@aws-sdk/client-bedrock-agentcore 3.1034.0 → 3.1035.0

package/dist-types/models/models_0.d.ts

@@ -1,5 +1,5 @@
 import type { DocumentType as __DocumentType, StreamingBlobTypes } from "@smithy/types";
-import type { AutomationStreamStatus, BrowserActionStatus, BrowserEnterprisePolicyType, BrowserSessionStatus, CodeInterpreterSessionStatus, CommandExecutionStatus, ContentBlockType, DescriptorType, EventFilterCondition, ExtractionJobStatus, LanguageRuntime, MemoryRecordStatus, MouseButton, Oauth2FlowType, OperatorType, ProgrammingLanguage, RegistryRecordStatus, ResourceContentType, Role, ScreenshotFormat, SessionStatus, TaskStatus, ToolName } from "./enums";
+import type { AutomationStreamStatus, BrowserActionStatus, BrowserEnterprisePolicyType, BrowserSessionStatus, CodeInterpreterSessionStatus, CommandExecutionStatus, ContentBlockType, DescriptorType, EventFilterCondition, ExtractionJobStatus, HarnessConversationRole, HarnessStopReason, HarnessToolType, HarnessToolUseStatus, HarnessToolUseType, LanguageRuntime, MemoryRecordStatus, MouseButton, Oauth2FlowType, OAuthGrantType, OperatorType, ProgrammingLanguage, RegistryRecordStatus, ResourceContentType, Role, ScreenshotFormat, SessionStatus, TaskStatus, ToolName } from "./enums";
 import type { AccessDeniedException, ConflictException, InternalServerException, ResourceNotFoundException, RuntimeClientError, ServiceQuotaExceededException, ThrottlingException, ValidationException } from "./errors";
 /**
  * <p> The agent card definition for A2A descriptors, including the schema version and inline content that describes the agent's capabilities.</p>
@@ -3306,6 +3306,1417 @@ export interface InvokeCodeInterpreterResponse {
      */
     stream: AsyncIterable<CodeInterpreterStreamOutput> | undefined;
 }
+/**
+ * <p>A block of reasoning text from the model.</p>
+ * @public
+ */
+export interface HarnessReasoningTextBlock {
+    /**
+     * <p>The reasoning text.</p>
+     * @public
+     */
+    text: string | undefined;
+    /**
+     * <p>Signature for verifying the reasoning content.</p>
+     * @public
+     */
+    signature?: string | undefined;
+}
+/**
+ * <p>Reasoning content from the model.</p>
+ * @public
+ */
+export type HarnessReasoningContentBlock = HarnessReasoningContentBlock.ReasoningTextMember | HarnessReasoningContentBlock.RedactedContentMember | HarnessReasoningContentBlock.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace HarnessReasoningContentBlock {
+    /**
+     * <p>The reasoning text.</p>
+     * @public
+     */
+    interface ReasoningTextMember {
+        reasoningText: HarnessReasoningTextBlock;
+        redactedContent?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Redacted reasoning content.</p>
+     * @public
+     */
+    interface RedactedContentMember {
+        reasoningText?: never;
+        redactedContent: Uint8Array;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        reasoningText?: never;
+        redactedContent?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        reasoningText: (value: HarnessReasoningTextBlock) => T;
+        redactedContent: (value: Uint8Array) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * <p>A content block within a tool result.</p>
+ * @public
+ */
+export type HarnessToolResultContentBlock = HarnessToolResultContentBlock.JsonMember | HarnessToolResultContentBlock.TextMember | HarnessToolResultContentBlock.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace HarnessToolResultContentBlock {
+    /**
+     * <p>Text content.</p>
+     * @public
+     */
+    interface TextMember {
+        text: string;
+        json?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>JSON content.</p>
+     * @public
+     */
+    interface JsonMember {
+        text?: never;
+        json: __DocumentType;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        text?: never;
+        json?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        text: (value: string) => T;
+        json: (value: __DocumentType) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * <p>The result of a tool execution.</p>
+ * @public
+ */
+export interface HarnessToolResultBlock {
+    /**
+     * <p>The tool use ID that this result corresponds to.</p>
+     * @public
+     */
+    toolUseId: string | undefined;
+    /**
+     * <p>The content of the tool result.</p>
+     * @public
+     */
+    content: HarnessToolResultContentBlock[] | undefined;
+    /**
+     * <p>The status of the tool execution.</p>
+     * @public
+     */
+    status?: HarnessToolUseStatus | undefined;
+    /**
+     * <p>The type of tool use that produced this result.</p>
+     * @public
+     */
+    type?: HarnessToolUseType | undefined;
+}
+/**
+ * <p>A tool use request from the model.</p>
+ * @public
+ */
+export interface HarnessToolUseBlock {
+    /**
+     * <p>The name of the tool to call.</p>
+     * @public
+     */
+    name: string | undefined;
+    /**
+     * <p>The unique ID of this tool use.</p>
+     * @public
+     */
+    toolUseId: string | undefined;
+    /**
+     * <p>The JSON input to pass to the tool.</p>
+     * @public
+     */
+    input: __DocumentType | undefined;
+    /**
+     * <p>The type of tool use.</p>
+     * @public
+     */
+    type?: HarnessToolUseType | undefined;
+    /**
+     * <p>The name of the MCP server providing this tool.</p>
+     * @public
+     */
+    serverName?: string | undefined;
+}
+/**
+ * <p>A content block within a message.</p>
+ * @public
+ */
+export type HarnessContentBlock = HarnessContentBlock.ReasoningContentMember | HarnessContentBlock.TextMember | HarnessContentBlock.ToolResultMember | HarnessContentBlock.ToolUseMember | HarnessContentBlock.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace HarnessContentBlock {
+    /**
+     * <p>Text content.</p>
+     * @public
+     */
+    interface TextMember {
+        text: string;
+        toolUse?: never;
+        toolResult?: never;
+        reasoningContent?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>A tool use request from the model.</p>
+     * @public
+     */
+    interface ToolUseMember {
+        text?: never;
+        toolUse: HarnessToolUseBlock;
+        toolResult?: never;
+        reasoningContent?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>A tool execution result.</p>
+     * @public
+     */
+    interface ToolResultMember {
+        text?: never;
+        toolUse?: never;
+        toolResult: HarnessToolResultBlock;
+        reasoningContent?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Model reasoning content.</p>
+     * @public
+     */
+    interface ReasoningContentMember {
+        text?: never;
+        toolUse?: never;
+        toolResult?: never;
+        reasoningContent: HarnessReasoningContentBlock;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        text?: never;
+        toolUse?: never;
+        toolResult?: never;
+        reasoningContent?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        text: (value: string) => T;
+        toolUse: (value: HarnessToolUseBlock) => T;
+        toolResult: (value: HarnessToolResultBlock) => T;
+        reasoningContent: (value: HarnessReasoningContentBlock) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * <p>A message in the conversation.</p>
+ * @public
+ */
+export interface HarnessMessage {
+    /**
+     * <p>The role of the message sender.</p>
+     * @public
+     */
+    role: HarnessConversationRole | undefined;
+    /**
+     * <p>The content blocks of the message.</p>
+     * @public
+     */
+    content: HarnessContentBlock[] | undefined;
+}
+/**
+ * <p>Configuration for an Amazon Bedrock model provider.</p>
+ * @public
+ */
+export interface HarnessBedrockModelConfig {
+    /**
+     * <p>The Bedrock model ID.</p>
+     * @public
+     */
+    modelId: string | undefined;
+    /**
+     * <p>The maximum number of tokens to allow in the generated response per iteration.</p>
+     * @public
+     */
+    maxTokens?: number | undefined;
+    /**
+     * <p>The temperature to set when calling the model.</p>
+     * @public
+     */
+    temperature?: number | undefined;
+    /**
+     * <p>The topP set when calling the model.</p>
+     * @public
+     */
+    topP?: number | undefined;
+}
+/**
+ * <p>Configuration for a Google Gemini model provider. Requires an API key stored in AgentCore Identity.</p>
+ * @public
+ */
+export interface HarnessGeminiModelConfig {
+    /**
+     * <p>The Gemini model ID.</p>
+     * @public
+     */
+    modelId: string | undefined;
+    /**
+     * <p>The ARN of your Gemini API key on AgentCore Identity.</p>
+     * @public
+     */
+    apiKeyArn: string | undefined;
+    /**
+     * <p>The maximum number of tokens to allow in the generated response per iteration.</p>
+     * @public
+     */
+    maxTokens?: number | undefined;
+    /**
+     * <p>The temperature to set when calling the model.</p>
+     * @public
+     */
+    temperature?: number | undefined;
+    /**
+     * <p>The topP set when calling the model.</p>
+     * @public
+     */
+    topP?: number | undefined;
+    /**
+     * <p>The topK set when calling the model.</p>
+     * @public
+     */
+    topK?: number | undefined;
+}
+/**
+ * <p>Configuration for an OpenAI model provider. Requires an API key stored in AgentCore Identity.</p>
+ * @public
+ */
+export interface HarnessOpenAiModelConfig {
+    /**
+     * <p>The OpenAI model ID.</p>
+     * @public
+     */
+    modelId: string | undefined;
+    /**
+     * <p>The ARN of your OpenAI API key on AgentCore Identity.</p>
+     * @public
+     */
+    apiKeyArn: string | undefined;
+    /**
+     * <p>The maximum number of tokens to allow in the generated response per iteration.</p>
+     * @public
+     */
+    maxTokens?: number | undefined;
+    /**
+     * <p>The temperature to set when calling the model.</p>
+     * @public
+     */
+    temperature?: number | undefined;
+    /**
+     * <p>The topP set when calling the model.</p>
+     * @public
+     */
+    topP?: number | undefined;
+}
+/**
+ * <p>Specification of which model to use.</p>
+ * @public
+ */
+export type HarnessModelConfiguration = HarnessModelConfiguration.BedrockModelConfigMember | HarnessModelConfiguration.GeminiModelConfigMember | HarnessModelConfiguration.OpenAiModelConfigMember | HarnessModelConfiguration.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace HarnessModelConfiguration {
+    /**
+     * <p>Configuration for an Amazon Bedrock model.</p>
+     * @public
+     */
+    interface BedrockModelConfigMember {
+        bedrockModelConfig: HarnessBedrockModelConfig;
+        openAiModelConfig?: never;
+        geminiModelConfig?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Configuration for an OpenAI model.</p>
+     * @public
+     */
+    interface OpenAiModelConfigMember {
+        bedrockModelConfig?: never;
+        openAiModelConfig: HarnessOpenAiModelConfig;
+        geminiModelConfig?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Configuration for a Google Gemini model.</p>
+     * @public
+     */
+    interface GeminiModelConfigMember {
+        bedrockModelConfig?: never;
+        openAiModelConfig?: never;
+        geminiModelConfig: HarnessGeminiModelConfig;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        bedrockModelConfig?: never;
+        openAiModelConfig?: never;
+        geminiModelConfig?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        bedrockModelConfig: (value: HarnessBedrockModelConfig) => T;
+        openAiModelConfig: (value: HarnessOpenAiModelConfig) => T;
+        geminiModelConfig: (value: HarnessGeminiModelConfig) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * <p>A skill available to the agent.</p>
+ * @public
+ */
+export type HarnessSkill = HarnessSkill.PathMember | HarnessSkill.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace HarnessSkill {
+    /**
+     * <p>The filesystem path to the skill definition.</p>
+     * @public
+     */
+    interface PathMember {
+        path: string;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        path?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        path: (value: string) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * <p>A content block in the system prompt.</p>
+ * @public
+ */
+export type HarnessSystemContentBlock = HarnessSystemContentBlock.TextMember | HarnessSystemContentBlock.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace HarnessSystemContentBlock {
+    /**
+     * <p>The text content of the system prompt block.</p>
+     * @public
+     */
+    interface TextMember {
+        text: string;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        text?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        text: (value: string) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * <p>Configuration for AgentCore Browser.</p>
+ * @public
+ */
+export interface HarnessAgentCoreBrowserConfig {
+    /**
+     * <p>If not populated, the built-in Browser ARN is used.</p>
+     * @public
+     */
+    browserArn?: string | undefined;
+}
+/**
+ * <p>Configuration for AgentCore Code Interpreter.</p>
+ * @public
+ */
+export interface HarnessAgentCoreCodeInterpreterConfig {
+    /**
+     * <p>If not populated, the built-in Code Interpreter ARN is used.</p>
+     * @public
+     */
+    codeInterpreterArn?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface Unit {
+}
+/**
+ * <p>Configuration for an OAuth 2.0 credential provider used to authenticate tool calls.</p>
+ * @public
+ */
+export interface OAuthCredentialProvider {
+    /**
+     * <p>The ARN of the OAuth 2.0 credential provider in AgentCore Identity.</p>
+     * @public
+     */
+    providerArn: string | undefined;
+    /**
+     * <p>The OAuth 2.0 scopes to request when obtaining an access token.</p>
+     * @public
+     */
+    scopes: string[] | undefined;
+    /**
+     * <p>Additional custom parameters to include in the OAuth 2.0 token request.</p>
+     * @public
+     */
+    customParameters?: Record<string, string> | undefined;
+    /**
+     * <p>The OAuth 2.0 grant type to use for authentication.</p>
+     * @public
+     */
+    grantType?: OAuthGrantType | undefined;
+    /**
+     * <p>The default return URL for the OAuth 2.0 authorization flow.</p>
+     * @public
+     */
+    defaultReturnUrl?: string | undefined;
+}
+/**
+ * <p>Authentication method for calling a Gateway.</p>
+ * @public
+ */
+export type HarnessGatewayOutboundAuth = HarnessGatewayOutboundAuth.AwsIamMember | HarnessGatewayOutboundAuth.NoneMember | HarnessGatewayOutboundAuth.OauthMember | HarnessGatewayOutboundAuth.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace HarnessGatewayOutboundAuth {
+    /**
+     * <p>SigV4-sign requests using the agent's execution role.</p>
+     * @public
+     */
+    interface AwsIamMember {
+        awsIam: Unit;
+        none?: never;
+        oauth?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>No authentication.</p>
+     * @public
+     */
+    interface NoneMember {
+        awsIam?: never;
+        none: Unit;
+        oauth?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>OAuth 2.0 authentication via AgentCore Identity.</p>
+     * @public
+     */
+    interface OauthMember {
+        awsIam?: never;
+        none?: never;
+        oauth: OAuthCredentialProvider;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        awsIam?: never;
+        none?: never;
+        oauth?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        awsIam: (value: Unit) => T;
+        none: (value: Unit) => T;
+        oauth: (value: OAuthCredentialProvider) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * <p>Configuration for AgentCore Gateway.</p>
+ * @public
+ */
+export interface HarnessAgentCoreGatewayConfig {
+    /**
+     * <p>The ARN of the desired AgentCore Gateway.</p>
+     * @public
+     */
+    gatewayArn: string | undefined;
+    /**
+     * <p>How Loopy authenticates to this Gateway. Defaults to AWS_IAM (SigV4) if omitted.</p>
+     * @public
+     */
+    outboundAuth?: HarnessGatewayOutboundAuth | undefined;
+}
+/**
+ * <p>Configuration for an inline function tool. When the agent calls this tool, the tool call is returned to the caller for external execution.</p>
+ * @public
+ */
+export interface HarnessInlineFunctionConfig {
+    /**
+     * <p>Description of what the tool does, provided to the model.</p>
+     * @public
+     */
+    description: string | undefined;
+    /**
+     * <p>JSON Schema describing the tool's input parameters.</p>
+     * @public
+     */
+    inputSchema: __DocumentType | undefined;
+}
+/**
+ * <p>Configuration for connecting to a remote MCP server.</p>
+ * @public
+ */
+export interface HarnessRemoteMcpConfig {
+    /**
+     * <p>URL of the MCP endpoint.</p>
+     * @public
+     */
+    url: string | undefined;
+    /**
+     * Map of key/value pairs for HTTP headers.
+     * @public
+     */
+    headers?: Record<string, string> | undefined;
+}
+/**
+ * <p>Configuration union for different tool types.</p>
+ * @public
+ */
+export type HarnessToolConfiguration = HarnessToolConfiguration.AgentCoreBrowserMember | HarnessToolConfiguration.AgentCoreCodeInterpreterMember | HarnessToolConfiguration.AgentCoreGatewayMember | HarnessToolConfiguration.InlineFunctionMember | HarnessToolConfiguration.RemoteMcpMember | HarnessToolConfiguration.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace HarnessToolConfiguration {
+    /**
+     * <p>Configuration for remote MCP server.</p>
+     * @public
+     */
+    interface RemoteMcpMember {
+        remoteMcp: HarnessRemoteMcpConfig;
+        agentCoreBrowser?: never;
+        agentCoreGateway?: never;
+        inlineFunction?: never;
+        agentCoreCodeInterpreter?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Configuration for AgentCore Browser.</p>
+     * @public
+     */
+    interface AgentCoreBrowserMember {
+        remoteMcp?: never;
+        agentCoreBrowser: HarnessAgentCoreBrowserConfig;
+        agentCoreGateway?: never;
+        inlineFunction?: never;
+        agentCoreCodeInterpreter?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Configuration for AgentCore Gateway.</p>
+     * @public
+     */
+    interface AgentCoreGatewayMember {
+        remoteMcp?: never;
+        agentCoreBrowser?: never;
+        agentCoreGateway: HarnessAgentCoreGatewayConfig;
+        inlineFunction?: never;
+        agentCoreCodeInterpreter?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Configuration for an inline function tool.</p>
+     * @public
+     */
+    interface InlineFunctionMember {
+        remoteMcp?: never;
+        agentCoreBrowser?: never;
+        agentCoreGateway?: never;
+        inlineFunction: HarnessInlineFunctionConfig;
+        agentCoreCodeInterpreter?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Configuration for AgentCore Code Interpreter.</p>
+     * @public
+     */
+    interface AgentCoreCodeInterpreterMember {
+        remoteMcp?: never;
+        agentCoreBrowser?: never;
+        agentCoreGateway?: never;
+        inlineFunction?: never;
+        agentCoreCodeInterpreter: HarnessAgentCoreCodeInterpreterConfig;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        remoteMcp?: never;
+        agentCoreBrowser?: never;
+        agentCoreGateway?: never;
+        inlineFunction?: never;
+        agentCoreCodeInterpreter?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        remoteMcp: (value: HarnessRemoteMcpConfig) => T;
+        agentCoreBrowser: (value: HarnessAgentCoreBrowserConfig) => T;
+        agentCoreGateway: (value: HarnessAgentCoreGatewayConfig) => T;
+        inlineFunction: (value: HarnessInlineFunctionConfig) => T;
+        agentCoreCodeInterpreter: (value: HarnessAgentCoreCodeInterpreterConfig) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * <p>A tool available to the agent loop.</p>
+ * @public
+ */
+export interface HarnessTool {
+    /**
+     * <p>The type of tool.</p>
+     * @public
+     */
+    type: HarnessToolType | undefined;
+    /**
+     * <p>Unique name for the tool. If not provided, a name will be inferred or generated.</p>
+     * @public
+     */
+    name?: string | undefined;
+    /**
+     * <p>Tool-specific configuration.</p>
+     * @public
+     */
+    config?: HarnessToolConfiguration | undefined;
+}
+/**
+ * @public
+ */
+export interface InvokeHarnessRequest {
+    /**
+     * <p>The ARN of the harness to invoke.</p>
+     * @public
+     */
+    harnessArn: string | undefined;
+    /**
+     * <p>The session ID for the invocation. Use the same session ID across requests to continue a conversation.</p>
+     * @public
+     */
+    runtimeSessionId: string | undefined;
+    /**
+     * <p>The messages to send to the agent.</p>
+     * @public
+     */
+    messages: HarnessMessage[] | undefined;
+    /**
+     * <p>The model configuration to use for this invocation. If specified, overrides the harness default.</p>
+     * @public
+     */
+    model?: HarnessModelConfiguration | undefined;
+    /**
+     * <p>The system prompt to use for this invocation. If specified, overrides the harness default.</p>
+     * @public
+     */
+    systemPrompt?: HarnessSystemContentBlock[] | undefined;
+    /**
+     * <p>The tools available to the agent for this invocation. If specified, overrides the harness default.</p>
+     * @public
+     */
+    tools?: HarnessTool[] | undefined;
+    /**
+     * <p>The skills available to the agent for this invocation. If specified, overrides the harness default.</p>
+     * @public
+     */
+    skills?: HarnessSkill[] | undefined;
+    /**
+     * <p>The tools that the agent is allowed to use for this invocation. If specified, overrides the harness default.</p>
+     * @public
+     */
+    allowedTools?: string[] | undefined;
+    /**
+     * <p>The maximum number of iterations the agent loop can execute. If specified, overrides the harness default.</p>
+     * @public
+     */
+    maxIterations?: number | undefined;
+    /**
+     * <p>The maximum number of tokens the agent can generate per iteration. If specified, overrides the harness default.</p>
+     * @public
+     */
+    maxTokens?: number | undefined;
+    /**
+     * <p>The maximum duration in seconds for the agent loop execution. If specified, overrides the harness default.</p>
+     * @public
+     */
+    timeoutSeconds?: number | undefined;
+    /**
+     * <p>The actor ID for memory operations. Overrides the actor ID configured on the harness.</p>
+     * @public
+     */
+    actorId?: string | undefined;
+}
+/**
+ * <p>A delta update to a reasoning content block.</p>
+ * @public
+ */
+export type HarnessReasoningContentBlockDelta = HarnessReasoningContentBlockDelta.RedactedContentMember | HarnessReasoningContentBlockDelta.SignatureMember | HarnessReasoningContentBlockDelta.TextMember | HarnessReasoningContentBlockDelta.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace HarnessReasoningContentBlockDelta {
+    /**
+     * <p>Reasoning text delta.</p>
+     * @public
+     */
+    interface TextMember {
+        text: string;
+        redactedContent?: never;
+        signature?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Redacted reasoning content.</p>
+     * @public
+     */
+    interface RedactedContentMember {
+        text?: never;
+        redactedContent: Uint8Array;
+        signature?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Signature for the reasoning content.</p>
+     * @public
+     */
+    interface SignatureMember {
+        text?: never;
+        redactedContent?: never;
+        signature: string;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        text?: never;
+        redactedContent?: never;
+        signature?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        text: (value: string) => T;
+        redactedContent: (value: Uint8Array) => T;
+        signature: (value: string) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * <p>A delta update to a tool result content block.</p>
+ * @public
+ */
+export type HarnessToolResultBlockDelta = HarnessToolResultBlockDelta.JsonMember | HarnessToolResultBlockDelta.TextMember | HarnessToolResultBlockDelta.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace HarnessToolResultBlockDelta {
+    /**
+     * <p>A text tool result delta.</p>
+     * @public
+     */
+    interface TextMember {
+        text: string;
+        json?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>A JSON tool result delta.</p>
+     * @public
+     */
+    interface JsonMember {
+        text?: never;
+        json: __DocumentType;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        text?: never;
+        json?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        text: (value: string) => T;
+        json: (value: __DocumentType) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * <p>Delta payload for tool use input.</p>
+ * @public
+ */
+export interface HarnessToolUseBlockDelta {
+    /**
+     * <p>The partial JSON input for the tool call.</p>
+     * @public
+     */
+    input: string | undefined;
+}
+/**
+ * <p>A delta update to a content block.</p>
+ * @public
+ */
+export type HarnessContentBlockDelta = HarnessContentBlockDelta.ReasoningContentMember | HarnessContentBlockDelta.TextMember | HarnessContentBlockDelta.ToolResultMember | HarnessContentBlockDelta.ToolUseMember | HarnessContentBlockDelta.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace HarnessContentBlockDelta {
+    /**
+     * <p>A text delta.</p>
+     * @public
+     */
+    interface TextMember {
+        text: string;
+        toolUse?: never;
+        toolResult?: never;
+        reasoningContent?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>A tool use input delta.</p>
+     * @public
+     */
+    interface ToolUseMember {
+        text?: never;
+        toolUse: HarnessToolUseBlockDelta;
+        toolResult?: never;
+        reasoningContent?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>A tool result delta.</p>
+     * @public
+     */
+    interface ToolResultMember {
+        text?: never;
+        toolUse?: never;
+        toolResult: HarnessToolResultBlockDelta[];
+        reasoningContent?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>A reasoning content delta.</p>
+     * @public
+     */
+    interface ReasoningContentMember {
+        text?: never;
+        toolUse?: never;
+        toolResult?: never;
+        reasoningContent: HarnessReasoningContentBlockDelta;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        text?: never;
+        toolUse?: never;
+        toolResult?: never;
+        reasoningContent?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        text: (value: string) => T;
+        toolUse: (value: HarnessToolUseBlockDelta) => T;
+        toolResult: (value: HarnessToolResultBlockDelta[]) => T;
+        reasoningContent: (value: HarnessReasoningContentBlockDelta) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * <p>Event containing a delta update to a content block.</p>
+ * @public
+ */
+export interface HarnessContentBlockDeltaEvent {
+    /**
+     * <p>The index of the content block being updated.</p>
+     * @public
+     */
+    contentBlockIndex: number | undefined;
+    /**
+     * <p>The delta payload.</p>
+     * @public
+     */
+    delta: HarnessContentBlockDelta | undefined;
+}
+/**
+ * <p>Start payload for a tool result content block.</p>
+ * @public
+ */
+export interface HarnessToolResultBlockStart {
+    /**
+     * <p>The tool use ID that this result corresponds to.</p>
+     * @public
+     */
+    toolUseId: string | undefined;
+    /**
+     * <p>The status of the tool execution.</p>
+     * @public
+     */
+    status?: HarnessToolUseStatus | undefined;
+}
+/**
+ * <p>Start payload for a tool use content block.</p>
+ * @public
+ */
+export interface HarnessToolUseBlockStart {
+    /**
+     * <p>The unique ID of this tool use.</p>
+     * @public
+     */
+    toolUseId: string | undefined;
+    /**
+     * <p>The name of the tool being called.</p>
+     * @public
+     */
+    name: string | undefined;
+    /**
+     * <p>The type of tool use.</p>
+     * @public
+     */
+    type?: HarnessToolUseType | undefined;
+    /**
+     * <p>The name of the MCP server providing this tool.</p>
+     * @public
+     */
+    serverName?: string | undefined;
+}
+/**
+ * <p>The start payload for a content block.</p>
+ * @public
+ */
+export type HarnessContentBlockStart = HarnessContentBlockStart.ToolResultMember | HarnessContentBlockStart.ToolUseMember | HarnessContentBlockStart.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace HarnessContentBlockStart {
+    /**
+     * <p>Start of a tool use content block.</p>
+     * @public
+     */
+    interface ToolUseMember {
+        toolUse: HarnessToolUseBlockStart;
+        toolResult?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Start of a tool result content block.</p>
+     * @public
+     */
+    interface ToolResultMember {
+        toolUse?: never;
+        toolResult: HarnessToolResultBlockStart;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        toolUse?: never;
+        toolResult?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        toolUse: (value: HarnessToolUseBlockStart) => T;
+        toolResult: (value: HarnessToolResultBlockStart) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * <p>Event indicating the start of a content block.</p>
+ * @public
+ */
+export interface HarnessContentBlockStartEvent {
+    /**
+     * <p>The index of the content block within the message.</p>
+     * @public
+     */
+    contentBlockIndex: number | undefined;
+    /**
+     * <p>The content block start payload.</p>
+     * @public
+     */
+    start: HarnessContentBlockStart | undefined;
+}
+/**
+ * <p>Event indicating the end of a content block.</p>
+ * @public
+ */
+export interface HarnessContentBlockStopEvent {
+    /**
+     * <p>The index of the content block that ended.</p>
+     * @public
+     */
+    contentBlockIndex: number | undefined;
+}
+/**
+ * <p>Event indicating the start of a message.</p>
+ * @public
+ */
+export interface HarnessMessageStartEvent {
+    /**
+     * <p>The role of the message sender.</p>
+     * @public
+     */
+    role: HarnessConversationRole | undefined;
+}
+/**
+ * <p>Event indicating the end of a message.</p>
+ * @public
+ */
+export interface HarnessMessageStopEvent {
+    /**
+     * <p>The reason the agent stopped generating.</p>
+     * @public
+     */
+    stopReason: HarnessStopReason | undefined;
+}
+/**
+ * <p>Latency metrics for the invocation.</p>
+ * @public
+ */
+export interface HarnessStreamMetrics {
+    /**
+     * <p>The end-to-end latency of the invocation in milliseconds.</p>
+     * @public
+     */
+    latencyMs: number | undefined;
+}
+/**
+ * <p>Token usage counts for the invocation.</p>
+ * @public
+ */
+export interface HarnessTokenUsage {
+    /**
+     * <p>The number of input tokens consumed.</p>
+     * @public
+     */
+    inputTokens: number | undefined;
+    /**
+     * <p>The number of output tokens generated.</p>
+     * @public
+     */
+    outputTokens: number | undefined;
+    /**
+     * <p>The total number of tokens consumed.</p>
+     * @public
+     */
+    totalTokens: number | undefined;
+    /**
+     * <p>The number of input tokens read from cache.</p>
+     * @public
+     */
+    cacheReadInputTokens?: number | undefined;
+    /**
+     * <p>The number of input tokens written to cache.</p>
+     * @public
+     */
+    cacheWriteInputTokens?: number | undefined;
+}
+/**
+ * <p>Token usage and latency metrics for the invocation.</p>
+ * @public
+ */
+export interface HarnessMetadataEvent {
+    /**
+     * <p>Token usage counts.</p>
+     * @public
+     */
+    usage: HarnessTokenUsage | undefined;
+    /**
+     * <p>Latency metrics.</p>
+     * @public
+     */
+    metrics: HarnessStreamMetrics | undefined;
+}
+/**
+ * <p>The streaming events returned by a harness invocation.</p>
+ * @public
+ */
+export type InvokeHarnessStreamOutput = InvokeHarnessStreamOutput.ContentBlockDeltaMember | InvokeHarnessStreamOutput.ContentBlockStartMember | InvokeHarnessStreamOutput.ContentBlockStopMember | InvokeHarnessStreamOutput.InternalServerExceptionMember | InvokeHarnessStreamOutput.MessageStartMember | InvokeHarnessStreamOutput.MessageStopMember | InvokeHarnessStreamOutput.MetadataMember | InvokeHarnessStreamOutput.RuntimeClientErrorMember | InvokeHarnessStreamOutput.ValidationExceptionMember | InvokeHarnessStreamOutput.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace InvokeHarnessStreamOutput {
+    /**
+     * <p>Indicates the start of a new message from the agent.</p>
+     * @public
+     */
+    interface MessageStartMember {
+        messageStart: HarnessMessageStartEvent;
+        contentBlockStart?: never;
+        contentBlockDelta?: never;
+        contentBlockStop?: never;
+        messageStop?: never;
+        metadata?: never;
+        internalServerException?: never;
+        validationException?: never;
+        runtimeClientError?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Indicates the start of a new content block.</p>
+     * @public
+     */
+    interface ContentBlockStartMember {
+        messageStart?: never;
+        contentBlockStart: HarnessContentBlockStartEvent;
+        contentBlockDelta?: never;
+        contentBlockStop?: never;
+        messageStop?: never;
+        metadata?: never;
+        internalServerException?: never;
+        validationException?: never;
+        runtimeClientError?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>A delta update to the current content block.</p>
+     * @public
+     */
+    interface ContentBlockDeltaMember {
+        messageStart?: never;
+        contentBlockStart?: never;
+        contentBlockDelta: HarnessContentBlockDeltaEvent;
+        contentBlockStop?: never;
+        messageStop?: never;
+        metadata?: never;
+        internalServerException?: never;
+        validationException?: never;
+        runtimeClientError?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Indicates the end of the current content block.</p>
+     * @public
+     */
+    interface ContentBlockStopMember {
+        messageStart?: never;
+        contentBlockStart?: never;
+        contentBlockDelta?: never;
+        contentBlockStop: HarnessContentBlockStopEvent;
+        messageStop?: never;
+        metadata?: never;
+        internalServerException?: never;
+        validationException?: never;
+        runtimeClientError?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Indicates the end of the current message.</p>
+     * @public
+     */
+    interface MessageStopMember {
+        messageStart?: never;
+        contentBlockStart?: never;
+        contentBlockDelta?: never;
+        contentBlockStop?: never;
+        messageStop: HarnessMessageStopEvent;
+        metadata?: never;
+        internalServerException?: never;
+        validationException?: never;
+        runtimeClientError?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>Token usage and latency metrics for the invocation.</p>
+     * @public
+     */
+    interface MetadataMember {
+        messageStart?: never;
+        contentBlockStart?: never;
+        contentBlockDelta?: never;
+        contentBlockStop?: never;
+        messageStop?: never;
+        metadata: HarnessMetadataEvent;
+        internalServerException?: never;
+        validationException?: never;
+        runtimeClientError?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>The exception that occurs when the service encounters an unexpected internal error. This is a temporary condition that will resolve itself with retries. We recommend implementing exponential backoff retry logic in your application.</p>
+     * @public
+     */
+    interface InternalServerExceptionMember {
+        messageStart?: never;
+        contentBlockStart?: never;
+        contentBlockDelta?: never;
+        contentBlockStop?: never;
+        messageStop?: never;
+        metadata?: never;
+        internalServerException: InternalServerException;
+        validationException?: never;
+        runtimeClientError?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>The exception that occurs when the input fails to satisfy the constraints specified by the service. Check the error message for details about which input parameter is invalid and correct your request.</p>
+     * @public
+     */
+    interface ValidationExceptionMember {
+        messageStart?: never;
+        contentBlockStart?: never;
+        contentBlockDelta?: never;
+        contentBlockStop?: never;
+        messageStop?: never;
+        metadata?: never;
+        internalServerException?: never;
+        validationException: ValidationException;
+        runtimeClientError?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>The exception that occurs when there is an error in the runtime client. This can happen due to network issues, invalid configuration, or other client-side problems. Check the error message for specific details about the error.</p>
+     * @public
+     */
+    interface RuntimeClientErrorMember {
+        messageStart?: never;
+        contentBlockStart?: never;
+        contentBlockDelta?: never;
+        contentBlockStop?: never;
+        messageStop?: never;
+        metadata?: never;
+        internalServerException?: never;
+        validationException?: never;
+        runtimeClientError: RuntimeClientError;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        messageStart?: never;
+        contentBlockStart?: never;
+        contentBlockDelta?: never;
+        contentBlockStop?: never;
+        messageStop?: never;
+        metadata?: never;
+        internalServerException?: never;
+        validationException?: never;
+        runtimeClientError?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        messageStart: (value: HarnessMessageStartEvent) => T;
+        contentBlockStart: (value: HarnessContentBlockStartEvent) => T;
+        contentBlockDelta: (value: HarnessContentBlockDeltaEvent) => T;
+        contentBlockStop: (value: HarnessContentBlockStopEvent) => T;
+        messageStop: (value: HarnessMessageStopEvent) => T;
+        metadata: (value: HarnessMetadataEvent) => T;
+        internalServerException: (value: InternalServerException) => T;
+        validationException: (value: ValidationException) => T;
+        runtimeClientError: (value: RuntimeClientError) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * @public
+ */
+export interface InvokeHarnessResponse {
+    /**
+     * <p>The streaming output from the harness invocation.</p>
+     * @public
+     */
+    stream: AsyncIterable<InvokeHarnessStreamOutput> | undefined;
+}
 /**
  * <p>Contains the content of a memory record.</p>
  * @public