@solidxai/core-ui 0.1.19-beta.0 → 0.1.19

package/dist/components/core/solid-agent/client/agentRuntime.js

@@ -0,0 +1,406 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+import { eventBus } from "../../../../helpers/eventBus";
+import { agentConnectionChanged, agentEventReceived, agentHistoryLoaded, agentThreadReset, agentUserMessageAdded, } from "../../../../redux/features/agentSlice";
+import { historyToItems, normalizeAgentFrame } from "../agentEvents";
+import { SOLID_AGENT_EVENTS } from "../sdk/solidAgent";
+import { AgentEventTypes } from "../types";
+import { resolveAttachmentMedia } from "./agentAttachmentMedia";
+import { clearAllAgentAuth } from "./agentAuth";
+import { fetchSessionHistory, uploadAgentAttachments } from "./agentRest";
+import { AgentSocket } from "./agentSocket";
+import { agentIdOf } from "./agentUrls";
+/** Keep the original SolidX storage key; Agent Hub keeps one per agent (its agent URL names the agent). */
+function sessionKey(agentRuntime, agentUrl) {
+    if (agentRuntime === "solidx")
+        return "solid-agent.session_id";
+    var agentId = agentIdOf(agentUrl);
+    return agentId === undefined ? "solid-agent.".concat(agentRuntime, ".session_id") : "solid-agent.".concat(agentRuntime, ".").concat(agentId, ".session_id");
+}
+function readSessionId(key) {
+    try {
+        return localStorage.getItem(key);
+    }
+    catch (_a) {
+        return null;
+    }
+}
+function writeSessionId(key, id) {
+    try {
+        id ? localStorage.setItem(key, id) : localStorage.removeItem(key);
+    }
+    catch (_a) {
+        // Storage blocked (private mode); the session just won't survive a reload.
+    }
+}
+var AgentRuntime = /** @class */ (function () {
+    function AgentRuntime(agentUrl, dispatch, getState, agentRuntime, persistSession) {
+        var _this = this;
+        if (agentRuntime === void 0) { agentRuntime = "solidx"; }
+        if (persistSession === void 0) { persistSession = true; }
+        Object.defineProperty(this, "agentUrl", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: agentUrl
+        });
+        Object.defineProperty(this, "dispatch", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: dispatch
+        });
+        Object.defineProperty(this, "getState", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: getState
+        });
+        Object.defineProperty(this, "agentRuntime", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: agentRuntime
+        });
+        Object.defineProperty(this, "persistSession", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: persistSession
+        });
+        Object.defineProperty(this, "socket", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "pendingDelta", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ""
+        });
+        Object.defineProperty(this, "frame", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "unsubscribers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "lastContext", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "sessionKey", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.sessionKey = sessionKey(agentRuntime, agentUrl);
+        this.socket = new AgentSocket(agentUrl, persistSession ? readSessionId(this.sessionKey) : null, agentRuntime === "agentHub");
+        this.unsubscribers.push(this.socket.onEvent(function (frame) { return _this.handleFrame(frame); }), this.socket.onStatus(function (status) { return _this.dispatch(agentConnectionChanged(status)); }));
+        this.socket.connect();
+    }
+    /**
+     * Uploads files into SolidX media storage first, then sends their IDs with the socket message.
+     */
+    Object.defineProperty(AgentRuntime.prototype, "sendMessage", {
+        enumerable: false,
+        configurable: true,
+        writable: true,
+        value: function (text, context, attachments, inputs) {
+            var _a;
+            if (attachments === void 0) { attachments = []; }
+            return __awaiter(this, void 0, void 0, function () {
+                var content, uploaded, _b, displayAttachments;
+                return __generator(this, function (_c) {
+                    switch (_c.label) {
+                        case 0:
+                            content = text.trim();
+                            if (!content && !attachments.length)
+                                return [2 /*return*/];
+                            if (!attachments.length) return [3 /*break*/, 2];
+                            return [4 /*yield*/, uploadAgentAttachments(this.agentUrl, attachments.map(function (item) { return item.file; }))];
+                        case 1:
+                            _b = _c.sent();
+                            return [3 /*break*/, 3];
+                        case 2:
+                            _b = [];
+                            _c.label = 3;
+                        case 3:
+                            uploaded = _b;
+                            if (uploaded.length !== attachments.length) {
+                                throw new Error("SolidX did not confirm every uploaded file. Please retry.");
+                            }
+                            if (context)
+                                this.lastContext = context;
+                            displayAttachments = attachments.map(function (item, index) { return (__assign(__assign({}, item.meta), (uploaded[index] ? { mediaId: uploaded[index].id } : {}))); });
+                            this.dispatch(agentUserMessageAdded({ text: content, attachments: displayAttachments }));
+                            this.socket.send(__assign(__assign({ action: "message", session_id: (_a = this.socket.currentSessionId) !== null && _a !== void 0 ? _a : "", content: content, context: context !== null && context !== void 0 ? context : this.lastContext }, (this.agentRuntime === "agentHub" && inputs ? { inputs: inputs } : {})), (attachments.length ? { attachments: uploaded } : {})));
+                            return [2 /*return*/];
+                    }
+                });
+            });
+        }
+    });
+    /** Answers a widget. Sent as text too, so agents without widget_reply support still understand it. */
+    Object.defineProperty(AgentRuntime.prototype, "replyToWidget", {
+        enumerable: false,
+        configurable: true,
+        writable: true,
+        value: function (widgetId, widget, value) {
+            var _a;
+            var text = typeof value === "string" ? value : Array.isArray(value) ? value.join(", ") : JSON.stringify(value);
+            this.dispatch(agentUserMessageAdded({ text: text }));
+            this.socket.send({
+                action: "message",
+                session_id: (_a = this.socket.currentSessionId) !== null && _a !== void 0 ? _a : "",
+                content: text,
+                context: this.lastContext,
+                widget_reply: { widgetId: widgetId, value: value },
+            });
+            eventBus.emit(SOLID_AGENT_EVENTS.widgetAction, { widgetId: widgetId, widget: widget, value: value, agentType: this.agentRuntime });
+        }
+    });
+    Object.defineProperty(AgentRuntime.prototype, "cancel", {
+        enumerable: false,
+        configurable: true,
+        writable: true,
+        value: function () {
+            var sessionId = this.socket.currentSessionId;
+            if (sessionId)
+                this.socket.send({ action: "cancel", session_id: sessionId });
+        }
+    });
+    Object.defineProperty(AgentRuntime.prototype, "newChat", {
+        enumerable: false,
+        configurable: true,
+        writable: true,
+        value: function () {
+            if (this.persistSession)
+                writeSessionId(this.sessionKey, null);
+            this.lastContext = undefined;
+            this.dispatch(agentThreadReset());
+            this.socket.newSession();
+        }
+    });
+    Object.defineProperty(AgentRuntime.prototype, "resume", {
+        enumerable: false,
+        configurable: true,
+        writable: true,
+        value: function (sessionId) {
+            if (this.persistSession)
+                writeSessionId(this.sessionKey, sessionId);
+            this.dispatch(agentThreadReset());
+            this.socket.resume(sessionId);
+        }
+    });
+    Object.defineProperty(AgentRuntime.prototype, "loadOlder", {
+        enumerable: false,
+        configurable: true,
+        writable: true,
+        value: function () {
+            return __awaiter(this, void 0, void 0, function () {
+                var state;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            state = this.getState();
+                            if (!(state === null || state === void 0 ? void 0 : state.historySessionId) || !state.hasMoreHistory)
+                                return [2 /*return*/];
+                            return [4 /*yield*/, this.loadHistory(state.historySessionId, state.historyPage + 1)];
+                        case 1:
+                            _a.sent();
+                            return [2 /*return*/];
+                    }
+                });
+            });
+        }
+    });
+    Object.defineProperty(AgentRuntime.prototype, "dispose", {
+        enumerable: false,
+        configurable: true,
+        writable: true,
+        value: function () {
+            this.unsubscribers.forEach(function (off) { return off(); });
+            if (this.frame != null)
+                cancelAnimationFrame(this.frame);
+            this.socket.close();
+        }
+    });
+    Object.defineProperty(AgentRuntime.prototype, "loadHistory", {
+        enumerable: false,
+        configurable: true,
+        writable: true,
+        value: function (historySessionId, page) {
+            var _a;
+            return __awaiter(this, void 0, void 0, function () {
+                var result, rawItems, items, _b, _c;
+                return __generator(this, function (_d) {
+                    switch (_d.label) {
+                        case 0:
+                            _d.trys.push([0, 5, , 6]);
+                            return [4 /*yield*/, fetchSessionHistory(this.agentUrl, historySessionId, page)];
+                        case 1:
+                            result = _d.sent();
+                            if (!result)
+                                return [2 /*return*/];
+                            rawItems = historyToItems((_a = result.messages) !== null && _a !== void 0 ? _a : []);
+                            if (!this.persistSession) return [3 /*break*/, 3];
+                            return [4 /*yield*/, resolveAttachmentMedia(rawItems)];
+                        case 2:
+                            _b = _d.sent();
+                            return [3 /*break*/, 4];
+                        case 3:
+                            _b = rawItems;
+                            _d.label = 4;
+                        case 4:
+                            items = _b;
+                            this.dispatch(agentHistoryLoaded({ items: items, hasMore: !!result.has_more, page: page }));
+                            return [3 /*break*/, 6];
+                        case 5:
+                            _c = _d.sent();
+                            return [3 /*break*/, 6];
+                        case 6: return [2 /*return*/];
+                    }
+                });
+            });
+        }
+    });
+    Object.defineProperty(AgentRuntime.prototype, "handleFrame", {
+        enumerable: false,
+        configurable: true,
+        writable: true,
+        value: function (frame) {
+            var _this = this;
+            var _a;
+            var event = normalizeAgentFrame(frame);
+            // Stream text is batched per animation frame unless it carries a widget of its own.
+            if (event.eventType === AgentEventTypes.llmToken && !event.eventData.widget) {
+                this.pendingDelta += (_a = event.eventData.delta) !== null && _a !== void 0 ? _a : "";
+                if (this.frame == null)
+                    this.frame = requestAnimationFrame(function () { return _this.flushTokens(); });
+                return;
+            }
+            // Keep order: any buffered text lands before the next event.
+            this.flushTokens();
+            this.dispatch(agentEventReceived(event));
+            this.emitSdkEvents(event);
+        }
+    });
+    Object.defineProperty(AgentRuntime.prototype, "emitSdkEvents", {
+        enumerable: false,
+        configurable: true,
+        writable: true,
+        value: function (event) {
+            var _a, _b, _c, _d, _e;
+            if (event.eventType === AgentEventTypes.sessionStarted) {
+                var sessionId = (_b = (_a = event.frame.session_id) !== null && _a !== void 0 ? _a : event.eventData.session_id) !== null && _b !== void 0 ? _b : null;
+                if (this.persistSession)
+                    writeSessionId(this.sessionKey, sessionId);
+                eventBus.emit(SOLID_AGENT_EVENTS.sessionChanged, { sessionId: sessionId, agentType: this.agentRuntime });
+                var state = this.getState();
+                var historyId = (_d = (_c = event.frame.history_session_id) !== null && _c !== void 0 ? _c : event.eventData.history_session_id) !== null && _d !== void 0 ? _d : sessionId;
+                if (state && state.items.length === 0 && historyId)
+                    void this.loadHistory(historyId, 1);
+            }
+            else if (event.eventType === AgentEventTypes.turnComplete || event.eventType === AgentEventTypes.turnCompleteLegacy) {
+                eventBus.emit(SOLID_AGENT_EVENTS.turnComplete, {
+                    sessionId: this.socket.currentSessionId,
+                    agentType: this.agentRuntime,
+                    content: (_e = event.eventData.content) !== null && _e !== void 0 ? _e : event.frame.content,
+                });
+            }
+        }
+    });
+    Object.defineProperty(AgentRuntime.prototype, "flushTokens", {
+        enumerable: false,
+        configurable: true,
+        writable: true,
+        value: function () {
+            if (this.frame != null) {
+                cancelAnimationFrame(this.frame);
+                this.frame = null;
+            }
+            if (!this.pendingDelta)
+                return;
+            var delta = this.pendingDelta;
+            this.pendingDelta = "";
+            this.dispatch(agentEventReceived(normalizeAgentFrame({ event_type: AgentEventTypes.llmToken, event_data: { delta: delta } })));
+        }
+    });
+    return AgentRuntime;
+}());
+export { AgentRuntime };
+var runtime = null;
+/** Returns the shared "solidx" runtime, creating (or re-pointing) it for `agentUrl`. */
+export function ensureAgentRuntime(agentUrl, dispatch, getState) {
+    if (runtime && runtime.agentUrl === agentUrl)
+        return runtime;
+    runtime === null || runtime === void 0 ? void 0 : runtime.dispose();
+    runtime = new AgentRuntime(agentUrl, dispatch, getState);
+    return runtime;
+}
+export function getAgentRuntime() {
+    return runtime;
+}
+/** Closes the connection and forgets this tab's agent logins (e.g. on logout). */
+export function disposeAgentRuntime() {
+    runtime === null || runtime === void 0 ? void 0 : runtime.dispose();
+    runtime = null;
+    clearAllAgentAuth();
+}
+//# sourceMappingURL=agentRuntime.js.map

package/dist/components/core/solid-agent/client/agentRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentRuntime.js","sourceRoot":"","sources":["../../../../../src/components/core/solid-agent/client/agentRuntime.ts"],"names":[],"mappings":"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","sourcesContent":["import { eventBus } from \"../../../../helpers/eventBus\";\nimport {\n    agentConnectionChanged,\n    agentEventReceived,\n    agentHistoryLoaded,\n    agentThreadReset,\n    agentUserMessageAdded,\n    type AgentState,\n} from \"../../../../redux/features/agentSlice\";\nimport { historyToItems, normalizeAgentFrame } from \"../agentEvents\";\nimport { SOLID_AGENT_EVENTS } from \"../sdk/solidAgent\";\nimport { AgentEventTypes, type AgentRuntimeType, type AgentAttachment, type AgentChatEvent, type AgentContext, type AgentWireFrame } from \"../types\";\nimport { resolveAttachmentMedia } from \"./agentAttachmentMedia\";\nimport { clearAllAgentAuth } from \"./agentAuth\";\nimport { fetchSessionHistory, uploadAgentAttachments } from \"./agentRest\";\nimport { AgentSocket } from \"./agentSocket\";\nimport { agentIdOf } from \"./agentUrls\";\n\n/**\n * A live connection to one agent backend. The \"solidx\" runtime is shared by the floating window and\n * any embedded chat of that type (ensureAgentRuntime); other types get their own runtime per\n * embedded chat (see useAgentChat). Owns the AgentSocket, normalises frames to `{ eventType, eventData }`, batches LlmToken\n * deltas to one dispatch per animation frame, loads history on session start, and emits the\n * public SDK events on the event bus.\n */\n\ntype Dispatch = (action: any) => any;\ntype GetAgentState = () => AgentState | undefined;\n\n/** Keep the original SolidX storage key; Agent Hub keeps one per agent (its agent URL names the agent). */\nfunction sessionKey(agentRuntime: AgentRuntimeType, agentUrl: string) {\n    if (agentRuntime === \"solidx\") return \"solid-agent.session_id\";\n    const agentId = agentIdOf(agentUrl);\n    return agentId === undefined ? `solid-agent.${agentRuntime}.session_id` : `solid-agent.${agentRuntime}.${agentId}.session_id`;\n}\n\nfunction readSessionId(key: string): string | null {\n    try {\n        return localStorage.getItem(key);\n    } catch {\n        return null;\n    }\n}\n\nfunction writeSessionId(key: string, id: string | null) {\n    try {\n        id ? localStorage.setItem(key, id) : localStorage.removeItem(key);\n    } catch {\n        // Storage blocked (private mode); the session just won't survive a reload.\n    }\n}\n\nexport class AgentRuntime {\n    readonly socket: AgentSocket;\n    private pendingDelta = \"\";\n    private frame: number | null = null;\n    private unsubscribers: Array<() => void> = [];\n    private lastContext: AgentContext | undefined;\n\n    private readonly sessionKey: string;\n\n    constructor(\n        readonly agentUrl: string,\n        private dispatch: Dispatch,\n        private getState: GetAgentState,\n        readonly agentRuntime: AgentRuntimeType = \"solidx\",\n        private persistSession = true,\n    ) {\n        this.sessionKey = sessionKey(agentRuntime, agentUrl);\n        this.socket = new AgentSocket(agentUrl, persistSession ? readSessionId(this.sessionKey) : null, agentRuntime === \"agentHub\");\n        this.unsubscribers.push(\n            this.socket.onEvent((frame) => this.handleFrame(frame)),\n            this.socket.onStatus((status) => this.dispatch(agentConnectionChanged(status))),\n        );\n        this.socket.connect();\n    }\n\n    /**\n     * Uploads files into SolidX media storage first, then sends their IDs with the socket message.\n     */\n    async sendMessage(text: string, context?: AgentContext, attachments: AgentAttachment[] = [], inputs?: Record<string, unknown>) {\n        const content = text.trim();\n        if (!content && !attachments.length) return;\n        const uploaded = attachments.length\n            ? await uploadAgentAttachments(this.agentUrl, attachments.map((item) => item.file))\n            : [];\n        if (uploaded.length !== attachments.length) {\n            throw new Error(\"SolidX did not confirm every uploaded file. Please retry.\");\n        }\n        if (context) this.lastContext = context;\n        const displayAttachments = attachments.map((item, index) => ({\n            ...item.meta,\n            ...(uploaded[index] ? { mediaId: uploaded[index].id } : {}),\n        }));\n        this.dispatch(agentUserMessageAdded({ text: content, attachments: displayAttachments }));\n        this.socket.send({\n            action: \"message\",\n            session_id: this.socket.currentSessionId ?? \"\",\n            content,\n            context: context ?? this.lastContext,\n            ...(this.agentRuntime === \"agentHub\" && inputs ? { inputs } : {}),\n            ...(attachments.length ? { attachments: uploaded } : {}),\n        });\n    }\n\n    /** Answers a widget. Sent as text too, so agents without widget_reply support still understand it. */\n    replyToWidget(widgetId: string, widget: string, value: unknown) {\n        const text = typeof value === \"string\" ? value : Array.isArray(value) ? value.join(\", \") : JSON.stringify(value);\n        this.dispatch(agentUserMessageAdded({ text }));\n        this.socket.send({\n            action: \"message\",\n            session_id: this.socket.currentSessionId ?? \"\",\n            content: text,\n            context: this.lastContext,\n            widget_reply: { widgetId, value },\n        });\n        eventBus.emit(SOLID_AGENT_EVENTS.widgetAction, { widgetId, widget, value, agentType: this.agentRuntime });\n    }\n\n    cancel() {\n        const sessionId = this.socket.currentSessionId;\n        if (sessionId) this.socket.send({ action: \"cancel\", session_id: sessionId });\n    }\n\n    newChat() {\n        if (this.persistSession) writeSessionId(this.sessionKey, null);\n        this.lastContext = undefined;\n        this.dispatch(agentThreadReset());\n        this.socket.newSession();\n    }\n\n    resume(sessionId: string) {\n        if (this.persistSession) writeSessionId(this.sessionKey, sessionId);\n        this.dispatch(agentThreadReset());\n        this.socket.resume(sessionId);\n    }\n\n    async loadOlder() {\n        const state = this.getState();\n        if (!state?.historySessionId || !state.hasMoreHistory) return;\n        await this.loadHistory(state.historySessionId, state.historyPage + 1);\n    }\n\n    dispose() {\n        this.unsubscribers.forEach((off) => off());\n        if (this.frame != null) cancelAnimationFrame(this.frame);\n        this.socket.close();\n    }\n\n    private async loadHistory(historySessionId: string, page: number) {\n        try {\n            const result = await fetchSessionHistory(this.agentUrl, historySessionId, page);\n            if (!result) return;\n            // Attached files are stored in Solid media storage; resolve their URLs before showing.\n            const rawItems = historyToItems(result.messages ?? []);\n            const items = this.persistSession ? await resolveAttachmentMedia(rawItems) : rawItems;\n            this.dispatch(agentHistoryLoaded({ items, hasMore: !!result.has_more, page }));\n        } catch {\n            // History is a convenience; the live session still works without it.\n        }\n    }\n\n    private handleFrame(frame: AgentWireFrame) {\n        const event = normalizeAgentFrame(frame);\n\n        // Stream text is batched per animation frame unless it carries a widget of its own.\n        if (event.eventType === AgentEventTypes.llmToken && !event.eventData.widget) {\n            this.pendingDelta += event.eventData.delta ?? \"\";\n            if (this.frame == null) this.frame = requestAnimationFrame(() => this.flushTokens());\n            return;\n        }\n        // Keep order: any buffered text lands before the next event.\n        this.flushTokens();\n        this.dispatch(agentEventReceived(event));\n        this.emitSdkEvents(event);\n    }\n\n    private emitSdkEvents(event: AgentChatEvent) {\n        if (event.eventType === AgentEventTypes.sessionStarted) {\n            const sessionId = event.frame.session_id ?? event.eventData.session_id ?? null;\n            if (this.persistSession) writeSessionId(this.sessionKey, sessionId);\n            eventBus.emit(SOLID_AGENT_EVENTS.sessionChanged, { sessionId, agentType: this.agentRuntime });\n            const state = this.getState();\n            const historyId = event.frame.history_session_id ?? event.eventData.history_session_id ?? sessionId;\n            if (state && state.items.length === 0 && historyId) void this.loadHistory(historyId, 1);\n        } else if (event.eventType === AgentEventTypes.turnComplete || event.eventType === AgentEventTypes.turnCompleteLegacy) {\n            eventBus.emit(SOLID_AGENT_EVENTS.turnComplete, {\n                sessionId: this.socket.currentSessionId,\n                agentType: this.agentRuntime,\n                content: event.eventData.content ?? event.frame.content,\n            });\n        }\n    }\n\n    private flushTokens() {\n        if (this.frame != null) {\n            cancelAnimationFrame(this.frame);\n            this.frame = null;\n        }\n        if (!this.pendingDelta) return;\n        const delta = this.pendingDelta;\n        this.pendingDelta = \"\";\n        this.dispatch(agentEventReceived(normalizeAgentFrame({ event_type: AgentEventTypes.llmToken, event_data: { delta } })));\n    }\n}\n\nlet runtime: AgentRuntime | null = null;\n\n/** Returns the shared \"solidx\" runtime, creating (or re-pointing) it for `agentUrl`. */\nexport function ensureAgentRuntime(agentUrl: string, dispatch: Dispatch, getState: GetAgentState): AgentRuntime {\n    if (runtime && runtime.agentUrl === agentUrl) return runtime;\n    runtime?.dispose();\n    runtime = new AgentRuntime(agentUrl, dispatch, getState);\n    return runtime;\n}\n\nexport function getAgentRuntime(): AgentRuntime | null {\n    return runtime;\n}\n\n/** Closes the connection and forgets this tab's agent logins (e.g. on logout). */\nexport function disposeAgentRuntime() {\n    runtime?.dispose();\n    runtime = null;\n    clearAllAgentAuth();\n}\n"]}

package/dist/components/core/solid-agent/client/agentRuntime.ts

@@ -0,0 +1,226 @@
+import { eventBus } from "../../../../helpers/eventBus";
+import {
+    agentConnectionChanged,
+    agentEventReceived,
+    agentHistoryLoaded,
+    agentThreadReset,
+    agentUserMessageAdded,
+    type AgentState,
+} from "../../../../redux/features/agentSlice";
+import { historyToItems, normalizeAgentFrame } from "../agentEvents";
+import { SOLID_AGENT_EVENTS } from "../sdk/solidAgent";
+import { AgentEventTypes, type AgentRuntimeType, type AgentAttachment, type AgentChatEvent, type AgentContext, type AgentWireFrame } from "../types";
+import { resolveAttachmentMedia } from "./agentAttachmentMedia";
+import { clearAllAgentAuth } from "./agentAuth";
+import { fetchSessionHistory, uploadAgentAttachments } from "./agentRest";
+import { AgentSocket } from "./agentSocket";
+import { agentIdOf } from "./agentUrls";
+
+/**
+ * A live connection to one agent backend. The "solidx" runtime is shared by the floating window and
+ * any embedded chat of that type (ensureAgentRuntime); other types get their own runtime per
+ * embedded chat (see useAgentChat). Owns the AgentSocket, normalises frames to `{ eventType, eventData }`, batches LlmToken
+ * deltas to one dispatch per animation frame, loads history on session start, and emits the
+ * public SDK events on the event bus.
+ */
+
+type Dispatch = (action: any) => any;
+type GetAgentState = () => AgentState | undefined;
+
+/** Keep the original SolidX storage key; Agent Hub keeps one per agent (its agent URL names the agent). */
+function sessionKey(agentRuntime: AgentRuntimeType, agentUrl: string) {
+    if (agentRuntime === "solidx") return "solid-agent.session_id";
+    const agentId = agentIdOf(agentUrl);
+    return agentId === undefined ? `solid-agent.${agentRuntime}.session_id` : `solid-agent.${agentRuntime}.${agentId}.session_id`;
+}
+
+function readSessionId(key: string): string | null {
+    try {
+        return localStorage.getItem(key);
+    } catch {
+        return null;
+    }
+}
+
+function writeSessionId(key: string, id: string | null) {
+    try {
+        id ? localStorage.setItem(key, id) : localStorage.removeItem(key);
+    } catch {
+        // Storage blocked (private mode); the session just won't survive a reload.
+    }
+}
+
+export class AgentRuntime {
+    readonly socket: AgentSocket;
+    private pendingDelta = "";
+    private frame: number | null = null;
+    private unsubscribers: Array<() => void> = [];
+    private lastContext: AgentContext | undefined;
+
+    private readonly sessionKey: string;
+
+    constructor(
+        readonly agentUrl: string,
+        private dispatch: Dispatch,
+        private getState: GetAgentState,
+        readonly agentRuntime: AgentRuntimeType = "solidx",
+        private persistSession = true,
+    ) {
+        this.sessionKey = sessionKey(agentRuntime, agentUrl);
+        this.socket = new AgentSocket(agentUrl, persistSession ? readSessionId(this.sessionKey) : null, agentRuntime === "agentHub");
+        this.unsubscribers.push(
+            this.socket.onEvent((frame) => this.handleFrame(frame)),
+            this.socket.onStatus((status) => this.dispatch(agentConnectionChanged(status))),
+        );
+        this.socket.connect();
+    }
+
+    /**
+     * Uploads files into SolidX media storage first, then sends their IDs with the socket message.
+     */
+    async sendMessage(text: string, context?: AgentContext, attachments: AgentAttachment[] = [], inputs?: Record<string, unknown>) {
+        const content = text.trim();
+        if (!content && !attachments.length) return;
+        const uploaded = attachments.length
+            ? await uploadAgentAttachments(this.agentUrl, attachments.map((item) => item.file))
+            : [];
+        if (uploaded.length !== attachments.length) {
+            throw new Error("SolidX did not confirm every uploaded file. Please retry.");
+        }
+        if (context) this.lastContext = context;
+        const displayAttachments = attachments.map((item, index) => ({
+            ...item.meta,
+            ...(uploaded[index] ? { mediaId: uploaded[index].id } : {}),
+        }));
+        this.dispatch(agentUserMessageAdded({ text: content, attachments: displayAttachments }));
+        this.socket.send({
+            action: "message",
+            session_id: this.socket.currentSessionId ?? "",
+            content,
+            context: context ?? this.lastContext,
+            ...(this.agentRuntime === "agentHub" && inputs ? { inputs } : {}),
+            ...(attachments.length ? { attachments: uploaded } : {}),
+        });
+    }
+
+    /** Answers a widget. Sent as text too, so agents without widget_reply support still understand it. */
+    replyToWidget(widgetId: string, widget: string, value: unknown) {
+        const text = typeof value === "string" ? value : Array.isArray(value) ? value.join(", ") : JSON.stringify(value);
+        this.dispatch(agentUserMessageAdded({ text }));
+        this.socket.send({
+            action: "message",
+            session_id: this.socket.currentSessionId ?? "",
+            content: text,
+            context: this.lastContext,
+            widget_reply: { widgetId, value },
+        });
+        eventBus.emit(SOLID_AGENT_EVENTS.widgetAction, { widgetId, widget, value, agentType: this.agentRuntime });
+    }
+
+    cancel() {
+        const sessionId = this.socket.currentSessionId;
+        if (sessionId) this.socket.send({ action: "cancel", session_id: sessionId });
+    }
+
+    newChat() {
+        if (this.persistSession) writeSessionId(this.sessionKey, null);
+        this.lastContext = undefined;
+        this.dispatch(agentThreadReset());
+        this.socket.newSession();
+    }
+
+    resume(sessionId: string) {
+        if (this.persistSession) writeSessionId(this.sessionKey, sessionId);
+        this.dispatch(agentThreadReset());
+        this.socket.resume(sessionId);
+    }
+
+    async loadOlder() {
+        const state = this.getState();
+        if (!state?.historySessionId || !state.hasMoreHistory) return;
+        await this.loadHistory(state.historySessionId, state.historyPage + 1);
+    }
+
+    dispose() {
+        this.unsubscribers.forEach((off) => off());
+        if (this.frame != null) cancelAnimationFrame(this.frame);
+        this.socket.close();
+    }
+
+    private async loadHistory(historySessionId: string, page: number) {
+        try {
+            const result = await fetchSessionHistory(this.agentUrl, historySessionId, page);
+            if (!result) return;
+            // Attached files are stored in Solid media storage; resolve their URLs before showing.
+            const rawItems = historyToItems(result.messages ?? []);
+            const items = this.persistSession ? await resolveAttachmentMedia(rawItems) : rawItems;
+            this.dispatch(agentHistoryLoaded({ items, hasMore: !!result.has_more, page }));
+        } catch {
+            // History is a convenience; the live session still works without it.
+        }
+    }
+
+    private handleFrame(frame: AgentWireFrame) {
+        const event = normalizeAgentFrame(frame);
+
+        // Stream text is batched per animation frame unless it carries a widget of its own.
+        if (event.eventType === AgentEventTypes.llmToken && !event.eventData.widget) {
+            this.pendingDelta += event.eventData.delta ?? "";
+            if (this.frame == null) this.frame = requestAnimationFrame(() => this.flushTokens());
+            return;
+        }
+        // Keep order: any buffered text lands before the next event.
+        this.flushTokens();
+        this.dispatch(agentEventReceived(event));
+        this.emitSdkEvents(event);
+    }
+
+    private emitSdkEvents(event: AgentChatEvent) {
+        if (event.eventType === AgentEventTypes.sessionStarted) {
+            const sessionId = event.frame.session_id ?? event.eventData.session_id ?? null;
+            if (this.persistSession) writeSessionId(this.sessionKey, sessionId);
+            eventBus.emit(SOLID_AGENT_EVENTS.sessionChanged, { sessionId, agentType: this.agentRuntime });
+            const state = this.getState();
+            const historyId = event.frame.history_session_id ?? event.eventData.history_session_id ?? sessionId;
+            if (state && state.items.length === 0 && historyId) void this.loadHistory(historyId, 1);
+        } else if (event.eventType === AgentEventTypes.turnComplete || event.eventType === AgentEventTypes.turnCompleteLegacy) {
+            eventBus.emit(SOLID_AGENT_EVENTS.turnComplete, {
+                sessionId: this.socket.currentSessionId,
+                agentType: this.agentRuntime,
+                content: event.eventData.content ?? event.frame.content,
+            });
+        }
+    }
+
+    private flushTokens() {
+        if (this.frame != null) {
+            cancelAnimationFrame(this.frame);
+            this.frame = null;
+        }
+        if (!this.pendingDelta) return;
+        const delta = this.pendingDelta;
+        this.pendingDelta = "";
+        this.dispatch(agentEventReceived(normalizeAgentFrame({ event_type: AgentEventTypes.llmToken, event_data: { delta } })));
+    }
+}
+
+let runtime: AgentRuntime | null = null;
+
+/** Returns the shared "solidx" runtime, creating (or re-pointing) it for `agentUrl`. */
+export function ensureAgentRuntime(agentUrl: string, dispatch: Dispatch, getState: GetAgentState): AgentRuntime {
+    if (runtime && runtime.agentUrl === agentUrl) return runtime;
+    runtime?.dispose();
+    runtime = new AgentRuntime(agentUrl, dispatch, getState);
+    return runtime;
+}
+
+export function getAgentRuntime(): AgentRuntime | null {
+    return runtime;
+}
+
+/** Closes the connection and forgets this tab's agent logins (e.g. on logout). */
+export function disposeAgentRuntime() {
+    runtime?.dispose();
+    runtime = null;
+    clearAllAgentAuth();
+}