@x12i/ai-tools 1.0.2 → 1.0.3

package/README.md

@@ -61,7 +61,117 @@ npx ai-tools models list --reasoning
 npx ai-tools models count --reasoning
 ```
 
-Re-run `npm run seed` or `npx ai-tools sync` after upgrading so existing Firestore rows get `supportsReasoning` indexed.
+Re-run [Updating the model catalog](#updating-the-model-catalog) after upgrading `@x12i/ai-tools` so existing Firestore rows pick up new fields (e.g. `supportsReasoning`).
+
+## Updating the model catalog
+
+The **ai-models** catalog in Catalox/Firestore is a mirror of the [OpenRouter Models API](https://openrouter.ai/docs/api-reference/models). OpenRouter’s public `/models` endpoint needs **no API key**; optional `OPENROUTER_API_KEY` only helps with rate limits.
+
+### Prerequisites
+
+Add to `.env` (see [Environment variables](#environment-variables)):
+
+| Variable | Required for sync |
+|----------|-------------------|
+| `GOOGLE_SERVICE_ACCOUNT_BASE64` | Yes |
+| `FIREBASE_PROJECT_ID` | Yes |
+| `FIRESTORE_DATABASE_ID` | No (defaults to `(default)`) |
+| `AI_TOOLS_APP_ID` | No (default: `ai-tools`) |
+| `AI_TOOLS_CATALOG_ID` | No (default: `ai-models`) |
+
+First time only, register the catalog descriptor and app binding:
+
+```bash
+npx ai-tools catalog ensure
+```
+
+### When to run an update
+
+| Situation | What to run |
+|-----------|-------------|
+| **First deploy** | `npx ai-tools catalog ensure` then `npx ai-tools sync` |
+| **Routine refresh** (new models/pricing on OpenRouter) | `npx ai-tools sync` |
+| **After upgrading `@x12i/ai-tools`** (new indexed fields) | `npx ai-tools sync` |
+| **Health check only** (no writes) | `npx ai-tools catalog verify` |
+| **Remove models OpenRouter dropped** | `npx ai-tools sync --prune-stale` |
+
+### Recommended commands
+
+**Full update (production default)** — fetch OpenRouter, upsert every model, then verify counts match:
+
+```bash
+npx ai-tools sync
+```
+
+Same job via npm script:
+
+```bash
+npm run seed
+npm run seed:verbose   # progress lines
+```
+
+**CI / cron** — JSON on stdout, non-zero exit if sync or verify fails:
+
+```bash
+npx ai-tools sync --json
+# or
+npm run verify:seed
+```
+
+**Verify only** (read-only; good between scheduled syncs):
+
+```bash
+npx ai-tools catalog verify
+npx ai-tools catalog verify --json
+# or
+npm run verify:sync
+```
+
+**Dry run** (fetch OpenRouter, no Firestore writes):
+
+```bash
+npx ai-tools sync --dry-run
+```
+
+| npm script | Equivalent |
+|------------|------------|
+| `npm run seed` | `npx ai-tools sync` |
+| `npm run seed:verbose` | `npx ai-tools sync --verbose` |
+| `npm run verify:seed` | `npx ai-tools sync` (via seed script, sync + verify) |
+| `npm run verify:sync` | `npx ai-tools catalog verify` |
+
+### What `sync` does
+
+1. Ensures catalog + descriptor exist (`catalog ensure` logic).
+2. Fetches all models from OpenRouter (`output_modalities=all`).
+3. Upserts each row into Firestore/Catalox (`data` + `indexed` fields).
+4. Verifies Catalox count equals OpenRouter count (unless `--no-verify`).
+
+On re-sync, existing rows are **updated** (`syncedAt`, pricing, metadata); `createdAt` is preserved and `version` increments.
+
+### Cron example
+
+```bash
+# Daily at 04:00 — fail the job if sync or verify fails
+0 4 * * * cd /path/to/app && npx ai-tools sync --json >> /var/log/ai-tools-sync.log 2>&1
+```
+
+### Programmatic update
+
+```ts
+import { createCataloxFromEnv } from "@x12i/catalox/firebase";
+import { runAiModelsCatalogSync, verifyAiModelsCatalog } from "@x12i/ai-tools/catalog";
+
+const { catalox, firestore } = createCataloxFromEnv();
+
+// Sync + verify (throws CatalogSyncJobError on failure)
+const job = await runAiModelsCatalogSync({ catalox, firestore, verifyAfter: true });
+console.log(job.sync.upserted, job.verify?.ok);
+
+// Verify only
+const report = await verifyAiModelsCatalog({ catalox });
+if (!report.ok) throw new Error(`catalog drift: missing=${report.missingInCatalox.length}`);
+```
 
 ## Smart model name resolution
 
@@ -139,15 +249,6 @@ npx ai-tools models resolve --model claude-sonnet --verbose
 npx ai-tools models resolve --model turbomax-9000 --json
 ```
 
-## Seed catalog (Firestore + OpenRouter)
-
-```bash
-# Requires .env: GOOGLE_SERVICE_ACCOUNT_BASE64, FIREBASE_PROJECT_ID
-# OpenRouter /models is public — no API key required
-npm run seed
-npm run seed:verbose
-```
-
 ## Tests
 
 ```bash
@@ -158,9 +259,9 @@ npm run test:all      # both
 
 ## CLI
 
+Catalog update commands are documented in [Updating the model catalog](#updating-the-model-catalog). Other commands:
+
 ```bash
-npx ai-tools catalog ensure
-npx ai-tools sync --verbose
 npx ai-tools models list --provider openai
 npx ai-tools models list --reasoning
 npx ai-tools models resolve --model gpt4o --provider openrouter --verbose
@@ -194,6 +295,7 @@ npx ai-tools alias check
 - `@x12i/ai-tools/catalox`
 - `@x12i/ai-tools/aliases`
 - `@x12i/ai-tools/models`
+- `@x12i/ai-tools/catalog` — `runAiModelsCatalogSync`, `verifyAiModelsCatalog`, bootstrap
 
 ## Project aliases
 

package/dist/{AiModelsCatalogClient-CSVlKql5.d.cts → AiModelsCatalogClient-CNeqFiFs.d.cts}

@@ -1,5 +1,6 @@
 import { Catalox } from '@x12i/catalox';
-import { l as ModelResolverOptions, a as AiModelRecord, h as ModelResolutionInput, j as ModelResolutionResult } from './types-DdGB3YaA.cjs';
+import { a as AiModelRecord } from './types-BYXnCvKx.cjs';
+import { h as ModelResolverOptions, M as ModelResolutionInput, f as ModelResolutionResult } from './types-CX6QFNNy.cjs';
 
 type AiModelsCatalogClientOptions = {
     catalox: Catalox;

package/dist/{AiModelsCatalogClient-B-dNLXX0.d.ts → AiModelsCatalogClient-nwFoEaqL.d.ts}

@@ -1,5 +1,6 @@
 import { Catalox } from '@x12i/catalox';
-import { l as ModelResolverOptions, a as AiModelRecord, h as ModelResolutionInput, j as ModelResolutionResult } from './types-DdGB3YaA.js';
+import { a as AiModelRecord } from './types-BYXnCvKx.js';
+import { h as ModelResolverOptions, M as ModelResolutionInput, f as ModelResolutionResult } from './types-CuiPDcVs.js';
 
 type AiModelsCatalogClientOptions = {
     catalox: Catalox;

package/dist/aliases/index.d.cts

@@ -1,6 +1,7 @@
-import { d as AliasRegistry, u as ResolvedModelRef, f as AliasValidationReport } from '../types-DdGB3YaA.cjs';
-export { b as AliasEntry, c as AliasFileSchema, e as AliasRegistryOptions } from '../types-DdGB3YaA.cjs';
-import { A as AiModelsCatalogClient } from '../AiModelsCatalogClient-CSVlKql5.cjs';
+import { b as AliasRegistry, j as ResolvedModelRef, d as AliasValidationReport } from '../types-CX6QFNNy.cjs';
+export { A as AliasEntry, a as AliasFileSchema, c as AliasRegistryOptions } from '../types-CX6QFNNy.cjs';
+import { A as AiModelsCatalogClient } from '../AiModelsCatalogClient-CNeqFiFs.cjs';
+import '../types-BYXnCvKx.cjs';
 import '@x12i/catalox';
 
 type AliasResolverOptions = {

package/dist/aliases/index.d.ts

@@ -1,6 +1,7 @@
-import { d as AliasRegistry, u as ResolvedModelRef, f as AliasValidationReport } from '../types-DdGB3YaA.js';
-export { b as AliasEntry, c as AliasFileSchema, e as AliasRegistryOptions } from '../types-DdGB3YaA.js';
-import { A as AiModelsCatalogClient } from '../AiModelsCatalogClient-B-dNLXX0.js';
+import { b as AliasRegistry, j as ResolvedModelRef, d as AliasValidationReport } from '../types-CuiPDcVs.js';
+export { A as AliasEntry, a as AliasFileSchema, c as AliasRegistryOptions } from '../types-CuiPDcVs.js';
+import { A as AiModelsCatalogClient } from '../AiModelsCatalogClient-nwFoEaqL.js';
+import '../types-BYXnCvKx.js';
 import '@x12i/catalox';
 
 type AliasResolverOptions = {

package/dist/catalog/index.cjs

@@ -0,0 +1,30 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('../chunk-C3H7RTFR.cjs');
+
+
+
+
+
+var _chunkHS74X2OJcjs = require('../chunk-HS74X2OJ.cjs');
+
+
+var _chunkDKHGWHXPcjs = require('../chunk-DKHGWHXP.cjs');
+require('../chunk-FGP3QXWL.cjs');
+require('../chunk-AV6OE2YQ.cjs');
+require('../chunk-F2F4UEFD.cjs');
+
+
+
+
+var _chunkTF4L2NECcjs = require('../chunk-TF4L2NEC.cjs');
+require('../chunk-7Q742NI3.cjs');
+
+
+
+
+
+
+
+
+
+exports.AI_MODELS_CATALOG_ID = _chunkTF4L2NECcjs.AI_MODELS_CATALOG_ID; exports.AI_MODELS_DESCRIPTOR = _chunkTF4L2NECcjs.AI_MODELS_DESCRIPTOR; exports.AI_TOOLS_APP_ID = _chunkTF4L2NECcjs.AI_TOOLS_APP_ID; exports.CatalogSyncJobError = _chunkHS74X2OJcjs.CatalogSyncJobError; exports.ensureAiModelsCatalog = _chunkDKHGWHXPcjs.ensureAiModelsCatalog; exports.pruneStaleCatalogModels = _chunkHS74X2OJcjs.pruneStaleCatalogModels; exports.runAiModelsCatalogSync = _chunkHS74X2OJcjs.runAiModelsCatalogSync; exports.verifyAiModelsCatalog = _chunkHS74X2OJcjs.verifyAiModelsCatalog;
+//# sourceMappingURL=index.cjs.map

package/dist/catalog/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/ami/Documents/prometheus/x12i/ai-tools/dist/catalog/index.cjs"],"names":[],"mappings":"AAAA,0GAA8B;AAC9B;AACE;AACA;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yjBAAC","file":"/Users/ami/Documents/prometheus/x12i/ai-tools/dist/catalog/index.cjs"}

package/dist/catalog/index.d.cts

@@ -0,0 +1,100 @@
+import { Catalox, CatalogDescriptor, CataloxContext } from '@x12i/catalox';
+import { a as AiModelRecord, d as OpenRouterModelsQuery } from '../types-BYXnCvKx.cjs';
+import { a as SyncResult, S as SyncOptions } from '../syncAiModelsCatalog-CnXRLm2c.cjs';
+import { Firestore } from 'firebase-admin/firestore';
+import '../upsertAiModelRecord-CjY-sny0.cjs';
+
+type EnsureAiModelsCatalogOptions = {
+    appId?: string;
+    catalogId?: string;
+};
+declare function ensureAiModelsCatalog(catalox: Catalox, options?: EnsureAiModelsCatalogOptions): Promise<void>;
+
+declare const AI_MODELS_CATALOG_ID = "ai-models";
+declare const AI_TOOLS_APP_ID = "ai-tools";
+declare const AI_MODELS_DESCRIPTOR: CatalogDescriptor;
+
+type CatalogVerifyOptions = {
+    catalox: Catalox;
+    appId?: string;
+    catalogId?: string;
+    /** When set, compare against this id set (e.g. from a sync that just ran). */
+    expectedModelIds?: Set<string>;
+    /** When set, compare against this list instead of fetching OpenRouter. */
+    openRouterModels?: AiModelRecord[];
+    openRouterApiKey?: string;
+    openRouterQuery?: OpenRouterModelsQuery;
+    /** Ensure descriptor is registered before reading (default true). */
+    ensureDescriptor?: boolean;
+    /** Max model ids to include in report samples (default 20). */
+    sampleLimit?: number;
+};
+type CatalogVerifyReport = {
+    ok: boolean;
+    openRouterCount: number;
+    cataloxCount: number;
+    missingInCatalox: string[];
+    extraInCatalox: string[];
+    supportsReasoningMissing: number;
+    openRouterMirrorMissing: number;
+    descriptorKeysMatch: boolean;
+    durationMs: number;
+};
+/**
+ * Compare the live OpenRouter catalog with Catalox/Firestore ai-models items.
+ * Use after sync in CI/cron, or standalone health checks.
+ */
+declare function verifyAiModelsCatalog(options: CatalogVerifyOptions): Promise<CatalogVerifyReport>;
+
+type CatalogSyncJobOptions = SyncOptions & {
+    /**
+     * After upsert, compare Catalox to OpenRouter (default true).
+     * Set false only when you will verify separately.
+     */
+    verifyAfter?: boolean;
+    /** Fail the job when verification does not pass (default true). */
+    failOnVerifyError?: boolean;
+    /** Delete Firestore rows not present in the latest OpenRouter list (default false). */
+    pruneStale?: boolean;
+};
+type CatalogSyncJobResult = {
+    sync: SyncResult;
+    verify?: CatalogVerifyReport;
+    prune?: {
+        scanned: number;
+        pruned: number;
+        prunedModelIds: string[];
+    };
+    ok: boolean;
+};
+declare class CatalogSyncJobError extends Error {
+    readonly sync: SyncResult;
+    readonly verify?: CatalogVerifyReport | undefined;
+    constructor(message: string, sync: SyncResult, verify?: CatalogVerifyReport | undefined);
+}
+/**
+ * Production entry point: sync OpenRouter → Catalox, optionally prune stale rows, then verify.
+ * Suitable for cron, Cloud Run jobs, and `ai-tools sync`.
+ */
+declare function runAiModelsCatalogSync(options: CatalogSyncJobOptions): Promise<CatalogSyncJobResult>;
+
+type PruneStaleCatalogModelsOptions = {
+    firestore: Firestore;
+    catalogId: string;
+    context: CataloxContext;
+    /** Canonical model ids from the latest OpenRouter fetch. */
+    activeModelIds: Set<string>;
+    dryRun?: boolean;
+};
+type PruneStaleCatalogModelsResult = {
+    scanned: number;
+    pruned: number;
+    prunedModelIds: string[];
+};
+/**
+ * Remove catalog documents that are no longer listed on OpenRouter.
+ * Off by default — enable explicitly when running production sync jobs.
+ */
+declare function pruneStaleCatalogModels(options: PruneStaleCatalogModelsOptions): Promise<PruneStaleCatalogModelsResult>;
+
+export { AI_MODELS_CATALOG_ID, AI_MODELS_DESCRIPTOR, AI_TOOLS_APP_ID, CatalogSyncJobError, type CatalogSyncJobOptions, type CatalogSyncJobResult, type CatalogVerifyOptions, type CatalogVerifyReport, type EnsureAiModelsCatalogOptions, type PruneStaleCatalogModelsOptions, type PruneStaleCatalogModelsResult, ensureAiModelsCatalog, pruneStaleCatalogModels, runAiModelsCatalogSync, verifyAiModelsCatalog };

package/dist/catalog/index.d.ts

@@ -0,0 +1,100 @@
+import { Catalox, CatalogDescriptor, CataloxContext } from '@x12i/catalox';
+import { a as AiModelRecord, d as OpenRouterModelsQuery } from '../types-BYXnCvKx.js';
+import { a as SyncResult, S as SyncOptions } from '../syncAiModelsCatalog-DpkN_w7S.js';
+import { Firestore } from 'firebase-admin/firestore';
+import '../upsertAiModelRecord-C831wOIF.js';
+
+type EnsureAiModelsCatalogOptions = {
+    appId?: string;
+    catalogId?: string;
+};
+declare function ensureAiModelsCatalog(catalox: Catalox, options?: EnsureAiModelsCatalogOptions): Promise<void>;
+
+declare const AI_MODELS_CATALOG_ID = "ai-models";
+declare const AI_TOOLS_APP_ID = "ai-tools";
+declare const AI_MODELS_DESCRIPTOR: CatalogDescriptor;
+
+type CatalogVerifyOptions = {
+    catalox: Catalox;
+    appId?: string;
+    catalogId?: string;
+    /** When set, compare against this id set (e.g. from a sync that just ran). */
+    expectedModelIds?: Set<string>;
+    /** When set, compare against this list instead of fetching OpenRouter. */
+    openRouterModels?: AiModelRecord[];
+    openRouterApiKey?: string;
+    openRouterQuery?: OpenRouterModelsQuery;
+    /** Ensure descriptor is registered before reading (default true). */
+    ensureDescriptor?: boolean;
+    /** Max model ids to include in report samples (default 20). */
+    sampleLimit?: number;
+};
+type CatalogVerifyReport = {
+    ok: boolean;
+    openRouterCount: number;
+    cataloxCount: number;
+    missingInCatalox: string[];
+    extraInCatalox: string[];
+    supportsReasoningMissing: number;
+    openRouterMirrorMissing: number;
+    descriptorKeysMatch: boolean;
+    durationMs: number;
+};
+/**
+ * Compare the live OpenRouter catalog with Catalox/Firestore ai-models items.
+ * Use after sync in CI/cron, or standalone health checks.
+ */
+declare function verifyAiModelsCatalog(options: CatalogVerifyOptions): Promise<CatalogVerifyReport>;
+
+type CatalogSyncJobOptions = SyncOptions & {
+    /**
+     * After upsert, compare Catalox to OpenRouter (default true).
+     * Set false only when you will verify separately.
+     */
+    verifyAfter?: boolean;
+    /** Fail the job when verification does not pass (default true). */
+    failOnVerifyError?: boolean;
+    /** Delete Firestore rows not present in the latest OpenRouter list (default false). */
+    pruneStale?: boolean;
+};
+type CatalogSyncJobResult = {
+    sync: SyncResult;
+    verify?: CatalogVerifyReport;
+    prune?: {
+        scanned: number;
+        pruned: number;
+        prunedModelIds: string[];
+    };
+    ok: boolean;
+};
+declare class CatalogSyncJobError extends Error {
+    readonly sync: SyncResult;
+    readonly verify?: CatalogVerifyReport | undefined;
+    constructor(message: string, sync: SyncResult, verify?: CatalogVerifyReport | undefined);
+}
+/**
+ * Production entry point: sync OpenRouter → Catalox, optionally prune stale rows, then verify.
+ * Suitable for cron, Cloud Run jobs, and `ai-tools sync`.
+ */
+declare function runAiModelsCatalogSync(options: CatalogSyncJobOptions): Promise<CatalogSyncJobResult>;
+
+type PruneStaleCatalogModelsOptions = {
+    firestore: Firestore;
+    catalogId: string;
+    context: CataloxContext;
+    /** Canonical model ids from the latest OpenRouter fetch. */
+    activeModelIds: Set<string>;
+    dryRun?: boolean;
+};
+type PruneStaleCatalogModelsResult = {
+    scanned: number;
+    pruned: number;
+    prunedModelIds: string[];
+};
+/**
+ * Remove catalog documents that are no longer listed on OpenRouter.
+ * Off by default — enable explicitly when running production sync jobs.
+ */
+declare function pruneStaleCatalogModels(options: PruneStaleCatalogModelsOptions): Promise<PruneStaleCatalogModelsResult>;
+
+export { AI_MODELS_CATALOG_ID, AI_MODELS_DESCRIPTOR, AI_TOOLS_APP_ID, CatalogSyncJobError, type CatalogSyncJobOptions, type CatalogSyncJobResult, type CatalogVerifyOptions, type CatalogVerifyReport, type EnsureAiModelsCatalogOptions, type PruneStaleCatalogModelsOptions, type PruneStaleCatalogModelsResult, ensureAiModelsCatalog, pruneStaleCatalogModels, runAiModelsCatalogSync, verifyAiModelsCatalog };

package/dist/catalog/index.js

@@ -0,0 +1,30 @@
+import "../chunk-M5TMA73F.js";
+import {
+  CatalogSyncJobError,
+  pruneStaleCatalogModels,
+  runAiModelsCatalogSync,
+  verifyAiModelsCatalog
+} from "../chunk-MX3AMQFC.js";
+import {
+  ensureAiModelsCatalog
+} from "../chunk-VRFVF5RH.js";
+import "../chunk-HYGXZY25.js";
+import "../chunk-6QGDZTGH.js";
+import "../chunk-KQOALKKX.js";
+import {
+  AI_MODELS_CATALOG_ID,
+  AI_MODELS_DESCRIPTOR,
+  AI_TOOLS_APP_ID
+} from "../chunk-DJ5SWJDY.js";
+import "../chunk-AJEKEWWB.js";
+export {
+  AI_MODELS_CATALOG_ID,
+  AI_MODELS_DESCRIPTOR,
+  AI_TOOLS_APP_ID,
+  CatalogSyncJobError,
+  ensureAiModelsCatalog,
+  pruneStaleCatalogModels,
+  runAiModelsCatalogSync,
+  verifyAiModelsCatalog
+};
+//# sourceMappingURL=index.js.map

package/dist/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/catalox/index.cjs

@@ -4,7 +4,7 @@
 
 
 
-var _chunkHHNHWYTPcjs = require('../chunk-HHNHWYTP.cjs');
+var _chunkFGP3QXWLcjs = require('../chunk-FGP3QXWL.cjs');
 
 
 var _chunkF2F4UEFDcjs = require('../chunk-F2F4UEFD.cjs');
@@ -17,5 +17,5 @@ require('../chunk-7Q742NI3.cjs');
 
 
 
-exports.AiModelsCatalogClient = _chunkF2F4UEFDcjs.AiModelsCatalogClient; exports.batchUpsertAiModelRecords = _chunkHHNHWYTPcjs.batchUpsertAiModelRecords; exports.decodeModelFirestoreDocId = _chunkHHNHWYTPcjs.decodeModelFirestoreDocId; exports.encodeModelFirestoreDocId = _chunkHHNHWYTPcjs.encodeModelFirestoreDocId; exports.sanitizeForFirestore = _chunkHHNHWYTPcjs.sanitizeForFirestore; exports.upsertAiModelRecord = _chunkHHNHWYTPcjs.upsertAiModelRecord;
+exports.AiModelsCatalogClient = _chunkF2F4UEFDcjs.AiModelsCatalogClient; exports.batchUpsertAiModelRecords = _chunkFGP3QXWLcjs.batchUpsertAiModelRecords; exports.decodeModelFirestoreDocId = _chunkFGP3QXWLcjs.decodeModelFirestoreDocId; exports.encodeModelFirestoreDocId = _chunkFGP3QXWLcjs.encodeModelFirestoreDocId; exports.sanitizeForFirestore = _chunkFGP3QXWLcjs.sanitizeForFirestore; exports.upsertAiModelRecord = _chunkFGP3QXWLcjs.upsertAiModelRecord;
 //# sourceMappingURL=index.cjs.map

package/dist/catalox/index.d.cts

@@ -1,23 +1,11 @@
-export { A as AiModelsCatalogClient, a as AiModelsCatalogClientOptions } from '../AiModelsCatalogClient-CSVlKql5.cjs';
-import { Firestore } from 'firebase-admin/firestore';
-import { CataloxContext } from '@x12i/catalox';
-import { a as AiModelRecord } from '../types-DdGB3YaA.cjs';
+export { A as AiModelsCatalogClient, a as AiModelsCatalogClientOptions } from '../AiModelsCatalogClient-CNeqFiFs.cjs';
+export { b as batchUpsertAiModelRecords, s as sanitizeForFirestore, u as upsertAiModelRecord } from '../upsertAiModelRecord-CjY-sny0.cjs';
+import '@x12i/catalox';
+import '../types-BYXnCvKx.cjs';
+import '../types-CX6QFNNy.cjs';
+import 'firebase-admin/firestore';
 
 declare function encodeModelFirestoreDocId(modelId: string): string;
 declare function decodeModelFirestoreDocId(docId: string): string;
 
-/** Firestore rejects `undefined` — strip before write. */
-declare function sanitizeForFirestore<T>(value: T): T;
-type UpsertAiModelRecordOptions = {
-    firestore: Firestore;
-    context: CataloxContext;
-    catalogId: string;
-    record: AiModelRecord;
-};
-/**
- * Upserts one ai-models row via Firestore (safe doc ids for `provider/model` ids).
- */
-declare function upsertAiModelRecord(options: UpsertAiModelRecordOptions): Promise<void>;
-declare function batchUpsertAiModelRecords(firestore: Firestore, catalogId: string, context: CataloxContext, records: AiModelRecord[]): Promise<void>;
-
-export { batchUpsertAiModelRecords, decodeModelFirestoreDocId, encodeModelFirestoreDocId, sanitizeForFirestore, upsertAiModelRecord };
+export { decodeModelFirestoreDocId, encodeModelFirestoreDocId };

package/dist/catalox/index.d.ts

@@ -1,23 +1,11 @@
-export { A as AiModelsCatalogClient, a as AiModelsCatalogClientOptions } from '../AiModelsCatalogClient-B-dNLXX0.js';
-import { Firestore } from 'firebase-admin/firestore';
-import { CataloxContext } from '@x12i/catalox';
-import { a as AiModelRecord } from '../types-DdGB3YaA.js';
+export { A as AiModelsCatalogClient, a as AiModelsCatalogClientOptions } from '../AiModelsCatalogClient-nwFoEaqL.js';
+export { b as batchUpsertAiModelRecords, s as sanitizeForFirestore, u as upsertAiModelRecord } from '../upsertAiModelRecord-C831wOIF.js';
+import '@x12i/catalox';
+import '../types-BYXnCvKx.js';
+import '../types-CuiPDcVs.js';
+import 'firebase-admin/firestore';
 
 declare function encodeModelFirestoreDocId(modelId: string): string;
 declare function decodeModelFirestoreDocId(docId: string): string;
 
-/** Firestore rejects `undefined` — strip before write. */
-declare function sanitizeForFirestore<T>(value: T): T;
-type UpsertAiModelRecordOptions = {
-    firestore: Firestore;
-    context: CataloxContext;
-    catalogId: string;
-    record: AiModelRecord;
-};
-/**
- * Upserts one ai-models row via Firestore (safe doc ids for `provider/model` ids).
- */
-declare function upsertAiModelRecord(options: UpsertAiModelRecordOptions): Promise<void>;
-declare function batchUpsertAiModelRecords(firestore: Firestore, catalogId: string, context: CataloxContext, records: AiModelRecord[]): Promise<void>;
-
-export { batchUpsertAiModelRecords, decodeModelFirestoreDocId, encodeModelFirestoreDocId, sanitizeForFirestore, upsertAiModelRecord };
+export { decodeModelFirestoreDocId, encodeModelFirestoreDocId };

package/dist/catalox/index.js

@@ -4,7 +4,7 @@ import {
   encodeModelFirestoreDocId,
   sanitizeForFirestore,
   upsertAiModelRecord
-} from "../chunk-ML2FRR4L.js";
+} from "../chunk-HYGXZY25.js";
 import {
   AiModelsCatalogClient
 } from "../chunk-KQOALKKX.js";

package/dist/chunk-C3H7RTFR.cjs

@@ -0,0 +1 @@
+"use strict";//# sourceMappingURL=chunk-C3H7RTFR.cjs.map

package/dist/chunk-C3H7RTFR.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/ami/Documents/prometheus/x12i/ai-tools/dist/chunk-C3H7RTFR.cjs"],"names":[],"mappings":"AAAA","file":"/Users/ami/Documents/prometheus/x12i/ai-tools/dist/chunk-C3H7RTFR.cjs"}

package/dist/{chunk-ONA73BU6.cjs → chunk-DKHGWHXP.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkHHNHWYTPcjs = require('./chunk-HHNHWYTP.cjs');
+var _chunkFGP3QXWLcjs = require('./chunk-FGP3QXWL.cjs');
 
 
 var _chunkAV6OE2YQcjs = require('./chunk-AV6OE2YQ.cjs');
@@ -126,28 +126,37 @@ async function syncAiModelsCatalog(options) {
   if (options.verbose) {
     console.log(`[sync] fetched ${models.length} models from ${provider.getModelsUrl()}`);
   }
+  const syncedModelIds = models.map((m) => m.modelId);
   if (options.dryRun) {
     return {
       fetched: models.length,
       upserted: 0,
       skipped: models.length,
       errors: [],
+      syncedModelIds,
       durationMs: Date.now() - start
     };
   }
-  const errors = [];
-  try {
-    await _chunkHHNHWYTPcjs.batchUpsertAiModelRecords.call(void 0, options.firestore, catalogId, ctx, models);
-  } catch (cause) {
-    const message = cause instanceof Error ? cause.message : String(cause);
-    throw new (0, _chunk7Q742NI3cjs.SyncError)("SYNC_UPSERT_FAILED", `Batch upsert failed: ${message}`, cause);
-  }
+  const upsert = await _chunkFGP3QXWLcjs.batchUpsertAiModelRecords.call(void 0, 
+    options.firestore,
+    catalogId,
+    ctx,
+    models,
+    { onProgress: options.onProgress }
+  );
   _chunkTF4L2NECcjs.invalidateModelsCache.call(void 0, appId);
+  if (upsert.failed.length > 0 && upsert.upserted === 0) {
+    throw new (0, _chunk7Q742NI3cjs.SyncError)(
+      "SYNC_UPSERT_FAILED",
+      `All ${upsert.failed.length} model upserts failed. First error: ${upsert.failed[0].error}`
+    );
+  }
   return {
     fetched: models.length,
-    upserted: models.length,
-    skipped: 0,
-    errors,
+    upserted: upsert.upserted,
+    skipped: models.length - upsert.upserted,
+    errors: upsert.failed,
+    syncedModelIds,
     durationMs: Date.now() - start
   };
 }
@@ -157,4 +166,4 @@ async function syncAiModelsCatalog(options) {
 
 
 exports.ensureAiModelsCatalog = ensureAiModelsCatalog; exports.OpenRouterSyncProvider = OpenRouterSyncProvider; exports.syncAiModelsCatalog = syncAiModelsCatalog;
-//# sourceMappingURL=chunk-ONA73BU6.cjs.map
+//# sourceMappingURL=chunk-DKHGWHXP.cjs.map

package/dist/chunk-DKHGWHXP.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/ami/Documents/prometheus/x12i/ai-tools/dist/chunk-DKHGWHXP.cjs","../src/catalog/ensureAiModelsCatalog.ts","../src/sync/OpenRouterSyncProvider.ts","../src/sync/syncAiModelsCatalog.ts"],"names":[],"mappings":"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","file":"/Users/ami/Documents/prometheus/x12i/ai-tools/dist/chunk-DKHGWHXP.cjs","sourcesContent":[null,"import type { Catalox, CataloxContext } from \"@x12i/catalox\";\nimport { AiToolsError } from \"../errors.js\";\nimport {\n  AI_MODELS_CATALOG_ID,\n  AI_MODELS_DESCRIPTOR,\n  AI_TOOLS_APP_ID,\n} from \"./aiModelsCatalogDescriptor.js\";\n\nexport type EnsureAiModelsCatalogOptions = {\n  appId?: string;\n  catalogId?: string;\n};\n\nexport async function ensureAiModelsCatalog(\n  catalox: Catalox,\n  options: EnsureAiModelsCatalogOptions = {},\n): Promise<void> {\n  const appId = options.appId ?? AI_TOOLS_APP_ID;\n  const catalogId = options.catalogId ?? AI_MODELS_CATALOG_ID;\n\n  const ctx: CataloxContext = { appId, superAdmin: true };\n\n  try {\n    await catalox.ensureCatalog(ctx, {\n      catalogId,\n      name: AI_MODELS_DESCRIPTOR.label,\n      status: \"active\",\n    });\n\n    await catalox.bindCatalogToApp(ctx, {\n      appId,\n      catalogId,\n      access: { canRead: true, canWrite: true, canAdmin: true },\n    });\n\n    await catalox.upsertCatalogDescriptor(ctx, catalogId, {\n      descriptorVersion: \"1.0.0\",\n      descriptor: AI_MODELS_DESCRIPTOR,\n    });\n  } catch (cause) {\n    throw new AiToolsError(\n      \"CATALOG_BOOTSTRAP_FAILED\",\n      `Failed to bootstrap catalog \"${catalogId}\" for app \"${appId}\".`,\n      cause,\n    );\n  }\n}\n","import { SyncError } from \"../errors.js\";\nimport { normalizeOpenRouterModel } from \"../models/normalizeOpenRouterModel.js\";\nimport type { AiModelRecord } from \"../models/types.js\";\nimport type {\n  OpenRouterModelsQuery,\n  OpenRouterModelsResponse,\n} from \"../models/openrouter.types.js\";\n\nexport type OpenRouterSyncProviderOptions = {\n  /** Optional — public GET /models needs no key. */\n  apiKey?: string;\n  baseUrl?: string;\n  /** Query params passed to OpenRouter (default: all modalities). */\n  query?: OpenRouterModelsQuery;\n};\n\nfunction buildFetchHeaders(apiKey?: string): Record<string, string> {\n  const headers: Record<string, string> = { Accept: \"application/json\" };\n  if (apiKey?.trim()) headers.Authorization = `Bearer ${apiKey.trim()}`;\n  return headers;\n}\n\nfunction buildModelsUrl(baseUrl: string, query?: OpenRouterModelsQuery): string {\n  const url = new URL(`${baseUrl.replace(/\\/$/, \"\")}/models`);\n  const q = { output_modalities: \"all\", ...query };\n  for (const [key, value] of Object.entries(q)) {\n    if (value !== undefined && value !== \"\") url.searchParams.set(key, value);\n  }\n  return url.toString();\n}\n\nexport class OpenRouterSyncProvider {\n  private readonly apiKey?: string;\n  private readonly baseUrl: string;\n  private readonly query?: OpenRouterModelsQuery;\n\n  constructor(options: OpenRouterSyncProviderOptions = {}) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl ?? \"https://openrouter.ai/api/v1\";\n    this.query = options.query ?? { output_modalities: \"all\" };\n  }\n\n  /**\n   * Fetches the full OpenRouter model catalog (public, no API key required).\n   * @see https://openrouter.ai/api/v1/models\n   */\n  async fetchModels(): Promise<AiModelRecord[]> {\n    const url = buildModelsUrl(this.baseUrl, this.query);\n    let response: Response;\n\n    try {\n      response = await fetch(url, { headers: buildFetchHeaders(this.apiKey) });\n    } catch (cause) {\n      throw new SyncError(\"OPENROUTER_MODELS_FETCH_FAILED\", `Failed to fetch OpenRouter models from ${url}`, cause);\n    }\n\n    if (response.status === 401 || response.status === 403) {\n      throw new SyncError(\n        \"OPENROUTER_AUTH_FAILED\",\n        this.apiKey\n          ? \"OpenRouter API key is invalid or unauthorized.\"\n          : \"OpenRouter returned unauthorized — remove OPENROUTER_API_KEY to use the public models endpoint.\",\n      );\n    }\n\n    if (!response.ok) {\n      const body = await response.text().catch(() => \"\");\n      throw new SyncError(\n        \"OPENROUTER_MODELS_FETCH_FAILED\",\n        `OpenRouter models fetch failed (${response.status}): ${body.slice(0, 200)}`,\n      );\n    }\n\n    const json = (await response.json()) as OpenRouterModelsResponse;\n    const syncedAt = new Date().toISOString();\n    return (json.data ?? []).map((row) => normalizeOpenRouterModel(row, syncedAt));\n  }\n\n  /** Build the URL used for the last fetch pattern (for debugging). */\n  getModelsUrl(): string {\n    return buildModelsUrl(this.baseUrl, this.query);\n  }\n}\n","import type { Catalox, CataloxContext } from \"@x12i/catalox\";\nimport type { Firestore } from \"firebase-admin/firestore\";\nimport { ensureAiModelsCatalog } from \"../catalog/ensureAiModelsCatalog.js\";\nimport { AI_MODELS_CATALOG_ID, AI_TOOLS_APP_ID } from \"../catalog/aiModelsCatalogDescriptor.js\";\nimport { invalidateModelsCache } from \"../cache/modelCache.js\";\nimport {\n  batchUpsertAiModelRecords,\n  type BatchUpsertProgress,\n} from \"../catalox/upsertAiModelRecord.js\";\nimport { SyncError } from \"../errors.js\";\nimport type { AiModelRecord } from \"../models/types.js\";\nimport type { OpenRouterModelsQuery } from \"../models/openrouter.types.js\";\nimport { OpenRouterSyncProvider } from \"./OpenRouterSyncProvider.js\";\n\nexport type SyncOptions = {\n  catalox: Catalox;\n  firestore: Firestore;\n  openRouterApiKey?: string;\n  openRouterQuery?: OpenRouterModelsQuery;\n  appId?: string;\n  catalogId?: string;\n  dryRun?: boolean;\n  verbose?: boolean;\n  forceCache?: boolean;\n  onProgress?: (progress: BatchUpsertProgress) => void;\n};\n\nexport type SyncResult = {\n  fetched: number;\n  upserted: number;\n  skipped: number;\n  errors: Array<{ modelId: string; error: string }>;\n  durationMs: number;\n  /** Model ids written (or that would be written on dry-run). */\n  syncedModelIds: string[];\n};\n\nexport async function syncAiModelsCatalog(options: SyncOptions): Promise<SyncResult> {\n  const start = Date.now();\n  const appId = options.appId ?? AI_TOOLS_APP_ID;\n  const catalogId = options.catalogId ?? AI_MODELS_CATALOG_ID;\n  const ctx: CataloxContext = { appId, superAdmin: true };\n\n  if (options.forceCache) {\n    invalidateModelsCache(appId);\n  }\n\n  await ensureAiModelsCatalog(options.catalox, { appId, catalogId });\n\n  const provider = new OpenRouterSyncProvider({\n    apiKey: options.openRouterApiKey,\n    query: options.openRouterQuery ?? { output_modalities: \"all\" },\n  });\n\n  let models: AiModelRecord[];\n  try {\n    models = await provider.fetchModels();\n  } catch (error) {\n    if (error instanceof SyncError) throw error;\n    throw new SyncError(\"SYNC_FETCH_FAILED\", \"Failed to fetch models from OpenRouter.\", error);\n  }\n\n  if (options.verbose) {\n    console.log(`[sync] fetched ${models.length} models from ${provider.getModelsUrl()}`);\n  }\n\n  const syncedModelIds = models.map((m) => m.modelId);\n\n  if (options.dryRun) {\n    return {\n      fetched: models.length,\n      upserted: 0,\n      skipped: models.length,\n      errors: [],\n      syncedModelIds,\n      durationMs: Date.now() - start,\n    };\n  }\n\n  const upsert = await batchUpsertAiModelRecords(\n    options.firestore,\n    catalogId,\n    ctx,\n    models,\n    { onProgress: options.onProgress },\n  );\n\n  invalidateModelsCache(appId);\n\n  if (upsert.failed.length > 0 && upsert.upserted === 0) {\n    throw new SyncError(\n      \"SYNC_UPSERT_FAILED\",\n      `All ${upsert.failed.length} model upserts failed. First error: ${upsert.failed[0]!.error}`,\n    );\n  }\n\n  return {\n    fetched: models.length,\n    upserted: upsert.upserted,\n    skipped: models.length - upsert.upserted,\n    errors: upsert.failed,\n    syncedModelIds,\n    durationMs: Date.now() - start,\n  };\n}\n"]}