nexus-agents 2.157.1 → 2.158.0

package/dist/{chunk-O7VPOR5A.js → chunk-R76LLKT2.js}

@@ -1,19 +1,19 @@
 import {
   resolveToken
-} from "./chunk-3S2OPUGU.js";
+} from "./chunk-XLJCXM7L.js";
 import {
   REGISTRY_PATH,
   getProjectRoot,
   loadPapersRegistry,
   loadTechniquesRegistry,
   savePapersRegistry
-} from "./chunk-HWG437YQ.js";
+} from "./chunk-YH5U3XCP.js";
 import {
   resolveInsideRoot
 } from "./chunk-NUBSJGQZ.js";
 import {
   getToolMemory
-} from "./chunk-7YOJXOFN.js";
+} from "./chunk-GG7MGRQ6.js";
 import {
   capitalizeWords
 } from "./chunk-6T3EPABN.js";
@@ -27,7 +27,7 @@ import {
   getOutcomeStore,
   getTimeProvider,
   registerPersistentDistillerFactory
-} from "./chunk-RCSDD2QY.js";
+} from "./chunk-Q4JNYY2Y.js";
 import {
   ensureLearningDir,
   getRulesFile
@@ -2686,4 +2686,4 @@ export {
   summarizeContextForPrompt,
   getContextPromptPrefix
 };
-//# sourceMappingURL=chunk-O7VPOR5A.js.map
+//# sourceMappingURL=chunk-R76LLKT2.js.map

package/dist/{chunk-YGYJUPVX.js → chunk-RI3BFANI.js}

@@ -3,7 +3,7 @@ import {
   MODEL_IDS,
   getTimeProvider,
   resolveModelIdentitySync
-} from "./chunk-RCSDD2QY.js";
+} from "./chunk-Q4JNYY2Y.js";
 
 // src/config/model-availability.ts
 var DEFAULT_TTL_MS = 6e4;
@@ -150,4 +150,4 @@ export {
   resetAvailabilityCache,
   filterAvailableModels
 };
-//# sourceMappingURL=chunk-YGYJUPVX.js.map
+//# sourceMappingURL=chunk-RI3BFANI.js.map

package/dist/{chunk-UAGYCCHY.js → chunk-S3H4VWN5.js}

@@ -2,7 +2,7 @@ import {
   CACHE_TIMEOUTS,
   createLogger,
   getTimeProvider
-} from "./chunk-RCSDD2QY.js";
+} from "./chunk-Q4JNYY2Y.js";
 
 // src/security/trust-types.ts
 import { z } from "zod";
@@ -560,4 +560,4 @@ export {
   resolveReputationGatingMode,
   gateWithReputation
 };
-//# sourceMappingURL=chunk-UAGYCCHY.js.map
+//# sourceMappingURL=chunk-S3H4VWN5.js.map

package/dist/{chunk-M532SJS6.js → chunk-S7PFS6PX.js}

@@ -5,24 +5,24 @@ import {
   planOptionalParams,
   requireApiKey,
   validateApiKeyPresence
-} from "./chunk-JZ4PCEEN.js";
+} from "./chunk-55ZDYUBT.js";
 import {
   CUSTOM_API_BASE_URL_ENV,
   CUSTOM_API_DEFAULT_MODEL,
   PROVIDER_ENV_KEYS,
   assertCustomApiHostResolvesPublic,
   validateCustomApiBaseUrl
-} from "./chunk-TNRTP5FW.js";
+} from "./chunk-I32MYAT5.js";
 import {
   CliCircuitBreaker,
   DEFAULT_CIRCUIT_BREAKER_CONFIG
-} from "./chunk-GYWYCCJC.js";
+} from "./chunk-YQRP5NST.js";
 import {
   getAvailabilityCache
-} from "./chunk-YGYJUPVX.js";
+} from "./chunk-RI3BFANI.js";
 import {
   generateHyphenId
-} from "./chunk-MYSS22Q2.js";
+} from "./chunk-U5KSLUZ6.js";
 import {
   CLI_SUBPROCESS_TIMEOUTS,
   CLI_TIMEOUTS,
@@ -58,7 +58,7 @@ import {
   loadModelsDevSnapshot,
   ok,
   resolveCliAlias
-} from "./chunk-RCSDD2QY.js";
+} from "./chunk-Q4JNYY2Y.js";
 
 // src/cli-adapters/cli-to-model-adapter.ts
 var CliToModelAdapter = class {
@@ -4867,4 +4867,4 @@ export {
   SdkAdapter,
   createAutoAdapter
 };
-//# sourceMappingURL=chunk-M532SJS6.js.map
+//# sourceMappingURL=chunk-S7PFS6PX.js.map

package/dist/{chunk-VEINXCXS.js → chunk-SPOES3DZ.js}

@@ -1,6 +1,6 @@
 import {
   generateSecurityPlan
-} from "./chunk-5FH7QZIT.js";
+} from "./chunk-6MCSD37T.js";
 import {
   analyzeGitHubRepo
 } from "./chunk-HFOQKCD2.js";
@@ -18,10 +18,10 @@ import {
   DEFAULT_TASK_TTL_MS,
   DEFAULT_TOOL_RATE_LIMITS,
   clampTaskTtl
-} from "./chunk-RHUKGSH7.js";
+} from "./chunk-J6OUXCR3.js";
 import {
   executeExpert
-} from "./chunk-BGAK4N74.js";
+} from "./chunk-LSWGHIJK.js";
 import {
   JobStatusSchema,
   abortJob,
@@ -42,21 +42,21 @@ import {
   simulationDeniedResult,
   toJobSummary,
   writeJobCancelled
-} from "./chunk-JWCD3JCB.js";
+} from "./chunk-Q7TALELN.js";
 import {
   normalizeTopicToCanonical,
   synthesizeResearch
-} from "./chunk-XGUZ2OQK.js";
+} from "./chunk-OOGGQ2NA.js";
 import {
   IssueTriage
-} from "./chunk-YZQXCCEA.js";
+} from "./chunk-6B5VQ2SY.js";
 import {
   resolveEnvMode,
   sanitizeInput
-} from "./chunk-UAGYCCHY.js";
+} from "./chunk-S3H4VWN5.js";
 import {
   withPrerequisite
-} from "./chunk-LZ2LHYDO.js";
+} from "./chunk-K6HJLOPA.js";
 import {
   NOOP_NOTIFIER,
   RateLimiter,
@@ -79,12 +79,12 @@ import {
   withAuditTrail,
   withProgressHeartbeat,
   wrapToolWithTimeout
-} from "./chunk-PZDDA6IW.js";
+} from "./chunk-2O63LDYB.js";
 import {
   createAuditTrail,
   createGraphAuditBridge,
   emitPipelinePolicyEvent
-} from "./chunk-BM26VPV5.js";
+} from "./chunk-42ZSRIEX.js";
 import {
   addResearchPaper,
   addSourceToRegistry,
@@ -112,15 +112,15 @@ import {
   parseRegistry,
   sourceExistsInRegistry,
   summarizeContextForPrompt
-} from "./chunk-O7VPOR5A.js";
+} from "./chunk-R76LLKT2.js";
 import {
   getTokenEnvVars,
   resolveToken
-} from "./chunk-3S2OPUGU.js";
+} from "./chunk-XLJCXM7L.js";
 import {
   loadPapersRegistry,
   loadTechniquesRegistry
-} from "./chunk-HWG437YQ.js";
+} from "./chunk-YH5U3XCP.js";
 import {
   resolveInsideRoot
 } from "./chunk-NUBSJGQZ.js";
@@ -129,14 +129,14 @@ import {
   MemoryImportance,
   calculateTextJaccardSimilarity,
   getToolMemory
-} from "./chunk-7YOJXOFN.js";
+} from "./chunk-GG7MGRQ6.js";
 import {
   STOPWORDS,
   truncateWithInfo
 } from "./chunk-6T3EPABN.js";
 import {
   createSessionMemory
-} from "./chunk-IILTUCFB.js";
+} from "./chunk-DSUFV2ZN.js";
 import {
   BUILT_IN_EXPERTS,
   BuiltInExpertTypeSchema,
@@ -151,7 +151,7 @@ import {
   createEvent,
   getGlobalEventBus,
   getGlobalRegistry
-} from "./chunk-TKCXD36G.js";
+} from "./chunk-VKVJSPHJ.js";
 import {
   CliDetectionCache,
   asRecord,
@@ -159,19 +159,19 @@ import {
   getAvailableClis,
   sleep,
   withTimeout
-} from "./chunk-M532SJS6.js";
+} from "./chunk-S7PFS6PX.js";
 import {
   DEFAULTS
-} from "./chunk-TNRTP5FW.js";
+} from "./chunk-I32MYAT5.js";
 import {
   getAvailabilityCache,
   getCliForModelId,
   resolveFallback
-} from "./chunk-YGYJUPVX.js";
+} from "./chunk-RI3BFANI.js";
 import {
   generateHyphenId,
   generateUUID
-} from "./chunk-MYSS22Q2.js";
+} from "./chunk-U5KSLUZ6.js";
 import {
   AGENT_ROUTER_TIMEOUTS,
   API_TIMEOUTS,
@@ -263,7 +263,7 @@ import {
   selectStrategyByManifest,
   toExpertTaskAnalysisResult,
   withStep
-} from "./chunk-RCSDD2QY.js";
+} from "./chunk-Q4JNYY2Y.js";
 import {
   ensureLearningDir,
   getMetaOutcomesFile,
@@ -26298,7 +26298,7 @@ function execIdFields(executionId) {
 async function populateUnifiedContextOnState(state, options) {
   const taskCandidate = state["task"];
   if (typeof taskCandidate !== "string" || taskCandidate === "") return;
-  const { getContextForTask: getContextForTask2, inferTaskCategory: inferTaskCategory2 } = await import("./context-retriever-33SGXV33.js");
+  const { getContextForTask: getContextForTask2, inferTaskCategory: inferTaskCategory2 } = await import("./context-retriever-MPZ7T4VA.js");
   const category = inferTaskCategory2(taskCandidate);
   const executionId = options?.executionId;
   const execFields = execIdFields(executionId);
@@ -41572,7 +41572,7 @@ async function tryIssueTriage(task) {
   try {
     const issueMatch = task.match(/github\.com\/([^/]+\/[^/]+)\/issues\/(\d+)/);
     if (issueMatch === null) return null;
-    const { createIssueTriage } = await import("./issue-triage-OP3FDRKY.js");
+    const { createIssueTriage } = await import("./issue-triage-7TWTN6LI.js");
     const triage = createIssueTriage();
     const owner = issueMatch[1] ?? "";
     const num = issueMatch[2] ?? "";
@@ -41600,7 +41600,7 @@ var VALID_TEMPLATES = /* @__PURE__ */ new Set([
 ]);
 async function classifyWithLLM(task) {
   try {
-    const { executeExpert: executeExpert2 } = await import("./expert-bridge-RJP57L75.js");
+    const { executeExpert: executeExpert2 } = await import("./expert-bridge-EK362QGQ.js");
     const prompt = [
       "Classify this task into exactly one pipeline template.",
       "Templates: dev (implementation/bug fix/refactor), research (investigate/evaluate/compare),",
@@ -43241,7 +43241,7 @@ var memoryInitPromise = null;
 async function initPipelineMemory() {
   if (cachedMemory !== null) return cachedMemory;
   try {
-    const { createSessionMemory: createSessionMemory2 } = await import("./session-memory-RA7KE6CX.js");
+    const { createSessionMemory: createSessionMemory2 } = await import("./session-memory-TVV2IOGB.js");
     const { getLearningDir } = await import("./learning-persistence-M3OTCCNI.js");
     const mem = createSessionMemory2(getLearningDir());
     mem.startSession(`pipeline-${String(getTimeProvider().now())}`);
@@ -43303,7 +43303,7 @@ function recordRoutingExperience(category, success, durationMs, tokensUsed = 0,
     callRecord(routingMemoryCache);
     return;
   }
-  routingMemoryInitPromise ??= import("./routing-memory-FE4EQUXO.js").then(({ createRoutingMemory }) => {
+  routingMemoryInitPromise ??= import("./routing-memory-PP4UJVH4.js").then(({ createRoutingMemory }) => {
     routingMemoryCache ??= createRoutingMemory();
     return routingMemoryCache;
   }).catch((error) => {
@@ -43337,7 +43337,7 @@ ${text}` : "";
 }
 async function getWeatherContext() {
   try {
-    const { generateWeatherReport: generateWeatherReport2 } = await import("./weather-report-HRQCJEU5.js");
+    const { generateWeatherReport: generateWeatherReport2 } = await import("./weather-report-XPDW6LGI.js");
     const report = generateWeatherReport2({ includeAdaptive: true });
     const mappings = "recommendedMappings" in report ? report.recommendedMappings : [];
     if (!Array.isArray(mappings) || mappings.length === 0) return "";
@@ -43355,7 +43355,7 @@ ${lines}
 }
 async function getMemoryContext(task) {
   try {
-    const { createSessionMemory: createSessionMemory2 } = await import("./session-memory-RA7KE6CX.js");
+    const { createSessionMemory: createSessionMemory2 } = await import("./session-memory-TVV2IOGB.js");
     const { getLearningDir } = await import("./learning-persistence-M3OTCCNI.js");
     const memory = createSessionMemory2(getLearningDir(), { maxLearningsInContext: 10 });
     const learnings = memory.searchLearnings(task.slice(0, 200));
@@ -43467,7 +43467,7 @@ ${contextBlock}`;
       const strategy = config.votingStrategy ?? "higher_order";
       await postProgress(config, "Vote", `Running consensus with ${strategy} strategy...`);
       try {
-        const { executeVoting } = await import("./consensus-vote-ZYZMDGT5.js");
+        const { executeVoting } = await import("./consensus-vote-MMZTCPL7.js");
         const votingResult = await executeVoting(
           {
             proposal: buildVoteProposal(plan, research),
@@ -43904,7 +43904,7 @@ async function searchCodebaseForTask(task) {
 }
 async function queryResearchRegistry(task) {
   try {
-    const { synthesizeResearch: synthesizeResearch2 } = await import("./research-helpers-synthesize-KUA53BAD.js");
+    const { synthesizeResearch: synthesizeResearch2 } = await import("./research-helpers-synthesize-VCUOMHPD.js");
     const topic = task.split(/[.!?\n]/).filter((s) => s.trim().length > 10)[0]?.trim();
     if (topic === void 0) return null;
     const result = await synthesizeResearch2(topic.slice(0, 50));
@@ -43975,7 +43975,7 @@ function createScanStageWrapper() {
       try {
         const slug = ctx.task.match(/([a-zA-Z0-9._-]+\/[a-zA-Z0-9._-]+)/)?.[1];
         if (slug !== void 0) {
-          const { generateSecurityPlan: generateSecurityPlan2 } = await import("./repo-security-plan-D62HB5PK.js");
+          const { generateSecurityPlan: generateSecurityPlan2 } = await import("./repo-security-plan-VSQWMONM.js");
           const plan = await generateSecurityPlan2({ repo: slug, maxScanners: 10 });
           const recs = plan.recommendations.slice(0, 5).map((r) => `${r.priority}: ${r.displayName} (${r.category})`).join("; ");
           return output(PIPELINE_STATE_KEYS.FINDINGS, recs, getTimeProvider().now() - start, true);
@@ -46935,7 +46935,7 @@ var GitHubTaskTracker = class {
   cachedProvider = null;
   async getProvider() {
     if (this.cachedProvider !== null) return this.cachedProvider;
-    const { createScmProvider } = await import("./factory-YOUM5MCV.js");
+    const { createScmProvider } = await import("./factory-XBUQP3UB.js");
     const result = await createScmProvider({ repo: this.config.repo ?? "" });
     if (!result.ok) throw new Error(`SCM provider error: ${result.error.message}`);
     this.cachedProvider = result.value;
@@ -47742,7 +47742,7 @@ async function probeSource(source, includeModelIds) {
   }
 }
 async function defaultSources(includeOpenRouter) {
-  const { createAllAdapters: createAllAdapters2 } = await import("./factory-C5PY7R6O.js");
+  const { createAllAdapters: createAllAdapters2 } = await import("./factory-GOO7MH5G.js");
   const adapters = createAllAdapters2();
   return buildDefaultModelSources(adapters, { includeOpenRouter });
 }
@@ -51809,4 +51809,4 @@ export {
   shutdownFeedbackSubscriber,
   createEventBusBridge
 };
-//# sourceMappingURL=chunk-VEINXCXS.js.map
+//# sourceMappingURL=chunk-SPOES3DZ.js.map

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';
 
 /**