@rudderjs/ai 1.17.2 → 1.18.0

package/dist/continuation-validation.d.ts

@@ -1,85 +0,0 @@
-import type { AiMessage, ContinuationValidator, ValidateContinuationOptions } from './types.js';
-export type { ContinuationValidator, ValidateContinuationOptions } from './types.js';
-/**
- * Continuation validation — defends the auto-persist / continuation path
- * against a client that resubmits a forged conversation.
- *
- * `runWithPersistence` (and the explicit `forUser`/`continue` form) trusts
- * the caller's incoming history. A continuation request after a client-tool
- * or approval round-trip carries the prior messages back from the browser,
- * which means a malicious caller can:
- *
- *  1. **Rewrite history / continue someone else's thread (IDOR)** — send
- *     messages that don't match what the server persisted for this thread.
- *  2. **Forge a tool result** — append a `tool` message answering a tool
- *     call that the server never issued (smuggling attacker-chosen data in
- *     as if a tool produced it).
- *  3. **Forge an approval** — claim `approvedToolCallIds` for a tool call
- *     that isn't actually pending approval.
- *
- * {@link validateContinuation} runs all three checks against the trusted
- * `persisted` history and returns a verdict. {@link assertValidContinuation}
- * throws {@link ContinuationValidationError} on failure, and
- * {@link defaultContinuationValidator} adapts it to the
- * {@link ContinuationValidator} hook shape consumed by `AgentPromptOptions`.
- */
-export type ContinuationRejectionCode = 'not-a-prefix' | 'forged-tool-result' | 'forged-approval';
-export interface ContinuationValidationResult {
-    /** `true` when the incoming continuation is a legitimate extension of `persisted`. */
-    ok: boolean;
-    /** Machine-readable reason, present only when `ok` is `false`. */
-    code?: ContinuationRejectionCode;
-    /** Human-readable explanation, present only when `ok` is `false`. */
-    reason?: string;
-    /**
-     * Index of the offending message — into `incoming` for `not-a-prefix` and
-     * `forged-tool-result`. Absent for `forged-approval` (the offending id is
-     * named in `reason` instead).
-     */
-    index?: number;
-}
-/**
- * Validate that an `incoming` continuation is a legitimate extension of the
- * server-persisted `persisted` history. Pure and synchronous — safe to call
- * from any runtime. Returns a verdict; never throws.
- *
- * Checks, in order:
- *
- * - **Prefix equality.** Every message the two share by position must match
- *   (role, content, `toolCallId`, and any assistant `toolCalls`). Comparison
- *   is order-insensitive for nested objects, so a tool-call `arguments` map
- *   reordered across a serialization boundary still matches. A genuine
- *   mismatch means the caller rewrote history or is replaying a different
- *   thread (IDOR) → `not-a-prefix`.
- * - **Tool-result forgery.** Every `tool` message in `incoming` must answer
- *   a tool call actually requested by some assistant message (in either
- *   `persisted` or `incoming`). A `tool` message with no matching request is
- *   smuggled data → `forged-tool-result`.
- * - **Approval forgery.** Every id in `opts.approvedToolCallIds` /
- *   `opts.rejectedToolCallIds` must reference a real requested tool call →
- *   `forged-approval`.
- */
-export declare function validateContinuation(persisted: readonly AiMessage[], incoming: readonly AiMessage[], opts?: ValidateContinuationOptions): ContinuationValidationResult;
-/** Thrown by {@link assertValidContinuation} when validation fails. */
-export declare class ContinuationValidationError extends Error {
-    readonly code: ContinuationRejectionCode;
-    readonly index: number | undefined;
-    constructor(result: ContinuationValidationResult);
-}
-/**
- * {@link validateContinuation} that throws {@link ContinuationValidationError}
- * instead of returning a verdict. Use directly, or via
- * {@link defaultContinuationValidator} as a `validate` hook.
- */
-export declare function assertValidContinuation(persisted: readonly AiMessage[], incoming: readonly AiMessage[], opts?: ValidateContinuationOptions): void;
-/**
- * A ready-made {@link ContinuationValidator} backed by
- * {@link assertValidContinuation}. Drop into `AgentPromptOptions.validate`
- * for the default prefix + tool-result-forgery + approval-forgery gate:
- *
- * ```ts
- * agent.continue(id).prompt(input, { validate: defaultContinuationValidator() })
- * ```
- */
-export declare function defaultContinuationValidator(): ContinuationValidator;
-//# sourceMappingURL=continuation-validation.d.ts.map

package/dist/continuation-validation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"continuation-validation.d.ts","sourceRoot":"","sources":["../src/continuation-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,qBAAqB,EAAY,2BAA2B,EAAE,MAAM,YAAY,CAAA;AAEzG,YAAY,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAA;AAEpF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,MAAM,yBAAyB,GACjC,cAAc,GACd,oBAAoB,GACpB,iBAAiB,CAAA;AAErB,MAAM,WAAW,4BAA4B;IAC3C,sFAAsF;IACtF,EAAE,EAAE,OAAO,CAAA;IACX,kEAAkE;IAClE,IAAI,CAAC,EAAE,yBAAyB,CAAA;IAChC,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAmED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,SAAS,EAAE,EAC/B,QAAQ,EAAE,SAAS,SAAS,EAAE,EAC9B,IAAI,GAAE,2BAAgC,GACrC,4BAA4B,CA2C9B;AAED,uEAAuE;AACvE,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAA;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;gBACtB,MAAM,EAAE,4BAA4B;CAMjD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,SAAS,EAAE,EAC/B,QAAQ,EAAE,SAAS,SAAS,EAAE,EAC9B,IAAI,GAAE,2BAAgC,GACrC,IAAI,CAGN;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,IAAI,qBAAqB,CAEpE"}

package/dist/continuation-validation.js

@@ -1,166 +0,0 @@
-/**
- * Recursively sort object keys (and drop `undefined`) so two semantically
- * equal values compare equal regardless of key insertion order. Without this,
- * a tool-call `arguments` object reordered across a serialization boundary
- * (e.g. loaded back from a Postgres `jsonb` column, which does not preserve
- * key order, or rebuilt by the client) would be read as a forgery.
- */
-function canonicalize(value) {
-    if (value === null || typeof value !== 'object')
-        return value;
-    if (Array.isArray(value))
-        return value.map(canonicalize);
-    const out = {};
-    for (const key of Object.keys(value).sort()) {
-        const v = value[key];
-        if (v === undefined)
-            continue;
-        out[key] = canonicalize(v);
-    }
-    return out;
-}
-/** Order-insensitive JSON of a value. */
-function canonicalJson(value) {
-    return JSON.stringify(canonicalize(value));
-}
-/** Order-insensitive string form of message content. */
-function contentString(content) {
-    return typeof content === 'string' ? content : canonicalJson(content);
-}
-/**
- * Compare two messages field by field, order-insensitively. Returns a
- * human-readable reason naming the first diverging field, or `null` when the
- * messages are equivalent. Used by the prefix check so a rejection points at
- * exactly what diverged.
- */
-function messageDiffReason(a, b) {
-    if (a.role !== b.role)
-        return `role: persisted "${a.role}" vs incoming "${b.role}"`;
-    if (contentString(a.content) !== contentString(b.content))
-        return 'content differs';
-    if ((a.toolCallId ?? null) !== (b.toolCallId ?? null)) {
-        return `toolCallId: persisted "${a.toolCallId ?? 'null'}" vs incoming "${b.toolCallId ?? 'null'}"`;
-    }
-    const aCalls = a.toolCalls ?? [];
-    const bCalls = b.toolCalls ?? [];
-    if (aCalls.length !== bCalls.length)
-        return `toolCalls length: persisted ${aCalls.length} vs incoming ${bCalls.length}`;
-    for (let i = 0; i < aCalls.length; i++) {
-        const ac = aCalls[i];
-        const bc = bCalls[i];
-        if (ac.id !== bc.id)
-            return `toolCalls[${i}].id: persisted "${ac.id}" vs incoming "${bc.id}"`;
-        if (ac.name !== bc.name)
-            return `toolCalls[${i}].name: persisted "${ac.name}" vs incoming "${bc.name}"`;
-        if (canonicalJson(ac.arguments) !== canonicalJson(bc.arguments))
-            return `toolCalls[${i}].arguments differ (${ac.name})`;
-    }
-    return null;
-}
-/** Collect every tool-call id the model requested across the given messages. */
-function requestedToolCallIds(messages) {
-    const ids = new Set();
-    for (const m of messages) {
-        if (m.role === 'assistant' && m.toolCalls) {
-            for (const c of m.toolCalls)
-                ids.add(c.id);
-        }
-    }
-    return ids;
-}
-/**
- * Validate that an `incoming` continuation is a legitimate extension of the
- * server-persisted `persisted` history. Pure and synchronous — safe to call
- * from any runtime. Returns a verdict; never throws.
- *
- * Checks, in order:
- *
- * - **Prefix equality.** Every message the two share by position must match
- *   (role, content, `toolCallId`, and any assistant `toolCalls`). Comparison
- *   is order-insensitive for nested objects, so a tool-call `arguments` map
- *   reordered across a serialization boundary still matches. A genuine
- *   mismatch means the caller rewrote history or is replaying a different
- *   thread (IDOR) → `not-a-prefix`.
- * - **Tool-result forgery.** Every `tool` message in `incoming` must answer
- *   a tool call actually requested by some assistant message (in either
- *   `persisted` or `incoming`). A `tool` message with no matching request is
- *   smuggled data → `forged-tool-result`.
- * - **Approval forgery.** Every id in `opts.approvedToolCallIds` /
- *   `opts.rejectedToolCallIds` must reference a real requested tool call →
- *   `forged-approval`.
- */
-export function validateContinuation(persisted, incoming, opts = {}) {
-    // 1. Prefix equality over the shared region. Comparison is order-insensitive
-    //    for nested objects (tool-call arguments, structured content) so a
-    //    legitimately reordered argument map is not mistaken for a forgery.
-    const overlap = Math.min(persisted.length, incoming.length);
-    for (let i = 0; i < overlap; i++) {
-        const diff = messageDiffReason(persisted[i], incoming[i]);
-        if (diff) {
-            return {
-                ok: false,
-                code: 'not-a-prefix',
-                index: i,
-                reason: `incoming message at index ${i} diverges from the persisted history (${diff})`,
-            };
-        }
-    }
-    // 2. Tool-result forgery — a tool message must answer a requested call.
-    const requested = requestedToolCallIds([...persisted, ...incoming]);
-    for (let i = 0; i < incoming.length; i++) {
-        const m = incoming[i];
-        if (m.role === 'tool' && (!m.toolCallId || !requested.has(m.toolCallId))) {
-            return {
-                ok: false,
-                code: 'forged-tool-result',
-                index: i,
-                reason: `tool message at index ${i} references tool call "${m.toolCallId ?? '<missing>'}" that was never requested`,
-            };
-        }
-    }
-    // 3. Approval forgery — approved/rejected ids must be real requested calls.
-    for (const id of [...(opts.approvedToolCallIds ?? []), ...(opts.rejectedToolCallIds ?? [])]) {
-        if (!requested.has(id)) {
-            return {
-                ok: false,
-                code: 'forged-approval',
-                reason: `tool call "${id}" was approved or rejected but was never requested`,
-            };
-        }
-    }
-    return { ok: true };
-}
-/** Thrown by {@link assertValidContinuation} when validation fails. */
-export class ContinuationValidationError extends Error {
-    code;
-    index;
-    constructor(result) {
-        super(`[Rudder AI] Rejected continuation: ${result.reason ?? result.code ?? 'invalid'}`);
-        this.name = 'ContinuationValidationError';
-        this.code = result.code ?? 'not-a-prefix';
-        this.index = result.index;
-    }
-}
-/**
- * {@link validateContinuation} that throws {@link ContinuationValidationError}
- * instead of returning a verdict. Use directly, or via
- * {@link defaultContinuationValidator} as a `validate` hook.
- */
-export function assertValidContinuation(persisted, incoming, opts = {}) {
-    const result = validateContinuation(persisted, incoming, opts);
-    if (!result.ok)
-        throw new ContinuationValidationError(result);
-}
-/**
- * A ready-made {@link ContinuationValidator} backed by
- * {@link assertValidContinuation}. Drop into `AgentPromptOptions.validate`
- * for the default prefix + tool-result-forgery + approval-forgery gate:
- *
- * ```ts
- * agent.continue(id).prompt(input, { validate: defaultContinuationValidator() })
- * ```
- */
-export function defaultContinuationValidator() {
-    return (persisted, incoming, opts) => assertValidContinuation(persisted, incoming, opts);
-}
-//# sourceMappingURL=continuation-validation.js.map

package/dist/continuation-validation.js.map

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

package/dist/conversation-persistence.d.ts

@@ -1,46 +0,0 @@
-import type { AgentPromptOptions, AgentResponse, AgentStreamResponse, AiMessage, ConversationalOverride, ConversationalSpec, ConversationStore } from './types.js';
-/**
- * Internal hook that's awaited by the persistence helpers to find the
- * registered `ConversationStore`. Wired to `setConversationStore()` /
- * `AiProvider`'s `ai.conversations` DI binding via `agent.ts` —
- * provided here as a parameter to keep this file dependency-free.
- */
-export type ConversationStoreLookup = () => ConversationStore | null | undefined;
-/**
- * Resolves the effective {@link ConversationalSpec} for a single
- * `prompt()` / `stream()` call. Returns `null` when the call should run
- * stateless (no auto-persist).
- *
- * Precedence (high → low):
- * 1. Per-call `options.conversation` — `false` opts out, a spec replaces
- *    the agent's declaration.
- * 2. Agent's `conversational()` — supports sync OR async returns.
- *
- * The `ConversableAgent` (`forUser` / `continue`) flow does **not** go
- * through this resolver — it builds its own spec and calls the helper
- * directly so the explicit form always wins over both layers below.
- */
-export declare function resolveAutoPersistSpec(agentDecl: () => false | ConversationalSpec | Promise<false | ConversationalSpec>, perCall: ConversationalOverride | undefined): Promise<ConversationalSpec | null>;
-/**
- * Compose the new turn's messages from the user input + the steps the
- * agent loop produced. Mirrors the old `ConversableAgent.prompt`
- * persistence shape exactly so downstream stores see no behavioral change.
- */
-export declare function newMessagesFromTurn(input: string, response: AgentResponse): AiMessage[];
-/**
- * Wrap a non-streaming agent run with conversation persistence. Loads
- * history before, appends the new turn after, and stamps `conversationId`
- * onto the result.
- *
- * `inner` receives the merged options (with the loaded history pre-pended
- * to `options.history`) and is expected to invoke the actual agent loop.
- */
-export declare function runWithPersistence(spec: ConversationalSpec, agentClassName: string, storeLookup: ConversationStoreLookup, input: string, options: AgentPromptOptions | undefined, inner: (effOptions: AgentPromptOptions | undefined) => Promise<AgentResponse>): Promise<AgentResponse>;
-/**
- * Wrap a streaming agent run with conversation persistence. Same shape as
- * {@link runWithPersistence}, but stitched into the
- * `AgentStreamResponse` `{ stream, response }` pair so the caller sees
- * stream chunks flowing first and the persisted result resolving last.
- */
-export declare function runWithPersistenceStreaming(spec: ConversationalSpec, agentClassName: string, storeLookup: ConversationStoreLookup, input: string, options: AgentPromptOptions | undefined, inner: (effOptions: AgentPromptOptions | undefined) => AgentStreamResponse): AgentStreamResponse;
-//# sourceMappingURL=conversation-persistence.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"conversation-persistence.d.ts","sourceRoot":"","sources":["../src/conversation-persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,SAAS,EACT,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EAElB,MAAM,YAAY,CAAA;AAEnB;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAA;AAEhF;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAK,MAAM,KAAK,GAAG,kBAAkB,GAAG,OAAO,CAAC,KAAK,GAAG,kBAAkB,CAAC,EACpF,OAAO,EAAO,sBAAsB,GAAG,SAAS,GAC/C,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAWpC;AA0FD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,SAAS,EAAE,CAUvF;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAY,kBAAkB,EAClC,cAAc,EAAE,MAAM,EACtB,WAAW,EAAK,uBAAuB,EACvC,KAAK,EAAW,MAAM,EACtB,OAAO,EAAS,kBAAkB,GAAG,SAAS,EAC9C,KAAK,EAAW,CAAC,UAAU,EAAE,kBAAkB,GAAG,SAAS,KAAK,OAAO,CAAC,aAAa,CAAC,GACrF,OAAO,CAAC,aAAa,CAAC,CAWxB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAY,kBAAkB,EAClC,cAAc,EAAE,MAAM,EACtB,WAAW,EAAK,uBAAuB,EACvC,KAAK,EAAW,MAAM,EACtB,OAAO,EAAS,kBAAkB,GAAG,SAAS,EAC9C,KAAK,EAAW,CAAC,UAAU,EAAE,kBAAkB,GAAG,SAAS,KAAK,mBAAmB,GAClF,mBAAmB,CAyCrB"}

package/dist/conversation-persistence.js

@@ -1,176 +0,0 @@
-/**
- * Resolves the effective {@link ConversationalSpec} for a single
- * `prompt()` / `stream()` call. Returns `null` when the call should run
- * stateless (no auto-persist).
- *
- * Precedence (high → low):
- * 1. Per-call `options.conversation` — `false` opts out, a spec replaces
- *    the agent's declaration.
- * 2. Agent's `conversational()` — supports sync OR async returns.
- *
- * The `ConversableAgent` (`forUser` / `continue`) flow does **not** go
- * through this resolver — it builds its own spec and calls the helper
- * directly so the explicit form always wins over both layers below.
- */
-export async function resolveAutoPersistSpec(agentDecl, perCall) {
-    if (perCall === false)
-        return null;
-    if (perCall && typeof perCall === 'object') {
-        if (!perCall.user && !perCall.id)
-            return null; // invalid override → opt out
-        return perCall;
-    }
-    const declared = await agentDecl();
-    if (declared === false || !declared)
-        return null;
-    if (!declared.user && !declared.id)
-        return null;
-    return declared;
-}
-/**
- * Run the load-or-create-thread half of the persistence flow. Resolves
- * the conversation id, loads history, applies `historyLimit`, and merges
- * with any caller-supplied `options.history`.
- */
-async function preparePersistence(spec, agentClassName, store, callerHistory) {
-    let convId = spec.id;
-    let loaded = [];
-    if (convId) {
-        loaded = await store.load(convId);
-    }
-    else if (spec.user) {
-        const agentKey = spec.agent ?? agentClassName;
-        const threads = await store.list(spec.user);
-        // Most-recent thread for this (user, agent) pair. Stores filter by
-        // `userId` already; we filter by the agent meta locally so existing
-        // stores (which may not persist `agent` in `list()` results) still
-        // work — they'll just always create new threads, which is the
-        // conservative behavior.
-        const candidates = threads.filter(t => (t.agent ?? null) === agentKey);
-        const mostRecent = candidates.sort((a, b) => {
-            const aT = (a.updatedAt ?? a.createdAt).getTime();
-            const bT = (b.updatedAt ?? b.createdAt).getTime();
-            return bT - aT;
-        })[0];
-        if (mostRecent) {
-            convId = mostRecent.id;
-            loaded = await store.load(convId);
-        }
-        else {
-            convId = await store.create(undefined, { userId: spec.user, agent: agentKey });
-        }
-    }
-    else {
-        throw new Error('[Rudder AI] ConversationalSpec must include either `user` or `id`.');
-    }
-    // Snapshot the trusted baseline before any limit slice — the validation
-    // hook compares the caller's incoming messages against the FULL persisted
-    // thread, not the windowed view fed to the model.
-    const persisted = loaded;
-    let windowed = loaded;
-    if (spec.historyLimit !== undefined && spec.historyLimit > 0) {
-        windowed = loaded.slice(-spec.historyLimit);
-    }
-    const history = [...windowed, ...(callerHistory ?? [])];
-    return { spec, store, convId, history, persisted };
-}
-/**
- * Run the caller-supplied `validate` continuation hook, if present. The
- * "incoming" view is the caller's claimed prior conversation — their
- * `options.messages` (full continuation list) when set, else
- * `options.history`. Throws (propagating the rejection) when the hook does.
- */
-async function runValidation(ctx, options) {
-    if (!options?.validate)
-        return;
-    const incoming = options.messages ?? options.history ?? [];
-    const opts = {};
-    if (options.approvedToolCallIds)
-        opts.approvedToolCallIds = options.approvedToolCallIds;
-    if (options.rejectedToolCallIds)
-        opts.rejectedToolCallIds = options.rejectedToolCallIds;
-    await options.validate(ctx.persisted, incoming, opts);
-}
-/**
- * Compose the new turn's messages from the user input + the steps the
- * agent loop produced. Mirrors the old `ConversableAgent.prompt`
- * persistence shape exactly so downstream stores see no behavioral change.
- */
-export function newMessagesFromTurn(input, response) {
-    const out = [{ role: 'user', content: input }];
-    for (const step of response.steps) {
-        out.push(step.message);
-        for (const tr of step.toolResults) {
-            const resultStr = typeof tr.result === 'string' ? tr.result : JSON.stringify(tr.result);
-            out.push({ role: 'tool', content: resultStr, toolCallId: tr.toolCallId });
-        }
-    }
-    return out;
-}
-/**
- * Wrap a non-streaming agent run with conversation persistence. Loads
- * history before, appends the new turn after, and stamps `conversationId`
- * onto the result.
- *
- * `inner` receives the merged options (with the loaded history pre-pended
- * to `options.history`) and is expected to invoke the actual agent loop.
- */
-export async function runWithPersistence(spec, agentClassName, storeLookup, input, options, inner) {
-    const store = storeLookup();
-    if (!store)
-        throw new Error('[Rudder AI] No ConversationStore registered. Bind one via `setConversationStore()` or the `ai.conversations` DI key.');
-    const ctx = await preparePersistence(spec, agentClassName, store, options?.history);
-    await runValidation(ctx, options);
-    const effOptions = { ...options, history: ctx.history };
-    const response = await inner(effOptions);
-    await store.append(ctx.convId, newMessagesFromTurn(input, response));
-    return { ...response, conversationId: ctx.convId };
-}
-/**
- * Wrap a streaming agent run with conversation persistence. Same shape as
- * {@link runWithPersistence}, but stitched into the
- * `AgentStreamResponse` `{ stream, response }` pair so the caller sees
- * stream chunks flowing first and the persisted result resolving last.
- */
-export function runWithPersistenceStreaming(spec, agentClassName, storeLookup, input, options, inner) {
-    let resolveResponse;
-    let rejectResponse;
-    const responsePromise = new Promise((res, rej) => { resolveResponse = res; rejectResponse = rej; });
-    async function* outer() {
-        const store = storeLookup();
-        if (!store) {
-            const err = new Error('[Rudder AI] No ConversationStore registered. Bind one via `setConversationStore()` or the `ai.conversations` DI key.');
-            rejectResponse(err);
-            throw err;
-        }
-        let ctx;
-        try {
-            ctx = await preparePersistence(spec, agentClassName, store, options?.history);
-            await runValidation(ctx, options);
-        }
-        catch (err) {
-            rejectResponse(err);
-            throw err;
-        }
-        const innerResp = inner({ ...options, history: ctx.history });
-        try {
-            for await (const chunk of innerResp.stream)
-                yield chunk;
-        }
-        catch (err) {
-            rejectResponse(err);
-            throw err;
-        }
-        const response = await innerResp.response;
-        try {
-            await store.append(ctx.convId, newMessagesFromTurn(input, response));
-        }
-        catch (err) {
-            rejectResponse(err);
-            throw err;
-        }
-        resolveResponse({ ...response, conversationId: ctx.convId });
-    }
-    return { stream: outer(), response: responsePromise };
-}
-//# sourceMappingURL=conversation-persistence.js.map

package/dist/conversation-persistence.js.map

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

package/dist/conversation.d.ts

@@ -1,11 +0,0 @@
-import type { AiMessage, ConversationStore, ConversationStoreListEntry, ConversationStoreMeta } from './types.js';
-export declare class MemoryConversationStore implements ConversationStore {
-    private readonly conversations;
-    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<ConversationStoreListEntry[]>;
-    delete(conversationId: string): Promise<void>;
-}
-//# sourceMappingURL=conversation.d.ts.map

package/dist/conversation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../src/conversation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAOjH,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAM1B;IAEE,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAarE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAMlD,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpE,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9D,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,EAAE,CAAC;IAa5D,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGpD"}

package/dist/conversation.js

@@ -1,55 +0,0 @@
-function generateId() {
-    if (typeof globalThis.crypto?.randomUUID === 'function')
-        return globalThis.crypto.randomUUID();
-    return `${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
-}
-export class MemoryConversationStore {
-    conversations = new Map();
-    async create(title, meta) {
-        const id = generateId();
-        const now = new Date();
-        this.conversations.set(id, {
-            title: title ?? 'New conversation',
-            messages: [],
-            meta,
-            createdAt: now,
-            updatedAt: now,
-        });
-        return id;
-    }
-    async load(conversationId) {
-        const conv = this.conversations.get(conversationId);
-        if (!conv)
-            throw new Error(`[Rudder AI] Conversation "${conversationId}" not found.`);
-        return [...conv.messages];
-    }
-    async append(conversationId, messages) {
-        const conv = this.conversations.get(conversationId);
-        if (!conv)
-            throw new Error(`[Rudder AI] Conversation "${conversationId}" not found.`);
-        conv.messages.push(...messages);
-        conv.updatedAt = new Date();
-    }
-    async setTitle(conversationId, title) {
-        const conv = this.conversations.get(conversationId);
-        if (!conv)
-            throw new Error(`[Rudder AI] Conversation "${conversationId}" not found.`);
-        conv.title = title;
-    }
-    async list(userId) {
-        return Array.from(this.conversations.entries())
-            .filter(([, conv]) => userId == null || conv.meta?.userId === userId)
-            .map(([id, conv]) => ({
-            id,
-            title: conv.title,
-            createdAt: conv.createdAt,
-            updatedAt: conv.updatedAt,
-            ...(conv.meta?.agent ? { agent: conv.meta.agent } : {}),
-        }))
-            .sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
-    }
-    async delete(conversationId) {
-        this.conversations.delete(conversationId);
-    }
-}
-//# sourceMappingURL=conversation.js.map

package/dist/conversation.js.map

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

package/dist/eval/fixtures.d.ts

@@ -1,65 +0,0 @@
-/**
- * Fixture I/O for `pnpm rudder ai:eval --record` / `--replay` (#A5
- * Phase 4). Each case writes one JSON file under
- * `evals/__fixtures__/<suite>/<case>.json` carrying the assistant
- * turns from a real provider run, normalized into the
- * {@link AiFakeStep} shape so `--replay` can re-feed them via
- * `AiFake.respondWithSequence` for zero-API regression tests.
- *
- * The fixture format is versioned. Bumping `version` forces a
- * re-record on stale fixtures rather than silently mis-replaying.
- */
-import type { AgentResponse } from '../types.js';
-import type { AiFakeStep } from '../fake.js';
-/** Fixture format. Bump `version` when the shape changes incompatibly. */
-export interface EvalFixture {
-    version: 1;
-    suite: string;
-    case: string;
-    input: string;
-    recordedAt: string;
-    steps: AiFakeStep[];
-}
-/**
- * Convert an `AgentResponse` into the assistant-turn `AiFakeStep[]`
- * sequence that `AiFake.respondWithSequence` expects.
- *
- * - Drops user/tool turns — those are framework-generated during a
- *   replayed run, not provider output.
- * - Multi-modal assistant content collapses to its concatenated text
- *   parts (the fake's transport is text-only; image/document parts
- *   wouldn't replay meaningfully).
- * - `toolCalls` carry through verbatim so multi-step tool loops
- *   replay deterministically.
- */
-export declare function stepsFromResponse(response: AgentResponse): AiFakeStep[];
-/**
- * Default fixtures directory: `<cwd>/evals/__fixtures__`. Override
- * via the CLI handler's options for tests / non-standard layouts.
- */
-export declare function defaultFixturesDir(cwd: string): string;
-/**
- * Filesystem-safe slug for `<suite>/<case>` segments. Letters,
- * digits, dot, dash, underscore pass through; everything else
- * collapses to `-`. Multiple consecutive `-` collapse to one.
- *
- * Pure function; tested directly so suite/case rename diffs stay
- * predictable across editors.
- */
-export declare function slugify(s: string): string;
-export declare function fixturePath(dir: string, suite: string, caseName: string): string;
-/**
- * Read a fixture file. Returns `null` when the fixture is missing
- * (replay falls back to running normally with a clear stderr line).
- *
- * Throws on parse / version errors — corruption is not a passing
- * case and silently ignoring it would mask real regressions.
- */
-export declare function readFixture(dir: string, suite: string, caseName: string): Promise<EvalFixture | null>;
-/**
- * Write a fixture, creating intermediate directories as needed.
- * Pretty-printed (2-space) so PR diffs remain readable when the
- * model output evolves.
- */
-export declare function writeFixture(dir: string, suite: string, caseName: string, payload: Omit<EvalFixture, 'version' | 'suite' | 'case' | 'recordedAt'>): Promise<string>;
-//# sourceMappingURL=fixtures.d.ts.map

package/dist/eval/fixtures.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/eval/fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,aAAa,CAAA;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAK,CAAC,CAAA;IACb,KAAK,EAAO,MAAM,CAAA;IAClB,IAAI,EAAQ,MAAM,CAAA;IAClB,KAAK,EAAO,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAO,UAAU,EAAE,CAAA;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,UAAU,EAAE,CAWvE;AASD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhF;AAID;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAO,MAAM,EAChB,KAAK,EAAK,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAiB7B;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAO,MAAM,EAChB,KAAK,EAAK,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAG,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,YAAY,CAAC,GACvE,OAAO,CAAC,MAAM,CAAC,CAYjB"}