@tangle-network/agent-runtime 0.246.0 → 0.249.1

package/dist/intelligence.d.ts

@@ -1,9 +1,9 @@
-import { Gi as RuntimeStreamEvent, nn as RuntimeTelemetryOptions, oi as LoopTraceEvent } from "./types-BoEzH8V6.js";
+import { Gi as RuntimeStreamEvent, nn as RuntimeTelemetryOptions, oi as LoopTraceEvent } from "./types-BmxS-W-f.js";
 import { d as RunAnalystLoopOpts, f as RunAnalystLoopResult } from "./types-zWfqDjeL.js";
-import { Tn as ToolSpec, er as Redactor, nr as resolveRedactor, tr as defaultRedactor, vt as AgentEnvironmentProviderRef, yt as AgentEnvironmentProviderRegistry } from "./stream-agent-turn-DQ-W8mHf.js";
+import { Tn as ToolSpec, er as Redactor, nr as resolveRedactor, tr as defaultRedactor, vt as AgentEnvironmentProviderRef, yt as AgentEnvironmentProviderRegistry } from "./stream-agent-turn-D9IbZMys.js";
 import { D as AgentCandidateRunFinalization, O as AgentCandidateTaskExecution, a as AgentCandidateExecutionPorts, c as AgentCandidateExecutorPort, r as AgentCandidateBenchmarkGraderPort, y as AgentCandidateOutputArtifactPort } from "./types-CuXu5zuS.js";
 import { T as AgentCandidateExecutionClaimStore, _ as PrepareAgentCandidateExecutionOptions, o as CreateProtectedAgentCandidateModelPortOptions, p as parseAgentCandidateProfileActivation, y as ExecutePreparedAgentCandidateOptions } from "./protected-model-port-BlLP8ja6.js";
-import { H as ImproveOptions, J as ImproveScenarioPartitions, K as ImproveResult, R as ImproveMethodOptions, a as AgentImprovementActivationTransitionInput, c as CreateAgentImprovementActivationResultOptions, d as ProfileImprovementActivationTransitionInput, f as SealedCandidateActivationTransitionInput, h as verifyAgentImprovementActivationResult, i as AgentImprovementActivationTransition, l as ExecuteAgentImprovementActivationInput, m as executeAgentImprovementActivation, n as AgentImprovementActivationResultStore, o as AgentProfileImprovementActivationOperation, p as createAgentImprovementActivationResult, r as AgentImprovementActivationTargetPlan, s as AgentProfileImprovementActivationTargetPlan, t as AgentImprovementActivationReconciliation, u as ExecuteAgentImprovementActivationOptions, z as ImproveMethodResult } from "./activation-Df-ae5Uq.js";
+import { H as ImproveOptions, J as ImproveScenarioPartitions, K as ImproveResult, R as ImproveMethodOptions, a as AgentImprovementActivationTransitionInput, c as CreateAgentImprovementActivationResultOptions, d as ProfileImprovementActivationTransitionInput, f as SealedCandidateActivationTransitionInput, h as verifyAgentImprovementActivationResult, i as AgentImprovementActivationTransition, l as ExecuteAgentImprovementActivationInput, m as executeAgentImprovementActivation, n as AgentImprovementActivationResultStore, o as AgentProfileImprovementActivationOperation, p as createAgentImprovementActivationResult, r as AgentImprovementActivationTargetPlan, s as AgentProfileImprovementActivationTargetPlan, t as AgentImprovementActivationReconciliation, u as ExecuteAgentImprovementActivationOptions, z as ImproveMethodResult } from "./activation-CZz7kkgd.js";
 import { AgentCandidateBenchmarkCellRef, AgentCandidateBundle, AgentCandidateEvaluationPolicy, AgentCandidateExperiment, AgentCandidateExperimentMaterial, AgentCandidateExperimentMeasurement, AgentCandidateLineage, AgentCandidateProfileActivation as CandidateProfileMaterialization, AgentImprovementActivation, AgentImprovementActivation as AgentImprovementActivation$1, AgentImprovementActivationIntent, AgentImprovementActivationIntent as AgentImprovementActivationIntent$1, AgentImprovementActivationOutcome, AgentImprovementActivationResult, AgentImprovementActivationTarget, AgentImprovementActivationTargetState, AgentImprovementActivationTargetTransition, AgentImprovementEvaluation, AgentImprovementEvaluation as AgentImprovementEvaluation$1, AgentImprovementMeasuredComparison, AgentImprovementMeasuredComparison as AgentImprovementMeasuredComparison$1, AgentImprovementProposal, AgentImprovementProposal as AgentImprovementProposal$1, AgentImprovementReview, AgentImprovementReview as AgentImprovementReview$1, AgentImprovementReviewDecision, AgentImprovementReviewDecision as AgentImprovementReviewDecision$1, AgentImprovementSource, AgentImprovementSurface, AgentProfile, AgentProfileDiff, AgentProfileImprovementChange, AgentProfileImprovementExecutionRef, AgentProfileImprovementExperiment, AgentProfileImprovementMeasuredComparison, AgentProfileImprovementMeasurement, AgentProfileImprovementRunReceipt, AgentProfileImprovementTaskMaterial, AgentProfileMcpServer, CandidateExecutionEvidence, CandidateExecutionEvidence as CandidateExecutionEvidence$1, Sha256Digest } from "@tangle-network/agent-interface";
 import { CostLedgerHandle, TraceStore } from "@tangle-network/agent-eval";
 import { ProposalFinding as ProposalFinding$1 } from "@tangle-network/agent-eval/analyst";
@@ -639,8 +639,10 @@ interface CertifiedPromptSource {
   compose(base: string): Promise<string>;
   /** The certified profile currently in effect (`null` = none pulled yet). */
   current(): CertifiedProfile | null;
-  /** Pull now if the refresh window has elapsed; coalesced and fail-closed. */
-  refresh(): Promise<void>;
+  /** Pull after the refresh window, or force a pull now. Both join an in-flight pull. */
+  refresh(options?: {
+    force?: boolean;
+  }): Promise<void>;
 }
 /** Options for {@link createCertifiedPromptSource} — the pull coordinates plus
  *  the refresh cadence. */
@@ -1048,7 +1050,7 @@ interface AppliedIntelligence {
   applyProfile(base: AgentProfile): AgentProfile;
   /** Enrich the {@link RunRecord} sent for this call — outcome, usage split,
    *  model/provider, and the loop event stream. Optional; an un-recorded run
-   *  still sends input/output with an inference-only zero usage split. */
+   *  still sends input/output with unknown usage, except for the OFF billing guarantee. */
   record(report: RunReport): void;
 }
 /** An agent wrapped by {@link withIntelligence}: receives the input plus the
@@ -1096,10 +1098,16 @@ declare function withIntelligence<I, O>(agent: IntelligenceAgent<I, O>, config:
  * bill. This is a classification on the trace, NOT a budget-pool split.
  */
 interface UsageSplit {
-  /** Base-stream (model) spend in USD. */
+  /** Observed base-stream spend in USD; a subtotal when `inferenceUsdKnown` is false. */
   inferenceUsd: number;
   /** Intelligence-spawn spend in USD. Provably `0` at the OFF tier. */
   intelligenceUsd: number;
+  /** False when inference cost is incomplete or unreported. */
+  inferenceUsdKnown?: false;
+  /** False when Intelligence cost is incomplete or unreported. */
+  intelligenceUsdKnown?: false;
+  /** Reported inference estimate, separate from observed spend and completeness. */
+  estimatedInferenceUsd?: number;
 }
 /**
  * The typed record `withIntelligence` sends per call — serialized through the
@@ -1139,6 +1147,8 @@ interface RunRecord {
     output: number;
     cachedInput?: number;
     reasoning?: number;
+    /** False when the numeric token subtotals are incomplete. */
+    tokensKnown?: false;
   };
   error?: {
     name: string;
@@ -1151,8 +1161,8 @@ interface RunRecord {
 /**
  * What an agent reports (via `applied.record`) to enrich the {@link RunRecord}
  * sent for its call. All optional — an un-recorded run still sends input/output
- * with an inference-only zero usage split. `costUsd` without a split is treated
- * as pure inference (the base stream).
+ * with unknown usage, except for the OFF billing guarantee.
+ * `costUsd` supplies inference spend when the split omits it.
  */
 interface RunReport {
   success?: boolean;
@@ -1251,10 +1261,9 @@ interface TraceHandle {
   /** Capture the run's output. Exported through the redactor. */
   recordOutput(output: unknown): void;
   /**
-   * Capture the run's outcome. `usage` defaults to inference-only
-   * (`intelligenceUsd: 0`) — the OFF baseline; an intelligence-enabled run
-   * fills `intelligenceUsd` itself. `costUsd`, when given without a split, is
-   * treated as pure inference.
+   * Capture the run's outcome. Unreported spend is unknown, except for Intelligence at OFF.
+   * `costUsd` supplies inference spend when the split omits it.
+   * Numeric usage updates replace subtotals; explicit incomplete flags remain sticky.
    */
   recordOutcome(outcome: {
     success?: boolean;

package/dist/intelligence.js

@@ -1,8 +1,8 @@
-import { Yn as resolveRedactor, ar as buildLoopOtelSpans, dr as flatOtelSpan, jn as resolveAgentEnvironmentProvider, lr as createOtelExporter, qn as defaultRedactor, sr as buildRuntimeEventOtelSpans } from "./supervisor-tGq-TPIv.js";
-import { C as optimizationActivationReceiptFromMetadata, D as agentImprovementProfileSurfaceDigest, E as agentImprovementProfileDiffs, F as isAgentImprovementProfileSurface, I as isAgentProfileMeasuredSurface, N as assertProfileImprovementTargetsShareIdentity, O as agentImprovementProfileSurfaceInput, P as buildAgentImprovementActivationTargets, S as createOptimizationActivationReceipt, T as AGENT_PROFILE_MEASURED_SURFACES, V as assertProfileTrainingIsHeldOut, _ as profilePolicyWithBudget, a as executeAgentCandidateExperimentCell, b as profileTaskScenarioIdentity, d as verifyAgentImprovementActivation, f as verifyAgentImprovementProposal, g as profileImprovementMetadata, h as createProfileImprovementCostLedger, i as createAgentImprovementProposal, j as agentImprovementTargetProfileDiffs, l as reviewAgentImprovementProposal, m as verifyCandidateExecutionEvidence, n as createAgentImprovementActivation, o as proposeAgentImprovement, p as verifyAgentImprovementReview, r as createAgentImprovementMeasuredComparison, s as proposeAgentProfileImprovement, t as AgentCandidateExperimentCellExecutionError, u as runAgentCandidateExperiment, v as profilePreparationAccounting, w as AGENT_IMPROVEMENT_PROFILE_SURFACES, x as sealProfileImprovementBenchmark, y as profileStateDigest$1 } from "./improvement-cycle-BE3gIJwL.js";
+import { Yn as resolveRedactor, ar as buildLoopOtelSpans, dr as flatOtelSpan, jn as resolveAgentEnvironmentProvider, lr as createOtelExporter, qn as defaultRedactor, sr as buildRuntimeEventOtelSpans } from "./supervisor-BIBWUFUr.js";
+import { a as createRuntimeUsageTotals, i as addRuntimeUsage, n as executeAgentImprovementActivation, o as isUsageAmount, r as verifyAgentImprovementActivationResult, t as createAgentImprovementActivationResult } from "./activation-ygjQvYwG.js";
+import { C as optimizationActivationReceiptFromMetadata, D as agentImprovementProfileSurfaceDigest, E as agentImprovementProfileDiffs, F as isAgentImprovementProfileSurface, I as isAgentProfileMeasuredSurface, N as assertProfileImprovementTargetsShareIdentity, O as agentImprovementProfileSurfaceInput, P as buildAgentImprovementActivationTargets, S as createOptimizationActivationReceipt, T as AGENT_PROFILE_MEASURED_SURFACES, V as assertProfileTrainingIsHeldOut, _ as profilePolicyWithBudget, a as executeAgentCandidateExperimentCell, b as profileTaskScenarioIdentity, d as verifyAgentImprovementActivation, f as verifyAgentImprovementProposal, g as profileImprovementMetadata, h as createProfileImprovementCostLedger, i as createAgentImprovementProposal, j as agentImprovementTargetProfileDiffs, l as reviewAgentImprovementProposal, m as verifyCandidateExecutionEvidence, n as createAgentImprovementActivation, o as proposeAgentImprovement, p as verifyAgentImprovementReview, r as createAgentImprovementMeasuredComparison, s as proposeAgentProfileImprovement, t as AgentCandidateExperimentCellExecutionError, u as runAgentCandidateExperiment, v as profilePreparationAccounting, w as AGENT_IMPROVEMENT_PROFILE_SURFACES, x as sealProfileImprovementBenchmark, y as profileStateDigest$1 } from "./improvement-cycle-B049YmQ8.js";
 import { o as canonicalCandidateDigest$1, u as immutableCandidateValue } from "./protected-redaction-Fn1ETfJ-.js";
 import { A as omitUndefinedObjectFields, M as parseExactAgentProfile, a as AGENT_CANDIDATE_EXECUTION_SUPPORT, j as parseAgentCandidateProfileActivation, w as applyExactAgentProfileDiff } from "./prepare-CibQrhfi.js";
-import { n as executeAgentImprovementActivation, r as verifyAgentImprovementActivationResult, t as createAgentImprovementActivationResult } from "./activation-C6d-NTWk.js";
 import { n as exactProcessProviderAsCandidateExecutor, t as createProtectedAgentCandidateModelPort } from "./protected-model-port-Dhdi5mDl.js";
 import { agentImprovementSourceSchema, agentProfileImprovementArmSchema, applyAgentProfileDiff } from "@tangle-network/agent-interface";
 import { contentHash } from "@tangle-network/agent-eval";
@@ -251,15 +251,16 @@ function composeCertifiedPrompt(base, certified) {
 * `withIntelligence` hook rides this same source for its prompt delivery.
 */
 function createCertifiedPromptSource(opts) {
-	const refreshMs = opts.refreshMs ?? defaultRefreshMs;
+	const pullOptions = { ...opts };
+	const refreshMs = pullOptions.refreshMs ?? defaultRefreshMs;
 	let certified = null;
-	let lastPullAt = 0;
+	let lastPullAt;
 	let inflight = null;
-	async function refresh() {
-		if (Date.now() - lastPullAt < refreshMs) return;
+	async function refresh(options) {
 		if (inflight) return inflight;
+		if (!options?.force && lastPullAt !== void 0 && Date.now() - lastPullAt < refreshMs) return;
 		inflight = (async () => {
-			const outcome = await pullCertified(opts);
+			const outcome = await pullCertified(pullOptions);
 			lastPullAt = Date.now();
 			if (outcome.succeeded) certified = outcome.value;
 		})();
@@ -370,6 +371,37 @@ function compileEffort(settings) {
 	};
 }
 //#endregion
+//#region src/intelligence/usage.ts
+/** Numeric reports replace subtotals; explicit or malformed missingness is irreversible. */
+function mergeReportedUsage(target, report) {
+	const update = {
+		...report.usage,
+		inferenceUsd: report.usage?.inferenceUsd ?? report.costUsd
+	};
+	for (const [amount, known] of [
+		["inferenceUsd", "inferenceUsdKnown"],
+		["intelligenceUsd", "intelligenceUsdKnown"],
+		["estimatedInferenceUsd", void 0]
+	]) {
+		const value = update[amount];
+		if (isUsageAmount(value)) target[amount] = value;
+		else if (value !== void 0 && known !== void 0) target[known] = false;
+		if (known !== void 0 && update[known] === false) target[known] = false;
+	}
+}
+/** Absence is unknown; OFF alone proves zero Intelligence spend without a receipt. */
+function normalizeReportedUsage(usage, intelligenceOff = false) {
+	const inferenceKnown = isUsageAmount(usage.inferenceUsd) && usage.inferenceUsdKnown !== false;
+	const intelligenceKnown = intelligenceOff || isUsageAmount(usage.intelligenceUsd) && usage.intelligenceUsdKnown !== false;
+	return {
+		inferenceUsd: isUsageAmount(usage.inferenceUsd) ? usage.inferenceUsd : 0,
+		intelligenceUsd: intelligenceOff || !isUsageAmount(usage.intelligenceUsd) ? 0 : usage.intelligenceUsd,
+		...!inferenceKnown ? { inferenceUsdKnown: false } : {},
+		...!intelligenceKnown ? { intelligenceUsdKnown: false } : {},
+		...isUsageAmount(usage.estimatedInferenceUsd) ? { estimatedInferenceUsd: usage.estimatedInferenceUsd } : {}
+	};
+}
+//#endregion
 //#region src/intelligence/authored-profile-improvement.ts
 /**
 * Put a complete authored/imported profile through the canonical profile
@@ -888,18 +920,12 @@ function assertUniqueProfileTargets(targets) {
 //#endregion
 //#region src/intelligence/with-intelligence.ts
 function summarizeRuntimeEvents(events) {
-	const summary = {
-		inferenceUsd: 0,
-		inputTokens: 0,
-		outputTokens: 0
-	};
+	const summary = createRuntimeUsageTotals();
 	for (const event of events) {
 		if ("session" in event && event.session) summary.sessionId = event.session.id;
 		if (event.type === "llm_call") {
 			summary.model = event.model;
-			summary.inferenceUsd += event.costUsd ?? 0;
-			summary.inputTokens += event.tokensIn ?? 0;
-			summary.outputTokens += event.tokensOut ?? 0;
+			addRuntimeUsage(summary, event);
 		} else if (event.type === "backend_error") {
 			summary.success = false;
 			summary.error = {
@@ -974,6 +1000,7 @@ function withIntelligence(agent, config) {
 		const certified = source.current();
 		const proposals = currentProposals();
 		const report = {};
+		const usage = {};
 		const applied = {
 			runId,
 			traceId,
@@ -981,16 +1008,41 @@ function withIntelligence(agent, config) {
 			composePrompt: (base) => composeCertifiedPrompt(base, certified),
 			proposals,
 			applyProfile: (base) => proposals.reduce((profile, p) => applyAgentProfileDiff(profile, p.diff), base),
-			record: (r) => Object.assign(report, r)
+			record: (r) => {
+				const tokens = r.tokens ?? report.tokens;
+				const tokensIncomplete = report.tokens?.tokensKnown === false || tokens?.tokensKnown === false;
+				mergeReportedUsage(usage, r);
+				Object.assign(report, r, {
+					usage,
+					...tokens ? { tokens: {
+						...tokens,
+						...tokensIncomplete ? { tokensKnown: false } : {}
+					} } : {}
+				});
+			}
 		};
 		function exportCompleted(output, caught) {
 			const completedAt = Date.now();
 			const eventSummary = summarizeRuntimeEvents(report.runtimeEvents ?? []);
 			const error = report.error ?? (caught !== void 0 ? runError(caught) : eventSummary.error);
-			const tokens = report.tokens ?? (eventSummary.inputTokens > 0 || eventSummary.outputTokens > 0 ? {
-				input: eventSummary.inputTokens,
-				output: eventSummary.outputTokens
-			} : void 0);
+			const tokens = report.tokens !== void 0 || eventSummary.llmCalls > 0 ? {
+				input: eventSummary.tokensIn,
+				output: eventSummary.tokensOut,
+				...eventSummary.tokensKnown === false || report.tokens?.tokensKnown === false ? { tokensKnown: false } : {}
+			} : void 0;
+			if (tokens && report.tokens) for (const key of [
+				"input",
+				"output",
+				"cachedInput",
+				"reasoning"
+			]) {
+				const value = report.tokens[key];
+				if (isUsageAmount(value) && Number.isSafeInteger(value)) tokens[key] = value;
+				else if (value !== void 0 || key === "input" || key === "output") tokens.tokensKnown = false;
+			}
+			const reportedCost = report.usage?.inferenceUsd ?? report.costUsd;
+			const inferenceKnown = eventSummary.usdKnown !== false && report.usage?.inferenceUsdKnown !== false && (reportedCost !== void 0 ? isUsageAmount(reportedCost) : eventSummary.llmCalls > 0);
+			const estimatedInferenceUsd = isUsageAmount(report.usage?.estimatedInferenceUsd) ? report.usage.estimatedInferenceUsd : eventSummary.estimatedCostUsd;
 			const profile = report.profile ?? config.profile;
 			const record = {
 				runId,
@@ -1002,10 +1054,13 @@ function withIntelligence(agent, config) {
 				outcome: {
 					success: report.success ?? (caught !== void 0 ? false : eventSummary.success ?? error === void 0),
 					...report.score !== void 0 ? { score: report.score } : {},
-					usage: {
-						inferenceUsd: report.usage?.inferenceUsd ?? report.costUsd ?? eventSummary.inferenceUsd,
-						intelligenceUsd: report.usage?.intelligenceUsd ?? 0
-					}
+					usage: normalizeReportedUsage({
+						inferenceUsd: isUsageAmount(reportedCost) ? reportedCost : eventSummary.costUsd,
+						...inferenceKnown ? {} : { inferenceUsdKnown: false },
+						...isUsageAmount(estimatedInferenceUsd) ? { estimatedInferenceUsd } : {},
+						intelligenceUsd: report.usage?.intelligenceUsd,
+						...report.usage?.intelligenceUsdKnown === false ? { intelligenceUsdKnown: false } : {}
+					})
 				},
 				timing: {
 					startedAt,
@@ -1063,6 +1118,16 @@ function withIntelligence(agent, config) {
 * @module
 * @stable
 */
+function usageAttributes(usage, intelligenceOff) {
+	const normalized = normalizeReportedUsage(usage, intelligenceOff);
+	return {
+		"tangle.usage.inference_usd": normalized.inferenceUsd,
+		"tangle.usage.intelligence_usd": normalized.intelligenceUsd,
+		...normalized.inferenceUsdKnown === false ? { "tangle.usage.inference_usd_known": false } : {},
+		...normalized.intelligenceUsdKnown === false ? { "tangle.usage.intelligence_usd_known": false } : {},
+		...normalized.estimatedInferenceUsd !== void 0 ? { "tangle.usage.inference_usd_estimated": normalized.estimatedInferenceUsd } : {}
+	};
+}
 function resolveEffortConfig(effort) {
 	if (effort === void 0) return resolveEffort(defaultEffortTier);
 	if (typeof effort === "string") return resolveEffort(effort);
@@ -1132,8 +1197,7 @@ function createIntelligenceClient(config) {
 			const labels = {
 				project: config.project,
 				"tangle.effort.intelligence_off": outcome.intelligenceOff,
-				"tangle.usage.inference_usd": outcome.usage.inferenceUsd,
-				"tangle.usage.intelligence_usd": outcome.usage.intelligenceUsd,
+				...usageAttributes(outcome.usage, intelligenceOff),
 				...meta.model ? { "gen_ai.request.model": meta.model } : {},
 				...meta.provider ? { "provider.name": meta.provider } : {},
 				...typeof outcome.success === "boolean" ? { "tangle.outcome.success": outcome.success } : {},
@@ -1154,14 +1218,12 @@ function createIntelligenceClient(config) {
 		const ex = getExporter();
 		if (!ex) return record.traceId;
 		try {
-			const intelligenceUsd = intelligenceOff ? 0 : record.outcome.usage.intelligenceUsd;
 			const repository = record.repository ?? (config.repo ? `${config.repo.owner}/${config.repo.name}` : void 0);
 			const labels = {
 				project: record.project,
 				"tangle.target": record.target,
 				"tangle.effort.intelligence_off": intelligenceOff,
-				"tangle.usage.inference_usd": record.outcome.usage.inferenceUsd,
-				"tangle.usage.intelligence_usd": intelligenceUsd,
+				...usageAttributes(record.outcome.usage, intelligenceOff),
 				...record.model ? { "gen_ai.request.model": record.model } : {},
 				...record.provider ? { "provider.name": record.provider } : {},
 				...record.sessionId ? {
@@ -1179,6 +1241,7 @@ function createIntelligenceClient(config) {
 				...record.tokens ? {
 					"gen_ai.usage.input_tokens": record.tokens.input,
 					"gen_ai.usage.output_tokens": record.tokens.output,
+					...record.tokens.tokensKnown === false ? { "tangle.usage.tokens_known": false } : {},
 					...record.tokens.cachedInput !== void 0 ? { "gen_ai.usage.cache_read_input_tokens": record.tokens.cachedInput } : {},
 					...record.tokens.reasoning !== void 0 ? { "gen_ai.usage.reasoning_tokens": record.tokens.reasoning } : {}
 				} : {},
@@ -1237,10 +1300,7 @@ function createIntelligenceClient(config) {
 			const runId = meta.runId ?? freshRunId();
 			const traceId = meta.traceId ?? freshTraceId();
 			let recordedOutput;
-			const usage = {
-				inferenceUsd: 0,
-				intelligenceUsd: 0
-			};
+			const usage = {};
 			let success;
 			let score;
 			const result = await fn({
@@ -1250,13 +1310,9 @@ function createIntelligenceClient(config) {
 				recordOutcome(outcome) {
 					if (typeof outcome.success === "boolean") success = outcome.success;
 					if (typeof outcome.score === "number") score = outcome.score;
-					if (outcome.usage) {
-						if (typeof outcome.usage.inferenceUsd === "number") usage.inferenceUsd = outcome.usage.inferenceUsd;
-						if (typeof outcome.usage.intelligenceUsd === "number") usage.intelligenceUsd = outcome.usage.intelligenceUsd;
-					} else if (typeof outcome.costUsd === "number") usage.inferenceUsd = outcome.costUsd;
+					mergeReportedUsage(usage, outcome);
 				}
 			});
-			if (intelligenceOff) usage.intelligenceUsd = 0;
 			exportTrace(meta, {
 				runId,
 				traceId,
@@ -1265,7 +1321,7 @@ function createIntelligenceClient(config) {
 				intelligenceOff,
 				...success !== void 0 ? { success } : {},
 				...score !== void 0 ? { score } : {},
-				usage
+				usage: normalizeReportedUsage(usage, intelligenceOff)
 			}, recordedOutput);
 			return result;
 		},