@zkp2p/cash 0.1.2 → 0.1.4

package/dist/tools.d.cts

@@ -18,14 +18,293 @@ interface CashToolDefinition {
     /** JSON Schema (draft-07 compatible) for the tool input. */
     inputSchema: Record<string, unknown>;
 }
+declare const builtInCashTools: readonly [{
+    readonly name: "cash_capabilities";
+    readonly description: "Discover what Peer Cash can do: payout platforms, oracle-priced currencies per platform, Base USDC destination, default Base USDC source, payee handle hints, and amount bounds. Set includeRelaySources=true to fetch live Relay-supported EVM source chains/tokens through the Relay SDK.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly includeRelaySources: {
+                readonly type: "boolean";
+                readonly description: "Fetch live Relay SDK EVM source chain/token metadata.";
+            };
+        };
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "cash_source_quote";
+    readonly description: "Quote any Relay-supported EVM source asset into Base USDC through @relayprotocol/relay-sdk. A custody-capable host must submit the returned route, poll cash_source_status to success, then call Base-USDC cash_cashout with the guaranteed output amount. Never submit the route twice.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly user: {
+                readonly description: "Source wallet submitting the Relay transaction.";
+                readonly type: "string";
+                readonly pattern: "^0x[0-9a-fA-F]{40}$";
+            };
+            readonly amount: {
+                readonly type: "string";
+                readonly pattern: "^0*[1-9][0-9]*$";
+                readonly description: "Base units as a decimal string. For the default path this is USDC 6 decimals; with source it is source-token base units.";
+            };
+            readonly source: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly chainId: {
+                        readonly description: "Relay-supported EVM source chain id.";
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: number;
+                    };
+                    readonly currency: {
+                        readonly description: "Source token/native address.";
+                        readonly type: "string";
+                        readonly pattern: "^0x[0-9a-fA-F]{40}$";
+                    };
+                };
+                readonly required: readonly ["chainId", "currency"];
+                readonly additionalProperties: false;
+            };
+            readonly recipient: {
+                readonly description: "Base recipient for Relay-delivered USDC. Defaults to user.";
+                readonly type: "string";
+                readonly pattern: "^0x[0-9a-fA-F]{40}$";
+            };
+            readonly tradeType: {
+                readonly type: "string";
+                readonly enum: readonly ["EXACT_INPUT", "EXACT_OUTPUT", "EXPECTED_OUTPUT"];
+                readonly description: "Relay quote trade type. Defaults to EXACT_INPUT.";
+            };
+        };
+        readonly required: readonly ["user", "amount", "source"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "cash_estimate";
+    readonly description: "Estimate fiat received at the live oracle market rate and include a simple recent-fill ETA. Without source, amount is Base USDC. With source, the SDK first quotes source->Base USDC through Relay SDK, then estimates the cashout.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly amount: {
+                readonly type: "string";
+                readonly pattern: "^0*[1-9][0-9]*$";
+                readonly description: "Base units as a decimal string. For the default path this is USDC 6 decimals; with source it is source-token base units.";
+            };
+            readonly currency: {
+                readonly type: "string";
+                readonly description: "Fiat currency code from cash_capabilities, e.g. \"USD\"";
+            };
+            readonly platform: {
+                readonly type: "string";
+                readonly description: "Optional payout platform for platform-specific ETA sampling.";
+            };
+            readonly source: {
+                readonly type: "object";
+                readonly description: "Optional Relay EVM source asset. Omit for the Base USDC default path.";
+                readonly properties: {
+                    readonly chainId: {
+                        readonly description: "Relay-supported EVM source chain id.";
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: number;
+                    };
+                    readonly currency: {
+                        readonly description: "Source token/native address.";
+                        readonly type: "string";
+                        readonly pattern: "^0x[0-9a-fA-F]{40}$";
+                    };
+                    readonly user: {
+                        readonly description: "Source wallet submitting the Relay transaction.";
+                        readonly type: "string";
+                        readonly pattern: "^0x[0-9a-fA-F]{40}$";
+                    };
+                    readonly recipient: {
+                        readonly description: "Base recipient for Relay-delivered USDC. Defaults to user.";
+                        readonly type: "string";
+                        readonly pattern: "^0x[0-9a-fA-F]{40}$";
+                    };
+                    readonly tradeType: {
+                        readonly type: "string";
+                        readonly enum: readonly ["EXACT_INPUT", "EXACT_OUTPUT", "EXPECTED_OUTPUT"];
+                    };
+                };
+                readonly required: readonly ["chainId", "currency", "user"];
+                readonly additionalProperties: false;
+            };
+        };
+        readonly required: readonly ["amount", "currency"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "cash_cashout";
+    readonly description: "Start a Base-USDC cash-out using the custody-separated prepare path. Returns UNSIGNED transactions plus same-index steps [approve, createDeposit]; signing and ordered submission stay host-side. For another source asset, complete cash_source_quote and cash_source_status first, then pass the guaranteed Base USDC output amount here.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly amount: {
+                readonly type: "string";
+                readonly pattern: "^0*[1-9][0-9]*$";
+                readonly description: "Base units as a decimal string. For the default path this is USDC 6 decimals; with source it is source-token base units.";
+            };
+            readonly receive: {
+                readonly type: "object";
+                readonly description: "Where the fiat should arrive";
+                readonly properties: {
+                    readonly platform: {
+                        readonly type: "string";
+                        readonly description: "Platform id from cash_capabilities, e.g. \"venmo\"";
+                    };
+                    readonly currency: {
+                        readonly type: "string";
+                        readonly description: "Fiat currency code, e.g. \"USD\"";
+                    };
+                    readonly payee: {
+                        readonly type: "object";
+                        readonly description: "Payee handle for the platform";
+                        readonly properties: {
+                            readonly offchainId: {
+                                readonly type: "string";
+                                readonly description: "The handle, e.g. \"@andrew\" for Venmo - see payeeHint in cash_capabilities";
+                            };
+                        };
+                        readonly required: readonly ["offchainId"];
+                        readonly additionalProperties: true;
+                    };
+                };
+                readonly required: readonly ["platform", "currency", "payee"];
+                readonly additionalProperties: false;
+            };
+        };
+        readonly required: readonly ["amount", "receive"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "cash_order";
+    readonly description: "Observe one cash-out order by depositId - fully resumable, no session state. Returns state (awaiting-buyer | matched | delivering | delivered | returned), amounts, fills, and nextActions (wait | withdraw). Errors are typed with retryable + remediation; ORDER_NOT_FOUND right after cashout means indexer lag - retry in a few seconds.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly depositId: {
+                readonly type: "string";
+                readonly pattern: "^0x[0-9a-fA-F]{40}_[0-9]+$";
+                readonly description: "Composite deposit id (escrow_onchainId) returned by cash_cashout - the resume key";
+            };
+        };
+        readonly required: readonly ["depositId"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "cash_orders";
+    readonly description: "List all cash-out orders for a wallet address (the chain is the database - a cash order IS a deposit, keyed by depositor). Use inFlight=true for only the orders still needing attention.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly owner: {
+                readonly description: "The maker wallet address (0x...)";
+                readonly type: "string";
+                readonly pattern: "^0x[0-9a-fA-F]{40}$";
+            };
+            readonly inFlight: {
+                readonly type: "boolean";
+                readonly description: "Only awaiting-buyer / matched / delivering orders";
+            };
+            readonly limit: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 1000;
+                readonly description: "Max deposits to scan (default 100)";
+            };
+        };
+        readonly required: readonly ["owner"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "cash_buyer";
+    readonly description: "Look up a buyer's protocol track record from their full intent history: lifetime intents, fulfilled vs pruned counts, success rate (bps), first/last seen. Use during the matched state to answer \"who just committed to my order?\".";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly address: {
+                readonly description: "The buyer (taker) wallet address (0x...)";
+                readonly type: "string";
+                readonly pattern: "^0x[0-9a-fA-F]{40}$";
+            };
+        };
+        readonly required: readonly ["address"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "cash_source_status";
+    readonly description: "Read Relay request status through the Relay SDK request utility using the requestId returned from cash_source_quote or Relay execution progress.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly requestId: {
+                readonly type: "string";
+                readonly description: "Relay request id.";
+            };
+        };
+        readonly required: readonly ["requestId"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "cash_withdraw";
+    readonly description: "Unwind a cash-out: returns UNSIGNED transaction(s) plus same-index steps (prepare path - signing stays host-side). With amount: partial withdrawal of the unlocked balance (a live buyer intent does not block it). Without amount: closes the order fully, state-aware - when the only live intents have expired it includes a pruneExpiredIntents transaction first; while a live buyer intent locks funds it fails with ACTIVE_INTENT_BLOCKS_WITHDRAWAL (retryable - wait for expiry).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly depositId: {
+                readonly type: "string";
+                readonly pattern: "^0x[0-9a-fA-F]{40}_[0-9]+$";
+                readonly description: "Composite deposit id (escrow_onchainId) returned by cash_cashout - the resume key";
+            };
+            readonly amount: {
+                readonly description: "Optional partial amount (USDC base units, decimal string). Omit to close the order fully.";
+                readonly type: "string";
+                readonly pattern: "^0*[1-9][0-9]*$";
+            };
+        };
+        readonly required: readonly ["depositId"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "cash_topup";
+    readonly description: "Add USDC to a live cash-out order (same payee, same market rate). Returns UNSIGNED transactions plus same-index steps [approve, addFunds] for the host to sign and submit in order. Fails with ORDER_NOT_ACTIVE if the order is already delivered or returned.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly depositId: {
+                readonly type: "string";
+                readonly pattern: "^0x[0-9a-fA-F]{40}_[0-9]+$";
+                readonly description: "Composite deposit id (escrow_onchainId) returned by cash_cashout - the resume key";
+            };
+            readonly amount: {
+                readonly type: "string";
+                readonly pattern: "^0*[1-9][0-9]*$";
+                readonly description: "Base units as a decimal string. For the default path this is USDC 6 decimals; with source it is source-token base units.";
+            };
+        };
+        readonly required: readonly ["depositId", "amount"];
+        readonly additionalProperties: false;
+    };
+}];
+/** Literal names shipped by this package. Use this for exhaustive built-in dispatch. */
+type BuiltInCashToolName = (typeof builtInCashTools)[number]['name'];
+/**
+ * Mutable tool registry for hosts that append their own definitions.
+ *
+ * This was part of the 0.1.x public contract: keep the element name open as a
+ * string rather than narrowing consumers to only the built-in verbs.
+ */
 declare const cashTools: CashToolDefinition[];
 /** Manifest wrapper with versioning for host registries. */
 declare const cashToolManifest: {
     readonly name: "@zkp2p/cash";
-    readonly version: "0.1.2";
+    readonly version: string;
     readonly description: "Peer Cash - offramp-only: route any Relay-supported EVM source asset to Base USDC, then cash out to fiat at the live oracle market rate (0% spread). Mutating protocol tools return unsigned transactions plus step labels with ERC-8021 peer-cash attribution.";
     readonly tools: CashToolDefinition[];
 };
-type CashToolName = (typeof cashTools)[number]['name'];
+/** Tool names accepted by an extensible host registry, including custom tools. */
+type CashToolName = string;
 
-export { type CashToolDefinition, type CashToolName, cashToolManifest, cashTools };
+export { type BuiltInCashToolName, type CashToolDefinition, type CashToolName, cashToolManifest, cashTools };

package/dist/tools.d.ts

@@ -18,14 +18,293 @@ interface CashToolDefinition {
     /** JSON Schema (draft-07 compatible) for the tool input. */
     inputSchema: Record<string, unknown>;
 }
+declare const builtInCashTools: readonly [{
+    readonly name: "cash_capabilities";
+    readonly description: "Discover what Peer Cash can do: payout platforms, oracle-priced currencies per platform, Base USDC destination, default Base USDC source, payee handle hints, and amount bounds. Set includeRelaySources=true to fetch live Relay-supported EVM source chains/tokens through the Relay SDK.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly includeRelaySources: {
+                readonly type: "boolean";
+                readonly description: "Fetch live Relay SDK EVM source chain/token metadata.";
+            };
+        };
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "cash_source_quote";
+    readonly description: "Quote any Relay-supported EVM source asset into Base USDC through @relayprotocol/relay-sdk. A custody-capable host must submit the returned route, poll cash_source_status to success, then call Base-USDC cash_cashout with the guaranteed output amount. Never submit the route twice.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly user: {
+                readonly description: "Source wallet submitting the Relay transaction.";
+                readonly type: "string";
+                readonly pattern: "^0x[0-9a-fA-F]{40}$";
+            };
+            readonly amount: {
+                readonly type: "string";
+                readonly pattern: "^0*[1-9][0-9]*$";
+                readonly description: "Base units as a decimal string. For the default path this is USDC 6 decimals; with source it is source-token base units.";
+            };
+            readonly source: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly chainId: {
+                        readonly description: "Relay-supported EVM source chain id.";
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: number;
+                    };
+                    readonly currency: {
+                        readonly description: "Source token/native address.";
+                        readonly type: "string";
+                        readonly pattern: "^0x[0-9a-fA-F]{40}$";
+                    };
+                };
+                readonly required: readonly ["chainId", "currency"];
+                readonly additionalProperties: false;
+            };
+            readonly recipient: {
+                readonly description: "Base recipient for Relay-delivered USDC. Defaults to user.";
+                readonly type: "string";
+                readonly pattern: "^0x[0-9a-fA-F]{40}$";
+            };
+            readonly tradeType: {
+                readonly type: "string";
+                readonly enum: readonly ["EXACT_INPUT", "EXACT_OUTPUT", "EXPECTED_OUTPUT"];
+                readonly description: "Relay quote trade type. Defaults to EXACT_INPUT.";
+            };
+        };
+        readonly required: readonly ["user", "amount", "source"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "cash_estimate";
+    readonly description: "Estimate fiat received at the live oracle market rate and include a simple recent-fill ETA. Without source, amount is Base USDC. With source, the SDK first quotes source->Base USDC through Relay SDK, then estimates the cashout.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly amount: {
+                readonly type: "string";
+                readonly pattern: "^0*[1-9][0-9]*$";
+                readonly description: "Base units as a decimal string. For the default path this is USDC 6 decimals; with source it is source-token base units.";
+            };
+            readonly currency: {
+                readonly type: "string";
+                readonly description: "Fiat currency code from cash_capabilities, e.g. \"USD\"";
+            };
+            readonly platform: {
+                readonly type: "string";
+                readonly description: "Optional payout platform for platform-specific ETA sampling.";
+            };
+            readonly source: {
+                readonly type: "object";
+                readonly description: "Optional Relay EVM source asset. Omit for the Base USDC default path.";
+                readonly properties: {
+                    readonly chainId: {
+                        readonly description: "Relay-supported EVM source chain id.";
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: number;
+                    };
+                    readonly currency: {
+                        readonly description: "Source token/native address.";
+                        readonly type: "string";
+                        readonly pattern: "^0x[0-9a-fA-F]{40}$";
+                    };
+                    readonly user: {
+                        readonly description: "Source wallet submitting the Relay transaction.";
+                        readonly type: "string";
+                        readonly pattern: "^0x[0-9a-fA-F]{40}$";
+                    };
+                    readonly recipient: {
+                        readonly description: "Base recipient for Relay-delivered USDC. Defaults to user.";
+                        readonly type: "string";
+                        readonly pattern: "^0x[0-9a-fA-F]{40}$";
+                    };
+                    readonly tradeType: {
+                        readonly type: "string";
+                        readonly enum: readonly ["EXACT_INPUT", "EXACT_OUTPUT", "EXPECTED_OUTPUT"];
+                    };
+                };
+                readonly required: readonly ["chainId", "currency", "user"];
+                readonly additionalProperties: false;
+            };
+        };
+        readonly required: readonly ["amount", "currency"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "cash_cashout";
+    readonly description: "Start a Base-USDC cash-out using the custody-separated prepare path. Returns UNSIGNED transactions plus same-index steps [approve, createDeposit]; signing and ordered submission stay host-side. For another source asset, complete cash_source_quote and cash_source_status first, then pass the guaranteed Base USDC output amount here.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly amount: {
+                readonly type: "string";
+                readonly pattern: "^0*[1-9][0-9]*$";
+                readonly description: "Base units as a decimal string. For the default path this is USDC 6 decimals; with source it is source-token base units.";
+            };
+            readonly receive: {
+                readonly type: "object";
+                readonly description: "Where the fiat should arrive";
+                readonly properties: {
+                    readonly platform: {
+                        readonly type: "string";
+                        readonly description: "Platform id from cash_capabilities, e.g. \"venmo\"";
+                    };
+                    readonly currency: {
+                        readonly type: "string";
+                        readonly description: "Fiat currency code, e.g. \"USD\"";
+                    };
+                    readonly payee: {
+                        readonly type: "object";
+                        readonly description: "Payee handle for the platform";
+                        readonly properties: {
+                            readonly offchainId: {
+                                readonly type: "string";
+                                readonly description: "The handle, e.g. \"@andrew\" for Venmo - see payeeHint in cash_capabilities";
+                            };
+                        };
+                        readonly required: readonly ["offchainId"];
+                        readonly additionalProperties: true;
+                    };
+                };
+                readonly required: readonly ["platform", "currency", "payee"];
+                readonly additionalProperties: false;
+            };
+        };
+        readonly required: readonly ["amount", "receive"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "cash_order";
+    readonly description: "Observe one cash-out order by depositId - fully resumable, no session state. Returns state (awaiting-buyer | matched | delivering | delivered | returned), amounts, fills, and nextActions (wait | withdraw). Errors are typed with retryable + remediation; ORDER_NOT_FOUND right after cashout means indexer lag - retry in a few seconds.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly depositId: {
+                readonly type: "string";
+                readonly pattern: "^0x[0-9a-fA-F]{40}_[0-9]+$";
+                readonly description: "Composite deposit id (escrow_onchainId) returned by cash_cashout - the resume key";
+            };
+        };
+        readonly required: readonly ["depositId"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "cash_orders";
+    readonly description: "List all cash-out orders for a wallet address (the chain is the database - a cash order IS a deposit, keyed by depositor). Use inFlight=true for only the orders still needing attention.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly owner: {
+                readonly description: "The maker wallet address (0x...)";
+                readonly type: "string";
+                readonly pattern: "^0x[0-9a-fA-F]{40}$";
+            };
+            readonly inFlight: {
+                readonly type: "boolean";
+                readonly description: "Only awaiting-buyer / matched / delivering orders";
+            };
+            readonly limit: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 1000;
+                readonly description: "Max deposits to scan (default 100)";
+            };
+        };
+        readonly required: readonly ["owner"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "cash_buyer";
+    readonly description: "Look up a buyer's protocol track record from their full intent history: lifetime intents, fulfilled vs pruned counts, success rate (bps), first/last seen. Use during the matched state to answer \"who just committed to my order?\".";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly address: {
+                readonly description: "The buyer (taker) wallet address (0x...)";
+                readonly type: "string";
+                readonly pattern: "^0x[0-9a-fA-F]{40}$";
+            };
+        };
+        readonly required: readonly ["address"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "cash_source_status";
+    readonly description: "Read Relay request status through the Relay SDK request utility using the requestId returned from cash_source_quote or Relay execution progress.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly requestId: {
+                readonly type: "string";
+                readonly description: "Relay request id.";
+            };
+        };
+        readonly required: readonly ["requestId"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "cash_withdraw";
+    readonly description: "Unwind a cash-out: returns UNSIGNED transaction(s) plus same-index steps (prepare path - signing stays host-side). With amount: partial withdrawal of the unlocked balance (a live buyer intent does not block it). Without amount: closes the order fully, state-aware - when the only live intents have expired it includes a pruneExpiredIntents transaction first; while a live buyer intent locks funds it fails with ACTIVE_INTENT_BLOCKS_WITHDRAWAL (retryable - wait for expiry).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly depositId: {
+                readonly type: "string";
+                readonly pattern: "^0x[0-9a-fA-F]{40}_[0-9]+$";
+                readonly description: "Composite deposit id (escrow_onchainId) returned by cash_cashout - the resume key";
+            };
+            readonly amount: {
+                readonly description: "Optional partial amount (USDC base units, decimal string). Omit to close the order fully.";
+                readonly type: "string";
+                readonly pattern: "^0*[1-9][0-9]*$";
+            };
+        };
+        readonly required: readonly ["depositId"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "cash_topup";
+    readonly description: "Add USDC to a live cash-out order (same payee, same market rate). Returns UNSIGNED transactions plus same-index steps [approve, addFunds] for the host to sign and submit in order. Fails with ORDER_NOT_ACTIVE if the order is already delivered or returned.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly depositId: {
+                readonly type: "string";
+                readonly pattern: "^0x[0-9a-fA-F]{40}_[0-9]+$";
+                readonly description: "Composite deposit id (escrow_onchainId) returned by cash_cashout - the resume key";
+            };
+            readonly amount: {
+                readonly type: "string";
+                readonly pattern: "^0*[1-9][0-9]*$";
+                readonly description: "Base units as a decimal string. For the default path this is USDC 6 decimals; with source it is source-token base units.";
+            };
+        };
+        readonly required: readonly ["depositId", "amount"];
+        readonly additionalProperties: false;
+    };
+}];
+/** Literal names shipped by this package. Use this for exhaustive built-in dispatch. */
+type BuiltInCashToolName = (typeof builtInCashTools)[number]['name'];
+/**
+ * Mutable tool registry for hosts that append their own definitions.
+ *
+ * This was part of the 0.1.x public contract: keep the element name open as a
+ * string rather than narrowing consumers to only the built-in verbs.
+ */
 declare const cashTools: CashToolDefinition[];
 /** Manifest wrapper with versioning for host registries. */
 declare const cashToolManifest: {
     readonly name: "@zkp2p/cash";
-    readonly version: "0.1.2";
+    readonly version: string;
     readonly description: "Peer Cash - offramp-only: route any Relay-supported EVM source asset to Base USDC, then cash out to fiat at the live oracle market rate (0% spread). Mutating protocol tools return unsigned transactions plus step labels with ERC-8021 peer-cash attribution.";
     readonly tools: CashToolDefinition[];
 };
-type CashToolName = (typeof cashTools)[number]['name'];
+/** Tool names accepted by an extensible host registry, including custom tools. */
+type CashToolName = string;
 
-export { type CashToolDefinition, type CashToolName, cashToolManifest, cashTools };
+export { type BuiltInCashToolName, type CashToolDefinition, type CashToolName, cashToolManifest, cashTools };