@elizaos/agent 2.0.0-alpha.358 → 2.0.0-alpha.376

package/packages/app-core/src/components/pages/knowledge-detail.js

@@ -0,0 +1,149 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Button, PagePanel, Textarea } from "@elizaos/ui";
+import { useEffect, useState } from "react";
+import { client } from "../../api/client";
+import { useApp } from "../../state/useApp";
+import { formatByteSize } from "../../utils/format";
+export function getKnowledgeTypeLabel(contentType) {
+    return contentType?.split("/").pop()?.toUpperCase() || "DOC";
+}
+export function getKnowledgeSourceLabel(source, t) {
+    if (source === "youtube") {
+        return t("knowledgeview.YouTube", { defaultValue: "YouTube" });
+    }
+    if (source === "url") {
+        return t("knowledgeview.FromUrl", { defaultValue: "From URL" });
+    }
+    return t("aria.upload", { defaultValue: "Upload" });
+}
+export function getKnowledgeDocumentSummary(doc, t) {
+    const fragmentLabel = doc.fragmentCount === 1
+        ? t("knowledgeview.FragmentCountOne", {
+            defaultValue: "1 fragment",
+        })
+        : t("knowledgeview.FragmentCountMany", {
+            defaultValue: "{{count}} fragments",
+            count: doc.fragmentCount,
+        });
+    return `${getKnowledgeSourceLabel(doc.source, t)} • ${fragmentLabel} • ${formatByteSize(doc.fileSize)}`;
+}
+function formatKnowledgeTimestamp(value) {
+    if (!value)
+        return null;
+    const timestamp = value < 1_000_000_000_000 ? value * 1000 : value;
+    const date = new Date(timestamp);
+    if (Number.isNaN(date.getTime()))
+        return null;
+    return date.toLocaleDateString(undefined, {
+        month: "short",
+        day: "numeric",
+        year: "numeric",
+    });
+}
+/* ── Document Viewer ────────────────────────────────────────────────── */
+export function DocumentViewer({ documentId, onUpdated, }) {
+    const { t, setActionNotice } = useApp();
+    const [doc, setDoc] = useState(null);
+    const [fragments, setFragments] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const [editing, setEditing] = useState(false);
+    const [draftText, setDraftText] = useState("");
+    const [saving, setSaving] = useState(false);
+    const [reloadToken, setReloadToken] = useState(0);
+    useEffect(() => {
+        const id = documentId ?? "";
+        const refreshToken = reloadToken;
+        void refreshToken;
+        if (!id) {
+            setDoc(null);
+            setFragments([]);
+            setLoading(false);
+            setError(null);
+            setEditing(false);
+            setDraftText("");
+            return;
+        }
+        let cancelled = false;
+        async function load() {
+            setLoading(true);
+            setError(null);
+            const [docRes, fragRes] = await Promise.all([
+                client.getKnowledgeDocument(id),
+                client.getKnowledgeFragments(id),
+            ]);
+            if (cancelled)
+                return;
+            setDoc(docRes.document);
+            setFragments(fragRes.fragments);
+            setDraftText(docRes.document.content?.text ?? "");
+            setEditing(false);
+            setLoading(false);
+        }
+        load().catch((err) => {
+            if (!cancelled) {
+                setError(err instanceof Error
+                    ? err.message
+                    : t("knowledgeview.FailedToLoadDocument", {
+                        defaultValue: "Failed to load document",
+                    }));
+                setLoading(false);
+            }
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [documentId, reloadToken, t]);
+    const previewText = doc?.content?.text?.trim();
+    const documentCreatedLabel = formatKnowledgeTimestamp(doc?.createdAt);
+    const handleSave = async () => {
+        if (!documentId || !doc)
+            return;
+        setSaving(true);
+        try {
+            const result = await client.updateKnowledgeDocument(documentId, {
+                content: draftText,
+            });
+            setActionNotice(t("knowledgeview.DocumentUpdated", {
+                defaultValue: "Updated knowledge document ({{count}} fragments)",
+                count: result.fragmentCount,
+            }), "success", 3000);
+            setEditing(false);
+            setReloadToken((current) => current + 1);
+            onUpdated?.();
+        }
+        catch (saveError) {
+            setActionNotice(saveError instanceof Error
+                ? saveError.message
+                : t("knowledgeview.FailedToUpdateDocument", {
+                    defaultValue: "Failed to update knowledge document",
+                }), "error", 5000);
+        }
+        finally {
+            setSaving(false);
+        }
+    };
+    return (_jsx(PagePanel, { className: "flex flex-col overflow-hidden !rounded-none !border-0 !bg-transparent !shadow-none !ring-0", children: _jsxs("div", { className: "custom-scrollbar flex min-h-0 flex-1 flex-col overflow-y-auto px-4 py-4", children: [loading && (_jsxs("div", { className: "py-10 text-center font-bold tracking-wide text-muted animate-pulse", children: [_jsx("span", { className: "mr-3 inline-block h-4 w-4 animate-spin rounded-full border-2 border-accent border-t-transparent align-middle" }), t("appsview.Loading")] })), error && (_jsx("div", { className: "rounded-xl border border-danger/25 bg-danger/10 py-8 text-center text-sm font-medium text-danger", children: error })), !loading && !error && !doc && (_jsx(PagePanel.Empty, { variant: "inset", className: "px-0 py-12 !rounded-none !border-0 !bg-transparent !shadow-none !ring-0", description: t("knowledgeview.NoDocumentSelectedDesc", {
+                        defaultValue: "Select a document from the list to view its fragments and metadata.",
+                    }), title: t("knowledgeview.NoDocumentSelected", {
+                        defaultValue: "No document selected",
+                    }) })), !loading && !error && doc && (_jsxs("div", { className: "mx-auto flex w-full max-w-4xl flex-col gap-4", children: [_jsxs("div", { className: "px-1", children: [_jsx("h2", { className: "break-words text-lg font-semibold text-txt", children: doc.filename }), _jsxs("div", { className: "mt-2 flex flex-wrap items-center gap-2 text-xs text-muted", children: [_jsx("span", { children: doc.provenance.label }), _jsx("span", { children: "\u2022" }), _jsx("span", { children: formatByteSize(doc.fileSize) }), _jsx("span", { children: "\u2022" }), _jsx("span", { children: doc.fragmentCount === 1
+                                                ? "1 fragment"
+                                                : `${doc.fragmentCount} fragments` }), doc.provenance.detail ? (_jsxs(_Fragment, { children: [_jsx("span", { children: "\u2022" }), _jsx("span", { className: "truncate", children: doc.provenance.detail })] })) : null, _jsx("span", { children: "\u2022" }), _jsx("span", { children: getKnowledgeTypeLabel(doc.contentType) }), documentCreatedLabel ? (_jsxs(_Fragment, { children: [_jsx("span", { children: "\u2022" }), _jsx("span", { children: documentCreatedLabel })] })) : null] }), _jsx("div", { className: "mt-3 flex flex-wrap items-center gap-2", children: doc.canEditText ? (_jsxs(_Fragment, { children: [_jsx(Button, { type: "button", variant: "outline", size: "sm", className: "rounded-lg", onClick: () => setEditing((current) => !current), disabled: saving, children: editing ? "Cancel" : "Edit text" }), editing ? (_jsx(Button, { type: "button", size: "sm", className: "rounded-lg", onClick: () => void handleSave(), disabled: saving || draftText.trim().length === 0, children: saving ? "Saving..." : "Save" })) : null] })) : doc.editabilityReason ? (_jsx("div", { className: "text-xs text-muted", children: doc.editabilityReason })) : null })] }), _jsxs(PagePanel, { variant: "inset", className: "p-4 !rounded-none !border-0 !bg-transparent !shadow-none !ring-0", children: [_jsx("div", { className: "mb-3 text-xs font-semibold uppercase tracking-[0.12em] text-muted/70", children: t("common.preview", { defaultValue: "Preview" }) }), editing ? (_jsx(Textarea, { value: draftText, rows: 16, onChange: (event) => setDraftText(event.target.value), className: "min-h-[20rem] resize-y rounded-xl border-border/40 bg-bg-muted/15 font-mono text-sm leading-relaxed" })) : previewText ? (_jsx("pre", { className: "custom-scrollbar max-h-[16rem] overflow-auto whitespace-pre-wrap break-words text-sm leading-relaxed text-txt/88", children: previewText.slice(0, 2000) })) : (_jsx("div", { className: "py-6 text-center text-xs text-muted", children: t("knowledgeview.NoPreview", {
+                                        defaultValue: "Full text preview is not available",
+                                    }) }))] }), _jsxs(PagePanel, { variant: "inset", className: "p-4 !rounded-none !border-0 !bg-transparent !shadow-none !ring-0", children: [_jsx("div", { className: "mb-3 text-xs font-semibold uppercase tracking-[0.12em] text-muted/70", children: t("knowledgeview.FragmentsLabel", {
+                                        defaultValue: "Fragments",
+                                    }) }), _jsxs("div", { className: "divide-y divide-border/20", children: [fragments.map((fragment, index) => {
+                                            const createdLabel = formatKnowledgeTimestamp(fragment.createdAt);
+                                            return (_jsxs("article", { className: "grid gap-3 py-4 sm:grid-cols-[4rem_minmax(0,1fr)]", children: [_jsxs("div", { className: "flex items-start gap-2 sm:block", children: [_jsx("div", { className: "flex h-8 w-8 items-center justify-center rounded-lg border border-border/35 bg-bg-muted/20 text-xs font-bold text-muted-strong", children: index + 1 }), _jsx("div", { className: "mt-0.5 text-2xs font-semibold uppercase tracking-[0.12em] text-muted/60 sm:mt-2", children: t("knowledgeview.Chunk", {
+                                                                    defaultValue: "Chunk",
+                                                                }) })] }), _jsxs("div", { className: "min-w-0", children: [_jsxs("div", { className: "mb-2 flex flex-wrap items-center gap-2 text-2xs text-muted", children: [fragment.position !== undefined ? (_jsx("span", { children: t("knowledgeview.FragmentPosition", {
+                                                                            defaultValue: "position {{position}}",
+                                                                            position: fragment.position,
+                                                                        }) })) : null, createdLabel ? (_jsxs(_Fragment, { children: [fragment.position !== undefined ? (_jsx("span", { children: "\u2022" })) : null, _jsx("span", { children: createdLabel })] })) : null, (fragment.position !== undefined ||
+                                                                        createdLabel) && _jsx("span", { children: "\u2022" }), _jsx("span", { children: t("knowledgeview.CharacterCount", {
+                                                                            defaultValue: "{{count}} chars",
+                                                                            count: fragment.text.length,
+                                                                        }) })] }), _jsx("p", { className: "whitespace-pre-wrap break-words text-sm leading-relaxed text-txt/90", children: fragment.text })] })] }, fragment.id));
+                                        }), fragments.length === 0 && (_jsx(PagePanel.Empty, { variant: "inset", className: "min-h-[8rem] py-8 !rounded-none !border-0 !bg-transparent !shadow-none !ring-0", title: t("knowledgeview.NoFragmentsFound") }))] })] })] }))] }) }));
+}

package/packages/app-core/src/components/pages/knowledge-upload.d.ts

@@ -0,0 +1,27 @@
+export declare const MAX_UPLOAD_REQUEST_BYTES: number;
+export declare const BULK_UPLOAD_TARGET_BYTES: number;
+export declare const MAX_BULK_REQUEST_DOCUMENTS = 100;
+export declare const LARGE_FILE_WARNING_BYTES: number;
+export declare const SUPPORTED_UPLOAD_EXTENSIONS: Set<string>;
+export declare const KNOWLEDGE_UPLOAD_ACCEPT: string;
+export type KnowledgeUploadFile = File & {
+    webkitRelativePath?: string;
+};
+export type KnowledgeUploadOptions = {
+    includeImageDescriptions: boolean;
+};
+export declare function getKnowledgeUploadFilename(file: KnowledgeUploadFile): string;
+export declare function shouldReadKnowledgeFileAsText(file: Pick<File, "type" | "name">): boolean;
+export declare function isSupportedKnowledgeFile(file: Pick<File, "name">): boolean;
+export declare function UploadZone({ fileInputId, onFilesUpload, onUrlUpload, uploading, uploadStatus, }: {
+    fileInputId?: string;
+    onFilesUpload: (files: KnowledgeUploadFile[], options: KnowledgeUploadOptions) => void;
+    onUrlUpload: (url: string, options: KnowledgeUploadOptions) => void;
+    uploading: boolean;
+    uploadStatus: {
+        current: number;
+        total: number;
+        filename: string;
+    } | null;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=knowledge-upload.d.ts.map

package/packages/app-core/src/components/pages/knowledge-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-upload.d.ts","sourceRoot":"","sources":["../../../../../../../app-core/src/components/pages/knowledge-upload.tsx"],"names":[],"mappings":"AAKA,eAAO,MAAM,wBAAwB,QAAiB,CAAC;AACvD,eAAO,MAAM,wBAAwB,QAAiB,CAAC;AACvD,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,wBAAwB,QAAgB,CAAC;AACtD,eAAO,MAAM,2BAA2B,aAetC,CAAC;AACH,eAAO,MAAM,uBAAuB,QAEzB,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG,IAAI,GAAG;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,wBAAwB,EAAE,OAAO,CAAC;CACnC,CAAC;AA2BF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAE5E;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,GAChC,OAAO,CAeT;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAM1E;AAID,wBAAgB,UAAU,CAAC,EACzB,WAAW,EACX,aAAa,EACb,WAAW,EACX,SAAS,EACT,YAAY,GACb,EAAE;IACD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,CACb,KAAK,EAAE,mBAAmB,EAAE,EAC5B,OAAO,EAAE,sBAAsB,KAC5B,IAAI,CAAC;IACV,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACpE,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC3E,2CAuKA"}

package/packages/app-core/src/components/pages/knowledge-upload.js

@@ -0,0 +1,125 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button, Checkbox, Input } from "@elizaos/ui";
+import { useCallback, useRef, useState } from "react";
+import { useApp } from "../../state/useApp";
+export const MAX_UPLOAD_REQUEST_BYTES = 32 * 1_048_576; // Must match server knowledge route limit
+export const BULK_UPLOAD_TARGET_BYTES = 24 * 1_048_576;
+export const MAX_BULK_REQUEST_DOCUMENTS = 100;
+export const LARGE_FILE_WARNING_BYTES = 8 * 1_048_576;
+export const SUPPORTED_UPLOAD_EXTENSIONS = new Set([
+    ".txt",
+    ".md",
+    ".mdx",
+    ".pdf",
+    ".docx",
+    ".json",
+    ".csv",
+    ".xml",
+    ".html",
+    ".png",
+    ".jpg",
+    ".jpeg",
+    ".webp",
+    ".gif",
+]);
+export const KNOWLEDGE_UPLOAD_ACCEPT = Array.from(SUPPORTED_UPLOAD_EXTENSIONS).join(",");
+const svgBase = {
+    xmlns: "http://www.w3.org/2000/svg",
+    width: 24,
+    height: 24,
+    viewBox: "0 0 24 24",
+    fill: "none",
+    stroke: "currentColor",
+    strokeWidth: 2,
+    strokeLinecap: "round",
+    strokeLinejoin: "round",
+};
+const UploadIcon = ({ className }) => (_jsx("svg", { ...svgBase, className: className, "aria-hidden": "true", children: _jsx("path", { d: "M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4M17 8l-5-5-5 5M12 3v12" }) }));
+const LinkIcon = ({ className }) => (_jsxs("svg", { ...svgBase, className: className, "aria-hidden": "true", children: [_jsx("path", { d: "M10 13a5 5 0 0 0 7.07 0l2.83-2.83a5 5 0 0 0-7.07-7.07L11 4" }), _jsx("path", { d: "M14 11a5 5 0 0 0-7.07 0L4.1 13.83a5 5 0 1 0 7.07 7.07L13 20" })] }));
+export function getKnowledgeUploadFilename(file) {
+    return file.webkitRelativePath?.trim() || file.name;
+}
+export function shouldReadKnowledgeFileAsText(file) {
+    const textTypes = [
+        "text/plain",
+        "text/markdown",
+        "text/html",
+        "text/csv",
+        "application/json",
+        "application/xml",
+    ];
+    return (textTypes.some((t) => file.type.includes(t)) ||
+        file.name.endsWith(".md") ||
+        file.name.endsWith(".mdx"));
+}
+export function isSupportedKnowledgeFile(file) {
+    const lowerName = file.name.toLowerCase();
+    for (const extension of SUPPORTED_UPLOAD_EXTENSIONS) {
+        if (lowerName.endsWith(extension))
+            return true;
+    }
+    return false;
+}
+/* ── Upload Zone ────────────────────────────────────────────────────── */
+export function UploadZone({ fileInputId, onFilesUpload, onUrlUpload, uploading, uploadStatus, }) {
+    const { t } = useApp();
+    const [dragOver, setDragOver] = useState(false);
+    const [urlInput, setUrlInput] = useState("");
+    const [showUrlInput, setShowUrlInput] = useState(false);
+    const [includeImageDescriptions, setIncludeImageDescriptions] = useState(true);
+    const fileInputRef = useRef(null);
+    const handleDrop = useCallback((e) => {
+        e.preventDefault();
+        setDragOver(false);
+        const files = Array.from(e.dataTransfer.files);
+        if (files.length > 0 && !uploading) {
+            onFilesUpload(files, { includeImageDescriptions });
+        }
+    }, [includeImageDescriptions, onFilesUpload, uploading]);
+    const handleFileSelect = useCallback((e) => {
+        const files = e.target.files;
+        if (files && files.length > 0 && !uploading) {
+            onFilesUpload(Array.from(files), {
+                includeImageDescriptions,
+            });
+        }
+        e.target.value = "";
+    }, [includeImageDescriptions, onFilesUpload, uploading]);
+    const handleUrlSubmit = useCallback(() => {
+        const url = urlInput.trim();
+        if (url && !uploading) {
+            onUrlUpload(url, { includeImageDescriptions });
+            setUrlInput("");
+            setShowUrlInput(false);
+        }
+    }, [includeImageDescriptions, urlInput, uploading, onUrlUpload]);
+    return (_jsxs("fieldset", { className: "w-full", onDragOver: (e) => {
+            e.preventDefault();
+            setDragOver(true);
+        }, onDragLeave: () => setDragOver(false), onDrop: handleDrop, "aria-label": t("aria.knowledgeUpload"), children: [_jsx("input", { id: fileInputId, ref: fileInputRef, type: "file", className: "hidden", multiple: true, accept: KNOWLEDGE_UPLOAD_ACCEPT, onChange: handleFileSelect }), _jsxs("div", { className: `rounded-2xl border px-3 py-3 transition-colors ${dragOver
+                    ? "border-accent/45 bg-accent/8 shadow-sm"
+                    : "border-border/35 bg-card/62"} ${uploading ? "opacity-60" : ""}`, children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsxs("div", { className: "flex shrink-0 items-center gap-2", children: [_jsx(Button, { variant: "outline", size: "icon", className: "h-9 w-9 rounded-xl", onClick: () => fileInputRef.current?.click(), disabled: uploading, "aria-label": t("knowledgeview.ChooseFiles", {
+                                            defaultValue: "Choose files",
+                                        }), title: t("knowledgeview.ChooseFiles", {
+                                            defaultValue: "Choose files",
+                                        }), children: _jsx(UploadIcon, { className: "h-4 w-4" }) }), _jsx(Button, { variant: "outline", size: "icon", className: `h-9 w-9 rounded-xl ${showUrlInput ? "border-accent/45 bg-accent/12 text-txt" : ""}`, onClick: () => setShowUrlInput((current) => !current), disabled: uploading, "aria-label": t("knowledgeview.AddFromURL", {
+                                            defaultValue: "Add from URL",
+                                        }), title: t("knowledgeview.AddFromURL", {
+                                            defaultValue: "Add from URL",
+                                        }), children: _jsx(LinkIcon, { className: "h-4 w-4" }) })] }), _jsx("div", { className: "min-w-0 flex-1 text-xs-tight text-muted-strong", children: uploadStatus
+                                    ? t("knowledgeview.UploadingProgress", {
+                                        defaultValue: "Uploading {{current}}/{{total}}{{filename}}",
+                                        current: uploadStatus.current,
+                                        total: uploadStatus.total,
+                                        filename: uploadStatus.filename
+                                            ? `: ${uploadStatus.filename}`
+                                            : "",
+                                    })
+                                    : dragOver
+                                        ? t("knowledgeview.DropFilesOrFoldersToUpload", {
+                                            defaultValue: "Drop files or folders to upload",
+                                        })
+                                        : t("knowledgeview.DropFilesHereToUpload", {
+                                            defaultValue: "Drop files here to upload",
+                                        }) })] }), showUrlInput && (_jsx("div", { className: "mt-3 animate-in fade-in slide-in-from-top-2 duration-300", children: _jsxs("div", { className: "flex flex-col gap-2 sm:flex-row", children: [_jsx(Input, { type: "url", placeholder: t("knowledgeview.httpsExampleCom"), value: urlInput, onChange: (e) => setUrlInput(e.target.value), onKeyDown: (e) => e.key === "Enter" && handleUrlSubmit(), disabled: uploading, className: "h-10 flex-1 border-border/55 bg-bg/72 text-xs shadow-none" }), _jsx(Button, { variant: "default", size: "sm", className: "h-10 px-4 text-xs-tight font-semibold", onClick: handleUrlSubmit, disabled: !urlInput.trim() || uploading, children: t("settings.import") })] }) })), _jsxs("div", { className: "mt-3 inline-flex min-h-9 w-full items-center gap-2 text-2xs leading-relaxed text-muted", children: [_jsx(Checkbox, { id: "knowledge-upload-image-descriptions", checked: includeImageDescriptions, onCheckedChange: (checked) => setIncludeImageDescriptions(!!checked), disabled: uploading }), _jsx("label", { htmlFor: "knowledge-upload-image-descriptions", className: "min-w-0 cursor-pointer", children: t("knowledgeview.IncludeAIImageDes") })] })] })] }));
+}

package/packages/app-core/src/components/pages/page-scoped-conversations.d.ts

@@ -0,0 +1,62 @@
+import type { Conversation, ConversationMetadata } from "../../api/client-types-chat";
+export type PageScope = "page-browser" | "page-character" | "page-automations" | "page-apps" | "page-connectors" | "page-phone" | "page-plugins" | "page-lifeops" | "page-settings" | "page-wallet";
+export declare const PAGE_SCOPES: readonly PageScope[];
+/**
+ * Bump when the per-scope brief, intro copy, or live-state shape changes
+ * meaningfully — so a future MIPRO/GEPA optimization pass can filter to a
+ * single prompt-regime cohort instead of mixing trajectories generated under
+ * different surface contracts.
+ */
+export declare const PAGE_SCOPE_VERSION = 12;
+export interface PageScopeIntroCopy {
+    /** Short user-facing intro card title shown when the conversation is empty. */
+    title: string;
+    /** Body shown to the user before they type. */
+    body: string;
+    /**
+     * System prompt addendum prepended to the FIRST user turn so the agent is
+     * grounded in the surface from message #1. Distinct from the user-facing
+     * intro and never persisted as a visible message.
+     */
+    systemAddendum: string;
+}
+export declare const PAGE_SCOPE_COPY: Record<PageScope, PageScopeIntroCopy>;
+export declare const PAGE_SCOPE_DEFAULT_TITLE: Record<PageScope, string>;
+/**
+ * Browser scope intro copy varies by Agent Browser Bridge companion state: when the
+ * extension is connected the agent can drive real tabs; when it isn't the
+ * intro has to walk the user through installing the extension instead of
+ * pretending real-browser control is available.
+ */
+export declare function getBrowserPageScopeCopy(state: {
+    browserBridgeConnected: boolean;
+    browserBridgeInstallAvailable?: boolean;
+    browserLabel?: string | null;
+    profileLabel?: string | null;
+}): PageScopeIntroCopy;
+export declare function isPageScopedConversation(conversation: Pick<Conversation, "metadata"> | null | undefined): boolean;
+export declare function isPageScopedConversationMetadata(metadata: ConversationMetadata | null | undefined): boolean;
+export declare function buildPageScopedConversationMetadata(scope: PageScope, options?: {
+    sourceConversationId?: string;
+    pageId?: string;
+}): ConversationMetadata;
+/**
+ * Routing metadata stamped on every page-scope send. The runtime persists this
+ * into the trajectory `metadata` column verbatim — every field here is a
+ * sortable dimension for later analysis or per-scope prompt optimization.
+ */
+export declare function buildPageScopedRoutingMetadata(scope: PageScope, options?: {
+    sourceConversationId?: string;
+    pageId?: string;
+}): Record<string, unknown>;
+export declare function resolvePageScopedConversation(params: {
+    scope: PageScope;
+    title?: string;
+    pageId?: string;
+}): Promise<Conversation>;
+export declare function resetPageScopedConversation(params: {
+    scope: PageScope;
+    title?: string;
+    pageId?: string;
+}): Promise<Conversation>;
+//# sourceMappingURL=page-scoped-conversations.d.ts.map

package/packages/app-core/src/components/pages/page-scoped-conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-scoped-conversations.d.ts","sourceRoot":"","sources":["../../../../../../../app-core/src/components/pages/page-scoped-conversations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACrB,MAAM,6BAA6B,CAAC;AAErC,MAAM,MAAM,SAAS,GACjB,cAAc,GACd,gBAAgB,GAChB,kBAAkB,GAClB,WAAW,GACX,iBAAiB,GACjB,YAAY,GACZ,cAAc,GACd,cAAc,GACd,eAAe,GACf,aAAa,CAAC;AAElB,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAWlC,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,SAAS,EAAE,kBAAkB,CA6DjE,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAW9D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,sBAAsB,EAAE,OAAO,CAAC;IAChC,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,kBAAkB,CAyBrB;AAED,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,GAC9D,OAAO,CAGT;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAChD,OAAO,CAGT;AAED,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/D,oBAAoB,CAStB;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB;AAqCD,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,YAAY,CAAC,CA6BxB;AAED,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,YAAY,CAAC,CAsBxB"}

package/packages/app-core/src/components/pages/page-scoped-conversations.js

@@ -0,0 +1,211 @@
+import { client } from "../../api";
+export const PAGE_SCOPES = [
+    "page-browser",
+    "page-character",
+    "page-automations",
+    "page-apps",
+    "page-connectors",
+    "page-phone",
+    "page-plugins",
+    "page-lifeops",
+    "page-settings",
+    "page-wallet",
+];
+/**
+ * Bump when the per-scope brief, intro copy, or live-state shape changes
+ * meaningfully — so a future MIPRO/GEPA optimization pass can filter to a
+ * single prompt-regime cohort instead of mixing trajectories generated under
+ * different surface contracts.
+ */
+export const PAGE_SCOPE_VERSION = 12;
+export const PAGE_SCOPE_COPY = {
+    "page-browser": {
+        title: "Browser chat",
+        body: "Use me to work with the browser workspace. User Tabs are writable; Agent Tabs and App Tabs are read-only context. I can open, navigate, refresh, snapshot, show, hide, or close User Tabs and explain what is currently open everywhere else.",
+        systemAddendum: "You are answering inside the Browser view. Tabs are grouped into User Tabs, Agent Tabs, and App Tabs. You may mutate User Tabs: open them, navigate them, refresh them, snapshot them, show or hide them, and close them. Agent Tabs and App Tabs are read-only context: you may inspect, summarize, or reference them, but do not navigate, click, type into, refresh, close, or otherwise mutate them. Recommend the next browser action based on live tab and bridge state. Offer to answer questions about the current page, forms, tabs, or browser setup. Ground every answer in the live tab list provided in context. Never invent tabs or URLs.",
+    },
+    "page-character": {
+        title: "Character chat",
+        body: "Use me to work with the Character hub. I can help you review Overview, refine Personality, manage Knowledge, inspect Skills, inspect Experience, and explore Relationships. Recommended: tell me what you want to change or understand, and I'll point to the right section or draft exact copy. Ask me what to update next.",
+        systemAddendum: "You are answering inside the Character view. The Character hub is organized into Overview, Personality, Knowledge, Skills, Experience, and Relationships. Help the user navigate those sections, recommend the next character step from live state, and draft exact wording when they need copy. Use Overview for high-level status and identity framing, Personality for editable persona/voice fields, Knowledge for uploaded reference material, Skills for learned skill proposals and status, Experience for surfaced learnings, and Relationships for contact and graph context. Guide the user to the relevant section instead of inventing a generic setter action. Reference live character state when answering.",
+    },
+    "page-automations": {
+        title: "Automations",
+        body: "Use me to create or inspect a task or n8n workflow. Tell me the trigger, timing, and result.",
+        systemAddendum: "You are answering inside the Automations view. The user can create tasks and n8n workflows, attach either one to a schedule or event, configure wake mode, max runs, and enabled state, browse templates, inspect existing automations, and troubleshoot failed runs. Treat tasks as simple prompt-driven automations and workflows as multi-step n8n pipelines. Recommend the smaller task shape unless the user clearly needs a multi-step pipeline. Use createTriggerTaskAction and manageTasksAction when the request is concrete. Reference live tasks and workflows in context by display name. Never fabricate automation names.",
+    },
+    "page-apps": {
+        title: "Apps chat",
+        body: "Use me to browse the catalog, compare apps, launch an app, stop a running app, open a live viewer, inspect run health, and manage favorites or recent apps. Recommended: describe the outcome you want, and I'll suggest the right app or launch it. Ask me about any catalog item or running app.",
+        systemAddendum: "You are answering inside the Apps view. The user can browse the catalog, compare apps by category and capability, launch apps, stop running apps, open attached live viewers, inspect run health and summaries, and manage favorites or recent apps. Recommend the best app or next run-management action based on live catalog and run state. Use launchAppAction and stopAppAction when the request is concrete. Refer to apps by display name and never invent app names.",
+    },
+    "page-connectors": {
+        title: "Connectors chat",
+        body: "Use me to inspect connector readiness, setup steps, auth state, and integration health. Recommended: ask what to connect or troubleshoot.",
+        systemAddendum: "You are answering inside the Connectors view. The user can inspect connector availability, authentication state, setup requirements, and integration health. Recommend the smallest connector action that fits the user's goal, reference visible connector state when present, and never invent connected accounts, permissions, webhook state, or delivery results.",
+    },
+    "page-phone": {
+        title: "Phone chat",
+        body: "Use me to review calls, SMS, contacts, imported vCards, caller context, and transcript notes. Recommended: ask me to draft a reply, summarize a call, decide who to call back, or organize a contact from the phone workspace. Ask me what to do with any visible call or message.",
+        systemAddendum: "You are answering inside the Android Phone view. The user can place calls through Android Telecom, open the dialer, send SMS through Android SMS, review recent calls, browse contacts, import vCards, and save call transcripts or summaries. Recommend the smallest concrete phone action that fits the user's goal. For calls or SMS, confirm the target number/contact and message content before sending. When discussing calls, messages, contacts, or transcripts, ground the answer in visible phone surface state when present and never invent call logs, contacts, message bodies, transcripts, or delivery results.",
+    },
+    "page-plugins": {
+        title: "Plugins chat",
+        body: "Use me to inspect installed plugins, configuration gaps, registry options, and runtime plugin health.",
+        systemAddendum: "You are answering inside the Plugins view. The user can inspect installed plugins, registry plugins, configuration readiness, plugin health, and runtime capability gaps. Recommend the smallest plugin setup or troubleshooting action that fits the user's goal, reference visible plugin state when present, and never invent installed plugins, credentials, or enabled capabilities.",
+    },
+    "page-lifeops": {
+        title: "LifeOps chat",
+        body: "Ask me about the visible LifeOps item or the next action you want handled.",
+        systemAddendum: "You are answering inside the LifeOps view. The user can inspect the current overview, goals, reminders, calendar, messages, mail, sleep, screen time, social context, connector setup, capability readiness, and LifeOps settings. Recommend capability readiness and overview review before creating or changing durable personal workflows. When the user asks for concrete LifeOps work, route through the LifeOps app actions/providers already available in the runtime instead of generic advice. Reference live LifeOps state when present, and never invent reminders, goals, messages, calendar events, or connector state.",
+    },
+    "page-settings": {
+        title: "Settings chat",
+        body: "Use me to tune models, providers, permissions, connectors, wallet RPC, cloud account state, appearance, updates, and feature toggles. Recommended: describe the capability you want to enable or troubleshoot, and I'll point to the right section or explain the tradeoffs.",
+        systemAddendum: "You are answering inside the Settings view. The user can change cloud account state, AI models and providers, permissions, wallet RPC providers, feature toggles, appearance, updates, and connector-related configuration. Recommend the smallest concrete settings change that fits the user's goal and reference the visible section when possible. Ask follow-up questions when a setting affects security, spending, or external accounts. Never invent provider status, account state, or permission grants.",
+    },
+    "page-wallet": {
+        title: "Wallet chat",
+        body: "Use me to inspect token inventory, NFTs, LP positions, balances, P&L, activity, EVM/Solana addresses, RPC readiness, and Vincent trading. Recommended: ask me to prepare a swap, bridge, or Vincent trading plan with the amount and constraints you want.",
+        systemAddendum: "You are answering inside the Wallet view. The user can inspect token inventory, NFTs, LP positions, current balance, P&L, activity, EVM/Solana addresses, RPC/provider readiness, wallet/RPC settings, and Vincent trading. There are no chain filters in this surface. Recommend the smallest concrete wallet action that fits the user's goal. For swaps, bridges, transfers, signatures, or trading actions, confirm the asset, amount, destination, slippage/risk limits, and execution path before invoking available wallet actions. If the user asks about trading, betting, gambling, predicting, Hyperliquid, or Polymarket, surface Vincent as the preferred integration when it is connected or suggest connecting it when it is not. Never invent balances, positions, fills, or execution support.",
+    },
+};
+export const PAGE_SCOPE_DEFAULT_TITLE = {
+    "page-browser": "Browser",
+    "page-character": "Character",
+    "page-automations": "Automations",
+    "page-apps": "Apps",
+    "page-connectors": "Connectors",
+    "page-phone": "Phone",
+    "page-plugins": "Plugins",
+    "page-lifeops": "LifeOps",
+    "page-settings": "Settings",
+    "page-wallet": "Wallet",
+};
+/**
+ * Browser scope intro copy varies by Agent Browser Bridge companion state: when the
+ * extension is connected the agent can drive real tabs; when it isn't the
+ * intro has to walk the user through installing the extension instead of
+ * pretending real-browser control is available.
+ */
+export function getBrowserPageScopeCopy(state) {
+    if (state.browserBridgeConnected) {
+        const browser = state.browserLabel?.trim() || "Chrome";
+        const profile = state.profileLabel?.trim();
+        const where = profile ? `${browser} / ${profile}` : browser;
+        return {
+            title: "Browser chat",
+            body: `Agent Browser Bridge is connected in ${where}. User Tabs are writable; Agent Tabs and App Tabs are read-only context. Use me to open, navigate, refresh, snapshot, show, hide, or close User Tabs and explain what is currently open in any tab.`,
+            systemAddendum: `You are answering inside the Browser view. Agent Browser Bridge is connected in ${where}. Tabs are grouped into User Tabs, Agent Tabs, and App Tabs. You may mutate User Tabs: open them, navigate them, refresh them, snapshot them, show or hide them, and close them. Agent Tabs and App Tabs are read-only context: you may inspect, summarize, or reference them, but do not navigate, click, type into, refresh, close, or otherwise mutate them. Recommend the next browser action based on the live tab list. Ground every answer in the live tab list provided in context. Never invent tabs or URLs.`,
+        };
+    }
+    if (state.browserBridgeInstallAvailable === false) {
+        return {
+            title: "Browser chat",
+            body: "Use me with the embedded browser in this view. User Tabs are writable; Agent Tabs and App Tabs are read-only context. Real Chrome control is unavailable in the current runtime, so I can help with embedded User Tabs, navigation, forms, and page questions only.",
+            systemAddendum: "You are answering inside the Browser view. Agent Browser Bridge is not available in this runtime, so real Chrome control cannot be enabled from this session. Tabs are grouped into User Tabs, Agent Tabs, and App Tabs. You may mutate embedded User Tabs only. Agent Tabs and App Tabs remain read-only context. Help the user with the embedded browser only: opening User Tabs, navigating URLs, refreshing pages, and answering questions about the current embedded page or tab list. Do not recommend installing Agent Browser Bridge or promise real-browser tab control.",
+        };
+    }
+    return {
+        title: "Install Agent Browser Bridge",
+        body: "Install Agent Browser Bridge so I can drive real Chrome tabs. User Tabs are writable; Agent Tabs and App Tabs are read-only context. Until it connects, I can still help with the embedded browser.",
+        systemAddendum: "You are answering inside the Browser view. The user has NOT installed the Agent Browser Bridge companion extension yet. Tabs are grouped into User Tabs, Agent Tabs, and App Tabs. You may mutate embedded User Tabs only. Agent Tabs and App Tabs are read-only context. Guide them to click the Install Agent Browser Bridge button visible in this chat panel — it builds the extension and opens Chrome's extension manager so they can load the unpacked folder. Recommend connecting the extension before requests that need real Chrome control. Until the extension is connected, only the embedded iframe browser is available; do not invent real-browser tabs or promise real-tab control. Offer to answer setup questions or help with embedded browsing.",
+    };
+}
+export function isPageScopedConversation(conversation) {
+    const scope = conversation?.metadata?.scope;
+    return typeof scope === "string" && scope.startsWith("page-");
+}
+export function isPageScopedConversationMetadata(metadata) {
+    const scope = metadata?.scope;
+    return typeof scope === "string" && scope.startsWith("page-");
+}
+export function buildPageScopedConversationMetadata(scope, options = {}) {
+    const metadata = { scope };
+    if (options.pageId) {
+        metadata.pageId = options.pageId;
+    }
+    if (options.sourceConversationId) {
+        metadata.sourceConversationId = options.sourceConversationId;
+    }
+    return metadata;
+}
+/**
+ * Routing metadata stamped on every page-scope send. The runtime persists this
+ * into the trajectory `metadata` column verbatim — every field here is a
+ * sortable dimension for later analysis or per-scope prompt optimization.
+ */
+export function buildPageScopedRoutingMetadata(scope, options = {}) {
+    const metadata = {
+        __responseContext: {
+            primaryContext: "page",
+            secondaryContexts: ["page", scope],
+        },
+        taskId: scope,
+        surface: "page-scoped",
+        surfaceVersion: PAGE_SCOPE_VERSION,
+    };
+    if (options.pageId) {
+        metadata.pageId = options.pageId;
+    }
+    if (options.sourceConversationId) {
+        metadata.sourceConversationId = options.sourceConversationId;
+    }
+    return metadata;
+}
+function findPageScopedConversation(conversations, scope, pageId) {
+    const matching = conversations.filter((conversation) => conversation.metadata?.scope === scope &&
+        (conversation.metadata?.pageId ?? undefined) === (pageId ?? undefined));
+    if (matching.length === 0)
+        return null;
+    return matching.sort((left, right) => new Date(right.updatedAt).getTime() - new Date(left.updatedAt).getTime())[0];
+}
+function findPageScopedConversations(conversations, scope, pageId) {
+    return conversations
+        .filter((conversation) => conversation.metadata?.scope === scope &&
+        (conversation.metadata?.pageId ?? undefined) === (pageId ?? undefined))
+        .sort((left, right) => new Date(right.updatedAt).getTime() -
+        new Date(left.updatedAt).getTime());
+}
+export async function resolvePageScopedConversation(params) {
+    const { scope, pageId } = params;
+    const title = params.title?.trim() || PAGE_SCOPE_DEFAULT_TITLE[scope];
+    const desiredMetadata = buildPageScopedConversationMetadata(scope, {
+        pageId,
+    });
+    const { conversations } = await client.listConversations();
+    const existing = findPageScopedConversation(conversations, scope, pageId);
+    if (existing) {
+        const titleMatches = existing.title === title;
+        const metadataMatches = existing.metadata?.scope === scope &&
+            (existing.metadata?.pageId ?? undefined) === (pageId ?? undefined);
+        if (titleMatches && metadataMatches) {
+            return existing;
+        }
+        const { conversation } = await client.updateConversation(existing.id, {
+            title,
+            metadata: desiredMetadata,
+        });
+        return conversation;
+    }
+    const { conversation } = await client.createConversation(title, {
+        metadata: desiredMetadata,
+    });
+    return conversation;
+}
+export async function resetPageScopedConversation(params) {
+    const { scope, pageId } = params;
+    const title = params.title?.trim() || PAGE_SCOPE_DEFAULT_TITLE[scope];
+    const desiredMetadata = buildPageScopedConversationMetadata(scope, {
+        pageId,
+    });
+    const { conversations } = await client.listConversations();
+    const matching = findPageScopedConversations(conversations, scope, pageId);
+    if (matching.length > 0) {
+        await Promise.allSettled(matching.map((conversation) => client.deleteConversation(conversation.id)));
+    }
+    const { conversation } = await client.createConversation(title, {
+        metadata: desiredMetadata,
+    });
+    return conversation;
+}