safehands-pharos 1.5.0 → 2.6.0

package/dist/tools/sendPayment.d.ts

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

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

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

package/dist/tools/sendPayment.js

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

package/dist/tools/sendPayment.js.map

@@ -1 +1 @@
-{"version":3,"file":"sendPayment.js","sourceRoot":"","sources":["../../src/tools/sendPayment.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,mCAAmC,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC3G,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,EAAE,EAA4B,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACnG,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACpI,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEvF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC;CAC3G,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,wHAAwH;IACrI,WAAW,EAAE,iBAAiB;CAC/B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAqB;IAC3D,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,MAAM,EAAE,CAAC;QAC/C,OAAO,IAAI,CACT,sBAAsB,EACtB,uGAAuG,EACvG,KAAK,EACL,cAAc,CACf,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC;IAErC,MAAM,MAAM,GAAG,oBAAoB,CAAC;QAClC,UAAU,EAAE,cAAc;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,UAAU,EAAE,MAAM;QAClB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,iBAAiB,EAAE,KAAK;QACxB,OAAO,EAAE,QAAQ;QACjB,WAAW,EAAE,kBAAkB;QAC/B,SAAS,EAAE,KAAK;QAChB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,IAAI;KACrB,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,sCAAsC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAC3H,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC,mBAAmB,EAAE,oDAAoD,kBAAkB,SAAS,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAC3I,CAAC;IAED,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,eAAe,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAC7D,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,OAAO,IAAI,CACT,4BAA4B,EAC5B,qCAAqC,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,EACnM,KAAK,EACL,cAAc,CACf,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAE/E,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,wBAAwB,EAAE,2BAA2B,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAC5F,CAAC;IACD,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC;IAE/B,IAAI,KAAK,CAAC,SAAS,KAAK,4CAA4C,EAAE,CAAC;QACrE,OAAO,IAAI,CAAC,sBAAsB,EAAE,6BAA6B,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC;QAClE,QAAQ,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;IAC1E,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAEvC,IAAI,OAAO,GAAG,SAAS,GAAG,WAAW,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC,8BAA8B,EAAE,8BAA8B,WAAW,CAAC,OAAO,CAAC,eAAe,KAAK,CAAC,MAAM,QAAQ,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAC5J,CAAC;IACD,UAAU,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAEpC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;IACtD,IAAI,QAAQ,GAAG,qBAAqB,EAAE,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,SAAS,QAAQ,qCAAqC,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC;QAC5B,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,aAAa;KACd,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,SAAS,GAAG,oBAAoB,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,gBAAgB,EAAE,gCAAgC,IAAI,CAAC,SAAS,SAAS,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IACjI,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,mCAAmC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC;YAC1C,EAAE,EAAE,KAAK,CAAC,SAA0B;YACpC,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAE/E,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,aAAa,EAAE,2DAA2D,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;QACjH,CAAC;QAED,WAAW,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QAEtC,OAAO,EAAE,CAAC;YACR,MAAM;YACN,WAAW,EAAE,cAAc,CAAC,MAAM,CAAC;YACnC,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,UAAU,EAAE,MAAM,CAAC,IAAI;YACvB,aAAa;YACb,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE;YACnC,UAAU;YACV,MAAM;YACN,cAAc,EAAE;gBACd,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,UAAU,EAAE,KAAK;aAClB;YACD,MAAM,EAAE,cAAc;SACvB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,qBAAqB,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}
+{"version":3,"file":"sendPayment.js","sourceRoot":"","sources":["../../src/tools/sendPayment.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,mCAAmC,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC3G,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,QAAQ,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC1H,OAAO,EAAE,4BAA4B,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACvG,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACjH,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErG,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;IAClG,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,wKAAwK,CAAC;CAClO,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,sJAAsJ;IACnK,WAAW,EAAE,iBAAiB;CAC/B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAqB;IAC3D,IAAI,KAAwC,CAAC;IAC7C,IAAI,CAAC;QACH,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,CAAC,CAAC,QAAQ;YACnC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACvE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC,kBAAkB,EAAE,yCAAyC,GAAG,EAAE,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IACzG,CAAC;IAED,MAAM,WAAW,GAAG,aAAa,CAAC;QAChC,sBAAsB,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC9C,sBAAsB,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC;KACrD,CAAC,CAAC;IACH,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,4BAA4B,CAAC,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/E,IAAI,yBAAyB,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC;IAErC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC,mBAAmB,EAAE,mEAAmE,kBAAkB,qGAAqG,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IACtP,CAAC;IAED,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,eAAe,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAC7D,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,OAAO,IAAI,CACT,4BAA4B,EAC5B,qCAAqC,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,EACnM,KAAK,EACL,cAAc,CACf,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAE/E,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,wBAAwB,EAAE,2BAA2B,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAC5F,CAAC;IACD,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC;IAE/B,IAAI,KAAK,CAAC,SAAS,KAAK,4CAA4C,EAAE,CAAC;QACrE,OAAO,IAAI,CAAC,sBAAsB,EAAE,6BAA6B,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC;QAClE,QAAQ,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;IAC1E,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAEvC,IAAI,OAAO,GAAG,SAAS,GAAG,WAAW,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC,sBAAsB,EAAE,8BAA8B,WAAW,CAAC,OAAO,CAAC,eAAe,KAAK,CAAC,MAAM,QAAQ,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IACpJ,CAAC;IACD,UAAU,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAEpC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;IACtD,IAAI,QAAQ,GAAG,qBAAqB,EAAE,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,SAAS,QAAQ,oCAAoC,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC;QAC5B,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,aAAa;KACd,CAAC,CAAC;IAEH,0EAA0E;IAC1E,0EAA0E;IAC1E,4EAA4E;IAC5E,6EAA6E;IAC7E,qDAAqD;IACrD,MAAM,MAAM,GAAG,oBAAoB,CAAC;QAClC,UAAU,EAAE,cAAc;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,UAAU,EAAE,MAAM;QAClB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,iBAAiB,EAAE,KAAK;QACxB,OAAO,EAAE,QAAQ;QACjB,WAAW,EAAE,kBAAkB;QAC/B,SAAS,EAAE,UAAU;QACrB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,IAAI;QACpB,IAAI,EAAE,0BAA0B,CAAC,IAAI,CAAC;KACvC,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,oBAAoB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7I,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IAEpC,4EAA4E;IAC5E,sFAAsF;IACtF,MAAM,WAAW,GAAG,iBAAiB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAChE,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,IAAI,CACT,4BAA4B,EAC5B,qCAAqC,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,EACtM,KAAK,EACL,cAAc,CACf,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,mCAAmC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC;YAC1C,EAAE,EAAE,KAAK,CAAC,SAA0B;YACpC,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAE/E,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,kBAAkB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;YAC7C,OAAO,IAAI,CAAC,aAAa,EAAE,2DAA2D,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;QACjH,CAAC;QAED,OAAO,EAAE,CAAC;YACR,MAAM;YACN,WAAW,EAAE,cAAc,CAAC,MAAM,CAAC;YACnC,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,UAAU,EAAE,MAAM,CAAC,IAAI;YACvB,aAAa;YACb,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE;YACnC,UAAU;YACV,MAAM;YACN,cAAc,EAAE;gBACd,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,UAAU,EAAE,KAAK;aAClB;YACD,MAAM,EAAE,cAAc;SACvB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,kBAAkB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QAC7C,OAAO,qBAAqB,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}

package/dist/tools/setAgentPolicy.d.ts

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

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

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

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"}