@x12i/ai-tools 1.0.2 → 1.0.3

package/dist/chunk-MX3AMQFC.js

@@ -0,0 +1,172 @@
+import {
+  OpenRouterSyncProvider,
+  ensureAiModelsCatalog,
+  syncAiModelsCatalog
+} from "./chunk-VRFVF5RH.js";
+import {
+  decodeModelFirestoreDocId,
+  encodeModelFirestoreDocId
+} from "./chunk-HYGXZY25.js";
+import {
+  AiModelsCatalogClient
+} from "./chunk-KQOALKKX.js";
+import {
+  AI_MODELS_CATALOG_ID,
+  AI_MODELS_DESCRIPTOR,
+  AI_TOOLS_APP_ID,
+  invalidateModelsCache
+} from "./chunk-DJ5SWJDY.js";
+
+// src/catalog/verifyAiModelsCatalog.ts
+function sample(ids, limit) {
+  return ids.length <= limit ? ids : ids.slice(0, limit);
+}
+async function verifyAiModelsCatalog(options) {
+  const start = Date.now();
+  const appId = options.appId ?? AI_TOOLS_APP_ID;
+  const catalogId = options.catalogId ?? AI_MODELS_CATALOG_ID;
+  const sampleLimit = options.sampleLimit ?? 20;
+  if (options.ensureDescriptor !== false) {
+    await ensureAiModelsCatalog(options.catalox, { appId, catalogId });
+  }
+  const orIds = options.expectedModelIds ?? new Set(
+    (options.openRouterModels ?? await new OpenRouterSyncProvider({
+      apiKey: options.openRouterApiKey,
+      query: options.openRouterQuery ?? { output_modalities: "all" }
+    }).fetchModels()).map((m) => m.modelId)
+  );
+  invalidateModelsCache(appId);
+  const client = new AiModelsCatalogClient({ catalox: options.catalox, appId, catalogId });
+  const catMap = await client.getAllModels();
+  const catIds = new Set(catMap.keys());
+  const missingInCatalox = [...orIds].filter((id) => !catIds.has(id));
+  const extraInCatalox = [...catIds].filter((id) => !orIds.has(id));
+  let supportsReasoningMissing = 0;
+  let openRouterMirrorMissing = 0;
+  for (const m of catMap.values()) {
+    if (m.supportsReasoning === void 0) supportsReasoningMissing++;
+    if (!m.openRouter?.id) openRouterMirrorMissing++;
+  }
+  const descriptor = await options.catalox.getCatalogDescriptor(
+    { appId, superAdmin: true },
+    catalogId
+  );
+  const remoteKeys = descriptor?.queryableFields?.map((f) => f.key) ?? [];
+  const localKeys = AI_MODELS_DESCRIPTOR.queryableFields.map((f) => f.key);
+  const descriptorKeysMatch = remoteKeys.length === localKeys.length && remoteKeys.every((k, i) => k === localKeys[i]);
+  const ok = missingInCatalox.length === 0 && extraInCatalox.length === 0 && supportsReasoningMissing === 0 && openRouterMirrorMissing === 0 && descriptorKeysMatch;
+  return {
+    ok,
+    openRouterCount: orIds.size,
+    cataloxCount: catIds.size,
+    missingInCatalox: sample(missingInCatalox, sampleLimit),
+    extraInCatalox: sample(extraInCatalox, sampleLimit),
+    supportsReasoningMissing,
+    openRouterMirrorMissing,
+    descriptorKeysMatch,
+    durationMs: Date.now() - start
+  };
+}
+
+// src/catalog/pruneStaleCatalogModels.ts
+import {
+  flatNativeItemsCollectionRef,
+  legacyNativeItemsCollectionRef,
+  resolveNativeItemsLayout
+} from "@x12i/catalox/firebase";
+var DELETE_BATCH = 400;
+async function pruneStaleCatalogModels(options) {
+  const { firestore, catalogId, activeModelIds, dryRun } = options;
+  const layout = await resolveNativeItemsLayout(firestore, catalogId);
+  const col = layout === "legacy" ? legacyNativeItemsCollectionRef(firestore, catalogId) : flatNativeItemsCollectionRef(firestore, catalogId);
+  const snapshot = await col.get();
+  const toDelete = [];
+  for (const doc of snapshot.docs) {
+    const modelId = decodeModelFirestoreDocId(doc.id);
+    if (!activeModelIds.has(modelId)) {
+      toDelete.push(modelId);
+    }
+  }
+  if (!dryRun && toDelete.length > 0) {
+    for (let i = 0; i < toDelete.length; i += DELETE_BATCH) {
+      const chunk = toDelete.slice(i, i + DELETE_BATCH);
+      const batch = firestore.batch();
+      for (const modelId of chunk) {
+        batch.delete(col.doc(encodeModelFirestoreDocId(modelId)));
+      }
+      await batch.commit();
+    }
+  }
+  return {
+    scanned: snapshot.size,
+    pruned: toDelete.length,
+    prunedModelIds: toDelete
+  };
+}
+
+// src/catalog/runAiModelsCatalogSync.ts
+var CatalogSyncJobError = class extends Error {
+  constructor(message, sync, verify) {
+    super(message);
+    this.sync = sync;
+    this.verify = verify;
+    this.name = "CatalogSyncJobError";
+  }
+  sync;
+  verify;
+};
+async function runAiModelsCatalogSync(options) {
+  const verifyAfter = options.verifyAfter !== false;
+  const failOnVerifyError = options.failOnVerifyError !== false;
+  const appId = options.appId ?? AI_TOOLS_APP_ID;
+  const catalogId = options.catalogId ?? AI_MODELS_CATALOG_ID;
+  const ctx = { appId, superAdmin: true };
+  const sync = await syncAiModelsCatalog(options);
+  let prune;
+  if (options.pruneStale && !options.dryRun) {
+    prune = await pruneStaleCatalogModels({
+      firestore: options.firestore,
+      catalogId,
+      context: ctx,
+      activeModelIds: new Set(sync.syncedModelIds),
+      dryRun: options.dryRun
+    });
+    invalidateModelsCache(appId);
+  }
+  let verify;
+  if (verifyAfter) {
+    verify = await verifyAiModelsCatalog({
+      catalox: options.catalox,
+      appId,
+      catalogId,
+      expectedModelIds: new Set(sync.syncedModelIds),
+      ensureDescriptor: false
+    });
+  }
+  const syncFailed = sync.errors.length > 0 || sync.upserted < sync.fetched;
+  const verifyFailed = verify !== void 0 && !verify.ok;
+  const ok = !syncFailed && !verifyFailed;
+  if (!ok && failOnVerifyError) {
+    const parts = [];
+    if (syncFailed) {
+      parts.push(
+        `sync incomplete: upserted ${sync.upserted}/${sync.fetched}, ${sync.errors.length} errors`
+      );
+    }
+    if (verifyFailed && verify) {
+      parts.push(
+        `verify failed: catalox ${verify.cataloxCount} vs openrouter ${verify.openRouterCount}, missing ${verify.missingInCatalox.length}, extra ${verify.extraInCatalox.length}`
+      );
+    }
+    throw new CatalogSyncJobError(parts.join("; "), sync, verify);
+  }
+  return { sync, verify, prune, ok };
+}
+
+export {
+  verifyAiModelsCatalog,
+  pruneStaleCatalogModels,
+  CatalogSyncJobError,
+  runAiModelsCatalogSync
+};
+//# sourceMappingURL=chunk-MX3AMQFC.js.map

package/dist/chunk-MX3AMQFC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/catalog/verifyAiModelsCatalog.ts","../src/catalog/pruneStaleCatalogModels.ts","../src/catalog/runAiModelsCatalogSync.ts"],"sourcesContent":["import type { Catalox } from \"@x12i/catalox\";\nimport { invalidateModelsCache } from \"../cache/modelCache.js\";\nimport { AiModelsCatalogClient } from \"../catalox/AiModelsCatalogClient.js\";\nimport type { AiModelRecord } from \"../models/types.js\";\nimport { OpenRouterSyncProvider } from \"../sync/OpenRouterSyncProvider.js\";\nimport type { OpenRouterModelsQuery } from \"../models/openrouter.types.js\";\nimport {\n  AI_MODELS_CATALOG_ID,\n  AI_MODELS_DESCRIPTOR,\n  AI_TOOLS_APP_ID,\n} from \"./aiModelsCatalogDescriptor.js\";\nimport { ensureAiModelsCatalog } from \"./ensureAiModelsCatalog.js\";\n\nexport type CatalogVerifyOptions = {\n  catalox: Catalox;\n  appId?: string;\n  catalogId?: string;\n  /** When set, compare against this id set (e.g. from a sync that just ran). */\n  expectedModelIds?: Set<string>;\n  /** When set, compare against this list instead of fetching OpenRouter. */\n  openRouterModels?: AiModelRecord[];\n  openRouterApiKey?: string;\n  openRouterQuery?: OpenRouterModelsQuery;\n  /** Ensure descriptor is registered before reading (default true). */\n  ensureDescriptor?: boolean;\n  /** Max model ids to include in report samples (default 20). */\n  sampleLimit?: number;\n};\n\nexport type CatalogVerifyReport = {\n  ok: boolean;\n  openRouterCount: number;\n  cataloxCount: number;\n  missingInCatalox: string[];\n  extraInCatalox: string[];\n  supportsReasoningMissing: number;\n  openRouterMirrorMissing: number;\n  descriptorKeysMatch: boolean;\n  durationMs: number;\n};\n\nfunction sample(ids: string[], limit: number): string[] {\n  return ids.length <= limit ? ids : ids.slice(0, limit);\n}\n\n/**\n * Compare the live OpenRouter catalog with Catalox/Firestore ai-models items.\n * Use after sync in CI/cron, or standalone health checks.\n */\nexport async function verifyAiModelsCatalog(\n  options: CatalogVerifyOptions,\n): Promise<CatalogVerifyReport> {\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 sampleLimit = options.sampleLimit ?? 20;\n\n  if (options.ensureDescriptor !== false) {\n    await ensureAiModelsCatalog(options.catalox, { appId, catalogId });\n  }\n\n  const orIds =\n    options.expectedModelIds ??\n    new Set(\n      (\n        options.openRouterModels ??\n        (await new OpenRouterSyncProvider({\n          apiKey: options.openRouterApiKey,\n          query: options.openRouterQuery ?? { output_modalities: \"all\" },\n        }).fetchModels())\n      ).map((m) => m.modelId),\n    );\n\n  invalidateModelsCache(appId);\n  const client = new AiModelsCatalogClient({ catalox: options.catalox, appId, catalogId });\n  const catMap = await client.getAllModels();\n  const catIds = new Set(catMap.keys());\n\n  const missingInCatalox = [...orIds].filter((id) => !catIds.has(id));\n  const extraInCatalox = [...catIds].filter((id) => !orIds.has(id));\n\n  let supportsReasoningMissing = 0;\n  let openRouterMirrorMissing = 0;\n  for (const m of catMap.values()) {\n    if (m.supportsReasoning === undefined) supportsReasoningMissing++;\n    if (!m.openRouter?.id) openRouterMirrorMissing++;\n  }\n\n  const descriptor = await options.catalox.getCatalogDescriptor(\n    { appId, superAdmin: true },\n    catalogId,\n  );\n  const remoteKeys = descriptor?.queryableFields?.map((f) => f.key) ?? [];\n  const localKeys = AI_MODELS_DESCRIPTOR.queryableFields.map((f) => f.key);\n  const descriptorKeysMatch =\n    remoteKeys.length === localKeys.length &&\n    remoteKeys.every((k, i) => k === localKeys[i]);\n\n  const ok =\n    missingInCatalox.length === 0 &&\n    extraInCatalox.length === 0 &&\n    supportsReasoningMissing === 0 &&\n    openRouterMirrorMissing === 0 &&\n    descriptorKeysMatch;\n\n  return {\n    ok,\n    openRouterCount: orIds.size,\n    cataloxCount: catIds.size,\n    missingInCatalox: sample(missingInCatalox, sampleLimit),\n    extraInCatalox: sample(extraInCatalox, sampleLimit),\n    supportsReasoningMissing,\n    openRouterMirrorMissing,\n    descriptorKeysMatch,\n    durationMs: Date.now() - start,\n  };\n}\n","import type { Firestore } from \"firebase-admin/firestore\";\nimport type { CataloxContext } from \"@x12i/catalox\";\nimport {\n  flatNativeItemsCollectionRef,\n  legacyNativeItemsCollectionRef,\n  resolveNativeItemsLayout,\n} from \"@x12i/catalox/firebase\";\nimport { decodeModelFirestoreDocId, encodeModelFirestoreDocId } from \"../catalox/modelDocId.js\";\n\nexport type PruneStaleCatalogModelsOptions = {\n  firestore: Firestore;\n  catalogId: string;\n  context: CataloxContext;\n  /** Canonical model ids from the latest OpenRouter fetch. */\n  activeModelIds: Set<string>;\n  dryRun?: boolean;\n};\n\nexport type PruneStaleCatalogModelsResult = {\n  scanned: number;\n  pruned: number;\n  prunedModelIds: string[];\n};\n\nconst DELETE_BATCH = 400;\n\n/**\n * Remove catalog documents that are no longer listed on OpenRouter.\n * Off by default — enable explicitly when running production sync jobs.\n */\nexport async function pruneStaleCatalogModels(\n  options: PruneStaleCatalogModelsOptions,\n): Promise<PruneStaleCatalogModelsResult> {\n  const { firestore, catalogId, activeModelIds, dryRun } = options;\n  const layout = await resolveNativeItemsLayout(firestore, catalogId);\n  const col =\n    layout === \"legacy\"\n      ? legacyNativeItemsCollectionRef(firestore, catalogId)\n      : flatNativeItemsCollectionRef(firestore, catalogId);\n\n  const snapshot = await col.get();\n  const toDelete: string[] = [];\n\n  for (const doc of snapshot.docs) {\n    const modelId = decodeModelFirestoreDocId(doc.id);\n    if (!activeModelIds.has(modelId)) {\n      toDelete.push(modelId);\n    }\n  }\n\n  if (!dryRun && toDelete.length > 0) {\n    for (let i = 0; i < toDelete.length; i += DELETE_BATCH) {\n      const chunk = toDelete.slice(i, i + DELETE_BATCH);\n      const batch = firestore.batch();\n      for (const modelId of chunk) {\n        batch.delete(col.doc(encodeModelFirestoreDocId(modelId)));\n      }\n      await batch.commit();\n    }\n  }\n\n  return {\n    scanned: snapshot.size,\n    pruned: toDelete.length,\n    prunedModelIds: toDelete,\n  };\n}\n","import { invalidateModelsCache } from \"../cache/modelCache.js\";\nimport { syncAiModelsCatalog } from \"../sync/syncAiModelsCatalog.js\";\nimport type { SyncOptions, SyncResult } from \"../sync/syncAiModelsCatalog.js\";\nimport { pruneStaleCatalogModels } from \"./pruneStaleCatalogModels.js\";\nimport type { CatalogVerifyReport } from \"./verifyAiModelsCatalog.js\";\nimport { verifyAiModelsCatalog } from \"./verifyAiModelsCatalog.js\";\nimport { AI_MODELS_CATALOG_ID, AI_TOOLS_APP_ID } from \"./aiModelsCatalogDescriptor.js\";\n\nexport type CatalogSyncJobOptions = SyncOptions & {\n  /**\n   * After upsert, compare Catalox to OpenRouter (default true).\n   * Set false only when you will verify separately.\n   */\n  verifyAfter?: boolean;\n  /** Fail the job when verification does not pass (default true). */\n  failOnVerifyError?: boolean;\n  /** Delete Firestore rows not present in the latest OpenRouter list (default false). */\n  pruneStale?: boolean;\n};\n\nexport type CatalogSyncJobResult = {\n  sync: SyncResult;\n  verify?: CatalogVerifyReport;\n  prune?: {\n    scanned: number;\n    pruned: number;\n    prunedModelIds: string[];\n  };\n  ok: boolean;\n};\n\nexport class CatalogSyncJobError extends Error {\n  constructor(\n    message: string,\n    public readonly sync: SyncResult,\n    public readonly verify?: CatalogVerifyReport,\n  ) {\n    super(message);\n    this.name = \"CatalogSyncJobError\";\n  }\n}\n\n/**\n * Production entry point: sync OpenRouter → Catalox, optionally prune stale rows, then verify.\n * Suitable for cron, Cloud Run jobs, and `ai-tools sync`.\n */\nexport async function runAiModelsCatalogSync(\n  options: CatalogSyncJobOptions,\n): Promise<CatalogSyncJobResult> {\n  const verifyAfter = options.verifyAfter !== false;\n  const failOnVerifyError = options.failOnVerifyError !== false;\n  const appId = options.appId ?? AI_TOOLS_APP_ID;\n  const catalogId = options.catalogId ?? AI_MODELS_CATALOG_ID;\n  const ctx = { appId, superAdmin: true as const };\n\n  const sync = await syncAiModelsCatalog(options);\n\n  let prune: CatalogSyncJobResult[\"prune\"];\n\n  if (options.pruneStale && !options.dryRun) {\n    prune = await pruneStaleCatalogModels({\n      firestore: options.firestore,\n      catalogId,\n      context: ctx,\n      activeModelIds: new Set(sync.syncedModelIds),\n      dryRun: options.dryRun,\n    });\n    invalidateModelsCache(appId);\n  }\n\n  let verify: CatalogVerifyReport | undefined;\n  if (verifyAfter) {\n    verify = await verifyAiModelsCatalog({\n      catalox: options.catalox,\n      appId,\n      catalogId,\n      expectedModelIds: new Set(sync.syncedModelIds),\n      ensureDescriptor: false,\n    });\n  }\n\n  const syncFailed = sync.errors.length > 0 || sync.upserted < sync.fetched;\n  const verifyFailed = verify !== undefined && !verify.ok;\n  const ok = !syncFailed && !verifyFailed;\n\n  if (!ok && failOnVerifyError) {\n    const parts: string[] = [];\n    if (syncFailed) {\n      parts.push(\n        `sync incomplete: upserted ${sync.upserted}/${sync.fetched}, ${sync.errors.length} errors`,\n      );\n    }\n    if (verifyFailed && verify) {\n      parts.push(\n        `verify failed: catalox ${verify.cataloxCount} vs openrouter ${verify.openRouterCount}, ` +\n          `missing ${verify.missingInCatalox.length}, extra ${verify.extraInCatalox.length}`,\n      );\n    }\n    throw new CatalogSyncJobError(parts.join(\"; \"), sync, verify);\n  }\n\n  return { sync, verify, prune, ok };\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-MLRHYOCD.js → chunk-VRFVF5RH.js}

@@ -1,6 +1,6 @@
 import {
   batchUpsertAiModelRecords
-} from "./chunk-ML2FRR4L.js";
+} from "./chunk-HYGXZY25.js";
 import {
   normalizeOpenRouterModel
 } from "./chunk-6QGDZTGH.js";
@@ -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 batchUpsertAiModelRecords(options.firestore, catalogId, ctx, models);
-  } catch (cause) {
-    const message = cause instanceof Error ? cause.message : String(cause);
-    throw new SyncError("SYNC_UPSERT_FAILED", `Batch upsert failed: ${message}`, cause);
-  }
+  const upsert = await batchUpsertAiModelRecords(
+    options.firestore,
+    catalogId,
+    ctx,
+    models,
+    { onProgress: options.onProgress }
+  );
   invalidateModelsCache(appId);
+  if (upsert.failed.length > 0 && upsert.upserted === 0) {
+    throw new 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 @@ export {
   OpenRouterSyncProvider,
   syncAiModelsCatalog
 };
-//# sourceMappingURL=chunk-MLRHYOCD.js.map
+//# sourceMappingURL=chunk-VRFVF5RH.js.map

package/dist/chunk-VRFVF5RH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/catalog/ensureAiModelsCatalog.ts","../src/sync/OpenRouterSyncProvider.ts","../src/sync/syncAiModelsCatalog.ts"],"sourcesContent":["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"],"mappings":"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","names":[]}

package/dist/cli/index.cjs

@@ -5,15 +5,19 @@ var _chunkHN6UAQAEcjs = require('../chunk-HN6UAQAE.cjs');
 
 
 
-var _chunkONA73BU6cjs = require('../chunk-ONA73BU6.cjs');
-require('../chunk-HHNHWYTP.cjs');
+var _chunkQWAX7VQOcjs = require('../chunk-QWAX7VQO.cjs');
 
 
+var _chunkQCRLKVB3cjs = require('../chunk-QCRLKVB3.cjs');
 
-var _chunkQWAX7VQOcjs = require('../chunk-QWAX7VQO.cjs');
 
 
-var _chunkQCRLKVB3cjs = require('../chunk-QCRLKVB3.cjs');
+
+var _chunkHS74X2OJcjs = require('../chunk-HS74X2OJ.cjs');
+
+
+var _chunkDKHGWHXPcjs = require('../chunk-DKHGWHXP.cjs');
+require('../chunk-FGP3QXWL.cjs');
 require('../chunk-AV6OE2YQ.cjs');
 
 
@@ -179,15 +183,91 @@ ${report.total} total  \xB7  ${report.ok} ok  \xB7  ${report.unknown} unknown  \
   });
 }
 
+// src/cli/report.ts
+function emitJson(data) {
+  console.log(JSON.stringify(data, null, 2));
+}
+function emitHuman(lines) {
+  for (const line of lines) {
+    console.log(line);
+  }
+}
+function formatSyncJobReport(result) {
+  const lines = [
+    "",
+    result.ok ? "\u2714  Catalog sync job succeeded" : "\u2717  Catalog sync job failed",
+    "",
+    "Sync",
+    `  Fetched:  ${result.sync.fetched}`,
+    `  Upserted: ${result.sync.upserted}`,
+    `  Skipped:  ${result.sync.skipped}`,
+    `  Errors:   ${result.sync.errors.length}`,
+    `  Duration: ${result.sync.durationMs}ms`
+  ];
+  if (result.verify) {
+    lines.push(
+      "",
+      "Verify",
+      `  Status:   ${result.verify.ok ? "ok" : "FAILED"}`,
+      `  OpenRouter: ${result.verify.openRouterCount}`,
+      `  Catalox:    ${result.verify.cataloxCount}`,
+      `  Missing:    ${result.verify.missingInCatalox.length}`,
+      `  Extra:      ${result.verify.extraInCatalox.length}`,
+      `  Duration:   ${result.verify.durationMs}ms`
+    );
+    if (result.verify.missingInCatalox.length > 0) {
+      lines.push(`  Sample missing: ${result.verify.missingInCatalox.join(", ")}`);
+    }
+    if (result.verify.extraInCatalox.length > 0) {
+      lines.push(`  Sample extra: ${result.verify.extraInCatalox.join(", ")}`);
+    }
+  }
+  if (result.prune) {
+    lines.push("", "Prune", `  Scanned: ${result.prune.scanned}`, `  Removed: ${result.prune.pruned}`);
+  }
+  return lines;
+}
+
 // src/cli/commands/catalog.ts
 function registerCatalogCommand(program2) {
-  const catalog = program2.command("catalog").description("Catalog bootstrap commands");
-  catalog.command("ensure").description("Create catalog, descriptor, and app binding if missing").option("--app <appId>", "Override appId").option("--catalog <id>", "Override catalogId").action(async (opts) => {
-    await _chunkONA73BU6cjs.ensureAiModelsCatalog.call(void 0, getCatalox(), {
+  const catalog = program2.command("catalog").description("Catalog bootstrap and health commands");
+  catalog.command("ensure").description("Create catalog, descriptor, and app binding if missing").option("--app <appId>", "Override appId").option("--catalog <id>", "Override catalogId").option("--json", "Machine-readable JSON on stdout").action(async (opts) => {
+    const appId = _nullishCoalesce(opts.app, () => ( envAppId()));
+    const catalogId = _nullishCoalesce(opts.catalog, () => ( envCatalogId()));
+    await _chunkDKHGWHXPcjs.ensureAiModelsCatalog.call(void 0, getCatalox(), { appId, catalogId });
+    if (opts.json) {
+      emitJson({ ok: true, appId, catalogId, action: "ensure" });
+    } else {
+      console.log("\u2714  ai-models catalog ensured");
+    }
+  });
+  catalog.command("verify").description("Health check: compare Catalox ai-models against the live OpenRouter catalog").option("--app <appId>", "Override appId").option("--catalog <id>", "Override catalogId").option("--json", "Machine-readable JSON on stdout").action(async (opts) => {
+    const report = await _chunkHS74X2OJcjs.verifyAiModelsCatalog.call(void 0, {
+      catalox: getCatalox(),
       appId: _nullishCoalesce(opts.app, () => ( envAppId())),
       catalogId: _nullishCoalesce(opts.catalog, () => ( envCatalogId()))
     });
-    console.log("\u2714  ai-models catalog ensured");
+    if (opts.json) {
+      emitJson(report);
+    } else {
+      emitHuman([
+        report.ok ? "\u2714  Catalog verification passed" : "\u2717  Catalog verification FAILED",
+        `  OpenRouter models: ${report.openRouterCount}`,
+        `  Catalox models:    ${report.cataloxCount}`,
+        `  Missing in Catalox: ${report.missingInCatalox.length}`,
+        `  Extra in Catalox:   ${report.extraInCatalox.length}`,
+        `  Duration: ${report.durationMs}ms`
+      ]);
+      if (report.missingInCatalox.length > 0) {
+        console.log(`  Sample missing: ${report.missingInCatalox.join(", ")}`);
+      }
+      if (report.extraInCatalox.length > 0) {
+        console.log(`  Sample extra: ${report.extraInCatalox.join(", ")}`);
+      }
+    }
+    if (!report.ok) {
+      process.exit(1);
+    }
   });
 }
 
@@ -362,30 +442,53 @@ ${rows.length} shown \xB7 ${total} matching`);
 
 // src/cli/commands/sync.ts
 function registerSyncCommand(program2) {
-  program2.command("sync").description("Fetch OpenRouter models (public API, no key required) and upsert into the ai-models catalog").option("--dry-run", "Print what would be written without touching Firestore").option("--verbose", "Print each model ID as it is upserted").option("--app <appId>", "Override appId").option("--catalog <id>", "Override catalogId").option("--force-cache", "Invalidate nx-cache before running").action(async (opts) => {
-    const result = await _chunkONA73BU6cjs.syncAiModelsCatalog.call(void 0, {
-      catalox: getCatalox(),
-      firestore: getFirestore(),
-      openRouterApiKey: process.env.OPENROUTER_API_KEY,
-      appId: _nullishCoalesce(opts.app, () => ( envAppId())),
-      catalogId: _nullishCoalesce(opts.catalog, () => ( envCatalogId())),
-      dryRun: opts.dryRun,
-      verbose: opts.verbose,
-      forceCache: opts.forceCache
-    });
-    console.log("\nSync complete");
-    console.log(`  Fetched:  ${result.fetched}`);
-    console.log(`  Upserted: ${result.upserted}`);
-    console.log(`  Skipped:  ${result.skipped}`);
-    console.log(`  Errors:   ${result.errors.length}`);
-    console.log(`  Duration: ${result.durationMs}ms`);
-    if (result.errors.length > 0) {
-      for (const e of result.errors.slice(0, 10)) {
-        console.error(`  \u2717 ${e.modelId}: ${e.error}`);
+  program2.command("sync").description(
+    "Production sync: fetch OpenRouter models, upsert into Catalox/Firestore, verify completeness"
+  ).option("--dry-run", "Fetch and validate without writing to Firestore").option("--no-verify", "Skip post-sync verification (not recommended in production)").option("--prune-stale", "Remove catalog rows no longer on OpenRouter").option("--json", "Machine-readable JSON on stdout").option("--verbose", "Log fetch URL and upsert progress").option("--app <appId>", "Override appId").option("--catalog <id>", "Override catalogId").option("--force-cache", "Invalidate nx-cache before running").action(
+    async (opts) => {
+      const verifyAfter = opts.verify !== false;
+      try {
+        const result = await _chunkHS74X2OJcjs.runAiModelsCatalogSync.call(void 0, {
+          catalox: getCatalox(),
+          firestore: getFirestore(),
+          openRouterApiKey: process.env.OPENROUTER_API_KEY,
+          appId: _nullishCoalesce(opts.app, () => ( envAppId())),
+          catalogId: _nullishCoalesce(opts.catalog, () => ( envCatalogId())),
+          dryRun: opts.dryRun,
+          verbose: opts.verbose,
+          forceCache: opts.forceCache,
+          verifyAfter,
+          pruneStale: opts.pruneStale,
+          onProgress: opts.verbose ? ({ completed, total, phase }) => {
+            console.log(`[sync] ${phase} ${completed}/${total}`);
+          } : void 0
+        });
+        if (opts.json) {
+          emitJson(result);
+        } else {
+          emitHuman(formatSyncJobReport(result));
+        }
+        if (!result.ok) {
+          process.exit(1);
+        }
+      } catch (error) {
+        if (error instanceof _chunkHS74X2OJcjs.CatalogSyncJobError) {
+          const payload = {
+            ok: false,
+            sync: error.sync,
+            verify: error.verify
+          };
+          if (opts.json) {
+            emitJson(payload);
+          } else {
+            emitHuman(formatSyncJobReport(payload));
+          }
+          process.exit(1);
+        }
+        throw error;
       }
-      process.exit(1);
     }
-  });
+  );
 }
 
 // src/cli/index.ts