@tetral-ai/sdk 0.110.0-alpha.1

package/helpers/beta/mcp.mjs

@@ -0,0 +1,406 @@
+/**
+ * Helper functions for integrating MCP (Model Context Protocol) SDK types
+ * with the Anthropic SDK.
+ *
+ * These helpers reduce boilerplate when converting between MCP types and
+ * Anthropic API types. The interfaces defined here use TypeScript's structural
+ * typing to match MCP SDK types without requiring a direct dependency.
+ */
+import { ToolError } from "../../lib/tools/ToolError.mjs";
+import { SDK_HELPER_SYMBOL, collectStainlessHelpers, stainlessHelperHeader, } from "../../internal/stainless-helper-header.mjs";
+import { fromBase64 } from "../../internal/utils/base64.mjs";
+export { SDK_HELPER_SYMBOL, collectStainlessHelpers, stainlessHelperHeader };
+// -----------------------------------------------------------------------------
+// Supported MIME types
+// -----------------------------------------------------------------------------
+const SUPPORTED_IMAGE_TYPES = ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
+function isSupportedImageType(mimeType) {
+    return SUPPORTED_IMAGE_TYPES.includes(mimeType);
+}
+function isSupportedResourceMimeType(mimeType) {
+    return (!mimeType ||
+        mimeType.startsWith('text/') ||
+        mimeType === 'application/pdf' ||
+        isSupportedImageType(mimeType));
+}
+// -----------------------------------------------------------------------------
+// Error classes
+// -----------------------------------------------------------------------------
+/**
+ * Error thrown when an MCP value cannot be converted to a format supported by the Claude API.
+ */
+export class UnsupportedMCPValueError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'UnsupportedMCPValueError';
+    }
+}
+// -----------------------------------------------------------------------------
+// Helper functions
+// -----------------------------------------------------------------------------
+/**
+ * Converts an MCP tool to a BetaRunnableTool for use with the Anthropic SDK's
+ * `toolRunner()` method.
+ *
+ * @param tool The MCP tool definition from `mcpClient.listTools()`
+ * @param mcpClient The MCP client instance used to call the tool
+ * @param extraProps Additional Claude API properties to include in the tool definition
+ * @returns A runnable tool for use with `anthropic.beta.messages.toolRunner()`
+ * @throws {UnsupportedMCPValueError} When the tool returns unsupported content types
+ * @throws {UnsupportedMCPValueError} When the tool returns unsupported resource links
+ * @throws {UnsupportedMCPValueError} When the tool returns resources with unsupported MIME types
+ *
+ * @example
+ * ```ts
+ * import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+ * import Anthropic from "@tetral-ai/sdk";
+ * import { mcpTool } from "@tetral-ai/sdk/helpers/beta/mcp";
+ *
+ * const mcpClient = new Client({ name: "example", version: "1.0.0" });
+ * const anthropic = new Anthropic();
+ *
+ * const tools = await mcpClient.listTools();
+ * const runner = await anthropic.beta.messages.toolRunner({
+ *   model: "claude-sonnet-4-20250514",
+ *   max_tokens: 1024,
+ *   tools: tools.tools.map(tool => mcpTool(tool, mcpClient)),
+ *   messages: [{ role: "user", content: "Use the available tools" }],
+ * });
+ * ```
+ */
+export function mcpTool(tool, mcpClient, extraProps) {
+    // Transform inputSchema to match BetaTool.InputSchema (convert undefined to null)
+    const inputSchema = {
+        ...tool.inputSchema,
+        type: 'object',
+        properties: tool.inputSchema.properties ?? null,
+        required: tool.inputSchema.required ?? null,
+    };
+    const betaTool = {
+        name: tool.name,
+        input_schema: inputSchema,
+        ...(tool.description !== undefined ? { description: tool.description } : {}),
+        ...extraProps,
+    };
+    const runnableTool = {
+        ...betaTool,
+        run: async (input) => {
+            const result = await mcpClient.callTool({
+                name: tool.name,
+                arguments: input,
+            });
+            if (result.isError) {
+                const content = result.content.map((item) => mcpContent(item));
+                throw new ToolError(content);
+            }
+            // If content is empty but structuredContent is present, JSON encode it
+            // Spec: "For backwards compatibility, a tool that returns structured content SHOULD also return the serialized JSON in a TextContent block."
+            // meaning it's not required and cannot be assumed.
+            if (result.content.length === 0 &&
+                // Spec: "Structured content is returned as a JSON object in the structuredContent field of a result."
+                typeof result.structuredContent === 'object' &&
+                result.structuredContent !== null) {
+                return JSON.stringify(result.structuredContent);
+            }
+            return result.content.map((item) => mcpContent(item));
+        },
+        parse: (content) => content,
+        [SDK_HELPER_SYMBOL]: 'mcpTool',
+    };
+    return runnableTool;
+}
+/**
+ * Converts an array of MCP tools to BetaRunnableTools.
+ *
+ * @param tools Array of MCP tool definitions from `mcpClient.listTools()`
+ * @param mcpClient The MCP client instance used to call the tools
+ * @param extraProps Additional Claude API properties to include in each tool definition
+ * @returns An array of runnable tools for use with `anthropic.beta.messages.toolRunner()`
+ *
+ * @example
+ * ```ts
+ * const { tools } = await mcpClient.listTools();
+ * const runner = await anthropic.beta.messages.toolRunner({
+ *   model: "claude-sonnet-4-20250514",
+ *   max_tokens: 1024,
+ *   tools: mcpTools(tools, mcpClient),
+ *   messages: [{ role: "user", content: "Use the available tools" }],
+ * });
+ * ```
+ */
+export function mcpTools(tools, mcpClient, extraProps) {
+    return tools.map((tool) => mcpTool(tool, mcpClient, extraProps));
+}
+/**
+ * Converts an MCP prompt message to an Anthropic BetaMessageParam.
+ *
+ * @param mcpMessage The MCP prompt message from `mcpClient.getPrompt()`
+ * @param extraProps Additional Claude API properties to include in content blocks (e.g., `cache_control`)
+ * @returns A message parameter for use with `anthropic.beta.messages.create()`
+ * @throws {UnsupportedMCPValueError} When the message contains unsupported content types
+ * @throws {UnsupportedMCPValueError} When the message contains unsupported resource links
+ * @throws {UnsupportedMCPValueError} When the message contains resources with unsupported MIME types
+ *
+ * @example
+ * ```ts
+ * import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+ * import Anthropic from "@tetral-ai/sdk";
+ * import { mcpMessage } from "@tetral-ai/sdk/helpers/beta/mcp";
+ *
+ * const mcpClient = new Client({ name: "example", version: "1.0.0" });
+ * const anthropic = new Anthropic();
+ *
+ * const prompt = await mcpClient.getPrompt({
+ *   name: "example-prompt",
+ *   arguments: { arg1: "value" },
+ * });
+ *
+ * await anthropic.beta.messages.create({
+ *   model: "claude-sonnet-4-20250514",
+ *   max_tokens: 1024,
+ *   messages: prompt.messages.map(msg => mcpMessage(msg)),
+ * });
+ * ```
+ */
+export function mcpMessage(mcpMessage, extraProps) {
+    const message = {
+        role: mcpMessage.role,
+        content: [mcpContent(mcpMessage.content, extraProps)],
+        [SDK_HELPER_SYMBOL]: 'mcpMessage',
+    };
+    return message;
+}
+/**
+ * Converts an array of MCP prompt messages to Anthropic BetaMessageParams.
+ *
+ * @param messages Array of MCP prompt messages from `mcpClient.getPrompt()`
+ * @param extraProps Additional Claude API properties to include in content blocks (e.g., `cache_control`)
+ * @returns An array of message parameters for use with `anthropic.beta.messages.create()`
+ * @throws {UnsupportedMCPValueError} When any message contains unsupported content types
+ * @throws {UnsupportedMCPValueError} When any message contains unsupported resource links
+ * @throws {UnsupportedMCPValueError} When any message contains resources with unsupported MIME types
+ *
+ * @example
+ * ```ts
+ * const { messages } = await mcpClient.getPrompt({ name: "example-prompt" });
+ * await anthropic.beta.messages.create({
+ *   model: "claude-sonnet-4-20250514",
+ *   max_tokens: 1024,
+ *   messages: mcpMessages(messages),
+ * });
+ * ```
+ */
+export function mcpMessages(messages, extraProps) {
+    return messages.map((message) => mcpMessage(message, extraProps));
+}
+/**
+ * Converts a single MCP prompt content item to an Anthropic content block.
+ *
+ * @param content The MCP content item (text, image, or embedded resource)
+ * @param extraProps Additional Claude API properties to include in the content block (e.g., `cache_control`)
+ * @returns A Claude content block for use in a message's content array
+ * @throws {UnsupportedMCPValueError} When the content type is not supported (e.g., 'audio')
+ * @throws {UnsupportedMCPValueError} When resource links use non-http/https protocols
+ * @throws {UnsupportedMCPValueError} When resources have unsupported MIME types
+ *
+ * @example
+ * ```ts
+ * const { messages } = await mcpClient.getPrompt({ name: "my-prompt" });
+ * // If you need to mix MCP content with other content:
+ * await anthropic.beta.messages.create({
+ *   model: "claude-sonnet-4-20250514",
+ *   max_tokens: 1024,
+ *   messages: [{
+ *     role: "user",
+ *     content: [
+ *       mcpContent(messages[0].content),
+ *       { type: "text", text: "Additional context" },
+ *     ],
+ *   }],
+ * });
+ * ```
+ */
+export function mcpContent(content, extraProps) {
+    switch (content.type) {
+        case 'text': {
+            const textBlock = {
+                type: 'text',
+                text: content.text,
+                ...extraProps,
+                [SDK_HELPER_SYMBOL]: 'mcpContent',
+            };
+            return textBlock;
+        }
+        case 'image': {
+            if (!isSupportedImageType(content.mimeType)) {
+                throw new UnsupportedMCPValueError(`Unsupported image MIME type: ${content.mimeType}`);
+            }
+            const imageBlock = {
+                type: 'image',
+                source: {
+                    type: 'base64',
+                    data: content.data,
+                    media_type: content.mimeType,
+                },
+                ...extraProps,
+                [SDK_HELPER_SYMBOL]: 'mcpContent',
+            };
+            return imageBlock;
+        }
+        case 'resource':
+            return mcpResourceContentToContentBlock(content.resource, extraProps, 'mcpContent');
+        case 'resource_link':
+        case 'audio':
+            throw new UnsupportedMCPValueError(`Unsupported MCP content type: ${content.type}`);
+        default:
+            // This should never happen as we handle all MCPPromptContentLike types
+            content;
+            throw new UnsupportedMCPValueError(`Unsupported MCP content type: ${content.type}`);
+    }
+}
+/**
+ * Converts a single MCP resource contents item to an Anthropic content block.
+ */
+function mcpResourceContentToContentBlock(resourceContent, extraProps, helperName = 'mcpResourceToContent') {
+    const mimeType = resourceContent.mimeType;
+    // Handle images (requires blob - base64-encoded binary data)
+    if (mimeType && isSupportedImageType(mimeType)) {
+        if (!('blob' in resourceContent)) {
+            throw new UnsupportedMCPValueError(`Image resource must have blob data, not text. URI: ${resourceContent.uri}`);
+        }
+        const imageBlock = {
+            type: 'image',
+            source: {
+                type: 'base64',
+                data: resourceContent.blob,
+                media_type: mimeType,
+            },
+            ...extraProps,
+            [SDK_HELPER_SYMBOL]: helperName,
+        };
+        return imageBlock;
+    }
+    // Handle PDFs (requires blob - base64-encoded binary data)
+    if (mimeType === 'application/pdf') {
+        if (!('blob' in resourceContent)) {
+            throw new UnsupportedMCPValueError(`PDF resource must have blob data, not text. URI: ${resourceContent.uri}`);
+        }
+        const pdfBlock = {
+            type: 'document',
+            source: {
+                type: 'base64',
+                data: resourceContent.blob,
+                media_type: 'application/pdf',
+            },
+            ...extraProps,
+            [SDK_HELPER_SYMBOL]: helperName,
+        };
+        return pdfBlock;
+    }
+    // Handle text types (text/*, or no MIME type defaults to text)
+    if (!mimeType || mimeType.startsWith('text/')) {
+        const textDocBlock = {
+            type: 'document',
+            source: textSourceFromResource(resourceContent),
+            ...extraProps,
+            [SDK_HELPER_SYMBOL]: helperName,
+        };
+        return textDocBlock;
+    }
+    throw new UnsupportedMCPValueError(`Unsupported MIME type "${mimeType}" for resource: ${resourceContent.uri}`);
+}
+/**
+ * Converts MCP resource contents to an Anthropic content block.
+ *
+ * This helper is useful when you have resource contents from `mcpClient.readResource()`
+ * and want to include them in a message or as a document source. It automatically
+ * finds the first resource with a supported MIME type.
+ *
+ * @param result The result from `mcpClient.readResource()`
+ * @param extraProps Additional Claude API properties to include in the content block (e.g., `cache_control`)
+ * @returns A Claude content block
+ * @throws {UnsupportedMCPValueError} When contents array is empty or none have a supported MIME type
+ *
+ * @example
+ * ```ts
+ * import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+ * import Anthropic from "@tetral-ai/sdk";
+ * import { mcpResourceToContent } from "@tetral-ai/sdk/helpers/beta/mcp";
+ *
+ * const mcpClient = new Client({ name: "example", version: "1.0.0" });
+ * const anthropic = new Anthropic();
+ *
+ * const resource = await mcpClient.readResource({ uri: "file:///example.txt" });
+ * await anthropic.beta.messages.create({
+ *   model: "claude-sonnet-4-20250514",
+ *   max_tokens: 1024,
+ *   messages: [{
+ *     role: "user",
+ *     content: [mcpResourceToContent(resource)],
+ *   }],
+ * });
+ * ```
+ */
+export function mcpResourceToContent(result, extraProps) {
+    if (result.contents.length === 0) {
+        throw new UnsupportedMCPValueError('Resource contents array must contain at least one item');
+    }
+    const supported = result.contents.find((c) => isSupportedResourceMimeType(c.mimeType));
+    if (!supported) {
+        const mimeTypes = result.contents.map((c) => c.mimeType).filter((m) => m !== undefined);
+        throw new UnsupportedMCPValueError(`No supported MIME type found in resource contents. Available: ${mimeTypes.join(', ')}`);
+    }
+    return mcpResourceContentToContentBlock(supported, extraProps);
+}
+/**
+ * Gets the raw bytes from an MCP resource.
+ */
+function bytesFromResource(resource) {
+    if ('blob' in resource) {
+        return fromBase64(resource.blob);
+    }
+    return new TextEncoder().encode(resource.text);
+}
+/**
+ * Creates a text document source from an MCP resource, decoding base64 blob to UTF-8 if needed.
+ */
+function textSourceFromResource(resource) {
+    const data = 'text' in resource ? resource.text : new TextDecoder().decode(fromBase64(resource.blob));
+    return { type: 'text', data, media_type: 'text/plain' };
+}
+/**
+ * Converts an MCP resource to a File object suitable for uploading via `anthropic.beta.files.upload()`.
+ *
+ * @param result The result from `mcpClient.readResource()`
+ * @returns A File object for use with `anthropic.beta.files.upload()`
+ * @throws {UnsupportedMCPValueError} When contents array is empty
+ *
+ * @example
+ * ```ts
+ * import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+ * import Anthropic from "@tetral-ai/sdk";
+ * import { mcpResourceToFile } from "@tetral-ai/sdk/helpers/beta/mcp";
+ *
+ * const mcpClient = new Client({ name: "example", version: "1.0.0" });
+ * const anthropic = new Anthropic();
+ *
+ * const resource = await mcpClient.readResource({ uri: "file:///document.pdf" });
+ *
+ * const uploaded = await anthropic.beta.files.upload({
+ *   file: mcpResourceToFile(resource),
+ * });
+ * ```
+ */
+export function mcpResourceToFile(result) {
+    if (result.contents.length === 0) {
+        throw new UnsupportedMCPValueError('Resource contents array must contain at least one item');
+    }
+    const resourceContents = result.contents[0];
+    const name = new URL(resourceContents.uri).pathname.split('/').at(-1) || 'file';
+    const type = resourceContents.mimeType;
+    const data = bytesFromResource(resourceContents);
+    const file = new File([data], name, type ? { type } : undefined);
+    file[SDK_HELPER_SYMBOL] = 'mcpResourceToFile';
+    return file;
+}
+//# sourceMappingURL=mcp.mjs.map

package/helpers/beta/mcp.mjs.map

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

package/helpers/beta/memory.d.mts

@@ -0,0 +1,11 @@
+import { BetaRunnableTool, Promisable } from "../../lib/tools/BetaRunnableTool.mjs";
+import { BetaMemoryTool20250818Command, BetaToolResultContentBlockParam } from "../../resources/beta.mjs";
+type Command = BetaMemoryTool20250818Command['command'];
+export type MemoryToolHandlers = {
+    [K in Command]: (command: Extract<BetaMemoryTool20250818Command, {
+        command: K;
+    }>) => Promisable<string | Array<BetaToolResultContentBlockParam>>;
+};
+export declare function betaMemoryTool(handlers: MemoryToolHandlers): BetaRunnableTool<BetaMemoryTool20250818Command>;
+export {};
+//# sourceMappingURL=memory.d.mts.map

package/helpers/beta/memory.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.mts","sourceRoot":"","sources":["../../src/helpers/beta/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,6CAAyC;AAChF,OAAO,EAAE,6BAA6B,EAAE,+BAA+B,EAAE,iCAA6B;AAEtG,KAAK,OAAO,GAAG,6BAA6B,CAAC,SAAS,CAAC,CAAC;AAExD,MAAM,MAAM,kBAAkB,GAAG;KAC9B,CAAC,IAAI,OAAO,GAAG,CACd,OAAO,EAAE,OAAO,CAAC,6BAA6B,EAAE;QAAE,OAAO,EAAE,CAAC,CAAA;KAAE,CAAC,KAC5D,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,+BAA+B,CAAC,CAAC;CACjE,CAAC;AAEF,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,kBAAkB,GAC3B,gBAAgB,CAAC,6BAA6B,CAAC,CAcjD"}

package/helpers/beta/memory.d.ts

@@ -0,0 +1,11 @@
+import { BetaRunnableTool, Promisable } from "../../lib/tools/BetaRunnableTool.js";
+import { BetaMemoryTool20250818Command, BetaToolResultContentBlockParam } from "../../resources/beta.js";
+type Command = BetaMemoryTool20250818Command['command'];
+export type MemoryToolHandlers = {
+    [K in Command]: (command: Extract<BetaMemoryTool20250818Command, {
+        command: K;
+    }>) => Promisable<string | Array<BetaToolResultContentBlockParam>>;
+};
+export declare function betaMemoryTool(handlers: MemoryToolHandlers): BetaRunnableTool<BetaMemoryTool20250818Command>;
+export {};
+//# sourceMappingURL=memory.d.ts.map

package/helpers/beta/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/helpers/beta/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,4CAAyC;AAChF,OAAO,EAAE,6BAA6B,EAAE,+BAA+B,EAAE,gCAA6B;AAEtG,KAAK,OAAO,GAAG,6BAA6B,CAAC,SAAS,CAAC,CAAC;AAExD,MAAM,MAAM,kBAAkB,GAAG;KAC9B,CAAC,IAAI,OAAO,GAAG,CACd,OAAO,EAAE,OAAO,CAAC,6BAA6B,EAAE;QAAE,OAAO,EAAE,CAAC,CAAA;KAAE,CAAC,KAC5D,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,+BAA+B,CAAC,CAAC;CACjE,CAAC;AAEF,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,kBAAkB,GAC3B,gBAAgB,CAAC,6BAA6B,CAAC,CAcjD"}

package/helpers/beta/memory.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.betaMemoryTool = betaMemoryTool;
+function betaMemoryTool(handlers) {
+    return {
+        type: 'memory_20250818',
+        name: 'memory',
+        parse: (content) => content,
+        run: (args) => {
+            const handler = handlers[args.command];
+            if (!handler) {
+                throw new Error(`${args.command} not implemented`);
+            }
+            return handler.bind(handlers)(args);
+        },
+    };
+}
+//# sourceMappingURL=memory.js.map

package/helpers/beta/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/helpers/beta/memory.ts"],"names":[],"mappings":";;AAWA,wCAgBC;AAhBD,SAAgB,cAAc,CAC5B,QAA4B;IAE5B,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAwC;QAC5D,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE;YACZ,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,kBAAkB,CAAC,CAAC;YACrD,CAAC;YAED,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAW,CAAC,CAAC;QAC7C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/helpers/beta/memory.mjs

@@ -0,0 +1,15 @@
+export function betaMemoryTool(handlers) {
+    return {
+        type: 'memory_20250818',
+        name: 'memory',
+        parse: (content) => content,
+        run: (args) => {
+            const handler = handlers[args.command];
+            if (!handler) {
+                throw new Error(`${args.command} not implemented`);
+            }
+            return handler.bind(handlers)(args);
+        },
+    };
+}
+//# sourceMappingURL=memory.mjs.map

package/helpers/beta/memory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.mjs","sourceRoot":"","sources":["../../src/helpers/beta/memory.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,cAAc,CAC5B,QAA4B;IAE5B,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAwC;QAC5D,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE;YACZ,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,kBAAkB,CAAC,CAAC;YACrD,CAAC;YAED,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAW,CAAC,CAAC;QAC7C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/helpers/beta/zod.d.mts

@@ -0,0 +1,33 @@
+import * as z from 'zod/v4';
+import { AutoParseableBetaOutputFormat } from "../../lib/beta-parser.mjs";
+import { BetaRunnableTool, BetaToolRunContext, Promisable } from "../../lib/tools/BetaRunnableTool.mjs";
+import { BetaToolResultContentBlockParam } from "../../resources/beta.mjs";
+/**
+ * Creates a JSON schema output format object from the given Zod schema.
+ *
+ * If this is passed to the `.parse()` method then the response message will contain a
+ * `.parsed_output` property that is the result of parsing the content with the given Zod object.
+ *
+ * This can be passed directly to the `.create()` method but will not
+ * result in any automatic parsing, you'll have to parse the response yourself.
+ */
+export declare function betaZodOutputFormat<ZodInput extends z.ZodType>(zodObject: ZodInput): AutoParseableBetaOutputFormat<z.infer<ZodInput>>;
+/**
+ * Creates a tool using the provided Zod schema that can be passed
+ * into the `.toolRunner()` method. The Zod schema will automatically be
+ * converted into JSON Schema when passed to the API. The provided function's
+ * input arguments will also be validated against the provided schema.
+ */
+export declare function betaZodTool<InputSchema extends z.ZodType>(options: {
+    name: string;
+    inputSchema: InputSchema;
+    description: string;
+    run: (args: z.infer<InputSchema>, context?: BetaToolRunContext) => Promisable<string | Array<BetaToolResultContentBlockParam>>;
+    /**
+     * Optional cleanup hook for tools that hold process-level resources (e.g. a
+     * persistent shell). `client.beta.sessions.events.toolRunner` calls it once
+     * when iteration ends.
+     */
+    close?: () => void | Promise<void>;
+}): BetaRunnableTool<z.infer<InputSchema>>;
+//# sourceMappingURL=zod.d.mts.map

package/helpers/beta/zod.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.mts","sourceRoot":"","sources":["../../src/helpers/beta/zod.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,6BAA6B,EAAE,kCAA8B;AACtE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,UAAU,EAAE,6CAAyC;AACpG,OAAO,EAAE,+BAA+B,EAAE,iCAA6B;AACvE;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,SAAS,CAAC,CAAC,OAAO,EAC5D,SAAS,EAAE,QAAQ,GAClB,6BAA6B,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAsBlD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,SAAS,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,CACH,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,EAC1B,OAAO,CAAC,EAAE,kBAAkB,KACzB,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;IACjE;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC,GAAG,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAmBzC"}

package/helpers/beta/zod.d.ts

@@ -0,0 +1,33 @@
+import * as z from 'zod/v4';
+import { AutoParseableBetaOutputFormat } from "../../lib/beta-parser.js";
+import { BetaRunnableTool, BetaToolRunContext, Promisable } from "../../lib/tools/BetaRunnableTool.js";
+import { BetaToolResultContentBlockParam } from "../../resources/beta.js";
+/**
+ * Creates a JSON schema output format object from the given Zod schema.
+ *
+ * If this is passed to the `.parse()` method then the response message will contain a
+ * `.parsed_output` property that is the result of parsing the content with the given Zod object.
+ *
+ * This can be passed directly to the `.create()` method but will not
+ * result in any automatic parsing, you'll have to parse the response yourself.
+ */
+export declare function betaZodOutputFormat<ZodInput extends z.ZodType>(zodObject: ZodInput): AutoParseableBetaOutputFormat<z.infer<ZodInput>>;
+/**
+ * Creates a tool using the provided Zod schema that can be passed
+ * into the `.toolRunner()` method. The Zod schema will automatically be
+ * converted into JSON Schema when passed to the API. The provided function's
+ * input arguments will also be validated against the provided schema.
+ */
+export declare function betaZodTool<InputSchema extends z.ZodType>(options: {
+    name: string;
+    inputSchema: InputSchema;
+    description: string;
+    run: (args: z.infer<InputSchema>, context?: BetaToolRunContext) => Promisable<string | Array<BetaToolResultContentBlockParam>>;
+    /**
+     * Optional cleanup hook for tools that hold process-level resources (e.g. a
+     * persistent shell). `client.beta.sessions.events.toolRunner` calls it once
+     * when iteration ends.
+     */
+    close?: () => void | Promise<void>;
+}): BetaRunnableTool<z.infer<InputSchema>>;
+//# sourceMappingURL=zod.d.ts.map

package/helpers/beta/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../src/helpers/beta/zod.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,6BAA6B,EAAE,iCAA8B;AACtE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,UAAU,EAAE,4CAAyC;AACpG,OAAO,EAAE,+BAA+B,EAAE,gCAA6B;AACvE;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,SAAS,CAAC,CAAC,OAAO,EAC5D,SAAS,EAAE,QAAQ,GAClB,6BAA6B,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAsBlD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,SAAS,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,CACH,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,EAC1B,OAAO,CAAC,EAAE,kBAAkB,KACzB,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;IACjE;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC,GAAG,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAmBzC"}

package/helpers/beta/zod.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.betaZodOutputFormat = betaZodOutputFormat;
+exports.betaZodTool = betaZodTool;
+const tslib_1 = require("../../internal/tslib.js");
+const transform_json_schema_1 = require("../..//lib/transform-json-schema.js");
+const z = tslib_1.__importStar(require("zod/v4"));
+const error_1 = require("../../core/error.js");
+/**
+ * Creates a JSON schema output format object from the given Zod schema.
+ *
+ * If this is passed to the `.parse()` method then the response message will contain a
+ * `.parsed_output` property that is the result of parsing the content with the given Zod object.
+ *
+ * This can be passed directly to the `.create()` method but will not
+ * result in any automatic parsing, you'll have to parse the response yourself.
+ */
+function betaZodOutputFormat(zodObject) {
+    let jsonSchema = z.toJSONSchema(zodObject, { reused: 'ref' });
+    jsonSchema = (0, transform_json_schema_1.transformJSONSchema)(jsonSchema);
+    return {
+        type: 'json_schema',
+        schema: {
+            ...jsonSchema,
+        },
+        parse: (content) => {
+            const output = zodObject.safeParse(JSON.parse(content));
+            if (!output.success) {
+                throw new error_1.AnthropicError(`Failed to parse structured output: ${output.error.message} cause: ${output.error.issues}`);
+            }
+            return output.data;
+        },
+    };
+}
+/**
+ * Creates a tool using the provided Zod schema that can be passed
+ * into the `.toolRunner()` method. The Zod schema will automatically be
+ * converted into JSON Schema when passed to the API. The provided function's
+ * input arguments will also be validated against the provided schema.
+ */
+function betaZodTool(options) {
+    const jsonSchema = z.toJSONSchema(options.inputSchema, { reused: 'ref' });
+    if (jsonSchema.type !== 'object') {
+        throw new Error(`Zod schema for tool "${options.name}" must be an object, but got ${jsonSchema.type}`);
+    }
+    // TypeScript doesn't narrow the type after the runtime check, so we need to assert it
+    const objectSchema = jsonSchema;
+    return {
+        type: 'custom',
+        name: options.name,
+        input_schema: objectSchema,
+        description: options.description,
+        run: options.run,
+        parse: (args) => options.inputSchema.parse(args),
+        ...(options.close ? { close: options.close } : {}),
+    };
+}
+//# sourceMappingURL=zod.js.map

package/helpers/beta/zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.js","sourceRoot":"","sources":["../../src/helpers/beta/zod.ts"],"names":[],"mappings":";;AAeA,kDAwBC;AAQD,kCAiCC;;AAhFD,+EAAuE;AACvE,kDAA4B;AAC5B,+CAAkD;AAIlD;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CACjC,SAAmB;IAEnB,IAAI,UAAU,GAAG,CAAC,CAAC,YAAY,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAE9D,UAAU,GAAG,IAAA,2CAAmB,EAAC,UAAU,CAAC,CAAC;IAE7C,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE;YACN,GAAG,UAAU;SACd;QACD,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;YACjB,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAExD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,sBAAc,CACtB,sCAAsC,MAAM,CAAC,KAAK,CAAC,OAAO,WAAW,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAC3F,CAAC;YACJ,CAAC;YAED,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAgC,OAc1D;IACC,MAAM,UAAU,GAAG,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAE1E,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,CAAC,IAAI,gCAAgC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IACzG,CAAC;IAED,sFAAsF;IACtF,MAAM,YAAY,GAAG,UAAoD,CAAC;IAE1E,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,YAAY,EAAE,YAAY;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAyB;QACjF,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnD,CAAC;AACJ,CAAC"}