@solidxai/core-ui 0.1.18 → 0.1.19-beta.1

package/dist/components/core/solid-agent/agentEvents.d.ts

@@ -0,0 +1,34 @@
+import { type AgentChatEvent, type AgentChatItem, type AgentCommand, type AgentWireFrame } from "./types";
+/**
+ * Turns agent events into thread items. Used by agentSlice for live socket frames and by the
+ * history loader for stored events, so both render identically.
+ *
+ * Rule: if `event_data.widget` is present the event becomes (or updates) a widget item rendered
+ * by that registered widget; otherwise the `event_type` switch below decides what, if anything,
+ * to add, and the thread renders it with the default widget for its type.
+ */
+/** The slice of chat state this reducer reads and writes (agentSlice state satisfies it). */
+export type AgentThreadState = {
+    items: AgentChatItem[];
+    sessionId: string | null;
+    historySessionId: string | null;
+    commands: AgentCommand[];
+    working: boolean;
+    thinking: boolean;
+    authError: string | null;
+    liveToolId: string | null;
+    streamingId: string | null;
+    turnStreamed: boolean;
+};
+export declare function createThreadState(): AgentThreadState;
+/** Accepts `{ event_type, event_data }` (current) and `{ type, data }` (legacy) frames. */
+export declare function normalizeAgentFrame(frame: AgentWireFrame): AgentChatEvent;
+export declare const nextItemId: (prefix: string) => string;
+/**
+ * Applies one event. `replay` is true when rebuilding from stored history: user messages then
+ * come from the event stream (live ones are added locally when the user sends them).
+ */
+export declare function applyAgentEvent(state: AgentThreadState, event: AgentChatEvent, replay?: boolean, at?: number): void;
+/** Rebuilds thread items from stored session events (`/api/agent/sessions/{id}/messages`). */
+export declare function historyToItems(rows: any[]): AgentChatItem[];
+//# sourceMappingURL=agentEvents.d.ts.map

package/dist/components/core/solid-agent/agentEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentEvents.d.ts","sourceRoot":"","sources":["../../../../src/components/core/solid-agent/agentEvents.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAE3H;;;;;;;GAOG;AAEH,6FAA6F;AAC7F,MAAM,MAAM,gBAAgB,GAAG;IAC3B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,wBAAgB,iBAAiB,IAAI,gBAAgB,CAapD;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAKzE;AAGD,eAAO,MAAM,UAAU,WAAY,MAAM,WAAuC,CAAC;AA0DjF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,UAAQ,EAAE,EAAE,SAAa,QAsK9G;AAED,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,aAAa,EAAE,CAU3D"}

package/dist/components/core/solid-agent/agentEvents.js

@@ -0,0 +1,282 @@
+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 __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+import { describeToolArgs, isLlmMetadata, parseToolResult } from "./agentFormat";
+import { AgentEventTypes } from "./types";
+export function createThreadState() {
+    return {
+        items: [],
+        sessionId: null,
+        historySessionId: null,
+        commands: [],
+        working: false,
+        thinking: false,
+        authError: null,
+        liveToolId: null,
+        streamingId: null,
+        turnStreamed: false,
+    };
+}
+/** Accepts `{ event_type, event_data }` (current) and `{ type, data }` (legacy) frames. */
+export function normalizeAgentFrame(frame) {
+    var _a, _b, _c, _d;
+    var eventType = (_b = (_a = frame.event_type) !== null && _a !== void 0 ? _a : frame.type) !== null && _b !== void 0 ? _b : "";
+    var raw = (_d = (_c = frame.event_data) !== null && _c !== void 0 ? _c : frame.data) !== null && _d !== void 0 ? _d : {};
+    var eventData = typeof raw === "object" && raw !== null ? raw : { value: raw };
+    return { eventType: eventType, eventData: eventData, frame: frame };
+}
+var seq = 0;
+export var nextItemId = function (prefix) { return "".concat(prefix, "-").concat(Date.now(), "-").concat(++seq); };
+function findItem(state, id) {
+    var _a;
+    return id ? (_a = state.items.find(function (item) { return item.id === id; })) !== null && _a !== void 0 ? _a : null : null;
+}
+function freezeLiveTool(state) {
+    var tool = findItem(state, state.liveToolId);
+    if (tool)
+        tool.live = false;
+    state.liveToolId = null;
+}
+function stopStreaming(state) {
+    var streaming = findItem(state, state.streamingId);
+    if (streaming)
+        streaming.live = false;
+    state.streamingId = null;
+}
+function endTurn(state) {
+    freezeLiveTool(state);
+    stopStreaming(state);
+    state.working = false;
+    state.thinking = false;
+}
+function lastAssistantText(state) {
+    for (var i = state.items.length - 1; i >= 0; i--) {
+        var item = state.items[i];
+        if (item.eventType === AgentEventTypes.llmComplete && !item.widget)
+            return item.eventData.content;
+        if (item.eventType === AgentEventTypes.userMessage)
+            return undefined;
+    }
+    return undefined;
+}
+function pushAssistantText(state, content, at) {
+    freezeLiveTool(state);
+    state.items.push({ id: nextItemId("llm"), at: at, eventType: AgentEventTypes.llmComplete, eventData: { content: content } });
+}
+/** Adds or updates the widget item named by `event_data.widget`. */
+function applyWidgetEvent(state, event, at) {
+    var _a, _b;
+    var eventType = event.eventType, eventData = event.eventData;
+    var widgetId = (_b = (_a = eventData.widgetId) !== null && _a !== void 0 ? _a : eventData.widget_id) !== null && _b !== void 0 ? _b : nextItemId(eventType || "widget");
+    var existing = state.items.find(function (item) { return item.widgetId === widgetId; });
+    if (existing) {
+        if (existing.final)
+            return;
+        existing.eventType = eventType;
+        existing.eventData = eventData;
+        existing.widget = eventData.widget;
+        existing.final = !!eventData.final;
+        return;
+    }
+    freezeLiveTool(state);
+    stopStreaming(state);
+    state.items.push({ id: nextItemId("w"), at: at, eventType: eventType, eventData: eventData, widget: eventData.widget, widgetId: widgetId, final: !!eventData.final });
+    state.thinking = false;
+}
+/**
+ * Applies one event. `replay` is true when rebuilding from stored history: user messages then
+ * come from the event stream (live ones are added locally when the user sends them).
+ */
+export function applyAgentEvent(state, event, replay, at) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2;
+    if (replay === void 0) { replay = false; }
+    if (at === void 0) { at = Date.now(); }
+    var eventType = event.eventType, eventData = event.eventData, frame = event.frame;
+    var hasWidget = typeof eventData.widget === "string" && eventData.widget.length > 0;
+    if (hasWidget) {
+        applyWidgetEvent(state, event, at);
+        // Widget events still close the turn when they are end-of-turn events.
+        switch (eventType) {
+            case AgentEventTypes.turnComplete:
+            case AgentEventTypes.turnCompleteLegacy:
+            case AgentEventTypes.executionCancelled:
+            case AgentEventTypes.executionCancelledLegacy:
+            case AgentEventTypes.agentError:
+            case AgentEventTypes.error:
+                endTurn(state);
+                break;
+        }
+        return;
+    }
+    switch (eventType) {
+        case AgentEventTypes.sessionStarted: {
+            var sessionId = (_b = (_a = frame.session_id) !== null && _a !== void 0 ? _a : eventData.session_id) !== null && _b !== void 0 ? _b : null;
+            state.sessionId = sessionId;
+            state.historySessionId = (_d = (_c = frame.history_session_id) !== null && _c !== void 0 ? _c : eventData.history_session_id) !== null && _d !== void 0 ? _d : sessionId;
+            var commands = (_e = frame.commands) !== null && _e !== void 0 ? _e : eventData.commands;
+            if (Array.isArray(commands))
+                state.commands = commands;
+            state.authError = null;
+            break;
+        }
+        case AgentEventTypes.sessionEnded:
+            state.sessionId = null;
+            break;
+        case AgentEventTypes.userMessage:
+            if (replay) {
+                var content = (_g = (_f = eventData.content) !== null && _f !== void 0 ? _f : frame.content) !== null && _g !== void 0 ? _g : "";
+                var attachments = Array.isArray(eventData.attachments) ? eventData.attachments : [];
+                if (content || attachments.length) {
+                    // agentEventId lets the UI fetch the stored attachment files (agentEvent media) later.
+                    var replayEventData = attachments.length
+                        ? { content: content, attachments: attachments, agentEventId: (_h = eventData.agentEventId) !== null && _h !== void 0 ? _h : frame.id }
+                        : { content: content };
+                    state.items.push({ id: nextItemId("u"), at: at, eventType: eventType, eventData: replayEventData });
+                }
+                state.liveToolId = null;
+            }
+            break;
+        case AgentEventTypes.agentStarted:
+        case AgentEventTypes.stepStarted:
+            if (!replay) {
+                state.working = true;
+                if (!state.liveToolId)
+                    state.thinking = true;
+            }
+            break;
+        case AgentEventTypes.stepComplete:
+        case AgentEventTypes.agentComplete:
+            freezeLiveTool(state);
+            break;
+        case AgentEventTypes.toolCalling: {
+            freezeLiveTool(state);
+            stopStreaming(state);
+            var toolName = (_k = (_j = eventData.tool_name) !== null && _j !== void 0 ? _j : frame.tool_name) !== null && _k !== void 0 ? _k : "tool";
+            var args = (_l = eventData.arguments) !== null && _l !== void 0 ? _l : {};
+            var id = nextItemId("tool");
+            state.items.push({
+                id: id,
+                at: at,
+                eventType: eventType,
+                eventData: { tool_name: toolName, arguments: args, summary: describeToolArgs(args, toolName) },
+                live: !replay,
+            });
+            state.liveToolId = id;
+            state.thinking = false;
+            break;
+        }
+        case AgentEventTypes.toolProgress: {
+            var tool = findItem(state, state.liveToolId);
+            if (!tool)
+                break;
+            var label_1 = (_m = eventData.label) !== null && _m !== void 0 ? _m : "";
+            var status_1 = eventData.status === "success" || eventData.status === "done" ? "done" : "running";
+            var progress = (_o = tool.eventData.progress) !== null && _o !== void 0 ? _o : [];
+            var index_1 = progress.findIndex(function (step) { return step.label === label_1; });
+            var step_1 = { label: label_1, status: status_1, duration_ms: (_p = eventData.duration_ms) !== null && _p !== void 0 ? _p : (_q = progress[index_1]) === null || _q === void 0 ? void 0 : _q.duration_ms };
+            tool.eventData = __assign(__assign({}, tool.eventData), { progress: index_1 >= 0 ? progress.map(function (entry, i) { return (i === index_1 ? step_1 : entry); }) : __spreadArray(__spreadArray([], progress, true), [step_1], false) });
+            break;
+        }
+        case AgentEventTypes.toolResult: {
+            var tool = findItem(state, state.liveToolId);
+            if (tool) {
+                var output = (_s = (_r = eventData.output) !== null && _r !== void 0 ? _r : frame.content) !== null && _s !== void 0 ? _s : "";
+                var parsed = output ? parseToolResult(String(output)) : null;
+                tool.eventData = __assign(__assign(__assign({}, tool.eventData), { duration_ms: (_t = eventData.duration_ms) !== null && _t !== void 0 ? _t : frame.duration_ms }), (parsed ? { status: parsed.status, output: parsed.text, output_raw: String(output) } : {}));
+            }
+            freezeLiveTool(state);
+            if (!replay)
+                state.thinking = true;
+            break;
+        }
+        case AgentEventTypes.llmToken: {
+            var delta = (_u = eventData.delta) !== null && _u !== void 0 ? _u : "";
+            if (!delta)
+                break;
+            freezeLiveTool(state);
+            state.thinking = false;
+            state.turnStreamed = true;
+            var streaming = findItem(state, state.streamingId);
+            if (streaming) {
+                streaming.eventData = __assign(__assign({}, streaming.eventData), { content: "".concat((_v = streaming.eventData.content) !== null && _v !== void 0 ? _v : "").concat(delta) });
+            }
+            else {
+                var id = nextItemId("stream");
+                state.items.push({ id: id, at: at, eventType: AgentEventTypes.llmComplete, eventData: { content: delta }, live: true });
+                state.streamingId = id;
+            }
+            break;
+        }
+        case AgentEventTypes.llmComplete: {
+            var content = (_x = (_w = eventData.content) !== null && _w !== void 0 ? _w : frame.content) !== null && _x !== void 0 ? _x : "";
+            var streamed = findItem(state, state.streamingId);
+            stopStreaming(state);
+            if (!content || isLlmMetadata(content))
+                break;
+            if (streamed)
+                streamed.eventData = __assign(__assign({}, streamed.eventData), { content: content }); // authoritative final text
+            else if (lastAssistantText(state) !== content)
+                pushAssistantText(state, content, at);
+            break;
+        }
+        case AgentEventTypes.turnComplete:
+        case AgentEventTypes.turnCompleteLegacy: {
+            var content = (_z = (_y = eventData.content) !== null && _y !== void 0 ? _y : frame.content) !== null && _z !== void 0 ? _z : "";
+            if (content && !state.turnStreamed && !isLlmMetadata(content) && lastAssistantText(state) !== content) {
+                pushAssistantText(state, content, at);
+            }
+            endTurn(state);
+            state.turnStreamed = false;
+            break;
+        }
+        case AgentEventTypes.executionCancelled:
+        case AgentEventTypes.executionCancelledLegacy:
+            endTurn(state);
+            state.items.push({ id: nextItemId("cancel"), at: at, eventType: AgentEventTypes.executionCancelled, eventData: { message: (_0 = eventData.message) !== null && _0 !== void 0 ? _0 : "Stopped." } });
+            break;
+        case AgentEventTypes.agentError:
+        case AgentEventTypes.error: {
+            var message = (_2 = (_1 = eventData.error) !== null && _1 !== void 0 ? _1 : frame.content) !== null && _2 !== void 0 ? _2 : "Unknown error";
+            endTurn(state);
+            if (!replay && /unauthori[sz]ed|access token|lacks required permission/i.test(message))
+                state.authError = message;
+            state.items.push({ id: nextItemId("err"), at: at, eventType: AgentEventTypes.agentError, eventData: { error: message } });
+            break;
+        }
+        default:
+            // Bookkeeping events (LlmRequest, SkillActivation, ...) are not rendered without a widget.
+            break;
+    }
+}
+/** Rebuilds thread items from stored session events (`/api/agent/sessions/{id}/messages`). */
+export function historyToItems(rows) {
+    var _a;
+    var state = createThreadState();
+    for (var _i = 0, rows_1 = rows; _i < rows_1.length; _i++) {
+        var row = rows_1[_i];
+        var frame = __assign(__assign({}, row), { event_type: (_a = row.event_type) !== null && _a !== void 0 ? _a : (row.role === "user" ? AgentEventTypes.userMessage : row.role === "assistant" ? AgentEventTypes.llmComplete : "") });
+        var at = row.timestamp ? new Date(row.timestamp).getTime() : Date.now();
+        applyAgentEvent(state, normalizeAgentFrame(frame), true, at);
+    }
+    freezeLiveTool(state);
+    stopStreaming(state);
+    return state.items;
+}
+//# sourceMappingURL=agentEvents.js.map

package/dist/components/core/solid-agent/agentEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentEvents.js","sourceRoot":"","sources":["../../../../src/components/core/solid-agent/agentEvents.ts"],"names":[],"mappings":"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","sourcesContent":["import { describeToolArgs, isLlmMetadata, parseToolResult } from \"./agentFormat\";\nimport { AgentEventTypes, type AgentChatEvent, type AgentChatItem, type AgentCommand, type AgentWireFrame } from \"./types\";\n\n/**\n * Turns agent events into thread items. Used by agentSlice for live socket frames and by the\n * history loader for stored events, so both render identically.\n *\n * Rule: if `event_data.widget` is present the event becomes (or updates) a widget item rendered\n * by that registered widget; otherwise the `event_type` switch below decides what, if anything,\n * to add, and the thread renders it with the default widget for its type.\n */\n\n/** The slice of chat state this reducer reads and writes (agentSlice state satisfies it). */\nexport type AgentThreadState = {\n    items: AgentChatItem[];\n    sessionId: string | null;\n    historySessionId: string | null;\n    commands: AgentCommand[];\n    working: boolean;\n    thinking: boolean;\n    authError: string | null;\n    liveToolId: string | null;\n    streamingId: string | null;\n    turnStreamed: boolean;\n};\n\nexport function createThreadState(): AgentThreadState {\n    return {\n        items: [],\n        sessionId: null,\n        historySessionId: null,\n        commands: [],\n        working: false,\n        thinking: false,\n        authError: null,\n        liveToolId: null,\n        streamingId: null,\n        turnStreamed: false,\n    };\n}\n\n/** Accepts `{ event_type, event_data }` (current) and `{ type, data }` (legacy) frames. */\nexport function normalizeAgentFrame(frame: AgentWireFrame): AgentChatEvent {\n    const eventType = frame.event_type ?? frame.type ?? \"\";\n    const raw = frame.event_data ?? frame.data ?? {};\n    const eventData = typeof raw === \"object\" && raw !== null ? raw : { value: raw };\n    return { eventType, eventData, frame };\n}\n\nlet seq = 0;\nexport const nextItemId = (prefix: string) => `${prefix}-${Date.now()}-${++seq}`;\n\nfunction findItem(state: AgentThreadState, id: string | null) {\n    return id ? state.items.find((item) => item.id === id) ?? null : null;\n}\n\nfunction freezeLiveTool(state: AgentThreadState) {\n    const tool = findItem(state, state.liveToolId);\n    if (tool) tool.live = false;\n    state.liveToolId = null;\n}\n\nfunction stopStreaming(state: AgentThreadState) {\n    const streaming = findItem(state, state.streamingId);\n    if (streaming) streaming.live = false;\n    state.streamingId = null;\n}\n\nfunction endTurn(state: AgentThreadState) {\n    freezeLiveTool(state);\n    stopStreaming(state);\n    state.working = false;\n    state.thinking = false;\n}\n\nfunction lastAssistantText(state: AgentThreadState): string | undefined {\n    for (let i = state.items.length - 1; i >= 0; i--) {\n        const item = state.items[i];\n        if (item.eventType === AgentEventTypes.llmComplete && !item.widget) return item.eventData.content;\n        if (item.eventType === AgentEventTypes.userMessage) return undefined;\n    }\n    return undefined;\n}\n\nfunction pushAssistantText(state: AgentThreadState, content: string, at: number) {\n    freezeLiveTool(state);\n    state.items.push({ id: nextItemId(\"llm\"), at, eventType: AgentEventTypes.llmComplete, eventData: { content } });\n}\n\n/** Adds or updates the widget item named by `event_data.widget`. */\nfunction applyWidgetEvent(state: AgentThreadState, event: AgentChatEvent, at: number) {\n    const { eventType, eventData } = event;\n    const widgetId: string = eventData.widgetId ?? eventData.widget_id ?? nextItemId(eventType || \"widget\");\n    const existing = state.items.find((item) => item.widgetId === widgetId);\n    if (existing) {\n        if (existing.final) return;\n        existing.eventType = eventType;\n        existing.eventData = eventData;\n        existing.widget = eventData.widget;\n        existing.final = !!eventData.final;\n        return;\n    }\n    freezeLiveTool(state);\n    stopStreaming(state);\n    state.items.push({ id: nextItemId(\"w\"), at, eventType, eventData, widget: eventData.widget, widgetId, final: !!eventData.final });\n    state.thinking = false;\n}\n\n/**\n * Applies one event. `replay` is true when rebuilding from stored history: user messages then\n * come from the event stream (live ones are added locally when the user sends them).\n */\nexport function applyAgentEvent(state: AgentThreadState, event: AgentChatEvent, replay = false, at = Date.now()) {\n    const { eventType, eventData, frame } = event;\n    const hasWidget = typeof eventData.widget === \"string\" && eventData.widget.length > 0;\n\n    if (hasWidget) {\n        applyWidgetEvent(state, event, at);\n        // Widget events still close the turn when they are end-of-turn events.\n        switch (eventType) {\n            case AgentEventTypes.turnComplete:\n            case AgentEventTypes.turnCompleteLegacy:\n            case AgentEventTypes.executionCancelled:\n            case AgentEventTypes.executionCancelledLegacy:\n            case AgentEventTypes.agentError:\n            case AgentEventTypes.error:\n                endTurn(state);\n                break;\n        }\n        return;\n    }\n\n    switch (eventType) {\n        case AgentEventTypes.sessionStarted: {\n            const sessionId = frame.session_id ?? eventData.session_id ?? null;\n            state.sessionId = sessionId;\n            state.historySessionId = frame.history_session_id ?? eventData.history_session_id ?? sessionId;\n            const commands = frame.commands ?? eventData.commands;\n            if (Array.isArray(commands)) state.commands = commands;\n            state.authError = null;\n            break;\n        }\n\n        case AgentEventTypes.sessionEnded:\n            state.sessionId = null;\n            break;\n\n        case AgentEventTypes.userMessage:\n            if (replay) {\n                const content = eventData.content ?? frame.content ?? \"\";\n                const attachments = Array.isArray(eventData.attachments) ? eventData.attachments : [];\n                if (content || attachments.length) {\n                    // agentEventId lets the UI fetch the stored attachment files (agentEvent media) later.\n                    const replayEventData = attachments.length\n                        ? { content, attachments, agentEventId: eventData.agentEventId ?? frame.id }\n                        : { content };\n                    state.items.push({ id: nextItemId(\"u\"), at, eventType, eventData: replayEventData });\n                }\n                state.liveToolId = null;\n            }\n            break;\n\n        case AgentEventTypes.agentStarted:\n        case AgentEventTypes.stepStarted:\n            if (!replay) {\n                state.working = true;\n                if (!state.liveToolId) state.thinking = true;\n            }\n            break;\n\n        case AgentEventTypes.stepComplete:\n        case AgentEventTypes.agentComplete:\n            freezeLiveTool(state);\n            break;\n\n        case AgentEventTypes.toolCalling: {\n            freezeLiveTool(state);\n            stopStreaming(state);\n            const toolName = eventData.tool_name ?? frame.tool_name ?? \"tool\";\n            const args = eventData.arguments ?? {};\n            const id = nextItemId(\"tool\");\n            state.items.push({\n                id,\n                at,\n                eventType,\n                eventData: { tool_name: toolName, arguments: args, summary: describeToolArgs(args, toolName) },\n                live: !replay,\n            });\n            state.liveToolId = id;\n            state.thinking = false;\n            break;\n        }\n\n        case AgentEventTypes.toolProgress: {\n            const tool = findItem(state, state.liveToolId);\n            if (!tool) break;\n            const label = eventData.label ?? \"\";\n            const status = eventData.status === \"success\" || eventData.status === \"done\" ? \"done\" : \"running\";\n            const progress: any[] = tool.eventData.progress ?? [];\n            const index = progress.findIndex((step) => step.label === label);\n            const step = { label, status, duration_ms: eventData.duration_ms ?? progress[index]?.duration_ms };\n            tool.eventData = { ...tool.eventData, progress: index >= 0 ? progress.map((entry, i) => (i === index ? step : entry)) : [...progress, step] };\n            break;\n        }\n\n        case AgentEventTypes.toolResult: {\n            const tool = findItem(state, state.liveToolId);\n            if (tool) {\n                const output = eventData.output ?? frame.content ?? \"\";\n                const parsed = output ? parseToolResult(String(output)) : null;\n                tool.eventData = {\n                    ...tool.eventData,\n                    duration_ms: eventData.duration_ms ?? frame.duration_ms,\n                    ...(parsed ? { status: parsed.status, output: parsed.text, output_raw: String(output) } : {}),\n                };\n            }\n            freezeLiveTool(state);\n            if (!replay) state.thinking = true;\n            break;\n        }\n\n        case AgentEventTypes.llmToken: {\n            const delta: string = eventData.delta ?? \"\";\n            if (!delta) break;\n            freezeLiveTool(state);\n            state.thinking = false;\n            state.turnStreamed = true;\n            const streaming = findItem(state, state.streamingId);\n            if (streaming) {\n                streaming.eventData = { ...streaming.eventData, content: `${streaming.eventData.content ?? \"\"}${delta}` };\n            } else {\n                const id = nextItemId(\"stream\");\n                state.items.push({ id, at, eventType: AgentEventTypes.llmComplete, eventData: { content: delta }, live: true });\n                state.streamingId = id;\n            }\n            break;\n        }\n\n        case AgentEventTypes.llmComplete: {\n            const content: string = eventData.content ?? frame.content ?? \"\";\n            const streamed = findItem(state, state.streamingId);\n            stopStreaming(state);\n            if (!content || isLlmMetadata(content)) break;\n            if (streamed) streamed.eventData = { ...streamed.eventData, content }; // authoritative final text\n            else if (lastAssistantText(state) !== content) pushAssistantText(state, content, at);\n            break;\n        }\n\n        case AgentEventTypes.turnComplete:\n        case AgentEventTypes.turnCompleteLegacy: {\n            const content: string = eventData.content ?? frame.content ?? \"\";\n            if (content && !state.turnStreamed && !isLlmMetadata(content) && lastAssistantText(state) !== content) {\n                pushAssistantText(state, content, at);\n            }\n            endTurn(state);\n            state.turnStreamed = false;\n            break;\n        }\n\n        case AgentEventTypes.executionCancelled:\n        case AgentEventTypes.executionCancelledLegacy:\n            endTurn(state);\n            state.items.push({ id: nextItemId(\"cancel\"), at, eventType: AgentEventTypes.executionCancelled, eventData: { message: eventData.message ?? \"Stopped.\" } });\n            break;\n\n        case AgentEventTypes.agentError:\n        case AgentEventTypes.error: {\n            const message: string = eventData.error ?? frame.content ?? \"Unknown error\";\n            endTurn(state);\n            if (!replay && /unauthori[sz]ed|access token|lacks required permission/i.test(message)) state.authError = message;\n            state.items.push({ id: nextItemId(\"err\"), at, eventType: AgentEventTypes.agentError, eventData: { error: message } });\n            break;\n        }\n\n        default:\n            // Bookkeeping events (LlmRequest, SkillActivation, ...) are not rendered without a widget.\n            break;\n    }\n}\n\n/** Rebuilds thread items from stored session events (`/api/agent/sessions/{id}/messages`). */\nexport function historyToItems(rows: any[]): AgentChatItem[] {\n    const state = createThreadState();\n    for (const row of rows) {\n        const frame: AgentWireFrame = { ...row, event_type: row.event_type ?? (row.role === \"user\" ? AgentEventTypes.userMessage : row.role === \"assistant\" ? AgentEventTypes.llmComplete : \"\") };\n        const at = row.timestamp ? new Date(row.timestamp).getTime() : Date.now();\n        applyAgentEvent(state, normalizeAgentFrame(frame), true, at);\n    }\n    freezeLiveTool(state);\n    stopStreaming(state);\n    return state.items;\n}\n"]}

package/dist/components/core/solid-agent/agentEvents.ts

@@ -0,0 +1,292 @@
+import { describeToolArgs, isLlmMetadata, parseToolResult } from "./agentFormat";
+import { AgentEventTypes, type AgentChatEvent, type AgentChatItem, type AgentCommand, type AgentWireFrame } from "./types";
+
+/**
+ * Turns agent events into thread items. Used by agentSlice for live socket frames and by the
+ * history loader for stored events, so both render identically.
+ *
+ * Rule: if `event_data.widget` is present the event becomes (or updates) a widget item rendered
+ * by that registered widget; otherwise the `event_type` switch below decides what, if anything,
+ * to add, and the thread renders it with the default widget for its type.
+ */
+
+/** The slice of chat state this reducer reads and writes (agentSlice state satisfies it). */
+export type AgentThreadState = {
+    items: AgentChatItem[];
+    sessionId: string | null;
+    historySessionId: string | null;
+    commands: AgentCommand[];
+    working: boolean;
+    thinking: boolean;
+    authError: string | null;
+    liveToolId: string | null;
+    streamingId: string | null;
+    turnStreamed: boolean;
+};
+
+export function createThreadState(): AgentThreadState {
+    return {
+        items: [],
+        sessionId: null,
+        historySessionId: null,
+        commands: [],
+        working: false,
+        thinking: false,
+        authError: null,
+        liveToolId: null,
+        streamingId: null,
+        turnStreamed: false,
+    };
+}
+
+/** Accepts `{ event_type, event_data }` (current) and `{ type, data }` (legacy) frames. */
+export function normalizeAgentFrame(frame: AgentWireFrame): AgentChatEvent {
+    const eventType = frame.event_type ?? frame.type ?? "";
+    const raw = frame.event_data ?? frame.data ?? {};
+    const eventData = typeof raw === "object" && raw !== null ? raw : { value: raw };
+    return { eventType, eventData, frame };
+}
+
+let seq = 0;
+export const nextItemId = (prefix: string) => `${prefix}-${Date.now()}-${++seq}`;
+
+function findItem(state: AgentThreadState, id: string | null) {
+    return id ? state.items.find((item) => item.id === id) ?? null : null;
+}
+
+function freezeLiveTool(state: AgentThreadState) {
+    const tool = findItem(state, state.liveToolId);
+    if (tool) tool.live = false;
+    state.liveToolId = null;
+}
+
+function stopStreaming(state: AgentThreadState) {
+    const streaming = findItem(state, state.streamingId);
+    if (streaming) streaming.live = false;
+    state.streamingId = null;
+}
+
+function endTurn(state: AgentThreadState) {
+    freezeLiveTool(state);
+    stopStreaming(state);
+    state.working = false;
+    state.thinking = false;
+}
+
+function lastAssistantText(state: AgentThreadState): string | undefined {
+    for (let i = state.items.length - 1; i >= 0; i--) {
+        const item = state.items[i];
+        if (item.eventType === AgentEventTypes.llmComplete && !item.widget) return item.eventData.content;
+        if (item.eventType === AgentEventTypes.userMessage) return undefined;
+    }
+    return undefined;
+}
+
+function pushAssistantText(state: AgentThreadState, content: string, at: number) {
+    freezeLiveTool(state);
+    state.items.push({ id: nextItemId("llm"), at, eventType: AgentEventTypes.llmComplete, eventData: { content } });
+}
+
+/** Adds or updates the widget item named by `event_data.widget`. */
+function applyWidgetEvent(state: AgentThreadState, event: AgentChatEvent, at: number) {
+    const { eventType, eventData } = event;
+    const widgetId: string = eventData.widgetId ?? eventData.widget_id ?? nextItemId(eventType || "widget");
+    const existing = state.items.find((item) => item.widgetId === widgetId);
+    if (existing) {
+        if (existing.final) return;
+        existing.eventType = eventType;
+        existing.eventData = eventData;
+        existing.widget = eventData.widget;
+        existing.final = !!eventData.final;
+        return;
+    }
+    freezeLiveTool(state);
+    stopStreaming(state);
+    state.items.push({ id: nextItemId("w"), at, eventType, eventData, widget: eventData.widget, widgetId, final: !!eventData.final });
+    state.thinking = false;
+}
+
+/**
+ * Applies one event. `replay` is true when rebuilding from stored history: user messages then
+ * come from the event stream (live ones are added locally when the user sends them).
+ */
+export function applyAgentEvent(state: AgentThreadState, event: AgentChatEvent, replay = false, at = Date.now()) {
+    const { eventType, eventData, frame } = event;
+    const hasWidget = typeof eventData.widget === "string" && eventData.widget.length > 0;
+
+    if (hasWidget) {
+        applyWidgetEvent(state, event, at);
+        // Widget events still close the turn when they are end-of-turn events.
+        switch (eventType) {
+            case AgentEventTypes.turnComplete:
+            case AgentEventTypes.turnCompleteLegacy:
+            case AgentEventTypes.executionCancelled:
+            case AgentEventTypes.executionCancelledLegacy:
+            case AgentEventTypes.agentError:
+            case AgentEventTypes.error:
+                endTurn(state);
+                break;
+        }
+        return;
+    }
+
+    switch (eventType) {
+        case AgentEventTypes.sessionStarted: {
+            const sessionId = frame.session_id ?? eventData.session_id ?? null;
+            state.sessionId = sessionId;
+            state.historySessionId = frame.history_session_id ?? eventData.history_session_id ?? sessionId;
+            const commands = frame.commands ?? eventData.commands;
+            if (Array.isArray(commands)) state.commands = commands;
+            state.authError = null;
+            break;
+        }
+
+        case AgentEventTypes.sessionEnded:
+            state.sessionId = null;
+            break;
+
+        case AgentEventTypes.userMessage:
+            if (replay) {
+                const content = eventData.content ?? frame.content ?? "";
+                const attachments = Array.isArray(eventData.attachments) ? eventData.attachments : [];
+                if (content || attachments.length) {
+                    // agentEventId lets the UI fetch the stored attachment files (agentEvent media) later.
+                    const replayEventData = attachments.length
+                        ? { content, attachments, agentEventId: eventData.agentEventId ?? frame.id }
+                        : { content };
+                    state.items.push({ id: nextItemId("u"), at, eventType, eventData: replayEventData });
+                }
+                state.liveToolId = null;
+            }
+            break;
+
+        case AgentEventTypes.agentStarted:
+        case AgentEventTypes.stepStarted:
+            if (!replay) {
+                state.working = true;
+                if (!state.liveToolId) state.thinking = true;
+            }
+            break;
+
+        case AgentEventTypes.stepComplete:
+        case AgentEventTypes.agentComplete:
+            freezeLiveTool(state);
+            break;
+
+        case AgentEventTypes.toolCalling: {
+            freezeLiveTool(state);
+            stopStreaming(state);
+            const toolName = eventData.tool_name ?? frame.tool_name ?? "tool";
+            const args = eventData.arguments ?? {};
+            const id = nextItemId("tool");
+            state.items.push({
+                id,
+                at,
+                eventType,
+                eventData: { tool_name: toolName, arguments: args, summary: describeToolArgs(args, toolName) },
+                live: !replay,
+            });
+            state.liveToolId = id;
+            state.thinking = false;
+            break;
+        }
+
+        case AgentEventTypes.toolProgress: {
+            const tool = findItem(state, state.liveToolId);
+            if (!tool) break;
+            const label = eventData.label ?? "";
+            const status = eventData.status === "success" || eventData.status === "done" ? "done" : "running";
+            const progress: any[] = tool.eventData.progress ?? [];
+            const index = progress.findIndex((step) => step.label === label);
+            const step = { label, status, duration_ms: eventData.duration_ms ?? progress[index]?.duration_ms };
+            tool.eventData = { ...tool.eventData, progress: index >= 0 ? progress.map((entry, i) => (i === index ? step : entry)) : [...progress, step] };
+            break;
+        }
+
+        case AgentEventTypes.toolResult: {
+            const tool = findItem(state, state.liveToolId);
+            if (tool) {
+                const output = eventData.output ?? frame.content ?? "";
+                const parsed = output ? parseToolResult(String(output)) : null;
+                tool.eventData = {
+                    ...tool.eventData,
+                    duration_ms: eventData.duration_ms ?? frame.duration_ms,
+                    ...(parsed ? { status: parsed.status, output: parsed.text, output_raw: String(output) } : {}),
+                };
+            }
+            freezeLiveTool(state);
+            if (!replay) state.thinking = true;
+            break;
+        }
+
+        case AgentEventTypes.llmToken: {
+            const delta: string = eventData.delta ?? "";
+            if (!delta) break;
+            freezeLiveTool(state);
+            state.thinking = false;
+            state.turnStreamed = true;
+            const streaming = findItem(state, state.streamingId);
+            if (streaming) {
+                streaming.eventData = { ...streaming.eventData, content: `${streaming.eventData.content ?? ""}${delta}` };
+            } else {
+                const id = nextItemId("stream");
+                state.items.push({ id, at, eventType: AgentEventTypes.llmComplete, eventData: { content: delta }, live: true });
+                state.streamingId = id;
+            }
+            break;
+        }
+
+        case AgentEventTypes.llmComplete: {
+            const content: string = eventData.content ?? frame.content ?? "";
+            const streamed = findItem(state, state.streamingId);
+            stopStreaming(state);
+            if (!content || isLlmMetadata(content)) break;
+            if (streamed) streamed.eventData = { ...streamed.eventData, content }; // authoritative final text
+            else if (lastAssistantText(state) !== content) pushAssistantText(state, content, at);
+            break;
+        }
+
+        case AgentEventTypes.turnComplete:
+        case AgentEventTypes.turnCompleteLegacy: {
+            const content: string = eventData.content ?? frame.content ?? "";
+            if (content && !state.turnStreamed && !isLlmMetadata(content) && lastAssistantText(state) !== content) {
+                pushAssistantText(state, content, at);
+            }
+            endTurn(state);
+            state.turnStreamed = false;
+            break;
+        }
+
+        case AgentEventTypes.executionCancelled:
+        case AgentEventTypes.executionCancelledLegacy:
+            endTurn(state);
+            state.items.push({ id: nextItemId("cancel"), at, eventType: AgentEventTypes.executionCancelled, eventData: { message: eventData.message ?? "Stopped." } });
+            break;
+
+        case AgentEventTypes.agentError:
+        case AgentEventTypes.error: {
+            const message: string = eventData.error ?? frame.content ?? "Unknown error";
+            endTurn(state);
+            if (!replay && /unauthori[sz]ed|access token|lacks required permission/i.test(message)) state.authError = message;
+            state.items.push({ id: nextItemId("err"), at, eventType: AgentEventTypes.agentError, eventData: { error: message } });
+            break;
+        }
+
+        default:
+            // Bookkeeping events (LlmRequest, SkillActivation, ...) are not rendered without a widget.
+            break;
+    }
+}
+
+/** Rebuilds thread items from stored session events (`/api/agent/sessions/{id}/messages`). */
+export function historyToItems(rows: any[]): AgentChatItem[] {
+    const state = createThreadState();
+    for (const row of rows) {
+        const frame: AgentWireFrame = { ...row, event_type: row.event_type ?? (row.role === "user" ? AgentEventTypes.userMessage : row.role === "assistant" ? AgentEventTypes.llmComplete : "") };
+        const at = row.timestamp ? new Date(row.timestamp).getTime() : Date.now();
+        applyAgentEvent(state, normalizeAgentFrame(frame), true, at);
+    }
+    freezeLiveTool(state);
+    stopStreaming(state);
+    return state.items;
+}