@portablecore/chat-runtime 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @portablecore/chat-runtime
+ *
+ * Headless chat runtime for Portable platforms.
+ * SSE streaming, message state management, and lifecycle hooks.
+ *
+ * No UI components — compose with @portablecore/chat for the full
+ * unified chat experience, or use these primitives directly for
+ * custom surfaces.
+ */
+export { useChatRuntime } from "./use-chat-runtime.js";
+export type { UseChatRuntimeOptions, ChatRuntime, PersistMessageResult, } from "./use-chat-runtime.js";
+export { useStreamingMessage } from "./use-streaming-message.js";
+export type { UseStreamingMessageReturn } from "./use-streaming-message.js";
+export { useSkillIndicators } from "./use-skill-indicators.js";
+export type { UseSkillIndicatorsReturn, SkillThinkingStage, ActiveSkillState, SkillConfig, SkillResultEntry, } from "./use-skill-indicators.js";
+export { parseSseStream, fetchWithRetry } from "./sse-client.js";
+export type { SseEvent, SseThinkingEvent, SseSkillStartEvent, SseSkillResultEvent, SseTextEvent, SseReplaceContentEvent, SseDoneEvent, SseErrorEvent, SseFirstResponseEvent, LiteMessage, } from "@portablecore/types/chat";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,YAAY,EACV,qBAAqB,EACrB,WAAW,EACX,oBAAoB,GACrB,MAAM,uBAAuB,CAAA;AAG9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,YAAY,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAA;AAG3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,YAAY,EACV,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,GACjB,MAAM,2BAA2B,CAAA;AAGlC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGhE,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,WAAW,GACZ,MAAM,0BAA0B,CAAA"}

package/dist/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * @portablecore/chat-runtime
+ *
+ * Headless chat runtime for Portable platforms.
+ * SSE streaming, message state management, and lifecycle hooks.
+ *
+ * No UI components — compose with @portablecore/chat for the full
+ * unified chat experience, or use these primitives directly for
+ * custom surfaces.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchWithRetry = exports.parseSseStream = exports.useSkillIndicators = exports.useStreamingMessage = exports.useChatRuntime = void 0;
+// Headless chat hook
+var use_chat_runtime_js_1 = require("./use-chat-runtime.js");
+Object.defineProperty(exports, "useChatRuntime", { enumerable: true, get: function () { return use_chat_runtime_js_1.useChatRuntime; } });
+// RAF-batched streaming message accumulator
+var use_streaming_message_js_1 = require("./use-streaming-message.js");
+Object.defineProperty(exports, "useStreamingMessage", { enumerable: true, get: function () { return use_streaming_message_js_1.useStreamingMessage; } });
+// Skill and thinking indicator state
+var use_skill_indicators_js_1 = require("./use-skill-indicators.js");
+Object.defineProperty(exports, "useSkillIndicators", { enumerable: true, get: function () { return use_skill_indicators_js_1.useSkillIndicators; } });
+// SSE client
+var sse_client_js_1 = require("./sse-client.js");
+Object.defineProperty(exports, "parseSseStream", { enumerable: true, get: function () { return sse_client_js_1.parseSseStream; } });
+Object.defineProperty(exports, "fetchWithRetry", { enumerable: true, get: function () { return sse_client_js_1.fetchWithRetry; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,qBAAqB;AACrB,6DAAsD;AAA7C,qHAAA,cAAc,OAAA;AAOvB,4CAA4C;AAC5C,uEAAgE;AAAvD,+HAAA,mBAAmB,OAAA;AAG5B,qCAAqC;AACrC,qEAA8D;AAArD,6HAAA,kBAAkB,OAAA;AAS3B,aAAa;AACb,iDAAgE;AAAvD,+GAAA,cAAc,OAAA;AAAE,+GAAA,cAAc,OAAA"}

package/dist/sse-client.d.ts

@@ -0,0 +1,25 @@
+/**
+ * SSE Client — Stream parsing and fetch utilities
+ *
+ * Shared utilities for connecting to /api/chat/stream endpoints
+ * and parsing Server-Sent Events into typed SseEvent objects.
+ *
+ * Both full chat and lite chat surfaces consume this same parser.
+ * Each surface handles only the events it cares about.
+ */
+import type { SseEvent } from "@portablecore/types/chat";
+/**
+ * Async generator that reads an SSE response body and yields typed SseEvent objects.
+ *
+ * Uses double-newline as event boundaries. Handles partial chunk buffering.
+ *
+ * Abort: pass an AbortSignal to the fetch call. When aborted, reader.read()
+ * rejects with AbortError, propagating to the consumer's catch block.
+ */
+export declare function parseSseStream(response: Response): AsyncGenerator<SseEvent>;
+/**
+ * Fetch wrapper with single retry for transient network failures.
+ * Does NOT retry on AbortError (user-initiated cancellation).
+ */
+export declare function fetchWithRetry(url: string, options: RequestInit, maxRetries?: number): Promise<Response>;
+//# sourceMappingURL=sse-client.d.ts.map

package/dist/sse-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-client.d.ts","sourceRoot":"","sources":["../src/sse-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAyFxD;;;;;;;GAOG;AACH,wBAAuB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAsDlF;AAMD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,EACpB,UAAU,SAAI,GACb,OAAO,CAAC,QAAQ,CAAC,CAoBnB"}

package/dist/sse-client.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * SSE Client — Stream parsing and fetch utilities
+ *
+ * Shared utilities for connecting to /api/chat/stream endpoints
+ * and parsing Server-Sent Events into typed SseEvent objects.
+ *
+ * Both full chat and lite chat surfaces consume this same parser.
+ * Each surface handles only the events it cares about.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSseStream = parseSseStream;
+exports.fetchWithRetry = fetchWithRetry;
+// ---------------------------------------------------------------------------
+// SSE Stream Parser
+// ---------------------------------------------------------------------------
+/**
+ * Parse a single SSE data line into a typed SseEvent.
+ * Returns null for non-data lines or unparseable content.
+ */
+function parseSseLine(line) {
+    if (!line.startsWith("data: "))
+        return null;
+    try {
+        const data = JSON.parse(line.slice(6));
+        if (data.thinking) {
+            return {
+                type: "thinking",
+                stage: data.thinking.stage,
+                detail: data.thinking.detail,
+                showIcon: data.thinking.showIcon,
+            };
+        }
+        if (data.skill_start) {
+            return {
+                type: "skill_start",
+                skillSlug: data.skill_start.skillSlug,
+                skillName: data.skill_start.skillName,
+                contextualMessage: data.skill_start.contextualMessage,
+            };
+        }
+        if (data.skill_result) {
+            return {
+                type: "skill_result",
+                skillSlug: data.skill_result.skillSlug,
+                skillName: data.skill_result.skillName,
+                success: data.skill_result.success,
+                error: data.skill_result.error,
+                duration_ms: data.skill_result.duration_ms,
+                citations: data.skill_result.citations,
+                sources: data.skill_result.sources,
+                locations: data.skill_result.locations,
+                booking_links: data.skill_result.booking_links,
+                documents: data.skill_result.documents,
+                notion_results: data.skill_result.notion_results,
+                craft_results: data.skill_result.craft_results,
+            };
+        }
+        if (data.first_response) {
+            return {
+                type: "first_response",
+                messageId: data.first_response.messageId,
+                content: data.first_response.content,
+            };
+        }
+        if (data.replace_content !== undefined) {
+            return { type: "replace_content" };
+        }
+        if (data.text) {
+            return { type: "text", text: data.text };
+        }
+        if (data.done) {
+            return {
+                type: "done",
+                messageId: data.messageId,
+                provider: data.provider,
+                model: data.model,
+                skill_usage: data.skill_usage,
+                expert_suggestion: data.expert_suggestion,
+            };
+        }
+        if (data.error) {
+            return { type: "error", error: data.error };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Async generator that reads an SSE response body and yields typed SseEvent objects.
+ *
+ * Uses double-newline as event boundaries. Handles partial chunk buffering.
+ *
+ * Abort: pass an AbortSignal to the fetch call. When aborted, reader.read()
+ * rejects with AbortError, propagating to the consumer's catch block.
+ */
+async function* parseSseStream(response) {
+    const reader = response.body?.getReader();
+    if (!reader) {
+        throw new Error("No response body");
+    }
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const events = buffer.split("\n\n");
+            buffer = events.pop() || "";
+            for (const rawEvent of events) {
+                const parsed = parseSseLine(rawEvent.trim());
+                if (parsed) {
+                    yield parsed;
+                }
+                else {
+                    for (const line of rawEvent.split("\n")) {
+                        const lineParsed = parseSseLine(line.trim());
+                        if (lineParsed) {
+                            yield lineParsed;
+                        }
+                    }
+                }
+            }
+        }
+        if (buffer.trim()) {
+            buffer += decoder.decode();
+            const remaining = buffer.split("\n\n");
+            for (const rawEvent of remaining) {
+                const parsed = parseSseLine(rawEvent.trim());
+                if (parsed) {
+                    yield parsed;
+                }
+                else {
+                    for (const line of rawEvent.split("\n")) {
+                        const lineParsed = parseSseLine(line.trim());
+                        if (lineParsed) {
+                            yield lineParsed;
+                        }
+                    }
+                }
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+// ---------------------------------------------------------------------------
+// Fetch with Retry
+// ---------------------------------------------------------------------------
+/**
+ * Fetch wrapper with single retry for transient network failures.
+ * Does NOT retry on AbortError (user-initiated cancellation).
+ */
+async function fetchWithRetry(url, options, maxRetries = 1) {
+    let lastError = null;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fetch(url, options);
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err : new Error(String(err));
+            if (lastError.name === "AbortError") {
+                throw lastError;
+            }
+            if (attempt < maxRetries) {
+                await new Promise((resolve) => setTimeout(resolve, 500));
+            }
+        }
+    }
+    throw lastError || new Error("Fetch failed after retries");
+}
+//# sourceMappingURL=sse-client.js.map

package/dist/sse-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-client.js","sourceRoot":"","sources":["../src/sse-client.ts"],"names":[],"mappings":"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"}

package/dist/use-chat-runtime.d.ts

@@ -0,0 +1,67 @@
+import type { LiteMessage, SseEvent } from "@portablecore/types/chat";
+/** Result of persisting a user message. */
+export interface PersistMessageResult {
+    /** Persisted message ID, or null on failure */
+    id: string | null;
+    /** Sender's user ID, or null if unavailable */
+    userId: string | null;
+}
+export interface UseChatRuntimeOptions {
+    /** Current chat ID. Can be null initially (lazy creation). */
+    chatId: string | null;
+    /** Expert to stream responses from. */
+    expertId: string;
+    /**
+     * Persist a user message before streaming. Platform-specific.
+     * Expert: saves to Supabase messages table.
+     * Team: saves to Team's local messages table.
+     * If omitted, no local persistence (stream endpoint handles it).
+     */
+    persistMessage?: (chatId: string, content: string) => Promise<PersistMessageResult>;
+    /** Display name of the sender (for multi-human chat context). */
+    senderName?: string;
+    /**
+     * Pre-warmed context from useChatWarmup. Passed through to the stream endpoint.
+     */
+    warmContext?: any;
+    /**
+     * Streaming API endpoint. Defaults to "/api/chat/stream".
+     */
+    streamEndpoint?: string;
+    /**
+     * Extra parameters merged into the stream POST body.
+     * Use for surface-specific fields (provider overrides, voice mode, etc.).
+     */
+    streamBody?: Record<string, unknown>;
+    /**
+     * Callback for SSE events. Called for EVERY event so the surface
+     * has full visibility (thinking indicators, skill results, etc.).
+     */
+    onEvent?: (event: SseEvent) => void;
+}
+export interface ChatRuntime {
+    /** Current messages in the conversation. */
+    messages: LiteMessage[];
+    /** Whether an expert response is currently streaming. */
+    streaming: boolean;
+    /** Whether a user message is being saved (before streaming starts). */
+    sending: boolean;
+    /** First Responder → full response transition. */
+    frTransitioning: boolean;
+    /** Expert is executing a skill mid-stream. */
+    skillTransitioning: boolean;
+    /** The resolved chat ID. */
+    chatId: string | null;
+    /**
+     * Send a message: persist the user message, then stream the expert response.
+     * @param content - The message text.
+     * @param chatIdOverride - Optional chat ID override for first-send case.
+     */
+    send: (content: string, chatIdOverride?: string) => Promise<void>;
+    /** Abort the in-flight stream. Preserves any partial response. */
+    abort: () => void;
+    /** Clear all messages from the runtime state. */
+    clear: () => void;
+}
+export declare function useChatRuntime(options: UseChatRuntimeOptions): ChatRuntime;
+//# sourceMappingURL=use-chat-runtime.d.ts.map

package/dist/use-chat-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chat-runtime.d.ts","sourceRoot":"","sources":["../src/use-chat-runtime.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAMrE,2CAA2C;AAC3C,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACjB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAA;IACnF,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;OAEG;IAEH,WAAW,CAAC,EAAE,GAAG,CAAA;IACjB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAA;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,yDAAyD;IACzD,SAAS,EAAE,OAAO,CAAA;IAClB,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAA;IAChB,kDAAkD;IAClD,eAAe,EAAE,OAAO,CAAA;IACxB,8CAA8C;IAC9C,kBAAkB,EAAE,OAAO,CAAA;IAC3B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB;;;;OAIG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjE,kEAAkE;IAClE,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,iDAAiD;IACjD,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAMD,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,WAAW,CAkU1E"}

package/dist/use-chat-runtime.js

@@ -0,0 +1,274 @@
+"use client";
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useChatRuntime = useChatRuntime;
+/**
+ * useChatRuntime — Headless chat lifecycle hook
+ *
+ * Manages the chat lifecycle without any UI: message state, streaming,
+ * persistence, and abort. Surfaces compose this hook with their own
+ * UI components and surface-specific features.
+ *
+ * Platform-specific concerns (message persistence, auth) are handled
+ * via callbacks rather than direct Supabase coupling.
+ *
+ * Usage:
+ *   const chat = useChatRuntime({ chatId, expertId, ... })
+ *   chat.messages      // LiteMessage[]
+ *   chat.streaming     // boolean
+ *   chat.send(content) // Save user message + trigger expert stream
+ *   chat.abort()       // Cancel in-flight stream
+ */
+const react_1 = require("react");
+const sse_client_js_1 = require("./sse-client.js");
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+function useChatRuntime(options) {
+    const { chatId: externalChatId, expertId, persistMessage, senderName, warmContext, streamEndpoint = "/api/chat/stream", streamBody, onEvent, } = options;
+    // ---- State ----
+    const [messages, setMessages] = (0, react_1.useState)([]);
+    const [streaming, setStreaming] = (0, react_1.useState)(false);
+    const [sending, setSending] = (0, react_1.useState)(false);
+    const [frTransitioning, setFrTransitioning] = (0, react_1.useState)(false);
+    const frTransitioningRef = (0, react_1.useRef)(false);
+    const [skillTransitioning, setSkillTransitioning] = (0, react_1.useState)(false);
+    const skillTransitioningRef = (0, react_1.useRef)(false);
+    const [chatId, setChatId] = (0, react_1.useState)(externalChatId);
+    (0, react_1.useEffect)(() => {
+        if (externalChatId) {
+            setChatId(externalChatId);
+        }
+    }, [externalChatId]);
+    // ---- Refs ----
+    const abortRef = (0, react_1.useRef)(null);
+    const pendingText = (0, react_1.useRef)("");
+    const rafId = (0, react_1.useRef)(null);
+    const streamTempId = (0, react_1.useRef)(null);
+    const onEventRef = (0, react_1.useRef)(onEvent);
+    (0, react_1.useEffect)(() => {
+        onEventRef.current = onEvent;
+    }, [onEvent]);
+    // ---- RAF Batching ----
+    const flushContent = (0, react_1.useCallback)(() => {
+        rafId.current = null;
+        const text = pendingText.current;
+        const tempId = streamTempId.current;
+        if (!text || !tempId)
+            return;
+        pendingText.current = "";
+        setMessages((prev) => prev.map((m) => (m.id === tempId ? { ...m, content: m.content + text } : m)));
+    }, []);
+    const scheduleFlush = (0, react_1.useCallback)((text) => {
+        pendingText.current += text;
+        if (rafId.current === null) {
+            rafId.current = requestAnimationFrame(flushContent);
+        }
+    }, [flushContent]);
+    const forceFlush = (0, react_1.useCallback)(() => {
+        if (rafId.current !== null) {
+            cancelAnimationFrame(rafId.current);
+            rafId.current = null;
+        }
+        const text = pendingText.current;
+        const tempId = streamTempId.current;
+        if (text && tempId) {
+            pendingText.current = "";
+            setMessages((prev) => prev.map((m) => (m.id === tempId ? { ...m, content: m.content + text } : m)));
+        }
+    }, []);
+    (0, react_1.useEffect)(() => {
+        return () => {
+            if (rafId.current !== null) {
+                cancelAnimationFrame(rafId.current);
+            }
+        };
+    }, []);
+    // ---- Stream ----
+    const streamResponse = (0, react_1.useCallback)(async (activeChatId, userMessage, userMessageId, senderUserId) => {
+        setStreaming(true);
+        const tempId = `stream-${Date.now()}`;
+        streamTempId.current = tempId;
+        pendingText.current = "";
+        setMessages((prev) => [
+            ...prev,
+            {
+                id: tempId,
+                role: "assistant",
+                content: "",
+                streaming: true,
+                createdAt: new Date().toISOString(),
+            },
+        ]);
+        const controller = new AbortController();
+        abortRef.current = controller;
+        try {
+            const response = await fetch(streamEndpoint, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    chatId: activeChatId,
+                    expertId,
+                    message: userMessage,
+                    userMessageId,
+                    senderName,
+                    senderUserId,
+                    warmContext: warmContext || undefined,
+                    timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+                    ...streamBody,
+                }),
+                signal: controller.signal,
+            });
+            if (!response.ok || !response.body) {
+                setMessages((prev) => prev.map((m) => m.id === tempId
+                    ? { ...m, content: "Something went wrong. Try again.", streaming: false }
+                    : m));
+                setStreaming(false);
+                return;
+            }
+            for await (const event of (0, sse_client_js_1.parseSseStream)(response)) {
+                onEventRef.current?.(event);
+                switch (event.type) {
+                    case "first_response": {
+                        forceFlush();
+                        pendingText.current = "";
+                        const frTarget = streamTempId.current || tempId;
+                        setMessages((prev) => prev.map((m) => (m.id === frTarget ? { ...m, content: m.content + "\n\n" } : m)));
+                        frTransitioningRef.current = true;
+                        setFrTransitioning(true);
+                        break;
+                    }
+                    case "replace_content": {
+                        forceFlush();
+                        pendingText.current = "";
+                        const replaceTarget = streamTempId.current || tempId;
+                        setMessages((prev) => prev.filter((m) => m.id !== replaceTarget));
+                        break;
+                    }
+                    case "skill_start": {
+                        skillTransitioningRef.current = true;
+                        setSkillTransitioning(true);
+                        break;
+                    }
+                    case "text": {
+                        if (frTransitioningRef.current) {
+                            frTransitioningRef.current = false;
+                            setFrTransitioning(false);
+                        }
+                        if (skillTransitioningRef.current) {
+                            skillTransitioningRef.current = false;
+                            setSkillTransitioning(false);
+                        }
+                        scheduleFlush(event.text);
+                        break;
+                    }
+                    case "done": {
+                        forceFlush();
+                        const remainingText = pendingText.current;
+                        pendingText.current = "";
+                        const finalMessageId = event.messageId;
+                        const doneTarget = streamTempId.current || tempId;
+                        setMessages((prev) => prev.map((m) => m.id === doneTarget
+                            ? {
+                                ...m,
+                                id: finalMessageId || doneTarget,
+                                content: m.content + remainingText,
+                                streaming: false,
+                            }
+                            : m));
+                        break;
+                    }
+                    case "error": {
+                        forceFlush();
+                        pendingText.current = "";
+                        const errorTarget = streamTempId.current || tempId;
+                        setMessages((prev) => prev.map((m) => m.id === errorTarget
+                            ? { ...m, content: m.content || event.error, streaming: false }
+                            : m));
+                        break;
+                    }
+                }
+            }
+            setMessages((prev) => prev.map((m) => (m.streaming ? { ...m, streaming: false } : m)));
+        }
+        catch (err) {
+            if (err.name !== "AbortError") {
+                setMessages((prev) => prev.map((m) => m.id === tempId
+                    ? { ...m, content: "Connection lost. Try again.", streaming: false }
+                    : m));
+            }
+        }
+        finally {
+            if (rafId.current !== null) {
+                cancelAnimationFrame(rafId.current);
+                rafId.current = null;
+            }
+            pendingText.current = "";
+            streamTempId.current = null;
+            setStreaming(false);
+            frTransitioningRef.current = false;
+            setFrTransitioning(false);
+            skillTransitioningRef.current = false;
+            setSkillTransitioning(false);
+            abortRef.current = null;
+        }
+    }, [expertId, senderName, warmContext, streamEndpoint, streamBody, scheduleFlush, forceFlush]);
+    // ---- Public API ----
+    const send = (0, react_1.useCallback)(async (content, chatIdOverride) => {
+        const activeChatId = chatIdOverride || chatId;
+        if (!content.trim() || sending || streaming || !activeChatId)
+            return;
+        if (chatIdOverride && chatIdOverride !== chatId) {
+            setChatId(chatIdOverride);
+        }
+        setSending(true);
+        const userTempId = `user-${Date.now()}`;
+        setMessages((prev) => [
+            ...prev,
+            { id: userTempId, role: "user", content, createdAt: new Date().toISOString() },
+        ]);
+        try {
+            let savedId = null;
+            let senderUserId = null;
+            if (persistMessage) {
+                const result = await persistMessage(activeChatId, content);
+                savedId = result.id;
+                senderUserId = result.userId;
+            }
+            if (savedId) {
+                setMessages((prev) => prev.map((m) => (m.id === userTempId ? { ...m, id: savedId } : m)));
+            }
+            setSending(false);
+            await streamResponse(activeChatId, content, savedId, senderUserId);
+        }
+        catch (err) {
+            console.error("[ChatRuntime] Error in send:", err);
+            setSending(false);
+        }
+    }, [chatId, sending, streaming, persistMessage, streamResponse]);
+    const abort = (0, react_1.useCallback)(() => {
+        if (abortRef.current) {
+            abortRef.current.abort();
+            abortRef.current = null;
+        }
+        forceFlush();
+        pendingText.current = "";
+        setMessages((prev) => prev.map((m) => (m.streaming ? { ...m, streaming: false } : m)));
+        setStreaming(false);
+    }, [forceFlush]);
+    const clear = (0, react_1.useCallback)(() => {
+        setMessages([]);
+    }, []);
+    return {
+        messages,
+        streaming,
+        sending,
+        frTransitioning,
+        skillTransitioning,
+        chatId,
+        send,
+        abort,
+        clear,
+    };
+}
+//# sourceMappingURL=use-chat-runtime.js.map

package/dist/use-chat-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chat-runtime.js","sourceRoot":"","sources":["../src/use-chat-runtime.ts"],"names":[],"mappings":"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"}

package/dist/use-skill-indicators.d.ts

@@ -0,0 +1,51 @@
+import type { SseEvent } from "@portablecore/types/chat";
+/** Thinking stage for the ThinkingIndicator component. */
+export interface SkillThinkingStage {
+    stage: "memories" | "knowledge" | "context" | "skills" | "thinking";
+    detail?: string;
+    showIcon?: boolean;
+}
+/** Active skill indicator state for the SkillIndicator component. */
+export interface ActiveSkillState {
+    slug: string;
+    name: string;
+    showSkillPill?: boolean;
+    skillPillText?: string | null;
+}
+/**
+ * Minimal skill config needed by the hook.
+ * Consumer passes their full skill array; only these fields are read.
+ */
+export interface SkillConfig {
+    slug: string;
+    showSkillPill: boolean;
+    skillPillText: string | null;
+}
+/** Accumulated skill result entry from streaming. */
+export interface SkillResultEntry {
+    skill_slug: string;
+    skill_name: string;
+    invoked_at: string;
+    duration_ms: number;
+    citations?: any[];
+    sources?: any[];
+    locations?: any[];
+    booking_links?: any[];
+    documents?: any[];
+}
+export interface UseSkillIndicatorsReturn {
+    /** Currently active skill (for skill pill indicator). Null when idle. */
+    activeSkill: ActiveSkillState | null;
+    /** Accumulated thinking stages for the current response. */
+    thinkingStages: SkillThinkingStage[];
+    /** Ref to accumulated skill results for the current response. */
+    pendingSkillResults: React.MutableRefObject<SkillResultEntry[]>;
+    /** Process a thinking, skill_start, or skill_result SSE event. */
+    handleEvent: (event: SseEvent) => void;
+    /** Clear thinking stages only. */
+    clearThinking: () => void;
+    /** Reset all indicator state. */
+    reset: () => void;
+}
+export declare function useSkillIndicators(chatSkills: SkillConfig[]): UseSkillIndicatorsReturn;
+//# sourceMappingURL=use-skill-indicators.d.ts.map

package/dist/use-skill-indicators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-skill-indicators.d.ts","sourceRoot":"","sources":["../src/use-skill-indicators.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAMxD,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAA;IACnE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,OAAO,CAAA;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IAEnB,SAAS,CAAC,EAAE,GAAG,EAAE,CAAA;IACjB,OAAO,CAAC,EAAE,GAAG,EAAE,CAAA;IACf,SAAS,CAAC,EAAE,GAAG,EAAE,CAAA;IACjB,aAAa,CAAC,EAAE,GAAG,EAAE,CAAA;IACrB,SAAS,CAAC,EAAE,GAAG,EAAE,CAAA;CAElB;AAED,MAAM,WAAW,wBAAwB;IACvC,yEAAyE;IACzE,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACpC,4DAA4D;IAC5D,cAAc,EAAE,kBAAkB,EAAE,CAAA;IACpC,iEAAiE;IACjE,mBAAmB,EAAE,KAAK,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,CAAC,CAAA;IAC/D,kEAAkE;IAClE,WAAW,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAA;IACtC,kCAAkC;IAClC,aAAa,EAAE,MAAM,IAAI,CAAA;IACzB,iCAAiC;IACjC,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAMD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,WAAW,EAAE,GAAG,wBAAwB,CA6EtF"}

package/dist/use-skill-indicators.js

@@ -0,0 +1,90 @@
+"use client";
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSkillIndicators = useSkillIndicators;
+/**
+ * useSkillIndicators — Skill and thinking indicator state management
+ *
+ * Manages UI state for cognition indicators (thinking stages) and
+ * skill execution indicators (active skill pill, pending results).
+ *
+ * Handles three SSE event types:
+ *  - thinking     → append to thinking stages
+ *  - skill_start  → show skill pill (if configured), clear thinking stages
+ *  - skill_result → accumulate results, clear skill pill
+ */
+const react_1 = require("react");
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+function useSkillIndicators(chatSkills) {
+    const [activeSkill, setActiveSkill] = (0, react_1.useState)(null);
+    const [thinkingStages, setThinkingStages] = (0, react_1.useState)([]);
+    const pendingSkillResults = (0, react_1.useRef)([]);
+    const chatSkillsRef = (0, react_1.useRef)(chatSkills);
+    (0, react_1.useEffect)(() => {
+        chatSkillsRef.current = chatSkills;
+    }, [chatSkills]);
+    const handleEvent = (0, react_1.useCallback)((event) => {
+        switch (event.type) {
+            case "thinking": {
+                setThinkingStages((prev) => [
+                    ...prev,
+                    {
+                        stage: event.stage,
+                        detail: event.detail,
+                        showIcon: event.showIcon,
+                    },
+                ]);
+                break;
+            }
+            case "skill_start": {
+                const displayName = event.contextualMessage || event.skillName;
+                const skillInfo = chatSkillsRef.current.find((s) => s.slug === event.skillSlug);
+                const shouldShowPill = skillInfo?.showSkillPill ?? true;
+                if (shouldShowPill) {
+                    setThinkingStages([]);
+                    setActiveSkill({
+                        slug: event.skillSlug,
+                        name: displayName,
+                        showSkillPill: true,
+                        skillPillText: skillInfo?.skillPillText ?? null,
+                    });
+                }
+                break;
+            }
+            case "skill_result": {
+                pendingSkillResults.current.push({
+                    skill_slug: event.skillSlug,
+                    skill_name: event.skillName,
+                    invoked_at: new Date().toISOString(),
+                    duration_ms: event.duration_ms || 0,
+                    citations: event.citations,
+                    sources: event.sources,
+                    locations: event.locations,
+                    booking_links: event.booking_links,
+                    documents: event.documents,
+                });
+                setActiveSkill(null);
+                break;
+            }
+        }
+    }, []);
+    const clearThinking = (0, react_1.useCallback)(() => {
+        setThinkingStages([]);
+    }, []);
+    const reset = (0, react_1.useCallback)(() => {
+        setActiveSkill(null);
+        setThinkingStages([]);
+        pendingSkillResults.current = [];
+    }, []);
+    return {
+        activeSkill,
+        thinkingStages,
+        pendingSkillResults,
+        handleEvent,
+        clearThinking,
+        reset,
+    };
+}
+//# sourceMappingURL=use-skill-indicators.js.map

package/dist/use-skill-indicators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-skill-indicators.js","sourceRoot":"","sources":["../src/use-skill-indicators.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;;;AAgFZ,gDA6EC;AA3JD;;;;;;;;;;GAUG;AAEH,iCAAgE;AA8DhE,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E,SAAgB,kBAAkB,CAAC,UAAyB;IAC1D,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,IAAA,gBAAQ,EAA0B,IAAI,CAAC,CAAA;IAC7E,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,IAAA,gBAAQ,EAAuB,EAAE,CAAC,CAAA;IAC9E,MAAM,mBAAmB,GAAG,IAAA,cAAM,EAAqB,EAAE,CAAC,CAAA;IAE1D,MAAM,aAAa,GAAG,IAAA,cAAM,EAAC,UAAU,CAAC,CAAA;IACxC,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,aAAa,CAAC,OAAO,GAAG,UAAU,CAAA;IACpC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAA;IAEhB,MAAM,WAAW,GAAG,IAAA,mBAAW,EAAC,CAAC,KAAe,EAAE,EAAE;QAClD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,iBAAiB,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;oBAC1B,GAAG,IAAI;oBACP;wBACE,KAAK,EAAE,KAAK,CAAC,KAAK;wBAClB,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;qBACzB;iBACF,CAAC,CAAA;gBACF,MAAK;YACP,CAAC;YAED,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,WAAW,GAAG,KAAK,CAAC,iBAAiB,IAAI,KAAK,CAAC,SAAS,CAAA;gBAC9D,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,SAAS,CAAC,CAAA;gBAC/E,MAAM,cAAc,GAAG,SAAS,EAAE,aAAa,IAAI,IAAI,CAAA;gBAEvD,IAAI,cAAc,EAAE,CAAC;oBACnB,iBAAiB,CAAC,EAAE,CAAC,CAAA;oBACrB,cAAc,CAAC;wBACb,IAAI,EAAE,KAAK,CAAC,SAAS;wBACrB,IAAI,EAAE,WAAW;wBACjB,aAAa,EAAE,IAAI;wBACnB,aAAa,EAAE,SAAS,EAAE,aAAa,IAAI,IAAI;qBAChD,CAAC,CAAA;gBACJ,CAAC;gBACD,MAAK;YACP,CAAC;YAED,KAAK,cAAc,CAAC,CAAC,CAAC;gBACpB,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC;oBAC/B,UAAU,EAAE,KAAK,CAAC,SAAS;oBAC3B,UAAU,EAAE,KAAK,CAAC,SAAS;oBAC3B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACpC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,CAAC;oBACnC,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,aAAa,EAAE,KAAK,CAAC,aAAa;oBAClC,SAAS,EAAE,KAAK,CAAC,SAAS;iBAC3B,CAAC,CAAA;gBACF,cAAc,CAAC,IAAI,CAAC,CAAA;gBACpB,MAAK;YACP,CAAC;QACH,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,aAAa,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QACrC,iBAAiB,CAAC,EAAE,CAAC,CAAA;IACvB,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,KAAK,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QAC7B,cAAc,CAAC,IAAI,CAAC,CAAA;QACpB,iBAAiB,CAAC,EAAE,CAAC,CAAA;QACrB,mBAAmB,CAAC,OAAO,GAAG,EAAE,CAAA;IAClC,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO;QACL,WAAW;QACX,cAAc;QACd,mBAAmB;QACnB,WAAW;QACX,aAAa;QACb,KAAK;KACN,CAAA;AACH,CAAC"}

package/dist/use-streaming-message.d.ts

@@ -0,0 +1,29 @@
+/** Minimal message shape required by the streaming engine. */
+interface StreamableMessage {
+    id: string;
+    content: string;
+}
+/**
+ * The setMessages updater. Works with React.Dispatch<SetStateAction<M[]>>
+ * for any message type extending StreamableMessage.
+ */
+type MessageUpdater<M extends StreamableMessage> = (updater: (prev: M[]) => M[]) => void;
+export interface UseStreamingMessageReturn {
+    /**
+     * Ref tracking the ID of the message currently being streamed into.
+     * Set by the caller before streaming starts; read by RAF callbacks.
+     */
+    streamingMessageId: React.MutableRefObject<string | null>;
+    /**
+     * Append a text chunk. Chunks are accumulated and flushed at 60fps.
+     */
+    updateStreamingMessage: (content: string) => void;
+    /**
+     * Force-flush buffered text immediately.
+     * Call before changing streamingMessageId or cleaning up.
+     */
+    flushPendingContent: () => void;
+}
+export declare function useStreamingMessage<M extends StreamableMessage>(setMessages: MessageUpdater<M>): UseStreamingMessageReturn;
+export {};
+//# sourceMappingURL=use-streaming-message.d.ts.map

package/dist/use-streaming-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-streaming-message.d.ts","sourceRoot":"","sources":["../src/use-streaming-message.ts"],"names":[],"mappings":"AAqBA,8DAA8D;AAC9D,UAAU,iBAAiB;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,KAAK,cAAc,CAAC,CAAC,SAAS,iBAAiB,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,IAAI,CAAA;AAExF,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,kBAAkB,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACzD;;OAEG;IACH,sBAAsB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACjD;;;OAGG;IACH,mBAAmB,EAAE,MAAM,IAAI,CAAA;CAChC;AAMD,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,iBAAiB,EAC7D,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC,GAC7B,yBAAyB,CAkE3B"}

package/dist/use-streaming-message.js

@@ -0,0 +1,73 @@
+"use client";
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useStreamingMessage = useStreamingMessage;
+/**
+ * useStreamingMessage — RAF-batched streaming text accumulator
+ *
+ * Provides low-level plumbing for appending streamed text chunks
+ * to a message list at 60fps. Used by both useChatRuntime (lite)
+ * and the full ChatInterface.
+ *
+ * The hook owns:
+ *  - streamingMessageId ref: which message is currently being streamed into
+ *  - updateStreamingMessage(text): accumulates text, flushes via RAF
+ *  - flushPendingContent(): force-flush before ID swaps or cleanup
+ */
+const react_1 = require("react");
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+function useStreamingMessage(setMessages) {
+    const streamingMessageId = (0, react_1.useRef)(null);
+    const pendingContent = (0, react_1.useRef)("");
+    const rafId = (0, react_1.useRef)(null);
+    const flushPendingContent = (0, react_1.useCallback)(() => {
+        if (rafId.current !== null) {
+            cancelAnimationFrame(rafId.current);
+            rafId.current = null;
+        }
+        if (pendingContent.current && streamingMessageId.current) {
+            const contentToAdd = pendingContent.current;
+            const messageId = streamingMessageId.current;
+            pendingContent.current = "";
+            setMessages((prev) => prev.map((m) => {
+                if (m.id === messageId) {
+                    return { ...m, content: m.content + contentToAdd };
+                }
+                return m;
+            }));
+        }
+    }, [setMessages]);
+    const updateStreamingMessage = (0, react_1.useCallback)((content) => {
+        if (!streamingMessageId.current)
+            return;
+        pendingContent.current += content;
+        if (rafId.current === null) {
+            rafId.current = requestAnimationFrame(() => {
+                const contentToAdd = pendingContent.current;
+                pendingContent.current = "";
+                rafId.current = null;
+                setMessages((prev) => prev.map((m) => {
+                    if (m.id === streamingMessageId.current) {
+                        return { ...m, content: m.content + contentToAdd };
+                    }
+                    return m;
+                }));
+            });
+        }
+    }, [setMessages]);
+    (0, react_1.useEffect)(() => {
+        return () => {
+            if (rafId.current !== null) {
+                cancelAnimationFrame(rafId.current);
+            }
+        };
+    }, []);
+    return {
+        streamingMessageId,
+        updateStreamingMessage,
+        flushPendingContent,
+    };
+}
+//# sourceMappingURL=use-streaming-message.js.map

package/dist/use-streaming-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-streaming-message.js","sourceRoot":"","sources":["../src/use-streaming-message.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;;;AAsDZ,kDAoEC;AAxHD;;;;;;;;;;;GAWG;AAEH,iCAAsD;AAmCtD,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E,SAAgB,mBAAmB,CACjC,WAA8B;IAE9B,MAAM,kBAAkB,GAAG,IAAA,cAAM,EAAgB,IAAI,CAAC,CAAA;IACtD,MAAM,cAAc,GAAG,IAAA,cAAM,EAAC,EAAE,CAAC,CAAA;IACjC,MAAM,KAAK,GAAG,IAAA,cAAM,EAAgB,IAAI,CAAC,CAAA;IAEzC,MAAM,mBAAmB,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QAC3C,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC3B,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YACnC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;QACtB,CAAC;QAED,IAAI,cAAc,CAAC,OAAO,IAAI,kBAAkB,CAAC,OAAO,EAAE,CAAC;YACzD,MAAM,YAAY,GAAG,cAAc,CAAC,OAAO,CAAA;YAC3C,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,CAAA;YAC5C,cAAc,CAAC,OAAO,GAAG,EAAE,CAAA;YAE3B,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CACnB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACb,IAAI,CAAC,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;oBACvB,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,GAAG,YAAY,EAAE,CAAA;gBACpD,CAAC;gBACD,OAAO,CAAC,CAAA;YACV,CAAC,CAAC,CACH,CAAA;QACH,CAAC;IACH,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAA;IAEjB,MAAM,sBAAsB,GAAG,IAAA,mBAAW,EACxC,CAAC,OAAe,EAAE,EAAE;QAClB,IAAI,CAAC,kBAAkB,CAAC,OAAO;YAAE,OAAM;QAEvC,cAAc,CAAC,OAAO,IAAI,OAAO,CAAA;QAEjC,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC3B,KAAK,CAAC,OAAO,GAAG,qBAAqB,CAAC,GAAG,EAAE;gBACzC,MAAM,YAAY,GAAG,cAAc,CAAC,OAAO,CAAA;gBAC3C,cAAc,CAAC,OAAO,GAAG,EAAE,CAAA;gBAC3B,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;gBAEpB,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CACnB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;oBACb,IAAI,CAAC,CAAC,EAAE,KAAK,kBAAkB,CAAC,OAAO,EAAE,CAAC;wBACxC,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,GAAG,YAAY,EAAE,CAAA;oBACpD,CAAC;oBACD,OAAO,CAAC,CAAA;gBACV,CAAC,CAAC,CACH,CAAA;YACH,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,EACD,CAAC,WAAW,CAAC,CACd,CAAA;IAED,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBAC3B,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YACrC,CAAC;QACH,CAAC,CAAA;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO;QACL,kBAAkB;QAClB,sBAAsB;QACtB,mBAAmB;KACpB,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@portablecore/chat-runtime",
+  "version": "0.1.0",
+  "description": "Headless chat runtime for Portable platforms — SSE streaming, message state, and lifecycle hooks",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "portable",
+    "chat",
+    "runtime",
+    "sse",
+    "streaming"
+  ],
+  "author": "Portable",
+  "license": "UNLICENSED",
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "@types/react": "^18.0.0",
+    "react": "^18.0.0"
+  },
+  "dependencies": {
+    "@portablecore/types": "0.10.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  }
+}