nexus-agents 2.102.7 → 2.103.0

package/dist/chunk-L2NPJRZZ.js

@@ -1,153 +0,0 @@
-import {
-  createLogger
-} from "./chunk-KLYBJUTK.js";
-
-// src/config/available-models-cache.ts
-var logger = createLogger({ component: "available-models-cache" });
-var DEFAULT_TTL_MS = 5 * 60 * 1e3;
-var DEFAULT_STALE_TTL_MS = 25 * 60 * 1e3;
-var AvailableModelsCache = class {
-  sources;
-  ttlMs;
-  staleTtlMs;
-  now;
-  states;
-  constructor(options) {
-    this.sources = [...options.sources];
-    this.ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
-    this.staleTtlMs = options.staleTtlMs ?? DEFAULT_STALE_TTL_MS;
-    this.now = options.now ?? Date.now;
-    this.states = /* @__PURE__ */ new Map();
-    for (const s of this.sources) {
-      this.states.set(s.name, { value: null, fetchedAt: 0, inFlight: null });
-    }
-  }
-  /**
-   * Register a source after construction. Used by adapter factories that
-   * wire themselves into the default cache lazily as they're built.
-   * Duplicate names are ignored (first registration wins, on the
-   * assumption that the same factory might run twice in a test session).
-   */
-  addSource(source) {
-    if (this.states.has(source.name)) return;
-    this.sources.push(source);
-    this.states.set(source.name, { value: null, fetchedAt: 0, inFlight: null });
-  }
-  /**
-   * Remove a previously-registered source. Used by tests + by factories
-   * that want to drop a probe when an adapter is being disposed.
-   */
-  removeSource(name) {
-    this.sources = this.sources.filter((s) => s.name !== name);
-    this.states.delete(name);
-  }
-  /**
-   * Returns the union of every source's available models. Stale-while-
-   * revalidate: serve fresh-or-stale immediately, refresh stale entries
-   * in the background. First call (no cache yet) blocks on every source.
-   */
-  async getAll() {
-    const probes = this.sources.map((s) => this.probeOne(s));
-    const results = await Promise.all(probes);
-    const out = [];
-    for (const r of results) {
-      for (const m of r) out.push(m);
-    }
-    return out;
-  }
-  /** Models reported by one named source (subset of getAll). */
-  async byProvider(sourceName) {
-    const all = await this.getAll();
-    return all.filter((m) => m.source === sourceName);
-  }
-  /** True iff some source currently reports the given model id. */
-  async has(modelId) {
-    const all = await this.getAll();
-    return all.some((m) => m.id === modelId);
-  }
-  /** Force a synchronous refresh of every source — used after a 404. */
-  async refresh() {
-    for (const s of this.sources) {
-      const state = this.states.get(s.name);
-      if (state === void 0) continue;
-      state.fetchedAt = 0;
-      state.value = null;
-    }
-    return this.getAll();
-  }
-  /**
-   * Probe one source. Returns:
-   *  - cached value if still fresh
-   *  - cached value AND kicks a background refresh if stale-but-not-expired
-   *  - blocks on the source if no cache or fully expired
-   *
-   * Source errors yield an empty list (logged) so one bad source can't
-   * poison the union.
-   */
-  async probeOne(source) {
-    const state = this.getState(source.name);
-    const age = this.now() - state.fetchedAt;
-    if (state.value !== null && age < this.ttlMs) {
-      return state.value;
-    }
-    if (state.value !== null && age < this.staleTtlMs) {
-      state.inFlight ??= this.fetchSource(source).finally(() => {
-        state.inFlight = null;
-      });
-      return state.value;
-    }
-    if (state.inFlight !== null) return state.inFlight;
-    state.inFlight = this.fetchSource(source).finally(() => {
-      state.inFlight = null;
-    });
-    return state.inFlight;
-  }
-  async fetchSource(source) {
-    const state = this.getState(source.name);
-    try {
-      const raw = await source.listModels();
-      const value = raw.map((m) => normaliseEntry(m, source));
-      state.value = value;
-      state.fetchedAt = this.now();
-      return value;
-    } catch (e) {
-      logger.warn("AvailableModelsCache source probe failed", {
-        source: source.name,
-        error: e instanceof Error ? e.message : String(e)
-      });
-      return state.value ?? [];
-    }
-  }
-  getState(name) {
-    const state = this.states.get(name);
-    if (state === void 0) {
-      throw new Error(`AvailableModelsCache: unknown source "${name}"`);
-    }
-    return state;
-  }
-};
-function normaliseEntry(raw, source) {
-  const slash = raw.id.indexOf("/");
-  if (slash > 0 && slash < raw.id.length - 1) {
-    return { id: raw.id, source: source.name, provider: raw.id.slice(0, slash) };
-  }
-  if (source.providerHint !== void 0) {
-    return { id: raw.id, source: source.name, provider: source.providerHint };
-  }
-  return { id: raw.id, source: source.name };
-}
-var defaultCache = null;
-function getDefaultAvailableModelsCache() {
-  defaultCache ??= new AvailableModelsCache({ sources: [] });
-  return defaultCache;
-}
-function setDefaultAvailableModelsCache(cache) {
-  defaultCache = cache;
-}
-
-export {
-  AvailableModelsCache,
-  getDefaultAvailableModelsCache,
-  setDefaultAvailableModelsCache
-};
-//# sourceMappingURL=chunk-L2NPJRZZ.js.map

package/dist/chunk-L2NPJRZZ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/config/available-models-cache.ts"],"sourcesContent":["/**\n * AvailableModelsCache (#2540 PR 6 of 8).\n *\n * Central, harness-driven view of what models the runtime can actually\n * dispatch to right now. PR 5 added `listModels()` on direct-API adapters\n * (Anthropic, Google, OpenAI gateway) and on the OpenCode CLI adapter;\n * this cache stitches those probes together into one queryable surface.\n *\n * Design invariants:\n *\n *   1. Sources are the source of truth — if a harness drops a model,\n *      the registry never decides it's still routable. The\n *      `ModelRegistry` (PR 1) answers \"how should this model behave\"\n *      while this cache answers \"is this model routable at all\".\n *\n *   2. Stale-while-revalidate: serve the most recent successful result\n *      while a refresh runs in the background, so callers never block on\n *      a slow `models.list` round-trip.\n *\n *   3. One bad source must not poison the others. A failing `listModels`\n *      logs and is excluded from the next snapshot; remaining sources\n *      remain queryable.\n *\n *   4. No persistence. Process-local cache only — operators restart and\n *      get a fresh probe. Persistence belongs in PR 7 if it's needed.\n */\n\nimport { createLogger } from '../core/logger.js';\n\nconst logger = createLogger({ component: 'available-models-cache' });\n\n/** Default freshness TTL: 5 minutes — matches per-adapter listModels TTL. */\nconst DEFAULT_TTL_MS = 5 * 60 * 1000;\n/** Default stale TTL: 25 minutes — beyond this, callers wait on a refresh. */\nconst DEFAULT_STALE_TTL_MS = 25 * 60 * 1000;\n\n/**\n * One adapter (CLI or API) that can be asked what models it currently has.\n * Exists so this cache doesn't have to know about IModelAdapter vs\n * ICliAdapter — both can adapt themselves to this minimal surface.\n */\nexport interface AvailableModelsSource {\n  /** Stable, human-readable identifier — e.g. `claude`, `gateway-openrouter`. */\n  readonly name: string;\n  /**\n   * Optional vendor-family hint — `anthropic` / `openai` / `google` / etc.\n   * Used to pre-tag entries when the source's own model ids don't carry\n   * a `provider/` prefix (Anthropic API, Google API).\n   */\n  readonly providerHint?: string;\n  /** Probe the underlying surface for currently available models. */\n  listModels(): Promise<readonly { id: string }[]>;\n}\n\n/** One row in the cache: model id + which source first reported it. */\nexport interface AvailableModel {\n  readonly id: string;\n  readonly source: string;\n  /** `provider/` prefix when the source uses one; otherwise the providerHint. */\n  readonly provider?: string;\n}\n\nexport interface AvailableModelsCacheOptions {\n  readonly sources: readonly AvailableModelsSource[];\n  /** Freshness TTL (ms). Defaults to 5 minutes. */\n  readonly ttlMs?: number;\n  /** Beyond this, callers block on the next refresh. Defaults to 25 minutes. */\n  readonly staleTtlMs?: number;\n  /** Override `Date.now` for tests. */\n  readonly now?: () => number;\n}\n\ninterface SourceState {\n  value: readonly AvailableModel[] | null;\n  fetchedAt: number;\n  inFlight: Promise<readonly AvailableModel[]> | null;\n}\n\nexport class AvailableModelsCache {\n  private sources: AvailableModelsSource[];\n  private readonly ttlMs: number;\n  private readonly staleTtlMs: number;\n  private readonly now: () => number;\n  private readonly states: Map<string, SourceState>;\n\n  constructor(options: AvailableModelsCacheOptions) {\n    this.sources = [...options.sources];\n    this.ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;\n    this.staleTtlMs = options.staleTtlMs ?? DEFAULT_STALE_TTL_MS;\n    this.now = options.now ?? Date.now;\n    this.states = new Map();\n    for (const s of this.sources) {\n      this.states.set(s.name, { value: null, fetchedAt: 0, inFlight: null });\n    }\n  }\n\n  /**\n   * Register a source after construction. Used by adapter factories that\n   * wire themselves into the default cache lazily as they're built.\n   * Duplicate names are ignored (first registration wins, on the\n   * assumption that the same factory might run twice in a test session).\n   */\n  addSource(source: AvailableModelsSource): void {\n    if (this.states.has(source.name)) return;\n    this.sources.push(source);\n    this.states.set(source.name, { value: null, fetchedAt: 0, inFlight: null });\n  }\n\n  /**\n   * Remove a previously-registered source. Used by tests + by factories\n   * that want to drop a probe when an adapter is being disposed.\n   */\n  removeSource(name: string): void {\n    this.sources = this.sources.filter((s) => s.name !== name);\n    this.states.delete(name);\n  }\n\n  /**\n   * Returns the union of every source's available models. Stale-while-\n   * revalidate: serve fresh-or-stale immediately, refresh stale entries\n   * in the background. First call (no cache yet) blocks on every source.\n   */\n  async getAll(): Promise<readonly AvailableModel[]> {\n    const probes = this.sources.map((s) => this.probeOne(s));\n    const results = await Promise.all(probes);\n    const out: AvailableModel[] = [];\n    for (const r of results) {\n      for (const m of r) out.push(m);\n    }\n    return out;\n  }\n\n  /** Models reported by one named source (subset of getAll). */\n  async byProvider(sourceName: string): Promise<readonly AvailableModel[]> {\n    const all = await this.getAll();\n    return all.filter((m) => m.source === sourceName);\n  }\n\n  /** True iff some source currently reports the given model id. */\n  async has(modelId: string): Promise<boolean> {\n    const all = await this.getAll();\n    return all.some((m) => m.id === modelId);\n  }\n\n  /** Force a synchronous refresh of every source — used after a 404. */\n  async refresh(): Promise<readonly AvailableModel[]> {\n    for (const s of this.sources) {\n      const state = this.states.get(s.name);\n      if (state === undefined) continue;\n      state.fetchedAt = 0;\n      state.value = null;\n    }\n    return this.getAll();\n  }\n\n  /**\n   * Probe one source. Returns:\n   *  - cached value if still fresh\n   *  - cached value AND kicks a background refresh if stale-but-not-expired\n   *  - blocks on the source if no cache or fully expired\n   *\n   * Source errors yield an empty list (logged) so one bad source can't\n   * poison the union.\n   */\n  private async probeOne(source: AvailableModelsSource): Promise<readonly AvailableModel[]> {\n    const state = this.getState(source.name);\n    const age = this.now() - state.fetchedAt;\n\n    if (state.value !== null && age < this.ttlMs) {\n      return state.value;\n    }\n    if (state.value !== null && age < this.staleTtlMs) {\n      state.inFlight ??= this.fetchSource(source).finally(() => {\n        state.inFlight = null;\n      });\n      return state.value;\n    }\n    if (state.inFlight !== null) return state.inFlight;\n    state.inFlight = this.fetchSource(source).finally(() => {\n      state.inFlight = null;\n    });\n    return state.inFlight;\n  }\n\n  private async fetchSource(source: AvailableModelsSource): Promise<readonly AvailableModel[]> {\n    const state = this.getState(source.name);\n    try {\n      const raw = await source.listModels();\n      const value = raw.map((m) => normaliseEntry(m, source));\n      state.value = value;\n      state.fetchedAt = this.now();\n      return value;\n    } catch (e: unknown) {\n      logger.warn('AvailableModelsCache source probe failed', {\n        source: source.name,\n        error: e instanceof Error ? e.message : String(e),\n      });\n      // Keep the stale value if we have one; otherwise empty.\n      return state.value ?? [];\n    }\n  }\n\n  private getState(name: string): SourceState {\n    const state = this.states.get(name);\n    // Constructor seeds an entry for every configured source, and the public\n    // surface only routes through `this.sources`, so a missing state would\n    // be a programming error — surface it loudly rather than masking it.\n    if (state === undefined) {\n      throw new Error(`AvailableModelsCache: unknown source \"${name}\"`);\n    }\n    return state;\n  }\n}\n\nfunction normaliseEntry(raw: { id: string }, source: AvailableModelsSource): AvailableModel {\n  const slash = raw.id.indexOf('/');\n  if (slash > 0 && slash < raw.id.length - 1) {\n    return { id: raw.id, source: source.name, provider: raw.id.slice(0, slash) };\n  }\n  if (source.providerHint !== undefined) {\n    return { id: raw.id, source: source.name, provider: source.providerHint };\n  }\n  return { id: raw.id, source: source.name };\n}\n\n// ============================================================================\n// Default (process-singleton) instance — used by adapter factories that\n// auto-wire `withModelNotFoundFallback`. Operators that need a different\n// cache (different TTLs, custom sources) can override via\n// `setDefaultAvailableModelsCache` at startup.\n// ============================================================================\n\nlet defaultCache: AvailableModelsCache | null = null;\n\n/**\n * Get (or lazily construct) the process-default cache. Starts with no\n * sources — adapter factories register themselves via `addSource` on\n * construction. Until at least one source is added, the cache returns\n * empty snapshots and `withModelNotFoundFallback` degrades to surfacing\n * the original error (safe).\n */\nexport function getDefaultAvailableModelsCache(): AvailableModelsCache {\n  defaultCache ??= new AvailableModelsCache({ sources: [] });\n  return defaultCache;\n}\n\n/**\n * Override the default cache. Useful for tests and for operators that\n * want a pre-populated cache wired at startup.\n */\nexport function setDefaultAvailableModelsCache(cache: AvailableModelsCache | null): void {\n  defaultCache = cache;\n}\n"],"mappings":"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","names":[]}