@procedures/mcp 0.0.0-stage → 0.2.0

package/dist/mapping/path-encoder.js

@@ -0,0 +1,93 @@
+/**
+ * Path Encoder
+ *
+ * Converts procedure paths to/from MCP tool names.
+ * MCP tool names should be valid identifiers (alphanumeric with dots/underscores).
+ */
+/**
+ * Encode a procedure path to an MCP tool name.
+ *
+ * Strategy: Join path segments with dots.
+ * Most procedure paths are already MCP-compatible (lowercase, alphanumeric).
+ *
+ * @param path - Procedure path array
+ * @returns MCP tool name string
+ *
+ * @example
+ * encodePath(["fs", "read"]) // "fs.read"
+ * encodePath(["mongo", "collections", "list"]) // "mongo.collections.list"
+ */
+export function encodePath(path) {
+    return path.join(".");
+}
+/**
+ * Decode an MCP tool name back to procedure path.
+ *
+ * @param toolName - MCP tool name string
+ * @returns Procedure path array
+ *
+ * @example
+ * decodePath("fs.read") // ["fs", "read"]
+ * decodePath("mongo.collections.list") // ["mongo", "collections", "list"]
+ */
+export function decodePath(toolName) {
+    return toolName.split(".");
+}
+/**
+ * Validate that a path segment is MCP-compatible.
+ *
+ * Valid segments:
+ * - Start with letter or underscore
+ * - Contain only letters, numbers, underscores, hyphens
+ *
+ * @param segment - Path segment to validate
+ * @returns True if segment is valid for MCP tool names
+ */
+export function isValidPathSegment(segment) {
+    return /^[a-zA-Z_][a-zA-Z0-9_-]*$/.test(segment);
+}
+/**
+ * Validate that an entire path is MCP-compatible.
+ *
+ * @param path - Procedure path to validate
+ * @returns True if all segments are valid
+ */
+export function isValidPath(path) {
+    return path.length > 0 && path.every(isValidPathSegment);
+}
+/**
+ * Sanitize a path segment for MCP compatibility.
+ *
+ * Replaces invalid characters with underscores.
+ *
+ * @param segment - Path segment to sanitize
+ * @returns Sanitized segment
+ *
+ * @example
+ * sanitizePathSegment("my-func") // "my-func" (valid)
+ * sanitizePathSegment("123abc") // "_123abc" (prefix if starts with number)
+ * sanitizePathSegment("my.func") // "my_func" (replace dots)
+ */
+export function sanitizePathSegment(segment) {
+    // Replace invalid chars with underscores
+    let sanitized = segment.replace(/[^a-zA-Z0-9_-]/g, "_");
+    // Prefix if starts with number
+    if (/^[0-9]/.test(sanitized)) {
+        sanitized = "_" + sanitized;
+    }
+    // Ensure not empty
+    if (!sanitized) {
+        sanitized = "_";
+    }
+    return sanitized;
+}
+/**
+ * Sanitize an entire path for MCP compatibility.
+ *
+ * @param path - Procedure path to sanitize
+ * @returns Sanitized path
+ */
+export function sanitizePath(path) {
+    return path.map(sanitizePathSegment);
+}
+//# sourceMappingURL=path-encoder.js.map

package/dist/mapping/path-encoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-encoder.js","sourceRoot":"","sources":["../../src/mapping/path-encoder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CAAC,IAAmB;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,OAAO,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAmB;IAC7C,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,yCAAyC;IACzC,IAAI,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IAExD,+BAA+B;IAC/B,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,SAAS,GAAG,GAAG,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,mBAAmB;IACnB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,GAAG,CAAC;IAClB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AACvC,CAAC"}

package/dist/mapping/procedure-to-tool.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Procedure to MCP Tool Mapper
+ *
+ * Converts procedures from PROCEDURE_REGISTRY to MCP tool definitions.
+ */
+import { type AnyProcedure, type ProcedurePath } from "@procedures/client";
+import type { McpTool, McpToolDefinition, McpToolFilter } from "../types.js";
+/**
+ * Convert a single procedure to an MCP tool definition.
+ *
+ * @param procedure - Procedure to convert
+ * @returns MCP tool with procedure metadata
+ */
+export declare function procedureToMcpTool(procedure: AnyProcedure): McpTool;
+/**
+ * Convert an MCP tool to the minimal definition format (for ListToolsRequest).
+ *
+ * @param tool - Full MCP tool with metadata
+ * @returns Minimal tool definition for MCP protocol
+ */
+export declare function toToolDefinition(tool: McpTool): McpToolDefinition;
+/**
+ * Convert multiple procedures to MCP tools.
+ *
+ * Filters out procedures without handlers and applies optional filters.
+ *
+ * @param procedures - Procedures to convert
+ * @param filter - Optional filter options
+ * @returns Array of MCP tools
+ */
+export declare function proceduresToMcpTools(procedures: AnyProcedure[], filter?: McpToolFilter): McpTool[];
+/**
+ * Create a lookup map from tool name to MCP tool.
+ *
+ * @param tools - Array of MCP tools
+ * @returns Map for O(1) lookup by tool name
+ */
+export declare function createToolMap(tools: McpTool[]): Map<string, McpTool>;
+/**
+ * Find a tool by procedure path.
+ *
+ * @param tools - Array or map of MCP tools
+ * @param path - Procedure path to find
+ * @returns Tool if found, undefined otherwise
+ */
+export declare function findToolByPath(tools: McpTool[] | Map<string, McpTool>, path: ProcedurePath): McpTool | undefined;
+//# sourceMappingURL=procedure-to-tool.d.ts.map

package/dist/mapping/procedure-to-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedure-to-tool.d.ts","sourceRoot":"","sources":["../../src/mapping/procedure-to-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAa,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA+B7E;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAsCnE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,CAiBjE;AA2CD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,YAAY,EAAE,EAC1B,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,EAAE,CAKX;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBpE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,IAAI,EAAE,aAAa,GAClB,OAAO,GAAG,SAAS,CAUrB"}

package/dist/mapping/procedure-to-tool.js

@@ -0,0 +1,172 @@
+/**
+ * Procedure to MCP Tool Mapper
+ *
+ * Converts procedures from PROCEDURE_REGISTRY to MCP tool definitions.
+ */
+import { toolHints } from "@procedures/client";
+import { cachedToolInputSchema, cachedToolOutputSchema } from "../schema/tool-schema.js";
+import { encodePath, sanitizePath } from "./path-encoder.js";
+/**
+ * Extract metadata from a procedure.
+ */
+function extractMetadata(procedure) {
+    const meta = procedure.metadata;
+    return {
+        description: meta?.["description"],
+        tags: meta?.["tags"],
+        internal: meta?.["internal"],
+    };
+}
+/**
+ * Convert a single procedure to an MCP tool definition.
+ *
+ * @param procedure - Procedure to convert
+ * @returns MCP tool with procedure metadata
+ */
+export function procedureToMcpTool(procedure) {
+    // Sanitize each path segment (replacing chars outside [A-Za-z0-9_-], e.g. a
+    // literal "." inside a single segment) before dot-joining. This keeps the
+    // dot-joined shape valid segments already have (["shell","run"] -> "shell.run",
+    // which the Claude client aliases to "shell_run"), while ensuring two distinct
+    // paths that would otherwise encode to the same string no longer collide.
+    const toolName = encodePath(sanitizePath(procedure.path));
+    const cacheKey = procedure.path.join(".");
+    const meta = extractMetadata(procedure);
+    const tool = {
+        name: toolName,
+        description: meta.description ?? `Call ${cacheKey}`,
+        inputSchema: cachedToolInputSchema(procedure.input, cacheKey),
+        procedurePath: procedure.path,
+    };
+    // MCP structured output: only an output whose JSON Schema is an object
+    const outputSchema = cachedToolOutputSchema(procedure.output);
+    if (outputSchema !== undefined) {
+        tool.outputSchema = outputSchema;
+    }
+    // The hints of the tool, from the declared effects (CAPABILITIES-2026-10)
+    const hints = toolHints(procedure);
+    if (Object.keys(hints).length > 0) {
+        tool.annotations = { ...hints };
+    }
+    // Only add optional properties if they have values
+    if (procedure.streaming !== undefined) {
+        tool.streaming = procedure.streaming;
+    }
+    if (meta.tags !== undefined) {
+        tool.tags = meta.tags;
+    }
+    return tool;
+}
+/**
+ * Convert an MCP tool to the minimal definition format (for ListToolsRequest).
+ *
+ * @param tool - Full MCP tool with metadata
+ * @returns Minimal tool definition for MCP protocol
+ */
+export function toToolDefinition(tool) {
+    const def = {
+        name: tool.name,
+        inputSchema: tool.inputSchema,
+    };
+    if (tool.description !== undefined) {
+        def.description = tool.description;
+    }
+    if (tool.outputSchema !== undefined) {
+        def.outputSchema = tool.outputSchema;
+    }
+    if (tool.annotations !== undefined) {
+        def.annotations = tool.annotations;
+    }
+    return def;
+}
+/**
+ * Check if a procedure matches the given filter.
+ */
+function matchesFilter(procedure, filter) {
+    if (!filter)
+        return true;
+    const meta = extractMetadata(procedure);
+    // Check internal filter
+    if (filter.excludeInternal !== false && meta.internal) {
+        return false;
+    }
+    // Check the include function
+    if (filter.include && !filter.include(procedure.path)) {
+        return false;
+    }
+    // Check path prefix
+    if (filter.pathPrefix) {
+        const matches = filter.pathPrefix.every((segment, i) => procedure.path[i] === segment);
+        if (!matches)
+            return false;
+    }
+    // Check tag inclusion
+    if (filter.includeTags?.length) {
+        const hasTags = meta.tags?.some((t) => filter.includeTags.includes(t));
+        if (!hasTags)
+            return false;
+    }
+    // Check tag exclusion
+    if (filter.excludeTags?.length) {
+        const hasExcludedTag = meta.tags?.some((t) => filter.excludeTags.includes(t));
+        if (hasExcludedTag)
+            return false;
+    }
+    return true;
+}
+/**
+ * Convert multiple procedures to MCP tools.
+ *
+ * Filters out procedures without handlers and applies optional filters.
+ *
+ * @param procedures - Procedures to convert
+ * @param filter - Optional filter options
+ * @returns Array of MCP tools
+ */
+export function proceduresToMcpTools(procedures, filter) {
+    return procedures
+        .filter((p) => p.handler !== undefined)
+        .filter((p) => matchesFilter(p, filter))
+        .map(procedureToMcpTool);
+}
+/**
+ * Create a lookup map from tool name to MCP tool.
+ *
+ * @param tools - Array of MCP tools
+ * @returns Map for O(1) lookup by tool name
+ */
+export function createToolMap(tools) {
+    const map = new Map();
+    for (const tool of tools) {
+        const existing = map.get(tool.name);
+        if (existing !== undefined) {
+            // Two distinct procedure paths encoded to the same MCP tool name. The
+            // Map preserves last-wins semantics (for backward compatibility), but
+            // this silently shadowed a tool before — warn on stderr so the collision
+            // is visible. stderr is used because stdout is reserved for the MCP
+            // stdio protocol stream.
+            console.error(`[mcp] Tool-name collision: "${tool.name}" is produced by both ` +
+                `[${existing.procedurePath.join(", ")}] and ` +
+                `[${tool.procedurePath.join(", ")}]; keeping the latter (last-wins).`);
+        }
+        map.set(tool.name, tool);
+    }
+    return map;
+}
+/**
+ * Find a tool by procedure path.
+ *
+ * @param tools - Array or map of MCP tools
+ * @param path - Procedure path to find
+ * @returns Tool if found, undefined otherwise
+ */
+export function findToolByPath(tools, path) {
+    // Must match the sanitization applied in procedureToMcpTool so lookups by
+    // path resolve to the same tool name that was stored.
+    const toolName = encodePath(sanitizePath(path));
+    if (tools instanceof Map) {
+        return tools.get(toolName);
+    }
+    return tools.find((t) => t.name === toolName);
+}
+//# sourceMappingURL=procedure-to-tool.js.map

package/dist/mapping/procedure-to-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedure-to-tool.js","sourceRoot":"","sources":["../../src/mapping/procedure-to-tool.ts"],"names":[],"mappings":"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"}

package/dist/schema/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Schema utilities exports.
+ */
+export { toolInputSchema, cachedToolInputSchema, toolOutputSchema, cachedToolOutputSchema, zodToJsonSchema, cachedZodToJsonSchema, clearSchemaCache, getSchemaCacheSize, type ZodToJsonSchemaOptions, } from "./tool-schema.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,sBAAsB,GAC5B,MAAM,kBAAkB,CAAC"}

package/dist/schema/index.js

@@ -0,0 +1,5 @@
+/**
+ * Schema utilities exports.
+ */
+export { toolInputSchema, cachedToolInputSchema, toolOutputSchema, cachedToolOutputSchema, zodToJsonSchema, cachedZodToJsonSchema, clearSchemaCache, getSchemaCacheSize, } from "./tool-schema.js";
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GAEnB,MAAM,kBAAkB,CAAC"}

package/dist/schema/tool-schema.d.ts

@@ -0,0 +1,77 @@
+/**
+ * The input JSON Schema of an MCP tool.
+ *
+ * The JSON Schema comes from `jsonSchemaOf()` of the core, which reads any Standard Schema
+ * (zod 4 and other libraries). Before, this file converted schemas with the zod 3 library
+ * `zod-to-json-schema`, and a schema without zod 3 fields got an empty object schema.
+ */
+import { type ProcedureSchema } from "@procedures/client";
+import type { JsonSchema } from "../types.js";
+/**
+ * A schema of a procedure.
+ * @deprecated Use `ProcedureSchema` of `@procedures/client`.
+ */
+export interface SchemaLike {
+    parse?(data: unknown): unknown;
+    safeParse?(data: unknown): {
+        success: boolean;
+        data?: unknown;
+        error?: unknown;
+    };
+}
+/**
+ * Options for the conversion.
+ * @deprecated The options are not used. The core gives draft-07 JSON Schema without definitions.
+ */
+export interface ZodToJsonSchemaOptions {
+    /** Name for the schema (not used) */
+    name?: string;
+    /** Pre-existing definitions (not used) */
+    definitions?: Record<string, unknown>;
+}
+/**
+ * The input JSON Schema of a tool for a procedure schema.
+ *
+ * MCP passes the arguments of a tool as an object, so an input that is not an object (a
+ * pass-through schema, a schema with no JSON Schema, a number) gives an object schema that
+ * accepts any field.
+ */
+export declare function toolInputSchema(schema: ProcedureSchema | unknown): JsonSchema;
+/**
+ * The input JSON Schema of a tool.
+ * @deprecated Use `toolInputSchema` (the schema need not be zod), or `jsonSchemaOf` of
+ * `@procedures/client` for the JSON Schema of any input or output.
+ */
+export declare function zodToJsonSchema(schema: SchemaLike | unknown, _options?: ZodToJsonSchemaOptions): JsonSchema;
+/**
+ * The input JSON Schema of a tool, cached by the schema object.
+ *
+ * @param schema - The input schema of the procedure
+ * @param _cacheKey - Not used any more (kept for compatibility): the schema object is the key
+ */
+export declare function cachedToolInputSchema(schema: ProcedureSchema | unknown, _cacheKey?: string): JsonSchema;
+/**
+ * The output JSON Schema of a tool (MCP structured output), or `undefined`.
+ *
+ * MCP needs an object at the root of an output schema, and a client can check each structured
+ * result against it. So only an output whose JSON Schema is an object gives one: a pass-through
+ * schema, a union (a stream of items) or a number gives none, and the tool gives text only.
+ */
+export declare function toolOutputSchema(schema: ProcedureSchema | unknown): JsonSchema | undefined;
+/** The output JSON Schema of a tool, cached by the schema object. */
+export declare function cachedToolOutputSchema(schema: ProcedureSchema | unknown): JsonSchema | undefined;
+/**
+ * The input JSON Schema of a tool, cached.
+ * @deprecated Use `cachedToolInputSchema`.
+ */
+export declare function cachedZodToJsonSchema(schema: SchemaLike | unknown, cacheKey?: string): JsonSchema;
+/**
+ * Clear the schema cache.
+ * Useful when procedures are re-registered with different schemas.
+ */
+export declare function clearSchemaCache(): void;
+/**
+ * Get the current schema cache size.
+ */
+export declare function getSchemaCacheSize(): number;
+//# sourceMappingURL=tool-schema.d.ts.map

package/dist/schema/tool-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema.d.ts","sourceRoot":"","sources":["../../src/schema/tool-schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IAC/B,SAAS,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAClF;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAKD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,GAAG,UAAU,CAM7E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,EAAE,QAAQ,CAAC,EAAE,sBAAsB,GAAG,UAAU,CAE3G;AAOD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,CAWvG;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAG1F;AAMD,qEAAqE;AACrE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAWhG;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,CAEjG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/schema/tool-schema.js

@@ -0,0 +1,103 @@
+/**
+ * The input JSON Schema of an MCP tool.
+ *
+ * The JSON Schema comes from `jsonSchemaOf()` of the core, which reads any Standard Schema
+ * (zod 4 and other libraries). Before, this file converted schemas with the zod 3 library
+ * `zod-to-json-schema`, and a schema without zod 3 fields got an empty object schema.
+ */
+import { jsonSchemaOf } from "@procedures/client";
+/** The input schema of a tool that takes any arguments. */
+const ANY_OBJECT = { type: "object", additionalProperties: true };
+/**
+ * The input JSON Schema of a tool for a procedure schema.
+ *
+ * MCP passes the arguments of a tool as an object, so an input that is not an object (a
+ * pass-through schema, a schema with no JSON Schema, a number) gives an object schema that
+ * accepts any field.
+ */
+export function toolInputSchema(schema) {
+    const json = jsonSchemaOf(schema, { io: "input" });
+    if (json && json["type"] === "object") {
+        return json;
+    }
+    return { ...ANY_OBJECT };
+}
+/**
+ * The input JSON Schema of a tool.
+ * @deprecated Use `toolInputSchema` (the schema need not be zod), or `jsonSchemaOf` of
+ * `@procedures/client` for the JSON Schema of any input or output.
+ */
+export function zodToJsonSchema(schema, _options) {
+    return toolInputSchema(schema);
+}
+// Schema cache for performance, keyed by the schema object: a procedure that is registered
+// again with a different schema gets the new JSON Schema (BUGS-2026-07 L30: the cache was keyed
+// by the procedure path and returned the old schema)
+const schemaCache = new Map();
+/**
+ * The input JSON Schema of a tool, cached by the schema object.
+ *
+ * @param schema - The input schema of the procedure
+ * @param _cacheKey - Not used any more (kept for compatibility): the schema object is the key
+ */
+export function cachedToolInputSchema(schema, _cacheKey) {
+    if (!schema || typeof schema !== "object") {
+        return toolInputSchema(schema);
+    }
+    const cached = schemaCache.get(schema);
+    if (cached) {
+        return cached;
+    }
+    const jsonSchema = toolInputSchema(schema);
+    schemaCache.set(schema, jsonSchema);
+    return jsonSchema;
+}
+/**
+ * The output JSON Schema of a tool (MCP structured output), or `undefined`.
+ *
+ * MCP needs an object at the root of an output schema, and a client can check each structured
+ * result against it. So only an output whose JSON Schema is an object gives one: a pass-through
+ * schema, a union (a stream of items) or a number gives none, and the tool gives text only.
+ */
+export function toolOutputSchema(schema) {
+    const json = jsonSchemaOf(schema, { io: "output" });
+    return json && json["type"] === "object" ? json : undefined;
+}
+// The output schemas, cached by the schema object like the input schemas. `null` keeps "no
+// output schema", so the check runs once for each schema.
+const outputSchemaCache = new Map();
+/** The output JSON Schema of a tool, cached by the schema object. */
+export function cachedToolOutputSchema(schema) {
+    if (!schema || typeof schema !== "object") {
+        return toolOutputSchema(schema);
+    }
+    const cached = outputSchemaCache.get(schema);
+    if (cached !== undefined) {
+        return cached ?? undefined;
+    }
+    const jsonSchema = toolOutputSchema(schema);
+    outputSchemaCache.set(schema, jsonSchema ?? null);
+    return jsonSchema;
+}
+/**
+ * The input JSON Schema of a tool, cached.
+ * @deprecated Use `cachedToolInputSchema`.
+ */
+export function cachedZodToJsonSchema(schema, cacheKey) {
+    return cachedToolInputSchema(schema, cacheKey);
+}
+/**
+ * Clear the schema cache.
+ * Useful when procedures are re-registered with different schemas.
+ */
+export function clearSchemaCache() {
+    schemaCache.clear();
+    outputSchemaCache.clear();
+}
+/**
+ * Get the current schema cache size.
+ */
+export function getSchemaCacheSize() {
+    return schemaCache.size;
+}
+//# sourceMappingURL=tool-schema.js.map

package/dist/schema/tool-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema.js","sourceRoot":"","sources":["../../src/schema/tool-schema.ts"],"names":[],"mappings":"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"}

package/dist/schema/zod-to-json-schema.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Zod to JSON Schema Converter
+ *
+ * Converts Zod schemas to JSON Schema format for MCP tool inputSchema.
+ * Uses zod-to-json-schema with caching for performance.
+ */
+import type { JsonSchema } from "../types.js";
+/**
+ * Schema interface compatible with Zod.
+ * Allows the system to work without direct Zod dependency.
+ */
+export interface SchemaLike {
+    parse?(data: unknown): unknown;
+    safeParse?(data: unknown): {
+        success: boolean;
+        data?: unknown;
+        error?: unknown;
+    };
+    _def?: unknown;
+}
+/**
+ * Options for Zod to JSON Schema conversion.
+ */
+export interface ZodToJsonSchemaOptions {
+    /** Name for the schema (used in definitions) */
+    name?: string;
+    /** Pre-existing definitions to include */
+    definitions?: Record<string, unknown>;
+}
+/**
+ * Convert a schema to JSON Schema.
+ *
+ * Uses zod-to-json-schema library for actual Zod schemas,
+ * with safe fallbacks for non-Zod implementations.
+ *
+ * @param schema - Schema to convert (Zod or ZodLike)
+ * @param options - Conversion options
+ * @returns JSON Schema representation
+ */
+export declare function zodToJsonSchema(schema: SchemaLike | unknown, options?: ZodToJsonSchemaOptions): JsonSchema;
+/**
+ * Convert a schema to JSON Schema with caching.
+ *
+ * @param schema - Schema to convert (Zod or ZodLike)
+ * @param _cacheKey - Not used any more (kept for compatibility): the schema object is the key
+ * @returns Cached or freshly converted JSON Schema
+ */
+export declare function cachedZodToJsonSchema(schema: SchemaLike | unknown, _cacheKey?: string): JsonSchema;
+/**
+ * Clear the schema cache.
+ * Useful when procedures are re-registered with different schemas.
+ */
+export declare function clearSchemaCache(): void;
+/**
+ * Get the current schema cache size.
+ */
+export declare function getSchemaCacheSize(): number;
+//# sourceMappingURL=zod-to-json-schema.d.ts.map

package/dist/schema/zod-to-json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-json-schema.d.ts","sourceRoot":"","sources":["../../src/schema/zod-to-json-schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IAC/B,SAAS,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACjF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,GAAG,OAAO,EAC5B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,UAAU,CA0BZ;AAOD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,GAAG,OAAO,EAC5B,SAAS,CAAC,EAAE,MAAM,GACjB,UAAU,CAaZ;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}