nexus-agents 2.157.0 → 2.158.0

package/dist/{chunk-MYSS22Q2.js → chunk-U5KSLUZ6.js}

@@ -1,7 +1,7 @@
 import {
   getRandomProvider,
   getTimeProvider
-} from "./chunk-RCSDD2QY.js";
+} from "./chunk-Q4JNYY2Y.js";
 
 // src/utils/id-utils.ts
 import { randomUUID } from "crypto";
@@ -24,4 +24,4 @@ export {
   generateHyphenId,
   generateUUID
 };
-//# sourceMappingURL=chunk-MYSS22Q2.js.map
+//# sourceMappingURL=chunk-U5KSLUZ6.js.map

package/dist/{chunk-3NT6NAXD.js → chunk-UQOJ2KGW.js}

@@ -1,6 +1,6 @@
 import {
-  lookupInTreeCapability
-} from "./chunk-RCSDD2QY.js";
+  getDefaultRegistry
+} from "./chunk-Q4JNYY2Y.js";
 import {
   getNexusDataDir
 } from "./chunk-DHVMSIT5.js";
@@ -8,16 +8,17 @@ import {
 // src/learning/usage-log.ts
 import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync } from "fs";
 import { dirname, join } from "path";
-function computeCostUSD(modelId, inputTokens, outputTokens) {
-  const cap = lookupInTreeCapability(modelId);
-  if (cap === void 0) return 0;
-  const inputPer1M = cap.pricing?.inputPer1M ?? 0;
-  const outputPer1M = cap.pricing?.outputPer1M ?? 0;
+function computeCostDetail(modelId, inputTokens, outputTokens) {
+  const entry = getDefaultRegistry().getEntry(modelId);
+  const resolvedId = entry.resolvedFrom ?? modelId;
+  const provenance = entry.matchedVia !== void 0 ? { matchedVia: entry.matchedVia } : {};
+  if (entry.pricing === void 0) {
+    return { costUsd: 0, priced: false, resolvedId, ...provenance };
+  }
   const microUsd = Math.round(
-    inputTokens * inputPer1M + outputTokens * outputPer1M
-    // micro-USD per million scaled
+    inputTokens * entry.pricing.inputPer1M + outputTokens * entry.pricing.outputPer1M
   );
-  return microUsd / 1e6;
+  return { costUsd: microUsd / 1e6, priced: true, resolvedId, ...provenance };
 }
 function getUsageLogPath(date = /* @__PURE__ */ new Date()) {
   const year = date.getUTCFullYear();
@@ -118,9 +119,9 @@ function rollupByModel(events) {
 }
 
 export {
-  computeCostUSD,
+  computeCostDetail,
   recordUsageEvent,
   loadUsageEvents,
   rollupByModel
 };
-//# sourceMappingURL=chunk-3NT6NAXD.js.map
+//# sourceMappingURL=chunk-UQOJ2KGW.js.map

package/dist/chunk-UQOJ2KGW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/learning/usage-log.ts"],"sourcesContent":["/**\n * usage-log — append-only per-call usage events with cost.\n *\n * Source: Issue #2469 (epic #2467 child).\n *\n * For operators running against metered API gateways, per-call cost +\n * tokens + latency is the data they need to manage spend. This module\n * provides three things:\n *\n *   1. `recordUsageEvent(event)` — append a per-call record to a JSONL\n *      log under <NEXUS_DATA_DIR>/usage/usage-YYYY-MM.jsonl.\n *   2. `loadUsageEvents({...})` — read events for a window, filtered\n *      by model / category.\n *   3. `computeCostDetail(modelId, inputTokens, outputTokens)` (and its\n *      thin wrapper `computeCostUSD`) — compute cost from the FULL model\n *      registry pricing chain (manifest > in-tree > models.dev > generated\n *      LiteLLM catalog), including the #4164 normalized/identity resolution\n *      tier for decorated gateway model ids. A model with no pricing\n *      anywhere in the chain is reported as `priced: false` so consumers\n *      can treat the missing cost as UNMEASURED (#3855), never a real $0.\n *\n * The `usage` CLI command (cli/usage-command.ts) consumes this for the\n * operator dashboard. Existing OutcomeStore is intentionally untouched\n * — its schema is for routing/learning signals, not billing.\n */\n\nimport { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\n\nimport { getNexusDataDir } from '../config/nexus-data-dir.js';\n// NOTE: only the FUNCTION is imported here — `getDefaultRegistry()` must never\n// be CALLED at module scope (#3185 bootstrap hazard: first construction reads\n// the manifest overlay/snapshot from disk). All calls happen at invocation\n// time inside computeCostDetail.\nimport { getDefaultRegistry, type MatchedVia } from '../config/model-registry.js';\n\nexport interface UsageEvent {\n  /** ISO 8601 timestamp of the call. */\n  readonly timestamp: string;\n  /** Model identifier (e.g., 'claude-sonnet-4', 'gpt-4o'). */\n  readonly modelId: string;\n  /** Provider/adapter (e.g., 'anthropic', 'openai', 'openai-compat'). */\n  readonly providerId: string;\n  /** Token counts. */\n  readonly inputTokens: number;\n  readonly outputTokens: number;\n  /**\n   * Cost in USD. Computed at write time from the full model-registry pricing\n   * chain (see `computeCostDetail`). 0 with `priced: false` means the model\n   * was UNPRICED (cost unknown), not a real $0 — check `priced` before\n   * treating this as a measured figure.\n   */\n  readonly usdCost: number;\n  /** Wall-clock latency in milliseconds. */\n  readonly latencyMs: number;\n  /** Whether the call succeeded. */\n  readonly success: boolean;\n  /**\n   * Optional task category — populated when the call was made on behalf of\n   * a routed task (so aggregation can roll up by category).\n   */\n  readonly category?: string;\n  /** Optional failure code when success === false. */\n  readonly errorCode?: string;\n  /**\n   * Whether pricing data existed for the model at write time (#4165), so\n   * audit can distinguish a real $0 from an unpriced model. Absent on lines\n   * written before this field existed.\n   */\n  readonly priced?: boolean;\n  /**\n   * Pricing provenance: the canonical registry id whose pricing was applied\n   * (the entry's `resolvedFrom` when the #4164 fuzzy tier matched a decorated\n   * id, else the caller's model id). Present only when `priced` is true.\n   */\n  readonly priceSource?: string;\n}\n\n/** Result of a pricing-aware cost computation (#4165). */\nexport interface CostDetail {\n  /** Cost in USD. Always 0 when `priced` is false — an unknown, not a $0. */\n  readonly costUsd: number;\n  /** Whether the resolved registry entry carried pricing data. */\n  readonly priced: boolean;\n  /**\n   * Canonical id the pricing/metadata came from: the entry's `resolvedFrom`\n   * when the #4164 fuzzy tier matched a decorated id, else the caller's id.\n   */\n  readonly resolvedId: string;\n  /** Fuzzy-resolution provenance (#4164), passed through from the entry. */\n  readonly matchedVia?: MatchedVia;\n}\n\n/**\n * Compute cost in USD given a model and token counts, with pricing\n * provenance. Reads the FULL registry chain via\n * `getDefaultRegistry().getEntry()` — manifest > in-tree > models.dev >\n * generated LiteLLM catalog, plus the #4164 normalized/identity tier that\n * resolves decorated model names from OpenAI-compatible gateways to their\n * canonical entry's pricing.\n *\n * `priced: false` (with `costUsd: 0`) means NO pricing existed anywhere in\n * the chain — consumers must treat the cost as UNMEASURED (#3855), never a\n * real $0. Operators can add pricing for gateway-only models via the\n * models-manifest overlay.\n */\nexport function computeCostDetail(\n  modelId: string,\n  inputTokens: number,\n  outputTokens: number\n): CostDetail {\n  // Registry read happens at INVOCATION time, never module load — first\n  // construction touches the filesystem (#3185 bootstrap hazard).\n  const entry = getDefaultRegistry().getEntry(modelId);\n  const resolvedId = entry.resolvedFrom ?? modelId;\n  const provenance = entry.matchedVia !== undefined ? { matchedVia: entry.matchedVia } : {};\n  if (entry.pricing === undefined) {\n    return { costUsd: 0, priced: false, resolvedId, ...provenance };\n  }\n  // Multiply token counts by per-million rate then divide. Use Math.round\n  // at micro-USD precision so JSONL files don't drift to floating-point\n  // noise on small calls.\n  const microUsd = Math.round(\n    inputTokens * entry.pricing.inputPer1M + outputTokens * entry.pricing.outputPer1M\n  );\n  return { costUsd: microUsd / 1_000_000, priced: true, resolvedId, ...provenance };\n}\n\n/**\n * Thin wrapper over {@link computeCostDetail} returning only the USD figure.\n * Returns 0 both for a genuinely free model and for a model with no pricing\n * data — callers that must tell those apart (unpriced ⇒ UNMEASURED, #3855)\n * should use `computeCostDetail` and check `priced`.\n */\nexport function computeCostUSD(modelId: string, inputTokens: number, outputTokens: number): number {\n  return computeCostDetail(modelId, inputTokens, outputTokens).costUsd;\n}\n\n/** Resolve the active usage log path for the current month. */\nexport function getUsageLogPath(date: Date = new Date()): string {\n  const year = date.getUTCFullYear();\n  const month = String(date.getUTCMonth() + 1).padStart(2, '0');\n  return join(getNexusDataDir(), 'usage', `usage-${String(year)}-${month}.jsonl`);\n}\n\n/**\n * Append a usage event to the current month's log. Best-effort — failures\n * are silent (we don't want to fail a successful model call because we\n * couldn't write a log line).\n */\nexport function recordUsageEvent(event: UsageEvent): void {\n  try {\n    const path = getUsageLogPath(new Date(event.timestamp));\n    mkdirSync(dirname(path), { recursive: true });\n    appendFileSync(path, `${JSON.stringify(event)}\\n`, 'utf-8');\n  } catch {\n    // Intentionally silent — telemetry must not break user calls.\n  }\n}\n\nexport interface LoadUsageOptions {\n  /** Restrict to events at or after this ISO timestamp. */\n  readonly sinceIso?: string;\n  /** Restrict to events before this ISO timestamp. */\n  readonly untilIso?: string;\n  /** Only events for this model. */\n  readonly modelId?: string;\n  /** Only events for this category. */\n  readonly category?: string;\n}\n\nfunction listUsageFiles(dir: string): readonly string[] {\n  if (!existsSync(dir)) return [];\n  try {\n    return readdirSync(dir).filter((f) => f.startsWith('usage-') && f.endsWith('.jsonl'));\n  } catch {\n    return [];\n  }\n}\n\ninterface LoadFilter {\n  readonly sinceMs: number;\n  readonly untilMs: number;\n  readonly modelId: string | undefined;\n  readonly category: string | undefined;\n}\n\nfunction eventMatches(parsed: UsageEvent, f: LoadFilter): boolean {\n  const ts = Date.parse(parsed.timestamp);\n  if (ts < f.sinceMs || ts >= f.untilMs) return false;\n  if (f.modelId !== undefined && parsed.modelId !== f.modelId) return false;\n  if (f.category !== undefined && parsed.category !== f.category) return false;\n  return true;\n}\n\nfunction parseFileLines(filePath: string, filter: LoadFilter): readonly UsageEvent[] {\n  let content: string;\n  try {\n    content = readFileSync(filePath, 'utf-8');\n  } catch {\n    return [];\n  }\n  const out: UsageEvent[] = [];\n  for (const line of content.split('\\n')) {\n    if (line.trim() === '') continue;\n    try {\n      const parsed = JSON.parse(line) as UsageEvent;\n      if (eventMatches(parsed, filter)) out.push(parsed);\n    } catch {\n      // Skip malformed line; keep reading.\n      continue;\n    }\n  }\n  return out;\n}\n\n/**\n * Load all usage events from disk that match the filter. Reads every\n * monthly log file under the data dir; for sub-second filtering at scale\n * a future PR can index by month, but linear scan is fine at the\n * \"operator dashboard\" scale this command targets.\n */\nexport function loadUsageEvents(opts: LoadUsageOptions = {}): readonly UsageEvent[] {\n  const dir = join(getNexusDataDir(), 'usage');\n  const files = listUsageFiles(dir);\n  if (files.length === 0) return [];\n  const filter: LoadFilter = {\n    sinceMs: opts.sinceIso !== undefined ? Date.parse(opts.sinceIso) : Number.NEGATIVE_INFINITY,\n    untilMs: opts.untilIso !== undefined ? Date.parse(opts.untilIso) : Number.POSITIVE_INFINITY,\n    modelId: opts.modelId,\n    category: opts.category,\n  };\n  const events: UsageEvent[] = [];\n  for (const f of files) {\n    events.push(...parseFileLines(join(dir, f), filter));\n  }\n  return events;\n}\n\nexport interface ModelRollup {\n  readonly modelId: string;\n  readonly providerId: string;\n  readonly callCount: number;\n  readonly successCount: number;\n  readonly successRate: number;\n  readonly totalInputTokens: number;\n  readonly totalOutputTokens: number;\n  readonly totalUsdCost: number;\n  readonly avgLatencyMs: number;\n  readonly costPerSuccessUsd: number;\n}\n\n/**\n * Aggregate events into per-model rollups. Sorted by total cost descending\n * — the model burning the most money at top. Useful for \"where is my spend\n * going?\" investigations.\n */\nexport function rollupByModel(events: readonly UsageEvent[]): readonly ModelRollup[] {\n  const groups = new Map<string, UsageEvent[]>();\n  for (const e of events) {\n    const arr = groups.get(e.modelId);\n    if (arr === undefined) groups.set(e.modelId, [e]);\n    else arr.push(e);\n  }\n  const rollups: ModelRollup[] = [];\n  for (const [modelId, group] of groups) {\n    const callCount = group.length;\n    const successCount = group.filter((e) => e.success).length;\n    const totalInputTokens = group.reduce((s, e) => s + e.inputTokens, 0);\n    const totalOutputTokens = group.reduce((s, e) => s + e.outputTokens, 0);\n    const totalUsdCost = group.reduce((s, e) => s + e.usdCost, 0);\n    const totalLatency = group.reduce((s, e) => s + e.latencyMs, 0);\n    const successRate = callCount === 0 ? 0 : successCount / callCount;\n    const avgLatencyMs = callCount === 0 ? 0 : totalLatency / callCount;\n    const costPerSuccessUsd = successCount === 0 ? totalUsdCost : totalUsdCost / successCount;\n    rollups.push({\n      modelId,\n      providerId: group[0]?.providerId ?? 'unknown',\n      callCount,\n      successCount,\n      successRate,\n      totalInputTokens,\n      totalOutputTokens,\n      totalUsdCost,\n      avgLatencyMs,\n      costPerSuccessUsd,\n    });\n  }\n  return rollups.sort((a, b) => b.totalUsdCost - a.totalUsdCost);\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-TKCXD36G.js → chunk-VKVJSPHJ.js}

@@ -1,9 +1,9 @@
 import {
   createAutoAdapter
-} from "./chunk-M532SJS6.js";
+} from "./chunk-S7PFS6PX.js";
 import {
   mapModelErrorToCategory
-} from "./chunk-GYWYCCJC.js";
+} from "./chunk-YQRP5NST.js";
 import {
   CLI_NAMES,
   CircularBuffer,
@@ -24,7 +24,7 @@ import {
   ok,
   recordRateLimitEvent,
   toRateLimitError
-} from "./chunk-RCSDD2QY.js";
+} from "./chunk-Q4JNYY2Y.js";
 
 // src/agents/collaboration/event-bus-helpers.ts
 import { randomUUID } from "crypto";
@@ -1041,4 +1041,4 @@ export {
   getGlobalRegistry,
   resetGlobalRegistry
 };
-//# sourceMappingURL=chunk-TKCXD36G.js.map
+//# sourceMappingURL=chunk-VKVJSPHJ.js.map

package/dist/{chunk-3S2OPUGU.js → chunk-XLJCXM7L.js}

@@ -2,7 +2,7 @@ import {
   createLogger,
   err,
   ok
-} from "./chunk-RCSDD2QY.js";
+} from "./chunk-Q4JNYY2Y.js";
 
 // src/scm/token-resolver.ts
 import { execFile } from "child_process";
@@ -87,4 +87,4 @@ export {
   hasToken,
   getTokenEnvVars
 };
-//# sourceMappingURL=chunk-3S2OPUGU.js.map
+//# sourceMappingURL=chunk-XLJCXM7L.js.map

package/dist/{chunk-HWG437YQ.js → chunk-YH5U3XCP.js}

@@ -8,7 +8,7 @@ import {
   getErrorMessage,
   ok,
   parseBoolEnv
-} from "./chunk-RCSDD2QY.js";
+} from "./chunk-Q4JNYY2Y.js";
 
 // src/cli/research-helpers-io.ts
 import * as fs2 from "fs/promises";
@@ -146,4 +146,4 @@ export {
   loadPapersRegistry,
   savePapersRegistry
 };
-//# sourceMappingURL=chunk-HWG437YQ.js.map
+//# sourceMappingURL=chunk-YH5U3XCP.js.map

package/dist/{chunk-AEPCCXMK.js → chunk-YMMX6ELC.js}

@@ -2,14 +2,14 @@ import {
   CircuitBreakerRegistry,
   CircuitError,
   mapCliErrorToCategory
-} from "./chunk-GYWYCCJC.js";
+} from "./chunk-YQRP5NST.js";
 import {
   createLogger,
   err,
   getFallbackChainForCategory,
   getTimeProvider,
   ok
-} from "./chunk-RCSDD2QY.js";
+} from "./chunk-Q4JNYY2Y.js";
 
 // src/cli-adapters/cli-circuit-breaker.ts
 var CATEGORY_TO_FALLBACK = {
@@ -152,4 +152,4 @@ export {
   CliCircuitBreakerIntegration,
   createCliCircuitBreakerIntegration
 };
-//# sourceMappingURL=chunk-AEPCCXMK.js.map
+//# sourceMappingURL=chunk-YMMX6ELC.js.map

package/dist/{chunk-GYWYCCJC.js → chunk-YQRP5NST.js}

@@ -5,7 +5,7 @@ import {
   getErrorMessage,
   getTimeProvider,
   ok
-} from "./chunk-RCSDD2QY.js";
+} from "./chunk-Q4JNYY2Y.js";
 
 // src/cli-adapters/circuit-breaker-types.ts
 var CircuitErrorCode = {
@@ -375,4 +375,4 @@ export {
   mapCliErrorToCategory,
   mapModelErrorToCategory
 };
-//# sourceMappingURL=chunk-GYWYCCJC.js.map
+//# sourceMappingURL=chunk-YQRP5NST.js.map

package/dist/{cli-circuit-breaker-Q43YSBCB.js → cli-circuit-breaker-MLVJXLK6.js}

@@ -1,9 +1,9 @@
 import {
   CliCircuitBreakerIntegration,
   createCliCircuitBreakerIntegration
-} from "./chunk-AEPCCXMK.js";
-import "./chunk-GYWYCCJC.js";
-import "./chunk-RCSDD2QY.js";
+} from "./chunk-YMMX6ELC.js";
+import "./chunk-YQRP5NST.js";
+import "./chunk-Q4JNYY2Y.js";
 import "./chunk-NL7SZQPW.js";
 import "./chunk-DHVMSIT5.js";
 import "./chunk-ZPWHCABL.js";
@@ -11,4 +11,4 @@ export {
   CliCircuitBreakerIntegration,
   createCliCircuitBreakerIntegration
 };
-//# sourceMappingURL=cli-circuit-breaker-Q43YSBCB.js.map
+//# sourceMappingURL=cli-circuit-breaker-MLVJXLK6.js.map

package/dist/cli.d.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { C as CliNameLiteral, K as VoteThreshold, E as ErrorPolicy, N as NoQuorumPolicy } from './consensus-vote-types-BNBMB415.js';
+import { C as CliNameLiteral, K as VoteThreshold, E as ErrorPolicy, N as NoQuorumPolicy } from './consensus-vote-types-DB3SmULO.js';
 import 'zod';
 
 /**

package/dist/cli.js

@@ -2,7 +2,7 @@
 import {
   buildOpenAICompatAdapters,
   readOpenAICompatEnv
-} from "./chunk-6ZKQRTTQ.js";
+} from "./chunk-CTL5HUZZ.js";
 import {
   calculateConsensus,
   countByCategory,
@@ -17,13 +17,13 @@ import {
   generateSummary,
   parseFindings,
   sumFindings
-} from "./chunk-HUN7CEAU.js";
-import "./chunk-SCJ2EB6Z.js";
+} from "./chunk-KS622JST.js";
+import "./chunk-FWW5GCEH.js";
 import {
   setupCommandAsync,
   verifyCommand
-} from "./chunk-553QYRXJ.js";
-import "./chunk-5ULXLPVP.js";
+} from "./chunk-IQVHJD4O.js";
+import "./chunk-4IXC6V6O.js";
 import {
   AuthHandler,
   DEFAULT_EXPERTS,
@@ -142,9 +142,9 @@ import {
   validateCommand,
   validateWorkflow,
   wrapInMarkdownFence
-} from "./chunk-3SE57WOV.js";
-import "./chunk-EJ3MAR5M.js";
-import "./chunk-5FH7QZIT.js";
+} from "./chunk-SPOES3DZ.js";
+import "./chunk-CSHFTQA7.js";
+import "./chunk-6MCSD37T.js";
 import "./chunk-HFOQKCD2.js";
 import "./chunk-3ACDP4E6.js";
 import {
@@ -170,11 +170,11 @@ import {
   loadConfig,
   runDoctor,
   validateNexusEnv
-} from "./chunk-OXYGRB4C.js";
-import "./chunk-AEPCCXMK.js";
+} from "./chunk-J6OUXCR3.js";
+import "./chunk-YMMX6ELC.js";
 import {
   shutdownExpertBridge
-} from "./chunk-BGAK4N74.js";
+} from "./chunk-LSWGHIJK.js";
 import {
   ConsensusVoteInputSchema,
   DEFAULT_VOTE_TIMEOUT_MS,
@@ -184,25 +184,25 @@ import {
   executeVoting,
   mapOutcomeToDecision,
   registerConsensusVoteTool
-} from "./chunk-TT4ZITRU.js";
+} from "./chunk-Q7TALELN.js";
 import {
   loadUsageEvents,
   rollupByModel
-} from "./chunk-3NT6NAXD.js";
+} from "./chunk-UQOJ2KGW.js";
 import {
   synthesizeResearch
-} from "./chunk-XGUZ2OQK.js";
+} from "./chunk-OOGGQ2NA.js";
 import {
   classifyTrust,
   createFullGitHubProvider,
   evaluatePolicy,
   parsePRUrl
-} from "./chunk-YZQXCCEA.js";
-import "./chunk-NELFMLLR.js";
+} from "./chunk-6B5VQ2SY.js";
+import "./chunk-7J3AAPH5.js";
 import {
   ReputationCache,
   sanitizeInput
-} from "./chunk-UAGYCCHY.js";
+} from "./chunk-S3H4VWN5.js";
 import {
   ImprovementReviewInputSchema,
   calculateFitnessScore,
@@ -216,11 +216,11 @@ import {
   registerImprovementReviewTool,
   runImprovementReview,
   scanForSecrets
-} from "./chunk-LZ2LHYDO.js";
+} from "./chunk-K6HJLOPA.js";
 import {
   createDefaultPolicyFirewall
-} from "./chunk-PZDDA6IW.js";
-import "./chunk-BM26VPV5.js";
+} from "./chunk-2O63LDYB.js";
+import "./chunk-42ZSRIEX.js";
 import {
   PaperStatusSchema,
   createResearchIssue,
@@ -243,32 +243,32 @@ import {
   loadSourcesRegistry,
   rankDiscoveredItems,
   saveSourcesRegistry
-} from "./chunk-O7VPOR5A.js";
+} from "./chunk-R76LLKT2.js";
 import {
   resolveToken
-} from "./chunk-3S2OPUGU.js";
+} from "./chunk-XLJCXM7L.js";
 import {
   loadPapersRegistry,
   loadTechniquesRegistry,
   savePapersRegistry
-} from "./chunk-HWG437YQ.js";
+} from "./chunk-YH5U3XCP.js";
 import "./chunk-NUBSJGQZ.js";
 import {
   MemoryError,
   shutdownToolMemory
-} from "./chunk-7YOJXOFN.js";
+} from "./chunk-GG7MGRQ6.js";
 import {
   capitalize,
   capitalizeKebab,
   truncateSentence
 } from "./chunk-6T3EPABN.js";
-import "./chunk-IILTUCFB.js";
+import "./chunk-DSUFV2ZN.js";
 import "./chunk-ZM4O442V.js";
 import "./chunk-PINS44XA.js";
 import "./chunk-KSQSWEFH.js";
 import {
   createUnifiedRegistry
-} from "./chunk-TKCXD36G.js";
+} from "./chunk-VKVJSPHJ.js";
 import {
   NEXUS_SUBPROCESS_DEPTH_ENV,
   createAllAdapters,
@@ -276,14 +276,14 @@ import {
   isRecord,
   probeAllClis,
   readSubprocessDepth
-} from "./chunk-M532SJS6.js";
-import "./chunk-JZ4PCEEN.js";
+} from "./chunk-S7PFS6PX.js";
+import "./chunk-55ZDYUBT.js";
 import {
   DEFAULTS
-} from "./chunk-TNRTP5FW.js";
-import "./chunk-GYWYCCJC.js";
-import "./chunk-YGYJUPVX.js";
-import "./chunk-MYSS22Q2.js";
+} from "./chunk-I32MYAT5.js";
+import "./chunk-YQRP5NST.js";
+import "./chunk-RI3BFANI.js";
+import "./chunk-U5KSLUZ6.js";
 import {
   API_TIMEOUTS,
   AgentCapability,
@@ -357,7 +357,7 @@ import {
   validateTimeout,
   writeEmptyLine,
   writeLine
-} from "./chunk-RCSDD2QY.js";
+} from "./chunk-Q4JNYY2Y.js";
 import "./chunk-NL7SZQPW.js";
 import {
   applyPortableMode,
@@ -4035,7 +4035,7 @@ ${file.patch}
         violations: policyResult.violations
       });
     }
-    const { formatReviewComment: formatReviewComment2 } = await import("./pr-reviewer-helpers-UF42XZB6.js");
+    const { formatReviewComment: formatReviewComment2 } = await import("./pr-reviewer-helpers-VT4DR5BC.js");
     const body = formatReviewComment2(result);
     const postResult = await provider.createReview(pr.prNumber, body, result.decision);
     if (!postResult.ok) {
@@ -17859,7 +17859,7 @@ function startImprovementReviewScheduler(options) {
   let running = false;
   const runOnce = async () => {
     try {
-      const { runImprovementReview: runImprovementReview2, ImprovementReviewInputSchema: ImprovementReviewInputSchema2 } = await import("./improvement-review-H5BQ2JXK.js");
+      const { runImprovementReview: runImprovementReview2, ImprovementReviewInputSchema: ImprovementReviewInputSchema2 } = await import("./improvement-review-XXRDVOJT.js");
       const input = ImprovementReviewInputSchema2.parse({ fileIssues });
       const result = await runImprovementReview2(input, { logger: logger19 });
       logger19.info("Scheduled improvement_review complete", {
@@ -19898,7 +19898,7 @@ function adaptConfigToLibrary(config) {
 }
 function createBeliefPromoter() {
   return async (event) => {
-    const { getToolMemory } = await import("./tool-memory-UQH2FTAS.js");
+    const { getToolMemory } = await import("./tool-memory-YLCJZVMV.js");
     const tm = getToolMemory();
     await tm.recordBelief(
       `skill:${event.name}`,
@@ -21010,7 +21010,7 @@ async function handleResearchCommand(args) {
   }
 }
 async function handleRegistryCommand(args) {
-  const { registryCommand, isValidRegistrySubcommand, formatRegistryUsage } = await import("./registry-command-EZ7735GC.js");
+  const { registryCommand, isValidRegistrySubcommand, formatRegistryUsage } = await import("./registry-command-QVBYBBWR.js");
   const subcommand = args.subcommand;
   if (!isValidRegistrySubcommand(subcommand)) {
     process.stdout.write(`${formatRegistryUsage()}
@@ -21058,7 +21058,7 @@ async function handleVerifyCommand(args) {
 async function handleDoctorCommand(args) {
   const exitCode = await doctorCommand({ fix: args.options.fix });
   if (args.options.deep) {
-    const { runDeepDiagnostics: runDeepDiagnostics2, formatDeepDiagnostics: formatDeepDiagnostics2 } = await import("./doctor-deep-RAN4HGOH.js");
+    const { runDeepDiagnostics: runDeepDiagnostics2, formatDeepDiagnostics: formatDeepDiagnostics2 } = await import("./doctor-deep-KUB4HPCS.js");
     const diag = runDeepDiagnostics2();
     process.stdout.write(formatDeepDiagnostics2(diag) + "\n");
   }
@@ -21108,7 +21108,7 @@ async function runInitPortableFlow(args) {
   return cliExit(result.success ? EXIT_CODES.SUCCESS : EXIT_CODES.SERVER_START_FAILED);
 }
 async function runInitOpencodeFlow(args) {
-  const { runInitOpencode } = await import("./init-opencode-KHODCXA6.js");
+  const { runInitOpencode } = await import("./init-opencode-RNSCHZIW.js");
   const opencodePath = args.options.opencode;
   if (opencodePath === void 0 || opencodePath === "") {
     process.stderr.write("Error: --opencode requires a path argument.\n");
@@ -21134,7 +21134,7 @@ async function runInitOpencodeFlow(args) {
   return cliExit(EXIT_CODES.SUCCESS);
 }
 async function renderOpencodeValidate(opencodePath) {
-  const { runOpencodeValidate } = await import("./init-opencode-KHODCXA6.js");
+  const { runOpencodeValidate } = await import("./init-opencode-RNSCHZIW.js");
   const result = await runOpencodeValidate(opencodePath);
   if (!result.ok) {
     process.stderr.write(`init --opencode --validate: ${result.reason ?? "failed"}
@@ -21173,7 +21173,7 @@ async function handleSetupCommandAsync(args) {
   return cliExitFromStatus(exitCode);
 }
 async function runCustomApiSetup(args) {
-  const { configureCustomApi } = await import("./setup-custom-api-NVS4EPBG.js");
+  const { configureCustomApi } = await import("./setup-custom-api-H6FJ5VWL.js");
   const baseUrl = args.options.customApi;
   if (baseUrl === void 0) return EXIT_CODES.SERVER_START_FAILED;
   const input = {

package/dist/{composite-router-5UHJFOB3.js → composite-router-FTECAR4U.js}

@@ -4,7 +4,7 @@ import {
   CompositeRoutingError,
   DEFAULT_COMPOSITE_CONFIG,
   createCompositeRouter
-} from "./chunk-RCSDD2QY.js";
+} from "./chunk-Q4JNYY2Y.js";
 import "./chunk-NL7SZQPW.js";
 import "./chunk-DHVMSIT5.js";
 import "./chunk-ZPWHCABL.js";
@@ -15,4 +15,4 @@ export {
   DEFAULT_COMPOSITE_CONFIG,
   createCompositeRouter
 };
-//# sourceMappingURL=composite-router-5UHJFOB3.js.map
+//# sourceMappingURL=composite-router-FTECAR4U.js.map

package/dist/{consensus-vote-7EBYYBCQ.js → consensus-vote-MMZTCPL7.js}

@@ -8,23 +8,23 @@ import {
   registerConsensusVoteTool,
   resetCorrelationTracker,
   runConsensusForGoal
-} from "./chunk-TT4ZITRU.js";
-import "./chunk-3NT6NAXD.js";
-import "./chunk-PZDDA6IW.js";
-import "./chunk-BM26VPV5.js";
-import "./chunk-7YOJXOFN.js";
+} from "./chunk-Q7TALELN.js";
+import "./chunk-UQOJ2KGW.js";
+import "./chunk-2O63LDYB.js";
+import "./chunk-42ZSRIEX.js";
+import "./chunk-GG7MGRQ6.js";
 import "./chunk-6T3EPABN.js";
-import "./chunk-IILTUCFB.js";
+import "./chunk-DSUFV2ZN.js";
 import "./chunk-PINS44XA.js";
 import "./chunk-KSQSWEFH.js";
-import "./chunk-TKCXD36G.js";
-import "./chunk-M532SJS6.js";
-import "./chunk-JZ4PCEEN.js";
-import "./chunk-TNRTP5FW.js";
-import "./chunk-GYWYCCJC.js";
-import "./chunk-YGYJUPVX.js";
-import "./chunk-MYSS22Q2.js";
-import "./chunk-RCSDD2QY.js";
+import "./chunk-VKVJSPHJ.js";
+import "./chunk-S7PFS6PX.js";
+import "./chunk-55ZDYUBT.js";
+import "./chunk-I32MYAT5.js";
+import "./chunk-YQRP5NST.js";
+import "./chunk-RI3BFANI.js";
+import "./chunk-U5KSLUZ6.js";
+import "./chunk-Q4JNYY2Y.js";
 import "./chunk-NL7SZQPW.js";
 import "./chunk-DHVMSIT5.js";
 import "./chunk-ZPWHCABL.js";
@@ -39,4 +39,4 @@ export {
   resetCorrelationTracker,
   runConsensusForGoal
 };
-//# sourceMappingURL=consensus-vote-7EBYYBCQ.js.map
+//# sourceMappingURL=consensus-vote-MMZTCPL7.js.map

package/dist/{consensus-vote-types-BNBMB415.d.ts → consensus-vote-types-DB3SmULO.d.ts}

@@ -86,12 +86,14 @@ type Pricing = z.infer<typeof PricingSchema>;
  *
  * Design decisions that the fixture tests pin (#3855 acceptance criteria):
  *
- *  - **Missing cost is UNMEASURED, not zero.** A voter with no token counts
- *    (e.g. a CLI-subscription adapter that doesn't report usage, or an error
- *    vote that never reached the model) is counted in `unmeasuredVoters` and
- *    contributes 0 to the totals — but the summary records that the total is a
- *    floor, not an exact figure (`measured` < `voterCount`). Treating unmeasured
- *    as a true $0 would silently understate spend; this keeps the honesty.
+ *  - **Missing cost is UNMEASURED, not zero.** A voter with no computable cost
+ *    — no usage report at all (a CLI-subscription adapter, an error vote that
+ *    never reached the model) or a model with no pricing anywhere in the
+ *    registry chain (#4165) — is counted in `unmeasuredVoters` and contributes
+ *    0 to the COST totals (reported tokens still count toward consumption) —
+ *    but the summary records that the total is a floor, not an exact figure
+ *    (`measured` < `voterCount`). Treating unmeasured as a true $0 would
+ *    silently understate spend; this keeps the honesty.
  *  - **Plan mode records 0-cost but keeps tokens.** Under `NEXUS_BILLING_MODE=plan`
  *    the spend is pre-covered by a subscription, so cost is recorded as $0 while
  *    token counts are preserved (so the operator can still see consumption and
@@ -113,8 +115,9 @@ interface VoterCostBreakdown {
     /** Effective cost after billing-mode application (0 in plan mode). */
     readonly costUsd: number;
     /**
-     * True when this voter reported NO usage at all (no tokens, no cost). Its
-     * zeros are placeholders, not a measured $0 / 0-token call.
+     * True when no cost was computable for this voter — no usage report at all,
+     * or a token-reporting call on an unpriced model (#4165). Its cost zero is a
+     * placeholder, not a measured $0.
      */
     readonly unmeasured: boolean;
 }
@@ -136,9 +139,12 @@ interface DecisionCostSummary {
     readonly billingMode: DecisionBillingMode;
     /** Total voters folded into this decision. */
     readonly voterCount: number;
-    /** Voters that reported usage (tokens and/or cost). */
+    /** Voters with a computable cost (`costUsd` present on the input). */
     readonly measuredVoters: number;
-    /** Voters that reported no usage at all (counted, not zeroed-as-fact). */
+    /**
+     * Voters whose cost could not be computed — no usage report, or an unpriced
+     * model (#4165). Counted, not zeroed-as-fact.
+     */
     readonly unmeasuredVoters: number;
     readonly totalInputTokens: number;
     readonly totalOutputTokens: number;

package/dist/{context-retriever-33SGXV33.js → context-retriever-MPZ7T4VA.js}

@@ -5,17 +5,17 @@ import {
   inferTaskCategory,
   selectRelevantResearch,
   summarizeContextForPrompt
-} from "./chunk-O7VPOR5A.js";
-import "./chunk-3S2OPUGU.js";
-import "./chunk-HWG437YQ.js";
+} from "./chunk-R76LLKT2.js";
+import "./chunk-XLJCXM7L.js";
+import "./chunk-YH5U3XCP.js";
 import "./chunk-NUBSJGQZ.js";
-import "./chunk-7YOJXOFN.js";
+import "./chunk-GG7MGRQ6.js";
 import "./chunk-6T3EPABN.js";
-import "./chunk-IILTUCFB.js";
+import "./chunk-DSUFV2ZN.js";
 import "./chunk-PINS44XA.js";
 import "./chunk-KSQSWEFH.js";
-import "./chunk-MYSS22Q2.js";
-import "./chunk-RCSDD2QY.js";
+import "./chunk-U5KSLUZ6.js";
+import "./chunk-Q4JNYY2Y.js";
 import "./chunk-NL7SZQPW.js";
 import "./chunk-DHVMSIT5.js";
 import "./chunk-ZPWHCABL.js";
@@ -27,4 +27,4 @@ export {
   selectRelevantResearch,
   summarizeContextForPrompt
 };
-//# sourceMappingURL=context-retriever-33SGXV33.js.map
+//# sourceMappingURL=context-retriever-MPZ7T4VA.js.map

package/dist/{doctor-deep-RAN4HGOH.js → doctor-deep-KUB4HPCS.js}

@@ -1,8 +1,8 @@
 import {
   formatDeepDiagnostics,
   runDeepDiagnostics
-} from "./chunk-SCJ2EB6Z.js";
-import "./chunk-RCSDD2QY.js";
+} from "./chunk-FWW5GCEH.js";
+import "./chunk-Q4JNYY2Y.js";
 import "./chunk-NL7SZQPW.js";
 import "./chunk-DHVMSIT5.js";
 import "./chunk-ZPWHCABL.js";
@@ -10,4 +10,4 @@ export {
   formatDeepDiagnostics,
   runDeepDiagnostics
 };
-//# sourceMappingURL=doctor-deep-RAN4HGOH.js.map
+//# sourceMappingURL=doctor-deep-KUB4HPCS.js.map

package/dist/{expert-bridge-RJP57L75.js → expert-bridge-EK362QGQ.js}

@@ -3,9 +3,9 @@ import {
   shutdownExpertBridge,
   tokenSplitFromUsage,
   totalTokensFromUsage
-} from "./chunk-BGAK4N74.js";
-import "./chunk-YGYJUPVX.js";
-import "./chunk-RCSDD2QY.js";
+} from "./chunk-LSWGHIJK.js";
+import "./chunk-RI3BFANI.js";
+import "./chunk-Q4JNYY2Y.js";
 import "./chunk-NL7SZQPW.js";
 import "./chunk-DHVMSIT5.js";
 import "./chunk-ZPWHCABL.js";
@@ -15,4 +15,4 @@ export {
   tokenSplitFromUsage,
   totalTokensFromUsage
 };
-//# sourceMappingURL=expert-bridge-RJP57L75.js.map
+//# sourceMappingURL=expert-bridge-EK362QGQ.js.map