@mantyx/sdk 0.10.1 → 0.11.0

package/dist/{client-CZUVldDx.d.cts → client-Byb0Zdo7.d.cts}

@@ -47,6 +47,30 @@ declare class MantyxToolError extends MantyxError {
     readonly toolName: string;
     constructor(toolName: string, message: string);
 }
+/**
+ * Per-run token totals attached to terminal `result` / `error`
+ * events. See `docs/agent-runs-protocol.md` §7.1 for the per-provider
+ * mapping and the relationship between buckets. Re-exported from
+ * `client.ts` so error consumers can pattern-match the triple without
+ * a second import.
+ */
+interface MantyxRunErrorTokens {
+    inputTokens: number;
+    cachedTokens: number;
+    reasoningTokens: number;
+    outputTokens: number;
+}
+/**
+ * Resolved model that executed the run. Surfaced on terminal events
+ * by MANTYX ≥ 2026-09. See `docs/agent-runs-protocol.md` §7.1. The
+ * `provider` empty / undefined is the "no usage data" sentinel.
+ */
+interface MantyxRunErrorModel {
+    id: string;
+    provider: string;
+    vendorModelId: string;
+    reasoningEffort?: string;
+}
 /**
  * Optional triage attributes the runner attaches to terminal `error`
  * events. Mirrors the wire fields described in
@@ -83,6 +107,17 @@ interface MantyxRunErrorInit {
      * Informational; the SDK still owns the actual retry decision.
      */
     retryable?: boolean;
+    /**
+     * Per-run token totals from the terminal event. Present against
+     * MANTYX ≥ 2026-09 — see {@link MantyxRunErrorTokens} and
+     * `docs/agent-runs-protocol.md` §7.1. Includes the failing model
+     * call's usage when the run errored mid-loop.
+     */
+    tokens?: MantyxRunErrorTokens;
+    /** Total model invocations for the run, including the failing call. */
+    turns?: number;
+    /** Resolved model that executed the run. See {@link MantyxRunErrorModel}. */
+    model?: MantyxRunErrorModel;
 }
 declare class MantyxRunError extends MantyxError {
     readonly runId: string;
@@ -95,6 +130,12 @@ declare class MantyxRunError extends MantyxError {
     readonly partialText: string | undefined;
     /** See {@link MantyxRunErrorInit.retryable}. */
     readonly retryable: boolean | undefined;
+    /** See {@link MantyxRunErrorInit.tokens}. */
+    readonly tokens: MantyxRunErrorTokens | undefined;
+    /** See {@link MantyxRunErrorInit.turns}. */
+    readonly turns: number | undefined;
+    /** See {@link MantyxRunErrorInit.model}. */
+    readonly model: MantyxRunErrorModel | undefined;
     constructor(runId: string, subtype: string, message: string, init?: MantyxRunErrorInit);
 }
 /**
@@ -884,10 +925,102 @@ interface ToolBudget {
  * entirely to keep the defaults.
  */
 type ToolBudgets = Record<string, ToolBudget>;
+/**
+ * Per-run token totals attached to terminal `result` / `error` events
+ * (and to the `GET /agent-runs/:runId` snapshot) by MANTYX ≥ 2026-09.
+ *
+ * Aggregated across every model invocation for the run. See
+ * `docs/agent-runs-protocol.md` §7.1 for the per-provider mapping and
+ * the relationship between buckets (`inputTokens` / `outputTokens` are
+ * the billable totals; `cachedTokens` and `reasoningTokens` are
+ * diagnostic breakdowns _inside_ those two totals, not separate
+ * additive buckets).
+ *
+ * Older servers omit the cost-attribution triple entirely; SDK callers
+ * detect "no usage data" by checking `result.model?.provider` is empty
+ * / undefined.
+ */
+interface RunTokenUsage {
+    /**
+     * Total billable input tokens — fresh prompt tokens plus the
+     * cached-read slice the provider still bills (at a discount) plus
+     * any cache-creation tokens plus tool-prompt tokens. Equal to the
+     * sum of every provider-reported input bucket for the run.
+     */
+    inputTokens: number;
+    /**
+     * The discounted slice of `inputTokens` that came from a prompt
+     * cache hit (Anthropic prompt caching, OpenAI cached prompt, Gemini
+     * implicit cache). `0` when the provider doesn't report cache reads
+     * or the run didn't hit cache.
+     */
+    cachedTokens: number;
+    /**
+     * Non-visible thinking tokens. **Already counted inside
+     * `outputTokens`** — surfaced separately so dashboards can break out
+     * "thinking cost" vs visible output. `0` when the model didn't
+     * reason or didn't report it.
+     */
+    reasoningTokens: number;
+    /**
+     * All tokens the model emitted for this run, visible + reasoning.
+     * Matches the provider's "completion tokens" / "output tokens"
+     * billing line.
+     */
+    outputTokens: number;
+}
+/**
+ * The resolved model the platform stamped onto the run, surfaced on
+ * terminal `result` / `error` events (and `GET /agent-runs/:runId`)
+ * by MANTYX ≥ 2026-09. See `docs/agent-runs-protocol.md` §7.1.
+ */
+interface RunModelInfo {
+    /**
+     * Catalog id — the same string a caller would pass back as
+     * `modelId` to re-select this exact entry (e.g. `"platform:demo"`,
+     * `"provider:cmf…"`). Empty string against legacy fallbacks that
+     * didn't synthesise a catalog id.
+     */
+    id: string;
+    /**
+     * Lowercase provider id: `"openai"`, `"anthropic"`, `"google"`,
+     * `"azure-openai"`. Empty string against legacy runners that don't
+     * report usage data — SDK callers use that as the "no usage data"
+     * signal.
+     */
+    provider: string;
+    /**
+     * The model id the platform actually sent to the provider (e.g.
+     * `"gpt-5.4-mini"`, `"claude-opus-4-7"`, `"gemini-2.5-pro"`).
+     */
+    vendorModelId: string;
+    /**
+     * `"off" | "low" | "medium" | "high"`. Omitted when the provider
+     * doesn't expose a reasoning-level knob or the run didn't request
+     * one.
+     */
+    reasoningEffort?: string;
+}
 interface RunResult {
     runId: string;
     text: string;
     events: RunEvent[];
+    /**
+     * Per-run token totals from the terminal event. Undefined against
+     * MANTYX servers older than 2026-09 (the "no usage data" signal is
+     * `result.model?.provider` being empty / undefined). See
+     * {@link RunTokenUsage} and `docs/agent-runs-protocol.md` §7.1.
+     */
+    tokens?: RunTokenUsage;
+    /**
+     * Total `engine.completeTurn(...)` invocations for the run,
+     * including the failing call when a run errored mid-loop. A
+     * single-shot run reports `1`; a tool loop is `>= 2`. Undefined
+     * against legacy MANTYX servers.
+     */
+    turns?: number;
+    /** Resolved model that executed the run. See {@link RunModelInfo}. */
+    model?: RunModelInfo;
 }
 interface RunEventBase {
     seq: number;
@@ -1036,6 +1169,15 @@ interface ResultEvent extends RunEventBase {
     subtype: string;
     text?: string;
     error?: string;
+    /**
+     * Per-run token totals. Present against MANTYX ≥ 2026-09 — see
+     * {@link RunTokenUsage} and `docs/agent-runs-protocol.md` §7.1.
+     */
+    tokens?: RunTokenUsage;
+    /** Total model invocations for the run. See {@link RunResult.turns}. */
+    turns?: number;
+    /** Resolved model that executed the run. See {@link RunModelInfo}. */
+    model?: RunModelInfo;
 }
 interface ErrorEvent extends RunEventBase {
     type: "error";
@@ -1074,6 +1216,18 @@ interface ErrorEvent extends RunEventBase {
      * Informational; the SDK still owns the actual retry decision.
      */
     retryable?: boolean;
+    /**
+     * Per-run token totals. Present against MANTYX ≥ 2026-09 — see
+     * {@link RunTokenUsage} and `docs/agent-runs-protocol.md` §7.1.
+     * The pipeline counts the failing model call too, so a run that
+     * threw on the first turn reports `turns: 1` with that call's
+     * tokens already aggregated.
+     */
+    tokens?: RunTokenUsage;
+    /** Total model invocations for the run, including the failing call. */
+    turns?: number;
+    /** Resolved model that executed the run. See {@link RunModelInfo}. */
+    model?: RunModelInfo;
 }
 interface CancelledEvent extends RunEventBase {
     type: "cancelled";
@@ -1280,4 +1434,4 @@ interface LocalHandlers {
  */
 declare function parseRunOutput<T = unknown>(result: RunResult, validator?: (value: unknown) => T): T;
 
-export { type RunResult as $, type A2AToolRef as A, MantyxOAuthError as B, type CancelledEvent as C, DEFAULT_BASE_URL as D, type ErrorEvent as E, MantyxParseError as F, type MantyxPluginToolRef as G, MantyxRunError as H, type MantyxRunErrorInit as I, MantyxScopeError as J, MantyxToolError as K, type LocalA2ATool as L, MantyxClient as M, type MantyxToolRef as N, type McpToolRef as O, type ModelCatalog as P, type ModelInfo as Q, type ReasoningLevel as R, type OAuthToken as S, type ToolRef as T, type OutputSchema as U, type RefreshOptions as V, type RefreshTokenSourceOptions as W, type ResultEvent as X, type RevokeOptions as Y, type RunEvent as Z, type RunEventBase as _, AgentSession as a, type RunSpec as a0, type ServerToolResultEvent as a1, type SessionInfo as a2, type SessionSpec as a3, type ThinkingDeltaEvent as a4, type TokenRequestReason as a5, type TokenSource as a6, type ToolBudget as a7, type ToolBudgetExceededEvent as a8, type ToolBudgets as a9, type ZodLikeObject as aa, defineLocalA2A as ab, defineLocalMcp as ac, defineLocalTool as ad, isLocalA2ATool as ae, isLocalMcpServer as af, isLocalTool as ag, mantyxA2A as ah, mantyxMcp as ai, mantyxPluginTool as aj, mantyxTool as ak, parseRunOutput as al, type AgentSpecBase as b, type AssistantDeltaEvent as c, type AssistantMessageEvent as d, DEFAULT_OAUTH_BASE_URL as e, DEFAULT_REFRESH_SKEW_MS as f, type DefineLocalA2AOptions as g, type DefineLocalMcpOptions as h, type DefineLocalToolOptions as i, type LocalHandlers as j, type LocalMcpHttpTransport as k, type LocalMcpServer as l, type LocalMcpStdioTransport as m, type LocalTool as n, type LocalToolCallEvent as o, type LocalToolResultInEvent as p, type LoopDetectedEvent as q, type LoopDetection as r, type MantyxA2AOptions as s, MantyxAuthError as t, type MantyxClientOptions as u, MantyxError as v, type MantyxMcpOptions as w, MantyxNetworkError as x, MantyxOAuthClient as y, type MantyxOAuthClientOptions as z };
+export { type RunEvent as $, type A2AToolRef as A, MantyxOAuthError as B, type CancelledEvent as C, DEFAULT_BASE_URL as D, type ErrorEvent as E, MantyxParseError as F, type MantyxPluginToolRef as G, MantyxRunError as H, type MantyxRunErrorInit as I, type MantyxRunErrorModel as J, type MantyxRunErrorTokens as K, type LocalA2ATool as L, MantyxClient as M, MantyxScopeError as N, MantyxToolError as O, type MantyxToolRef as P, type McpToolRef as Q, type ReasoningLevel as R, type ModelCatalog as S, type ToolRef as T, type ModelInfo as U, type OAuthToken as V, type OutputSchema as W, type RefreshOptions as X, type RefreshTokenSourceOptions as Y, type ResultEvent as Z, type RevokeOptions as _, AgentSession as a, type RunEventBase as a0, type RunModelInfo as a1, type RunResult as a2, type RunSpec as a3, type RunTokenUsage as a4, type ServerToolResultEvent as a5, type SessionInfo as a6, type SessionSpec as a7, type ThinkingDeltaEvent as a8, type TokenRequestReason as a9, type TokenSource as aa, type ToolBudget as ab, type ToolBudgetExceededEvent as ac, type ToolBudgets as ad, type ZodLikeObject as ae, defineLocalA2A as af, defineLocalMcp as ag, defineLocalTool as ah, isLocalA2ATool as ai, isLocalMcpServer as aj, isLocalTool as ak, mantyxA2A as al, mantyxMcp as am, mantyxPluginTool as an, mantyxTool as ao, parseRunOutput as ap, type AgentSpecBase as b, type AssistantDeltaEvent as c, type AssistantMessageEvent as d, DEFAULT_OAUTH_BASE_URL as e, DEFAULT_REFRESH_SKEW_MS as f, type DefineLocalA2AOptions as g, type DefineLocalMcpOptions as h, type DefineLocalToolOptions as i, type LocalHandlers as j, type LocalMcpHttpTransport as k, type LocalMcpServer as l, type LocalMcpStdioTransport as m, type LocalTool as n, type LocalToolCallEvent as o, type LocalToolResultInEvent as p, type LoopDetectedEvent as q, type LoopDetection as r, type MantyxA2AOptions as s, MantyxAuthError as t, type MantyxClientOptions as u, MantyxError as v, type MantyxMcpOptions as w, MantyxNetworkError as x, MantyxOAuthClient as y, type MantyxOAuthClientOptions as z };

package/dist/{client-CZUVldDx.d.ts → client-Byb0Zdo7.d.ts}

@@ -47,6 +47,30 @@ declare class MantyxToolError extends MantyxError {
     readonly toolName: string;
     constructor(toolName: string, message: string);
 }
+/**
+ * Per-run token totals attached to terminal `result` / `error`
+ * events. See `docs/agent-runs-protocol.md` §7.1 for the per-provider
+ * mapping and the relationship between buckets. Re-exported from
+ * `client.ts` so error consumers can pattern-match the triple without
+ * a second import.
+ */
+interface MantyxRunErrorTokens {
+    inputTokens: number;
+    cachedTokens: number;
+    reasoningTokens: number;
+    outputTokens: number;
+}
+/**
+ * Resolved model that executed the run. Surfaced on terminal events
+ * by MANTYX ≥ 2026-09. See `docs/agent-runs-protocol.md` §7.1. The
+ * `provider` empty / undefined is the "no usage data" sentinel.
+ */
+interface MantyxRunErrorModel {
+    id: string;
+    provider: string;
+    vendorModelId: string;
+    reasoningEffort?: string;
+}
 /**
  * Optional triage attributes the runner attaches to terminal `error`
  * events. Mirrors the wire fields described in
@@ -83,6 +107,17 @@ interface MantyxRunErrorInit {
      * Informational; the SDK still owns the actual retry decision.
      */
     retryable?: boolean;
+    /**
+     * Per-run token totals from the terminal event. Present against
+     * MANTYX ≥ 2026-09 — see {@link MantyxRunErrorTokens} and
+     * `docs/agent-runs-protocol.md` §7.1. Includes the failing model
+     * call's usage when the run errored mid-loop.
+     */
+    tokens?: MantyxRunErrorTokens;
+    /** Total model invocations for the run, including the failing call. */
+    turns?: number;
+    /** Resolved model that executed the run. See {@link MantyxRunErrorModel}. */
+    model?: MantyxRunErrorModel;
 }
 declare class MantyxRunError extends MantyxError {
     readonly runId: string;
@@ -95,6 +130,12 @@ declare class MantyxRunError extends MantyxError {
     readonly partialText: string | undefined;
     /** See {@link MantyxRunErrorInit.retryable}. */
     readonly retryable: boolean | undefined;
+    /** See {@link MantyxRunErrorInit.tokens}. */
+    readonly tokens: MantyxRunErrorTokens | undefined;
+    /** See {@link MantyxRunErrorInit.turns}. */
+    readonly turns: number | undefined;
+    /** See {@link MantyxRunErrorInit.model}. */
+    readonly model: MantyxRunErrorModel | undefined;
     constructor(runId: string, subtype: string, message: string, init?: MantyxRunErrorInit);
 }
 /**
@@ -884,10 +925,102 @@ interface ToolBudget {
  * entirely to keep the defaults.
  */
 type ToolBudgets = Record<string, ToolBudget>;
+/**
+ * Per-run token totals attached to terminal `result` / `error` events
+ * (and to the `GET /agent-runs/:runId` snapshot) by MANTYX ≥ 2026-09.
+ *
+ * Aggregated across every model invocation for the run. See
+ * `docs/agent-runs-protocol.md` §7.1 for the per-provider mapping and
+ * the relationship between buckets (`inputTokens` / `outputTokens` are
+ * the billable totals; `cachedTokens` and `reasoningTokens` are
+ * diagnostic breakdowns _inside_ those two totals, not separate
+ * additive buckets).
+ *
+ * Older servers omit the cost-attribution triple entirely; SDK callers
+ * detect "no usage data" by checking `result.model?.provider` is empty
+ * / undefined.
+ */
+interface RunTokenUsage {
+    /**
+     * Total billable input tokens — fresh prompt tokens plus the
+     * cached-read slice the provider still bills (at a discount) plus
+     * any cache-creation tokens plus tool-prompt tokens. Equal to the
+     * sum of every provider-reported input bucket for the run.
+     */
+    inputTokens: number;
+    /**
+     * The discounted slice of `inputTokens` that came from a prompt
+     * cache hit (Anthropic prompt caching, OpenAI cached prompt, Gemini
+     * implicit cache). `0` when the provider doesn't report cache reads
+     * or the run didn't hit cache.
+     */
+    cachedTokens: number;
+    /**
+     * Non-visible thinking tokens. **Already counted inside
+     * `outputTokens`** — surfaced separately so dashboards can break out
+     * "thinking cost" vs visible output. `0` when the model didn't
+     * reason or didn't report it.
+     */
+    reasoningTokens: number;
+    /**
+     * All tokens the model emitted for this run, visible + reasoning.
+     * Matches the provider's "completion tokens" / "output tokens"
+     * billing line.
+     */
+    outputTokens: number;
+}
+/**
+ * The resolved model the platform stamped onto the run, surfaced on
+ * terminal `result` / `error` events (and `GET /agent-runs/:runId`)
+ * by MANTYX ≥ 2026-09. See `docs/agent-runs-protocol.md` §7.1.
+ */
+interface RunModelInfo {
+    /**
+     * Catalog id — the same string a caller would pass back as
+     * `modelId` to re-select this exact entry (e.g. `"platform:demo"`,
+     * `"provider:cmf…"`). Empty string against legacy fallbacks that
+     * didn't synthesise a catalog id.
+     */
+    id: string;
+    /**
+     * Lowercase provider id: `"openai"`, `"anthropic"`, `"google"`,
+     * `"azure-openai"`. Empty string against legacy runners that don't
+     * report usage data — SDK callers use that as the "no usage data"
+     * signal.
+     */
+    provider: string;
+    /**
+     * The model id the platform actually sent to the provider (e.g.
+     * `"gpt-5.4-mini"`, `"claude-opus-4-7"`, `"gemini-2.5-pro"`).
+     */
+    vendorModelId: string;
+    /**
+     * `"off" | "low" | "medium" | "high"`. Omitted when the provider
+     * doesn't expose a reasoning-level knob or the run didn't request
+     * one.
+     */
+    reasoningEffort?: string;
+}
 interface RunResult {
     runId: string;
     text: string;
     events: RunEvent[];
+    /**
+     * Per-run token totals from the terminal event. Undefined against
+     * MANTYX servers older than 2026-09 (the "no usage data" signal is
+     * `result.model?.provider` being empty / undefined). See
+     * {@link RunTokenUsage} and `docs/agent-runs-protocol.md` §7.1.
+     */
+    tokens?: RunTokenUsage;
+    /**
+     * Total `engine.completeTurn(...)` invocations for the run,
+     * including the failing call when a run errored mid-loop. A
+     * single-shot run reports `1`; a tool loop is `>= 2`. Undefined
+     * against legacy MANTYX servers.
+     */
+    turns?: number;
+    /** Resolved model that executed the run. See {@link RunModelInfo}. */
+    model?: RunModelInfo;
 }
 interface RunEventBase {
     seq: number;
@@ -1036,6 +1169,15 @@ interface ResultEvent extends RunEventBase {
     subtype: string;
     text?: string;
     error?: string;
+    /**
+     * Per-run token totals. Present against MANTYX ≥ 2026-09 — see
+     * {@link RunTokenUsage} and `docs/agent-runs-protocol.md` §7.1.
+     */
+    tokens?: RunTokenUsage;
+    /** Total model invocations for the run. See {@link RunResult.turns}. */
+    turns?: number;
+    /** Resolved model that executed the run. See {@link RunModelInfo}. */
+    model?: RunModelInfo;
 }
 interface ErrorEvent extends RunEventBase {
     type: "error";
@@ -1074,6 +1216,18 @@ interface ErrorEvent extends RunEventBase {
      * Informational; the SDK still owns the actual retry decision.
      */
     retryable?: boolean;
+    /**
+     * Per-run token totals. Present against MANTYX ≥ 2026-09 — see
+     * {@link RunTokenUsage} and `docs/agent-runs-protocol.md` §7.1.
+     * The pipeline counts the failing model call too, so a run that
+     * threw on the first turn reports `turns: 1` with that call's
+     * tokens already aggregated.
+     */
+    tokens?: RunTokenUsage;
+    /** Total model invocations for the run, including the failing call. */
+    turns?: number;
+    /** Resolved model that executed the run. See {@link RunModelInfo}. */
+    model?: RunModelInfo;
 }
 interface CancelledEvent extends RunEventBase {
     type: "cancelled";
@@ -1280,4 +1434,4 @@ interface LocalHandlers {
  */
 declare function parseRunOutput<T = unknown>(result: RunResult, validator?: (value: unknown) => T): T;
 
-export { type RunResult as $, type A2AToolRef as A, MantyxOAuthError as B, type CancelledEvent as C, DEFAULT_BASE_URL as D, type ErrorEvent as E, MantyxParseError as F, type MantyxPluginToolRef as G, MantyxRunError as H, type MantyxRunErrorInit as I, MantyxScopeError as J, MantyxToolError as K, type LocalA2ATool as L, MantyxClient as M, type MantyxToolRef as N, type McpToolRef as O, type ModelCatalog as P, type ModelInfo as Q, type ReasoningLevel as R, type OAuthToken as S, type ToolRef as T, type OutputSchema as U, type RefreshOptions as V, type RefreshTokenSourceOptions as W, type ResultEvent as X, type RevokeOptions as Y, type RunEvent as Z, type RunEventBase as _, AgentSession as a, type RunSpec as a0, type ServerToolResultEvent as a1, type SessionInfo as a2, type SessionSpec as a3, type ThinkingDeltaEvent as a4, type TokenRequestReason as a5, type TokenSource as a6, type ToolBudget as a7, type ToolBudgetExceededEvent as a8, type ToolBudgets as a9, type ZodLikeObject as aa, defineLocalA2A as ab, defineLocalMcp as ac, defineLocalTool as ad, isLocalA2ATool as ae, isLocalMcpServer as af, isLocalTool as ag, mantyxA2A as ah, mantyxMcp as ai, mantyxPluginTool as aj, mantyxTool as ak, parseRunOutput as al, type AgentSpecBase as b, type AssistantDeltaEvent as c, type AssistantMessageEvent as d, DEFAULT_OAUTH_BASE_URL as e, DEFAULT_REFRESH_SKEW_MS as f, type DefineLocalA2AOptions as g, type DefineLocalMcpOptions as h, type DefineLocalToolOptions as i, type LocalHandlers as j, type LocalMcpHttpTransport as k, type LocalMcpServer as l, type LocalMcpStdioTransport as m, type LocalTool as n, type LocalToolCallEvent as o, type LocalToolResultInEvent as p, type LoopDetectedEvent as q, type LoopDetection as r, type MantyxA2AOptions as s, MantyxAuthError as t, type MantyxClientOptions as u, MantyxError as v, type MantyxMcpOptions as w, MantyxNetworkError as x, MantyxOAuthClient as y, type MantyxOAuthClientOptions as z };
+export { type RunEvent as $, type A2AToolRef as A, MantyxOAuthError as B, type CancelledEvent as C, DEFAULT_BASE_URL as D, type ErrorEvent as E, MantyxParseError as F, type MantyxPluginToolRef as G, MantyxRunError as H, type MantyxRunErrorInit as I, type MantyxRunErrorModel as J, type MantyxRunErrorTokens as K, type LocalA2ATool as L, MantyxClient as M, MantyxScopeError as N, MantyxToolError as O, type MantyxToolRef as P, type McpToolRef as Q, type ReasoningLevel as R, type ModelCatalog as S, type ToolRef as T, type ModelInfo as U, type OAuthToken as V, type OutputSchema as W, type RefreshOptions as X, type RefreshTokenSourceOptions as Y, type ResultEvent as Z, type RevokeOptions as _, AgentSession as a, type RunEventBase as a0, type RunModelInfo as a1, type RunResult as a2, type RunSpec as a3, type RunTokenUsage as a4, type ServerToolResultEvent as a5, type SessionInfo as a6, type SessionSpec as a7, type ThinkingDeltaEvent as a8, type TokenRequestReason as a9, type TokenSource as aa, type ToolBudget as ab, type ToolBudgetExceededEvent as ac, type ToolBudgets as ad, type ZodLikeObject as ae, defineLocalA2A as af, defineLocalMcp as ag, defineLocalTool as ah, isLocalA2ATool as ai, isLocalMcpServer as aj, isLocalTool as ak, mantyxA2A as al, mantyxMcp as am, mantyxPluginTool as an, mantyxTool as ao, parseRunOutput as ap, type AgentSpecBase as b, type AssistantDeltaEvent as c, type AssistantMessageEvent as d, DEFAULT_OAUTH_BASE_URL as e, DEFAULT_REFRESH_SKEW_MS as f, type DefineLocalA2AOptions as g, type DefineLocalMcpOptions as h, type DefineLocalToolOptions as i, type LocalHandlers as j, type LocalMcpHttpTransport as k, type LocalMcpServer as l, type LocalMcpStdioTransport as m, type LocalTool as n, type LocalToolCallEvent as o, type LocalToolResultInEvent as p, type LoopDetectedEvent as q, type LoopDetection as r, type MantyxA2AOptions as s, MantyxAuthError as t, type MantyxClientOptions as u, MantyxError as v, type MantyxMcpOptions as w, MantyxNetworkError as x, MantyxOAuthClient as y, type MantyxOAuthClientOptions as z };

package/dist/index.cjs

@@ -123,6 +123,12 @@ var MantyxRunError = class extends MantyxError {
   partialText;
   /** See {@link MantyxRunErrorInit.retryable}. */
   retryable;
+  /** See {@link MantyxRunErrorInit.tokens}. */
+  tokens;
+  /** See {@link MantyxRunErrorInit.turns}. */
+  turns;
+  /** See {@link MantyxRunErrorInit.model}. */
+  model;
   constructor(runId, subtype, message, init = {}) {
     super(message, { code: subtype });
     this.name = "MantyxRunError";
@@ -132,6 +138,9 @@ var MantyxRunError = class extends MantyxError {
     this.finishReason = init.finishReason;
     this.partialText = init.partialText;
     this.retryable = init.retryable;
+    this.tokens = init.tokens;
+    this.turns = init.turns;
+    this.model = init.model;
   }
 };
 var MantyxParseError = class extends MantyxError {
@@ -771,6 +780,9 @@ var MantyxClient = class {
   async driveRun(runId, handlers, opts = {}) {
     const collected = [];
     let finalText = "";
+    let tokens;
+    let turns;
+    let modelInfo;
     for await (const ev of this.streamRunEvents(runId, handlers, opts.signal)) {
       collected.push(ev);
       if (opts.onEvent) opts.onEvent(ev);
@@ -779,25 +791,42 @@ var MantyxClient = class {
       }
       if (ev.type === "result") {
         const r = ev;
+        tokens = parseRunTokens(r.tokens) ?? tokens;
+        turns = parseRunTurns(r.turns) ?? turns;
+        modelInfo = parseRunModel(r.model) ?? modelInfo;
         if (r.subtype === "success") {
           finalText = typeof r.text === "string" ? r.text : "";
         } else {
-          throw new MantyxRunError(runId, r.subtype, r.error ?? r.subtype);
+          const errInit = {};
+          if (tokens !== void 0) errInit.tokens = tokens;
+          if (turns !== void 0) errInit.turns = turns;
+          if (modelInfo !== void 0) errInit.model = modelInfo;
+          throw new MantyxRunError(runId, r.subtype, r.error ?? r.subtype, errInit);
         }
       } else if (ev.type === "error") {
         const e = ev;
         const subtype = e.errorClass ?? e.code ?? "error";
-        throw new MantyxRunError(runId, subtype, e.error, {
-          ...e.errorClass !== void 0 ? { errorClass: e.errorClass } : {},
-          ...e.finishReason !== void 0 ? { finishReason: e.finishReason } : {},
-          ...typeof e.partialText === "string" ? { partialText: e.partialText } : {},
-          ...typeof e.retryable === "boolean" ? { retryable: e.retryable } : {}
-        });
+        const errInit = {};
+        if (e.errorClass !== void 0) errInit.errorClass = e.errorClass;
+        if (e.finishReason !== void 0) errInit.finishReason = e.finishReason;
+        if (typeof e.partialText === "string") errInit.partialText = e.partialText;
+        if (typeof e.retryable === "boolean") errInit.retryable = e.retryable;
+        const errTokens = parseRunTokens(e.tokens);
+        if (errTokens !== void 0) errInit.tokens = errTokens;
+        const errTurns = parseRunTurns(e.turns);
+        if (errTurns !== void 0) errInit.turns = errTurns;
+        const errModel = parseRunModel(e.model);
+        if (errModel !== void 0) errInit.model = errModel;
+        throw new MantyxRunError(runId, subtype, e.error, errInit);
       } else if (ev.type === "cancelled") {
         throw new MantyxRunError(runId, "cancelled", "Run was cancelled");
       }
     }
-    return { runId, text: finalText, events: collected };
+    const result = { runId, text: finalText, events: collected };
+    if (tokens !== void 0) result.tokens = tokens;
+    if (turns !== void 0) result.turns = turns;
+    if (modelInfo !== void 0) result.model = modelInfo;
+    return result;
   }
   async *streamRunEvents(runId, handlers, signal) {
     const url = this.absoluteUrl(`/agent-runs/${encodeURIComponent(runId)}/stream`);
@@ -1384,6 +1413,37 @@ function parseRunOutput(result, validator) {
 function sleep(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }
+function parseRunTokens(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const v = value;
+  return {
+    inputTokens: toNonNegativeInt(v.inputTokens),
+    cachedTokens: toNonNegativeInt(v.cachedTokens),
+    reasoningTokens: toNonNegativeInt(v.reasoningTokens),
+    outputTokens: toNonNegativeInt(v.outputTokens)
+  };
+}
+function parseRunTurns(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return void 0;
+  return Math.max(0, Math.trunc(value));
+}
+function parseRunModel(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const v = value;
+  const out = {
+    id: typeof v.id === "string" ? v.id : "",
+    provider: typeof v.provider === "string" ? v.provider : "",
+    vendorModelId: typeof v.vendorModelId === "string" ? v.vendorModelId : ""
+  };
+  if (typeof v.reasoningEffort === "string" && v.reasoningEffort.length > 0) {
+    out.reasoningEffort = v.reasoningEffort;
+  }
+  return out;
+}
+function toNonNegativeInt(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return 0;
+  return Math.max(0, Math.trunc(value));
+}
 function resolveCredential(opts) {
   const apiKey = typeof opts.apiKey === "string" ? opts.apiKey : "";
   const accessToken = typeof opts.accessToken === "string" ? opts.accessToken : "";
@@ -1640,7 +1700,7 @@ function normalizeScope(scope) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.10.1";
+var SDK_VERSION = "0.11.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AgentSession,