@demlik/tea 0.13.0 → 0.15.0

package/dist/work-queue/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/work-queue/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @packageDocumentation\n * @demlik/tea/work-queue — substrate-agnostic work-queue lifecycle on `Store<S>`.\n *\n * Two public surfaces, one shape:\n *   - `createQueue(store)` (this file) is the in-process adapter — it binds the\n *     pure ops to an injected `Store` and runs `load → mutate → save`.\n *   - `@demlik/tea/work-queue/ops` (`./ops`) is the BLESSED, importable surface\n *     of those same pure ops. L2 compositions that own their own Model slice\n *     (`monitored-run`, `idempotent-intake`, …) import the ops directly and\n *     delegate status flips to them instead of re-rolling the transitions.\n * Both routes call the identical ops, so the lifecycle rules live in exactly\n * one place. This mirrors `@demlik/tea/do`'s one-shape-per-package rule.\n *\n * The package is generic in the input payload `I` (audit-specific fields go\n * here in the extension host). `output` is a free-form side-channel correlation\n * token (a backend id, URL, trace id) — typed as `string` because that's its\n * only honest type. Consumers that need structured per-item data persist it in\n * their own store and put the foreign-key string in `output`.\n */\n\nimport type { Store } from \"../index\";\nimport {\n  claimNextOp,\n  enqueueOp,\n  markDoneOp,\n  patchItemOp,\n  removeOp,\n  resetRunningOp,\n} from \"./ops\";\n\n/**\n * Generate a queue-item id at the adapter boundary. Reads `Date.now()` and\n * `Math.random()` — impure helpers belong in the adapter (`index.ts`),\n * never in `ops.ts` (which is purely-functional by contract). Uses native\n * UUID when available, falls back to timestamp + random for environments\n * without `crypto.randomUUID`.\n */\nfunction genId(): string {\n  return (\n    globalThis.crypto?.randomUUID?.() ??\n    `q_${Date.now()}_${Math.random().toString(36).slice(2)}`\n  );\n}\n\nexport type QueueItemStatus =\n  | \"pending\"\n  | \"running\"\n  | \"done\"\n  | \"failed\"\n  | \"cancelled\";\n\n/**\n * A single queue entry. Every field is `readonly`: a persisted slice is\n * immutable, so a transition returns a NEW item (the ops always spread —\n * `{ ...item, status: … }`) rather than mutating in place. This type-enforces\n * the durability invariant the consumers already honor by convention, and\n * keeps a slice round-trippable through JSON unchanged across a reload.\n */\nexport interface QueueItem<I> {\n  readonly id: string;\n  readonly status: QueueItemStatus;\n  readonly input: I;\n  readonly enqueuedAt: number;\n  readonly startedAt?: number;\n  readonly finishedAt?: number;\n  readonly output?: string;\n  readonly error?: string;\n}\n\n/**\n * Caller-facing enqueue payload. Just `I` today — kept named so future\n * variants (priority, deferUntil, …) can grow without breaking callers.\n */\nexport type EnqueueInput<I> = I;\n\n/**\n * Adapter that binds the pure ops to an injected `Store<QueueItem<I>[]>`.\n *\n * `load → mutate → save` is the only durability discipline this package\n * imposes. The store decides what \"save\" means (chrome.storage, KV, DO\n * storage, in-memory) — that decision belongs at the caller.\n *\n * Ops that don't change the queue (e.g. `markDone` on an unknown id) skip the\n * save call so the underlying store doesn't observe a write churn.\n */\nexport function createQueue<I>(store: Store<QueueItem<I>[]>) {\n  // `Store<S>.load()` returns `unknown` (invariant 8 boundary). Route\n  // through `store.migrate(raw)` to get the typed value before any\n  // queue operation reads it — same wiring the substrate's `run()` uses at\n  // boot. The work queue is a substrate-agnostic primitive on top of\n  // `Store<S>`, so it honors the same contract.\n  async function loadParsed(): Promise<QueueItem<I>[] | null> {\n    const raw = await store.load();\n    return store.migrate(raw);\n  }\n\n  async function list(): Promise<QueueItem<I>[]> {\n    return (await loadParsed()) ?? [];\n  }\n\n  async function enqueue(input: EnqueueInput<I>): Promise<QueueItem<I>> {\n    const queue = await list();\n    const { next, item } = enqueueOp<I>(queue, input, Date.now(), genId());\n    await store.save(next);\n    return item;\n  }\n\n  async function claimNext(): Promise<QueueItem<I> | null> {\n    const queue = await list();\n    const result = claimNextOp<I>(queue, Date.now());\n    if (!result) return null;\n    await store.save(result.next);\n    return result.claimed;\n  }\n\n  // `markDone` ignores the optional second arg by design: completed runs leave\n  // the queue, and the consumer is expected to persist any output (auditId,\n  // etc.) wherever those completed records belong. Kept in the signature for\n  // call-site readability and forward-compat with `bindOutput`.\n  async function markDone(id: string): Promise<void> {\n    const queue = await list();\n    const { next, changed } = markDoneOp<I>(queue, id);\n    if (changed) await store.save(next);\n  }\n\n  async function markFailed(id: string, error: string): Promise<void> {\n    const queue = await list();\n    const { next, changed } = patchItemOp<I>(queue, id, (item) => ({\n      ...item,\n      status: \"failed\",\n      finishedAt: Date.now(),\n      error,\n    }));\n    if (changed) await store.save(next);\n  }\n\n  async function markCancelled(id: string): Promise<void> {\n    const queue = await list();\n    const { next, changed } = patchItemOp<I>(queue, id, (item) => ({\n      ...item,\n      status: \"cancelled\",\n      finishedAt: Date.now(),\n    }));\n    if (changed) await store.save(next);\n  }\n\n  async function resetRunningToPending(): Promise<void> {\n    const queue = await list();\n    const { next, changed } = resetRunningOp<I>(queue);\n    if (changed) await store.save(next);\n  }\n\n  async function removeItem(id: string): Promise<void> {\n    const queue = await list();\n    const { next, changed } = removeOp<I>(queue, id);\n    if (changed) await store.save(next);\n  }\n\n  async function retryItem(id: string): Promise<void> {\n    const queue = await list();\n    const { next, changed } = patchItemOp<I>(queue, id, (item) => ({\n      ...item,\n      status: \"pending\",\n      startedAt: undefined,\n      finishedAt: undefined,\n      error: undefined,\n      output: undefined,\n    }));\n    if (changed) await store.save(next);\n  }\n\n  // `bindOutput` attaches a side-channel correlation token (string) to a\n  // running item without changing its status. The queue can't reach into\n  // `I` to mutate it (the substrate is domain-agnostic), so callers that\n  // need to thread a backend id / URL / trace id through the lifecycle\n  // route it here. Consumers needing structured payloads should persist\n  // them in their own store and put the foreign-key string in `output`.\n  async function bindOutput(id: string, value: string): Promise<void> {\n    const queue = await list();\n    const { next, changed } = patchItemOp<I>(queue, id, (item) => ({\n      ...item,\n      output: value,\n    }));\n    if (changed) await store.save(next);\n  }\n\n  return {\n    enqueue,\n    claimNext,\n    markDone,\n    markFailed,\n    markCancelled,\n    resetRunningToPending,\n    removeItem,\n    retryItem,\n    bindOutput,\n    list,\n  };\n}\n"]}
+{"version":3,"sources":["../../src/internal/work-queue/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * internal/work-queue — substrate-agnostic work-queue lifecycle on `Store<S>`.\n *\n * Two public surfaces, one shape:\n *   - `createQueue(store)` (this file) is the in-process adapter — it binds the\n *     pure ops to an injected `Store` and runs `load → mutate → save`.\n *   - `internal/work-queue/ops` (`./ops`) is the BLESSED, importable surface\n *     of those same pure ops. L2 compositions that own their own Model slice\n *     (`monitored-run`, `idempotent-intake`, …) import the ops directly and\n *     delegate status flips to them instead of re-rolling the transitions.\n * Both routes call the identical ops, so the lifecycle rules live in exactly\n * one place. This mirrors `@demlik/tea/do`'s one-shape-per-package rule.\n *\n * The package is generic in the input payload `I` (audit-specific fields go\n * here in the extension host). `output` is a free-form side-channel correlation\n * token (a backend id, URL, trace id) — typed as `string` because that's its\n * only honest type. Consumers that need structured per-item data persist it in\n * their own store and put the foreign-key string in `output`.\n */\n\nimport type { Store } from \"../../index\";\nimport {\n  claimNextOp,\n  enqueueOp,\n  markDoneOp,\n  patchItemOp,\n  removeOp,\n  resetRunningOp,\n} from \"./ops\";\n\n/**\n * Generate a queue-item id at the adapter boundary. Reads `Date.now()` and\n * `Math.random()` — impure helpers belong in the adapter (`index.ts`),\n * never in `ops.ts` (which is purely-functional by contract). Uses native\n * UUID when available, falls back to timestamp + random for environments\n * without `crypto.randomUUID`.\n */\nfunction genId(): string {\n  return (\n    globalThis.crypto?.randomUUID?.() ??\n    `q_${Date.now()}_${Math.random().toString(36).slice(2)}`\n  );\n}\n\nexport type QueueItemStatus =\n  | \"pending\"\n  | \"running\"\n  | \"done\"\n  | \"failed\"\n  | \"cancelled\";\n\n/**\n * A single queue entry. Every field is `readonly`: a persisted slice is\n * immutable, so a transition returns a NEW item (the ops always spread —\n * `{ ...item, status: … }`) rather than mutating in place. This type-enforces\n * the durability invariant the consumers already honor by convention, and\n * keeps a slice round-trippable through JSON unchanged across a reload.\n */\nexport interface QueueItem<I> {\n  readonly id: string;\n  readonly status: QueueItemStatus;\n  readonly input: I;\n  readonly enqueuedAt: number;\n  readonly startedAt?: number;\n  readonly finishedAt?: number;\n  readonly output?: string;\n  readonly error?: string;\n}\n\n/**\n * Caller-facing enqueue payload. Just `I` today — kept named so future\n * variants (priority, deferUntil, …) can grow without breaking callers.\n */\nexport type EnqueueInput<I> = I;\n\n/**\n * Adapter that binds the pure ops to an injected `Store<QueueItem<I>[]>`.\n *\n * `load → mutate → save` is the only durability discipline this package\n * imposes. The store decides what \"save\" means (chrome.storage, KV, DO\n * storage, in-memory) — that decision belongs at the caller.\n *\n * Ops that don't change the queue (e.g. `markDone` on an unknown id) skip the\n * save call so the underlying store doesn't observe a write churn.\n */\nexport function createQueue<I>(store: Store<QueueItem<I>[]>) {\n  // `Store<S>.load()` returns `unknown` (invariant 8 boundary). Route\n  // through `store.migrate(raw)` to get the typed value before any\n  // queue operation reads it — same wiring the substrate's `run()` uses at\n  // boot. The work queue is a substrate-agnostic primitive on top of\n  // `Store<S>`, so it honors the same contract.\n  async function loadParsed(): Promise<QueueItem<I>[] | null> {\n    const raw = await store.load();\n    return store.migrate(raw);\n  }\n\n  async function list(): Promise<QueueItem<I>[]> {\n    return (await loadParsed()) ?? [];\n  }\n\n  async function enqueue(input: EnqueueInput<I>): Promise<QueueItem<I>> {\n    const queue = await list();\n    const { next, item } = enqueueOp<I>(queue, input, Date.now(), genId());\n    await store.save(next);\n    return item;\n  }\n\n  async function claimNext(): Promise<QueueItem<I> | null> {\n    const queue = await list();\n    const result = claimNextOp<I>(queue, Date.now());\n    if (!result) return null;\n    await store.save(result.next);\n    return result.claimed;\n  }\n\n  // `markDone` ignores the optional second arg by design: completed runs leave\n  // the queue, and the consumer is expected to persist any output (auditId,\n  // etc.) wherever those completed records belong. Kept in the signature for\n  // call-site readability and forward-compat with `bindOutput`.\n  async function markDone(id: string): Promise<void> {\n    const queue = await list();\n    const { next, changed } = markDoneOp<I>(queue, id);\n    if (changed) await store.save(next);\n  }\n\n  async function markFailed(id: string, error: string): Promise<void> {\n    const queue = await list();\n    const { next, changed } = patchItemOp<I>(queue, id, (item) => ({\n      ...item,\n      status: \"failed\",\n      finishedAt: Date.now(),\n      error,\n    }));\n    if (changed) await store.save(next);\n  }\n\n  async function markCancelled(id: string): Promise<void> {\n    const queue = await list();\n    const { next, changed } = patchItemOp<I>(queue, id, (item) => ({\n      ...item,\n      status: \"cancelled\",\n      finishedAt: Date.now(),\n    }));\n    if (changed) await store.save(next);\n  }\n\n  async function resetRunningToPending(): Promise<void> {\n    const queue = await list();\n    const { next, changed } = resetRunningOp<I>(queue);\n    if (changed) await store.save(next);\n  }\n\n  async function removeItem(id: string): Promise<void> {\n    const queue = await list();\n    const { next, changed } = removeOp<I>(queue, id);\n    if (changed) await store.save(next);\n  }\n\n  async function retryItem(id: string): Promise<void> {\n    const queue = await list();\n    const { next, changed } = patchItemOp<I>(queue, id, (item) => ({\n      ...item,\n      status: \"pending\",\n      startedAt: undefined,\n      finishedAt: undefined,\n      error: undefined,\n      output: undefined,\n    }));\n    if (changed) await store.save(next);\n  }\n\n  // `bindOutput` attaches a side-channel correlation token (string) to a\n  // running item without changing its status. The queue can't reach into\n  // `I` to mutate it (the substrate is domain-agnostic), so callers that\n  // need to thread a backend id / URL / trace id through the lifecycle\n  // route it here. Consumers needing structured payloads should persist\n  // them in their own store and put the foreign-key string in `output`.\n  async function bindOutput(id: string, value: string): Promise<void> {\n    const queue = await list();\n    const { next, changed } = patchItemOp<I>(queue, id, (item) => ({\n      ...item,\n      output: value,\n    }));\n    if (changed) await store.save(next);\n  }\n\n  return {\n    enqueue,\n    claimNext,\n    markDone,\n    markFailed,\n    markCancelled,\n    resetRunningToPending,\n    removeItem,\n    retryItem,\n    bindOutput,\n    list,\n  };\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@demlik/tea",
-  "version": "0.13.0",
-  "description": "TEA-faithful state machine substrate — one package, every host adapter. Core + subs + testing, plus React, Durable Object, Chrome extension, Node, in-memory, work-queue, devtools, and property-testing modules as subpaths.",
+  "version": "0.15.0",
+  "description": "TEA-faithful state machine substrate — one package, every host adapter. Core + subs + testing, plus React, Durable Object, Chrome extension, Node, in-memory, devtools, and property-testing modules as subpaths.",
   "keywords": [
     "tea",
     "elm-architecture",
@@ -31,257 +31,87 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
-    "./subs": {
-      "types": "./dist/subs/index.d.ts",
-      "import": "./dist/subs/index.js"
-    },
-    "./testing": {
-      "types": "./dist/testing/index.d.ts",
-      "import": "./dist/testing/index.js"
-    },
     "./do": {
       "types": "./dist/do/index.d.ts",
       "import": "./dist/do/index.js"
     },
+    "./node": {
+      "types": "./dist/node/index.d.ts",
+      "import": "./dist/node/index.js"
+    },
     "./mem": {
       "types": "./dist/mem/index.d.ts",
       "import": "./dist/mem/index.js"
     },
-    "./journal": {
-      "types": "./dist/journal/index.d.ts",
-      "import": "./dist/journal/index.js"
-    },
     "./react": {
       "types": "./dist/react/index.d.ts",
       "import": "./dist/react/index.js"
     },
-    "./devtools": {
-      "types": "./dist/devtools/index.d.ts",
-      "import": "./dist/devtools/index.js"
-    },
-    "./devtools/styles.css": "./dist/devtools/styles.css",
     "./extension": {
       "types": "./dist/extension/index.d.ts",
       "import": "./dist/extension/index.js"
     },
-    "./extension/react": {
-      "types": "./dist/extension/react.d.ts",
-      "import": "./dist/extension/react.js"
-    },
-    "./extension/subs": {
-      "types": "./dist/extension/subs/index.d.ts",
-      "import": "./dist/extension/subs/index.js"
-    },
-    "./extension/test-utils": {
-      "types": "./dist/extension/test-utils.d.ts",
-      "import": "./dist/extension/test-utils.js"
-    },
-    "./work-queue": {
-      "types": "./dist/work-queue/index.d.ts",
-      "import": "./dist/work-queue/index.js"
-    },
-    "./work-queue/ops": {
-      "types": "./dist/work-queue/ops.d.ts",
-      "import": "./dist/work-queue/ops.js"
-    },
-    "./work-queue/adapter": {
-      "types": "./dist/work-queue/adapter.d.ts",
-      "import": "./dist/work-queue/adapter.js"
-    },
-    "./node": {
-      "types": "./dist/node/index.d.ts",
-      "import": "./dist/node/index.js"
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js"
     },
     "./pbt": {
       "types": "./dist/pbt/index.d.ts",
       "import": "./dist/pbt/index.js"
     },
-    "./pbt/arbitraries": {
-      "types": "./dist/pbt/arbitraries/index.d.ts",
-      "import": "./dist/pbt/arbitraries/index.js"
-    },
-    "./pbt/runners": {
-      "types": "./dist/pbt/runners/index.d.ts",
-      "import": "./dist/pbt/runners/index.js"
+    "./agent": {
+      "types": "./dist/agent/index.d.ts",
+      "import": "./dist/agent/index.js"
     },
     "./retry-backoff": {
       "types": "./dist/retry-backoff/index.d.ts",
       "import": "./dist/retry-backoff/index.js"
     },
-    "./rate-limit": {
-      "types": "./dist/rate-limit/index.d.ts",
-      "import": "./dist/rate-limit/index.js"
-    },
     "./idempotency": {
       "types": "./dist/idempotency/index.d.ts",
       "import": "./dist/idempotency/index.js"
     },
-    "./idempotency/adapter": {
-      "types": "./dist/idempotency/adapter.d.ts",
-      "import": "./dist/idempotency/adapter.js"
+    "./flow": {
+      "types": "./dist/flow/index.d.ts",
+      "import": "./dist/flow/index.js"
     },
-    "./circuit-breaker": {
-      "types": "./dist/circuit-breaker/index.d.ts",
-      "import": "./dist/circuit-breaker/index.js"
+    "./resilience": {
+      "types": "./dist/resilience/index.d.ts",
+      "import": "./dist/resilience/index.js"
     },
-    "./cache": {
-      "types": "./dist/cache/index.d.ts",
-      "import": "./dist/cache/index.js"
+    "./timing": {
+      "types": "./dist/timing/index.d.ts",
+      "import": "./dist/timing/index.js"
     },
-    "./deadline": {
-      "types": "./dist/deadline/index.d.ts",
-      "import": "./dist/deadline/index.js"
+    "./persistence": {
+      "types": "./dist/persistence/index.d.ts",
+      "import": "./dist/persistence/index.js"
+    },
+    "./paginate": {
+      "types": "./dist/paginate/index.d.ts",
+      "import": "./dist/paginate/index.js"
+    },
+    "./work-queue": {
+      "types": "./dist/work-queue/index.d.ts",
+      "import": "./dist/work-queue/index.js"
     },
-    "./await-terminal": {
-      "types": "./dist/await-terminal/index.d.ts",
-      "import": "./dist/await-terminal/index.js"
+    "./jev": {
+      "types": "./dist/jev/index.d.ts",
+      "import": "./dist/jev/index.js"
     },
-    "./retry-to-success": {
-      "types": "./dist/retry-to-success/index.d.ts",
-      "import": "./dist/retry-to-success/index.js"
+    "./devtools": {
+      "types": "./dist/devtools/index.d.ts",
+      "import": "./dist/devtools/index.js"
     },
     "./machine-viz": {
       "types": "./dist/machine-viz/index.d.ts",
       "import": "./dist/machine-viz/index.js"
     },
-    "./debounce": {
-      "types": "./dist/debounce/index.d.ts",
-      "import": "./dist/debounce/index.js"
-    },
-    "./throttle": {
-      "types": "./dist/throttle/index.d.ts",
-      "import": "./dist/throttle/index.js"
-    },
-    "./recorder": {
-      "types": "./dist/recorder/index.d.ts",
-      "import": "./dist/recorder/index.js"
-    },
-    "./trace-replay": {
-      "types": "./dist/trace-replay/index.d.ts",
-      "import": "./dist/trace-replay/index.js"
-    },
-    "./paginator": {
-      "types": "./dist/paginator/index.d.ts",
-      "import": "./dist/paginator/index.js"
-    },
-    "./snapshot": {
-      "types": "./dist/snapshot/index.d.ts",
-      "import": "./dist/snapshot/index.js"
-    },
-    "./token-refresh": {
-      "types": "./dist/token-refresh/index.d.ts",
-      "import": "./dist/token-refresh/index.js"
-    },
-    "./resilient-call": {
-      "types": "./dist/resilient-call/index.d.ts",
-      "import": "./dist/resilient-call/index.js"
-    },
-    "./with-telemetry": {
-      "types": "./dist/with-telemetry/index.d.ts",
-      "import": "./dist/with-telemetry/index.js"
-    },
-    "./fan-out": {
-      "types": "./dist/fan-out/index.d.ts",
-      "import": "./dist/fan-out/index.js"
-    },
-    "./idempotent-intake": {
-      "types": "./dist/idempotent-intake/index.d.ts",
-      "import": "./dist/idempotent-intake/index.js"
-    },
-    "./poller": {
-      "types": "./dist/poller/index.d.ts",
-      "import": "./dist/poller/index.js"
-    },
-    "./workflow": {
-      "types": "./dist/workflow/index.d.ts",
-      "import": "./dist/workflow/index.js"
-    },
-    "./batch-window": {
-      "types": "./dist/batch-window/index.d.ts",
-      "import": "./dist/batch-window/index.js"
-    },
-    "./saga": {
-      "types": "./dist/saga/index.d.ts",
-      "import": "./dist/saga/index.js"
-    },
-    "./throttled-input": {
-      "types": "./dist/throttled-input/index.d.ts",
-      "import": "./dist/throttled-input/index.js"
-    },
-    "./monitored-run": {
-      "types": "./dist/monitored-run/index.d.ts",
-      "import": "./dist/monitored-run/index.js"
-    },
-    "./llm-call": {
-      "types": "./dist/llm-call/index.d.ts",
-      "import": "./dist/llm-call/index.js"
-    },
-    "./paginated-walk": {
-      "types": "./dist/paginated-walk/index.d.ts",
-      "import": "./dist/paginated-walk/index.js"
-    },
-    "./authed-call": {
-      "types": "./dist/authed-call/index.d.ts",
-      "import": "./dist/authed-call/index.js"
-    },
-    "./reconciler": {
-      "types": "./dist/reconciler/index.d.ts",
-      "import": "./dist/reconciler/index.js"
-    },
-    "./agent": {
-      "types": "./dist/agent/index.d.ts",
-      "import": "./dist/agent/index.js"
-    },
-    "./with-deadline": {
-      "types": "./dist/with-deadline/index.d.ts",
-      "import": "./dist/with-deadline/index.js"
-    },
-    "./with-resilience": {
-      "types": "./dist/with-resilience/index.d.ts",
-      "import": "./dist/with-resilience/index.js"
-    },
-    "./prediction": {
-      "types": "./dist/prediction/index.d.ts",
-      "import": "./dist/prediction/index.js"
-    },
-    "./pure": {
-      "types": "./dist/pure/index.d.ts",
-      "import": "./dist/pure/index.js"
-    },
     "./parity": {
       "types": "./dist/parity/index.d.ts",
       "import": "./dist/parity/index.js"
     },
-    "./chart": {
-      "types": "./dist/chart/index.d.ts",
-      "import": "./dist/chart/index.js"
-    },
-    "./chart/inspect": {
-      "types": "./dist/chart/inspect/index.d.ts",
-      "import": "./dist/chart/inspect/index.js"
-    },
-    "./chart/inspect/react": {
-      "types": "./dist/chart/inspect/react.d.ts",
-      "import": "./dist/chart/inspect/react.js"
-    },
-    "./chart/inspect/styles.css": "./dist/chart/inspect/styles.css",
-    "./chart/report": {
-      "types": "./dist/chart/report/index.d.ts",
-      "import": "./dist/chart/report/index.js"
-    },
-    "./chart/lane": {
-      "types": "./dist/chart/lane/index.d.ts",
-      "import": "./dist/chart/lane/index.js"
-    },
-    "./chart/lane/react": {
-      "types": "./dist/chart/lane/react.d.ts",
-      "import": "./dist/chart/lane/react.js"
-    },
-    "./chart/lane/server": {
-      "types": "./dist/chart/lane/server.d.ts",
-      "import": "./dist/chart/lane/server.js"
-    },
-    "./chart/lane/styles.css": "./dist/chart/lane/styles.css",
+    "./devtools/styles.css": "./dist/devtools/styles.css",
     "./package.json": "./package.json"
   },
   "dependencies": {
@@ -313,6 +143,7 @@
     }
   },
   "devDependencies": {
+    "@anthropic-ai/sdk": "0.124.0",
     "@biomejs/biome": "2.3.14",
     "@changesets/cli": "^2.27.11",
     "@cloudflare/workers-types": "4.20260312.1",
@@ -322,10 +153,9 @@
     "@types/react": "19.0.8",
     "@types/react-dom": "19.0.3",
     "@types/ws": "8.5.14",
-    "@vitejs/plugin-react": "^6.0.5",
+    "ai": "^7.0.93",
     "fast-check": "^3.23.0",
     "happy-dom": "^20.9.0",
-    "mermaid": "^11.16.1",
     "react": "19.0.0",
     "react-dom": "19.0.0",
     "tsup": "^8.3.5",
@@ -345,22 +175,19 @@
     "node": "23.7.0"
   },
   "scripts": {
-    "build": "NODE_OPTIONS=--max-old-space-size=8192 tsup && node build-viewer.mjs",
+    "build": "NODE_OPTIONS=--max-old-space-size=8192 tsup",
     "lint": "biome check src package.json",
     "lint:worktree": "biome check src package.json",
     "test": "vitest run",
-    "demo:saga": "vitest run src/workflow/demo.test.ts",
-    "lane:view": "vite --config demo/lane-view/vite.config.ts",
-    "lane:watch": "node --experimental-strip-types --disable-warning=ExperimentalWarning scripts/lane-watch.ts",
+    "demo:saga": "vitest run src/internal/flow/workflow/demo.test.ts",
     "typecheck": "tsc --noEmit",
     "typecheck:test": "tsc --noEmit -p tsconfig.test.json",
     "typecheck:consumers": "tsc -p tsconfig.consumers.json",
     "docs:reference": "TEA_DOCS_WRITE=1 vitest run src/docs/reference/generate-reference.test.ts",
     "docs:reference:check": "pnpm run docs:reference && git diff --exit-code -- docs/reference",
     "verify-exports": "node scripts/verify-exports.mjs",
-    "check:chart-probes": "node scripts/check-chart-probes.mjs",
+    "verify-optional-peer-install": "node scripts/verify-optional-peer-install.mjs",
     "check:merge-markers": "node scripts/check-merge-markers.mjs",
-    "release": "changeset",
-    "build:viewer": "node build-viewer.mjs"
+    "release": "changeset"
   }
 }

package/dist/authed-call/index.d.ts

@@ -1,120 +0,0 @@
-import { P as PortEmitter, C as Cmd } from '../core-Co0LWkIA.js';
-import { M as MsgType } from '../protocol-B5YmJr0d.js';
-import { ResilientConfig, ResilientState, RunCmd, SucceedMsg, FailMsg, ResilientTimerMsg, ResilientPorts } from '../resilient-call/index.js';
-import { TokenRefreshConfig, Token, TokenState, RefreshTokenCmd, TokenRefreshMsg } from '../token-refresh/index.js';
-import { DeadlineSub } from '../deadline/index.js';
-export { DeadlineExceeded, deadlineSub, subscribeDeadline } from '../deadline/index.js';
-import 'zod';
-import '../cache/index.js';
-import '../types-XS_miRnB.js';
-import '../circuit-breaker/index.js';
-import '../rate-limit/index.js';
-import '../retry-backoff/index.js';
-
-/**
- * The authed-call knob. It is `ResilientConfig` widened by the token dimension:
- *
- *   - `refresh` — the ONLY required field: the port that mints a fresh `Token`.
- *     Identical to token-refresh's `TokenRefreshPorts.refresh`; it is hoisted
- *     onto the config (not the ports) so the consumer spells the credential
- *     source once, the same way `rng` is curried onto the factory.
- *   - `skewMs` — token-refresh's refresh-ahead skew (optional, defaults to 0).
- *   - every `ResilientConfig` field (`retry` / `circuit` / `rateLimit` /
- *     `cache` / `deadline`) — passed straight through to the resilient-call
- *     knob, each still optional, each still "omit a brick → omit its gate".
- */
-interface AuthedConfig extends ResilientConfig, TokenRefreshConfig {
-    /** Mint a fresh credential. The single DI seam the auth dimension adds. */
-    readonly refresh: () => Promise<Token>;
-}
-/**
- * The composed slice. Three plain-data fields, no closures:
- *
- *   - `resilience` — resilient-call's entire slice (circuit, bucket, retry,
- *     cache, calls). Owned and mutated only via resilient-call's verbs.
- *   - `auth` — token-refresh's `{ token, stale }` slice. Owned and mutated only
- *     via token-refresh's verbs.
- *   - `authRetry` — per-key count of auth-retries (401 → refresh → retry) spent
- *     on a call. Caps the dance at one retry per call so a credential the server
- *     keeps rejecting cannot spin forever. A key absent from the record has
- *     spent zero. Cleared when a call settles or a fresh `attempt` starts.
- *
- * `pendingAuthRetry` carries the inputs of calls parked waiting for the refresh
- * to land, keyed so `onRefreshed` can re-issue exactly those calls. Plain data —
- * `input` is the same payload the call was issued with.
- */
-interface AuthedState<I, R> {
-    readonly resilience: ResilientState<I, R>;
-    readonly auth: TokenState;
-    readonly authRetry: Readonly<Record<string, number>>;
-    readonly pendingAuthRetry: Readonly<Record<string, I>>;
-}
-/** The two effects this knob emits: resilient-call's run, token-refresh's mint. */
-type AuthedCmd<I> = RunCmd<I> | RefreshTokenCmd;
-/**
- * Every Msg the knob's verbs fold. Resilient-call's settle + timer Msgs, token-
- * refresh's refresh-result Msgs, and the 401 trigger the consumer dispatches
- * when a guarded call comes back unauthorized.
- */
-type Unauthorized = {
-    readonly type: typeof MsgType.Unauthorized;
-    readonly key: string;
-    readonly at: number;
-};
-/**
- * The plain-data error a 401 we cannot fix settles with. A `{_tag, ...}`
- * sentinel — NEVER a `new Error(...)` — so the slice stays JSON-serializable
- * (an Error object round-trips to `{}` under JSON and carries a stack trace,
- * both of which break the slice's durability invariant once it is persisted
- * into a `Store<S>` and reloaded). Mirrors resilient-call's `DeadlineExceededError`
- * sentinel discipline. `key` echoes the call that was rejected so a consumer can
- * attribute the failure.
- */
-type UnauthorizedError = {
-    readonly _tag: "unauthorized";
-    readonly key: string;
-};
-/** Ports `handlers` needs — resilient-call's run port AND token-refresh's refresh port. */
-interface AuthedPorts<I, R> extends ResilientPorts<I, R> {
-    /** Mint a fresh credential. Mirrors `AuthedConfig.refresh` for symmetry at the splice site. */
-    readonly refresh: () => Promise<Token>;
-}
-/**
- * Build an authed-call knob from `config`. `rng` is injected for retry jitter
- * and threaded straight into the underlying resilient-call knob — pass a fixed
- * `() => 0.5` in tests to pin backoff; defaults to `Math.random` (read only at
- * the verb boundary inside resilient-call, never in a brick op).
- *
- * Returns the uniform L2 knob contract, widened by the auth verbs (`on401`,
- * `onRefreshed`, `installToken`). `I` is the port input type, `R` the result.
- */
-declare function createAuthedCall<I, R>(config: AuthedConfig, rng?: () => number): {
-    init: () => AuthedState<I, R>;
-    attempt: (s: AuthedState<I, R>, key: string, input: I, at: number) => readonly [AuthedState<I, R>, readonly AuthedCmd<I>[]];
-    succeed: (s: AuthedState<I, R>, key: string, msg: SucceedMsg<R>) => readonly [AuthedState<I, R>, readonly AuthedCmd<I>[]];
-    fail: (s: AuthedState<I, R>, key: string, msg: FailMsg) => readonly [AuthedState<I, R>, readonly AuthedCmd<I>[]];
-    on401: (s: AuthedState<I, R>, key: string, at: number) => readonly [AuthedState<I, R>, readonly AuthedCmd<I>[]];
-    installToken: (s: AuthedState<I, R>, token: Token) => AuthedState<I, R>;
-    onRefreshed: (s: AuthedState<I, R>, at: number) => readonly [AuthedState<I, R>, readonly AuthedCmd<I>[]];
-    onTimer: (s: AuthedState<I, R>, msg: ResilientTimerMsg) => readonly [AuthedState<I, R>, readonly AuthedCmd<I>[]];
-    /** token-refresh's call-boundary verb, re-exposed for proactive expiry refresh. */
-    needsRefresh: (s: AuthedState<I, R>, at: number) => boolean;
-    subs: (s: AuthedState<I, R>) => readonly DeadlineSub[];
-    handlers: (ports: AuthedPorts<I, R>) => {
-        refresh_token: (cmd: RefreshTokenCmd, ctx: PortEmitter, dispatch?: ((msg: TokenRefreshMsg) => void) | undefined) => Promise<void | TokenRefreshMsg>;
-        resilient_run: (cmd: RunCmd<I>, ctx: Readonly<Record<never, never>>) => Promise<FailMsg | SucceedMsg<R>>;
-    };
-};
-/** The shape `createAuthedCall` returns — useful for typing a held knob. */
-type AuthedCall<I, R> = ReturnType<typeof createAuthedCall<I, R>>;
-/**
- * Lift a knob result `[slice, cmds]` into a host `[State, cmds]` where the slice
- * lives at `state.authed`. A convenience for the common single-slice host;
- * consumers with a differently-named field spread by hand. Pure — a thin record
- * rebuild, no clock / RNG.
- */
-declare function liftAuthed<S extends {
-    authed: AuthedState<I, R>;
-}, I, R, C extends Cmd>(state: S, [slice, cmds]: readonly [AuthedState<I, R>, readonly C[]]): readonly [S, readonly C[]];
-
-export { type AuthedCall, type AuthedCmd, type AuthedConfig, type AuthedPorts, type AuthedState, DeadlineSub, FailMsg, ResilientState, ResilientTimerMsg, RunCmd, SucceedMsg, Token, TokenRefreshMsg, TokenState, type Unauthorized, type UnauthorizedError, createAuthedCall, liftAuthed };

package/dist/authed-call/index.js

@@ -1,134 +0,0 @@
-import { createTokenRefresh, refreshTokenCmd } from '../chunk-CLM6ERNO.js';
-import { createResilientCall } from '../chunk-4KLG43GY.js';
-import '../chunk-JELSZN25.js';
-import '../chunk-RH5EFRVJ.js';
-export { deadlineSub, subscribeDeadline } from '../chunk-DGE4PV4A.js';
-import '../chunk-Q2UM7BXU.js';
-import '../chunk-S2EGRPCM.js';
-import '../chunk-UF4MZSLT.js';
-import '../chunk-VYFAZN3F.js';
-import '../chunk-2YFLOCWX.js';
-import '../chunk-ZJ5AOYBH.js';
-import '../chunk-ZSUUOEPL.js';
-import { without } from '../chunk-OOYD44JI.js';
-
-// src/authed-call/index.ts
-function createAuthedCall(config, rng = Math.random) {
-  const rc = createResilientCall(config, rng);
-  const tr = createTokenRefresh({ skewMs: config.skewMs });
-  function init() {
-    return {
-      resilience: rc.init(),
-      auth: tr.init(),
-      authRetry: {},
-      pendingAuthRetry: {}
-    };
-  }
-  function liftResilient(s, [resilience, cmds]) {
-    return [{ ...s, resilience }, cmds];
-  }
-  function clearAuthKey(s, key) {
-    return {
-      ...s,
-      authRetry: without(s.authRetry, key),
-      pendingAuthRetry: without(s.pendingAuthRetry, key)
-    };
-  }
-  function attempt(s, key, input, at) {
-    const cleared = clearAuthKey(s, key);
-    return liftResilient(
-      cleared,
-      rc.attempt(cleared.resilience, key, input, at)
-    );
-  }
-  function succeed(s, key, msg) {
-    const settled = clearAuthKey(s, key);
-    return liftResilient(settled, rc.succeed(settled.resilience, key, msg));
-  }
-  function fail(s, key, msg) {
-    const [resilience, cmds] = rc.fail(s.resilience, key, msg);
-    const next = settleAuthIfDone({ ...s, resilience }, key, resilience);
-    return [next, cmds];
-  }
-  function on401(s, key, at) {
-    const spent = s.authRetry[key] ?? 0;
-    const call = s.resilience.calls[key];
-    const input = call?.phase === "running" || call?.phase === "waiting_retry" ? call.input : void 0;
-    if (spent >= 1 || input === void 0) {
-      const error = { _tag: "unauthorized", key };
-      const [settled] = rc.settleFailed(s.resilience, key, error);
-      return [{ ...clearAuthKey(s, key), resilience: settled }, []];
-    }
-    return [
-      {
-        ...s,
-        auth: tr.on401(s.auth),
-        authRetry: { ...s.authRetry, [key]: spent + 1 },
-        pendingAuthRetry: { ...s.pendingAuthRetry, [key]: input }
-      },
-      [refreshTokenCmd()]
-    ];
-  }
-  function installToken(s, token) {
-    return { ...s, auth: tr.refreshed(s.auth, token) };
-  }
-  function onRefreshed(s, at) {
-    const parked = Object.entries(s.pendingAuthRetry);
-    if (parked.length === 0) return [s, []];
-    let resilience = s.resilience;
-    const cmds = [];
-    for (const [key, input] of parked) {
-      const [next, runCmds] = rc.attempt(resilience, key, input, at);
-      resilience = next;
-      cmds.push(...runCmds);
-    }
-    return [{ ...s, resilience, pendingAuthRetry: {} }, cmds];
-  }
-  function onTimer(s, msg) {
-    const [resilience, cmds] = rc.onTimer(s.resilience, msg);
-    const next = settleAuthIfDone({ ...s, resilience }, void 0, resilience);
-    return [next, cmds];
-  }
-  function settleAuthIfDone(s, onlyKey, resilience) {
-    const keys = onlyKey !== void 0 ? [onlyKey] : Object.keys(s.authRetry);
-    let next = s;
-    for (const key of keys) {
-      const phase = resilience.calls[key]?.phase;
-      if (phase === "succeeded" || phase === "failed") {
-        next = clearAuthKey(next, key);
-      }
-    }
-    return next;
-  }
-  function subs(s) {
-    return rc.subs(s.resilience);
-  }
-  function handlers(ports) {
-    const trPorts = { refresh: ports.refresh };
-    return {
-      ...rc.handlers({ run: ports.run }),
-      ...tr.handlers(trPorts)
-    };
-  }
-  return {
-    init,
-    attempt,
-    succeed,
-    fail,
-    on401,
-    installToken,
-    onRefreshed,
-    onTimer,
-    /** token-refresh's call-boundary verb, re-exposed for proactive expiry refresh. */
-    needsRefresh: (s, at) => tr.needsRefresh(s.auth, at),
-    subs,
-    handlers
-  };
-}
-function liftAuthed(state, [slice, cmds]) {
-  return [{ ...state, authed: slice }, cmds];
-}
-
-export { createAuthedCall, liftAuthed };
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map