@agent-native/core 0.103.0 → 0.104.0

package/corpus/core/src/client/agent-page/types.ts

@@ -11,7 +11,7 @@ export type AgentPageScope = "user" | "org";
 
 /** Props every Agent page tab receives from the page shell. */
 export interface AgentPageTabProps {
-  /** Current scope selected by the page-level Personal/Organization toggle. */
+  /** Current scope selected by the Agent workspace Personal/Organization control. */
   scope: AgentPageScope;
   /** Whether the current user can administer org-scoped agent config. */
   canManageOrg?: boolean;

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

@@ -35,8 +35,14 @@ export type {
   SessionReplayNetworkOptions,
   SessionReplayOptions,
   SessionReplayStartResult,
+  SessionReplayContext,
+  SessionReplayLinkOptions,
   SessionReplayUrlMatcher,
 } from "./session-replay.js";
+export {
+  getSessionReplayContext,
+  getSessionReplayUrl,
+} from "./session-replay.js";
 
 declare global {
   interface Window {
@@ -101,6 +107,10 @@ export type ConfigureTrackingOptions = {
    * Disable this on anonymous/public routes to avoid an expected 401 request.
    */
   llmConnectionStatus?: boolean;
+  /** Disable framework auth refresh when the host owns identity/session state. */
+  authSessionRefresh?: boolean;
+  /** Disable automatic history/pageview events when the host emits its own. */
+  pageviewTracking?: boolean;
   sessionReplay?: boolean | SessionReplayOptions;
   /**
    * First-party, Sentry-style error capture. Auto-captures uncaught errors
@@ -110,7 +120,7 @@ export type ConfigureTrackingOptions = {
   errorCapture?: boolean | ErrorCaptureConfigOptions;
 };
 
-type SentryUser = {
+export type TrackingIdentityUser = {
   id?: string;
   email?: string;
   username?: string;
@@ -148,7 +158,7 @@ let _trackingContentCaptureEnabled = true;
 let _contentCaptureForPath: ((pathname: string) => boolean) | null = null;
 // Buffer for setSentryUser calls made before Sentry has initialized.
 // `undefined` means "no pending update"; `null` means "pending clear".
-let _pendingSentryUser: SentryUser | null | undefined = undefined;
+let _pendingSentryUser: TrackingIdentityUser | null | undefined = undefined;
 let _pendingSentryOrgId: string | null | undefined = undefined;
 
 const AGENT_NATIVE_ANALYTICS_DEFAULT_ENDPOINT =
@@ -905,7 +915,7 @@ function ensureSentry(): void {
  * for filtering Sentry by tenant.
  */
 export function setSentryUser(
-  user: SentryUser | null,
+  user: TrackingIdentityUser | null,
   orgId?: string | null,
 ): void {
   let shouldRetryReplay = false;
@@ -946,6 +956,14 @@ export function setSentryUser(
   }
 }
 
+/** Neutral alias for hosts that own identity outside Sentry. */
+export function setTrackingIdentity(
+  user: TrackingIdentityUser | null,
+  orgId?: string | null,
+): void {
+  setSentryUser(user, orgId);
+}
+
 export interface ClientCaptureContext {
   /** Searchable Sentry tags (low-cardinality strings only). */
   tags?: Record<string, string | undefined>;
@@ -1050,8 +1068,12 @@ export function configureTracking(options: ConfigureTrackingOptions): void {
     if (options.llmConnectionStatus !== false) {
       installLlmConnectionRefresh();
     }
-    installTrackingAuthSessionRefresh();
-    installPageviewTracking();
+    if (options.authSessionRefresh !== false) {
+      installTrackingAuthSessionRefresh();
+    }
+    if (options.pageviewTracking !== false) {
+      installPageviewTracking();
+    }
     maybeInstallSessionReplay(
       options.sessionReplay,
       {
@@ -1371,6 +1393,7 @@ async function startConfiguredSessionReplay(
       return { started: false, reason: "disabled" as const };
     }
     const mod = await import("./session-replay.js");
+    _sessionReplayModuleForCapture = mod;
     if (!_trackingContentCaptureEnabled) {
       return { started: false, reason: "disabled" as const };
     }
@@ -1398,6 +1421,7 @@ export async function startSessionReplay(
     return { started: false, reason: "missing-user-id" };
   }
   const mod = await import("./session-replay.js");
+  _sessionReplayModuleForCapture = mod;
   return mod.startSessionReplay({
     ...configured,
     shouldStart: () =>
@@ -1466,9 +1490,31 @@ function resolveProps(
   for (const [key, value] of Object.entries(llmProps)) {
     if (enriched[key] === undefined) enriched[key] = value;
   }
+  const replayProps = sessionReplayTrackingProperties();
+  for (const [key, value] of Object.entries(replayProps)) {
+    if (enriched[key] === undefined) enriched[key] = value;
+  }
   return applyTrackingIdentity(enriched);
 }
 
+function sessionReplayTrackingProperties(): Record<string, unknown> {
+  const module = _sessionReplayModuleForCapture;
+  if (!module) return {};
+  const context = module.getSessionReplayContext?.();
+  if (!context?.active) return {};
+  const occurredAt = new Date().toISOString();
+  return {
+    sessionReplayId: context.replayId,
+    sessionReplayStartedAt: context.startedAt,
+    sessionReplayAt: occurredAt,
+    ...(module.getSessionReplayUrl
+      ? {
+          sessionReplayUrl: module.getSessionReplayUrl({ at: occurredAt }),
+        }
+      : {}),
+  };
+}
+
 function pageviewKey(): string {
   return window.location.href;
 }

package/corpus/core/src/client/chat/run-recovery.tsx

@@ -28,6 +28,7 @@ import {
 } from "../agent-engine-key.js";
 import { agentNativePath } from "../api-path.js";
 import { writeClipboardText } from "../clipboard.js";
+import { useT } from "../i18n.js";
 import { useBuilderConnectFlow } from "../settings/useBuilderStatus.js";
 import { cn } from "../utils.js";
 
@@ -294,6 +295,7 @@ const API_KEY_PROVIDERS: Array<{
 ];
 
 export function ApiKeyConnect({ onConnected }: { onConnected?: () => void }) {
+  const t = useT();
   const [provider, setProvider] = useState<AgentEngineProvider>("anthropic");
   const [apiKey, setApiKey] = useState("");
   const [saving, setSaving] = useState(false);
@@ -318,7 +320,7 @@ export function ApiKeyConnect({ onConnected }: { onConnected?: () => void }) {
   return (
     <div className="rounded-md border border-border bg-background/60 p-3">
       <div className="mb-2 text-[11px] font-medium text-foreground">
-        Use your own API key
+        {t("agentPanel.addOwnKeys", { defaultValue: "Add your own keys" })}
       </div>
       <p className="mb-2.5 text-[11px] leading-relaxed text-muted-foreground">
         Stored securely for this app only.
@@ -405,6 +407,7 @@ export function BuilderSetupContent({
   onConnected?: () => void;
   layout?: BuilderSetupCardLayout;
 }) {
+  const t = useT();
   const [keyOpen, setKeyOpen] = useState(false);
   const sidebarLayout = layout === "sidebar";
 
@@ -423,10 +426,13 @@ export function BuilderSetupContent({
       >
         <div className="agent-builder-setup-card__copy min-w-0">
           <h3 className="text-[13px] font-medium text-foreground">
-            Connect AI
+            {t("agentPanel.connectAi", { defaultValue: "Connect AI" })}
           </h3>
           <p className="mt-0.5 text-[11px] leading-relaxed text-muted-foreground">
-            Use Builder.io (free credits), or add an Anthropic/OpenAI key.
+            {t("agentPanel.builderOrOwnKeys", {
+              defaultValue:
+                "Use Builder.io (free credits), or add your own provider keys.",
+            })}
           </p>
         </div>
         <div
@@ -449,7 +455,9 @@ export function BuilderSetupContent({
             )}
             aria-expanded={keyOpen}
           >
-            Use API key
+            {t("agentPanel.addOwnKeys", {
+              defaultValue: "Add your own keys",
+            })}
           </button>
         </div>
       </div>

package/corpus/core/src/client/composer/PromptComposer.tsx

@@ -30,7 +30,7 @@ import {
 
 import type { ReasoningEffort } from "../../shared/reasoning-effort.js";
 import { AssistantUiStaleIndexErrorBoundary } from "../assistant-ui-recovery.js";
-import { BuilderConnectCta, BuilderSetupCard } from "../chat/run-recovery.js";
+import { BuilderSetupCard, BuilderSetupContent } from "../chat/run-recovery.js";
 import { TooltipProvider } from "../components/ui/tooltip.js";
 import {
   fetchAgentEngineConfiguredState,
@@ -595,20 +595,10 @@ function PromptComposerInner({
       ) : null}
       {missingApiKey && useInlineMissingKeySetup ? (
         <div className="mb-2 rounded-md border border-border/80 bg-background/80 p-2.5 text-start shadow-sm">
-          <div className="flex flex-col gap-2">
-            <div className="min-w-0">
-              <p className="text-[12px] font-medium text-foreground">
-                Connect AI
-              </p>
-              <p className="mt-0.5 text-[11px] leading-4 text-muted-foreground">
-                Connect Builder.io before sending.
-              </p>
-            </div>
-            <BuilderConnectCta
-              variant="compact"
-              onConnected={handleBuilderConnected}
-            />
-          </div>
+          <BuilderSetupContent
+            onConnected={handleBuilderConnected}
+            layout="sidebar"
+          />
         </div>
       ) : null}
       <AgentComposerFrame

package/corpus/core/src/client/composer/TiptapComposer.tsx

@@ -10,6 +10,7 @@ import {
   IconTool,
   IconX,
   IconClipboardList,
+  IconKey,
   IconPencil,
   IconPlugConnected,
 } from "@tabler/icons-react";
@@ -57,6 +58,7 @@ import {
   TooltipTrigger,
 } from "../components/ui/tooltip.js";
 import { isTrustedFrameMessage } from "../frame.js";
+import { useT } from "../i18n.js";
 import { useBuilderConnectFlow } from "../settings/useBuilderStatus.js";
 import { ComposerPlusMenu } from "./ComposerPlusMenu.js";
 import { getComposerDraftKey } from "./draft-key.js";
@@ -970,6 +972,7 @@ function ModelSelector({
   onConnectLocalRuntime?: (engine: string) => void;
   imageModel?: ComposerImageModelMenu;
 }) {
+  const t = useT();
   const [open, setOpen] = useState(false);
   const autoModelGroup = engines.find((group) => group.models.includes("auto"));
   const providerGroups = useMemo(
@@ -1114,11 +1117,37 @@ function ModelSelector({
               <span className="flex-1 min-w-0">
                 <span className="block text-[12px] font-medium text-foreground">
                   {!onConnectProvider && builderFlow.connecting
-                    ? "Connecting Builder.io…"
-                    : "Connect Builder.io"}
+                    ? t("agentPanel.connectingBuilder", {
+                        defaultValue: "Connecting Builder.io…",
+                      })
+                    : t("agentPanel.connectBuilderIo", {
+                        defaultValue: "Connect Builder.io",
+                      })}
                 </span>
                 <span className="block text-[11px] text-muted-foreground">
-                  Free credits for Claude, OpenAI &amp; Gemini
+                  {t("agentPanel.builderModelCredits", {
+                    defaultValue: "Free credits for Claude, OpenAI & Gemini",
+                  })}
+                </span>
+              </span>
+            </button>
+            <button
+              type="button"
+              onClick={openLlmSettings}
+              className="flex w-full items-start gap-2 px-3 py-2 text-start hover:bg-accent/50"
+            >
+              <IconKey className="mt-0.5 h-4 w-4 shrink-0 text-muted-foreground" />
+              <span className="min-w-0 flex-1">
+                <span className="block text-[12px] font-medium text-foreground">
+                  {t("agentPanel.addOwnKeys", {
+                    defaultValue: "Add your own keys",
+                  })}
+                </span>
+                <span className="block text-[11px] text-muted-foreground">
+                  {t("agentPanel.configureProviderKeys", {
+                    defaultValue:
+                      "Configure Anthropic, OpenAI, or another provider",
+                  })}
                 </span>
               </span>
             </button>

package/corpus/core/src/client/dynamic-suggestions.ts

@@ -5,7 +5,7 @@ import { useChangeVersions } from "./use-change-version.js";
 import type { ChatThreadScope } from "./use-chat-threads.js";
 
 const SAFE_BROWSER_TAB_ID_RE = /^[A-Za-z0-9_-]{1,96}$/;
-const DEFAULT_MAX_SUGGESTIONS = 4;
+const DEFAULT_MAX_SUGGESTIONS = 3;
 
 export interface AgentDynamicSuggestionContext {
   navigation: unknown;
@@ -322,7 +322,7 @@ export function mergeAgentSuggestions(options: {
 }): string[] {
   if (options.dynamicSuggestions.length === 0) {
     return options.includeStatic
-      ? dedupeSuggestions(options.staticSuggestions ?? [])
+      ? dedupeSuggestions(options.staticSuggestions ?? []).slice(0, options.max)
       : [];
   }
 
@@ -424,7 +424,7 @@ export function useAgentDynamicSuggestionsResult(
   const suggestions = useMemo(() => {
     if (!enabled) {
       return options.staticSuggestions
-        ? dedupeSuggestions(options.staticSuggestions)
+        ? dedupeSuggestions(options.staticSuggestions).slice(0, config.max)
         : undefined;
     }
     if (context === null) return undefined;

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

@@ -3,6 +3,10 @@ import { installRouteChunkRecovery } from "./route-chunk-recovery.js";
 installRouteChunkRecovery();
 
 export { getBrowserTabId } from "./browser-tab-id.js";
+export {
+  AgentAskPopover,
+  type AgentAskPopoverProps,
+} from "./AgentAskPopover.js";
 
 export {
   addContextToAgentChat,
@@ -388,7 +392,10 @@ export {
   type BuildAgentNativeExtensionHtmlOptions,
   type CreateHttpAgentNativeExtensionStorageOptions,
 } from "./extensions/portable-extension.js";
-export { injectSessionReplayIframeBootstrap } from "../extensions/session-replay-iframe.js";
+export {
+  buildSessionReplayIframeBootstrap,
+  injectSessionReplayIframeBootstrap,
+} from "../extensions/session-replay-iframe.js";
 export {
   SESSION_REPLAY_IFRAME_ATTRIBUTE,
   SESSION_REPLAY_IFRAME_PROBE,
@@ -596,6 +603,8 @@ export {
 } 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";
@@ -777,6 +786,9 @@ export {
   getAnalyticsSessionId,
   getFirstTouchAttribution,
   setSentryUser,
+  setTrackingIdentity,
+  getSessionReplayContext,
+  getSessionReplayUrl,
   captureError,
   captureClientException,
   // First-party, Sentry-style error capture (auto + manual API).
@@ -794,8 +806,11 @@ export {
   type ExceptionLevel,
   type FirstTouchAttribution,
   type SessionReplayOptions,
+  type SessionReplayContext,
+  type SessionReplayLinkOptions,
   type SessionReplayStartResult,
   type SessionReplayUrlMatcher,
+  type TrackingIdentityUser,
 } from "./analytics.js";
 export { track } from "./track.js";
 export {