@aws-sdk/client-bedrock-agentcore-control 3.1000.0 → 3.1001.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/dist-cjs/index.js +7 -6
  2. package/dist-cjs/schemas/schemas_0.js +50 -28
  3. package/dist-es/models/enums.js +1 -0
  4. package/dist-es/schemas/schemas_0.js +44 -23
  5. package/dist-es/waiters/waitForPolicyActive.js +2 -2
  6. package/dist-es/waiters/waitForPolicyEngineActive.js +2 -2
  7. package/dist-es/waiters/waitForPolicyGenerationCompleted.js +2 -2
  8. package/dist-types/commands/CreateAgentRuntimeCommand.d.ts +1 -1
  9. package/dist-types/commands/CreatePolicyCommand.d.ts +8 -0
  10. package/dist-types/commands/CreatePolicyEngineCommand.d.ts +5 -0
  11. package/dist-types/commands/DeletePolicyCommand.d.ts +4 -0
  12. package/dist-types/commands/DeletePolicyEngineCommand.d.ts +1 -0
  13. package/dist-types/commands/GetAgentRuntimeCommand.d.ts +4 -1
  14. package/dist-types/commands/GetPolicyCommand.d.ts +4 -0
  15. package/dist-types/commands/GetPolicyEngineCommand.d.ts +1 -0
  16. package/dist-types/commands/ListPoliciesCommand.d.ts +4 -0
  17. package/dist-types/commands/ListPolicyEnginesCommand.d.ts +1 -0
  18. package/dist-types/commands/ListPolicyGenerationAssetsCommand.d.ts +4 -0
  19. package/dist-types/commands/ListPolicyGenerationsCommand.d.ts +1 -1
  20. package/dist-types/commands/UpdateAgentRuntimeCommand.d.ts +4 -1
  21. package/dist-types/commands/UpdatePolicyCommand.d.ts +11 -1
  22. package/dist-types/commands/UpdatePolicyEngineCommand.d.ts +4 -1
  23. package/dist-types/models/enums.d.ts +1 -0
  24. package/dist-types/models/models_0.d.ts +97 -93
  25. package/dist-types/models/models_1.d.ts +94 -3
  26. package/dist-types/schemas/schemas_0.d.ts +3 -0
  27. package/dist-types/ts3.4/commands/ListPolicyGenerationsCommand.d.ts +1 -1
  28. package/dist-types/ts3.4/models/enums.d.ts +1 -0
  29. package/dist-types/ts3.4/models/models_0.d.ts +29 -22
  30. package/dist-types/ts3.4/models/models_1.d.ts +24 -2
  31. package/dist-types/ts3.4/schemas/schemas_0.d.ts +3 -0
  32. package/package.json +13 -13
@@ -83,7 +83,7 @@ declare const GetAgentRuntimeCommand_base: {
83
83
  * // versionId: "STRING_VALUE",
84
84
  * // },
85
85
  * // },
86
- * // runtime: "PYTHON_3_10" || "PYTHON_3_11" || "PYTHON_3_12" || "PYTHON_3_13", // required
86
+ * // runtime: "PYTHON_3_10" || "PYTHON_3_11" || "PYTHON_3_12" || "PYTHON_3_13" || "PYTHON_3_14", // required
87
87
  * // entryPoint: [ // EntryPoints // required
88
88
  * // "STRING_VALUE",
89
89
  * // ],
@@ -129,6 +129,9 @@ declare const GetAgentRuntimeCommand_base: {
129
129
  * // "STRING_VALUE",
130
130
  * // ],
131
131
  * // },
132
+ * // metadataConfiguration: { // RuntimeMetadataConfiguration
133
+ * // requireMMDSV2: true || false, // required
134
+ * // },
132
135
  * // };
133
136
  *
134
137
  * ```
@@ -50,6 +50,10 @@ declare const GetPolicyCommand_base: {
50
50
  * // cedar: { // CedarPolicy
51
51
  * // statement: "STRING_VALUE", // required
52
52
  * // },
53
+ * // policyGeneration: { // PolicyGenerationDetails
54
+ * // policyGenerationId: "STRING_VALUE", // required
55
+ * // policyGenerationAssetId: "STRING_VALUE", // required
56
+ * // },
53
57
  * // },
54
58
  * // description: "STRING_VALUE",
55
59
  * // createdAt: new Date("TIMESTAMP"), // required
@@ -52,6 +52,7 @@ declare const GetPolicyEngineCommand_base: {
52
52
  * // statusReasons: [ // PolicyStatusReasons // required
53
53
  * // "STRING_VALUE",
54
54
  * // ],
55
+ * // encryptionKeyArn: "STRING_VALUE",
55
56
  * // };
56
57
  *
57
58
  * ```
@@ -54,6 +54,10 @@ declare const ListPoliciesCommand_base: {
54
54
  * // cedar: { // CedarPolicy
55
55
  * // statement: "STRING_VALUE", // required
56
56
  * // },
57
+ * // policyGeneration: { // PolicyGenerationDetails
58
+ * // policyGenerationId: "STRING_VALUE", // required
59
+ * // policyGenerationAssetId: "STRING_VALUE", // required
60
+ * // },
57
61
  * // },
58
62
  * // description: "STRING_VALUE",
59
63
  * // createdAt: new Date("TIMESTAMP"), // required
@@ -55,6 +55,7 @@ declare const ListPolicyEnginesCommand_base: {
55
55
  * // statusReasons: [ // PolicyStatusReasons // required
56
56
  * // "STRING_VALUE",
57
57
  * // ],
58
+ * // encryptionKeyArn: "STRING_VALUE",
58
59
  * // },
59
60
  * // ],
60
61
  * // nextToken: "STRING_VALUE",
@@ -52,6 +52,10 @@ declare const ListPolicyGenerationAssetsCommand_base: {
52
52
  * // cedar: { // CedarPolicy
53
53
  * // statement: "STRING_VALUE", // required
54
54
  * // },
55
+ * // policyGeneration: { // PolicyGenerationDetails
56
+ * // policyGenerationId: "STRING_VALUE", // required
57
+ * // policyGenerationAssetId: "STRING_VALUE", // required
58
+ * // },
55
59
  * // },
56
60
  * // rawTextFragment: "STRING_VALUE", // required
57
61
  * // findings: [ // Findings // required
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/smithy-client";
2
2
  import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
3
  import type { BedrockAgentCoreControlClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../BedrockAgentCoreControlClient";
4
- import type { ListPolicyGenerationsRequest, ListPolicyGenerationsResponse } from "../models/models_0";
4
+ import type { ListPolicyGenerationsRequest, ListPolicyGenerationsResponse } from "../models/models_1";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -50,7 +50,7 @@ declare const UpdateAgentRuntimeCommand_base: {
50
50
  * versionId: "STRING_VALUE",
51
51
  * },
52
52
  * },
53
- * runtime: "PYTHON_3_10" || "PYTHON_3_11" || "PYTHON_3_12" || "PYTHON_3_13", // required
53
+ * runtime: "PYTHON_3_10" || "PYTHON_3_11" || "PYTHON_3_12" || "PYTHON_3_13" || "PYTHON_3_14", // required
54
54
  * entryPoint: [ // EntryPoints // required
55
55
  * "STRING_VALUE",
56
56
  * ],
@@ -110,6 +110,9 @@ declare const UpdateAgentRuntimeCommand_base: {
110
110
  * idleRuntimeSessionTimeout: Number("int"),
111
111
  * maxLifetime: Number("int"),
112
112
  * },
113
+ * metadataConfiguration: { // RuntimeMetadataConfiguration
114
+ * requireMMDSV2: true || false, // required
115
+ * },
113
116
  * environmentVariables: { // EnvironmentVariablesMap
114
117
  * "<keys>": "STRING_VALUE",
115
118
  * },
@@ -39,11 +39,17 @@ declare const UpdatePolicyCommand_base: {
39
39
  * const input = { // UpdatePolicyRequest
40
40
  * policyEngineId: "STRING_VALUE", // required
41
41
  * policyId: "STRING_VALUE", // required
42
- * description: "STRING_VALUE",
42
+ * description: { // UpdatedDescription
43
+ * optionalValue: "STRING_VALUE",
44
+ * },
43
45
  * definition: { // PolicyDefinition Union: only one key present
44
46
  * cedar: { // CedarPolicy
45
47
  * statement: "STRING_VALUE", // required
46
48
  * },
49
+ * policyGeneration: { // PolicyGenerationDetails
50
+ * policyGenerationId: "STRING_VALUE", // required
51
+ * policyGenerationAssetId: "STRING_VALUE", // required
52
+ * },
47
53
  * },
48
54
  * validationMode: "FAIL_ON_ANY_FINDINGS" || "IGNORE_ALL_FINDINGS",
49
55
  * };
@@ -57,6 +63,10 @@ declare const UpdatePolicyCommand_base: {
57
63
  * // cedar: { // CedarPolicy
58
64
  * // statement: "STRING_VALUE", // required
59
65
  * // },
66
+ * // policyGeneration: { // PolicyGenerationDetails
67
+ * // policyGenerationId: "STRING_VALUE", // required
68
+ * // policyGenerationAssetId: "STRING_VALUE", // required
69
+ * // },
60
70
  * // },
61
71
  * // description: "STRING_VALUE",
62
72
  * // createdAt: new Date("TIMESTAMP"), // required
@@ -38,7 +38,9 @@ declare const UpdatePolicyEngineCommand_base: {
38
38
  * const client = new BedrockAgentCoreControlClient(config);
39
39
  * const input = { // UpdatePolicyEngineRequest
40
40
  * policyEngineId: "STRING_VALUE", // required
41
- * description: "STRING_VALUE",
41
+ * description: { // UpdatedDescription
42
+ * optionalValue: "STRING_VALUE",
43
+ * },
42
44
  * };
43
45
  * const command = new UpdatePolicyEngineCommand(input);
44
46
  * const response = await client.send(command);
@@ -53,6 +55,7 @@ declare const UpdatePolicyEngineCommand_base: {
53
55
  * // statusReasons: [ // PolicyStatusReasons // required
54
56
  * // "STRING_VALUE",
55
57
  * // ],
58
+ * // encryptionKeyArn: "STRING_VALUE",
56
59
  * // };
57
60
  *
58
61
  * ```
@@ -38,6 +38,7 @@ export declare const AgentManagedRuntimeType: {
38
38
  readonly PYTHON_3_11: "PYTHON_3_11";
39
39
  readonly PYTHON_3_12: "PYTHON_3_12";
40
40
  readonly PYTHON_3_13: "PYTHON_3_13";
41
+ readonly PYTHON_3_14: "PYTHON_3_14";
41
42
  };
42
43
  /**
43
44
  * @public
@@ -892,6 +892,17 @@ export interface GetAgentRuntimeRequest {
892
892
  */
893
893
  agentRuntimeVersion?: string | undefined;
894
894
  }
895
+ /**
896
+ * <p>Configuration for microVM metadata service settings.</p>
897
+ * @public
898
+ */
899
+ export interface RuntimeMetadataConfiguration {
900
+ /**
901
+ * <p>Enables MMDSv2 (microVM Metadata Service Version 2) requirement for the agent runtime. When set to <code>true</code>, the runtime microVM will only accept MMDSv2 requests.</p>
902
+ * @public
903
+ */
904
+ requireMMDSV2: boolean | undefined;
905
+ }
895
906
  /**
896
907
  * @public
897
908
  */
@@ -986,6 +997,11 @@ export interface GetAgentRuntimeResponse {
986
997
  * @public
987
998
  */
988
999
  requestHeaderConfiguration?: RequestHeaderConfiguration | undefined;
1000
+ /**
1001
+ * <p>Configuration for microVM Metadata Service (MMDS) settings for the AgentCore Runtime.</p>
1002
+ * @public
1003
+ */
1004
+ metadataConfiguration?: RuntimeMetadataConfiguration | undefined;
989
1005
  }
990
1006
  /**
991
1007
  * @public
@@ -1142,6 +1158,11 @@ export interface UpdateAgentRuntimeRequest {
1142
1158
  * @public
1143
1159
  */
1144
1160
  lifecycleConfiguration?: LifecycleConfiguration | undefined;
1161
+ /**
1162
+ * <p>The updated configuration for microVM Metadata Service (MMDS) settings for the AgentCore Runtime.</p>
1163
+ * @public
1164
+ */
1165
+ metadataConfiguration?: RuntimeMetadataConfiguration | undefined;
1145
1166
  /**
1146
1167
  * <p>Updated environment variables to set in the AgentCore Runtime environment.</p>
1147
1168
  * @public
@@ -7523,6 +7544,16 @@ export interface CreatePolicyEngineRequest {
7523
7544
  * @public
7524
7545
  */
7525
7546
  clientToken?: string | undefined;
7547
+ /**
7548
+ * <p>The Amazon Resource Name (ARN) of the KMS key used to encrypt the policy engine data.</p>
7549
+ * @public
7550
+ */
7551
+ encryptionKeyArn?: string | undefined;
7552
+ /**
7553
+ * <p>A map of tag keys and values to assign to an AgentCore Policy. Tags enable you to categorize your resources in different ways, for example, by purpose, owner, or environment.</p>
7554
+ * @public
7555
+ */
7556
+ tags?: Record<string, string> | undefined;
7526
7557
  }
7527
7558
  /**
7528
7559
  * @public
@@ -7568,6 +7599,11 @@ export interface CreatePolicyEngineResponse {
7568
7599
  * @public
7569
7600
  */
7570
7601
  statusReasons: string[] | undefined;
7602
+ /**
7603
+ * <p>The Amazon Resource Name (ARN) of the KMS key used to encrypt the policy engine data.</p>
7604
+ * @public
7605
+ */
7606
+ encryptionKeyArn?: string | undefined;
7571
7607
  }
7572
7608
  /**
7573
7609
  * @public
@@ -7623,6 +7659,11 @@ export interface DeletePolicyEngineResponse {
7623
7659
  * @public
7624
7660
  */
7625
7661
  statusReasons: string[] | undefined;
7662
+ /**
7663
+ * <p>The Amazon Resource Name (ARN) of the KMS key used to encrypt the policy engine data.</p>
7664
+ * @public
7665
+ */
7666
+ encryptionKeyArn?: string | undefined;
7626
7667
  }
7627
7668
  /**
7628
7669
  * @public
@@ -7678,6 +7719,11 @@ export interface GetPolicyEngineResponse {
7678
7719
  * @public
7679
7720
  */
7680
7721
  statusReasons: string[] | undefined;
7722
+ /**
7723
+ * <p>The Amazon Resource Name (ARN) of the KMS key used to encrypt the policy engine data.</p>
7724
+ * @public
7725
+ */
7726
+ encryptionKeyArn?: string | undefined;
7681
7727
  }
7682
7728
  /**
7683
7729
  * @public
@@ -7739,6 +7785,11 @@ export interface PolicyEngine {
7739
7785
  * @public
7740
7786
  */
7741
7787
  statusReasons: string[] | undefined;
7788
+ /**
7789
+ * <p>The Amazon Resource Name (ARN) of the KMS key used to encrypt the policy engine data.</p>
7790
+ * @public
7791
+ */
7792
+ encryptionKeyArn?: string | undefined;
7742
7793
  }
7743
7794
  /**
7744
7795
  * @public
@@ -7755,6 +7806,17 @@ export interface ListPolicyEnginesResponse {
7755
7806
  */
7756
7807
  nextToken?: string | undefined;
7757
7808
  }
7809
+ /**
7810
+ * <p>Respresents an optional value that can be provided to update the human-readable description of the resource. If the field is omitted from the request, it will leave the current decription value unchanged.</p>
7811
+ * @public
7812
+ */
7813
+ export interface UpdatedDescription {
7814
+ /**
7815
+ * <p>Represents an optional value that is used to update the human-readable description of the resource. If set to null, it will clear the current description of the resource.</p>
7816
+ * @public
7817
+ */
7818
+ optionalValue?: string | undefined;
7819
+ }
7758
7820
  /**
7759
7821
  * @public
7760
7822
  */
@@ -7768,7 +7830,7 @@ export interface UpdatePolicyEngineRequest {
7768
7830
  * <p>The new description for the policy engine.</p>
7769
7831
  * @public
7770
7832
  */
7771
- description?: string | undefined;
7833
+ description?: UpdatedDescription | undefined;
7772
7834
  }
7773
7835
  /**
7774
7836
  * @public
@@ -7814,6 +7876,11 @@ export interface UpdatePolicyEngineResponse {
7814
7876
  * @public
7815
7877
  */
7816
7878
  statusReasons: string[] | undefined;
7879
+ /**
7880
+ * <p>The Amazon Resource Name (ARN) of the KMS key used to encrypt the policy engine data.</p>
7881
+ * @public
7882
+ */
7883
+ encryptionKeyArn?: string | undefined;
7817
7884
  }
7818
7885
  /**
7819
7886
  * @public
@@ -7954,11 +8021,27 @@ export interface CedarPolicy {
7954
8021
  */
7955
8022
  statement: string | undefined;
7956
8023
  }
8024
+ /**
8025
+ * <p>Represents the information identifying a generated policy asset from the AI-powered policy generation process within the AgentCore Policy system. Each asset contains a Cedar policy statement generated from natural language input, along with associated metadata and analysis findings to help users evaluate and select the most appropriate policy option.</p>
8026
+ * @public
8027
+ */
8028
+ export interface PolicyGenerationDetails {
8029
+ /**
8030
+ * <p>The unique identifier for this policy generation request.</p>
8031
+ * @public
8032
+ */
8033
+ policyGenerationId: string | undefined;
8034
+ /**
8035
+ * <p>The unique identifier for this generated policy asset within the policy generation request.</p>
8036
+ * @public
8037
+ */
8038
+ policyGenerationAssetId: string | undefined;
8039
+ }
7957
8040
  /**
7958
8041
  * <p>Represents the definition structure for policies within the AgentCore Policy system. This structure encapsulates different policy formats and languages that can be used to define access control rules.</p>
7959
8042
  * @public
7960
8043
  */
7961
- export type PolicyDefinition = PolicyDefinition.CedarMember | PolicyDefinition.$UnknownMember;
8044
+ export type PolicyDefinition = PolicyDefinition.CedarMember | PolicyDefinition.PolicyGenerationMember | PolicyDefinition.$UnknownMember;
7962
8045
  /**
7963
8046
  * @public
7964
8047
  */
@@ -7969,6 +8052,16 @@ export declare namespace PolicyDefinition {
7969
8052
  */
7970
8053
  interface CedarMember {
7971
8054
  cedar: CedarPolicy;
8055
+ policyGeneration?: never;
8056
+ $unknown?: never;
8057
+ }
8058
+ /**
8059
+ * <p>The generated policy asset information within the policy definition structure. This contains information identifying a generated policy asset from the AI-powered policy generation process within the AgentCore Policy system. Each asset contains a Cedar policy statement generated from natural language input, along with associated metadata and analysis findings to help users evaluate and select the most appropriate policy option.</p>
8060
+ * @public
8061
+ */
8062
+ interface PolicyGenerationMember {
8063
+ cedar?: never;
8064
+ policyGeneration: PolicyGenerationDetails;
7972
8065
  $unknown?: never;
7973
8066
  }
7974
8067
  /**
@@ -7976,6 +8069,7 @@ export declare namespace PolicyDefinition {
7976
8069
  */
7977
8070
  interface $UnknownMember {
7978
8071
  cedar?: never;
8072
+ policyGeneration?: never;
7979
8073
  $unknown: [string, any];
7980
8074
  }
7981
8075
  /**
@@ -7984,6 +8078,7 @@ export declare namespace PolicyDefinition {
7984
8078
  */
7985
8079
  interface Visitor<T> {
7986
8080
  cedar: (value: CedarPolicy) => T;
8081
+ policyGeneration: (value: PolicyGenerationDetails) => T;
7987
8082
  _: (name: string, value: any) => T;
7988
8083
  }
7989
8084
  }
@@ -8044,94 +8139,3 @@ export interface ListPolicyGenerationAssetsResponse {
8044
8139
  */
8045
8140
  nextToken?: string | undefined;
8046
8141
  }
8047
- /**
8048
- * @public
8049
- */
8050
- export interface ListPolicyGenerationsRequest {
8051
- /**
8052
- * <p>A pagination token for retrieving additional policy generations when results are paginated.</p>
8053
- * @public
8054
- */
8055
- nextToken?: string | undefined;
8056
- /**
8057
- * <p>The maximum number of policy generations to return in a single response.</p>
8058
- * @public
8059
- */
8060
- maxResults?: number | undefined;
8061
- /**
8062
- * <p>The identifier of the policy engine whose policy generations to retrieve.</p>
8063
- * @public
8064
- */
8065
- policyEngineId: string | undefined;
8066
- }
8067
- /**
8068
- * <p>Represents a policy generation request within the AgentCore Policy system. Tracks the AI-powered conversion of natural language descriptions into Cedar policy statements, enabling users to author policies by describing authorization requirements in plain English. The generation process analyzes the natural language input along with the Gateway's tool context and Cedar schema to produce one or more validated policy options. Each generation request tracks the status of the conversion process and maintains findings about the generated policies, including validation results and potential issues. Generated policy assets remain available for one week after successful generation, allowing time to review and create policies from the generated options.</p>
8069
- * @public
8070
- */
8071
- export interface PolicyGeneration {
8072
- /**
8073
- * <p>The identifier of the policy engine associated with this generation request.</p>
8074
- * @public
8075
- */
8076
- policyEngineId: string | undefined;
8077
- /**
8078
- * <p>The unique identifier for this policy generation request.</p>
8079
- * @public
8080
- */
8081
- policyGenerationId: string | undefined;
8082
- /**
8083
- * <p>The customer-assigned name for this policy generation request.</p>
8084
- * @public
8085
- */
8086
- name: string | undefined;
8087
- /**
8088
- * <p>The ARN of this policy generation request.</p>
8089
- * @public
8090
- */
8091
- policyGenerationArn: string | undefined;
8092
- /**
8093
- * <p>The resource information associated with this policy generation.</p>
8094
- * @public
8095
- */
8096
- resource: Resource | undefined;
8097
- /**
8098
- * <p>The timestamp when this policy generation request was created.</p>
8099
- * @public
8100
- */
8101
- createdAt: Date | undefined;
8102
- /**
8103
- * <p>The timestamp when this policy generation was last updated.</p>
8104
- * @public
8105
- */
8106
- updatedAt: Date | undefined;
8107
- /**
8108
- * <p>The current status of this policy generation request.</p>
8109
- * @public
8110
- */
8111
- status: PolicyGenerationStatus | undefined;
8112
- /**
8113
- * <p>Additional information about the generation status.</p>
8114
- * @public
8115
- */
8116
- statusReasons: string[] | undefined;
8117
- /**
8118
- * <p>Findings and insights from this policy generation process.</p>
8119
- * @public
8120
- */
8121
- findings?: string | undefined;
8122
- }
8123
- /**
8124
- * @public
8125
- */
8126
- export interface ListPolicyGenerationsResponse {
8127
- /**
8128
- * <p>An array of policy generation objects that match the specified criteria.</p>
8129
- * @public
8130
- */
8131
- policyGenerations: PolicyGeneration[] | undefined;
8132
- /**
8133
- * <p>A pagination token for retrieving additional policy generations if more results are available.</p>
8134
- * @public
8135
- */
8136
- nextToken?: string | undefined;
8137
- }
@@ -1,5 +1,96 @@
1
1
  import { PolicyGenerationStatus, PolicyStatus, PolicyValidationMode, SchemaType, TargetStatus } from "./enums";
2
- import { type KmsConfiguration, type MetadataConfiguration, type PolicyDefinition, type Resource, ApiGatewayTargetConfiguration, ApiSchemaConfiguration, CredentialProviderConfiguration, McpServerTargetConfiguration, S3Configuration } from "./models_0";
2
+ import { type KmsConfiguration, type MetadataConfiguration, type PolicyDefinition, type Resource, type UpdatedDescription, ApiGatewayTargetConfiguration, ApiSchemaConfiguration, CredentialProviderConfiguration, McpServerTargetConfiguration, S3Configuration } from "./models_0";
3
+ /**
4
+ * @public
5
+ */
6
+ export interface ListPolicyGenerationsRequest {
7
+ /**
8
+ * <p>A pagination token for retrieving additional policy generations when results are paginated.</p>
9
+ * @public
10
+ */
11
+ nextToken?: string | undefined;
12
+ /**
13
+ * <p>The maximum number of policy generations to return in a single response.</p>
14
+ * @public
15
+ */
16
+ maxResults?: number | undefined;
17
+ /**
18
+ * <p>The identifier of the policy engine whose policy generations to retrieve.</p>
19
+ * @public
20
+ */
21
+ policyEngineId: string | undefined;
22
+ }
23
+ /**
24
+ * <p>Represents a policy generation request within the AgentCore Policy system. Tracks the AI-powered conversion of natural language descriptions into Cedar policy statements, enabling users to author policies by describing authorization requirements in plain English. The generation process analyzes the natural language input along with the Gateway's tool context and Cedar schema to produce one or more validated policy options. Each generation request tracks the status of the conversion process and maintains findings about the generated policies, including validation results and potential issues. Generated policy assets remain available for one week after successful generation, allowing time to review and create policies from the generated options.</p>
25
+ * @public
26
+ */
27
+ export interface PolicyGeneration {
28
+ /**
29
+ * <p>The identifier of the policy engine associated with this generation request.</p>
30
+ * @public
31
+ */
32
+ policyEngineId: string | undefined;
33
+ /**
34
+ * <p>The unique identifier for this policy generation request.</p>
35
+ * @public
36
+ */
37
+ policyGenerationId: string | undefined;
38
+ /**
39
+ * <p>The customer-assigned name for this policy generation request.</p>
40
+ * @public
41
+ */
42
+ name: string | undefined;
43
+ /**
44
+ * <p>The ARN of this policy generation request.</p>
45
+ * @public
46
+ */
47
+ policyGenerationArn: string | undefined;
48
+ /**
49
+ * <p>The resource information associated with this policy generation.</p>
50
+ * @public
51
+ */
52
+ resource: Resource | undefined;
53
+ /**
54
+ * <p>The timestamp when this policy generation request was created.</p>
55
+ * @public
56
+ */
57
+ createdAt: Date | undefined;
58
+ /**
59
+ * <p>The timestamp when this policy generation was last updated.</p>
60
+ * @public
61
+ */
62
+ updatedAt: Date | undefined;
63
+ /**
64
+ * <p>The current status of this policy generation request.</p>
65
+ * @public
66
+ */
67
+ status: PolicyGenerationStatus | undefined;
68
+ /**
69
+ * <p>Additional information about the generation status.</p>
70
+ * @public
71
+ */
72
+ statusReasons: string[] | undefined;
73
+ /**
74
+ * <p>Findings and insights from this policy generation process.</p>
75
+ * @public
76
+ */
77
+ findings?: string | undefined;
78
+ }
79
+ /**
80
+ * @public
81
+ */
82
+ export interface ListPolicyGenerationsResponse {
83
+ /**
84
+ * <p>An array of policy generation objects that match the specified criteria.</p>
85
+ * @public
86
+ */
87
+ policyGenerations: PolicyGeneration[] | undefined;
88
+ /**
89
+ * <p>A pagination token for retrieving additional policy generations if more results are available.</p>
90
+ * @public
91
+ */
92
+ nextToken?: string | undefined;
93
+ }
3
94
  /**
4
95
  * <p>Represents content input for policy generation operations. This structure encapsulates the natural language descriptions or other content formats that are used as input for AI-powered policy generation.</p>
5
96
  * @public
@@ -462,12 +553,12 @@ export interface UpdatePolicyRequest {
462
553
  * <p>The new human-readable description for the policy. This optional field allows updating the policy's documentation while keeping the same policy logic.</p>
463
554
  * @public
464
555
  */
465
- description?: string | undefined;
556
+ description?: UpdatedDescription | undefined;
466
557
  /**
467
558
  * <p>The new Cedar policy statement that defines the access control rules. This replaces the existing policy definition with new logic while maintaining the policy's identity.</p>
468
559
  * @public
469
560
  */
470
- definition: PolicyDefinition | undefined;
561
+ definition?: PolicyDefinition | undefined;
471
562
  /**
472
563
  * <p>The validation mode for the policy update. Determines how Cedar analyzer validation results are handled during policy updates. FAIL_ON_ANY_FINDINGS runs the Cedar analyzer and fails the update if validation issues are detected, ensuring the policy conforms to the Cedar schema and tool context. IGNORE_ALL_FINDINGS runs the Cedar analyzer but allows updates despite validation warnings. Use FAIL_ON_ANY_FINDINGS to ensure policy correctness during updates, especially when modifying policy logic or conditions.</p>
473
564
  * @public
@@ -249,11 +249,13 @@ export declare var Policy$: StaticStructureSchema;
249
249
  export declare var PolicyEngine$: StaticStructureSchema;
250
250
  export declare var PolicyGeneration$: StaticStructureSchema;
251
251
  export declare var PolicyGenerationAsset$: StaticStructureSchema;
252
+ export declare var PolicyGenerationDetails$: StaticStructureSchema;
252
253
  export declare var ProtocolConfiguration$: StaticStructureSchema;
253
254
  export declare var PutResourcePolicyRequest$: StaticStructureSchema;
254
255
  export declare var PutResourcePolicyResponse$: StaticStructureSchema;
255
256
  export declare var RecordingConfig$: StaticStructureSchema;
256
257
  export declare var Rule$: StaticStructureSchema;
258
+ export declare var RuntimeMetadataConfiguration$: StaticStructureSchema;
257
259
  export declare var S3Configuration$: StaticStructureSchema;
258
260
  export declare var S3Location$: StaticStructureSchema;
259
261
  export declare var SalesforceOauth2ProviderConfigInput$: StaticStructureSchema;
@@ -299,6 +301,7 @@ export declare var UpdateAgentRuntimeRequest$: StaticStructureSchema;
299
301
  export declare var UpdateAgentRuntimeResponse$: StaticStructureSchema;
300
302
  export declare var UpdateApiKeyCredentialProviderRequest$: StaticStructureSchema;
301
303
  export declare var UpdateApiKeyCredentialProviderResponse$: StaticStructureSchema;
304
+ export declare var UpdatedDescription$: StaticStructureSchema;
302
305
  export declare var UpdateEvaluatorRequest$: StaticStructureSchema;
303
306
  export declare var UpdateEvaluatorResponse$: StaticStructureSchema;
304
307
  export declare var UpdateGatewayRequest$: StaticStructureSchema;
@@ -8,7 +8,7 @@ import {
8
8
  import {
9
9
  ListPolicyGenerationsRequest,
10
10
  ListPolicyGenerationsResponse,
11
- } from "../models/models_0";
11
+ } from "../models/models_1";
12
12
  export { __MetadataBearer };
13
13
  export { $Command };
14
14
  export interface ListPolicyGenerationsCommandInput
@@ -22,6 +22,7 @@ export declare const AgentManagedRuntimeType: {
22
22
  readonly PYTHON_3_11: "PYTHON_3_11";
23
23
  readonly PYTHON_3_12: "PYTHON_3_12";
24
24
  readonly PYTHON_3_13: "PYTHON_3_13";
25
+ readonly PYTHON_3_14: "PYTHON_3_14";
25
26
  };
26
27
  export type AgentManagedRuntimeType =
27
28
  (typeof AgentManagedRuntimeType)[keyof typeof AgentManagedRuntimeType];