@elizaos/agent 2.0.0-alpha.98 → 2.0.0-beta.2

package/packages/agent/src/api/server-helpers-wallet.js

@@ -0,0 +1,177 @@
+/**
+ * Wallet intent/export helpers extracted from server.ts.
+ */
+import crypto from "node:crypto";
+// ---------------------------------------------------------------------------
+// Wallet intent fallback parsing
+// ---------------------------------------------------------------------------
+const EVM_ADDRESS_CAPTURE_RE = /\b0x[a-fA-F0-9]{40}\b/g;
+const DECIMAL_AMOUNT_CAPTURE_RE = /\b(\d+(?:\.\d+)?)\b/;
+const SEND_NATIVE_ASSET_RE = /\b(?:t?bnb|bnb|eth|usdt|usdc|busd|dai|weth|wbtc)\b/i;
+const SWAP_ROUTE_PROVIDER_RE = /\b(pancakeswap-v2|0x|auto)\b/i;
+function normalizeWalletAssetSymbol(asset) {
+    const normalized = asset.trim().toUpperCase();
+    if (normalized === "TBNB")
+        return "BNB";
+    return normalized;
+}
+function resolveWalletDrillTokenAddress() {
+    if (process.env.NODE_ENV === "production" && !process.env.VITEST) {
+        return null;
+    }
+    const raw = process.env.WALLET_DRILL_TOKEN_ADDRESS?.trim();
+    return raw && /^0x[a-fA-F0-9]{40}$/.test(raw) ? raw : null;
+}
+function buildWalletParameterFailureReply(actionName, reason) {
+    const walletNetwork = process.env.ELIZA_WALLET_NETWORK?.trim().toLowerCase() === "testnet"
+        ? "BSC testnet"
+        : "BSC";
+    return [
+        `Action: ${actionName}`,
+        `Chain: ${walletNetwork}`,
+        "Executed: false",
+        `Reason: ${reason}`,
+    ].join("\n");
+}
+function inferTransferFallbackAction(prompt) {
+    if (!/\b(send|transfer|pay)\b/i.test(prompt))
+        return null;
+    const recipient = prompt.match(EVM_ADDRESS_CAPTURE_RE)?.[0];
+    if (!recipient) {
+        return {
+            errorText: buildWalletParameterFailureReply("TRANSFER_TOKEN", "I need a recipient EVM address to send funds."),
+        };
+    }
+    const amount = prompt.match(DECIMAL_AMOUNT_CAPTURE_RE)?.[1];
+    if (!amount) {
+        return {
+            errorText: buildWalletParameterFailureReply("TRANSFER_TOKEN", "I need a positive transfer amount."),
+        };
+    }
+    const assetMatch = prompt.match(SEND_NATIVE_ASSET_RE)?.[0];
+    if (!assetMatch) {
+        return {
+            errorText: buildWalletParameterFailureReply("TRANSFER_TOKEN", "I need an asset symbol such as BNB, USDT, or USDC."),
+        };
+    }
+    return {
+        action: {
+            name: "TRANSFER_TOKEN",
+            parameters: {
+                toAddress: recipient,
+                amount,
+                assetSymbol: normalizeWalletAssetSymbol(assetMatch),
+            },
+        },
+    };
+}
+function inferTradeSide(prompt) {
+    if (/\bsell\b/i.test(prompt))
+        return "sell";
+    if (/\b(buy|swap|trade)\b/i.test(prompt))
+        return "buy";
+    return null;
+}
+function inferTradeFallbackAction(prompt) {
+    if (!/\b(swap|trade|buy|sell)\b/i.test(prompt))
+        return null;
+    const side = inferTradeSide(prompt);
+    if (!side) {
+        return {
+            errorText: buildWalletParameterFailureReply("EXECUTE_TRADE", 'I need a trade side ("buy" or "sell").'),
+        };
+    }
+    const amount = prompt.match(DECIMAL_AMOUNT_CAPTURE_RE)?.[1];
+    if (!amount) {
+        return {
+            errorText: buildWalletParameterFailureReply("EXECUTE_TRADE", "I need a positive trade amount."),
+        };
+    }
+    const addresses = prompt.match(EVM_ADDRESS_CAPTURE_RE) ?? [];
+    const drillTokenAddress = resolveWalletDrillTokenAddress();
+    const tokenAddress = addresses[0] ?? drillTokenAddress;
+    if (!tokenAddress) {
+        return {
+            errorText: buildWalletParameterFailureReply("EXECUTE_TRADE", drillTokenAddress === null &&
+                process.env.NODE_ENV === "production" &&
+                !process.env.VITEST
+                ? "I need a target token contract address in the prompt."
+                : "I need a target token address. Set WALLET_DRILL_TOKEN_ADDRESS or include the token contract address in the prompt."),
+        };
+    }
+    const routeProvider = prompt.match(SWAP_ROUTE_PROVIDER_RE)?.[1]?.toLowerCase() ??
+        "pancakeswap-v2";
+    return {
+        action: {
+            name: "EXECUTE_TRADE",
+            parameters: {
+                side,
+                amount,
+                tokenAddress,
+                routeProvider,
+            },
+        },
+    };
+}
+export function inferWalletExecutionFallback(prompt) {
+    return (inferTransferFallbackAction(prompt) ?? inferTradeFallbackAction(prompt));
+}
+export function hasUsableWalletFallbackParams(action) {
+    const parameters = action.parameters ?? {};
+    if (action.name === "TRANSFER_TOKEN") {
+        return (typeof parameters.toAddress === "string" &&
+            /^0x[a-fA-F0-9]{40}$/.test(parameters.toAddress) &&
+            typeof parameters.amount === "string" &&
+            parameters.amount.trim().length > 0 &&
+            typeof parameters.assetSymbol === "string" &&
+            parameters.assetSymbol.trim().length > 0);
+    }
+    if (action.name === "EXECUTE_TRADE") {
+        return ((parameters.side === "buy" || parameters.side === "sell") &&
+            typeof parameters.amount === "string" &&
+            parameters.amount.trim().length > 0 &&
+            typeof parameters.tokenAddress === "string" &&
+            /^0x[a-fA-F0-9]{40}$/.test(parameters.tokenAddress));
+    }
+    return true;
+}
+// ---------------------------------------------------------------------------
+// Wallet export rejection
+// ---------------------------------------------------------------------------
+function tokenMatches(expected, provided) {
+    const a = Buffer.from(expected, "utf8");
+    const b = Buffer.from(provided, "utf8");
+    if (a.length !== b.length)
+        return false;
+    return crypto.timingSafeEqual(a, b);
+}
+export function resolveWalletExportRejection(req, body) {
+    if (!body.confirm) {
+        return {
+            status: 403,
+            reason: 'Export requires explicit confirmation. Send { "confirm": true } in the request body.',
+        };
+    }
+    const expected = process.env.ELIZA_WALLET_EXPORT_TOKEN?.trim();
+    if (!expected) {
+        return {
+            status: 403,
+            reason: "Wallet export is disabled. Set ELIZA_WALLET_EXPORT_TOKEN to enable secure exports.",
+        };
+    }
+    const headerToken = typeof req.headers["x-eliza-export-token"] === "string"
+        ? req.headers["x-eliza-export-token"].trim()
+        : "";
+    const bodyToken = typeof body.exportToken === "string" ? body.exportToken.trim() : "";
+    const provided = headerToken || bodyToken;
+    if (!provided) {
+        return {
+            status: 401,
+            reason: "Missing export token. Provide X-Eliza-Export-Token header or exportToken in request body.",
+        };
+    }
+    if (!tokenMatches(expected, provided)) {
+        return { status: 401, reason: "Invalid export token." };
+    }
+    return null;
+}

package/packages/agent/src/api/server-helpers.d.ts

@@ -0,0 +1,96 @@
+/**
+ * General-purpose helper functions extracted from server.ts.
+ *
+ * Utility functions for plugin services, UUID validation, state persistence,
+ * onboarding, config, and package root resolution.
+ */
+import type http from "node:http";
+import { type AgentRuntime, type ChannelType, createMessageMemory, type Media, type UUID } from "@elizaos/core";
+import type { ElizaConfig } from "../config/config.ts";
+import { type AgentEventServiceLike } from "../runtime/agent-event-service.ts";
+import { type CoreManagerLike, type PluginManagerLike } from "../services/plugin-manager-types.ts";
+import type { ChatAttachmentWithData, ServerState } from "./server-types.ts";
+export declare function getAgentEventSvc(runtime: AgentRuntime | null): AgentEventServiceLike | null;
+export declare function requirePluginManager(runtime: AgentRuntime | null): PluginManagerLike;
+export declare function requireCoreManager(runtime: AgentRuntime | null): CoreManagerLike;
+export declare function isUuidLike(value: string): value is UUID;
+export interface DeletedConversationsStateFile {
+    version: 1;
+    updatedAt: string;
+    ids: string[];
+}
+export declare function readDeletedConversationIdsFromState(): Set<string>;
+export declare function persistDeletedConversationIdsToState(ids: Set<string>): void;
+export declare function readOGCodeFromState(): string | null;
+export declare function initializeOGCodeInState(): void;
+/** Metadata for a web-chat conversation. */
+export interface ConversationMeta {
+    id: string;
+    title: string;
+    roomId: UUID;
+    metadata?: import("./server-types.ts").ConversationMetadata;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AgentStartupDiagnostics {
+    phase: string;
+    attempt: number;
+    lastError?: string;
+    lastErrorAt?: number;
+    nextRetryAt?: number;
+}
+export declare function hasPersistedOnboardingState(config: ElizaConfig): boolean;
+/** Resolve the app owner's display name from config, or fall back to "User". */
+export declare function resolveAppUserName(config: ElizaConfig): string;
+export declare function patchTouchesProviderSelection(patch: Record<string, unknown>): boolean;
+export declare function resolveConversationGreetingText(runtime: AgentRuntime, lang: string, uiConfig?: ElizaConfig["ui"]): string;
+export declare function findOwnPackageRoot(startDir: string): string;
+export declare function getErrorMessage(err: unknown, fallback?: string): string;
+export declare function decodePathComponent(raw: string, res: http.ServerResponse, fieldName: string): string | null;
+export declare function hasBlockedObjectKeyDeep(value: unknown): boolean;
+export declare function cloneWithoutBlockedObjectKeys<T>(value: T): T;
+export { maybeAugmentChatMessageWithLanguage } from "./chat-augmentation.ts";
+interface ChatImageAttachment {
+    /** Base64-encoded image data (no data URL prefix). */
+    data: string;
+    mimeType: string;
+    name: string;
+}
+export declare const IMAGE_ONLY_CHAT_FALLBACK_PROMPT = "Please describe the attached image.";
+/** Returns an error message string, or null if valid. Exported for unit tests. */
+export declare function validateChatImages(images: unknown): string | null;
+export declare function normalizeIncomingChatPrompt(text: string | null | undefined, images: ChatImageAttachment[] | null | undefined): string | null;
+export declare function buildChatAttachments(images: ChatImageAttachment[] | undefined): {
+    attachments: ChatAttachmentWithData[] | undefined;
+    compactAttachments: Media[] | undefined;
+};
+type MessageMemory = ReturnType<typeof createMessageMemory>;
+/**
+ * Constructs the in-memory user message (with image data for action handlers)
+ * and the persistence-safe counterpart (image data stripped).
+ */
+export declare function buildUserMessages(params: {
+    images: ChatImageAttachment[] | undefined;
+    prompt: string;
+    userId: UUID;
+    agentId: UUID;
+    roomId: UUID;
+    channelType: ChannelType;
+    conversationMode?: "simple" | "power";
+    messageSource?: string;
+    metadata?: Record<string, unknown>;
+}): {
+    userMessage: MessageMemory;
+    messageToStore: MessageMemory;
+};
+type ConversationRoomTitleRef = Pick<ConversationMeta, "id" | "title" | "roomId">;
+export declare function persistConversationRoomTitle(runtime: Pick<AgentRuntime, "getRoom" | "adapter"> | null | undefined, conversation: ConversationRoomTitleRef): Promise<boolean>;
+export declare function maybeAugmentChatMessageWithWalletContext(runtime: AgentRuntime, message: ReturnType<typeof createMessageMemory>): ReturnType<typeof createMessageMemory>;
+export declare function maybeAugmentChatMessageWithDocuments(runtime: AgentRuntime, message: ReturnType<typeof createMessageMemory>): Promise<ReturnType<typeof createMessageMemory>>;
+export declare const WALLET_EXECUTION_INTENT_RE: RegExp;
+export declare const WALLET_PROGRESS_ONLY_RE: RegExp;
+export declare function isWalletActionRequiredIntent(prompt: string): boolean;
+export declare function buildWalletActionNotExecutedReply(runtime: AgentRuntime, userPrompt: string): string;
+export declare function trimWalletProgressPrefix(text: string): string;
+export declare function resolveWalletModeGuidanceReply(state: Pick<ServerState, "config" | "runtime">, prompt: string): string | null;
+//# sourceMappingURL=server-helpers.d.ts.map

package/packages/agent/src/api/server-helpers.d.ts.map

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