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

package/packages/agent/src/api/index.d.ts

@@ -1,61 +1,46 @@
-export * from "./agent-admin-routes";
-export * from "./agent-lifecycle-routes";
-export * from "./agent-model";
-export * from "./agent-transfer-routes";
-export * from "./apps-routes";
-export * from "./auth-routes";
-export * from "./bug-report-routes";
-export * from "./character-routes";
-export * from "./cloud-billing-routes";
-export * from "./cloud-compat-routes";
-export { type CloudRouteState, handleCloudRoute, } from "./cloud-routes";
-export { type CloudStatusRouteContext, handleCloudStatusRoutes, } from "./cloud-status-routes";
-export * from "./compat-utils";
-export * from "./connector-health";
-export * from "./coordinator-wiring";
-export * from "./credit-detection";
-export * from "./database";
-export * from "./diagnostics-routes";
-export * from "./drop-service";
-export * from "./early-logs";
-export * from "./http-helpers";
-export * from "./knowledge-routes";
-export * from "./knowledge-service-loader";
-export * from "./memory-bounds";
-export * from "./memory-routes";
-export * from "./merkle-tree";
-export * from "./models-routes";
-export * from "./nfa-routes";
-export * from "./og-tracker";
-export * from "./parse-action-block";
-export * from "./permissions-routes";
-export * from "./plugin-validation";
-export * from "./provider-switch-config";
-export * from "./registry-routes";
-export * from "./registry-service";
-export * from "./route-helpers";
-export * from "./sandbox-routes";
-export { applySignalQrOverride, handleSignalRoute, type SignalPairingEventLike, type SignalPairingSessionLike, type SignalRouteDeps, type SignalRouteState, } from "./signal-routes";
-export * from "./stream-route-state";
-export * from "./stream-routes";
-export type { StreamVoiceRouteContext } from "./stream-voice-routes";
-export { handleStreamVoiceRoute } from "./stream-voice-routes";
-export * from "./streaming-text";
-export * from "./subscription-routes";
-export * from "./terminal-run-limits";
-export * from "./training-backend-check";
-export * from "./training-routes";
-export * from "./training-service-like";
-export * from "./trajectory-routes";
-export * from "./trigger-routes";
-export * from "./twitter-verify";
-export * from "./tx-service";
-export * from "./wallet";
-export * from "./wallet-dex-prices";
-export * from "./wallet-evm-balance";
-export * from "./wallet-routes";
-export * from "./wallet-rpc";
-export * from "./wallet-trading-profile";
-export { applyWhatsAppQrOverride, handleWhatsAppRoute, type WhatsAppPairingEventLike, type WhatsAppPairingSessionLike, type WhatsAppRouteDeps, type WhatsAppRouteState, } from "./whatsapp-routes";
-export * from "./zip-utils";
+export { handleSandboxRoute } from "@elizaos/plugin-computeruse";
+export { applySignalQrOverride } from "@elizaos/plugin-signal";
+export { applyWhatsAppQrOverride, handleWhatsAppRoute, type WhatsAppPairingEventLike, type WhatsAppPairingSessionLike, type WhatsAppRouteDeps, type WhatsAppRouteState, } from "@elizaos/plugin-whatsapp";
+export { handleTriggerRoutes, type TriggerRouteContext, type TriggerRouteHelpers, } from "@elizaos/plugin-workflow";
+export * from "./accounts-routes.ts";
+export * from "./agent-admin-routes.ts";
+export * from "./agent-lifecycle-routes.ts";
+export * from "./agent-model.ts";
+export * from "./agent-transfer-routes.ts";
+export * from "./apps-routes.ts";
+export * from "./auth-routes.ts";
+export * from "./bug-report-routes.ts";
+export * from "./character-routes.ts";
+export * from "./compat-utils.ts";
+export * from "./connector-health.ts";
+export * from "./credit-detection.ts";
+export * from "./database.ts";
+export * from "./diagnostics-routes.ts";
+export * from "./documents-routes.ts";
+export * from "./documents-service-loader.ts";
+export * from "./early-logs.ts";
+export * from "./memory-bounds.ts";
+export * from "./memory-routes.ts";
+export * from "./models-routes.ts";
+export * from "./nfa-routes.ts";
+export * from "./parse-action-block.ts";
+export * from "./permission-request-prompt.ts";
+export * from "./permissions-routes.ts";
+export * from "./plugin-validation.ts";
+export * from "./provider-switch-config.ts";
+export * from "./rate-limiter.ts";
+export * from "./registry-routes.ts";
+export * from "./registry-service.ts";
+export { matchPluginRoutePath, tryHandleRuntimePluginRoute, } from "./runtime-plugin-routes.ts";
+export * from "./subscription-routes.ts";
+export * from "./terminal-run-limits.ts";
+export * from "./training-backend-check.ts";
+export * from "./training-service-like.ts";
+export * from "./tx-service.ts";
+export * from "./wallet.ts";
+export * from "./wallet-evm-balance.ts";
+export * from "./wallet-routes.ts";
+export * from "./wallet-rpc.ts";
+export * from "./wallet-trading-profile.ts";
+export * from "./zip-utils.ts";
 //# sourceMappingURL=index.d.ts.map

package/packages/agent/src/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EACL,KAAK,eAAe,EACpB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,uBAAuB,EAC5B,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,0BAA0B,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AAKtC,OAAO,EACL,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC"}

package/packages/agent/src/api/index.js

@@ -1,59 +1,49 @@
-export * from "./agent-admin-routes";
-export * from "./agent-lifecycle-routes";
-export * from "./agent-model";
-export * from "./agent-transfer-routes";
-export * from "./apps-routes";
-export * from "./auth-routes";
-export * from "./bug-report-routes";
-export * from "./character-routes";
-export * from "./cloud-billing-routes";
-export * from "./cloud-compat-routes";
-export { handleCloudRoute, } from "./cloud-routes";
-export { handleCloudStatusRoutes, } from "./cloud-status-routes";
-export * from "./compat-utils";
-export * from "./connector-health";
-export * from "./coordinator-wiring";
-export * from "./credit-detection";
-export * from "./database";
-export * from "./diagnostics-routes";
-export * from "./drop-service";
-export * from "./early-logs";
-export * from "./http-helpers";
-export * from "./knowledge-routes";
-export * from "./knowledge-service-loader";
-export * from "./memory-bounds";
-export * from "./memory-routes";
-export * from "./merkle-tree";
-export * from "./models-routes";
-export * from "./nfa-routes";
-export * from "./og-tracker";
-export * from "./parse-action-block";
-export * from "./permissions-routes";
-export * from "./plugin-validation";
-export * from "./provider-switch-config";
-export * from "./registry-routes";
-export * from "./registry-service";
-export * from "./route-helpers";
-export * from "./sandbox-routes";
-export { applySignalQrOverride, handleSignalRoute, } from "./signal-routes";
-export * from "./stream-route-state";
-export * from "./stream-routes";
-export { handleStreamVoiceRoute } from "./stream-voice-routes";
-export * from "./streaming-text";
-export * from "./subscription-routes";
-export * from "./terminal-run-limits";
-export * from "./training-backend-check";
-export * from "./training-routes";
-export * from "./training-service-like";
-export * from "./trajectory-routes";
-export * from "./trigger-routes";
-export * from "./twitter-verify";
-export * from "./tx-service";
-export * from "./wallet";
-export * from "./wallet-dex-prices";
-export * from "./wallet-evm-balance";
-export * from "./wallet-routes";
-export * from "./wallet-rpc";
-export * from "./wallet-trading-profile";
-export { applyWhatsAppQrOverride, handleWhatsAppRoute, } from "./whatsapp-routes";
-export * from "./zip-utils";
+export { handleSandboxRoute } from "@elizaos/plugin-computeruse";
+export { applySignalQrOverride } from "@elizaos/plugin-signal";
+export { applyWhatsAppQrOverride, handleWhatsAppRoute, } from "@elizaos/plugin-whatsapp";
+export { handleTriggerRoutes, } from "@elizaos/plugin-workflow";
+export * from "./accounts-routes.js";
+export * from "./agent-admin-routes.js";
+export * from "./agent-lifecycle-routes.js";
+export * from "./agent-model.js";
+export * from "./agent-transfer-routes.js";
+export * from "./apps-routes.js";
+export * from "./auth-routes.js";
+export * from "./bug-report-routes.js";
+export * from "./character-routes.js";
+export * from "./compat-utils.js";
+export * from "./connector-health.js";
+export * from "./credit-detection.js";
+export * from "./database.js";
+export * from "./diagnostics-routes.js";
+export * from "./documents-routes.js";
+export * from "./documents-service-loader.js";
+export * from "./early-logs.js";
+export * from "./memory-bounds.js";
+export * from "./memory-routes.js";
+export * from "./models-routes.js";
+export * from "./nfa-routes.js";
+export * from "./parse-action-block.js";
+export * from "./permission-request-prompt.js";
+export * from "./permissions-routes.js";
+export * from "./plugin-validation.js";
+export * from "./provider-switch-config.js";
+export * from "./rate-limiter.js";
+export * from "./registry-routes.js";
+export * from "./registry-service.js";
+// `runtime-plugin-routes.ts` exports `matchPluginRoutePath` (used by plugin
+// authors and their tests, e.g. plugins/app-vincent/src/vincent-plugin-dispatch.test.ts)
+// and the request-handling helper `tryHandleRuntimePluginRoute` (used by
+// agent runtime wiring). Both are part of the public agent surface.
+export { matchPluginRoutePath, tryHandleRuntimePluginRoute, } from "./runtime-plugin-routes.js";
+export * from "./subscription-routes.js";
+export * from "./terminal-run-limits.js";
+export * from "./training-backend-check.js";
+export * from "./training-service-like.js";
+export * from "./tx-service.js";
+export * from "./wallet.js";
+export * from "./wallet-evm-balance.js";
+export * from "./wallet-routes.js";
+export * from "./wallet-rpc.js";
+export * from "./wallet-trading-profile.js";
+export * from "./zip-utils.js";

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

@@ -1,5 +1,5 @@
 import { type AgentRuntime } from "@elizaos/core";
-import type { RouteRequestContext } from "./route-helpers";
+import type { RouteRequestContext } from "@elizaos/shared";
 export interface MemoryRouteContext extends RouteRequestContext {
     url: URL;
     runtime: AgentRuntime | null;

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

@@ -1 +1 @@
-{"version":3,"file":"memory-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/memory-routes.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,YAAY,EAOlB,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAU3D,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,GAAG,EAAE,GAAG,CAAC;IACT,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAiMD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,OAAO,CAAC,CA+HlB"}
+{"version":3,"file":"memory-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/memory-routes.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,YAAY,EASlB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AA4B3D,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,GAAG,EAAE,GAAG,CAAC;IACT,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AA8RD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,OAAO,CAAC,CA2VlB"}

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

@@ -1,14 +1,25 @@
 import crypto from "node:crypto";
-import { ChannelType, createMessageMemory, ModelType, stringToUuid, } from "@elizaos/core";
-import { parsePositiveInteger } from "../utils/number-parsing";
-import { getKnowledgeService } from "./knowledge-service-loader";
+import { ChannelType, composePrompt, createMessageMemory, ModelType, memoryContextQaTemplate, stringToUuid, } from "@elizaos/core";
+import { parsePositiveInteger } from "../utils/number-parsing.js";
+import { getDocumentsService, } from "./documents-service-loader.js";
 const HASH_MEMORY_SOURCE = "hash_memory";
+const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 const MEMORY_SEARCH_SCAN_LIMIT = 500;
 const MEMORY_SEARCH_DEFAULT_LIMIT = 10;
 const MEMORY_SEARCH_MAX_LIMIT = 50;
 const QUICK_CONTEXT_DEFAULT_LIMIT = 8;
 const QUICK_CONTEXT_MAX_LIMIT = 20;
-const QUICK_CONTEXT_KNOWLEDGE_THRESHOLD = 0.2;
+const QUICK_CONTEXT_DOCUMENTS_THRESHOLD = 0.2;
+const MEMORY_BROWSE_DEFAULT_LIMIT = 50;
+const MEMORY_BROWSE_MAX_LIMIT = 200;
+const MEMORY_FEED_DEFAULT_LIMIT = 50;
+const MEMORY_FEED_MAX_LIMIT = 100;
+const MEMORY_TABLE_NAMES = [
+    "messages",
+    "memories",
+    "facts",
+    "documents",
+];
 function resolveAgentName(runtime, fallbackName) {
     return runtime.character.name?.trim() || fallbackName || "Eliza";
 }
@@ -54,7 +65,7 @@ async function searchMemoryNotes(runtime, roomId, query, limit) {
     const memories = await runtime.getMemories({
         roomId,
         tableName: "messages",
-        count: MEMORY_SEARCH_SCAN_LIMIT,
+        limit: MEMORY_SEARCH_SCAN_LIMIT,
     });
     const hits = [];
     for (const memory of memories) {
@@ -81,10 +92,10 @@ async function searchMemoryNotes(runtime, roomId, query, limit) {
     });
     return hits.slice(0, limit);
 }
-async function searchKnowledge(runtime, query, limit) {
-    const knowledge = await getKnowledgeService(runtime);
-    const knowledgeService = knowledge.service;
-    if (!knowledgeService || !runtime.agentId)
+async function searchDocuments(runtime, query, limit) {
+    const documents = await getDocumentsService(runtime);
+    const documentsService = documents.service;
+    if (!documentsService || !runtime.agentId)
         return [];
     const agentId = runtime.agentId;
     const searchMessage = {
@@ -95,11 +106,11 @@ async function searchKnowledge(runtime, query, limit) {
         content: { text: query },
         createdAt: Date.now(),
     };
-    const matches = await knowledgeService.getKnowledge(searchMessage, {
+    const matches = await documentsService.searchDocuments(searchMessage, {
         roomId: agentId,
     });
     return matches
-        .filter((match) => (match.similarity ?? 0) >= QUICK_CONTEXT_KNOWLEDGE_THRESHOLD)
+        .filter((match) => (match.similarity ?? 0) >= QUICK_CONTEXT_DOCUMENTS_THRESHOLD)
         .slice(0, limit)
         .map((match) => {
         const metadata = match.metadata;
@@ -122,34 +133,83 @@ async function searchKnowledge(runtime, query, limit) {
     });
 }
 function buildQuickContextPrompt(params) {
-    const { query, memories, knowledge } = params;
+    const { query, memories, documents } = params;
     const memorySection = memories.length > 0
         ? memories
             .map((item, index) => `- [M${index + 1}] ${item.text}`)
             .join("\n")
         : "- none";
-    const knowledgeSection = knowledge.length > 0
-        ? knowledge
-            .map((item, index) => `- [K${index + 1}] ${item.text}`)
+    const documentsSection = documents.length > 0
+        ? documents
+            .map((item, index) => `- [D${index + 1}] ${item.text}`)
             .join("\n")
         : "- none";
-    return [
-        "You are a concise context assistant.",
-        "Answer only from the provided context. If context is insufficient, say so explicitly.",
-        "Keep the answer under 120 words.",
-        "",
-        `Query: ${query}`,
-        "",
-        "Saved memory notes:",
-        memorySection,
-        "",
-        "Knowledge snippets:",
-        knowledgeSection,
-    ].join("\n");
+    return composePrompt({
+        state: { query, memorySection, knowledgeSection: documentsSection },
+        template: memoryContextQaTemplate,
+    });
+}
+function memoryToBrowseItem(memory) {
+    const content = memory.content;
+    return {
+        id: memory.id ?? "",
+        type: memory._table,
+        text: content?.text ?? "",
+        entityId: memory.entityId ?? null,
+        roomId: memory.roomId ?? null,
+        agentId: memory.agentId ?? null,
+        createdAt: memory.createdAt ?? 0,
+        metadata: memory.metadata ?? null,
+        source: content?.source ?? null,
+    };
+}
+function hasBrowsableContent(memory) {
+    const text = memory.content?.text;
+    return typeof text === "string" && text.trim().length > 0;
+}
+async function fetchMemoriesFromTables(runtime, params) {
+    const tables = params.tables ?? MEMORY_TABLE_NAMES;
+    const perTableLimit = Math.max(Math.ceil((params.limit ?? MEMORY_BROWSE_DEFAULT_LIMIT) * 2), 200);
+    const allMemories = [];
+    for (const tableName of tables) {
+        const memories = await runtime.getMemories({
+            agentId: runtime.agentId,
+            roomId: params.roomId,
+            tableName,
+            limit: perTableLimit,
+        });
+        for (const m of memories) {
+            allMemories.push(Object.assign(m, { _table: tableName }));
+        }
+    }
+    // The DB adapter ignores entityId in getMemories (used only for RLS
+    // context). Post-filter here so person-centric views actually work.
+    const entitySet = params.entityIds;
+    let filtered = allMemories;
+    if (entitySet && entitySet.length > 0) {
+        const ids = new Set(entitySet);
+        filtered = allMemories.filter((m) => m.entityId && ids.has(m.entityId));
+    }
+    filtered = filtered.filter(hasBrowsableContent);
+    const beforeTs = params.before;
+    if (beforeTs) {
+        return filtered.filter((m) => (m.createdAt ?? 0) < beforeTs);
+    }
+    return filtered;
+}
+function resolveTableFilter(typeParam) {
+    if (!typeParam)
+        return undefined;
+    const t = typeParam.toLowerCase();
+    if (MEMORY_TABLE_NAMES.includes(t)) {
+        return [t];
+    }
+    return undefined;
 }
 export async function handleMemoryRoutes(ctx) {
     const { req, res, method, pathname, url, runtime, agentName, json, error, readJsonBody, } = ctx;
     if (!pathname.startsWith("/api/memory") &&
+        !pathname.startsWith("/api/memories") &&
         pathname !== "/api/context/quick") {
         return false;
     }
@@ -213,29 +273,202 @@ export async function handleMemoryRoutes(ctx) {
         }
         const requestedLimit = parsePositiveInteger(url.searchParams.get("limit"), QUICK_CONTEXT_DEFAULT_LIMIT);
         const limit = Math.min(Math.max(requestedLimit, 1), QUICK_CONTEXT_MAX_LIMIT);
-        const [memories, knowledge] = await Promise.all([
+        const [memories, documents] = await Promise.all([
             searchMemoryNotes(runtime, roomId, query, limit),
-            searchKnowledge(runtime, query, limit),
+            searchDocuments(runtime, query, limit),
         ]);
-        const prompt = buildQuickContextPrompt({ query, memories, knowledge });
+        const prompt = buildQuickContextPrompt({ query, memories, documents });
         let answer = "I couldn't generate a quick answer right now.";
-        try {
-            const response = await runtime.useModel(ModelType.TEXT_SMALL, { prompt });
-            const text = typeof response === "string" ? response : String(response);
-            if (text.trim()) {
-                answer = text.trim();
-            }
-        }
-        catch {
-            // Keep fallback answer.
+        const response = await runtime.useModel(ModelType.TEXT_SMALL, { prompt });
+        const text = typeof response === "string" ? response : String(response);
+        if (text.trim()) {
+            answer = text.trim();
         }
         json(res, {
             query,
             answer,
             memories,
-            knowledge,
+            documents,
+        });
+        return true;
+    }
+    // ── Memory Viewer endpoints ───────────────────────────────────────────
+    if (method === "GET" && pathname === "/api/memories/feed") {
+        const requestedLimit = parsePositiveInteger(url.searchParams.get("limit"), MEMORY_FEED_DEFAULT_LIMIT);
+        const limit = Math.min(Math.max(requestedLimit, 1), MEMORY_FEED_MAX_LIMIT);
+        const beforeParam = url.searchParams.get("before");
+        const before = beforeParam ? Number(beforeParam) : undefined;
+        const tables = resolveTableFilter(url.searchParams.get("type"));
+        const allMemories = await fetchMemoriesFromTables(runtime, {
+            tables,
+            limit: limit * 2,
+            before,
+        });
+        allMemories.sort((a, b) => (b.createdAt ?? 0) - (a.createdAt ?? 0));
+        const items = allMemories.slice(0, limit).map(memoryToBrowseItem);
+        json(res, {
+            memories: items,
+            count: items.length,
+            limit,
+            hasMore: allMemories.length > limit,
+        });
+        return true;
+    }
+    if (method === "GET" && pathname === "/api/memories/browse") {
+        const requestedLimit = parsePositiveInteger(url.searchParams.get("limit"), MEMORY_BROWSE_DEFAULT_LIMIT);
+        const limit = Math.min(Math.max(requestedLimit, 1), MEMORY_BROWSE_MAX_LIMIT);
+        const offset = parsePositiveInteger(url.searchParams.get("offset"), 0);
+        const tables = resolveTableFilter(url.searchParams.get("type"));
+        const entityIdParam = url.searchParams.get("entityId");
+        const entityIdsParam = url.searchParams.get("entityIds");
+        const roomIdParam = url.searchParams.get("roomId");
+        const searchQuery = url.searchParams.get("q")?.trim() ?? "";
+        const entityIds = entityIdsParam
+            ? entityIdsParam
+                .split(",")
+                .map((id) => id.trim())
+                .filter(Boolean)
+            : entityIdParam
+                ? [entityIdParam]
+                : undefined;
+        const allMemories = await fetchMemoriesFromTables(runtime, {
+            tables,
+            entityIds,
+            roomId: roomIdParam ? roomIdParam : undefined,
+            limit: limit + offset + 100,
+        });
+        allMemories.sort((a, b) => (b.createdAt ?? 0) - (a.createdAt ?? 0));
+        let filtered = allMemories;
+        if (searchQuery) {
+            filtered = allMemories.filter((m) => {
+                const text = m.content?.text ?? "";
+                return scoreMemoryText(text, searchQuery) > 0;
+            });
+        }
+        const total = filtered.length;
+        const page = filtered.slice(offset, offset + limit).map(memoryToBrowseItem);
+        json(res, {
+            memories: page,
+            total,
+            limit,
+            offset,
+        });
+        return true;
+    }
+    if (method === "GET" && pathname.startsWith("/api/memories/by-entity/")) {
+        const primaryEntityId = decodeURIComponent(pathname.slice("/api/memories/by-entity/".length));
+        if (!primaryEntityId) {
+            error(res, "Missing entity identifier.", 400);
+            return true;
+        }
+        // Support multi-identity people: ?entityIds=id1,id2,id3
+        // Falls back to the single path param if not provided.
+        const entityIdsParam = url.searchParams.get("entityIds");
+        const entityIds = entityIdsParam
+            ? entityIdsParam
+                .split(",")
+                .map((id) => id.trim())
+                .filter(Boolean)
+            : [primaryEntityId];
+        const requestedLimit = parsePositiveInteger(url.searchParams.get("limit"), MEMORY_BROWSE_DEFAULT_LIMIT);
+        const limit = Math.min(Math.max(requestedLimit, 1), MEMORY_BROWSE_MAX_LIMIT);
+        const offset = parsePositiveInteger(url.searchParams.get("offset"), 0);
+        const tables = resolveTableFilter(url.searchParams.get("type"));
+        const allMemories = await fetchMemoriesFromTables(runtime, {
+            entityIds,
+            tables,
+            limit: limit + offset + 100,
+        });
+        allMemories.sort((a, b) => (b.createdAt ?? 0) - (a.createdAt ?? 0));
+        const total = allMemories.length;
+        const page = allMemories
+            .slice(offset, offset + limit)
+            .map(memoryToBrowseItem);
+        json(res, {
+            entityId: primaryEntityId,
+            memories: page,
+            total,
+            limit,
+            offset,
         });
         return true;
     }
+    // ── Memory mutation by id ─────────────────────────────────────────────
+    // DELETE /api/memories/:id and PATCH /api/memories/:id operate on the bare
+    // id segment. Path matching only fires when the segment looks like a UUID,
+    // which keeps the literal sibling routes (`feed`, `browse`, `stats`,
+    // `by-entity/...`) unambiguous.
+    const memoryIdMatch = /^\/api\/memories\/([^/]+)$/.exec(pathname);
+    if (memoryIdMatch && (method === "DELETE" || method === "PATCH")) {
+        const rawId = decodeURIComponent(memoryIdMatch[1] ?? "");
+        if (!UUID_REGEX.test(rawId)) {
+            error(res, "Invalid memory id.", 400);
+            return true;
+        }
+        const memoryId = rawId;
+        const existing = await runtime.getMemoryById(memoryId);
+        if (!existing) {
+            error(res, "Memory not found.", 404);
+            return true;
+        }
+        if (method === "DELETE") {
+            await runtime.deleteMemory(memoryId);
+            json(res, { deleted: true, id: memoryId });
+            return true;
+        }
+        // PATCH — update text, regenerate embedding, then atomically persist
+        // both via runtime.updateMemory (the SQL adapter writes content +
+        // embedding in a single transaction). If embedding generation fails we
+        // return 500 *before* touching the database, so there is nothing to roll
+        // back.
+        const body = await readJsonBody(req, res);
+        if (!body)
+            return true;
+        const text = typeof body.text === "string" ? body.text.trim() : "";
+        if (!text) {
+            error(res, "text is required", 400);
+            return true;
+        }
+        const existingContent = existing.content ?? {};
+        const nextContent = { ...existingContent, text };
+        let embedding;
+        try {
+            embedding = await runtime.useModel(ModelType.TEXT_EMBEDDING, {
+                text,
+            });
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            error(res, `Failed to regenerate embedding: ${detail}`, 500);
+            return true;
+        }
+        if (!Array.isArray(embedding) || embedding.length === 0) {
+            error(res, "Embedding model returned no vector.", 500);
+            return true;
+        }
+        await runtime.updateMemory({
+            id: memoryId,
+            content: nextContent,
+            embedding,
+        });
+        const updated = await runtime.getMemoryById(memoryId);
+        json(res, { updated: true, id: memoryId, memory: updated });
+        return true;
+    }
+    if (method === "GET" && pathname === "/api/memories/stats") {
+        const counts = {};
+        let total = 0;
+        for (const tableName of MEMORY_TABLE_NAMES) {
+            const memories = await runtime.getMemories({
+                agentId: runtime.agentId,
+                tableName,
+                limit: 10000,
+            });
+            counts[tableName] = memories.length;
+            total += memories.length;
+        }
+        json(res, { total, byType: counts });
+        return true;
+    }
     return false;
 }