erosolar-cli 2.1.231 → 2.1.235

package/dist/core/baseToolFactory.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Base Tool Factory
+ *
+ * Provides utilities and patterns for creating tools with consistent:
+ * - Error handling
+ * - JSON schema generation
+ * - Result formatting
+ * - Progress reporting
+ * - Timeout handling
+ *
+ * Usage:
+ * ```typescript
+ * import { createTool, ToolBuilder, commonSchemas } from '../core/baseToolFactory.js';
+ *
+ * const myTool = createTool({
+ *   name: 'MyTool',
+ *   description: 'Does something useful',
+ *   parameters: {
+ *     input: { type: 'string', required: true, description: 'Input value' },
+ *   },
+ *   handler: async (args) => {
+ *     // Implementation
+ *     return { success: true, data: args.input };
+ *   },
+ * });
+ * ```
+ */
+import type { ToolDefinition, ToolSuite } from './toolRuntime.js';
+/**
+ * Common schema fragments for reuse across tools
+ */
+export declare const commonSchemas: {
+    /** File path parameter */
+    filePath: {
+        type: "string";
+        description: string;
+    };
+    /** Directory path parameter */
+    directoryPath: {
+        type: "string";
+        description: string;
+    };
+    /** Timeout in milliseconds */
+    timeout: {
+        type: "number";
+        description: string;
+        default: number;
+    };
+    /** Boolean flag */
+    flag: (description: string, defaultValue?: boolean) => {
+        type: "boolean";
+        description: string;
+        default: boolean;
+    };
+    /** String with enum options */
+    enum: (description: string, values: string[], defaultValue?: string) => {
+        default?: string | undefined;
+        type: "string";
+        description: string;
+        enum: string[];
+    };
+    /** Array of strings */
+    stringArray: (description: string) => {
+        type: "array";
+        items: {
+            type: "string";
+        };
+        description: string;
+    };
+    /** Optional string */
+    optionalString: (description: string) => {
+        type: "string";
+        description: string;
+    };
+    /** Required string */
+    requiredString: (description: string) => {
+        type: "string";
+        description: string;
+    };
+};
+export interface ToolResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    warnings?: string[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Format a tool result to a consistent JSON string
+ */
+export declare function formatToolResult(result: ToolResult): string;
+/**
+ * Create a successful tool result
+ */
+export declare function successResult(data: unknown, metadata?: Record<string, unknown>): string;
+/**
+ * Create a failed tool result
+ */
+export declare function errorResult(error: string | Error, metadata?: Record<string, unknown>): string;
+/**
+ * Create a result with warnings
+ */
+export declare function warningResult(data: unknown, warnings: string[], metadata?: Record<string, unknown>): string;
+export interface SimpleParameterDef {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    description: string;
+    required?: boolean;
+    default?: unknown;
+    enum?: string[];
+    items?: {
+        type: string;
+    };
+}
+export interface CreateToolOptions<T extends Record<string, unknown>> {
+    name: string;
+    description: string;
+    parameters?: Record<string, SimpleParameterDef>;
+    handler: (args: T) => Promise<unknown> | unknown;
+    cacheable?: boolean;
+    formatResult?: (result: unknown) => string;
+}
+/**
+ * Create a tool definition with simplified parameter handling
+ */
+export declare function createTool<T extends Record<string, unknown>>(options: CreateToolOptions<T>): ToolDefinition<T>;
+/**
+ * Fluent builder for creating tools
+ *
+ * Usage:
+ * ```typescript
+ * const tool = new ToolBuilder('MyTool')
+ *   .description('Does something useful')
+ *   .param('input', 'string', 'The input value', true)
+ *   .param('verbose', 'boolean', 'Enable verbose output', false, false)
+ *   .handler(async (args) => {
+ *     return { data: args.input };
+ *   })
+ *   .build();
+ * ```
+ */
+export declare class ToolBuilder<T extends Record<string, unknown> = Record<string, unknown>> {
+    private _name;
+    private _description;
+    private _parameters;
+    private _handler?;
+    private _cacheable;
+    private _formatResult?;
+    constructor(name: string);
+    description(desc: string): this;
+    param(name: string, type: SimpleParameterDef['type'], description: string, required?: boolean, defaultValue?: unknown): this;
+    enumParam(name: string, description: string, values: string[], required?: boolean, defaultValue?: string): this;
+    arrayParam(name: string, description: string, itemType?: string, required?: boolean): this;
+    handler(fn: (args: T) => Promise<unknown> | unknown): this;
+    cacheable(value?: boolean): this;
+    formatResult(fn: (result: unknown) => string): this;
+    build(): ToolDefinition<T>;
+}
+/**
+ * Builder for creating tool suites
+ */
+export declare class ToolSuiteBuilder {
+    private _id;
+    private _description?;
+    private _tools;
+    constructor(id: string);
+    description(desc: string): this;
+    addTool(tool: ToolDefinition): this;
+    addTools(tools: ToolDefinition[]): this;
+    build(): ToolSuite;
+}
+/**
+ * Execute with timeout
+ */
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, errorMessage?: string): Promise<T>;
+/**
+ * Execute with progress reporting for long operations
+ */
+export declare function withProgress<T>(operation: (report: (current: number, total?: number, message?: string) => void) => Promise<T>): Promise<T>;
+/**
+ * Retry an operation with exponential backoff
+ */
+export declare function withRetry<T>(operation: () => Promise<T>, options?: {
+    maxRetries?: number;
+    baseDelayMs?: number;
+    shouldRetry?: (error: unknown) => boolean;
+}): Promise<T>;
+//# sourceMappingURL=baseToolFactory.d.ts.map

package/dist/core/baseToolFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseToolFactory.d.ts","sourceRoot":"","sources":["../../src/core/baseToolFactory.ts"],"names":[],"mappings":"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"}

package/dist/core/baseToolFactory.js

@@ -0,0 +1,352 @@
+/**
+ * Base Tool Factory
+ *
+ * Provides utilities and patterns for creating tools with consistent:
+ * - Error handling
+ * - JSON schema generation
+ * - Result formatting
+ * - Progress reporting
+ * - Timeout handling
+ *
+ * Usage:
+ * ```typescript
+ * import { createTool, ToolBuilder, commonSchemas } from '../core/baseToolFactory.js';
+ *
+ * const myTool = createTool({
+ *   name: 'MyTool',
+ *   description: 'Does something useful',
+ *   parameters: {
+ *     input: { type: 'string', required: true, description: 'Input value' },
+ *   },
+ *   handler: async (args) => {
+ *     // Implementation
+ *     return { success: true, data: args.input };
+ *   },
+ * });
+ * ```
+ */
+import { reportToolProgress } from './toolRuntime.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// Common Schema Fragments
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Common schema fragments for reuse across tools
+ */
+export const commonSchemas = {
+    /** File path parameter */
+    filePath: {
+        type: 'string',
+        description: 'Absolute path to the file',
+    },
+    /** Directory path parameter */
+    directoryPath: {
+        type: 'string',
+        description: 'Absolute path to the directory',
+    },
+    /** Timeout in milliseconds */
+    timeout: {
+        type: 'number',
+        description: 'Timeout in milliseconds',
+        default: 30000,
+    },
+    /** Boolean flag */
+    flag: (description, defaultValue = false) => ({
+        type: 'boolean',
+        description,
+        default: defaultValue,
+    }),
+    /** String with enum options */
+    enum: (description, values, defaultValue) => ({
+        type: 'string',
+        description,
+        enum: values,
+        ...(defaultValue !== undefined && { default: defaultValue }),
+    }),
+    /** Array of strings */
+    stringArray: (description) => ({
+        type: 'array',
+        items: { type: 'string' },
+        description,
+    }),
+    /** Optional string */
+    optionalString: (description) => ({
+        type: 'string',
+        description,
+    }),
+    /** Required string */
+    requiredString: (description) => ({
+        type: 'string',
+        description,
+    }),
+};
+/**
+ * Format a tool result to a consistent JSON string
+ */
+export function formatToolResult(result) {
+    return JSON.stringify(result, null, 2);
+}
+/**
+ * Create a successful tool result
+ */
+export function successResult(data, metadata) {
+    return formatToolResult({
+        success: true,
+        data,
+        ...(metadata && { metadata }),
+    });
+}
+/**
+ * Create a failed tool result
+ */
+export function errorResult(error, metadata) {
+    const message = error instanceof Error ? error.message : error;
+    return formatToolResult({
+        success: false,
+        error: message,
+        ...(metadata && { metadata }),
+    });
+}
+/**
+ * Create a result with warnings
+ */
+export function warningResult(data, warnings, metadata) {
+    return formatToolResult({
+        success: true,
+        data,
+        warnings,
+        ...(metadata && { metadata }),
+    });
+}
+/**
+ * Create a tool definition with simplified parameter handling
+ */
+export function createTool(options) {
+    const { name, description, parameters, handler, cacheable, formatResult } = options;
+    // Build JSON schema from simple parameter definitions
+    const jsonSchema = parameters
+        ? buildJsonSchema(parameters)
+        : undefined;
+    return {
+        name,
+        description,
+        parameters: jsonSchema,
+        cacheable,
+        handler: async (args) => {
+            try {
+                const result = await handler(args);
+                // Use custom formatter if provided
+                if (formatResult) {
+                    return formatResult(result);
+                }
+                // Default: JSON stringify
+                if (typeof result === 'string') {
+                    return result;
+                }
+                return JSON.stringify(result, null, 2);
+            }
+            catch (error) {
+                return errorResult(error instanceof Error ? error : String(error));
+            }
+        },
+    };
+}
+/**
+ * Build a JSON schema from simplified parameter definitions
+ */
+function buildJsonSchema(parameters) {
+    const properties = {};
+    const required = [];
+    for (const [key, def] of Object.entries(parameters)) {
+        const prop = {
+            type: def.type,
+            description: def.description,
+        };
+        if (def.default !== undefined) {
+            prop['default'] = def.default;
+        }
+        if (def.enum) {
+            prop['enum'] = def.enum;
+        }
+        if (def.items) {
+            prop['items'] = def.items;
+        }
+        properties[key] = prop;
+        if (def.required) {
+            required.push(key);
+        }
+    }
+    return {
+        type: 'object',
+        properties,
+        ...(required.length > 0 && { required }),
+    };
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// Tool Builder (Fluent API)
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Fluent builder for creating tools
+ *
+ * Usage:
+ * ```typescript
+ * const tool = new ToolBuilder('MyTool')
+ *   .description('Does something useful')
+ *   .param('input', 'string', 'The input value', true)
+ *   .param('verbose', 'boolean', 'Enable verbose output', false, false)
+ *   .handler(async (args) => {
+ *     return { data: args.input };
+ *   })
+ *   .build();
+ * ```
+ */
+export class ToolBuilder {
+    _name;
+    _description = '';
+    _parameters = {};
+    _handler;
+    _cacheable = false;
+    _formatResult;
+    constructor(name) {
+        this._name = name;
+    }
+    description(desc) {
+        this._description = desc;
+        return this;
+    }
+    param(name, type, description, required = false, defaultValue) {
+        this._parameters[name] = {
+            type,
+            description,
+            required,
+            ...(defaultValue !== undefined && { default: defaultValue }),
+        };
+        return this;
+    }
+    enumParam(name, description, values, required = false, defaultValue) {
+        this._parameters[name] = {
+            type: 'string',
+            description,
+            required,
+            enum: values,
+            ...(defaultValue !== undefined && { default: defaultValue }),
+        };
+        return this;
+    }
+    arrayParam(name, description, itemType = 'string', required = false) {
+        this._parameters[name] = {
+            type: 'array',
+            description,
+            required,
+            items: { type: itemType },
+        };
+        return this;
+    }
+    handler(fn) {
+        this._handler = fn;
+        return this;
+    }
+    cacheable(value = true) {
+        this._cacheable = value;
+        return this;
+    }
+    formatResult(fn) {
+        this._formatResult = fn;
+        return this;
+    }
+    build() {
+        if (!this._handler) {
+            throw new Error(`Tool ${this._name} requires a handler`);
+        }
+        return createTool({
+            name: this._name,
+            description: this._description,
+            parameters: Object.keys(this._parameters).length > 0 ? this._parameters : undefined,
+            handler: this._handler,
+            cacheable: this._cacheable,
+            formatResult: this._formatResult,
+        });
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// Tool Suite Builder
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Builder for creating tool suites
+ */
+export class ToolSuiteBuilder {
+    _id;
+    _description;
+    _tools = [];
+    constructor(id) {
+        this._id = id;
+    }
+    description(desc) {
+        this._description = desc;
+        return this;
+    }
+    addTool(tool) {
+        this._tools.push(tool);
+        return this;
+    }
+    addTools(tools) {
+        this._tools.push(...tools);
+        return this;
+    }
+    build() {
+        return {
+            id: this._id,
+            description: this._description,
+            tools: this._tools,
+        };
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// Async Utilities for Tools
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Execute with timeout
+ */
+export async function withTimeout(promise, timeoutMs, errorMessage = 'Operation timed out') {
+    let timeoutId;
+    const timeoutPromise = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => reject(new Error(errorMessage)), timeoutMs);
+    });
+    try {
+        return await Promise.race([promise, timeoutPromise]);
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+/**
+ * Execute with progress reporting for long operations
+ */
+export async function withProgress(operation) {
+    const report = (current, total, message) => {
+        reportToolProgress({ current, total, message });
+    };
+    return operation(report);
+}
+/**
+ * Retry an operation with exponential backoff
+ */
+export async function withRetry(operation, options = {}) {
+    const { maxRetries = 3, baseDelayMs = 1000, shouldRetry = () => true } = options;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt === maxRetries || !shouldRetry(error)) {
+                throw error;
+            }
+            // Exponential backoff
+            const delayMs = baseDelayMs * Math.pow(2, attempt);
+            await new Promise((resolve) => setTimeout(resolve, delayMs));
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=baseToolFactory.js.map

package/dist/core/baseToolFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseToolFactory.js","sourceRoot":"","sources":["../../src/core/baseToolFactory.ts"],"names":[],"mappings":"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"}

package/dist/core/constants.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Shared constants used across the orchestration stack.
+ */
+export declare const TASK_FULLY_COMPLETE = "TASK_FULLY_COMPLETE";
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,mBAAmB,wBAAwB,CAAC"}

package/dist/core/constants.js

@@ -0,0 +1,5 @@
+/**
+ * Shared constants used across the orchestration stack.
+ */
+export const TASK_FULLY_COMPLETE = 'TASK_FULLY_COMPLETE';
+//# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC"}

package/dist/core/errors/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Unified Error Handling System
+ *
+ * This module consolidates all error-related exports into a single entry point.
+ * Use this module for all error handling needs instead of importing from
+ * individual files.
+ *
+ * Architecture:
+ * - errorTypes.ts: Base classes and structured error types
+ * - apiKeyErrors.ts: API key and authentication errors
+ * - networkErrors.ts: Network connectivity errors
+ * - safetyValidator.ts: Input validation and safety checks
+ *
+ * Usage:
+ * ```typescript
+ * import {
+ *   StructuredError,
+ *   ErrorSeverity,
+ *   ErrorCategory,
+ *   DangerousOperationError,
+ *   detectApiKeyError,
+ *   detectNetworkError,
+ * } from '../core/errors/index.js';
+ * ```
+ */
+export { ErrorSeverity, ErrorCategory, type ErrorSuggestion, type StructuredErrorDetails, StructuredError, DangerousOperationError, BlockedOperationError, ContextOverflowError, ResourceLimitError, ValidationError, toStructuredError, } from './errorTypes.js';
+export { type ApiKeyErrorType, type ApiKeyErrorInfo, detectApiKeyError, } from './apiKeyErrors.js';
+export { type NetworkErrorInfo, detectNetworkError, } from './networkErrors.js';
+export * from './safetyValidator.js';
+export { type ErrorContextValue, type ErrorContext, buildError, } from '../errors.js';
+/**
+ * Detect and classify any error into a structured format
+ */
+export declare function detectError(error: unknown, provider?: string): {
+    type: 'api_key' | 'network' | 'structured' | 'unknown';
+    info: unknown;
+};
+/**
+ * Check if an error is recoverable
+ */
+export declare function isRecoverableError(error: unknown): boolean;
+/**
+ * Get a user-friendly error message
+ */
+export declare function getUserFriendlyMessage(error: unknown): string;
+/**
+ * Format error for logging (includes full details)
+ */
+export declare function formatForLogging(error: unknown, context?: Record<string, unknown>): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAMH,OAAO,EAEL,aAAa,EACb,aAAa,EAGb,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAG3B,eAAe,EAGf,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EAGf,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EACL,KAAK,gBAAgB,EACrB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAM5B,cAAc,sBAAsB,CAAC;AAMrC,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,UAAU,GACX,MAAM,cAAc,CAAC;AAatB;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG;IAC9D,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IACvD,IAAI,EAAE,OAAO,CAAC;CACf,CA0BA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAa1D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAuB7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CA2B1F"}