@agent-native/core 0.115.4 → 0.117.0

package/src/client/AgentPanel.tsx

@@ -66,7 +66,7 @@ import {
   normalizeTooltipText,
 } from "./components/ui/tooltip.js";
 import { ErrorReportActions } from "./ErrorReportActions.js";
-import { FeedbackButton } from "./FeedbackButton.js";
+import { FeedbackButton, resolveFeedbackUrl } from "./FeedbackButton.js";
 import { RunsTrayMenuItem } from "./progress/RunsTray.js";
 import { ShareButton } from "./sharing/ShareButton.js";
 // Lazy-load the full assistant-ui chat stack (tiptap composer + react-markdown +
@@ -773,6 +773,7 @@ function AgentPanelInner({
   ...assistantChatProps
 }: AgentPanelProps) {
   const t = useT();
+  const feedbackEnabled = resolveFeedbackUrl() !== null;
   const navigate = useNavigate();
   const mounted = useClientOnly();
   const keyPrefix = storageKey ? `:${storageKey}` : "";
@@ -1218,23 +1219,25 @@ function AgentPanelInner({
               />
             );
           })()}
-        <FeedbackButton
-          variant="icon"
-          side="bottom"
-          align="end"
-          chatSessionId={activeChatSessionId}
-          chatStorageKey={storageKey}
-          open={feedbackOpen}
-          onOpenChange={setFeedbackOpen}
-          trigger={
-            <button
-              type="button"
-              tabIndex={-1}
-              aria-hidden="true"
-              className="pointer-events-none absolute end-0 top-full h-px w-px opacity-0"
-            />
-          }
-        />
+        {feedbackEnabled ? (
+          <FeedbackButton
+            variant="icon"
+            side="bottom"
+            align="end"
+            chatSessionId={activeChatSessionId}
+            chatStorageKey={storageKey}
+            open={feedbackOpen}
+            onOpenChange={setFeedbackOpen}
+            trigger={
+              <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" && (
           <IconTooltip content={t("agentPanel.newChat")}>
             <button
@@ -1355,17 +1358,19 @@ function AgentPanelInner({
                 {t("agentPanel.settings")}
               </DropdownMenuItem>
             )}
-            <DropdownMenuItem
-              onSelect={() => {
-                // Defer past the closing DropdownMenu's focus-restore/dismiss-layer
-                // teardown, otherwise it can immediately dismiss the Popover we're
-                // opening in the same tick (Radix nested-overlay race).
-                setTimeout(() => setFeedbackOpen(true), 0);
-              }}
-            >
-              <IconMessageDots size={14} className="shrink-0" />
-              {t("agentPanel.feedback")}
-            </DropdownMenuItem>
+            {feedbackEnabled ? (
+              <DropdownMenuItem
+                onSelect={() => {
+                  // Defer past the closing DropdownMenu's focus-restore/dismiss-layer
+                  // teardown, otherwise it can immediately dismiss the Popover we're
+                  // opening in the same tick (Radix nested-overlay race).
+                  setTimeout(() => setFeedbackOpen(true), 0);
+                }}
+              >
+                <IconMessageDots size={14} className="shrink-0" />
+                {t("agentPanel.feedback")}
+              </DropdownMenuItem>
+            ) : null}
             {onToggleFullscreen && (
               <DropdownMenuItem onSelect={onToggleFullscreen}>
                 {isFullscreen ? (
@@ -1464,6 +1469,7 @@ function AgentPanelInner({
       closeOtherCliTabs,
       closeTabHint,
       feedbackOpen,
+      feedbackEnabled,
       getChatThreadShareUrl,
       headerMenuOpen,
       isFullscreen,
@@ -1541,24 +1547,42 @@ function AgentPanelInner({
     [getChatThreadShareUrl, t],
   );
 
-  // Ref callback: scroll the active tab into view in the overflow container.
-  // Uses getBoundingClientRect for reliable positioning regardless of offsetParent.
-  const activeTabRefCb = useCallback((el: HTMLDivElement | null) => {
-    if (!el) return;
+  const activeTabResizeObserverRef = useRef<ResizeObserver | null>(null);
+  const scrollActiveTabIntoView = useCallback((el: HTMLDivElement) => {
     const container = el.parentElement;
     if (!container) return;
-    // Use rAF so layout is settled after React commit
     requestAnimationFrame(() => {
-      const containerRect = container.getBoundingClientRect();
-      const tabRect = el.getBoundingClientRect();
-      if (tabRect.left < containerRect.left) {
-        container.scrollLeft += tabRect.left - containerRect.left;
-      } else if (tabRect.right > containerRect.right) {
-        container.scrollLeft += tabRect.right - containerRect.right;
-      }
+      const delta = getActiveTabScrollDelta(
+        container.getBoundingClientRect(),
+        el.getBoundingClientRect(),
+      );
+      if (delta !== 0) container.scrollLeft += delta;
     });
   }, []);
 
+  // The sidebar stays mounted while closed and animates its width on open, so
+  // the active tab ref alone can run before the overflow container is usable.
+  const activeTabRefCb = useCallback(
+    (el: HTMLDivElement | null) => {
+      activeTabResizeObserverRef.current?.disconnect();
+      activeTabResizeObserverRef.current = null;
+      if (!el) return;
+      const container = el.parentElement;
+      if (!container) return;
+
+      const observer =
+        typeof ResizeObserver === "undefined"
+          ? null
+          : new ResizeObserver(() => scrollActiveTabIntoView(el));
+      observer?.observe(container);
+      activeTabResizeObserverRef.current = observer;
+      scrollActiveTabIntoView(el);
+    },
+    [scrollActiveTabIntoView],
+  );
+
+  useEffect(() => () => activeTabResizeObserverRef.current?.disconnect(), []);
+
   const renderChatHeader = useCallback(
     ({
       tabs,
@@ -2108,6 +2132,20 @@ const SIDEBAR_FULLSCREEN_Z_INDEX = 90;
 /** Shared max width of the centered fullscreen chat column and composer. */
 const FULLSCREEN_CHAT_COLUMN_MAX_PX = 684;
 
+export function getActiveTabScrollDelta(
+  containerRect: Pick<DOMRect, "left" | "right">,
+  tabRect: Pick<DOMRect, "left" | "right">,
+  margin = 24,
+): number {
+  if (tabRect.left < containerRect.left + margin) {
+    return tabRect.left - containerRect.left - margin;
+  }
+  if (tabRect.right > containerRect.right - margin) {
+    return tabRect.right - containerRect.right + margin;
+  }
+  return 0;
+}
+
 function ResizeHandle({
   position,
   onDrag,

package/src/client/AssistantChat.tsx

@@ -173,6 +173,11 @@ import {
   useGuidedQuestionFlow,
 } from "./guided-questions.js";
 import { useT } from "./i18n.js";
+import {
+  addMcpConnectionCompleteListener,
+  consumeMcpConnectionResume,
+  type McpConnectionResumeRequest,
+} from "./resources/mcp-connection-resume.js";
 import { McpConnectionSuggestion } from "./resources/McpConnectionSuggestion.js";
 import {
   AgentAutoContinueSignal,
@@ -1513,20 +1518,24 @@ export function resolveAssistantChatRunningStatusLabel({
   return "Thinking";
 }
 
-function contentHasVisibleReasoning(content: unknown): boolean {
+function contentHasVisibleTailReasoning(content: unknown): boolean {
   if (!Array.isArray(content)) return false;
-  return content.some((part) => {
-    if (!part || typeof part !== "object") return false;
+  for (let index = content.length - 1; index >= 0; index -= 1) {
+    const part = content[index];
+    if (!part || typeof part !== "object") continue;
     const candidate = part as { type?: unknown; text?: unknown };
-    return (
-      candidate.type === "reasoning" &&
-      typeof candidate.text === "string" &&
-      candidate.text.trim().length > 0
-    );
-  });
+    if (
+      (candidate.type === "text" || candidate.type === "reasoning") &&
+      (typeof candidate.text !== "string" || candidate.text.trim().length === 0)
+    ) {
+      continue;
+    }
+    return candidate.type === "reasoning";
+  }
+  return false;
 }
 
-function contentHasUnresolvedToolCall(
+function contentHasToolCall(
   content: unknown,
   toolName?: string | null,
 ): boolean {
@@ -1540,7 +1549,6 @@ function contentHasUnresolvedToolCall(
     };
     return (
       candidate.type === "tool-call" &&
-      candidate.result === undefined &&
       (!toolName || candidate.toolName === toolName)
     );
   });
@@ -1565,17 +1573,19 @@ export function shouldShowGlobalRunningStatus({
     latestMessage && typeof latestMessage === "object"
       ? (latestMessage as { role?: unknown; content?: unknown })
       : null;
-  const latestMessageHasReasoning =
+  const latestMessageHasTailReasoning =
     message?.role === "assistant" &&
-    contentHasVisibleReasoning(message.content);
-  const latestMessageHasUnresolvedTool =
-    message?.role === "assistant" &&
-    contentHasUnresolvedToolCall(message.content);
+    contentHasVisibleTailReasoning(message.content);
+  const latestMessageHasTool =
+    message?.role === "assistant" && contentHasToolCall(message.content);
+  const reconnectHasTool = contentHasToolCall(reconnectContent);
+  const reconnectHasTailReasoning =
+    contentHasVisibleTailReasoning(reconnectContent);
   const matchingActivityToolIsVisible = Boolean(
     runningActivityTool &&
     ((message?.role === "assistant" &&
-      contentHasUnresolvedToolCall(message.content, runningActivityTool)) ||
-      contentHasUnresolvedToolCall(reconnectContent, runningActivityTool)),
+      contentHasToolCall(message.content, runningActivityTool)) ||
+      contentHasToolCall(reconnectContent, runningActivityTool)),
   );
 
   // A pending card for the same tool is already the running indicator.
@@ -1584,11 +1594,7 @@ export function shouldShowGlobalRunningStatus({
   if (runningActivityLabel && matchingActivityToolIsVisible) {
     return false;
   }
-  if (
-    !runningActivityLabel &&
-    (latestMessageHasUnresolvedTool ||
-      contentHasUnresolvedToolCall(reconnectContent))
-  ) {
+  if (!runningActivityLabel && (latestMessageHasTool || reconnectHasTool)) {
     return false;
   }
   // The reasoning cell already owns the generic Thinking state. Activity
@@ -1596,14 +1602,20 @@ export function shouldShowGlobalRunningStatus({
   // rendering both makes a second Thinking row flash beneath the thought.
   if (
     runningActivityLabel === "Thinking" &&
-    (latestMessageHasReasoning || contentHasVisibleReasoning(reconnectContent))
+    (latestMessageHasTool ||
+      reconnectHasTool ||
+      latestMessageHasTailReasoning ||
+      reconnectHasTailReasoning)
   ) {
     return false;
   }
   if (runningActivityLabel) return true;
 
   return (
-    !latestMessageHasReasoning && !contentHasVisibleReasoning(reconnectContent)
+    !latestMessageHasTool &&
+    !reconnectHasTool &&
+    !latestMessageHasTailReasoning &&
+    !reconnectHasTailReasoning
   );
 }
 
@@ -4676,6 +4688,40 @@ const AssistantChatInner = forwardRef<
     ],
   );
 
+  const mcpResumeTimerRef = useRef<number | null>(null);
+  const scheduleMcpConnectionResume = useCallback(
+    (request: McpConnectionResumeRequest) => {
+      if (mcpResumeTimerRef.current !== null) {
+        window.clearTimeout(mcpResumeTimerRef.current);
+      }
+      mcpResumeTimerRef.current = window.setTimeout(() => {
+        mcpResumeTimerRef.current = null;
+        void addToQueue(request.message);
+      }, 0);
+    },
+    [addToQueue],
+  );
+
+  useEffect(() => {
+    const pending = consumeMcpConnectionResume();
+    if (pending) scheduleMcpConnectionResume(pending);
+
+    return addMcpConnectionCompleteListener(() => {
+      const completed = consumeMcpConnectionResume();
+      if (completed) scheduleMcpConnectionResume(completed);
+    });
+  }, [scheduleMcpConnectionResume]);
+
+  useEffect(
+    () => () => {
+      if (mcpResumeTimerRef.current !== null) {
+        window.clearTimeout(mcpResumeTimerRef.current);
+        mcpResumeTimerRef.current = null;
+      }
+    },
+    [],
+  );
+
   useEffect(() => {
     if (!pendingReconnectRecovery) return;
     const recovery = pendingReconnectRecovery;

package/src/client/FeedbackButton.tsx

@@ -17,9 +17,6 @@ import { useOptionalLocale } from "./i18n.js";
 import { useSession } from "./use-session.js";
 import { cn } from "./utils.js";
 
-const DEFAULT_FEEDBACK_URL =
-  "https://forms.agent-native.com/f/agent-native-feedback/_16ewV";
-
 function isSyntheticAgentNativeAnonymousEmail(
   value: string | null | undefined,
 ): boolean {
@@ -234,7 +231,8 @@ export interface FeedbackButtonProps {
    */
   variant?: "sidebar" | "icon" | "outlined";
   label?: string;
-  url?: string;
+  /** Defaults to VITE_AGENT_NATIVE_FEEDBACK_URL. Missing, blank, or null hides the control. */
+  url?: string | null;
   className?: string;
   /** Which side the popover opens on. Defaults match the variant. */
   side?: "top" | "bottom" | "left" | "right";
@@ -267,10 +265,38 @@ const honeypotStyle: CSSProperties = {
   overflow: "hidden",
 };
 
-export function FeedbackButton({
+function clientEnv(): Record<string, string | boolean | undefined> | undefined {
+  const importMetaEnv = (
+    import.meta as unknown as {
+      env?: Record<string, string | boolean | undefined>;
+    }
+  ).env;
+  const processEnv = (
+    globalThis as typeof globalThis & {
+      process?: { env?: Record<string, string | boolean | undefined> };
+    }
+  ).process?.env;
+
+  if (importMetaEnv && processEnv) return { ...processEnv, ...importMetaEnv };
+  return importMetaEnv ?? processEnv;
+}
+
+export function resolveFeedbackUrl(url?: string | null): string | null {
+  const value =
+    url === undefined ? clientEnv()?.VITE_AGENT_NATIVE_FEEDBACK_URL : url;
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+
+export function FeedbackButton(props: FeedbackButtonProps) {
+  const url = resolveFeedbackUrl(props.url);
+  if (!url) return null;
+  return <FeedbackPopoverButton {...props} url={url} />;
+}
+
+function FeedbackPopoverButton({
   variant = "sidebar",
   label,
-  url = DEFAULT_FEEDBACK_URL,
+  url,
   className,
   side,
   align = "end",
@@ -281,7 +307,7 @@ export function FeedbackButton({
   open: controlledOpen,
   onOpenChange,
   trigger: customTrigger,
-}: FeedbackButtonProps) {
+}: Omit<FeedbackButtonProps, "url"> & { url: string }) {
   const target = parseTarget(url);
   const { session } = useSession();
   const localeContext = useOptionalLocale();

package/src/client/MultiTabAssistantChat.tsx

@@ -53,7 +53,6 @@ import {
   TooltipTrigger,
 } from "./components/ui/tooltip.js";
 import { isTrustedFrameMessage } from "./frame.js";
-import { KeepTabOpenNotice } from "./KeepTabOpenNotice.js";
 import { RunStuckBanner } from "./RunStuckBanner.js";
 import { callAction } from "./use-action.js";
 import { useChangeVersion } from "./use-change-version.js";
@@ -703,7 +702,7 @@ export type MultiTabAssistantChatProps = Omit<
   showTabBar?: boolean;
   /** Optional custom single-row header renderer */
   renderHeader?: (props: MultiTabAssistantChatHeaderProps) => React.ReactNode;
-  /** Optional overlay actions renderer for the active tab */
+  /** Optional page-level top-bar actions renderer for the active tab. */
   renderOverlay?: (props: MultiTabAssistantChatHeaderProps) => React.ReactNode;
   /** Hide the chat content while keeping the header visible. Used when CLI/resources mode is active. */
   contentHidden?: boolean;
@@ -2442,7 +2441,11 @@ export function MultiTabAssistantChat({
 
       {/* Chat content with optional overlay */}
       <div
-        className="relative flex-1 flex flex-col min-h-0"
+        className={cn(
+          "relative flex-1 flex flex-col min-h-0",
+          renderOverlay && "pt-14",
+        )}
+        data-agent-page-chat-topbar={renderOverlay ? "" : undefined}
         data-agent-page-chat-scrolled={
           renderOverlay && pageOverlayScrolled ? "" : undefined
         }
@@ -2494,11 +2497,6 @@ export function MultiTabAssistantChat({
                     contentHidden || tabId !== activeThreadId ? "none" : "flex",
                 }}
               >
-                <KeepTabOpenNotice
-                  threadId={tabId}
-                  enabled={tabId === activeThreadId}
-                  apiUrl={apiUrl}
-                />
                 <RunStuckBanner
                   threadId={tabId}
                   enabled={tabId === activeThreadId}

package/src/client/agent-chat-adapter.ts

@@ -23,6 +23,7 @@ import { agentNativePath } from "./api-path.js";
 import { formatChatErrorText, normalizeChatError } from "./error-format.js";
 import {
   AgentAutoContinueSignal,
+  appendMissingFinalResponseWarning,
   type AgentActivityTrailEntry,
   type AgentAutoContinueErrorInfo,
   type ContentPart,
@@ -2321,14 +2322,22 @@ export function createAgentChatAdapter(
 
           if (status === "completed") {
             // The turn finished server-side; the events we managed to fold are
-            // the durable transcript. Finalize with them.
+            // the durable transcript. Never turn a terminal tool-only chunk
+            // into a blank successful message when no explicit `done` event
+            // passed through the normal SSE finalizer.
             settleInterruptedToolCalls(content, undefined, {
               includeActivity: true,
             });
+            const runWarning = appendMissingFinalResponseWarning(content);
             yield {
               content: [...content],
               status: { type: "complete" as const, reason: "stop" as const },
-              metadata: { custom: { ...(runId ? { runId } : {}) } },
+              metadata: {
+                custom: {
+                  ...(runId ? { runId } : {}),
+                  ...(runWarning ? { runWarning } : {}),
+                },
+              },
             } as ChatModelRunResult;
             clearActiveRun();
             return;

package/src/client/agent-page/AgentTabFrame.tsx

@@ -1,3 +1,4 @@
+import { IconHelpCircle } from "@tabler/icons-react";
 import type { ReactNode } from "react";
 
 import { cn } from "../utils.js";
@@ -5,6 +6,8 @@ import { cn } from "../utils.js";
 interface AgentTabFrameProps {
   title: string;
   description: string;
+  helpHref?: string;
+  helpLabel?: string;
   actions?: ReactNode;
   children: ReactNode;
   className?: string;
@@ -14,6 +17,8 @@ interface AgentTabFrameProps {
 export function AgentTabFrame({
   title,
   description,
+  helpHref,
+  helpLabel,
   actions,
   children,
   className,
@@ -24,9 +29,23 @@ export function AgentTabFrame({
     >
       <header className="flex flex-wrap items-start justify-between gap-4 border-b border-border/70 pb-5">
         <div className="space-y-1">
-          <h2 className="text-xl font-semibold tracking-tight text-foreground">
-            {title}
-          </h2>
+          <div className="flex items-center gap-1.5">
+            <h2 className="text-xl font-semibold tracking-tight text-foreground">
+              {title}
+            </h2>
+            {helpHref && (
+              <a
+                href={helpHref}
+                target="_blank"
+                rel="noopener noreferrer"
+                aria-label={helpLabel ?? `Open ${title} documentation`}
+                title={helpLabel ?? `Open ${title} documentation`}
+                className="inline-flex size-6 shrink-0 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-accent/50 hover:text-foreground"
+              >
+                <IconHelpCircle className="size-4" />
+              </a>
+            )}
+          </div>
           <p className="max-w-2xl text-sm leading-relaxed text-muted-foreground">
             {description}
           </p>

package/src/client/agent-page/AgentTabsPage.tsx

@@ -133,40 +133,48 @@ function EmptySlot({ label }: { label: string }) {
   );
 }
 
+export const AGENT_RESOURCE_DOCS_HREF: Record<ResourceView, string> = {
+  files: "https://agent-native.com/docs/agent-resources#resources-tab",
+  instructions: "https://agent-native.com/docs/agent-resources#agents-md",
+  agents: "https://agent-native.com/docs/agent-resources#custom-agents",
+  memory: "https://agent-native.com/docs/agent-resources#memory",
+  skills: "https://agent-native.com/docs/skills-guide",
+  learnings: "https://agent-native.com/docs/agent-resources#memory",
+  "remote-agents":
+    "https://agent-native.com/docs/agent-resources#remote-vs-custom-agents",
+};
+
 const RESOURCE_TAB_COPY: Record<
   ResourceView,
-  { title: string; description: string }
+  { titleKey: string; descriptionKey: string }
 > = {
   files: {
-    title: "Files",
-    description: "Plain workspace files the agent can read and write.",
+    titleKey: "agentResources.files.title",
+    descriptionKey: "agentResources.files.description",
   },
   instructions: {
-    title: "Instructions",
-    description:
-      "The rules, preferences, and project guidance that steer the agent.",
+    titleKey: "agentResources.instructions.title",
+    descriptionKey: "agentResources.instructions.description",
   },
   agents: {
-    title: "Agents",
-    description: "Reusable profiles for focused sub-agents and delegated work.",
+    titleKey: "agentResources.agents.title",
+    descriptionKey: "agentResources.agents.description",
   },
   memory: {
-    title: "Memory",
-    description: "Durable notes the agent can retrieve across conversations.",
+    titleKey: "agentResources.memory.title",
+    descriptionKey: "agentResources.memory.description",
   },
   skills: {
-    title: "Skills",
-    description:
-      "Specialized instructions that give the agent repeatable abilities.",
+    titleKey: "agentResources.skills.title",
+    descriptionKey: "agentResources.skills.description",
   },
   learnings: {
-    title: "Learnings",
-    description:
-      "Corrections and patterns worth carrying forward for future work.",
+    titleKey: "agentResources.learnings.title",
+    descriptionKey: "agentResources.learnings.description",
   },
   "remote-agents": {
-    title: "Remote agents",
-    description: "Other agents this workspace can call through A2A.",
+    titleKey: "agentResources.remoteAgents.title",
+    descriptionKey: "agentResources.remoteAgents.description",
   },
 };
 
@@ -174,9 +182,16 @@ function AgentResourceTab({
   scope,
   view,
 }: AgentPageTabProps & { view: ResourceView }) {
+  const t = useT();
   const copy = RESOURCE_TAB_COPY[view];
+  const title = t(copy.titleKey);
   return (
-    <AgentTabFrame title={copy.title} description={copy.description}>
+    <AgentTabFrame
+      title={title}
+      description={t(copy.descriptionKey)}
+      helpHref={AGENT_RESOURCE_DOCS_HREF[view]}
+      helpLabel={t("agentResources.openDocs", { section: title })}
+    >
       <div className="min-h-[480px]">
         <ResourcesPanel
           key={`${scope}-${view}`}

package/src/client/analytics.ts

@@ -50,6 +50,13 @@ declare global {
     __AGENT_NATIVE_CONFIG__?: {
       sentryDsn?: string;
       sentryEnvironment?: string;
+      /**
+       * Hosted Realtime Gateway config. Impersonal (same for every visitor),
+       * so it is safe inside the CDN-cached SSR shell — unlike the per-user
+       * subscribe token, which is minted client-side after load. Absent when
+       * the app uses the in-process (local) transport.
+       */
+      realtime?: { transport?: string; gatewayBaseUrl?: string };
     };
   }
 }