@steerable/agent-ui 0.2.3 → 0.2.4

package/dist/state/ChatSessionProvider.js

@@ -0,0 +1,71 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * `ChatSessionProvider` + `useChatSessionContext`
+ *
+ * Lifts the chat-session primitives out of the host app's god-context (e.g.
+ * deeppath's `ChatUIContext`, deeppath-agent's hooks) into a framework-owned
+ * provider. Concretely it owns:
+ *
+ *   - the streaming transcript: `messages`, `isStreaming`, `streamingMessageId`
+ *   - send / cancel / clear actions
+ *   - the composer (draft, send, cancel, key handlers)
+ *
+ * App-specific concerns that don't belong here (file uploads, geolocation,
+ * suggestion banners, chat tool toggles, chat list / agent selector) stay in
+ * the host app's own context. The `extras` slot lets apps thread custom
+ * values through the same provider so chat cards can call host actions
+ * without prop-drilling.
+ *
+ * Usage in a host app:
+ *
+ *   <ChatSessionProvider
+ *     value={{ ...useChatSession({ transport }), extras: { ...appHooks } }}
+ *   >
+ *     <ChatPanel.Root>...</ChatPanel.Root>
+ *   </ChatSessionProvider>
+ *
+ * Cards / shell pieces consume via `useChatSessionContext()` so they don't
+ * import the host's context directly. This is the seam that lets the same
+ * compound `ChatPanel` work in deeppath, deeppath-agent, and the framework
+ * `examples/web-shell`.
+ */
+import * as React from 'react';
+const ChatSessionContext = React.createContext(null);
+export function ChatSessionProvider({ value, children, }) {
+    return (_jsx(ChatSessionContext.Provider, { value: value, children: children }));
+}
+/**
+ * Read the active chat session. Throws if no `ChatSessionProvider` is
+ * mounted above -- this is intentional: cards / shell pieces should be
+ * usable both inside the provider (typical) and via direct props for
+ * apps that haven't migrated yet (use `useOptionalChatSession()` for that).
+ */
+export function useChatSessionContext() {
+    const ctx = React.useContext(ChatSessionContext);
+    if (!ctx) {
+        throw new Error('useChatSessionContext must be used inside a <ChatSessionProvider />');
+    }
+    return ctx;
+}
+/** Non-throwing variant for components that want to fall back to props. */
+export function useOptionalChatSession() {
+    const ctx = React.useContext(ChatSessionContext);
+    return ctx;
+}
+/**
+ * Convenience selector for the most-used slice in cards (`{ messages,
+ * isStreaming, sendUserMessage, cancel }`). Returns null when there's no
+ * provider so cards can opt into context-driven mode incrementally.
+ */
+export function useChatSessionSlice() {
+    const ctx = useOptionalChatSession();
+    if (!ctx)
+        return null;
+    return {
+        messages: ctx.messages,
+        isStreaming: ctx.isStreaming,
+        sendUserMessage: ctx.sendUserMessage,
+        cancel: ctx.cancel,
+    };
+}
+//# sourceMappingURL=ChatSessionProvider.js.map

package/dist/state/ChatSessionProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSessionProvider.js","sourceRoot":"","sources":["../../src/state/ChatSessionProvider.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAS/B,MAAM,kBAAkB,GAAG,KAAK,CAAC,aAAa,CAAiC,IAAI,CAAC,CAAC;AAOrF,MAAM,UAAU,mBAAmB,CAAoB,EACrD,KAAK,EACL,QAAQ,GAC0B;IAClC,OAAO,CACL,KAAC,kBAAkB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAgC,YACjE,QAAQ,GACmB,CAC/B,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;IACjD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,GAAuC,CAAC;AACjD,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,sBAAsB;IAGpC,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;IACjD,OAAO,GAA8C,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IAGjC,MAAM,GAAG,GAAG,sBAAsB,EAAE,CAAC;IACrC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO;QACL,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,eAAe,EAAE,GAAG,CAAC,eAAe;QACpC,MAAM,EAAE,GAAG,CAAC,MAAM;KACnB,CAAC;AACJ,CAAC"}

package/dist/state/MockChatStreamTransport.d.ts

@@ -0,0 +1,54 @@
+/**
+ * `MockChatStreamTransport` — canned-script transport for stories, tests, and
+ * the framework's runnable web-shell example.
+ *
+ * Replays a deterministic list of `SSEEvent` per call to `stream()`. Optional
+ * per-event delays make streaming feel real in demos. Loop the same script
+ * forever, or vary by index — the constructor accepts either an array (one
+ * script per turn) or a function `(turn: number) => SSEEvent[]`.
+ *
+ *   const transport = new MockChatStreamTransport({
+ *     scripts: [
+ *       [{ type: 'content', content: 'Hello, ' }, { type: 'content', content: 'world!' }, { type: 'done' }],
+ *     ],
+ *     defaultDelayMs: 25,
+ *   });
+ *
+ *   const { messages, sendUserMessage } = useChatStream({ transport });
+ */
+import type { SSEEvent } from '@steerable/agent-protocol';
+import type { ChatStreamSendInput, ChatStreamTransport } from '../hooks/useChatStream.js';
+export type MockScriptStep = SSEEvent | {
+    event: SSEEvent;
+    delayMs?: number;
+};
+export type MockScript = MockScriptStep[];
+export interface MockChatStreamTransportOptions {
+    /**
+     * A list of scripts (one per turn), or a callback that returns a script for
+     * the current turn. Required.
+     */
+    scripts: MockScript[] | ((turn: number, input: ChatStreamSendInput) => MockScript);
+    /** Delay between events when the step doesn't specify one. Defaults to 0. */
+    defaultDelayMs?: number;
+    /**
+     * What to do when there are fewer scripts than turns:
+     *   - 'cycle' (default): wrap modulo `scripts.length`.
+     *   - 'last': stay on the last script.
+     *   - 'empty': emit only a `done` event.
+     */
+    exhaustionPolicy?: 'cycle' | 'last' | 'empty';
+}
+export declare class MockChatStreamTransport implements ChatStreamTransport {
+    private readonly options;
+    private turn;
+    /** Set of in-flight cancel signals, exposed for tests. */
+    readonly cancelled: Set<number>;
+    constructor(options: MockChatStreamTransportOptions);
+    /** Reset the turn counter — useful between fixture-driven test cases. */
+    reset(): void;
+    stream(input: ChatStreamSendInput, onEvent: (event: SSEEvent) => void): Promise<() => void>;
+    private resolveScript;
+    private run;
+}
+//# sourceMappingURL=MockChatStreamTransport.d.ts.map

package/dist/state/MockChatStreamTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockChatStreamTransport.d.ts","sourceRoot":"","sources":["../../src/state/MockChatStreamTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,MAAM,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;AAE1C,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,KAAK,UAAU,CAAC,CAAC;IACnF,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;CAC/C;AAED,qBAAa,uBAAwB,YAAW,mBAAmB;IAKrD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,IAAI,CAAK;IACjB,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,cAAqB;gBAEV,OAAO,EAAE,8BAA8B;IAEpE,yEAAyE;IACzE,KAAK,IAAI,IAAI;IAKP,MAAM,CACV,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GACjC,OAAO,CAAC,MAAM,IAAI,CAAC;IActB,OAAO,CAAC,aAAa;YAgBP,GAAG;CAclB"}

package/dist/state/MockChatStreamTransport.js

@@ -0,0 +1,86 @@
+/**
+ * `MockChatStreamTransport` — canned-script transport for stories, tests, and
+ * the framework's runnable web-shell example.
+ *
+ * Replays a deterministic list of `SSEEvent` per call to `stream()`. Optional
+ * per-event delays make streaming feel real in demos. Loop the same script
+ * forever, or vary by index — the constructor accepts either an array (one
+ * script per turn) or a function `(turn: number) => SSEEvent[]`.
+ *
+ *   const transport = new MockChatStreamTransport({
+ *     scripts: [
+ *       [{ type: 'content', content: 'Hello, ' }, { type: 'content', content: 'world!' }, { type: 'done' }],
+ *     ],
+ *     defaultDelayMs: 25,
+ *   });
+ *
+ *   const { messages, sendUserMessage } = useChatStream({ transport });
+ */
+export class MockChatStreamTransport {
+    options;
+    turn = 0;
+    /** Set of in-flight cancel signals, exposed for tests. */
+    cancelled = new Set();
+    constructor(options) {
+        this.options = options;
+    }
+    /** Reset the turn counter — useful between fixture-driven test cases. */
+    reset() {
+        this.turn = 0;
+        this.cancelled.clear();
+    }
+    async stream(input, onEvent) {
+        const turn = this.turn++;
+        const script = this.resolveScript(turn, input);
+        let cancelled = false;
+        const cancel = () => {
+            cancelled = true;
+            this.cancelled.add(turn);
+        };
+        void this.run(script, onEvent, () => cancelled);
+        // Return synchronously so the framework hook can capture the cancel handle
+        // without waiting for the full script.
+        return cancel;
+    }
+    resolveScript(turn, input) {
+        const { scripts, exhaustionPolicy = 'cycle' } = this.options;
+        if (typeof scripts === 'function')
+            return scripts(turn, input);
+        if (scripts.length === 0)
+            return [{ type: 'done' }];
+        if (turn < scripts.length)
+            return scripts[turn];
+        switch (exhaustionPolicy) {
+            case 'last':
+                return scripts[scripts.length - 1];
+            case 'empty':
+                return [{ type: 'done' }];
+            case 'cycle':
+            default:
+                return scripts[turn % scripts.length];
+        }
+    }
+    async run(script, onEvent, isCancelled) {
+        const defaultDelay = this.options.defaultDelayMs ?? 0;
+        for (const step of script) {
+            if (isCancelled())
+                return;
+            const { event, delayMs } = normaliseStep(step, defaultDelay);
+            if (delayMs > 0)
+                await sleep(delayMs);
+            if (isCancelled())
+                return;
+            onEvent(event);
+        }
+    }
+}
+function normaliseStep(step, defaultDelayMs) {
+    if ('event' in step && step.event && typeof step.event === 'object') {
+        return { event: step.event, delayMs: step.delayMs ?? defaultDelayMs };
+    }
+    return { event: step, delayMs: defaultDelayMs };
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=MockChatStreamTransport.js.map

package/dist/state/MockChatStreamTransport.js.map

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

package/dist/state/MockChatStreamTransport.stories.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Storybook story for `MockChatStreamTransport` paired with `useChatSession`.
+ * This is the canonical "framework runs end-to-end with zero backend" demo —
+ * the same pattern is used by `examples/web-shell` in wave 5.
+ */
+import type { Meta, StoryObj } from '@storybook/react';
+declare const meta: Meta;
+export default meta;
+type Story = StoryObj;
+export declare const ContentOnly: Story;
+export declare const WithToolCall: Story;
+export declare const Cycling: Story;
+//# sourceMappingURL=MockChatStreamTransport.stories.d.ts.map

package/dist/state/MockChatStreamTransport.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockChatStreamTransport.stories.d.ts","sourceRoot":"","sources":["../../src/state/MockChatStreamTransport.stories.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAOvD,QAAA,MAAM,IAAI,EAAE,IAWX,CAAC;AACF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC;AA0DtB,eAAO,MAAM,WAAW,EAAE,KAEzB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAE1B,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,KAErB,CAAC"}

package/dist/state/MockChatStreamTransport.stories.js

@@ -0,0 +1,60 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { ChatPanel } from '../components/ChatPanel.js';
+import { MockChatStreamTransport } from './MockChatStreamTransport.js';
+import { useChatSession } from './useChatSession.js';
+const meta = {
+    title: 'State/MockChatStreamTransport',
+    parameters: {
+        layout: 'fullscreen',
+        docs: {
+            description: {
+                component: 'Scripted SSE transport used in tests, stories, and the framework web-shell example. Pair with `useChatSession` for a fully offline chat demo.',
+            },
+        },
+    },
+};
+export default meta;
+const baselineScript = [
+    { type: 'content', content: 'Sure — ' },
+    { type: 'content', content: "here's a plan:\n\n" },
+    { type: 'content', content: '1. Outline goals\n' },
+    { type: 'content', content: '2. Gather inputs\n' },
+    { type: 'content', content: '3. Iterate\n\n' },
+    { type: 'content', content: 'Want me to dive deeper into any step?' },
+    { type: 'done' },
+];
+const toolCallScript = [
+    { type: 'content', content: 'Checking the weather…\n' },
+    {
+        type: 'tool_call',
+        payload: { id: 'c1', name: 'get_weather', arguments: { city: 'Tokyo' } },
+    },
+    {
+        type: 'tool_result',
+        payload: { success: true, data: { temp: 22, conditions: 'clear' } },
+    },
+    { type: 'content', content: '\nIt is 22°C and clear in Tokyo right now.' },
+    { type: 'done' },
+];
+function DemoChat({ scripts, delayMs }) {
+    const transport = useMemo(() => new MockChatStreamTransport({
+        scripts,
+        defaultDelayMs: delayMs,
+        exhaustionPolicy: 'cycle',
+    }), [scripts, delayMs]);
+    const session = useChatSession({ transport });
+    return (_jsx("div", { className: "h-[640px] w-full max-w-3xl border border-agent-border bg-agent-canvas", children: _jsx(ChatPanel, { messages: session.messages, isStreaming: session.isStreaming, onSubmit: async ({ content }) => {
+                await session.sendUserMessage({ content });
+            }, onCancel: session.cancel, emptyState: _jsxs("div", { className: "m-auto max-w-sm text-center text-sm text-agent-muted-foreground", children: [_jsx("p", { className: "font-medium text-agent-foreground", children: "Try the mock transport" }), _jsx("p", { className: "mt-1", children: "Anything you type triggers the next scripted reply." })] }) }) }));
+}
+export const ContentOnly = {
+    render: () => _jsx(DemoChat, { scripts: [baselineScript], delayMs: 30 }),
+};
+export const WithToolCall = {
+    render: () => _jsx(DemoChat, { scripts: [toolCallScript], delayMs: 30 }),
+};
+export const Cycling = {
+    render: () => _jsx(DemoChat, { scripts: [baselineScript, toolCallScript], delayMs: 30 }),
+};
+//# sourceMappingURL=MockChatStreamTransport.stories.js.map

package/dist/state/MockChatStreamTransport.stories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockChatStreamTransport.stories.js","sourceRoot":"","sources":["../../src/state/MockChatStreamTransport.stories.tsx"],"names":[],"mappings":";AAOA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,IAAI,GAAS;IACjB,KAAK,EAAE,+BAA+B;IACtC,UAAU,EAAE;QACV,MAAM,EAAE,YAAY;QACpB,IAAI,EAAE;YACJ,WAAW,EAAE;gBACX,SAAS,EACP,+IAA+I;aAClJ;SACF;KACF;CACF,CAAC;AACF,eAAe,IAAI,CAAC;AAGpB,MAAM,cAAc,GAAe;IACjC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE;IACvC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,oBAAoB,EAAE;IAClD,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,oBAAoB,EAAE;IAClD,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,oBAAoB,EAAE;IAClD,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,EAAE;IAC9C,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,uCAAuC,EAAE;IACrE,EAAE,IAAI,EAAE,MAAM,EAAE;CACjB,CAAC;AAEF,MAAM,cAAc,GAAe;IACjC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,yBAAyB,EAAE;IACvD;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;KACzE;IACD;QACE,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE;KACpE;IACD,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,4CAA4C,EAAE;IAC1E,EAAE,IAAI,EAAE,MAAM,EAAE;CACjB,CAAC;AAEF,SAAS,QAAQ,CAAC,EAAE,OAAO,EAAE,OAAO,EAA8C;IAChF,MAAM,SAAS,GAAG,OAAO,CACvB,GAAG,EAAE,CACH,IAAI,uBAAuB,CAAC;QAC1B,OAAO;QACP,cAAc,EAAE,OAAO;QACvB,gBAAgB,EAAE,OAAO;KAC1B,CAAC,EACJ,CAAC,OAAO,EAAE,OAAO,CAAC,CACnB,CAAC;IACF,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAE9C,OAAO,CACL,cAAK,SAAS,EAAC,uEAAuE,YACpF,KAAC,SAAS,IACR,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAC1B,WAAW,EAAE,OAAO,CAAC,WAAW,EAChC,QAAQ,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;gBAC9B,MAAM,OAAO,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;YAC7C,CAAC,EACD,QAAQ,EAAE,OAAO,CAAC,MAAM,EACxB,UAAU,EACR,eAAK,SAAS,EAAC,iEAAiE,aAC9E,YAAG,SAAS,EAAC,mCAAmC,uCAA2B,EAC3E,YAAG,SAAS,EAAC,MAAM,oEAAwD,IACvE,GAER,GACE,CACP,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAU;IAChC,MAAM,EAAE,GAAG,EAAE,CAAC,KAAC,QAAQ,IAAC,OAAO,EAAE,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,EAAE,GAAI;CACnE,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAU;IACjC,MAAM,EAAE,GAAG,EAAE,CAAC,KAAC,QAAQ,IAAC,OAAO,EAAE,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,EAAE,GAAI;CACnE,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAU;IAC5B,MAAM,EAAE,GAAG,EAAE,CAAC,KAAC,QAAQ,IAAC,OAAO,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC,EAAE,OAAO,EAAE,EAAE,GAAI;CACnF,CAAC"}

package/dist/state/bridgeLegacySSE.d.ts

@@ -0,0 +1,42 @@
+/**
+ * `bridgeLegacySSE` — turn the heterogeneous wire envelopes that deeppath's
+ * Next.js API and deeppath-agent's local backend speak into the canonical
+ * `SSEEvent` consumed by `useChatStream`.
+ *
+ * Lifted from:
+ *   - deeppath/apps/web/src/lib/utils/framework-sse-bridge.ts (normalize())
+ *   - deeppath-agent/apps/web/src/lib/chat-transport.ts (normaliseLocalPayload())
+ *
+ * The two implementations are merged here, with deeppath-agent's richer
+ * `completion` / `executed_actions` / `user_message` / `message_id` handling
+ * promoted as the default and the older deeppath wire shapes added as
+ * `EnvelopeProfile.deeppathCloud`. A consumer picks a profile (or "auto"),
+ * and the bridge does the rest.
+ *
+ * The bridge is intentionally pure — no I/O, no DOM, no electron — so it can
+ * back any transport (fetch SSE, IPC streaming, mocked fixtures, JSON-RPC).
+ */
+import type { SSEEvent } from '@steerable/agent-protocol';
+export type EnvelopeProfile = 'auto'
+/** Next.js `/api/chats/:id/send` legacy wire — `{content}` deltas, `{error}` envelopes. */
+ | 'deeppathCloud'
+/** Electron local-backend wire — typed completion/executed_actions/user_message. */
+ | 'deeppathLocal';
+export interface BridgeLegacySSEOptions {
+    profile?: EnvelopeProfile;
+    /**
+     * If we see a typed event with `type` outside the canonical SSEEvent union
+     * (e.g. `stage-complete`, `executed_actions`), repackage it as an `agent`
+     * event whose `payload` is the raw envelope. Defaults to `true` so the
+     * framework `useChatStream`'s `onUnknownEvent` channel sees them.
+     */
+    passthroughUnknownAsAgent?: boolean;
+}
+/**
+ * Convert one parsed envelope (the JSON value of `data:` plus the optional
+ * `event:` name) into zero or one `SSEEvent`. Returns null if the envelope is
+ * deliberately suppressed (e.g. `user_message` echoes, since useChatStream
+ * already appends the user message locally).
+ */
+export declare function bridgeLegacySSE(parsed: unknown, eventName?: string, options?: BridgeLegacySSEOptions): SSEEvent | null;
+//# sourceMappingURL=bridgeLegacySSE.d.ts.map

package/dist/state/bridgeLegacySSE.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeLegacySSE.d.ts","sourceRoot":"","sources":["../../src/state/bridgeLegacySSE.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,MAAM,eAAe,GACvB,MAAM;AACR,2FAA2F;GACzF,eAAe;AACjB,oFAAoF;GAClF,eAAe,CAAC;AAEpB,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B;;;;;OAKG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAeD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,OAAO,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE,sBAA2B,GACnC,QAAQ,GAAG,IAAI,CA2CjB"}

package/dist/state/bridgeLegacySSE.js

@@ -0,0 +1,102 @@
+/**
+ * `bridgeLegacySSE` — turn the heterogeneous wire envelopes that deeppath's
+ * Next.js API and deeppath-agent's local backend speak into the canonical
+ * `SSEEvent` consumed by `useChatStream`.
+ *
+ * Lifted from:
+ *   - deeppath/apps/web/src/lib/utils/framework-sse-bridge.ts (normalize())
+ *   - deeppath-agent/apps/web/src/lib/chat-transport.ts (normaliseLocalPayload())
+ *
+ * The two implementations are merged here, with deeppath-agent's richer
+ * `completion` / `executed_actions` / `user_message` / `message_id` handling
+ * promoted as the default and the older deeppath wire shapes added as
+ * `EnvelopeProfile.deeppathCloud`. A consumer picks a profile (or "auto"),
+ * and the bridge does the rest.
+ *
+ * The bridge is intentionally pure — no I/O, no DOM, no electron — so it can
+ * back any transport (fetch SSE, IPC streaming, mocked fixtures, JSON-RPC).
+ */
+const KNOWN_EVENT_TYPES = new Set([
+    'content',
+    'error',
+    'agent',
+    'orchestration',
+    'loader-hint',
+    'keepalive',
+    'done',
+    'budget_exhausted',
+    'tool_call',
+    'tool_result',
+]);
+/**
+ * Convert one parsed envelope (the JSON value of `data:` plus the optional
+ * `event:` name) into zero or one `SSEEvent`. Returns null if the envelope is
+ * deliberately suppressed (e.g. `user_message` echoes, since useChatStream
+ * already appends the user message locally).
+ */
+export function bridgeLegacySSE(parsed, eventName, options = {}) {
+    const profile = options.profile ?? 'auto';
+    const passthroughUnknown = options.passthroughUnknownAsAgent ?? true;
+    if (typeof parsed === 'string') {
+        return parsed.length > 0 ? { type: 'content', content: parsed } : null;
+    }
+    if (parsed === null || typeof parsed !== 'object') {
+        return null;
+    }
+    const data = parsed;
+    if (eventName === 'error') {
+        return {
+            type: 'error',
+            message: typeof data.message === 'string' ? data.message : 'unknown error',
+        };
+    }
+    // Legacy: `{ content: '...' }` carries an incremental token (deeppath cloud).
+    if (typeof data.content === 'string' && !('type' in data)) {
+        return { type: 'content', content: data.content };
+    }
+    // Legacy: `{ error: '...' }` is an inline error envelope (deeppath cloud).
+    if (typeof data.error === 'string' && !('type' in data)) {
+        return { type: 'error', message: data.error };
+    }
+    // Canonical typed events.
+    if (typeof data.type === 'string') {
+        if (KNOWN_EVENT_TYPES.has(data.type)) {
+            return data;
+        }
+        if (profile === 'deeppathLocal' || profile === 'auto') {
+            const mapped = mapLocalBackendEnvelope(data);
+            if (mapped !== undefined)
+                return mapped;
+        }
+        if (passthroughUnknown) {
+            return { type: 'agent', event: data.type, payload: data };
+        }
+    }
+    return null;
+}
+function mapLocalBackendEnvelope(data) {
+    switch (data.type) {
+        case 'completion': {
+            const status = data.status;
+            if (status === 'completed' || status === 'failed') {
+                return { type: 'done', payload: data };
+            }
+            if (status === 'budget_exhausted') {
+                return {
+                    type: 'budget_exhausted',
+                    message: typeof data.reason === 'string' ? data.reason : undefined,
+                };
+            }
+            return { type: 'agent', event: 'round_end', payload: data };
+        }
+        case 'executed_actions':
+            return { type: 'agent', event: 'executed_actions', payload: data };
+        case 'user_message':
+            return null;
+        case 'message_id':
+            return { type: 'agent', event: 'message_id', payload: data };
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=bridgeLegacySSE.js.map

package/dist/state/bridgeLegacySSE.js.map

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

package/dist/state/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `@steerable/agent-ui/state` — chat-state primitives lifted out of deeppath
+ * and deeppath-agent. Composes with the existing `hooks/` exports.
+ *
+ * Subpath import recommended:
+ *
+ *   import { useChatSession, MockChatStreamTransport } from '@steerable/agent-ui/state';
+ *
+ * but the same identifiers are also re-exported from the package root for
+ * back-compat.
+ */
+export { SSEParser, parseSSEData } from './parseSSE.js';
+export type { SSEFrame, SSEParserOptions } from './parseSSE.js';
+export { bridgeLegacySSE } from './bridgeLegacySSE.js';
+export type { EnvelopeProfile, BridgeLegacySSEOptions } from './bridgeLegacySSE.js';
+export { MockChatStreamTransport } from './MockChatStreamTransport.js';
+export type { MockScript, MockScriptStep, MockChatStreamTransportOptions, } from './MockChatStreamTransport.js';
+export { useChatComposer } from './useChatComposer.js';
+export type { UseChatComposerOptions, UseChatComposerReturn, } from './useChatComposer.js';
+export { useChatList } from './useChatList.js';
+export type { ChatListTransport, UseChatListOptions, UseChatListReturn, } from './useChatList.js';
+export { useChatSession } from './useChatSession.js';
+export type { UseChatSessionOptions, UseChatSessionReturn, } from './useChatSession.js';
+export { ChatSessionProvider, useChatSessionContext, useOptionalChatSession, useChatSessionSlice, } from './ChatSessionProvider.js';
+export type { ChatSessionContextValue, ChatSessionProviderProps, } from './ChatSessionProvider.js';
+export { useToolCallStream, useToolCallStatus, } from './useToolCallStream.js';
+export type { ToolCallEntry, UseToolCallStreamOptions, UseToolCallStreamReturn, } from './useToolCallStream.js';
+export { useScrollLock } from './useScrollLock.js';
+export type { UseScrollLockOptions, UseScrollLockReturn, } from './useScrollLock.js';
+export { useChatStream, } from '../hooks/useChatStream.js';
+export type { UseChatStreamOptions, UseChatStreamReturn, ChatStreamSendInput, ChatStreamTransport, } from '../hooks/useChatStream.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EACV,UAAU,EACV,cAAc,EACd,8BAA8B,GAC/B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,aAAa,EACb,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EACL,aAAa,GACd,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC"}

package/dist/state/index.js

@@ -0,0 +1,24 @@
+/**
+ * `@steerable/agent-ui/state` — chat-state primitives lifted out of deeppath
+ * and deeppath-agent. Composes with the existing `hooks/` exports.
+ *
+ * Subpath import recommended:
+ *
+ *   import { useChatSession, MockChatStreamTransport } from '@steerable/agent-ui/state';
+ *
+ * but the same identifiers are also re-exported from the package root for
+ * back-compat.
+ */
+export { SSEParser, parseSSEData } from './parseSSE.js';
+export { bridgeLegacySSE } from './bridgeLegacySSE.js';
+export { MockChatStreamTransport } from './MockChatStreamTransport.js';
+export { useChatComposer } from './useChatComposer.js';
+export { useChatList } from './useChatList.js';
+export { useChatSession } from './useChatSession.js';
+export { ChatSessionProvider, useChatSessionContext, useOptionalChatSession, useChatSessionSlice, } from './ChatSessionProvider.js';
+export { useToolCallStream, useToolCallStatus, } from './useToolCallStream.js';
+export { useScrollLock } from './useScrollLock.js';
+// Re-export the canonical chat-stream surface so callers can stay on a single
+// import root if they don't want to think about subpaths.
+export { useChatStream, } from '../hooks/useChatStream.js';
+//# sourceMappingURL=index.js.map

package/dist/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGxD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAOvE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAMvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAO/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMrD,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAOhC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMnD,8EAA8E;AAC9E,0DAA0D;AAC1D,OAAO,EACL,aAAa,GACd,MAAM,2BAA2B,CAAC"}

package/dist/state/parseSSE.d.ts

@@ -0,0 +1,50 @@
+/**
+ * `parseSSE` — wire-level Server-Sent-Events parser.
+ *
+ * Feed it raw text chunks from any source (fetch ReadableStream chunks,
+ * Electron IPC `webContents.send` payloads, mocked fixtures, …). It buffers,
+ * splits on the `\r?\n\r?\n` frame terminator, and emits one
+ * `{ event?, data?, id?, retry? }` per complete frame. JSON parsing of `data`
+ * is intentionally out of scope; downstream layers like {@link bridgeLegacySSE}
+ * handle that.
+ *
+ * Replaces deeppath's `SSEParser` and deeppath-agent's `LocalBackendSseParser`
+ * with a single dependency-free implementation that compiles to both Node and
+ * the browser. Heartbeat-timeout watchdogs (deeppath had a 30 s gate) live on
+ * the transport, not here — this class is a pure parser.
+ */
+export interface SSEFrame {
+    /** The `event: …` field; undefined for default `message` events. */
+    event?: string;
+    /** Concatenated `data: …` lines (newline-joined per the SSE spec). */
+    data?: string;
+    /** The `id: …` field. */
+    id?: string;
+    /** The `retry: …` field, as milliseconds. */
+    retry?: number;
+}
+export interface SSEParserOptions {
+    onFrame: (frame: SSEFrame) => void;
+    onError?: (err: Error) => void;
+    /** Called when the stream emits the canonical `data: [DONE]` terminator. */
+    onComplete?: () => void;
+}
+export declare class SSEParser {
+    private readonly options;
+    private buffer;
+    private completed;
+    constructor(options: SSEParserOptions);
+    /** Feed one chunk. Safe to call with partial UTF-8 strings (we don't decode). */
+    feed(chunk: string): void;
+    /** Call when the source signals end-of-stream. Flushes any trailing frame. */
+    end(): void;
+    /** Drop all state and stop emitting. */
+    cleanup(): void;
+    private processFrame;
+}
+/**
+ * Tolerant JSON parser for SSE `data:` payloads — returns the raw string when
+ * the body isn't JSON, which deeppath relies on for bare-text content deltas.
+ */
+export declare function parseSSEData(data: string): unknown;
+//# sourceMappingURL=parseSSE.d.ts.map

package/dist/state/parseSSE.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseSSE.d.ts","sourceRoot":"","sources":["../../src/state/parseSSE.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,QAAQ;IACvB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,qBAAa,SAAS;IAIR,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,SAAS,CAAS;gBAEG,OAAO,EAAE,gBAAgB;IAEtD,iFAAiF;IACjF,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAUzB,8EAA8E;IAC9E,GAAG,IAAI,IAAI;IAMX,wCAAwC;IACxC,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,YAAY;CA8CrB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMlD"}