@agent-native/core 0.152.0 → 0.153.0

package/dist/client/chat-first/app-open-actions.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "@agent-native/toolkit";
+import { Button } from "@agent-native/toolkit/ui/button";
+import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger, } from "@agent-native/toolkit/ui/dropdown-menu";
+import { IconAppWindow, IconChevronDown, IconExternalLink, IconPlus, } from "@tabler/icons-react";
+export const APP_ACTION_MENU_CONTENT_CLASS = "w-48";
+const DEFAULT_LABELS = {
+    addApp: "Add app",
+    openApp: "Open app",
+    openInline: "Open inline",
+    openInNewTab: "Open in new tab",
+};
+export function AppOpenActions({ name, href, target, rel, labels: labelOverrides, onAddApp, onOpen, onOpenInline, showInlineOption = false, showNewTabOption = false, menuItems, className, }) {
+    const labels = { ...DEFAULT_LABELS, ...labelOverrides };
+    const primaryUsesHref = Boolean(href) && !onOpen;
+    const canOfferNewTab = Boolean(href) && showNewTabOption;
+    const hasMenu = Boolean(onAddApp) ||
+        (Boolean(href) && (Boolean(onOpenInline) || canOfferNewTab)) ||
+        Boolean(menuItems?.length);
+    const canOpen = primaryUsesHref || Boolean(onOpen);
+    if (!canOpen && !hasMenu) {
+        return (_jsx(Button, { size: "sm", variant: "outline", disabled: true, children: labels.openApp }));
+    }
+    return (_jsxs("div", { className: cn("app-open-actions flex shrink-0 overflow-hidden rounded-md border border-border focus-within:ring-2 focus-within:ring-ring focus-within:ring-offset-2", className), children: [_jsx(Button, { asChild: primaryUsesHref, size: "sm", variant: "outline", className: "app-open-actions__primary h-7 rounded-none border-0 border-e border-border px-0 pe-2 ps-3 text-xs", disabled: !canOpen, onClick: onOpen, type: primaryUsesHref ? undefined : "button", "aria-label": !primaryUsesHref ? `Open ${name}` : undefined, children: primaryUsesHref ? (_jsx("a", { href: href ?? undefined, target: target, rel: rel, children: labels.openApp })) : (_jsx("span", { children: labels.openApp })) }), hasMenu ? (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsx(Button, { type: "button", size: "sm", variant: "outline", className: "app-open-actions__menu size-7 rounded-none border-0 p-0 text-xs", "aria-label": `Open options for ${name}`, children: _jsx(IconChevronDown, { size: 15 }) }) }), _jsxs(DropdownMenuContent, { align: "end", className: APP_ACTION_MENU_CONTENT_CLASS, children: [onAddApp ? (_jsxs(DropdownMenuItem, { onSelect: onAddApp, children: [_jsx(IconPlus, { size: 14, "aria-hidden": "true" }), labels.addApp] })) : null, showInlineOption && href && onOpenInline ? (_jsxs(DropdownMenuItem, { onSelect: onOpenInline, children: [_jsx(IconAppWindow, { size: 14, "aria-hidden": "true" }), labels.openInline] })) : null, canOfferNewTab && href ? (_jsx(DropdownMenuItem, { asChild: true, children: _jsxs("a", { href: href ?? undefined, target: "_blank", rel: "noreferrer", children: [_jsx(IconExternalLink, { size: 14, "aria-hidden": "true" }), labels.openInNewTab] }) })) : null, menuItems?.map((item) => (_jsxs(DropdownMenuItem, { onSelect: item.onSelect, children: [item.icon ? (_jsx("span", { "aria-hidden": "true", className: "shrink-0", children: item.icon })) : null, item.label] }, item.id)))] })] })) : null] }));
+}

package/dist/client/chat-first/index.d.ts

@@ -1,6 +1,7 @@
 export { ChatFirstAgentsPane } from "./agents-pane.js";
 export { ChatFirstAppPane } from "./app-pane.js";
 export { ChatFirstAppsRail } from "./apps-rail.js";
+export { APP_ACTION_MENU_CONTENT_CLASS, AppOpenActions, type AppOpenActionLabels, type AppOpenActionMenuItem, } from "./app-open-actions.js";
 export { ChatFirstBrowserPane } from "./browser-pane.js";
 export { defaultChatFirstCopy } from "./copy.js";
 export { ChatFirstChatHistory, type ChatFirstChatHistoryProps, } from "./chat-history.js";

package/dist/client/chat-first/index.js

@@ -1,6 +1,7 @@
 export { ChatFirstAgentsPane } from "./agents-pane.js";
 export { ChatFirstAppPane } from "./app-pane.js";
 export { ChatFirstAppsRail } from "./apps-rail.js";
+export { APP_ACTION_MENU_CONTENT_CLASS, AppOpenActions, } from "./app-open-actions.js";
 export { ChatFirstBrowserPane } from "./browser-pane.js";
 export { defaultChatFirstCopy } from "./copy.js";
 export { ChatFirstChatHistory, } from "./chat-history.js";

package/dist/client/chat-first/primary-nav.d.ts

@@ -1,10 +1,11 @@
 import type { ChatFirstCopy } from "./types.js";
 export type ChatFirstPrimaryTab = "new-chat" | "integrations" | "scheduled";
-export declare function ChatFirstPrimaryNavigation({ onNewChat, onOpenIntegrations, onOpenScheduled, onSearch, activeTab, copy, }: {
+export declare function ChatFirstPrimaryNavigation({ onNewChat, onOpenIntegrations, onOpenScheduled, onSearch, activeTab, stickyNewChat, copy, }: {
     onNewChat?: () => void;
     onOpenIntegrations: () => void;
     onOpenScheduled: () => void;
     onSearch?: () => void;
     activeTab?: ChatFirstPrimaryTab;
+    stickyNewChat?: boolean;
     copy?: ChatFirstCopy;
 }): import("react").JSX.Element;

package/dist/client/chat-first/primary-nav.js

@@ -1,12 +1,19 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { IconClock, IconPlus, IconPlugConnected, IconSearch, } from "@tabler/icons-react";
 import { defaultChatFirstCopy } from "./copy.js";
-export function ChatFirstPrimaryNavigation({ onNewChat, onOpenIntegrations, onOpenScheduled, onSearch, activeTab, copy = defaultChatFirstCopy, }) {
+export function ChatFirstPrimaryNavigation({ onNewChat, onOpenIntegrations, onOpenScheduled, onSearch, activeTab, stickyNewChat = false, copy = defaultChatFirstCopy, }) {
     const tabClassName = (tab) => `flex h-8 w-full items-center gap-2 rounded-md px-2 text-[13px] font-medium transition-[background-color,color] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring ${activeTab === tab
         ? "bg-sidebar-accent text-sidebar-accent-foreground"
         : "text-sidebar-foreground/80 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"}`;
-    const renderTab = (tab, content, onSelect) => (_jsx("button", { type: "button", role: "tab", "aria-selected": activeTab === tab, className: tabClassName(tab), onClick: onSelect, children: content }));
-    return (_jsxs("div", { children: [_jsxs("div", { role: "tablist", "aria-label": "Primary navigation", className: "grid gap-px", children: [onNewChat
-                        ? renderTab("new-chat", _jsxs(_Fragment, { children: [_jsx(IconPlus, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { children: copy("newChat") })] }), onNewChat)
-                        : null, renderTab("integrations", _jsxs(_Fragment, { children: [_jsx(IconPlugConnected, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { children: copy("integrations") })] }), onOpenIntegrations), renderTab("scheduled", _jsxs(_Fragment, { children: [_jsx(IconClock, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { children: copy("scheduled") })] }), onOpenScheduled)] }), onSearch ? (_jsxs("button", { type: "button", className: "mt-px flex h-8 w-full items-center gap-2 rounded-md px-2 text-[13px] font-medium text-sidebar-foreground/80 transition-[background-color,color] hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", onClick: onSearch, children: [_jsx(IconSearch, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { children: copy("search") })] })) : null] }));
+    const renderTab = (tab, content, onSelect, className) => (_jsx("button", { type: "button", role: "tab", "aria-selected": activeTab === tab, className: [tabClassName(tab), className].filter(Boolean).join(" "), onClick: onSelect, children: content }));
+    const newChatTab = onNewChat
+        ? renderTab("new-chat", _jsxs(_Fragment, { children: [_jsx(IconPlus, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { children: copy("newChat") })] }), onNewChat, "code-agents-primary-new-chat")
+        : null;
+    const integrationsTab = renderTab("integrations", _jsxs(_Fragment, { children: [_jsx(IconPlugConnected, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { children: copy("integrations") })] }), onOpenIntegrations);
+    const scheduledTab = renderTab("scheduled", _jsxs(_Fragment, { children: [_jsx(IconClock, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { children: copy("scheduled") })] }), onOpenScheduled);
+    const searchAction = onSearch ? (_jsxs("button", { type: "button", className: "mt-px flex h-8 w-full items-center gap-2 rounded-md px-2 text-[13px] font-medium text-sidebar-foreground/80 transition-[background-color,color] hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", onClick: onSearch, children: [_jsx(IconSearch, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { children: copy("search") })] })) : null;
+    if (stickyNewChat) {
+        return (_jsxs(_Fragment, { children: [newChatTab ? (_jsx("div", { className: "code-agents-primary-new-chat-shell", children: newChatTab })) : null, _jsxs("div", { className: "code-agents-nav-list", "aria-label": "Agent navigation", children: [_jsxs("div", { role: "tablist", "aria-label": "Primary navigation", className: "grid gap-px", children: [integrationsTab, scheduledTab] }), searchAction] })] }));
+    }
+    return (_jsxs("div", { children: [_jsxs("div", { role: "tablist", "aria-label": "Primary navigation", className: "grid gap-px", children: [newChatTab, integrationsTab, scheduledTab] }), searchAction] }));
 }

package/dist/client/conversation/use-near-bottom-autoscroll.d.ts

@@ -4,6 +4,20 @@ export interface UseNearBottomAutoscrollOptions {
     threshold?: number;
     enabled?: boolean;
 }
+/**
+ * @deprecated Nothing in this repo calls this any more — `AgentConversation`
+ * and `AssistantChat` both stick to the bottom via the shadcn `MessageScroller`
+ * primitive, which does it with one mechanism instead of five.
+ *
+ * What is below is five independent things all writing `scrollTop`: a scroll
+ * listener with a content-shrank heuristic, a ResizeObserver re-attached to
+ * every child on each mutation, a MutationObserver that scrolls, a
+ * rAF+rAF+setTimeout(80) chain, and a 100ms interval while streaming. Each was
+ * added to fix a different report and none replaced the one before it, so they
+ * race: that is the "text bumps up and down rapidly" and "flashing and
+ * jittering" users kept describing. Kept only so an external template importing
+ * it does not break; do not adopt it, and delete it in the next major.
+ */
 export declare function useNearBottomAutoscroll<TElement extends HTMLElement>({ followKey, streaming, threshold, enabled, }: UseNearBottomAutoscrollOptions): {
     scrollRef: import("react").RefObject<TElement | null>;
     isNearBottomRef: import("react").RefObject<boolean>;

package/dist/client/conversation/use-near-bottom-autoscroll.js

@@ -30,6 +30,20 @@ function nestedScrollableConsumesVerticalIntent(event, root, deltaY) {
     }
     return false;
 }
+/**
+ * @deprecated Nothing in this repo calls this any more — `AgentConversation`
+ * and `AssistantChat` both stick to the bottom via the shadcn `MessageScroller`
+ * primitive, which does it with one mechanism instead of five.
+ *
+ * What is below is five independent things all writing `scrollTop`: a scroll
+ * listener with a content-shrank heuristic, a ResizeObserver re-attached to
+ * every child on each mutation, a MutationObserver that scrolls, a
+ * rAF+rAF+setTimeout(80) chain, and a 100ms interval while streaming. Each was
+ * added to fix a different report and none replaced the one before it, so they
+ * race: that is the "text bumps up and down rapidly" and "flashing and
+ * jittering" users kept describing. Kept only so an external template importing
+ * it does not break; do not adopt it, and delete it in the next major.
+ */
 export function useNearBottomAutoscroll({ followKey, streaming = false, threshold = 4, enabled = true, }) {
     const scrollRef = useRef(null);
     const isNearBottomRef = useRef(true);

package/dist/client/error-format.js

@@ -56,10 +56,34 @@ function isProviderRateLimit(text, errorCode) {
         code === "http_429" ||
         code === "rate_limited" ||
         code === "rate_limit_exceeded" ||
+        code === "overloaded_error" ||
         /^429 status code(?:\s*\(no body\))?$/i.test(text) ||
         /\b(?:http\s*)?429\b.*\b(?:status|too many requests|rate[-_\s]?limit|no body)\b/i.test(text) ||
         /\b(?:too many requests|rate[-_\s]?limit(?:ed| exceeded)?)\b/i.test(text));
 }
+function parseProviderErrorPayload(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object")
+            return null;
+        const record = parsed;
+        const error = record.error;
+        if (!error || typeof error !== "object")
+            return null;
+        const errorRecord = error;
+        const errorCode = typeof errorRecord.type === "string" ? errorRecord.type : undefined;
+        const message = typeof errorRecord.message === "string"
+            ? errorRecord.message.trim()
+            : undefined;
+        if (!errorCode && !message)
+            return null;
+        return { message, errorCode };
+        // coercion-ok: invalid provider payloads are expected and fall back to the raw error text
+    }
+    catch {
+        return null;
+    }
+}
 export function isProviderAuthenticationError(text, errorCode) {
     const code = normalizeErrorCode(errorCode);
     const lower = text.toLowerCase();
@@ -87,7 +111,11 @@ export function normalizeChatError(errorMessage, errorCode) {
     const raw = String(errorMessage || "Unknown error");
     const looksHtml = /<html[\s>]|<body[\s>]|<head[\s>]/i.test(raw);
     const text = looksHtml ? htmlToText(raw) : raw.trim();
-    const code = normalizeErrorCode(errorCode);
+    const providerPayload = looksHtml ? null : parseProviderErrorPayload(text);
+    const code = normalizeErrorCode(errorCode ?? providerPayload?.errorCode);
+    const providerMessage = providerPayload?.errorCode === "overloaded_error"
+        ? "The model provider is overloaded right now. Wait a moment, then retry."
+        : providerPayload?.message;
     if (code === "builder_model_unauthorized") {
         return {
             message: "The provider behind this model rejected the request. Pick a different model, then retry.",
@@ -121,9 +149,10 @@ export function normalizeChatError(errorMessage, errorCode) {
             details: text,
         };
     }
-    if (isProviderRateLimit(text, errorCode)) {
+    if (isProviderRateLimit(text, code)) {
         return {
-            message: "The model provider is rate-limiting this chat right now. Wait a moment, then retry.",
+            message: providerMessage ??
+                "The model provider is rate-limiting this chat right now. Wait a moment, then retry.",
             details: text,
         };
     }

package/dist/client/extensions/EmbeddedExtension.js

@@ -206,6 +206,7 @@ export function EmbeddedExtension({ extensionId, slotId, context, className, ini
                 const role = binding.role === "owner" ||
                     binding.role === "admin" ||
                     binding.role === "editor" ||
+                    binding.role === "commenter" ||
                     binding.role === "viewer"
                     ? binding.role
                     : "viewer";

package/dist/client/extensions/ExtensionViewer.js

@@ -81,6 +81,7 @@ function extensionRole(value) {
     return value === "owner" ||
         value === "admin" ||
         value === "editor" ||
+        value === "commenter" ||
         value === "viewer"
         ? value
         : "viewer";
@@ -441,6 +442,7 @@ export function ExtensionViewer({ extensionId }) {
                 const role = binding.role === "owner" ||
                     binding.role === "admin" ||
                     binding.role === "editor" ||
+                    binding.role === "commenter" ||
                     binding.role === "viewer"
                     ? binding.role
                     : "viewer";
@@ -732,7 +734,7 @@ export function ExtensionViewer({ extensionId }) {
                                                     ? t("extensions.sandboxedCustomBlockCreatedBy", {
                                                         email: extension.ownerEmail,
                                                     })
-                                                    : t("extensions.sandboxedCustomBlock"), children: t("extensions.customBlockSandboxed") })), extension.canEdit && !isLocalExtension && (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("button", { type: "button", onClick: startRename, className: "shrink-0 cursor-pointer rounded p-0.5 text-muted-foreground/40 opacity-0 group-hover/name:opacity-100 hover:text-foreground", children: _jsx(IconPencil, { className: "h-3 w-3" }) }) }), _jsx(TooltipContent, { children: "Rename" })] }))] }))] }) }), _jsxs("div", { className: "flex shrink-0 items-center gap-1", children: [_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("button", { type: "button", onClick: () => setRefreshKey((k) => k + 1), className: "inline-flex items-center justify-center rounded-md h-8 w-8 text-muted-foreground hover:bg-accent hover:text-accent-foreground cursor-pointer", children: _jsx(IconRefresh, { className: "h-4 w-4" }) }) }), _jsx(TooltipContent, { children: "Refresh" })] }), !isLocalExtension && (_jsxs(_Fragment, { children: [_jsx(ExtensionHistoryPopover, { extensionId: extensionId, canEdit: extension.canEdit, onRestored: () => setRefreshKey((k) => k + 1), onOpenChange: onPopoverOpenChange }), _jsx(EditToolPopover, { extension: extension, onOpenChange: onPopoverOpenChange })] })), _jsx(ToolMoreMenu, { extensionId: extensionId, toolName: extension.name, ownerEmail: extension.ownerEmail, canDelete: extension.canDelete, canEdit: extension.canEdit, sourceMode: extension.source?.mode, onOpenChange: onPopoverOpenChange }), !isLocalExtension && (_jsx(_Fragment, { children: _jsx(ShareButton, { resourceType: "extension", resourceId: extensionId, resourceTitle: extension.name, onOpenChange: onPopoverOpenChange, accessNote: _jsx(_Fragment, { children: "Extensions can be shared inside your organization only \u2014 they run with the viewer's credentials, so cross-org access isn't supported." }) }) })), _jsx(AgentToggleButton, {})] })] }), isLocalExtension && (_jsxs("div", { className: "shrink-0 border-b bg-muted/30 px-4 py-2 text-xs text-muted-foreground", children: ["Repo-backed extension. Edit", " ", _jsx("span", { className: "font-mono text-foreground", children: extension.source?.entryPath ?? "extensions/*/index.html" }), " ", "in your workspace, then refresh this preview."] })), _jsxs("div", { className: "relative flex-1 min-h-0", children: [!iframeReady && (_jsx("div", { className: "absolute inset-0 flex items-center justify-center bg-background z-10", children: _jsx(IconLoader2, { className: "size-5 animate-spin text-muted-foreground", role: "status", "aria-label": "Loading" }) })), _jsx("iframe", { [SESSION_REPLAY_IFRAME_ATTRIBUTE]: "", ref: iframeRef, src: iframeSrcDoc ? undefined : iframeSrc, srcDoc: iframeSrcDoc, className: "h-full w-full border-0", sandbox: EXTENSION_IFRAME_SANDBOX, title: extension.name, style: {
+                                                    : t("extensions.sandboxedCustomBlock"), children: t("extensions.customBlockSandboxed") })), extension.canEdit && !isLocalExtension && (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("button", { type: "button", onClick: startRename, className: "shrink-0 cursor-pointer rounded p-0.5 text-muted-foreground/40 opacity-0 group-hover/name:opacity-100 hover:text-foreground", children: _jsx(IconPencil, { className: "h-3 w-3" }) }) }), _jsx(TooltipContent, { children: "Rename" })] }))] }))] }) }), _jsxs("div", { className: "flex shrink-0 items-center gap-1", children: [_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("button", { type: "button", onClick: () => setRefreshKey((k) => k + 1), className: "inline-flex items-center justify-center rounded-md h-8 w-8 text-muted-foreground hover:bg-accent hover:text-accent-foreground cursor-pointer", children: _jsx(IconRefresh, { className: "h-4 w-4" }) }) }), _jsx(TooltipContent, { children: "Refresh" })] }), !isLocalExtension && (_jsxs(_Fragment, { children: [_jsx(ExtensionHistoryPopover, { extensionId: extensionId, canEdit: extension.canEdit, onRestored: () => setRefreshKey((k) => k + 1), onOpenChange: onPopoverOpenChange }), _jsx(EditToolPopover, { extension: extension, onOpenChange: onPopoverOpenChange })] })), _jsx(ToolMoreMenu, { extensionId: extensionId, toolName: extension.name, ownerEmail: extension.ownerEmail, canDelete: extension.canDelete, canEdit: extension.canEdit, sourceMode: extension.source?.mode, onOpenChange: onPopoverOpenChange }), !isLocalExtension && (_jsx(_Fragment, { children: _jsx(ShareButton, { resourceType: "extension", resourceId: extensionId, allowedRoles: ["viewer", "editor", "admin"], resourceTitle: extension.name, onOpenChange: onPopoverOpenChange, accessNote: _jsx(_Fragment, { children: "Extensions can be shared inside your organization only \u2014 they run with the viewer's credentials, so cross-org access isn't supported." }) }) })), _jsx(AgentToggleButton, {})] })] }), isLocalExtension && (_jsxs("div", { className: "shrink-0 border-b bg-muted/30 px-4 py-2 text-xs text-muted-foreground", children: ["Repo-backed extension. Edit", " ", _jsx("span", { className: "font-mono text-foreground", children: extension.source?.entryPath ?? "extensions/*/index.html" }), " ", "in your workspace, then refresh this preview."] })), _jsxs("div", { className: "relative flex-1 min-h-0", children: [!iframeReady && (_jsx("div", { className: "absolute inset-0 flex items-center justify-center bg-background z-10", children: _jsx(IconLoader2, { className: "size-5 animate-spin text-muted-foreground", role: "status", "aria-label": "Loading" }) })), _jsx("iframe", { [SESSION_REPLAY_IFRAME_ATTRIBUTE]: "", ref: iframeRef, src: iframeSrcDoc ? undefined : iframeSrc, srcDoc: iframeSrcDoc, className: "h-full w-full border-0", sandbox: EXTENSION_IFRAME_SANDBOX, title: extension.name, style: {
                                 pointerEvents: openPopoverCount > 0 ? "none" : "auto",
                             }, onLoad: () => {
                                 sendThemeToIframe();

package/dist/client/extensions/InlineExtensionFrame.js

@@ -54,6 +54,7 @@ function normalizeRole(value) {
     return value === "owner" ||
         value === "admin" ||
         value === "editor" ||
+        value === "commenter" ||
         value === "viewer"
         ? value
         : "viewer";

package/dist/client/extensions/iframe-bridge.d.ts

@@ -13,7 +13,7 @@
  */
 export declare function isAllowedExtensionPath(path: string, extensionId: string): boolean;
 export declare function sanitizeExtensionRequestOptions(value: unknown): RequestInit;
-export type ExtensionBridgeRole = "owner" | "admin" | "editor" | "viewer";
+export type ExtensionBridgeRole = "owner" | "admin" | "editor" | "commenter" | "viewer";
 export interface BridgePolicyContext {
     /** Extension id currently owning the iframe. Used for narrow helper-specific exceptions. */
     extensionId?: string;
@@ -39,7 +39,8 @@ export interface BridgePolicyResult {
 /**
  * Decide whether the iframe is allowed to proxy this request given the
  * viewer's role on the extension. Authors (and owner/admin/editor in general)
- * keep the full bridge surface; viewers get a strictly read-only subset.
+ * keep the full bridge surface; commenters and viewers get a strictly
+ * read-only subset because extensions have no comment-specific bridge APIs.
  *
  * Called BEFORE the request leaves the parent — so a denial is local-only
  * and never reveals server state to the iframe.

package/dist/client/extensions/iframe-bridge.js

@@ -119,7 +119,8 @@ const READ_METHODS = new Set(["GET", "HEAD"]);
 /**
  * Decide whether the iframe is allowed to proxy this request given the
  * viewer's role on the extension. Authors (and owner/admin/editor in general)
- * keep the full bridge surface; viewers get a strictly read-only subset.
+ * keep the full bridge surface; commenters and viewers get a strictly
+ * read-only subset because extensions have no comment-specific bridge APIs.
  *
  * Called BEFORE the request leaves the parent — so a denial is local-only
  * and never reveals server state to the iframe.
@@ -138,7 +139,8 @@ export function checkBridgePolicy(path, method, ctx) {
     if (ctx.role === "editor") {
         return { ok: true };
     }
-    // From here on: role === "viewer". Lock down everything beyond reads.
+    // From here on: role === "commenter" or "viewer". Lock down everything
+    // beyond reads; extensions have no comment-specific bridge APIs.
     const upperMethod = method.toUpperCase();
     // SQL is denied for viewers entirely (defense-in-depth: dev mode bypasses
     // the production scoping shim).

package/dist/client/guided-questions.d.ts

@@ -46,6 +46,13 @@ export interface GuidedQuestionPayload {
      * promise with the answer instead of forwarding it to the agent chat.
      */
     clientResolveId?: string;
+    /**
+     * Chat thread that asked. Set by the agent's `ask-question` tool. A payload
+     * carrying this only renders in that conversation; one without it (app code
+     * calling {@link askUserQuestion}, deterministic writes) is not thread-bound
+     * and renders wherever the flow is mounted.
+     */
+    threadId?: string;
 }
 export declare function isOtherGuidedAnswer(value: unknown): value is string;
 export declare function getOtherGuidedAnswerText(value: unknown): string;
@@ -137,6 +144,13 @@ export interface UseGuidedQuestionFlowOptions {
      * (which it almost always does — see `sessionBrowserTabId`).
      */
     browserTabId?: string;
+    /**
+     * The conversation this flow is mounted in. Agent-written payloads name the
+     * thread that asked, and a pending question belongs to that conversation
+     * only — the application-state key is per browser tab, so without this the
+     * same card follows the user into every other chat in the tab.
+     */
+    threadId?: string;
     queryKey?: readonly unknown[];
     refetchInterval?: number | false;
     submitMessage?: string;
@@ -147,7 +161,7 @@ export interface UseGuidedQuestionFlowOptions {
     }) => string;
     buildSkipContext?: () => string;
 }
-export declare function useGuidedQuestionFlow({ enabled, stateKey, browserTabId, queryKey, refetchInterval, submitMessage, skipMessage, buildSubmitContext, buildSkipContext, }?: UseGuidedQuestionFlowOptions): {
+export declare function useGuidedQuestionFlow({ enabled, stateKey, browserTabId, threadId, queryKey, refetchInterval, submitMessage, skipMessage, buildSubmitContext, buildSkipContext, }?: UseGuidedQuestionFlowOptions): {
     payload: GuidedQuestionPayload | null;
     questions: GuidedQuestion[] | null;
     title: string | undefined;

package/dist/client/guided-questions.js

@@ -406,7 +406,17 @@ function normalizeBrowserTabId(browserTabId) {
     const trimmed = browserTabId.trim();
     return SAFE_BROWSER_TAB_ID_RE.test(trimmed) ? trimmed : undefined;
 }
-export function useGuidedQuestionFlow({ enabled = true, stateKey = "show-questions", browserTabId, queryKey = ["show-questions"], refetchInterval = false, submitMessage = "Here are my answers — go ahead.", skipMessage = "Skip the questions — decide for me.", buildSubmitContext, buildSkipContext, } = {}) {
+/**
+ * Whether a stored payload belongs to the conversation currently on screen.
+ * Payloads with no `threadId` are not thread-bound and always match.
+ */
+function payloadBelongsToThread(payload, threadId) {
+    const asker = typeof payload.threadId === "string" ? payload.threadId.trim() : "";
+    if (!asker)
+        return true;
+    return asker === (threadId ?? "").trim();
+}
+export function useGuidedQuestionFlow({ enabled = true, stateKey = "show-questions", browserTabId, threadId, queryKey = ["show-questions"], refetchInterval = false, submitMessage = "Here are my answers — go ahead.", skipMessage = "Skip the questions — decide for me.", buildSubmitContext, buildSkipContext, } = {}) {
     const queryClient = useQueryClient();
     const [payload, setPayload] = useState(null);
     const normalizedBrowserTabId = useMemo(() => normalizeBrowserTabId(browserTabId), [browserTabId]);
@@ -458,7 +468,11 @@ export function useGuidedQuestionFlow({ enabled = true, stateKey = "show-questio
                 if (prev &&
                     guidedQuestionsFingerprint(prev.questions) ===
                         guidedQuestionsFingerprint(data.questions) &&
-                    prev.clientResolveId === data.clientResolveId) {
+                    prev.clientResolveId === data.clientResolveId &&
+                    // Two chats can ask a word-for-word identical question. Keeping the
+                    // old payload would bind the new one to the wrong thread, hiding it
+                    // in the chat that asked and re-showing it in the one that didn't.
+                    prev.threadId === data.threadId) {
                     return prev;
                 }
                 return data;
@@ -468,6 +482,10 @@ export function useGuidedQuestionFlow({ enabled = true, stateKey = "show-questio
             setPayload(null);
         }
     }, [data]);
+    // A question asked in another conversation stays in application state — the
+    // user can still answer it by going back to that chat — but it must not
+    // render here.
+    const visiblePayload = payload && payloadBelongsToThread(payload, threadId) ? payload : null;
     const clear = useCallback(() => {
         setPayload(null);
         queryClient.setQueryData(resolvedQueryKey, null);
@@ -481,15 +499,15 @@ export function useGuidedQuestionFlow({ enabled = true, stateKey = "show-questio
     const handleSubmit = useCallback((answers) => {
         // Client-initiated question (askUserQuestion): resolve the caller's
         // promise with the answer instead of forwarding it to the agent chat.
-        const resolveId = payload?.clientResolveId;
+        const resolveId = visiblePayload?.clientResolveId;
         if (resolveId) {
-            const firstId = payload?.questions?.[0]?.id ?? "q1";
+            const firstId = visiblePayload?.questions?.[0]?.id ?? "q1";
             resolveClientQuestion(resolveId, extractSingleAnswer(answers, firstId));
             clear();
             return;
         }
         const formattedAnswers = formatGuidedAnswersForAgent(answers);
-        const resolvedSubmitMessage = payload?.submitMessage ?? submitMessage;
+        const resolvedSubmitMessage = visiblePayload?.submitMessage ?? submitMessage;
         const context = buildSubmitContext?.({ answers, formattedAnswers }) ??
             defaultGuidedSubmitContext(formattedAnswers);
         sendToAgentChat({
@@ -498,28 +516,28 @@ export function useGuidedQuestionFlow({ enabled = true, stateKey = "show-questio
             submit: true,
         });
         clear();
-    }, [buildSubmitContext, clear, payload, submitMessage]);
+    }, [buildSubmitContext, clear, visiblePayload, submitMessage]);
     const handleSkip = useCallback(() => {
-        const resolveId = payload?.clientResolveId;
+        const resolveId = visiblePayload?.clientResolveId;
         if (resolveId) {
             resolveClientQuestion(resolveId, null);
             clear();
             return;
         }
         sendToAgentChat({
-            message: payload?.skipMessage ?? skipMessage,
+            message: visiblePayload?.skipMessage ?? skipMessage,
             context: buildSkipContext?.(),
             submit: true,
         });
         clear();
-    }, [buildSkipContext, clear, payload, skipMessage]);
+    }, [buildSkipContext, clear, visiblePayload, skipMessage]);
     return {
-        payload,
-        questions: payload?.questions ?? null,
-        title: payload?.title,
-        description: payload?.description,
-        skipLabel: payload?.skipLabel,
-        submitLabel: payload?.submitLabel,
+        payload: visiblePayload,
+        questions: visiblePayload?.questions ?? null,
+        title: visiblePayload?.title,
+        description: visiblePayload?.description,
+        skipLabel: visiblePayload?.skipLabel,
+        submitLabel: visiblePayload?.submitLabel,
         clear,
         handleSubmit,
         handleSkip,

package/dist/client/i18n.js

@@ -7,6 +7,7 @@ import { createContext, useCallback, useContext, useEffect, useMemo, useRef, use
 import { I18nextProvider, initReactI18next, useTranslation, } from "react-i18next";
 import defaultEnglishMessages from "../localization/default-messages.js";
 import { DEFAULT_LOCALE, LOCALE_HYDRATION_GLOBAL, LOCALE_METADATA, LOCALE_STORAGE_KEY, SUPPORTED_LOCALES, localeDirection, normalizeLocalizationPreference, resolveLocaleFromCandidates, resolveLocaleFromPreference, } from "../localization/shared.js";
+import { injectedAgentNativeConfig } from "./app-config.js";
 import { setClientAppState } from "./application-state.js";
 import { callAction } from "./use-action.js";
 import { cn } from "./utils.js";
@@ -127,11 +128,27 @@ function readHydrationPayload() {
 function resolveInitialState(args) {
     const hydration = readHydrationPayload();
     const preference = normalizeLocalizationPreference(args.initialPreference ?? hydration.preference ?? readStoredPreference()).locale;
-    const locale = args.initialLocale ??
+    const requestedLocale = args.initialLocale ??
         hydration.locale ??
         resolveLocaleFromPreference(preference, browserLanguageCandidates());
+    const locale = args.supportedLocales.includes(requestedLocale)
+        ? requestedLocale
+        : args.sourceLocale;
     return { locale, preference };
 }
+function resolveSupportedLocales(args) {
+    const configured = injectedAgentNativeConfig().translations?.locales;
+    const candidates = configured ??
+        args.catalog?.supportedLocales ?? [args.sourceLocale];
+    const supported = candidates.filter((locale) => SUPPORTED_LOCALES.includes(locale));
+    return [
+        args.sourceLocale,
+        ...supported.filter((locale) => locale !== args.sourceLocale),
+    ].filter((locale, index, all) => all.indexOf(locale) === index);
+}
+function resolveSupportedLocale(locale, supportedLocales, sourceLocale) {
+    return supportedLocales.includes(locale) ? locale : sourceLocale;
+}
 function normalizeLoadedMessages(value) {
     if (!value || typeof value !== "object" || Array.isArray(value))
         return null;
@@ -173,9 +190,14 @@ export function AgentNativeI18nProvider({ children, catalog, initialLocale, init
     const sourceLocale = catalog?.sourceLocale ?? DEFAULT_LOCALE;
     const sourceMessages = catalog?.messages ?? {};
     const loadMessages = catalog?.loadMessages;
-    const supportedLocales = catalog?.supportedLocales ?? SUPPORTED_LOCALES;
+    const supportedLocales = useMemo(() => resolveSupportedLocales({ catalog, sourceLocale }), [catalog, sourceLocale]);
     const hydration = readHydrationPayload();
-    const initialState = useMemo(() => resolveInitialState({ initialLocale, initialPreference }), [initialLocale, initialPreference]);
+    const initialState = useMemo(() => resolveInitialState({
+        initialLocale,
+        initialPreference,
+        sourceLocale,
+        supportedLocales,
+    }), [initialLocale, initialPreference, sourceLocale, supportedLocales]);
     const [preference, setPreferenceState] = useState(initialState.preference);
     const [locale, setLocale] = useState(initialState.locale);
     const [loading, setLoading] = useState(false);
@@ -204,8 +226,8 @@ export function AgentNativeI18nProvider({ children, catalog, initialLocale, init
         const nextLocale = preference === "system"
             ? resolveLocaleFromCandidates(browserLanguageCandidates())
             : preference;
-        setLocale(nextLocale);
-    }, [preference]);
+        setLocale(resolveSupportedLocale(nextLocale, supportedLocales, sourceLocale));
+    }, [preference, sourceLocale, supportedLocales]);
     useEffect(() => {
         let cancelled = false;
         async function applyLocale() {
@@ -247,6 +269,7 @@ export function AgentNativeI18nProvider({ children, catalog, initialLocale, init
         locale,
         namespace,
         sourceLocale,
+        supportedLocales,
     ]);
     useEffect(() => {
         if (typeof document === "undefined")

package/dist/client/integrations/IntegrationConnectionChoice.d.ts

@@ -0,0 +1,11 @@
+import type { ReactNode } from "react";
+export interface IntegrationConnectionChoiceProps {
+    name: string;
+    logo?: ReactNode;
+    showWorkspaceOption: boolean;
+    busy?: boolean;
+    onPersonal: () => void;
+    onWorkspace: () => void;
+}
+/** The one small decision before an integration's advanced setup surface. */
+export declare function IntegrationConnectionChoice({ name, logo, showWorkspaceOption, busy, onPersonal, onWorkspace, }: IntegrationConnectionChoiceProps): import("react").JSX.Element;

package/dist/client/integrations/IntegrationConnectionChoice.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { IconLoader2, IconUser, IconUsersGroup } from "@tabler/icons-react";
+/** The one small decision before an integration's advanced setup surface. */
+export function IntegrationConnectionChoice({ name, logo, showWorkspaceOption, busy = false, onPersonal, onWorkspace, }) {
+    return (_jsxs("div", { className: "flex min-h-full flex-1 flex-col bg-background", children: [_jsx("header", { className: "flex min-h-16 items-center border-b border-border px-6 sm:px-10", children: _jsxs("div", { className: "flex min-w-0 items-center gap-3", children: [logo ? (_jsx("span", { className: "flex size-8 shrink-0 items-center justify-center rounded-md bg-muted/50 text-foreground", children: logo })) : null, _jsxs("span", { className: "truncate text-sm font-medium text-foreground", children: ["Connect ", name] })] }) }), _jsx("main", { className: "flex flex-1 justify-center overflow-y-auto px-6 py-12 sm:px-10 sm:py-[12vh]", children: _jsxs("div", { className: "w-full max-w-[420px] self-start", children: [_jsx("h1", { className: "text-2xl font-semibold tracking-[-0.03em] text-foreground sm:text-[28px]", children: "Who should use this?" }), _jsx("p", { className: "mt-2 text-sm leading-6 text-muted-foreground", children: "Choose where this connection is available." }), _jsxs("div", { className: "mt-8 grid gap-2.5", children: [_jsxs("button", { type: "button", onClick: onPersonal, disabled: busy, "aria-busy": busy, className: "flex min-h-12 items-center gap-3 rounded-lg bg-primary px-4 py-3 text-left text-primary-foreground transition-[background-color,opacity] hover:bg-primary/90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background disabled:cursor-wait disabled:opacity-60", children: [_jsx(IconUser, { className: "size-4 shrink-0 opacity-75" }), _jsx("span", { className: "min-w-0 flex-1 text-sm font-medium", children: "Connect for me" }), busy ? (_jsx(IconLoader2, { className: "size-4 shrink-0 animate-spin" })) : null] }), showWorkspaceOption ? (_jsxs("button", { type: "button", onClick: onWorkspace, disabled: busy, className: "flex min-h-12 items-center gap-3 rounded-lg bg-muted/50 px-4 py-3 text-left text-foreground transition-colors hover:bg-muted/70 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background disabled:cursor-wait disabled:opacity-60", children: [_jsx(IconUsersGroup, { className: "size-4 shrink-0 text-muted-foreground" }), _jsx("span", { className: "min-w-0 flex-1 text-sm font-medium", children: "Set up for workspace" })] })) : null] })] }) })] }));
+}

package/dist/client/integrations/IntegrationGrid.d.ts

@@ -0,0 +1,23 @@
+import type { ReactNode } from "react";
+export interface IntegrationGridItem {
+    id: string;
+    name: string;
+    description?: string;
+    logo: ReactNode;
+    status?: string;
+    statusClassName?: string;
+    actionLabel: string;
+    actionAriaLabel?: string;
+    disabled?: boolean;
+    onAction: () => void;
+}
+export interface IntegrationGridProps {
+    items: IntegrationGridItem[];
+    emptyLabel?: string;
+    className?: string;
+}
+/**
+ * The shared integration list surface. Keep provider rows intentionally
+ * boring: identity, one-line context, and one clear next action.
+ */
+export declare function IntegrationGrid({ items, emptyLabel, className, }: IntegrationGridProps): import("react").JSX.Element;

package/dist/client/integrations/IntegrationGrid.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "../utils.js";
+/**
+ * The shared integration list surface. Keep provider rows intentionally
+ * boring: identity, one-line context, and one clear next action.
+ */
+export function IntegrationGrid({ items, emptyLabel = "No integrations found.", className, }) {
+    if (items.length === 0) {
+        return (_jsx("div", { className: cn("rounded-xl bg-muted/30 px-5 py-8 text-center text-xs text-muted-foreground", className), children: emptyLabel }));
+    }
+    return (_jsx("div", { className: cn("grid gap-2 overflow-hidden rounded-xl bg-muted/20 p-2", "sm:grid-cols-2", className), children: items.map((item) => (_jsxs("article", { className: "flex min-w-0 items-center gap-3 rounded-lg bg-muted/35 px-3 py-3.5", children: [_jsx("span", { className: "flex size-8 shrink-0 items-center justify-center rounded-md bg-background/80 text-foreground", children: item.logo }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsxs("div", { className: "flex min-w-0 items-center gap-2", children: [_jsx("h3", { className: "truncate text-sm font-medium text-foreground", children: item.name }), item.status ? (_jsx("span", { className: cn("shrink-0 text-[11px] font-medium text-muted-foreground", item.statusClassName), children: item.status })) : null] }), item.description ? (_jsx("p", { className: "mt-0.5 line-clamp-1 text-xs leading-5 text-muted-foreground", children: item.description })) : null] }), _jsx("button", { type: "button", onClick: item.onAction, disabled: item.disabled, "aria-label": item.actionAriaLabel ?? `${item.actionLabel} ${item.name}`, className: "inline-flex h-8 shrink-0 items-center justify-center gap-1 rounded-md border border-border bg-background px-2.5 text-xs font-medium text-foreground transition-colors hover:bg-accent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50", children: item.actionLabel })] }, item.id))) }));
+}