centient 2.20.0

package/dist/tools/artifacts/searchArtifacts.js

@@ -0,0 +1,98 @@
+import { searchArtifactsInProjects, } from "../../utils/artifacts.js";
+import { estimateTokensFromJSON } from "../../utils/tokenEstimator.js";
+export const searchArtifactsTool = {
+    name: "searchArtifacts",
+    description: "Search finalization packs (session artifacts) across projects by keyword. Returns session metadata.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            keyword: {
+                type: "string",
+                description: "Keyword to search in session titles and summaries",
+            },
+            project: {
+                type: "string",
+                description: "Limit search to specific project name",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum number of results to return",
+                default: 20,
+            },
+        },
+    },
+};
+export async function searchArtifactsHandler(args) {
+    const startTime = Date.now();
+    try {
+        const input = args;
+        const result = await searchArtifacts(input);
+        const responseText = JSON.stringify(result, null, 2);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: responseText,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorResult = {
+            success: false,
+            error: {
+                code: "SEARCH_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                resultsCount: 0,
+                duration,
+            },
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(errorResult, null, 2),
+                },
+            ],
+        };
+    }
+}
+async function searchArtifacts(input) {
+    const startTime = Date.now();
+    try {
+        const results = await searchArtifactsInProjects(input.keyword, input.project, input.limit ?? 20);
+        const tokensUsed = estimateTokensFromJSON(results);
+        const duration = Date.now() - startTime;
+        return {
+            success: true,
+            data: results,
+            metadata: {
+                tokensUsed,
+                resultsCount: results.length,
+                duration,
+            },
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: {
+                code: "SEARCH_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                resultsCount: 0,
+                duration,
+            },
+        };
+    }
+}
+//# sourceMappingURL=searchArtifacts.js.map

package/dist/tools/artifacts/searchArtifacts.js.map

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

package/dist/tools/branching/closeBranch.d.ts

@@ -0,0 +1,10 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export type CloseAction = "merge" | "reject" | "abandon";
+export declare const closeBranchTool: Tool;
+export declare function closeBranchHandler(args: unknown): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=closeBranch.d.ts.map

package/dist/tools/branching/closeBranch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"closeBranch.d.ts","sourceRoot":"","sources":["../../../src/tools/branching/closeBranch.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAQ1D,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAKzD,eAAO,MAAM,eAAe,EAAE,IAqC7B,CAAC;AAkCF,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAiD7D"}

package/dist/tools/branching/closeBranch.js

@@ -0,0 +1,193 @@
+import { getActiveCoordinator } from "../session/startSessionCoordination.js";
+import { estimateTokensFromJSON } from "../../utils/tokenEstimator.js";
+export const closeBranchTool = {
+    name: "close_branch",
+    description: "Close a branch by merging its insights to main, rejecting it with a reason, or abandoning incomplete exploration. Automatically switches back to main path.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            branchId: {
+                type: "string",
+                description: "The branch ID to close (optional - closes active branch if not specified)",
+            },
+            action: {
+                type: "string",
+                enum: ["merge", "reject", "abandon"],
+                description: 'How to close the branch: "merge" (adopt insights), "reject" (document why not), "abandon" (incomplete)',
+            },
+            reason: {
+                type: "string",
+                description: "Reason for rejection/abandonment (required for reject/abandon, optional for merge)",
+            },
+            insights: {
+                type: "array",
+                items: { type: "string" },
+                description: "Key insights or learnings from this exploration (recommended for merge)",
+            },
+            adoptFully: {
+                type: "boolean",
+                description: "For merge: adopt this branch as the new main approach (default: false, just merge insights)",
+            },
+        },
+        required: ["action"],
+    },
+};
+export async function closeBranchHandler(args) {
+    const startTime = Date.now();
+    try {
+        const input = args;
+        if (!input.action) {
+            throw new Error("action is required (merge, reject, or abandon)");
+        }
+        if (input.action === "reject" && !input.reason) {
+            throw new Error("reason is required when rejecting a branch");
+        }
+        const result = await closeBranch(input);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorResult = {
+            success: false,
+            error: {
+                code: "CLOSE_BRANCH_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+            },
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(errorResult, null, 2),
+                },
+            ],
+        };
+    }
+}
+async function closeBranch(input) {
+    const startTime = Date.now();
+    try {
+        const coordinator = getActiveCoordinator();
+        const branchNotes = await coordinator.getNotesByType("branch");
+        let targetBranch;
+        if (input.branchId) {
+            targetBranch = branchNotes.find((note) => note.metadata?.branch_id === input.branchId);
+            if (!targetBranch) {
+                throw new Error(`Branch not found: ${input.branchId}`);
+            }
+        }
+        else {
+            targetBranch = branchNotes.find((note) => note.metadata?.status === "active");
+            if (!targetBranch) {
+                throw new Error("No active branch to close. Use branchId to specify a branch.");
+            }
+        }
+        const branchId = targetBranch.metadata?.branch_id;
+        const branchLabel = targetBranch.content;
+        const currentStatus = targetBranch.metadata?.status;
+        if (currentStatus === "merged" ||
+            currentStatus === "rejected" ||
+            currentStatus === "abandoned") {
+            throw new Error(`Branch already closed with status: ${currentStatus}`);
+        }
+        const finalStatus = input.action === "merge"
+            ? "merged"
+            : input.action === "reject"
+                ? "rejected"
+                : "abandoned";
+        const existingInsights = targetBranch.metadata?.insights_extracted || [];
+        const newInsights = input.insights || [];
+        const allInsights = [...existingInsights, ...newInsights];
+        await coordinator.saveNoteWithId({
+            type: "branch",
+            content: `[${finalStatus.toUpperCase()}] ${branchLabel}`,
+            metadata: {
+                branch_id: branchId,
+                parent_decision_point: targetBranch.metadata?.parent_decision_point,
+                status: finalStatus,
+                reason_explored: targetBranch.metadata?.reason_explored,
+                rejection_reason: input.action === "reject" ? input.reason : undefined,
+                abandonment_reason: input.action === "abandon" ? input.reason : undefined,
+                insights_extracted: allInsights,
+                adopt_fully: input.action === "merge" && input.adoptFully,
+                closed_at: new Date().toISOString(),
+            },
+        });
+        if (input.action === "merge" && allInsights.length > 0) {
+            for (const insight of newInsights) {
+                await coordinator.saveNoteWithId({
+                    type: "learning",
+                    content: insight,
+                    metadata: {
+                        source: "branch_merge",
+                        source_branch: branchId,
+                        source_label: branchLabel,
+                    },
+                });
+            }
+        }
+        let message;
+        switch (input.action) {
+            case "merge":
+                if (input.adoptFully) {
+                    message = `Branch "${branchLabel}" fully adopted as main approach. ${allInsights.length} insight(s) recorded.`;
+                }
+                else {
+                    message = `Merged ${allInsights.length} insight(s) from branch "${branchLabel}" to main.`;
+                }
+                break;
+            case "reject":
+                message = `Branch "${branchLabel}" rejected: ${input.reason}`;
+                break;
+            case "abandon":
+                message = `Branch "${branchLabel}" abandoned${input.reason ? `: ${input.reason}` : " (incomplete exploration)"}.`;
+                break;
+        }
+        const tokensUsed = estimateTokensFromJSON({ input, allInsights });
+        const duration = Date.now() - startTime;
+        return {
+            success: true,
+            data: {
+                branchId,
+                branchLabel,
+                action: input.action,
+                finalStatus,
+                insightsExtracted: allInsights,
+                switchedTo: "main",
+                message: message + " Switched back to main path.",
+            },
+            metadata: {
+                tokensUsed,
+                duration,
+            },
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: {
+                code: "CLOSE_BRANCH_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+            },
+        };
+    }
+}
+//# sourceMappingURL=closeBranch.js.map

package/dist/tools/branching/closeBranch.js.map

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

package/dist/tools/branching/createBranch.d.ts

@@ -0,0 +1,10 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export type BranchStatus = "active" | "merged" | "rejected" | "abandoned";
+export declare const createBranchTool: Tool;
+export declare function createBranchHandler(args: unknown): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=createBranch.d.ts.map

package/dist/tools/branching/createBranch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createBranch.d.ts","sourceRoot":"","sources":["../../../src/tools/branching/createBranch.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAO1D,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAK1E,eAAO,MAAM,gBAAgB,EAAE,IAwB9B,CAAC;AAqCF,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAiD7D"}

package/dist/tools/branching/createBranch.js

@@ -0,0 +1,136 @@
+import { getActiveCoordinator } from "../session/startSessionCoordination.js";
+import { estimateTokensFromJSON } from "../../utils/tokenEstimator.js";
+export const createBranchTool = {
+    name: "create_branch",
+    description: "Create an exploration branch from a decision point to try an alternative approach. The branch becomes active and all subsequent work is tracked under it until closed.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            decisionPointId: {
+                type: "string",
+                description: 'The decision point ID to branch from (e.g., "dp-2026-01-02-001")',
+            },
+            label: {
+                type: "string",
+                description: 'Human-readable label for the branch (e.g., "Elasticsearch approach")',
+            },
+            reasonExplored: {
+                type: "string",
+                description: "Why this alternative is being explored",
+            },
+        },
+        required: ["decisionPointId", "label"],
+    },
+};
+export async function createBranchHandler(args) {
+    const startTime = Date.now();
+    try {
+        const input = args;
+        if (!input.decisionPointId) {
+            throw new Error("decisionPointId is required");
+        }
+        if (!input.label) {
+            throw new Error("label is required");
+        }
+        const result = await createBranch(input);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorResult = {
+            success: false,
+            error: {
+                code: "CREATE_BRANCH_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+            },
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(errorResult, null, 2),
+                },
+            ],
+        };
+    }
+}
+async function createBranch(input) {
+    const startTime = Date.now();
+    try {
+        const coordinator = getActiveCoordinator();
+        const dpNotes = await coordinator.getNotesByType("decision_point");
+        const decisionPoint = dpNotes.find((note) => note.metadata?.decision_point_id === input.decisionPointId);
+        if (!decisionPoint) {
+            throw new Error(`Decision point not found: ${input.decisionPointId}`);
+        }
+        const branchNotes = await coordinator.getNotesByType("branch");
+        const existingBranches = branchNotes.filter((note) => note.metadata?.parent_decision_point === input.decisionPointId);
+        const sequence = String.fromCharCode(97 + existingBranches.length);
+        const branchId = `branch-${input.decisionPointId}-${sequence}`;
+        const activeBranches = branchNotes.filter((note) => note.metadata?.status === "active");
+        const previousBranch = activeBranches.length > 0
+            ? activeBranches[0]?.metadata?.branch_id || "main"
+            : "main";
+        const branch = {
+            id: branchId,
+            label: input.label,
+            parentDecisionPointId: input.decisionPointId,
+            status: "active",
+            reasonExplored: input.reasonExplored || "",
+            createdAt: new Date().toISOString(),
+        };
+        await coordinator.saveNoteWithId({
+            type: "branch",
+            content: input.label,
+            metadata: {
+                branch_id: branchId,
+                parent_decision_point: input.decisionPointId,
+                status: "active",
+                reason_explored: branch.reasonExplored,
+                insights_extracted: [],
+            },
+        });
+        const tokensUsed = estimateTokensFromJSON({ input, branch });
+        const duration = Date.now() - startTime;
+        return {
+            success: true,
+            data: {
+                branch,
+                message: `Branch "${input.label}" created and now active. Use close_branch to reject/merge/abandon when done.`,
+                previousBranch,
+            },
+            metadata: {
+                tokensUsed,
+                duration,
+            },
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: {
+                code: "CREATE_BRANCH_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+            },
+        };
+    }
+}
+//# sourceMappingURL=createBranch.js.map

package/dist/tools/branching/createBranch.js.map

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

package/dist/tools/branching/listBranches.d.ts

@@ -0,0 +1,9 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const listBranchesTool: Tool;
+export declare function listBranchesHandler(args: unknown): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=listBranches.d.ts.map

package/dist/tools/branching/listBranches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listBranches.d.ts","sourceRoot":"","sources":["../../../src/tools/branching/listBranches.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAQ1D,eAAO,MAAM,gBAAgB,EAAE,IAsB9B,CAAC;AAkDF,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAwC7D"}