stitchkit 0.56.5 → 0.58.0

package/dist/index-vtjgx3vv.js

@@ -0,0 +1,161 @@
+// src/agent-runtime/schemas.ts
+import { z } from "zod";
+var AgentRecordIdSchema = z.string().min(1);
+var AgentRecordVersionSchema = z.int().nonnegative();
+var AgentTimestampSchema = z.iso.datetime({ offset: true });
+var AgentJsonObjectSchema = z.record(z.string(), z.json());
+var AgentProviderEnvelopeSchema = z.object({
+  schemaVersion: z.int().positive(),
+  provider: z.string().min(1),
+  data: AgentJsonObjectSchema
+});
+var AgentTextPartSchema = z.object({
+  type: z.literal("text"),
+  text: z.string()
+});
+var AgentReasoningPartSchema = z.object({
+  type: z.literal("reasoning"),
+  text: z.string(),
+  provider: AgentProviderEnvelopeSchema.optional()
+});
+var AgentFilePartSchema = z.object({
+  type: z.literal("file"),
+  mediaType: z.string().min(1),
+  reference: z.string().min(1),
+  filename: z.string().min(1).optional()
+});
+var AgentSourcePartSchema = z.object({
+  type: z.literal("source"),
+  sourceId: z.string().min(1),
+  url: z.url().optional(),
+  title: z.string().optional()
+});
+var AgentToolCallPartSchema = z.object({
+  type: z.literal("tool-call"),
+  callId: z.string().min(1),
+  toolName: z.string().min(1),
+  input: z.json(),
+  provider: AgentProviderEnvelopeSchema.optional()
+});
+var AgentToolResultPartSchema = z.object({
+  type: z.literal("tool-result"),
+  callId: z.string().min(1),
+  toolName: z.string().min(1),
+  outcome: z.enum(["success", "error", "interrupted"]),
+  output: z.json().optional()
+});
+var AgentOpaquePartSchema = z.object({
+  type: z.literal("provider"),
+  envelope: AgentProviderEnvelopeSchema
+});
+var AgentControlPartSchema = z.object({
+  type: z.literal("control"),
+  reason: z.enum(["run-interrupted", "stale-run"])
+});
+var AgentMessagePartSchema = z.discriminatedUnion("type", [
+  AgentTextPartSchema,
+  AgentReasoningPartSchema,
+  AgentFilePartSchema,
+  AgentSourcePartSchema,
+  AgentToolCallPartSchema,
+  AgentToolResultPartSchema,
+  AgentOpaquePartSchema,
+  AgentControlPartSchema
+]);
+var AgentMessageRoleSchema = z.enum(["user", "assistant", "system", "summary"]);
+var AgentMessageStatusSchema = z.enum([
+  "committed",
+  "streaming",
+  "completed",
+  "interrupted",
+  "failed"
+]);
+var AgentMessageSchema = z.object({
+  schemaVersion: z.literal(1),
+  id: AgentRecordIdSchema,
+  conversationId: AgentRecordIdSchema,
+  runId: AgentRecordIdSchema.optional(),
+  role: AgentMessageRoleSchema,
+  status: AgentMessageStatusSchema,
+  parts: z.array(AgentMessagePartSchema),
+  metadata: AgentJsonObjectSchema.optional(),
+  createdAt: AgentTimestampSchema,
+  updatedAt: AgentTimestampSchema
+});
+var AgentAssistantPlaceholderSchema = z.object({
+  schemaVersion: z.literal(1),
+  id: AgentRecordIdSchema,
+  conversationId: AgentRecordIdSchema,
+  runId: AgentRecordIdSchema,
+  status: z.literal("pending"),
+  createdAt: AgentTimestampSchema,
+  updatedAt: AgentTimestampSchema
+});
+var AgentRunStateSchema = z.enum([
+  "queued",
+  "running",
+  "interrupt_requested",
+  "completed",
+  "interrupted",
+  "failed",
+  "cancelled",
+  "abandoned"
+]);
+var AgentTerminalReasonSchema = z.enum([
+  "success",
+  "policy_stop",
+  "interrupted",
+  "cancelled",
+  "timeout",
+  "shutdown",
+  "provider_failure",
+  "tool_failure",
+  "abandoned"
+]);
+var AgentRunSchema = z.object({
+  schemaVersion: z.literal(1),
+  id: AgentRecordIdSchema,
+  conversationId: AgentRecordIdSchema,
+  inputMessageIds: z.array(AgentRecordIdSchema).min(1),
+  assistantMessageId: AgentRecordIdSchema,
+  state: AgentRunStateSchema,
+  revision: AgentRecordVersionSchema,
+  ownerId: z.string().min(1).optional(),
+  fencingToken: AgentRecordVersionSchema.optional(),
+  terminalReason: AgentTerminalReasonSchema.optional(),
+  terminalPolicyName: z.string().min(1).optional(),
+  createdAt: AgentTimestampSchema,
+  updatedAt: AgentTimestampSchema
+});
+var AgentSnapshotSchema = z.object({
+  schemaVersion: z.literal(1),
+  conversationId: AgentRecordIdSchema,
+  version: AgentRecordVersionSchema,
+  messages: z.array(AgentMessageSchema),
+  runs: z.array(AgentRunSchema)
+});
+var AgentUsageValueSchema = z.object({
+  value: z.number().nonnegative().optional(),
+  provenance: z.enum(["provider-reported", "computed", "estimated", "unavailable"])
+});
+var AgentCostValueSchema = z.object({
+  value: z.number().nonnegative().optional(),
+  currency: z.string().length(3).optional(),
+  provenance: z.enum(["provider-reported", "computed", "estimated", "unavailable"])
+});
+var AgentUsageSchema = z.object({
+  inputTokens: AgentUsageValueSchema,
+  outputTokens: AgentUsageValueSchema,
+  reasoningTokens: AgentUsageValueSchema.optional(),
+  cacheReadTokens: AgentUsageValueSchema.optional(),
+  cacheWriteTokens: AgentUsageValueSchema.optional(),
+  cost: AgentCostValueSchema.optional()
+});
+var AgentRunMetricsSchema = z.object({
+  partial: z.boolean(),
+  usage: AgentUsageSchema.optional(),
+  durationMs: z.number().nonnegative().optional(),
+  ttftMs: z.number().nonnegative().optional()
+});
+
+export { AgentRecordIdSchema, AgentRecordVersionSchema, AgentTimestampSchema, AgentJsonObjectSchema, AgentProviderEnvelopeSchema, AgentTextPartSchema, AgentReasoningPartSchema, AgentFilePartSchema, AgentSourcePartSchema, AgentToolCallPartSchema, AgentToolResultPartSchema, AgentOpaquePartSchema, AgentControlPartSchema, AgentMessagePartSchema, AgentMessageRoleSchema, AgentMessageStatusSchema, AgentMessageSchema, AgentAssistantPlaceholderSchema, AgentRunStateSchema, AgentTerminalReasonSchema, AgentRunSchema, AgentSnapshotSchema, AgentUsageValueSchema, AgentCostValueSchema, AgentUsageSchema, AgentRunMetricsSchema };

package/dist/server/error-hook.d.ts

@@ -5,7 +5,8 @@
  * Every project writes the same `onError`: turn a thrown value into one wire
  * shape, mapping stitchkit's own error codes to the app's public codes. The map
  * is partial — list the codes you have an opinion about, and an unlisted one
- * travels as itself, exactly like a code the project threw on its own. A
+ * travels as itself unless `unmappedCode` supplies one declarative fallback.
+ * Codes the project throws on its own always pass through unchanged. A
  * project whose envelope is a published contract adds `satisfies
  * Record<StitchErrorCode, …>` to its own map and buys the stricter deal: a code
  * added by a later release then breaks the build instead of reaching the wire
@@ -58,6 +59,12 @@ export interface ErrorHookConfig<TWireCode extends string = string> {
      * error here. Codes you threw yourself (not stitchkit's) pass through as-is.
      */
     codeMap?: Partial<Record<StitchErrorCode, TWireCode>>;
+    /**
+     * Wire code for every unmapped stitchkit code, or a resolver for grouping
+     * them. Explicit `codeMap` entries win. Project-owned codes never use this
+     * fallback and continue to pass through unchanged.
+     */
+    unmappedCode?: TWireCode | ((code: StitchErrorCode) => TWireCode);
     /** Build the response body from the resolved error. */
     /**
      * Build the response body from the resolved error. `ctx` is the request's

package/dist/server/error-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-hook.d.ts","sourceRoot":"","sources":["../../src/server/error-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzD,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,oCAAoC;AACpC,MAAM,WAAW,eAAe,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IAChE;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC,CAAC;IACtD,uDAAuD;IACvD;;;;;OAKG;IACH,MAAM,EAAE,CACN,IAAI,EAAE,aAAa,EACnB,GAAG,EAAE,cAAc,EACnB,QAAQ,CAAC,EAAE,SAAS,KACjB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC;;;;OAIG;IACH,OAAO,CAAC,EAAE,CACR,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,aAAa,EACnB,GAAG,EAAE,cAAc,EACnB,QAAQ,CAAC,EAAE,SAAS,KACjB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM,EAC/D,MAAM,EAAE,eAAe,CAAC,SAAS,CAAC,GACjC,WAAW,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAgCxC"}
+{"version":3,"file":"error-hook.d.ts","sourceRoot":"","sources":["../../src/server/error-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzD,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,oCAAoC;AACpC,MAAM,WAAW,eAAe,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IAChE;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC,CAAC;IACtD;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,IAAI,EAAE,eAAe,KAAK,SAAS,CAAC,CAAC;IAClE,uDAAuD;IACvD;;;;;OAKG;IACH,MAAM,EAAE,CACN,IAAI,EAAE,aAAa,EACnB,GAAG,EAAE,cAAc,EACnB,QAAQ,CAAC,EAAE,SAAS,KACjB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC;;;;OAIG;IACH,OAAO,CAAC,EAAE,CACR,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,aAAa,EACnB,GAAG,EAAE,cAAc,EACnB,QAAQ,CAAC,EAAE,SAAS,KACjB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM,EAC/D,MAAM,EAAE,eAAe,CAAC,SAAS,CAAC,GACjC,WAAW,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAkCxC"}

package/dist/server/index.js

@@ -351,8 +351,10 @@ function cacheHeaders(maxAge, scope = "public") {
 function createErrorHook(config) {
   return async (ctx, error, endpoint) => {
     const appErr = normalizeError(error);
-    const mapped = config.codeMap && isStitchErrorCode(appErr.code) ? config.codeMap[appErr.code] : undefined;
-    const code = mapped ?? appErr.code;
+    const stitchCode = isStitchErrorCode(appErr.code) ? appErr.code : undefined;
+    const mapped = stitchCode === undefined ? undefined : config.codeMap?.[stitchCode];
+    const fallback = mapped === undefined && stitchCode !== undefined ? typeof config.unmappedCode === "function" ? config.unmappedCode(stitchCode) : config.unmappedCode : undefined;
+    const code = mapped ?? fallback ?? appErr.code;
     const info = {
       code,
       status: appErr.status,

package/dist/testing/agent-store-conformance.d.ts

@@ -0,0 +1,7 @@
+import type { AgentRuntimeStore } from '../agent-runtime/store';
+export interface AgentStoreConformanceConfig {
+    createStore(): AgentRuntimeStore | Promise<AgentRuntimeStore>;
+}
+/** Black-box contract shared by memory and third-party durable agent stores. */
+export declare function runAgentStoreConformance(config: AgentStoreConformanceConfig): Promise<void>;
+//# sourceMappingURL=agent-store-conformance.d.ts.map

package/dist/testing/agent-store-conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-store-conformance.d.ts","sourceRoot":"","sources":["../../src/testing/agent-store-conformance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,WAAW,2BAA2B;IAC1C,WAAW,IAAI,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/D;AAwCD,gFAAgF;AAChF,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,IAAI,CAAC,CAmPf"}

package/dist/testing.d.ts

@@ -31,6 +31,8 @@ export declare function createHandlerTestClient<T extends Record<string, Endpoin
 export declare function createHandlerTestClients<T extends Record<string, ContractDef<Record<string, EndpointDef>, string>>, TServer = unknown, const K extends string = never>(config: HandlerTestClientsConfig<T, TServer, K>): {
     [P in keyof T]: ScopedHttpClient<T[P]['endpoints'], ScopedKeys<K>>;
 };
+export { type AgentRaceBarrier, type AgentRaceDriver, type AgentRaceTrace, type AgentRaceTraceEntry, createAgentRaceBarrier, createAgentRaceDriver, createAgentRaceTrace, } from './agent-runtime/testing';
+export { type AgentStoreConformanceConfig, runAgentStoreConformance, } from './testing/agent-store-conformance';
 export { assertSurfaceDiscovery, type ConformanceTransport, type CreateRealtimeProbeDriverConfig, createRealtimeProbeDriver, type DefineRealtimeProbeConfig, defineRealtimeProbe, type RealtimeDisconnectObservation, RealtimeDisconnectObservationSchema, type RealtimeProbeAdapter, type RealtimeProbeFixture, type RealtimeProbeScenario, type RealtimeRejectionObservation, RealtimeRejectionObservationSchema, type RunSurfaceProbesConfig, runSurfaceProbes, type SurfaceDiscoveryObservation, type SurfaceProbe, type SurfaceProbeDriver, type SurfaceRealtimeDiscoveryObservation, type SurfaceToolDiscoveryObservation, type TransportObservation, TransportObservationSchema, } from './testing/surface-conformance';
 export { assertSurfaceManifestSnapshot, buildSurfaceManifest, type IncompatibleSchemaPolicy, type McpSchemaValidationConfig, type SurfaceAgentProjection, type SurfaceManifest, type SurfaceManifestConfig, type SurfaceManifestExtension, SurfaceManifestExtensionSchema, type SurfaceManifestOperation, SurfaceManifestOperationSchema, type SurfaceManifestRealtimeEvent, SurfaceManifestRealtimeEventSchema, SurfaceManifestSchema, type SurfaceManifestTool, SurfaceManifestToolSchema, type SurfaceManifestToolSurface, SurfaceManifestToolSurfaceSchema, type SurfaceMcpPreparation, SurfaceRealtimeSchemaPairSchema, type SurfaceRuntimeToolDefinition, SurfaceSchemaDigestsSchema, type SurfaceToolDefinition, type SurfaceToolExtension, serializeSurfaceValue, } from './testing/surface-manifest';
 //# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

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

package/dist/testing.js

@@ -1,3 +1,7 @@
+import {
+  AgentMessageSchema,
+  AgentRunSchema
+} from "./index-vtjgx3vv.js";
 import {
   RealtimeRequestDisconnectedError,
   RealtimeRequestInvalidAcknowledgementError,
@@ -23,6 +27,329 @@ import {
 } from "./index-smpbdg6k.js";
 import"./index-1bx83sw4.js";
 
+// src/agent-runtime/testing.ts
+function createAgentRaceBarrier(timeoutMs = 5000) {
+  if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1) {
+    throw new TypeError("Agent race barrier timeoutMs must be a positive safe integer");
+  }
+  const reached = Promise.withResolvers();
+  const released = Promise.withResolvers();
+  let announced = false;
+  return {
+    reached: reached.promise,
+    async wait() {
+      if (!announced) {
+        announced = true;
+        reached.resolve();
+      }
+      let timer;
+      try {
+        await Promise.race([
+          released.promise,
+          new Promise((_resolve, reject) => {
+            timer = setTimeout(() => reject(new Error(`Agent race barrier exceeded ${timeoutMs}ms teardown bound`)), timeoutMs);
+          })
+        ]);
+      } finally {
+        if (timer !== undefined)
+          clearTimeout(timer);
+      }
+    },
+    release: released.resolve
+  };
+}
+function createAgentRaceTrace() {
+  const recorded = [];
+  return {
+    record(name) {
+      const entry = { name, sequence: recorded.length };
+      recorded.push(entry);
+      return entry;
+    },
+    entries: () => recorded.map((entry) => ({ ...entry })),
+    assertBefore(first, second) {
+      const firstEntry = recorded.find((entry) => entry.name === first);
+      const secondEntry = recorded.find((entry) => entry.name === second);
+      if (!firstEntry || !secondEntry || firstEntry.sequence >= secondEntry.sequence) {
+        throw new Error(`Expected ${first} before ${second}`);
+      }
+    },
+    assertSequence(names) {
+      const actual = recorded.map((entry) => entry.name);
+      if (actual.length !== names.length || actual.some((name, index) => name !== names[index])) {
+        throw new Error(`Expected trace ${names.join(" -> ")}, received ${actual.join(" -> ")}`);
+      }
+    },
+    count: (name) => recorded.filter((entry) => entry.name === name).length
+  };
+}
+function createAgentRaceDriver(timeoutMs = 5000) {
+  const trace = createAgentRaceTrace();
+  const barriers = new Map;
+  return {
+    trace,
+    barrier(name) {
+      const existing = barriers.get(name);
+      if (existing)
+        return existing;
+      const created = createAgentRaceBarrier(timeoutMs);
+      barriers.set(name, created);
+      return created;
+    },
+    releaseAll() {
+      for (const barrier of barriers.values())
+        barrier.release();
+    }
+  };
+}
+// src/testing/agent-store-conformance.ts
+function userMessage(conversationId, id) {
+  return AgentMessageSchema.parse({
+    schemaVersion: 1,
+    id,
+    conversationId,
+    role: "user",
+    status: "committed",
+    parts: [{ type: "text", text: id }],
+    createdAt: "2026-08-22T00:00:00.000Z",
+    updatedAt: "2026-08-22T00:00:00.000Z"
+  });
+}
+function queuedRun(conversationId, inputMessageId, id) {
+  return AgentRunSchema.parse({
+    schemaVersion: 1,
+    id,
+    conversationId,
+    inputMessageIds: [inputMessageId],
+    assistantMessageId: `${id}-assistant`,
+    state: "queued",
+    revision: 0,
+    createdAt: "2026-08-22T00:00:00.000Z",
+    updatedAt: "2026-08-22T00:00:00.000Z"
+  });
+}
+function requireOutcome(actual, expected) {
+  if (actual.outcome !== expected) {
+    throw new Error(`Agent store conformance expected ${expected}, received ${actual.outcome}`);
+  }
+}
+async function runAgentStoreConformance(config) {
+  const store = await config.createStore();
+  const conversationId = `conformance-${crypto.randomUUID()}`;
+  const firstInput = userMessage(conversationId, "input-1");
+  const firstRun = queuedRun(conversationId, firstInput.id, "run-1");
+  const accepted = await store.acceptInputAndAssignRun({
+    idempotencyKey: "request-1",
+    input: firstInput,
+    run: firstRun
+  });
+  requireOutcome(accepted, "applied");
+  const duplicate = await store.acceptInputAndAssignRun({
+    idempotencyKey: "request-1",
+    input: userMessage(conversationId, "discarded-input"),
+    run: queuedRun(conversationId, "discarded-input", "discarded-run")
+  });
+  requireOutcome(duplicate, "duplicate");
+  if (duplicate.input.id !== firstInput.id || duplicate.inputMessageId !== firstInput.id || duplicate.runId !== firstRun.id || duplicate.assistantMessageId !== firstRun.assistantMessageId) {
+    throw new Error("Duplicate admission did not return its original durable identity");
+  }
+  const secondInput = userMessage(conversationId, "input-2");
+  const coalesced = await store.acceptInputAndAssignRun({
+    idempotencyKey: "request-2",
+    input: secondInput,
+    run: queuedRun(conversationId, secondInput.id, "discarded-coalesced-run"),
+    coalesceIntoRunId: firstRun.id
+  });
+  requireOutcome(coalesced, "applied");
+  const assigned = coalesced.snapshot.runs.find((run) => run.id === firstRun.id);
+  if (assigned?.inputMessageIds.join(",") !== "input-1,input-2") {
+    throw new Error("Coalesced admission did not preserve ordered input identities");
+  }
+  const collidingInput = userMessage(conversationId, assigned.assistantMessageId);
+  await store.acceptInputAndAssignRun({
+    idempotencyKey: "request-collision",
+    input: collidingInput,
+    run: queuedRun(conversationId, collidingInput.id, "discarded-collision-run"),
+    coalesceIntoRunId: assigned.id
+  }).then(() => {
+    throw new Error("Coalesced input reused the reserved assistant identity");
+  }, (error) => {
+    if (!(error instanceof TypeError))
+      throw error;
+  });
+  await store.replaceCompactedRange({
+    conversationId,
+    expectedVersion: coalesced.snapshot.version,
+    replacedMessageIds: [firstInput.id, secondInput.id],
+    summary: AgentMessageSchema.parse({
+      schemaVersion: 1,
+      id: assigned.assistantMessageId,
+      conversationId,
+      role: "summary",
+      status: "committed",
+      parts: [{ type: "text", text: "invalid reserved identity" }],
+      createdAt: "2026-08-22T00:00:02.000Z",
+      updatedAt: "2026-08-22T00:00:02.000Z"
+    })
+  }).then(() => {
+    throw new Error("Compaction reused a reserved assistant identity");
+  }, (error) => {
+    if (!(error instanceof TypeError))
+      throw error;
+  });
+  const compacted = await store.replaceCompactedRange({
+    conversationId,
+    expectedVersion: coalesced.snapshot.version,
+    replacedMessageIds: [firstInput.id, secondInput.id],
+    summary: AgentMessageSchema.parse({
+      schemaVersion: 1,
+      id: "summary-1",
+      conversationId,
+      role: "summary",
+      status: "committed",
+      parts: [{ type: "text", text: "two inputs" }],
+      createdAt: "2026-08-22T00:00:02.000Z",
+      updatedAt: "2026-08-22T00:00:02.000Z"
+    })
+  });
+  requireOutcome(compacted, "applied");
+  const duplicateAfterCompaction = await store.acceptInputAndAssignRun({
+    idempotencyKey: "request-1",
+    input: userMessage(conversationId, "discarded-after-compaction"),
+    run: queuedRun(conversationId, "discarded-after-compaction", "discarded-run-2")
+  });
+  requireOutcome(duplicateAfterCompaction, "duplicate");
+  if (duplicateAfterCompaction.input.id !== firstInput.id) {
+    throw new Error("Compaction discarded the canonical duplicate admission input");
+  }
+  const acquired = await store.acquireRun({
+    conversationId,
+    runId: assigned.id,
+    expectedRevision: assigned.revision,
+    ownerId: "conformance-owner"
+  });
+  requireOutcome(acquired, "applied");
+  const running = acquired.snapshot.runs.find((run) => run.id === assigned.id);
+  if (!running)
+    throw new Error("Acquired run disappeared");
+  const stale = await store.checkpointRunAssistant({
+    conversationId,
+    runId: running.id,
+    expectedRevision: running.revision - 1,
+    ownerId: "conformance-owner",
+    assistant: AgentMessageSchema.parse({
+      schemaVersion: 1,
+      id: running.assistantMessageId,
+      conversationId,
+      runId: running.id,
+      role: "assistant",
+      status: "streaming",
+      parts: [],
+      createdAt: "2026-08-22T00:00:00.000Z",
+      updatedAt: "2026-08-22T00:00:01.000Z"
+    })
+  });
+  requireOutcome(stale, "conflict");
+  await store.recoverRun({
+    conversationId,
+    runId: running.id,
+    expectedRevision: running.revision,
+    action: "requeue"
+  }).then(() => {
+    throw new Error("Acquired recovery replayed without explicit safety evidence");
+  }, (error) => {
+    if (!(error instanceof TypeError))
+      throw error;
+  });
+  const checkpoint = await store.checkpointRunAssistant({
+    conversationId,
+    runId: running.id,
+    expectedRevision: running.revision,
+    ownerId: "conformance-owner",
+    assistant: AgentMessageSchema.parse({
+      schemaVersion: 1,
+      id: running.assistantMessageId,
+      conversationId,
+      runId: running.id,
+      role: "assistant",
+      status: "streaming",
+      parts: [{ type: "text", text: "checkpoint" }],
+      createdAt: "2026-08-22T00:00:00.000Z",
+      updatedAt: "2026-08-22T00:00:01.000Z"
+    })
+  });
+  requireOutcome(checkpoint, "applied");
+  const checkpointedRun = checkpoint.snapshot.runs.find((run) => run.id === running.id);
+  if (!checkpointedRun)
+    throw new Error("Checkpointed run disappeared");
+  const terminalAssistant = AgentMessageSchema.parse({
+    schemaVersion: 1,
+    id: running.assistantMessageId,
+    conversationId,
+    runId: running.id,
+    role: "assistant",
+    status: "completed",
+    parts: [{ type: "text", text: "done" }],
+    createdAt: "2026-08-22T00:00:00.000Z",
+    updatedAt: "2026-08-22T00:00:02.000Z"
+  });
+  const terminalResults = await Promise.all([
+    store.commitRunTerminal({
+      conversationId,
+      runId: running.id,
+      expectedRevision: checkpointedRun.revision,
+      ownerId: "conformance-owner",
+      assistant: terminalAssistant,
+      reason: "success"
+    }),
+    store.commitRunTerminal({
+      conversationId,
+      runId: running.id,
+      expectedRevision: checkpointedRun.revision,
+      ownerId: "conformance-owner",
+      assistant: terminalAssistant,
+      reason: "success"
+    })
+  ]);
+  const terminalOutcomes = terminalResults.map((result) => result.outcome).sort();
+  if (terminalOutcomes.join(",") !== "applied,conflict") {
+    throw new Error(`Terminal race was not linearized: ${terminalOutcomes.join(",")}`);
+  }
+  const recoveryConversationId = `${conversationId}-recovery`;
+  const recoveryInput = userMessage(recoveryConversationId, "recovery-input");
+  const recoveryRun = queuedRun(recoveryConversationId, recoveryInput.id, "recovery-run");
+  const recoveryAccepted = await store.acceptInputAndAssignRun({
+    idempotencyKey: "recovery-request",
+    input: recoveryInput,
+    run: recoveryRun
+  });
+  requireOutcome(recoveryAccepted, "applied");
+  const recoveryAssigned = recoveryAccepted.snapshot.runs.find((run) => run.id === recoveryRun.id);
+  if (!recoveryAssigned)
+    throw new Error("Recovery run disappeared after admission");
+  const recoveryAcquired = await store.acquireRun({
+    conversationId: recoveryConversationId,
+    runId: recoveryAssigned.id,
+    expectedRevision: recoveryAssigned.revision,
+    ownerId: "abandoned-owner"
+  });
+  requireOutcome(recoveryAcquired, "applied");
+  const abandonedRun = recoveryAcquired.snapshot.runs.find((run) => run.id === recoveryRun.id);
+  if (!abandonedRun)
+    throw new Error("Recovery run disappeared after acquisition");
+  const abandoned = await store.recoverRun({
+    conversationId: recoveryConversationId,
+    runId: abandonedRun.id,
+    expectedRevision: abandonedRun.revision,
+    action: "abandon"
+  });
+  requireOutcome(abandoned, "applied");
+  const terminalRun = abandoned.snapshot.runs.find((run) => run.id === abandonedRun.id);
+  const terminalMessage = abandoned.snapshot.messages.find((message) => message.id === abandonedRun.assistantMessageId);
+  if (terminalRun?.state !== "abandoned" || terminalMessage?.status !== "failed") {
+    throw new Error("Abandon recovery did not atomically terminalize its assistant record");
+  }
+}
 // src/testing/surface-conformance.ts
 import { z as z2 } from "zod";
 
@@ -740,10 +1067,14 @@ export {
   assertSurfaceDiscovery,
   assertSurfaceManifestSnapshot,
   buildSurfaceManifest,
+  createAgentRaceBarrier,
+  createAgentRaceDriver,
+  createAgentRaceTrace,
   createHandlerTestClient,
   createHandlerTestClients,
   createRealtimeProbeDriver,
   defineRealtimeProbe,
+  runAgentStoreConformance,
   runSurfaceProbes,
   serializeSurfaceValue
 };