stitchkit 0.85.1 → 0.85.2

package/CHANGELOG.md

@@ -15,6 +15,24 @@ additive**; the first breaking change landed in 0.10.0. Grep the file for
 
 ## [Unreleased]
 
+## [0.85.2] — 2026-09-08
+
+### Fixed
+
+- **An asynchronous store no longer fails a run before the provider is
+  called.** The assistant checkpoint and the model-request admission are two
+  owned mutations of one run, written by two independent schedules — the stream
+  consumer and the SDK's model middleware — and each named the revision it read
+  before its own `await`. Where the store answered on a later tick (a worker, a
+  socket, a real database) the second write named a spent revision, the losing
+  compare-and-set threw out of `wrapStream`, and the run ended
+  `provider_failure` with zero provider calls; frequent checkpoints
+  (`checkpointEveryEvents: 1`) made it reliable. Owned mutations of a run now
+  take their turn in one per-run queue and read the revision inside that turn.
+  Independent runs are unaffected — the queue is per run — and fencing,
+  cancellation and checkpoint durability are unchanged. Proven on the packed
+  tarball by a consumer-lane fixture, not only in-repo. → ADR 0174 (amended).
+
 ## [0.85.1] — 2026-09-07
 
 ### Fixed

package/dist/agent-runtime/run-execution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-execution.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/run-execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,OAAO,EACb,MAAM,IAAI,CAAC;AAMZ,OAAO,EAAE,KAAK,iBAAiB,EAAuB,MAAM,UAAU,CAAC;AAEvE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAI1D,OAAO,KAAK,EAAqB,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAavE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAKL,KAAK,QAAQ,EAOd,MAAM,WAAW,CAAC;AAuCnB,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB,CAAC,OAAO,EAAE,KAAK,SAAS,OAAO;IACrE,MAAM,EAAE,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3C,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,IAAI,MAAM,CAAC;IACrB,GAAG,IAAI,IAAI,CAAC;IACZ,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,KAAK,SAAS,OAAO,EAC9D,YAAY,EAAE,uBAAuB,CAAC,OAAO,EAAE,KAAK,CAAC,WAcb;IACtC,WAAW,EAAE,QAAQ,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,UAAU,CAAC,IAAI,IAAI,CAAC;CACrB,KAAG,OAAO,CAAC,kBAAkB,CAAC,CAoiChC"}
+{"version":3,"file":"run-execution.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/run-execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,OAAO,EACb,MAAM,IAAI,CAAC;AAMZ,OAAO,EAAE,KAAK,iBAAiB,EAAuB,MAAM,UAAU,CAAC;AAEvE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAK1D,OAAO,KAAK,EAAqB,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAavE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAKL,KAAK,QAAQ,EAOd,MAAM,WAAW,CAAC;AAuCnB,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB,CAAC,OAAO,EAAE,KAAK,SAAS,OAAO;IACrE,MAAM,EAAE,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3C,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,IAAI,MAAM,CAAC;IACrB,GAAG,IAAI,IAAI,CAAC;IACZ,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,KAAK,SAAS,OAAO,EAC9D,YAAY,EAAE,uBAAuB,CAAC,OAAO,EAAE,KAAK,CAAC,WAcb;IACtC,WAAW,EAAE,QAAQ,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,UAAU,CAAC,IAAI,IAAI,CAAC;CACrB,KAAG,OAAO,CAAC,kBAAkB,CAAC,CA8iChC"}

package/dist/agent-runtime/run-mutation-queue.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Owned mutations of one run, applied one at a time.
+ *
+ * Every owned mutation is a compare-and-set against the run's current revision,
+ * and the revision it must name is the one the previous mutation produced.
+ * Reading that revision and writing it back are therefore safe apart only while
+ * nothing else can write in between — which stops being true the moment a store
+ * returns a promise that yields. With an asynchronous store the assistant
+ * checkpoint and the model-request admission both name the revision they read
+ * before their own `await`, the later write is rejected as a conflict, and the
+ * run fails without the provider ever having been called.
+ *
+ * The terminal commit answers the same hazard with a bounded retry, which suits
+ * it: committing a terminal twice is a duplicate the store recognises. It does
+ * not suit these two — a retried operation write would publish a second
+ * lifecycle event for one provider call — so they take their turn instead.
+ */
+export type RunMutationQueue = <T>(mutation: () => Promise<T>) => Promise<T>;
+/** A queue of owned mutations for one run. */
+export declare function createRunMutationQueue(): RunMutationQueue;
+//# sourceMappingURL=run-mutation-queue.d.ts.map

package/dist/agent-runtime/run-mutation-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-mutation-queue.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/run-mutation-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7E,8CAA8C;AAC9C,wBAAgB,sBAAsB,IAAI,gBAAgB,CAgBzD"}

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

@@ -1,5 +1,6 @@
 import { type LanguageModel } from 'ai';
 import type { AgentRuntimeEvent } from './event-schema.js';
+import type { RunMutationQueue } from './run-mutation-queue.js';
 import { type AgentRun, type AgentSnapshot } from './schemas.js';
 import type { AgentRuntimeStore } from './store.js';
 type TerminalOperationPhase = 'completed' | 'failed' | 'cancelled';
@@ -10,6 +11,8 @@ export interface AgentRunOperationLifecycleConfig {
     acceptSnapshot(snapshot: AgentSnapshot): void;
     publish(event: AgentRuntimeEvent): Promise<void>;
     now(): Date;
+    /** The order every owned mutation of this run takes its turn in. */
+    serialize: RunMutationQueue;
 }
 /** One durable latest-operation state machine for an executing run. */
 export declare function createAgentRunOperationLifecycle(config: AgentRunOperationLifecycleConfig): {

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,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;CACb;AAED,uEAAuE;AACvE,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,gCAAgC;IA4CrF,gBAAgB,SAAS,MAAM,GAAG,IAAI;IAGhC,YAAY,QACT,aAAa,QACd,MAAM,kBACI,MAAM,GACrB,OAAO,CAAC,aAAa,CAAC;IAgCzB,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;AAExD,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;IA+CrF,gBAAgB,SAAS,MAAM,GAAG,IAAI;IAGhC,YAAY,QACT,aAAa,QACd,MAAM,kBACI,MAAM,GACrB,OAAO,CAAC,aAAa,CAAC;IAgCzB,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/agent-runtime-harness.js

@@ -2,7 +2,7 @@ import {
   composeAgentPrompt,
   createAgentRuntime,
   createAgentRuntimeEventSink
-} from "./index-jpp7jd1p.js";
+} from "./index-2jg7b11j.js";
 import {
   AgentModelDescriptorSchema
 } from "./index-tg3m2ec5.js";

package/dist/agent-runtime.js

@@ -49,7 +49,7 @@ import {
   registerDeferredToolRepair,
   repairedSearchCall,
   selectAgentHistory
-} from "./index-jpp7jd1p.js";
+} from "./index-2jg7b11j.js";
 import {
   AgentModelCapabilitySchema,
   AgentModelCatalogEntrySchema,

package/dist/{index-jpp7jd1p.js → index-2jg7b11j.js}

@@ -934,6 +934,20 @@ function repairedSearchCall(toolCall, searchName) {
   };
 }
 
+// src/agent-runtime/run-mutation-queue.ts
+function createRunMutationQueue() {
+  let tail = Promise.resolve();
+  return (mutation) => {
+    const result = tail.then(mutation, mutation);
+    tail = result.then(() => {
+      return;
+    }, () => {
+      return;
+    });
+    return result;
+  };
+}
+
 // src/agent-runtime/run-operation-lifecycle.ts
 import { wrapLanguageModel } from "ai";
 
@@ -1084,7 +1098,7 @@ function createAgentRunOperationLifecycle(config) {
   let providerCallId;
   let checkpointedStep = -1;
   const checkpointWaiters = new Map;
-  const record = async (operation) => {
+  const record = (operation) => config.serialize(async () => {
     const current = config.currentRun();
     const snapshot = appliedSnapshot(await config.store.recordRunOperation({
       conversationId: current.conversationId,
@@ -1106,7 +1120,7 @@ function createAgentRunOperationLifecycle(config) {
       operation,
       emittedAt: config.now().toISOString()
     });
-  };
+  });
   const startModelRequest = (callId, step) => record(AgentRunOperationSchema.parse({
     operationId: `${callId}:${step}`,
     kind: "model-request",
@@ -1314,9 +1328,11 @@ function createRunExecutor(dependencies) {
     let terminalPolicyName;
     const idleDeadline = createIdleDeadline(input.signal, idleTimeoutMs);
     const executionSignal = idleDeadline.signal;
+    const serialize = createRunMutationQueue();
     const operationLifecycle = createAgentRunOperationLifecycle({
       store: config.store,
       runtimeEpoch,
+      serialize,
       currentRun: () => run,
       acceptSnapshot: (next) => {
         snapshot = next;
@@ -1347,7 +1363,7 @@ function createRunExecutor(dependencies) {
         ...provider && { provider }
       }));
     };
-    const checkpoint = async () => {
+    const checkpoint = () => serialize(async () => {
       assistant = AgentMessageSchema.parse({
         ...assistant,
         parts,
@@ -1380,7 +1396,7 @@ function createRunExecutor(dependencies) {
         metrics: checkpointMetrics,
         emittedAt: now().toISOString()
       });
-    };
+    });
     try {
       if (config.history?.compact) {
         await operationLifecycle.startCompaction(generateId());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stitchkit",
-  "version": "0.85.1",
+  "version": "0.85.2",
   "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",