fascicle 0.8.16 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,30 @@
1
1
  # Changelog
2
2
 
3
+ ## v0.9.1 — 2026-07-10
4
+
5
+ ### Internal
6
+
7
+ - Re-pinned every GitHub Actions dependency to its Node 24 runtime major (`actions/checkout` v7, `actions/setup-node` v6, `pnpm/action-setup` v6, `actions/cache` v6, `actions/deploy-pages` v5), clearing GitHub's Node 20 runtime deprecation warning that surfaced on the v0.9.0 publish run. Workflow-only change; the published package is byte-identical to v0.9.0.
8
+
9
+ ## v0.9.0 — 2026-07-10
10
+
11
+ ### Changed
12
+
13
+ - **Breaking (peer dependencies): AI SDK v7.** The `ai` peer floor is now `^7.0.0` with no v6 compatibility window, and every AI SDK provider peer moves to its v7-line major: `@ai-sdk/anthropic` `^4`, `@ai-sdk/openai` `^4`, `@ai-sdk/google` `^4`, `@ai-sdk/amazon-bedrock` `^5`, `@ai-sdk/openai-compatible` `^3`, `@openrouter/ai-sdk-provider` `^3`, `ai-sdk-ollama` `^4`. Upgrade the whole set together. Fascicle's own API is unchanged: the v7 renames (`system` to `instructions`, `fullStream` to `stream`, `experimental_output` to `output`, `stepCountIs` to `isStepCount`) land at the SDK boundary only, so `generate({ system })` and friends keep their names.
14
+ - Usage and cost accounting is verified against v7's nested token-detail shape (`inputTokenDetails`/`outputTokenDetails`, cache-inclusive `inputTokens`, reasoning-inclusive `outputTokens`) with concrete-value tests per provider. On `@ai-sdk/anthropic` v4, cache read and write tokens now fold into `inputTokens` upstream, which makes fascicle's cost subtraction formula exact instead of skewed for cache-heavy Anthropic calls.
15
+
16
+ ### Fixed
17
+
18
+ - Streamed `step_finish` chunks now carry the same cached-input/cache-write/reasoning usage granularity as the non-streamed step record (`default_usage_from_sdk` delegates to the provider usage normalizer).
19
+ - The `lmstudio` (OpenAI-compatible) provider opts into streaming usage (`stream_options.include_usage`), so streamed calls report real token counts instead of zeros on spec-strict OpenAI-compatible servers such as Ollama's `/v1` endpoint.
20
+
21
+ ### Internal
22
+
23
+ - Releases are now published from CI with npm Trusted Publishing (OIDC) and a signed provenance attestation, gated by a required-reviewer GitHub Environment (`.github/workflows/publish.yaml`). No long-lived npm token exists anywhere; verify a release with `npm audit signatures`. This makes v0.9.0 the first provenance-attested fascicle publish (see `research/provenance-publish-spec.md`).
24
+ - Agent-layer boundary ADR: fascicle stays on the single-turn seam (`generateText`/`streamText`) and declines the v7 agent layer (`ToolLoopAgent`, `WorkflowAgent`, `HarnessAgent`, `toolApproval`, `@ai-sdk/otel`), recorded in `research/explorations/2026-07-ai-sdk-agent-layer-boundary.md` and linked from `docs/providers.md`.
25
+ - `examples/live_smoke.ts`: a manual release smoke gate that runs one tool-loop flow streamed and non-streamed against OpenRouter and an OpenAI-compatible backend, checking the tool round trip, stream/record text parity, and usage/cost accounting. Live network, so it stays out of the test suite by design.
26
+ - Dev toolchain sweep: vitest 4.1.10, oxlint 1.73, oxlint-tsgolint 0.24, tsdown 0.22.3, zod 4.4.3, `@types/node` 26, fallow 3, and friends.
27
+
3
28
  ## v0.8.16 — 2026-07-07
4
29
 
5
30
  ### Added
package/README.md CHANGED
@@ -180,6 +180,7 @@ For zero-latency streaming from inside a long-running flow, pair it with `http_l
180
180
  - [docs/embedding-under-a-harness.md](./docs/embedding-under-a-harness.md) — running a fascicle agent as somebody's child process
181
181
  - [docs/troubleshooting.md](./docs/troubleshooting.md) — first-run errors and what they mean
182
182
  - [docs/comparison.md](./docs/comparison.md) — how fascicle compares to LangChain, Mastra, and others
183
+ - [docs/adoption-decision.md](./docs/adoption-decision.md) weighs whether to adopt fascicle: the honest case, the risks, and when to reach for something else
183
184
  - [examples/](./examples/) — runnable reference flows
184
185
  - [docs/viewer.md](./docs/viewer.md) — viewer details and transport options
185
186
 
@@ -98,10 +98,11 @@ function http_logger(options) {
98
98
  const send = options.fetch ?? default_fetch;
99
99
  const stack = [];
100
100
  const post = (event) => {
101
+ const body = `${JSON.stringify(event)}\n`;
101
102
  send(url, {
102
103
  method: "POST",
103
104
  headers: { "content-type": "application/x-ndjson" },
104
- body: `${JSON.stringify(event)}\n`
105
+ body
105
106
  }).then((res) => {
106
107
  if (!res.ok && on_error) on_error(/* @__PURE__ */ new Error(`http_logger: POST ${url} -> ${res.status}`));
107
108
  }).catch((err) => {
@@ -261,4 +262,4 @@ function filesystem_store(options) {
261
262
  //#endregion
262
263
  export { http_logger as a, noop_logger as i, tee_logger as n, filesystem_logger as o, stderr_logger as r, filesystem_store as t };
263
264
 
264
- //# sourceMappingURL=adapters-DdUx-_b3.js.map
265
+ //# sourceMappingURL=adapters-Dbx3M8m-.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"adapters-DdUx-_b3.js","names":[],"sources":["../src/adapters/line_logger.ts","../src/adapters/filesystem_logger.ts","../src/adapters/http_logger.ts","../src/adapters/noop_logger.ts","../src/adapters/stderr_logger.ts","../src/adapters/tee_logger.ts","../src/adapters/filesystem_store.ts"],"sourcesContent":["/**\n * Shared line-oriented trajectory logger core.\n *\n * `filesystem_logger` and `stderr_logger` emit the same wire format (one JSON\n * object per line) and differ only in where the line goes. This module holds\n * the common span bookkeeping: `start_span` and `end_span` each emit a line;\n * `record` emits the event as written. When the caller supplies\n * `parent_span_id` in the span meta (the runner threads the true structural\n * parent through `RunContext`), that value is used verbatim, so span trees are\n * correct even for concurrent children under `parallel`/`map`. Only when no\n * parent is supplied does the logger fall back to an in-memory stack of\n * still-open spans, which is best-effort under concurrency.\n */\n\nimport { randomUUID } from 'node:crypto'\nimport type { TrajectoryLogger } from '#core'\n\nexport function line_logger(write_line: (event: Record<string, unknown>) => void): TrajectoryLogger {\n const stack: string[] = []\n\n const start_span: TrajectoryLogger['start_span'] = (name, meta) => {\n const span_id = `${name}:${randomUUID().slice(0, 8)}`\n const event: Record<string, unknown> = { kind: 'span_start', span_id, name, ...meta }\n if (event['parent_span_id'] === undefined && stack.length > 0) {\n event['parent_span_id'] = stack[stack.length - 1]\n }\n write_line(event)\n stack.push(span_id)\n return span_id\n }\n\n const end_span: TrajectoryLogger['end_span'] = (id, meta) => {\n write_line({ kind: 'span_end', span_id: id, ...meta })\n const idx = stack.lastIndexOf(id)\n if (idx !== -1) stack.splice(idx, 1)\n }\n\n const record: TrajectoryLogger['record'] = (event) => {\n write_line({ ...event })\n }\n\n return { record, start_span, end_span }\n}\n","/**\n * Filesystem JSONL trajectory logger.\n *\n * Appends one JSON object per line to a configured output file. Span\n * bookkeeping (including the `parent_span_id` handling that keeps span trees\n * correct for concurrent children under `parallel`/`map`) lives in\n * `line_logger`. Two concurrent `run(...)` calls that pass distinct logger\n * instances (constructed with distinct `output_path`s) share nothing.\n *\n * Paths are accepted at construction; the logger never reads `process.env`.\n */\n\nimport { appendFileSync, mkdirSync } from 'node:fs'\nimport { dirname } from 'node:path'\nimport type { TrajectoryLogger } from '#core'\nimport { line_logger } from './line_logger.js'\n\nexport type FilesystemLoggerOptions = {\n readonly output_path: string\n}\n\nexport function filesystem_logger(options: FilesystemLoggerOptions): TrajectoryLogger {\n const { output_path } = options\n mkdirSync(dirname(output_path), { recursive: true })\n\n return line_logger((event) => {\n appendFileSync(output_path, `${JSON.stringify(event)}\\n`)\n })\n}\n","/**\n * HTTP push trajectory logger.\n *\n * Conforms to `TrajectoryLogger`. POSTs each event as a single line of\n * newline-delimited JSON to a configured URL. Pairs naturally with the\n * fascicle viewer's `/api/ingest` endpoint, but is a generic adapter — the\n * receiver can be anything that accepts NDJSON over HTTP.\n *\n * Failure policy: drop on transport error and invoke the optional `on_error`\n * callback. Never throws, never blocks the user's flow on a dev tool being\n * up. The flow always wins; the viewer is best-effort.\n *\n * Hierarchical span ids are tracked in-process, mirroring `filesystem_logger`\n * so the wire format is identical.\n */\n\nimport { randomUUID } from 'node:crypto'\nimport type { TrajectoryLogger } from '#core'\n\nexport type HttpLoggerFetch = (\n url: string,\n init: { method: 'POST'; headers: Record<string, string>; body: string },\n) => Promise<{ ok: boolean; status: number }>\n\nexport type HttpLoggerOptions = {\n readonly url: string\n readonly fetch?: HttpLoggerFetch\n readonly on_error?: (err: unknown) => void\n}\n\nconst default_fetch: HttpLoggerFetch = async (url, init) => {\n const res = await fetch(url, init)\n return { ok: res.ok, status: res.status }\n}\n\nexport function http_logger(options: HttpLoggerOptions): TrajectoryLogger {\n const { url, on_error } = options\n const send = options.fetch ?? default_fetch\n const stack: string[] = []\n\n const post = (event: Record<string, unknown>): void => {\n const body = `${JSON.stringify(event)}\\n`\n void send(url, {\n method: 'POST',\n headers: { 'content-type': 'application/x-ndjson' },\n body,\n })\n .then((res) => {\n if (!res.ok && on_error) on_error(new Error(`http_logger: POST ${url} -> ${res.status}`))\n })\n .catch((err: unknown) => {\n if (on_error) on_error(err)\n })\n }\n\n const start_span: TrajectoryLogger['start_span'] = (name, meta) => {\n const span_id = `${name}:${randomUUID().slice(0, 8)}`\n const event: Record<string, unknown> = { kind: 'span_start', span_id, name, ...meta }\n // Prefer the caller-threaded structural parent; fall back to the open-span\n // stack only when none was supplied (best-effort under concurrency).\n if (event['parent_span_id'] === undefined && stack.length > 0) {\n event['parent_span_id'] = stack[stack.length - 1]\n }\n post(event)\n stack.push(span_id)\n return span_id\n }\n\n const end_span: TrajectoryLogger['end_span'] = (id, meta) => {\n post({ kind: 'span_end', span_id: id, ...meta })\n const idx = stack.lastIndexOf(id)\n if (idx !== -1) stack.splice(idx, 1)\n }\n\n const record: TrajectoryLogger['record'] = (event) => {\n post({ ...event })\n }\n\n return { record, start_span, end_span }\n}\n","/**\n * No-op trajectory logger.\n *\n * Satisfies `TrajectoryLogger` from `core` without emitting any\n * output. Used as the default when no logger is supplied to `run(...)` and as\n * a cheap fallback in tests that do not care about trajectory output.\n */\n\nimport { randomUUID } from 'node:crypto'\nimport type { TrajectoryLogger } from '#core'\n\nexport function noop_logger(): TrajectoryLogger {\n return {\n record: () => {},\n start_span: (name) => `${name}:${randomUUID().slice(0, 8)}`,\n end_span: () => {},\n }\n}\n","/**\n * Stderr JSONL trajectory logger.\n *\n * Writes one JSON object per line to stderr (or an injected stream), leaving\n * stdout untouched. This is the blessed console logger for agents that run as\n * somebody's child process: under the stdio agent contract, stdout carries the\n * result envelope and belongs to the parent, so trajectory must go elsewhere.\n * The wire format is identical to `filesystem_logger`, so captured stderr is a\n * valid trajectory JSONL file (`2>events.jsonl`) the viewer parses unchanged.\n *\n * Writes never throw: a broken pipe or closed stream drops the event rather\n * than failing the flow.\n */\n\nimport type { TrajectoryLogger } from '#core'\nimport { line_logger } from './line_logger.js'\n\nexport type StderrLoggerOptions = {\n readonly stream?: { write(chunk: string): unknown }\n}\n\nexport function stderr_logger(options: StderrLoggerOptions = {}): TrajectoryLogger {\n const stream = options.stream ?? process.stderr\n return line_logger((event) => {\n try {\n stream.write(`${JSON.stringify(event)}\\n`)\n } catch {\n // Never throw from a logger; the flow always wins.\n }\n })\n}\n","/**\n * tee_logger: fan one TrajectoryLogger contract out to many sinks.\n *\n * Each sink receives every record/start_span/end_span call. Sinks are called\n * in registration order and exceptions in one sink do not prevent the others\n * from receiving the event.\n *\n * The first sink's `start_span` return value is treated as canonical and\n * returned to the caller; the tee remembers each sink's per-sink id so that\n * `end_span(canonical_id, ...)` translates back to the right id for each sink.\n * Within any one sink the wire format stays internally consistent — only the\n * across-sink ids may differ.\n */\n\nimport type { TrajectoryLogger } from '#core'\n\nexport function tee_logger(...loggers: ReadonlyArray<TrajectoryLogger>): TrajectoryLogger {\n if (loggers.length === 0) {\n throw new Error('tee_logger: at least one logger required')\n }\n\n const id_map = new Map<string, ReadonlyArray<string>>()\n\n const safe_each = (fn: (l: TrajectoryLogger, idx: number) => void): void => {\n for (let i = 0; i < loggers.length; i += 1) {\n const l = loggers[i]\n if (l === undefined) continue\n try {\n fn(l, i)\n } catch {\n // best-effort fan-out: a misbehaving sink must not derail the others\n }\n }\n }\n\n return {\n record: (event) => {\n safe_each((l) => l.record(event))\n },\n start_span: (name, meta) => {\n const ids: string[] = []\n safe_each((l) => {\n ids.push(l.start_span(name, meta))\n })\n const canonical = ids[0] ?? `${name}:tee`\n if (loggers.length > 1) id_map.set(canonical, ids)\n return canonical\n },\n end_span: (id, meta) => {\n const ids = id_map.get(id)\n if (ids === undefined) {\n safe_each((l) => l.end_span(id, meta))\n return\n }\n id_map.delete(id)\n safe_each((l, idx) => l.end_span(ids[idx] ?? id, meta))\n },\n }\n}\n","/**\n * Filesystem-backed checkpoint store.\n *\n * Satisfies `CheckpointStore` from `core`. Each key is stored as\n * a JSON file under the configured root directory. Writes are all-or-nothing:\n * values are written to a temporary sibling file and then atomically renamed\n * into place, so an interrupted write never leaves a partially-written file\n * at the target key (spec.md §6.3, §6.8). On `get`, a missing file, a partial\n * temp file that is not atomically renamed, or a JSON parse failure each read\n * as a cache miss (returning `null`) rather than an error.\n *\n * Paths are accepted at construction; the store never reads `process.env`.\n */\n\nimport { createHash, randomUUID } from 'node:crypto'\nimport { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises'\nimport { join } from 'node:path'\nimport type { CheckpointStore } from '#core'\n\nexport type FilesystemStoreOptions = {\n readonly root_dir: string\n}\n\nfunction safe_filename(key: string): string {\n const hash = createHash('sha256').update(key).digest('hex').slice(0, 12)\n const slug = key.replace(/[^a-zA-Z0-9._-]/g, '_').slice(0, 64)\n return `${slug}.${hash}.json`\n}\n\nexport function filesystem_store(options: FilesystemStoreOptions): CheckpointStore {\n const { root_dir } = options\n\n const ensure_root = async (): Promise<void> => {\n await mkdir(root_dir, { recursive: true })\n }\n\n const path_for = (key: string): string => join(root_dir, safe_filename(key))\n\n const get = async (key: string): Promise<unknown> => {\n const path = path_for(key)\n let raw: string\n try {\n raw = await readFile(path, 'utf8')\n } catch {\n return null\n }\n try {\n return JSON.parse(raw) as unknown\n } catch {\n return null\n }\n }\n\n const set = async (key: string, value: unknown): Promise<void> => {\n await ensure_root()\n const target = path_for(key)\n const tmp = `${target}.${randomUUID().slice(0, 8)}.tmp`\n await writeFile(tmp, JSON.stringify(value), 'utf8')\n await rename(tmp, target)\n }\n\n const delete_key = async (key: string): Promise<void> => {\n const target = path_for(key)\n await rm(target, { force: true })\n }\n\n return { get, set, delete: delete_key }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAiBA,SAAgB,YAAY,YAAwE;CAClG,MAAM,QAAkB,EAAE;CAE1B,MAAM,cAA8C,MAAM,SAAS;EACjE,MAAM,UAAU,GAAG,KAAK,GAAG,YAAY,CAAC,MAAM,GAAG,EAAE;EACnD,MAAM,QAAiC;GAAE,MAAM;GAAc;GAAS;GAAM,GAAG;GAAM;AACrF,MAAI,MAAM,sBAAsB,KAAA,KAAa,MAAM,SAAS,EAC1D,OAAM,oBAAoB,MAAM,MAAM,SAAS;AAEjD,aAAW,MAAM;AACjB,QAAM,KAAK,QAAQ;AACnB,SAAO;;CAGT,MAAM,YAA0C,IAAI,SAAS;AAC3D,aAAW;GAAE,MAAM;GAAY,SAAS;GAAI,GAAG;GAAM,CAAC;EACtD,MAAM,MAAM,MAAM,YAAY,GAAG;AACjC,MAAI,QAAQ,GAAI,OAAM,OAAO,KAAK,EAAE;;CAGtC,MAAM,UAAsC,UAAU;AACpD,aAAW,EAAE,GAAG,OAAO,CAAC;;AAG1B,QAAO;EAAE;EAAQ;EAAY;EAAU;;;;;;;;;;;;;;;ACpBzC,SAAgB,kBAAkB,SAAoD;CACpF,MAAM,EAAE,gBAAgB;AACxB,WAAU,QAAQ,YAAY,EAAE,EAAE,WAAW,MAAM,CAAC;AAEpD,QAAO,aAAa,UAAU;AAC5B,iBAAe,aAAa,GAAG,KAAK,UAAU,MAAM,CAAC,IAAI;GACzD;;;;;;;;;;;;;;;;;;;ACGJ,MAAM,gBAAiC,OAAO,KAAK,SAAS;CAC1D,MAAM,MAAM,MAAM,MAAM,KAAK,KAAK;AAClC,QAAO;EAAE,IAAI,IAAI;EAAI,QAAQ,IAAI;EAAQ;;AAG3C,SAAgB,YAAY,SAA8C;CACxE,MAAM,EAAE,KAAK,aAAa;CAC1B,MAAM,OAAO,QAAQ,SAAS;CAC9B,MAAM,QAAkB,EAAE;CAE1B,MAAM,QAAQ,UAAyC;AAEhD,OAAK,KAAK;GACb,QAAQ;GACR,SAAS,EAAE,gBAAgB,wBAAwB;GACnD,MAJW,GAAG,KAAK,UAAU,MAAM,CAAC;GAKrC,CAAC,CACC,MAAM,QAAQ;AACb,OAAI,CAAC,IAAI,MAAM,SAAU,0BAAS,IAAI,MAAM,qBAAqB,IAAI,MAAM,IAAI,SAAS,CAAC;IACzF,CACD,OAAO,QAAiB;AACvB,OAAI,SAAU,UAAS,IAAI;IAC3B;;CAGN,MAAM,cAA8C,MAAM,SAAS;EACjE,MAAM,UAAU,GAAG,KAAK,GAAG,YAAY,CAAC,MAAM,GAAG,EAAE;EACnD,MAAM,QAAiC;GAAE,MAAM;GAAc;GAAS;GAAM,GAAG;GAAM;AAGrF,MAAI,MAAM,sBAAsB,KAAA,KAAa,MAAM,SAAS,EAC1D,OAAM,oBAAoB,MAAM,MAAM,SAAS;AAEjD,OAAK,MAAM;AACX,QAAM,KAAK,QAAQ;AACnB,SAAO;;CAGT,MAAM,YAA0C,IAAI,SAAS;AAC3D,OAAK;GAAE,MAAM;GAAY,SAAS;GAAI,GAAG;GAAM,CAAC;EAChD,MAAM,MAAM,MAAM,YAAY,GAAG;AACjC,MAAI,QAAQ,GAAI,OAAM,OAAO,KAAK,EAAE;;CAGtC,MAAM,UAAsC,UAAU;AACpD,OAAK,EAAE,GAAG,OAAO,CAAC;;AAGpB,QAAO;EAAE;EAAQ;EAAY;EAAU;;;;;;;;;;;ACnEzC,SAAgB,cAAgC;AAC9C,QAAO;EACL,cAAc;EACd,aAAa,SAAS,GAAG,KAAK,GAAG,YAAY,CAAC,MAAM,GAAG,EAAE;EACzD,gBAAgB;EACjB;;;;ACKH,SAAgB,cAAc,UAA+B,EAAE,EAAoB;CACjF,MAAM,SAAS,QAAQ,UAAU,QAAQ;AACzC,QAAO,aAAa,UAAU;AAC5B,MAAI;AACF,UAAO,MAAM,GAAG,KAAK,UAAU,MAAM,CAAC,IAAI;UACpC;GAGR;;;;ACbJ,SAAgB,WAAW,GAAG,SAA4D;AACxF,KAAI,QAAQ,WAAW,EACrB,OAAM,IAAI,MAAM,2CAA2C;CAG7D,MAAM,yBAAS,IAAI,KAAoC;CAEvD,MAAM,aAAa,OAAyD;AAC1E,OAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK,GAAG;GAC1C,MAAM,IAAI,QAAQ;AAClB,OAAI,MAAM,KAAA,EAAW;AACrB,OAAI;AACF,OAAG,GAAG,EAAE;WACF;;;AAMZ,QAAO;EACL,SAAS,UAAU;AACjB,cAAW,MAAM,EAAE,OAAO,MAAM,CAAC;;EAEnC,aAAa,MAAM,SAAS;GAC1B,MAAM,MAAgB,EAAE;AACxB,cAAW,MAAM;AACf,QAAI,KAAK,EAAE,WAAW,MAAM,KAAK,CAAC;KAClC;GACF,MAAM,YAAY,IAAI,MAAM,GAAG,KAAK;AACpC,OAAI,QAAQ,SAAS,EAAG,QAAO,IAAI,WAAW,IAAI;AAClD,UAAO;;EAET,WAAW,IAAI,SAAS;GACtB,MAAM,MAAM,OAAO,IAAI,GAAG;AAC1B,OAAI,QAAQ,KAAA,GAAW;AACrB,eAAW,MAAM,EAAE,SAAS,IAAI,KAAK,CAAC;AACtC;;AAEF,UAAO,OAAO,GAAG;AACjB,cAAW,GAAG,QAAQ,EAAE,SAAS,IAAI,QAAQ,IAAI,KAAK,CAAC;;EAE1D;;;;;;;;;;;;;;;;;AClCH,SAAS,cAAc,KAAqB;CAC1C,MAAM,OAAO,WAAW,SAAS,CAAC,OAAO,IAAI,CAAC,OAAO,MAAM,CAAC,MAAM,GAAG,GAAG;AAExE,QAAO,GADM,IAAI,QAAQ,oBAAoB,IAAI,CAAC,MAAM,GAAG,GAAG,CAC/C,GAAG,KAAK;;AAGzB,SAAgB,iBAAiB,SAAkD;CACjF,MAAM,EAAE,aAAa;CAErB,MAAM,cAAc,YAA2B;AAC7C,QAAM,MAAM,UAAU,EAAE,WAAW,MAAM,CAAC;;CAG5C,MAAM,YAAY,QAAwB,KAAK,UAAU,cAAc,IAAI,CAAC;CAE5E,MAAM,MAAM,OAAO,QAAkC;EACnD,MAAM,OAAO,SAAS,IAAI;EAC1B,IAAI;AACJ,MAAI;AACF,SAAM,MAAM,SAAS,MAAM,OAAO;UAC5B;AACN,UAAO;;AAET,MAAI;AACF,UAAO,KAAK,MAAM,IAAI;UAChB;AACN,UAAO;;;CAIX,MAAM,MAAM,OAAO,KAAa,UAAkC;AAChE,QAAM,aAAa;EACnB,MAAM,SAAS,SAAS,IAAI;EAC5B,MAAM,MAAM,GAAG,OAAO,GAAG,YAAY,CAAC,MAAM,GAAG,EAAE,CAAC;AAClD,QAAM,UAAU,KAAK,KAAK,UAAU,MAAM,EAAE,OAAO;AACnD,QAAM,OAAO,KAAK,OAAO;;CAG3B,MAAM,aAAa,OAAO,QAA+B;AAEvD,QAAM,GADS,SAAS,IAAI,EACX,EAAE,OAAO,MAAM,CAAC;;AAGnC,QAAO;EAAE;EAAK;EAAK,QAAQ;EAAY"}
1
+ {"version":3,"file":"adapters-Dbx3M8m-.js","names":[],"sources":["../src/adapters/line_logger.ts","../src/adapters/filesystem_logger.ts","../src/adapters/http_logger.ts","../src/adapters/noop_logger.ts","../src/adapters/stderr_logger.ts","../src/adapters/tee_logger.ts","../src/adapters/filesystem_store.ts"],"sourcesContent":["/**\n * Shared line-oriented trajectory logger core.\n *\n * `filesystem_logger` and `stderr_logger` emit the same wire format (one JSON\n * object per line) and differ only in where the line goes. This module holds\n * the common span bookkeeping: `start_span` and `end_span` each emit a line;\n * `record` emits the event as written. When the caller supplies\n * `parent_span_id` in the span meta (the runner threads the true structural\n * parent through `RunContext`), that value is used verbatim, so span trees are\n * correct even for concurrent children under `parallel`/`map`. Only when no\n * parent is supplied does the logger fall back to an in-memory stack of\n * still-open spans, which is best-effort under concurrency.\n */\n\nimport { randomUUID } from 'node:crypto'\nimport type { TrajectoryLogger } from '#core'\n\nexport function line_logger(write_line: (event: Record<string, unknown>) => void): TrajectoryLogger {\n const stack: string[] = []\n\n const start_span: TrajectoryLogger['start_span'] = (name, meta) => {\n const span_id = `${name}:${randomUUID().slice(0, 8)}`\n const event: Record<string, unknown> = { kind: 'span_start', span_id, name, ...meta }\n if (event['parent_span_id'] === undefined && stack.length > 0) {\n event['parent_span_id'] = stack[stack.length - 1]\n }\n write_line(event)\n stack.push(span_id)\n return span_id\n }\n\n const end_span: TrajectoryLogger['end_span'] = (id, meta) => {\n write_line({ kind: 'span_end', span_id: id, ...meta })\n const idx = stack.lastIndexOf(id)\n if (idx !== -1) stack.splice(idx, 1)\n }\n\n const record: TrajectoryLogger['record'] = (event) => {\n write_line({ ...event })\n }\n\n return { record, start_span, end_span }\n}\n","/**\n * Filesystem JSONL trajectory logger.\n *\n * Appends one JSON object per line to a configured output file. Span\n * bookkeeping (including the `parent_span_id` handling that keeps span trees\n * correct for concurrent children under `parallel`/`map`) lives in\n * `line_logger`. Two concurrent `run(...)` calls that pass distinct logger\n * instances (constructed with distinct `output_path`s) share nothing.\n *\n * Paths are accepted at construction; the logger never reads `process.env`.\n */\n\nimport { appendFileSync, mkdirSync } from 'node:fs'\nimport { dirname } from 'node:path'\nimport type { TrajectoryLogger } from '#core'\nimport { line_logger } from './line_logger.js'\n\nexport type FilesystemLoggerOptions = {\n readonly output_path: string\n}\n\nexport function filesystem_logger(options: FilesystemLoggerOptions): TrajectoryLogger {\n const { output_path } = options\n mkdirSync(dirname(output_path), { recursive: true })\n\n return line_logger((event) => {\n appendFileSync(output_path, `${JSON.stringify(event)}\\n`)\n })\n}\n","/**\n * HTTP push trajectory logger.\n *\n * Conforms to `TrajectoryLogger`. POSTs each event as a single line of\n * newline-delimited JSON to a configured URL. Pairs naturally with the\n * fascicle viewer's `/api/ingest` endpoint, but is a generic adapter — the\n * receiver can be anything that accepts NDJSON over HTTP.\n *\n * Failure policy: drop on transport error and invoke the optional `on_error`\n * callback. Never throws, never blocks the user's flow on a dev tool being\n * up. The flow always wins; the viewer is best-effort.\n *\n * Hierarchical span ids are tracked in-process, mirroring `filesystem_logger`\n * so the wire format is identical.\n */\n\nimport { randomUUID } from 'node:crypto'\nimport type { TrajectoryLogger } from '#core'\n\nexport type HttpLoggerFetch = (\n url: string,\n init: { method: 'POST'; headers: Record<string, string>; body: string },\n) => Promise<{ ok: boolean; status: number }>\n\nexport type HttpLoggerOptions = {\n readonly url: string\n readonly fetch?: HttpLoggerFetch\n readonly on_error?: (err: unknown) => void\n}\n\nconst default_fetch: HttpLoggerFetch = async (url, init) => {\n const res = await fetch(url, init)\n return { ok: res.ok, status: res.status }\n}\n\nexport function http_logger(options: HttpLoggerOptions): TrajectoryLogger {\n const { url, on_error } = options\n const send = options.fetch ?? default_fetch\n const stack: string[] = []\n\n const post = (event: Record<string, unknown>): void => {\n const body = `${JSON.stringify(event)}\\n`\n void send(url, {\n method: 'POST',\n headers: { 'content-type': 'application/x-ndjson' },\n body,\n })\n .then((res) => {\n if (!res.ok && on_error) on_error(new Error(`http_logger: POST ${url} -> ${res.status}`))\n })\n .catch((err: unknown) => {\n if (on_error) on_error(err)\n })\n }\n\n const start_span: TrajectoryLogger['start_span'] = (name, meta) => {\n const span_id = `${name}:${randomUUID().slice(0, 8)}`\n const event: Record<string, unknown> = { kind: 'span_start', span_id, name, ...meta }\n // Prefer the caller-threaded structural parent; fall back to the open-span\n // stack only when none was supplied (best-effort under concurrency).\n if (event['parent_span_id'] === undefined && stack.length > 0) {\n event['parent_span_id'] = stack[stack.length - 1]\n }\n post(event)\n stack.push(span_id)\n return span_id\n }\n\n const end_span: TrajectoryLogger['end_span'] = (id, meta) => {\n post({ kind: 'span_end', span_id: id, ...meta })\n const idx = stack.lastIndexOf(id)\n if (idx !== -1) stack.splice(idx, 1)\n }\n\n const record: TrajectoryLogger['record'] = (event) => {\n post({ ...event })\n }\n\n return { record, start_span, end_span }\n}\n","/**\n * No-op trajectory logger.\n *\n * Satisfies `TrajectoryLogger` from `core` without emitting any\n * output. Used as the default when no logger is supplied to `run(...)` and as\n * a cheap fallback in tests that do not care about trajectory output.\n */\n\nimport { randomUUID } from 'node:crypto'\nimport type { TrajectoryLogger } from '#core'\n\nexport function noop_logger(): TrajectoryLogger {\n return {\n record: () => {},\n start_span: (name) => `${name}:${randomUUID().slice(0, 8)}`,\n end_span: () => {},\n }\n}\n","/**\n * Stderr JSONL trajectory logger.\n *\n * Writes one JSON object per line to stderr (or an injected stream), leaving\n * stdout untouched. This is the blessed console logger for agents that run as\n * somebody's child process: under the stdio agent contract, stdout carries the\n * result envelope and belongs to the parent, so trajectory must go elsewhere.\n * The wire format is identical to `filesystem_logger`, so captured stderr is a\n * valid trajectory JSONL file (`2>events.jsonl`) the viewer parses unchanged.\n *\n * Writes never throw: a broken pipe or closed stream drops the event rather\n * than failing the flow.\n */\n\nimport type { TrajectoryLogger } from '#core'\nimport { line_logger } from './line_logger.js'\n\nexport type StderrLoggerOptions = {\n readonly stream?: { write(chunk: string): unknown }\n}\n\nexport function stderr_logger(options: StderrLoggerOptions = {}): TrajectoryLogger {\n const stream = options.stream ?? process.stderr\n return line_logger((event) => {\n try {\n stream.write(`${JSON.stringify(event)}\\n`)\n } catch {\n // Never throw from a logger; the flow always wins.\n }\n })\n}\n","/**\n * tee_logger: fan one TrajectoryLogger contract out to many sinks.\n *\n * Each sink receives every record/start_span/end_span call. Sinks are called\n * in registration order and exceptions in one sink do not prevent the others\n * from receiving the event.\n *\n * The first sink's `start_span` return value is treated as canonical and\n * returned to the caller; the tee remembers each sink's per-sink id so that\n * `end_span(canonical_id, ...)` translates back to the right id for each sink.\n * Within any one sink the wire format stays internally consistent — only the\n * across-sink ids may differ.\n */\n\nimport type { TrajectoryLogger } from '#core'\n\nexport function tee_logger(...loggers: ReadonlyArray<TrajectoryLogger>): TrajectoryLogger {\n if (loggers.length === 0) {\n throw new Error('tee_logger: at least one logger required')\n }\n\n const id_map = new Map<string, ReadonlyArray<string>>()\n\n const safe_each = (fn: (l: TrajectoryLogger, idx: number) => void): void => {\n for (let i = 0; i < loggers.length; i += 1) {\n const l = loggers[i]\n if (l === undefined) continue\n try {\n fn(l, i)\n } catch {\n // best-effort fan-out: a misbehaving sink must not derail the others\n }\n }\n }\n\n return {\n record: (event) => {\n safe_each((l) => l.record(event))\n },\n start_span: (name, meta) => {\n const ids: string[] = []\n safe_each((l) => {\n ids.push(l.start_span(name, meta))\n })\n const canonical = ids[0] ?? `${name}:tee`\n if (loggers.length > 1) id_map.set(canonical, ids)\n return canonical\n },\n end_span: (id, meta) => {\n const ids = id_map.get(id)\n if (ids === undefined) {\n safe_each((l) => l.end_span(id, meta))\n return\n }\n id_map.delete(id)\n safe_each((l, idx) => l.end_span(ids[idx] ?? id, meta))\n },\n }\n}\n","/**\n * Filesystem-backed checkpoint store.\n *\n * Satisfies `CheckpointStore` from `core`. Each key is stored as\n * a JSON file under the configured root directory. Writes are all-or-nothing:\n * values are written to a temporary sibling file and then atomically renamed\n * into place, so an interrupted write never leaves a partially-written file\n * at the target key (spec.md §6.3, §6.8). On `get`, a missing file, a partial\n * temp file that is not atomically renamed, or a JSON parse failure each read\n * as a cache miss (returning `null`) rather than an error.\n *\n * Paths are accepted at construction; the store never reads `process.env`.\n */\n\nimport { createHash, randomUUID } from 'node:crypto'\nimport { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises'\nimport { join } from 'node:path'\nimport type { CheckpointStore } from '#core'\n\nexport type FilesystemStoreOptions = {\n readonly root_dir: string\n}\n\nfunction safe_filename(key: string): string {\n const hash = createHash('sha256').update(key).digest('hex').slice(0, 12)\n const slug = key.replace(/[^a-zA-Z0-9._-]/g, '_').slice(0, 64)\n return `${slug}.${hash}.json`\n}\n\nexport function filesystem_store(options: FilesystemStoreOptions): CheckpointStore {\n const { root_dir } = options\n\n const ensure_root = async (): Promise<void> => {\n await mkdir(root_dir, { recursive: true })\n }\n\n const path_for = (key: string): string => join(root_dir, safe_filename(key))\n\n const get = async (key: string): Promise<unknown> => {\n const path = path_for(key)\n let raw: string\n try {\n raw = await readFile(path, 'utf8')\n } catch {\n return null\n }\n try {\n return JSON.parse(raw) as unknown\n } catch {\n return null\n }\n }\n\n const set = async (key: string, value: unknown): Promise<void> => {\n await ensure_root()\n const target = path_for(key)\n const tmp = `${target}.${randomUUID().slice(0, 8)}.tmp`\n await writeFile(tmp, JSON.stringify(value), 'utf8')\n await rename(tmp, target)\n }\n\n const delete_key = async (key: string): Promise<void> => {\n const target = path_for(key)\n await rm(target, { force: true })\n }\n\n return { get, set, delete: delete_key }\n}\n"],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import { J as TrajectoryLogger, U as CheckpointStore } from "./index-CEj6hY9z.js";
1
+ import { J as TrajectoryLogger, U as CheckpointStore } from "./index-JhJahQNi.js";
2
2
 
3
3
  //#region src/adapters/filesystem_logger.d.ts
4
4
  type FilesystemLoggerOptions = {
package/dist/adapters.js CHANGED
@@ -1,2 +1,2 @@
1
- import { a as http_logger, i as noop_logger, n as tee_logger, o as filesystem_logger, r as stderr_logger, t as filesystem_store } from "./adapters-DdUx-_b3.js";
1
+ import { a as http_logger, i as noop_logger, n as tee_logger, o as filesystem_logger, r as stderr_logger, t as filesystem_store } from "./adapters-Dbx3M8m-.js";
2
2
  export { filesystem_logger, filesystem_store, http_logger, noop_logger, stderr_logger, tee_logger };
@@ -1190,7 +1190,8 @@ function map(config) {
1190
1190
  abort: composed
1191
1191
  };
1192
1192
  const item_value = list[idx];
1193
- results[idx] = await dispatch_step(per_item, item_value, child_ctx);
1193
+ const value = await dispatch_step(per_item, item_value, child_ctx);
1194
+ results[idx] = value;
1194
1195
  };
1195
1196
  const worker = async () => {
1196
1197
  while (true) {
@@ -1856,4 +1857,4 @@ const trajectory_event_schema = z.union([
1856
1857
  //#endregion
1857
1858
  export { timeout_error as A, describe as C, describe_cycle_error as D, aborted_error as E, resume_validation_error as O, sequence as S, run as T, retry as _, trajectory_event_schema as a, branch as b, scope as c, suspend as d, checkpoint as f, fallback as g, timeout as h, span_start_event_schema as i, flow_schema_default as j, suspended_error as k, stash as l, loop as m, emit_event_schema as n, STEP_KINDS as o, compose as p, span_end_event_schema as r, is_step_kind as s, custom_event_schema as t, use as u, pipe as v, step as w, parallel as x, map as y };
1858
1859
 
1859
- //# sourceMappingURL=core-BhmclJzj.js.map
1860
+ //# sourceMappingURL=core-CYpxskeT.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"core-CYpxskeT.js","names":["is_step","is_step","next_id","is_step","next_id","next_id","next_id","next_id","is_step","next_id","next_id","next_id","next_id","next_id"],"sources":["../src/core/flow-schema.json","../src/core/cleanup.ts","../src/core/errors.ts","../src/core/streaming.ts","../src/core/runner.ts","../src/core/step.ts","../src/core/is_step.ts","../src/core/describe.ts","../src/core/sequence.ts","../src/core/parallel.ts","../src/core/branch.ts","../src/core/map.ts","../src/core/pipe.ts","../src/core/retry.ts","../src/core/fallback.ts","../src/core/timeout.ts","../src/core/loop.ts","../src/core/compose.ts","../src/core/checkpoint.ts","../src/core/suspend.ts","../src/core/scope.ts","../src/core/step_kinds.ts","../src/core/trajectory.ts","../src/core/index.ts"],"sourcesContent":["","/**\n * Per-run cleanup registry.\n *\n * Handlers fire in LIFO (reverse registration) order on abort, on uncaught\n * error in the root, and on successful completion. Each handler has a\n * 5-second timeout; timeouts are recorded in the trajectory but do not block\n * other handlers. A handler that throws is recorded as `cleanup_error`;\n * subsequent handlers still execute. See constraints.md §5.2 / spec.md §6.8.\n */\n\nimport type { CleanupFn, TrajectoryLogger } from './types.js'\n\nconst HANDLER_TIMEOUT_MS = 5_000\n\nexport type CleanupRegistry = {\n readonly register: (fn: CleanupFn) => void\n readonly run_all: () => Promise<void>\n}\n\nexport function create_cleanup_registry(trajectory: TrajectoryLogger): CleanupRegistry {\n const handlers: CleanupFn[] = []\n let ran = false\n\n function register(fn: CleanupFn): void {\n if (ran) {\n trajectory.record({\n kind: 'cleanup_registered_after_flush',\n })\n return\n }\n handlers.push(fn)\n }\n\n async function run_all(): Promise<void> {\n if (ran) return\n ran = true\n for (let i = handlers.length - 1; i >= 0; i -= 1) {\n const fn = handlers[i]\n if (!fn) continue\n await run_one(fn, trajectory)\n }\n }\n\n return { register, run_all }\n}\n\nasync function run_one(fn: CleanupFn, trajectory: TrajectoryLogger): Promise<void> {\n let timeout_id: ReturnType<typeof setTimeout> | null = null\n try {\n await new Promise<void>((resolve) => {\n timeout_id = setTimeout(() => {\n trajectory.record({ kind: 'cleanup_timeout', timeout_ms: HANDLER_TIMEOUT_MS })\n resolve()\n }, HANDLER_TIMEOUT_MS)\n \n Promise.resolve()\n .then(() => fn())\n .then(\n () => {\n if (timeout_id) clearTimeout(timeout_id)\n resolve()\n },\n (err: unknown) => {\n if (timeout_id) clearTimeout(timeout_id)\n trajectory.record({\n kind: 'cleanup_error',\n error: err instanceof Error ? err.message : String(err),\n })\n resolve()\n },\n )\n })\n } finally {\n if (timeout_id) clearTimeout(timeout_id)\n }\n}\n","/**\n * Typed errors for the composition layer.\n *\n * This is the only source file in packages/core/src/ that uses the `class`\n * keyword. `Error` is a built-in and `instanceof` branching is how composers\n * like `retry` and `fallback` distinguish failure modes. See constraints.md §2.\n */\n\nexport class timeout_error extends Error {\n readonly kind = 'timeout_error' as const;\n readonly timeout_ms: number;\n constructor(message: string, timeout_ms: number) {\n super(message)\n this.name = 'timeout_error'\n this.timeout_ms = timeout_ms\n }\n}\n\nexport class suspended_error extends Error {\n readonly kind = 'suspended_error' as const;\n readonly suspend_id: string;\n readonly payload: unknown;\n constructor(suspend_id: string, payload: unknown, message?: string) {\n super(message ?? `suspended at ${suspend_id}`)\n this.name = 'suspended_error'\n this.suspend_id = suspend_id\n this.payload = payload\n }\n}\n\nexport class resume_validation_error extends Error {\n readonly kind = 'resume_validation_error' as const;\n readonly issues: unknown;\n constructor(message: string, issues: unknown) {\n super(message)\n this.name = 'resume_validation_error'\n this.issues = issues\n }\n}\n\nexport class describe_cycle_error extends Error {\n readonly kind = 'describe_cycle_error' as const;\n readonly step_id: string;\n constructor(step_id: string, message?: string) {\n super(message ?? `describe: cycle detected at step id: ${step_id}`)\n this.name = 'describe_cycle_error'\n this.step_id = step_id\n }\n}\n\nexport class aborted_error extends Error {\n readonly kind = 'aborted_error' as const;\n readonly reason?: unknown;\n readonly step_index: number;\n readonly tool_call_in_flight?: { id: string; name: string };\n constructor(\n message = 'aborted',\n metadata: {\n reason?: unknown\n step_index?: number\n tool_call_in_flight?: { id: string; name: string }\n } = {},\n ) {\n super(message)\n this.name = 'aborted_error'\n if (metadata.reason !== undefined) this.reason = metadata.reason\n this.step_index = metadata.step_index ?? 0\n if (metadata.tool_call_in_flight !== undefined) {\n this.tool_call_in_flight = metadata.tool_call_in_flight\n }\n }\n}\n\n/**\n * Control-flow signals are not application failures. `suspended_error` is a\n * human-approval gate pausing the run for later resume; `aborted_error` is\n * cancellation. Resilience composers (`retry`, `fallback`) must rethrow these\n * rather than retry past a suspend or run a backup under an aborted context.\n *\n * Kept internal to core: not re-exported by index.ts, so it does not\n * widen the public surface.\n */\nexport function is_control_flow_error(\n err: unknown,\n): err is suspended_error | aborted_error {\n return err instanceof suspended_error || err instanceof aborted_error\n}\n","/**\n * Streaming observation channel.\n *\n * `run.stream(flow, input)` is a secondary entry point returning\n * `{ events, result }`. Events are observed via an async iterable; the result\n * promise resolves once the flow completes. Streaming is purely\n * observational — composers do not know it exists, and `run` and `run.stream`\n * produce identical final results (spec.md §6.7).\n *\n * The event buffer has a default high-water mark of 10,000. When the consumer\n * never iterates, emissions past the mark drop the oldest events and record a\n * single `events_dropped` marker. The `result` promise resolves regardless of\n * buffer pressure.\n */\n\nimport type { TrajectoryEvent, TrajectoryLogger } from './types.js'\n\nexport const STREAMING_HIGH_WATER_MARK = 10_000\n\nexport type StreamingChannel = {\n readonly logger: TrajectoryLogger\n readonly events: AsyncIterable<TrajectoryEvent>\n readonly close: () => void\n}\n\nexport function create_streaming_channel(\n base: TrajectoryLogger,\n high_water_mark = STREAMING_HIGH_WATER_MARK,\n): StreamingChannel {\n const buffer: TrajectoryEvent[] = []\n let dropped = 0\n let closed = false\n let marker_emitted = false\n let waiter: ((value: IteratorResult<TrajectoryEvent>) => void) | null = null\n\n function enqueue(event: TrajectoryEvent): void {\n if (closed) return\n if (waiter) {\n const resolve = waiter\n waiter = null\n resolve({ value: event, done: false })\n return\n }\n if (buffer.length >= high_water_mark) {\n buffer.shift()\n dropped += 1\n return\n }\n buffer.push(event)\n }\n\n function close(): void {\n if (closed) return\n closed = true\n if (dropped > 0 && !marker_emitted) {\n marker_emitted = true\n buffer.push({ kind: 'events_dropped', count: dropped })\n }\n if (waiter) {\n const resolve = waiter\n waiter = null\n resolve({ value: undefined, done: true })\n }\n }\n\n const logger: TrajectoryLogger = {\n record: (event) => {\n base.record(event)\n enqueue(event)\n },\n start_span: (name, meta) => {\n const id = base.start_span(name, meta)\n enqueue({ kind: 'span_start', span_id: id, name, ...meta })\n return id\n },\n end_span: (id, meta) => {\n base.end_span(id, meta)\n enqueue({ kind: 'span_end', span_id: id, ...meta })\n },\n }\n\n const events: AsyncIterable<TrajectoryEvent> = {\n [Symbol.asyncIterator]() {\n return {\n next(): Promise<IteratorResult<TrajectoryEvent>> {\n if (buffer.length > 0) {\n const next_event = buffer.shift()\n if (next_event !== undefined) {\n return Promise.resolve({ value: next_event, done: false })\n }\n }\n if (closed) {\n return Promise.resolve({ value: undefined, done: true })\n }\n return new Promise<IteratorResult<TrajectoryEvent>>((resolve) => {\n waiter = resolve\n })\n },\n return(): Promise<IteratorResult<TrajectoryEvent>> {\n close()\n return Promise.resolve({ value: undefined, done: true })\n },\n }\n },\n }\n\n return { logger, events, close }\n}\n","/**\n * Runner.\n *\n * Dispatches a step to its kind-specific handler. `runner.ts` contains no\n * composer-specific logic beyond a Map lookup on `step.kind`; each composer\n * file registers its handler at module load via `register_kind(...)`.\n *\n * `run(flow, input, options?)` constructs a fresh `RunContext` per top-level\n * call, installs process signal handlers (opt-out via options), forwards an\n * optional caller-supplied `AbortSignal` into the run, and guarantees cleanup\n * handlers execute in LIFO order on success, failure, or abort.\n *\n * `run.stream(flow, input, options?)` is a secondary entry point returning\n * `{ events, result }`. Streaming is purely observational; the step graph is\n * identical to `run(...)`.\n */\n\nimport { randomUUID } from 'node:crypto'\nimport { create_cleanup_registry } from './cleanup.js'\nimport { aborted_error } from './errors.js'\nimport { create_streaming_channel, STREAMING_HIGH_WATER_MARK } from './streaming.js'\nimport type {\n CheckpointStore,\n RunContext,\n Step,\n TrajectoryEvent,\n TrajectoryLogger,\n} from './types.js'\n\ntype Dispatcher = (\n flow: Step<unknown, unknown>,\n input: unknown,\n ctx: RunContext,\n) => Promise<unknown>\n\nconst dispatch = new Map<string, Dispatcher>()\n\nexport function register_kind(kind: string, fn: Dispatcher): void {\n dispatch.set(kind, fn)\n}\n\n/**\n * Resolve the trajectory span label for a step. Prefers a non-empty\n * `display_name` from `flow.config`; otherwise falls back to the supplied\n * default (typically the step's `kind`).\n *\n * Dispatch handlers use this so that any composer carrying a user-supplied\n * `name` surfaces under that label in the trajectory, while unconfigured\n * composers retain their kind-based label.\n */\nexport function resolve_span_label(\n flow: Step<unknown, unknown>,\n fallback: string,\n): string {\n const display = flow.config?.['display_name']\n return typeof display === 'string' && display.length > 0 ? display : fallback\n}\n\n/**\n * Register the standard span-wrapping dispatch handler for a composer kind.\n *\n * Every composer wraps `flow.run` in a span identically; this centralizes that\n * boilerplate and threads span parentage: the span opens with the current\n * `ctx.parent_span_id` as its parent, and `flow.run` receives a child context\n * whose `parent_span_id` is this span. Children dispatched from within\n * (including concurrent ones under `parallel`/`map`, which spread the context)\n * therefore nest correctly instead of leaving `parent_span_id` unpopulated.\n */\nexport function register_traced_kind(kind: string): void {\n register_kind(kind, async (flow, input, ctx) => {\n const label = resolve_span_label(flow, kind)\n const span_meta: Record<string, unknown> = { id: flow.id }\n if (ctx.parent_span_id !== undefined) {\n span_meta['parent_span_id'] = ctx.parent_span_id\n }\n const span_id = ctx.trajectory.start_span(label, span_meta)\n const child_ctx: RunContext = { ...ctx, parent_span_id: span_id }\n try {\n const out = await flow.run(input, child_ctx)\n ctx.trajectory.end_span(span_id, { id: flow.id })\n return out\n } catch (err) {\n ctx.trajectory.end_span(span_id, {\n id: flow.id,\n error: err instanceof Error ? err.message : String(err),\n })\n throw err\n }\n })\n}\n\nexport type RunOptions = {\n readonly install_signal_handlers?: boolean\n readonly trajectory?: TrajectoryLogger\n readonly checkpoint_store?: CheckpointStore\n readonly resume_data?: Readonly<Record<string, unknown>>\n // A caller-owned cancellation source (HTTP request, queue shutdown, MCP\n // request, AbortSignal.timeout). When it fires the run aborts with its\n // reason, composing with the internal controller and the process signal\n // handlers rather than replacing them.\n readonly abort?: AbortSignal\n}\n\nexport type StreamingRunHandle<o> = {\n readonly events: AsyncIterable<TrajectoryEvent>\n readonly result: Promise<o>\n}\n\nconst active_runs = new Set<AbortController>()\nlet signal_handler_installed = false\nlet sigint_handler: (() => void) | null = null\nlet sigterm_handler: (() => void) | null = null\n\nfunction ensure_signal_handlers(): void {\n if (signal_handler_installed) return\n signal_handler_installed = true\n const abort_all = (signal_name: string) => () => {\n for (const controller of active_runs) {\n controller.abort(new aborted_error(`received ${signal_name}`, { reason: { signal: signal_name } }))\n }\n }\n sigint_handler = abort_all('SIGINT')\n sigterm_handler = abort_all('SIGTERM')\n process.on('SIGINT', sigint_handler)\n process.on('SIGTERM', sigterm_handler)\n}\n\nfunction release_signal_handlers(): void {\n if (!signal_handler_installed) return\n if (active_runs.size > 0) return\n signal_handler_installed = false\n if (sigint_handler) process.off('SIGINT', sigint_handler)\n if (sigterm_handler) process.off('SIGTERM', sigterm_handler)\n sigint_handler = null\n sigterm_handler = null\n}\n\nconst noop_logger: TrajectoryLogger = {\n record: () => {},\n start_span: (name) => `${name}:${randomUUID().slice(0, 8)}`,\n end_span: () => {},\n}\n\n/**\n * Wrap a logger so every emitted event automatically carries `run_id` and a\n * `ts` (epoch milliseconds) stamped at emission.\n *\n * Studios and other downstream consumers multiplex events across runs by\n * `run_id` and reconstruct real timing from `ts` instead of fabricating it at\n * ingest. Either field already present on an event or its meta is preserved;\n * we never overwrite a caller-supplied value.\n */\nfunction decorate_logger(inner: TrajectoryLogger, run_id: string): TrajectoryLogger {\n const stamp_meta = (\n meta: Record<string, unknown> | undefined,\n ): Record<string, unknown> => {\n const out: Record<string, unknown> = { ...meta }\n if (!('run_id' in out)) out['run_id'] = run_id\n if (!('ts' in out)) out['ts'] = Date.now()\n return out\n }\n return {\n record: (event) => {\n if ('run_id' in event && 'ts' in event) {\n inner.record(event)\n return\n }\n const extra: Record<string, unknown> = {}\n if (!('run_id' in event)) extra['run_id'] = run_id\n if (!('ts' in event)) extra['ts'] = Date.now()\n inner.record({ ...event, ...extra })\n },\n start_span: (name, meta) => inner.start_span(name, stamp_meta(meta)),\n end_span: (id, meta) => {\n inner.end_span(id, stamp_meta(meta))\n },\n }\n}\n\nexport async function dispatch_step<i, o>(\n flow: Step<i, o>,\n input: i,\n ctx: RunContext,\n): Promise<o> {\n const handler = dispatch.get(flow.kind)\n if (!handler) {\n throw new Error(`unknown step kind: ${flow.kind} (step id: ${flow.id})`)\n }\n try {\n const result = await handler(flow, input, ctx)\n // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n return result as o\n } catch (err) {\n prepend_path(err, flow.id)\n throw err\n }\n}\n\nexport function prepend_path(err: unknown, id: string): void {\n if (err === null || typeof err !== 'object') return\n const existing = Reflect.get(err, 'path')\n const next: string[] = Array.isArray(existing)\n ? [id, ...existing.filter((v): v is string => typeof v === 'string')]\n : [id]\n Reflect.set(err, 'path', next)\n}\n\n/**\n * Throw the abort reason if the context has been cancelled. Composers that\n * iterate over children (`sequence`, `scope`, `loop`) call this between steps\n * so a pending abort is honored before the next child starts, not only when a\n * downstream dispatch happens to observe it.\n */\nexport function throw_if_aborted(ctx: RunContext): void {\n if (!ctx.abort.aborted) return\n const reason = ctx.abort.reason\n throw reason instanceof Error ? reason : new aborted_error('aborted', { reason })\n}\n\n/**\n * Forward a caller-owned AbortSignal into the run's internal controller and\n * return an unlink function. The reason is preserved so the original\n * cancellation cause propagates out of `run`. The listener is `once` and the\n * returned unlink is called when the run settles, so a long-lived host (an MCP\n * server, an HTTP worker) firing many short runs against one external signal\n * does not accumulate listeners.\n */\nfunction link_external_abort(\n controller: AbortController,\n external: AbortSignal | undefined,\n): () => void {\n if (external === undefined) return () => {}\n if (external.aborted) {\n controller.abort(external.reason)\n return () => {}\n }\n const on_abort = (): void => {\n controller.abort(external.reason)\n }\n external.addEventListener('abort', on_abort, { once: true })\n return () => {\n external.removeEventListener('abort', on_abort)\n }\n}\n\ntype StartResult<o> = {\n readonly events: AsyncIterable<TrajectoryEvent>\n readonly result: Promise<o>\n}\n\nfunction start_run<i, o>(\n flow: Step<i, o>,\n input: i,\n options: RunOptions,\n high_water_mark: number | null,\n): StartResult<o> {\n const install_signal_handlers = options.install_signal_handlers !== false\n const base_logger = options.trajectory ?? noop_logger\n const streaming = high_water_mark !== null\n\n const controller = new AbortController()\n const unlink_abort = link_external_abort(controller, options.abort)\n const run_id = randomUUID()\n\n let stream_events: AsyncIterable<TrajectoryEvent> = empty_async_iterable()\n let close_stream: (() => void) | null = null\n let inner: TrajectoryLogger = base_logger\n\n if (streaming) {\n // Decorate must wrap the streaming channel, not the reverse: the channel\n // enqueues a copy of each event for `run.stream` consumers, so it has to\n // see the events after `decorate_logger` has stamped `ts` and `run_id`.\n const channel = create_streaming_channel(base_logger, high_water_mark)\n inner = channel.logger\n stream_events = channel.events\n close_stream = channel.close\n }\n\n const logger: TrajectoryLogger = decorate_logger(inner, run_id)\n\n const cleanup = create_cleanup_registry(logger)\n\n const ctx: RunContext = {\n run_id,\n trajectory: logger,\n state: new Map(),\n abort: controller.signal,\n emit: (event) => {\n logger.record({ ...event, kind: 'emit' })\n },\n on_cleanup: (fn) => {\n cleanup.register(fn)\n },\n checkpoint_store: options.checkpoint_store,\n resume_data: options.resume_data,\n streaming,\n }\n\n active_runs.add(controller)\n if (install_signal_handlers) {\n ensure_signal_handlers()\n }\n\n const result = (async (): Promise<o> => {\n try {\n // Honor an external signal that was already aborted at call time, so the\n // run rejects without dispatching even when the flow is a single leaf\n // step that never reaches a cooperative abort check.\n throw_if_aborted(ctx)\n return await dispatch_step(flow, input, ctx)\n } catch (err) {\n if (controller.signal.aborted && !(err instanceof aborted_error)) {\n const reason = controller.signal.reason\n if (reason instanceof aborted_error) throw reason\n }\n throw err\n } finally {\n try {\n await cleanup.run_all()\n } finally {\n unlink_abort()\n active_runs.delete(controller)\n release_signal_handlers()\n if (close_stream) close_stream()\n }\n }\n })()\n\n return { events: stream_events, result }\n}\n\nfunction empty_async_iterable(): AsyncIterable<TrajectoryEvent> {\n return {\n [Symbol.asyncIterator]() {\n return {\n next: (): Promise<IteratorResult<TrajectoryEvent>> =>\n Promise.resolve({ value: undefined, done: true } as IteratorResult<TrajectoryEvent>),\n }\n },\n }\n}\n\nasync function run_impl<i, o>(\n flow: Step<i, o>,\n input: i,\n options: RunOptions = {},\n): Promise<o> {\n const { result } = start_run(flow, input, options, null)\n return result\n}\n\nfunction run_stream<i, o>(\n flow: Step<i, o>,\n input: i,\n options: RunOptions = {},\n): StreamingRunHandle<o> {\n const { events, result } = start_run(flow, input, options, STREAMING_HIGH_WATER_MARK)\n return { events, result }\n}\n\nexport const run: typeof run_impl & { stream: typeof run_stream } = Object.assign(run_impl, {\n stream: run_stream,\n})\n","/**\n * step() factory.\n *\n * Three forms:\n * step(id, fn) — named step. id is rendered in trajectory spans and describe().\n * step(id, fn, meta) — named step with optional human-readable metadata for studio,\n * codegen, and similar consumers. `meta` is purely descriptive\n * and never affects runtime semantics.\n * step(fn) — anonymous step. id is `anon_<counter>`; cannot be checkpointed.\n *\n * Anonymous steps carry an internal `anonymous: true` flag so checkpoint can\n * reject them synchronously at flow construction time (spec.md §9 F6 / §7 invariant 8).\n */\n\nimport { register_traced_kind } from './runner.js'\nimport type { Step, StepFn, StepMetadata } from './types.js'\n\nlet anon_counter = 0\n\nfunction next_anon_id(): string {\n anon_counter += 1\n return `anon_${anon_counter}`\n}\n\nexport function step<i, o>(id: string, fn: StepFn<i, o>, meta?: StepMetadata): Step<i, o>\nexport function step<i, o>(fn: StepFn<i, o>): Step<i, o>\nexport function step<i, o>(\n id_or_fn: string | StepFn<i, o>,\n maybe_fn?: StepFn<i, o>,\n meta?: StepMetadata,\n): Step<i, o> {\n if (typeof id_or_fn === 'function') {\n return {\n id: next_anon_id(),\n kind: 'step',\n run: id_or_fn,\n anonymous: true,\n }\n }\n if (typeof maybe_fn !== 'function') {\n throw new TypeError('step(id, fn): fn must be a function')\n }\n if (meta) {\n return {\n id: id_or_fn,\n kind: 'step',\n run: maybe_fn,\n meta,\n }\n }\n return {\n id: id_or_fn,\n kind: 'step',\n run: maybe_fn,\n }\n}\n\nregister_traced_kind('step')\n","/**\n * is_step: structural Step check.\n *\n * Steps are plain objects with no brand symbol, so runtime detection is\n * structural: string `id`, string `kind`, callable `run`. Used by describe()\n * to render Step references and by combinators to validate arguments at\n * construction time.\n */\n\nimport type { Step } from './types.js'\n\nexport function is_step(value: unknown): value is Step<unknown, unknown> {\n if (typeof value !== 'object' || value === null) return false\n if (!('id' in value) || !('kind' in value) || !('run' in value)) return false\n const { id, kind, run } = value\n return typeof id === 'string' && typeof kind === 'string' && typeof run === 'function'\n}\n","/**\n * describe(step) and describe.json(step) — composition introspection.\n *\n * `describe(step)` is the text-tree renderer. Multi-line string with\n * hierarchical indentation. Function values render as `<fn>` (or\n * `<fn:name>` when the function has a non-empty `name`); zod schemas\n * render as `<schema>`.\n *\n * `describe.json(step)` returns a `FlowNode` tree (kind, id, config, children)\n * for tooling (Studio UI, Mermaid renderers, diff tools). Function values\n * serialize as `{ kind: '<fn>', name? }` and schemas as `{ kind: '<schema>' }`.\n *\n * Both forms detect cycles. Under the default (loose) mode, back-references\n * render as `<cycle>(id)` in text and `{ kind: '<cycle>', id }` in JSON. Under\n * `{ strict: true }`, cycles throw `describe_cycle_error`.\n */\n\nimport { describe_cycle_error } from './errors.js'\nimport { is_step } from './is_step.js'\nimport type { Step, StepMetadata } from './types.js'\n\nconst INDENT = ' '\n\nexport type FlowValue =\n | string\n | number\n | boolean\n | null\n | ReadonlyArray<FlowValue>\n | Readonly<{ [key: string]: FlowValue }>\n | { readonly kind: '<fn>'; readonly name?: string }\n | { readonly kind: '<schema>' }\n | { readonly kind: string; readonly id: string }\n\nexport type FlowNode = {\n readonly kind: string\n readonly id: string\n readonly config?: Readonly<{ [key: string]: FlowValue }>\n readonly children?: ReadonlyArray<FlowNode>\n readonly meta?: StepMetadata\n}\n\nexport type DescribeOptions = {\n readonly strict?: boolean\n}\n\ntype Path = Set<Step<unknown, unknown>>\n\nfunction describe_text<i, o>(root: Step<i, o>, options?: DescribeOptions): string {\n const lines: string[] = []\n const strict = Boolean(options?.strict)\n render_text(root, 0, lines, new Set(), strict)\n return lines.join('\\n')\n}\n\nfunction describe_json<i, o>(root: Step<i, o>, options?: DescribeOptions): FlowNode {\n const strict = Boolean(options?.strict)\n return render_json(root, new Set(), strict)\n}\n\nexport const describe: {\n <i, o>(root: Step<i, o>, options?: DescribeOptions): string\n json: <i, o>(root: Step<i, o>, options?: DescribeOptions) => FlowNode\n} = Object.assign(describe_text, { json: describe_json })\n\nfunction render_text(\n node: Step<unknown, unknown>,\n depth: number,\n lines: string[],\n path: Path,\n strict: boolean,\n): void {\n const prefix = INDENT.repeat(depth)\n if (path.has(node)) {\n if (strict) throw new describe_cycle_error(node.id)\n lines.push(`${prefix}<cycle>(${node.id})`)\n return\n }\n path.add(node)\n try {\n const display = node.config?.['display_name']\n const label = typeof display === 'string' && display.length > 0 ? display : node.kind\n lines.push(`${prefix}${label}(${node.id})`)\n if (node.config) {\n for (const [key, value] of Object.entries(node.config)) {\n if (key === 'display_name') continue\n lines.push(`${prefix}${INDENT}${key}: ${render_value_text(value, path, strict)}`)\n }\n }\n if (node.children && node.children.length > 0) {\n for (const child of node.children) {\n render_text(child, depth + 1, lines, path, strict)\n }\n }\n } finally {\n path.delete(node)\n }\n}\n\nfunction render_value_text(value: unknown, path: Path, strict: boolean): string {\n if (typeof value === 'function') {\n const name = typeof value.name === 'string' && value.name.length > 0 ? value.name : ''\n return name ? `<fn:${name}>` : '<fn>'\n }\n if (value === null) return 'null'\n if (value === undefined) return 'undefined'\n if (is_zod_schema(value)) return '<schema>'\n if (is_step(value)) {\n if (path.has(value)) {\n if (strict) throw new describe_cycle_error(value.id)\n return `<cycle>(${value.id})`\n }\n return `${value.kind}(${value.id})`\n }\n if (Array.isArray(value)) {\n return `[${value.map((item: unknown) => render_value_text(item, path, strict)).join(', ')}]`\n }\n if (typeof value === 'object') {\n const entries = Object.entries({ ...value }).map(\n ([k, v]: [string, unknown]) => `${k}: ${render_value_text(v, path, strict)}`,\n )\n return `{ ${entries.join(', ')} }`\n }\n if (typeof value === 'string') return JSON.stringify(value)\n if (typeof value === 'bigint') return `${value.toString()}n`\n if (typeof value === 'symbol') return value.toString()\n if (typeof value === 'number' || typeof value === 'boolean') return String(value)\n return JSON.stringify(value)\n}\n\nfunction render_json(\n node: Step<unknown, unknown>,\n path: Path,\n strict: boolean,\n): FlowNode {\n if (path.has(node)) {\n if (strict) throw new describe_cycle_error(node.id)\n return { kind: '<cycle>', id: node.id }\n }\n path.add(node)\n try {\n const result: {\n kind: string\n id: string\n config?: { [key: string]: FlowValue }\n children?: FlowNode[]\n meta?: StepMetadata\n } = { kind: node.kind, id: node.id }\n if (node.config) {\n const config: { [key: string]: FlowValue } = {}\n for (const [key, value] of Object.entries(node.config)) {\n config[key] = render_value_json(value, path, strict)\n }\n result.config = config\n }\n if (node.children && node.children.length > 0) {\n result.children = node.children.map((child) => render_json(child, path, strict))\n }\n if (node.meta) {\n result.meta = node.meta\n }\n return result\n } finally {\n path.delete(node)\n }\n}\n\nfunction render_value_json(value: unknown, path: Path, strict: boolean): FlowValue {\n if (typeof value === 'function') {\n const name = typeof value.name === 'string' && value.name.length > 0 ? value.name : ''\n return name ? { kind: '<fn>', name } : { kind: '<fn>' }\n }\n if (value === null) return null\n if (value === undefined) return null\n if (is_zod_schema(value)) return { kind: '<schema>' }\n if (is_step(value)) {\n if (path.has(value)) {\n if (strict) throw new describe_cycle_error(value.id)\n return { kind: '<cycle>', id: value.id }\n }\n return { kind: value.kind, id: value.id }\n }\n if (Array.isArray(value)) {\n return value.map((item: unknown) => render_value_json(item, path, strict))\n }\n if (typeof value === 'object') {\n const out: { [key: string]: FlowValue } = {}\n for (const [k, v] of Object.entries({ ...value })) {\n out[k] = render_value_json(v, path, strict)\n }\n return out\n }\n if (typeof value === 'string') return value\n if (typeof value === 'number' || typeof value === 'boolean') return value\n if (typeof value === 'bigint') return `${value.toString()}n`\n if (typeof value === 'symbol') return value.toString()\n return JSON.stringify(value)\n}\n\nfunction is_zod_schema(value: unknown): boolean {\n if (typeof value !== 'object' || value === null) return false\n return '_zod' in value || '_def' in value\n}\n","/**\n * sequence: chain child outputs.\n *\n * `sequence([a, b, c])` runs a, b, c in declared order. The input to sequence\n * is passed to the first child; each subsequent child receives the previous\n * child's output. The composer returns the last child's output.\n *\n * See spec.md §5.2 and §6.1.\n */\n\nimport { is_step } from './is_step.js'\nimport { dispatch_step, register_traced_kind, throw_if_aborted } from './runner.js'\nimport type { RunContext, Step } from './types.js'\n\ntype AnyStep = Step<unknown, unknown>\n\ntype FirstInput<children> = children extends readonly [Step<infer i, unknown>, ...unknown[]]\n ? i\n : unknown\n\ntype LastOutput<children> = children extends readonly [...unknown[], Step<unknown, infer o>]\n ? o\n : children extends readonly [Step<unknown, infer o>]\n ? o\n : unknown\n\nlet sequence_counter = 0\n\nfunction next_id(): string {\n sequence_counter += 1\n return `sequence_${sequence_counter}`\n}\n\nexport type SequenceOptions = {\n readonly name?: string\n}\n\nexport function sequence<const children extends readonly AnyStep[]>(\n children: children,\n options?: SequenceOptions,\n): Step<FirstInput<children>, LastOutput<children>> {\n if (!Array.isArray(children)) {\n throw new TypeError(\n `sequence(children): children must be an array of Steps, got ${typeof children} — sequence takes a single array, e.g. sequence([a, b, c])`,\n )\n }\n children.forEach((child, index) => {\n if (is_step(child)) return\n const hint =\n typeof child === 'function'\n ? ' — wrap plain functions with step(fn), or use pipe(inner, fn) to transform output'\n : ''\n throw new TypeError(\n `sequence(children): children[${index}] is not a Step, got ${typeof child}${hint}`,\n )\n })\n\n const id = next_id()\n const children_ref = children\n const run_fn = async (input: unknown, ctx: RunContext): Promise<unknown> => {\n let acc: unknown = input\n for (const child of children_ref) {\n throw_if_aborted(ctx)\n acc = await dispatch_step(child, acc, ctx)\n }\n return acc\n }\n\n const config_meta: Record<string, unknown> | undefined =\n options?.name === undefined ? undefined : { display_name: options.name }\n\n // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n return {\n id,\n kind: 'sequence',\n children,\n ...(config_meta ? { config: config_meta } : {}),\n run: run_fn,\n } as Step<FirstInput<children>, LastOutput<children>>\n}\n\nregister_traced_kind('sequence')\n","/**\n * parallel: concurrent execution of named children.\n *\n * `parallel({ a, b })` runs a and b concurrently with the same input. Output\n * is an object keyed by the child name; all children must accept the same\n * input type.\n *\n * Cancellation (constraints.md §5.1, spec.md §6.8): each child runs with a\n * composed abort signal — `AbortSignal.any([ctx.abort, child_local])`. On\n * abort the composer awaits all in-flight children (success, failure, or\n * aborted) before rethrowing `ctx.abort.reason`. This matches the\n * \"agent-pattern\" composer contract in spec.md §6.8.\n *\n * When several children fail, a `suspended_error` is preferred over an\n * application error so a human-approval gate inside a branch stays resumable\n * rather than being masked by a sibling's failure. Otherwise the first error\n * in declared order propagates.\n */\n\nimport { aborted_error, suspended_error } from './errors.js'\nimport { dispatch_step, register_traced_kind } from './runner.js'\nimport type { RunContext, Step } from './types.js'\n\ntype AnyStep = Step<unknown, unknown>\n\ntype OutputOf<s> = s extends Step<unknown, infer o> ? o : unknown\n\ntype ParallelOutputs<children extends Record<string, AnyStep>> = {\n [k in keyof children]: OutputOf<children[k]>\n}\n\nlet parallel_counter = 0\n\nfunction next_id(): string {\n parallel_counter += 1\n return `parallel_${parallel_counter}`\n}\n\nexport type ParallelOptions = {\n readonly name?: string\n}\n\nexport function parallel<i, children extends Record<string, Step<i, unknown>>>(\n members: children,\n options?: ParallelOptions,\n): Step<i, ParallelOutputs<children>> {\n const id = next_id()\n const entries: ReadonlyArray<readonly [string, AnyStep]> = Object.entries(members)\n const child_list: ReadonlyArray<AnyStep> = entries.map(([, s]) => s)\n const keys: ReadonlyArray<string> = entries.map(([k]) => k)\n\n const run_fn = async (input: i, ctx: RunContext): Promise<ParallelOutputs<children>> => {\n const controllers = entries.map(() => new AbortController())\n const on_parent_abort = (): void => {\n for (const c of controllers) c.abort(ctx.abort.reason)\n }\n if (ctx.abort.aborted) {\n on_parent_abort()\n } else {\n ctx.abort.addEventListener('abort', on_parent_abort, { once: true })\n }\n \n try {\n const settled = await Promise.all(\n entries.map(async ([key, child], idx) => {\n const local = controllers[idx]\n if (!local) throw new Error('parallel: missing controller')\n const composed = AbortSignal.any([ctx.abort, local.signal])\n const child_ctx: RunContext = { ...ctx, abort: composed }\n try {\n const value = await dispatch_step(child, input, child_ctx)\n return { status: 'ok' as const, key, value }\n } catch (err) {\n return { status: 'err' as const, key, err }\n }\n }),\n )\n \n if (ctx.abort.aborted) {\n const reason = ctx.abort.reason\n throw reason instanceof Error ? reason : new aborted_error('aborted', { reason })\n }\n\n let first_err: unknown\n let has_err = false\n let suspended: unknown\n let has_suspended = false\n for (const s of settled) {\n if (s.status !== 'err') continue\n if (!has_err) {\n first_err = s.err\n has_err = true\n }\n if (!has_suspended && s.err instanceof suspended_error) {\n suspended = s.err\n has_suspended = true\n }\n }\n if (has_suspended) throw suspended\n if (has_err) throw first_err\n \n const out: Record<string, unknown> = {}\n for (const s of settled) {\n if (s.status === 'ok') out[s.key] = s.value\n }\n // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n return out as ParallelOutputs<children>\n } finally {\n ctx.abort.removeEventListener('abort', on_parent_abort)\n }\n }\n\n const config_meta: Record<string, unknown> = { keys }\n if (options?.name !== undefined) config_meta['display_name'] = options.name\n\n return {\n id,\n kind: 'parallel',\n children: child_list,\n config: config_meta,\n run: run_fn,\n }\n}\n\nregister_traced_kind('parallel')\n","/**\n * branch: conditional routing.\n *\n * `branch({ when, then, otherwise })` evaluates `when(input)`; if truthy, runs\n * `then`, else runs `otherwise`. Both branches must return the same output\n * type.\n *\n * See spec.md §5.4.\n */\n\nimport { dispatch_step, register_traced_kind } from './runner.js'\nimport type { RunContext, Step } from './types.js'\n\nexport type BranchConfig<i, o> = {\n readonly name?: string\n readonly when: (input: i) => boolean | Promise<boolean>\n readonly then: Step<i, o>\n readonly otherwise: Step<i, o>\n}\n\nlet branch_counter = 0\n\nfunction next_id(): string {\n branch_counter += 1\n return `branch_${branch_counter}`\n}\n\nexport function branch<i, o>(config: BranchConfig<i, o>): Step<i, o> {\n const id = next_id()\n const { when, then: then_step, otherwise: otherwise_step, name } = config\n\n const run_fn = async (input: i, ctx: RunContext): Promise<o> => {\n const cond = await when(input)\n const next_step = cond ? then_step : otherwise_step\n return dispatch_step(next_step, input, ctx)\n }\n\n const config_meta: Record<string, unknown> = { when, then: then_step, otherwise: otherwise_step }\n if (name !== undefined) config_meta['display_name'] = name\n\n return {\n id,\n kind: 'branch',\n children: [then_step, otherwise_step],\n config: config_meta,\n run: run_fn,\n }\n}\n\nregister_traced_kind('branch')\n","/**\n * map: per-item execution.\n *\n * `map({ items, do, concurrency? })` extracts an array via `items(input)`,\n * runs `do` once per element, returns an array in the same order as inputs.\n * `concurrency` caps simultaneous in-flight items; omitted means full\n * parallelism.\n *\n * Cancellation (constraints.md §5.1, spec.md §6.8): each in-flight item runs\n * with a composed abort signal via `AbortSignal.any([ctx.abort, child_local])`.\n * On abort no new items start. The composer awaits all in-flight items before\n * rethrowing `ctx.abort.reason`.\n */\n\nimport { aborted_error } from './errors.js'\nimport { dispatch_step, register_traced_kind } from './runner.js'\nimport type { RunContext, Step } from './types.js'\n\nexport type MapConfig<input, item, result> = {\n readonly name?: string\n readonly items: (input: input) => ReadonlyArray<item> | Promise<ReadonlyArray<item>>\n readonly do: Step<item, result>\n readonly concurrency?: number\n}\n\nlet map_counter = 0\n\nfunction next_id(): string {\n map_counter += 1\n return `map_${map_counter}`\n}\n\nexport function map<input, item, result>(\n config: MapConfig<input, item, result>,\n): Step<input, result[]> {\n const id = next_id()\n const { items, do: per_item, concurrency, name } = config\n\n const run_fn = async (input: input, ctx: RunContext): Promise<result[]> => {\n const list = await items(input)\n if (list.length === 0) return []\n const results: result[] = Array.from({ length: list.length })\n \n const limit = concurrency === undefined ? list.length : Math.max(1, concurrency)\n const controllers: AbortController[] = []\n \n const on_parent_abort = (): void => {\n for (const c of controllers) c.abort(ctx.abort.reason)\n }\n if (ctx.abort.aborted) {\n on_parent_abort()\n } else {\n ctx.abort.addEventListener('abort', on_parent_abort, { once: true })\n }\n \n let cursor = 0\n let worker_error: unknown = undefined\n \n const run_one = async (idx: number): Promise<void> => {\n const local = new AbortController()\n controllers.push(local)\n const composed = AbortSignal.any([ctx.abort, local.signal])\n const child_ctx: RunContext = { ...ctx, abort: composed }\n const item_value = list[idx]\n // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n const value = await dispatch_step(per_item, item_value as item, child_ctx)\n results[idx] = value\n }\n \n const worker = async (): Promise<void> => {\n while (true) {\n if (ctx.abort.aborted || worker_error !== undefined) return\n const idx = cursor\n cursor += 1\n if (idx >= list.length) return\n try {\n await run_one(idx)\n } catch (err) {\n if (worker_error === undefined) worker_error = err\n return\n }\n }\n }\n \n try {\n const worker_count = Math.min(limit, list.length)\n const workers: Promise<void>[] = []\n for (let w = 0; w < worker_count; w += 1) {\n workers.push(worker())\n }\n await Promise.all(workers)\n \n if (ctx.abort.aborted) {\n const reason = ctx.abort.reason\n throw reason instanceof Error ? reason : new aborted_error('aborted', { reason })\n }\n if (worker_error !== undefined) throw worker_error\n \n return results\n } finally {\n ctx.abort.removeEventListener('abort', on_parent_abort)\n }\n }\n\n const config_meta: Record<string, unknown> = { items }\n if (concurrency !== undefined) config_meta['concurrency'] = concurrency\n if (name !== undefined) config_meta['display_name'] = name\n\n return {\n id,\n kind: 'map',\n children: [per_item],\n config: config_meta,\n run: run_fn,\n }\n}\n\nregister_traced_kind('map')\n","/**\n * pipe: transform output.\n *\n * `pipe(inner, fn)` runs `inner`, passes its output to `fn`, returns `fn`'s\n * result. Use for shape adaptation when composing heterogeneous steps.\n *\n * See spec.md §5.6.\n */\n\nimport { is_step } from './is_step.js'\nimport { dispatch_step, register_traced_kind } from './runner.js'\nimport type { RunContext, Step } from './types.js'\n\nlet pipe_counter = 0\n\nfunction next_id(): string {\n pipe_counter += 1\n return `pipe_${pipe_counter}`\n}\n\nexport type PipeOptions = {\n readonly name?: string\n}\n\nexport function pipe<i, a, b>(\n inner: Step<i, a>,\n fn: (value: a) => b | Promise<b>,\n options?: PipeOptions,\n): Step<i, b> {\n if (!is_step(inner)) {\n const hint = typeof inner === 'function' ? ' — wrap plain functions with step(fn)' : ''\n throw new TypeError(`pipe(inner, fn): inner must be a Step, got ${typeof inner}${hint}`)\n }\n if (typeof fn !== 'function') {\n if (is_step(fn)) {\n throw new TypeError(\n 'pipe(inner, fn): fn must be a function, got a Step — pipe is not variadic; to chain Steps use sequence([...])',\n )\n }\n throw new TypeError(`pipe(inner, fn): fn must be a function, got ${typeof fn}`)\n }\n if (is_step(options)) {\n throw new TypeError(\n 'pipe(inner, fn, options): got a Step as the third argument — pipe is not variadic; to chain Steps use sequence([...])',\n )\n }\n\n const id = next_id()\n\n const run_fn = async (input: i, ctx: RunContext): Promise<b> => {\n const intermediate = await dispatch_step(inner, input, ctx)\n return fn(intermediate)\n }\n\n const config_meta: Record<string, unknown> = { fn }\n if (options?.name !== undefined) config_meta['display_name'] = options.name\n\n return {\n id,\n kind: 'pipe',\n children: [inner],\n config: config_meta,\n run: run_fn,\n }\n}\n\nregister_traced_kind('pipe')\n","/**\n * retry: re-run on failure.\n *\n * `retry(inner, { max_attempts, backoff_ms?, on_error? })` runs `inner`. If it\n * throws an application error, retries up to `max_attempts - 1` more times with\n * exponential backoff (`backoff_ms * 2^(attempt-1)`). `on_error` is called on\n * every such failure. The last error is rethrown if all attempts fail.\n *\n * Control-flow signals (`suspended_error`, `aborted_error`) are not failures:\n * they propagate immediately without consuming an attempt, firing `on_error`,\n * or scheduling a backoff. A suspend's `on()` side effect therefore runs once\n * per run, not once per attempt.\n *\n * Cancellation / cleanup (constraints.md §5.2, spec.md §6.8): cleanup handlers\n * registered by the inner step accumulate across attempts. The parent\n * `ctx.abort` is honored between attempts — a pending abort short-circuits\n * the backoff and propagates. See spec.md §5.7 and §9 F11.\n */\n\nimport { aborted_error, is_control_flow_error } from './errors.js'\nimport { dispatch_step, register_traced_kind } from './runner.js'\nimport type { RunContext, Step } from './types.js'\n\nconst DEFAULT_BACKOFF_MS = 1_000\n\nexport type RetryConfig = {\n readonly name?: string\n readonly max_attempts: number\n readonly backoff_ms?: number\n readonly on_error?: (err: unknown, attempt: number) => void\n}\n\nlet retry_counter = 0\n\nfunction next_id(): string {\n retry_counter += 1\n return `retry_${retry_counter}`\n}\n\nasync function abortable_wait(ms: number, ctx: RunContext): Promise<void> {\n if (ms <= 0) return\n await new Promise<void>((resolve, reject) => {\n if (ctx.abort.aborted) {\n const reason = ctx.abort.reason\n reject(reason instanceof Error ? reason : new aborted_error('aborted', { reason }))\n return\n }\n const timer = setTimeout(() => {\n ctx.abort.removeEventListener('abort', on_abort)\n resolve()\n }, ms)\n const on_abort = (): void => {\n clearTimeout(timer)\n const reason = ctx.abort.reason\n reject(reason instanceof Error ? reason : new aborted_error('aborted', { reason }))\n }\n ctx.abort.addEventListener('abort', on_abort, { once: true })\n })\n}\n\nexport function retry<i, o>(inner: Step<i, o>, config: RetryConfig): Step<i, o> {\n const id = next_id()\n const max_attempts = Math.max(1, Math.floor(config.max_attempts))\n const backoff_ms = config.backoff_ms ?? DEFAULT_BACKOFF_MS\n const on_error = config.on_error\n\n const run_fn = async (input: i, ctx: RunContext): Promise<o> => {\n let last_err: unknown = undefined\n for (let attempt = 1; attempt <= max_attempts; attempt += 1) {\n if (ctx.abort.aborted) {\n const reason = ctx.abort.reason\n throw reason instanceof Error ? reason : new aborted_error('aborted', { reason })\n }\n try {\n return await dispatch_step(inner, input, ctx)\n } catch (err) {\n if (is_control_flow_error(err)) throw err\n last_err = err\n if (on_error) on_error(err, attempt)\n if (attempt >= max_attempts) break\n const delay = backoff_ms * 2 ** (attempt - 1)\n await abortable_wait(delay, ctx)\n }\n }\n throw last_err\n }\n\n const config_meta: Record<string, unknown> = { max_attempts, backoff_ms }\n if (on_error) config_meta['on_error'] = on_error\n if (config.name !== undefined) config_meta['display_name'] = config.name\n\n return {\n id,\n kind: 'retry',\n children: [inner],\n config: config_meta,\n run: run_fn,\n }\n}\n\nregister_traced_kind('retry')\n","/**\n * fallback: primary-or-backup.\n *\n * `fallback(primary, backup)` runs `primary`. If it throws an application\n * error, runs `backup` with the same input. If `backup` also throws, the\n * `backup` error propagates. Control-flow signals (`suspended_error`,\n * `aborted_error`) are not failures: they propagate instead of triggering the\n * backup, so a human-approval gate is never silently bypassed and the backup\n * never runs under an aborted context. See spec.md §5.8.\n */\n\nimport { is_control_flow_error } from './errors.js'\nimport { dispatch_step, register_traced_kind } from './runner.js'\nimport type { RunContext, Step } from './types.js'\n\nlet fallback_counter = 0\n\nfunction next_id(): string {\n fallback_counter += 1\n return `fallback_${fallback_counter}`\n}\n\nexport type FallbackOptions = {\n readonly name?: string\n}\n\nexport function fallback<i, o>(\n primary: Step<i, o>,\n backup: Step<i, o>,\n options?: FallbackOptions,\n): Step<i, o> {\n const id = next_id()\n\n const run_fn = async (input: i, ctx: RunContext): Promise<o> => {\n try {\n return await dispatch_step(primary, input, ctx)\n } catch (err) {\n if (is_control_flow_error(err)) throw err\n return dispatch_step(backup, input, ctx)\n }\n }\n\n const config_meta: Record<string, unknown> | undefined =\n options?.name === undefined ? undefined : { display_name: options.name }\n\n return {\n id,\n kind: 'fallback',\n children: [primary, backup],\n ...(config_meta ? { config: config_meta } : {}),\n run: run_fn,\n }\n}\n\nregister_traced_kind('fallback')\n","/**\n * timeout: bound execution.\n *\n * `timeout(inner, ms)` runs `inner` with a composed `AbortSignal` that fires\n * at `ms` milliseconds. If the inner step does not complete in time, throws\n * `timeout_error`. The inner step is responsible for honoring `ctx.abort`;\n * a step that ignores the signal still triggers `timeout_error` on schedule\n * but continues running in the background (spec.md §9 F4).\n *\n * Cancellation (constraints.md §5.1, spec.md §6.8): the inner step runs with\n * `AbortSignal.any([ctx.abort, timeout_local])`. On timer expiry, the local\n * controller aborts with a `timeout_error` as its reason; on parent abort\n * the parent reason flows through. The timer is always cleared in a finally\n * block so it does not leak across retries.\n */\n\nimport { aborted_error, timeout_error } from './errors.js'\nimport { dispatch_step, register_traced_kind } from './runner.js'\nimport type { RunContext, Step } from './types.js'\n\nlet timeout_counter = 0\n\nfunction next_id(): string {\n timeout_counter += 1\n return `timeout_${timeout_counter}`\n}\n\nexport type TimeoutOptions = {\n readonly name?: string\n}\n\nexport function timeout<i, o>(\n inner: Step<i, o>,\n ms: number,\n options?: TimeoutOptions,\n): Step<i, o> {\n const id = next_id()\n\n const run_fn = async (input: i, ctx: RunContext): Promise<o> => {\n const local = new AbortController()\n const composed = AbortSignal.any([ctx.abort, local.signal])\n const child_ctx: RunContext = { ...ctx, abort: composed }\n \n let timed_out = false\n const timer = setTimeout(() => {\n timed_out = true\n local.abort(new timeout_error(`timeout after ${ms}ms`, ms))\n }, ms)\n \n const deadline = new Promise<never>((_, reject) => {\n const on_local_abort = (): void => {\n if (timed_out) {\n reject(new timeout_error(`timeout after ${ms}ms`, ms))\n } else {\n const reason = ctx.abort.reason\n reject(reason instanceof Error ? reason : new aborted_error('aborted', { reason }))\n }\n }\n if (composed.aborted) {\n on_local_abort()\n return\n }\n composed.addEventListener('abort', on_local_abort, { once: true })\n })\n \n try {\n return await Promise.race([dispatch_step(inner, input, child_ctx), deadline])\n } finally {\n clearTimeout(timer)\n }\n }\n\n const config_meta: Record<string, unknown> = { ms }\n if (options?.name !== undefined) config_meta['display_name'] = options.name\n\n return {\n id,\n kind: 'timeout',\n children: [inner],\n config: config_meta,\n run: run_fn,\n }\n}\n\nregister_traced_kind('timeout')\n","/**\n * loop: bounded iteration with carry-state.\n *\n * `loop({ init, body, guard?, finish, max_rounds, name? })` runs `body` up to\n * `max_rounds` times, threading `state` through each iteration. After every\n * `body` call, an optional `guard` step inspects (and may transform) the state\n * and decides whether to stop. When `guard.stop` is true, the loop exits\n * \"converged\"; otherwise it continues until `max_rounds`. `finish` projects\n * the final state to the loop's output value.\n *\n * Non-convergence is data, not error: when `max_rounds` is exhausted without\n * `guard` returning stop, the loop returns `{ value, converged: false, rounds }`.\n * This matches the existing convention from adversarial/consensus.\n *\n * Cancellation: between rounds the parent `ctx.abort` is honored — a pending\n * abort short-circuits and propagates `ctx.abort.reason`. The body and guard\n * receive the parent context unchanged; their own dispatch routes already\n * thread cancellation per the runner contract.\n */\n\nimport { dispatch_step, register_traced_kind, throw_if_aborted } from './runner.js'\nimport type { RunContext, Step } from './types.js'\n\nexport type LoopGuardResult<state> = {\n readonly stop: boolean\n readonly state: state\n}\n\nexport type LoopConfig<i, state, o> = {\n readonly name?: string\n readonly init: (input: i) => state\n readonly body: Step<state, state>\n readonly guard?: Step<state, LoopGuardResult<state>>\n readonly finish: (state: state, round: number) => o\n readonly max_rounds: number\n}\n\nexport type LoopResult<o> = {\n readonly value: o\n readonly converged: boolean\n readonly rounds: number\n}\n\nlet loop_counter = 0\n\nfunction next_id(name: string | undefined): string {\n loop_counter += 1\n return `${name ?? 'loop'}_${loop_counter}`\n}\n\nexport function loop<i, state, o>(\n config: LoopConfig<i, state, o>,\n): Step<i, LoopResult<o>> {\n const { init, body, guard, finish, name } = config\n const rounds_limit = Math.max(1, Math.floor(config.max_rounds))\n const id = next_id(name)\n\n const run_fn = async (input: i, ctx: RunContext): Promise<LoopResult<o>> => {\n let state = init(input)\n let round = 0\n let converged = false\n \n while (round < rounds_limit) {\n throw_if_aborted(ctx)\n round += 1\n state = await dispatch_step(body, state, ctx)\n if (guard) {\n throw_if_aborted(ctx)\n const guard_out = await dispatch_step(guard, state, ctx)\n state = guard_out.state\n if (guard_out.stop) {\n converged = true\n break\n }\n }\n }\n \n const value = finish(state, round)\n return { value, converged, rounds: round }\n }\n\n const config_meta: Record<string, unknown> = { max_rounds: rounds_limit }\n if (name !== undefined) config_meta['display_name'] = name\n const children: ReadonlyArray<Step<unknown, unknown>> = guard\n ? [body, guard]\n : [body]\n\n return {\n id,\n kind: 'loop',\n children,\n config: config_meta,\n run: run_fn,\n }\n}\n\nregister_traced_kind('loop')\n","/**\n * compose: name a composite step.\n *\n * `compose(name, inner)` wraps any step and labels its trajectory span with\n * `name`. The inner step's own span (e.g. a `sequence`) appears as a child of\n * the compose span — the implementation tree is preserved while the user's\n * intent (\"this whole thing is an ensemble\") is surfaced in observability.\n *\n * Used by the composites package to make built-in patterns appear under\n * their familiar names, and available to library consumers who want their own\n * named composites to show up in logs as first-class components.\n *\n * The primitive's `kind` is always `'compose'`; the user-supplied label lives\n * in `config.display_name` and is the span name the dispatcher opens.\n */\n\nimport { dispatch_step, register_traced_kind } from './runner.js'\nimport type { RunContext, Step } from './types.js'\n\nlet compose_counter = 0\n\nfunction next_id(name: string): string {\n compose_counter += 1\n return `${name}_${compose_counter}`\n}\n\nexport function compose<i, o>(name: string, inner: Step<i, o>): Step<i, o> {\n if (typeof name !== 'string' || name.length === 0) {\n throw new TypeError('compose(name, inner): name must be a non-empty string')\n }\n const id = next_id(name)\n\n const run_fn = (input: i, ctx: RunContext): Promise<o> | o => dispatch_step(inner, input, ctx)\n\n return {\n id,\n kind: 'compose',\n children: [inner],\n config: { display_name: name },\n run: run_fn,\n }\n}\n\nregister_traced_kind('compose')\n","/**\n * checkpoint: persist and resume.\n *\n * `checkpoint(inner, { key })` checks a persistent store for a completed\n * result at `key` before running `inner`. On a hit, returns the stored\n * value. On a miss, runs `inner`, persists its result at `key`, and returns\n * it. Corrupted reads (store throws on `get`) are treated as a miss.\n *\n * Fail-fast (constraints.md §7 invariant 8, spec.md §9 F6): wrapping an\n * anonymous inner step throws synchronously at construction time with the\n * message `checkpoint requires a named step; got anonymous`.\n *\n * See spec.md §5.14, §6.3.\n */\n\nimport { dispatch_step, register_traced_kind } from './runner.js'\nimport type { RunContext, Step } from './types.js'\n\nexport type CheckpointConfig<i> = {\n readonly name?: string\n readonly key: string | ((input: i) => string)\n}\n\nlet checkpoint_counter = 0\n\nfunction next_id(): string {\n checkpoint_counter += 1\n return `checkpoint_${checkpoint_counter}`\n}\n\nexport function checkpoint<i, o>(inner: Step<i, o>, config: CheckpointConfig<i>): Step<i, o> {\n if (inner.anonymous === true) {\n throw new Error('checkpoint requires a named step; got anonymous')\n }\n\n const id = next_id()\n const key_spec = config.key\n\n const run_fn = async (input: i, ctx: RunContext): Promise<o> => {\n const key = typeof key_spec === 'function' ? key_spec(input) : key_spec\n const store = ctx.checkpoint_store\n \n if (store) {\n let cached: unknown = undefined\n let hit = false\n try {\n cached = await store.get(key)\n hit = cached !== null && cached !== undefined\n } catch {\n hit = false\n }\n if (hit) {\n // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n return cached as o\n }\n }\n \n const result = await dispatch_step(inner, input, ctx)\n \n if (store) {\n await store.set(key, result)\n }\n \n return result\n }\n\n const config_meta: Record<string, unknown> = { key: key_spec }\n if (config.name !== undefined) config_meta['display_name'] = config.name\n\n return {\n id,\n kind: 'checkpoint',\n children: [inner],\n config: config_meta,\n run: run_fn,\n }\n}\n\nregister_traced_kind('checkpoint')\n","/**\n * suspend: human-in-the-loop pause.\n *\n * `suspend({ id, on, resume_schema, combine })` pauses a flow waiting on\n * external input (a notification, an approval, an uploaded file). On first\n * encounter with no resume data, it calls `on(input, ctx)` (side effect) and\n * throws `suspended_error` carrying the run state. On resume (re-invocation\n * with `run_options.resume_data[id]` populated), the provided value is\n * validated against `resume_schema` and passed to `combine(input, resume,\n * ctx)`; the result is returned. Invalid resume data throws\n * `resume_validation_error` built from zod 4's `.flatten()` (spec.md §9 F5).\n *\n * See spec.md §5.15, §6.4.\n */\n\nimport { z } from 'zod'\nimport { resume_validation_error, suspended_error } from './errors.js'\nimport { dispatch_step, register_traced_kind } from './runner.js'\nimport type { RunContext, Step } from './types.js'\n\nexport type SuspendConfig<i, o, resume> = {\n readonly id: string\n readonly name?: string\n readonly on: (input: i, ctx: RunContext) => Promise<void> | void\n readonly resume_schema: z.ZodType<resume>\n readonly combine: (\n input: i,\n resume: resume,\n ctx: RunContext,\n ) => Promise<o> | o | Step<unknown, o>\n}\n\nfunction is_step(value: unknown): value is Step<unknown, unknown> {\n if (typeof value !== 'object' || value === null) return false\n if (!('id' in value) || !('kind' in value) || !('run' in value)) return false\n const { id, kind, run } = value\n return typeof id === 'string' && typeof kind === 'string' && typeof run === 'function'\n}\n\nexport function suspend<i, o, resume>(config: SuspendConfig<i, o, resume>): Step<i, o> {\n const suspend_id = config.id\n const on_fn = config.on\n const resume_schema = config.resume_schema\n const combine_fn = config.combine\n\n const run_fn = async (input: i, ctx: RunContext): Promise<o> => {\n const resume_value = ctx.resume_data?.[suspend_id]\n \n if (resume_value === undefined) {\n await on_fn(input, ctx)\n throw new suspended_error(suspend_id, { input })\n }\n \n const parsed = resume_schema.safeParse(resume_value)\n if (!parsed.success) {\n const issues = z.flattenError(parsed.error)\n throw new resume_validation_error(\n `resume data for ${suspend_id} failed validation`,\n issues,\n )\n }\n \n const result = await combine_fn(input, parsed.data, ctx)\n if (is_step(result)) {\n return dispatch_step(result, input, ctx)\n }\n return result\n }\n\n const config_meta: Record<string, unknown> = { id: suspend_id }\n if (config.name !== undefined) config_meta['display_name'] = config.name\n\n return {\n id: suspend_id,\n kind: 'suspend',\n config: config_meta,\n run: run_fn,\n }\n}\n\nregister_traced_kind('suspend')\n","/**\n * scope / stash / use: named state.\n *\n * `scope([...children])` introduces a scope-local `Map<string, unknown>` and\n * runs its children in order, chaining outputs like `sequence`. `stash(key,\n * source)` runs `source`, writes its output to the scope's state at `key`,\n * and passes the value through. `use(keys, fn)` reads the named values from\n * state and runs `fn` with the projection. Inner scopes inherit outer state;\n * writes only affect the inner map.\n *\n * Using `stash` or `use` outside a `scope` is a runtime error with a clear\n * message (spec.md §9 F1).\n *\n * See spec.md §5.16.\n */\n\nimport { dispatch_step, register_traced_kind, throw_if_aborted } from './runner.js'\nimport type { RunContext, Step } from './types.js'\n\ntype AnyStep = Step<unknown, unknown>\n\ntype LastOutput<children> = children extends readonly [...unknown[], Step<unknown, infer o>]\n ? o\n : children extends readonly [Step<unknown, infer o>]\n ? o\n : unknown\n\nconst scope_states = new WeakSet<ReadonlyMap<string, unknown>>()\n\nfunction is_scope_state(state: ReadonlyMap<string, unknown>): boolean {\n return scope_states.has(state)\n}\n\nlet scope_counter = 0\nlet stash_counter = 0\nlet use_counter = 0\n\nfunction next_scope_id(): string {\n scope_counter += 1\n return `scope_${scope_counter}`\n}\n\nfunction next_stash_id(): string {\n stash_counter += 1\n return `stash_${stash_counter}`\n}\n\nfunction next_use_id(): string {\n use_counter += 1\n return `use_${use_counter}`\n}\n\nexport type ScopeOptions = {\n readonly name?: string\n}\n\nexport type StashOptions = {\n readonly name?: string\n}\n\nexport type UseOptions = {\n readonly name?: string\n}\n\nexport function scope<const children extends readonly AnyStep[]>(\n children: children,\n options?: ScopeOptions,\n): Step<unknown, LastOutput<children>> {\n const id = next_scope_id()\n const children_ref = children\n\n const run_fn = async (input: unknown, ctx: RunContext): Promise<unknown> => {\n const local = new Map<string, unknown>(ctx.state)\n scope_states.add(local)\n const scope_ctx: RunContext = { ...ctx, state: local }\n \n let acc: unknown = input\n for (const child of children_ref) {\n throw_if_aborted(scope_ctx)\n acc = await dispatch_step(child, acc, scope_ctx)\n }\n return acc\n }\n\n const config_meta: Record<string, unknown> | undefined =\n options?.name === undefined ? undefined : { display_name: options.name }\n\n // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n return {\n id,\n kind: 'scope',\n children,\n ...(config_meta ? { config: config_meta } : {}),\n run: run_fn,\n } as Step<unknown, LastOutput<children>>\n}\n\nexport function stash<i, v>(\n key: string,\n source: Step<i, v>,\n options?: StashOptions,\n): Step<i, v> {\n const id = next_stash_id()\n\n const run_fn = async (input: i, ctx: RunContext): Promise<v> => {\n if (!is_scope_state(ctx.state)) {\n throw new Error('stash() may only appear inside scope(); got: top-level')\n }\n const value = await dispatch_step(source, input, ctx)\n // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n const state = ctx.state as Map<string, unknown>\n state.set(key, value)\n return value\n }\n\n const config_meta: Record<string, unknown> = { key }\n if (options?.name !== undefined) config_meta['display_name'] = options.name\n\n return {\n id,\n kind: 'stash',\n children: [source],\n config: config_meta,\n run: run_fn,\n }\n}\n\nexport function use<const keys extends readonly string[], i, o>(\n keys: keys,\n fn: (\n state: { [k in keys[number]]: unknown },\n input: i,\n ctx: RunContext,\n ) => Promise<o> | o,\n options?: UseOptions,\n): Step<i, o> {\n const id = next_use_id()\n\n const run_fn = async (input: i, ctx: RunContext): Promise<o> => {\n if (!is_scope_state(ctx.state)) {\n throw new Error('use() may only appear inside scope(); got: top-level')\n }\n const projection: Record<string, unknown> = {}\n for (const k of keys) {\n projection[k] = ctx.state.get(k)\n }\n // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n return fn(projection as { [k in keys[number]]: unknown }, input, ctx)\n }\n\n const config_meta: Record<string, unknown> = { keys: [...keys] }\n if (options?.name !== undefined) config_meta['display_name'] = options.name\n\n return {\n id,\n kind: 'use',\n config: config_meta,\n run: run_fn,\n }\n}\n\nregister_traced_kind('scope')\n\nregister_traced_kind('stash')\n\nregister_traced_kind('use')\n","/**\n * Closed registry of every `Step.kind` produced by the composition layer.\n *\n * Studio (and any other consumer that needs to enumerate primitives — palette,\n * docs, code generation) can rely on this being the exhaustive set. New\n * primitives must add their kind here. The `step_kinds_cover_runner` contract\n * test in `step_kinds.test.ts` asserts every dispatch handler corresponds to a\n * kind listed here.\n */\n\nexport const STEP_KINDS = [\n 'step',\n 'sequence',\n 'parallel',\n 'branch',\n 'map',\n 'pipe',\n 'retry',\n 'fallback',\n 'timeout',\n 'loop',\n 'compose',\n 'adversarial',\n 'ensemble',\n 'tournament',\n 'consensus',\n 'checkpoint',\n 'suspend',\n 'scope',\n 'stash',\n 'use',\n] as const\n\nexport type StepKind = (typeof STEP_KINDS)[number]\n\nexport function is_step_kind(value: unknown): value is StepKind {\n return typeof value === 'string' && (STEP_KINDS as readonly string[]).includes(value)\n}\n","/**\n * Wire-format schema for trajectory events.\n *\n * `TrajectoryEvent` (in `types.ts`) is the loose internal type — any code that\n * calls `trajectory.record(event)` or `start_span(name, meta)` produces values\n * conforming to it. This file defines the *narrower* shapes that the studio\n * (and any other downstream consumer) can parse out of the wire stream:\n *\n * span_start — composer span open\n * span_end — composer span close\n * emit — user-emitted event from inside a step (ctx.emit)\n * <other> — falls through `custom_event_schema`, which only requires a\n * string `kind` and tolerates any extra fields\n *\n * The discriminated union is **ordered**: well-known shapes are tried before\n * the permissive `custom` schema, so a `{ kind: 'span_start', ... }` event\n * always parses as `SpanStartEvent`, never as `CustomTrajectoryEvent`.\n *\n * Every well-known schema and `custom_event_schema` use `.passthrough()` so\n * additional fields (e.g. `run_id`, `id`, provider-specific metadata) survive\n * a parse / re-serialize round-trip without loss.\n */\n\nimport { z } from 'zod'\n\nexport const span_start_event_schema = z\n .object({\n kind: z.literal('span_start'),\n span_id: z.string(),\n name: z.string(),\n })\n .passthrough()\n\nexport const span_end_event_schema = z\n .object({\n kind: z.literal('span_end'),\n span_id: z.string(),\n })\n .passthrough()\n\nexport const emit_event_schema = z\n .object({\n kind: z.literal('emit'),\n })\n .passthrough()\n\nexport const custom_event_schema = z\n .object({\n kind: z.string(),\n })\n .passthrough()\n\nexport const trajectory_event_schema = z.union([\n span_start_event_schema,\n span_end_event_schema,\n emit_event_schema,\n custom_event_schema,\n])\n\nexport type SpanStartEvent = z.infer<typeof span_start_event_schema>\nexport type SpanEndEvent = z.infer<typeof span_end_event_schema>\nexport type EmitEvent = z.infer<typeof emit_event_schema>\nexport type CustomTrajectoryEvent = z.infer<typeof custom_event_schema>\nexport type ParsedTrajectoryEvent = z.infer<typeof trajectory_event_schema>\n","/**\n * Public surface for core.\n *\n * Side-effect imports ensure every composer registers itself with the runner\n * at module load. Importing anything from `core` populates the\n * dispatch table with the core primitives. Built-in composites\n * (adversarial, ensemble, tournament, consensus) live in composites\n * and surface through the umbrella package.\n */\n\nimport flow_schema_data from './flow-schema.json' with { type: 'json' }\n\nexport { run } from './runner.js'\nexport { step } from './step.js'\nexport { describe } from './describe.js'\nexport type { DescribeOptions, FlowNode, FlowValue } from './describe.js'\nexport { sequence } from './sequence.js'\nexport { parallel } from './parallel.js'\nexport { branch } from './branch.js'\nexport { map } from './map.js'\nexport { pipe } from './pipe.js'\nexport { retry } from './retry.js'\nexport { fallback } from './fallback.js'\nexport { timeout } from './timeout.js'\nexport { loop } from './loop.js'\nexport type { LoopConfig, LoopGuardResult, LoopResult } from './loop.js'\nexport { compose } from './compose.js'\nexport { checkpoint } from './checkpoint.js'\nexport { suspend } from './suspend.js'\nexport { scope, stash, use } from './scope.js'\n\nexport {\n aborted_error,\n describe_cycle_error,\n resume_validation_error,\n suspended_error,\n timeout_error,\n} from './errors.js'\n\nexport type {\n CheckpointStore,\n RunContext,\n Step,\n StepMetadata,\n TrajectoryEvent,\n TrajectoryLogger,\n} from './types.js'\n\nexport { is_step_kind, STEP_KINDS } from './step_kinds.js'\nexport type { StepKind } from './step_kinds.js'\n\nexport {\n custom_event_schema,\n emit_event_schema,\n span_end_event_schema,\n span_start_event_schema,\n trajectory_event_schema,\n} from './trajectory.js'\nexport type {\n CustomTrajectoryEvent,\n EmitEvent,\n ParsedTrajectoryEvent,\n SpanEndEvent,\n SpanStartEvent,\n} from './trajectory.js'\n\nexport { flow_schema_data as flow_schema }\n"],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import { J as TrajectoryLogger } from "./index-CEj6hY9z.js";
1
+ import { J as TrajectoryLogger } from "./index-JhJahQNi.js";
2
2
  import { z } from "zod";
3
3
 
4
4
  //#region src/engine/providers/claude_cli/types.d.ts
@@ -458,4 +458,4 @@ declare class provider_auth_error extends Error {
458
458
  }
459
459
  //#endregion
460
460
  export { RetryFailureKind as A, UserContentPart as B, GenerateResult as C, ProviderConfigMap as D, PricingTable as E, ToolApprovalHandler as F, ToolApprovalRequest as I, ToolCallRecord as L, StepRecord as M, StreamChunk as N, ProviderInit as O, Tool as P, ToolExecContext as R, GenerateOptions as S, Pricing as T, EffortLevel as _, on_chunk_error as a, EngineDefaults as b, provider_error as c, schema_validation_error as d, tool_approval_denied_error as f, CostBreakdown as g, AssistantContentPart as h, model_required_error as i, RetryPolicy as j, ResolvedModel as k, provider_not_configured_error as l, create_engine as m, engine_config_error as n, provider_auth_error as o, tool_error as p, engine_disposed_error as r, provider_capability_error as s, claude_cli_error as t, rate_limit_error as u, Engine as v, Message as w, FinishReason as x, EngineConfig as y, UsageTotals as z };
461
- //# sourceMappingURL=index-ORrmFF1x.d.ts.map
461
+ //# sourceMappingURL=index-CJRUqgsV.d.ts.map
@@ -853,4 +853,4 @@ type CustomTrajectoryEvent = z.infer<typeof custom_event_schema>;
853
853
  type ParsedTrajectoryEvent = z.infer<typeof trajectory_event_schema>;
854
854
  //#endregion
855
855
  export { fallback as A, describe as B, checkpoint as C, LoopResult as D, LoopGuardResult as E, parallel as F, Step as G, run as H, sequence as I, TrajectoryLogger as J, StepMetadata as K, DescribeOptions as L, pipe as M, map as N, loop as O, branch as P, FlowNode as R, suspend as S, LoopConfig as T, CheckpointStore as U, step as V, RunContext as W, __json_default_export as Y, suspended_error as _, SpanStartEvent as a, stash as b, span_end_event_schema as c, STEP_KINDS as d, StepKind as f, resume_validation_error as g, describe_cycle_error as h, SpanEndEvent as i, retry as j, timeout as k, span_start_event_schema as l, aborted_error as m, EmitEvent as n, custom_event_schema as o, is_step_kind as p, TrajectoryEvent as q, ParsedTrajectoryEvent as r, emit_event_schema as s, CustomTrajectoryEvent as t, trajectory_event_schema as u, timeout_error as v, compose as w, use as x, scope as y, FlowValue as z };
856
- //# sourceMappingURL=index-CEj6hY9z.d.ts.map
856
+ //# sourceMappingURL=index-JhJahQNi.d.ts.map
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- import { A as fallback, B as describe, C as checkpoint, D as LoopResult, E as LoopGuardResult, F as parallel, G as Step, H as run, I as sequence, J as TrajectoryLogger, K as StepMetadata, L as DescribeOptions, M as pipe, N as map, O as loop, P as branch, R as FlowNode, S as suspend, T as LoopConfig, U as CheckpointStore, V as step, W as RunContext, Y as __json_default_export, _ as suspended_error, a as SpanStartEvent, b as stash, c as span_end_event_schema, d as STEP_KINDS, f as StepKind, g as resume_validation_error, h as describe_cycle_error, i as SpanEndEvent, j as retry, k as timeout, l as span_start_event_schema, m as aborted_error, n as EmitEvent, o as custom_event_schema, p as is_step_kind, q as TrajectoryEvent, r as ParsedTrajectoryEvent, s as emit_event_schema, t as CustomTrajectoryEvent, u as trajectory_event_schema, v as timeout_error, w as compose, x as use, y as scope, z as FlowValue } from "./index-CEj6hY9z.js";
2
- import { A as RetryFailureKind, B as UserContentPart, C as GenerateResult, D as ProviderConfigMap, E as PricingTable, F as ToolApprovalHandler, I as ToolApprovalRequest, L as ToolCallRecord, M as StepRecord, N as StreamChunk, O as ProviderInit, P as Tool, R as ToolExecContext, S as GenerateOptions, T as Pricing, _ as EffortLevel, a as on_chunk_error, b as EngineDefaults, c as provider_error, d as schema_validation_error, f as tool_approval_denied_error, g as CostBreakdown, h as AssistantContentPart, i as model_required_error, j as RetryPolicy, k as ResolvedModel, l as provider_not_configured_error, m as create_engine, n as engine_config_error, o as provider_auth_error, p as tool_error, r as engine_disposed_error, s as provider_capability_error, t as claude_cli_error, u as rate_limit_error, v as Engine, w as Message, x as FinishReason, y as EngineConfig, z as UsageTotals } from "./index-ORrmFF1x.js";
1
+ import { A as fallback, B as describe, C as checkpoint, D as LoopResult, E as LoopGuardResult, F as parallel, G as Step, H as run, I as sequence, J as TrajectoryLogger, K as StepMetadata, L as DescribeOptions, M as pipe, N as map, O as loop, P as branch, R as FlowNode, S as suspend, T as LoopConfig, U as CheckpointStore, V as step, W as RunContext, Y as __json_default_export, _ as suspended_error, a as SpanStartEvent, b as stash, c as span_end_event_schema, d as STEP_KINDS, f as StepKind, g as resume_validation_error, h as describe_cycle_error, i as SpanEndEvent, j as retry, k as timeout, l as span_start_event_schema, m as aborted_error, n as EmitEvent, o as custom_event_schema, p as is_step_kind, q as TrajectoryEvent, r as ParsedTrajectoryEvent, s as emit_event_schema, t as CustomTrajectoryEvent, u as trajectory_event_schema, v as timeout_error, w as compose, x as use, y as scope, z as FlowValue } from "./index-JhJahQNi.js";
2
+ import { A as RetryFailureKind, B as UserContentPart, C as GenerateResult, D as ProviderConfigMap, E as PricingTable, F as ToolApprovalHandler, I as ToolApprovalRequest, L as ToolCallRecord, M as StepRecord, N as StreamChunk, O as ProviderInit, P as Tool, R as ToolExecContext, S as GenerateOptions, T as Pricing, _ as EffortLevel, a as on_chunk_error, b as EngineDefaults, c as provider_error, d as schema_validation_error, f as tool_approval_denied_error, g as CostBreakdown, h as AssistantContentPart, i as model_required_error, j as RetryPolicy, k as ResolvedModel, l as provider_not_configured_error, m as create_engine, n as engine_config_error, o as provider_auth_error, p as tool_error, r as engine_disposed_error, s as provider_capability_error, t as claude_cli_error, u as rate_limit_error, v as Engine, w as Message, x as FinishReason, y as EngineConfig, z as UsageTotals } from "./index-CJRUqgsV.js";
3
3
  import { z } from "zod";
4
4
 
5
5
  //#region src/composites/adversarial.d.ts
@@ -348,5 +348,5 @@ declare function start_viewer(options?: StartViewerOptions): Promise<ViewerHandl
348
348
  */
349
349
  declare function run_viewer_cli(argv: readonly string[]): Promise<void>;
350
350
  //#endregion
351
- export { type AdversarialBuildInput, type AdversarialConfig, type AdversarialCritiqueResult, type AdversarialResult, type AssistantContentPart, type BenchCase, type BenchOptions, type BenchReport, type BenchSummary, type BracketRecord, type Candidate, type CaseResult, CheckpointStore, type ConsensusConfig, type ConsensusResult, type CostBreakdown, CustomTrajectoryEvent, DescribeOptions, type EffortLevel, EmitEvent, type Engine, type EngineConfig, type EngineDefaults, type EnsembleConfig, type EnsembleResult, type EnsembleStepConfig, type EnsembleStepResult, type FinishReason, FlowNode, FlowValue, type GenerateOptions, type GenerateResult, type HistoryEntry, type ImproveBudget, type ImproveConfig, type ImproveResult, type ImproveRoundInput, type Improvement, type Judge, type JudgeArgs, type JudgeLlmConfig, type JudgeWithFn, type LearnConfig, type LearnInput, type LearnResult, type Lesson, LoopConfig, LoopGuardResult, LoopResult, type Message, type ModelCallConfig, type ModelCallInput, ParsedTrajectoryEvent, type PerCaseDelta, type Pricing, type PricingTable, type ProviderConfigMap, type ProviderInit, type RegressionCompareOptions, type RegressionDelta, type RegressionReport, type ResolvedModel, type RetryFailureKind, type RetryPolicy, RunContext, STEP_KINDS, type Score, type ScoredCandidate, SpanEndEvent, SpanStartEvent, type StartViewerOptions, Step, StepKind, StepMetadata, type StepRecord, type StreamChunk, type Tool, type ToolApprovalHandler, type ToolApprovalRequest, type ToolCallRecord, type ToolExecContext, type TournamentConfig, type TournamentResult, TrajectoryEvent, TrajectoryLogger, type TrajectorySource, type UsageTotals, type UserContentPart, type ViewerHandle, aborted_error, adversarial, bench, branch, checkpoint, claude_cli_error, compose, consensus, create_engine, custom_event_schema, describe, describe_cycle_error, emit_event_schema, engine_config_error, engine_disposed_error, ensemble, ensemble_step, fallback, __json_default_export as flow_schema, forward_standard_env, improve, is_step_kind, judge_equals, judge_llm, judge_with, learn, loop, map, model_call, model_required_error, normalize_score, on_chunk_error, parallel, pipe, provider_auth_error, provider_capability_error, provider_error, provider_not_configured_error, rate_limit_error, read_baseline, regression_compare, resume_validation_error, retry, run, run_viewer_cli, schema_validation_error, scope, sequence, span_end_event_schema, span_start_event_schema, start_viewer, stash, step, suspend, suspended_error, timeout, timeout_error, tool_approval_denied_error, tool_error, tournament, trajectory_event_schema, use, write_baseline };
351
+ export { type AdversarialBuildInput, type AdversarialConfig, type AdversarialCritiqueResult, type AdversarialResult, type AssistantContentPart, type BenchCase, type BenchOptions, type BenchReport, type BenchSummary, type BracketRecord, type Candidate, type CaseResult, type CheckpointStore, type ConsensusConfig, type ConsensusResult, type CostBreakdown, type CustomTrajectoryEvent, type DescribeOptions, type EffortLevel, type EmitEvent, type Engine, type EngineConfig, type EngineDefaults, type EnsembleConfig, type EnsembleResult, type EnsembleStepConfig, type EnsembleStepResult, type FinishReason, type FlowNode, type FlowValue, type GenerateOptions, type GenerateResult, type HistoryEntry, type ImproveBudget, type ImproveConfig, type ImproveResult, type ImproveRoundInput, type Improvement, type Judge, type JudgeArgs, type JudgeLlmConfig, type JudgeWithFn, type LearnConfig, type LearnInput, type LearnResult, type Lesson, type LoopConfig, type LoopGuardResult, type LoopResult, type Message, type ModelCallConfig, type ModelCallInput, type ParsedTrajectoryEvent, type PerCaseDelta, type Pricing, type PricingTable, type ProviderConfigMap, type ProviderInit, type RegressionCompareOptions, type RegressionDelta, type RegressionReport, type ResolvedModel, type RetryFailureKind, type RetryPolicy, type RunContext, STEP_KINDS, type Score, type ScoredCandidate, type SpanEndEvent, type SpanStartEvent, type StartViewerOptions, type Step, type StepKind, type StepMetadata, type StepRecord, type StreamChunk, type Tool, type ToolApprovalHandler, type ToolApprovalRequest, type ToolCallRecord, type ToolExecContext, type TournamentConfig, type TournamentResult, type TrajectoryEvent, type TrajectoryLogger, type TrajectorySource, type UsageTotals, type UserContentPart, type ViewerHandle, aborted_error, adversarial, bench, branch, checkpoint, claude_cli_error, compose, consensus, create_engine, custom_event_schema, describe, describe_cycle_error, emit_event_schema, engine_config_error, engine_disposed_error, ensemble, ensemble_step, fallback, __json_default_export as flow_schema, forward_standard_env, improve, is_step_kind, judge_equals, judge_llm, judge_with, learn, loop, map, model_call, model_required_error, normalize_score, on_chunk_error, parallel, pipe, provider_auth_error, provider_capability_error, provider_error, provider_not_configured_error, rate_limit_error, read_baseline, regression_compare, resume_validation_error, retry, run, run_viewer_cli, schema_validation_error, scope, sequence, span_end_event_schema, span_start_event_schema, start_viewer, stash, step, suspend, suspended_error, timeout, timeout_error, tool_approval_denied_error, tool_error, tournament, trajectory_event_schema, use, write_baseline };
352
352
  //# sourceMappingURL=index.d.ts.map