@elizaos/agent 2.0.0-alpha.97 → 2.0.0-beta.1

package/README.md

@@ -0,0 +1,33 @@
+# `@elizaos/agent`
+
+Standalone elizaOS agent and HTTP backend. Plugin routes can be registered on `AgentRuntime` and are served by the agent’s HTTP stack.
+
+## Documentation
+
+- **Paid HTTP routes (webhooks, plugins):** see the docs site section on [webhooks and routes](https://docs.elizaos.ai/plugins/webhooks-and-routes).
+- **x402 micropayments on plugin routes:** see [x402 paid plugin routes](https://docs.elizaos.ai/plugins/x402-paid-routes) and the [x402 roadmap](https://docs.elizaos.ai/plugins/x402-roadmap) for protocol alignment, env vars, and planned work.
+
+**Why this README exists:** the published docs site is the canonical narrative for operators and plugin authors; this file is the short “where do I look?” entry point from the package root and from npm/GitHub directory views.
+
+## Local development
+
+From this package:
+
+```bash
+bun install
+bun run typecheck
+bun run test
+```
+
+See `package.json` for `build`, `lint`, and other scripts.
+
+## x402 at a glance
+
+Paid routes set `x402` on a `Route`. The middleware can:
+
+- Return **402** with payment options (legacy JSON body for x402scan-style clients **and** `PAYMENT-REQUIRED` for standard buyers).
+- Accept **on-chain proofs**, **facilitator payment IDs**, or **standard payment payloads** (`PAYMENT-SIGNATURE` / `X-Payment`), then **verify and settle** through a facilitator before running the handler.
+
+**Why verify *and* settle:** a valid authorization signature is not the same as collected funds. Unlocking the handler only after settlement matches how facilitators are meant to be used and avoids “free API” gaps between verify and on-chain execution.
+
+For environment variables, events, replay protection, and buyer guidance, use the linked docs above.

package/dist/package.json

@@ -0,0 +1,139 @@
+{
+  "name": "@elizaos/agent",
+  "version": "2.0.0-beta.1",
+  "description": "Standalone elizaOS-based agent and backend server package.",
+  "type": "module",
+  "license": "MIT",
+  "homepage": "https://github.com/elizaos/eliza",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elizaos/eliza.git",
+    "directory": "packages/agent"
+  },
+  "keywords": [
+    "eliza",
+    "agent",
+    "backend",
+    "runtime",
+    "elizaos"
+  ],
+  "main": "./packages/agent/src/index.js",
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "bin": {
+    "eliza-autonomous": "./packages/agent/src/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./packages/agent/src/index.d.ts",
+      "import": "./packages/agent/src/index.js",
+      "default": "./packages/agent/src/index.js"
+    },
+    "./package.json": "./package.json",
+    "./config/plugin-auto-enable": {
+      "types": "./packages/agent/src/config/plugin-auto-enable.d.ts",
+      "import": "./packages/agent/src/config/plugin-auto-enable.js",
+      "default": "./packages/agent/src/config/plugin-auto-enable.js"
+    },
+    "./services/app-session-gate": {
+      "types": "./packages/agent/src/services/app-session-gate.d.ts",
+      "bun": {
+        "types": "./packages/agent/src/services/app-session-gate.d.ts",
+        "import": "./packages/agent/src/services/app-session-gate.js",
+        "default": "./packages/agent/src/services/app-session-gate.js"
+      },
+      "import": "./packages/agent/src/services/app-session-gate.js",
+      "default": "./packages/agent/src/services/app-session-gate.js"
+    },
+    "./security/*": {
+      "types": "./packages/agent/src/security/*.d.ts",
+      "bun": {
+        "types": "./packages/agent/src/security/*.d.ts",
+        "import": "./packages/agent/src/security/*.js",
+        "default": "./packages/agent/src/security/*.js"
+      },
+      "import": "./packages/agent/src/security/*.js",
+      "default": "./packages/agent/src/security/*.js"
+    },
+    "./services/*": {
+      "types": "./packages/agent/src/services/*.d.ts",
+      "bun": {
+        "types": "./packages/agent/src/services/*.d.ts",
+        "import": "./packages/agent/src/services/*.js",
+        "default": "./packages/agent/src/services/*.js"
+      },
+      "import": "./packages/agent/src/services/*.js",
+      "default": "./packages/agent/src/services/*.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "directory": "dist"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.0.0",
+    "@elizaos/capacitor-contacts": "2.0.0-beta.1",
+    "@elizaos/capacitor-phone": "2.0.0-beta.1",
+    "@elizaos/capacitor-wifi": "2.0.0-beta.1",
+    "@elizaos/core": "2.0.0-beta.1",
+    "@elizaos/plugin-agent-skills": "2.0.0-beta.1",
+    "@elizaos/plugin-aosp-local-inference": "2.0.0-beta.1",
+    "@elizaos/plugin-browser": "2.0.0-beta.1",
+    "@elizaos/plugin-capacitor-bridge": "2.0.0-beta.1",
+    "@elizaos/plugin-coding-tools": "2.0.0-beta.1",
+    "@elizaos/plugin-commands": "2.0.0-beta.1",
+    "@elizaos/plugin-computeruse": "2.0.0-beta.1",
+    "@elizaos/plugin-discord": "2.0.0-beta.1",
+    "@elizaos/plugin-discord-local": "2.0.0-beta.1",
+    "@elizaos/plugin-elizacloud": "2.0.0-beta.1",
+    "@elizaos/plugin-imessage": "2.0.0-beta.1",
+    "@elizaos/plugin-local-embedding": "2.0.0-beta.1",
+    "@elizaos/plugin-local-inference": "2.0.0-beta.1",
+    "@elizaos/plugin-mcp": "2.0.0-beta.1",
+    "@elizaos/plugin-ollama": "2.0.0-beta.1",
+    "@elizaos/plugin-pdf": "2.0.0-beta.1",
+    "@elizaos/plugin-signal": "2.0.0-beta.1",
+    "@elizaos/plugin-sql": "2.0.0-beta.1",
+    "@elizaos/plugin-streaming": "2.0.0-beta.1",
+    "@elizaos/plugin-video": "2.0.0-beta.1",
+    "@elizaos/plugin-wechat": "2.0.0-beta.1",
+    "@elizaos/plugin-whatsapp": "2.0.0-beta.1",
+    "@elizaos/plugin-workflow": "2.0.0-beta.1",
+    "@elizaos/plugin-x402": "2.0.0-beta.1",
+    "@elizaos/shared": "2.0.0-beta.1",
+    "@elizaos/skills": "2.0.0-beta.1",
+    "@elizaos/vault": "2.0.0-beta.1",
+    "@hapi/boom": "^10.0.1",
+    "@noble/curves": "2.2.0",
+    "@solana/web3.js": "1.98.4",
+    "@whiskeysockets/baileys": "7.0.0-rc.9",
+    "abitype": "^1.0.0",
+    "coding-agent-adapters": "0.16.3",
+    "dotenv": "^17.2.3",
+    "drizzle-orm": "0.45.2",
+    "esbuild": "^0.28.0",
+    "ethers": "^6.16.0",
+    "git-workspace-service": "0.4.5",
+    "jsdom": "^29.0.0",
+    "json5": "^2.2.3",
+    "pg": "^8.16.3",
+    "pino": "^10.3.1",
+    "pty-manager": "1.11.0",
+    "puppeteer-core": "^24.37.5",
+    "qrcode": "^1.5.4",
+    "telegram": "2.26.22",
+    "viem": "^2.48.8",
+    "ws": "^8.19.0",
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "@elizaos/signal-native": "*"
+  },
+  "peerDependenciesMeta": {
+    "@elizaos/signal-native": {
+      "optional": true
+    }
+  },
+  "types": "./packages/agent/src/index.d.ts"
+}

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

@@ -0,0 +1,74 @@
+/**
+ * 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 MESSAGE and POST connector operations.
+ *
+ * @module actions/connector-resolver
+ */
+import type { IAgentRuntime, Memory, RelationshipsGraphService, RelationshipsPersonSummary, Room, UUID } from "@elizaos/core";
+/** 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): Promise<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/dist/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,EACV,aAAa,EACb,MAAM,EACN,yBAAyB,EACzB,0BAA0B,EAC1B,IAAI,EAEJ,IAAI,EACL,MAAM,eAAe,CAAC;AAQvB,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,wBAAsB,eAAe,CACnC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAI3C;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,CASvE;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,CA8DjC;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,CAoCR;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,0BAA0B,EAAE,GACvC,MAAM,CAcR;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/dist/packages/agent/src/actions/connector-resolver.js

@@ -0,0 +1,253 @@
+/**
+ * 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 MESSAGE and POST connector operations.
+ *
+ * @module actions/connector-resolver
+ */
+import { logger } from "@elizaos/core";
+import { formatSpeakerLabel } from "../shared/conversation-format.js";
+// ---------------------------------------------------------------------------
+// Service access
+// ---------------------------------------------------------------------------
+export async function getGraphService(runtime) {
+    return runtime.getService("relationships");
+}
+/** Returns the set of connector source names that have active send handlers. */
+export function getActiveConnectors(runtime) {
+    const active = new Set();
+    for (const connector of runtime.getMessageConnectors()) {
+        if (typeof connector.source === "string" && connector.source.trim()) {
+            active.add(connector.source);
+        }
+    }
+    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 = await 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];
+    if (!person) {
+        return null;
+    }
+    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)
+        const fallbackPlatform = reachablePlatforms[0];
+        if (fallbackPlatform) {
+            recommendedPlatform = fallbackPlatform;
+        }
+    }
+    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 = await 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 (const [index, mem] of convo.messages.entries()) {
+            if (!mem) {
+                continue;
+            }
+            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(index + 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 (const [index, p] of candidates.entries()) {
+        if (!p) {
+            continue;
+        }
+        const platforms = p.platforms.join(", ") || "no platforms";
+        const aliases = p.aliases.length > 0 ? ` (aka ${p.aliases.slice(0, 2).join(", ")})` : "";
+        lines.push(`${index + 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/dist/packages/agent/src/actions/contact.d.ts

@@ -0,0 +1,35 @@
+/**
+ * CONTACT — single umbrella action consolidating Rolodex / contact /
+ * entity / relationship lifecycle.
+ *
+ * Replaces the former SEARCH_CONTACT / READ_CONTACT / LINK_CONTACT /
+ * MERGE_CONTACT / CONTACT_ACTIVITY / CREATE_CONTACT / UPDATE_CONTACT /
+ * DELETE_CONTACT actions in `entity-actions.ts`, plus the core-side
+ * ADD_CONTACT / REMOVE_CONTACT / SEARCH_CONTACTS / UPDATE_CONTACT /
+ * UPDATE_ENTITY actions (which lived in
+ * `packages/core/src/features/advanced-capabilities/actions/`).
+ *
+ * Op-based dispatch (Pattern C):
+ *   create   — create a new contact entity (and optionally a contact_info
+ *              component via RelationshipsService when categories/tags/
+ *              preferences/customFields are provided).
+ *   read     — load full identity + facts + recent conversations +
+ *              relationships for an entity by id or name.
+ *   search   — search the Rolodex by name/handle/platform with
+ *              line-numbered results.
+ *   update   — update an existing contact: name/email/phone/notes via the
+ *              entity record, categories/tags/preferences/customFields
+ *              via the contact_info component, or component data per
+ *              source (UPDATE_ENTITY semantics).
+ *   delete   — permanently delete a contact entity (requires confirm).
+ *   link     — propose / confirm a merge of two entities that represent
+ *              the same human across platforms.
+ *   merge    — accept or reject a pending merge candidate by id.
+ *   activity — paginated relationship/identity/fact activity timeline.
+ *   followup — schedule a follow-up touch-base with a contact via the
+ *              FollowUp service (was SCHEDULE_FOLLOW_UP).
+ */
+import type { Action, IAgentRuntime } from "@elizaos/core";
+export declare function registerEntitySearchCategory(runtime: IAgentRuntime): void;
+export declare const contactAction: Action;
+//# sourceMappingURL=contact.d.ts.map

package/dist/packages/agent/src/actions/contact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact.d.ts","sourceRoot":"","sources":["../../../../../src/actions/contact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EACV,MAAM,EAON,aAAa,EAWd,MAAM,eAAe,CAAC;AAiZvB,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAIzE;AAw2CD,eAAO,MAAM,aAAa,EAAE,MAoa3B,CAAC"}