safehands-pharos 1.4.0 → 2.6.0

package/dist/tools/safehandsWalletHealth.d.ts

@@ -1,15 +1,29 @@
-import { z } from "zod";
-import { type ToolResponse } from "../lib/toolResponse.js";
-export declare const safehandsWalletHealthSchema: z.ZodObject<{
-    agentId: z.ZodOptional<z.ZodString>;
-    walletAddress: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    agentId?: string | undefined;
-    walletAddress?: string | undefined;
-}, {
-    agentId?: string | undefined;
-    walletAddress?: string | undefined;
-}>;
-export type SafeHandsWalletHealthInput = z.input<typeof safehandsWalletHealthSchema>;
-export declare function handleSafeHandsWalletHealth(raw: SafeHandsWalletHealthInput): Promise<ToolResponse<unknown>>;
+import { z } from "zod";
+import { type ToolResponse } from "../lib/toolResponse.js";
+export declare const safehandsWalletHealthSchema: z.ZodObject<{
+    agentId: z.ZodOptional<z.ZodString>;
+    walletAddress: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    agentId?: string | undefined;
+    walletAddress?: string | undefined;
+}, {
+    agentId?: string | undefined;
+    walletAddress?: string | undefined;
+}>;
+export type SafeHandsWalletHealthInput = z.input<typeof safehandsWalletHealthSchema>;
+/**
+ * Optional read seam for offline tests. Defaults to the live read-only RPC reads
+ * (PROS + USDC balances, SafeHandsRegistry authorization). These are READS only —
+ * there is no signing or write path here either way; injecting them performs no
+ * network I/O. The MCP path calls the handler with one argument, so default
+ * behavior is unchanged.
+ */
+export interface WalletHealthReaders {
+    readBalances?: (address: `0x${string}`) => Promise<{
+        pros: bigint;
+        usdc: bigint;
+    }>;
+    readAuthorization?: (address: `0x${string}`) => Promise<boolean>;
+}
+export declare function handleSafeHandsWalletHealth(raw: SafeHandsWalletHealthInput, readers?: WalletHealthReaders): Promise<ToolResponse<unknown>>;
 //# sourceMappingURL=safehandsWalletHealth.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"safehandsWalletHealth.d.ts","sourceRoot":"","sources":["../../src/tools/safehandsWalletHealth.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAmC,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI5F,eAAO,MAAM,2BAA2B;;;;;;;;;EAGtC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAErF,wBAAsB,2BAA2B,CAAC,GAAG,EAAE,0BAA0B,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CA4FjH"}
+{"version":3,"file":"safehandsWalletHealth.d.ts","sourceRoot":"","sources":["../../src/tools/safehandsWalletHealth.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAA6B,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAKtF,eAAO,MAAM,2BAA2B;;;;;;;;;EAGtC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAErF;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnF,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAClE;AAED,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,0BAA0B,EAC/B,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CA4IhC"}

package/dist/tools/safehandsWalletHealth.js

@@ -1,104 +1,146 @@
-// ─── Tool: safehands_wallet_health ─────────────────────────────────────
-// Checks whether an AI agent wallet is ready for guarded testnet 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 { ok, classifyExternalError } from "../lib/toolResponse.js";
-import { getSigner, isSignerFailure } from "../lib/signer/index.js";
-import { walletStore } from "../lib/wallet/index.js";
-export const safehandsWalletHealthSchema = z.object({
-    agentId: z.string().optional().describe("Managed testnet wallet agentId"),
-    walletAddress: z.string().optional().describe("Explicit wallet address for read-only health checks"),
-});
-export async function handleSafeHandsWalletHealth(raw) {
-    const input = safehandsWalletHealthSchema.parse(raw);
-    const managedWallet = input.agentId ? await walletStore.get(input.agentId) : null;
-    const signer = await getSigner(input.agentId);
-    const signerAvailable = !isSignerFailure(signer);
-    const address = signerAvailable ? signer.address : (input.walletAddress || managedWallet?.address);
-    const base = {
-        environment: PHAROS_ENVIRONMENT,
-        chainId: CHAIN_ID,
-        isMainnet: IS_MAINNET,
-        walletMode: process.env.WALLET_MODE || "none",
-        writeToolsEnabled: process.env.WRITE_TOOLS_ENABLED === "true",
-        signerAvailable,
-        signerMode: signerAvailable ? signer.mode : null,
-        signerError: signerAvailable ? null : signer.error,
-        managedWalletExists: Boolean(managedWallet),
-        address: address || null,
-    };
-    if (!address) {
-        return ok({
-            ...base,
-            status: "NOT_READY",
-            readiness: {
-                canReadBalances: false,
-                canPayGas: false,
-                canPayX402: false,
-                canExecuteWrites: false,
-            },
-            requiredActions: ["Create a managed testnet wallet or provide WALLET_MODE=env with a testnet PRIVATE_KEY."],
-            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 usdc = formatUnits(usdcRaw, 6);
-        const canPayGas = parseFloat(phrs) > 0.001;
-        const canPayX402 = parseFloat(usdc) >= Number(MAX_X402_PAYMENT_USDC);
-        const canExecuteWrites = signerAvailable && canPayGas && process.env.WRITE_TOOLS_ENABLED === "true";
-        return ok({
-            ...base,
-            status: canExecuteWrites ? "READY" : signerAvailable ? "DEGRADED" : "NOT_READY",
-            balances: {
-                PHRS: { value: phrs, unit: "PHRS", decimals: 18 },
-                USDC: { value: usdc, unit: "USDC", decimals: 6, tokenAddress: USDC_ADDRESS },
-            },
-            readiness: {
-                canReadBalances: true,
-                canPayGas,
-                canPayX402,
-                canExecuteWrites,
-            },
-            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."]),
-            ],
-            source: "safehands_wallet_health",
-        });
-    }
-    catch (err) {
-        const rpc = classifyExternalError("pharos_rpc", err);
-        return ok({
-            ...base,
-            status: "DEGRADED",
-            readiness: {
-                canReadBalances: false,
-                canPayGas: "unknown",
-                canPayX402: "unknown",
-                canExecuteWrites: false,
-            },
-            rpcError: rpc.error,
-            requiredActions: ["Retry RPC balance checks later or configure PHAROS_RPC_URL."],
-            source: "safehands_wallet_health",
-        });
-    }
-}
+// ─── Tool: safehands_wallet_health ─────────────────────────────────────
+// 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, 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 wallet agentId"),
+    walletAddress: z.string().optional().describe("Explicit wallet address for read-only health checks"),
+});
+export async function handleSafeHandsWalletHealth(raw, readers = {}) {
+    const input = safehandsWalletHealthSchema.parse(raw);
+    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 = {
+        environment: PHAROS_ENVIRONMENT,
+        chainId: CHAIN_ID,
+        isMainnet: IS_MAINNET,
+        walletMode: process.env.WALLET_MODE || "none",
+        writeToolsEnabled: process.env.WRITE_TOOLS_ENABLED === "true",
+        signerAvailable,
+        signerMode: signerAvailable ? signer.mode : null,
+        signerError: signerAvailable ? null : signer.error,
+        managedWalletExists: Boolean(managedWallet),
+        address: address || null,
+    };
+    if (!address) {
+        return ok({
+            ...base,
+            status: "NOT_READY",
+            readiness: {
+                canReadBalances: false,
+                canPayGas: false,
+                canPayX402: false,
+                canExecuteWrites: false,
+            },
+            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 { 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(pros) > 0.001;
+        const canPayX402 = parseFloat(usdc) >= Number(MAX_X402_PAYMENT_USDC);
+        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,
+            balances: {
+                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 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",
+        });
+    }
+    catch (err) {
+        const rpc = classifyExternalError("pharos_rpc", err);
+        return ok({
+            ...base,
+            status: "DEGRADED",
+            readiness: {
+                canReadBalances: false,
+                canPayGas: "unknown",
+                canPayX402: "unknown",
+                canExecuteWrites: false,
+            },
+            rpcError: rpc.error,
+            requiredActions: ["Retry RPC balance checks later or configure PHAROS_RPC_URL."],
+            source: "safehands_wallet_health",
+        });
+    }
+}
 //# sourceMappingURL=safehandsWalletHealth.js.map

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

@@ -1,27 +1,27 @@
-import { z } from "zod";
-import { type ToolResponse } from "../lib/toolResponse.js";
-export declare const safehandsX402PreflightSchema: z.ZodObject<{
-    url: z.ZodString;
-    method: z.ZodDefault<z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "DELETE"]>>>;
-    paymentAmountUsdc: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    paymentTokenAddress: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    agentId: z.ZodOptional<z.ZodString>;
-    probeEndpoint: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-}, "strip", z.ZodTypeAny, {
-    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;
-    probeEndpoint?: boolean | undefined;
-}>;
-export type SafeHandsX402PreflightInput = z.input<typeof safehandsX402PreflightSchema>;
-export declare function handleSafeHandsX402Preflight(raw: SafeHandsX402PreflightInput): Promise<ToolResponse<unknown>>;
+import { z } from "zod";
+import { type ToolResponse } from "../lib/toolResponse.js";
+export declare const safehandsX402PreflightSchema: z.ZodObject<{
+    url: z.ZodString;
+    method: z.ZodDefault<z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "DELETE"]>>>;
+    paymentAmountUsdc: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    paymentTokenAddress: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    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;
+    probeEndpoint: boolean;
+    agentId?: string | undefined;
+}, {
+    url: string;
+    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>;
+export declare function handleSafeHandsX402Preflight(raw: SafeHandsX402PreflightInput): Promise<ToolResponse<unknown>>;
 //# sourceMappingURL=safehandsX402Preflight.d.ts.map

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

@@ -1,66 +1,87 @@
-// ─── Tool: safehands_x402_preflight ────────────────────────────────────
-// Checks whether an x402 paid resource is safe before payment signing.
-// ───────────────────────────────────────────────────────────────────────
-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 { evaluateActionPolicy } from "../lib/policy/actionPolicyEngine.js";
-import { getSigner, isSignerFailure } from "../lib/signer/index.js";
-export const safehandsX402PreflightSchema = z.object({
-    url: z.string(),
-    method: z.enum(["GET", "POST", "PUT", "DELETE"]).optional().default("GET"),
-    paymentAmountUsdc: z.string().optional().default("0.001"),
-    paymentTokenAddress: z.string().optional().default(X402_PAYMENT_TOKEN_ADDRESS),
-    agentId: z.string().optional(),
-    probeEndpoint: z.boolean().optional().default(false),
-});
-export async function handleSafeHandsX402Preflight(raw) {
-    const input = safehandsX402PreflightSchema.parse(raw);
-    try {
-        await assertSafeFetchUrl(input.url);
-    }
-    catch (err) {
-        return fail("SSRF_BLOCKED", err instanceof Error ? err.message.replace(/^SSRF_BLOCKED:\s*/, "") : String(err), false, "safehands_x402_preflight");
-    }
-    let detectedStatus = null;
-    let paymentRequired = "unknown";
-    if (input.probeEndpoint) {
-        try {
-            const res = await fetchWithTimeoutAndRetry(input.url, { method: input.method, timeoutMs: 7_500, retries: 0 });
-            detectedStatus = res.status;
-            paymentRequired = res.status === 402;
-        }
-        catch {
-            paymentRequired = "unknown";
-        }
-    }
-    const signer = await getSigner(input.agentId, { purpose: "x402" });
-    const signerAvailable = !isSignerFailure(signer);
-    const policy = evaluateActionPolicy({
-        actionType: "x402_pay_and_fetch",
-        url: input.url,
-        paymentAmountUsdc: input.paymentAmountUsdc,
-        paymentTokenAddress: input.paymentTokenAddress,
-        signerAvailable,
-        requiresSigner: paymentRequired === true,
-        chainId: CHAIN_ID,
-        environment: PHAROS_ENVIRONMENT,
-        isMainnet: false,
-    });
-    return ok({
-        ...policy,
-        url: input.url,
-        method: input.method,
-        paymentAmountUsdc: input.paymentAmountUsdc,
-        maxPaymentUsdc: MAX_X402_PAYMENT_USDC,
-        paymentTokenAddress: input.paymentTokenAddress,
-        signerAvailable,
-        signerMode: signerAvailable ? signer.mode : null,
-        signerError: signerAvailable ? null : signer.error,
-        probe: { enabled: input.probeEndpoint, status: detectedStatus, paymentRequired },
-        testnetPayment: true,
-        source: "safehands_x402_preflight",
-    });
-}
+// ─── Tool: safehands_x402_preflight ────────────────────────────────────
+// Checks whether an x402 paid resource is safe before payment signing.
+// ───────────────────────────────────────────────────────────────────────
+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, 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"),
+    paymentAmountUsdc: z.string().optional().default("0.001"),
+    paymentTokenAddress: z.string().optional().default(X402_PAYMENT_TOKEN_ADDRESS),
+    agentId: z.string().optional(),
+    probeEndpoint: z.boolean().optional().default(false),
+});
+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);
+    }
+    catch (err) {
+        return fail("SSRF_BLOCKED", err instanceof Error ? err.message.replace(/^SSRF_BLOCKED:\s*/, "") : String(err), false, "safehands_x402_preflight");
+    }
+    let detectedStatus = null;
+    let paymentRequired = "unknown";
+    if (input.probeEndpoint) {
+        try {
+            const res = await fetchWithTimeoutAndRetry(input.url, { method: input.method, timeoutMs: 7_500, retries: 0 });
+            detectedStatus = res.status;
+            paymentRequired = res.status === 402;
+        }
+        catch {
+            paymentRequired = "unknown";
+        }
+    }
+    const signer = await getSigner(input.agentId, { purpose: "x402" });
+    const signerAvailable = !isSignerFailure(signer);
+    const policy = evaluateActionPolicy({
+        actionType: "x402_pay_and_fetch",
+        agentId: input.agentId,
+        url: input.url,
+        paymentAmountUsdc: input.paymentAmountUsdc,
+        paymentTokenAddress: input.paymentTokenAddress,
+        signerAvailable,
+        requiresSigner: paymentRequired === true,
+        chainId: CHAIN_ID,
+        environment: PHAROS_ENVIRONMENT,
+        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,
+        maxPaymentUsdc: MAX_X402_PAYMENT_USDC,
+        paymentTokenAddress: input.paymentTokenAddress,
+        signerAvailable,
+        signerMode: signerAvailable ? signer.mode : null,
+        signerError: signerAvailable ? null : signer.error,
+        probe: { enabled: input.probeEndpoint, status: detectedStatus, paymentRequired },
+        mainnetPayment: true,
+        analysis,
+        source: "safehands_x402_preflight",
+    });
+}
 //# sourceMappingURL=safehandsX402Preflight.js.map

package/dist/tools/safehandsX402Preflight.js.map

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