@agent-native/core 0.161.23 → 0.163.0

package/dist/client/session-replay.js

@@ -1040,6 +1040,31 @@ function isDefinitiveReplayUploadClientError(status) {
     return status === 400 || status === 409 || status === 413 || status === 422;
 }
 const MAX_TRANSIENT_REPLAY_CLIENT_FAILURES = 3;
+// A hung upload never settles, so `state.flushing` stays set, every later flush
+// early-returns while still queueing rrweb events, and the queue grows until the
+// session ends. Time the request out so the failure is observable and the lock
+// is released.
+const REPLAY_UPLOAD_TIMEOUT_MS = 15_000;
+function startReplayUploadTimeout() {
+    // Use an explicit controller/timer pair instead of relying only on
+    // AbortSignal.timeout: the controller is available in older supported
+    // browsers, and the timer can always be cleared when a normal upload
+    // settles so completed uploads do not leave timeout work behind.
+    const controller = typeof AbortController === "undefined" ? undefined : new AbortController();
+    let rejectTimeout;
+    const promise = new Promise((_, reject) => {
+        rejectTimeout = reject;
+    });
+    const timer = setTimeout(() => {
+        controller?.abort();
+        rejectTimeout(new Error("Session replay upload timed out"));
+    }, REPLAY_UPLOAD_TIMEOUT_MS);
+    return {
+        signal: controller?.signal,
+        promise,
+        done: () => clearTimeout(timer),
+    };
+}
 function isTransientReplayUploadClientError(status) {
     return status === 401 || status === 403 || status === 404;
 }
@@ -1048,12 +1073,21 @@ async function sendReplayUpload(options, body, callbacks = {}) {
         const canUseKeepalive = canUseReplayKeepalive(body);
         if (canUseKeepalive)
             callbacks.beforeKeepaliveUpload?.();
-        const response = await fetch(options.endpoint, {
-            method: "POST",
-            body,
-            keepalive: canUseKeepalive,
-            headers: { "Content-Type": "text/plain;charset=UTF-8" },
-        });
+        const timeout = startReplayUploadTimeout();
+        let response;
+        try {
+            const request = fetch(options.endpoint, {
+                method: "POST",
+                body,
+                keepalive: canUseKeepalive,
+                headers: { "Content-Type": "text/plain;charset=UTF-8" },
+                signal: timeout.signal,
+            });
+            response = await Promise.race([request, timeout.promise]);
+        }
+        finally {
+            timeout.done();
+        }
         if (!response.ok) {
             throw new ReplayUploadHttpError(response.status);
         }
@@ -1063,15 +1097,24 @@ async function sendReplayUpload(options, body, callbacks = {}) {
     const canUseKeepalive = canUseReplayKeepalive(upload.body);
     if (canUseKeepalive)
         callbacks.beforeKeepaliveUpload?.();
-    const response = await fetch(options.endpoint, {
-        method: "POST",
-        body: upload.body,
-        keepalive: canUseKeepalive,
-        headers: {
-            ...upload.headers,
-            "X-Agent-Native-Analytics-Key": options.publicKey,
-        },
-    });
+    const timeout = startReplayUploadTimeout();
+    let response;
+    try {
+        const request = fetch(options.endpoint, {
+            method: "POST",
+            body: upload.body,
+            keepalive: canUseKeepalive,
+            headers: {
+                ...upload.headers,
+                "X-Agent-Native-Analytics-Key": options.publicKey,
+            },
+            signal: timeout.signal,
+        });
+        response = await Promise.race([request, timeout.promise]);
+    }
+    finally {
+        timeout.done();
+    }
     if (!response.ok) {
         throw new ReplayUploadHttpError(response.status);
     }

package/dist/client/settings/SettingsTabsPage.js

@@ -3,6 +3,7 @@ import { Tabs, useDesignSystem } from "@agent-native/toolkit/design-system";
 import { IconArrowUpRight, IconHistory, IconSearch, IconSettings, IconUserCircle, IconUsers, IconX, } from "@tabler/icons-react";
 import { useCallback, useEffect, useMemo, useRef, useState, } from "react";
 import { Link } from "react-router";
+import { appBasePath, appPath } from "../../client/api-path.js";
 import { buildSettingsRoute } from "../../navigation/index.js";
 import { cn } from "../utils.js";
 function normalizeTabId(value) {
@@ -70,12 +71,13 @@ function resolveTabId(tabs, value) {
 function activeTabFromLocation(tabs, defaultTab) {
     if (typeof window === "undefined")
         return defaultTab;
+    const pathname = appLocalPathname();
     const settingsPrefix = "/settings";
-    if (window.location.pathname === settingsPrefix) {
+    if (pathname === settingsPrefix) {
         return resolveTabId(tabs, window.location.hash) ?? defaultTab;
     }
-    if (window.location.pathname.startsWith(`${settingsPrefix}/`)) {
-        const segments = window.location.pathname
+    if (pathname.startsWith(`${settingsPrefix}/`)) {
+        const segments = pathname
             .slice(`${settingsPrefix}/`.length)
             .split("/")
             .filter(Boolean)
@@ -95,6 +97,17 @@ function activeTabFromLocation(tabs, defaultTab) {
     }
     return resolveTabId(tabs, window.location.hash) ?? defaultTab;
 }
+function appLocalPathname() {
+    if (typeof window === "undefined")
+        return "/";
+    const pathname = window.location.pathname;
+    const basePath = appBasePath();
+    if (basePath &&
+        (pathname === basePath || pathname.startsWith(`${basePath}/`))) {
+        return pathname.slice(basePath.length) || "/";
+    }
+    return pathname;
+}
 function buildSettingsEntryRoute(tabId, section) {
     const normalizedSection = section?.replace(/^#/, "").trim();
     if (!normalizedSection || normalizedSection === tabId) {
@@ -112,7 +125,7 @@ function updateRouteForTab(tabId, section) {
     if (typeof window === "undefined")
         return;
     const route = buildSettingsEntryRoute(tabId, section);
-    window.history.pushState(null, "", `${route}${window.location.search}`);
+    window.history.pushState(null, "", `${appPath(route)}${window.location.search}`);
 }
 function isEditableElement(element) {
     if (!(element instanceof HTMLElement))
@@ -233,7 +246,7 @@ export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs =
             const fromPath = activeTabFromLocation(tabs, fallbackTab);
             if (fromPath)
                 setInternalTab(fromPath);
-            if (window.location.pathname.startsWith("/settings/"))
+            if (appLocalPathname().startsWith("/settings/"))
                 return;
             const hashValue = window.location.hash.replace(/^#/, "");
             const fromHash = resolveTabId(tabs, hashValue);
@@ -254,7 +267,7 @@ export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs =
         if (!isControlled)
             return;
         const syncControlledLocation = () => {
-            const fromPath = window.location.pathname.startsWith("/settings/")
+            const fromPath = appLocalPathname().startsWith("/settings/")
                 ? activeTabFromLocation(tabs, defaultTab)
                 : null;
             const hashValue = window.location.hash.replace(/^#/, "");

package/dist/client/sharing/ShareButton.js

@@ -131,7 +131,7 @@ export function ShareButton(props) {
 function SharePanel(props) {
     const t = useT();
     const { controller } = props;
-    const { inviteEmail, setInviteEmail: onInviteEmailChange, activeShareTab, handleShareTabChange, data, policy, visibility, canManage, role, setRole, notifyPeople, setNotifyPeople, shareMessage, setShareMessage, messageOpen, setMessageOpen, shareError, setShareError, suggestionsOpen, setSuggestionsOpen, inFlight, memberSearch, memberSuggestions, knownMembers, shares, handleVisibility, handleHideInSearch, handleAdd, handleChangeRole, handleRemove, } = controller;
+    const { inviteEmail, setInviteEmail: onInviteEmailChange, activeShareTab, handleShareTabChange, data, policy, visibility, canManage, role, setRole, notifyPeople, setNotifyPeople, shareMessage, setShareMessage, messageOpen, setMessageOpen, shareError, setShareError, suggestionsOpen, setSuggestionsOpen, inFlight, memberSearch, memberSuggestions, groupSuggestions, selectGroup, knownMembers, shares, handleVisibility, handleHideInSearch, handleAdd, handleChangeRole, handleRemove, } = controller;
     const hasInviteEmail = inviteEmail.trim().length > 0;
     const isLoading = data === undefined;
     const meta = visibilityMeta(visibility, t, props.visibilityCopy);
@@ -155,8 +155,13 @@ function SharePanel(props) {
                                             onInviteEmailChange(next);
                                             if (shareError)
                                                 setShareError(null);
-                                        }, onSelectMember: (member) => {
-                                            onInviteEmailChange(member.email);
+                                        }, onSelectSuggestion: (suggestion) => {
+                                            if (suggestion.principalType === "group") {
+                                                selectGroup(suggestion);
+                                            }
+                                            else {
+                                                onInviteEmailChange(suggestion.email);
+                                            }
                                             setSuggestionsOpen(false);
                                             if (shareError)
                                                 setShareError(null);
@@ -165,8 +170,21 @@ function SharePanel(props) {
                                                 defaultValue: "Add people from your organization",
                                             })
                                             : t("agentChat.share.addPeopleEmail", {
-                                                defaultValue: "Add people by email",
-                                            }), suggestions: memberSuggestions, search: memberSearch }), _jsx(RoleSelect, { value: role, onChange: setRole, roleCopy: props.roleCopy, allowedRoles: props.allowedRoles }), _jsx("button", { type: "button", onClick: handleAdd, disabled: !hasInviteEmail, className: BUTTON_PRIMARY_SM, children: t("agentChat.share.add", { defaultValue: "Add" }) })] }), shareError ? (_jsx("div", { role: "alert", className: "rounded-md border border-destructive/40 bg-destructive/10 px-3 py-2 text-xs text-destructive", children: shareError })) : null, hasInviteEmail ? (_jsxs("div", { className: "flex flex-wrap items-center gap-x-3 gap-y-2 text-xs text-muted-foreground", children: [_jsxs("label", { className: "inline-flex items-center gap-2", children: [_jsx("input", { type: "checkbox", checked: notifyPeople, onChange: (e) => setNotifyPeople(e.target.checked), className: "h-4 w-4 rounded border-input accent-primary" }), t("agentChat.share.notifyPeople", {
+                                                defaultValue: policy.supportsGroupShares
+                                                    ? "Add people or groups"
+                                                    : "Add people by email",
+                                            }), suggestions: [
+                                            ...memberSuggestions.map((member) => ({
+                                                ...member,
+                                                principalType: "user",
+                                            })),
+                                            ...(policy.supportsGroupShares
+                                                ? groupSuggestions.map((group) => ({
+                                                    ...group,
+                                                    principalType: "group",
+                                                }))
+                                                : []),
+                                        ], search: memberSearch }), _jsx(RoleSelect, { value: role, onChange: setRole, roleCopy: props.roleCopy, allowedRoles: props.allowedRoles }), _jsx("button", { type: "button", onClick: handleAdd, disabled: !hasInviteEmail, className: BUTTON_PRIMARY_SM, children: t("agentChat.share.add", { defaultValue: "Add" }) })] }), shareError ? (_jsx("div", { role: "alert", className: "rounded-md border border-destructive/40 bg-destructive/10 px-3 py-2 text-xs text-destructive", children: shareError })) : null, hasInviteEmail ? (_jsxs("div", { className: "flex flex-wrap items-center gap-x-3 gap-y-2 text-xs text-muted-foreground", children: [_jsxs("label", { className: "inline-flex items-center gap-2", children: [_jsx("input", { type: "checkbox", checked: notifyPeople, onChange: (e) => setNotifyPeople(e.target.checked), className: "h-4 w-4 rounded border-input accent-primary" }), t("agentChat.share.notifyPeople", {
                                                 defaultValue: "Notify people",
                                             })] }), notifyPeople ? (_jsx("button", { type: "button", "aria-expanded": messageOpen, onClick: () => setMessageOpen(!messageOpen), className: "rounded-sm px-1 py-0.5 font-medium text-foreground underline decoration-border underline-offset-2 transition-colors hover:bg-accent hover:text-accent-foreground", children: messageOpen
                                             ? t("agentChat.share.hideMessage", {
@@ -178,7 +196,7 @@ function SharePanel(props) {
                                         defaultValue: "Message",
                                     }), placeholder: t("agentChat.share.messagePlaceholder", {
                                         defaultValue: "Add a short note (optional)",
-                                    }), value: shareMessage, onChange: (event) => setShareMessage(event.target.value), maxLength: 500, rows: 3, className: "w-full resize-y rounded-md border border-input bg-card px-3 py-2 text-sm text-foreground placeholder:text-muted-foreground focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 focus:ring-offset-background" }) })) : null] })) : null, _jsxs("ul", { className: "flex list-none flex-col gap-1 p-0 m-0", children: [data?.ownerEmail ? (_jsxs("li", { className: "flex items-center gap-3 px-1 py-1.5 text-sm", children: [_jsx(Avatar, { label: displayName(data.ownerEmail, knownMembers, t) }), _jsx("span", { className: "flex-1 min-w-0 truncate", children: displayName(data.ownerEmail, knownMembers, t) }), _jsx("span", { className: "text-xs text-muted-foreground", children: t("agentChat.share.owner", { defaultValue: "Owner" }) })] })) : null, shares.map((s) => (_jsxs("li", { className: cn("flex items-center gap-3 px-1 py-1.5 text-sm", inFlight.has(keyOf(s)) && "opacity-60"), children: [_jsx(Avatar, { label: principalLabel(s, knownMembers, t), org: s.principalType === "org" }), _jsx("span", { className: "flex-1 min-w-0 truncate", children: principalLabel(s, knownMembers, t) }), canManage ? (_jsx(RoleSelect, { value: s.role, onChange: (r) => handleChangeRole(s, r), disabled: inFlight.has(keyOf(s)), plain: true, roleCopy: props.roleCopy, allowedRoles: props.allowedRoles })) : (_jsx("span", { className: "text-xs text-muted-foreground", children: roleMeta(s.role, t, props.roleCopy).label })), canManage ? (_jsx("button", { type: "button", "aria-label": t("agentChat.share.remove", {
+                                    }), value: shareMessage, onChange: (event) => setShareMessage(event.target.value), maxLength: 500, rows: 3, className: "w-full resize-y rounded-md border border-input bg-card px-3 py-2 text-sm text-foreground placeholder:text-muted-foreground focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 focus:ring-offset-background" }) })) : null] })) : null, _jsxs("ul", { className: "flex list-none flex-col gap-1 p-0 m-0", children: [data?.ownerEmail ? (_jsxs("li", { className: "flex items-center gap-3 px-1 py-1.5 text-sm", children: [_jsx(Avatar, { label: displayName(data.ownerEmail, knownMembers, t) }), _jsx("span", { className: "flex-1 min-w-0 truncate", children: displayName(data.ownerEmail, knownMembers, t) }), _jsx("span", { className: "text-xs text-muted-foreground", children: t("agentChat.share.owner", { defaultValue: "Owner" }) })] })) : null, shares.map((s) => (_jsxs("li", { className: cn("flex items-center gap-3 px-1 py-1.5 text-sm", inFlight.has(keyOf(s)) && "opacity-60"), children: [_jsx(Avatar, { label: principalLabel(s, knownMembers, t), org: s.principalType === "org", group: s.principalType === "group" }), _jsx("span", { className: "flex-1 min-w-0 truncate", children: principalLabel(s, knownMembers, t) }), canManage ? (_jsx(RoleSelect, { value: s.role, onChange: (r) => handleChangeRole(s, r), disabled: inFlight.has(keyOf(s)), plain: true, roleCopy: props.roleCopy, allowedRoles: props.allowedRoles })) : (_jsx("span", { className: "text-xs text-muted-foreground", children: roleMeta(s.role, t, props.roleCopy).label })), canManage ? (_jsx("button", { type: "button", "aria-label": t("agentChat.share.remove", {
                                             defaultValue: "Remove",
                                         }), onClick: () => handleRemove(s), disabled: inFlight.has(keyOf(s)), className: BUTTON_GHOST_ICON, children: _jsx(IconTrash, { size: 14 }) })) : null] }, keyOf(s)))), !shares.length && !data?.ownerEmail ? (_jsx("li", { className: "px-1 py-1.5 text-sm text-muted-foreground", children: t("agentChat.share.noAccess", {
                                     defaultValue: "No one has access yet.",
@@ -219,13 +237,13 @@ function AdvancedAccessPopover({ control, canManage, onToggle, }) {
                                                     defaultValue: "People with the link can still open this.",
                                                 }) })] })] })] }) })] }));
 }
-function MemberAutocomplete({ value, open, onOpenChange, onValueChange, onSelectMember, onSubmit, placeholder, suggestions, search, }) {
+function MemberAutocomplete({ value, open, onOpenChange, onValueChange, onSelectSuggestion, onSubmit, placeholder, suggestions, search, }) {
     const t = useT();
     const rawListboxId = useId();
     const listboxId = rawListboxId.replace(/:/g, "");
     const inputRef = useRef(null);
     const [activeIndex, setActiveIndex] = useState(-1);
-    const activeMember = activeIndex >= 0 && activeIndex < suggestions.length
+    const activeSuggestion = activeIndex >= 0 && activeIndex < suggestions.length
         ? suggestions[activeIndex]
         : null;
     useEffect(() => {
@@ -243,8 +261,8 @@ function MemberAutocomplete({ value, open, onOpenChange, onValueChange, onSelect
             .getElementById(optionId(listboxId, activeIndex))
             ?.scrollIntoView({ block: "nearest" });
     }, [activeIndex, listboxId]);
-    const chooseMember = (member) => {
-        onSelectMember(member);
+    const chooseSuggestion = (suggestion) => {
+        onSelectSuggestion(suggestion);
         onOpenChange(false);
         inputRef.current?.focus();
     };
@@ -273,9 +291,9 @@ function MemberAutocomplete({ value, open, onOpenChange, onValueChange, onSelect
             return;
         }
         if (event.key === "Enter") {
-            if (open && activeMember) {
+            if (open && activeSuggestion) {
                 event.preventDefault();
-                chooseMember(activeMember);
+                chooseSuggestion(activeSuggestion);
                 return;
             }
             if (value.trim()) {
@@ -299,7 +317,7 @@ function MemberAutocomplete({ value, open, onOpenChange, onValueChange, onSelect
             search.loadMore();
         }
     };
-    return (_jsxs(Popover, { open: open, onOpenChange: onOpenChange, children: [_jsx(PopoverAnchor, { asChild: true, children: _jsxs("div", { className: "relative flex-1 min-w-0", children: [_jsx(IconSearch, { "aria-hidden": true, size: 15, strokeWidth: 1.8, className: "pointer-events-none absolute start-2.5 top-1/2 -translate-y-1/2 text-muted-foreground" }), _jsx("input", { ref: inputRef, type: "email", role: "combobox", "aria-autocomplete": "list", "aria-expanded": open, "aria-controls": open ? listboxId : undefined, "aria-activedescendant": activeIndex >= 0 ? optionId(listboxId, activeIndex) : undefined, placeholder: placeholder, value: value, onChange: (event) => {
+    return (_jsxs(Popover, { open: open, onOpenChange: onOpenChange, children: [_jsx(PopoverAnchor, { asChild: true, children: _jsxs("div", { className: "relative flex-1 min-w-0", children: [_jsx(IconSearch, { "aria-hidden": true, size: 15, strokeWidth: 1.8, className: "pointer-events-none absolute start-2.5 top-1/2 -translate-y-1/2 text-muted-foreground" }), _jsx("input", { ref: inputRef, type: "text", role: "combobox", "aria-autocomplete": "list", "aria-expanded": open, "aria-controls": open ? listboxId : undefined, "aria-activedescendant": activeIndex >= 0 ? optionId(listboxId, activeIndex) : undefined, placeholder: placeholder, value: value, onChange: (event) => {
                                 onValueChange(event.target.value);
                                 onOpenChange(true);
                             }, onFocus: () => onOpenChange(true), onBlur: () => {
@@ -308,11 +326,15 @@ function MemberAutocomplete({ value, open, onOpenChange, onValueChange, onSelect
                                         onOpenChange(false);
                                     }
                                 }, 0);
-                            }, onKeyDown: handleKeyDown, autoComplete: "off", className: "h-9 w-full min-w-0 rounded-md border border-input bg-card ps-8 pe-8 text-sm text-foreground placeholder:text-muted-foreground focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 focus:ring-offset-background" }), search.isLoading ? (_jsx(IconLoader2, { "aria-hidden": true, size: 15, strokeWidth: 1.8, className: "pointer-events-none absolute end-2.5 top-1/2 -translate-y-1/2 animate-spin text-muted-foreground" })) : null] }) }), _jsx(PopoverContent, { align: "start", sideOffset: 4, "data-agent-native-share-overlay": "", onOpenAutoFocus: (event) => event.preventDefault(), className: cn(SHARE_NESTED_OVERLAY_Z, "w-[var(--radix-popper-anchor-width)] min-w-[18rem] rounded-md p-1 shadow-lg", SHARE_POPOVER_SURFACE), children: _jsxs("div", { id: listboxId, role: "listbox", className: "max-h-56 overflow-y-auto overflow-x-hidden", onScroll: handleScroll, children: [suggestions.map((member, index) => {
+                            }, onKeyDown: handleKeyDown, autoComplete: "off", className: "h-9 w-full min-w-0 rounded-md border border-input bg-card ps-8 pe-8 text-sm text-foreground placeholder:text-muted-foreground focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 focus:ring-offset-background" }), search.isLoading ? (_jsx(IconLoader2, { "aria-hidden": true, size: 15, strokeWidth: 1.8, className: "pointer-events-none absolute end-2.5 top-1/2 -translate-y-1/2 animate-spin text-muted-foreground" })) : null] }) }), _jsx(PopoverContent, { align: "start", sideOffset: 4, "data-agent-native-share-overlay": "", onOpenAutoFocus: (event) => event.preventDefault(), className: cn(SHARE_NESTED_OVERLAY_Z, "w-[var(--radix-popper-anchor-width)] min-w-[18rem] rounded-md p-1 shadow-lg", SHARE_POPOVER_SURFACE), children: _jsxs("div", { id: listboxId, role: "listbox", className: "max-h-56 overflow-y-auto overflow-x-hidden", onScroll: handleScroll, children: [suggestions.map((suggestion, index) => {
                             const active = index === activeIndex;
-                            return (_jsxs("div", { id: optionId(listboxId, index), role: "option", "aria-selected": active, onMouseDown: (event) => event.preventDefault(), onMouseEnter: () => setActiveIndex(index), onClick: () => chooseMember(member), className: cn("flex cursor-pointer select-none flex-col rounded-sm px-3 py-2 text-sm outline-none", active
+                            return (_jsxs("div", { id: optionId(listboxId, index), role: "option", "aria-selected": active, onMouseDown: (event) => event.preventDefault(), onMouseEnter: () => setActiveIndex(index), onClick: () => chooseSuggestion(suggestion), className: cn("flex cursor-pointer select-none flex-col rounded-sm px-3 py-2 text-sm outline-none", active
                                     ? "bg-accent text-accent-foreground"
-                                    : "text-foreground hover:bg-accent hover:text-accent-foreground"), children: [_jsx("span", { className: "truncate font-medium", children: member.name?.trim() || member.email }), member.name?.trim() ? (_jsx("span", { className: "truncate text-xs text-muted-foreground", children: member.email })) : null] }, member.email));
+                                    : "text-foreground hover:bg-accent hover:text-accent-foreground"), children: [_jsxs("span", { className: "flex items-center gap-2 truncate font-medium", children: [suggestion.principalType === "group" ? (_jsx(IconUsersGroup, { "aria-hidden": true, size: 14, strokeWidth: 1.8, className: "shrink-0 text-muted-foreground" })) : null, _jsx("span", { className: "truncate", children: suggestion.principalType === "group"
+                                                    ? suggestion.name
+                                                    : suggestion.name?.trim() || suggestion.email })] }), suggestion.principalType === "group" ? (_jsx("span", { className: "truncate text-xs text-muted-foreground", children: t("agentChat.share.userGroup", {
+                                            defaultValue: "User group",
+                                        }) })) : suggestion.name?.trim() ? (_jsx("span", { className: "truncate text-xs text-muted-foreground", children: suggestion.email })) : null] }, `${suggestion.principalType}:${suggestion.principalType === "group" ? suggestion.id : suggestion.email}`));
                         }), search.isLoading && suggestions.length === 0 ? (_jsx("div", { className: "px-3 py-3 text-sm text-muted-foreground", children: t("agentChat.share.searching", {
                                 defaultValue: "Searching...",
                             }) })) : null, search.error ? (_jsx("div", { className: "px-3 py-3 text-sm text-muted-foreground", children: t("agentChat.share.loadPeopleFailed", {
@@ -375,8 +397,8 @@ function VisibilitySelect(props) {
                                     .description,
                             })) }) }) }) })] }));
 }
-function Avatar({ label, org }) {
-    return (_jsx("span", { "aria-hidden": true, className: "inline-flex h-7 w-7 shrink-0 items-center justify-center rounded-full bg-muted text-[11px] font-semibold text-muted-foreground", children: org ? _jsx(IconUsersGroup, { size: 14, strokeWidth: 1.75 }) : initials(label) }));
+function Avatar({ label, org, group, }) {
+    return (_jsx("span", { "aria-hidden": true, className: "inline-flex h-7 w-7 shrink-0 items-center justify-center rounded-full bg-muted text-[11px] font-semibold text-muted-foreground", children: org || group ? (_jsx(IconUsersGroup, { size: 14, strokeWidth: 1.75 })) : (initials(label)) }));
 }
 function keyOf(s) {
     return `${s.principalType}:${s.principalId}`;
@@ -393,6 +415,9 @@ function principalLabel(share, members, t) {
         return t("agentChat.share.organization", {
             defaultValue: "Organization",
         });
+    if (share.principalType === "group")
+        return (serverLabel ||
+            t("agentChat.share.userGroup", { defaultValue: "User group" }));
     return displayName(share.principalId, members, t);
 }
 function displayName(emailOrId, members, t) {

package/dist/client/sharing/useShareButtonController.d.ts

@@ -1,13 +1,18 @@
-import type { useActionQuery } from "../use-action.js";
+import { useActionQuery } from "../use-action.js";
 export type ShareButtonVisibility = "private" | "org" | "public";
 export type ShareButtonRole = "viewer" | "commenter" | "editor" | "admin";
 export interface ShareButtonShare {
     id: string;
-    principalType: "user" | "org";
+    principalType: "user" | "group" | "org";
     principalId: string;
     displayName?: string | null;
     role: ShareButtonRole;
 }
+export interface ShareButtonGroup {
+    id: string;
+    name: string;
+    memberEmails?: string[];
+}
 export interface ShareButtonSharesResponse {
     ownerEmail: string | null;
     orgId: string | null;
@@ -18,6 +23,7 @@ export interface ShareButtonSharesResponse {
     policy?: {
         allowPublic: boolean;
         requireOrgMemberForUserShares: boolean;
+        supportsGroupShares?: boolean;
     };
 }
 export interface ShareButtonOrgMember {
@@ -65,6 +71,7 @@ export interface ShareButtonController {
     policy: {
         allowPublic: boolean;
         requireOrgMemberForUserShares: boolean;
+        supportsGroupShares?: boolean;
     };
     visibility: ShareButtonVisibility;
     triggerVisibility: ShareButtonVisibility | null;
@@ -84,7 +91,10 @@ export interface ShareButtonController {
     inFlight: Set<string>;
     memberSearch: ShareButtonOrgMemberSearch;
     memberSuggestions: ShareButtonOrgMember[];
+    groupSuggestions: ShareButtonGroup[];
     knownMembers: ShareButtonOrgMember[];
+    selectedGroup: ShareButtonGroup | null;
+    selectGroup: (group: ShareButtonGroup) => void;
     shares: ShareButtonShare[];
     handleVisibility: (visibility: ShareButtonVisibility) => void;
     handleHideInSearch: () => void;

package/dist/client/sharing/useShareButtonController.js

@@ -1,8 +1,10 @@
 import { useCallback, useEffect, useRef, useState } from "react";
+import { useActionQuery } from "../use-action.js";
 import { DEFAULT_MEMBER_SEARCH_DEBOUNCE_MS, DEFAULT_MEMBER_SUGGESTION_LIMIT, extractShareErrorMessage, optimisticallyUpdateShareCache, rollbackShareCache, useShareOrgMemberSearch, useShareMutationGuard, useShareMutations, useShareQuery, } from "./share-controller-helpers.js";
 export function useShareButtonController(options) {
     const [open, setOpen] = useState(false);
     const [inviteEmail, setInviteEmail] = useState("");
+    const [selectedGroup, setSelectedGroup] = useState(null);
     const shareTabDefaultValue = options.shareTabs?.defaultValue ?? "share";
     const [activeShareTab, setActiveShareTab] = useState(shareTabDefaultValue);
     const [visibilityOverride, setVisibilityOverride] = useState(null);
@@ -25,6 +27,7 @@ export function useShareButtonController(options) {
     }, [options, shareTabDefaultValue, sharesQuery, visibilityOverride]);
     useEffect(() => {
         setInviteEmail("");
+        setSelectedGroup(null);
         setShareMessage("");
         setMessageOpen(false);
     }, [options.resourceId, options.resourceType]);
@@ -141,6 +144,10 @@ export function useShareButtonController(options) {
         limit: DEFAULT_MEMBER_SUGGESTION_LIMIT,
         debounceMs: DEFAULT_MEMBER_SEARCH_DEBOUNCE_MS,
     });
+    const groupsQuery = useActionQuery("list-workspace-user-groups", {}, {
+        enabled: canManage && policy.supportsGroupShares === true && suggestionsOpen,
+        staleTime: 30_000,
+    });
     const serverShares = data?.shares ?? [];
     const shares = [
         ...serverShares
@@ -160,7 +167,21 @@ export function useShareButtonController(options) {
         }
     }
     const memberSuggestions = memberSearch.members.filter((member) => !excludedMemberEmails.has(member.email.toLowerCase()));
+    const excludedGroupIds = new Set(shares
+        .filter((share) => share.principalType === "group")
+        .map((share) => share.principalId));
+    const groupSuggestions = (Array.isArray(groupsQuery.data) ? groupsQuery.data : []).filter((group) => !excludedGroupIds.has(group.id) &&
+        (!inviteEmail.trim() ||
+            group.name.toLowerCase().includes(inviteEmail.trim().toLowerCase())));
     const knownMembers = memberSearch.members;
+    const setInviteEmailValue = useCallback((email) => {
+        setSelectedGroup(null);
+        setInviteEmail(email);
+    }, []);
+    const selectGroup = useCallback((group) => {
+        setSelectedGroup(group);
+        setInviteEmail(group.name);
+    }, []);
     const handleVisibility = useCallback((next) => {
         if (next === visibility)
             return;
@@ -189,11 +210,14 @@ export function useShareButtonController(options) {
         const trimmed = inviteEmail.trim();
         if (!trimmed || !canManage)
             return;
-        const message = notifyPeople ? shareMessage.trim() : "";
+        const principalType = selectedGroup ? "group" : "user";
+        const principalId = selectedGroup?.id ?? trimmed;
+        const message = principalType === "user" && notifyPeople ? shareMessage.trim() : "";
         const optimistic = {
-            id: `pending-${trimmed}`,
-            principalType: "user",
-            principalId: trimmed,
+            id: `pending-${principalType}-${principalId}`,
+            principalType,
+            principalId,
+            ...(selectedGroup ? { displayName: selectedGroup.name } : {}),
             role,
         };
         const key = keyOf(optimistic);
@@ -202,6 +226,7 @@ export function useShareButtonController(options) {
         setShareError(null);
         setPendingAdds((previous) => [...previous, optimistic]);
         setInviteEmail("");
+        setSelectedGroup(null);
         setShareMessage("");
         setMessageOpen(false);
         setSuggestionsOpen(false);
@@ -210,10 +235,10 @@ export function useShareButtonController(options) {
         share.mutate({
             resourceType: options.resourceType,
             resourceId: options.resourceId,
-            principalType: "user",
-            principalId: trimmed,
+            principalType,
+            principalId,
             role,
-            notify: notifyPeople,
+            notify: principalType === "user" && notifyPeople,
             resourceUrl: getNotificationUrl(options.shareUrl),
             ...(message ? { message } : {}),
         }, {
@@ -228,6 +253,7 @@ export function useShareButtonController(options) {
                 setPendingAdds((previous) => previous.filter((item) => item.id !== optimistic.id));
                 clearInFlight(key);
                 setInviteEmail(trimmed);
+                setSelectedGroup(selectedGroup);
                 setShareMessage((current) => current || message);
                 setMessageOpen((current) => current || Boolean(message));
                 setShareError(extractShareErrorMessage(error));
@@ -244,6 +270,7 @@ export function useShareButtonController(options) {
         options.resourceType,
         options.shareUrl,
         role,
+        selectedGroup,
         shareMessage,
         share,
         queryClient,
@@ -368,7 +395,7 @@ export function useShareButtonController(options) {
         activeShareTab,
         handleShareTabChange,
         inviteEmail,
-        setInviteEmail,
+        setInviteEmail: setInviteEmailValue,
         sharesQuery,
         visibilityOverride,
         handleVisibilityChange,
@@ -399,6 +426,9 @@ export function useShareButtonController(options) {
         handleAdd,
         handleChangeRole,
         handleRemove,
+        groupSuggestions,
+        selectedGroup,
+        selectGroup,
     };
 }
 function keyOf(share) {

package/dist/client/sse-event-processor.d.ts

@@ -39,10 +39,15 @@ export type ContentPart = {
      * call (opt-in `needsApproval` actions). The action did NOT run; the UI
      * renders an Approve/Deny affordance. `approvalKey` is echoed back in
      * `approvedToolCalls` to approve, `dismissed` records a local Deny.
+     * `askId` identifies THIS gate hit; it changes when a failed resume
+     * re-emits `approval_required` for the same call, which is how the UI
+     * tells that apart from the same ask simply re-rendering (see
+     * `ApprovalAffordance` in chat/tool-call-display.tsx).
      */
     approval?: {
         approvalKey: string;
         dismissed?: boolean;
+        askId?: string;
     };
     /**
      * Structured metadata from the coding-tools executor side-channel.
@@ -70,6 +75,8 @@ export interface SSEEvent {
     approvalKey?: string;
     /** Model-side tool-call id for `approval_required` (mirrors AgentChatEvent). */
     toolCallId?: string;
+    /** Identifies this `approval_required` gate hit (mirrors AgentChatEvent). */
+    askId?: string;
     error?: string;
     seq?: number;
     agent?: string;

package/dist/client/sse-event-processor.js

@@ -1182,7 +1182,10 @@ export function processEvent(ev, content, toolCallCounter, tabId, state) {
             if (idx >= 0) {
                 const part = content[idx];
                 if (part.type === "tool-call") {
-                    part.approval = { approvalKey };
+                    part.approval = {
+                        approvalKey,
+                        ...(ev.askId ? { askId: ev.askId } : {}),
+                    };
                 }
             }
         }

package/dist/client/ui/index.d.ts

@@ -12,6 +12,7 @@ export { ErrorBoundary } from "../ErrorBoundary.js";
 export { ClientOnly } from "../ClientOnly.js";
 export { DefaultSpinner } from "../DefaultSpinner.js";
 export { RuntimeConfigNotice } from "../RuntimeConfigNotice.js";
+export { EnvironmentBadge, buildEnvironmentUrl, isBuilderIoEmployee, resolveEnvironmentChannel, resolveEnvironmentTargets, type EnvironmentBadgeTargets, } from "../EnvironmentBadge.js";
 export { RouteTransitionIndicator, ROUTE_TRANSITION_INDICATOR_DELAY_MS, } from "../RouteTransitionIndicator.js";
 export { applyEmbeddedThemeUpdate, buildEmbeddedThemeUpdate, EMBEDDED_THEME_CHANGE_EVENT, EMBEDDED_THEME_UPDATE_MESSAGE, getThemeInitScript, parseEmbeddedThemeUpdate, themeInitScript, type EmbeddedThemeUpdate, type NormalizedEmbeddedThemeUpdate, type ResolvedTheme, type ThemePreference, } from "../theme.js";
 export { APPEARANCE_PRESETS, applyAppearance, getStoredAppearance, useAppearance, useAppearanceSync, type AppearancePresetId, } from "../appearance.js";

package/dist/client/ui/index.js

@@ -12,6 +12,7 @@ export { ErrorBoundary } from "../ErrorBoundary.js";
 export { ClientOnly } from "../ClientOnly.js";
 export { DefaultSpinner } from "../DefaultSpinner.js";
 export { RuntimeConfigNotice } from "../RuntimeConfigNotice.js";
+export { EnvironmentBadge, buildEnvironmentUrl, isBuilderIoEmployee, resolveEnvironmentChannel, resolveEnvironmentTargets, } from "../EnvironmentBadge.js";
 export { RouteTransitionIndicator, ROUTE_TRANSITION_INDICATOR_DELAY_MS, } from "../RouteTransitionIndicator.js";
 export { applyEmbeddedThemeUpdate, buildEmbeddedThemeUpdate, EMBEDDED_THEME_CHANGE_EVENT, EMBEDDED_THEME_UPDATE_MESSAGE, getThemeInitScript, parseEmbeddedThemeUpdate, themeInitScript, } from "../theme.js";
 export { APPEARANCE_PRESETS, applyAppearance, getStoredAppearance, useAppearance, useAppearanceSync, } from "../appearance.js";

package/dist/client/use-action.js

@@ -52,6 +52,11 @@ function isActionTimeout(error) {
         typeof error === "object" &&
         error.timedOut === true);
 }
+function isActionMethodMismatch(error) {
+    return (!!error &&
+        typeof error === "object" &&
+        error.code === "action_method_mismatch");
+}
 /** @internal exported for tests */
 export function defaultActionQueryRetry(failureCount, error) {
     if (isAuthFailure(error))
@@ -60,6 +65,9 @@ export function defaultActionQueryRetry(failureCount, error) {
     // silently retrying would multiply that wait. Surface it instead.
     if (isActionTimeout(error))
         return false;
+    // Wrong verb is deterministic — retrying sends the same wrong verb again.
+    if (isActionMethodMismatch(error))
+        return false;
     if (isBrowserResourceExhaustion(error))
         return false;
     // Network-level failures never carry an HTTP `status` (actionFetch only
@@ -338,6 +346,24 @@ async function performActionFetch(name, method, params, options) {
             (raw && raw.slice(0, 200)) ||
             res.statusText ||
             `HTTP ${res.status}`;
+        // mountActionRoutes only ever returns 405 for one reason: the verb this
+        // call sent doesn't match the action's declared `http.method`. The client
+        // has no way to look that method up ahead of time (defineAction lives in
+        // server-only modules), so callers routinely default to POST and hit this
+        // blind. Name the action and the required method instead of leaving a
+        // bare 405 for the caller to reverse-engineer from a "Use X" string.
+        if (res.status === 405) {
+            const requiredMethod = /\bUse (GET|POST|PUT|DELETE)\b/.exec(message)?.[1];
+            const error = new Error(`Action ${name} was called with ${method}, but it declares ` +
+                `http: { method: "${requiredMethod ?? "?"}" }. Pass { method: "${requiredMethod ?? "..."}" } ` +
+                `to this call (or use the hook that defaults to it) to match the action's declared method.`);
+            error.status = 405;
+            error.code = "action_method_mismatch";
+            error.sentMethod = method;
+            if (requiredMethod)
+                error.requiredMethod = requiredMethod;
+            throw error;
+        }
         const error = new Error(`Action ${name} failed: ${message}`);
         error.status = res.status;
         throw error;

package/dist/collab/struct-routes.d.ts

@@ -13,8 +13,8 @@
  * Body: { json: any, fieldName?: string, type?: "map"|"array", requestSource?: string }
  */
 export declare const postCollabJson: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    error: string;
     ok?: undefined;
+    error: string;
 } | {
     error?: undefined;
     ok: boolean;