@elizaos/agent 2.0.0-alpha.223 → 2.0.0-alpha.333

package/apps/app-knowledge/src/document-presenter.d.ts

@@ -0,0 +1,43 @@
+import type { Memory } from "@elizaos/core";
+export type KnowledgeDocumentProvenanceKind = "upload" | "learned" | "character" | "url" | "youtube" | "bundled" | "unknown";
+export interface KnowledgeDocumentProvenance {
+    kind: KnowledgeDocumentProvenanceKind;
+    label: string;
+    detail?: string;
+}
+export interface PresentedKnowledgeDocument {
+    id: string;
+    filename: string;
+    contentType: string;
+    fileSize: number;
+    createdAt: number;
+    fragmentCount: number;
+    source: KnowledgeDocumentProvenanceKind;
+    url?: string;
+    provenance: KnowledgeDocumentProvenance;
+    canEditText: boolean;
+    editabilityReason?: string;
+    canDelete: boolean;
+    deleteabilityReason?: string;
+    content?: {
+        text?: string;
+    };
+}
+export declare function normalizeKnowledgeSource(source: unknown): KnowledgeDocumentProvenanceKind;
+export declare function getKnowledgeDocumentProvenance(metadata: Record<string, unknown> | undefined): KnowledgeDocumentProvenance;
+export declare function getKnowledgeDocumentContentType(metadata: Record<string, unknown> | undefined): string;
+export declare function getKnowledgeDocumentTitleFromMetadata(metadata: Record<string, unknown> | undefined, contentText?: string): string;
+export declare function isKnowledgeDocumentTextBacked(memory: Memory): boolean;
+export declare function getKnowledgeDocumentPreviewText(memory: Memory): string | undefined;
+export declare function getKnowledgeDocumentEditability(memory: Memory): {
+    canEditText: boolean;
+    reason?: string;
+};
+export declare function getKnowledgeDocumentDeleteability(memory: Memory): {
+    canDelete: boolean;
+    reason?: string;
+};
+export declare function presentKnowledgeDocument(memory: Memory, fragmentCount: number, options?: {
+    includeContent?: boolean;
+}): PresentedKnowledgeDocument;
+//# sourceMappingURL=document-presenter.d.ts.map

package/apps/app-knowledge/src/document-presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-presenter.d.ts","sourceRoot":"","sources":["../../../../../../apps/app-knowledge/src/document-presenter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,MAAM,+BAA+B,GACvC,QAAQ,GACR,SAAS,GACT,WAAW,GACX,KAAK,GACL,SAAS,GACT,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,+BAA+B,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,+BAA+B,CAAC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,2BAA2B,CAAC;IACxC,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7B;AAgJD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,OAAO,GACd,+BAA+B,CAkBjC;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC5C,2BAA2B,CA8B7B;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC5C,MAAM,CAIR;AAED,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC7C,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAmBR;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAqBrE;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,SAAS,CAQpB;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG;IAC/D,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CA2BA;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,MAAM,GAAG;IACjE,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAiBA;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GACrC,0BAA0B,CA6B5B"}

package/apps/app-knowledge/src/document-presenter.js

@@ -0,0 +1,284 @@
+const BINARY_CONTENT_TYPE_PREFIXES = [
+    "application/pdf",
+    "application/msword",
+    "application/vnd.openxmlformats-officedocument",
+    "application/vnd.ms-excel",
+    "application/vnd.ms-powerpoint",
+    "application/octet-stream",
+    "image/",
+    "audio/",
+    "video/",
+];
+const BINARY_FILE_EXTENSIONS = new Set([
+    "pdf",
+    "doc",
+    "docx",
+    "xls",
+    "xlsx",
+    "ppt",
+    "pptx",
+    "zip",
+    "rar",
+    "7z",
+    "jpg",
+    "jpeg",
+    "png",
+    "gif",
+    "bmp",
+    "svg",
+    "webp",
+    "mp3",
+    "wav",
+    "mp4",
+    "mov",
+    "avi",
+]);
+function asRecord(value) {
+    return value && typeof value === "object"
+        ? value
+        : undefined;
+}
+function asString(value) {
+    return typeof value === "string" && value.trim().length > 0
+        ? value.trim()
+        : undefined;
+}
+function asNumber(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value === "string") {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    return undefined;
+}
+function truncateLabel(value, maxLength = 80) {
+    return value.length > maxLength
+        ? `${value.slice(0, maxLength - 1).trimEnd()}…`
+        : value;
+}
+function stripMarkdownPrefix(line) {
+    return line
+        .replace(/^#+\s*/, "")
+        .replace(/^[-*]\s+/, "")
+        .replace(/^\d+[.)]\s+/, "")
+        .trim();
+}
+function deriveTitleFromText(text, fallback = "Untitled") {
+    if (!text)
+        return fallback;
+    const lines = text
+        .replace(/\r\n/g, "\n")
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+    for (const line of lines) {
+        if (/^path:\s+/i.test(line))
+            continue;
+        const candidate = stripMarkdownPrefix(line);
+        if (candidate.length > 0) {
+            return truncateLabel(candidate);
+        }
+    }
+    return fallback;
+}
+function looksLikeBase64(text) {
+    const clean = text.replace(/\s/g, "");
+    if (clean.length < 16 || clean.length % 4 !== 0)
+        return false;
+    if (!/^[A-Za-z0-9+/]*={0,2}$/.test(clean))
+        return false;
+    return /[a-z]/.test(clean) && (/[A-Z]/.test(clean) || /\d/.test(clean));
+}
+function getFilenameExtension(filename) {
+    if (!filename)
+        return undefined;
+    const dotIndex = filename.lastIndexOf(".");
+    if (dotIndex <= 0 || dotIndex === filename.length - 1)
+        return undefined;
+    return filename.slice(dotIndex + 1).toLowerCase();
+}
+function isBinaryLike(contentType, filename) {
+    const normalizedContentType = contentType?.toLowerCase();
+    if (normalizedContentType &&
+        BINARY_CONTENT_TYPE_PREFIXES.some((prefix) => normalizedContentType.startsWith(prefix))) {
+        return true;
+    }
+    const extension = getFilenameExtension(filename);
+    return extension ? BINARY_FILE_EXTENSIONS.has(extension) : false;
+}
+function isGenericFilename(filename, provenanceKind) {
+    if (!filename)
+        return true;
+    const normalized = filename.toLowerCase();
+    if (normalized === "knowledge-note.txt")
+        return true;
+    if (provenanceKind === "learned" && normalized === "user-knowledge.txt") {
+        return true;
+    }
+    return false;
+}
+export function normalizeKnowledgeSource(source) {
+    switch (source) {
+        case "upload":
+        case "rag-service-main-upload":
+            return "upload";
+        case "learned":
+            return "learned";
+        case "character":
+            return "character";
+        case "url":
+            return "url";
+        case "youtube":
+            return "youtube";
+        case "eliza-default-knowledge":
+            return "bundled";
+        default:
+            return "unknown";
+    }
+}
+export function getKnowledgeDocumentProvenance(metadata) {
+    const kind = normalizeKnowledgeSource(metadata?.source);
+    switch (kind) {
+        case "upload":
+            return { kind, label: "Manual upload" };
+        case "learned":
+            return { kind, label: "Learned knowledge" };
+        case "character":
+            return {
+                kind,
+                label: "Character knowledge",
+                detail: asString(metadata?.path),
+            };
+        case "url":
+            return {
+                kind,
+                label: "Imported URL",
+                detail: asString(metadata?.url),
+            };
+        case "youtube":
+            return {
+                kind,
+                label: "YouTube transcript",
+                detail: asString(metadata?.url),
+            };
+        case "bundled":
+            return { kind, label: "Bundled knowledge" };
+        default:
+            return { kind, label: "Knowledge document" };
+    }
+}
+export function getKnowledgeDocumentContentType(metadata) {
+    return (asString(metadata?.fileType) ?? asString(metadata?.contentType) ?? "unknown");
+}
+export function getKnowledgeDocumentTitleFromMetadata(metadata, contentText) {
+    const provenance = getKnowledgeDocumentProvenance(metadata);
+    const filename = asString(metadata?.filename);
+    const title = asString(metadata?.title);
+    const originalFilename = asString(metadata?.originalFilename);
+    const url = asString(metadata?.url);
+    if (filename && !isGenericFilename(filename, provenance.kind)) {
+        return filename;
+    }
+    if (title)
+        return title;
+    if (originalFilename &&
+        !isGenericFilename(originalFilename, provenance.kind)) {
+        return originalFilename;
+    }
+    if (url)
+        return url;
+    return deriveTitleFromText(contentText, "Untitled");
+}
+export function isKnowledgeDocumentTextBacked(memory) {
+    const metadata = asRecord(memory.metadata);
+    if (typeof metadata?.textBacked === "boolean") {
+        return metadata.textBacked;
+    }
+    const filename = getKnowledgeDocumentTitleFromMetadata(metadata, memory.content?.text);
+    const contentType = getKnowledgeDocumentContentType(metadata);
+    if (isBinaryLike(contentType, filename)) {
+        return false;
+    }
+    const contentText = memory.content?.text;
+    if (typeof contentText !== "string" || contentText.trim().length === 0) {
+        return false;
+    }
+    return !looksLikeBase64(contentText);
+}
+export function getKnowledgeDocumentPreviewText(memory) {
+    const contentText = memory.content?.text;
+    if (typeof contentText !== "string")
+        return undefined;
+    const trimmed = contentText.trim();
+    if (trimmed.length === 0 || looksLikeBase64(trimmed)) {
+        return undefined;
+    }
+    return trimmed;
+}
+export function getKnowledgeDocumentEditability(memory) {
+    const metadata = asRecord(memory.metadata);
+    const provenance = getKnowledgeDocumentProvenance(metadata);
+    if (provenance.kind === "bundled") {
+        return {
+            canEditText: false,
+            reason: "Bundled knowledge is seeded by the runtime.",
+        };
+    }
+    if (provenance.kind === "character") {
+        return {
+            canEditText: false,
+            reason: "Character knowledge comes from source files or character config.",
+        };
+    }
+    if (!isKnowledgeDocumentTextBacked(memory)) {
+        return {
+            canEditText: false,
+            reason: "Only text-backed knowledge can be edited here.",
+        };
+    }
+    return { canEditText: true };
+}
+export function getKnowledgeDocumentDeleteability(memory) {
+    const provenance = getKnowledgeDocumentProvenance(asRecord(memory.metadata));
+    if (provenance.kind === "bundled") {
+        return {
+            canDelete: false,
+            reason: "Bundled knowledge is recreated by the runtime.",
+        };
+    }
+    if (provenance.kind === "character") {
+        return {
+            canDelete: false,
+            reason: "Character knowledge is backed by the character source.",
+        };
+    }
+    return { canDelete: true };
+}
+export function presentKnowledgeDocument(memory, fragmentCount, options) {
+    const metadata = asRecord(memory.metadata);
+    const provenance = getKnowledgeDocumentProvenance(metadata);
+    const contentType = getKnowledgeDocumentContentType(metadata);
+    const previewText = options?.includeContent
+        ? getKnowledgeDocumentPreviewText(memory)
+        : undefined;
+    const editability = getKnowledgeDocumentEditability(memory);
+    const deleteability = getKnowledgeDocumentDeleteability(memory);
+    return {
+        id: String(memory.id ?? ""),
+        filename: getKnowledgeDocumentTitleFromMetadata(metadata, memory.content?.text),
+        contentType,
+        fileSize: asNumber(metadata?.fileSize) ?? 0,
+        createdAt: asNumber(memory.createdAt) ?? 0,
+        fragmentCount,
+        source: provenance.kind,
+        url: asString(metadata?.url),
+        provenance,
+        canEditText: editability.canEditText,
+        editabilityReason: editability.reason,
+        canDelete: deleteability.canDelete,
+        deleteabilityReason: deleteability.reason,
+        ...(previewText ? { content: { text: previewText } } : {}),
+    };
+}

package/apps/app-knowledge/src/routes.d.ts

@@ -1,5 +1,5 @@
-import type { AgentRuntime } from "@elizaos/core";
 import type { RouteHelpers, RouteRequestContext } from "@elizaos/agent/api/route-helpers";
+import type { AgentRuntime } from "@elizaos/core";
 export type KnowledgeRouteHelpers = RouteHelpers;
 export interface KnowledgeRouteContext extends RouteRequestContext {
     url: URL;

package/apps/app-knowledge/src/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../../../apps/app-knowledge/src/routes.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,eAAe,CAAC;AAahE,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE1F,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAEjD,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,GAAG,EAAE,GAAG,CAAC;IACT,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;CAC9B;AA0JD,KAAK,iBAAiB,GAAG;IACvB,MAAM,EAAE,GAAG,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AA0GtE,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,eAAe,GAAG,IAAI,GAC3B,IAAI,CAEN;AAsWD,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,OAAO,CAAC,CA6lBlB"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../../../apps/app-knowledge/src/routes.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACpB,MAAM,kCAAkC,CAAC;AAS1C,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,eAAe,CAAC;AAahE,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAEjD,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,GAAG,EAAE,GAAG,CAAC;IACT,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;CAC9B;AAyKD,KAAK,iBAAiB,GAAG;IACvB,MAAM,EAAE,GAAG,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AA0GtE,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,eAAe,GAAG,IAAI,GAC3B,IAAI,CAEN;AAsWD,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,OAAO,CAAC,CAypBlB"}

package/apps/app-knowledge/src/routes.js

@@ -5,6 +5,7 @@ import net from "node:net";
 import { Readable } from "node:stream";
 import { isBlockedPrivateOrLinkLocalIp, normalizeHostLike, } from "@elizaos/agent/security/network-policy";
 import { parseClampedFloat, parsePositiveInteger, } from "@elizaos/agent/utils/number-parsing";
+import { getKnowledgeDocumentDeleteability, getKnowledgeDocumentEditability, getKnowledgeDocumentProvenance, getKnowledgeDocumentTitleFromMetadata, presentKnowledgeDocument, } from "./document-presenter.js";
 import { getKnowledgeService, } from "./service-loader.js";
 const FRAGMENT_COUNT_BATCH_SIZE = 500;
 const KNOWLEDGE_UPLOAD_MAX_BODY_BYTES = 32 * 1_048_576; // 32 MB
@@ -17,16 +18,23 @@ const BLOCKED_HOST_LITERALS = new Set([
     "localhost",
     "metadata.google.internal",
 ]);
-function toSafeNumber(value, fallback) {
-    if (typeof value === "number" && Number.isFinite(value)) {
-        return value;
-    }
-    if (typeof value === "string") {
-        const parsed = Number(value);
-        if (Number.isFinite(parsed))
-            return parsed;
+function isTextBackedContentType(contentType, filename) {
+    if (contentType.startsWith("text/"))
+        return true;
+    if (contentType === "application/json" ||
+        contentType === "application/xml" ||
+        contentType === "application/javascript" ||
+        contentType === "text/markdown") {
+        return true;
     }
-    return fallback;
+    const lowerFilename = filename.toLowerCase();
+    return (lowerFilename.endsWith(".md") ||
+        lowerFilename.endsWith(".mdx") ||
+        lowerFilename.endsWith(".txt") ||
+        lowerFilename.endsWith(".json") ||
+        lowerFilename.endsWith(".xml") ||
+        lowerFilename.endsWith(".csv") ||
+        lowerFilename.endsWith(".tsv"));
 }
 function hasUuidId(memory) {
     return typeof memory.id === "string" && memory.id.length > 0;
@@ -521,12 +529,10 @@ export async function handleKnowledgeRoutes(ctx) {
     if (method === "GET" && pathname === "/api/knowledge") {
         const documentCount = await knowledgeService.countMemories({
             tableName: "documents",
-            roomId: agentId,
             unique: false,
         });
         const fragmentCount = await knowledgeService.countMemories({
             tableName: "knowledge",
-            roomId: agentId,
             unique: false,
         });
         json(res, {
@@ -542,12 +548,10 @@ export async function handleKnowledgeRoutes(ctx) {
     if (method === "GET" && pathname === "/api/knowledge/stats") {
         const documentCount = await knowledgeService.countMemories({
             tableName: "documents",
-            roomId: agentId,
             unique: false,
         });
         const fragmentCount = await knowledgeService.countMemories({
             tableName: "knowledge",
-            roomId: agentId,
             unique: false,
         });
         json(res, {
@@ -563,32 +567,19 @@ export async function handleKnowledgeRoutes(ctx) {
         const offset = parsePositiveInteger(url.searchParams.get("offset"), 0);
         const documents = await knowledgeService.getMemories({
             tableName: "documents",
-            roomId: agentId,
             count: limit,
             offset: offset > 0 ? offset : undefined,
         });
-        const documentIds = documents.filter(hasUuidId).map((doc) => doc.id);
-        const fragmentCounts = await mapKnowledgeFragmentsByDocumentId(knowledgeService, agentId, documentIds);
-        // Clean up documents for response (remove embeddings, format metadata)
-        const cleanedDocuments = documents.map((doc) => {
-            const metadata = doc.metadata;
-            const documentId = hasUuidId(doc) ? doc.id : null;
-            return {
-                id: doc.id,
-                filename: metadata?.filename || metadata?.title || "Untitled",
-                contentType: metadata?.fileType || metadata?.contentType || "unknown",
-                fileSize: toSafeNumber(metadata?.fileSize, 0),
-                createdAt: toSafeNumber(doc.createdAt, 0),
-                fragmentCount: documentId !== null && fragmentCounts.has(documentId)
-                    ? (fragmentCounts.get(documentId) ?? 0)
-                    : 0,
-                source: metadata?.source || "upload",
-                url: metadata?.url,
-            };
+        const total = await knowledgeService.countMemories({
+            tableName: "documents",
+            unique: false,
         });
+        const documentIds = documents.filter(hasUuidId).map((doc) => doc.id);
+        const fragmentCounts = await mapKnowledgeFragmentsByDocumentId(knowledgeService, undefined, documentIds);
+        const cleanedDocuments = documents.map((doc) => presentKnowledgeDocument(doc, hasUuidId(doc) ? (fragmentCounts.get(doc.id) ?? 0) : 0));
         json(res, {
             documents: cleanedDocuments,
-            total: cleanedDocuments.length,
+            total,
             limit,
             offset: offset > 0 ? offset : 0,
         });
@@ -598,38 +589,74 @@ export async function handleKnowledgeRoutes(ctx) {
     const docIdMatch = /^\/api\/knowledge\/documents\/([^/]+)$/.exec(pathname);
     if (method === "GET" && docIdMatch) {
         const documentId = decodeURIComponent(docIdMatch[1]);
-        const documents = await knowledgeService.getMemories({
-            tableName: "documents",
-            roomId: agentId,
-            count: 10000,
+        const document = await runtime.getMemoryById(documentId);
+        const documentMetadata = document?.metadata;
+        const isDocument = document?.agentId === agentId &&
+            (documentMetadata?.documentId === documentId ||
+                documentMetadata?.type === "document" ||
+                documentMetadata?.type === "custom");
+        if (!document || !isDocument) {
+            error(res, "Document not found", 404);
+            return true;
+        }
+        const fragmentCount = await countKnowledgeFragmentsForDocument(knowledgeService, undefined, documentId);
+        json(res, {
+            document: presentKnowledgeDocument(document, fragmentCount, {
+                includeContent: true,
+            }),
         });
-        const document = documents.find((d) => d.id === documentId);
-        if (!document) {
+        return true;
+    }
+    if (method === "PATCH" && docIdMatch) {
+        const documentId = decodeURIComponent(docIdMatch[1]);
+        const document = await runtime.getMemoryById(documentId);
+        if (!document || document.agentId !== agentId) {
             error(res, "Document not found", 404);
             return true;
         }
-        // Get fragment count for this document
-        const fragmentCount = await countKnowledgeFragmentsForDocument(knowledgeService, agentId, documentId);
-        const metadata = document.metadata;
+        const editability = getKnowledgeDocumentEditability(document);
+        if (!editability.canEditText) {
+            error(res, editability.reason || "This knowledge document cannot be edited.", 400);
+            return true;
+        }
+        const body = await readJsonBody(req, res, {
+            maxBytes: KNOWLEDGE_UPLOAD_MAX_BODY_BYTES,
+        });
+        if (!body)
+            return true;
+        if (typeof body.content !== "string" || body.content.trim().length === 0) {
+            error(res, "content must be a non-empty string");
+            return true;
+        }
+        if (typeof knowledgeService.updateKnowledgeDocument !== "function") {
+            error(res, "Knowledge document editing is unavailable", 503);
+            return true;
+        }
+        const result = await knowledgeService.updateKnowledgeDocument({
+            documentId,
+            content: body.content,
+        });
         json(res, {
-            document: {
-                id: document.id,
-                filename: metadata?.filename || metadata?.title || "Untitled",
-                contentType: metadata?.fileType || metadata?.contentType || "unknown",
-                fileSize: toSafeNumber(metadata?.fileSize, 0),
-                createdAt: toSafeNumber(document.createdAt, 0),
-                fragmentCount,
-                source: metadata?.source || "upload",
-                url: metadata?.url,
-                content: document.content,
-            },
+            ok: true,
+            documentId: result.documentId,
+            fragmentCount: result.fragmentCount,
         });
         return true;
     }
     // ── DELETE /api/knowledge/documents/:id ─────────────────────────────────
     if (method === "DELETE" && docIdMatch) {
         const documentId = decodeURIComponent(docIdMatch[1]);
-        const fragmentIds = await listKnowledgeFragmentsForDocument(knowledgeService, agentId, documentId);
+        const existingDocument = await runtime.getMemoryById(documentId);
+        if (!existingDocument || existingDocument.agentId !== agentId) {
+            error(res, "Document not found", 404);
+            return true;
+        }
+        const deleteability = getKnowledgeDocumentDeleteability(existingDocument);
+        if (!deleteability.canDelete) {
+            error(res, deleteability.reason || "This knowledge document cannot be deleted.", 400);
+            return true;
+        }
+        const fragmentIds = await listKnowledgeFragmentsForDocument(knowledgeService, undefined, documentId);
         for (const fragmentId of fragmentIds) {
             await knowledgeService.deleteMemory(fragmentId);
         }
@@ -643,8 +670,10 @@ export async function handleKnowledgeRoutes(ctx) {
     }
     async function addKnowledgeDocument(service, document) {
         let content = document.content;
-        let contentType = document.contentType || "text/plain";
+        const originalContentType = document.contentType || "text/plain";
+        let contentType = originalContentType;
         const warnings = [];
+        const textBacked = isTextBackedContentType(originalContentType, document.filename);
         // Image files: the content is base64-encoded binary which can't be
         // text-extracted. Convert to a text description for embedding.
         if (contentType.startsWith("image/")) {
@@ -692,7 +721,15 @@ export async function handleKnowledgeRoutes(ctx) {
             contentType,
             originalFilename: document.filename,
             content,
-            metadata: document.metadata,
+            metadata: {
+                ...document.metadata,
+                source: "upload",
+                filename: document.filename,
+                originalFilename: document.filename,
+                fileType: originalContentType,
+                contentType,
+                textBacked,
+            },
         });
         const warningsValue = result.warnings;
         if (Array.isArray(warningsValue)) {
@@ -835,6 +872,11 @@ export async function handleKnowledgeRoutes(ctx) {
                 ...body.metadata,
                 url: urlToFetch,
                 source: isYouTubeUrl(urlToFetch) ? "youtube" : "url",
+                filename,
+                originalFilename: filename,
+                fileType: contentType,
+                contentType,
+                textBacked: true,
             },
         });
         json(res, {
@@ -869,9 +911,7 @@ export async function handleKnowledgeRoutes(ctx) {
             content: { text: query.trim() },
             createdAt: Date.now(),
         };
-        const results = await knowledgeService.getKnowledge(searchMessage, {
-            roomId: agentId,
-        });
+        const results = await knowledgeService.getKnowledge(searchMessage);
         // Filter by threshold and limit
         const filteredResults = results
             .filter((r) => (r.similarity ?? 0) >= threshold)
@@ -883,7 +923,10 @@ export async function handleKnowledgeRoutes(ctx) {
                 text: r.content?.text || "",
                 similarity: r.similarity,
                 documentId: meta?.documentId,
-                documentTitle: meta?.filename || meta?.title || "",
+                documentTitle: getKnowledgeDocumentTitleFromMetadata(meta, r.content?.text),
+                documentProvenance: meta
+                    ? getKnowledgeDocumentProvenance(meta)
+                    : undefined,
                 position: meta?.position,
             };
         });
@@ -904,7 +947,6 @@ export async function handleKnowledgeRoutes(ctx) {
         while (true) {
             const fragmentBatch = await knowledgeService.getMemories({
                 tableName: "knowledge",
-                roomId: agentId,
                 count: FRAGMENT_COUNT_BATCH_SIZE,
                 offset: fragmentOffset,
             });

package/apps/app-knowledge/src/service-loader.d.ts

@@ -39,6 +39,13 @@ export interface KnowledgeServiceLike {
         roomId?: UUID;
         unique?: boolean;
     }): Promise<number>;
+    updateKnowledgeDocument?(options: {
+        documentId: UUID;
+        content: string;
+    }): Promise<{
+        documentId: UUID;
+        fragmentCount: number;
+    }>;
     deleteMemory(memoryId: UUID): Promise<void>;
 }
 export type KnowledgeLoadFailReason = "timeout" | "runtime_unavailable" | "not_registered";

package/apps/app-knowledge/src/service-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-loader.d.ts","sourceRoot":"","sources":["../../../../../../apps/app-knowledge/src/service-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAW,IAAI,EAAE,MAAM,eAAe,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,OAAO,EAAE;QACpB,OAAO,CAAC,EAAE,IAAI,CAAC;QACf,OAAO,EAAE,IAAI,CAAC;QACd,MAAM,EAAE,IAAI,CAAC;QACb,QAAQ,EAAE,IAAI,CAAC;QACf,gBAAgB,EAAE,IAAI,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,CAAC;QACzB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC;QACV,gBAAgB,EAAE,MAAM,CAAC;QACzB,sBAAsB,EAAE,IAAI,CAAC;QAC7B,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,YAAY,CACV,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,IAAI,CAAA;KAAE,GACzD,OAAO,CACR,KAAK,CAAC;QACJ,EAAE,EAAE,IAAI,CAAC;QACT,OAAO,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC,CACH,CAAC;IACF,WAAW,CAAC,MAAM,EAAE;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,IAAI,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACtB,aAAa,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,IAAI,CAAC;QACd,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpB,YAAY,CAAC,QAAQ,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,MAAM,MAAM,uBAAuB,GAC/B,SAAS,GACT,qBAAqB,GACrB,gBAAgB,CAAC;AAErB,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACrC,MAAM,CAAC,EAAE,uBAAuB,CAAC;CAClC;AAKD,wBAAgB,qBAAqB,IAAI,MAAM,CAM9C;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,YAAY,GAAG,IAAI,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CAwBjC"}
+{"version":3,"file":"service-loader.d.ts","sourceRoot":"","sources":["../../../../../../apps/app-knowledge/src/service-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAW,IAAI,EAAE,MAAM,eAAe,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,OAAO,EAAE;QACpB,OAAO,CAAC,EAAE,IAAI,CAAC;QACf,OAAO,EAAE,IAAI,CAAC;QACd,MAAM,EAAE,IAAI,CAAC;QACb,QAAQ,EAAE,IAAI,CAAC;QACf,gBAAgB,EAAE,IAAI,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,CAAC;QACzB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC;QACV,gBAAgB,EAAE,MAAM,CAAC;QACzB,sBAAsB,EAAE,IAAI,CAAC;QAC7B,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,YAAY,CACV,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,IAAI,CAAA;KAAE,GACzD,OAAO,CACR,KAAK,CAAC;QACJ,EAAE,EAAE,IAAI,CAAC;QACT,OAAO,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC,CACH,CAAC;IACF,WAAW,CAAC,MAAM,EAAE;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,IAAI,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACtB,aAAa,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,IAAI,CAAC;QACd,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpB,uBAAuB,CAAC,CAAC,OAAO,EAAE;QAChC,UAAU,EAAE,IAAI,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC;QACV,UAAU,EAAE,IAAI,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,YAAY,CAAC,QAAQ,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,MAAM,MAAM,uBAAuB,GAC/B,SAAS,GACT,qBAAqB,GACrB,gBAAgB,CAAC;AAErB,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACrC,MAAM,CAAC,EAAE,uBAAuB,CAAC;CAClC;AAKD,wBAAgB,qBAAqB,IAAI,MAAM,CAM9C;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,YAAY,GAAG,IAAI,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CAwBjC"}

package/apps/app-lifeops/src/action.d.ts

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

package/apps/app-lifeops/src/action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../../../../apps/app-lifeops/src/action.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,MAAM,EAMP,MAAM,eAAe,CAAC;AAgXvB,eAAO,MAAM,0BAA0B,EAAE,MAmFxC,CAAC"}
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../../../../apps/app-lifeops/src/action.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,MAAM,EAMP,MAAM,eAAe,CAAC;AAgXvB,eAAO,MAAM,yBAAyB,EAAE,MAmFvC,CAAC"}