@petepetrash/circuit 0.1.0

package/dist/runtime/run/commit-containment.d.ts

@@ -0,0 +1,11 @@
+export interface CommitContainmentRunner {
+    begin(input: {
+        branchName: string;
+    }): void | Promise<void>;
+    commitIteration(input: {
+        iterationIndex: number;
+        message: string;
+    }): void | Promise<void>;
+}
+export declare function createGitCommitContainmentRunner(cwd: string): CommitContainmentRunner;
+//# sourceMappingURL=commit-containment.d.ts.map

package/dist/runtime/run/commit-containment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-containment.d.ts","sourceRoot":"","sources":["../../../src/runtime/run/commit-containment.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,uBAAuB;IAGtC,KAAK,CAAC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG3D,eAAe,CAAC,KAAK,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3F;AAKD,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,CA4BrF"}

package/dist/runtime/run/commit-containment.js

@@ -0,0 +1,46 @@
+// Per-iteration commit containment for the until loop (slice 7).
+//
+// An autonomous until loop re-enters its body many times, each pass mutating the
+// project's working tree in place. That is the highest-blast-radius part of the
+// whole feature: a bad pass leaves the operator's tree in a half-changed state
+// with no clean boundary between iterations. Containment moves the loop onto a
+// throwaway branch — each iteration becomes one commit, the operator's original
+// branch ref never moves, and the operator owns the merge at the end. Nothing is
+// ever merged or pushed by the engine.
+//
+// This is OPT-IN and DEFAULT OFF. The engine makes zero git calls unless a flow
+// declares `iterationCommitContainment` AND the host injects a runner. The git
+// runner is a factory closed over an explicit project root (never process.cwd(),
+// per the host-identity rule), so the engine never reaches for ambient cwd.
+import { spawnSync } from 'node:child_process';
+// A git-backed runner operating in an explicit working directory. Throws on any
+// git failure (the seam treats a containment failure as fatal: a loop asked to
+// contain its commits must not silently run uncontained).
+export function createGitCommitContainmentRunner(cwd) {
+    function git(args) {
+        const result = spawnSync('git', [...args], { cwd, encoding: 'utf8' });
+        if (result.status !== 0) {
+            throw new Error(`git ${args[0]} failed (exit ${result.status ?? 'null'}): ${(result.stderr ?? '').trim()}`);
+        }
+    }
+    return {
+        begin({ branchName }) {
+            // Switch onto a fresh throwaway branch rooted at the current HEAD, carrying
+            // the working tree along. The operator's original branch ref stays put, so
+            // they keep ownership of whether and how this work merges back.
+            git(['checkout', '-b', branchName]);
+        },
+        commitIteration({ iterationIndex, message }) {
+            git(['add', '-A']);
+            // --allow-empty keeps one commit per iteration even when a pass changed
+            // nothing on disk, so the branch history maps one-to-one to iterations.
+            git([
+                'commit',
+                '--allow-empty',
+                '-m',
+                `circuit until-loop iteration ${iterationIndex}: ${message}`,
+            ]);
+        },
+    };
+}
+//# sourceMappingURL=commit-containment.js.map

package/dist/runtime/run/commit-containment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-containment.js","sourceRoot":"","sources":["../../../src/runtime/run/commit-containment.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,iFAAiF;AACjF,gFAAgF;AAChF,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,iFAAiF;AACjF,uCAAuC;AACvC,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,iFAAiF;AACjF,4EAA4E;AAE5E,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAW/C,gFAAgF;AAChF,+EAA+E;AAC/E,0DAA0D;AAC1D,MAAM,UAAU,gCAAgC,CAAC,GAAW;IAC1D,SAAS,GAAG,CAAC,IAAuB;QAClC,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACtE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,OAAO,IAAI,CAAC,CAAC,CAAC,iBAAiB,MAAM,CAAC,MAAM,IAAI,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAC3F,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO;QACL,KAAK,CAAC,EAAE,UAAU,EAAE;YAClB,4EAA4E;YAC5E,2EAA2E;YAC3E,gEAAgE;YAChE,GAAG,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;QACtC,CAAC;QACD,eAAe,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE;YACzC,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;YACnB,wEAAwE;YACxE,wEAAwE;YACxE,GAAG,CAAC;gBACF,QAAQ;gBACR,eAAe;gBACf,IAAI;gBACJ,gCAAgC,cAAc,KAAK,OAAO,EAAE;aAC7D,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime/run/compiled-flow-runner.d.ts

@@ -0,0 +1,26 @@
+import type { Axes } from '../../schemas/axes.js';
+import { type CompiledFlow } from '../../schemas/compiled-flow.js';
+import type { RuntimeExecutionCapabilities } from './capabilities.js';
+import { type GraphExecutionResult } from './graph-runner.js';
+import type { GraphRunResult } from './run-close.js';
+export interface CompiledFlowRunOptions extends RuntimeExecutionCapabilities {
+    readonly flowBytes: Uint8Array;
+    readonly compiledFlowPath?: string;
+    readonly runDir: string;
+    readonly runId?: string;
+    readonly goal: string;
+    readonly why?: string;
+    readonly entryModeName?: string;
+    readonly depth?: string;
+    readonly axes?: Axes;
+    readonly unattended?: boolean;
+    readonly recursionDepth?: number;
+    readonly recursionAncestors?: ReadonlySet<string>;
+    readonly maxSteps?: number;
+    readonly reuseChildrenFrom?: string;
+    readonly enableContextDelivery?: boolean;
+}
+export declare function parseCompiledFlowBytes(bytes: Uint8Array): CompiledFlow;
+export declare function runCompiledFlowWithWaiting(options: CompiledFlowRunOptions): Promise<GraphExecutionResult>;
+export declare function runCompiledFlow(options: CompiledFlowRunOptions): Promise<GraphRunResult>;
+//# sourceMappingURL=compiled-flow-runner.d.ts.map

package/dist/runtime/run/compiled-flow-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiled-flow-runner.d.ts","sourceRoot":"","sources":["../../../src/runtime/run/compiled-flow-runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EACL,KAAK,YAAY,EAElB,MAAM,gCAAgC,CAAC;AAQxC,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AAItE,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,WAAW,sBAAuB,SAAQ,4BAA4B;IAC1E,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IAIrB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAM9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAI3B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAOpC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAC1C;AAcD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CAGtE;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAwG/B;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,cAAc,CAAC,CAQ9F"}

package/dist/runtime/run/compiled-flow-runner.js

@@ -0,0 +1,137 @@
+// Runtime entry adapter for compiled-flow bytes. Parse the saved or generated
+// manifest, choose the requested axis depth, then hand the normalized
+// executable graph to graph-runner.ts. Keep graph-runner.ts focused on step
+// advancement and trace writes.
+import { CompiledFlow as CompiledFlowSchema, } from '../../schemas/compiled-flow.js';
+import { computeManifestHash } from '../../schemas/manifest.js';
+import { projectWorkContractProjectionV0, runtimeWorkContractRefForProjectedRef, workContractProjectionPathForCompiledFlowPath, } from '../../shared/work-contract-projection.js';
+import { fromCompiledFlow } from '../manifest/from-compiled-flow.js';
+import { createContextDelivery } from './context-delivery.js';
+import { createContextPuller } from './context-pull.js';
+import { createEquipmentReshaper } from './equipment-reshape.js';
+import { executeExecutableFlowWithWaiting, isGraphCheckpointWaitingResult, } from './graph-runner.js';
+function depthForAxisSelectionName(entryModeName) {
+    if (entryModeName === 'low' || entryModeName === 'high')
+        return entryModeName;
+    if (entryModeName === 'tournament' || entryModeName === 'autonomous')
+        return entryModeName;
+    return undefined;
+}
+function defaultDepthForFlow(flow) {
+    if (flow.axes.default.autonomous)
+        return 'autonomous';
+    if (flow.axes.default.tournament)
+        return 'tournament';
+    return flow.axes.default.depth;
+}
+export function parseCompiledFlowBytes(bytes) {
+    const raw = JSON.parse(Buffer.from(bytes).toString('utf8'));
+    return CompiledFlowSchema.parse(raw);
+}
+export async function runCompiledFlowWithWaiting(options) {
+    const flow = parseCompiledFlowBytes(options.flowBytes);
+    const executable = fromCompiledFlow(flow);
+    const entryModeName = options.entryModeName ?? 'default';
+    const depth = options.depth ?? depthForAxisSelectionName(options.entryModeName) ?? defaultDepthForFlow(flow);
+    const contractRefPath = options.compiledFlowPath === undefined
+        ? undefined
+        : workContractProjectionPathForCompiledFlowPath(options.compiledFlowPath);
+    const workContractProjection = projectWorkContractProjectionV0({
+        flow,
+        ...(contractRefPath === undefined ? {} : { contractRefPath }),
+    });
+    const workContractRef = workContractProjection.contract_ref;
+    const tracedWorkContractRef = contractRefPath === undefined
+        ? runtimeWorkContractRefForProjectedRef(workContractRef)
+        : workContractRef;
+    return await executeExecutableFlowWithWaiting({
+        ...executable,
+        metadata: {
+            ...executable.metadata,
+            selected_entry_mode: entryModeName,
+            selected_depth: depth,
+        },
+    }, {
+        runDir: options.runDir,
+        ...(options.runId === undefined ? {} : { runId: options.runId }),
+        goal: options.goal,
+        ...(options.why === undefined ? {} : { why: options.why }),
+        manifestHash: computeManifestHash(options.flowBytes),
+        manifestBytes: options.flowBytes,
+        // Step 2 — the live equipment reshaper, built once per run from the parsed
+        // compiled flow. The runner calls it when a relay surfaces a confirmed
+        // discovery; it re-resolves equipment and returns a re-validated executable
+        // tail, keeping the compiled form and the per-run bound encapsulated here.
+        // Every compiled-flow run flows through this — the standard run path and
+        // each recovery attempt alike — and each builds its own reshaper, so the
+        // bound is correctly scoped per run. Callers that invoke executeExecutableFlow*
+        // directly (tests, internal helpers) leave this undefined, and the whole
+        // reshape stays inert there.
+        equipmentReshaper: createEquipmentReshaper(flow),
+        // The live context-pull channel — the typed-lookup sibling of the reshaper.
+        // Passed as a FACTORY: the seam builds a fresh puller per step that asks, so
+        // the query budget is per-step. The runner calls it when a relay surfaces a
+        // typed `context_request`, resolving each named parent slice and recording it
+        // in the trace. Callers that invoke executeExecutableFlow* directly leave this
+        // undefined, keeping the channel inert there.
+        contextPuller: createContextPuller,
+        // Pull-then-retry delivery (the value half of context-pull). Built once per
+        // run when the operator opts in, so the per-run delivery bound is correctly
+        // scoped here. Off by default: without it the channel only resolves and
+        // records, never re-runs a step.
+        ...(options.enableContextDelivery === true
+            ? { contextDelivery: createContextDelivery() }
+            : {}),
+        workContractRef: tracedWorkContractRef,
+        recoveryRouteBindings: workContractProjection.work_contract.recovery,
+        ...(options.reuseChildrenFrom === undefined
+            ? {}
+            : { reuseChildrenFrom: options.reuseChildrenFrom }),
+        entryModeName,
+        depth,
+        ...(options.axes === undefined ? {} : { axes: options.axes }),
+        ...(options.unattended === undefined ? {} : { unattended: options.unattended }),
+        ...(options.recursionDepth === undefined ? {} : { recursionDepth: options.recursionDepth }),
+        ...(options.recursionAncestors === undefined
+            ? {}
+            : { recursionAncestors: options.recursionAncestors }),
+        ...(options.now === undefined ? {} : { now: options.now }),
+        ...(options.executors === undefined ? {} : { executors: options.executors }),
+        ...(options.childExecutors === undefined ? {} : { childExecutors: options.childExecutors }),
+        ...(options.childCompiledFlowResolver === undefined
+            ? {}
+            : { childCompiledFlowResolver: options.childCompiledFlowResolver }),
+        childRunner: options.childRunner ?? runCompiledFlow,
+        ...(options.externalFiles === undefined ? {} : { externalFiles: options.externalFiles }),
+        ...(options.projectRoot === undefined ? {} : { projectRoot: options.projectRoot }),
+        ...(options.evidencePolicy === undefined ? {} : { evidencePolicy: options.evidencePolicy }),
+        ...(options.worktreeRunner === undefined ? {} : { worktreeRunner: options.worktreeRunner }),
+        ...(options.relayConnector === undefined ? {} : { relayConnector: options.relayConnector }),
+        ...(options.relayer === undefined ? {} : { relayer: options.relayer }),
+        ...(options.hostKind === undefined ? {} : { hostKind: options.hostKind }),
+        ...(options.selectionConfigLayers === undefined
+            ? {}
+            : { selectionConfigLayers: options.selectionConfigLayers }),
+        ...(options.policyLayers === undefined ? {} : { policyLayers: options.policyLayers }),
+        ...(options.progress === undefined ? {} : { progress: options.progress }),
+        ...(options.progressSurface === undefined
+            ? {}
+            : { progressSurface: options.progressSurface }),
+        ...(options.memoryInputs === undefined ? {} : { memoryInputs: options.memoryInputs }),
+        ...(options.historyRecallReport === undefined
+            ? {}
+            : { historyRecallReport: options.historyRecallReport }),
+        ...(options.historyRecallPrecision === undefined
+            ? {}
+            : { historyRecallPrecision: options.historyRecallPrecision }),
+        ...(options.maxSteps === undefined ? {} : { maxSteps: options.maxSteps }),
+    });
+}
+export async function runCompiledFlow(options) {
+    const result = await runCompiledFlowWithWaiting(options);
+    if (isGraphCheckpointWaitingResult(result)) {
+        throw new Error(`runtime run '${result.runId}' paused at checkpoint '${result.checkpoint.stepId}', which requires checkpoint-aware resume routing`);
+    }
+    return result;
+}
+//# sourceMappingURL=compiled-flow-runner.js.map

package/dist/runtime/run/compiled-flow-runner.js.map

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

package/dist/runtime/run/connector-planning.d.ts

@@ -0,0 +1,3 @@
+import { type PrototypeVariantConnectorPlanner } from '../../selection/connector-planning.js';
+export declare const runtimeConnectorPlanner: PrototypeVariantConnectorPlanner;
+//# sourceMappingURL=connector-planning.d.ts.map

package/dist/runtime/run/connector-planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-planning.d.ts","sourceRoot":"","sources":["../../../src/runtime/run/connector-planning.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,gCAAgC,EAEtC,MAAM,uCAAuC,CAAC;AAE/C,eAAO,MAAM,uBAAuB,EAAE,gCA6BrC,CAAC"}

package/dist/runtime/run/connector-planning.js

@@ -0,0 +1,29 @@
+import { assertConnectorSelectionCompatible, resolveConnectorForGuidanceInput, resolveConnectorReference, } from '../../connectors/resolver.js';
+import { resolvedPrototypeVariantSelection, } from '../../selection/connector-planning.js';
+export const runtimeConnectorPlanner = {
+    planPrototypeVariantConnector(input) {
+        const explicitConnector = input.variant.connector === undefined
+            ? undefined
+            : resolveConnectorReference({
+                ref: input.variant.connector,
+                ...(input.selectionConfigLayers === undefined
+                    ? {}
+                    : { configLayers: input.selectionConfigLayers }),
+            });
+        const relay = resolveConnectorForGuidanceInput({
+            flowId: 'prototype',
+            role: 'implementer',
+            ...(explicitConnector === undefined ? {} : { explicitConnector }),
+            ...(input.selectionConfigLayers === undefined
+                ? {}
+                : { configLayers: input.selectionConfigLayers }),
+        });
+        assertConnectorSelectionCompatible(relay.connectorName, resolvedPrototypeVariantSelection(input.variant.selection));
+        return {
+            variantId: input.variant.id,
+            connectorName: relay.connectorName,
+            resolvedFrom: relay.resolvedFrom,
+        };
+    },
+};
+//# sourceMappingURL=connector-planning.js.map

package/dist/runtime/run/connector-planning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-planning.js","sourceRoot":"","sources":["../../../src/runtime/run/connector-planning.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,iCAAiC,GAClC,MAAM,uCAAuC,CAAC;AAE/C,MAAM,CAAC,MAAM,uBAAuB,GAAqC;IACvE,6BAA6B,CAAC,KAAK;QACjC,MAAM,iBAAiB,GACrB,KAAK,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS;YACnC,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,yBAAyB,CAAC;gBACxB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS;gBAC5B,GAAG,CAAC,KAAK,CAAC,qBAAqB,KAAK,SAAS;oBAC3C,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,qBAAqB,EAAE,CAAC;aACnD,CAAC,CAAC;QACT,MAAM,KAAK,GAAG,gCAAgC,CAAC;YAC7C,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,aAAa;YACnB,GAAG,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC;YACjE,GAAG,CAAC,KAAK,CAAC,qBAAqB,KAAK,SAAS;gBAC3C,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,qBAAqB,EAAE,CAAC;SACnD,CAAC,CAAC;QACH,kCAAkC,CAChC,KAAK,CAAC,aAAa,EACnB,iCAAiC,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAC3D,CAAC;QACF,OAAO;YACL,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE;YAC3B,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,YAAY,EAAE,KAAK,CAAC,YAAY;SACjC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/runtime/run/context-delivery.d.ts

@@ -0,0 +1,24 @@
+import type { TraceEntry } from '../domain/trace.js';
+export type DeliveredContextSlice = {
+    readonly source: string;
+    readonly value: unknown;
+    readonly bytes: number;
+};
+export declare const CONTEXT_DELIVERY_BUDGET = 3;
+export type ContextDeliveryGuard = {
+    readonly claim: (stepId: string) => boolean;
+};
+export declare function createContextDelivery(): ContextDeliveryGuard;
+export declare function seedContextDeliveryFromTrace(entries: readonly TraceEntry[]): ContextDeliveryGuard;
+export type RetryEvaluation = {
+    readonly kind: 'errored';
+} | {
+    readonly kind: 'connector_failed';
+} | {
+    readonly kind: 'produced';
+};
+export declare function decideContextDeliveryOutcome(retry: RetryEvaluation): {
+    readonly keep: 'retry' | 'original';
+    readonly reason: string;
+};
+//# sourceMappingURL=context-delivery.d.ts.map

package/dist/runtime/run/context-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-delivery.d.ts","sourceRoot":"","sources":["../../../src/runtime/run/context-delivery.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKrD,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAOF,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,MAAM,MAAM,oBAAoB,GAAG;IAKjC,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;CAC7C,CAAC;AAEF,wBAAgB,qBAAqB,IAAI,oBAAoB,CAW5D;AAcD,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,oBAAoB,CAOjG;AAUD,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;CAAE,GACrC;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAYlC,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,eAAe,GAAG;IACpE,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAmBA"}

package/dist/runtime/run/context-delivery.js

@@ -0,0 +1,92 @@
+// Pull-then-retry context-delivery — the value half of the typed-lookup channel.
+//
+// On-demand context-pull resolves a running step's typed `context_request` against
+// a parent's report and records each answer. That is the resolve-and-record cut:
+// it never changes the run. Delivery is the next, bounded step — it FOLDS the
+// answered slices back into the starving step's envelope and RE-RUNS the step
+// ONCE on the enriched context, so a step that started thin and asked for more
+// actually gets to use what it pulled.
+//
+// This module owns the two pure pieces the seam in graph-runner needs: the per-run
+// BOUND (a step delivers at most once; a global cap bounds the total — the same
+// once-only discipline the equipment reshaper holds) and the keep-or-fall-back
+// DECISION. The orchestration — reading the starved result off the trace,
+// materializing the parent surface, re-running the executor — stays inline in the
+// runner like the reshape and resolve-and-record seams, because it needs the run's
+// trace, files, and step map. Keeping the bound and the decision here makes both
+// unit-testable without standing up a run.
+//
+// Inert by construction: the runner only builds a guard when the live path opts in
+// (`enableContextDelivery`); off the opt-in there is no guard, the resolve-and-
+// record seam runs instead, and a run is byte-identical to today.
+// The per-run delivery bound. A delivery loop must be bounded or a step could
+// re-run forever, so this caps deliveries two ways: a step delivers AT MOST ONCE
+// (the cycle guard), and a global counter bounds the total across the run. Both
+// live in the guard closure (created once per run), mirroring the equipment
+// reshaper's `{ remaining, touched }` bound.
+export const CONTEXT_DELIVERY_BUDGET = 3;
+export function createContextDelivery() {
+    const budget = { remaining: CONTEXT_DELIVERY_BUDGET, touched: new Set() };
+    return {
+        claim(stepId) {
+            if (budget.remaining <= 0)
+                return false;
+            if (budget.touched.has(stepId))
+                return false;
+            budget.remaining -= 1;
+            budget.touched.add(stepId);
+            return true;
+        },
+    };
+}
+// Re-thread the per-run delivery bound on resume. A crash can land mid-run after
+// a step already delivered, and the durable `run.context-delivery` trace entry
+// is the proof it did. The fresh guard a resumed run builds knows nothing of
+// that history, so without this it would let an already-delivered step deliver
+// again (double-spending its once-per-step claim) and ignore budget the run had
+// already spent. The mirror of `seedEquipmentReshapeFromTrace`: fold the trace
+// forward and re-claim each recorded delivery on a fresh guard. Each
+// `run.context-delivery` entry is written only after a `claim()` succeeded, so
+// re-claiming it reproduces exactly that spend — the per-step touched-set and
+// the global counter both land where the pre-crash guard left them. Skips every
+// other entry kind; an empty or delivery-free trace yields a guard identical to
+// a fresh `createContextDelivery()`.
+export function seedContextDeliveryFromTrace(entries) {
+    const guard = createContextDelivery();
+    for (const entry of entries) {
+        if (entry.kind !== 'run.context-delivery')
+            continue;
+        guard.claim(entry.step_id);
+    }
+    return guard;
+}
+// Keep the enriched retry, or fall back to the starved original?
+//
+// Fall back in exactly the two cases where the retry produced no usable result:
+// it errored, or its connector failed before writing anything. In both, the
+// starved result is still on disk untouched, so keeping the original is coherent
+// with zero restoration. Otherwise keep the retry — it is the live result on the
+// context the step asked for. Note this keeps a retry even when its check routes
+// to rework: an enriched attempt that still cannot pass is honest signal (the run
+// does MORE work, never less), and it can only route a starved pass to rework, never
+// launder a real failure into a false done.
+export function decideContextDeliveryOutcome(retry) {
+    switch (retry.kind) {
+        case 'errored':
+            return {
+                keep: 'original',
+                reason: 'the enriched retry errored before producing a result; kept the starved original',
+            };
+        case 'connector_failed':
+            return {
+                keep: 'original',
+                reason: 'the enriched retry connector-failed before producing a result; kept the starved original',
+            };
+        case 'produced':
+            return {
+                keep: 'retry',
+                reason: 'the enriched retry produced a result on the delivered context; kept the retry',
+            };
+    }
+}
+//# sourceMappingURL=context-delivery.js.map

package/dist/runtime/run/context-delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-delivery.js","sourceRoot":"","sources":["../../../src/runtime/run/context-delivery.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,EAAE;AACF,mFAAmF;AACnF,iFAAiF;AACjF,8EAA8E;AAC9E,8EAA8E;AAC9E,+EAA+E;AAC/E,uCAAuC;AACvC,EAAE;AACF,mFAAmF;AACnF,gFAAgF;AAChF,+EAA+E;AAC/E,0EAA0E;AAC1E,kFAAkF;AAClF,mFAAmF;AACnF,iFAAiF;AACjF,2CAA2C;AAC3C,EAAE;AACF,mFAAmF;AACnF,gFAAgF;AAChF,kEAAkE;AAalE,8EAA8E;AAC9E,iFAAiF;AACjF,gFAAgF;AAChF,4EAA4E;AAC5E,6CAA6C;AAC7C,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAUzC,MAAM,UAAU,qBAAqB;IACnC,MAAM,MAAM,GAAG,EAAE,SAAS,EAAE,uBAAuB,EAAE,OAAO,EAAE,IAAI,GAAG,EAAU,EAAE,CAAC;IAClF,OAAO;QACL,KAAK,CAAC,MAAc;YAClB,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC;gBAAE,OAAO,KAAK,CAAC;YACxC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAC;YAC7C,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;YACtB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,+EAA+E;AAC/E,6EAA6E;AAC7E,+EAA+E;AAC/E,gFAAgF;AAChF,+EAA+E;AAC/E,qEAAqE;AACrE,+EAA+E;AAC/E,8EAA8E;AAC9E,gFAAgF;AAChF,gFAAgF;AAChF,qCAAqC;AACrC,MAAM,UAAU,4BAA4B,CAAC,OAA8B;IACzE,MAAM,KAAK,GAAG,qBAAqB,EAAE,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB;YAAE,SAAS;QACpD,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAeD,iEAAiE;AACjE,EAAE;AACF,gFAAgF;AAChF,4EAA4E;AAC5E,iFAAiF;AACjF,iFAAiF;AACjF,iFAAiF;AACjF,kFAAkF;AAClF,qFAAqF;AACrF,4CAA4C;AAC5C,MAAM,UAAU,4BAA4B,CAAC,KAAsB;IAIjE,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO;gBACL,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,iFAAiF;aAC1F,CAAC;QACJ,KAAK,kBAAkB;YACrB,OAAO;gBACL,IAAI,EAAE,UAAU;gBAChB,MAAM,EACJ,0FAA0F;aAC7F,CAAC;QACJ,KAAK,UAAU;YACb,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE,+EAA+E;aACxF,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/runtime/run/context-pull.d.ts

@@ -0,0 +1,22 @@
+import { ContextRequest } from '../../schemas/context-request.js';
+import type { ContextQuery } from '../../schemas/context-request.js';
+export type { ContextQuery, ContextRequest };
+export declare const CONTEXT_PULL_BUDGET = 3;
+export type ContextPullSurface = ReadonlyMap<string, unknown>;
+export type ContextPullOutcome = {
+    readonly answered: true;
+    readonly value: unknown;
+    readonly bytes: number;
+    readonly source: string;
+} | {
+    readonly answered: false;
+    readonly finding: string;
+};
+export type ContextPuller = (input: {
+    readonly fromStepId: string;
+    readonly query: ContextQuery;
+    readonly surface: ContextPullSurface;
+}) => ContextPullOutcome;
+export declare function extractContextRequest(report: unknown): ContextRequest | undefined;
+export declare function createContextPuller(): ContextPuller;
+//# sourceMappingURL=context-pull.d.ts.map

package/dist/runtime/run/context-pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pull.d.ts","sourceRoot":"","sources":["../../../src/runtime/run/context-pull.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAErE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC;AAqB7C,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAWrC,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9D,MAAM,MAAM,kBAAkB,GAC1B;IACE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GACD;IAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;CACtC,KAAK,kBAAkB,CAAC;AAMzB,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAMjF;AA0CD,wBAAgB,mBAAmB,IAAI,aAAa,CAgDnD"}

package/dist/runtime/run/context-pull.js

@@ -0,0 +1,112 @@
+import { ContextRequest } from '../../schemas/context-request.js';
+// On-demand context-pull — the typed-lookup channel, runtime half.
+//
+// The validated sibling of equipment reshape. Where reshape injects equipment
+// into the remaining steps, context-pull lets a RUNNING step ask a parent for
+// one more named slice of context on demand, through a typed queryable surface.
+// This is the cheapest validated cut only: a typed lookup against a parent's
+// typed report. No retrieval, no semantic engine, no "everything" channel.
+//
+// Like the reshaper, this is a closure that owns a small budget and is fail-safe
+// by construction: every refusal, exhaustion, or unanswerable lookup becomes a
+// finding the caller records in the trace, and the step proceeds on the context
+// it already has. A run that never asks is byte-identical to today. The budget is
+// PER-STEP: the live seam builds a fresh puller for each step's batch of queries,
+// so one step pulling its fill never starves the next (the conservative default
+// in the design note). Independent steps hold independent budgets by construction.
+// Three covers every shipped flow's declared reads with one retry to spare
+// while keeping a runaway asker bounded; exhaustion degrades to proceed-as-is
+// and is recorded as a finding, so the cap is visible when it bites.
+export const CONTEXT_PULL_BUDGET = 3;
+// A field_path of '*' (or empty) is the "give me everything" smell. The typed
+// channel refuses it on sight and surfaces it as a finding — the operator sees a
+// step that wanted the whole parent instead of a named slice.
+const EVERYTHING_SENTINEL = '*';
+// Field-tolerant read of a `context_request` off a relay's result body. Mirrors
+// extractEquipmentDiscovery: the top-level key is optional, malformed payloads
+// safeParse to undefined, and a non-object body is simply "no request". A step
+// that emits nothing here is byte-identical to a step from before this channel.
+export function extractContextRequest(report) {
+    if (report === null || typeof report !== 'object')
+        return undefined;
+    const candidate = report.context_request;
+    if (candidate === undefined)
+        return undefined;
+    const parsed = ContextRequest.safeParse(candidate);
+    return parsed.success ? parsed.data : undefined;
+}
+function finding(message) {
+    return { answered: false, finding: message };
+}
+// Resolve a dotted field_path to ONE own field of the parent's typed report.
+// Deliberately NOT the shared resolveDottedPath: field_path is untrusted model
+// free text, and a bare `cursor[segment]` descent resolves prototype-chain keys
+// ('__proto__', 'constructor', 'toString', 'valueOf', 'hasOwnProperty', ...) that
+// name no report field — answering them would breach the typed-lookup rail. Each
+// segment must be an OWN property (every real field of a JSON-parsed report is);
+// a non-own key, a missing key, or a descent into a non-object/array throws, and
+// the caller parks the throw as a finding. A terminal array value is fine — only
+// descending THROUGH a non-object is refused.
+function resolveOwnFieldPath(root, path) {
+    let cursor = root;
+    for (const segment of path.split('.')) {
+        if (cursor === null || typeof cursor !== 'object' || Array.isArray(cursor)) {
+            throw new Error(`field_path '${path}' descended into a non-object at segment '${segment}'`);
+        }
+        if (!Object.hasOwn(cursor, segment)) {
+            throw new Error(`field_path '${path}' names no own field at segment '${segment}'`);
+        }
+        cursor = cursor[segment];
+    }
+    return cursor;
+}
+function byteSizeOf(value) {
+    try {
+        return JSON.stringify(value)?.length ?? 0;
+    }
+    catch {
+        return 0;
+    }
+}
+// Build one typed-lookup channel with its own budget. The seam calls this once
+// per step that asks, so the budget is per-step. The returned function resolves
+// one query at a time against the surface it is handed, spending budget only on
+// answered pulls. Refusals (everything-ask, exhausted budget, unknown parent,
+// unanswerable path) never throw and never draw the budget down.
+export function createContextPuller() {
+    const budget = { remaining: CONTEXT_PULL_BUDGET };
+    return ({ fromStepId, query, surface }) => {
+        const path = query.field_path.trim();
+        // 1. Refuse the untyped "everything" ask before anything else.
+        if (path === EVERYTHING_SENTINEL || path === '') {
+            return finding(`context pull from step '${fromStepId}' asked for "everything" (field_path '${query.field_path}'); refused — name one typed slice, or narrow the envelope`);
+        }
+        // 2. Bound by the per-run budget; exhaustion degrades to "proceed as-is".
+        if (budget.remaining <= 0) {
+            return finding(`context pull budget exhausted at step '${fromStepId}'; recorded as a finding, step proceeds on current context`);
+        }
+        // 3. The named parent must have a readable typed report on the surface.
+        if (!surface.has(query.from_step)) {
+            return finding(`context pull from step '${fromStepId}' named parent '${query.from_step}', which has no readable typed report; recorded as a finding`);
+        }
+        // 4. Resolve the one named own field; an unanswerable path is a finding, not a throw.
+        const root = surface.get(query.from_step);
+        let value;
+        try {
+            value = resolveOwnFieldPath(root, path);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return finding(`context pull '${query.from_step}.${path}' is unanswerable: ${message}; recorded as a finding`);
+        }
+        // Only a real answer spends the budget.
+        budget.remaining -= 1;
+        return {
+            answered: true,
+            value,
+            bytes: byteSizeOf(value),
+            source: `${query.from_step}.${path}`,
+        };
+    };
+}
+//# sourceMappingURL=context-pull.js.map

package/dist/runtime/run/context-pull.js.map

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

package/dist/runtime/run/engine-flags.d.ts

@@ -0,0 +1,7 @@
+import type { CompiledFlowEngineFlags } from '../../flows/types.js';
+import type { CompiledFlowManifestEngineFlags } from '../../schemas/compiled-flow.js';
+export declare function manifestEngineFlagsToInCode(manifest: CompiledFlowManifestEngineFlags | undefined): CompiledFlowEngineFlags | undefined;
+export declare function resolveEngineFlags(flow: {
+    readonly engineFlags?: CompiledFlowEngineFlags;
+}): CompiledFlowEngineFlags | undefined;
+//# sourceMappingURL=engine-flags.d.ts.map

package/dist/runtime/run/engine-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-flags.d.ts","sourceRoot":"","sources":["../../../src/runtime/run/engine-flags.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,uBAAuB,EAGxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AAwEtF,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,+BAA+B,GAAG,SAAS,GACpD,uBAAuB,GAAG,SAAS,CAmBrC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,uBAAuB,CAAC;CAChD,GAAG,uBAAuB,GAAG,SAAS,CAEtC"}