safehands-pharos 1.5.0 → 2.8.0

package/dist/tools/safehandsWalletHealth.js

@@ -1,21 +1,23 @@
 // ─── Tool: safehands_wallet_health ─────────────────────────────────────
-// Checks whether an AI agent wallet is ready for guarded testnet actions.
+// Checks whether an AI agent wallet is ready for guarded mainnet actions.
 // ───────────────────────────────────────────────────────────────────────
 import { z } from "zod";
 import { formatEther, formatUnits } from "viem";
 import { publicClient } from "../lib/pharosClient.js";
-import { ERC20_ABI, USDC_ADDRESS, CHAIN_ID, PHAROS_ENVIRONMENT, IS_MAINNET, MAX_X402_PAYMENT_USDC } from "../lib/constants.js";
+import { ERC20_ABI, activeUsdcAddress, CHAIN_ID, PHAROS_ENVIRONMENT, IS_MAINNET, MAX_X402_PAYMENT_USDC, SAFEHANDS_REGISTRY_ADDRESS, REQUIRE_AUTHORIZED_AGENT_FOR_WRITE } from "../lib/constants.js";
 import { ok, classifyExternalError } from "../lib/toolResponse.js";
 import { getSigner, isSignerFailure } from "../lib/signer/index.js";
 import { walletStore } from "../lib/wallet/index.js";
+import { isAgentAuthorized } from "../lib/safeHandsRegistry.js";
 export const safehandsWalletHealthSchema = z.object({
-    agentId: z.string().optional().describe("Managed testnet wallet agentId"),
+    agentId: z.string().optional().describe("Managed wallet agentId"),
     walletAddress: z.string().optional().describe("Explicit wallet address for read-only health checks"),
 });
-export async function handleSafeHandsWalletHealth(raw) {
+export async function handleSafeHandsWalletHealth(raw, readers = {}) {
     const input = safehandsWalletHealthSchema.parse(raw);
-    const managedWallet = input.agentId ? await walletStore.get(input.agentId) : null;
-    const signer = await getSigner(input.agentId);
+    const effectiveAgentId = input.agentId || (process.env.WALLET_MODE === "managed-mainnet" ? "default" : undefined);
+    const managedWallet = effectiveAgentId ? await walletStore.get(effectiveAgentId) : null;
+    const signer = await getSigner(effectiveAgentId);
     const signerAvailable = !isSignerFailure(signer);
     const address = signerAvailable ? signer.address : (input.walletAddress || managedWallet?.address);
     const base = {
@@ -40,46 +42,86 @@ export async function handleSafeHandsWalletHealth(raw) {
                 canPayX402: false,
                 canExecuteWrites: false,
             },
-            requiredActions: ["Create a managed testnet wallet or provide WALLET_MODE=env with a testnet PRIVATE_KEY."],
+            requiredActions: [
+                "Create a managed mainnet wallet (set WALLET_MODE=managed-mainnet; auto-creates on next startup) or provide WALLET_MODE=env with a testnet PRIVATE_KEY.",
+                "Fund your wallet with PROS on Pharos Pacific Mainnet",
+            ],
             source: "safehands_wallet_health",
         });
     }
     try {
-        const [phrsRaw, usdcRaw] = await Promise.all([
-            publicClient.getBalance({ address: address }),
-            publicClient.readContract({
-                address: USDC_ADDRESS,
-                abi: ERC20_ABI,
-                functionName: "balanceOf",
-                args: [address],
-            }),
-        ]);
-        const phrs = formatEther(phrsRaw);
+        const { pros: prosRaw, usdc: usdcRaw } = readers.readBalances
+            ? await readers.readBalances(address)
+            : await (async () => {
+                const [p, u] = await Promise.all([
+                    publicClient.getBalance({ address: address }),
+                    publicClient.readContract({
+                        address: activeUsdcAddress(),
+                        abi: ERC20_ABI,
+                        functionName: "balanceOf",
+                        args: [address],
+                    }),
+                ]);
+                return { pros: p, usdc: u };
+            })();
+        const pros = formatEther(prosRaw);
         const usdc = formatUnits(usdcRaw, 6);
-        const canPayGas = parseFloat(phrs) > 0.001;
+        const canPayGas = parseFloat(pros) > 0.001;
         const canPayX402 = parseFloat(usdc) >= Number(MAX_X402_PAYMENT_USDC);
-        const canExecuteWrites = signerAvailable && canPayGas && process.env.WRITE_TOOLS_ENABLED === "true";
+        const writeToolsEnabled = process.env.WRITE_TOOLS_ENABLED === "true";
+        let safeHandsRegistry;
+        try {
+            const authorized = readers.readAuthorization
+                ? await readers.readAuthorization(address)
+                : await isAgentAuthorized(address);
+            safeHandsRegistry = { authorized, address: SAFEHANDS_REGISTRY_ADDRESS };
+        }
+        catch {
+            safeHandsRegistry = { authorized: false, address: SAFEHANDS_REGISTRY_ADDRESS, error: "SafeHandsRegistry query failed" };
+        }
+        // Managed-mainnet wallets must be authorized in SafeHandsRegistry before they
+        // can execute writes. env-mode wallets do not require registry authorization.
+        const authorizationRequired = signerAvailable && signer.mode === "managed-mainnet" && REQUIRE_AUTHORIZED_AGENT_FOR_WRITE;
+        const riskRegistryAuthorized = safeHandsRegistry.authorized === true;
+        const authorizationSatisfied = !authorizationRequired || riskRegistryAuthorized;
+        const canExecuteWrites = signerAvailable && canPayGas && writeToolsEnabled && authorizationSatisfied;
+        // REQUIRE_AUTHORIZATION surfaces the one remaining blocker when a funded,
+        // write-enabled managed wallet is simply not yet authorized in SafeHandsRegistry.
+        const needsAuthorizationOnly = signerAvailable && writeToolsEnabled && canPayGas && authorizationRequired && !riskRegistryAuthorized;
+        const status = canExecuteWrites
+            ? "READY"
+            : needsAuthorizationOnly
+                ? "REQUIRE_AUTHORIZATION"
+                : signerAvailable
+                    ? "DEGRADED"
+                    : "NOT_READY";
         return ok({
             ...base,
-            status: canExecuteWrites ? "READY" : signerAvailable ? "DEGRADED" : "NOT_READY",
+            status,
             balances: {
-                PHRS: { value: phrs, unit: "PHRS", decimals: 18 },
-                USDC: { value: usdc, unit: "USDC", decimals: 6, tokenAddress: USDC_ADDRESS },
+                PROS: { value: pros, unit: "PROS", decimals: 18 },
+                USDC: { value: usdc, unit: "USDC", decimals: 6, tokenAddress: activeUsdcAddress() },
             },
             readiness: {
                 canReadBalances: true,
                 canPayGas,
                 canPayX402,
                 canExecuteWrites,
+                authorizationRequired,
+                riskRegistryAuthorized,
             },
+            safeHandsRegistry,
             dailySpendStatus: {
                 implemented: false,
                 note: "Daily spend accounting is config-ready but not persisted in this MVP.",
             },
             requiredActions: [
-                ...(canPayGas ? [] : ["Fund wallet with testnet PHRS for gas."]),
-                ...(canPayX402 ? [] : [`Fund wallet with at least ${MAX_X402_PAYMENT_USDC} testnet USDC for x402 payments.`]),
-                ...(process.env.WRITE_TOOLS_ENABLED === "true" ? [] : ["Set WRITE_TOOLS_ENABLED=true only when intentionally executing trusted testnet actions."]),
+                ...(canPayGas ? [] : ["Fund wallet with PROS for gas: Mainnet (no faucet)"]),
+                ...(canPayX402 ? [] : [`Fund wallet with at least ${MAX_X402_PAYMENT_USDC} USDC for x402 payments.`]),
+                ...(writeToolsEnabled ? [] : ["Set WRITE_TOOLS_ENABLED=true only when intentionally executing trusted mainnet actions."]),
+                ...(authorizationRequired && !riskRegistryAuthorized
+                    ? [`Authorize this managed wallet in SafeHandsRegistry: the contract owner must call setAuthorizedAgent(${address}, true), or set AUTO_AUTHORIZE_AGENT_WALLET=true with RISK_REGISTRY_OWNER_PRIVATE_KEY.`]
+                    : []),
             ],
             source: "safehands_wallet_health",
         });

package/dist/tools/safehandsWalletHealth.js.map

@@ -1 +1 @@
-{"version":3,"file":"safehandsWalletHealth.js","sourceRoot":"","sources":["../../src/tools/safehandsWalletHealth.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"safehandsWalletHealth.js","sourceRoot":"","sources":["../../src/tools/safehandsWalletHealth.ts"],"names":[],"mappings":"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"}

package/dist/tools/safehandsX402Preflight.d.ts

@@ -8,18 +8,18 @@ export declare const safehandsX402PreflightSchema: z.ZodObject<{
     agentId: z.ZodOptional<z.ZodString>;
     probeEndpoint: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
+    method: "GET" | "POST" | "PUT" | "DELETE";
     url: string;
     paymentAmountUsdc: string;
     paymentTokenAddress: string;
-    method: "GET" | "POST" | "PUT" | "DELETE";
     probeEndpoint: boolean;
     agentId?: string | undefined;
 }, {
     url: string;
-    paymentAmountUsdc?: string | undefined;
-    paymentTokenAddress?: string | undefined;
     method?: "GET" | "POST" | "PUT" | "DELETE" | undefined;
     agentId?: string | undefined;
+    paymentAmountUsdc?: string | undefined;
+    paymentTokenAddress?: string | undefined;
     probeEndpoint?: boolean | undefined;
 }>;
 export type SafeHandsX402PreflightInput = z.input<typeof safehandsX402PreflightSchema>;

package/dist/tools/safehandsX402Preflight.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"safehandsX402Preflight.d.ts","sourceRoot":"","sources":["../../src/tools/safehandsX402Preflight.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAMrE,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;EAOvC,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEvF,wBAAsB,4BAA4B,CAAC,GAAG,EAAE,2BAA2B,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAqDnH"}
+{"version":3,"file":"safehandsX402Preflight.d.ts","sourceRoot":"","sources":["../../src/tools/safehandsX402Preflight.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAUrE,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;EAOvC,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEvF,wBAAsB,4BAA4B,CAAC,GAAG,EAAE,2BAA2B,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CA+EnH"}

package/dist/tools/safehandsX402Preflight.js

@@ -4,9 +4,13 @@
 import { z } from "zod";
 import { ok, fail } from "../lib/toolResponse.js";
 import { assertSafeFetchUrl, fetchWithTimeoutAndRetry } from "../lib/http.js";
-import { CHAIN_ID, PHAROS_ENVIRONMENT, MAX_X402_PAYMENT_USDC, X402_PAYMENT_TOKEN_ADDRESS } from "../lib/constants.js";
+import { CHAIN_ID, PHAROS_ENVIRONMENT, MAX_X402_PAYMENT_USDC, X402_PAYMENT_TOKEN_ADDRESS, IS_MAINNET } from "../lib/constants.js";
 import { evaluateActionPolicy } from "../lib/policy/actionPolicyEngine.js";
+import { mapEngineDecision } from "../lib/guardian/decision.js";
+import { isExecutionAvailable } from "../lib/config.js";
+import { analyzeX402 } from "../lib/analysis/x402.js";
 import { getSigner, isSignerFailure } from "../lib/signer/index.js";
+import { isValidPositiveAmount } from "../lib/validation.js";
 export const safehandsX402PreflightSchema = z.object({
     url: z.string(),
     method: z.enum(["GET", "POST", "PUT", "DELETE"]).optional().default("GET"),
@@ -17,6 +21,9 @@ export const safehandsX402PreflightSchema = z.object({
 });
 export async function handleSafeHandsX402Preflight(raw) {
     const input = safehandsX402PreflightSchema.parse(raw);
+    if (!isValidPositiveAmount(input.paymentAmountUsdc)) {
+        return fail("VALIDATION_ERROR", `paymentAmountUsdc must be a valid positive number (got "${input.paymentAmountUsdc}").`, false, "safehands_x402_preflight");
+    }
     try {
         await assertSafeFetchUrl(input.url);
     }
@@ -39,6 +46,7 @@ export async function handleSafeHandsX402Preflight(raw) {
     const signerAvailable = !isSignerFailure(signer);
     const policy = evaluateActionPolicy({
         actionType: "x402_pay_and_fetch",
+        agentId: input.agentId,
         url: input.url,
         paymentAmountUsdc: input.paymentAmountUsdc,
         paymentTokenAddress: input.paymentTokenAddress,
@@ -46,10 +54,22 @@ export async function handleSafeHandsX402Preflight(raw) {
         requiresSigner: paymentRequired === true,
         chainId: CHAIN_ID,
         environment: PHAROS_ENVIRONMENT,
-        isMainnet: false,
+        isMainnet: IS_MAINNET,
+    });
+    const analysis = analyzeX402({
+        url: input.url,
+        paymentAmountUsdc: input.paymentAmountUsdc,
+        paymentTokenAddress: input.paymentTokenAddress,
+        agentId: input.agentId,
+        chainId: CHAIN_ID,
+    });
+    const guardianDecision = mapEngineDecision(policy.decision, {
+        executionAvailable: isExecutionAvailable(),
     });
     return ok({
         ...policy,
+        decision: guardianDecision,
+        guardianDecision,
         url: input.url,
         method: input.method,
         paymentAmountUsdc: input.paymentAmountUsdc,
@@ -59,7 +79,8 @@ export async function handleSafeHandsX402Preflight(raw) {
         signerMode: signerAvailable ? signer.mode : null,
         signerError: signerAvailable ? null : signer.error,
         probe: { enabled: input.probeEndpoint, status: detectedStatus, paymentRequired },
-        testnetPayment: true,
+        mainnetPayment: true,
+        analysis,
         source: "safehands_x402_preflight",
     });
 }

package/dist/tools/safehandsX402Preflight.js.map

@@ -1 +1 @@
-{"version":3,"file":"safehandsX402Preflight.js","sourceRoot":"","sources":["../../src/tools/safehandsX402Preflight.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,uEAAuE;AACvE,0EAA0E;AAE1E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAqB,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACtH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEpE,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC1E,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;IACzD,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,0BAA0B,CAAC;IAC9E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACrD,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,GAAgC;IACjF,MAAM,KAAK,GAAG,4BAA4B,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACtD,IAAI,CAAC;QACH,MAAM,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,IAAI,CACT,cAAc,EACd,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EACjF,KAAK,EACL,0BAA0B,CAC3B,CAAC;IACJ,CAAC;IAED,IAAI,cAAc,GAAkB,IAAI,CAAC;IACzC,IAAI,eAAe,GAAwB,SAAS,CAAC;IACrD,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,wBAAwB,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9G,cAAc,GAAG,GAAG,CAAC,MAAM,CAAC;YAC5B,eAAe,GAAG,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,eAAe,GAAG,SAAS,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACnE,MAAM,eAAe,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,oBAAoB,CAAC;QAClC,UAAU,EAAE,oBAAoB;QAChC,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;QAC9C,eAAe;QACf,cAAc,EAAE,eAAe,KAAK,IAAI;QACxC,OAAO,EAAE,QAAQ;QACjB,WAAW,EAAE,kBAAkB;QAC/B,SAAS,EAAE,KAAK;KACjB,CAAC,CAAC;IAEH,OAAO,EAAE,CAAC;QACR,GAAG,MAAM;QACT,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,cAAc,EAAE,qBAAqB;QACrC,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;QAC9C,eAAe;QACf,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QAChD,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK;QAClD,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE;QAChF,cAAc,EAAE,IAAI;QACpB,MAAM,EAAE,0BAA0B;KACnC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"safehandsX402Preflight.js","sourceRoot":"","sources":["../../src/tools/safehandsX402Preflight.ts"],"names":[],"mappings":"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"}

package/dist/tools/sendPayment.d.ts

@@ -4,9 +4,11 @@ export declare const sendPaymentSchema: z.ZodObject<{
     amount: z.ZodString;
     memo: z.ZodOptional<z.ZodString>;
     agentId: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
+    confirm: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strict", z.ZodTypeAny, {
     amount: string;
     toAddress: string;
+    confirm: boolean;
     agentId?: string | undefined;
     memo?: string | undefined;
 }, {
@@ -14,6 +16,7 @@ export declare const sendPaymentSchema: z.ZodObject<{
     toAddress: string;
     agentId?: string | undefined;
     memo?: string | undefined;
+    confirm?: boolean | undefined;
 }>;
 export type SendPaymentInput = z.input<typeof sendPaymentSchema>;
 export declare const sendPaymentTool: {
@@ -24,9 +27,11 @@ export declare const sendPaymentTool: {
         amount: z.ZodString;
         memo: z.ZodOptional<z.ZodString>;
         agentId: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
+        confirm: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strict", z.ZodTypeAny, {
         amount: string;
         toAddress: string;
+        confirm: boolean;
         agentId?: string | undefined;
         memo?: string | undefined;
     }, {
@@ -34,9 +39,10 @@ export declare const sendPaymentTool: {
         toAddress: string;
         agentId?: string | undefined;
         memo?: string | undefined;
+        confirm?: boolean | undefined;
     }>;
 };
-export declare function handleSendPayment(raw: SendPaymentInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
+export declare function handleSendPayment(raw: SendPaymentInput): Promise<import("../sdk.js").ToolFailure | import("../sdk.js").ToolSuccess<{
     txHash: `0x${string}`;
     explorerUrl: string;
     amountSent: string;
@@ -48,7 +54,7 @@ export declare function handleSendPayment(raw: SendPaymentInput): Promise<import
         balanceSufficient: boolean;
         warnings: string[];
     };
-    policy: import("../lib/policy/actionPolicyEngine.js").ActionPolicyResult;
+    policy: import("../sdk.js").ActionPolicyResult;
     riskAssessment: {
         riskScore: number;
         wasBlocked: boolean;

package/dist/tools/sendPayment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sendPayment.d.ts","sourceRoot":"","sources":["../../src/tools/sendPayment.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;EAK5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;CAI3B,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;IAwH5D"}
+{"version":3,"file":"sendPayment.d.ts","sourceRoot":"","sources":["../../src/tools/sendPayment.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EAMnB,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CAI3B,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;IA6I5D"}

package/dist/tools/sendPayment.js

@@ -4,50 +4,51 @@ import { publicClient, createPharosWalletClientFromAccount, getExplorerUrl } fro
 import { isAddress, parseEther, formatEther } from "viem";
 import { assessRisk } from "../lib/riskEngine.js";
 import { fail, ok, classifyExternalError } from "../lib/toolResponse.js";
-import { MAX_BALANCE_USAGE_PCT, RISK_BLOCK_THRESHOLD, MAX_TX_AMOUNT_PHRS, CHAIN_ID, PHAROS_ENVIRONMENT } from "../lib/constants.js";
-import { getSigner, isSignerFailure } from "../lib/signer/index.js";
-import { evaluateActionPolicy } from "../lib/policy/actionPolicyEngine.js";
-import { checkDailyLimit, recordSpend, estimateUsd } from "../lib/spendAccumulator.js";
+import { MAX_BALANCE_USAGE_PCT, MAX_TX_AMOUNT_PROS, CHAIN_ID, PHAROS_ENVIRONMENT, IS_MAINNET } from "../lib/constants.js";
+import { requireManagedExecutionReady, isManagedExecutionFailure } from "../lib/managedExecution.js";
+import { evaluateActionPolicy, riskEvidenceFromAssessment } from "../lib/policy/actionPolicyEngine.js";
+import { enforceWriteDecision } from "../lib/policy/writeExecutionGate.js";
+import { checkDailyLimit, reserveDailyLimit, releaseReservation, estimateUsd } from "../lib/spendAccumulator.js";
+import { validatePositiveAmount, validateNonZeroAddress, collectErrors } from "../lib/validation.js";
 export const sendPaymentSchema = z.object({
     toAddress: z.string(),
     amount: z.string(),
     memo: z.string().optional(),
-    agentId: z.string().optional().describe("Managed testnet wallet agentId when WALLET_MODE=managed-testnet"),
-});
+    agentId: z.string().optional().describe("Managed wallet agentId when WALLET_MODE=managed-mainnet"),
+    confirm: z.boolean().optional().default(false).describe("Explicit acknowledgement to proceed when SafeHands returns REQUIRE_CONFIRMATION (e.g. unverified recipient). Hard BLOCK / denylist / over-limit are never overridable."),
+}).strict();
 export const sendPaymentTool = {
     name: "send_payment",
-    description: "Send native PHRS with pre-flight validation. Checks address validity, balance sufficiency, and warns on high exposure.",
+    description: "Send native PROS with pre-flight validation. Checks address validity, balance sufficiency, and warns on high exposure. Gated by WRITE_TOOLS_ENABLED.",
     inputSchema: sendPaymentSchema,
 };
 export async function handleSendPayment(raw) {
-    if (process.env.WRITE_TOOLS_ENABLED !== "true") {
-        return fail("WRITE_TOOLS_DISABLED", "send_payment is disabled by default. Set WRITE_TOOLS_ENABLED=true only for trusted testnet execution.", false, "send_payment");
+    let input;
+    try {
+        input = sendPaymentSchema.parse(raw);
     }
-    const input = sendPaymentSchema.parse(raw);
-    const signer = await getSigner(input.agentId);
-    if (isSignerFailure(signer)) {
-        return fail(signer.error.code, signer.error.message, false, "send_payment");
+    catch (err) {
+        const msg = err instanceof z.ZodError
+            ? err.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")
+            : String(err);
+        return fail("VALIDATION_ERROR", `send_payment input validation failed: ${msg}`, false, "send_payment");
     }
-    const walletAddress = signer.address;
-    const policy = evaluateActionPolicy({
-        actionType: "send_payment",
-        amount: input.amount,
-        amountUnit: "PHRS",
-        recipient: input.toAddress,
-        recipientVerified: false,
-        chainId: CHAIN_ID,
-        environment: PHAROS_ENVIRONMENT,
-        isMainnet: false,
-        signerAvailable: true,
-        requiresSigner: true,
-    });
-    if (policy.decision === "BLOCK") {
-        return fail("POLICY_BLOCKED", policy.reasons.join(" ") || "Payment blocked by SafeHands policy.", false, "send_payment");
+    const fieldErrors = collectErrors([
+        validatePositiveAmount(input.amount, "amount"),
+        validateNonZeroAddress(input.toAddress, "toAddress"),
+    ]);
+    if (fieldErrors.length > 0) {
+        return fail("VALIDATION_ERROR", fieldErrors.join(" "), false, "send_payment");
     }
-    if (Number(input.amount) > Number(MAX_TX_AMOUNT_PHRS)) {
-        return fail("TX_LIMIT_EXCEEDED", `Payment amount exceeds configured testnet limit (${MAX_TX_AMOUNT_PHRS} PHRS).`, false, "send_payment");
+    const gate = await requireManagedExecutionReady("send_payment", input.agentId);
+    if (isManagedExecutionFailure(gate))
+        return gate;
+    const { signer } = gate;
+    const walletAddress = signer.address;
+    if (Number(input.amount) > Number(MAX_TX_AMOUNT_PROS)) {
+        return fail("TX_LIMIT_EXCEEDED", `Payment amount exceeds the operator ceiling MAX_TX_AMOUNT_PROS (${MAX_TX_AMOUNT_PROS} PROS), which bounds all agent policies. Raise MAX_TX_AMOUNT_PROS to allow larger mainnet payments.`, false, "send_payment");
     }
-    const amountUsd = estimateUsd(input.amount, "PHRS");
+    const amountUsd = estimateUsd(input.amount, "PROS");
     const dailyCheck = checkDailyLimit(walletAddress, amountUsd);
     if (!dailyCheck.allowed) {
         return fail("DAILY_SPEND_LIMIT_EXCEEDED", `Daily spend limit reached. Spent $${dailyCheck.currentUsd.toFixed(2)} of $${dailyCheck.limitUsd.toFixed(2)} USD today. Remaining: $${dailyCheck.remainingUsd.toFixed(2)}. Resets at UTC midnight.`, false, "send_payment");
@@ -68,12 +69,12 @@ export async function handleSendPayment(raw) {
     const balance = await publicClient.getBalance({ address: walletAddress });
     const gasEstimate = parseEther("0.01");
     if (balance < amountWei + gasEstimate) {
-        return fail("INSUFFICIENT_TESTNET_BALANCE", `Insufficient balance: have ${formatEther(balance)} PHRS, need ${input.amount} + gas`, false, "send_payment");
+        return fail("INSUFFICIENT_BALANCE", `Insufficient balance: have ${formatEther(balance)} PROS, need ${input.amount} + gas`, false, "send_payment");
     }
     validation.balanceSufficient = true;
     const usagePct = Number((amountWei * 100n) / balance);
     if (usagePct > MAX_BALANCE_USAGE_PCT) {
-        warnings.push(`Using ${usagePct}% of wallet balance — high exposure`);
+        warnings.push(`Using ${usagePct}% of wallet balance; high exposure`);
     }
     const risk = await assessRisk({
         action: "transfer",
@@ -81,8 +82,33 @@ export async function handleSendPayment(raw) {
         toAddress: input.toAddress,
         walletAddress,
     });
-    if (risk.riskScore > RISK_BLOCK_THRESHOLD) {
-        return fail("POLICY_BLOCKED", `Payment blocked — risk score ${risk.riskScore}/100: ${risk.suggestion}`, false, "send_payment");
+    // Sole decision point: ONE policy evaluation over all collected evidence,
+    // including the advisory risk assessment. Never gate on riskEngine output
+    // directly — the policy engine's risk_* checks do that (never-weaken parity
+    // with the former direct gates; requireRiskEvidence makes a wiring miss fail
+    // closed instead of silently losing the risk gates).
+    const policy = evaluateActionPolicy({
+        actionType: "send_payment",
+        agentId: input.agentId,
+        amount: input.amount,
+        amountUnit: "PROS",
+        recipient: input.toAddress,
+        recipientVerified: false,
+        chainId: CHAIN_ID,
+        environment: PHAROS_ENVIRONMENT,
+        isMainnet: IS_MAINNET,
+        signerAvailable: true,
+        requiresSigner: true,
+        risk: riskEvidenceFromAssessment(risk),
+    });
+    const paymentGate = enforceWriteDecision(policy, { confirmed: input.confirm === true, toolName: "send_payment", requireRiskEvidence: true });
+    if (paymentGate)
+        return paymentGate;
+    // Atomically reserve the daily-spend budget immediately before broadcasting
+    // (no await between reserve and send), so concurrent calls can't both exceed the cap.
+    const reservation = reserveDailyLimit(walletAddress, amountUsd);
+    if (!reservation.allowed) {
+        return fail("DAILY_SPEND_LIMIT_EXCEEDED", `Daily spend limit reached. Spent $${reservation.currentUsd.toFixed(2)} of $${reservation.limitUsd.toFixed(2)} USD today. Remaining: $${reservation.remainingUsd.toFixed(2)}. Resets at UTC midnight.`, false, "send_payment");
     }
     try {
         const wallet = createPharosWalletClientFromAccount(signer.account);
@@ -92,9 +118,9 @@ export async function handleSendPayment(raw) {
         });
         const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
         if (receipt.status !== "success") {
+            releaseReservation(walletAddress, amountUsd);
             return fail("TX_REVERTED", "send_payment transaction was mined but reverted on-chain.", false, "send_payment");
         }
-        recordSpend(walletAddress, amountUsd);
         return ok({
             txHash,
             explorerUrl: getExplorerUrl(txHash),
@@ -112,6 +138,7 @@ export async function handleSendPayment(raw) {
         });
     }
     catch (err) {
+        releaseReservation(walletAddress, amountUsd);
         return classifyExternalError("pharos_rpc", err);
     }
 }

package/dist/tools/sendPayment.js.map

@@ -1 +1 @@
-{"version":3,"file":"sendPayment.js","sourceRoot":"","sources":["../../src/tools/sendPayment.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sendPayment.js","sourceRoot":"","sources":["../../src/tools/sendPayment.ts"],"names":[],"mappings":"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"}

package/dist/tools/setAgentPolicy.d.ts

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import { type AgentPolicy } from "../lib/policy/agentPolicy.js";
+export declare const setAgentPolicySchema: z.ZodObject<{
+    agentId: z.ZodEffects<z.ZodString, string, string>;
+    profile: z.ZodOptional<z.ZodEnum<["conservative", "balanced", "advanced", "custom"]>>;
+    limits: z.ZodOptional<z.ZodObject<{
+        maxPaymentPROS: z.ZodOptional<z.ZodString>;
+        maxSwapPROS: z.ZodOptional<z.ZodString>;
+        maxDailySpendPROS: z.ZodOptional<z.ZodString>;
+        maxX402PaymentUSDC: z.ZodOptional<z.ZodString>;
+        maxApprovalUSDC: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        maxPaymentPROS?: string | undefined;
+        maxSwapPROS?: string | undefined;
+        maxDailySpendPROS?: string | undefined;
+        maxX402PaymentUSDC?: string | undefined;
+        maxApprovalUSDC?: string | undefined;
+    }, {
+        maxPaymentPROS?: string | undefined;
+        maxSwapPROS?: string | undefined;
+        maxDailySpendPROS?: string | undefined;
+        maxX402PaymentUSDC?: string | undefined;
+        maxApprovalUSDC?: string | undefined;
+    }>>;
+    flags: z.ZodOptional<z.ZodObject<{
+        allowUnknownTokens: z.ZodOptional<z.ZodBoolean>;
+        allowCustomContractCalls: z.ZodOptional<z.ZodBoolean>;
+        requireConfirmationAboveRisk: z.ZodOptional<z.ZodEnum<["LOW", "MEDIUM", "HIGH", "CRITICAL"]>>;
+    }, "strip", z.ZodTypeAny, {
+        allowUnknownTokens?: boolean | undefined;
+        allowCustomContractCalls?: boolean | undefined;
+        requireConfirmationAboveRisk?: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL" | undefined;
+    }, {
+        allowUnknownTokens?: boolean | undefined;
+        allowCustomContractCalls?: boolean | undefined;
+        requireConfirmationAboveRisk?: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL" | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    agentId: string;
+    profile?: "custom" | "conservative" | "balanced" | "advanced" | undefined;
+    limits?: {
+        maxPaymentPROS?: string | undefined;
+        maxSwapPROS?: string | undefined;
+        maxDailySpendPROS?: string | undefined;
+        maxX402PaymentUSDC?: string | undefined;
+        maxApprovalUSDC?: string | undefined;
+    } | undefined;
+    flags?: {
+        allowUnknownTokens?: boolean | undefined;
+        allowCustomContractCalls?: boolean | undefined;
+        requireConfirmationAboveRisk?: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL" | undefined;
+    } | undefined;
+}, {
+    agentId: string;
+    profile?: "custom" | "conservative" | "balanced" | "advanced" | undefined;
+    limits?: {
+        maxPaymentPROS?: string | undefined;
+        maxSwapPROS?: string | undefined;
+        maxDailySpendPROS?: string | undefined;
+        maxX402PaymentUSDC?: string | undefined;
+        maxApprovalUSDC?: string | undefined;
+    } | undefined;
+    flags?: {
+        allowUnknownTokens?: boolean | undefined;
+        allowCustomContractCalls?: boolean | undefined;
+        requireConfirmationAboveRisk?: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL" | undefined;
+    } | undefined;
+}>;
+export declare function handleSetAgentPolicy(rawParams: unknown): Promise<import("../sdk.js").ToolFailure | import("../sdk.js").ToolSuccess<{
+    agentId: string;
+    policy: AgentPolicy;
+    saved: boolean;
+    source: string;
+}>>;
+//# sourceMappingURL=setAgentPolicy.d.ts.map

package/dist/tools/setAgentPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setAgentPolicy.d.ts","sourceRoot":"","sources":["../../src/tools/setAgentPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAqD,KAAK,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEnH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBtB,CAAC;AAEZ,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,OAAO;;;;;IAuD5D"}