@data-club/ai-hub 0.0.1

package/dist/state/stateReducer.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Client-side state reducer for `AIHubState`.
+ *
+ * The ai-hub server is the authoritative source of state (§6.6, §10). Every
+ * SSE event carries a `state: { status, phase }` snapshot at emission time
+ * (§9); the client's job is to trust that snapshot and enrich it with the
+ * cross-event fields the UI needs to render — `last_seq` (for the resumption
+ * cursor), `turn_id` (from `stream_start`), `session_id`, and `tpm_retry_at`
+ * (the countdown deadline read from the latest `system_notice {tpm_wait}`).
+ *
+ * Because the server emits the `(status, phase)` directly on every event, the
+ * reducer does **not** re-derive the transitions from §10.2 — it just lifts
+ * the snapshot. The §10.2 arrows are tested via the cross-package SSE
+ * fixtures (`packages/ai-hub-server/__tests__/fixtures/sse/*.json`): each
+ * fixture replays the bytes the server emits and the reducer's per-event
+ * output is asserted to match the expected `(status, phase)` for that arrow.
+ *
+ * @see SPECIFICATIONS.md §6.6 — server-authoritative state
+ * @see SPECIFICATIONS.md §7.5 — state on the client
+ * @see SPECIFICATIONS.md §9   — wire protocol
+ * @see SPECIFICATIONS.md §10  — state machine
+ */
+import type { AIHubEvent, AIHubState } from "../types.js";
+/**
+ * The reducer's starting state, before any event has been seen.
+ *
+ * `last_seq: -1` is the convention used as the `from_seq` cursor on the
+ * resumption endpoint (`/chat/{turn_id}/events?from_seq=N`) — the server
+ * matches with `seq > N`, so `-1` replays every event from `seq: 0`
+ * forward (`server/routes/chat.ts`).
+ *
+ * @returns the initial state.
+ */
+export declare function initialAIHubState(): AIHubState;
+/**
+ * Reduces one `AIHubEvent` into the next `AIHubState`.
+ *
+ * Pure. Re-runnable. The provider replays the same event sequence on
+ * reconnect-by-replay and lands on the same state every time — that's the
+ * load-bearing property the resumption flow depends on.
+ *
+ * Behavioural notes (each maps to a §10.2 arrow or §10.3 rule, and is locked
+ * down by the SSE fixtures consumed in `__tests__/state/stateReducer.test.ts`):
+ *
+ * - `stream_start` → captures `turn_id` + `session_id`; clears any leftover
+ *   `tpm_retry_at` from a previous turn (defensive; a fresh turn should
+ *   never inherit one).
+ * - `system_notice {code: "tpm_wait"}` → stores `retry_at` so the TPM banner
+ *   (Step 10) can render its countdown. The `(status, phase)` snapshot on
+ *   the event is already `running / waiting_provider` per §10.2.
+ * - `system_notice {code: "resumed"}` → clears `tpm_retry_at`. Snapshot is
+ *   back to `running / model_text` (or whatever the recovery resumes into).
+ * - `error` → server already emitted `(status: failed, phase: null)`; the
+ *   reducer just lifts it and clears `tpm_retry_at` so a Retry button
+ *   doesn't render a stale countdown.
+ * - `stream_end` → terminal `(status, phase)` is already on the snapshot;
+ *   `tpm_retry_at` is cleared for the same reason as `error`.
+ * - All other events → `(status, phase)` + `last_seq` are lifted from the
+ *   snapshot; nothing else changes. The §10.3 tool-error-vs-agent-error
+ *   rule is honored entirely by the server's snapshot (a `tool_call_result`
+ *   with an `error` field carries `phase: model_text` and `status: running`;
+ *   only an `error` event carries `status: failed`).
+ *
+ * @param state - the previous `AIHubState`.
+ * @param event - the next event from the SSE stream.
+ * @returns the next `AIHubState`.
+ *
+ * @see SPECIFICATIONS.md §10.2 — transitions
+ * @see SPECIFICATIONS.md §10.3 — tool error vs. agent error
+ */
+export declare function reduceAIHubState(state: AIHubState, event: AIHubEvent): AIHubState;
+//# sourceMappingURL=stateReducer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stateReducer.d.ts","sourceRoot":"","sources":["../../src/state/stateReducer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE1D;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAS9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,UAAU,GAChB,UAAU,CA6CZ"}

package/dist/state/stateReducer.js

@@ -0,0 +1,122 @@
+/**
+ * Client-side state reducer for `AIHubState`.
+ *
+ * The ai-hub server is the authoritative source of state (§6.6, §10). Every
+ * SSE event carries a `state: { status, phase }` snapshot at emission time
+ * (§9); the client's job is to trust that snapshot and enrich it with the
+ * cross-event fields the UI needs to render — `last_seq` (for the resumption
+ * cursor), `turn_id` (from `stream_start`), `session_id`, and `tpm_retry_at`
+ * (the countdown deadline read from the latest `system_notice {tpm_wait}`).
+ *
+ * Because the server emits the `(status, phase)` directly on every event, the
+ * reducer does **not** re-derive the transitions from §10.2 — it just lifts
+ * the snapshot. The §10.2 arrows are tested via the cross-package SSE
+ * fixtures (`packages/ai-hub-server/__tests__/fixtures/sse/*.json`): each
+ * fixture replays the bytes the server emits and the reducer's per-event
+ * output is asserted to match the expected `(status, phase)` for that arrow.
+ *
+ * @see SPECIFICATIONS.md §6.6 — server-authoritative state
+ * @see SPECIFICATIONS.md §7.5 — state on the client
+ * @see SPECIFICATIONS.md §9   — wire protocol
+ * @see SPECIFICATIONS.md §10  — state machine
+ */
+/**
+ * The reducer's starting state, before any event has been seen.
+ *
+ * `last_seq: -1` is the convention used as the `from_seq` cursor on the
+ * resumption endpoint (`/chat/{turn_id}/events?from_seq=N`) — the server
+ * matches with `seq > N`, so `-1` replays every event from `seq: 0`
+ * forward (`server/routes/chat.ts`).
+ *
+ * @returns the initial state.
+ */
+export function initialAIHubState() {
+    return {
+        status: "idle",
+        phase: null,
+        last_seq: -1,
+        turn_id: null,
+        session_id: null,
+        tpm_retry_at: null,
+    };
+}
+/**
+ * Reduces one `AIHubEvent` into the next `AIHubState`.
+ *
+ * Pure. Re-runnable. The provider replays the same event sequence on
+ * reconnect-by-replay and lands on the same state every time — that's the
+ * load-bearing property the resumption flow depends on.
+ *
+ * Behavioural notes (each maps to a §10.2 arrow or §10.3 rule, and is locked
+ * down by the SSE fixtures consumed in `__tests__/state/stateReducer.test.ts`):
+ *
+ * - `stream_start` → captures `turn_id` + `session_id`; clears any leftover
+ *   `tpm_retry_at` from a previous turn (defensive; a fresh turn should
+ *   never inherit one).
+ * - `system_notice {code: "tpm_wait"}` → stores `retry_at` so the TPM banner
+ *   (Step 10) can render its countdown. The `(status, phase)` snapshot on
+ *   the event is already `running / waiting_provider` per §10.2.
+ * - `system_notice {code: "resumed"}` → clears `tpm_retry_at`. Snapshot is
+ *   back to `running / model_text` (or whatever the recovery resumes into).
+ * - `error` → server already emitted `(status: failed, phase: null)`; the
+ *   reducer just lifts it and clears `tpm_retry_at` so a Retry button
+ *   doesn't render a stale countdown.
+ * - `stream_end` → terminal `(status, phase)` is already on the snapshot;
+ *   `tpm_retry_at` is cleared for the same reason as `error`.
+ * - All other events → `(status, phase)` + `last_seq` are lifted from the
+ *   snapshot; nothing else changes. The §10.3 tool-error-vs-agent-error
+ *   rule is honored entirely by the server's snapshot (a `tool_call_result`
+ *   with an `error` field carries `phase: model_text` and `status: running`;
+ *   only an `error` event carries `status: failed`).
+ *
+ * @param state - the previous `AIHubState`.
+ * @param event - the next event from the SSE stream.
+ * @returns the next `AIHubState`.
+ *
+ * @see SPECIFICATIONS.md §10.2 — transitions
+ * @see SPECIFICATIONS.md §10.3 — tool error vs. agent error
+ */
+export function reduceAIHubState(state, event) {
+    // Lift the snapshot + advance the resumption cursor. Every branch below
+    // refines this base value.
+    const next = {
+        ...state,
+        status: event.state.status,
+        phase: event.state.phase,
+        last_seq: event.seq,
+    };
+    switch (event.event) {
+        case "stream_start":
+            next.turn_id = event.data.turn_id;
+            next.session_id = event.data.session_id;
+            next.tpm_retry_at = null;
+            return next;
+        case "system_notice":
+            if (event.data.code === "tpm_wait") {
+                // `retry_at` is optional on the wire; absent → no countdown, the
+                // banner renders without a timer. We still keep the `waiting_provider`
+                // phase from the snapshot so the affordance flips.
+                next.tpm_retry_at = event.data.retry_at ?? null;
+            }
+            else if (event.data.code === "resumed") {
+                next.tpm_retry_at = null;
+            }
+            return next;
+        case "error":
+        case "stream_end":
+            next.tpm_retry_at = null;
+            return next;
+        case "heartbeat":
+        case "assistant_delta":
+        case "reasoning_delta":
+        case "assistant_message_complete":
+        case "tool_call_started":
+        case "tool_call_input_delta":
+        case "tool_call_dispatched":
+        case "tool_call_progress":
+        case "tool_call_result":
+        case "usage":
+            return next;
+    }
+}
+//# sourceMappingURL=stateReducer.js.map

package/dist/state/stateReducer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateReducer.js","sourceRoot":"","sources":["../../src/state/stateReducer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,CAAC,CAAC;QACZ,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,IAAI;KACnB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAiB,EACjB,KAAiB;IAEjB,wEAAwE;IACxE,2BAA2B;IAC3B,MAAM,IAAI,GAAe;QACvB,GAAG,KAAK;QACR,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;QAC1B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK;QACxB,QAAQ,EAAE,KAAK,CAAC,GAAG;KACpB,CAAC;IAEF,QAAQ,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,KAAK,cAAc;YACjB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;YAClC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;YACxC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,OAAO,IAAI,CAAC;QAEd,KAAK,eAAe;YAClB,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBACnC,iEAAiE;gBACjE,uEAAuE;gBACvE,mDAAmD;gBACnD,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC;YAClD,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACzC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YAC3B,CAAC;YACD,OAAO,IAAI,CAAC;QAEd,KAAK,OAAO,CAAC;QACb,KAAK,YAAY;YACf,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,OAAO,IAAI,CAAC;QAEd,KAAK,WAAW,CAAC;QACjB,KAAK,iBAAiB,CAAC;QACvB,KAAK,iBAAiB,CAAC;QACvB,KAAK,4BAA4B,CAAC;QAClC,KAAK,mBAAmB,CAAC;QACzB,KAAK,uBAAuB,CAAC;QAC7B,KAAK,sBAAsB,CAAC;QAC5B,KAAK,oBAAoB,CAAC;QAC1B,KAAK,kBAAkB,CAAC;QACxB,KAAK,OAAO;YACV,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/stories/EffortControl.stories.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Stories for `<EffortControl />` — reasoning-effort dropdown.
+ *
+ * @see SPECIFICATIONS.md §7.4 — reasoning effort
+ */
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { EffortControl } from "../components/EffortControl/index.js";
+declare const meta: Meta<typeof EffortControl>;
+export default meta;
+type Story = StoryObj<typeof EffortControl>;
+export declare const DefaultMedium: Story;
+export declare const SetToNone: Story;
+export declare const Disabled: Story;
+//# sourceMappingURL=EffortControl.stories.d.ts.map

package/dist/stories/EffortControl.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EffortControl.stories.d.ts","sourceRoot":"","sources":["../../src/stories/EffortControl.stories.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAarE,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,aAAa,CAWpC,CAAC;AACF,eAAe,IAAI,CAAC;AAEpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,aAAa,CAAC,CAAC;AAE5C,eAAO,MAAM,aAAa,EAAE,KAE3B,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAUvB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAUtB,CAAC"}

package/dist/stories/EffortControl.stories.js

@@ -0,0 +1,43 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { EffortControl } from "../components/EffortControl/index.js";
+import { MockProvider } from "./_mockProvider.js";
+function withEffort(effort) {
+    return (Story) => (_jsx(MockProvider, { opts: { effort }, children: _jsx(Story, {}) }));
+}
+const meta = {
+    title: "Affordances/EffortControl",
+    component: EffortControl,
+    parameters: {
+        docs: {
+            description: {
+                component: "Reasoning-effort dropdown mirroring Letta's ADE enum (None | Minimal | Low | Medium | High | Extra High). Per-message; persists in provider state until changed.",
+            },
+        },
+    },
+};
+export default meta;
+export const DefaultMedium = {
+    decorators: [withEffort("medium")],
+};
+export const SetToNone = {
+    decorators: [withEffort("none")],
+    parameters: {
+        docs: {
+            description: {
+                story: "`none` is the off-state for reasoning; there is no separate reasoning toggle.",
+            },
+        },
+    },
+};
+export const Disabled = {
+    decorators: [withEffort("medium")],
+    args: { disabled: true },
+    parameters: {
+        docs: {
+            description: {
+                story: "Disabled while a turn is streaming.",
+            },
+        },
+    },
+};
+//# sourceMappingURL=EffortControl.stories.js.map

package/dist/stories/EffortControl.stories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EffortControl.stories.js","sourceRoot":"","sources":["../../src/stories/EffortControl.stories.tsx"],"names":[],"mappings":";AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAGrE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,SAAS,UAAU,CAAC,MAAmB;IACrC,OAAO,CAAC,KAA4B,EAAE,EAAE,CAAC,CACvC,KAAC,YAAY,IAAC,IAAI,EAAE,EAAE,MAAM,EAAE,YAC5B,KAAC,KAAK,KAAG,GACI,CAChB,CAAC;AACJ,CAAC;AAED,MAAM,IAAI,GAA+B;IACvC,KAAK,EAAE,2BAA2B;IAClC,SAAS,EAAE,aAAa;IACxB,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,WAAW,EAAE;gBACX,SAAS,EACP,kKAAkK;aACrK;SACF;KACF;CACF,CAAC;AACF,eAAe,IAAI,CAAC;AAIpB,MAAM,CAAC,MAAM,aAAa,GAAU;IAClC,UAAU,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAU;IAC9B,UAAU,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAChC,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,WAAW,EAAE;gBACX,KAAK,EACH,+EAA+E;aAClF;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAU;IAC7B,UAAU,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;IACxB,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,WAAW,EAAE;gBACX,KAAK,EAAE,qCAAqC;aAC7C;SACF;KACF;CACF,CAAC"}

package/dist/stories/MarkdownRenderer.stories.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Stories for `<MarkdownRenderer />` — the assistant-bubble body
+ * renderer that turns GFM markdown (+ LaTeX-style math) into themed HTML.
+ *
+ * Each story feeds a curated chunk of markdown so designers can eyeball
+ * one feature at a time (paragraphs, tables, code blocks, math…) without
+ * having to spin up a real chat turn. The "Showcase" story stitches all
+ * of them together — that's the one to load when checking the renderer
+ * end-to-end after a CSS-token tweak.
+ *
+ * @see docs/react/markdown-rendering.md
+ */
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { MarkdownRenderer } from "../components/MarkdownRenderer/index.js";
+declare const meta: Meta<typeof MarkdownRenderer>;
+export default meta;
+type Story = StoryObj<typeof MarkdownRenderer>;
+export declare const Paragraphs: Story;
+export declare const HeadingsAndLists: Story;
+export declare const Tables: Story;
+export declare const CodeBlocks: Story;
+export declare const MathEquations: Story;
+export declare const Blockquotes: Story;
+export declare const Showcase: Story;
+//# sourceMappingURL=MarkdownRenderer.stories.d.ts.map

package/dist/stories/MarkdownRenderer.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownRenderer.stories.d.ts","sourceRoot":"","sources":["../../src/stories/MarkdownRenderer.stories.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAE3E,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,gBAAgB,CAWvC,CAAC;AACF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/C,eAAO,MAAM,UAAU,EAAE,KAQxB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KAmB9B,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,KAkBpB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KAwBxB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,KAoB3B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAUzB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KA0DtB,CAAC"}

package/dist/stories/MarkdownRenderer.stories.js

@@ -0,0 +1,178 @@
+import { MarkdownRenderer } from "../components/MarkdownRenderer/index.js";
+const meta = {
+    title: "Affordances/MarkdownRenderer",
+    component: MarkdownRenderer,
+    parameters: {
+        docs: {
+            description: {
+                component: "Renders assistant-bubble bodies as GitHub-flavored Markdown with KaTeX math. Per-customer wrappers theme it via the `--dc-aih-markdown-*` custom properties (default mappings live in `src/styles/default.css`).",
+            },
+        },
+    },
+};
+export default meta;
+export const Paragraphs = {
+    args: {
+        content: [
+            "This is a **bold** statement with some *emphasis*, an [inline link](https://example.com), and ~~strikethrough~~ for good measure.",
+            "",
+            "Second paragraph — separated by a blank line. Inline code looks like `const x = 42;`.",
+        ].join("\n"),
+    },
+};
+export const HeadingsAndLists = {
+    args: {
+        content: [
+            "# Heading 1",
+            "## Heading 2",
+            "### Heading 3",
+            "",
+            "Unordered list:",
+            "- First item",
+            "- Second item",
+            "  - Nested item",
+            "- Third item",
+            "",
+            "Ordered list:",
+            "1. Step one",
+            "2. Step two",
+            "3. Step three",
+        ].join("\n"),
+    },
+};
+export const Tables = {
+    args: {
+        content: [
+            "| Plan | Monthly | Annual |",
+            "|------|---------|--------|",
+            "| Starter | $9 | $90 |",
+            "| Pro | $29 | $290 |",
+            "| Enterprise | Contact us | Contact us |",
+            "",
+            "Wide tables are horizontally scrollable, so the bubble keeps its `max-width: 80%` even when the table doesn't fit:",
+            "",
+            "| Region | Q1 | Q2 | Q3 | Q4 | Total | YoY % | Notes |",
+            "|--------|----|----|----|----|-------|-------|-------|",
+            "| EMEA | 120 | 134 | 142 | 158 | 554 | +18% | Growth driven by DACH region |",
+            "| APAC | 87 | 95 | 110 | 121 | 413 | +24% | Strong tailwind from JP launches |",
+            "| Americas | 210 | 215 | 219 | 240 | 884 | +6% | Mature market, steady |",
+        ].join("\n"),
+    },
+};
+export const CodeBlocks = {
+    args: {
+        content: [
+            "Here's a TypeScript snippet:",
+            "",
+            "```ts",
+            "function greet(name: string): string {",
+            "  return `Hello, ${name}!`;",
+            "}",
+            "",
+            "const message = greet('world');",
+            "console.log(message);",
+            "```",
+            "",
+            "And a Python one:",
+            "",
+            "```python",
+            "def fibonacci(n: int) -> int:",
+            "    if n < 2:",
+            "        return n",
+            "    return fibonacci(n - 1) + fibonacci(n - 2)",
+            "```",
+        ].join("\n"),
+    },
+};
+export const MathEquations = {
+    args: {
+        content: [
+            "Inline math: the Pythagorean identity is $a^2 + b^2 = c^2$.",
+            "",
+            "Block math:",
+            "",
+            "$$",
+            "\\int_0^\\infty e^{-x^2} \\, dx = \\frac{\\sqrt{\\pi}}{2}",
+            "$$",
+            "",
+            "The quadratic formula:",
+            "",
+            "$$",
+            "x = \\frac{-b \\pm \\sqrt{b^2 - 4ac}}{2a}",
+            "$$",
+            "",
+            "Euler's identity, $e^{i\\pi} + 1 = 0$, links five fundamental constants.",
+        ].join("\n"),
+    },
+};
+export const Blockquotes = {
+    args: {
+        content: [
+            "> This is a blockquote. It's typically used to highlight a quote, an aside, or a callout from another source.",
+            ">",
+            "> Multi-paragraph quotes work too.",
+            "",
+            "Back to regular text.",
+        ].join("\n"),
+    },
+};
+export const Showcase = {
+    args: {
+        content: [
+            "# Markdown showcase",
+            "",
+            "This story renders every feature the chat supports — use it as a regression sanity-check after touching `--dc-aih-markdown-*` tokens.",
+            "",
+            "## Inline formatting",
+            "",
+            "Mix of **bold**, *italic*, `inline code`, [a link](https://example.com), and ~~strikethrough~~.",
+            "",
+            "## Lists",
+            "",
+            "- Apples",
+            "- Oranges",
+            "  - Mandarins",
+            "  - Clementines",
+            "- Bananas",
+            "",
+            "1. Mise en place",
+            "2. Sauté the aromatics",
+            "3. Simmer until thickened",
+            "",
+            "## Tables",
+            "",
+            "| Customer | MRR | Tier |",
+            "|----------|-----|------|",
+            "| Acme Co. | $9,400 | Enterprise |",
+            "| Globex   | $2,100 | Pro |",
+            "| Initech  |   $290 | Starter |",
+            "",
+            "## Code",
+            "",
+            "```ts",
+            "export function sum(xs: number[]): number {",
+            "  return xs.reduce((a, b) => a + b, 0);",
+            "}",
+            "```",
+            "",
+            "## Math",
+            "",
+            "The sum of the first $n$ natural numbers is",
+            "",
+            "$$",
+            "\\sum_{k=1}^{n} k = \\frac{n(n+1)}{2}.",
+            "$$",
+            "",
+            "## Blockquote",
+            "",
+            "> The best way to predict the future is to invent it.",
+            ">",
+            "> — Alan Kay",
+            "",
+            "---",
+            "",
+            "End of showcase.",
+        ].join("\n"),
+    },
+};
+//# sourceMappingURL=MarkdownRenderer.stories.js.map

package/dist/stories/MarkdownRenderer.stories.js.map

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

package/dist/stories/MessageBubble.stories.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Stories for the message-bubble variants emitted by `<MessageList />`.
+ *
+ * The bubble is not a separate primitive — it's the inner element of
+ * `MessageList`. Each story mounts a full `<MessageList />` under a
+ * `MockProvider` whose `messages` array + reducer `state` produces the
+ * variant under inspection (user / assistant / system / tool / failed
+ * assistant / cancelled assistant).
+ *
+ * @see SPECIFICATIONS.md §7.3 — message bubble variants
+ * @see ui-sketches/03-chat.md
+ */
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { MessageList } from "../components/MessageList/index.js";
+declare const meta: Meta<typeof MessageList>;
+export default meta;
+type Story = StoryObj<typeof MessageList>;
+export declare const Mixed_AllVariants: Story;
+export declare const FailedAssistant: Story;
+export declare const CancelledAssistant: Story;
+//# sourceMappingURL=MessageBubble.stories.d.ts.map

package/dist/stories/MessageBubble.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageBubble.stories.d.ts","sourceRoot":"","sources":["../../src/stories/MessageBubble.stories.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AA2CjE,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,WAAW,CAWlC,CAAC;AACF,eAAe,IAAI,CAAC;AAEpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,WAAW,CAAC,CAAC;AAE1C,eAAO,MAAM,iBAAiB,EAAE,KAE/B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,KAW7B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,KAUhC,CAAC"}

package/dist/stories/MessageBubble.stories.js

@@ -0,0 +1,59 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { MessageList } from "../components/MessageList/index.js";
+import { MockProvider } from "./_mockProvider.js";
+function msg(id, role, content) {
+    return {
+        id,
+        role,
+        content,
+        created_at: "2026-05-13T12:00:00.000Z",
+    };
+}
+function withProvider(opts) {
+    return (Story) => (_jsx(MockProvider, { opts: { activeSessionId: "s-mock", ...opts }, children: _jsx("div", { style: { height: "32rem", display: "flex" }, children: _jsx(Story, {}) }) }));
+}
+const HISTORY = [
+    msg("m1", "user", "Why did my last turn fail?"),
+    msg("m2", "assistant", "Looking at the logs, the upstream provider returned a 429 and we exhausted the retry budget."),
+    msg("m3", "system", "Notice: deployment-wide TPM recovery is configured for 5 retries with 30s backoff."),
+    msg("m4", "tool", "search_docs → 3 results returned"),
+];
+const meta = {
+    title: "Affordances/MessageBubble",
+    component: MessageList,
+    parameters: {
+        docs: {
+            description: {
+                component: "Each story mounts `<MessageList />` with a curated `messages` array + reducer state so the resulting DOM shows one of the six bubble variants (user / assistant / system / tool / failed assistant / cancelled assistant).",
+            },
+        },
+    },
+};
+export default meta;
+export const Mixed_AllVariants = {
+    decorators: [withProvider({ status: "idle", messages: HISTORY })],
+};
+export const FailedAssistant = {
+    decorators: [
+        withProvider({
+            status: "failed",
+            lastTurnError: "Stream failed: upstream provider unavailable.",
+            messages: [
+                msg("m1", "user", "Summarize the last release."),
+                msg("m2", "assistant", "Sure, here's what I have so far —"),
+            ],
+        }),
+    ],
+};
+export const CancelledAssistant = {
+    decorators: [
+        withProvider({
+            status: "cancelled",
+            messages: [
+                msg("m1", "user", "Run a long simulation."),
+                msg("m2", "assistant", "Starting the simulation now…"),
+            ],
+        }),
+    ],
+};
+//# sourceMappingURL=MessageBubble.stories.js.map

package/dist/stories/MessageBubble.stories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageBubble.stories.js","sourceRoot":"","sources":["../../src/stories/MessageBubble.stories.tsx"],"names":[],"mappings":";AAcA,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAGjE,OAAO,EAAE,YAAY,EAAyB,MAAM,oBAAoB,CAAC;AAEzE,SAAS,GAAG,CACV,EAAU,EACV,IAA0B,EAC1B,OAAe;IAEf,OAAO;QACL,EAAE;QACF,IAAI;QACJ,OAAO;QACP,UAAU,EAAE,0BAA0B;KACvC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,IAAsB;IAC1C,OAAO,CAAC,KAA4B,EAAE,EAAE,CAAC,CACvC,KAAC,YAAY,IAAC,IAAI,EAAE,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,YACxD,cAAK,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAC9C,KAAC,KAAK,KAAG,GACL,GACO,CAChB,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,GAAmB;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,4BAA4B,CAAC;IAC/C,GAAG,CACD,IAAI,EACJ,WAAW,EACX,8FAA8F,CAC/F;IACD,GAAG,CACD,IAAI,EACJ,QAAQ,EACR,oFAAoF,CACrF;IACD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,kCAAkC,CAAC;CACtD,CAAC;AAEF,MAAM,IAAI,GAA6B;IACrC,KAAK,EAAE,2BAA2B;IAClC,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,WAAW,EAAE;gBACX,SAAS,EACP,4NAA4N;aAC/N;SACF;KACF;CACF,CAAC;AACF,eAAe,IAAI,CAAC;AAIpB,MAAM,CAAC,MAAM,iBAAiB,GAAU;IACtC,UAAU,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;CAClE,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAU;IACpC,UAAU,EAAE;QACV,YAAY,CAAC;YACX,MAAM,EAAE,QAAQ;YAChB,aAAa,EAAE,+CAA+C;YAC9D,QAAQ,EAAE;gBACR,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,6BAA6B,CAAC;gBAChD,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,mCAAmC,CAAC;aAC5D;SACF,CAAC;KACH;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAU;IACvC,UAAU,EAAE;QACV,YAAY,CAAC;YACX,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE;gBACR,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,wBAAwB,CAAC;gBAC3C,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,8BAA8B,CAAC;aACvD;SACF,CAAC;KACH;CACF,CAAC"}

package/dist/stories/ReasoningView.stories.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Stories for `<ReasoningView />` — collapsible reasoning block inside
+ * an assistant bubble.
+ *
+ * Pure presentational primitive (no context needed).
+ *
+ * @see SPECIFICATIONS.md §7.3 — showReasoning prop
+ */
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { ReasoningView } from "../components/ReasoningView/index.js";
+declare const meta: Meta<typeof ReasoningView>;
+export default meta;
+type Story = StoryObj<typeof ReasoningView>;
+export declare const Collapsed: Story;
+export declare const Expanded: Story;
+export declare const Streaming: Story;
+export declare const WithDuration: Story;
+//# sourceMappingURL=ReasoningView.stories.d.ts.map

package/dist/stories/ReasoningView.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReasoningView.stories.d.ts","sourceRoot":"","sources":["../../src/stories/ReasoningView.stories.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AASrE,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,aAAa,CAWpC,CAAC;AACF,eAAe,IAAI,CAAC;AAEpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,aAAa,CAAC,CAAC;AAE5C,eAAO,MAAM,SAAS,EAAE,KAMvB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAMtB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAcvB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAa1B,CAAC"}