@robota-sdk/agent-tools 3.0.0-beta.62 → 3.0.0-beta.64

package/dist/node/index.d.cts

@@ -1,504 +0,0 @@
-import { IToolRegistry, ITool, IToolSchema, TToolParameters, TUniversalValue, IFunctionTool, TToolExecutor, IEventService, IToolExecutionContext, IToolResult, IParameterValidationResult, IOpenAPIToolConfig } from '@robota-sdk/agent-core';
-
-/**
- * Result returned by a CLI tool invocation
- */
-interface TToolResult {
-    success: boolean;
-    output: string;
-    error?: string;
-    exitCode?: number;
-    /** Start line number of the edit in the original file (Edit tool only) */
-    startLine?: number;
-}
-
-interface ISandboxRunOptions {
-    timeoutMs?: number;
-    workingDirectory?: string;
-}
-interface ISandboxRunResult {
-    stdout: string;
-    stderr?: string;
-    exitCode: number;
-}
-interface IWorkspaceManifestFileEntry {
-    type: 'file';
-    content: string;
-    encoding?: 'utf8';
-}
-interface IWorkspaceManifestDirectoryEntry {
-    type: 'dir';
-}
-interface IWorkspaceManifestLocalFileEntry {
-    type: 'localFile';
-    src: string;
-}
-interface IWorkspaceManifestLocalDirectoryEntry {
-    type: 'localDir';
-    src: string;
-}
-interface IWorkspaceManifestGitRepositoryEntry {
-    type: 'gitRepo';
-    url: string;
-    ref?: string;
-    shallow?: boolean;
-}
-interface IWorkspaceManifestS3MountEntry {
-    type: 's3Mount';
-    bucket: string;
-    prefix?: string;
-    region: string;
-}
-interface IWorkspaceManifestGcsMountEntry {
-    type: 'gcsMount';
-    bucket: string;
-    prefix?: string;
-}
-interface IWorkspaceManifestR2MountEntry {
-    type: 'r2Mount';
-    bucket: string;
-    accountId: string;
-    prefix?: string;
-}
-interface IWorkspaceManifestAzureBlobMountEntry {
-    type: 'azureBlobMount';
-    container: string;
-    account: string;
-    prefix?: string;
-}
-type TWorkspaceManifestEntry = IWorkspaceManifestFileEntry | IWorkspaceManifestDirectoryEntry | IWorkspaceManifestLocalFileEntry | IWorkspaceManifestLocalDirectoryEntry | IWorkspaceManifestGitRepositoryEntry | IWorkspaceManifestS3MountEntry | IWorkspaceManifestGcsMountEntry | IWorkspaceManifestR2MountEntry | IWorkspaceManifestAzureBlobMountEntry;
-interface IWorkspaceManifestPermissions {
-    read?: string[];
-    write?: string[];
-}
-interface IWorkspaceManifest {
-    entries: Record<string, TWorkspaceManifestEntry>;
-    environment?: Record<string, string>;
-    permissions?: IWorkspaceManifestPermissions;
-}
-interface IWorkspaceManifestApplyOptions {
-    targetRoot?: string;
-    hostRoot?: string;
-}
-type TWorkspaceManifestApplyStatus = 'applied' | 'unsupported';
-interface IWorkspaceManifestAppliedEntry {
-    path: string;
-    type: TWorkspaceManifestEntry['type'];
-    status: TWorkspaceManifestApplyStatus;
-    message?: string;
-}
-interface IWorkspaceManifestApplyResult {
-    entries: IWorkspaceManifestAppliedEntry[];
-}
-interface ISandboxClient {
-    run(command: string, options?: ISandboxRunOptions): Promise<ISandboxRunResult>;
-    readFile(path: string): Promise<string>;
-    writeFile(path: string, content: string): Promise<void>;
-    applyManifest?(manifest: IWorkspaceManifest, options?: IWorkspaceManifestApplyOptions): Promise<IWorkspaceManifestApplyResult>;
-    /** Return a provider-owned resumable workspace reference. */
-    snapshot?(): Promise<string>;
-    /** Hydrate this client from a provider-owned workspace reference. */
-    restore?(snapshotId: string): Promise<void>;
-}
-interface ISandboxToolOptions {
-    sandboxClient?: ISandboxClient;
-}
-
-interface IE2BCommandStartOptions {
-    timeoutMs?: number;
-    cwd?: string;
-    background?: false;
-}
-interface IE2BCommandResult {
-    stdout?: string;
-    stderr?: string;
-    exitCode?: number;
-    exit_code?: number;
-}
-interface IE2BCommands {
-    run(command: string, options?: IE2BCommandStartOptions): Promise<IE2BCommandResult>;
-}
-interface IE2BFiles {
-    read(path: string): Promise<string | Uint8Array>;
-    write(path: string, content: string): Promise<void>;
-}
-interface IE2BSnapshot {
-    snapshotId?: string;
-    id?: string;
-}
-interface IE2BSandboxAdapter {
-    sandboxId?: string;
-    commands: IE2BCommands;
-    files: IE2BFiles;
-    pause?(): Promise<boolean | string | void>;
-    connect?(): Promise<IE2BSandboxAdapter>;
-    createSnapshot?(): Promise<IE2BSnapshot>;
-}
-interface IE2BSandboxClientOptions {
-    sandbox: IE2BSandboxAdapter;
-    connectSandbox?: (sandboxId: string) => Promise<IE2BSandboxAdapter>;
-    createSandboxFromSnapshot?: (snapshotId: string) => Promise<IE2BSandboxAdapter>;
-}
-declare class E2BSandboxClient implements ISandboxClient {
-    private sandbox;
-    private readonly connectSandbox?;
-    private readonly createSandboxFromSnapshot?;
-    constructor(options: IE2BSandboxClientOptions);
-    run(command: string, options?: ISandboxRunOptions): Promise<ISandboxRunResult>;
-    readFile(path: string): Promise<string>;
-    writeFile(path: string, content: string): Promise<void>;
-    snapshot(): Promise<string>;
-    restore(snapshotId: string): Promise<void>;
-}
-
-type TInMemorySandboxRunHandler = (command: string, options: ISandboxRunOptions | undefined, files: ReadonlyMap<string, string>) => Promise<ISandboxRunResult> | ISandboxRunResult;
-interface IInMemorySandboxClientOptions {
-    files?: Record<string, string>;
-    runHandler?: TInMemorySandboxRunHandler;
-}
-declare class InMemorySandboxClient implements ISandboxClient {
-    private readonly files;
-    private readonly snapshots;
-    private readonly runHandler?;
-    private snapshotSequence;
-    constructor(options?: IInMemorySandboxClientOptions);
-    run(command: string, options?: ISandboxRunOptions): Promise<ISandboxRunResult>;
-    readFile(path: string): Promise<string>;
-    writeFile(path: string, content: string): Promise<void>;
-    snapshot(): Promise<string>;
-    restore(snapshotId: string): Promise<void>;
-    getFile(path: string): string | undefined;
-}
-
-declare function applyWorkspaceManifest(sandboxClient: ISandboxClient, manifest: IWorkspaceManifest, options?: IWorkspaceManifestApplyOptions): Promise<IWorkspaceManifestApplyResult>;
-declare function validateWorkspaceManifestPath(path: string): string;
-
-/**
- * Tool registry implementation
- * Manages tool registration, validation, and retrieval
- */
-declare class ToolRegistry implements IToolRegistry {
-    private tools;
-    /**
-     * Register a tool
-     */
-    register(tool: ITool): void;
-    /**
-     * Unregister a tool
-     */
-    unregister(name: string): void;
-    /**
-     * Get tool by name
-     */
-    get(name: string): ITool | undefined;
-    /**
-     * Get all registered tools
-     */
-    getAll(): ITool[];
-    /**
-     * Get tool schemas
-     */
-    getSchemas(): IToolSchema[];
-    /**
-     * Check if tool exists
-     */
-    has(name: string): boolean;
-    /**
-     * Clear all tools
-     */
-    clear(): void;
-    /**
-     * Get tool names
-     */
-    getToolNames(): string[];
-    /**
-     * Get tools by pattern
-     */
-    getToolsByPattern(pattern: string | RegExp): ITool[];
-    /**
-     * Get tool count
-     */
-    size(): number;
-    /**
-     * Validate tool schema
-     */
-    private validateToolSchema;
-}
-
-/**
- * FunctionTool - Type definitions for Facade pattern implementation
- *
- * REASON: Complex Zod schema type compatibility requires separation of concerns
- * ALTERNATIVES_CONSIDERED:
- * 1. Fix all Zod undefined issues in single file (creates maintenance burden)
- * 2. Use any types strategically (reduces type safety)
- * 3. Remove Zod support entirely (breaks existing functionality)
- * 4. Create complex conditional types (adds cognitive overhead)
- * 5. Use type assertions everywhere (increases runtime risk)
- * NOTE: Tool functionality is now integrated into @robota-sdk/agent-tools package
- */
-
-/**
- * Zod schema compatibility types
- */
-interface IZodParseResult {
-    success: boolean;
-    data?: TToolParameters;
-    error?: string | Error;
-}
-interface IZodSchemaDef {
-    typeName?: string;
-    innerType?: IZodSchema;
-    valueType?: IZodSchema;
-    checks?: Array<{
-        kind: string;
-        value?: TUniversalValue;
-    }>;
-    shape?: () => Record<string, IZodSchema>;
-    type?: IZodSchema;
-    values?: TUniversalValue[];
-    description?: string;
-    unknownKeys?: 'passthrough' | 'strip' | 'strict';
-}
-interface IZodSchema {
-    parse(value: TToolParameters): TToolParameters;
-    safeParse(value: TToolParameters): IZodParseResult;
-    _def?: IZodSchemaDef;
-}
-/**
- * Parameter type validation options
- */
-interface IFunctionToolValidationOptions {
-    strict?: boolean;
-    allowUnknown?: boolean;
-    validateTypes?: boolean;
-}
-/**
- * Schema conversion options
- */
-interface ISchemaConversionOptions {
-    includeDescription?: boolean;
-    strictTypes?: boolean;
-    allowAdditionalProperties?: boolean;
-}
-/**
- * Tool execution metadata
- */
-interface IFunctionToolExecutionMetadata {
-    executionTime: number;
-    toolName: string;
-    parameters: TToolParameters;
-}
-/**
- * Tool result with metadata
- */
-interface IFunctionToolResult {
-    success: boolean;
-    data: TUniversalValue;
-    metadata?: IFunctionToolExecutionMetadata;
-}
-
-/**
- * Function tool implementation
- * Wraps a JavaScript function as a tool with schema validation
- *
- * Implements IFunctionTool without extending AbstractTool to avoid
- * circular runtime dependency (tools → agents → tools).
- */
-declare class FunctionTool implements IFunctionTool {
-    readonly schema: IToolSchema;
-    readonly fn: TToolExecutor;
-    private eventService;
-    constructor(schema: IToolSchema, fn: TToolExecutor);
-    /**
-     * Get tool name
-     */
-    getName(): string;
-    /**
-     * Set EventService for post-construction injection.
-     * Accepts EventService as-is without transformation.
-     * Caller is responsible for providing properly configured EventService.
-     */
-    setEventService(eventService: IEventService | undefined): void;
-    /**
-     * Execute the function tool
-     */
-    execute(parameters: TToolParameters, context?: IToolExecutionContext): Promise<IToolResult>;
-    /**
-     * Validate parameters (simple boolean result)
-     */
-    validate(parameters: TToolParameters): boolean;
-    /**
-     * Validate tool parameters with detailed result
-     */
-    validateParameters(parameters: TToolParameters): IParameterValidationResult;
-    /**
-     * Get tool description
-     */
-    getDescription(): string;
-    /**
-     * Validate constructor inputs
-     */
-    private validateConstructorInputs;
-}
-/**
- * Helper function to create a function tool from a simple function
- */
-declare function createFunctionTool(name: string, description: string, parameters: IToolSchema['parameters'], fn: TToolExecutor): FunctionTool;
-/**
- * Helper function to create a function tool from Zod schema
- */
-declare function createZodFunctionTool(name: string, description: string, zodSchema: IZodSchema, fn: TToolExecutor): FunctionTool;
-
-/**
- * OpenAPI tool implementation
- * Executes API calls based on OpenAPI 3.0 specifications
- *
- * Implements ITool without extending AbstractTool to avoid
- * circular runtime dependency (tools → agents → tools).
- */
-declare class OpenAPITool implements ITool {
-    readonly schema: IToolSchema;
-    private readonly apiSpec;
-    private readonly operationId;
-    private readonly baseURL;
-    private readonly config;
-    private eventService;
-    constructor(config: IOpenAPIToolConfig);
-    /**
-     * Execute the OpenAPI tool
-     */
-    execute(parameters: TToolParameters, context?: IToolExecutionContext): Promise<IToolResult>;
-    /**
-     * Validate tool parameters
-     */
-    validate(parameters: TToolParameters): boolean;
-    /**
-     * Validate tool parameters with detailed result
-     */
-    validateParameters(parameters: TToolParameters): IParameterValidationResult;
-    /**
-     * Get tool name
-     */
-    getName(): string;
-    /**
-     * Set EventService for post-construction injection.
-     */
-    setEventService(eventService: IEventService | undefined): void;
-    /**
-     * Get tool description
-     */
-    getDescription(): string;
-    /**
-     * Execute the actual API call
-     * @private
-     */
-    private executeAPICall;
-    /**
-     * Build HTTP request configuration from OpenAPI operation and parameters
-     */
-    private buildRequestConfig;
-    /**
-     * Create tool schema from OpenAPI operation specification
-     */
-    private createSchemaFromOpenAPI;
-}
-/**
- * Factory function to create OpenAPI tools from specification
- */
-declare function createOpenAPITool(config: IOpenAPIToolConfig): OpenAPITool;
-
-/**
- * FunctionTool - Schema conversion utilities for Facade pattern
- *
- * REASON: Complex Zod to JSON schema conversion requires isolated utility functions
- * ALTERNATIVES_CONSIDERED:
- * 1. Keep conversion logic in main class (violates single responsibility)
- * 2. Use third-party library (adds external dependency)
- * 3. Manual conversion each time (code duplication)
- * 4. Runtime type checking only (loses compile-time safety)
- * 5. Remove Zod support (breaks backward compatibility)
- * TODO: Consider caching conversion results for performance
- */
-
-/**
- * Convert Zod schema to JSON Schema format with safe undefined handling
- */
-declare function zodToJsonSchema(schema: IZodSchema, options?: ISchemaConversionOptions): IToolSchema['parameters'];
-
-/**
- * Create a BashTool instance — register with Robota agent tools registry.
- */
-declare function createBashTool(options?: ISandboxToolOptions): FunctionTool;
-/**
- * BashTool instance — register with Robota agent tools registry.
- */
-declare const bashTool: FunctionTool;
-
-/**
- * Create a ReadTool instance — register with Robota agent tools registry.
- */
-declare function createReadTool(options?: ISandboxToolOptions): FunctionTool;
-/**
- * ReadTool instance — register with Robota agent tools registry.
- */
-declare const readTool: FunctionTool;
-
-/**
- * Create a WriteTool instance — register with Robota agent tools registry.
- */
-declare function createWriteTool(options?: ISandboxToolOptions): FunctionTool;
-/**
- * WriteTool instance — register with Robota agent tools registry.
- */
-declare const writeTool: FunctionTool;
-
-/**
- * Create an EditTool instance — register with Robota agent tools registry.
- */
-declare function createEditTool(options?: ISandboxToolOptions): FunctionTool;
-/**
- * EditTool instance — register with Robota agent tools registry.
- */
-declare const editTool: FunctionTool;
-
-/**
- * GlobTool — fast file pattern search using fast-glob.
- *
- * Excludes node_modules and .git by default.
- * Results are sorted by modification time (most recently modified first).
- */
-/**
- * GlobTool instance — register with Robota agent tools registry.
- */
-declare const globTool: FunctionTool;
-
-/**
- * GrepTool — recursive regex content search.
- *
- * Supports two output modes:
- * - files_with_matches (default): return only file paths that contain a match
- * - content: return matching lines with optional context lines
- */
-/**
- * GrepTool instance — register with Robota agent tools registry.
- */
-declare const grepTool: FunctionTool;
-
-/**
- * WebFetchTool — fetch a URL and return its content as text.
- *
- * HTML is stripped to plain text for readability. Uses Node.js native fetch.
- * Output is capped at 30K chars (same as other tools).
- */
-declare const webFetchTool: FunctionTool;
-
-/**
- * WebSearchTool — search the web and return results.
- *
- * Uses Brave Search API when BRAVE_API_KEY is set.
- * Returns an error with setup instructions otherwise.
- */
-declare const webSearchTool: FunctionTool;
-
-export { E2BSandboxClient, FunctionTool, type IE2BSandboxAdapter, type IE2BSandboxClientOptions, type IFunctionToolExecutionMetadata, type IFunctionToolResult, type IFunctionToolValidationOptions, type IInMemorySandboxClientOptions, type ISandboxClient, type ISandboxRunOptions, type ISandboxRunResult, type ISandboxToolOptions, type ISchemaConversionOptions, type IWorkspaceManifest, type IWorkspaceManifestAppliedEntry, type IWorkspaceManifestApplyOptions, type IWorkspaceManifestApplyResult, type IWorkspaceManifestAzureBlobMountEntry, type IWorkspaceManifestDirectoryEntry, type IWorkspaceManifestFileEntry, type IWorkspaceManifestGcsMountEntry, type IWorkspaceManifestGitRepositoryEntry, type IWorkspaceManifestLocalDirectoryEntry, type IWorkspaceManifestLocalFileEntry, type IWorkspaceManifestPermissions, type IWorkspaceManifestR2MountEntry, type IWorkspaceManifestS3MountEntry, type IZodParseResult, type IZodSchema, type IZodSchemaDef, InMemorySandboxClient, OpenAPITool, type TInMemorySandboxRunHandler, type TToolResult, type TWorkspaceManifestApplyStatus, type TWorkspaceManifestEntry, ToolRegistry, applyWorkspaceManifest, bashTool, createBashTool, createEditTool, createFunctionTool, createOpenAPITool, createReadTool, createWriteTool, createZodFunctionTool, editTool, globTool, grepTool, readTool, validateWorkspaceManifestPath, webFetchTool, webSearchTool, writeTool, zodToJsonSchema };