stitchkit 0.94.0 → 0.94.1

package/dist/{index-gyr48nzg.js → index-k30h66yd.js}

@@ -1,3 +1,6 @@
+import {
+  resolveRouteParamsSchema
+} from "./index-4gcnakhx.js";
 import {
   isUnsafeKey
 } from "./index-kzfs85xp.js";
@@ -38,15 +41,14 @@ function assertToolView(prefix, key, ep) {
   if (project !== undefined && typeof project !== "function") {
     throw new Error(`${where}.project must be a function`);
   }
-  if (output === undefined && project === undefined) {
-    throw new Error(`${where} declares neither output nor project — it would change nothing`);
-  }
   const defaults = view.defaults;
-  if (defaults === undefined)
-    return;
-  if (!isRecord(defaults))
+  if (defaults !== undefined && !isRecord(defaults)) {
     throw new Error(`${where}.defaults must be an object`);
-  const entries = Object.entries(defaults);
+  }
+  const entries = defaults === undefined ? [] : Object.entries(defaults);
+  if (output === undefined && project === undefined && entries.length === 0) {
+    throw new Error(`${where} declares no defaults, output or project — it would change nothing`);
+  }
   if (entries.length === 0)
     return;
   if (!(ep.input instanceof z.ZodObject)) {
@@ -68,143 +70,7 @@ function assertToolView(prefix, key, ep) {
   }
 }
 
-// src/internal/route-pattern.ts
-import { z as z2 } from "zod";
-var PARAM_IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
-function joinRoutePath(...parts) {
-  const joined = parts.filter((part) => Boolean(part)).map((part) => part.replace(/^\/+|\/+$/g, "")).filter(Boolean).join("/");
-  return `/${joined}`;
-}
-function parseRoutePattern(path) {
-  const segments = path.split("/").filter(Boolean);
-  const parameters = [];
-  const names = new Set;
-  for (const [segmentIndex, segment] of segments.entries()) {
-    const marker = segment.at(0);
-    if (marker !== ":" && marker !== "*") {
-      if (segment.includes("*")) {
-        throw new Error(`Wildcard must occupy its own segment in path "${path}"`);
-      }
-      continue;
-    }
-    const name = segment.slice(1);
-    if (marker === "*" && name === "") {
-      throw new Error(`Trailing wildcard in path "${path}" must be named, for example "/*filePath"`);
-    }
-    if (!PARAM_IDENTIFIER.test(name) || isUnsafeKey(name)) {
-      const label = marker === "*" ? "wildcard" : "route parameter";
-      throw new Error(`Invalid ${label} name "${name}" in path "${path}"`);
-    }
-    if (names.has(name)) {
-      throw new Error(`Duplicate route parameter name "${name}" in path "${path}"`);
-    }
-    if (marker === "*" && segmentIndex !== segments.length - 1) {
-      throw new Error(`Wildcard "*${name}" must be the final segment in path "${path}"`);
-    }
-    names.add(name);
-    parameters.push({
-      name,
-      kind: marker === "*" ? "wildcard" : "segment",
-      segmentIndex
-    });
-  }
-  return parameters;
-}
-function resolveRouteParamsSchema(path, schema) {
-  const parameters = parseRoutePattern(path);
-  if (parameters.length === 0)
-    return schema;
-  if (!schema) {
-    const shape = {};
-    for (const parameter of parameters)
-      shape[parameter.name] = z2.string();
-    return z2.object(shape);
-  }
-  const jsonSchema = z2.toJSONSchema(schema, { io: "input", unrepresentable: "any" });
-  const properties = jsonSchema.properties;
-  if (!properties) {
-    throw new Error(`Route params schema for path "${path}" must be an object schema with a property per path field`);
-  }
-  for (const parameter of parameters) {
-    if (!(parameter.name in properties)) {
-      const kind = parameter.kind === "wildcard" ? "wildcard" : "path";
-      throw new Error(`Route params schema for path "${path}" is missing ${kind} field "${parameter.name}"`);
-    }
-  }
-  const names = new Set(parameters.map((parameter) => parameter.name));
-  const required = Array.isArray(jsonSchema.required) ? jsonSchema.required : [];
-  for (const field of required) {
-    if (typeof field === "string" && !names.has(field)) {
-      throw new Error(`Route params schema for path "${path}" requires field "${field}" that the path does not carry`);
-    }
-  }
-  return schema;
-}
-function parseTrailingWildcard(path) {
-  const wildcard = parseRoutePattern(path).find((parameter) => parameter.kind === "wildcard");
-  return wildcard ? { name: wildcard.name, segmentIndex: wildcard.segmentIndex } : null;
-}
-
-// src/contract/define.ts
-var ALL_TRANSPORTS = ["HTTP", "MCP", "AGENT", "CLI"];
-var TOOL_TRANSPORTS = ["MCP", "AGENT", "CLI"];
-function defineContract(meta, endpoints) {
-  const materializedEndpoints = {};
-  for (const [key, endpoint] of Object.entries(endpoints)) {
-    const params = resolveRouteParamsSchema(endpoint.path, endpoint.params);
-    materializedEndpoints[key] = params === endpoint.params ? endpoint : { ...endpoint, params };
-  }
-  const toolTransports = new Map;
-  for (const [key, ep] of Object.entries(materializedEndpoints)) {
-    if (ep.desc.trim() === "") {
-      throw new Error(`Contract "${meta.prefix}": endpoint "${key}" has an empty desc`);
-    }
-    if (ep.maxJsonBodyBytes !== undefined && (!Number.isSafeInteger(ep.maxJsonBodyBytes) || ep.maxJsonBodyBytes <= 0)) {
-      throw new Error(`Contract "${meta.prefix}": endpoint "${key}" maxJsonBodyBytes must be a positive safe integer, received ${ep.maxJsonBodyBytes}`);
-    }
-    if (ep.multipart)
-      assertMultipartEndpoint(meta.prefix, key, ep);
-    if (ep.rawResponse)
-      assertRawEndpoint(meta.prefix, key, ep);
-    if ("stream" in ep)
-      assertStreamingResponseEndpoint(meta.prefix, key, ep);
-    if (ep.method === "HEAD")
-      assertHeadEndpoint(meta.prefix, key, ep);
-    if (ep.rawBody)
-      assertRawBodyEndpoint(meta.prefix, key, ep);
-    if (ep.safelistedBody)
-      assertSafelistedBodyEndpoint(meta.prefix, key, ep);
-    if ("responseMeta" in ep)
-      assertResponseMetaEndpoint(meta.prefix, key, ep);
-    assertNoUngroupedToolOptions(meta.prefix, key, ep);
-    const tool = "tool" in ep ? ep.tool : undefined;
-    if (tool === undefined)
-      continue;
-    if (typeof tool !== "object" || tool === null) {
-      throw new Error(`Contract "${meta.prefix}": endpoint "${key}" tool must be an object`);
-    }
-    const transports = new Set(ep.expose ? ep.expose.filter((t) => t !== "HTTP") : ["MCP", "AGENT"]);
-    if (transports.size === 0) {
-      throw new Error(`Contract "${meta.prefix}": endpoint "${key}" sets tool options but is not exposed on any tool transport (${TOOL_TRANSPORTS.join(" / ")}) — a contract factory with toolExposure 'explicit' makes an omitted expose HTTP-only`);
-    }
-    if (tool.view !== undefined)
-      assertToolView(meta.prefix, key, ep);
-    if (!tool.name)
-      continue;
-    const existing = toolTransports.get(tool.name);
-    if (existing) {
-      for (const t of transports) {
-        if (existing.transports.has(t)) {
-          throw new Error(`Contract "${meta.prefix}": duplicate tool name "${tool.name}" on transport "${t}" (endpoints: "${existing.key}" and "${key}")`);
-        }
-        existing.transports.add(t);
-      }
-    } else {
-      toolTransports.set(tool.name, { key, transports });
-    }
-  }
-  return { meta, endpoints: materializedEndpoints };
-}
+// src/contract/define-validation.ts
 function assertPositiveLimit(where, name, value) {
   if (value !== undefined && (!Number.isSafeInteger(value) || value <= 0)) {
     throw new Error(`${where} ${name} must be a positive safe integer, received ${value}`);
@@ -386,12 +252,66 @@ function assertResponseMetaEndpoint(prefix, key, ep) {
     throw new Error(`${where} is HTTP-only — remove ${nonHttp.join(", ")} from expose`);
   }
 }
-function mergeMeta(contractMeta, endpointMeta) {
-  if (!contractMeta)
-    return endpointMeta;
-  if (!endpointMeta)
-    return { ...contractMeta };
-  return { ...contractMeta, ...endpointMeta };
+
+// src/contract/define.ts
+var ALL_TRANSPORTS = ["HTTP", "MCP", "AGENT", "CLI"];
+var TOOL_TRANSPORTS = ["MCP", "AGENT", "CLI"];
+function defineContract(meta, endpoints) {
+  const materializedEndpoints = {};
+  for (const [key, endpoint] of Object.entries(endpoints)) {
+    const params = resolveRouteParamsSchema(endpoint.path, endpoint.params);
+    materializedEndpoints[key] = params === endpoint.params ? endpoint : { ...endpoint, params };
+  }
+  const toolTransports = new Map;
+  for (const [key, ep] of Object.entries(materializedEndpoints)) {
+    if (ep.desc.trim() === "") {
+      throw new Error(`Contract "${meta.prefix}": endpoint "${key}" has an empty desc`);
+    }
+    if (ep.maxJsonBodyBytes !== undefined && (!Number.isSafeInteger(ep.maxJsonBodyBytes) || ep.maxJsonBodyBytes <= 0)) {
+      throw new Error(`Contract "${meta.prefix}": endpoint "${key}" maxJsonBodyBytes must be a positive safe integer, received ${ep.maxJsonBodyBytes}`);
+    }
+    if (ep.multipart)
+      assertMultipartEndpoint(meta.prefix, key, ep);
+    if (ep.rawResponse)
+      assertRawEndpoint(meta.prefix, key, ep);
+    if ("stream" in ep)
+      assertStreamingResponseEndpoint(meta.prefix, key, ep);
+    if (ep.method === "HEAD")
+      assertHeadEndpoint(meta.prefix, key, ep);
+    if (ep.rawBody)
+      assertRawBodyEndpoint(meta.prefix, key, ep);
+    if (ep.safelistedBody)
+      assertSafelistedBodyEndpoint(meta.prefix, key, ep);
+    if ("responseMeta" in ep)
+      assertResponseMetaEndpoint(meta.prefix, key, ep);
+    assertNoUngroupedToolOptions(meta.prefix, key, ep);
+    const tool = "tool" in ep ? ep.tool : undefined;
+    if (tool === undefined)
+      continue;
+    if (typeof tool !== "object" || tool === null) {
+      throw new Error(`Contract "${meta.prefix}": endpoint "${key}" tool must be an object`);
+    }
+    const transports = new Set(ep.expose ? ep.expose.filter((t) => t !== "HTTP") : ["MCP", "AGENT"]);
+    if (transports.size === 0) {
+      throw new Error(`Contract "${meta.prefix}": endpoint "${key}" sets tool options but is not exposed on any tool transport (${TOOL_TRANSPORTS.join(" / ")}) — a contract factory with toolExposure 'explicit' makes an omitted expose HTTP-only`);
+    }
+    if (tool.view !== undefined)
+      assertToolView(meta.prefix, key, ep);
+    if (!tool.name)
+      continue;
+    const existing = toolTransports.get(tool.name);
+    if (existing) {
+      for (const t of transports) {
+        if (existing.transports.has(t)) {
+          throw new Error(`Contract "${meta.prefix}": duplicate tool name "${tool.name}" on transport "${t}" (endpoints: "${existing.key}" and "${key}")`);
+        }
+        existing.transports.add(t);
+      }
+    } else {
+      toolTransports.set(tool.name, { key, transports });
+    }
+  }
+  return { meta, endpoints: materializedEndpoints };
 }
 
-export { joinRoutePath, resolveRouteParamsSchema, parseTrailingWildcard, withToolView, ALL_TRANSPORTS, TOOL_TRANSPORTS, defineContract, mergeMeta };
+export { withToolView, ALL_TRANSPORTS, TOOL_TRANSPORTS, defineContract };

package/dist/{index-2cr1cqhn.js → index-khtgb21r.js}

@@ -1,13 +1,13 @@
 import {
   executeToolMethod,
   toolErrorFromResult
-} from "./index-j05z5gn4.js";
+} from "./index-55hkhm67.js";
 import {
   assertToolExtensionCompatible,
   mergeSchemas,
   projectToolSurface,
   rebuildObject
-} from "./index-dydjcp8z.js";
+} from "./index-np4m8hd3.js";
 import {
   isRetryableStatus
 } from "./index-2vtcmrj9.js";

package/dist/{index-x4799c19.js → index-ndddxtyx.js}

@@ -1,7 +1,7 @@
 import {
   RealtimeRequestInvalidAcknowledgementError,
   RealtimeRequestRejectedError
-} from "./index-2qzskm8h.js";
+} from "./index-dce5wxcq.js";
 import {
   zodIssues
 } from "./index-p5r7qpdd.js";
@@ -55,15 +55,6 @@ function parseIssues(value) {
   return issues.length > 0 ? issues : undefined;
 }
 
-// src/internal/optional-peer.ts
-function isModuleNotFound(error) {
-  if (typeof error !== "object" || error === null)
-    return false;
-  const code = "code" in error ? error.code : undefined;
-  const message = "message" in error && typeof error.message === "string" ? error.message : "";
-  return code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND" || message.includes("Cannot find module") || message.includes("Cannot find package");
-}
-
 // src/realtime/rejection.ts
 import { z } from "zod";
 function realtimeContractViolation(options) {
@@ -321,4 +312,13 @@ function createValidatedRealtimeSocket({
   };
 }
 
-export { isModuleNotFound, REALTIME_REJECTION_KEY, asRealtimeRejection, parseRealtimeRequestArguments, parseRealtimeRequestAcknowledgement, createValidatedRealtimeSocket };
+// src/internal/optional-peer.ts
+function isModuleNotFound(error) {
+  if (typeof error !== "object" || error === null)
+    return false;
+  const code = "code" in error ? error.code : undefined;
+  const message = "message" in error && typeof error.message === "string" ? error.message : "";
+  return code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND" || message.includes("Cannot find module") || message.includes("Cannot find package");
+}
+
+export { REALTIME_REJECTION_KEY, asRealtimeRejection, parseRealtimeRequestArguments, parseRealtimeRequestAcknowledgement, createValidatedRealtimeSocket, isModuleNotFound };

package/dist/{index-dydjcp8z.js → index-np4m8hd3.js}

@@ -649,42 +649,6 @@ function mergeSchemas(paramsSchema, inputSchema) {
   return paramsObject ? z.intersection(paramsObject, inputSchema) : inputSchema;
 }
 
-// src/tools/mcp/round-policy.ts
-function staticInputRounds(policy) {
-  return Array.isArray(policy.inputRequired) ? policy.inputRequired : undefined;
-}
-function validateMcpRoundPolicy(tool, policy, runtime) {
-  if (!runtime?.stateConfigured) {
-    throw new Error(`[stitchkit] MCP tool "${tool.name}" declares inputRequired but no multiRound.state key is configured`);
-  }
-  const { maxRounds } = runtime;
-  if (!Number.isInteger(maxRounds) || maxRounds < 1) {
-    throw new Error("[stitchkit] multiRound.serving.maxRounds must be a positive integer");
-  }
-  const declared = staticInputRounds(policy);
-  if (!declared)
-    return;
-  if (declared.length === 0) {
-    throw new Error(`[stitchkit] MCP tool "${tool.name}" must declare at least one input round`);
-  }
-  assertRoundShape(tool, declared, maxRounds);
-}
-function validateResolvedInputRounds(tool, resolved, maxRounds) {
-  assertRoundShape(tool, resolved, maxRounds);
-}
-function assertRoundShape(tool, rounds, maxRounds) {
-  if (rounds.length > maxRounds) {
-    throw new Error(`[stitchkit] MCP tool "${tool.name}" declares ${rounds.length} input rounds, exceeding maxRounds ${maxRounds}`);
-  }
-  const keys = new Set;
-  for (const request of rounds) {
-    if (keys.has(request.key)) {
-      throw new Error(`[stitchkit] MCP tool "${tool.name}" declares duplicate input key "${request.key}"`);
-    }
-    keys.add(request.key);
-  }
-}
-
 // src/tools/names.ts
 var SINGULAR_EXCEPTIONS = new Set([
   "analytics",
@@ -976,6 +940,44 @@ function presentationMetadata(schema) {
 
 // src/tools/internal/surface-projector.ts
 import { z as z3 } from "zod";
+
+// src/tools/mcp/round-policy.ts
+function staticInputRounds(policy) {
+  return Array.isArray(policy.inputRequired) ? policy.inputRequired : undefined;
+}
+function validateMcpRoundPolicy(tool, policy, runtime) {
+  if (!runtime?.stateConfigured) {
+    throw new Error(`[stitchkit] MCP tool "${tool.name}" declares inputRequired but no multiRound.state key is configured`);
+  }
+  const { maxRounds } = runtime;
+  if (!Number.isInteger(maxRounds) || maxRounds < 1) {
+    throw new Error("[stitchkit] multiRound.serving.maxRounds must be a positive integer");
+  }
+  const declared = staticInputRounds(policy);
+  if (!declared)
+    return;
+  if (declared.length === 0) {
+    throw new Error(`[stitchkit] MCP tool "${tool.name}" must declare at least one input round`);
+  }
+  assertRoundShape(tool, declared, maxRounds);
+}
+function validateResolvedInputRounds(tool, resolved, maxRounds) {
+  assertRoundShape(tool, resolved, maxRounds);
+}
+function assertRoundShape(tool, rounds, maxRounds) {
+  if (rounds.length > maxRounds) {
+    throw new Error(`[stitchkit] MCP tool "${tool.name}" declares ${rounds.length} input rounds, exceeding maxRounds ${maxRounds}`);
+  }
+  const keys = new Set;
+  for (const request of rounds) {
+    if (keys.has(request.key)) {
+      throw new Error(`[stitchkit] MCP tool "${tool.name}" declares duplicate input key "${request.key}"`);
+    }
+    keys.add(request.key);
+  }
+}
+
+// src/tools/internal/surface-projector.ts
 function assertToolExtensionCompatible(base, extra) {
   if (!(base instanceof z3.ZodObject))
     return;