@naturalpay/sdk 0.3.0 → 0.5.0

package/src/resources/agents.ts

@@ -105,34 +105,34 @@ export class Agents extends APIResource {
   }
 
   /**
-   * 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,
+  createCustomer(
+    agentID: string,
+    params: AgentCreateCustomerParams,
     options?: RequestOptions,
-  ): APIPromise<AgentCreateInvitationsResponse> {
+  ): APIPromise<AgentCreateCustomerResponse> {
     const {
       'Idempotency-Key': idempotencyKey,
       'X-Agent-ID': xAgentID,
       'X-Instance-ID': xInstanceID,
       ...body
     } = params;
-    return this._client.post('/agents/invitations', {
+    return this._client.post(path`/agents/${agentID}/customers`, {
       body,
       ...options,
       headers: buildHeaders([
@@ -175,20 +175,51 @@ export class Agents extends APIResource {
   }
 
   /**
-   * 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> {
+    const { agentId, 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID } = params;
+    return this._client.get(path`/agents/${agentId}/customers/${customerID}`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * 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 = {},
+  listCustomers(
+    agentID: string,
+    params: AgentListCustomersParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<AgentListInvitationsForDeveloperResponse> {
+  ): APIPromise<AgentListCustomersResponse> {
     const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params ?? {};
-    return this._client.get('/agents/invitations', {
+    return this._client.get(path`/agents/${agentID}/customers`, {
       query,
       ...options,
       headers: buildHeaders([
@@ -202,7 +233,7 @@ export class Agents extends APIResource {
   }
 
   /**
-   * Revoke an agent.
+   * Delete an agent. Deleting an agent revokes it and cleans up active access.
    *
    * @example
    * ```ts
@@ -234,6 +265,44 @@ export class Agents extends APIResource {
       ]),
     });
   }
+
+  /**
+   * 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> {
+    const {
+      agentId,
+      'Idempotency-Key': idempotencyKey,
+      'X-Agent-ID': xAgentID,
+      'X-Instance-ID': xInstanceID,
+    } = params;
+    return this._client.delete(path`/agents/${agentId}/customers/${customerID}`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          'Idempotency-Key': idempotencyKey,
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
 }
 
 export interface AgentCreateResponse {
@@ -595,32 +664,32 @@ export 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 namespace AgentCreateInvitationsResponse {
+export namespace AgentCreateCustomerResponse {
   export 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;
 
@@ -632,78 +701,48 @@ export namespace AgentCreateInvitationsResponse {
 
   export namespace Data {
     /**
-     * Resource attributes
+     * Invitation attributes
      */
     export 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;
     }
 
     export namespace Attributes {
       /**
-       * Per-agent transaction limits
+       * Requested per-agent customer limits
        */
       export interface Limits {
         /**
@@ -711,119 +750,112 @@ export namespace AgentCreateInvitationsResponse {
          */
         perTransaction?: number | null;
       }
+
+      export interface UnionMember0 {
+        type: string;
+
+        /**
+         * Email address
+         */
+        value: string;
+      }
+
+      export interface UnionMember1 {
+        type: string;
+
+        /**
+         * Phone number in E.164 format
+         */
+        value: string;
+      }
+
+      export interface UnionMember2 {
+        type: string;
+
+        /**
+         * Natural party ID (pty\_\*)
+         */
+        value: string;
+      }
     }
 
     /**
-     * Related resource identifiers
+     * Related agent and customer party
      */
     export 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;
     }
 
     export namespace Relationships {
       /**
-       * Agent being delegated
+       * Agent attached to this invitation
        */
       export interface Agent {
-        /**
-         * Related resource identifier
-         */
         data: Agent.Data;
       }
 
       export namespace Agent {
-        /**
-         * Related resource identifier
-         */
         export interface Data {
+          /**
+           * Agent ID (agt\_\*)
+           */
           id: string;
 
           /**
-           * Resource type
+           * Agent attributes
            */
-          type: string;
-        }
-      }
-
-      /**
-       * Resulting agent delegation once accepted; currently null on public create/list
-       * responses
-       */
-      export interface AgentDelegation {
-        /**
-         * Related resource identifier
-         */
-        data: AgentDelegation.Data | null;
-      }
-
-      export namespace AgentDelegation {
-        /**
-         * Related resource identifier
-         */
-        export interface Data {
-          id: string;
+          attributes: Data.Attributes;
 
           /**
            * Resource type
            */
           type: string;
         }
-      }
-
-      /**
-       * Customer party the invitation was accepted on (null until accept)
-       */
-      export interface CustomerParty {
-        /**
-         * Related resource identifier
-         */
-        data: CustomerParty.Data | null;
-      }
-
-      export namespace CustomerParty {
-        /**
-         * Related resource identifier
-         */
-        export interface Data {
-          id: string;
 
+        export namespace Data {
           /**
-           * Resource type
+           * Agent attributes
            */
-          type: string;
+          export interface Attributes {
+            /**
+             * Agent description
+             */
+            description: string | null;
+
+            /**
+             * Agent display name
+             */
+            name: string | null;
+
+            /**
+             * Agent status
+             */
+            status: 'ACTIVE' | 'REVOKED';
+          }
         }
       }
 
       /**
-       * Developer party that issued the invitation
+       * Customer party when the recipient is an existing party or once the invitation is
+       * accepted
        */
-      export interface DeveloperParty {
+      export interface CustomerParty {
         /**
          * Related resource identifier
          */
-        data: DeveloperParty.Data;
+        data: CustomerParty.Data | null;
       }
 
-      export namespace DeveloperParty {
+      export namespace CustomerParty {
         /**
          * Related resource identifier
          */
@@ -966,26 +998,24 @@ export namespace AgentGetResponse {
   }
 }
 
-export interface AgentListInvitationsForDeveloperResponse {
-  data: Array<AgentListInvitationsForDeveloperResponse.Data>;
-
-  meta: AgentListInvitationsForDeveloperResponse.Meta;
+export interface AgentGetCustomerResponse {
+  data: AgentGetCustomerResponse.Data;
 }
 
-export namespace AgentListInvitationsForDeveloperResponse {
+export namespace AgentGetCustomerResponse {
   export 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;
 
@@ -997,208 +1027,323 @@ export namespace AgentListInvitationsForDeveloperResponse {
 
   export namespace Data {
     /**
-     * Resource attributes
+     * Customer party attributes
      */
     export 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;
+      type: string;
+    }
 
+    /**
+     * Related agent and access details
+     */
+    export interface Relationships {
       /**
-       * When this invitation was created
+       * This agent's access state for the customer
        */
-      createdAt: string;
+      access: Relationships.Access;
 
       /**
-       * When this invitation was declined
+       * Agent attached to this customer
        */
-      declinedAt: string | null;
+      agent: Relationships.Agent;
+    }
 
+    export namespace Relationships {
       /**
-       * Display name of the developer party
+       * This agent's access state for the customer
        */
-      developerName: string;
+      export interface Access {
+        data: Access.Data;
+      }
 
-      /**
-       * Status after applying expiry and cancel-reason overlays
-       */
-      effectiveStatus: 'PENDING' | 'ACCEPTED' | 'DECLINED' | 'EXPIRED' | 'CANCELLED';
+      export namespace Access {
+        export interface Data {
+          /**
+           * Underlying access record ID
+           */
+          id: string;
 
-      /**
-       * Customer email the invitation was sent to
-       */
-      email: string;
+          /**
+           * Access attributes
+           */
+          attributes: Data.Attributes;
 
-      /**
-       * When this invitation expires
-       */
-      expiresAt: string;
+          /**
+           * Resource type
+           */
+          type: string;
+        }
 
-      /**
-       * Per-agent transaction limits
-       */
-      limits: Attributes.Limits | null;
+        export namespace Data {
+          /**
+           * Access attributes
+           */
+          export 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;
+          }
+
+          export namespace Attributes {
+            /**
+             * Per-agent customer transaction limits
+             */
+            export interface Limits {
+              /**
+               * Per-transaction cap, integer cents (USD).
+               */
+              perTransaction?: number | null;
+            }
+          }
+        }
+      }
 
       /**
-       * Permissions the agent will hold on accept
+       * Agent attached to this customer
        */
-      permissions: Array<string>;
+      export interface Agent {
+        data: Agent.Data;
+      }
 
-      /**
-       * Raw persisted status
-       */
-      status: 'PENDING' | 'ACCEPTED' | 'DECLINED' | 'EXPIRED' | 'CANCELLED';
+      export namespace Agent {
+        export interface Data {
+          /**
+           * Agent ID (agt\_\*)
+           */
+          id: string;
 
-      /**
-       * When this invitation was last updated
-       */
-      updatedAt: string;
-    }
+          /**
+           * Agent attributes
+           */
+          attributes: Data.Attributes;
 
-    export namespace Attributes {
-      /**
-       * Per-agent transaction limits
-       */
-      export interface Limits {
-        /**
-         * Per-transaction cap, integer cents (USD).
-         */
-        perTransaction?: number | null;
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+
+        export namespace Data {
+          /**
+           * Agent attributes
+           */
+          export interface Attributes {
+            /**
+             * Agent display name
+             */
+            name: string | null;
+          }
+        }
       }
     }
+  }
+}
+
+export interface AgentListCustomersResponse {
+  data: Array<AgentListCustomersResponse.Data>;
+
+  meta: AgentListCustomersResponse.Meta;
+}
+
+export namespace AgentListCustomersResponse {
+  export interface Data {
+    /**
+     * Customer party ID when known; otherwise the lowercased customer email
+     */
+    id: string;
 
     /**
-     * Related resource identifiers
+     * Customer party attributes
      */
-    export interface Relationships {
+    attributes: Data.Attributes;
+
+    /**
+     * Related agent and access details
+     */
+    relationships: Data.Relationships;
+
+    /**
+     * Resource type
+     */
+    type: string;
+  }
+
+  export namespace Data {
+    /**
+     * Customer party attributes
+     */
+    export interface Attributes {
       /**
-       * Agent being delegated
+       * Customer email, when known
        */
-      agent: Relationships.Agent;
+      email: string | null;
 
       /**
-       * Resulting agent delegation once accepted; currently null on public create/list
-       * responses
+       * Customer party display name, when known
        */
-      agentDelegation: Relationships.AgentDelegation;
+      name: string | null;
 
       /**
-       * Customer party the invitation was accepted on (null until accept)
+       * The customer is represented by a party
        */
-      customerParty: Relationships.CustomerParty;
+      type: string;
+    }
+
+    /**
+     * Related agent and access details
+     */
+    export interface Relationships {
+      /**
+       * This agent's access state for the customer
+       */
+      access: Relationships.Access;
 
       /**
-       * Developer party that issued the invitation
+       * Agent attached to this customer
        */
-      developerParty: Relationships.DeveloperParty;
+      agent: Relationships.Agent;
     }
 
     export namespace Relationships {
       /**
-       * Agent being delegated
+       * This agent's access state for the customer
        */
-      export interface Agent {
-        /**
-         * Related resource identifier
-         */
-        data: Agent.Data;
+      export interface Access {
+        data: Access.Data;
       }
 
-      export namespace Agent {
-        /**
-         * Related resource identifier
-         */
+      export namespace Access {
         export interface Data {
+          /**
+           * Underlying access record ID
+           */
           id: string;
 
+          /**
+           * Access attributes
+           */
+          attributes: Data.Attributes;
+
           /**
            * Resource type
            */
           type: string;
         }
-      }
-
-      /**
-       * Resulting agent delegation once accepted; currently null on public create/list
-       * responses
-       */
-      export interface AgentDelegation {
-        /**
-         * Related resource identifier
-         */
-        data: AgentDelegation.Data | null;
-      }
-
-      export namespace AgentDelegation {
-        /**
-         * Related resource identifier
-         */
-        export interface Data {
-          id: string;
 
+        export namespace Data {
           /**
-           * Resource type
+           * Access attributes
            */
-          type: string;
+          export 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;
+          }
+
+          export namespace Attributes {
+            /**
+             * Per-agent customer transaction limits
+             */
+            export interface Limits {
+              /**
+               * Per-transaction cap, integer cents (USD).
+               */
+              perTransaction?: number | null;
+            }
+          }
         }
       }
 
       /**
-       * Customer party the invitation was accepted on (null until accept)
+       * Agent attached to this customer
        */
-      export interface CustomerParty {
-        /**
-         * Related resource identifier
-         */
-        data: CustomerParty.Data | null;
+      export interface Agent {
+        data: Agent.Data;
       }
 
-      export namespace CustomerParty {
-        /**
-         * Related resource identifier
-         */
+      export namespace Agent {
         export interface Data {
+          /**
+           * Agent ID (agt\_\*)
+           */
           id: string;
 
+          /**
+           * Agent attributes
+           */
+          attributes: Data.Attributes;
+
           /**
            * Resource type
            */
           type: string;
         }
-      }
-
-      /**
-       * Developer party that issued the invitation
-       */
-      export interface DeveloperParty {
-        /**
-         * Related resource identifier
-         */
-        data: DeveloperParty.Data;
-      }
-
-      export namespace DeveloperParty {
-        /**
-         * Related resource identifier
-         */
-        export interface Data {
-          id: string;
 
+        export namespace Data {
           /**
-           * Resource type
+           * Agent attributes
            */
-          type: string;
+          export interface Attributes {
+            /**
+             * Agent display name
+             */
+            name: string | null;
+          }
         }
       }
     }
@@ -1341,6 +1486,190 @@ export namespace AgentRemoveResponse {
   }
 }
 
+export interface AgentRemoveCustomerResponse {
+  data: AgentRemoveCustomerResponse.Data;
+
+  meta: AgentRemoveCustomerResponse.Meta;
+}
+
+export namespace AgentRemoveCustomerResponse {
+  export 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;
+  }
+
+  export namespace Data {
+    /**
+     * Customer party attributes
+     */
+    export 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
+     */
+    export interface Relationships {
+      /**
+       * This agent's access state for the customer
+       */
+      access: Relationships.Access;
+
+      /**
+       * Agent attached to this customer
+       */
+      agent: Relationships.Agent;
+    }
+
+    export namespace Relationships {
+      /**
+       * This agent's access state for the customer
+       */
+      export interface Access {
+        data: Access.Data;
+      }
+
+      export namespace Access {
+        export interface Data {
+          /**
+           * Underlying access record ID
+           */
+          id: string;
+
+          /**
+           * Access attributes
+           */
+          attributes: Data.Attributes;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+
+        export namespace Data {
+          /**
+           * Access attributes
+           */
+          export 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;
+          }
+
+          export namespace Attributes {
+            /**
+             * Per-agent customer transaction limits
+             */
+            export interface Limits {
+              /**
+               * Per-transaction cap, integer cents (USD).
+               */
+              perTransaction?: number | null;
+            }
+          }
+        }
+      }
+
+      /**
+       * Agent attached to this customer
+       */
+      export interface Agent {
+        data: Agent.Data;
+      }
+
+      export namespace Agent {
+        export interface Data {
+          /**
+           * Agent ID (agt\_\*)
+           */
+          id: string;
+
+          /**
+           * Agent attributes
+           */
+          attributes: Data.Attributes;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+
+        export namespace Data {
+          /**
+           * Agent attributes
+           */
+          export interface Attributes {
+            /**
+             * Agent display name
+             */
+            name: string | null;
+          }
+        }
+      }
+    }
+  }
+
+  export interface Meta {
+    /**
+     * Indicates the resource was deleted
+     */
+    deleted: true;
+  }
+}
+
 export interface AgentCreateParams {
   /**
    * Body param: Agent display name
@@ -1462,16 +1791,16 @@ 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
@@ -1484,6 +1813,11 @@ export interface AgentCreateInvitationsParams {
    */
   expiresAt?: string;
 
+  /**
+   * Body param: Optional per-transaction limit
+   */
+  limits?: AgentCreateCustomerParams.Limits;
+
   /**
    * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
    */
@@ -1496,22 +1830,33 @@ export interface AgentCreateInvitationsParams {
   'X-Instance-ID'?: string;
 }
 
-export namespace AgentCreateInvitationsParams {
-  export interface Agent {
-    agentId: string;
+export namespace AgentCreateCustomerParams {
+  export interface UnionMember0 {
+    type: string;
 
-    permissions: Array<string>;
+    /**
+     * Email address
+     */
+    value: string;
+  }
+
+  export interface UnionMember1 {
+    type: string;
 
-    limits?: Agent.Limits;
+    /**
+     * Phone number in E.164 format
+     */
+    value: string;
   }
 
-  export namespace Agent {
-    export interface Limits {
-      /**
-       * Per-transaction cap, integer cents (USD).
-       */
-      perTransaction?: number | null;
-    }
+  /**
+   * Optional per-transaction limit
+   */
+  export interface Limits {
+    /**
+     * Per-transaction cap, integer cents (USD).
+     */
+    perTransaction?: number | null;
   }
 }
 
@@ -1528,31 +1873,34 @@ 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.
@@ -1585,21 +1933,49 @@ 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 AgentCreateCustomerResponse as AgentCreateCustomerResponse,
     type AgentGetResponse as AgentGetResponse,
-    type AgentListInvitationsForDeveloperResponse as AgentListInvitationsForDeveloperResponse,
+    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 AgentCreateInvitationsParams as AgentCreateInvitationsParams,
+    type AgentCreateCustomerParams as AgentCreateCustomerParams,
     type AgentGetParams as AgentGetParams,
-    type AgentListInvitationsForDeveloperParams as AgentListInvitationsForDeveloperParams,
+    type AgentGetCustomerParams as AgentGetCustomerParams,
+    type AgentListCustomersParams as AgentListCustomersParams,
     type AgentRemoveParams as AgentRemoveParams,
+    type AgentRemoveCustomerParams as AgentRemoveCustomerParams,
   };
 }