@useagentpay/sdk 0.1.0 → 0.1.2

package/dist/index.d.cts

@@ -1,3 +1,6 @@
+import { Stagehand } from '@browserbasehq/stagehand';
+import { createServer } from 'node:http';
+
 interface BillingCredentials {
     card: {
         number: string;
@@ -82,15 +85,27 @@ interface ProposeOptions {
     url: string;
 }
 
+/**
+ * Abstraction over how a Stagehand browser instance is created.
+ * Implement this interface to plug in a custom browser backend
+ * (e.g. Browserbase, cloud Playwright, etc.).
+ */
+interface BrowserProvider {
+    createStagehand(modelApiKey?: string): Stagehand;
+    close(): Promise<void>;
+}
+
 interface CheckoutResult {
     success: boolean;
     confirmationId?: string;
     error?: string;
 }
 interface ExecutorConfig {
-    browserbaseApiKey?: string;
-    browserbaseProjectId?: string;
+    /** Custom browser provider. Defaults to LocalBrowserProvider (local Chromium). */
+    provider?: BrowserProvider;
+    /** LLM API key for Stagehand's AI-driven navigation (e.g. ANTHROPIC_API_KEY). */
     modelApiKey?: string;
+    proxyUrl?: string;
 }
 
 declare class NotSetupError extends Error {
@@ -220,8 +235,11 @@ interface DiscoverResult {
     productName: string;
 }
 declare class PurchaseExecutor {
-    private config;
+    private provider;
+    private modelApiKey?;
     private stagehand;
+    private proxyUrl;
+    private originalBaseUrl;
     constructor(config?: ExecutorConfig);
     private createStagehand;
     /**
@@ -263,6 +281,52 @@ declare const PLACEHOLDER_MAP: {
 declare function getPlaceholderVariables(): Record<string, string>;
 declare function credentialsToSwapMap(creds: BillingCredentials): Record<string, string>;
 
+interface ApprovalResult {
+    action: 'approved' | 'rejected';
+    passphrase?: string;
+    reason?: string;
+}
+/**
+ * Launch an ephemeral HTTP server on localhost, open a browser page
+ * where the human can approve or deny the transaction.
+ * On approve: server-side signing is performed, passphrase returned in result.
+ * On deny: transaction is rejected.
+ */
+declare function requestBrowserApproval(tx: Transaction, tm: TransactionManager, audit: AuditLogger, home?: string): Promise<ApprovalResult>;
+
+interface SetupResult {
+    completed: boolean;
+}
+/**
+ * Launch an ephemeral HTTP server on localhost, open a browser page
+ * where the human fills in credentials, passphrase, and budget.
+ * All sensitive data stays in the browser->server HTTP request on localhost.
+ * Never touches stdout/terminal.
+ */
+declare function requestBrowserSetup(home?: string): Promise<SetupResult>;
+
+declare function startServer(port: number): Promise<ReturnType<typeof createServer>>;
+
+declare function openBrowser(url: string): void;
+
+interface PassphraseContext {
+    action: 'buy' | 'approve';
+    merchant?: string;
+    amount?: number;
+    description?: string;
+    txId?: string;
+}
+
+declare function promptInput(question: string): Promise<string>;
+declare function promptPassphrase(prompt?: string): Promise<string>;
+declare function promptConfirm(question: string): Promise<boolean>;
+/**
+ * Collect passphrase safely: uses terminal prompt when stdin is a TTY,
+ * otherwise opens a browser page so the human can enter it directly
+ * (keeping the passphrase out of the agent's context).
+ */
+declare function promptPassphraseSafe(context?: PassphraseContext): Promise<string>;
+
 interface AgentPayOptions {
     home?: string;
     passphrase?: string;
@@ -289,13 +353,6 @@ declare class AgentPay {
             limitPerTx: number;
             remaining: number;
         };
-        generateFundingQR: (options?: {
-            suggestedBudget?: number;
-            message?: string;
-        }) => Promise<{
-            url: string;
-            qrDataUrl: string;
-        }>;
     };
     get transactions(): {
         propose: (options: ProposeOptions) => Transaction;
@@ -307,6 +364,11 @@ declare class AgentPay {
             status: "approved" | "rejected";
             reason?: string;
         }>;
+        requestApproval: (txId: string) => Promise<{
+            action: "approved" | "rejected";
+            passphrase?: string;
+            reason?: string;
+        }>;
         execute: (txId: string) => Promise<Receipt>;
         getReceipt: (txId: string) => Receipt | undefined;
     };
@@ -323,6 +385,6 @@ declare class AgentPay {
     };
 }
 
-declare const VERSION = "0.1.0";
+declare const VERSION: string;
 
-export { AgentPay, type AgentPayOptions, AlreadyExecutedError, AuditLogger, type BillingCredentials, BudgetManager, CheckoutFailedError, type CheckoutResult, DecryptError, type EncryptedVault, ExceedsTxLimitError, type ExecutorConfig, InsufficientBalanceError, InvalidMandateError, type KeyPair, NotApprovedError, NotSetupError, PLACEHOLDER_MAP, type ProposeOptions, PurchaseExecutor, type PurchaseMandate, type Receipt, TimeoutError, type Transaction, type TransactionDetails, TransactionManager, type TransactionStatus, VERSION, type Wallet, createMandate, credentialsToSwapMap, decrypt, encrypt, formatCurrency, formatStatus, formatTable, formatTimestamp, generateKeyPair, generateTxId, getAuditPath, getCredentialsPath, getHomePath, getKeysPath, getPlaceholderVariables, getTransactionsPath, getWalletPath, loadPrivateKey, loadPublicKey, loadVault, saveKeyPair, saveVault, verifyMandate, waitForApproval };
+export { AgentPay, type AgentPayOptions, AlreadyExecutedError, type ApprovalResult, AuditLogger, type BillingCredentials, type BrowserProvider, BudgetManager, CheckoutFailedError, type CheckoutResult, DecryptError, type EncryptedVault, ExceedsTxLimitError, type ExecutorConfig, InsufficientBalanceError, InvalidMandateError, type KeyPair, NotApprovedError, NotSetupError, PLACEHOLDER_MAP, type ProposeOptions, PurchaseExecutor, type PurchaseMandate, type Receipt, type SetupResult, TimeoutError, type Transaction, type TransactionDetails, TransactionManager, type TransactionStatus, VERSION, type Wallet, createMandate, credentialsToSwapMap, decrypt, encrypt, formatCurrency, formatStatus, formatTable, formatTimestamp, generateKeyPair, generateTxId, getAuditPath, getCredentialsPath, getHomePath, getKeysPath, getPlaceholderVariables, getTransactionsPath, getWalletPath, loadPrivateKey, loadPublicKey, loadVault, openBrowser, promptConfirm, promptInput, promptPassphrase, promptPassphraseSafe, requestBrowserApproval, requestBrowserSetup, saveKeyPair, saveVault, startServer as startDashboardServer, verifyMandate, waitForApproval };

package/dist/index.d.ts

@@ -1,3 +1,6 @@
+import { Stagehand } from '@browserbasehq/stagehand';
+import { createServer } from 'node:http';
+
 interface BillingCredentials {
     card: {
         number: string;
@@ -82,15 +85,27 @@ interface ProposeOptions {
     url: string;
 }
 
+/**
+ * Abstraction over how a Stagehand browser instance is created.
+ * Implement this interface to plug in a custom browser backend
+ * (e.g. Browserbase, cloud Playwright, etc.).
+ */
+interface BrowserProvider {
+    createStagehand(modelApiKey?: string): Stagehand;
+    close(): Promise<void>;
+}
+
 interface CheckoutResult {
     success: boolean;
     confirmationId?: string;
     error?: string;
 }
 interface ExecutorConfig {
-    browserbaseApiKey?: string;
-    browserbaseProjectId?: string;
+    /** Custom browser provider. Defaults to LocalBrowserProvider (local Chromium). */
+    provider?: BrowserProvider;
+    /** LLM API key for Stagehand's AI-driven navigation (e.g. ANTHROPIC_API_KEY). */
     modelApiKey?: string;
+    proxyUrl?: string;
 }
 
 declare class NotSetupError extends Error {
@@ -220,8 +235,11 @@ interface DiscoverResult {
     productName: string;
 }
 declare class PurchaseExecutor {
-    private config;
+    private provider;
+    private modelApiKey?;
     private stagehand;
+    private proxyUrl;
+    private originalBaseUrl;
     constructor(config?: ExecutorConfig);
     private createStagehand;
     /**
@@ -263,6 +281,52 @@ declare const PLACEHOLDER_MAP: {
 declare function getPlaceholderVariables(): Record<string, string>;
 declare function credentialsToSwapMap(creds: BillingCredentials): Record<string, string>;
 
+interface ApprovalResult {
+    action: 'approved' | 'rejected';
+    passphrase?: string;
+    reason?: string;
+}
+/**
+ * Launch an ephemeral HTTP server on localhost, open a browser page
+ * where the human can approve or deny the transaction.
+ * On approve: server-side signing is performed, passphrase returned in result.
+ * On deny: transaction is rejected.
+ */
+declare function requestBrowserApproval(tx: Transaction, tm: TransactionManager, audit: AuditLogger, home?: string): Promise<ApprovalResult>;
+
+interface SetupResult {
+    completed: boolean;
+}
+/**
+ * Launch an ephemeral HTTP server on localhost, open a browser page
+ * where the human fills in credentials, passphrase, and budget.
+ * All sensitive data stays in the browser->server HTTP request on localhost.
+ * Never touches stdout/terminal.
+ */
+declare function requestBrowserSetup(home?: string): Promise<SetupResult>;
+
+declare function startServer(port: number): Promise<ReturnType<typeof createServer>>;
+
+declare function openBrowser(url: string): void;
+
+interface PassphraseContext {
+    action: 'buy' | 'approve';
+    merchant?: string;
+    amount?: number;
+    description?: string;
+    txId?: string;
+}
+
+declare function promptInput(question: string): Promise<string>;
+declare function promptPassphrase(prompt?: string): Promise<string>;
+declare function promptConfirm(question: string): Promise<boolean>;
+/**
+ * Collect passphrase safely: uses terminal prompt when stdin is a TTY,
+ * otherwise opens a browser page so the human can enter it directly
+ * (keeping the passphrase out of the agent's context).
+ */
+declare function promptPassphraseSafe(context?: PassphraseContext): Promise<string>;
+
 interface AgentPayOptions {
     home?: string;
     passphrase?: string;
@@ -289,13 +353,6 @@ declare class AgentPay {
             limitPerTx: number;
             remaining: number;
         };
-        generateFundingQR: (options?: {
-            suggestedBudget?: number;
-            message?: string;
-        }) => Promise<{
-            url: string;
-            qrDataUrl: string;
-        }>;
     };
     get transactions(): {
         propose: (options: ProposeOptions) => Transaction;
@@ -307,6 +364,11 @@ declare class AgentPay {
             status: "approved" | "rejected";
             reason?: string;
         }>;
+        requestApproval: (txId: string) => Promise<{
+            action: "approved" | "rejected";
+            passphrase?: string;
+            reason?: string;
+        }>;
         execute: (txId: string) => Promise<Receipt>;
         getReceipt: (txId: string) => Receipt | undefined;
     };
@@ -323,6 +385,6 @@ declare class AgentPay {
     };
 }
 
-declare const VERSION = "0.1.0";
+declare const VERSION: string;
 
-export { AgentPay, type AgentPayOptions, AlreadyExecutedError, AuditLogger, type BillingCredentials, BudgetManager, CheckoutFailedError, type CheckoutResult, DecryptError, type EncryptedVault, ExceedsTxLimitError, type ExecutorConfig, InsufficientBalanceError, InvalidMandateError, type KeyPair, NotApprovedError, NotSetupError, PLACEHOLDER_MAP, type ProposeOptions, PurchaseExecutor, type PurchaseMandate, type Receipt, TimeoutError, type Transaction, type TransactionDetails, TransactionManager, type TransactionStatus, VERSION, type Wallet, createMandate, credentialsToSwapMap, decrypt, encrypt, formatCurrency, formatStatus, formatTable, formatTimestamp, generateKeyPair, generateTxId, getAuditPath, getCredentialsPath, getHomePath, getKeysPath, getPlaceholderVariables, getTransactionsPath, getWalletPath, loadPrivateKey, loadPublicKey, loadVault, saveKeyPair, saveVault, verifyMandate, waitForApproval };
+export { AgentPay, type AgentPayOptions, AlreadyExecutedError, type ApprovalResult, AuditLogger, type BillingCredentials, type BrowserProvider, BudgetManager, CheckoutFailedError, type CheckoutResult, DecryptError, type EncryptedVault, ExceedsTxLimitError, type ExecutorConfig, InsufficientBalanceError, InvalidMandateError, type KeyPair, NotApprovedError, NotSetupError, PLACEHOLDER_MAP, type ProposeOptions, PurchaseExecutor, type PurchaseMandate, type Receipt, type SetupResult, TimeoutError, type Transaction, type TransactionDetails, TransactionManager, type TransactionStatus, VERSION, type Wallet, createMandate, credentialsToSwapMap, decrypt, encrypt, formatCurrency, formatStatus, formatTable, formatTimestamp, generateKeyPair, generateTxId, getAuditPath, getCredentialsPath, getHomePath, getKeysPath, getPlaceholderVariables, getTransactionsPath, getWalletPath, loadPrivateKey, loadPublicKey, loadVault, openBrowser, promptConfirm, promptInput, promptPassphrase, promptPassphraseSafe, requestBrowserApproval, requestBrowserSetup, saveKeyPair, saveVault, startServer as startDashboardServer, verifyMandate, waitForApproval };