@cosmoops/connect-sdk 0.41.0 → 0.42.0

package/dist/esm/client/components/access-gate.js

@@ -271,26 +271,26 @@ function AccessGateFallback({ state, blocker, className, }) {
  * to a choice they can act on. Sending them to Connect's own subscribe page
  * always resolves.
  *
- * ### Same tab, and it carries the way back
+ * ### A hand-off, so it ends back here
  *
- * It used to `window.open(resolveUrl, "_blank")`. A new tab is the wrong
- * shape for a step you have to finish before you can continue: the customer
- * subscribes over there, is left on Connect's billing page with nothing
- * pointing home, and the tab they started in is still showing this card. The
- * most common ending was two open tabs and the belief that the payment had
- * not worked.
+ * It used to `window.open(resolveUrl, "_blank")`, and the customer was left on
+ * Connect's billing page with nothing pointing home while the tab they
+ * started in still showed this card - two open tabs and the belief that the
+ * payment had not worked. Then it went same-tab with `?next=`, which only
+ * Connect's subscribe page honoured, so every other blocker (a lapsed
+ * payment, a missing payment method, verification) still stranded them.
  *
- * So: a same-tab navigation carrying `?next=` back to the page they are
- * standing on, which Connect honours after a subscribe once the origin
- * matches one registered for this application's client
- * (`resolveApplicationReturnUrl`). An unregistered origin costs the return
- * trip and nothing else - they still reach Connect, still resolve the
- * blocker, and `ConnectAccessGate`'s focus re-check catches them on the way
- * back. Partners should register their app's origin; the fallback is a
- * degraded path, not a broken one.
+ * Now it is `openConnect`, like every other Connect button: Connect brings
+ * them back from whichever page the blocker points at, closing itself in
+ * `popup` mode or navigating back in `redirect` mode, and the provider
+ * re-reads the entitlements the moment it reports in - so this card is
+ * replaced by the app without anyone reloading. The focus re-check in
+ * `ConnectAccessGate` stays as the backstop for an origin Connect could not
+ * validate, which still reaches the blocker and just gets no way back.
  */
 function GateCard({ icon: Icon, iconClassName, title, message, actionLabel, resolveUrl, className, }) {
-    return (_jsx(MotionProvider, { children: _jsx(m.div, { initial: { opacity: 0, y: -6 }, animate: { opacity: 1, y: 0 }, transition: ENTER, children: _jsxs(Card, { className: className, children: [_jsxs(Card.Header, { children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Icon, { className: `size-5 shrink-0 ${iconClassName}`, "aria-hidden": "true" }), _jsx(Card.Title, { children: title })] }), _jsx(Card.Description, { children: message })] }), resolveUrl && (_jsx(Card.Footer, { children: _jsxs(Button, { variant: "primary", onPress: () => window.location.assign(withReturnTo(resolveUrl)), children: [actionLabel ?? "Resolve on Connect", _jsx(ExternalLink, { className: "size-3.5" })] }) }))] }) }) }));
+    const { openConnect } = useConnect();
+    return (_jsx(MotionProvider, { children: _jsx(m.div, { initial: { opacity: 0, y: -6 }, animate: { opacity: 1, y: 0 }, transition: ENTER, children: _jsxs(Card, { className: className, children: [_jsxs(Card.Header, { children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Icon, { className: `size-5 shrink-0 ${iconClassName}`, "aria-hidden": "true" }), _jsx(Card.Title, { children: title })] }), _jsx(Card.Description, { children: message })] }), resolveUrl && (_jsx(Card.Footer, { children: _jsxs(Button, { variant: "primary", onPress: () => openConnect(resolveUrl), children: [actionLabel ?? "Resolve on Connect", _jsx(ExternalLink, { className: "size-3.5" })] }) }))] }) }) }));
 }
 /**
  * The skippable payment-due warning. Dismissal is scoped to this specific
@@ -299,36 +299,14 @@ function GateCard({ icon: Icon, iconClassName, title, message, actionLabel, reso
  * though an old dismissal is still on record.
  */
 function PaymentRetryBanner({ blocker, className, }) {
+    const { openConnect } = useConnect();
     const dismissKey = blocker.graceEndsAt ? `connect_dismissed_payment_retry_pending_${blocker.graceEndsAt}` : null;
     const [dismissed, setDismissed] = useState(() => dismissKey !== null && typeof window !== "undefined" && window.localStorage.getItem(dismissKey) === "1");
     if (dismissed)
         return null;
-    return (_jsx(MotionProvider, { children: _jsxs(m.div, { className: cn("flex flex-wrap items-center justify-between gap-3 rounded-lg bg-accent-soft px-3 py-2 text-sm text-accent", className), role: "status", initial: { opacity: 0, y: -6 }, animate: { opacity: 1, y: 0 }, transition: ENTER, children: [_jsxs("span", { className: "flex items-center gap-2", children: [_jsx(AlertTriangle, { className: "size-4 shrink-0", "aria-hidden": "true" }), blocker.message, blocker.graceEndsAt && ` Resolve by ${formatDate(blocker.graceEndsAt)} to avoid losing access.`] }), _jsxs("div", { className: "flex items-center gap-2", children: [blocker.resolveUrl && (_jsxs(Button, { variant: "secondary", onPress: () => window.open(blocker.resolveUrl, "_blank", "noopener,noreferrer"), children: ["Resolve payment", _jsx(ExternalLink, { className: "size-3.5" })] })), _jsx(Button, { variant: "tertiary", isIconOnly: true, "aria-label": "Dismiss", onPress: () => {
+    return (_jsx(MotionProvider, { children: _jsxs(m.div, { className: cn("flex flex-wrap items-center justify-between gap-3 rounded-lg bg-accent-soft px-3 py-2 text-sm text-accent", className), role: "status", initial: { opacity: 0, y: -6 }, animate: { opacity: 1, y: 0 }, transition: ENTER, children: [_jsxs("span", { className: "flex items-center gap-2", children: [_jsx(AlertTriangle, { className: "size-4 shrink-0", "aria-hidden": "true" }), blocker.message, blocker.graceEndsAt && ` Resolve by ${formatDate(blocker.graceEndsAt)} to avoid losing access.`] }), _jsxs("div", { className: "flex items-center gap-2", children: [blocker.resolveUrl && (_jsxs(Button, { variant: "secondary", onPress: () => openConnect(blocker.resolveUrl), children: ["Resolve payment", _jsx(ExternalLink, { className: "size-3.5" })] })), _jsx(Button, { variant: "tertiary", isIconOnly: true, "aria-label": "Dismiss", onPress: () => {
                                 setDismissed(true);
                                 if (dismissKey && typeof window !== "undefined")
                                     window.localStorage.setItem(dismissKey, "1");
                             }, children: _jsx(X, { className: "size-4" }) })] })] }) }));
 }
-/**
- * `resolveUrl` with `?next=` pointing at the page the customer is standing
- * on, so Connect can hand them back once the blocker is gone.
- *
- * Returns the URL untouched if anything is off - no `window`, an unparseable
- * `resolveUrl`, a `next` already set by the server. Getting back is a
- * courtesy on top of resolving the blocker, and it must never be the reason
- * somebody cannot reach the screen that resolves it.
- */
-function withReturnTo(resolveUrl) {
-    if (typeof window === "undefined")
-        return resolveUrl;
-    try {
-        const url = new URL(resolveUrl);
-        if (url.searchParams.has("next"))
-            return resolveUrl;
-        url.searchParams.set("next", window.location.href);
-        return url.toString();
-    }
-    catch {
-        return resolveUrl;
-    }
-}

package/dist/esm/client/components/apps-grid.js

@@ -102,7 +102,7 @@ function GridSkeleton() {
  * button that opens an empty box.
  */
 export function ConnectAppsGrid({ className, label = "Switch app", variant = "row" }) {
-    const { session, isLoading: sessionLoading, appUrl } = useConnect();
+    const { session, isLoading: sessionLoading, openConnect } = useConnect();
     const { data, isLoading, error } = useConnectApps();
     const [query, setQuery] = useState("");
     const apps = useMemo(() => data?.apps ?? [], [data]);
@@ -123,8 +123,16 @@ export function ConnectAppsGrid({ className, label = "Switch app", variant = "ro
         // application's page on Connect, which is where a plan is actually
         // chosen. The SDK owns this mapping so no integration has to know either
         // URL shape.
-        const target = app.subscribed && app.launchUrl ? app.launchUrl : `${appUrl}/apps/${app.applicationId}`;
-        window.open(target, "_blank", "noopener,noreferrer");
+        //
+        // The two are different kinds of trip. Launching another application is
+        // leaving for somewhere else, so it is a plain new tab with no way back
+        // and no `opener`. Choosing a plan on Connect is a task, so it is a
+        // hand-off that ends back here.
+        if (app.subscribed && app.launchUrl) {
+            window.open(app.launchUrl, "_blank", "noopener,noreferrer");
+            return;
+        }
+        openConnect(`/apps/${encodeURIComponent(app.applicationId)}`);
     };
     const showSearch = apps.length > SEARCH_THRESHOLD;
     const isEmpty = !isLoading && !error && mine.length === 0 && explore.length === 0;

package/dist/esm/client/components/ask-ai-errors.js

@@ -0,0 +1,102 @@
+import { ConnectError } from "../../errors.js";
+/**
+ * What Ask AI shows when something fails - a sentence for a person, never the
+ * error itself.
+ *
+ * The raw text is somebody else's diagnostic: `TypeError: Failed to fetch`
+ * from the browser, `Connect bridge returned 502` from the provider, a
+ * validation message naming a request field. None of it tells the person what
+ * happened or what to do, and the last one tells them something about the
+ * API they should not need to know. The real error is still on the console of
+ * whoever is debugging; this module decides only what is on screen.
+ */
+export const ASK_AI_GENERIC_FAILURE = "Something went wrong. Please try again.";
+export const TOOL_GENERIC_FAILURE = "That step couldn't be completed. Try again in a moment.";
+/** Longest partner-written failure shown inline - a sentence or two, not a dump. */
+const MAX_TOOL_FAILURE_CHARS = 280;
+/**
+ * A failure Connect reported inside the stream, after it had opened.
+ *
+ * Kept apart from a transport failure because its text was written for the
+ * person by Connect's own stream error handler, so it may be shown as it is.
+ */
+export class AskAiStreamError extends Error {
+    name = "AskAiStreamError";
+}
+/** The SDK default and this panel's old fallback - both say nothing. */
+const UNINFORMATIVE = new Set(["", "An error occurred.", "Ask AI failed"]);
+/** The browser's own words for "no response arrived", across engines. */
+function isNetworkFailure(cause) {
+    if (!(cause instanceof Error))
+        return false;
+    return (cause.name === "TypeError" &&
+        /failed to fetch|fetch failed|load failed|networkerror|network error|network connection was lost/i.test(cause.message));
+}
+export function describeAskAiFailure(cause) {
+    if (cause instanceof AskAiStreamError) {
+        return UNINFORMATIVE.has(cause.message.trim()) ? ASK_AI_GENERIC_FAILURE : cause.message;
+    }
+    if (cause instanceof ConnectError) {
+        if (cause.status === 401 || cause.isSessionExpired)
+            return "Your session has ended. Sign in again to keep asking.";
+        if (cause.status === 403)
+            return "You don't have access to Ask AI in this workspace. Ask an admin if you think you should.";
+        if (cause.status === 429)
+            return "That's a lot of questions at once. Wait a moment, then try again.";
+        // The one refusal Connect words for a person: Ask AI is switched off for
+        // this workspace, and retrying will not change that.
+        if (cause.status === 503 && cause.code === "unavailable" && cause.message)
+            return cause.message;
+        if (cause.status === 0 || cause.status >= 500)
+            return "The assistant is having trouble right now. Try again in a moment.";
+        return ASK_AI_GENERIC_FAILURE;
+    }
+    if (isNetworkFailure(cause))
+        return "Couldn't reach the assistant. Check your connection, then try again.";
+    return ASK_AI_GENERIC_FAILURE;
+}
+/**
+ * Whether trying the same question again could help.
+ *
+ * Off for the failures a retry cannot fix - signed out, no access, Ask AI
+ * switched off - so the panel does not offer a button that will fail the same
+ * way every time.
+ */
+export function isRetryableAskAiFailure(cause) {
+    if (cause instanceof ConnectError) {
+        return !(cause.status === 401 || cause.status === 403 || cause.isSessionExpired || (cause.status === 503 && cause.code === "unavailable"));
+    }
+    return true;
+}
+function truncate(text) {
+    const trimmed = text.trim();
+    return trimmed.length > MAX_TOOL_FAILURE_CHARS ? `${trimmed.slice(0, MAX_TOOL_FAILURE_CHARS - 1)}…` : trimmed;
+}
+/**
+ * The failure a tool's *result* reports, or `null` when it succeeded.
+ *
+ * An application's tool answers `{ isError: true, ... }` rather than throwing,
+ * which is MCP's distinction between "the tool refused" and "the call broke".
+ * Connect puts its own sentence in `error.message` when it could not reach
+ * the application at all; otherwise the application's first text block is its
+ * own refusal ("You don't have permission to ..."), written for its own user.
+ */
+export function toolFailureFromOutput(output) {
+    if (typeof output !== "object" || output === null)
+        return null;
+    const result = output;
+    if (result.isError !== true)
+        return null;
+    if (typeof result.error?.message === "string" && result.error.message.trim())
+        return truncate(result.error.message);
+    if (Array.isArray(result.content)) {
+        for (const part of result.content) {
+            if (part && typeof part === "object" && part.type === "text") {
+                const text = part.text;
+                if (typeof text === "string" && text.trim())
+                    return truncate(text);
+            }
+        }
+    }
+    return TOOL_GENERIC_FAILURE;
+}

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

@@ -1,3 +1,4 @@
+import { TOOL_GENERIC_FAILURE, toolFailureFromOutput } from "./ask-ai-errors.js";
 /**
  * Index of the final text block, or `-1`. A reverse loop rather than
  * `findLastIndex`, which is ES2023 - this package targets ES2022 so its
@@ -73,6 +74,7 @@ export function turnsFromStored(turns) {
                         id: typeof part.toolCallId === "string" ? part.toolCallId : `${turn.id}-${blocks.length}`,
                         name: part.type.slice("tool-".length),
                         input: part.input,
+                        ...storedFailure(part),
                     },
                 ];
             }
@@ -80,3 +82,13 @@ export function turnsFromStored(turns) {
         return { id: turn.id, role: turn.role, blocks, reasoning };
     });
 }
+/**
+ * A stored step's failure, worded exactly as it was live. A thrown error is
+ * stored with its raw `errorText`, which is never shown - only the fact.
+ */
+function storedFailure(part) {
+    if (part.state === "output-error")
+        return { failure: TOOL_GENERIC_FAILURE };
+    const failure = toolFailureFromOutput(part.output);
+    return failure ? { failure } : {};
+}

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

@@ -2,7 +2,7 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { Suspense, lazy, useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { Button, Input, Label, TextField } from "@heroui/react";
-import { Brain, ChevronDown, History, Plus, Send, Sparkles, Square, X } from "lucide-react";
+import { Brain, ChevronDown, History, Plus, RotateCcw, Send, Sparkles, Square, TriangleAlert, X } from "lucide-react";
 import { useConnect } from "../provider.js";
 /**
  * The markdown renderer, fetched the first time there is markdown to render.
@@ -32,6 +32,7 @@ import { matchConnectScreen } from "./ai-screens.js";
 import { AiActions, AiChart, AiDetails, AiMetrics, AiSources, AiSteps, AiTable, AiTimeline } from "./ai-widgets.js";
 import { AskAiHistory } from "./ask-ai-history.js";
 import { appendText, lastTextBlockIndex, turnsFromStored, } from "./ask-ai-turns.js";
+import { AskAiStreamError, TOOL_GENERIC_FAILURE, describeAskAiFailure, isRetryableAskAiFailure, toolFailureFromOutput, } from "./ask-ai-errors.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.
@@ -115,6 +116,16 @@ function renderTool(name, input, renderMarkdown, screens, renderLink) {
             return null;
     }
 }
+/**
+ * A step that failed, drawn where its result would have been.
+ *
+ * Small and inline rather than a banner: the turn itself has not failed - the
+ * model goes on to say what happened - and one unreachable application should
+ * read as one missing piece of an answer, not as the panel breaking.
+ */
+function ToolFailure({ message }) {
+    return (_jsxs("div", { className: "my-2 flex items-start gap-2 rounded-md border border-warning/30 bg-warning/5 px-2.5 py-2 text-xs text-foreground", children: [_jsx(TriangleAlert, { className: "mt-px size-3.5 shrink-0 text-warning", "aria-hidden": true }), _jsx("p", { children: message })] }));
+}
 /** Placeholder while a tool's arguments are still arriving, sized like the real thing. */
 function ToolSkeleton() {
     return (_jsx("div", { className: "my-3 flex h-24 animate-pulse items-center justify-center rounded-lg border border-border bg-surface-secondary", role: "status", "aria-label": "Preparing result", children: _jsx(Sparkles, { className: "size-4 text-accent/60", "aria-hidden": true }) }));
@@ -139,7 +150,7 @@ function ToolSkeleton() {
 async function readStream(response, onChunk) {
     const body = response.body;
     if (!body)
-        throw new Error("Ask AI returned no stream");
+        throw new AskAiStreamError("");
     const reader = body.pipeThrough(new TextDecoderStream()).getReader();
     let buffer = "";
     for (;;) {
@@ -185,8 +196,23 @@ async function readStream(response, onChunk) {
                     if (chunk.toolCallId)
                         onChunk({ toolInput: { id: chunk.toolCallId, input: chunk.input } });
                     break;
+                case "tool-output-available": {
+                    // A tool that answered `isError` - an application that could not be
+                    // reached, or one that refused. Successful output is not drawn: the
+                    // model's prose is the reading of it.
+                    const failure = toolFailureFromOutput(chunk.output);
+                    if (chunk.toolCallId && failure)
+                        onChunk({ toolFailure: { id: chunk.toolCallId, message: failure } });
+                    break;
+                }
+                case "tool-output-error":
+                    // `errorText` here is a thrown error's raw message - the fact of the
+                    // failure is shown, its wording never is.
+                    if (chunk.toolCallId)
+                        onChunk({ toolFailure: { id: chunk.toolCallId, message: TOOL_GENERIC_FAILURE } });
+                    break;
                 case "error":
-                    throw new Error(chunk.errorText || "Ask AI failed");
+                    throw new AskAiStreamError(chunk.errorText ?? "");
             }
         }
     }
@@ -238,6 +264,12 @@ export function ConnectAskAi({ title = "Ask AI", assistantName = "Assistant", pl
     const [turns, setTurns] = useState([]);
     const [input, setInput] = useState("");
     const [isBusy, setIsBusy] = useState(false);
+    /**
+     * The last request's failure, worded for a person - and the question to ask
+     * again, when asking again could help. `retry` is `null` for a failure no
+     * retry fixes (signed out, no access, Ask AI switched off), so the panel
+     * never offers a button that fails the same way every time.
+     */
     const [error, setError] = useState(null);
     const [showHistory, setShowHistory] = useState(false);
     /**
@@ -296,7 +328,13 @@ export function ConnectAskAi({ title = "Ask AI", assistantName = "Assistant", pl
         abortRef.current = null;
         setIsBusy(false);
     }, []);
-    const send = useCallback(async (text) => {
+    const send = useCallback(
+    /**
+     * `prior` is the conversation the question is asked after - the current
+     * one, except on a retry, which drops the failed exchange first so the
+     * question is not shown (or sent) twice.
+     */
+    async (text, prior = turns) => {
         const controller = new AbortController();
         abortRef.current = controller;
         setError(null);
@@ -312,7 +350,7 @@ export function ConnectAskAi({ title = "Ask AI", assistantName = "Assistant", pl
         // strings. Built from the turns *plus* this one rather than from state,
         // which has not been committed yet at this point. Only text is sent back:
         // a widget is a rendering of something the model already said.
-        const history = [...turns, userTurn].map((turn) => ({
+        const history = [...prior, userTurn].map((turn) => ({
             id: turn.id,
             role: turn.role,
             parts: [
@@ -325,7 +363,7 @@ export function ConnectAskAi({ title = "Ask AI", assistantName = "Assistant", pl
                 },
             ],
         }));
-        setTurns((current) => [...current, userTurn]);
+        setTurns([...prior, userTurn]);
         const patchAnswer = (patch) => setTurns((current) => current.map((turn) => (turn.id === answerId ? patch(turn) : turn)));
         try {
             // Relative to the provider's own `basePath` - `streamResource` prefixes
@@ -359,6 +397,13 @@ export function ConnectAskAi({ title = "Ask AI", assistantName = "Assistant", pl
                     const { id, name } = chunk.toolStart;
                     patchAnswer((turn) => ({ ...turn, blocks: [...turn.blocks, { kind: "tool", id, name, input: null }] }));
                 }
+                if (chunk.toolFailure) {
+                    const { id, message } = chunk.toolFailure;
+                    patchAnswer((turn) => ({
+                        ...turn,
+                        blocks: turn.blocks.map((block) => block.kind === "tool" && block.id === id ? { ...block, failure: message } : block),
+                    }));
+                }
                 if (chunk.toolInput) {
                     const { id, input: toolInput } = chunk.toolInput;
                     patchAnswer((turn) => ({
@@ -372,7 +417,10 @@ export function ConnectAskAi({ title = "Ask AI", assistantName = "Assistant", pl
             // Pressing Stop aborts the fetch, which lands here - a decision, not a
             // failure, and nothing to report.
             if (!controller.signal.aborted) {
-                setError(cause instanceof Error ? cause.message : "Ask AI failed");
+                // The real error is for whoever is debugging; the panel shows a
+                // sentence. See `describeAskAiFailure`.
+                console.error("[connect] Ask AI request failed:", cause);
+                setError({ message: describeAskAiFailure(cause), retry: isRetryableAskAiFailure(cause) ? text : null });
             }
         }
         finally {
@@ -414,6 +462,25 @@ export function ConnectAskAi({ title = "Ask AI", assistantName = "Assistant", pl
         setConversationId(id);
         setShowHistory(false);
     }, []);
+    /**
+     * Asks the failed question again, in place of the failed exchange.
+     *
+     * Everything from the last question onwards is dropped - the question and
+     * whatever half-answer arrived before the failure - so the retry reads as
+     * the same question answered, not as the person asking twice.
+     */
+    const retry = useCallback(() => {
+        if (!error?.retry || isBusy)
+            return;
+        let cut = turns.length;
+        for (let index = turns.length - 1; index >= 0; index--) {
+            if (turns[index]?.role === "user") {
+                cut = index;
+                break;
+            }
+        }
+        void send(error.retry, turns.slice(0, cut));
+    }, [error, isBusy, turns, send]);
     const lastTurn = turns.at(-1);
     const isAnswering = isBusy && lastTurn?.role === "assistant";
     const rendered = useMemo(() => turns.map((turn) => {
@@ -423,7 +490,7 @@ export function ConnectAskAi({ title = "Ask AI", assistantName = "Assistant", pl
                 // The user's own turn is shown as they typed it - running a
                 // question that happens to start with `#` through the markdown
                 // renderer would turn it into a heading.
-                _jsx("div", { children: turn.role === "user" ? (_jsx("p", { className: "whitespace-pre-wrap", children: block.text })) : (renderMarkdown(block.text, isLive && index === lastTextIndex)) }, index)) : block.input === null ? (_jsx(ToolSkeleton, {}, block.id)) : (_jsx("div", { children: renderTool(block.name, block.input, renderMarkdown, screens, renderLink) }, block.id))), isLive && lastTextIndex === -1 && turn.blocks.length === 0 && _jsx(ThinkingShimmer, {})] }, turn.id));
+                _jsx("div", { children: turn.role === "user" ? (_jsx("p", { className: "whitespace-pre-wrap", children: block.text })) : (renderMarkdown(block.text, isLive && index === lastTextIndex)) }, index)) : block.failure ? (_jsx(ToolFailure, { message: block.failure }, block.id)) : block.input === null ? (_jsx(ToolSkeleton, {}, block.id)) : (_jsx("div", { children: renderTool(block.name, block.input, renderMarkdown, screens, renderLink) }, block.id))), isLive && lastTextIndex === -1 && turn.blocks.length === 0 && _jsx(ThinkingShimmer, {})] }, turn.id));
     }), [turns, isAnswering, lastTurn?.id, assistantName, renderMarkdown]);
     // Signed out there is no workspace to ground an answer in, and the bridge
     // would answer 401 - so there is nothing to offer, not even a button.
@@ -444,7 +511,7 @@ export function ConnectAskAi({ title = "Ask AI", assistantName = "Assistant", pl
                                     // 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: _jsx(Plus, { className: "size-4" }) }), _jsx(Button, { isIconOnly: true, size: "sm", variant: "tertiary", "aria-label": showHistory ? "Hide past conversations" : "Past conversations", "aria-pressed": showHistory, onPress: () => setShowHistory((open) => !open), children: _jsx(History, { className: "size-4" }) }), _jsx(Button, { isIconOnly: true, size: "sm", variant: "tertiary", "aria-label": "Close", onPress: () => setIsOpen(false), children: _jsx(X, { className: "size-4" }) })] }), showHistory ? (_jsx("div", { className: "min-h-0 flex-1 overflow-y-auto", children: _jsx(AskAiHistory, { refreshKey: writeCount, activeConversationId: conversationId, onOpenConversation: openConversation }) })) : (_jsxs("div", { className: "flex-1 space-y-3 overflow-y-auto p-4", children: [turns.length === 0 && (_jsxs("div", { className: "space-y-3", children: [_jsx("p", { className: "text-sm text-muted", children: hint }), currentScreen?.suggestions?.length ? (_jsx("div", { className: "flex flex-wrap gap-1.5", children: currentScreen.suggestions.map((suggestion) => (_jsx(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" && (_jsxs("div", { className: "rounded-md border border-border bg-accent/5 p-2.5 text-sm", children: [_jsx("p", { className: "mb-1 text-[11px] font-semibold tracking-wide text-muted uppercase", children: assistantName }), _jsx(ThinkingShimmer, {})] })), error && _jsx("p", { className: "text-xs text-danger", children: error }), _jsx("div", { ref: bottomRef })] })), _jsxs("form", { onSubmit: handleSubmit, className: "flex gap-2 border-t border-border p-3", children: [_jsxs(TextField, { variant: "secondary", className: "flex-1", children: [_jsx(Label, { className: "sr-only", children: placeholder }), _jsx(Input, { placeholder: placeholder, value: input, onChange: (event) => setInput(event.currentTarget.value), disabled: isBusy })] }), isBusy ? (_jsx(Button, { type: "button", isIconOnly: true, variant: "secondary", "aria-label": "Stop generating", onPress: stop, children: _jsx(Square, { className: "size-3.5" }) })) : (_jsx(Button, { type: "submit", isIconOnly: true, variant: "primary", "aria-label": "Send", isDisabled: !input.trim(), children: _jsx(Send, { className: "size-3.5" }) }))] })] }) })] }));
+                                    isDisabled: turns.length === 0, onPress: startNewConversation, children: _jsx(Plus, { className: "size-4" }) }), _jsx(Button, { isIconOnly: true, size: "sm", variant: "tertiary", "aria-label": showHistory ? "Hide past conversations" : "Past conversations", "aria-pressed": showHistory, onPress: () => setShowHistory((open) => !open), children: _jsx(History, { className: "size-4" }) }), _jsx(Button, { isIconOnly: true, size: "sm", variant: "tertiary", "aria-label": "Close", onPress: () => setIsOpen(false), children: _jsx(X, { className: "size-4" }) })] }), showHistory ? (_jsx("div", { className: "min-h-0 flex-1 overflow-y-auto", children: _jsx(AskAiHistory, { refreshKey: writeCount, activeConversationId: conversationId, onOpenConversation: openConversation }) })) : (_jsxs("div", { className: "flex-1 space-y-3 overflow-y-auto p-4", children: [turns.length === 0 && (_jsxs("div", { className: "space-y-3", children: [_jsx("p", { className: "text-sm text-muted", children: hint }), currentScreen?.suggestions?.length ? (_jsx("div", { className: "flex flex-wrap gap-1.5", children: currentScreen.suggestions.map((suggestion) => (_jsx(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" && (_jsxs("div", { className: "rounded-md border border-border bg-accent/5 p-2.5 text-sm", children: [_jsx("p", { className: "mb-1 text-[11px] font-semibold tracking-wide text-muted uppercase", children: assistantName }), _jsx(ThinkingShimmer, {})] })), error && (_jsxs("div", { role: "alert", className: "flex items-start gap-2 rounded-md border border-danger/30 bg-danger/5 p-2.5 text-xs text-danger", children: [_jsx(TriangleAlert, { className: "mt-px size-3.5 shrink-0", "aria-hidden": true }), _jsx("p", { className: "flex-1", children: error.message }), error.retry && (_jsxs(Button, { size: "sm", variant: "tertiary", className: "h-6 shrink-0 px-2 text-xs", onPress: retry, isDisabled: isBusy, children: [_jsx(RotateCcw, { className: "size-3", "aria-hidden": true }), "Try again"] }))] })), _jsx("div", { ref: bottomRef })] })), _jsxs("form", { onSubmit: handleSubmit, className: "flex gap-2 border-t border-border p-3", children: [_jsxs(TextField, { variant: "secondary", className: "flex-1", children: [_jsx(Label, { className: "sr-only", children: placeholder }), _jsx(Input, { placeholder: placeholder, value: input, onChange: (event) => setInput(event.currentTarget.value), disabled: isBusy })] }), isBusy ? (_jsx(Button, { type: "button", isIconOnly: true, variant: "secondary", "aria-label": "Stop generating", onPress: stop, children: _jsx(Square, { className: "size-3.5" }) })) : (_jsx(Button, { type: "submit", isIconOnly: true, variant: "primary", "aria-label": "Send", isDisabled: !input.trim(), children: _jsx(Send, { className: "size-3.5" }) }))] })] }) })] }));
 }
 /** Hoisted for the same reference-equality reason as `ANIMATED` - Streamdown compares it by identity. */
 const LINK_SAFETY = { enabled: false };

package/dist/esm/client/components/plans.js

@@ -162,6 +162,7 @@ function ConnectCheckoutStatusRow({ checkout, }) {
     return (_jsx(AnimatePresence, { mode: "wait", initial: false, children: checkout.status !== "idle" && (_jsx(m.div, { initial: { opacity: 0, y: 4 }, animate: { opacity: 1, y: 0 }, exit: { opacity: 0, y: -4 }, transition: { duration: 0.18 }, children: _jsx(CheckoutStatusRowContent, { checkout: checkout }) }, checkout.status)) }));
 }
 function CheckoutStatusRowContent({ checkout, }) {
+    const { openConnect } = useConnect();
     if (checkout.status === "waiting") {
         return (_jsxs("div", { className: "flex items-center gap-2 rounded-lg border border-separator px-3 py-2 text-sm text-muted", children: [_jsx(Loader2, { className: "size-4 shrink-0 animate-spin", "aria-hidden": "true" }), _jsx("span", { children: "Finish up in the Connect window. This page updates on its own." })] }));
     }
@@ -172,7 +173,11 @@ function CheckoutStatusRowContent({ checkout, }) {
     // are fixed by going to the same URL - so offer it rather than explaining.
     return (_jsxs("div", { className: "flex flex-wrap items-center justify-between gap-3 rounded-lg border border-separator px-3 py-2 text-sm text-muted", children: [_jsx("span", { children: checkout.status === "blocked"
                     ? "Your browser blocked the Connect window."
-                    : "Nothing changed - the Connect window closed before it was finished." }), _jsxs("div", { className: "flex items-center gap-2", children: [checkout.url && (_jsxs(Button, { variant: "secondary", onPress: () => window.open(checkout.url, "_blank", "noopener,noreferrer"), children: ["Open Connect", _jsx(ExternalLink, { className: "size-3.5" })] })), _jsx(Button, { variant: "tertiary", onPress: checkout.reset, children: "Dismiss" })] })] }));
+                    : "Nothing changed - the Connect window closed before it was finished." }), _jsxs("div", { className: "flex items-center gap-2", children: [checkout.url && (_jsxs(Button, { variant: "secondary", 
+                        // Not watched by the checkout poll - that run has ended - but a
+                        // hand-off all the same: Connect reports back when it is done, and
+                        // the provider re-reads every resource on this page.
+                        onPress: () => openConnect(checkout.url), children: ["Open Connect", _jsx(ExternalLink, { className: "size-3.5" })] })), _jsx(Button, { variant: "tertiary", onPress: checkout.reset, children: "Dismiss" })] })] }));
 }
 /**
  * Cancellation, kept out of the plan grid and stated plainly.
@@ -192,9 +197,10 @@ function CheckoutStatusRowContent({ checkout, }) {
  * version.
  */
 function ConnectUnsubscribeRow({ subscription, appUrl, checkout, }) {
+    const { openConnect } = useConnect();
     const endsOn = subscription.currentBillingCycle?.endDate;
     if (subscription.cancelAtPeriodEnd) {
-        return (_jsxs("div", { className: "flex flex-wrap items-center justify-between gap-3 border-t border-separator pt-4", children: [_jsxs("p", { className: "text-sm text-muted", children: ["Cancels", endsOn ? ` on ${new Date(endsOn).toLocaleDateString()}` : " at the end of this cycle", ". You keep access until then."] }), _jsxs(Button, { variant: "tertiary", onPress: () => window.open(`${appUrl}/billing/subscriptions/${subscription.id}`, "_blank", "noopener,noreferrer"), children: ["View on Connect", _jsx(ExternalLink, { className: "size-3.5" })] })] }));
+        return (_jsxs("div", { className: "flex flex-wrap items-center justify-between gap-3 border-t border-separator pt-4", children: [_jsxs("p", { className: "text-sm text-muted", children: ["Cancels", endsOn ? ` on ${new Date(endsOn).toLocaleDateString()}` : " at the end of this cycle", ". You keep access until then."] }), _jsxs(Button, { variant: "tertiary", onPress: () => openConnect(`/billing/subscriptions/${encodeURIComponent(subscription.id)}`), children: ["View on Connect", _jsx(ExternalLink, { className: "size-3.5" })] })] }));
     }
     return (_jsxs("div", { className: "flex flex-wrap items-center justify-between gap-3 border-t border-separator pt-4", children: [_jsx("p", { className: "text-sm text-muted", children: "Cancel any time. Access continues to the end of the paid cycle." }), _jsxs(Button, { variant: "tertiary", className: "text-danger", isDisabled: checkout.status === "waiting", onPress: () => checkout.start({
                     url: buildCancelUrl({ appUrl, subscriptionId: subscription.id }),

package/dist/esm/client/components/readiness.js

@@ -68,9 +68,10 @@ export function ConnectReadinessBanner({ includeAdvisory = false, hideWhenReady
     return (_jsx(MotionProvider, { children: _jsx(m.div, { className: cn("flex flex-col gap-2", className), role: "status", initial: { opacity: 0, y: -6 }, animate: { opacity: 1, y: 0 }, transition: ENTER, children: blockers.map((blocker) => (_jsx(BlockerRow, { blocker: blocker }, `${blocker.code}-${blocker.message}`))) }) }));
 }
 function BlockerRow({ blocker }) {
+    const { openConnect } = useConnect();
     const inProgress = IN_PROGRESS_CODES.has(blocker.code);
     const isBlocking = blocker.severity === "blocking";
-    return (_jsxs("div", { className: `flex flex-wrap items-center justify-between gap-3 rounded-lg px-3 py-2 text-sm ${inProgress || !isBlocking ? "bg-surface text-muted" : "bg-danger-soft text-danger"}`, children: [_jsxs("span", { className: "flex items-center gap-2", children: [inProgress || !isBlocking ? (_jsx(Info, { className: "size-4 shrink-0", "aria-hidden": "true" })) : (_jsx(AlertTriangle, { className: "size-4 shrink-0", "aria-hidden": "true" })), blocker.message] }), blocker.resolveUrl && !inProgress && (_jsxs(Button, { variant: "secondary", onPress: () => window.open(blocker.resolveUrl, "_blank", "noopener,noreferrer"), children: [actionLabel(blocker), _jsx(ExternalLink, { className: "size-3.5" })] }))] }));
+    return (_jsxs("div", { className: `flex flex-wrap items-center justify-between gap-3 rounded-lg px-3 py-2 text-sm ${inProgress || !isBlocking ? "bg-surface text-muted" : "bg-danger-soft text-danger"}`, children: [_jsxs("span", { className: "flex items-center gap-2", children: [inProgress || !isBlocking ? (_jsx(Info, { className: "size-4 shrink-0", "aria-hidden": "true" })) : (_jsx(AlertTriangle, { className: "size-4 shrink-0", "aria-hidden": "true" })), blocker.message] }), blocker.resolveUrl && !inProgress && (_jsxs(Button, { variant: "secondary", onPress: () => openConnect(blocker.resolveUrl), children: [actionLabel(blocker), _jsx(ExternalLink, { className: "size-3.5" })] }))] }));
 }
 function ReadyRow({ className }) {
     return (_jsx("p", { className: cn("text-sm text-muted", className), children: "This workspace is cleared to use every part of the application." }));

package/dist/esm/client/components/subscription.js

@@ -72,13 +72,13 @@ export function ConnectNoSubscriptionCard({ plansHref = DEFAULT_PLANS_HREF, titl
  * impure and re-renders wrong.
  */
 export function ConnectSubscriptionCard({ plansHref, className }) {
-    const { appUrl } = useConnect();
+    const { openConnect } = useConnect();
     const { isLoading, detail, plan, state } = useSubscriptionState();
     if (isLoading)
         return _jsx(Skeleton, { className: cn("h-48 rounded-xl", className) });
     if (!detail || !plan)
         return _jsx(ConnectNoSubscriptionCard, { plansHref: plansHref, className: className });
-    return (_jsx(MotionProvider, { children: _jsx(m.div, { initial: { opacity: 0 }, animate: { opacity: 1 }, transition: { duration: 0.2 }, children: _jsxs(Card, { className: className, children: [_jsxs(Card.Header, { children: [_jsxs("div", { className: "flex items-start justify-between gap-2", children: [_jsx(Card.Title, { children: plan.name }), _jsx(SubscriptionChip, { state: state })] }), _jsxs(Card.Description, { children: [formatPrice(plan.price), " + ", plan.gstRate, "% GST per", " ", intervalLabel(plan.billingInterval).per] })] }), _jsxs(Card.Content, { className: "flex flex-col gap-2 text-sm", children: [_jsx(NextEvent, { detail: detail, state: state }), _jsx(ConnectSeatUsage, { plan: plan, detail: detail })] }), _jsxs(Card.Footer, { className: "flex flex-wrap gap-2", children: [_jsxs(Button, { variant: "secondary", onPress: () => window.open(`${appUrl}/billing/subscriptions/${detail.id}`, "_blank", "noopener,noreferrer"), children: ["Manage on Connect", _jsx(ExternalLink, { className: "size-3.5" })] }), _jsx(ConnectLinkButton, { href: plansHref ?? DEFAULT_PLANS_HREF, variant: "tertiary", children: "Change plan" })] })] }) }) }));
+    return (_jsx(MotionProvider, { children: _jsx(m.div, { initial: { opacity: 0 }, animate: { opacity: 1 }, transition: { duration: 0.2 }, children: _jsxs(Card, { className: className, children: [_jsxs(Card.Header, { children: [_jsxs("div", { className: "flex items-start justify-between gap-2", children: [_jsx(Card.Title, { children: plan.name }), _jsx(SubscriptionChip, { state: state })] }), _jsxs(Card.Description, { children: [formatPrice(plan.price), " + ", plan.gstRate, "% GST per", " ", intervalLabel(plan.billingInterval).per] })] }), _jsxs(Card.Content, { className: "flex flex-col gap-2 text-sm", children: [_jsx(NextEvent, { detail: detail, state: state }), _jsx(ConnectSeatUsage, { plan: plan, detail: detail })] }), _jsxs(Card.Footer, { className: "flex flex-wrap gap-2", children: [_jsxs(Button, { variant: "secondary", onPress: () => openConnect(`/billing/subscriptions/${encodeURIComponent(detail.id)}`), children: ["Manage on Connect", _jsx(ExternalLink, { className: "size-3.5" })] }), _jsx(ConnectLinkButton, { href: plansHref ?? DEFAULT_PLANS_HREF, variant: "tertiary", children: "Change plan" })] })] }) }) }));
 }
 function SubscriptionChip({ state }) {
     switch (state) {
@@ -149,11 +149,11 @@ export function ConnectSeatUsage({ plan, detail, className, }) {
  * actually cares about anyway.
  */
 export function ConnectTrialBanner({ plansHref, className }) {
-    const { appUrl } = useConnect();
+    const { openConnect } = useConnect();
     const { detail, state } = useSubscriptionState();
     if (state !== "trialing" || !detail)
         return null;
-    return (_jsxs("div", { className: cn("flex flex-wrap items-center justify-between gap-3 rounded-lg bg-accent-soft px-3 py-2 text-sm text-accent", className), children: [_jsxs("span", { className: "flex items-center gap-2", children: [_jsx(Clock, { className: "size-4 shrink-0", "aria-hidden": "true" }), "You're on a free trial", detail.nextBillingDate ? `. Your first charge is on ${formatDate(detail.nextBillingDate)}.` : "."] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(ConnectLinkButton, { href: plansHref ?? DEFAULT_PLANS_HREF, variant: "tertiary", children: "Compare plans" }), _jsxs(Button, { variant: "secondary", onPress: () => window.open(`${appUrl}/billing/subscriptions/${detail.id}`, "_blank", "noopener,noreferrer"), children: ["Manage", _jsx(ExternalLink, { className: "size-3.5" })] })] })] }));
+    return (_jsxs("div", { className: cn("flex flex-wrap items-center justify-between gap-3 rounded-lg bg-accent-soft px-3 py-2 text-sm text-accent", className), children: [_jsxs("span", { className: "flex items-center gap-2", children: [_jsx(Clock, { className: "size-4 shrink-0", "aria-hidden": "true" }), "You're on a free trial", detail.nextBillingDate ? `. Your first charge is on ${formatDate(detail.nextBillingDate)}.` : "."] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(ConnectLinkButton, { href: plansHref ?? DEFAULT_PLANS_HREF, variant: "tertiary", children: "Compare plans" }), _jsxs(Button, { variant: "secondary", onPress: () => openConnect(`/billing/subscriptions/${encodeURIComponent(detail.id)}`), children: ["Manage", _jsx(ExternalLink, { className: "size-3.5" })] })] })] }));
 }
 /**
  * Renders `children` for a subscribed workspace, and the "pick a plan" card for