@aws-sdk/client-bedrock-agent-runtime 3.764.0 → 3.772.0

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

@@ -181,6 +181,9 @@ export interface ActionGroupInvocationOutput {
 export declare const ActionGroupSignature: {
     readonly AMAZON_CODEINTERPRETER: "AMAZON.CodeInterpreter";
     readonly AMAZON_USERINPUT: "AMAZON.UserInput";
+    readonly ANTHROPIC_BASH: "ANTHROPIC.Bash";
+    readonly ANTHROPIC_COMPUTER: "ANTHROPIC.Computer";
+    readonly ANTHROPIC_TEXTEDITOR: "ANTHROPIC.TextEditor";
 };
 /**
  * @public
@@ -418,14 +421,41 @@ export interface AgentActionGroup {
      */
     description?: string | undefined;
     /**
-     * <p>
-     *             To allow your agent to request the user for additional information when trying to complete a task, set this field to <code>AMAZON.UserInput</code>.
-     *             You must leave the <code>description</code>, <code>apiSchema</code>, and <code>actionGroupExecutor</code> fields blank for this action group.
-     *         </p>
-     *          <p>To allow your agent to generate, run, and troubleshoot code when trying to complete a task, set this field to <code>AMAZON.CodeInterpreter</code>. You must
-     *             leave the <code>description</code>, <code>apiSchema</code>, and <code>actionGroupExecutor</code> fields blank for this action group.</p>
-     *          <p>During orchestration, if your agent determines that it needs to invoke an API in an action group, but doesn't have enough information to complete the API request,
-     *             it will invoke this action group instead and return an <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html">Observation</a> reprompting the user for more information.</p>
+     * <p>Specify a built-in or computer use action for this action group. If you specify a value, you must leave the <code>description</code>, <code>apiSchema</code>, and <code>actionGroupExecutor</code> fields empty for this action group. </p>
+     *          <ul>
+     *             <li>
+     *                <p>To allow your agent to request the user for additional information when trying to complete a task, set this field to <code>AMAZON.UserInput</code>. </p>
+     *             </li>
+     *             <li>
+     *                <p>To allow your agent to generate, run, and troubleshoot code when trying to complete a task, set this field to <code>AMAZON.CodeInterpreter</code>.</p>
+     *             </li>
+     *             <li>
+     *                <p>To allow your agent to use an Anthropic computer use tool, specify one of the following values. </p>
+     *                <important>
+     *                   <p>
+     *             Computer use is a new Anthropic Claude model capability (in beta) available with Anthropic Claude 3.7 Sonnet and Claude 3.5 Sonnet v2 only.
+     *             When operating computer use functionality, we recommend taking additional security precautions,
+     *             such as executing computer actions in virtual environments with restricted data access and limited internet connectivity.
+     *              For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agent-computer-use.html">Configure an Amazon Bedrock Agent to complete tasks with computer use tools</a>.
+     *           </p>
+     *                </important>
+     *                <ul>
+     *                   <li>
+     *                      <p>
+     *                         <code>ANTHROPIC.Computer</code> - Gives the agent permission to use the mouse and keyboard and
+     *               take screenshots.</p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <code>ANTHROPIC.TextEditor</code> - Gives the agent permission to view, create and edit files.</p>
+     *                   </li>
+     *                   <li>
+     *                      <p>
+     *                         <code>ANTHROPIC.Bash</code> - Gives the agent permission to run commands in a bash shell.</p>
+     *                   </li>
+     *                </ul>
+     *             </li>
+     *          </ul>
      * @public
      */
     parentActionGroupSignature?: ActionGroupSignature | undefined;
@@ -452,6 +482,16 @@ export interface AgentActionGroup {
      * @public
      */
     functionSchema?: FunctionSchema | undefined;
+    /**
+     * <p>
+     *             The configuration settings for a computer use action.
+     *         </p>
+     *          <important>
+     *             <p>Computer use is a new Anthropic Claude model capability (in beta) available with Claude 3.7 Sonnet and Claude 3.5 Sonnet v2 only. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agent-computer-use.html">Configure an Amazon Bedrock Agent to complete tasks with computer use tools</a>.</p>
+     *          </important>
+     * @public
+     */
+    parentActionGroupSignatureParams?: Record<string, string> | undefined;
 }
 /**
  * @public
@@ -478,6 +518,67 @@ export declare const ConfirmationState: {
  * @public
  */
 export type ConfirmationState = (typeof ConfirmationState)[keyof typeof ConfirmationState];
+/**
+ * @public
+ * @enum
+ */
+export declare const ImageInputFormat: {
+    readonly GIF: "gif";
+    readonly JPEG: "jpeg";
+    readonly PNG: "png";
+    readonly WEBP: "webp";
+};
+/**
+ * @public
+ */
+export type ImageInputFormat = (typeof ImageInputFormat)[keyof typeof ImageInputFormat];
+/**
+ * <p>Details about the source of an input image in the result from a function in the action group invocation.</p>
+ * @public
+ */
+export type ImageInputSource = ImageInputSource.BytesMember | ImageInputSource.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace ImageInputSource {
+    /**
+     * <p> The raw image bytes for the image. If you use an Amazon Web Services SDK, you don't need to encode the image bytes in base64.</p>
+     * @public
+     */
+    interface BytesMember {
+        bytes: Uint8Array;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        bytes?: never;
+        $unknown: [string, any];
+    }
+    interface Visitor<T> {
+        bytes: (value: Uint8Array) => T;
+        _: (name: string, value: any) => T;
+    }
+    const visit: <T>(value: ImageInputSource, visitor: Visitor<T>) => T;
+}
+/**
+ * <p>Details about an image in the result from a function in the action group invocation. You can specify images only when the function
+ *       is a computer use action. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agent-computer-use.html">Configure an Amazon Bedrock Agent to complete tasks with computer use tools</a>.</p>
+ * @public
+ */
+export interface ImageInput {
+    /**
+     * <p>The type of image in the result.</p>
+     * @public
+     */
+    format: ImageInputFormat | undefined;
+    /**
+     * <p>The source of the image in the result.</p>
+     * @public
+     */
+    source: ImageInputSource | undefined;
+}
 /**
  * <p>Contains the body of the API response.</p>
  *          <p>This data type is used in the following API operations:</p>
@@ -495,6 +596,14 @@ export interface ContentBody {
      * @public
      */
     body?: string | undefined;
+    /**
+     * <p>Lists details, including format and source, for the image in the response from the function call. You can specify only one image and the function in the <code>returnControlInvocationResults</code>
+     *       must be a computer use action.
+     *       For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agent-computer-use.html">Configure an Amazon Bedrock Agent to complete tasks with computer use tools</a>.
+     *     </p>
+     * @public
+     */
+    images?: ImageInput[] | undefined;
 }
 /**
  * @public
@@ -589,7 +698,10 @@ export interface FunctionResult {
      */
     function?: string | undefined;
     /**
-     * <p>The response from the function call using the parameters. The key of the object is the content type (currently, only <code>TEXT</code> is supported). The response may be returned directly or from the Lambda function.</p>
+     * <p>The response from the function call using the parameters. The response might be returned directly or from the Lambda function.
+     *       Specify <code>TEXT</code> or <code>IMAGES</code>. The key of the object is the content type. You can only specify one type. If you
+     *       specify <code>IMAGES</code>, you can specify only one image. You can specify images only when the function in the <code>returnControlInvocationResults</code>
+     *       is a computer use action. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agent-computer-use.html">Configure an Amazon Bedrock Agent to complete tasks with computer use tools</a>.</p>
      * @public
      */
     responseBody?: Record<string, ContentBody> | undefined;
@@ -7746,41 +7858,6 @@ export interface UpdateSessionResponse {
      */
     lastUpdatedAt: Date | undefined;
 }
-/**
- * @public
- */
-export interface ListTagsForResourceRequest {
-    /**
-     * <p>The Amazon Resource Name (ARN) of the resource for which to list tags.</p>
-     * @public
-     */
-    resourceArn: string | undefined;
-}
-/**
- * @public
- */
-export interface ListTagsForResourceResponse {
-    /**
-     * <p>The key-value pairs for the tags associated with the resource.</p>
-     * @public
-     */
-    tags?: Record<string, string> | undefined;
-}
-/**
- * @public
- */
-export interface TagResourceRequest {
-    /**
-     * <p>The Amazon Resource Name (ARN) of the resource to tag.</p>
-     * @public
-     */
-    resourceArn: string | undefined;
-    /**
-     * <p>An object containing key-value pairs that define the tags to attach to the resource.</p>
-     * @public
-     */
-    tags: Record<string, string> | undefined;
-}
 /**
  * @internal
  */

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

@@ -1,4 +1,39 @@
 import { AgentActionGroup, AgentCollaboration, BedrockModelConfigurations, CollaboratorConfiguration, ConversationHistory, ExternalSourcesRetrieveAndGenerateConfiguration, FilterAttribute, GenerationConfiguration, GuardrailConfiguration, GuardrailConfigurationWithArn, ImplicitFilterConfiguration, InlineBedrockModelConfigurations, InlineSessionState, InputFile, InvocationResultMember, KnowledgeBaseQuery, OrchestrationConfiguration, PromptOverrideConfiguration, RetrieveAndGenerateInput, RetrieveAndGenerateSessionConfiguration, RetrieveAndGenerateType, SearchType, StreamingConfigurations, VectorSearchRerankingConfiguration } from "./models_0";
+/**
+ * @public
+ */
+export interface ListTagsForResourceRequest {
+    /**
+     * <p>The Amazon Resource Name (ARN) of the resource for which to list tags.</p>
+     * @public
+     */
+    resourceArn: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ListTagsForResourceResponse {
+    /**
+     * <p>The key-value pairs for the tags associated with the resource.</p>
+     * @public
+     */
+    tags?: Record<string, string> | undefined;
+}
+/**
+ * @public
+ */
+export interface TagResourceRequest {
+    /**
+     * <p>The Amazon Resource Name (ARN) of the resource to tag.</p>
+     * @public
+     */
+    resourceArn: string | undefined;
+    /**
+     * <p>An object containing key-value pairs that define the tags to attach to the resource.</p>
+     * @public
+     */
+    tags: Record<string, string> | undefined;
+}
 /**
  * @public
  */
@@ -69,7 +104,16 @@ export declare namespace RetrievalFilter {
         $unknown?: never;
     }
     /**
-     * <p>Knowledge base data sources that contain a metadata attribute whose name matches the <code>key</code> and whose value doesn't match the <code>value</code> in this object are returned.</p>
+     * <p>Knowledge base data sources are returned when:</p>
+     *          <ul>
+     *             <li>
+     *                <p>It contains a metadata attribute whose name matches the <code>key</code> and whose value doesn't match the <code>value</code>
+     *                     in this object.</p>
+     *             </li>
+     *             <li>
+     *                <p>The key is not present in the document.</p>
+     *             </li>
+     *          </ul>
      *          <p>The following example would return data sources that don't contain an <code>animal</code> attribute whose value is <code>cat</code>.</p>
      *          <p>
      *             <code>"notEquals": \{ "key": "animal", "value": "cat" \}</code>
@@ -590,7 +634,9 @@ export interface RetrieveRequest {
 export interface RetrieveAndGenerateConfiguration {
     /**
      * <p>The type of resource that contains your data for retrieving information and generating responses.</p>
-     *          <p>If you choose to use <code>EXTERNAL_SOURCES</code>, then currently only Anthropic Claude 3 Sonnet models for knowledge bases are supported.</p>
+     *          <note>
+     *             <p>If you choose to use <code>EXTERNAL_SOURCES</code>, then currently only Anthropic Claude 3 Sonnet models for knowledge bases are supported.</p>
+     *          </note>
      * @public
      */
     type: RetrieveAndGenerateType | undefined;
@@ -747,12 +793,20 @@ export interface RetrieveAndGenerateStreamRequest {
  */
 export interface SessionState {
     /**
-     * <p>Contains attributes that persist across a session and the values of those attributes.</p>
+     * <p>Contains attributes that persist across a session and the values of those attributes. If <code>sessionAttributes</code> are passed to a supervisor agent in <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-multi-agent-collaboration.html">multi-agent collaboration</a>, it will be forwarded to all agent collaborators.</p>
      * @public
      */
     sessionAttributes?: Record<string, string> | undefined;
     /**
-     * <p>Contains attributes that persist across a prompt and the values of those attributes. These attributes replace the $prompt_session_attributes$ placeholder variable in the orchestration prompt template. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-placeholders.html">Prompt template placeholder variables</a>.</p>
+     * <p>Contains attributes that persist across a prompt and the values of those attributes. </p>
+     *          <ul>
+     *             <li>
+     *                <p>In orchestration prompt template, these attributes replace the $prompt_session_attributes$ placeholder variable.  For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-placeholders.html">Prompt template placeholder variables</a>.</p>
+     *             </li>
+     *             <li>
+     *                <p>In <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-multi-agent-collaboration.html">multi-agent collaboration</a>, the <code>promptSessionAttributes</code> will only be used by supervisor agent when $prompt_session_attributes$ is present in prompt template. </p>
+     *             </li>
+     *          </ul>
      * @public
      */
     promptSessionAttributes?: Record<string, string> | undefined;

package/dist-types/ts3.4/commands/ListTagsForResourceCommand.d.ts

@@ -8,7 +8,7 @@ import {
 import {
   ListTagsForResourceRequest,
   ListTagsForResourceResponse,
-} from "../models/models_0";
+} from "../models/models_1";
 export { __MetadataBearer };
 export { $Command };
 export interface ListTagsForResourceCommandInput

package/dist-types/ts3.4/commands/TagResourceCommand.d.ts

@@ -5,8 +5,7 @@ import {
   ServiceInputTypes,
   ServiceOutputTypes,
 } from "../BedrockAgentRuntimeClient";
-import { TagResourceRequest } from "../models/models_0";
-import { TagResourceResponse } from "../models/models_1";
+import { TagResourceRequest, TagResourceResponse } from "../models/models_1";
 export { __MetadataBearer };
 export { $Command };
 export interface TagResourceCommandInput extends TagResourceRequest {}

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

@@ -69,6 +69,9 @@ export interface ActionGroupInvocationOutput {
 export declare const ActionGroupSignature: {
   readonly AMAZON_CODEINTERPRETER: "AMAZON.CodeInterpreter";
   readonly AMAZON_USERINPUT: "AMAZON.UserInput";
+  readonly ANTHROPIC_BASH: "ANTHROPIC.Bash";
+  readonly ANTHROPIC_COMPUTER: "ANTHROPIC.Computer";
+  readonly ANTHROPIC_TEXTEDITOR: "ANTHROPIC.TextEditor";
 };
 export type ActionGroupSignature =
   (typeof ActionGroupSignature)[keyof typeof ActionGroupSignature];
@@ -160,6 +163,7 @@ export interface AgentActionGroup {
   actionGroupExecutor?: ActionGroupExecutor | undefined;
   apiSchema?: APISchema | undefined;
   functionSchema?: FunctionSchema | undefined;
+  parentActionGroupSignatureParams?: Record<string, string> | undefined;
 }
 export declare const AgentCollaboration: {
   readonly DISABLED: "DISABLED";
@@ -174,8 +178,39 @@ export declare const ConfirmationState: {
 };
 export type ConfirmationState =
   (typeof ConfirmationState)[keyof typeof ConfirmationState];
+export declare const ImageInputFormat: {
+  readonly GIF: "gif";
+  readonly JPEG: "jpeg";
+  readonly PNG: "png";
+  readonly WEBP: "webp";
+};
+export type ImageInputFormat =
+  (typeof ImageInputFormat)[keyof typeof ImageInputFormat];
+export type ImageInputSource =
+  | ImageInputSource.BytesMember
+  | ImageInputSource.$UnknownMember;
+export declare namespace ImageInputSource {
+  interface BytesMember {
+    bytes: Uint8Array;
+    $unknown?: never;
+  }
+  interface $UnknownMember {
+    bytes?: never;
+    $unknown: [string, any];
+  }
+  interface Visitor<T> {
+    bytes: (value: Uint8Array) => T;
+    _: (name: string, value: any) => T;
+  }
+  const visit: <T>(value: ImageInputSource, visitor: Visitor<T>) => T;
+}
+export interface ImageInput {
+  format: ImageInputFormat | undefined;
+  source: ImageInputSource | undefined;
+}
 export interface ContentBody {
   body?: string | undefined;
+  images?: ImageInput[] | undefined;
 }
 export declare const ResponseState: {
   readonly FAILURE: "FAILURE";
@@ -3291,16 +3326,6 @@ export interface UpdateSessionResponse {
   createdAt: Date | undefined;
   lastUpdatedAt: Date | undefined;
 }
-export interface ListTagsForResourceRequest {
-  resourceArn: string | undefined;
-}
-export interface ListTagsForResourceResponse {
-  tags?: Record<string, string> | undefined;
-}
-export interface TagResourceRequest {
-  resourceArn: string | undefined;
-  tags: Record<string, string> | undefined;
-}
 export declare const ActionGroupInvocationInputFilterSensitiveLog: (
   obj: ActionGroupInvocationInput
 ) => any;

package/dist-types/ts3.4/models/models_1.d.ts

@@ -24,6 +24,16 @@ import {
   StreamingConfigurations,
   VectorSearchRerankingConfiguration,
 } from "./models_0";
+export interface ListTagsForResourceRequest {
+  resourceArn: string | undefined;
+}
+export interface ListTagsForResourceResponse {
+  tags?: Record<string, string> | undefined;
+}
+export interface TagResourceRequest {
+  resourceArn: string | undefined;
+  tags: Record<string, string> | undefined;
+}
 export interface TagResourceResponse {}
 export interface UntagResourceRequest {
   resourceArn: string | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-bedrock-agent-runtime",
   "description": "AWS SDK for JavaScript Bedrock Agent Runtime Client for Node.js, Browser and React Native",
-  "version": "3.764.0",
+  "version": "3.772.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-bedrock-agent-runtime",
@@ -21,10 +21,10 @@
     "@aws-crypto/sha256-browser": "5.2.0",
     "@aws-crypto/sha256-js": "5.2.0",
     "@aws-sdk/core": "3.758.0",
-    "@aws-sdk/credential-provider-node": "3.758.0",
+    "@aws-sdk/credential-provider-node": "3.772.0",
     "@aws-sdk/middleware-host-header": "3.734.0",
     "@aws-sdk/middleware-logger": "3.734.0",
-    "@aws-sdk/middleware-recursion-detection": "3.734.0",
+    "@aws-sdk/middleware-recursion-detection": "3.772.0",
     "@aws-sdk/middleware-user-agent": "3.758.0",
     "@aws-sdk/region-config-resolver": "3.734.0",
     "@aws-sdk/types": "3.734.0",