@agent-native/core 0.146.0 → 0.146.1

package/corpus/templates/slides/server/lib/slide-image-insertion.ts

@@ -0,0 +1,141 @@
+interface InsertSlideImageOptions {
+  alt?: string;
+}
+
+function cleanAlt(value: string | undefined): string {
+  return (value || "Uploaded image").replace(/\s+/g, " ").trim();
+}
+
+function escapeAttribute(value: string): string {
+  return value
+    .replace(/&/g, "&")
+    .replace(/"/g, """)
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;");
+}
+
+function decodeHtml(value: string): string {
+  return value
+    .replace(/&quot;/gi, '"')
+    .replace(/&#39;/gi, "'")
+    .replace(/&lt;/gi, "<")
+    .replace(/&gt;/gi, ">")
+    .replace(/&amp;/gi, "&");
+}
+
+function textContent(html: string): string {
+  return decodeHtml(html.replace(/<[^>]+>/g, " "))
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+function attribute(attributes: string, name: string): string | null {
+  const match = attributes.match(
+    new RegExp(`\\b${name}\\s*=\\s*(["'])([\\s\\S]*?)\\1`, "i"),
+  );
+  return match ? match[2] : null;
+}
+
+function hasStyleProperty(style: string, property: string): boolean {
+  return new RegExp(`(?:^|;)\\s*${property}\\s*:`, "i").test(style);
+}
+
+function appendImageStyle(baseStyle: string): string {
+  const declarations = [baseStyle.trim().replace(/;+\s*$/, "")].filter(Boolean);
+  if (!hasStyleProperty(baseStyle, "display"))
+    declarations.push("display: block");
+  if (!hasStyleProperty(baseStyle, "object-fit")) {
+    declarations.push("object-fit: cover");
+  }
+  if (!hasStyleProperty(baseStyle, "min-width"))
+    declarations.push("min-width: 0");
+  return declarations.length > 0 ? `${declarations.join("; ")};` : "";
+}
+
+function imageHtml(src: string, alt: string, style: string): string {
+  return `<img src="${escapeAttribute(src)}" alt="${escapeAttribute(alt)}" class="fmd-img-uploaded"${style ? ` style="${escapeAttribute(style)}"` : ""}>`;
+}
+
+/**
+ * Server-safe counterpart to the editor's image replacement helper. It uses
+ * deterministic string transforms because DOMParser is not available in the
+ * server runtime that executes actions.
+ */
+export function insertImageIntoSlideHtml(
+  content: string,
+  src: string,
+  options: InsertSlideImageOptions = {},
+): string {
+  const openingTags = /<([a-z][\w:-]*)([^>]*)>/gi;
+  for (const match of content.matchAll(openingTags)) {
+    const className = attribute(match[2], "class") || "";
+    if (!/(?:^|\s)fmd-img-placeholder(?:\s|$)/.test(className)) continue;
+
+    const closingTag = new RegExp(`</${match[1]}\\s*>`, "gi");
+    closingTag.lastIndex = (match.index ?? 0) + match[0].length;
+    const closing = closingTag.exec(content);
+    if (!closing || match.index === undefined) continue;
+
+    const style = appendImageStyle(
+      attribute(match[2], "style") ||
+        "width: 100%; height: 100%; border-radius: 8px; object-fit: cover;",
+    );
+    const replacement = imageHtml(
+      src,
+      cleanAlt(
+        options.alt ||
+          textContent(
+            content.slice(match.index + match[0].length, closing.index),
+          ) ||
+          "Uploaded image",
+      ),
+      style,
+    );
+    return `${content.slice(0, match.index)}${replacement}${content.slice(closing.index + closing[0].length)}`;
+  }
+
+  const fullBleed = imageHtml(
+    src,
+    cleanAlt(options.alt),
+    "position: absolute; inset: 0; width: 100%; height: 100%; object-fit: cover; z-index: -1;",
+  );
+  const slideRoot =
+    /<([a-z][\w:-]*)([^>]*\bclass\s*=\s*(["'])[^"']*\bfmd-slide\b[^"']*\3[^>]*)>/i.exec(
+      content,
+    );
+  if (!slideRoot || slideRoot.index === undefined)
+    return `${fullBleed}${content}`;
+
+  let openingTag = slideRoot[0];
+  const style = attribute(slideRoot[2], "style") || "";
+  if (!hasStyleProperty(style, "position")) {
+    const nextStyle =
+      `${style.trim().replace(/;+\s*$/, "")}; position: relative;`.replace(
+        /^;\s*/,
+        "",
+      );
+    if (/\bstyle\s*=\s*(["'])/i.test(openingTag)) {
+      openingTag = openingTag.replace(
+        /\bstyle\s*=\s*(["'])[^"']*\1/i,
+        `style="${escapeAttribute(nextStyle)}"`,
+      );
+    } else {
+      openingTag = openingTag.replace(
+        />$/,
+        ` style="${escapeAttribute(nextStyle)}">`,
+      );
+    }
+  }
+  return `${content.slice(0, slideRoot.index)}${openingTag}${fullBleed}${content.slice(slideRoot.index + slideRoot[0].length)}`;
+}
+
+export function slideHtmlContainsImageSource(
+  html: string,
+  src: string,
+): boolean {
+  const images = /<img\b([^>]*)>/gi;
+  for (const match of html.matchAll(images)) {
+    if (decodeHtml(attribute(match[1], "src") || "") === src) return true;
+  }
+  return false;
+}

package/corpus/templates/slides/server/plugins/agent-chat.ts

@@ -62,6 +62,8 @@ Layout-fit workflow is strict. When the user asks to fix overflow, first call vi
 
 Fit means the main content fits the native content area. A small outer-wrapper spill is tolerated by the measurement, but cards, text, columns, and other visible content must fit. Never use zoom, transform: scale(), overflow: hidden/scroll, clipping, or a smaller-than-16px body font to hide overflow. Preserve manually positioned freeform objects and their data-slide-object-id values; repair normal-flow structure, copy, gaps, or slide padding instead. A successful action result must include the affected slide IDs; if it does not, report that no verified write occurred.
 
+Image workflow is strict. For direct insertion, call generate-image-api with insertIntoSlide: true plus deckId and slideId. Claim that an image was added only when that action returns inserted: true; a preview URL or completed generation alone is not a slide edit. For preview-only variations, call generate-image-api without insertIntoSlide, then use update-slide to place the chosen URL and re-read the target with get-deck to confirm its persisted HTML contains that image source before claiming success.
+
 Provider-specific Slides actions are shortcuts, not limits. If a first-class action cannot express the exact Google Drive endpoint, file metadata field, export format, query, request body, pagination mode, payload shape, or API version needed, call provider-api-catalog and provider-api-docs as needed, then call provider-api-request against the real provider API. Use the raw provider API escape hatch instead of weakening the answer or claiming Slides cannot do something the underlying Google Drive API can do.
 
 Slides' Google Drive provider API uses the user's connected Google Docs OAuth account. The drive.file scope is intentionally limited to files the user selected or the app created. For large Drive file lists or metadata sweeps, pass stageAs and pagination options to provider-api-request, then use query-staged-dataset to count, filter, group, or project the staged rows.

package/corpus/templates/tasks/.agents/skills/turn-into-app/SKILL.md

@@ -27,6 +27,10 @@ The build location depends on the host. Treat this as a hard routing rule:
   `resourceIds` when available. This is the Builder handoff.
 - Do not substitute the generic `create_workspace_app` MCP tool in an online
   host. That tool is a local workspace scaffolder, not the Builder handoff.
+- Connect the Agent-Native Dispatch MCP connector only. Dispatch uses the
+  authenticated Builder Projects API to reuse or provision the workspace
+  project before starting the Builder Cloud Agent; a separate Builder CMS MCP
+  connection is not required for this workflow.
 - If `start-workspace-app-creation` is not available or Dispatch is not
   authenticated, stop with the connector setup needed. Do not fall back to a
   local build or claim that the app exists.

package/corpus/templates/tasks/.agents/skills/turn-into-app/references/fresh-project.md

@@ -50,6 +50,14 @@ skills. For a ChatGPT Project or any host that exposes only the MCP connector,
 also place the skill instructions or this reference in the Project
 instructions/knowledge files. Then add and authenticate the Dispatch MCP
 connector from the packaged `adapters/chatgpt-mcp/connector.json`.
+This single connector is enough: Dispatch provisions or reuses the Builder
+project through the Builder Projects API, so do not ask the user to add a
+separate Builder CMS MCP for app creation.
+Builder's separate Fusion MCP is available as a custom remote connector at
+`https://mcp.builder.io/mcp/fusion` for direct Builder work. It can run an
+existing project, but it cannot provision the repo-backed Agent-Native
+workspace project, so it is optional and not a replacement for the Dispatch
+handoff in this skill. Do not add Builder's CMS MCP for this workflow.
 
 For Claude Web, ChatGPT Web, and their web Projects, the host is an
 orchestrator, not the build environment. After forming the source brief, call

package/dist/client/AgentPanel.d.ts

@@ -38,7 +38,13 @@ export declare function shouldShowAgentPanelSidebarChatTabs(tabs: MultiTabAssist
 export declare function shouldShowAgentPanelPageNewChatButton(tabs: MultiTabAssistantChatHeaderProps["tabs"], activeTabId: string, activeTabMessageCount: number): boolean;
 export declare function shouldShowAgentPanelCliTabBar(cliTabs: string[]): boolean;
 export declare function shouldShowAgentPanelModeButtons(isSidebar: boolean): boolean;
-export declare function shouldShowAgentPanelFullViewAction(agentPageHref: string | undefined, mode: PanelMode, isSidebar?: boolean): boolean;
+export declare function shouldShowAgentPanelFullViewAction(agentPageHref: string | undefined, mode: PanelMode, isSidebar?: boolean, currentPath?: string): boolean;
+export declare function getAgentPanelShortcutHints(isMac: boolean): {
+    closeTab: string;
+    closeAllTabs: string;
+    toggleSidebar: string;
+    widenChat: string;
+};
 export interface AgentPanelCodeAccess {
     /** Whether this surface can safely edit source and run shell commands. */
     enabled: boolean;
@@ -68,7 +74,7 @@ export interface AgentPanelProps extends Omit<AssistantChatProps, "onSwitchToCli
     onCollapse?: () => void;
     /** Whether the panel is currently in fullscreen (Claude-style centered) mode. */
     isFullscreen?: boolean;
-    /** Called when the user clicks the maximize/minimize button. If provided, the button appears next to the collapse button. */
+    /** @deprecated Fullscreen sidebar controls are no longer rendered. */
     onToggleFullscreen?: () => void;
     /** Called when the user asks the sidebar to use the wide chat width preset. */
     onSnapTo75Percent?: () => void;
@@ -180,7 +186,7 @@ export interface AgentSidebarProps {
     storageKey?: string;
     /** Open the sidebar when a chat run is active or reconnects. */
     openOnChatRunning?: boolean;
-    /** Override the fullscreen menu action, for templates with a chat-first page. */
+    /** @deprecated Fullscreen sidebar actions are no longer rendered. */
     onFullscreenRequest?: () => void;
     /** Ambient resource context rendered as a composer chip. */
     scope?: import("./use-chat-threads.js").ChatThreadScope | null;
@@ -199,7 +205,7 @@ export interface AgentSidebarProps {
  * Wraps app content with a toggleable agent sidebar.
  * Use AgentToggleButton in your header to open/close it.
  */
-export declare function AgentSidebar({ children, emptyStateText, suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position, defaultOpen, animateMobile, animateDesktop, chatViewTransition, chatViewTransitionHandoff, storageKey, openOnChatRunning, onFullscreenRequest, scope, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding, }: AgentSidebarProps): React.JSX.Element;
+export declare function AgentSidebar({ children, emptyStateText, suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position, defaultOpen, animateMobile, animateDesktop, chatViewTransition, chatViewTransitionHandoff, storageKey, openOnChatRunning, scope, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding, }: AgentSidebarProps): React.JSX.Element;
 /**
  * Focus the agent chat composer input.
  * Opens the sidebar if closed, then focuses the text input.

package/dist/client/AgentPanel.js

@@ -22,7 +22,7 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
  *   <AgentChatSurface mode="page" className="h-screen" />
  */
 import { Tooltip as DesignSystemTooltip } from "@agent-native/toolkit/design-system";
-import { IconMessageCircle, IconMessageDots, IconTerminal2, IconSettings, IconLayoutSidebarRightCollapse, IconLayoutGrid, IconCheck, IconPlus, IconX, IconDotsVertical, IconHistory, IconArrowsHorizontal, IconArrowsMaximize, IconArrowsMinimize, IconExternalLink, } from "@tabler/icons-react";
+import { IconMessageCircle, IconMessageDots, IconTerminal2, IconSettings, IconLayoutSidebarRightCollapse, IconLayoutGrid, IconCheck, IconPlus, IconX, IconDotsVertical, IconHistory, IconArrowsHorizontal, IconArrowsMaximize, IconExternalLink, } from "@tabler/icons-react";
 import React, { useState, useEffect, useRef, useCallback, useMemo, lazy, Suspense, startTransition, } from "react";
 import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuTrigger, } from "./components/ui/dropdown-menu.js";
 import { normalizeTooltipText } from "./components/ui/tooltip.js";
@@ -240,10 +240,19 @@ export function shouldShowAgentPanelCliTabBar(cliTabs) {
 export function shouldShowAgentPanelModeButtons(isSidebar) {
     return !isSidebar;
 }
-export function shouldShowAgentPanelFullViewAction(agentPageHref, mode, isSidebar = false) {
+export function shouldShowAgentPanelFullViewAction(agentPageHref, mode, isSidebar = false, currentPath) {
     return (Boolean(agentPageHref) &&
+        currentPath !== agentPageHref &&
         (isSidebar || mode === "resources" || mode === "settings"));
 }
+export function getAgentPanelShortcutHints(isMac) {
+    return {
+        closeTab: isMac ? "⌃W" : "⌥W",
+        closeAllTabs: isMac ? "⌃⌥W" : "^⌥W",
+        toggleSidebar: isMac ? "⌘\\" : "^\\",
+        widenChat: isMac ? "⌘⇧\\" : "^⇧\\",
+    };
+}
 function useBuilderConnectUrl() {
     const [connectUrl, setConnectUrl] = useState(null);
     const [configured, setConfigured] = useState(false);
@@ -391,6 +400,7 @@ function CodeAccessUnavailablePanel({ title, description, ctaLabel, ctaHref, sec
 function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, emptyStateText, emptyStateAddon, suggestions, dynamicSuggestions, showHeader = true, onCollapse, isFullscreen, onToggleFullscreen, onSnapTo75Percent, isWideDrawer, onExitWideDrawer, devAppUrl, storageKey, restoreActiveThread = true, scope, showScopeBadge, browserTabId, threadUrlSync, chatNotice, showTabBar = true, showPageNewChatButton = false, allowSettingsMode = true, chatOnly = false, agentPageHref, codeAccess, ...assistantChatProps }) {
     const t = useT();
     const navigate = useNavigate();
+    const location = useLocation();
     const mounted = useClientOnly();
     const onboardingPreviewMode = useOnboardingPreviewMode();
     const showFirstRunOnboarding = SHOW_FIRST_RUN_ONBOARDING || onboardingPreviewMode;
@@ -402,11 +412,7 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
     const panelModeKey = `agent-native-panel-mode${keyPrefix}`;
     const isMac = useMemo(() => typeof navigator !== "undefined" &&
         /Mac|iPhone|iPad/.test(navigator.userAgent), []);
-    const closeTabHint = isMac ? "\u2303W" : "Alt+W";
-    const closeAllTabsHint = isMac ? "\u2303\u2325W" : "Ctrl+Alt+W";
-    const toggleSidebarHint = isMac ? "\u2318\\" : "Ctrl+\\";
-    const widenChatHint = isMac ? "\u2318\u21e7\\" : "Ctrl+Shift+\\";
-    const fullscreenHint = isMac ? "\u2318\u21e7F" : "Ctrl+Shift+F";
+    const { closeTab: closeTabHint, closeAllTabs: closeAllTabsHint, toggleSidebar: toggleSidebarHint, widenChat: widenChatHint, } = getAgentPanelShortcutHints(isMac);
     const [execMode, setExecMode] = useState(() => {
         try {
             const saved = localStorage.getItem(execModeKey);
@@ -651,7 +657,7 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
     const wideDrawerAction = isWideDrawer ? onExitWideDrawer : onSnapTo75Percent;
     const wideDrawerLabel = t(isWideDrawer ? "agentPanel.returnChatToLayout" : "agentPanel.widenChat");
     const showFullViewAction = Boolean(agentPageHref &&
-        shouldShowAgentPanelFullViewAction(agentPageHref, mode, chatOnly));
+        shouldShowAgentPanelFullViewAction(agentPageHref, mode, chatOnly, location.pathname));
     useEffect(() => {
         const handleKeyDown = (event) => {
             if (!(event.metaKey || event.ctrlKey) ||
@@ -667,14 +673,10 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
                 wideDrawerAction();
                 return;
             }
-            if (event.code === "KeyF" && onToggleFullscreen) {
-                event.preventDefault();
-                onToggleFullscreen();
-            }
         };
         document.addEventListener("keydown", handleKeyDown);
         return () => document.removeEventListener("keydown", handleKeyDown);
-    }, [mode, onCollapse, onToggleFullscreen, wideDrawerAction]);
+    }, [mode, onCollapse, wideDrawerAction]);
     const renderHeaderActions = useCallback(({ activeChatSessionId, activeTabId, activeTabMessageCount, addTab, clearActiveTab, closeAllTabs, closeOtherTabs, closeTab, showHistory, tabs, toggleHistory, }) => (_jsxs("div", { className: "relative flex shrink-0 items-center gap-0.5", children: [!onCollapse && SHOW_ONBOARDING && (_jsx(Suspense, { fallback: null, children: _jsx(SetupButton, {}) })), !onCollapse &&
                 (() => {
                     const activeTab = mode === "chat" && activeChatSessionId
@@ -686,11 +688,8 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
                     }
                     return (_jsx(ShareButton, { resourceType: "chat_thread", resourceId: activeTab.id, resourceTitle: activeTab.label || "Chat", shareUrl: getChatThreadShareUrl(activeTab.id), trigger: "icon", triggerClassName: "h-7 w-7" }));
                 })(), feedbackEnabled ? (_jsx(FeedbackButton, { variant: "icon", side: "bottom", align: "end", chatSessionId: activeChatSessionId, chatStorageKey: storageKey, open: feedbackOpen, onOpenChange: setFeedbackOpen, trigger: _jsx("button", { type: "button", tabIndex: -1, "aria-hidden": "true", className: "pointer-events-none absolute end-0 top-full h-px w-px opacity-0" }) })) : null, mode === "chat" && (_jsx(IconTooltip, { content: t("agentPanel.newChat"), children: _jsx("button", { onClick: addTab, "aria-label": t("agentPanel.newChat"), className: "flex h-6 w-6 items-center justify-center rounded text-muted-foreground hover:text-foreground hover:bg-accent/50", children: _jsx(IconPlus, { size: 14 }) }) })), !onCollapse && mode === "cli" && canUseCodeTools && (_jsx(IconTooltip, { content: t("agentPanel.newTerminal"), children: _jsx("button", { onClick: addCliTab, "aria-label": t("agentPanel.newTerminal"), className: "flex h-6 w-6 items-center justify-center rounded text-muted-foreground hover:text-foreground hover:bg-accent/50", children: _jsx(IconPlus, { size: 14 }) }) })), _jsxs(DropdownMenu, { open: headerMenuOpen, onOpenChange: setHeaderMenuOpen, children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsx("button", { className: cn("flex h-6 w-6 items-center justify-center rounded text-muted-foreground hover:text-foreground hover:bg-accent/50", (headerMenuOpen || mode === "settings") &&
-                                "bg-accent text-foreground"), "aria-label": t("agentPanel.panelOptions"), children: _jsx(IconDotsVertical, { size: 14 }) }) }), _jsxs(DropdownMenuContent, { align: "end", sideOffset: 6, className: "w-48", children: [onCollapse && (_jsxs(_Fragment, { children: [_jsxs(DropdownMenuItem, { onSelect: onCollapse, children: [_jsx(IconLayoutSidebarRightCollapse, { size: 14, className: "shrink-0" }), t("agentPanel.collapseSidebar"), _jsx(DropdownMenuShortcut, { children: toggleSidebarHint })] }), _jsx(DropdownMenuSeparator, {})] })), onCollapse && mode === "chat" && wideDrawerAction ? (_jsxs(DropdownMenuItem, { onSelect: wideDrawerAction, children: [_jsx(IconArrowsHorizontal, { size: 14, className: "shrink-0" }), wideDrawerLabel, _jsx(DropdownMenuShortcut, { children: widenChatHint })] })) : null, showFullViewAction && agentPageHref ? (_jsx(DropdownMenuItem, { asChild: true, children: _jsxs(Link, { to: agentPageHref, "aria-label": t("agentPanel.openFullView"), children: [_jsx(IconArrowsMaximize, { size: 14, className: "shrink-0" }), t("agentPanel.openFullView")] }) })) : null, onToggleFullscreen && (_jsxs(DropdownMenuItem, { onSelect: onToggleFullscreen, children: [isFullscreen ? (_jsx(IconArrowsMinimize, { size: 14, className: "shrink-0" })) : (_jsx(IconArrowsMaximize, { size: 14, className: "shrink-0" })), isFullscreen
-                                        ? t("agentPanel.exitFullscreen")
-                                        : t("agentPanel.fullscreen"), _jsx(DropdownMenuShortcut, { children: fullscreenHint })] })), (onCollapse && mode === "chat" && wideDrawerAction) ||
-                                showFullViewAction ||
-                                onToggleFullscreen ? (_jsx(DropdownMenuSeparator, {})) : null, onCollapse && mode === "chat" && (_jsxs(DropdownMenuItem, { onSelect: addTab, children: [_jsx(IconPlus, { size: 14, className: "shrink-0" }), t("agentPanel.newChat")] })), mode === "chat" && toggleHistory && (_jsxs(DropdownMenuItem, { onSelect: toggleHistory, children: [_jsx(IconHistory, { size: 14, className: "shrink-0" }), showHistory
+                                "bg-accent text-foreground"), "aria-label": t("agentPanel.panelOptions"), children: _jsx(IconDotsVertical, { size: 14 }) }) }), _jsxs(DropdownMenuContent, { align: "end", sideOffset: 6, className: "w-48", children: [onCollapse && (_jsxs(_Fragment, { children: [_jsxs(DropdownMenuItem, { onSelect: onCollapse, children: [_jsx(IconLayoutSidebarRightCollapse, { size: 14, className: "shrink-0" }), t("agentPanel.collapseSidebar"), _jsx(DropdownMenuShortcut, { children: toggleSidebarHint })] }), _jsx(DropdownMenuSeparator, {})] })), onCollapse && mode === "chat" && wideDrawerAction ? (_jsxs(DropdownMenuItem, { onSelect: wideDrawerAction, children: [_jsx(IconArrowsHorizontal, { size: 14, className: "shrink-0" }), wideDrawerLabel, _jsx(DropdownMenuShortcut, { children: widenChatHint })] })) : null, showFullViewAction && agentPageHref ? (_jsx(DropdownMenuItem, { asChild: true, children: _jsxs(Link, { to: agentPageHref, "aria-label": t("agentPanel.openFullView"), children: [_jsx(IconArrowsMaximize, { size: 14, className: "shrink-0" }), t("agentPanel.openFullView")] }) })) : null, (onCollapse && mode === "chat" && wideDrawerAction) ||
+                                showFullViewAction ? (_jsx(DropdownMenuSeparator, {})) : null, onCollapse && mode === "chat" && (_jsxs(DropdownMenuItem, { onSelect: addTab, children: [_jsx(IconPlus, { size: 14, className: "shrink-0" }), t("agentPanel.newChat")] })), mode === "chat" && toggleHistory && (_jsxs(DropdownMenuItem, { onSelect: toggleHistory, children: [_jsx(IconHistory, { size: 14, className: "shrink-0" }), showHistory
                                         ? t("agentPanel.hideChats")
                                         : t("agentPanel.allChats")] })), mode === "chat" && (_jsx(RunsTrayMenuItem, { pollMs: 0, limit: 12, showRecent: true, onOpenThread: openRunThread })), mode === "chat" && _jsx(DropdownMenuSeparator, {}), mode === "cli" && availableClis.length > 0 && (_jsxs(_Fragment, { children: [availableClis.map((cli) => (_jsxs(DropdownMenuItem, { onSelect: () => selectCli(cli.command), className: cn(cli.command === selectedCli
                                             ? "font-medium"
@@ -715,14 +714,12 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
         feedbackEnabled,
         getChatThreadShareUrl,
         headerMenuOpen,
-        isFullscreen,
         isWideDrawer,
         mode,
         agentPageHref,
         onCollapse,
         onExitWideDrawer,
         onSnapTo75Percent,
-        onToggleFullscreen,
         openRunThread,
         selectCli,
         selectedCli,
@@ -732,7 +729,6 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
         wideDrawerAction,
         wideDrawerLabel,
         widenChatHint,
-        fullscreenHint,
         showFullViewAction,
     ]);
     const renderPageChatOverlay = useCallback(({ activeTabId, activeTabMessageCount, addTab, tabs, }) => {
@@ -939,13 +935,11 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
 }
 // ─── Resize handle ──────────────────────────────────────────────────────────
 const SIDEBAR_STORAGE_KEY = "agent-native-sidebar-width";
-const SIDEBAR_FULLSCREEN_KEY = "agent-native-sidebar-fullscreen";
 const SIDEBAR_DRAWER_KEY = "agent-native-sidebar-wide-drawer";
 const SIDEBAR_DRAWER_PLACEHOLDER_KEY = "agent-native-sidebar-drawer-placeholder-width";
 const SIDEBAR_ANIMATION_MS = 260;
 const SIDEBAR_OVERLAY_Z_INDEX = 70;
 const SIDEBAR_DRAWER_Z_INDEX = 80;
-const SIDEBAR_FULLSCREEN_Z_INDEX = 90;
 const SIDEBAR_DRAWER_VIEW_TRANSITION_NAME = "agent-native-sidebar-drawer";
 /** Shared max width of the centered fullscreen chat column and composer. */
 const FULLSCREEN_CHAT_COLUMN_MAX_PX = 684;
@@ -1365,7 +1359,7 @@ export function AgentChatSurface({ mode = "panel", className, defaultMode = "cha
  * Wraps app content with a toggleable agent sidebar.
  * Use AgentToggleButton in your header to open/close it.
  */
-export function AgentSidebar({ children, emptyStateText = "How can I help you?", suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position = "right", defaultOpen = false, animateMobile = true, animateDesktop = true, chatViewTransition = false, chatViewTransitionHandoff = false, storageKey, openOnChatRunning = false, onFullscreenRequest, scope, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding = false, }) {
+export function AgentSidebar({ children, emptyStateText = "How can I help you?", suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position = "right", defaultOpen = false, animateMobile = true, animateDesktop = true, chatViewTransition = false, chatViewTransitionHandoff = false, storageKey, openOnChatRunning = false, scope, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding = false, }) {
     const onboardingPreviewMode = useOnboardingPreviewMode();
     const showFirstRunOnboarding = !suppressFirstRunOnboarding &&
         (SHOW_FIRST_RUN_ONBOARDING || onboardingPreviewMode);
@@ -1399,20 +1393,6 @@ export function AgentSidebar({ children, emptyStateText = "How can I help you?",
     });
     const drawerExitTimerRef = useRef(null);
     const [isResizing, setIsResizing] = useState(false);
-    const [fullscreen, setFullscreen] = useState(() => {
-        // Force-disable on mobile: a Claude-style centered column makes no sense
-        // when the sidebar already covers most of the viewport.
-        if (typeof window !== "undefined" &&
-            window.matchMedia("(max-width: 767px)").matches) {
-            return false;
-        }
-        try {
-            return localStorage.getItem(SIDEBAR_FULLSCREEN_KEY) === "true";
-        }
-        catch {
-            return false;
-        }
-    });
     // Track mobile viewport so we can switch to overlay mode.
     const [isMobile, setIsMobile] = useState(() => typeof window !== "undefined" &&
         window.matchMedia("(max-width: 767px)").matches);
@@ -1458,16 +1438,6 @@ export function AgentSidebar({ children, emptyStateText = "How can I help you?",
         if (openOnChatRunning)
             setOpen(true);
     }, [openOnChatRunning]);
-    const toggleFullscreen = useCallback(() => {
-        setFullscreen((prev) => {
-            const next = !prev;
-            try {
-                localStorage.setItem(SIDEBAR_FULLSCREEN_KEY, String(next));
-            }
-            catch { }
-            return next;
-        });
-    }, []);
     // Track whether the frame is controlling the sidebar (code mode = frame active).
     // Default to true when inside an iframe — assume the frame sidebar is active
     // until told otherwise. This prevents both sidebars flashing after hot reloads.
@@ -1769,13 +1739,9 @@ export function AgentSidebar({ children, emptyStateText = "How can I help you?",
     const handleResizeStart = useCallback(() => setIsResizing(true), []);
     const handleResizeEnd = useCallback(() => setIsResizing(false), []);
     const isLeft = position === "left";
-    // Fullscreen only applies on desktop — on mobile the existing overlay is
-    // already viewport-covering, so the maximize button is hidden and the
-    // mounted state ignores any persisted value.
-    const effectiveFullscreen = !onFullscreenRequest && fullscreen && !isMobile;
-    const wideDrawerEnabled = isWideDrawer && !isMobile && !effectiveFullscreen;
-    const mobileAnimationEnabled = !presentationMode && !effectiveFullscreen && isMobile && animateMobile;
-    const desktopAnimationEnabled = !presentationMode && !effectiveFullscreen && !isMobile && animateDesktop;
+    const wideDrawerEnabled = isWideDrawer && !isMobile;
+    const mobileAnimationEnabled = !presentationMode && isMobile && animateMobile;
+    const desktopAnimationEnabled = !presentationMode && !isMobile && animateDesktop;
     const sidebarAnimationEnabled = mobileAnimationEnabled || desktopAnimationEnabled;
     const [renderAnimatedPanel, setRenderAnimatedPanel] = useState(shouldMountPanel);
     useEffect(() => {
@@ -1804,17 +1770,15 @@ export function AgentSidebar({ children, emptyStateText = "How can I help you?",
     const panelOpen = open && shouldMountPanel;
     const panelLayout = isMobile
         ? "mobile"
-        : effectiveFullscreen
-            ? "fullscreen"
-            : wideDrawerEnabled
-                ? "drawer"
-                : "desktop";
+        : wideDrawerEnabled
+            ? "drawer"
+            : "desktop";
     // On desktop the resize handle is also the visual divider. Avoid painting a
     // second panel border next to it.
-    const showResizeHandle = !isMobile && !effectiveFullscreen && !wideDrawerEnabled && panelOpen;
+    const showResizeHandle = !isMobile && !wideDrawerEnabled && panelOpen;
     // On mobile the sidebar floats as a fixed overlay so the content below isn't
-    // squashed. On desktop it participates in the flex layout as before, except
-    // in fullscreen mode where it overlays the entire viewport (Claude-style).
+    // squashed. On desktop it participates in the flex layout or becomes a
+    // fixed-width drawer when the user asks for more room.
     let panelStyle;
     if (isMobile) {
         panelStyle = {
@@ -1836,18 +1800,6 @@ export function AgentSidebar({ children, emptyStateText = "How can I help you?",
             pointerEvents: mobileAnimationEnabled && !panelOpen ? "none" : undefined,
         };
     }
-    else if (effectiveFullscreen) {
-        panelStyle = {
-            ...AGENT_PANEL_ROOT_STYLE,
-            position: "fixed",
-            inset: 0,
-            width: "100%",
-            maxHeight: "var(--agent-native-viewport-height, 100vh)",
-            zIndex: SIDEBAR_FULLSCREEN_Z_INDEX,
-            background: "hsl(var(--background))",
-            display: open ? "flex" : "none",
-        };
-    }
     else if (wideDrawerEnabled) {
         panelStyle = {
             ...AGENT_PANEL_ROOT_STYLE,
@@ -1898,16 +1850,11 @@ export function AgentSidebar({ children, emptyStateText = "How can I help you?",
                             ? "desktop"
                             : undefined, "data-agent-sidebar-layout": panelLayout, "data-agent-sidebar-position": position, "data-agent-sidebar-state": panelOpen ? "open" : "closed", "data-agent-sidebar-resizing": isResizing ? "true" : undefined, "data-agent-sidebar-chat-handoff": chatViewTransitionHandoff ? "true" : undefined, style: chatViewTransition
                     ? getAgentChatViewTransitionStyle(panelStyle)
-                    : panelStyle, inert: sidebarAnimationEnabled && !panelOpen ? true : undefined, "aria-hidden": sidebarAnimationEnabled && !panelOpen ? true : undefined, children: _jsx("div", { className: "agent-sidebar-panel-inner flex min-h-0 flex-1 flex-col", children: _jsx(AgentPanel, { emptyStateText: emptyStateText, suggestions: suggestions, dynamicSuggestions: dynamicSuggestions, composerToolbarSlot: composerToolbarSlot, composerSlot: composerSlot, onComposerTextChange: onComposerTextChange, imageModelMenu: imageModelMenu, threadFooterSlot: threadFooterSlot, missingApiKeySetupLayout: "sidebar", onCollapse: () => setOpenPersisted(false), isFullscreen: effectiveFullscreen, onToggleFullscreen: isMobile ? undefined : (onFullscreenRequest ?? toggleFullscreen), onSnapTo75Percent: isMobile ? undefined : snapTo75Percent, isWideDrawer: isMobile ? false : isWideDrawer, onExitWideDrawer: isMobile ? undefined : exitWideDrawer, storageKey: storageKey, scope: scope, showScopeBadge: showScopeBadge, browserTabId: browserTabId, threadUrlSync: threadUrlSync, agentPageHref: agentPageHref, allowSettingsMode: false, chatOnly: true }) }) }), showResizeHandle && isLeft && (_jsx(ResizeHandle, { position: position, onDrag: handleDrag, onResizeStart: handleResizeStart, onResizeEnd: handleResizeEnd }))] })) : null;
+                    : panelStyle, inert: sidebarAnimationEnabled && !panelOpen ? true : undefined, "aria-hidden": sidebarAnimationEnabled && !panelOpen ? true : undefined, children: _jsx("div", { className: "agent-sidebar-panel-inner flex min-h-0 flex-1 flex-col", children: _jsx(AgentPanel, { emptyStateText: emptyStateText, suggestions: suggestions, dynamicSuggestions: dynamicSuggestions, composerToolbarSlot: composerToolbarSlot, composerSlot: composerSlot, onComposerTextChange: onComposerTextChange, imageModelMenu: imageModelMenu, threadFooterSlot: threadFooterSlot, missingApiKeySetupLayout: "sidebar", onCollapse: () => setOpenPersisted(false), onSnapTo75Percent: isMobile ? undefined : snapTo75Percent, isWideDrawer: isMobile ? false : isWideDrawer, onExitWideDrawer: isMobile ? undefined : exitWideDrawer, storageKey: storageKey, scope: scope, showScopeBadge: showScopeBadge, browserTabId: browserTabId, threadUrlSync: threadUrlSync, agentPageHref: agentPageHref, allowSettingsMode: false, chatOnly: true }) }) }), showResizeHandle && isLeft && (_jsx(ResizeHandle, { position: position, onDrag: handleDrag, onResizeStart: handleResizeStart, onResizeEnd: handleResizeEnd }))] })) : null;
     const drawerPlaceholder = wideDrawerEnabled && !presentationMode && shouldRenderPanel ? (_jsx("div", { "aria-hidden": "true", className: "agent-sidebar-drawer-placeholder shrink-0", "data-agent-sidebar-placeholder": "true", style: { width: drawerPlaceholderWidth + 1 } })) : null;
     return (_jsx(AgentSidebarOnboardingContext.Provider, { value: true, children: _jsxs(RealtimeVoiceModeProvider, { browserTabId: browserTabId, children: [showFirstRunOnboarding && (_jsx(Suspense, { fallback: null, children: _jsx(FirstRunOnboarding, {}) })), _jsxs("div", { className: "agent-sidebar-shell flex min-w-0 flex-1 h-screen overflow-hidden", "data-agent-sidebar-position": position, "data-agent-sidebar-resizing": isResizing ? "true" : undefined, children: [isMobile &&
                             !presentationMode &&
-                            (mobileAnimationEnabled ? shouldRenderPanel : open) && (_jsx("div", { className: cn("agent-sidebar-backdrop fixed inset-0 bg-foreground/40", mobileAnimationEnabled && !panelOpen && "pointer-events-none"), "data-agent-sidebar-animation": mobileAnimationEnabled ? "mobile" : undefined, "data-agent-sidebar-state": panelOpen ? "open" : "closed", style: { zIndex: SIDEBAR_OVERLAY_Z_INDEX - 1 }, onClick: () => setOpenPersisted(false) })), shouldMountPanel ? _jsx(URLSync, { browserTabId: browserTabId }) : null, isLeft && !presentationMode ? sidebar : null, isLeft && !presentationMode ? drawerPlaceholder : null, _jsx("div", { className: "agent-sidebar-main-surface flex flex-1 flex-col overflow-auto min-w-0", "data-agent-sidebar-main-position": position, "data-agent-sidebar-main-state": !isMobile &&
-                                !effectiveFullscreen &&
-                                !presentationMode &&
-                                panelOpen
-                                ? "open"
-                                : "closed", "data-agent-sidebar-resizing": isResizing ? "true" : undefined, children: _jsx(ScreenRefreshBoundary, { children: children }) }), !isLeft && !presentationMode ? drawerPlaceholder : null, !isLeft && !presentationMode ? sidebar : null] })] }) }));
+                            (mobileAnimationEnabled ? shouldRenderPanel : open) && (_jsx("div", { className: cn("agent-sidebar-backdrop fixed inset-0 bg-foreground/40", mobileAnimationEnabled && !panelOpen && "pointer-events-none"), "data-agent-sidebar-animation": mobileAnimationEnabled ? "mobile" : undefined, "data-agent-sidebar-state": panelOpen ? "open" : "closed", style: { zIndex: SIDEBAR_OVERLAY_Z_INDEX - 1 }, onClick: () => setOpenPersisted(false) })), shouldMountPanel ? _jsx(URLSync, { browserTabId: browserTabId }) : null, isLeft && !presentationMode ? sidebar : null, isLeft && !presentationMode ? drawerPlaceholder : null, _jsx("div", { className: "agent-sidebar-main-surface flex flex-1 flex-col overflow-auto min-w-0", "data-agent-sidebar-main-position": position, "data-agent-sidebar-main-state": !isMobile && !presentationMode && panelOpen ? "open" : "closed", "data-agent-sidebar-resizing": isResizing ? "true" : undefined, children: _jsx(ScreenRefreshBoundary, { children: children }) }), !isLeft && !presentationMode ? drawerPlaceholder : null, !isLeft && !presentationMode ? sidebar : null] })] }) }));
 }
 /**
  * Focus the agent chat composer input.

package/dist/collab/awareness.d.ts

@@ -62,11 +62,11 @@ export declare const postAwareness: import("h3").EventHandlerWithFetch<import("h
     error: string;
     states?: undefined;
 } | {
-    error?: undefined;
     states: {
         clientId: number;
         state: string;
     }[];
+    error?: undefined;
 }>>;
 /**
  * GET /_agent-native/collab/:docId/users
@@ -77,9 +77,9 @@ export declare const getActiveUsers: import("h3").EventHandlerWithFetch<import("
     error: string;
     users?: undefined;
 } | {
-    error?: undefined;
     users: {
         clientId: number;
         lastSeen: number;
     }[];
+    error?: undefined;
 }>>;

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;

package/dist/db/migrations.js

@@ -245,11 +245,28 @@ function isServerlessRequestRuntime() {
         process.env.VERCEL === "1");
 }
 /**
- * A runtime that is ALLOWED to migrate: scheduled jobs and durable background
- * workers, which are off the request path and may take as long as they need.
+ * Whether this app migrates at RELEASE time, so skipping on the request path
+ * is safe.
  *
- * Set by whichever runtime claims migration duty. Analytics sets its own
- * equivalent flag before running the scheduled rollup.
+ * Without this, "skip in serverless" silently means "never migrate" for any app
+ * that has no release entrypoint — and at the time this was written exactly one
+ * of seventeen templates had one. Existing tables keep working, so nothing
+ * fails; a newly added migration just never applies, and a fresh deploy comes
+ * up with missing tables. That is a skip indistinguishable from success, which
+ * is the failure mode this repo bans.
+ *
+ * So the request-path skip is opt-in per app. An app sets this once it owns a
+ * release migration step (see templates/analytics/scripts/migrate-production.ts
+ * and the `migrate:production` build step in its netlify.toml).
+ */
+function appMigratesAtRelease() {
+    const raw = process.env.AGENT_NATIVE_RELEASE_MIGRATIONS?.trim();
+    return !!raw && ["1", "true", "yes", "on"].includes(raw.toLowerCase());
+}
+/**
+ * A runtime that is ALLOWED to migrate: release scripts, scheduled jobs, and
+ * durable background workers, which are off the request path and may take as
+ * long as they need. Claimed with {@link withMigrationRuntime}.
  */
 function isMigrationAuthorizedRuntime() {
     return (globalThis.__AGENT_NATIVE_MIGRATION_RUNTIME__ === true);
@@ -322,6 +339,7 @@ export function runMigrations(migrations, options) {
         // the explicit opt-in for a caller that genuinely cannot defer.
         if (options?.runInServerlessRequest !== true &&
             isServerlessRequestRuntime() &&
+            appMigratesAtRelease() &&
             !isMigrationAuthorizedRuntime()) {
             console.info(`[migrations] Skipping "${table}" migrations in a serverless request runtime`);
             return;

package/dist/deploy/build.d.ts

@@ -312,3 +312,4 @@ export declare function resolveNitroBundledYjsEntry(): string;
  * the small set above bundled to keep their package manifests traceable.
  */
 export declare function nitroNoExternalsForPreset(targetPreset: string): true | readonly string[];
+export declare function resolveNitroBuildReplacements(env?: NodeJS.ProcessEnv): Record<string, string>;