Expand description
Data structures used by operation inputs/outputs.
Modules§
Structs§
- Agent
Space Represents a complete AgentSpace with all its properties, timestamps, encryption settings, and unique identifier.
- Approval
Action An approval decision supplied when resuming a paused agent execution. When an agent execution pauses to request approval for an elevated action, SendMessage streams an approval request carrying interrupt identifiers. This structure carries the decision back to the service — which paused tool invocation is being resumed, the opaque interrupt identifier that resumes it, the identifier of the approval request being resolved, optional display text of the control the user chose, and the action taken (APPROVED or REJECTED) — so the service can resume the paused execution. All members are optional on the wire; service-side validation is applied against the populated subset.
- Approval
Pattern Tool-invocation pattern primitive used to express both an agent-requested approval and a finalized approval. The primitive is uniform across AWS and third-party tools: a tool identifier plus a map of argument pins that narrow which invocations the pattern matches.
- Asset
Represents an asset in an agent space, including its identifier, type, metadata, version, and timestamps.
- Asset
File Represents a single file within an asset, including its path, content, version, and timestamps.
- Asset
File Content A single file with path and content
- Asset
File Summary Summary of a file within an asset, including its path, version, and timestamps.
- Asset
Source UrlContent Content for an asset sourced from an external URL.
- Asset
Type Summary Summary of an asset type, including its identifier and description.
- Asset
Version Metadata Metadata for a single version of an asset, including the version number and timestamps.
- Asset
ZipContent A zip file containing asset files
- Association
Represents a service association within an AgentSpace, defining how the agent interacts with external services.
- AwsConfiguration
Configuration for AWS monitor account integration, allowing AIDevOps to monitor AWS resources.
- Azure
Configuration Configuration for Azure subscription integration.
- Azure
DevOps Configuration Configuration for Azure DevOps project integration.
- Capability
Configuration Capability configuration for the AWS DevOps Agent.
- Chat
Execution A single chat execution summary
- Datadog
Service Details Complete service details for Datadog MCP server integration.
- Dynatrace
Configuration Configuration for Dynatrace monitoring integration.
- DynatraceO
Auth Client Credentials Config OAuth client credentials configuration for Dynatrace.
- Dynatrace
Service Details Complete service details for Dynatrace integration.
- Event
Channel Configuration Configuration for Event Channel integration.
- Event
Channel Details Service details for Event Channel integration.
- Execution
Represents an execution instance with its lifecycle information
- Generic
Webhook Generic webhook configuration for services that support webhook notifications.
- GitHub
Configuration Configuration for GitHub repository integration.
- GitLab
Configuration Configuration for GitLab project integration.
- GitLab
Details Service details for GitLab integration.
- Goal
Represents a goal with all its properties and metadata
- Goal
Content Content of a goal
- Goal
Schedule Schedule configuration for goal evaluations
- Goal
Schedule Input Schedule configuration for updating goal evaluations
- Grafana
Service Details Complete service details for Grafana MCP server integration.
- IamAuth
Configuration Configuration for IAM-based authentication flow for the Operator App.
- IdcAuth
Configuration Configuration for AWS Identity Center (IdC) authentication flow for the Operator App.
- IdpAuth
Configuration Configuration for external Identity Provider OIDC authentication flow for the Operator App.
- Journal
Record Represents a journal record containing execution details and content
- McpServer
ApiKey Config API key configuration for MCP server.
- McpServer
Authorization Discovery Config Authorization discovery configuration for MCP server.
- McpServer
Bearer Token Config Bearer token configuration for MCP server (RFC 6750).
- McpServer
Configuration Configuration for Model Context Protocol (MCP) server integration.
- McpServer
Datadog Configuration Mixin for webhook update support.
- McpServer
Details Complete service details for MCP server integration.
- McpServer
Grafana Configuration Configuration for Grafana MCP server integration, used with an AWS-hosted MCP server.
- McpServer
NewRelic Configuration Mixin for webhook update support.
- McpServerO
Auth3 LoConfig OAuth 3-legged authorization configuration for MCP server.
- McpServerO
Auth Client Credentials Config OAuth client credentials configuration for MCP server.
- McpServer
SigV4 Authorization Config Authorization configuration for SigV4-authenticated MCP server.
- McpServer
SigV4 Configuration Configuration for SigV4-authenticated MCP server integration.
- McpServer
SigV4 Service Details Complete service details for SigV4-authenticated MCP server integration.
- McpServer
Splunk Configuration Mixin for webhook update support.
- McpTool
Detail An MCP tool together with its access categorization.
- NewRelic
ApiKey Config API key authentication configuration for New Relic service.
- NewRelic
Service Details Complete service details for New Relic integration.
- OAuth
Additional Step Details Details for completing OAuth authorization step.
- Pager
Duty Configuration Configuration for Pagerduty integration.
- Pager
Duty Details Complete service details for PagerDuty integration
- Pager
DutyO Auth Client Credentials Config OAuth client credentials configuration for PagerDuty.
- Pattern
Filter A regex-based match condition. Passes when the value matches any pattern.
- Pending
Message Represents a pending message in an agent execution.
- Private
Connection Summary Summary of a Private Connection.
- Recommendation
Represents a recommendation with all its properties and metadata
- Recommendation
Content Content of a recommendation
- Reference
Input Reference information linking a task to external systems - for input with validation
- Reference
Output Reference information linking a task to external systems - for output without validation
- Registered
Azure DevOps Service Details Details specific to a registered Azure DevOps service.
- Registered
Azure Identity Details Details specific to a registered Azure identity using AWS Outbound Identity Federation.
- Registered
GitLab Service Details Details specific to a registered GitLab instance.
- Registered
Github Service Details Details specific to a registered GitHub service.
- Registered
Grafana Server Details Details specific to a registered Grafana server, used by the built-in MCP server.
- Registered
McpServer Details Details specific to a registered MCP (Model Context Protocol) server.
- Registered
McpServer SigV4 Details Details specific to a registered SigV4-authenticated MCP server.
- Registered
NewRelic Details Details specific to a registered NewRelic instance.
- Registered
Pager Duty Details Details specific to a registered PagerDuty service.
- Registered
Remote Agent Details Details specific to a registered token-based remote A2A agent.
- Registered
Remote Agent SigV4 Details Details specific to a registered SigV4-authenticated remote A2A agent.
- Registered
Service Represents a registered service with its configuration and accessible resources.
- Registered
Service NowDetails Details specific to a registered ServiceNow instance.
- Registered
Slack Service Details Details specific to a registered Slack workspace.
- Remote
Agent ApiKey Config API key configuration for remote A2A agent.
- Remote
Agent Bearer Token Config Bearer token configuration for remote A2A agent (RFC 6750).
- Remote
Agent Configuration Configuration for token-based remote A2A agent integration.
- Remote
AgentO Auth Client Credentials Config OAuth client credentials configuration for remote A2A agent.
- Remote
Agent Service Details Complete service details for token-based remote A2A agent integration.
- Remote
Agent SigV4 Authorization Config SigV4 authorization configuration for remote A2A agent.
- Remote
Agent SigV4 Configuration Configuration for SigV4-authenticated remote A2A agent integration.
- Remote
Agent SigV4 Service Details Complete service details for SigV4-authenticated remote A2A agent integration.
- Schedule
Condition Schedule-based condition that fires the Trigger
- Self
Managed Input Configuration for a self-managed Private Connection.
- Send
Message Content Block Delta Event Event emitted for each incremental content delta within a content block
- Send
Message Content Block Start Event Event emitted when a new content block starts
- Send
Message Content Block Stop Event Event emitted when a content block is complete
- Send
Message Context Context object for additional message metadata
- Send
Message Heartbeat Event Heartbeat event to keep connection alive
- Send
Message Json Delta JSON delta containing partial JSON
- Send
Message Response Completed Event Event emitted when the response completes successfully
- Send
Message Response Created Event Event emitted when the response is created
- Send
Message Response Failed Event Event emitted when the response fails
- Send
Message Response InProgress Event Event emitted while the response is being generated
- Send
Message Summary Event Event summarizing agent actions
- Send
Message Text Delta Text delta containing a text fragment
- Send
Message Usage Info Token usage information
- Service
Managed Input Configuration for a service-managed Private Connection.
- Service
NowConfiguration Configuration for ServiceNow instance integration.
- Service
NowO Auth Client Credentials Config OAuth client credentials configuration for ServiceNow.
- Service
NowService Details Complete service details for ServiceNow integration.
- Slack
Bidirectional Configuration Configuration for bidirectional Slack communication.
- Slack
Channel Represents a Slack channel with its ID and optional name.
- Slack
Configuration Configuration for Slack workspace integration.
- Slack
Transmission Target Defines Slack channels for different types of agent notifications.
- Source
AwsConfiguration Configuration for AWS source account integration. Setting the role ARNs on this configuration requires the caller to have at least the iam:PassRole permission (see assumableRoleArn).
- Task
Represents a backlog task with all its properties and metadata
- Task
Filter Filter criteria for listing backlog tasks, supporting time range, priority, status, and type filters.
- Trigger
A Trigger fires on a schedule and invokes an agent
- Trigger
Filter Group A group of trigger conditions. The group matches when ALL present conditions pass. A group cannot be empty: at least one condition must be present.
- Usage
Metric Represents a usage metric with its configured limit and current usage value.
- User
Reference Reference to a user in the system
- Validation
Exception Field Describes one specific validation failure for an input member.
- Webhook
Represents a complete Webhook with all its properties, and unique identifier.
Enums§
- Additional
Service Details Union of service-specific details for different service types.
- Additional
Service Registration Step Additional steps required to complete service registration.
- Agent
Space Preference Key - When writing a match expression against
AgentSpacePreferenceKey, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Approval
Action Type - When writing a match expression against
ApprovalActionType, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Approval
Status - When writing a match expression against
ApprovalStatus, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Asset
Content Content for an asset: a single file, a zip bundle, or a source URL to import from
- Asset
File Body Content of an individual asset file
- Assistant
Message Block A block of content in an assistant message.
- Auth
Flow - When writing a match expression against
AuthFlow, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Capability
Type - When writing a match expression against
CapabilityType, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Datadog
Authorization Config Authorization configuration for Datadog MCP server (uses authorization discovery only).
- Dynatrace
Service Authorization Config Authorization configuration options for Dynatrace service.
- Event
Channel Type - When writing a match expression against
EventChannelType, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Execution
Status - When writing a match expression against
ExecutionStatus, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - GitLab
Token Type - When writing a match expression against
GitLabTokenType, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Github
Repo Owner Type - When writing a match expression against
GithubRepoOwnerType, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Goal
Status - When writing a match expression against
GoalStatus, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Goal
Type - When writing a match expression against
GoalType, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - IpAddress
Type - When writing a match expression against
IpAddressType, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - McpServer
Authorization Config Authorization configuration options for MCP server, supporting OAuth, API key, bearer token, and authorization discovery methods.
- McpServer
Authorization Method - When writing a match expression against
McpServerAuthorizationMethod, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Message
A message in a conversation, either from the user or the assistant.
- Monitor
Account Type - When writing a match expression against
MonitorAccountType, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - NewRelic
Region - When writing a match expression against
NewRelicRegion, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - NewRelic
Service Authorization Config Authorization configuration options for New Relic service.
- Order
Type - When writing a match expression against
OrderType, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Pager
Duty Authorization Config Authorization configuration options for PagerDuty service.
- Post
Register Service Supported Service - When writing a match expression against
PostRegisterServiceSupportedService, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Priority
- When writing a match expression against
Priority, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Private
Connection Mode Private Connection mode — either service-managed or self-managed.
- Private
Connection Status - When writing a match expression against
PrivateConnectionStatus, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Private
Connection Type - When writing a match expression against
PrivateConnectionType, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Recommendation
Priority - When writing a match expression against
RecommendationPriority, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Recommendation
Status - When writing a match expression against
RecommendationStatus, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Remote
Agent Authorization Config Authorization configuration for remote A2A agents with token-based auth (API key, OAuth, bearer token).
- Remote
Agent Authorization Method - When writing a match expression against
RemoteAgentAuthorizationMethod, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Resource
Config DnsResolution - When writing a match expression against
ResourceConfigDnsResolution, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Scheduler
State - When writing a match expression against
SchedulerState, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Send
Message Content Block Delta Union of possible delta payloads within a content block delta event
- Send
Message Events Event stream for chat message responses using the content block model. Events follow a lifecycle: responseCreated -> responseInProgress -> (contentBlockStart/contentBlockDelta/contentBlockStop events) -> responseCompleted|responseFailed SendMessage always uses content block mode — legacy per-field events (outputTextDelta, functionCallArgumentsDelta, etc.) are not emitted.
- Service
- When writing a match expression against
Service, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Service
Configuration Union of all supported service configuration types. Each service has its own specific configuration structure.
- Service
Details Union of service-specific configuration details for service registration.
- Service
NowService Authorization Config Authorization configuration options for ServiceNow service.
- Source
Account Type - When writing a match expression against
SourceAccountType, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Task
Sort Field - When writing a match expression against
TaskSortField, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Task
Sort Order - When writing a match expression against
TaskSortOrder, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Task
Status - When writing a match expression against
TaskStatus, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Task
Type - When writing a match expression against
TaskType, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Tool
Classification - When writing a match expression against
ToolClassification, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Trigger
Condition Defines the firing condition for a Trigger
- Trigger
Event - When writing a match expression against
TriggerEvent, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - User
Message Block A block of content in a user message.
- User
Type - When writing a match expression against
UserType, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Validation
Status - When writing a match expression against
ValidationStatus, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Webhook
Type - When writing a match expression against
WebhookType, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature.