@agent-native/core 0.109.4 → 0.110.1

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(

package/corpus/core/src/client/chat/widgets/inline-extension-result.ts

@@ -0,0 +1,86 @@
+import { extensionPath } from "../../../extensions/path.js";
+import type { ToolRendererContext } from "../tool-render-registry.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;
+}

package/corpus/core/src/client/client-bootstrap.ts

@@ -0,0 +1,7 @@
+import { ensureEmbedAuthFetchInterceptor } from "./embed-auth.js";
+import { installRouteChunkRecovery } from "./route-chunk-recovery.js";
+
+export function initializeAgentNativeClient(): void {
+  ensureEmbedAuthFetchInterceptor();
+  installRouteChunkRecovery();
+}

package/corpus/core/src/client/context-xray/ContextXRayPanel.tsx

@@ -37,7 +37,7 @@ export function ContextXRayPanel({
       onPin={onPin}
       onEvict={onEvict}
       onRestore={onRestore}
-      titleLabel={t("contextXray.pageTitle", {
+      titleLabel={t("contextXray.panelTitle", {
         defaultValue: "Context X-Ray",
       })}
       systemOrderedLabel={t("contextXray.systemOrdered", {