@rudderjs/ai 1.17.2 → 1.18.0

package/dist/registry.d.ts

@@ -1,45 +0,0 @@
-import type { AiModelConfig, ProviderFactory, ProviderAdapter, RerankingAdapter, FileAdapter, VectorStoreAdapter } from './types.js';
-/**
- * Try a list of provider/model strings in order until one succeeds.
- *
- * Used by the media-generation paths (Image, Audio, Transcription) to give
- * the same failover ergonomics agents already have. The first model is the
- * "primary"; the rest are fallbacks. Errors from earlier candidates are
- * swallowed; only the last error is thrown if every candidate fails.
- *
- * The agent loop has its own failover wired into LoopContext (telemetry,
- * abort handling, observer attempts counter). This is a simpler helper for
- * single-shot calls outside the agent loop.
- *
- * @param primary    The user's chosen model string (e.g. `'openai/dall-e-3'`).
- * @param fallbacks  Additional candidates to try on failure.
- * @param call       Receives each candidate model string and runs the work.
- */
-export declare function tryWithFailover<T>(primary: string, fallbacks: readonly string[], call: (modelString: string) => Promise<T>): Promise<T>;
-export declare class AiRegistry {
-    /** Register a provider factory */
-    static register(factory: ProviderFactory): void;
-    /** Get a registered provider factory by name */
-    static getFactory(name: string): ProviderFactory;
-    /** Set the default provider/model string */
-    static setDefault(modelString: string): void;
-    /** Get the default provider/model string */
-    static getDefault(): string;
-    /** Parse 'provider/model' string into [providerName, modelId] */
-    static parseModelString(modelString: string): [string, string];
-    /** Resolve a provider/model string to a ProviderAdapter */
-    static resolve(modelString: string): ProviderAdapter;
-    /** Resolve a provider/model string to a RerankingAdapter */
-    static resolveReranking(modelString: string): RerankingAdapter;
-    /** Resolve a file adapter for a provider name */
-    static resolveFiles(providerName: string): FileAdapter;
-    /** Resolve a vector-store adapter for a provider name (#B8) */
-    static resolveVectorStores(providerName: string): VectorStoreAdapter;
-    /** Set available models for user selection */
-    static setModels(models: AiModelConfig[]): void;
-    /** Get available models */
-    static getModels(): AiModelConfig[];
-    /** Test-cleanup hook (public — other packages reset across the boundary). */
-    static reset(): void;
-}
-//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpI;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACxC,OAAO,CAAC,CAAC,CAAC,CAaZ;AA4CD,qBAAa,UAAU;IACrB,kCAAkC;IAClC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAI/C,gDAAgD;IAChD,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAMhD,4CAA4C;IAC5C,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAI5C,4CAA4C;IAC5C,MAAM,CAAC,UAAU,IAAI,MAAM;IAK3B,iEAAiE;IACjE,MAAM,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAM9D,2DAA2D;IAC3D,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe;IAMpD,4DAA4D;IAC5D,MAAM,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB;IAY9D,iDAAiD;IACjD,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW;IAWtD,+DAA+D;IAC/D,MAAM,CAAC,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,kBAAkB;IAYpE,8CAA8C;IAC9C,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI;IAI/C,2BAA2B;IAC3B,MAAM,CAAC,SAAS,IAAI,aAAa,EAAE;IAInC,6EAA6E;IAC7E,MAAM,CAAC,KAAK,IAAI,IAAI;CAMrB"}

package/dist/registry.js

@@ -1,131 +0,0 @@
-/**
- * Try a list of provider/model strings in order until one succeeds.
- *
- * Used by the media-generation paths (Image, Audio, Transcription) to give
- * the same failover ergonomics agents already have. The first model is the
- * "primary"; the rest are fallbacks. Errors from earlier candidates are
- * swallowed; only the last error is thrown if every candidate fails.
- *
- * The agent loop has its own failover wired into LoopContext (telemetry,
- * abort handling, observer attempts counter). This is a simpler helper for
- * single-shot calls outside the agent loop.
- *
- * @param primary    The user's chosen model string (e.g. `'openai/dall-e-3'`).
- * @param fallbacks  Additional candidates to try on failure.
- * @param call       Receives each candidate model string and runs the work.
- */
-export async function tryWithFailover(primary, fallbacks, call) {
-    const candidates = fallbacks.length > 0
-        ? [primary, ...fallbacks.filter((m) => m !== primary)]
-        : [primary];
-    let lastError;
-    for (const m of candidates) {
-        try {
-            return await call(m);
-        }
-        catch (err) {
-            lastError = err instanceof Error ? err : new Error(String(err));
-        }
-    }
-    throw lastError ?? new Error('[Rudder AI] No provider available for failover.');
-}
-const _g = globalThis;
-if (!_g['__rudderjs_ai_registry__']) {
-    _g['__rudderjs_ai_registry__'] = {
-        factories: new Map(),
-        default: null,
-        models: [],
-    };
-}
-const _store = _g['__rudderjs_ai_registry__'];
-// Reset listeners — modules that hold registry-shaped caches (e.g. the
-// facade's embedding-adapter cache) subscribe here so `AiRegistry.reset()`
-// clears them in lock-step. Survives reload via the same global slot.
-if (!_g['__rudderjs_ai_reset_listeners__']) {
-    _g['__rudderjs_ai_reset_listeners__'] = new Set();
-}
-const _resetListeners = _g['__rudderjs_ai_reset_listeners__'];
-/** Test-cleanup hook (@internal — subscribe to `AiRegistry.reset()` to clear adjacent caches. ). Kept public — other packages reset across the boundary. */
-export function _onAiRegistryReset(fn) { _resetListeners.add(fn); }
-export class AiRegistry {
-    /** Register a provider factory */
-    static register(factory) {
-        _store.factories.set(factory.name, factory);
-    }
-    /** Get a registered provider factory by name */
-    static getFactory(name) {
-        const f = _store.factories.get(name);
-        if (!f)
-            throw new Error(`[Rudder AI] Unknown AI provider "${name}". Register it first.`);
-        return f;
-    }
-    /** Set the default provider/model string */
-    static setDefault(modelString) {
-        _store.default = modelString;
-    }
-    /** Get the default provider/model string */
-    static getDefault() {
-        if (!_store.default)
-            throw new Error('[Rudder AI] No default model set. Add ai() to providers with a config.');
-        return _store.default;
-    }
-    /** Parse 'provider/model' string into [providerName, modelId] */
-    static parseModelString(modelString) {
-        const slash = modelString.indexOf('/');
-        if (slash === -1)
-            throw new Error(`[Rudder AI] Invalid model string "${modelString}". Expected "provider/model" format.`);
-        return [modelString.slice(0, slash), modelString.slice(slash + 1)];
-    }
-    /** Resolve a provider/model string to a ProviderAdapter */
-    static resolve(modelString) {
-        const [providerName, model] = this.parseModelString(modelString);
-        const factory = this.getFactory(providerName);
-        return factory.create(model);
-    }
-    /** Resolve a provider/model string to a RerankingAdapter */
-    static resolveReranking(modelString) {
-        const [providerName, model] = this.parseModelString(modelString);
-        const factory = this.getFactory(providerName);
-        if (!factory.createReranking) {
-            throw new Error(`[Rudder AI] Provider "${providerName}" does not support reranking. ` +
-                `Use a provider that implements createReranking() (e.g. cohere, jina).`);
-        }
-        return factory.createReranking(model);
-    }
-    /** Resolve a file adapter for a provider name */
-    static resolveFiles(providerName) {
-        const factory = this.getFactory(providerName);
-        if (!factory.createFiles) {
-            throw new Error(`[Rudder AI] Provider "${providerName}" does not support file management. ` +
-                `Use a provider that implements createFiles() (e.g. openai, anthropic, google).`);
-        }
-        return factory.createFiles();
-    }
-    /** Resolve a vector-store adapter for a provider name (#B8) */
-    static resolveVectorStores(providerName) {
-        const factory = this.getFactory(providerName);
-        if (!factory.createVectorStores) {
-            throw new Error(`[Rudder AI] Provider "${providerName}" does not support hosted vector stores. ` +
-                `Use a provider that implements createVectorStores() (e.g. openai). ` +
-                `For self-hosted RAG, use similaritySearch() against an @rudderjs/orm Model with a pgvector column.`);
-        }
-        return factory.createVectorStores();
-    }
-    /** Set available models for user selection */
-    static setModels(models) {
-        _store.models = models;
-    }
-    /** Get available models */
-    static getModels() {
-        return _store.models;
-    }
-    /** Test-cleanup hook (public — other packages reset across the boundary). */
-    static reset() {
-        _store.factories.clear();
-        _store.default = null;
-        _store.models = [];
-        for (const fn of _resetListeners)
-            fn();
-    }
-}
-//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/rerank.d.ts

@@ -1,20 +0,0 @@
-import type { RerankingResult } from './types.js';
-/**
- * Fluent reranking builder.
- *
- * @example
- * const result = await Reranker.of('search query', documents).topK(5).rank()
- * const result = await Reranker.of('query', docs).model('cohere/rerank-v3.5').rank()
- */
-export declare class Reranker {
-    private readonly _query;
-    private readonly _documents;
-    private _model;
-    private _topK;
-    private constructor();
-    static of(query: string, documents: string[]): Reranker;
-    model(model: string): this;
-    topK(k: number): this;
-    rank(): Promise<RerankingResult>;
-}
-//# sourceMappingURL=rerank.d.ts.map

package/dist/rerank.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rerank.d.ts","sourceRoot":"","sources":["../src/rerank.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;GAMG;AACH,qBAAa,QAAQ;IAKjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAL7B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAAoB;IAEjC,OAAO;IAKP,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,QAAQ;IAIvD,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK1B,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKf,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;CAWvC"}

package/dist/rerank.js

@@ -1,40 +0,0 @@
-import { AiRegistry } from './registry.js';
-/**
- * Fluent reranking builder.
- *
- * @example
- * const result = await Reranker.of('search query', documents).topK(5).rank()
- * const result = await Reranker.of('query', docs).model('cohere/rerank-v3.5').rank()
- */
-export class Reranker {
-    _query;
-    _documents;
-    _model;
-    _topK;
-    constructor(_query, _documents) {
-        this._query = _query;
-        this._documents = _documents;
-    }
-    static of(query, documents) {
-        return new Reranker(query, documents);
-    }
-    model(model) {
-        this._model = model;
-        return this;
-    }
-    topK(k) {
-        this._topK = k;
-        return this;
-    }
-    async rank() {
-        const modelStr = this._model ?? AiRegistry.getDefault();
-        const adapter = AiRegistry.resolveReranking(modelStr);
-        return adapter.rerank({
-            query: this._query,
-            documents: this._documents,
-            model: modelStr,
-            topK: this._topK,
-        });
-    }
-}
-//# sourceMappingURL=rerank.js.map

package/dist/rerank.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"rerank.js","sourceRoot":"","sources":["../src/rerank.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAG1C;;;;;;GAMG;AACH,MAAM,OAAO,QAAQ;IAKA;IACA;IALX,MAAM,CAAoB;IAC1B,KAAK,CAAoB;IAEjC,YACmB,MAAc,EACd,UAAoB;QADpB,WAAM,GAAN,MAAM,CAAQ;QACd,eAAU,GAAV,UAAU,CAAU;IACpC,CAAC;IAEJ,MAAM,CAAC,EAAE,CAAC,KAAa,EAAE,SAAmB;QAC1C,OAAO,IAAI,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;IACvC,CAAC;IAED,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACnB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,CAAC,CAAS;QACZ,IAAI,CAAC,KAAK,GAAG,CAAC,CAAA;QACd,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC,UAAU,EAAE,CAAA;QACvD,MAAM,OAAO,GAAG,UAAU,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QAErD,OAAO,OAAO,CAAC,MAAM,CAAC;YACpB,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,KAAK,EAAE,QAAQ;YACf,IAAI,EAAE,IAAI,CAAC,KAAK;SACjB,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/resume-approval.d.ts

@@ -1,30 +0,0 @@
-import type { AgentPromptOptions, AiMessage, AnyTool, ToolCall } from './types.js';
-/**
- * When continuing a chat after a stop-on-approval round-trip, the supplied
- * `messages` array ends with an `assistant` message whose `toolCalls` were
- * never fulfilled (the loop paused before executing them). Most providers
- * (Anthropic in particular) reject such conversations because every
- * `tool_use` block must be followed by a matching `tool_result`.
- *
- * This helper detects that case, executes the pending **server** tool calls
- * (honoring `approvedToolCallIds` / `rejectedToolCallIds`), appends the
- * resulting tool messages to `messages` in place, and returns them. The
- * caller can attach the returned list to `AgentResponse.resumedToolMessages`
- * so that the panels dispatcher persists them in the conversation store.
- *
- * Client tools (no `execute`) must come back from the browser with their
- * tool result already in the conversation, so the trailing assistant message
- * will not have unmatched `toolCalls` for them — they're handled outside.
- */
-export declare function resumePendingToolCalls(deps: {
-    messages: AiMessage[];
-    toolMap: Map<string, AnyTool>;
-    options: AgentPromptOptions | undefined;
-}): Promise<{
-    resumed: AiMessage[];
-    approvalStillRequired: {
-        toolCall: ToolCall;
-        isClientTool: boolean;
-    } | undefined;
-}>;
-//# sourceMappingURL=resume-approval.d.ts.map

package/dist/resume-approval.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resume-approval.d.ts","sourceRoot":"","sources":["../src/resume-approval.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAElF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,QAAQ,EAAE,SAAS,EAAE,CAAA;IACrB,OAAO,EAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,OAAO,EAAG,kBAAkB,GAAG,SAAS,CAAA;CACzC,GAAG,OAAO,CAAC;IACV,OAAO,EAAgB,SAAS,EAAE,CAAA;IAClC,qBAAqB,EAAE;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,YAAY,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAA;CACjF,CAAC,CA8HD"}

package/dist/resume-approval.js

@@ -1,147 +0,0 @@
-import { applyToModelOutput, evaluateApproval, executeMaybeStreaming, validateToolArgs, } from './tool-helpers.js';
-/**
- * When continuing a chat after a stop-on-approval round-trip, the supplied
- * `messages` array ends with an `assistant` message whose `toolCalls` were
- * never fulfilled (the loop paused before executing them). Most providers
- * (Anthropic in particular) reject such conversations because every
- * `tool_use` block must be followed by a matching `tool_result`.
- *
- * This helper detects that case, executes the pending **server** tool calls
- * (honoring `approvedToolCallIds` / `rejectedToolCallIds`), appends the
- * resulting tool messages to `messages` in place, and returns them. The
- * caller can attach the returned list to `AgentResponse.resumedToolMessages`
- * so that the panels dispatcher persists them in the conversation store.
- *
- * Client tools (no `execute`) must come back from the browser with their
- * tool result already in the conversation, so the trailing assistant message
- * will not have unmatched `toolCalls` for them — they're handled outside.
- */
-export async function resumePendingToolCalls(deps) {
-    const { messages, toolMap, options } = deps;
-    // Strip trailing pending-approval placeholders from a prior partial resume.
-    // They were synthesized so every `tool_use` in the parent assistant message
-    // had a matching `tool_result` during the pause; on resume we re-walk the
-    // parent and append fresh results (real or placeholder) based on the
-    // latest approval state.
-    while (messages.length > 0) {
-        const tail = messages[messages.length - 1];
-        if (tail.role === 'tool' && tail._pending) {
-            messages.pop();
-        }
-        else
-            break;
-    }
-    // Find the parent assistant message — it's the most recent assistant
-    // message immediately followed only by tool messages. On a fresh pause
-    // there are no tools yet; on a subsequent resume the parent is buried
-    // under the real tool results we appended last time.
-    let parentIdx = messages.length - 1;
-    while (parentIdx >= 0 && messages[parentIdx].role === 'tool')
-        parentIdx--;
-    const last = parentIdx >= 0 ? messages[parentIdx] : undefined;
-    if (!last || last.role !== 'assistant' || !last.toolCalls || last.toolCalls.length === 0) {
-        return { resumed: [], approvalStillRequired: undefined };
-    }
-    // Collect tool-call ids already resolved in a prior partial resume — those
-    // trail the parent assistant as non-`_pending` tool messages. Skipping
-    // them on the next walk avoids double-executing approved tools.
-    const alreadyResolved = new Set();
-    for (let i = parentIdx + 1; i < messages.length; i++) {
-        const m = messages[i];
-        if (m.role !== 'tool')
-            break;
-        if (!m._pending && m.toolCallId)
-            alreadyResolved.add(m.toolCallId);
-    }
-    const resumed = [];
-    let approvalStillRequired;
-    for (let i = 0; i < last.toolCalls.length; i++) {
-        const tc = last.toolCalls[i];
-        if (alreadyResolved.has(tc.id))
-            continue;
-        const tool = toolMap.get(tc.name);
-        if (!tool) {
-            const err = `Error: Unknown tool "${tc.name}"`;
-            const m = { role: 'tool', content: err, toolCallId: tc.id };
-            messages.push(m);
-            resumed.push(m);
-            continue;
-        }
-        if (!tool.execute) {
-            // Client tool whose result is missing from the supplied messages.
-            // Surface an error so the model can recover instead of hanging.
-            const err = `Error: client tool "${tc.name}" was not executed by the browser`;
-            const m = { role: 'tool', content: err, toolCallId: tc.id };
-            messages.push(m);
-            resumed.push(m);
-            continue;
-        }
-        const decision = await evaluateApproval(tool, tc, options);
-        if (decision === 'rejected') {
-            const rej = { rejected: true, reason: 'User rejected this tool call' };
-            const m = { role: 'tool', content: JSON.stringify(rej), toolCallId: tc.id };
-            messages.push(m);
-            resumed.push(m);
-            continue;
-        }
-        if (decision === 'pending') {
-            // Still pending — the user hasn't decided on this call yet. Stop
-            // executing further tools AND synthesize placeholder tool messages for
-            // every unresolved sibling (including this one), so Anthropic's
-            // "every tool_use needs a matching tool_result" invariant holds while
-            // the loop is paused. The next resume strips these placeholders and
-            // re-walks based on the fresh approval state.
-            approvalStillRequired = { toolCall: tc, isClientTool: false };
-            for (let j = i; j < last.toolCalls.length; j++) {
-                const sib = last.toolCalls[j];
-                if (alreadyResolved.has(sib.id))
-                    continue;
-                messages.push({
-                    role: 'tool',
-                    content: 'Tool call pending user approval — execution deferred.',
-                    toolCallId: sib.id,
-                    _pending: true,
-                });
-            }
-            break;
-        }
-        // Validate args before executing on resume. Approval-resume bypasses
-        // middleware so we use the raw tc.arguments. On failure, feed the
-        // structured error to the model so it can correct itself.
-        const validation = validateToolArgs(tool, tc.arguments);
-        if (!validation.ok) {
-            const m = { role: 'tool', content: JSON.stringify(validation.error), toolCallId: tc.id };
-            messages.push(m);
-            resumed.push(m);
-            continue;
-        }
-        try {
-            // Drain generator yields silently — approval-resume runs outside the
-            // stream, so any preliminary updates are discarded; only the final
-            // return value is captured.
-            const execGen = executeMaybeStreaming(tool, validation.value, { toolCallId: tc.id });
-            let result;
-            while (true) {
-                const step = await execGen.next();
-                if (step.done) {
-                    result = step.value;
-                    break;
-                }
-            }
-            // Approval-resume has no middleware context here, so toModelOutput
-            // errors fall back silently to default stringification (R6).
-            const content = await applyToModelOutput(tool, result);
-            const m = { role: 'tool', content, toolCallId: tc.id };
-            messages.push(m);
-            resumed.push(m);
-        }
-        catch (err) {
-            const errMsg = `Error: ${err instanceof Error ? err.message : String(err)}`;
-            const m = { role: 'tool', content: errMsg, toolCallId: tc.id };
-            messages.push(m);
-            resumed.push(m);
-        }
-    }
-    return { resumed, approvalStillRequired };
-}
-//# sourceMappingURL=resume-approval.js.map

package/dist/resume-approval.js.map

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

package/dist/sanitize-conversation.d.ts

@@ -1,43 +0,0 @@
-/**
- * Make a loaded conversation history safe to replay against any provider by
- * enforcing the tool-call / tool-result invariant in BOTH directions.
- *
- * Anthropic's Messages API requires every `tool_use` block to be followed by
- * `tool_result` blocks for all of its ids. OpenAI-compatible providers
- * (DeepSeek, OpenRouter, Azure) are stricter still: a `role:'tool'` message
- * must immediately follow the `assistant` + `tool_calls` that declared its id,
- * and an unanswered `tool_calls` is equally rejected, surfacing as
- * `400 Messages with role 'tool' must be a response to a preceding message
- * with 'tool_calls'`. A conversation interrupted mid-turn (a crash after the
- * assistant message persisted but before all tool results landed; a client
- * failure that never replayed the results) leaves a malformed graph in the
- * store, and replaying it 400s.
- *
- * {@link sanitizeConversation} walks the messages in order:
- *
- *   - **Complete tool turn** (every declared id has a matching result in the
- *     immediately-following tool run) is kept, with the results re-emitted in
- *     `toolCalls` order, exactly one per call. Any extra / duplicate / orphan
- *     tool message interleaved in that run is dropped.
- *   - **Dangling tool turn** (one or more declared ids unanswered) has its
- *     assistant `toolCalls` stripped; the text `content` is preserved as a
- *     plain assistant message (an empty one is dropped entirely); the partial
- *     tool results are dropped.
- *   - **Orphan tool result** (a `role:'tool'` message whose parent assistant
- *     is missing or was dropped as dangling) is dropped. Replaying it trips
- *     the 400 above on OpenAI-compatible providers and a BadRequestError on
- *     Anthropic.
- *
- * Unlike the wire-level normalizer the provider adapters apply (which
- * SYNTHESIZES stub results so an in-flight request stays well-formed), the
- * load boundary DROPS incomplete turns: an interrupted turn is abandoned
- * history, and a fake "result missing" message would pollute the model's
- * future context.
- *
- * Pure and idempotent: safe to apply at any load boundary, and re-running over
- * an already-sanitized array is a no-op. {@link OrmConversationStore} applies
- * it in `load()` so persisted histories are replay-safe by default.
- */
-import type { AiMessage } from './types.js';
-export declare function sanitizeConversation(messages: AiMessage[]): AiMessage[];
-//# sourceMappingURL=sanitize-conversation.d.ts.map

package/dist/sanitize-conversation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sanitize-conversation.d.ts","sourceRoot":"","sources":["../src/sanitize-conversation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAgDvE"}

package/dist/sanitize-conversation.js

@@ -1,85 +0,0 @@
-/**
- * Make a loaded conversation history safe to replay against any provider by
- * enforcing the tool-call / tool-result invariant in BOTH directions.
- *
- * Anthropic's Messages API requires every `tool_use` block to be followed by
- * `tool_result` blocks for all of its ids. OpenAI-compatible providers
- * (DeepSeek, OpenRouter, Azure) are stricter still: a `role:'tool'` message
- * must immediately follow the `assistant` + `tool_calls` that declared its id,
- * and an unanswered `tool_calls` is equally rejected, surfacing as
- * `400 Messages with role 'tool' must be a response to a preceding message
- * with 'tool_calls'`. A conversation interrupted mid-turn (a crash after the
- * assistant message persisted but before all tool results landed; a client
- * failure that never replayed the results) leaves a malformed graph in the
- * store, and replaying it 400s.
- *
- * {@link sanitizeConversation} walks the messages in order:
- *
- *   - **Complete tool turn** (every declared id has a matching result in the
- *     immediately-following tool run) is kept, with the results re-emitted in
- *     `toolCalls` order, exactly one per call. Any extra / duplicate / orphan
- *     tool message interleaved in that run is dropped.
- *   - **Dangling tool turn** (one or more declared ids unanswered) has its
- *     assistant `toolCalls` stripped; the text `content` is preserved as a
- *     plain assistant message (an empty one is dropped entirely); the partial
- *     tool results are dropped.
- *   - **Orphan tool result** (a `role:'tool'` message whose parent assistant
- *     is missing or was dropped as dangling) is dropped. Replaying it trips
- *     the 400 above on OpenAI-compatible providers and a BadRequestError on
- *     Anthropic.
- *
- * Unlike the wire-level normalizer the provider adapters apply (which
- * SYNTHESIZES stub results so an in-flight request stays well-formed), the
- * load boundary DROPS incomplete turns: an interrupted turn is abandoned
- * history, and a fake "result missing" message would pollute the model's
- * future context.
- *
- * Pure and idempotent: safe to apply at any load boundary, and re-running over
- * an already-sanitized array is a no-op. {@link OrmConversationStore} applies
- * it in `load()` so persisted histories are replay-safe by default.
- */
-export function sanitizeConversation(messages) {
-    const result = [];
-    for (let i = 0; i < messages.length; i++) {
-        const msg = messages[i];
-        // A `tool` message reaching the top level was not consumed by a complete
-        // assistant turn below (those advance `i` past their results), so its
-        // parent is missing or was dropped as dangling. It is an orphan; drop it.
-        if (msg.role === 'tool')
-            continue;
-        if (msg.role !== 'assistant' || !msg.toolCalls?.length) {
-            result.push(msg);
-            continue;
-        }
-        const wanted = msg.toolCalls.map(tc => tc.id).filter(Boolean);
-        // Map the immediately-following tool run by id (first result per id wins).
-        const resultsById = new Map();
-        let j = i + 1;
-        while (j < messages.length && messages[j].role === 'tool') {
-            const t = messages[j];
-            const tid = t.toolCallId;
-            if (tid && !resultsById.has(tid))
-                resultsById.set(tid, t);
-            j++;
-        }
-        const allCovered = wanted.every(id => resultsById.has(id));
-        if (allCovered) {
-            // Emit the assistant followed by exactly one result per call, in
-            // `toolCalls` order. This normalizes ordering and drops any extra /
-            // orphan tool message that was interleaved in the run.
-            result.push(msg);
-            for (const tc of msg.toolCalls)
-                result.push(resultsById.get(tc.id));
-            i = j - 1;
-            continue;
-        }
-        // Dangling: strip toolCalls, drop the partial tool results, keep any text.
-        const text = typeof msg.content === 'string' ? msg.content : '';
-        if (text.trim() !== '') {
-            result.push({ role: 'assistant', content: msg.content });
-        }
-        i = j - 1;
-    }
-    return result;
-}
-//# sourceMappingURL=sanitize-conversation.js.map

package/dist/sanitize-conversation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sanitize-conversation.js","sourceRoot":"","sources":["../src/sanitize-conversation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAIH,MAAM,UAAU,oBAAoB,CAAC,QAAqB;IACxD,MAAM,MAAM,GAAgB,EAAE,CAAA;IAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAA;QAExB,yEAAyE;QACzE,sEAAsE;QACtE,0EAA0E;QAC1E,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;YAAE,SAAQ;QAEjC,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;YACvD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAChB,SAAQ;QACV,CAAC;QAED,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAE7D,2EAA2E;QAC3E,MAAM,WAAW,GAAG,IAAI,GAAG,EAAqB,CAAA;QAChD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACb,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAE,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3D,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAA;YACtB,MAAM,GAAG,GAAG,CAAC,CAAC,UAAU,CAAA;YACxB,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;YACzD,CAAC,EAAE,CAAA;QACL,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;QAC1D,IAAI,UAAU,EAAE,CAAC;YACf,iEAAiE;YACjE,oEAAoE;YACpE,uDAAuD;YACvD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAChB,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,SAAS;gBAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAE,CAAC,CAAA;YACpE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YACT,SAAQ;QACV,CAAC;QAED,2EAA2E;QAC3E,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;QAC/D,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA;QAC1D,CAAC;QACD,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACX,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}