Scripta Client & API Documentation

"text-pink-500">import { 
  ScriptaClient, 
  PlatformAdapter,
  PermissionHandler
} "text-pink-500">from '@scripta/client-sdk';

// Create platform adapter (implementation depends on your environment)
"text-pink-500">const adapter = "text-pink-500">new YourPlatformAdapter();

// Create permission handler (implementation depends on your UI framework)
"text-pink-500">const permissionHandler = "text-pink-500">new YourPermissionHandler();

// Initialize the client
"text-pink-500">const client = "text-pink-500">new ScriptaClient(
  adapter,
  permissionHandler,
  { serverUrl: 'http://localhost:3456/api' }
);

// Connect to the server
"text-pink-500">const session = "text-pink-500">await client.connect();

// Listen "text-pink-500">for events
client.on('response', (message) => {
  console.log('Received response:', message);
});

client.on('toolRequest', (request) => {
  console.log('Tool request:', request);
});

// Send a message
"text-pink-500">await client.sendMessage('Hello, Scripta!');

"text-pink-500">import { 
  BasePermissionHandler, 
  PermissionContext,
  PermissionResponse,
  PermissionScope
} "text-pink-500">from '@scripta/client-sdk';

"text-pink-500">export "text-pink-500">class MyPermissionHandler "text-pink-500">extends BasePermissionHandler {
  // Check "text-pink-500">if permission is already stored
  protected "text-pink-500">async checkStoredPermission(
    toolName: string,
    parameters: any,
    context: PermissionContext
  ): Promise<boolean> {
    // Implement your storage check here
    "text-pink-500">return false;
  }

  // Request permission "text-pink-500">from the user
  "text-pink-500">async requestPermission(
    toolName: string,
    parameters: any,
    context: PermissionContext
  ): Promise<boolean> {
    // Get a description of the operation
    "text-pink-500">const description = "text-pink-500">this.getToolDescription(toolName, parameters);
    
    // Assess risk level
    "text-pink-500">const risk = "text-pink-500">this.assessRisk(toolName, parameters);
    
    // Show UI to request permission (implementation depends on your UI framework)
    "text-pink-500">const userResponse = "text-pink-500">await showPermissionDialog({
      toolName,
      description,
      risk
    });
    
    // Store the permission "text-pink-500">if granted
    "text-pink-500">if (userResponse.granted && userResponse.scope !== 'once') {
      "text-pink-500">await "text-pink-500">this.storePermission(
        toolName,
        parameters,
        true,
        context,
        userResponse.scope
      );
    }
    
    "text-pink-500">return userResponse.granted;
  }

  // Store permission decision
  "text-pink-500">async storePermission(
    toolName: string,
    parameters: any,
    granted: boolean,
    context: PermissionContext,
    scope: PermissionScope | boolean
  ): Promise<void> {
    // Implement your storage mechanism here
    // This could use localStorage, cookies, or a server API
  }
}

"text-pink-500">import { 
  PlatformAdapter,
  ShellResult,
  GrepResult,
  ListFilesOptions,
  GlobOptions,
  GrepOptions,
  ShellOptions,
  PermissionRequest
} "text-pink-500">from '@scripta/client-sdk';

"text-pink-500">export "text-pink-500">class MyPlatformAdapter "text-pink-500">implements PlatformAdapter {
  // Filesystem operations
  "text-pink-500">async readFile(path: string): Promise<string> {
    // Implement based on your platform
  }

  "text-pink-500">async writeFile(path: string, content: string): Promise<void> {
    // Implement based on your platform
  }

  "text-pink-500">async listFiles(path: string, options?: ListFilesOptions): Promise<string[]> {
    // Implement based on your platform
  }

  "text-pink-500">async glob(pattern: string, options?: GlobOptions): Promise<string[]> {
    // Implement based on your platform
  }

  "text-pink-500">async grep(pattern: string, path: string, options?: GrepOptions): Promise {
    // Implement based on your platform
  }
  
  // Shell operations
  "text-pink-500">async executeCommand(command: string, options?: ShellOptions): Promise {
    // Implement based on your platform
  }
  
  // Path operations
  "text-pink-500">async resolvePath(path: string): Promise<string> {
    // Implement based on your platform
  }

  "text-pink-500">async isAbsolutePath(path: string): Promise<boolean> {
    // Implement based on your platform
  }

  "text-pink-500">async joinPaths(...paths: string[]): Promise<string> {
    // Implement based on your platform
  }
  
  // Configuration operations
  "text-pink-500">async getConfigPath(): Promise<string> {
    // Implement based on your platform
  }
  
  // Permission operations
  "text-pink-500">async requestPermission(request: PermissionRequest): Promise<boolean> {
    // Implement based on your platform
  }
}