@aws-sdk/client-devops-agent 3.1117.0 → 3.1118.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 (40) hide show
  1. package/README.md +7 -0
  2. package/dist-cjs/index.js +202 -104
  3. package/dist-es/DevOpsAgent.js +2 -0
  4. package/dist-es/commands/UpdateApprovalActionCommand.js +4 -0
  5. package/dist-es/commands/index.js +1 -0
  6. package/dist-es/models/enums.js +25 -3
  7. package/dist-es/schemas/schemas_0.js +163 -100
  8. package/dist-types/DevOpsAgent.d.ts +7 -0
  9. package/dist-types/DevOpsAgentClient.d.ts +3 -2
  10. package/dist-types/commands/AssociateServiceCommand.d.ts +60 -2
  11. package/dist-types/commands/CreateAgentSpaceCommand.d.ts +6 -0
  12. package/dist-types/commands/CreateBacklogTaskCommand.d.ts +1 -1
  13. package/dist-types/commands/CreatePrivateConnectionCommand.d.ts +3 -3
  14. package/dist-types/commands/GetAgentSpaceCommand.d.ts +3 -0
  15. package/dist-types/commands/GetAssociationCommand.d.ts +30 -1
  16. package/dist-types/commands/GetBacklogTaskCommand.d.ts +1 -1
  17. package/dist-types/commands/GetServiceCommand.d.ts +3 -1
  18. package/dist-types/commands/ListAgentSpacesCommand.d.ts +3 -0
  19. package/dist-types/commands/ListAssociationsCommand.d.ts +30 -1
  20. package/dist-types/commands/ListBacklogTasksCommand.d.ts +2 -2
  21. package/dist-types/commands/ListExecutionsCommand.d.ts +1 -1
  22. package/dist-types/commands/ListServicesCommand.d.ts +3 -1
  23. package/dist-types/commands/RegisterServiceCommand.d.ts +1 -1
  24. package/dist-types/commands/SendMessageCommand.d.ts +8 -0
  25. package/dist-types/commands/UpdateAgentSpaceCommand.d.ts +6 -0
  26. package/dist-types/commands/UpdateApprovalActionCommand.d.ts +111 -0
  27. package/dist-types/commands/UpdateAssociationCommand.d.ts +60 -2
  28. package/dist-types/commands/UpdateBacklogTaskCommand.d.ts +2 -2
  29. package/dist-types/commands/index.d.ts +1 -0
  30. package/dist-types/models/enums.d.ts +86 -11
  31. package/dist-types/models/models_0.d.ts +211 -7
  32. package/dist-types/schemas/schemas_0.d.ts +6 -0
  33. package/dist-types/ts3.4/DevOpsAgent.d.ts +17 -0
  34. package/dist-types/ts3.4/DevOpsAgentClient.d.ts +6 -0
  35. package/dist-types/ts3.4/commands/UpdateApprovalActionCommand.d.ts +39 -0
  36. package/dist-types/ts3.4/commands/index.d.ts +1 -0
  37. package/dist-types/ts3.4/models/enums.d.ts +31 -4
  38. package/dist-types/ts3.4/models/models_0.d.ts +50 -1
  39. package/dist-types/ts3.4/schemas/schemas_0.d.ts +6 -0
  40. package/package.json +1 -1
@@ -0,0 +1,111 @@
1
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
2
+ import type { UpdateApprovalActionRequest, UpdateApprovalActionResponse } from "../models/models_0";
3
+ /**
4
+ * @public
5
+ */
6
+ export type { __MetadataBearer };
7
+ /**
8
+ * @public
9
+ *
10
+ * The input for {@link UpdateApprovalActionCommand}.
11
+ */
12
+ export interface UpdateApprovalActionCommandInput extends UpdateApprovalActionRequest {
13
+ }
14
+ /**
15
+ * @public
16
+ *
17
+ * The output of {@link UpdateApprovalActionCommand}.
18
+ */
19
+ export interface UpdateApprovalActionCommandOutput extends UpdateApprovalActionResponse, __MetadataBearer {
20
+ }
21
+ declare const UpdateApprovalActionCommand_base: {
22
+ new (input: UpdateApprovalActionCommandInput): import("@smithy/core/client").CommandImpl<UpdateApprovalActionCommandInput, UpdateApprovalActionCommandOutput, import("..").DevOpsAgentClientResolvedConfig, import("..").ServiceInputTypes, import("..").ServiceOutputTypes>;
23
+ new (input: UpdateApprovalActionCommandInput): import("@smithy/core/client").CommandImpl<UpdateApprovalActionCommandInput, UpdateApprovalActionCommandOutput, import("..").DevOpsAgentClientResolvedConfig, import("..").ServiceInputTypes, import("..").ServiceOutputTypes>;
24
+ getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
25
+ };
26
+ /**
27
+ * <p>Updates an approval request with the terminal decision (APPROVED or REJECTED). A single operation handles both verbs via the action enum.</p>
28
+ * @example
29
+ * Use a bare-bones client and the command you need to make an API call.
30
+ * ```javascript
31
+ * import { DevOpsAgentClient, UpdateApprovalActionCommand } from "@aws-sdk/client-devops-agent"; // ES Modules import
32
+ * // const { DevOpsAgentClient, UpdateApprovalActionCommand } = require("@aws-sdk/client-devops-agent"); // CommonJS import
33
+ * // import type { DevOpsAgentClientConfig } from "@aws-sdk/client-devops-agent";
34
+ * const config = {}; // type is DevOpsAgentClientConfig
35
+ * const client = new DevOpsAgentClient(config);
36
+ * const input = { // UpdateApprovalActionRequest
37
+ * agentSpaceId: "STRING_VALUE", // required
38
+ * approvalId: "STRING_VALUE", // required
39
+ * action: "APPROVED" || "REJECTED", // required
40
+ * finalPattern: { // ApprovalPattern
41
+ * tool: "STRING_VALUE", // required
42
+ * argumentPins: { // ApprovalArgumentPins // required
43
+ * "<keys>": "STRING_VALUE",
44
+ * },
45
+ * },
46
+ * reason: "STRING_VALUE",
47
+ * ttlSeconds: Number("int"),
48
+ * singleUse: true || false,
49
+ * };
50
+ * const command = new UpdateApprovalActionCommand(input);
51
+ * const response = await client.send(command);
52
+ * // { // UpdateApprovalActionResponse
53
+ * // approvalId: "STRING_VALUE", // required
54
+ * // status: "PENDING" || "APPROVED" || "REJECTED" || "REVOKED" || "REDEEMED", // required
55
+ * // expiresAt: new Date("TIMESTAMP"),
56
+ * // };
57
+ *
58
+ * ```
59
+ *
60
+ * @param UpdateApprovalActionCommandInput - {@link UpdateApprovalActionCommandInput}
61
+ * @returns {@link UpdateApprovalActionCommandOutput}
62
+ * @see {@link UpdateApprovalActionCommandInput} for command's `input` shape.
63
+ * @see {@link UpdateApprovalActionCommandOutput} for command's `response` shape.
64
+ * @see {@link DevOpsAgentClientResolvedConfig | config} for DevOpsAgentClient's `config` shape.
65
+ *
66
+ * @throws {@link AccessDeniedException} (client fault)
67
+ * <p>Access to the requested resource is denied due to insufficient permissions.</p>
68
+ *
69
+ * @throws {@link ConflictException} (client fault)
70
+ * <p>The request conflicts with the current state of the resource.</p>
71
+ *
72
+ * @throws {@link InternalServerException} (server fault)
73
+ * <p>This exception is thrown when an unexpected error occurs in the processing of a request.</p>
74
+ *
75
+ * @throws {@link ResourceNotFoundException} (client fault)
76
+ * <p>The requested resource could not be found.</p>
77
+ *
78
+ * @throws {@link ServiceQuotaExceededException} (client fault)
79
+ * <p>The request would exceed the service quota limit.</p>
80
+ *
81
+ * @throws {@link ThrottlingException} (client fault)
82
+ * <p>The request was throttled due to too many requests. Please slow down and try again.</p>
83
+ *
84
+ * @throws {@link ValidationException} (client fault)
85
+ * <p>The input fails to satisfy the constraints specified by the service.</p>
86
+ *
87
+ * @throws {@link ContentSizeExceededException} (client fault)
88
+ * <p>This exception is thrown when the content size exceeds the allowed limit.</p>
89
+ *
90
+ * @throws {@link InvalidParameterException} (client fault)
91
+ * <p>One or more parameters provided in the request are invalid.</p>
92
+ *
93
+ * @throws {@link DevOpsAgentServiceException}
94
+ * <p>Base exception class for all service exceptions from DevOpsAgent service.</p>
95
+ *
96
+ *
97
+ * @public
98
+ */
99
+ export declare class UpdateApprovalActionCommand extends UpdateApprovalActionCommand_base {
100
+ /** @internal type navigation helper, not in runtime. */
101
+ protected static __types: {
102
+ api: {
103
+ input: UpdateApprovalActionRequest;
104
+ output: UpdateApprovalActionResponse;
105
+ };
106
+ sdk: {
107
+ input: UpdateApprovalActionCommandInput;
108
+ output: UpdateApprovalActionCommandOutput;
109
+ };
110
+ };
111
+ }
@@ -42,11 +42,15 @@ declare const UpdateAssociationCommand_base: {
42
42
  * accountType: "source", // required
43
43
  * assumableRoleArn: "STRING_VALUE", // required
44
44
  * externalId: "STRING_VALUE",
45
+ * agentElevatedRoleArn: "STRING_VALUE",
46
+ * agentElevatedRoleArnStatus: "valid" || "invalid" || "pending-confirmation",
45
47
  * },
46
48
  * aws: { // AWSConfiguration
47
49
  * assumableRoleArn: "STRING_VALUE", // required
48
50
  * accountId: "STRING_VALUE", // required
49
51
  * accountType: "monitor", // required
52
+ * agentElevatedRoleArn: "STRING_VALUE",
53
+ * agentElevatedRoleArnStatus: "valid" || "invalid" || "pending-confirmation",
50
54
  * },
51
55
  * github: { // GitHubConfiguration
52
56
  * repoName: "STRING_VALUE", // required
@@ -86,11 +90,24 @@ declare const UpdateAssociationCommand_base: {
86
90
  * accountId: "STRING_VALUE", // required
87
91
  * endpoint: "STRING_VALUE", // required
88
92
  * },
89
- * mcpserverdatadog: {},
93
+ * mcpserverdatadog: { // MCPServerDatadogConfiguration
94
+ * enabledElevatedTools: [ // MCPToolDetailsList
95
+ * { // MCPToolDetail
96
+ * name: "STRING_VALUE", // required
97
+ * toolClassification: "READ_ONLY" || "MUTATIVE" || "DESTRUCTIVE",
98
+ * },
99
+ * ],
100
+ * },
90
101
  * mcpserver: { // MCPServerConfiguration
91
102
  * tools: [ // MCPToolsList // required
92
103
  * "STRING_VALUE",
93
104
  * ],
105
+ * toolDetails: [
106
+ * {
107
+ * name: "STRING_VALUE", // required
108
+ * toolClassification: "READ_ONLY" || "MUTATIVE" || "DESTRUCTIVE",
109
+ * },
110
+ * ],
94
111
  * },
95
112
  * gitlab: { // GitLabConfiguration
96
113
  * projectId: "STRING_VALUE", // required
@@ -114,6 +131,12 @@ declare const UpdateAssociationCommand_base: {
114
131
  * tools: [
115
132
  * "STRING_VALUE",
116
133
  * ],
134
+ * enabledElevatedTools: [
135
+ * {
136
+ * name: "STRING_VALUE", // required
137
+ * toolClassification: "READ_ONLY" || "MUTATIVE" || "DESTRUCTIVE",
138
+ * },
139
+ * ],
117
140
  * },
118
141
  * pagerduty: { // PagerDutyConfiguration
119
142
  * services: [ // PagerDutyServicesList // required
@@ -125,6 +148,12 @@ declare const UpdateAssociationCommand_base: {
125
148
  * tools: [ // required
126
149
  * "STRING_VALUE",
127
150
  * ],
151
+ * toolDetails: [
152
+ * {
153
+ * name: "STRING_VALUE", // required
154
+ * toolClassification: "READ_ONLY" || "MUTATIVE" || "DESTRUCTIVE",
155
+ * },
156
+ * ],
128
157
  * },
129
158
  * remoteagent: {},
130
159
  * remoteagentsigv4: {},
@@ -151,11 +180,15 @@ declare const UpdateAssociationCommand_base: {
151
180
  * // accountType: "source", // required
152
181
  * // assumableRoleArn: "STRING_VALUE", // required
153
182
  * // externalId: "STRING_VALUE",
183
+ * // agentElevatedRoleArn: "STRING_VALUE",
184
+ * // agentElevatedRoleArnStatus: "valid" || "invalid" || "pending-confirmation",
154
185
  * // },
155
186
  * // aws: { // AWSConfiguration
156
187
  * // assumableRoleArn: "STRING_VALUE", // required
157
188
  * // accountId: "STRING_VALUE", // required
158
189
  * // accountType: "monitor", // required
190
+ * // agentElevatedRoleArn: "STRING_VALUE",
191
+ * // agentElevatedRoleArnStatus: "valid" || "invalid" || "pending-confirmation",
159
192
  * // },
160
193
  * // github: { // GitHubConfiguration
161
194
  * // repoName: "STRING_VALUE", // required
@@ -195,11 +228,24 @@ declare const UpdateAssociationCommand_base: {
195
228
  * // accountId: "STRING_VALUE", // required
196
229
  * // endpoint: "STRING_VALUE", // required
197
230
  * // },
198
- * // mcpserverdatadog: {},
231
+ * // mcpserverdatadog: { // MCPServerDatadogConfiguration
232
+ * // enabledElevatedTools: [ // MCPToolDetailsList
233
+ * // { // MCPToolDetail
234
+ * // name: "STRING_VALUE", // required
235
+ * // toolClassification: "READ_ONLY" || "MUTATIVE" || "DESTRUCTIVE",
236
+ * // },
237
+ * // ],
238
+ * // },
199
239
  * // mcpserver: { // MCPServerConfiguration
200
240
  * // tools: [ // MCPToolsList // required
201
241
  * // "STRING_VALUE",
202
242
  * // ],
243
+ * // toolDetails: [
244
+ * // {
245
+ * // name: "STRING_VALUE", // required
246
+ * // toolClassification: "READ_ONLY" || "MUTATIVE" || "DESTRUCTIVE",
247
+ * // },
248
+ * // ],
203
249
  * // },
204
250
  * // gitlab: { // GitLabConfiguration
205
251
  * // projectId: "STRING_VALUE", // required
@@ -223,6 +269,12 @@ declare const UpdateAssociationCommand_base: {
223
269
  * // tools: [
224
270
  * // "STRING_VALUE",
225
271
  * // ],
272
+ * // enabledElevatedTools: [
273
+ * // {
274
+ * // name: "STRING_VALUE", // required
275
+ * // toolClassification: "READ_ONLY" || "MUTATIVE" || "DESTRUCTIVE",
276
+ * // },
277
+ * // ],
226
278
  * // },
227
279
  * // pagerduty: { // PagerDutyConfiguration
228
280
  * // services: [ // PagerDutyServicesList // required
@@ -234,6 +286,12 @@ declare const UpdateAssociationCommand_base: {
234
286
  * // tools: [ // required
235
287
  * // "STRING_VALUE",
236
288
  * // ],
289
+ * // toolDetails: [
290
+ * // {
291
+ * // name: "STRING_VALUE", // required
292
+ * // toolClassification: "READ_ONLY" || "MUTATIVE" || "DESTRUCTIVE",
293
+ * // },
294
+ * // ],
237
295
  * // },
238
296
  * // remoteagent: {},
239
297
  * // remoteagentsigv4: {},
@@ -36,7 +36,7 @@ declare const UpdateBacklogTaskCommand_base: {
36
36
  * const input = { // UpdateBacklogTaskRequest
37
37
  * agentSpaceId: "STRING_VALUE", // required
38
38
  * taskId: "STRING_VALUE", // required
39
- * taskStatus: "PENDING_TRIAGE" || "LINKED" || "PENDING_START" || "IN_PROGRESS" || "PENDING_CUSTOMER_APPROVAL" || "COMPLETED" || "FAILED" || "TIMED_OUT" || "CANCELED" || "SKIPPED",
39
+ * taskStatus: "PENDING_TRIAGE" || "LINKED" || "PENDING_START" || "IN_PROGRESS" || "PENDING_CUSTOMER_APPROVAL" || "COMPLETED" || "FAILED" || "TIMED_OUT" || "CANCELED" || "SKIPPED" || "WAITING",
40
40
  * clientToken: "STRING_VALUE",
41
41
  * };
42
42
  * const command = new UpdateBacklogTaskCommand(input);
@@ -57,7 +57,7 @@ declare const UpdateBacklogTaskCommand_base: {
57
57
  * // },
58
58
  * // taskType: "INVESTIGATION" || "EVALUATION" || "RELEASE_READINESS_REVIEW" || "RELEASE_TESTING", // required
59
59
  * // priority: "CRITICAL" || "HIGH" || "MEDIUM" || "LOW" || "MINIMAL", // required
60
- * // status: "PENDING_TRIAGE" || "LINKED" || "PENDING_START" || "IN_PROGRESS" || "PENDING_CUSTOMER_APPROVAL" || "COMPLETED" || "FAILED" || "TIMED_OUT" || "CANCELED" || "SKIPPED", // required
60
+ * // status: "PENDING_TRIAGE" || "LINKED" || "PENDING_START" || "IN_PROGRESS" || "PENDING_CUSTOMER_APPROVAL" || "COMPLETED" || "FAILED" || "TIMED_OUT" || "CANCELED" || "SKIPPED" || "WAITING", // required
61
61
  * // createdAt: new Date("TIMESTAMP"), // required
62
62
  * // updatedAt: new Date("TIMESTAMP"), // required
63
63
  * // version: Number("int"), // required
@@ -50,6 +50,7 @@ export * from "./SendMessageCommand";
50
50
  export * from "./TagResourceCommand";
51
51
  export * from "./UntagResourceCommand";
52
52
  export * from "./UpdateAgentSpaceCommand";
53
+ export * from "./UpdateApprovalActionCommand";
53
54
  export * from "./UpdateAssetCommand";
54
55
  export * from "./UpdateAssetFileCommand";
55
56
  export * from "./UpdateAssociationCommand";
@@ -69,6 +69,7 @@ export declare const NewRelicRegion: {
69
69
  * <p>EU region</p>
70
70
  */
71
71
  readonly EU: "EU";
72
+ readonly JP: "JP";
72
73
  /**
73
74
  * <p>US region</p>
74
75
  */
@@ -100,6 +101,17 @@ export declare const RemoteAgentAuthorizationMethod: {
100
101
  * @public
101
102
  */
102
103
  export type RemoteAgentAuthorizationMethod = (typeof RemoteAgentAuthorizationMethod)[keyof typeof RemoteAgentAuthorizationMethod];
104
+ /**
105
+ * @public
106
+ * @enum
107
+ */
108
+ export declare const AgentSpacePreferenceKey: {
109
+ readonly ELEVATED_ACTIONS_ENABLED: "elevatedActionsEnabled";
110
+ };
111
+ /**
112
+ * @public
113
+ */
114
+ export type AgentSpacePreferenceKey = (typeof AgentSpacePreferenceKey)[keyof typeof AgentSpacePreferenceKey];
103
115
  /**
104
116
  * @public
105
117
  * @enum
@@ -129,17 +141,6 @@ export declare const MonitorAccountType: {
129
141
  * @public
130
142
  */
131
143
  export type MonitorAccountType = (typeof MonitorAccountType)[keyof typeof MonitorAccountType];
132
- /**
133
- * @public
134
- * @enum
135
- */
136
- export declare const SourceAccountType: {
137
- readonly SOURCE: "source";
138
- };
139
- /**
140
- * @public
141
- */
142
- export type SourceAccountType = (typeof SourceAccountType)[keyof typeof SourceAccountType];
143
144
  /**
144
145
  * @public
145
146
  * @enum
@@ -162,6 +163,30 @@ export declare const ValidationStatus: {
162
163
  * @public
163
164
  */
164
165
  export type ValidationStatus = (typeof ValidationStatus)[keyof typeof ValidationStatus];
166
+ /**
167
+ * @public
168
+ * @enum
169
+ */
170
+ export declare const ToolClassification: {
171
+ readonly DESTRUCTIVE: "DESTRUCTIVE";
172
+ readonly MUTATIVE: "MUTATIVE";
173
+ readonly READ_ONLY: "READ_ONLY";
174
+ };
175
+ /**
176
+ * @public
177
+ */
178
+ export type ToolClassification = (typeof ToolClassification)[keyof typeof ToolClassification];
179
+ /**
180
+ * @public
181
+ * @enum
182
+ */
183
+ export declare const SourceAccountType: {
184
+ readonly SOURCE: "source";
185
+ };
186
+ /**
187
+ * @public
188
+ */
189
+ export type SourceAccountType = (typeof SourceAccountType)[keyof typeof SourceAccountType];
165
190
  /**
166
191
  * @public
167
192
  * @enum
@@ -210,6 +235,54 @@ export declare const AuthFlow: {
210
235
  * @public
211
236
  */
212
237
  export type AuthFlow = (typeof AuthFlow)[keyof typeof AuthFlow];
238
+ /**
239
+ * @public
240
+ * @enum
241
+ */
242
+ export declare const ApprovalActionType: {
243
+ /**
244
+ * <p>The agent's tool invocation is approved; finalPattern and ttlSeconds carry the finalized scope and lifetime.</p>
245
+ */
246
+ readonly APPROVED: "APPROVED";
247
+ /**
248
+ * <p>The agent's tool invocation is rejected; reason optionally carries a free-text rationale.</p>
249
+ */
250
+ readonly REJECTED: "REJECTED";
251
+ };
252
+ /**
253
+ * @public
254
+ */
255
+ export type ApprovalActionType = (typeof ApprovalActionType)[keyof typeof ApprovalActionType];
256
+ /**
257
+ * @public
258
+ * @enum
259
+ */
260
+ export declare const ApprovalStatus: {
261
+ /**
262
+ * <p>The action was APPROVED; the approval request is live and may be redeemed via a credential mint until it is revoked or fully redeemed.</p>
263
+ */
264
+ readonly APPROVED: "APPROVED";
265
+ /**
266
+ * <p>The approval request is awaiting a decision.</p>
267
+ */
268
+ readonly PENDING: "PENDING";
269
+ /**
270
+ * <p>The approval was consumed by a credential mint at least once. Non-single-use approvals stay re-redeemable until expiry; single-use approvals are terminal.</p>
271
+ */
272
+ readonly REDEEMED: "REDEEMED";
273
+ /**
274
+ * <p>The action was REJECTED; no further redemption is possible.</p>
275
+ */
276
+ readonly REJECTED: "REJECTED";
277
+ /**
278
+ * <p>The approval was administratively invalidated; no further redemption is possible.</p>
279
+ */
280
+ readonly REVOKED: "REVOKED";
281
+ };
282
+ /**
283
+ * @public
284
+ */
285
+ export type ApprovalStatus = (typeof ApprovalStatus)[keyof typeof ApprovalStatus];
213
286
  /**
214
287
  * @public
215
288
  * @enum
@@ -311,6 +384,7 @@ export declare const TaskStatus: {
311
384
  * <p>Task has exceeded its time limit</p>
312
385
  */
313
386
  readonly TIMED_OUT: "TIMED_OUT";
387
+ readonly WAITING: "WAITING";
314
388
  };
315
389
  /**
316
390
  * @public
@@ -513,6 +587,7 @@ export declare const ExecutionStatus: {
513
587
  * <p>Unlike in the case of user-initiated Cancelation, a customer won't be billed</p>
514
588
  */
515
589
  readonly TIMED_OUT: "TIMED_OUT";
590
+ readonly WAITING: "WAITING";
516
591
  };
517
592
  /**
518
593
  * @public