@nexus-cortex/executors 4.26.0

package/dist/implementations/historical/RequestHistoricalContextTool.js

@@ -0,0 +1,224 @@
+/**
+ * RequestHistoricalContext Tool Executor
+ *
+ * Requests historical context using a cheap helper model (e.g., FREE Gemma).
+ * Cost-effective way to access archived context outside the main model's window.
+ */
+import { BaseTool } from '../../base/index.js';
+import { SchemaValidator } from '../../utils/SchemaValidator.js';
+import { RequestHistoricalContextTool as CoreRequestContextTool, JSONLHistoryStore, } from '@nexus-cortex/core';
+/**
+ * RequestHistoricalContext Tool Executor
+ *
+ * Features:
+ * - Uses FREE Gemma models for cost-effective context retrieval
+ * - Searches both recent and compacted history
+ * - Configurable detail level
+ * - Returns sources and cost information
+ */
+export class RequestHistoricalContextToolExecutor extends BaseTool {
+    config;
+    constructor(config) {
+        super('RequestHistoricalContext', 'RequestHistoricalContext', `Request historical context using cheap helper model. Cost-effective for accessing archived context.
+
+Uses FREE Gemma models to generate context from historical conversation data.`, {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Query describing what historical context is needed',
+                },
+                detailLevel: {
+                    type: 'string',
+                    enum: ['brief', 'standard', 'detailed'],
+                    description: 'Detail level for the response',
+                    default: 'standard',
+                },
+                maxTokens: {
+                    type: 'number',
+                    description: 'Maximum tokens for the response',
+                    default: 1000,
+                },
+                useHelperModel: {
+                    type: 'boolean',
+                    description: 'Whether to use helper model (vs main model)',
+                    default: true,
+                },
+            },
+            required: ['query'],
+        });
+        this.config = config;
+    }
+    /**
+     * Get workspace root from config (dynamically resolved)
+     */
+    getWorkspaceRoot() {
+        return this.config.workspaceRoot || this.config.storageDir || this.config.workingDirectory;
+    }
+    validateToolParams(params) {
+        // Schema validation
+        const schemaError = SchemaValidator.validate(this.parameterSchema, params);
+        if (schemaError) {
+            return schemaError;
+        }
+        // Validate query
+        if (!params.query || params.query.trim().length === 0) {
+            return 'Query cannot be empty.';
+        }
+        if (params.query.length > 1000) {
+            return 'Query too long (max 1000 characters).';
+        }
+        // Validate detailLevel
+        if (params.detailLevel && !['brief', 'standard', 'detailed'].includes(params.detailLevel)) {
+            return `Invalid detailLevel: ${params.detailLevel}. Must be 'brief', 'standard', or 'detailed'.`;
+        }
+        // Validate maxTokens
+        if (params.maxTokens !== undefined) {
+            if (params.maxTokens < 100) {
+                return 'maxTokens must be at least 100.';
+            }
+            if (params.maxTokens > 10000) {
+                return 'maxTokens cannot exceed 10000.';
+            }
+        }
+        return null;
+    }
+    getDescription(params) {
+        const detailLevel = params.detailLevel || 'standard';
+        return `Requesting historical context for "${params.query}" (${detailLevel})`;
+    }
+    async execute(params, signal, updateOutput) {
+        const startTime = Date.now();
+        try {
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Context request was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Validate parameters
+            const validationError = this.validateToolParams(params);
+            if (validationError) {
+                return {
+                    ...this.createErrorResult(validationError),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Get session ID from config
+            const sessionId = this.config.sessionId;
+            if (!sessionId) {
+                return {
+                    ...this.createErrorResult('Session ID not provided in executor config. Historical tools require active session context.'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Get storage directory from config (updated after session creation)
+            const storageDir = this.config.storageDir || '.cortex/sessions';
+            const workspaceRoot = this.getWorkspaceRoot();
+            // Create history store with storage directory
+            const historyStore = new JSONLHistoryStore({ baseDir: storageDir });
+            // Load messages from session storage (without workspacePath to use baseDir directly)
+            const messages = await historyStore.loadSession(sessionId);
+            if (messages.length === 0) {
+                return {
+                    ...this.createSuccessResult('No historical context available in this session.'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                        sessionId,
+                        messageCount: 0,
+                    },
+                };
+            }
+            // Note: The core tool requires HelperMiddlewareAdapter which may not be available
+            // in the executor context. For now, we'll create the tool without it and rely
+            // on it using stored compaction summaries instead of generating new context.
+            const coreTool = new CoreRequestContextTool(workspaceRoot);
+            const input = {
+                query: params.query,
+                detailLevel: params.detailLevel,
+                maxTokens: params.maxTokens,
+                useHelperModel: params.useHelperModel,
+            };
+            const result = await coreTool.execute(input, sessionId, messages);
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Context request was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Format output
+            const formattedOutput = this.formatContext(result, params.query);
+            return {
+                ...this.createSuccessResult(formattedOutput),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    sessionId,
+                    tokensUsed: result.tokensUsed,
+                    modelUsed: result.modelUsed,
+                    cost: result.cost,
+                    processingTime: result.processingTime,
+                    sourceCount: result.sources.length,
+                },
+            };
+        }
+        catch (error) {
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Context request was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            const errorMessage = error.message || String(error);
+            return {
+                ...this.createErrorResult(`Error requesting historical context: ${errorMessage}`),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    error: errorMessage,
+                },
+            };
+        }
+    }
+    /**
+     * Format historical context result for display
+     */
+    formatContext(result, query) {
+        const lines = [];
+        lines.push(`=== Historical Context for "${query}" ===\n\n`);
+        lines.push('## Context\n\n');
+        lines.push(result.context);
+        lines.push('\n\n');
+        lines.push('## Sources\n\n');
+        if (result.sources.length === 0) {
+            lines.push('No specific sources referenced.\n');
+        }
+        else {
+            result.sources.forEach((source, index) => {
+                lines.push(`${index + 1}. Turn ${source.turnNumber} (${source.timestamp.toLocaleString()})\n`);
+                if (source.isCompacted) {
+                    lines.push(` From compacted section: ${source.compactionId}\n`);
+                }
+            });
+        }
+        lines.push('\n');
+        lines.push('## Metadata\n\n');
+        lines.push(`Model used: ${result.modelUsed}\n`);
+        lines.push(`Tokens used: ${result.tokensUsed}\n`);
+        lines.push(`Processing time: ${result.processingTime}ms\n`);
+        lines.push(`Cost: $${result.cost.toFixed(6)}\n`);
+        return lines.join('');
+    }
+}
+//# sourceMappingURL=RequestHistoricalContextTool.js.map

package/dist/implementations/historical/RequestHistoricalContextTool.js.map

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

package/dist/implementations/historical/SearchConversationHistoryTool.d.ts

@@ -0,0 +1,51 @@
+/**
+ * SearchConversationHistory Tool Executor
+ *
+ * Searches conversation history including both recent messages and compacted boundaries.
+ * Provides semantic search across the full conversation timeline.
+ */
+import { BaseTool, type ToolResult } from '../../base/index.js';
+import type { ExecutorConfig } from '../../base/ToolRegistry.js';
+/**
+ * Parameters for the SearchConversationHistory tool
+ */
+export interface SearchConversationHistoryToolParams {
+    /** Search query string */
+    query: string;
+    /** Maximum number of results to return */
+    maxResults?: number;
+    /** Time range filter */
+    timeRange?: {
+        start: string;
+        end: string;
+    };
+    /** Include compacted messages in search */
+    includeCompacted?: boolean;
+    /** Search scope: 'current' (current session), 'all' (all sessions), or specific session IDs */
+    searchScope?: 'current' | 'all' | string[];
+}
+/**
+ * SearchConversationHistory Tool Executor
+ *
+ * Features:
+ * - Searches both recent and compacted messages
+ * - Semantic search with relevance scoring
+ * - Time range filtering
+ * - Configurable result limit
+ */
+export declare class SearchConversationHistoryToolExecutor extends BaseTool<SearchConversationHistoryToolParams, ToolResult> {
+    private config;
+    constructor(config: ExecutorConfig);
+    /**
+     * Get storage directory from config (dynamically resolved)
+     */
+    private getStorageDir;
+    validateToolParams(params: SearchConversationHistoryToolParams): string | null;
+    getDescription(params: SearchConversationHistoryToolParams): string;
+    execute(params: SearchConversationHistoryToolParams, signal: AbortSignal, updateOutput?: (output: string) => void): Promise<ToolResult>;
+    /**
+     * Format search results for display
+     */
+    private formatResults;
+}
+//# sourceMappingURL=SearchConversationHistoryTool.d.ts.map

package/dist/implementations/historical/SearchConversationHistoryTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchConversationHistoryTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/historical/SearchConversationHistoryTool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAOjE;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IAEd,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,wBAAwB;IACxB,SAAS,CAAC,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IAEF,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,+FAA+F;IAC/F,WAAW,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,EAAE,CAAC;CAC5C;AAED;;;;;;;;GAQG;AACH,qBAAa,qCAAsC,SAAQ,QAAQ,CACjE,mCAAmC,EACnC,UAAU,CACX;IACa,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAoD1C;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB,kBAAkB,CAAC,MAAM,EAAE,mCAAmC,GAAG,MAAM,GAAG,IAAI;IAiD9E,cAAc,CAAC,MAAM,EAAE,mCAAmC,GAAG,MAAM;IAK7D,OAAO,CACX,MAAM,EAAE,mCAAmC,EAC3C,MAAM,EAAE,WAAW,EACnB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,UAAU,CAAC;IA8JtB;;OAEG;IACH,OAAO,CAAC,aAAa;CA4CtB"}

package/dist/implementations/historical/SearchConversationHistoryTool.js

@@ -0,0 +1,306 @@
+/**
+ * SearchConversationHistory Tool Executor
+ *
+ * Searches conversation history including both recent messages and compacted boundaries.
+ * Provides semantic search across the full conversation timeline.
+ */
+import { BaseTool } from '../../base/index.js';
+import { SchemaValidator } from '../../utils/SchemaValidator.js';
+import { SearchConversationHistoryTool as CoreSearchTool, JSONLHistoryStore, } from '@nexus-cortex/core';
+/**
+ * SearchConversationHistory Tool Executor
+ *
+ * Features:
+ * - Searches both recent and compacted messages
+ * - Semantic search with relevance scoring
+ * - Time range filtering
+ * - Configurable result limit
+ */
+export class SearchConversationHistoryToolExecutor extends BaseTool {
+    config;
+    constructor(config) {
+        super('SearchConversationHistory', 'SearchConversationHistory', `Search conversation history across ALL previous sessions and current session.
+
+Use this tool to:
+- Find messages from previous conversations/sessions
+- Search across all historical session data (default behavior)
+- Locate specific topics or information from past interactions
+
+By default searches ALL sessions. Use searchScope parameter to limit to current session only.`, {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query string',
+                },
+                maxResults: {
+                    type: 'number',
+                    description: 'Maximum number of results to return',
+                    default: 10,
+                },
+                timeRange: {
+                    type: 'object',
+                    properties: {
+                        start: { type: 'string', format: 'date-time' },
+                        end: { type: 'string', format: 'date-time' },
+                    },
+                    description: 'Optional time range filter',
+                },
+                includeCompacted: {
+                    type: 'boolean',
+                    description: 'Include compacted messages in search',
+                    default: true,
+                },
+                searchScope: {
+                    type: 'string',
+                    oneOf: [
+                        { type: 'string', enum: ['current', 'all'] },
+                        { type: 'array', items: { type: 'string' } }
+                    ],
+                    description: 'Search scope: "current" (current session only), "all" (all sessions), or array of specific session IDs. Defaults to "all" to search across all sessions.',
+                    default: 'all',
+                },
+            },
+            required: ['query'],
+        });
+        this.config = config;
+    }
+    /**
+     * Get storage directory from config (dynamically resolved)
+     */
+    getStorageDir() {
+        return this.config.storageDir || '.cortex/sessions';
+    }
+    validateToolParams(params) {
+        // Schema validation
+        const schemaError = SchemaValidator.validate(this.parameterSchema, params);
+        if (schemaError) {
+            return schemaError;
+        }
+        // Validate query
+        if (!params.query || params.query.trim().length === 0) {
+            return 'Query cannot be empty.';
+        }
+        if (params.query.length > 1000) {
+            return 'Query too long (max 1000 characters).';
+        }
+        // Validate maxResults
+        if (params.maxResults !== undefined) {
+            if (params.maxResults < 1) {
+                return 'maxResults must be at least 1.';
+            }
+            if (params.maxResults > 100) {
+                return 'maxResults cannot exceed 100.';
+            }
+        }
+        // Validate time range if provided
+        if (params.timeRange) {
+            try {
+                const start = new Date(params.timeRange.start);
+                const end = new Date(params.timeRange.end);
+                if (isNaN(start.getTime())) {
+                    return 'Invalid start date in timeRange.';
+                }
+                if (isNaN(end.getTime())) {
+                    return 'Invalid end date in timeRange.';
+                }
+                if (start > end) {
+                    return 'Time range start must be before end.';
+                }
+            }
+            catch (error) {
+                return `Invalid time range: ${error.message}`;
+            }
+        }
+        return null;
+    }
+    getDescription(params) {
+        const maxResults = params.maxResults || 10;
+        return `Searching conversation history for "${params.query}" (max ${maxResults} results)`;
+    }
+    async execute(params, signal, updateOutput) {
+        const startTime = Date.now();
+        try {
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Search was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Validate parameters
+            const validationError = this.validateToolParams(params);
+            if (validationError) {
+                return {
+                    ...this.createErrorResult(validationError),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Get session ID from config
+            const sessionId = this.config.sessionId;
+            if (!sessionId) {
+                return {
+                    ...this.createErrorResult('Session ID not provided in executor config. Historical tools require active session context.'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Get storage directory and create history store
+            const storageDir = this.getStorageDir();
+            const workspaceRoot = this.config.workspaceRoot || storageDir;
+            const historyStore = new JSONLHistoryStore({ baseDir: storageDir });
+            // Determine which sessions to search
+            const searchScope = params.searchScope || 'all';
+            let sessionIdsToSearch = [];
+            if (searchScope === 'current') {
+                // Search only current session
+                sessionIdsToSearch = [sessionId];
+            }
+            else if (searchScope === 'all') {
+                // Search all sessions
+                const allSessions = await historyStore.listSessions();
+                sessionIdsToSearch = allSessions.map((s) => s.sessionId);
+            }
+            else if (Array.isArray(searchScope)) {
+                // Search specific session IDs
+                sessionIdsToSearch = searchScope;
+            }
+            // Load messages from all sessions in scope
+            const allMessages = [];
+            const sessionMessageCounts = {};
+            for (const sid of sessionIdsToSearch) {
+                try {
+                    const messages = await historyStore.loadSession(sid);
+                    // Tag each message with its source session ID for cross-session search
+                    const taggedMessages = messages.map(msg => ({
+                        ...msg,
+                        _sourceSessionId: sid
+                    }));
+                    allMessages.push(...taggedMessages);
+                    sessionMessageCounts[sid] = messages.length;
+                }
+                catch (error) {
+                    // Skip sessions that can't be loaded
+                    console.warn(`Failed to load session ${sid}: ${error}`);
+                }
+            }
+            if (allMessages.length === 0) {
+                return {
+                    ...this.createSuccessResult('No messages found in session history.'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                        sessionId,
+                        sessionsSearched: sessionIdsToSearch.length,
+                        messageCount: 0,
+                        resultCount: 0,
+                    },
+                };
+            }
+            // Convert time range to Date objects if provided
+            const timeRange = params.timeRange
+                ? {
+                    start: new Date(params.timeRange.start),
+                    end: new Date(params.timeRange.end),
+                }
+                : undefined;
+            // Create core tool and execute search across all messages
+            const coreTool = new CoreSearchTool(workspaceRoot);
+            const input = {
+                query: params.query,
+                maxResults: params.maxResults,
+                timeRange,
+                includeCompacted: params.includeCompacted,
+            };
+            const results = await coreTool.execute(input, sessionId, allMessages);
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Search was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Format results
+            const formattedOutput = this.formatResults(results, params.query);
+            return {
+                ...this.createSuccessResult(formattedOutput),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    sessionId,
+                    sessionsSearched: sessionIdsToSearch.length,
+                    messageCount: allMessages.length,
+                    resultCount: results.length,
+                    query: params.query,
+                    searchScope: searchScope,
+                },
+            };
+        }
+        catch (error) {
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Search was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            const errorMessage = error.message || String(error);
+            return {
+                ...this.createErrorResult(`Error searching conversation history: ${errorMessage}`),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    error: errorMessage,
+                },
+            };
+        }
+    }
+    /**
+     * Format search results for display
+     */
+    formatResults(results, query) {
+        if (results.length === 0) {
+            return `No results found for "${query}".`;
+        }
+        const lines = [];
+        lines.push(`=== Search Results for "${query}" ===\n\n`);
+        lines.push(`Found ${results.length} result${results.length > 1 ? 's' : ''}:\n\n`);
+        // Group results by session for clarity
+        const resultsBySession = new Map();
+        results.forEach(result => {
+            const sessionResults = resultsBySession.get(result.sessionId) || [];
+            sessionResults.push(result);
+            resultsBySession.set(result.sessionId, sessionResults);
+        });
+        let globalIndex = 0;
+        resultsBySession.forEach((sessionResults, sessionId) => {
+            if (resultsBySession.size > 1) {
+                // Show session header if results span multiple sessions
+                lines.push(`--- Session: ${sessionId} (${sessionResults.length} result${sessionResults.length > 1 ? 's' : ''}) ---\n\n`);
+            }
+            sessionResults.forEach((result) => {
+                globalIndex++;
+                lines.push(`${globalIndex}. Turn ${result.turnNumber} (${result.timestamp.toLocaleString()})\n`);
+                if (resultsBySession.size === 1) {
+                    lines.push(` Session: ${result.sessionId}\n`);
+                }
+                lines.push(` Relevance: ${result.relevanceScore}%\n`);
+                if (result.isCompacted) {
+                    lines.push(` Source: Compacted section (ID: ${result.compactionId})\n`);
+                }
+                else {
+                    lines.push(` Source: Message ${result.messageId}\n`);
+                }
+                lines.push(` Preview: ${result.preview}\n\n`);
+            });
+        });
+        return lines.join('');
+    }
+}
+//# sourceMappingURL=SearchConversationHistoryTool.js.map

package/dist/implementations/historical/SearchConversationHistoryTool.js.map

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

package/dist/implementations/historical/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Historical Tools
+ *
+ * Tools for accessing conversation history, compaction boundaries, and historical context
+ */
+export * from './SearchConversationHistoryTool.js';
+export * from './GetConversationSegmentTool.js';
+export * from './ListCompactionBoundariesTool.js';
+export * from './RequestHistoricalContextTool.js';
+export * from './ListSessionsTool.js';
+export * from './LoadSessionTool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/implementations/historical/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/implementations/historical/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oCAAoC,CAAC;AACnD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}

package/dist/implementations/historical/index.js

@@ -0,0 +1,12 @@
+/**
+ * Historical Tools
+ *
+ * Tools for accessing conversation history, compaction boundaries, and historical context
+ */
+export * from './SearchConversationHistoryTool.js';
+export * from './GetConversationSegmentTool.js';
+export * from './ListCompactionBoundariesTool.js';
+export * from './RequestHistoricalContextTool.js';
+export * from './ListSessionsTool.js';
+export * from './LoadSessionTool.js';
+//# sourceMappingURL=index.js.map

package/dist/implementations/historical/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/implementations/historical/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oCAAoC,CAAC;AACnD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}

package/dist/implementations/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tool Executor Implementations
+ */
+export * from './file/index.js';
+export * from './search/index.js';
+export * from './web/index.js';
+export * from './execution/index.js';
+export * from './ui/index.js';
+export * from './notebook/index.js';
+export * from './historical/index.js';
+export * from './mcp/index.js';
+export * from './extensions/index.js';
+export * from './agent/index.js';
+export * from './addon/index.js';
+export * from './tmux/index.js';
+//# sourceMappingURL=index.d.ts.map