stitchkit 0.93.0 → 0.94.1

package/llms.txt

@@ -2,16 +2,66 @@
 
 > Contract-first backend framework for Bun and Node. One `defineContract()` becomes an HTTP API, MCP tools, AI-agent tools, a CLI and a fully-typed client — one source of truth, no drift.
 
-Build with stitchkit: define a contract once, then `implement` it and serve it (`createServer` on Bun, `serveNode` on Node ≥ 22). The same contract drives MCP / agent tools and a typed client, so the transports cannot diverge. The pages below are the full guide; `llms-full.txt` (in this package) inlines all of them for offline reading.
+Build with stitchkit: define a contract once, then `implement` it and serve it (`createServer` on Bun, `serveNode` on Node ≥ 22). The same contract drives MCP / agent tools and a typed client, so the transports cannot diverge.
 
-## Guide
+## How to read these docs
+
+Load the slice for each entrypoint your code imports — `import … from 'stitchkit/server'` → `llms/server.txt`; the root `stitchkit` import → `llms/stitchkit.txt`. A slice holds that entrypoint's API reference section and the guide pages whose home it is; every guide lives in exactly one slice, and a slice that needs another's guide names it under "Also read". Each file is at most 50.0 KB; a longer one continues in numbered parts, each naming the next at its top. Moving across versions: load `llms/upgrading.txt` and the range slices it lists between your version and the target. `llms-full.txt` inlines everything; it is far larger than a context window, so do not read it whole.
+
+## Entrypoint slices
+- **stitchkit**: [llms/stitchkit.txt](llms/stitchkit.txt) 15.1 KB → [llms/stitchkit.2.txt](llms/stitchkit.2.txt) 35.0 KB → [llms/stitchkit.3.txt](llms/stitchkit.3.txt) 14.2 KB
+- **stitchkit/live**: [llms/live.txt](llms/live.txt) 21.2 KB
+- **stitchkit/react**: [llms/react.txt](llms/react.txt) 8.6 KB
+- **stitchkit/tools**: [llms/tools.txt](llms/tools.txt) 44.9 KB → [llms/tools.2.txt](llms/tools.2.txt) 26.3 KB → [llms/tools.3.txt](llms/tools.3.txt) 25.4 KB
+- **stitchkit/tools/contract**: [llms/tools-contract.txt](llms/tools-contract.txt) 0.2 KB
+- **stitchkit/tools/invoker**: [llms/tools-invoker.txt](llms/tools-invoker.txt) 0.2 KB
+- **stitchkit/tools/connections**: [llms/tools-connections.txt](llms/tools-connections.txt) 3.1 KB
+- **stitchkit/cli**: [llms/cli.txt](llms/cli.txt) 41.3 KB → [llms/cli.2.txt](llms/cli.2.txt) 8.1 KB
+- **stitchkit/remote**: [llms/remote.txt](llms/remote.txt) 1.0 KB
+- **stitchkit/contract**: [llms/contract.txt](llms/contract.txt) 31.9 KB
+- **stitchkit/primitives**: [llms/primitives.txt](llms/primitives.txt) 9.3 KB
+- **stitchkit/server**: [llms/server.txt](llms/server.txt) 45.3 KB → [llms/server.2.txt](llms/server.2.txt) 14.6 KB → [llms/server.3.txt](llms/server.3.txt) 42.7 KB → [llms/server.4.txt](llms/server.4.txt) 37.3 KB → [llms/server.5.txt](llms/server.5.txt) 21.8 KB
+- **stitchkit/observability**: [llms/observability.txt](llms/observability.txt) 42.8 KB
+- **stitchkit/agent-runtime**: [llms/agent-runtime.txt](llms/agent-runtime.txt) 46.6 KB → [llms/agent-runtime.2.txt](llms/agent-runtime.2.txt) 29.8 KB → [llms/agent-runtime.3.txt](llms/agent-runtime.3.txt) 31.8 KB
+- **stitchkit/agent-runtime/testing**: [llms/agent-runtime-testing.txt](llms/agent-runtime-testing.txt) 2.2 KB
+- **stitchkit/agent-runtime/harness**: [llms/agent-runtime-harness.txt](llms/agent-runtime-harness.txt) 4.1 KB
+- **stitchkit/agent-runtime/coding-tools**: [llms/agent-runtime-coding-tools.txt](llms/agent-runtime-coding-tools.txt) 4.9 KB
+- **stitchkit/agent-runtime/browser**: [llms/agent-runtime-browser.txt](llms/agent-runtime-browser.txt) 1.6 KB
+- **stitchkit/agent-runtime/openrouter**: [llms/agent-runtime-openrouter.txt](llms/agent-runtime-openrouter.txt) 1.1 KB
+- **stitchkit/agent-runtime/sqlite/bun**: [llms/agent-runtime-sqlite-bun.txt](llms/agent-runtime-sqlite-bun.txt) 1.8 KB
+- **stitchkit/agent-runtime/sqlite/node**: [llms/agent-runtime-sqlite-node.txt](llms/agent-runtime-sqlite-node.txt) 1.7 KB
+- **stitchkit/application**: [llms/application.txt](llms/application.txt) 38.0 KB → [llms/application.2.txt](llms/application.2.txt) 31.6 KB
+- **stitchkit/application/grammy**: [llms/application-grammy.txt](llms/application-grammy.txt) 1.5 KB
+- **stitchkit/application/opentelemetry**: [llms/application-opentelemetry.txt](llms/application-opentelemetry.txt) 1.6 KB
+- **stitchkit/application/diagnostic-journal**: [llms/application-diagnostic-journal.txt](llms/application-diagnostic-journal.txt) 1.4 KB
+- **stitchkit/application/schemas**: [llms/application-schemas.txt](llms/application-schemas.txt) 1.8 KB
+- **stitchkit/testing**: [llms/testing.txt](llms/testing.txt) 30.8 KB
+- **stitchkit/agent-runtime/sandbox**: [llms/agent-runtime-sandbox.txt](llms/agent-runtime-sandbox.txt) 8.1 KB
+- **stitchkit/files**: [llms/files.txt](llms/files.txt) 2.9 KB
+- **stitchkit/telegram**: [llms/telegram.txt](llms/telegram.txt) 2.0 KB
+- **stitchkit/tracking**: [llms/tracking.txt](llms/tracking.txt) 16.8 KB
+- **stitchkit/release**: [llms/release.txt](llms/release.txt) 8.9 KB
+- **stitchkit/tracking/server**: [llms/tracking-server.txt](llms/tracking-server.txt) 2.5 KB
+- **stitchkit/geo**: [llms/geo.txt](llms/geo.txt) 4.3 KB
+- **stitchkit/oauth**: [llms/oauth.txt](llms/oauth.txt) 6.7 KB
+- **stitchkit/google**: [llms/google.txt](llms/google.txt) 1.4 KB
+- **stitchkit/declaration**: [llms/declaration.txt](llms/declaration.txt) 16.0 KB
+- **stitchkit/node**: [llms/node.txt](llms/node.txt) 3.1 KB
+
+## Upgrading slices
+- **Upgrading — how to move across versions**: [llms/upgrading.txt](llms/upgrading.txt) 10.3 KB
+- **Upgrading 0.68.0 → 0.94.0**: [llms/upgrading-0.68.0-0.94.0.txt](llms/upgrading-0.68.0-0.94.0.txt) 46.5 KB
+- **Upgrading 0.53.0 → 0.67.0**: [llms/upgrading-0.53.0-0.67.0.txt](llms/upgrading-0.53.0-0.67.0.txt) 46.1 KB
+- **Upgrading 0.37.0 → 0.50.0**: [llms/upgrading-0.37.0-0.50.0.txt](llms/upgrading-0.37.0-0.50.0.txt) 31.6 KB
+
+## Guide (web)
 - [Getting started](https://github.com/max-listov/stitchkit/blob/master/docs/guide/getting-started.md): install, entrypoints, and a first contract → server → client app
 - [Release](https://github.com/max-listov/stitchkit/blob/master/docs/guide/release.md): stitchkit/release — the page reloads onto the release it was built for: build marker, X-Build-Id header, socket event, reload policy, the deploy signal
 - [Visitor tracking](https://github.com/max-listov/stitchkit/blob/master/docs/guide/tracking.md): stitchkit/tracking — the browser client, outbox, page-leave beacon, attribution; stitchkit/tracking/server — dispositions and the visit lease over your store
 - [Contracts](https://github.com/max-listov/stitchkit/blob/master/docs/guide/contracts.md): every endpoint field — method, path, params/input/output, scope, expose, meta, multipart
 - [HTTP server](https://github.com/max-listov/stitchkit/blob/master/docs/guide/server.md): createServer/createHandler, implement, lifecycle hooks, raw routes + raw-response endpoints + helpers, scopePrefixes, serveFile, primitives
 - [Typed client](https://github.com/max-listov/stitchkit/blob/master/docs/guide/client.md): createClient/createHttpClient, the typed call surface, scoped clients, SSE
-- [MCP & agents](https://github.com/max-listov/stitchkit/blob/master/docs/guide/mcp-and-agents.md): contracts as MCP tools (createMcpHandler) and AI-agent tools (mountAgent); tool lifecycle, extend, identity
+- [MCP & agents](https://github.com/max-listov/stitchkit/blob/master/docs/guide/mcp-and-agents.md): contracts as MCP tools (createMcpHandler) and AI-agent tools (mountAgent); tool lifecycle, extend, identity, a separate tool answer (withToolView)
 - [Agent application runtime](https://github.com/max-listov/stitchkit/blob/master/docs/guide/agent-runtime.md): optional durable history, prompt/model composition, stream loop, coordination, fencing and events
 - [Managed application kernel](https://github.com/max-listov/stitchkit/blob/master/docs/guide/application-kernel.md): process-local resources, readiness, admission, schedules, projections and optional provider adapters
 - [Optional process sandbox](https://github.com/max-listov/stitchkit/blob/master/docs/guide/sandbox.md): Linux Bubblewrap sessions, durable workspace reconnect, network policy and host credential brokering
@@ -31,6 +81,5 @@ Build with stitchkit: define a contract once, then `implement` it and serve it (
 - [Upgrading](https://github.com/max-listov/stitchkit/blob/master/docs/guide/upgrading.md): moving a project across stitchkit versions; how breaking changes are marked
 - [Project declaration](https://github.com/max-listov/stitchkit/blob/master/docs/guide/declaration.md): the optional machine-readable statement a repository makes about itself — identity, roles, build, requirements, release steps and the names of the values a deployment supplies
 
-## Reference
+## Reference (web)
 - [API reference](https://github.com/max-listov/stitchkit/blob/master/docs/api/reference.md): every public export, grouped by entrypoint, each linked to the guide
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stitchkit",
-  "version": "0.93.0",
+  "version": "0.94.1",
   "description": "Contract-first backend framework — one defineContract() into an HTTP API, MCP tools, AI-agent tools and a typed client. Bun and Node.",
   "keywords": [
     "bun",
@@ -35,171 +35,172 @@
     "node": ">=22"
   },
   "bin": {
-    "stitchkit": "./dist/upgrade-cli.js"
+    "stitchkit": "./dist/entrypoints/bin/upgrade-cli.js"
   },
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/entrypoints/index.js",
+  "types": "./dist/entrypoints/index.d.ts",
   "files": [
     "dist",
     "native/*.node",
     "llms.txt",
     "llms-full.txt",
+    "llms",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
   ],
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "types": "./dist/entrypoints/index.d.ts",
+      "import": "./dist/entrypoints/index.js"
     },
     "./live": {
-      "types": "./dist/live.d.ts",
-      "import": "./dist/live.js"
+      "types": "./dist/entrypoints/live.d.ts",
+      "import": "./dist/entrypoints/live.js"
     },
     "./react": {
-      "types": "./dist/react.d.ts",
-      "import": "./dist/react.js"
+      "types": "./dist/entrypoints/react.d.ts",
+      "import": "./dist/entrypoints/react.js"
     },
     "./tools": {
-      "types": "./dist/tools.d.ts",
-      "import": "./dist/tools.js"
+      "types": "./dist/entrypoints/tools.d.ts",
+      "import": "./dist/entrypoints/tools.js"
     },
     "./tools/contract": {
-      "types": "./dist/tools-contract.d.ts",
-      "import": "./dist/tools-contract.js"
+      "types": "./dist/entrypoints/tools/contract.d.ts",
+      "import": "./dist/entrypoints/tools/contract.js"
     },
     "./tools/invoker": {
-      "types": "./dist/tool-invoker.d.ts",
-      "import": "./dist/tool-invoker.js"
+      "types": "./dist/entrypoints/tools/invoker.d.ts",
+      "import": "./dist/entrypoints/tools/invoker.js"
     },
     "./tools/connections": {
-      "types": "./dist/tools/connections/index.d.ts",
-      "import": "./dist/tools/connections/index.js"
+      "types": "./dist/entrypoints/tools/connections.d.ts",
+      "import": "./dist/entrypoints/tools/connections.js"
     },
     "./cli": {
-      "types": "./dist/cli.d.ts",
-      "import": "./dist/cli.js"
+      "types": "./dist/entrypoints/cli.d.ts",
+      "import": "./dist/entrypoints/cli.js"
     },
     "./remote": {
-      "types": "./dist/remote.d.ts",
-      "import": "./dist/remote.js"
+      "types": "./dist/entrypoints/remote.d.ts",
+      "import": "./dist/entrypoints/remote.js"
     },
     "./contract": {
-      "types": "./dist/contract/index.d.ts",
-      "import": "./dist/contract/index.js"
+      "types": "./dist/entrypoints/contract.d.ts",
+      "import": "./dist/entrypoints/contract.js"
     },
     "./primitives": {
-      "types": "./dist/primitives.d.ts",
-      "import": "./dist/primitives.js"
+      "types": "./dist/entrypoints/primitives.d.ts",
+      "import": "./dist/entrypoints/primitives.js"
     },
     "./server": {
-      "types": "./dist/server/index.d.ts",
-      "import": "./dist/server/index.js"
+      "types": "./dist/entrypoints/server.d.ts",
+      "import": "./dist/entrypoints/server.js"
     },
     "./observability": {
-      "types": "./dist/observability/index.d.ts",
-      "import": "./dist/observability/index.js"
+      "types": "./dist/entrypoints/observability.d.ts",
+      "import": "./dist/entrypoints/observability.js"
     },
     "./agent-runtime": {
-      "types": "./dist/agent-runtime.d.ts",
-      "import": "./dist/agent-runtime.js"
+      "types": "./dist/entrypoints/agent-runtime.d.ts",
+      "import": "./dist/entrypoints/agent-runtime.js"
     },
     "./agent-runtime/testing": {
-      "types": "./dist/agent-runtime-testing.d.ts",
-      "import": "./dist/agent-runtime-testing.js"
+      "types": "./dist/entrypoints/agent-runtime/testing.d.ts",
+      "import": "./dist/entrypoints/agent-runtime/testing.js"
     },
     "./agent-runtime/harness": {
-      "types": "./dist/agent-runtime-harness.d.ts",
-      "import": "./dist/agent-runtime-harness.js"
+      "types": "./dist/entrypoints/agent-runtime/harness.d.ts",
+      "import": "./dist/entrypoints/agent-runtime/harness.js"
     },
     "./agent-runtime/coding-tools": {
-      "types": "./dist/agent-runtime-coding-tools.d.ts",
-      "import": "./dist/agent-runtime-coding-tools.js"
+      "types": "./dist/entrypoints/agent-runtime/coding-tools.d.ts",
+      "import": "./dist/entrypoints/agent-runtime/coding-tools.js"
     },
     "./agent-runtime/browser": {
-      "types": "./dist/agent-runtime-browser.d.ts",
-      "import": "./dist/agent-runtime-browser.js"
+      "types": "./dist/entrypoints/agent-runtime/browser.d.ts",
+      "import": "./dist/entrypoints/agent-runtime/browser.js"
     },
     "./agent-runtime/openrouter": {
-      "types": "./dist/agent-runtime-openrouter.d.ts",
-      "import": "./dist/agent-runtime-openrouter.js"
+      "types": "./dist/entrypoints/agent-runtime/openrouter.d.ts",
+      "import": "./dist/entrypoints/agent-runtime/openrouter.js"
     },
     "./agent-runtime/sqlite/bun": {
-      "types": "./dist/agent-runtime-sqlite-bun.d.ts",
-      "import": "./dist/agent-runtime-sqlite-bun.js"
+      "types": "./dist/entrypoints/agent-runtime/sqlite/bun.d.ts",
+      "import": "./dist/entrypoints/agent-runtime/sqlite/bun.js"
     },
     "./agent-runtime/sqlite/node": {
-      "types": "./dist/agent-runtime-sqlite-node.d.ts",
-      "import": "./dist/agent-runtime-sqlite-node.js"
+      "types": "./dist/entrypoints/agent-runtime/sqlite/node.d.ts",
+      "import": "./dist/entrypoints/agent-runtime/sqlite/node.js"
     },
     "./application": {
-      "types": "./dist/application.d.ts",
-      "import": "./dist/application.js"
+      "types": "./dist/entrypoints/application.d.ts",
+      "import": "./dist/entrypoints/application.js"
     },
     "./application/grammy": {
-      "types": "./dist/application-grammy.d.ts",
-      "import": "./dist/application-grammy.js"
+      "types": "./dist/entrypoints/application/grammy.d.ts",
+      "import": "./dist/entrypoints/application/grammy.js"
     },
     "./application/opentelemetry": {
-      "types": "./dist/application-opentelemetry.d.ts",
-      "import": "./dist/application-opentelemetry.js"
+      "types": "./dist/entrypoints/application/opentelemetry.d.ts",
+      "import": "./dist/entrypoints/application/opentelemetry.js"
     },
     "./application/diagnostic-journal": {
-      "types": "./dist/application-diagnostic-journal.d.ts",
-      "import": "./dist/application-diagnostic-journal.js"
+      "types": "./dist/entrypoints/application/diagnostic-journal.d.ts",
+      "import": "./dist/entrypoints/application/diagnostic-journal.js"
     },
     "./application/schemas": {
-      "types": "./dist/application-schemas.d.ts",
-      "import": "./dist/application-schemas.js"
+      "types": "./dist/entrypoints/application/schemas.d.ts",
+      "import": "./dist/entrypoints/application/schemas.js"
     },
     "./testing": {
-      "types": "./dist/testing.d.ts",
-      "import": "./dist/testing.js"
+      "types": "./dist/entrypoints/testing.d.ts",
+      "import": "./dist/entrypoints/testing.js"
     },
     "./agent-runtime/sandbox": {
-      "types": "./dist/agent-runtime-sandbox.d.ts",
-      "import": "./dist/agent-runtime-sandbox.js"
+      "types": "./dist/entrypoints/agent-runtime/sandbox.d.ts",
+      "import": "./dist/entrypoints/agent-runtime/sandbox.js"
     },
     "./files": {
-      "types": "./dist/files.d.ts",
-      "import": "./dist/files.js"
+      "types": "./dist/entrypoints/files.d.ts",
+      "import": "./dist/entrypoints/files.js"
     },
     "./telegram": {
-      "types": "./dist/telegram.d.ts",
-      "import": "./dist/telegram.js"
+      "types": "./dist/entrypoints/telegram.d.ts",
+      "import": "./dist/entrypoints/telegram.js"
     },
     "./tracking": {
-      "types": "./dist/tracking.d.ts",
-      "import": "./dist/tracking.js"
+      "types": "./dist/entrypoints/tracking.d.ts",
+      "import": "./dist/entrypoints/tracking.js"
     },
     "./release": {
-      "types": "./dist/release.d.ts",
-      "import": "./dist/release.js"
+      "types": "./dist/entrypoints/release.d.ts",
+      "import": "./dist/entrypoints/release.js"
     },
     "./tracking/server": {
-      "types": "./dist/tracking-server.d.ts",
-      "import": "./dist/tracking-server.js"
+      "types": "./dist/entrypoints/tracking/server.d.ts",
+      "import": "./dist/entrypoints/tracking/server.js"
     },
     "./geo": {
-      "types": "./dist/geo.d.ts",
-      "import": "./dist/geo.js"
+      "types": "./dist/entrypoints/geo.d.ts",
+      "import": "./dist/entrypoints/geo.js"
     },
     "./oauth": {
-      "types": "./dist/oauth.d.ts",
-      "import": "./dist/oauth.js"
+      "types": "./dist/entrypoints/oauth.d.ts",
+      "import": "./dist/entrypoints/oauth.js"
     },
     "./google": {
-      "types": "./dist/google.d.ts",
-      "import": "./dist/google.js"
+      "types": "./dist/entrypoints/google.d.ts",
+      "import": "./dist/entrypoints/google.js"
     },
     "./declaration": {
-      "types": "./dist/declaration.d.ts",
-      "import": "./dist/declaration.js"
+      "types": "./dist/entrypoints/declaration.d.ts",
+      "import": "./dist/entrypoints/declaration.js"
     },
     "./node": {
-      "types": "./dist/node.d.ts",
-      "import": "./dist/node.js"
+      "types": "./dist/entrypoints/node.d.ts",
+      "import": "./dist/entrypoints/node.js"
     }
   },
   "publishConfig": {
@@ -211,7 +212,7 @@
     "build:js": "bun run build:entrypoints && bun scripts/preserve-webpack-ignore.mjs",
     "build:types": "bun x tsc -p tsconfig.build.json --emitDeclarationOnly && bun scripts/rewrite-declaration-specifiers.mjs",
     "build": "bun ../../scripts/package-build-lock.ts -- bun run build:unlocked",
-    "build:unlocked": "rm -rf dist && cp ../../CHANGELOG.md ./CHANGELOG.md && bun run build:js && chmod +x dist/upgrade-cli.js && bun run build:types && bun scripts/check-browser-clean.mjs && bun scripts/check-browser-executes.mjs && bun scripts/check-env-live.mjs && bun scripts/check-public-types.mjs && bun scripts/check-durability-port-standalone.mjs && bun scripts/check-declarations-strict.mjs",
+    "build:unlocked": "rm -rf dist && cp ../../CHANGELOG.md ./CHANGELOG.md && bun run build:js && chmod +x dist/entrypoints/bin/upgrade-cli.js && bun run build:types && bun scripts/check-browser-clean.mjs && bun scripts/check-browser-executes.mjs && bun scripts/check-env-live.mjs && bun scripts/check-public-types.mjs && bun scripts/check-durability-port-standalone.mjs && bun scripts/check-declarations-strict.mjs",
     "dev": "bun run build:entrypoints -- --watch",
     "prepack": "cp ../../README.md ./README.md && bun ../../scripts/gen-llms.ts && bun run build",
     "test": "bun test",
@@ -306,12 +307,12 @@
     "@opentelemetry/api": "^1.9.0",
     "@socket.io/bun-engine": "^0.1.2",
     "@socket.io/component-emitter": "^3.1.2",
-    "@tanstack/react-query": "5.103.1",
+    "@tanstack/react-query": "5.103.2",
     "@types/bun": "^1.4.2",
     "@types/json-schema": "^7.0.15",
     "@types/react": "^19.3.0",
     "@typescript/typescript6": "^6.0.2",
-    "ai": "^7.0.107",
+    "ai": "^7.0.111",
     "fake-indexeddb": "^6.2.5",
     "grammy": "^1.46.0",
     "google-auth-library": "^11.1.0",

package/dist/agent-runtime/durability-contract.d.ts

@@ -1,176 +0,0 @@
-import { z } from 'zod';
-import type { AgentStoreEventEnvelope, AgentStoreEventPage, AppendAgentStoreEvent, ReadAgentStoreEvents } from './store-events.js';
-/**
- * The durable ledger a local step implementation needs.
- *
- * Narrower than `AgentRuntimeStore` on purpose: durability owns no records of
- * its own, it reads and appends the conversation's canonical event log, so a
- * store that already satisfies this slice can back it without the rest of the
- * runtime.
- *
- * A park (`sleep`/`waitFor`) is recorded the same way a step result is: as an
- * ordinary event in this ledger. The local scheduler waits in-process, and a
- * reconstruction resumes from the records that survived a restart.
- */
-export interface StepDurabilityLedger {
-    appendEvent(input: AppendAgentStoreEvent): Promise<AgentStoreEventEnvelope>;
-    readEvents(input: ReadAgentStoreEvents): Promise<AgentStoreEventPage>;
-}
-/** Event kind carrying one recorded step result in the canonical ledger. */
-export declare const DURABILITY_STEP_EVENT_KIND = "durability/step";
-/** Event kind recording that a run parked on time or on an external event. */
-export declare const DURABILITY_PARK_EVENT_KIND = "durability/park";
-/** Event kind recording an external event delivered to a parked wait. */
-export declare const DURABILITY_EVENT_EVENT_KIND = "durability/event";
-export declare const StepEventPayloadSchema: z.ZodObject<{
-    runId: z.ZodString;
-    stepName: z.ZodString;
-    encoded: z.ZodString;
-}, z.core.$strip>;
-export declare const ParkEventPayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    runId: z.ZodString;
-    kind: z.ZodLiteral<"sleep">;
-    name: z.ZodString;
-    deadline: z.ZodNumber;
-}, z.core.$strip>, z.ZodObject<{
-    runId: z.ZodString;
-    kind: z.ZodLiteral<"wait">;
-    event: z.ZodString;
-    id: z.ZodString;
-}, z.core.$strip>], "kind">;
-export declare const DeliveredEventPayloadSchema: z.ZodObject<{
-    runId: z.ZodString;
-    event: z.ZodString;
-    id: z.ZodString;
-    encoded: z.ZodString;
-}, z.core.$strip>;
-export type ParkEventPayload = z.infer<typeof ParkEventPayloadSchema>;
-export type StepEventPayload = z.infer<typeof StepEventPayloadSchema>;
-/**
- * The time source a park uses.
- *
- * `now` is the wall clock the durable sleep deadline is stamped from and
- * re-evaluated against, so a reconstructed park resumes from the recorded
- * value. A test replaces the pair with a manual clock to advance time without
- * waiting in real time.
- */
-export interface DurabilityClock {
-    now(): number;
-    schedule(callback: () => void, delayMs: number): {
-        cancel(): void;
-    };
-}
-export interface LocalStepDurabilityOptions {
-    store: StepDurabilityLedger;
-    conversationId: string;
-    runId: string;
-    signal?: AbortSignal;
-    /** Host-owned notification for ledger writes made by another process. */
-    subscribe?(wake: () => void): () => void;
-    /**
-     * Injectable time source for `sleep`. Defaults to the wall clock and
-     * `setTimeout`; a test passes a manual clock so advancing time
-     * deterministically resumes a park without waiting in real time.
-     */
-    clock?: {
-        now(): number;
-        schedule(callback: () => void, delayMs: number): {
-            cancel(): void;
-        };
-    };
-}
-export interface StepRunOptions {
-    /** Aborting refuses to *start* a body and releases a park; it never removes a record already written. */
-    signal?: AbortSignal;
-}
-export interface LocalStepDurability {
-    /**
-     * Run `name` once and durably record its JSON result.
-     *
-     * The first execution runs `body` and appends the result to the ledger. A
-     * replay — a fresh process, or a second durability object built over the same
-     * store — decodes the record and returns it without calling `body` again.
-     */
-    step<T extends z.infer<ReturnType<typeof z.json>>>(name: string, body: () => T | Promise<T>, options?: StepRunOptions): Promise<T>;
-    /** The decoded result of an already-recorded step, or `undefined` if none. */
-    readRecordedStep(name: string): Promise<unknown | undefined>;
-    /** Whether `name` has a recorded result. */
-    hasRecordedStep(name: string): Promise<boolean>;
-    /**
-     * Wait on a lightweight local timer for `seconds`, retaining a durable deadline.
-     *
-     * The first call records a park with an absolute deadline; a replay whose
-     * deadline has passed returns immediately, one before it waits out the
-     * remainder. `name` is the park's identity within the run and must be stable
-     * across replays. It defaults to the duration, so a caller that parks twice
-     * for the same length must pass distinct names.
-     */
-    sleep(input: {
-        seconds: number;
-        name?: string;
-    }, options?: StepRunOptions): Promise<void>;
-    /**
-     * Park the run until an external event `{ event, id }` is delivered.
-     *
-     * Resolves with the delivered payload. A waiter that starts after delivery
-     * returns immediately, as does a reconstruction that finds the delivery in
-     * the ledger.
-     */
-    waitFor<T = unknown>(input: {
-        event: string;
-        id: string;
-    }, options?: StepRunOptions): Promise<T>;
-    /**
-     * Durably record an external event and wake any waiter for it.
-     *
-     * The record is append-only and survives a restart: reconstruction finds it
-     * and a `waitFor` for the same key resolves without a second delivery.
-     */
-    deliver(input: {
-        event: string;
-        id: string;
-        payload?: unknown;
-    }): Promise<void>;
-}
-/**
- * The record for `name` cannot be trusted.
- *
- * Thrown instead of re-running `body`: a body is arbitrary and often effectful,
- * and a record that cannot be decoded is evidence the ledger is not what this
- * run wrote, never evidence the step never ran.
- */
-export declare class StepResultDecodeError extends Error {
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-}
-/** A step body returned a value that cannot be represented as JSON. */
-export declare class StepResultNotSerializableError extends Error {
-    constructor(stepName: string, cause: unknown);
-}
-/** The caller aborted before the step body was started. No record was written. */
-export declare class StepAbortedError extends Error {
-    constructor(stepName: string);
-}
-/**
- * A park or delivered-event record cannot be trusted.
- *
- * Thrown instead of parking on a record whose shape is not ours: an
- * undecodable park is evidence the ledger is not what this run wrote, never
- * evidence the park never happened.
- */
-export declare class ParkRecordDecodeError extends Error {
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-}
-/**
- * A sleeping or waiting park was aborted before it was satisfied.
- *
- * No record is removed: the park stays in the ledger, so a later replay
- * resumes from the same durable state instead of starting a new park.
- */
-export declare class ParkAbortedError extends Error {
-    constructor(park: string);
-}
-//# sourceMappingURL=durability-contract.d.ts.map

package/dist/agent-runtime/durability-contract.d.ts.map

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

package/dist/agent-runtime/durability-json.d.ts

@@ -1,3 +0,0 @@
-import { z } from 'zod';
-export declare const DurableJsonSchema: z.ZodCustom<z.JSONType, z.JSONType>;
-//# sourceMappingURL=durability-json.d.ts.map

package/dist/agent-runtime/durability-json.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"durability-json.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/durability-json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoCxB,eAAO,MAAM,iBAAiB,qCAG7B,CAAC"}

package/dist/agent-runtime/durability-ledger.d.ts

@@ -1,16 +0,0 @@
-import { type ParkEventPayload, type StepDurabilityLedger } from './durability-contract.js';
-export declare function stepKey(conversationId: string, runId: string, stepName: string): string;
-export declare function sleepParkKey(conversationId: string, runId: string, name: string): string;
-export declare function waitParkKey(conversationId: string, runId: string, event: string, id: string): string;
-export declare function parkEventKey(conversationId: string, payload: ParkEventPayload): string;
-export declare function encodeStepResult(stepName: string, value: unknown): string;
-export declare function encodeDeliveredPayload(event: string, id: string, payload: unknown): string;
-export interface DurabilityLedgerView {
-    readonly steps: Map<string, unknown>;
-    readonly parks: Map<string, ParkEventPayload>;
-    readonly deliveries: Map<string, unknown>;
-    nextSeq: number;
-}
-/** Read every `durability/*` record in the conversation, keyed by durable key. */
-export declare function readDurabilityLedger(store: StepDurabilityLedger, conversationId: string, view: DurabilityLedgerView): Promise<DurabilityLedgerView>;
-//# sourceMappingURL=durability-ledger.d.ts.map

package/dist/agent-runtime/durability-ledger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"durability-ledger.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/durability-ledger.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,gBAAgB,EAGrB,KAAK,oBAAoB,EAK1B,MAAM,uBAAuB,CAAC;AAG/B,wBAAgB,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAExF;AAED,wBAAgB,WAAW,CACzB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,GACT,MAAM,CAER;AAED,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAItF;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAWzE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAa1F;AAmED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,kFAAkF;AAClF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,oBAAoB,EAC3B,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAsC/B"}

package/dist/agent-runtime/durability-scheduler.d.ts

@@ -1,29 +0,0 @@
-import { type DurabilityClock, type StepDurabilityLedger } from './durability-contract.js';
-export declare const systemClock: DurabilityClock;
-/**
- * In-flight steps of one process, keyed by the full durable key and removed as
- * soon as they settle.
- *
- * It is module-level rather than per-object so two durability objects built over
- * the same store in one process cannot both start an effectful body. It cannot
- * span processes: a second process is fenced by the run lease the runtime
- * already holds, not by this map, and that is the boundary this local slice
- * draws.
- */
-export interface InFlightDurability {
-    steps: Map<string, Promise<unknown>>;
-    parks: Map<string, Promise<unknown>>;
-    waiters: Map<string, Set<() => void>>;
-}
-export declare const stores: WeakMap<StepDurabilityLedger, InFlightDurability>;
-export declare function notifyWaiters(parkWaiters: InFlightDurability['waiters'], key: string): void;
-export declare function waitForDeadline(clock: DurabilityClock, deadline: number, park: string, signal?: AbortSignal): Promise<void>;
-interface ParkWaiter {
-    /** `'woke'` when a delivery notifies this park, `'aborted'` when the signal fires. */
-    readonly outcome: Promise<'woke' | 'aborted'>;
-    /** Remove this waiter from the registry; idempotent. */
-    cancel(): void;
-}
-export declare function createParkWaiter(parkWaiters: InFlightDurability['waiters'], key: string, signal?: AbortSignal): ParkWaiter;
-export {};
-//# sourceMappingURL=durability-scheduler.d.ts.map

package/dist/agent-runtime/durability-scheduler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"durability-scheduler.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/durability-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAC/B,eAAO,MAAM,WAAW,EAAE,eAOzB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;CACvC;AACD,eAAO,MAAM,MAAM,mDAA0D,CAAC;AAE9E,wBAAgB,aAAa,CAAC,WAAW,EAAE,kBAAkB,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAI3F;AA2BD,wBAAsB,eAAe,CACnC,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,UAAU,UAAU;IAClB,sFAAsF;IACtF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC9C,wDAAwD;IACxD,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,kBAAkB,CAAC,SAAS,CAAC,EAC1C,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,GACnB,UAAU,CA2BZ"}

package/dist/agent-runtime/durability.d.ts

@@ -1,14 +0,0 @@
-import { type LocalStepDurability, type LocalStepDurabilityOptions } from './durability-contract.js';
-export type { LocalStepDurability, LocalStepDurabilityOptions, StepDurabilityLedger, StepRunOptions, } from './durability-contract.js';
-export { DURABILITY_STEP_EVENT_KIND, ParkAbortedError, ParkRecordDecodeError, StepAbortedError, StepResultDecodeError, StepResultNotSerializableError, } from './durability-contract.js';
-/**
- * A local step-durability port over an `AgentRuntimeStore`.
- *
- * Replaying is reading the ledger: nothing is kept between instances, so a
- * fresh object over the same store resumes from the records that survived a
- * process restart. Completed records are append-only — there is no deletion
- * path — so cancellation cannot remove one, and a park that completed is never
- * created a second time.
- */
-export declare function createLocalStepDurability(options: LocalStepDurabilityOptions): LocalStepDurability;
-//# sourceMappingURL=durability.d.ts.map