@elizaos/app-core 2.0.0-alpha.72 → 2.0.0-alpha.74

package/.turbo/turbo-build.log

@@ -0,0 +1,2 @@
+$ bun run build:dist
+$ test -f ../ui/dist/index.d.ts || (cd ../ui && bun run build) && rimraf dist && tsc -p tsconfig.build.json && node ../../scripts/copy-package-assets.mjs packages/app-core src/styles src/i18n/locales && node ../../scripts/prepare-package-dist.mjs packages/app-core

package/.turbo/turbo-lint$colon$check.log

@@ -0,0 +1,2 @@
+$ bunx @biomejs/biome check ./src/App.tsx ./src/actions ./src/api ./src/autonomy ./src/bridge ./src/chat ./src/coding ./src/components ./src/config ./src/events ./src/hooks ./src/i18n ./src/index.ts ./src/navigation ./src/platform ./src/providers ./src/state ./src/types ./src/utils ./src/voice ./src/ambient.d.ts
+Checked 253 files in 344ms. No fixes applied.

package/.turbo/turbo-typecheck.log

@@ -0,0 +1 @@
+$ test -f ../ui/dist/index.d.ts || (cd ../ui && bun run build) && tsc --noEmit -p tsconfig.json

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/App.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Root App component — routing shell.
+ */
+export declare function App(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=App.d.ts.map

package/dist/App.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../src/App.tsx"],"names":[],"mappings":"AAAA;;GAEG;AA0LH,wBAAgB,GAAG,4CA2TlB"}

package/dist/App.js

@@ -0,0 +1,220 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * Root App component — routing shell.
+ */
+import { Keyboard } from "@capacitor/keyboard";
+import { isIOS, isLifoPopoutValue, isNative, } from "@elizaos/app-core/platform";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { AdvancedPageView, AppsPageView, AvatarLoader, CharacterView, ChatView, CompanionShell, CompanionView, ConnectionFailedBanner, ConnectorsPageView, ConversationsSidebar, CustomActionEditor, CustomActionsPanel, ErrorBoundary, GameViewOverlay, Header, MiladyBar, HeartbeatsView, InventoryView, KnowledgeView, OnboardingWizard, PairingView, SaveCommandModal, SettingsView, SharedCompanionScene, ShellOverlays, StartupFailureView, StreamView, SystemWarningBanner, } from "./components";
+import { BugReportProvider, useBugReportState, useContextMenu, useStreamPopoutNavigation, } from "./hooks";
+import { APPS_ENABLED, COMPANION_ENABLED } from "./navigation";
+import { useApp } from "./state";
+const CHAT_MOBILE_BREAKPOINT_PX = 1024;
+/** Check if we're in pop-out mode (StreamView only, no chrome).
+ *  Legacy LIFO popout values are ignored so the normal app shell still loads. */
+function useIsPopout() {
+    const [popout] = useState(() => {
+        if (typeof window === "undefined")
+            return false;
+        const params = new URLSearchParams(window.location.search || window.location.hash.split("?")[1] || "");
+        if (!params.has("popout"))
+            return false;
+        return !isLifoPopoutValue(params.get("popout"));
+    });
+    return popout;
+}
+function TabScrollView({ children, className = "", }) {
+    return (_jsx("div", { "data-shell-scroll-region": "true", className: `flex-1 min-h-0 min-w-0 w-full overflow-y-auto ${className}`, children: children }));
+}
+function TabContentView({ children }) {
+    return (_jsx("div", { className: "flex-1 min-h-0 min-w-0 w-full overflow-hidden", children: children }));
+}
+function isCharacterTab(tab) {
+    return tab === "character" || tab === "character-select";
+}
+function ViewRouter({ characterSceneVisible = false, }) {
+    const { tab } = useApp();
+    const view = (() => {
+        switch (tab) {
+            case "chat":
+                return _jsx(ChatView, {});
+            case "companion":
+                return COMPANION_ENABLED ? _jsx(CompanionView, {}) : _jsx(ChatView, {});
+            case "stream":
+                return _jsx(StreamView, {});
+            case "apps":
+                // Apps disabled in production builds; fall through to chat
+                return APPS_ENABLED ? (_jsx(TabScrollView, { children: _jsx(AppsPageView, {}) })) : (_jsx(ChatView, {}));
+            case "character":
+            case "character-select":
+                return (_jsx(TabScrollView, { children: _jsx(CharacterView, { sceneOverlay: characterSceneVisible }) }));
+            case "wallets":
+                return (_jsx(TabScrollView, { children: _jsx(InventoryView, {}) }));
+            case "knowledge":
+                return (_jsx(TabScrollView, { children: _jsx(KnowledgeView, {}) }));
+            case "connectors":
+                return (_jsx(TabScrollView, { children: _jsx(ConnectorsPageView, {}) }));
+            case "triggers":
+                return (_jsx(TabScrollView, { children: _jsx("section", { className: "w-full px-4 py-4 lg:px-6", children: _jsx(HeartbeatsView, {}) }) }));
+            case "voice":
+                return (_jsx(TabScrollView, { className: "settings-scroll-region", children: _jsx(SettingsView, { initialSection: "voice" }, "settings-voice") }));
+            case "settings":
+                return (_jsx(TabScrollView, { className: "settings-scroll-region", children: _jsx(SettingsView, {}, "settings-root") }));
+            case "advanced":
+            case "plugins":
+            case "skills":
+            case "actions":
+            case "fine-tuning":
+            case "trajectories":
+            case "runtime":
+            case "database":
+            case "lifo":
+            case "logs":
+            case "security":
+                return (_jsx(TabContentView, { children: _jsx(AdvancedPageView, {}) }));
+            default:
+                return _jsx(ChatView, {});
+        }
+    })();
+    return _jsx(ErrorBoundary, { children: view });
+}
+export function App() {
+    const { onboardingLoading, startupPhase, startupError, authRequired, onboardingComplete, retryStartup, tab, setTab, actionNotice, uiShellMode, agentStatus, unreadConversations, activeGameViewerUrl, gameOverlayEnabled, } = useApp();
+    const isPopout = useIsPopout();
+    const shellMode = tab === "character" || tab === "character-select"
+        ? "native"
+        : (uiShellMode ?? "companion");
+    const effectiveTab = shellMode === "companion"
+        ? "companion"
+        : tab === "companion"
+            ? "chat"
+            : tab;
+    const characterSceneVisible = shellMode === "native" &&
+        (isCharacterTab(effectiveTab) || isCharacterTab(tab));
+    const companionShellVisible = shellMode === "companion";
+    // Don't initialize the 3D scene while the system is still booting — this
+    // prevents VrmEngine's Three.js setup from blocking the JS thread and
+    // delaying WebSocket agent-status updates (which would freeze the loader).
+    const companionSceneActive = COMPANION_ENABLED &&
+        !onboardingLoading &&
+        agentStatus?.state !== "starting" &&
+        (companionShellVisible || characterSceneVisible);
+    const contextMenu = useContextMenu();
+    useStreamPopoutNavigation(setTab);
+    const [customActionsPanelOpen, setCustomActionsPanelOpen] = useState(false);
+    const [customActionsEditorOpen, setCustomActionsEditorOpen] = useState(false);
+    const [editingAction, setEditingAction] = useState(null);
+    const [isChatMobileLayout, setIsChatMobileLayout] = useState(() => typeof window !== "undefined"
+        ? window.innerWidth < CHAT_MOBILE_BREAKPOINT_PX
+        : false);
+    const [mobileConversationsOpen, setMobileConversationsOpen] = useState(false);
+    const isChat = tab === "chat";
+    const unreadCount = unreadConversations?.size ?? 0;
+    const mobileChatControls = isChatMobileLayout ? (_jsx("div", { className: "flex items-center gap-2 w-max", children: _jsxs("button", { type: "button", className: `inline-flex items-center gap-2 px-3 py-2 border rounded-md text-[12px] font-semibold transition-all cursor-pointer ${mobileConversationsOpen
+                ? "border-accent bg-accent-subtle text-txt"
+                : "border-border bg-card text-txt hover:border-accent hover:text-txt"}`, onClick: () => {
+                setMobileConversationsOpen(true);
+            }, "aria-label": "Open chats panel", children: [_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": true, children: [_jsx("title", { children: "Chats" }), _jsx("path", { d: "M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z" })] }), "Chats", unreadCount > 0 && (_jsx("span", { className: "inline-flex min-w-[18px] h-[18px] items-center justify-center rounded-full bg-accent text-accent-fg text-[10px] font-bold px-1", children: unreadCount > 99 ? "99+" : unreadCount }))] }) })) : undefined;
+    // Keep hook order stable across onboarding/auth state transitions.
+    // Otherwise React can throw when onboarding completes and the main shell mounts.
+    useEffect(() => {
+        const handler = () => setCustomActionsPanelOpen((v) => !v);
+        window.addEventListener("toggle-custom-actions-panel", handler);
+        return () => window.removeEventListener("toggle-custom-actions-panel", handler);
+    }, []);
+    const handleEditorSave = useCallback(() => {
+        setCustomActionsEditorOpen(false);
+        setEditingAction(null);
+    }, []);
+    useEffect(() => {
+        if (typeof window === "undefined")
+            return;
+        const handleResize = () => {
+            setIsChatMobileLayout(window.innerWidth < CHAT_MOBILE_BREAKPOINT_PX);
+        };
+        handleResize();
+        window.addEventListener("resize", handleResize);
+        return () => window.removeEventListener("resize", handleResize);
+    }, []);
+    useEffect(() => {
+        if (!isChatMobileLayout) {
+            setMobileConversationsOpen(false);
+        }
+    }, [isChatMobileLayout]);
+    useEffect(() => {
+        if (!isChat) {
+            setMobileConversationsOpen(false);
+        }
+    }, [isChat]);
+    useEffect(() => {
+        if (!isNative || !isIOS) {
+            return;
+        }
+        // Disable the iOS WebView scroll only while the companion shell is active.
+        void Keyboard.setScroll({ isDisabled: companionShellVisible }).catch(() => {
+            // Ignore bridge failures so web and desktop shells keep working.
+        });
+    }, [companionShellVisible]);
+    useEffect(() => {
+        if (!isNative || !isIOS) {
+            return;
+        }
+        return () => {
+            void Keyboard.setScroll({ isDisabled: false }).catch(() => {
+                // Ignore cleanup failures when the native bridge is unavailable.
+            });
+        };
+    }, []);
+    const bugReport = useBugReportState();
+    const agentStarting = agentStatus?.state === "starting";
+    useEffect(() => {
+        const STARTUP_TIMEOUT_MS = 300_000;
+        if (startupPhase !== "ready" && !startupError) {
+            const timer = setTimeout(() => {
+                retryStartup();
+            }, STARTUP_TIMEOUT_MS);
+            return () => clearTimeout(timer);
+        }
+    }, [startupPhase, startupError, retryStartup]);
+    // Pop-out mode — render only StreamView, skip startup gates.
+    // Platform init is skipped in main.tsx; AppProvider hydrates WS in background.
+    if (isPopout) {
+        return (_jsx("div", { className: "flex flex-col h-screen w-screen font-body text-txt bg-bg overflow-hidden", children: _jsx(StreamView, {}) }));
+    }
+    if (startupError) {
+        return _jsx(StartupFailureView, { error: startupError, onRetry: retryStartup });
+    }
+    const shouldLoad = onboardingLoading || agentStarting;
+    const [loaderFadingOut, setLoaderFadingOut] = useState(false);
+    const showLoaderRef = useRef(true);
+    const [showLoader, setShowLoader] = useState(true);
+    useEffect(() => {
+        if (shouldLoad) {
+            showLoaderRef.current = true;
+            setShowLoader(true);
+            setLoaderFadingOut(false);
+        }
+        else if (showLoaderRef.current) {
+            showLoaderRef.current = false;
+            setLoaderFadingOut(true);
+            const timer = setTimeout(() => {
+                setShowLoader(false);
+                setLoaderFadingOut(false);
+            }, 800);
+            return () => clearTimeout(timer);
+        }
+    }, [shouldLoad]);
+    if (authRequired && !shouldLoad)
+        return _jsx(PairingView, {});
+    if (!onboardingComplete && !shouldLoad)
+        return _jsx(OnboardingWizard, {});
+    const shellContent = companionShellVisible ? (_jsx(CompanionShell, { tab: effectiveTab, actionNotice: actionNotice })) : tab === "stream" ? (_jsxs("div", { className: "flex flex-col flex-1 min-h-0 w-full font-body text-txt bg-bg", children: [_jsx(Header, { hideCloudCredits: true }), _jsx(MiladyBar, {}), _jsx("main", { className: "flex-1 min-h-0 overflow-hidden", children: _jsx(StreamView, {}) })] })) : isChat ? (_jsxs("div", { className: "flex flex-col flex-1 min-h-0 w-full font-body text-txt bg-bg", children: [_jsx(Header, { mobileLeft: mobileChatControls, hideCloudCredits: true }), _jsx(MiladyBar, {}), _jsxs("div", { className: "flex flex-1 min-h-0 relative", children: [isChatMobileLayout ? (_jsxs(_Fragment, { children: [_jsx("main", { className: "flex flex-col flex-1 min-h-0 min-w-0 overflow-hidden pt-2 px-2", children: _jsx(ChatView, {}) }), mobileConversationsOpen && (_jsx("div", { className: "fixed inset-0 z-[120] bg-bg", children: _jsx(ConversationsSidebar, { mobile: true, onClose: () => setMobileConversationsOpen(false) }) }))] })) : (_jsxs(_Fragment, { children: [_jsx(ConversationsSidebar, {}), _jsx("main", { className: "flex flex-col flex-1 min-h-0 min-w-0 overflow-hidden pt-3 px-3 xl:px-5", children: _jsx(ChatView, {}) })] })), _jsx(CustomActionsPanel, { open: customActionsPanelOpen, onClose: () => setCustomActionsPanelOpen(false), onOpenEditor: (action) => {
+                            setEditingAction(action ?? null);
+                            setCustomActionsEditorOpen(true);
+                        } })] })] })) : (_jsxs("div", { className: `flex flex-col flex-1 min-h-0 w-full font-body text-txt ${characterSceneVisible ? "bg-transparent" : "bg-bg"}`, children: [_jsx(Header, { transparent: characterSceneVisible, hideCloudCredits: !characterSceneVisible }), !characterSceneVisible && _jsx(MiladyBar, {}), _jsx("main", { className: `flex flex-1 min-h-0 min-w-0 overflow-hidden px-3 xl:px-5 ${characterSceneVisible ? "pb-4 pt-2 xl:pb-6" : "py-4 xl:py-6"}`, children: _jsx(ViewRouter, { characterSceneVisible: characterSceneVisible }) })] }));
+    const appShell = COMPANION_ENABLED ? (_jsx(SharedCompanionScene, { active: companionSceneActive, interactive: companionShellVisible, children: shellContent })) : (shellContent);
+    return (_jsxs(BugReportProvider, { value: bugReport, children: [appShell, activeGameViewerUrl && gameOverlayEnabled && tab !== "apps" && (_jsx(GameViewOverlay, {})), _jsx(ShellOverlays, { actionNotice: actionNotice }), _jsx(SaveCommandModal, { open: contextMenu.saveCommandModalOpen, text: contextMenu.saveCommandText, onSave: contextMenu.confirmSaveCommand, onClose: contextMenu.closeSaveCommandModal }), _jsx(CustomActionEditor, { open: customActionsEditorOpen, action: editingAction, onSave: handleEditorSave, onClose: () => {
+                    setCustomActionsEditorOpen(false);
+                    setEditingAction(null);
+                } }), _jsx(ConnectionFailedBanner, {}), _jsx(SystemWarningBanner, {}), showLoader && (_jsx(AvatarLoader, { label: agentStarting ? "Initializing agent" : "Starting systems", fullScreen: true, fadingOut: loaderFadingOut }))] }));
+}

package/dist/actions/character.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Character action helpers — extracted from AppContext.
+ *
+ * Pure functions for character CRUD and draft management.
+ */
+import type { CharacterData, ElizaClient } from "../api/client";
+type MessageExampleGroup = {
+    examples: Array<{
+        name: string;
+        content: {
+            text: string;
+        };
+    }>;
+};
+export interface CharacterActionContext {
+    client: ElizaClient;
+    setCharacterData: (data: CharacterData | null) => void;
+    setCharacterDraft: (fn: CharacterData | ((prev: CharacterData) => CharacterData)) => void;
+    setCharacterLoading: (loading: boolean) => void;
+    setCharacterSaving: (saving: boolean) => void;
+    setCharacterSaveError: (error: string | null) => void;
+    setCharacterSaveSuccess: (message: string | null) => void;
+}
+export declare function loadCharacter(ctx: CharacterActionContext): Promise<void>;
+export declare function normalizeGeneratedMessageExamples(input: unknown, fallbackAgentName?: string, options?: {
+    fallbackMissingSpeaker?: boolean;
+}): MessageExampleGroup[];
+export declare function prepareDraftForSave(draft: CharacterData): Record<string, unknown>;
+export declare function parseMessageExamplesInput(value: string): Array<{
+    examples: Array<{
+        name: string;
+        content: {
+            text: string;
+        };
+    }>;
+}>;
+export declare function parseArrayInput(value: string): string[];
+export {};
+//# sourceMappingURL=character.d.ts.map

package/dist/actions/character.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"character.d.ts","sourceRoot":"","sources":["../../src/actions/character.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEhE,KAAK,mBAAmB,GAAG;IACzB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;CAC9D,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,WAAW,CAAC;IACpB,gBAAgB,EAAE,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD,iBAAiB,EAAE,CACjB,EAAE,EAAE,aAAa,GAAG,CAAC,CAAC,IAAI,EAAE,aAAa,KAAK,aAAa,CAAC,KACzD,IAAI,CAAC;IACV,mBAAmB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,kBAAkB,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C,qBAAqB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACtD,uBAAuB,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC3D;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAsHD,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,OAAO,EACd,iBAAiB,SAAU,EAC3B,OAAO,GAAE;IAAE,sBAAsB,CAAC,EAAE,OAAO,CAAA;CAAO,GACjD,mBAAmB,EAAE,CAqCvB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuFzB;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9D,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;CAC9D,CAAC,CAiBD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAKvD"}

package/dist/actions/character.js

@@ -0,0 +1,247 @@
+/**
+ * Character action helpers — extracted from AppContext.
+ *
+ * Pure functions for character CRUD and draft management.
+ */
+export async function loadCharacter(ctx) {
+    ctx.setCharacterLoading(true);
+    ctx.setCharacterSaveError(null);
+    ctx.setCharacterSaveSuccess(null);
+    try {
+        const { character } = await ctx.client.getCharacter();
+        ctx.setCharacterData(character);
+        ctx.setCharacterDraft({
+            name: character.name ?? "",
+            username: character.username ?? "",
+            bio: Array.isArray(character.bio)
+                ? character.bio.join("\n")
+                : (character.bio ?? ""),
+            system: character.system ?? "",
+            adjectives: character.adjectives ?? [],
+            topics: character.topics ?? [],
+            style: {
+                all: character.style?.all ?? [],
+                chat: character.style?.chat ?? [],
+                post: character.style?.post ?? [],
+            },
+            messageExamples: character.messageExamples ?? [],
+            postExamples: character.postExamples ?? [],
+        });
+    }
+    catch {
+        ctx.setCharacterData(null);
+        ctx.setCharacterDraft({});
+    }
+    ctx.setCharacterLoading(false);
+}
+function extractLikelyJson(input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        return trimmed;
+    const withoutFences = trimmed
+        .replace(/^```(?:json)?\s*/i, "")
+        .replace(/\s*```$/i, "")
+        .trim();
+    if (withoutFences.startsWith("{") || withoutFences.startsWith("[")) {
+        return withoutFences;
+    }
+    const firstBracket = withoutFences.indexOf("[");
+    const firstBrace = withoutFences.indexOf("{");
+    const starts = [firstBracket, firstBrace].filter((index) => index >= 0);
+    if (starts.length === 0)
+        return withoutFences;
+    const start = Math.min(...starts);
+    const opener = withoutFences[start];
+    const closer = opener === "[" ? "]" : "}";
+    const end = withoutFences.lastIndexOf(closer);
+    if (end <= start)
+        return withoutFences;
+    return withoutFences.slice(start, end + 1);
+}
+function normalizeSpeakerName(rawName, fallbackAgentName, options = {}) {
+    const fallbackMissingSpeaker = options.fallbackMissingSpeaker ?? true;
+    if (typeof rawName === "string" && rawName.trim()) {
+        const trimmed = rawName.trim();
+        const normalized = trimmed.toLowerCase();
+        if (normalized === "assistant" ||
+            normalized === "agent" ||
+            normalized === "ai" ||
+            normalized === "model" ||
+            normalized === "{{agentname}}") {
+            return fallbackAgentName;
+        }
+        if (normalized === "user" ||
+            normalized === "human" ||
+            normalized === "{{user}}" ||
+            normalized === "customer") {
+            return "{{user1}}";
+        }
+        return trimmed;
+    }
+    return fallbackMissingSpeaker ? fallbackAgentName : "";
+}
+function normalizeMessageText(raw) {
+    if (typeof raw === "string")
+        return raw.trim();
+    return "";
+}
+function normalizeConversation(conversation, fallbackAgentName, options = {}) {
+    const rawExamples = Array.isArray(conversation)
+        ? conversation
+        : conversation &&
+            typeof conversation === "object" &&
+            Array.isArray(conversation.examples)
+            ? conversation.examples
+            : null;
+    if (!rawExamples)
+        return null;
+    const examples = rawExamples
+        .map((message) => {
+        const record = message && typeof message === "object"
+            ? message
+            : null;
+        if (!record)
+            return null;
+        const content = record.content && typeof record.content === "object"
+            ? record.content
+            : null;
+        const text = normalizeMessageText(content?.text ?? record.text ?? record.message ?? record.content);
+        if (!text)
+            return null;
+        return {
+            name: normalizeSpeakerName(record.name ?? record.user ?? record.speaker ?? record.role, fallbackAgentName, options),
+            content: { text },
+        };
+    })
+        .filter((message) => Boolean(message?.name && message.content.text));
+    if (examples.length === 0)
+        return null;
+    return { examples };
+}
+export function normalizeGeneratedMessageExamples(input, fallbackAgentName = "Agent", options = {}) {
+    let parsed = input;
+    if (typeof input === "string") {
+        const candidate = extractLikelyJson(input);
+        try {
+            parsed = JSON.parse(candidate);
+        }
+        catch {
+            return [];
+        }
+    }
+    const source = parsed &&
+        typeof parsed === "object" &&
+        Array.isArray(parsed.messageExamples)
+        ? parsed.messageExamples
+        : parsed;
+    if (!Array.isArray(source))
+        return [];
+    const groups = source.length > 0 &&
+        source.every((entry) => entry && typeof entry === "object" && Array.isArray(entry.examples))
+        ? source
+        : source.every((entry) => Array.isArray(entry))
+            ? source
+            : [source];
+    return groups
+        .map((group) => normalizeConversation(group, fallbackAgentName, options))
+        .filter((group) => Boolean(group));
+}
+export function prepareDraftForSave(draft) {
+    // Only pick fields the API schema accepts (.strict() rejects unknown keys)
+    const result = {};
+    if (draft.name?.trim()) {
+        result.name = draft.name.trim();
+    }
+    if (draft.username?.trim()) {
+        result.username = draft.username.trim();
+    }
+    else if (typeof result.name === "string") {
+        result.username = result.name;
+    }
+    if (draft.system)
+        result.system = draft.system;
+    if (typeof draft.bio === "string") {
+        const lines = draft.bio
+            .split("\n")
+            .map((l) => l.trim())
+            .filter((l) => l.length > 0);
+        if (lines.length > 0)
+            result.bio = lines;
+    }
+    else if (Array.isArray(draft.bio) && draft.bio.length > 0) {
+        result.bio = draft.bio;
+    }
+    const adjectives = (draft.adjectives ?? []).filter((s) => s.trim().length > 0);
+    if (adjectives.length > 0)
+        result.adjectives = adjectives;
+    const topics = (draft.topics ?? []).filter((s) => s.trim().length > 0);
+    if (topics.length > 0)
+        result.topics = topics;
+    const postExamples = (draft.postExamples ?? []).filter((s) => s.trim().length > 0);
+    if (postExamples.length > 0)
+        result.postExamples = postExamples;
+    if (draft.messageExamples != null) {
+        // Strip extra fields from content (schema is .strict() — only text + actions allowed)
+        const cleaned = normalizeGeneratedMessageExamples(draft.messageExamples, draft.name?.trim() || "Agent", { fallbackMissingSpeaker: false }).map((group, groupIndex) => ({
+            examples: group.examples
+                .map((msg) => {
+                const originalGroup = Array.isArray(draft.messageExamples) &&
+                    draft.messageExamples[groupIndex] &&
+                    typeof draft.messageExamples[groupIndex] === "object"
+                    ? draft.messageExamples[groupIndex]
+                    : null;
+                const originalMessage = originalGroup?.examples?.find((candidate) => candidate?.name?.trim() === msg.name &&
+                    candidate?.content?.text?.trim() === msg.content.text);
+                return {
+                    name: msg.name.trim(),
+                    content: {
+                        text: msg.content.text.trim(),
+                        ...(originalMessage?.content?.actions
+                            ? { actions: originalMessage.content.actions }
+                            : {}),
+                    },
+                };
+            })
+                .filter((msg) => msg.name && msg.content.text),
+        }));
+        if (cleaned.length > 0)
+            result.messageExamples = cleaned;
+    }
+    if (draft.style) {
+        const style = {};
+        if (draft.style.all?.length)
+            style.all = draft.style.all;
+        if (draft.style.chat?.length)
+            style.chat = draft.style.chat;
+        if (draft.style.post?.length)
+            style.post = draft.style.post;
+        if (Object.keys(style).length > 0)
+            result.style = style;
+    }
+    return result;
+}
+export function parseMessageExamplesInput(value) {
+    if (!value.trim())
+        return [];
+    const blocks = value.split(/\n\s*\n/).filter((b) => b.trim().length > 0);
+    return blocks.map((block) => {
+        const lines = block.split("\n").filter((l) => l.trim().length > 0);
+        const examples = lines.map((line) => {
+            const colonIdx = line.indexOf(":");
+            if (colonIdx > 0) {
+                return {
+                    name: line.slice(0, colonIdx).trim(),
+                    content: { text: line.slice(colonIdx + 1).trim() },
+                };
+            }
+            return { name: "User", content: { text: line.trim() } };
+        });
+        return { examples };
+    });
+}
+export function parseArrayInput(value) {
+    return value
+        .split("\n")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+}

package/dist/actions/chat-helpers.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Chat helpers — streaming delta computation, formatting, and common patterns.
+ *
+ * Extracted from AppContext to be reusable across providers.
+ */
+import { mergeStreamingText } from "../utils/streaming-text";
+export { mergeStreamingText };
+/**
+ * Compute the streaming delta between the accumulated text and the new token.
+ * The SSE endpoint may emit the full text so far or just the delta — this
+ * function handles both by returning only the new characters.
+ */
+export declare function computeStreamingDelta(accumulated: string, token: string): string;
+/**
+ * Determine whether the final stream response text should replace the
+ * accumulated text in the UI. This handles cases where the final text
+ * differs from what was streamed (e.g., post-processing on the server).
+ */
+export declare function shouldApplyFinalStreamText(streamed: string, final: string): boolean;
+/**
+ * Format a search result section with a label and bullet items.
+ */
+export declare function formatSearchBullet(label: string, items: string[]): string;
+/**
+ * Parse slash command input into a command name and raw arguments.
+ */
+export declare function parseSlashCommandInput(rawText: string): {
+    name: string;
+    argsRaw: string;
+} | null;
+/**
+ * Normalize a custom action name for slash command matching.
+ */
+export declare function normalizeCustomActionName(name: string): string;
+/**
+ * Parse custom action params from a slash command args string.
+ */
+export declare function parseCustomActionParams(action: {
+    params?: Array<{
+        name: string;
+        required?: boolean;
+    }>;
+}, argsRaw: string): {
+    params: Record<string, string>;
+    missingRequired: string[];
+};
+//# sourceMappingURL=chat-helpers.d.ts.map

package/dist/actions/chat-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-helpers.d.ts","sourceRoot":"","sources":["../../src/actions/chat-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAGT;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAGzE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,GACd;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAW1C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAAE,EAChE,OAAO,EAAE,MAAM,GACd;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,eAAe,EAAE,MAAM,EAAE,CAAA;CAAE,CAsB/D"}