Unary · Agents
Sends user input to an active agent run.
This method is used to provide interactive or conversation-based input
to an agent. The agent can respond with output blocks containing
text, file changes, or tool usage requests.
Examples
-
Send a text message to an agent:
Endpoint
https://app.ona.com with that domain.
Request example
Request
gitpod.v1.SendToAgentExecutionRequest
Response
gitpod.v1.SendToAgentExecutionResponse
This message has no fields.
Related types
AgentControlInput
AgentControlInput
gitpod.v1.AgentControlInputCompact
Compact
gitpod.v1.AgentControlInput.CompactThis message has no fields.DeleteQueuedMessage
DeleteQueuedMessage
gitpod.v1.AgentControlInput.DeleteQueuedMessageGoal
Goal
gitpod.v1.AgentControlInput.GoalMoveQueuedMessage
MoveQueuedMessage
gitpod.v1.AgentControlInput.MoveQueuedMessageSteerQueuedMessage
SteerQueuedMessage
gitpod.v1.AgentControlInput.SteerQueuedMessageAgentMessage
AgentMessage
AgentMessage is a message sent between agents (e.g. from a parent agent to a
child agent execution, or vice versa).
gitpod.v1.AgentMessageCodexSettings
CodexSettings
CodexSettings contains settings consumed only by the Codex app agent.
gitpod.v1.CodexSettingsTurnOptions
TurnOptions
gitpod.v1.TurnOptionsUserInputBlock
UserInputBlock
gitpod.v1.UserInputBlockImageInput
ImageInput
ImageInput allows sending images to the agent.
Client must provide the MIME type; backend validates against magic bytes.
gitpod.v1.UserInputBlock.ImageInputInput
Input
gitpod.v1.UserInputBlock.InputTextInput
TextInput
gitpod.v1.UserInputBlock.TextInputUserInputMetadata
UserInputMetadata
UserInputMetadata carries integration-specific context for a user input.
Internal only - not exposed in public SDKs. External API consumers should
not set these fields; they are populated by integration handlers.
gitpod.v1.UserInputMetadataWakeEvent
WakeEvent
WakeEvent is sent by the backend to wake an agent when a registered interest fires.
Delivered via SendToAgentExecution as a new oneof variant.
gitpod.v1.WakeEventDevcontainerPhaseReached
DevcontainerPhaseReached
gitpod.v1.WakeEvent.DevcontainerPhaseReachedEnvironmentPhaseReached
EnvironmentPhaseReached
gitpod.v1.WakeEvent.EnvironmentPhaseReachedLoopRetrigger
LoopRetrigger
gitpod.v1.WakeEvent.LoopRetriggerTimerFired
TimerFired
gitpod.v1.WakeEvent.TimerFiredRole
Role
Role identifies the sender’s relationship in the parent/child hierarchy.
Type
Type
AgentMode
AgentMode
AgentMode defines the operational mode of an agent
CodexOpenAIModel
CodexOpenAIModel
CodexOpenAIModel is the static allowlist of concrete OpenAI models that the
Codex app runtime can select through Ona’s Codex picker.
CodexReasoningEffort
CodexReasoningEffort
CodexReasoningEffort is the static allowlist of reasoning efforts supported
by the Codex app runtime.
CodexServiceTier
CodexServiceTier
CodexServiceTier is the static allowlist of service tiers supported by the
Codex app runtime.