@x12i/ai-tools 1.0.2

package/README.md

@@ -0,0 +1,214 @@
+# @x12i/ai-tools
+
+TypeScript-first npm package for AI model catalog management, runtime cost calculation, project-local model aliases, and an integrated LLM utility belt — backed by [@x12i/catalox](https://www.npmjs.com/package/@x12i/catalox) and OpenRouter.
+
+## Install
+
+```bash
+npm install @x12i/ai-tools @x12i/catalox
+```
+
+Optional peers: `firebase-admin`, `@x12i/helpers`, `openai`, `better-sqlite3` (for toolbox SQLite storage).
+
+## Quick start
+
+```ts
+import { createCataloxFromEnv } from "@x12i/catalox/firebase";
+import {
+  ensureAiModelsCatalog,
+  AiModelsCatalogClient,
+  CostCalculator,
+} from "@x12i/ai-tools";
+
+const { catalox } = createCataloxFromEnv();
+await ensureAiModelsCatalog(catalox);
+
+const catalog = new AiModelsCatalogClient({ catalox });
+const calculator = new CostCalculator(catalog);
+
+const result = await calculator.calculate({
+  tokens: { prompt: 1000, completion: 500, total: 1500 },
+  provider: "openrouter",
+  modelUsed: "openai/gpt-4o",
+});
+
+console.log(result.cost);
+```
+
+## Reasoning models
+
+After sync, each catalog record includes **`supportsReasoning`** — use it to branch prompts, token limits, or cost handling.
+
+```ts
+import { getModelInfo, isReasoningModel } from "@x12i/ai-tools";
+
+const model = await getModelInfo("openai/o3-mini");
+if (model?.supportsReasoning) {
+  // pass OpenRouter `reasoning: { effort: "medium" }`, bill reasoning tokens, etc.
+}
+
+// Same check without loading the full record field:
+isReasoningModel(model!);
+```
+
+Detection uses OpenRouter metadata:
+
+- `supported_parameters` includes `reasoning` (or `include_reasoning`)
+- pricing includes `internal_reasoning` (exposed as `pricing.reasoningUsdPerToken`)
+
+```bash
+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.
+
+## Smart model name resolution
+
+Callers often pass messy `provider` + `model` pairs (typos, missing namespaces, version suffixes, aliases used as provider names, or no provider at all). **`ModelNameResolver`** normalises input and runs a deterministic strategy pipeline against the cached catalog (no network calls during resolution).
+
+```ts
+import { AiModelsCatalogClient, ModelNameResolver } from "@x12i/ai-tools";
+
+const catalog = new AiModelsCatalogClient({ catalox });
+const models = await catalog.getAllModels();
+
+const resolver = new ModelNameResolver(models, { aliasRegistry });
+const result = await catalog.resolveModel({
+  provider: "openrouter",
+  model: "gpt4o",
+});
+
+if (result.found) {
+  console.log(result.modelId); // openai/gpt-4o
+  console.log(result.confidence, result.resolvedVia);
+  console.log(result.routedViaOpenRouter);
+}
+```
+
+### What it handles
+
+| Input | Resolves to |
+|-------|-------------|
+| `openrouter` + `gpt-4o` | `openai/gpt-4o` (provider prefix inference) |
+| `openrouter` + `gpt4o` | `openai/gpt-4o` (shorthand expansion) |
+| `openrouter` + `gpt-4o-2024-08-06` | `openai/gpt-4o` (version suffix strip) |
+| `openrouter` + `openai/claude-3-5-sonnet` | `anthropic/claude-3-5-sonnet-…` (cross-provider correction) |
+| provider `best` (alias name) + any model | alias target (alias-as-provider correction) |
+| model only (`gpt-4o`) | catalog alias or prefix inference |
+| `ollama` + `llama3:8b` | passthrough (`record: null`, not an error) |
+
+Each success includes `confidence`, `resolvedVia[]`, and `resolvedReason`. Below-threshold matches return `found: false` with `bestRejectedCandidate` when applicable.
+
+### OpenRouter vs direct provider (env defaults)
+
+When the **provider is omitted** or ambiguous, routing defaults come from your `.env` (loaded via [@x12/env](https://www.npmjs.com/package/@x12i/env)):
+
+| Condition | Default routing |
+|-----------|-----------------|
+| `OPENROUTER_API_KEY` is set **and** `USE_OPENROUTER=true` or `USE_OPENROUTER=1` | OpenRouter |
+| `OPENROUTER_API_KEY` is set **and** `{VENDOR}_API_KEY` is missing for the resolved vendor | OpenRouter |
+| `{VENDOR}_API_KEY` is set (and `USE_OPENROUTER` not forcing OR) | Direct to that vendor |
+
+**Vendor API key naming:** `{VENDOR}_API_KEY` where `VENDOR` is the catalog `providerId` in `UPPER_SNAKE_CASE` (hyphens → underscores).
+
+Examples:
+
+- `openai` → `OPENAI_API_KEY`
+- `anthropic` → `ANTHROPIC_API_KEY`
+- `meta-llama` → `META_LLAMA_API_KEY`
+- `x-ai` → `X_AI_API_KEY`
+
+```ts
+import {
+  loadOpenRouterRoutingEnv,
+  shouldDefaultRouteViaOpenRouter,
+} from "@x12i/ai-tools";
+
+const routing = loadOpenRouterRoutingEnv();
+shouldDefaultRouteViaOpenRouter("openai", routing); // true if OR key set but OPENAI_API_KEY missing
+```
+
+Explicit `provider: "openrouter"` always sets `routedViaOpenRouter: true`. Explicit direct providers (`openai`, `anthropic`, …) use direct routing unless env rules above apply.
+
+### CLI
+
+```bash
+npx ai-tools models resolve --provider openrouter --model gpt4o
+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
+npm test              # unit tests (mocked)
+npm run test:live     # live Firestore/Catalox tests (uses .env)
+npm run test:all      # both
+```
+
+## CLI
+
+```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
+npx ai-tools cost --model openai/gpt-4o --prompt-tokens 2000 --completion-tokens 800
+npx ai-tools alias init
+npx ai-tools alias set best anthropic/claude-opus-4 --provider openrouter
+npx ai-tools alias check
+```
+
+### Environment variables
+
+| Variable | Purpose |
+|----------|---------|
+| `OPENROUTER_API_KEY` | OpenRouter API key; used for routing defaults and optional sync auth |
+| `USE_OPENROUTER` | Set to `true` or `1` to default API routing via OpenRouter when `OPENROUTER_API_KEY` is set |
+| `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, … | Direct vendor keys — pattern `{PROVIDER_ID}_API_KEY` (see smart resolver above) |
+| `GOOGLE_SERVICE_ACCOUNT_BASE64` | Firebase / Firestore credentials |
+| `FIREBASE_PROJECT_ID` | GCP project |
+| `FIRESTORE_DATABASE_ID` | Firestore database (default: `(default)`) |
+| `AI_TOOLS_APP_ID` | Catalox appId (default: `ai-tools`) |
+| `AI_TOOLS_CATALOG_ID` | Catalog id (default: `ai-models`) |
+| `AI_TOOLS_CACHE_TTL_MS` | nx-cache TTL override |
+| `AI_TOOLS_ALIASES_PATH` | Path to `aliases.json` |
+
+## Subpath exports
+
+- `@x12i/ai-tools` — main API (`ModelNameResolver`, `loadOpenRouterRoutingEnv`, catalog, cost, aliases)
+- `@x12i/ai-tools/cost`
+- `@x12i/ai-tools/toolbox`
+- `@x12i/ai-tools/sync` — sync + resolver types
+- `@x12i/ai-tools/catalox`
+- `@x12i/ai-tools/aliases`
+- `@x12i/ai-tools/models`
+
+## Project aliases
+
+Commit `./ai-tools/aliases.json` in your application repo so dev/staging/prod share the same model vocabulary. Alias targets that use shorthand or versioned ids are resolved through the same smart resolver as runtime model strings.
+
+## Publishing
+
+Scoped packages (`@x12i/...`) require public access on the free npm plan:
+
+```bash
+npm publish
+```
+
+`package.json` includes `"publishConfig": { "access": "public" }`. If publish still fails, run `npm publish --access public`.
+
+## License
+
+MIT

package/dist/AiModelsCatalogClient-4RF5BCDL.cjs

@@ -0,0 +1,9 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkF2F4UEFDcjs = require('./chunk-F2F4UEFD.cjs');
+require('./chunk-TF4L2NEC.cjs');
+require('./chunk-7Q742NI3.cjs');
+
+
+exports.AiModelsCatalogClient = _chunkF2F4UEFDcjs.AiModelsCatalogClient;
+//# sourceMappingURL=AiModelsCatalogClient-4RF5BCDL.cjs.map

package/dist/AiModelsCatalogClient-4RF5BCDL.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/ami/Documents/prometheus/x12i/ai-tools/dist/AiModelsCatalogClient-4RF5BCDL.cjs"],"names":[],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACF,wEAAC","file":"/Users/ami/Documents/prometheus/x12i/ai-tools/dist/AiModelsCatalogClient-4RF5BCDL.cjs"}

package/dist/AiModelsCatalogClient-B-dNLXX0.d.ts

@@ -0,0 +1,29 @@
+import { Catalox } from '@x12i/catalox';
+import { l as ModelResolverOptions, a as AiModelRecord, h as ModelResolutionInput, j as ModelResolutionResult } from './types-DdGB3YaA.js';
+
+type AiModelsCatalogClientOptions = {
+    catalox: Catalox;
+    appId?: string;
+    catalogId?: string;
+    cacheTtlMs?: number;
+    resolverOptions?: Omit<ModelResolverOptions, "aliasRegistry">;
+};
+declare class AiModelsCatalogClient {
+    private readonly catalox;
+    private readonly appId;
+    private readonly catalogId;
+    private readonly cacheTtlMs;
+    private readonly resolverOptions;
+    constructor(options: AiModelsCatalogClientOptions);
+    private context;
+    getAllModels(): Promise<Map<string, AiModelRecord>>;
+    private resolver;
+    /**
+     * Resolve a (provider, model) pair to a canonical model id and catalog record.
+     */
+    resolveModel(input: ModelResolutionInput, options?: ModelResolverOptions): Promise<ModelResolutionResult>;
+    getModel(modelId: string, provider?: string, options?: ModelResolverOptions): Promise<AiModelRecord | null>;
+    refresh(): Promise<void>;
+}
+
+export { AiModelsCatalogClient as A, type AiModelsCatalogClientOptions as a };

package/dist/AiModelsCatalogClient-CSVlKql5.d.cts

@@ -0,0 +1,29 @@
+import { Catalox } from '@x12i/catalox';
+import { l as ModelResolverOptions, a as AiModelRecord, h as ModelResolutionInput, j as ModelResolutionResult } from './types-DdGB3YaA.cjs';
+
+type AiModelsCatalogClientOptions = {
+    catalox: Catalox;
+    appId?: string;
+    catalogId?: string;
+    cacheTtlMs?: number;
+    resolverOptions?: Omit<ModelResolverOptions, "aliasRegistry">;
+};
+declare class AiModelsCatalogClient {
+    private readonly catalox;
+    private readonly appId;
+    private readonly catalogId;
+    private readonly cacheTtlMs;
+    private readonly resolverOptions;
+    constructor(options: AiModelsCatalogClientOptions);
+    private context;
+    getAllModels(): Promise<Map<string, AiModelRecord>>;
+    private resolver;
+    /**
+     * Resolve a (provider, model) pair to a canonical model id and catalog record.
+     */
+    resolveModel(input: ModelResolutionInput, options?: ModelResolverOptions): Promise<ModelResolutionResult>;
+    getModel(modelId: string, provider?: string, options?: ModelResolverOptions): Promise<AiModelRecord | null>;
+    refresh(): Promise<void>;
+}
+
+export { AiModelsCatalogClient as A, type AiModelsCatalogClientOptions as a };

package/dist/AiModelsCatalogClient-NUF3CBLW.js

@@ -0,0 +1,9 @@
+import {
+  AiModelsCatalogClient
+} from "./chunk-KQOALKKX.js";
+import "./chunk-DJ5SWJDY.js";
+import "./chunk-AJEKEWWB.js";
+export {
+  AiModelsCatalogClient
+};
+//# sourceMappingURL=AiModelsCatalogClient-NUF3CBLW.js.map

package/dist/AiModelsCatalogClient-NUF3CBLW.js.map

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

package/dist/aliases/index.cjs

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('../chunk-3E67S427.cjs');
+
+
+
+var _chunkQWAX7VQOcjs = require('../chunk-QWAX7VQO.cjs');
+require('../chunk-7Q742NI3.cjs');
+
+
+
+exports.AliasRegistry = _chunkQWAX7VQOcjs.AliasRegistry; exports.AliasResolver = _chunkQWAX7VQOcjs.AliasResolver;
+//# sourceMappingURL=index.cjs.map

package/dist/aliases/index.cjs.map

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

package/dist/aliases/index.d.cts

@@ -0,0 +1,21 @@
+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 '@x12i/catalox';
+
+type AliasResolverOptions = {
+    registry: AliasRegistry;
+    catalogClient: AiModelsCatalogClient;
+};
+declare class AliasResolver {
+    private readonly registry;
+    private readonly catalogClient;
+    constructor(options: AliasResolverOptions);
+    getModel(aliasName: string): Promise<ResolvedModelRef>;
+    getModels(aliasNames: string[]): Promise<ResolvedModelRef[]>;
+    getAllResolved(): Promise<ResolvedModelRef[]>;
+    validate(): Promise<AliasValidationReport>;
+    private resolveEntry;
+}
+
+export { AliasRegistry, AliasResolver, type AliasResolverOptions, AliasValidationReport, ResolvedModelRef };

package/dist/aliases/index.d.ts

@@ -0,0 +1,21 @@
+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 '@x12i/catalox';
+
+type AliasResolverOptions = {
+    registry: AliasRegistry;
+    catalogClient: AiModelsCatalogClient;
+};
+declare class AliasResolver {
+    private readonly registry;
+    private readonly catalogClient;
+    constructor(options: AliasResolverOptions);
+    getModel(aliasName: string): Promise<ResolvedModelRef>;
+    getModels(aliasNames: string[]): Promise<ResolvedModelRef[]>;
+    getAllResolved(): Promise<ResolvedModelRef[]>;
+    validate(): Promise<AliasValidationReport>;
+    private resolveEntry;
+}
+
+export { AliasRegistry, AliasResolver, type AliasResolverOptions, AliasValidationReport, ResolvedModelRef };

package/dist/aliases/index.js

@@ -0,0 +1,11 @@
+import "../chunk-KHODXGPV.js";
+import {
+  AliasRegistry,
+  AliasResolver
+} from "../chunk-O2A6OVEH.js";
+import "../chunk-AJEKEWWB.js";
+export {
+  AliasRegistry,
+  AliasResolver
+};
+//# sourceMappingURL=index.js.map

package/dist/aliases/index.js.map

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

package/dist/catalox/index.cjs

@@ -0,0 +1,21 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+var _chunkHHNHWYTPcjs = require('../chunk-HHNHWYTP.cjs');
+
+
+var _chunkF2F4UEFDcjs = require('../chunk-F2F4UEFD.cjs');
+require('../chunk-TF4L2NEC.cjs');
+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;
+//# sourceMappingURL=index.cjs.map

package/dist/catalox/index.cjs.map

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

package/dist/catalox/index.d.cts

@@ -0,0 +1,23 @@
+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';
+
+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 };

package/dist/catalox/index.d.ts

@@ -0,0 +1,23 @@
+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';
+
+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 };

package/dist/catalox/index.js

@@ -0,0 +1,21 @@
+import {
+  batchUpsertAiModelRecords,
+  decodeModelFirestoreDocId,
+  encodeModelFirestoreDocId,
+  sanitizeForFirestore,
+  upsertAiModelRecord
+} from "../chunk-ML2FRR4L.js";
+import {
+  AiModelsCatalogClient
+} from "../chunk-KQOALKKX.js";
+import "../chunk-DJ5SWJDY.js";
+import "../chunk-AJEKEWWB.js";
+export {
+  AiModelsCatalogClient,
+  batchUpsertAiModelRecords,
+  decodeModelFirestoreDocId,
+  encodeModelFirestoreDocId,
+  sanitizeForFirestore,
+  upsertAiModelRecord
+};
+//# sourceMappingURL=index.js.map

package/dist/catalox/index.js.map

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

package/dist/chunk-2PYACSZ5.cjs

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

package/dist/chunk-2PYACSZ5.cjs.map

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

package/dist/chunk-3E67S427.cjs

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

package/dist/chunk-3E67S427.cjs.map

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

package/dist/chunk-4NAY6HRP.js

@@ -0,0 +1,137 @@
+import {
+  AiModelsCatalogClient
+} from "./chunk-KQOALKKX.js";
+
+// src/models/filterModels.ts
+function matchesSearch(record, search) {
+  const q = search.toLowerCase();
+  return record.modelId.toLowerCase().includes(q) || record.name.toLowerCase().includes(q) || record.description.toLowerCase().includes(q) || record.canonicalSlug.toLowerCase().includes(q) || record.aliases.some((a) => a.toLowerCase().includes(q));
+}
+function filterModels(models, filters = {}) {
+  let list = [...models];
+  if (filters.providerId) {
+    list = list.filter((m) => m.providerId === filters.providerId);
+  }
+  if (filters.status) {
+    list = list.filter((m) => m.status === filters.status);
+  }
+  if (filters.outputModality) {
+    list = list.filter((m) => m.outputModalities.includes(filters.outputModality));
+  }
+  if (filters.inputModality) {
+    list = list.filter((m) => m.inputModalities.includes(filters.inputModality));
+  }
+  if (filters.supportedParameter) {
+    list = list.filter((m) => m.supportedParameters.includes(filters.supportedParameter));
+  }
+  if (filters.supportsTools !== void 0) {
+    list = list.filter((m) => m.supportsTools === filters.supportsTools);
+  }
+  if (filters.supportsReasoning !== void 0) {
+    list = list.filter((m) => m.supportsReasoning === filters.supportsReasoning);
+  }
+  if (filters.search) {
+    list = list.filter((m) => matchesSearch(m, filters.search));
+  }
+  list.sort((a, b) => a.name.localeCompare(b.name));
+  const offset = filters.offset ?? 0;
+  const limit = filters.limit ?? list.length;
+  return list.slice(offset, offset + limit);
+}
+function countModels(models, filters = {}) {
+  return filterModels(models, { ...filters, limit: Number.MAX_SAFE_INTEGER, offset: 0 }).length;
+}
+
+// src/models/AiModelsService.ts
+var AiModelsService = class {
+  client;
+  catalox;
+  appId;
+  catalogId;
+  constructor(options) {
+    this.catalox = options.catalox;
+    this.client = new AiModelsCatalogClient(options);
+    this.appId = options.appId ?? "ai-tools";
+    this.catalogId = options.catalogId ?? "ai-models";
+  }
+  context() {
+    return { appId: this.appId, superAdmin: true };
+  }
+  /** Load all models (cached). */
+  async getAllModels() {
+    return this.client.getAllModels();
+  }
+  /** List models with in-memory filters (fast after cache warm). */
+  async listModels(filters = {}) {
+    const all = await this.getAllModels();
+    const total = countModels(all.values(), filters);
+    const limit = filters.limit ?? 50;
+    const offset = filters.offset ?? 0;
+    const models = filterModels(all.values(), { ...filters, limit, offset });
+    return { models, total, limit, offset };
+  }
+  /** Count models matching filters. */
+  async countModels(filters = {}) {
+    const all = await this.getAllModels();
+    return countModels(all.values(), filters);
+  }
+  /**
+   * Full model record by id or alias (same resolution as cost calculator).
+   */
+  async getModelInfo(modelIdOrAlias) {
+    return this.client.getModel(modelIdOrAlias);
+  }
+  /**
+   * Query via Catalox indexed fields (provider, status, output modality, tools).
+   * Falls back to in-memory filter when Catalox returns partial pages.
+   */
+  async listModelsFromCatalog(filters = {}, options) {
+    const filter = {};
+    if (filters.providerId) filter.providerId = filters.providerId;
+    if (filters.status) filter.status = filters.status;
+    if (filters.outputModality) filter.primaryOutputModality = filters.outputModality;
+    if (filters.supportsTools !== void 0) filter.supportsTools = filters.supportsTools;
+    if (filters.supportsReasoning !== void 0) {
+      filter.supportsReasoning = filters.supportsReasoning;
+    }
+    const limit = filters.limit ?? 50;
+    const result = await this.catalox.listCatalogItems(this.context(), this.catalogId, {
+      limit: Math.min(limit, 1e4),
+      filter,
+      ...options
+    });
+    let models = result.items.map((item) => item.data);
+    if (filters.supportedParameter) {
+      models = models.filter((m) => m.supportedParameters?.includes(filters.supportedParameter));
+    }
+    if (filters.inputModality) {
+      models = models.filter((m) => m.inputModalities?.includes(filters.inputModality));
+    }
+    if (filters.search) {
+      models = filterModels(models, { search: filters.search });
+    }
+    return {
+      models,
+      total: models.length,
+      limit,
+      offset: filters.offset ?? 0
+    };
+  }
+  async resolve(modelIdOrAlias, provider) {
+    return this.client.resolveModel({ model: modelIdOrAlias, provider });
+  }
+  async refresh() {
+    await this.client.refresh();
+  }
+};
+async function getModelInfo(service, modelIdOrAlias) {
+  return service.getModelInfo(modelIdOrAlias);
+}
+
+export {
+  filterModels,
+  countModels,
+  AiModelsService,
+  getModelInfo
+};
+//# sourceMappingURL=chunk-4NAY6HRP.js.map

package/dist/chunk-4NAY6HRP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/models/filterModels.ts","../src/models/AiModelsService.ts"],"sourcesContent":["import type { AiModelRecord, ModelListFilters } from \"./types.js\";\n\nfunction matchesSearch(record: AiModelRecord, search: string): boolean {\n  const q = search.toLowerCase();\n  return (\n    record.modelId.toLowerCase().includes(q) ||\n    record.name.toLowerCase().includes(q) ||\n    record.description.toLowerCase().includes(q) ||\n    record.canonicalSlug.toLowerCase().includes(q) ||\n    record.aliases.some((a) => a.toLowerCase().includes(q))\n  );\n}\n\nexport function filterModels(\n  models: Iterable<AiModelRecord>,\n  filters: ModelListFilters = {},\n): AiModelRecord[] {\n  let list = [...models];\n\n  if (filters.providerId) {\n    list = list.filter((m) => m.providerId === filters.providerId);\n  }\n  if (filters.status) {\n    list = list.filter((m) => m.status === filters.status);\n  }\n  if (filters.outputModality) {\n    list = list.filter((m) => m.outputModalities.includes(filters.outputModality!));\n  }\n  if (filters.inputModality) {\n    list = list.filter((m) => m.inputModalities.includes(filters.inputModality!));\n  }\n  if (filters.supportedParameter) {\n    list = list.filter((m) => m.supportedParameters.includes(filters.supportedParameter!));\n  }\n  if (filters.supportsTools !== undefined) {\n    list = list.filter((m) => m.supportsTools === filters.supportsTools);\n  }\n  if (filters.supportsReasoning !== undefined) {\n    list = list.filter((m) => m.supportsReasoning === filters.supportsReasoning);\n  }\n  if (filters.search) {\n    list = list.filter((m) => matchesSearch(m, filters.search!));\n  }\n\n  list.sort((a, b) => a.name.localeCompare(b.name));\n\n  const offset = filters.offset ?? 0;\n  const limit = filters.limit ?? list.length;\n  return list.slice(offset, offset + limit);\n}\n\nexport function countModels(\n  models: Iterable<AiModelRecord>,\n  filters: Omit<ModelListFilters, \"limit\" | \"offset\"> = {},\n): number {\n  return filterModels(models, { ...filters, limit: Number.MAX_SAFE_INTEGER, offset: 0 }).length;\n}\n","import type { Catalox, CataloxContext } from \"@x12i/catalox\";\nimport type { CatalogQueryOptions } from \"@x12i/catalox\";\nimport { AiModelsCatalogClient } from \"../catalox/AiModelsCatalogClient.js\";\nimport { countModels, filterModels } from \"./filterModels.js\";\nimport type { AiModelRecord, ModelListFilters, ModelListResult } from \"./types.js\";\n\nexport type AiModelsServiceOptions = {\n  catalox: Catalox;\n  appId?: string;\n  catalogId?: string;\n  cacheTtlMs?: number;\n};\n\n/**\n * High-level model catalog API — list, filter, count, and get full model info.\n */\nexport class AiModelsService {\n  private readonly client: AiModelsCatalogClient;\n  private readonly catalox: Catalox;\n  private readonly appId: string;\n  private readonly catalogId: string;\n\n  constructor(options: AiModelsServiceOptions) {\n    this.catalox = options.catalox;\n    this.client = new AiModelsCatalogClient(options);\n    this.appId = options.appId ?? \"ai-tools\";\n    this.catalogId = options.catalogId ?? \"ai-models\";\n  }\n\n  private context(): CataloxContext {\n    return { appId: this.appId, superAdmin: true };\n  }\n\n  /** Load all models (cached). */\n  async getAllModels(): Promise<Map<string, AiModelRecord>> {\n    return this.client.getAllModels();\n  }\n\n  /** List models with in-memory filters (fast after cache warm). */\n  async listModels(filters: ModelListFilters = {}): Promise<ModelListResult> {\n    const all = await this.getAllModels();\n    const total = countModels(all.values(), filters);\n    const limit = filters.limit ?? 50;\n    const offset = filters.offset ?? 0;\n    const models = filterModels(all.values(), { ...filters, limit, offset });\n    return { models, total, limit, offset };\n  }\n\n  /** Count models matching filters. */\n  async countModels(filters: Omit<ModelListFilters, \"limit\" | \"offset\"> = {}): Promise<number> {\n    const all = await this.getAllModels();\n    return countModels(all.values(), filters);\n  }\n\n  /**\n   * Full model record by id or alias (same resolution as cost calculator).\n   */\n  async getModelInfo(modelIdOrAlias: string): Promise<AiModelRecord | null> {\n    return this.client.getModel(modelIdOrAlias);\n  }\n\n  /**\n   * Query via Catalox indexed fields (provider, status, output modality, tools).\n   * Falls back to in-memory filter when Catalox returns partial pages.\n   */\n  async listModelsFromCatalog(\n    filters: ModelListFilters = {},\n    options?: CatalogQueryOptions,\n  ): Promise<ModelListResult> {\n    const filter: Record<string, unknown> = {};\n    if (filters.providerId) filter.providerId = filters.providerId;\n    if (filters.status) filter.status = filters.status;\n    if (filters.outputModality) filter.primaryOutputModality = filters.outputModality;\n    if (filters.supportsTools !== undefined) filter.supportsTools = filters.supportsTools;\n    if (filters.supportsReasoning !== undefined) {\n      filter.supportsReasoning = filters.supportsReasoning;\n    }\n\n    const limit = filters.limit ?? 50;\n    const result = await this.catalox.listCatalogItems(this.context(), this.catalogId, {\n      limit: Math.min(limit, 10_000),\n      filter,\n      ...options,\n    });\n\n    let models = result.items.map((item) => item.data as unknown as AiModelRecord);\n\n    if (filters.supportedParameter) {\n      models = models.filter((m) => m.supportedParameters?.includes(filters.supportedParameter!));\n    }\n    if (filters.inputModality) {\n      models = models.filter((m) => m.inputModalities?.includes(filters.inputModality!));\n    }\n    if (filters.search) {\n      models = filterModels(models, { search: filters.search });\n    }\n\n    return {\n      models,\n      total: models.length,\n      limit,\n      offset: filters.offset ?? 0,\n    };\n  }\n\n  async resolve(\n    modelIdOrAlias: string,\n    provider?: string,\n  ): Promise<import(\"../sync/modelNameResolver/types.js\").ModelResolutionResult> {\n    return this.client.resolveModel({ model: modelIdOrAlias, provider });\n  }\n\n  async refresh(): Promise<void> {\n    await this.client.refresh();\n  }\n}\n\n/** Convenience: getModelInfo */\nexport async function getModelInfo(\n  service: AiModelsService,\n  modelIdOrAlias: string,\n): Promise<AiModelRecord | null> {\n  return service.getModelInfo(modelIdOrAlias);\n}\n"],"mappings":"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","names":[]}