pocket-agent 0.1.0

package/dist/quickStart.js

@@ -0,0 +1,77 @@
+/**
+ * One-call quick start: create an agent with default single-step plan and
+ * model-based executor. Get running in a few lines, then customize as needed.
+ */
+import { createAgentRunner } from "./runner/createAgentRunner.js";
+import { createLLMEvaluator } from "./adapters/createLLMEvaluator.js";
+import { createOpenAIModelAdapter } from "./adapters/models/openai.js";
+import { createAnthropicModelAdapter } from "./adapters/models/anthropic.js";
+import { createGeminiModelAdapter } from "./adapters/models/gemini.js";
+import { createOllamaModelAdapter } from "./adapters/models/ollama.js";
+import { createLmStudioModelAdapter } from "./adapters/models/lmstudio.js";
+import { createSingleStepPlanner } from "./defaults/singleStepPlanner.js";
+import { createLLMPlanner } from "./defaults/llmPlanner.js";
+import { createDefaultExecutor } from "./defaults/defaultExecutor.js";
+function resolveModel(provider, modelConfig = {}) {
+    switch (provider) {
+        case "openai":
+            return createOpenAIModelAdapter(modelConfig);
+        case "anthropic":
+            return createAnthropicModelAdapter(modelConfig);
+        case "gemini":
+            return createGeminiModelAdapter(modelConfig);
+        case "ollama":
+            return createOllamaModelAdapter(modelConfig);
+        case "lmstudio":
+            return createLmStudioModelAdapter(modelConfig);
+        default:
+            throw new Error(`Unknown provider: ${provider}`);
+    }
+}
+/**
+ * Create an agent runner with a single-step plan and model-based executor.
+ * No tools; just set your provider (and API key in env) and run.
+ *
+ * @example
+ * const runner = createQuickAgent({ provider: "openai" });
+ * const run = await runner.run({ goal: "What is 2+2? Explain briefly." });
+ * console.log(run.outputs?.answer);
+ */
+export function createQuickAgent(config) {
+    const { provider, modelConfig = {}, systemPrompt } = config;
+    const model = resolveModel(provider, modelConfig);
+    const evaluator = createLLMEvaluator(model);
+    const planner = createSingleStepPlanner();
+    const executor = createDefaultExecutor({ model, systemPrompt });
+    return createAgentRunner({
+        planner,
+        executor,
+        evaluator,
+        model,
+    });
+}
+/**
+ * Create an agent runner that works from a goal only: no steps defined by you.
+ * When useLLMPlanner is true, the LLM generates the plan (steps) from the goal;
+ * otherwise a single implicit step is used (same as createQuickAgent).
+ * No tools; uses default executor and evaluator.
+ *
+ * @example
+ * const runner = createGoalDrivenAgent({ provider: "openai", useLLMPlanner: true });
+ * const run = await runner.run({ goal: "Explain quantum computing in 3 steps." });
+ * console.log(run.plan.steps, run.outputs);
+ */
+export function createGoalDrivenAgent(config) {
+    const { provider, modelConfig = {}, systemPrompt, useLLMPlanner = false, llmPlannerOptions } = config;
+    const model = resolveModel(provider, modelConfig);
+    const evaluator = createLLMEvaluator(model);
+    const planner = useLLMPlanner ? createLLMPlanner(model, llmPlannerOptions ?? {}) : createSingleStepPlanner();
+    const executor = createDefaultExecutor({ model, systemPrompt });
+    return createAgentRunner({
+        planner,
+        executor,
+        evaluator,
+        model,
+    });
+}
+//# sourceMappingURL=quickStart.js.map

package/dist/quickStart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickStart.js","sourceRoot":"","sources":["../src/quickStart.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAMlE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAyBtE,SAAS,YAAY,CAAC,QAAsB,EAAE,cAAsB,EAAE;IACpE,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,wBAAwB,CAAC,WAAgC,CAAC,CAAC;QACpE,KAAK,WAAW;YACd,OAAO,2BAA2B,CAAC,WAAmC,CAAC,CAAC;QAC1E,KAAK,QAAQ;YACX,OAAO,wBAAwB,CAAC,WAAgC,CAAC,CAAC;QACpE,KAAK,QAAQ;YACX,OAAO,wBAAwB,CAAC,WAAgC,CAAC,CAAC;QACpE,KAAK,UAAU;YACb,OAAO,0BAA0B,CAAC,WAAkC,CAAC,CAAC;QACxE;YACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,EAAE,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IAC5D,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,uBAAuB,EAAE,CAAC;IAC1C,MAAM,QAAQ,GAAG,qBAAqB,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;IAChE,OAAO,iBAAiB,CAAC;QACvB,OAAO;QACP,QAAQ;QACR,SAAS;QACT,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAA6B;IACjE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,EAAE,EAAE,YAAY,EAAE,aAAa,GAAG,KAAK,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAC;IACtG,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,uBAAuB,EAAE,CAAC;IAC7G,MAAM,QAAQ,GAAG,qBAAqB,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;IAChE,OAAO,iBAAiB,CAAC;QACvB,OAAO;QACP,QAAQ;QACR,SAAS;QACT,KAAK;KACN,CAAC,CAAC;AACL,CAAC"}

package/dist/runner/AgentRunner.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Top-level orchestrator (spec §6.1, §7).
+ */
+import type { RunTaskInput, RunResult, RunOptions } from "../types/run.js";
+import type { Planner } from "../planner/Planner.js";
+import type { StepExecutor } from "../executor/StepExecutor.js";
+import type { StepEvaluator } from "../evaluator/StepEvaluator.js";
+import type { ToolAdapter } from "../types/tools.js";
+import type { ModelAdapter } from "../types/models.js";
+import { RunStateManager } from "./RunStateManager.js";
+import { EventBus } from "../events/EventBus.js";
+export interface AgentRunnerDeps {
+    planner: Planner;
+    executor: StepExecutor;
+    evaluator: StepEvaluator;
+    tools?: Record<string, ToolAdapter>;
+    model?: ModelAdapter;
+    defaultOptions?: Partial<RunOptions>;
+}
+export declare class AgentRunner {
+    private deps;
+    private stateManager;
+    private eventBus;
+    constructor(deps: AgentRunnerDeps, stateManager: RunStateManager, eventBus: EventBus);
+    start(input: RunTaskInput): import("./RunningExecution.js").RunningExecution;
+    run(input: RunTaskInput): Promise<RunResult>;
+    private runLoop;
+}
+//# sourceMappingURL=AgentRunner.d.ts.map

package/dist/runner/AgentRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRunner.d.ts","sourceRoot":"","sources":["../../src/runner/AgentRunner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AA2BjD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,aAAa,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;CACtC;AAED,qBAAa,WAAW;IAEpB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,QAAQ;gBAFR,IAAI,EAAE,eAAe,EACrB,YAAY,EAAE,eAAe,EAC7B,QAAQ,EAAE,QAAQ;IAG5B,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,uBAAuB,EAAE,gBAAgB;IAYtE,GAAG,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;YAIpC,OAAO;CAuMtB"}

package/dist/runner/AgentRunner.js

@@ -0,0 +1,223 @@
+/**
+ * Top-level orchestrator (spec §6.1, §7).
+ */
+import { DEFAULT_RUN_OPTIONS } from "../types/run.js";
+import { assertValidPlan } from "../planner/PlanValidator.js";
+import { getReadyStepIds } from "./StepScheduler.js";
+import { resolveInputs } from "./resolveInputs.js";
+import { nowISO } from "../utils/time.js";
+import { durationMs } from "../utils/time.js";
+import { RunFailureError } from "../types/errors.js";
+function mergeOptions(overrides) {
+    return { ...DEFAULT_RUN_OPTIONS, ...overrides };
+}
+function toRunResult(state) {
+    const completedAt = state.completedAt ?? nowISO();
+    const status = state.status === "completed" || state.status === "failed" || state.status === "partial"
+        ? state.status
+        : "failed";
+    return {
+        runId: state.runId,
+        status,
+        plan: state.currentPlan,
+        steps: { ...state.steps },
+        outputs: { ...state.outputs },
+        startedAt: state.startedAt,
+        completedAt,
+        durationMs: durationMs(state.startedAt, completedAt),
+    };
+}
+export class AgentRunner {
+    constructor(deps, stateManager, eventBus) {
+        this.deps = deps;
+        this.stateManager = stateManager;
+        this.eventBus = eventBus;
+    }
+    start(input) {
+        this.stateManager.createRun(input, input.options ?? this.deps.defaultOptions);
+        const runId = this.stateManager.getState().runId;
+        const result = this.runLoop(input, true);
+        return {
+            runId,
+            result,
+            on: (eventName, handler) => this.eventBus.on(eventName, handler),
+            getState: () => this.stateManager.getState(),
+        };
+    }
+    async run(input) {
+        return this.runLoop(input, false);
+    }
+    async runLoop(input, skipCreateRun) {
+        const options = mergeOptions(input.options ?? this.deps.defaultOptions);
+        const tools = this.deps.tools ?? {};
+        const context = input.context ?? {};
+        if (!skipCreateRun) {
+            this.stateManager.createRun(input, options);
+        }
+        const state = this.stateManager.getState();
+        this.eventBus.emit("run.started", { runId: state.runId });
+        // Planning
+        const plan = await this.deps.planner.createPlan({
+            goal: input.goal,
+            context: context,
+            constraints: input.constraints ?? [],
+            availableTools: Object.values(tools).map((t) => t.definition),
+            options,
+        });
+        assertValidPlan(plan);
+        this.stateManager.setPlan(plan);
+        this.eventBus.emit("plan.created", { runId: state.runId, plan });
+        this.stateManager.setRunStatus("running");
+        let planRevisions = 0;
+        const startTime = Date.now();
+        // Execution loop
+        while (true) {
+            const currentState = this.stateManager.getState();
+            if (currentState.status === "failed" || currentState.status === "completed" || currentState.status === "partial") {
+                break;
+            }
+            if (Date.now() - startTime > options.maxExecutionTimeMs) {
+                this.stateManager.setRunStatus("failed", nowISO());
+                this.eventBus.emit("run.failed", { runId: state.runId, error: new RunFailureError("maxExecutionTimeMs exceeded", state.runId) });
+                break;
+            }
+            const totalStepsExecuted = Object.values(currentState.steps).reduce((n, r) => n + r.attempts.length, 0);
+            if (totalStepsExecuted >= options.maxTotalSteps) {
+                this.stateManager.setRunStatus("failed", nowISO());
+                this.eventBus.emit("run.failed", { runId: state.runId, error: new RunFailureError("maxTotalSteps exceeded", state.runId) });
+                break;
+            }
+            const readyIds = getReadyStepIds(currentState.currentPlan, currentState.steps, options);
+            if (readyIds.length === 0) {
+                const allTerminal = currentState.currentPlan.steps.every((s) => {
+                    const r = currentState.steps[s.id];
+                    return r && (r.status === "completed" || r.status === "failed" || r.status === "blocked" || r.status === "skipped");
+                });
+                if (allTerminal) {
+                    const anyFailed = currentState.currentPlan.steps.some((s) => currentState.steps[s.id]?.status === "failed");
+                    this.stateManager.setRunStatus(anyFailed ? "failed" : "completed", nowISO());
+                    this.eventBus.emit(anyFailed ? "run.failed" : "run.completed", anyFailed ? { runId: state.runId, timestamp: nowISO() } : { runId: state.runId, outputs: currentState.outputs, timestamp: nowISO() });
+                }
+                else {
+                    this.stateManager.setRunStatus("partial", nowISO());
+                    this.eventBus.emit("run.failed", { runId: state.runId, timestamp: nowISO() });
+                }
+                break;
+            }
+            for (const stepId of readyIds) {
+                const stepRecord = this.stateManager.getStepRecord(stepId);
+                const step = stepRecord.step;
+                const attempt = stepRecord.attempts.length + 1;
+                if (attempt > options.maxStepAttempts) {
+                    this.stateManager.setStepStatus(stepId, "failed");
+                    this.eventBus.emit("step.failed", { runId: state.runId, stepId, attempt: attempt - 1, timestamp: nowISO() });
+                    if (options.stopOnStepFailure) {
+                        this.stateManager.setRunStatus("failed", nowISO());
+                        this.eventBus.emit("run.failed", { runId: state.runId, timestamp: nowISO() });
+                        return toRunResult(this.stateManager.getState());
+                    }
+                    continue;
+                }
+                this.stateManager.setStepStatus(stepId, attempt > 1 ? "retrying" : "running");
+                this.eventBus.emit("step.started", { runId: state.runId, stepId, attempt, timestamp: nowISO() });
+                if (attempt > 1) {
+                    this.eventBus.emit("step.retrying", { runId: state.runId, stepId, attempt, timestamp: nowISO() });
+                }
+                const resolvedInputs = resolveInputs(step.inputs, context, this.stateManager.getState().steps);
+                let attemptResult;
+                try {
+                    attemptResult = await this.deps.executor.execute({
+                        runId: state.runId,
+                        step,
+                        attempt,
+                        resolvedInputs,
+                        runContext: context,
+                        tools,
+                        model: this.deps.model,
+                        priorAttempts: stepRecord.attempts,
+                    });
+                }
+                catch (err) {
+                    attemptResult = {
+                        stepId,
+                        attempt,
+                        status: "error",
+                        error: { code: "EXECUTION_ERROR", message: String(err), details: err },
+                        startedAt: nowISO(),
+                        completedAt: nowISO(),
+                        durationMs: 0,
+                    };
+                }
+                this.stateManager.recordStepAttempt(stepId, attemptResult);
+                const evaluation = await this.deps.evaluator.evaluate({
+                    runId: state.runId,
+                    step,
+                    attemptResult,
+                    priorAttempts: stepRecord.attempts,
+                });
+                this.stateManager.setStepEvaluation(stepId, evaluation);
+                if (evaluation.verdict === "complete") {
+                    const output = attemptResult.structuredOutput ?? attemptResult.rawOutput ?? {};
+                    this.stateManager.setFinalOutput(stepId, output, attemptResult.artifacts);
+                    this.stateManager.setRunOutputs(output);
+                    this.eventBus.emit("step.completed", {
+                        runId: state.runId,
+                        stepId,
+                        attempt,
+                        outputs: output,
+                        timestamp: nowISO(),
+                    });
+                    continue;
+                }
+                if (evaluation.verdict === "retry") {
+                    if (attempt < step.retryPolicy.maxAttempts && attempt < options.maxStepAttempts) {
+                        this.stateManager.setStepStatus(stepId, "ready");
+                        break; // re-enter main loop to re-pick this step
+                    }
+                    this.stateManager.setStepStatus(stepId, "failed");
+                    this.eventBus.emit("step.failed", { runId: state.runId, stepId, attempt, error: evaluation.reasons, timestamp: nowISO() });
+                    if (options.stopOnStepFailure) {
+                        this.stateManager.setRunStatus("failed", nowISO());
+                        this.eventBus.emit("run.failed", { runId: state.runId, timestamp: nowISO() });
+                        return toRunResult(this.stateManager.getState());
+                    }
+                    continue;
+                }
+                if (evaluation.verdict === "needs_replan") {
+                    if (planRevisions >= options.maxPlanRevisions) {
+                        this.stateManager.setStepStatus(stepId, "failed");
+                        this.stateManager.setRunStatus("failed", nowISO());
+                        this.eventBus.emit("run.failed", { runId: state.runId, timestamp: nowISO() });
+                        return toRunResult(this.stateManager.getState());
+                    }
+                    const newPlan = await this.deps.planner.replan({
+                        runId: state.runId,
+                        goal: input.goal,
+                        context: context,
+                        constraints: input.constraints ?? [],
+                        currentPlan: this.stateManager.getState().currentPlan,
+                        failedStepId: stepId,
+                        availableTools: Object.values(tools).map((t) => t.definition),
+                        options,
+                    });
+                    assertValidPlan(newPlan);
+                    this.stateManager.appendPlanHistory(this.stateManager.getState().currentPlan);
+                    this.stateManager.setPlan(newPlan);
+                    planRevisions++;
+                    this.eventBus.emit("plan.revised", { runId: state.runId, plan: newPlan, timestamp: nowISO() });
+                    break; // re-enter loop to get new ready steps
+                }
+                // failed
+                this.stateManager.setStepStatus(stepId, "failed");
+                this.eventBus.emit("step.failed", { runId: state.runId, stepId, attempt, error: evaluation.reasons, timestamp: nowISO() });
+                if (options.stopOnStepFailure) {
+                    this.stateManager.setRunStatus("failed", nowISO());
+                    this.eventBus.emit("run.failed", { runId: state.runId, timestamp: nowISO() });
+                    return toRunResult(this.stateManager.getState());
+                }
+            }
+        }
+        return toRunResult(this.stateManager.getState());
+    }
+}
+//# sourceMappingURL=AgentRunner.js.map

package/dist/runner/AgentRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRunner.js","sourceRoot":"","sources":["../../src/runner/AgentRunner.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,SAAS,YAAY,CAAC,SAA+B;IACnD,OAAO,EAAE,GAAG,mBAAmB,EAAE,GAAG,SAAS,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,WAAW,CAAC,KAA8C;IACjE,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,MAAM,EAAE,CAAC;IAClD,MAAM,MAAM,GACV,KAAK,CAAC,MAAM,KAAK,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QACrF,CAAC,CAAC,KAAK,CAAC,MAAM;QACd,CAAC,CAAC,QAAQ,CAAC;IACf,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM;QACN,IAAI,EAAE,KAAK,CAAC,WAAW;QACvB,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE;QACzB,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE;QAC7B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,WAAW;QACX,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC;KACrD,CAAC;AACJ,CAAC;AAWD,MAAM,OAAO,WAAW;IACtB,YACU,IAAqB,EACrB,YAA6B,EAC7B,QAAkB;QAFlB,SAAI,GAAJ,IAAI,CAAiB;QACrB,iBAAY,GAAZ,YAAY,CAAiB;QAC7B,aAAQ,GAAR,QAAQ,CAAU;IACzB,CAAC;IAEJ,KAAK,CAAC,KAAmB;QACvB,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9E,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzC,OAAO;YACL,KAAK;YACL,MAAM;YACN,EAAE,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,OAAqE,CAAC;YAC9H,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE;SAC7C,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAAmB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,KAAmB,EAAE,aAAsB;QAC/D,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACxE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;QAEpC,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;QAC3C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAE1D,WAAW;QACX,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;YAC9C,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,OAAkC;YAC3C,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;YACpC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;YAC7D,OAAO;SACR,CAAC,CAAC;QACH,eAAe,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAEjE,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,iBAAiB;QACjB,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YAClD,IAAI,YAAY,CAAC,MAAM,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,KAAK,WAAW,IAAI,YAAY,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBACjH,MAAM;YACR,CAAC;YAED,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;gBACxD,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;gBACnD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,eAAe,CAAC,6BAA6B,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACjI,MAAM;YACR,CAAC;YAED,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,MAAM,CACjE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,EAC/B,CAAC,CACF,CAAC;YACF,IAAI,kBAAkB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;gBAChD,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;gBACnD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,eAAe,CAAC,wBAAwB,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAC5H,MAAM;YACR,CAAC;YAED,MAAM,QAAQ,GAAG,eAAe,CAAC,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACxF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,WAAW,GAAG,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;oBAC7D,MAAM,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;gBACtH,CAAC,CAAC,CAAC;gBACH,IAAI,WAAW,EAAE,CAAC;oBAChB,MAAM,SAAS,GAAG,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC;oBAC5G,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;oBAC7E,IAAI,CAAC,QAAQ,CAAC,IAAI,CAChB,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,eAAe,EAC1C,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CACrI,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;oBACpD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;gBAChF,CAAC;gBACD,MAAM;YACR,CAAC;YAED,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,MAAM,CAAE,CAAC;gBAC5D,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;gBAC7B,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;gBAE/C,IAAI,OAAO,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;oBACtC,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;oBAClD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;oBAC7G,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;wBAC9B,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;wBACnD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;wBAC9E,OAAO,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC;oBACnD,CAAC;oBACD,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;gBAC9E,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;gBACjG,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;oBAChB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;gBACpG,CAAC;gBAED,MAAM,cAAc,GAAG,aAAa,CAClC,IAAI,CAAC,MAAM,EACX,OAAkC,EAClC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,CACnC,CAAC;gBAEF,IAAI,aAAgC,CAAC;gBACrC,IAAI,CAAC;oBACH,aAAa,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;wBAC/C,KAAK,EAAE,KAAK,CAAC,KAAK;wBAClB,IAAI;wBACJ,OAAO;wBACP,cAAc;wBACd,UAAU,EAAE,OAAkC;wBAC9C,KAAK;wBACL,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;wBACtB,aAAa,EAAE,UAAU,CAAC,QAAQ;qBACnC,CAAC,CAAC;gBACL,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,aAAa,GAAG;wBACd,MAAM;wBACN,OAAO;wBACP,MAAM,EAAE,OAAO;wBACf,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE;wBACtE,SAAS,EAAE,MAAM,EAAE;wBACnB,WAAW,EAAE,MAAM,EAAE;wBACrB,UAAU,EAAE,CAAC;qBACd,CAAC;gBACJ,CAAC;gBAED,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;gBAE3D,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;oBACpD,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,IAAI;oBACJ,aAAa;oBACb,aAAa,EAAE,UAAU,CAAC,QAAQ;iBACnC,CAAC,CAAC;gBACH,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;gBAExD,IAAI,UAAU,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;oBACtC,MAAM,MAAM,GAAG,aAAa,CAAC,gBAAgB,IAAK,aAAa,CAAC,SAAqC,IAAI,EAAE,CAAC;oBAC5G,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;oBAC1E,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;oBACxC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE;wBACnC,KAAK,EAAE,KAAK,CAAC,KAAK;wBAClB,MAAM;wBACN,OAAO;wBACP,OAAO,EAAE,MAAM;wBACf,SAAS,EAAE,MAAM,EAAE;qBACpB,CAAC,CAAC;oBACH,SAAS;gBACX,CAAC;gBAED,IAAI,UAAU,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;oBACnC,IAAI,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,IAAI,OAAO,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;wBAChF,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;wBACjD,MAAM,CAAC,0CAA0C;oBACnD,CAAC;oBACD,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;oBAClD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;oBAC3H,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;wBAC9B,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;wBACnD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;wBAC9E,OAAO,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC;oBACnD,CAAC;oBACD,SAAS;gBACX,CAAC;gBAED,IAAI,UAAU,CAAC,OAAO,KAAK,cAAc,EAAE,CAAC;oBAC1C,IAAI,aAAa,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;wBAC9C,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;wBAClD,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;wBACnD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;wBAC9E,OAAO,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC;oBACnD,CAAC;oBACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;wBAC7C,KAAK,EAAE,KAAK,CAAC,KAAK;wBAClB,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,OAAO,EAAE,OAAkC;wBAC3C,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;wBACpC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,WAAW;wBACrD,YAAY,EAAE,MAAM;wBACpB,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;wBAC7D,OAAO;qBACR,CAAC,CAAC;oBACH,eAAe,CAAC,OAAO,CAAC,CAAC;oBACzB,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC;oBAC9E,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBACnC,aAAa,EAAE,CAAC;oBAChB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;oBAC/F,MAAM,CAAC,uCAAuC;gBAChD,CAAC;gBAED,SAAS;gBACT,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBAClD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;gBAC3H,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;oBAC9B,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;oBACnD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;oBAC9E,OAAO,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/runner/RunStateManager.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Run-scoped execution state (spec §15).
+ */
+import type { RunState, RunStatus, RunTaskInput, RunOptions } from "../types/run.js";
+import type { Plan } from "../types/plan.js";
+import type { StepRunRecord, StepStatus, StepAttemptResult, EvaluationResult, ArtifactRef } from "../types/step.js";
+export declare class RunStateManager {
+    private state;
+    createRun(task: RunTaskInput, options?: Partial<RunOptions>): RunState;
+    setPlan(plan: Plan): void;
+    appendPlanHistory(plan: Plan): void;
+    getStepRecord(stepId: string): StepRunRecord | undefined;
+    recordStepAttempt(stepId: string, attemptResult: StepAttemptResult): void;
+    setStepStatus(stepId: string, status: StepStatus): void;
+    setStepEvaluation(stepId: string, evaluation: EvaluationResult): void;
+    setFinalOutput(stepId: string, output: Record<string, unknown>, artifacts?: ArtifactRef[]): void;
+    setRunOutputs(outputs: Record<string, unknown>): void;
+    setRunStatus(status: RunStatus, completedAt?: string): void;
+    getState(): RunState;
+}
+//# sourceMappingURL=RunStateManager.d.ts.map

package/dist/runner/RunStateManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunStateManager.d.ts","sourceRoot":"","sources":["../../src/runner/RunStateManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AA2BpH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAY;IAEzB,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,QAAQ;IAkBtE,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAQzB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAInC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIxD,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,iBAAiB,GAAG,IAAI;IAOzE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAOvD,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAOrE,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,GAAG,IAAI;IAShG,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIrD,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAO3D,QAAQ,IAAI,QAAQ;CAGrB"}

package/dist/runner/RunStateManager.js

@@ -0,0 +1,96 @@
+/**
+ * Run-scoped execution state (spec §15).
+ */
+import { createRunId } from "../utils/ids.js";
+import { nowISO } from "../utils/time.js";
+import { DEFAULT_RUN_OPTIONS } from "../types/run.js";
+function mergeOptions(overrides) {
+    return { ...DEFAULT_RUN_OPTIONS, ...overrides };
+}
+function emptyPlan(goal) {
+    return {
+        id: "",
+        version: 0,
+        goal,
+        steps: [],
+        createdAt: nowISO(),
+    };
+}
+function createStepRecord(step) {
+    return {
+        step,
+        status: "pending",
+        attempts: [],
+    };
+}
+export class RunStateManager {
+    createRun(task, options) {
+        const runId = createRunId();
+        const opts = mergeOptions(task.options ?? options);
+        this.state = {
+            runId,
+            status: "planning",
+            task,
+            options: opts,
+            currentPlan: emptyPlan(task.goal),
+            planHistory: [],
+            steps: {},
+            outputs: {},
+            artifacts: {},
+            startedAt: nowISO(),
+        };
+        return this.state;
+    }
+    setPlan(plan) {
+        this.state.currentPlan = plan;
+        this.state.steps = {};
+        for (const s of plan.steps) {
+            this.state.steps[s.id] = createStepRecord(s);
+        }
+    }
+    appendPlanHistory(plan) {
+        this.state.planHistory.push(plan);
+    }
+    getStepRecord(stepId) {
+        return this.state.steps[stepId];
+    }
+    recordStepAttempt(stepId, attemptResult) {
+        const record = this.state.steps[stepId];
+        if (record) {
+            record.attempts.push(attemptResult);
+        }
+    }
+    setStepStatus(stepId, status) {
+        const record = this.state.steps[stepId];
+        if (record) {
+            record.status = status;
+        }
+    }
+    setStepEvaluation(stepId, evaluation) {
+        const record = this.state.steps[stepId];
+        if (record) {
+            record.latestEvaluation = evaluation;
+        }
+    }
+    setFinalOutput(stepId, output, artifacts) {
+        const record = this.state.steps[stepId];
+        if (record) {
+            record.finalOutput = output;
+            record.finalArtifacts = artifacts;
+            record.status = "completed";
+        }
+    }
+    setRunOutputs(outputs) {
+        this.state.outputs = { ...this.state.outputs, ...outputs };
+    }
+    setRunStatus(status, completedAt) {
+        this.state.status = status;
+        if (completedAt) {
+            this.state.completedAt = completedAt;
+        }
+    }
+    getState() {
+        return this.state;
+    }
+}
+//# sourceMappingURL=RunStateManager.js.map

package/dist/runner/RunStateManager.js.map

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

package/dist/runner/RunningExecution.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Event-driven execution handle (spec §23.3).
+ */
+import type { RunResult } from "../types/run.js";
+import type { RunState } from "../types/run.js";
+import type { EventName } from "../types/events.js";
+import type { AgentRunnerEvent } from "../types/events.js";
+export interface RunningExecution {
+    runId: string;
+    result: Promise<RunResult>;
+    on(eventName: EventName, handler: (event: AgentRunnerEvent) => void): void;
+    getState(): RunState;
+}
+//# sourceMappingURL=RunningExecution.d.ts.map

package/dist/runner/RunningExecution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunningExecution.d.ts","sourceRoot":"","sources":["../../src/runner/RunningExecution.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC3B,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3E,QAAQ,IAAI,QAAQ,CAAC;CACtB"}

package/dist/runner/RunningExecution.js

@@ -0,0 +1,5 @@
+/**
+ * Event-driven execution handle (spec §23.3).
+ */
+export {};
+//# sourceMappingURL=RunningExecution.js.map

package/dist/runner/RunningExecution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunningExecution.js","sourceRoot":"","sources":["../../src/runner/RunningExecution.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/runner/StepScheduler.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Determines which steps are ready to run (spec §6.1, §7.3, §20).
+ */
+import type { Plan } from "../types/plan.js";
+import type { StepRunRecord } from "../types/step.js";
+import type { RunOptions } from "../types/run.js";
+/**
+ * Returns step IDs that are ready: dependencies satisfied and status is pending/ready.
+ * Respects maxParallelSteps (v1: default 1 = sequential).
+ */
+export declare function getReadyStepIds(plan: Plan, stepRecords: Record<string, StepRunRecord>, options: RunOptions): string[];
+//# sourceMappingURL=StepScheduler.d.ts.map

package/dist/runner/StepScheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepScheduler.d.ts","sourceRoot":"","sources":["../../src/runner/StepScheduler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAKlD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAC1C,OAAO,EAAE,UAAU,GAClB,MAAM,EAAE,CA+BV"}

package/dist/runner/StepScheduler.js

@@ -0,0 +1,42 @@
+/**
+ * Determines which steps are ready to run (spec §6.1, §7.3, §20).
+ */
+const TERMINAL_STATUSES = new Set(["completed", "failed", "blocked", "skipped"]);
+const SCHEDULABLE_STATUSES = new Set(["pending", "ready"]);
+/**
+ * Returns step IDs that are ready: dependencies satisfied and status is pending/ready.
+ * Respects maxParallelSteps (v1: default 1 = sequential).
+ */
+export function getReadyStepIds(plan, stepRecords, options) {
+    const completedOrTerminal = new Set();
+    for (const [id, record] of Object.entries(stepRecords)) {
+        if (record.status === "completed" || record.status === "failed" || record.status === "blocked" || record.status === "skipped") {
+            completedOrTerminal.add(id);
+        }
+    }
+    const dependencySatisfied = new Set();
+    for (const step of plan.steps) {
+        const deps = step.dependencies ?? [];
+        const allDone = deps.every((d) => completedOrTerminal.has(d));
+        if (allDone) {
+            dependencySatisfied.add(step.id);
+        }
+    }
+    const ready = [];
+    for (const step of plan.steps) {
+        if (!dependencySatisfied.has(step.id))
+            continue;
+        const record = stepRecords[step.id];
+        const status = record?.status ?? "pending";
+        if (record?.status === "running" || record?.status === "retrying")
+            continue;
+        if (TERMINAL_STATUSES.has(status))
+            continue;
+        if (SCHEDULABLE_STATUSES.has(status)) {
+            ready.push(step.id);
+        }
+    }
+    const max = options.maxParallelSteps ?? 1;
+    return ready.slice(0, max);
+}
+//# sourceMappingURL=StepScheduler.js.map

package/dist/runner/StepScheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepScheduler.js","sourceRoot":"","sources":["../../src/runner/StepScheduler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAS,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AACzF,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;AAEnE;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAU,EACV,WAA0C,EAC1C,OAAmB;IAEnB,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9C,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACvD,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9H,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,IAAI,OAAO,EAAE,CAAC;YACZ,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,SAAS;QAChD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,SAAS,CAAC;QAC3C,IAAI,MAAM,EAAE,MAAM,KAAK,SAAS,IAAI,MAAM,EAAE,MAAM,KAAK,UAAU;YAAE,SAAS;QAC5E,IAAI,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,SAAS;QAC5C,IAAI,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,gBAAgB,IAAI,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC7B,CAAC"}

package/dist/runner/createAgentRunner.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Factory for AgentRunner (spec §23.1).
+ */
+import type { Planner } from "../planner/Planner.js";
+import type { StepExecutor } from "../executor/StepExecutor.js";
+import type { StepEvaluator } from "../evaluator/StepEvaluator.js";
+import type { ToolAdapter } from "../types/tools.js";
+import type { ModelAdapter } from "../types/models.js";
+import type { RunOptions } from "../types/run.js";
+import { AgentRunner } from "./AgentRunner.js";
+import type { OpenAIModelConfig } from "../adapters/models/openai.js";
+import type { AnthropicModelConfig } from "../adapters/models/anthropic.js";
+import type { GeminiModelConfig } from "../adapters/models/gemini.js";
+import type { OllamaModelConfig } from "../adapters/models/ollama.js";
+import type { LmStudioModelConfig } from "../adapters/models/lmstudio.js";
+export type ProviderName = "openai" | "anthropic" | "gemini" | "ollama" | "lmstudio";
+export interface AgentRunnerConfig {
+    planner: Planner;
+    executor: StepExecutor;
+    /** Required when provider is not set. When provider is set, a default LLM evaluator is used. */
+    evaluator?: StepEvaluator;
+    tools?: Record<string, ToolAdapter>;
+    model?: ModelAdapter;
+    defaultOptions?: Partial<RunOptions>;
+    /** When set, model and evaluator are created from env/modelConfig; install the matching SDK (openai for openai/ollama/lmstudio). */
+    provider?: ProviderName;
+    /** Override env-based config for the chosen provider. */
+    modelConfig?: OpenAIModelConfig | AnthropicModelConfig | GeminiModelConfig | OllamaModelConfig | LmStudioModelConfig;
+}
+export declare function createAgentRunner(config: AgentRunnerConfig): AgentRunner;
+export type { AgentRunner };
+//# sourceMappingURL=createAgentRunner.d.ts.map

package/dist/runner/createAgentRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAgentRunner.d.ts","sourceRoot":"","sources":["../../src/runner/createAgentRunner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAS/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAErF,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,YAAY,CAAC;IACvB,gGAAgG;IAChG,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,oIAAoI;IACpI,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,yDAAyD;IACzD,WAAW,CAAC,EACR,iBAAiB,GACjB,oBAAoB,GACpB,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,CAAC;CACzB;AAuCD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAgBxE;AAED,YAAY,EAAE,WAAW,EAAE,CAAC"}