@elizaos/agent 2.0.0-alpha.144 → 2.0.0-alpha.151

package/packages/agent/src/actions/execute-trade.js

@@ -0,0 +1,299 @@
+/**
+ * EXECUTE_TRADE action - executes a BSC token trade (buy or sell).
+ *
+ * When triggered the action:
+ *   1. Validates parameters (side, tokenAddress format, amount > 0)
+ *   2. POSTs to the local trade execution API with agent automation header
+ *   3. Returns structured result: quote details, execution status, txHash
+ *      if executed, or unsigned TX info if user-sign mode
+ *
+ * All business logic (permissions, safety caps, signing) is handled
+ * server-side - this action is a thin wrapper.
+ *
+ * @module actions/execute-trade
+ */
+import { logger } from "@elizaos/core";
+import { buildAuthHeaders, getWalletActionApiPort, } from "./wallet-action-shared.js";
+/** Timeout for the trade API call (includes on-chain confirmation). */
+const TRADE_TIMEOUT_MS = 60_000;
+/** Matches a 0x-prefixed 40-hex-char BSC address. */
+const BSC_ADDRESS_RE = /^0x[0-9a-fA-F]{40}$/;
+/** Check if a value is a valid extracted param (not a placeholder). */
+function isValidParam(val) {
+    if (typeof val !== "string")
+        return false;
+    const v = val.trim().toLowerCase();
+    return (v.length > 0 &&
+        v !== "unknown" &&
+        !v.includes("required") &&
+        v !== "undefined" &&
+        v !== "null");
+}
+function walletNetworkLabel() {
+    return process.env.ELIZA_WALLET_NETWORK?.trim().toLowerCase() === "testnet"
+        ? "BSC testnet"
+        : "BSC";
+}
+function buildTradeSuccessText(args) {
+    return [
+        "Action: EXECUTE_TRADE",
+        `Chain: ${walletNetworkLabel()}`,
+        `Side: ${args.side}`,
+        `Amount: ${args.amount} BNB`,
+        `Token: ${args.tokenAddress}`,
+        `Route provider: ${args.routeProvider}`,
+        `Execution mode: ${args.mode}`,
+        "Executed: true",
+        `Tx hash: ${args.txHash}`,
+        `Explorer: ${args.explorerUrl}`,
+        `Status: ${args.status}`,
+    ].join("\n");
+}
+function buildTradeFailureText(args) {
+    return [
+        "Action: EXECUTE_TRADE",
+        `Chain: ${walletNetworkLabel()}`,
+        `Side: ${args.side}`,
+        `Amount: ${args.amount} BNB`,
+        `Token: ${args.tokenAddress}`,
+        `Route provider: ${args.routeProvider}`,
+        `Execution mode: ${args.mode}`,
+        "Executed: false",
+        `Requires user signature: ${args.requiresUserSignature ? "true" : "false"}`,
+        `Reason: ${args.reason}`,
+    ].join("\n");
+}
+export const executeTradeAction = {
+    name: "EXECUTE_TRADE",
+    similes: ["BUY_TOKEN", "SELL_TOKEN", "SWAP", "TRADE", "BUY", "SELL"],
+    description: "Execute a BSC token trade (buy or sell). Use this when a user asks to " +
+        "buy or sell a token on BSC/BNB Chain. The trade is routed through " +
+        "PancakeSwap and respects the current trade permission mode.",
+    validate: async (runtime) => {
+        const hasWallet = runtime.getSetting("EVM_PRIVATE_KEY") ||
+            runtime.getSetting("PRIVY_APP_ID") ||
+            runtime.getSetting("STEWARD_API_URL");
+        return Boolean(hasWallet);
+    },
+    handler: async (_runtime, _message, _state, options, callback) => {
+        try {
+            const params = options?.parameters;
+            logger.debug(`[EXECUTE_TRADE] handler called with params:`, JSON.stringify(params ?? {}));
+            const rawSide = isValidParam(params?.side)
+                ? params?.side
+                : undefined;
+            const side = typeof rawSide === "string" ? rawSide.trim().toLowerCase() : undefined;
+            if (side !== "buy" && side !== "sell") {
+                const text = 'I need a valid trade side ("buy" or "sell").';
+                callback?.({ text, action: "EXECUTE_TRADE_FAILED" });
+                return { text, success: false };
+            }
+            const rawAddr = isValidParam(params?.tokenAddress)
+                ? params?.tokenAddress
+                : undefined;
+            const tokenAddress = typeof rawAddr === "string" ? rawAddr.trim() : undefined;
+            if (!tokenAddress || !BSC_ADDRESS_RE.test(tokenAddress)) {
+                const text = "I need a valid BSC token contract address (0x-prefixed, 40 hex chars).";
+                callback?.({ text, action: "EXECUTE_TRADE_FAILED" });
+                return { text, success: false };
+            }
+            const rawAmt = isValidParam(params?.amount)
+                ? params?.amount
+                : typeof params?.amount === "number" && params.amount > 0
+                    ? String(params.amount)
+                    : undefined;
+            const amountRaw = typeof rawAmt === "string" ? rawAmt.trim() : undefined;
+            if (!amountRaw ||
+                Number.isNaN(Number(amountRaw)) ||
+                Number(amountRaw) <= 0) {
+                const text = "I need a positive numeric amount for the trade.";
+                callback?.({ text, action: "EXECUTE_TRADE_FAILED" });
+                return { text, success: false };
+            }
+            const slippageBps = typeof params?.slippageBps === "number"
+                ? params.slippageBps
+                : typeof params?.slippageBps === "string" &&
+                    params.slippageBps.trim() !== ""
+                    ? Number(params.slippageBps)
+                    : 300;
+            if (Number.isNaN(slippageBps) || slippageBps < 0) {
+                const text = "slippageBps must be a non-negative number.";
+                callback?.({ text, action: "EXECUTE_TRADE_FAILED" });
+                return { text, success: false };
+            }
+            const routeProvider = typeof params?.routeProvider === "string" &&
+                params.routeProvider.trim().length > 0
+                ? params.routeProvider.trim()
+                : "pancakeswap-v2";
+            logger.debug(`[EXECUTE_TRADE] resolved: side=${side} token=${tokenAddress} amount=${amountRaw} slippage=${slippageBps} routeProvider=${routeProvider}`);
+            const response = await fetch(`http://127.0.0.1:${getWalletActionApiPort()}/api/wallet/trade/execute`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "X-Eliza-Agent-Action": "1",
+                    ...buildAuthHeaders(),
+                },
+                body: JSON.stringify({
+                    side,
+                    tokenAddress,
+                    amount: amountRaw,
+                    slippageBps,
+                    routeProvider,
+                    confirm: true,
+                }),
+                signal: AbortSignal.timeout(TRADE_TIMEOUT_MS),
+            });
+            if (!response.ok) {
+                const body = (await response.json().catch(() => ({})));
+                const text = buildTradeFailureText({
+                    side,
+                    amount: amountRaw,
+                    tokenAddress,
+                    routeProvider,
+                    mode: "unknown",
+                    requiresUserSignature: false,
+                    reason: body.error ?? `HTTP ${response.status}`,
+                });
+                callback?.({ text, action: "EXECUTE_TRADE_FAILED" });
+                return { text, success: false };
+            }
+            const result = (await response.json());
+            logger.debug(`[EXECUTE_TRADE] API response:`, JSON.stringify({
+                ok: result.ok,
+                side: result.side,
+                mode: result.mode,
+                executed: result.executed,
+                requiresUserSignature: result.requiresUserSignature,
+                hasExecution: !!result.execution,
+                error: result.error,
+            }));
+            const resolvedRouteProvider = typeof result.quote?.routeProvider === "string"
+                ? result.quote.routeProvider
+                : routeProvider;
+            if (!result.ok) {
+                const text = buildTradeFailureText({
+                    side,
+                    amount: amountRaw,
+                    tokenAddress,
+                    routeProvider: resolvedRouteProvider,
+                    mode: result.mode,
+                    requiresUserSignature: result.requiresUserSignature,
+                    reason: result.error ?? "unknown error",
+                });
+                callback?.({ text, action: "EXECUTE_TRADE_FAILED" });
+                return { text, success: false };
+            }
+            if (result.executed && result.execution) {
+                const text = buildTradeSuccessText({
+                    side,
+                    amount: amountRaw,
+                    tokenAddress,
+                    routeProvider: resolvedRouteProvider,
+                    mode: result.mode,
+                    txHash: result.execution.hash,
+                    explorerUrl: result.execution.explorerUrl,
+                    status: result.execution.status,
+                });
+                callback?.({
+                    text,
+                    action: "EXECUTE_TRADE_SUCCESS",
+                    txHash: result.execution.hash,
+                    explorerUrl: result.execution.explorerUrl,
+                    executionMode: result.mode,
+                    routeProvider: resolvedRouteProvider,
+                    executed: true,
+                    tokenAddress,
+                    side,
+                });
+                return {
+                    text,
+                    success: true,
+                    data: {
+                        side,
+                        tokenAddress,
+                        amount: amountRaw,
+                        mode: result.mode,
+                        routeProvider: resolvedRouteProvider,
+                        txHash: result.execution.hash,
+                        explorerUrl: result.execution.explorerUrl,
+                        executed: true,
+                    },
+                };
+            }
+            // For agent automation, reporting "success" without an on-chain execution
+            // leads to false-positive heartbeat status.
+            const text = buildTradeFailureText({
+                side,
+                amount: amountRaw,
+                tokenAddress,
+                routeProvider: resolvedRouteProvider,
+                mode: result.mode,
+                requiresUserSignature: result.requiresUserSignature,
+                reason: result.requiresUserSignature
+                    ? `User signature is required to complete the ${side}.`
+                    : "Trade was prepared but not executed on-chain.",
+            });
+            callback?.({
+                text,
+                action: "EXECUTE_TRADE_FAILED",
+                executionMode: result.mode,
+                routeProvider: resolvedRouteProvider,
+                executed: false,
+                tokenAddress,
+                side,
+                requiresUserSignature: result.requiresUserSignature,
+            });
+            return {
+                text,
+                success: false,
+                data: {
+                    side,
+                    tokenAddress,
+                    amount: amountRaw,
+                    mode: result.mode,
+                    routeProvider: resolvedRouteProvider,
+                    requiresUserSignature: result.requiresUserSignature,
+                    executed: false,
+                    unsignedTx: result.unsignedTx,
+                },
+            };
+        }
+        catch (err) {
+            const text = `Trade failed: ${err instanceof Error ? err.message : String(err)}`;
+            callback?.({ text, action: "EXECUTE_TRADE_FAILED" });
+            return { text, success: false };
+        }
+    },
+    parameters: [
+        {
+            name: "side",
+            description: 'Trade direction: "buy" or "sell"',
+            required: true,
+            schema: { type: "string" },
+        },
+        {
+            name: "tokenAddress",
+            description: "BSC token contract address (0x-prefixed, 40 hex characters)",
+            required: true,
+            schema: { type: "string" },
+        },
+        {
+            name: "amount",
+            description: 'Human-readable trade amount (e.g. "0.5" BNB for buys, or token amount for sells)',
+            required: true,
+            schema: { type: "string" },
+        },
+        {
+            name: "slippageBps",
+            description: "Slippage tolerance in basis points (default 300 = 3%)",
+            required: false,
+            schema: { type: "number" },
+        },
+        {
+            name: "routeProvider",
+            description: 'Route provider preference for the swap: "pancakeswap-v2" or "0x". Defaults to "pancakeswap-v2".',
+            required: false,
+            schema: { type: "string" },
+        },
+    ],
+};

package/packages/agent/src/actions/get-self-status.d.ts

@@ -0,0 +1,13 @@
+/**
+ * GET_SELF_STATUS action — on-demand detail retrieval from the Self-Awareness System.
+ *
+ * Provides Layer 2 detail for a specific module or all modules.
+ * The always-on Layer 1 summary (injected via the self-status provider)
+ * gives a brief overview every turn; this action lets the agent (or user)
+ * drill down when more context is needed.
+ *
+ * @module actions/get-self-status
+ */
+import type { Action } from "@elizaos/core";
+export declare const getSelfStatusAction: Action;
+//# sourceMappingURL=get-self-status.d.ts.map

package/packages/agent/src/actions/get-self-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-self-status.d.ts","sourceRoot":"","sources":["../../../../../src/actions/get-self-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,eAAe,CAAC;AAkB5D,eAAO,MAAM,mBAAmB,EAAE,MAwDjC,CAAC"}

package/packages/agent/src/actions/get-self-status.js

@@ -0,0 +1,66 @@
+/**
+ * GET_SELF_STATUS action — on-demand detail retrieval from the Self-Awareness System.
+ *
+ * Provides Layer 2 detail for a specific module or all modules.
+ * The always-on Layer 1 summary (injected via the self-status provider)
+ * gives a brief overview every turn; this action lets the agent (or user)
+ * drill down when more context is needed.
+ *
+ * @module actions/get-self-status
+ */
+import { getGlobalAwarenessRegistry } from "@elizaos/shared/awareness";
+const VALID_MODULES = [
+    "all",
+    "runtime",
+    "permissions",
+    "wallet",
+    "provider",
+    "pluginHealth",
+    "connectors",
+    "cloud",
+    "features",
+];
+export const getSelfStatusAction = {
+    name: "GET_SELF_STATUS",
+    similes: [
+        "CHECK_STATUS",
+        "SELF_STATUS",
+        "MY_STATUS",
+        "SYSTEM_STATUS",
+        "CHECK_SELF",
+    ],
+    description: "Get detailed self-status about a specific module (wallet, permissions, plugins, etc.) or all modules. " +
+        "Use this when you need more detail than the always-on summary provides.",
+    validate: async () => true,
+    handler: async (runtime, _message, _state, options) => {
+        const registry = runtime.getService("AWARENESS_REGISTRY") ?? getGlobalAwarenessRegistry();
+        if (!registry) {
+            return {
+                text: "Self-awareness registry is not available.",
+                success: false,
+            };
+        }
+        const params = options?.parameters;
+        const rawModule = typeof params?.module === "string" ? params.module : "all";
+        const module = VALID_MODULES.includes(rawModule)
+            ? rawModule
+            : "all";
+        const detailLevel = params?.detailLevel === "full" ? "full" : "brief";
+        const text = await registry.getDetail(runtime, module, detailLevel);
+        return { text, success: true };
+    },
+    parameters: [
+        {
+            name: "module",
+            description: "Which module: all, runtime, permissions, wallet, provider, pluginHealth, connectors, cloud, features.",
+            required: false,
+            schema: { type: "string" },
+        },
+        {
+            name: "detailLevel",
+            description: '"brief" (~200 tokens) or "full" (~2000 tokens).',
+            required: false,
+            schema: { type: "string" },
+        },
+    ],
+};

package/packages/agent/src/actions/gmail.d.ts

@@ -1,33 +1,2 @@
-import type { Action, IAgentRuntime, Memory, State } from "@elizaos/core";
-type GmailSubaction = "triage" | "needs_response" | "search" | "read" | "draft_reply" | "draft_batch_replies" | "send_reply" | "send_batch_replies" | "send_message";
-export type GmailLlmPlan = {
-    subaction: GmailSubaction | null;
-    queries: string[];
-    messageId?: string;
-    replyNeededOnly?: boolean;
-    response?: string;
-    shouldAct?: boolean | null;
-    to?: string[];
-    cc?: string[];
-    bcc?: string[];
-    subject?: string;
-    bodyText?: string;
-};
-type GmailComposeDraftStatus = "pending_clarification" | "sent";
-type GmailComposeDraft = {
-    subaction: "send_message";
-    status: GmailComposeDraftStatus;
-    intent?: string;
-    to?: string[];
-    cc?: string[];
-    bcc?: string[];
-    subject?: string;
-    bodyText?: string;
-    updatedAt?: string;
-};
-export declare function extractGmailPlanWithLlm(runtime: IAgentRuntime, message: Memory, state: State | undefined, intent: string, activeComposeDraft?: GmailComposeDraft | null): Promise<GmailLlmPlan>;
-export declare const gmailAction: Action & {
-    suppressPostActionContinuation?: boolean;
-};
-export {};
+export * from "@elizaos/app-lifeops/actions/gmail";
 //# sourceMappingURL=gmail.d.ts.map

package/packages/agent/src/actions/gmail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gmail.d.ts","sourceRoot":"","sources":["../../../../../src/actions/gmail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EAKN,aAAa,EACb,MAAM,EACN,KAAK,EACN,MAAM,eAAe,CAAC;AA6CvB,KAAK,cAAc,GACf,QAAQ,GACR,gBAAgB,GAChB,QAAQ,GACR,MAAM,GACN,aAAa,GACb,qBAAqB,GACrB,YAAY,GACZ,oBAAoB,GACpB,cAAc,CAAC;AAEnB,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,uBAAuB,GAAG,uBAAuB,GAAG,MAAM,CAAC;AAEhE,KAAK,iBAAiB,GAAG;IACvB,SAAS,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,uBAAuB,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAmtBF,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,GAAG,SAAS,EACxB,MAAM,EAAE,MAAM,EACd,kBAAkB,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAC5C,OAAO,CAAC,YAAY,CAAC,CAkMvB;AAgRD,eAAO,MAAM,WAAW,EAAE,MAAM,GAAG;IACjC,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAs+B1C,CAAC"}
+{"version":3,"file":"gmail.d.ts","sourceRoot":"","sources":["../../../../../src/actions/gmail.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC"}