pulseed 0.4.18 → 0.4.19

package/dist/orchestrator/execution/parallel-executor.js

@@ -0,0 +1,172 @@
+// ─── ParallelExecutor ───
+//
+// Executes a TaskGroup's subtasks in parallel waves, respecting dependency
+// ordering and file ownership constraints. Each wave is a set of tasks
+// whose dependencies have already completed; waves run via Promise.all.
+import { reconcileResults } from "./result-reconciler.js";
+import { durationToMs } from "./task/task-executor.js";
+// ─── ParallelExecutor ───
+export class ParallelExecutor {
+    pipelineExecutor;
+    logger;
+    concurrencyLimit;
+    llmClient;
+    constructor(deps) {
+        this.pipelineExecutor = deps.pipelineExecutor;
+        this.logger = deps.logger;
+        this.concurrencyLimit = deps.concurrencyLimit ?? 3;
+        this.llmClient = deps.llmClient;
+    }
+    async execute(group, context) {
+        // 1. Validate file ownership — throws on conflict
+        const conflicts = this.validateFileOwnership(group);
+        if (conflicts.length > 0) {
+            throw new Error(`[ParallelExecutor] File ownership conflicts detected:\n${conflicts.join("\n")}`);
+        }
+        // 2. Build execution order (topological waves)
+        const waves = this.buildExecutionOrder(group);
+        this.logger?.info("[ParallelExecutor] Execution waves", {
+            goalId: context.goalId,
+            waveCount: waves.length,
+            waves,
+        });
+        // 3. Execute waves sequentially, tasks within each wave in parallel (with concurrency limit)
+        const allResults = [];
+        for (const wave of waves) {
+            const tasks = wave.map((taskId) => () => this.runSubtask(taskId, group, context));
+            const waveResults = await this.runWithSemaphore(tasks, this.concurrencyLimit);
+            allResults.push(...waveResults);
+        }
+        // Reconcile results for contradictions (if llmClient is available)
+        if (this.llmClient && allResults.length > 1) {
+            try {
+                const report = await reconcileResults({ llmClient: this.llmClient, logger: this.logger }, allResults);
+                if (report.has_contradictions) {
+                    this.logger?.warn("[ParallelExecutor] Result reconciliation found contradictions", {
+                        goalId: context.goalId,
+                        contradictions: report.contradictions,
+                    });
+                }
+            }
+            catch (err) {
+                const error = err instanceof Error ? err.message : String(err);
+                this.logger?.warn("[ParallelExecutor] Result reconciliation failed (non-fatal)", { error });
+            }
+        }
+        const overall_verdict = this.aggregateVerdict(allResults);
+        this.logger?.info("[ParallelExecutor] Execution complete", {
+            goalId: context.goalId,
+            overall_verdict,
+            resultCount: allResults.length,
+        });
+        return { results: allResults, overall_verdict, conflicts_detected: conflicts };
+    }
+    // ─── Public helpers (exposed for testing) ───
+    validateFileOwnership(group) {
+        const conflicts = [];
+        // file_ownership maps file path → [task_id, ...]
+        for (const [file, owners] of Object.entries(group.file_ownership)) {
+            if (owners.length > 1) {
+                conflicts.push(`File "${file}" is owned by multiple tasks: ${owners.join(", ")}`);
+            }
+        }
+        return conflicts;
+    }
+    buildExecutionOrder(group) {
+        const taskIds = group.subtasks.map((t) => t.id);
+        // Build adjacency: dependsOn[id] = set of ids that must complete first
+        const dependsOn = new Map();
+        for (const id of taskIds) {
+            dependsOn.set(id, new Set());
+        }
+        for (const dep of group.dependencies) {
+            // dep.from must complete before dep.to
+            dependsOn.get(dep.to)?.add(dep.from);
+        }
+        // Kahn's algorithm — produce waves
+        const waves = [];
+        const completed = new Set();
+        let remaining = new Set(taskIds);
+        while (remaining.size > 0) {
+            const wave = [...remaining].filter((id) => {
+                const deps = dependsOn.get(id) ?? new Set();
+                return [...deps].every((d) => completed.has(d));
+            });
+            if (wave.length === 0) {
+                // Cycle detected — include remaining tasks in one wave to avoid infinite loop
+                this.logger?.warn("[ParallelExecutor] Cycle detected in dependencies, forcing remaining tasks");
+                waves.push([...remaining]);
+                break;
+            }
+            waves.push(wave);
+            for (const id of wave) {
+                completed.add(id);
+                remaining.delete(id);
+            }
+        }
+        return waves;
+    }
+    // ─── Private helpers ───
+    async runWithSemaphore(tasks, limit) {
+        const results = new Array(tasks.length);
+        let nextIndex = 0;
+        async function runNext() {
+            while (nextIndex < tasks.length) {
+                const i = nextIndex++;
+                results[i] = await tasks[i]();
+            }
+        }
+        await Promise.all(Array.from({ length: Math.min(limit, tasks.length) }, () => runNext()));
+        return results;
+    }
+    async runSubtask(taskId, group, context) {
+        const subtask = group.subtasks.find((t) => t.id === taskId);
+        if (!subtask) {
+            return { task_id: taskId, verdict: "fail", output: "", error: "Subtask not found" };
+        }
+        // Check if this task has a pipeline attached (via task_category or other mechanism)
+        // For now, build a minimal AgentTask from the Task schema fields
+        const agentTask = {
+            prompt: subtask.work_description,
+            timeout_ms: subtask.estimated_duration
+                ? durationToMs(subtask.estimated_duration)
+                : 60_000,
+            adapter_type: "default",
+        };
+        // Build a simple single-stage pipeline for tasks without explicit pipeline config
+        const pipeline = {
+            stages: [{ role: "implementor" }],
+            fail_fast: false,
+            shared_context: group.shared_context,
+            strategy_id: context.strategy_id,
+        };
+        try {
+            const result = await this.pipelineExecutor.run(taskId, agentTask, pipeline, undefined);
+            const verdict = result.final_verdict;
+            const lastStage = result.stage_results[result.stage_results.length - 1];
+            this.logger?.info("[ParallelExecutor] Subtask complete", { taskId, verdict });
+            return {
+                task_id: taskId,
+                verdict,
+                output: lastStage?.output ?? "",
+            };
+        }
+        catch (err) {
+            const error = err instanceof Error ? err.message : String(err);
+            this.logger?.error("[ParallelExecutor] Subtask threw", { taskId, error });
+            return { task_id: taskId, verdict: "fail", output: "", error };
+        }
+    }
+    aggregateVerdict(results) {
+        if (results.length === 0)
+            return "fail";
+        const hasFailure = results.some((r) => r.verdict === "fail");
+        const hasPass = results.some((r) => r.verdict === "pass");
+        if (!hasFailure)
+            return "pass";
+        if (hasPass)
+            return "partial";
+        return "fail";
+    }
+}
+//# sourceMappingURL=parallel-executor.js.map

package/dist/orchestrator/execution/parallel-executor.js.map

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

package/dist/orchestrator/execution/pipeline-executor.d.ts

@@ -0,0 +1,55 @@
+import type { Logger } from "../../runtime/logger.js";
+import type { StateManager } from "../../base/state/state-manager.js";
+import type { AgentTask } from "./adapter-layer.js";
+import { AdapterRegistry } from "./adapter-layer.js";
+import type { TaskPipeline, PipelineState, StageResult } from "../../base/types/pipeline.js";
+import type { Verdict } from "../../base/types/core.js";
+export interface PlanApprovalResult {
+    approved: boolean;
+    plan: string;
+    modified_plan?: string;
+}
+export interface PipelineExecutorDeps {
+    stateManager: StateManager;
+    adapterRegistry: AdapterRegistry;
+    logger?: Logger;
+    /** Plan gate: called when plan_required=true and trust < HIGH_TRUST_THRESHOLD */
+    approvalFn?: (plan: string) => Promise<boolean>;
+    /** Strategy feedback: called at pipeline completion when strategy_id is set */
+    strategyFeedbackFn?: (strategyId: string, verdict: string) => void;
+    /** Escalation: find an alternative adapter for a domain, excluding a failed one */
+    findAlternativeAdapter?: (domain: string, excludeAdapter: string) => string | null;
+    /** Max retries per stage (default: 3) */
+    maxRetries?: number;
+}
+export interface PipelineRunResult {
+    pipeline_id: string;
+    final_verdict: Verdict;
+    stage_results: StageResult[];
+    status: PipelineState["status"];
+}
+type TaskPipelineExt = TaskPipeline & {
+    plan_required?: boolean;
+};
+export declare class PipelineExecutor {
+    private readonly stateManager;
+    private readonly adapterRegistry;
+    private readonly logger?;
+    private readonly approvalFn?;
+    private readonly strategyFeedbackFn?;
+    private readonly findAlternativeAdapter?;
+    private readonly maxRetries;
+    constructor(deps: PipelineExecutorDeps);
+    run(taskId: string, task: AgentTask, pipeline: TaskPipelineExt, observationContext?: string, trustScore?: number): Promise<PipelineRunResult>;
+    private runPlanApprovalGate;
+    private executeWithEscalation;
+    private executeAdapterWithCircuitBreaker;
+    private makeStageResult;
+    private selectAdapter;
+    private buildStagePrompt;
+    private persistState;
+    private restoreState;
+    private mapResultToVerdict;
+}
+export {};
+//# sourceMappingURL=pipeline-executor.d.ts.map

package/dist/orchestrator/execution/pipeline-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-executor.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/execution/pipeline-executor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAyB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAiB,aAAa,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE5G,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAIxD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,YAAY,CAAC;IAC3B,eAAe,EAAE,eAAe,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,+EAA+E;IAC/E,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnE,mFAAmF;IACnF,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACnF,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CACjC;AAED,KAAK,eAAe,GAAG,YAAY,GAAG;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAOlE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAqC;IACjE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAgD;IACpF,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAA4D;IACpG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,IAAI,EAAE,oBAAoB;IAUhC,GAAG,CACP,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,eAAe,EACzB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC;YAwFf,mBAAmB;YAyCnB,qBAAqB;YA4DrB,gCAAgC;IAkC9C,OAAO,CAAC,eAAe;IA0BvB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,gBAAgB;YA+BV,YAAY;YAIZ,YAAY;IAU1B,OAAO,CAAC,kBAAkB;CAK3B"}

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

@@ -0,0 +1,281 @@
+// ─── 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 "../../base/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 this.executeAdapterWithCircuitBreaker(adapter, planTask);
+            if (!result.success) {
+                this.logger?.warn("[PipelineExecutor] Plan generation failed", { error: result.error ?? "unknown failure" });
+                return { approved: false, plan: "" };
+            }
+            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;
+            result = await this.executeAdapterWithCircuitBreaker(currentAdapter, retryTask);
+            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 ───
+    async executeAdapterWithCircuitBreaker(adapter, task) {
+        if (!this.adapterRegistry.isAvailable(adapter.adapterType)) {
+            return {
+                success: false,
+                output: "",
+                error: `Adapter circuit breaker is open for "${adapter.adapterType}"`,
+                exit_code: null,
+                elapsed_ms: 0,
+                stopped_reason: "error",
+            };
+        }
+        let result;
+        try {
+            result = await adapter.execute(task);
+        }
+        catch (err) {
+            result = {
+                success: false,
+                output: "",
+                error: err instanceof Error ? err.message : String(err),
+                exit_code: null,
+                elapsed_ms: 0,
+                stopped_reason: "error",
+            };
+        }
+        if (result.success) {
+            this.adapterRegistry.recordSuccess(adapter.adapterType);
+        }
+        else {
+            this.adapterRegistry.recordFailure(adapter.adapterType);
+        }
+        return result;
+    }
+    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/orchestrator/execution/pipeline-executor.js.map

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

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

@@ -0,0 +1,24 @@
+import { type ReflectionNote } from "../../base/types/reflection.js";
+import type { ILLMClient } from "../../base/llm/llm-client.js";
+import type { Task } from "../../base/types/task.js";
+import type { VerificationResult } from "../../base/types/task.js";
+import type { KnowledgeManager } from "../../platform/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, logger?: ReflectionLogger): Promise<ReflectionNote[]>;
+export declare function formatReflectionsForPrompt(reflections: ReflectionNote[]): string;
+export {};
+//# sourceMappingURL=reflection-generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-generator.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/execution/reflection-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAC3F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AAGtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,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,EACT,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,cAAc,EAAE,CAAC,CAwB3B;AAID,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,MAAM,CAQhF"}