stitchkit 0.112.2 → 0.112.3

package/CHANGELOG.md

@@ -15,6 +15,13 @@ additive**; the first breaking change landed in 0.10.0. Grep the file for
 
 ## [Unreleased]
 
+## [0.112.3] - 2026-10-26
+
+### Fixed
+
+- `stitchkit/tools/mcp`, `stitchkit/tools/connections` — a tool whose input holds a `z.tuple` is now served as a valid 2020-12 schema: the tuple is written as `prefixItems` (rest as `items`) instead of draft-07's `items` list, which Claude's MCP client refused (`must be object,boolean`) and dropped the tool without a server-side error. The stitchkit MCP client reads a tuple from an older server's document with the same meaning. → ADR 0270
+  **Affects:** `stitchkit/tools/mcp` behaviour; `stitchkit/tools/connections` behaviour
+
 ## [0.112.2] - 2026-10-25
 
 ### Added

package/dist/entrypoints/agent-runtime/coding-tools.js

@@ -1,17 +1,17 @@
 import"../../index-ct75c3at.js";
-import"../../index-h7accrrv.js";
+import"../../index-jgwqc38k.js";
 import"../../index-fynr93w4.js";
 import {
   AgentCodingToolLimitsSchema2,
   AgentCodingToolAuthorizationSchema2,
   AgentCodingToolPathAuthorizationSchema2,
   createAgentCodingTools2
-} from "../../index-n0adphfg.js";
+} from "../../index-dsxrcseb.js";
 import"../../index-2kbysk9s.js";
 import"../../index-84bf5spd.js";
 import"../../index-7r4knwf8.js";
 import"../../index-zrtrjkbf.js";
-import"../../index-ff3agzaf.js";
+import"../../index-nk1mh535.js";
 export {
   AgentCodingToolAuthorizationSchema2 as AgentCodingToolAuthorizationSchema,
   AgentCodingToolLimitsSchema2 as AgentCodingToolLimitsSchema,

package/dist/entrypoints/agent-runtime/harness.js

@@ -5,15 +5,15 @@ import"../../index-8kzct1d6.js";
 import {
   composeAgentPrompt2,
   createAgentRuntime2
-} from "../../index-a0vj9edp.js";
+} from "../../index-b9yqb9e7.js";
 import"../../index-qaet40b2.js";
 import"../../index-mnkk1ffz.js";
 import"../../index-fynr93w4.js";
 import"../../index-epmnrnth.js";
 import"../../index-jy9wq8tp.js";
 import"../../index-ct75c3at.js";
-import"../../index-h7accrrv.js";
-import"../../index-02h0dfpr.js";
+import"../../index-jgwqc38k.js";
+import"../../index-z4ga1fa1.js";
 import"../../index-snef22zr.js";
 import"../../index-56yx8dxp.js";
 import"../../index-jna0ejsa.js";
@@ -29,7 +29,7 @@ import {
 } from "../../index-zrtrjkbf.js";
 import {
   defineRuntimeTool2
-} from "../../index-ff3agzaf.js";
+} from "../../index-nk1mh535.js";
 
 // src/agent-runtime/harness-contract.ts
 import { z } from "zod";

package/dist/entrypoints/agent-runtime/sandbox.js

@@ -3,9 +3,9 @@ import {
   missingSandboxRestrictions2,
   codingRefusal,
   createAgentCodingTools2
-} from "../../index-n0adphfg.js";
+} from "../../index-dsxrcseb.js";
 import"../../index-ct75c3at.js";
-import"../../index-h7accrrv.js";
+import"../../index-jgwqc38k.js";
 import"../../index-fynr93w4.js";
 import"../../index-2kbysk9s.js";
 import {
@@ -25,7 +25,7 @@ import {
 import {
   MAX_TIMER_MS
 } from "../../index-eemvahkc.js";
-import"../../index-ff3agzaf.js";
+import"../../index-nk1mh535.js";
 
 // src/agent-runtime/sandbox-bubblewrap.ts
 import { mkdir as mkdir2, mkdtemp, realpath, rm as rm2 } from "node:fs/promises";

package/dist/entrypoints/agent-runtime/sqlite/bun.js

@@ -1,22 +1,22 @@
 import"../../../index-jna0ejsa.js";
-import"../../../index-38gvr73z.js";
+import"../../../index-f2p949ax.js";
 import"../../../index-8kzct1d6.js";
 import {
   initializeAgentRuntimeSqlite2,
   createSqliteAgentRuntimeStore2
-} from "../../../index-fh2ht88b.js";
+} from "../../../index-c9vpsxw4.js";
 import"../../../index-kqnd6a85.js";
 import"../../../index-5w6t91ze.js";
-import"../../../index-n0adphfg.js";
+import"../../../index-dsxrcseb.js";
 import"../../../index-ct75c3at.js";
-import"../../../index-h7accrrv.js";
+import"../../../index-jgwqc38k.js";
 import"../../../index-fynr93w4.js";
 import"../../../index-2kbysk9s.js";
 import"../../../index-84bf5spd.js";
 import"../../../index-7r4knwf8.js";
 import"../../../index-snef22zr.js";
 import"../../../index-zrtrjkbf.js";
-import"../../../index-ff3agzaf.js";
+import"../../../index-nk1mh535.js";
 
 // src/agent-runtime/sqlite-bun.ts
 import { Database } from "bun:sqlite";

package/dist/entrypoints/agent-runtime/sqlite/node.js

@@ -1,22 +1,22 @@
 import"../../../index-jna0ejsa.js";
-import"../../../index-38gvr73z.js";
+import"../../../index-f2p949ax.js";
 import"../../../index-8kzct1d6.js";
 import {
   initializeAgentRuntimeSqlite2,
   createSqliteAgentRuntimeStore2
-} from "../../../index-fh2ht88b.js";
+} from "../../../index-c9vpsxw4.js";
 import"../../../index-kqnd6a85.js";
 import"../../../index-5w6t91ze.js";
-import"../../../index-n0adphfg.js";
+import"../../../index-dsxrcseb.js";
 import"../../../index-ct75c3at.js";
-import"../../../index-h7accrrv.js";
+import"../../../index-jgwqc38k.js";
 import"../../../index-fynr93w4.js";
 import"../../../index-2kbysk9s.js";
 import"../../../index-84bf5spd.js";
 import"../../../index-7r4knwf8.js";
 import"../../../index-snef22zr.js";
 import"../../../index-zrtrjkbf.js";
-import"../../../index-ff3agzaf.js";
+import"../../../index-nk1mh535.js";
 
 // src/agent-runtime/sqlite-node.ts
 import { DatabaseSync } from "node:sqlite";

package/dist/entrypoints/agent-runtime/testing.js

@@ -10,10 +10,10 @@ import {
   advanceToolChronology
 } from "../../index-jna0ejsa.js";
 import"../../index-5w6t91ze.js";
-import"../../index-n0adphfg.js";
-import"../../index-38gvr73z.js";
+import"../../index-dsxrcseb.js";
+import"../../index-f2p949ax.js";
 import"../../index-ct75c3at.js";
-import"../../index-h7accrrv.js";
+import"../../index-jgwqc38k.js";
 import"../../index-fynr93w4.js";
 import"../../index-2kbysk9s.js";
 import"../../index-84bf5spd.js";
@@ -21,12 +21,12 @@ import"../../index-7r4knwf8.js";
 import"../../index-snef22zr.js";
 import {
   createMemoryAgentRuntimeStore2
-} from "../../index-d4cnhfdn.js";
+} from "../../index-kenvdagc.js";
 import"../../index-zrtrjkbf.js";
 import {
   assertPositiveSafeInteger
 } from "../../index-0s4xebbg.js";
-import"../../index-ff3agzaf.js";
+import"../../index-nk1mh535.js";
 
 // src/agent-runtime/fault-bench.ts
 import { createServer } from "node:http";

package/dist/entrypoints/agent-runtime.js

@@ -5,7 +5,7 @@ import {
   missingSandboxRestrictions2,
   recordAgentSandboxProbe2,
   refuseUnknownSpillReference
-} from "../index-n0adphfg.js";
+} from "../index-dsxrcseb.js";
 import {
   AgentRecordIdSchema2,
   AgentRecordVersionSchema2,
@@ -58,7 +58,7 @@ import {
   AgentHistoryMutationSchema2,
   ACTIVE_AGENT_RUN_STATES2,
   createAgentRuntimeStore2
-} from "../index-38gvr73z.js";
+} from "../index-f2p949ax.js";
 import {
   AgentStoreEventKindSchema2,
   AgentStoreEventEnvelopeSchema2,
@@ -123,7 +123,7 @@ import {
   agentGoalStateSlot2,
   agentTodoStateSlot2,
   createAgentRuntime2
-} from "../index-a0vj9edp.js";
+} from "../index-b9yqb9e7.js";
 import {
   AgentConversationSummarySchema2,
   AgentConversationPageSchema2,
@@ -133,13 +133,13 @@ import"../index-fynr93w4.js";
 import"../index-epmnrnth.js";
 import"../index-jy9wq8tp.js";
 import"../index-ct75c3at.js";
-import"../index-h7accrrv.js";
-import"../index-02h0dfpr.js";
-import"../index-vqdjym30.js";
+import"../index-jgwqc38k.js";
+import"../index-z4ga1fa1.js";
+import"../index-zm1k7hhv.js";
 import {
   mountAgent2,
   buildToolManifest2
-} from "../index-c7h371gr.js";
+} from "../index-5jjda9a4.js";
 import {
   createBoundedSinkManager
 } from "../index-qaet40b2.js";
@@ -191,7 +191,7 @@ import"../index-84bf5spd.js";
 import"../index-7r4knwf8.js";
 import {
   createMemoryAgentRuntimeStore2
-} from "../index-d4cnhfdn.js";
+} from "../index-kenvdagc.js";
 import {
   createAgentRuntimeEventSink2
 } from "../index-616xh7f2.js";
@@ -202,11 +202,11 @@ import {
 import {
   assertPositiveSafeInteger
 } from "../index-0s4xebbg.js";
-import"../index-hvg9hctd.js";
+import"../index-eddzs589.js";
 import {
   defineRuntimeTool2,
   executableAgentRuntimeTools
-} from "../index-ff3agzaf.js";
+} from "../index-nk1mh535.js";
 import {
   createTraceContext2,
   childSpan2

package/dist/entrypoints/cli.js

@@ -16,12 +16,12 @@ import {
   renderCliView2,
   pollUntilDone2,
   createCli2
-} from "../index-bd7spznx.js";
+} from "../index-gpbk7yse.js";
 import"../index-fynr93w4.js";
 import"../index-ct75c3at.js";
-import"../index-h7accrrv.js";
-import"../index-02h0dfpr.js";
-import"../index-vqdjym30.js";
+import"../index-jgwqc38k.js";
+import"../index-z4ga1fa1.js";
+import"../index-zm1k7hhv.js";
 import {
   CliBuildSignatureSchema2,
   cliManifestSigningPayload2,
@@ -44,8 +44,8 @@ import {
 import {
   writeFileAtomicSync2
 } from "../index-07dcf2yn.js";
-import"../index-hvg9hctd.js";
-import"../index-ff3agzaf.js";
+import"../index-eddzs589.js";
+import"../index-nk1mh535.js";
 import {
   safeJsonParse
 } from "../index-zsarb5xp.js";

package/dist/entrypoints/testing.js

@@ -30,7 +30,7 @@ import {
   projectToolSurface,
   mcpProjectionCandidate,
   prepareProjectedMcpTools
-} from "../index-h7accrrv.js";
+} from "../index-jgwqc38k.js";
 import"../index-fynr93w4.js";
 import {
   createClient2,

package/dist/entrypoints/tools/connections.js

@@ -1,8 +1,8 @@
 import"../../index-ct75c3at.js";
 import {
   declaresDraft07,
-  withDefsDialect
-} from "../../index-h7accrrv.js";
+  withDraft2020Keywords
+} from "../../index-jgwqc38k.js";
 import"../../index-fynr93w4.js";
 import {
   markJsonSchemaObjectGuards,
@@ -26,7 +26,7 @@ import {
 } from "../../index-0s4xebbg.js";
 import {
   defineRuntimeTool2
-} from "../../index-ff3agzaf.js";
+} from "../../index-nk1mh535.js";
 import {
   TOOL_ERROR_PROJECTION
 } from "../../index-556g5hsh.js";
@@ -844,7 +844,7 @@ async function withConnectionToken(params, body) {
 function zodObjectFromJsonSchema(schema) {
   if (!schema || Object.keys(schema).length === 0)
     return z.looseObject({});
-  const parsed = z.fromJSONSchema(reconcileDefinitionKeyword(schema));
+  const parsed = z.fromJSONSchema(reconcileDialect(schema));
   if (parsed instanceof z.ZodObject) {
     markJsonSchemaObjectGuards(parsed);
     markRemoteUnionVerdict(parsed);
@@ -852,8 +852,8 @@ function zodObjectFromJsonSchema(schema) {
   }
   return z.looseObject({});
 }
-function reconcileDefinitionKeyword(schema) {
-  return declaresDraft07(schema.$schema) ? schema : withDefsDialect(schema);
+function reconcileDialect(schema) {
+  return declaresDraft07(schema.$schema) ? schema : withDraft2020Keywords(schema);
 }
 function sanitizeToolName(value) {
   return value.replace(/[^a-zA-Z0-9_-]+/g, "_").replace(/^_+|_+$/g, "") || "operation";

package/dist/entrypoints/tools/invoker.js

@@ -2,12 +2,12 @@ import"../../index-fynr93w4.js";
 import"../../index-epmnrnth.js";
 import"../../index-jy9wq8tp.js";
 import"../../index-ct75c3at.js";
-import"../../index-h7accrrv.js";
-import"../../index-02h0dfpr.js";
-import"../../index-vqdjym30.js";
+import"../../index-jgwqc38k.js";
+import"../../index-z4ga1fa1.js";
+import"../../index-zm1k7hhv.js";
 import {
   createToolInvoker2
-} from "../../index-jfk93gja.js";
+} from "../../index-4dh3hfs7.js";
 export {
   createToolInvoker2 as createToolInvoker
 };

package/dist/entrypoints/tools/mcp.js

@@ -2,9 +2,9 @@ import"../../index-ct75c3at.js";
 import"../../index-fynr93w4.js";
 import"../../index-epmnrnth.js";
 import"../../index-jy9wq8tp.js";
-import"../../index-h7accrrv.js";
-import"../../index-02h0dfpr.js";
-import"../../index-vqdjym30.js";
+import"../../index-jgwqc38k.js";
+import"../../index-z4ga1fa1.js";
+import"../../index-zm1k7hhv.js";
 import {
   RESOURCE_MIME_TYPE2,
   EXT_APPS_BUNDLE_PLACEHOLDER2,
@@ -20,9 +20,9 @@ import {
   createMcpHttpRoute2,
   createStdioMcpServer2,
   bindStdioProcessSignals2
-} from "../../index-651xsm48.js";
-import"../../index-hvg9hctd.js";
-import"../../index-ff3agzaf.js";
+} from "../../index-54q2mghq.js";
+import"../../index-eddzs589.js";
+import"../../index-nk1mh535.js";
 export {
   EXT_APPS_BUNDLE_PLACEHOLDER2 as EXT_APPS_BUNDLE_PLACEHOLDER,
   MCP_CATALOG_META_KEY2 as MCP_CATALOG_META_KEY,

package/dist/entrypoints/tools.js

@@ -21,19 +21,19 @@ import {
   findNonPortableFormats2,
   flattenToolJsonSchema2,
   findUntypedProperties2
-} from "../index-h7accrrv.js";
+} from "../index-jgwqc38k.js";
 import {
   ToolExecutionControlError2,
   isToolExecutionControlError2
-} from "../index-02h0dfpr.js";
+} from "../index-z4ga1fa1.js";
 import {
   collectTools2
-} from "../index-vqdjym30.js";
+} from "../index-zm1k7hhv.js";
 import {
   mountAgent2,
   describeToolCatalog2,
   buildToolManifest2
-} from "../index-c7h371gr.js";
+} from "../index-5jjda9a4.js";
 import"../index-m38ej7e5.js";
 import {
   ALL_TRANSPORTS2,
@@ -60,7 +60,7 @@ import {
   createMcpHttpRoute2,
   createStdioMcpServer2,
   bindStdioProcessSignals2
-} from "../index-651xsm48.js";
+} from "../index-54q2mghq.js";
 import {
   AsyncOperationCancelResultSchema2,
   createAsyncOperationSnapshotSchema2,
@@ -74,7 +74,7 @@ import {
   WaitTimeoutError,
   runWaitOperation,
   createCli2
-} from "../index-bd7spznx.js";
+} from "../index-gpbk7yse.js";
 import {
   ManagedFilePathSchema2,
   ManagedFileRefSchema2
@@ -89,7 +89,7 @@ import {
 } from "../index-pzw0fpek.js";
 import {
   createToolInvoker2
-} from "../index-jfk93gja.js";
+} from "../index-4dh3hfs7.js";
 import {
   ManagedFileError2
 } from "../index-2f9r0jgr.js";
@@ -111,14 +111,14 @@ import {
 } from "../index-yk4g8805.js";
 import {
   collectToolSurface
-} from "../index-hvg9hctd.js";
+} from "../index-eddzs589.js";
 import {
   getTraceId2
 } from "../index-r6v4mc67.js";
 import {
   defineRuntimeTool2,
   createRuntimeToolFactory2
-} from "../index-ff3agzaf.js";
+} from "../index-nk1mh535.js";
 import {
   formatZodError2
 } from "../index-1eeqpadm.js";

package/dist/{index-jfk93gja.js → index-4dh3hfs7.js}

@@ -1,13 +1,13 @@
 import {
   assertUniqueToolName
-} from "./index-h7accrrv.js";
+} from "./index-jgwqc38k.js";
 import {
   toolErrorFromResult
-} from "./index-02h0dfpr.js";
+} from "./index-z4ga1fa1.js";
 import {
   collectTools2,
   createToolRunner
-} from "./index-vqdjym30.js";
+} from "./index-zm1k7hhv.js";
 import {
   AppError2
 } from "./index-j9gxbztg.js";

package/dist/{index-651xsm48.js → index-54q2mghq.js}

@@ -8,17 +8,17 @@ import {
   validateResolvedInputRounds,
   presentationMetadata,
   prepareProjectedMcpTools
-} from "./index-h7accrrv.js";
+} from "./index-jgwqc38k.js";
 import {
   parseToolCallArguments,
   toolResultFromError,
   observed
-} from "./index-02h0dfpr.js";
+} from "./index-z4ga1fa1.js";
 import {
   collectTools2,
   createToolRunner,
   formatToolError
-} from "./index-vqdjym30.js";
+} from "./index-zm1k7hhv.js";
 import {
   DEFAULT_CORS_ALLOW_HEADERS2,
   DEFAULT_PROCESS_SIGNALS,
@@ -31,7 +31,7 @@ import {
 } from "./index-e6c2spsd.js";
 import {
   collectToolSurface
-} from "./index-hvg9hctd.js";
+} from "./index-eddzs589.js";
 import {
   runWithRequestContext2,
   getRequestContext2

package/dist/{index-c7h371gr.js → index-5jjda9a4.js}

@@ -2,21 +2,21 @@ import {
   toolResultFromError,
   toolCauseFromResult,
   isToolExecutionControlError2
-} from "./index-02h0dfpr.js";
+} from "./index-z4ga1fa1.js";
 import {
   createToolRunner,
   formatToolError
-} from "./index-vqdjym30.js";
+} from "./index-zm1k7hhv.js";
 import {
   AgentToolError2,
   resolveToolDurability
 } from "./index-56yx8dxp.js";
 import {
   collectToolSurface
-} from "./index-hvg9hctd.js";
+} from "./index-eddzs589.js";
 import {
   agentPresenterOf
-} from "./index-ff3agzaf.js";
+} from "./index-nk1mh535.js";
 import {
   isRecord
 } from "./index-9jfdm5tg.js";

package/dist/{index-a0vj9edp.js → index-b9yqb9e7.js}

@@ -14,7 +14,7 @@ import {
 import {
   ToolExecutionControlError2,
   isToolExecutionControlError2
-} from "./index-02h0dfpr.js";
+} from "./index-z4ga1fa1.js";
 import {
   agentDurableEventId2
 } from "./index-mnkk1ffz.js";

package/dist/{index-fh2ht88b.js → index-c9vpsxw4.js}

@@ -19,7 +19,7 @@ import {
   appendEventIn,
   ArchiveProjectionSchema,
   createAgentRuntimeStore2
-} from "./index-38gvr73z.js";
+} from "./index-f2p949ax.js";
 import {
   AgentConversationPageSchema2,
   AgentConversationMessagePageSchema2

package/dist/{index-n0adphfg.js → index-dsxrcseb.js}

@@ -27,7 +27,7 @@ import {
 } from "./index-j4zh647a.js";
 import {
   defineRuntimeTool2
-} from "./index-ff3agzaf.js";
+} from "./index-nk1mh535.js";
 import {
   AppError2,
   forbidden2,

package/dist/{index-hvg9hctd.js → index-eddzs589.js}

@@ -1,12 +1,12 @@
 import {
   projectToolSurface
-} from "./index-h7accrrv.js";
+} from "./index-jgwqc38k.js";
 import {
   contractToolMountable
-} from "./index-vqdjym30.js";
+} from "./index-zm1k7hhv.js";
 import {
   runtimeToolMountable
-} from "./index-ff3agzaf.js";
+} from "./index-nk1mh535.js";
 
 // src/tools/surface.ts
 function collectToolSurface({

package/dist/{index-38gvr73z.js → index-f2p949ax.js}

@@ -4,7 +4,7 @@ import {
   AgentSandboxRestrictionSchema2,
   AgentSandboxGradeSchema2,
   AGENT_CODING_TOOL_NAMES
-} from "./index-n0adphfg.js";
+} from "./index-dsxrcseb.js";
 import {
   AgentRecordIdSchema2,
   AgentRecordVersionSchema2,

package/dist/{index-bd7spznx.js → index-gpbk7yse.js}

@@ -14,15 +14,15 @@ import {
   objectShapeKeys,
   assertUniqueToolName,
   buildToolPresentationSchema
-} from "./index-h7accrrv.js";
+} from "./index-jgwqc38k.js";
 import {
   toolResultFromError,
   toolErrorFromResult
-} from "./index-02h0dfpr.js";
+} from "./index-z4ga1fa1.js";
 import {
   createToolRunner,
   formatToolError
-} from "./index-vqdjym30.js";
+} from "./index-zm1k7hhv.js";
 import {
   fetchGuarded,
   readCapped
@@ -35,7 +35,7 @@ import {
 } from "./index-eemvahkc.js";
 import {
   collectToolSurface
-} from "./index-hvg9hctd.js";
+} from "./index-eddzs589.js";
 import {
   isUnsafeKey,
   safeJsonParse

package/dist/{index-h7accrrv.js → index-jgwqc38k.js}

@@ -763,6 +763,27 @@ import { z as z2 } from "zod";
 var DRAFT_07_MARKER = "draft-07";
 var DRAFT_07_KEYWORD = "definitions";
 var DEFS_KEYWORD = "$defs";
+var SCHEMA_KEYWORDS = [
+  "items",
+  "additionalItems",
+  "additionalProperties",
+  "contains",
+  "propertyNames",
+  "not",
+  "if",
+  "then",
+  "else",
+  "unevaluatedItems",
+  "unevaluatedProperties"
+];
+var SCHEMA_LIST_KEYWORDS = ["allOf", "anyOf", "oneOf", "prefixItems"];
+var SCHEMA_MAP_KEYWORDS = [
+  "properties",
+  "patternProperties",
+  "dependentSchemas",
+  DRAFT_07_KEYWORD,
+  DEFS_KEYWORD
+];
 function declaresDraft07(dialect) {
   return typeof dialect === "string" && dialect.includes(DRAFT_07_MARKER);
 }
@@ -777,12 +798,51 @@ function rewriteDefinitionPointers(value) {
   }
   return rewritten;
 }
-function withDefsDialect(schema) {
-  const definitions = schema[DRAFT_07_KEYWORD];
-  if (!isRecord(definitions) || DEFS_KEYWORD in schema)
+function mapValues(value, rewrite) {
+  if (!isRecord(value))
+    return value;
+  const rewritten = {};
+  for (const [name, child] of Object.entries(value))
+    rewritten[name] = rewrite(child);
+  return rewritten;
+}
+function withPositionalItems(schema) {
+  if (!isRecord(schema))
     return schema;
   const rewritten = {};
-  for (const [key, value] of Object.entries(schema)) {
+  for (const [key, child] of Object.entries(schema)) {
+    if (SCHEMA_KEYWORDS.includes(key))
+      rewritten[key] = withPositionalItems(child);
+    else if (SCHEMA_LIST_KEYWORDS.includes(key) && Array.isArray(child)) {
+      rewritten[key] = child.map(withPositionalItems);
+    } else if (SCHEMA_MAP_KEYWORDS.includes(key)) {
+      rewritten[key] = mapValues(child, withPositionalItems);
+    } else
+      rewritten[key] = child;
+  }
+  const { items, additionalItems } = rewritten;
+  if (!Array.isArray(items))
+    return rewritten;
+  const positional = {};
+  for (const [key, child] of Object.entries(rewritten)) {
+    if (key === "items")
+      positional.prefixItems = items;
+    else if (key !== "additionalItems")
+      positional[key] = child;
+  }
+  if (additionalItems !== undefined)
+    positional.items = additionalItems;
+  return positional;
+}
+function withDraft2020Keywords(schema) {
+  const positional = withPositionalItems(schema);
+  if (!isRecord(positional))
+    return schema;
+  const definitions = positional[DRAFT_07_KEYWORD];
+  if (!isRecord(definitions) || DEFS_KEYWORD in positional)
+    return positional;
+  const rewritten = {};
+  for (const [key, value] of Object.entries(positional)) {
     if (key === DRAFT_07_KEYWORD)
       continue;
     rewritten[key] = rewriteDefinitionPointers(value);
@@ -977,7 +1037,7 @@ function isObjectPresentationSchema(schema) {
   return schema.type === "object" && isRecord(schema.properties);
 }
 function presentationMetadata(schema) {
-  return withDefsDialect(withoutDialect(schema));
+  return withDraft2020Keywords(withoutDialect(schema));
 }
 
 // src/tools/internal/surface-projector.ts
@@ -1244,4 +1304,4 @@ function prepareProjectedMcpTools(tools, config = {}) {
   return prepared;
 }
 
-export { toolSurfaceOutputSchema, applyToolViewDefaults, projectToolView, objectShapeKeys, rebuildObject, mergeSchemas, staticInputRounds, validateMcpRoundPolicy, validateResolvedInputRounds, assertToolName, assertUniqueToolName, PORTABLE_JSON_SCHEMA_FORMATS2, findNonPortableFormats2, declaresDraft07, withDefsDialect, flattenToolJsonSchema2, buildToolPresentationSchema, presentationMetadata, findUntypedProperties2, assertToolExtensionCompatible, projectRuntimeTool, projectToolSurface, mcpProjectionCandidate, prepareProjectedMcpTools };
+export { toolSurfaceOutputSchema, applyToolViewDefaults, projectToolView, objectShapeKeys, rebuildObject, mergeSchemas, staticInputRounds, validateMcpRoundPolicy, validateResolvedInputRounds, assertToolName, assertUniqueToolName, PORTABLE_JSON_SCHEMA_FORMATS2, findNonPortableFormats2, declaresDraft07, withDraft2020Keywords, flattenToolJsonSchema2, buildToolPresentationSchema, presentationMetadata, findUntypedProperties2, assertToolExtensionCompatible, projectRuntimeTool, projectToolSurface, mcpProjectionCandidate, prepareProjectedMcpTools };

package/dist/{index-d4cnhfdn.js → index-kenvdagc.js}

@@ -17,7 +17,7 @@ import {
   replaceMessage,
   ArchiveSpillSchema,
   createAgentRuntimeStore2
-} from "./index-38gvr73z.js";
+} from "./index-f2p949ax.js";
 
 // src/agent-runtime/store-memory.ts
 import { z as z2 } from "zod";

package/dist/{index-ff3agzaf.js → index-nk1mh535.js}

@@ -1,6 +1,6 @@
 import {
   projectRuntimeTool
-} from "./index-h7accrrv.js";
+} from "./index-jgwqc38k.js";
 import {
   isRecord
 } from "./index-9jfdm5tg.js";

package/dist/{index-02h0dfpr.js → index-z4ga1fa1.js}

@@ -12,7 +12,7 @@ import {
   applyToolViewDefaults,
   projectToolView,
   objectShapeKeys
-} from "./index-h7accrrv.js";
+} from "./index-jgwqc38k.js";
 import {
   runWithRequestContext2,
   getRequestContext2

package/dist/{index-vqdjym30.js → index-zm1k7hhv.js}

@@ -3,11 +3,11 @@ import {
   mergeSchemas,
   assertToolExtensionCompatible,
   projectToolSurface
-} from "./index-h7accrrv.js";
+} from "./index-jgwqc38k.js";
 import {
   toolErrorFromResult,
   executeToolMethod
-} from "./index-02h0dfpr.js";
+} from "./index-z4ga1fa1.js";
 import {
   isRetryableStatus2
 } from "./index-j9gxbztg.js";

package/dist/json-schema/dialect.d.ts

@@ -1,17 +1,19 @@
 /** True when a document says, in its own `$schema`, that it is draft-07. */
 export declare function declaresDraft07(dialect: unknown): boolean;
 /**
- * Move a document's top-level `definitions` to `$defs`, carrying its pointers.
+ * Write a document in the keywords of 2020-12, the dialect an MCP client reads
+ * tool schemas in. Two draft-07 keywords mean something else there or nothing:
+ * reusable subschemas move from `definitions` to `$defs` with their pointers,
+ * and a tuple's `items` list becomes `prefixItems`.
  *
- * A JSON Schema document that names one dialect and uses another's keyword is
- * not a style question: a reader registers reusable subschemas from the keyword
- * the dialect declares and then cannot resolve `#/definitions/x` at all. Both
- * halves of this framework met that document — the MCP SDK stamps 2020-12 onto
- * the metadata it is handed, and our own MCP client obeyed the stamp.
+ * A document that names one dialect and uses another's keyword is not a style
+ * question: a reader registers subschemas from the keyword its dialect declares
+ * and cannot resolve `#/definitions/x`, and a reader that validates the schema
+ * itself refuses an `items` list and drops the whole tool.
  *
- * Only the top level moves. A `definitions` deeper in the document may be a
- * property literally called "definitions", and guessing which is worse than
- * leaving it where the author put it.
+ * Only the top-level `definitions` moves. A `definitions` deeper in the
+ * document may be a property literally called "definitions", and guessing which
+ * is worse than leaving it where the author put it.
  */
-export declare function withDefsDialect(schema: Record<string, unknown>): Record<string, unknown>;
+export declare function withDraft2020Keywords(schema: Record<string, unknown>): Record<string, unknown>;
 //# sourceMappingURL=dialect.d.ts.map

package/dist/json-schema/dialect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dialect.d.ts","sourceRoot":"","sources":["../../src/json-schema/dialect.ts"],"names":[],"mappings":"AAQA,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEzD;AAeD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUxF"}
+{"version":3,"file":"dialect.d.ts","sourceRoot":"","sources":["../../src/json-schema/dialect.ts"],"names":[],"mappings":"AAiCA,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEzD;AAmDD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB"}

package/dist/tools/schema/presentation.d.ts

@@ -16,9 +16,10 @@ export declare function isObjectPresentationSchema(schema: ToolPresentationSchem
  * Metadata passed to the Zod identity carrier.
  *
  * The SDK supplies its own dialect and it is 2020-12, so the document has to
- * speak 2020-12: a draft-07 `definitions` block under a 2020-12 `$schema` is a
- * document that says one thing and does another, and a client that believes the
- * stamp cannot resolve a single `#/definitions/...` pointer in it.
+ * speak 2020-12: draft-07 `definitions` under a 2020-12 `$schema` leave every
+ * `#/definitions/...` pointer unresolvable, and a tuple's draft-07 `items` list
+ * is not a schema there, so a client that validates tool schemas drops the tool.
+ * → ADR 0185, ADR 0268.
  */
 export declare function presentationMetadata(schema: ToolPresentationSchema): ToolPresentationSchema;
 //# sourceMappingURL=presentation.d.ts.map

package/dist/tools/schema/presentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../../src/tools/schema/presentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IACzC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAClC,uFAAuF;IACvF,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC9C;AA+KD,+EAA+E;AAC/E,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,sBAAsB,GAC7B,sBAAsB,CAkDxB;AAoCD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAElF;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,sBAAsB,GAAG,sBAAsB,CAE3F"}
+{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../../src/tools/schema/presentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IACzC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAClC,uFAAuF;IACvF,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC9C;AA+KD,+EAA+E;AAC/E,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,sBAAsB,GAC7B,sBAAsB,CAkDxB;AAoCD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAElF;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,sBAAsB,GAAG,sBAAsB,CAE3F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stitchkit",
-  "version": "0.112.2",
+  "version": "0.112.3",
   "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",
@@ -378,6 +378,7 @@
     "@types/react-dom": "^19.3.0",
     "@typescript/typescript6": "^6.0.2",
     "ai": "^7.0.111",
+    "ajv": "^8.20.0",
     "fake-indexeddb": "^6.2.5",
     "google-auth-library": "^11.1.0",
     "grammy": "^1.46.0",