@stackmemoryai/stackmemory 1.2.2 → 1.2.4

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

@@ -0,0 +1,211 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { logger } from "../../../core/monitoring/logger.js";
+class TeamHandlers {
+  constructor(deps) {
+    this.deps = deps;
+  }
+  /**
+   * Get context from other agents working on the same project.
+   * Returns recent frames and shared anchors from other sessions.
+   */
+  async handleTeamContextGet(args) {
+    try {
+      const limit = args.limit ?? 10;
+      const types = args.types;
+      const since = args.since;
+      const projectId = this.getProjectId();
+      const runId = this.getRunId();
+      const frames = await this.deps.dbAdapter.getRecentFramesExcludingRun(
+        projectId,
+        runId,
+        { limit, types, since }
+      );
+      const sharedAnchors = await this.deps.dbAdapter.getSharedAnchors(
+        projectId,
+        { limit, since }
+      );
+      if (frames.length === 0 && sharedAnchors.length === 0) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: "No context from other agents found in this project."
+            }
+          ]
+        };
+      }
+      const frameSummaries = frames.map((f) => ({
+        frame_id: f.frame_id,
+        run_id: f.run_id,
+        name: f.name,
+        type: f.type,
+        state: f.state,
+        created_at: f.created_at,
+        digest_text: f.digest_text || null,
+        anchors: f.anchors.map((a) => ({
+          type: a.type,
+          text: a.text,
+          priority: a.priority
+        }))
+      }));
+      const sharedSummaries = sharedAnchors.map((a) => ({
+        type: a.type,
+        text: a.text,
+        priority: a.priority,
+        frame_name: a.frame_name,
+        run_id: a.run_id,
+        shared_by: a.metadata?.sharedBy
+      }));
+      const text = `Team Context (${frames.length} frames, ${sharedAnchors.length} shared anchors):
+
+` + frameSummaries.map(
+        (f) => `[${f.run_id?.slice(0, 8)}] ${f.name} (${f.type}, ${f.state})` + (f.digest_text ? `
+  ${f.digest_text}` : "") + (f.anchors.length > 0 ? "\n  Anchors: " + f.anchors.map((a) => `${a.type}: ${a.text}`).join("; ") : "")
+      ).join("\n") + (sharedSummaries.length > 0 ? "\n\nShared Anchors:\n" + sharedSummaries.map((a) => `  [${a.type}] ${a.text} (priority: ${a.priority})`).join("\n") : "");
+      return {
+        content: [{ type: "text", text }],
+        metadata: { frames: frameSummaries, sharedAnchors: sharedSummaries }
+      };
+    } catch (error) {
+      logger.error(
+        "Error getting team context",
+        error instanceof Error ? error : new Error(String(error))
+      );
+      throw error;
+    }
+  }
+  /**
+   * Share a piece of context with other agents.
+   * Creates a high-priority anchor tagged with shared=true.
+   */
+  async handleTeamContextShare(args) {
+    try {
+      const { content, type = "FACT", priority = 8 } = args;
+      if (!content) {
+        throw new Error("content is required");
+      }
+      const validTypes = [
+        "FACT",
+        "DECISION",
+        "CONSTRAINT",
+        "INTERFACE_CONTRACT",
+        "TODO",
+        "RISK"
+      ];
+      if (!validTypes.includes(type)) {
+        throw new Error(
+          `Invalid type. Must be one of: ${validTypes.join(", ")}`
+        );
+      }
+      let frameId = this.deps.frameManager.getCurrentFrameId();
+      if (!frameId) {
+        frameId = this.deps.frameManager.createFrame({
+          type: "tool_scope",
+          name: "team_context_share"
+        });
+      }
+      const runId = this.getRunId();
+      this.deps.frameManager.addAnchor(type, content, priority, {
+        shared: true,
+        sharedBy: runId,
+        sharedAt: Date.now()
+      });
+      logger.info("Shared team context", { type, priority });
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Shared ${type}: ${content}`
+          }
+        ]
+      };
+    } catch (error) {
+      logger.error(
+        "Error sharing team context",
+        error instanceof Error ? error : new Error(String(error))
+      );
+      throw error;
+    }
+  }
+  /**
+   * Search across all agents' context in the project.
+   * Uses FTS5 search without run_id filtering.
+   */
+  async handleTeamSearch(args) {
+    try {
+      const { query, limit = 20, include_events = false } = args;
+      if (!query) {
+        throw new Error("query is required");
+      }
+      const projectId = this.getProjectId();
+      const results = await this.deps.dbAdapter.search({
+        query,
+        projectId,
+        limit
+      });
+      if (results.length === 0) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `No results found for "${query}" across team sessions.`
+            }
+          ]
+        };
+      }
+      const frameResults = results.map((f) => ({
+        frame_id: f.frame_id,
+        run_id: f.run_id,
+        name: f.name,
+        type: f.type,
+        state: f.state,
+        score: f.score,
+        digest_text: f.digest_text || null,
+        created_at: f.created_at,
+        events: []
+      }));
+      if (include_events) {
+        for (const fr of frameResults) {
+          const events = await this.deps.dbAdapter.getFrameEvents(fr.frame_id, {
+            limit: 5
+          });
+          fr.events = events.map((e) => ({
+            event_type: e.event_type,
+            payload: e.payload,
+            ts: e.ts
+          }));
+        }
+      }
+      const text = `Team Search: ${results.length} results for "${query}":
+
+` + frameResults.map(
+        (f) => `[${f.run_id?.slice(0, 8)}] ${f.name} (score: ${f.score?.toFixed(3)})` + (f.digest_text ? `
+  ${f.digest_text}` : "")
+      ).join("\n");
+      return {
+        content: [{ type: "text", text }],
+        metadata: { results: frameResults, total: results.length }
+      };
+    } catch (error) {
+      logger.error(
+        "Error in team search",
+        error instanceof Error ? error : new Error(String(error))
+      );
+      throw error;
+    }
+  }
+  /** Extract projectId from the dbAdapter (protected field on DatabaseAdapter) */
+  getProjectId() {
+    return this.deps.dbAdapter.projectId;
+  }
+  /** Extract current runId from frameManager (private field) */
+  getRunId() {
+    return this.deps.frameManager.currentRunId;
+  }
+}
+export {
+  TeamHandlers
+};

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

@@ -73,7 +73,10 @@ ${summaryText}`
       }
       return result;
     } catch (error) {
-      logger.error("Error getting traces", error instanceof Error ? error : new Error(String(error)));
+      logger.error(
+        "Error getting traces",
+        error instanceof Error ? error : new Error(String(error))
+      );
       throw error;
     }
   }
@@ -129,9 +132,7 @@ ${summaryText}`
       }
       if (include_recommendations && analysis.recommendations) {
         analysisText += "\n\nRecommendations:\n";
-        analysisText += analysis.recommendations.map(
-          (rec, i) => `${i + 1}. ${rec}`
-        ).join("\n");
+        analysisText += analysis.recommendations.map((rec, i) => `${i + 1}. ${rec}`).join("\n");
       }
       return {
         content: [
@@ -147,7 +148,10 @@ ${summaryText}`
         }
       };
     } catch (error) {
-      logger.error("Error analyzing traces", error instanceof Error ? error : new Error(String(error)));
+      logger.error(
+        "Error analyzing traces",
+        error instanceof Error ? error : new Error(String(error))
+      );
       throw error;
     }
   }
@@ -184,7 +188,10 @@ Navigated to: ${url}`
         }
       };
     } catch (error) {
-      logger.error("Error starting browser debug session", error instanceof Error ? error : new Error(String(error)));
+      logger.error(
+        "Error starting browser debug session",
+        error instanceof Error ? error : new Error(String(error))
+      );
       throw error;
     }
   }
@@ -218,7 +225,10 @@ Navigated to: ${url}`
         }
       };
     } catch (error) {
-      logger.error("Error taking screenshot", error instanceof Error ? error : new Error(String(error)));
+      logger.error(
+        "Error taking screenshot",
+        error instanceof Error ? error : new Error(String(error))
+      );
       throw error;
     }
   }
@@ -251,7 +261,10 @@ Result: ${JSON.stringify(result, null, 2)}`
         }
       };
     } catch (error) {
-      logger.error("Error executing script", error instanceof Error ? error : new Error(String(error)));
+      logger.error(
+        "Error executing script",
+        error instanceof Error ? error : new Error(String(error))
+      );
       throw error;
     }
   }
@@ -279,7 +292,10 @@ Result: ${JSON.stringify(result, null, 2)}`
         }
       };
     } catch (error) {
-      logger.error("Error stopping browser debug session", error instanceof Error ? error : new Error(String(error)));
+      logger.error(
+        "Error stopping browser debug session",
+        error instanceof Error ? error : new Error(String(error))
+      );
       throw error;
     }
   }

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

@@ -2,7 +2,7 @@ import { fileURLToPath as __fileURLToPath } from 'url';
 import { dirname as __pathDirname } from 'path';
 const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __pathDirname(__filename);
-import { RefactoredStackMemoryMCP } from "./refactored-server.js";
+import { StackMemoryMCP } from "./refactored-server.js";
 import { MCPHandlerFactory } from "./handlers/index.js";
 import { ContextHandlers } from "./handlers/context-handlers.js";
 import { TaskHandlers } from "./handlers/task-handlers.js";
@@ -16,7 +16,7 @@ export {
   LinearHandlers,
   MCPHandlerFactory,
   MCPToolDefinitions,
-  RefactoredStackMemoryMCP as StackMemoryMCP,
+  StackMemoryMCP,
   TaskHandlers,
   TraceHandlers
 };

package/dist/src/integrations/mcp/refactored-server.js

@@ -11,13 +11,14 @@ import { existsSync, mkdirSync } from "fs";
 import { join, dirname } from "path";
 import { execSync } from "child_process";
 import { v4 as uuidv4 } from "uuid";
-import { RefactoredFrameManager } from "../../core/context/refactored-frame-manager.js";
+import { FrameManager } from "../../core/context/frame-manager.js";
 import { LinearTaskManager } from "../../features/tasks/linear-task-manager.js";
 import { LinearAuthManager } from "../linear/auth.js";
 import { LinearSyncEngine, DEFAULT_SYNC_CONFIG } from "../linear/sync.js";
 import { BrowserMCPIntegration } from "../../features/browser/browser-mcp.js";
 import { TraceDetector } from "../../core/trace/trace-detector.js";
 import { LLMContextRetrieval } from "../../core/retrieval/index.js";
+import { SQLiteAdapter } from "../../core/database/sqlite-adapter.js";
 import { ConfigManager } from "../../core/config/config-manager.js";
 import { logger } from "../../core/monitoring/logger.js";
 import { MCPHandlerFactory } from "./handlers/index.js";
@@ -34,7 +35,7 @@ function getEnv(key, defaultValue) {
 function getOptionalEnv(key) {
   return process.env[key];
 }
-class RefactoredStackMemoryMCP {
+class StackMemoryMCP {
   server;
   db;
   projectRoot;
@@ -47,6 +48,7 @@ class RefactoredStackMemoryMCP {
   browserMCP;
   traceDetector;
   contextRetrieval;
+  dbAdapter;
   configManager;
   toolScoringMiddleware;
   // Handler factory
@@ -70,6 +72,7 @@ class RefactoredStackMemoryMCP {
     }
     const dbPath = join(dbDir, "context.db");
     this.db = new Database(dbPath);
+    this.dbAdapter = new SQLiteAdapter(this.projectId, { dbPath });
     logger.info("Database initialized", { dbPath });
   }
   /**
@@ -78,7 +81,7 @@ class RefactoredStackMemoryMCP {
   initializeComponents(config) {
     const configPath = join(this.projectRoot, ".stackmemory", "config.yaml");
     this.configManager = new ConfigManager(configPath);
-    this.frameManager = new RefactoredFrameManager(this.db, this.projectId);
+    this.frameManager = new FrameManager(this.db, this.projectId);
     this.taskStore = new LinearTaskManager(this.projectRoot, this.db);
     this.linearAuthManager = new LinearAuthManager(this.projectRoot);
     this.linearSync = new LinearSyncEngine(
@@ -140,7 +143,8 @@ class RefactoredStackMemoryMCP {
       linearAuthManager: this.linearAuthManager,
       linearSync: this.linearSync,
       traceDetector: this.traceDetector,
-      browserMCP: this.browserMCP
+      browserMCP: this.browserMCP,
+      dbAdapter: this.dbAdapter
     };
     this.handlerFactory = new MCPHandlerFactory(dependencies);
     this.toolDefinitions = new MCPToolDefinitions();
@@ -275,6 +279,8 @@ class RefactoredStackMemoryMCP {
    */
   async start() {
     try {
+      await this.dbAdapter.connect();
+      await this.dbAdapter.initializeSchema();
       await this.frameManager.initialize();
       const transport = new StdioServerTransport();
       await this.server.connect(transport);
@@ -285,7 +291,10 @@ class RefactoredStackMemoryMCP {
       });
       this.setupCleanup();
     } catch (error) {
-      logger.error("Failed to start MCP server", error instanceof Error ? error : new Error(String(error)));
+      logger.error(
+        "Failed to start MCP server",
+        error instanceof Error ? error : new Error(String(error))
+      );
       throw error;
     }
   }
@@ -299,19 +308,28 @@ class RefactoredStackMemoryMCP {
         if (this.browserMCP) {
           await this.browserMCP.cleanup();
         }
+        if (this.dbAdapter) {
+          await this.dbAdapter.disconnect();
+        }
         if (this.db) {
           this.db.close();
         }
         logger.info("MCP server shutdown complete");
       } catch (error) {
-        logger.error("Error during cleanup", error instanceof Error ? error : new Error(String(error)));
+        logger.error(
+          "Error during cleanup",
+          error instanceof Error ? error : new Error(String(error))
+        );
       }
       process.exit(0);
     };
     process.on("SIGINT", cleanup);
     process.on("SIGTERM", cleanup);
     process.on("uncaughtException", (error) => {
-      logger.error("Uncaught exception", error instanceof Error ? error : new Error(String(error)));
+      logger.error(
+        "Uncaught exception",
+        error instanceof Error ? error : new Error(String(error))
+      );
       cleanup();
     });
   }
@@ -355,10 +373,13 @@ async function main() {
       enableTracing: process.env["DISABLE_TRACING"] !== "true",
       enableBrowser: process.env["DISABLE_BROWSER"] !== "true"
     };
-    const server = new RefactoredStackMemoryMCP(config);
+    const server = new StackMemoryMCP(config);
     await server.start();
   } catch (error) {
-    logger.error("Failed to start server", error instanceof Error ? error : new Error(String(error)));
+    logger.error(
+      "Failed to start server",
+      error instanceof Error ? error : new Error(String(error))
+    );
     process.exit(1);
   }
 }
@@ -369,5 +390,5 @@ if (import.meta.url === `file://${process.argv[1]}`) {
   });
 }
 export {
-  RefactoredStackMemoryMCP
+  StackMemoryMCP
 };

package/dist/src/integrations/mcp/tool-definitions.js

@@ -14,7 +14,9 @@ class MCPToolDefinitions {
       ...this.getTraceTools(),
       ...this.getDiscoveryTools(),
       ...this.getEditTools(),
-      ...this.getGraphitiTools()
+      ...this.getGraphitiTools(),
+      ...this.getTeamTools(),
+      ...this.getCordTools()
     ];
   }
   /**
@@ -755,6 +757,214 @@ class MCPToolDefinitions {
       }
     ];
   }
+  /**
+   * Multi-agent team collaboration tools
+   */
+  getTeamTools() {
+    return [
+      {
+        name: "team_context_get",
+        description: "Get context from other agents working on the same project. Returns recent frames and shared anchors from other sessions.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            limit: {
+              type: "number",
+              default: 10,
+              description: "Max frames to return"
+            },
+            types: {
+              type: "array",
+              items: { type: "string" },
+              description: "Filter by frame types"
+            },
+            since: {
+              type: "number",
+              description: "Only frames created after this timestamp (epoch ms)"
+            }
+          }
+        }
+      },
+      {
+        name: "team_context_share",
+        description: "Share a piece of context with other agents working on the same project. Creates a high-priority anchor visible to team_context_get.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            content: {
+              type: "string",
+              description: "The context to share"
+            },
+            type: {
+              type: "string",
+              enum: [
+                "FACT",
+                "DECISION",
+                "CONSTRAINT",
+                "INTERFACE_CONTRACT",
+                "TODO",
+                "RISK"
+              ],
+              default: "FACT",
+              description: "Type of context"
+            },
+            priority: {
+              type: "number",
+              minimum: 1,
+              maximum: 10,
+              default: 8,
+              description: "Priority level (1-10)"
+            }
+          },
+          required: ["content"]
+        }
+      },
+      {
+        name: "team_search",
+        description: "Search across all agents' context in the project. Uses full-text search across all sessions.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            query: {
+              type: "string",
+              description: "Search query"
+            },
+            limit: {
+              type: "number",
+              default: 20,
+              description: "Maximum results to return"
+            },
+            include_events: {
+              type: "boolean",
+              default: false,
+              description: "Include events in results"
+            }
+          },
+          required: ["query"]
+        }
+      }
+    ];
+  }
+  /**
+   * Cord task orchestration tools
+   */
+  getCordTools() {
+    return [
+      {
+        name: "cord_spawn",
+        description: "Create a subtask with clean context (spawn). Child sees only its prompt and completed blocker results.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            goal: {
+              type: "string",
+              description: "What this task should accomplish"
+            },
+            prompt: {
+              type: "string",
+              description: "Detailed instructions for the task"
+            },
+            blocked_by: {
+              type: "array",
+              items: { type: "string" },
+              description: "Task IDs that must complete before this can start"
+            },
+            parent_id: {
+              type: "string",
+              description: "Parent task ID"
+            }
+          },
+          required: ["goal"]
+        }
+      },
+      {
+        name: "cord_fork",
+        description: "Create a subtask with full sibling context (fork). Child sees its prompt, blocker results, AND completed sibling results.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            goal: {
+              type: "string",
+              description: "What this task should accomplish"
+            },
+            prompt: {
+              type: "string",
+              description: "Detailed instructions for the task"
+            },
+            blocked_by: {
+              type: "array",
+              items: { type: "string" },
+              description: "Task IDs that must complete before this can start"
+            },
+            parent_id: {
+              type: "string",
+              description: "Parent task ID"
+            }
+          },
+          required: ["goal"]
+        }
+      },
+      {
+        name: "cord_complete",
+        description: "Mark a cord task as completed with a result. Automatically unblocks dependent tasks.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            task_id: {
+              type: "string",
+              description: "Task ID to complete"
+            },
+            result: {
+              type: "string",
+              description: "The result/output of this task"
+            }
+          },
+          required: ["task_id", "result"]
+        }
+      },
+      {
+        name: "cord_ask",
+        description: "Create an ask task \u2014 a question that needs an answer before dependent tasks can proceed.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            question: {
+              type: "string",
+              description: "The question to ask"
+            },
+            options: {
+              type: "array",
+              items: { type: "string" },
+              description: "Optional list of answer choices"
+            },
+            parent_id: {
+              type: "string",
+              description: "Parent task ID"
+            }
+          },
+          required: ["question"]
+        }
+      },
+      {
+        name: "cord_tree",
+        description: "View the cord task tree with context scoping. Shows which tasks are active, blocked, or completed.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            task_id: {
+              type: "string",
+              description: "Root task ID to show subtree (omit for full project tree)"
+            },
+            include_results: {
+              type: "boolean",
+              default: false,
+              description: "Include task results in output"
+            }
+          }
+        }
+      }
+    ];
+  }
   /**
    * Get tool definition by name
    */
@@ -780,6 +990,10 @@ class MCPToolDefinitions {
         return this.getEditTools();
       case "graphiti":
         return this.getGraphitiTools();
+      case "team":
+        return this.getTeamTools();
+      case "cord":
+        return this.getCordTools();
       default:
         return [];
     }

package/dist/src/integrations/ralph/context/context-budget-manager.js

@@ -115,14 +115,22 @@ class ContextBudgetManager {
     const reductionRatio = this.config.maxTokens / currentTokens;
     const phase = this.determinePhase(context.task.currentIteration);
     const adjustedWeights = this.getPhaseAdjustedWeights(phase);
-    return this.applyWeightedReduction(context, reductionRatio, adjustedWeights);
+    return this.applyWeightedReduction(
+      context,
+      reductionRatio,
+      adjustedWeights
+    );
   }
   /**
    * Priority-based allocation using fixed weights
    */
   priorityBasedAllocation(context, currentTokens) {
     const reductionRatio = this.config.maxTokens / currentTokens;
-    return this.applyWeightedReduction(context, reductionRatio, this.config.priorityWeights);
+    return this.applyWeightedReduction(
+      context,
+      reductionRatio,
+      this.config.priorityWeights
+    );
   }
   /**
    * Apply weighted reduction to context