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

package/packages/agent/src/actions/emote.js

@@ -1,91 +0,0 @@
-/**
- * PLAY_EMOTE action — plays an emote animation on the avatar.
- *
- * When triggered the action:
- *   1. Extracts the emote ID from required structured parameters
- *   2. Looks up the emote in the catalog
- *   3. POSTs to the local API server to trigger the animation
- *   4. Returns success without posting chat text
- *
- * @module actions/emote
- */
-import { AGENT_EMOTE_BY_ID, AGENT_EMOTE_CATALOG } from "../emotes/catalog";
-/** API port for posting emote requests. */
-const API_PORT = process.env.API_PORT || process.env.SERVER_PORT || "2138";
-export const emoteAction = {
-    name: "PLAY_EMOTE",
-    similes: [
-        "EMOTE",
-        "ANIMATE",
-        "GESTURE",
-        "DANCE",
-        "WAVE",
-        "PLAY_ANIMATION",
-        "DO_EMOTE",
-        "PERFORM",
-    ],
-    description: "Play a one-shot emote animation on your 3D VRM avatar, then return to idle. " +
-        "Use whenever a visible gesture, reaction, or trick helps convey emotion. " +
-        "This is a silent non-blocking visual side action that does not create " +
-        "chat text on its own. Only call it when you set the required emote " +
-        "parameter to a valid emote ID. If you also want speech, chain it " +
-        "before, after, or alongside other actions in the same turn " +
-        "(for example with REPLY, SEND_MESSAGE, or stream actions).",
-    validate: async (_runtime, _message, _state) => {
-        // Always valid — the handler will check if the emote exists.
-        return true;
-    },
-    handler: async (_runtime, _message, _state, options) => {
-        try {
-            const params = options?.parameters;
-            const emoteId = typeof params?.emote === "string" ? params.emote.trim() : "";
-            if (!emoteId) {
-                return { text: "", success: false };
-            }
-            // Look up the emote in the catalog.
-            const emote = AGENT_EMOTE_BY_ID.get(emoteId);
-            if (!emote) {
-                return {
-                    text: "",
-                    success: false,
-                };
-            }
-            // POST to the local API server to trigger the emote.
-            const response = await fetch(`http://localhost:${API_PORT}/api/emote`, {
-                method: "POST",
-                headers: { "Content-Type": "application/json" },
-                body: JSON.stringify({ emoteId: emote.id }),
-            });
-            if (!response.ok) {
-                return {
-                    text: "",
-                    success: false,
-                };
-            }
-            return {
-                text: "",
-                success: true,
-                data: { emoteId: emote.id },
-            };
-        }
-        catch {
-            return {
-                text: "",
-                success: false,
-            };
-        }
-    },
-    parameters: [
-        {
-            name: "emote",
-            description: "Required emote ID to play once silently before returning to idle. " +
-                "Common mappings: dance/vibe → dance-happy, wave/greet → wave, " +
-                "flip/backflip → flip, cry/sad → crying, fight/punch → punching, fish → fishing",
-            required: true,
-            schema: {
-                type: "string",
-                enum: AGENT_EMOTE_CATALOG.map((e) => e.id),
-            },
-        },
-    ],
-};

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

@@ -1,19 +0,0 @@
-/**
- * RESTART_AGENT action — gracefully restarts the agent.
- *
- * When triggered the action:
- *   1. Persists a "Restarting…" memory so the event is visible in logs
- *   2. Returns a brief restart notice to the caller
- *   3. After a short delay (so the response can flush), invokes
- *      {@link requestRestart} which delegates to the registered
- *      {@link RestartHandler}.
- *
- * In CLI mode the default handler exits with code 75 so the runner script
- * rebuilds and relaunches. In headless / desktop mode a custom handler
- * performs an in-process restart (stop → re-init → hot-swap references).
- *
- * @module actions/restart
- */
-import type { Action } from "@elizaos/core";
-export declare const restartAction: Action;
-//# sourceMappingURL=restart.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"restart.d.ts","sourceRoot":"","sources":["../../../../../src/actions/restart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAgC,MAAM,eAAe,CAAC;AAO1E,eAAO,MAAM,aAAa,EAAE,MA2E3B,CAAC"}

package/packages/agent/src/actions/restart.js

@@ -1,86 +0,0 @@
-/**
- * RESTART_AGENT action — gracefully restarts the agent.
- *
- * When triggered the action:
- *   1. Persists a "Restarting…" memory so the event is visible in logs
- *   2. Returns a brief restart notice to the caller
- *   3. After a short delay (so the response can flush), invokes
- *      {@link requestRestart} which delegates to the registered
- *      {@link RestartHandler}.
- *
- * In CLI mode the default handler exits with code 75 so the runner script
- * rebuilds and relaunches. In headless / desktop mode a custom handler
- * performs an in-process restart (stop → re-init → hot-swap references).
- *
- * @module actions/restart
- */
-import crypto from "node:crypto";
-import { logger } from "@elizaos/core";
-import { requestRestart } from "../runtime/restart";
-/** Small delay (ms) before restarting so the response has time to flush. */
-const SHUTDOWN_DELAY_MS = 1_500;
-export const restartAction = {
-    name: "RESTART_AGENT",
-    similes: [
-        "RESTART",
-        "REBOOT",
-        "RELOAD",
-        "REFRESH",
-        "RESPAWN",
-        "RESTART_SELF",
-        "REBOOT_AGENT",
-        "RELOAD_AGENT",
-    ],
-    description: "Restart the agent process. This stops the runtime, rebuilds if source " +
-        "files changed, and relaunches — picking up new code, config, or plugins.",
-    validate: async (_runtime, _message, _state) => {
-        // Always valid — the registered handler decides how (or whether) to restart.
-        return true;
-    },
-    handler: async (runtime, message, _state, options) => {
-        // This action declares parameters, so the runtime provides HandlerOptions.
-        const params = options?.parameters;
-        const reason = typeof params?.reason === "string" ? params.reason : undefined;
-        const restartText = reason ? `Restarting… (${reason})` : "Restarting…";
-        logger.info(`[eliza] ${restartText}`);
-        // Persist a "Restarting…" memory so it shows up in the message log.
-        try {
-            const restartMemory = {
-                id: crypto.randomUUID(),
-                entityId: runtime.agentId,
-                roomId: message.roomId,
-                worldId: message.worldId,
-                content: {
-                    text: restartText,
-                    source: "eliza",
-                    type: "system",
-                },
-            };
-            await runtime.createMemory(restartMemory, "messages");
-        }
-        catch (err) {
-            // Non-fatal — the restart still proceeds even if the memory write fails.
-            const msg = err instanceof Error ? err.message : String(err);
-            logger.warn(`[eliza] Could not persist restart memory: ${msg}`);
-        }
-        // Schedule the restart slightly after returning so the response can be
-        // delivered to the user / channel before the process bounces.
-        setTimeout(() => {
-            requestRestart(reason);
-        }, SHUTDOWN_DELAY_MS);
-        return {
-            text: restartText,
-            success: true,
-            values: { restarting: true },
-            data: { reason },
-        };
-    },
-    parameters: [
-        {
-            name: "reason",
-            description: "Optional reason for the restart (logged for diagnostics).",
-            required: false,
-            schema: { type: "string" },
-        },
-    ],
-};

package/packages/agent/src/actions/send-message.d.ts

@@ -1,3 +0,0 @@
-import type { Action } from "@elizaos/core";
-export declare const sendMessageAction: Action;
-//# sourceMappingURL=send-message.d.ts.map

package/packages/agent/src/actions/send-message.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"send-message.d.ts","sourceRoot":"","sources":["../../../../../src/actions/send-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAA2B,MAAM,eAAe,CAAC;AAUrE,eAAO,MAAM,iBAAiB,EAAE,MAqK/B,CAAC"}

package/packages/agent/src/actions/send-message.js

@@ -1,144 +0,0 @@
-export const sendMessageAction = {
-    name: "SEND_MESSAGE",
-    similes: ["DM", "MESSAGE", "SEND_DM", "POST_MESSAGE"],
-    description: "Send a message to a user or room on a specific platform/service using explicit parameters.",
-    validate: async () => true,
-    handler: async (runtime, _message, _state, options) => {
-        const params = options?.parameters;
-        const targetType = params?.targetType === "user" || params?.targetType === "room"
-            ? params.targetType
-            : null;
-        const source = typeof params?.source === "string" ? params.source.trim() : "";
-        const target = typeof params?.target === "string" ? params.target.trim() : "";
-        const text = typeof params?.text === "string" ? params.text.trim() : "";
-        if (!targetType || !source || !target || !text) {
-            return {
-                text: "SEND_MESSAGE requires targetType, source, target, and text parameters.",
-                success: false,
-                values: {
-                    success: false,
-                    error: "INVALID_PARAMETERS",
-                },
-                data: {
-                    actionName: "SEND_MESSAGE",
-                    targetType,
-                    source: source || null,
-                    target: target || null,
-                },
-            };
-        }
-        const service = runtime.getService(source);
-        if (!service) {
-            return {
-                text: `Message service '${source}' is not available.`,
-                success: false,
-                values: {
-                    success: false,
-                    error: "SERVICE_NOT_FOUND",
-                },
-                data: {
-                    actionName: "SEND_MESSAGE",
-                    targetType,
-                    source,
-                    target,
-                },
-            };
-        }
-        if (targetType === "user") {
-            if (!service.sendDirectMessage) {
-                return {
-                    text: `Direct messaging is not supported by '${source}'.`,
-                    success: false,
-                    values: {
-                        success: false,
-                        error: "DIRECT_MESSAGE_UNSUPPORTED",
-                    },
-                    data: {
-                        actionName: "SEND_MESSAGE",
-                        targetType,
-                        source,
-                        target,
-                    },
-                };
-            }
-            await service.sendDirectMessage(target, { text, source });
-            return {
-                text: `Message sent to user ${target} on ${source}.`,
-                success: true,
-                values: {
-                    success: true,
-                    targetType,
-                    source,
-                    target,
-                },
-                data: {
-                    actionName: "SEND_MESSAGE",
-                    targetType,
-                    source,
-                    target,
-                    text,
-                },
-            };
-        }
-        if (!service.sendRoomMessage) {
-            return {
-                text: `Room messaging is not supported by '${source}'.`,
-                success: false,
-                values: {
-                    success: false,
-                    error: "ROOM_MESSAGE_UNSUPPORTED",
-                },
-                data: {
-                    actionName: "SEND_MESSAGE",
-                    targetType,
-                    source,
-                    target,
-                },
-            };
-        }
-        await service.sendRoomMessage(target, { text, source });
-        return {
-            text: `Message sent to room ${target} on ${source}.`,
-            success: true,
-            values: {
-                success: true,
-                targetType,
-                source,
-                target,
-            },
-            data: {
-                actionName: "SEND_MESSAGE",
-                targetType,
-                source,
-                target,
-                text,
-            },
-        };
-    },
-    parameters: [
-        {
-            name: "targetType",
-            description: "Target entity type: user or room.",
-            required: true,
-            schema: { type: "string", enum: ["user", "room"] },
-        },
-        {
-            name: "source",
-            description: "Messaging source/service name (e.g. telegram, discord).",
-            required: true,
-            schema: { type: "string" },
-        },
-        {
-            name: "target",
-            description: "Target identifier. For users: entity ID/username. For rooms: room ID/name.",
-            required: true,
-            schema: { type: "string" },
-        },
-        {
-            name: "text",
-            description: "Message text to send.",
-            required: true,
-            schema: { type: "string" },
-        },
-    ],
-};

package/packages/agent/src/actions/switch-stream-source.d.ts

@@ -1,16 +0,0 @@
-/**
- * SWITCH_STREAM_SOURCE action — changes the content being captured and streamed.
- *
- * When triggered the action:
- *   1. Validates the requested sourceType against the allowed set
- *   2. Requires customUrl when sourceType is "custom-url"
- *   3. POSTs to the local API to apply the new stream source
- *
- * All stream-switching logic is handled server-side — this action is a
- * thin wrapper that validates inputs and forwards the request.
- *
- * @module actions/switch-stream-source
- */
-import type { Action } from "@elizaos/core";
-export declare const switchStreamSourceAction: Action;
-//# sourceMappingURL=switch-stream-source.d.ts.map

package/packages/agent/src/actions/switch-stream-source.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"switch-stream-source.d.ts","sourceRoot":"","sources":["../../../../../src/actions/switch-stream-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,eAAe,CAAC;AAQ5D,eAAO,MAAM,wBAAwB,EAAE,MA6GtC,CAAC"}

package/packages/agent/src/actions/switch-stream-source.js

@@ -1,94 +0,0 @@
-/**
- * SWITCH_STREAM_SOURCE action — changes the content being captured and streamed.
- *
- * When triggered the action:
- *   1. Validates the requested sourceType against the allowed set
- *   2. Requires customUrl when sourceType is "custom-url"
- *   3. POSTs to the local API to apply the new stream source
- *
- * All stream-switching logic is handled server-side — this action is a
- * thin wrapper that validates inputs and forwards the request.
- *
- * @module actions/switch-stream-source
- */
-/** API port for the stream source endpoint. */
-const API_PORT = process.env.API_PORT || process.env.SERVER_PORT || "2138";
-const VALID_SOURCE_TYPES = ["stream-tab", "game", "custom-url"];
-export const switchStreamSourceAction = {
-    name: "SWITCH_STREAM_SOURCE",
-    similes: ["CHANGE_STREAM", "STREAM_GAME", "STREAM_URL", "SET_STREAM_SOURCE"],
-    description: "Switches what content is being captured and streamed. " +
-        'Use "stream-tab" to capture the stream browser tab, "game" to capture a game window, ' +
-        'or "custom-url" to stream from a specific URL.',
-    validate: async () => true,
-    handler: async (_runtime, _message, _state, options) => {
-        try {
-            const params = options?.parameters;
-            // ── Extract parameters ───────────────────────────────────────────
-            const rawSourceType = typeof params?.sourceType === "string"
-                ? params.sourceType.trim()
-                : "stream-tab";
-            const sourceType = VALID_SOURCE_TYPES.includes(rawSourceType)
-                ? rawSourceType
-                : "stream-tab";
-            if (!VALID_SOURCE_TYPES.includes(rawSourceType) &&
-                rawSourceType !== "") {
-                return {
-                    text: `Invalid sourceType "${rawSourceType}". Must be one of: ${VALID_SOURCE_TYPES.join(", ")}.`,
-                    success: false,
-                };
-            }
-            const customUrl = typeof params?.customUrl === "string"
-                ? params.customUrl.trim()
-                : undefined;
-            // ── Validate custom-url requirement ─────────────────────────────
-            if (sourceType === "custom-url" && !customUrl) {
-                return {
-                    text: 'customUrl is required when sourceType is "custom-url".',
-                    success: false,
-                };
-            }
-            // ── POST to stream source API ───────────────────────────────────
-            const response = await fetch(`http://127.0.0.1:${API_PORT}/api/stream/source`, {
-                method: "POST",
-                headers: { "Content-Type": "application/json" },
-                body: JSON.stringify({ sourceType, customUrl }),
-                signal: AbortSignal.timeout(10_000),
-            });
-            if (!response.ok) {
-                return {
-                    text: `Failed to switch stream source (HTTP ${response.status}).`,
-                    success: false,
-                };
-            }
-            // ── Format and return ────────────────────────────────────────────
-            const label = sourceType === "custom-url"
-                ? `${sourceType} (${customUrl})`
-                : sourceType;
-            return {
-                text: `Switched stream source to ${label}.`,
-                success: true,
-            };
-        }
-        catch (err) {
-            return {
-                text: `Failed to switch stream source: ${err instanceof Error ? err.message : String(err)}`,
-                success: false,
-            };
-        }
-    },
-    parameters: [
-        {
-            name: "sourceType",
-            description: 'The stream source type to switch to: "stream-tab", "game", or "custom-url".',
-            required: true,
-            schema: { type: "string" },
-        },
-        {
-            name: "customUrl",
-            description: 'The URL to stream from. Required when sourceType is "custom-url".',
-            required: false,
-            schema: { type: "string" },
-        },
-    ],
-};

package/packages/agent/src/api/bsc-trade.d.ts

@@ -1,34 +0,0 @@
-/**
- * BSC trade preflight + quote helpers.
- *
- * Safety-first scope:
- * - No execution/signing here.
- * - Validate wallet/rpc/chain/gas/token before producing a quote.
- */
-import type { BscTradePreflightResponse, BscTradeQuoteRequest, BscTradeQuoteResponse, BscUnsignedApprovalTx, BscUnsignedTradeTx } from "../contracts/wallet.js";
-export declare const PANCAKE_SWAP_V2_ROUTER: string;
-export declare const BSC_WBNB_FALLBACK: string;
-export interface BscTradeRpcConfig {
-    rpcUrls?: string[] | null;
-    nodeRealBscRpcUrl?: string | null;
-    quickNodeBscRpcUrl?: string | null;
-    bscRpcUrl?: string | null;
-    cloudManagedAccess?: boolean | null;
-}
-export interface BuildBscTradePreflightInput extends BscTradeRpcConfig {
-    walletAddress: string | null;
-    tokenAddress?: string | null;
-}
-export interface BuildBscTradeQuoteInput extends BscTradeRpcConfig {
-    walletAddress: string | null;
-    request: BscTradeQuoteRequest;
-}
-export declare function resolveBscRpcUrls(input: BscTradeRpcConfig): string[];
-export declare function resolvePrimaryBscRpcUrl(input: BscTradeRpcConfig): string | null;
-export declare function readTokenDecimals(rpcUrls: string[], tokenAddress: string): Promise<number>;
-export declare function buildBscTradePreflight(input: BuildBscTradePreflightInput): Promise<BscTradePreflightResponse>;
-export declare function buildBscTradeQuote(input: BuildBscTradeQuoteInput): Promise<BscTradeQuoteResponse>;
-export declare function buildBscBuyUnsignedTx(quote: BscTradeQuoteResponse, recipientAddress: string | null, deadlineSeconds?: number): BscUnsignedTradeTx;
-export declare function buildBscSellUnsignedTx(quote: BscTradeQuoteResponse, recipientAddress: string | null, deadlineSeconds?: number): BscUnsignedTradeTx;
-export declare function buildBscApproveUnsignedTx(tokenAddress: string, ownerAddress: string | null, spenderAddress: string, amountWei: string): BscUnsignedApprovalTx;
-//# sourceMappingURL=bsc-trade.d.ts.map

package/packages/agent/src/api/bsc-trade.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bsc-trade.d.ts","sourceRoot":"","sources":["../../../../../src/api/bsc-trade.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EAErB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAYhC,eAAO,MAAM,sBAAsB,QAElC,CAAC;AACF,eAAO,MAAM,iBAAiB,QAE7B,CAAC;AAgBF,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,2BAA4B,SAAQ,iBAAiB;IACpE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AA6BD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,EAAE,CA0BpE;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,iBAAiB,GACvB,MAAM,GAAG,IAAI,CAef;AAuJD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAajB;AAmCD,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,yBAAyB,CAAC,CAkIpC;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,qBAAqB,CAAC,CAiIhC;AAcD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,qBAAqB,EAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,eAAe,CAAC,EAAE,MAAM,GACvB,kBAAkB,CA8BpB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,qBAAqB,EAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,eAAe,CAAC,EAAE,MAAM,GACvB,kBAAkB,CA+BpB;AAED,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,qBAAqB,CAuCvB"}