@rudderjs/ai 0.0.1

package/dist/types.d.ts

@@ -0,0 +1,439 @@
+import type { z } from 'zod';
+/** A single content part (text, image, or document) */
+export type ContentPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    data: string;
+    mimeType: string;
+} | {
+    type: 'document';
+    data: string;
+    mimeType: string;
+    name?: string;
+};
+/** A message in the conversation */
+export interface AiMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | ContentPart[];
+    /** Present when role === 'tool' */
+    toolCallId?: string;
+    /** Present when role === 'assistant' and model wants to call tools */
+    toolCalls?: ToolCall[];
+}
+/** A tool call from the model */
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/** A tool result to feed back to the model */
+export interface ToolResult {
+    toolCallId: string;
+    result: unknown;
+}
+/** Token usage stats */
+export interface TokenUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+}
+/** Non-streaming response from a provider */
+export interface ProviderResponse {
+    message: AiMessage;
+    usage: TokenUsage;
+    finishReason: FinishReason;
+}
+export type FinishReason = 'stop' | 'tool_calls' | 'length' | 'content_filter'
+/** Loop stopped because client-side tool calls are pending execution. */
+ | 'client_tool_calls'
+/** Loop stopped because a tool call requires user approval. */
+ | 'tool_approval_required';
+/** A single streamed chunk */
+export interface StreamChunk {
+    type: 'text-delta' | 'tool-call-delta' | 'tool-call' | 'tool-result' | 'tool-update' | 'usage' | 'finish' | 'pending-client-tools' | 'pending-approval';
+    /** Text content delta (when type === 'text-delta') */
+    text?: string;
+    /** Tool call info (when type === 'tool-call', 'tool-call-delta', 'tool-result', 'tool-update', or 'pending-approval') */
+    toolCall?: Partial<ToolCall>;
+    /** Tool execution result (when type === 'tool-result') */
+    result?: unknown;
+    /**
+     * Preliminary tool progress payload (when type === 'tool-update').
+     * Emitted by async-generator tool executes for each `yield`.
+     * Ephemeral: not persisted, not seen by the model on the next step.
+     */
+    update?: unknown;
+    /** Pending client tool calls (when type === 'pending-client-tools') */
+    toolCalls?: ToolCall[];
+    /** Approval-pending metadata (when type === 'pending-approval') */
+    isClientTool?: boolean;
+    /** Usage stats (when type === 'finish' or 'usage') */
+    usage?: TokenUsage | undefined;
+    /** Finish reason (when type === 'finish') */
+    finishReason?: FinishReason;
+}
+/** Options passed to the provider for each request */
+export interface ProviderRequestOptions {
+    model: string;
+    messages: AiMessage[];
+    tools?: ToolDefinitionSchema[] | undefined;
+    toolChoice?: ToolChoice | undefined;
+    temperature?: number | undefined;
+    maxTokens?: number | undefined;
+    topP?: number | undefined;
+    stop?: string[] | undefined;
+    /** Provider-specific options */
+    providerOptions?: Record<string, unknown> | undefined;
+}
+export type ToolChoice = 'auto' | 'required' | 'none' | {
+    name: string;
+};
+/** Tool definition as sent to the provider (JSON Schema) */
+export interface ToolDefinitionSchema {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+/** Provider adapter — thin wrapper around a provider SDK */
+export interface ProviderAdapter {
+    /** Generate a complete response */
+    generate(options: ProviderRequestOptions): Promise<ProviderResponse>;
+    /** Stream a response */
+    stream(options: ProviderRequestOptions): AsyncIterable<StreamChunk>;
+}
+/** Embedding response */
+export interface EmbeddingResult {
+    embeddings: number[][];
+    usage: {
+        promptTokens: number;
+        totalTokens: number;
+    };
+}
+/** Provider adapter that supports embeddings */
+export interface EmbeddingAdapter {
+    embed(input: string | string[], model: string): Promise<EmbeddingResult>;
+}
+export interface ImageGenerationOptions {
+    prompt: string;
+    model?: string | undefined;
+    size?: 'square' | 'landscape' | 'portrait' | string | undefined;
+    quality?: 'standard' | 'hd' | undefined;
+    style?: 'natural' | 'vivid' | undefined;
+    n?: number | undefined;
+}
+export interface ImageGenerationResult {
+    images: Array<{
+        url?: string | undefined;
+        base64?: string | undefined;
+        revisedPrompt?: string | undefined;
+    }>;
+    model: string;
+}
+export interface ImageGenerationAdapter {
+    generate(options: ImageGenerationOptions): Promise<ImageGenerationResult>;
+}
+/** Provider factory — creates a ProviderAdapter from a model string */
+export interface ProviderFactory {
+    readonly name: string;
+    create(model: string): ProviderAdapter;
+    /** Create an embedding adapter (optional — not all providers support embeddings) */
+    createEmbedding?(model: string): EmbeddingAdapter;
+    /** Create an image generation adapter (optional — not all providers support image generation) */
+    createImage?(model: string): ImageGenerationAdapter;
+    /** Create a text-to-speech adapter (optional) */
+    createTts?(model: string): TextToSpeechAdapter;
+    /** Create a speech-to-text adapter (optional) */
+    createStt?(model: string): SpeechToTextAdapter;
+}
+export interface TextToSpeechOptions {
+    text: string;
+    model?: string | undefined;
+    voice?: string | undefined;
+    speed?: number | undefined;
+    format?: 'mp3' | 'opus' | 'aac' | 'flac' | 'wav' | undefined;
+}
+export interface TextToSpeechResult {
+    audio: Buffer;
+    format: string;
+    model: string;
+}
+export interface SpeechToTextOptions {
+    audio: Buffer | string;
+    model?: string | undefined;
+    language?: string | undefined;
+    prompt?: string | undefined;
+}
+export interface SpeechToTextResult {
+    text: string;
+    language?: string | undefined;
+    duration?: number | undefined;
+    model: string;
+}
+export interface TextToSpeechAdapter {
+    generate(options: TextToSpeechOptions): Promise<TextToSpeechResult>;
+}
+export interface SpeechToTextAdapter {
+    transcribe(options: SpeechToTextOptions): Promise<SpeechToTextResult>;
+}
+/**
+ * Per-call context passed to a tool's `execute` as an optional second
+ * argument. Carries loop-level identity that the tool would otherwise have
+ * no way to observe.
+ *
+ * Today it contains only `toolCallId` — the id the model assigned to this
+ * particular invocation. Tools that need to correlate their side-effects
+ * with the surrounding loop (e.g. a sub-agent runner that pauses on a
+ * client tool and needs to record which parent tool-call id its suspension
+ * belongs to) read this id.
+ *
+ * Additional fields may be added over time; tools should destructure only
+ * what they need. The whole parameter is optional on the call signature so
+ * existing single-arg executes keep working.
+ */
+export interface ToolCallContext {
+    /** The id the model assigned to this particular tool call. */
+    readonly toolCallId: string;
+}
+/**
+ * Tool execute function.
+ *
+ * Returns either a value (sync), a promise (async), or an async generator.
+ * Generator-style executes can `yield` preliminary progress payloads —
+ * each yield is emitted as a `tool-update` stream chunk while the tool runs.
+ * The generator's `return` value is the final tool result (the value the
+ * model and the persisted store both see).
+ *
+ * The optional second `ctx` parameter carries loop-level metadata such as
+ * `toolCallId`. Tools that don't care can omit it and keep a one-arg
+ * signature — TypeScript's contravariant function parameter rules mean
+ * `(input) => ...` still satisfies `(input, ctx?) => ...`.
+ *
+ * `TUpdate` defaults to `never` so non-generator call sites infer cleanly
+ * without a third type parameter on every existing tool definition.
+ */
+export type ToolExecuteFn<TInput = unknown, TOutput = unknown, TUpdate = never> = (input: TInput, ctx?: ToolCallContext) => TOutput | Promise<TOutput> | AsyncGenerator<TUpdate, TOutput, void>;
+export type ToolNeedsApproval<TInput = unknown> = boolean | ((input: TInput) => boolean | Promise<boolean>);
+export interface ToolDefinitionOptions<TInput extends z.ZodType = z.ZodType, TOutput extends z.ZodType = z.ZodType> {
+    name: string;
+    description: string;
+    inputSchema: TInput;
+    outputSchema?: TOutput | undefined;
+    needsApproval?: ToolNeedsApproval<z.infer<TInput>> | undefined;
+    lazy?: boolean | undefined;
+    /** Arbitrary metadata — used by provider-native tools to signal special handling */
+    meta?: Record<string, unknown> | undefined;
+}
+/**
+ * A tool the model can call.
+ *
+ * `execute` is optional — its presence/absence is the only discriminator
+ * between server tools (have an executor) and client tools (run in the
+ * browser via the `clientTools` registry on the panels side).
+ *
+ * This shape mirrors Vercel AI SDK v4+ and TanStack AI.
+ */
+export interface Tool<TInput = unknown, TOutput = unknown> {
+    readonly definition: ToolDefinitionOptions;
+    readonly execute?: ToolExecuteFn<TInput, TOutput, unknown> | undefined;
+    /**
+     * Optional transform from the tool's structured `result` to the string the
+     * **model** sees on its next step. The UI (`tool-result` chunk and
+     * `step.toolResults`) still receives the original `result`.
+     *
+     * Use this to summarize, redact, or shrink large/binary tool outputs so
+     * the parent model doesn't get the full payload stuffed into its context
+     * (e.g. subagent transcripts, base64 blobs). Default — when this is
+     * absent — is the same `JSON.stringify`-or-pass-through behavior as before.
+     */
+    readonly toModelOutput?: ((result: TOutput) => string | Promise<string>) | undefined;
+}
+export type AnyTool = Tool<any, any>;
+/**
+ * @deprecated Use {@link Tool}. A "server tool" is just a `Tool` whose
+ * `execute` is defined.
+ */
+export interface ServerTool<TInput = unknown, TOutput = unknown> extends Tool<TInput, TOutput> {
+    readonly execute: ToolExecuteFn<TInput, TOutput, unknown>;
+}
+/**
+ * @deprecated Use {@link Tool}. A "client tool" is just a `Tool` whose
+ * `execute` is omitted; the browser handles execution via the
+ * `clientTools` registry in `@rudderjs/panels`.
+ */
+export type ClientTool<TInput = unknown, TOutput = unknown> = Tool<TInput, TOutput>;
+export interface MiddlewareContext {
+    requestId: string;
+    iteration: number;
+    chunkIndex: number;
+    messages: AiMessage[];
+    model: string;
+    provider: string;
+    toolNames: string[];
+    context?: unknown;
+    abort(reason?: string): void;
+}
+export interface MiddlewareConfigResult {
+    messages?: AiMessage[];
+    systemPrompts?: string[];
+    tools?: AnyTool[];
+    temperature?: number;
+    maxTokens?: number;
+    providerOptions?: Record<string, unknown>;
+}
+export type BeforeToolCallResult = void | {
+    type: 'transformArgs';
+    args: Record<string, unknown>;
+} | {
+    type: 'skip';
+    result: unknown;
+} | {
+    type: 'abort';
+    reason: string;
+};
+export interface AiMiddleware {
+    name: string;
+    onConfig?(ctx: MiddlewareContext, config: MiddlewareConfigResult, phase: 'init' | 'beforeModel'): MiddlewareConfigResult | void;
+    onStart?(ctx: MiddlewareContext): void | Promise<void>;
+    onIteration?(ctx: MiddlewareContext): void | Promise<void>;
+    onChunk?(ctx: MiddlewareContext, chunk: StreamChunk): StreamChunk | null;
+    onBeforeToolCall?(ctx: MiddlewareContext, toolName: string, args: Record<string, unknown>): BeforeToolCallResult | Promise<BeforeToolCallResult>;
+    onAfterToolCall?(ctx: MiddlewareContext, toolName: string, args: Record<string, unknown>, result: unknown): void | Promise<void>;
+    onToolPhaseComplete?(ctx: MiddlewareContext): void | Promise<void>;
+    onUsage?(ctx: MiddlewareContext, usage: TokenUsage): void | Promise<void>;
+    onFinish?(ctx: MiddlewareContext): void | Promise<void>;
+    onAbort?(ctx: MiddlewareContext, reason: string): void | Promise<void>;
+    onError?(ctx: MiddlewareContext, error: unknown): void | Promise<void>;
+}
+export interface HasTools {
+    tools(): AnyTool[];
+}
+export interface HasMemory {
+    conversationId?: string;
+    messages(): AiMessage[] | Promise<AiMessage[]>;
+}
+export interface HasStructuredOutput {
+    outputSchema(): z.ZodType;
+}
+export interface HasMiddleware {
+    middleware(): AiMiddleware[];
+}
+export type StopCondition = (ctx: {
+    steps: AgentStep[];
+    iteration: number;
+    lastMessage: AiMessage;
+}) => boolean;
+export interface AgentStep {
+    message: AiMessage;
+    toolCalls: ToolCall[];
+    toolResults: ToolResult[];
+    usage: TokenUsage;
+    finishReason: FinishReason;
+}
+export interface PrepareStepResult {
+    model?: string;
+    tools?: AnyTool[];
+    toolChoice?: ToolChoice;
+    messages?: AiMessage[];
+    system?: string;
+    providerOptions?: Record<string, unknown>;
+}
+export interface AgentResponse {
+    text: string;
+    steps: AgentStep[];
+    usage: TokenUsage;
+    conversationId?: string;
+    /** When the loop stopped early, why. */
+    finishReason?: FinishReason;
+    /** Client tool calls awaiting browser-side execution. */
+    pendingClientToolCalls?: ToolCall[];
+    /** A tool call awaiting user approval. */
+    pendingApprovalToolCall?: {
+        toolCall: ToolCall;
+        isClientTool: boolean;
+    };
+    /**
+     * Tool result messages that were injected at the start of a continuation
+     * to fulfill an `assistant{toolCalls}` carried over from the previous turn
+     * (e.g. an approval round-trip). The panels dispatcher persists these so
+     * the conversation store never holds an unfulfilled `tool_use` block.
+     */
+    resumedToolMessages?: AiMessage[];
+}
+export interface AgentStreamResponse {
+    stream: AsyncIterable<StreamChunk>;
+    response: Promise<AgentResponse>;
+}
+export interface AiProviderConfig {
+    driver: string;
+    apiKey?: string;
+    baseUrl?: string;
+    [key: string]: unknown;
+}
+export interface AiModelConfig {
+    id: string;
+    label: string;
+}
+export interface AiConfig {
+    default: string;
+    providers: Record<string, AiProviderConfig>;
+    failover?: string[];
+    models?: AiModelConfig[];
+    /** Conversation store for persisting agent conversations */
+    conversations?: ConversationStore;
+}
+export interface AgentPromptOptions {
+    /** Prior conversation messages to prepend (after system prompt, before current user message) */
+    history?: AiMessage[];
+    /**
+     * Full message list to send instead of `[system, ...history, user(input)]`.
+     * When set, the loop runs with `[system, ...messages]` directly — `input`
+     * is ignored. Used for continuations after a client-tool round-trip or
+     * approval round-trip, where the conversation ends with a tool result
+     * message and there is no fresh user input.
+     */
+    messages?: AiMessage[];
+    /** File/image attachments to include with the prompt */
+    attachments?: Attachment[];
+    /**
+     * How to handle tool calls for tools without a server-side handler.
+     *
+     * - `'placeholder'` (default): write a placeholder tool result and continue the loop.
+     *   Preserves the historical behavior.
+     * - `'stop-on-client-tool'`: stop the loop, expose pending tool calls on the
+     *   `AgentResponse`, and let the caller (typically the panels chat handler)
+     *   re-submit with tool results once the browser has executed them.
+     */
+    toolCallStreamingMode?: 'placeholder' | 'stop-on-client-tool';
+    /** Tool call ids the user has approved. */
+    approvedToolCallIds?: string[];
+    /** Tool call ids the user has rejected. */
+    rejectedToolCallIds?: string[];
+}
+/** An attachment (file or image) to include with a prompt */
+export interface Attachment {
+    type: 'image' | 'document';
+    data: string;
+    mimeType: string;
+    name?: string;
+}
+export interface ConversationStoreMeta {
+    userId?: string;
+    resourceSlug?: string;
+    recordId?: string;
+}
+export interface ConversationStore {
+    create(title?: string, meta?: ConversationStoreMeta): Promise<string>;
+    load(conversationId: string): Promise<AiMessage[]>;
+    append(conversationId: string, messages: AiMessage[]): Promise<void>;
+    setTitle(conversationId: string, title: string): Promise<void>;
+    list(userId?: string): Promise<{
+        id: string;
+        title: string;
+        createdAt: Date;
+        updatedAt?: Date;
+    }[]>;
+    delete?(conversationId: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/vercel-protocol.d.ts

@@ -0,0 +1,18 @@
+import type { StreamChunk } from './types.js';
+/**
+ * Convert a RudderJS AI stream to Vercel AI SDK Data Stream Protocol format.
+ *
+ * Protocol prefixes:
+ * - `0:` text delta (JSON string)
+ * - `9:` tool call begin (JSON: toolCallId + toolName)
+ * - `a:` tool call delta (JSON: toolCallId + argsTextDelta)
+ * - `b:` tool call result (JSON: toolCallId + result)
+ * - `e:` finish (JSON: finishReason + usage)
+ * - `d:` done (JSON: finishReason)
+ *
+ * @see https://sdk.vercel.ai/docs/ai-sdk-ui/stream-protocol#data-stream-protocol
+ */
+export declare function toVercelDataStream(stream: AsyncIterable<StreamChunk>): ReadableStream<Uint8Array>;
+/** Create a Response object with proper headers for Vercel AI SDK streaming. */
+export declare function toVercelResponse(stream: AsyncIterable<StreamChunk>): Response;
+//# sourceMappingURL=vercel-protocol.d.ts.map

package/dist/vercel-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-protocol.d.ts","sourceRoot":"","sources":["../src/vercel-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,cAAc,CAAC,UAAU,CAAC,CAwDjG;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,QAAQ,CAO7E"}

package/dist/vercel-protocol.js

@@ -0,0 +1,75 @@
+/**
+ * Convert a RudderJS AI stream to Vercel AI SDK Data Stream Protocol format.
+ *
+ * Protocol prefixes:
+ * - `0:` text delta (JSON string)
+ * - `9:` tool call begin (JSON: toolCallId + toolName)
+ * - `a:` tool call delta (JSON: toolCallId + argsTextDelta)
+ * - `b:` tool call result (JSON: toolCallId + result)
+ * - `e:` finish (JSON: finishReason + usage)
+ * - `d:` done (JSON: finishReason)
+ *
+ * @see https://sdk.vercel.ai/docs/ai-sdk-ui/stream-protocol#data-stream-protocol
+ */
+export function toVercelDataStream(stream) {
+    const encoder = new TextEncoder();
+    return new ReadableStream({
+        async start(controller) {
+            try {
+                for await (const chunk of stream) {
+                    let line;
+                    switch (chunk.type) {
+                        case 'text-delta':
+                            line = `0:${JSON.stringify(chunk.text)}\n`;
+                            break;
+                        case 'tool-call-delta':
+                            if (chunk.toolCall?.name) {
+                                line = `9:${JSON.stringify({ toolCallId: chunk.toolCall.id ?? '', toolName: chunk.toolCall.name })}\n`;
+                            }
+                            if (chunk.text) {
+                                line = (line ?? '') + `a:${JSON.stringify({ toolCallId: chunk.toolCall?.id ?? '', argsTextDelta: chunk.text })}\n`;
+                            }
+                            break;
+                        case 'tool-call':
+                            // Tool call complete — result will be emitted separately if available
+                            break;
+                        case 'usage':
+                            // Usage is emitted as part of the finish chunk
+                            break;
+                        case 'finish': {
+                            const finishReason = chunk.finishReason === 'tool_calls' ? 'tool-calls' : chunk.finishReason;
+                            line = `e:${JSON.stringify({
+                                finishReason,
+                                usage: chunk.usage ? {
+                                    promptTokens: chunk.usage.promptTokens,
+                                    completionTokens: chunk.usage.completionTokens,
+                                } : undefined,
+                            })}\n`;
+                            line += `d:${JSON.stringify({ finishReason })}\n`;
+                            break;
+                        }
+                    }
+                    if (line) {
+                        controller.enqueue(encoder.encode(line));
+                    }
+                }
+            }
+            catch (err) {
+                controller.error(err);
+            }
+            finally {
+                controller.close();
+            }
+        },
+    });
+}
+/** Create a Response object with proper headers for Vercel AI SDK streaming. */
+export function toVercelResponse(stream) {
+    return new Response(toVercelDataStream(stream), {
+        headers: {
+            'Content-Type': 'text/plain; charset=utf-8',
+            'X-Vercel-AI-Data-Stream': 'v1',
+        },
+    });
+}
+//# sourceMappingURL=vercel-protocol.js.map

package/dist/vercel-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-protocol.js","sourceRoot":"","sources":["../src/vercel-protocol.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAkC;IACnE,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;IAEjC,OAAO,IAAI,cAAc,CAAC;QACxB,KAAK,CAAC,KAAK,CAAC,UAAU;YACpB,IAAI,CAAC;gBACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;oBACjC,IAAI,IAAwB,CAAA;oBAE5B,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;wBACnB,KAAK,YAAY;4BACf,IAAI,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAA;4BAC1C,MAAK;wBAEP,KAAK,iBAAiB;4BACpB,IAAI,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;gCACzB,IAAI,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,CAAA;4BACxG,CAAC;4BACD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gCACf,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,aAAa,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAA;4BACpH,CAAC;4BACD,MAAK;wBAEP,KAAK,WAAW;4BACd,sEAAsE;4BACtE,MAAK;wBAEP,KAAK,OAAO;4BACV,+CAA+C;4BAC/C,MAAK;wBAEP,KAAK,QAAQ,CAAC,CAAC,CAAC;4BACd,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAA;4BAC5F,IAAI,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC;gCACzB,YAAY;gCACZ,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;oCACnB,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,YAAY;oCACtC,gBAAgB,EAAE,KAAK,CAAC,KAAK,CAAC,gBAAgB;iCAC/C,CAAC,CAAC,CAAC,SAAS;6BACd,CAAC,IAAI,CAAA;4BACN,IAAI,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC,IAAI,CAAA;4BACjD,MAAK;wBACP,CAAC;oBACH,CAAC;oBAED,IAAI,IAAI,EAAE,CAAC;wBACT,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;oBAC1C,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YACvB,CAAC;oBAAS,CAAC;gBACT,UAAU,CAAC,KAAK,EAAE,CAAA;YACpB,CAAC;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAAC,MAAkC;IACjE,OAAO,IAAI,QAAQ,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE;QAC9C,OAAO,EAAE;YACP,cAAc,EAAE,2BAA2B;YAC3C,yBAAyB,EAAE,IAAI;SAChC;KACF,CAAC,CAAA;AACJ,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { z } from 'zod';
+/**
+ * Lightweight Zod → JSON Schema converter.
+ * Handles the common types used in tool definitions.
+ * Supports both Zod v3 (typeName) and Zod v4 (_def.type).
+ */
+export declare function zodToJsonSchema(schema: z.ZodType): Record<string, unknown>;
+//# sourceMappingURL=zod-to-json-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-json-schema.d.ts","sourceRoot":"","sources":["../src/zod-to-json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE1E"}

package/dist/zod-to-json-schema.js

@@ -0,0 +1,86 @@
+/**
+ * Lightweight Zod → JSON Schema converter.
+ * Handles the common types used in tool definitions.
+ * Supports both Zod v3 (typeName) and Zod v4 (_def.type).
+ */
+export function zodToJsonSchema(schema) {
+    return zodTypeToJson(schema);
+}
+function getType(def) {
+    // Zod v3 uses typeName (e.g. 'ZodString'), Zod v4 uses type (e.g. 'string')
+    return def.typeName ?? def.type ?? '';
+}
+function zodTypeToJson(schema) {
+    const def = schema._def;
+    const t = getType(def);
+    const desc = def.description;
+    // Object
+    if (t === 'ZodObject' || t === 'object') {
+        const shape = schema.shape ?? def.shape;
+        const properties = {};
+        const required = [];
+        for (const [key, value] of Object.entries(shape)) {
+            properties[key] = zodTypeToJson(value);
+            if (!isOptional(value))
+                required.push(key);
+        }
+        return {
+            type: 'object',
+            properties,
+            ...(required.length > 0 ? { required } : {}),
+        };
+    }
+    if (t === 'ZodString' || t === 'string')
+        return { type: 'string', ...(desc ? { description: desc } : {}) };
+    if (t === 'ZodNumber' || t === 'number')
+        return { type: 'number', ...(desc ? { description: desc } : {}) };
+    if (t === 'ZodBoolean' || t === 'boolean')
+        return { type: 'boolean', ...(desc ? { description: desc } : {}) };
+    if (t === 'ZodNull' || t === 'null')
+        return { type: 'null' };
+    // Array — Zod v3: def.type (inner schema), Zod v4: def.element
+    if (t === 'ZodArray' || t === 'array') {
+        const inner = def.element ?? def.type;
+        return { type: 'array', items: zodTypeToJson(inner) };
+    }
+    // Enum — Zod v3: def.values (string[]), Zod v4: def.entries (Record)
+    if (t === 'ZodEnum' || t === 'enum') {
+        const values = def.values ?? Object.keys(def.entries ?? {});
+        return { type: 'string', enum: values };
+    }
+    // Optional
+    if (t === 'ZodOptional' || t === 'optional') {
+        return zodTypeToJson(def.innerType);
+    }
+    // Nullable
+    if (t === 'ZodNullable' || t === 'nullable') {
+        const inner = zodTypeToJson(def.innerType);
+        return { ...inner, nullable: true };
+    }
+    // Default
+    if (t === 'ZodDefault' || t === 'default') {
+        const inner = zodTypeToJson(def.innerType);
+        return { ...inner, default: typeof def.defaultValue === 'function' ? def.defaultValue() : def.defaultValue };
+    }
+    // Literal — Zod v3: def.value, Zod v4: def.values (array)
+    if (t === 'ZodLiteral' || t === 'literal') {
+        const val = def.value ?? def.values?.[0];
+        return { type: typeof val, enum: [val] };
+    }
+    // Union
+    if (t === 'ZodUnion' || t === 'union') {
+        const options = def.options ?? def.members ?? [];
+        return { oneOf: options.map((o) => zodTypeToJson(o)) };
+    }
+    // Record
+    if (t === 'ZodRecord' || t === 'record') {
+        return { type: 'object', additionalProperties: zodTypeToJson(def.valueType) };
+    }
+    // Fallback
+    return { type: 'string' };
+}
+function isOptional(schema) {
+    const t = getType(schema._def);
+    return t === 'ZodOptional' || t === 'optional' || t === 'ZodDefault' || t === 'default';
+}
+//# sourceMappingURL=zod-to-json-schema.js.map