@anthropic-ai/sdk 0.115.0 → 0.116.0

package/src/resources/beta/sessions/events.ts

@@ -272,7 +272,7 @@ export interface BetaManagedAgentsAgentMessageEvent {
   /**
    * Array of text blocks comprising the agent response.
    */
-  content: Array<BetaManagedAgentsTextBlock>;
+  content: Array<BetaManagedAgentsTextBlock | BetaManagedAgentsRedactedBlock>;
 
   /**
    * A timestamp in RFC 3339 format
@@ -330,7 +330,12 @@ export interface BetaManagedAgentsAgentThreadMessageReceivedEvent {
   /**
    * Message content blocks.
    */
-  content: Array<BetaManagedAgentsTextBlock | BetaManagedAgentsImageBlock | BetaManagedAgentsDocumentBlock>;
+  content: Array<
+    | BetaManagedAgentsTextBlock
+    | BetaManagedAgentsImageBlock
+    | BetaManagedAgentsDocumentBlock
+    | BetaManagedAgentsRedactedBlock
+  >;
 
   /**
    * Public `sthr_` ID of the thread that sent the message.
@@ -364,7 +369,12 @@ export interface BetaManagedAgentsAgentThreadMessageSentEvent {
   /**
    * Message content blocks.
    */
-  content: Array<BetaManagedAgentsTextBlock | BetaManagedAgentsImageBlock | BetaManagedAgentsDocumentBlock>;
+  content: Array<
+    | BetaManagedAgentsTextBlock
+    | BetaManagedAgentsImageBlock
+    | BetaManagedAgentsDocumentBlock
+    | BetaManagedAgentsRedactedBlock
+  >;
 
   /**
    * A timestamp in RFC 3339 format
@@ -780,6 +790,13 @@ export interface BetaManagedAgentsPlainTextDocumentSource {
   type: 'text';
 }
 
+/**
+ * Placeholder for content withheld by Anthropic model policy.
+ */
+export interface BetaManagedAgentsRedactedBlock {
+  type: 'redacted';
+}
+
 /**
  * This turn is dead; queued inputs are flushed and the session returns to idle.
  * Client may send a new prompt.
@@ -872,6 +889,16 @@ export interface BetaManagedAgentsSendSessionEvents {
   >;
 }
 
+/**
+ * The agent stopped because the session's tracked list cost reached its budget, or
+ * because its usage includes a model with no list price (which the budget cannot
+ * measure). Raise the budget to continue — or, if raising is rejected because a
+ * model has no list price, remove the budget.
+ */
+export interface BetaManagedAgentsSessionBudgetReached {
+  type: 'budget_reached';
+}
+
 /**
  * Emitted when a session has been deleted. Terminates any active event stream — no
  * further events will be emitted for this session.
@@ -966,7 +993,8 @@ export type BetaManagedAgentsSessionEvent =
   | SessionsAPI.BetaManagedAgentsUserToolResultEvent
   | BetaManagedAgentsSessionThreadStatusRescheduledEvent
   | SessionsAPI.BetaManagedAgentsSessionUpdatedEvent
-  | SessionsAPI.BetaManagedAgentsSystemMessageEvent;
+  | SessionsAPI.BetaManagedAgentsSystemMessageEvent
+  | SessionsAPI.BetaManagedAgentsSessionUsageEvent;
 
 /**
  * The agent is idle waiting on one or more blocking user-input events (tool
@@ -1011,7 +1039,8 @@ export interface BetaManagedAgentsSessionStatusIdleEvent {
   stop_reason:
     | BetaManagedAgentsSessionEndTurn
     | BetaManagedAgentsSessionRequiresAction
-    | BetaManagedAgentsSessionRetriesExhausted;
+    | BetaManagedAgentsSessionRetriesExhausted
+    | BetaManagedAgentsSessionBudgetReached;
 
   type: 'session.status_idle';
 }
@@ -1127,7 +1156,8 @@ export interface BetaManagedAgentsSessionThreadStatusIdleEvent {
   stop_reason:
     | BetaManagedAgentsSessionEndTurn
     | BetaManagedAgentsSessionRequiresAction
-    | BetaManagedAgentsSessionRetriesExhausted;
+    | BetaManagedAgentsSessionRetriesExhausted
+    | BetaManagedAgentsSessionBudgetReached;
 
   type: 'session.thread_status_idle';
 }
@@ -1217,6 +1247,48 @@ export interface BetaManagedAgentsSessionThreadStatusTerminatedEvent {
   type: 'session.thread_status_terminated';
 }
 
+/**
+ * Point-in-time snapshot of a session's cumulative usage.
+ */
+export interface BetaManagedAgentsSessionUsageSnapshot {
+  /**
+   * Cumulative time in seconds during which the session had at least one thread in
+   * running status. Overlapping activity from concurrent threads is counted once.
+   * This is the duration the session's runtime cost is priced on.
+   */
+  active_seconds?: number;
+
+  /**
+   * Prompt-cache creation token usage broken down by cache lifetime.
+   */
+  cache_creation?: SessionsAPI.BetaManagedAgentsCacheCreationUsage;
+
+  /**
+   * Total tokens read from prompt cache.
+   */
+  cache_read_input_tokens?: number;
+
+  /**
+   * Total input tokens consumed across all turns.
+   */
+  input_tokens?: number;
+
+  /**
+   * A monetary amount in a specific currency.
+   */
+  list_cost?: BetaAPI.BetaMonetaryAmount;
+
+  /**
+   * Total output tokens generated across all turns.
+   */
+  output_tokens?: number;
+
+  /**
+   * Cumulative count of server-executed tool invocations, broken down by tool.
+   */
+  server_tool_use?: SessionsAPI.BetaManagedAgentsServerToolUsage;
+}
+
 /**
  * Emitted when a model request completes.
  */
@@ -1454,7 +1526,8 @@ export type BetaManagedAgentsStreamSessionEvents =
   | SessionsAPI.BetaManagedAgentsSessionUpdatedEvent
   | SessionsAPI.BetaManagedAgentsStartEvent
   | SessionsAPI.BetaManagedAgentsDeltaEvent
-  | SessionsAPI.BetaManagedAgentsSystemMessageEvent;
+  | SessionsAPI.BetaManagedAgentsSystemMessageEvent
+  | SessionsAPI.BetaManagedAgentsSessionUsageEvent;
 
 /**
  * Privileged context for the accompanying turn and all subsequent turns, appended
@@ -1744,7 +1817,12 @@ export interface BetaManagedAgentsUserMessageEvent {
   /**
    * Array of content blocks comprising the user message.
    */
-  content: Array<BetaManagedAgentsTextBlock | BetaManagedAgentsImageBlock | BetaManagedAgentsDocumentBlock>;
+  content: Array<
+    | BetaManagedAgentsTextBlock
+    | BetaManagedAgentsImageBlock
+    | BetaManagedAgentsDocumentBlock
+    | BetaManagedAgentsRedactedBlock
+  >;
 
   type: 'user.message';
 
@@ -1761,7 +1839,12 @@ export interface BetaManagedAgentsUserMessageEventParams {
   /**
    * Array of content blocks for the user message.
    */
-  content: Array<BetaManagedAgentsTextBlock | BetaManagedAgentsImageBlock | BetaManagedAgentsDocumentBlock>;
+  content: Array<
+    | BetaManagedAgentsTextBlock
+    | BetaManagedAgentsImageBlock
+    | BetaManagedAgentsDocumentBlock
+    | BetaManagedAgentsRedactedBlock
+  >;
 
   type: 'user.message';
 }
@@ -1979,6 +2062,7 @@ export declare namespace Events {
     type BetaManagedAgentsModelRateLimitedError as BetaManagedAgentsModelRateLimitedError,
     type BetaManagedAgentsModelRequestFailedError as BetaManagedAgentsModelRequestFailedError,
     type BetaManagedAgentsPlainTextDocumentSource as BetaManagedAgentsPlainTextDocumentSource,
+    type BetaManagedAgentsRedactedBlock as BetaManagedAgentsRedactedBlock,
     type BetaManagedAgentsRetryStatusExhausted as BetaManagedAgentsRetryStatusExhausted,
     type BetaManagedAgentsRetryStatusRetrying as BetaManagedAgentsRetryStatusRetrying,
     type BetaManagedAgentsRetryStatusTerminal as BetaManagedAgentsRetryStatusTerminal,
@@ -1986,6 +2070,7 @@ export declare namespace Events {
     type BetaManagedAgentsSearchResultCitations as BetaManagedAgentsSearchResultCitations,
     type BetaManagedAgentsSearchResultContent as BetaManagedAgentsSearchResultContent,
     type BetaManagedAgentsSendSessionEvents as BetaManagedAgentsSendSessionEvents,
+    type BetaManagedAgentsSessionBudgetReached as BetaManagedAgentsSessionBudgetReached,
     type BetaManagedAgentsSessionDeletedEvent as BetaManagedAgentsSessionDeletedEvent,
     type BetaManagedAgentsSessionEndTurn as BetaManagedAgentsSessionEndTurn,
     type BetaManagedAgentsSessionErrorEvent as BetaManagedAgentsSessionErrorEvent,
@@ -2001,6 +2086,7 @@ export declare namespace Events {
     type BetaManagedAgentsSessionThreadStatusRescheduledEvent as BetaManagedAgentsSessionThreadStatusRescheduledEvent,
     type BetaManagedAgentsSessionThreadStatusRunningEvent as BetaManagedAgentsSessionThreadStatusRunningEvent,
     type BetaManagedAgentsSessionThreadStatusTerminatedEvent as BetaManagedAgentsSessionThreadStatusTerminatedEvent,
+    type BetaManagedAgentsSessionUsageSnapshot as BetaManagedAgentsSessionUsageSnapshot,
     type BetaManagedAgentsSpanModelRequestEndEvent as BetaManagedAgentsSpanModelRequestEndEvent,
     type BetaManagedAgentsSpanModelRequestStartEvent as BetaManagedAgentsSpanModelRequestStartEvent,
     type BetaManagedAgentsSpanModelUsage as BetaManagedAgentsSpanModelUsage,

package/src/resources/beta/sessions/index.ts

@@ -29,6 +29,7 @@ export {
   type BetaManagedAgentsModelRateLimitedError,
   type BetaManagedAgentsModelRequestFailedError,
   type BetaManagedAgentsPlainTextDocumentSource,
+  type BetaManagedAgentsRedactedBlock,
   type BetaManagedAgentsRetryStatusExhausted,
   type BetaManagedAgentsRetryStatusRetrying,
   type BetaManagedAgentsRetryStatusTerminal,
@@ -36,6 +37,7 @@ export {
   type BetaManagedAgentsSearchResultCitations,
   type BetaManagedAgentsSearchResultContent,
   type BetaManagedAgentsSendSessionEvents,
+  type BetaManagedAgentsSessionBudgetReached,
   type BetaManagedAgentsSessionDeletedEvent,
   type BetaManagedAgentsSessionEndTurn,
   type BetaManagedAgentsSessionErrorEvent,
@@ -51,6 +53,7 @@ export {
   type BetaManagedAgentsSessionThreadStatusRescheduledEvent,
   type BetaManagedAgentsSessionThreadStatusRunningEvent,
   type BetaManagedAgentsSessionThreadStatusTerminatedEvent,
+  type BetaManagedAgentsSessionUsageSnapshot,
   type BetaManagedAgentsSpanModelRequestEndEvent,
   type BetaManagedAgentsSpanModelRequestStartEvent,
   type BetaManagedAgentsSpanModelUsage,
@@ -99,11 +102,13 @@ export {
 } from './resources';
 export {
   Sessions,
+  type BetaManagedAgentsAdvisorParams,
   type BetaManagedAgentsAgentMessagePreview,
   type BetaManagedAgentsAgentParams,
   type BetaManagedAgentsAgentThinkingPreview,
   type BetaManagedAgentsAgentWithOverridesParams,
   type BetaManagedAgentsBranchCheckout,
+  type BetaManagedAgentsBudgetLimit,
   type BetaManagedAgentsCacheCreationUsage,
   type BetaManagedAgentsCommitCheckout,
   type BetaManagedAgentsDeletedSession,
@@ -117,6 +122,7 @@ export {
   type BetaManagedAgentsMultiagentParams,
   type BetaManagedAgentsMultiagentRosterEntryParams,
   type BetaManagedAgentsOutcomeEvaluationResource,
+  type BetaManagedAgentsServerToolUsage,
   type BetaManagedAgentsSession,
   type BetaManagedAgentsSessionAgent,
   type BetaManagedAgentsSessionAgentUpdate,
@@ -124,6 +130,7 @@ export {
   type BetaManagedAgentsSessionStats,
   type BetaManagedAgentsSessionUpdatedEvent,
   type BetaManagedAgentsSessionUsage,
+  type BetaManagedAgentsSessionUsageEvent,
   type BetaManagedAgentsStartEvent,
   type BetaManagedAgentsStartEventPreview,
   type BetaManagedAgentsSystemContentBlock,

package/src/resources/beta/sessions/sessions.ts

@@ -32,6 +32,7 @@ import {
   BetaManagedAgentsModelRateLimitedError,
   BetaManagedAgentsModelRequestFailedError,
   BetaManagedAgentsPlainTextDocumentSource,
+  BetaManagedAgentsRedactedBlock,
   BetaManagedAgentsRetryStatusExhausted,
   BetaManagedAgentsRetryStatusRetrying,
   BetaManagedAgentsRetryStatusTerminal,
@@ -39,6 +40,7 @@ import {
   BetaManagedAgentsSearchResultCitations,
   BetaManagedAgentsSearchResultContent,
   BetaManagedAgentsSendSessionEvents,
+  BetaManagedAgentsSessionBudgetReached,
   BetaManagedAgentsSessionDeletedEvent,
   BetaManagedAgentsSessionEndTurn,
   BetaManagedAgentsSessionErrorEvent,
@@ -55,6 +57,7 @@ import {
   BetaManagedAgentsSessionThreadStatusRescheduledEvent,
   BetaManagedAgentsSessionThreadStatusRunningEvent,
   BetaManagedAgentsSessionThreadStatusTerminatedEvent,
+  BetaManagedAgentsSessionUsageSnapshot,
   BetaManagedAgentsSpanModelRequestEndEvent,
   BetaManagedAgentsSpanModelRequestStartEvent,
   BetaManagedAgentsSpanModelUsage,
@@ -293,6 +296,21 @@ export class Sessions extends APIResource {
 export type BetaManagedAgentsSessionsBidirectionalPageCursor =
   BidirectionalPageCursor<BetaManagedAgentsSession>;
 
+/**
+ * Platform advisor roster entry: a model the session's primary thread may consult
+ * mid-turn. At most one per roster; the entry occupies the roster name
+ * `anthropic.advisor`.
+ */
+export interface BetaManagedAgentsAdvisorParams {
+  /**
+   * A Claude model id. The model must be permitted as an advisor for this agent's
+   * model — see the sessions/threads/advisor spec.
+   */
+  model: string;
+
+  type: 'advisor';
+}
+
 export interface BetaManagedAgentsAgentMessagePreview {
   /**
    * The id the buffered agent.message will carry if it is emitted. Matches the
@@ -394,6 +412,19 @@ export interface BetaManagedAgentsBranchCheckout {
   type: 'branch';
 }
 
+/**
+ * A hard spend ceiling. The session stops issuing new model requests once the
+ * tracked list cost reaches `max_list_cost`.
+ */
+export interface BetaManagedAgentsBudgetLimit {
+  /**
+   * A monetary amount in a specific currency.
+   */
+  max_list_cost: BetaAPI.BetaMonetaryAmount;
+
+  type: 'limit';
+}
+
 /**
  * Prompt-cache creation token usage broken down by cache lifetime.
  */
@@ -549,7 +580,7 @@ export interface BetaManagedAgentsMultiagent {
    * Agents the coordinator may spawn as session threads, each resolved to a specific
    * version.
    */
-  agents: Array<AgentsAPI.BetaManagedAgentsAgentReference>;
+  agents: Array<AgentsAPI.BetaManagedAgentsAgentReference | AgentsAPI.BetaManagedAgentsAdvisor>;
 
   type: 'coordinator';
 }
@@ -579,7 +610,8 @@ export interface BetaManagedAgentsMultiagentParams {
 export type BetaManagedAgentsMultiagentRosterEntryParams =
   | string
   | BetaManagedAgentsAgentParams
-  | AgentsAPI.BetaManagedAgentsMultiagentSelfParams;
+  | AgentsAPI.BetaManagedAgentsMultiagentSelfParams
+  | BetaManagedAgentsAdvisorParams;
 
 /**
  * Evaluation state for a single outcome defined via a define_outcome event.
@@ -622,6 +654,21 @@ export interface BetaManagedAgentsOutcomeEvaluationResource {
   type: 'outcome_evaluation';
 }
 
+/**
+ * Cumulative count of server-executed tool invocations, broken down by tool.
+ */
+export interface BetaManagedAgentsServerToolUsage {
+  /**
+   * Number of server-executed web fetch requests.
+   */
+  web_fetch_requests?: number;
+
+  /**
+   * Number of server-executed web search requests.
+   */
+  web_search_requests?: number;
+}
+
 /**
  * A Managed Agents `session`.
  */
@@ -639,6 +686,12 @@ export interface BetaManagedAgentsSession {
    */
   archived_at: string | null;
 
+  /**
+   * A hard spend ceiling. The session stops issuing new model requests once the
+   * tracked list cost reaches `max_list_cost`.
+   */
+  budget: BetaManagedAgentsBudgetLimit | null;
+
   /**
    * A timestamp in RFC 3339 format
    */
@@ -763,7 +816,7 @@ export interface BetaManagedAgentsSessionMultiagentCoordinator {
   /**
    * Full `agent` definitions the coordinator may spawn as session threads.
    */
-  agents: Array<AgentsAPI.BetaManagedAgentsSessionThreadAgent>;
+  agents: Array<AgentsAPI.BetaManagedAgentsSessionThreadAgent | AgentsAPI.BetaManagedAgentsAdvisor>;
 
   type: 'coordinator';
 }
@@ -809,6 +862,12 @@ export interface BetaManagedAgentsSessionUpdatedEvent {
    */
   agent?: BetaManagedAgentsSessionAgent | null;
 
+  /**
+   * A hard spend ceiling. The session stops issuing new model requests once the
+   * tracked list cost reaches `max_list_cost`.
+   */
+  budget?: BetaManagedAgentsBudgetLimit | null;
+
   /**
    * The session's full metadata bag after the update. Present when the update set
    * non-empty metadata; absent when metadata was unchanged or cleared to empty.
@@ -825,6 +884,14 @@ export interface BetaManagedAgentsSessionUpdatedEvent {
  * Cumulative token usage for a session across all turns.
  */
 export interface BetaManagedAgentsSessionUsage {
+  /**
+   * Cumulative time in seconds during which the session had at least one thread in
+   * running status. Overlapping activity from concurrent threads is counted once,
+   * unlike `stats.active_seconds`, which sums each thread's own active time. This is
+   * the duration the session's runtime cost is priced on.
+   */
+  active_seconds?: number;
+
   /**
    * Prompt-cache creation token usage broken down by cache lifetime.
    */
@@ -840,10 +907,48 @@ export interface BetaManagedAgentsSessionUsage {
    */
   input_tokens?: number;
 
+  /**
+   * A monetary amount in a specific currency.
+   */
+  list_cost?: BetaAPI.BetaMonetaryAmount | null;
+
   /**
    * Total output tokens generated across all turns.
    */
   output_tokens?: number;
+
+  /**
+   * Cumulative count of server-executed tool invocations, broken down by tool.
+   */
+  server_tool_use?: BetaManagedAgentsServerToolUsage | null;
+}
+
+/**
+ * Periodic snapshot of the session's cumulative usage and tracked list cost.
+ */
+export interface BetaManagedAgentsSessionUsageEvent {
+  /**
+   * Unique identifier for this event.
+   */
+  id: string;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  processed_at: string;
+
+  type: 'session.usage';
+
+  /**
+   * Point-in-time snapshot of a session's cumulative usage.
+   */
+  usage: EventsAPI.BetaManagedAgentsSessionUsageSnapshot;
+
+  /**
+   * A hard spend ceiling. The session stops issuing new model requests once the
+   * tracked list cost reaches `max_list_cost`.
+   */
+  budget?: BetaManagedAgentsBudgetLimit | null;
 }
 
 /**
@@ -967,6 +1072,12 @@ export interface SessionCreateParams {
    */
   environment_id: string;
 
+  /**
+   * Body param: A hard spend ceiling. The session stops issuing new model requests
+   * once the tracked list cost reaches `max_list_cost`.
+   */
+  budget?: BetaManagedAgentsBudgetLimit;
+
   /**
    * Body param: Initial events to send to the `session` at creation, processed in
    * order. Supports `user.message` and `user.define_outcome` events. Maximum 50
@@ -1026,6 +1137,12 @@ export interface SessionUpdateParams {
    */
   agent?: BetaManagedAgentsSessionAgentUpdate;
 
+  /**
+   * Body param: A hard spend ceiling. The session stops issuing new model requests
+   * once the tracked list cost reaches `max_list_cost`.
+   */
+  budget?: BetaManagedAgentsBudgetLimit | null;
+
   /**
    * Body param: Metadata patch. Set a key to a string to upsert it, or to null to
    * delete it. Omit the field to preserve.
@@ -1135,11 +1252,13 @@ Sessions.Threads = Threads;
 
 export declare namespace Sessions {
   export {
+    type BetaManagedAgentsAdvisorParams as BetaManagedAgentsAdvisorParams,
     type BetaManagedAgentsAgentMessagePreview as BetaManagedAgentsAgentMessagePreview,
     type BetaManagedAgentsAgentParams as BetaManagedAgentsAgentParams,
     type BetaManagedAgentsAgentThinkingPreview as BetaManagedAgentsAgentThinkingPreview,
     type BetaManagedAgentsAgentWithOverridesParams as BetaManagedAgentsAgentWithOverridesParams,
     type BetaManagedAgentsBranchCheckout as BetaManagedAgentsBranchCheckout,
+    type BetaManagedAgentsBudgetLimit as BetaManagedAgentsBudgetLimit,
     type BetaManagedAgentsCacheCreationUsage as BetaManagedAgentsCacheCreationUsage,
     type BetaManagedAgentsCommitCheckout as BetaManagedAgentsCommitCheckout,
     type BetaManagedAgentsDeletedSession as BetaManagedAgentsDeletedSession,
@@ -1153,6 +1272,7 @@ export declare namespace Sessions {
     type BetaManagedAgentsMultiagentParams as BetaManagedAgentsMultiagentParams,
     type BetaManagedAgentsMultiagentRosterEntryParams as BetaManagedAgentsMultiagentRosterEntryParams,
     type BetaManagedAgentsOutcomeEvaluationResource as BetaManagedAgentsOutcomeEvaluationResource,
+    type BetaManagedAgentsServerToolUsage as BetaManagedAgentsServerToolUsage,
     type BetaManagedAgentsSession as BetaManagedAgentsSession,
     type BetaManagedAgentsSessionAgent as BetaManagedAgentsSessionAgent,
     type BetaManagedAgentsSessionAgentUpdate as BetaManagedAgentsSessionAgentUpdate,
@@ -1160,6 +1280,7 @@ export declare namespace Sessions {
     type BetaManagedAgentsSessionStats as BetaManagedAgentsSessionStats,
     type BetaManagedAgentsSessionUpdatedEvent as BetaManagedAgentsSessionUpdatedEvent,
     type BetaManagedAgentsSessionUsage as BetaManagedAgentsSessionUsage,
+    type BetaManagedAgentsSessionUsageEvent as BetaManagedAgentsSessionUsageEvent,
     type BetaManagedAgentsStartEvent as BetaManagedAgentsStartEvent,
     type BetaManagedAgentsStartEventPreview as BetaManagedAgentsStartEventPreview,
     type BetaManagedAgentsSystemContentBlock as BetaManagedAgentsSystemContentBlock,
@@ -1203,6 +1324,7 @@ export declare namespace Sessions {
     type BetaManagedAgentsModelRateLimitedError as BetaManagedAgentsModelRateLimitedError,
     type BetaManagedAgentsModelRequestFailedError as BetaManagedAgentsModelRequestFailedError,
     type BetaManagedAgentsPlainTextDocumentSource as BetaManagedAgentsPlainTextDocumentSource,
+    type BetaManagedAgentsRedactedBlock as BetaManagedAgentsRedactedBlock,
     type BetaManagedAgentsRetryStatusExhausted as BetaManagedAgentsRetryStatusExhausted,
     type BetaManagedAgentsRetryStatusRetrying as BetaManagedAgentsRetryStatusRetrying,
     type BetaManagedAgentsRetryStatusTerminal as BetaManagedAgentsRetryStatusTerminal,
@@ -1210,6 +1332,7 @@ export declare namespace Sessions {
     type BetaManagedAgentsSearchResultCitations as BetaManagedAgentsSearchResultCitations,
     type BetaManagedAgentsSearchResultContent as BetaManagedAgentsSearchResultContent,
     type BetaManagedAgentsSendSessionEvents as BetaManagedAgentsSendSessionEvents,
+    type BetaManagedAgentsSessionBudgetReached as BetaManagedAgentsSessionBudgetReached,
     type BetaManagedAgentsSessionDeletedEvent as BetaManagedAgentsSessionDeletedEvent,
     type BetaManagedAgentsSessionEndTurn as BetaManagedAgentsSessionEndTurn,
     type BetaManagedAgentsSessionErrorEvent as BetaManagedAgentsSessionErrorEvent,
@@ -1225,6 +1348,7 @@ export declare namespace Sessions {
     type BetaManagedAgentsSessionThreadStatusRescheduledEvent as BetaManagedAgentsSessionThreadStatusRescheduledEvent,
     type BetaManagedAgentsSessionThreadStatusRunningEvent as BetaManagedAgentsSessionThreadStatusRunningEvent,
     type BetaManagedAgentsSessionThreadStatusTerminatedEvent as BetaManagedAgentsSessionThreadStatusTerminatedEvent,
+    type BetaManagedAgentsSessionUsageSnapshot as BetaManagedAgentsSessionUsageSnapshot,
     type BetaManagedAgentsSpanModelRequestEndEvent as BetaManagedAgentsSpanModelRequestEndEvent,
     type BetaManagedAgentsSpanModelRequestStartEvent as BetaManagedAgentsSpanModelRequestStartEvent,
     type BetaManagedAgentsSpanModelUsage as BetaManagedAgentsSpanModelUsage,

package/src/resources/beta/sessions/threads/threads.ts

@@ -117,11 +117,9 @@ export interface BetaManagedAgentsSessionThread {
   id: string;
 
   /**
-   * Resolved `agent` definition for a single `session_thread`. Snapshot of the agent
-   * at thread creation time. The multiagent roster is not repeated here; read it
-   * from `Session.agent`.
+   * A session-resolved multiagent roster entry.
    */
-  agent: AgentsAPI.BetaManagedAgentsSessionThreadAgent;
+  agent: AgentsAPI.BetaManagedAgentsSessionThreadAgent | AgentsAPI.BetaManagedAgentsAdvisor;
 
   /**
    * A timestamp in RFC 3339 format
@@ -198,6 +196,13 @@ export type BetaManagedAgentsSessionThreadStatus = 'running' | 'idle' | 'resched
  * Cumulative token usage for a session thread across all turns.
  */
 export interface BetaManagedAgentsSessionThreadUsage {
+  /**
+   * Cumulative time in seconds this thread spent in running status. Equal to
+   * `stats.active_seconds`; surfaced here so a thread's usage carries every quantity
+   * its cost is priced on.
+   */
+  active_seconds?: number;
+
   /**
    * Prompt-cache creation token usage broken down by cache lifetime.
    */
@@ -213,10 +218,20 @@ export interface BetaManagedAgentsSessionThreadUsage {
    */
   input_tokens?: number;
 
+  /**
+   * A monetary amount in a specific currency.
+   */
+  list_cost?: BetaAPI.BetaMonetaryAmount | null;
+
   /**
    * Total output tokens generated across all turns.
    */
   output_tokens?: number;
+
+  /**
+   * Cumulative count of server-executed tool invocations, broken down by tool.
+   */
+  server_tool_use?: SessionsAPI.BetaManagedAgentsServerToolUsage | null;
 }
 
 /**
@@ -258,7 +273,8 @@ export type BetaManagedAgentsStreamSessionThreadEvents =
   | SessionsAPI.BetaManagedAgentsSessionUpdatedEvent
   | SessionsAPI.BetaManagedAgentsStartEvent
   | SessionsAPI.BetaManagedAgentsDeltaEvent
-  | SessionsAPI.BetaManagedAgentsSystemMessageEvent;
+  | SessionsAPI.BetaManagedAgentsSystemMessageEvent
+  | SessionsAPI.BetaManagedAgentsSessionUsageEvent;
 
 export interface ThreadRetrieveParams {
   /**

package/src/resources/beta/webhooks.ts

@@ -301,7 +301,8 @@ export type BetaWebhookEventData =
   | BetaWebhookEnvironmentDeletedEventData
   | BetaWebhookMemoryStoreCreatedEventData
   | BetaWebhookMemoryStoreArchivedEventData
-  | BetaWebhookMemoryStoreDeletedEventData;
+  | BetaWebhookMemoryStoreDeletedEventData
+  | BetaWebhookSessionBudgetReachedEventData;
 
 export interface BetaWebhookMemoryStoreArchivedEventData {
   /**
@@ -355,6 +356,19 @@ export interface BetaWebhookSessionArchivedEventData {
   workspace_id: string;
 }
 
+export interface BetaWebhookSessionBudgetReachedEventData {
+  /**
+   * ID of the session that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'session.budget_reached';
+
+  workspace_id: string;
+}
+
 export interface BetaWebhookSessionCreatedEventData {
   /**
    * ID of the session that triggered the event.
@@ -720,6 +734,7 @@ export declare namespace Webhooks {
     type BetaWebhookMemoryStoreCreatedEventData as BetaWebhookMemoryStoreCreatedEventData,
     type BetaWebhookMemoryStoreDeletedEventData as BetaWebhookMemoryStoreDeletedEventData,
     type BetaWebhookSessionArchivedEventData as BetaWebhookSessionArchivedEventData,
+    type BetaWebhookSessionBudgetReachedEventData as BetaWebhookSessionBudgetReachedEventData,
     type BetaWebhookSessionCreatedEventData as BetaWebhookSessionCreatedEventData,
     type BetaWebhookSessionDeletedEventData as BetaWebhookSessionDeletedEventData,
     type BetaWebhookSessionIdledEventData as BetaWebhookSessionIdledEventData,

package/src/resources/index.ts

@@ -7,10 +7,12 @@ export {
   type BetaAPIError,
   type BetaAuthenticationError,
   type BetaBillingError,
+  type BetaCurrency,
   type BetaError,
   type BetaErrorResponse,
   type BetaGatewayTimeoutError,
   type BetaInvalidRequestError,
+  type BetaMonetaryAmount,
   type BetaNotFoundError,
   type BetaOverloadedError,
   type BetaPermissionError,