@agentpress/sdk 0.4.12 → 0.4.14

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.
package/dist/index.d.cts CHANGED
@@ -44,7 +44,7 @@ interface PartnerMcpOptions {
44
44
  issuer: string;
45
45
  /** Exact match for the JWT `aud` claim — your partner MCP's stable URL. */
46
46
  audience: string;
47
- /** Required value for the `ext_provider` claim, e.g. `"localfalcon"`. */
47
+ /** Required value for the `ext_provider` claim, e.g. `"partner_auth"`. */
48
48
  expectedExtProvider: string;
49
49
  /**
50
50
  * Clock skew tolerance for `iat` / `exp` validation. Accepts a jose duration
@@ -240,6 +240,16 @@ interface ActionCallbackPayload {
240
240
  agentResponse: AgentResponse;
241
241
  /** Error message if the action failed. */
242
242
  errorMessage: string | null;
243
+ /**
244
+ * Structured error metadata for clients that need branching/logging without
245
+ * displaying raw provider errors.
246
+ */
247
+ errorDetails: {
248
+ code: string | null;
249
+ provider: string | null;
250
+ recoverable: boolean;
251
+ userMessage: string | null;
252
+ } | null;
243
253
  /** Reason provided if the action was rejected by a human reviewer. */
244
254
  rejectionReason: string | null;
245
255
  /** Additional custom fields from post-event configuration. */
@@ -247,6 +257,12 @@ interface ActionCallbackPayload {
247
257
  }
248
258
  /** Mode of a user tool approval rule. */
249
259
  type ApprovalMode = "always_allow" | "always_deny";
260
+ /**
261
+ * Mode accepted by settings UIs that sync Allow/Ask choices. `always_allow`
262
+ * persists an allow rule. `ask` means no stored allow rule for that listed
263
+ * tool. `always_deny` is intentionally not accepted by sync.
264
+ */
265
+ type ApprovalRuleSyncMode = "always_allow" | "ask";
250
266
  /**
251
267
  * A persisted rule that auto-approves (or auto-denies) a specific
252
268
  * `(user, webhook, tool)` triple, bypassing the per-action approval prompt.
@@ -273,13 +289,15 @@ interface ListUserApprovalsParams {
273
289
  /**
274
290
  * Filter to a single user's approvals. Accepts either an internal AgentPress
275
291
  * user UUID, or — when paired with {@link authProvider} — an external user ID
276
- * from a custom auth provider (e.g. LocalFalcon).
292
+ * from a custom auth provider. If omitted, lists every approval for the
293
+ * signed webhook.
277
294
  */
278
295
  userId?: string;
279
296
  /**
280
297
  * Name of the registered external auth provider. When provided, `userId` is
281
298
  * treated as the external user ID and resolved to the internal user via
282
- * `users.external_auth_id`.
299
+ * `users.external_auth_id`. The resolved user must belong to the webhook's
300
+ * AgentPress org.
283
301
  */
284
302
  authProvider?: string;
285
303
  }
@@ -287,6 +305,40 @@ interface ListUserApprovalsParams {
287
305
  interface ListUserApprovalsResponse {
288
306
  approvals: UserToolApproval[];
289
307
  }
308
+ /** Metadata for one tool that the webhook's default rule stages for approval. */
309
+ interface WebhookApprovalToolMetadata {
310
+ /** Stable tool slug to use in create/sync rules. */
311
+ toolName: string;
312
+ /** Human-readable label matching AgentPress approval UI formatting. */
313
+ label: string;
314
+ /** Tool description, when exposed by the agent/tool catalog. */
315
+ description: string | null;
316
+ /** True/false when known; null when the tool catalog does not expose it. */
317
+ destructiveHint: boolean | null;
318
+ /** True/false when known; null when the tool catalog does not expose it. */
319
+ sensitiveHint: boolean | null;
320
+ }
321
+ /** Webhook metadata plus the ordered approval-tool catalog for partner UIs. */
322
+ interface WebhookApprovalMetadata {
323
+ /** Same value as `actionWebhookId`; included for compatibility. */
324
+ id: string;
325
+ /** UUID of the `action_webhooks` row resolved from `webhookIdentifier`. */
326
+ actionWebhookId: string;
327
+ /** Stable webhook slug used in SDK calls and signed URLs. */
328
+ webhookIdentifier: string;
329
+ /** Human-readable webhook display name. */
330
+ displayName: string;
331
+ /** Alias of `displayName`; included for compatibility with webhook rows. */
332
+ name: string;
333
+ /** Organization that owns this webhook. */
334
+ orgId: string;
335
+ /** Default action rule attached to the webhook, if any. */
336
+ defaultActionRuleId: string | null;
337
+ /** Ordered tools matching the AgentPress approval popup order. */
338
+ availableTools: WebhookApprovalToolMetadata[];
339
+ /** Backwards-compatible ordered projection of `availableTools[].toolName`. */
340
+ toolNames: string[];
341
+ }
290
342
  /** Parameters for {@link UserApprovalsClient.create}. */
291
343
  interface CreateUserApprovalParams {
292
344
  /** Webhook identifier (slug) — required to scope the signing secret. */
@@ -294,21 +346,26 @@ interface CreateUserApprovalParams {
294
346
  /**
295
347
  * User identifier this rule applies to. Accepts either an internal AgentPress
296
348
  * user UUID, or — when paired with {@link authProvider} — an external user ID
297
- * from a custom auth provider (e.g. LocalFalcon).
349
+ * from a custom auth provider.
298
350
  */
299
351
  userId: string;
300
352
  /**
301
353
  * Name of the registered external auth provider. When provided, `userId` is
302
354
  * treated as the external user ID and resolved to the internal user via
303
355
  * `users.external_auth_id`. The user must have authenticated through the
304
- * provider at least once for resolution to succeed.
356
+ * provider at least once and belong to the webhook's AgentPress org for
357
+ * resolution to succeed.
305
358
  */
306
359
  authProvider?: string;
307
- /** UUID of the `action_webhooks` row. Must match the webhook identified by `webhookIdentifier`. */
308
- actionWebhookId: string;
309
- /** Name of the tool this rule covers. */
360
+ /**
361
+ * UUID of the `action_webhooks` row. Optional for SDK callers; when omitted,
362
+ * AgentPress resolves it from `webhookIdentifier`. If supplied, core rejects
363
+ * the request unless it matches the URL-scoped webhook.
364
+ */
365
+ actionWebhookId?: string;
366
+ /** Tool slug from `WebhookApprovalMetadata.availableTools[].toolName`. */
310
367
  toolName: string;
311
- /** @default "always_allow" */
368
+ /** Stored approval mode. Defaults to `"always_allow"`. */
312
369
  mode?: ApprovalMode;
313
370
  /** `null` or omitted = never expires. */
314
371
  expiresAt?: Date | null;
@@ -325,6 +382,51 @@ interface DeleteUserApprovalParams {
325
382
  /** Webhook identifier (slug) the approval belongs to — required for signing. */
326
383
  webhookIdentifier: string;
327
384
  }
385
+ /** Parameters for {@link UserApprovalsClient.getWebhookMetadata}. */
386
+ interface GetUserApprovalWebhookMetadataParams {
387
+ /** Webhook identifier (slug) — required to scope the signing secret. */
388
+ webhookIdentifier: string;
389
+ }
390
+ interface SyncUserApprovalRule {
391
+ /** Tool slug from `WebhookApprovalMetadata.availableTools[].toolName`. */
392
+ toolName: string;
393
+ /** Desired partner UI state for this listed tool. */
394
+ mode: ApprovalRuleSyncMode;
395
+ }
396
+ /** Parameters for {@link UserApprovalsClient.sync}. */
397
+ interface SyncUserApprovalsParams {
398
+ /** Webhook identifier (slug) — required to scope the signing secret. */
399
+ webhookIdentifier: string;
400
+ /**
401
+ * User identifier this sync applies to. Accepts either an internal AgentPress
402
+ * user UUID, or — when paired with {@link authProvider} — an external user ID.
403
+ */
404
+ userId: string;
405
+ /**
406
+ * Name of the registered external auth provider. The user must have
407
+ * authenticated through that provider at least once and belong to the
408
+ * webhook's AgentPress org.
409
+ */
410
+ authProvider?: string;
411
+ /**
412
+ * Complete desired Allow/Ask state for the tools your UI manages. Tools not
413
+ * listed here are left untouched. Existing always_deny rules are preserved.
414
+ */
415
+ rules: SyncUserApprovalRule[];
416
+ }
417
+ interface SyncUserApprovalsResponse {
418
+ /** Approval rows remaining after sync for this user and webhook. */
419
+ approvals: UserToolApproval[];
420
+ summary: {
421
+ /** Unique tool names requested after duplicate tool names are collapsed. */requested: number; /** Number of allow upserts attempted. */
422
+ upserted: number; /** Number of existing non-deny rows removed for `ask`. */
423
+ removed: number; /** Number of requested rows that already had the desired no-op state. */
424
+ unchanged: number; /** Number of requested tools skipped because an always_deny rule exists. */
425
+ preservedDeny: number;
426
+ };
427
+ /** Tool names whose existing always_deny rows were intentionally preserved. */
428
+ preservedDenyTools: string[];
429
+ }
328
430
  /** @internal Resolved (validated, defaulted) options. Not exported from the public API. */
329
431
  interface ResolvedOptions {
330
432
  baseUrl: string;
@@ -465,12 +567,16 @@ declare class PartnersClient {
465
567
  * ```ts
466
568
  * const client = new AgentPress({ webhookSecret: "whsec_...", org: "my-org" });
467
569
  *
468
- * // Provision consent so future "sendEmail" triggers skip the approval prompt
469
- * await client.userApprovals.create({
570
+ * const metadata = await client.userApprovals.getWebhookMetadata({
470
571
  * webhookIdentifier: "reviews",
572
+ * });
573
+ * const selectedTool = getSelectedToolFromYourUi(metadata.availableTools);
574
+ *
575
+ * // Provision consent so future selectedTool triggers skip the approval prompt
576
+ * await client.userApprovals.create({
577
+ * webhookIdentifier: metadata.webhookIdentifier,
471
578
  * userId: "user-uuid",
472
- * actionWebhookId: "webhook-uuid",
473
- * toolName: "sendEmail",
579
+ * toolName: selectedTool.toolName,
474
580
  * mode: "always_allow",
475
581
  * });
476
582
  *
@@ -489,22 +595,56 @@ declare class UserApprovalsClient {
489
595
  constructor(options: ResolvedOptions, http: HttpClient);
490
596
  /**
491
597
  * List auto-approval rules for a webhook. Optionally filter by `userId`.
598
+ * When `userId` is omitted, AgentPress returns all approval rules for the
599
+ * signed webhook. Partner user-settings UIs should usually pass `userId` and
600
+ * `authProvider`.
492
601
  *
493
602
  * @throws ConfigurationError if webhookSecret is not configured
494
- * @throws HttpError on non-2xx response
603
+ * @throws HttpError on non-2xx response. A 422 with
604
+ * `code: "USER_NOT_PROVISIONED"` means the external user has not
605
+ * authenticated into AgentPress yet or is not a member of the webhook's org.
495
606
  * @throws TimeoutError if request exceeds timeout
496
607
  */
497
608
  list(params: ListUserApprovalsParams): Promise<ListUserApprovalsResponse>;
609
+ /**
610
+ * Fetch metadata for a webhook plus the ordered tools that its default action
611
+ * rule stages for approval. This is the SDK source of truth for partner
612
+ * settings UIs; `actionWebhookId` in the response can be passed to older
613
+ * AgentPress versions that still require it. Tool order matches the
614
+ * AgentPress approval popup.
615
+ *
616
+ * @throws ConfigurationError if webhookSecret is not configured
617
+ * @throws HttpError on non-2xx response
618
+ * @throws TimeoutError if request exceeds timeout
619
+ */
620
+ getWebhookMetadata(params: GetUserApprovalWebhookMetadataParams): Promise<WebhookApprovalMetadata>;
498
621
  /**
499
622
  * Create (or upsert) an auto-approval rule. If a rule with the same
500
623
  * `(userId, actionWebhookId, toolName)` triple already exists, it is
501
- * updated in place.
624
+ * updated in place. `actionWebhookId` is optional for current AgentPress
625
+ * core; the webhook URL scope resolves it from `webhookIdentifier`. Use
626
+ * `toolName` values from `getWebhookMetadata().availableTools`.
502
627
  *
503
628
  * @throws ConfigurationError if webhookSecret is not configured
504
- * @throws HttpError on non-2xx response
629
+ * @throws HttpError on non-2xx response. A 422 with
630
+ * `code: "USER_NOT_PROVISIONED"` means the external user has not
631
+ * authenticated into AgentPress yet or is not a member of the webhook's org.
505
632
  * @throws TimeoutError if request exceeds timeout
506
633
  */
507
634
  create(params: CreateUserApprovalParams): Promise<UserToolApproval>;
635
+ /**
636
+ * Idempotently sync a partner settings UI's Allow/Ask choices for one user
637
+ * and one webhook. `mode: "ask"` removes an existing allow rule for that
638
+ * listed tool. Existing `always_deny` rules and non-listed tool rules are
639
+ * preserved.
640
+ *
641
+ * @throws ConfigurationError if webhookSecret is not configured
642
+ * @throws HttpError on non-2xx response. A 422 with
643
+ * `code: "USER_NOT_PROVISIONED"` means the external user has not
644
+ * authenticated into AgentPress yet or is not a member of the webhook's org.
645
+ * @throws TimeoutError if request exceeds timeout
646
+ */
647
+ sync(params: SyncUserApprovalsParams): Promise<SyncUserApprovalsResponse>;
508
648
  /**
509
649
  * Patch an existing auto-approval rule (change mode or expiry).
510
650
  *
@@ -670,5 +810,5 @@ declare class KeyRotationVerifyError extends AgentPressError {
670
810
  constructor(reason: KeyRotationVerifyErrorReason, message: string);
671
811
  }
672
812
  //#endregion
673
- export { ACTION_EVENT_TYPES, type ActionCallbackPayload, type ActionEventType, type ActionManageResponse, type ActionStatus, ActionsClient, AgentPress, AgentPressError, type AgentPressOptions, type AgentResponse, type ApprovalMode, type ApproveActionParams, ConfigurationError, type CreateUserApprovalParams, type DeleteUserApprovalParams, HttpError, type KeyRotationEvent, KeyRotationVerifyError, type KeyRotationVerifyErrorReason, type KeyRotationVerifyParams, type ListUserApprovalsParams, type ListUserApprovalsResponse, type PartnerMcpOptions, type PartnerTokenClaims, PartnerTokenError, type PartnerTokenErrorReason, PartnersClient, type RejectActionParams, type StagedToolCall, type StagedToolCallSummary, TimeoutError, type ToolCallResult, type UpdateUserApprovalParams, UserApprovalsClient, type UserToolApproval, type WebhookResponse, type WebhookSendParams, WebhookSignatureError, type WebhookVerifyParams, WebhooksClient };
813
+ export { ACTION_EVENT_TYPES, type ActionCallbackPayload, type ActionEventType, type ActionManageResponse, type ActionStatus, ActionsClient, AgentPress, AgentPressError, type AgentPressOptions, type AgentResponse, type ApprovalMode, type ApprovalRuleSyncMode, type ApproveActionParams, ConfigurationError, type CreateUserApprovalParams, type DeleteUserApprovalParams, type GetUserApprovalWebhookMetadataParams, HttpError, type KeyRotationEvent, KeyRotationVerifyError, type KeyRotationVerifyErrorReason, type KeyRotationVerifyParams, type ListUserApprovalsParams, type ListUserApprovalsResponse, type PartnerMcpOptions, type PartnerTokenClaims, PartnerTokenError, type PartnerTokenErrorReason, PartnersClient, type RejectActionParams, type StagedToolCall, type StagedToolCallSummary, type SyncUserApprovalRule, type SyncUserApprovalsParams, type SyncUserApprovalsResponse, TimeoutError, type ToolCallResult, type UpdateUserApprovalParams, UserApprovalsClient, type UserToolApproval, type WebhookApprovalMetadata, type WebhookApprovalToolMetadata, type WebhookResponse, type WebhookSendParams, WebhookSignatureError, type WebhookVerifyParams, WebhooksClient };
674
814
  //# sourceMappingURL=index.d.cts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/http.ts","../src/actions/client.ts","../src/partners/client.ts","../src/userApprovals/client.ts","../src/webhooks/client.ts","../src/client.ts","../src/errors.ts"],"mappings":"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"}
1
+ {"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/http.ts","../src/actions/client.ts","../src/partners/client.ts","../src/userApprovals/client.ts","../src/webhooks/client.ts","../src/client.ts","../src/errors.ts"],"mappings":"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"}
package/dist/index.d.mts CHANGED
@@ -44,7 +44,7 @@ interface PartnerMcpOptions {
44
44
  issuer: string;
45
45
  /** Exact match for the JWT `aud` claim — your partner MCP's stable URL. */
46
46
  audience: string;
47
- /** Required value for the `ext_provider` claim, e.g. `"localfalcon"`. */
47
+ /** Required value for the `ext_provider` claim, e.g. `"partner_auth"`. */
48
48
  expectedExtProvider: string;
49
49
  /**
50
50
  * Clock skew tolerance for `iat` / `exp` validation. Accepts a jose duration
@@ -240,6 +240,16 @@ interface ActionCallbackPayload {
240
240
  agentResponse: AgentResponse;
241
241
  /** Error message if the action failed. */
242
242
  errorMessage: string | null;
243
+ /**
244
+ * Structured error metadata for clients that need branching/logging without
245
+ * displaying raw provider errors.
246
+ */
247
+ errorDetails: {
248
+ code: string | null;
249
+ provider: string | null;
250
+ recoverable: boolean;
251
+ userMessage: string | null;
252
+ } | null;
243
253
  /** Reason provided if the action was rejected by a human reviewer. */
244
254
  rejectionReason: string | null;
245
255
  /** Additional custom fields from post-event configuration. */
@@ -247,6 +257,12 @@ interface ActionCallbackPayload {
247
257
  }
248
258
  /** Mode of a user tool approval rule. */
249
259
  type ApprovalMode = "always_allow" | "always_deny";
260
+ /**
261
+ * Mode accepted by settings UIs that sync Allow/Ask choices. `always_allow`
262
+ * persists an allow rule. `ask` means no stored allow rule for that listed
263
+ * tool. `always_deny` is intentionally not accepted by sync.
264
+ */
265
+ type ApprovalRuleSyncMode = "always_allow" | "ask";
250
266
  /**
251
267
  * A persisted rule that auto-approves (or auto-denies) a specific
252
268
  * `(user, webhook, tool)` triple, bypassing the per-action approval prompt.
@@ -273,13 +289,15 @@ interface ListUserApprovalsParams {
273
289
  /**
274
290
  * Filter to a single user's approvals. Accepts either an internal AgentPress
275
291
  * user UUID, or — when paired with {@link authProvider} — an external user ID
276
- * from a custom auth provider (e.g. LocalFalcon).
292
+ * from a custom auth provider. If omitted, lists every approval for the
293
+ * signed webhook.
277
294
  */
278
295
  userId?: string;
279
296
  /**
280
297
  * Name of the registered external auth provider. When provided, `userId` is
281
298
  * treated as the external user ID and resolved to the internal user via
282
- * `users.external_auth_id`.
299
+ * `users.external_auth_id`. The resolved user must belong to the webhook's
300
+ * AgentPress org.
283
301
  */
284
302
  authProvider?: string;
285
303
  }
@@ -287,6 +305,40 @@ interface ListUserApprovalsParams {
287
305
  interface ListUserApprovalsResponse {
288
306
  approvals: UserToolApproval[];
289
307
  }
308
+ /** Metadata for one tool that the webhook's default rule stages for approval. */
309
+ interface WebhookApprovalToolMetadata {
310
+ /** Stable tool slug to use in create/sync rules. */
311
+ toolName: string;
312
+ /** Human-readable label matching AgentPress approval UI formatting. */
313
+ label: string;
314
+ /** Tool description, when exposed by the agent/tool catalog. */
315
+ description: string | null;
316
+ /** True/false when known; null when the tool catalog does not expose it. */
317
+ destructiveHint: boolean | null;
318
+ /** True/false when known; null when the tool catalog does not expose it. */
319
+ sensitiveHint: boolean | null;
320
+ }
321
+ /** Webhook metadata plus the ordered approval-tool catalog for partner UIs. */
322
+ interface WebhookApprovalMetadata {
323
+ /** Same value as `actionWebhookId`; included for compatibility. */
324
+ id: string;
325
+ /** UUID of the `action_webhooks` row resolved from `webhookIdentifier`. */
326
+ actionWebhookId: string;
327
+ /** Stable webhook slug used in SDK calls and signed URLs. */
328
+ webhookIdentifier: string;
329
+ /** Human-readable webhook display name. */
330
+ displayName: string;
331
+ /** Alias of `displayName`; included for compatibility with webhook rows. */
332
+ name: string;
333
+ /** Organization that owns this webhook. */
334
+ orgId: string;
335
+ /** Default action rule attached to the webhook, if any. */
336
+ defaultActionRuleId: string | null;
337
+ /** Ordered tools matching the AgentPress approval popup order. */
338
+ availableTools: WebhookApprovalToolMetadata[];
339
+ /** Backwards-compatible ordered projection of `availableTools[].toolName`. */
340
+ toolNames: string[];
341
+ }
290
342
  /** Parameters for {@link UserApprovalsClient.create}. */
291
343
  interface CreateUserApprovalParams {
292
344
  /** Webhook identifier (slug) — required to scope the signing secret. */
@@ -294,21 +346,26 @@ interface CreateUserApprovalParams {
294
346
  /**
295
347
  * User identifier this rule applies to. Accepts either an internal AgentPress
296
348
  * user UUID, or — when paired with {@link authProvider} — an external user ID
297
- * from a custom auth provider (e.g. LocalFalcon).
349
+ * from a custom auth provider.
298
350
  */
299
351
  userId: string;
300
352
  /**
301
353
  * Name of the registered external auth provider. When provided, `userId` is
302
354
  * treated as the external user ID and resolved to the internal user via
303
355
  * `users.external_auth_id`. The user must have authenticated through the
304
- * provider at least once for resolution to succeed.
356
+ * provider at least once and belong to the webhook's AgentPress org for
357
+ * resolution to succeed.
305
358
  */
306
359
  authProvider?: string;
307
- /** UUID of the `action_webhooks` row. Must match the webhook identified by `webhookIdentifier`. */
308
- actionWebhookId: string;
309
- /** Name of the tool this rule covers. */
360
+ /**
361
+ * UUID of the `action_webhooks` row. Optional for SDK callers; when omitted,
362
+ * AgentPress resolves it from `webhookIdentifier`. If supplied, core rejects
363
+ * the request unless it matches the URL-scoped webhook.
364
+ */
365
+ actionWebhookId?: string;
366
+ /** Tool slug from `WebhookApprovalMetadata.availableTools[].toolName`. */
310
367
  toolName: string;
311
- /** @default "always_allow" */
368
+ /** Stored approval mode. Defaults to `"always_allow"`. */
312
369
  mode?: ApprovalMode;
313
370
  /** `null` or omitted = never expires. */
314
371
  expiresAt?: Date | null;
@@ -325,6 +382,51 @@ interface DeleteUserApprovalParams {
325
382
  /** Webhook identifier (slug) the approval belongs to — required for signing. */
326
383
  webhookIdentifier: string;
327
384
  }
385
+ /** Parameters for {@link UserApprovalsClient.getWebhookMetadata}. */
386
+ interface GetUserApprovalWebhookMetadataParams {
387
+ /** Webhook identifier (slug) — required to scope the signing secret. */
388
+ webhookIdentifier: string;
389
+ }
390
+ interface SyncUserApprovalRule {
391
+ /** Tool slug from `WebhookApprovalMetadata.availableTools[].toolName`. */
392
+ toolName: string;
393
+ /** Desired partner UI state for this listed tool. */
394
+ mode: ApprovalRuleSyncMode;
395
+ }
396
+ /** Parameters for {@link UserApprovalsClient.sync}. */
397
+ interface SyncUserApprovalsParams {
398
+ /** Webhook identifier (slug) — required to scope the signing secret. */
399
+ webhookIdentifier: string;
400
+ /**
401
+ * User identifier this sync applies to. Accepts either an internal AgentPress
402
+ * user UUID, or — when paired with {@link authProvider} — an external user ID.
403
+ */
404
+ userId: string;
405
+ /**
406
+ * Name of the registered external auth provider. The user must have
407
+ * authenticated through that provider at least once and belong to the
408
+ * webhook's AgentPress org.
409
+ */
410
+ authProvider?: string;
411
+ /**
412
+ * Complete desired Allow/Ask state for the tools your UI manages. Tools not
413
+ * listed here are left untouched. Existing always_deny rules are preserved.
414
+ */
415
+ rules: SyncUserApprovalRule[];
416
+ }
417
+ interface SyncUserApprovalsResponse {
418
+ /** Approval rows remaining after sync for this user and webhook. */
419
+ approvals: UserToolApproval[];
420
+ summary: {
421
+ /** Unique tool names requested after duplicate tool names are collapsed. */requested: number; /** Number of allow upserts attempted. */
422
+ upserted: number; /** Number of existing non-deny rows removed for `ask`. */
423
+ removed: number; /** Number of requested rows that already had the desired no-op state. */
424
+ unchanged: number; /** Number of requested tools skipped because an always_deny rule exists. */
425
+ preservedDeny: number;
426
+ };
427
+ /** Tool names whose existing always_deny rows were intentionally preserved. */
428
+ preservedDenyTools: string[];
429
+ }
328
430
  /** @internal Resolved (validated, defaulted) options. Not exported from the public API. */
329
431
  interface ResolvedOptions {
330
432
  baseUrl: string;
@@ -465,12 +567,16 @@ declare class PartnersClient {
465
567
  * ```ts
466
568
  * const client = new AgentPress({ webhookSecret: "whsec_...", org: "my-org" });
467
569
  *
468
- * // Provision consent so future "sendEmail" triggers skip the approval prompt
469
- * await client.userApprovals.create({
570
+ * const metadata = await client.userApprovals.getWebhookMetadata({
470
571
  * webhookIdentifier: "reviews",
572
+ * });
573
+ * const selectedTool = getSelectedToolFromYourUi(metadata.availableTools);
574
+ *
575
+ * // Provision consent so future selectedTool triggers skip the approval prompt
576
+ * await client.userApprovals.create({
577
+ * webhookIdentifier: metadata.webhookIdentifier,
471
578
  * userId: "user-uuid",
472
- * actionWebhookId: "webhook-uuid",
473
- * toolName: "sendEmail",
579
+ * toolName: selectedTool.toolName,
474
580
  * mode: "always_allow",
475
581
  * });
476
582
  *
@@ -489,22 +595,56 @@ declare class UserApprovalsClient {
489
595
  constructor(options: ResolvedOptions, http: HttpClient);
490
596
  /**
491
597
  * List auto-approval rules for a webhook. Optionally filter by `userId`.
598
+ * When `userId` is omitted, AgentPress returns all approval rules for the
599
+ * signed webhook. Partner user-settings UIs should usually pass `userId` and
600
+ * `authProvider`.
492
601
  *
493
602
  * @throws ConfigurationError if webhookSecret is not configured
494
- * @throws HttpError on non-2xx response
603
+ * @throws HttpError on non-2xx response. A 422 with
604
+ * `code: "USER_NOT_PROVISIONED"` means the external user has not
605
+ * authenticated into AgentPress yet or is not a member of the webhook's org.
495
606
  * @throws TimeoutError if request exceeds timeout
496
607
  */
497
608
  list(params: ListUserApprovalsParams): Promise<ListUserApprovalsResponse>;
609
+ /**
610
+ * Fetch metadata for a webhook plus the ordered tools that its default action
611
+ * rule stages for approval. This is the SDK source of truth for partner
612
+ * settings UIs; `actionWebhookId` in the response can be passed to older
613
+ * AgentPress versions that still require it. Tool order matches the
614
+ * AgentPress approval popup.
615
+ *
616
+ * @throws ConfigurationError if webhookSecret is not configured
617
+ * @throws HttpError on non-2xx response
618
+ * @throws TimeoutError if request exceeds timeout
619
+ */
620
+ getWebhookMetadata(params: GetUserApprovalWebhookMetadataParams): Promise<WebhookApprovalMetadata>;
498
621
  /**
499
622
  * Create (or upsert) an auto-approval rule. If a rule with the same
500
623
  * `(userId, actionWebhookId, toolName)` triple already exists, it is
501
- * updated in place.
624
+ * updated in place. `actionWebhookId` is optional for current AgentPress
625
+ * core; the webhook URL scope resolves it from `webhookIdentifier`. Use
626
+ * `toolName` values from `getWebhookMetadata().availableTools`.
502
627
  *
503
628
  * @throws ConfigurationError if webhookSecret is not configured
504
- * @throws HttpError on non-2xx response
629
+ * @throws HttpError on non-2xx response. A 422 with
630
+ * `code: "USER_NOT_PROVISIONED"` means the external user has not
631
+ * authenticated into AgentPress yet or is not a member of the webhook's org.
505
632
  * @throws TimeoutError if request exceeds timeout
506
633
  */
507
634
  create(params: CreateUserApprovalParams): Promise<UserToolApproval>;
635
+ /**
636
+ * Idempotently sync a partner settings UI's Allow/Ask choices for one user
637
+ * and one webhook. `mode: "ask"` removes an existing allow rule for that
638
+ * listed tool. Existing `always_deny` rules and non-listed tool rules are
639
+ * preserved.
640
+ *
641
+ * @throws ConfigurationError if webhookSecret is not configured
642
+ * @throws HttpError on non-2xx response. A 422 with
643
+ * `code: "USER_NOT_PROVISIONED"` means the external user has not
644
+ * authenticated into AgentPress yet or is not a member of the webhook's org.
645
+ * @throws TimeoutError if request exceeds timeout
646
+ */
647
+ sync(params: SyncUserApprovalsParams): Promise<SyncUserApprovalsResponse>;
508
648
  /**
509
649
  * Patch an existing auto-approval rule (change mode or expiry).
510
650
  *
@@ -670,5 +810,5 @@ declare class KeyRotationVerifyError extends AgentPressError {
670
810
  constructor(reason: KeyRotationVerifyErrorReason, message: string);
671
811
  }
672
812
  //#endregion
673
- export { ACTION_EVENT_TYPES, type ActionCallbackPayload, type ActionEventType, type ActionManageResponse, type ActionStatus, ActionsClient, AgentPress, AgentPressError, type AgentPressOptions, type AgentResponse, type ApprovalMode, type ApproveActionParams, ConfigurationError, type CreateUserApprovalParams, type DeleteUserApprovalParams, HttpError, type KeyRotationEvent, KeyRotationVerifyError, type KeyRotationVerifyErrorReason, type KeyRotationVerifyParams, type ListUserApprovalsParams, type ListUserApprovalsResponse, type PartnerMcpOptions, type PartnerTokenClaims, PartnerTokenError, type PartnerTokenErrorReason, PartnersClient, type RejectActionParams, type StagedToolCall, type StagedToolCallSummary, TimeoutError, type ToolCallResult, type UpdateUserApprovalParams, UserApprovalsClient, type UserToolApproval, type WebhookResponse, type WebhookSendParams, WebhookSignatureError, type WebhookVerifyParams, WebhooksClient };
813
+ export { ACTION_EVENT_TYPES, type ActionCallbackPayload, type ActionEventType, type ActionManageResponse, type ActionStatus, ActionsClient, AgentPress, AgentPressError, type AgentPressOptions, type AgentResponse, type ApprovalMode, type ApprovalRuleSyncMode, type ApproveActionParams, ConfigurationError, type CreateUserApprovalParams, type DeleteUserApprovalParams, type GetUserApprovalWebhookMetadataParams, HttpError, type KeyRotationEvent, KeyRotationVerifyError, type KeyRotationVerifyErrorReason, type KeyRotationVerifyParams, type ListUserApprovalsParams, type ListUserApprovalsResponse, type PartnerMcpOptions, type PartnerTokenClaims, PartnerTokenError, type PartnerTokenErrorReason, PartnersClient, type RejectActionParams, type StagedToolCall, type StagedToolCallSummary, type SyncUserApprovalRule, type SyncUserApprovalsParams, type SyncUserApprovalsResponse, TimeoutError, type ToolCallResult, type UpdateUserApprovalParams, UserApprovalsClient, type UserToolApproval, type WebhookApprovalMetadata, type WebhookApprovalToolMetadata, type WebhookResponse, type WebhookSendParams, WebhookSignatureError, type WebhookVerifyParams, WebhooksClient };
674
814
  //# sourceMappingURL=index.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/http.ts","../src/actions/client.ts","../src/partners/client.ts","../src/userApprovals/client.ts","../src/webhooks/client.ts","../src/client.ts","../src/errors.ts"],"mappings":"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"}
1
+ {"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/http.ts","../src/actions/client.ts","../src/partners/client.ts","../src/userApprovals/client.ts","../src/webhooks/client.ts","../src/client.ts","../src/errors.ts"],"mappings":"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"}