nexus-agents 8.13.0 → 8.14.0

package/dist/{chunk-74PMAQD6.js → chunk-357SIWOH.js}

@@ -7,7 +7,7 @@ import {
   toolStructuredError,
   toolSuccessStructured,
   wrapToolWithTimeout
-} from "./chunk-5KXR5XZQ.js";
+} from "./chunk-GZTMRQCU.js";
 import {
   JsonlStore,
   SECURITY_KEYWORDS,
@@ -2159,4 +2159,4 @@ export {
   runImprovementReview,
   registerImprovementReviewTool
 };
-//# sourceMappingURL=chunk-74PMAQD6.js.map
+//# sourceMappingURL=chunk-357SIWOH.js.map

package/dist/{chunk-22FTW2WH.js → chunk-DO63GVEY.js}

@@ -1,12 +1,12 @@
 import {
   readOpenAICompatEnv
-} from "./chunk-JH2GRV3L.js";
+} from "./chunk-T22TMAIG.js";
 import {
   allOf
 } from "./chunk-OQB3XC5O.js";
 import {
   VERSION
-} from "./chunk-ZUI3SW2Y.js";
+} from "./chunk-GLIEFVVU.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-WMB4DSAI.js");
+    const { initDataDirectories: initDataDirectories2, describeDataDirFix: describeDataDirFix2 } = await import("./setup-data-dir-PFCBRVZ5.js");
     const outcome = describeDataDirFix2(initDataDirectories2());
     writeLine2(outcome.line);
     if (outcome.counted) fixCount++;
@@ -1303,4 +1303,4 @@ export {
   startStdioServer,
   closeServer
 };
-//# sourceMappingURL=chunk-22FTW2WH.js.map
+//# sourceMappingURL=chunk-DO63GVEY.js.map

package/dist/{chunk-JEQF3ET2.js → chunk-DVYY5WN6.js}

@@ -42,12 +42,21 @@ function recordUsageEvent(event) {
   } catch {
   }
 }
+function describeReadError(error) {
+  return error instanceof Error ? error.message : String(error);
+}
 function listUsageFiles(dir) {
-  if (!existsSync(dir)) return [];
+  if (!existsSync(dir)) return { files: [], readErrors: [] };
   try {
-    return readdirSync(dir).filter((f) => f.startsWith("usage-") && f.endsWith(".jsonl"));
-  } catch {
-    return [];
+    const files = readdirSync(dir).filter(
+      (file) => file.startsWith("usage-") && file.endsWith(".jsonl")
+    );
+    return { files, readErrors: [] };
+  } catch (error) {
+    return {
+      files: [],
+      readErrors: [`usage ledger unreadable: failed to list ${dir}: ${describeReadError(error)}`]
+    };
   }
 }
 var logger = createLogger({ component: "usage-log" });
@@ -92,8 +101,8 @@ function parseFileLines(filePath, filter) {
   let content;
   try {
     content = readFileSync(filePath, "utf-8");
-  } catch {
-    return [];
+  } catch (error) {
+    return { events: [], readError: `${filePath}: ${describeReadError(error)}` };
   }
   const out = [];
   let rejected = 0;
@@ -117,12 +126,14 @@ function parseFileLines(filePath, filter) {
   if (rejected > 0) {
     logger.warn("Usage ledger lines rejected as unreadable", { filePath, rejected });
   }
-  return out;
+  return { events: out };
 }
 function loadUsageEvents(opts = {}) {
   const dir = join(getNexusDataDir(), "usage");
-  const files = listUsageFiles(dir);
-  if (files.length === 0) return [];
+  const listed = listUsageFiles(dir);
+  if (listed.files.length === 0) {
+    return { events: [], complete: listed.readErrors.length === 0, readErrors: listed.readErrors };
+  }
   const filter = {
     sinceMs: opts.sinceIso !== void 0 ? Date.parse(opts.sinceIso) : Number.NEGATIVE_INFINITY,
     untilMs: opts.untilIso !== void 0 ? Date.parse(opts.untilIso) : Number.POSITIVE_INFINITY,
@@ -130,12 +141,19 @@ function loadUsageEvents(opts = {}) {
     category: opts.category
   };
   const events = [];
-  for (const f of files) {
-    events.push(...parseFileLines(join(dir, f), filter));
+  const readErrors = [];
+  for (const file of listed.files) {
+    const parsed = parseFileLines(join(dir, file), filter);
+    events.push(...parsed.events);
+    if (parsed.readError !== void 0) readErrors.push(parsed.readError);
+  }
+  if (readErrors.length === listed.files.length) {
+    readErrors[0] = `usage ledger unreadable: no files readable; ${readErrors[0] ?? ""}`;
   }
-  return events;
+  return { events, complete: readErrors.length === 0, readErrors };
 }
 function rollupByModel(events) {
+  if (events.length === 0) return [];
   const groups = /* @__PURE__ */ new Map();
   for (const e of events) {
     const arr = groups.get(e.modelId);
@@ -149,10 +167,11 @@ function rollupByModel(events) {
     const totalInputTokens = group.reduce((s, e) => s + e.inputTokens, 0);
     const totalOutputTokens = group.reduce((s, e) => s + e.outputTokens, 0);
     const totalUsdCost = group.reduce((s, e) => s + e.usdCost, 0);
+    const unpricedCallCount = group.filter((event) => event.priced === false).length;
     const totalLatency = group.reduce((s, e) => s + e.latencyMs, 0);
     const successRate = callCount === 0 ? 0 : successCount / callCount;
     const avgLatencyMs = callCount === 0 ? 0 : totalLatency / callCount;
-    const costPerSuccessUsd = successCount === 0 ? totalUsdCost : totalUsdCost / successCount;
+    const costPerSuccessUsd = successCount === 0 ? null : totalUsdCost / successCount;
     rollups.push({
       modelId,
       providerId: group[0]?.providerId ?? "unknown",
@@ -162,6 +181,7 @@ function rollupByModel(events) {
       totalInputTokens,
       totalOutputTokens,
       totalUsdCost,
+      unpricedCallCount,
       avgLatencyMs,
       costPerSuccessUsd
     });
@@ -176,4 +196,4 @@ export {
   loadUsageEvents,
   rollupByModel
 };
-//# sourceMappingURL=chunk-JEQF3ET2.js.map
+//# sourceMappingURL=chunk-DVYY5WN6.js.map

package/dist/chunk-DVYY5WN6.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 { z } from 'zod';\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';\nimport { createLogger } from '../core/logger.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\ninterface UsageFileList {\n  readonly files: readonly string[];\n  readonly readErrors: readonly string[];\n}\n\nfunction describeReadError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction listUsageFiles(dir: string): UsageFileList {\n  if (!existsSync(dir)) return { files: [], readErrors: [] };\n  try {\n    const files = readdirSync(dir).filter(\n      (file) => file.startsWith('usage-') && file.endsWith('.jsonl')\n    );\n    return { files, readErrors: [] };\n  } catch (error) {\n    return {\n      files: [],\n      readErrors: [`usage ledger unreadable: failed to list ${dir}: ${describeReadError(error)}`],\n    };\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\nconst logger = createLogger({ component: 'usage-log' });\n\n/**\n * Validate a ledger line before it is trusted (#5328).\n *\n * The read path did `JSON.parse(line) as UsageEvent` — a cast. `eventMatches`\n * only inspects `timestamp` / `modelId` / `category`, so a corrupt `usdCost`\n * reached `rollupByModel`'s `reduce((s, e) => s + e.usdCost, 0)`: a string\n * concatenates, a missing value yields `NaN`, and neither throws. Every sibling\n * JSONL reader here validates; this one did not, and it is the cost ledger.\n *\n * Optional fields stay optional ON PURPOSE. `category`, `errorCode`, `priced`\n * and `priceSource` all postdate the original format — `priced` is documented\n * as \"Absent on lines written before this field existed\" — so requiring them\n * would silently discard real spend history, which is worse than the corruption\n * being fixed.\n *\n * Not `.strict()`, for the same forward-compatibility reason: a line carrying a\n * field a newer version writes must still load in an older one.\n *\n * `z.number()` already rejects `NaN` and infinities in zod v4, which is the\n * property that matters here: a cost that is not a real number cannot be summed,\n * and JSON renders `NaN` as `null`, which this also rejects.\n */\nconst UsageEventSchema = z.object({\n  timestamp: z.string(),\n  modelId: z.string(),\n  providerId: z.string(),\n  inputTokens: z.number(),\n  outputTokens: z.number(),\n  usdCost: z.number(),\n  latencyMs: z.number(),\n  success: z.boolean(),\n  category: z.string().optional(),\n  errorCode: z.string().optional(),\n  priced: z.boolean().optional(),\n  priceSource: z.string().optional(),\n});\n\n/**\n * Narrow a validated line to {@link UsageEvent}.\n *\n * Zod's `.optional()` yields `T | undefined`, which `exactOptionalPropertyTypes`\n * will not assign to a `?: T` property — an absent key and a present-but-\n * undefined key are different things under that flag, and the distinction is\n * the right one for a ledger: a line that omits `priced` is legacy, whereas one\n * that sets it to `undefined` is malformed.\n */\nfunction toUsageEvent(v: z.infer<typeof UsageEventSchema>): UsageEvent {\n  return {\n    timestamp: v.timestamp,\n    modelId: v.modelId,\n    providerId: v.providerId,\n    inputTokens: v.inputTokens,\n    outputTokens: v.outputTokens,\n    usdCost: v.usdCost,\n    latencyMs: v.latencyMs,\n    success: v.success,\n    ...(v.category !== undefined && { category: v.category }),\n    ...(v.errorCode !== undefined && { errorCode: v.errorCode }),\n    ...(v.priced !== undefined && { priced: v.priced }),\n    ...(v.priceSource !== undefined && { priceSource: v.priceSource }),\n  };\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\ninterface ParsedUsageFile {\n  readonly events: readonly UsageEvent[];\n  readonly readError?: string;\n}\n\nfunction parseFileLines(filePath: string, filter: LoadFilter): ParsedUsageFile {\n  let content: string;\n  try {\n    content = readFileSync(filePath, 'utf-8');\n  } catch (error) {\n    return { events: [], readError: `${filePath}: ${describeReadError(error)}` };\n  }\n  const out: UsageEvent[] = [];\n  let rejected = 0;\n  for (const line of content.split('\\n')) {\n    if (line.trim() === '') continue;\n    let raw: unknown;\n    try {\n      raw = JSON.parse(line);\n    } catch {\n      // Skip malformed line; keep reading.\n      rejected++;\n      continue;\n    }\n    const parsed = UsageEventSchema.safeParse(raw);\n    if (!parsed.success) {\n      rejected++;\n      continue;\n    }\n    const event = toUsageEvent(parsed.data);\n    if (eventMatches(event, filter)) out.push(event);\n  }\n  // Say so rather than quietly returning a shorter list: a ledger that drops\n  // lines silently under-reports spend, and the operator has no way to tell.\n  if (rejected > 0) {\n    logger.warn('Usage ledger lines rejected as unreadable', { filePath, rejected });\n  }\n  return { events: out };\n}\n\ninterface UsageLedgerLoadResult {\n  /** Valid events recovered from every readable ledger file. */\n  readonly events: readonly UsageEvent[];\n  /** True only when the ledger directory and every discovered file were readable. */\n  readonly complete: boolean;\n  /** Human-readable directory/file failures that made the result incomplete. */\n  readonly readErrors: readonly string[];\n}\n\n/**\n * Load all usage events from disk that match the filter, preserving whether\n * every ledger file was readable. A missing usage directory is a complete,\n * empty ledger. For sub-second filtering at scale a future PR can index by\n * month, but linear scan is fine at the \"operator dashboard\" scale.\n */\nexport function loadUsageEvents(opts: LoadUsageOptions = {}): UsageLedgerLoadResult {\n  const dir = join(getNexusDataDir(), 'usage');\n  const listed = listUsageFiles(dir);\n  if (listed.files.length === 0) {\n    return { events: [], complete: listed.readErrors.length === 0, readErrors: listed.readErrors };\n  }\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  const readErrors: string[] = [];\n  for (const file of listed.files) {\n    const parsed = parseFileLines(join(dir, file), filter);\n    events.push(...parsed.events);\n    if (parsed.readError !== undefined) readErrors.push(parsed.readError);\n  }\n  if (readErrors.length === listed.files.length) {\n    readErrors[0] = `usage ledger unreadable: no files readable; ${readErrors[0] ?? ''}`;\n  }\n  return { events, complete: readErrors.length === 0, readErrors };\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  /** Calls whose cost is unknown; legacy events without `priced` do not count. */\n  readonly unpricedCallCount: number;\n  readonly avgLatencyMs: number;\n  /** Null when there were no successful calls. */\n  readonly costPerSuccessUsd: number | null;\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  if (events.length === 0) return [];\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    // Legacy ledger lines predate `priced`; only an explicit false is unpriced.\n    const unpricedCallCount = group.filter((event) => event.priced === false).length;\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 ? null : 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      unpricedCallCount,\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-GLIEFVVU.js

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

package/dist/{chunk-5KXR5XZQ.js → chunk-GZTMRQCU.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-ZUI3SW2Y.js";
+} from "./chunk-GLIEFVVU.js";
 import {
   emitClawGuardViolation
 } from "./chunk-KHJACO7N.js";
@@ -2246,4 +2246,4 @@ export {
   VOTING_THRESHOLDS,
   ConsensusMetricsSchema
 };
-//# sourceMappingURL=chunk-5KXR5XZQ.js.map
+//# sourceMappingURL=chunk-GZTMRQCU.js.map

package/dist/{chunk-6FGQB3AO.js → chunk-LMYHGHZN.js}

@@ -21,7 +21,7 @@ import {
 import {
   DEFAULT_TASK_TTL_MS,
   clampTaskTtl
-} from "./chunk-22FTW2WH.js";
+} from "./chunk-DO63GVEY.js";
 import {
   executeExpert
 } from "./chunk-ZVBGJJHJ.js";
@@ -48,7 +48,7 @@ import {
   simulationDeniedResult,
   toJobSummary,
   writeJobCancelled
-} from "./chunk-LN7ELNT3.js";
+} from "./chunk-MSOUT5RH.js";
 import {
   allOf
 } from "./chunk-OQB3XC5O.js";
@@ -67,7 +67,7 @@ import {
 } from "./chunk-EIEC22PA.js";
 import {
   withPrerequisite
-} from "./chunk-74PMAQD6.js";
+} from "./chunk-357SIWOH.js";
 import {
   NOOP_NOTIFIER,
   RateLimiter,
@@ -92,7 +92,7 @@ import {
   withAuditTrail,
   withProgressHeartbeat,
   wrapToolWithTimeout
-} from "./chunk-5KXR5XZQ.js";
+} from "./chunk-GZTMRQCU.js";
 import {
   createAuditTrail,
   createGraphAuditBridge,
@@ -47395,7 +47395,7 @@ ${contextBlock}`;
       const strategy = config.votingStrategy ?? "higher_order";
       await postProgress(config, "Vote", `Running consensus with ${strategy} strategy...`);
       try {
-        const { executeVoting } = await import("./consensus-vote-J662PG7U.js");
+        const { executeVoting } = await import("./consensus-vote-TMWNYIHD.js");
         const votingResult = await executeVoting(
           {
             proposal: buildVoteProposal(plan, research),
@@ -56059,4 +56059,4 @@ export {
   shutdownFeedbackSubscriber,
   createEventBusBridge
 };
-//# sourceMappingURL=chunk-6FGQB3AO.js.map
+//# sourceMappingURL=chunk-LMYHGHZN.js.map

package/dist/{chunk-LN7ELNT3.js → chunk-MSOUT5RH.js}

@@ -1,7 +1,7 @@
 import {
   computeCostDetail,
   priceBasisOf
-} from "./chunk-JEQF3ET2.js";
+} from "./chunk-DVYY5WN6.js";
 import {
   allOf
 } from "./chunk-OQB3XC5O.js";
@@ -23,10 +23,10 @@ import {
   toolSuccessStructured,
   withProgressHeartbeat,
   wrapToolWithTimeout
-} from "./chunk-5KXR5XZQ.js";
+} from "./chunk-GZTMRQCU.js";
 import {
   VERSION
-} from "./chunk-ZUI3SW2Y.js";
+} from "./chunk-GLIEFVVU.js";
 import {
   assessPanelIndependence,
   countDistinctModels,
@@ -6972,4 +6972,4 @@ export {
   CONSENSUS_VOTE_TOOL_SCHEMA,
   registerConsensusVoteTool
 };
-//# sourceMappingURL=chunk-LN7ELNT3.js.map
+//# sourceMappingURL=chunk-MSOUT5RH.js.map

package/dist/{chunk-JH2GRV3L.js → chunk-T22TMAIG.js}

@@ -1,7 +1,7 @@
 import {
   computeCostDetail,
   recordUsageEvent
-} from "./chunk-JEQF3ET2.js";
+} from "./chunk-DVYY5WN6.js";
 import {
   BaseAdapter,
   createStream,
@@ -833,4 +833,4 @@ export {
   discoverModels,
   buildOpenAICompatAdapters
 };
-//# sourceMappingURL=chunk-JH2GRV3L.js.map
+//# sourceMappingURL=chunk-T22TMAIG.js.map

package/dist/cli.js

@@ -154,7 +154,7 @@ import {
   validateNexusEnv,
   validateWorkflow,
   wrapInMarkdownFence
-} from "./chunk-6FGQB3AO.js";
+} from "./chunk-LMYHGHZN.js";
 import "./chunk-FGEGUND2.js";
 import "./chunk-DGWT7DXX.js";
 import "./chunk-64GMIUM5.js";
@@ -174,11 +174,11 @@ import {
   doctorCommand,
   initDataDirectories,
   runDoctor
-} from "./chunk-22FTW2WH.js";
+} from "./chunk-DO63GVEY.js";
 import {
   buildOpenAICompatAdapters,
   readOpenAICompatEnv
-} from "./chunk-JH2GRV3L.js";
+} from "./chunk-T22TMAIG.js";
 import {
   shutdownExpertBridge
 } from "./chunk-ZVBGJJHJ.js";
@@ -193,11 +193,11 @@ import {
   recordAuthenticVote,
   registerConsensusVoteTool,
   toRecordDecision
-} from "./chunk-LN7ELNT3.js";
+} from "./chunk-MSOUT5RH.js";
 import {
   loadUsageEvents,
   rollupByModel
-} from "./chunk-JEQF3ET2.js";
+} from "./chunk-DVYY5WN6.js";
 import {
   allOf,
   anyOf
@@ -230,15 +230,15 @@ import {
   registerImprovementReviewTool,
   runImprovementReview,
   scanForSecrets
-} from "./chunk-74PMAQD6.js";
+} from "./chunk-357SIWOH.js";
 import {
   createDefaultPolicyFirewall,
   setGlobalPolicyFirewall,
   stagePolicyFirewallForRollout
-} from "./chunk-5KXR5XZQ.js";
+} from "./chunk-GZTMRQCU.js";
 import {
   VERSION
-} from "./chunk-ZUI3SW2Y.js";
+} from "./chunk-GLIEFVVU.js";
 import "./chunk-KHJACO7N.js";
 import {
   createUnifiedRegistry,
@@ -19685,7 +19685,7 @@ function startImprovementReviewScheduler(options) {
   let running = false;
   const runOnce = async () => {
     try {
-      const { runImprovementReview: runImprovementReview2, ImprovementReviewInputSchema: ImprovementReviewInputSchema2 } = await import("./improvement-review-DRHKKXAE.js");
+      const { runImprovementReview: runImprovementReview2, ImprovementReviewInputSchema: ImprovementReviewInputSchema2 } = await import("./improvement-review-SZTIX2IL.js");
       const input = ImprovementReviewInputSchema2.parse({ fileIssues });
       const result = await runImprovementReview2(input, { logger: logger22 });
       logger22.info("Scheduled improvement_review complete", {
@@ -23099,7 +23099,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-5WSAP46F.js");
+  const { runInitOpencode } = await import("./init-opencode-3NZVCAQX.js");
   const opencodePath = args.options.opencode;
   if (opencodePath === void 0 || opencodePath === "") {
     process.stderr.write("Error: --opencode requires a path argument.\n");
@@ -23125,7 +23125,7 @@ async function runInitOpencodeFlow(args) {
   return cliExit(EXIT_CODES.SUCCESS);
 }
 async function renderOpencodeValidate(opencodePath) {
-  const { runOpencodeValidate } = await import("./init-opencode-5WSAP46F.js");
+  const { runOpencodeValidate } = await import("./init-opencode-3NZVCAQX.js");
   const result = await runOpencodeValidate(opencodePath);
   if (!result.ok) {
     process.stderr.write(`init --opencode --validate: ${result.reason ?? "failed"}
@@ -25398,19 +25398,32 @@ async function handleUsageCommand(args) {
   if (opts.modelId !== void 0) {
     loadOpts.modelId = opts.modelId;
   }
-  const events = loadUsageEvents(loadOpts);
-  const rollups = rollupByModel(events);
+  const ledger = loadUsageEvents(loadOpts);
+  const rollups = rollupByModel(ledger.events);
+  const exitCode = ledger.complete ? EXIT_CODES.SUCCESS : EXIT_CODES.SERVER_START_FAILED;
   if (opts.format === "json") {
-    process.stdout.write(`${JSON.stringify({ since: opts.sinceIso, rollups }, null, 2)}
-`);
+    process.stdout.write(
+      `${JSON.stringify(
+        {
+          since: opts.sinceIso,
+          complete: ledger.complete,
+          readErrors: ledger.readErrors,
+          rollups
+        },
+        null,
+        2
+      )}
+`
+    );
     await Promise.resolve();
-    return cliExit(EXIT_CODES.SUCCESS);
+    return cliExit(exitCode);
   }
-  printTextReport(opts, rollups, events.length);
+  printTextReport(opts, rollups, ledger.events.length, ledger.complete);
+  printReadStatus(ledger.readErrors);
   await Promise.resolve();
-  return cliExit(EXIT_CODES.SUCCESS);
+  return cliExit(exitCode);
 }
-function printTextReport(opts, rollups, totalEvents) {
+function printTextReport(opts, rollups, totalEvents, complete) {
   console.log("Nexus Agents \u2014 Usage Report");
   console.log("===========================");
   console.log(`Window: ${opts.sinceIso} \u2192 ${opts.untilIso ?? "now"}`);
@@ -25420,6 +25433,7 @@ function printTextReport(opts, rollups, totalEvents) {
   console.log(`Events: ${String(totalEvents)}
 `);
   if (rollups.length === 0) {
+    if (!complete) return;
     console.log("No usage events recorded for this window.");
     console.log("");
     console.log("To start recording, calls must reach a recordUsageEvent()-instrumented");
@@ -25434,14 +25448,30 @@ function printTextReport(opts, rollups, totalEvents) {
     console.log(
       `  tokens          : ${String(r.totalInputTokens)} in / ${String(r.totalOutputTokens)} out`
     );
-    console.log(
-      `  cost            : $${r.totalUsdCost.toFixed(4)} ($${r.costPerSuccessUsd.toFixed(4)} / success)`
-    );
+    const costPerSuccess = r.costPerSuccessUsd === null ? "N/A (no successes)" : `${r.unpricedCallCount === 0 ? "" : "\u2265 "}$${r.costPerSuccessUsd.toFixed(4)} / success`;
+    console.log(`  cost            : ${formatCost2(r.totalUsdCost, r.unpricedCallCount)}`);
+    console.log(`  cost / success  : ${costPerSuccess}`);
     console.log(`  avg latency     : ${r.avgLatencyMs.toFixed(0)}ms`);
     console.log("");
   }
   const totalCost = rollups.reduce((s, r) => s + r.totalUsdCost, 0);
-  console.log(`Total cost: $${totalCost.toFixed(4)} across ${String(rollups.length)} model(s).`);
+  const totalUnpriced = rollups.reduce((sum, rollup) => sum + rollup.unpricedCallCount, 0);
+  console.log(
+    `Total cost: ${formatCost2(totalCost, totalUnpriced)} across ${String(rollups.length)} model(s).`
+  );
+}
+function formatCost2(costUsd, unpricedCallCount) {
+  const measured = `$${costUsd.toFixed(4)}`;
+  return unpricedCallCount === 0 ? measured : `\u2265 ${measured} (${String(unpricedCallCount)} unpriced)`;
+}
+function printReadStatus(readErrors) {
+  if (readErrors.length === 0) return;
+  if (readErrors[0]?.startsWith("usage ledger unreadable:") === true) {
+    console.error(readErrors.join("; "));
+    return;
+  }
+  console.error(`Usage ledger partial: ${String(readErrors.length)} file(s) unreadable.`);
+  for (const error of readErrors) console.error(`  ${error}`);
 }
 
 // src/cli/improvement-review-command.ts