@stackmemoryai/stackmemory 0.2.9 → 0.3.0

package/dist/src/integrations/mcp/handlers/context-handlers.js

@@ -0,0 +1,266 @@
+/**
+ * Context-related MCP tool handlers
+ * Handles frame management and context retrieval
+ */
+import { logger } from '../../../core/monitoring/logger.js';
+export class ContextHandlers {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Get current project context
+     */
+    async handleGetContext(args) {
+        try {
+            const query = args.query || '';
+            const limit = args.limit || 5;
+            logger.info('Getting context', { query, limit });
+            // Get hot stack context
+            const hotStack = this.deps.frameManager.getHotStackContext(20);
+            if (hotStack.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'No active context frames found. Use start_frame to begin working on a task.',
+                        },
+                    ],
+                };
+            }
+            // Use LLM context retrieval if available
+            if (this.deps.contextRetrieval && query) {
+                try {
+                    // TODO: Implement getRelevantContext method
+                    const llmContext = { summary: 'Context retrieval not yet implemented', frameIds: [] };
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: llmContext.summary || 'No specific context found.',
+                            },
+                        ],
+                        metadata: {
+                            relevantFrames: llmContext.frameIds,
+                            query,
+                        },
+                    };
+                }
+                catch (error) {
+                    logger.warn('LLM context retrieval failed, falling back to hot stack', error instanceof Error ? error : new Error(String(error)));
+                }
+            }
+            // Format hot stack context
+            const contextText = hotStack
+                .map((frame, i) => {
+                const depth = '  '.repeat(i);
+                const constraints = frame.header.constraints?.length
+                    ? `\n${depth}  Constraints: ${frame.header.constraints.join(', ')}`
+                    : '';
+                const events = frame.recentEvents.length
+                    ? `\n${depth}  Recent: ${frame.recentEvents.length} events`
+                    : '';
+                return `${depth}Frame ${i + 1}: ${frame.header.goal}${constraints}${events}`;
+            })
+                .join('\n');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Current Context Stack:\n${contextText}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('Error getting context', error instanceof Error ? error : new Error(String(error)));
+            throw error;
+        }
+    }
+    /**
+     * Record a decision or important information
+     */
+    async handleAddDecision(args) {
+        try {
+            const { content, type } = args;
+            if (!content) {
+                throw new Error('Content is required');
+            }
+            const currentFrame = this.deps.frameManager.getCurrentFrameId();
+            if (!currentFrame) {
+                throw new Error('No active frame. Use start_frame first.');
+            }
+            // Add as anchor
+            this.deps.frameManager.addAnchor(type === 'constraint' ? 'CONSTRAINT' : 'DECISION', content, type === 'constraint' ? 9 : 7);
+            // Also add as event
+            this.deps.frameManager.addEvent('decision', {
+                type,
+                content,
+                timestamp: Date.now(),
+            });
+            logger.info('Added decision/constraint', { type, content });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Recorded ${type}: ${content}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('Error adding decision', error instanceof Error ? error : new Error(String(error)));
+            throw error;
+        }
+    }
+    /**
+     * Start a new frame (task/subtask) on the call stack
+     */
+    async handleStartFrame(args) {
+        try {
+            const { name, type = 'task', constraints = [], definitions = {} } = args;
+            if (!name) {
+                throw new Error('Frame name is required');
+            }
+            const frameId = this.deps.frameManager.createFrame({
+                type: type,
+                name,
+                inputs: { constraints, definitions }
+            });
+            logger.info('Started frame', { frameId, name, type });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Started frame: ${name} (${frameId})`,
+                    },
+                ],
+                metadata: {
+                    frameId,
+                    type,
+                    name,
+                },
+            };
+        }
+        catch (error) {
+            logger.error('Error starting frame', error instanceof Error ? error : new Error(String(error)));
+            throw error;
+        }
+    }
+    /**
+     * Close current frame with summary
+     */
+    async handleCloseFrame(args) {
+        try {
+            const { summary, frameId } = args;
+            const targetFrameId = frameId || this.deps.frameManager.getCurrentFrameId();
+            if (!targetFrameId) {
+                throw new Error('No active frame to close');
+            }
+            const frame = this.deps.frameManager.getFrame(targetFrameId);
+            if (!frame) {
+                throw new Error(`Frame not found: ${targetFrameId}`);
+            }
+            // Add summary if provided
+            if (summary) {
+                this.deps.frameManager.addEvent('observation', {
+                    type: 'completion_summary',
+                    content: summary,
+                    timestamp: Date.now(),
+                });
+            }
+            this.deps.frameManager.closeFrame(targetFrameId, summary ? { summary } : {});
+            logger.info('Closed frame', { frameId: targetFrameId, frameName: frame.name });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Closed frame: ${frame.name}${summary ? ` with summary: ${summary}` : ''}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('Error closing frame', error instanceof Error ? error : new Error(String(error)));
+            throw error;
+        }
+    }
+    /**
+     * Add an anchor (important fact) to current frame
+     */
+    async handleAddAnchor(args) {
+        try {
+            const { type, text, priority = 5 } = args;
+            if (!text) {
+                throw new Error('Anchor text is required');
+            }
+            const currentFrame = this.deps.frameManager.getCurrentFrameId();
+            if (!currentFrame) {
+                throw new Error('No active frame. Use start_frame first.');
+            }
+            const validTypes = ['FACT', 'DECISION', 'CONSTRAINT', 'INTERFACE_CONTRACT', 'TODO', 'RISK'];
+            if (!validTypes.includes(type)) {
+                throw new Error(`Invalid anchor type. Must be one of: ${validTypes.join(', ')}`);
+            }
+            this.deps.frameManager.addAnchor(type, text, priority);
+            logger.info('Added anchor', { type, text, priority });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Added ${type.toLowerCase()}: ${text}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('Error adding anchor', error instanceof Error ? error : new Error(String(error)));
+            throw error;
+        }
+    }
+    /**
+     * Get current hot stack context
+     */
+    async handleGetHotStack(args) {
+        try {
+            const maxEvents = args.max_events || 10;
+            const hotStack = this.deps.frameManager.getHotStackContext(maxEvents);
+            if (hotStack.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'No active frames on the stack.',
+                        },
+                    ],
+                };
+            }
+            const stackSummary = hotStack.map((frame, index) => ({
+                depth: index,
+                frameId: frame.frameId,
+                goal: frame.header.goal,
+                constraints: frame.header.constraints || [],
+                anchors: frame.anchors.length,
+                recentEvents: frame.recentEvents.length,
+                artifacts: frame.activeArtifacts.length,
+            }));
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Hot Stack (${hotStack.length} frames):\n` +
+                            stackSummary.map(f => `  ${f.depth}: ${f.goal} (${f.anchors} anchors, ${f.recentEvents} events)`).join('\n'),
+                    },
+                ],
+                metadata: {
+                    stack: stackSummary,
+                },
+            };
+        }
+        catch (error) {
+            logger.error('Error getting hot stack', error instanceof Error ? error : new Error(String(error)));
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=context-handlers.js.map

package/dist/src/integrations/mcp/handlers/context-handlers.js.map

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

package/dist/src/integrations/mcp/handlers/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * MCP Handler Modules
+ * Centralized exports for all MCP tool handlers
+ */
+export { ContextHandlers, type ContextHandlerDependencies } from './context-handlers.js';
+export { TaskHandlers, type TaskHandlerDependencies } from './task-handlers.js';
+export { LinearHandlers, type LinearHandlerDependencies } from './linear-handlers.js';
+export { TraceHandlers, type TraceHandlerDependencies } from './trace-handlers.js';
+import { ContextHandlerDependencies } from './context-handlers.js';
+import { TaskHandlerDependencies } from './task-handlers.js';
+import { LinearHandlerDependencies } from './linear-handlers.js';
+import { TraceHandlerDependencies } from './trace-handlers.js';
+export interface MCPHandlerDependencies extends ContextHandlerDependencies, TaskHandlerDependencies, LinearHandlerDependencies, TraceHandlerDependencies {
+}
+/**
+ * Handler factory that creates all MCP tool handlers
+ */
+export declare class MCPHandlerFactory {
+    private contextHandlers;
+    private taskHandlers;
+    private linearHandlers;
+    private traceHandlers;
+    constructor(deps: MCPHandlerDependencies);
+    /**
+     * Get handler for a specific tool
+     */
+    getHandler(toolName: string): (args: any) => Promise<any>;
+    /**
+     * Get all available tool names
+     */
+    getAvailableTools(): string[];
+    /**
+     * Check if a tool exists
+     */
+    hasHandler(toolName: string): boolean;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/integrations/mcp/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/integrations/mcp/handlers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,KAAK,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,KAAK,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEnF,OAAO,EAAmB,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAgB,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAkB,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAiB,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAG9E,MAAM,WAAW,sBAAuB,SACtC,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB;CACzB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,IAAI,EAAE,sBAAsB;IAuBxC;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC;IAyDzD;;OAEG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAiC7B;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAGtC"}

package/dist/src/integrations/mcp/handlers/index.js

@@ -0,0 +1,134 @@
+/**
+ * MCP Handler Modules
+ * Centralized exports for all MCP tool handlers
+ */
+export { ContextHandlers } from './context-handlers.js';
+export { TaskHandlers } from './task-handlers.js';
+export { LinearHandlers } from './linear-handlers.js';
+export { TraceHandlers } from './trace-handlers.js';
+import { ContextHandlers } from './context-handlers.js';
+import { TaskHandlers } from './task-handlers.js';
+import { LinearHandlers } from './linear-handlers.js';
+import { TraceHandlers } from './trace-handlers.js';
+/**
+ * Handler factory that creates all MCP tool handlers
+ */
+export class MCPHandlerFactory {
+    contextHandlers;
+    taskHandlers;
+    linearHandlers;
+    traceHandlers;
+    constructor(deps) {
+        this.contextHandlers = new ContextHandlers({
+            frameManager: deps.frameManager,
+            contextRetrieval: deps.contextRetrieval,
+        });
+        this.taskHandlers = new TaskHandlers({
+            taskStore: deps.taskStore,
+            projectId: deps.projectId,
+        });
+        this.linearHandlers = new LinearHandlers({
+            linearAuthManager: deps.linearAuthManager,
+            linearSync: deps.linearSync,
+            taskStore: deps.taskStore,
+        });
+        this.traceHandlers = new TraceHandlers({
+            traceDetector: deps.traceDetector,
+            browserMCP: deps.browserMCP,
+        });
+    }
+    /**
+     * Get handler for a specific tool
+     */
+    getHandler(toolName) {
+        switch (toolName) {
+            // Context handlers
+            case 'get_context':
+                return this.contextHandlers.handleGetContext.bind(this.contextHandlers);
+            case 'add_decision':
+                return this.contextHandlers.handleAddDecision.bind(this.contextHandlers);
+            case 'start_frame':
+                return this.contextHandlers.handleStartFrame.bind(this.contextHandlers);
+            case 'close_frame':
+                return this.contextHandlers.handleCloseFrame.bind(this.contextHandlers);
+            case 'add_anchor':
+                return this.contextHandlers.handleAddAnchor.bind(this.contextHandlers);
+            case 'get_hot_stack':
+                return this.contextHandlers.handleGetHotStack.bind(this.contextHandlers);
+            // Task handlers
+            case 'create_task':
+                return this.taskHandlers.handleCreateTask.bind(this.taskHandlers);
+            case 'update_task_status':
+                return this.taskHandlers.handleUpdateTaskStatus.bind(this.taskHandlers);
+            case 'get_active_tasks':
+                return this.taskHandlers.handleGetActiveTasks.bind(this.taskHandlers);
+            case 'get_task_metrics':
+                return this.taskHandlers.handleGetTaskMetrics.bind(this.taskHandlers);
+            case 'add_task_dependency':
+                return this.taskHandlers.handleAddTaskDependency.bind(this.taskHandlers);
+            // Linear handlers
+            case 'linear_sync':
+                return this.linearHandlers.handleLinearSync.bind(this.linearHandlers);
+            case 'linear_update_task':
+                return this.linearHandlers.handleLinearUpdateTask.bind(this.linearHandlers);
+            case 'linear_get_tasks':
+                return this.linearHandlers.handleLinearGetTasks.bind(this.linearHandlers);
+            case 'linear_status':
+                return this.linearHandlers.handleLinearStatus.bind(this.linearHandlers);
+            // Trace handlers
+            case 'get_traces':
+                return this.traceHandlers.handleGetTraces.bind(this.traceHandlers);
+            case 'analyze_traces':
+                return this.traceHandlers.handleAnalyzeTraces.bind(this.traceHandlers);
+            case 'start_browser_debug':
+                return this.traceHandlers.handleStartBrowserDebug.bind(this.traceHandlers);
+            case 'take_screenshot':
+                return this.traceHandlers.handleTakeScreenshot.bind(this.traceHandlers);
+            case 'execute_script':
+                return this.traceHandlers.handleExecuteScript.bind(this.traceHandlers);
+            case 'stop_browser_debug':
+                return this.traceHandlers.handleStopBrowserDebug.bind(this.traceHandlers);
+            default:
+                throw new Error(`Unknown tool: ${toolName}`);
+        }
+    }
+    /**
+     * Get all available tool names
+     */
+    getAvailableTools() {
+        return [
+            // Context tools
+            'get_context',
+            'add_decision',
+            'start_frame',
+            'close_frame',
+            'add_anchor',
+            'get_hot_stack',
+            // Task tools
+            'create_task',
+            'update_task_status',
+            'get_active_tasks',
+            'get_task_metrics',
+            'add_task_dependency',
+            // Linear tools
+            'linear_sync',
+            'linear_update_task',
+            'linear_get_tasks',
+            'linear_status',
+            // Trace tools
+            'get_traces',
+            'analyze_traces',
+            'start_browser_debug',
+            'take_screenshot',
+            'execute_script',
+            'stop_browser_debug',
+        ];
+    }
+    /**
+     * Check if a tool exists
+     */
+    hasHandler(toolName) {
+        return this.getAvailableTools().includes(toolName);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/integrations/mcp/handlers/index.js.map

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

package/dist/src/integrations/mcp/handlers/linear-handlers.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Linear integration MCP tool handlers
+ * Handles Linear sync, task updates, and status queries
+ */
+import { LinearAuthManager } from '../../linear/auth.js';
+import { LinearSyncEngine } from '../../linear/sync.js';
+import { PebblesTaskStore } from '../../../features/tasks/pebbles-task-store.js';
+export interface LinearHandlerDependencies {
+    linearAuthManager: LinearAuthManager;
+    linearSync: LinearSyncEngine;
+    taskStore: PebblesTaskStore;
+}
+export declare class LinearHandlers {
+    private deps;
+    constructor(deps: LinearHandlerDependencies);
+    /**
+     * Sync tasks with Linear
+     */
+    handleLinearSync(args: any): Promise<any>;
+    /**
+     * Update Linear task status
+     */
+    handleLinearUpdateTask(args: any): Promise<any>;
+    /**
+     * Get tasks from Linear
+     */
+    handleLinearGetTasks(args: any): Promise<any>;
+    /**
+     * Get Linear integration status
+     */
+    handleLinearStatus(args: any): Promise<any>;
+}
+//# sourceMappingURL=linear-handlers.d.ts.map

package/dist/src/integrations/mcp/handlers/linear-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-handlers.d.ts","sourceRoot":"","sources":["../../../../../src/integrations/mcp/handlers/linear-handlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAuB,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AAGjF,MAAM,WAAW,yBAAyB;IACxC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,yBAAyB;IAEnD;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IA8D/C;;OAEG;IACG,sBAAsB,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAwDrD;;OAEG;IACG,oBAAoB,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IA2EnD;;OAEG;IACG,kBAAkB,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;CAsElD"}