@naturalpay/sdk 0.2.0 → 0.2.1

package/src/resources/agents.ts

@@ -0,0 +1,1785 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+/**
+ * Agent management
+ */
+export 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> {
+    const {
+      'Idempotency-Key': idempotencyKey,
+      'X-Agent-ID': xAgentID,
+      'X-Instance-ID': xInstanceID,
+      ...body
+    } = params;
+    return this._client.post('/agents', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          'Idempotency-Key': idempotencyKey,
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * 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> {
+    const {
+      'Idempotency-Key': idempotencyKey,
+      'X-Agent-ID': xAgentID,
+      'X-Instance-ID': xInstanceID,
+      ...body
+    } = params;
+    return this._client.put(path`/agents/${agentID}`, {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          'Idempotency-Key': idempotencyKey,
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * 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> {
+    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params ?? {};
+    return this._client.get('/agents', {
+      query,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * 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> {
+    const {
+      'Idempotency-Key': idempotencyKey,
+      'X-Agent-ID': xAgentID,
+      'X-Instance-ID': xInstanceID,
+      ...body
+    } = params;
+    return this._client.post('/agents/invitations', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          'Idempotency-Key': idempotencyKey,
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * 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> {
+    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID } = params ?? {};
+    return this._client.get(path`/agents/${agentID}`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * List agent delegation invitations
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.agents.listInvitationsForDeveloper();
+   * ```
+   */
+  listInvitationsForDeveloper(
+    params: AgentListInvitationsForDeveloperParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<AgentListInvitationsForDeveloperResponse> {
+    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params ?? {};
+    return this._client.get('/agents/invitations', {
+      query,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * 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> {
+    const {
+      'Idempotency-Key': idempotencyKey,
+      'X-Agent-ID': xAgentID,
+      'X-Instance-ID': xInstanceID,
+    } = params;
+    return this._client.delete(path`/agents/${agentID}`, {
+      ...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 {
+  data: AgentCreateResponse.Data;
+}
+
+export namespace AgentCreateResponse {
+  export interface Data {
+    /**
+     * Resource ID
+     */
+    id: string;
+
+    /**
+     * Resource attributes
+     */
+    attributes: Data.Attributes;
+
+    /**
+     * Resource relationships
+     */
+    relationships: Data.Relationships;
+
+    /**
+     * Resource type
+     */
+    type: string;
+  }
+
+  export namespace Data {
+    /**
+     * Resource attributes
+     */
+    export 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;
+    }
+
+    export 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.
+       */
+      export interface Limits {
+        /**
+         * Positive per-transaction limit in cents. null means no per-payment limit.
+         */
+        perTransaction?: number | null;
+      }
+
+      /**
+       * Observability stats (null when unavailable)
+       */
+      export interface Observability {
+        /**
+         * Errors in last 24h
+         */
+        errorCount: number;
+
+        /**
+         * Last activity timestamp
+         */
+        lastActiveAt: string | null;
+
+        /**
+         * Requests in last 24h
+         */
+        requestCount: number;
+      }
+    }
+
+    /**
+     * Resource relationships
+     */
+    export interface Relationships {
+      /**
+       * Party that owns the agent
+       */
+      party: Relationships.Party;
+    }
+
+    export namespace Relationships {
+      /**
+       * Party that owns the agent
+       */
+      export interface Party {
+        /**
+         * Related resource identifier
+         */
+        data: Party.Data;
+      }
+
+      export namespace Party {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+    }
+  }
+}
+
+export interface AgentUpdateResponse {
+  data: AgentUpdateResponse.Data;
+}
+
+export namespace AgentUpdateResponse {
+  export interface Data {
+    /**
+     * Resource ID
+     */
+    id: string;
+
+    /**
+     * Resource attributes
+     */
+    attributes: Data.Attributes;
+
+    /**
+     * Resource relationships
+     */
+    relationships: Data.Relationships;
+
+    /**
+     * Resource type
+     */
+    type: string;
+  }
+
+  export namespace Data {
+    /**
+     * Resource attributes
+     */
+    export 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;
+    }
+
+    export 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.
+       */
+      export interface Limits {
+        /**
+         * Positive per-transaction limit in cents. null means no per-payment limit.
+         */
+        perTransaction?: number | null;
+      }
+
+      /**
+       * Observability stats (null when unavailable)
+       */
+      export interface Observability {
+        /**
+         * Errors in last 24h
+         */
+        errorCount: number;
+
+        /**
+         * Last activity timestamp
+         */
+        lastActiveAt: string | null;
+
+        /**
+         * Requests in last 24h
+         */
+        requestCount: number;
+      }
+    }
+
+    /**
+     * Resource relationships
+     */
+    export interface Relationships {
+      /**
+       * Party that owns the agent
+       */
+      party: Relationships.Party;
+    }
+
+    export namespace Relationships {
+      /**
+       * Party that owns the agent
+       */
+      export interface Party {
+        /**
+         * Related resource identifier
+         */
+        data: Party.Data;
+      }
+
+      export namespace Party {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+    }
+  }
+}
+
+export interface AgentListResponse {
+  data: Array<AgentListResponse.Data>;
+
+  meta: AgentListResponse.Meta;
+}
+
+export namespace AgentListResponse {
+  export interface Data {
+    /**
+     * Resource ID
+     */
+    id: string;
+
+    /**
+     * Resource attributes
+     */
+    attributes: Data.Attributes;
+
+    /**
+     * Resource relationships
+     */
+    relationships: Data.Relationships;
+
+    /**
+     * Resource type
+     */
+    type: string;
+  }
+
+  export namespace Data {
+    /**
+     * Resource attributes
+     */
+    export 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;
+    }
+
+    export 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.
+       */
+      export interface Limits {
+        /**
+         * Positive per-transaction limit in cents. null means no per-payment limit.
+         */
+        perTransaction?: number | null;
+      }
+
+      /**
+       * Observability stats (null when unavailable)
+       */
+      export interface Observability {
+        /**
+         * Errors in last 24h
+         */
+        errorCount: number;
+
+        /**
+         * Last activity timestamp
+         */
+        lastActiveAt: string | null;
+
+        /**
+         * Requests in last 24h
+         */
+        requestCount: number;
+      }
+    }
+
+    /**
+     * Resource relationships
+     */
+    export interface Relationships {
+      /**
+       * Party that owns the agent
+       */
+      party: Relationships.Party;
+    }
+
+    export namespace Relationships {
+      /**
+       * Party that owns the agent
+       */
+      export interface Party {
+        /**
+         * Related resource identifier
+         */
+        data: Party.Data;
+      }
+
+      export namespace Party {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+    }
+  }
+
+  export interface Meta {
+    pagination: Meta.Pagination;
+  }
+
+  export namespace Meta {
+    export 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 namespace AgentCreateInvitationsResponse {
+  export interface Data {
+    /**
+     * Invitation ID (adi\_\*)
+     */
+    id: string;
+
+    /**
+     * Resource attributes
+     */
+    attributes: Data.Attributes;
+
+    /**
+     * Related resource identifiers
+     */
+    relationships: Data.Relationships;
+
+    /**
+     * Resource type
+     */
+    type: string;
+  }
+
+  export namespace Data {
+    /**
+     * Resource 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
+       */
+      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;
+    }
+
+    export namespace Attributes {
+      /**
+       * Per-agent transaction limits
+       */
+      export interface Limits {
+        /**
+         * Per-transaction cap, integer cents (USD).
+         */
+        perTransaction?: number | null;
+      }
+    }
+
+    /**
+     * Related resource identifiers
+     */
+    export 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;
+    }
+
+    export namespace Relationships {
+      /**
+       * Agent being delegated
+       */
+      export interface Agent {
+        /**
+         * Related resource identifier
+         */
+        data: Agent.Data;
+      }
+
+      export namespace Agent {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * 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;
+
+          /**
+           * 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;
+
+          /**
+           * 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;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+    }
+  }
+
+  /**
+   * Batch invitation metadata
+   */
+  export 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 namespace AgentGetResponse {
+  export interface Data {
+    /**
+     * Resource ID
+     */
+    id: string;
+
+    /**
+     * Resource attributes
+     */
+    attributes: Data.Attributes;
+
+    /**
+     * Resource relationships
+     */
+    relationships: Data.Relationships;
+
+    /**
+     * Resource type
+     */
+    type: string;
+  }
+
+  export namespace Data {
+    /**
+     * Resource attributes
+     */
+    export 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;
+    }
+
+    export 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.
+       */
+      export interface Limits {
+        /**
+         * Positive per-transaction limit in cents. null means no per-payment limit.
+         */
+        perTransaction?: number | null;
+      }
+
+      /**
+       * Observability stats (null when unavailable)
+       */
+      export interface Observability {
+        /**
+         * Errors in last 24h
+         */
+        errorCount: number;
+
+        /**
+         * Last activity timestamp
+         */
+        lastActiveAt: string | null;
+
+        /**
+         * Requests in last 24h
+         */
+        requestCount: number;
+      }
+    }
+
+    /**
+     * Resource relationships
+     */
+    export interface Relationships {
+      /**
+       * Party that owns the agent
+       */
+      party: Relationships.Party;
+    }
+
+    export namespace Relationships {
+      /**
+       * Party that owns the agent
+       */
+      export interface Party {
+        /**
+         * Related resource identifier
+         */
+        data: Party.Data;
+      }
+
+      export namespace Party {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+    }
+  }
+}
+
+export interface AgentListInvitationsForDeveloperResponse {
+  data: Array<AgentListInvitationsForDeveloperResponse.Data>;
+
+  meta: AgentListInvitationsForDeveloperResponse.Meta;
+}
+
+export namespace AgentListInvitationsForDeveloperResponse {
+  export interface Data {
+    /**
+     * Invitation ID (adi\_\*)
+     */
+    id: string;
+
+    /**
+     * Resource attributes
+     */
+    attributes: Data.Attributes;
+
+    /**
+     * Related resource identifiers
+     */
+    relationships: Data.Relationships;
+
+    /**
+     * Resource type
+     */
+    type: string;
+  }
+
+  export namespace Data {
+    /**
+     * Resource 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
+       */
+      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;
+    }
+
+    export namespace Attributes {
+      /**
+       * Per-agent transaction limits
+       */
+      export interface Limits {
+        /**
+         * Per-transaction cap, integer cents (USD).
+         */
+        perTransaction?: number | null;
+      }
+    }
+
+    /**
+     * Related resource identifiers
+     */
+    export 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;
+    }
+
+    export namespace Relationships {
+      /**
+       * Agent being delegated
+       */
+      export interface Agent {
+        /**
+         * Related resource identifier
+         */
+        data: Agent.Data;
+      }
+
+      export namespace Agent {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * 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;
+
+          /**
+           * 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;
+
+          /**
+           * 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;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+    }
+  }
+
+  export interface Meta {
+    pagination: Meta.Pagination;
+  }
+
+  export namespace Meta {
+    export interface Pagination {
+      hasMore: boolean;
+
+      nextCursor: string | null;
+    }
+  }
+}
+
+export interface AgentRemoveResponse {
+  data: AgentRemoveResponse.Data;
+
+  meta: AgentRemoveResponse.Meta;
+}
+
+export namespace AgentRemoveResponse {
+  export interface Data {
+    /**
+     * Resource ID
+     */
+    id: string;
+
+    /**
+     * Resource attributes
+     */
+    attributes: Data.Attributes;
+
+    /**
+     * Resource relationships
+     */
+    relationships: Data.Relationships;
+
+    /**
+     * Resource type
+     */
+    type: string;
+  }
+
+  export namespace Data {
+    /**
+     * Resource attributes
+     */
+    export 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;
+    }
+
+    export 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.
+       */
+      export interface Limits {
+        /**
+         * Positive per-transaction limit in cents. null means no per-payment limit.
+         */
+        perTransaction?: number | null;
+      }
+
+      /**
+       * Observability stats (null when unavailable)
+       */
+      export interface Observability {
+        /**
+         * Errors in last 24h
+         */
+        errorCount: number;
+
+        /**
+         * Last activity timestamp
+         */
+        lastActiveAt: string | null;
+
+        /**
+         * Requests in last 24h
+         */
+        requestCount: number;
+      }
+    }
+
+    /**
+     * Resource relationships
+     */
+    export interface Relationships {
+      /**
+       * Party that owns the agent
+       */
+      party: Relationships.Party;
+    }
+
+    export namespace Relationships {
+      /**
+       * Party that owns the agent
+       */
+      export interface Party {
+        /**
+         * Related resource identifier
+         */
+        data: Party.Data;
+      }
+
+      export namespace Party {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+    }
+  }
+
+  export 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 namespace AgentCreateParams {
+  /**
+   * Optional per-transaction limit for the agent
+   */
+  export 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 namespace AgentUpdateParams {
+  /**
+   * Per-transaction spend cap. null clears the limit; omitted leaves it unchanged.
+   */
+  export 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 namespace AgentCreateInvitationsParams {
+  export interface Agent {
+    agentId: string;
+
+    permissions: Array<string>;
+
+    limits?: Agent.Limits;
+  }
+
+  export namespace Agent {
+    export 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,
+  };
+}