@naturalpay/sdk 0.4.0 → 0.5.0

package/resources/agents.d.ts

@@ -39,24 +39,23 @@ export declare class Agents extends APIResource {
      */
     list(params?: AgentListParams | null | undefined, options?: RequestOptions): APIPromise<AgentListResponse>;
     /**
-     * Developer-only. Creates one invitation per agent and sends a single Resend email
-     * to the customer.
+     * Add or invite customer relationships for this agent.
      *
      * @example
      * ```ts
-     * const response = await client.agents.createInvitations({
-     *   agents: [
-     *     {
-     *       agentId: 'agt_ecc2efdd09bd231a9ad9bd2aada37aa7',
-     *       permissions: ['string'],
-     *     },
-     *   ],
-     *   customerEmail: 'dev@stainless.com',
-     *   'Idempotency-Key': 'Idempotency-Key',
-     * });
+     * const response = await client.agents.createCustomer(
+     *   'agt_ecc2efdd09bd231a9ad9bd2aada37aa7',
+     *   {
+     *     permissions: ['string'],
+     *     recipients: [
+     *       { type: 'type', value: 'dev@stainless.com' },
+     *     ],
+     *     'Idempotency-Key': 'Idempotency-Key',
+     *   },
+     * );
      * ```
      */
-    createInvitations(params: AgentCreateInvitationsParams, options?: RequestOptions): APIPromise<AgentCreateInvitationsResponse>;
+    createCustomer(agentID: string, params: AgentCreateCustomerParams, options?: RequestOptions): APIPromise<AgentCreateCustomerResponse>;
     /**
      * Get agent details by its unique ID.
      *
@@ -69,17 +68,30 @@ export declare class Agents extends APIResource {
      */
     get(agentID: string, params?: AgentGetParams | null | undefined, options?: RequestOptions): APIPromise<AgentGetResponse>;
     /**
-     * List agent delegation invitations
+     * Get a specific customer invitation for this agent.
+     *
+     * @example
+     * ```ts
+     * const response = await client.agents.getCustomer(
+     *   'pty_ecc2efdd09bd231a9ad9bd2aada37aa7',
+     *   { agentId: 'agt_ecc2efdd09bd231a9ad9bd2aada37aa7' },
+     * );
+     * ```
+     */
+    getCustomer(customerID: string, params: AgentGetCustomerParams, options?: RequestOptions): APIPromise<AgentGetCustomerResponse>;
+    /**
+     * List customer invitations for this agent.
      *
      * @example
      * ```ts
-     * const response =
-     *   await client.agents.listInvitationsForDeveloper();
+     * const response = await client.agents.listCustomers(
+     *   'agt_ecc2efdd09bd231a9ad9bd2aada37aa7',
+     * );
      * ```
      */
-    listInvitationsForDeveloper(params?: AgentListInvitationsForDeveloperParams | null | undefined, options?: RequestOptions): APIPromise<AgentListInvitationsForDeveloperResponse>;
+    listCustomers(agentID: string, params?: AgentListCustomersParams | null | undefined, options?: RequestOptions): APIPromise<AgentListCustomersResponse>;
     /**
-     * Revoke an agent.
+     * Delete an agent. Deleting an agent revokes it and cleans up active access.
      *
      * @example
      * ```ts
@@ -90,6 +102,21 @@ export declare class Agents extends APIResource {
      * ```
      */
     remove(agentID: string, params: AgentRemoveParams, options?: RequestOptions): APIPromise<AgentRemoveResponse>;
+    /**
+     * Revoke this customer invitation so the agent can no longer act for the customer.
+     *
+     * @example
+     * ```ts
+     * const response = await client.agents.removeCustomer(
+     *   'pty_ecc2efdd09bd231a9ad9bd2aada37aa7',
+     *   {
+     *     agentId: 'agt_ecc2efdd09bd231a9ad9bd2aada37aa7',
+     *     'Idempotency-Key': 'Idempotency-Key',
+     *   },
+     * );
+     * ```
+     */
+    removeCustomer(customerID: string, params: AgentRemoveCustomerParams, options?: RequestOptions): APIPromise<AgentRemoveCustomerResponse>;
 }
 export interface AgentCreateResponse {
     data: AgentCreateResponse.Data;
@@ -398,28 +425,28 @@ export declare namespace AgentListResponse {
         }
     }
 }
-export interface AgentCreateInvitationsResponse {
+export interface AgentCreateCustomerResponse {
     /**
-     * Successfully created invitation resources
+     * Created customer invitation resources
      */
-    data: Array<AgentCreateInvitationsResponse.Data>;
+    data: Array<AgentCreateCustomerResponse.Data>;
     /**
      * Batch invitation metadata
      */
-    meta: AgentCreateInvitationsResponse.Meta;
+    meta: AgentCreateCustomerResponse.Meta;
 }
-export declare namespace AgentCreateInvitationsResponse {
+export declare namespace AgentCreateCustomerResponse {
     interface Data {
         /**
-         * Invitation ID (adi\_\*)
+         * Customer invitation ID (adi\_\*)
          */
         id: string;
         /**
-         * Resource attributes
+         * Invitation attributes
          */
         attributes: Data.Attributes;
         /**
-         * Related resource identifiers
+         * Related agent and customer party
          */
         relationships: Data.Relationships;
         /**
@@ -429,65 +456,41 @@ export declare namespace AgentCreateInvitationsResponse {
     }
     namespace Data {
         /**
-         * Resource attributes
+         * Invitation attributes
          */
         interface Attributes {
-            /**
-             * When this invitation was accepted
-             */
-            acceptedAt: string | null;
-            /**
-             * Display name of the agent being delegated
-             */
-            agentName: string;
-            /**
-             * Why the invitation was cancelled
-             */
-            cancelReason: 'AGENT_RETIRED' | 'DEVELOPER_RETIRED' | null;
             /**
              * When this invitation was created
              */
             createdAt: string;
-            /**
-             * When this invitation was declined
-             */
-            declinedAt: string | null;
-            /**
-             * Display name of the developer party
-             */
-            developerName: string;
-            /**
-             * Status after applying expiry and cancel-reason overlays
-             */
-            effectiveStatus: 'PENDING' | 'ACCEPTED' | 'DECLINED' | 'EXPIRED' | 'CANCELLED';
-            /**
-             * Customer email the invitation was sent to
-             */
-            email: string;
             /**
              * When this invitation expires
              */
             expiresAt: string;
             /**
-             * Per-agent transaction limits
+             * Requested per-agent customer limits
              */
             limits: Attributes.Limits | null;
             /**
-             * Permissions the agent will hold on accept
+             * Permissions requested for this agent invitation
              */
             permissions: Array<string>;
             /**
-             * Raw persisted status
+             * Recipient identifier used to create the invitation
              */
-            status: 'PENDING' | 'ACCEPTED' | 'DECLINED' | 'EXPIRED' | 'CANCELLED';
+            recipient: Attributes.UnionMember0 | Attributes.UnionMember1 | Attributes.UnionMember2;
+            /**
+             * Current invitation status
+             */
+            status: 'ACTIVE' | 'PENDING' | 'ACCEPTED' | 'DECLINED' | 'EXPIRED' | 'CANCELLED' | 'REVOKED';
             /**
              * When this invitation was last updated
              */
-            updatedAt: string;
+            updatedAt: string | null;
         }
         namespace Attributes {
             /**
-             * Per-agent transaction limits
+             * Requested per-agent customer limits
              */
             interface Limits {
                 /**
@@ -495,75 +498,87 @@ export declare namespace AgentCreateInvitationsResponse {
                  */
                 perTransaction?: number | null;
             }
+            interface UnionMember0 {
+                type: string;
+                /**
+                 * Email address
+                 */
+                value: string;
+            }
+            interface UnionMember1 {
+                type: string;
+                /**
+                 * Phone number in E.164 format
+                 */
+                value: string;
+            }
+            interface UnionMember2 {
+                type: string;
+                /**
+                 * Natural party ID (pty\_\*)
+                 */
+                value: string;
+            }
         }
         /**
-         * Related resource identifiers
+         * Related agent and customer party
          */
         interface Relationships {
             /**
-             * Agent being delegated
+             * Agent attached to this invitation
              */
             agent: Relationships.Agent;
             /**
-             * Resulting agent delegation once accepted; currently null on public create/list
-             * responses
-             */
-            agentDelegation: Relationships.AgentDelegation;
-            /**
-             * Customer party the invitation was accepted on (null until accept)
+             * Customer party when the recipient is an existing party or once the invitation is
+             * accepted
              */
             customerParty: Relationships.CustomerParty;
-            /**
-             * Developer party that issued the invitation
-             */
-            developerParty: Relationships.DeveloperParty;
         }
         namespace Relationships {
             /**
-             * Agent being delegated
+             * Agent attached to this invitation
              */
             interface Agent {
-                /**
-                 * Related resource identifier
-                 */
                 data: Agent.Data;
             }
             namespace Agent {
-                /**
-                 * Related resource identifier
-                 */
                 interface Data {
+                    /**
+                     * Agent ID (agt\_\*)
+                     */
                     id: string;
+                    /**
+                     * Agent attributes
+                     */
+                    attributes: Data.Attributes;
                     /**
                      * Resource type
                      */
                     type: string;
                 }
-            }
-            /**
-             * Resulting agent delegation once accepted; currently null on public create/list
-             * responses
-             */
-            interface AgentDelegation {
-                /**
-                 * Related resource identifier
-                 */
-                data: AgentDelegation.Data | null;
-            }
-            namespace AgentDelegation {
-                /**
-                 * Related resource identifier
-                 */
-                interface Data {
-                    id: string;
+                namespace Data {
                     /**
-                     * Resource type
+                     * Agent attributes
                      */
-                    type: string;
+                    interface Attributes {
+                        /**
+                         * Agent description
+                         */
+                        description: string | null;
+                        /**
+                         * Agent display name
+                         */
+                        name: string | null;
+                        /**
+                         * Agent status
+                         */
+                        status: 'ACTIVE' | 'REVOKED';
+                    }
                 }
             }
             /**
-             * Customer party the invitation was accepted on (null until accept)
+             * Customer party when the recipient is an existing party or once the invitation is
+             * accepted
              */
             interface CustomerParty {
                 /**
@@ -583,27 +598,6 @@ export declare namespace AgentCreateInvitationsResponse {
                     type: string;
                 }
             }
-            /**
-             * Developer party that issued the invitation
-             */
-            interface DeveloperParty {
-                /**
-                 * Related resource identifier
-                 */
-                data: DeveloperParty.Data;
-            }
-            namespace DeveloperParty {
-                /**
-                 * Related resource identifier
-                 */
-                interface Data {
-                    id: string;
-                    /**
-                     * Resource type
-                     */
-                    type: string;
-                }
-            }
         }
     }
     /**
@@ -716,22 +710,21 @@ export declare namespace AgentGetResponse {
         }
     }
 }
-export interface AgentListInvitationsForDeveloperResponse {
-    data: Array<AgentListInvitationsForDeveloperResponse.Data>;
-    meta: AgentListInvitationsForDeveloperResponse.Meta;
+export interface AgentGetCustomerResponse {
+    data: AgentGetCustomerResponse.Data;
 }
-export declare namespace AgentListInvitationsForDeveloperResponse {
+export declare namespace AgentGetCustomerResponse {
     interface Data {
         /**
-         * Invitation ID (adi\_\*)
+         * Customer party ID when known; otherwise the lowercased customer email
          */
         id: string;
         /**
-         * Resource attributes
+         * Customer party attributes
          */
         attributes: Data.Attributes;
         /**
-         * Related resource identifiers
+         * Related agent and access details
          */
         relationships: Data.Relationships;
         /**
@@ -741,180 +734,279 @@ export declare namespace AgentListInvitationsForDeveloperResponse {
     }
     namespace Data {
         /**
-         * Resource attributes
+         * Customer party attributes
          */
         interface Attributes {
             /**
-             * When this invitation was accepted
+             * Customer email, when known
              */
-            acceptedAt: string | null;
+            email: string | null;
             /**
-             * Display name of the agent being delegated
+             * Customer party display name, when known
              */
-            agentName: string;
+            name: string | null;
             /**
-             * Why the invitation was cancelled
+             * The customer is represented by a party
              */
-            cancelReason: 'AGENT_RETIRED' | 'DEVELOPER_RETIRED' | null;
-            /**
-             * When this invitation was created
-             */
-            createdAt: string;
-            /**
-             * When this invitation was declined
-             */
-            declinedAt: string | null;
-            /**
-             * Display name of the developer party
-             */
-            developerName: string;
-            /**
-             * Status after applying expiry and cancel-reason overlays
-             */
-            effectiveStatus: 'PENDING' | 'ACCEPTED' | 'DECLINED' | 'EXPIRED' | 'CANCELLED';
-            /**
-             * Customer email the invitation was sent to
-             */
-            email: string;
-            /**
-             * When this invitation expires
-             */
-            expiresAt: string;
-            /**
-             * Per-agent transaction limits
-             */
-            limits: Attributes.Limits | null;
-            /**
-             * Permissions the agent will hold on accept
-             */
-            permissions: Array<string>;
-            /**
-             * Raw persisted status
-             */
-            status: 'PENDING' | 'ACCEPTED' | 'DECLINED' | 'EXPIRED' | 'CANCELLED';
-            /**
-             * When this invitation was last updated
-             */
-            updatedAt: string;
-        }
-        namespace Attributes {
-            /**
-             * Per-agent transaction limits
-             */
-            interface Limits {
-                /**
-                 * Per-transaction cap, integer cents (USD).
-                 */
-                perTransaction?: number | null;
-            }
+            type: string;
         }
         /**
-         * Related resource identifiers
+         * Related agent and access details
          */
         interface Relationships {
             /**
-             * Agent being delegated
-             */
-            agent: Relationships.Agent;
-            /**
-             * Resulting agent delegation once accepted; currently null on public create/list
-             * responses
+             * This agent's access state for the customer
              */
-            agentDelegation: Relationships.AgentDelegation;
+            access: Relationships.Access;
             /**
-             * Customer party the invitation was accepted on (null until accept)
+             * Agent attached to this customer
              */
-            customerParty: Relationships.CustomerParty;
-            /**
-             * Developer party that issued the invitation
-             */
-            developerParty: Relationships.DeveloperParty;
+            agent: Relationships.Agent;
         }
         namespace Relationships {
             /**
-             * Agent being delegated
+             * This agent's access state for the customer
              */
-            interface Agent {
-                /**
-                 * Related resource identifier
-                 */
-                data: Agent.Data;
+            interface Access {
+                data: Access.Data;
             }
-            namespace Agent {
-                /**
-                 * Related resource identifier
-                 */
+            namespace Access {
                 interface Data {
+                    /**
+                     * Underlying access record ID
+                     */
                     id: string;
+                    /**
+                     * Access attributes
+                     */
+                    attributes: Data.Attributes;
                     /**
                      * Resource type
                      */
                     type: string;
                 }
+                namespace Data {
+                    /**
+                     * Access attributes
+                     */
+                    interface Attributes {
+                        /**
+                         * When this agent-customer relationship was created
+                         */
+                        createdAt: string;
+                        /**
+                         * Per-agent customer transaction limits
+                         */
+                        limits: Attributes.Limits | null;
+                        /**
+                         * Permissions granted or requested for this agent
+                         */
+                        permissions: Array<string>;
+                        /**
+                         * Current agent-customer relationship status
+                         */
+                        status: 'ACTIVE' | 'PENDING' | 'ACCEPTED' | 'DECLINED' | 'EXPIRED' | 'CANCELLED' | 'REVOKED';
+                        /**
+                         * When this agent-customer relationship was last updated
+                         */
+                        updatedAt: string | null;
+                    }
+                    namespace Attributes {
+                        /**
+                         * Per-agent customer transaction limits
+                         */
+                        interface Limits {
+                            /**
+                             * Per-transaction cap, integer cents (USD).
+                             */
+                            perTransaction?: number | null;
+                        }
+                    }
+                }
             }
             /**
-             * Resulting agent delegation once accepted; currently null on public create/list
-             * responses
+             * Agent attached to this customer
              */
-            interface AgentDelegation {
-                /**
-                 * Related resource identifier
-                 */
-                data: AgentDelegation.Data | null;
+            interface Agent {
+                data: Agent.Data;
             }
-            namespace AgentDelegation {
-                /**
-                 * Related resource identifier
-                 */
+            namespace Agent {
                 interface Data {
+                    /**
+                     * Agent ID (agt\_\*)
+                     */
                     id: string;
+                    /**
+                     * Agent attributes
+                     */
+                    attributes: Data.Attributes;
                     /**
                      * Resource type
                      */
                     type: string;
                 }
+                namespace Data {
+                    /**
+                     * Agent attributes
+                     */
+                    interface Attributes {
+                        /**
+                         * Agent display name
+                         */
+                        name: string | null;
+                    }
+                }
             }
+        }
+    }
+}
+export interface AgentListCustomersResponse {
+    data: Array<AgentListCustomersResponse.Data>;
+    meta: AgentListCustomersResponse.Meta;
+}
+export declare namespace AgentListCustomersResponse {
+    interface Data {
+        /**
+         * Customer party ID when known; otherwise the lowercased customer email
+         */
+        id: string;
+        /**
+         * Customer party attributes
+         */
+        attributes: Data.Attributes;
+        /**
+         * Related agent and access details
+         */
+        relationships: Data.Relationships;
+        /**
+         * Resource type
+         */
+        type: string;
+    }
+    namespace Data {
+        /**
+         * Customer party attributes
+         */
+        interface Attributes {
             /**
-             * Customer party the invitation was accepted on (null until accept)
+             * Customer email, when known
              */
-            interface CustomerParty {
-                /**
-                 * Related resource identifier
-                 */
-                data: CustomerParty.Data | null;
+            email: string | null;
+            /**
+             * Customer party display name, when known
+             */
+            name: string | null;
+            /**
+             * The customer is represented by a party
+             */
+            type: string;
+        }
+        /**
+         * Related agent and access details
+         */
+        interface Relationships {
+            /**
+             * This agent's access state for the customer
+             */
+            access: Relationships.Access;
+            /**
+             * Agent attached to this customer
+             */
+            agent: Relationships.Agent;
+        }
+        namespace Relationships {
+            /**
+             * This agent's access state for the customer
+             */
+            interface Access {
+                data: Access.Data;
             }
-            namespace CustomerParty {
-                /**
-                 * Related resource identifier
-                 */
+            namespace Access {
                 interface Data {
+                    /**
+                     * Underlying access record ID
+                     */
                     id: string;
+                    /**
+                     * Access attributes
+                     */
+                    attributes: Data.Attributes;
                     /**
                      * Resource type
                      */
                     type: string;
                 }
+                namespace Data {
+                    /**
+                     * Access attributes
+                     */
+                    interface Attributes {
+                        /**
+                         * When this agent-customer relationship was created
+                         */
+                        createdAt: string;
+                        /**
+                         * Per-agent customer transaction limits
+                         */
+                        limits: Attributes.Limits | null;
+                        /**
+                         * Permissions granted or requested for this agent
+                         */
+                        permissions: Array<string>;
+                        /**
+                         * Current agent-customer relationship status
+                         */
+                        status: 'ACTIVE' | 'PENDING' | 'ACCEPTED' | 'DECLINED' | 'EXPIRED' | 'CANCELLED' | 'REVOKED';
+                        /**
+                         * When this agent-customer relationship was last updated
+                         */
+                        updatedAt: string | null;
+                    }
+                    namespace Attributes {
+                        /**
+                         * Per-agent customer transaction limits
+                         */
+                        interface Limits {
+                            /**
+                             * Per-transaction cap, integer cents (USD).
+                             */
+                            perTransaction?: number | null;
+                        }
+                    }
+                }
             }
             /**
-             * Developer party that issued the invitation
+             * Agent attached to this customer
              */
-            interface DeveloperParty {
-                /**
-                 * Related resource identifier
-                 */
-                data: DeveloperParty.Data;
+            interface Agent {
+                data: Agent.Data;
             }
-            namespace DeveloperParty {
-                /**
-                 * Related resource identifier
-                 */
+            namespace Agent {
                 interface Data {
+                    /**
+                     * Agent ID (agt\_\*)
+                     */
                     id: string;
+                    /**
+                     * Agent attributes
+                     */
+                    attributes: Data.Attributes;
                     /**
                      * Resource type
                      */
                     type: string;
                 }
+                namespace Data {
+                    /**
+                     * Agent attributes
+                     */
+                    interface Attributes {
+                        /**
+                         * Agent display name
+                         */
+                        name: string | null;
+                    }
+                }
             }
         }
     }
@@ -1034,6 +1126,163 @@ export declare namespace AgentRemoveResponse {
         deleted: true;
     }
 }
+export interface AgentRemoveCustomerResponse {
+    data: AgentRemoveCustomerResponse.Data;
+    meta: AgentRemoveCustomerResponse.Meta;
+}
+export declare namespace AgentRemoveCustomerResponse {
+    interface Data {
+        /**
+         * Customer party ID when known; otherwise the lowercased customer email
+         */
+        id: string;
+        /**
+         * Customer party attributes
+         */
+        attributes: Data.Attributes;
+        /**
+         * Related agent and access details
+         */
+        relationships: Data.Relationships;
+        /**
+         * Resource type
+         */
+        type: string;
+    }
+    namespace Data {
+        /**
+         * Customer party attributes
+         */
+        interface Attributes {
+            /**
+             * Customer email, when known
+             */
+            email: string | null;
+            /**
+             * Customer party display name, when known
+             */
+            name: string | null;
+            /**
+             * The customer is represented by a party
+             */
+            type: string;
+        }
+        /**
+         * Related agent and access details
+         */
+        interface Relationships {
+            /**
+             * This agent's access state for the customer
+             */
+            access: Relationships.Access;
+            /**
+             * Agent attached to this customer
+             */
+            agent: Relationships.Agent;
+        }
+        namespace Relationships {
+            /**
+             * This agent's access state for the customer
+             */
+            interface Access {
+                data: Access.Data;
+            }
+            namespace Access {
+                interface Data {
+                    /**
+                     * Underlying access record ID
+                     */
+                    id: string;
+                    /**
+                     * Access attributes
+                     */
+                    attributes: Data.Attributes;
+                    /**
+                     * Resource type
+                     */
+                    type: string;
+                }
+                namespace Data {
+                    /**
+                     * Access attributes
+                     */
+                    interface Attributes {
+                        /**
+                         * When this agent-customer relationship was created
+                         */
+                        createdAt: string;
+                        /**
+                         * Per-agent customer transaction limits
+                         */
+                        limits: Attributes.Limits | null;
+                        /**
+                         * Permissions granted or requested for this agent
+                         */
+                        permissions: Array<string>;
+                        /**
+                         * Current agent-customer relationship status
+                         */
+                        status: 'ACTIVE' | 'PENDING' | 'ACCEPTED' | 'DECLINED' | 'EXPIRED' | 'CANCELLED' | 'REVOKED';
+                        /**
+                         * When this agent-customer relationship was last updated
+                         */
+                        updatedAt: string | null;
+                    }
+                    namespace Attributes {
+                        /**
+                         * Per-agent customer transaction limits
+                         */
+                        interface Limits {
+                            /**
+                             * Per-transaction cap, integer cents (USD).
+                             */
+                            perTransaction?: number | null;
+                        }
+                    }
+                }
+            }
+            /**
+             * Agent attached to this customer
+             */
+            interface Agent {
+                data: Agent.Data;
+            }
+            namespace Agent {
+                interface Data {
+                    /**
+                     * Agent ID (agt\_\*)
+                     */
+                    id: string;
+                    /**
+                     * Agent attributes
+                     */
+                    attributes: Data.Attributes;
+                    /**
+                     * Resource type
+                     */
+                    type: string;
+                }
+                namespace Data {
+                    /**
+                     * Agent attributes
+                     */
+                    interface Attributes {
+                        /**
+                         * Agent display name
+                         */
+                        name: string | null;
+                    }
+                }
+            }
+        }
+    }
+    interface Meta {
+        /**
+         * Indicates the resource was deleted
+         */
+        deleted: true;
+    }
+}
 export interface AgentCreateParams {
     /**
      * Body param: Agent display name
@@ -1136,15 +1385,15 @@ export interface AgentListParams {
      */
     'X-Instance-ID'?: string;
 }
-export interface AgentCreateInvitationsParams {
+export interface AgentCreateCustomerParams {
     /**
-     * Body param: Per-agent delegation requests (1-50)
+     * Body param: Permissions to request
      */
-    agents: Array<AgentCreateInvitationsParams.Agent>;
+    permissions: Array<string>;
     /**
-     * Body param: Email address of the customer to invite
+     * Body param: Customer recipients to invite (1-50)
      */
-    customerEmail: string;
+    recipients: Array<AgentCreateCustomerParams.UnionMember0 | AgentCreateCustomerParams.UnionMember1>;
     /**
      * Header param: Unique key for idempotent request handling. If a request with the
      * same key was already processed, the original response is returned.
@@ -1154,6 +1403,10 @@ export interface AgentCreateInvitationsParams {
      * Body param: Optional explicit expiry timestamp; server defaults to 7 days
      */
     expiresAt?: string;
+    /**
+     * Body param: Optional per-transaction limit
+     */
+    limits?: AgentCreateCustomerParams.Limits;
     /**
      * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
      */
@@ -1164,19 +1417,29 @@ export interface AgentCreateInvitationsParams {
      */
     'X-Instance-ID'?: string;
 }
-export declare namespace AgentCreateInvitationsParams {
-    interface Agent {
-        agentId: string;
-        permissions: Array<string>;
-        limits?: Agent.Limits;
+export declare namespace AgentCreateCustomerParams {
+    interface UnionMember0 {
+        type: string;
+        /**
+         * Email address
+         */
+        value: string;
     }
-    namespace Agent {
-        interface Limits {
-            /**
-             * Per-transaction cap, integer cents (USD).
-             */
-            perTransaction?: number | null;
-        }
+    interface UnionMember1 {
+        type: string;
+        /**
+         * Phone number in E.164 format
+         */
+        value: string;
+    }
+    /**
+     * Optional per-transaction limit
+     */
+    interface Limits {
+        /**
+         * Per-transaction cap, integer cents (USD).
+         */
+        perTransaction?: number | null;
     }
 }
 export interface AgentGetParams {
@@ -1190,27 +1453,30 @@ export interface AgentGetParams {
      */
     'X-Instance-ID'?: string;
 }
-export interface AgentListInvitationsForDeveloperParams {
+export interface AgentGetCustomerParams {
     /**
-     * Query param
+     * Path param: Agent ID
      */
-    agentId?: string;
+    agentId: string;
     /**
-     * Query param
+     * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
      */
-    cursor?: string;
+    'X-Agent-ID'?: string;
     /**
-     * Query param
+     * Header param: Required when X-Agent-ID is present. Session or conversation ID
+     * for agent observability.
      */
-    customerEmail?: string;
+    'X-Instance-ID'?: string;
+}
+export interface AgentListCustomersParams {
     /**
      * Query param
      */
-    limit?: number;
+    cursor?: string;
     /**
      * Query param
      */
-    status?: Array<'PENDING' | 'ACCEPTED' | 'DECLINED' | 'EXPIRED' | 'CANCELLED'>;
+    limit?: number;
     /**
      * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
      */
@@ -1237,7 +1503,27 @@ export interface AgentRemoveParams {
      */
     'X-Instance-ID'?: string;
 }
+export interface AgentRemoveCustomerParams {
+    /**
+     * Path param: Agent ID
+     */
+    agentId: string;
+    /**
+     * Header param: Unique key for idempotent request handling. If a request with the
+     * same key was already processed, the original response is returned.
+     */
+    'Idempotency-Key': string;
+    /**
+     * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
+     */
+    'X-Agent-ID'?: string;
+    /**
+     * Header param: Required when X-Agent-ID is present. Session or conversation ID
+     * for agent observability.
+     */
+    'X-Instance-ID'?: string;
+}
 export declare namespace Agents {
-    export { type AgentCreateResponse as AgentCreateResponse, type AgentUpdateResponse as AgentUpdateResponse, type AgentListResponse as AgentListResponse, type AgentCreateInvitationsResponse as AgentCreateInvitationsResponse, type AgentGetResponse as AgentGetResponse, type AgentListInvitationsForDeveloperResponse as AgentListInvitationsForDeveloperResponse, type AgentRemoveResponse as AgentRemoveResponse, type AgentCreateParams as AgentCreateParams, type AgentUpdateParams as AgentUpdateParams, type AgentListParams as AgentListParams, type AgentCreateInvitationsParams as AgentCreateInvitationsParams, type AgentGetParams as AgentGetParams, type AgentListInvitationsForDeveloperParams as AgentListInvitationsForDeveloperParams, type AgentRemoveParams as AgentRemoveParams, };
+    export { type AgentCreateResponse as AgentCreateResponse, type AgentUpdateResponse as AgentUpdateResponse, type AgentListResponse as AgentListResponse, type AgentCreateCustomerResponse as AgentCreateCustomerResponse, type AgentGetResponse as AgentGetResponse, type AgentGetCustomerResponse as AgentGetCustomerResponse, type AgentListCustomersResponse as AgentListCustomersResponse, type AgentRemoveResponse as AgentRemoveResponse, type AgentRemoveCustomerResponse as AgentRemoveCustomerResponse, type AgentCreateParams as AgentCreateParams, type AgentUpdateParams as AgentUpdateParams, type AgentListParams as AgentListParams, type AgentCreateCustomerParams as AgentCreateCustomerParams, type AgentGetParams as AgentGetParams, type AgentGetCustomerParams as AgentGetCustomerParams, type AgentListCustomersParams as AgentListCustomersParams, type AgentRemoveParams as AgentRemoveParams, type AgentRemoveCustomerParams as AgentRemoveCustomerParams, };
 }
 //# sourceMappingURL=agents.d.ts.map