@cosmoops/connect-sdk 0.6.0 → 0.9.0

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

@@ -0,0 +1,334 @@
+"use client";
+"use strict";
+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");
+const ai_widgets_js_1 = require("./ai-widgets.js");
+const PANEL_WIDTH = "w-full lg:w-[400px]";
+/**
+ * `blurIn` over the default `fadeIn`: Gemini arrives in bursts rather than an
+ * even token drip, and a blur masks a batch landing at once where a plain
+ * opacity fade just flickers. Hoisted to module scope because Streamdown
+ * compares `animated` by reference.
+ */
+const ANIMATED = {
+    animation: "blurIn",
+    duration: 220,
+    easing: "ease-out",
+    sep: "word",
+};
+/**
+ * The "working on it" state - a highlight sweeping through the word rather
+ * than a spinner beside it. `connect-ai-shimmer` is defined in the SDK's
+ * `theme.css`, which every application platform already imports.
+ */
+function ThinkingShimmer({ label = "Thinking" }) {
+    return ((0, jsx_runtime_1.jsx)("span", { className: "connect-ai-shimmer text-xs font-medium", role: "status", children: label }));
+}
+/** Open while it streams, collapsed once the answer lands. */
+function ThinkingDisclosure({ text, isStreaming }) {
+    if (!text)
+        return null;
+    return ((0, jsx_runtime_1.jsxs)("details", { className: "group mb-2", open: isStreaming, children: [(0, jsx_runtime_1.jsxs)("summary", { className: "flex cursor-pointer list-none items-center gap-1 text-[11px] font-medium text-muted select-none hover:text-foreground", children: [(0, jsx_runtime_1.jsx)(lucide_react_1.Brain, { className: "size-3" }), isStreaming ? (0, jsx_runtime_1.jsx)(ThinkingShimmer, {}) : "Thinking", (0, jsx_runtime_1.jsx)(lucide_react_1.ChevronDown, { className: "size-3 transition-transform group-open:rotate-180" })] }), (0, jsx_runtime_1.jsx)("div", { className: "mt-1.5 border-s-2 border-border ps-2 text-xs whitespace-pre-wrap text-muted italic", children: text })] }));
+}
+/**
+ * Structural guards, one per widget.
+ *
+ * The published package carries no schema validator, and should not gain one
+ * for this - so each tool input is checked for the fields its renderer would
+ * otherwise crash on. Anything that fails renders nothing: the model's prose
+ * sits around it either way, so a missing widget reads as terse rather than
+ * broken, which is the better failure.
+ */
+const isArray = (value) => Array.isArray(value) && value.length > 0;
+const field = (input, key) => typeof input === "object" && input !== null ? input[key] : undefined;
+function renderTool(name, input, renderMarkdown) {
+    switch (name) {
+        case "showTable":
+            return isArray(field(input, "columns")) && Array.isArray(field(input, "rows")) ? ((0, jsx_runtime_1.jsx)(ai_widgets_js_1.AiTable, { ...input })) : null;
+        case "showChart":
+            return isArray(field(input, "series")) ? (0, jsx_runtime_1.jsx)(ai_widgets_js_1.AiChart, { ...input }) : null;
+        case "showMetrics":
+            return isArray(field(input, "metrics")) ? (0, jsx_runtime_1.jsx)(ai_widgets_js_1.AiMetrics, { ...input }) : null;
+        case "showTimeline":
+            return isArray(field(input, "events")) ? (0, jsx_runtime_1.jsx)(ai_widgets_js_1.AiTimeline, { ...input }) : null;
+        case "showDetails":
+            return isArray(field(input, "fields")) ? (0, jsx_runtime_1.jsx)(ai_widgets_js_1.AiDetails, { ...input }) : null;
+        case "showSteps":
+            return isArray(field(input, "steps")) ? ((0, jsx_runtime_1.jsx)(ai_widgets_js_1.AiSteps, { ...input, renderDetail: renderMarkdown })) : null;
+        case "showSources":
+            return isArray(field(input, "sources")) ? (0, jsx_runtime_1.jsx)(ai_widgets_js_1.AiSources, { ...input }) : null;
+        default:
+            return null;
+    }
+}
+/** Placeholder while a tool's arguments are still arriving, sized like the real thing. */
+function ToolSkeleton() {
+    return ((0, jsx_runtime_1.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: (0, jsx_runtime_1.jsx)(lucide_react_1.Sparkles, { className: "size-4 text-accent/60", "aria-hidden": true }) }));
+}
+/**
+ * One server-sent event stream, folded into the turn being built.
+ *
+ * Hand-rolled rather than pulled from `@ai-sdk/react`, and that is a deliberate
+ * trade: this package ships to partners, and `ai` + `@ai-sdk/react` is a large
+ * dependency to add to every application platform for one panel. The wire format
+ * is small, both ends of it are ours, and the chunk kinds below are all this
+ * panel can render.
+ *
+ * Tool arguments are read from `tool-input-available` - the complete object -
+ * rather than reassembled from `tool-input-delta` fragments. `tool-input-start`
+ * is enough to put a skeleton on screen in the meantime, and partial-JSON
+ * parsing buys nothing a placeholder does not.
+ *
+ * Chunks are newline-delimited `data:` frames; a frame can split across network
+ * reads, so the tail of each read is carried forward rather than parsed.
+ */
+async function readStream(response, onChunk) {
+    const body = response.body;
+    if (!body)
+        throw new Error("Ask AI returned no stream");
+    const reader = body.pipeThrough(new TextDecoderStream()).getReader();
+    let buffer = "";
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        buffer += value;
+        // Everything up to the last newline is whole; whatever follows it is a
+        // partial frame and waits for the next read.
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+            if (!line.startsWith("data:"))
+                continue;
+            const payload = line.slice(5).trim();
+            if (!payload || payload === "[DONE]")
+                continue;
+            let chunk;
+            try {
+                chunk = JSON.parse(payload);
+            }
+            catch {
+                // A frame we cannot parse is a frame we cannot render. Dropping it
+                // keeps the rest of the answer flowing, which is strictly better than
+                // failing the whole turn over one malformed chunk.
+                continue;
+            }
+            switch (chunk.type) {
+                case "text-delta":
+                    if (chunk.delta)
+                        onChunk({ text: chunk.delta });
+                    break;
+                case "reasoning-delta":
+                    if (chunk.delta)
+                        onChunk({ reasoning: chunk.delta });
+                    break;
+                case "tool-input-start":
+                    if (chunk.toolCallId && chunk.toolName) {
+                        onChunk({ toolStart: { id: chunk.toolCallId, name: chunk.toolName } });
+                    }
+                    break;
+                case "tool-input-available":
+                    if (chunk.toolCallId)
+                        onChunk({ toolInput: { id: chunk.toolCallId, input: chunk.input } });
+                    break;
+                case "error":
+                    throw new Error(chunk.errorText || "Ask AI failed");
+            }
+        }
+    }
+}
+/**
+ * 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.
+ *
+ * Answers are not only prose. Connect's model can call a small set of
+ * presentation tools - `showTable`, `showChart`, `showMetrics`, `showTimeline`,
+ * `showDetails`, `showSteps`, `showSources` - and this panel renders each one
+ * natively: a sortable table with a CSV download, a chart, a row of metric
+ * tiles. Values arrive raw with a format tag, so they are formatted here rather
+ * than by the model, which is what lets a column sort numerically.
+ *
+ * Nothing here holds a credential: it POSTs to `${basePath}/ai/chat` on your
+ * own origin, and `createConnectHandler` is what reaches Connect. The workspace
+ * is resolved from the caller's session there, never sent from the browser - so
+ * a user can only ever ask about the workspace they are signed into.
+ *
+ * ```tsx
+ * <AppShell name="Dispatch" nav={nav}>
+ *   {children}
+ * </AppShell>
+ * ```
+ *
+ * `AppShell` mounts it by default. Mount it directly only when you are not
+ * using the shell: it renders a fixed corner trigger plus a panel that is an
+ * *in-flow flex sibling* at `lg` and up, so opening it pushes your content
+ * aside rather than covering it. That requires it to be the last child of a
+ * `flex` row owning the viewport height - which is exactly what `AppShell` is.
+ * Below `lg` it is a full-screen sheet with a backdrop instead; there is no
+ * room to push anything on a phone.
+ *
+ * **Host setup:** markdown rendering needs `streamdown` installed, one Tailwind
+ * `@source "…/node_modules/streamdown/dist/*.js"` line so its utility classes
+ * are generated, and `import "streamdown/styles.css"` for the streaming
+ * animation. The colour tokens Streamdown expects are already mapped in this
+ * SDK's `theme.css`.
+ *
+ * Answers require the workspace's Context Index to be turned on (a workspace
+ * admin toggle in Connect) and your API key to carry the `ai:chat` scope.
+ * Neither is something the browser can discover, so both surface as a message
+ * in the panel rather than as a hidden button.
+ */
+function ConnectAskAi({ title = "Ask AI", assistantName = "Assistant", placeholder = "Ask a question...", hint = "Ask a question about your workspace - answers are grounded in what your team has indexed.", defaultOpen = false, markdownPlugins, }) {
+    const { session, isLoading, streamResource } = (0, provider_js_1.useConnect)();
+    const [isOpen, setIsOpen] = (0, react_1.useState)(defaultOpen);
+    const [turns, setTurns] = (0, react_1.useState)([]);
+    const [input, setInput] = (0, react_1.useState)("");
+    const [isBusy, setIsBusy] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(null);
+    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
+    // enough - and unlike `crypto.randomUUID()` it cannot differ between the
+    // server's render and the browser's.
+    const nextId = (0, react_1.useRef)(0);
+    (0, react_1.useEffect)(() => {
+        bottomRef.current?.scrollIntoView({ behavior: "smooth", block: "end" });
+    }, [turns]);
+    // A conversation left mid-stream should stop costing tokens the moment the
+    // panel goes away.
+    (0, react_1.useEffect)(() => () => abortRef.current?.abort(), []);
+    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 stop = (0, react_1.useCallback)(() => {
+        abortRef.current?.abort();
+        abortRef.current = null;
+        setIsBusy(false);
+    }, []);
+    const send = (0, react_1.useCallback)(async (text) => {
+        const controller = new AbortController();
+        abortRef.current = controller;
+        setError(null);
+        setIsBusy(true);
+        const userTurn = {
+            id: `u${nextId.current++}`,
+            role: "user",
+            blocks: [{ kind: "text", text }],
+            reasoning: "",
+        };
+        const answerId = `a${nextId.current++}`;
+        // The wire format Connect reads - part-based `UIMessage`s, not flat
+        // 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) => ({
+            id: turn.id,
+            role: turn.role,
+            parts: [
+                {
+                    type: "text",
+                    text: turn.blocks
+                        .filter((block) => block.kind === "text")
+                        .map((block) => block.text)
+                        .join(""),
+                },
+            ],
+        }));
+        setTurns((current) => [...current, 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
+            // it, the same way every other bridge call is addressed.
+            const response = await streamResource("/ai/chat", { messages: history }, { 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
+            // empty bubble that never fills.
+            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) }));
+                }
+                if (chunk.reasoning) {
+                    patchAnswer((turn) => ({ ...turn, reasoning: turn.reasoning + chunk.reasoning }));
+                }
+                if (chunk.toolStart) {
+                    const { id, name } = chunk.toolStart;
+                    patchAnswer((turn) => ({ ...turn, blocks: [...turn.blocks, { kind: "tool", id, name, input: null }] }));
+                }
+                if (chunk.toolInput) {
+                    const { id, input: toolInput } = chunk.toolInput;
+                    patchAnswer((turn) => ({
+                        ...turn,
+                        blocks: turn.blocks.map((block) => block.kind === "tool" && block.id === id ? { ...block, input: toolInput } : block),
+                    }));
+                }
+            });
+        }
+        catch (cause) {
+            // 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");
+            }
+        }
+        finally {
+            if (abortRef.current === controller)
+                abortRef.current = null;
+            setIsBusy(false);
+        }
+    }, [streamResource, turns]);
+    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);
+        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
+                // renderer would turn it into a heading.
+                (0, jsx_runtime_1.jsx)("div", { children: turn.role === "user" ? ((0, jsx_runtime_1.jsx)("p", { className: "whitespace-pre-wrap", children: block.text })) : (renderMarkdown(block.text, isLive && index === lastTextIndex)) }, index)) : block.input === null ? ((0, jsx_runtime_1.jsx)(ToolSkeleton, {}, block.id)) : ((0, jsx_runtime_1.jsx)("div", { children: renderTool(block.name, block.input, renderMarkdown) }, block.id))), isLive && lastTextIndex === -1 && turn.blocks.length === 0 && (0, jsx_runtime_1.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.
+    if (isLoading || !session?.user)
+        return null;
+    const handleSubmit = (event) => {
+        event.preventDefault();
+        const text = input.trim();
+        if (!text || isBusy)
+            return;
+        setInput("");
+        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 ${PANEL_WIDTH} ${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] ${isOpen ? "" : "lg:w-0 lg:overflow-hidden lg:border-s-0"}`, 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.jsx)("p", { className: "text-sm text-muted", children: hint }), 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 };

package/dist/cjs/client/components/feature-gate.js

@@ -42,7 +42,7 @@ function useConnectFeature(feature) {
  *
  * Like every gate in this package, it is a **UX gate, not a security
  * boundary**: the entitlement is read through your own origin and the browser
- * can ignore it. Check `client.entitlements.hasFeature(orgId, feature)` on the
+ * can ignore it. Check `client.entitlements.hasFeature(workspaceId, feature)` on the
  * server before doing the thing the feature unlocks.
  *
  * Renders `loading` - not `fallback` - while the answer is unknown, so a paying
@@ -57,5 +57,5 @@ function ConnectFeatureGate({ feature, children, fallback, loading = null, plans
         return (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: children });
     if (fallback !== undefined)
         return (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: fallback });
-    return ((0, jsx_runtime_1.jsx)(subscription_js_1.ConnectNoSubscriptionCard, { plansHref: plansHref, title: title ?? "Not included in your plan", description: description ?? "This part of the service is on a higher plan. Compare plans to see what unlocks it.", className: className }));
+    return ((0, jsx_runtime_1.jsx)(subscription_js_1.ConnectNoSubscriptionCard, { plansHref: plansHref, title: title ?? "Not included in your plan", description: description ?? "This part of the application is on a higher plan. Compare plans to see what unlocks it.", className: className }));
 }

package/dist/cjs/client/components/integrations-modal.js

@@ -45,7 +45,7 @@ function ToolkitTile({ toolkit, isPending, onConnect, onDisconnect }) {
                     (0, jsx_runtime_1.jsx)("img", { src: toolkit.logoUrl, alt: "", className: "size-full object-cover" })) : ((0, jsx_runtime_1.jsx)(lucide_react_1.Puzzle, { className: "size-6 text-muted", "aria-hidden": "true" })), toolkit.status === "failed" && ((0, jsx_runtime_1.jsx)("span", { className: "absolute -right-0.5 -top-0.5 flex size-4 items-center justify-center rounded-full bg-danger text-danger-foreground", children: (0, jsx_runtime_1.jsx)(lucide_react_1.AlertCircle, { className: "size-3", "aria-hidden": "true" }) }))] }), (0, jsx_runtime_1.jsx)("span", { className: "line-clamp-2 text-center text-xs font-medium text-foreground", children: toolkit.name }), (0, jsx_runtime_1.jsx)(react_2.Chip, { size: "sm", variant: "soft", color: STATUS_COLOR[toolkit.status], children: STATUS_LABEL[toolkit.status] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex w-full flex-col gap-1.5 pt-1", children: [CAN_CONNECT.has(toolkit.status) && ((0, jsx_runtime_1.jsx)(react_2.Button, { size: "sm", variant: "secondary", className: "w-full text-xs", isPending: isPending, isDisabled: isPending, onPress: onConnect, children: "Connect" })), toolkit.status === "active" && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(react_2.Button, { size: "sm", variant: "secondary", className: "w-full text-xs", isPending: isPending, isDisabled: isPending, onPress: onConnect, children: "Reconnect" }), (0, jsx_runtime_1.jsxs)(react_2.AlertDialog, { isOpen: confirmingDisconnect, onOpenChange: setConfirmingDisconnect, children: [(0, jsx_runtime_1.jsx)(react_2.Button, { size: "sm", variant: "tertiary", className: "w-full text-xs text-danger", isDisabled: isPending, children: "Disconnect" }), (0, jsx_runtime_1.jsx)(react_2.AlertDialog.Backdrop, { children: (0, jsx_runtime_1.jsx)(react_2.AlertDialog.Container, { children: (0, jsx_runtime_1.jsxs)(react_2.AlertDialog.Dialog, { className: "sm:max-w-100", children: [(0, jsx_runtime_1.jsx)(react_2.AlertDialog.CloseTrigger, {}), (0, jsx_runtime_1.jsxs)(react_2.AlertDialog.Header, { children: [(0, jsx_runtime_1.jsx)(react_2.AlertDialog.Icon, { status: "danger" }), (0, jsx_runtime_1.jsxs)(react_2.AlertDialog.Heading, { children: ["Disconnect ", toolkit.name, "?"] })] }), (0, jsx_runtime_1.jsx)(react_2.AlertDialog.Body, { children: (0, jsx_runtime_1.jsx)("p", { className: "text-sm text-muted", children: "Every member loses this connection immediately - it can be reconnected later." }) }), (0, jsx_runtime_1.jsxs)(react_2.AlertDialog.Footer, { children: [(0, jsx_runtime_1.jsx)(react_2.Button, { slot: "close", variant: "secondary", className: "text-xs", children: "Cancel" }), (0, jsx_runtime_1.jsx)(react_2.Button, { slot: "close", variant: "danger", className: "text-xs", onPress: onDisconnect, children: "Disconnect" })] })] }) }) })] })] })), toolkit.status === "pending" && ((0, jsx_runtime_1.jsx)(react_2.Button, { size: "sm", variant: "tertiary", className: "w-full text-xs text-danger", isDisabled: isPending, onPress: onDisconnect, children: "Cancel" }))] })] }));
 }
 /**
- * A grid of every Composio-hosted toolkit this organization can connect -
+ * A grid of every Composio-hosted toolkit this workspace can connect -
  * Google Calendar, Slack, Twitter/X, whatever a platform admin enabled in
  * Connect's own Console. Each tile carries its own connect/reconnect/
  * disconnect action and its own pending state, independent of every other

package/dist/cjs/client/components/logo.js

@@ -5,10 +5,10 @@ exports.ConnectLogo = ConnectLogo;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const mark_js_1 = require("../mark.js");
 /**
- * The shared platform lockup: a service's own glyph on the CosmoOps badge,
- * `cosmo·ops` beside it, and the service name underneath.
+ * The shared platform lockup: an application's own glyph on the CosmoOps badge,
+ * `cosmo·ops` beside it, and the application name underneath.
  *
- * This is what makes a family of service platforms look like one product. Each
+ * This is what makes a family of application platforms look like one product. Each
  * platform passes only what differs - its `name` and its `icon` - and inherits
  * the mark geometry, the wordmark treatment, the separator, and the accent from
  * one place. Change the lockup here and every platform follows.

package/dist/cjs/client/components/nav.js

@@ -89,7 +89,7 @@ function isNavItemActive(item, activeHref) {
         return false;
     return normalizePath(item.href) === activeHref;
 }
-/** Hrefs declared `gateExempt` - the routes `ConnectAppShell` renders outside its `ConnectAccessGate`. */
+/** Hrefs declared `gateExempt` - the routes `AppShell` renders outside its `ConnectAccessGate`. */
 function gateExemptPaths(nav) {
     return flattenNav(nav)
         .filter((item) => item.gateExempt)

package/dist/cjs/client/components/plan-pricing.js

@@ -5,7 +5,7 @@
  * an upgrade while the card behind it said downgrade would be worse than
  * either label being wrong on its own.
  *
- * Mirrors `packages/data/src/services/catalog.ts` and
+ * Mirrors `packages/data/src/applications/catalog.ts` and
  * `packages/data/src/payments/plan-change.ts`, which are the copies Connect's
  * own UI uses and which decide which use-case actually runs. The duplication
  * is deliberate and load-bearing: this package carries no dependency on

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

@@ -47,7 +47,7 @@ function ConnectPlans({ planIds, hideCoupon = false, className }) {
     /** The plan under review in the confirmation dialog, or `null` when it is closed. */
     const [pending, setPending] = (0, react_2.useState)(null);
     const subscription = entitlements?.subscription ?? null;
-    const serviceId = subscription?.serviceId ?? null;
+    const applicationId = subscription?.applicationId ?? null;
     const allPlans = (0, react_2.useMemo)(() => {
         const plans = catalog?.plans ?? [];
         if (!planIds)
@@ -85,12 +85,12 @@ function ConnectPlans({ planIds, hideCoupon = false, className }) {
      * then would misreport a completed checkout as an abandoned one.
      */
     function startCheckout(plan) {
-        if (!serviceId)
+        if (!applicationId)
             return;
         checkout.start({
             url: (0, use_checkout_js_1.buildCheckoutUrl)({
                 appUrl,
-                serviceId,
+                applicationId,
                 planId: plan.id,
                 subscriptionId: subscription?.subscription?.id ?? null,
                 coupon,
@@ -119,7 +119,7 @@ function ConnectPlans({ planIds, hideCoupon = false, className }) {
                             return null;
                         const action = (0, plan_pricing_js_1.resolveAction)(plan, subscription);
                         // "Current" belongs to the tier, not just the exact price point: an
-                        // org on Growth annual looking at monthly pricing is still on the
+                        // workspace on Growth annual looking at monthly pricing is still on the
                         // Growth tier, and marking only the row it literally subscribes to
                         // would leave its own card unmarked half the time.
                         const isCurrentTier = subscription?.plan != null &&
@@ -137,8 +137,8 @@ function ConnectPlans({ planIds, hideCoupon = false, className }) {
                                                 ? "primary"
                                                 : "secondary", 
                                             // Disabled while a hand-off is in flight, not just on the
-                                            // card that started it: the org has one subscription per
-                                            // service, so a second checkout opened against a different
+                                            // card that started it: the workspace has one subscription per
+                                            // application, so a second checkout opened against a different
                                             // plan would race the first and one of them would be
                                             // rejected on arrival.
                                             isDisabled: isCurrent || checkout.status === "waiting", onPress: () => setPending({ plan, action }), children: [plan_pricing_js_1.ACTION_LABEL[action], !isCurrent && (0, jsx_runtime_1.jsx)(lucide_react_1.ExternalLink, { className: "size-3.5" })] }) })] }) }, tier.planGroup));

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

@@ -33,7 +33,7 @@ function actionLabel(blocker) {
     return ACTION_LABELS[blocker.code] ?? "Resolve on Connect";
 }
 /**
- * Every gate between this workspace and your service, with the way out of each.
+ * Every gate between this workspace and your application, with the way out of each.
  *
  * This is the component that keeps a blocked customer from staring at a broken
  * app. `getReadiness` resolves subscription state, KYC/KYB, a chargeable
@@ -41,7 +41,7 @@ function actionLabel(blocker) {
  * `resolveUrl` into the exact Connect screen that fixes it** - so being blocked
  * comes with somewhere to go rather than a refusal.
  *
- * Render it high on any page your service gates. It draws nothing at all when
+ * Render it high on any page your application gates. It draws nothing at all when
  * the workspace is ready, so it is safe to leave mounted permanently.
  *
  * Two deliberate refusals:
@@ -76,7 +76,7 @@ function BlockerRow({ blocker }) {
     return ((0, jsx_runtime_1.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: [(0, jsx_runtime_1.jsxs)("span", { className: "flex items-center gap-2", children: [inProgress || !isBlocking ? ((0, jsx_runtime_1.jsx)(lucide_react_1.Info, { className: "size-4 shrink-0", "aria-hidden": "true" })) : ((0, jsx_runtime_1.jsx)(lucide_react_1.AlertTriangle, { className: "size-4 shrink-0", "aria-hidden": "true" })), blocker.message] }), blocker.resolveUrl && !inProgress && ((0, jsx_runtime_1.jsxs)(react_1.Button, { variant: "secondary", onPress: () => window.open(blocker.resolveUrl, "_blank", "noopener,noreferrer"), children: [actionLabel(blocker), (0, jsx_runtime_1.jsx)(lucide_react_1.ExternalLink, { className: "size-3.5" })] }))] }));
 }
 function ReadyRow({ className }) {
-    return ((0, jsx_runtime_1.jsx)("p", { className: `text-sm text-muted ${className ?? ""}`, children: "This workspace is cleared to use every part of the service." }));
+    return ((0, jsx_runtime_1.jsx)("p", { className: `text-sm text-muted ${className ?? ""}`, children: "This workspace is cleared to use every part of the application." }));
 }
 /**
  * Renders `children` only once the workspace clears every blocking gate.

package/dist/cjs/client/components/side-nav.js

@@ -39,7 +39,7 @@ function NavRow({ item, isActive, hasActiveChild, collapsed, depth, renderLink,
  * The sidebar's nav column on its own - sections, items, one level of
  * children, and the active highlight.
  *
- * `ConnectAppShell` renders this inside its rail and its mobile drawer, and it
+ * `AppShell` renders this inside its rail and its mobile drawer, and it
  * is exported for a host that wants the shell's navigation without its
  * chrome: the same items, the same active resolution, dropped into a layout
  * you already have.

package/dist/cjs/client/components/subscribe-dialog.js

@@ -37,7 +37,7 @@ const HEADING = {
  * The authoritative price is computed by Connect against the real cart:
  * proration is priced against the actual cycle, a coupon is validated
  * against the plan it is being applied to, trial eligibility depends on
- * whether this organization has ever subscribed to this service before, and
+ * whether this workspace has ever subscribed to this application before, and
  * an accumulated credit is deducted. None of that is knowable from the
  * partner's origin, so this component states the list price and says where
  * the final figure comes from rather than quietly guessing at one.
@@ -50,7 +50,7 @@ function ConnectSubscribeDialog({ plan, action, current, coupon, onClose, onConf
     // member and the one most in need of it: the two prices differ by an order
     // of magnitude, and showing only the new one reads as a price rise.
     const isChange = action === "upgrade" || action === "downgrade" || isIntervalSwitch;
-    return ((0, jsx_runtime_1.jsx)(react_1.Modal.Backdrop, { isOpen: plan !== null, onOpenChange: (open) => !open && onClose(), children: (0, jsx_runtime_1.jsx)(react_1.Modal.Container, { size: "sm", children: (0, jsx_runtime_1.jsxs)(react_1.Modal.Dialog, { children: [(0, jsx_runtime_1.jsx)(react_1.Modal.CloseTrigger, { onPress: onClose }), (0, jsx_runtime_1.jsx)(react_1.Modal.Header, { children: (0, jsx_runtime_1.jsx)(react_1.Modal.Heading, { children: HEADING[action] }) }), plan && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)(react_1.Modal.Body, { className: "flex flex-col gap-4", children: [isChange && currentPlan ? ((0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-3 text-sm", children: [(0, jsx_runtime_1.jsxs)("div", { className: "min-w-0", children: [(0, jsx_runtime_1.jsx)("p", { className: "truncate text-muted", children: currentPlan.name }), (0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-muted", children: [(0, plan_pricing_js_1.formatPrice)(currentPlan.price), "/", currentPlan.billingInterval === "annual" ? "yr" : "mo"] })] }), (0, jsx_runtime_1.jsx)(lucide_react_1.ArrowRight, { className: "size-4 shrink-0 text-muted", "aria-hidden": "true" }), (0, jsx_runtime_1.jsxs)("div", { className: "min-w-0", children: [(0, jsx_runtime_1.jsx)("p", { className: "truncate font-medium text-foreground", children: plan.name }), (0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-muted", children: [(0, plan_pricing_js_1.formatPrice)(plan.price), "/", plan.billingInterval === "annual" ? "yr" : "mo"] })] })] })) : ((0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "font-medium text-foreground", children: plan.name }), plan.description && (0, jsx_runtime_1.jsx)("p", { className: "text-xs text-muted", children: plan.description })] })), (0, jsx_runtime_1.jsxs)("div", { className: "flex flex-col gap-1 border-t border-separator pt-3 text-sm", children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex justify-between text-muted", children: [(0, jsx_runtime_1.jsx)("span", { children: plan.name }), (0, jsx_runtime_1.jsx)("span", { children: (0, plan_pricing_js_1.formatPrice)(plan.price) })] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex justify-between text-muted", children: [(0, jsx_runtime_1.jsxs)("span", { children: ["GST (", plan.gstRate, "%)"] }), (0, jsx_runtime_1.jsx)("span", { children: (0, plan_pricing_js_1.formatPrice)(withGst(plan.price, plan.gstRate) - plan.price) })] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex justify-between border-t border-separator pt-1 font-semibold text-foreground", children: [(0, jsx_runtime_1.jsxs)("span", { children: ["Per ", cadenceOf(plan)] }), (0, jsx_runtime_1.jsx)("span", { children: (0, plan_pricing_js_1.formatPrice)(withGst(plan.price, plan.gstRate)) })] }), plan.billingInterval === "annual" && ((0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-muted", children: ["Works out to ", (0, plan_pricing_js_1.formatPrice)((0, plan_pricing_js_1.monthlyOf)(withGst(plan.price, plan.gstRate), "annual")), " a month, billed yearly."] }))] }), plan.trialDays ? ((0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-accent", children: [plan.trialDays, "-day free trial, if this workspace has not subscribed to this service before."] })) : null, coupon?.trim() ? ((0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-muted", children: ["Coupon ", (0, jsx_runtime_1.jsx)("span", { className: "font-mono text-foreground", children: coupon.trim() }), " is carried over and validated on Connect."] })) : null, (0, jsx_runtime_1.jsxs)("div", { className: "flex gap-2 rounded-lg bg-surface p-3 text-xs text-muted", children: [(0, jsx_runtime_1.jsx)(lucide_react_1.Info, { className: "mt-0.5 size-4 shrink-0", "aria-hidden": "true" }), (0, jsx_runtime_1.jsxs)("div", { className: "flex flex-col gap-1", children: [action === "subscribe" && ((0, jsx_runtime_1.jsx)("p", { children: "Payment is completed on Connect, where your card or UPI mandate is set up and the tax invoice is issued. This page updates by itself once it is done." })), action === "upgrade" && ((0, jsx_runtime_1.jsxs)("p", { children: ["Connect prices the difference for the days left in your current cycle and collects just that amount now. From the next cycle you are billed the ", plan.name, " rate."] })), action === "downgrade" && ((0, jsx_runtime_1.jsx)("p", { children: "You keep what you have paid for. Connect works out the unused part of this cycle and applies it as credit or a refund, depending on how this service is configured." })), isIntervalSwitch && (
+    return ((0, jsx_runtime_1.jsx)(react_1.Modal.Backdrop, { isOpen: plan !== null, onOpenChange: (open) => !open && onClose(), children: (0, jsx_runtime_1.jsx)(react_1.Modal.Container, { size: "sm", children: (0, jsx_runtime_1.jsxs)(react_1.Modal.Dialog, { children: [(0, jsx_runtime_1.jsx)(react_1.Modal.CloseTrigger, { onPress: onClose }), (0, jsx_runtime_1.jsx)(react_1.Modal.Header, { children: (0, jsx_runtime_1.jsx)(react_1.Modal.Heading, { children: HEADING[action] }) }), plan && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)(react_1.Modal.Body, { className: "flex flex-col gap-4", children: [isChange && currentPlan ? ((0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-3 text-sm", children: [(0, jsx_runtime_1.jsxs)("div", { className: "min-w-0", children: [(0, jsx_runtime_1.jsx)("p", { className: "truncate text-muted", children: currentPlan.name }), (0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-muted", children: [(0, plan_pricing_js_1.formatPrice)(currentPlan.price), "/", currentPlan.billingInterval === "annual" ? "yr" : "mo"] })] }), (0, jsx_runtime_1.jsx)(lucide_react_1.ArrowRight, { className: "size-4 shrink-0 text-muted", "aria-hidden": "true" }), (0, jsx_runtime_1.jsxs)("div", { className: "min-w-0", children: [(0, jsx_runtime_1.jsx)("p", { className: "truncate font-medium text-foreground", children: plan.name }), (0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-muted", children: [(0, plan_pricing_js_1.formatPrice)(plan.price), "/", plan.billingInterval === "annual" ? "yr" : "mo"] })] })] })) : ((0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "font-medium text-foreground", children: plan.name }), plan.description && (0, jsx_runtime_1.jsx)("p", { className: "text-xs text-muted", children: plan.description })] })), (0, jsx_runtime_1.jsxs)("div", { className: "flex flex-col gap-1 border-t border-separator pt-3 text-sm", children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex justify-between text-muted", children: [(0, jsx_runtime_1.jsx)("span", { children: plan.name }), (0, jsx_runtime_1.jsx)("span", { children: (0, plan_pricing_js_1.formatPrice)(plan.price) })] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex justify-between text-muted", children: [(0, jsx_runtime_1.jsxs)("span", { children: ["GST (", plan.gstRate, "%)"] }), (0, jsx_runtime_1.jsx)("span", { children: (0, plan_pricing_js_1.formatPrice)(withGst(plan.price, plan.gstRate) - plan.price) })] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex justify-between border-t border-separator pt-1 font-semibold text-foreground", children: [(0, jsx_runtime_1.jsxs)("span", { children: ["Per ", cadenceOf(plan)] }), (0, jsx_runtime_1.jsx)("span", { children: (0, plan_pricing_js_1.formatPrice)(withGst(plan.price, plan.gstRate)) })] }), plan.billingInterval === "annual" && ((0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-muted", children: ["Works out to ", (0, plan_pricing_js_1.formatPrice)((0, plan_pricing_js_1.monthlyOf)(withGst(plan.price, plan.gstRate), "annual")), " a month, billed yearly."] }))] }), plan.trialDays ? ((0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-accent", children: [plan.trialDays, "-day free trial, if this workspace has not subscribed to this application before."] })) : null, coupon?.trim() ? ((0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-muted", children: ["Coupon ", (0, jsx_runtime_1.jsx)("span", { className: "font-mono text-foreground", children: coupon.trim() }), " is carried over and validated on Connect."] })) : null, (0, jsx_runtime_1.jsxs)("div", { className: "flex gap-2 rounded-lg bg-surface p-3 text-xs text-muted", children: [(0, jsx_runtime_1.jsx)(lucide_react_1.Info, { className: "mt-0.5 size-4 shrink-0", "aria-hidden": "true" }), (0, jsx_runtime_1.jsxs)("div", { className: "flex flex-col gap-1", children: [action === "subscribe" && ((0, jsx_runtime_1.jsx)("p", { children: "Payment is completed on Connect, where your card or UPI mandate is set up and the tax invoice is issued. This page updates by itself once it is done." })), action === "upgrade" && ((0, jsx_runtime_1.jsxs)("p", { children: ["Connect prices the difference for the days left in your current cycle and collects just that amount now. From the next cycle you are billed the ", plan.name, " rate."] })), action === "downgrade" && ((0, jsx_runtime_1.jsx)("p", { children: "You keep what you have paid for. Connect works out the unused part of this cycle and applies it as credit or a refund, depending on how this application is configured." })), isIntervalSwitch && (
                                                     // Not a proration. The cycle you are on ends, so this is
                                                     // the one action where the amount collected can exceed a
                                                     // single cycle's list price - or be nothing at all, with

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

@@ -63,7 +63,7 @@ function useSubscriptionState() {
  * Rendered on its own it is just a card; `ConnectSubscriptionGate` is the usual
  * way in, since it picks this only when there is genuinely nothing to show.
  */
-function ConnectNoSubscriptionCard({ plansHref = DEFAULT_PLANS_HREF, title = "You're not on a plan yet", description = "Pick a plan to unlock the full service. You can change or cancel it whenever you like.", className, }) {
+function ConnectNoSubscriptionCard({ plansHref = DEFAULT_PLANS_HREF, title = "You're not on a plan yet", description = "Pick a plan to unlock the full application. You can change or cancel it whenever you like.", className, }) {
     return ((0, jsx_runtime_1.jsxs)(react_1.Card, { className: className, children: [(0, jsx_runtime_1.jsxs)(react_1.Card.Header, { children: [(0, jsx_runtime_1.jsx)(react_1.Card.Title, { children: title }), (0, jsx_runtime_1.jsx)(react_1.Card.Description, { children: description })] }), (0, jsx_runtime_1.jsx)(react_1.Card.Footer, { children: (0, jsx_runtime_1.jsxs)(link_button_js_1.ConnectLinkButton, { href: plansHref, variant: "primary", children: ["See plans", (0, jsx_runtime_1.jsx)(lucide_react_1.ArrowRight, { className: "size-3.5" })] }) })] }));
 }
 /**

package/dist/cjs/client/components/usage-meter.js

@@ -19,7 +19,7 @@ function formatDate(iso) {
  *
  * Reads the balance Connect actually debits, so the number here and the number
  * `consumeAddon` enforces cannot disagree. Before the `addons:read` endpoint
- * existed this component was impossible to write honestly: a service could
+ * existed this component was impossible to write honestly: an application could
  * spend an allowance down on every request and the only thing the API exposed
  * was the list of add-on *ids* on the subscription.
  *