taskflow-core 0.1.8 → 0.2.0

package/dist/flowir/schema.d.ts

@@ -0,0 +1,260 @@
+/**
+ * # Canonical FlowIR type contract
+ *
+ * This module formalizes the **canonical FlowIR** (Flow Intermediate
+ * Representation) type contract for the overstory-convergence roadmap. It is a
+ * **superset** of the implicit shape that `./translate.ts` already produces
+ * (mirrored structurally in `./meta.ts`): every `FlowIR`/`FlowIRNode` emitted
+ * by `translateTaskflow` satisfies the types defined here, and these types add
+ * the missing formalization — a closed `FlowIRNodeKind` literal union, an
+ * explicit `FlowIREdge` model, structural `FlowIRBudget`/`FlowIRMeta`, and
+ * optional lightweight TypeBox guards.
+ *
+ * **Provenance & ownership (Q2=B, Q5=own):** this is pi-taskflow's *own* type
+ * contract — not vendored from overstory. `flowir/compile.ts` (batch 2 of the
+ * roadmap) will emit this canonical shape; the event-sourced kernel executes
+ * it. `translate.ts`'s 1:1 projection is a *read-only stub* that already
+ * conforms to this contract today, so formalizing here is purely additive —
+ * it must not break `translate.ts`, `meta.ts`, `hash.ts`, or any barrel.
+ *
+ * **Compatibility note:** the canonical `FlowIRNode.kind` is the closed
+ * `FlowIRNodeKind` literal union (the closed set of native phase kinds = `PHASE_TYPES`), whereas
+ * `meta.ts`'s `FlowIRNode.kind` is `string` (a 1:1 projection). Every value
+ * `translate.ts` produces for `kind` (`phase.type ?? "agent"`) is a member of
+ * `FlowIRNodeKind`, so the canonical type is a strict refinement that
+ * subsumes the stub output. Code that needs the looser projection can keep
+ * using `meta.ts`; code that wants the closed contract imports from here.
+ *
+ * **Purity:** zero runtime deps beyond `typebox`. No IO, no Date, no
+ * randomness. Guards are pure functions over plain JSON values.
+ *
+ * @see docs/internal/overstory-convergence-roadmap.md §3 (M1), §6 (compile seam)
+ * @see docs/internal/rfc-flowir-compilation.md
+ */
+import { Type } from "typebox";
+import { type PhaseType } from "../schema.ts";
+/**
+ * The closed set of pi-taskflow phase kinds, derived 1:1 from the exported
+ * {@link PHASE_TYPES} in `../schema.ts` (single source of truth). This is the
+ * canonical `FlowIRNode.kind` vocabulary. `translate.ts` sets
+ * `kind = phase.type ?? "agent"`, so every node it emits is a member of this
+ * union. Adding a phase kind requires updating `PHASE_TYPES` only — FlowIR
+ * follows automatically.
+ *
+ * | kind        | purpose                                                  |
+ * |-------------|----------------------------------------------------------|
+ * | `agent`     | single subagent call                                     |
+ * | `parallel`  | static concurrent branches                               |
+ * | `map`       | dynamic fan-out over an array (one subagent per item)   |
+ * | `gate`      | quality gate — can halt the flow on VERDICT: BLOCK      |
+ * | `reduce`    | aggregate multiple upstream outputs into one            |
+ * | `approval`  | human-in-the-loop pause (approve/reject/edit)           |
+ * | `flow`      | run a saved sub-taskflow as a single phase              |
+ * | `loop`      | repeat body until condition, convergence, or max iters  |
+ * | `tournament`| N competing variants + judge picks best / aggregates    |
+ * | `script`    | run a shell command (no LLM, zero tokens)               |
+ */
+export declare const FlowIRNodeKind: Type.TUnsafe<"agent" | "approval" | "expand" | "flow" | "gate" | "loop" | "map" | "parallel" | "race" | "reduce" | "script" | "tournament">;
+/** @see PHASE_TYPES — same closed set as the DSL. */
+export type FlowIRNodeKind = PhaseType;
+/**
+ * A single canonical FlowIR node — one per pi-taskflow phase.
+ *
+ * This is a **superset** of the node shape `translate.ts` emits. The stub
+ * attaches exactly `{ id, kind, inject, emits, when? }`; this contract
+ * additionally formalizes the optional fields a genuine compiler (batch 2,
+ * `flowir/compile.ts`) and the event-sourced kernel will populate:
+ *
+ * - `task`     — the resolved (interpolated) task prompt, when materialized.
+ * - `condRef`  — a reference to a compiled condition descriptor (the lowered
+ *                form of `when`; see `flowir/cond.ts`). Absent on the stub,
+ *                which passes `when` through verbatim.
+ * - `deps`     — explicit `dependsOn` edges carried onto the node (the stub
+ *                folds these into `inject`; a compiler may keep them
+ *                separate for the edge model).
+ * - `join`     — join mode (`"all"` default, or `"any"` for OR-join).
+ * - `timeout`  — per-call ms cap (agent-running phases).
+ * - `payload`  — stable, hash-addressed DSL payload fields not otherwise
+ *                represented above (for example branch bodies, script command,
+ *                map source, flow/expand definitions, output contracts).
+ *
+ * All added fields are **optional** so the stub's minimal output remains valid.
+ */
+export interface FlowIRNode {
+    /** Unique phase identifier (referenced via `{steps.<id>.output}`). */
+    id: string;
+    /** The native phase kind — a member of {@link FlowIRNodeKind}. */
+    kind: FlowIRNodeKind;
+    /**
+     * Synthesized declared reads: the upstream step ids whose outputs this
+     * node injects. In the stub this is `{steps.X}` refs ∪ `dependsOn`
+     * (minus self); a genuine compiler lowers this to overstory's inject
+     * model.
+     */
+    inject: string[];
+    /** What this node emits — currently `[id]` (1:1 projection). */
+    emits: string[];
+    /** Raw `when` guard passthrough (stub: not rewritten to IR conditions). */
+    when?: string;
+    /** Resolved (interpolated) task prompt, when materialized by a compiler. */
+    task?: string;
+    /** Reference to a compiled condition descriptor (lowered `when`). */
+    condRef?: string;
+    /** Explicit `dependsOn` edges carried onto the node (optional). */
+    deps?: string[];
+    /** Join mode: `"all"` (default AND-join) or `"any"` (OR-join). */
+    join?: "all" | "any";
+    /** Per-subagent-call ms cap (agent-running phases). */
+    timeout?: number;
+    /** Runtime-affecting DSL payload not otherwise modeled by the core node fields. */
+    payload?: Record<string, unknown>;
+}
+/**
+ * A directed edge in the FlowIR DAG. `from` is the upstream (producer) node
+ * id; `to` is the downstream (consumer) node id. The stub projection encodes
+ * edges implicitly via `FlowIRNode.inject` (and `dependsOn`); a genuine
+ * compiler may emit an explicit `edges` list for graph consumers (renderers,
+ * topo sorters). When present, `edges` must be consistent with `inject`.
+ */
+export interface FlowIREdge {
+    /** Upstream (producer) node id. */
+    from: string;
+    /** Downstream (consumer) node id. */
+    to: string;
+}
+/**
+ * Run-wide observed-usage stop-loss. Once reported usage exceeds it, no new
+ * model call is admitted and remaining phases are skipped; a call already in
+ * flight may overshoot the threshold. Ordinary budgeted DAG layers and
+ * map/parallel/tournament fan-out use serial admission, limiting new-call
+ * overshoot to one call. A `race` necessarily admits competing branches
+ * together, so all already-active race branches may contribute overshoot.
+ * Structurally identical to the DSL `Budget` (schema.ts); mirrored
+ * here so the FlowIR contract is self-contained and doesn't leak DSL types to
+ * pure IR consumers (the event-sourced kernel).
+ */
+export interface FlowIRBudget {
+    /** Stop admitting calls once observed accumulated cost exceeds this many USD. */
+    maxUSD?: number;
+    /** Stop admitting calls once observed accumulated input+output tokens exceed this. */
+    maxTokens?: number;
+}
+/**
+ * Optional flow-level metadata attached to a compiled FlowIR. Populated by a
+ * genuine compiler; absent on the stub (which carries metadata in
+ * `TaskflowIRMeta`, not on the IR itself). Kept loose (`Record<string,
+ * unknown>`) so the contract is forward-compatible without churn.
+ */
+export interface FlowIRMeta {
+    /** Origin tool/host (e.g. `"pi"`, `"codex"`). */
+    source?: string;
+    /** Schema version of the IR emitter. */
+    irVersion?: number;
+    /** Free-form compiler diagnostics / annotations. */
+    annotations?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * The canonical compiled FlowIR. A **superset** of `meta.ts`'s `FlowIR`:
+ * - `version` is formalized (maps to the DSL `Taskflow.version`).
+ * - `edges` is the optional explicit edge model (absent on the stub).
+ * - `meta` is the optional flow-level metadata (absent on the stub).
+ *
+ * Every `FlowIR` produced by `translateTaskflow` — `{ name, nodes, args?,
+ * budget?, concurrency? }` — satisfies this contract (the added fields are all
+ * optional). `compile.ts` (batch 2) emits the full canonical form.
+ */
+export interface FlowIR {
+    /** Workflow name (the DSL `Taskflow.name`). */
+    name: string;
+    /** DSL schema version (maps to `Taskflow.version`, default 1). */
+    version?: number;
+    /** The flat list of IR nodes (one per phase). */
+    nodes: FlowIRNode[];
+    /** Optional explicit edge list (consistent with `inject`). */
+    edges?: FlowIREdge[];
+    /** Declared invocation arguments (DSL `Taskflow.args`). */
+    args?: Record<string, unknown>;
+    /** Run-wide observed-usage stop-loss; an in-flight call may overshoot. */
+    budget?: FlowIRBudget;
+    /** Default max concurrent subagents. */
+    concurrency?: number;
+    /** Optional flow-level metadata (compiler-populated). */
+    meta?: FlowIRMeta;
+}
+/**
+ * TypeBox schema mirroring {@link FlowIRNode}. Used by the structural guards
+ * below. Kept in sync by construction (the `Static` of this schema *is*
+ * `FlowIRNode`); if the interface above drifts, this schema must be updated to
+ * match.
+ */
+export declare const FlowIRNodeSchema: Type.TObject<{
+    id: Type.TString;
+    kind: Type.TUnsafe<"agent" | "approval" | "expand" | "flow" | "gate" | "loop" | "map" | "parallel" | "race" | "reduce" | "script" | "tournament">;
+    inject: Type.TArray<Type.TString>;
+    emits: Type.TArray<Type.TString>;
+    when: Type.TOptional<Type.TString>;
+    task: Type.TOptional<Type.TString>;
+    condRef: Type.TOptional<Type.TString>;
+    deps: Type.TOptional<Type.TArray<Type.TString>>;
+    join: Type.TOptional<Type.TUnion<[Type.TLiteral<"all">, Type.TLiteral<"any">]>>;
+    timeout: Type.TOptional<Type.TNumber>;
+    payload: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+}>;
+/**
+ * TypeBox schema mirroring {@link FlowIREdge}.
+ */
+export declare const FlowIREdgeSchema: Type.TObject<{
+    from: Type.TString;
+    to: Type.TString;
+}>;
+/**
+ * TypeBox schema mirroring {@link FlowIR}.
+ */
+export declare const FlowIRSchema: Type.TObject<{
+    name: Type.TString;
+    version: Type.TOptional<Type.TNumber>;
+    nodes: Type.TArray<Type.TObject<{
+        id: Type.TString;
+        kind: Type.TUnsafe<"agent" | "approval" | "expand" | "flow" | "gate" | "loop" | "map" | "parallel" | "race" | "reduce" | "script" | "tournament">;
+        inject: Type.TArray<Type.TString>;
+        emits: Type.TArray<Type.TString>;
+        when: Type.TOptional<Type.TString>;
+        task: Type.TOptional<Type.TString>;
+        condRef: Type.TOptional<Type.TString>;
+        deps: Type.TOptional<Type.TArray<Type.TString>>;
+        join: Type.TOptional<Type.TUnion<[Type.TLiteral<"all">, Type.TLiteral<"any">]>>;
+        timeout: Type.TOptional<Type.TNumber>;
+        payload: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+    }>>;
+    edges: Type.TOptional<Type.TArray<Type.TObject<{
+        from: Type.TString;
+        to: Type.TString;
+    }>>>;
+    args: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+    budget: Type.TOptional<Type.TObject<{
+        maxUSD: Type.TOptional<Type.TNumber>;
+        maxTokens: Type.TOptional<Type.TNumber>;
+    }>>;
+    concurrency: Type.TOptional<Type.TNumber>;
+    meta: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+}>;
+/**
+ * Narrow an `unknown` value to a {@link FlowIRNode}. Pure, synchronous,
+ * fail-closed: returns `false` for anything that is not a plain object with
+ * a string `id`, a valid `kind`, and string-array `inject`/`emits`. Does not
+ * throw. This is a *structural* check (not a deep TypeBox decode) so it stays
+ * cheap and dependency-light; use {@link assertFlowIR} for full validation.
+ */
+export declare function isFlowIRNode(value: unknown): value is FlowIRNode;
+/**
+ * Assert that a value is a well-formed {@link FlowIR}. Throws a descriptive
+ * `Error` (not an `AssertionError`) on the first structural violation —
+ * fail-closed, so a malformed IR can never silently reach the kernel. Uses
+ * the lightweight structural checks (no external validator); for full schema
+ * decoding, decode `FlowIRSchema` with a TypeBox-compatible checker.
+ *
+ * @throws {Error} if `value` is not a valid `FlowIR`.
+ */
+export declare function assertFlowIR(value: unknown): asserts value is FlowIR;
+//# sourceMappingURL=schema.d.ts.map

package/dist/flowir/schema.d.ts.map

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

package/dist/flowir/schema.js

@@ -0,0 +1,234 @@
+/**
+ * # Canonical FlowIR type contract
+ *
+ * This module formalizes the **canonical FlowIR** (Flow Intermediate
+ * Representation) type contract for the overstory-convergence roadmap. It is a
+ * **superset** of the implicit shape that `./translate.ts` already produces
+ * (mirrored structurally in `./meta.ts`): every `FlowIR`/`FlowIRNode` emitted
+ * by `translateTaskflow` satisfies the types defined here, and these types add
+ * the missing formalization — a closed `FlowIRNodeKind` literal union, an
+ * explicit `FlowIREdge` model, structural `FlowIRBudget`/`FlowIRMeta`, and
+ * optional lightweight TypeBox guards.
+ *
+ * **Provenance & ownership (Q2=B, Q5=own):** this is pi-taskflow's *own* type
+ * contract — not vendored from overstory. `flowir/compile.ts` (batch 2 of the
+ * roadmap) will emit this canonical shape; the event-sourced kernel executes
+ * it. `translate.ts`'s 1:1 projection is a *read-only stub* that already
+ * conforms to this contract today, so formalizing here is purely additive —
+ * it must not break `translate.ts`, `meta.ts`, `hash.ts`, or any barrel.
+ *
+ * **Compatibility note:** the canonical `FlowIRNode.kind` is the closed
+ * `FlowIRNodeKind` literal union (the closed set of native phase kinds = `PHASE_TYPES`), whereas
+ * `meta.ts`'s `FlowIRNode.kind` is `string` (a 1:1 projection). Every value
+ * `translate.ts` produces for `kind` (`phase.type ?? "agent"`) is a member of
+ * `FlowIRNodeKind`, so the canonical type is a strict refinement that
+ * subsumes the stub output. Code that needs the looser projection can keep
+ * using `meta.ts`; code that wants the closed contract imports from here.
+ *
+ * **Purity:** zero runtime deps beyond `typebox`. No IO, no Date, no
+ * randomness. Guards are pure functions over plain JSON values.
+ *
+ * @see docs/internal/overstory-convergence-roadmap.md §3 (M1), §6 (compile seam)
+ * @see docs/internal/rfc-flowir-compilation.md
+ */
+import { Type } from "typebox";
+import { StringEnum } from "../typebox-helpers.js";
+import { PHASE_TYPES } from "../schema.js";
+// ---------------------------------------------------------------------------
+// FlowIRNodeKind — closed literal union = PHASE_TYPES (currently 12 kinds)
+// ---------------------------------------------------------------------------
+/**
+ * The closed set of pi-taskflow phase kinds, derived 1:1 from the exported
+ * {@link PHASE_TYPES} in `../schema.ts` (single source of truth). This is the
+ * canonical `FlowIRNode.kind` vocabulary. `translate.ts` sets
+ * `kind = phase.type ?? "agent"`, so every node it emits is a member of this
+ * union. Adding a phase kind requires updating `PHASE_TYPES` only — FlowIR
+ * follows automatically.
+ *
+ * | kind        | purpose                                                  |
+ * |-------------|----------------------------------------------------------|
+ * | `agent`     | single subagent call                                     |
+ * | `parallel`  | static concurrent branches                               |
+ * | `map`       | dynamic fan-out over an array (one subagent per item)   |
+ * | `gate`      | quality gate — can halt the flow on VERDICT: BLOCK      |
+ * | `reduce`    | aggregate multiple upstream outputs into one            |
+ * | `approval`  | human-in-the-loop pause (approve/reject/edit)           |
+ * | `flow`      | run a saved sub-taskflow as a single phase              |
+ * | `loop`      | repeat body until condition, convergence, or max iters  |
+ * | `tournament`| N competing variants + judge picks best / aggregates    |
+ * | `script`    | run a shell command (no LLM, zero tokens)               |
+ */
+export const FlowIRNodeKind = StringEnum(PHASE_TYPES, {
+    description: "Native phase kinds — 1:1 projection of PHASE_TYPES (agent…script, race, expand, …)",
+});
+// ---------------------------------------------------------------------------
+// TypeBox schemas (for runtime validation / structural guards)
+// ---------------------------------------------------------------------------
+/**
+ * TypeBox schema mirroring {@link FlowIRNode}. Used by the structural guards
+ * below. Kept in sync by construction (the `Static` of this schema *is*
+ * `FlowIRNode`); if the interface above drifts, this schema must be updated to
+ * match.
+ */
+export const FlowIRNodeSchema = Type.Object({
+    id: Type.String({ description: "Unique phase identifier" }),
+    kind: FlowIRNodeKind,
+    inject: Type.Array(Type.String(), { description: "Declared reads (upstream step ids)" }),
+    emits: Type.Array(Type.String(), { description: "What this node emits (currently [id])" }),
+    when: Type.Optional(Type.String({ description: "Raw when guard passthrough" })),
+    task: Type.Optional(Type.String({ description: "Resolved task prompt" })),
+    condRef: Type.Optional(Type.String({ description: "Reference to a compiled condition descriptor" })),
+    deps: Type.Optional(Type.Array(Type.String(), { description: "Explicit dependsOn edges" })),
+    join: Type.Optional(Type.Union([Type.Literal("all"), Type.Literal("any")], { description: "Join mode" })),
+    timeout: Type.Optional(Type.Number({ description: "Per-call ms cap" })),
+    payload: Type.Optional(Type.Record(Type.String(), Type.Unknown(), {
+        description: "Runtime-affecting DSL payload not otherwise modeled by the core node fields",
+    })),
+}, { additionalProperties: false });
+/**
+ * TypeBox schema mirroring {@link FlowIREdge}.
+ */
+export const FlowIREdgeSchema = Type.Object({
+    from: Type.String({ description: "Upstream (producer) node id" }),
+    to: Type.String({ description: "Downstream (consumer) node id" }),
+}, { additionalProperties: false });
+/**
+ * TypeBox schema mirroring {@link FlowIR}.
+ */
+export const FlowIRSchema = Type.Object({
+    name: Type.String({ minLength: 1, description: "Workflow name" }),
+    version: Type.Optional(Type.Number({ description: "DSL schema version" })),
+    nodes: Type.Array(FlowIRNodeSchema, { minItems: 1, description: "IR nodes (one per phase)" }),
+    edges: Type.Optional(Type.Array(FlowIREdgeSchema, { description: "Explicit edge list" })),
+    args: Type.Optional(Type.Record(Type.String(), Type.Unknown(), { description: "Declared invocation arguments" })),
+    budget: Type.Optional(Type.Object({
+        maxUSD: Type.Optional(Type.Number()),
+        maxTokens: Type.Optional(Type.Number()),
+    }, { additionalProperties: false })),
+    concurrency: Type.Optional(Type.Number({ description: "Default max concurrent subagents" })),
+    meta: Type.Optional(Type.Record(Type.String(), Type.Unknown(), { description: "Flow-level metadata" })),
+}, { additionalProperties: false });
+// ---------------------------------------------------------------------------
+// Structural guards — pure, zero-dep (beyond typebox), fail-closed
+// ---------------------------------------------------------------------------
+/** The 10 valid phase kinds, for O(1) membership checks without TypeBox. */
+const VALID_KINDS = new Set(PHASE_TYPES);
+/**
+ * Narrow an `unknown` value to a {@link FlowIRNode}. Pure, synchronous,
+ * fail-closed: returns `false` for anything that is not a plain object with
+ * a string `id`, a valid `kind`, and string-array `inject`/`emits`. Does not
+ * throw. This is a *structural* check (not a deep TypeBox decode) so it stays
+ * cheap and dependency-light; use {@link assertFlowIR} for full validation.
+ */
+export function isFlowIRNode(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const n = value;
+    if (typeof n.id !== "string" || n.id.length === 0)
+        return false;
+    if (typeof n.kind !== "string" || !VALID_KINDS.has(n.kind))
+        return false;
+    if (!isStringArray(n.inject))
+        return false;
+    if (!isStringArray(n.emits))
+        return false;
+    if (n.when !== undefined && typeof n.when !== "string")
+        return false;
+    if (n.task !== undefined && typeof n.task !== "string")
+        return false;
+    if (n.condRef !== undefined && typeof n.condRef !== "string")
+        return false;
+    if (n.deps !== undefined && !isStringArray(n.deps))
+        return false;
+    if (n.join !== undefined && n.join !== "all" && n.join !== "any")
+        return false;
+    if (n.timeout !== undefined && typeof n.timeout !== "number")
+        return false;
+    if (n.payload !== undefined && (typeof n.payload !== "object" || n.payload === null || Array.isArray(n.payload))) {
+        return false;
+    }
+    return true;
+}
+/** Type guard for a `string[]`. */
+function isStringArray(v) {
+    if (!Array.isArray(v))
+        return false;
+    return v.every((x) => typeof x === "string");
+}
+/**
+ * Assert that a value is a well-formed {@link FlowIR}. Throws a descriptive
+ * `Error` (not an `AssertionError`) on the first structural violation —
+ * fail-closed, so a malformed IR can never silently reach the kernel. Uses
+ * the lightweight structural checks (no external validator); for full schema
+ * decoding, decode `FlowIRSchema` with a TypeBox-compatible checker.
+ *
+ * @throws {Error} if `value` is not a valid `FlowIR`.
+ */
+export function assertFlowIR(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new Error(`FlowIR: expected an object, got ${typeof value}`);
+    }
+    const ir = value;
+    if (typeof ir.name !== "string" || ir.name.length === 0) {
+        throw new Error(`FlowIR: 'name' must be a non-empty string`);
+    }
+    if (ir.version !== undefined && typeof ir.version !== "number") {
+        throw new Error(`FlowIR: 'version' must be a number if present`);
+    }
+    if (!Array.isArray(ir.nodes) || ir.nodes.length === 0) {
+        throw new Error(`FlowIR: 'nodes' must be a non-empty array`);
+    }
+    const seenIds = new Set();
+    for (let i = 0; i < ir.nodes.length; i++) {
+        const node = ir.nodes[i];
+        if (!isFlowIRNode(node)) {
+            throw new Error(`FlowIR: nodes[${i}] is not a valid FlowIRNode (id=${String(node?.id)})`);
+        }
+        if (seenIds.has(node.id)) {
+            throw new Error(`FlowIR: duplicate node id '${node.id}'`);
+        }
+        seenIds.add(node.id);
+    }
+    if (ir.edges !== undefined) {
+        if (!Array.isArray(ir.edges)) {
+            throw new Error(`FlowIR: 'edges' must be an array if present`);
+        }
+        for (let i = 0; i < ir.edges.length; i++) {
+            const e = ir.edges[i];
+            if (typeof e !== "object" ||
+                e === null ||
+                typeof e.from !== "string" ||
+                typeof e.to !== "string") {
+                throw new Error(`FlowIR: edges[${i}] must be { from: string, to: string }`);
+            }
+            if (!seenIds.has(e.from)) {
+                throw new Error(`FlowIR: edges[${i}].from references unknown node '${e.from}'`);
+            }
+            if (!seenIds.has(e.to)) {
+                throw new Error(`FlowIR: edges[${i}].to references unknown node '${e.to}'`);
+            }
+        }
+    }
+    if (ir.budget !== undefined) {
+        if (typeof ir.budget !== "object" || ir.budget === null || Array.isArray(ir.budget)) {
+            throw new Error(`FlowIR: 'budget' must be an object if present`);
+        }
+        const b = ir.budget;
+        if (b.maxUSD !== undefined && typeof b.maxUSD !== "number") {
+            throw new Error(`FlowIR: 'budget.maxUSD' must be a number if present`);
+        }
+        if (b.maxTokens !== undefined && typeof b.maxTokens !== "number") {
+            throw new Error(`FlowIR: 'budget.maxTokens' must be a number if present`);
+        }
+    }
+    if (ir.concurrency !== undefined && typeof ir.concurrency !== "number") {
+        throw new Error(`FlowIR: 'concurrency' must be a number if present`);
+    }
+    if (ir.args !== undefined && (typeof ir.args !== "object" || ir.args === null || Array.isArray(ir.args))) {
+        throw new Error(`FlowIR: 'args' must be an object if present`);
+    }
+    if (ir.meta !== undefined && (typeof ir.meta !== "object" || ir.meta === null || Array.isArray(ir.meta))) {
+        throw new Error(`FlowIR: 'meta' must be an object if present`);
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/flowir/schema.js.map

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

package/dist/flowir/translate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../../src/flowir/translate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EACX,YAAY,EACZ,cAAc,EAEd,MAAM,EAEN,cAAc,EACd,MAAM,WAAW,CAAC;AAoEnB;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,GAAG;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;CAC1B,CAoEA"}
+{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../../src/flowir/translate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EACX,YAAY,EACZ,cAAc,EAEd,MAAM,EAEN,cAAc,EACd,MAAM,WAAW,CAAC;AAuEnB;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,GAAG;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;CAC1B,CAoEA"}

package/dist/flowir/translate.js

@@ -67,6 +67,9 @@ const SIDECAR_PHASE_FIELDS = [
     "score",
     "cache",
     "shareContext",
+    "cancelLosers",
+    "expandMode",
+    "maxNodes",
 ];
 /** Build the per-phase sidecar record (verbatim copy of non-IR fields). */
 function sidecarForPhase(phase) {

package/dist/flowir/translate.js.map

@@ -1 +1 @@
-{"version":3,"file":"translate.js","sourceRoot":"","sources":["../../src/flowir/translate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,WAAW,EAA6B,MAAM,cAAc,CAAC;AAUtE,8EAA8E;AAC9E,0EAA0E;AAC1E,sEAAsE;AACtE,2EAA2E;AAC3E,0EAA0E;AAC1E,2CAA2C;AAC3C,8EAA8E;AAE9E,6EAA6E;AAC7E,0EAA0E;AAC1E,4EAA4E;AAC5E,6EAA6E;AAC7E,MAAM,oBAAoB,GAAG;IAC5B,OAAO;IACP,MAAM;IACN,MAAM;IACN,IAAI;IACJ,UAAU;IACV,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,OAAO;IACP,SAAS;IACT,OAAO;IACP,eAAe;IACf,aAAa;IACb,WAAW;IACX,UAAU;IACV,OAAO;IACP,YAAY;IACZ,MAAM;IACN,WAAW;IACX,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,UAAU;IACV,OAAO;IACP,KAAK;IACL,OAAO;IACP,UAAU;IACV,YAAY;IACZ,aAAa;IACb,SAAS;IACT,cAAc;IACd,SAAS;IACT,MAAM;IACN,OAAO;IACP,OAAO;IACP,cAAc;CACL,CAAC;AAEX,2EAA2E;AAC3E,SAAS,eAAe,CAAC,KAAY;IACpC,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,oBAAoB,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAa;IAO9C,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,MAAM,YAAY,GAAiC,EAAE,CAAC;IACtD,MAAM,aAAa,GAA4B,EAAE,CAAC;IAElD,4EAA4E;IAC5E,2EAA2E;IAC3E,4EAA4E;IAC5E,wEAAwE;IACxE,0EAA0E;IAC1E,uEAAuE;IACvE,MAAM,gBAAgB,GAAG,IAAI,CAAC;IAE9B,MAAM,KAAK,GAAiB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACpD,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QAChC,uEAAuE;QACvE,yEAAyE;QACzE,yEAAyE;QACzE,mEAAmE;QACnE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAS,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1E,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,IAAI,EAAE;YAAE,IAAI,CAAC,KAAK,KAAK,CAAC,EAAE;gBAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACxE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QAE1E,oEAAoE;QACpE,oEAAoE;QACpE,0CAA0C;QAC1C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACtD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,KAAK,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxC,QAAQ,CAAC,IAAI,CAAC;oBACb,OAAO,EAAE,KAAK,CAAC,EAAE;oBACjB,OAAO,EAAE,qBAAqB,CAAC,qBAAqB,CAAC,UAAU;iBAC/D,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,yEAAyE;YACzE,4DAA4D;QAC7D,CAAC;QAED,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAEjD,OAAO;YACN,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,OAAO;YAC3B,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;YACzB,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;YACjB,IAAI,EAAE,KAAK,CAAC,IAAI;SACK,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,MAAM,EAAE,GAAW;QAClB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,KAAK;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,WAAW,EAAE,GAAG,CAAC,WAAW;KAC5B,CAAC;IAEF,MAAM,IAAI,GAAmB;QAC5B,cAAc,EAAE,GAAG,CAAC,IAAI;QACxB,YAAY;QACZ,OAAO,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE;KAClC,CAAC;IAEF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;AACzD,CAAC"}
+{"version":3,"file":"translate.js","sourceRoot":"","sources":["../../src/flowir/translate.ts"],"names":[],"mappings":"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"}

package/dist/host/runner-types.d.ts

@@ -96,6 +96,9 @@ export interface RunOptions {
  * instead, so the engine's retry and fail-soft logic can act on it.
  */
 export interface SubagentRunner<TAgent = unknown> {
+    /** Whether this host reports authoritative token/cost usage. `unavailable`
+     * makes runtime budget declarations fail closed at every execution boundary. */
+    readonly usageAccounting?: "available" | "tokens-only" | "unavailable";
     runTask(defaultCwd: string, agents: TAgent[], agentName: string, task: string, opts: RunOptions, globalThinking?: string): Promise<RunResult>;
 }
 //# sourceMappingURL=runner-types.d.ts.map

package/dist/host/runner-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner-types.d.ts","sourceRoot":"","sources":["../../src/host/runner-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AACD,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACrB;AAED,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;yEACqE;IACrE,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,yDAAyD;AACzD,MAAM,WAAW,UAAU;IAC1B,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,kFAAkF;AAClF,MAAM,WAAW,UAAU;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iFAAiF;IACjF,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACpC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,OAAO;IAC/C,OAAO,CACN,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,cAAc,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,SAAS,CAAC,CAAC;CACtB"}
+{"version":3,"file":"runner-types.d.ts","sourceRoot":"","sources":["../../src/host/runner-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AACD,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACrB;AAED,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;yEACqE;IACrE,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,yDAAyD;AACzD,MAAM,WAAW,UAAU;IAC1B,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,kFAAkF;AAClF,MAAM,WAAW,UAAU;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iFAAiF;IACjF,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACpC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,OAAO;IAC/C;oFACgF;IAChF,QAAQ,CAAC,eAAe,CAAC,EAAE,WAAW,GAAG,aAAa,GAAG,aAAa,CAAC;IACvE,OAAO,CACN,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,cAAc,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,SAAS,CAAC,CAAC;CACtB"}

package/dist/index.d.ts

@@ -20,6 +20,7 @@ export * from "./cache.ts";
 export * from "./interpolate.ts";
 export * from "./verify.ts";
 export * from "./usage.ts";
+export * from "./rates.ts";
 export * from "./stale.ts";
 export * from "./workspace.ts";
 export * from "./context-store.ts";
@@ -35,4 +36,5 @@ export * from "./flowir/index.ts";
 export * from "./trace.ts";
 export * from "./deterministic.ts";
 export * from "./replay.ts";
+export * from "./exec/index.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAK7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAK7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -20,6 +20,7 @@ export * from "./cache.js";
 export * from "./interpolate.js";
 export * from "./verify.js";
 export * from "./usage.js";
+export * from "./rates.js";
 export * from "./stale.js";
 export * from "./workspace.js";
 export * from "./context-store.js";
@@ -39,4 +40,5 @@ export * from "./flowir/index.js";
 export * from "./trace.js";
 export * from "./deterministic.js";
 export * from "./replay.js";
+export * from "./exec/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,iFAAiF;AACjF,+EAA+E;AAC/E,iFAAiF;AACjF,mCAAmC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,iFAAiF;AACjF,+EAA+E;AAC/E,iFAAiF;AACjF,mCAAmC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}