safehands-pharos 1.3.0 → 1.4.0

package/dist/tools/safehandsPreflightCheck.js

@@ -1,48 +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",
-    });
-}
+// ─── 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/safehandsRiskReport.d.ts

@@ -1,82 +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>>;
+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.js

@@ -1,29 +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",
-    });
-}
+// ─── 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/safehandsSafeExecute.d.ts

@@ -1,21 +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>>;
+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

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

@@ -1 +1 @@
-{"version":3,"file":"safehandsSafeExecute.d.ts","sourceRoot":"","sources":["../../src/tools/safehandsSafeExecute.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAsC,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAO/F,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;EAKrC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAenF,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAmD/G"}
+{"version":3,"file":"safehandsSafeExecute.d.ts","sourceRoot":"","sources":["../../src/tools/safehandsSafeExecute.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAsC,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAQ/F,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;EAKrC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAenF,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAyD/G"}

package/dist/tools/safehandsSafeExecute.js

@@ -1,76 +1,82 @@
-// ─── Tool: safehands_safe_execute ──────────────────────────────────────
-// Guarded execution wrapper so AI agents cannot bypass preflight checks.
-// ───────────────────────────────────────────────────────────────────────
-import { z } from "zod";
-import { fail, ok, requireWriteToolsEnabled } from "../lib/toolResponse.js";
-import { handleSafeHandsPreflightCheck } from "./safehandsPreflightCheck.js";
-import { handleSendPayment } from "./sendPayment.js";
-import { handleApproveToken } from "./approveToken.js";
-import { handleExecuteSwap } from "./executeSwap.js";
-import { handleX402PayAndFetch } from "./x402PayAndFetch.js";
-export const safehandsSafeExecuteSchema = z.object({
-    path: z.enum(["safe_execute_send_payment", "safe_execute_approve_token", "safe_execute_swap", "safe_x402_pay_and_fetch"]),
-    execute: z.boolean().optional().default(false).describe("Must be true to execute. false returns dry-run guarded report only."),
-    confirmExecution: z.boolean().optional().default(false).describe("Additional explicit runtime confirmation."),
-    action: z.record(z.any()).describe("Underlying tool input object"),
-});
-function toPreflight(path, action) {
-    if (path === "safe_execute_send_payment") {
-        return { actionType: "send_payment", amount: String(action.amount || ""), amountUnit: "PHRS", recipient: String(action.toAddress || ""), recipientVerified: false, requiresSigner: true, signerAvailable: true };
-    }
-    if (path === "safe_execute_approve_token") {
-        return { actionType: "approve_token", approvalAmount: String(action.amount || ""), approvalToken: String(action.token || ""), approvalUnlimited: action.amount === "max", requiresSigner: true, signerAvailable: true };
-    }
-    if (path === "safe_execute_swap") {
-        return { actionType: "execute_swap", amount: String(action.amountIn || ""), tokenIn: String(action.tokenIn || ""), tokenOut: String(action.tokenOut || ""), requiresSigner: true, signerAvailable: true };
-    }
-    return { actionType: "x402_pay_and_fetch", url: String(action.url || ""), paymentAmountUsdc: String(action.maxPaymentUsdc || "0.001"), requiresSigner: true, signerAvailable: true };
-}
-export async function handleSafeHandsSafeExecute(raw) {
-    const input = safehandsSafeExecuteSchema.parse(raw);
-    const writeGuard = requireWriteToolsEnabled("safehands_safe_execute");
-    if (writeGuard)
-        return writeGuard;
-    const preflight = await handleSafeHandsPreflightCheck(toPreflight(input.path, input.action));
-    if (!preflight.success)
-        return preflight;
-    const report = preflight.data;
-    if (report.decision === "BLOCK") {
-        return ok({
-            executed: false,
-            blocked: true,
-            safetyReport: report,
-            executionResult: null,
-            source: "safehands_safe_execute",
-        });
-    }
-    if (report.decision !== "ALLOW") {
-        return fail(report.decision === "REQUIRE_CONFIRMATION" ? "CONFIRMATION_REQUIRED" : "POLICY_BLOCKED", `SafeHands did not execute because policy decision is ${report.decision}.`, false, "safehands_safe_execute");
-    }
-    if (!input.execute || !input.confirmExecution) {
-        return ok({
-            executed: false,
-            dryRun: true,
-            reason: "Set execute=true and confirmExecution=true to execute this allowed testnet action.",
-            safetyReport: report,
-            executionResult: null,
-            source: "safehands_safe_execute",
-        });
-    }
-    let executionResult;
-    if (input.path === "safe_execute_send_payment")
-        executionResult = await handleSendPayment(input.action);
-    else if (input.path === "safe_execute_approve_token")
-        executionResult = await handleApproveToken(input.action);
-    else if (input.path === "safe_execute_swap")
-        executionResult = await handleExecuteSwap(input.action);
-    else
-        executionResult = await handleX402PayAndFetch(input.action);
-    return ok({
-        executed: true,
-        safetyReport: report,
-        executionResult,
-        source: "safehands_safe_execute",
-    });
-}
+// ─── Tool: safehands_safe_execute ──────────────────────────────────────
+// Guarded execution wrapper so AI agents cannot bypass preflight checks.
+// ───────────────────────────────────────────────────────────────────────
+import { z } from "zod";
+import { fail, ok, requireWriteToolsEnabled } from "../lib/toolResponse.js";
+import { getSigner, isSignerFailure } from "../lib/signer/index.js";
+import { handleSafeHandsPreflightCheck } from "./safehandsPreflightCheck.js";
+import { handleSendPayment } from "./sendPayment.js";
+import { handleApproveToken } from "./approveToken.js";
+import { handleExecuteSwap } from "./executeSwap.js";
+import { handleX402PayAndFetch } from "./x402PayAndFetch.js";
+export const safehandsSafeExecuteSchema = z.object({
+    path: z.enum(["safe_execute_send_payment", "safe_execute_approve_token", "safe_execute_swap", "safe_x402_pay_and_fetch"]),
+    execute: z.boolean().optional().default(false).describe("Must be true to execute. false returns dry-run guarded report only."),
+    confirmExecution: z.boolean().optional().default(false).describe("Additional explicit runtime confirmation."),
+    action: z.record(z.any()).describe("Underlying tool input object"),
+});
+function toPreflight(path, action, signerAvailable) {
+    if (path === "safe_execute_send_payment") {
+        return { actionType: "send_payment", amount: String(action.amount || ""), amountUnit: "PHRS", recipient: String(action.toAddress || ""), recipientVerified: false, requiresSigner: true, signerAvailable };
+    }
+    if (path === "safe_execute_approve_token") {
+        return { actionType: "approve_token", approvalAmount: String(action.amount || ""), approvalToken: String(action.token || ""), approvalUnlimited: action.amount === "max", requiresSigner: true, signerAvailable };
+    }
+    if (path === "safe_execute_swap") {
+        return { actionType: "execute_swap", amount: String(action.amountIn || ""), tokenIn: String(action.tokenIn || ""), tokenOut: String(action.tokenOut || ""), requiresSigner: true, signerAvailable };
+    }
+    return { actionType: "x402_pay_and_fetch", url: String(action.url || ""), paymentAmountUsdc: String(action.maxPaymentUsdc || "0.001"), requiresSigner: true, signerAvailable };
+}
+export async function handleSafeHandsSafeExecute(raw) {
+    const input = safehandsSafeExecuteSchema.parse(raw);
+    const writeGuard = requireWriteToolsEnabled("safehands_safe_execute");
+    if (writeGuard)
+        return writeGuard;
+    // Resolve actual signer availability so the preflight report is truthful
+    const purpose = input.path === "safe_x402_pay_and_fetch" ? "x402" : "write";
+    const agentId = typeof input.action.agentId === "string" ? input.action.agentId : undefined;
+    const signerResult = await getSigner(agentId, { purpose });
+    const signerAvailable = !isSignerFailure(signerResult);
+    const preflight = await handleSafeHandsPreflightCheck(toPreflight(input.path, input.action, signerAvailable));
+    if (!preflight.success)
+        return preflight;
+    const report = preflight.data;
+    if (report.decision === "BLOCK") {
+        return ok({
+            executed: false,
+            blocked: true,
+            safetyReport: report,
+            executionResult: null,
+            source: "safehands_safe_execute",
+        });
+    }
+    if (report.decision !== "ALLOW") {
+        return fail(report.decision === "REQUIRE_CONFIRMATION" ? "CONFIRMATION_REQUIRED" : "POLICY_BLOCKED", `SafeHands did not execute because policy decision is ${report.decision}.`, false, "safehands_safe_execute");
+    }
+    if (!input.execute || !input.confirmExecution) {
+        return ok({
+            executed: false,
+            dryRun: true,
+            reason: "Set execute=true and confirmExecution=true to execute this allowed testnet action.",
+            safetyReport: report,
+            executionResult: null,
+            source: "safehands_safe_execute",
+        });
+    }
+    let executionResult;
+    if (input.path === "safe_execute_send_payment")
+        executionResult = await handleSendPayment(input.action);
+    else if (input.path === "safe_execute_approve_token")
+        executionResult = await handleApproveToken(input.action);
+    else if (input.path === "safe_execute_swap")
+        executionResult = await handleExecuteSwap(input.action);
+    else
+        executionResult = await handleX402PayAndFetch(input.action);
+    return ok({
+        executed: true,
+        safetyReport: report,
+        executionResult,
+        source: "safehands_safe_execute",
+    });
+}
 //# sourceMappingURL=safehandsSafeExecute.js.map

package/dist/tools/safehandsSafeExecute.js.map

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

package/dist/tools/safehandsWalletHealth.d.ts

@@ -1,15 +1,15 @@
-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>;
+export declare function handleSafeHandsWalletHealth(raw: SafeHandsWalletHealthInput): Promise<ToolResponse<unknown>>;
 //# sourceMappingURL=safehandsWalletHealth.d.ts.map