stitchkit 0.108.4 → 0.109.0

package/dist/entrypoints/testing.js

@@ -2,7 +2,7 @@ import {
   joinRoutePath
 } from "../index-m38ej7e5.js";
 import"../index-h2fhjqy7.js";
-import"../index-7jvwrjqa.js";
+import"../index-00v1qz76.js";
 import"../index-q0th8q0z.js";
 import {
   createApplication2
@@ -35,7 +35,7 @@ import"../index-fynr93w4.js";
 import {
   createClient2,
   createClients2
-} from "../index-p5kx5vqd.js";
+} from "../index-e32vy8jw.js";
 import {
   assertPositiveSafeInteger
 } from "../index-0s4xebbg.js";

package/dist/entrypoints/tools/connections.js

@@ -4,6 +4,9 @@ import {
   withDefsDialect
 } from "../../index-q6crhe1n.js";
 import"../../index-fynr93w4.js";
+import {
+  markJsonSchemaObjectGuards
+} from "../../index-t5sjh517.js";
 import {
   withSignalDeadline
 } from "../../index-9tqbxv5p.js";
@@ -856,8 +859,10 @@ function zodObjectFromJsonSchema(schema) {
   if (!schema || Object.keys(schema).length === 0)
     return z.looseObject({});
   const parsed = z.fromJSONSchema(reconcileDefinitionKeyword(schema));
-  if (parsed instanceof z.ZodObject)
+  if (parsed instanceof z.ZodObject) {
+    markJsonSchemaObjectGuards(parsed);
     return parsed;
+  }
   return z.looseObject({});
 }
 function reconcileDefinitionKeyword(schema) {

package/dist/entrypoints/tools/contract.js

@@ -9,7 +9,8 @@ import {
 } from "../../index-0gxvns6s.js";
 import {
   coerceJsonArgs2
-} from "../../index-6yxhe58g.js";
+} from "../../index-cykxpxz5.js";
+import"../../index-t5sjh517.js";
 export {
   AsyncOperationCancelResultSchema2 as AsyncOperationCancelResultSchema,
   McpAnnotationsSchema2 as McpAnnotationsSchema,

package/dist/entrypoints/tools/invoker.js

@@ -1,12 +1,13 @@
 import"../../index-fynr93w4.js";
-import"../../index-6yxhe58g.js";
+import"../../index-t5sjh517.js";
+import"../../index-cykxpxz5.js";
 import"../../index-ct75c3at.js";
 import"../../index-q6crhe1n.js";
-import"../../index-dm2fv45z.js";
-import"../../index-2s6fpehp.js";
+import"../../index-k4v2kq4q.js";
+import"../../index-ryv32myz.js";
 import {
   createToolInvoker2
-} from "../../index-6y9t2fwz.js";
+} from "../../index-kvvpw1kq.js";
 export {
   createToolInvoker2 as createToolInvoker
 };

package/dist/entrypoints/tools/mcp.js

@@ -1,9 +1,10 @@
 import"../../index-ct75c3at.js";
 import"../../index-fynr93w4.js";
-import"../../index-6yxhe58g.js";
+import"../../index-t5sjh517.js";
+import"../../index-cykxpxz5.js";
 import"../../index-q6crhe1n.js";
-import"../../index-dm2fv45z.js";
-import"../../index-2s6fpehp.js";
+import"../../index-k4v2kq4q.js";
+import"../../index-ryv32myz.js";
 import {
   RESOURCE_MIME_TYPE2,
   EXT_APPS_BUNDLE_PLACEHOLDER2,
@@ -19,8 +20,8 @@ import {
   createMcpHttpRoute2,
   createStdioMcpServer2,
   bindStdioProcessSignals2
-} from "../../index-mep4sb48.js";
-import"../../index-cx2nh595.js";
+} from "../../index-x5xs71dw.js";
+import"../../index-3wm2xp2a.js";
 import"../../index-636mggad.js";
 export {
   EXT_APPS_BUNDLE_PLACEHOLDER2 as EXT_APPS_BUNDLE_PLACEHOLDER,

package/dist/entrypoints/tools.js

@@ -7,9 +7,10 @@ import {
 import {
   normalizeError2
 } from "../index-fynr93w4.js";
+import"../index-t5sjh517.js";
 import {
   coerceJsonArgs2
-} from "../index-6yxhe58g.js";
+} from "../index-cykxpxz5.js";
 import"../index-ct75c3at.js";
 import {
   assertToolName,
@@ -22,15 +23,15 @@ import {
 import {
   ToolExecutionControlError2,
   isToolExecutionControlError2
-} from "../index-dm2fv45z.js";
+} from "../index-k4v2kq4q.js";
 import {
   collectTools2
-} from "../index-2s6fpehp.js";
+} from "../index-ryv32myz.js";
 import {
   mountAgent2,
   describeToolCatalog2,
   buildToolManifest2
-} from "../index-h7qms8f9.js";
+} from "../index-68y3n9j3.js";
 import"../index-m38ej7e5.js";
 import {
   ALL_TRANSPORTS2,
@@ -57,7 +58,7 @@ import {
   createMcpHttpRoute2,
   createStdioMcpServer2,
   bindStdioProcessSignals2
-} from "../index-mep4sb48.js";
+} from "../index-x5xs71dw.js";
 import {
   AsyncOperationCancelResultSchema2,
   createAsyncOperationSnapshotSchema2,
@@ -71,7 +72,7 @@ import {
   WaitTimeoutError,
   runWaitOperation,
   createCli2
-} from "../index-fgq4w9bf.js";
+} from "../index-5cw390s6.js";
 import {
   ManagedFilePathSchema2,
   ManagedFileRefSchema2
@@ -95,7 +96,7 @@ import {
 import"../index-1bx1xv1k.js";
 import {
   collectToolSurface
-} from "../index-cx2nh595.js";
+} from "../index-3wm2xp2a.js";
 import {
   defineRuntimeTool2,
   createRuntimeToolFactory2
@@ -105,7 +106,7 @@ import {
 } from "../index-yk4g8805.js";
 import {
   createToolInvoker2
-} from "../index-6y9t2fwz.js";
+} from "../index-kvvpw1kq.js";
 import {
   getTraceId2
 } from "../index-y3nemndz.js";

package/dist/{index-7jvwrjqa.js → index-00v1qz76.js}

@@ -19,10 +19,10 @@ import ky, {
 
 // src/browser/cancellation.ts
 class RequestCancellationError extends Error {
-  cause;
-  constructor(cause) {
-    super(cause === "caller" ? "Request was aborted" : "Request timed out");
-    this.cause = cause;
+  origin;
+  constructor(origin, cause) {
+    super(origin === "caller" ? "Request was aborted" : "Request timed out", cause === undefined ? undefined : { cause });
+    this.origin = origin;
     this.name = "RequestCancellationError";
   }
 }
@@ -32,12 +32,12 @@ function createRequestCancellation(caller, timeoutMs) {
   }
   const timeoutController = timeoutMs === undefined ? undefined : new AbortController;
   const signal = caller && timeoutController ? AbortSignal.any([caller, timeoutController.signal]) : caller ?? timeoutController?.signal;
-  let cause;
+  let origin;
   let timer;
   const abortFromCaller = () => {
-    if (cause)
+    if (origin)
       return;
-    cause = "caller";
+    origin = "caller";
   };
   if (caller?.aborted)
     abortFromCaller();
@@ -45,9 +45,9 @@ function createRequestCancellation(caller, timeoutMs) {
     caller?.addEventListener("abort", abortFromCaller, { once: true });
   if (timeoutMs !== undefined && timeoutController) {
     timer = setTimeout(() => {
-      if (cause)
+      if (origin)
         return;
-      cause = "timeout";
+      origin = "timeout";
       timeoutController.abort(new DOMException("Request timed out", "TimeoutError"));
     }, timeoutMs);
   }
@@ -55,12 +55,14 @@ function createRequestCancellation(caller, timeoutMs) {
     signal,
     async run(operation) {
       try {
-        if (cause === "caller")
-          throw cancellationError(cause);
+        if (origin === "caller")
+          throw cancellationError(origin);
         return await operation(signal);
       } catch (error) {
-        if (cause)
-          throw cancellationError(cause);
+        if (error instanceof RequestCancellationError)
+          throw error;
+        if (origin)
+          throw cancellationError(origin, error);
         throw error;
       } finally {
         if (timer !== undefined)
@@ -70,8 +72,8 @@ function createRequestCancellation(caller, timeoutMs) {
     }
   };
 }
-function cancellationError(cause) {
-  return new RequestCancellationError(cause);
+function cancellationError(origin, cause) {
+  return new RequestCancellationError(origin, cause);
 }
 
 // src/browser/http-fetch.ts
@@ -412,9 +414,10 @@ function assertTransportChoice(config) {
 }
 function requestFailure(error, emit) {
   if (error instanceof RequestCancellationError) {
-    return new ApiError2(error.cause === "caller" ? "REQUEST_ABORTED" : "REQUEST_TIMEOUT", {
+    return new ApiError2(error.origin === "caller" ? "REQUEST_ABORTED" : "REQUEST_TIMEOUT", {
       status: 0,
-      message: error.message
+      message: error.message,
+      ...error.cause !== undefined && { cause: error.cause }
     });
   }
   if (ApiError2.is(error))

package/dist/{index-cx2nh595.js → index-3wm2xp2a.js}

@@ -3,7 +3,7 @@ import {
 } from "./index-q6crhe1n.js";
 import {
   contractToolMountable
-} from "./index-2s6fpehp.js";
+} from "./index-ryv32myz.js";
 import {
   runtimeToolMountable
 } from "./index-636mggad.js";

package/dist/{index-fgq4w9bf.js → index-5cw390s6.js}

@@ -1,9 +1,12 @@
 import {
   validateDeclaredOutput
 } from "./index-fynr93w4.js";
+import {
+  jsonSchemaObjectCoercionMembers
+} from "./index-t5sjh517.js";
 import {
   coerceJsonArgs2
-} from "./index-6yxhe58g.js";
+} from "./index-cykxpxz5.js";
 import {
   jsonSchemaFields
 } from "./index-ct75c3at.js";
@@ -15,11 +18,11 @@ import {
 import {
   toolResultFromError,
   toolErrorFromResult
-} from "./index-dm2fv45z.js";
+} from "./index-k4v2kq4q.js";
 import {
   createToolRunner,
   formatToolError
-} from "./index-2s6fpehp.js";
+} from "./index-ryv32myz.js";
 import {
   fetchGuarded,
   readCapped
@@ -32,7 +35,7 @@ import {
 } from "./index-eemvahkc.js";
 import {
   collectToolSurface
-} from "./index-cx2nh595.js";
+} from "./index-3wm2xp2a.js";
 import {
   formatZodError2
 } from "./index-1eeqpadm.js";
@@ -167,7 +170,7 @@ class CliArgumentError2 extends Error {
 import { z } from "zod";
 function appendCliOptionValue(raw, name, value, info) {
   const existing = raw.get(name);
-  const repeatable = !name.includes(".") && (info === undefined || info.kind === "array");
+  const repeatable = info?.kind === "array" || !name.includes(".") && info === undefined;
   if (existing !== undefined) {
     if (!repeatable) {
       throw new CliArgumentError2(`--${name} was passed ${existing.length + 1} times`);
@@ -230,8 +233,12 @@ function mergeField(fields, name, info) {
     fields.set(name, info);
     return;
   }
-  if (existing.kind === info.kind)
+  if (existing.kind === info.kind) {
+    if (existing.kind === "array" && existing.elementKind !== info.elementKind) {
+      fields.set(name, { kind: "array", elementKind: "other" });
+    }
     return;
+  }
   if (existing.kind === "boolean" || info.kind === "boolean") {
     fields.set(name, { kind: "boolean" });
     return;
@@ -275,6 +282,71 @@ function describeSchemaFields(schema) {
     collectSchemaFields(schema, fields);
   return fields;
 }
+function infoOf(field) {
+  const base = unwrap(field);
+  const kind = classify(base);
+  if (kind === "array" && base instanceof z.ZodArray) {
+    return { kind, elementKind: classify(unwrap(base.element)) };
+  }
+  return {
+    kind,
+    ...base instanceof z.ZodNumber && base.isInt && { integer: true }
+  };
+}
+function mergePathInfos(infos, composition) {
+  const present = infos.filter((info) => info !== undefined);
+  if (present.length === 0)
+    return;
+  if (composition === "union" && present.some((info) => info.kind === "other")) {
+    return { kind: "other" };
+  }
+  const concrete = present.filter((info) => info.kind !== "other");
+  const candidates = composition === "intersection" && concrete.length > 0 ? concrete : present;
+  const first = candidates[0];
+  if (!first)
+    return;
+  if (candidates.every((info) => info.kind === first.kind)) {
+    const elementKind = first.kind === "array" ? candidates.every((info) => info.elementKind === first.elementKind) ? first.elementKind : "other" : undefined;
+    return {
+      kind: first.kind,
+      ...elementKind && { elementKind },
+      ...first.integer && candidates.every((info) => info.integer) && { integer: true }
+    };
+  }
+  return candidates.some((info) => info.kind === "boolean") ? { kind: "boolean" } : { kind: "other" };
+}
+function pathInfo(schema, path) {
+  const guarded = jsonSchemaObjectCoercionMembers(schema);
+  if (guarded) {
+    return mergePathInfos(guarded.map((member) => pathInfo(member, path)), "intersection");
+  }
+  const base = unwrap(schema);
+  if (base !== schema)
+    return pathInfo(base, path);
+  if (base instanceof z.ZodUnion) {
+    return mergePathInfos(base.def.options.map((member) => pathInfo(member, path)), "union");
+  }
+  if (base instanceof z.ZodIntersection) {
+    return mergePathInfos([pathInfo(base.def.left, path), pathInfo(base.def.right, path)], "intersection");
+  }
+  if (path.length === 0)
+    return infoOf(base);
+  const [name, ...rest] = path;
+  if (name === undefined)
+    return infoOf(base);
+  if (base instanceof z.ZodObject) {
+    const member = base.shape[name] ?? base.def.catchall;
+    return member ? pathInfo(member, rest) : undefined;
+  }
+  if (base instanceof z.ZodRecord)
+    return pathInfo(base.valueType, rest);
+  return;
+}
+function describeSchemaPath(schema, path) {
+  if (!schema || path.length === 0)
+    return;
+  return pathInfo(schema, path);
+}
 var TRUE_WORDS = new Set(["true", "1", "yes", "on"]);
 var FALSE_WORDS = new Set(["false", "0", "no", "off"]);
 function separateBoolValue(next) {
@@ -329,8 +401,8 @@ function looseCoerce(value) {
     return true;
   if (value === "false")
     return false;
-  const n = Number(value);
-  return value.trim() !== "" && !Number.isNaN(n) ? n : value;
+  const number = Number(value);
+  return value.trim() !== "" && !Number.isNaN(number) ? number : value;
 }
 function looksLikeJson(value) {
   const t = value.trim();
@@ -840,7 +912,7 @@ function resolveCliView(flags, ascending) {
 }
 
 // src/tools/cli/args.ts
-function readCliTokens(argv, fields, config) {
+function readCliTokens(argv, fields, fieldFor, config) {
   const options = {
     json: false,
     wait: false,
@@ -855,7 +927,7 @@ function readCliTokens(argv, fields, config) {
   let ascending = false;
   const positionals = [];
   const pushFlag = (name, value) => {
-    appendCliOptionValue(flags, name, value, fields.get(name));
+    appendCliOptionValue(flags, name, value, fieldFor(name));
   };
   let optionsEnded = false;
   for (let i = 0;i < argv.length; i++) {
@@ -881,7 +953,7 @@ function readCliTokens(argv, fields, config) {
       if (!alias || !field)
         throw new CliArgumentError2(`Unknown option "${tok}"`);
       const inline = match?.[2];
-      const info = fields.get(field);
+      const info = fieldFor(field);
       if (info?.kind === "boolean") {
         const separate = inline === undefined ? separateBoolValue(argv[i + 1]) : undefined;
         if (separate !== undefined)
@@ -958,7 +1030,7 @@ function readCliTokens(argv, fields, config) {
       }
       continue;
     }
-    if (value === undefined && name.startsWith("no-") && fields.get(name.slice(3))?.kind === "boolean") {
+    if (value === undefined && name.startsWith("no-") && fieldFor(name.slice(3))?.kind === "boolean") {
       pushFlag(name.slice(3), "false");
       literalBooleanFlags.add(name.slice(3));
       continue;
@@ -967,7 +1039,7 @@ function readCliTokens(argv, fields, config) {
     if (unsafeSegment !== undefined) {
       throw new CliArgumentError2(`Unsafe option name "--${name}"`);
     }
-    const info = fields.get(name);
+    const info = fieldFor(name);
     const rootName = name.split(".")[0] ?? name;
     if (!fields.has(rootName) && !config.allowUnknown) {
       throw new CliArgumentError2(`Unknown option "--${name}"`);
@@ -993,7 +1065,7 @@ function readCliTokens(argv, fields, config) {
   }
   return { options, flags, literalBooleanFlags, viewFlags, ascending, positionals };
 }
-function buildToolArgs(tokens, fields, declaredPositionals) {
+function buildToolArgs(tokens, fields, fieldFor, declaredPositionals, allowUnknown) {
   const { flags, literalBooleanFlags, positionals } = tokens;
   const toolArgs = {};
   const fillable = declaredPositionals === undefined ? [...fields.entries()].filter(([, info]) => info.kind !== "boolean").map(([name]) => name) : [...declaredPositionals];
@@ -1023,7 +1095,8 @@ function buildToolArgs(tokens, fields, declaredPositionals) {
   const dottedRoots = new Map;
   for (const key of flags.keys()) {
     const dot = key.indexOf(".");
-    if (dot > 0 && !literalBooleanFlags.has(key)) {
+    const exactLiteralBoolean = literalBooleanFlags.has(key) && fields.has(key);
+    if (dot > 0 && !exactLiteralBoolean) {
       dottedRoots.set(key.slice(0, dot), key);
     }
   }
@@ -1033,9 +1106,12 @@ function buildToolArgs(tokens, fields, declaredPositionals) {
     }
   }
   for (const [key, values] of flags) {
-    const info = fields.get(key);
-    if (key.includes(".") && !literalBooleanFlags.has(key)) {
-      setNested(toolArgs, key.split("."), looseCoerce(values[0] ?? ""));
+    const info = fieldFor(key);
+    const exactLiteralBoolean = literalBooleanFlags.has(key) && fields.has(key);
+    if (key.includes(".") && !exactLiteralBoolean) {
+      const root = key.split(".")[0] ?? key;
+      const value = info === undefined && allowUnknown && !fields.has(root) ? looseCoerce(values[0] ?? "") : coerceField(info, values, `--${key}`);
+      setNested(toolArgs, key.split("."), value);
       continue;
     }
     toolArgs[key] = coerceField(info, values, `--${key}`);
@@ -1048,12 +1124,16 @@ function parseCliArgs2(argv, schema, config = {}) {
     if (!fields.has(name))
       fields.set(name, { kind: "other" });
   }
-  const tokens = readCliTokens(argv, fields, config);
+  const fieldFor = (name) => fields.get(name) ?? (name.includes(".") ? describeSchemaPath(schema, name.split(".")) : undefined);
+  const tokens = readCliTokens(argv, fields, fieldFor, config);
   const { options } = tokens;
   const view = resolveCliView(tokens.viewFlags, tokens.ascending);
   if (view)
     options.view = view;
-  return { toolArgs: buildToolArgs(tokens, fields, config.positionals), options };
+  return {
+    toolArgs: buildToolArgs(tokens, fields, fieldFor, config.positionals, config.allowUnknown === true),
+    options
+  };
 }
 function refuseGlobalOption(issue) {
   const field = issue?.path[0];

package/dist/{index-h7qms8f9.js → index-68y3n9j3.js}

@@ -2,18 +2,18 @@ import {
   toolResultFromError,
   toolCauseFromResult,
   isToolExecutionControlError2
-} from "./index-dm2fv45z.js";
+} from "./index-k4v2kq4q.js";
 import {
   createToolRunner,
   formatToolError
-} from "./index-2s6fpehp.js";
+} from "./index-ryv32myz.js";
 import {
   AgentToolError2,
   resolveToolDurability
 } from "./index-c17xcx4k.js";
 import {
   collectToolSurface
-} from "./index-cx2nh595.js";
+} from "./index-3wm2xp2a.js";
 import {
   agentPresenterOf
 } from "./index-636mggad.js";

package/dist/{index-6yxhe58g.js → index-cykxpxz5.js}

@@ -1,3 +1,6 @@
+import {
+  jsonSchemaObjectCoercionMembers
+} from "./index-t5sjh517.js";
 import {
   safeJsonParse
 } from "./index-zsarb5xp.js";
@@ -76,6 +79,10 @@ function coerceValue(value, schema, path) {
   if (schema instanceof z.ZodOptional || schema instanceof z.ZodNullable || schema instanceof z.ZodDefault) {
     return coerceValue(value, schema.unwrap(), path);
   }
+  const guardedMembers = jsonSchemaObjectCoercionMembers(schema);
+  if (guardedMembers) {
+    return guardedMembers.reduce((current, member) => coerceValue(current, member, path), value);
+  }
   let current = value;
   if (typeof current === "string" && needsJsonCoercion(schema)) {
     if (acceptsRawString(schema)) {

package/dist/{index-p5kx5vqd.js → index-e32vy8jw.js}

@@ -13,7 +13,7 @@ import {
   uploadProgressRoute,
   withUploadProgress,
   parseApiErrorBody
-} from "./index-7jvwrjqa.js";
+} from "./index-00v1qz76.js";
 import {
   abortReason,
   untilAborted
@@ -702,23 +702,33 @@ function createFetchExecutor(endpoint, prefix, config, contractConfig) {
     const cancellation = streamAbort ? {
       signal: requestSignal,
       async run(operation) {
-        let timedOut = false;
+        let origin;
+        const abortFromCaller = () => {
+          origin ??= "caller";
+        };
+        if (options?.signal?.aborted)
+          abortFromCaller();
+        else
+          options?.signal?.addEventListener("abort", abortFromCaller, { once: true });
         const timer = setTimeout(() => {
-          timedOut = true;
+          if (origin)
+            return;
+          origin = "timeout";
           streamAbort.abort(new DOMException("Request timed out", "TimeoutError"));
         }, openTimeoutMs);
         try {
-          if (options?.signal?.aborted)
-            throw new RequestCancellationError("caller");
+          if (origin === "caller")
+            throw new RequestCancellationError(origin);
           return await operation(requestSignal);
         } catch (error) {
-          if (timedOut)
-            throw new RequestCancellationError("timeout");
-          if (options?.signal?.aborted)
-            throw new RequestCancellationError("caller");
+          if (error instanceof RequestCancellationError)
+            throw error;
+          if (origin)
+            throw new RequestCancellationError(origin, error);
           throw error;
         } finally {
           clearTimeout(timer);
+          options?.signal?.removeEventListener("abort", abortFromCaller);
         }
       }
     } : createRequestCancellation(requestSignal, openTimeoutMs);
@@ -758,9 +768,10 @@ function createFetchExecutor(endpoint, prefix, config, contractConfig) {
       });
     } catch (error) {
       if (error instanceof RequestCancellationError) {
-        throw new ApiError2(error.cause === "caller" ? "REQUEST_ABORTED" : "REQUEST_TIMEOUT", {
+        throw new ApiError2(error.origin === "caller" ? "REQUEST_ABORTED" : "REQUEST_TIMEOUT", {
           status: 0,
-          message: error.message
+          message: error.message,
+          ...error.cause !== undefined && { cause: error.cause }
         });
       }
       if (ApiError2.is(error))

package/dist/{index-dm2fv45z.js → index-k4v2kq4q.js}

@@ -4,7 +4,7 @@ import {
 } from "./index-fynr93w4.js";
 import {
   coerceJsonArgs2
-} from "./index-6yxhe58g.js";
+} from "./index-cykxpxz5.js";
 import {
   applyToolViewDefaults,
   projectToolView,

package/dist/{index-6y9t2fwz.js → index-kvvpw1kq.js}

@@ -3,11 +3,11 @@ import {
 } from "./index-q6crhe1n.js";
 import {
   toolErrorFromResult
-} from "./index-dm2fv45z.js";
+} from "./index-k4v2kq4q.js";
 import {
   collectTools2,
   createToolRunner
-} from "./index-2s6fpehp.js";
+} from "./index-ryv32myz.js";
 import {
   AppError2
 } from "./index-j9gxbztg.js";

package/dist/{index-2s6fpehp.js → index-ryv32myz.js}

@@ -7,7 +7,7 @@ import {
 import {
   toolErrorFromResult,
   executeToolMethod
-} from "./index-dm2fv45z.js";
+} from "./index-k4v2kq4q.js";
 import {
   isRetryableStatus2
 } from "./index-j9gxbztg.js";