stitchkit 0.90.7 → 0.91.0

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

@@ -1,6 +1,6 @@
 import {
   AppError
-} from "./index-scs3f1eg.js";
+} from "./index-2vtcmrj9.js";
 import {
   isRecord
 } from "./index-77fekveh.js";
@@ -10,21 +10,62 @@ import { z } from "zod";
 function issuePath(path) {
   return path.length > 0 ? path.map(String).join(".") : "(root)";
 }
+var MAX_UNION_DEPTH = 3;
+var MAX_DESCRIBED_BRANCHES = 5;
+function unionBranches(issue) {
+  const errors = Reflect.get(issue, "errors");
+  if (!Array.isArray(errors) || errors.length === 0)
+    return;
+  if (!errors.every((branch) => Array.isArray(branch)))
+    return;
+  return errors;
+}
+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 rest = branches.length - described.length;
+  const suffix = rest > 0 ? `; ...and ${rest} more branches` : "";
+  return `No union branch matched — ${described.join("; ")}${suffix}`;
+}
+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;
+    into.push({
+      path: issuePath(path),
+      code: issue.code,
+      message: branches ? unionSummary(branches, path) : issue.message,
+      ...branch !== undefined && { branch }
+    });
+    if (!branches)
+      continue;
+    branches.forEach((branchIssues, index) => {
+      collectIssues(branchIssues, path, index + 1, depth + 1, into);
+    });
+  }
+}
+function zodIssues(error) {
+  const issues = [];
+  collectIssues(error.issues, [], undefined, 0, issues);
+  return issues;
+}
+var MAX_FORMATTED_ISSUES = 5;
 function formatZodError(error) {
-  const issues = error.issues.slice(0, 5);
-  const lines = issues.map((issue) => `${issuePath(issue.path)}: ${issue.message}`);
-  const suffix = error.issues.length > 5 ? `
-...and ${error.issues.length - 5} more issues` : "";
+  const all = zodIssues(error);
+  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})`;
+    return `${where}: ${issue.message}`;
+  });
+  const suffix = all.length > shown.length ? `
+...and ${all.length - shown.length} more issues` : "";
   return lines.join(`
 `) + suffix;
 }
-function zodIssues(error) {
-  return error.issues.map((issue) => ({
-    path: issuePath(issue.path),
-    code: issue.code,
-    message: issue.message
-  }));
-}
 var MAX_DETAIL_ISSUES = 20;
 function errorCode(err) {
   if (AppError.is(err))
@@ -109,4 +150,4 @@ function validateDeclaredOutput(schema, data, onStripped) {
   return validateHandlerOutput(schema, data, onStripped);
 }
 
-export { formatZodError, zodIssues, errorCode, recordedErrorMessage, normalizeError, validateDeclaredOutput };
+export { zodIssues, formatZodError, errorCode, recordedErrorMessage, normalizeError, validateDeclaredOutput };

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

@@ -4,10 +4,10 @@ import {
 } from "./index-2qzskm8h.js";
 import {
   zodIssues
-} from "./index-2hryh65w.js";
+} from "./index-13cjtmrw.js";
 import {
   AppError
-} from "./index-scs3f1eg.js";
+} from "./index-2vtcmrj9.js";
 
 // src/realtime/rejected-frame.ts
 var REALTIME_REJECTION_KEY = "@stitchkit/realtime-rejected";
@@ -43,7 +43,13 @@ function parseIssues(value) {
     const code = Reflect.get(entry, "code");
     const message = Reflect.get(entry, "message");
     if (typeof path === "string" && typeof code === "string" && typeof message === "string") {
-      issues.push({ path, code, message });
+      const branch = Reflect.get(entry, "branch");
+      issues.push({
+        path,
+        code,
+        message,
+        ...typeof branch === "number" && Number.isInteger(branch) && branch > 0 && { branch }
+      });
     }
   }
   return issues.length > 0 ? issues : undefined;

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

@@ -1,12 +1,16 @@
 import {
-  executeToolMethod
-} from "./index-8pjqv3zh.js";
+  executeToolMethod,
+  toolErrorFromResult
+} from "./index-mqhjmadk.js";
 import {
   assertToolExtensionCompatible,
   mergeSchemas,
   projectToolSurface,
   rebuildObject
 } from "./index-fenaekmk.js";
+import {
+  isRetryableStatus
+} from "./index-2vtcmrj9.js";
 
 // src/tools/mount.ts
 import { z } from "zod";
@@ -54,7 +58,10 @@ function createToolRunner(config) {
   };
 }
 function formatToolError(result, toolName, errorHint) {
-  const err = { error: result.code };
+  const err = {
+    error: result.code,
+    retryable: result.retryable ?? isRetryableStatus(toolErrorFromResult(result).status)
+  };
   if (result.details)
     err.details = result.details;
   const hints = [];

package/dist/{index-scs3f1eg.js → index-2vtcmrj9.js}

@@ -7,13 +7,15 @@ class AppError extends Error {
   details;
   hint;
   traceId;
-  constructor(code, message, status = 500, details, hint, traceId) {
+  retryable;
+  constructor(code, message, status = 500, details, hint, traceId, retryable) {
     super(message ?? code);
     this.code = code;
     this.status = status;
     this.details = details;
     this.hint = hint;
     this.traceId = traceId;
+    this.retryable = retryable;
     this.name = "AppError";
     Object.defineProperty(this, APP_ERROR_BRAND, { value: true });
   }
@@ -68,6 +70,7 @@ var STITCH_ERROR_STATUS = {
   REALTIME_CONTRACT_VIOLATION: 500,
   APPLICATION_NOT_ACCEPTING: 503,
   GRAMMY_WEBHOOK_NOT_ACCEPTING: 503,
+  NOT_IMPLEMENTED: 501,
   WAIT_TIMEOUT: 408,
   WAIT_FAILED: 409,
   DOWNLOAD_NOT_FOUND: 404,
@@ -82,6 +85,9 @@ var STITCH_ERROR_STATUS = {
   SPILL_REFERENCE_UNKNOWN: 404,
   INTERNAL_SERVER_ERROR: 500
 };
+function isRetryableStatus(status) {
+  return status === 408 || status === 429 || status === 502 || status === 503 || status === 504;
+}
 function isStitchErrorCode(code) {
   return Object.hasOwn(STITCH_ERROR_STATUS, code);
 }
@@ -89,4 +95,4 @@ function appError(code, message, details) {
   throw new AppError(code, message, isStitchErrorCode(code) ? STITCH_ERROR_STATUS[code] : 500, details);
 }
 
-export { AppError, notFound, badRequest, unauthorized, forbidden, conflict, rateLimited, STITCH_ERROR_STATUS, isStitchErrorCode, appError };
+export { AppError, notFound, badRequest, unauthorized, forbidden, conflict, rateLimited, STITCH_ERROR_STATUS, isRetryableStatus, isStitchErrorCode, appError };

package/dist/{index-xbppf54a.js → index-6kyksz9y.js}

@@ -81,7 +81,12 @@ function redact(value, options = {}) {
     return matchesPath(matcher, path, patternIndex + 1, pathIndex + 1);
   };
   const isSensitivePath = (path) => pathMatchers.some((matcher) => matchesPath(matcher, path));
-  const safeString = (input) => {
+  const stringBoundFor = (key) => {
+    const byKey = key === undefined ? undefined : options.maxStringLengthByKey?.[key];
+    return byKey ?? maxStringLength;
+  };
+  const safeString = (input, key) => {
+    const bound = stringBoundFor(key);
     let output = input;
     for (const pattern of options.sensitiveUrlPatterns ?? []) {
       try {
@@ -89,9 +94,9 @@ function redact(value, options = {}) {
         output = output.replace(global, MASK);
       } catch {}
     }
-    if (output.length <= maxStringLength)
+    if (output.length <= bound)
       return output;
-    return `${output.slice(0, Math.max(0, maxStringLength))}…[truncated]`;
+    return `${output.slice(0, Math.max(0, bound))}…[truncated]`;
   };
   const ancestors = new Set;
   const maxNodes = options.maxNodes ?? DEFAULT_MAX_NODES;
@@ -105,7 +110,7 @@ function redact(value, options = {}) {
     if (input === null || input === undefined)
       return null;
     if (typeof input === "string")
-      return safeString(input);
+      return safeString(input, path[path.length - 1]);
     if (typeof input === "number" || typeof input === "boolean") {
       return input;
     }
@@ -164,9 +169,9 @@ function redact(value, options = {}) {
       const cause = property("cause");
       return {
         _type: "error",
-        name: safeString(String(property("name"))),
-        message: safeString(String(property("message"))),
-        ...stack !== undefined && { stack: safeString(String(stack)) },
+        name: safeString(String(property("name")), "name"),
+        message: safeString(String(property("message")), "message"),
+        ...stack !== undefined && { stack: safeString(String(stack), "stack") },
         ...cause !== undefined && { cause: walk(cause, depth + 1, [...path, "cause"]) }
       };
     }

package/dist/{index-aj9geeez.js → index-709nh7z7.js}

@@ -1,7 +1,10 @@
 import {
   mergeMeta,
   resolveRouteParamsSchema
-} from "./index-nrqg8tks.js";
+} from "./index-0a349c33.js";
+import {
+  AppError
+} from "./index-2vtcmrj9.js";
 import {
   isUnsafeKey
 } from "./index-kzfs85xp.js";
@@ -70,14 +73,24 @@ function contractOnlyService(contract) {
   return bindContract(contract, handlers);
 }
 var HTTP_ONLY = Object.freeze(["HTTP"]);
-function bindContract(contract, handlers) {
+function stubHandler(label) {
+  return () => {
+    throw new AppError("NOT_IMPLEMENTED", `[stitchkit] ${label} is declared by its contract and has no handler`, 501);
+  };
+}
+function bindContract(contract, handlers, options) {
   const methods = {};
   const groupScope = contract.meta.scope ?? "public";
   for (const [key, endpoint] of typedEntries(contract.endpoints)) {
-    const typedHandler = handlers[String(key)];
+    const label = `${contract.meta.prefix}.${String(key)}`;
+    let typedHandler = handlers[String(key)];
     const isStreaming = endpoint.multipart?.delivery === "stream";
     if (!isStreaming && typeof typedHandler !== "function") {
-      throw new Error(`[stitchkit] implement: missing handler for "${contract.meta.prefix}.${String(key)}"`);
+      if (options?.onMissingHandler !== "stub") {
+        throw new Error(`[stitchkit] implement: missing handler for "${label}"`);
+      }
+      console.warn(`[stitchkit] implement: "${label}" has no handler and is mounted as a 501 stub`);
+      typedHandler = stubHandler(label);
     }
     if (isStreaming && !isStreamingImplementation(typedHandler)) {
       throw new Error(`[stitchkit] implement: streaming multipart endpoint "${contract.meta.prefix}.${String(key)}" must use defineMultipartStream()`);
@@ -125,14 +138,14 @@ function bindContract(contract, handlers) {
     methods
   };
 }
-function implement(contract, handlers) {
-  return bindContract(contract, handlers);
+function implement(contract, handlers, options) {
+  return bindContract(contract, handlers, options);
 }
 function createImplement() {
-  return (contract, handlers) => implement(contract, handlers);
+  return (contract, handlers, options) => implement(contract, handlers, options);
 }
 function createScopedImplement() {
-  const implementScoped = (contract, handlers) => bindContract(contract, handlers);
+  const implementScoped = (contract, handlers, options) => bindContract(contract, handlers, options);
   const stream = (scope, endpoint, config) => {
     if (endpoint.scope !== undefined && endpoint.scope !== scope) {
       throw new Error(`[stitchkit] createScopedImplement.stream: endpoint declares scope "${endpoint.scope}" but "${String(scope)}" was given`);
@@ -143,18 +156,21 @@ function createScopedImplement() {
   return Object.assign(implementScoped, { stream, declare });
 }
 function createScopedImplementRegistry() {
-  return (contracts, handlers) => transportResult(bindRegistry(contracts, handlers));
+  return (contracts, handlers, options) => transportResult(bindRegistry(contracts, handlers, options));
 }
 function isImplementationContract(value) {
   return isRecord(value) && isRecord(value.meta) && typeof value.meta.prefix === "string" && isRecord(value.endpoints);
 }
-function bindRegistry(contracts, handlers) {
+function bindRegistry(contracts, handlers, options) {
   const contractKeys = Object.keys(contracts);
   const handlerKeys = Object.keys(handlers);
   const missing = contractKeys.filter((key) => !Object.hasOwn(handlers, key));
   const extra = handlerKeys.filter((key) => !Object.hasOwn(contracts, key));
   if (missing.length > 0 || extra.length > 0) {
-    throw new Error(`[stitchkit] implementRegistry: registry mismatch (missing: ${missing.join(", ") || "none"}; extra: ${extra.join(", ") || "none"})`);
+    if (options?.onMissingHandler !== "stub") {
+      throw new Error(`[stitchkit] implementRegistry: registry mismatch (missing: ${missing.join(", ") || "none"}; extra: ${extra.join(", ") || "none"})`);
+    }
+    console.warn(`[stitchkit] implementRegistry: registry mismatch (missing: ${missing.join(", ") || "none"}; extra: ${extra.join(", ") || "none"}) — missing contracts are mounted as 501 stubs and extra handlers are ignored`);
   }
   const prefixes = new Map;
   const services = [];
@@ -171,7 +187,7 @@ function bindRegistry(contracts, handlers) {
       throw new Error(`[stitchkit] implementRegistry: duplicate contract prefix "${contract.meta.prefix}" in scope "${groupScope}" at "${previousKey}" and "${key}"`);
     }
     prefixes.set(identity, key);
-    const entryHandlers = handlers[key];
+    const entryHandlers = handlers[key] === undefined && options?.onMissingHandler === "stub" ? {} : handlers[key];
     if (!isRecord(entryHandlers)) {
       throw new TypeError(`[stitchkit] implementRegistry: handlers for "${key}" must be an object`);
     }
@@ -180,20 +196,24 @@ function bindRegistry(contracts, handlers) {
     const missingEndpoints = endpointKeys.filter((endpointKey) => !Object.hasOwn(entryHandlers, endpointKey));
     const extraEndpoints = handlerEntryKeys.filter((endpointKey) => !Object.hasOwn(contract.endpoints, endpointKey));
     if (missingEndpoints.length > 0 || extraEndpoints.length > 0) {
-      throw new Error(`[stitchkit] implementRegistry: handlers for "${key}" mismatch (missing: ${missingEndpoints.join(", ") || "none"}; extra: ${extraEndpoints.join(", ") || "none"})`);
+      const detail = `handlers for "${key}" mismatch (missing: ${missingEndpoints.join(", ") || "none"}; extra: ${extraEndpoints.join(", ") || "none"})`;
+      if (options?.onMissingHandler !== "stub") {
+        throw new Error(`[stitchkit] implementRegistry: ${detail}`);
+      }
+      console.warn(`[stitchkit] implementRegistry: ${detail} — missing endpoints are mounted as 501 stubs and extra handlers are ignored`);
     }
-    const service = bindContract(contract, entryHandlers);
+    const service = bindContract(contract, entryHandlers, options);
     services.push(service);
     byKey[key] = service;
   }
   Object.defineProperty(services, "byKey", { value: byKey, enumerable: false });
   return transportResult(services);
 }
-function implementRegistry(contracts, handlers) {
-  return transportResult(bindRegistry(contracts, handlers));
+function implementRegistry(contracts, handlers, options) {
+  return transportResult(bindRegistry(contracts, handlers, options));
 }
 function createImplementRegistry() {
-  return (contracts, handlers) => transportResult(bindRegistry(contracts, handlers));
+  return (contracts, handlers, options) => transportResult(bindRegistry(contracts, handlers, options));
 }
 
 // src/server/middleware/cors.ts

package/dist/{index-zkcqhxx8.js → index-a11g2kry.js}

@@ -11,7 +11,7 @@ import {
 } from "./index-3z73fh2c.js";
 import {
   AppError
-} from "./index-scs3f1eg.js";
+} from "./index-2vtcmrj9.js";
 
 // src/application/kernel.ts
 import { z } from "zod";

package/dist/{index-1txvygak.js → index-b971qjes.js}

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

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

@@ -1,16 +1,16 @@
 import {
   collectTools,
   createToolRunner
-} from "./index-1bnkzq95.js";
+} from "./index-1qvdwnp2.js";
 import {
   toolErrorFromResult
-} from "./index-8pjqv3zh.js";
+} from "./index-mqhjmadk.js";
 import {
   assertUniqueToolName
 } from "./index-fenaekmk.js";
 import {
   AppError
-} from "./index-scs3f1eg.js";
+} from "./index-2vtcmrj9.js";
 
 // src/tools/invoker.ts
 function createToolInvoker(services, config) {

package/dist/{index-bva395we.js → index-bv7mytab.js}

@@ -5,7 +5,7 @@ import {
   contextContributionDelta,
   mergeContextContribution,
   prepareContextContribution
-} from "./index-aj9geeez.js";
+} from "./index-709nh7z7.js";
 import {
   base64UrlToBytes,
   bytesToBase64Url
@@ -13,7 +13,7 @@ import {
 import {
   forbidden,
   unauthorized
-} from "./index-scs3f1eg.js";
+} from "./index-2vtcmrj9.js";
 import {
   isUnsafeKey,
   safeJsonParse