safehands-pharos 1.5.0 → 2.8.0

package/dist/tools/setAgentPolicy.js

@@ -0,0 +1,80 @@
+import { z } from "zod";
+import { ok, fail } from "../lib/toolResponse.js";
+import { loadAgentPolicy, saveAgentPolicy, POLICY_PROFILES } from "../lib/policy/agentPolicy.js";
+export const setAgentPolicySchema = z.object({
+    agentId: z.string().min(1).max(128)
+        .regex(/^[A-Za-z0-9_.:-]+$/, "agentId may only contain letters, digits and _ . : -")
+        .refine((v) => !v.includes(".."), "agentId must not contain '..'")
+        .describe("Agent ID to set policy for."),
+    profile: z.enum(["conservative", "balanced", "advanced", "custom"]).optional()
+        .describe("Named profile to apply. Overrides individual limit/flag fields unless 'custom' is chosen with explicit values."),
+    limits: z.object({
+        maxPaymentPROS: z.string().optional(),
+        maxSwapPROS: z.string().optional(),
+        maxDailySpendPROS: z.string().optional(),
+        maxX402PaymentUSDC: z.string().optional(),
+        maxApprovalUSDC: z.string().optional(),
+    }).optional().describe("Custom limits. Only used when profile is 'custom' or to override a named profile's defaults."),
+    flags: z.object({
+        allowUnknownTokens: z.boolean().optional(),
+        allowCustomContractCalls: z.boolean().optional(),
+        requireConfirmationAboveRisk: z.enum(["LOW", "MEDIUM", "HIGH", "CRITICAL"]).optional(),
+    }).optional().describe("Custom flags. Only used when profile is 'custom' or to override a named profile's defaults."),
+}).strict();
+export async function handleSetAgentPolicy(rawParams) {
+    // Self-validate: the HTTP tool gateway does NOT parse before dispatch, so this
+    // disk-writing tool must enforce its own schema (agentId is path-safe; strict).
+    let params;
+    try {
+        params = setAgentPolicySchema.parse(rawParams);
+    }
+    catch (err) {
+        const msg = err instanceof z.ZodError
+            ? err.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")
+            : String(err);
+        return fail("VALIDATION_ERROR", `Invalid set_agent_policy input: ${msg}`, false, "set_agent_policy");
+    }
+    const profileName = params.profile || "custom";
+    let base;
+    if (profileName !== "custom" && profileName in POLICY_PROFILES) {
+        base = structuredClone(POLICY_PROFILES[profileName]);
+    }
+    else {
+        base = loadAgentPolicy(params.agentId);
+        base.profile = "custom";
+    }
+    if (params.limits) {
+        for (const [key, val] of Object.entries(params.limits)) {
+            if (val !== undefined) {
+                const n = Number(val);
+                if (!Number.isFinite(n) || n < 0) {
+                    return fail("VALIDATION_ERROR", `Invalid limit value for ${key}: ${val}`, false, "set_agent_policy");
+                }
+                base.limits[key] = val;
+            }
+        }
+    }
+    if (params.flags) {
+        if (params.flags.allowUnknownTokens !== undefined)
+            base.flags.allowUnknownTokens = params.flags.allowUnknownTokens;
+        if (params.flags.allowCustomContractCalls !== undefined)
+            base.flags.allowCustomContractCalls = params.flags.allowCustomContractCalls;
+        if (params.flags.requireConfirmationAboveRisk !== undefined)
+            base.flags.requireConfirmationAboveRisk = params.flags.requireConfirmationAboveRisk;
+    }
+    if (profileName !== "custom")
+        base.profile = profileName;
+    try {
+        saveAgentPolicy(params.agentId, base);
+    }
+    catch (err) {
+        return fail("POLICY_SAVE_FAILED", `Failed to save policy: ${err instanceof Error ? err.message : String(err)}`, false, "set_agent_policy");
+    }
+    return ok({
+        agentId: params.agentId,
+        policy: base,
+        saved: true,
+        source: "set_agent_policy",
+    });
+}
+//# sourceMappingURL=setAgentPolicy.js.map

package/dist/tools/setAgentPolicy.js.map

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

package/dist/tools/simulateTransaction.d.ts

@@ -6,7 +6,7 @@ export declare const simulateTransactionSchema: z.ZodObject<{
     amount: z.ZodString;
     toAddress: z.ZodOptional<z.ZodString>;
     walletAddress: z.ZodString;
-}, "strip", z.ZodTypeAny, {
+}, "strict", z.ZodTypeAny, {
     amount: string;
     walletAddress: string;
     action: "transfer" | "swap";
@@ -32,7 +32,7 @@ export declare const simulateTransactionTool: {
         amount: z.ZodString;
         toAddress: z.ZodOptional<z.ZodString>;
         walletAddress: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
+    }, "strict", z.ZodTypeAny, {
         amount: string;
         walletAddress: string;
         action: "transfer" | "swap";
@@ -48,10 +48,14 @@ export declare const simulateTransactionTool: {
         toAddress?: string | undefined;
     }>;
 };
-export declare function handleSimulateTransaction(input: SimulateTransactionInput): Promise<import("../lib/toolResponse.js").ToolFailure | import("../lib/toolResponse.js").ToolSuccess<{
+export declare function handleSimulateTransaction(raw: SimulateTransactionInput): Promise<import("../sdk.js").ToolFailure | import("../sdk.js").ToolSuccess<{
     wouldSucceed: boolean;
     expectedOutput: string;
     gasEstimate: string;
+    recommendedGas: {
+        value: string;
+        bufferPct: number;
+    };
     balanceChanges: {
         token: string;
         delta: string;

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

@@ -1 +1 @@
-{"version":3,"file":"simulateTransaction.d.ts","sourceRoot":"","sources":["../../src/tools/simulateTransaction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;EAOpC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEjF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;CAInC,CAAC;AAEF,wBAAsB,yBAAyB,CAAC,KAAK,EAAE,wBAAwB;;;;;eAExC,MAAM;eAAS,MAAM;;;IA4E3D"}
+{"version":3,"file":"simulateTransaction.d.ts","sourceRoot":"","sources":["../../src/tools/simulateTransaction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;EAO3B,CAAC;AAEZ,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEjF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;CAInC,CAAC;AAEF,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,wBAAwB;;;;;;;;;eAkBtC,MAAM;eAAS,MAAM;;;IA0F3D"}

package/dist/tools/simulateTransaction.js

@@ -4,6 +4,8 @@ import { publicClient } from "../lib/pharosClient.js";
 import { getDodoRoute } from "../lib/dodoApi.js";
 import { parseEther, formatEther } from "viem";
 import { ok, fail } from "../lib/toolResponse.js";
+import { validatePositiveAmount, validateAddress } from "../lib/validation.js";
+import { recommendGasWithBuffer, DEFAULT_GAS_BUFFER_PCT } from "../lib/analysis/gas.js";
 export const simulateTransactionSchema = z.object({
     action: z.enum(["swap", "transfer"]),
     tokenIn: z.string().optional(),
@@ -11,19 +13,35 @@ export const simulateTransactionSchema = z.object({
     amount: z.string(),
     toAddress: z.string().optional(),
     walletAddress: z.string(),
-});
+}).strict();
 export const simulateTransactionTool = {
     name: "simulate_transaction",
-    description: "Dry run a swap or transfer via eth_call — no gas spent. Returns expected output, gas estimate, and revert reasons.",
+    description: "Dry run a swap or transfer via eth_call; no gas spent. Returns expected output, gas estimate, and revert reasons.",
     inputSchema: simulateTransactionSchema,
 };
-export async function handleSimulateTransaction(input) {
+export async function handleSimulateTransaction(raw) {
+    let input;
+    try {
+        input = simulateTransactionSchema.parse(raw);
+    }
+    catch (err) {
+        const msg = err instanceof z.ZodError
+            ? err.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")
+            : String(err);
+        return fail("VALIDATION_ERROR", `simulate_transaction input validation failed: ${msg}`, false, "simulate_transaction");
+    }
+    const amtErr = validatePositiveAmount(input.amount, "amount");
+    if (amtErr)
+        return fail("VALIDATION_ERROR", amtErr, false, "simulate_transaction");
+    const walletErr = validateAddress(input.walletAddress, "walletAddress");
+    if (walletErr)
+        return fail("VALIDATION_ERROR", walletErr, false, "simulate_transaction");
     const warnings = [];
     const balanceChanges = [];
     try {
         if (input.action === "swap") {
             if (!input.tokenIn || !input.tokenOut) {
-                return fail("INVALID_INPUT", "tokenIn and tokenOut required for swap simulation", false, "simulate_transaction");
+                return fail("VALIDATION_ERROR", "tokenIn and tokenOut required for swap simulation", false, "simulate_transaction");
             }
             const quote = await getDodoRoute({
                 fromToken: input.tokenIn,
@@ -52,33 +70,48 @@ export async function handleSimulateTransaction(input) {
             }
             balanceChanges.push({ token: input.tokenIn, delta: `-${input.amount}` });
             balanceChanges.push({ token: input.tokenOut, delta: `+${quote.amountOut}` });
-            return ok({ wouldSucceed: true, expectedOutput: quote.amountOut, gasEstimate: quote.gasLimit, balanceChanges, warnings });
+            return ok({
+                wouldSucceed: true,
+                expectedOutput: quote.amountOut,
+                gasEstimate: quote.gasLimit,
+                recommendedGas: { value: recommendGasWithBuffer(BigInt(quote.gasLimit)).toString(), bufferPct: DEFAULT_GAS_BUFFER_PCT },
+                balanceChanges,
+                warnings,
+            });
         }
         // Transfer simulation
         if (!input.toAddress) {
-            return fail("INVALID_INPUT", "toAddress required for transfer simulation", false, "simulate_transaction");
+            return fail("VALIDATION_ERROR", "toAddress required for transfer simulation", false, "simulate_transaction");
         }
+        const toErr = validateAddress(input.toAddress, "toAddress");
+        if (toErr)
+            return fail("VALIDATION_ERROR", toErr, false, "simulate_transaction");
         const amountWei = parseEther(input.amount);
         const balance = await publicClient.getBalance({ address: input.walletAddress });
         if (balance < amountWei) {
-            return fail("INSUFFICIENT_TESTNET_BALANCE", `Insufficient balance: have ${formatEther(balance)}, need ${input.amount}`, false, "simulate_transaction");
+            return fail("INSUFFICIENT_BALANCE", `Insufficient balance: have ${formatEther(balance)}, need ${input.amount}`, false, "simulate_transaction");
         }
         const gasEstimate = await publicClient.estimateGas({
             to: input.toAddress,
             value: amountWei,
             account: input.walletAddress,
         });
-        balanceChanges.push({ token: "PHRS", delta: `-${input.amount}` });
+        balanceChanges.push({ token: "PROS", delta: `-${input.amount}` });
         return ok({
             wouldSucceed: true,
             expectedOutput: input.amount,
             gasEstimate: gasEstimate.toString(),
+            recommendedGas: { value: recommendGasWithBuffer(gasEstimate).toString(), bufferPct: DEFAULT_GAS_BUFFER_PCT },
             balanceChanges,
             warnings,
         });
     }
     catch (err) {
-        return fail("SIMULATION_FAILED", err.message, true, "simulate_transaction");
+        const message = err.message;
+        if (message.includes("SWAP_LIQUIDITY_NOT_CONFIGURED")) {
+            return fail("SWAP_LIQUIDITY_NOT_CONFIGURED", message, false, "dodo_api");
+        }
+        return fail("SIMULATION_FAILED", message, true, "simulate_transaction");
     }
 }
 //# sourceMappingURL=simulateTransaction.js.map

package/dist/tools/simulateTransaction.js.map

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

package/dist/tools/tokenRegistryStatus.d.ts

@@ -11,17 +11,37 @@ export declare const tokenRegistryStatusSchema: z.ZodObject<{
     tokenAddress?: string | undefined;
 }>;
 export type TokenRegistryStatusInput = z.input<typeof tokenRegistryStatusSchema>;
-export type TokenRegistryStatusValue = "CANONICAL_TESTNET_TOKEN" | "SKILL_ENGINE_CANONICAL_TOKEN" | "ALTERNATE_SOURCE_TOKEN" | "CUSTOM_NON_REGISTRY" | "UNKNOWN" | "INVALID_ADDRESS";
+export type TokenRegistryStatusValue = "CANONICAL_MAINNET_TOKEN" | "SKILL_ENGINE_CANONICAL_TOKEN" | "ALTERNATE_SOURCE_TOKEN" | "CUSTOM_NON_REGISTRY" | "UNKNOWN" | "INVALID_ADDRESS";
 export declare function classifyTokenRegistryStatus(token: string): {
+    chainId: number;
+    environment: string;
+    isMainnet: boolean;
+    input: string;
+    normalizedAddress: string;
+    symbol: string;
+    status: TokenRegistryStatusValue;
+    verificationStatus: string;
+    docsSource: string;
+} | {
+    chainId: number;
+    environment: string;
+    isMainnet: boolean;
     input: string;
-    normalizedAddress: any;
-    symbol: any;
+    normalizedAddress: null;
+    symbol: null;
     status: TokenRegistryStatusValue;
-    verificationStatus: any;
-    docsSource: any;
+    verificationStatus: string;
+    docsSource: null;
+} | {
     chainId: number;
     environment: string;
     isMainnet: boolean;
+    input: string;
+    normalizedAddress: `0x${string}`;
+    symbol: null;
+    status: TokenRegistryStatusValue;
+    verificationStatus: string;
+    docsSource: null;
 };
 export declare function handleTokenRegistryStatus(raw: TokenRegistryStatusInput): Promise<ToolResponse<unknown>>;
 //# sourceMappingURL=tokenRegistryStatus.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tokenRegistryStatus.d.ts","sourceRoot":"","sources":["../../src/tools/tokenRegistryStatus.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG/D,eAAO,MAAM,yBAAyB;;;;;;;;;EAGpC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEjF,MAAM,MAAM,wBAAwB,GAChC,yBAAyB,GACzB,8BAA8B,GAC9B,wBAAwB,GACxB,qBAAqB,GACrB,SAAS,GACT,iBAAiB,CAAC;AAQtB,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM;;;;;;;;;;EA2ExD;AAED,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,wBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAG7G"}
+{"version":3,"file":"tokenRegistryStatus.d.ts","sourceRoot":"","sources":["../../src/tools/tokenRegistryStatus.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAY/D,eAAO,MAAM,yBAAyB;;;;;;;;;EAGpC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEjF,MAAM,MAAM,wBAAwB,GAChC,yBAAyB,GACzB,8BAA8B,GAC9B,wBAAwB,GACxB,qBAAqB,GACrB,SAAS,GACT,iBAAiB,CAAC;AAmCtB,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM;;;;;;;;;;;;;;;;;YAsBF,wBAAwB;;;;;;;;;;YAwC1C,wBAAwB;;;EAK5D;AAED,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,wBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CA2B7G"}

package/dist/tools/tokenRegistryStatus.js

@@ -1,38 +1,53 @@
 // ─── Tool: token_registry_status ───────────────────────────────────────
-// Classify exact token addresses without silently replacing user input.
-// The official Pharos Skill Engine (pharos-skill-engine-0.1.0)
-// assets/tokens.json lists 0xE0BE... as USDC for atlantic-testnet.
+// Classify exact token inputs against the active network token registry.
+// Pacific Mainnet uses PACIFIC_MAINNET_TOKEN_REGISTRY; Atlantic Testnet keeps
+// the legacy testnet registry for compatibility.
 // ───────────────────────────────────────────────────────────────────────
 import { z } from "zod";
 import { getAddress, isAddress } from "viem";
 import { ok } from "../lib/toolResponse.js";
-import { TOKEN_REGISTRY, CIRCLE_USDC_ADDRESS, CHAIN_ID, PHAROS_ENVIRONMENT } from "../lib/constants.js";
+import { TOKEN_REGISTRY, CIRCLE_USDC_ADDRESS, CHAIN_ID, PHAROS_ENVIRONMENT, IS_MAINNET, PACIFIC_MAINNET_TOKEN_REGISTRY, } from "../lib/constants.js";
+import { getActiveNetwork } from "../lib/networks.js";
+import { fetchGoplusTokenIdentity } from "./checkTokenSecurity.js";
 export const tokenRegistryStatusSchema = z.object({
     token: z.string().optional().describe("Token symbol or exact contract address to classify"),
     tokenAddress: z.string().optional().describe("Exact token contract address to classify"),
 });
+function activeRegistry() {
+    return getActiveNetwork().isMainnet
+        ? PACIFIC_MAINNET_TOKEN_REGISTRY
+        : TOKEN_REGISTRY;
+}
 function deriveStatus(match) {
+    if (getActiveNetwork().isMainnet || match.isMainnet)
+        return "CANONICAL_MAINNET_TOKEN";
     if (match.verificationStatus === "DOCS_VERIFIED_FROM_PHAROS_SKILL_ENGINE")
         return "SKILL_ENGINE_CANONICAL_TOKEN";
     if (match.verificationStatus === "CIRCLE_REFERENCED_USDC")
         return "ALTERNATE_SOURCE_TOKEN";
-    return "CANONICAL_TESTNET_TOKEN";
+    return "CANONICAL_MAINNET_TOKEN";
+}
+function responseBase() {
+    return {
+        chainId: CHAIN_ID,
+        environment: PHAROS_ENVIRONMENT,
+        isMainnet: IS_MAINNET,
+    };
 }
 export function classifyTokenRegistryStatus(token) {
     const raw = token.trim();
     const upper = raw.toUpperCase();
-    const bySymbol = TOKEN_REGISTRY[upper];
+    const registry = activeRegistry();
+    const bySymbol = registry[upper];
     if (bySymbol) {
         return {
             input: token,
             normalizedAddress: bySymbol.address,
             symbol: bySymbol.symbol,
             status: deriveStatus(bySymbol),
-            verificationStatus: bySymbol.verificationStatus || (bySymbol.isCanonical ? "PROJECT_CONFIGURED" : "UNVERIFIED_CONFIG_VALUE"),
-            docsSource: bySymbol.docsSource || "project constants",
-            chainId: CHAIN_ID,
-            environment: PHAROS_ENVIRONMENT,
-            isMainnet: false,
+            verificationStatus: bySymbol.verificationStatus || (bySymbol.isCanonical ? "DOCS_VERIFIED" : "UNVERIFIED_CONFIG_VALUE"),
+            docsSource: bySymbol.docsSource || "active network token registry",
+            ...responseBase(),
         };
     }
     if (!isAddress(raw)) {
@@ -40,16 +55,14 @@ export function classifyTokenRegistryStatus(token) {
             input: token,
             normalizedAddress: null,
             symbol: null,
-            status: "INVALID_ADDRESS",
-            verificationStatus: "INVALID_ADDRESS",
+            status: (raw ? "UNKNOWN" : "INVALID_ADDRESS"),
+            verificationStatus: raw ? "UNKNOWN_SYMBOL" : "INVALID_ADDRESS",
             docsSource: null,
-            chainId: CHAIN_ID,
-            environment: PHAROS_ENVIRONMENT,
-            isMainnet: false,
+            ...responseBase(),
         };
     }
     const checksum = getAddress(raw);
-    const entries = Object.values(TOKEN_REGISTRY);
+    const entries = Object.values(registry);
     const match = entries.find((t) => t.address.toLowerCase() === checksum.toLowerCase());
     if (match) {
         return {
@@ -57,15 +70,14 @@ export function classifyTokenRegistryStatus(token) {
             normalizedAddress: checksum,
             symbol: match.symbol,
             status: deriveStatus(match),
-            verificationStatus: match.verificationStatus || "PROJECT_CONFIGURED",
-            docsSource: match.docsSource || "project constants",
-            chainId: CHAIN_ID,
-            environment: PHAROS_ENVIRONMENT,
-            isMainnet: false,
+            verificationStatus: match.verificationStatus || (getActiveNetwork().isMainnet ? "DOCS_VERIFIED" : "PROJECT_CONFIGURED"),
+            docsSource: match.docsSource || "active network token registry",
+            ...responseBase(),
         };
     }
-    // Check if it's the Circle USDC address directly (even if not primary)
-    if (checksum.toLowerCase() === CIRCLE_USDC_ADDRESS.toLowerCase()) {
+    // Atlantic-only alternate USDC recognition. On Pacific Mainnet this old
+    // address is intentionally treated as custom/non-registry.
+    if (!getActiveNetwork().isMainnet && checksum.toLowerCase() === CIRCLE_USDC_ADDRESS.toLowerCase()) {
         return {
             input: token,
             normalizedAddress: checksum,
@@ -73,9 +85,7 @@ export function classifyTokenRegistryStatus(token) {
             status: "ALTERNATE_SOURCE_TOKEN",
             verificationStatus: "CIRCLE_REFERENCED_USDC",
             docsSource: "https://developers.circle.com/stablecoins/usdc-contract-addresses",
-            chainId: CHAIN_ID,
-            environment: PHAROS_ENVIRONMENT,
-            isMainnet: false,
+            ...responseBase(),
         };
     }
     return {
@@ -85,13 +95,33 @@ export function classifyTokenRegistryStatus(token) {
         status: "CUSTOM_NON_REGISTRY",
         verificationStatus: "UNVERIFIED_CUSTOM_TOKEN",
         docsSource: null,
-        chainId: CHAIN_ID,
-        environment: PHAROS_ENVIRONMENT,
-        isMainnet: false,
+        ...responseBase(),
     };
 }
 export async function handleTokenRegistryStatus(raw) {
     const input = tokenRegistryStatusSchema.parse(raw);
-    return ok(classifyTokenRegistryStatus(input.tokenAddress || input.token || ""));
+    const classification = classifyTokenRegistryStatus(input.tokenAddress || input.token || "");
+    // For custom/non-registry tokens, best-effort DISPLAY-ONLY identity enrichment.
+    // Purely additive: status/verificationStatus/symbol are never altered, metadata
+    // is never fed into policy or gates (those consume classifyTokenRegistryStatus
+    // directly), and a fetch failure leaves the response identical to before.
+    if (classification.status !== "CUSTOM_NON_REGISTRY" || !classification.normalizedAddress) {
+        return ok(classification);
+    }
+    const identity = await fetchGoplusTokenIdentity(classification.normalizedAddress);
+    if (!identity.tokenName && !identity.tokenSymbol) {
+        return ok(classification);
+    }
+    return ok({
+        ...classification,
+        tokenMetadata: {
+            tokenName: identity.tokenName,
+            tokenSymbol: identity.tokenSymbol,
+            source: "goplus_metadata",
+            verified: false,
+            displayOnly: true,
+            warning: "Untrusted display-only metadata reported by a third-party API. It does NOT verify this token's identity and does NOT imply the token is safe. The token remains UNVERIFIED_CUSTOM_TOKEN; anyone can deploy a token with any name/symbol.",
+        },
+    });
 }
 //# sourceMappingURL=tokenRegistryStatus.js.map

package/dist/tools/tokenRegistryStatus.js.map

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

package/dist/tools/verifyRiskInclusion.d.ts

@@ -0,0 +1,59 @@
+import { z } from "zod";
+export declare const verifyRiskInclusionSchema: z.ZodObject<{
+    target: z.ZodString;
+    actionHash: z.ZodOptional<z.ZodString>;
+    verifyOnchain: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    target: string;
+    verifyOnchain: boolean;
+    actionHash?: string | undefined;
+}, {
+    target: string;
+    actionHash?: string | undefined;
+    verifyOnchain?: boolean | undefined;
+}>;
+export type VerifyRiskInclusionInput = z.input<typeof verifyRiskInclusionSchema>;
+export declare const verifyRiskInclusionTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        target: z.ZodString;
+        actionHash: z.ZodOptional<z.ZodString>;
+        verifyOnchain: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        target: string;
+        verifyOnchain: boolean;
+        actionHash?: string | undefined;
+    }, {
+        target: string;
+        actionHash?: string | undefined;
+        verifyOnchain?: boolean | undefined;
+    }>;
+};
+export declare function handleVerifyRiskInclusion(raw: VerifyRiskInclusionInput): Promise<import("../sdk.js").ToolFailure | import("../sdk.js").ToolSuccess<{
+    registryContract: string | null;
+    included: boolean;
+    configured: boolean;
+    committed: boolean;
+    onchainMerkleRoot: string | null;
+    dataURI: string | null;
+    found: boolean;
+    rootMatches: boolean;
+    verifiedLocal: boolean;
+    verifiedOnchain: boolean | null;
+    expired: boolean;
+    proof: string[] | null;
+    record: {
+        target: string;
+        actionHash: string;
+        score: number;
+        level: number;
+        recommendation: number;
+        policyVersionHash: string;
+        evidenceHash: string;
+        expiresAt: string;
+    } | null;
+    source: "onchain-view" | "local-only" | "unconfigured" | "not-committed" | "not-found" | "root-mismatch" | "error";
+    error?: string;
+}>>;
+//# sourceMappingURL=verifyRiskInclusion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verifyRiskInclusion.d.ts","sourceRoot":"","sources":["../../src/tools/verifyRiskInclusion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAIpC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEjF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;CAOnC,CAAC;AAEF,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;IA4B5E"}

package/dist/tools/verifyRiskInclusion.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+import { isAddress } from "viem";
+import { ok, fail } from "../lib/toolResponse.js";
+import { SAFEHANDS_REGISTRY_ADDRESS } from "../lib/constants.js";
+import { verifyRiskInclusion } from "../lib/riskInclusion.js";
+export const verifyRiskInclusionSchema = z.object({
+    target: z.string().describe("The address whose risk record you want to prove is included in the committed on-chain Merkle root."),
+    actionHash: z.string().optional().describe("Optional 32-byte action hash to disambiguate when a target has multiple records in the batch."),
+    verifyOnchain: z.boolean().optional().default(true).describe("If true (default), also verify the Merkle proof through the contract's verifyRiskRecord view for a trustless result."),
+});
+export const verifyRiskInclusionTool = {
+    name: "verify_risk_inclusion",
+    description: "Prove a target's SafeHands risk record is included in the currently committed on-chain Merkle root. " +
+        "Fetches the committed root + data-availability batch, rebuilds the Merkle proof, and verifies it both " +
+        "locally and (by default) through the SafeHandsRegistry.verifyRiskRecord view. Read-only, keyless, composable.",
+    inputSchema: verifyRiskInclusionSchema,
+};
+export async function handleVerifyRiskInclusion(raw) {
+    const input = verifyRiskInclusionSchema.parse(raw);
+    if (!isAddress(input.target)) {
+        return fail("VALIDATION_ERROR", "target is not a valid EVM address.", false, "verify_risk_inclusion");
+    }
+    try {
+        const result = await verifyRiskInclusion({ target: input.target, actionHash: input.actionHash }, { verifyOnchain: input.verifyOnchain });
+        return ok({
+            ...result,
+            registryContract: SAFEHANDS_REGISTRY_ADDRESS || null,
+            // A single, unambiguous verdict for callers that don't want to interpret the flags themselves.
+            included: Boolean(result.found &&
+                result.rootMatches &&
+                result.verifiedLocal &&
+                (result.verifiedOnchain === null || result.verifiedOnchain === true) &&
+                !result.expired),
+        });
+    }
+    catch (err) {
+        return fail("RISK_INCLUSION_FAILED", `Failed to verify risk inclusion: ${err.message}`, true, "verify_risk_inclusion");
+    }
+}
+//# sourceMappingURL=verifyRiskInclusion.js.map

package/dist/tools/verifyRiskInclusion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifyRiskInclusion.js","sourceRoot":"","sources":["../../src/tools/verifyRiskInclusion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oGAAoG,CAAC;IACjI,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+FAA+F,CAAC;IAC3I,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,sHAAsH,CAAC;CACrL,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,sGAAsG;QACtG,wGAAwG;QACxG,+GAA+G;IACjH,WAAW,EAAE,yBAAyB;CACvC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,GAA6B;IAC3E,MAAM,KAAK,GAAG,yBAAyB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEnD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,kBAAkB,EAAE,oCAAoC,EAAE,KAAK,EAAE,uBAAuB,CAAC,CAAC;IACxG,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,mBAAmB,CACtC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,EACtD,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CACvC,CAAC;QAEF,OAAO,EAAE,CAAC;YACR,GAAG,MAAM;YACT,gBAAgB,EAAE,0BAA0B,IAAI,IAAI;YACpD,+FAA+F;YAC/F,QAAQ,EAAE,OAAO,CACf,MAAM,CAAC,KAAK;gBACV,MAAM,CAAC,WAAW;gBAClB,MAAM,CAAC,aAAa;gBACpB,CAAC,MAAM,CAAC,eAAe,KAAK,IAAI,IAAI,MAAM,CAAC,eAAe,KAAK,IAAI,CAAC;gBACpE,CAAC,MAAM,CAAC,OAAO,CAClB;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,uBAAuB,EAAE,oCAAqC,GAAa,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,uBAAuB,CAAC,CAAC;IACpI,CAAC;AACH,CAAC"}