safehands-pharos 1.2.0 → 1.2.3

package/dist/tools/getWalletBalance.js

@@ -4,8 +4,9 @@
 import { z } from "zod";
 import { publicClient } from "../lib/pharosClient.js";
 import { getDodoRoute } from "../lib/dodoApi.js";
-import { USDC_ADDRESS, USDT_ADDRESS, ERC20_ABI } from "../lib/constants.js";
-import { formatEther, formatUnits } from "viem";
+import { USDC_ADDRESS, USDT_ADDRESS, ERC20_ABI, CHAIN_ID, PHAROS_ENVIRONMENT } from "../lib/constants.js";
+import { formatEther, formatUnits, isAddress } from "viem";
+import { classifyExternalError, fail, ok } from "../lib/toolResponse.js";
 export const getWalletBalanceSchema = z.object({
     walletAddress: z.string().describe("Wallet address to check balances for"),
 });
@@ -17,55 +18,71 @@ export const getWalletBalanceTool = {
 const QUOTE_WALLET = "0x0000000000000000000000000000000000000001";
 export async function handleGetWalletBalance(raw) {
     const input = getWalletBalanceSchema.parse(raw);
+    if (!isAddress(input.walletAddress)) {
+        return fail("INVALID_WALLET_ADDRESS", `Invalid wallet address: ${input.walletAddress}`, false, "get_wallet_balance");
+    }
     const addr = input.walletAddress;
-    // Fetch all three balances in parallel
-    const [phrsBalanceWei, usdcBalanceRaw, usdtBalanceRaw] = await Promise.all([
-        publicClient.getBalance({ address: addr }),
-        publicClient.readContract({
-            address: USDC_ADDRESS,
-            abi: ERC20_ABI,
-            functionName: "balanceOf",
-            args: [addr],
-        }),
-        publicClient.readContract({
-            address: USDT_ADDRESS,
-            abi: ERC20_ABI,
-            functionName: "balanceOf",
-            args: [addr],
-        }),
-    ]);
-    const phrsBalance = formatEther(phrsBalanceWei);
-    const usdcBalance = formatUnits(usdcBalanceRaw, 6);
-    const usdtBalance = formatUnits(usdtBalanceRaw, 6);
-    // Get PHRS price in USD for total calculation
-    let phrsUsd = 0;
     try {
-        const quote = await getDodoRoute({
-            fromToken: "PHRS",
-            toToken: "USDC",
-            amountHuman: "1",
-            walletAddress: QUOTE_WALLET,
-        });
-        if (quote.routeAvailable) {
-            phrsUsd = parseFloat(quote.amountOut);
+        const [phrsBalanceWei, usdcBalanceRaw, usdtBalanceRaw] = await Promise.all([
+            publicClient.getBalance({ address: addr }),
+            publicClient.readContract({
+                address: USDC_ADDRESS,
+                abi: ERC20_ABI,
+                functionName: "balanceOf",
+                args: [addr],
+            }),
+            publicClient.readContract({
+                address: USDT_ADDRESS,
+                abi: ERC20_ABI,
+                functionName: "balanceOf",
+                args: [addr],
+            }),
+        ]);
+        const phrsBalance = formatEther(phrsBalanceWei);
+        const usdcBalance = formatUnits(usdcBalanceRaw, 6);
+        const usdtBalance = formatUnits(usdtBalanceRaw, 6);
+        let phrsUsd = 0;
+        let priceSourceStatus = "unavailable";
+        try {
+            const quote = await getDodoRoute({
+                fromToken: "PHRS",
+                toToken: "USDC",
+                amountHuman: "1",
+                walletAddress: QUOTE_WALLET,
+            });
+            if (quote.routeAvailable) {
+                phrsUsd = parseFloat(quote.amountOut);
+                priceSourceStatus = "ok";
+            }
+            else {
+                priceSourceStatus = "no_route_available";
+            }
         }
+        catch {
+            priceSourceStatus = "unavailable";
+        }
+        const phrsValueUsd = parseFloat(phrsBalance) * phrsUsd;
+        const usdcValueUsd = parseFloat(usdcBalance);
+        const usdtValueUsd = parseFloat(usdtBalance);
+        const totalUsd = (phrsValueUsd + usdcValueUsd + usdtValueUsd).toFixed(4);
+        return ok({
+            walletAddress: input.walletAddress,
+            balances: {
+                PHRS: { balance: { value: phrsBalance, unit: "PHRS" }, valueUsd: { value: phrsValueUsd.toFixed(4), unit: "USD" } },
+                USDC: { balance: { value: usdcBalance, unit: "USDC" }, valueUsd: { value: usdcValueUsd.toFixed(4), unit: "USD" } },
+                USDT: { balance: { value: usdtBalance, unit: "USDT" }, valueUsd: { value: usdtValueUsd.toFixed(4), unit: "USD" } },
+            },
+            totalUsd: { value: totalUsd, unit: "USD" },
+            phrsPrice: phrsUsd > 0 ? { value: phrsUsd.toFixed(4), unit: "USD" } : null,
+            priceSourceStatus,
+            chainId: CHAIN_ID,
+            environment: PHAROS_ENVIRONMENT,
+            isMainnet: false,
+            source: "pharos_rpc",
+        });
     }
-    catch {
-        // Price unavailable, leave at 0
+    catch (err) {
+        return classifyExternalError("pharos_rpc", err);
     }
-    const phrsValueUsd = parseFloat(phrsBalance) * phrsUsd;
-    const usdcValueUsd = parseFloat(usdcBalance); // 1:1 stablecoin
-    const usdtValueUsd = parseFloat(usdtBalance); // 1:1 stablecoin
-    const totalUsd = (phrsValueUsd + usdcValueUsd + usdtValueUsd).toFixed(4);
-    return {
-        walletAddress: input.walletAddress,
-        balances: {
-            PHRS: { balance: phrsBalance, valueUsd: phrsValueUsd.toFixed(4) },
-            USDC: { balance: usdcBalance, valueUsd: usdcValueUsd.toFixed(4) },
-            USDT: { balance: usdtBalance, valueUsd: usdtValueUsd.toFixed(4) },
-        },
-        totalUsd,
-        phrsPrice: phrsUsd > 0 ? phrsUsd.toFixed(4) : "unavailable",
-    };
 }
 //# sourceMappingURL=getWalletBalance.js.map

package/dist/tools/getWalletBalance.js.map

@@ -1 +1 @@
-{"version":3,"file":"getWalletBalance.js","sourceRoot":"","sources":["../../src/tools/getWalletBalance.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,mEAAmE;AACnE,2EAA2E;AAE3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAEhD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;CAC3E,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,iHAAiH;IACnH,WAAW,EAAE,sBAAsB;CACpC,CAAC;AAEF,MAAM,YAAY,GAAG,4CAA4C,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,GAA0B;IACrE,MAAM,KAAK,GAAG,sBAAsB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,KAAK,CAAC,aAA8B,CAAC;IAElD,uCAAuC;IACvC,MAAM,CAAC,cAAc,EAAE,cAAc,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACzE,YAAY,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC1C,YAAY,CAAC,YAAY,CAAC;YACxB,OAAO,EAAE,YAAY;YACrB,GAAG,EAAE,SAAS;YACd,YAAY,EAAE,WAAW;YACzB,IAAI,EAAE,CAAC,IAAI,CAAC;SACb,CAAoB;QACrB,YAAY,CAAC,YAAY,CAAC;YACxB,OAAO,EAAE,YAAY;YACrB,GAAG,EAAE,SAAS;YACd,YAAY,EAAE,WAAW;YACzB,IAAI,EAAE,CAAC,IAAI,CAAC;SACb,CAAoB;KACtB,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,WAAW,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,WAAW,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;IAEnD,8CAA8C;IAC9C,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC;YAC/B,SAAS,EAAE,MAAM;YACjB,OAAO,EAAE,MAAM;YACf,WAAW,EAAE,GAAG;YAChB,aAAa,EAAE,YAAY;SAC5B,CAAC,CAAC;QACH,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;YACzB,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gCAAgC;IAClC,CAAC;IAED,MAAM,YAAY,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC;IACvD,MAAM,YAAY,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB;IAC/D,MAAM,YAAY,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB;IAC/D,MAAM,QAAQ,GAAG,CAAC,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAEzE,OAAO;QACL,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,QAAQ,EAAE;YACR,IAAI,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YACjE,IAAI,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YACjE,IAAI,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;SAClE;QACD,QAAQ;QACR,SAAS,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa;KAC5D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"getWalletBalance.js","sourceRoot":"","sources":["../../src/tools/getWalletBalance.ts"],"names":[],"mappings":"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"}

package/dist/tools/publishRiskScore.d.ts

@@ -5,17 +5,20 @@ export declare const publishRiskScoreSchema: z.ZodObject<{
     tokenOut: z.ZodOptional<z.ZodString>;
     amount: z.ZodString;
     toAddress: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     amount: string;
     action: "transfer" | "swap";
     tokenIn?: string | undefined;
     tokenOut?: string | undefined;
+    agentId?: string | undefined;
     toAddress?: string | undefined;
 }, {
     amount: string;
     action: "transfer" | "swap";
     tokenIn?: string | undefined;
     tokenOut?: string | undefined;
+    agentId?: string | undefined;
     toAddress?: string | undefined;
 }>;
 export type PublishRiskScoreInput = z.input<typeof publishRiskScoreSchema>;
@@ -28,35 +31,34 @@ export declare const publishRiskScoreTool: {
         tokenOut: z.ZodOptional<z.ZodString>;
         amount: z.ZodString;
         toAddress: z.ZodOptional<z.ZodString>;
+        agentId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         amount: string;
         action: "transfer" | "swap";
         tokenIn?: string | undefined;
         tokenOut?: string | undefined;
+        agentId?: string | undefined;
         toAddress?: string | undefined;
     }, {
         amount: string;
         action: "transfer" | "swap";
         tokenIn?: string | undefined;
         tokenOut?: string | undefined;
+        agentId?: string | undefined;
         toAddress?: string | undefined;
     }>;
 };
-export declare function handlePublishRiskScore(raw: PublishRiskScoreInput): Promise<{
-    success: boolean;
+export declare function handlePublishRiskScore(raw: PublishRiskScoreInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
     assessment: import("../lib/riskEngine.js").RiskAssessment;
+    policy: import("../lib/policy/actionPolicyEngine.js").ActionPolicyResult;
+    signerMode: import("../lib/signer/index.js").SignerMode;
     onChain: {
         txHash: `0x${string}`;
         explorerUrl: string;
-        contractAddress: "0x71fc28ed3a31016b42f18764889cd911f22b67b8";
+        contractAddress: `0x${string}`;
         gasUsed: string;
         blockNumber: string;
     };
-    error?: undefined;
-} | {
-    success: boolean;
-    assessment: import("../lib/riskEngine.js").RiskAssessment;
-    onChain: null;
-    error: string;
-}>;
+    source: string;
+}>>;
 //# sourceMappingURL=publishRiskScore.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"publishRiskScore.d.ts","sourceRoot":"","sources":["../../src/tools/publishRiskScore.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;EAMjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;CAMhC,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,qBAAqB;;;;;;;;;;;;;;;;GAqDtE"}
+{"version":3,"file":"publishRiskScore.d.ts","sourceRoot":"","sources":["../../src/tools/publishRiskScore.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;EAOjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;CAMhC,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,qBAAqB;;;;;;;;;;;;IAiEtE"}

package/dist/tools/publishRiskScore.js

@@ -2,15 +2,19 @@
 // Publishes a risk assessment result to the on-chain RiskRegistry.
 // ────────────────────────────────────────────────────────────────────────
 import { z } from "zod";
-import { publicClient, createPharosWalletClient, getExplorerUrl } from "../lib/pharosClient.js";
-import { RISK_REGISTRY_ADDRESS, RISK_REGISTRY_ABI } from "../lib/constants.js";
+import { publicClient, createPharosWalletClientFromAccount, getExplorerUrl } from "../lib/pharosClient.js";
+import { RISK_REGISTRY_ADDRESS, RISK_REGISTRY_ABI, CHAIN_ID, PHAROS_ENVIRONMENT } from "../lib/constants.js";
 import { assessRisk } from "../lib/riskEngine.js";
+import { fail, ok, requireWriteToolsEnabled, classifyExternalError } from "../lib/toolResponse.js";
+import { getSigner, isSignerFailure } from "../lib/signer/index.js";
+import { evaluateActionPolicy } from "../lib/policy/actionPolicyEngine.js";
 export const publishRiskScoreSchema = z.object({
     action: z.enum(["swap", "transfer"]).describe("Type of on-chain action to assess"),
     tokenIn: z.string().optional(),
     tokenOut: z.string().optional(),
     amount: z.string().describe("Human-readable amount"),
     toAddress: z.string().optional().describe("Recipient address (for transfers)"),
+    agentId: z.string().optional().describe("Managed testnet wallet agentId when WALLET_MODE=managed-testnet"),
 });
 export const publishRiskScoreTool = {
     name: "publish_risk_score",
@@ -19,23 +23,36 @@ export const publishRiskScoreTool = {
     inputSchema: publishRiskScoreSchema,
 };
 export async function handlePublishRiskScore(raw) {
-    const privateKey = process.env.PRIVATE_KEY;
-    const walletAddress = process.env.WALLET_ADDRESS;
-    if (!privateKey || !walletAddress)
-        throw new Error("Missing PRIVATE_KEY or WALLET_ADDRESS in environment variables.");
+    const writeGuard = requireWriteToolsEnabled("publish_risk_score");
+    if (writeGuard)
+        return writeGuard;
     const input = publishRiskScoreSchema.parse(raw);
-    // 1. Run risk assessment
+    const signer = await getSigner(input.agentId);
+    if (isSignerFailure(signer)) {
+        return fail(signer.error.code, signer.error.message, false, "publish_risk_score");
+    }
+    const policy = evaluateActionPolicy({
+        actionType: "publish_risk_score",
+        chainId: CHAIN_ID,
+        environment: PHAROS_ENVIRONMENT,
+        isMainnet: false,
+        signerAvailable: true,
+        requiresSigner: true,
+    });
+    if (policy.decision === "BLOCK") {
+        return fail("POLICY_BLOCKED", policy.reasons.join(" ") || "Publishing blocked by SafeHands policy.", false, "publish_risk_score");
+    }
+    const walletAddress = signer.address;
     const assessment = await assessRisk({
         action: input.action,
         tokenIn: input.tokenIn,
         tokenOut: input.tokenOut,
         amount: input.amount,
         toAddress: input.toAddress,
-        walletAddress: walletAddress,
+        walletAddress,
     });
-    // 2. Publish to on-chain registry
     try {
-        const wallet = createPharosWalletClient(privateKey);
+        const wallet = createPharosWalletClientFromAccount(signer.account);
         const txHash = await wallet.writeContract({
             address: RISK_REGISTRY_ADDRESS,
             abi: RISK_REGISTRY_ABI,
@@ -48,9 +65,10 @@ export async function handlePublishRiskScore(raw) {
             ],
         });
         const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
-        return {
-            success: true,
+        return ok({
             assessment,
+            policy,
+            signerMode: signer.mode,
             onChain: {
                 txHash,
                 explorerUrl: getExplorerUrl(txHash),
@@ -58,15 +76,11 @@ export async function handlePublishRiskScore(raw) {
                 gasUsed: receipt.gasUsed.toString(),
                 blockNumber: receipt.blockNumber.toString(),
             },
-        };
+            source: "publish_risk_score",
+        });
     }
     catch (err) {
-        return {
-            success: false,
-            assessment,
-            onChain: null,
-            error: `Failed to publish to registry: ${err.message}`,
-        };
+        return classifyExternalError("pharos_rpc", err);
     }
 }
 //# sourceMappingURL=publishRiskScore.js.map

package/dist/tools/publishRiskScore.js.map

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

package/dist/tools/queryRiskRegistry.d.ts

@@ -22,7 +22,7 @@ export declare function handleQueryRiskRegistry(raw: QueryRiskRegistryInput): Pr
     walletAddress: string;
     found: boolean;
     record: null;
-    registryContract: "0x71fc28ed3a31016b42f18764889cd911f22b67b8";
+    registryContract: `0x${string}`;
     message: string;
     error?: undefined;
 } | {
@@ -35,14 +35,14 @@ export declare function handleQueryRiskRegistry(raw: QueryRiskRegistryInput): Pr
         timestamp: string;
         assessedBy: `0x${string}`;
     };
-    registryContract: "0x71fc28ed3a31016b42f18764889cd911f22b67b8";
+    registryContract: `0x${string}`;
     message?: undefined;
     error?: undefined;
 } | {
     walletAddress: string;
     found: boolean;
     record: null;
-    registryContract: "0x71fc28ed3a31016b42f18764889cd911f22b67b8";
+    registryContract: `0x${string}`;
     error: string;
     message?: undefined;
 }>;

package/dist/tools/safehandsPreflightCheck.d.ts

@@ -0,0 +1,78 @@
+import { z } from "zod";
+import { type ToolResponse } from "../lib/toolResponse.js";
+export declare const safehandsPreflightCheckSchema: z.ZodObject<{
+    actionType: z.ZodEnum<["send_payment", "approve_token", "execute_swap", "x402_pay_and_fetch", "publish_risk_score", "custom_contract_call"]>;
+    chainId: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    environment: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    isMainnet: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    amount: z.ZodOptional<z.ZodString>;
+    amountUnit: z.ZodOptional<z.ZodEnum<["PHRS", "USDC", "USD", "TOKEN"]>>;
+    token: z.ZodOptional<z.ZodString>;
+    tokenAddress: z.ZodOptional<z.ZodString>;
+    tokenIn: z.ZodOptional<z.ZodString>;
+    tokenOut: z.ZodOptional<z.ZodString>;
+    recipient: z.ZodOptional<z.ZodString>;
+    spender: z.ZodOptional<z.ZodString>;
+    approvalAmount: z.ZodOptional<z.ZodString>;
+    approvalToken: z.ZodOptional<z.ZodString>;
+    approvalUnlimited: z.ZodOptional<z.ZodBoolean>;
+    url: z.ZodOptional<z.ZodString>;
+    paymentAmountUsdc: z.ZodOptional<z.ZodString>;
+    paymentTokenAddress: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    signerAvailable: z.ZodOptional<z.ZodBoolean>;
+    tokenSecurityStatus: z.ZodOptional<z.ZodEnum<["ok", "unavailable", "unknown"]>>;
+    recipientVerified: z.ZodOptional<z.ZodBoolean>;
+    spenderVerified: z.ZodOptional<z.ZodBoolean>;
+    requiresSigner: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    environment: string;
+    actionType: "send_payment" | "approve_token" | "execute_swap" | "x402_pay_and_fetch" | "publish_risk_score" | "custom_contract_call";
+    chainId: number;
+    isMainnet: boolean;
+    paymentTokenAddress: string;
+    spender?: string | undefined;
+    amount?: string | undefined;
+    token?: string | undefined;
+    tokenAddress?: string | undefined;
+    amountUnit?: "PHRS" | "USDC" | "USD" | "TOKEN" | undefined;
+    tokenIn?: string | undefined;
+    tokenOut?: string | undefined;
+    recipient?: string | undefined;
+    approvalAmount?: string | undefined;
+    approvalToken?: string | undefined;
+    approvalUnlimited?: boolean | undefined;
+    url?: string | undefined;
+    paymentAmountUsdc?: string | undefined;
+    signerAvailable?: boolean | undefined;
+    tokenSecurityStatus?: "unknown" | "ok" | "unavailable" | undefined;
+    recipientVerified?: boolean | undefined;
+    spenderVerified?: boolean | undefined;
+    requiresSigner?: boolean | undefined;
+}, {
+    actionType: "send_payment" | "approve_token" | "execute_swap" | "x402_pay_and_fetch" | "publish_risk_score" | "custom_contract_call";
+    spender?: string | undefined;
+    amount?: string | undefined;
+    environment?: string | undefined;
+    token?: string | undefined;
+    tokenAddress?: string | undefined;
+    chainId?: number | undefined;
+    isMainnet?: boolean | undefined;
+    amountUnit?: "PHRS" | "USDC" | "USD" | "TOKEN" | undefined;
+    tokenIn?: string | undefined;
+    tokenOut?: string | undefined;
+    recipient?: string | undefined;
+    approvalAmount?: string | undefined;
+    approvalToken?: string | undefined;
+    approvalUnlimited?: boolean | undefined;
+    url?: string | undefined;
+    paymentAmountUsdc?: string | undefined;
+    paymentTokenAddress?: string | undefined;
+    signerAvailable?: boolean | undefined;
+    tokenSecurityStatus?: "unknown" | "ok" | "unavailable" | undefined;
+    recipientVerified?: boolean | undefined;
+    spenderVerified?: boolean | undefined;
+    requiresSigner?: boolean | undefined;
+}>;
+export type SafeHandsPreflightCheckInput = z.input<typeof safehandsPreflightCheckSchema>;
+export declare function handleSafeHandsPreflightCheck(raw: SafeHandsPreflightCheckInput): Promise<ToolResponse<unknown>>;
+//# sourceMappingURL=safehandsPreflightCheck.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safehandsPreflightCheck.d.ts","sourceRoot":"","sources":["../../src/tools/safehandsPreflightCheck.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAK/D,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwBxC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEzF,wBAAsB,6BAA6B,CAAC,GAAG,EAAE,4BAA4B,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAerH"}

package/dist/tools/safehandsPreflightCheck.js

@@ -0,0 +1,48 @@
+// ─── Tool: safehands_preflight_check ───────────────────────────────────
+// Branded SafeHands transaction safety firewall preflight.
+// ───────────────────────────────────────────────────────────────────────
+import { z } from "zod";
+import { ok } from "../lib/toolResponse.js";
+import { CHAIN_ID, PHAROS_ENVIRONMENT, IS_MAINNET, X402_PAYMENT_TOKEN_ADDRESS } from "../lib/constants.js";
+import { evaluateActionPolicy } from "../lib/policy/actionPolicyEngine.js";
+import { classifyTokenRegistryStatus } from "./tokenRegistryStatus.js";
+export const safehandsPreflightCheckSchema = z.object({
+    actionType: z.enum(["send_payment", "approve_token", "execute_swap", "x402_pay_and_fetch", "publish_risk_score", "custom_contract_call"]),
+    chainId: z.number().optional().default(CHAIN_ID),
+    environment: z.string().optional().default(PHAROS_ENVIRONMENT),
+    isMainnet: z.boolean().optional().default(IS_MAINNET),
+    amount: z.string().optional(),
+    amountUnit: z.enum(["PHRS", "USDC", "USD", "TOKEN"]).optional(),
+    token: z.string().optional(),
+    tokenAddress: z.string().optional(),
+    tokenIn: z.string().optional(),
+    tokenOut: z.string().optional(),
+    recipient: z.string().optional(),
+    spender: z.string().optional(),
+    approvalAmount: z.string().optional(),
+    approvalToken: z.string().optional(),
+    approvalUnlimited: z.boolean().optional(),
+    url: z.string().optional(),
+    paymentAmountUsdc: z.string().optional(),
+    paymentTokenAddress: z.string().optional().default(X402_PAYMENT_TOKEN_ADDRESS),
+    signerAvailable: z.boolean().optional(),
+    tokenSecurityStatus: z.enum(["ok", "unavailable", "unknown"]).optional(),
+    recipientVerified: z.boolean().optional(),
+    spenderVerified: z.boolean().optional(),
+    requiresSigner: z.boolean().optional(),
+});
+export async function handleSafeHandsPreflightCheck(raw) {
+    const input = safehandsPreflightCheckSchema.parse(raw);
+    const tokenForRegistry = input.tokenAddress || input.token || input.tokenOut || input.tokenIn;
+    const registry = tokenForRegistry ? classifyTokenRegistryStatus(tokenForRegistry) : null;
+    const policy = evaluateActionPolicy({
+        ...input,
+        tokenRegistryStatus: registry?.status,
+    });
+    return ok({
+        ...policy,
+        tokenRegistry: registry,
+        source: "safehands_preflight_check",
+    });
+}
+//# sourceMappingURL=safehandsPreflightCheck.js.map

package/dist/tools/safehandsPreflightCheck.js.map

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

package/dist/tools/safehandsRiskReport.d.ts

@@ -0,0 +1,82 @@
+import { z } from "zod";
+import { type ToolResponse } from "../lib/toolResponse.js";
+export declare const safehandsRiskReportSchema: z.ZodObject<{
+    actionType: z.ZodEnum<["send_payment", "approve_token", "execute_swap", "x402_pay_and_fetch", "publish_risk_score", "custom_contract_call"]>;
+    chainId: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    environment: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    isMainnet: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    amount: z.ZodOptional<z.ZodString>;
+    amountUnit: z.ZodOptional<z.ZodEnum<["PHRS", "USDC", "USD", "TOKEN"]>>;
+    token: z.ZodOptional<z.ZodString>;
+    tokenAddress: z.ZodOptional<z.ZodString>;
+    tokenIn: z.ZodOptional<z.ZodString>;
+    tokenOut: z.ZodOptional<z.ZodString>;
+    recipient: z.ZodOptional<z.ZodString>;
+    spender: z.ZodOptional<z.ZodString>;
+    approvalAmount: z.ZodOptional<z.ZodString>;
+    approvalToken: z.ZodOptional<z.ZodString>;
+    approvalUnlimited: z.ZodOptional<z.ZodBoolean>;
+    url: z.ZodOptional<z.ZodString>;
+    paymentAmountUsdc: z.ZodOptional<z.ZodString>;
+    paymentTokenAddress: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    signerAvailable: z.ZodOptional<z.ZodBoolean>;
+    tokenSecurityStatus: z.ZodOptional<z.ZodEnum<["ok", "unavailable", "unknown"]>>;
+    recipientVerified: z.ZodOptional<z.ZodBoolean>;
+    spenderVerified: z.ZodOptional<z.ZodBoolean>;
+    requiresSigner: z.ZodOptional<z.ZodBoolean>;
+} & {
+    includeChecks: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    environment: string;
+    actionType: "send_payment" | "approve_token" | "execute_swap" | "x402_pay_and_fetch" | "publish_risk_score" | "custom_contract_call";
+    chainId: number;
+    isMainnet: boolean;
+    paymentTokenAddress: string;
+    includeChecks: boolean;
+    spender?: string | undefined;
+    amount?: string | undefined;
+    token?: string | undefined;
+    tokenAddress?: string | undefined;
+    amountUnit?: "PHRS" | "USDC" | "USD" | "TOKEN" | undefined;
+    tokenIn?: string | undefined;
+    tokenOut?: string | undefined;
+    recipient?: string | undefined;
+    approvalAmount?: string | undefined;
+    approvalToken?: string | undefined;
+    approvalUnlimited?: boolean | undefined;
+    url?: string | undefined;
+    paymentAmountUsdc?: string | undefined;
+    signerAvailable?: boolean | undefined;
+    tokenSecurityStatus?: "unknown" | "ok" | "unavailable" | undefined;
+    recipientVerified?: boolean | undefined;
+    spenderVerified?: boolean | undefined;
+    requiresSigner?: boolean | undefined;
+}, {
+    actionType: "send_payment" | "approve_token" | "execute_swap" | "x402_pay_and_fetch" | "publish_risk_score" | "custom_contract_call";
+    spender?: string | undefined;
+    amount?: string | undefined;
+    environment?: string | undefined;
+    token?: string | undefined;
+    tokenAddress?: string | undefined;
+    chainId?: number | undefined;
+    isMainnet?: boolean | undefined;
+    amountUnit?: "PHRS" | "USDC" | "USD" | "TOKEN" | undefined;
+    tokenIn?: string | undefined;
+    tokenOut?: string | undefined;
+    recipient?: string | undefined;
+    approvalAmount?: string | undefined;
+    approvalToken?: string | undefined;
+    approvalUnlimited?: boolean | undefined;
+    url?: string | undefined;
+    paymentAmountUsdc?: string | undefined;
+    paymentTokenAddress?: string | undefined;
+    signerAvailable?: boolean | undefined;
+    tokenSecurityStatus?: "unknown" | "ok" | "unavailable" | undefined;
+    recipientVerified?: boolean | undefined;
+    spenderVerified?: boolean | undefined;
+    requiresSigner?: boolean | undefined;
+    includeChecks?: boolean | undefined;
+}>;
+export type SafeHandsRiskReportInput = z.input<typeof safehandsRiskReportSchema>;
+export declare function handleSafeHandsRiskReport(raw: SafeHandsRiskReportInput): Promise<ToolResponse<unknown>>;
+//# sourceMappingURL=safehandsRiskReport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safehandsRiskReport.d.ts","sourceRoot":"","sources":["../../src/tools/safehandsRiskReport.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI/D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEpC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEjF,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,wBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAkB7G"}

package/dist/tools/safehandsRiskReport.js

@@ -0,0 +1,29 @@
+// ─── Tool: safehands_risk_report ───────────────────────────────────────
+import { z } from "zod";
+import { ok } from "../lib/toolResponse.js";
+import { explainPolicyResult } from "../lib/policy/actionPolicyEngine.js";
+import { handleSafeHandsPreflightCheck, safehandsPreflightCheckSchema } from "./safehandsPreflightCheck.js";
+export const safehandsRiskReportSchema = safehandsPreflightCheckSchema.extend({
+    includeChecks: z.boolean().optional().default(true),
+});
+export async function handleSafeHandsRiskReport(raw) {
+    const input = safehandsRiskReportSchema.parse(raw);
+    const preflight = await handleSafeHandsPreflightCheck(input);
+    if (!preflight.success)
+        return preflight;
+    const data = preflight.data;
+    return ok({
+        decision: data.decision,
+        riskLevel: data.riskLevel,
+        safeToExecute: data.safeToExecute,
+        summary: explainPolicyResult(data),
+        reasons: data.reasons,
+        requiredActions: data.requiredActions,
+        checks: input.includeChecks ? data.checks : undefined,
+        environment: data.environment,
+        chainId: data.chainId,
+        isMainnet: data.isMainnet,
+        source: "safehands_risk_report",
+    });
+}
+//# sourceMappingURL=safehandsRiskReport.js.map

package/dist/tools/safehandsRiskReport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safehandsRiskReport.js","sourceRoot":"","sources":["../../src/tools/safehandsRiskReport.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,EAAE,EAAqB,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,6BAA6B,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAE5G,MAAM,CAAC,MAAM,yBAAyB,GAAG,6BAA6B,CAAC,MAAM,CAAC;IAC5E,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACpD,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,GAA6B;IAC3E,MAAM,KAAK,GAAG,yBAAyB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,MAAM,6BAA6B,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,CAAC,SAAS,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAW,CAAC;IACnC,OAAO,EAAE,CAAC;QACR,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,OAAO,EAAE,mBAAmB,CAAC,IAAI,CAAC;QAClC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;QACrD,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,MAAM,EAAE,uBAAuB;KAChC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/safehandsSafeExecute.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { type ToolResponse } from "../lib/toolResponse.js";
+export declare const safehandsSafeExecuteSchema: z.ZodObject<{
+    path: z.ZodEnum<["safe_execute_send_payment", "safe_execute_approve_token", "safe_execute_swap", "safe_x402_pay_and_fetch"]>;
+    execute: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    confirmExecution: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    action: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, "strip", z.ZodTypeAny, {
+    path: "safe_execute_send_payment" | "safe_execute_approve_token" | "safe_execute_swap" | "safe_x402_pay_and_fetch";
+    execute: boolean;
+    confirmExecution: boolean;
+    action: Record<string, any>;
+}, {
+    path: "safe_execute_send_payment" | "safe_execute_approve_token" | "safe_execute_swap" | "safe_x402_pay_and_fetch";
+    action: Record<string, any>;
+    execute?: boolean | undefined;
+    confirmExecution?: boolean | undefined;
+}>;
+export type SafeHandsSafeExecuteInput = z.input<typeof safehandsSafeExecuteSchema>;
+export declare function handleSafeHandsSafeExecute(raw: SafeHandsSafeExecuteInput): Promise<ToolResponse<unknown>>;
+//# sourceMappingURL=safehandsSafeExecute.d.ts.map