@elizaos/agent 0.25.9 → 2.0.0-alpha.151

package/packages/agent/src/actions/app-control.js

@@ -0,0 +1,212 @@
+/**
+ * LAUNCH_APP / STOP_APP actions — let the agent launch and stop overlay apps.
+ *
+ * When LAUNCH_APP is triggered:
+ *   1. Calls POST /api/apps/launch with the app name
+ *   2. Returns a link to the app view
+ *
+ * When STOP_APP is triggered:
+ *   1. Calls POST /api/apps/stop with the app name
+ *   2. Returns confirmation
+ *
+ * @module actions/app-control
+ */
+import { logger } from "@elizaos/core";
+import { getValidationKeywordTerms, normalizeKeywordMatchText, textIncludesKeywordTerm, } from "@elizaos/shared/validation-keywords";
+import { resolveServerOnlyPort } from "../config/runtime-env.js";
+import { hasOwnerAccess } from "../security/access.js";
+const LAUNCH_APP_TERMS = getValidationKeywordTerms("action.appControl.launchVerb", {
+    includeAllLocales: true,
+});
+const STOP_APP_TERMS = getValidationKeywordTerms("action.appControl.stopVerb", {
+    includeAllLocales: true,
+});
+const GENERIC_APP_TARGET_TERMS = getValidationKeywordTerms("action.appControl.genericTarget", {
+    includeAllLocales: true,
+});
+const KNOWN_APP_TERMS = getValidationKeywordTerms("action.appControl.knownApp", {
+    includeAllLocales: true,
+});
+const ALL_APP_TARGET_TERMS = [...GENERIC_APP_TARGET_TERMS, ...KNOWN_APP_TERMS];
+function getApiBase() {
+    const port = resolveServerOnlyPort(process.env);
+    return `http://localhost:${port}`;
+}
+function escapePattern(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function containsKeywordTerm(text, terms) {
+    return terms.some((term) => textIncludesKeywordTerm(text, term));
+}
+function extractTargetAfterTerms(text, terms) {
+    const sortedTerms = [...terms].sort((left, right) => right.length - left.length);
+    for (const term of sortedTerms) {
+        const pattern = new RegExp(`${escapePattern(term).replace(/\\ /g, "\\s*")}\\s*([\\p{L}\\p{N}_-]+)`, "iu");
+        const match = text.match(pattern);
+        const candidate = match?.[1]?.trim();
+        if (!candidate) {
+            continue;
+        }
+        const normalizedCandidate = normalizeKeywordMatchText(candidate);
+        if (GENERIC_APP_TARGET_TERMS.some((target) => normalizeKeywordMatchText(target) === normalizedCandidate)) {
+            return null;
+        }
+        return candidate.toLowerCase();
+    }
+    return null;
+}
+function extractAppName(message) {
+    const text = (message?.content?.text ?? "").trim();
+    return (extractTargetAfterTerms(text, LAUNCH_APP_TERMS) ??
+        extractTargetAfterTerms(text, STOP_APP_TERMS));
+}
+function isLaunchRequest(message) {
+    const text = (message?.content?.text ?? "").trim();
+    return (containsKeywordTerm(text, LAUNCH_APP_TERMS) &&
+        containsKeywordTerm(text, ALL_APP_TARGET_TERMS));
+}
+function isStopRequest(message) {
+    const text = (message?.content?.text ?? "").trim();
+    return (containsKeywordTerm(text, STOP_APP_TERMS) &&
+        containsKeywordTerm(text, ALL_APP_TARGET_TERMS));
+}
+export const launchAppAction = {
+    name: "LAUNCH_APP",
+    similes: [
+        "OPEN_APP",
+        "START_APP",
+        "RUN_APP",
+        "SHOW_APP",
+        "LAUNCH_APPLICATION",
+    ],
+    description: "Launch an overlay app (e.g. Shopify, Vincent, Companion). " +
+        "Returns a link to open the app in the dashboard.",
+    validate: async (runtime, message) => {
+        if (!(await hasOwnerAccess(runtime, message)))
+            return false;
+        return isLaunchRequest(message);
+    },
+    handler: async (runtime, message, _state, options) => {
+        if (!(await hasOwnerAccess(runtime, message))) {
+            return {
+                success: false,
+                text: "Permission denied: only the owner may launch apps.",
+            };
+        }
+        const params = options?.parameters;
+        const appName = params?.name?.trim() || extractAppName(message);
+        if (!appName) {
+            return {
+                success: false,
+                text: 'I need the app name to launch. Try: "launch shopify" or "open vincent"',
+            };
+        }
+        try {
+            const base = getApiBase();
+            const resp = await fetch(`${base}/api/apps/launch`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ name: appName }),
+                signal: AbortSignal.timeout(30_000),
+            });
+            const data = (await resp.json());
+            if (!resp.ok || data.success === false) {
+                const errMsg = data.message || `Failed to launch ${appName} (${resp.status})`;
+                logger.warn(`[app-control] launch failed: ${errMsg}`);
+                return { success: false, text: errMsg };
+            }
+            const displayName = data.displayName || appName;
+            const uiPort = process.env.ELIZA_PORT || "2138";
+            const appLink = `http://localhost:${uiPort}/#/apps/${appName}`;
+            logger.info(`[app-control] launched ${displayName}`);
+            return {
+                success: true,
+                text: `${displayName} is now running. Open it here: ${appLink}`,
+                values: { appName, displayName, appLink },
+                data: { run: data.run },
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.error(`[app-control] launch error: ${msg}`);
+            return { success: false, text: `Failed to launch ${appName}: ${msg}` };
+        }
+    },
+    parameters: [
+        {
+            name: "name",
+            description: "The app name or slug to launch (e.g. 'shopify', 'vincent', 'companion').",
+            required: true,
+            schema: { type: "string" },
+        },
+    ],
+};
+export const stopAppAction = {
+    name: "STOP_APP",
+    similes: [
+        "CLOSE_APP",
+        "SHUTDOWN_APP",
+        "KILL_APP",
+        "QUIT_APP",
+        "EXIT_APP",
+        "STOP_APPLICATION",
+    ],
+    description: "Stop a running overlay app by name. Uninstalls the plugin and tears " +
+        "down the viewer session.",
+    validate: async (runtime, message) => {
+        if (!(await hasOwnerAccess(runtime, message)))
+            return false;
+        return isStopRequest(message);
+    },
+    handler: async (runtime, message, _state, options) => {
+        if (!(await hasOwnerAccess(runtime, message))) {
+            return {
+                success: false,
+                text: "Permission denied: only the owner may stop apps.",
+            };
+        }
+        const params = options?.parameters;
+        const appName = params?.name?.trim() || extractAppName(message);
+        if (!appName) {
+            return {
+                success: false,
+                text: 'I need the app name to stop. Try: "stop shopify" or "close vincent"',
+            };
+        }
+        try {
+            const base = getApiBase();
+            const resp = await fetch(`${base}/api/apps/stop`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ name: appName }),
+                signal: AbortSignal.timeout(15_000),
+            });
+            const data = (await resp.json());
+            if (!resp.ok || data.success === false) {
+                const errMsg = data.message || `Failed to stop ${appName} (${resp.status})`;
+                logger.warn(`[app-control] stop failed: ${errMsg}`);
+                return { success: false, text: errMsg };
+            }
+            const msg = data.message || `${appName} has been stopped.`;
+            logger.info(`[app-control] stopped ${appName}`);
+            return {
+                success: true,
+                text: msg,
+                values: { appName },
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.error(`[app-control] stop error: ${msg}`);
+            return { success: false, text: `Failed to stop ${appName}: ${msg}` };
+        }
+    },
+    parameters: [
+        {
+            name: "name",
+            description: "The app name or slug to stop (e.g. 'shopify', 'vincent', 'companion').",
+            required: true,
+            schema: { type: "string" },
+        },
+    ],
+};

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

@@ -0,0 +1,2 @@
+export * from "@elizaos/app-lifeops/actions/calendar";
+//# sourceMappingURL=calendar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../../../../src/actions/calendar.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAC"}

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

@@ -0,0 +1 @@
+export * from "@elizaos/app-lifeops/actions/calendar";

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