stitchkit 0.109.4 → 0.110.1

package/llms/{upgrading-0.101.0-0.109.0.txt → upgrading-0.101.0-0.110.0.txt}

@@ -1,14 +1,24 @@
-# Upgrading 0.101.0 → 0.109.0 — stitchkit docs slice
+# Upgrading 0.101.0 → 0.110.0 — stitchkit docs slice
 
 > Generated from the `docs/` tree by `bun run gen:llms`. The index of all slices is
 > `llms.txt` in this package.
 
-Contains: Guide: Upgrading, 0.101.0 → 0.109.0  (docs/guide/upgrading.md)
+Contains: Guide: Upgrading, 0.101.0 → 0.110.0  (docs/guide/upgrading.md)
 
 ==============================================================================
-# Guide: Upgrading, 0.101.0 → 0.109.0  (docs/guide/upgrading.md)
+# Guide: Upgrading, 0.101.0 → 0.110.0  (docs/guide/upgrading.md)
 ==============================================================================
 
+## Released migration: 0.110.0
+
+### Interrupted process drains
+
+**Who must act:** applications with exhaustive switches or schemas over `LifecycleTermination` or `PreviousExit` from `stitchkit/application`.
+
+A successor that closes an abandoned `draining` run now reports `interrupted`, rather than `abnormal` (or `startup-failed` before readiness). Add an `interrupted` case for an unfinished shutdown. `abnormal` still describes an abandoned active run. Handoff and same-pid hot reload retain their meaning.
+
+`StartFact.previousDrainUpperBoundMs` measures from recorded admission stop to successor start, or is `null` without those facts. It is an upper bound: the ledger does not observe the actual kill signal, supervisor deadline, or death time. Before: `previousExit === "abnormal"` included unfinished drains; after: handle `previousExit === "interrupted"` separately.
+
 ## Released migration: 0.109.0
 
 ### free CLI record leaves are lexical

package/llms/upgrading.txt

@@ -11,7 +11,7 @@ Contains: Guide: Upgrading, general  (docs/guide/upgrading.md)
 
 Load this slice, then every range slice between your installed version and the target:
 
-- 0.101.0 → 0.109.0: `llms/upgrading-0.101.0-0.109.0.txt`
+- 0.101.0 → 0.110.0: `llms/upgrading-0.101.0-0.110.0.txt`
 - 0.74.0 → 0.100.0: `llms/upgrading-0.74.0-0.100.0.txt`
 - 0.61.0 → 0.73.0: `llms/upgrading-0.61.0-0.73.0.txt`
 - 0.44.0 → 0.60.0: `llms/upgrading-0.44.0-0.60.0.txt`

package/llms-full.txt

@@ -48,6 +48,8 @@ own, recorded as an ADR.
 | Import | Use in | Maturity | Holds |
 |--------|--------|----------|-------|
 | `stitchkit` | browser **and** server | stable | `defineContract`, `createClient`, `createHttpClient`, `createSocketIOClient`, `parseSSE`, the error model |
+| `stitchkit/http` | browser, React Native/Hermes **and** server | evolving | typed HTTP client factories and `ApiError`, without optional realtime peers |
+| `stitchkit/realtime` | browser, React Native/Hermes **and** server | evolving | typed realtime clients and retained topics with a required explicit Socket.IO peer loader |
 | `stitchkit/contract` | browser **and** server | stable | the contract layer alone — `defineContract`, errors, pagination |
 | `stitchkit/live` | browser **and** server | evolving | `defineEvents` — topic declarations beside the operation contract — and watched reads: `createWatchClient`, the value/difference frame and its reassembly |
 | `stitchkit/primitives` | browser **and** server | evolving | generic values and declarations for lifecycle, access, audit, delivery and exports |
@@ -75,12 +77,12 @@ own, recorded as an ADR.
 | `stitchkit/geo` | server (Bun or Node) | evolving | managed GeoIP reader generations, last-known-good reload and the optional MaxMind adapter |
 | `stitchkit/oauth` | browser **and** server | evolving | provider-neutral Authorization Code + PKCE request and one-shot callback transaction mechanics |
 | `stitchkit/google` | server (Bun or Node) | evolving | optional Google code exchange and verified OIDC identity adapter |
-| `stitchkit/observability` | server | stable<br>_redefined in 2 of the 54 minors since 0.56.2, most recently 0.92.0_ | request/tool event projections — `createObservability`, trace context, sanitisation |
+| `stitchkit/observability` | server | stable<br>_redefined in 2 of the 55 minors since 0.56.2, most recently 0.92.0_ | request/tool event projections — `createObservability`, trace context, sanitisation |
 | `stitchkit/testing` | tests on Bun or Node | stable | in-process generated clients over a real Fetch handler, the managed-resource conformance kit and manual time for schedules and retries |
 | `stitchkit/declaration` | browser + build and deployment tooling (Bun or Node) | evolving | `ProjectDeclarationSchema` — the one machine-readable statement a repository makes about itself |
 | `stitchkit/react` | browser + server rendering | stable | `createCursorQuery`, `createCacheBridge`, QueryClient and `ApiError` retry policy |
 | `stitchkit/react/keyboard` | browser | evolving | which part of a screen gets a key — ordered layers, one Escape per level, list zones with real focus; see [keyboard guide](keyboard.md) |
-| `stitchkit/agent-runtime` | server | evolving<br>_redefined in 23 of the 54 minors since 0.56.2, most recently 0.105.0_ | optional durable conversation/run loop, history, models, prompts, fencing and events |
+| `stitchkit/agent-runtime` | server | evolving<br>_redefined in 23 of the 55 minors since 0.56.2, most recently 0.105.0_ | optional durable conversation/run loop, history, models, prompts, fencing and events |
 | `stitchkit/agent-runtime/sandbox` | server | evolving | optional Linux Bubblewrap sessions, durable workspaces and a host HTTP credential gateway; see [sandbox guide](sandbox.md) |
 | `stitchkit/agent-runtime/testing` | tests on Bun or Node | evolving | credential-free replay, scripted provider faults, deterministic race controls and the agent-store conformance kit |
 | `stitchkit/agent-runtime/harness` | server | evolving | resource-aware process-local facade over the canonical Agent runtime; supervision stays outside |
@@ -92,7 +94,7 @@ own, recorded as an ADR.
 | `stitchkit/agent-runtime/sqlite/bun` | server (Bun) | evolving | durable built-in SQLite store for the agent runtime |
 | `stitchkit/agent-runtime/sqlite/node` | server (Node ≥ 22.5) | evolving | durable built-in SQLite store for the agent runtime |
 | `stitchkit-tui` | terminal (Bun) | evolving | optional official OpenTUI host over a caller-composed headless runtime |
-| `stitchkit/application` | browser + server | evolving<br>_redefined in 13 of the 54 minors since 0.56.2, most recently 0.105.0_ | managed resource graph, readiness, admission, schedules, subtree restart and bounded shutdown |
+| `stitchkit/application` | browser + server | evolving<br>_redefined in 14 of the 55 minors since 0.56.2, most recently 0.110.0_ | managed resource graph, readiness, admission, schedules, subtree restart and bounded shutdown |
 | `stitchkit/application/grammy` | server | evolving | a grammY bot as application resources — configuration, then polling with updates admitted by batch — and the webhook adapter |
 | `stitchkit/application/opentelemetry` | server | evolving | maps application snapshots onto an injected OpenTelemetry `Meter` |
 | `stitchkit/application/schemas` | browser + server | evolving | the application's snapshot, health and shutdown schemas alone, without the kernel |
@@ -7849,12 +7851,13 @@ ever became ready:
 | newest run | same pid | version | `previousExit` | predecessor's `termination` |
 |---|---|---|---|---|
 | none | — | — | `first-boot` | — |
-| recorded `stoppedAt` | — | — | `clean` / `forced` / `startup-failed` / `abnormal` as recorded | unchanged |
+| recorded `stoppedAt` | — | — | the recorded termination, including `interrupted` | unchanged |
 | still open | yes | — | `hot-reload` | `hot-reload`, closed at the new start |
 | still open | no | changed | `handoff` (default) | stays open; it records its own stop later |
-| still open | no | changed, `versionChangeOverlap: 'abnormal'` | `abnormal` / `startup-failed` | closed at the new start, as for the same version |
-| still open, was ready | no | same | `abnormal` (default) | `abnormal`, closed at the new start — an upper bound, the crash time is unknown |
-| still open, never ready | no | same | `startup-failed` (default) | `startup-failed`, closed at the new start |
+| still open | no | changed, `versionChangeOverlap: 'abnormal'` | `interrupted` / `abnormal` / `startup-failed` | closed at the new start, as for the same version |
+| still draining | no | same or non-overlapping build | `interrupted` | closed at the new start; its death time and kill signal are unknown |
+| still active, was ready | no | same | `abnormal` (default) | `abnormal`, closed at the new start — an upper bound, the crash time is unknown |
+| still active, never ready | no | same | `startup-failed` (default) | `startup-failed`, closed at the new start |
 
 Every other open run the start finds was abandoned too and is closed the same
 way — two crashes in a row leave two open runs, and both are closed, not only
@@ -7883,10 +7886,12 @@ The ledger records what the process says while it can say it. stitchkit never
 calls `process.exit` (ADR 0074), so a stop is recorded on the kernel's `close`
 or `force` path, both awaited. An application that exits the process on its
 own before its shutdown settles loses that last write; the successor then
-finds the run open and closes it as `abnormal`, keeping the `unavailableAt`
+finds the unfinished drain and closes it as `interrupted`, keeping the `unavailableAt`
 already recorded — which is why the drain moment is written first, at
 `stopAdmission`, and the downtime survives a stop that was never recorded.
 
+An abandoned `draining` run closes as `interrupted`, including before readiness. `StartFact.previousDrainUpperBoundMs` is the elapsed time from recorded admission stop to successor start, or `null` when unknown. This is an upper bound, not proof of a supervisor timeout or a particular kill signal. Live handoff predecessors remain open; same-pid restarts remain `hot-reload`.
+
 The `abnormal` default is a choice, and it is the single-process deployment:
 one process per build, a new pid of the same build means the old one stopped
 answering. Where processes of **one** build overlap on purpose — a cluster, a
@@ -15890,6 +15895,17 @@ analytics policy belong to the application.
 
 # Upgrading stitchkit
 
+## Released migration: 0.110.0
+
+### Interrupted process drains
+
+**Who must act:** applications with exhaustive switches or schemas over `LifecycleTermination` or `PreviousExit` from `stitchkit/application`.
+
+A successor that closes an abandoned `draining` run now reports `interrupted`, rather than `abnormal` (or `startup-failed` before readiness). Add an `interrupted` case for an unfinished shutdown. `abnormal` still describes an abandoned active run. Handoff and same-pid hot reload retain their meaning.
+
+`StartFact.previousDrainUpperBoundMs` measures from recorded admission stop to successor start, or is `null` without those facts. It is an upper bound: the ledger does not observe the actual kill signal, supervisor deadline, or death time. Before: `previousExit === "abnormal"` included unfinished drains; after: handle `previousExit === "interrupted"` separately.
+
+
 ## Released migration: 0.109.0
 
 ### free CLI record leaves are lexical
@@ -21313,6 +21329,9 @@ lane never reaches the hooks on either runtime.
 
 ## `stitchkit/application`
 
+`StartFact` also carries `previousDrainUpperBoundMs`: the time from a predecessor's recorded admission stop to this start when its exit is `interrupted`, otherwise `null`. This is an upper bound, and does not identify a kill signal or supervisor deadline.
+
+
 Server-only process-local application composition. See the
 [application kernel guide](../guide/application-kernel.md) and
 [architecture](../architecture/application-kernel.md). Complete consumer
@@ -23311,3 +23330,33 @@ has no `outputPath`, because nothing is written beside the executable. Keep comp
 without splitting, preserve every output, and write each asset's `bytes` to its `outputPath`.
 This evolving entrypoint is a build dependency; runtime imports do not reach it.
 The detailed recipe is in [native IO](../guide/native-io.md#public-native-packaging).
+
+## `stitchkit/http`
+
+An HTTP-only entrypoint for browsers, React Native/Hermes and servers. It exports the same `createClient`, `createClients`, `createHttpClient`, URL builders, client configuration types and `ApiError` as the root, without loading its optional Socket.IO graph. Import shared contracts from `stitchkit/contract`.
+
+```ts
+import { createClients, createHttpClient } from 'stitchkit/http';
+import { defineContract } from 'stitchkit/contract';
+```
+
+## `stitchkit/realtime`
+
+Hermes-safe realtime clients reuse the root transport and contract implementation. Both
+`createRealtimeClient` and `createSocketIOClient` require `peers.client` here; no default
+computed import enters this graph. Root clients retain their optional lazy runtime loader.
+
+```ts
+import { createRealtimeClient, defineRealtimeContract } from 'stitchkit/realtime';
+const client = createRealtimeClient(contract, {
+  url,
+  peers: { client: () => import('socket.io-client') },
+});
+```
+
+Native consumers import HTTP factories, `ApiError`, `createUrlBuilder`,
+`contractEndpointMatchers` and `uploadInChunks` from `stitchkit/http`; schema factories,
+`ContractDef` and `paginatedSchema` from `stitchkit/contract`; realtime factories,
+`RealtimeClient`, `defineRealtimeContract`, `InferRealtimeEventMap`, `createRetainedTopics`
+and `RetainedTopics` from `stitchkit/realtime`. `createQueryClientFactory` remains in
+`stitchkit/react`. Shared modules must use the same public leaves throughout their graph.

package/llms.txt

@@ -9,7 +9,7 @@ Build with stitchkit: define a contract once, then `implement` it and serve it (
 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) 47.2 KB → [llms/stitchkit.2.txt](llms/stitchkit.2.txt) 36.5 KB
+- **stitchkit**: [llms/stitchkit.txt](llms/stitchkit.txt) 47.5 KB → [llms/stitchkit.2.txt](llms/stitchkit.2.txt) 36.5 KB
 - **stitchkit/live**: [llms/live.txt](llms/live.txt) 21.2 KB
 - **stitchkit/react**: [llms/react.txt](llms/react.txt) 8.6 KB
 - **stitchkit/react/keyboard**: [llms/react-keyboard.txt](llms/react-keyboard.txt) 9.2 KB
@@ -33,7 +33,7 @@ Load the slice for each entrypoint your code imports — `import … from 'stitc
 - **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) 40.8 KB → [llms/application.2.txt](llms/application.2.txt) 30.7 KB → [llms/application.3.txt](llms/application.3.txt) 29.4 KB
+- **stitchkit/application**: [llms/application.txt](llms/application.txt) 40.8 KB → [llms/application.2.txt](llms/application.2.txt) 31.3 KB → [llms/application.3.txt](llms/application.3.txt) 29.6 KB
 - **stitchkit/application/grammy**: [llms/application-grammy.txt](llms/application-grammy.txt) 2.3 KB
 - **stitchkit/application/opentelemetry**: [llms/application-opentelemetry.txt](llms/application-opentelemetry.txt) 1.6 KB
 - **stitchkit/application/directory-inbox**: [llms/application-directory-inbox.txt](llms/application-directory-inbox.txt) 0.3 KB
@@ -59,10 +59,12 @@ Load the slice for each entrypoint your code imports — `import … from 'stitc
 - **stitchkit/process**: [llms/process.txt](llms/process.txt) 45.8 KB
 - **stitchkit/process/owner-loss**: [llms/process-owner-loss.txt](llms/process-owner-loss.txt) 0.9 KB
 - **stitchkit/files/packaging**: [llms/files-packaging.txt](llms/files-packaging.txt) 3.5 KB
+- **stitchkit/http**: [llms/http.txt](llms/http.txt) 0.9 KB
+- **stitchkit/realtime**: [llms/realtime.txt](llms/realtime.txt) 1.4 KB
 
 ## Upgrading slices
 - **Upgrading — how to move across versions**: [llms/upgrading.txt](llms/upgrading.txt) 12.2 KB
-- **Upgrading 0.101.0 → 0.109.0**: [llms/upgrading-0.101.0-0.109.0.txt](llms/upgrading-0.101.0-0.109.0.txt) 45.0 KB
+- **Upgrading 0.101.0 → 0.110.0**: [llms/upgrading-0.101.0-0.110.0.txt](llms/upgrading-0.101.0-0.110.0.txt) 45.8 KB
 - **Upgrading 0.74.0 → 0.100.0**: [llms/upgrading-0.74.0-0.100.0.txt](llms/upgrading-0.74.0-0.100.0.txt) 45.1 KB
 - **Upgrading 0.61.0 → 0.73.0**: [llms/upgrading-0.61.0-0.73.0.txt](llms/upgrading-0.61.0-0.73.0.txt) 41.2 KB
 - **Upgrading 0.44.0 → 0.60.0**: [llms/upgrading-0.44.0-0.60.0.txt](llms/upgrading-0.44.0-0.60.0.txt) 43.9 KB

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stitchkit",
-  "version": "0.109.4",
+  "version": "0.110.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",
@@ -256,6 +256,14 @@
     "./files/packaging": {
       "types": "./dist/entrypoints/files/packaging.d.ts",
       "import": "./dist/entrypoints/files/packaging.js"
+    },
+    "./http": {
+      "types": "./dist/entrypoints/http.d.ts",
+      "import": "./dist/entrypoints/http.js"
+    },
+    "./realtime": {
+      "types": "./dist/entrypoints/realtime.d.ts",
+      "import": "./dist/entrypoints/realtime.js"
     }
   },
   "publishConfig": {

package/dist/{index-9j2atjte.js → index-2f9r0jgr.js}

@@ -2,9 +2,6 @@ import {
   ManagedFilePathSchema2,
   ManagedFileRefSchema2
 } from "./index-xqhede6x.js";
-import {
-  raceAbort
-} from "./index-b0kddvzw.js";
 import {
   BoundedFileReadError,
   readBoundedFile
@@ -19,6 +16,9 @@ import {
 import {
   AtomicFilePublicationError2
 } from "./index-b56nnscm.js";
+import {
+  raceAbort
+} from "./index-b0kddvzw.js";
 import {
   assertPositiveSafeInteger
 } from "./index-0s4xebbg.js";

package/dist/{index-k7qdkh3n.js → index-h1spd9kv.js}

@@ -5,12 +5,12 @@ import {
   bytesToBase64Url,
   base64UrlToBytes
 } from "./index-dwfv9a85.js";
-import {
-  unauthorized2
-} from "./index-j9gxbztg.js";
 import {
   safeJsonParse
 } from "./index-zsarb5xp.js";
+import {
+  unauthorized2
+} from "./index-j9gxbztg.js";
 import {
   isRecord
 } from "./index-9jfdm5tg.js";

package/dist/{index-y3nemndz.js → index-r6v4mc67.js}

@@ -2,12 +2,12 @@ import {
   resolveSocketIp2,
   getClientInfo2
 } from "./index-kw1ws0cs.js";
-import {
-  resolveTraceContext2
-} from "./index-yex7eg1v.js";
 import {
   isUnsafeKey
 } from "./index-zsarb5xp.js";
+import {
+  resolveTraceContext2
+} from "./index-yex7eg1v.js";
 
 // src/observability/context.ts
 import { AsyncLocalStorage } from "node:async_hooks";

package/dist/{index-ktjmgq9p.js → index-s0xbnpfh.js}

@@ -6,12 +6,12 @@ import {
   PrivateAddressRefusal,
   readCapped
 } from "./index-3h0ztg0z.js";
-import {
-  raceAbort
-} from "./index-b0kddvzw.js";
 import {
   writeFileAtomicSync2
 } from "./index-07dcf2yn.js";
+import {
+  raceAbort
+} from "./index-b0kddvzw.js";
 import {
   assertPositiveSafeInteger
 } from "./index-0s4xebbg.js";