@tangle-network/agent-runtime 0.247.0 → 0.252.0

package/dist/{types-BUhz284C.d.ts → types-BmxS-W-f.d.ts}

@@ -524,27 +524,38 @@ interface KnowledgeReadinessDecision {
   nonBlockingGapIds: string[];
 }
 //#endregion
+//#region src/runtime-usage.d.ts
+/** Observed subtotals, with missing measurements kept separate from measured zeroes. */
+interface RuntimeUsageTotals {
+  /** Observed input tokens across normalized per-call events. */
+  tokensIn: number;
+  /** Observed output tokens across normalized per-call events. */
+  tokensOut: number;
+  /** Observed dollar subtotal; incomplete when `usdKnown` is false. */
+  costUsd: number;
+  /** Number of observed model calls, including unpriced or incompletely metered calls. */
+  llmCalls: number;
+  /** False when any observed call has incomplete token usage. */
+  tokensKnown?: false;
+  /** False when any observed call lacks complete provider-billed cost. */
+  usdKnown?: false;
+  /** Sum of reported external estimates; never included in `costUsd` or proof of complete cost. */
+  estimatedCostUsd?: number;
+}
+//#endregion
 //#region src/runtime-run.d.ts
 /** @stable */
 type RuntimeRunStatus = 'running' | 'completed' | 'failed' | 'cancelled';
 /** @stable */
-interface RuntimeRunCost {
-  /** Cumulative input tokens across every observed `llm_call` event. */
-  tokensIn: number;
-  /** Cumulative output tokens across every observed `llm_call` event. */
-  tokensOut: number;
-  /** Sum of `costUsd` from every observed `llm_call` event. */
-  costUsd: number;
+interface RuntimeRunCost extends RuntimeUsageTotals {
   /** Wall time from `startRuntimeRun()` to `complete()` (or `now()` if not yet completed). */
   wallMs: number;
-  /** Count of `llm_call` events observed during the run. */
-  llmCalls: number;
 }
 /** @stable */
 interface RuntimeRunCompleteInput {
   status: Exclude<RuntimeRunStatus, 'running'>;
   resultSummary?: string;
-  /** Optional explicit cost override; if omitted, the accumulated ledger is used. */
+  /** Optional subtotal overrides. Existing incomplete-usage flags remain authoritative. */
   cost?: Partial<RuntimeRunCost>;
   /** Stable error message when `status === 'failed'`. */
   error?: string;
@@ -4704,4 +4715,4 @@ interface WidenGate<Out> {
 }
 //#endregion
 export { SpawnPrior as $, captureHarnessTranscript as $n, LoopPlanPayload as $r, RuntimeStreamEventCollector as $t, NodeId as A, AgentRuntimeEventSink as Ai, RetainedPendingCause as An, BudgetPoolRestore as Ar, EvalRunEvent as At, ResumedWork as B, RunAgentTaskOptions as Bi, RecoverRetainedInteractiveRunOptions as Bn, spendFromUsageEvents as Br, RuntimeEventOtelOptions as Bt, ExecutorToolCall as C, startRuntimeRun as Ci, SessionTraceBox as Cn, RetainedRunReplayPoint as Cr, workerTraceHeaders as Ct, MaterializedModelIdentity as D, AgentExecutionBackend as Di, decodeToolPart as Dn, StartRetainedRunInEnvironmentOptions as Dr, mergeTraceEnv as Dt, MaterializedExecutionIdentity as E, AgentBackendInput as Ei, createPushTraceSource as En, RetainedRunTurnInput as Er, createPropagatingTraceEmitter as Et, ProviderModelExecutionEvidence as F, BackendErrorDetail as Fi, ScopeProgressInput as Fn, ReservationRejection as Fr, LoopSpanNode as Ft, RootSignal as G, RuntimeStreamEvent as Gi, StartRetainedInteractiveRunOptions as Gn, Iteration as Gr, createOtelExporter as Gt, RootHandle as H, RuntimeCanonicalStreamEvent as Hi, RetainedInteractiveEnvironmentInput as Hn, DefaultVerdict$1 as Hr, buildLoopSpanNodes as Ht, ResourceLimit as I, KnowledgeReadinessDecision as Ii, WorkerProgress as In, ReservationShortfall as Ir, OtelAttribute as It, Scope as J, HarnessTranscriptEvidence as Jn, LoopIterationDispatchPayload as Jr, loopEventToOtelSpan as Jt, RootStreamReceipt as K, HarnessTranscriptArtifact as Kn, LoopDecisionPayload as Kr, exportEvalRuns as Kt, ResourceSpend as L, OpenAIChatResponseFormat as Li, createActivityLog as Ln, ReservationStage as Lr, OtelExportConfig as Lt, NodeStatus as M, AgentTaskRunResult as Mi, ActivityNote as Mn, BudgetReconcileFault as Mr, EvalRunsExportConfig as Mt, ProfileMaterializationReceipt as N, AgentTaskSpec as Ni, DEFAULT_STALL_AFTER_MS as Nn, LeakedReservation as Nr, EvalRunsExportResult as Nt, NoWinnerError as O, AgentKnowledgeProvider as Oi, sandboxSessionTraceSource as On, StartRetainedRunOptions as Or, readTraceContextFromEnv as Ot, ProviderModelAttemptEvidence as P, AgentTaskStatus as Pi, ExecutorProgress as Pn, ReservationHolder as Pr, INTELLIGENCE_WIRE_VERSION as Pt, SpawnOpts as Q, ReadableEnvironment as Qn, LoopPlanDescription as Qr, RuntimeEventCollector as Qt, ResultBlobStore as R, OpenAIChatTool as Ri, readWorkerProgress as Rn, ReservationTicket as Rr, OtelExporter as Rt, ExecutorTeardownWarning as S, RuntimeRunStatus as Si, SessionMessageLike as Sn, RetainedRunIntentAdmission as Sr, workerTraceEnv as St, Handle as T, AgentBackendContext as Ti, TraceSource as Tn, RetainedRunStartMaterial as Tr, TraceContext as Tt, RootMaterialization as U, RuntimeSession as Ui, RetainedInteractiveRunHandle as Un, Driver as Ur, buildRuntimeEventOtelSpans as Ut, RetainedExecutionState as V, RunAgentTaskStreamOptions as Vi, RetainedInteractiveAdmissionHook as Vn, AgentRunSpec as Vr, buildLoopOtelSpans as Vt, RootProviderModelEvidence as W, RuntimeSessionStore as Wi, RetainedInteractiveStartMaterial as Wn, ExecCtx as Wr, createOpenInferenceFileExporter as Wt, SpawnEvent as X, HarnessTranscriptUnavailable as Xn, LoopIterationStartedPayload as Xr, padTraceId as Xt, Settled as Y, HarnessTranscriptFile as Yn, LoopIterationEndedPayload as Yr, padSpanId as Yt, SpawnJournal as Z, HarnessTranscriptUnavailableReason as Zn, LoopLineageOptions as Zr, toOtelAttributes as Zt, ExecutorMaterialization as _, RuntimeRunCost as _i, isWaitOutcome as _n, RetainedRunDispatchedAdmission as _r, WorkerTraceEvidence as _t, BudgetOverspend as a, LoopTraceEmitter as ai, createRuntimeEventCollector as an, ReconnectRetainedRunOptions as ar, SupervisedResult as at, ExecutorRegistry as b, RuntimeRunPersistenceAdapter as bi, validateWaitSpec as bn, RetainedRunEventOptions as br, WorkerTraceSeamCarrier as bt, EnvironmentTeardownReceipt as c, MountManifestEntry as ci, sanitizeKnowledgeReadinessReport as cn, RecoverRetainedRunResult as cr, TokenUsageProvenance as ct, ExecutorAccounting as d, RunProvenance as di, WaitOutcome as dn, RetainedInteractiveIntentAdmission as dr, UnknownMaterializationReason as dt, LoopResult as ei, RuntimeStreamEventSink as en, harnessTranscriptArtifact as er, SpawnRejection as et, ExecutorCancellation as f, SandboxClient as fi, WaitProbe as fn, RetainedInteractiveStartedAdmission as fr, UsageEvent as ft, ExecutorFactory as g, RuntimeRunCompleteInput as gi, createWaitProbes as gn, RetainedRunCancellation as gr, WorkerInteractiveUnavailableReason as gt, ExecutorExecutionBinding as h, Validator as hi, WaitSpec as hn, RetainedRunCancelOptions as hr, WorkerInteractiveSession as ht, Budget as i, LoopTokenUsage as ii, SanitizedKnowledgeRequirement as in, NativeContextContinuationInput as ir, SteerableRootHandle as it, NodeSnapshot as j, AgentTaskContext as ji, ActivityLog as jn, BudgetReadout as jr, EvalRunGeneration as jt, NodeExecutionIdentity as k, AgentRuntimeEvent as ki, RetainedChildRecovery as kn, BudgetPool as kr, traceContextToEnv as kt, ExecutionBindingReceipt as l, MountRecorder as li, sanitizeRuntimeStreamEvent as ln, RetainedInteractiveAdmission as lr, TreeView as lt, ExecutorContext as m, ValidationCtx as mi, WaitRejection as mn, RetainedRunAdmissionHook as mr, WidenGate as mt, AgentExecutionRef as n, LoopStartedPayload as ni, RuntimeTelemetryOptions as nn, NativeContextContinuationExecution as nr, SpendChannel as nt, BudgetViolation as o, LoopTraceEvent as oi, createRuntimeStreamEventCollector as on, RecoverRetainedRunIntentOptions as or, Supervisor as ot, ExecutorCancellationRequest as p, SelectionReceipt as pi, WaitProbeRegistry as pn, RetainedRunAdmission as pr, WaitOpts as pt, Runtime as q, HarnessTranscriptCapture as qn, LoopEndedPayload as qr, generateSpanId as qt, AgentSpec as r, LoopTeardownFailedPayload as ri, SanitizedKnowledgeReadinessReport as rn, NativeContextContinuationHandle as rr, SpendGap as rt, DefaultVerdict as s, LoopWinner as si, sanitizeAgentRuntimeEvent as sn, RecoverRetainedRunOptions as sr, SupervisorOpts as st, Agent as t, LoopSandboxPlacement as ti, RuntimeStreamEventSummary as tn, persistHarnessTranscript as tr, Spend as tt, Executor as u, OutputAdapter as ui, PendingWait as un, RetainedInteractiveEnvironmentAdmission as ur, UnconfirmedTeardown as ut, ExecutorNodeContext as v, RuntimeRunHandle as vi, pollFor as vn, RetainedRunEffect as vr, WorkerTraceUnavailableReason as vt, FleetYield as w, AgentAdapter as wi, ToolStepInput as wn, RetainedRunSnapshot as wr, workerTraceSeamKey as wt, ExecutorResult as x, RuntimeRunRow as xi, waitUntil as xn, RetainedRunHandle as xr, readWorkerTraceContext as xt, ExecutorProgressEvent as y, RuntimeRunOptions as yi, timerAt as yn, RetainedRunEnvironmentAdmission as yr, WorkerTraceResolver as yt, ResumedKeyState as z, OpenAIChatToolChoice as zi, ReconnectRetainedInteractiveRunOptions as zn, createBudgetPool as zr, OtelSpan as zt };
-//# sourceMappingURL=types-BUhz284C.d.ts.map
+//# sourceMappingURL=types-BmxS-W-f.d.ts.map