@agent-native/core 0.109.3 → 0.110.0

package/corpus/core/src/cli/upgrade.ts

@@ -27,6 +27,8 @@ export interface UpgradeCliOptions {
   command: UpgradeCommand;
   cwd?: string;
   dryRun?: boolean;
+  codemods?: boolean;
+  yes?: boolean;
   skipInstall?: boolean;
   skipVerify?: boolean;
   skipSkills?: boolean;
@@ -93,6 +95,11 @@ export interface UpgradeRunResult {
   }>;
   message: string;
   exitCode: number;
+  codemod?: {
+    files: string[];
+    warnings: string[];
+    diff: string;
+  };
 }
 
 export interface UpgradeIo {
@@ -139,6 +146,10 @@ export function parseUpgradeArgs(argv: string[]): UpgradeCliOptions {
       opts.help = true;
     } else if (arg === "--dry-run") {
       opts.dryRun = true;
+    } else if (arg === "--codemods") {
+      opts.codemods = true;
+    } else if (arg === "--yes") {
+      opts.yes = true;
     } else if (arg === "--skip-install") {
       opts.skipInstall = true;
     } else if (arg === "--skip-verify") {
@@ -167,9 +178,12 @@ export function printUpgradeHelp(io: Pick<UpgradeIo, "log"> = defaultIo): void {
       "  agent-native upgrade              Bring this app/workspace to current @agent-native/*",
       "  agent-native upgrade check        Doctor only: overrides, patches, pending bumps",
       "  agent-native upgrade --dry-run    Show the plan without writing or installing",
+      "  agent-native upgrade --codemods   Preview manifest-driven import migrations",
       "",
       "Options:",
       "  --skip-install   Bump package.json only; do not run the package manager",
+      "  --codemods       Rewrite moved Agent Native imports and exports (preview by default)",
+      "  --yes            Apply codemods; without this flag --codemods is a dry run",
       "  --skip-skills    Skip `skills update scaffold --project`",
       "  --skip-verify    Skip typecheck after upgrade",
       "  --force          Continue even when framework overrides/patches are present",
@@ -566,9 +580,10 @@ export async function runUpgrade(
     return doctor.findings.length > 0 ? 1 : 0;
   }
 
+  const dryRun = Boolean(opts.dryRun || (opts.codemods && !opts.yes));
   const result: UpgradeRunResult = {
     ok: true,
-    dryRun: Boolean(opts.dryRun),
+    dryRun,
     doctor,
     steps: [],
     message: "",
@@ -613,7 +628,7 @@ export async function runUpgrade(
       status: "skipped",
       detail: "All @agent-native/* deps already use latest or local pins",
     });
-  } else if (opts.dryRun) {
+  } else if (dryRun) {
     result.steps.push({
       id: "bump",
       status: "planned",
@@ -644,6 +659,45 @@ export async function runUpgrade(
     });
   }
 
+  if (opts.codemods) {
+    const { formatMigrationCodemodDiff, runMigrationCodemods } =
+      await import("./migration-codemod.js");
+    const codemodResult = runMigrationCodemods({
+      root: project.root,
+      apply: !dryRun,
+    });
+    const diff = formatMigrationCodemodDiff(codemodResult, project.root);
+    result.codemod = {
+      files: codemodResult.changes.map((change) =>
+        relativeTo(project.root, change.file),
+      ),
+      warnings: codemodResult.warnings,
+      diff,
+    };
+    result.steps.push({
+      id: "codemods",
+      status:
+        codemodResult.changes.length === 0
+          ? "skipped"
+          : dryRun
+            ? "planned"
+            : "ok",
+      detail:
+        codemodResult.changes.length === 0
+          ? "No manifest migrations found"
+          : `${dryRun ? "Would update" : "Updated"} ${codemodResult.changes.length} file(s)`,
+    });
+    if (!opts.json && diff) {
+      io.log(diff);
+      io.log("");
+    }
+    if (!opts.json) {
+      for (const warning of codemodResult.warnings) {
+        io.err(`[codemods] ${warning}`);
+      }
+    }
+  }
+
   // Install.
   if (opts.skipInstall) {
     result.steps.push({
@@ -651,7 +705,7 @@ export async function runUpgrade(
       status: "skipped",
       detail: "--skip-install",
     });
-  } else if (opts.dryRun) {
+  } else if (dryRun) {
     result.steps.push({
       id: "install",
       status: "planned",
@@ -685,7 +739,7 @@ export async function runUpgrade(
       status: "skipped",
       detail: "--skip-skills",
     });
-  } else if (opts.dryRun) {
+  } else if (dryRun) {
     result.steps.push({
       id: "skills",
       status: "planned",
@@ -720,7 +774,7 @@ export async function runUpgrade(
       status: "skipped",
       detail: "--skip-verify",
     });
-  } else if (opts.dryRun) {
+  } else if (dryRun) {
     result.steps.push({
       id: "verify",
       status: "planned",
@@ -763,8 +817,10 @@ export async function runUpgrade(
     }
   }
 
-  result.message = opts.dryRun
-    ? "Dry run complete. Re-run without --dry-run to apply."
+  result.message = dryRun
+    ? opts.codemods && !opts.yes
+      ? "Codemod preview complete. Re-run with --codemods --yes to apply."
+      : "Dry run complete. Re-run without --dry-run to apply."
     : "Upgrade complete. If the app still fails to run, fix app-level code — do not patch @agent-native/*.";
   emitResult(io, opts, result);
   return 0;

package/corpus/core/src/client/agent-chat/index.ts

@@ -0,0 +1,279 @@
+export {
+  AgentAskPopover,
+  type AgentAskPopoverProps,
+} from "../AgentAskPopover.js";
+export {
+  addContextToAgentChat,
+  appendAgentChatContextToMessage,
+  clearAgentChatContext,
+  formatAgentChatContextItemsForPrompt,
+  insertAgentComposerReference,
+  listAgentChatContext,
+  normalizeAgentComposerReference,
+  refreshAgentChatContext,
+  removeAgentChatContextItem,
+  requestAgentChatThreadOpen,
+  requestAgentTaskOpen,
+  sendToAgentChat,
+  sendToAgentChatAndConfirm,
+  reportAgentChatSubmitResult,
+  AGENT_CHAT_SUBMIT_RESULT_EVENT,
+  parseSubmitChatMessage,
+  setAgentChatContextItem,
+  setContextToAgentChat,
+  generateTabId,
+  type ParsedSubmitChat,
+  type AgentChatOpenTaskRequest,
+  type AgentChatOpenThreadRequest,
+  type AgentChatContextItem,
+  type AgentChatContextMessage,
+  type AgentChatContextMutationOptions,
+  type AgentChatContextRemoveOptions,
+  type AgentChatContextSetOptions,
+  type AgentChatContextState,
+  type AgentChatMessage,
+  type AgentChatSubmitResult,
+  type SendToAgentChatAndConfirmResult,
+  type AgentComposerReference,
+  type AgentComposerReferenceInsertOptions,
+  type AgentComposerReferenceInsertPayload,
+} from "../agent-chat.js";
+export {
+  saveAgentEngineApiKey,
+  saveAgentEngineProviderSettings,
+  type AgentEngineProvider,
+  type SaveAgentEngineApiKeyOptions,
+  type SaveAgentEngineProviderSettingsOptions,
+} from "../agent-engine-key.js";
+export { useAgentChatGenerating } from "../use-agent-chat.js";
+export {
+  useAgentChatContext,
+  type UseAgentChatContextResult,
+} from "../use-agent-chat-context.js";
+export { useCodeMode, useDevMode } from "../use-dev-mode.js";
+export {
+  codeAgentTranscriptEventsToContent,
+  codeAgentTranscriptHasPendingApproval,
+  createCodeAgentChatAdapter,
+  type CodeAgentChatController,
+  type CodeAgentChatControlResult,
+  type CodeAgentChatFollowUpMode,
+  type CodeAgentChatTranscriptEvent,
+  type CreateCodeAgentChatAdapterOptions,
+} from "../code-agent-chat-adapter.js";
+export {
+  buildRepositoryFromCodeAgentTranscript,
+  type BuildRepositoryFromCodeAgentTranscriptOptions,
+  type CodeAgentThreadTranscriptEvent,
+} from "../../agent/thread-data-builder.js";
+export {
+  compareCodeAgentTranscriptEvents,
+  getCodeAgentTranscriptSeq,
+  isCodeAgentRunActive,
+  mergeCodeAgentTranscriptEvents,
+  type CodeAgentRunStateLike,
+  type CodeAgentTranscriptOrderEvent,
+} from "../../code-agents/transcript-order.js";
+export {
+  CREDENTIAL_GAP_SIGNAL,
+  isCredentialGapCodeAgentEvent,
+} from "../../code-agents/transcript-normalizer.js";
+export { useSendToAgentChat } from "../use-send-to-agent-chat.js";
+export {
+  useChatModels,
+  type UseChatModelsResult,
+  type EngineModelGroup,
+} from "../use-chat-models.js";
+export {
+  CodeRequiredDialog,
+  type CodeRequiredDialogProps,
+} from "../components/CodeRequiredDialog.js";
+export {
+  useAgentEngineConfigured,
+  type AgentEngineConfiguredState,
+  type UseAgentEngineConfiguredResult,
+} from "../use-agent-engine-configured.js";
+export { BuilderSetupCard } from "../chat/run-recovery.js";
+export {
+  AgentConversation,
+  AgentConversationMessageView,
+  normalizeCodeAgentTranscriptForConversation,
+  useNearBottomAutoscroll,
+  type CodeAgentConversationTranscriptEvent,
+  type CodeAgentConversationTranscriptEventType,
+  type NormalizeCodeAgentTranscriptOptions,
+  type AgentConversationArtifact,
+  type AgentConversationAttachment,
+  type AgentConversationMessage,
+  type AgentConversationMessagePart,
+  type AgentConversationMessageRole,
+  type AgentConversationNotice,
+  type AgentConversationNoticeTone,
+  type AgentConversationToolCall,
+  type AgentConversationToolState,
+} from "../conversation/index.js";
+export { McpAppRenderer } from "../mcp-apps/McpAppRenderer.js";
+export {
+  AGENT_NATIVE_MCP_APP_HOST_MESSAGE_TYPES,
+  getMcpAppHostContext,
+  openMcpAppHostLink,
+  requestMcpAppDisplayMode,
+  sendMcpAppHostMessage,
+  updateMcpAppModelContext,
+  useMcpAppHostContext,
+  type AgentNativeMcpAppHostMessageType,
+  type McpAppDisplayMode,
+  type McpAppHostChatMessage,
+  type McpAppHostCapabilities,
+  type McpAppHostContext,
+  type McpAppHostContextSnapshot,
+  type McpAppModelContextContentPart,
+  type McpAppModelContextUpdate,
+} from "../mcp-app-host.js";
+export {
+  CodeAgentIndicator,
+  type CodeAgentIndicatorProps,
+} from "../components/CodeAgentIndicator.js";
+export {
+  buildDynamicAgentSuggestions,
+  dedupeSuggestions,
+  mergeAgentSuggestions,
+  normalizeAgentDynamicSuggestionsConfig,
+  useAgentDynamicSuggestions,
+  type AgentDynamicSuggestionContext,
+  type AgentDynamicSuggestionsConfig,
+  type AgentDynamicSuggestionsOption,
+} from "../dynamic-suggestions.js";
+export {
+  AssistantChat,
+  clearChatStorage,
+  type AssistantChatProps,
+  type AssistantChatHandle,
+  type AssistantChatAdapterContext,
+} from "../AssistantChat.js";
+export {
+  MultiTabAssistantChat,
+  type MultiTabAssistantChatProps,
+  type MultiTabAssistantChatHeaderProps,
+} from "../MultiTabAssistantChat.js";
+export { RunStuckBanner, type RunStuckBannerProps } from "../RunStuckBanner.js";
+export {
+  KeepTabOpenNotice,
+  type KeepTabOpenNoticeProps,
+} from "../KeepTabOpenNotice.js";
+export {
+  useRunStuckDetection,
+  useAbortRun,
+  type RunStuckState,
+  type UseRunStuckDetectionOptions,
+} from "../use-run-stuck-detection.js";
+export {
+  createAgentChatAdapter,
+  type AgentChatSurfaceKind,
+  type CreateAgentChatAdapterOptions,
+} from "../agent-chat-adapter.js";
+export {
+  GuidedQuestionFlow,
+  useGuidedQuestionFlow,
+  askUserQuestion,
+  formatGuidedAnswerValue,
+  formatGuidedAnswersForAgent,
+  getOtherGuidedAnswerText,
+  hasGuidedAnswer,
+  isOtherGuidedAnswer,
+  makeOtherGuidedAnswer,
+  normalizeGuidedAnswers,
+  type AskUserQuestionInput,
+  type AskUserQuestionOption,
+  type AskUserQuestionResult,
+  type GuidedQuestion,
+  type GuidedQuestionAnswers,
+  type GuidedQuestionFlowProps,
+  type GuidedQuestionOption,
+  type GuidedQuestionPayload,
+  type GuidedQuestionType,
+  type UseGuidedQuestionFlowOptions,
+} from "../guided-questions.js";
+export {
+  useChatThreads,
+  type ChatThreadScope,
+  type ChatThreadSnapshot,
+  type ChatThreadSummary,
+  type ChatThreadData,
+  type ChatThreadShareLink,
+  type ChatThreadShareState,
+  type UseChatThreadsOptions,
+} from "../use-chat-threads.js";
+export {
+  ChatHistoryList,
+  type ChatHistoryItem,
+  type ChatHistorySection,
+  type ChatHistoryListProps,
+} from "../chat/ChatHistoryList.js";
+export { AgentChatHome, type AgentChatHomeProps } from "../AgentChatHome.js";
+export {
+  AgentChatSurface,
+  AgentPanel,
+  AgentSidebar,
+  AgentToggleButton,
+  focusAgentChat,
+  type AgentChatSurfaceMode,
+  type AgentChatSurfaceProps,
+  type AgentPanelProps,
+  type AgentSidebarProps,
+} from "../AgentPanel.js";
+export {
+  AgentTabsPage,
+  type AgentPageExtraTabContext,
+  type AgentPageExtraTabFactory,
+  type AgentTabsPageProps,
+} from "../agent-page/AgentTabsPage.js";
+export type { AgentPageScope, AgentPageTabProps } from "../agent-page/types.js";
+export {
+  AGENT_CHAT_HOME_HANDOFF_TTL_MS,
+  AGENT_CHAT_VIEW_TRANSITION_CLASS,
+  AGENT_CHAT_VIEW_TRANSITION_NAME,
+  consumeAgentChatHomeHandoff,
+  getAgentChatViewTransitionStyle,
+  isAgentChatHomeHandoffActive,
+  markAgentChatHomeHandoff,
+  navigateWithAgentChatViewTransition,
+  startAgentChatViewTransition,
+  supportsAgentChatViewTransition,
+  type AgentChatHomeHandoffOptions,
+  type AgentChatViewTransition,
+  type AgentChatViewTransitionOptions,
+} from "../chat-view-transition.js";
+export {
+  useAgentChatHomeHandoff,
+  useAgentChatHomeHandoffLinks,
+  type UseAgentChatHomeHandoffLinksOptions,
+  type UseAgentChatHomeHandoffOptions,
+} from "../use-agent-chat-home-handoff.js";
+export {
+  requestAgentSidebarOpen,
+  SIDEBAR_STATE_CHANGE_EVENT,
+  setAgentSidebarOpenPreference,
+  type AgentSidebarStateChangeDetail,
+  type AgentSidebarStateMode,
+  type AgentSidebarStateSource,
+} from "../agent-sidebar-state.js";
+export {
+  clearReservedToolRenderersForTests,
+  clearToolRenderersForTests,
+  registerActionChatRenderer,
+  registerFallbackToolRenderer,
+  registerReservedActionChatRenderer,
+  registerReservedFallbackToolRenderer,
+  registerReservedToolRenderer,
+  registerToolRenderer,
+  resolveToolRenderer,
+  type ActionChatRendererRegistration,
+  type ToolRendererComponent,
+  type ToolRendererContext,
+  type ToolRendererMatch,
+  type ToolRendererProps,
+  type ToolRendererRegistration,
+} from "../chat/tool-render-registry.js";
+export * from "../chat/connectors.js";
+export * from "../chat/runtime.js";

package/corpus/core/src/client/agent-page/AgentContextTab.tsx

@@ -332,7 +332,9 @@ export function AgentContextTab({ scope }: AgentPageTabProps) {
   const preview = previewQuery.data;
   const previewManifest = preview ? previewAsManifest(preview) : null;
   const budget = resolveContextWindow(preview?.model);
-  const title = t("contextXray.pageTitle", { defaultValue: "Snapshots" });
+  const title = t("contextXray.snapshotsTitle", {
+    defaultValue: "Snapshots",
+  });
   const description = t("contextXray.headerDescription", {
     defaultValue:
       "Inspect the latest combined snapshot of what the agent loaded and why.",

package/corpus/core/src/client/analytics/index.ts

@@ -0,0 +1,40 @@
+export {
+  AGENT_NATIVE_EXCEPTION_EVENT_NAME,
+  addErrorBreadcrumb,
+  captureClientException,
+  captureError,
+  captureException,
+  captureMessage,
+  configureTracking,
+  getAnalyticsAnonymousId,
+  getAnalyticsSessionId,
+  getFirstTouchAttribution,
+  getSessionReplayContext,
+  getSessionReplayUrl,
+  isErrorCaptureInstalled,
+  maybeStartSessionReplay,
+  setSentryUser,
+  setTrackingContentCaptureEnabled,
+  setTrackingIdentity,
+  startSessionReplay,
+  stopSessionReplay,
+  trackAgentChatLifecycle,
+  trackEvent,
+  trackSessionStatus,
+  type AgentChatLifecycleEvent,
+  type CaptureExceptionContext,
+  type CapturedExceptionEvent,
+  type ClientCaptureContext,
+  type ConfigureTrackingOptions,
+  type ErrorCaptureConfigOptions,
+  type ExceptionBreadcrumb,
+  type ExceptionLevel,
+  type FirstTouchAttribution,
+  type SessionReplayContext,
+  type SessionReplayLinkOptions,
+  type SessionReplayOptions,
+  type SessionReplayStartResult,
+  type SessionReplayUrlMatcher,
+  type TrackingIdentityUser,
+} from "../analytics.js";
+export { track } from "../track.js";

package/corpus/core/src/client/api-path.ts

@@ -1,4 +1,4 @@
-import { ensureEmbedAuthFetchInterceptor } from "./embed-auth.js";
+import { initializeAgentNativeClient } from "./client-bootstrap.js";
 
 const FRAMEWORK_ROUTE_PREFIX = "/_agent-native";
 
@@ -86,7 +86,7 @@ function externalEmbedTargetBasePath(): string {
 }
 
 export function appBasePath(): string {
-  ensureEmbedAuthFetchInterceptor();
+  initializeAgentNativeClient();
   const externalEmbed = externalEmbedTargetBasePath();
   if (externalEmbed) return externalEmbed;
   const configured = configuredBasePath();

package/corpus/core/src/client/automation/index.ts

@@ -0,0 +1,4 @@
+export {
+  invokeConfiguredAutomationWorkflow,
+  type InvokeConfiguredAutomationWorkflowInput,
+} from "../automation.js";

package/corpus/core/src/client/changelog/index.ts

@@ -0,0 +1 @@
+export * from "./Changelog.js";

package/corpus/core/src/client/chat/widgets/InlineExtensionWidget.tsx

@@ -1,93 +1,14 @@
 import { IconExternalLink, IconSparkles } from "@tabler/icons-react";
 
-import { extensionPath } from "../../../extensions/path.js";
 import { appPath } from "../../api-path.js";
 import { InlineExtensionFrame } from "../../extensions/InlineExtensionFrame.js";
 import type { ToolRendererContext } from "../tool-render-registry.js";
+import { normalizeInlineExtensionToolResult } from "./inline-extension-result.js";
 
-export interface InlineExtensionToolResult {
-  mode: "transient" | "persisted";
-  id: string;
-  name: string;
-  description?: string;
-  content?: string;
-  path?: string;
-  updatedAt?: string;
-  context?: Record<string, unknown>;
-  initialHeight?: number;
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return !!value && typeof value === "object" && !Array.isArray(value);
-}
-
-function stringValue(value: unknown): string | undefined {
-  return typeof value === "string" && value.trim() ? value.trim() : undefined;
-}
-
-function recordValue(value: unknown): Record<string, unknown> | undefined {
-  return isRecord(value) ? value : undefined;
-}
-
-function initialHeightValue(value: unknown): number | undefined {
-  const height = Number(value);
-  if (!Number.isFinite(height) || height <= 0) return undefined;
-  return Math.min(Math.max(Math.round(height), 120), 1000);
-}
-
-function normalizeInlineExtension(
-  value: unknown,
-): InlineExtensionToolResult | null {
-  if (!isRecord(value)) return null;
-  const id = stringValue(value.id);
-  const name = stringValue(value.name);
-  if (!id || !name) return null;
-  const mode = value.mode === "transient" ? "transient" : "persisted";
-  const content = stringValue(value.content);
-  if (mode === "transient" && !content) return null;
-  return {
-    mode,
-    id,
-    name,
-    description: stringValue(value.description),
-    content,
-    path: stringValue(value.path),
-    updatedAt: stringValue(value.updatedAt),
-    context: recordValue(value.context),
-    initialHeight: initialHeightValue(value.initialHeight),
-  };
-}
-
-export function normalizeInlineExtensionToolResult(
-  context: ToolRendererContext,
-): InlineExtensionToolResult | null {
-  const result = context.resultJson;
-  if (!isRecord(result)) return null;
-
-  const inline = normalizeInlineExtension(result.inlineExtension);
-  if (inline) return inline;
-
-  if (isRecord(result.extension)) {
-    const id = stringValue(result.extension.id);
-    const name = stringValue(result.extension.name);
-    if (!id || !name) return null;
-    return {
-      mode: "persisted",
-      id,
-      name,
-      description: stringValue(result.extension.description),
-      path:
-        stringValue(result.extension.path) ??
-        stringValue(result.path) ??
-        extensionPath(id, name),
-      updatedAt: stringValue(result.extension.updatedAt),
-      context: recordValue(result.context),
-      initialHeight: initialHeightValue(result.initialHeight),
-    };
-  }
-
-  return null;
-}
+export {
+  normalizeInlineExtensionToolResult,
+  type InlineExtensionToolResult,
+} from "./inline-extension-result.js";
 
 export function InlineExtensionWidget({
   context,

package/corpus/core/src/client/chat/widgets/builtin-tool-renderers.tsx

@@ -1,3 +1,5 @@
+import { lazy, Suspense } from "react";
+
 import {
   ACTION_CHAT_UI_DATA_CHART_RENDERER,
   ACTION_CHAT_UI_DATA_INSIGHTS_RENDERER,
@@ -19,13 +21,28 @@ import {
   normalizeDataWidgetResult,
   type DataWidgetResult,
 } from "./data-widget-types.js";
-import { DataChartWidget } from "./DataChartWidget.js";
-import { DataInsightsWidget } from "./DataInsightsWidget.js";
-import { DataTableWidget } from "./DataTableWidget.js";
-import {
-  InlineExtensionWidget,
-  normalizeInlineExtensionToolResult,
-} from "./InlineExtensionWidget.js";
+import { normalizeInlineExtensionToolResult } from "./inline-extension-result.js";
+
+const LazyDataChartWidget = lazy(() =>
+  import("./DataChartWidget.js").then((module) => ({
+    default: module.DataChartWidget,
+  })),
+);
+const LazyDataInsightsWidget = lazy(() =>
+  import("./DataInsightsWidget.js").then((module) => ({
+    default: module.DataInsightsWidget,
+  })),
+);
+const LazyDataTableWidget = lazy(() =>
+  import("./DataTableWidget.js").then((module) => ({
+    default: module.DataTableWidget,
+  })),
+);
+const LazyInlineExtensionWidget = lazy(() =>
+  import("./InlineExtensionWidget.js").then((module) => ({
+    default: module.InlineExtensionWidget,
+  })),
+);
 
 function isRecord(value: unknown): value is Record<string, unknown> {
   return !!value && typeof value === "object" && !Array.isArray(value);
@@ -84,27 +101,48 @@ function renderDataWidget(context: ToolRendererContext) {
   const widget = normalizeDataWidgetKind(result.widget);
   if (widget === DATA_TABLE_WIDGET && result.table) {
     return (
-      <DataTableWidget
-        table={result.table}
-        action={result.display?.primaryAction}
-      />
+      <Suspense fallback={<BuiltinToolRendererSkeleton />}>
+        <LazyDataTableWidget
+          table={result.table}
+          action={result.display?.primaryAction}
+        />
+      </Suspense>
     );
   }
   if (widget === DATA_CHART_WIDGET && result.chartSeries) {
-    return <DataChartWidget chart={result.chartSeries} />;
+    return (
+      <Suspense fallback={<BuiltinToolRendererSkeleton />}>
+        <LazyDataChartWidget chart={result.chartSeries} />
+      </Suspense>
+    );
   }
   if (widget === DATA_INSIGHTS_WIDGET) {
-    return <DataInsightsWidget result={result} />;
+    return (
+      <Suspense fallback={<BuiltinToolRendererSkeleton />}>
+        <LazyDataInsightsWidget result={result} />
+      </Suspense>
+    );
   }
   return null;
 }
 
+function BuiltinToolRendererSkeleton() {
+  return (
+    <div
+      aria-label="Loading tool result"
+      className="my-1.5 h-24 animate-pulse rounded-lg border border-border bg-muted/30"
+    />
+  );
+}
+
 const BuiltinDataWidgetRenderer: ToolRendererComponent = ({ context }) =>
   renderDataWidget(context);
 
 const BuiltinInlineExtensionRenderer: ToolRendererComponent = ({ context }) =>
   normalizeInlineExtensionToolResult(context) ? (
-    <InlineExtensionWidget context={context} />
+    <Suspense fallback={<BuiltinToolRendererSkeleton />}>
+      <LazyInlineExtensionWidget context={context} />
+    </Suspense>
   ) : null;
 
 export function isBuiltinDataWidgetActionRenderer(