@rudderjs/ai 1.17.2 → 1.18.0

package/dist/handoff.d.ts

@@ -1,95 +0,0 @@
-import { z } from 'zod';
-import type { ToolDefinitionOptions, ToolDefinitionSchema } from './types.js';
-import type { Agent } from './agent.js';
-/**
- * Symbol-tagged marker identifying a handoff tool. Looked up via
- * `Symbol.for(...)` so cross-bundle / cross-realm checks succeed even when
- * `@rudderjs/ai` is loaded twice (rare, but possible in monorepo + linked
- * setups).
- */
-export declare const HANDOFF_MARKER: unique symbol;
-/**
- * Internal spec attached to a handoff tool. The agent loop reads this when
- * it sees a tool call that lands on a `HandoffTool` — it does NOT execute
- * the tool's body (there isn't one). Instead it short-circuits the loop,
- * synthesizes a tool result, and pivots control to a new instance of
- * `AgentClass` for the rest of the conversation.
- */
-export interface HandoffSpec {
-    readonly AgentClass: new (...args: unknown[]) => Agent;
-    readonly name: string;
-    readonly description: string;
-    readonly inputSchema: z.ZodType;
-}
-/**
- * A tool returned by {@link handoff}. The loop recognizes it via the
- * `HANDOFF_MARKER` symbol property and treats it as a control-transfer,
- * not a normal server tool. Its `execute` is intentionally absent.
- */
-export interface HandoffTool {
-    readonly [HANDOFF_MARKER]: true;
-    readonly __handoffSpec: HandoffSpec;
-    readonly definition: ToolDefinitionOptions;
-    readonly execute?: undefined;
-    toSchema(): ToolDefinitionSchema;
-}
-/**
- * Options for {@link handoff}. All fields optional — by default, a handoff
- * tool is named `handoffTo${AgentClass.name}` and accepts a single
- * `message: string` argument that becomes the transition prompt seen by
- * the new agent as its first user message.
- */
-export interface HandoffOptions<TInput extends z.ZodType = z.ZodType> {
-    /** Override the tool name. Default: `handoffTo${AgentClass.name}`. */
-    name?: string;
-    /**
-     * Trigger guidance — a short phrase appended to the description so the
-     * model knows when to pick this handoff. Example: `'pricing or sales'`
-     * → "Hand off the conversation to SalesAgent for pricing or sales."
-     */
-    when?: string;
-    /** Override the entire description. If set, takes precedence over `when`. */
-    description?: string;
-    /**
-     * Zod schema for the handoff payload. Defaults to
-     * `z.object({ message: z.string() })` — the parent's model writes a
-     * transition prompt that becomes the child's first user message.
-     *
-     * Custom schemas are supported but the loop reads `args.message` (string)
-     * as the transition prompt. Schemas without a `message` string field will
-     * pass an empty transition message; the carried conversation history is
-     * still surfaced to the child.
-     */
-    inputSchema?: TInput;
-}
-/**
- * Define a handoff tool — a control-transfer tool the parent agent's model
- * can call to pivot the conversation to another agent. After the model
- * calls it, the parent's loop ends and the child agent runs from the same
- * message history with its own instructions, tools, and model.
- *
- * Distinct from {@link Agent.asTool} (which is call-and-return: the parent
- * resumes after the child finishes and incorporates the child's text as a
- * tool result). Handoffs do not return — the child owns the rest of the
- * conversation.
- *
- * @example
- * ```ts
- * class TriageAgent extends Agent {
- *   tools() {
- *     return [
- *       handoff(SalesAgent,    { when: 'pricing or sales questions' }),
- *       handoff(SupportAgent,  { when: 'bug reports or technical issues' }),
- *     ]
- *   }
- * }
- * ```
- */
-export declare function handoff(AgentClass: new (...args: never[]) => Agent, opts?: HandoffOptions): HandoffTool;
-/**
- * Structural typeguard. Used by the agent loop to detect handoff tools
- * without coupling to a class hierarchy — handoff tools are plain objects
- * tagged with the {@link HANDOFF_MARKER} symbol.
- */
-export declare function isHandoffTool(t: unknown): t is HandoffTool;
-//# sourceMappingURL=handoff.d.ts.map

package/dist/handoff.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../src/handoff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAC7E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvC;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,MAA0C,CAAA;AAE9E;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,KAAK,CAAA;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAA;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,CAAC,cAAc,CAAC,EAAE,IAAI,CAAA;IAC/B,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAA;IACnC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAA;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;IAC5B,QAAQ,IAAI,oBAAoB,CAAA;CACjC;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IAClE,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAQD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CACrB,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,KAAK,EAC3C,IAAI,CAAC,EAAE,cAAc,GACpB,WAAW,CA0Bb;AAOD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,WAAW,CAI1D"}

package/dist/handoff.js

@@ -1,78 +0,0 @@
-import { z } from 'zod';
-import { zodToJsonSchema } from './zod-to-json-schema.js';
-/**
- * Symbol-tagged marker identifying a handoff tool. Looked up via
- * `Symbol.for(...)` so cross-bundle / cross-realm checks succeed even when
- * `@rudderjs/ai` is loaded twice (rare, but possible in monorepo + linked
- * setups).
- */
-export const HANDOFF_MARKER = Symbol.for('rudderjs.ai.handoff');
-const DEFAULT_INPUT_SCHEMA = z.object({
-    message: z
-        .string()
-        .describe('A short user-style prompt for the next agent describing what to do next.'),
-});
-/**
- * Define a handoff tool — a control-transfer tool the parent agent's model
- * can call to pivot the conversation to another agent. After the model
- * calls it, the parent's loop ends and the child agent runs from the same
- * message history with its own instructions, tools, and model.
- *
- * Distinct from {@link Agent.asTool} (which is call-and-return: the parent
- * resumes after the child finishes and incorporates the child's text as a
- * tool result). Handoffs do not return — the child owns the rest of the
- * conversation.
- *
- * @example
- * ```ts
- * class TriageAgent extends Agent {
- *   tools() {
- *     return [
- *       handoff(SalesAgent,    { when: 'pricing or sales questions' }),
- *       handoff(SupportAgent,  { when: 'bug reports or technical issues' }),
- *     ]
- *   }
- * }
- * ```
- */
-export function handoff(AgentClass, opts) {
-    const name = opts?.name ?? `handoffTo${AgentClass.name}`;
-    const description = opts?.description ?? buildDefaultDescription(AgentClass.name, opts?.when);
-    const inputSchema = (opts?.inputSchema ?? DEFAULT_INPUT_SCHEMA);
-    const spec = {
-        AgentClass: AgentClass,
-        name,
-        description,
-        inputSchema,
-    };
-    const definition = { name, description, inputSchema };
-    const tool = {
-        [HANDOFF_MARKER]: true,
-        __handoffSpec: spec,
-        definition,
-        toSchema() {
-            return {
-                name,
-                description,
-                parameters: zodToJsonSchema(inputSchema, 'input'),
-            };
-        },
-    };
-    return tool;
-}
-function buildDefaultDescription(agentName, when) {
-    const base = `Hand off the conversation to ${agentName}`;
-    return when ? `${base} for ${when}.` : `${base}.`;
-}
-/**
- * Structural typeguard. Used by the agent loop to detect handoff tools
- * without coupling to a class hierarchy — handoff tools are plain objects
- * tagged with the {@link HANDOFF_MARKER} symbol.
- */
-export function isHandoffTool(t) {
-    if (t === null || typeof t !== 'object')
-        return false;
-    const marker = t[HANDOFF_MARKER];
-    return marker === true;
-}
-//# sourceMappingURL=handoff.js.map

package/dist/handoff.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../src/handoff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAIzD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAkB,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAA;AA2D9E,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,0EAA0E,CAAC;CACxF,CAAC,CAAA;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,OAAO,CACrB,UAA2C,EAC3C,IAAqB;IAErB,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,YAAY,UAAU,CAAC,IAAI,EAAE,CAAA;IACxD,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,uBAAuB,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IAC7F,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,WAAW,IAAI,oBAAoB,CAAc,CAAA;IAE5E,MAAM,IAAI,GAAgB;QACxB,UAAU,EAAE,UAA0D;QACtE,IAAI;QACJ,WAAW;QACX,WAAW;KACZ,CAAA;IACD,MAAM,UAAU,GAA0B,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,CAAA;IAE5E,MAAM,IAAI,GAAgB;QACxB,CAAC,cAAc,CAAC,EAAE,IAAI;QACtB,aAAa,EAAE,IAAI;QACnB,UAAU;QACV,QAAQ;YACN,OAAO;gBACL,IAAI;gBACJ,WAAW;gBACX,UAAU,EAAE,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC;aAClD,CAAA;QACH,CAAC;KACF,CAAA;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,uBAAuB,CAAC,SAAiB,EAAE,IAAa;IAC/D,MAAM,IAAI,GAAG,gCAAgC,SAAS,EAAE,CAAA;IACxD,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,QAAQ,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAA;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,CAAU;IACtC,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACrD,MAAM,MAAM,GAAI,CAAsC,CAAC,cAAc,CAAC,CAAA;IACtE,OAAO,MAAM,KAAK,IAAI,CAAA;AACxB,CAAC"}

package/dist/handoffs-driver.d.ts

@@ -1,58 +0,0 @@
-import type { Agent } from './agent.js';
-import type { HandoffSpec } from './handoff.js';
-import type { AgentPromptOptions, AgentResponse, AgentStep, AiMessage, TokenUsage } from './types.js';
-/**
- * Hard ceiling for the number of agent-to-agent handoffs in a single
- * `prompt()` / `stream()` call. Most workflows hop once or twice (triage →
- * specialist). Anything beyond this almost certainly means the agents are
- * cycling — surfacing a clear error beats silently looping until token
- * budgets explode.
- */
-export declare const MAX_HANDOFFS = 5;
-/**
- * Internal record of a pending handoff carried from the loop to the
- * handoff-aware wrapper. Not part of the public surface.
- */
-export interface PendingHandoff {
-    spec: HandoffSpec;
-    transitionMessage: string;
-    parentToolCallId: string;
-}
-/**
- * Signature of `runAgentLoopOnce` from `agent.ts`, injected so this module
- * doesn't import its caller and create a runtime cycle.
- */
-export type RunOnce = (a: Agent, input: string, options?: AgentPromptOptions) => Promise<AgentResponse & {
-    _pendingHandoff?: PendingHandoff;
-    _carriedMessages?: AiMessage[];
-}>;
-/**
- * Iteratively drive pending handoffs, carrying steps + usage forward.
- * Used by the non-streaming path. (Streaming has its own iterative driver
- * inline so chunks can flow as each hop's loop runs.)
- */
-export declare function driveHandoffs(rootName: string, rootResult: AgentResponse & {
-    _pendingHandoff?: PendingHandoff;
-    _carriedMessages?: AiMessage[];
-}, pending: PendingHandoff, carriedMessages: AiMessage[], origOptions: AgentPromptOptions | undefined, startHopCount: number, runOnce: RunOnce): Promise<AgentResponse>;
-/** Merge the terminal hop's response with carried steps / usage / path. */
-export declare function mergeFinalHandoff(terminal: AgentResponse, mergedSteps: AgentStep[], mergedUsage: TokenUsage, pathPrefix: string[], terminalName: string): AgentResponse;
-/**
- * Build the {@link AgentPromptOptions} for a child agent invoked via
- * handoff. The parent's carried message log replaces the child's input
- * (so the child sees the full conversation up to the handoff point) but
- * the child still prepends its own `instructions()` as the system message
- * during initialization, so we drop the parent's leading system message
- * to avoid double-prefixing.
- *
- * Per-call options that make sense to carry across (signal, attachments,
- * tool/middleware overrides) are preserved; `messages` and `history` are
- * deliberately overridden.
- */
-export declare function buildHandoffChildOptions(parentOptions: AgentPromptOptions | undefined, carriedMessages: AiMessage[]): AgentPromptOptions;
-/** Strip the internal `_pendingHandoff` / `_carriedMessages` fields before surfacing the response to public callers. */
-export declare function stripInternal(r: AgentResponse & {
-    _pendingHandoff?: PendingHandoff;
-    _carriedMessages?: AiMessage[];
-}): AgentResponse;
-//# sourceMappingURL=handoffs-driver.d.ts.map

package/dist/handoffs-driver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"handoffs-driver.d.ts","sourceRoot":"","sources":["../src/handoffs-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAErG;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,IAAI,CAAA;AAE7B;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAe,WAAW,CAAA;IAC9B,iBAAiB,EAAE,MAAM,CAAA;IACzB,gBAAgB,EAAG,MAAM,CAAA;CAC1B;AAED;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,KAC1E,OAAO,CAAC,aAAa,GAAG;IAAE,eAAe,CAAC,EAAE,cAAc,CAAC;IAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,CAAA;CAAE,CAAC,CAAA;AAQ/F;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAS,MAAM,EACvB,UAAU,EAAO,aAAa,GAAG;IAAE,eAAe,CAAC,EAAE,cAAc,CAAC;IAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,CAAA;CAAE,EACrG,OAAO,EAAU,cAAc,EAC/B,eAAe,EAAE,SAAS,EAAE,EAC5B,WAAW,EAAM,kBAAkB,GAAG,SAAS,EAC/C,aAAa,EAAI,MAAM,EACvB,OAAO,EAAU,OAAO,GACvB,OAAO,CAAC,aAAa,CAAC,CAqCxB;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAM,aAAa,EAC3B,WAAW,EAAG,SAAS,EAAE,EACzB,WAAW,EAAG,UAAU,EACxB,UAAU,EAAI,MAAM,EAAE,EACtB,YAAY,EAAE,MAAM,GACnB,aAAa,CAOf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAI,kBAAkB,GAAG,SAAS,EAC/C,eAAe,EAAE,SAAS,EAAE,GAC3B,kBAAkB,CAQpB;AAED,wHAAwH;AACxH,wBAAgB,aAAa,CAAC,CAAC,EAAE,aAAa,GAAG;IAAE,eAAe,CAAC,EAAE,cAAc,CAAC;IAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,CAAA;CAAE,GAAG,aAAa,CAapI"}

package/dist/handoffs-driver.js

@@ -1,103 +0,0 @@
-/**
- * Hard ceiling for the number of agent-to-agent handoffs in a single
- * `prompt()` / `stream()` call. Most workflows hop once or twice (triage →
- * specialist). Anything beyond this almost certainly means the agents are
- * cycling — surfacing a clear error beats silently looping until token
- * budgets explode.
- */
-export const MAX_HANDOFFS = 5;
-function addUsage(total, step) {
-    total.promptTokens += step.promptTokens;
-    total.completionTokens += step.completionTokens;
-    total.totalTokens += step.totalTokens;
-}
-/**
- * Iteratively drive pending handoffs, carrying steps + usage forward.
- * Used by the non-streaming path. (Streaming has its own iterative driver
- * inline so chunks can flow as each hop's loop runs.)
- */
-export async function driveHandoffs(rootName, rootResult, pending, carriedMessages, origOptions, startHopCount, runOnce) {
-    const mergedSteps = [...rootResult.steps];
-    const mergedUsage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
-    addUsage(mergedUsage, rootResult.usage);
-    const handoffPath = [rootName];
-    let currentPending = pending;
-    let currentCarried = carriedMessages;
-    let hopCount = startHopCount;
-    for (;;) {
-        if (hopCount >= MAX_HANDOFFS) {
-            throw new Error(`[Rudder AI] Exceeded max handoffs (${MAX_HANDOFFS}). Likely a cycle between agents.`);
-        }
-        const ChildClass = currentPending.spec.AgentClass;
-        handoffPath.push(ChildClass.name);
-        const child = new ChildClass();
-        const childOpts = buildHandoffChildOptions(origOptions, currentCarried);
-        const childOnce = await runOnce(child, currentPending.transitionMessage, childOpts);
-        mergedSteps.push(...childOnce.steps);
-        addUsage(mergedUsage, childOnce.usage);
-        if (childOnce._pendingHandoff) {
-            currentPending = childOnce._pendingHandoff;
-            currentCarried = childOnce._carriedMessages ?? [];
-            hopCount++;
-            continue;
-        }
-        return {
-            ...stripInternal(childOnce),
-            steps: mergedSteps,
-            usage: mergedUsage,
-            handoffPath,
-        };
-    }
-}
-/** Merge the terminal hop's response with carried steps / usage / path. */
-export function mergeFinalHandoff(terminal, mergedSteps, mergedUsage, pathPrefix, terminalName) {
-    return {
-        ...terminal,
-        steps: mergedSteps,
-        usage: mergedUsage,
-        handoffPath: [...pathPrefix, terminalName],
-    };
-}
-/**
- * Build the {@link AgentPromptOptions} for a child agent invoked via
- * handoff. The parent's carried message log replaces the child's input
- * (so the child sees the full conversation up to the handoff point) but
- * the child still prepends its own `instructions()` as the system message
- * during initialization, so we drop the parent's leading system message
- * to avoid double-prefixing.
- *
- * Per-call options that make sense to carry across (signal, attachments,
- * tool/middleware overrides) are preserved; `messages` and `history` are
- * deliberately overridden.
- */
-export function buildHandoffChildOptions(parentOptions, carriedMessages) {
-    const stripped = carriedMessages.length > 0 && carriedMessages[0]?.role === 'system'
-        ? carriedMessages.slice(1)
-        : carriedMessages;
-    return {
-        ...(parentOptions ?? {}),
-        messages: stripped,
-    };
-}
-/** Strip the internal `_pendingHandoff` / `_carriedMessages` fields before surfacing the response to public callers. */
-export function stripInternal(r) {
-    const out = {
-        text: r.text,
-        steps: r.steps,
-        usage: r.usage,
-    };
-    if (r.conversationId !== undefined)
-        out.conversationId = r.conversationId;
-    if (r.finishReason !== undefined)
-        out.finishReason = r.finishReason;
-    if (r.pendingClientToolCalls !== undefined)
-        out.pendingClientToolCalls = r.pendingClientToolCalls;
-    if (r.pendingApprovalToolCall !== undefined)
-        out.pendingApprovalToolCall = r.pendingApprovalToolCall;
-    if (r.resumedToolMessages !== undefined)
-        out.resumedToolMessages = r.resumedToolMessages;
-    if (r.handoffPath !== undefined)
-        out.handoffPath = r.handoffPath;
-    return out;
-}
-//# sourceMappingURL=handoffs-driver.js.map

package/dist/handoffs-driver.js.map

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

package/dist/image.d.ts

@@ -1,40 +0,0 @@
-import type { ImageGenerationResult } from './types.js';
-/**
- * Fluent image generation facade.
- *
- * @example
- * const result = await ImageGenerator.of('A sunset over mountains').size('landscape').generate()
- * const path = await ImageGenerator.of('A logo').model('openai/dall-e-3').store('images/logo.png')
- *
- * @example  Failover across providers
- * const result = await ImageGenerator.of('A donut')
- *   .model('openai/dall-e-3')
- *   .failover('google/imagen-3', 'azure/dall-e-3')
- *   .generate()
- */
-export declare class ImageGenerator {
-    private readonly _prompt;
-    private _model;
-    private _size;
-    private _quality;
-    private _style;
-    private _n;
-    private _failover;
-    private constructor();
-    static of(prompt: string): ImageGenerator;
-    model(model: string): this;
-    /**
-     * Provider/model strings to try if the primary fails.
-     * Tried in order; the first to succeed wins. Swallows individual errors,
-     * surfaces only the last one if every candidate fails.
-     */
-    failover(...models: string[]): this;
-    size(size: string): this;
-    quality(quality: 'standard' | 'hd'): this;
-    style(style: 'natural' | 'vivid'): this;
-    count(n: number): this;
-    generate(): Promise<ImageGenerationResult>;
-    /** Generate and store the first image to storage. Requires @rudderjs/storage. */
-    store(path: string): Promise<string>;
-}
-//# sourceMappingURL=image.d.ts.map

package/dist/image.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../src/image.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA0B,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAE/E;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAc;IAQL,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP5C,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,SAAS,CAAe;IAEhC,OAAO;IAEP,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc;IAIzC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK1B;;;;OAIG;IACH,QAAQ,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAKnC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI;IAKzC,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,IAAI;IAKvC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKhB,QAAQ,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAyBhD,iFAAiF;IAC3E,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAwB3C"}

package/dist/image.js

@@ -1,109 +0,0 @@
-import { AiRegistry, tryWithFailover } from './registry.js';
-import { fromBase64 } from './base64.js';
-/**
- * Fluent image generation facade.
- *
- * @example
- * const result = await ImageGenerator.of('A sunset over mountains').size('landscape').generate()
- * const path = await ImageGenerator.of('A logo').model('openai/dall-e-3').store('images/logo.png')
- *
- * @example  Failover across providers
- * const result = await ImageGenerator.of('A donut')
- *   .model('openai/dall-e-3')
- *   .failover('google/imagen-3', 'azure/dall-e-3')
- *   .generate()
- */
-export class ImageGenerator {
-    _prompt;
-    _model;
-    _size;
-    _quality;
-    _style;
-    _n;
-    _failover = [];
-    constructor(_prompt) {
-        this._prompt = _prompt;
-    }
-    static of(prompt) {
-        return new ImageGenerator(prompt);
-    }
-    model(model) {
-        this._model = model;
-        return this;
-    }
-    /**
-     * Provider/model strings to try if the primary fails.
-     * Tried in order; the first to succeed wins. Swallows individual errors,
-     * surfaces only the last one if every candidate fails.
-     */
-    failover(...models) {
-        this._failover = models;
-        return this;
-    }
-    size(size) {
-        this._size = size;
-        return this;
-    }
-    quality(quality) {
-        this._quality = quality;
-        return this;
-    }
-    style(style) {
-        this._style = style;
-        return this;
-    }
-    count(n) {
-        this._n = n;
-        return this;
-    }
-    async generate() {
-        const primary = this._model ?? AiRegistry.getDefault();
-        return tryWithFailover(primary, this._failover, async (modelStr) => {
-            const [providerName, modelName] = AiRegistry.parseModelString(modelStr);
-            const factory = AiRegistry.getFactory(providerName);
-            if (!factory.createImage) {
-                throw new Error(`[Rudder AI] Provider "${providerName}" does not support image generation.`);
-            }
-            const adapter = factory.createImage(modelName);
-            const options = {
-                prompt: this._prompt,
-                model: modelStr,
-            };
-            if (this._size !== undefined)
-                options.size = this._size;
-            if (this._quality !== undefined)
-                options.quality = this._quality;
-            if (this._style !== undefined)
-                options.style = this._style;
-            if (this._n !== undefined)
-                options.n = this._n;
-            return adapter.generate(options);
-        });
-    }
-    /** Generate and store the first image to storage. Requires @rudderjs/storage. */
-    async store(path) {
-        const result = await this.generate();
-        const image = result.images[0];
-        if (!image)
-            throw new Error('[Rudder AI] No image generated.');
-        try {
-            // eslint-disable-next-line @typescript-eslint/no-require-imports
-            const mod = await import(/* @vite-ignore */ '@rudderjs/storage');
-            const Storage = mod.Storage;
-            if (image.base64) {
-                const bytes = fromBase64(image.base64);
-                await Storage.put(path, bytes);
-            }
-            else if (image.url) {
-                const response = await fetch(image.url);
-                const bytes = new Uint8Array(await response.arrayBuffer());
-                await Storage.put(path, bytes);
-            }
-            return path;
-        }
-        catch {
-            throw new Error('[Rudder AI] Image storage requires @rudderjs/storage to be installed.');
-        }
-    }
-}
-//# sourceMappingURL=image.js.map

package/dist/image.js.map

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

package/dist/mcp/client-tools.d.ts

@@ -1,39 +0,0 @@
-import type { Tool } from '../types.js';
-import type { McpClientTransport, McpClientToolsOptions } from './types.js';
-/**
- * The result of `mcpClientTools()` — an array of `Tool`s that also carries a
- * `close()` method when this call owns the underlying client lifecycle.
- *
- * Spreading this into `tools()` works because the extra method is non-enumerable
- * (and only present when relevant) — the agent loop iterates with for-of which
- * skips it.
- */
-export interface McpClientToolsHandle extends ReadonlyArray<Tool> {
-    /** Disconnect the underlying MCP client. No-op when an external client was passed in. */
-    close?: () => Promise<void>;
-}
-/**
- * Connect to a remote MCP server and surface its tools as RudderJS `Tool`s.
- *
- * Three transport shapes are accepted:
- *
- * ```ts
- * // (a) HTTP — string URL or URL instance
- * const t = await mcpClientTools('https://api.example.com/mcp')
- *
- * // (b) Local stdio subprocess
- * const t = await mcpClientTools({ command: 'npx', args: ['some-mcp-server'] })
- *
- * // (c) Already-connected SDK Client (caller owns lifecycle)
- * const t = await mcpClientTools(myClient)
- * ```
- *
- * The returned array exposes a `close()` method when this call owns the client
- * (cases a + b). Pass it back so the subprocess / HTTP session can shut down
- * cleanly when your agent is done.
- *
- * The remote server's `inputSchema` (JSON Schema) ships through to providers
- * via `ToolDefinitionOptions.jsonSchema` — no zod conversion in either direction.
- */
-export declare function mcpClientTools(transport: McpClientTransport, opts?: McpClientToolsOptions): Promise<McpClientToolsHandle>;
-//# sourceMappingURL=client-tools.d.ts.map

package/dist/mcp/client-tools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/client-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAmB,MAAM,aAAa,CAAA;AACxD,OAAO,KAAK,EACV,kBAAkB,EAAE,qBAAqB,EAC1C,MAAM,YAAY,CAAA;AAInB;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAqB,SAAQ,aAAa,CAAC,IAAI,CAAC;IAC/D,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,kBAAkB,EAC7B,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CA4B/B"}