@rudderjs/ai 1.18.2 → 1.18.4

package/dist/commands/ai-eval.js

@@ -1,5 +1,380 @@
-// @rudderjs/ai is deprecated. The AI engine now lives in @gemstack/ai-sdk.
-// This module re-exports it for backwards compatibility; import from
-// '@gemstack/ai-sdk/commands/ai-eval' directly in new code.
-export * from '@gemstack/ai-sdk/commands/ai-eval';
+/**
+ * `pnpm rudder ai:eval` — discover `evals/**\/*.eval.ts` suites,
+ * run each, and report. Console reporter by default; `--json` emits
+ * a machine-readable envelope to stdout for CI.
+ *
+ * This is a Rudder CLI binding: it reads `config('ai')` via
+ * `@rudderjs/core` and registers onto the Rudder runner, so it lives
+ * on the Rudder side. The eval framework it drives (`runSuite`,
+ * reporters, fixtures) lives in the agnostic `@gemstack/ai-sdk/eval`.
+ *
+ * Registered from the CLI loader (`packages/cli/src/index.ts`)
+ * — the AiProvider doesn't own this so it surfaces even when the
+ * user app fails to boot, matching the `command:list --json`
+ * graceful-degradation pattern from #349.
+ */
+import { readdir } from 'node:fs/promises';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { runSuite, reportConsole, evalSuite, stepsFromResponse, reportJson, reportHtml, defaultFixturesDir, readFixture, writeFixture, } from '@gemstack/ai-sdk/eval';
+import { AiFake } from '@gemstack/ai-sdk';
+/** Register the `ai:eval` command on the rudder runner. */
+export function registerAiEvalCommand(rudder) {
+    rudder.command('ai:eval', async (rawArgs) => {
+        const code = await runEvalCli(parseArgs(rawArgs));
+        if (code !== 0)
+            process.exit(code);
+    }).description('Run eval suites — pnpm rudder ai:eval [name-pattern] [--bail] [--json] [--record|--replay] [--html <path>]');
+}
+// ─── Args parser ─────────────────────────────────────────
+const VALUE_FLAGS = new Set(['--html']);
+/**
+ * Parse the rest-of-line. Recognizes:
+ *  - boolean flags: `--bail`, `--json`, `--record`, `--replay`
+ *  - value flags  : `--html <path>` or `--html=<path>`
+ *  - one positional name filter (anything not consumed above)
+ */
+export function parseArgs(args) {
+    const positional = [];
+    const opts = { bail: false, json: false };
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (!a.startsWith('--')) {
+            positional.push(a);
+            continue;
+        }
+        // `--flag=value` form
+        const eq = a.indexOf('=');
+        const name = eq >= 0 ? a.slice(0, eq) : a;
+        const inline = eq >= 0 ? a.slice(eq + 1) : undefined;
+        if (name === '--bail') {
+            opts.bail = true;
+            continue;
+        }
+        if (name === '--json') {
+            opts.json = true;
+            continue;
+        }
+        if (name === '--record') {
+            opts.record = true;
+            continue;
+        }
+        if (name === '--replay') {
+            opts.replay = true;
+            continue;
+        }
+        if (VALUE_FLAGS.has(name)) {
+            const value = inline ?? args[i + 1];
+            if (!inline)
+                i++; // consumed the next arg
+            if (!value)
+                throw new Error(`[ai:eval] ${name} requires a value`);
+            if (name === '--html')
+                opts.html = value;
+            continue;
+        }
+        // unknown flag — surface as positional so the user sees the typo
+        positional.push(a);
+    }
+    if (positional[0])
+        opts.filter = positional[0];
+    return opts;
+}
+// ─── Runner ──────────────────────────────────────────────
+/**
+ * Execute the CLI flow. Returns the process exit code (0 = all pass,
+ * 1 = at least one suite had a failure or no suites discovered).
+ *
+ * The handler is `process.exit`-free so tests can drive it directly.
+ */
+export async function runEvalCli(opts, deps = {}) {
+    const cwd = deps.cwd ?? process.cwd();
+    const stdout = deps.stdout ?? process.stdout;
+    const stderr = deps.stderr ?? process.stderr;
+    if (opts.record && opts.replay) {
+        stderr.write('[ai:eval] --record and --replay are mutually exclusive\n');
+        return 1;
+    }
+    const pattern = await Promise.resolve((deps.configPattern ?? loadConfigPattern)()) ?? 'evals/**/*.eval.ts';
+    const discover = deps.discover ?? discoverSuiteFiles;
+    const files = await discover(cwd, pattern);
+    if (files.length === 0) {
+        stderr.write(`[ai:eval] no suites found matching ${pattern}\n`);
+        return opts.json ? emitJson(stdout, []) : 1;
+    }
+    const loader = deps.loadSuite ?? defaultSuiteLoader;
+    const fixturesDir = deps.fixturesDir ?? defaultFixturesDir(cwd);
+    const reports = [];
+    const fullReports = [];
+    let exitCode = 0;
+    // `--replay` swaps the global runtime once, restored when we're done.
+    // The per-case fixture is set on the AiFake instance inside the
+    // wrapped agent factory just before each case's `agent.prompt()`.
+    let fake = null;
+    if (opts.replay)
+        fake = AiFake.fake();
+    try {
+        for (const file of files) {
+            let suite;
+            try {
+                suite = await loader(file);
+            }
+            catch (err) {
+                stderr.write(`[ai:eval] failed to load ${path.relative(cwd, file)}: ${formatError(err)}\n`);
+                exitCode = 1;
+                if (opts.bail)
+                    break;
+                continue;
+            }
+            if (!suite) {
+                stderr.write(`[ai:eval] ${path.relative(cwd, file)} has no default eval suite — skipping\n`);
+                continue;
+            }
+            if (opts.filter && !suite.name.toLowerCase().includes(opts.filter.toLowerCase()))
+                continue;
+            const decorated = await decorateForMode(suite, opts, { fixturesDir, stderr, fake });
+            const report = await runSuite(decorated);
+            fullReports.push(report);
+            if (opts.json) {
+                reports.push(reportJson(report));
+            }
+            else {
+                reportConsole(report, { log: (s) => stdout.write(`${s}\n`) });
+            }
+            if (report.failed > 0) {
+                exitCode = 1;
+                if (opts.bail)
+                    break;
+            }
+        }
+    }
+    finally {
+        if (fake)
+            fake.restore();
+    }
+    if (opts.json)
+        emitJson(stdout, reports);
+    if (opts.html)
+        await writeHtmlReport(opts.html, fullReports, cwd, stderr);
+    return exitCode;
+}
+async function writeHtmlReport(htmlPath, reports, cwd, stderr) {
+    const { writeFile, mkdir } = await import('node:fs/promises');
+    const abs = path.isAbsolute(htmlPath) ? htmlPath : path.resolve(cwd, htmlPath);
+    try {
+        await mkdir(path.dirname(abs), { recursive: true });
+        await writeFile(abs, reportHtml(reports));
+        stderr.write(`[ai:eval] wrote HTML report → ${path.relative(cwd, abs)}\n`);
+    }
+    catch (err) {
+        stderr.write(`[ai:eval] failed to write HTML report ${abs}: ${formatError(err)}\n`);
+    }
+}
+function emitJson(stdout, suites) {
+    stdout.write(`${JSON.stringify({ suites }, null, 2)}\n`);
+    return 0;
+}
+function formatError(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/**
+ * Wrap a suite so each case captures the response (`--record`) or
+ * pre-loads the fake's sequence (`--replay`) before running. A
+ * normal run returns the suite untouched.
+ *
+ * Implemented as a per-case `agent` / `assert` decoration so the
+ * runner stays unchanged — `runSuite` doesn't need to know about
+ * the fixture format. The original `agent`/`assert` for each case
+ * are still called; we just slip work in around them.
+ *
+ * For replay, fixtures load up-front (sync factory contract) so the
+ * AiFake is primed before each `agent.prompt()` runs.
+ */
+async function decorateForMode(suite, opts, ctx) {
+    if (!opts.record && !opts.replay)
+        return suite;
+    // Pre-load every fixture for replay so the per-case factory can
+    // call `respondWithSequence` synchronously.
+    const replaySteps = new Map();
+    if (opts.replay) {
+        for (let i = 0; i < suite.spec.cases.length; i++) {
+            const c = suite.spec.cases[i];
+            const caseName = c.name ?? `case-${i}`;
+            try {
+                const fixture = await readFixture(ctx.fixturesDir, suite.name, caseName);
+                if (fixture)
+                    replaySteps.set(caseName, fixture.steps);
+                else
+                    ctx.stderr.write(`[ai:eval] no fixture for ${suite.name}/${caseName} — running against live provider\n`);
+            }
+            catch (err) {
+                ctx.stderr.write(`[ai:eval] fixture load error for ${suite.name}/${caseName}: ${formatError(err)}\n`);
+            }
+        }
+    }
+    const wrapped = suite.spec.cases.map((c, i) => {
+        const caseName = c.name ?? `case-${i}`;
+        const baseFactory = c.agent ?? suite.spec.agent;
+        const baseAssert = c.assert;
+        const factory = opts.replay
+            ? wrapReplayFactory(baseFactory, replaySteps.get(caseName), ctx.fake)
+            : baseFactory;
+        const assert = opts.record
+            ? wrapRecordAssert(baseAssert, suite.name, caseName, c.input, ctx)
+            : baseAssert;
+        const out = {
+            input: c.input,
+            assert,
+            agent: factory,
+        };
+        if (c.name)
+            out.name = c.name;
+        if (c.timeout !== undefined)
+            out.timeout = c.timeout;
+        if (c.skip !== undefined)
+            out.skip = c.skip;
+        return out;
+    });
+    const newSpec = {
+        agent: suite.spec.agent,
+        cases: wrapped,
+    };
+    if (suite.spec.timeout !== undefined)
+        newSpec.timeout = suite.spec.timeout;
+    return evalSuite(suite.name, newSpec);
+}
+/**
+ * Replay path: before each case runs, prime the shared `AiFake`
+ * with the case's recorded steps. When the fixture is missing the
+ * factory still returns the agent — it'll hit whatever the AiFake
+ * is currently scripted to return (typically falling back to the
+ * default ambient response, which surfaces as an obvious diff in
+ * the case's assertion).
+ */
+function wrapReplayFactory(base, steps, fake) {
+    return () => {
+        if (fake && steps)
+            fake.respondWithSequence(steps);
+        return base();
+    };
+}
+/**
+ * Record path: after each case's assertion runs, capture the
+ * agent response's assistant turns to the fixture file. Wrapping
+ * the assert is the cleanest hook — the runner already passes
+ * `response` into it, and the wrapped fn still returns the
+ * original assertion's result.
+ */
+function wrapRecordAssert(base, suite, caseName, input, ctx) {
+    return async (response, mctx) => {
+        try {
+            const file = await writeFixture(ctx.fixturesDir, suite, caseName, {
+                input,
+                steps: stepsFromResponse(response),
+            });
+            ctx.stderr.write(`[ai:eval] recorded ${path.relative(process.cwd(), file)}\n`);
+        }
+        catch (err) {
+            ctx.stderr.write(`[ai:eval] failed to record ${suite}/${caseName}: ${formatError(err)}\n`);
+        }
+        return base(response, mctx);
+    };
+}
+// ─── File discovery ──────────────────────────────────────
+/**
+ * Recursive walk constrained to a `<dir>/**\/*<suffix>` shape.
+ * Returns absolute paths sorted lexicographically for stable test
+ * output and predictable `--bail` ordering.
+ */
+export async function discoverSuiteFiles(cwd, pattern) {
+    const { root, suffix } = parsePattern(pattern);
+    const absRoot = path.resolve(cwd, root);
+    const out = [];
+    await walk(absRoot, suffix, out);
+    return out.sort();
+}
+/**
+ * Tiny pattern parser — supports `<dir>/**\/*<suffix>` and bare
+ * `*<suffix>` (current directory). Anything more elaborate is
+ * deferred to userland (run a custom script that imports `runSuite`).
+ *
+ * Examples:
+ *   `evals/**\/*.eval.ts`     → root=`evals`,    suffix=`.eval.ts`
+ *   `tests/agents/**\/*.ts`   → root=`tests/agents`, suffix=`.ts`
+ *   `*.eval.ts`               → root=`.`,        suffix=`.eval.ts`
+ */
+function parsePattern(pattern) {
+    const doubleStar = pattern.indexOf('**');
+    let prefix;
+    let postfix;
+    if (doubleStar >= 0) {
+        prefix = pattern.slice(0, doubleStar).replace(/\/$/, '');
+        postfix = pattern.slice(doubleStar + 2).replace(/^\//, '');
+    }
+    else {
+        const lastSlash = pattern.lastIndexOf('/');
+        prefix = lastSlash >= 0 ? pattern.slice(0, lastSlash) : '';
+        postfix = lastSlash >= 0 ? pattern.slice(lastSlash + 1) : pattern;
+    }
+    if (!postfix.startsWith('*')) {
+        throw new Error(`[ai:eval] Unsupported eval pattern "${pattern}". ` +
+            `Expected <dir>/**/*<suffix> or *<suffix>.`);
+    }
+    return {
+        root: prefix || '.',
+        suffix: postfix.slice(1),
+    };
+}
+async function walk(dir, suffix, out) {
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return;
+        throw err;
+    }
+    for (const entry of entries) {
+        const p = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === 'node_modules' || entry.name.startsWith('.'))
+                continue;
+            await walk(p, suffix, out);
+        }
+        else if (entry.isFile() && entry.name.endsWith(suffix)) {
+            out.push(p);
+        }
+    }
+}
+// ─── Suite loader ────────────────────────────────────────
+async function defaultSuiteLoader(file) {
+    const mod = await import(pathToFileURL(file).href);
+    const candidate = (mod['default'] ?? mod['suite']);
+    if (!candidate || typeof candidate.name !== 'string' || !candidate.spec)
+        return null;
+    return candidate;
+}
+// ─── Config lookup ───────────────────────────────────────
+/**
+ * Read `config('ai').eval.pattern` from the booted app. Returns
+ * `null` (default pattern) when `@rudderjs/core` isn't loadable
+ * or the app didn't boot — the CLI must still work in
+ * introspective mode (#349).
+ */
+async function loadConfigPattern() {
+    try {
+        // Dynamic import so the static graph doesn't pin `@rudderjs/core`
+        // (optional peer). Falls back to default when core isn't loadable
+        // or the app didn't boot.
+        const core = await import('@rudderjs/core');
+        if (typeof core.config !== 'function')
+            return null;
+        const cfg = core.config('ai');
+        return cfg?.eval?.pattern ?? null;
+    }
+    catch {
+        return null;
+    }
+}
 //# sourceMappingURL=ai-eval.js.map

package/dist/commands/ai-eval.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-eval.js","sourceRoot":"","sources":["../../src/commands/ai-eval.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,qEAAqE;AACrE,4DAA4D;AAC5D,cAAc,mCAAmC,CAAA"}
+{"version":3,"file":"ai-eval.js","sourceRoot":"","sources":["../../src/commands/ai-eval.ts"],"names":[],"mappings":"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"}

package/dist/commands/make-agent.d.ts

@@ -1,2 +1,3 @@
-export * from '@gemstack/ai-sdk/commands/make-agent';
+import type { MakeSpec } from '@rudderjs/console';
+export declare const makeAgentSpec: MakeSpec;
 //# sourceMappingURL=make-agent.d.ts.map

package/dist/commands/make-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"make-agent.d.ts","sourceRoot":"","sources":["../../src/commands/make-agent.ts"],"names":[],"mappings":"AAGA,cAAc,sCAAsC,CAAA"}
+{"version":3,"file":"make-agent.d.ts","sourceRoot":"","sources":["../../src/commands/make-agent.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEjD,eAAO,MAAM,aAAa,EAAE,QAqB3B,CAAA"}

package/dist/commands/make-agent.js

@@ -1,5 +1,23 @@
-// @rudderjs/ai is deprecated. The AI engine now lives in @gemstack/ai-sdk.
-// This module re-exports it for backwards compatibility; import from
-// '@gemstack/ai-sdk/commands/make-agent' directly in new code.
-export * from '@gemstack/ai-sdk/commands/make-agent';
+export const makeAgentSpec = {
+    command: 'make:agent',
+    description: 'Create a new AI agent class',
+    label: 'Agent created',
+    suffix: 'Agent',
+    directory: 'app/Agents',
+    stub: (className) => `import { Agent } from '@gemstack/ai-sdk'
+import type { HasTools, AnyTool } from '@gemstack/ai-sdk'
+
+export class ${className} extends Agent implements HasTools {
+  instructions(): string {
+    return 'You are a helpful assistant.'
+  }
+
+  // model(): string | undefined { return 'anthropic/claude-sonnet-4-5' }
+
+  tools(): AnyTool[] {
+    return []
+  }
+}
+`,
+};
 //# sourceMappingURL=make-agent.js.map

package/dist/commands/make-agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"make-agent.js","sourceRoot":"","sources":["../../src/commands/make-agent.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,qEAAqE;AACrE,+DAA+D;AAC/D,cAAc,sCAAsC,CAAA"}
+{"version":3,"file":"make-agent.js","sourceRoot":"","sources":["../../src/commands/make-agent.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,aAAa,GAAa;IACrC,OAAO,EAAM,YAAY;IACzB,WAAW,EAAE,6BAA6B;IAC1C,KAAK,EAAQ,eAAe;IAC5B,MAAM,EAAO,OAAO;IACpB,SAAS,EAAI,YAAY;IACzB,IAAI,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC;;;eAGR,SAAS;;;;;;;;;;;CAWvB;CACA,CAAA"}

package/dist/conversation-orm/index.d.ts

@@ -1,2 +1,116 @@
-export * from '@gemstack/ai-sdk/conversation-orm';
+/**
+ * `@rudderjs/ai/conversation-orm` - ORM-backed {@link ConversationStore}.
+ *
+ * Production-grade replacement for `MemoryConversationStore` (which is
+ * single-process, in-memory, and loses every thread on restart). Persists
+ * conversation threads and their messages via the registered `@rudderjs/orm`
+ * adapter - works across web processes, queue workers, and horizontally
+ * scaled deployments. Mirrors the `@rudderjs/ai/memory-orm` /
+ * `@rudderjs/ai/budget-orm` pattern.
+ *
+ * Wire it as the conversation store:
+ *
+ * ```ts
+ * import { setConversationStore } from '@gemstack/ai-sdk'
+ * import { OrmConversationStore } from '@rudderjs/ai/conversation-orm'
+ *
+ * setConversationStore(new OrmConversationStore())
+ * ```
+ *
+ * The schema lives at {@link conversationOrmPrismaSchema} - copy it into your
+ * Prisma schema (or a new `prisma/schema/<file>.prisma` if you use the
+ * multi-file setup). On the native engine, add an equivalent migration; on
+ * Drizzle, define matching tables and register them via `tables: { ... }`.
+ *
+ * # Adapter coverage
+ *
+ * - Prisma - works out of the box; copy {@link conversationOrmPrismaSchema}.
+ * - Native - add a migration with the same columns.
+ * - Drizzle - define the two tables and register them on the `drizzle()`
+ *   config.
+ *
+ * # Ordering & concurrency
+ *
+ * Messages carry a monotonic per-thread `position` so `load()` returns them
+ * in append order regardless of timestamp granularity. `append()` reads the
+ * current max position and assigns the next slots; like
+ * `OrmBudgetStorage.checkAndDebit`, the read-then-write is not isolated, so
+ * two concurrent appends to the SAME thread could collide on a position.
+ * Conversation threads are single-writer in practice (one user, one turn at
+ * a time), so this is a non-issue for typical apps. File an issue if you hit
+ * it; strict ordering needs a serializable transaction or a DB sequence.
+ */
+import { Model } from '@rudderjs/orm';
+import type { AiMessage, ConversationStore, ConversationStoreMeta } from '@gemstack/ai-sdk';
+/**
+ * Entry shape returned by {@link ConversationStore.list}. Derived from the
+ * engine's exported `ConversationStore` interface so it stays in lockstep
+ * without depending on the type being exported by name.
+ */
+type ConversationStoreListEntry = Awaited<ReturnType<ConversationStore['list']>>[number];
+/**
+ * The thread row backing {@link OrmConversationStore}. Exposed so apps that
+ * want their own queries (admin views, analytics) can use
+ * `AiConversationRecord.where(...).get()` directly.
+ *
+ * `userId` / `agent` mirror {@link ConversationStoreMeta} - `userId` scopes
+ * `list()`, `agent` carries the thread-segregation key the auto-persist
+ * machinery uses to keep one user's threads per agent class apart.
+ */
+export declare class AiConversationRecord extends Model {
+    static table: string;
+    static fillable: string[];
+    id: string;
+    title: string;
+    userId: string | null;
+    agent: string | null;
+    createdAt: Date;
+    updatedAt: Date | null;
+}
+/**
+ * One message row in a thread. `content` and `toolCalls` are JSON-encoded
+ * strings (so a `string` content and a `ContentPart[]` content both
+ * round-trip through a portable `text` column); `position` orders them.
+ */
+export declare class AiConversationMessageRecord extends Model {
+    static table: string;
+    static fillable: string[];
+    id: string;
+    conversationId: string;
+    position: number;
+    role: string;
+    /** JSON-encoded `string | ContentPart[]`. */
+    content: string;
+    toolCallId: string | null;
+    /** JSON-encoded `ToolCall[]` or null. */
+    toolCalls: string | null;
+    createdAt: Date;
+}
+/**
+ * {@link ConversationStore} implementation that persists rows to the
+ * registered ORM adapter. Designed for production use - the in-process
+ * `MemoryConversationStore` is for tests and dev.
+ */
+export declare class OrmConversationStore implements ConversationStore {
+    create(title?: string, meta?: ConversationStoreMeta): Promise<string>;
+    load(conversationId: string): Promise<AiMessage[]>;
+    append(conversationId: string, messages: AiMessage[]): Promise<void>;
+    setTitle(conversationId: string, title: string): Promise<void>;
+    list(userId?: string): Promise<ConversationStoreListEntry[]>;
+    delete(conversationId: string): Promise<void>;
+    /** Throw the same not-found error shape as `MemoryConversationStore`. */
+    private requireThread;
+    /** Next monotonic position for the thread (0 when empty). */
+    private nextPosition;
+}
+/** Convenience factory mirroring `ormBudgetStorage()` / `OrmUserMemory`. */
+export declare function ormConversationStore(): OrmConversationStore;
+/**
+ * Reference Prisma schema for `OrmConversationStore`. Copy into your
+ * `prisma/schema/<file>.prisma`. SQLite stores the `text` content as TEXT;
+ * Postgres as `text`. The `@@index` keeps `list()` (by user) and `load()`
+ * (by thread, ordered) cheap.
+ */
+export declare const conversationOrmPrismaSchema = "model AiConversation {\n  id        String   @id @default(cuid())\n  title     String\n  userId    String?\n  /// Thread-segregation key - the agent class name by default\n  agent     String?\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([userId])\n}\n\nmodel AiConversationMessage {\n  id             String   @id @default(cuid())\n  conversationId String\n  /// Monotonic per-thread ordering\n  position       Int\n  role           String\n  /// JSON-encoded `string | ContentPart[]`\n  content        String\n  toolCallId     String?\n  /// JSON-encoded `ToolCall[]` or null\n  toolCalls      String?\n  createdAt      DateTime @default(now())\n\n  @@index([conversationId, position])\n}\n";
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/conversation-orm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversation-orm/index.ts"],"names":[],"mappings":"AAGA,cAAc,mCAAmC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversation-orm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAErC,OAAO,KAAK,EACV,SAAS,EACT,iBAAiB,EACjB,qBAAqB,EAEtB,MAAM,kBAAkB,CAAA;AAEzB;;;;GAIG;AACH,KAAK,0BAA0B,GAAG,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AAIxF;;;;;;;;GAQG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,OAAgB,KAAK,SAAsB;IAC3C,OAAgB,QAAQ,WAA4C;IAE5D,EAAE,EAAS,MAAM,CAAA;IACjB,KAAK,EAAM,MAAM,CAAA;IACjB,MAAM,EAAK,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,EAAM,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,EAAE,IAAI,GAAG,IAAI,CAAA;CAC/B;AAED;;;;GAIG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,OAAgB,KAAK,SAA6B;IAClD,OAAgB,QAAQ,WAA+E;IAE/F,EAAE,EAAc,MAAM,CAAA;IACtB,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAQ,MAAM,CAAA;IACtB,IAAI,EAAY,MAAM,CAAA;IAC9B,6CAA6C;IACrC,OAAO,EAAS,MAAM,CAAA;IACtB,UAAU,EAAM,MAAM,GAAG,IAAI,CAAA;IACrC,yCAAyC;IACjC,SAAS,EAAO,MAAM,GAAG,IAAI,CAAA;IAC7B,SAAS,EAAO,IAAI,CAAA;CAC7B;AAID;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,iBAAiB;IACtD,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IASrE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAYlD,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAapE,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9D,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,EAAE,CAAC;IAO5D,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD,yEAAyE;YAC3D,aAAa;IAK3B,6DAA6D;YAC/C,YAAY;CAO3B;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,IAAI,oBAAoB,CAE3D;AAID;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,+tBA2BvC,CAAA"}