@rudderjs/ai 1.17.3 → 1.18.0

package/dist/file-search.js

@@ -1,158 +0,0 @@
-/**
- * `fileSearch({ stores, where?, maxResults?, name?, description? })` — agent
- * tool factory for hosted vector-store retrieval (#B8 Phase 2).
- *
- * Wraps OpenAI's native `file_search` tool. The tool object is tagged with
- * `providerHint: { type: 'file-search', ... }`; the OpenAI adapter's
- * `toOpenAITools` recognizes the hint and emits the native
- * `{ type: 'file_search', vector_store_ids, filters, max_num_results }`
- * block instead of a generic function-call shape. The model runs the search
- * server-side and the results land in the assistant message — no agent-loop
- * tool round-trip on the hosted path.
- *
- * # Hosted on OpenAI today
- *
- * Other providers see the tool as a regular function-call tool with the
- * placeholder `{ query: string }` schema — without an `execute` they pause
- * for client tools, which is degraded. Phase 3 will add a `fallback` opt
- * that installs an `execute` delegating to `similaritySearch` over a local
- * pgvector model.
- *
- * # Wiring
- *
- * ```ts
- * import { Agent, fileSearch, VectorStores } from '@rudderjs/ai'
- *
- * const kb = await VectorStores.get('vs_abc123')
- *
- * class SupportAgent extends Agent {
- *   model() { return 'openai/gpt-4o' }
- *   tools() {
- *     return [
- *       fileSearch({
- *         stores:     [kb.id],
- *         where:      { author: 'Alice', year: 2026 },
- *         maxResults: 10,
- *       }),
- *     ]
- *   }
- * }
- * ```
- *
- * # Metadata filter sugar
- *
- * `where: { author: 'Alice', year: 2026 }` is shorthand for the typed
- * OpenAI filter shape `{ type: 'and', filters: [{ type: 'eq', key: 'author',
- * value: 'Alice' }, { type: 'eq', key: 'year', value: 2026 }] }`. Either
- * shape works — pass the typed object form for `gt` / `lt` / `or`.
- */
-import { z } from 'zod';
-import { similaritySearch } from './similarity-search.js';
-/**
- * Symbol-tagged marker identifying a file-search tool. Mirrors the
- * `COMPUTER_USE_MARKER` pattern — `Symbol.for(...)` so cross-bundle /
- * cross-realm checks succeed even when `@rudderjs/ai` loads twice.
- */
-export const FILE_SEARCH_MARKER = Symbol.for('rudderjs.ai.file-search');
-/**
- * Default tool name. OpenAI's native `file_search` tool expects calls to
- * land on a tool literally named `file_search` — the model is trained on
- * that identifier. Apps can override via `opts.name` but usually shouldn't.
- */
-export const FILE_SEARCH_TOOL_NAME = 'file_search';
-const DEFAULT_DESCRIPTION = 'Search the configured knowledge base(s) for documents relevant to the query. ' +
-    'Returns the most relevant passages alongside the source document metadata.';
-/** Build the agent tool. See module JSDoc for usage. */
-export function fileSearch(opts) {
-    if (!Array.isArray(opts.stores) || opts.stores.length === 0) {
-        throw new Error('[Rudder AI] fileSearch({ stores }) requires at least one vector-store id. ' +
-            'Create a store via `VectorStores.create(...)` and pass its `id`.');
-    }
-    const name = opts.name ?? FILE_SEARCH_TOOL_NAME;
-    const description = opts.description ?? DEFAULT_DESCRIPTION;
-    const filters = opts.where !== undefined ? normalizeWhere(opts.where) : undefined;
-    // The provider hint is the load-bearing piece — adapters recognizing
-    // `type === 'file-search'` substitute their native tool block.
-    const providerHint = { type: 'file-search', vector_store_ids: opts.stores };
-    if (filters)
-        providerHint['filters'] = filters;
-    if (opts.maxResults !== undefined)
-        providerHint['max_num_results'] = opts.maxResults;
-    const definition = {
-        name,
-        description,
-        // Placeholder schema. Non-OpenAI providers see this and treat the
-        // tool as a normal function-call. OpenAI's native block drops it.
-        inputSchema: z.object({ query: z.string().describe('Natural-language query.') }),
-        providerHint,
-    };
-    // Build the fallback execute when configured. The inner similaritySearch
-    // tool's name/description are overridden so structural identity stays on
-    // the outer fileSearch (the model still sees the same tool and prompt).
-    let execute;
-    let toModelOutput;
-    if (opts.fallback) {
-        const inner = similaritySearch({
-            ...opts.fallback,
-            name,
-            description,
-        });
-        execute = inner.execute;
-        toModelOutput = inner.toModelOutput;
-    }
-    const tool = {
-        [FILE_SEARCH_MARKER]: true,
-        definition,
-        ...(execute ? { execute } : {}),
-        ...(toModelOutput ? { toModelOutput } : {}),
-        toSchema() {
-            const schema = {
-                name,
-                description,
-                parameters: { type: 'object', properties: { query: { type: 'string' } }, required: ['query'] },
-                providerHint,
-            };
-            return schema;
-        },
-    };
-    return tool;
-}
-/**
- * Structural typeguard. Mirrors `isComputerUseTool` / `isHandoffTool` —
- * tools are plain objects tagged with `Symbol.for(...)` markers so the
- * loop and adapters can detect them without coupling to a class.
- */
-export function isFileSearchTool(t) {
-    if (t === null || typeof t !== 'object')
-        return false;
-    const marker = t[FILE_SEARCH_MARKER];
-    return marker === true;
-}
-/**
- * Lower the user-friendly `where` shape to OpenAI's typed filter object.
- *
- * - `{ author: 'Alice', year: 2026 }` → `{ type: 'and', filters: [eq, eq] }`
- * - `{ type: 'eq' | ... }`           → pass-through
- * - `{ type: 'and' | 'or', filters }` → pass-through
- *
- * A single-key sugar object short-circuits to the bare `eq` (no `and`
- * wrapper), matching OpenAI's recommended shape.
- */
-export function normalizeWhere(where) {
-    if (isTypedFilter(where))
-        return where;
-    const entries = Object.entries(where);
-    if (entries.length === 0) {
-        throw new Error('[Rudder AI] fileSearch({ where }) must contain at least one key.');
-    }
-    const eqs = entries.map(([key, value]) => ({ type: 'eq', key, value }));
-    return eqs.length === 1 ? eqs[0] : { type: 'and', filters: eqs };
-}
-function isTypedFilter(w) {
-    if (typeof w !== 'object' || w === null)
-        return false;
-    const t = w.type;
-    return typeof t === 'string'
-        && (t === 'eq' || t === 'ne' || t === 'gt' || t === 'gte' || t === 'lt' || t === 'lte' || t === 'and' || t === 'or');
-}
-//# sourceMappingURL=file-search.js.map

package/dist/file-search.js.map

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

package/dist/files.d.ts

@@ -1,27 +0,0 @@
-import type { FileUploadResult, FileListResult, FileContent } from './types.js';
-/**
- * Provider file management — upload, list, delete, and retrieve files
- * on provider platforms (OpenAI, Anthropic, Google).
- *
- * @example
- * const files = AI.files('openai')
- * const uploaded = await files.upload('./report.pdf', { purpose: 'assistants' })
- * const list = await files.list()
- * await files.delete(uploaded.id)
- */
-export declare class FileManager {
-    private readonly providerName;
-    private constructor();
-    static for(providerName: string): FileManager;
-    /** Upload a file to the provider */
-    upload(filePath: string, options?: {
-        purpose?: string | undefined;
-    }): Promise<FileUploadResult>;
-    /** List all files on the provider */
-    list(): Promise<FileListResult>;
-    /** Delete a file by ID */
-    delete(fileId: string): Promise<void>;
-    /** Retrieve file content by ID (not all providers support this) */
-    retrieve(fileId: string): Promise<FileContent>;
-}
-//# sourceMappingURL=files.d.ts.map

package/dist/files.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE/E;;;;;;;;;GASG;AACH,qBAAa,WAAW;IACF,OAAO,CAAC,QAAQ,CAAC,YAAY;IAAjD,OAAO;IAEP,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW;IAI7C,oCAAoC;IAC9B,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKrG,qCAAqC;IAC/B,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC;IAKrC,0BAA0B;IACpB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3C,mEAAmE;IAC7D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAOrD"}

package/dist/files.js

@@ -1,44 +0,0 @@
-import { AiRegistry } from './registry.js';
-/**
- * Provider file management — upload, list, delete, and retrieve files
- * on provider platforms (OpenAI, Anthropic, Google).
- *
- * @example
- * const files = AI.files('openai')
- * const uploaded = await files.upload('./report.pdf', { purpose: 'assistants' })
- * const list = await files.list()
- * await files.delete(uploaded.id)
- */
-export class FileManager {
-    providerName;
-    constructor(providerName) {
-        this.providerName = providerName;
-    }
-    static for(providerName) {
-        return new FileManager(providerName);
-    }
-    /** Upload a file to the provider */
-    async upload(filePath, options) {
-        const adapter = AiRegistry.resolveFiles(this.providerName);
-        return adapter.upload({ filePath, purpose: options?.purpose });
-    }
-    /** List all files on the provider */
-    async list() {
-        const adapter = AiRegistry.resolveFiles(this.providerName);
-        return adapter.list();
-    }
-    /** Delete a file by ID */
-    async delete(fileId) {
-        const adapter = AiRegistry.resolveFiles(this.providerName);
-        return adapter.delete(fileId);
-    }
-    /** Retrieve file content by ID (not all providers support this) */
-    async retrieve(fileId) {
-        const adapter = AiRegistry.resolveFiles(this.providerName);
-        if (!adapter.retrieve) {
-            throw new Error(`[Rudder AI] Provider "${this.providerName}" does not support file retrieval.`);
-        }
-        return adapter.retrieve(fileId);
-    }
-}
-//# sourceMappingURL=files.js.map

package/dist/files.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"files.js","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAG1C;;;;;;;;;GASG;AACH,MAAM,OAAO,WAAW;IACe;IAArC,YAAqC,YAAoB;QAApB,iBAAY,GAAZ,YAAY,CAAQ;IAAG,CAAC;IAE7D,MAAM,CAAC,GAAG,CAAC,YAAoB;QAC7B,OAAO,IAAI,WAAW,CAAC,YAAY,CAAC,CAAA;IACtC,CAAC;IAED,oCAAoC;IACpC,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,OAA0C;QACvE,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAC1D,OAAO,OAAO,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;IAChE,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,IAAI;QACR,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAC1D,OAAO,OAAO,CAAC,IAAI,EAAE,CAAA;IACvB,CAAC;IAED,0BAA0B;IAC1B,KAAK,CAAC,MAAM,CAAC,MAAc;QACzB,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAC1D,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC/B,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,QAAQ,CAAC,MAAc;QAC3B,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAC1D,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,YAAY,oCAAoC,CAAC,CAAA;QACjG,CAAC;QACD,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IACjC,CAAC;CACF"}

package/dist/gateway/http-gateway-adapter.d.ts

@@ -1,94 +0,0 @@
-import type { ProviderAdapter, ProviderRequestOptions, ProviderResponse, StreamChunk } from '../types.js';
-import { type SseEvent } from './sse.js';
-/**
- * Connection config shared by every gateway adapter. Subclasses may extend
- * this with gateway-specific fields (region, project id, ...).
- */
-export interface GatewayAdapterConfig {
-    /** Base URL of the gateway endpoint. */
-    baseUrl: string;
-    /** Optional API key — surfaced for {@link HttpGatewayAdapter.buildHeaders}. */
-    apiKey?: string | undefined;
-    /** Static headers merged into every request (auth from `buildHeaders` wins). */
-    headers?: Record<string, string> | undefined;
-}
-/** Context passed to the request-shaping hooks. */
-export interface GatewayRequestContext {
-    /** `true` for the streaming (`stream()`) path, `false` for `generate()`. */
-    stream: boolean;
-}
-/**
- * Abstract template for normalizing an upstream LLM gateway behind the
- * framework's {@link ProviderAdapter} contract.
- *
- * This is the Laravel custom-driver pattern (Template Method): the base class
- * owns the reusable lifecycle — `fetch`, JSON / SSE handling, `AbortSignal`
- * wiring, and error mapping — and leaves four `protected abstract` hooks for
- * the gateway's wire format:
- *
- * - {@link buildHeaders} — the gateway's auth scheme.
- * - {@link buildRequestBody} — map {@link ProviderRequestOptions} → the
- *   gateway's request envelope.
- * - {@link parseResponse} — map a non-streaming response → {@link ProviderResponse}.
- * - {@link parseStreamEvent} — map one {@link SseEvent} → zero or more
- *   {@link StreamChunk}s.
- *
- * Reach for this only when the gateway's wire format matches no built-in
- * provider. An OpenAI- or Anthropic-compatible gateway needs no subclass:
- * register the `openai` / `anthropic` driver with a `baseUrl` override instead.
- *
- * Register a subclass through the usual factory path — `AiRegistry.register()`
- * (the framework's `extend()` equivalent).
- *
- * @example
- * ```ts
- * class AcmeGatewayAdapter extends HttpGatewayAdapter {
- *   protected buildHeaders() {
- *     return { authorization: `Bearer ${this.config.apiKey}` }
- *   }
- *   protected buildRequestBody(o: ProviderRequestOptions, ctx: GatewayRequestContext) {
- *     return { model: this.model, messages: o.messages, stream: ctx.stream }
- *   }
- *   protected parseResponse(json: any): ProviderResponse {
- *     return {
- *       message: { role: 'assistant', content: json.text },
- *       usage: { promptTokens: json.usage.in, completionTokens: json.usage.out, totalTokens: json.usage.total },
- *       finishReason: 'stop',
- *     }
- *   }
- *   protected parseStreamEvent(e: SseEvent): StreamChunk[] {
- *     if (e.data === '[DONE]') return [{ type: 'finish', finishReason: 'stop' }]
- *     const { delta } = JSON.parse(e.data)
- *     return delta ? [{ type: 'text-delta', text: delta }] : []
- *   }
- * }
- * ```
- */
-export declare abstract class HttpGatewayAdapter implements ProviderAdapter {
-    protected readonly config: GatewayAdapterConfig;
-    protected readonly model: string;
-    constructor(config: GatewayAdapterConfig, model: string);
-    generate(options: ProviderRequestOptions): Promise<ProviderResponse>;
-    stream(options: ProviderRequestOptions): AsyncIterable<StreamChunk>;
-    /** Perform the POST, wire the abort signal, and map error responses. */
-    private send;
-    /**
-     * Resolve the request URL. Defaults to {@link GatewayAdapterConfig.baseUrl}
-     * for both paths; override to append a path or branch on `ctx.stream`.
-     */
-    protected endpoint(_ctx: GatewayRequestContext): string;
-    /**
-     * Map a non-2xx response to an error. Override to parse a gateway-specific
-     * error envelope. The default reads the body as text and throws.
-     */
-    protected onErrorResponse(res: Response): Promise<never>;
-    /** Auth/identity headers for every request (merged over `config.headers`). */
-    protected abstract buildHeaders(): Record<string, string>;
-    /** Map the framework request to the gateway's request envelope. */
-    protected abstract buildRequestBody(options: ProviderRequestOptions, ctx: GatewayRequestContext): unknown;
-    /** Map a complete (non-streaming) gateway response to a {@link ProviderResponse}. */
-    protected abstract parseResponse(json: unknown): ProviderResponse;
-    /** Map one parsed {@link SseEvent} to zero or more {@link StreamChunk}s. */
-    protected abstract parseStreamEvent(event: SseEvent): StreamChunk[];
-}
-//# sourceMappingURL=http-gateway-adapter.d.ts.map

package/dist/gateway/http-gateway-adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"http-gateway-adapter.d.ts","sourceRoot":"","sources":["../../src/gateway/http-gateway-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,WAAW,EACZ,MAAM,aAAa,CAAA;AACpB,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAA;IACf,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;CAC7C;AAED,mDAAmD;AACnD,MAAM,WAAW,qBAAqB;IACpC,4EAA4E;IAC5E,MAAM,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,8BAAsB,kBAAmB,YAAW,eAAe;IAE/D,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,oBAAoB;IAC/C,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM;gBADb,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,MAAM;IAG5B,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAMnE,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,aAAa,CAAC,WAAW,CAAC;IAY1E,wEAAwE;YAC1D,IAAI;IAiBlB;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM;IAIvD;;;OAGG;cACa,eAAe,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC;IAS9D,8EAA8E;IAC9E,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAEzD,mEAAmE;IACnE,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CACjC,OAAO,EAAE,sBAAsB,EAC/B,GAAG,EAAE,qBAAqB,GACzB,OAAO;IAEV,qFAAqF;IACrF,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB;IAEjE,4EAA4E;IAC5E,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,WAAW,EAAE;CACpE"}

package/dist/gateway/http-gateway-adapter.js

@@ -1,106 +0,0 @@
-import { parseSseStream } from './sse.js';
-/**
- * Abstract template for normalizing an upstream LLM gateway behind the
- * framework's {@link ProviderAdapter} contract.
- *
- * This is the Laravel custom-driver pattern (Template Method): the base class
- * owns the reusable lifecycle — `fetch`, JSON / SSE handling, `AbortSignal`
- * wiring, and error mapping — and leaves four `protected abstract` hooks for
- * the gateway's wire format:
- *
- * - {@link buildHeaders} — the gateway's auth scheme.
- * - {@link buildRequestBody} — map {@link ProviderRequestOptions} → the
- *   gateway's request envelope.
- * - {@link parseResponse} — map a non-streaming response → {@link ProviderResponse}.
- * - {@link parseStreamEvent} — map one {@link SseEvent} → zero or more
- *   {@link StreamChunk}s.
- *
- * Reach for this only when the gateway's wire format matches no built-in
- * provider. An OpenAI- or Anthropic-compatible gateway needs no subclass:
- * register the `openai` / `anthropic` driver with a `baseUrl` override instead.
- *
- * Register a subclass through the usual factory path — `AiRegistry.register()`
- * (the framework's `extend()` equivalent).
- *
- * @example
- * ```ts
- * class AcmeGatewayAdapter extends HttpGatewayAdapter {
- *   protected buildHeaders() {
- *     return { authorization: `Bearer ${this.config.apiKey}` }
- *   }
- *   protected buildRequestBody(o: ProviderRequestOptions, ctx: GatewayRequestContext) {
- *     return { model: this.model, messages: o.messages, stream: ctx.stream }
- *   }
- *   protected parseResponse(json: any): ProviderResponse {
- *     return {
- *       message: { role: 'assistant', content: json.text },
- *       usage: { promptTokens: json.usage.in, completionTokens: json.usage.out, totalTokens: json.usage.total },
- *       finishReason: 'stop',
- *     }
- *   }
- *   protected parseStreamEvent(e: SseEvent): StreamChunk[] {
- *     if (e.data === '[DONE]') return [{ type: 'finish', finishReason: 'stop' }]
- *     const { delta } = JSON.parse(e.data)
- *     return delta ? [{ type: 'text-delta', text: delta }] : []
- *   }
- * }
- * ```
- */
-export class HttpGatewayAdapter {
-    config;
-    model;
-    constructor(config, model) {
-        this.config = config;
-        this.model = model;
-    }
-    async generate(options) {
-        const res = await this.send(options, { stream: false });
-        const json = (await res.json());
-        return this.parseResponse(json);
-    }
-    async *stream(options) {
-        const res = await this.send(options, { stream: true });
-        if (!res.body) {
-            throw new Error('[Rudder AI] Gateway stream response had no body');
-        }
-        for await (const event of parseSseStream(res.body, options.signal)) {
-            for (const chunk of this.parseStreamEvent(event))
-                yield chunk;
-        }
-    }
-    // ─── reusable plumbing ─────────────────────────────────────
-    /** Perform the POST, wire the abort signal, and map error responses. */
-    async send(options, ctx) {
-        const headers = {
-            'content-type': 'application/json',
-            accept: ctx.stream ? 'text/event-stream' : 'application/json',
-            ...this.config.headers,
-            ...this.buildHeaders(),
-        };
-        const res = await fetch(this.endpoint(ctx), {
-            method: 'POST',
-            headers,
-            body: JSON.stringify(this.buildRequestBody(options, ctx)),
-            ...(options.signal ? { signal: options.signal } : {}),
-        });
-        if (!res.ok)
-            await this.onErrorResponse(res);
-        return res;
-    }
-    /**
-     * Resolve the request URL. Defaults to {@link GatewayAdapterConfig.baseUrl}
-     * for both paths; override to append a path or branch on `ctx.stream`.
-     */
-    endpoint(_ctx) {
-        return this.config.baseUrl;
-    }
-    /**
-     * Map a non-2xx response to an error. Override to parse a gateway-specific
-     * error envelope. The default reads the body as text and throws.
-     */
-    async onErrorResponse(res) {
-        const body = await res.text().catch(() => '');
-        throw new Error(`[Rudder AI] Gateway request failed: ${res.status} ${res.statusText}${body ? ` — ${body}` : ''}`);
-    }
-}
-//# sourceMappingURL=http-gateway-adapter.js.map

package/dist/gateway/http-gateway-adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"http-gateway-adapter.js","sourceRoot":"","sources":["../../src/gateway/http-gateway-adapter.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAiB,MAAM,UAAU,CAAA;AAqBxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,OAAgB,kBAAkB;IAEjB;IACA;IAFrB,YACqB,MAA4B,EAC5B,KAAa;QADb,WAAM,GAAN,MAAM,CAAsB;QAC5B,UAAK,GAAL,KAAK,CAAQ;IAC/B,CAAC;IAEJ,KAAK,CAAC,QAAQ,CAAC,OAA+B;QAC5C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;QACvD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAY,CAAA;QAC1C,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;IACjC,CAAC;IAED,KAAK,CAAC,CAAC,MAAM,CAAC,OAA+B;QAC3C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QACtD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;QACpE,CAAC;QACD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAA;QAC/D,CAAC;IACH,CAAC;IAED,8DAA8D;IAE9D,wEAAwE;IAChE,KAAK,CAAC,IAAI,CAAC,OAA+B,EAAE,GAA0B;QAC5E,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,kBAAkB;YAC7D,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO;YACtB,GAAG,IAAI,CAAC,YAAY,EAAE;SACvB,CAAA;QACD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;YAC1C,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACzD,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAA;QAC5C,OAAO,GAAG,CAAA;IACZ,CAAC;IAED;;;OAGG;IACO,QAAQ,CAAC,IAA2B;QAC5C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAA;IAC5B,CAAC;IAED;;;OAGG;IACO,KAAK,CAAC,eAAe,CAAC,GAAa;QAC3C,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QAC7C,MAAM,IAAI,KAAK,CACb,uCAAuC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACjG,CAAA;IACH,CAAC;CAkBF"}

package/dist/gateway/sse.d.ts

@@ -1,28 +0,0 @@
-/**
- * A single Server-Sent Event frame, parsed from a `text/event-stream` body.
- *
- * Only the two fields LLM gateways use in practice are surfaced: the optional
- * `event:` name and the (possibly multi-line) `data:` payload. Comment lines
- * (`:`-prefixed) and `id:` / `retry:` fields are consumed and ignored.
- */
-export interface SseEvent {
-    /** The `event:` field, if the frame declared one. */
-    event?: string | undefined;
-    /** The concatenated `data:` payload (multiple `data:` lines joined by `\n`). */
-    data: string;
-}
-/**
- * Frame a `text/event-stream` response body into {@link SseEvent}s.
- *
- * Standalone and dependency-free so the gateway template ships its own
- * framing — every built-in chat provider streams through a vendor SDK, so
- * there is no shared framer to reuse. Handles `\n` and `\r\n` line endings,
- * multi-line `data:` payloads, and back-pressure-friendly chunk boundaries
- * (an event split across two network reads is buffered until complete).
- *
- * Aborts cleanly: when `signal` fires, the reader is cancelled and iteration
- * ends. A trailing event with no terminating blank line is still yielded once
- * the stream closes.
- */
-export declare function parseSseStream(body: ReadableStream<Uint8Array>, signal?: AbortSignal): AsyncGenerator<SseEvent>;
-//# sourceMappingURL=sse.d.ts.map

package/dist/gateway/sse.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/gateway/sse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;;;;;;;;GAYG;AACH,wBAAuB,cAAc,CACnC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,MAAM,CAAC,EAAE,WAAW,GACnB,cAAc,CAAC,QAAQ,CAAC,CAuC1B"}

package/dist/gateway/sse.js

@@ -1,78 +0,0 @@
-/**
- * Frame a `text/event-stream` response body into {@link SseEvent}s.
- *
- * Standalone and dependency-free so the gateway template ships its own
- * framing — every built-in chat provider streams through a vendor SDK, so
- * there is no shared framer to reuse. Handles `\n` and `\r\n` line endings,
- * multi-line `data:` payloads, and back-pressure-friendly chunk boundaries
- * (an event split across two network reads is buffered until complete).
- *
- * Aborts cleanly: when `signal` fires, the reader is cancelled and iteration
- * ends. A trailing event with no terminating blank line is still yielded once
- * the stream closes.
- */
-export async function* parseSseStream(body, signal) {
-    const reader = body.getReader();
-    const decoder = new TextDecoder();
-    let buffer = '';
-    const onAbort = () => {
-        void reader.cancel().catch(() => { });
-    };
-    signal?.addEventListener('abort', onAbort, { once: true });
-    try {
-        while (true) {
-            if (signal?.aborted)
-                return;
-            const { done, value } = await reader.read();
-            if (done)
-                break;
-            buffer += decoder.decode(value, { stream: true });
-            // Events are separated by a blank line. Normalize CRLF to LF first so a
-            // single split handles both endings.
-            let sep;
-            buffer = buffer.replace(/\r\n/g, '\n');
-            while ((sep = buffer.indexOf('\n\n')) !== -1) {
-                const raw = buffer.slice(0, sep);
-                buffer = buffer.slice(sep + 2);
-                const event = parseFrame(raw);
-                if (event)
-                    yield event;
-            }
-        }
-        // Flush a final frame that arrived without a trailing blank line.
-        const tail = (buffer + decoder.decode()).replace(/\r\n/g, '\n').trim();
-        if (tail) {
-            const event = parseFrame(tail);
-            if (event)
-                yield event;
-        }
-    }
-    finally {
-        signal?.removeEventListener('abort', onAbort);
-        reader.releaseLock();
-    }
-}
-/** Parse one raw SSE frame (the text between blank-line separators). */
-function parseFrame(raw) {
-    let event;
-    const dataLines = [];
-    for (const line of raw.split('\n')) {
-        if (line === '' || line.startsWith(':'))
-            continue; // blank or comment
-        const colon = line.indexOf(':');
-        const field = colon === -1 ? line : line.slice(0, colon);
-        // Per spec, a single leading space after the colon is stripped.
-        let value = colon === -1 ? '' : line.slice(colon + 1);
-        if (value.startsWith(' '))
-            value = value.slice(1);
-        if (field === 'event')
-            event = value;
-        else if (field === 'data')
-            dataLines.push(value);
-        // id / retry / unknown fields ignored
-    }
-    if (dataLines.length === 0 && event === undefined)
-        return null;
-    return { ...(event !== undefined ? { event } : {}), data: dataLines.join('\n') };
-}
-//# sourceMappingURL=sse.js.map

package/dist/gateway/sse.js.map

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