stitchkit 0.65.1 → 0.66.1

package/dist/{index-sbkyvacf.js → index-fhsmrzj7.js}

@@ -114,6 +114,7 @@ var AgentTerminalReasonSchema = z.enum([
   "shutdown",
   "provider_failure",
   "context_overflow",
+  "absorbed",
   "abandoned"
 ]);
 function runStateForTerminalReason(reason) {
@@ -122,7 +123,7 @@ function runStateForTerminalReason(reason) {
   }
   if (reason === "interrupted")
     return "interrupted";
-  if (reason === "superseded")
+  if (reason === "superseded" || reason === "absorbed")
     return "superseded";
   if (reason === "cancelled" || reason === "shutdown" || reason === "timeout") {
     return "cancelled";
@@ -131,14 +132,31 @@ function runStateForTerminalReason(reason) {
     return "abandoned";
   return "failed";
 }
+var AgentProvenanceSchema = z.enum([
+  "provider-reported",
+  "measured",
+  "computed",
+  "estimated",
+  "unavailable"
+]);
 var AgentUsageValueSchema = z.object({
-  value: z.number().nonnegative().optional(),
-  provenance: z.enum(["provider-reported", "computed", "estimated", "unavailable"])
+  value: z.int().nonnegative().optional(),
+  provenance: AgentProvenanceSchema.extract([
+    "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"])
+  provenance: AgentProvenanceSchema.extract([
+    "provider-reported",
+    "computed",
+    "estimated",
+    "unavailable"
+  ])
 });
 var AgentUsageSchema = z.object({
   inputTokens: AgentUsageValueSchema,
@@ -160,11 +178,19 @@ var AgentRunFieldsSchema = z.object({
   fencingToken: AgentRecordVersionSchema.optional(),
   terminalReason: AgentTerminalReasonSchema.optional(),
   terminalPolicyName: z.string().min(1).optional(),
+  absorbedIntoRunId: AgentRecordIdSchema.optional(),
   usage: AgentUsageSchema.optional(),
   createdAt: AgentTimestampSchema,
   updatedAt: AgentTimestampSchema
 });
 var AgentRunSchema = AgentRunFieldsSchema.superRefine((run, ctx) => {
+  if (run.terminalReason !== "absorbed" && run.absorbedIntoRunId !== undefined) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["absorbedIntoRunId"],
+      message: "Only an absorbed run names the run that answered it"
+    });
+  }
   if (run.terminalReason === undefined) {
     if (TERMINAL_RUN_STATES.has(run.state)) {
       ctx.addIssue({
@@ -190,6 +216,20 @@ var AgentRunSchema = AgentRunFieldsSchema.superRefine((run, ctx) => {
       message: "A policy stop names the policy that stopped the run"
     });
   }
+  if (run.terminalReason === "absorbed" && run.absorbedIntoRunId === undefined) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["absorbedIntoRunId"],
+      message: "An absorbed run names the run that answered its input"
+    });
+  }
+  if (run.absorbedIntoRunId === run.id) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["absorbedIntoRunId"],
+      message: "A run cannot absorb itself"
+    });
+  }
 });
 var TERMINAL_RUN_STATES = new Set([
   "completed",
@@ -213,4 +253,4 @@ var AgentRunMetricsSchema = z.object({
   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, runStateForTerminalReason, AgentUsageValueSchema, AgentCostValueSchema, AgentUsageSchema, AgentRunSchema, AgentSnapshotSchema, AgentRunMetricsSchema };
+export { AgentRecordIdSchema, AgentRecordVersionSchema, AgentTimestampSchema, AgentJsonObjectSchema, AgentProviderEnvelopeSchema, AgentTextPartSchema, AgentReasoningPartSchema, AgentFilePartSchema, AgentSourcePartSchema, AgentToolCallPartSchema, AgentToolResultPartSchema, AgentOpaquePartSchema, AgentControlPartSchema, AgentMessagePartSchema, AgentMessageRoleSchema, AgentMessageStatusSchema, AgentMessageSchema, AgentAssistantPlaceholderSchema, AgentRunStateSchema, AgentTerminalReasonSchema, runStateForTerminalReason, AgentProvenanceSchema, AgentUsageValueSchema, AgentCostValueSchema, AgentUsageSchema, AgentRunSchema, AgentSnapshotSchema, AgentRunMetricsSchema };

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

@@ -1,6 +1,39 @@
 import type { AgentRuntimeStore } from '../agent-runtime/store';
+/**
+ * What the scenario is about to touch, handed over before the first mutation.
+ *
+ * The kit used to pick its conversation identities *after* `createStore()`
+ * returned, which locked out exactly the adapters it exists to certify: a
+ * durable store whose runtime rows hang off an application-owned conversation
+ * row cannot serve the first admission, because nobody ever told it which
+ * parent to provision. Running the kit against the memory reference store
+ * instead proves the reducer — which is not the thing under test.
+ */
+export interface AgentStoreConformanceContext {
+    /**
+     * Every conversation the scenario mutates, in the order it first touches
+     * them. Provision one parent per id before returning the store, and remove
+     * them again in `cleanup`.
+     */
+    readonly conversationIds: readonly string[];
+}
 export interface AgentStoreConformanceConfig {
-    createStore(): AgentRuntimeStore | Promise<AgentRuntimeStore>;
+    /**
+     * Build the store under test. The context arrives first so an adapter can
+     * provision fixture state; a factory that needs none may ignore it, and an
+     * existing zero-argument factory stays valid unchanged.
+     */
+    createStore(context: AgentStoreConformanceContext): AgentRuntimeStore | Promise<AgentRuntimeStore>;
+    /**
+     * Remove whatever `createStore` provisioned.
+     *
+     * Runs exactly once, after the scenario, whether it passed or failed — a kit
+     * that only cleans up on success leaks a row for every red run, which is the
+     * shape that makes a failing suite un-rerunnable. A failure here never
+     * replaces the scenario's own: the answer to "does this adapter conform" is
+     * not overwritten by the answer to "did the teardown work".
+     */
+    cleanup?(context: AgentStoreConformanceContext): void | Promise<void>;
 }
 /** Black-box contract shared by memory and third-party durable agent stores. */
 export declare function runAgentStoreConformance(config: AgentStoreConformanceConfig): Promise<void>;

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

@@ -1 +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,CAiXf"}
+{"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;;;;;;;;;GASG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,WAAW,CACT,OAAO,EAAE,4BAA4B,GACpC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClD;;;;;;;;OAQG;IACH,OAAO,CAAC,CAAC,OAAO,EAAE,4BAA4B,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAwCD,gFAAgF;AAChF,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,IAAI,CAAC,CA2Bf"}

package/dist/testing.d.ts

@@ -32,7 +32,7 @@ export declare function createHandlerTestClients<T extends Record<string, Contra
     [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 { type AgentStoreConformanceConfig, type AgentStoreConformanceContext, runAgentStoreConformance, } from './testing/agent-store-conformance';
 export { type ManagedResourceConformanceConfig, type ManagedResourceConformanceControls, ManagedResourceConformanceError, type ManagedResourceConformanceFactoryInput, type ManagedResourceConformanceFixture, type ManagedResourceConformancePhase, ManagedResourceConformancePhaseSchema, type ManagedResourceConformanceScenario, type ManagedResourceConformanceScenarioId, ManagedResourceConformanceScenarioIdSchema, ManagedResourceConformanceScenarioSchema, type ManagedResourceConformanceTraceEntry, ManagedResourceConformanceTraceEntrySchema, type ManagedResourceConformanceTraceOutcome, ManagedResourceConformanceTraceOutcomeSchema, runManagedResourceConformance, } from './testing/managed-resource-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';

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,7 +1,7 @@
 import {
   AgentMessageSchema,
   AgentRunSchema
-} from "./index-sbkyvacf.js";
+} from "./index-fhsmrzj7.js";
 import {
   createApplication
 } from "./index-eabpd4tb.js";
@@ -141,8 +141,33 @@ function requireOutcome(actual, expected) {
   }
 }
 async function runAgentStoreConformance(config) {
-  const store = await config.createStore();
-  const conversationId = `conformance-${crypto.randomUUID()}`;
+  const run = `conformance-${crypto.randomUUID()}`;
+  const context = {
+    conversationIds: [run, `${run}-recovery`, `${run}-absorb`]
+  };
+  const store = await config.createStore(context);
+  let failure;
+  try {
+    await conformanceScenario(store, context.conversationIds);
+  } catch (error) {
+    failure = error;
+  }
+  try {
+    await config.cleanup?.(context);
+  } catch (cleanupError) {
+    if (failure === undefined)
+      throw cleanupError;
+    throw new AggregateError([failure, cleanupError], `${failure instanceof Error ? failure.message : String(failure)} (cleanup also failed: ${cleanupError instanceof Error ? cleanupError.message : String(cleanupError)})`);
+  }
+  if (failure !== undefined)
+    throw failure;
+}
+async function conformanceScenario(store, conversationIds) {
+  const [conversationId, recoveryConversationId, absorbConversationId] = conversationIds;
+  if (!conversationId || !recoveryConversationId || !absorbConversationId) {
+    throw new Error("Agent store conformance requires three conversation identities");
+  }
+  const absentConversationId = `${conversationId}-absent`;
   const firstInput = userMessage(conversationId, "input-1");
   const firstRun = queuedRun(conversationId, firstInput.id, "run-1");
   const accepted = await store.acceptInputAndAssignRun({
@@ -352,6 +377,50 @@ async function runAgentStoreConformance(config) {
   if (foreignOwner.outcome !== "conflict") {
     throw new Error("A checkpoint from another owner must conflict");
   }
+  const liveView = await store.loadRun({ conversationId, runId: running.id });
+  if (!liveView)
+    throw new Error("loadRun must find a run of this conversation");
+  if (liveView.run.id !== running.id || liveView.run.conversationId !== conversationId) {
+    throw new Error("loadRun returned a run it was not asked for");
+  }
+  if (liveView.run.revision !== checkpointedRun.revision) {
+    throw new Error("loadRun must return the run as the last mutation left it");
+  }
+  if (liveView.run.usage?.cost?.value !== 0.25) {
+    throw new Error("loadRun must carry the figure the run has spent so far");
+  }
+  if (liveView.snapshotVersion !== checkpoint.snapshot.version) {
+    throw new Error("loadRun must report the conversation version it read at");
+  }
+  if (liveView.assistant !== undefined) {
+    throw new Error("loadRun must not report a terminal answer for a live run");
+  }
+  if (await store.loadRun({ conversationId, runId: "no-such-run" })) {
+    throw new Error("loadRun must return undefined for an unknown run");
+  }
+  if (await store.loadRun({ conversationId: absentConversationId, runId: running.id })) {
+    throw new Error("loadRun must not cross conversation boundaries");
+  }
+  const activeRuns = await store.listActiveRuns(conversationId);
+  if (!activeRuns.some((run) => run.id === running.id)) {
+    throw new Error("listActiveRuns must report a run that is in flight");
+  }
+  if (activeRuns.some((run) => run.terminalReason !== undefined)) {
+    throw new Error("listActiveRuns must not report a run that has ended");
+  }
+  for (let index = 1;index < activeRuns.length; index += 1) {
+    const previous = activeRuns[index - 1];
+    const current = activeRuns[index];
+    if (!previous || !current)
+      continue;
+    const ordered = previous.createdAt === current.createdAt ? previous.id.localeCompare(current.id) < 0 : previous.createdAt < current.createdAt;
+    if (!ordered) {
+      throw new Error("listActiveRuns must order by createdAt and then by id");
+    }
+  }
+  if ((await store.listActiveRuns(absentConversationId)).length !== 0) {
+    throw new Error("listActiveRuns must be empty for an unknown conversation");
+  }
   const recoverable = await store.scanRecoverable({ limit: 10 });
   if (!recoverable.items.some((item) => item.run.id === running.id)) {
     throw new Error("A running run must appear in a recoverable scan");
@@ -409,6 +478,16 @@ async function runAgentStoreConformance(config) {
   if (settledRun?.usage?.cost?.value !== 1.5) {
     throw new Error("Terminal commit did not persist the run usage it was given");
   }
+  const terminalView = await store.loadRun({ conversationId, runId: running.id });
+  if (terminalView?.run.terminalReason !== "success") {
+    throw new Error("loadRun must report the terminal reason a settled run ended with");
+  }
+  if (JSON.stringify(terminalView.assistant) !== JSON.stringify(terminalAssistant)) {
+    throw new Error("loadRun must retain the answer a settled run produced");
+  }
+  if ((await store.listActiveRuns(conversationId)).some((run) => run.id === running.id)) {
+    throw new Error("listActiveRuns must drop a run once it has ended");
+  }
   const compactedTerminal = await store.replaceCompactedRange({
     conversationId,
     expectedVersion: terminalApplied.snapshot.version,
@@ -434,7 +513,6 @@ async function runAgentStoreConformance(config) {
   if (duplicateTerminal.run.terminalReason !== "success" || JSON.stringify(duplicateTerminal.assistant) !== JSON.stringify(terminalAssistant)) {
     throw new Error("Compaction discarded the canonical duplicate terminal result");
   }
-  const recoveryConversationId = `${conversationId}-recovery`;
   const recoveryInput = userMessage(recoveryConversationId, "recovery-input");
   const recoveryRun = queuedRun(recoveryConversationId, recoveryInput.id, "recovery-run");
   const recoveryAccepted = await store.acceptInputAndAssignRun({
@@ -468,6 +546,99 @@ async function runAgentStoreConformance(config) {
   if (terminalRun?.state !== "abandoned" || terminalMessage?.status !== "failed") {
     throw new Error("Abandon recovery did not atomically terminalize its assistant record");
   }
+  await assertAbsorptionIsAtomic(store, absorbConversationId);
+}
+async function assertAbsorptionIsAtomic(store, conversationId) {
+  const leadInput = userMessage(conversationId, "absorb-input-1");
+  const leadRun = queuedRun(conversationId, leadInput.id, "absorb-run-1");
+  const lead = await store.acceptInputAndAssignRun({
+    idempotencyKey: "absorb-request-1",
+    input: leadInput,
+    run: leadRun
+  });
+  requireOutcome(lead, "applied");
+  const successorInput = userMessage(conversationId, "absorb-input-2");
+  const successorRun = queuedRun(conversationId, successorInput.id, "absorb-run-2");
+  const successor = await store.acceptInputAndAssignRun({
+    idempotencyKey: "absorb-request-2",
+    input: successorInput,
+    run: successorRun
+  });
+  requireOutcome(successor, "applied");
+  const acquired = await store.acquireRun({
+    conversationId,
+    runId: leadRun.id,
+    expectedRevision: 0,
+    ownerId: "absorb-owner"
+  });
+  requireOutcome(acquired, "applied");
+  const running = acquired.snapshot.runs.find((run) => run.id === leadRun.id);
+  if (!running)
+    throw new Error("Absorbing run disappeared after acquisition");
+  const answer = AgentMessageSchema.parse({
+    schemaVersion: 1,
+    id: running.assistantMessageId,
+    conversationId,
+    runId: running.id,
+    role: "assistant",
+    status: "completed",
+    parts: [{ type: "text", text: "answered both" }],
+    createdAt: "2026-08-26T00:00:00.000Z",
+    updatedAt: "2026-08-26T00:00:02.000Z"
+  });
+  await store.commitRunTerminal({
+    conversationId,
+    runId: running.id,
+    expectedRevision: running.revision,
+    ownerId: "absorb-owner",
+    assistant: AgentMessageSchema.parse({ ...answer, status: "interrupted" }),
+    reason: "interrupted",
+    absorb: [{ runId: successorRun.id, inputMessageIds: [successorInput.id] }]
+  }).then(() => {
+    throw new Error("A non-completing run absorbed a queued successor");
+  }, (error) => {
+    if (!(error instanceof TypeError))
+      throw error;
+  });
+  const committed = await store.commitRunTerminal({
+    conversationId,
+    runId: running.id,
+    expectedRevision: running.revision,
+    ownerId: "absorb-owner",
+    assistant: answer,
+    reason: "success",
+    absorb: [{ runId: successorRun.id, inputMessageIds: [successorInput.id] }]
+  });
+  requireOutcome(committed, "applied");
+  const absorbingView = await store.loadRun({ conversationId, runId: leadRun.id });
+  if (absorbingView?.run.inputMessageIds.join(",") !== "absorb-input-1,absorb-input-2") {
+    throw new Error("An absorbing run must record the inputs it answered");
+  }
+  const absorbedView = await store.loadRun({ conversationId, runId: successorRun.id });
+  if (absorbedView?.run.terminalReason !== "absorbed") {
+    throw new Error("An absorbed successor must be terminal in the same transaction");
+  }
+  if (absorbedView.run.absorbedIntoRunId !== leadRun.id) {
+    throw new Error("An absorbed run must name the run that answered its input");
+  }
+  if (absorbedView.assistant !== undefined) {
+    throw new Error("An absorbed run produced no answer and must retain none");
+  }
+  if ((await store.listActiveRuns(conversationId)).length !== 0) {
+    throw new Error("An absorbed successor must leave the active listing");
+  }
+  const retried = await store.acceptInputAndAssignRun({
+    idempotencyKey: "absorb-request-2",
+    input: userMessage(conversationId, "absorb-discarded"),
+    run: queuedRun(conversationId, "absorb-discarded", "absorb-discarded-run")
+  });
+  requireOutcome(retried, "duplicate");
+  if (retried.runId !== leadRun.id || retried.assistant?.id !== answer.id) {
+    throw new Error("A retried absorbed key must resolve to the run that answered it");
+  }
+  if (retried.inputMessageId !== successorInput.id) {
+    throw new Error("A retried absorbed key must still name its own input");
+  }
 }
 // src/testing/managed-resource-conformance-contract.ts
 import { z } from "zod";