@allternit/gizzi-sdk 1.3.0

package/dist/providers/allternit/helpers/beta/mcp.js

@@ -0,0 +1,406 @@
+/**
+ * Helper functions for integrating MCP (Model Context Protocol) SDK types
+ * with the Allternit SDK.
+ *
+ * These helpers reduce boilerplate when converting between MCP types and
+ * Allternit AI 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';
+import { SDK_HELPER_SYMBOL, collectStainlessHelpers, stainlessHelperHeader, } from '../../lib/stainless-helper-header';
+import { fromBase64 } from '../../internal/utils/base64';
+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 Allternit 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 Allternit 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 Allternit API properties to include in the tool definition
+ * @returns A runnable tool for use with `client.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 Allternit from "@allternit/gizzi-sdk";
+ * import { mcpTool } from "@allternit/gizzi-sdk/helpers/beta/mcp";
+ *
+ * const mcpClient = new Client({ name: "example", version: "1.0.0" });
+ * const allternit = new AllternitAI();
+ *
+ * const tools = await mcpClient.listTools();
+ * const runner = await client.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 Allternit API properties to include in each tool definition
+ * @returns An array of runnable tools for use with `client.beta.messages.toolRunner()`
+ *
+ * @example
+ * ```ts
+ * const { tools } = await mcpClient.listTools();
+ * const runner = await client.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 Allternit BetaMessageParam.
+ *
+ * @param mcpMessage The MCP prompt message from `mcpClient.getPrompt()`
+ * @param extraProps Additional Allternit API properties to include in content blocks (e.g., `cache_control`)
+ * @returns A message parameter for use with `client.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 Allternit from "@allternit/gizzi-sdk";
+ * import { mcpMessage } from "@allternit/gizzi-sdk/helpers/beta/mcp";
+ *
+ * const mcpClient = new Client({ name: "example", version: "1.0.0" });
+ * const allternit = new AllternitAI();
+ *
+ * const prompt = await mcpClient.getPrompt({
+ *   name: "example-prompt",
+ *   arguments: { arg1: "value" },
+ * });
+ *
+ * await client.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 Allternit BetaMessageParams.
+ *
+ * @param messages Array of MCP prompt messages from `mcpClient.getPrompt()`
+ * @param extraProps Additional Allternit API properties to include in content blocks (e.g., `cache_control`)
+ * @returns An array of message parameters for use with `client.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 client.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 Allternit content block.
+ *
+ * @param content The MCP content item (text, image, or embedded resource)
+ * @param extraProps Additional Allternit API properties to include in the content block (e.g., `cache_control`)
+ * @returns A Allternit 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 client.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 Allternit 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 Allternit 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 Allternit API properties to include in the content block (e.g., `cache_control`)
+ * @returns A Allternit 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 Allternit from "@allternit/gizzi-sdk";
+ * import { mcpResourceToContent } from "@allternit/gizzi-sdk/helpers/beta/mcp";
+ *
+ * const mcpClient = new Client({ name: "example", version: "1.0.0" });
+ * const allternit = new AllternitAI();
+ *
+ * const resource = await mcpClient.readResource({ uri: "file:///example.txt" });
+ * await client.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 `client.beta.files.upload()`.
+ *
+ * @param result The result from `mcpClient.readResource()`
+ * @returns A File object for use with `client.beta.files.upload()`
+ * @throws {UnsupportedMCPValueError} When contents array is empty
+ *
+ * @example
+ * ```ts
+ * import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+ * import Allternit from "@allternit/gizzi-sdk";
+ * import { mcpResourceToFile } from "@allternit/gizzi-sdk/helpers/beta/mcp";
+ *
+ * const mcpClient = new Client({ name: "example", version: "1.0.0" });
+ * const allternit = new AllternitAI();
+ *
+ * const resource = await mcpClient.readResource({ uri: "file:///document.pdf" });
+ *
+ * const uploaded = await client.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.js.map

package/dist/providers/allternit/helpers/beta/mcp.js.map

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

package/dist/providers/allternit/helpers/beta/memory.d.ts

@@ -0,0 +1,11 @@
+import { BetaRunnableTool, Promisable } from '../../lib/tools/BetaRunnableTool';
+import { BetaMemoryTool20250818Command, BetaToolResultContentBlockParam } from '../../resources/beta';
+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/dist/providers/allternit/helpers/beta/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../../src/providers/allternit/helpers/beta/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,EAAE,6BAA6B,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAC;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/dist/providers/allternit/helpers/beta/memory.js

@@ -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.js.map

package/dist/providers/allternit/helpers/beta/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../../../src/providers/allternit/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/dist/providers/allternit/helpers/beta/zod.d.ts

@@ -0,0 +1,27 @@
+import type { infer as zodInfer, ZodType } from 'zod';
+import { AutoParseableBetaOutputFormat } from '../../lib/beta-parser';
+import { BetaRunnableTool, Promisable } from '../../lib/tools/BetaRunnableTool';
+import { BetaToolResultContentBlockParam } from '../../resources/beta';
+/**
+ * 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 ZodType>(zodObject: ZodInput): AutoParseableBetaOutputFormat<zodInfer<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 ZodType>(options: {
+    name: string;
+    inputSchema: InputSchema;
+    description: string;
+    run: (args: zodInfer<InputSchema>) => Promisable<string | Array<BetaToolResultContentBlockParam>>;
+}): BetaRunnableTool<zodInfer<InputSchema>>;
+//# sourceMappingURL=zod.d.ts.map

package/dist/providers/allternit/helpers/beta/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../../../../src/providers/allternit/helpers/beta/zod.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,IAAI,QAAQ,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAGtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAC;AACvE;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,SAAS,OAAO,EAC1D,SAAS,EAAE,QAAQ,GAClB,6BAA6B,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAsBnD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,SAAS,OAAO,EAAE,OAAO,EAAE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,WAAW,CAAC,KAAK,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;CACnG,GAAG,gBAAgB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAkB1C"}

package/dist/providers/allternit/helpers/beta/zod.js

@@ -0,0 +1,52 @@
+import { transformJSONSchema } from '../../lib/transform-json-schema';
+import * as z from 'zod/v4';
+import { AllternitError } from '../../core/error';
+/**
+ * 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 function betaZodOutputFormat(zodObject) {
+    let jsonSchema = z.toJSONSchema(zodObject, { reused: 'ref' });
+    jsonSchema = transformJSONSchema(jsonSchema);
+    return {
+        type: 'json_schema',
+        schema: {
+            ...jsonSchema,
+        },
+        parse: (content) => {
+            const output = zodObject.safeParse(JSON.parse(content));
+            if (!output.success) {
+                throw new AllternitError(`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.
+ */
+export 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),
+    };
+}
+//# sourceMappingURL=zod.js.map

package/dist/providers/allternit/helpers/beta/zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.js","sourceRoot":"","sources":["../../../../../src/providers/allternit/helpers/beta/zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAmB,MAAM,iCAAiC,CAAC;AAEvF,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIlD;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAmB;IAEnB,IAAI,UAAU,GAAe,CAAC,CAAC,YAAY,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAe,CAAC;IAExF,UAAU,GAAG,mBAAmB,CAAC,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,cAAc,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,MAAM,UAAU,WAAW,CAA8B,OAKxD;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,CAA0B;KACnF,CAAC;AACJ,CAAC"}

package/dist/providers/allternit/helpers/index.d.ts

@@ -0,0 +1,3 @@
+export { jsonSchemaOutputFormat } from './json-schema';
+export { zodOutputFormat } from './zod';
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/allternit/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/providers/allternit/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC"}

package/dist/providers/allternit/helpers/index.js

@@ -0,0 +1,3 @@
+export { jsonSchemaOutputFormat } from './json-schema';
+export { zodOutputFormat } from './zod';
+//# sourceMappingURL=index.js.map

package/dist/providers/allternit/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/providers/allternit/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC"}

package/dist/providers/allternit/helpers/json-schema.d.ts

@@ -0,0 +1,18 @@
+import { FromSchema, JSONSchema } from 'json-schema-to-ts';
+import { AutoParseableOutputFormat } from '../lib/parser';
+type NoInfer<T> = T extends infer R ? R : never;
+/**
+ * Creates a JSON schema output format object from the given JSON 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 JSON schema.
+ *
+ * Note: When `transform` is enabled (the default), the schema is deep-cloned before transformation,
+ * so the original schema object is not modified.
+ */
+export declare function jsonSchemaOutputFormat<const Schema extends Exclude<JSONSchema, boolean> & {
+    type: 'object';
+}>(jsonSchema: Schema, options?: {
+    transform?: boolean;
+}): AutoParseableOutputFormat<NoInfer<FromSchema<Schema>>>;
+export {};
+//# sourceMappingURL=json-schema.d.ts.map

package/dist/providers/allternit/helpers/json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../../../src/providers/allternit/helpers/json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAI1D,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEhD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,CAAC,MAAM,SAAS,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,EAEtE,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GACA,yBAAyB,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAyBxD"}

package/dist/providers/allternit/helpers/json-schema.js

@@ -0,0 +1,34 @@
+import { AllternitError } from '../core/error';
+import { transformJSONSchema } from '../lib/transform-json-schema';
+/**
+ * Creates a JSON schema output format object from the given JSON 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 JSON schema.
+ *
+ * Note: When `transform` is enabled (the default), the schema is deep-cloned before transformation,
+ * so the original schema object is not modified.
+ */
+export function jsonSchemaOutputFormat(jsonSchema, options) {
+    if (jsonSchema.type !== 'object') {
+        throw new Error(`JSON schema must be an object, but got ${jsonSchema.type}`);
+    }
+    const transform = options?.transform ?? true;
+    if (transform) {
+        jsonSchema = transformJSONSchema(jsonSchema);
+    }
+    return {
+        type: 'json_schema',
+        schema: {
+            ...jsonSchema,
+        },
+        parse: (content) => {
+            try {
+                return JSON.parse(content);
+            }
+            catch (error) {
+                throw new AllternitError(`Failed to parse structured output: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=json-schema.js.map

package/dist/providers/allternit/helpers/json-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.js","sourceRoot":"","sources":["../../../../src/providers/allternit/helpers/json-schema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAInE;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAGpC,UAAkB,EAClB,OAEC;IAED,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,0CAA0C,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC;IAC7C,IAAI,SAAS,EAAE,CAAC;QACd,UAAU,GAAG,mBAAmB,CAAC,UAAU,CAAW,CAAC;IACzD,CAAC;IAED,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE;YACN,GAAG,UAAU;SACd;QACD,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;YACjB,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,cAAc,CACtB,sCAAsC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC/F,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/providers/allternit/helpers/zod.d.ts

@@ -0,0 +1,13 @@
+import type { infer as zodInfer, ZodType } from 'zod';
+import { AutoParseableOutputFormat } from '../lib/parser';
+/**
+ * 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 zodOutputFormat<ZodInput extends ZodType>(zodObject: ZodInput): AutoParseableOutputFormat<zodInfer<ZodInput>>;
+//# sourceMappingURL=zod.d.ts.map

package/dist/providers/allternit/helpers/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../../../src/providers/allternit/helpers/zod.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,IAAI,QAAQ,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAGtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,QAAQ,SAAS,OAAO,EACtD,SAAS,EAAE,QAAQ,GAClB,yBAAyB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAwC/C"}