Constructor Detail

Method Detail

• visitUserMessage

   abstract T visitUserMessage(BetaManagedAgentsUserMessageEvent userMessage)

  A user message event in the session conversation.

• visitUserInterrupt

   abstract T visitUserInterrupt(BetaManagedAgentsUserInterruptEvent userInterrupt)

  An interrupt event that pauses agent execution and returns control to the user.

• visitUserToolConfirmation

   abstract T visitUserToolConfirmation(BetaManagedAgentsUserToolConfirmationEvent userToolConfirmation)

  A tool confirmation event that approves or denies a pending tool execution.

• visitUserCustomToolResult

   abstract T visitUserCustomToolResult(BetaManagedAgentsUserCustomToolResultEvent userCustomToolResult)

  Event sent by the client providing the result of a custom tool execution.

• visitAgentCustomToolUse

   abstract T visitAgentCustomToolUse(BetaManagedAgentsAgentCustomToolUseEvent agentCustomToolUse)

  Event emitted when the agent calls a custom tool. The session goes idle until the client sends a user.custom_tool_result event with the result.

• visitAgentMessage

   abstract T visitAgentMessage(BetaManagedAgentsAgentMessageEvent agentMessage)

  An agent response event in the session conversation.

• visitAgentThinking

   abstract T visitAgentThinking(BetaManagedAgentsAgentThinkingEvent agentThinking)

  Indicates the agent is making forward progress via extended thinking. A progress signal, not a content carrier.

• visitAgentMcpToolUse

   abstract T visitAgentMcpToolUse(BetaManagedAgentsAgentMcpToolUseEvent agentMcpToolUse)

  Event emitted when the agent invokes a tool provided by an MCP server.

• visitAgentMcpToolResult

   abstract T visitAgentMcpToolResult(BetaManagedAgentsAgentMcpToolResultEvent agentMcpToolResult)

  Event representing the result of an MCP tool execution.

• visitAgentToolUse

   abstract T visitAgentToolUse(BetaManagedAgentsAgentToolUseEvent agentToolUse)

  Event emitted when the agent invokes a built-in agent tool.

• visitAgentToolResult

   abstract T visitAgentToolResult(BetaManagedAgentsAgentToolResultEvent agentToolResult)

  Event representing the result of an agent tool execution.

• visitAgentThreadMessageReceived

   abstract T visitAgentThreadMessageReceived(BetaManagedAgentsAgentThreadMessageReceivedEvent agentThreadMessageReceived)

  Delivery event written to the target thread's input stream when an agent-to-agent message arrives.

• visitAgentThreadMessageSent

   abstract T visitAgentThreadMessageSent(BetaManagedAgentsAgentThreadMessageSentEvent agentThreadMessageSent)

  Observability event emitted to the sender's output stream when an agent-to-agent message is sent.

• visitAgentThreadContextCompacted

   abstract T visitAgentThreadContextCompacted(BetaManagedAgentsAgentThreadContextCompactedEvent agentThreadContextCompacted)

  Indicates that context compaction (summarization) occurred during the session.

• visitSessionError

   abstract T visitSessionError(BetaManagedAgentsSessionErrorEvent sessionError)

  An error event indicating a problem occurred during session execution.

• visitSessionStatusRescheduled

   abstract T visitSessionStatusRescheduled(BetaManagedAgentsSessionStatusRescheduledEvent sessionStatusRescheduled)

  Indicates the session is recovering from an error state and is rescheduled for execution.

• visitSessionStatusRunning

   abstract T visitSessionStatusRunning(BetaManagedAgentsSessionStatusRunningEvent sessionStatusRunning)

  Indicates the session is actively running and the agent is working.

• visitSessionStatusIdle

   abstract T visitSessionStatusIdle(BetaManagedAgentsSessionStatusIdleEvent sessionStatusIdle)

  Indicates the agent has paused and is awaiting user input.

• visitSessionStatusTerminated

   abstract T visitSessionStatusTerminated(BetaManagedAgentsSessionStatusTerminatedEvent sessionStatusTerminated)

  Indicates the session has terminated, either due to an error or completion.

• visitSessionThreadCreated

   abstract T visitSessionThreadCreated(BetaManagedAgentsSessionThreadCreatedEvent sessionThreadCreated)

  Emitted when a subagent is spawned as a new thread. Written to the parent thread's output stream so clients observing the session see child creation.

• visitSpanOutcomeEvaluationStart

   abstract T visitSpanOutcomeEvaluationStart(BetaManagedAgentsSpanOutcomeEvaluationStartEvent spanOutcomeEvaluationStart)

  Emitted when an outcome evaluation cycle begins.

• visitSpanOutcomeEvaluationEnd

   abstract T visitSpanOutcomeEvaluationEnd(BetaManagedAgentsSpanOutcomeEvaluationEndEvent spanOutcomeEvaluationEnd)

  Emitted when an outcome evaluation cycle completes. Carries the verdict and aggregate token usage. A verdict of needs_revision means another evaluation cycle follows; satisfied, max_iterations_reached, failed, or interrupted are terminal — no further evaluation cycles follow.

• visitSpanModelRequestStart

   abstract T visitSpanModelRequestStart(BetaManagedAgentsSpanModelRequestStartEvent spanModelRequestStart)

  Emitted when a model request is initiated by the agent.

• visitSpanModelRequestEnd

   abstract T visitSpanModelRequestEnd(BetaManagedAgentsSpanModelRequestEndEvent spanModelRequestEnd)

  Emitted when a model request completes.

• visitSpanOutcomeEvaluationOngoing

   abstract T visitSpanOutcomeEvaluationOngoing(BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent spanOutcomeEvaluationOngoing)

  Periodic heartbeat emitted while an outcome evaluation cycle is in progress. Distinguishes 'evaluation is actively running' from 'evaluation is stuck' between the corresponding span.outcome_evaluation_start and span.outcome_evaluation_end events.

• visitUserDefineOutcome

   abstract T visitUserDefineOutcome(BetaManagedAgentsUserDefineOutcomeEvent userDefineOutcome)

  Echo of a user.define_outcome input event. Carries the server-generated outcome_id that subsequent span.outcome_evaluation_* events reference.

• visitSessionDeleted

   abstract T visitSessionDeleted(BetaManagedAgentsSessionDeletedEvent sessionDeleted)

  Emitted when a session has been deleted. Terminates any active event stream — no further events will be emitted for this session.

• visitSessionThreadStatusRunning

   abstract T visitSessionThreadStatusRunning(BetaManagedAgentsSessionThreadStatusRunningEvent sessionThreadStatusRunning)

  A session thread has begun executing. Emitted on the thread's own stream and cross-posted to the primary stream for child threads.

• visitSessionThreadStatusIdle

   abstract T visitSessionThreadStatusIdle(BetaManagedAgentsSessionThreadStatusIdleEvent sessionThreadStatusIdle)

  A session thread has yielded and is awaiting input. Emitted on the thread's own stream and cross-posted to the primary stream for child threads.

• visitSessionThreadStatusTerminated

   abstract T visitSessionThreadStatusTerminated(BetaManagedAgentsSessionThreadStatusTerminatedEvent sessionThreadStatusTerminated)

  A session thread has terminated and will accept no further input. Emitted on the thread's own stream and cross-posted to the primary stream for child threads.

• visitUserToolResult

   abstract T visitUserToolResult(BetaManagedAgentsUserToolResultEvent userToolResult)

  Event sent by the client providing the result of an agent-toolset tool execution. Only valid on self_hosted environments, where sandbox-routed tools are executed by the client rather than the server.

• visitSessionThreadStatusRescheduled

   abstract T visitSessionThreadStatusRescheduled(BetaManagedAgentsSessionThreadStatusRescheduledEvent sessionThreadStatusRescheduled)

  A session thread hit a transient error and is retrying automatically. Emitted on the thread's own stream and cross-posted to the primary stream for child threads.

• visitSessionUpdated

   abstract T visitSessionUpdated(BetaManagedAgentsSessionUpdatedEvent sessionUpdated)

  Emitted when an UpdateSession request changed at least one field. Carries only the fields that changed; absent fields were not part of the update. The new configuration applies from the next turn.

• visitSystemMessage

   abstract T visitSystemMessage(BetaManagedAgentsSystemMessageEvent systemMessage)

  A mid-conversation system message event. Carries system-role content that is appended to the session as a role: "system" turn.

• unknown

   T unknown(JsonValue json)

  Maps an unknown variant of BetaManagedAgentsSessionEvent to a value of type T.

  An instance of BetaManagedAgentsSessionEvent can contain an unknown variant if it was deserialized from data that doesn't match any known variant. For example, if the SDK is on an older version than the API, then the API may respond with new variants that the SDK is unaware of.