stitchkit 0.94.1 → 0.95.1

package/CHANGELOG.md

@@ -15,6 +15,63 @@ additive**; the first breaking change landed in 0.10.0. Grep the file for
 
 ## [Unreleased]
 
+## [0.95.1] — 2026-09-23
+
+### Added
+
+- `stitchkit/application/directory-inbox` (new, server, evolving) —
+  **`createDirectoryInbox({ id, directory, schema, handle })`**, with its
+  contract (`DirectoryInboxConfig`, `DirectoryInboxStateSchema`, …) in
+  `stitchkit/application`: a managed resource that delivers each `<name>.json` entry
+  another program drops into a directory to the application at least once,
+  after readiness. Taken and done are separate durable records — a claim with a
+  lease before `handle`, a receipt after it and only then the file removed — so
+  a restart neither loses an entry nor repeats a finished one. A throwing
+  handler is retried with a backoff; an entry that fails its schema, is too
+  large or used up `maxAttempts` is moved to `rejected/` with its reason and
+  the queue keeps flowing. `stopAdmission` stops taking entries, `force` aborts
+  the delivery in flight. A consuming project wrote this receiver by hand.
+
+## [0.95.0] — 2026-09-23
+
+### ⚠️ Breaking changes
+
+**Who must act:** a project that reads `downtimeMs` from a lifecycle start fact,
+switches exhaustively over `LifecycleTermination`, `PreviousExit` or
+`ProcessLifecycleFact`, imports `TransitionReadyInput`, or drives
+`createProcessLifecycleLedger` by hand without `recordReady`. A project that uses `lifecycleLedgerResource` and only
+stores the ledger raises its version range; a ledger file written by an earlier
+version loads unchanged.
+
+- `stitchkit/application` — **the lifecycle ledger measures the window nobody
+  answered in.** `downtimeMs` was `startedAt` of the new process minus
+  `stoppedAt` of the old one, so a 110 s forced drain read as the same ~4 s
+  before and after it was fixed. A run now records `unavailableAt` when its
+  admission stops (`lifecycleLedgerResource` does it at `stopAdmission`; by
+  hand, `ledger.recordDraining()`) and passes an open `draining` phase.
+  `ReadyFact.downtimeMs` is `readyAt` of the new run minus `unavailableAt` of
+  the last run that served, with `unavailableSince` naming that moment; the old
+  number stays on `StartFact` as `processGapMs`. A run that stops before it was
+  ever ready ends `startup-failed` — recorded by itself on a rolled-back
+  startup, or by the successor that finds it open — and `PreviousExit` gains
+  the same value. A start closes every abandoned open run it finds, not only
+  the newest. New names: `DrainingFact`, `transitionProcessDraining`.
+  `TransitionReadyInput` is `TransitionRunInput`: one shape — which run, and
+  when — taken by readiness and draining alike, and extended by
+  `TransitionShutdownInput`; a second name for it would be an alias.
+  `// before: ledger.subscribe((fact) => fact.type === 'started' && report(fact.downtimeMs))` →
+  `// after:  ledger.subscribe((fact) => fact.type === 'ready' && report(fact.downtimeMs))`
+
+### Fixed
+
+- `stitchkit/agent-runtime` — **a provider stream cut mid-answer is a
+  `provider_failure` on Bun 1.4 too.** Only a throw out of `doStream()` was
+  marked as the provider's; Bun 1.4 delivers a cut connection as a rejected
+  read of the stream `doStream()` already returned (`AI_APICallError: Failed to
+  process successful response`), and that unmarked error ended the run as
+  `runtime_failure`. Every failed read of the provider's stream is now marked;
+  the runtime's own failures while consuming it keep their classes.
+
 ## [0.94.1] — 2026-09-23
 
 ### Added

package/dist/agent-runtime/provider-origin.d.ts

@@ -9,4 +9,11 @@ export declare function isOwnInputRefusal(error: unknown): boolean;
 export declare function markProviderOrigin<T>(error: T): T;
 /** Whether this error came out of the provider call itself. */
 export declare function hasProviderOrigin(error: unknown): boolean;
+/**
+ * The provider's stream, with every failed read marked as the provider's.
+ *
+ * Only reads of this stream pass through here: the runtime's own work on the
+ * parts happens downstream, so its failures stay unmarked.
+ */
+export declare function markProviderStream<T>(stream: ReadableStream<T>): ReadableStream<T>;
 //# sourceMappingURL=provider-origin.d.ts.map

package/dist/agent-runtime/provider-origin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-origin.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/provider-origin.ts"],"names":[],"mappings":"AAsBA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMzD;AAED,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAGjD;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEzD"}
+{"version":3,"file":"provider-origin.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/provider-origin.ts"],"names":[],"mappings":"AAyBA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMzD;AAED,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAGjD;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAkBlF"}

package/dist/agent-runtime/run-operation-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-operation-lifecycle.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/run-operation-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,IAAI,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EACL,KAAK,QAAQ,EAGb,KAAK,aAAa,EACnB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGjD,KAAK,sBAAsB,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEnE,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE,iBAAiB,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,IAAI,QAAQ,CAAC;IACvB,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9C,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,GAAG,IAAI,IAAI,CAAC;IACZ,oEAAoE;IACpE,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED,uEAAuE;AACvE,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,gCAAgC;IAgDrF,gBAAgB,SAAS,MAAM,GAAG,IAAI;IAGhC,YAAY,QACT,aAAa,QACd,MAAM,kBACI,MAAM,GACrB,OAAO,CAAC,aAAa,CAAC;IAwCzB,cAAc,OAAO,MAAM,GAAG,IAAI;IAQlC,mBAAmB,QAAQ,OAAO,GAAG,IAAI;IAIzC,eAAe,cAAc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,MAAM,QAAQ,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;EAavD"}
+{"version":3,"file":"run-operation-lifecycle.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/run-operation-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,IAAI,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EACL,KAAK,QAAQ,EAGb,KAAK,aAAa,EACnB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGjD,KAAK,sBAAsB,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEnE,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE,iBAAiB,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,IAAI,QAAQ,CAAC;IACvB,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9C,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,GAAG,IAAI,IAAI,CAAC;IACZ,oEAAoE;IACpE,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED,uEAAuE;AACvE,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,gCAAgC;IAgDrF,gBAAgB,SAAS,MAAM,GAAG,IAAI;IAGhC,YAAY,QACT,aAAa,QACd,MAAM,kBACI,MAAM,GACrB,OAAO,CAAC,aAAa,CAAC;IAyCzB,cAAc,OAAO,MAAM,GAAG,IAAI;IAQlC,mBAAmB,QAAQ,OAAO,GAAG,IAAI;IAIzC,eAAe,cAAc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,MAAM,QAAQ,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;EAavD"}

package/dist/application/directory-inbox-contract.d.ts

@@ -0,0 +1,129 @@
+import { z } from 'zod';
+import type { ManagedResource, ManagedResourceDependency } from './resource.js';
+import type { StateStore } from './state-store.js';
+export declare const DirectoryInboxRejectionReasonSchema: z.ZodEnum<{
+    "attempt-limit": "attempt-limit";
+    invalid: "invalid";
+    "too-large": "too-large";
+}>;
+export type DirectoryInboxRejectionReason = z.infer<typeof DirectoryInboxRejectionReasonSchema>;
+export declare const DirectoryInboxStateSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    claims: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        attempts: z.ZodNumber;
+        nextAttemptAt: z.ZodString;
+        leaseId: z.ZodNullable<z.ZodString>;
+        leaseUntil: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    receipts: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        completedAt: z.ZodString;
+    }, z.core.$strict>>;
+    rejected: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        reason: z.ZodEnum<{
+            "attempt-limit": "attempt-limit";
+            invalid: "invalid";
+            "too-large": "too-large";
+        }>;
+        detail: z.ZodString;
+        rejectedAt: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type DirectoryInboxState = z.infer<typeof DirectoryInboxStateSchema>;
+export type DirectoryInboxClaim = DirectoryInboxState['claims'][number];
+export type DirectoryInboxRejection = DirectoryInboxState['rejected'][number];
+export declare const emptyDirectoryInboxState: () => DirectoryInboxState;
+/**
+ * A directory another program drops entries into, handed to the application
+ * at least once each. The producer writes each entry atomically as a
+ * `<name>.json` file (a temporary name, then a rename); names starting with a
+ * dot are never read, which is where the inbox keeps its own state.
+ */
+export interface DirectoryInboxDelivery<TEntry> {
+    /** The entry's file name — stable across retries and restarts. */
+    readonly key: string;
+    readonly entry: TEntry;
+    /** 1 on the first delivery of this entry. */
+    readonly attempt: number;
+    /** Aborted when the application is forced down mid-delivery. */
+    readonly signal: AbortSignal;
+}
+export interface DirectoryInboxConfig<TEntry> {
+    readonly id: string;
+    readonly directory: string;
+    readonly schema: z.ZodType<TEntry>;
+    /** Throwing leaves the entry for a later attempt. */
+    readonly handle: (delivery: DirectoryInboxDelivery<TEntry>) => void | Promise<void>;
+    readonly dependsOn?: readonly ManagedResourceDependency[];
+    /** Default: `<directory>/.inbox-state.json`, locked across processes. */
+    readonly store?: StateStore<DirectoryInboxState>;
+    readonly clock?: () => Date;
+    /** How often the directory is read while the application runs. Default 1 s. */
+    readonly pollIntervalMs?: number;
+    /** How long a taken entry is someone's before it may be taken again. Default 5 min. */
+    readonly leaseMs?: number;
+    /** Deliveries of one entry before it is set aside. Default 20. */
+    readonly maxAttempts?: number;
+    /** Larger entries are set aside unread. Default 1 MiB. */
+    readonly maxEntryBytes?: number;
+    /** Receipts and rejections kept. Default 1 000. */
+    readonly retain?: number;
+    /** An entry was set aside into `<directory>/rejected/`, with the reason. */
+    readonly onRejected?: (rejection: DirectoryInboxRejection) => void | Promise<void>;
+    /**
+     * A delivery failed (the entry is retried after a backoff) or a whole pass
+     * did (storage, the directory; the next poll tries again).
+     */
+    readonly onError?: (error: unknown) => void | Promise<void>;
+}
+export interface DirectoryInbox {
+    /** Deliver every entry due now; resolves with how many were handled. */
+    flush(): Promise<number>;
+    state(): Promise<DirectoryInboxState>;
+}
+export interface DirectoryInboxResource extends ManagedResource {
+    start(): Promise<{
+        readonly value: DirectoryInbox;
+    }>;
+}
+/** What the next step does with one entry of the directory. */
+export type InboxStep = {
+    readonly kind: 'skip';
+} | {
+    readonly kind: 'remove';
+} | {
+    readonly kind: 'set-aside';
+} | {
+    readonly kind: 'reject';
+    readonly rejection: DirectoryInboxRejection;
+} | {
+    readonly kind: 'deliver';
+    readonly claim: DirectoryInboxClaim;
+};
+interface StepInput {
+    readonly key: string;
+    readonly now: Date;
+    readonly leaseMs: number;
+    readonly maxAttempts: number;
+    readonly retain: number;
+}
+export declare function withRejection(state: DirectoryInboxState, rejection: DirectoryInboxRejection, retain: number): DirectoryInboxState;
+/**
+ * Decide one entry, and take it when it is due. A claim whose attempts are
+ * spent is not taken again: an entry whose handling kills the process would
+ * otherwise be retried on every restart, forever.
+ */
+export declare function claimEntry(state: DirectoryInboxState, input: StepInput): {
+    readonly state: DirectoryInboxState;
+    readonly step: InboxStep;
+};
+/** The entry was handled: its receipt replaces its claim. */
+export declare function completeEntry(state: DirectoryInboxState, entryKey: string, now: Date, retain: number): DirectoryInboxState;
+/** The handler refused: wait, then take it again — unless it is no longer ours. */
+export declare function releaseEntry(state: DirectoryInboxState, claim: DirectoryInboxClaim, retryAt: Date): DirectoryInboxState;
+/** Records about entries that are gone from the directory, except a live lease. */
+export declare function forgetMissing(state: DirectoryInboxState, present: ReadonlySet<string>, now: Date): DirectoryInboxState;
+export {};
+//# sourceMappingURL=directory-inbox-contract.d.ts.map

package/dist/application/directory-inbox-contract.d.ts.map

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

package/dist/application/directory-inbox.d.ts

@@ -0,0 +1,3 @@
+import { type DirectoryInboxConfig, type DirectoryInboxResource } from './directory-inbox-contract.js';
+export declare function createDirectoryInbox<TEntry>(config: DirectoryInboxConfig<TEntry>): DirectoryInboxResource;
+//# sourceMappingURL=directory-inbox.d.ts.map

package/dist/application/directory-inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-inbox.d.ts","sourceRoot":"","sources":["../../src/application/directory-inbox.ts"],"names":[],"mappings":"AAIA,OAAO,EAKL,KAAK,oBAAoB,EAEzB,KAAK,sBAAsB,EAO5B,MAAM,4BAA4B,CAAC;AAyEpC,wBAAgB,oBAAoB,CAAC,MAAM,EACzC,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC,GACnC,sBAAsB,CAiKxB"}

package/dist/application/process-lifecycle-transitions.d.ts

@@ -0,0 +1,175 @@
+import { z } from 'zod';
+/**
+ * Where a run is. `active` and `draining` are open: the run is alive, and
+ * `draining` means it has stopped admitting work — from `unavailableAt` on
+ * nobody new is answered. The rest are how it ended. `clean`, `forced` and
+ * `startup-failed` are recorded by the run itself; `hot-reload` and `abnormal`
+ * by its successor, because the run never got to say — the same pid started
+ * again, or a different pid found it still open. `abnormal` is a crash
+ * observed from outside, not a kill the process acknowledged, so the two stay
+ * distinct. `startup-failed` is a run that ended before it was ever ready,
+ * whether it said so itself or a successor found it open.
+ */
+export declare const LifecycleTerminationSchema: z.ZodEnum<{
+    abnormal: "abnormal";
+    active: "active";
+    clean: "clean";
+    draining: "draining";
+    forced: "forced";
+    "hot-reload": "hot-reload";
+    "startup-failed": "startup-failed";
+}>;
+export type LifecycleTermination = z.infer<typeof LifecycleTerminationSchema>;
+export declare const LifecycleRunSchema: z.ZodObject<{
+    runId: z.ZodString;
+    pid: z.ZodNumber;
+    version: z.ZodString;
+    startedAt: z.ZodString;
+    readyAt: z.ZodNullable<z.ZodString>;
+    unavailableAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    stoppedAt: z.ZodNullable<z.ZodString>;
+    termination: z.ZodEnum<{
+        abnormal: "abnormal";
+        active: "active";
+        clean: "clean";
+        draining: "draining";
+        forced: "forced";
+        "hot-reload": "hot-reload";
+        "startup-failed": "startup-failed";
+    }>;
+}, z.core.$strict>;
+export type LifecycleRun = z.infer<typeof LifecycleRunSchema>;
+export declare const LifecycleStateSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    runs: z.ZodArray<z.ZodObject<{
+        runId: z.ZodString;
+        pid: z.ZodNumber;
+        version: z.ZodString;
+        startedAt: z.ZodString;
+        readyAt: z.ZodNullable<z.ZodString>;
+        unavailableAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        stoppedAt: z.ZodNullable<z.ZodString>;
+        termination: z.ZodEnum<{
+            abnormal: "abnormal";
+            active: "active";
+            clean: "clean";
+            draining: "draining";
+            forced: "forced";
+            "hot-reload": "hot-reload";
+            "startup-failed": "startup-failed";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type LifecycleState = z.infer<typeof LifecycleStateSchema>;
+export declare const PreviousExitSchema: z.ZodEnum<{
+    abnormal: "abnormal";
+    clean: "clean";
+    "first-boot": "first-boot";
+    forced: "forced";
+    handoff: "handoff";
+    "hot-reload": "hot-reload";
+    "startup-failed": "startup-failed";
+}>;
+export type PreviousExit = z.infer<typeof PreviousExitSchema>;
+export interface StartFact {
+    readonly type: 'started';
+    readonly runId: string;
+    readonly pid: number;
+    readonly version: string;
+    readonly startedAt: string;
+    readonly previousExit: PreviousExit;
+    readonly previousRunId: string | null;
+    readonly previousPid: number | null;
+    readonly previousVersion: string | null;
+    readonly versionChanged: boolean;
+    /**
+     * From the predecessor's recorded stop to this start: the gap between two
+     * processes, not the time nobody answered — that is `ReadyFact.downtimeMs`.
+     */
+    readonly processGapMs: number | null;
+}
+export interface ReadyFact {
+    readonly type: 'ready';
+    readonly runId: string;
+    readonly pid: number;
+    readonly readyAt: string;
+    readonly startupMs: number;
+    /**
+     * The window in which nobody answered: from the moment the last run that
+     * served stopped admitting work to this run's readiness — its drain plus
+     * this start. Zero when that run still answers (a handoff); null on first
+     * boot and when its end was never timed (a crash, a hot reload).
+     */
+    readonly downtimeMs: number | null;
+    /** The moment `downtimeMs` is counted from, when it is known. */
+    readonly unavailableSince: string | null;
+    /** False when this exact ready transition was already recorded. */
+    readonly recorded: boolean;
+}
+export interface DrainingFact {
+    readonly type: 'draining';
+    readonly runId: string;
+    readonly pid: number;
+    /** Null for a run that never became ready: it was never available. */
+    readonly unavailableAt: string | null;
+    readonly recorded: boolean;
+}
+export interface ShutdownFact {
+    readonly type: 'stopped';
+    readonly runId: string;
+    readonly pid: number;
+    readonly stoppedAt: string;
+    readonly uptimeMs: number | null;
+    readonly termination: 'clean' | 'forced' | 'startup-failed';
+    readonly recorded: boolean;
+}
+export type ProcessLifecycleFact = StartFact | ReadyFact | DrainingFact | ShutdownFact;
+export interface LifecycleTransition<TFact extends ProcessLifecycleFact> {
+    readonly state: LifecycleState;
+    readonly fact: TFact;
+}
+export declare const isOpenRun: (run: LifecycleRun) => boolean;
+/**
+ * The list is newest-first in the order the transitions wrote it — every write
+ * goes through one atomic update, so that order is the causal one. Clocks are
+ * not: a successor whose clock lags its predecessor must still find that
+ * predecessor at the head, so the list is never re-sorted by `startedAt`.
+ * Retention drops finished runs first; an open run — a live handoff
+ * predecessor — is dropped only when nothing finished is left to drop.
+ */
+export declare function normalizeLifecycleState(state: LifecycleState | null, retain: number): LifecycleState;
+/**
+ * What a start means when the newest run is still open under another pid
+ * **and the same version**. `abnormal` (default): the predecessor crashed
+ * without recording its exit — one process per deployment, a restart after a
+ * kill. `handoff`: processes of one build overlap on purpose (a cluster, a
+ * zero-downtime reload of the same build), so every open run stays open and
+ * records its own shutdown later. A different version is always a handoff; a
+ * version of `unknown` on either side is never a version change.
+ */
+export type SameVersionOverlap = 'abnormal' | 'handoff';
+export interface TransitionStartInput {
+    readonly runId: string;
+    readonly pid: number;
+    readonly version: string;
+    readonly now: string;
+    readonly retain?: number;
+    readonly sameVersionOverlap?: SameVersionOverlap;
+}
+/** Apply one process start without touching persistence or application events. */
+export declare function transitionProcessStart(source: LifecycleState | null, input: TransitionStartInput): LifecycleTransition<StartFact>;
+/** The run a transition applies to — owned by run id plus pid — and when. */
+export interface TransitionRunInput {
+    readonly runId: string;
+    readonly pid: number;
+    readonly now: string;
+    readonly retain?: number;
+}
+export declare function transitionProcessReady(source: LifecycleState | null, input: TransitionRunInput): LifecycleTransition<ReadyFact>;
+/** The run stopped admitting work: from here on it answers nobody new. */
+export declare function transitionProcessDraining(source: LifecycleState | null, input: TransitionRunInput): LifecycleTransition<DrainingFact>;
+export interface TransitionShutdownInput extends TransitionRunInput {
+    readonly forced?: boolean;
+}
+export declare function transitionProcessShutdown(source: LifecycleState | null, input: TransitionShutdownInput): LifecycleTransition<ShutdownFact>;
+//# sourceMappingURL=process-lifecycle-transitions.d.ts.map

package/dist/application/process-lifecycle-transitions.d.ts.map

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

package/dist/application/process-lifecycle.d.ts

@@ -1,141 +1,13 @@
-import { z } from 'zod';
+import { type DrainingFact, type LifecycleRun, type LifecycleState, type ProcessLifecycleFact, type ReadyFact, type SameVersionOverlap, type ShutdownFact, type StartFact } from './process-lifecycle-transitions.js';
 import { type ManagedResource } from './resource.js';
 import type { StateStore } from './state-store.js';
-/**
- * How a run ended. `clean` and `forced` are recorded by the run itself;
- * `hot-reload` and `abnormal` are recorded by its successor, because the run
- * never got to say — the same pid started again, or a different pid found it
- * still marked active. `abnormal` is a crash observed from outside, not a kill
- * the process acknowledged, so the two stay distinct in the ledger.
- */
-export declare const LifecycleTerminationSchema: z.ZodEnum<{
-    abnormal: "abnormal";
-    active: "active";
-    clean: "clean";
-    forced: "forced";
-    "hot-reload": "hot-reload";
-}>;
-export type LifecycleTermination = z.infer<typeof LifecycleTerminationSchema>;
-export declare const LifecycleRunSchema: z.ZodObject<{
-    runId: z.ZodString;
-    pid: z.ZodNumber;
-    version: z.ZodString;
-    startedAt: z.ZodString;
-    readyAt: z.ZodNullable<z.ZodString>;
-    stoppedAt: z.ZodNullable<z.ZodString>;
-    termination: z.ZodEnum<{
-        abnormal: "abnormal";
-        active: "active";
-        clean: "clean";
-        forced: "forced";
-        "hot-reload": "hot-reload";
-    }>;
-}, z.core.$strict>;
-export type LifecycleRun = z.infer<typeof LifecycleRunSchema>;
-export declare const LifecycleStateSchema: z.ZodObject<{
-    schemaVersion: z.ZodLiteral<1>;
-    runs: z.ZodArray<z.ZodObject<{
-        runId: z.ZodString;
-        pid: z.ZodNumber;
-        version: z.ZodString;
-        startedAt: z.ZodString;
-        readyAt: z.ZodNullable<z.ZodString>;
-        stoppedAt: z.ZodNullable<z.ZodString>;
-        termination: z.ZodEnum<{
-            abnormal: "abnormal";
-            active: "active";
-            clean: "clean";
-            forced: "forced";
-            "hot-reload": "hot-reload";
-        }>;
-    }, z.core.$strict>>;
-}, z.core.$strict>;
-export type LifecycleState = z.infer<typeof LifecycleStateSchema>;
-export declare const PreviousExitSchema: z.ZodEnum<{
-    abnormal: "abnormal";
-    clean: "clean";
-    "first-boot": "first-boot";
-    forced: "forced";
-    handoff: "handoff";
-    "hot-reload": "hot-reload";
-}>;
-export type PreviousExit = z.infer<typeof PreviousExitSchema>;
-export interface StartFact {
-    readonly type: 'started';
-    readonly runId: string;
-    readonly pid: number;
-    readonly version: string;
-    readonly startedAt: string;
-    readonly previousExit: PreviousExit;
-    readonly previousRunId: string | null;
-    readonly previousPid: number | null;
-    readonly previousVersion: string | null;
-    readonly versionChanged: boolean;
-    readonly downtimeMs: number | null;
-}
-export interface ReadyFact {
-    readonly type: 'ready';
-    readonly runId: string;
-    readonly pid: number;
-    readonly readyAt: string;
-    readonly startupMs: number;
-    /** False when this exact ready transition was already recorded. */
-    readonly recorded: boolean;
-}
-export interface ShutdownFact {
-    readonly type: 'stopped';
-    readonly runId: string;
-    readonly pid: number;
-    readonly stoppedAt: string;
-    readonly uptimeMs: number | null;
-    readonly termination: 'clean' | 'forced';
-    readonly recorded: boolean;
-}
-export type ProcessLifecycleFact = StartFact | ReadyFact | ShutdownFact;
-export interface LifecycleTransition<TFact extends ProcessLifecycleFact> {
-    readonly state: LifecycleState;
-    readonly fact: TFact;
-}
-/**
- * What a start means when the newest run is still marked active under another
- * pid **and the same version**. `abnormal` (default): the predecessor crashed
- * without recording its exit — one process per deployment, a restart after a
- * kill. `handoff`: two processes of one build overlap on purpose (a cluster, a
- * zero-downtime reload of the same build), so the predecessor stays active and
- * records its own shutdown later. A different version is always a handoff; a
- * version of `unknown` on either side is never a version change.
- */
-export type SameVersionOverlap = 'abnormal' | 'handoff';
-export interface TransitionStartInput {
-    readonly runId: string;
-    readonly pid: number;
-    readonly version: string;
-    readonly now: string;
-    readonly retain?: number;
-    readonly sameVersionOverlap?: SameVersionOverlap;
-}
-/** Apply one process start without touching persistence or application events. */
-export declare function transitionProcessStart(source: LifecycleState | null, input: TransitionStartInput): LifecycleTransition<StartFact>;
-export interface TransitionReadyInput {
-    readonly runId: string;
-    readonly pid: number;
-    readonly now: string;
-    readonly retain?: number;
-}
-export declare function transitionProcessReady(source: LifecycleState | null, input: TransitionReadyInput): LifecycleTransition<ReadyFact>;
-export interface TransitionShutdownInput {
-    readonly runId: string;
-    readonly pid: number;
-    readonly now: string;
-    readonly forced?: boolean;
-    readonly retain?: number;
-}
-export declare function transitionProcessShutdown(source: LifecycleState | null, input: TransitionShutdownInput): LifecycleTransition<ShutdownFact>;
 export interface ProcessLifecycleLedger {
     recordStart(input: {
         readonly version: string;
     }): Promise<StartFact>;
     recordReady(): Promise<ReadyFact>;
+    /** The run stopped admitting work; its `unavailableAt` is now. */
+    recordDraining(): Promise<DrainingFact>;
     recordShutdown(input?: {
         readonly forced?: boolean;
     }): Promise<ShutdownFact>;

package/dist/application/process-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-lifecycle.d.ts","sourceRoot":"","sources":["../../src/application/process-lifecycle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"process-lifecycle.d.ts","sourceRoot":"","sources":["../../src/application/process-lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,cAAc,EAEnB,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,SAAS,EAKf,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACrE,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,kEAAkE;IAClE,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IACxC,cAAc,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7E,OAAO,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACxC,IAAI,IAAI,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;IACzC,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC;CACvF;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACjD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAC3B,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,oBAAoB,KACvB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,4BAA4B,GACnC,sBAAsB,CAsGxB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,KAAK,IAAI,OAAO,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAA;KAAE,CAAC,CAAC;CAC9D;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,6BAA6B,GACpC,uBAAuB,CAsCzB"}

package/dist/entrypoints/agent-runtime/harness.js

@@ -6,7 +6,7 @@ import {
   composeAgentPrompt,
   createAgentRuntime,
   createAgentRuntimeEventSink
-} from "../../index-7f68ghdn.js";
+} from "../../index-8zja4pkf.js";
 import"../../index-83bdg97s.js";
 import"../../index-y64k3s0h.js";
 import {

package/dist/entrypoints/agent-runtime.js

@@ -24,7 +24,7 @@ import {
   renderAgentStateSlots,
   repairedSearchCall,
   selectAgentHistory
-} from "../index-7f68ghdn.js";
+} from "../index-8zja4pkf.js";
 import"../index-83bdg97s.js";
 import {
   AgentAdmissionEventSchema,

package/dist/entrypoints/application/directory-inbox.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The directory inbox — delivers each entry another program drops into a
+ * directory to the application at least once.
+ *
+ * Its own entrypoint because it reads, renames and removes files (`node:fs`),
+ * and `stitchkit/application` must stay importable in a browser. Its contract —
+ * the configuration, the delivery, the state and rejection schemas — stays in
+ * `stitchkit/application`, as the diagnostic journal's does. → ADR 0156.
+ */
+export { createDirectoryInbox } from '../../application/directory-inbox.js';
+//# sourceMappingURL=directory-inbox.d.ts.map

package/dist/entrypoints/application/directory-inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-inbox.d.ts","sourceRoot":"","sources":["../../../src/entrypoints/application/directory-inbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC"}