stitchkit 0.91.0 → 0.91.2

package/CHANGELOG.md

@@ -15,6 +15,48 @@ additive**; the first breaking change landed in 0.10.0. Grep the file for
 
 ## [Unreleased]
 
+## [0.91.2] — 2026-09-22
+
+### Fixed
+
+- **A refused union now presents the field it already collected.** 0.90.8 made
+  the real path available — and then `formatZodError` printed the first five
+  entries of a tree walk, which for a union over primitives (`z.json()`, or any
+  recursive schema) are the branches that failed on the type of the whole value:
+  all at the union's own path, all saying the same thing. A consuming session
+  read `(root)` five times and `...and 14 more issues` while the line naming
+  `nodes.0.streams` sat eighteenth of nineteen, and spent an hour on it. Three
+  changes, each measured on that payload: a branch is described by the **deepest
+  named field it reached** rather than by its first issue (which for a nested
+  union is that nested `invalid_union` at the parent's own path, saying nothing
+  new); a truncated summary keeps the branches that got **furthest** rather than
+  the first few; and the text projection prints one line per path, since the
+  union's own line already quotes the repeats and each one spends a slot. The
+  depth limit now bounds how many *issues* a nested union contributes and no
+  longer silences its own line, which used to read `nodes.0.streams: Invalid
+  input` on exactly the line that mattered. `zodIssues` and `details.issues` are
+  unchanged in shape and still carry every branch, repeats included — a machine
+  addresses them by branch number. An error with no unions prints exactly what
+  it printed before. → ADR 0188
+
+## [0.91.1] — 2026-09-22
+
+### Fixed
+
+- **A refusal relayed from a discovered MCP tool no longer says "retryable" for
+  everything.** `mcpToolFailure` rebuilt the remote's refusal with a constant
+  502 and read neither `retryable` nor `_hint` off the envelope it had just
+  parsed. 502 is a retryable class, so the status-derived answer was `true` for
+  every relayed failure there has ever been — `NOT_FOUND` included, and a model
+  reading it calls the missing thing again. That is the exact opposite of what
+  the field was added for in 0.91.0. Both fields are now carried as the remote
+  sent them: `retryable` only when it is a boolean, `_hint` only when it is a
+  string, so `0` or `'false'` stays undeclared rather than being coerced into a
+  decision. The status stays 502 in both branches — the failure did happen
+  upstream, and a declared `retryable` wins over it anyway. A remote that
+  declares nothing is unchanged, and the unstructured branch
+  (`UPSTREAM_TOOL_ERROR`) has nothing to declare and keeps the 502 default.
+
 ## [0.91.0] — 2026-09-22
 
 ### ⚠️ Breaking changes

package/dist/agent-runtime-harness.js

@@ -6,7 +6,7 @@ import {
   composeAgentPrompt,
   createAgentRuntime,
   createAgentRuntimeEventSink
-} from "./index-bx6yq2m4.js";
+} from "./index-7hz88dy8.js";
 import"./index-p13mwz16.js";
 import"./index-y64k3s0h.js";
 import {
@@ -19,10 +19,10 @@ import {
   walkContainedFiles
 } from "./index-bn2cjajt.js";
 import"./index-kw9t5ayn.js";
-import"./index-mqhjmadk.js";
+import"./index-s3dssqxp.js";
 import"./index-vsbzgd7b.js";
 import"./index-f9mb610r.js";
-import"./index-13cjtmrw.js";
+import"./index-e0znv5gn.js";
 import"./index-0a349c33.js";
 import"./index-rxfy4cq7.js";
 import"./index-6k1937bx.js";

package/dist/agent-runtime.js

@@ -24,7 +24,7 @@ import {
   renderAgentStateSlots,
   repairedSearchCall,
   selectAgentHistory
-} from "./index-bx6yq2m4.js";
+} from "./index-7hz88dy8.js";
 import"./index-p13mwz16.js";
 import {
   AgentAdmissionEventSchema,
@@ -162,7 +162,7 @@ import {
 import {
   buildToolManifest,
   mountAgent
-} from "./index-f4p4b8f6.js";
+} from "./index-pena034b.js";
 import {
   DURABILITY_STEP_EVENT_KIND,
   ParkAbortedError,
@@ -172,12 +172,12 @@ import {
   StepResultNotSerializableError,
   createLocalStepDurability
 } from "./index-kw9t5ayn.js";
-import"./index-qrbdq8jk.js";
-import"./index-1qvdwnp2.js";
-import"./index-mqhjmadk.js";
+import"./index-a2nzz56k.js";
+import"./index-4x809vqd.js";
+import"./index-s3dssqxp.js";
 import"./index-vsbzgd7b.js";
 import"./index-f9mb610r.js";
-import"./index-13cjtmrw.js";
+import"./index-e0znv5gn.js";
 import"./index-0a349c33.js";
 import"./index-rxfy4cq7.js";
 import"./index-6k1937bx.js";

package/dist/cli.js

@@ -11,14 +11,14 @@ import {
   readCapped,
   renderCliView,
   routeCliArgv
-} from "./index-ya611vx3.js";
+} from "./index-seyy8dvn.js";
 import"./index-sbdmyz75.js";
-import"./index-qrbdq8jk.js";
-import"./index-1qvdwnp2.js";
-import"./index-mqhjmadk.js";
+import"./index-a2nzz56k.js";
+import"./index-4x809vqd.js";
+import"./index-s3dssqxp.js";
 import"./index-vsbzgd7b.js";
 import"./index-f9mb610r.js";
-import"./index-13cjtmrw.js";
+import"./index-e0znv5gn.js";
 import"./index-0a349c33.js";
 import"./index-rxfy4cq7.js";
 import"./index-6k1937bx.js";

package/dist/{index-1qvdwnp2.js → index-4x809vqd.js}

@@ -1,7 +1,7 @@
 import {
   executeToolMethod,
   toolErrorFromResult
-} from "./index-mqhjmadk.js";
+} from "./index-s3dssqxp.js";
 import {
   assertToolExtensionCompatible,
   mergeSchemas,

package/dist/{index-bx6yq2m4.js → index-7hz88dy8.js}

@@ -37,7 +37,7 @@ import {
 import {
   ToolExecutionControlError,
   isToolExecutionControlError
-} from "./index-mqhjmadk.js";
+} from "./index-s3dssqxp.js";
 import {
   isRecord,
   transportResult

package/dist/{index-qrbdq8jk.js → index-a2nzz56k.js}

@@ -1,6 +1,6 @@
 import {
   contractToolMountable
-} from "./index-1qvdwnp2.js";
+} from "./index-4x809vqd.js";
 import {
   runtimeToolMountable
 } from "./index-8z9we758.js";

package/dist/{index-bh70rk41.js → index-axvavfr4.js}

@@ -1,10 +1,10 @@
 import {
   collectTools,
   createToolRunner
-} from "./index-1qvdwnp2.js";
+} from "./index-4x809vqd.js";
 import {
   toolErrorFromResult
-} from "./index-mqhjmadk.js";
+} from "./index-s3dssqxp.js";
 import {
   assertUniqueToolName
 } from "./index-fenaekmk.js";

package/dist/{index-13cjtmrw.js → index-e0znv5gn.js}

@@ -20,12 +20,29 @@ function unionBranches(issue) {
     return;
   return errors;
 }
+function deepestBranchReason(issues, prefix, budget) {
+  let deepest;
+  for (const issue of issues) {
+    const path = [...prefix, ...issue.path];
+    const nested = budget > 0 ? unionBranches(issue) : undefined;
+    const candidates = nested ? nested.map((branch) => deepestBranchReason(branch, path, budget - 1)).filter((reason) => reason !== undefined) : [{ path, message: issue.message }];
+    for (const candidate of candidates) {
+      if (!deepest || candidate.path.length > deepest.path.length)
+        deepest = candidate;
+    }
+  }
+  return deepest;
+}
 function unionSummary(branches, prefix) {
-  const described = branches.slice(0, MAX_DESCRIBED_BRANCHES).map((issues, index) => {
-    const first = issues[0];
-    if (!first)
-      return `branch ${index + 1} reported no reason`;
-    return `branch ${index + 1} at ${issuePath([...prefix, ...first.path])}: ${first.message}`;
+  const reasons = branches.map((issues, index) => ({
+    branch: index + 1,
+    reason: deepestBranchReason(issues, prefix, MAX_UNION_DEPTH)
+  }));
+  const ranked = [...reasons].sort((a, b) => (b.reason?.path.length ?? -1) - (a.reason?.path.length ?? -1));
+  const described = ranked.slice(0, MAX_DESCRIBED_BRANCHES).map(({ branch, reason }) => {
+    if (!reason)
+      return `branch ${branch} reported no reason`;
+    return `branch ${branch} at ${issuePath(reason.path)}: ${reason.message}`;
   });
   const rest = branches.length - described.length;
   const suffix = rest > 0 ? `; ...and ${rest} more branches` : "";
@@ -34,14 +51,14 @@ function unionSummary(branches, prefix) {
 function collectIssues(issues, prefix, branch, depth, into) {
   for (const issue of issues) {
     const path = [...prefix, ...issue.path];
-    const branches = depth < MAX_UNION_DEPTH ? unionBranches(issue) : undefined;
+    const branches = unionBranches(issue);
     into.push({
       path: issuePath(path),
       code: issue.code,
       message: branches ? unionSummary(branches, path) : issue.message,
       ...branch !== undefined && { branch }
     });
-    if (!branches)
+    if (!branches || depth >= MAX_UNION_DEPTH)
       continue;
     branches.forEach((branchIssues, index) => {
       collectIssues(branchIssues, path, index + 1, depth + 1, into);
@@ -55,7 +72,13 @@ function zodIssues(error) {
 }
 var MAX_FORMATTED_ISSUES = 5;
 function formatZodError(error) {
-  const all = zodIssues(error);
+  const seen = new Set;
+  const all = zodIssues(error).filter((issue) => {
+    if (seen.has(issue.path))
+      return false;
+    seen.add(issue.path);
+    return true;
+  });
   const shown = all.slice(0, MAX_FORMATTED_ISSUES);
   const lines = shown.map((issue) => {
     const where = issue.branch === undefined ? issue.path : `${issue.path} (branch ${issue.branch})`;

package/dist/{index-13e1k7v9.js → index-f477k430.js}

@@ -4,7 +4,7 @@ import {
 } from "./index-2qzskm8h.js";
 import {
   zodIssues
-} from "./index-13cjtmrw.js";
+} from "./index-e0znv5gn.js";
 import {
   AppError
 } from "./index-2vtcmrj9.js";

package/dist/{index-zsqy3xfn.js → index-jpfqfg5c.js}

@@ -10,7 +10,7 @@ import {
 import {
   createValidatedRealtimeSocket,
   isModuleNotFound
-} from "./index-13e1k7v9.js";
+} from "./index-f477k430.js";
 import {
   DEFAULT_PROCESS_SIGNALS,
   RUNTIME_CONTEXT_RESERVED_KEYS,
@@ -41,7 +41,7 @@ import {
   normalizeError,
   recordedErrorMessage,
   validateDeclaredOutput
-} from "./index-13cjtmrw.js";
+} from "./index-e0znv5gn.js";
 import {
   DEFAULT_CONTRACT_STREAM_FRAME_BYTES,
   joinRoutePath,

package/dist/{index-f4p4b8f6.js → index-pena034b.js}

@@ -4,16 +4,16 @@ import {
 } from "./index-kw9t5ayn.js";
 import {
   collectToolSurface
-} from "./index-qrbdq8jk.js";
+} from "./index-a2nzz56k.js";
 import {
   createToolRunner,
   formatToolError
-} from "./index-1qvdwnp2.js";
+} from "./index-4x809vqd.js";
 import {
   isToolExecutionControlError,
   toolCauseFromResult,
   toolResultFromError
-} from "./index-mqhjmadk.js";
+} from "./index-s3dssqxp.js";
 import {
   isRecord
 } from "./index-77fekveh.js";

package/dist/{index-mqhjmadk.js → index-s3dssqxp.js}

@@ -6,7 +6,7 @@ import {
   formatZodError,
   normalizeError,
   validateDeclaredOutput
-} from "./index-13cjtmrw.js";
+} from "./index-e0znv5gn.js";
 import {
   coerceJsonArgs
 } from "./index-7zbps32p.js";

package/dist/{index-ya611vx3.js → index-seyy8dvn.js}

@@ -3,19 +3,19 @@ import {
 } from "./index-sbdmyz75.js";
 import {
   collectToolSurface
-} from "./index-qrbdq8jk.js";
+} from "./index-a2nzz56k.js";
 import {
   createToolRunner,
   formatToolError
-} from "./index-1qvdwnp2.js";
+} from "./index-4x809vqd.js";
 import {
   toolErrorFromResult,
   toolResultFromError
-} from "./index-mqhjmadk.js";
+} from "./index-s3dssqxp.js";
 import {
   formatZodError,
   validateDeclaredOutput
-} from "./index-13cjtmrw.js";
+} from "./index-e0znv5gn.js";
 import {
   coerceJsonArgs
 } from "./index-7zbps32p.js";

package/dist/{index-b971qjes.js → index-v5573g1k.js}

@@ -1,6 +1,6 @@
 import {
   normalizeError
-} from "./index-13cjtmrw.js";
+} from "./index-e0znv5gn.js";
 
 // src/internal/bounded-lines.ts
 var DEFAULT_STREAM_LINE_BYTES = 1024 * 1024;

package/dist/{index-137jjs4v.js → index-yewwh1w4.js}

@@ -3,7 +3,7 @@ import {
   inputIsQuery,
   parseSSE,
   readBoundedUtf8Lines
-} from "./index-b971qjes.js";
+} from "./index-v5573g1k.js";
 import {
   ApiError,
   RequestCancellationError,

package/dist/index.js

@@ -15,7 +15,7 @@ import {
   createUrlBuilder,
   createUrlBuilders,
   parseNDJSON
-} from "./index-137jjs4v.js";
+} from "./index-yewwh1w4.js";
 import {
   REALTIME_REJECTION_KEY,
   asRealtimeRejection,
@@ -23,7 +23,7 @@ import {
   isModuleNotFound,
   parseRealtimeRequestAcknowledgement,
   parseRealtimeRequestArguments
-} from "./index-13e1k7v9.js";
+} from "./index-f477k430.js";
 import {
   RealtimeRequestDisconnectedError,
   RealtimeRequestInvalidAcknowledgementError,
@@ -34,7 +34,7 @@ import {
 } from "./index-2qzskm8h.js";
 import {
   parseSSE
-} from "./index-b971qjes.js";
+} from "./index-v5573g1k.js";
 import {
   LiveStateControllerStatusSchema,
   LiveStatePhaseSchema,
@@ -49,7 +49,7 @@ import {
 import {
   formatZodError,
   zodIssues
-} from "./index-13cjtmrw.js";
+} from "./index-e0znv5gn.js";
 import {
   ALL_TRANSPORTS,
   ContractStreamFrameSchema,

package/dist/internal/errors.d.ts

@@ -25,6 +25,16 @@ export interface ZodIssueSummary {
  * the refusal names the branch and the path instead of only `(root)`.
  */
 export declare function zodIssues(error: z.ZodError): ZodIssueSummary[];
+/**
+ * The text a person reads, which is a different job from the structured list.
+ *
+ * `zodIssues` keeps every branch failure, including the several that sit at the
+ * union's own path — a machine addresses them by branch number and wants them
+ * all. A reader gains nothing from the same path twice: the union's own line
+ * already quotes those reasons, and each repeat costs one of the few lines the
+ * cap allows. So the text keeps the first issue at each path and drops the
+ * rest, which is what leaves room for the line naming the field.
+ */
 export declare function formatZodError(error: z.ZodError): string;
 /**
  * The stable error code for a thrown value — `AppError.code`, `VALIDATION_ERROR`

package/dist/internal/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/internal/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQvC,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAyED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,eAAe,EAAE,CAI9D;AAKD,wBAAgB,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,MAAM,CAWxD;AAKD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI1D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,MAAM,EAAE,OAAO,GACd,MAAM,GAAG,SAAS,CAYpB;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,CAyBrD;AA4BD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,OAAO,EACb,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,GACrC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAe9D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,GAAG,SAAS,EAC3B,IAAI,EAAE,OAAO,EACb,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,GACrC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAe9D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/internal/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQvC,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAwID;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,eAAe,EAAE,CAI9D;AAKD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,MAAM,CAgBxD;AAKD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI1D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,MAAM,EAAE,OAAO,GACd,MAAM,GAAG,SAAS,CAYpB;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,CAyBrD;AA4BD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,OAAO,EACb,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,GACrC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAe9D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,GAAG,SAAS,EAC3B,IAAI,EAAE,OAAO,EACb,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,GACrC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAe9D"}

package/dist/node.js

@@ -5,7 +5,7 @@ import {
   createHandler,
   createSocketIOServer,
   createUnixClientTransport
-} from "./index-zsqy3xfn.js";
+} from "./index-jpfqfg5c.js";
 import"./index-y91ry9h2.js";
 import {
   ShutdownOptionsSchema,
@@ -14,7 +14,7 @@ import {
   ShutdownStatusSchema,
   createServerLifecycle
 } from "./index-3z73fh2c.js";
-import"./index-13e1k7v9.js";
+import"./index-f477k430.js";
 import"./index-2qzskm8h.js";
 import {
   createImplement,
@@ -27,7 +27,7 @@ import {
 } from "./index-709nh7z7.js";
 import"./index-vsbzgd7b.js";
 import"./index-f9mb610r.js";
-import"./index-13cjtmrw.js";
+import"./index-e0znv5gn.js";
 import"./index-0a349c33.js";
 import"./index-rxfy4cq7.js";
 import"./index-6k1937bx.js";

package/dist/observability/index.js

@@ -27,7 +27,7 @@ import {
 import"../index-f9mb610r.js";
 import {
   recordedErrorMessage
-} from "../index-13cjtmrw.js";
+} from "../index-e0znv5gn.js";
 import"../index-0a349c33.js";
 import"../index-rxfy4cq7.js";
 import"../index-6k1937bx.js";

package/dist/remote.js

@@ -1,11 +1,11 @@
 import {
   createClient
-} from "./index-137jjs4v.js";
-import"./index-b971qjes.js";
+} from "./index-yewwh1w4.js";
+import"./index-v5573g1k.js";
 import {
   ApiError
 } from "./index-3xwxfj4z.js";
-import"./index-13cjtmrw.js";
+import"./index-e0znv5gn.js";
 import {
   mergeMeta,
   resolveRouteParamsSchema

package/dist/server/index.js

@@ -13,7 +13,7 @@ import {
   sseRoute,
   streamingRoute,
   webSocketLane
-} from "../index-zsqy3xfn.js";
+} from "../index-jpfqfg5c.js";
 import"../index-y91ry9h2.js";
 import {
   withDeadline
@@ -25,13 +25,13 @@ import {
   ShutdownStatusSchema,
   createServerLifecycle
 } from "../index-3z73fh2c.js";
-import"../index-13e1k7v9.js";
+import"../index-f477k430.js";
 import"../index-2qzskm8h.js";
 import {
   inputIsQuery,
   parseSSE,
   streamSSE
-} from "../index-b971qjes.js";
+} from "../index-v5573g1k.js";
 import {
   composeAuthHooks,
   createAuthHook,
@@ -82,7 +82,7 @@ import {
   formatZodError,
   normalizeError,
   zodIssues
-} from "../index-13cjtmrw.js";
+} from "../index-e0znv5gn.js";
 import {
   DEFAULT_CONTRACT_STREAM_FRAME_BYTES,
   joinRoutePath,

package/dist/testing.js

@@ -28,19 +28,19 @@ import {
 import {
   createClient,
   createClients
-} from "./index-137jjs4v.js";
+} from "./index-yewwh1w4.js";
 import {
   RealtimeRequestDisconnectedError,
   RealtimeRequestInvalidAcknowledgementError,
   RealtimeRequestTimeoutError
 } from "./index-2qzskm8h.js";
-import"./index-b971qjes.js";
+import"./index-v5573g1k.js";
 import"./index-3xwxfj4z.js";
 import {
   compareCodepoints,
   serializeCanonicalJson
 } from "./index-0j3vcp5m.js";
-import"./index-13cjtmrw.js";
+import"./index-e0znv5gn.js";
 import {
   joinRoutePath
 } from "./index-0a349c33.js";

package/dist/tool-invoker.js

@@ -1,11 +1,11 @@
 import {
   createToolInvoker
-} from "./index-bh70rk41.js";
-import"./index-1qvdwnp2.js";
-import"./index-mqhjmadk.js";
+} from "./index-axvavfr4.js";
+import"./index-4x809vqd.js";
+import"./index-s3dssqxp.js";
 import"./index-vsbzgd7b.js";
 import"./index-f9mb610r.js";
-import"./index-13cjtmrw.js";
+import"./index-e0znv5gn.js";
 import"./index-0a349c33.js";
 import"./index-rxfy4cq7.js";
 import"./index-6k1937bx.js";

package/dist/tools/connections/index.js

@@ -543,7 +543,7 @@ function mcpToolFailure(toolName, result) {
   if (isRecord(payload) && typeof payload.error === "string") {
     const details = isRecord(payload.details) ? payload.details : undefined;
     const message = typeof details?.message === "string" ? details.message : payload.error;
-    return new AppError(payload.error, message, 502, details);
+    return new AppError(payload.error, message, 502, details, typeof payload._hint === "string" ? payload._hint : undefined, undefined, typeof payload.retryable === "boolean" ? payload.retryable : undefined);
   }
   return new AppError(UPSTREAM_TOOL_ERROR, `External MCP tool "${toolName}" returned an error`, 502, payload === undefined ? undefined : { upstream: payload });
 }

package/dist/tools/connections/mcp-envelope.d.ts

@@ -34,11 +34,21 @@ export declare const UPSTREAM_TOOL_ERROR = "UPSTREAM_TOOL_ERROR";
  * it printed a code frame of the framework bundle before the JSON failure and
  * was then scrubbed to a bare `INTERNAL_SERVER_ERROR`.
  *
- * A structured `{ error, details }` body is the remote contract's own refusal
- * and is relayed as one. Anything else keeps the framework's sentence and
- * carries what the server did send — reporting less than we have is not caution.
+ * A structured `{ error, retryable, details, _hint }` body is the remote
+ * contract's own refusal and is relayed as one — every field of it. Anything
+ * else keeps the framework's sentence and carries what the server did send —
+ * reporting less than we have is not caution.
+ *
  * The status is 502 either way: whatever the code says, the failure happened
- * upstream, and a consumer re-serving it over HTTP should say so.
+ * upstream, and a consumer re-serving it over HTTP should say so. That constant
+ * is exactly why `retryable` has to be carried rather than re-derived. 502 is a
+ * retryable class, so a status-derived answer says `true` for every relayed
+ * refusal there has ever been — `NOT_FOUND` included, and a model reading it
+ * calls the missing thing again. The remote already decided, declared or
+ * derived from its own status, and its answer is the one that means something:
+ * it is the only side that knows whether repeating the call could work. `_hint`
+ * rides along for the same reason — it is the remote's instruction for what to
+ * do instead, and dropping it leaves the model with a refusal and no next move.
  */
 export declare function mcpToolFailure(toolName: string, result: unknown): AppError;
 //# sourceMappingURL=mcp-envelope.d.ts.map

package/dist/tools/connections/mcp-envelope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-envelope.d.ts","sourceRoot":"","sources":["../../../src/tools/connections/mcp-envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAIjD,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAaxD;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,QAAQ,CAa1E"}
+{"version":3,"file":"mcp-envelope.d.ts","sourceRoot":"","sources":["../../../src/tools/connections/mcp-envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAIjD,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAaxD;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,QAAQ,CAwB1E"}

package/dist/tools.js

@@ -26,7 +26,7 @@ import {
   buildToolManifest,
   describeToolCatalog,
   mountAgent
-} from "./index-f4p4b8f6.js";
+} from "./index-pena034b.js";
 import {
   AgentToolError,
   createLocalStepDurability,
@@ -46,7 +46,7 @@ import {
 } from "./index-4fpa9dy2.js";
 import {
   createToolInvoker
-} from "./index-bh70rk41.js";
+} from "./index-axvavfr4.js";
 import {
   WaitTimeoutError,
   createCli,
@@ -55,22 +55,22 @@ import {
   fetchPinnedDocument,
   readCapped,
   runWaitOperation
-} from "./index-ya611vx3.js";
+} from "./index-seyy8dvn.js";
 import"./index-sbdmyz75.js";
 import {
   collectToolSurface
-} from "./index-qrbdq8jk.js";
+} from "./index-a2nzz56k.js";
 import {
   collectTools,
   createToolRunner,
   formatToolError
-} from "./index-1qvdwnp2.js";
+} from "./index-4x809vqd.js";
 import {
   ToolExecutionControlError,
   executeToolMethod,
   isToolExecutionControlError,
   toolResultFromError
-} from "./index-mqhjmadk.js";
+} from "./index-s3dssqxp.js";
 import {
   getRequestContext,
   getTraceId,
@@ -79,7 +79,7 @@ import {
 import"./index-f9mb610r.js";
 import {
   normalizeError
-} from "./index-13cjtmrw.js";
+} from "./index-e0znv5gn.js";
 import {
   defineContract
 } from "./index-0a349c33.js";

package/llms-full.txt

@@ -6110,6 +6110,15 @@ const signals = bindProcessSignals(app, {
 await app.start()
 ```
 
+**Bind before you start, and the order is load-bearing.** Reading it the other way
+round — start serving, then arrange for shutdown — leaves a window between the
+first accepted request and the first listener, and a supervisor that sends
+`SIGTERM` inside that window kills the process outright: exit 143, no shutdown
+chain, no `onComplete`, nothing drained. The window is small and opens exactly
+when the machine is busiest, which is when a supervisor is most likely to be
+restarting something. `bindProcessSignals` does not start anything, so there is
+no cost to binding first.
+
 The exact resource callbacks are typed by their public configuration. The
 important ownership rule is stable: the application decides what the
 database/server/provider objects are and how they are configured; Stitchkit

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stitchkit",
-  "version": "0.91.0",
+  "version": "0.91.2",
   "description": "Contract-first backend framework — one defineContract() into an HTTP API, MCP tools, AI-agent tools and a typed client. Bun and Node.",
   "keywords": [
     "bun",