@rudderjs/ai 1.17.3 → 1.18.0

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

@@ -1,96 +1,2 @@
-/**
- * `@rudderjs/ai/budget-orm` — ORM-backed {@link BudgetStorage} for #A6 Phase 4.
- *
- * Production-grade replacement for `memoryBudgetStorage()` (which is
- * single-process only). Persists per-user spend counters in a
- * `BudgetUsage` table via the registered `@rudderjs/orm` adapter — works
- * across queue workers, web processes, and horizontally-scaled deployments.
- *
- * Wire it into your AI middleware:
- *
- * ```ts
- * import { withBudget } from '@rudderjs/ai'
- * import { ormBudgetStorage } from '@rudderjs/ai/budget-orm'
- *
- * const budgeted = withBudget({
- *   user:    (ctx) => ctx.context as string,
- *   budget:  () => ({ daily: 0.50, monthly: 10 }),
- *   storage: ormBudgetStorage(),
- * })
- * ```
- *
- * The schema lives at {@link budgetUsagePrismaSchema} — copy it into your
- * Prisma schema (or a new `prisma/schema/<file>.prisma` if you use the
- * multi-file setup). The `@@unique([userId, period, periodKey])`
- * constraint is the one load-bearing index — without it, the
- * find-or-create path can race and produce duplicate rows.
- *
- * # Atomicity caveat
- *
- * `checkAndDebit` does a read-then-conditional-increment. The increment
- * itself is atomic (`UPDATE col = col + n`), but the cap check sits
- * between the read and the write. Under high concurrency for a single
- * user (more than ~1 in-flight budgeted request at a time), total spend
- * can briefly exceed `cap` by up to `costUsd × concurrency`. For typical
- * apps this is a non-issue.
- *
- * Strict guarantees require a database transaction with serializable
- * isolation or a Redis-backed counter — both planned as follow-ups. File
- * an issue if you hit this in production.
- */
-import { Model } from '@rudderjs/orm';
-import { type BudgetCheckOptions, type BudgetCheckResult, type BudgetPeriod, type BudgetStorage } from '../budget/storage.js';
-/**
- * Model row backing {@link OrmBudgetStorage}. Exposed so apps that
- * want admin views (e.g. "show me top spenders this month") can use
- * `BudgetUsageRecord.where(...).get()` instead of routing every read
- * through the {@link BudgetStorage} interface.
- *
- * The `@@unique([userId, period, periodKey])` constraint is required —
- * without it, two concurrent first-writes for the same user/period
- * create duplicate rows and the cap accounting silently drifts.
- */
-export declare class BudgetUsageRecord extends Model {
-    static table: string;
-    static fillable: string[];
-    id: string;
-    userId: string;
-    /** `'daily'` or `'monthly'`. */
-    period: string;
-    /** TZ-aware bucket key — `YYYY-MM-DD` (daily) or `YYYY-MM` (monthly). */
-    periodKey: string;
-    /** Cumulative USD spend in this period. */
-    spent: number;
-    createdAt: Date;
-    updatedAt: Date | null;
-}
-/**
- * Production `BudgetStorage` backed by the registered `@rudderjs/orm`
- * adapter. See the module JSDoc for setup + the atomicity caveat.
- */
-export declare class OrmBudgetStorage implements BudgetStorage {
-    checkAndDebit(opts: BudgetCheckOptions): Promise<BudgetCheckResult>;
-    /** Apply the read-then-conditional-increment path on an existing row. */
-    private _applyIncrementPath;
-    reset(userId: string, period: BudgetPeriod, now?: Date, timezone?: string): Promise<void>;
-}
-/**
- * Convenience factory — returns a fresh {@link OrmBudgetStorage}
- * instance. Prefer this over `new OrmBudgetStorage()` for symmetry with
- * `memoryBudgetStorage()`.
- */
-export declare function ormBudgetStorage(): BudgetStorage;
-/**
- * Reference Prisma schema for `OrmBudgetStorage`. Copy into your
- * `prisma/schema/<file>.prisma` (or paste alongside an existing model).
- *
- * The `@@unique([userId, period, periodKey])` constraint is required —
- * without it the find-or-create path can race and produce duplicate
- * rows, breaking cap accounting.
- *
- * SQLite stores `Float` as `REAL`; Postgres / MySQL as `DOUBLE
- * PRECISION` / `DOUBLE`. All three give 15+ significant digits — more
- * than enough for sub-cent budget tracking.
- */
-export declare const budgetUsagePrismaSchema = "model BudgetUsage {\n  id        String   @id @default(cuid())\n  userId    String\n  /// 'daily' | 'monthly'\n  period    String\n  /// YYYY-MM-DD (daily) or YYYY-MM (monthly), in the configured timezone\n  periodKey String\n  /// Cumulative USD spend in this period\n  spent     Float    @default(0)\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@unique([userId, period, periodKey])\n  @@index([userId])\n}\n";
+export * from '@gemstack/ai-sdk/budget-orm';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/budget-orm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AACrC,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,aAAa,EAEnB,MAAM,sBAAsB,CAAA;AAI7B;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,OAAgB,KAAK,SAAmB;IACxC,OAAgB,QAAQ,WAA6C;IAE7D,EAAE,EAAS,MAAM,CAAA;IACjB,MAAM,EAAK,MAAM,CAAA;IACzB,gCAAgC;IACxB,MAAM,EAAK,MAAM,CAAA;IACzB,yEAAyE;IACjE,SAAS,EAAE,MAAM,CAAA;IACzB,2CAA2C;IACnC,KAAK,EAAM,MAAM,CAAA;IACjB,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,EAAE,IAAI,GAAG,IAAI,CAAA;CAC/B;AAID;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,aAAa;IAC9C,aAAa,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAuDzE,yEAAyE;YAC3D,mBAAmB;IAsB3B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQhG;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAID;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,8bAenC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/budget-orm/index.ts"],"names":[],"mappings":"AAGA,cAAc,6BAA6B,CAAA"}

package/dist/budget-orm/index.js

@@ -1,177 +1,5 @@
-/**
- * `@rudderjs/ai/budget-orm` — ORM-backed {@link BudgetStorage} for #A6 Phase 4.
- *
- * Production-grade replacement for `memoryBudgetStorage()` (which is
- * single-process only). Persists per-user spend counters in a
- * `BudgetUsage` table via the registered `@rudderjs/orm` adapter — works
- * across queue workers, web processes, and horizontally-scaled deployments.
- *
- * Wire it into your AI middleware:
- *
- * ```ts
- * import { withBudget } from '@rudderjs/ai'
- * import { ormBudgetStorage } from '@rudderjs/ai/budget-orm'
- *
- * const budgeted = withBudget({
- *   user:    (ctx) => ctx.context as string,
- *   budget:  () => ({ daily: 0.50, monthly: 10 }),
- *   storage: ormBudgetStorage(),
- * })
- * ```
- *
- * The schema lives at {@link budgetUsagePrismaSchema} — copy it into your
- * Prisma schema (or a new `prisma/schema/<file>.prisma` if you use the
- * multi-file setup). The `@@unique([userId, period, periodKey])`
- * constraint is the one load-bearing index — without it, the
- * find-or-create path can race and produce duplicate rows.
- *
- * # Atomicity caveat
- *
- * `checkAndDebit` does a read-then-conditional-increment. The increment
- * itself is atomic (`UPDATE col = col + n`), but the cap check sits
- * between the read and the write. Under high concurrency for a single
- * user (more than ~1 in-flight budgeted request at a time), total spend
- * can briefly exceed `cap` by up to `costUsd × concurrency`. For typical
- * apps this is a non-issue.
- *
- * Strict guarantees require a database transaction with serializable
- * isolation or a Redis-backed counter — both planned as follow-ups. File
- * an issue if you hit this in production.
- */
-import { Model } from '@rudderjs/orm';
-import { periodKey as buildPeriodKey, } from '../budget/storage.js';
-// ─── ORM Model ────────────────────────────────────────────
-/**
- * Model row backing {@link OrmBudgetStorage}. Exposed so apps that
- * want admin views (e.g. "show me top spenders this month") can use
- * `BudgetUsageRecord.where(...).get()` instead of routing every read
- * through the {@link BudgetStorage} interface.
- *
- * The `@@unique([userId, period, periodKey])` constraint is required —
- * without it, two concurrent first-writes for the same user/period
- * create duplicate rows and the cap accounting silently drifts.
- */
-export class BudgetUsageRecord extends Model {
-    static table = 'budgetUsage';
-    static fillable = ['userId', 'period', 'periodKey', 'spent'];
-}
-// ─── BudgetStorage adapter ────────────────────────────────
-/**
- * Production `BudgetStorage` backed by the registered `@rudderjs/orm`
- * adapter. See the module JSDoc for setup + the atomicity caveat.
- */
-export class OrmBudgetStorage {
-    async checkAndDebit(opts) {
-        if (!Number.isFinite(opts.cap) || opts.cap < 0) {
-            throw new Error(`[Rudder AI] BudgetStorage: cap must be a non-negative finite number, got ${opts.cap}`);
-        }
-        if (!Number.isFinite(opts.costUsd) || opts.costUsd < 0) {
-            throw new Error(`[Rudder AI] BudgetStorage: costUsd must be a non-negative finite number, got ${opts.costUsd}`);
-        }
-        const now = opts.now ?? new Date();
-        const key = buildPeriodKey(opts.period, now, opts.timezone);
-        const existing = await BudgetUsageRecord
-            .where('userId', opts.userId)
-            .where('period', opts.period)
-            .where('periodKey', key)
-            .first();
-        // ─── No row yet — first write for this period ─────────
-        if (!existing) {
-            // Pure-read on an empty bucket — still empty after.
-            if (opts.costUsd === 0) {
-                return { allowed: true, spent: 0, cap: opts.cap };
-            }
-            // Single debit larger than cap — refuse before creating the row,
-            // so we don't pollute storage with denied requests.
-            if (opts.costUsd > opts.cap) {
-                return { allowed: false, spent: 0, cap: opts.cap };
-            }
-            try {
-                await BudgetUsageRecord.create({
-                    userId: opts.userId,
-                    period: opts.period,
-                    periodKey: key,
-                    spent: opts.costUsd,
-                });
-                return { allowed: true, spent: opts.costUsd, cap: opts.cap };
-            }
-            catch (e) {
-                // Race: another caller created the row between our `first()` and
-                // `create()`. Re-read and fall through to the increment path.
-                // We deliberately don't sniff the error type — any create failure
-                // means the row may now exist; let the re-read decide.
-                const refetched = await BudgetUsageRecord
-                    .where('userId', opts.userId)
-                    .where('period', opts.period)
-                    .where('periodKey', key)
-                    .first();
-                if (!refetched)
-                    throw e; // not a unique-constraint race; surface the original error
-                return this._applyIncrementPath(refetched, opts);
-            }
-        }
-        return this._applyIncrementPath(existing, opts);
-    }
-    /** Apply the read-then-conditional-increment path on an existing row. */
-    async _applyIncrementPath(row, opts) {
-        const current = Number(row.spent ?? 0);
-        // Pure read.
-        if (opts.costUsd === 0) {
-            return { allowed: true, spent: current, cap: opts.cap };
-        }
-        // Cap check — read-then-decide. Atomic under single-writer; under
-        // concurrent writers, see the module-level atomicity caveat.
-        if (current + opts.costUsd > opts.cap) {
-            return { allowed: false, spent: current, cap: opts.cap };
-        }
-        const updated = await BudgetUsageRecord.increment(row.id, 'spent', opts.costUsd);
-        const newSpent = Number(updated?.spent ?? current + opts.costUsd);
-        return { allowed: true, spent: newSpent, cap: opts.cap };
-    }
-    async reset(userId, period, now, timezone) {
-        const key = buildPeriodKey(period, now ?? new Date(), timezone);
-        await BudgetUsageRecord
-            .where('userId', userId)
-            .where('period', period)
-            .where('periodKey', key)
-            .deleteAll();
-    }
-}
-/**
- * Convenience factory — returns a fresh {@link OrmBudgetStorage}
- * instance. Prefer this over `new OrmBudgetStorage()` for symmetry with
- * `memoryBudgetStorage()`.
- */
-export function ormBudgetStorage() {
-    return new OrmBudgetStorage();
-}
-// ─── Schema reference ─────────────────────────────────────
-/**
- * Reference Prisma schema for `OrmBudgetStorage`. Copy into your
- * `prisma/schema/<file>.prisma` (or paste alongside an existing model).
- *
- * The `@@unique([userId, period, periodKey])` constraint is required —
- * without it the find-or-create path can race and produce duplicate
- * rows, breaking cap accounting.
- *
- * SQLite stores `Float` as `REAL`; Postgres / MySQL as `DOUBLE
- * PRECISION` / `DOUBLE`. All three give 15+ significant digits — more
- * than enough for sub-cent budget tracking.
- */
-export const budgetUsagePrismaSchema = `model BudgetUsage {
-  id        String   @id @default(cuid())
-  userId    String
-  /// 'daily' | 'monthly'
-  period    String
-  /// YYYY-MM-DD (daily) or YYYY-MM (monthly), in the configured timezone
-  periodKey String
-  /// Cumulative USD spend in this period
-  spent     Float    @default(0)
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  @@unique([userId, period, periodKey])
-  @@index([userId])
-}
-`;
+// @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/budget-orm' directly in new code.
+export * from '@gemstack/ai-sdk/budget-orm';
 //# sourceMappingURL=index.js.map

package/dist/budget-orm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/budget-orm/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/budget-orm/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,qEAAqE;AACrE,sDAAsD;AACtD,cAAc,6BAA6B,CAAA"}

package/dist/chat-mentions.d.ts

@@ -1,59 +1,2 @@
-/**
- * `@rudderjs/ai/chat-mentions` - parse `@<slug>` agent mentions out of a chat
- * message and turn them into an orchestrator routing rule.
- *
- * A chat UX where the user types `@<slug>` to explicitly invoke an agent
- * (overriding the orchestrator's own routing judgment) is generic: chat
- * panels, Slack/Discord bots, CLIs. This ships the two reusable pieces every
- * such consumer would otherwise hand-roll:
- *
- * - {@link parseMentions} extracts and validates the tokens, returning the
- *   matched slugs plus the message with the tokens stripped.
- * - {@link buildMentionRoutingRule} renders a system-prompt rule that forces
- *   the orchestrator to dispatch the mentioned agents in order.
- *
- * Token shape: `@<slug>` where `<slug>` matches `[a-z0-9-]+`. A whitespace (or
- * start-of-string) is required before the `@` so `email@host` is not parsed as
- * a mention, and the right side is bounded by a non-word boundary so
- * `@seo-assistant.` does not eat the trailing punctuation.
- */
-/** Global regex matching an `@<slug>` mention with its leading boundary. */
-export declare const MENTION_REGEX: RegExp;
-export interface ParsedMentions {
-    /** Slugs found in the message, lower-cased, in first-seen order, deduplicated. */
-    slugs: string[];
-    /** The message with every recognized `@<slug>` token removed and whitespace collapsed. */
-    cleaned: string;
-}
-/**
- * Parse `@<slug>` mentions from a message and validate them against a set of
- * known agent slugs. Unknown mentions (e.g. `@nope`) are left in the message
- * verbatim - they are plain text, not a routing signal. Matched tokens are
- * stripped and surrounding whitespace is collapsed, so the model sees only the
- * cleaned intent.
- *
- * `knownSlugs` accepts any iterable (array or `Set`); matching is
- * case-insensitive and the returned slugs are lower-cased.
- */
-export declare function parseMentions(message: string, knownSlugs: Iterable<string>): ParsedMentions;
-export interface MentionRoutingRuleOptions {
-    /**
-     * Name of the tool the orchestrator calls to dispatch an agent.
-     * Default `'run_agent'`.
-     */
-    toolName?: string;
-    /**
-     * The argument key on that tool carrying the agent slug.
-     * Default `'agentSlug'`.
-     */
-    argKey?: string;
-}
-/**
- * Build the system-prompt rule injected when a message carries one or more
- * validated mentions. The orchestrator is instructed to call the dispatch
- * tool (default `run_agent({ agentSlug })`) for each mentioned agent in order,
- * overriding its own routing decision. Returns `null` when `slugs` is empty so
- * callers can `if (rule) systemPrompt += rule` without a length check.
- */
-export declare function buildMentionRoutingRule(slugs: readonly string[], opts?: MentionRoutingRuleOptions): string | null;
+export * from '@gemstack/ai-sdk/chat-mentions';
 //# sourceMappingURL=chat-mentions.d.ts.map

package/dist/chat-mentions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-mentions.d.ts","sourceRoot":"","sources":["../src/chat-mentions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,aAAa,QAAsC,CAAA;AAEhE,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,KAAK,EAAI,MAAM,EAAE,CAAA;IACjB,0FAA0F;IAC1F,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,cAAc,CAyB3F;AAED,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAI,MAAM,CAAA;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,IAAI,GAAG,yBAA8B,GACpC,MAAM,GAAG,IAAI,CAmBf"}
+{"version":3,"file":"chat-mentions.d.ts","sourceRoot":"","sources":["../src/chat-mentions.ts"],"names":[],"mappings":"AAGA,cAAc,gCAAgC,CAAA"}

package/dist/chat-mentions.js

@@ -1,81 +1,5 @@
-/**
- * `@rudderjs/ai/chat-mentions` - parse `@<slug>` agent mentions out of a chat
- * message and turn them into an orchestrator routing rule.
- *
- * A chat UX where the user types `@<slug>` to explicitly invoke an agent
- * (overriding the orchestrator's own routing judgment) is generic: chat
- * panels, Slack/Discord bots, CLIs. This ships the two reusable pieces every
- * such consumer would otherwise hand-roll:
- *
- * - {@link parseMentions} extracts and validates the tokens, returning the
- *   matched slugs plus the message with the tokens stripped.
- * - {@link buildMentionRoutingRule} renders a system-prompt rule that forces
- *   the orchestrator to dispatch the mentioned agents in order.
- *
- * Token shape: `@<slug>` where `<slug>` matches `[a-z0-9-]+`. A whitespace (or
- * start-of-string) is required before the `@` so `email@host` is not parsed as
- * a mention, and the right side is bounded by a non-word boundary so
- * `@seo-assistant.` does not eat the trailing punctuation.
- */
-/** Global regex matching an `@<slug>` mention with its leading boundary. */
-export const MENTION_REGEX = /(^|\s)@([a-z0-9-]+)(?=$|[^\w-])/gi;
-/**
- * Parse `@<slug>` mentions from a message and validate them against a set of
- * known agent slugs. Unknown mentions (e.g. `@nope`) are left in the message
- * verbatim - they are plain text, not a routing signal. Matched tokens are
- * stripped and surrounding whitespace is collapsed, so the model sees only the
- * cleaned intent.
- *
- * `knownSlugs` accepts any iterable (array or `Set`); matching is
- * case-insensitive and the returned slugs are lower-cased.
- */
-export function parseMentions(message, knownSlugs) {
-    const known = new Set();
-    for (const s of knownSlugs)
-        known.add(s.toLowerCase());
-    const seen = new Set();
-    const slugs = [];
-    // Fresh regex instance so a shared `MENTION_REGEX.lastIndex` can never leak
-    // across calls (the exported constant is global).
-    const re = new RegExp(MENTION_REGEX.source, MENTION_REGEX.flags);
-    const cleaned = message
-        .replace(re, (full, lead, slug) => {
-        const lower = slug.toLowerCase();
-        if (!known.has(lower))
-            return full; // unknown slug - leave intact
-        if (!seen.has(lower)) {
-            seen.add(lower);
-            slugs.push(lower);
-        }
-        return lead === '' ? '' : ' ';
-    })
-        .replace(/\s{2,}/g, ' ')
-        .trim();
-    return { slugs, cleaned };
-}
-/**
- * Build the system-prompt rule injected when a message carries one or more
- * validated mentions. The orchestrator is instructed to call the dispatch
- * tool (default `run_agent({ agentSlug })`) for each mentioned agent in order,
- * overriding its own routing decision. Returns `null` when `slugs` is empty so
- * callers can `if (rule) systemPrompt += rule` without a length check.
- */
-export function buildMentionRoutingRule(slugs, opts = {}) {
-    if (slugs.length === 0)
-        return null;
-    const toolName = opts.toolName ?? 'run_agent';
-    const argKey = opts.argKey ?? 'agentSlug';
-    if (slugs.length === 1) {
-        const slug = slugs[0];
-        return [
-            '## @-mention routing (HARD RULE)',
-            `The user explicitly invoked agent \`${slug}\` via @-mention. You MUST call \`${toolName}({ ${argKey}: "${slug}" })\` immediately with the user's request, regardless of how well the request matches that agent. Do not ask clarifying questions. Do not call other tools first. The mention has already been validated by the server.`,
-        ].join('\n');
-    }
-    const list = slugs.map((s) => `\`${s}\``).join(', ');
-    return [
-        '## @-mention routing (HARD RULE)',
-        `The user explicitly invoked these agents via @-mention, in order: ${list}. You MUST call \`${toolName}\` for each one in turn (passing its slug as \`${argKey}\`), passing the user's request as input. Do not ask clarifying questions between mentions. Do not call other tools first. The mentions have already been validated by the server.`,
-    ].join('\n');
-}
+// @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/chat-mentions' directly in new code.
+export * from '@gemstack/ai-sdk/chat-mentions';
 //# sourceMappingURL=chat-mentions.js.map

package/dist/chat-mentions.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat-mentions.js","sourceRoot":"","sources":["../src/chat-mentions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,aAAa,GAAG,mCAAmC,CAAA;AAShE;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,UAA4B;IACzE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;IAC/B,KAAK,MAAM,CAAC,IAAI,UAAU;QAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;IAEtD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,4EAA4E;IAC5E,kDAAkD;IAClD,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAA;IAEhE,MAAM,OAAO,GAAG,OAAO;SACpB,OAAO,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,IAAY,EAAE,IAAY,EAAE,EAAE;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QAChC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAA,CAAG,8BAA8B;QACnE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACnB,CAAC;QACD,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;IAC/B,CAAC,CAAC;SACD,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,IAAI,EAAE,CAAA;IAET,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;AAC3B,CAAC;AAeD;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAwB,EACxB,OAAmC,EAAE;IAErC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAEnC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,WAAW,CAAA;IAC7C,MAAM,MAAM,GAAK,IAAI,CAAC,MAAM,IAAM,WAAW,CAAA;IAE7C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAA;QACtB,OAAO;YACL,kCAAkC;YAClC,uCAAuC,IAAI,qCAAqC,QAAQ,MAAM,MAAM,MAAM,IAAI,0NAA0N;SACzU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACd,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpD,OAAO;QACL,kCAAkC;QAClC,qEAAqE,IAAI,qBAAqB,QAAQ,kDAAkD,MAAM,oLAAoL;KACnV,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}
+{"version":3,"file":"chat-mentions.js","sourceRoot":"","sources":["../src/chat-mentions.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,qEAAqE;AACrE,yDAAyD;AACzD,cAAc,gCAAgC,CAAA"}

package/dist/commands/ai-eval.d.ts

@@ -1,93 +1,2 @@
-/**
- * `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.
- *
- * 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 type { EvalSuite } from '../eval/index.js';
-type Rudder = {
-    command(name: string, handler: (args: string[]) => void | Promise<void>): {
-        description(text: string): unknown;
-    };
-};
-/** CLI flags + positional name filter. */
-export interface AiEvalOptions {
-    /** Substring filter (case-insensitive) applied to suite names. */
-    filter?: string;
-    /** Stop on the first failing suite. */
-    bail: boolean;
-    /** Emit `{ suites: [...] }` JSON to stdout. */
-    json: boolean;
-    /**
-     * Run against the real provider, capture each case's assistant
-     * turns to `evals/__fixtures__/<suite>/<case>.json`. Existing
-     * fixtures are overwritten — diff in your VCS to see what changed.
-     * Default `false`.
-     */
-    record?: boolean;
-    /**
-     * Swap the runtime with `AiFake.fake()` and feed each case its
-     * recorded fixture via `respondWithSequence`. Zero API calls,
-     * deterministic regression tests. Cases without a fixture fall
-     * through to a normal run with a stderr warning. Default `false`.
-     */
-    replay?: boolean;
-    /**
-     * Path for a self-contained HTML report (#A5 Phase 5). Pasteable
-     * into PR comments / Slack threads. Coexists with `--json` (JSON
-     * still goes to stdout, HTML goes to disk).
-     */
-    html?: string;
-}
-/**
- * Test seam — every external dependency gets an injectable
- * override. The CLI handler defaults each to its real impl.
- */
-export interface AiEvalDeps {
-    cwd?: string;
-    stdout?: {
-        write(s: string): boolean | void;
-    };
-    stderr?: {
-        write(s: string): boolean | void;
-    };
-    /** Override the file walk (test harness returns a virtual list). */
-    discover?: (cwd: string, pattern: string) => Promise<string[]>;
-    /** Override file → suite loader (test harness uses an in-memory map). */
-    loadSuite?: (absPath: string) => Promise<EvalSuite | null>;
-    /** Override config lookup (test harness skips `@rudderjs/core`). */
-    configPattern?: () => string | null | Promise<string | null>;
-    /**
-     * Override fixtures directory (defaults to `<cwd>/evals/__fixtures__`).
-     * Tests point to a tmpdir to keep round-trips off the source tree.
-     */
-    fixturesDir?: string;
-}
-/** Register the `ai:eval` command on the rudder runner. */
-export declare function registerAiEvalCommand(rudder: Rudder): void;
-/**
- * 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 declare function parseArgs(args: string[]): AiEvalOptions;
-/**
- * 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 declare function runEvalCli(opts: AiEvalOptions, deps?: AiEvalDeps): Promise<number>;
-/**
- * Recursive walk constrained to a `<dir>/**\/*<suffix>` shape.
- * Returns absolute paths sorted lexicographically for stable test
- * output and predictable `--bail` ordering.
- */
-export declare function discoverSuiteFiles(cwd: string, pattern: string): Promise<string[]>;
-export {};
+export * from '@gemstack/ai-sdk/commands/ai-eval';
 //# sourceMappingURL=ai-eval.d.ts.map

package/dist/commands/ai-eval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-eval.d.ts","sourceRoot":"","sources":["../../src/commands/ai-eval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAiC,MAAM,kBAAkB,CAAA;AAUhF,KAAK,MAAM,GAAG;IACZ,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAChD;QAAE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;CAC1C,CAAA;AAED,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uCAAuC;IACvC,IAAI,EAAK,OAAO,CAAA;IAChB,+CAA+C;IAC/C,IAAI,EAAK,OAAO,CAAA;IAChB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAS,MAAM,CAAA;IACnB,MAAM,CAAC,EAAM;QAAE,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;KAAE,CAAA;IACjD,MAAM,CAAC,EAAM;QAAE,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;KAAE,CAAA;IACjD,oEAAoE;IACpE,QAAQ,CAAC,EAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAChE,yEAAyE;IACzE,SAAS,CAAC,EAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IAC3D,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAC5D;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAO1D;AAMD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CA8BvD;AAID;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAsE5F;AA4JD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAMxF"}
+{"version":3,"file":"ai-eval.d.ts","sourceRoot":"","sources":["../../src/commands/ai-eval.ts"],"names":[],"mappings":"AAGA,cAAc,mCAAmC,CAAA"}