stitchkit 0.88.0 → 0.90.0

package/dist/{index-0ydchz76.js → index-mnm4qp0p.js}

@@ -1,16 +1,16 @@
 import {
   collectTools,
   createToolRunner
-} from "./index-0vfdh685.js";
+} from "./index-8c3a7m4g.js";
 import {
   toolErrorFromResult
-} from "./index-wn9cb82y.js";
-import {
-  assertUniqueToolName
-} from "./index-r159gjwy.js";
+} from "./index-zyvby92n.js";
 import {
   AppError
 } from "./index-0w9abg87.js";
+import {
+  assertUniqueToolName
+} from "./index-r159gjwy.js";
 
 // src/tools/invoker.ts
 function createToolInvoker(services, config) {

package/dist/{index-1szetq6f.js → index-q3ve2d1k.js}

@@ -1,17 +1,19 @@
 import {
-  AgentToolError
-} from "./index-3xnq72rz.js";
+  AgentToolError,
+  resolveToolDurability
+} from "./index-7rkhw9ec.js";
 import {
   collectToolSurface
-} from "./index-rcgsnrr6.js";
+} from "./index-31jw8fjq.js";
 import {
   createToolRunner,
   formatToolError
-} from "./index-0vfdh685.js";
+} from "./index-8c3a7m4g.js";
 import {
   isToolExecutionControlError,
+  toolCauseFromResult,
   toolResultFromError
-} from "./index-wn9cb82y.js";
+} from "./index-zyvby92n.js";
 import {
   isRecord
 } from "./index-77fekveh.js";
@@ -20,6 +22,10 @@ import {
 import { jsonSchema, tool } from "ai";
 function mountAgent(services, config = {}) {
   const serviceList = Array.isArray(services) ? services : [services];
+  if (config.registry && config.runtimeTools) {
+    throw new Error("mountAgent accepts either runtimeTools or a registry, not both");
+  }
+  const runtimeTools = config.registry ? config.registry.tools : config.runtimeTools;
   const tools = {};
   const runTool = createToolRunner({
     source: "agent",
@@ -32,7 +38,7 @@ function mountAgent(services, config = {}) {
     onOutputStrip: config.onOutputStrip
   });
   for (const entry of collectToolSurface({
-    surface: { services: serviceList, runtimeTools: config.runtimeTools },
+    surface: { services: serviceList, runtimeTools },
     transport: "AGENT",
     extend: config.extend,
     flattenUnionInput: config.flattenUnionInput
@@ -43,7 +49,23 @@ function mountAgent(services, config = {}) {
     });
     const execute = async (rawArgs, options) => {
       const args = isRecord(rawArgs) ? rawArgs : {};
-      const result = await runTool(mountable, args, {
+      const durability = resolveToolDurability(options.context, options.toolCallId, options.abortSignal);
+      const executeTool = durability ? createToolRunner({
+        source: "agent",
+        extend: config.extend,
+        context: {
+          ...config.context,
+          step: durability.step,
+          sleep: durability.sleep,
+          waitFor: durability.waitFor
+        },
+        hooks: config.hooks,
+        lifecycle: config.lifecycle,
+        errorHint: config.errorHint,
+        coerceJsonArgs: config.coerceJsonArgs,
+        onOutputStrip: config.onOutputStrip
+      }) : runTool;
+      const result = await executeTool(mountable, args, {
         signal: options.abortSignal
       }).catch((err) => {
         if (isToolExecutionControlError(err))
@@ -52,7 +74,7 @@ function mountAgent(services, config = {}) {
       });
       if (result.ok)
         return result.data;
-      throw new AgentToolError(formatToolError(result, mountable.name, config.errorHint));
+      throw new AgentToolError(formatToolError(result, mountable.name, config.errorHint), toolCauseFromResult(result));
     };
     const presenter = entry.kind === "runtime" ? entry.definition.present?.agent : undefined;
     if (entry.kind === "runtime" && presenter) {

package/dist/{index-6krwcdcf.js → index-zwkgfq1s.js}

@@ -9,88 +9,6 @@ import {
   AgentUsageSchema
 } from "./index-gtj3zc53.js";
 
-// src/agent-runtime/history-chronology.ts
-function createToolChronology() {
-  return { calls: new Map, approvals: new Map, pending: 0, resultsStarted: false };
-}
-function advanceToolChronology(previous, parts) {
-  const calls = new Map(previous.calls);
-  const approvals = new Map(previous.approvals);
-  let { pending, resultsStarted } = previous;
-  for (const part of parts) {
-    if (part.type === "tool-call") {
-      if (calls.has(part.callId) || resultsStarted && pending > 0)
-        return;
-      if (pending === 0)
-        resultsStarted = false;
-      calls.set(part.callId, { toolName: part.toolName, phase: "called" });
-      pending += 1;
-    } else if (part.type === "tool-approval-request") {
-      const call = calls.get(part.callId);
-      if (call?.phase !== "called" || approvals.has(part.approvalId))
-        return;
-      approvals.set(part.approvalId, part.callId);
-      calls.set(part.callId, { ...call, phase: "requested" });
-    } else if (part.type === "tool-approval-response") {
-      const callId = approvals.get(part.approvalId);
-      const call = callId === undefined ? undefined : calls.get(callId);
-      if (callId === undefined || !call || call.phase !== "requested")
-        return;
-      calls.set(callId, { ...call, phase: part.approved ? "approved" : "denied" });
-    } else if (part.type === "tool-result") {
-      const call = calls.get(part.callId);
-      if (!call || call.toolName !== part.toolName || call.phase === "result" || call.phase === "requested" || call.phase === "denied" && part.outcome === "success")
-        return;
-      calls.set(part.callId, { ...call, phase: "result" });
-      pending -= 1;
-      resultsStarted = true;
-    }
-  }
-  return { calls, approvals, pending, resultsStarted };
-}
-function canProjectToolChronology(state) {
-  return [...state.calls.values()].every(({ phase }) => phase !== "called");
-}
-
-// src/agent-runtime/terminal-status.ts
-function isSpeakableAssistantStatus(status) {
-  return status === "completed" || status === "interrupted" || status === "committed";
-}
-function isAssistantHistoryEvidence(status, policy) {
-  return isSpeakableAssistantStatus(status) || status === "failed" && policy?.failedAssistant === "assistant-marked";
-}
-function isCompleteAgentHistoryTurn(messages, policy) {
-  if (messages[0]?.role !== "user")
-    return false;
-  let chronology = createToolChronology();
-  let assistantCount = 0;
-  for (const message of messages) {
-    if (message.role === "assistant") {
-      if (!isAssistantHistoryEvidence(message.status, policy))
-        return false;
-      assistantCount += 1;
-    }
-    const next = advanceToolChronology(chronology, message.parts);
-    if (!next)
-      return false;
-    chronology = next;
-  }
-  return assistantCount > 0 && chronology.pending === 0;
-}
-function assistantStatus(reason) {
-  if (reason === "success" || reason === "policy_stop" || reason === "provider_stop") {
-    return "completed";
-  }
-  if (reason === "superseded")
-    return "superseded";
-  if (reason === "absorbed")
-    return "superseded";
-  if (reason === "interrupted" || reason === "cancelled" || reason === "shutdown") {
-    return "interrupted";
-  }
-  return "failed";
-}
-
 // src/agent-runtime/store.ts
 import { z } from "zod";
 var AgentStoreConflictSchema = z.object({
@@ -186,6 +104,11 @@ var ReplaceCompactedRangeSchema = z.object({
   replacedMessageIds: z.array(AgentRecordIdSchema).min(1),
   summary: AgentMessageSchema
 });
+var SeedConversationInputSchema = z.object({
+  conversationId: AgentRecordIdSchema,
+  seedKey: z.string().min(1),
+  inputs: z.array(AgentMessageSchema).min(1)
+});
 var AgentRecoverableDescriptorSchema = z.object({
   conversationId: AgentRecordIdSchema,
   run: AgentRunSchema
@@ -216,7 +139,11 @@ var AgentStoreEventKindSchema = z2.enum([
   "child/state",
   "retry/scheduled",
   "retry/started",
-  "sandbox/probed"
+  "sandbox/probed",
+  "approval/response-rejected",
+  "durability/step",
+  "durability/park",
+  "durability/event"
 ]);
 var AgentStoreTransitionSchema = z2.discriminatedUnion("type", [
   z2.object({ type: z2.literal("accept"), input: AcceptInputAndAssignRunSchema }).strict(),
@@ -226,7 +153,8 @@ var AgentStoreTransitionSchema = z2.discriminatedUnion("type", [
   z2.object({ type: z2.literal("interrupt"), input: RequestRunInterruptSchema }).strict(),
   z2.object({ type: z2.literal("recover"), input: RecoverAgentRunSchema }).strict(),
   z2.object({ type: z2.literal("terminal"), input: CommitRunTerminalSchema }).strict(),
-  z2.object({ type: z2.literal("compact"), input: ReplaceCompactedRangeSchema }).strict()
+  z2.object({ type: z2.literal("compact"), input: ReplaceCompactedRangeSchema }).strict(),
+  z2.object({ type: z2.literal("seed"), input: SeedConversationInputSchema }).strict()
 ]);
 var AgentStoreEventEnvelopeSchema = z2.object({
   schemaVersion: z2.int().positive(),
@@ -332,4 +260,86 @@ function decodeAgentConversationArchive(bytes) {
   return archive;
 }
 
-export { createToolChronology, advanceToolChronology, canProjectToolChronology, isAssistantHistoryEvidence, isCompleteAgentHistoryTurn, assistantStatus, AgentStoreConflictSchema, AgentStoreNotFoundSchema, AgentStoreAppliedSchema, AgentStoreDuplicateSchema, AgentStoreMutationResultSchema, AgentRunViewSchema, AcceptInputAndAssignRunSchema, AcquireAgentRunSchema, CheckpointRunAssistantSchema, RecordRunOperationSchema, CommitRunTerminalSchema, RequestRunInterruptSchema, RecoverAgentRunSchema, ReplaceCompactedRangeSchema, AgentRecoverableDescriptorSchema, AgentRecoverablePageSchema, AgentStoreEventKindSchema, AgentStoreTransitionSchema, AgentStoreEventEnvelopeSchema, AppendAgentStoreEventSchema, ReadAgentStoreEventsSchema, AgentStoreEventPageSchema, decodeAgentStoreEvent, agentStoreEventDraft, canonicalAgentJson, AgentConversationArchiveSchema, encodeAgentConversationArchive, decodeAgentConversationArchive };
+// src/agent-runtime/history-chronology.ts
+function createToolChronology() {
+  return { calls: new Map, approvals: new Map, pending: 0, resultsStarted: false };
+}
+function advanceToolChronology(previous, parts) {
+  const calls = new Map(previous.calls);
+  const approvals = new Map(previous.approvals);
+  let { pending, resultsStarted } = previous;
+  for (const part of parts) {
+    if (part.type === "tool-call") {
+      if (calls.has(part.callId) || resultsStarted && pending > 0)
+        return;
+      if (pending === 0)
+        resultsStarted = false;
+      calls.set(part.callId, { toolName: part.toolName, phase: "called" });
+      pending += 1;
+    } else if (part.type === "tool-approval-request") {
+      const call = calls.get(part.callId);
+      if (call?.phase !== "called" || approvals.has(part.approvalId))
+        return;
+      approvals.set(part.approvalId, part.callId);
+      calls.set(part.callId, { ...call, phase: "requested" });
+    } else if (part.type === "tool-approval-response") {
+      const callId = approvals.get(part.approvalId);
+      const call = callId === undefined ? undefined : calls.get(callId);
+      if (callId === undefined || !call || call.phase !== "requested")
+        return;
+      calls.set(callId, { ...call, phase: part.approved ? "approved" : "denied" });
+    } else if (part.type === "tool-result") {
+      const call = calls.get(part.callId);
+      if (!call || call.toolName !== part.toolName || call.phase === "result" || call.phase === "requested" || call.phase === "denied" && part.outcome === "success")
+        return;
+      calls.set(part.callId, { ...call, phase: "result" });
+      pending -= 1;
+      resultsStarted = true;
+    }
+  }
+  return { calls, approvals, pending, resultsStarted };
+}
+function canProjectToolChronology(state) {
+  return [...state.calls.values()].every(({ phase }) => phase !== "called");
+}
+
+// src/agent-runtime/terminal-status.ts
+function isSpeakableAssistantStatus(status) {
+  return status === "completed" || status === "interrupted" || status === "committed";
+}
+function isAssistantHistoryEvidence(status, policy) {
+  return isSpeakableAssistantStatus(status) || status === "failed" && policy?.failedAssistant === "assistant-marked";
+}
+function isCompleteAgentHistoryTurn(messages, policy) {
+  if (messages[0]?.role !== "user")
+    return false;
+  let chronology = createToolChronology();
+  let assistantCount = 0;
+  for (const message of messages) {
+    if (message.role === "assistant") {
+      if (!isAssistantHistoryEvidence(message.status, policy))
+        return false;
+      assistantCount += 1;
+    }
+    const next = advanceToolChronology(chronology, message.parts);
+    if (!next)
+      return false;
+    chronology = next;
+  }
+  return assistantCount > 0 && chronology.pending === 0;
+}
+function assistantStatus(reason) {
+  if (reason === "success" || reason === "policy_stop" || reason === "provider_stop") {
+    return "completed";
+  }
+  if (reason === "superseded")
+    return "superseded";
+  if (reason === "absorbed")
+    return "superseded";
+  if (reason === "interrupted" || reason === "cancelled" || reason === "shutdown") {
+    return "interrupted";
+  }
+  return "failed";
+}
+
+export { AgentStoreConflictSchema, AgentStoreNotFoundSchema, AgentStoreAppliedSchema, AgentStoreDuplicateSchema, AgentStoreMutationResultSchema, AgentRunViewSchema, AcceptInputAndAssignRunSchema, AcquireAgentRunSchema, CheckpointRunAssistantSchema, RecordRunOperationSchema, CommitRunTerminalSchema, RequestRunInterruptSchema, RecoverAgentRunSchema, ReplaceCompactedRangeSchema, SeedConversationInputSchema, AgentRecoverableDescriptorSchema, AgentRecoverablePageSchema, AgentStoreEventKindSchema, AgentStoreTransitionSchema, AgentStoreEventEnvelopeSchema, AppendAgentStoreEventSchema, ReadAgentStoreEventsSchema, AgentStoreEventPageSchema, decodeAgentStoreEvent, agentStoreEventDraft, canonicalAgentJson, AgentConversationArchiveSchema, encodeAgentConversationArchive, decodeAgentConversationArchive, createToolChronology, advanceToolChronology, canProjectToolChronology, isAssistantHistoryEvidence, isCompleteAgentHistoryTurn, assistantStatus };

package/dist/{index-wn9cb82y.js → index-zyvby92n.js}

@@ -2,12 +2,6 @@ import {
   getRequestContext,
   runWithRequestContext
 } from "./index-vsbzgd7b.js";
-import {
-  objectShapeKeys
-} from "./index-r159gjwy.js";
-import {
-  coerceJsonArgs
-} from "./index-7zbps32p.js";
 import {
   formatZodError,
   normalizeError,
@@ -18,9 +12,15 @@ import {
   STITCH_ERROR_STATUS,
   isStitchErrorCode
 } from "./index-0w9abg87.js";
+import {
+  coerceJsonArgs
+} from "./index-7zbps32p.js";
 import {
   isUnsafeKey
 } from "./index-kzfs85xp.js";
+import {
+  objectShapeKeys
+} from "./index-r159gjwy.js";
 import {
   isRecord
 } from "./index-77fekveh.js";
@@ -46,18 +46,21 @@ function toolResultFromError(err) {
     details: appErr.details ?? { message: appErr.message },
     ...appErr.hint && { hint: appErr.hint }
   };
-  normalizedToolErrors.set(result, appErr);
+  normalizedToolErrors.set(result, { normalized: appErr, cause: err });
   return result;
 }
 function toolErrorFromResult(result) {
   const retained = normalizedToolErrors.get(result);
   if (retained)
-    return retained;
+    return retained.normalized;
   const details = isRecord(result.details) ? result.details : undefined;
   const message = typeof details?.message === "string" ? details.message : result.code;
   const status = isStitchErrorCode(result.code) ? STITCH_ERROR_STATUS[result.code] : 500;
   return new AppError(result.code, message, status, details, result.hint);
 }
+function toolCauseFromResult(result) {
+  return normalizedToolErrors.get(result)?.cause;
+}
 async function executeToolMethod(method, toolName, rawArgs, context, hooks, lifecycle, coerceJson = false, onOutputStrip, extension, finalizeOutput) {
   return inToolCallContext({ source: context.source, toolName, method }, () => runToolMethod(method, toolName, rawArgs, context, hooks, lifecycle, coerceJson, onOutputStrip, extension, finalizeOutput));
 }
@@ -258,4 +261,4 @@ async function runToolMethod(method, toolName, rawArgs, context, hooks, lifecycl
   }
 }
 
-export { ToolExecutionControlError, isToolExecutionControlError, toolResultFromError, toolErrorFromResult, executeToolMethod };
+export { ToolExecutionControlError, isToolExecutionControlError, toolResultFromError, toolErrorFromResult, toolCauseFromResult, executeToolMethod };

package/dist/index.js

@@ -6,6 +6,16 @@ import {
   createBackoff,
   resumableIterator
 } from "./index-s8cnx02s.js";
+import {
+  contractEndpointMatchers,
+  createClient,
+  createClients,
+  createScopedClients,
+  createScopedUrlBuilders,
+  createUrlBuilder,
+  createUrlBuilders,
+  parseNDJSON
+} from "./index-27gm3d6g.js";
 import {
   REALTIME_REJECTION_KEY,
   asRealtimeRejection,
@@ -22,6 +32,9 @@ import {
   RealtimeRequestRejectedError,
   RealtimeRequestTimeoutError
 } from "./index-2qzskm8h.js";
+import {
+  parseSSE
+} from "./index-qmgs7y68.js";
 import {
   LiveStateControllerStatusSchema,
   LiveStatePhaseSchema,
@@ -29,19 +42,6 @@ import {
   createLiveStateController
 } from "./index-ywd0y6m1.js";
 import"./index-7gnkny4z.js";
-import {
-  contractEndpointMatchers,
-  createClient,
-  createClients,
-  createScopedClients,
-  createScopedUrlBuilders,
-  createUrlBuilder,
-  createUrlBuilders,
-  parseNDJSON
-} from "./index-27gm3d6g.js";
-import {
-  parseSSE
-} from "./index-qmgs7y68.js";
 import {
   ApiError,
   createHttpClient

package/dist/live/watch-client.d.ts

@@ -44,7 +44,7 @@
  * sense a rendering component can use.
  */
 import type { ContractDef, EndpointDef } from '../contract/define.js';
-import { WATCH_CLOSE, WATCH_OPEN, WATCH_STATE, WATCH_VALUE, type WatchKey, type WatchStateFrame, type WatchValueFrame } from './watch-contract.js';
+import { WATCH_CLOSE, WATCH_OPEN, WATCH_STATE, WATCH_VALUE, type WatchHave, type WatchKey, type WatchStateFrame, type WatchValueFrame } from './watch-contract.js';
 export interface WatchListeners<TValue> {
     value(value: TValue): void;
     /** Phase and, when unhealthy, the read's own code and message. */
@@ -107,6 +107,7 @@ export interface WatchTransport {
     request(event: typeof WATCH_OPEN, payload: {
         key: WatchKey;
         args: unknown;
+        have?: WatchHave;
     }, options: {
         timeoutMs: number;
     }): Promise<{

package/dist/live/watch-client.d.ts.map

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

package/dist/live/watch-contract.d.ts

@@ -26,6 +26,20 @@ export declare const WatchKeySchema: z.ZodReadonly<z.ZodObject<{
     digest: z.ZodString;
 }, z.core.$strict>>;
 export type WatchKey = z.infer<typeof WatchKeySchema>;
+/**
+ * What a subscriber already holds, offered when it opens a key.
+ *
+ * Both halves are needed and neither is redundant. The revision says *which*
+ * answer it has; the fingerprint proves it is that answer and not a different
+ * one wearing the same number — revisions restart at zero when a hub restarts or
+ * a key is released and re-acquired, so a bare revision would let a client keep
+ * a value from a previous life of the source and be told it was current.
+ */
+export declare const WatchHaveSchema: z.ZodReadonly<z.ZodObject<{
+    revision: z.ZodNumber;
+    fingerprint: z.ZodString;
+}, z.core.$strict>>;
+export type WatchHave = z.infer<typeof WatchHaveSchema>;
 export declare const WatchOpenSchema: z.ZodReadonly<z.ZodObject<{
     key: z.ZodReadonly<z.ZodObject<{
         service: z.ZodString;
@@ -33,20 +47,46 @@ export declare const WatchOpenSchema: z.ZodReadonly<z.ZodObject<{
         digest: z.ZodString;
     }, z.core.$strict>>;
     args: z.ZodUnknown;
+    have: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+        revision: z.ZodNumber;
+        fingerprint: z.ZodString;
+    }, z.core.$strict>>>;
 }, z.core.$strip>>;
 export declare const WatchAcceptedSchema: z.ZodReadonly<z.ZodObject<{
     accepted: z.ZodBoolean;
     reason: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>>;
-export declare const WatchValueSchema: z.ZodReadonly<z.ZodObject<{
+export declare const WatchValueSchema: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
     key: z.ZodReadonly<z.ZodObject<{
         service: z.ZodString;
         action: z.ZodString;
         digest: z.ZodString;
     }, z.core.$strict>>;
     revision: z.ZodNumber;
+    fingerprint: z.ZodString;
+    kind: z.ZodLiteral<"full">;
     value: z.ZodUnknown;
-}, z.core.$strip>>;
+}, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
+    key: z.ZodReadonly<z.ZodObject<{
+        service: z.ZodString;
+        action: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>>;
+    revision: z.ZodNumber;
+    fingerprint: z.ZodString;
+    kind: z.ZodLiteral<"delta">;
+    base: z.ZodNumber;
+    delta: z.ZodType<import("./watch-delta.js").WatchDelta, unknown, z.core.$ZodTypeInternals<import("./watch-delta.js").WatchDelta, unknown>>;
+}, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
+    key: z.ZodReadonly<z.ZodObject<{
+        service: z.ZodString;
+        action: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>>;
+    revision: z.ZodNumber;
+    fingerprint: z.ZodString;
+    kind: z.ZodLiteral<"unchanged">;
+}, z.core.$strip>>], "kind">;
 export declare const WatchStateSchema: z.ZodReadonly<z.ZodObject<{
     key: z.ZodReadonly<z.ZodObject<{
         service: z.ZodString;
@@ -88,15 +128,37 @@ export declare const WATCH_STATE = "stitchkit.watch.state";
 export declare const watchContract: {
     readonly serverToClient: {
         readonly "stitchkit.watch.value": {
-            readonly args: z.ZodTuple<[z.ZodReadonly<z.ZodObject<{
+            readonly args: z.ZodTuple<[z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
                 key: z.ZodReadonly<z.ZodObject<{
                     service: z.ZodString;
                     action: z.ZodString;
                     digest: z.ZodString;
                 }, z.core.$strict>>;
                 revision: z.ZodNumber;
+                fingerprint: z.ZodString;
+                kind: z.ZodLiteral<"full">;
                 value: z.ZodUnknown;
-            }, z.core.$strip>>], null>;
+            }, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
+                key: z.ZodReadonly<z.ZodObject<{
+                    service: z.ZodString;
+                    action: z.ZodString;
+                    digest: z.ZodString;
+                }, z.core.$strict>>;
+                revision: z.ZodNumber;
+                fingerprint: z.ZodString;
+                kind: z.ZodLiteral<"delta">;
+                base: z.ZodNumber;
+                delta: z.ZodType<import("./watch-delta.js").WatchDelta, unknown, z.core.$ZodTypeInternals<import("./watch-delta.js").WatchDelta, unknown>>;
+            }, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
+                key: z.ZodReadonly<z.ZodObject<{
+                    service: z.ZodString;
+                    action: z.ZodString;
+                    digest: z.ZodString;
+                }, z.core.$strict>>;
+                revision: z.ZodNumber;
+                fingerprint: z.ZodString;
+                kind: z.ZodLiteral<"unchanged">;
+            }, z.core.$strip>>], "kind">], null>;
         };
         readonly "stitchkit.watch.state": {
             readonly args: z.ZodTuple<[z.ZodReadonly<z.ZodObject<{
@@ -135,6 +197,10 @@ export declare const watchContract: {
                     digest: z.ZodString;
                 }, z.core.$strict>>;
                 args: z.ZodUnknown;
+                have: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+                    revision: z.ZodNumber;
+                    fingerprint: z.ZodString;
+                }, z.core.$strict>>>;
             }, z.core.$strip>>], null>;
             readonly ack: z.ZodReadonly<z.ZodObject<{
                 accepted: z.ZodBoolean;

package/dist/live/watch-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watch-contract.d.ts","sourceRoot":"","sources":["../../src/live/watch-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,2FAA2F;AAC3F,eAAO,MAAM,cAAc;;;;mBAkBd,CAAC;AACd,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,eAAe;;;;;;;kBAAkE,CAAC;AAE/F,eAAO,MAAM,mBAAmB;;;mBAOnB,CAAC;AAEd,eAAO,MAAM,gBAAgB;;;;;;;;kBAUhB,CAAC;AAEd,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;kBAShB,CAAC;AAEd,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC/D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D,eAAO,MAAM,UAAU,yBAAyB,CAAC;AACjD,eAAO,MAAM,WAAW,0BAA0B,CAAC;AACnD,eAAO,MAAM,WAAW,0BAA0B,CAAC;AACnD,eAAO,MAAM,WAAW,0BAA0B,CAAC;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;;;qBAEL,IAAI;;;;;;;;;;;qBACJ,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAGL,IAAI;;;;;;;;qBAA8B,GAAG;;;;;;qBACpC,IAAI;;;;;;;;;CAKxB,CAAC;AAEF,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAEpD"}
+{"version":3,"file":"watch-contract.d.ts","sourceRoot":"","sources":["../../src/live/watch-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,2FAA2F;AAC3F,eAAO,MAAM,cAAc;;;;mBAkBd,CAAC;AACd,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe;;;mBAGf,CAAC;AACd,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,eAAe;;;;;;;;;;;kBAEf,CAAC;AAEd,eAAO,MAAM,mBAAmB;;;mBAOnB,CAAC;AA6Bd,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAmB3B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;kBAShB,CAAC;AAEd,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC/D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D,eAAO,MAAM,UAAU,yBAAyB,CAAC;AACjD,eAAO,MAAM,WAAW,0BAA0B,CAAC;AACnD,eAAO,MAAM,WAAW,0BAA0B,CAAC;AACnD,eAAO,MAAM,WAAW,0BAA0B,CAAC;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;;;qBAEL,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBACJ,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAGL,IAAI;;;;;;;;;;;;qBAA8B,GAAG;;;;;;qBACpC,IAAI;;;;;;;;;CAKxB,CAAC;AAEF,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAEpD"}