stitchkit 0.59.4 → 0.60.0

package/dist/agent-runtime.js

@@ -1,7 +1,7 @@
 import {
   ToolExecutionControlError,
   isToolExecutionControlError
-} from "./index-sa2mbwa7.js";
+} from "./index-2akar0rq.js";
 import {
   AgentAssistantPlaceholderSchema,
   AgentControlPartSchema,
@@ -34,14 +34,14 @@ import"./index-6djpbnda.js";
 import"./index-cby4ar3v.js";
 import {
   createBoundedSinkManager
-} from "./index-0nc0cddp.js";
-import"./index-7c0gkyvj.js";
-import"./index-ps5pxp3h.js";
+} from "./index-a59da114.js";
+import"./index-6fbp58g8.js";
+import"./index-v6e8hnkx.js";
 import"./index-6k1937bx.js";
 import {
   childSpan,
   createTraceContext
-} from "./index-y2rb7dwx.js";
+} from "./index-pzyt11ch.js";
 import"./index-smpbdg6k.js";
 
 // src/agent-runtime/compaction.ts
@@ -243,21 +243,31 @@ function createAgentSessionCoordinator() {
       }
       const active = [...lanes.values()].map((lane) => lane.active).filter((run) => run !== undefined);
       const settlements = active.map((run) => run.settled);
+      const outstanding = new Set(settlements);
+      for (const settled of settlements) {
+        settled.then(() => {
+          outstanding.delete(settled);
+        });
+      }
       const drain = Promise.all(settlements).then(() => {
         return;
       });
-      if (options.drainTimeoutMs !== undefined) {
-        const drained = await waitWithin(drain, options.drainTimeoutMs);
-        if (drained)
-          return;
+      const finished = () => ({
+        settled: outstanding.size === 0,
+        timedOut: outstanding.size > 0,
+        remaining: outstanding.size
+      });
+      if (options.gracePeriodMs !== undefined && await waitWithin(drain, options.gracePeriodMs)) {
+        return finished();
       }
       for (const run of active)
         run.controller.abort("shutdown");
-      if (options.drainTimeoutMs === undefined)
-        return drain;
-      if (options.forceTimeoutMs === undefined)
-        return;
+      if (options.forceTimeoutMs === undefined) {
+        await drain;
+        return finished();
+      }
       await waitWithin(drain, options.forceTimeoutMs);
+      return finished();
     },
     isRunning(key) {
       return lanes.get(key)?.active !== undefined;
@@ -431,12 +441,16 @@ async function userMessage(message, options) {
       });
       continue;
     }
-    const fallback = options.unresolvedFile ?? "text";
+    const fallback = options.unresolvedFile ?? "omit";
     if (fallback === "error") {
       throw new Error(`No history file resolver configured for ${part.reference}`);
     }
     if (fallback === "text") {
-      content.push({ type: "text", text: `[attachment: ${part.reference}]` });
+      const described = part.filename ?? part.mediaType;
+      content.push({
+        type: "text",
+        text: described ? `[attachment: ${described}]` : "[attachment]"
+      });
     }
   }
   if (content.length === 0)
@@ -693,7 +707,18 @@ function createAgentObservability(config) {
     ...config.onSinkError && { onSinkError: config.onSinkError },
     ...config.onDrop && { onDrop: config.onDrop }
   });
+  const DEDUPLICATION_WINDOW = 1e4;
   const emitted = new Set;
+  const ring = new Array(DEDUPLICATION_WINDOW).fill(undefined);
+  let cursor = 0;
+  const remember = (eventId) => {
+    emitted.add(eventId);
+    const evicted = ring[cursor];
+    ring[cursor] = eventId;
+    cursor = (cursor + 1) % DEDUPLICATION_WINDOW;
+    if (evicted !== undefined)
+      emitted.delete(evicted);
+  };
   return {
     rootTrace(parent) {
       const trace = parent ? childSpan(parent) : createTraceContext();
@@ -703,7 +728,7 @@ function createAgentObservability(config) {
       const parsed = AgentRunEventSchema.parse(rawEvent);
       if ((config.deduplicate ?? true) && emitted.has(parsed.eventId))
         return;
-      emitted.add(parsed.eventId);
+      remember(parsed.eventId);
       manager.submit(() => config.includeInternalCause ? parsed : AgentRunEventSchema.omit({ internalCause: true }).parse(parsed));
     },
     flush: () => manager.flush(),
@@ -893,13 +918,74 @@ function defineAgentProtocol(config) {
     parsePart: (input) => AgentMessageSchema.shape.parts.element.parse(input)
   };
 }
-// src/agent-runtime/runtime.ts
-import {
-  stepCountIs,
-  streamText
-} from "ai";
+// src/agent-runtime/admission-lanes.ts
+function createRuntimeAdmissionLanes() {
+  const lanes = new Map;
+  const admit = (runId) => {
+    const admission = { runId, completion: Promise.withResolvers() };
+    admission.completion.promise.catch(() => {
+      return;
+    });
+    return admission;
+  };
+  return {
+    reserve(key, runId) {
+      const existing = lanes.get(key);
+      const lane = existing ?? { acceptanceTail: Promise.resolve() };
+      if (!existing)
+        lanes.set(key, lane);
+      if (!lane.head) {
+        lane.head = admit(runId);
+        return { lane, admission: lane.head, shouldSchedule: true };
+      }
+      if (!lane.pending) {
+        lane.pending = admit(runId);
+        return { lane, admission: lane.pending, shouldSchedule: true };
+      }
+      return { lane, admission: lane.pending, shouldSchedule: false };
+    },
+    settle(key, admission) {
+      const lane = lanes.get(key);
+      if (!lane)
+        return;
+      if (lane.head?.runId === admission.runId) {
+        lane.head = lane.pending;
+        lane.pending = undefined;
+      } else if (lane.pending?.runId === admission.runId) {
+        lane.pending = undefined;
+      }
+      if (!lane.head && !lane.pending)
+        lanes.delete(key);
+    },
+    async waitForAcceptances(lane) {
+      while (true) {
+        const tail = lane.acceptanceTail;
+        await tail.catch(() => {
+          return;
+        });
+        if (tail === lane.acceptanceTail)
+          return;
+      }
+    }
+  };
+}
+
+// src/agent-runtime/run-execution.ts
+import { stepCountIs, streamText } from "ai";
+
+// src/agent-runtime/runtime-internals.ts
 import { z as z5 } from "zod";
 
+// src/agent-runtime/terminal-status.ts
+function assistantStatus(reason) {
+  if (reason === "success" || reason === "policy_stop")
+    return "completed";
+  if (reason === "interrupted" || reason === "cancelled" || reason === "shutdown") {
+    return "interrupted";
+  }
+  return "failed";
+}
+
 // src/agent-runtime/terminal-commit.ts
 class AgentRuntimeConflictError extends Error {
   constructor(operation) {
@@ -912,20 +998,12 @@ function appliedSnapshot(result, operation) {
     return result.snapshot;
   throw new AgentRuntimeConflictError(operation);
 }
-function terminalMessageStatus(reason) {
-  if (reason === "success" || reason === "policy_stop")
-    return "completed";
-  if (reason === "interrupted" || reason === "cancelled" || reason === "shutdown") {
-    return "interrupted";
-  }
-  return "failed";
-}
 function canonicalTerminal(snapshot, runId, retainedAssistant) {
   const run = snapshot.runs.find((candidate) => candidate.id === runId);
   if (!run?.terminalReason)
     return;
   const assistant = snapshot.messages.find((message) => message.id === run.assistantMessageId) ?? retainedAssistant;
-  if (snapshot.conversationId !== run.conversationId || !assistant || assistant.id !== run.assistantMessageId || assistant.conversationId !== run.conversationId || assistant.runId !== run.id || assistant.role !== "assistant" || assistant.status !== terminalMessageStatus(run.terminalReason)) {
+  if (snapshot.conversationId !== run.conversationId || !assistant || assistant.id !== run.assistantMessageId || assistant.conversationId !== run.conversationId || assistant.runId !== run.id || assistant.role !== "assistant" || assistant.status !== assistantStatus(run.terminalReason)) {
     throw new AgentRuntimeConflictError("terminal result projection");
   }
   return {
@@ -999,7 +1077,7 @@ async function commitAgentRunTerminal(input) {
   }
 }
 
-// src/agent-runtime/runtime.ts
+// src/agent-runtime/runtime-internals.ts
 function findRun(runs, runId) {
   const run = runs.find((candidate) => candidate.id === runId);
   if (!run)
@@ -1025,14 +1103,6 @@ function appendText(parts, text) {
   }
   parts.push(AgentMessagePartSchema.parse({ type: "text", text }));
 }
-function assistantStatus(reason) {
-  if (reason === "success" || reason === "policy_stop")
-    return "completed";
-  if (reason === "interrupted" || reason === "cancelled" || reason === "shutdown") {
-    return "interrupted";
-  }
-  return "failed";
-}
 function abortTerminalReason(signal) {
   if (signal.reason === "shutdown")
     return "shutdown";
@@ -1074,88 +1144,20 @@ function createIdleDeadline(parent, timeoutMs) {
     }
   };
 }
-function createAgentRuntime(config) {
-  const coordinator = createAgentSessionCoordinator();
-  const tickets = new Map;
-  const generateId = config.generateId ?? (() => crypto.randomUUID());
-  const now = config.now ?? (() => new Date);
-  const runtimeEpoch = generateId();
-  const admissionLanes = new Map;
-  const reserveAdmission = (key, runId) => {
-    const existing = admissionLanes.get(key);
-    const lane = existing ?? { acceptanceTail: Promise.resolve() };
-    if (!existing)
-      admissionLanes.set(key, lane);
-    if (!lane.head) {
-      const admission = { runId, completion: Promise.withResolvers() };
-      admission.completion.promise.catch(() => {
-        return;
-      });
-      lane.head = admission;
-      return { lane, admission, shouldSchedule: true };
-    }
-    if (!lane.pending) {
-      const admission = { runId, completion: Promise.withResolvers() };
-      admission.completion.promise.catch(() => {
-        return;
-      });
-      lane.pending = admission;
-      return { lane, admission, shouldSchedule: true };
-    }
-    return { lane, admission: lane.pending, shouldSchedule: false };
-  };
-  const settleAdmission = (key, admission) => {
-    const lane = admissionLanes.get(key);
-    if (!lane)
-      return;
-    if (lane.head?.runId === admission.runId) {
-      lane.head = lane.pending;
-      lane.pending = undefined;
-    } else if (lane.pending?.runId === admission.runId) {
-      lane.pending = undefined;
-    }
-    if (!lane.head && !lane.pending)
-      admissionLanes.delete(key);
-  };
-  const waitForAdmissionAcceptances = async (lane) => {
-    while (true) {
-      const tail = lane.acceptanceTail;
-      await tail.catch(() => {
-        return;
-      });
-      if (tail === lane.acceptanceTail)
-        return;
-    }
-  };
-  const checkpointEveryEvents = config.loop?.checkpointEveryEvents ?? 20;
-  const maxSteps = config.loop?.maxSteps ?? 50;
-  const idleTimeoutMs = config.loop?.idleTimeoutMs;
-  if (!Number.isSafeInteger(checkpointEveryEvents) || checkpointEveryEvents < 1) {
-    throw new TypeError("checkpointEveryEvents must be a positive safe integer");
-  }
-  if (!Number.isSafeInteger(maxSteps) || maxSteps < 1) {
-    throw new TypeError("maxSteps must be a positive safe integer");
-  }
-  if (idleTimeoutMs !== undefined && (!Number.isSafeInteger(idleTimeoutMs) || idleTimeoutMs < 1)) {
-    throw new TypeError("idleTimeoutMs must be a positive safe integer");
-  }
-  const policyNames = new Set(["max-steps"]);
-  for (const policy of config.loop?.stopPolicies ?? []) {
-    if (!policy.name || policyNames.has(policy.name)) {
-      throw new TypeError("Agent stop policy names must be non-empty and unique");
-    }
-    policyNames.add(policy.name);
-  }
-  const publish = async (event) => {
-    try {
-      await config.publish?.(event);
-    } catch (error) {
-      try {
-        await config.onPublishError?.({ event, error });
-      } catch {}
-    }
-  };
-  const executeRun = async (input) => {
+
+// src/agent-runtime/run-execution.ts
+function createRunExecutor(dependencies) {
+  const {
+    config,
+    publish,
+    runtimeEpoch,
+    generateId,
+    now,
+    checkpointEveryEvents,
+    maxSteps,
+    idleTimeoutMs
+  } = dependencies;
+  return async function executeRun(input) {
     const queuedSnapshot = await config.store.loadSnapshot(input.acceptedRun.conversationId);
     const queuedRun = findRun(queuedSnapshot.runs, input.acceptedRun.id);
     const acquired = appliedSnapshot(await config.store.acquireRun({
@@ -1699,7 +1701,74 @@ function createAgentRuntime(config) {
       ...terminalPolicyName && { policyName: terminalPolicyName }
     };
   };
+}
+
+// src/agent-runtime/runtime.ts
+function createAgentRuntime(config) {
+  const coordinator = createAgentSessionCoordinator();
+  const tickets = new Map;
+  const generateId = config.generateId ?? (() => crypto.randomUUID());
+  const now = config.now ?? (() => new Date);
+  const runtimeEpoch = generateId();
+  const admissionLanes = createRuntimeAdmissionLanes();
+  const reserveAdmission = admissionLanes.reserve;
+  const settleAdmission = admissionLanes.settle;
+  const waitForAdmissionAcceptances = admissionLanes.waitForAcceptances;
+  const checkpointEveryEvents = config.loop?.checkpointEveryEvents ?? 20;
+  const maxSteps = config.loop?.maxSteps ?? 50;
+  const idleTimeoutMs = config.loop?.idleTimeoutMs;
+  if (!Number.isSafeInteger(checkpointEveryEvents) || checkpointEveryEvents < 1) {
+    throw new TypeError("checkpointEveryEvents must be a positive safe integer");
+  }
+  if (!Number.isSafeInteger(maxSteps) || maxSteps < 1) {
+    throw new TypeError("maxSteps must be a positive safe integer");
+  }
+  if (idleTimeoutMs !== undefined && (!Number.isSafeInteger(idleTimeoutMs) || idleTimeoutMs < 1)) {
+    throw new TypeError("idleTimeoutMs must be a positive safe integer");
+  }
+  const policyNames = new Set(["max-steps"]);
+  for (const policy of config.loop?.stopPolicies ?? []) {
+    if (!policy.name || policyNames.has(policy.name)) {
+      throw new TypeError("Agent stop policy names must be non-empty and unique");
+    }
+    policyNames.add(policy.name);
+  }
+  const publish = async (event) => {
+    try {
+      await config.publish?.(event);
+    } catch (error) {
+      try {
+        await config.onPublishError?.({ event, error });
+      } catch {}
+    }
+  };
+  const executeRun = createRunExecutor({
+    config,
+    publish,
+    runtimeEpoch,
+    generateId,
+    now,
+    checkpointEveryEvents,
+    maxSteps,
+    ...idleTimeoutMs !== undefined && { idleTimeoutMs }
+  });
+  let admissionClosed = false;
+  const closedError = () => new Error("[stitchkit] agent runtime is closed and admits no further work");
+  const refuse = () => {
+    const error = closedError();
+    const accepted = Promise.reject(error);
+    const result = Promise.reject(error);
+    accepted.catch(() => {
+      return;
+    });
+    result.catch(() => {
+      return;
+    });
+    return { accepted, result };
+  };
   const resume = (rawInput) => {
+    if (admissionClosed)
+      return refuse();
     const context = config.protocol.parseContext(rawInput.context);
     const accepted = Promise.withResolvers();
     const result = Promise.withResolvers();
@@ -1729,6 +1798,14 @@ function createAgentRuntime(config) {
   };
   return {
     submit(rawInput) {
+      if (admissionClosed) {
+        const refused = refuse();
+        const admission = Promise.reject(closedError());
+        admission.catch(() => {
+          return;
+        });
+        return { ...refused, admission };
+      }
       const metadata = rawInput.metadata === undefined ? undefined : config.protocol.parseInputMetadata(rawInput.metadata);
       const input = {
         conversationId: rawInput.conversationId,
@@ -1810,6 +1887,8 @@ function createAgentRuntime(config) {
             context,
             conversationId: input.conversationId
           });
+          if (admissionClosed)
+            throw closedError();
           const acceptance = await config.store.acceptInputAndAssignRun({
             idempotencyKey: input.idempotencyKey,
             input: userMessage2,
@@ -1969,9 +2048,8 @@ function createAgentRuntime(config) {
       return requested;
     },
     async recover(options) {
-      if (!config.store.scanRecoverablePage) {
-        throw new Error("The configured agent store does not support bounded recovery scans");
-      }
+      if (admissionClosed)
+        throw closedError();
       const pageSize = options.pageSize ?? 100;
       const maxRuns = options.maxRuns ?? 1000;
       if (!Number.isSafeInteger(pageSize) || pageSize < 1 || pageSize > 1000) {
@@ -1982,8 +2060,8 @@ function createAgentRuntime(config) {
       }
       const outcomes = [];
       let cursor;
-      while (outcomes.length < maxRuns && !options.signal?.aborted) {
-        const page = await config.store.scanRecoverablePage({
+      while (outcomes.length < maxRuns && !options.signal?.aborted && !admissionClosed) {
+        const page = await config.store.scanRecoverable({
           ...cursor && { cursor },
           limit: Math.min(pageSize, maxRuns - outcomes.length)
         });
@@ -2072,7 +2150,10 @@ function createAgentRuntime(config) {
       return outcomes;
     },
     stop: (conversationKey, reason) => coordinator.stop(conversationKey, reason),
-    close: (options) => coordinator.close(options)
+    close: (options) => {
+      admissionClosed = true;
+      return coordinator.close(options);
+    }
   };
 }
 // src/agent-runtime/store.ts
@@ -2271,14 +2352,6 @@ function terminalState(reason) {
     return "abandoned";
   return "failed";
 }
-function terminalMessageStatus2(reason) {
-  if (reason === "success" || reason === "policy_stop")
-    return "completed";
-  if (reason === "interrupted" || reason === "cancelled" || reason === "shutdown") {
-    return "interrupted";
-  }
-  return "failed";
-}
 function applied(current, input, effects) {
   return {
     outcome: "applied",
@@ -2439,7 +2512,7 @@ function reduceStore(current, operation) {
   }
   if (operation.type === "terminal" && run) {
     const input = operation.input;
-    if (run.revision !== input.expectedRevision || run.state !== "running" && run.state !== "interrupt_requested" || run.ownerId !== input.ownerId || input.fencingToken !== undefined && run.fencingToken !== input.fencingToken || input.assistant.runId !== run.id || input.assistant.id !== run.assistantMessageId || input.assistant.conversationId !== run.conversationId || input.assistant.role !== "assistant" || input.assistant.status !== terminalMessageStatus2(input.reason)) {
+    if (run.revision !== input.expectedRevision || run.state !== "running" && run.state !== "interrupt_requested" || run.ownerId !== input.ownerId || input.fencingToken !== undefined && run.fencingToken !== input.fencingToken || input.assistant.runId !== run.id || input.assistant.id !== run.assistantMessageId || input.assistant.conversationId !== run.conversationId || input.assistant.role !== "assistant" || input.assistant.status !== assistantStatus(input.reason)) {
       return conflict(run.revision);
     }
     const next = AgentRunSchema.parse({
@@ -2645,26 +2718,7 @@ function createAgentRuntimeStore(driver) {
       type: "compact",
       input: ReplaceCompactedRangeSchema.parse(input)
     }),
-    async scanRecoverable() {
-      const snapshots = [];
-      const seenConversationIds = new Set;
-      let cursor;
-      do {
-        const page = AgentRecoverablePageSchema.parse(await driver.scanRecoverable({
-          ...cursor && { cursor },
-          limit: 100
-        }));
-        const conversationIds = [
-          ...new Set(page.items.map((item) => item.conversationId))
-        ].filter((conversationId) => !seenConversationIds.has(conversationId));
-        for (const conversationId of conversationIds)
-          seenConversationIds.add(conversationId);
-        snapshots.push(...await Promise.all(conversationIds.map(loadSnapshot)));
-        cursor = page.nextCursor;
-      } while (cursor !== undefined);
-      return snapshots;
-    },
-    async scanRecoverablePage(input) {
+    async scanRecoverable(input) {
       const parsed = AgentRecoverableScanInputSchema.parse(input);
       return AgentRecoverablePageSchema.parse(await driver.scanRecoverable(parsed));
     }
@@ -2863,6 +2917,7 @@ export {
   AgentRunSchema,
   AgentRunStateEventSchema,
   AgentRunStateSchema,
+  AgentRuntimeConflictError,
   AgentRuntimeEventCursorSchema,
   AgentRuntimeEventSchema,
   AgentRuntimeHeadSchema,

package/dist/application/activity.d.ts

@@ -37,7 +37,13 @@ export declare const ActivityLiveStateSchema: z.ZodEnum<{
     queued: "queued";
 }>;
 export type ActivityLiveState = z.infer<typeof ActivityLiveStateSchema>;
-declare const ActivityTokenBrand: unique symbol;
+/**
+ * Exported because `ActivityToken` is part of a public interface a consumer must
+ * be able to implement — a test double, a decorator. A brand nobody outside the
+ * module can spell makes `ActivityProjection` unimplementable, which is a
+ * stronger guarantee than intended.
+ */
+export declare const ActivityTokenBrand: unique symbol;
 export interface ActivityToken {
     readonly [ActivityTokenBrand]: true;
 }
@@ -66,5 +72,4 @@ export interface ActivityProjection<TStage extends string> {
     subscribe(listener: (snapshot: ActivitySnapshot) => void | Promise<void>): () => void;
 }
 export declare function createActivityProjection<const TStages extends readonly string[]>(config: ActivityProjectionConfig<TStages>): ActivityProjection<TStages[number]>;
-export {};
 //# sourceMappingURL=activity.d.ts.map

package/dist/application/activity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../src/application/activity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,gBAAgB,aAA6B,CAAC;AAC3D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,eAAO,MAAM,qBAAqB,aAA6B,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,2BAA2B;;;;;;mBAS3B,CAAC;AACd,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAYhF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;mBAWtB,CAAC;AACd,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,uBAAuB;;;EAA+B,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,QAAA,MAAM,kBAAkB,EAAE,OAAO,MAAiD,CAAC;AACnF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB,CAAC,MAAM,SAAS,MAAM;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;CACnC;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;CACrC;AAED,MAAM,WAAW,wBAAwB,CAAC,OAAO,SAAS,SAAS,MAAM,EAAE;IACzE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,iBAAiB,CAAC,CAAC,OAAO,EAAE,iCAAiC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtF;AAED,MAAM,WAAW,kBAAkB,CAAC,MAAM,SAAS,MAAM;IACvD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,iBAAiB,GAAG,aAAa,CAAC;IAC9D,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;IAClF,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;IACxC,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;IACpC,WAAW,IAAI,gBAAgB,CAAC;IAChC,iFAAiF;IACjF,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC;CACvF;AA8BD,wBAAgB,wBAAwB,CAAC,KAAK,CAAC,OAAO,SAAS,SAAS,MAAM,EAAE,EAC9E,MAAM,EAAE,wBAAwB,CAAC,OAAO,CAAC,GACxC,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAoHrC"}
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../src/application/activity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,gBAAgB,aAA6B,CAAC;AAC3D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,eAAO,MAAM,qBAAqB,aAA6B,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,2BAA2B;;;;;;mBAS3B,CAAC;AACd,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAYhF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;mBAWtB,CAAC;AACd,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,uBAAuB;;;EAA+B,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAAO,MAAiD,CAAC;AAC1F,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB,CAAC,MAAM,SAAS,MAAM;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;CACnC;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;CACrC;AAED,MAAM,WAAW,wBAAwB,CAAC,OAAO,SAAS,SAAS,MAAM,EAAE;IACzE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,iBAAiB,CAAC,CAAC,OAAO,EAAE,iCAAiC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtF;AAED,MAAM,WAAW,kBAAkB,CAAC,MAAM,SAAS,MAAM;IACvD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,iBAAiB,GAAG,aAAa,CAAC;IAC9D,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;IAClF,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;IACxC,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;IACpC,WAAW,IAAI,gBAAgB,CAAC;IAChC,iFAAiF;IACjF,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC;CACvF;AA8BD,wBAAgB,wBAAwB,CAAC,KAAK,CAAC,OAAO,SAAS,SAAS,MAAM,EAAE,EAC9E,MAAM,EAAE,wBAAwB,CAAC,OAAO,CAAC,GACxC,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAoHrC"}

package/dist/application/grammy.d.ts

@@ -23,6 +23,12 @@ export interface GrammyWebhookResource<C extends Context> {
     readonly resource: ManagedResource;
     handleUpdate(update: GrammyUpdate<C>, webhookReplyEnvelope?: WebhookReplyEnvelope): Promise<void>;
 }
+/**
+ * Deliberately NOT in `STITCH_ERROR_STATUS`: that registry is the generic core's
+ * (→ ADR 0002), and a provider name has no place in a union every consumer
+ * imports. This code travels as itself through a partial `codeMap`, exactly the
+ * way a code the project threw does.
+ */
 export declare class GrammyWebhookUnavailableError extends Error {
     readonly code = "GRAMMY_WEBHOOK_NOT_ACCEPTING";
     constructor();

package/dist/application/grammy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grammy.d.ts","sourceRoot":"","sources":["../../src/application/grammy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC3F,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAMzE,MAAM,WAAW,2BAA2B,CAAC,CAAC,SAAS,OAAO;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAcD,iEAAiE;AACjE,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,OAAO,EACrD,MAAM,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACrC,eAAe,CAiEjB;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9F,MAAM,WAAW,2BAA2B,CAAC,CAAC,SAAS,OAAO;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,OAAO;IACtD,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,YAAY,CACV,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,oBAAoB,CAAC,EAAE,oBAAoB,GAC1C,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,QAAQ,CAAC,IAAI,kCAAkC;IAE/C,cAGC;CACF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,OAAO,EAC3D,MAAM,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACrC,qBAAqB,CAAC,CAAC,CAAC,CAiE1B"}
+{"version":3,"file":"grammy.d.ts","sourceRoot":"","sources":["../../src/application/grammy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC3F,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAMzE,MAAM,WAAW,2BAA2B,CAAC,CAAC,SAAS,OAAO;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAcD,iEAAiE;AACjE,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,OAAO,EACrD,MAAM,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACrC,eAAe,CAiEjB;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9F,MAAM,WAAW,2BAA2B,CAAC,CAAC,SAAS,OAAO;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,OAAO;IACtD,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,YAAY,CACV,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,oBAAoB,CAAC,EAAE,oBAAoB,GAC1C,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED;;;;;GAKG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,QAAQ,CAAC,IAAI,kCAAkC;IAE/C,cAGC;CACF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,OAAO,EAC3D,MAAM,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACrC,qBAAqB,CAAC,CAAC,CAAC,CAiE1B"}

package/dist/application/health.d.ts

@@ -13,12 +13,19 @@ export declare const ApplicationOperationalHandlersOptionsSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type ApplicationOperationalHandlersOptions = z.input<typeof ApplicationOperationalHandlersOptionsSchema>;
 export interface ApplicationOperationalHandlers {
-    /** Always-readable canonical application snapshot. */
+    /** Always-readable published projection of the application snapshot. */
     status(): Response;
     readiness(): Response;
     liveness(): Response;
 }
-/** Fetch-clean liveness/readiness response with only the sanitized application snapshot. */
+/**
+ * Fetch-clean liveness/readiness response carrying the published projection.
+ *
+ * Never the raw snapshot: it names every resource, its `dependsOn` edges, the
+ * process epoch and live admission counters, and these handlers are documented
+ * for public mounting. The full snapshot stays available in-process through
+ * `getSnapshot()`.
+ */
 export declare function createApplicationHealthHandler(application: Pick<ApplicationHandle, 'getSnapshot'>, options: ApplicationHealthHandlerOptions): () => Response;
 /** Compose the canonical status and probe handlers without introducing another state model. */
 export declare function createApplicationOperationalHandlers(application: Pick<ApplicationHandle, 'getSnapshot'>, options?: ApplicationOperationalHandlersOptions): ApplicationOperationalHandlers;

package/dist/application/health.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/application/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,eAAO,MAAM,qCAAqC;;;;;;iBAGhD,CAAC;AACH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,qCAAqC,CAC7C,CAAC;AAEF,eAAO,MAAM,2CAA2C;;iBAEtD,CAAC;AACH,MAAM,MAAM,qCAAqC,GAAG,CAAC,CAAC,KAAK,CACzD,OAAO,2CAA2C,CACnD,CAAC;AAEF,MAAM,WAAW,8BAA8B;IAC7C,sDAAsD;IACtD,MAAM,IAAI,QAAQ,CAAC;IACnB,SAAS,IAAI,QAAQ,CAAC;IACtB,QAAQ,IAAI,QAAQ,CAAC;CACtB;AAED,4FAA4F;AAC5F,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,EACnD,OAAO,EAAE,+BAA+B,GACvC,MAAM,QAAQ,CAahB;AAED,+FAA+F;AAC/F,wBAAgB,oCAAoC,CAClD,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,EACnD,OAAO,GAAE,qCAA0C,GAClD,8BAA8B,CAahC"}
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/application/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGlD,eAAO,MAAM,qCAAqC;;;;;;iBAGhD,CAAC;AACH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,qCAAqC,CAC7C,CAAC;AAEF,eAAO,MAAM,2CAA2C;;iBAEtD,CAAC;AACH,MAAM,MAAM,qCAAqC,GAAG,CAAC,CAAC,KAAK,CACzD,OAAO,2CAA2C,CACnD,CAAC;AAEF,MAAM,WAAW,8BAA8B;IAC7C,wEAAwE;IACxE,MAAM,IAAI,QAAQ,CAAC;IACnB,SAAS,IAAI,QAAQ,CAAC;IACtB,QAAQ,IAAI,QAAQ,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,EACnD,OAAO,EAAE,+BAA+B,GACvC,MAAM,QAAQ,CAahB;AAED,+FAA+F;AAC/F,wBAAgB,oCAAoC,CAClD,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,EACnD,OAAO,GAAE,qCAA0C,GAClD,8BAA8B,CAahC"}