@agent-native/core 0.113.0 → 0.114.1

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

@@ -1002,6 +1002,19 @@ switch (command) {
     break;
   }
 
+  case "eject": {
+    import("./eject.js")
+      .then(async (m) => {
+        const code = await m.runEject(args);
+        process.exit(code);
+      })
+      .catch((err) => {
+        console.error(err?.message ?? err);
+        process.exit(1);
+      });
+    break;
+  }
+
   case "audit-agent-web": {
     import("./audit-agent-web.js")
       .then((m) => m.runAuditAgentWeb(args))
@@ -1135,6 +1148,9 @@ Usage:
                                 Manifest package lifecycle: inspect | add | eject.
                                 add/eject are dry-run unless --apply; --json emits
                                 a machine-readable compatibility/change report.
+  agent-native eject <unit>    Copy a supported feature into app-owned source.
+                                --list discovers units; inspect/diff are read-only;
+                                eject/restore are dry-run unless --apply.
   agent-native changelog <cmd>  Author the app's user-facing changelog.
                                 cmds: add "<summary>" [--type added|fixed|...] |
                                 release | list. Pending entries live in

package/corpus/core/src/client/build-compatibility.ts

@@ -0,0 +1,77 @@
+declare const __AGENT_NATIVE_BUILD_ID__: string | undefined;
+declare const __AGENT_NATIVE_CLIENT_COMPATIBILITY_VERSION__: string | undefined;
+
+const RELOAD_MARKER_KEY = "__agentNativeClientCompatibilityReload";
+export const BUILD_CACHE_BUSTER_PARAM = "__an_build";
+
+type CompatibilityWindow = Pick<Window, "location" | "history"> & {
+  sessionStorage?: Storage;
+  __agentNativeClientCompatibilityReload?: string;
+};
+
+export function clientBuildId(): string {
+  if (typeof __AGENT_NATIVE_BUILD_ID__ === "string") {
+    return __AGENT_NATIVE_BUILD_ID__;
+  }
+  return (
+    (globalThis as typeof globalThis & { __AGENT_NATIVE_BUILD_ID__?: string })
+      .__AGENT_NATIVE_BUILD_ID__ ?? ""
+  );
+}
+
+export function clientCompatibilityVersion(): string {
+  if (typeof __AGENT_NATIVE_CLIENT_COMPATIBILITY_VERSION__ === "string") {
+    return __AGENT_NATIVE_CLIENT_COMPATIBILITY_VERSION__;
+  }
+  return (
+    (
+      globalThis as typeof globalThis & {
+        __AGENT_NATIVE_CLIENT_COMPATIBILITY_VERSION__?: string;
+      }
+    ).__AGENT_NATIVE_CLIENT_COMPATIBILITY_VERSION__ ?? ""
+  );
+}
+
+function readReloadMarker(win: CompatibilityWindow): string {
+  try {
+    return win.sessionStorage?.getItem(RELOAD_MARKER_KEY) ?? "";
+  } catch {
+    return win.__agentNativeClientCompatibilityReload ?? "";
+  }
+}
+
+function writeReloadMarker(win: CompatibilityWindow, marker: string): void {
+  win.__agentNativeClientCompatibilityReload = marker;
+  try {
+    win.sessionStorage?.setItem(RELOAD_MARKER_KEY, marker);
+  } catch {}
+}
+
+export function reloadForClientCompatibilityMismatch(
+  serverBuildId: string,
+  requiredCompatibility: string,
+  win: CompatibilityWindow | undefined = typeof window === "undefined"
+    ? undefined
+    : window,
+): boolean {
+  if (!win?.location) return false;
+  const marker = `${requiredCompatibility}:${serverBuildId}`;
+  if (readReloadMarker(win) === marker) return false;
+  writeReloadMarker(win, marker);
+  const target = new URL(win.location.href);
+  target.searchParams.set(BUILD_CACHE_BUSTER_PARAM, serverBuildId || "latest");
+  win.location.replace(target.href);
+  return true;
+}
+
+export function stripBuildCompatibilityCacheBuster(
+  win: CompatibilityWindow | undefined = typeof window === "undefined"
+    ? undefined
+    : window,
+): void {
+  if (!win?.location || !win.history) return;
+  const target = new URL(win.location.href);
+  if (!target.searchParams.has(BUILD_CACHE_BUSTER_PARAM)) return;
+  target.searchParams.delete(BUILD_CACHE_BUSTER_PARAM);
+  win.history.replaceState(win.history.state, "", target.href);
+}

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

@@ -153,6 +153,9 @@ export {
   ResourcesPanel,
   ResourceTree,
   ResourceEditor,
+  DEFAULT_MCP_INTEGRATIONS,
+  getDefaultMcpIntegrations,
+  mergeDefaultMcpIntegrations,
   useResources,
   useResourceTree,
   useResource,
@@ -166,6 +169,7 @@ export {
   type ResourceScope,
   type ResourceTreeProps,
   type ResourceEditorProps,
+  type DefaultMcpIntegration,
 } from "./resources/index.js";
 export type { ResourcesPanelProps } from "./resources/ResourcesPanel.js";
 export {

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

@@ -26,10 +26,11 @@ import {
 
 export type McpConnectionSuggestionVariant = "composer" | "response";
 
-interface McpConnectionSuggestionProps {
+export interface McpConnectionSuggestionProps {
   text: string;
   contextText?: string;
   variant?: McpConnectionSuggestionVariant;
+  integrations?: DefaultMcpIntegration[];
 }
 
 function compareUrl(value: string): string {
@@ -79,6 +80,7 @@ export function McpConnectionSuggestion({
   text,
   contextText = "",
   variant = "composer",
+  integrations: integrationOptions,
 }: McpConnectionSuggestionProps) {
   const t = useT();
   const mcpServersQuery = useMcpServers();
@@ -87,7 +89,10 @@ export function McpConnectionSuggestion({
   const [dismissedId, setDismissedId] = useState<string | null>(null);
   const [connecting, setConnecting] = useState(false);
   const [error, setError] = useState<string | null>(null);
-  const integrations = useMemo(() => getDefaultMcpIntegrations(), []);
+  const integrations = useMemo(
+    () => integrationOptions ?? getDefaultMcpIntegrations(),
+    [integrationOptions],
+  );
   const textIntegration = useMemo(
     () => findMcpIntegrationForText(text, integrations),
     [integrations, text],
@@ -264,6 +269,7 @@ export function McpConnectionSuggestion({
         hasOrg={Boolean(mcpServersQuery.data?.orgId)}
         onCreateMcpServer={(args) => createMcpServer.mutateAsync(args)}
         onCreated={() => setDismissedId(integration.id)}
+        integrations={integrations}
       />
     </>
   );

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

@@ -45,7 +45,7 @@ import {
 
 type DialogMode = "catalog" | "form";
 
-interface McpIntegrationDialogProps {
+export interface McpIntegrationDialogProps {
   open: boolean;
   onOpenChange: (open: boolean) => void;
   initialIntegrationId?: string | null;
@@ -54,6 +54,7 @@ interface McpIntegrationDialogProps {
   hasOrg: boolean;
   onCreateMcpServer: (args: CreateMcpServerArgs) => Promise<unknown>;
   onCreated?: () => void;
+  integrations?: DefaultMcpIntegration[];
 }
 
 interface TestResult {
@@ -95,6 +96,7 @@ export function McpIntegrationDialog({
   hasOrg,
   onCreateMcpServer,
   onCreated,
+  integrations,
 }: McpIntegrationDialogProps) {
   const t = useT();
   const [mode, setMode] = useState<DialogMode>("catalog");
@@ -116,7 +118,10 @@ export function McpIntegrationDialog({
   const [testResult, setTestResult] = useState<TestResult | null>(null);
   const inputRef = useRef<HTMLInputElement>(null);
   const mcpServersQuery = useMcpServers();
-  const defaultIntegrations = useMemo(() => getDefaultMcpIntegrations(), []);
+  const defaultIntegrations = useMemo(
+    () => integrations ?? getDefaultMcpIntegrations(),
+    [integrations],
+  );
   const customIntegrationEnabled = useMemo(
     () => isCustomMcpIntegrationEnabled(),
     [],

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

@@ -46,7 +46,10 @@ import { useOrg } from "../org/hooks.js";
 import { useUploadResource } from "../uploads/use-upload-resource.js";
 import { cn } from "../utils.js";
 import { BuiltinCapabilityDetail } from "./BuiltinCapabilityDetail.js";
-import { isMcpIntegrationCatalogAvailable } from "./mcp-integration-catalog.js";
+import {
+  isMcpIntegrationCatalogAvailable,
+  type DefaultMcpIntegration,
+} from "./mcp-integration-catalog.js";
 import { McpIntegrationDialog } from "./McpIntegrationDialog.js";
 import { McpServerDetail } from "./McpServerDetail.js";
 import { ResourceEditor } from "./ResourceEditor.js";
@@ -224,6 +227,7 @@ function CreateMenu({
   hasOrg,
   onCreated,
   showToast,
+  mcpIntegrations,
 }: {
   scope: ResourceScope;
   resourceFilter?: ResourceView;
@@ -247,6 +251,7 @@ function CreateMenu({
   canCreateOrgMcp: boolean;
   hasOrg: boolean;
   onCreated?: () => void;
+  mcpIntegrations?: DefaultMcpIntegration[];
   showToast?: (
     kind: "ok" | "err",
     message: string,
@@ -258,8 +263,11 @@ function CreateMenu({
   const [mcpDialogOpen, setMcpDialogOpen] = useState(false);
   const [view, setView] = useState<CreateMenuView>("menu");
   const showMcpIntegrations = useMemo(
-    () => isMcpIntegrationCatalogAvailable(),
-    [],
+    () =>
+      mcpIntegrations
+        ? mcpIntegrations.length > 0
+        : isMcpIntegrationCatalogAvailable(),
+    [mcpIntegrations],
   );
   const [value, setValue] = useState("");
   const [agentName, setAgentName] = useState("");
@@ -1030,6 +1038,7 @@ The result should be a reusable agent profile, not a one-off task response.`,
         hasOrg={hasOrg}
         onCreateMcpServer={onCreateMcpServer}
         onCreated={onCreated}
+        integrations={mcpIntegrations}
       />
     </>
   );
@@ -1098,6 +1107,8 @@ export interface ResourcesPanelProps {
   resourceFilter?: ResourceView;
   /** Render special collections as cards instead of a nested file tree. */
   resourceTreeVariant?: ResourceTreeVariant;
+  /** Optional app-owned remote MCP catalog. */
+  mcpIntegrations?: DefaultMcpIntegration[];
 }
 
 export function resolveInitialResourceScope(
@@ -1115,6 +1126,7 @@ export function ResourcesPanel({
   showOnlyRequestedScope = false,
   resourceFilter,
   resourceTreeVariant = "tree",
+  mcpIntegrations,
 }: ResourcesPanelProps = {}) {
   const { data: org } = useOrg();
   // Non-admin org members get read-only access to organization resources.
@@ -1505,6 +1517,7 @@ export function ResourcesPanel({
         canCreateOrgMcp={canCreateOrgMcp}
         hasOrg={hasOrgForMcp}
         showToast={showToast}
+        mcpIntegrations={mcpIntegrations}
       />
     );
   };
@@ -1664,6 +1677,7 @@ export function ResourcesPanel({
               canCreateOrgMcp={canCreateOrgMcp}
               hasOrg={hasOrgForMcp}
               showToast={showToast}
+              mcpIntegrations={mcpIntegrations}
             />
           )}
           {(!resourceFilter || resourceFilter === "files") && (

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

@@ -4,3 +4,22 @@ export { ResourceEditor, type ResourceEditorProps } from "./ResourceEditor.js";
 export { useUploadResource } from "../uploads/use-upload-resource.js";
 export * from "./use-resources.js";
 export * from "./use-builtin-capabilities.js";
+export {
+  DEFAULT_MCP_INTEGRATIONS,
+  filterMcpIntegrations,
+  findMcpIntegrationForText,
+  getDefaultMcpIntegrations,
+  isCustomMcpIntegrationEnabled,
+  isMcpIntegrationCatalogAvailable,
+  mergeDefaultMcpIntegrations,
+  type DefaultMcpIntegration,
+} from "./mcp-integration-catalog.js";
+export {
+  McpIntegrationDialog,
+  type McpIntegrationDialogProps,
+} from "./McpIntegrationDialog.js";
+export {
+  McpConnectionSuggestion,
+  type McpConnectionSuggestionProps,
+  type McpConnectionSuggestionVariant,
+} from "./McpConnectionSuggestion.js";

package/corpus/core/src/client/resources/mcp-integration-catalog.ts

@@ -3,6 +3,7 @@ import {
   type McpIntegrationsConfigInput,
   type NormalizedMcpIntegrationsConfig,
 } from "../../shared/mcp-integration-config.js";
+import { mergeDefinitionsById } from "../../shared/merge-by-id.js";
 import { mcpIntegrationLogo } from "./mcp-integration-logos.js";
 
 export type McpIntegrationAuthMode = "none" | "headers" | "oauth";
@@ -586,6 +587,7 @@ function normalizePresetConfig(
 
 export function getDefaultMcpIntegrations(
   config?: McpIntegrationsConfigInput | NormalizedMcpIntegrationsConfig,
+  overrides: readonly DefaultMcpIntegration[] = [],
 ): DefaultMcpIntegration[] {
   const normalized = normalizePresetConfig(config);
   if (!normalized.enabled || !normalized.defaults.enabled) return [];
@@ -594,13 +596,19 @@ export function getDefaultMcpIntegrations(
     ? new Set(normalized.defaults.include)
     : null;
   const exclude = new Set(normalized.defaults.exclude);
-  return DEFAULT_MCP_INTEGRATIONS.filter((integration) => {
+  return mergeDefaultMcpIntegrations(overrides).filter((integration) => {
     const id = integration.id.toLowerCase();
     if (include && !include.has(id)) return false;
     return !exclude.has(id);
   });
 }
 
+export function mergeDefaultMcpIntegrations(
+  overrides: readonly DefaultMcpIntegration[] = [],
+): DefaultMcpIntegration[] {
+  return mergeDefinitionsById(DEFAULT_MCP_INTEGRATIONS, overrides);
+}
+
 export function isCustomMcpIntegrationEnabled(
   config?: McpIntegrationsConfigInput | NormalizedMcpIntegrationsConfig,
 ): boolean {

package/corpus/core/src/client/resources/runtime.ts

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

package/corpus/core/src/client/route-chunk-recovery/index.ts

@@ -1 +1,2 @@
 export * from "../route-chunk-recovery.js";
+export * from "../build-compatibility.js";

package/corpus/core/src/client/setup-connections/catalog.ts

@@ -0,0 +1,6 @@
+export const BUILT_IN_SETUP_READINESS_UI_IDS = Object.freeze([
+  "builder-connect-card",
+  "onboarding",
+  "provider-readiness-badge",
+  "setup-connections-page",
+] as const);

package/corpus/core/src/client/setup-connections/index.ts

@@ -2,6 +2,7 @@ export {
   BuilderConnectCard,
   type BuilderConnectCardProps,
 } from "./BuilderConnectCard.js";
+export { BUILT_IN_SETUP_READINESS_UI_IDS } from "./catalog.js";
 export {
   ProviderReadinessBadge,
   type ProviderReadinessBadgeProps,

package/corpus/core/src/client/setup-connections/runtime.ts

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

package/corpus/core/src/client/use-action.ts

@@ -30,6 +30,11 @@ import type {
 import { trackEvent } from "./analytics.js";
 import { agentNativePath } from "./api-path.js";
 import { getBrowserTabId } from "./browser-tab-id.js";
+import {
+  clientBuildId,
+  clientCompatibilityVersion,
+  reloadForClientCompatibilityMismatch,
+} from "./build-compatibility.js";
 import { ensureEmbedAuthFetchInterceptor } from "./embed-auth.js";
 
 const ACTION_PREFIX = agentNativePath("/_agent-native/actions");
@@ -281,6 +286,12 @@ async function performActionFetch<T>(
         }
       : {}),
   };
+  const compatibilityVersion = clientCompatibilityVersion();
+  if (compatibilityVersion) {
+    headers["X-Agent-Native-Client-Compatibility"] = compatibilityVersion;
+  }
+  const buildId = clientBuildId();
+  if (buildId) headers["X-Agent-Native-Build-Id"] = buildId;
   const tz = resolveUserTimezone();
   if (tz) headers["x-user-timezone"] = tz;
   const init: RequestInit = {
@@ -349,6 +360,26 @@ async function performActionFetch<T>(
       throw new Error(`Action ${name} failed: ${cause}`);
     }
 
+    if (
+      res.status === 409 &&
+      res.headers.get("X-Agent-Native-Client-Mismatch") === "1"
+    ) {
+      const serverBuildId =
+        res.headers.get("X-Agent-Native-Build-Id") ?? "latest";
+      const requiredCompatibility =
+        res.headers.get("X-Agent-Native-Client-Compatibility") ?? "unknown";
+      reloadForClientCompatibilityMismatch(
+        serverBuildId,
+        requiredCompatibility,
+      );
+      const error = new Error(
+        `Action ${name} requires a refreshed browser client`,
+      );
+      (error as any).status = 409;
+      (error as any).code = "client_build_mismatch";
+      throw error;
+    }
+
     // 204 No Content — nothing to parse.
     if (res.status === 204) return null as T;
 
@@ -760,7 +791,7 @@ export function useActionMutation<
       if (!skipActionQueryInvalidation) {
         queryClient.invalidateQueries({ queryKey: ["action"] });
       }
-      (onSuccess as Function)?.(...args);
+      return (onSuccess as Function)?.(...args);
     },
   });
 }

package/corpus/core/src/connections/catalog.ts

@@ -59,6 +59,7 @@ export interface WorkspaceConnectionProvider {
 export interface ListWorkspaceConnectionProvidersOptions {
   capability?: WorkspaceConnectionCapability;
   templateUse?: WorkspaceConnectionTemplateUse;
+  providerOverrides?: readonly WorkspaceConnectionProvider[];
 }
 
 export function defineWorkspaceConnectionProvider<
@@ -360,33 +361,46 @@ const PROVIDERS_BY_ID = new Map<
 export function listWorkspaceConnectionProviders(
   options: ListWorkspaceConnectionProvidersOptions = {},
 ): WorkspaceConnectionProvider[] {
-  return WORKSPACE_CONNECTION_PROVIDERS.filter((provider) => {
-    if (
-      options.capability &&
-      !includesWorkspaceConnectionCapability(
-        provider.capabilities,
-        options.capability,
-      )
-    ) {
-      return false;
-    }
-    if (
-      options.templateUse &&
-      !includesWorkspaceConnectionTemplateUse(
-        provider.recommendedTemplateUses,
-        options.templateUse,
-      )
-    ) {
-      return false;
-    }
-    return true;
-  }).map((provider) => ({ ...provider }));
+  return mergeWorkspaceConnectionProviders(options.providerOverrides)
+    .filter((provider) => {
+      if (
+        options.capability &&
+        !includesWorkspaceConnectionCapability(
+          provider.capabilities,
+          options.capability,
+        )
+      ) {
+        return false;
+      }
+      if (
+        options.templateUse &&
+        !includesWorkspaceConnectionTemplateUse(
+          provider.recommendedTemplateUses,
+          options.templateUse,
+        )
+      ) {
+        return false;
+      }
+      return true;
+    })
+    .map((provider) => ({ ...provider }));
+}
+
+export function mergeWorkspaceConnectionProviders(
+  overrides: readonly WorkspaceConnectionProvider[] = [],
+): WorkspaceConnectionProvider[] {
+  return mergeDefinitionsById(WORKSPACE_CONNECTION_PROVIDERS, overrides);
 }
 
 export function getWorkspaceConnectionProvider(
   id: string,
+  overrides: readonly WorkspaceConnectionProvider[] = [],
 ): WorkspaceConnectionProvider | undefined {
-  const provider = PROVIDERS_BY_ID.get(id as WorkspaceConnectionProviderId);
+  const provider = overrides.length
+    ? mergeWorkspaceConnectionProviders(overrides).find(
+        (candidate) => candidate.id === id,
+      )
+    : PROVIDERS_BY_ID.get(id as WorkspaceConnectionProviderId);
   return provider ? { ...provider } : undefined;
 }
 
@@ -398,14 +412,16 @@ export function isWorkspaceConnectionProviderId(
 
 export function listWorkspaceConnectionProvidersForTemplate(
   templateUse: WorkspaceConnectionTemplateUse,
+  providerOverrides: readonly WorkspaceConnectionProvider[] = [],
 ): WorkspaceConnectionProvider[] {
-  return listWorkspaceConnectionProviders({ templateUse });
+  return listWorkspaceConnectionProviders({ templateUse, providerOverrides });
 }
 
 export function listWorkspaceConnectionProvidersForCapability(
   capability: WorkspaceConnectionCapability,
+  providerOverrides: readonly WorkspaceConnectionProvider[] = [],
 ): WorkspaceConnectionProvider[] {
-  return listWorkspaceConnectionProviders({ capability });
+  return listWorkspaceConnectionProviders({ capability, providerOverrides });
 }
 
 export function workspaceConnectionProviderSupports(
@@ -432,3 +448,4 @@ function includesWorkspaceConnectionTemplateUse(
 ): boolean {
   return templateUses.includes(templateUse);
 }
+import { mergeDefinitionsById } from "../shared/merge-by-id.js";

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

@@ -6,6 +6,7 @@ export {
   listWorkspaceConnectionProviders,
   listWorkspaceConnectionProvidersForCapability,
   listWorkspaceConnectionProvidersForTemplate,
+  mergeWorkspaceConnectionProviders,
   workspaceConnectionProviderSupports,
   type ListWorkspaceConnectionProvidersOptions,
   type WorkspaceConnectionCapability,

package/corpus/core/src/connections/runtime.ts

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

package/corpus/core/src/deploy/build.ts

@@ -1240,7 +1240,7 @@ async function getHandler() {
         headers: {
           "Access-Control-Allow-Origin": "*",
           "Access-Control-Allow-Methods": "GET,HEAD,POST,PUT,PATCH,DELETE,OPTIONS",
-          "Access-Control-Allow-Headers": "Content-Type,Authorization,X-Requested-With,X-Request-Source,X-Agent-Native-CSRF,X-User-Timezone,X-Agent-Native-Tool-Bridge,X-Agent-Native-Tool-Id,X-Agent-Native-Frontend,X-Agent-Native-Embed-Target",
+          "Access-Control-Allow-Headers": "Content-Type,Authorization,X-Requested-With,X-Request-Source,X-Agent-Native-CSRF,X-User-Timezone,X-Agent-Native-Tool-Bridge,X-Agent-Native-Tool-Id,X-Agent-Native-Frontend,X-Agent-Native-Client-Compatibility,X-Agent-Native-Build-Id,X-Agent-Native-Embed-Target",
         },
       });
     }
@@ -3479,6 +3479,9 @@ export default bundle;
       "process.env.AGENT_NATIVE_BUILD_GA_MEASUREMENT_ID": JSON.stringify(
         process.env.GA_MEASUREMENT_ID?.trim() || "",
       ),
+      "process.env.AGENT_NATIVE_BUILD_DEPLOY_CONTEXT": JSON.stringify(
+        process.env.CONTEXT?.trim() || "",
+      ),
     },
     // Replace browser-only renderers (Excalidraw/Mermaid) with an inert proxy in
     // the server bundle. Without this, Nitro's Rolldown build pulls the real