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

package/packages/agent/src/api/connector-health.d.ts

@@ -12,9 +12,17 @@ export interface ConnectorHealthMonitorOptions {
     config: {
         connectors?: Record<string, unknown>;
     };
-    broadcastWs: (payload: Record<string, unknown>) => void;
+    broadcastWs: (payload: object) => void;
     intervalMs?: number;
 }
+/**
+ * Maps connector config keys to the service/client name the plugin registers.
+ *
+ * Kept aligned with CONNECTOR_PLUGINS in plugin-auto-enable.ts — every
+ * connector that can be configured should be probeable here so that cloud
+ * and local agents get the same health monitoring coverage.
+ */
+export declare const CONNECTOR_PLUGIN_MAP: Record<string, string>;
 export declare class ConnectorHealthMonitor {
     private runtime;
     private config;

package/packages/agent/src/api/connector-health.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connector-health.d.ts","sourceRoot":"","sources":["../../../../../src/api/connector-health.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC;AAE3D,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACjD,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAYD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,WAAW,CAA6C;IAChE,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,QAAQ,CAA2C;gBAE/C,IAAI,EAAE,6BAA6B;IAO/C,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,IAAI;IAOZ,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;IAQvD,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,uBAAuB;YAiBjB,cAAc;IAsBtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAwB7B"}
+{"version":3,"file":"connector-health.d.ts","sourceRoot":"","sources":["../../../../../src/api/connector-health.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC;AAE3D,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACjD,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsBvD,CAAC;AAQF,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,QAAQ,CAA2C;gBAE/C,IAAI,EAAE,6BAA6B;IAO/C,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,IAAI;IAOZ,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;IAQvD,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,uBAAuB;YAiBjB,cAAc;IAoBtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAwB7B"}

package/packages/agent/src/api/connector-health.js

@@ -6,13 +6,40 @@
  * "missing", broadcasts a system-warning via WebSocket.
  */
 const DEFAULT_INTERVAL_MS = 60_000;
-const CONNECTOR_PLUGIN_MAP = {
+/**
+ * Maps connector config keys to the service/client name the plugin registers.
+ *
+ * Kept aligned with CONNECTOR_PLUGINS in plugin-auto-enable.ts — every
+ * connector that can be configured should be probeable here so that cloud
+ * and local agents get the same health monitoring coverage.
+ */
+export const CONNECTOR_PLUGIN_MAP = {
+    bluebubbles: "bluebubbles",
     discord: "discord",
+    discordLocal: "discord-local",
     telegram: "telegram",
+    telegramAccount: "telegram-account",
     twitter: "twitter",
     slack: "slack",
     farcaster: "farcaster",
+    lens: "lens",
+    whatsapp: "whatsapp",
+    signal: "signal",
+    imessage: "imessage",
+    msteams: "msteams",
+    feishu: "feishu",
+    matrix: "matrix",
+    nostr: "nostr",
+    blooio: "blooio",
+    twitch: "twitch",
+    mattermost: "mattermost",
+    googlechat: "google-chat",
+    wechat: "wechat",
 };
+const CONNECTOR_PLUGIN_MAP_NORMALIZED = Object.fromEntries(Object.entries(CONNECTOR_PLUGIN_MAP).map(([connectorName, pluginName]) => [
+    connectorName.toLowerCase(),
+    pluginName,
+]));
 export class ConnectorHealthMonitor {
     runtime;
     config;
@@ -69,17 +96,13 @@ export class ConnectorHealthMonitor {
         return result;
     }
     async probeConnector(name) {
-        const pluginName = CONNECTOR_PLUGIN_MAP[name.toLowerCase()];
+        const pluginName = CONNECTOR_PLUGIN_MAP[name] ??
+            CONNECTOR_PLUGIN_MAP_NORMALIZED[name.toLowerCase()];
         if (!pluginName)
             return "unknown";
-        try {
-            const service = this.runtime.getService(pluginName);
-            if (service)
-                return "ok";
-        }
-        catch {
-            // getService may throw if runtime is shutting down
-        }
+        const service = this.runtime.getService(pluginName);
+        if (service)
+            return "ok";
         // Also check runtime.clients if available
         const clients = this.runtime.clients;
         if (clients?.[pluginName])

package/packages/agent/src/api/connector-oauth-callback-auth.d.ts

@@ -0,0 +1,2 @@
+export declare function isConnectorOAuthCallbackEndpoint(method: string, pathname: string): boolean;
+//# sourceMappingURL=connector-oauth-callback-auth.d.ts.map

package/packages/agent/src/api/connector-oauth-callback-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-oauth-callback-auth.d.ts","sourceRoot":"","sources":["../../../../../src/api/connector-oauth-callback-auth.ts"],"names":[],"mappings":"AAAA,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAKT"}

package/packages/agent/src/api/connector-oauth-callback-auth.js

@@ -0,0 +1,4 @@
+export function isConnectorOAuthCallbackEndpoint(method, pathname) {
+    return ((method === "GET" || method === "POST") &&
+        /^\/api\/connectors\/[^/]+\/oauth\/callback(?:\/[^/]+)?$/.test(pathname));
+}

package/packages/agent/src/api/connector-routes.d.ts

@@ -0,0 +1,36 @@
+import type http from "node:http";
+import type { IAgentRuntime, ReadJsonBodyOptions } from "@elizaos/core";
+import type { ElizaConfig } from "../config/config.ts";
+export interface ConnectorRouteContext {
+    req: http.IncomingMessage;
+    res: http.ServerResponse;
+    method: string;
+    pathname: string;
+    state: {
+        config: ElizaConfig;
+        /**
+         * Optional running agent. When present, every disconnect path emits
+         * `connector_disconnected` so service-owned caches (workflow credential
+         * store, etc.) self-invalidate without the agent reaching across package
+         * boundaries.
+         */
+        runtime?: IAgentRuntime | null;
+    };
+    json: (res: http.ServerResponse, data: unknown, status?: number) => void;
+    error: (res: http.ServerResponse, message: string, status?: number) => void;
+    readJsonBody: <T extends object>(req: http.IncomingMessage, res: http.ServerResponse, options?: ReadJsonBodyOptions) => Promise<T | null>;
+    saveElizaConfig: (config: ElizaConfig) => void;
+    redactConfigSecrets: (config: Record<string, unknown>) => Record<string, unknown>;
+    isBlockedObjectKey: (key: string) => boolean;
+    cloneWithoutBlockedObjectKeys: <T>(value: T) => T;
+    /**
+     * Optional host-supplied callback fired on every disconnect path. The
+     * canonical invalidation channel is the `connector_disconnected` runtime
+     * event (subscribed to by services like the workflow credential store);
+     * this callback remains as a host extension point for behavior that does
+     * not belong on the runtime event bus.
+     */
+    onConnectorDisconnect?: (connectorName: string) => Promise<void> | void;
+}
+export declare function handleConnectorRoutes(ctx: ConnectorRouteContext): Promise<boolean>;
+//# sourceMappingURL=connector-routes.d.ts.map

package/packages/agent/src/api/connector-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/connector-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAEV,aAAa,EACb,mBAAmB,EACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AA0BvD,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,IAAI,CAAC,eAAe,CAAC;IAC1B,GAAG,EAAE,IAAI,CAAC,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QACL,MAAM,EAAE,WAAW,CAAC;QACpB;;;;;WAKG;QACH,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;KAChC,CAAC;IACF,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzE,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5E,YAAY,EAAE,CAAC,CAAC,SAAS,MAAM,EAC7B,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,OAAO,CAAC,EAAE,mBAAmB,KAC1B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,eAAe,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IAC/C,mBAAmB,EAAE,CACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7C,6BAA6B,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;IAClD;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACzE;AAgFD,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,OAAO,CAAC,CA2IlB"}

package/packages/agent/src/api/connector-routes.js

@@ -0,0 +1,184 @@
+import { credTypesForConnector } from "@elizaos/shared";
+import { CONNECTOR_ENV_MAP } from "../config/env-vars.js";
+/**
+ * Runtime event name emitted when a connector is disconnected. Subscribers
+ * (e.g. `WorkflowCredentialStore` in `@elizaos/plugin-workflow`) self-purge
+ * any caches keyed off the connector instead of the agent reaching across
+ * package boundaries to call them directly.
+ *
+ * Kept as a local string constant to avoid pulling plugin-workflow types
+ * into the agent. The matching constant in plugin-workflow lives at
+ * `plugins/plugin-workflow/src/types/index.ts` (`CONNECTOR_DISCONNECTED_EVENT`).
+ */
+const CONNECTOR_DISCONNECTED_EVENT = "connector_disconnected";
+/**
+ * Emit the `connector_disconnected` runtime event so service subscribers can
+ * purge their own caches. Safe when no runtime / no subscribers are
+ * registered: the runtime emit is a no-op in that case.
+ */
+async function emitConnectorDisconnected(runtime, connectorName) {
+    if (!runtime)
+        return;
+    const credTypes = credTypesForConnector(connectorName);
+    const payload = {
+        runtime,
+        userId: runtime.agentId,
+        credTypes,
+        connectorName,
+    };
+    await runtime.emitEvent(CONNECTOR_DISCONNECTED_EVENT, payload);
+}
+function getConfiguredConnectorsFromEnv() {
+    const configured = {};
+    for (const [connectorName, envMap] of Object.entries(CONNECTOR_ENV_MAP)) {
+        const envKeys = new Set(Object.values(envMap));
+        if (connectorName === "discord") {
+            envKeys.add("DISCORD_BOT_TOKEN");
+        }
+        const hasAnyEnvValue = [...envKeys].some((envKey) => {
+            const value = process.env[envKey];
+            return typeof value === "string" && value.trim().length > 0;
+        });
+        if (hasAnyEnvValue) {
+            configured[connectorName] = {
+                enabled: true,
+                configuredViaEnv: true,
+            };
+        }
+    }
+    return configured;
+}
+function listVisibleConnectors(config) {
+    const rawConnectors = config.connectors ??
+        config.channels ??
+        {};
+    const visibleConnectors = rawConnectors &&
+        typeof rawConnectors === "object" &&
+        !Array.isArray(rawConnectors)
+        ? { ...rawConnectors }
+        : {};
+    for (const [connectorName, summary] of Object.entries(getConfiguredConnectorsFromEnv())) {
+        if (!(connectorName in visibleConnectors)) {
+            visibleConnectors[connectorName] = summary;
+        }
+    }
+    return visibleConnectors;
+}
+// ---------------------------------------------------------------------------
+// Route handler
+// ---------------------------------------------------------------------------
+export async function handleConnectorRoutes(ctx) {
+    const { req, res, method, pathname, state, json, error, readJsonBody, saveElizaConfig, redactConfigSecrets, isBlockedObjectKey, cloneWithoutBlockedObjectKeys, onConnectorDisconnect, } = ctx;
+    // ── GET /api/connectors ──────────────────────────────────────────────
+    if (method === "GET" && pathname === "/api/connectors") {
+        json(res, {
+            connectors: redactConfigSecrets(listVisibleConnectors(state.config)),
+        });
+        return true;
+    }
+    // ── POST /api/connectors ─────────────────────────────────────────────
+    if (method === "POST" && pathname === "/api/connectors") {
+        const body = await readJsonBody(req, res);
+        if (!body)
+            return true;
+        const name = body.name;
+        const config = body.config;
+        if (!name || typeof name !== "string" || !name.trim()) {
+            error(res, "Missing connector name", 400);
+            return true;
+        }
+        const connectorName = name.trim();
+        if (isBlockedObjectKey(connectorName)) {
+            error(res, 'Invalid connector name: "__proto__", "constructor", and "prototype" are reserved', 400);
+            return true;
+        }
+        if (!config || typeof config !== "object") {
+            error(res, "Missing connector config", 400);
+            return true;
+        }
+        if (!state.config.connectors)
+            state.config.connectors = {};
+        state.config.connectors[connectorName] = cloneWithoutBlockedObjectKeys(config);
+        try {
+            saveElizaConfig(state.config);
+        }
+        catch {
+            /* test envs */
+        }
+        // Only treat this POST as a disconnect when the incoming payload
+        // explicitly sets `enabled: false`. The second clause that read
+        // `state.config.connectors[connectorName]` would have been evaluated
+        // AFTER the new (cloned) config was written above, making it equivalent
+        // to checking the incoming payload — but firing on every config-only
+        // update that happens to omit `enabled` while the connector was active.
+        // That false-positive purge silently broke live connectors.
+        const isDisconnect = config.enabled === false;
+        if (isDisconnect) {
+            try {
+                await emitConnectorDisconnected(state.runtime, connectorName);
+            }
+            catch {
+                /* don't let event-bus failure block the response */
+            }
+            if (onConnectorDisconnect) {
+                try {
+                    await onConnectorDisconnect(connectorName);
+                }
+                catch {
+                    /* don't let host callback failure block the response */
+                }
+            }
+        }
+        json(res, {
+            connectors: redactConfigSecrets((state.config.connectors ?? {})),
+        });
+        return true;
+    }
+    // ── DELETE /api/connectors/:name ─────────────────────────────────────
+    if (method === "DELETE" && pathname.startsWith("/api/connectors/")) {
+        const rawName = pathname.slice("/api/connectors/".length);
+        if (rawName.includes("/")) {
+            return false;
+        }
+        const name = decodeURIComponent(rawName);
+        if (!name || isBlockedObjectKey(name)) {
+            error(res, "Missing or invalid connector name", 400);
+            return true;
+        }
+        if (state.config.connectors &&
+            Object.hasOwn(state.config.connectors, name)) {
+            delete state.config.connectors[name];
+        }
+        const stateConfigRecord = state.config;
+        if (stateConfigRecord.channels &&
+            typeof stateConfigRecord.channels === "object" &&
+            Object.hasOwn(stateConfigRecord.channels, name)) {
+            delete stateConfigRecord.channels[name];
+        }
+        try {
+            saveElizaConfig(state.config);
+        }
+        catch {
+            /* test envs */
+        }
+        try {
+            await emitConnectorDisconnected(state.runtime, name);
+        }
+        catch {
+            /* don't let event-bus failure block the response */
+        }
+        if (onConnectorDisconnect) {
+            try {
+                await onConnectorDisconnect(name);
+            }
+            catch {
+                /* don't let host callback failure block the response */
+            }
+        }
+        json(res, {
+            connectors: redactConfigSecrets((state.config.connectors ?? {})),
+        });
+        return true;
+    }
+    return false;
+}

package/packages/agent/src/api/conversation-metadata.d.ts

@@ -0,0 +1,10 @@
+import type { JsonValue, Room } from "@elizaos/core";
+import type { ConversationMeta, ConversationMetadata } from "./server-types.ts";
+type RoomMetadataRecord = Record<string, JsonValue>;
+export declare function sanitizeConversationMetadata(value: unknown): ConversationMetadata | undefined;
+export declare function buildConversationRoomMetadata(conversation: Pick<ConversationMeta, "id" | "metadata">, ownerId: string, existingMetadata?: unknown): RoomMetadataRecord;
+export declare function extractConversationMetadataFromRoom(room: Pick<Room, "metadata"> | null | undefined, expectedConversationId?: string): ConversationMetadata | undefined;
+export declare function isAutomationConversationMetadata(metadata: ConversationMetadata | null | undefined): boolean;
+export declare function isPageScopedConversationMetadata(metadata: ConversationMetadata | null | undefined): boolean;
+export {};
+//# sourceMappingURL=conversation-metadata.d.ts.map

package/packages/agent/src/api/conversation-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-metadata.d.ts","sourceRoot":"","sources":["../../../../../src/api/conversation-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EAErB,MAAM,mBAAmB,CAAC;AAE3B,KAAK,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AA4BpD,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,GACb,oBAAoB,GAAG,SAAS,CAkDlC;AAED,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,UAAU,CAAC,EACvD,OAAO,EAAE,MAAM,EACf,gBAAgB,CAAC,EAAE,OAAO,GACzB,kBAAkB,CAkBpB;AAED,wBAAgB,mCAAmC,CACjD,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,EAC/C,sBAAsB,CAAC,EAAE,MAAM,GAC9B,oBAAoB,GAAG,SAAS,CAkBlC;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAChD,OAAO,CAOT;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAChD,OAAO,CAGT"}

package/packages/agent/src/api/conversation-metadata.js

@@ -0,0 +1,107 @@
+import { asNonEmptyString, asRecord } from "@elizaos/shared";
+const VALID_SCOPES = new Set([
+    "general",
+    "automation-coordinator",
+    "automation-workflow",
+    "automation-workflow-draft",
+    "automation-draft",
+    "page-character",
+    "page-apps",
+    "page-connectors",
+    "page-phone",
+    "page-plugins",
+    "page-lifeops",
+    "page-settings",
+    "page-wallet",
+    "page-browser",
+    "page-automations",
+]);
+const VALID_AUTOMATION_TYPES = new Set(["coordinator_text", "workflow"]);
+const normalizeOptionalString = asNonEmptyString;
+export function sanitizeConversationMetadata(value) {
+    const record = asRecord(value);
+    if (!record) {
+        return undefined;
+    }
+    const scope = normalizeOptionalString(record.scope);
+    const automationType = normalizeOptionalString(record.automationType);
+    const next = {};
+    if (scope && VALID_SCOPES.has(scope)) {
+        next.scope = scope;
+    }
+    if (automationType && VALID_AUTOMATION_TYPES.has(automationType)) {
+        next.automationType =
+            automationType;
+    }
+    const taskId = normalizeOptionalString(record.taskId);
+    if (taskId)
+        next.taskId = taskId;
+    const triggerId = normalizeOptionalString(record.triggerId);
+    if (triggerId)
+        next.triggerId = triggerId;
+    const workflowId = normalizeOptionalString(record.workflowId);
+    if (workflowId)
+        next.workflowId = workflowId;
+    const workflowName = normalizeOptionalString(record.workflowName);
+    if (workflowName)
+        next.workflowName = workflowName;
+    const draftId = normalizeOptionalString(record.draftId);
+    if (draftId)
+        next.draftId = draftId;
+    const pageId = normalizeOptionalString(record.pageId);
+    if (pageId)
+        next.pageId = pageId;
+    const sourceConversationId = normalizeOptionalString(record.sourceConversationId);
+    if (sourceConversationId)
+        next.sourceConversationId = sourceConversationId;
+    const terminalBridgeConversationId = normalizeOptionalString(record.terminalBridgeConversationId);
+    if (terminalBridgeConversationId) {
+        next.terminalBridgeConversationId = terminalBridgeConversationId;
+    }
+    return Object.keys(next).length > 0 ? next : undefined;
+}
+export function buildConversationRoomMetadata(conversation, ownerId, existingMetadata) {
+    const base = (asRecord(existingMetadata) ?? {});
+    const sanitized = sanitizeConversationMetadata(conversation.metadata);
+    const next = {
+        ...base,
+        ownership: { ownerId },
+    };
+    if (sanitized) {
+        next.webConversation = {
+            conversationId: conversation.id,
+            ...sanitized,
+        };
+    }
+    else {
+        delete next.webConversation;
+    }
+    return next;
+}
+export function extractConversationMetadataFromRoom(room, expectedConversationId) {
+    const roomMetadata = asRecord(room?.metadata);
+    if (!roomMetadata) {
+        return undefined;
+    }
+    const stored = asRecord(roomMetadata.webConversation);
+    if (!stored) {
+        return undefined;
+    }
+    const storedConversationId = normalizeOptionalString(stored.conversationId);
+    if (expectedConversationId &&
+        storedConversationId &&
+        storedConversationId !== expectedConversationId) {
+        return undefined;
+    }
+    return sanitizeConversationMetadata(stored);
+}
+export function isAutomationConversationMetadata(metadata) {
+    return (metadata?.scope === "automation-coordinator" ||
+        metadata?.scope === "automation-workflow" ||
+        metadata?.scope === "automation-workflow-draft" ||
+        metadata?.scope === "automation-draft");
+}
+export function isPageScopedConversationMetadata(metadata) {
+    const scope = metadata?.scope;
+    return typeof scope === "string" && scope.startsWith("page-");
+}

package/packages/agent/src/api/conversation-routes.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Conversation CRUD routes extracted from server.ts.
+ *
+ * Handles:
+ *   POST   /api/conversations            – create
+ *   GET    /api/conversations             – list
+ *   GET    /api/conversations/:id/messages – get messages
+ *   POST   /api/conversations/:id/messages/truncate – truncate
+ *   POST   /api/conversations/:id/messages/stream   – stream message
+ *   POST   /api/conversations/:id/messages           – send message
+ *   POST   /api/conversations/:id/greeting            – get/store greeting
+ *   PATCH  /api/conversations/:id         – update/rename
+ *   DELETE /api/conversations/:id         – delete
+ */
+import type { RouteRequestContext } from "@elizaos/core";
+import { type AgentRuntime, type Content, type UUID } from "@elizaos/core";
+import type { ElizaConfig } from "../config/config.ts";
+import type { ChatGenerationResult, LogEntry } from "./chat-routes.ts";
+import type { ConversationMeta } from "./server-types.ts";
+export interface ConversationRouteState {
+    runtime: AgentRuntime | null;
+    config: ElizaConfig;
+    agentName: string;
+    adminEntityId: UUID | null;
+    chatUserId: UUID | null;
+    logBuffer: LogEntry[];
+    conversations: Map<string, ConversationMeta>;
+    conversationRestorePromise: Promise<void> | null;
+    deletedConversationIds: Set<string>;
+    broadcastWs: ((data: object) => void) | null;
+    /** Wallet trade permission mode for wallet-mode guidance replies. */
+    tradePermissionMode?: string;
+}
+export interface ConversationRouteContext extends RouteRequestContext {
+    state: ConversationRouteState;
+}
+export declare function resolveConversationAdminEntityId(state: ConversationRouteState): UUID;
+export declare function normalizeActionCallbackHistory(value: unknown): string[];
+export declare function formatConversationMessageText(text: string, actionCallbackHistory?: readonly string[]): string;
+export declare function buildPersistedAssistantContent(text: string, result: Pick<ChatGenerationResult, "actionCallbackHistory" | "responseContent" | "responseMessages"> | null | undefined): Content;
+export declare function persistRecentAssistantActionCallbackHistory(runtime: AgentRuntime, roomId: UUID, actionCallbackHistory: readonly string[], sinceMs: number): Promise<boolean>;
+export declare function handleConversationRoutes(ctx: ConversationRouteContext): Promise<boolean>;
+//# sourceMappingURL=conversation-routes.d.ts.map

package/packages/agent/src/api/conversation-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/conversation-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,OAAO,EAIZ,KAAK,IAAI,EACV,MAAM,eAAe,CAAC;AAQvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AA8BvE,OAAO,KAAK,EAAE,gBAAgB,EAAwB,MAAM,mBAAmB,CAAC;AA+DhF,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C,0BAA0B,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACjD,sBAAsB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7C,qEAAqE;IACrE,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACnE,KAAK,EAAE,sBAAsB,CAAC;CAC/B;AAMD,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,sBAAsB,GAC5B,IAAI,CAEN;AAsPD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAqBvE;AASD,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,qBAAqB,GAAE,SAAS,MAAM,EAAO,GAC5C,MAAM,CAYR;AAED,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,MAAM,EACZ,MAAM,EACF,IAAI,CACF,oBAAoB,EACpB,uBAAuB,GAAG,iBAAiB,GAAG,kBAAkB,CACjE,GACD,IAAI,GACJ,SAAS,GACZ,OAAO,CA8BT;AAED,wBAAsB,2CAA2C,CAC/D,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,IAAI,EACZ,qBAAqB,EAAE,SAAS,MAAM,EAAE,EACxC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAoElB;AAkMD,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,wBAAwB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAo/BlB"}