@agent-native/core 0.168.0 → 0.168.2

package/dist/client/resources/McpIntegrationDialog.js

@@ -8,9 +8,9 @@ import { useT } from "../i18n.js";
 import { IntegrationConnectionChoice } from "../integrations/IntegrationConnectionChoice.js";
 import { IntegrationGrid } from "../integrations/IntegrationGrid.js";
 import { cn } from "../utils.js";
-import { buildMcpOAuthStartUrl, createMcpIntegrationFormDefaults, filterMcpIntegrations, getMcpIntegrationApiFallback, getDefaultMcpIntegrations, isCustomMcpIntegrationEnabled, navigateToMcpOAuthStart, resolveMcpIntegrationScope, shouldOfferMcpIntegrationOrganizationScope, shouldOfferMcpOrganizationScope, } from "./mcp-integration-catalog.js";
+import { buildMcpOAuthStartUrl, createMcpIntegrationFormDefaults, filterMcpIntegrations, getMcpIntegrationApiFallback, getDefaultMcpIntegrations, isCustomMcpIntegrationEnabled, navigateToMcpOAuthStart, resolveMcpIntegrationScope, shouldOfferMcpIntegrationOrganizationScope, shouldOfferMcpOrganizationScope, supportsMcpIntegrationOrganizationScope, } from "./mcp-integration-catalog.js";
 import { McpIntegrationLogo } from "./McpIntegrationLogo.js";
-import { formatMcpServerError, getMcpUrlValidationError, useMcpServersApi, useMcpServers, } from "./use-mcp-servers.js";
+import { formatMcpServerError, formatMcpServersLoadError, getMcpUrlValidationError, useMcpServersApi, useMcpServers, } from "./use-mcp-servers.js";
 function parseHeaderLines(text) {
     const out = {};
     for (const line of text.split(/\r?\n/)) {
@@ -49,7 +49,7 @@ function resolveIntegrationScope(integration, defaultScope, hasOrg, canCreateOrg
         (integration.supportsOrganizationScope === true &&
             integration.managedOAuth !== true));
 }
-export function McpIntegrationDialog({ open, onOpenChange, initialIntegrationId = null, connectIntegrationId = null, quickConnectIntegrationId = null, defaultScope, canCreateOrgMcp, hasOrg, onCreateMcpServer, onCreated, integrations, }) {
+export function McpIntegrationDialog({ open, onOpenChange, initialIntegrationId = null, connectIntegrationId = null, quickConnectIntegrationId = null, defaultScope, canCreateOrgMcp, hasOrg, onCreateMcpServer, onOAuthStart, oauthReturnPath, onCreated, integrations, }) {
     const t = useT();
     const [mode, setMode] = useState("catalog");
     const [query, setQuery] = useState("");
@@ -89,11 +89,21 @@ export function McpIntegrationDialog({ open, onOpenChange, initialIntegrationId
     useEffect(() => {
         if (!open)
             return;
+        if (initialIntegrationId && !mcpServersQuery.isSuccess)
+            return;
         const initialIntegration = initialIntegrationId
             ? defaultIntegrations.find((integration) => integration.id === initialIntegrationId)
             : null;
         const initialDefaults = createMcpIntegrationFormDefaults(initialIntegration);
-        setMode(initialIntegration || !showCatalog ? "form" : "catalog");
+        const initialNeedsScopeChoice = Boolean(initialIntegration &&
+            hasOrg &&
+            requiresMcpIntegrationSetup(initialIntegration) &&
+            supportsMcpIntegrationOrganizationScope(initialIntegration));
+        setMode(initialNeedsScopeChoice
+            ? "choice"
+            : initialIntegration || !showCatalog
+                ? "form"
+                : "catalog");
         setQuery("");
         setSelected(initialIntegration ?? null);
         setScope(resolveIntegrationScope(initialIntegration, defaultScope, hasOrg, canCreateOrgMcp));
@@ -114,6 +124,7 @@ export function McpIntegrationDialog({ open, onOpenChange, initialIntegrationId
         open,
         safeDefaultScope,
         showCatalog,
+        mcpServersQuery.isSuccess,
     ]);
     useEffect(() => {
         if (open && mode === "form") {
@@ -147,18 +158,31 @@ export function McpIntegrationDialog({ open, onOpenChange, initialIntegrationId
             return;
         }
         setBusy(true);
-        const returnUrl = typeof window === "undefined"
-            ? "/"
-            : window.location.pathname +
-                window.location.search +
-                window.location.hash;
-        navigateToMcpOAuthStart(agentNativePath(buildMcpOAuthStartUrl({
+        const returnUrl = oauthReturnPath?.startsWith("/")
+            ? oauthReturnPath
+            : typeof window === "undefined"
+                ? "/"
+                : window.location.pathname +
+                    window.location.search +
+                    window.location.hash;
+        const oauthUrl = agentNativePath(buildMcpOAuthStartUrl({
             name: args.name,
             url: args.url,
             description: args.description,
             scope: options?.scope ?? scope,
             returnUrl,
-        })));
+        }));
+        if (!onOAuthStart) {
+            navigateToMcpOAuthStart(oauthUrl);
+            return;
+        }
+        void Promise.resolve()
+            .then(() => onOAuthStart(oauthUrl))
+            .then(() => onOpenChange(false))
+            .catch((cause) => {
+            setBusy(false);
+            setError(formatMcpServerError(cause));
+        });
     };
     const connectWithOAuth = (integration, options) => beginOAuth({
         name: integration.name,
@@ -218,6 +242,11 @@ export function McpIntegrationDialog({ open, onOpenChange, initialIntegrationId
         });
     };
     const quickConnect = (integration) => {
+        if (hasOrg) {
+            setSelected(integration);
+            setMode("choice");
+            return;
+        }
         if (requiresMcpIntegrationSetup(integration)) {
             openForm(integration);
             return;
@@ -240,6 +269,13 @@ export function McpIntegrationDialog({ open, onOpenChange, initialIntegrationId
         });
     };
     const selectCatalogConnection = (integration) => {
+        if (!mcpServersQuery.isSuccess)
+            return;
+        if (hasOrg) {
+            setSelected(integration);
+            setMode("choice");
+            return;
+        }
         if (requiresMcpIntegrationSetup(integration)) {
             const apiFallback = getMcpIntegrationApiFallback(integration);
             if (apiFallback) {
@@ -250,11 +286,6 @@ export function McpIntegrationDialog({ open, onOpenChange, initialIntegrationId
             }
             return;
         }
-        if (shouldOfferMcpIntegrationOrganizationScope(integration, hasOrg, canCreateOrgMcp)) {
-            setSelected(integration);
-            setMode("choice");
-            return;
-        }
         quickConnect(integration);
     };
     quickConnectRef.current = quickConnect;
@@ -267,15 +298,30 @@ export function McpIntegrationDialog({ open, onOpenChange, initialIntegrationId
             quickConnectAttemptedRef.current === quickConnectIntegrationId) {
             return;
         }
+        if (mcpServersQuery.isError)
+            return;
+        if (!mcpServersQuery.isSuccess)
+            return;
         const integration = defaultIntegrations.find((candidate) => candidate.id === quickConnectIntegrationId);
         if (!integration)
             return;
         quickConnectAttemptedRef.current = quickConnectIntegrationId;
         quickConnectRef.current?.(integration);
-    }, [defaultIntegrations, open, quickConnectIntegrationId]);
+    }, [
+        defaultIntegrations,
+        hasOrg,
+        mcpServersQuery.isError,
+        mcpServersQuery.isSuccess,
+        open,
+        quickConnectIntegrationId,
+    ]);
     useEffect(() => {
         if (!open || !connectIntegrationId)
             return;
+        if (mcpServersQuery.isError)
+            return;
+        if (!mcpServersQuery.isSuccess)
+            return;
         const integration = defaultIntegrations.find((candidate) => candidate.id === connectIntegrationId);
         if (!integration)
             return;
@@ -283,25 +329,36 @@ export function McpIntegrationDialog({ open, onOpenChange, initialIntegrationId
         if (quickConnectAttemptedRef.current === attemptKey)
             return;
         quickConnectAttemptedRef.current = attemptKey;
+        if (hasOrg) {
+            setSelected(integration);
+            setMode("choice");
+            return;
+        }
         if (requiresMcpIntegrationSetup(integration)) {
             openForm(integration);
             return;
         }
-        const showWorkspaceChoice = shouldOfferMcpIntegrationOrganizationScope(integration, hasOrg, canCreateOrgMcp);
-        if (!showWorkspaceChoice) {
-            quickConnectRef.current?.(integration);
-        }
-        else {
-            setMode("choice");
-        }
+        quickConnectRef.current?.(integration);
     }, [
         canCreateOrgMcp,
         connectIntegrationId,
         defaultIntegrations,
         hasOrg,
+        mcpServersQuery.isError,
+        mcpServersQuery.isSuccess,
         open,
     ]);
     const connectPersonal = (integration) => {
+        if (requiresMcpIntegrationSetup(integration)) {
+            const apiFallback = getMcpIntegrationApiFallback(integration);
+            if (apiFallback) {
+                openAgentSettings(`secrets:${apiFallback.secretKey}`);
+            }
+            else {
+                openForm(integration, { scope: "user" });
+            }
+            return;
+        }
         if (integration.authMode === "oauth") {
             connectWithOAuth(integration, { scope: "user" });
             return;
@@ -319,6 +376,12 @@ export function McpIntegrationDialog({ open, onOpenChange, initialIntegrationId
         openForm(integration, { scope: "user" });
     };
     const connectWorkspace = (integration) => {
+        if (!canCreateOrgMcp)
+            return;
+        if (requiresMcpIntegrationSetup(integration)) {
+            openForm(integration, { scope: "org" });
+            return;
+        }
         if (integration.authMode === "oauth") {
             connectWithOAuth(integration, { scope: "org" });
             return;
@@ -384,93 +447,99 @@ export function McpIntegrationDialog({ open, onOpenChange, initialIntegrationId
     };
     if (!showCatalog && !customIntegrationEnabled)
         return null;
-    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsx(DialogContent, { "aria-describedby": undefined, className: "inset-0 flex h-[100dvh] max-h-none w-full max-w-none translate-x-0 translate-y-0 flex-col gap-0 overflow-hidden rounded-none p-0", children: mode === "choice" && selected ? (_jsxs(_Fragment, { children: [_jsx(DialogHeader, { className: "sr-only", children: _jsxs(DialogTitle, { children: ["Connect ", selected.name] }) }), _jsx(IntegrationConnectionChoice, { name: selected.name, logo: _jsx(McpIntegrationLogo, { name: selected.name, logoUrl: selected.logoUrl, integrationId: selected.id, className: "size-7 rounded-md", imageClassName: "size-full p-1" }), showWorkspaceOption: shouldOfferMcpIntegrationOrganizationScope(selected, hasOrg, canCreateOrgMcp), busy: busy, onPersonal: () => connectPersonal(selected), onWorkspace: () => connectWorkspace(selected) })] })) : mode === "catalog" ? (_jsxs(_Fragment, { children: [_jsxs(DialogHeader, { className: "shrink-0 border-b border-border px-7 pb-5 pe-14 pt-7 sm:px-10", children: [_jsx(DialogTitle, { children: t("mcpIntegrations.title") }), _jsx(DialogDescription, { children: t("mcpIntegrations.description", {
-                                    count: defaultIntegrations.length,
-                                }) })] }), _jsx("div", { className: "shrink-0 px-7 pb-5 sm:px-10", children: _jsxs("div", { className: "mx-auto flex w-full max-w-5xl flex-col gap-3 sm:flex-row", children: [_jsxs("label", { className: "relative min-w-0 flex-1", children: [_jsx(IconSearch, { className: "pointer-events-none absolute start-3 top-1/2 h-3.5 w-3.5 -translate-y-1/2 text-muted-foreground" }), _jsx("input", { value: query, onChange: (event) => setQuery(event.target.value), className: "h-9 w-full rounded-md border border-border bg-background pe-3 ps-8 text-[13px] text-foreground outline-none placeholder:text-muted-foreground/50 focus:ring-1 focus:ring-ring", placeholder: t("mcpIntegrations.searchPlaceholder") })] }), _jsx("button", { type: "button", onClick: () => openForm(null), className: cn("inline-flex h-9 items-center justify-center gap-1.5 rounded-md border border-border bg-background px-3 text-[12px] font-medium text-foreground hover:bg-accent", !customIntegrationEnabled && "hidden"), children: t("mcpIntegrations.addYourOwn") })] }) }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto px-7 pb-10 pt-7 sm:px-10", children: _jsxs("div", { className: "mx-auto w-full max-w-5xl", children: [error && (_jsx("div", { className: "mb-3 rounded-md border border-destructive/20 bg-destructive/5 px-3 py-2 text-[12px] leading-relaxed text-destructive", children: error })), _jsx(IntegrationGrid, { items: filteredIntegrations.map((integration) => {
-                                        const connected = connectedUrls.has(compareUrl(integration.url));
-                                        const setupOnly = requiresMcpIntegrationSetup(integration);
-                                        const apiFallback = getMcpIntegrationApiFallback(integration);
-                                        return {
-                                            id: integration.id,
-                                            name: integration.name,
-                                            description: t(integration.descriptionKey),
-                                            logo: (_jsx(McpIntegrationLogo, { name: integration.name, logoUrl: integration.logoUrl, integrationId: integration.id, className: "size-7 rounded-md", imageClassName: "size-full p-1" })),
-                                            status: connected
-                                                ? t("mcpIntegrations.connected")
-                                                : setupOnly
-                                                    ? t("mcpIntegrations.status.setupRequired")
-                                                    : undefined,
-                                            statusClassName: connected
-                                                ? "text-emerald-600 dark:text-emerald-400"
-                                                : "text-muted-foreground",
-                                            actionLabel: connected
-                                                ? "Manage"
-                                                : setupOnly && apiFallback
-                                                    ? t("mcpIntegrations.useApiToken")
+    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogContent, { "aria-describedby": undefined, className: "inset-0 flex h-[100dvh] max-h-none w-full max-w-none translate-x-0 translate-y-0 flex-col gap-0 overflow-hidden rounded-none p-0", children: [mcpServersQuery.isError ? (_jsxs("div", { role: "alert", className: "mx-7 mt-4 shrink-0 rounded-md border border-destructive/20 bg-destructive/5 px-3 py-2 text-xs text-destructive sm:mx-10", children: [_jsx("p", { children: formatMcpServersLoadError(mcpServersQuery.error) }), _jsx("button", { type: "button", onClick: () => void mcpServersQuery.refetch(), disabled: mcpServersQuery.isFetching, className: "mt-2 font-medium underline underline-offset-2 hover:text-foreground disabled:cursor-wait disabled:opacity-60", children: mcpServersQuery.isFetching
+                                ? t("mcpIntegrations.retrying")
+                                : t("mcpIntegrations.retry") })] })) : null, mode === "choice" && selected ? (_jsxs(_Fragment, { children: [_jsx(DialogHeader, { className: "sr-only", children: _jsxs(DialogTitle, { children: [t("mcpIntegrations.connect"), " ", selected.name] }) }), _jsx(IntegrationConnectionChoice, { name: selected.name, logo: _jsx(McpIntegrationLogo, { name: selected.name, logoUrl: selected.logoUrl, integrationId: selected.id, className: "size-7 rounded-md", imageClassName: "size-full p-1" }), showWorkspaceOption: supportsMcpIntegrationOrganizationScope(selected), workspaceOptionDisabled: !canCreateOrgMcp, workspaceOptionDisabledReason: !canCreateOrgMcp
+                                ? t("mcpIntegrations.workspaceAdminRequired")
+                                : undefined, personalOnlyReason: !supportsMcpIntegrationOrganizationScope(selected)
+                                ? t("mcpIntegrations.personalOnlyDescription")
+                                : undefined, busy: busy, onPersonal: () => connectPersonal(selected), onWorkspace: () => connectWorkspace(selected) })] })) : mode === "catalog" ? (_jsxs(_Fragment, { children: [_jsxs(DialogHeader, { className: "shrink-0 border-b border-border px-7 pb-5 pe-14 pt-7 sm:px-10", children: [_jsx(DialogTitle, { children: t("mcpIntegrations.title") }), _jsx(DialogDescription, { children: t("mcpIntegrations.description", {
+                                        count: defaultIntegrations.length,
+                                    }) })] }), _jsx("div", { className: "shrink-0 px-7 pb-5 sm:px-10", children: _jsxs("div", { className: "mx-auto flex w-full max-w-5xl flex-col gap-3 sm:flex-row", children: [_jsxs("label", { className: "relative min-w-0 flex-1", children: [_jsx(IconSearch, { className: "pointer-events-none absolute start-3 top-1/2 h-3.5 w-3.5 -translate-y-1/2 text-muted-foreground" }), _jsx("input", { value: query, onChange: (event) => setQuery(event.target.value), className: "h-9 w-full rounded-md border border-border bg-background pe-3 ps-8 text-[13px] text-foreground outline-none placeholder:text-muted-foreground/50 focus:ring-1 focus:ring-ring", placeholder: t("mcpIntegrations.searchPlaceholder") })] }), _jsx("button", { type: "button", onClick: () => openForm(null), className: cn("inline-flex h-9 items-center justify-center gap-1.5 rounded-md border border-border bg-background px-3 text-[12px] font-medium text-foreground hover:bg-accent", !customIntegrationEnabled && "hidden"), children: t("mcpIntegrations.addYourOwn") })] }) }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto px-7 pb-10 pt-7 sm:px-10", children: _jsxs("div", { className: "mx-auto w-full max-w-5xl", children: [error && (_jsx("div", { className: "mb-3 rounded-md border border-destructive/20 bg-destructive/5 px-3 py-2 text-[12px] leading-relaxed text-destructive", children: error })), !mcpServersQuery.isSuccess && !mcpServersQuery.isError ? (_jsx("div", { role: "status", className: "mb-3 rounded-md border border-border bg-muted/30 px-3 py-2 text-[12px] leading-relaxed text-muted-foreground", children: t("mcpIntegrations.loadingScopeMetadata") })) : null, _jsx(IntegrationGrid, { items: filteredIntegrations.map((integration) => {
+                                            const connected = connectedUrls.has(compareUrl(integration.url));
+                                            const setupOnly = requiresMcpIntegrationSetup(integration);
+                                            const apiFallback = getMcpIntegrationApiFallback(integration);
+                                            return {
+                                                id: integration.id,
+                                                name: integration.name,
+                                                description: t(integration.descriptionKey),
+                                                logo: (_jsx(McpIntegrationLogo, { name: integration.name, logoUrl: integration.logoUrl, integrationId: integration.id, className: "size-7 rounded-md", imageClassName: "size-full p-1" })),
+                                                status: connected
+                                                    ? t("mcpIntegrations.connected")
                                                     : setupOnly
-                                                        ? t("mcpIntegrations.viewSetup")
-                                                        : t("mcpIntegrations.connect"),
-                                            disabled: connected || busy,
-                                            onAction: () => {
-                                                if (connected) {
-                                                    openForm(integration);
-                                                    return;
-                                                }
-                                                selectCatalogConnection(integration);
-                                            },
-                                        };
-                                    }), emptyLabel: t("mcpIntegrations.noMatches") })] }) })] })) : (_jsxs(_Fragment, { children: [_jsxs(DialogHeader, { className: "shrink-0 border-b border-border px-7 pb-5 pe-14 pt-7 sm:px-10", children: [_jsxs("button", { type: "button", onClick: () => {
-                                    clearFeedback();
-                                    setMode("catalog");
-                                }, className: cn("mb-1 inline-flex w-fit items-center gap-1 text-[11px] text-muted-foreground hover:text-foreground", !showCatalog && "hidden"), children: [_jsx(IconArrowLeft, { className: "h-3 w-3 rtl:-scale-x-100" }), t("mcpIntegrations.backToIntegrations")] }), _jsx(DialogTitle, { children: selected
-                                    ? selectedRequiresSetup
-                                        ? t("mcpIntegrations.setupTitle", {
-                                            name: selected.name,
-                                        })
-                                        : t("mcpIntegrations.configureTitle", {
-                                            name: selected.name,
-                                        })
-                                    : t("mcpIntegrations.customTitle") }), _jsx(DialogDescription, { children: selected
-                                    ? selectedRequiresSetup
-                                        ? t("mcpIntegrations.providerSetupFormDescription")
-                                        : selected.authMode === "none"
-                                            ? t("mcpIntegrations.presetNoAuthDescription")
-                                            : t("mcpIntegrations.presetAuthDescription")
-                                    : t("mcpIntegrations.customDescription") })] }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto px-7 py-7 sm:px-10", children: _jsxs("div", { className: "mx-auto max-w-2xl space-y-3", children: [renderScopeSelector(), selected?.setupNoteKey && !selectedRequiresSetup ? (_jsx("div", { className: "rounded-md bg-muted/40 px-3 py-2 text-[11px] leading-relaxed text-muted-foreground", children: t(selected.setupNoteKey) })) : null, selectedRequiresSetup && selected && (_jsxs("div", { className: "mx-auto grid w-full max-w-xl gap-4 py-8", children: [_jsxs("div", { children: [_jsx("p", { className: "text-base font-semibold tracking-[-0.02em] text-foreground", children: t("mcpIntegrations.providerSetupRequired") }), _jsx("p", { className: "mt-1 text-sm leading-6 text-muted-foreground", children: t("mcpIntegrations.providerSetupDescription", {
-                                                        name: selected.name,
-                                                    }) })] }), selected.setupNoteKey ? (_jsx("p", { className: "text-sm leading-6 text-muted-foreground", children: t(selected.setupNoteKey) })) : null, selected.docsUrl ? (_jsxs("a", { href: selected.docsUrl, target: "_blank", rel: "noopener noreferrer", className: "inline-flex w-fit items-center gap-1 text-sm font-medium text-foreground underline underline-offset-4 hover:text-muted-foreground", children: [t("mcpIntegrations.viewSetup"), _jsx(IconExternalLink, { className: "size-3.5" })] })) : null] })), !selected && (_jsxs("div", { className: "flex items-center justify-between gap-3 rounded-md bg-muted/30 px-3 py-2 text-[11px]", children: [_jsx("span", { className: "text-muted-foreground", children: customAuthMode === "oauth"
-                                                ? t(
-                                                /* i18n-key-ignore */
-                                                "mcpIntegrations.customOAuthDefault", { defaultValue: "Sign in with OAuth" })
-                                                : t(
-                                                /* i18n-key-ignore */
-                                                "mcpIntegrations.customHeadersMode", { defaultValue: "Use an API key" }) }), _jsx("button", { type: "button", onClick: () => {
-                                                setCustomAuthMode((current) => current === "oauth" ? "headers" : "oauth");
-                                                clearFeedback();
-                                            }, className: "font-medium text-foreground underline underline-offset-2 hover:text-muted-foreground", children: customAuthMode === "oauth"
-                                                ? t(
-                                                /* i18n-key-ignore */
-                                                "mcpIntegrations.useApiKeyInstead", { defaultValue: "Use an API key instead" })
-                                                : t(
-                                                /* i18n-key-ignore */
-                                                "mcpIntegrations.useOAuthInstead", { defaultValue: "Use OAuth instead" }) })] })), !selectedRequiresSetup && (_jsxs(_Fragment, { children: [selected?.authMode === "oauth" && (_jsx("div", { className: "rounded-md border border-primary/20 bg-primary/5 px-3 py-2 text-[11px] leading-relaxed text-primary", children: t("mcpIntegrations.oauthNotice") })), _jsxs("label", { className: "block", children: [_jsx("span", { className: "mb-1 block text-[10px] font-medium text-muted-foreground", children: t("mcpIntegrations.serverName") }), _jsx("input", { ref: inputRef, value: name, onChange: (event) => {
-                                                        setName(event.target.value);
-                                                        clearFeedback();
-                                                    }, className: "w-full rounded-md border border-border bg-background px-2.5 py-1.5 text-[13px] text-foreground outline-none placeholder:text-muted-foreground/50 focus:ring-1 focus:ring-ring", placeholder: t("mcpIntegrations.serverNamePlaceholder") })] }), _jsxs("label", { className: "block", children: [_jsx("span", { className: "mb-1 block text-[10px] font-medium text-muted-foreground", children: t("mcpIntegrations.url") }), _jsx("input", { value: url, onChange: (event) => {
-                                                        setUrl(event.target.value);
-                                                        clearFeedback();
-                                                    }, className: "w-full rounded-md border border-border bg-background px-2.5 py-1.5 text-[13px] text-foreground outline-none placeholder:text-muted-foreground/50 focus:ring-1 focus:ring-ring", placeholder: t("mcpIntegrations.urlPlaceholder") })] }), _jsxs("label", { className: "block", children: [_jsx("span", { className: "mb-1 block text-[10px] font-medium text-muted-foreground", children: t("mcpIntegrations.fieldDescription") }), _jsx("input", { value: description, onChange: (event) => {
-                                                        setDescription(event.target.value);
-                                                        clearFeedback();
-                                                    }, className: "w-full rounded-md border border-border bg-background px-2.5 py-1.5 text-[13px] text-foreground outline-none placeholder:text-muted-foreground/50 focus:ring-1 focus:ring-ring", placeholder: t("mcpIntegrations.descriptionPlaceholder") })] }), (selected
-                                            ? selected.authMode !== "oauth"
-                                            : customAuthMode === "headers") && (_jsxs("label", { className: "block", children: [_jsx("span", { className: "mb-1 block text-[10px] font-medium text-muted-foreground", children: t("mcpIntegrations.headers") }), _jsx("textarea", { value: headersText, onChange: (event) => {
-                                                        setHeadersText(event.target.value);
-                                                        clearFeedback();
-                                                    }, rows: 3, className: "w-full resize-y rounded-md border border-border bg-background px-2.5 py-1.5 text-[12px] text-foreground outline-none placeholder:text-muted-foreground/50 focus:ring-1 focus:ring-ring", style: {
-                                                        fontFamily: 'ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace',
-                                                    }, placeholder: selected?.headerPlaceholder ??
-                                                        t("mcpIntegrations.headersPlaceholder") })] })), selected?.docsUrl && (_jsxs("a", { href: selected.docsUrl, target: "_blank", rel: "noopener noreferrer", className: "inline-flex items-center gap-1 text-[11px] text-muted-foreground underline hover:text-foreground", children: [t("mcpIntegrations.openSetupDocs"), _jsx(IconExternalLink, { className: "h-3 w-3" })] }))] })), testResult && (_jsxs("div", { className: cn("flex items-start gap-1 rounded-md px-3 py-2 text-[11px] leading-snug", testResult.ok
-                                        ? "bg-green-500/5 text-green-600 dark:text-green-400"
-                                        : "bg-red-500/5 text-red-600 dark:text-red-400"), children: [testResult.ok && (_jsx(IconCheck, { className: "mt-0.5 h-3 w-3 shrink-0" })), _jsx("span", { className: "min-w-0 break-words", children: testResult.message })] })), error && (_jsx("div", { className: "break-words rounded-md bg-red-500/5 px-3 py-2 text-[11px] leading-snug text-red-600 dark:text-red-400", children: error }))] }) }), _jsxs("div", { className: "flex shrink-0 items-center justify-between gap-2 border-t border-border px-7 py-4", children: [!selectedRequiresSetup && (_jsx("button", { type: "button", onClick: runTest, disabled: !url.trim() || busy, className: "rounded-md border border-border bg-background px-3 py-1.5 text-[12px] font-medium text-foreground hover:bg-accent disabled:pointer-events-none disabled:opacity-40", children: t("mcpIntegrations.test") })), !selected && customAuthMode === "oauth" ? (_jsxs("button", { type: "button", onClick: connectCustomWithOAuth, disabled: !name.trim() || !url.trim() || busy, "aria-busy": busy, className: "rounded-md border border-border bg-background px-3 py-1.5 text-[12px] font-medium text-foreground hover:bg-accent disabled:pointer-events-none disabled:opacity-40", children: [busy && (_jsx(IconLoader2, { className: "me-1.5 inline h-3.5 w-3.5 animate-spin" })), t("mcpIntegrations.connectWithOAuth")] })) : null, selectedRequiresSetup ? (_jsxs("div", { className: "ms-auto flex items-center gap-2", children: [selected?.docsUrl ? (_jsxs("a", { href: selected.docsUrl, target: "_blank", rel: "noopener noreferrer", className: "inline-flex min-w-[92px] items-center justify-center gap-1.5 rounded-md border border-border bg-background px-3 py-1.5 text-[12px] font-medium text-foreground hover:bg-accent", children: [t("mcpIntegrations.viewSetup"), _jsx(IconExternalLink, { className: "h-3 w-3" })] })) : null, selected?.authMode === "oauth" && (_jsxs("button", { type: "button", onClick: () => connectWithOAuth(selected), disabled: busy, "aria-busy": busy, className: "inline-flex min-w-[132px] items-center justify-center gap-1.5 rounded-md bg-primary px-3 py-1.5 text-[12px] font-medium text-primary-foreground hover:bg-primary/90 disabled:pointer-events-none disabled:opacity-40", children: [busy && (_jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" })), t("mcpIntegrations.continueToConnect")] }))] })) : selected?.authMode === "oauth" ? (_jsxs("button", { type: "button", onClick: () => connectWithOAuth(selected), disabled: !name.trim() || !url.trim() || busy, "aria-busy": busy, className: "inline-flex min-w-[92px] items-center justify-center gap-1.5 rounded-md bg-primary px-3 py-1.5 text-[12px] font-medium text-primary-foreground hover:bg-primary/90 disabled:pointer-events-none disabled:opacity-40", children: [busy && _jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" }), t("mcpIntegrations.connectWithOAuth")] })) : !selected && customAuthMode === "oauth" ? null : (_jsxs("button", { type: "button", onClick: submitForm, disabled: !name.trim() || !url.trim() || busy, className: "inline-flex min-w-[92px] items-center justify-center gap-1.5 rounded-md bg-primary px-3 py-1.5 text-[12px] font-medium text-primary-foreground hover:bg-primary/90 disabled:pointer-events-none disabled:opacity-40", children: [busy && _jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" }), t("mcpIntegrations.connect")] }))] })] })) }) }));
+                                                        ? t("mcpIntegrations.status.setupRequired")
+                                                        : undefined,
+                                                statusClassName: connected
+                                                    ? "text-emerald-600 dark:text-emerald-400"
+                                                    : "text-muted-foreground",
+                                                actionLabel: connected
+                                                    ? "Manage"
+                                                    : setupOnly && apiFallback
+                                                        ? t("mcpIntegrations.useApiToken")
+                                                        : setupOnly
+                                                            ? t("mcpIntegrations.viewSetup")
+                                                            : t("mcpIntegrations.connect"),
+                                                disabled: connected || busy || !mcpServersQuery.isSuccess,
+                                                onAction: () => {
+                                                    if (connected) {
+                                                        openForm(integration);
+                                                        return;
+                                                    }
+                                                    selectCatalogConnection(integration);
+                                                },
+                                            };
+                                        }), emptyLabel: t("mcpIntegrations.noMatches") })] }) })] })) : (_jsxs(_Fragment, { children: [_jsxs(DialogHeader, { className: "shrink-0 border-b border-border px-7 pb-5 pe-14 pt-7 sm:px-10", children: [_jsxs("button", { type: "button", onClick: () => {
+                                        clearFeedback();
+                                        setMode("catalog");
+                                    }, className: cn("mb-1 inline-flex w-fit items-center gap-1 text-[11px] text-muted-foreground hover:text-foreground", !showCatalog && "hidden"), children: [_jsx(IconArrowLeft, { className: "h-3 w-3 rtl:-scale-x-100" }), t("mcpIntegrations.backToIntegrations")] }), _jsx(DialogTitle, { children: selected
+                                        ? selectedRequiresSetup
+                                            ? t("mcpIntegrations.setupTitle", {
+                                                name: selected.name,
+                                            })
+                                            : t("mcpIntegrations.configureTitle", {
+                                                name: selected.name,
+                                            })
+                                        : t("mcpIntegrations.customTitle") }), _jsx(DialogDescription, { children: selected
+                                        ? selectedRequiresSetup
+                                            ? t("mcpIntegrations.providerSetupFormDescription")
+                                            : selected.authMode === "none"
+                                                ? t("mcpIntegrations.presetNoAuthDescription")
+                                                : t("mcpIntegrations.presetAuthDescription")
+                                        : t("mcpIntegrations.customDescription") })] }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto px-7 py-7 sm:px-10", children: _jsxs("div", { className: "mx-auto max-w-2xl space-y-3", children: [renderScopeSelector(), selected?.setupNoteKey && !selectedRequiresSetup ? (_jsx("div", { className: "rounded-md bg-muted/40 px-3 py-2 text-[11px] leading-relaxed text-muted-foreground", children: t(selected.setupNoteKey) })) : null, selectedRequiresSetup && selected && (_jsxs("div", { className: "mx-auto grid w-full max-w-xl gap-4 py-8", children: [_jsxs("div", { children: [_jsx("p", { className: "text-base font-semibold tracking-[-0.02em] text-foreground", children: t("mcpIntegrations.providerSetupRequired") }), _jsx("p", { className: "mt-1 text-sm leading-6 text-muted-foreground", children: t("mcpIntegrations.providerSetupDescription", {
+                                                            name: selected.name,
+                                                        }) })] }), selected.setupNoteKey ? (_jsx("p", { className: "text-sm leading-6 text-muted-foreground", children: t(selected.setupNoteKey) })) : null, selected.docsUrl ? (_jsxs("a", { href: selected.docsUrl, target: "_blank", rel: "noopener noreferrer", className: "inline-flex w-fit items-center gap-1 text-sm font-medium text-foreground underline underline-offset-4 hover:text-muted-foreground", children: [t("mcpIntegrations.viewSetup"), _jsx(IconExternalLink, { className: "size-3.5" })] })) : null] })), !selected && (_jsxs("div", { className: "flex items-center justify-between gap-3 rounded-md bg-muted/30 px-3 py-2 text-[11px]", children: [_jsx("span", { className: "text-muted-foreground", children: customAuthMode === "oauth"
+                                                    ? t(
+                                                    /* i18n-key-ignore */
+                                                    "mcpIntegrations.customOAuthDefault", { defaultValue: "Sign in with OAuth" })
+                                                    : t(
+                                                    /* i18n-key-ignore */
+                                                    "mcpIntegrations.customHeadersMode", { defaultValue: "Use an API key" }) }), _jsx("button", { type: "button", onClick: () => {
+                                                    setCustomAuthMode((current) => current === "oauth" ? "headers" : "oauth");
+                                                    clearFeedback();
+                                                }, className: "font-medium text-foreground underline underline-offset-2 hover:text-muted-foreground", children: customAuthMode === "oauth"
+                                                    ? t(
+                                                    /* i18n-key-ignore */
+                                                    "mcpIntegrations.useApiKeyInstead", { defaultValue: "Use an API key instead" })
+                                                    : t(
+                                                    /* i18n-key-ignore */
+                                                    "mcpIntegrations.useOAuthInstead", { defaultValue: "Use OAuth instead" }) })] })), !selectedRequiresSetup && (_jsxs(_Fragment, { children: [selected?.authMode === "oauth" && (_jsx("div", { className: "rounded-md border border-primary/20 bg-primary/5 px-3 py-2 text-[11px] leading-relaxed text-primary", children: t("mcpIntegrations.oauthNotice") })), _jsxs("label", { className: "block", children: [_jsx("span", { className: "mb-1 block text-[10px] font-medium text-muted-foreground", children: t("mcpIntegrations.serverName") }), _jsx("input", { ref: inputRef, value: name, onChange: (event) => {
+                                                            setName(event.target.value);
+                                                            clearFeedback();
+                                                        }, className: "w-full rounded-md border border-border bg-background px-2.5 py-1.5 text-[13px] text-foreground outline-none placeholder:text-muted-foreground/50 focus:ring-1 focus:ring-ring", placeholder: t("mcpIntegrations.serverNamePlaceholder") })] }), _jsxs("label", { className: "block", children: [_jsx("span", { className: "mb-1 block text-[10px] font-medium text-muted-foreground", children: t("mcpIntegrations.url") }), _jsx("input", { value: url, onChange: (event) => {
+                                                            setUrl(event.target.value);
+                                                            clearFeedback();
+                                                        }, className: "w-full rounded-md border border-border bg-background px-2.5 py-1.5 text-[13px] text-foreground outline-none placeholder:text-muted-foreground/50 focus:ring-1 focus:ring-ring", placeholder: t("mcpIntegrations.urlPlaceholder") })] }), _jsxs("label", { className: "block", children: [_jsx("span", { className: "mb-1 block text-[10px] font-medium text-muted-foreground", children: t("mcpIntegrations.fieldDescription") }), _jsx("input", { value: description, onChange: (event) => {
+                                                            setDescription(event.target.value);
+                                                            clearFeedback();
+                                                        }, className: "w-full rounded-md border border-border bg-background px-2.5 py-1.5 text-[13px] text-foreground outline-none placeholder:text-muted-foreground/50 focus:ring-1 focus:ring-ring", placeholder: t("mcpIntegrations.descriptionPlaceholder") })] }), (selected
+                                                ? selected.authMode !== "oauth"
+                                                : customAuthMode === "headers") && (_jsxs("label", { className: "block", children: [_jsx("span", { className: "mb-1 block text-[10px] font-medium text-muted-foreground", children: t("mcpIntegrations.headers") }), _jsx("textarea", { value: headersText, onChange: (event) => {
+                                                            setHeadersText(event.target.value);
+                                                            clearFeedback();
+                                                        }, rows: 3, className: "w-full resize-y rounded-md border border-border bg-background px-2.5 py-1.5 text-[12px] text-foreground outline-none placeholder:text-muted-foreground/50 focus:ring-1 focus:ring-ring", style: {
+                                                            fontFamily: 'ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace',
+                                                        }, placeholder: selected?.headerPlaceholder ??
+                                                            t("mcpIntegrations.headersPlaceholder") })] })), selected?.docsUrl && (_jsxs("a", { href: selected.docsUrl, target: "_blank", rel: "noopener noreferrer", className: "inline-flex items-center gap-1 text-[11px] text-muted-foreground underline hover:text-foreground", children: [t("mcpIntegrations.openSetupDocs"), _jsx(IconExternalLink, { className: "h-3 w-3" })] }))] })), testResult && (_jsxs("div", { className: cn("flex items-start gap-1 rounded-md px-3 py-2 text-[11px] leading-snug", testResult.ok
+                                            ? "bg-green-500/5 text-green-600 dark:text-green-400"
+                                            : "bg-red-500/5 text-red-600 dark:text-red-400"), children: [testResult.ok && (_jsx(IconCheck, { className: "mt-0.5 h-3 w-3 shrink-0" })), _jsx("span", { className: "min-w-0 break-words", children: testResult.message })] })), error && (_jsx("div", { className: "break-words rounded-md bg-red-500/5 px-3 py-2 text-[11px] leading-snug text-red-600 dark:text-red-400", children: error }))] }) }), _jsxs("div", { className: "flex shrink-0 items-center justify-between gap-2 border-t border-border px-7 py-4", children: [!selectedRequiresSetup && (_jsx("button", { type: "button", onClick: runTest, disabled: !url.trim() || busy, className: "rounded-md border border-border bg-background px-3 py-1.5 text-[12px] font-medium text-foreground hover:bg-accent disabled:pointer-events-none disabled:opacity-40", children: t("mcpIntegrations.test") })), !selected && customAuthMode === "oauth" ? (_jsxs("button", { type: "button", onClick: connectCustomWithOAuth, disabled: !name.trim() || !url.trim() || busy, "aria-busy": busy, className: "rounded-md border border-border bg-background px-3 py-1.5 text-[12px] font-medium text-foreground hover:bg-accent disabled:pointer-events-none disabled:opacity-40", children: [busy && (_jsx(IconLoader2, { className: "me-1.5 inline h-3.5 w-3.5 animate-spin" })), t("mcpIntegrations.connectWithOAuth")] })) : null, selectedRequiresSetup ? (_jsxs("div", { className: "ms-auto flex items-center gap-2", children: [selected?.docsUrl ? (_jsxs("a", { href: selected.docsUrl, target: "_blank", rel: "noopener noreferrer", className: "inline-flex min-w-[92px] items-center justify-center gap-1.5 rounded-md border border-border bg-background px-3 py-1.5 text-[12px] font-medium text-foreground hover:bg-accent", children: [t("mcpIntegrations.viewSetup"), _jsx(IconExternalLink, { className: "h-3 w-3" })] })) : null, selected?.authMode === "oauth" && (_jsxs("button", { type: "button", onClick: () => connectWithOAuth(selected), disabled: busy, "aria-busy": busy, className: "inline-flex min-w-[132px] items-center justify-center gap-1.5 rounded-md bg-primary px-3 py-1.5 text-[12px] font-medium text-primary-foreground hover:bg-primary/90 disabled:pointer-events-none disabled:opacity-40", children: [busy && (_jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" })), t("mcpIntegrations.continueToConnect")] }))] })) : selected?.authMode === "oauth" ? (_jsxs("button", { type: "button", onClick: () => connectWithOAuth(selected), disabled: !name.trim() || !url.trim() || busy, "aria-busy": busy, className: "inline-flex min-w-[92px] items-center justify-center gap-1.5 rounded-md bg-primary px-3 py-1.5 text-[12px] font-medium text-primary-foreground hover:bg-primary/90 disabled:pointer-events-none disabled:opacity-40", children: [busy && _jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" }), t("mcpIntegrations.connectWithOAuth")] })) : !selected && customAuthMode === "oauth" ? null : (_jsxs("button", { type: "button", onClick: submitForm, disabled: !name.trim() || !url.trim() || busy, className: "inline-flex min-w-[92px] items-center justify-center gap-1.5 rounded-md bg-primary px-3 py-1.5 text-[12px] font-medium text-primary-foreground hover:bg-primary/90 disabled:pointer-events-none disabled:opacity-40", children: [busy && _jsx(IconLoader2, { className: "h-3.5 w-3.5 animate-spin" }), t("mcpIntegrations.connect")] }))] })] }))] }) }));
 }

package/dist/client/resources/mcp-integration-catalog.d.ts

@@ -71,6 +71,7 @@ export declare function buildMcpOAuthStartUrl({ name, url, description, scope, r
 export declare function navigateToMcpOAuthStart(url: string): void;
 export declare function resolveMcpIntegrationScope(defaultScope: "user" | "org", hasOrg: boolean, canCreateOrgMcp: boolean, supportsOrganizationScope?: boolean): "user" | "org";
 export declare function shouldOfferMcpOrganizationScope(hasOrg: boolean, canCreateOrgMcp: boolean): boolean;
+export declare function supportsMcpIntegrationOrganizationScope(integration: DefaultMcpIntegration): boolean;
 export declare function shouldOfferMcpIntegrationOrganizationScope(integration: DefaultMcpIntegration, hasOrg: boolean, canCreateOrgMcp: boolean): boolean;
 export declare function filterMcpIntegrations(query: string, integrations?: DefaultMcpIntegration[]): DefaultMcpIntegration[];
 export declare function findMcpIntegrationForText(text: string, integrations?: DefaultMcpIntegration[]): DefaultMcpIntegration | null;

package/dist/client/resources/mcp-integration-catalog.js

@@ -863,10 +863,13 @@ export function resolveMcpIntegrationScope(defaultScope, hasOrg, canCreateOrgMcp
 export function shouldOfferMcpOrganizationScope(hasOrg, canCreateOrgMcp) {
     return hasOrg && canCreateOrgMcp;
 }
+export function supportsMcpIntegrationOrganizationScope(integration) {
+    return (integration.supportsOrganizationScope === true &&
+        integration.managedOAuth !== true);
+}
 export function shouldOfferMcpIntegrationOrganizationScope(integration, hasOrg, canCreateOrgMcp) {
     return (shouldOfferMcpOrganizationScope(hasOrg, canCreateOrgMcp) &&
-        integration.supportsOrganizationScope === true &&
-        integration.managedOAuth !== true);
+        supportsMcpIntegrationOrganizationScope(integration));
 }
 export function filterMcpIntegrations(query, integrations = getDefaultMcpIntegrations()) {
     const needle = query.trim().toLowerCase();

package/dist/collab/routes.d.ts

@@ -26,8 +26,8 @@ export declare const getCollabState: import("h3").EventHandlerWithFetch<import("
  * Body: { update: string (base64), requestSource?: string }
  */
 export declare const postCollabUpdate: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    error: string;
     ok?: undefined;
+    error: string;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/db/migrations.js

@@ -1,3 +1,4 @@
+import { getAppConfig } from "../app-config/index.js";
 import { getDbExec, createDbExec, isPostgres, getDialect, getMigrationDatabaseUrl, getCloudflareD1Binding, retrySqliteBusy, } from "./client.js";
 import { isMigrationAuthorizedRuntime } from "./migration-runtime.js";
 // ---------------------------------------------------------------------------
@@ -250,8 +251,15 @@ function isServerlessRequestRuntime() {
  * migration skipping is safe only when that runner owns schema setup.
  */
 function appMigratesAtRelease() {
-    const raw = process.env.AGENT_NATIVE_RELEASE_MIGRATIONS?.trim();
-    return !!raw && ["1", "true", "yes", "on"].includes(raw.toLowerCase());
+    const { migration } = getAppConfig();
+    if (migration.releaseMigrations)
+        return true;
+    // Clips beta uses the production-owned schema but its masked prebuilt build
+    // must not run migrate:production against the fake build database. The
+    // owner marker is embedded into the deployed server bundle and therefore
+    // carries the same request-path skip decision without pretending the masked
+    // build performed the release migration.
+    return migration.betaSchemaOwner?.toLowerCase() === "production";
 }
 /**
  * Run an explicit release-time migration job with migration duty enabled.

package/dist/deploy/build.js

@@ -34,6 +34,7 @@ import { generateActionRegistryForProject } from "../vite/action-types-plugin.js
 import { createAgentNativeConfigContext, loadResolvedAgentNativeConfig, } from "../vite/agent-native-config-loader.js";
 import { cloneServerBundleForFunction, copyDir } from "./function-bundle.js";
 import { collectImmutableAssetPaths, IMMUTABLE_ASSET_CACHE_CONTROL, IMMUTABLE_ASSET_CACHE_HEADERS, prefixAssetPath, } from "./immutable-assets.js";
+import { writeNetlifyStaticHeaders } from "./netlify-static-headers.js";
 import { discoverApiRoutes, discoverPlugins, discoverActionFiles, getMissingDefaultPlugins, DEFAULT_PLUGIN_REGISTRY, } from "./route-discovery.js";
 import { getWorkspaceCoreExports, } from "./workspace-core.js";
 const cwd = process.cwd();
@@ -3892,6 +3893,7 @@ export function resolveNitroBuildReplacements(env = process.env, deploymentEnvir
         // a separate server build, so embed release migration ownership here as
         // well as in the Vite server bundle.
         "process.env.AGENT_NATIVE_RELEASE_MIGRATIONS": JSON.stringify(env.AGENT_NATIVE_RELEASE_MIGRATIONS?.trim() || ""),
+        "process.env.AGENT_NATIVE_BETA_SCHEMA_OWNER": JSON.stringify(env.AGENT_NATIVE_BETA_SCHEMA_OWNER?.trim() || ""),
         "process.env.AGENT_NATIVE_BUILD_DEPLOY_CONTEXT": JSON.stringify(env.CONTEXT?.trim() || env.NETLIFY_CONTEXT?.trim() || ""),
         // Whether the recurring-jobs scheduled function exists is decided HERE, by
         // the build env. `scheduledTriggerAvailability` cannot re-derive it later —
@@ -4087,6 +4089,10 @@ export default bundle;
             }
         }
         writeSingleTemplateNetlifyRedirects(cwd);
+        // React Router prerendered pages bypass the SSR function and are served
+        // directly from Netlify's static backing store. Keep that artifact on the
+        // same public SWR policy as runtime SSR and .data responses.
+        writeNetlifyStaticHeaders(path.join(cwd, "dist"));
         assertSingleTemplateNetlifyBuildOutput(cwd);
     }
     // Resolve remaining bare npm imports by bundling them into _libs/.

package/dist/deploy/netlify-static-headers.d.ts

@@ -0,0 +1,3 @@
+export declare const GENERATED_NETLIFY_HEADERS_MARKER = "# Generated by @agent-native/core deploy/netlify-static-headers.ts";
+export declare function renderNetlifyStaticHeaders(env?: Record<string, string | undefined>): string;
+export declare function writeNetlifyStaticHeaders(publishDir: string, env?: Record<string, string | undefined>): void;

package/dist/deploy/netlify-static-headers.js

@@ -0,0 +1,60 @@
+import fs from "node:fs";
+import path from "node:path";
+import { resolveSsrCacheHeaders } from "../shared/cache-control.js";
+import { IMMUTABLE_ASSET_CACHE_CONTROL } from "./immutable-assets.js";
+export const GENERATED_NETLIFY_HEADERS_MARKER = "# Generated by @agent-native/core deploy/netlify-static-headers.ts";
+const LEGACY_GENERATED_NETLIFY_HEADERS_MARKER = "# Generated by @agent-native/docs scripts/generate-netlify-headers.ts";
+function renderHeaderBlock(pathname, headers) {
+    return [
+        pathname,
+        ...headers.map(([name, value]) => `  ${name}: ${value}`),
+    ].join("\n");
+}
+export function renderNetlifyStaticHeaders(env = process.env) {
+    const ssrHeaders = resolveSsrCacheHeaders(env);
+    const ssrHeaderEntries = [
+        ["Cache-Control", ssrHeaders["cache-control"]],
+        ["CDN-Cache-Control", ssrHeaders["cdn-cache-control"]],
+        ["Netlify-CDN-Cache-Control", ssrHeaders["netlify-cdn-cache-control"]],
+    ];
+    const immutableAssetHeaders = [
+        ["Cache-Control", IMMUTABLE_ASSET_CACHE_CONTROL],
+        ["CDN-Cache-Control", IMMUTABLE_ASSET_CACHE_CONTROL],
+        ["Netlify-CDN-Cache-Control", IMMUTABLE_ASSET_CACHE_CONTROL],
+    ];
+    const internalHeaders = [
+        ["Cache-Control", "no-cache, no-store"],
+        ["CDN-Cache-Control", "no-cache, no-store"],
+        ["Netlify-CDN-Cache-Control", "no-cache, no-store"],
+    ];
+    return ([
+        GENERATED_NETLIFY_HEADERS_MARKER,
+        renderHeaderBlock("/*", ssrHeaderEntries),
+        renderHeaderBlock("/assets/*", immutableAssetHeaders),
+        renderHeaderBlock("/_agent-native/*", internalHeaders),
+    ].join("\n\n") + "\n");
+}
+export function writeNetlifyStaticHeaders(publishDir, env = process.env) {
+    if (!fs.existsSync(publishDir)) {
+        throw new Error(`Netlify publish directory does not exist: ${publishDir}`);
+    }
+    const headersPath = path.join(publishDir, "_headers");
+    const existing = fs.existsSync(headersPath)
+        ? fs.readFileSync(headersPath, "utf8").trim()
+        : "";
+    const generated = renderNetlifyStaticHeaders(env).trim();
+    const generatedStart = [
+        GENERATED_NETLIFY_HEADERS_MARKER,
+        LEGACY_GENERATED_NETLIFY_HEADERS_MARKER,
+    ]
+        .map((marker) => existing.indexOf(marker))
+        .filter((index) => index >= 0)
+        .sort((a, b) => a - b)[0];
+    const existingWithoutGenerated = generatedStart === undefined
+        ? existing
+        : existing.slice(0, generatedStart).trimEnd();
+    const contents = existingWithoutGenerated
+        ? `${existingWithoutGenerated}\n\n${generated}`
+        : generated;
+    fs.writeFileSync(headersPath, `${contents}\n`);
+}