@naturalpay/sdk 0.2.0 → 0.2.1

package/resources/agents.d.ts

@@ -0,0 +1,1392 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+/**
+ * Agent management
+ */
+export declare class Agents extends APIResource {
+    /**
+     * Create a new agent for the authenticated party.
+     *
+     * @example
+     * ```ts
+     * const agent = await client.agents.create({
+     *   name: 'x',
+     *   'Idempotency-Key': 'Idempotency-Key',
+     * });
+     * ```
+     */
+    create(params: AgentCreateParams, options?: RequestOptions): APIPromise<AgentCreateResponse>;
+    /**
+     * Update an existing agent's mutable fields or revoke it.
+     *
+     * @example
+     * ```ts
+     * const agent = await client.agents.update(
+     *   'agt_ecc2efdd09bd231a9ad9bd2aada37aa7',
+     *   { 'Idempotency-Key': 'Idempotency-Key' },
+     * );
+     * ```
+     */
+    update(agentID: string, params: AgentUpdateParams, options?: RequestOptions): APIPromise<AgentUpdateResponse>;
+    /**
+     * List agents for the authenticated user's party.
+     *
+     * @example
+     * ```ts
+     * const agents = await client.agents.list();
+     * ```
+     */
+    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.
+     *
+     * @example
+     * ```ts
+     * const response = await client.agents.createInvitations({
+     *   agents: [
+     *     {
+     *       agentId: 'agt_ecc2efdd09bd231a9ad9bd2aada37aa7',
+     *       permissions: ['string'],
+     *     },
+     *   ],
+     *   customerEmail: 'dev@stainless.com',
+     *   'Idempotency-Key': 'Idempotency-Key',
+     * });
+     * ```
+     */
+    createInvitations(params: AgentCreateInvitationsParams, options?: RequestOptions): APIPromise<AgentCreateInvitationsResponse>;
+    /**
+     * Get agent details by its unique ID.
+     *
+     * @example
+     * ```ts
+     * const agent = await client.agents.get(
+     *   'agt_ecc2efdd09bd231a9ad9bd2aada37aa7',
+     * );
+     * ```
+     */
+    get(agentID: string, params?: AgentGetParams | null | undefined, options?: RequestOptions): APIPromise<AgentGetResponse>;
+    /**
+     * List agent delegation invitations
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.agents.listInvitationsForDeveloper();
+     * ```
+     */
+    listInvitationsForDeveloper(params?: AgentListInvitationsForDeveloperParams | null | undefined, options?: RequestOptions): APIPromise<AgentListInvitationsForDeveloperResponse>;
+    /**
+     * Delete an agent and clean up its delegations and policies.
+     *
+     * @example
+     * ```ts
+     * const agent = await client.agents.remove(
+     *   'agt_ecc2efdd09bd231a9ad9bd2aada37aa7',
+     *   { 'Idempotency-Key': 'Idempotency-Key' },
+     * );
+     * ```
+     */
+    remove(agentID: string, params: AgentRemoveParams, options?: RequestOptions): APIPromise<AgentRemoveResponse>;
+}
+export interface AgentCreateResponse {
+    data: AgentCreateResponse.Data;
+}
+export declare namespace AgentCreateResponse {
+    interface Data {
+        /**
+         * Resource ID
+         */
+        id: string;
+        /**
+         * Resource attributes
+         */
+        attributes: Data.Attributes;
+        /**
+         * Resource relationships
+         */
+        relationships: Data.Relationships;
+        /**
+         * Resource type
+         */
+        type: string;
+    }
+    namespace Data {
+        /**
+         * Resource attributes
+         */
+        interface Attributes {
+            /**
+             * When this agent was created
+             */
+            createdAt: string | null;
+            /**
+             * User who created this agent (usr\_\*)
+             */
+            createdBy: string | null;
+            /**
+             * Agent description
+             */
+            description: string | null;
+            /**
+             * Per-transaction spend cap for actions this agent initiates on its owner's party.
+             * null = no limit. Stored as Policy(scope=Agent(id)) in the policy service.
+             */
+            limits: Attributes.Limits | null;
+            /**
+             * Agent display name
+             */
+            name: string;
+            /**
+             * Observability stats (null when unavailable)
+             */
+            observability: Attributes.Observability | null;
+            /**
+             * Agent status
+             */
+            status: 'ACTIVE' | 'REVOKED';
+            /**
+             * When this agent was last updated
+             */
+            updatedAt: string | null;
+            /**
+             * User who last updated this agent (usr\_\*)
+             */
+            updatedBy: string | null;
+        }
+        namespace Attributes {
+            /**
+             * Per-transaction spend cap for actions this agent initiates on its owner's party.
+             * null = no limit. Stored as Policy(scope=Agent(id)) in the policy service.
+             */
+            interface Limits {
+                /**
+                 * Positive per-transaction limit in cents. null means no per-payment limit.
+                 */
+                perTransaction?: number | null;
+            }
+            /**
+             * Observability stats (null when unavailable)
+             */
+            interface Observability {
+                /**
+                 * Errors in last 24h
+                 */
+                errorCount: number;
+                /**
+                 * Last activity timestamp
+                 */
+                lastActiveAt: string | null;
+                /**
+                 * Requests in last 24h
+                 */
+                requestCount: number;
+            }
+        }
+        /**
+         * Resource relationships
+         */
+        interface Relationships {
+            /**
+             * Party that owns the agent
+             */
+            party: Relationships.Party;
+        }
+        namespace Relationships {
+            /**
+             * Party that owns the agent
+             */
+            interface Party {
+                /**
+                 * Related resource identifier
+                 */
+                data: Party.Data;
+            }
+            namespace Party {
+                /**
+                 * Related resource identifier
+                 */
+                interface Data {
+                    id: string;
+                    /**
+                     * Resource type
+                     */
+                    type: string;
+                }
+            }
+        }
+    }
+}
+export interface AgentUpdateResponse {
+    data: AgentUpdateResponse.Data;
+}
+export declare namespace AgentUpdateResponse {
+    interface Data {
+        /**
+         * Resource ID
+         */
+        id: string;
+        /**
+         * Resource attributes
+         */
+        attributes: Data.Attributes;
+        /**
+         * Resource relationships
+         */
+        relationships: Data.Relationships;
+        /**
+         * Resource type
+         */
+        type: string;
+    }
+    namespace Data {
+        /**
+         * Resource attributes
+         */
+        interface Attributes {
+            /**
+             * When this agent was created
+             */
+            createdAt: string | null;
+            /**
+             * User who created this agent (usr\_\*)
+             */
+            createdBy: string | null;
+            /**
+             * Agent description
+             */
+            description: string | null;
+            /**
+             * Per-transaction spend cap for actions this agent initiates on its owner's party.
+             * null = no limit. Stored as Policy(scope=Agent(id)) in the policy service.
+             */
+            limits: Attributes.Limits | null;
+            /**
+             * Agent display name
+             */
+            name: string;
+            /**
+             * Observability stats (null when unavailable)
+             */
+            observability: Attributes.Observability | null;
+            /**
+             * Agent status
+             */
+            status: 'ACTIVE' | 'REVOKED';
+            /**
+             * When this agent was last updated
+             */
+            updatedAt: string | null;
+            /**
+             * User who last updated this agent (usr\_\*)
+             */
+            updatedBy: string | null;
+        }
+        namespace Attributes {
+            /**
+             * Per-transaction spend cap for actions this agent initiates on its owner's party.
+             * null = no limit. Stored as Policy(scope=Agent(id)) in the policy service.
+             */
+            interface Limits {
+                /**
+                 * Positive per-transaction limit in cents. null means no per-payment limit.
+                 */
+                perTransaction?: number | null;
+            }
+            /**
+             * Observability stats (null when unavailable)
+             */
+            interface Observability {
+                /**
+                 * Errors in last 24h
+                 */
+                errorCount: number;
+                /**
+                 * Last activity timestamp
+                 */
+                lastActiveAt: string | null;
+                /**
+                 * Requests in last 24h
+                 */
+                requestCount: number;
+            }
+        }
+        /**
+         * Resource relationships
+         */
+        interface Relationships {
+            /**
+             * Party that owns the agent
+             */
+            party: Relationships.Party;
+        }
+        namespace Relationships {
+            /**
+             * Party that owns the agent
+             */
+            interface Party {
+                /**
+                 * Related resource identifier
+                 */
+                data: Party.Data;
+            }
+            namespace Party {
+                /**
+                 * Related resource identifier
+                 */
+                interface Data {
+                    id: string;
+                    /**
+                     * Resource type
+                     */
+                    type: string;
+                }
+            }
+        }
+    }
+}
+export interface AgentListResponse {
+    data: Array<AgentListResponse.Data>;
+    meta: AgentListResponse.Meta;
+}
+export declare namespace AgentListResponse {
+    interface Data {
+        /**
+         * Resource ID
+         */
+        id: string;
+        /**
+         * Resource attributes
+         */
+        attributes: Data.Attributes;
+        /**
+         * Resource relationships
+         */
+        relationships: Data.Relationships;
+        /**
+         * Resource type
+         */
+        type: string;
+    }
+    namespace Data {
+        /**
+         * Resource attributes
+         */
+        interface Attributes {
+            /**
+             * When this agent was created
+             */
+            createdAt: string | null;
+            /**
+             * User who created this agent (usr\_\*)
+             */
+            createdBy: string | null;
+            /**
+             * Agent description
+             */
+            description: string | null;
+            /**
+             * Per-transaction spend cap for actions this agent initiates on its owner's party.
+             * null = no limit. Stored as Policy(scope=Agent(id)) in the policy service.
+             */
+            limits: Attributes.Limits | null;
+            /**
+             * Agent display name
+             */
+            name: string;
+            /**
+             * Observability stats (null when unavailable)
+             */
+            observability: Attributes.Observability | null;
+            /**
+             * Agent status
+             */
+            status: 'ACTIVE' | 'REVOKED';
+            /**
+             * When this agent was last updated
+             */
+            updatedAt: string | null;
+            /**
+             * User who last updated this agent (usr\_\*)
+             */
+            updatedBy: string | null;
+        }
+        namespace Attributes {
+            /**
+             * Per-transaction spend cap for actions this agent initiates on its owner's party.
+             * null = no limit. Stored as Policy(scope=Agent(id)) in the policy service.
+             */
+            interface Limits {
+                /**
+                 * Positive per-transaction limit in cents. null means no per-payment limit.
+                 */
+                perTransaction?: number | null;
+            }
+            /**
+             * Observability stats (null when unavailable)
+             */
+            interface Observability {
+                /**
+                 * Errors in last 24h
+                 */
+                errorCount: number;
+                /**
+                 * Last activity timestamp
+                 */
+                lastActiveAt: string | null;
+                /**
+                 * Requests in last 24h
+                 */
+                requestCount: number;
+            }
+        }
+        /**
+         * Resource relationships
+         */
+        interface Relationships {
+            /**
+             * Party that owns the agent
+             */
+            party: Relationships.Party;
+        }
+        namespace Relationships {
+            /**
+             * Party that owns the agent
+             */
+            interface Party {
+                /**
+                 * Related resource identifier
+                 */
+                data: Party.Data;
+            }
+            namespace Party {
+                /**
+                 * Related resource identifier
+                 */
+                interface Data {
+                    id: string;
+                    /**
+                     * Resource type
+                     */
+                    type: string;
+                }
+            }
+        }
+    }
+    interface Meta {
+        pagination: Meta.Pagination;
+    }
+    namespace Meta {
+        interface Pagination {
+            hasMore: boolean;
+            nextCursor: string | null;
+        }
+    }
+}
+export interface AgentCreateInvitationsResponse {
+    /**
+     * Successfully created invitation resources
+     */
+    data: Array<AgentCreateInvitationsResponse.Data>;
+    /**
+     * Batch invitation metadata
+     */
+    meta: AgentCreateInvitationsResponse.Meta;
+}
+export declare namespace AgentCreateInvitationsResponse {
+    interface Data {
+        /**
+         * Invitation ID (adi\_\*)
+         */
+        id: string;
+        /**
+         * Resource attributes
+         */
+        attributes: Data.Attributes;
+        /**
+         * Related resource identifiers
+         */
+        relationships: Data.Relationships;
+        /**
+         * Resource type
+         */
+        type: string;
+    }
+    namespace Data {
+        /**
+         * Resource 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
+             */
+            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;
+            }
+        }
+        /**
+         * Related resource identifiers
+         */
+        interface Relationships {
+            /**
+             * Agent being delegated
+             */
+            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)
+             */
+            customerParty: Relationships.CustomerParty;
+            /**
+             * Developer party that issued the invitation
+             */
+            developerParty: Relationships.DeveloperParty;
+        }
+        namespace Relationships {
+            /**
+             * Agent being delegated
+             */
+            interface Agent {
+                /**
+                 * Related resource identifier
+                 */
+                data: Agent.Data;
+            }
+            namespace Agent {
+                /**
+                 * Related resource identifier
+                 */
+                interface Data {
+                    id: string;
+                    /**
+                     * 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;
+                    /**
+                     * Resource type
+                     */
+                    type: string;
+                }
+            }
+            /**
+             * Customer party the invitation was accepted on (null until accept)
+             */
+            interface CustomerParty {
+                /**
+                 * Related resource identifier
+                 */
+                data: CustomerParty.Data | null;
+            }
+            namespace CustomerParty {
+                /**
+                 * Related resource identifier
+                 */
+                interface Data {
+                    id: string;
+                    /**
+                     * Resource type
+                     */
+                    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;
+                }
+            }
+        }
+    }
+    /**
+     * Batch invitation metadata
+     */
+    interface Meta {
+        /**
+         * Invitation IDs whose welcome-email send failed. Invitations are still persisted;
+         * use the resend-email flow to retry.
+         */
+        emailFailures: Array<string>;
+    }
+}
+export interface AgentGetResponse {
+    data: AgentGetResponse.Data;
+}
+export declare namespace AgentGetResponse {
+    interface Data {
+        /**
+         * Resource ID
+         */
+        id: string;
+        /**
+         * Resource attributes
+         */
+        attributes: Data.Attributes;
+        /**
+         * Resource relationships
+         */
+        relationships: Data.Relationships;
+        /**
+         * Resource type
+         */
+        type: string;
+    }
+    namespace Data {
+        /**
+         * Resource attributes
+         */
+        interface Attributes {
+            /**
+             * When this agent was created
+             */
+            createdAt: string | null;
+            /**
+             * User who created this agent (usr\_\*)
+             */
+            createdBy: string | null;
+            /**
+             * Agent description
+             */
+            description: string | null;
+            /**
+             * Per-transaction spend cap for actions this agent initiates on its owner's party.
+             * null = no limit. Stored as Policy(scope=Agent(id)) in the policy service.
+             */
+            limits: Attributes.Limits | null;
+            /**
+             * Agent display name
+             */
+            name: string;
+            /**
+             * Observability stats (null when unavailable)
+             */
+            observability: Attributes.Observability | null;
+            /**
+             * Agent status
+             */
+            status: 'ACTIVE' | 'REVOKED';
+            /**
+             * When this agent was last updated
+             */
+            updatedAt: string | null;
+            /**
+             * User who last updated this agent (usr\_\*)
+             */
+            updatedBy: string | null;
+        }
+        namespace Attributes {
+            /**
+             * Per-transaction spend cap for actions this agent initiates on its owner's party.
+             * null = no limit. Stored as Policy(scope=Agent(id)) in the policy service.
+             */
+            interface Limits {
+                /**
+                 * Positive per-transaction limit in cents. null means no per-payment limit.
+                 */
+                perTransaction?: number | null;
+            }
+            /**
+             * Observability stats (null when unavailable)
+             */
+            interface Observability {
+                /**
+                 * Errors in last 24h
+                 */
+                errorCount: number;
+                /**
+                 * Last activity timestamp
+                 */
+                lastActiveAt: string | null;
+                /**
+                 * Requests in last 24h
+                 */
+                requestCount: number;
+            }
+        }
+        /**
+         * Resource relationships
+         */
+        interface Relationships {
+            /**
+             * Party that owns the agent
+             */
+            party: Relationships.Party;
+        }
+        namespace Relationships {
+            /**
+             * Party that owns the agent
+             */
+            interface Party {
+                /**
+                 * Related resource identifier
+                 */
+                data: Party.Data;
+            }
+            namespace Party {
+                /**
+                 * Related resource identifier
+                 */
+                interface Data {
+                    id: string;
+                    /**
+                     * Resource type
+                     */
+                    type: string;
+                }
+            }
+        }
+    }
+}
+export interface AgentListInvitationsForDeveloperResponse {
+    data: Array<AgentListInvitationsForDeveloperResponse.Data>;
+    meta: AgentListInvitationsForDeveloperResponse.Meta;
+}
+export declare namespace AgentListInvitationsForDeveloperResponse {
+    interface Data {
+        /**
+         * Invitation ID (adi\_\*)
+         */
+        id: string;
+        /**
+         * Resource attributes
+         */
+        attributes: Data.Attributes;
+        /**
+         * Related resource identifiers
+         */
+        relationships: Data.Relationships;
+        /**
+         * Resource type
+         */
+        type: string;
+    }
+    namespace Data {
+        /**
+         * Resource 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
+             */
+            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;
+            }
+        }
+        /**
+         * Related resource identifiers
+         */
+        interface Relationships {
+            /**
+             * Agent being delegated
+             */
+            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)
+             */
+            customerParty: Relationships.CustomerParty;
+            /**
+             * Developer party that issued the invitation
+             */
+            developerParty: Relationships.DeveloperParty;
+        }
+        namespace Relationships {
+            /**
+             * Agent being delegated
+             */
+            interface Agent {
+                /**
+                 * Related resource identifier
+                 */
+                data: Agent.Data;
+            }
+            namespace Agent {
+                /**
+                 * Related resource identifier
+                 */
+                interface Data {
+                    id: string;
+                    /**
+                     * 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;
+                    /**
+                     * Resource type
+                     */
+                    type: string;
+                }
+            }
+            /**
+             * Customer party the invitation was accepted on (null until accept)
+             */
+            interface CustomerParty {
+                /**
+                 * Related resource identifier
+                 */
+                data: CustomerParty.Data | null;
+            }
+            namespace CustomerParty {
+                /**
+                 * Related resource identifier
+                 */
+                interface Data {
+                    id: string;
+                    /**
+                     * Resource type
+                     */
+                    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;
+                }
+            }
+        }
+    }
+    interface Meta {
+        pagination: Meta.Pagination;
+    }
+    namespace Meta {
+        interface Pagination {
+            hasMore: boolean;
+            nextCursor: string | null;
+        }
+    }
+}
+export interface AgentRemoveResponse {
+    data: AgentRemoveResponse.Data;
+    meta: AgentRemoveResponse.Meta;
+}
+export declare namespace AgentRemoveResponse {
+    interface Data {
+        /**
+         * Resource ID
+         */
+        id: string;
+        /**
+         * Resource attributes
+         */
+        attributes: Data.Attributes;
+        /**
+         * Resource relationships
+         */
+        relationships: Data.Relationships;
+        /**
+         * Resource type
+         */
+        type: string;
+    }
+    namespace Data {
+        /**
+         * Resource attributes
+         */
+        interface Attributes {
+            /**
+             * When this agent was created
+             */
+            createdAt: string | null;
+            /**
+             * User who created this agent (usr\_\*)
+             */
+            createdBy: string | null;
+            /**
+             * Agent description
+             */
+            description: string | null;
+            /**
+             * Per-transaction spend cap for actions this agent initiates on its owner's party.
+             * null = no limit. Stored as Policy(scope=Agent(id)) in the policy service.
+             */
+            limits: Attributes.Limits | null;
+            /**
+             * Agent display name
+             */
+            name: string;
+            /**
+             * Observability stats (null when unavailable)
+             */
+            observability: Attributes.Observability | null;
+            /**
+             * Agent status
+             */
+            status: 'ACTIVE' | 'REVOKED';
+            /**
+             * When this agent was last updated
+             */
+            updatedAt: string | null;
+            /**
+             * User who last updated this agent (usr\_\*)
+             */
+            updatedBy: string | null;
+        }
+        namespace Attributes {
+            /**
+             * Per-transaction spend cap for actions this agent initiates on its owner's party.
+             * null = no limit. Stored as Policy(scope=Agent(id)) in the policy service.
+             */
+            interface Limits {
+                /**
+                 * Positive per-transaction limit in cents. null means no per-payment limit.
+                 */
+                perTransaction?: number | null;
+            }
+            /**
+             * Observability stats (null when unavailable)
+             */
+            interface Observability {
+                /**
+                 * Errors in last 24h
+                 */
+                errorCount: number;
+                /**
+                 * Last activity timestamp
+                 */
+                lastActiveAt: string | null;
+                /**
+                 * Requests in last 24h
+                 */
+                requestCount: number;
+            }
+        }
+        /**
+         * Resource relationships
+         */
+        interface Relationships {
+            /**
+             * Party that owns the agent
+             */
+            party: Relationships.Party;
+        }
+        namespace Relationships {
+            /**
+             * Party that owns the agent
+             */
+            interface Party {
+                /**
+                 * Related resource identifier
+                 */
+                data: Party.Data;
+            }
+            namespace Party {
+                /**
+                 * Related resource identifier
+                 */
+                interface Data {
+                    id: string;
+                    /**
+                     * Resource type
+                     */
+                    type: string;
+                }
+            }
+        }
+    }
+    interface Meta {
+        /**
+         * Indicates the resource was deleted
+         */
+        deleted: true;
+    }
+}
+export interface AgentCreateParams {
+    /**
+     * Body param: Agent display name
+     */
+    name: 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;
+    /**
+     * Body param: Agent description
+     */
+    description?: string;
+    /**
+     * Body param: Optional per-transaction limit for the agent
+     */
+    limits?: AgentCreateParams.Limits;
+    /**
+     * 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 AgentCreateParams {
+    /**
+     * Optional per-transaction limit for the agent
+     */
+    interface Limits {
+        /**
+         * Positive per-transaction limit in cents. null means no per-payment limit.
+         */
+        perTransaction?: number | null;
+    }
+}
+export interface AgentUpdateParams {
+    /**
+     * 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;
+    /**
+     * Body param: Updated description
+     */
+    description?: string | null;
+    /**
+     * Body param: Per-transaction spend cap. null clears the limit; omitted leaves it
+     * unchanged.
+     */
+    limits?: AgentUpdateParams.Limits | null;
+    /**
+     * Body param: Updated name for the agent
+     */
+    name?: string | null;
+    /**
+     * Body param: Updated status
+     */
+    status?: 'ACTIVE' | 'REVOKED' | null;
+    /**
+     * 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 AgentUpdateParams {
+    /**
+     * Per-transaction spend cap. null clears the limit; omitted leaves it unchanged.
+     */
+    interface Limits {
+        /**
+         * Positive per-transaction limit in cents. null means no per-payment limit.
+         */
+        perTransaction?: number | null;
+    }
+}
+export interface AgentListParams {
+    /**
+     * Query param: Cursor for the next page
+     */
+    cursor?: string;
+    /**
+     * Query param: Maximum number of agents to return
+     */
+    limit?: number;
+    /**
+     * Query param: Filter by status
+     */
+    status?: 'ACTIVE' | 'REVOKED';
+    /**
+     * 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 interface AgentCreateInvitationsParams {
+    /**
+     * Body param: Per-agent delegation requests (1-50)
+     */
+    agents: Array<AgentCreateInvitationsParams.Agent>;
+    /**
+     * Body param: Email address of the customer to invite
+     */
+    customerEmail: 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;
+    /**
+     * Body param: Optional explicit expiry timestamp; server defaults to 7 days
+     */
+    expiresAt?: 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 AgentCreateInvitationsParams {
+    interface Agent {
+        agentId: string;
+        permissions: Array<string>;
+        limits?: Agent.Limits;
+    }
+    namespace Agent {
+        interface Limits {
+            /**
+             * Per-transaction cap, integer cents (USD).
+             */
+            perTransaction?: number | null;
+        }
+    }
+}
+export interface AgentGetParams {
+    /**
+     * Agent ID (agt_xxx) identifying which agent is making the request.
+     */
+    'X-Agent-ID'?: string;
+    /**
+     * Required when X-Agent-ID is present. Session or conversation ID for agent
+     * observability.
+     */
+    'X-Instance-ID'?: string;
+}
+export interface AgentListInvitationsForDeveloperParams {
+    /**
+     * Query param
+     */
+    agentId?: string;
+    /**
+     * Query param
+     */
+    cursor?: string;
+    /**
+     * Query param
+     */
+    customerEmail?: string;
+    /**
+     * Query param
+     */
+    limit?: number;
+    /**
+     * Query param
+     */
+    status?: Array<'PENDING' | 'ACCEPTED' | 'DECLINED' | 'EXPIRED' | 'CANCELLED'>;
+    /**
+     * 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 interface AgentRemoveParams {
+    /**
+     * Unique key for idempotent request handling. If a request with the same key was
+     * already processed, the original response is returned.
+     */
+    'Idempotency-Key': string;
+    /**
+     * Agent ID (agt_xxx) identifying which agent is making the request.
+     */
+    'X-Agent-ID'?: string;
+    /**
+     * 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, };
+}
+//# sourceMappingURL=agents.d.ts.map