@oneshot-agent/sdk 0.29.0 → 0.32.0

package/dist/index.js

@@ -37,9 +37,13 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OneShot = exports.executeSwap = exports.getSwapQuote = exports.CdpWalletProvider = exports.EthersWalletProvider = void 0;
+const physical_mail_1 = require("./physical-mail");
+__exportStar(require("./physical-mail"), exports);
+const deadline_1 = require("./deadline");
+const errors_1 = require("./errors");
 const ethers_1 = require("ethers");
 const ethers_2 = require("./providers/ethers");
-const errors_1 = require("./errors");
+const errors_2 = require("./errors");
 var ethers_3 = require("./providers/ethers");
 Object.defineProperty(exports, "EthersWalletProvider", { enumerable: true, get: function () { return ethers_3.EthersWalletProvider; } });
 var cdp_1 = require("./providers/cdp");
@@ -49,7 +53,7 @@ Object.defineProperty(exports, "getSwapQuote", { enumerable: true, get: function
 Object.defineProperty(exports, "executeSwap", { enumerable: true, get: function () { return swap_1.executeSwap; } });
 __exportStar(require("./errors"), exports);
 // Keep in sync with package.json `version`. Guarded by version.test.ts.
-const SDK_VERSION = '0.29.0';
+const SDK_VERSION = '0.32.0';
 /** HTTP poll cadence while push is unconfirmed: fast first checks, settling at 2s. */
 const HTTP_POLL_BACKOFF_MS = [300, 600, 1000, 2000];
 /** HTTP poll cadence once the WebSocket has delivered for this request. */
@@ -78,12 +82,14 @@ const USDC_BALANCE_CACHE_MS = 2000;
 const USDC_RESERVATION_TTL_MS = 90000;
 const DEFAULT_SWAP_BUFFER_MULTIPLIER = 10;
 const MAX_SWAP_BUFFER_MULTIPLIER = 1000;
+/** Fixed-point scale for the multiplier (6 decimals, matching USDC). */
+const SWAP_MULTIPLIER_SCALE = 1000000;
 const ERC20_BALANCE_ABI = ['function balanceOf(address) view returns (uint256)'];
 function validateSwapBufferMultiplier(m) {
     if (m === undefined)
         return DEFAULT_SWAP_BUFFER_MULTIPLIER;
     if (typeof m !== 'number' || !Number.isFinite(m) || m < 1 || m > MAX_SWAP_BUFFER_MULTIPLIER) {
-        throw new errors_1.ValidationError(`swapBufferMultiplier must be a finite number between 1 and ${MAX_SWAP_BUFFER_MULTIPLIER}`, 'swapBufferMultiplier');
+        throw new errors_2.ValidationError(`swapBufferMultiplier must be a finite number between 1 and ${MAX_SWAP_BUFFER_MULTIPLIER}`, 'swapBufferMultiplier');
     }
     return m;
 }
@@ -116,21 +122,21 @@ function validateBudgetConfig(budgets) {
     // A typo'd key (`daliy`) from an untyped caller must not silently mean "no cap".
     for (const key of Object.keys(budgets)) {
         if (!['daily', 'perTransaction', 'alertAt', 'pauseAt'].includes(key)) {
-            throw new errors_1.ValidationError(`budgets.${key} is not a recognized field`, `budgets.${key}`);
+            throw new errors_2.ValidationError(`budgets.${key} is not a recognized field`, `budgets.${key}`);
         }
     }
     const positive = (v, field) => {
         if (v === undefined)
             return;
         if (typeof v !== 'number' || !Number.isFinite(v) || v <= 0) {
-            throw new errors_1.ValidationError(`budgets.${field} must be a positive number`, `budgets.${field}`);
+            throw new errors_2.ValidationError(`budgets.${field} must be a positive number`, `budgets.${field}`);
         }
     };
     const fraction = (v, field) => {
         if (v === undefined)
             return;
         if (typeof v !== 'number' || !Number.isFinite(v) || v <= 0 || v > 1) {
-            throw new errors_1.ValidationError(`budgets.${field} must be a fraction in (0, 1]`, `budgets.${field}`);
+            throw new errors_2.ValidationError(`budgets.${field} must be a fraction in (0, 1]`, `budgets.${field}`);
         }
     };
     positive(budgets.daily, 'daily');
@@ -168,13 +174,23 @@ class OneShot {
             const walletProvider = new ethers_2.EthersWalletProvider(config.privateKey, rpcProvider);
             return new OneShot(config, walletProvider);
         }
-        throw new errors_1.ValidationError('Provide one of: privateKey, cdp, or walletProvider', 'config');
+        throw new errors_2.ValidationError('Provide one of: privateKey, cdp, or walletProvider', 'config');
     }
     /**
      * Sync constructor — works with privateKey (backwards compatible).
      * For CDP wallets, use OneShot.create() instead.
      */
     constructor(config, walletProvider) {
+        this.physicalMail = new physical_mail_1.PhysicalMail(async (path, method, body, mime) => {
+            const response = await fetch(`${this.baseUrl}/v1/tools/physical-mail${path}`, {
+                method, headers: { ...await this.signedReadHeaders(method === 'GET' ? 'read' : 'write'), 'Content-Type': mime ?? 'application/json' },
+                ...(body === undefined ? {} : { body: mime ? body : JSON.stringify(body) }),
+                signal: AbortSignal.timeout(60000),
+            });
+            if (!response.ok)
+                await this.failFromResponse('Physical mail request failed', response);
+            return await response.json();
+        }, input => this.executeToolRequest('/v1/tools/physical-mail/send', { ...input, wait: false }));
         /** ETH mode: signed payments not yet observed as settled, keyed by reservation id. */
         this._usdcPending = new Map();
         this._usdcReservationSeq = 0;
@@ -196,10 +212,10 @@ class OneShot {
             this.provider = new ethers_2.EthersWalletProvider(config.privateKey, this.rpcProvider);
         }
         else {
-            throw new errors_1.ValidationError('Provide privateKey or use OneShot.create() for CDP/custom wallets', 'config');
+            throw new errors_2.ValidationError('Provide privateKey or use OneShot.create() for CDP/custom wallets', 'config');
         }
         if (this._currency === 'ETH' && !this.provider.sendTransaction) {
-            throw new errors_1.ValidationError('ETH currency mode requires a wallet provider that supports sendTransaction', 'currency');
+            throw new errors_2.ValidationError('ETH currency mode requires a wallet provider that supports sendTransaction', 'currency');
         }
         if (this.debug) {
             this.log(`SDK initialized — chain=${CHAIN_ID} currency=${this._currency}`);
@@ -311,7 +327,7 @@ class OneShot {
             headers: this.headers(),
         });
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to list domains', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to list domains', response.status, await response.text());
         }
         return response.json();
     }
@@ -323,7 +339,7 @@ class OneShot {
             headers: this.headers(),
         });
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to pause domain', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to pause domain', response.status, await response.text());
         }
         return response.json();
     }
@@ -335,7 +351,7 @@ class OneShot {
             headers: this.headers(),
         });
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to resume domain', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to resume domain', response.status, await response.text());
         }
         return response.json();
     }
@@ -348,7 +364,7 @@ class OneShot {
     }
     async enrichProfile(options) {
         if (!options.linkedin_url && !options.email && !options.name) {
-            throw new errors_1.ValidationError('At least one of linkedin_url, email, or name is required', 'identifier');
+            throw new errors_2.ValidationError('At least one of linkedin_url, email, or name is required', 'identifier');
         }
         return this.tool('enrich/profile', { ...options });
     }
@@ -357,14 +373,58 @@ class OneShot {
     }
     async enrichCompany(options) {
         if (!options.domain && !options.name && !options.linkedin_url && !options.ticker) {
-            throw new errors_1.ValidationError('At least one of domain, name, linkedin_url, or ticker is required', 'identifier');
+            throw new errors_2.ValidationError('At least one of domain, name, linkedin_url, or ticker is required', 'identifier');
         }
         return this.tool('enrich/company', { ...options });
     }
+    /**
+     * Discover local businesses (restaurants, contractors, practices) by
+     * category/keywords × location. Flat price per search, not per row.
+     */
+    async localSearch(options) {
+        if (!options.location || options.location.length === 0) {
+            throw new errors_2.ValidationError('location is required (e.g. ["Austin, TX"])', 'location');
+        }
+        if (!(options.category && options.category.length) && !(options.keywords && options.keywords.length)) {
+            throw new errors_2.ValidationError('At least one of category or keywords is required', 'category');
+        }
+        return this.tool('local/search', { ...options, limit: options.limit ?? 100 });
+    }
+    /**
+     * Resolve a business name + one locating field to its domain, phone,
+     * category and operating status. A miss resolves with `found: false`
+     * (a completed job), never a rejection.
+     */
+    async localResolve(options) {
+        this.validate(options.name, 'name');
+        if (!options.address && !options.city && !options.postal_code && !options.phone) {
+            throw new errors_2.ValidationError('name plus at least one of address, city, postal_code, or phone is required', 'address');
+        }
+        return this.tool('local/resolve', { ...options });
+    }
+    /**
+     * Federal contract opportunities (SAM.gov) by NAICS code — Sources Sought
+     * and Presolicitation notices with the contracting officer's published
+     * contact. Flat price per search; zero notices is a completed result.
+     */
+    async govSolicitations(options) {
+        if (!options.naics || options.naics.length === 0) {
+            throw new errors_2.ValidationError('naics is required (one or more 6-digit codes, e.g. ["541511"])', 'naics');
+        }
+        const bad = options.naics.find(c => !/^\d{6}$/.test(String(c)));
+        if (bad !== undefined) {
+            throw new errors_2.ValidationError(`NAICS codes are 6 digits (got ${JSON.stringify(bad)})`, 'naics');
+        }
+        return this.tool('gov/solicitations', {
+            ...options,
+            notice_types: options.notice_types ?? ['r', 'p'],
+            limit: options.limit ?? 100,
+        });
+    }
     async findEmail(options) {
         this.validate(options.company_domain, 'company_domain');
         if (!options.full_name && !(options.first_name && options.last_name)) {
-            throw new errors_1.ValidationError('Either full_name or both first_name and last_name required', 'name');
+            throw new errors_2.ValidationError('Either full_name or both first_name and last_name required', 'name');
         }
         return this.tool('enrich/email', { ...options });
     }
@@ -374,13 +434,13 @@ class OneShot {
     }
     async deepResearchPerson(options) {
         if (!options.email && !options.social_media_url && !options.name) {
-            throw new errors_1.ValidationError('At least one of email, social_media_url, or name is required', 'identifier');
+            throw new errors_2.ValidationError('At least one of email, social_media_url, or name is required', 'identifier');
         }
         return this.tool('research/person', { ...options });
     }
     async socialProfiles(options) {
         if (!options.email && !options.social_media_url) {
-            throw new errors_1.ValidationError('At least one of email or social_media_url is required', 'identifier');
+            throw new errors_2.ValidationError('At least one of email or social_media_url is required', 'identifier');
         }
         return this.tool('research/social', { ...options });
     }
@@ -395,7 +455,7 @@ class OneShot {
     }
     async personInterests(options) {
         if (!options.email && !options.phone && !options.social_media_url) {
-            throw new errors_1.ValidationError('At least one of email, phone, or social_media_url is required', 'identifier');
+            throw new errors_2.ValidationError('At least one of email, phone, or social_media_url is required', 'identifier');
         }
         return this.tool('research/interests', { ...options });
     }
@@ -413,7 +473,7 @@ class OneShot {
             headers: await this.signedReadHeaders()
         });
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to list inbox', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to list inbox', response.status, await response.text());
         }
         return response.json();
     }
@@ -423,10 +483,10 @@ class OneShot {
             headers: await this.signedReadHeaders()
         });
         if (response.status === 404) {
-            throw new errors_1.ToolError('Email not found', 404, 'Email not found');
+            throw new errors_2.ToolError('Email not found', 404, 'Email not found');
         }
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to get email', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to get email', response.status, await response.text());
         }
         return response.json();
     }
@@ -491,13 +551,13 @@ class OneShot {
         this.validate(options.objective, 'objective');
         this.validate(options.target_number, 'target_number');
         if (Array.isArray(options.target_number) && options.target_number.length === 0) {
-            throw new errors_1.ValidationError('target_number array cannot be empty', 'target_number');
+            throw new errors_2.ValidationError('target_number array cannot be empty', 'target_number');
         }
         if (options.objective.length < 10) {
-            throw new errors_1.ValidationError('Objective must be at least 10 characters', 'objective');
+            throw new errors_2.ValidationError('Objective must be at least 10 characters', 'objective');
         }
         if (options.max_duration_minutes !== undefined && (options.max_duration_minutes < 1 || options.max_duration_minutes > 30)) {
-            throw new errors_1.ValidationError('max_duration_minutes must be between 1 and 30', 'max_duration_minutes');
+            throw new errors_2.ValidationError('max_duration_minutes must be between 1 and 30', 'max_duration_minutes');
         }
         const payload = {
             objective: options.objective,
@@ -520,12 +580,12 @@ class OneShot {
             on400: async (resp) => {
                 const errorData = await resp.json();
                 if (errorData.error === 'content_blocked') {
-                    throw new errors_1.ContentBlockedError(errorData.message, errorData.categories || []);
+                    throw new errors_2.ContentBlockedError(errorData.message, errorData.categories || []);
                 }
                 if (errorData.error === 'emergency_number_blocked') {
-                    throw new errors_1.EmergencyNumberError(errorData.message, errorData.blocked_number || '');
+                    throw new errors_2.EmergencyNumberError(errorData.message, errorData.blocked_number || '');
                 }
-                throw new errors_1.ValidationError(errorData.message || 'Invalid request', 'request');
+                throw new errors_2.ValidationError(errorData.message || 'Invalid request', 'request');
             },
         });
         if (callResp.status !== 202) {
@@ -554,17 +614,17 @@ class OneShot {
         this.validate(options.message, 'message');
         this.validate(options.to_number, 'to_number');
         if (Array.isArray(options.to_number) && options.to_number.length === 0) {
-            throw new errors_1.ValidationError('to_number array cannot be empty', 'to_number');
+            throw new errors_2.ValidationError('to_number array cannot be empty', 'to_number');
         }
         if (options.message.length < 1) {
-            throw new errors_1.ValidationError('Message is required', 'message');
+            throw new errors_2.ValidationError('Message is required', 'message');
         }
         if (options.message.length > 1600) {
-            throw new errors_1.ValidationError('Message must be 1600 characters or less', 'message');
+            throw new errors_2.ValidationError('Message must be 1600 characters or less', 'message');
         }
         const recipientCount = Array.isArray(options.to_number) ? options.to_number.length : 1;
         if (recipientCount > 10) {
-            throw new errors_1.ValidationError('Maximum 10 recipients allowed', 'to_number');
+            throw new errors_2.ValidationError('Maximum 10 recipients allowed', 'to_number');
         }
         const payload = {
             message: options.message,
@@ -582,12 +642,12 @@ class OneShot {
             on400: async (resp) => {
                 const errorData = await resp.json();
                 if (errorData.error === 'content_blocked') {
-                    throw new errors_1.ContentBlockedError(errorData.message, errorData.categories || []);
+                    throw new errors_2.ContentBlockedError(errorData.message, errorData.categories || []);
                 }
                 if (errorData.error === 'emergency_number_blocked') {
-                    throw new errors_1.EmergencyNumberError(errorData.message, errorData.blocked_number || '');
+                    throw new errors_2.EmergencyNumberError(errorData.message, errorData.blocked_number || '');
                 }
-                throw new errors_1.ValidationError(errorData.message || 'Invalid request', 'request');
+                throw new errors_2.ValidationError(errorData.message || 'Invalid request', 'request');
             },
         });
         if (sendResp.status !== 202) {
@@ -621,7 +681,7 @@ class OneShot {
         this.validate(options.product?.name, 'product.name');
         this.validate(options.product?.description, 'product.description');
         if (options.product.description.length < 10) {
-            throw new errors_1.ValidationError('Product description must be at least 10 characters', 'product.description');
+            throw new errors_2.ValidationError('Product description must be at least 10 characters', 'product.description');
         }
         const payload = {
             type: options.type ?? 'saas',
@@ -656,7 +716,7 @@ class OneShot {
             },
             on400: async (resp) => {
                 const errorData = await resp.json();
-                throw new errors_1.ValidationError(errorData.message || 'Invalid request', 'request');
+                throw new errors_2.ValidationError(errorData.message || 'Invalid request', 'request');
             },
         });
         if (buildResp.status !== 202) {
@@ -684,10 +744,10 @@ class OneShot {
     async browser(options) {
         this.validate(options.task, 'task');
         if (options.task.length < 10) {
-            throw new errors_1.ValidationError('Task must be at least 10 characters', 'task');
+            throw new errors_2.ValidationError('Task must be at least 10 characters', 'task');
         }
         if (options.max_steps !== undefined && (options.max_steps < 1 || options.max_steps > 100)) {
-            throw new errors_1.ValidationError('max_steps must be between 1 and 100', 'max_steps');
+            throw new errors_2.ValidationError('max_steps must be between 1 and 100', 'max_steps');
         }
         const payload = {
             task: options.task,
@@ -718,7 +778,7 @@ class OneShot {
             onQuote: (ctx) => this.log(`Browser quote: $${ctx.estimated_cost} for ~${ctx.estimated_steps} steps`),
             on400: async (resp) => {
                 const errorData = await resp.json();
-                throw new errors_1.ValidationError(errorData.message || 'Invalid request', 'request');
+                throw new errors_2.ValidationError(errorData.message || 'Invalid request', 'request');
             },
         });
         if (execResp.status !== 202) {
@@ -748,7 +808,7 @@ class OneShot {
             body: JSON.stringify({ name }),
         });
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to create browser profile', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to create browser profile', response.status, await response.text());
         }
         return response.json();
     }
@@ -768,7 +828,7 @@ class OneShot {
             headers: await this.signedReadHeaders(),
         });
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to list browser profiles', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to list browser profiles', response.status, await response.text());
         }
         const data = await response.json();
         return data.profiles;
@@ -788,7 +848,7 @@ class OneShot {
             headers: await this.signedReadHeaders(),
         });
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to delete browser profile', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to delete browser profile', response.status, await response.text());
         }
     }
     /**
@@ -834,7 +894,7 @@ class OneShot {
             headers: await this.signedReadHeaders()
         });
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to list SMS inbox', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to list SMS inbox', response.status, await response.text());
         }
         return response.json();
     }
@@ -853,10 +913,10 @@ class OneShot {
             headers: await this.signedReadHeaders()
         });
         if (response.status === 404) {
-            throw new errors_1.ToolError('SMS message not found', 404, 'Message not found');
+            throw new errors_2.ToolError('SMS message not found', 404, 'Message not found');
         }
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to get SMS message', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to get SMS message', response.status, await response.text());
         }
         return response.json();
     }
@@ -881,7 +941,7 @@ class OneShot {
             headers: await this.signedReadHeaders()
         });
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to list notifications', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to list notifications', response.status, await response.text());
         }
         return response.json();
     }
@@ -900,10 +960,10 @@ class OneShot {
             headers: await this.signedReadHeaders()
         });
         if (response.status === 404) {
-            throw new errors_1.ToolError('Notification not found', 404, 'Notification not found');
+            throw new errors_2.ToolError('Notification not found', 404, 'Notification not found');
         }
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to mark notification as read', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to mark notification as read', response.status, await response.text());
         }
     }
     async getUnifiedBalance() {
@@ -911,7 +971,7 @@ class OneShot {
             headers: await this.signedReadHeaders()
         });
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to fetch balance', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to fetch balance', response.status, await response.text());
         }
         return response.json();
     }
@@ -981,9 +1041,9 @@ class OneShot {
             on400: async (resp) => {
                 const errorData = await resp.json();
                 if (errorData.error === 'content_blocked') {
-                    throw new errors_1.ContentBlockedError(errorData.message, []);
+                    throw new errors_2.ContentBlockedError(errorData.message, []);
                 }
-                throw new errors_1.ValidationError(errorData.message || 'Invalid request', 'request');
+                throw new errors_2.ValidationError(errorData.message || 'Invalid request', 'request');
             },
         });
         if (createResp.status !== 202) {
@@ -1006,10 +1066,10 @@ class OneShot {
             headers: this.headers()
         });
         if (response.status === 404) {
-            throw new errors_1.ToolError('Goal not found', 404, 'Goal not found');
+            throw new errors_2.ToolError('Goal not found', 404, 'Goal not found');
         }
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to get compute goal', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to get compute goal', response.status, await response.text());
         }
         const json = await response.json();
         return json.data;
@@ -1031,7 +1091,7 @@ class OneShot {
             headers: this.headers()
         });
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to get compute tasks', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to get compute tasks', response.status, await response.text());
         }
         const json = await response.json();
         return json.data;
@@ -1051,10 +1111,10 @@ class OneShot {
             headers: this.headers()
         });
         if (response.status === 404) {
-            throw new errors_1.ToolError('Budget not found', 404, 'Budget not found for this goal');
+            throw new errors_2.ToolError('Budget not found', 404, 'Budget not found for this goal');
         }
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to get compute budget', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to get compute budget', response.status, await response.text());
         }
         const json = await response.json();
         return json.data;
@@ -1076,10 +1136,10 @@ class OneShot {
             body: JSON.stringify({ reason })
         });
         if (response.status === 404) {
-            throw new errors_1.ToolError('Goal not found', 404, 'Goal not found');
+            throw new errors_2.ToolError('Goal not found', 404, 'Goal not found');
         }
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to cancel compute goal', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to cancel compute goal', response.status, await response.text());
         }
         const json = await response.json();
         return json.data;
@@ -1105,10 +1165,10 @@ class OneShot {
             body: JSON.stringify(input)
         });
         if (response.status === 404) {
-            throw new errors_1.ToolError('Goal or task not found', 404, await response.text());
+            throw new errors_2.ToolError('Goal or task not found', 404, await response.text());
         }
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to respond to compute task', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to respond to compute task', response.status, await response.text());
         }
         const json = await response.json();
         return json.data;
@@ -1129,7 +1189,7 @@ class OneShot {
             body: JSON.stringify({ reason })
         });
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to pause compute goal', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to pause compute goal', response.status, await response.text());
         }
         const json = await response.json();
         return json.data;
@@ -1151,7 +1211,7 @@ class OneShot {
             body: JSON.stringify({})
         });
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to resume compute goal', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to resume compute goal', response.status, await response.text());
         }
         const json = await response.json();
         return json.data;
@@ -1171,7 +1231,7 @@ class OneShot {
     async fundComputeGoal(goalId, amount) {
         this.validate(goalId, 'goalId');
         if (!amount || amount <= 0) {
-            throw new errors_1.ValidationError('amount must be a positive number', 'amount');
+            throw new errors_2.ValidationError('amount must be a positive number', 'amount');
         }
         const path = `/v1/compute/${goalId}/fund`;
         const payload = { amount };
@@ -1224,7 +1284,7 @@ class OneShot {
             headers: this.headers()
         });
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to get spend breakdown', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to get spend breakdown', response.status, await response.text());
         }
         return response.json();
     }
@@ -1243,7 +1303,7 @@ class OneShot {
             headers: this.headers()
         });
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to get RoCS', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to get RoCS', response.status, await response.text());
         }
         return response.json();
     }
@@ -1279,7 +1339,7 @@ class OneShot {
             headers: this.headers()
         });
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to list receipts', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to list receipts', response.status, await response.text());
         }
         return response.json();
     }
@@ -1318,7 +1378,7 @@ class OneShot {
                 body: JSON.stringify({ goal_id: ref.goalId, ...valueTag }),
             });
             if (!response.ok) {
-                throw new errors_1.ToolError('Failed to record outcome value', response.status, await response.text());
+                throw new errors_2.ToolError('Failed to record outcome value', response.status, await response.text());
             }
             return;
         }
@@ -1330,10 +1390,10 @@ class OneShot {
             body: JSON.stringify(valueTag)
         });
         if (response.status === 404) {
-            throw new errors_1.ToolError('Receipt not found', 404, 'Receipt not found or not owned by this agent');
+            throw new errors_2.ToolError('Receipt not found', 404, 'Receipt not found or not owned by this agent');
         }
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to tag receipt value', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to tag receipt value', response.status, await response.text());
         }
     }
     /**
@@ -1359,7 +1419,7 @@ class OneShot {
             headers: this.headers()
         });
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to get RoCS by goal', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to get RoCS by goal', response.status, await response.text());
         }
         return response.json();
     }
@@ -1372,7 +1432,7 @@ class OneShot {
     }
     validate(value, field) {
         if (!value)
-            throw new errors_1.ValidationError(`${field} is required`, field);
+            throw new errors_2.ValidationError(`${field} is required`, field);
     }
     headers() {
         return {
@@ -1466,11 +1526,11 @@ class OneShot {
                 });
             }
             catch (err) {
-                throw new errors_1.BudgetSyncError(`Could not sync spend budget (network): ${err}`);
+                throw new errors_2.BudgetSyncError(`Could not sync spend budget (network): ${err}`);
             }
             if (!response.ok) {
                 const text = await response.text();
-                throw new errors_1.BudgetSyncError(`Could not sync spend budget (${response.status}): ${text}`, response.status, text);
+                throw new errors_2.BudgetSyncError(`Could not sync spend budget (${response.status}): ${text}`, response.status, text);
             }
             this.log('Budget synced');
         })();
@@ -1498,7 +1558,7 @@ class OneShot {
             return;
         const amount = parseFloat(total);
         if (Number.isFinite(amount) && amount > cap) {
-            throw new errors_1.BudgetExceededError(`Quote $${total} exceeds this agent's per-transaction budget of $${cap}`, 'per_transaction', cap, undefined, amount);
+            throw new errors_2.BudgetExceededError(`Quote $${total} exceeds this agent's per-transaction budget of $${cap}`, 'per_transaction', cap, undefined, amount);
         }
     }
     /**
@@ -1515,7 +1575,7 @@ class OneShot {
             headers: await this.signedReadHeaders(),
         });
         if (!response.ok) {
-            throw new errors_1.ToolError('Failed to fetch budgets', response.status, await response.text());
+            throw new errors_2.ToolError('Failed to fetch budgets', response.status, await response.text());
         }
         const body = await response.json();
         return (body.data ?? body);
@@ -1523,7 +1583,7 @@ class OneShot {
     /** Local fast-fail guard: throw when a quote total exceeds the caller's cap. */
     assertWithinMaxCost(total, maxCost) {
         if (maxCost && parseFloat(total) > maxCost) {
-            throw new errors_1.OneShotError(`Quote $${total} exceeds maxCost $${maxCost}`);
+            throw new errors_2.OneShotError(`Quote $${total} exceeds maxCost $${maxCost}`);
         }
     }
     /**
@@ -1569,7 +1629,7 @@ class OneShot {
         const budget = response.status === 403 ? this.parseBudgetRejection(text) : undefined;
         if (budget)
             throw budget;
-        throw new errors_1.ToolError(message, response.status, text);
+        throw new errors_2.ToolError(message, response.status, text);
     }
     /**
      * Map a 403 `budget_exceeded` body onto a typed error, so callers can catch
@@ -1582,7 +1642,7 @@ class OneShot {
             if (body.error !== 'budget_exceeded')
                 return undefined;
             const b = body.budget ?? {};
-            return new errors_1.BudgetExceededError(body.message ?? 'Agent spend budget exceeded', b.reason === 'per_transaction' ? 'per_transaction' : 'daily', b.cap !== undefined ? parseFloat(b.cap) : undefined, b.spent !== undefined ? parseFloat(b.spent) : undefined, b.charge !== undefined ? parseFloat(b.charge) : undefined, b.resets_at);
+            return new errors_2.BudgetExceededError(body.message ?? 'Agent spend budget exceeded', b.reason === 'per_transaction' ? 'per_transaction' : 'daily', b.cap !== undefined ? parseFloat(b.cap) : undefined, b.spent !== undefined ? parseFloat(b.spent) : undefined, b.charge !== undefined ? parseFloat(b.charge) : undefined, b.resets_at);
         }
         catch {
             return undefined;
@@ -1605,7 +1665,7 @@ class OneShot {
             expectedAmount ? `expected $${expectedAmount}` : null,
             receivedAmount ? `signed $${receivedAmount}` : null,
         ].filter(Boolean).join(', ');
-        return new errors_1.PaymentError(`payment rejected: ${reason}${detail ? ` — ${detail}` : ''}${data.message ? ` (${data.message})` : ''}`, reason, {
+        return new errors_2.PaymentError(`payment rejected: ${reason}${detail ? ` — ${detail}` : ''}${data.message ? ` (${data.message})` : ''}`, reason, {
             amount: expectedAmount,
             asset: data.expected?.asset,
             network: data.expected?.network,
@@ -1641,8 +1701,59 @@ class OneShot {
             return undefined;
         return { 'Idempotency-Key': idempotencyKey };
     }
+    async readReliabilityJson(path, signed, allowDegraded = false) {
+        const scope = (0, deadline_1.deadlineScope)(undefined, signed ? 10000 : 5000);
+        try {
+            return await (0, deadline_1.abortable)((async () => {
+                const headers = signed ? await this.signedReadHeaders() : undefined;
+                if (scope.signal.aborted)
+                    throw new errors_2.OneShotError('Read deadline exceeded');
+                const response = await fetch(`${this.baseUrl}${path}`, { headers, signal: scope.signal });
+                if (!response.ok && !(allowDegraded && response.status === 503))
+                    await this.failFromResponse('Reliability read failed', response);
+                return await response.json();
+            })(), scope.signal);
+        }
+        finally {
+            scope.close();
+        }
+    }
+    async recoverRequest(options) {
+        const query = new URLSearchParams({ endpoint: options.endpoint, key: options.idempotencyKey });
+        return this.readReliabilityJson(`/v1/submissions/recover?${query}`, true);
+    }
+    async getServiceStatus() {
+        return this.readReliabilityJson('/v1/status', false, true);
+    }
     async executeToolRequest(endpoint, options, quoteId) {
-        const { signal, onStatusUpdate, wait = true, waitForPhones, phoneTimeoutSec, idempotencyKey, maxCost, ...payload } = options;
+        const reliable = /(?:^|\/)(enrich\/(profile|email)|verify\/email)$/.test(endpoint);
+        const key = options.idempotencyKey ?? (reliable ? ethers_1.ethers.hexlify(ethers_1.ethers.randomBytes(16)) : undefined);
+        if (options.totalTimeoutMs !== undefined && (!Number.isFinite(options.totalTimeoutMs) || options.totalTimeoutMs <= 0)) {
+            throw new errors_2.ValidationError('totalTimeoutMs must be positive', 'totalTimeoutMs');
+        }
+        const scope = (0, deadline_1.deadlineScope)(options.signal, options.totalTimeoutMs);
+        const context = { phase: 'initialization' };
+        const started = Date.now();
+        try {
+            if (scope.signal.aborted)
+                throw new errors_2.OneShotError('Operation cancelled');
+            if (key)
+                options.onRequestCreated?.({ idempotencyKey: key });
+            return await (0, deadline_1.abortable)(this.executeToolRequestImpl(endpoint, { ...options, idempotencyKey: key, signal: scope.signal }, quoteId, context), scope.signal);
+        }
+        catch (error) {
+            if (scope.timedOut())
+                throw new errors_1.RequestTimeoutError(Date.now() - started, context.phase, key, context.requestId, context.receiptId);
+            if (error instanceof Error)
+                Object.assign(error, { idempotencyKey: key, requestId: context.requestId, receiptId: context.receiptId, phase: context.phase });
+            throw error;
+        }
+        finally {
+            scope.close();
+        }
+    }
+    async executeToolRequestImpl(endpoint, options, quoteId, context = { phase: "initialization" }) {
+        const { totalTimeoutMs, onRequestCreated, onAccepted, signal, onStatusUpdate, wait = true, waitForPhones, phoneTimeoutSec, idempotencyKey, maxCost, ...payload } = options;
         const extraHeaders = {
             ...this.maxCostHeader(maxCost),
             ...this.idempotencyHeader(idempotencyKey),
@@ -1671,11 +1782,18 @@ class OneShot {
             }
         }
         if (signal?.aborted) {
-            throw new errors_1.OneShotError('Operation cancelled');
+            throw new errors_2.OneShotError('Operation cancelled');
         }
         // One-time push of config.budgets before the first paid call, so the
         // server-side gate knows about them on this very request.
         await this.ensureBudgetsSynced();
+        if (signal?.aborted)
+            throw new errors_2.OneShotError('Operation cancelled');
+        if (idempotencyKey)
+            Object.assign(extraHeaders, { 'x-agent-proof': 'required' });
+        if (signal?.aborted)
+            throw new errors_2.OneShotError('Operation cancelled');
+        context.phase = 'submission';
         let response = await this.makeRequest(endpoint, payload, undefined, quoteId, signal, undefined, extraHeaders);
         // Handle 402 Payment Required
         if (response.status === 402) {
@@ -1696,7 +1814,10 @@ class OneShot {
             this.log(`Payment required: ${paymentInfo.amount} USDC`);
             this.assertWithinBudget(paymentInfo.amount);
             this.checkAbortBeforePayment(signal);
+            context.phase = 'payment';
             const signed = await this.signPaymentAuthorization(paymentInfo, accepted, resource, extensions);
+            this.checkAbortBeforePayment(signal);
+            context.phase = 'submission';
             response = await this.makePaidRequest(signed, endpoint, payload, quoteId, signal, undefined, extraHeaders);
         }
         if (!response.ok) {
@@ -1705,11 +1826,19 @@ class OneShot {
         const result = await response.json();
         // Handle async jobs
         if ((result.status === 'pending' || result.status === 'processing') && result.request_id) {
+            context.requestId = String(result.request_id);
+            context.receiptId = typeof result.receipt_id === 'string' ? result.receipt_id : undefined;
+            onAccepted?.({ request_id: context.requestId, receipt_id: context.receiptId, idempotencyKey });
+            context.phase = 'polling';
             this.log(`Job queued: ${result.request_id}`);
             if (!wait) {
-                return { request_id: result.request_id, status: result.status };
+                return { ...result, idempotencyKey };
+            }
+            const completed = await this.pollJob(result.request_id, options.timeout, signal, onStatusUpdate, waitForPhones ? { waitForPhones, phoneTimeoutSec } : undefined);
+            if (completed && typeof completed === 'object' && !Array.isArray(completed)) {
+                return { ...completed, request_id: context.requestId, receipt_id: completed.receipt_id ?? context.receiptId, idempotencyKey };
             }
-            return this.pollJob(result.request_id, options.timeout, signal, onStatusUpdate, waitForPhones ? { waitForPhones, phoneTimeoutSec } : undefined);
+            return completed;
         }
         return (result.data ?? result);
     }
@@ -1788,7 +1917,7 @@ class OneShot {
         const wsBranch = this.waitViaWebSocket(requestId, inner.signal, emit, wait).catch((err) => {
             // A failed job or a cancellation is a real outcome. Anything else is a
             // transport problem: never settle the race on it, HTTP carries on.
-            if (err instanceof errors_1.OneShotError)
+            if (err instanceof errors_2.OneShotError)
                 throw err;
             this.log(`WebSocket unavailable (${err instanceof Error ? err.message : String(err)}) — relying on HTTP polling`);
             return new Promise(() => { });
@@ -1858,7 +1987,7 @@ class OneShot {
         let lastResult = initialResult;
         while (Date.now() < deadline) {
             if (signal?.aborted)
-                throw new errors_1.OneShotError('Operation cancelled');
+                throw new errors_2.OneShotError('Operation cancelled');
             try {
                 const resp = await fetch(`${this.baseUrl}/v1/requests/${requestId}`, {
                     headers: this.headers(),
@@ -1869,7 +1998,7 @@ class OneShot {
                     // whatever we last had so consumers don't lose the sync result.
                     if (lastResult !== undefined)
                         return lastResult;
-                    throw new errors_1.ToolError('Failed to check job status', resp.status, await resp.text());
+                    throw new errors_2.ToolError('Failed to check job status', resp.status, await resp.text());
                 }
                 const job = await resp.json();
                 lastResult = (job.result ?? job);
@@ -1878,7 +2007,7 @@ class OneShot {
                 }
             }
             catch (err) {
-                if (err instanceof errors_1.OneShotError)
+                if (err instanceof errors_2.OneShotError)
                     throw err;
                 if (lastResult !== undefined)
                     return lastResult;
@@ -1904,7 +2033,7 @@ class OneShot {
                 return reject(new Error('WebSocket not available'));
             }
             if (signal.aborted) {
-                return reject(new errors_1.OneShotError('Operation cancelled'));
+                return reject(new errors_2.OneShotError('Operation cancelled'));
             }
             const wsUrl = this.baseUrl.replace(/^http/, 'ws') +
                 `/v1/requests/subscribe?wallet=${encodeURIComponent(this.provider.address)}`;
@@ -1932,7 +2061,7 @@ class OneShot {
             const onAbort = () => {
                 settle(() => {
                     cleanup();
-                    reject(new errors_1.OneShotError('Operation cancelled'));
+                    reject(new errors_2.OneShotError('Operation cancelled'));
                 });
             };
             signal.addEventListener('abort', onAbort, { once: true });
@@ -1965,7 +2094,7 @@ class OneShot {
                         settle(() => {
                             cleanup();
                             wait.via = 'ws';
-                            reject(new errors_1.JobError(`Job failed: ${msg.error ?? 'Unknown'}`, requestId, String(msg.error ?? 'Unknown'), msg.error_code));
+                            reject(new errors_2.JobError(`Job failed: ${msg.error ?? 'Unknown'}`, requestId, String(msg.error ?? 'Unknown'), msg.error_code));
                         });
                     }
                     else {
@@ -1998,6 +2127,21 @@ class OneShot {
      * Owns the caller's deadline (`JobTimeoutError`).
      */
     async pollJobHttp(requestId, timeoutSec, signal, emit, wait) {
+        const scope = (0, deadline_1.deadlineScope)(signal, (timeoutSec ?? 120) * 1000);
+        const started = Date.now();
+        try {
+            return await (0, deadline_1.abortable)(this.pollJobHttpImpl(requestId, timeoutSec, scope.signal, emit, wait), scope.signal);
+        }
+        catch (error) {
+            if (scope.timedOut())
+                throw new errors_2.JobTimeoutError(requestId, Date.now() - started);
+            throw error;
+        }
+        finally {
+            scope.close();
+        }
+    }
+    async pollJobHttpImpl(requestId, timeoutSec, signal, emit, wait) {
         const maxWaitMs = (timeoutSec ?? 120) * 1000;
         const startTime = Date.now();
         let retries = 0;
@@ -2005,7 +2149,7 @@ class OneShot {
         let polls = 0;
         while (Date.now() - startTime < maxWaitMs) {
             if (signal?.aborted)
-                throw new errors_1.OneShotError('Operation cancelled');
+                throw new errors_2.OneShotError('Operation cancelled');
             try {
                 const resp = await fetch(`${this.baseUrl}/v1/requests/${requestId}`, {
                     headers: this.headers(),
@@ -2018,7 +2162,7 @@ class OneShot {
                     if (resp.status >= 500 || resp.status === 429) {
                         throw new Error(`Poll returned ${resp.status}: ${body.slice(0, 200)}`);
                     }
-                    throw new errors_1.ToolError('Failed to check job status', resp.status, body);
+                    throw new errors_2.ToolError('Failed to check job status', resp.status, body);
                 }
                 const job = await resp.json();
                 if (job.status === 'completed') {
@@ -2030,12 +2174,18 @@ class OneShot {
                     if (job.request_id && typeof result === 'object' && result !== null && !('request_id' in result)) {
                         result.request_id = job.request_id;
                     }
+                    if (result && typeof result === 'object' && !Array.isArray(result)) {
+                        if (job.receipt_id && !result.receipt_id)
+                            result.receipt_id = job.receipt_id;
+                        if (job.settlement_status && !result.settlement_status)
+                            result.settlement_status = job.settlement_status;
+                    }
                     return result;
                 }
                 if (job.status === 'failed') {
                     if (wait)
                         wait.via = 'http';
-                    throw new errors_1.JobError(`Job failed: ${job.error ?? 'Unknown'}`, requestId, String(job.error ?? 'Unknown'), job.error_code);
+                    throw new errors_2.JobError(`Job failed: ${job.error ?? 'Unknown'}`, requestId, String(job.error ?? 'Unknown'), job.error_code);
                 }
                 emit?.(String(job.status));
                 retries = 0;
@@ -2049,27 +2199,27 @@ class OneShot {
                 await this.sleep(Math.min(interval, remaining), signal);
             }
             catch (err) {
-                if (err instanceof errors_1.OneShotError)
+                if (err instanceof errors_2.OneShotError)
                     throw err;
                 if (++retries > maxRetries) {
-                    throw new errors_1.OneShotError(`Polling failed after ${maxRetries} retries: ${err}`);
+                    throw new errors_2.OneShotError(`Polling failed after ${maxRetries} retries: ${err}`);
                 }
                 const backoff = 2000 * Math.pow(2, retries - 1);
                 this.log(`Retry ${retries}/${maxRetries} in ${backoff}ms`);
                 await this.sleep(backoff, signal);
             }
         }
-        throw new errors_1.JobTimeoutError(requestId, Date.now() - startTime);
+        throw new errors_2.JobTimeoutError(requestId, Date.now() - startTime);
     }
     sleep(ms, signal) {
         return new Promise((resolve, reject) => {
             if (signal?.aborted) {
-                return reject(new errors_1.OneShotError('Operation cancelled'));
+                return reject(new errors_2.OneShotError('Operation cancelled'));
             }
-            const timer = setTimeout(resolve, ms);
+            const timer = setTimeout(() => { signal?.removeEventListener('abort', onAbort); resolve(); }, ms);
             const onAbort = () => {
                 clearTimeout(timer);
-                reject(new errors_1.OneShotError('Operation cancelled'));
+                reject(new errors_2.OneShotError('Operation cancelled'));
             };
             signal?.addEventListener('abort', onAbort, { once: true });
         });
@@ -2078,7 +2228,8 @@ class OneShot {
         const headers = {
             'Content-Type': 'application/json',
             ...this.headers(),
-            ...(extraHeaders ?? {})
+            ...(extraHeaders ?? {}),
+            ...(extraHeaders?.['x-agent-proof'] ? await this.signedReadHeaders(/(enrich\/(profile|email)|verify\/email|physical-mail\/send)$/.test(endpoint) ? 'submit' : 'read') : {})
         };
         if (payment) {
             const paymentJson = JSON.stringify(payment);
@@ -2089,29 +2240,27 @@ class OneShot {
         }
         if (quoteId)
             headers['x-quote-id'] = quoteId;
-        let fetchSignal = signal;
-        let timeoutId;
-        if (timeoutMs && !signal) {
-            const controller = new AbortController();
-            timeoutId = setTimeout(() => controller.abort(), timeoutMs);
-            fetchSignal = controller.signal;
-        }
+        const transportDeadline = timeoutMs === undefined ? undefined : (0, deadline_1.deadlineScope)(signal, timeoutMs);
+        const fetchSignal = transportDeadline?.signal ?? signal;
+        // Node 18 compatibility: do not require AbortSignal.any. Retain the deadline
+        // through response-body consumption; cleanup occurs when it expires/aborts.
+        transportDeadline?.signal.addEventListener('abort', () => transportDeadline.close(), { once: true });
+        if (fetchSignal?.aborted)
+            throw new errors_2.OneShotError('Operation cancelled');
+        const work = fetch(`${this.baseUrl}${endpoint}`, {
+            method: 'POST', headers, body: JSON.stringify(data), signal: fetchSignal,
+        });
         try {
-            return await fetch(`${this.baseUrl}${endpoint}`, {
-                method: 'POST',
-                headers,
-                body: JSON.stringify(data),
-                signal: fetchSignal
-            });
+            return await (fetchSignal ? (0, deadline_1.abortable)(work, fetchSignal) : work);
         }
-        finally {
-            if (timeoutId)
-                clearTimeout(timeoutId);
+        catch (error) {
+            transportDeadline?.close();
+            throw error;
         }
     }
     checkAbortBeforePayment(signal) {
         if (signal?.aborted) {
-            throw new errors_1.OneShotError('Operation cancelled before payment');
+            throw new errors_2.OneShotError('Operation cancelled before payment');
         }
     }
     // ---------------------------------------------------------------------------
@@ -2159,11 +2308,11 @@ class OneShot {
     assertEthModeSupported(paymentInfo) {
         const chainId = chainIdFromNetwork(paymentInfo.network) ?? CHAIN_ID;
         if (chainId !== CHAIN_ID) {
-            throw new errors_1.ValidationError(`ETH currency mode is only supported on Base mainnet (eip155:${CHAIN_ID}); this payment is on ${paymentInfo.network}. Fund the wallet with USDC or use currency: 'USDC'.`, 'currency');
+            throw new errors_2.ValidationError(`ETH currency mode is only supported on Base mainnet (eip155:${CHAIN_ID}); this payment is on ${paymentInfo.network}. Fund the wallet with USDC or use currency: 'USDC'.`, 'currency');
         }
         const usdcAddress = paymentInfo.token.address;
         if (usdcAddress.toLowerCase() !== USDC_ADDRESS.toLowerCase()) {
-            throw new errors_1.ValidationError(`ETH→USDC swap buys ${USDC_ADDRESS} but this payment requires ${usdcAddress}`, 'currency');
+            throw new errors_2.ValidationError(`ETH→USDC swap buys ${USDC_ADDRESS} but this payment requires ${usdcAddress}`, 'currency');
         }
         return { chainId, usdcAddress };
     }
@@ -2207,15 +2356,18 @@ class OneShot {
     }
     /**
      * How much USDC to buy: top up to `charge × swapBufferMultiplier`, counting
-     * whatever effective balance is already there. If the wallet's ETH cannot
-     * cover the buffered quote, fall back to the bare shortfall so an ETH-poor
-     * wallet can still make the one payment in front of it.
+     * whatever effective balance is already there. When the wallet provider
+     * exposes `getBalance` and its ETH cannot cover the buffered quote, fall
+     * back to the bare shortfall so an ETH-poor wallet can still make the one
+     * payment in front of it (a send-only provider always gets the buffer).
      */
     async sizeSwap(charge, effective, chainId) {
         const shortfall = charge - effective;
-        // Integer math on a 1000× scale: no float→BigInt on an unbounded value.
-        const mScaled = BigInt(Math.round(this._swapBufferMultiplier * 1000));
-        const target = (charge * mScaled + 999n) / 1000n;
+        // Integer math on a 10^6 scale (multiplier ≤ 1000, so ≤ 10^9 — always a
+        // finite, exact integer): keeps the multiplier's precision, no float→BigInt
+        // on an unbounded value.
+        const mScaled = BigInt(Math.round(this._swapBufferMultiplier * SWAP_MULTIPLIER_SCALE));
+        const target = (charge * mScaled + BigInt(SWAP_MULTIPLIER_SCALE) - 1n) / BigInt(SWAP_MULTIPLIER_SCALE);
         let amount = target > effective ? target - effective : shortfall;
         if (amount > shortfall && this.provider.getBalance) {
             try {
@@ -2245,8 +2397,8 @@ class OneShot {
     }
     /**
      * Send the paid leg of a request. The server settles the authorization only
-     * on a 2xx, so a thrown request or a non-2xx response means nothing will be
-     * debited on-chain — release the ETH-mode reservation in that case.
+     * on acceptance. A transport failure on a durable endpoint is ambiguous;
+     * retain its short-lived ETH-mode reservation until recovery or expiry.
      */
     async makePaidRequest(signed, endpoint, data, quoteId, signal, timeoutMs, extraHeaders) {
         let resp;
@@ -2254,10 +2406,11 @@ class OneShot {
             resp = await this.makeRequest(endpoint, data, signed.auth, quoteId, signal, timeoutMs, extraHeaders);
         }
         catch (err) {
-            this.releaseUsdcReservation(signed.reservation);
+            if (!/(enrich\/(profile|email)|verify\/email|physical-mail\/send)$/.test(endpoint))
+                this.releaseUsdcReservation(signed.reservation);
             throw err;
         }
-        if (!resp.ok)
+        if (!resp.ok && !(extraHeaders?.['Idempotency-Key'] && resp.status >= 500))
             this.releaseUsdcReservation(signed.reservation);
         return resp;
     }