@nexus-cortex/executors 4.26.0

package/dist/implementations/historical/ListCompactionBoundariesTool.js

@@ -0,0 +1,174 @@
+/**
+ * ListCompactionBoundaries Tool Executor
+ *
+ * Lists all compaction boundaries (conversation summaries) with metadata.
+ * Provides an overview of the compaction history for the session.
+ */
+import { BaseTool } from '../../base/index.js';
+import { SchemaValidator } from '../../utils/SchemaValidator.js';
+import { ListCompactionBoundariesTool as CoreListBoundariesTool, } from '@nexus-cortex/core';
+/**
+ * ListCompactionBoundaries Tool Executor
+ *
+ * Features:
+ * - Lists all compaction boundaries chronologically
+ * - Shows token savings and compression ratios
+ * - Optional detailed metadata (topics, decisions, tools used)
+ */
+export class ListCompactionBoundariesToolExecutor extends BaseTool {
+    config;
+    workspaceRoot;
+    constructor(config) {
+        super('ListCompactionBoundaries', 'ListCompactionBoundaries', `List compaction boundaries within the CURRENT session only.
+
+Shows where the current conversation has been compressed/summarized to save tokens.
+This is NOT for finding previous sessions - use SearchConversationHistory for that.`, {
+            type: 'object',
+            properties: {
+                includeMetadata: {
+                    type: 'boolean',
+                    description: 'Include detailed metadata in response',
+                    default: true,
+                },
+            },
+        });
+        this.config = config;
+        this.workspaceRoot = config.workspaceRoot || config.workingDirectory;
+    }
+    validateToolParams(params) {
+        // Schema validation
+        const schemaError = SchemaValidator.validate(this.parameterSchema, params);
+        if (schemaError) {
+            return schemaError;
+        }
+        return null;
+    }
+    getDescription(params) {
+        return `Listing compaction boundaries${params.includeMetadata !== false ? ' with metadata' : ''}`;
+    }
+    async execute(params, signal, updateOutput) {
+        const startTime = Date.now();
+        try {
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Listing 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,
+                    },
+                };
+            }
+            // Create core tool and execute
+            const coreTool = new CoreListBoundariesTool(this.workspaceRoot);
+            const input = {
+                includeMetadata: params.includeMetadata,
+            };
+            const boundaries = await coreTool.execute(input, sessionId);
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Listing was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Format output
+            const formattedOutput = this.formatBoundaries(boundaries, params.includeMetadata !== false);
+            return {
+                ...this.createSuccessResult(formattedOutput),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    sessionId,
+                    boundaryCount: boundaries.length,
+                },
+            };
+        }
+        catch (error) {
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Listing was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            const errorMessage = error.message || String(error);
+            return {
+                ...this.createErrorResult(`Error listing compaction boundaries: ${errorMessage}`),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    error: errorMessage,
+                },
+            };
+        }
+    }
+    /**
+     * Format compaction boundaries for display
+     */
+    formatBoundaries(boundaries, includeMetadata) {
+        if (boundaries.length === 0) {
+            return 'No compaction boundaries found in this session.';
+        }
+        const lines = [];
+        lines.push('=== Compaction Boundaries ===\n\n');
+        lines.push(`Total: ${boundaries.length} compaction${boundaries.length > 1 ? 's' : ''}\n\n`);
+        // Calculate totals
+        const totalSaved = boundaries.reduce((sum, b) => sum + b.tokens.saved, 0);
+        const totalOriginal = boundaries.reduce((sum, b) => sum + b.tokens.original, 0);
+        const totalCompressed = boundaries.reduce((sum, b) => sum + b.tokens.compressed, 0);
+        const avgCompressionRatio = totalOriginal > 0
+            ? ((totalCompressed / totalOriginal) * 100).toFixed(1)
+            : '0.0';
+        lines.push(`Total tokens saved: ${totalSaved}\n`);
+        lines.push(`Total original tokens: ${totalOriginal}\n`);
+        lines.push(`Total compressed tokens: ${totalCompressed}\n`);
+        lines.push(`Average compression ratio: ${avgCompressionRatio}%\n\n`);
+        lines.push('---\n\n');
+        // List each boundary
+        boundaries.forEach((boundary, index) => {
+            lines.push(`${index + 1}. Compaction ID: ${boundary.id}\n`);
+            lines.push(` Type: ${boundary.type}\n`);
+            lines.push(` Turns: ${boundary.turnRange.start} - ${boundary.turnRange.end}\n`);
+            lines.push(` Timestamp: ${boundary.timestamp.toLocaleString()}\n`);
+            lines.push(` Tokens: ${boundary.tokens.original} → ${boundary.tokens.compressed} (saved ${boundary.tokens.saved})\n`);
+            if (includeMetadata && boundary.metadata) {
+                lines.push(` Helper model: ${boundary.metadata.helperModel}\n`);
+                lines.push(` Cost: $${boundary.metadata.cost.toFixed(6)}\n`);
+                if (boundary.metadata.topics.length > 0) {
+                    lines.push(` Topics: ${boundary.metadata.topics.slice(0, 3).join(', ')}\n`);
+                }
+                if (boundary.metadata.toolsUsed.length > 0) {
+                    lines.push(` Tools used: ${boundary.metadata.toolsUsed.join(', ')}\n`);
+                }
+                if (boundary.metadata.summary) {
+                    lines.push(` Summary: ${boundary.metadata.summary.substring(0, 100)}...\n`);
+                }
+            }
+            lines.push('\n');
+        });
+        return lines.join('');
+    }
+}
+//# sourceMappingURL=ListCompactionBoundariesTool.js.map

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

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

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

@@ -0,0 +1,38 @@
+/**
+ * ListSessions Tool Executor
+ *
+ * Lists all available sessions with metadata for discovery and navigation.
+ */
+import { BaseTool, type ToolResult } from '../../base/index.js';
+import type { ExecutorConfig } from '../../base/ToolRegistry.js';
+/**
+ * Parameters for the ListSessions tool
+ */
+export interface ListSessionsToolParams {
+    /** Maximum number of sessions to return */
+    limit?: number;
+    /** Filter by minimum age in days */
+    minAgeDays?: number;
+    /** Filter by maximum age in days */
+    maxAgeDays?: number;
+    /** Sort order: 'newest' or 'oldest' */
+    sortBy?: 'newest' | 'oldest';
+}
+/**
+ * ListSessions Tool Executor
+ */
+export declare class ListSessionsToolExecutor extends BaseTool<ListSessionsToolParams, ToolResult> {
+    private config;
+    constructor(config: ExecutorConfig);
+    validateToolParams(params: ListSessionsToolParams): string | null;
+    execute(params: ListSessionsToolParams, signal: AbortSignal): Promise<ToolResult>;
+    /**
+     * Format sessions for display
+     */
+    private formatSessions;
+    /**
+     * Format file size
+     */
+    private formatFileSize;
+}
+//# sourceMappingURL=ListSessionsTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ListSessionsTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/historical/ListSessionsTool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAIjE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,uCAAuC;IACvC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC9B;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,QAAQ,CACpD,sBAAsB,EACtB,UAAU,CACX;IACa,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAwC1C,kBAAkB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI;IAK3D,OAAO,CACX,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,CAAC;IAyDtB;;OAEG;IACH,OAAO,CAAC,cAAc;IA8BtB;;OAEG;IACH,OAAO,CAAC,cAAc;CAKvB"}

package/dist/implementations/historical/ListSessionsTool.js

@@ -0,0 +1,140 @@
+/**
+ * ListSessions Tool Executor
+ *
+ * Lists all available sessions with metadata for discovery and navigation.
+ */
+import { BaseTool } from '../../base/index.js';
+import { ListSessionsTool as CoreListSessionsTool } from '@nexus-cortex/core';
+/**
+ * ListSessions Tool Executor
+ */
+export class ListSessionsToolExecutor extends BaseTool {
+    config;
+    constructor(config) {
+        super('ListSessions', 'ListSessions', `List all available conversation sessions to discover and browse past conversations.
+
+Use this tool to:
+- Browse all previous conversation sessions
+- Find sessions by age (recent or old)
+- See session metadata (message count, creation date, last activity)
+- Get session IDs for use with LoadSession tool
+
+Returns sessions sorted by most recent activity by default.`, {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of sessions to return',
+                    default: 50,
+                },
+                minAgeDays: {
+                    type: 'number',
+                    description: 'Filter sessions older than N days',
+                },
+                maxAgeDays: {
+                    type: 'number',
+                    description: 'Filter sessions newer than N days',
+                },
+                sortBy: {
+                    type: 'string',
+                    enum: ['newest', 'oldest'],
+                    description: 'Sort order by last activity',
+                    default: 'newest',
+                },
+            },
+        });
+        this.config = config;
+    }
+    validateToolParams(params) {
+        // All parameters are optional, nothing to validate
+        return null;
+    }
+    async execute(params, signal) {
+        const startTime = Date.now();
+        try {
+            const storageDir = this.config.storageDir || '.cortex/sessions';
+            const coreTool = new CoreListSessionsTool(storageDir);
+            const input = {
+                limit: params.limit,
+                minAgeDays: params.minAgeDays,
+                maxAgeDays: params.maxAgeDays,
+                sortBy: params.sortBy,
+            };
+            const sessions = await coreTool.execute(input);
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('List sessions was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Format output
+            const formattedOutput = this.formatSessions(sessions);
+            return {
+                ...this.createSuccessResult(formattedOutput),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    sessionCount: sessions.length,
+                    storageDir,
+                },
+            };
+        }
+        catch (error) {
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('List sessions was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            return {
+                ...this.createErrorResult(`Failed to list sessions: ${error.message}`),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    error: error.message,
+                },
+            };
+        }
+    }
+    /**
+     * Format sessions for display
+     */
+    formatSessions(sessions) {
+        if (sessions.length === 0) {
+            return 'No sessions found.';
+        }
+        const lines = [];
+        lines.push(`=== Available Sessions ===\n\n`);
+        lines.push(`Found ${sessions.length} session${sessions.length > 1 ? 's' : ''}:\n\n`);
+        sessions.forEach((session, index) => {
+            const createdDate = new Date(session.createdAt).toLocaleDateString();
+            const lastModDate = new Date(session.lastModified).toLocaleDateString();
+            const size = this.formatFileSize(session.fileSize);
+            lines.push(`${index + 1}. Session: ${session.sessionId}\n`);
+            if (session.title) {
+                lines.push(` Title: ${session.title}\n`);
+            }
+            lines.push(` Created: ${createdDate}\n`);
+            lines.push(` Last Activity: ${lastModDate} (${session.ageDays} days ago)\n`);
+            lines.push(` Messages: ${session.messageCount}\n`);
+            lines.push(` Size: ${size}\n`);
+            lines.push(` Compactions: ${session.compactionCount}\n\n`);
+        });
+        lines.push(`\nUse LoadSession with a sessionId to load full conversation history.`);
+        return lines.join('');
+    }
+    /**
+     * Format file size
+     */
+    formatFileSize(bytes) {
+        if (bytes < 1024)
+            return `${bytes} B`;
+        if (bytes < 1024 * 1024)
+            return `${(bytes / 1024).toFixed(1)} KB`;
+        return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+    }
+}
+//# sourceMappingURL=ListSessionsTool.js.map

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

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

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

@@ -0,0 +1,39 @@
+/**
+ * LoadSession Tool Executor
+ *
+ * Loads messages from a specific session to bring past conversation context
+ * into the current conversation.
+ */
+import { BaseTool, type ToolResult } from '../../base/index.js';
+import type { ExecutorConfig } from '../../base/ToolRegistry.js';
+/**
+ * Parameters for the LoadSession tool
+ */
+export interface LoadSessionToolParams {
+    /** Session ID to load */
+    sessionId: string;
+    /** Maximum number of messages to return */
+    limit?: number;
+    /** Start from message offset (for pagination) */
+    offset?: number;
+    /** Include system messages */
+    includeSystemMessages?: boolean;
+}
+/**
+ * LoadSession Tool Executor
+ */
+export declare class LoadSessionToolExecutor extends BaseTool<LoadSessionToolParams, ToolResult> {
+    private config;
+    constructor(config: ExecutorConfig);
+    validateToolParams(params: LoadSessionToolParams): string | null;
+    execute(params: LoadSessionToolParams, signal: AbortSignal): Promise<ToolResult>;
+    /**
+     * Format session messages for display
+     */
+    private formatSession;
+    /**
+     * Extract readable content from message
+     */
+    private extractMessageContent;
+}
+//# sourceMappingURL=LoadSessionTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LoadSessionTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/historical/LoadSessionTool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAIjE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAElB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8BAA8B;IAC9B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,QAAQ,CACnD,qBAAqB,EACrB,UAAU,CACX;IACa,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAyC1C,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI;IAO1D,OAAO,CACX,MAAM,EAAE,qBAAqB,EAC7B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,CAAC;IA4DtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkCrB;;OAEG;IACH,OAAO,CAAC,qBAAqB;CA2B9B"}

package/dist/implementations/historical/LoadSessionTool.js

@@ -0,0 +1,171 @@
+/**
+ * LoadSession Tool Executor
+ *
+ * Loads messages from a specific session to bring past conversation context
+ * into the current conversation.
+ */
+import { BaseTool } from '../../base/index.js';
+import { LoadSessionTool as CoreLoadSessionTool } from '@nexus-cortex/core';
+/**
+ * LoadSession Tool Executor
+ */
+export class LoadSessionToolExecutor extends BaseTool {
+    config;
+    constructor(config) {
+        super('LoadSession', 'LoadSession', `Load full message history from a specific previous session.
+
+Use this tool to:
+- Load complete conversation context from a past session
+- Access detailed message history beyond search results
+- Continue analysis from a previous conversation
+- Bring full context from identified sessions (via ListSessions or SearchConversationHistory)
+
+Returns actual messages with full content. Use pagination (limit/offset) for large sessions.`, {
+            type: 'object',
+            properties: {
+                sessionId: {
+                    type: 'string',
+                    description: 'Session ID to load (from ListSessions or SearchConversationHistory results)',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of messages to return',
+                    default: 100,
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Start from message offset (for pagination)',
+                    default: 0,
+                },
+                includeSystemMessages: {
+                    type: 'boolean',
+                    description: 'Include system messages in results',
+                    default: false,
+                },
+            },
+            required: ['sessionId'],
+        });
+        this.config = config;
+    }
+    validateToolParams(params) {
+        if (!params.sessionId || typeof params.sessionId !== 'string') {
+            return 'sessionId is required and must be a string';
+        }
+        return null;
+    }
+    async execute(params, signal) {
+        const startTime = Date.now();
+        try {
+            const storageDir = this.config.storageDir || '.cortex/sessions';
+            const coreTool = new CoreLoadSessionTool(storageDir);
+            const input = {
+                sessionId: params.sessionId,
+                limit: params.limit,
+                offset: params.offset,
+                includeSystemMessages: params.includeSystemMessages,
+            };
+            const result = await coreTool.execute(input);
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Load session was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Format output
+            const formattedOutput = this.formatSession(result);
+            return {
+                ...this.createSuccessResult(formattedOutput),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    sessionId: result.sessionId,
+                    totalMessages: result.totalMessageCount,
+                    returnedMessages: result.returnedMessageCount,
+                    hasMore: result.hasMore,
+                },
+            };
+        }
+        catch (error) {
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Load session was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            return {
+                ...this.createErrorResult(`Failed to load session: ${error.message}`),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    sessionId: params.sessionId,
+                    error: error.message,
+                },
+            };
+        }
+    }
+    /**
+     * Format session messages for display
+     */
+    formatSession(result) {
+        const lines = [];
+        lines.push(`=== Session: ${result.sessionId} ===\n\n`);
+        lines.push(`Created: ${new Date(result.metadata.createdAt).toLocaleString()}\n`);
+        lines.push(`Last Modified: ${new Date(result.metadata.lastModified).toLocaleString()}\n`);
+        lines.push(`Total Messages: ${result.totalMessageCount}\n`);
+        lines.push(`Compactions: ${result.metadata.compactionCount}\n`);
+        lines.push(`Showing: ${result.returnedMessageCount} messages\n`);
+        if (result.hasMore) {
+            lines.push(`(More messages available - use offset parameter for pagination)\n`);
+        }
+        lines.push(`\n--- Messages ---\n\n`);
+        result.messages.forEach((msg, index) => {
+            const msgNum = result.metadata.offset ? result.metadata.offset + index + 1 : index + 1;
+            const timestamp = new Date(msg.timestamp).toLocaleString();
+            const role = msg.type || msg.role || 'unknown';
+            lines.push(`Message ${msgNum} [${role}] - ${timestamp}\n`);
+            // Extract content
+            const content = this.extractMessageContent(msg);
+            if (content) {
+                const preview = content.length > 200 ? content.substring(0, 200) + '...' : content;
+                lines.push(`${preview}\n\n`);
+            }
+            else {
+                lines.push(`(No text content)\n\n`);
+            }
+        });
+        return lines.join('');
+    }
+    /**
+     * Extract readable content from message
+     */
+    extractMessageContent(msg) {
+        // Handle different message formats
+        if (typeof msg.content === 'string') {
+            return msg.content;
+        }
+        if (Array.isArray(msg.content)) {
+            return msg.content
+                .map((block) => {
+                if (block.type === 'text')
+                    return block.text;
+                if (block.type === 'tool_use') {
+                    const toolName = block.toolUse?.name || block.name || 'Unknown';
+                    return `[Tool: ${toolName}]`;
+                }
+                if (block.type === 'tool_result')
+                    return `[Tool Result]`;
+                return '';
+            })
+                .filter(Boolean)
+                .join(' ');
+        }
+        if (msg.message?.content) {
+            return this.extractMessageContent(msg.message);
+        }
+        return '';
+    }
+}
+//# sourceMappingURL=LoadSessionTool.js.map

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

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

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

@@ -0,0 +1,46 @@
+/**
+ * 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, type ToolResult } from '../../base/index.js';
+import type { ExecutorConfig } from '../../base/ToolRegistry.js';
+/**
+ * Parameters for the RequestHistoricalContext tool
+ */
+export interface RequestHistoricalContextToolParams {
+    /** Query describing what historical context is needed */
+    query: string;
+    /** Detail level for the response */
+    detailLevel?: 'brief' | 'standard' | 'detailed';
+    /** Maximum tokens for the response */
+    maxTokens?: number;
+    /** Whether to use helper model (vs main model) */
+    useHelperModel?: boolean;
+}
+/**
+ * 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 declare class RequestHistoricalContextToolExecutor extends BaseTool<RequestHistoricalContextToolParams, ToolResult> {
+    private config;
+    constructor(config: ExecutorConfig);
+    /**
+     * Get workspace root from config (dynamically resolved)
+     */
+    private getWorkspaceRoot;
+    validateToolParams(params: RequestHistoricalContextToolParams): string | null;
+    getDescription(params: RequestHistoricalContextToolParams): string;
+    execute(params: RequestHistoricalContextToolParams, signal: AbortSignal, updateOutput?: (output: string) => void): Promise<ToolResult>;
+    /**
+     * Format historical context result for display
+     */
+    private formatContext;
+}
+//# sourceMappingURL=RequestHistoricalContextTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RequestHistoricalContextTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/historical/RequestHistoricalContextTool.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,kCAAkC;IACjD,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IAEd,oCAAoC;IACpC,WAAW,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;IAEhD,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,kDAAkD;IAClD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,qBAAa,oCAAqC,SAAQ,QAAQ,CAChE,kCAAkC,EAClC,UAAU,CACX;IACa,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAoC1C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB,kBAAkB,CAAC,MAAM,EAAE,kCAAkC,GAAG,MAAM,GAAG,IAAI;IAkC7E,cAAc,CAAC,MAAM,EAAE,kCAAkC,GAAG,MAAM;IAK5D,OAAO,CACX,MAAM,EAAE,kCAAkC,EAC1C,MAAM,EAAE,WAAW,EACnB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,UAAU,CAAC;IAwHtB;;OAEG;IACH,OAAO,CAAC,aAAa;CA8BtB"}