@nexus-cortex/executors 4.26.0

package/dist/base/BaseTool.js

@@ -0,0 +1,111 @@
+/**
+ * Base Tool Abstract Class
+ *
+ * Foundation for all tool executors in Nexus Cortex
+ * Adapted from Gemini CLI patterns
+ *
+ * Key Principle: Definition ≠ Execution
+ * - Tool definitions live in @nexus-cortex/core
+ * - Tool executors live here in @nexus-cortex/executors
+ */
+/**
+ * Abstract base class for tool execution
+ *
+ * All tool executors must extend this class and implement:
+ * - validateToolParams(): Validate parameters before execution
+ * - execute(): Perform the actual tool operation
+ *
+ * Optionally override:
+ * - shouldConfirmExecute(): Determine if user confirmation is needed
+ * - getDescription(): Provide human-readable description of action
+ */
+export class BaseTool {
+    name;
+    displayName;
+    description;
+    parameterSchema;
+    isOutputMarkdown;
+    canUpdateOutput;
+    /**
+     * Creates a new tool executor
+     *
+     * @param name Internal name of the tool (matches definition in core)
+     * @param displayName User-friendly display name
+     * @param description What the tool does
+     * @param parameterSchema JSON Schema for parameters
+     * @param isOutputMarkdown Whether output should be rendered as markdown
+     * @param canUpdateOutput Whether tool supports streaming output
+     */
+    constructor(name, displayName, description, parameterSchema, isOutputMarkdown = true, canUpdateOutput = false) {
+        this.name = name;
+        this.displayName = displayName;
+        this.description = description;
+        this.parameterSchema = parameterSchema;
+        this.isOutputMarkdown = isOutputMarkdown;
+        this.canUpdateOutput = canUpdateOutput;
+    }
+    /**
+     * Get human-readable description of what the tool will do
+     *
+     * Used for logging, debugging, and user confirmation prompts.
+     * Default implementation returns JSON stringified params.
+     * Override to provide better descriptions.
+     *
+     * @param params Tool parameters
+     * @returns Human-readable description
+     */
+    getDescription(params) {
+        return `Executing ${this.displayName} with: ${JSON.stringify(params)}`;
+    }
+    /**
+     * Determine if tool execution should prompt for user confirmation
+     *
+     * Override this for tools that:
+     * - Modify files
+     * - Execute commands
+     * - Make network requests
+     * - Perform destructive operations
+     *
+     * Default: No confirmation required
+     *
+     * @param params Tool parameters
+     * @param signal AbortSignal
+     * @returns Confirmation details or false if no confirmation needed
+     */
+    async shouldConfirmExecute(
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    params, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    signal) {
+        return false; // Default: no confirmation
+    }
+    /**
+     * Helper: Create success result
+     *
+     * Convenience method for creating successful tool results
+     */
+    createSuccessResult(content, metadata) {
+        return {
+            llmContent: content,
+            returnDisplay: typeof content === 'string' ? content : JSON.stringify(content, null, 2),
+            success: true,
+            metadata,
+        };
+    }
+    /**
+     * Helper: Create error result
+     *
+     * Convenience method for creating error tool results
+     */
+    createErrorResult(error, metadata) {
+        const errorMessage = error instanceof Error ? error.message : error;
+        return {
+            llmContent: `Error: ${errorMessage}`,
+            returnDisplay: `Error: ${errorMessage}`,
+            success: false,
+            error: errorMessage,
+            metadata,
+        };
+    }
+}
+//# sourceMappingURL=BaseTool.js.map

package/dist/base/BaseTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseTool.js","sourceRoot":"","sources":["../../src/base/BaseTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;;;;;;;;GAUG;AACH,MAAM,OAAgB,QAAQ;IAYV;IACA;IACA;IACA;IACA;IACA;IAhBlB;;;;;;;;;OASG;IACH,YACkB,IAAY,EACZ,WAAmB,EACnB,WAAmB,EACnB,eAA2B,EAC3B,mBAA4B,IAAI,EAChC,kBAA2B,KAAK;QALhC,SAAI,GAAJ,IAAI,CAAQ;QACZ,gBAAW,GAAX,WAAW,CAAQ;QACnB,gBAAW,GAAX,WAAW,CAAQ;QACnB,oBAAe,GAAf,eAAe,CAAY;QAC3B,qBAAgB,GAAhB,gBAAgB,CAAgB;QAChC,oBAAe,GAAf,eAAe,CAAiB;IAC/C,CAAC;IAkCJ;;;;;;;;;OASG;IACH,cAAc,CAAC,MAAe;QAC5B,OAAO,aAAa,IAAI,CAAC,WAAW,UAAU,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;IACzE,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,oBAAoB;IACxB,6DAA6D;IAC7D,MAAe;IACf,6DAA6D;IAC7D,MAAmB;QAEnB,OAAO,KAAK,CAAC,CAAC,2BAA2B;IAC3C,CAAC;IAED;;;;OAIG;IACO,mBAAmB,CAC3B,OAAuB,EACvB,QAAiC;QAEjC,OAAO;YACL,UAAU,EAAE,OAAO;YACnB,aAAa,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YACvF,OAAO,EAAE,IAAI;YACb,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACO,iBAAiB,CAAC,KAAqB,EAAE,QAAiC;QAClF,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QAEpE,OAAO;YACL,UAAU,EAAE,UAAU,YAAY,EAAE;YACpC,aAAa,EAAE,UAAU,YAAY,EAAE;YACvC,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,YAAY;YACnB,QAAQ;SACT,CAAC;IACJ,CAAC;CACF"}

package/dist/base/ToolRegistry.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Tool Registry
+ *
+ * Manages registration and execution of tool executors
+ * Central coordination point for all tool execution in Nexus Cortex
+ */
+import type { BaseTool } from './BaseTool.js';
+import type { ToolResult } from './ToolResult.js';
+import type { ExecutorConfig } from '@nexus-cortex/types';
+export type { ExecutorConfig };
+/**
+ * Tool execution statistics
+ */
+export interface ToolExecutionStats {
+    /** Tool name */
+    toolName: string;
+    /** Number of times executed */
+    executionCount: number;
+    /** Total execution time (milliseconds) */
+    totalExecutionTime: number;
+    /** Average execution time (milliseconds) */
+    averageExecutionTime: number;
+    /** Number of successful executions */
+    successCount: number;
+    /** Number of failed executions */
+    failureCount: number;
+    /** Last execution timestamp */
+    lastExecuted?: Date;
+}
+/**
+ * Tool Registry
+ *
+ * Manages tool executor instances and provides execution interface
+ */
+export declare class ToolRegistry {
+    private config;
+    /** Registered tool executors */
+    private tools;
+    /** Execution statistics */
+    private stats;
+    constructor(config: ExecutorConfig);
+    /**
+     * Register a tool executor
+     *
+     * @param tool Tool executor instance
+     * @throws Error if tool with same name already registered
+     */
+    registerTool(tool: BaseTool<any, any>): void;
+    /**
+     * Update executor config (e.g., add sessionId after session creation)
+     *
+     * @param updates Partial config updates
+     */
+    updateConfig(updates: Partial<ExecutorConfig>): void;
+    /**
+     * Get current config
+     *
+     * @returns Current executor config
+     */
+    getConfig(): ExecutorConfig;
+    /**
+     * Unregister a tool executor
+     *
+     * @param name Tool name
+     * @returns true if tool was removed, false if not found
+     */
+    unregisterTool(name: string): boolean;
+    /**
+     * Get a tool executor by name
+     *
+     * @param name Tool name
+     * @returns Tool executor or undefined if not found
+     */
+    getTool(name: string): BaseTool<any, any> | undefined;
+    /**
+     * Check if a tool is registered
+     *
+     * @param name Tool name
+     * @returns true if registered, false otherwise
+     */
+    hasTool(name: string): boolean;
+    /**
+     * Get all registered tool names
+     *
+     * @returns Array of tool names
+     */
+    getToolNames(): string[];
+    /**
+     * Get count of registered tools
+     *
+     * @returns Number of registered tools
+     */
+    getToolCount(): number;
+    /**
+     * Execute a tool by name
+     *
+     * Main execution method that:
+     * 1. Validates tool exists
+     * 2. Validates parameters
+     * 3. Executes tool
+     * 4. Handles errors
+     * 5. Updates statistics
+     *
+     * @param name Tool name
+     * @param params Tool parameters
+     * @param signal AbortSignal for cancellation
+     * @param updateOutput Optional callback for streaming output
+     * @returns Tool execution result
+     */
+    executeTool(name: string, params: any, signal?: AbortSignal, updateOutput?: (output: string) => void): Promise<ToolResult>;
+    /**
+     * Get execution statistics for a tool
+     *
+     * @param name Tool name
+     * @returns Statistics or undefined if tool not found
+     */
+    getToolStats(name: string): ToolExecutionStats | undefined;
+    /**
+     * Get execution statistics for all tools
+     *
+     * @returns Map of tool name to statistics
+     */
+    getAllStats(): Map<string, ToolExecutionStats>;
+    /**
+     * Reset statistics for a tool
+     *
+     * @param name Tool name
+     */
+    resetToolStats(name: string): void;
+    /**
+     * Reset statistics for all tools
+     */
+    resetAllStats(): void;
+    /**
+     * Update execution statistics
+     *
+     * @private
+     */
+    private updateStats;
+}
+//# sourceMappingURL=ToolRegistry.d.ts.map

package/dist/base/ToolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRegistry.d.ts","sourceRoot":"","sources":["../../src/base/ToolRegistry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IAEjB,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAC;IAEvB,0CAA0C;IAC1C,kBAAkB,EAAE,MAAM,CAAC;IAE3B,4CAA4C;IAC5C,oBAAoB,EAAE,MAAM,CAAC;IAE7B,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IAErB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IAErB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,IAAI,CAAC;CACrB;AAED;;;;GAIG;AACH,qBAAa,YAAY;IAOX,OAAO,CAAC,MAAM;IAN1B,gCAAgC;IAChC,OAAO,CAAC,KAAK,CAA8C;IAE3D,2BAA2B;IAC3B,OAAO,CAAC,KAAK,CAA8C;gBAEvC,MAAM,EAAE,cAAc;IAE1C;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI;IAkB5C;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAIpD;;;;OAIG;IACH,SAAS,IAAI,cAAc;IAI3B;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQrC;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,SAAS;IAIrD;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B;;;;OAIG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;;;OAIG;IACH,YAAY,IAAI,MAAM;IAItB;;;;;;;;;;;;;;;OAeG;IACG,WAAW,CACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,GAAG,EACX,MAAM,CAAC,EAAE,WAAW,EACpB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,UAAU,CAAC;IAiEtB;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI1D;;;;OAIG;IACH,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAI9C;;;;OAIG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAclC;;OAEG;IACH,aAAa,IAAI,IAAI;IAMrB;;;;OAIG;IACH,OAAO,CAAC,WAAW;CAepB"}

package/dist/base/ToolRegistry.js

@@ -0,0 +1,241 @@
+/**
+ * Tool Registry
+ *
+ * Manages registration and execution of tool executors
+ * Central coordination point for all tool execution in Nexus Cortex
+ */
+/**
+ * Tool Registry
+ *
+ * Manages tool executor instances and provides execution interface
+ */
+export class ToolRegistry {
+    config;
+    /** Registered tool executors */
+    tools = new Map();
+    /** Execution statistics */
+    stats = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Register a tool executor
+     *
+     * @param tool Tool executor instance
+     * @throws Error if tool with same name already registered
+     */
+    registerTool(tool) {
+        if (this.tools.has(tool.name)) {
+            throw new Error(`Tool '${tool.name}' is already registered`);
+        }
+        this.tools.set(tool.name, tool);
+        // Initialize stats
+        this.stats.set(tool.name, {
+            toolName: tool.name,
+            executionCount: 0,
+            totalExecutionTime: 0,
+            averageExecutionTime: 0,
+            successCount: 0,
+            failureCount: 0,
+        });
+    }
+    /**
+     * Update executor config (e.g., add sessionId after session creation)
+     *
+     * @param updates Partial config updates
+     */
+    updateConfig(updates) {
+        this.config = { ...this.config, ...updates };
+    }
+    /**
+     * Get current config
+     *
+     * @returns Current executor config
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Unregister a tool executor
+     *
+     * @param name Tool name
+     * @returns true if tool was removed, false if not found
+     */
+    unregisterTool(name) {
+        const removed = this.tools.delete(name);
+        if (removed) {
+            this.stats.delete(name);
+        }
+        return removed;
+    }
+    /**
+     * Get a tool executor by name
+     *
+     * @param name Tool name
+     * @returns Tool executor or undefined if not found
+     */
+    getTool(name) {
+        return this.tools.get(name);
+    }
+    /**
+     * Check if a tool is registered
+     *
+     * @param name Tool name
+     * @returns true if registered, false otherwise
+     */
+    hasTool(name) {
+        return this.tools.has(name);
+    }
+    /**
+     * Get all registered tool names
+     *
+     * @returns Array of tool names
+     */
+    getToolNames() {
+        return Array.from(this.tools.keys());
+    }
+    /**
+     * Get count of registered tools
+     *
+     * @returns Number of registered tools
+     */
+    getToolCount() {
+        return this.tools.size;
+    }
+    /**
+     * Execute a tool by name
+     *
+     * Main execution method that:
+     * 1. Validates tool exists
+     * 2. Validates parameters
+     * 3. Executes tool
+     * 4. Handles errors
+     * 5. Updates statistics
+     *
+     * @param name Tool name
+     * @param params Tool parameters
+     * @param signal AbortSignal for cancellation
+     * @param updateOutput Optional callback for streaming output
+     * @returns Tool execution result
+     */
+    async executeTool(name, params, signal, updateOutput) {
+        const startTime = Date.now();
+        // Get tool
+        const tool = this.tools.get(name);
+        if (!tool) {
+            return {
+                llmContent: `Tool "${name}" not found`,
+                returnDisplay: `Error: Tool "${name}" not found`,
+                success: false,
+                error: `Unknown tool: ${name}`,
+            };
+        }
+        // Validate parameters
+        const validationError = tool.validateToolParams(params);
+        if (validationError) {
+            this.updateStats(name, false, Date.now() - startTime);
+            return {
+                llmContent: `Invalid parameters: ${validationError}`,
+                returnDisplay: `Parameter validation failed: ${validationError}`,
+                success: false,
+                error: validationError,
+            };
+        }
+        // Create abort signal if not provided
+        const abortSignal = signal || new AbortController().signal;
+        // Execute tool
+        try {
+            const result = await tool.execute(params, abortSignal, updateOutput);
+            // Update stats
+            const executionTime = Date.now() - startTime;
+            this.updateStats(name, result.success, executionTime);
+            // Add execution time to metadata if not already present
+            if (!result.metadata?.executionTime) {
+                result.metadata = {
+                    ...result.metadata,
+                    executionTime,
+                };
+            }
+            return result;
+        }
+        catch (error) {
+            // Handle execution error
+            const executionTime = Date.now() - startTime;
+            this.updateStats(name, false, executionTime);
+            return {
+                llmContent: `Tool execution failed: ${error.message}`,
+                returnDisplay: `Execution error: ${error.message}`,
+                success: false,
+                error: error.message,
+                metadata: {
+                    executionTime,
+                    errorStack: error.stack,
+                },
+            };
+        }
+    }
+    /**
+     * Get execution statistics for a tool
+     *
+     * @param name Tool name
+     * @returns Statistics or undefined if tool not found
+     */
+    getToolStats(name) {
+        return this.stats.get(name);
+    }
+    /**
+     * Get execution statistics for all tools
+     *
+     * @returns Map of tool name to statistics
+     */
+    getAllStats() {
+        return new Map(this.stats);
+    }
+    /**
+     * Reset statistics for a tool
+     *
+     * @param name Tool name
+     */
+    resetToolStats(name) {
+        const tool = this.tools.get(name);
+        if (tool) {
+            this.stats.set(name, {
+                toolName: name,
+                executionCount: 0,
+                totalExecutionTime: 0,
+                averageExecutionTime: 0,
+                successCount: 0,
+                failureCount: 0,
+            });
+        }
+    }
+    /**
+     * Reset statistics for all tools
+     */
+    resetAllStats() {
+        for (const name of this.tools.keys()) {
+            this.resetToolStats(name);
+        }
+    }
+    /**
+     * Update execution statistics
+     *
+     * @private
+     */
+    updateStats(name, success, executionTime) {
+        const stats = this.stats.get(name);
+        if (!stats)
+            return;
+        stats.executionCount++;
+        stats.totalExecutionTime += executionTime;
+        stats.averageExecutionTime = stats.totalExecutionTime / stats.executionCount;
+        stats.lastExecuted = new Date();
+        if (success) {
+            stats.successCount++;
+        }
+        else {
+            stats.failureCount++;
+        }
+    }
+}
+//# sourceMappingURL=ToolRegistry.js.map

package/dist/base/ToolRegistry.js.map

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

package/dist/base/ToolResult.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Tool Execution Result
+ *
+ * Standardized result format for all tool executions
+ * Adapted from Gemini CLI patterns for V4
+ */
+import type { CanonicalContentBlock } from '@nexus-cortex/types';
+/**
+ * Result from tool execution
+ */
+export interface ToolResult {
+    /**
+     * Content to send back to LLM
+     * Can be string or structured content blocks
+     */
+    llmContent: string | CanonicalContentBlock[];
+    /**
+     * Content to display to user (optional)
+     * If not provided, llmContent is used
+     */
+    returnDisplay?: string;
+    /**
+     * Whether execution was successful
+     */
+    success: boolean;
+    /**
+     * Error message if failed
+     */
+    error?: string;
+    /**
+     * Metadata about execution
+     */
+    metadata?: {
+        /** Execution time in milliseconds */
+        executionTime?: number;
+        /** Resources accessed during execution */
+        resourcesUsed?: {
+            /** Files read or written */
+            files?: string[];
+            /** Network endpoints accessed */
+            network?: string[];
+            /** Shell commands executed */
+            commands?: string[];
+        };
+        /** Any additional tool-specific metadata */
+        [key: string]: any;
+    };
+}
+/**
+ * Tool call confirmation details
+ * Used for tools that require user confirmation before execution
+ */
+export interface ToolCallConfirmationDetails {
+    /** Human-readable description of what the tool will do */
+    description: string;
+    /** Whether confirmation is required */
+    requiresConfirmation: boolean;
+    /** Severity level for UI display */
+    severity?: 'info' | 'warning' | 'danger';
+    /** Additional context for confirmation prompt */
+    context?: string;
+}
+//# sourceMappingURL=ToolResult.d.ts.map

package/dist/base/ToolResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolResult.d.ts","sourceRoot":"","sources":["../../src/base/ToolResult.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,UAAU,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAAC;IAE7C;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,qCAAqC;QACrC,aAAa,CAAC,EAAE,MAAM,CAAC;QAEvB,0CAA0C;QAC1C,aAAa,CAAC,EAAE;YACd,4BAA4B;YAC5B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;YAEjB,iCAAiC;YACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;YAEnB,8BAA8B;YAC9B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;SACrB,CAAC;QAEF,4CAA4C;QAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IAEpB,uCAAuC;IACvC,oBAAoB,EAAE,OAAO,CAAC;IAE9B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IAEzC,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/base/ToolResult.js

@@ -0,0 +1,8 @@
+/**
+ * Tool Execution Result
+ *
+ * Standardized result format for all tool executions
+ * Adapted from Gemini CLI patterns for V4
+ */
+export {};
+//# sourceMappingURL=ToolResult.js.map

package/dist/base/ToolResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolResult.js","sourceRoot":"","sources":["../../src/base/ToolResult.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/base/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Base Executor Components
+ *
+ * Foundation classes and interfaces for tool execution
+ */
+export { BaseTool } from './BaseTool.js';
+export { ToolRegistry, type ToolExecutionStats } from './ToolRegistry.js';
+export { type ToolResult, type ToolCallConfirmationDetails } from './ToolResult.js';
+export type { ExecutorConfig } from '@nexus-cortex/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/base/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/base/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACpF,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/base/index.js

@@ -0,0 +1,8 @@
+/**
+ * Base Executor Components
+ *
+ * Foundation classes and interfaces for tool execution
+ */
+export { BaseTool } from './BaseTool.js';
+export { ToolRegistry } from './ToolRegistry.js';
+//# sourceMappingURL=index.js.map

package/dist/base/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/base/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAA2B,MAAM,mBAAmB,CAAC"}