conatus 0.1.0

package/dist/execution/pipeline-executor.js

@@ -0,0 +1,250 @@
+// ─── PipelineExecutor ───
+//
+// Executes a TaskPipeline sequentially with persistence and idempotency.
+// Phase 2: Plan Approval Gate, 3-stage escalation, strategy feedback.
+import { randomUUID } from "node:crypto";
+import { PipelineStateSchema } from "../types/pipeline.js";
+const HIGH_TRUST_THRESHOLD = 20;
+const PLAN_MODE_PREFIX = "Generate a plan for the following task. Do NOT execute — output the plan only.\n\n";
+// ─── PipelineExecutor ───
+export class PipelineExecutor {
+    stateManager;
+    adapterRegistry;
+    logger;
+    approvalFn;
+    strategyFeedbackFn;
+    findAlternativeAdapter;
+    maxRetries;
+    constructor(deps) {
+        this.stateManager = deps.stateManager;
+        this.adapterRegistry = deps.adapterRegistry;
+        this.logger = deps.logger;
+        this.approvalFn = deps.approvalFn;
+        this.strategyFeedbackFn = deps.strategyFeedbackFn;
+        this.findAlternativeAdapter = deps.findAlternativeAdapter;
+        this.maxRetries = deps.maxRetries ?? 3;
+    }
+    async run(taskId, task, pipeline, observationContext, trustScore) {
+        let state = await this.restoreState(taskId);
+        const isResume = state !== null && state.status === "interrupted";
+        if (!isResume) {
+            const now = new Date().toISOString();
+            state = {
+                pipeline_id: randomUUID(),
+                task_id: taskId,
+                current_stage_index: 0,
+                completed_stages: [],
+                status: "running",
+                started_at: now,
+                updated_at: now,
+            };
+        }
+        else {
+            this.logger?.info("[PipelineExecutor] Resuming interrupted pipeline", {
+                taskId, fromStage: state.current_stage_index,
+            });
+            state = { ...state, status: "running", updated_at: new Date().toISOString() };
+        }
+        await this.persistState(taskId, state);
+        for (let i = state.current_stage_index; i < pipeline.stages.length; i++) {
+            const stage = pipeline.stages[i];
+            const idempotencyKey = `${taskId}:${i}:0`;
+            if (state.completed_stages.some((r) => r.idempotency_key === idempotencyKey)) {
+                this.logger?.info("[PipelineExecutor] Skipping completed stage", { stage: i });
+                continue;
+            }
+            // Plan Approval Gate
+            if (stage.role === "implementor" && pipeline.plan_required) {
+                const gate = await this.runPlanApprovalGate(stage, task, pipeline, observationContext, trustScore);
+                if (!gate.approved) {
+                    this.logger?.info("[PipelineExecutor] Plan not approved — aborting", { stage: i });
+                    state = { ...state, status: "failed", updated_at: new Date().toISOString() };
+                    await this.persistState(taskId, state);
+                    break;
+                }
+                if (gate.modified_plan) {
+                    pipeline = { ...pipeline, shared_context: gate.modified_plan };
+                }
+            }
+            const stageResult = await this.executeWithEscalation(i, stage, task, pipeline, observationContext, idempotencyKey);
+            state = {
+                ...state,
+                current_stage_index: i + 1,
+                completed_stages: [...state.completed_stages, stageResult],
+                updated_at: new Date().toISOString(),
+            };
+            await this.persistState(taskId, state);
+            this.logger?.info("[PipelineExecutor] Stage complete", { stage: i, role: stage.role, verdict: stageResult.verdict });
+            if (pipeline.fail_fast && stageResult.verdict === "fail") {
+                state = { ...state, status: "failed", updated_at: new Date().toISOString() };
+                await this.persistState(taskId, state);
+                break;
+            }
+        }
+        if (state.status === "running") {
+            state = { ...state, status: "completed", updated_at: new Date().toISOString() };
+            await this.persistState(taskId, state);
+        }
+        const lastStage = state.completed_stages[state.completed_stages.length - 1];
+        const finalVerdict = lastStage?.verdict ?? "fail";
+        if (pipeline.strategy_id && this.strategyFeedbackFn) {
+            this.strategyFeedbackFn(pipeline.strategy_id, finalVerdict);
+        }
+        return {
+            pipeline_id: state.pipeline_id,
+            final_verdict: finalVerdict,
+            stage_results: state.completed_stages,
+            status: state.status,
+        };
+    }
+    // ─── Plan Approval Gate ───
+    async runPlanApprovalGate(stage, task, pipeline, observationContext, trustScore) {
+        const planTask = this.buildStagePrompt({ ...stage, prompt_override: PLAN_MODE_PREFIX }, task, observationContext, pipeline.shared_context);
+        let plan = "";
+        try {
+            const adapter = this.selectAdapter(stage);
+            const result = await adapter.execute(planTask);
+            plan = result.output;
+        }
+        catch (err) {
+            this.logger?.warn("[PipelineExecutor] Plan generation failed", { error: err instanceof Error ? err.message : String(err) });
+            return { approved: false, plan: "" };
+        }
+        if (trustScore !== undefined && trustScore >= HIGH_TRUST_THRESHOLD) {
+            this.logger?.info("[PipelineExecutor] Plan auto-approved (high trust)", { trustScore });
+            return { approved: true, plan };
+        }
+        if (this.approvalFn) {
+            return { approved: await this.approvalFn(plan), plan };
+        }
+        this.logger?.warn("[PipelineExecutor] No approvalFn configured — plan denied");
+        return { approved: false, plan };
+    }
+    // ─── 3-Stage Escalation ───
+    async executeWithEscalation(stageIndex, stage, task, pipeline, observationContext, idempotencyKey) {
+        // Without escalation deps, run a single attempt (backward-compatible).
+        const maxAttempts = (this.approvalFn ?? this.findAlternativeAdapter) ? this.maxRetries : 1;
+        let lastError = "";
+        let currentAdapter = this.selectAdapter(stage);
+        const baseTask = this.buildStagePrompt(stage, task, observationContext, pipeline.shared_context);
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            // Strike 2: try alternative adapter
+            if (attempt === 1 && stage.capability_requirement?.domain && this.findAlternativeAdapter) {
+                const alt = this.findAlternativeAdapter(stage.capability_requirement.domain, stage.capability_requirement.preferred_adapter ?? "");
+                if (alt) {
+                    try {
+                        currentAdapter = this.adapterRegistry.getAdapter(alt);
+                        this.logger?.info("[PipelineExecutor] Escalation: switching adapter", { stage: stageIndex, adapter: alt });
+                    }
+                    catch { /* keep existing */ }
+                }
+            }
+            // Strike 3: human escalation
+            if (attempt === this.maxRetries - 1 && this.approvalFn) {
+                this.logger?.warn("[PipelineExecutor] Escalation: requesting human approval", { stage: stageIndex });
+                const ok = await this.approvalFn(`Stage ${stageIndex} (${stage.role}) failed ${attempt} time(s).\nLast error: ${lastError}\n\nApprove to attempt final retry?`);
+                if (!ok) {
+                    return this.makeStageResult(stageIndex, stage, idempotencyKey, false, "", "Human escalation rejected");
+                }
+            }
+            const retryTask = attempt === 0
+                ? baseTask
+                : { ...baseTask, prompt: `${baseTask.prompt}\n\nPREVIOUS ATTEMPT FAILED: ${lastError}\nPlease try again.` };
+            let result;
+            try {
+                result = await currentAdapter.execute(retryTask);
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err.message : String(err);
+                result = { success: false, output: "", error: lastError, exit_code: null, elapsed_ms: 0, stopped_reason: "error" };
+            }
+            if (this.mapResultToVerdict(result) !== "fail") {
+                return this.makeStageResult(stageIndex, stage, idempotencyKey, result.success, result.output);
+            }
+            lastError = result.error ?? "unknown failure";
+            this.logger?.warn("[PipelineExecutor] Stage attempt failed", { stage: stageIndex, attempt: attempt + 1, error: lastError });
+        }
+        return this.makeStageResult(stageIndex, stage, idempotencyKey, false, "");
+    }
+    // ─── Private helpers ───
+    makeStageResult(stageIndex, stage, idempotencyKey, success, output, error) {
+        const fakeResult = {
+            success,
+            output,
+            error: error ?? null,
+            exit_code: null,
+            elapsed_ms: 0,
+            stopped_reason: success ? "completed" : "error",
+        };
+        return {
+            stage_index: stageIndex,
+            role: stage.role,
+            verdict: this.mapResultToVerdict(fakeResult),
+            output,
+            confidence: success ? 0.8 : 0.2,
+            idempotency_key: idempotencyKey,
+        };
+    }
+    selectAdapter(stage) {
+        const preferred = stage.capability_requirement?.preferred_adapter;
+        if (preferred) {
+            try {
+                return this.adapterRegistry.getAdapter(preferred);
+            }
+            catch { /* fall through */ }
+        }
+        const types = this.adapterRegistry.listAdapters();
+        if (types.length === 0)
+            throw new Error("[PipelineExecutor] No adapters registered");
+        return this.adapterRegistry.getAdapter(types[0]);
+    }
+    buildStagePrompt(stage, task, observationContext, sharedContext) {
+        let prompt;
+        switch (stage.role) {
+            case "implementor":
+            case "researcher": {
+                const parts = [task.prompt];
+                if (observationContext)
+                    parts.push(`\n\nOBSERVATION CONTEXT:\n${observationContext}`);
+                if (sharedContext)
+                    parts.push(`\n\nSHARED CONTEXT:\n${sharedContext}`);
+                prompt = parts.join("");
+                break;
+            }
+            case "verifier": {
+                prompt = task.prompt;
+                if (sharedContext)
+                    prompt += `\n\nSHARED CONTEXT:\n${sharedContext}`;
+                break;
+            }
+            default: {
+                prompt = task.prompt;
+            }
+        }
+        if (stage.prompt_override)
+            prompt = `${stage.prompt_override}\n\n${prompt}`;
+        return { ...task, prompt };
+    }
+    async persistState(taskId, state) {
+        await this.stateManager.writeRaw(`pipelines/${taskId}.json`, state);
+    }
+    async restoreState(taskId) {
+        try {
+            const raw = await this.stateManager.readRaw(`pipelines/${taskId}.json`);
+            if (!raw)
+                return null;
+            return PipelineStateSchema.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    mapResultToVerdict(result) {
+        if (result.stopped_reason === "error" || result.stopped_reason === "timeout")
+            return "fail";
+        if (result.success)
+            return "pass";
+        return "partial";
+    }
+}
+//# sourceMappingURL=pipeline-executor.js.map

package/dist/execution/pipeline-executor.js.map

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

package/dist/execution/reflection-generator.d.ts

@@ -0,0 +1,24 @@
+import { type ReflectionNote } from "../types/reflection.js";
+import type { ILLMClient } from "../llm/llm-client.js";
+import type { Task } from "../types/task.js";
+import type { VerificationResult } from "../types/task.js";
+import type { KnowledgeManager } from "../knowledge/knowledge-manager.js";
+import type { IPromptGateway } from "../prompt/gateway.js";
+interface ReflectionLogger {
+    debug?: (message: string, context?: Record<string, unknown>) => void;
+    warn?: (message: string, context?: Record<string, unknown>) => void;
+}
+export declare function generateReflection(params: {
+    task: Task;
+    verificationResult: VerificationResult;
+    goalId: string;
+    strategyId?: string;
+    llmClient: ILLMClient;
+    logger?: ReflectionLogger;
+    gateway?: IPromptGateway;
+}): Promise<ReflectionNote>;
+export declare function saveReflectionAsKnowledge(knowledgeManager: KnowledgeManager, goalId: string, reflection: ReflectionNote, taskDescription: string): Promise<void>;
+export declare function getReflectionsForGoal(knowledgeManager: KnowledgeManager, goalId: string, limit?: number): Promise<ReflectionNote[]>;
+export declare function formatReflectionsForPrompt(reflections: ReflectionNote[]): string;
+export {};
+//# sourceMappingURL=reflection-generator.d.ts.map

package/dist/execution/reflection-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-generator.d.ts","sourceRoot":"","sources":["../../src/execution/reflection-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAG1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,UAAU,gBAAgB;IACxB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACrE,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACrE;AAuBD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,IAAI,EAAE,IAAI,CAAC;IACX,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,UAAU,CAAC;IACtB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,GAAG,OAAO,CAAC,cAAc,CAAC,CA+D1B;AAID,wBAAsB,yBAAyB,CAC7C,gBAAgB,EAAE,gBAAgB,EAClC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,cAAc,EAC1B,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAyBf;AAID,wBAAsB,qBAAqB,CACzC,gBAAgB,EAAE,gBAAgB,EAClC,MAAM,EAAE,MAAM,EACd,KAAK,SAAI,GACR,OAAO,CAAC,cAAc,EAAE,CAAC,CAwB3B;AAID,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,MAAM,CAQhF"}

package/dist/execution/reflection-generator.js

@@ -0,0 +1,143 @@
+import { randomUUID } from "node:crypto";
+import { z } from "zod";
+import { ReflectionNoteSchema } from "../types/reflection.js";
+import { extractJSON } from "../llm/llm-client.js";
+const LLMReflectionSchema = z.object({
+    what_was_attempted: z.string(),
+    outcome: z.enum(["success", "partial", "fail"]),
+    why_it_worked_or_failed: z.string(),
+    what_to_do_differently: z.string(),
+});
+function mapVerdict(verdict) {
+    if (verdict === "pass")
+        return "success";
+    if (verdict === "partial")
+        return "partial";
+    return "fail";
+}
+function mapVerdictToConfidence(verdict) {
+    if (verdict === "pass")
+        return 0.9;
+    if (verdict === "partial")
+        return 0.6;
+    return 0.3;
+}
+// --- generateReflection ---
+export async function generateReflection(params) {
+    const { task, verificationResult, goalId, strategyId, llmClient, logger, gateway } = params;
+    const prompt = `You are analyzing the result of an AI agent task execution. Generate a structured reflection.
+
+Task: ${task.work_description}
+Verdict: ${verificationResult.verdict}
+Confidence: ${verificationResult.confidence}
+Evidence: ${verificationResult.evidence.map((e) => e.description).join("; ")}
+
+Respond with JSON only:
+{
+  "what_was_attempted": "brief description of what was done",
+  "outcome": "${mapVerdict(verificationResult.verdict)}",
+  "why_it_worked_or_failed": "root cause analysis",
+  "what_to_do_differently": "actionable improvement for next time"
+}`;
+    try {
+        let parsed;
+        if (gateway) {
+            parsed = await gateway.execute({
+                purpose: "reflection_generation",
+                goalId,
+                additionalContext: { prompt },
+                responseSchema: LLMReflectionSchema,
+                maxTokens: 512,
+            });
+        }
+        else {
+            const response = await llmClient.sendMessage([{ role: "user", content: prompt }], { max_tokens: 512 });
+            const jsonText = extractJSON(response.content);
+            const raw = JSON.parse(jsonText);
+            parsed = LLMReflectionSchema.parse(raw);
+        }
+        return ReflectionNoteSchema.parse({
+            reflection_id: randomUUID(),
+            goal_id: goalId,
+            strategy_id: strategyId ?? null,
+            task_id: task.id,
+            what_was_attempted: parsed.what_was_attempted,
+            outcome: parsed.outcome,
+            why_it_worked_or_failed: parsed.why_it_worked_or_failed,
+            what_to_do_differently: parsed.what_to_do_differently,
+            created_at: new Date().toISOString(),
+        });
+    }
+    catch (err) {
+        logger?.warn?.("generateReflection: LLM parse failed, using fallback", { error: String(err) });
+        return ReflectionNoteSchema.parse({
+            reflection_id: randomUUID(),
+            goal_id: goalId,
+            strategy_id: strategyId ?? null,
+            task_id: task.id,
+            what_was_attempted: task.work_description,
+            outcome: mapVerdict(verificationResult.verdict),
+            why_it_worked_or_failed: "Analysis unavailable",
+            what_to_do_differently: "Review task and retry",
+            created_at: new Date().toISOString(),
+        });
+    }
+}
+// --- saveReflectionAsKnowledge ---
+export async function saveReflectionAsKnowledge(knowledgeManager, goalId, reflection, taskDescription) {
+    const tags = ["reflection", `goal:${goalId}`];
+    if (reflection.strategy_id) {
+        tags.push(`strategy:${reflection.strategy_id}`);
+    }
+    const entry = {
+        entry_id: randomUUID(),
+        question: `Reflection: ${taskDescription}`,
+        answer: JSON.stringify({
+            what_was_attempted: reflection.what_was_attempted,
+            outcome: reflection.outcome,
+            why_it_worked_or_failed: reflection.why_it_worked_or_failed,
+            what_to_do_differently: reflection.what_to_do_differently,
+        }),
+        sources: [],
+        confidence: mapVerdictToConfidence(reflection.outcome === "success" ? "pass" : reflection.outcome),
+        acquired_at: reflection.created_at,
+        acquisition_task_id: reflection.task_id,
+        superseded_by: null,
+        tags,
+        embedding_id: null,
+    };
+    await knowledgeManager.saveKnowledge(goalId, entry);
+}
+// --- getReflectionsForGoal ---
+export async function getReflectionsForGoal(knowledgeManager, goalId, limit = 5) {
+    const entries = await knowledgeManager.loadKnowledge(goalId, ["reflection"]);
+    const reflections = [];
+    for (const entry of entries) {
+        try {
+            const raw = JSON.parse(entry.answer);
+            const note = ReflectionNoteSchema.parse({
+                reflection_id: entry.entry_id,
+                goal_id: goalId,
+                strategy_id: null,
+                task_id: entry.acquisition_task_id,
+                ...raw,
+                created_at: entry.acquired_at,
+            });
+            reflections.push(note);
+        }
+        catch {
+            // skip malformed entries
+        }
+    }
+    return reflections
+        .sort((a, b) => b.created_at.localeCompare(a.created_at))
+        .slice(0, limit);
+}
+// --- formatReflectionsForPrompt ---
+export function formatReflectionsForPrompt(reflections) {
+    if (reflections.length === 0)
+        return "";
+    const lines = reflections.map((r) => `- [${r.outcome}] Attempted: ${r.what_was_attempted} → Why: ${r.why_it_worked_or_failed} → Next time: ${r.what_to_do_differently}`);
+    return "## Past Reflections (learn from these)\n" + lines.join("\n");
+}
+//# sourceMappingURL=reflection-generator.js.map

package/dist/execution/reflection-generator.js.map

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

package/dist/execution/result-reconciler.d.ts

@@ -0,0 +1,23 @@
+import type { ILLMClient } from "../llm/llm-client.js";
+import type { IPromptGateway } from "../prompt/gateway.js";
+import type { Logger } from "../runtime/logger.js";
+import type { SubtaskResult } from "./parallel-executor.js";
+export interface Contradiction {
+    task_a_id: string;
+    task_b_id: string;
+    description: string;
+    severity: "critical" | "warning" | "info";
+}
+export interface ContradictionReport {
+    has_contradictions: boolean;
+    contradictions: Contradiction[];
+    confidence: number;
+}
+export interface ReconcilerDeps {
+    llmClient: ILLMClient;
+    logger?: Logger;
+    gateway?: IPromptGateway;
+}
+export declare function buildReconciliationPrompt(resultA: SubtaskResult, resultB: SubtaskResult): string;
+export declare function reconcileResults(deps: ReconcilerDeps, results: SubtaskResult[]): Promise<ContradictionReport>;
+//# sourceMappingURL=result-reconciler.d.ts.map

package/dist/execution/result-reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-reconciler.d.ts","sourceRoot":"","sources":["../../src/execution/result-reconciler.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAI5D,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;CAC3C;AAED,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,UAAU,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAID,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,aAAa,GACrB,MAAM,CAuBR;AA2ED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,aAAa,EAAE,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAyB9B"}

package/dist/execution/result-reconciler.js

@@ -0,0 +1,109 @@
+// ─── ResultReconciler ───
+//
+// Detects semantic contradictions between parallel subtask results using LLM.
+// Fails open: on any LLM error, returns no contradictions with confidence 0.
+import { z } from "zod";
+// ─── Prompt Builder ───
+export function buildReconciliationPrompt(resultA, resultB) {
+    return `You are a contradiction detector for parallel agent task outputs.
+
+Compare these two task outputs and identify any semantic contradictions — cases where
+the outputs conflict, produce incompatible changes, or make inconsistent assumptions.
+
+Task A (id: ${resultA.task_id}, verdict: ${resultA.verdict}):
+${resultA.output || "(no output)"}
+
+Task B (id: ${resultB.task_id}, verdict: ${resultB.verdict}):
+${resultB.output || "(no output)"}
+
+Respond with JSON only (no markdown):
+{
+  "contradictions": [
+    {
+      "description": "brief description of the contradiction",
+      "severity": "critical" | "warning" | "info"
+    }
+  ]
+}
+
+If there are no contradictions, return: { "contradictions": [] }`;
+}
+const ReconciliationResponseSchema = z.object({
+    contradictions: z.array(z.object({
+        description: z.string(),
+        severity: z.string(),
+    })),
+});
+async function checkPair(deps, resultA, resultB) {
+    const prompt = buildReconciliationPrompt(resultA, resultB);
+    let parsed;
+    if (deps.gateway) {
+        try {
+            parsed = await deps.gateway.execute({
+                purpose: "result_reconciliation",
+                additionalContext: { reconciliation_prompt: prompt },
+                responseSchema: ReconciliationResponseSchema,
+                maxTokens: 512,
+                temperature: 0,
+            });
+        }
+        catch {
+            deps.logger?.warn("[ResultReconciler] gateway call failed", {
+                taskAId: resultA.task_id,
+                taskBId: resultB.task_id,
+            });
+            return [];
+        }
+    }
+    else {
+        const response = await deps.llmClient.sendMessage([{ role: "user", content: prompt }], { max_tokens: 512, temperature: 0 });
+        try {
+            parsed = JSON.parse(response.content);
+        }
+        catch {
+            deps.logger?.warn("[ResultReconciler] Failed to parse LLM response as JSON", {
+                taskAId: resultA.task_id,
+                taskBId: resultB.task_id,
+            });
+            return [];
+        }
+    }
+    const items = Array.isArray(parsed?.contradictions)
+        ? parsed.contradictions
+        : [];
+    const validSeverities = new Set(["critical", "warning", "info"]);
+    return items
+        .filter((c) => c.description && validSeverities.has(c.severity))
+        .map((c) => ({
+        task_a_id: resultA.task_id,
+        task_b_id: resultB.task_id,
+        description: c.description,
+        severity: c.severity,
+    }));
+}
+// ─── Main Export ───
+export async function reconcileResults(deps, results) {
+    if (results.length <= 1) {
+        return { has_contradictions: false, contradictions: [], confidence: 1.0 };
+    }
+    const allContradictions = [];
+    try {
+        for (let i = 0; i < results.length; i++) {
+            for (let j = i + 1; j < results.length; j++) {
+                const found = await checkPair(deps, results[i], results[j]);
+                allContradictions.push(...found);
+            }
+        }
+    }
+    catch (err) {
+        const error = err instanceof Error ? err.message : String(err);
+        deps.logger?.warn("[ResultReconciler] LLM call failed, failing open", { error });
+        return { has_contradictions: false, contradictions: [], confidence: 0.0 };
+    }
+    return {
+        has_contradictions: allContradictions.length > 0,
+        contradictions: allContradictions,
+        confidence: 1.0,
+    };
+}
+//# sourceMappingURL=result-reconciler.js.map

package/dist/execution/result-reconciler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-reconciler.js","sourceRoot":"","sources":["../../src/execution/result-reconciler.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAE7E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA6BxB,yBAAyB;AAEzB,MAAM,UAAU,yBAAyB,CACvC,OAAsB,EACtB,OAAsB;IAEtB,OAAO;;;;;cAKK,OAAO,CAAC,OAAO,cAAc,OAAO,CAAC,OAAO;EACxD,OAAO,CAAC,MAAM,IAAI,aAAa;;cAEnB,OAAO,CAAC,OAAO,cAAc,OAAO,CAAC,OAAO;EACxD,OAAO,CAAC,MAAM,IAAI,aAAa;;;;;;;;;;;;iEAYgC,CAAC;AAClE,CAAC;AASD,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACrB,CAAC,CAAC;CACJ,CAAC,CAAC;AAEH,KAAK,UAAU,SAAS,CACtB,IAAoB,EACpB,OAAsB,EACtB,OAAsB;IAEtB,MAAM,MAAM,GAAG,yBAAyB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAE3D,IAAI,MAAkD,CAAC;IACvD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;gBAClC,OAAO,EAAE,uBAAuB;gBAChC,iBAAiB,EAAE,EAAE,qBAAqB,EAAE,MAAM,EAAE;gBACpD,cAAc,EAAE,4BAA4B;gBAC5C,SAAS,EAAE,GAAG;gBACd,WAAW,EAAE,CAAC;aACf,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,wCAAwC,EAAE;gBAC1D,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,OAAO,EAAE,OAAO,CAAC,OAAO;aACzB,CAAC,CAAC;YACH,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAC/C,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EACnC,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,CACpC,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,yDAAyD,EAAE;gBAC3E,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,OAAO,EAAE,OAAO,CAAC,OAAO;aACzB,CAAC,CAAC;YACH,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAA2B,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC;QACzE,CAAC,CAAC,MAAM,CAAC,cAAc;QACvB,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAEjE,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;SAC/D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,SAAS,EAAE,OAAO,CAAC,OAAO;QAC1B,SAAS,EAAE,OAAO,CAAC,OAAO;QAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,QAAQ,EAAE,CAAC,CAAC,QAAqC;KAClD,CAAC,CAAC,CAAC;AACR,CAAC;AAED,sBAAsB;AAEtB,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAoB,EACpB,OAAwB;IAExB,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;IAC5E,CAAC;IAED,MAAM,iBAAiB,GAAoB,EAAE,CAAC;IAE9C,IAAI,CAAC;QACH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC5C,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5D,iBAAiB,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/D,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,kDAAkD,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACjF,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;IAC5E,CAAC;IAED,OAAO;QACL,kBAAkB,EAAE,iBAAiB,CAAC,MAAM,GAAG,CAAC;QAChD,cAAc,EAAE,iBAAiB;QACjC,UAAU,EAAE,GAAG;KAChB,CAAC;AACJ,CAAC"}