centient 2.20.0

package/dist/tools/consultation/validateDecision.d.ts

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

package/dist/tools/consultation/validateDecision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateDecision.d.ts","sourceRoot":"","sources":["../../../src/tools/consultation/validateDecision.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAO1D,eAAO,MAAM,oBAAoB,EAAE,IAsClC,CAAC;AA6CF,wBAAsB,uBAAuB,CAC3C,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"}

package/dist/tools/consultation/validateDecision.js

@@ -0,0 +1,253 @@
+import { getActiveCoordinator } from "../session/startSessionCoordination.js";
+import { estimateTokensFromJSON } from "../../utils/tokenEstimator.js";
+export const validateDecisionTool = {
+    name: "validate_decision",
+    description: `Prepare a focused validation request for a specific decision. Retrieves the decision and related context, then formats a prompt for external model review.
+
+Use this when you want an external model to validate a specific architectural or design decision.
+
+Workflow:
+1. validate_decision({ decisionId: <point_id> })
+2. consult_llm({ prompt: <returned prompt>, model: <suggested> })
+3. capture_consultation_response({ ..., relatedDecisionIds: [<point_id>] })
+
+The decision will automatically be linked via validated_by relationship when captured.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            decisionId: {
+                type: "number",
+                description: "The Qdrant point ID of the decision to validate",
+            },
+            validationFocus: {
+                type: "string",
+                description: 'Optional specific aspect to focus validation on (e.g., "security implications", "performance trade-offs")',
+            },
+            includeRelatedContext: {
+                type: "boolean",
+                description: "Include related decisions and hypotheses for context (default: true)",
+            },
+            suggestedModel: {
+                type: "string",
+                enum: ["o3", "gemini-3-pro-preview", "deepseek-reasoner", "gpt-5.2"],
+                description: "Suggested model for validation (default: o3 for architectural decisions)",
+            },
+        },
+        required: ["decisionId"],
+    },
+};
+export async function validateDecisionHandler(args) {
+    const startTime = Date.now();
+    try {
+        const input = args;
+        const result = await validateDecision(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: "VALIDATE_DECISION_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+            },
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(errorResult, null, 2),
+                },
+            ],
+        };
+    }
+}
+async function validateDecision(input) {
+    const startTime = Date.now();
+    const { decisionId, validationFocus, includeRelatedContext = true, suggestedModel, } = input;
+    if (!decisionId || typeof decisionId !== "number") {
+        return {
+            success: false,
+            error: {
+                code: "INVALID_INPUT",
+                message: "decisionId must be a valid Qdrant point ID (number)",
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration: Date.now() - startTime,
+            },
+        };
+    }
+    try {
+        const coordinator = getActiveCoordinator();
+        const decision = await coordinator.getNoteById(decisionId);
+        if (!decision) {
+            return {
+                success: false,
+                error: {
+                    code: "DECISION_NOT_FOUND",
+                    message: `No note found with point ID: ${decisionId}`,
+                },
+                metadata: {
+                    tokensUsed: 0,
+                    duration: Date.now() - startTime,
+                },
+            };
+        }
+        if (decision.type !== "decision") {
+            return {
+                success: false,
+                error: {
+                    code: "NOT_A_DECISION",
+                    message: `Note with ID ${decisionId} is a "${decision.type}", not a decision`,
+                },
+                metadata: {
+                    tokensUsed: 0,
+                    duration: Date.now() - startTime,
+                },
+            };
+        }
+        let causalChain = [];
+        let relatedNotes = [];
+        if (includeRelatedContext) {
+            try {
+                causalChain = await coordinator.getCausalChain(decisionId, 3);
+                relatedNotes = await coordinator.getRelatedNotes(decisionId);
+            }
+            catch (error) {
+                console.error("Failed to get related context:", error);
+            }
+        }
+        const prompt = buildValidationPrompt(decision, causalChain, relatedNotes, validationFocus);
+        const { model, rationale } = selectValidationModel(decision.content, suggestedModel);
+        const tokensUsed = estimateTokensFromJSON({ input, prompt });
+        const duration = Date.now() - startTime;
+        return {
+            success: true,
+            data: {
+                prompt,
+                decision: {
+                    pointId: decisionId,
+                    content: decision.content,
+                    timestamp: decision.timestamp,
+                },
+                relatedContext: {
+                    causalChainLength: causalChain.length,
+                    relatedNotesCount: relatedNotes.length,
+                },
+                suggestedModel: model,
+                modelRationale: rationale,
+                consultLlmCall: {
+                    prompt,
+                    model,
+                },
+                captureCall: {
+                    relatedDecisionIds: [decisionId],
+                },
+            },
+            metadata: {
+                tokensUsed,
+                duration,
+            },
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: {
+                code: "VALIDATE_DECISION_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+            },
+        };
+    }
+}
+function buildValidationPrompt(decision, causalChain, relatedNotes, validationFocus) {
+    const sections = [];
+    sections.push("# Decision Validation Request\n");
+    sections.push("Please review and validate the following architectural/design decision.\n");
+    sections.push("## Decision Under Review\n");
+    sections.push(`**Timestamp:** ${decision.timestamp}\n`);
+    sections.push(`${decision.content}\n`);
+    if (causalChain.length > 1) {
+        sections.push("## Causal Context\n");
+        sections.push("This decision was influenced by the following prior decisions/notes:\n");
+        causalChain.slice(1).forEach((note, i) => {
+            sections.push(`${i + 1}. [${note.type}] ${note.content}`);
+        });
+        sections.push("");
+    }
+    if (relatedNotes.length > 0) {
+        sections.push("## Related Context\n");
+        relatedNotes.slice(0, 5).forEach((note, i) => {
+            sections.push(`${i + 1}. [${note.type}] ${note.content}`);
+        });
+        sections.push("");
+    }
+    if (validationFocus) {
+        sections.push("## Validation Focus\n");
+        sections.push(`Please focus particularly on: **${validationFocus}**\n`);
+    }
+    sections.push("---\n");
+    sections.push("## Requested Response Format\n");
+    sections.push("Please provide your validation assessment:\n");
+    sections.push("### Assessment\n");
+    sections.push("**[Approved/Concerns/Rejected].** [Your primary verdict and reasoning]\n");
+    sections.push("### Key Points\n");
+    sections.push("- [Strengths of this decision]\n");
+    sections.push("### Concerns\n");
+    sections.push("- [Any risks or issues identified]\n");
+    sections.push("### Recommendations\n");
+    sections.push("- [Suggested improvements or mitigations]\n");
+    sections.push("### Confidence\n");
+    sections.push("[High/Medium/Low] - [Reasoning for confidence level]");
+    return sections.join("\n");
+}
+function selectValidationModel(decisionContent, suggestedModel) {
+    if (suggestedModel) {
+        return {
+            model: suggestedModel,
+            rationale: "User-specified model",
+        };
+    }
+    const contentLower = decisionContent.toLowerCase();
+    if (contentLower.includes("security") ||
+        contentLower.includes("architecture") ||
+        contentLower.includes("trade-off") ||
+        contentLower.includes("scalab")) {
+        return {
+            model: "o3",
+            rationale: "Complex architectural decision - o3 excels at deep analysis",
+        };
+    }
+    if (contentLower.includes("implementation") ||
+        contentLower.includes("refactor") ||
+        contentLower.includes("pattern")) {
+        return {
+            model: "gemini-3-pro-preview",
+            rationale: "Implementation decision - Gemini handles detailed review well",
+        };
+    }
+    return {
+        model: "o3",
+        rationale: "Decision validation - o3 provides rigorous analysis",
+    };
+}
+//# sourceMappingURL=validateDecision.js.map

package/dist/tools/consultation/validateDecision.js.map

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

package/dist/tools/consultation/validateReviewResponse.d.ts

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

package/dist/tools/consultation/validateReviewResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateReviewResponse.d.ts","sourceRoot":"","sources":["../../../src/tools/consultation/validateReviewResponse.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAU1D,eAAO,MAAM,0BAA0B,EAAE,IAqCxC,CAAC;AA4BF,wBAAsB,6BAA6B,CACjD,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,CA8E7D"}

package/dist/tools/consultation/validateReviewResponse.js

@@ -0,0 +1,105 @@
+import { ReviewContractStatus, validateReviewResponse, buildContractAwarePrompt, } from "./peerReviewContract.js";
+import { extractFullSessionContext } from "../../utils/contextBuilder.js";
+export const validateReviewResponseTool = {
+    name: "validate_review_response",
+    description: `Validate an LLM review response against contract acceptance criteria.
+
+Part of the Contractor Model workflow for accountable peer review.
+
+Use after receiving a review from consult_llm to:
+- Check if all required deliverables are present
+- Verify acceptance criteria are met
+- Determine if iteration is needed
+- Get feedback prompt for next iteration
+
+Workflow:
+1. peer_review_contract() → contract
+2. consult_llm(contract.prompt) → response
+3. validate_review_response(contract, response) → validation
+4. If validation.requiresIteration: consult_llm(validation.iterationPrompt)
+5. Repeat until validation passes or maxIterations reached`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            contract: {
+                type: "object",
+                description: "The ReviewContract from peer_review_contract()",
+            },
+            response: {
+                type: "string",
+                description: "The LLM review response to validate",
+            },
+            iteration: {
+                type: "number",
+                default: 1,
+                description: "Current iteration number (default: 1)",
+            },
+        },
+        required: ["contract", "response"],
+    },
+};
+export async function validateReviewResponseHandler(args) {
+    try {
+        const input = args;
+        const { contract, response, iteration = 1 } = input;
+        const validation = validateReviewResponse(contract, response, iteration);
+        const result = {
+            success: !validation.requiresIteration,
+            validation,
+            contractUpdate: {
+                status: validation.requiresIteration
+                    ? ReviewContractStatus.EXECUTING
+                    : validation.allCriteriaPassed
+                        ? ReviewContractStatus.COMPLETE
+                        : ReviewContractStatus.FAILED,
+                auditEntry: {
+                    timestamp: new Date().toISOString(),
+                    event: validation.requiresIteration
+                        ? "validation_iteration_required"
+                        : validation.allCriteriaPassed
+                            ? "validation_passed"
+                            : "validation_failed",
+                    details: {
+                        iteration,
+                        overallScore: validation.overallScore,
+                        verdict: validation.verdict,
+                        confidence: validation.confidence,
+                        deliverablesMet: validation.allDeliverablesMet,
+                        criteriaPassed: validation.allCriteriaPassed,
+                    },
+                },
+            },
+        };
+        if (validation.requiresIteration &&
+            iteration < contract.constraints.maxIterations) {
+            const context = await extractFullSessionContext();
+            result.iterationPrompt = buildContractAwarePrompt(contract, context, iteration + 1, validation);
+        }
+        if (!validation.requiresIteration && validation.verdict) {
+            result.captureCall = {
+                originalQuestion: `Contract review: ${contract.id}`,
+                model: "o3",
+                persistToMemoryBank: true,
+                relatedDecisionIds: [],
+            };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: false,
+                        error: { code: "VALIDATION_ERROR", message: errorMessage },
+                    }),
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=validateReviewResponse.js.map

package/dist/tools/consultation/validateReviewResponse.js.map

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

package/dist/tools/graph/addNoteRelationship.d.ts

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

package/dist/tools/graph/addNoteRelationship.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addNoteRelationship.d.ts","sourceRoot":"","sources":["../../../src/tools/graph/addNoteRelationship.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAQ1D,eAAO,MAAM,uBAAuB,EAAE,IAkCrC,CAAC;AA8BF,wBAAsB,0BAA0B,CAC9C,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,CAqD7D"}

package/dist/tools/graph/addNoteRelationship.js

@@ -0,0 +1,120 @@
+import { getActiveCoordinator } from "../session/startSessionCoordination.js";
+import { estimateTokensFromJSON } from "../../utils/tokenEstimator.js";
+export const addNoteRelationshipTool = {
+    name: "add_note_relationship",
+    description: "Link two notes with a typed relationship. Creates explicit graph edges between session notes for causal chain queries.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source_note_id: {
+                type: "number",
+                description: "The Qdrant point ID of the source note",
+            },
+            target_note_id: {
+                type: "number",
+                description: "The Qdrant point ID of the target note",
+            },
+            relationship: {
+                type: "string",
+                enum: [
+                    "preceded_by",
+                    "caused_by",
+                    "validated_by",
+                    "superseded_by",
+                    "related_to",
+                ],
+                description: "Type of relationship. preceded_by: chronological order. caused_by: causal antecedent. validated_by: confirmation. superseded_by: replacement. related_to: generic link.",
+            },
+            evidence: {
+                type: "string",
+                description: "Optional explanation of why this relationship exists",
+            },
+        },
+        required: ["source_note_id", "target_note_id", "relationship"],
+    },
+};
+export async function addNoteRelationshipHandler(args) {
+    const startTime = Date.now();
+    try {
+        const input = args;
+        if (!input.source_note_id) {
+            throw new Error("source_note_id is required");
+        }
+        if (!input.target_note_id) {
+            throw new Error("target_note_id is required");
+        }
+        if (!input.relationship) {
+            throw new Error("relationship is required");
+        }
+        const result = await addRelationship(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: "ADD_RELATIONSHIP_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+            },
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(errorResult, null, 2),
+                },
+            ],
+        };
+    }
+}
+async function addRelationship(input) {
+    const startTime = Date.now();
+    try {
+        const coordinator = getActiveCoordinator();
+        await coordinator.addRelationship(input.source_note_id, input.target_note_id, input.relationship);
+        const tokensUsed = estimateTokensFromJSON({ input });
+        const duration = Date.now() - startTime;
+        return {
+            success: true,
+            data: {
+                source_note_id: input.source_note_id,
+                target_note_id: input.target_note_id,
+                relationship: input.relationship,
+                created: true,
+            },
+            metadata: {
+                tokensUsed,
+                duration,
+            },
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: {
+                code: "ADD_RELATIONSHIP_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+            },
+        };
+    }
+}
+//# sourceMappingURL=addNoteRelationship.js.map

package/dist/tools/graph/addNoteRelationship.js.map

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

package/dist/tools/graph/linkSessions.d.ts

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

package/dist/tools/graph/linkSessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkSessions.d.ts","sourceRoot":"","sources":["../../../src/tools/graph/linkSessions.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAQ1D,eAAO,MAAM,gBAAgB,EAAE,IAsC9B,CAAC;AA+BF,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,CAyD7D"}