@cosmoops/connect-sdk 0.29.0 → 0.30.1

package/CHANGELOG.md

@@ -3,6 +3,105 @@
 `@cosmoops/connect-sdk` follows semver, with the 0.x convention that **minor
 versions may carry breaking changes** and patch versions never do.
 
+## 0.30.1
+
+`ConnectAppShell` was putting **462 KB** of markdown renderer on every page of
+every application platform that mounts it — which is every page, because the
+shell owns the layout. `streamdown` was a static import in `ConnectAskAi`, so
+it was downloaded, parsed and evaluated on each route to render nothing until
+somebody opened the assistant, which most page views never do. Measured on a
+partner app: 48 of its 49 routes carried it, roughly a quarter of each route's
+JavaScript.
+
+It is now `React.lazy`, so the chunk is requested the first time there is
+markdown to render and cached by React from then on. No API changed and no
+host setup changed; `streamdown` stays a peer dependency of `/client` and is
+still needed for formatted answers.
+
+The Suspense fallback is the **raw text** rather than a spinner. An answer
+streams in token by token, and unformatted prose is readable — so the first
+words now appear *while* the renderer is being fetched instead of behind it,
+and re-render as markdown when it lands. On a cold cache that makes the first
+answer feel earlier than it did before, not later.
+
+### Changed
+
+- `ConnectAskAi` loads `streamdown` on demand instead of at module scope.
+  Partner apps get the saving by upgrading; nothing in their code moves.
+
+## 0.30.0
+
+`<ConnectAskAi>` forgot everything on reload. Connect's own panel has had
+History and a New-conversation button since it shipped; this is the same two
+controls, backed by the same storage, for the panel a partner mounts.
+
+The reason it took a server change rather than a component one: the
+application chat lane deliberately stored nothing, because a conversation
+belongs to a *person* and an API key names an application. That is still true
+of a server-to-server call — it persists nothing, exactly as before. What
+changed is that the browser path was already sending a signed-in user's
+session token, so there has been a real owner to file a transcript under for
+some time, and nothing was doing it.
+
+### Added
+
+- **History and New in `<ConnectAskAi>`.** Two buttons in the panel header. New
+  clears the transcript and starts a fresh conversation without deleting the
+  old one; History lists what this user has asked *in your application*, and
+  pressing a row reopens the transcript and keeps writing into it.
+
+  Nothing to wire up: if your API key carries `ai:chat` it already works. There
+  is no prop to turn it on, and none to turn it off — a chat panel that cannot
+  show you what you asked yesterday is the odd one out, not the default.
+
+- `connect.ai.listConversations({ asUser, limit?, cursor? })`,
+  `connect.ai.getConversation({ conversationId, asUser })` and
+  `connect.ai.deleteConversation({ conversationId, asUser })`, plus the types
+  they answer with: `AiConversation`, `AiConversationList`,
+  `AiConversationTurn` and `AiConversationDetail`.
+
+  `asUser` is **required** on all three, unlike on `ai.chat` where it is
+  optional. There is no application-wide view of these rows to fall back to:
+  they are scoped to a person, and a version of this call that read every
+  user's transcripts is not a smaller feature, it is a different and worse one.
+
+  `turns[].parts` comes back as the AI SDK's own `UIMessage` parts, in the
+  order the model produced them — prose, reasoning and tool calls interleaved.
+  Hand them to your chat UI as they are. Flattening a turn to text loses the
+  model's own argument and makes the conversation unresumable, which is why
+  these are typed `unknown[]` rather than restated in a schema that would start
+  rejecting transcripts the day the AI SDK adds a part kind.
+
+- `connect.ai.chat({ conversationId })`, optional. Generate one id per
+  conversation client-side and send it with every turn of it; Connect upserts
+  against it. **No id, nothing stored** — which is how a caller opts out of
+  history entirely, and it stays the behaviour for any call made without
+  `asUser`.
+
+- `createConnectHandler` answers three more routes —
+  `GET /ai/conversations`, `GET /ai/conversation?id=`,
+  `DELETE /ai/conversation?id=` — and relays `conversationId` on
+  `POST /ai/chat`. The owner comes from the caller's own session on all four;
+  there is no parameter that could name somebody else.
+
+### Changed
+
+- `mutateResource(path, body?, method?)` takes an optional third argument,
+  `"POST"` (the default, and what every existing call gets) or `"DELETE"`.
+  Existing calls are unaffected.
+
+### Notes
+
+- **Scoped to your application, not just to the workspace.** A workspace
+  subscribing to two products on Connect keeps two separate histories, and
+  neither can read the other's — nor the one that user keeps in the Connect
+  portal itself. An id from the wrong one answers `404`, not somebody else's
+  transcript.
+
+- **A transcript is not an audit trail.** It records what was asked and
+  answered, and a user can delete their own. If you need a durable record of
+  something the assistant *did*, that is your own write and your own log.
+
 ## 0.29.0
 
 Voice was readable and writing was not. `calls.list` has always let a partner

package/dist/cjs/client/components/ask-ai-history.js

@@ -0,0 +1,106 @@
+"use client";
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AskAiHistory = AskAiHistory;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const react_2 = require("@heroui/react");
+const lucide_react_1 = require("lucide-react");
+const provider_js_1 = require("../provider.js");
+/** Bridge paths, spelled once - the list is read and invalidated from three places. */
+const LIST_PATH = "/ai/conversations";
+const detailPath = (id) => `/ai/conversation?id=${encodeURIComponent(id)}`;
+/**
+ * Past Ask AI conversations, for reopening or deleting.
+ *
+ * ## It fetches only while it is open
+ *
+ * `<ConnectAskAi>` is mounted for the whole application shell, so an
+ * unconditional read here would put a request on every page load to populate a
+ * list most people never open. It reads on open, and again whenever the panel
+ * has written a new conversation since - which is what `refreshKey` is for.
+ *
+ * ## Deletion confirms inline, not in a dialog
+ *
+ * Destructive actions confirm; this one does it at the weight it deserves.
+ * Losing a transcript is recoverable by asking again, not a cancelled
+ * subscription, and a modal over a 400px panel would be heavier than the thing
+ * it guards. The row swaps to "Delete? / Cancel" and stays there until
+ * answered.
+ */
+function AskAiHistory({ refreshKey, activeConversationId, onOpenConversation, }) {
+    const { fetchResource, mutateResource, invalidateResource } = (0, provider_js_1.useConnect)();
+    const [conversations, setConversations] = (0, react_1.useState)(null);
+    const [error, setError] = (0, react_1.useState)(null);
+    const [confirmingId, setConfirmingId] = (0, react_1.useState)(null);
+    const [busyId, setBusyId] = (0, react_1.useState)(null);
+    (0, react_1.useEffect)(() => {
+        let active = true;
+        // The cached entry is dropped first. This component mounts only when the
+        // user asks for the list, and the provider's cache would otherwise hand
+        // them the copy taken before the last three questions they asked.
+        invalidateResource(LIST_PATH);
+        fetchResource(LIST_PATH)
+            .then((page) => {
+            if (!active)
+                return;
+            setConversations(page.conversations);
+            setError(null);
+        })
+            .catch((cause) => {
+            if (!active)
+                return;
+            // An empty list rather than a permanent skeleton: the error is shown
+            // beside it, and a panel stuck loading says nothing at all.
+            setConversations([]);
+            setError(cause instanceof Error ? cause.message : "Could not load your conversations");
+        });
+        return () => {
+            active = false;
+        };
+    }, [fetchResource, invalidateResource, refreshKey]);
+    const open = async (id) => {
+        setBusyId(id);
+        try {
+            const detail = await fetchResource(detailPath(id));
+            onOpenConversation(id, detail);
+        }
+        catch (cause) {
+            setError(cause instanceof Error ? cause.message : "Could not open that conversation");
+        }
+        finally {
+            setBusyId(null);
+        }
+    };
+    const remove = async (id) => {
+        setBusyId(id);
+        // Removed from the list before the response lands. The confirmation was the
+        // decision point, and a row that lingers while the request flies reads as a
+        // press that did not take - so the list is patched and put back on failure.
+        const previous = conversations;
+        setConversations((current) => current?.filter((row) => row.id !== id) ?? null);
+        setConfirmingId(null);
+        try {
+            await mutateResource(detailPath(id), undefined, "DELETE");
+            invalidateResource(LIST_PATH);
+        }
+        catch (cause) {
+            setConversations(previous);
+            setError(cause instanceof Error ? cause.message : "Could not delete that conversation");
+        }
+        finally {
+            setBusyId(null);
+        }
+    };
+    if (conversations === null) {
+        return ((0, jsx_runtime_1.jsx)("div", { className: "space-y-2 p-4", "aria-busy": "true", children: [0, 1, 2].map((row) => ((0, jsx_runtime_1.jsx)("div", { className: "h-9 animate-pulse rounded-md bg-surface-secondary" }, row))) }));
+    }
+    if (conversations.length === 0) {
+        return ((0, jsx_runtime_1.jsx)("div", { className: "p-4", children: error ? ((0, jsx_runtime_1.jsx)("p", { className: "text-xs text-danger", children: error })) : ((0, jsx_runtime_1.jsx)("p", { className: "text-center text-xs text-muted", children: "Nothing here yet. Conversations you have are saved automatically." })) }));
+    }
+    return ((0, jsx_runtime_1.jsxs)("div", { className: "p-2", children: [error && (0, jsx_runtime_1.jsx)("p", { className: "px-2 pb-2 text-xs text-danger", children: error }), (0, jsx_runtime_1.jsx)("ul", { className: "space-y-0.5", children: conversations.map((conversation) => {
+                    const isConfirming = confirmingId === conversation.id;
+                    const isActive = conversation.id === activeConversationId;
+                    return ((0, jsx_runtime_1.jsx)("li", { children: isConfirming ? ((0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-2 rounded-md border border-border px-2 py-1.5", children: [(0, jsx_runtime_1.jsx)("span", { className: "flex-1 truncate text-xs text-muted", children: "Delete this conversation?" }), (0, jsx_runtime_1.jsx)(react_2.Button, { size: "sm", variant: "danger", className: "h-7 px-2 text-xs", isDisabled: busyId === conversation.id, onPress: () => void remove(conversation.id), children: "Delete" }), (0, jsx_runtime_1.jsx)(react_2.Button, { size: "sm", variant: "tertiary", className: "h-7 px-2 text-xs", onPress: () => setConfirmingId(null), children: "Cancel" })] })) : ((0, jsx_runtime_1.jsxs)("div", { className: `group flex items-center gap-1 rounded-md ${isActive ? "bg-surface-secondary" : ""}`, children: [(0, jsx_runtime_1.jsxs)(react_2.Button, { variant: "ghost", className: "h-auto min-w-0 flex-1 justify-start gap-2 px-2 py-1.5 text-start", isDisabled: busyId === conversation.id, onPress: () => void open(conversation.id), children: [(0, jsx_runtime_1.jsx)(lucide_react_1.MessageSquare, { className: "size-3.5 shrink-0 text-muted" }), (0, jsx_runtime_1.jsx)("span", { className: "min-w-0 flex-1 truncate text-xs font-normal", children: conversation.title })] }), (0, jsx_runtime_1.jsx)(react_2.Button, { isIconOnly: true, size: "sm", variant: "ghost", className: "shrink-0", "aria-label": `Delete "${conversation.title}"`, onPress: () => setConfirmingId(conversation.id), children: (0, jsx_runtime_1.jsx)(lucide_react_1.Trash2, { className: "size-3.5 text-muted" }) })] })) }, conversation.id));
+                }) })] }));
+}

package/dist/cjs/client/components/ask-ai-turns.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lastTextBlockIndex = lastTextBlockIndex;
+exports.appendText = appendText;
+exports.turnsFromStored = turnsFromStored;
+/**
+ * Index of the final text block, or `-1`. A reverse loop rather than
+ * `findLastIndex`, which is ES2023 - this package targets ES2022 so its
+ * published output stays usable on the runtimes its `engines` field claims.
+ */
+function lastTextBlockIndex(blocks) {
+    for (let index = blocks.length - 1; index >= 0; index--) {
+        if (blocks[index]?.kind === "text")
+            return index;
+    }
+    return -1;
+}
+/** Appends a text delta to the open text block, or opens one after a widget. */
+function appendText(blocks, text) {
+    const last = blocks.at(-1);
+    if (last?.kind === "text") {
+        return [...blocks.slice(0, -1), { kind: "text", text: last.text + text }];
+    }
+    return [...blocks, { kind: "text", text }];
+}
+/**
+ * Rebuilds the panel's turns from a stored transcript.
+ *
+ * The inverse of what the stream reader does live, and it has to agree with it
+ * or a reopened conversation renders differently from the one the user just
+ * had. Two shapes, one source: the stream delivers `text-delta`,
+ * `reasoning-delta` and `tool-input-available` frames, and storage keeps the
+ * settled `UIMessage` parts those frames built - `{ type: "text" }`,
+ * `{ type: "reasoning" }`, and `{ type: "tool-<name>" }` carrying the input the
+ * widget was drawn from.
+ *
+ * Three rules, each of which is a thing that would otherwise render wrong:
+ *
+ * - **A tool part with no input is dropped, not restored.** `input: null` means
+ *   "still arriving" to the renderer, which draws a skeleton - correct live,
+ *   and a shimmer that never resolves on a transcript that finished days ago.
+ * - **Reasoning is hoisted per turn**, not left in place. It is rendered above
+ *   the answer in a disclosure, which is where it sat while streaming.
+ * - **A part this build cannot place is skipped rather than guessed at.**
+ *   `parts` is the AI SDK's own shape and gains kinds over time; an unknown one
+ *   costs a widget, and inventing a rendering for it costs the whole turn.
+ */
+function turnsFromStored(turns) {
+    return turns.map((turn) => {
+        let blocks = [];
+        let reasoning = "";
+        for (const raw of turn.parts) {
+            const part = raw;
+            if (typeof part?.type !== "string")
+                continue;
+            if (part.type === "text") {
+                if (typeof part.text === "string" && part.text.length > 0) {
+                    blocks = appendText(blocks, part.text);
+                }
+                continue;
+            }
+            if (part.type === "reasoning") {
+                if (typeof part.text === "string")
+                    reasoning += part.text;
+                continue;
+            }
+            if (part.type.startsWith("tool-")) {
+                // See the note above: an absent input is a skeleton forever.
+                if (part.input === undefined || part.input === null)
+                    continue;
+                blocks = [
+                    ...blocks,
+                    {
+                        kind: "tool",
+                        // The stored call id when there is one. Falling back to the block's
+                        // position keeps React keys unique within the turn, which is all
+                        // this id is used for once the turn is settled.
+                        id: typeof part.toolCallId === "string" ? part.toolCallId : `${turn.id}-${blocks.length}`,
+                        name: part.type.slice("tool-".length),
+                        input: part.input,
+                    },
+                ];
+            }
+        }
+        return { id: turn.id, role: turn.role, blocks, reasoning };
+    });
+}

package/dist/cjs/client/components/ask-ai.js

@@ -1,16 +1,73 @@
 "use client";
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConnectAskAi = ConnectAskAi;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
 const react_2 = require("@heroui/react");
 const lucide_react_1 = require("lucide-react");
-const streamdown_1 = require("streamdown");
 const provider_js_1 = require("../provider.js");
+/**
+ * The markdown renderer, fetched the first time there is markdown to render.
+ *
+ * `streamdown` is **462 KB** of the host's client bundle, and a static import
+ * here put all of it on every page of every application platform that mounts
+ * `ConnectAppShell` - which is every page, because the shell owns the layout.
+ * It rendered nothing until somebody opened the assistant, which most page
+ * views never do. Measured on one partner app: 48 of 49 routes carrying it,
+ * about a quarter of each route's JavaScript.
+ *
+ * `lazy` rather than a conditional `import()` in an effect: React caches the
+ * module promise, so the chunk is requested once no matter how many messages
+ * render, and the boundary below is what covers the gap.
+ *
+ * The fallback is the **raw text**, not a spinner. An answer streams in token
+ * by token, and unformatted prose is readable - so the first words appear
+ * while the renderer is still arriving rather than behind it. Once it lands,
+ * the same text re-renders as markdown.
+ */
+const Streamdown = (0, react_1.lazy)(async () => {
+    const mod = await Promise.resolve().then(() => __importStar(require("streamdown")));
+    return { default: mod.Streamdown };
+});
 const use_active_path_js_1 = require("../use-active-path.js");
 const ai_screens_js_1 = require("./ai-screens.js");
 const ai_widgets_js_1 = require("./ai-widgets.js");
+const ask_ai_history_js_1 = require("./ask-ai-history.js");
+const ask_ai_turns_js_1 = require("./ask-ai-turns.js");
 /**
  * The panel's open width. The *inner* pane always carries it, so the content
  * keeps its layout while the outer shell's width animates to zero around it.
@@ -170,26 +227,6 @@ async function readStream(response, onChunk) {
         }
     }
 }
-/**
- * Index of the final text block, or `-1`. A reverse loop rather than
- * `findLastIndex`, which is ES2023 - this package targets ES2022 so its
- * published output stays usable on the runtimes its `engines` field claims.
- */
-function lastTextBlockIndex(blocks) {
-    for (let index = blocks.length - 1; index >= 0; index--) {
-        if (blocks[index]?.kind === "text")
-            return index;
-    }
-    return -1;
-}
-/** Appends a text delta to the open text block, or opens one after a widget. */
-function appendText(blocks, text) {
-    const last = blocks.at(-1);
-    if (last?.kind === "text") {
-        return [...blocks.slice(0, -1), { kind: "text", text: last.text + text }];
-    }
-    return [...blocks, { kind: "text", text }];
-}
 /**
  * Ask AI - a chat panel grounded in the signed-in workspace's Context Index,
  * streamed through your own bridge.
@@ -238,6 +275,31 @@ function ConnectAskAi({ title = "Ask AI", assistantName = "Assistant", placehold
     const [input, setInput] = (0, react_1.useState)("");
     const [isBusy, setIsBusy] = (0, react_1.useState)(false);
     const [error, setError] = (0, react_1.useState)(null);
+    const [showHistory, setShowHistory] = (0, react_1.useState)(false);
+    /**
+     * The conversation being written to.
+     *
+     * Generated here, before the first message, because the server cannot hand
+     * one back: it is streaming a response, and there is no point in that stream
+     * at which a new id could reach the browser ahead of the first token. So the
+     * client picks it and Connect upserts - safe because ownership is checked
+     * rather than assumed, and an id naming somebody else's conversation is
+     * refused.
+     *
+     * Lazily initialised rather than computed in a `useMemo`: this has to survive
+     * re-renders and change only when the user starts a new conversation, which
+     * is precisely what `useMemo` does not promise.
+     */
+    const [conversationId, setConversationId] = (0, react_1.useState)(() => newConversationId());
+    /**
+     * Bumped whenever a turn has been written, so the history list re-reads the
+     * next time it is opened.
+     *
+     * A counter rather than a refetch call, because the list is unmounted while
+     * closed - there is nothing to tell. It is *why* the list re-reads, not the
+     * list itself.
+     */
+    const [writeCount, setWriteCount] = (0, react_1.useState)(0);
     const abortRef = (0, react_1.useRef)(null);
     const bottomRef = (0, react_1.useRef)(null);
     // Ids only have to be unique within one mounted conversation, so a counter is
@@ -260,11 +322,11 @@ function ConnectAskAi({ title = "Ask AI", assistantName = "Assistant", placehold
      */
     const resolvedPath = (0, use_active_path_js_1.useActivePath)(activePath);
     const currentScreen = (0, react_1.useMemo)(() => (resolvedPath ? (0, ai_screens_js_1.matchConnectScreen)(screens, resolvedPath) : null), [screens, resolvedPath]);
-    const renderMarkdown = (0, react_1.useCallback)((text, isStreaming = false) => ((0, jsx_runtime_1.jsx)(streamdown_1.Streamdown, { className: "connect-ai-body", mode: isStreaming ? "streaming" : "static", isAnimating: isStreaming, animated: ANIMATED, caret: isStreaming ? "block" : undefined, plugins: markdownPlugins, 
-        // Retrieved documents cite real URLs; an interstitial on every one of
-        // them turns a citation into a chore. The renderer still sanitises the
-        // markup itself, which is the part that matters.
-        linkSafety: LINK_SAFETY, children: text })), [markdownPlugins]);
+    const renderMarkdown = (0, react_1.useCallback)((text, isStreaming = false) => ((0, jsx_runtime_1.jsx)(react_1.Suspense, { fallback: (0, jsx_runtime_1.jsx)("div", { className: "connect-ai-body whitespace-pre-wrap", children: text }), children: (0, jsx_runtime_1.jsx)(Streamdown, { className: "connect-ai-body", mode: isStreaming ? "streaming" : "static", isAnimating: isStreaming, animated: ANIMATED, caret: isStreaming ? "block" : undefined, plugins: markdownPlugins, 
+            // Retrieved documents cite real URLs; an interstitial on every one of
+            // them turns a citation into a chore. The renderer still sanitises the
+            // markup itself, which is the part that matters.
+            linkSafety: LINK_SAFETY, children: text }) })), [markdownPlugins]);
     const stop = (0, react_1.useCallback)(() => {
         abortRef.current?.abort();
         abortRef.current = null;
@@ -312,6 +374,11 @@ function ConnectAskAi({ title = "Ask AI", assistantName = "Assistant", placehold
                 // decide what anyone may do. See `ConnectScreen`.
                 ...(resolvedPath ? { screenContext: { pathname: resolvedPath } } : {}),
                 ...(screens.length > 0 ? { screens } : {}),
+                // What makes the conversation resumable. Connect stores the turn
+                // against it and `<AskAiHistory>` reads it back; a turn sent
+                // without one is answered exactly the same way and remembered by
+                // nobody.
+                conversationId,
             }, { signal: controller.signal });
             // The assistant's turn is appended only once the stream is live, so a
             // failed request leaves an error under the question rather than an
@@ -319,7 +386,7 @@ function ConnectAskAi({ title = "Ask AI", assistantName = "Assistant", placehold
             setTurns((current) => [...current, { id: answerId, role: "assistant", blocks: [], reasoning: "" }]);
             await readStream(response, (chunk) => {
                 if (chunk.text) {
-                    patchAnswer((turn) => ({ ...turn, blocks: appendText(turn.blocks, chunk.text) }));
+                    patchAnswer((turn) => ({ ...turn, blocks: (0, ask_ai_turns_js_1.appendText)(turn.blocks, chunk.text) }));
                 }
                 if (chunk.reasoning) {
                     patchAnswer((turn) => ({ ...turn, reasoning: turn.reasoning + chunk.reasoning }));
@@ -348,13 +415,46 @@ function ConnectAskAi({ title = "Ask AI", assistantName = "Assistant", placehold
             if (abortRef.current === controller)
                 abortRef.current = null;
             setIsBusy(false);
+            // Even on an aborted or failed turn: the user's own question has
+            // already been persisted by the time anything can go wrong downstream
+            // of it, so the list is stale either way.
+            setWriteCount((count) => count + 1);
         }
-    }, [streamResource, turns]);
+    }, [streamResource, turns, conversationId]);
+    /**
+     * Clears the transcript and starts writing into a fresh conversation.
+     *
+     * The old one is not deleted - it is in History, which is the whole point.
+     */
+    const startNewConversation = (0, react_1.useCallback)(() => {
+        abortRef.current?.abort();
+        abortRef.current = null;
+        setIsBusy(false);
+        setTurns([]);
+        setError(null);
+        setShowHistory(false);
+        setConversationId(newConversationId());
+    }, []);
+    /**
+     * Replaces the transcript with a stored one, and continues writing into it.
+     *
+     * Writing continues into the conversation that was opened rather than forking
+     * a new one, which is what makes "come back to this tomorrow" work at all.
+     */
+    const openConversation = (0, react_1.useCallback)((id, detail) => {
+        abortRef.current?.abort();
+        abortRef.current = null;
+        setIsBusy(false);
+        setError(null);
+        setTurns((0, ask_ai_turns_js_1.turnsFromStored)(detail.turns));
+        setConversationId(id);
+        setShowHistory(false);
+    }, []);
     const lastTurn = turns.at(-1);
     const isAnswering = isBusy && lastTurn?.role === "assistant";
     const rendered = (0, react_1.useMemo)(() => turns.map((turn) => {
         const isLive = isAnswering && turn.id === lastTurn?.id;
-        const lastTextIndex = lastTextBlockIndex(turn.blocks);
+        const lastTextIndex = (0, ask_ai_turns_js_1.lastTextBlockIndex)(turn.blocks);
         return ((0, jsx_runtime_1.jsxs)("div", { className: `connect-ai-host rounded-md border border-border p-2.5 text-sm ${turn.role === "user" ? "bg-surface-secondary" : "bg-accent/5"}`, children: [(0, jsx_runtime_1.jsx)("p", { className: "mb-1 text-[11px] font-semibold tracking-wide text-muted uppercase", children: turn.role === "user" ? "You" : assistantName }), turn.role === "assistant" && ((0, jsx_runtime_1.jsx)(ThinkingDisclosure, { text: turn.reasoning, isStreaming: isLive && lastTextIndex === -1 })), turn.blocks.map((block, index) => block.kind === "text" ? (
                 // The user's own turn is shown as they typed it - running a
                 // question that happens to start with `#` through the markdown
@@ -371,9 +471,34 @@ function ConnectAskAi({ title = "Ask AI", assistantName = "Assistant", placehold
         if (!text || isBusy)
             return;
         setInput("");
+        // Typing sends you back to the conversation: staying on the history list
+        // while an answer streams behind it would hide the thing just asked for.
+        setShowHistory(false);
         void send(text);
     };
-    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [!isOpen && ((0, jsx_runtime_1.jsx)(react_2.Button, { isIconOnly: true, variant: "primary", "aria-label": title, onPress: () => setIsOpen(true), className: "fixed bottom-4 end-4 z-30 size-12 rounded-full shadow-lg sm:bottom-6 sm:end-6", children: (0, jsx_runtime_1.jsx)(lucide_react_1.Sparkles, { className: "size-5" }) })), (0, jsx_runtime_1.jsx)("div", { className: `fixed inset-0 z-40 bg-backdrop transition-opacity lg:hidden ${isOpen ? "pointer-events-auto opacity-100" : "pointer-events-none opacity-0"}`, onClick: () => setIsOpen(false), "aria-hidden": "true" }), (0, jsx_runtime_1.jsx)("aside", { "aria-hidden": !isOpen, className: `fixed inset-y-0 end-0 z-50 flex flex-col border-s border-border bg-surface shadow-xl transition-transform duration-300 ease-in-out ${panelShellWidth(isOpen)} ${isOpen ? "translate-x-0" : "translate-x-full rtl:-translate-x-full"} lg:static lg:z-auto lg:translate-x-0 lg:shadow-none lg:transition-[width]`, children: (0, jsx_runtime_1.jsxs)("div", { className: `flex h-full shrink-0 flex-col ${PANEL_WIDTH}`, children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-2 border-b border-border px-4 py-3", children: [(0, jsx_runtime_1.jsx)(lucide_react_1.Sparkles, { className: "size-4 shrink-0 text-accent" }), (0, jsx_runtime_1.jsx)("span", { className: "flex-1 text-sm font-semibold", children: title }), (0, jsx_runtime_1.jsx)(react_2.Button, { isIconOnly: true, size: "sm", variant: "tertiary", "aria-label": "Close", onPress: () => setIsOpen(false), children: (0, jsx_runtime_1.jsx)(lucide_react_1.X, { className: "size-4" }) })] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex-1 space-y-3 overflow-y-auto p-4", children: [turns.length === 0 && ((0, jsx_runtime_1.jsxs)("div", { className: "space-y-3", children: [(0, jsx_runtime_1.jsx)("p", { className: "text-sm text-muted", children: hint }), currentScreen?.suggestions?.length ? ((0, jsx_runtime_1.jsx)("div", { className: "flex flex-wrap gap-1.5", children: currentScreen.suggestions.map((suggestion) => ((0, jsx_runtime_1.jsx)(react_2.Button, { size: "sm", variant: "secondary", className: "h-auto rounded-full px-2.5 py-1 text-start text-xs whitespace-normal", isDisabled: isBusy, onPress: () => void send(suggestion), children: suggestion }, suggestion))) })) : null] })), rendered, isBusy && lastTurn?.role === "user" && ((0, jsx_runtime_1.jsxs)("div", { className: "rounded-md border border-border bg-accent/5 p-2.5 text-sm", children: [(0, jsx_runtime_1.jsx)("p", { className: "mb-1 text-[11px] font-semibold tracking-wide text-muted uppercase", children: assistantName }), (0, jsx_runtime_1.jsx)(ThinkingShimmer, {})] })), error && (0, jsx_runtime_1.jsx)("p", { className: "text-xs text-danger", children: error }), (0, jsx_runtime_1.jsx)("div", { ref: bottomRef })] }), (0, jsx_runtime_1.jsxs)("form", { onSubmit: handleSubmit, className: "flex gap-2 border-t border-border p-3", children: [(0, jsx_runtime_1.jsxs)(react_2.TextField, { variant: "secondary", className: "flex-1", children: [(0, jsx_runtime_1.jsx)(react_2.Label, { className: "sr-only", children: placeholder }), (0, jsx_runtime_1.jsx)(react_2.Input, { placeholder: placeholder, value: input, onChange: (event) => setInput(event.currentTarget.value), disabled: isBusy })] }), isBusy ? ((0, jsx_runtime_1.jsx)(react_2.Button, { type: "button", isIconOnly: true, variant: "secondary", "aria-label": "Stop generating", onPress: stop, children: (0, jsx_runtime_1.jsx)(lucide_react_1.Square, { className: "size-3.5" }) })) : ((0, jsx_runtime_1.jsx)(react_2.Button, { type: "submit", isIconOnly: true, variant: "primary", "aria-label": "Send", isDisabled: !input.trim(), children: (0, jsx_runtime_1.jsx)(lucide_react_1.Send, { className: "size-3.5" }) }))] })] }) })] }));
+    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [!isOpen && ((0, jsx_runtime_1.jsx)(react_2.Button, { isIconOnly: true, variant: "primary", "aria-label": title, onPress: () => setIsOpen(true), className: "fixed bottom-4 end-4 z-30 size-12 rounded-full shadow-lg sm:bottom-6 sm:end-6", children: (0, jsx_runtime_1.jsx)(lucide_react_1.Sparkles, { className: "size-5" }) })), (0, jsx_runtime_1.jsx)("div", { className: `fixed inset-0 z-40 bg-backdrop transition-opacity lg:hidden ${isOpen ? "pointer-events-auto opacity-100" : "pointer-events-none opacity-0"}`, onClick: () => setIsOpen(false), "aria-hidden": "true" }), (0, jsx_runtime_1.jsx)("aside", { "aria-hidden": !isOpen, className: `fixed inset-y-0 end-0 z-50 flex flex-col border-s border-border bg-surface shadow-xl transition-transform duration-300 ease-in-out ${panelShellWidth(isOpen)} ${isOpen ? "translate-x-0" : "translate-x-full rtl:-translate-x-full"} lg:static lg:z-auto lg:translate-x-0 lg:shadow-none lg:transition-[width]`, children: (0, jsx_runtime_1.jsxs)("div", { className: `flex h-full shrink-0 flex-col ${PANEL_WIDTH}`, children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-2 border-b border-border px-4 py-3", children: [(0, jsx_runtime_1.jsx)(lucide_react_1.Sparkles, { className: "size-4 shrink-0 text-accent" }), (0, jsx_runtime_1.jsx)("span", { className: "flex-1 text-sm font-semibold", children: title }), (0, jsx_runtime_1.jsx)(react_2.Button, { isIconOnly: true, size: "sm", variant: "tertiary", "aria-label": "New conversation", 
+                                    // Disabled on an empty one rather than hidden: a control that
+                                    // appears and disappears as you use the panel is harder to find
+                                    // than one that is always in the same place.
+                                    isDisabled: turns.length === 0, onPress: startNewConversation, children: (0, jsx_runtime_1.jsx)(lucide_react_1.Plus, { className: "size-4" }) }), (0, jsx_runtime_1.jsx)(react_2.Button, { isIconOnly: true, size: "sm", variant: "tertiary", "aria-label": showHistory ? "Hide past conversations" : "Past conversations", "aria-pressed": showHistory, onPress: () => setShowHistory((open) => !open), children: (0, jsx_runtime_1.jsx)(lucide_react_1.History, { className: "size-4" }) }), (0, jsx_runtime_1.jsx)(react_2.Button, { isIconOnly: true, size: "sm", variant: "tertiary", "aria-label": "Close", onPress: () => setIsOpen(false), children: (0, jsx_runtime_1.jsx)(lucide_react_1.X, { className: "size-4" }) })] }), showHistory ? ((0, jsx_runtime_1.jsx)("div", { className: "min-h-0 flex-1 overflow-y-auto", children: (0, jsx_runtime_1.jsx)(ask_ai_history_js_1.AskAiHistory, { refreshKey: writeCount, activeConversationId: conversationId, onOpenConversation: openConversation }) })) : ((0, jsx_runtime_1.jsxs)("div", { className: "flex-1 space-y-3 overflow-y-auto p-4", children: [turns.length === 0 && ((0, jsx_runtime_1.jsxs)("div", { className: "space-y-3", children: [(0, jsx_runtime_1.jsx)("p", { className: "text-sm text-muted", children: hint }), currentScreen?.suggestions?.length ? ((0, jsx_runtime_1.jsx)("div", { className: "flex flex-wrap gap-1.5", children: currentScreen.suggestions.map((suggestion) => ((0, jsx_runtime_1.jsx)(react_2.Button, { size: "sm", variant: "secondary", className: "h-auto rounded-full px-2.5 py-1 text-start text-xs whitespace-normal", isDisabled: isBusy, onPress: () => void send(suggestion), children: suggestion }, suggestion))) })) : null] })), rendered, isBusy && lastTurn?.role === "user" && ((0, jsx_runtime_1.jsxs)("div", { className: "rounded-md border border-border bg-accent/5 p-2.5 text-sm", children: [(0, jsx_runtime_1.jsx)("p", { className: "mb-1 text-[11px] font-semibold tracking-wide text-muted uppercase", children: assistantName }), (0, jsx_runtime_1.jsx)(ThinkingShimmer, {})] })), error && (0, jsx_runtime_1.jsx)("p", { className: "text-xs text-danger", children: error }), (0, jsx_runtime_1.jsx)("div", { ref: bottomRef })] })), (0, jsx_runtime_1.jsxs)("form", { onSubmit: handleSubmit, className: "flex gap-2 border-t border-border p-3", children: [(0, jsx_runtime_1.jsxs)(react_2.TextField, { variant: "secondary", className: "flex-1", children: [(0, jsx_runtime_1.jsx)(react_2.Label, { className: "sr-only", children: placeholder }), (0, jsx_runtime_1.jsx)(react_2.Input, { placeholder: placeholder, value: input, onChange: (event) => setInput(event.currentTarget.value), disabled: isBusy })] }), isBusy ? ((0, jsx_runtime_1.jsx)(react_2.Button, { type: "button", isIconOnly: true, variant: "secondary", "aria-label": "Stop generating", onPress: stop, children: (0, jsx_runtime_1.jsx)(lucide_react_1.Square, { className: "size-3.5" }) })) : ((0, jsx_runtime_1.jsx)(react_2.Button, { type: "submit", isIconOnly: true, variant: "primary", "aria-label": "Send", isDisabled: !input.trim(), children: (0, jsx_runtime_1.jsx)(lucide_react_1.Send, { className: "size-3.5" }) }))] })] }) })] }));
 }
 /** Hoisted for the same reference-equality reason as `ANIMATED` - Streamdown compares it by identity. */
 const LINK_SAFETY = { enabled: false };
+/**
+ * A fresh conversation id.
+ *
+ * `crypto.randomUUID` where it exists, and it usually does - but it is gated on
+ * a *secure context*, so it is simply absent on an `http://` origin that is not
+ * localhost. That is somebody's LAN dev server or a staging box on a bare IP,
+ * and a panel that throws there rather than chatting would be a poor trade for
+ * four lines. The fallback is not cryptographically strong and does not need to
+ * be: the id selects among the caller's own conversations and grants nothing -
+ * Connect refuses one belonging to another user or another application - so its
+ * only real job is not to collide with itself.
+ */
+function newConversationId() {
+    if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+        return crypto.randomUUID();
+    }
+    return `c-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 12)}`;
+}

package/dist/cjs/client/provider.js

@@ -108,9 +108,9 @@ function ConnectProvider({ clientId = "", basePath = "/api/connect", redirectUri
         cache.current.set(key, pending);
         return pending;
     }, [basePath, fetchImpl]);
-    const mutateResource = (0, react_1.useCallback)(async (path, body) => {
+    const mutateResource = (0, react_1.useCallback)(async (path, body, method = "POST") => {
         const response = await (fetchImpl ?? globalThis.fetch)(`${basePath}${path}`, {
-            method: "POST",
+            method,
             credentials: "same-origin",
             headers: {
                 accept: "application/json",

package/dist/cjs/server/client.js

@@ -165,4 +165,4 @@ class ConnectClient {
 }
 exports.ConnectClient = ConnectClient;
 /** Kept in step with `package.json` by `sdk.test.ts`. */
-exports.SDK_VERSION = "0.29.0";
+exports.SDK_VERSION = "0.30.1";