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

package/packages/agent/src/actions/check-balance.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CHECK_BALANCE action — retrieves wallet balances across chains.
+ *
+ * When triggered the action:
+ *   1. GETs wallet balances from the local API
+ *   2. Optionally filters by chain (bsc, ethereum, base, solana)
+ *   3. Formats a human-readable summary with addresses, native balances,
+ *      USD values, and top token holdings
+ *
+ * All balance fetching logic is handled server-side — this action is a
+ * thin wrapper that formats the response for the LLM.
+ *
+ * @module actions/check-balance
+ */
+import type { Action } from "@elizaos/core";
+export declare const checkBalanceAction: Action;
+//# sourceMappingURL=check-balance.d.ts.map

package/packages/agent/src/actions/check-balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-balance.d.ts","sourceRoot":"","sources":["../../../../../src/actions/check-balance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAmC,MAAM,eAAe,CAAC;AA8H7E,eAAO,MAAM,kBAAkB,EAAE,MA4FhC,CAAC"}

package/packages/agent/src/actions/check-balance.js

@@ -0,0 +1,167 @@
+/**
+ * CHECK_BALANCE action — retrieves wallet balances across chains.
+ *
+ * When triggered the action:
+ *   1. GETs wallet balances from the local API
+ *   2. Optionally filters by chain (bsc, ethereum, base, solana)
+ *   3. Formats a human-readable summary with addresses, native balances,
+ *      USD values, and top token holdings
+ *
+ * All balance fetching logic is handled server-side — this action is a
+ * thin wrapper that formats the response for the LLM.
+ *
+ * @module actions/check-balance
+ */
+import { buildAuthHeaders, getWalletActionApiPort, } from "./wallet-action-shared.js";
+/** Timeout for the balance API call. */
+const BALANCE_TIMEOUT_MS = 10_000;
+/** Maximum token holdings to display per chain. */
+const MAX_TOKENS_PER_CHAIN = 10;
+const VALID_CHAINS = ["all", "bsc", "ethereum", "base", "solana"];
+// ── Formatting helpers ──────────────────────────────────────────────────────
+function shortenAddress(address) {
+    if (address.length <= 10)
+        return address;
+    return `${address.slice(0, 6)}...${address.slice(-4)}`;
+}
+function formatUsd(value) {
+    const num = Number(value);
+    if (Number.isNaN(num))
+        return `$${value}`;
+    return `$${num.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+}
+function formatEvmChain(chain, address) {
+    const label = chain.chain.toUpperCase();
+    const short = shortenAddress(address);
+    const lines = [];
+    lines.push(`${label} (${short}):`);
+    lines.push(`  ${chain.nativeSymbol}: ${chain.nativeBalance} (${formatUsd(chain.nativeValueUsd)})`);
+    if (chain.error) {
+        lines.push(`  Error: ${chain.error}`);
+    }
+    const tokens = chain.tokens.slice(0, MAX_TOKENS_PER_CHAIN);
+    if (tokens.length > 0) {
+        lines.push("  Tokens:");
+        for (const token of tokens) {
+            lines.push(`    ${token.symbol}: ${token.balance} (${formatUsd(token.valueUsd)})`);
+        }
+        if (chain.tokens.length > MAX_TOKENS_PER_CHAIN) {
+            lines.push(`    ... and ${chain.tokens.length - MAX_TOKENS_PER_CHAIN} more`);
+        }
+    }
+    return lines.join("\n");
+}
+function formatSolana(solana) {
+    const short = shortenAddress(solana.address);
+    const lines = [];
+    lines.push(`Solana (${short}):`);
+    lines.push(`  SOL: ${solana.solBalance} (${formatUsd(solana.solValueUsd)})`);
+    const tokens = solana.tokens.slice(0, MAX_TOKENS_PER_CHAIN);
+    if (tokens.length > 0) {
+        lines.push("  Tokens:");
+        for (const token of tokens) {
+            lines.push(`    ${token.symbol}: ${token.balance} (${formatUsd(token.valueUsd)})`);
+        }
+        if (solana.tokens.length > MAX_TOKENS_PER_CHAIN) {
+            lines.push(`    ... and ${solana.tokens.length - MAX_TOKENS_PER_CHAIN} more`);
+        }
+    }
+    return lines.join("\n");
+}
+function formatBalances(data, chain) {
+    const sections = [];
+    // EVM chains
+    if (data.evm && chain !== "solana") {
+        const chains = chain === "all"
+            ? data.evm.chains
+            : data.evm.chains.filter((c) => c.chain.toLowerCase() === chain);
+        for (const evmChain of chains) {
+            sections.push(formatEvmChain(evmChain, data.evm.address));
+        }
+    }
+    // Solana
+    if (data.solana && (chain === "all" || chain === "solana")) {
+        sections.push(formatSolana(data.solana));
+    }
+    if (sections.length === 0) {
+        if (chain === "all") {
+            return "No wallet balances available.";
+        }
+        return `No balance data available for chain "${chain}".`;
+    }
+    return `Wallet Balances:\n\n${sections.join("\n\n")}`;
+}
+// ── Action ──────────────────────────────────────────────────────────────────
+export const checkBalanceAction = {
+    name: "CHECK_BALANCE",
+    similes: [
+        "GET_BALANCE",
+        "WALLET_BALANCE",
+        "CHECK_WALLET",
+        "MY_BALANCE",
+        "PORTFOLIO",
+        "HOLDINGS",
+    ],
+    description: "Check wallet balances across chains. Use this when a user asks about " +
+        "their balance, portfolio, holdings, or wallet contents.",
+    validate: async () => true,
+    handler: async (_runtime, _message, _state, options, callback) => {
+        try {
+            const params = options?.parameters;
+            // ── Extract optional chain parameter ─────────────────────────────
+            const rawChain = typeof params?.chain === "string"
+                ? params.chain.trim().toLowerCase()
+                : "all";
+            const chain = VALID_CHAINS.includes(rawChain)
+                ? rawChain
+                : "all";
+            // ── Fetch balances from API ──────────────────────────────────────
+            const response = await fetch(`http://127.0.0.1:${getWalletActionApiPort()}/api/wallet/balances`, {
+                headers: {
+                    ...buildAuthHeaders(),
+                },
+                signal: AbortSignal.timeout(BALANCE_TIMEOUT_MS),
+            });
+            if (!response.ok) {
+                const text = `Failed to fetch wallet balances (HTTP ${response.status}).`;
+                if (callback)
+                    callback({ text, action: "CHECK_BALANCE_FAILED" });
+                return {
+                    text,
+                    success: false,
+                };
+            }
+            const data = (await response.json());
+            // ── Format and return ────────────────────────────────────────────
+            const text = formatBalances(data, chain);
+            if (callback)
+                callback({ text, action: "CHECK_BALANCE_RESPONSE" });
+            return {
+                text,
+                success: true,
+                data: {
+                    chain,
+                    evm: data.evm,
+                    solana: data.solana,
+                },
+            };
+        }
+        catch (err) {
+            const text = `Failed to fetch wallet balances: ${err instanceof Error ? err.message : String(err)}`;
+            if (callback)
+                callback({ text, action: "CHECK_BALANCE_FAILED" });
+            return {
+                text,
+                success: false,
+            };
+        }
+    },
+    parameters: [
+        {
+            name: "chain",
+            description: 'Which chain to check: "all", "bsc", "ethereum", "base", or "solana". Defaults to "all".',
+            required: false,
+            schema: { type: "string" },
+        },
+    ],
+};

package/packages/agent/src/actions/connector-resolver.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Connector resolver — shared utilities for resolving contacts to platform
+ * handles via the Rolodex (relationships graph) and finding conversations
+ * with a person across all connected platforms.
+ *
+ * Used by SEND_MESSAGE, READ_MESSAGES, READ_POSTS, and SEND_POST actions.
+ *
+ * @module actions/connector-resolver
+ */
+import type { IAgentRuntime, Memory, Room, UUID } from "@elizaos/core";
+import type { RelationshipsGraphService, RelationshipsPersonSummary } from "../services/relationships-graph.js";
+/** Resolved contact with platform-specific routing information. */
+export type ResolvedContact = {
+    person: RelationshipsPersonSummary;
+    /** Best platform to reach this person (based on preference + availability). */
+    recommendedPlatform: string | null;
+    /** All platforms where both the contact exists AND we have a running connector. */
+    reachablePlatforms: string[];
+    /** Map of platform → entity ID for direct addressing. */
+    platformEntityIds: Map<string, UUID>;
+};
+/** A conversation thread with a person on a specific platform. */
+export type PersonConversation = {
+    platform: string;
+    roomId: UUID;
+    roomName: string;
+    messages: Memory[];
+    messageCount: number;
+    lastMessageAt: string | null;
+};
+/** Summary of all conversations with a person across platforms. */
+export type CrossPlatformConversationView = {
+    person: RelationshipsPersonSummary;
+    conversations: PersonConversation[];
+    totalMessages: number;
+};
+export declare function getGraphService(runtime: IAgentRuntime): RelationshipsGraphService | null;
+/** Returns the set of connector source names that have active send handlers. */
+export declare function getActiveConnectors(runtime: IAgentRuntime): Set<string>;
+/**
+ * Resolve a person name to a contact with platform routing info.
+ *
+ * Uses the Rolodex (relationships graph) for lookup — no regex, no string
+ * matching. The Rolodex handles fuzzy name/alias matching internally.
+ *
+ * @returns null if no match found, or a ResolvedContact with the best
+ *   person match and their reachable platforms.
+ */
+export declare function resolveContact(runtime: IAgentRuntime, name: string, preferredPlatform?: string): Promise<ResolvedContact | null>;
+/**
+ * Resolve a person name and return ALL matching contacts (for disambiguation).
+ */
+export declare function resolveContactCandidates(runtime: IAgentRuntime, name: string, limit?: number): Promise<RelationshipsPersonSummary[]>;
+/**
+ * Get all conversations with a specific person across all platforms.
+ *
+ * This is the "conversation handoff" view — shows recent messages from
+ * every platform where the agent has interacted with this person, so
+ * the user can see full context before deciding where to respond.
+ */
+export declare function getPersonConversations(runtime: IAgentRuntime, person: RelationshipsPersonSummary, opts?: {
+    limitPerPlatform?: number;
+}): Promise<CrossPlatformConversationView>;
+/** Format a cross-platform conversation view as human-readable text. */
+export declare function formatConversationView(runtime: IAgentRuntime, view: CrossPlatformConversationView): string;
+/**
+ * Format a list of resolved contacts for disambiguation display.
+ */
+export declare function formatContactCandidates(candidates: RelationshipsPersonSummary[]): string;
+/**
+ * Find the room ID for a DM/conversation between the agent and an entity
+ * on a specific platform.
+ */
+export declare function findRoomForEntity(runtime: IAgentRuntime, entityId: UUID, platform: string): Promise<Room | null>;
+//# sourceMappingURL=connector-resolver.d.ts.map

package/packages/agent/src/actions/connector-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-resolver.d.ts","sourceRoot":"","sources":["../../../../../src/actions/connector-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAGvE,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,oCAAoC,CAAC;AAM5C,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,0BAA0B,CAAC;IACnC,+EAA+E;IAC/E,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,mFAAmF;IACnF,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,yDAAyD;IACzD,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CACtC,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,IAAI,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,mEAAmE;AACnE,MAAM,MAAM,6BAA6B,GAAG;IAC1C,MAAM,EAAE,0BAA0B,CAAC;IACnC,aAAa,EAAE,kBAAkB,EAAE,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAMF,wBAAgB,eAAe,CAC7B,OAAO,EAAE,aAAa,GACrB,yBAAyB,GAAG,IAAI,CAIlC;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,CAYvE;AAMD;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,MAAM,EACZ,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAwDjC;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,MAAM,EACZ,KAAK,SAAI,GACR,OAAO,CAAC,0BAA0B,EAAE,CAAC,CAUvC;AAMD;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,0BAA0B,EAClC,IAAI,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC,OAAO,CAAC,6BAA6B,CAAC,CA2ExC;AAMD,wEAAwE;AACxE,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,6BAA6B,GAClC,MAAM,CAkCR;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,0BAA0B,EAAE,GACvC,MAAM,CAYR;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,IAAI,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAkBtB"}

package/packages/agent/src/actions/connector-resolver.js

@@ -0,0 +1,245 @@
+/**
+ * Connector resolver — shared utilities for resolving contacts to platform
+ * handles via the Rolodex (relationships graph) and finding conversations
+ * with a person across all connected platforms.
+ *
+ * Used by SEND_MESSAGE, READ_MESSAGES, READ_POSTS, and SEND_POST actions.
+ *
+ * @module actions/connector-resolver
+ */
+import { logger } from "@elizaos/core";
+import { formatSpeakerLabel } from "../providers/conversation-utils.js";
+// ---------------------------------------------------------------------------
+// Service access
+// ---------------------------------------------------------------------------
+export function getGraphService(runtime) {
+    return runtime.getService("RELATIONSHIPS_GRAPH");
+}
+/** Returns the set of connector source names that have active send handlers. */
+export function getActiveConnectors(runtime) {
+    const active = new Set();
+    // sendHandlers is a Map<string, SendHandlerFunction> on the runtime
+    const rt = runtime;
+    if (rt.sendHandlers) {
+        for (const key of rt.sendHandlers.keys()) {
+            active.add(key);
+        }
+    }
+    return active;
+}
+// ---------------------------------------------------------------------------
+// Contact resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a person name to a contact with platform routing info.
+ *
+ * Uses the Rolodex (relationships graph) for lookup — no regex, no string
+ * matching. The Rolodex handles fuzzy name/alias matching internally.
+ *
+ * @returns null if no match found, or a ResolvedContact with the best
+ *   person match and their reachable platforms.
+ */
+export async function resolveContact(runtime, name, preferredPlatform) {
+    const graphService = getGraphService(runtime);
+    if (!graphService) {
+        logger.warn("[connector-resolver] Relationships service not available");
+        return null;
+    }
+    const snapshot = await graphService.getGraphSnapshot({
+        search: name.trim(),
+        limit: 5,
+    });
+    if (!snapshot || snapshot.people.length === 0) {
+        return null;
+    }
+    // Take the best match (first result — the graph service ranks by relevance)
+    const person = snapshot.people[0];
+    const activeConnectors = getActiveConnectors(runtime);
+    // Build a map of platform → entity ID for each reachable identity
+    const platformEntityIds = new Map();
+    for (const identity of person.identities) {
+        for (const handle of identity.handles) {
+            if (activeConnectors.has(handle.platform)) {
+                // Use the identity's entity ID for routing
+                if (!platformEntityIds.has(handle.platform)) {
+                    platformEntityIds.set(handle.platform, identity.entityId);
+                }
+            }
+        }
+    }
+    const reachablePlatforms = [...platformEntityIds.keys()];
+    // Pick recommended platform
+    let recommendedPlatform = null;
+    if (preferredPlatform && reachablePlatforms.includes(preferredPlatform)) {
+        recommendedPlatform = preferredPlatform;
+    }
+    else if (person.preferredCommunicationChannel &&
+        reachablePlatforms.includes(person.preferredCommunicationChannel)) {
+        recommendedPlatform = person.preferredCommunicationChannel;
+    }
+    else if (reachablePlatforms.length > 0) {
+        // Pick the first reachable platform (the graph service orders by interaction recency)
+        recommendedPlatform = reachablePlatforms[0];
+    }
+    return {
+        person,
+        recommendedPlatform,
+        reachablePlatforms,
+        platformEntityIds,
+    };
+}
+/**
+ * Resolve a person name and return ALL matching contacts (for disambiguation).
+ */
+export async function resolveContactCandidates(runtime, name, limit = 5) {
+    const graphService = getGraphService(runtime);
+    if (!graphService)
+        return [];
+    const snapshot = await graphService.getGraphSnapshot({
+        search: name.trim(),
+        limit,
+    });
+    return snapshot?.people ?? [];
+}
+// ---------------------------------------------------------------------------
+// Cross-platform conversation view
+// ---------------------------------------------------------------------------
+/**
+ * Get all conversations with a specific person across all platforms.
+ *
+ * This is the "conversation handoff" view — shows recent messages from
+ * every platform where the agent has interacted with this person, so
+ * the user can see full context before deciding where to respond.
+ */
+export async function getPersonConversations(runtime, person, opts) {
+    const limitPerPlatform = opts?.limitPerPlatform ?? 15;
+    const conversations = [];
+    let totalMessages = 0;
+    // Collect all entity IDs for this person (across all platforms)
+    const entityIds = new Set();
+    entityIds.add(person.primaryEntityId);
+    for (const id of person.memberEntityIds) {
+        entityIds.add(id);
+    }
+    // Find all rooms where this person participates
+    const seenRooms = new Set();
+    for (const entityId of entityIds) {
+        try {
+            const roomIds = await runtime.getRoomsForParticipant(entityId);
+            for (const roomId of roomIds) {
+                if (seenRooms.has(roomId))
+                    continue;
+                seenRooms.add(roomId);
+                const room = await runtime.getRoom(roomId);
+                if (!room)
+                    continue;
+                const roomRecord = room;
+                const platform = roomRecord.source ?? room.type ?? "unknown";
+                // Get recent messages from this room
+                const rawMemories = (await runtime.getMemories({
+                    tableName: "messages",
+                    roomId: room.id,
+                    limit: limitPerPlatform,
+                    orderBy: "createdAt",
+                    orderDirection: "desc",
+                }));
+                if (rawMemories.length === 0)
+                    continue;
+                // Reverse for chronological order
+                const messages = rawMemories.reverse();
+                const lastMsg = messages[messages.length - 1];
+                const lastMessageAt = lastMsg?.createdAt
+                    ? new Date(lastMsg.createdAt).toISOString()
+                    : null;
+                conversations.push({
+                    platform,
+                    roomId: room.id,
+                    roomName: roomRecord.name ?? `Room ${room.id.slice(0, 8)}`,
+                    messages,
+                    messageCount: messages.length,
+                    lastMessageAt,
+                });
+                totalMessages += messages.length;
+            }
+        }
+        catch (err) {
+            logger.debug(`[connector-resolver] Error fetching rooms for entity ${entityId}:`, err instanceof Error ? err.message : String(err));
+        }
+    }
+    // Sort conversations by most recent activity first
+    conversations.sort((a, b) => {
+        if (!a.lastMessageAt && !b.lastMessageAt)
+            return 0;
+        if (!a.lastMessageAt)
+            return 1;
+        if (!b.lastMessageAt)
+            return -1;
+        return b.lastMessageAt.localeCompare(a.lastMessageAt);
+    });
+    return { person, conversations, totalMessages };
+}
+// ---------------------------------------------------------------------------
+// Formatting helpers
+// ---------------------------------------------------------------------------
+/** Format a cross-platform conversation view as human-readable text. */
+export function formatConversationView(runtime, view) {
+    const sections = [];
+    sections.push(`Conversations with ${view.person.displayName} — ` +
+        `${view.conversations.length} thread(s), ` +
+        `${view.totalMessages} messages across ` +
+        `${[...new Set(view.conversations.map((c) => c.platform))].join(", ")}`);
+    sections.push("═".repeat(60));
+    for (const convo of view.conversations) {
+        sections.push(`\n▸ [${convo.platform}] ${convo.roomName}` +
+            (convo.lastMessageAt
+                ? ` — last activity: ${convo.lastMessageAt.slice(0, 19)}`
+                : ""));
+        sections.push("─".repeat(40));
+        for (let i = 0; i < convo.messages.length; i++) {
+            const mem = convo.messages[i];
+            const speaker = formatSpeakerLabel(runtime, mem);
+            const ts = mem.createdAt
+                ? new Date(mem.createdAt).toISOString().slice(0, 19)
+                : "";
+            const text = (mem.content?.text ?? "").slice(0, 500);
+            sections.push(`${String(i + 1).padStart(3, " ")} | ${ts} ${speaker}: ${text}`);
+        }
+    }
+    return sections.join("\n");
+}
+/**
+ * Format a list of resolved contacts for disambiguation display.
+ */
+export function formatContactCandidates(candidates) {
+    const lines = [];
+    for (let i = 0; i < candidates.length; i++) {
+        const p = candidates[i];
+        const platforms = p.platforms.join(", ") || "no platforms";
+        const aliases = p.aliases.length > 0 ? ` (aka ${p.aliases.slice(0, 2).join(", ")})` : "";
+        lines.push(`${i + 1}. ${p.displayName}${aliases} — ${platforms} — entityId: ${p.primaryEntityId}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Find the room ID for a DM/conversation between the agent and an entity
+ * on a specific platform.
+ */
+export async function findRoomForEntity(runtime, entityId, platform) {
+    try {
+        const roomIds = await runtime.getRoomsForParticipant(entityId);
+        for (const roomId of roomIds) {
+            const room = await runtime.getRoom(roomId);
+            if (!room)
+                continue;
+            const roomRecord = room;
+            if ((roomRecord.source ?? room.type ?? "").toLowerCase() ===
+                platform.toLowerCase()) {
+                return room;
+            }
+        }
+    }
+    catch {
+        // Entity may not be in any rooms yet
+    }
+    return null;
+}

package/packages/agent/src/actions/context-signal-lexicon.d.ts

@@ -1,5 +1,5 @@
 import type { CharacterLanguage } from "@elizaos/shared/contracts/onboarding";
-export type ContextSignalKey = "affirmative" | "calendar" | "draft_edit" | "gmail" | "lifeops" | "lifeops_cadence" | "lifeops_complete" | "lifeops_delete" | "lifeops_escalation" | "lifeops_goal" | "lifeops_overview" | "lifeops_phone" | "lifeops_reminder_pref" | "lifeops_review" | "lifeops_skip" | "lifeops_snooze" | "lifeops_update" | "negative" | "read_channel" | "search_conversations" | "search_entity" | "send_admin_message" | "send_message" | "stream_control" | "temporal_followup" | "temporal_next" | "web_search";
+export type ContextSignalKey = "affirmative" | "calendar" | "draft_edit" | "gmail" | "lifeops" | "lifeops_cadence" | "lifeops_complete" | "lifeops_delete" | "lifeops_escalation" | "lifeops_goal" | "lifeops_overview" | "lifeops_phone" | "lifeops_reminder_pref" | "lifeops_review" | "lifeops_skip" | "lifeops_snooze" | "lifeops_update" | "negative" | "read_channel" | "read_messages" | "search_conversations" | "search_entity" | "send_admin_message" | "send_message" | "stream_control" | "temporal_followup" | "temporal_next" | "web_search";
 export type ContextSignalStrength = "strong" | "weak";
 export type ResolvedContextSignalSpec = {
     locale: CharacterLanguage;

package/packages/agent/src/actions/context-signal-lexicon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-signal-lexicon.d.ts","sourceRoot":"","sources":["../../../../../src/actions/context-signal-lexicon.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAI9E,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,UAAU,GACV,YAAY,GACZ,OAAO,GACP,SAAS,GACT,iBAAiB,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,oBAAoB,GACpB,cAAc,GACd,kBAAkB,GAClB,eAAe,GACf,uBAAuB,GACvB,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAChB,gBAAgB,GAChB,UAAU,GACV,cAAc,GACd,sBAAsB,GACtB,eAAe,GACf,oBAAoB,GACpB,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GACnB,eAAe,GACf,YAAY,CAAC;AAEjB,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAUtD,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AA6KF,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,gBAAgB,EACrB,WAAW,CAAC,EAAE,OAAO,EACrB,OAAO,CAAC,EAAE;IACR,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GACA,yBAAyB,CAmB3B;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,CAAC,EAAE;IACR,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACA,MAAM,EAAE,CAYV"}
+{"version":3,"file":"context-signal-lexicon.d.ts","sourceRoot":"","sources":["../../../../../src/actions/context-signal-lexicon.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAI9E,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,UAAU,GACV,YAAY,GACZ,OAAO,GACP,SAAS,GACT,iBAAiB,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,oBAAoB,GACpB,cAAc,GACd,kBAAkB,GAClB,eAAe,GACf,uBAAuB,GACvB,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAChB,gBAAgB,GAChB,UAAU,GACV,cAAc,GACd,eAAe,GACf,sBAAsB,GACtB,eAAe,GACf,oBAAoB,GACpB,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GACnB,eAAe,GACf,YAAY,CAAC;AAEjB,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAUtD,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAmLF,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,gBAAgB,EACrB,WAAW,CAAC,EAAE,OAAO,EACrB,OAAO,CAAC,EAAE;IACR,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GACA,yBAAyB,CAmB3B;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,CAAC,EAAE;IACR,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACA,MAAM,EAAE,CAYV"}

package/packages/agent/src/actions/context-signal-lexicon.js

@@ -156,6 +156,12 @@ const CONTEXT_SIGNAL_SPECS = {
             weak: "contextSignal.read_channel.weak",
         },
     },
+    read_messages: {
+        keywordKeys: {
+            strong: "contextSignal.read_messages.strong",
+            weak: "contextSignal.read_messages.weak",
+        },
+    },
     stream_control: {
         keywordKeys: {
             strong: "contextSignal.stream_control.strong",

package/packages/agent/src/actions/eject-plugin.d.ts

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

package/packages/agent/src/actions/eject-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eject-plugin.d.ts","sourceRoot":"","sources":["../../../../../src/actions/eject-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiC,MAAM,eAAe,CAAC;AAc3E,eAAO,MAAM,iBAAiB,EAAE,MAwD/B,CAAC"}

package/packages/agent/src/actions/eject-plugin.js

@@ -0,0 +1,48 @@
+import { requestRestart } from "@elizaos/shared/restart";
+function getPluginManager(runtime) {
+    return runtime.getService("plugin_manager");
+}
+export const ejectPluginAction = {
+    name: "EJECT_PLUGIN",
+    similes: ["EJECT", "FORK_PLUGIN", "CLONE_PLUGIN", "EDIT_PLUGIN_SOURCE"],
+    description: "Clone a plugin's source code locally so edits override the npm version " +
+        "at runtime. Use this before modifying upstream plugin code.",
+    validate: async () => true,
+    handler: async (runtime, _message, _state, options) => {
+        const params = options?.parameters;
+        const pluginId = typeof params?.pluginId === "string" ? params.pluginId.trim() : "";
+        if (!pluginId) {
+            return { text: "I need a plugin ID to eject.", success: false };
+        }
+        const mgr = getPluginManager(runtime);
+        if (!mgr) {
+            return {
+                text: "Plugin manager service is not available.",
+                success: false,
+            };
+        }
+        const result = await mgr.ejectPlugin(pluginId);
+        if (!result.success) {
+            return {
+                text: `Failed to eject ${pluginId}: ${result.error ?? "unknown error"}`,
+                success: false,
+            };
+        }
+        setTimeout(() => {
+            requestRestart(`Plugin ${result.pluginName} ejected`);
+        }, 1_000);
+        return {
+            text: `Ejected ${result.pluginName} to ${result.ejectedPath}. Restarting to load local source.`,
+            success: true,
+            data: { ...result },
+        };
+    },
+    parameters: [
+        {
+            name: "pluginId",
+            description: "Plugin ID or npm package to eject (e.g. 'discord' or '@elizaos/plugin-discord')",
+            required: true,
+            schema: { type: "string" },
+        },
+    ],
+};

package/packages/agent/src/actions/execute-trade.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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 type { Action } from "@elizaos/core";
+export declare const executeTradeAction: Action;
+//# sourceMappingURL=execute-trade.d.ts.map

package/packages/agent/src/actions/execute-trade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-trade.d.ts","sourceRoot":"","sources":["../../../../../src/actions/execute-trade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,MAAM,EAIP,MAAM,eAAe,CAAC;AAgFvB,eAAO,MAAM,kBAAkB,EAAE,MA+ShC,CAAC"}