@massa-ai/core 1.2.1

package/dist/tools/restore_checkpoint.js

@@ -0,0 +1,113 @@
+/**
+ * Restore Checkpoint Tool
+ *
+ * MCP tool for restoring a previously saved task checkpoint.
+ * Returns the saved state along with integrity checks
+ * (missing memories, file conflicts).
+ *
+ * Thin layer — delegates to CheckpointManager service.
+ */
+import { logger } from "@massa-ai/shared";
+import { CheckpointManager } from "../services/checkpoint/checkpoint-manager.js";
+import { serializeToolResponse } from "./serialize.js";
+export class RestoreCheckpointTool {
+    name = "restore_checkpoint";
+    description = "Restore a saved task checkpoint — returns the full TASK state (progress, " +
+        "decisions, agent state), integrity checks for referenced memories and files, " +
+        "and instructions for resuming the task. Distinct from compact_snapshot " +
+        "(which preserves SESSION continuity, not task state).";
+    inputSchema = {
+        type: "object",
+        properties: {
+            checkpointId: {
+                type: "string",
+                description: "The checkpoint ID to restore. If omitted, taskId is required.",
+            },
+            taskId: {
+                type: "string",
+                description: "Task ID to restore the latest checkpoint for. Used when checkpointId is not provided.",
+            },
+            format: {
+                type: "string",
+                enum: ["json", "toon"],
+                description: "Output format",
+                default: "toon",
+            },
+            fields: {
+                type: "array",
+                items: { type: "string" },
+                description: "Projection — keep only these keys (dotted paths supported, e.g. ['nodes.symbol']). Absent/empty → full data.",
+            },
+        },
+        required: [],
+    };
+    checkpointManager;
+    constructor() {
+        this.checkpointManager = CheckpointManager.getInstance();
+    }
+    async handle(params) {
+        const { checkpointId, taskId, format = "toon", fields, } = params;
+        try {
+            if (!checkpointId && !taskId) {
+                return {
+                    success: false,
+                    error: "Either checkpointId or taskId must be provided",
+                };
+            }
+            // Resolve checkpoint ID
+            let resolvedId = checkpointId;
+            if (!resolvedId && taskId) {
+                const latest = this.checkpointManager.getLatestCheckpoint(taskId);
+                if (!latest) {
+                    return {
+                        success: false,
+                        error: `No checkpoints found for task: ${taskId}`,
+                    };
+                }
+                resolvedId = latest.id;
+            }
+            const result = await this.checkpointManager.restoreCheckpoint(resolvedId);
+            if (!result) {
+                return {
+                    success: false,
+                    error: `Checkpoint not found: ${resolvedId}`,
+                };
+            }
+            logger.info("Checkpoint tool: restored", {
+                checkpointId: resolvedId,
+                taskId: result.checkpoint.taskId,
+                validMemories: result.validMemoryIds.length,
+                missingMemories: result.missingMemoryIds.length,
+                fileConflicts: result.fileConflicts.length,
+            });
+            const responseData = {
+                checkpointId: result.checkpoint.id,
+                taskId: result.checkpoint.taskId,
+                description: result.checkpoint.state.description,
+                status: result.checkpoint.state.status,
+                progress: result.checkpoint.state.progress,
+                context: result.checkpoint.state.context,
+                agentState: result.checkpoint.state.agentState,
+                integrity: {
+                    validMemories: result.validMemoryIds.length,
+                    missingMemories: result.missingMemoryIds.length,
+                    fileConflicts: result.fileConflicts,
+                },
+                restoreInstructions: result.restoreInstructions,
+                createdAt: result.checkpoint.createdAt,
+            };
+            return serializeToolResponse(responseData, { format, fields });
+        }
+        catch (error) {
+            logger.error("Failed to restore checkpoint", error, {
+                checkpointId,
+                taskId,
+            });
+            return {
+                success: false,
+                error: `Failed to restore checkpoint: ${error.message}`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=restore_checkpoint.js.map

package/dist/tools/restore_checkpoint.js.map

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

package/dist/tools/search_code.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Search Code Tool
+ *
+ * Alias for search_project focused on semantic code search.
+ * Uses the same caching, auto-reindex, and filter capabilities.
+ */
+import { IToolHandler } from "@massa-ai/shared";
+import { ToolResponse } from "@massa-ai/shared";
+export declare class SearchCodeTool implements IToolHandler {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            projectId: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+                default: number;
+            };
+        };
+        required: string[];
+    };
+    private searchProjectTool;
+    constructor();
+    handle(params: unknown): Promise<ToolResponse>;
+}
+//# sourceMappingURL=search_code.d.ts.map

package/dist/tools/search_code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search_code.d.ts","sourceRoot":"","sources":["../../src/tools/search_code.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAUhD,qBAAa,cAAe,YAAW,YAAY;IACjD,IAAI,SAAiB;IACrB,WAAW,SACsE;IACjF,WAAW;;;;;;;;;;;;;;;;;;MAkBT;IAEF,OAAO,CAAC,iBAAiB,CAAoB;;IAMvC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;CA4BrD"}

package/dist/tools/search_code.js

@@ -0,0 +1,61 @@
+/**
+ * Search Code Tool
+ *
+ * Alias for search_project focused on semantic code search.
+ * Uses the same caching, auto-reindex, and filter capabilities.
+ */
+import { SearchProjectTool } from "./search_project.js";
+import { logger } from "@massa-ai/shared";
+export class SearchCodeTool {
+    name = "search_code";
+    description = "Search for code using semantic and keyword search (alias for search_project)";
+    inputSchema = {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "Code search query (natural language or keywords)",
+            },
+            projectId: {
+                type: "string",
+                description: "Project ID to search in",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum number of results",
+                default: 10,
+            },
+        },
+        required: ["query", "projectId"],
+    };
+    searchProjectTool;
+    constructor() {
+        this.searchProjectTool = new SearchProjectTool();
+    }
+    async handle(params) {
+        const { query, projectId, limit = 10 } = params;
+        try {
+            logger.info("Search code request", { query, projectId, limit });
+            // Delegate to search_project with summary mode for token efficiency
+            const response = await this.searchProjectTool.handle({
+                query,
+                projectId,
+                maxResults: limit,
+                responseMode: "summary", // Always use summary for code search
+                autoReindex: false, // Don't auto-reindex on every code search
+            });
+            return response;
+        }
+        catch (error) {
+            logger.error("Failed to search code", error, {
+                query,
+                projectId,
+            });
+            return {
+                success: false,
+                error: `Failed to search code: ${error.message}`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=search_code.js.map

package/dist/tools/search_code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search_code.js","sourceRoot":"","sources":["../../src/tools/search_code.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAQ1C,MAAM,OAAO,cAAc;IACzB,IAAI,GAAG,aAAa,CAAC;IACrB,WAAW,GACT,8EAA8E,CAAC;IACjF,WAAW,GAAG;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kDAAkD;aAChE;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yBAAyB;aACvC;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2BAA2B;gBACxC,OAAO,EAAE,EAAE;aACZ;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;KACjC,CAAC;IAEM,iBAAiB,CAAoB;IAE7C;QACE,IAAI,CAAC,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAe;QAC1B,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,MAA0B,CAAC;QAEpE,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YAEhE,oEAAoE;YACpE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC;gBACnD,KAAK;gBACL,SAAS;gBACT,UAAU,EAAE,KAAK;gBACjB,YAAY,EAAE,SAAS,EAAE,qCAAqC;gBAC9D,WAAW,EAAE,KAAK,EAAE,0CAA0C;aAC/D,CAAC,CAAC;YAEH,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAc,EAAE;gBACpD,KAAK;gBACL,SAAS;aACV,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,0BAA2B,KAAe,CAAC,OAAO,EAAE;aAC5D,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/tools/search_definitions.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Search Definitions Tool (search_definitions)
+ *
+ * Browse symbols (functions, classes, types, etc.) in a project.
+ * Uses the Symbol Graph's PostgreSQL index for fast, exact results.
+ */
+import { IToolHandler, ToolResponse } from "@massa-ai/shared";
+export declare class SearchDefinitionsTool implements IToolHandler {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            projectId: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            kind: {
+                type: string;
+                items: Readonly<{
+                    type: "string";
+                    enum: readonly ["module", "namespace", "class", "interface", "trait", "enum", "function", "method", "constructor", "property", "field", "variable", "constant", "type", "type_parameter", "export", "heading", "key"];
+                    description: string;
+                }>;
+                description: string;
+            };
+            file: {
+                type: string;
+                description: string;
+            };
+            exportedOnly: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            maxResults: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            ifNoneMatch: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handle(params: unknown): Promise<ToolResponse>;
+}
+//# sourceMappingURL=search_definitions.d.ts.map

package/dist/tools/search_definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search_definitions.d.ts","sourceRoot":"","sources":["../../src/tools/search_definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,EAGZ,YAAY,EACb,MAAM,kBAAkB,CAAC;AAqB1B,qBAAa,qBAAsB,YAAW,YAAY;IACxD,IAAI,SAAwB;IAC5B,WAAW,SACsJ;IAEjK,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAqCT;IAEI,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;CAuFrD"}

package/dist/tools/search_definitions.js

@@ -0,0 +1,123 @@
+/**
+ * Search Definitions Tool (search_definitions)
+ *
+ * Browse symbols (functions, classes, types, etc.) in a project.
+ * Uses the Symbol Graph's PostgreSQL index for fast, exact results.
+ */
+import { STRUCTURAL_SYMBOL_KINDS, STRUCTURAL_SYMBOL_KIND_SCHEMA, } from "@massa-ai/shared";
+import { symbolGraphService } from "../services/symbol/symbol-graph.service.js";
+import { validateEnum, ToolError } from "./enum-validation.js";
+import { getActiveGeneration, assertGenerationNotStale } from "../services/symbol/active-generation.js";
+export class SearchDefinitionsTool {
+    name = "search_definitions";
+    description = "Search for symbol definitions (functions, classes, variables, types, interfaces) in an indexed project. Returns name, kind, file location, and doc comments.";
+    inputSchema = {
+        type: "object",
+        properties: {
+            projectId: {
+                type: "string",
+                description: "The project ID to search in",
+            },
+            query: {
+                type: "string",
+                description: "Substring search on symbol name (case-insensitive)",
+            },
+            kind: {
+                type: "array",
+                items: STRUCTURAL_SYMBOL_KIND_SCHEMA,
+                description: "Filter by symbol kind",
+            },
+            file: {
+                type: "string",
+                description: "Filter by file path (relative to project root)",
+            },
+            exportedOnly: {
+                type: "boolean",
+                description: "Return only exported symbols",
+                default: false,
+            },
+            maxResults: {
+                type: "number",
+                description: "Maximum number of results to return (default: 20)",
+                default: 20,
+            },
+            ifNoneMatch: {
+                type: "string",
+                description: "Optional precondition: the client's last-known `activatedGraphGenerationId`. If it mismatches the current active generation, the tool returns a 412 teaching error.",
+            },
+        },
+        required: ["projectId"],
+    };
+    async handle(params) {
+        const { projectId, query, kind, file, exportedOnly = false, maxResults = 20, ifNoneMatch, } = params;
+        // Validate each kind entry against the 18 canonical structural kinds.
+        // Empty/missing kind is allowed (no filter); an invalid kind string
+        // teaching-errors immediately with the full valid-values list.
+        const validatedKind = kind
+            ? kind.map((k) => validateEnum("kind", k, STRUCTURAL_SYMBOL_KINDS))
+            : undefined;
+        // N1 (WAVE4-N1): surface the active graph generation id + opt-in stale
+        // precondition. search_definitions reads the symbol graph, so it
+        // participates; search_code is excluded (vector + keyword only).
+        const activatedGraphGenerationId = await getActiveGeneration(projectId);
+        try {
+            assertGenerationNotStale(ifNoneMatch, activatedGraphGenerationId);
+        }
+        catch (e) {
+            if (e instanceof ToolError) {
+                return { success: false, error: e.message };
+            }
+            throw e;
+        }
+        try {
+            const { definitions, total, total_exact } = await symbolGraphService.listDefinitions(projectId, {
+                search: query,
+                kind: validatedKind,
+                file,
+                exportedOnly,
+                limit: maxResults,
+            });
+            const shown = definitions.length;
+            const omitted = Math.max(0, total - shown);
+            return {
+                success: true,
+                data: {
+                    definitions: definitions.map((d) => ({
+                        fqn: d.fqn,
+                        name: d.name,
+                        kind: d.kind,
+                        file: d.file,
+                        lineStart: d.lineStart,
+                        lineEnd: d.lineEnd,
+                        exported: d.exported,
+                        docComment: d.docComment,
+                        centralityScore: d.centralityScore,
+                    })),
+                    // N4 (WAVE4-N4): pre-LIMIT total, post-LIMIT shown, omitted = total - shown.
+                    // `total` is the exact count of matching definitions BEFORE the SQL LIMIT
+                    // (computed via SELECT COUNT(*) on the same WHERE clauses) for ≤100k
+                    // workspaces. For >100k match sets, T10 emits the sentinel cap (100000)
+                    // with `definitions_total_exact: false` — `total` is a floor, not exact.
+                    definitions_total: total,
+                    definitions_shown: shown,
+                    definitions_omitted: omitted,
+                    definitions_total_exact: total_exact,
+                    // Legacy `total` kept for back-compat with callers that read the old shape.
+                    // Equals `definitions_shown` (the page length) — matches the prior contract.
+                    total: shown,
+                    projectId,
+                    query: query ?? null,
+                    // N1 (WAVE4-N1): the active graph generation id at query time.
+                    activatedGraphGenerationId,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to search definitions: ${error.message}`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=search_definitions.js.map

package/dist/tools/search_definitions.js.map

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

package/dist/tools/search_memories.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Search Memories Tool
+ *
+ * Thin MCP tool layer — validates input and delegates to MemoryController.
+ * All business logic lives in controllers/memory-controller.ts.
+ */
+import { IToolHandler, ToolResponse } from "@massa-ai/shared";
+export declare class SearchMemoriesTool implements IToolHandler {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            userId: {
+                type: string;
+                description: string;
+            };
+            sessionId: {
+                type: string;
+                description: string;
+            };
+            projectId: {
+                type: string;
+                description: string;
+            };
+            agentId: {
+                type: string;
+                description: string;
+            };
+            types: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+                description: string;
+            };
+            minImportance: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            limit: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            includePersistent: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            includeRelated: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            fields: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    private controller;
+    constructor();
+    handle(params: unknown): Promise<ToolResponse>;
+}
+//# sourceMappingURL=search_memories.d.ts.map

package/dist/tools/search_memories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search_memories.d.ts","sourceRoot":"","sources":["../../src/tools/search_memories.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAc,MAAM,kBAAkB,CAAC;AAoB1E,qBAAa,kBAAmB,YAAW,YAAY;IACrD,IAAI,SAAqB;IACzB,WAAW,SACqG;IAChH,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAqDT;IAEF,OAAO,CAAC,UAAU,CAAmB;;IAM/B,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;CA2DrD"}

package/dist/tools/search_memories.js

@@ -0,0 +1,115 @@
+/**
+ * Search Memories Tool
+ *
+ * Thin MCP tool layer — validates input and delegates to MemoryController.
+ * All business logic lives in controllers/memory-controller.ts.
+ */
+import { logger } from "@massa-ai/shared";
+import { MemoryController } from "../controllers/memory-controller.js";
+import { serializeToolResponse } from "./serialize.js";
+export class SearchMemoriesTool {
+    name = "search_memories";
+    description = "Search stored memories across sessions using semantic search (recovers context from previous conversations)";
+    inputSchema = {
+        type: "object",
+        properties: {
+            query: { type: "string", description: "Search query (what to remember)" },
+            userId: { type: "string", description: "Filter by user ID" },
+            sessionId: { type: "string", description: "Filter by session ID" },
+            projectId: { type: "string", description: "Filter by project ID" },
+            agentId: {
+                type: "string",
+                description: "Filter by agent ID (orchestrator, implementer, architect, optimizer)",
+            },
+            types: {
+                type: "array",
+                items: {
+                    type: "string",
+                    enum: ["critical", "conversation", "code", "decision", "pattern"],
+                },
+                description: "Filter by memory types",
+            },
+            minImportance: {
+                type: "number",
+                description: "Minimum importance (0-1)",
+                default: 0.3,
+            },
+            limit: {
+                type: "number",
+                description: "Maximum results to return",
+                default: 10,
+            },
+            includePersistent: {
+                type: "boolean",
+                description: "Include persistent memories from other sessions",
+                default: true,
+            },
+            includeRelated: {
+                type: "boolean",
+                description: "Expand results with graph-related memories (follows knowledge graph edges)",
+                default: false,
+            },
+            format: {
+                type: "string",
+                enum: ["json", "toon"],
+                description: "Output format (json or toon)",
+                default: "toon",
+            },
+            fields: {
+                type: "array",
+                items: { type: "string" },
+                description: "Projection — keep only these keys (dotted paths supported, e.g. ['nodes.symbol']). Absent/empty → full data.",
+            },
+        },
+        required: ["query"],
+    };
+    controller;
+    constructor() {
+        this.controller = MemoryController.getInstance();
+    }
+    async handle(params) {
+        const { query, userId, sessionId, projectId, agentId, types, minImportance, limit, includePersistent, includeRelated, format = "toon", fields, } = params;
+        try {
+            const result = await this.controller.search({
+                query,
+                userId,
+                sessionId,
+                projectId,
+                agentId,
+                types,
+                minImportance,
+                limit,
+                includePersistent,
+                includeRelated,
+            });
+            const responseData = {
+                memories: result.memories.map((m) => ({
+                    id: m.id,
+                    content: m.content,
+                    type: m.type,
+                    level: m.level,
+                    agentId: m.agentId,
+                    importance: m.importance,
+                    tags: m.tags,
+                    score: m.score,
+                    createdAt: new Date(m.createdAt).toISOString(),
+                    accessCount: m.accessCount,
+                    ...(result.relatedSummaries[m.id]
+                        ? { relatedContext: result.relatedSummaries[m.id] }
+                        : {}),
+                })),
+                query: result.query,
+                total: result.total,
+            };
+            return serializeToolResponse(responseData, { format, fields });
+        }
+        catch (error) {
+            logger.error("Failed to search memories", error, { query });
+            return {
+                success: false,
+                error: `Failed to search memories: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=search_memories.js.map

package/dist/tools/search_memories.js.map

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