@agent-native/core 0.115.4 → 0.117.0

package/corpus/core/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/corpus/core/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/corpus/core/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 };
     };
   }
 }

package/corpus/core/src/client/chat/message-components.tsx

@@ -14,9 +14,9 @@ import {
   ComposerPrimitive,
   useMessagePartReasoning,
   useMessagePartRuntime,
+  useAuiState,
 } from "@assistant-ui/react";
 import type { Attachment } from "@assistant-ui/react";
-import { useAuiState } from "@assistant-ui/store";
 import {
   IconX,
   IconCheck,
@@ -71,6 +71,7 @@ import {
 } from "./markdown-renderer.js";
 import {
   ToolCallFallback,
+  ToolActivityPresentation,
   FilesChangedSummary,
   ASSISTANT_VISIBLE_TOOL_CALL_LIMIT,
   ChatRunningContext,
@@ -862,7 +863,7 @@ export function assistantMessageHasUnresolvedTool(content: unknown): boolean {
 // Only the last assistant message may shimmer as "the currently running
 // tool" — an older message's dangling unresolved tool-call must never
 // shimmer once a later run is active.
-export function computeLatestRunningToolCallId(
+export function computeActiveTailToolCallId(
   content: ContentPart[] | undefined,
   { chatRunning, isLast }: { chatRunning: boolean; isLast: boolean },
 ): string | null {
@@ -870,9 +871,7 @@ export function computeLatestRunningToolCallId(
   return (
     content?.reduce(
       (latestToolCallId, part) =>
-        part.type === "tool-call" &&
-        part.result === undefined &&
-        (chatRunning || part.activity === true)
+        part.type === "tool-call" && (chatRunning || part.activity === true)
           ? part.toolCallId
           : latestToolCallId,
       null as string | null,
@@ -900,6 +899,18 @@ export function shouldShowAssistantMessageFooter({
   return statusIsTerminal;
 }
 
+export function shouldShowMissingFinalResponse({
+  statusIsTerminal,
+  hasAssistantText,
+  hasUnresolvedTool,
+}: {
+  statusIsTerminal: boolean;
+  hasAssistantText: boolean;
+  hasUnresolvedTool: boolean;
+}): boolean {
+  return statusIsTerminal && !hasAssistantText && !hasUnresolvedTool;
+}
+
 export function shouldShowAssistantWorkSummary({
   isLast,
   isComplete,
@@ -1061,12 +1072,18 @@ export function AssistantMessage() {
   const hasRenderableContent = assistantMessageHasRenderableContent(msg);
   const hasUnresolvedTool = assistantMessageHasUnresolvedTool(msg.content);
   const responseConnectionText = messageTextFromContent(msg.content);
+  const statusIsTerminal = assistantMessageStatusIsTerminal(msg);
+  const showMissingFinalResponse = shouldShowMissingFinalResponse({
+    statusIsTerminal,
+    hasAssistantText: responseConnectionText.trim().length > 0,
+    hasUnresolvedTool,
+  });
   const responseConnectionContext = latestUserMessageText(thread.messages);
   const isComplete = shouldShowAssistantMessageFooter({
     isLast,
     chatRunning,
     hasRenderableContent,
-    statusIsTerminal: assistantMessageStatusIsTerminal(msg),
+    statusIsTerminal,
     hasUnresolvedTool,
   });
   const cpCtx = React.useContext(CheckpointContext);
@@ -1178,7 +1195,7 @@ export function AssistantMessage() {
         (p.type !== "tool-call" || p.activity !== true) &&
         isCollapsibleAssistantWorkPart(p),
     );
-  const latestRunningToolCallId = computeLatestRunningToolCallId(msgContent, {
+  const activeTailToolCallId = computeActiveTailToolCallId(msgContent, {
     chatRunning,
     isLast,
   });
@@ -1226,21 +1243,31 @@ export function AssistantMessage() {
               case "reasoning":
                 return <ReasoningMessagePart />;
               case "tool-call":
-                return (
-                  part.toolUI ?? (
-                    <ToolCallFallback
-                      {...part}
-                      isLatestRunning={
-                        part.toolCallId === latestRunningToolCallId
-                      }
-                    />
-                  )
+                return part.toolUI ? (
+                  <ToolActivityPresentation
+                    toolName={part.toolName}
+                    isRunning={part.status?.type === "running"}
+                    isActiveTail={part.toolCallId === activeTailToolCallId}
+                  >
+                    {part.toolUI}
+                  </ToolActivityPresentation>
+                ) : (
+                  <ToolCallFallback
+                    {...part}
+                    isActiveTail={part.toolCallId === activeTailToolCallId}
+                  />
                 );
               default:
                 return null;
             }
           }}
         </MessagePrimitive.GroupedParts>
+        {showMissingFinalResponse && (
+          <p role="status" className="text-muted-foreground">
+            The agent stopped without sending a final message. Ask it to
+            continue or retry.
+          </p>
+        )}
         {isComplete && hasCodeAgentTools && msgContent && (
           <FilesChangedSummary parts={msgContent} />
         )}

package/corpus/core/src/client/chat/tool-call-display.tsx

@@ -94,20 +94,22 @@ export const ApprovalContext = React.createContext<ApprovalContextValue | null>(
 
 export const TOOL_LONG_RUNNING_HINT_DELAY_MS = 45_000;
 
-function ToolLongRunningHintShell({
+export function ToolActivityPresentation({
   toolName,
   isRunning,
+  isActiveTail,
   children,
 }: {
   toolName: string;
   isRunning: boolean;
+  isActiveTail: boolean;
   children: React.ReactNode;
 }) {
   const [showLongRunningHint, setShowLongRunningHint] = useState(false);
-  // useState initializer runs once at mount: a row that mounts already
-  // resolved never animates, while a tool appended during an active stream
-  // mounts running and animates in.
-  const [animateEntry] = useState(isRunning);
+  // A batched update can first reveal a tool with its result already attached.
+  // Presentation follows the active chat tail rather than execution state so
+  // that newly revealed completed tools still get their entrance motion.
+  const [animateEntry] = useState(isActiveTail);
 
   useEffect(() => {
     if (!isRunning) {
@@ -125,10 +127,10 @@ function ToolLongRunningHintShell({
     <div
       className={cn(
         "agent-tool-call",
-        animateEntry &&
-          "motion-safe:animate-in motion-safe:fade-in-0 motion-safe:slide-in-from-bottom-1 motion-safe:duration-200 motion-safe:ease-[var(--ease-out-strong)]",
+        animateEntry && "agent-tool-call--entering",
       )}
       data-running={isRunning ? "true" : undefined}
+      data-active-tail={isActiveTail ? "true" : undefined}
     >
       {children}
       {isRunning && showLongRunningHint && (
@@ -554,6 +556,7 @@ export function ToolCallDisplay({
   approval,
   repeatCount,
   isLatestRunning = isRunning,
+  isActiveTail,
 }: {
   toolName: string;
   argsText?: string;
@@ -565,16 +568,24 @@ export function ToolCallDisplay({
   structuredMeta?: Record<string, unknown>;
   approval?: { approvalKey: string; dismissed?: boolean };
   repeatCount?: number;
+  /** The latest tool shown while the overall chat turn is still active. */
+  isActiveTail?: boolean;
+  /** @deprecated Use isActiveTail. */
   isLatestRunning?: boolean;
 }) {
+  const showActiveTail = isActiveTail ?? isLatestRunning;
   // Delegate to bespoke cells when structured metadata is present.
   // These must be separate components so hook order in ToolCallDisplayGeneric
   // is always stable (no conditional hook calls).
   const toolKind = structuredMeta?.toolKind as string | undefined;
   const wrapToolDisplay = (children: React.ReactNode) => (
-    <ToolLongRunningHintShell toolName={toolName} isRunning={isRunning}>
+    <ToolActivityPresentation
+      toolName={toolName}
+      isRunning={isRunning}
+      isActiveTail={showActiveTail}
+    >
       {children}
-    </ToolLongRunningHintShell>
+    </ToolActivityPresentation>
   );
   if (toolKind === "bash") {
     return wrapToolDisplay(
@@ -616,7 +627,7 @@ export function ToolCallDisplay({
       mcpApp={mcpApp}
       chatUI={chatUI}
       isRunning={isRunning}
-      isLatestRunning={isLatestRunning}
+      isActiveTail={showActiveTail}
       approval={approval}
       repeatCount={repeatCount}
     />,
@@ -631,7 +642,7 @@ function ToolCallDisplayGeneric({
   mcpApp,
   chatUI,
   isRunning,
-  isLatestRunning,
+  isActiveTail,
   approval,
   repeatCount,
 }: {
@@ -642,7 +653,7 @@ function ToolCallDisplayGeneric({
   mcpApp?: AgentMcpAppPayload;
   chatUI?: ActionChatUIConfig;
   isRunning: boolean;
-  isLatestRunning: boolean;
+  isActiveTail: boolean;
   approval?: { approvalKey: string; dismissed?: boolean };
   repeatCount?: number;
 }) {
@@ -734,6 +745,7 @@ function ToolCallDisplayGeneric({
     resultText: result,
     resultJson: parsedResult,
     isRunning,
+    isActiveTail,
     chatUI,
   };
   const skipRegistryRenderer =
@@ -805,7 +817,7 @@ function ToolCallDisplayGeneric({
         <span
           className={cn(
             "min-w-0 truncate font-normal",
-            isRunning && isLatestRunning && "agent-running-shimmer",
+            isActiveTail && "agent-running-shimmer",
           )}
         >
           {displayName}
@@ -888,6 +900,7 @@ export function ToolCallFallback({
   approval?: { approvalKey: string; dismissed?: boolean };
   repeatCount?: number;
   isLatestRunning?: boolean;
+  isActiveTail?: boolean;
 }) {
   const chatRunning = React.useContext(ChatRunningContext);
   const isRunning =
@@ -908,6 +921,7 @@ export function ToolCallFallback({
       chatUI={rest.chatUI}
       structuredMeta={rest.structuredMeta}
       isRunning={isRunning}
+      isActiveTail={rest.isActiveTail}
       isLatestRunning={rest.isLatestRunning}
       approval={rest.approval}
       repeatCount={rest.repeatCount}
@@ -935,11 +949,9 @@ export function ReconnectStreamMessage({
     content.at(-1)?.type === "text" ? content.length - 1 : -1;
   const streamingReasoningPartIndex =
     content.at(-1)?.type === "reasoning" ? content.length - 1 : -1;
-  const latestRunningToolIndex = content.reduce(
+  const latestActiveToolIndex = content.reduce(
     (latestIndex, part, index) =>
-      part.type === "tool-call" &&
-      part.result === undefined &&
-      (chatRunning || part.activity === true)
+      part.type === "tool-call" && (chatRunning || part.activity === true)
         ? index
         : latestIndex,
     -1,
@@ -983,7 +995,7 @@ export function ReconnectStreamMessage({
         isRunning={
           part.result === undefined && (chatRunning || part.activity === true)
         }
-        isLatestRunning={i === latestRunningToolIndex}
+        isActiveTail={i === latestActiveToolIndex}
         approval={part.approval}
         repeatCount={part.repeatCount}
       />

package/corpus/core/src/client/chat/tool-render-registry.tsx

@@ -8,6 +8,8 @@ export interface ToolRendererContext {
   resultText?: string;
   resultJson: unknown;
   isRunning: boolean;
+  /** True while this is the newest tool representing an active chat turn. */
+  isActiveTail?: boolean;
   chatUI?: ActionChatUIConfig;
 }
 

package/corpus/core/src/client/resources/McpConnectionSuggestion.tsx

@@ -9,6 +9,11 @@ import { useEffect, useMemo, useState } from "react";
 import { agentNativePath } from "../api-path.js";
 import { openAgentSettings } from "../CommandMenu.js";
 import { useT } from "../i18n.js";
+import {
+  clearMcpConnectionResume,
+  notifyMcpConnectionComplete,
+  saveMcpConnectionResume,
+} from "./mcp-connection-resume.js";
 import {
   buildMcpOAuthStartUrl,
   findMcpIntegrationForText,
@@ -144,6 +149,7 @@ export function McpConnectionSuggestion({
     }
 
     if (canStartOAuth(integration)) {
+      saveMcpConnectionResume(variant === "response" ? contextText : text);
       window.location.assign(
         agentNativePath(
           buildMcpOAuthStartUrl({
@@ -162,6 +168,7 @@ export function McpConnectionSuggestion({
       integration.authMode === "none" &&
       integration.connectionMode === "direct"
     ) {
+      saveMcpConnectionResume(variant === "response" ? contextText : text);
       setConnecting(true);
       try {
         await createMcpServer.mutateAsync({
@@ -171,7 +178,9 @@ export function McpConnectionSuggestion({
           description: integration.description,
         });
         setDismissedId(integration.id);
+        notifyMcpConnectionComplete();
       } catch (cause) {
+        clearMcpConnectionResume();
         setError(
           cause instanceof Error ? cause.message : t("mcpIntegrations.failed"),
         );
@@ -181,6 +190,7 @@ export function McpConnectionSuggestion({
       return;
     }
 
+    saveMcpConnectionResume(variant === "response" ? contextText : text);
     setDialogOpen(true);
   };
 
@@ -262,13 +272,20 @@ export function McpConnectionSuggestion({
       )}
       <McpIntegrationDialog
         open={dialogOpen}
-        onOpenChange={setDialogOpen}
+        onOpenChange={(open) => {
+          setDialogOpen(open);
+          if (!open) clearMcpConnectionResume();
+        }}
         initialIntegrationId={integration.id}
         defaultScope="user"
         canCreateOrgMcp={false}
         hasOrg={Boolean(mcpServersQuery.data?.orgId)}
         onCreateMcpServer={(args) => createMcpServer.mutateAsync(args)}
-        onCreated={() => setDismissedId(integration.id)}
+        onCreated={() => {
+          setDismissedId(integration.id);
+          saveMcpConnectionResume(variant === "response" ? contextText : text);
+          notifyMcpConnectionComplete();
+        }}
         integrations={integrations}
       />
     </>

package/corpus/core/src/client/resources/ResourceTree.tsx

@@ -849,16 +849,13 @@ export function ResourceTree({
       )}
 
       {isEmpty && !creating && !isLoading && (
-        <div className="flex items-start gap-2 border-y border-border/60 px-2 py-4">
-          <IconFile className="mt-0.5 size-3.5 shrink-0 text-muted-foreground" />
-          <div className="flex flex-col items-start gap-2">
-            <p className="text-xs text-muted-foreground">
-              {variant === "collection"
-                ? "No resources in this collection yet"
-                : "No files yet"}
-            </p>
-            {emptyStateAction}
-          </div>
+        <div className="flex flex-col items-start border-y border-border/60 px-2 py-5">
+          <p className="ps-5 text-xs text-muted-foreground">
+            {variant === "collection"
+              ? "No resources in this collection yet"
+              : "No files yet"}
+          </p>
+          {emptyStateAction && <div className="mt-4">{emptyStateAction}</div>}
         </div>
       )}
     </div>