@agent-native/core 0.146.8 → 0.147.0

package/dist/client/app-providers.js

@@ -52,7 +52,9 @@ import { Toaster } from "@agent-native/toolkit/ui/sonner";
 import { TooltipProvider } from "@radix-ui/react-tooltip";
 import { QueryClientProvider } from "@tanstack/react-query";
 import { ThemeProvider } from "next-themes";
+import { useEffect, useRef } from "react";
 import { useInRouterContext } from "react-router";
+import { isHumanReadableDocumentTitle, normalizeDocumentTitle, } from "../shared/document-title.js";
 import { ClientOnly } from "./ClientOnly.js";
 import { DefaultSpinner } from "./DefaultSpinner.js";
 import { AgentNativeI18nProvider, } from "./i18n.js";
@@ -67,14 +69,57 @@ function RoutedAppEnhancements() {
         return null;
     return (_jsxs(_Fragment, { children: [_jsx(AgentNativeRouteWarmup, {}), _jsx(RouteTransitionIndicator, {})] }));
 }
-function ProvidersInner({ queryClient, defaultTheme = "system", themeAttribute = "class", tooltipDelayDuration, toaster = DEFAULT_TOASTER, disableThemeTransitions = true, i18n, children, }) {
+function readDocumentTitleFallback() {
+    const selectors = [
+        'meta[name="application-name"]',
+        'meta[name="apple-mobile-web-app-title"]',
+        'meta[property="og:site_name"]',
+    ];
+    const metadataTitle = selectors
+        .map((selector) => document.querySelector(selector)?.content ?? "")
+        .find((title) => isHumanReadableDocumentTitle(title));
+    return normalizeDocumentTitle(metadataTitle, "Agent Native");
+}
+/** Repairs route metadata that would otherwise expose a structured payload in the tab. */
+function DocumentTitleGuard({ fallbackTitle }) {
+    const initialTitleRef = useRef(null);
+    if (initialTitleRef.current === null && typeof document !== "undefined") {
+        const initialTitle = document.title.trim();
+        if (isHumanReadableDocumentTitle(initialTitle)) {
+            initialTitleRef.current = initialTitle;
+        }
+    }
+    useEffect(() => {
+        let lastKnownTitle = normalizeDocumentTitle(initialTitleRef.current ?? fallbackTitle ?? readDocumentTitleFallback(), fallbackTitle ?? "Agent Native");
+        const repairTitle = () => {
+            const currentTitle = document.title.trim();
+            if (isHumanReadableDocumentTitle(currentTitle)) {
+                lastKnownTitle = currentTitle;
+                return;
+            }
+            const nextTitle = normalizeDocumentTitle(lastKnownTitle, "Agent Native");
+            if (currentTitle !== nextTitle)
+                document.title = nextTitle;
+        };
+        repairTitle();
+        const observer = new MutationObserver(repairTitle);
+        observer.observe(document.head, {
+            characterData: true,
+            childList: true,
+            subtree: true,
+        });
+        return () => observer.disconnect();
+    }, [fallbackTitle]);
+    return null;
+}
+function ProvidersInner({ queryClient, defaultTheme = "system", themeAttribute = "class", tooltipDelayDuration, toaster = DEFAULT_TOASTER, disableThemeTransitions = true, i18n, documentTitleFallback, children, }) {
     const localizedChildren = i18n === false ? (children) : (_jsx(AgentNativeI18nProvider, { ...(i18n ?? {}), children: children }));
-    return (_jsx(QueryClientProvider, { client: queryClient, children: _jsx(ThemeProvider, { attribute: themeAttribute, defaultTheme: defaultTheme, enableSystem: true, disableTransitionOnChange: disableThemeTransitions, children: _jsxs(TooltipProvider, { delayDuration: tooltipDelayDuration, children: [localizedChildren, _jsx(RuntimeConfigNotice, {}), _jsx(RoutedAppEnhancements, {}), toaster] }) }) }));
+    return (_jsx(QueryClientProvider, { client: queryClient, children: _jsx(ThemeProvider, { attribute: themeAttribute, defaultTheme: defaultTheme, enableSystem: true, disableTransitionOnChange: disableThemeTransitions, children: _jsxs(TooltipProvider, { delayDuration: tooltipDelayDuration, children: [localizedChildren, _jsx(DocumentTitleGuard, { fallbackTitle: documentTitleFallback }), _jsx(RuntimeConfigNotice, {}), _jsx(RoutedAppEnhancements, {}), toaster] }) }) }));
 }
-export function AppProviders({ queryClient, isPublicPath = false, clientOnlyFallback, sessionBypass = false, defaultTheme, themeAttribute, tooltipDelayDuration, toaster, disableThemeTransitions, i18n, children, }) {
+export function AppProviders({ queryClient, isPublicPath = false, clientOnlyFallback, sessionBypass = false, defaultTheme, themeAttribute, tooltipDelayDuration, toaster, disableThemeTransitions, i18n, documentTitleFallback, children, }) {
     const fallback = clientOnlyFallback ?? _jsx(DefaultSpinner, {});
     if (isPublicPath) {
-        return (_jsx(ProvidersInner, { queryClient: queryClient, defaultTheme: defaultTheme, themeAttribute: themeAttribute, tooltipDelayDuration: tooltipDelayDuration, toaster: toaster, disableThemeTransitions: disableThemeTransitions, i18n: i18n, children: children }));
+        return (_jsx(ProvidersInner, { queryClient: queryClient, defaultTheme: defaultTheme, themeAttribute: themeAttribute, tooltipDelayDuration: tooltipDelayDuration, toaster: toaster, disableThemeTransitions: disableThemeTransitions, i18n: i18n, documentTitleFallback: documentTitleFallback, children: children }));
     }
-    return (_jsx(ClientOnly, { fallback: fallback, children: _jsx(ProvidersInner, { queryClient: queryClient, defaultTheme: defaultTheme, themeAttribute: themeAttribute, tooltipDelayDuration: tooltipDelayDuration, toaster: toaster, disableThemeTransitions: disableThemeTransitions, i18n: i18n, children: _jsx(RequireSession, { bypass: sessionBypass, fallback: fallback, children: children }) }) }));
+    return (_jsx(ClientOnly, { fallback: fallback, children: _jsx(ProvidersInner, { queryClient: queryClient, defaultTheme: defaultTheme, themeAttribute: themeAttribute, tooltipDelayDuration: tooltipDelayDuration, toaster: toaster, disableThemeTransitions: disableThemeTransitions, i18n: i18n, documentTitleFallback: documentTitleFallback, children: _jsx(RequireSession, { bypass: sessionBypass, fallback: fallback, children: children }) }) }));
 }

package/dist/client/chat/runtime.js

@@ -1,4 +1,5 @@
 import { agentNativePath } from "../api-path.js";
+import { emitChatFirstOpenApp, emitChatFirstOpenBrowser, } from "../chat-first.js";
 import { formatChatErrorText, normalizeChatError } from "../error-format.js";
 import { settleInterruptedToolCalls, } from "../sse-event-processor.js";
 const DEFAULT_RUNTIME_CAPABILITIES = {
@@ -977,6 +978,7 @@ export function createAgentChatRuntimeAdapter(runtime, options = {}) {
             };
             try {
                 for await (const event of turn.events) {
+                    emitChatFirstOpenAppFromRuntimeEvent(event);
                     const result = applyRuntimeEventToContent(event, projection);
                     if (result) {
                         const metadata = (result.metadata ?? {});
@@ -1007,3 +1009,64 @@ export function createAgentChatRuntimeAdapter(runtime, options = {}) {
         },
     };
 }
+function emitChatFirstOpenAppFromRuntimeEvent(event) {
+    if (event.type !== "tool-done")
+        return;
+    const toolEvent = event;
+    if (toolEvent.status !== "completed" ||
+        (!isOpenAppTool(toolEvent.toolName) &&
+            !isOpenBrowserTool(toolEvent.toolName))) {
+        return;
+    }
+    const result = asRecord(toolEvent.result) ?? parseResultRecord(toolEvent.resultText);
+    if (!result) {
+        console.warn(`[chat-first] ${toolEvent.toolName} completed without a readable result`);
+        return;
+    }
+    if (isOpenBrowserTool(toolEvent.toolName)) {
+        const delivery = emitChatFirstOpenBrowser({
+            url: readString(result.url ?? result.href),
+            title: readString(result.title ?? result.name),
+        });
+        warnWhenChatFirstDeliveryIsNotObserved(toolEvent.toolName, delivery);
+        return;
+    }
+    const detail = {
+        app: readString(result.app ?? result.appId ?? result.application),
+        path: readString(result.path ?? result.targetPath),
+        url: readString(result.url ?? result.href),
+        view: readString(result.view),
+    };
+    const delivery = emitChatFirstOpenApp(detail);
+    warnWhenChatFirstDeliveryIsNotObserved(toolEvent.toolName, delivery);
+}
+function warnWhenChatFirstDeliveryIsNotObserved(toolName, delivery) {
+    if (delivery.delivered)
+        return;
+    console.warn(`[chat-first] ${toolName} was completed but not delivered (${delivery.reason ?? "unknown"})`);
+}
+function isOpenAppTool(toolName) {
+    return toolName === "open_app";
+}
+function isOpenBrowserTool(toolName) {
+    return toolName === "open_browser";
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+function readString(value) {
+    return typeof value === "string" && value.trim() ? value : undefined;
+}
+function parseResultRecord(value) {
+    if (!value?.trim())
+        return null;
+    try {
+        return asRecord(JSON.parse(value));
+    }
+    catch {
+        // coercion-ok: malformed tool output is an unreadable absence; the caller logs it.
+        return null;
+    }
+}

package/dist/client/chat-first/agents-pane.d.ts

@@ -0,0 +1,2 @@
+import type { ChatFirstAgentsPaneProps } from "./types.js";
+export declare function ChatFirstAgentsPane({ activities, loading, error, onRefresh, onWatch, copy, }: ChatFirstAgentsPaneProps): import("react").JSX.Element;

package/dist/client/chat-first/agents-pane.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ChatFirstAgentActivityPanel } from "../chat-first-agent-activity.js";
+import { defaultChatFirstCopy } from "./copy.js";
+export function ChatFirstAgentsPane({ activities, loading = false, error, onRefresh, onWatch, copy = defaultChatFirstCopy, }) {
+    return (_jsx("section", { "data-chat-first-agents-pane": true, className: "flex h-full min-h-0 flex-col overflow-y-auto bg-background", "aria-label": copy("agentsTitle"), children: _jsx(ChatFirstAgentActivityPanel, { activities: activities, loading: loading, error: error ?? null, onRefresh: onRefresh, onWatch: onWatch, copy: copy }) }));
+}

package/dist/client/chat-first/app-pane.d.ts

@@ -0,0 +1,2 @@
+import type { ChatFirstAppPaneProps } from "./types.js";
+export declare function ChatFirstAppPane({ app, status, embedUrl, errorMessage, onRetry, renderEmbed, copy, }: ChatFirstAppPaneProps): import("react").JSX.Element;

package/dist/client/chat-first/app-pane.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Skeleton } from "@agent-native/toolkit/ui";
+import { defaultChatFirstCopy } from "./copy.js";
+export function ChatFirstAppPane({ app, status, embedUrl, errorMessage, onRetry, renderEmbed, copy = defaultChatFirstCopy, }) {
+    return (_jsx("section", { "data-chat-first-app-pane": true, className: "flex h-full min-h-0 w-full flex-col overflow-hidden bg-background", "aria-label": app ? `${app.name} app` : copy("appUnavailable"), children: status === "loading" ? (_jsxs("div", { className: "space-y-3 p-4", children: [_jsx(Skeleton, { className: "h-5 w-40" }), _jsx(Skeleton, { className: "h-4 w-full" }), _jsx(Skeleton, { className: "h-4 w-2/3" })] })) : status === "ready" && app && embedUrl ? (_jsx("div", { className: "relative min-h-0 flex-1 overflow-hidden", children: renderEmbed({ url: embedUrl, title: app.name }) })) : status === "error" ? (_jsxs("div", { className: "flex h-full flex-col items-center justify-center gap-3 p-6 text-center", children: [_jsx("p", { className: "text-sm text-muted-foreground", children: errorMessage || copy("appUnavailable") }), onRetry ? (_jsx("button", { type: "button", className: "rounded-md border border-border px-3 py-1.5 text-xs text-foreground hover:bg-accent", onClick: onRetry, children: copy("retry") })) : null] })) : (_jsx("div", { className: "flex h-full items-center justify-center p-6 text-center text-sm text-muted-foreground", children: copy("appUnavailable") })) }));
+}

package/dist/client/chat-first/apps-rail.d.ts

@@ -0,0 +1,2 @@
+import type { ChatFirstAppRailProps } from "./types.js";
+export declare function ChatFirstAppsRail({ apps, activeAppId, loading, error, collapsed, layout: controlledLayout, onLayoutChange, onLayoutError, onRetry, onOpenApp, onCreateApp, createAppTrigger, renderIcon, copy, }: ChatFirstAppRailProps): import("react").JSX.Element;

package/dist/client/chat-first/apps-rail.js

@@ -0,0 +1,103 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ContextMenu, ContextMenuContent, ContextMenuItem, ContextMenuSeparator, ContextMenuTrigger, Skeleton, Tooltip, TooltipContent, TooltipTrigger, } from "@agent-native/toolkit/ui";
+import { IconChevronDown, IconChevronUp, IconPin, IconPlus, } from "@tabler/icons-react";
+import { useMemo, useState } from "react";
+import { orderChatFirstAppIds, readChatFirstAppLayout, writeChatFirstAppLayout, } from "../chat-first.js";
+import { cn } from "../utils.js";
+import { defaultChatFirstCopy } from "./copy.js";
+function AppRows({ apps, activeAppId, layout, onDragStart, onDrop, onDragEnd, onOpenApp, onTogglePinned, onMove, renderIcon, copy, }) {
+    const orderedIds = orderChatFirstAppIds(apps.map((app) => app.id), layout);
+    const appsById = new Map(apps.map((app) => [app.id, app]));
+    const orderedApps = orderedIds
+        .map((id) => appsById.get(id))
+        .filter((app) => Boolean(app));
+    return (_jsx("ul", { className: "space-y-px", children: orderedApps.map((app) => {
+            const active = activeAppId === app.id;
+            const pinned = layout.pinnedIds.includes(app.id);
+            const index = orderedApps.indexOf(app);
+            return (_jsxs(ContextMenu, { children: [_jsx(ContextMenuTrigger, { asChild: true, children: _jsxs("li", { draggable: true, "data-chat-first-app": true, "data-app-id": app.id, className: cn("group flex h-6 w-full min-w-0 items-center gap-1 rounded-md px-1 text-sm transition-colors", active
+                                ? "bg-sidebar-accent font-medium text-sidebar-accent-foreground"
+                                : "text-sidebar-foreground/75 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"), onDragStart: (event) => {
+                                event.dataTransfer.effectAllowed = "move";
+                                onDragStart(app.id);
+                            }, onDragOver: (event) => event.preventDefault(), onDrop: () => onDrop(app.id), onDragEnd: onDragEnd, children: [_jsxs("button", { type: "button", className: "flex min-w-0 flex-1 items-center gap-2 px-1 text-start", onClick: () => onOpenApp(app), onKeyDown: (event) => {
+                                        if (!event.altKey)
+                                            return;
+                                        if (event.key === "ArrowUp") {
+                                            event.preventDefault();
+                                            onMove(app.id, -1);
+                                        }
+                                        else if (event.key === "ArrowDown") {
+                                            event.preventDefault();
+                                            onMove(app.id, 1);
+                                        }
+                                    }, "aria-keyshortcuts": "Alt+ArrowUp Alt+ArrowDown", "aria-label": copy("openApp", { name: app.name }), title: app.name, children: [renderIcon(app), _jsx("span", { className: "truncate", children: app.name })] }), _jsx("button", { type: "button", className: cn("flex size-6 shrink-0 items-center justify-center rounded text-sidebar-foreground/45 opacity-0 transition-opacity hover:bg-sidebar-accent hover:text-sidebar-foreground group-hover:opacity-100 focus-visible:opacity-100", pinned && "text-sidebar-foreground/70 opacity-100"), "aria-label": copy(pinned ? "unpinApp" : "pinApp", {
+                                        name: app.name,
+                                    }), "aria-pressed": pinned, title: pinned ? copy("removePinned") : copy("pinTop"), onClick: () => onTogglePinned(app.id), children: _jsx(IconPin, { size: 13, strokeWidth: pinned ? 2.2 : 1.6, "aria-hidden": "true" }) }), _jsx("span", { className: "sr-only", children: `${index + 1} of ${orderedApps.length}` })] }) }), _jsxs(ContextMenuContent, { children: [_jsxs(ContextMenuItem, { onSelect: () => onTogglePinned(app.id), children: [_jsx(IconPin, { size: 14, "aria-hidden": "true" }), pinned ? copy("removePinned") : copy("pinTop")] }), _jsx(ContextMenuSeparator, {}), _jsxs(ContextMenuItem, { disabled: index === 0, onSelect: () => onMove(app.id, -1), children: [_jsx(IconChevronUp, { size: 14, "aria-hidden": "true" }), copy("moveUp")] }), _jsxs(ContextMenuItem, { disabled: index === orderedApps.length - 1, onSelect: () => onMove(app.id, 1), children: [_jsx(IconChevronDown, { size: 14, "aria-hidden": "true" }), copy("moveDown")] })] })] }, app.id));
+        }) }));
+}
+export function ChatFirstAppsRail({ apps, activeAppId, loading = false, error, collapsed = false, layout: controlledLayout, onLayoutChange, onLayoutError, onRetry, onOpenApp, onCreateApp, createAppTrigger, renderIcon, copy = defaultChatFirstCopy, }) {
+    const [localLayout, setLocalLayout] = useState(() => readChatFirstAppLayout());
+    const layout = controlledLayout ?? localLayout;
+    const [draggedAppId, setDraggedAppId] = useState(null);
+    const [showAllApps, setShowAllApps] = useState(false);
+    const orderedApps = useMemo(() => {
+        const orderedIds = orderChatFirstAppIds(apps.map((app) => app.id), layout);
+        const appsById = new Map(apps.map((app) => [app.id, app]));
+        return orderedIds
+            .map((id) => appsById.get(id))
+            .filter((app) => Boolean(app));
+    }, [apps, layout]);
+    const visibleApps = showAllApps ? orderedApps : orderedApps.slice(0, 5);
+    const hasMoreApps = orderedApps.length > visibleApps.length;
+    const createTrigger = createAppTrigger ??
+        (onCreateApp ? (_jsx("button", { type: "button", className: "flex size-6 items-center justify-center rounded text-sidebar-foreground/55 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: onCreateApp, "aria-label": copy("createWorkspaceApp"), title: copy("createWorkspaceApp"), children: _jsx(IconPlus, { size: 14, "aria-hidden": "true" }) })) : null);
+    function persistLayout(next) {
+        setLocalLayout(next);
+        onLayoutChange?.(next);
+        const result = writeChatFirstAppLayout(next);
+        if (!result.ok)
+            onLayoutError?.(result.reason);
+    }
+    function togglePinned(appId) {
+        const pinnedIds = layout.pinnedIds.includes(appId)
+            ? layout.pinnedIds.filter((id) => id !== appId)
+            : [appId, ...layout.pinnedIds];
+        persistLayout({ ...layout, pinnedIds });
+    }
+    function reorderApps(targetId) {
+        if (!draggedAppId || draggedAppId === targetId)
+            return;
+        const currentOrder = orderChatFirstAppIds(apps.map((app) => app.id), layout);
+        const fromIndex = currentOrder.indexOf(draggedAppId);
+        const toIndex = currentOrder.indexOf(targetId);
+        if (fromIndex < 0 || toIndex < 0)
+            return;
+        const nextOrder = [...currentOrder];
+        nextOrder.splice(fromIndex, 1);
+        nextOrder.splice(toIndex, 0, draggedAppId);
+        persistLayout({ ...layout, orderedIds: nextOrder });
+        setDraggedAppId(null);
+    }
+    function moveApp(appId, direction) {
+        const currentOrder = orderChatFirstAppIds(apps.map((app) => app.id), layout);
+        const index = currentOrder.indexOf(appId);
+        const nextIndex = index + direction;
+        if (index < 0 || nextIndex < 0 || nextIndex >= currentOrder.length)
+            return;
+        const nextOrder = [...currentOrder];
+        [nextOrder[index], nextOrder[nextIndex]] = [
+            nextOrder[nextIndex],
+            nextOrder[index],
+        ];
+        persistLayout({ ...layout, orderedIds: nextOrder });
+    }
+    if (collapsed) {
+        return (_jsxs("section", { "data-chat-first-apps-rail": true, className: "flex flex-col items-center gap-1 px-1.5 pt-2", "aria-label": copy("workspaceApps"), children: [createTrigger, loading && apps.length === 0
+                    ? [0, 1, 2].map((index) => (_jsx(Skeleton, { className: "size-9 rounded-md" }, index)))
+                    : visibleApps.map((app) => (_jsx("button", { type: "button", "data-chat-first-app": true, "data-app-id": app.id, className: cn("flex size-9 items-center justify-center rounded-md transition-colors", activeAppId === app.id
+                            ? "bg-sidebar-accent text-sidebar-accent-foreground"
+                            : "text-sidebar-foreground/70 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"), onClick: () => onOpenApp(app), "aria-label": copy("openApp", { name: app.name }), title: app.name, children: renderIcon(app) }, app.id))), error ? (_jsx("span", { className: "size-1.5 rounded-full bg-destructive", title: error, "aria-label": error })) : null] }));
+    }
+    return (_jsxs("section", { "data-chat-first-apps-rail": true, className: "mt-3 px-2 pb-2 pt-2", "aria-label": copy("workspaceApps"), children: [_jsxs("div", { className: "mb-1 flex items-center gap-1.5 px-1 text-[11px] font-medium text-sidebar-foreground/50", children: [_jsx("span", { children: copy("workspaceApps") }), _jsx("span", { className: "ml-auto", children: createTrigger })] }), loading && apps.length === 0 ? (_jsx("div", { className: "space-y-0.5 px-1", children: [0, 1, 2].map((index) => (_jsx(Skeleton, { className: "h-7 w-full rounded-md" }, index))) })) : apps.length === 0 ? (_jsxs("div", { className: "px-1", children: [_jsx("p", { className: "text-xs text-sidebar-foreground/55", children: copy("noWorkspaceApps") }), createAppTrigger ? (createTrigger) : onCreateApp ? (_jsxs("button", { type: "button", className: "mt-1 inline-flex h-6 items-center gap-1.5 rounded-md border border-sidebar-border px-2 text-xs text-sidebar-foreground/75 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: onCreateApp, children: [_jsx(IconPlus, { size: 13, "aria-hidden": "true" }), copy("createApp")] })) : (createTrigger)] })) : (_jsx(AppRows, { apps: visibleApps, activeAppId: activeAppId, layout: layout, onDragStart: setDraggedAppId, onDrop: reorderApps, onDragEnd: () => setDraggedAppId(null), onOpenApp: onOpenApp, onTogglePinned: togglePinned, onMove: moveApp, renderIcon: renderIcon, copy: copy })), hasMoreApps || showAllApps ? (_jsxs("button", { type: "button", className: "mt-0.5 flex h-6 w-full items-center gap-2 rounded-md px-2 text-xs text-sidebar-foreground/50 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: () => setShowAllApps((value) => !value), children: [showAllApps ? (_jsx(IconChevronUp, { size: 14, "aria-hidden": "true" })) : (_jsx(IconChevronDown, { size: 14, "aria-hidden": "true" })), showAllApps ? copy("showLess") : copy("showMore")] })) : null, error ? (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsxs("button", { type: "button", className: "mt-1 flex items-center gap-1 px-1 text-[10px] text-destructive/80", onClick: onRetry, "aria-label": error, children: [_jsx("span", { className: "size-1.5 rounded-full bg-destructive" }), onRetry ? copy("retry") : copy("appsLoadError")] }) }), _jsx(TooltipContent, { side: "right", children: error })] })) : null] }));
+}

package/dist/client/chat-first/browser-pane.d.ts

@@ -0,0 +1,2 @@
+import type { ChatFirstBrowserPaneProps } from "./types.js";
+export declare function ChatFirstBrowserPane({ url, title, status, statusMessage, onClose, renderEmbed, copy, }: ChatFirstBrowserPaneProps): import("react").JSX.Element;

package/dist/client/chat-first/browser-pane.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { IconArrowLeft, IconArrowRight, IconExternalLink, IconRefresh, IconWorld, IconX, } from "@tabler/icons-react";
+import { useEffect, useState } from "react";
+import { resolveChatFirstBrowserTarget } from "../chat-first.js";
+import { defaultChatFirstCopy } from "./copy.js";
+export function ChatFirstBrowserPane({ url, title, status, statusMessage, onClose, renderEmbed, copy = defaultChatFirstCopy, }) {
+    const [currentUrl, setCurrentUrl] = useState(url);
+    const [draftUrl, setDraftUrl] = useState(url);
+    const [reloadKey, setReloadKey] = useState(0);
+    const [history, setHistory] = useState([url]);
+    const [historyIndex, setHistoryIndex] = useState(0);
+    const [navigationError, setNavigationError] = useState(null);
+    useEffect(() => {
+        setCurrentUrl(url);
+        setDraftUrl(url);
+        setHistory([url]);
+        setHistoryIndex(0);
+        setNavigationError(null);
+    }, [url]);
+    function navigate(event) {
+        event.preventDefault();
+        const target = resolveChatFirstBrowserTarget({ url: draftUrl });
+        if (target.status !== "ready") {
+            setNavigationError(copy("browserInvalidUrl"));
+            return;
+        }
+        const nextUrl = target.target.url;
+        setNavigationError(null);
+        setCurrentUrl(nextUrl);
+        setDraftUrl(nextUrl);
+        setHistory((current) => [...current.slice(0, historyIndex + 1), nextUrl]);
+        setHistoryIndex((index) => index + 1);
+        setReloadKey((key) => key + 1);
+    }
+    function goBack() {
+        if (historyIndex <= 0)
+            return;
+        const nextIndex = historyIndex - 1;
+        const nextUrl = history[nextIndex];
+        setHistoryIndex(nextIndex);
+        setCurrentUrl(nextUrl);
+        setDraftUrl(nextUrl);
+        setNavigationError(null);
+        setReloadKey((key) => key + 1);
+    }
+    function goForward() {
+        if (historyIndex >= history.length - 1)
+            return;
+        const nextIndex = historyIndex + 1;
+        const nextUrl = history[nextIndex];
+        setHistoryIndex(nextIndex);
+        setCurrentUrl(nextUrl);
+        setDraftUrl(nextUrl);
+        setNavigationError(null);
+        setReloadKey((key) => key + 1);
+    }
+    return (_jsxs("section", { "data-chat-first-browser-pane": true, className: "flex h-full min-h-0 w-full flex-col overflow-hidden bg-background", "aria-label": copy("surface.browser.label"), children: [_jsxs("header", { className: "flex h-12 shrink-0 items-center gap-1.5 border-b border-border bg-card px-2", children: [_jsxs("div", { className: "flex shrink-0 items-center gap-0.5", children: [_jsx("button", { type: "button", disabled: historyIndex <= 0, onClick: goBack, "aria-label": copy("browserBack"), title: copy("browserBack"), className: "flex size-7 items-center justify-center rounded-md text-muted-foreground hover:bg-accent hover:text-foreground disabled:opacity-35", children: _jsx(IconArrowLeft, { size: 15 }) }), _jsx("button", { type: "button", disabled: historyIndex >= history.length - 1, onClick: goForward, "aria-label": copy("browserForward"), title: copy("browserForward"), className: "flex size-7 items-center justify-center rounded-md text-muted-foreground hover:bg-accent hover:text-foreground disabled:opacity-35", children: _jsx(IconArrowRight, { size: 15 }) }), _jsx("button", { type: "button", onClick: () => setReloadKey((key) => key + 1), "aria-label": copy("browserReload"), title: copy("browserReload"), className: "flex size-7 items-center justify-center rounded-md text-muted-foreground hover:bg-accent hover:text-foreground", children: _jsx(IconRefresh, { size: 15 }) })] }), _jsxs("form", { className: "flex min-w-0 flex-1 items-center gap-1.5 rounded-md border border-input bg-background px-2", onSubmit: navigate, children: [_jsx(IconWorld, { size: 13, className: "shrink-0 text-muted-foreground", "aria-hidden": "true" }), _jsx("input", { value: draftUrl, onChange: (event) => setDraftUrl(event.target.value), "aria-label": copy("browserAddress"), spellCheck: false, className: "h-7 min-w-0 flex-1 bg-transparent text-xs text-foreground outline-none placeholder:text-muted-foreground" })] }), _jsxs("div", { className: "flex shrink-0 items-center gap-0.5", children: [title ? (_jsx("span", { className: "hidden max-w-28 truncate px-1 text-xs text-muted-foreground xl:block", title: title, children: title })) : null, _jsx("button", { type: "button", onClick: () => window.open(currentUrl, "_blank", "noopener,noreferrer"), "aria-label": copy("browserOpenExternal"), title: copy("browserOpenExternal"), className: "flex size-7 items-center justify-center rounded-md text-muted-foreground hover:bg-accent hover:text-foreground", children: _jsx(IconExternalLink, { size: 15 }) }), _jsx("button", { type: "button", onClick: onClose, "aria-label": copy("browserClose"), title: copy("browserClose"), className: "flex size-7 items-center justify-center rounded-md text-muted-foreground hover:bg-accent hover:text-foreground", children: _jsx(IconX, { size: 15 }) })] })] }), navigationError ? (_jsx("p", { className: "border-b border-destructive/30 bg-destructive/10 px-3 py-1.5 text-xs text-destructive", role: "alert", children: navigationError })) : null, _jsx("div", { className: "relative min-h-0 flex-1 overflow-hidden", children: status === "starting" || status === "error" ? (_jsx("div", { className: "flex h-full items-center justify-center px-6 text-center", role: status === "error" ? "alert" : "status", "aria-live": "polite", children: _jsxs("div", { className: "max-w-xs space-y-1", children: [_jsx("p", { className: "text-sm font-medium text-foreground", children: status === "starting"
+                                    ? copy("browserPreviewStarting")
+                                    : copy("browserPreviewError") }), statusMessage ? (_jsx("p", { className: "text-xs text-muted-foreground", children: statusMessage })) : null] }) })) : (renderEmbed({
+                    url: currentUrl,
+                    title: title || copy("browserPage"),
+                    key: `${currentUrl}:${reloadKey}`,
+                })) })] }));
+}

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

@@ -0,0 +1,12 @@
+import type { ReactNode } from "react";
+import { type ChatHistoryItem, type ChatHistoryListProps } from "../chat/ChatHistoryList.js";
+export interface ChatFirstChatHistoryProps extends Omit<ChatHistoryListProps, "items" | "sections" | "variant"> {
+    items: ChatHistoryItem[];
+    label?: ReactNode;
+}
+/**
+ * The single chat-list presentation used by the chat-first rail on every
+ * host. Hosts still own thread fetching and actions, but row rhythm and the
+ * Chats section treatment stay identical.
+ */
+export declare function ChatFirstChatHistory({ items, label, className, ...props }: ChatFirstChatHistoryProps): import("react").JSX.Element;

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

@@ -0,0 +1,10 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ChatHistoryList, } from "../chat/ChatHistoryList.js";
+/**
+ * The single chat-list presentation used by the chat-first rail on every
+ * host. Hosts still own thread fetching and actions, but row rhythm and the
+ * Chats section treatment stay identical.
+ */
+export function ChatFirstChatHistory({ items, label = "Chats", className, ...props }) {
+    return (_jsxs("section", { "data-chat-first-chat-history": true, className: ["min-h-0 min-w-0", className].filter(Boolean).join(" "), children: [_jsx("p", { className: "mb-1 px-2 text-[11px] font-medium text-sidebar-foreground/50", children: label }), _jsx(ChatHistoryList, { ...props, items: items, variant: "rail", className: "min-w-0" })] }));
+}

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

@@ -0,0 +1,2 @@
+import type { ChatFirstCopy } from "./types.js";
+export declare const defaultChatFirstCopy: ChatFirstCopy;

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

@@ -0,0 +1,117 @@
+const DEFAULT_COPY = {
+    newChat: "New chat",
+    search: "Search",
+    workspaceApps: "Apps",
+    integrations: "Integrations",
+    scheduled: "Scheduled",
+    createWorkspaceApp: "Create app",
+    openApp: "Open {name}",
+    appsLoadError: "Apps could not be loaded",
+    noWorkspaceApps: "No apps yet",
+    createApp: "Create app",
+    retry: "Retry",
+    dismiss: "Dismiss",
+    unpinApp: "Unpin {name}",
+    pinApp: "Pin {name}",
+    removePinned: "Remove from pinned apps",
+    pinTop: "Pin app to the top",
+    moveUp: "Move up",
+    moveDown: "Move down",
+    showMore: "Show more",
+    showLess: "Show less",
+    appOrderUnavailable: "App order could not be saved on this device.",
+    openSideSurfaces: "Open side surfaces",
+    sideSurfaces: "Side surfaces",
+    resizeSideSurface: "Resize side surface",
+    closeTab: "Close {name}",
+    close: "Close",
+    closeOthers: "Close others",
+    closeToRight: "Close to the right",
+    closeAll: "Close all",
+    deferred: "Deferred",
+    openActivity: "Open activity",
+    unavailable: "This surface is not available here.",
+    browserBack: "Back",
+    browserForward: "Forward",
+    browserReload: "Reload page",
+    browserAddress: "Browser address",
+    browserOpenExternal: "Open in external browser",
+    browserClose: "Close browser",
+    browserPage: "Browser page",
+    browserInvalidUrl: "Enter a full http(s) URL to navigate.",
+    browserPreviewStarting: "Starting preview…",
+    browserPreviewError: "Preview unavailable",
+    appUnavailable: "This workspace app is no longer available.",
+    appLoading: "Loading app",
+    agentActivityEyebrow: "Workspace",
+    agentActivityTitle: "Agent activity",
+    agentActivityDescription: "Follow runs and open a second session beside this chat.",
+    refreshAgentActivity: "Refresh agent activity",
+    noAgentSessions: "No agent sessions yet",
+    startAgentSession: "Start an agent run and it will appear here.",
+    watchSession: "Watch",
+    copySessionId: "Copy session ID",
+    copySessionIdFor: "Copy session ID for {name}",
+    sessionIdCopied: "Session ID copied",
+    sessionIdShort: "ID",
+    copied: "Copied",
+    agentActivityStatusQueued: "Queued",
+    agentActivityStatusRunning: "Running",
+    agentActivityStatusPaused: "Paused",
+    agentActivityStatusNeedsApproval: "Needs approval",
+    agentActivityStatusCompleted: "Completed",
+    agentActivityStatusErrored: "Needs attention",
+    agentActivityStatusRecent: "Recent",
+    agentActivityStatusUnknown: "Unknown",
+    watchingSession: "Watching {name}",
+    session: "session",
+    stopWatchingSession: "Stop watching session",
+    stopWatching: "Stop watching",
+    watchedSession: "Watched session",
+    agentsTitle: "Subagents",
+};
+const SURFACE_COPY = {
+    app: {
+        label: "App",
+        reason: "Open a workspace app beside the conversation.",
+    },
+    browser: {
+        label: "Browser",
+        reason: "Ask the agent to open a web URL.",
+    },
+    terminal: {
+        label: "Terminal",
+        reason: "Deferred: an embedded PTY lifecycle is not connected in this release.",
+    },
+    files: {
+        label: "Files",
+        reason: "Deferred: a bounded workspace tree is not connected in this release.",
+    },
+    diff: {
+        label: "Diff",
+        reason: "Deferred: changed-file data is not connected in this release.",
+    },
+    "side-chat": {
+        label: "Side chat",
+        reason: "Choose Watch and message from any chat row.",
+    },
+    agents: {
+        label: "Agents",
+        reason: "Review recent runs or watch one beside this conversation.",
+    },
+};
+function interpolate(value, values) {
+    if (!values)
+        return value;
+    return value.replace(/\{(\w+)\}/g, (_, key) => values[key] ?? "");
+}
+export const defaultChatFirstCopy = (key, values) => {
+    if (key.startsWith("surface.")) {
+        const [, kind, field] = key.split(".");
+        const surface = SURFACE_COPY[kind];
+        if (surface && (field === "label" || field === "reason")) {
+            return surface[field];
+        }
+    }
+    return interpolate(DEFAULT_COPY[key] ?? key, values);
+};

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

@@ -0,0 +1,13 @@
+export { ChatFirstAgentsPane } from "./agents-pane.js";
+export { ChatFirstAppPane } from "./app-pane.js";
+export { ChatFirstAppsRail } from "./apps-rail.js";
+export { ChatFirstBrowserPane } from "./browser-pane.js";
+export { defaultChatFirstCopy } from "./copy.js";
+export { ChatFirstChatHistory, type ChatFirstChatHistoryProps, } from "./chat-history.js";
+export { ChatFirstSessionWatchPane } from "./session-watch-pane.js";
+export { ChatFirstSurfacePanel, type ChatFirstSurfacePanelProps, } from "./surface-panel.js";
+export { ChatFirstPrimaryNavigation } from "./primary-nav.js";
+export { emitChatFirstOpenApp, resolveChatFirstAppTarget, CHAT_FIRST_DEFAULT_APP_IDS, type ChatFirstOpenAppDetail, } from "../chat-first.js";
+export { buildChatFirstAppCreationPrompt, titleFromChatFirstAppPrompt, type ChatFirstAppCreationPromptInput, type ChatFirstAppCreationResource, type ChatFirstAppCreationVaultAccessMode, } from "../../shared/chat-first-app-creation.js";
+export { ChatFirstSurfaceContent, ChatFirstSurfaceTabs, } from "./surface-tabs.js";
+export type { ChatFirstAgentActivity, ChatFirstAgentsPaneProps, ChatFirstAppItem, ChatFirstAppPaneProps, ChatFirstAppRailProps, ChatFirstBrowserPaneProps, ChatFirstCopy, ChatFirstEmbedTarget, ChatFirstSessionWatchPaneProps, ChatFirstSurfaceTabsProps, } from "./types.js";

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

@@ -0,0 +1,12 @@
+export { ChatFirstAgentsPane } from "./agents-pane.js";
+export { ChatFirstAppPane } from "./app-pane.js";
+export { ChatFirstAppsRail } from "./apps-rail.js";
+export { ChatFirstBrowserPane } from "./browser-pane.js";
+export { defaultChatFirstCopy } from "./copy.js";
+export { ChatFirstChatHistory, } from "./chat-history.js";
+export { ChatFirstSessionWatchPane } from "./session-watch-pane.js";
+export { ChatFirstSurfacePanel, } from "./surface-panel.js";
+export { ChatFirstPrimaryNavigation } from "./primary-nav.js";
+export { emitChatFirstOpenApp, resolveChatFirstAppTarget, CHAT_FIRST_DEFAULT_APP_IDS, } from "../chat-first.js";
+export { buildChatFirstAppCreationPrompt, titleFromChatFirstAppPrompt, } from "../../shared/chat-first-app-creation.js";
+export { ChatFirstSurfaceContent, ChatFirstSurfaceTabs, } from "./surface-tabs.js";

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

@@ -0,0 +1,8 @@
+import type { ChatFirstCopy } from "./types.js";
+export declare function ChatFirstPrimaryNavigation({ onNewChat, onOpenIntegrations, onOpenScheduled, onSearch, copy, }: {
+    onNewChat?: () => void;
+    onOpenIntegrations: () => void;
+    onOpenScheduled: () => void;
+    onSearch?: () => void;
+    copy?: ChatFirstCopy;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,6 @@
+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, copy = defaultChatFirstCopy, }) {
+    return (_jsxs(_Fragment, { children: [onNewChat ? (_jsxs("button", { type: "button", className: "flex h-8 w-full items-center gap-2 rounded-md px-2 text-[13px] font-medium text-sidebar-foreground/80 transition-colors hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", onClick: onNewChat, children: [_jsx(IconPlus, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { children: copy("newChat") })] })) : null, _jsxs("button", { type: "button", className: "flex h-8 w-full items-center gap-2 rounded-md px-2 text-[13px] font-medium text-sidebar-foreground/80 transition-colors hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", onClick: onOpenIntegrations, children: [_jsx(IconPlugConnected, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { children: copy("integrations") })] }), _jsxs("button", { type: "button", className: "flex h-8 w-full items-center gap-2 rounded-md px-2 text-[13px] font-medium text-sidebar-foreground/80 transition-colors hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", onClick: onOpenScheduled, children: [_jsx(IconClock, { size: 15, className: "shrink-0", "aria-hidden": "true" }), _jsx("span", { children: copy("scheduled") })] }), onSearch ? (_jsxs("button", { type: "button", className: "flex h-8 w-full items-center gap-2 rounded-md px-2 text-[13px] font-medium text-sidebar-foreground/80 transition-colors 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] }));
+}

package/dist/client/chat-first/session-watch-pane.d.ts

@@ -0,0 +1,2 @@
+import type { ChatFirstSessionWatchPaneProps } from "./types.js";
+export declare function ChatFirstSessionWatchPane({ target, onClose, renderChat, copy, }: ChatFirstSessionWatchPaneProps): import("react").JSX.Element | null;

package/dist/client/chat-first/session-watch-pane.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { IconEye, IconX } from "@tabler/icons-react";
+import { defaultChatFirstCopy } from "./copy.js";
+export function ChatFirstSessionWatchPane({ target, onClose, renderChat, copy = defaultChatFirstCopy, }) {
+    if (!target)
+        return null;
+    const sessionName = target.title || copy("session");
+    return (_jsxs("section", { "data-chat-first-watch-pane": true, className: "flex h-full min-h-0 w-full flex-col overflow-hidden bg-background", "aria-label": copy("watchedSession"), children: [_jsxs("header", { className: "flex h-12 shrink-0 items-center gap-2 border-b border-border bg-card px-3", children: [_jsx(IconEye, { size: 16, className: "shrink-0 text-primary", "aria-hidden": "true" }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("p", { className: "truncate text-xs font-semibold text-foreground", children: copy("watchingSession", { name: sessionName }) }), _jsx("p", { className: "truncate font-mono text-[10px] text-muted-foreground", children: target.sessionId })] }), _jsx("button", { type: "button", className: "flex size-7 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-accent hover:text-foreground", "aria-label": copy("stopWatchingSession"), title: copy("stopWatching"), onClick: onClose, children: _jsx(IconX, { size: 16, "aria-hidden": "true" }) })] }), _jsx("div", { className: "min-h-0 flex-1", children: renderChat(target) })] }));
+}

package/dist/client/chat-first/surface-panel.d.ts

@@ -0,0 +1,9 @@
+import type { PointerEvent, ReactNode } from "react";
+import type { ChatFirstCopy } from "./types.js";
+export interface ChatFirstSurfacePanelProps {
+    width: number;
+    onResizePointerDown: (event: PointerEvent<HTMLDivElement>) => void;
+    children: ReactNode;
+    copy?: ChatFirstCopy;
+}
+export declare function ChatFirstSurfacePanel({ width, onResizePointerDown, children, copy, }: ChatFirstSurfacePanelProps): import("react").JSX.Element;

package/dist/client/chat-first/surface-panel.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { clampChatFirstSurfaceWidth } from "../chat-first.js";
+import { defaultChatFirstCopy } from "./copy.js";
+export function ChatFirstSurfacePanel({ width, onResizePointerDown, children, copy = defaultChatFirstCopy, }) {
+    const panelWidth = clampChatFirstSurfaceWidth(width);
+    return (_jsxs("aside", { "data-chat-first-surface-panel": true, "aria-label": copy("sideSurfaces"), className: "chat-first-surface-panel relative flex h-full w-[var(--chat-first-surface-width)] min-w-0 shrink-0 flex-col overflow-hidden border-s border-border bg-background max-[767px]:absolute max-[767px]:inset-0 max-[767px]:z-10 max-[767px]:w-full max-[767px]:min-w-0", style: {
+            "--chat-first-surface-width": `${panelWidth}px`,
+        }, children: [_jsx("div", { className: "chat-first-surface-resize-handle absolute inset-y-0 -start-1 z-[3] w-2 cursor-col-resize hover:bg-ring/35 max-[767px]:hidden", role: "separator", "aria-label": copy("resizeSideSurface"), "aria-orientation": "vertical", onPointerDown: onResizePointerDown }), children] }));
+}

package/dist/client/chat-first/surface-tabs.d.ts

@@ -0,0 +1,9 @@
+import type { ReactNode } from "react";
+import { type ChatFirstSurfaceTab } from "../chat-first.js";
+import type { ChatFirstSurfaceTabsProps } from "./types.js";
+export declare function ChatFirstSurfaceTabs({ tabs, activeTabId, onActivate, onClose, onCloseOthers, onCloseToRight, onCloseAll, onOpenSurface, copy, }: ChatFirstSurfaceTabsProps): import("react").JSX.Element;
+export declare function ChatFirstSurfaceContent({ tabs, activeTabId, renderTab, }: {
+    tabs: readonly ChatFirstSurfaceTab[];
+    activeTabId: string | null;
+    renderTab: (tab: ChatFirstSurfaceTab) => ReactNode;
+}): import("react").JSX.Element;