@nifrajs/coding-agent 3.2.0

package/dist/orchestration/recovery.d.ts.map

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

package/dist/orchestration/recovery.js

@@ -0,0 +1,197 @@
+/**
+ * Recovery state machine for at-least-once node dispatch.
+ *
+ * The machine treats every effect invocation as potentially side-effecting. A normal retry is
+ * allowed only for an explicit pre-effect rejection. Once an effect has been invoked, recovery
+ * requires a matching idempotency proof; without one it dead-letters the dispatch instead of
+ * guessing that a duplicate is safe. This is deliberately conservative and never claims exactly
+ * once delivery or hostile-code isolation.
+ */
+import { systemClock, } from "./dispatch.js";
+/** Disposable proof reference for tests and one-process local runs. */
+export class MemoryIdempotencyProofStore {
+    keys = new Set();
+    has(key) {
+        return this.keys.has(key);
+    }
+    record(key) {
+        this.keys.add(key);
+    }
+    keysSnapshot() {
+        return Object.freeze([...this.keys].sort());
+    }
+}
+/** Stable pre-effect failure; it may be retried with a new logical attempt. */
+export class EffectRejectedError extends Error {
+    code;
+    constructor(code = "effect_rejected") {
+        super("run effect was rejected before the side effect boundary");
+        this.name = "EffectRejectedError";
+        this.code = code;
+    }
+}
+/** Simulates worker loss at a named boundary; the lease is intentionally left unresolved. */
+export class RecoveryCrashError extends Error {
+    boundary;
+    constructor(boundary) {
+        super("worker stopped at a recovery boundary");
+        this.name = "RecoveryCrashError";
+        this.boundary = boundary;
+    }
+}
+const DEFAULT_LEASE_MS = 30_000;
+const DEFAULT_BACKOFF = (attempt) => Math.min(1_000 * Math.max(1, attempt), 60_000);
+function stableCode(error) {
+    if (error instanceof EffectRejectedError)
+        return error.code;
+    if (error instanceof RecoveryCrashError)
+        return `worker_${error.boundary.replaceAll("-", "_")}`;
+    return "effect_failed";
+}
+function isAbort(signal, error) {
+    return signal.aborted || (error instanceof DOMException && error.name === "AbortError");
+}
+/**
+ * Drives leases through safe checkpoints and terminal transitions. The caller owns the effect and
+ * any real idempotency ledger; this class stores only opaque proof keys in the reference adapter.
+ */
+export class RunRecoveryMachine {
+    store;
+    clock;
+    proofs;
+    leaseMs;
+    retryBackoff;
+    signal;
+    constructor(options) {
+        this.store = options.store;
+        this.clock = options.clock ?? systemClock;
+        this.proofs = options.proofStore ?? new MemoryIdempotencyProofStore();
+        this.leaseMs = options.leaseMs ?? DEFAULT_LEASE_MS;
+        this.retryBackoff = options.retryBackoff ?? DEFAULT_BACKOFF;
+        this.signal = options.signal ?? new AbortController().signal;
+        if (!Number.isFinite(this.leaseMs) || this.leaseMs <= 0)
+            throw new RangeError("recovery leaseMs must be positive");
+    }
+    /** Cancel all matching run dispatches; every late lease write then fails closed. */
+    async cancel(runId) {
+        return await this.store.cancel(runId, "cancelled");
+    }
+    /** Process one bounded lease batch. No payload is read or emitted by this coordinator. */
+    async process(effect, options = {}) {
+        const limit = options.limit ?? 1;
+        const leases = await this.store.lease(this.clock.now(), limit, this.leaseMs);
+        const summary = {
+            leased: leases.length,
+            completed: 0,
+            retried: 0,
+            deadLettered: 0,
+            cancelled: 0,
+        };
+        for (const lease of leases) {
+            const outcome = await this.processLease(lease, effect);
+            summary.completed += outcome === "completed" ? 1 : 0;
+            summary.retried += outcome === "retried" ? 1 : 0;
+            summary.deadLettered += outcome === "dead-lettered" ? 1 : 0;
+            summary.cancelled += outcome === "cancelled" ? 1 : 0;
+        }
+        return Object.freeze(summary);
+    }
+    async processLease(lease, effect) {
+        const signal = this.signal;
+        if (signal.aborted) {
+            await this.store.cancel(lease.dispatch.runId, "cancelled");
+            return "cancelled";
+        }
+        const inspection = await this.store.inspect(lease.dispatch.dispatchId);
+        const checkpoint = inspection?.checkpoint;
+        const proof = await this.proofs.has(lease.idempotencyKey);
+        if (proof || checkpoint?.boundary === "after-effect") {
+            if (!proof) {
+                await this.store.deadLetter(lease, "idempotency_required");
+                return "dead-lettered";
+            }
+            const completed = await this.store.complete(lease);
+            return completed.ok ? "completed" : "waiting";
+        }
+        const before = await this.storeCheckpoint(lease, "before-effect");
+        if (!before)
+            return "waiting";
+        if (signal.aborted) {
+            await this.store.cancel(lease.dispatch.runId, "cancelled");
+            return "cancelled";
+        }
+        let invoked = false;
+        try {
+            invoked = true;
+            const committed = await effect({
+                lease,
+                signal,
+                checkpoint: (boundary) => this.storeCheckpoint(lease, boundary),
+            });
+            if (committed.committed !== true) {
+                await this.store.deadLetter(lease, "idempotency_required");
+                return "dead-lettered";
+            }
+            await this.proofs.record(lease.idempotencyKey);
+            const after = await this.storeCheckpoint(lease, "after-effect");
+            if (!after)
+                return "waiting";
+            const completed = await this.store.complete(lease);
+            return completed.ok ? "completed" : "waiting";
+        }
+        catch (error) {
+            if (error instanceof RecoveryCrashError)
+                return "waiting";
+            if (isAbort(signal, error)) {
+                await this.store.cancel(lease.dispatch.runId, "cancelled");
+                return "cancelled";
+            }
+            const failure = stableCode(error);
+            if (invoked && !(error instanceof EffectRejectedError)) {
+                // The effect boundary was crossed, so a retry would be an unproven duplicate.
+                await this.store.deadLetter(lease, "idempotency_required");
+                return "dead-lettered";
+            }
+            if (lease.attempt >= lease.dispatch.maxAttempts) {
+                await this.store.deadLetter(lease, failure);
+                return "dead-lettered";
+            }
+            const delay = this.retryBackoff(lease.attempt);
+            if (!Number.isFinite(delay) || delay < 0)
+                throw new RangeError("recovery retry backoff is invalid");
+            const retried = await this.store.retry(lease, this.clock.now() + Math.min(delay, 86_400_000), failure);
+            return retried.ok ? "retried" : "waiting";
+        }
+    }
+    async storeCheckpoint(lease, boundary) {
+        const outcome = await this.store.checkpoint(lease, {
+            version: 1,
+            dispatchId: lease.dispatch.dispatchId,
+            runId: lease.dispatch.runId,
+            nodeId: lease.dispatch.nodeId,
+            attempt: lease.attempt,
+            generation: lease.generation,
+            boundary,
+            idempotencyKey: lease.idempotencyKey,
+            at: this.clock.now(),
+            scheduleToken: lease.scheduleToken,
+        });
+        return outcome.ok;
+    }
+}
+/** A small deterministic clock useful for recovery schedules and tests. */
+export class TestClock {
+    current;
+    constructor(start = 0) {
+        if (!Number.isSafeInteger(start) || start < 0)
+            throw new RangeError("test clock start is invalid");
+        this.current = start;
+    }
+    now = () => this.current;
+    advance(milliseconds) {
+        if (!Number.isSafeInteger(milliseconds) || milliseconds < 0)
+            throw new RangeError("test clock advance is invalid");
+        this.current += milliseconds;
+    }
+}
+//# sourceMappingURL=recovery.js.map

package/dist/orchestration/recovery.js.map

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

package/dist/orchestration/tracer.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The end-to-end tracer: compile a {@link RunPlan}, run it through the {@link WorkflowRunner}, and
+ * project each transition into content-free {@link RunEvidence}. Every emitted record is re-parsed
+ * through {@link parseRunEvidence}, so the tracer itself proves the stream carries no payload and
+ * stays under the size cap. The terminal digest is a deterministic hash of the evidence stream:
+ * identical plan + catalog + inputs yield an identical digest, which is the deterministic-eval anchor.
+ */
+import type { ArtifactPort, RunEvidence, RunPlan } from "@nifrajs/agent-protocol";
+import type { StepCatalog } from "./catalog.js";
+export interface RunTraceOptions {
+    /** Caller-supplied, so a trace is fully reproducible. No clock or randomness is read here. */
+    readonly runId: string;
+    readonly catalog: StepCatalog;
+    /** Defaults to {@link noopArtifactPort} (hash-and-discard). */
+    readonly artifactPort?: ArtifactPort;
+    readonly signal?: AbortSignal;
+    readonly maxSteps?: number;
+    readonly maxDepth?: number;
+}
+export interface RunTraceResult {
+    readonly ok: boolean;
+    readonly runId: string;
+    readonly planDigest: string;
+    readonly evidence: readonly RunEvidence[];
+    /** SHA-256 hex of the canonical evidence stream. Deterministic across identical runs. */
+    readonly terminalDigest: string;
+    readonly error?: string;
+}
+/** Run a plan and return its content-free evidence stream plus a deterministic terminal digest. */
+export declare function runTrace(source: RunPlan | unknown, options: RunTraceOptions): Promise<RunTraceResult>;
+//# sourceMappingURL=tracer.d.ts.map

package/dist/orchestration/tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../src/orchestration/tracer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,YAAY,EAGZ,WAAW,EAGX,OAAO,EACR,MAAM,yBAAyB,CAAA;AAIhC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAkB/C,MAAM,WAAW,eAAe;IAC9B,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAA;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;IACzC,yFAAyF;IACzF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,mGAAmG;AACnG,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,OAAO,GAAG,OAAO,EACzB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAiHzB"}

package/dist/orchestration/tracer.js

@@ -0,0 +1,141 @@
+/**
+ * The end-to-end tracer: compile a {@link RunPlan}, run it through the {@link WorkflowRunner}, and
+ * project each transition into content-free {@link RunEvidence}. Every emitted record is re-parsed
+ * through {@link parseRunEvidence}, so the tracer itself proves the stream carries no payload and
+ * stays under the size cap. The terminal digest is a deterministic hash of the evidence stream:
+ * identical plan + catalog + inputs yield an identical digest, which is the deterministic-eval anchor.
+ */
+import { parseRunEvidence, parseRunPlan, RUN_PLAN_VERSION } from "@nifrajs/agent-protocol";
+import { WorkflowRunner } from "../workflows.js";
+import { noopArtifactPort } from "./artifact-port.js";
+import { compileRunPlan, digestRunPlan } from "./compile.js";
+import { canonicalJson, sha256HexOf } from "./hash.js";
+/** A verify/approve node whose output is not a pass. Other kinds never gate. */
+function isGateRejection(kind, output) {
+    if (kind === "verify") {
+        if (output === true)
+            return false;
+        return !(typeof output === "object" &&
+            output !== null &&
+            output.ok === true);
+    }
+    if (kind === "approve")
+        return output !== true;
+    return false;
+}
+/** Run a plan and return its content-free evidence stream plus a deterministic terminal digest. */
+export async function runTrace(source, options) {
+    const plan = parseRunPlan(source);
+    const planDigest = await digestRunPlan(plan);
+    const artifactPort = options.artifactPort ?? noopArtifactPort();
+    const effectKeys = new Map();
+    const artifacts = new Map();
+    const idempotent = new Map();
+    const kindById = new Map();
+    const nodeIds = new Set();
+    const walk = (node) => {
+        nodeIds.add(node.id);
+        kindById.set(node.id, node.kind);
+        const step = "step" in node ? options.catalog.get(node.step) : undefined;
+        idempotent.set(node.id, step?.selectEffect !== undefined);
+        switch (node.kind) {
+            case "sequence":
+            case "parallel":
+                for (const child of node.children)
+                    walk(child);
+                break;
+            case "retry":
+                walk(node.child);
+                break;
+            case "branch":
+                walk(node.then);
+                if (node.otherwise !== undefined)
+                    walk(node.otherwise);
+                break;
+        }
+    };
+    for (const node of plan.nodes)
+        walk(node);
+    const step = compileRunPlan(plan, {
+        catalog: options.catalog,
+        planDigest,
+        artifactPort,
+        onNodeEffect: (nodeId, key) => effectKeys.set(nodeId, key),
+        collectArtifact: (nodeId, ref) => {
+            const list = artifacts.get(nodeId);
+            if (list === undefined)
+                artifacts.set(nodeId, [ref]);
+            else
+                list.push(ref);
+        },
+    });
+    const evidence = [];
+    let seq = 0;
+    const push = (record) => {
+        // Re-parse each record: proves it is content-free and within the size cap before it is kept.
+        evidence.push(parseRunEvidence(record));
+    };
+    const onEvent = (event) => {
+        if (!("id" in event) || !nodeIds.has(event.id))
+            return;
+        const base = {
+            version: RUN_PLAN_VERSION,
+            runId: options.runId,
+            planDigest,
+            nodeId: event.id,
+            seq: seq++,
+            idempotent: idempotent.get(event.id) ?? false,
+        };
+        if (event.type === "step.started") {
+            push({ ...base, status: "started" });
+            return;
+        }
+        if (event.type === "step.completed") {
+            const key = effectKeys.get(event.id);
+            const refs = artifacts.get(event.id);
+            // A verify/approve gate reports pass/fail through its output, then the kernel aborts the run on
+            // a non-pass. Project that as a failed record so the evidence reflects the gate's verdict.
+            if (isGateRejection(kindById.get(event.id), event.output)) {
+                push({
+                    ...base,
+                    status: "failed",
+                    errorCode: "GATE_REJECTED",
+                    ...(key !== undefined ? { effectKey: key.digest } : {}),
+                });
+                return;
+            }
+            push({
+                ...base,
+                status: "completed",
+                ...(key !== undefined ? { effectKey: key.digest } : {}),
+                ...(refs !== undefined && refs.length > 0 ? { artifacts: refs } : {}),
+            });
+            return;
+        }
+        if (event.type === "step.failed") {
+            const key = effectKeys.get(event.id);
+            push({
+                ...base,
+                status: "failed",
+                errorCode: "STEP_FAILED",
+                ...(key !== undefined ? { effectKey: key.digest } : {}),
+            });
+        }
+    };
+    const result = await new WorkflowRunner({
+        onEvent,
+        ...(options.signal !== undefined ? { signal: options.signal } : {}),
+        ...(options.maxSteps !== undefined ? { maxSteps: options.maxSteps } : {}),
+        ...(options.maxDepth !== undefined ? { maxDepth: options.maxDepth } : {}),
+    }).run(step);
+    const terminalDigest = await sha256HexOf(canonicalJson(evidence));
+    return {
+        ok: result.ok,
+        runId: options.runId,
+        planDigest,
+        evidence,
+        terminalDigest,
+        ...(result.error !== undefined ? { error: result.error } : {}),
+    };
+}
+//# sourceMappingURL=tracer.js.map

package/dist/orchestration/tracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.js","sourceRoot":"","sources":["../../src/orchestration/tracer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1F,OAAO,EAAsB,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAEtD,gFAAgF;AAChF,SAAS,eAAe,CAAC,IAA6B,EAAE,MAAe;IACrE,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,KAAK,CAAA;QACjC,OAAO,CAAC,CACN,OAAO,MAAM,KAAK,QAAQ;YAC1B,MAAM,KAAK,IAAI;YACd,MAA2B,CAAC,EAAE,KAAK,IAAI,CACzC,CAAA;IACH,CAAC;IACD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,MAAM,KAAK,IAAI,CAAA;IAC9C,OAAO,KAAK,CAAA;AACd,CAAC;AAuBD,mGAAmG;AACnG,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAyB,EACzB,OAAwB;IAExB,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;IACjC,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAA;IAC5C,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,gBAAgB,EAAE,CAAA;IAE/D,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyB,CAAA;IACnD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAA;IAClD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAmB,CAAA;IAC7C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAA;IAC/C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAA;IACjC,MAAM,IAAI,GAAG,CAAC,IAAa,EAAQ,EAAE;QACnC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACpB,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QAChC,MAAM,IAAI,GAAG,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACxE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,KAAK,SAAS,CAAC,CAAA;QACzD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,UAAU,CAAC;YAChB,KAAK,UAAU;gBACb,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ;oBAAE,IAAI,CAAC,KAAK,CAAC,CAAA;gBAC9C,MAAK;YACP,KAAK,OAAO;gBACV,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBAChB,MAAK;YACP,KAAK,QAAQ;gBACX,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACf,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;oBAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;gBACtD,MAAK;QACT,CAAC;IACH,CAAC,CAAA;IACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,CAAA;IAEzC,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE;QAChC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU;QACV,YAAY;QACZ,YAAY,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC;QAC1D,eAAe,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;YAC/B,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YAClC,IAAI,IAAI,KAAK,SAAS;gBAAE,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;;gBAC/C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACrB,CAAC;KACF,CAAC,CAAA;IAEF,MAAM,QAAQ,GAAkB,EAAE,CAAA;IAClC,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,MAAM,IAAI,GAAG,CAAC,MAAmB,EAAQ,EAAE;QACzC,6FAA6F;QAC7F,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAA;IACzC,CAAC,CAAA;IAED,MAAM,OAAO,GAAG,CAAC,KAAoB,EAAQ,EAAE;QAC7C,IAAI,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAAE,OAAM;QACtD,MAAM,IAAI,GAAG;YACX,OAAO,EAAE,gBAAgB;YACzB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,UAAU;YACV,MAAM,EAAE,KAAK,CAAC,EAAE;YAChB,GAAG,EAAE,GAAG,EAAE;YACV,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,KAAK;SACrC,CAAA;QACV,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAClC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;YACpC,OAAM;QACR,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACpC,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YACpC,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YACpC,gGAAgG;YAChG,2FAA2F;YAC3F,IAAI,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1D,IAAI,CAAC;oBACH,GAAG,IAAI;oBACP,MAAM,EAAE,QAAQ;oBAChB,SAAS,EAAE,eAAe;oBAC1B,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACxD,CAAC,CAAA;gBACF,OAAM;YACR,CAAC;YACD,IAAI,CAAC;gBACH,GAAG,IAAI;gBACP,MAAM,EAAE,WAAW;gBACnB,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvD,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtE,CAAC,CAAA;YACF,OAAM;QACR,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YACpC,IAAI,CAAC;gBACH,GAAG,IAAI;gBACP,MAAM,EAAE,QAAQ;gBAChB,SAAS,EAAE,aAAa;gBACxB,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxD,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,CAAA;IAED,MAAM,MAAM,GAAG,MAAM,IAAI,cAAc,CAAC;QACtC,OAAO;QACP,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1E,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAEZ,MAAM,cAAc,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAA;IACjE,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU;QACV,QAAQ;QACR,cAAc;QACd,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/D,CAAA;AACH,CAAC"}

package/dist/plans.d.ts

@@ -0,0 +1,35 @@
+import { type WorkflowEvent, type WorkflowResult, type WorkflowStep } from "./workflows.js";
+export interface PlanPhase {
+    readonly id: string;
+    readonly title: string;
+    readonly step: WorkflowStep;
+}
+export interface AgentPlan {
+    readonly id: string;
+    readonly goal: string;
+    readonly phases: readonly PlanPhase[];
+    readonly maxSteps?: number;
+    readonly maxDepth?: number;
+}
+export interface PlanEvent {
+    readonly type: "plan.started" | "plan.phase.started" | "plan.phase.completed" | "plan.completed" | "plan.failed";
+    readonly planId: string;
+    readonly phaseId?: string;
+    readonly message?: string;
+}
+export interface PlanRunnerOptions {
+    readonly signal?: AbortSignal;
+    readonly onEvent?: (event: PlanEvent | WorkflowEvent) => void | PromiseLike<void>;
+}
+export interface PlanResult extends WorkflowResult {
+    readonly planId: string;
+    readonly goal: string;
+}
+/** First-party plan mode built on the bounded workflow primitives; no model or UI dependency. */
+export declare class PlanRunner {
+    private readonly options;
+    constructor(options?: PlanRunnerOptions);
+    run(plan: AgentPlan): Promise<PlanResult>;
+    private emit;
+}
+//# sourceMappingURL=plans.d.ts.map

package/dist/plans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plans.d.ts","sourceRoot":"","sources":["../src/plans.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,cAAc,EAEnB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAA;AAEvB,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAA;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EACT,cAAc,GACd,oBAAoB,GACpB,sBAAsB,GACtB,gBAAgB,GAChB,aAAa,CAAA;IACjB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,aAAa,KAAK,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;CAClF;AAED,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,iGAAiG;AACjG,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;gBAE/B,OAAO,GAAE,iBAAsB;IAIrC,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;YAoCjC,IAAI;CAGnB"}

package/dist/plans.js

@@ -0,0 +1,63 @@
+import { WorkflowRunner, } from "./workflows.js";
+/** First-party plan mode built on the bounded workflow primitives; no model or UI dependency. */
+export class PlanRunner {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async run(plan) {
+        validatePlan(plan);
+        await this.emit({ type: "plan.started", planId: plan.id, message: plan.goal });
+        const workflow = new WorkflowRunner({
+            ...(this.options.signal === undefined ? {} : { signal: this.options.signal }),
+            ...(plan.maxSteps === undefined ? {} : { maxSteps: plan.maxSteps }),
+            ...(plan.maxDepth === undefined ? {} : { maxDepth: plan.maxDepth }),
+            onEvent: async (event) => this.options.onEvent?.(event),
+        });
+        const step = {
+            type: "sequence",
+            steps: plan.phases.map((phase) => ({
+                type: "task",
+                id: phase.id,
+                run: async (context) => {
+                    await this.emit({
+                        type: "plan.phase.started",
+                        planId: plan.id,
+                        phaseId: phase.id,
+                        message: phase.title,
+                    });
+                    const output = await context.run(phase.step);
+                    await this.emit({ type: "plan.phase.completed", planId: plan.id, phaseId: phase.id });
+                    return output;
+                },
+            })),
+        };
+        const result = await workflow.run(step);
+        await this.emit({
+            type: result.ok ? "plan.completed" : "plan.failed",
+            planId: plan.id,
+            ...(result.error === undefined ? {} : { message: result.error }),
+        });
+        return { ...result, planId: plan.id, goal: plan.goal };
+    }
+    async emit(event) {
+        await this.options.onEvent?.(event);
+    }
+}
+function validatePlan(plan) {
+    if (!/^[a-z][a-z0-9._:-]{0,63}$/.test(plan.id))
+        throw new TypeError("plan: id is invalid");
+    if (!plan.goal || plan.goal.length > 4_096)
+        throw new TypeError("plan: goal is empty or too long");
+    if (plan.phases.length === 0 || plan.phases.length > 128)
+        throw new RangeError("plan: phases must be between 1 and 128");
+    const ids = new Set();
+    for (const phase of plan.phases) {
+        if (!/^[a-z][a-z0-9._:-]{0,63}$/.test(phase.id) || !phase.title || phase.title.length > 256)
+            throw new TypeError(`plan: invalid phase ${phase.id}`);
+        if (ids.has(phase.id))
+            throw new TypeError(`plan: duplicate phase ${phase.id}`);
+        ids.add(phase.id);
+    }
+}
+//# sourceMappingURL=plans.js.map

package/dist/plans.js.map

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

package/dist/presets.d.ts

@@ -0,0 +1,10 @@
+import type { SubagentSpec } from "./subagents.js";
+export type AgentPresetName = "planner" | "implementer" | "test-fixer" | "reviewer" | "security-reviewer" | "final-verifier";
+export interface AgentPreset extends Omit<SubagentSpec, "id" | "prompt"> {
+    readonly name: AgentPresetName;
+    readonly summary: string;
+}
+export declare const AGENT_PRESETS: Readonly<Record<AgentPresetName, AgentPreset>>;
+export declare function getAgentPreset(name: AgentPresetName): AgentPreset;
+export declare function createPresetSpec(name: AgentPresetName, prompt: string, id?: string): SubagentSpec;
+//# sourceMappingURL=presets.d.ts.map

package/dist/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElD,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,aAAa,GACb,YAAY,GACZ,UAAU,GACV,mBAAmB,GACnB,gBAAgB,CAAA;AAEpB,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,QAAQ,CAAC;IACtE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAqDD,eAAO,MAAM,aAAa,gDAAU,CAAA;AAEpC,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAEjE;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,MAAM,EACd,EAAE,SAAuC,GACxC,YAAY,CAad"}

package/dist/presets.js

@@ -0,0 +1,70 @@
+const PRESETS = Object.freeze({
+    planner: {
+        name: "planner",
+        role: "planner",
+        summary: "Break a task into bounded, verifiable phases.",
+        capabilities: Object.freeze(["read"]),
+        maxDepth: 1,
+        timeoutMs: 120_000,
+    },
+    implementer: {
+        name: "implementer",
+        role: "implementer",
+        summary: "Apply a narrowly scoped implementation and report changed files.",
+        capabilities: Object.freeze(["read", "write", "process"]),
+        maxDepth: 1,
+        timeoutMs: 600_000,
+    },
+    "test-fixer": {
+        name: "test-fixer",
+        role: "test-fixer",
+        summary: "Reproduce and repair a failing test within the task boundary.",
+        capabilities: Object.freeze(["read", "write", "process"]),
+        maxDepth: 1,
+        timeoutMs: 600_000,
+    },
+    reviewer: {
+        name: "reviewer",
+        role: "reviewer",
+        summary: "Review a proposed change for correctness and regressions.",
+        capabilities: Object.freeze(["read", "process"]),
+        maxDepth: 1,
+        timeoutMs: 240_000,
+    },
+    "security-reviewer": {
+        name: "security-reviewer",
+        role: "security-reviewer",
+        summary: "Review capabilities, trust boundaries, secrets, and process execution.",
+        capabilities: Object.freeze(["read", "process"]),
+        maxDepth: 1,
+        timeoutMs: 240_000,
+    },
+    "final-verifier": {
+        name: "final-verifier",
+        role: "final-verifier",
+        summary: "Run the configured verification gates and return structured evidence.",
+        capabilities: Object.freeze(["read", "process"]),
+        maxDepth: 1,
+        timeoutMs: 300_000,
+    },
+});
+export const AGENT_PRESETS = PRESETS;
+export function getAgentPreset(name) {
+    return PRESETS[name];
+}
+export function createPresetSpec(name, prompt, id = `${name}-${Date.now().toString(36)}`) {
+    const preset = getAgentPreset(name);
+    if (!prompt || prompt.length > 16_384)
+        throw new TypeError("agent preset: prompt is empty or too long");
+    if (!/^[a-z][a-z0-9._:-]{0,63}$/.test(id))
+        throw new TypeError("agent preset: id is invalid");
+    return {
+        id,
+        role: preset.role,
+        prompt,
+        ...(preset.capabilities === undefined ? {} : { capabilities: preset.capabilities }),
+        ...(preset.maxDepth === undefined ? {} : { maxDepth: preset.maxDepth }),
+        ...(preset.timeoutMs === undefined ? {} : { timeoutMs: preset.timeoutMs }),
+    };
+}
+//# sourceMappingURL=presets.js.map

package/dist/presets.js.map

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

package/dist/process.d.ts

@@ -0,0 +1,6 @@
+export interface BoundedText {
+    readonly text: string;
+    readonly truncated: boolean;
+}
+export declare function readBoundedText(stream: ReadableStream<Uint8Array> | null | undefined | number, maxBytes: number): Promise<BoundedText>;
+//# sourceMappingURL=process.d.ts.map

package/dist/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../src/process.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAC9D,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,CAsCtB"}