@naturalpay/sdk 0.1.4 → 0.2.0

package/dist/index.d.cts

@@ -145,11 +145,17 @@ interface PaymentCreateParams {
     agentId?: string;
     /** Payment amount in minor units (cents). 5000 = $50.00. */
     amount: number;
-    customerPartyId: string;
+    /** Sender party ID (pty_xxx). Omit to send from your own wallet; provide for delegated payments on behalf of a customer. */
+    customerPartyId?: string;
     /** Recipient email, phone number, or party ID (pty_xxx). */
     recipient: string;
-    /** Payment memo/description. */
-    memo: string;
+    /**
+     * Human-readable description of the payment's purpose. Required for all SDK
+     * callers. For agent-initiated payments, write a rich rationale (≥20 chars
+     * recommended) so the user can confidently approve and the audit trail is
+     * legible.
+     */
+    description: string;
     /** Currency code (default: USD). */
     currency?: string;
     idempotencyKey: string;
@@ -175,8 +181,9 @@ interface Transaction {
     amount: number;
     currency: string;
     status: string;
+    escalationId?: string;
+    disputeId?: string;
     description?: string;
-    memo?: string;
     createdAt: string;
     updatedAt?: string;
     isDelegated: boolean;
@@ -184,6 +191,8 @@ interface Transaction {
     customerAgentId?: string;
     senderName?: string;
     recipientName?: string;
+    initiatorName?: string;
+    initiatorIsAgent?: boolean;
     transactionType: string;
     category: string;
     direction: string;
@@ -191,7 +200,7 @@ interface Transaction {
     destinationPartyId?: string;
     sourceWalletId?: string;
     destinationWalletId?: string;
-    /** Internal instance ID (ins_xxx) assigned by server. */
+    /** Present on payment creation responses when agent instance metadata was supplied. */
     instanceId?: string;
     /** Claim link URL for unclaimed payments. */
     claimLink?: string;
@@ -246,9 +255,9 @@ interface AmountInfo {
 interface BalanceBreakdown {
     operatingFunded: AmountInfo;
     operatingAdvanced: AmountInfo;
-    escrowFundedSettled: AmountInfo;
-    escrowAdvanced: AmountInfo;
-    holdsOutbound: AmountInfo;
+    pendingIn: AmountInfo;
+    pendingOut: AmountInfo;
+    held: AmountInfo;
 }
 interface AccountBalance {
     walletId: string;
@@ -532,9 +541,8 @@ interface CustomerPartyInfo {
 }
 interface Customer {
     id: string;
-    type: 'party' | 'delegationInvitation';
+    type: 'party';
     party?: CustomerPartyInfo;
-    email?: string;
     status: string;
     permissions: string[];
     createdAt: string;
@@ -542,6 +550,14 @@ interface Customer {
     walletAvailableDollars?: string;
     walletAccess: 'granted' | 'denied' | 'noWallet';
 }
+interface PendingInvitation {
+    id: string;
+    type: 'delegationInvitation';
+    email?: string;
+    status: string;
+    permissions: string[];
+    createdAt: string;
+}
 interface CustomerListParams {
     limit?: number;
     cursor?: string;
@@ -557,6 +573,11 @@ interface CustomerListResponse {
     hasMore: boolean;
     nextCursor?: string | null;
 }
+interface PendingInvitationListResponse {
+    items: PendingInvitation[];
+    hasMore: boolean;
+    nextCursor?: string | null;
+}
 
 /**
  * Customers resource.
@@ -564,12 +585,16 @@ interface CustomerListResponse {
 
 declare class CustomersResource extends BaseResource {
     /**
-     * List customers who have delegated access to the partner.
+     * List active customers who have delegated access to the partner.
      *
-     * @param params - Pagination parameters
-     * @returns CustomerListResponse with items, hasMore, nextCursor
+     * Returns only accepted delegations. Use {@link listInvitations} for pending
+     * invitations that have not yet been accepted.
      */
     list(params?: CustomerListParams): Promise<CustomerListResponse>;
+    /**
+     * List pending customer invitations you've sent that have not yet been accepted.
+     */
+    listInvitations(params?: CustomerListParams): Promise<PendingInvitationListResponse>;
 }
 
 /**
@@ -593,7 +618,7 @@ interface NaturalClientOptions extends HTTPClientOptions {
  *   amount: 5000,
  *   customerPartyId: 'pty_xxx',
  *   recipient: 'alice@example.com',
- *   memo: 'For consulting',
+ *   description: 'For consulting',
  *   idempotencyKey: 'unique-key-for-this-payment',
  * });
  *
@@ -637,6 +662,29 @@ type ToolCallId = string & {
     readonly __brand: 'ToolCallId';
 };
 
+/**
+ * Natural's canonical tool-name vocabulary.
+ *
+ * These are the names Natural recognizes on the `X-Tool-Call` header and
+ * displays in admin audit views. The `runWithToolCall` helper accepts only
+ * these names, so callers typing a custom label get a TypeScript error at the
+ * call site — the SDK is the single source of truth.
+ *
+ * When Natural adds or renames a tool, update this constant in the same
+ * change. Callers with their own caller-side metadata should use the
+ * `developer_context` field instead.
+ */
+declare const NATURAL_TOOL_NAMES: {
+    readonly CREATE_PAYMENT: "create_payment";
+    readonly GET_PAYMENT_STATUS: "get_payment_status";
+    readonly GET_ACCOUNT_BALANCE: "get_account_balance";
+    readonly LIST_TRANSACTIONS: "list_transactions";
+    readonly LIST_AGENTS: "list_agents";
+    readonly LIST_CUSTOMERS: "list_customers";
+    readonly LIST_CUSTOMER_INVITATIONS: "list_customer_invitations";
+};
+type NaturalToolName = (typeof NATURAL_TOOL_NAMES)[keyof typeof NATURAL_TOOL_NAMES];
+
 /**
  * Tool call context for MCP server -> HTTP layer communication.
  *
@@ -662,11 +710,13 @@ declare function getToolCallHeader(): string | undefined;
  * pick up the tool call data and send it as the X-Tool-Call header.
  *
  * @param toolCallId - Unique ID for this invocation (tc_<uuid>).
- * @param name       - Tool name (e.g. "create_payment").
+ * @param name       - Canonical Natural tool name (see `NATURAL_TOOL_NAMES`).
+ *                     Custom caller-side labels are not accepted here; use the
+ *                     `developer_context` field for caller-side metadata.
  * @param args       - Raw tool arguments.
  * @param fn         - The function to execute within the context.
  */
-declare function runWithToolCall<T>(toolCallId: ToolCallId, name: string, args: Record<string, unknown>, fn: () => T): T;
+declare function runWithToolCall<T>(toolCallId: ToolCallId, name: NaturalToolName, args: Record<string, unknown>, fn: () => T): T;
 
 /**
  * Structured logging for Natural Payments SDK.
@@ -876,4 +926,4 @@ declare function verifyWebhookSignature(body: string | Buffer | Uint8Array, head
  */
 declare const VERSION = "0.1.4";
 
-export { type AccountBalance, type Agent, type AgentConfig, type AgentConfigDict, type AgentCreateParams, type AgentCreateResponse, type AgentDelegation, type AgentDelegationListParams, type AgentDelegationListResponse, type AgentDeleteOptions, type AgentGetOptions, type AgentListParams, type AgentListResponse, type AgentStatus, type AgentUpdateParams, type AgentUpdateResponse, type AmountInfo, AuthenticationError, type BalanceBreakdown, type Customer, type CustomerListParams, type CustomerListResponse, type CustomerPartyInfo, type InstanceId, InsufficientFundsError, InvalidRequestError, type LogLevel, Logger, type ModelUsage, type ModelUsageDict, NaturalClient, type NaturalClientOptions, NaturalError, type PaymentCreateParams, PaymentError, RateLimitError, RecipientNotFoundError, ServerError, type ToolCallId, type TraceId, type Transaction, type TransactionGetParams, type TransactionListParams, type TransactionListResponse, TransactionTypeFilter, VERSION, type VerifyWebhookOptions, WebhookVerificationError, type WithdrawParams, type WithdrawResponse, agentConfigToDict, bindContext, clearContext, configHash, configureLogging, generateToolCallId, getContext, getLogger, getToolCallHeader, logApiCall, logError, logToolCall, modelUsageToDict, parseApiKeyEnv, runWithContext, runWithToolCall, validateBaseUrl, verifyWebhookSignature };
+export { type AccountBalance, type Agent, type AgentConfig, type AgentConfigDict, type AgentCreateParams, type AgentCreateResponse, type AgentDelegation, type AgentDelegationListParams, type AgentDelegationListResponse, type AgentDeleteOptions, type AgentGetOptions, type AgentListParams, type AgentListResponse, type AgentStatus, type AgentUpdateParams, type AgentUpdateResponse, type AmountInfo, AuthenticationError, type BalanceBreakdown, type Customer, type CustomerListParams, type CustomerListResponse, type CustomerPartyInfo, type InstanceId, InsufficientFundsError, InvalidRequestError, type LogLevel, Logger, type ModelUsage, type ModelUsageDict, NATURAL_TOOL_NAMES, NaturalClient, type NaturalClientOptions, NaturalError, type NaturalToolName, type PaymentCreateParams, PaymentError, type PendingInvitation, type PendingInvitationListResponse, RateLimitError, RecipientNotFoundError, ServerError, type ToolCallId, type TraceId, type Transaction, type TransactionGetParams, type TransactionListParams, type TransactionListResponse, TransactionTypeFilter, VERSION, type VerifyWebhookOptions, WebhookVerificationError, type WithdrawParams, type WithdrawResponse, agentConfigToDict, bindContext, clearContext, configHash, configureLogging, generateToolCallId, getContext, getLogger, getToolCallHeader, logApiCall, logError, logToolCall, modelUsageToDict, parseApiKeyEnv, runWithContext, runWithToolCall, validateBaseUrl, verifyWebhookSignature };

package/dist/index.d.ts

@@ -145,11 +145,17 @@ interface PaymentCreateParams {
     agentId?: string;
     /** Payment amount in minor units (cents). 5000 = $50.00. */
     amount: number;
-    customerPartyId: string;
+    /** Sender party ID (pty_xxx). Omit to send from your own wallet; provide for delegated payments on behalf of a customer. */
+    customerPartyId?: string;
     /** Recipient email, phone number, or party ID (pty_xxx). */
     recipient: string;
-    /** Payment memo/description. */
-    memo: string;
+    /**
+     * Human-readable description of the payment's purpose. Required for all SDK
+     * callers. For agent-initiated payments, write a rich rationale (≥20 chars
+     * recommended) so the user can confidently approve and the audit trail is
+     * legible.
+     */
+    description: string;
     /** Currency code (default: USD). */
     currency?: string;
     idempotencyKey: string;
@@ -175,8 +181,9 @@ interface Transaction {
     amount: number;
     currency: string;
     status: string;
+    escalationId?: string;
+    disputeId?: string;
     description?: string;
-    memo?: string;
     createdAt: string;
     updatedAt?: string;
     isDelegated: boolean;
@@ -184,6 +191,8 @@ interface Transaction {
     customerAgentId?: string;
     senderName?: string;
     recipientName?: string;
+    initiatorName?: string;
+    initiatorIsAgent?: boolean;
     transactionType: string;
     category: string;
     direction: string;
@@ -191,7 +200,7 @@ interface Transaction {
     destinationPartyId?: string;
     sourceWalletId?: string;
     destinationWalletId?: string;
-    /** Internal instance ID (ins_xxx) assigned by server. */
+    /** Present on payment creation responses when agent instance metadata was supplied. */
     instanceId?: string;
     /** Claim link URL for unclaimed payments. */
     claimLink?: string;
@@ -246,9 +255,9 @@ interface AmountInfo {
 interface BalanceBreakdown {
     operatingFunded: AmountInfo;
     operatingAdvanced: AmountInfo;
-    escrowFundedSettled: AmountInfo;
-    escrowAdvanced: AmountInfo;
-    holdsOutbound: AmountInfo;
+    pendingIn: AmountInfo;
+    pendingOut: AmountInfo;
+    held: AmountInfo;
 }
 interface AccountBalance {
     walletId: string;
@@ -532,9 +541,8 @@ interface CustomerPartyInfo {
 }
 interface Customer {
     id: string;
-    type: 'party' | 'delegationInvitation';
+    type: 'party';
     party?: CustomerPartyInfo;
-    email?: string;
     status: string;
     permissions: string[];
     createdAt: string;
@@ -542,6 +550,14 @@ interface Customer {
     walletAvailableDollars?: string;
     walletAccess: 'granted' | 'denied' | 'noWallet';
 }
+interface PendingInvitation {
+    id: string;
+    type: 'delegationInvitation';
+    email?: string;
+    status: string;
+    permissions: string[];
+    createdAt: string;
+}
 interface CustomerListParams {
     limit?: number;
     cursor?: string;
@@ -557,6 +573,11 @@ interface CustomerListResponse {
     hasMore: boolean;
     nextCursor?: string | null;
 }
+interface PendingInvitationListResponse {
+    items: PendingInvitation[];
+    hasMore: boolean;
+    nextCursor?: string | null;
+}
 
 /**
  * Customers resource.
@@ -564,12 +585,16 @@ interface CustomerListResponse {
 
 declare class CustomersResource extends BaseResource {
     /**
-     * List customers who have delegated access to the partner.
+     * List active customers who have delegated access to the partner.
      *
-     * @param params - Pagination parameters
-     * @returns CustomerListResponse with items, hasMore, nextCursor
+     * Returns only accepted delegations. Use {@link listInvitations} for pending
+     * invitations that have not yet been accepted.
      */
     list(params?: CustomerListParams): Promise<CustomerListResponse>;
+    /**
+     * List pending customer invitations you've sent that have not yet been accepted.
+     */
+    listInvitations(params?: CustomerListParams): Promise<PendingInvitationListResponse>;
 }
 
 /**
@@ -593,7 +618,7 @@ interface NaturalClientOptions extends HTTPClientOptions {
  *   amount: 5000,
  *   customerPartyId: 'pty_xxx',
  *   recipient: 'alice@example.com',
- *   memo: 'For consulting',
+ *   description: 'For consulting',
  *   idempotencyKey: 'unique-key-for-this-payment',
  * });
  *
@@ -637,6 +662,29 @@ type ToolCallId = string & {
     readonly __brand: 'ToolCallId';
 };
 
+/**
+ * Natural's canonical tool-name vocabulary.
+ *
+ * These are the names Natural recognizes on the `X-Tool-Call` header and
+ * displays in admin audit views. The `runWithToolCall` helper accepts only
+ * these names, so callers typing a custom label get a TypeScript error at the
+ * call site — the SDK is the single source of truth.
+ *
+ * When Natural adds or renames a tool, update this constant in the same
+ * change. Callers with their own caller-side metadata should use the
+ * `developer_context` field instead.
+ */
+declare const NATURAL_TOOL_NAMES: {
+    readonly CREATE_PAYMENT: "create_payment";
+    readonly GET_PAYMENT_STATUS: "get_payment_status";
+    readonly GET_ACCOUNT_BALANCE: "get_account_balance";
+    readonly LIST_TRANSACTIONS: "list_transactions";
+    readonly LIST_AGENTS: "list_agents";
+    readonly LIST_CUSTOMERS: "list_customers";
+    readonly LIST_CUSTOMER_INVITATIONS: "list_customer_invitations";
+};
+type NaturalToolName = (typeof NATURAL_TOOL_NAMES)[keyof typeof NATURAL_TOOL_NAMES];
+
 /**
  * Tool call context for MCP server -> HTTP layer communication.
  *
@@ -662,11 +710,13 @@ declare function getToolCallHeader(): string | undefined;
  * pick up the tool call data and send it as the X-Tool-Call header.
  *
  * @param toolCallId - Unique ID for this invocation (tc_<uuid>).
- * @param name       - Tool name (e.g. "create_payment").
+ * @param name       - Canonical Natural tool name (see `NATURAL_TOOL_NAMES`).
+ *                     Custom caller-side labels are not accepted here; use the
+ *                     `developer_context` field for caller-side metadata.
  * @param args       - Raw tool arguments.
  * @param fn         - The function to execute within the context.
  */
-declare function runWithToolCall<T>(toolCallId: ToolCallId, name: string, args: Record<string, unknown>, fn: () => T): T;
+declare function runWithToolCall<T>(toolCallId: ToolCallId, name: NaturalToolName, args: Record<string, unknown>, fn: () => T): T;
 
 /**
  * Structured logging for Natural Payments SDK.
@@ -876,4 +926,4 @@ declare function verifyWebhookSignature(body: string | Buffer | Uint8Array, head
  */
 declare const VERSION = "0.1.4";
 
-export { type AccountBalance, type Agent, type AgentConfig, type AgentConfigDict, type AgentCreateParams, type AgentCreateResponse, type AgentDelegation, type AgentDelegationListParams, type AgentDelegationListResponse, type AgentDeleteOptions, type AgentGetOptions, type AgentListParams, type AgentListResponse, type AgentStatus, type AgentUpdateParams, type AgentUpdateResponse, type AmountInfo, AuthenticationError, type BalanceBreakdown, type Customer, type CustomerListParams, type CustomerListResponse, type CustomerPartyInfo, type InstanceId, InsufficientFundsError, InvalidRequestError, type LogLevel, Logger, type ModelUsage, type ModelUsageDict, NaturalClient, type NaturalClientOptions, NaturalError, type PaymentCreateParams, PaymentError, RateLimitError, RecipientNotFoundError, ServerError, type ToolCallId, type TraceId, type Transaction, type TransactionGetParams, type TransactionListParams, type TransactionListResponse, TransactionTypeFilter, VERSION, type VerifyWebhookOptions, WebhookVerificationError, type WithdrawParams, type WithdrawResponse, agentConfigToDict, bindContext, clearContext, configHash, configureLogging, generateToolCallId, getContext, getLogger, getToolCallHeader, logApiCall, logError, logToolCall, modelUsageToDict, parseApiKeyEnv, runWithContext, runWithToolCall, validateBaseUrl, verifyWebhookSignature };
+export { type AccountBalance, type Agent, type AgentConfig, type AgentConfigDict, type AgentCreateParams, type AgentCreateResponse, type AgentDelegation, type AgentDelegationListParams, type AgentDelegationListResponse, type AgentDeleteOptions, type AgentGetOptions, type AgentListParams, type AgentListResponse, type AgentStatus, type AgentUpdateParams, type AgentUpdateResponse, type AmountInfo, AuthenticationError, type BalanceBreakdown, type Customer, type CustomerListParams, type CustomerListResponse, type CustomerPartyInfo, type InstanceId, InsufficientFundsError, InvalidRequestError, type LogLevel, Logger, type ModelUsage, type ModelUsageDict, NATURAL_TOOL_NAMES, NaturalClient, type NaturalClientOptions, NaturalError, type NaturalToolName, type PaymentCreateParams, PaymentError, type PendingInvitation, type PendingInvitationListResponse, RateLimitError, RecipientNotFoundError, ServerError, type ToolCallId, type TraceId, type Transaction, type TransactionGetParams, type TransactionListParams, type TransactionListResponse, TransactionTypeFilter, VERSION, type VerifyWebhookOptions, WebhookVerificationError, type WithdrawParams, type WithdrawResponse, agentConfigToDict, bindContext, clearContext, configHash, configureLogging, generateToolCallId, getContext, getLogger, getToolCallHeader, logApiCall, logError, logToolCall, modelUsageToDict, parseApiKeyEnv, runWithContext, runWithToolCall, validateBaseUrl, verifyWebhookSignature };

package/dist/index.js

@@ -877,8 +877,9 @@ function unwrapTransactionResource(resource) {
     amount: Number(attributes.amount),
     currency: String(attributes.currency),
     status: String(attributes.status),
+    escalationId: attributes.escalationId != null ? String(attributes.escalationId) : void 0,
+    disputeId: attributes.disputeId != null ? String(attributes.disputeId) : void 0,
     description: attributes.description != null ? String(attributes.description) : void 0,
-    memo: attributes.memo != null ? String(attributes.memo) : void 0,
     createdAt: String(attributes.createdAt),
     updatedAt: attributes.updatedAt != null ? String(attributes.updatedAt) : void 0,
     isDelegated: Boolean(attributes.isDelegated),
@@ -886,6 +887,8 @@ function unwrapTransactionResource(resource) {
     customerAgentId: attributes.customerAgentId != null ? String(attributes.customerAgentId) : void 0,
     senderName: attributes.senderName != null ? String(attributes.senderName) : void 0,
     recipientName: attributes.recipientName != null ? String(attributes.recipientName) : void 0,
+    initiatorName: attributes.initiatorName != null ? String(attributes.initiatorName) : void 0,
+    initiatorIsAgent: attributes.initiatorIsAgent != null ? Boolean(attributes.initiatorIsAgent) : void 0,
     transactionType: String(attributes.transactionType),
     category: String(attributes.category),
     direction: String(attributes.direction),
@@ -1000,8 +1003,6 @@ function unwrapPaymentResponse(response) {
     transactionType: String(attributes.transactionType ?? "payment"),
     category: String(attributes.category ?? "sent"),
     direction: String(attributes.direction ?? "OUTBOUND"),
-    // Mirror description into memo for payment convenience.
-    memo: base.description,
     // Payments use customerParty/counterparty relationship keys,
     // falling back to the generic sourceParty/destinationParty.
     sourcePartyId: relationships?.customerParty?.data?.id ?? base.sourcePartyId,
@@ -1025,9 +1026,9 @@ var PaymentsResource = class extends BaseResource {
       amount: params.amount,
       currency: params.currency ?? "USD",
       counterparty: recipient,
-      customerPartyId: params.customerPartyId
+      description: params.description,
+      ...params.customerPartyId != null ? { customerPartyId: params.customerPartyId } : {}
     };
-    attributes["description"] = params.memo;
     const body = { data: { attributes } };
     const headers = {
       "Idempotency-Key": params.idempotencyKey
@@ -1076,9 +1077,9 @@ function unwrapBalance(response) {
   const breakdown = {
     operatingFunded: toAmountInfo(rawBreakdown?.operatingFunded),
     operatingAdvanced: toAmountInfo(rawBreakdown?.operatingAdvanced),
-    escrowFundedSettled: toAmountInfo(rawBreakdown?.escrowFundedSettled),
-    escrowAdvanced: toAmountInfo(rawBreakdown?.escrowAdvanced),
-    holdsOutbound: toAmountInfo(rawBreakdown?.holdsOutbound)
+    pendingIn: toAmountInfo(rawBreakdown?.pendingIn),
+    pendingOut: toAmountInfo(rawBreakdown?.pendingOut),
+    held: toAmountInfo(rawBreakdown?.held)
   };
   return {
     walletId: id,
@@ -1456,18 +1457,14 @@ var DelegationsResource = class extends BaseResource {
 };
 
 // src/resources/customers.ts
-var VALID_CUSTOMER_TYPES = /* @__PURE__ */ new Set(["party", "delegationInvitation"]);
 var VALID_WALLET_ACCESS = /* @__PURE__ */ new Set(["granted", "denied", "noWallet"]);
-function isCustomerType(value) {
-  return VALID_CUSTOMER_TYPES.has(value);
-}
 function isWalletAccess(value) {
   return typeof value === "string" && VALID_WALLET_ACCESS.has(value);
 }
 function unwrapCustomerResource(resource) {
-  if (!isCustomerType(resource.type) || !resource.attributes) {
+  if (resource.type !== "party" || !resource.attributes) {
     throw new NaturalError(
-      `Unexpected resource format: expected type "party" or "delegationInvitation", got "${resource.type}"`
+      `Unexpected resource format: expected type "party", got "${resource.type}"`
     );
   }
   const { id, attributes } = resource;
@@ -1478,9 +1475,8 @@ function unwrapCustomerResource(resource) {
   } : void 0;
   return {
     id,
-    type: resource.type,
+    type: "party",
     party,
-    email: typeof attributes.email === "string" ? attributes.email : void 0,
     status: typeof attributes.status === "string" ? attributes.status : "",
     permissions: Array.isArray(attributes.permissions) ? attributes.permissions : [],
     createdAt: typeof attributes.createdAt === "string" ? attributes.createdAt : "",
@@ -1489,6 +1485,22 @@ function unwrapCustomerResource(resource) {
     walletAccess: isWalletAccess(attributes.walletAccess) ? attributes.walletAccess : "denied"
   };
 }
+function unwrapPendingInvitationResource(resource) {
+  if (resource.type !== "delegationInvitation" || !resource.attributes) {
+    throw new NaturalError(
+      `Unexpected resource format: expected type "delegationInvitation", got "${resource.type}"`
+    );
+  }
+  const { id, attributes } = resource;
+  return {
+    id,
+    type: "delegationInvitation",
+    email: typeof attributes.email === "string" ? attributes.email : void 0,
+    status: typeof attributes.status === "string" ? attributes.status : "",
+    permissions: Array.isArray(attributes.permissions) ? attributes.permissions : [],
+    createdAt: typeof attributes.createdAt === "string" ? attributes.createdAt : ""
+  };
+}
 function unwrapCustomerList(response) {
   if (!response?.data || !Array.isArray(response.data)) {
     throw new NaturalError(
@@ -1502,34 +1514,59 @@ function unwrapCustomerList(response) {
     nextCursor: pagination.nextCursor ?? null
   };
 }
+function unwrapPendingInvitationList(response) {
+  if (!response?.data || !Array.isArray(response.data)) {
+    throw new NaturalError(
+      'Unexpected response format: missing "data" array in pending invitation list response'
+    );
+  }
+  const pagination = response.meta?.pagination ?? {};
+  return {
+    items: response.data.map(unwrapPendingInvitationResource),
+    hasMore: pagination.hasMore ?? false,
+    nextCursor: pagination.nextCursor ?? null
+  };
+}
+function buildRequest(params) {
+  const headers = {};
+  if (params?.agentId) {
+    headers["X-Agent-ID"] = params.agentId;
+  }
+  if (params?.instanceId) {
+    headers["X-Instance-ID"] = params.instanceId;
+  }
+  if (params?.traceId) {
+    headers["X-Trace-ID"] = sanitizeHeaderValue(params.traceId);
+  }
+  const queryParams = {
+    limit: params?.limit,
+    cursor: params?.cursor
+  };
+  return {
+    params: queryParams,
+    headers: Object.keys(headers).length > 0 ? headers : void 0
+  };
+}
 var CustomersResource = class extends BaseResource {
   /**
-   * List customers who have delegated access to the partner.
+   * List active customers who have delegated access to the partner.
    *
-   * @param params - Pagination parameters
-   * @returns CustomerListResponse with items, hasMore, nextCursor
+   * Returns only accepted delegations. Use {@link listInvitations} for pending
+   * invitations that have not yet been accepted.
    */
   async list(params) {
-    const headers = {};
-    if (params?.agentId) {
-      headers["X-Agent-ID"] = params.agentId;
-    }
-    if (params?.instanceId) {
-      headers["X-Instance-ID"] = params.instanceId;
-    }
-    if (params?.traceId) {
-      headers["X-Trace-ID"] = sanitizeHeaderValue(params.traceId);
-    }
-    const queryParams = {
-      limit: params?.limit,
-      cursor: params?.cursor
-    };
-    const response = await this.http.get("/customers", {
-      params: queryParams,
-      headers: Object.keys(headers).length > 0 ? headers : void 0
-    });
+    const request = buildRequest(params);
+    const response = await this.http.get("/customers", request);
     return unwrapCustomerList(response);
   }
+  /**
+   * List pending customer invitations you've sent that have not yet been accepted.
+   */
+  async listInvitations(params) {
+    const request = buildRequest(params);
+    const response = await this.http.get("/customers/invitations", request);
+    return unwrapPendingInvitationList(response);
+  }
 };
 
 // src/client.ts
@@ -1565,6 +1602,17 @@ var NaturalClient = class {
     this.customers = new CustomersResource(this.http);
   }
 };
+
+// src/tool-names.ts
+var NATURAL_TOOL_NAMES = {
+  CREATE_PAYMENT: "create_payment",
+  GET_PAYMENT_STATUS: "get_payment_status",
+  GET_ACCOUNT_BALANCE: "get_account_balance",
+  LIST_TRANSACTIONS: "list_transactions",
+  LIST_AGENTS: "list_agents",
+  LIST_CUSTOMERS: "list_customers",
+  LIST_CUSTOMER_INVITATIONS: "list_customer_invitations"
+};
 var WHSEC_PREFIX = "whsec_";
 var DEFAULT_TOLERANCE_SECONDS = 300;
 function getHeader(headers, name) {
@@ -1652,6 +1700,6 @@ var TransactionTypeFilter = /* @__PURE__ */ ((TransactionTypeFilter2) => {
   return TransactionTypeFilter2;
 })(TransactionTypeFilter || {});
 
-export { AuthenticationError, InsufficientFundsError, InvalidRequestError, NaturalClient, NaturalError, PaymentError, RateLimitError, RecipientNotFoundError, ServerError, TransactionTypeFilter, VERSION, WebhookVerificationError, agentConfigToDict, bindContext, clearContext, configHash, configureLogging, generateToolCallId, getContext, getLogger, getToolCallHeader, logApiCall, logError, logToolCall, modelUsageToDict, parseApiKeyEnv, runWithContext, runWithToolCall, validateBaseUrl, verifyWebhookSignature };
+export { AuthenticationError, InsufficientFundsError, InvalidRequestError, NATURAL_TOOL_NAMES, NaturalClient, NaturalError, PaymentError, RateLimitError, RecipientNotFoundError, ServerError, TransactionTypeFilter, VERSION, WebhookVerificationError, agentConfigToDict, bindContext, clearContext, configHash, configureLogging, generateToolCallId, getContext, getLogger, getToolCallHeader, logApiCall, logError, logToolCall, modelUsageToDict, parseApiKeyEnv, runWithContext, runWithToolCall, validateBaseUrl, verifyWebhookSignature };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map