nexus-agents 4.29.6 → 4.29.7

package/dist/{chunk-IIKPFM4S.js → chunk-46F3UEKW.js}

@@ -21,7 +21,7 @@ import {
 import {
   DEFAULT_TASK_TTL_MS,
   clampTaskTtl
-} from "./chunk-7BX54AST.js";
+} from "./chunk-A4ISLEV6.js";
 import {
   executeExpert
 } from "./chunk-UPKYWLPL.js";
@@ -47,7 +47,7 @@ import {
   simulationDeniedResult,
   toJobSummary,
   writeJobCancelled
-} from "./chunk-T6GDTQPM.js";
+} from "./chunk-WRKUNUCA.js";
 import {
   allOf
 } from "./chunk-OQB3XC5O.js";
@@ -64,7 +64,7 @@ import {
 } from "./chunk-3IM3OPZH.js";
 import {
   withPrerequisite
-} from "./chunk-UMT3WDMH.js";
+} from "./chunk-XP5BAFPJ.js";
 import {
   NOOP_NOTIFIER,
   RateLimiter,
@@ -88,7 +88,7 @@ import {
   withAuditTrail,
   withProgressHeartbeat,
   wrapToolWithTimeout
-} from "./chunk-6FQTJHBL.js";
+} from "./chunk-WB54CVTG.js";
 import {
   createAuditTrail,
   createGraphAuditBridge,
@@ -47537,7 +47537,7 @@ ${contextBlock}`;
       const strategy = config.votingStrategy ?? "higher_order";
       await postProgress(config, "Vote", `Running consensus with ${strategy} strategy...`);
       try {
-        const { executeVoting } = await import("./consensus-vote-6GHVEPJO.js");
+        const { executeVoting } = await import("./consensus-vote-RJBBB25Z.js");
         const votingResult = await executeVoting(
           {
             proposal: buildVoteProposal(plan, research),
@@ -56165,4 +56165,4 @@ export {
   shutdownFeedbackSubscriber,
   createEventBusBridge
 };
-//# sourceMappingURL=chunk-IIKPFM4S.js.map
+//# sourceMappingURL=chunk-46F3UEKW.js.map

package/dist/{chunk-7BX54AST.js → chunk-A4ISLEV6.js}

@@ -1,12 +1,12 @@
 import {
   readOpenAICompatEnv
-} from "./chunk-MLPECOSS.js";
+} from "./chunk-GFNBH2PE.js";
 import {
   allOf
 } from "./chunk-OQB3XC5O.js";
 import {
   VERSION
-} from "./chunk-RN2LHUXX.js";
+} from "./chunk-EE53G5Z4.js";
 import {
   capitalize
 } from "./chunk-6T3EPABN.js";
@@ -1201,7 +1201,7 @@ async function runDoctorFix(result) {
   writeLine2("\u2500".repeat(40));
   let fixCount = 0;
   if (!result.dataDirectory.rootExists || result.dataDirectory.subdirectories.some((d) => !d.exists || !d.writable)) {
-    const { initDataDirectories: initDataDirectories2, describeDataDirFix: describeDataDirFix2 } = await import("./setup-data-dir-I35NTAVH.js");
+    const { initDataDirectories: initDataDirectories2, describeDataDirFix: describeDataDirFix2 } = await import("./setup-data-dir-A6DPGVXF.js");
     const outcome = describeDataDirFix2(initDataDirectories2());
     writeLine2(outcome.line);
     if (outcome.counted) fixCount++;
@@ -1303,4 +1303,4 @@ export {
   startStdioServer,
   closeServer
 };
-//# sourceMappingURL=chunk-7BX54AST.js.map
+//# sourceMappingURL=chunk-A4ISLEV6.js.map

package/dist/chunk-EE53G5Z4.js

@@ -0,0 +1,7 @@
+// src/version.ts
+var VERSION = true ? "4.29.7" : "dev";
+
+export {
+  VERSION
+};
+//# sourceMappingURL=chunk-EE53G5Z4.js.map

package/dist/{chunk-MLPECOSS.js → chunk-GFNBH2PE.js}

@@ -1,7 +1,7 @@
 import {
   computeCostDetail,
   recordUsageEvent
-} from "./chunk-HTDLKLLP.js";
+} from "./chunk-WIB7TIDY.js";
 import {
   BaseAdapter,
   createStream,
@@ -833,4 +833,4 @@ export {
   discoverModels,
   buildOpenAICompatAdapters
 };
-//# sourceMappingURL=chunk-MLPECOSS.js.map
+//# sourceMappingURL=chunk-GFNBH2PE.js.map

package/dist/{chunk-6FQTJHBL.js → chunk-WB54CVTG.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-RN2LHUXX.js";
+} from "./chunk-EE53G5Z4.js";
 import {
   emitClawGuardViolation
 } from "./chunk-ULZFVZFW.js";
@@ -2116,4 +2116,4 @@ export {
   VOTING_THRESHOLDS,
   ConsensusMetricsSchema
 };
-//# sourceMappingURL=chunk-6FQTJHBL.js.map
+//# sourceMappingURL=chunk-WB54CVTG.js.map

package/dist/{chunk-HTDLKLLP.js → chunk-WIB7TIDY.js}

@@ -7,6 +7,30 @@ import {
 
 // src/learning/usage-log.ts
 import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync } from "fs";
+
+// src/learning/token-cost-core.ts
+function componentCost(tokens, perMillion) {
+  return tokens * perMillion / 1e6;
+}
+function computeTokenCost(tokens, rates) {
+  const unpriced = [];
+  let costUsd = componentCost(tokens.input, rates.inputPer1M);
+  costUsd += componentCost(tokens.output, rates.outputPer1M);
+  if (tokens.cacheRead !== void 0 && tokens.cacheRead > 0) {
+    if (rates.cacheReadPer1M === void 0) unpriced.push("cacheRead");
+    else costUsd += componentCost(tokens.cacheRead, rates.cacheReadPer1M);
+  }
+  if (tokens.cacheWrite !== void 0 && tokens.cacheWrite > 0) {
+    if (rates.cacheWritePer1M === void 0) unpriced.push("cacheWrite");
+    else costUsd += componentCost(tokens.cacheWrite, rates.cacheWritePer1M);
+  }
+  return { costUsd, unpricedComponents: unpriced, complete: unpriced.length === 0 };
+}
+function roundToMicroUsd(costUsd) {
+  return Math.round(costUsd * 1e6) / 1e6;
+}
+
+// src/learning/usage-log.ts
 import { dirname, join } from "path";
 function computeCostDetail(modelId, inputTokens, outputTokens) {
   const entry = getDefaultRegistry().getEntry(modelId);
@@ -15,10 +39,11 @@ function computeCostDetail(modelId, inputTokens, outputTokens) {
   if (entry.pricing === void 0) {
     return { costUsd: 0, priced: false, resolvedId, ...provenance };
   }
-  const microUsd = Math.round(
-    inputTokens * entry.pricing.inputPer1M + outputTokens * entry.pricing.outputPer1M
+  const { costUsd } = computeTokenCost(
+    { input: inputTokens, output: outputTokens },
+    { inputPer1M: entry.pricing.inputPer1M, outputPer1M: entry.pricing.outputPer1M }
   );
-  return { costUsd: microUsd / 1e6, priced: true, resolvedId, ...provenance };
+  return { costUsd: roundToMicroUsd(costUsd), priced: true, resolvedId, ...provenance };
 }
 function priceBasisOf(detail) {
   return detail.priced ? "list" : "unknown";
@@ -128,4 +153,4 @@ export {
   loadUsageEvents,
   rollupByModel
 };
-//# sourceMappingURL=chunk-HTDLKLLP.js.map
+//# sourceMappingURL=chunk-WIB7TIDY.js.map

package/dist/chunk-WIB7TIDY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/learning/usage-log.ts","../src/learning/token-cost-core.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 { computeTokenCost, roundToMicroUsd } from './token-cost-core.js';\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';\nimport type { PriceBasis } from '../core/price-basis.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  // The arithmetic lives in the shared core (#5122); this function is the\n  // REGISTRY-BACKED, LEDGER-ROUNDED wrapper over it. Rounding to micro-USD\n  // stays here rather than in the core: it exists so this log's JSONL does not\n  // drift into floating-point noise across many small calls, which is a ledger\n  // requirement, not a property of cost.\n  const { costUsd } = computeTokenCost(\n    { input: inputTokens, output: outputTokens },\n    { inputPer1M: entry.pricing.inputPer1M, outputPer1M: entry.pricing.outputPer1M }\n  );\n  return { costUsd: roundToMicroUsd(costUsd), priced: true, resolvedId, ...provenance };\n}\n\n/**\n * The {@link PriceBasis} the cost in a {@link CostDetail} rests on (#4406).\n *\n * DELIBERATELY derived rather than stored, because `CostDetail.priced` already\n * carries the only distinction the current two-member union can express: the\n * chain resolved a rate, or it did not. A `priceBasis` property beside `priced`\n * would be a second spelling of the same boolean.\n *\n * WHAT THE `'list'` VALUE ASSERTS. Only that a rate was resolved, and that it\n * should be read as an assumed published rate. It is NOT a guarantee that the\n * number is a vendor's advertised public rate — at least two paths put\n * something else behind the label, and one puts a real published rate behind\n * `'unknown'`:\n *\n *  - The operator manifest overlay is the highest-precedence tier and passes\n *    `pricing` through; overriding pricing is its purpose. A negotiated rate\n *    entered there reports `'list'`, and the caveat then warns the reader their\n *    contract may differ over the contract rate.\n *  - The normalized/fuzzy identity tier lets a decorated gateway id inherit a\n *    DIFFERENT canonical entry's rate.\n *  - `config/models-generated-loader.ts` discards a published $0/$0 rate unless\n *    the id ends `:free`, so `'unknown'` does not mean no price exists.\n *\n * The derivation is therefore an assumption about the chain, not a fact about\n * it — conservative in the right direction (it invites a caveat rather than\n * suppressing one), and honest only if described this way. Narrowing it needs a\n * per-entry label the registry does not carry today; see {@link PriceBasis}.\n *\n * `priceSource`, the other provenance field, answers a different question: WHICH\n * registry entry supplied the number, not what KIND of rate it is. It does not\n * encode the basis, which is why the basis has to travel separately into records\n * (the decision-cost store) that persist neither field.\n */\nexport function priceBasisOf(detail: CostDetail): PriceBasis {\n  return detail.priced ? 'list' : 'unknown';\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","/**\n * The one place token counts become USD (#5122, epic #5121).\n *\n * An audit found ELEVEN implementations of this arithmetic across the tree,\n * disagreeing by **3.3x on identical usage**: 1M input + 1M output on\n * `claude-sonnet` gave $18.00 from six of them, $20.00 from three, and $6.00\n * from one. They also disagreed on rounding — one input token at $2.50/1M\n * returned `0.000003` from the usage-log path and `0.0000025` from the trace\n * path, off the same registry rate.\n *\n * The panel that ratified this shape (6/6 on the option) separated two causes\n * that need opposite treatment:\n *\n *  - **Arithmetic drift** — per-1M vs per-1K, blended vs split, rounded vs not.\n *    Pure duplication. It lives here, once.\n *  - **Unpriced policy** — return `0` with `priced:false`, return `undefined`,\n *    or substitute a conservative non-$0 rate. These are *deliberate and\n *    different per call site*, so they stay in named wrappers where a reader can\n *    see which one they get. A policy enum on one function was explicitly\n *    rejected: it makes picking the wrong policy a one-character mistake that\n *    typechecks and ships green, which is how #4165/#4196 happened.\n *\n * WHAT THIS MODULE DOES NOT DO, deliberately:\n *\n *  - **No registry lookup.** Rates are injected. That is what lets the routing\n *    profile (`topsis-helpers`) and the operator-configured rate\n *    (`orchestration-observer-helpers`) share this arithmetic instead of\n *    reimplementing it.\n *  - **No rounding.** The usage log rounds to micro-USD so its JSONL does not\n *    drift into floating-point noise; that is a *ledger* requirement, not a\n *    property of cost. Rounding here would impose it on every consumer and bake\n *    in the upward bias on sub-micro calls.\n *  - **No unpriced policy.** A caller with no rate must not reach this function.\n *\n * @module learning/token-cost-core\n */\n\n/**\n * Token counts for one call, split by how each component bills.\n *\n * `cacheRead` and `cacheWrite` are separate fields rather than folded into\n * `input` because vendors bill them at genuinely different rates — a cache read\n * at a discount, a cache write at a premium — and because providers report them\n * as counts SEPARATE from `input_tokens`, so adding them to `input` would double\n * count. Both optional: absent means the provider reported none, which is\n * different from zero of them (#5170).\n */\nexport interface TokenCounts {\n  readonly input: number;\n  readonly output: number;\n  /** Tokens served from cache, billed at a discount when a rate is known. */\n  readonly cacheRead?: number | undefined;\n  /** Tokens written to cache, billed at a premium when a rate is known. */\n  readonly cacheWrite?: number | undefined;\n}\n\n/**\n * Per-million-token rates in USD.\n *\n * Cache rates are optional because the registry cannot yet supply them: the\n * internal `PricingSchema` carries only `inputPer1M`/`outputPer1M`, even though\n * `models-dev-client.ts` already fetches `cache_read` from upstream and drops it\n * (#5170). The signature takes them from day one on the panel's binding\n * condition — consolidating onto an input/output-only shape would guarantee a\n * second sweeping refactor the moment those rates land.\n */\nexport interface TokenRates {\n  readonly inputPer1M: number;\n  readonly outputPer1M: number;\n  readonly cacheReadPer1M?: number | undefined;\n  readonly cacheWritePer1M?: number | undefined;\n}\n\n/**\n * A cost and an honest account of what it covers.\n *\n * `unpricedComponents` is the load-bearing field. A cache-heavy call whose cache\n * rates are unknown yields a cost computed from input and output alone — a real\n * number that is nonetheless a LOWER BOUND, and one that today's callers present\n * as a finished total. Naming the gap is what stops a partial from reading as\n * complete; per this repo's rule, an instrument must be able to represent what\n * it did not measure.\n */\nexport interface TokenCostBreakdown {\n  /** Cost in USD of the components that had a rate. Never rounded. */\n  readonly costUsd: number;\n  /**\n   * Components the caller reported tokens for but supplied no rate for.\n   * Empty means the cost covers every reported component.\n   */\n  readonly unpricedComponents: readonly (keyof TokenCounts)[];\n  /** True when `unpricedComponents` is empty — the cost is a total, not a floor. */\n  readonly complete: boolean;\n}\n\n/** USD for `tokens` at `perMillion`. */\nfunction componentCost(tokens: number, perMillion: number): number {\n  return (tokens * perMillion) / 1_000_000;\n}\n\n/**\n * Convert token counts to USD at the supplied rates.\n *\n * Pure: no registry, no rounding, no fallback. A component with tokens but no\n * rate contributes nothing to `costUsd` and is named in `unpricedComponents`,\n * so a caller can tell a complete total from a floor.\n *\n * @example\n * // 1M in + 1M out on claude-sonnet's 3/15 rates — the audit's golden value.\n * computeTokenCost({ input: 1e6, output: 1e6 }, { inputPer1M: 3, outputPer1M: 15 })\n * // → { costUsd: 18, unpricedComponents: [], complete: true }\n */\nexport function computeTokenCost(tokens: TokenCounts, rates: TokenRates): TokenCostBreakdown {\n  const unpriced: (keyof TokenCounts)[] = [];\n  let costUsd = componentCost(tokens.input, rates.inputPer1M);\n  costUsd += componentCost(tokens.output, rates.outputPer1M);\n\n  // A component is unpriced only when tokens were actually reported for it.\n  // Zero cache-read tokens with no cache-read rate is not a measurement gap —\n  // there was nothing to price. Naming it anyway would make `complete` false\n  // for every ordinary uncached call and render the flag useless.\n  if (tokens.cacheRead !== undefined && tokens.cacheRead > 0) {\n    if (rates.cacheReadPer1M === undefined) unpriced.push('cacheRead');\n    else costUsd += componentCost(tokens.cacheRead, rates.cacheReadPer1M);\n  }\n  if (tokens.cacheWrite !== undefined && tokens.cacheWrite > 0) {\n    if (rates.cacheWritePer1M === undefined) unpriced.push('cacheWrite');\n    else costUsd += componentCost(tokens.cacheWrite, rates.cacheWritePer1M);\n  }\n\n  return { costUsd, unpricedComponents: unpriced, complete: unpriced.length === 0 };\n}\n\n/**\n * Round a USD figure to whole micro-USD.\n *\n * Ledger-only. The usage log needs it so its JSONL does not accumulate\n * floating-point noise across many small calls; nothing else should, and it is\n * NOT applied inside {@link computeTokenCost}. It rounds half away from zero,\n * so a sub-micro call biases upward — pinned by test so the bias is a recorded\n * decision rather than an artefact.\n */\nexport function roundToMicroUsd(costUsd: number): number {\n  return Math.round(costUsd * 1_000_000) / 1_000_000;\n}\n"],"mappings":";;;;;;;;AA0BA,SAAS,gBAAgB,YAAY,WAAW,cAAc,mBAAmB;;;ACsEjF,SAAS,cAAc,QAAgB,YAA4B;AACjE,SAAQ,SAAS,aAAc;AACjC;AAcO,SAAS,iBAAiB,QAAqB,OAAuC;AAC3F,QAAM,WAAkC,CAAC;AACzC,MAAI,UAAU,cAAc,OAAO,OAAO,MAAM,UAAU;AAC1D,aAAW,cAAc,OAAO,QAAQ,MAAM,WAAW;AAMzD,MAAI,OAAO,cAAc,UAAa,OAAO,YAAY,GAAG;AAC1D,QAAI,MAAM,mBAAmB,OAAW,UAAS,KAAK,WAAW;AAAA,QAC5D,YAAW,cAAc,OAAO,WAAW,MAAM,cAAc;AAAA,EACtE;AACA,MAAI,OAAO,eAAe,UAAa,OAAO,aAAa,GAAG;AAC5D,QAAI,MAAM,oBAAoB,OAAW,UAAS,KAAK,YAAY;AAAA,QAC9D,YAAW,cAAc,OAAO,YAAY,MAAM,eAAe;AAAA,EACxE;AAEA,SAAO,EAAE,SAAS,oBAAoB,UAAU,UAAU,SAAS,WAAW,EAAE;AAClF;AAWO,SAAS,gBAAgB,SAAyB;AACvD,SAAO,KAAK,MAAM,UAAU,GAAS,IAAI;AAC3C;;;ADpHA,SAAS,SAAS,YAAY;AAgFvB,SAAS,kBACd,SACA,aACA,cACY;AAGZ,QAAM,QAAQ,mBAAmB,EAAE,SAAS,OAAO;AACnD,QAAM,aAAa,MAAM,gBAAgB;AACzC,QAAM,aAAa,MAAM,eAAe,SAAY,EAAE,YAAY,MAAM,WAAW,IAAI,CAAC;AACxF,MAAI,MAAM,YAAY,QAAW;AAC/B,WAAO,EAAE,SAAS,GAAG,QAAQ,OAAO,YAAY,GAAG,WAAW;AAAA,EAChE;AAMA,QAAM,EAAE,QAAQ,IAAI;AAAA,IAClB,EAAE,OAAO,aAAa,QAAQ,aAAa;AAAA,IAC3C,EAAE,YAAY,MAAM,QAAQ,YAAY,aAAa,MAAM,QAAQ,YAAY;AAAA,EACjF;AACA,SAAO,EAAE,SAAS,gBAAgB,OAAO,GAAG,QAAQ,MAAM,YAAY,GAAG,WAAW;AACtF;AAmCO,SAAS,aAAa,QAAgC;AAC3D,SAAO,OAAO,SAAS,SAAS;AAClC;AAaO,SAAS,gBAAgB,OAAa,oBAAI,KAAK,GAAW;AAC/D,QAAM,OAAO,KAAK,eAAe;AACjC,QAAM,QAAQ,OAAO,KAAK,YAAY,IAAI,CAAC,EAAE,SAAS,GAAG,GAAG;AAC5D,SAAO,KAAK,gBAAgB,GAAG,SAAS,SAAS,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;AAChF;AAOO,SAAS,iBAAiB,OAAyB;AACxD,MAAI;AACF,UAAM,OAAO,gBAAgB,IAAI,KAAK,MAAM,SAAS,CAAC;AACtD,cAAU,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;AAC5C,mBAAe,MAAM,GAAG,KAAK,UAAU,KAAK,CAAC;AAAA,GAAM,OAAO;AAAA,EAC5D,QAAQ;AAAA,EAER;AACF;AAaA,SAAS,eAAe,KAAgC;AACtD,MAAI,CAAC,WAAW,GAAG,EAAG,QAAO,CAAC;AAC9B,MAAI;AACF,WAAO,YAAY,GAAG,EAAE,OAAO,CAAC,MAAM,EAAE,WAAW,QAAQ,KAAK,EAAE,SAAS,QAAQ,CAAC;AAAA,EACtF,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AASA,SAAS,aAAa,QAAoB,GAAwB;AAChE,QAAM,KAAK,KAAK,MAAM,OAAO,SAAS;AACtC,MAAI,KAAK,EAAE,WAAW,MAAM,EAAE,QAAS,QAAO;AAC9C,MAAI,EAAE,YAAY,UAAa,OAAO,YAAY,EAAE,QAAS,QAAO;AACpE,MAAI,EAAE,aAAa,UAAa,OAAO,aAAa,EAAE,SAAU,QAAO;AACvE,SAAO;AACT;AAEA,SAAS,eAAe,UAAkB,QAA2C;AACnF,MAAI;AACJ,MAAI;AACF,cAAU,aAAa,UAAU,OAAO;AAAA,EAC1C,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACA,QAAM,MAAoB,CAAC;AAC3B,aAAW,QAAQ,QAAQ,MAAM,IAAI,GAAG;AACtC,QAAI,KAAK,KAAK,MAAM,GAAI;AACxB,QAAI;AACF,YAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,UAAI,aAAa,QAAQ,MAAM,EAAG,KAAI,KAAK,MAAM;AAAA,IACnD,QAAQ;AAEN;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAQO,SAAS,gBAAgB,OAAyB,CAAC,GAA0B;AAClF,QAAM,MAAM,KAAK,gBAAgB,GAAG,OAAO;AAC3C,QAAM,QAAQ,eAAe,GAAG;AAChC,MAAI,MAAM,WAAW,EAAG,QAAO,CAAC;AAChC,QAAM,SAAqB;AAAA,IACzB,SAAS,KAAK,aAAa,SAAY,KAAK,MAAM,KAAK,QAAQ,IAAI,OAAO;AAAA,IAC1E,SAAS,KAAK,aAAa,SAAY,KAAK,MAAM,KAAK,QAAQ,IAAI,OAAO;AAAA,IAC1E,SAAS,KAAK;AAAA,IACd,UAAU,KAAK;AAAA,EACjB;AACA,QAAM,SAAuB,CAAC;AAC9B,aAAW,KAAK,OAAO;AACrB,WAAO,KAAK,GAAG,eAAe,KAAK,KAAK,CAAC,GAAG,MAAM,CAAC;AAAA,EACrD;AACA,SAAO;AACT;AAoBO,SAAS,cAAc,QAAuD;AACnF,QAAM,SAAS,oBAAI,IAA0B;AAC7C,aAAW,KAAK,QAAQ;AACtB,UAAM,MAAM,OAAO,IAAI,EAAE,OAAO;AAChC,QAAI,QAAQ,OAAW,QAAO,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;AAAA,QAC3C,KAAI,KAAK,CAAC;AAAA,EACjB;AACA,QAAM,UAAyB,CAAC;AAChC,aAAW,CAAC,SAAS,KAAK,KAAK,QAAQ;AACrC,UAAM,YAAY,MAAM;AACxB,UAAM,eAAe,MAAM,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE;AACpD,UAAM,mBAAmB,MAAM,OAAO,CAAC,GAAG,MAAM,IAAI,EAAE,aAAa,CAAC;AACpE,UAAM,oBAAoB,MAAM,OAAO,CAAC,GAAG,MAAM,IAAI,EAAE,cAAc,CAAC;AACtE,UAAM,eAAe,MAAM,OAAO,CAAC,GAAG,MAAM,IAAI,EAAE,SAAS,CAAC;AAC5D,UAAM,eAAe,MAAM,OAAO,CAAC,GAAG,MAAM,IAAI,EAAE,WAAW,CAAC;AAC9D,UAAM,cAAc,cAAc,IAAI,IAAI,eAAe;AACzD,UAAM,eAAe,cAAc,IAAI,IAAI,eAAe;AAC1D,UAAM,oBAAoB,iBAAiB,IAAI,eAAe,eAAe;AAC7E,YAAQ,KAAK;AAAA,MACX;AAAA,MACA,YAAY,MAAM,CAAC,GAAG,cAAc;AAAA,MACpC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AACA,SAAO,QAAQ,KAAK,CAAC,GAAG,MAAM,EAAE,eAAe,EAAE,YAAY;AAC/D;","names":[]}

package/dist/{chunk-T6GDTQPM.js → chunk-WRKUNUCA.js}

@@ -1,7 +1,7 @@
 import {
   computeCostDetail,
   priceBasisOf
-} from "./chunk-HTDLKLLP.js";
+} from "./chunk-WIB7TIDY.js";
 import {
   allOf
 } from "./chunk-OQB3XC5O.js";
@@ -23,7 +23,7 @@ import {
   toolSuccessStructured,
   withProgressHeartbeat,
   wrapToolWithTimeout
-} from "./chunk-6FQTJHBL.js";
+} from "./chunk-WB54CVTG.js";
 import {
   assessPanelIndependence,
   countDistinctModels,
@@ -6803,4 +6803,4 @@ export {
   CONSENSUS_VOTE_TOOL_SCHEMA,
   registerConsensusVoteTool
 };
-//# sourceMappingURL=chunk-T6GDTQPM.js.map
+//# sourceMappingURL=chunk-WRKUNUCA.js.map

package/dist/{chunk-UMT3WDMH.js → chunk-XP5BAFPJ.js}

@@ -7,7 +7,7 @@ import {
   toolStructuredError,
   toolSuccessStructured,
   wrapToolWithTimeout
-} from "./chunk-6FQTJHBL.js";
+} from "./chunk-WB54CVTG.js";
 import {
   JsonlStore,
   SECURITY_KEYWORDS,
@@ -2159,4 +2159,4 @@ export {
   runImprovementReview,
   registerImprovementReviewTool
 };
-//# sourceMappingURL=chunk-UMT3WDMH.js.map
+//# sourceMappingURL=chunk-XP5BAFPJ.js.map

package/dist/cli.js

@@ -152,7 +152,7 @@ import {
   validateNexusEnv,
   validateWorkflow,
   wrapInMarkdownFence
-} from "./chunk-IIKPFM4S.js";
+} from "./chunk-46F3UEKW.js";
 import "./chunk-GZUHLCRE.js";
 import "./chunk-HFOQKCD2.js";
 import "./chunk-RSMG2DPB.js";
@@ -171,11 +171,11 @@ import {
   doctorCommand,
   initDataDirectories,
   runDoctor
-} from "./chunk-7BX54AST.js";
+} from "./chunk-A4ISLEV6.js";
 import {
   buildOpenAICompatAdapters,
   readOpenAICompatEnv
-} from "./chunk-MLPECOSS.js";
+} from "./chunk-GFNBH2PE.js";
 import {
   shutdownExpertBridge
 } from "./chunk-UPKYWLPL.js";
@@ -190,11 +190,11 @@ import {
   recordAuthenticVote,
   registerConsensusVoteTool,
   toRecordDecision
-} from "./chunk-T6GDTQPM.js";
+} from "./chunk-WRKUNUCA.js";
 import {
   loadUsageEvents,
   rollupByModel
-} from "./chunk-HTDLKLLP.js";
+} from "./chunk-WIB7TIDY.js";
 import {
   allOf,
   anyOf
@@ -226,15 +226,15 @@ import {
   registerImprovementReviewTool,
   runImprovementReview,
   scanForSecrets
-} from "./chunk-UMT3WDMH.js";
+} from "./chunk-XP5BAFPJ.js";
 import {
   createDefaultPolicyFirewall,
   setGlobalPolicyFirewall,
   stagePolicyFirewallForRollout
-} from "./chunk-6FQTJHBL.js";
+} from "./chunk-WB54CVTG.js";
 import {
   VERSION
-} from "./chunk-RN2LHUXX.js";
+} from "./chunk-EE53G5Z4.js";
 import "./chunk-ULZFVZFW.js";
 import {
   createUnifiedRegistry,
@@ -19553,7 +19553,7 @@ function startImprovementReviewScheduler(options) {
   let running = false;
   const runOnce = async () => {
     try {
-      const { runImprovementReview: runImprovementReview2, ImprovementReviewInputSchema: ImprovementReviewInputSchema2 } = await import("./improvement-review-Z6CAUHEY.js");
+      const { runImprovementReview: runImprovementReview2, ImprovementReviewInputSchema: ImprovementReviewInputSchema2 } = await import("./improvement-review-I26ZEHXQ.js");
       const input = ImprovementReviewInputSchema2.parse({ fileIssues });
       const result = await runImprovementReview2(input, { logger: logger22 });
       logger22.info("Scheduled improvement_review complete", {
@@ -22965,7 +22965,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-Y2L2ZW3Q.js");
+  const { runInitOpencode } = await import("./init-opencode-KWKRUK5D.js");
   const opencodePath = args.options.opencode;
   if (opencodePath === void 0 || opencodePath === "") {
     process.stderr.write("Error: --opencode requires a path argument.\n");
@@ -22991,7 +22991,7 @@ async function runInitOpencodeFlow(args) {
   return cliExit(EXIT_CODES.SUCCESS);
 }
 async function renderOpencodeValidate(opencodePath) {
-  const { runOpencodeValidate } = await import("./init-opencode-Y2L2ZW3Q.js");
+  const { runOpencodeValidate } = await import("./init-opencode-KWKRUK5D.js");
   const result = await runOpencodeValidate(opencodePath);
   if (!result.ok) {
     process.stderr.write(`init --opencode --validate: ${result.reason ?? "failed"}

package/dist/{consensus-vote-6GHVEPJO.js → consensus-vote-RJBBB25Z.js}

@@ -11,11 +11,11 @@ import {
   resetCorrelationTracker,
   runConsensusForGoal,
   unwrapVoteOrThrow
-} from "./chunk-T6GDTQPM.js";
-import "./chunk-HTDLKLLP.js";
+} from "./chunk-WRKUNUCA.js";
+import "./chunk-WIB7TIDY.js";
 import "./chunk-OQB3XC5O.js";
-import "./chunk-6FQTJHBL.js";
-import "./chunk-RN2LHUXX.js";
+import "./chunk-WB54CVTG.js";
+import "./chunk-EE53G5Z4.js";
 import "./chunk-ULZFVZFW.js";
 import "./chunk-KYTV2JFH.js";
 import "./chunk-WYKMINTU.js";
@@ -50,4 +50,4 @@ export {
   runConsensusForGoal,
   unwrapVoteOrThrow
 };
-//# sourceMappingURL=consensus-vote-6GHVEPJO.js.map
+//# sourceMappingURL=consensus-vote-RJBBB25Z.js.map

package/dist/{improvement-review-Z6CAUHEY.js → improvement-review-I26ZEHXQ.js}

@@ -11,9 +11,9 @@ import {
   loadSelfEvalSignals,
   registerImprovementReviewTool,
   runImprovementReview
-} from "./chunk-UMT3WDMH.js";
-import "./chunk-6FQTJHBL.js";
-import "./chunk-RN2LHUXX.js";
+} from "./chunk-XP5BAFPJ.js";
+import "./chunk-WB54CVTG.js";
+import "./chunk-EE53G5Z4.js";
 import "./chunk-ULZFVZFW.js";
 import "./chunk-WJ5TFKDF.js";
 import "./chunk-GBHJ37V3.js";
@@ -33,4 +33,4 @@ export {
   registerImprovementReviewTool,
   runImprovementReview
 };
-//# sourceMappingURL=improvement-review-Z6CAUHEY.js.map
+//# sourceMappingURL=improvement-review-I26ZEHXQ.js.map

package/dist/index.js

@@ -553,7 +553,7 @@ import {
   withLogging,
   withRetry,
   withRetryWrapper
-} from "./chunk-IIKPFM4S.js";
+} from "./chunk-46F3UEKW.js";
 import {
   FALLBACK_SCANNER_DATA,
   buildPlanFromAnalysis,
@@ -574,13 +574,13 @@ import {
   connectTransport,
   createServer,
   startStdioServer
-} from "./chunk-7BX54AST.js";
+} from "./chunk-A4ISLEV6.js";
 import {
   OPENAI_MODELS,
   OPENAI_MODEL_ALIASES,
   OpenAIAdapter,
   createOpenAIAdapter
-} from "./chunk-MLPECOSS.js";
+} from "./chunk-GFNBH2PE.js";
 import {
   executeExpert
 } from "./chunk-UPKYWLPL.js";
@@ -632,8 +632,8 @@ import {
   generateProposalId,
   parseAgentPairKey,
   registerConsensusVoteTool
-} from "./chunk-T6GDTQPM.js";
-import "./chunk-HTDLKLLP.js";
+} from "./chunk-WRKUNUCA.js";
+import "./chunk-WIB7TIDY.js";
 import {
   allOf
 } from "./chunk-OQB3XC5O.js";
@@ -683,7 +683,7 @@ import {
 import {
   ImprovementReviewInputSchema,
   registerImprovementReviewTool
-} from "./chunk-UMT3WDMH.js";
+} from "./chunk-XP5BAFPJ.js";
 import {
   AgentPerformanceSchema,
   ConsensusAlgorithmSchema,
@@ -719,10 +719,10 @@ import {
   toolSuccess,
   toolSuccessStructured,
   validateToolInput
-} from "./chunk-6FQTJHBL.js";
+} from "./chunk-WB54CVTG.js";
 import {
   VERSION
-} from "./chunk-RN2LHUXX.js";
+} from "./chunk-EE53G5Z4.js";
 import {
   AuditTrail,
   MAX_STRIPPED_ELEMENTS_PER_EVENT,
@@ -4729,7 +4729,7 @@ function buildVotingInput(plan, config) {
 }
 async function executeSingleVote(plan, config, log) {
   try {
-    const { executeVoting } = await import("./consensus-vote-6GHVEPJO.js");
+    const { executeVoting } = await import("./consensus-vote-RJBBB25Z.js");
     const input = buildVotingInput(plan, config);
     const result = await executeVoting(input, log);
     return parseVotingResult(result);

package/dist/{init-opencode-Y2L2ZW3Q.js → init-opencode-KWKRUK5D.js}

@@ -1,8 +1,8 @@
 import {
   discoverModels,
   readOpencodeGateway
-} from "./chunk-MLPECOSS.js";
-import "./chunk-HTDLKLLP.js";
+} from "./chunk-GFNBH2PE.js";
+import "./chunk-WIB7TIDY.js";
 import "./chunk-CQHUNYJN.js";
 import "./chunk-GXZDUDSD.js";
 import {
@@ -176,4 +176,4 @@ export {
   runInitOpencode,
   runOpencodeValidate
 };
-//# sourceMappingURL=init-opencode-Y2L2ZW3Q.js.map
+//# sourceMappingURL=init-opencode-KWKRUK5D.js.map

package/dist/{setup-data-dir-I35NTAVH.js → setup-data-dir-A6DPGVXF.js}

@@ -2,11 +2,11 @@ import {
   NEXUS_DATA_DIR,
   describeDataDirFix,
   initDataDirectories
-} from "./chunk-7BX54AST.js";
-import "./chunk-MLPECOSS.js";
-import "./chunk-HTDLKLLP.js";
+} from "./chunk-A4ISLEV6.js";
+import "./chunk-GFNBH2PE.js";
+import "./chunk-WIB7TIDY.js";
 import "./chunk-OQB3XC5O.js";
-import "./chunk-RN2LHUXX.js";
+import "./chunk-EE53G5Z4.js";
 import "./chunk-6T3EPABN.js";
 import "./chunk-VOXVWYD4.js";
 import "./chunk-CQHUNYJN.js";
@@ -26,4 +26,4 @@ export {
   describeDataDirFix,
   initDataDirectories
 };
-//# sourceMappingURL=setup-data-dir-I35NTAVH.js.map
+//# sourceMappingURL=setup-data-dir-A6DPGVXF.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-agents",
-  "version": "4.29.6",
+  "version": "4.29.7",
   "description": "Governance substrate for AI coding agents — adversarial PR review, drift-detected rules, tamper-evident audit, and closed-loop outcome routing for Claude, Codex, Gemini, and OpenCode",
   "mcpName": "io.github.nexus-substrate/nexus-agents",
   "license": "MIT",

package/dist/chunk-HTDLKLLP.js.map

@@ -1 +0,0 @@
-{"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';\nimport type { PriceBasis } from '../core/price-basis.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 * The {@link PriceBasis} the cost in a {@link CostDetail} rests on (#4406).\n *\n * DELIBERATELY derived rather than stored, because `CostDetail.priced` already\n * carries the only distinction the current two-member union can express: the\n * chain resolved a rate, or it did not. A `priceBasis` property beside `priced`\n * would be a second spelling of the same boolean.\n *\n * WHAT THE `'list'` VALUE ASSERTS. Only that a rate was resolved, and that it\n * should be read as an assumed published rate. It is NOT a guarantee that the\n * number is a vendor's advertised public rate — at least two paths put\n * something else behind the label, and one puts a real published rate behind\n * `'unknown'`:\n *\n *  - The operator manifest overlay is the highest-precedence tier and passes\n *    `pricing` through; overriding pricing is its purpose. A negotiated rate\n *    entered there reports `'list'`, and the caveat then warns the reader their\n *    contract may differ over the contract rate.\n *  - The normalized/fuzzy identity tier lets a decorated gateway id inherit a\n *    DIFFERENT canonical entry's rate.\n *  - `config/models-generated-loader.ts` discards a published $0/$0 rate unless\n *    the id ends `:free`, so `'unknown'` does not mean no price exists.\n *\n * The derivation is therefore an assumption about the chain, not a fact about\n * it — conservative in the right direction (it invites a caveat rather than\n * suppressing one), and honest only if described this way. Narrowing it needs a\n * per-entry label the registry does not carry today; see {@link PriceBasis}.\n *\n * `priceSource`, the other provenance field, answers a different question: WHICH\n * registry entry supplied the number, not what KIND of rate it is. It does not\n * encode the basis, which is why the basis has to travel separately into records\n * (the decision-cost store) that persist neither field.\n */\nexport function priceBasisOf(detail: CostDetail): PriceBasis {\n  return detail.priced ? 'list' : 'unknown';\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-RN2LHUXX.js

@@ -1,7 +0,0 @@
-// src/version.ts
-var VERSION = true ? "4.29.6" : "dev";
-
-export {
-  VERSION
-};
-//# sourceMappingURL=chunk-RN2LHUXX.js.map