@agent-native/core 0.49.9 → 0.49.11

package/dist/server/entry-server.d.ts

@@ -1,10 +1,19 @@
 /**
  * Shared React Router entry-server handler for agent-native templates.
  *
- * Templates that don't need customization can reduce their entry.server.tsx
- * to a single re-export:
+ * Templates can keep the shared behavior while importing `ServerRouter` from
+ * their own app-local `react-router` dependency:
  *
- *   export { handleDocumentRequest as default, streamTimeout } from "@agent-native/core/server/entry-server";
+ *   import { ServerRouter } from "react-router";
+ *   import { createDocumentRequestHandler, streamTimeout } from "@agent-native/core/server/entry-server";
+ *
+ *   const handleDocumentRequest = createDocumentRequestHandler(ServerRouter);
+ *   export { streamTimeout };
+ *   export default handleDocumentRequest;
+ *
+ * Keeping `ServerRouter` app-local matters in pnpm/published-package installs:
+ * React Router's `<Meta />`, `<Links />`, and `<Scripts />` read framework
+ * context from the same package singleton that rendered `<ServerRouter>`.
  *
  * The superset behavior covers all variants observed across the template fleet:
  *   - HEAD requests: return early with status/headers, no stream body
@@ -17,8 +26,22 @@
  *     conditionally undefined), so the `typeof === "function"` guards that
  *     appeared in older template copies were dead code and are removed here
  */
+import type { ReactElement } from "react";
 import type { AppLoadContext, EntryContext } from "react-router";
 export declare const streamTimeout = 5000;
-export declare function handleDocumentRequest(request: Request, responseStatusCode: number, responseHeaders: Headers, routerContext: EntryContext, _loadContext: AppLoadContext): Promise<Response>;
+type ServerRouterComponent = (props: {
+    context: EntryContext;
+    url: string;
+}) => ReactElement;
+export type DocumentRequestHandler = (request: Request, responseStatusCode: number, responseHeaders: Headers, routerContext: EntryContext, loadContext: AppLoadContext) => Promise<Response>;
+export declare function createDocumentRequestHandler(ServerRouter: ServerRouterComponent): DocumentRequestHandler;
+/**
+ * Backwards-compatible default for older generated apps.
+ *
+ * New templates should call `createDocumentRequestHandler(ServerRouter)` from
+ * their own `entry.server.tsx` so React Router framework context always comes
+ * from the app-local singleton.
+ */
+export declare function handleDocumentRequest(request: Request, responseStatusCode: number, responseHeaders: Headers, routerContext: EntryContext, loadContext: AppLoadContext): Promise<Response>;
 export default handleDocumentRequest;
 //# sourceMappingURL=entry-server.d.ts.map

package/dist/server/entry-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entry-server.d.ts","sourceRoot":"","sources":["../../src/server/entry-server.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AASjE,eAAO,MAAM,aAAa,OAAQ,CAAC;AAEnC,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,kBAAkB,EAAE,MAAM,EAC1B,eAAe,EAAE,OAAO,EACxB,aAAa,EAAE,YAAY,EAC3B,YAAY,EAAE,cAAc,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAoDnB;AAED,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"entry-server.d.ts","sourceRoot":"","sources":["../../src/server/entry-server.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAQjE,eAAO,MAAM,aAAa,OAAQ,CAAC;AAEnC,KAAK,qBAAqB,GAAG,CAAC,KAAK,EAAE;IACnC,OAAO,EAAE,YAAY,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb,KAAK,YAAY,CAAC;AAEnB,MAAM,MAAM,sBAAsB,GAAG,CACnC,OAAO,EAAE,OAAO,EAChB,kBAAkB,EAAE,MAAM,EAC1B,eAAe,EAAE,OAAO,EACxB,aAAa,EAAE,YAAY,EAC3B,WAAW,EAAE,cAAc,KACxB,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,qBAAqB,GAClC,sBAAsB,CA6DxB;AAYD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,kBAAkB,EAAE,MAAM,EAC1B,eAAe,EAAE,OAAO,EACxB,aAAa,EAAE,YAAY,EAC3B,WAAW,EAAE,cAAc,GAC1B,OAAO,CAAC,QAAQ,CAAC,CASnB;AAED,eAAe,qBAAqB,CAAC"}

package/dist/server/entry-server.js

@@ -1,54 +1,74 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { ServerRouter } from "react-router";
 import ReactDOMServer from "react-dom/server.browser";
 const { renderToReadableStream } = ReactDOMServer;
 import { isbot } from "isbot";
 import { wrapWithAnalytics } from "./analytics.js";
 export const streamTimeout = 5_000;
-export async function handleDocumentRequest(request, responseStatusCode, responseHeaders, routerContext, _loadContext) {
-    // HEAD requests need no body — return immediately.
-    if (request.method.toUpperCase() === "HEAD") {
-        return new Response(null, {
-            status: responseStatusCode,
-            headers: responseHeaders,
-        });
-    }
-    // Reject Chrome DevTools well-known probes that have no matching route.
-    // Content template introduced this improvement; it becomes the default here.
-    const url = new URL(request.url);
-    if (url.pathname.startsWith("/.well-known/")) {
-        return new Response(null, { status: 404 });
-    }
-    const userAgent = request.headers.get("user-agent");
-    // Wait for full render for bots (so crawlers see complete HTML) and in SPA
-    // mode (where the stream must be fully hydrated before sending).
-    const waitForAll = (userAgent && isbot(userAgent)) || routerContext.isSpaMode;
-    const abortController = new AbortController();
-    const timeoutId = setTimeout(() => abortController.abort(), streamTimeout);
-    try {
-        const body = await renderToReadableStream(_jsx(ServerRouter, { context: routerContext, url: request.url }), {
-            signal: abortController.signal,
-            onError(error) {
-                // Only record a 500 when the stream hasn't already been deliberately
-                // aborted by the timeout above.
-                if (!abortController.signal.aborted) {
-                    responseStatusCode = 500;
-                    console.error(error);
-                }
-            },
-        });
-        if (waitForAll) {
-            await body.allReady;
+export function createDocumentRequestHandler(ServerRouter) {
+    return async function handleDocumentRequest(request, responseStatusCode, responseHeaders, routerContext, _loadContext) {
+        // HEAD requests need no body — return immediately.
+        if (request.method.toUpperCase() === "HEAD") {
+            return new Response(null, {
+                status: responseStatusCode,
+                headers: responseHeaders,
+            });
         }
-        responseHeaders.set("Content-Type", "text/html");
-        return new Response(wrapWithAnalytics(body), {
-            headers: responseHeaders,
-            status: responseStatusCode,
-        });
-    }
-    finally {
-        clearTimeout(timeoutId);
+        // Reject Chrome DevTools well-known probes that have no matching route.
+        // Content template introduced this improvement; it becomes the default here.
+        const url = new URL(request.url);
+        if (url.pathname.startsWith("/.well-known/")) {
+            return new Response(null, { status: 404 });
+        }
+        const userAgent = request.headers.get("user-agent");
+        // Wait for full render for bots (so crawlers see complete HTML) and in SPA
+        // mode (where the stream must be fully hydrated before sending).
+        const waitForAll = (userAgent && isbot(userAgent)) || routerContext.isSpaMode;
+        const abortController = new AbortController();
+        const timeoutId = setTimeout(() => abortController.abort(), streamTimeout);
+        try {
+            const body = await renderToReadableStream(_jsx(ServerRouter, { context: routerContext, url: request.url }), {
+                signal: abortController.signal,
+                onError(error) {
+                    // Only record a 500 when the stream hasn't already been deliberately
+                    // aborted by the timeout above.
+                    if (!abortController.signal.aborted) {
+                        responseStatusCode = 500;
+                        console.error(error);
+                    }
+                },
+            });
+            if (waitForAll) {
+                await body.allReady;
+            }
+            responseHeaders.set("Content-Type", "text/html");
+            return new Response(wrapWithAnalytics(body), {
+                headers: responseHeaders,
+                status: responseStatusCode,
+            });
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    };
+}
+let defaultDocumentRequestHandler = null;
+async function getDefaultDocumentRequestHandler() {
+    if (!defaultDocumentRequestHandler) {
+        const { ServerRouter } = await import("react-router");
+        defaultDocumentRequestHandler = createDocumentRequestHandler(ServerRouter);
     }
+    return defaultDocumentRequestHandler;
+}
+/**
+ * Backwards-compatible default for older generated apps.
+ *
+ * New templates should call `createDocumentRequestHandler(ServerRouter)` from
+ * their own `entry.server.tsx` so React Router framework context always comes
+ * from the app-local singleton.
+ */
+export async function handleDocumentRequest(request, responseStatusCode, responseHeaders, routerContext, loadContext) {
+    const handler = await getDefaultDocumentRequestHandler();
+    return handler(request, responseStatusCode, responseHeaders, routerContext, loadContext);
 }
 export default handleDocumentRequest;
 //# sourceMappingURL=entry-server.js.map

package/dist/server/entry-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"entry-server.js","sourceRoot":"","sources":["../../src/server/entry-server.tsx"],"names":[],"mappings":";AAqBA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,cAAc,MAAM,0BAA0B,CAAC;AAEtD,MAAM,EAAE,sBAAsB,EAAE,GAAG,cAAc,CAAC;AAElD,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AAEnC,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAgB,EAChB,kBAA0B,EAC1B,eAAwB,EACxB,aAA2B,EAC3B,YAA4B;IAE5B,mDAAmD;IACnD,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;QAC5C,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE;YACxB,MAAM,EAAE,kBAAkB;YAC1B,OAAO,EAAE,eAAe;SACzB,CAAC,CAAC;IACL,CAAC;IAED,wEAAwE;IACxE,6EAA6E;IAC7E,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAC7C,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACpD,2EAA2E;IAC3E,iEAAiE;IACjE,MAAM,UAAU,GAAG,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,aAAa,CAAC,SAAS,CAAC;IAE9E,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAC9C,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,EAAE,aAAa,CAAC,CAAC;IAE3E,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,sBAAsB,CACvC,KAAC,YAAY,IAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,GAAI,EAC1D;YACE,MAAM,EAAE,eAAe,CAAC,MAAM;YAC9B,OAAO,CAAC,KAAc;gBACpB,qEAAqE;gBACrE,gCAAgC;gBAChC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpC,kBAAkB,GAAG,GAAG,CAAC;oBACzB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;SACF,CACF,CAAC;QAEF,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,QAAQ,CAAC;QACtB,CAAC;QAED,eAAe,CAAC,GAAG,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QACjD,OAAO,IAAI,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE;YAC3C,OAAO,EAAE,eAAe;YACxB,MAAM,EAAE,kBAAkB;SAC3B,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,eAAe,qBAAqB,CAAC","sourcesContent":["/**\n * Shared React Router entry-server handler for agent-native templates.\n *\n * Templates that don't need customization can reduce their entry.server.tsx\n * to a single re-export:\n *\n *   export { handleDocumentRequest as default, streamTimeout } from \"@agent-native/core/server/entry-server\";\n *\n * The superset behavior covers all variants observed across the template fleet:\n *   - HEAD requests: return early with status/headers, no stream body\n *   - .well-known rejection: 404 before rendering (avoids Chrome DevTools probe noise)\n *   - streamTimeout + AbortController: abort render after 5 s, preserving\n *     partial output already streamed to the client\n *   - bot/allReady detection: wait for full render for bots and SPA mode so\n *     crawlers receive complete HTML\n *   - wrapWithAnalytics: applied unconditionally — it is a plain import (never\n *     conditionally undefined), so the `typeof === \"function\"` guards that\n *     appeared in older template copies were dead code and are removed here\n */\n\nimport type { AppLoadContext, EntryContext } from \"react-router\";\nimport { ServerRouter } from \"react-router\";\nimport ReactDOMServer from \"react-dom/server.browser\";\n\nconst { renderToReadableStream } = ReactDOMServer;\n\nimport { isbot } from \"isbot\";\nimport { wrapWithAnalytics } from \"./analytics.js\";\n\nexport const streamTimeout = 5_000;\n\nexport async function handleDocumentRequest(\n  request: Request,\n  responseStatusCode: number,\n  responseHeaders: Headers,\n  routerContext: EntryContext,\n  _loadContext: AppLoadContext,\n): Promise<Response> {\n  // HEAD requests need no body — return immediately.\n  if (request.method.toUpperCase() === \"HEAD\") {\n    return new Response(null, {\n      status: responseStatusCode,\n      headers: responseHeaders,\n    });\n  }\n\n  // Reject Chrome DevTools well-known probes that have no matching route.\n  // Content template introduced this improvement; it becomes the default here.\n  const url = new URL(request.url);\n  if (url.pathname.startsWith(\"/.well-known/\")) {\n    return new Response(null, { status: 404 });\n  }\n\n  const userAgent = request.headers.get(\"user-agent\");\n  // Wait for full render for bots (so crawlers see complete HTML) and in SPA\n  // mode (where the stream must be fully hydrated before sending).\n  const waitForAll = (userAgent && isbot(userAgent)) || routerContext.isSpaMode;\n\n  const abortController = new AbortController();\n  const timeoutId = setTimeout(() => abortController.abort(), streamTimeout);\n\n  try {\n    const body = await renderToReadableStream(\n      <ServerRouter context={routerContext} url={request.url} />,\n      {\n        signal: abortController.signal,\n        onError(error: unknown) {\n          // Only record a 500 when the stream hasn't already been deliberately\n          // aborted by the timeout above.\n          if (!abortController.signal.aborted) {\n            responseStatusCode = 500;\n            console.error(error);\n          }\n        },\n      },\n    );\n\n    if (waitForAll) {\n      await body.allReady;\n    }\n\n    responseHeaders.set(\"Content-Type\", \"text/html\");\n    return new Response(wrapWithAnalytics(body), {\n      headers: responseHeaders,\n      status: responseStatusCode,\n    });\n  } finally {\n    clearTimeout(timeoutId);\n  }\n}\n\nexport default handleDocumentRequest;\n"]}
+{"version":3,"file":"entry-server.js","sourceRoot":"","sources":["../../src/server/entry-server.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared React Router entry-server handler for agent-native templates.\n *\n * Templates can keep the shared behavior while importing `ServerRouter` from\n * their own app-local `react-router` dependency:\n *\n *   import { ServerRouter } from \"react-router\";\n *   import { createDocumentRequestHandler, streamTimeout } from \"@agent-native/core/server/entry-server\";\n *\n *   const handleDocumentRequest = createDocumentRequestHandler(ServerRouter);\n *   export { streamTimeout };\n *   export default handleDocumentRequest;\n *\n * Keeping `ServerRouter` app-local matters in pnpm/published-package installs:\n * React Router's `<Meta />`, `<Links />`, and `<Scripts />` read framework\n * context from the same package singleton that rendered `<ServerRouter>`.\n *\n * The superset behavior covers all variants observed across the template fleet:\n *   - HEAD requests: return early with status/headers, no stream body\n *   - .well-known rejection: 404 before rendering (avoids Chrome DevTools probe noise)\n *   - streamTimeout + AbortController: abort render after 5 s, preserving\n *     partial output already streamed to the client\n *   - bot/allReady detection: wait for full render for bots and SPA mode so\n *     crawlers receive complete HTML\n *   - wrapWithAnalytics: applied unconditionally — it is a plain import (never\n *     conditionally undefined), so the `typeof === \"function\"` guards that\n *     appeared in older template copies were dead code and are removed here\n */\n\nimport type { ReactElement } from \"react\";\nimport type { AppLoadContext, EntryContext } from \"react-router\";\nimport ReactDOMServer from \"react-dom/server.browser\";\n\nconst { renderToReadableStream } = ReactDOMServer;\n\nimport { isbot } from \"isbot\";\nimport { wrapWithAnalytics } from \"./analytics.js\";\n\nexport const streamTimeout = 5_000;\n\ntype ServerRouterComponent = (props: {\n  context: EntryContext;\n  url: string;\n}) => ReactElement;\n\nexport type DocumentRequestHandler = (\n  request: Request,\n  responseStatusCode: number,\n  responseHeaders: Headers,\n  routerContext: EntryContext,\n  loadContext: AppLoadContext,\n) => Promise<Response>;\n\nexport function createDocumentRequestHandler(\n  ServerRouter: ServerRouterComponent,\n): DocumentRequestHandler {\n  return async function handleDocumentRequest(\n    request: Request,\n    responseStatusCode: number,\n    responseHeaders: Headers,\n    routerContext: EntryContext,\n    _loadContext: AppLoadContext,\n  ): Promise<Response> {\n    // HEAD requests need no body — return immediately.\n    if (request.method.toUpperCase() === \"HEAD\") {\n      return new Response(null, {\n        status: responseStatusCode,\n        headers: responseHeaders,\n      });\n    }\n\n    // Reject Chrome DevTools well-known probes that have no matching route.\n    // Content template introduced this improvement; it becomes the default here.\n    const url = new URL(request.url);\n    if (url.pathname.startsWith(\"/.well-known/\")) {\n      return new Response(null, { status: 404 });\n    }\n\n    const userAgent = request.headers.get(\"user-agent\");\n    // Wait for full render for bots (so crawlers see complete HTML) and in SPA\n    // mode (where the stream must be fully hydrated before sending).\n    const waitForAll =\n      (userAgent && isbot(userAgent)) || routerContext.isSpaMode;\n\n    const abortController = new AbortController();\n    const timeoutId = setTimeout(() => abortController.abort(), streamTimeout);\n\n    try {\n      const body = await renderToReadableStream(\n        <ServerRouter context={routerContext} url={request.url} />,\n        {\n          signal: abortController.signal,\n          onError(error: unknown) {\n            // Only record a 500 when the stream hasn't already been deliberately\n            // aborted by the timeout above.\n            if (!abortController.signal.aborted) {\n              responseStatusCode = 500;\n              console.error(error);\n            }\n          },\n        },\n      );\n\n      if (waitForAll) {\n        await body.allReady;\n      }\n\n      responseHeaders.set(\"Content-Type\", \"text/html\");\n      return new Response(wrapWithAnalytics(body), {\n        headers: responseHeaders,\n        status: responseStatusCode,\n      });\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  };\n}\n\nlet defaultDocumentRequestHandler: DocumentRequestHandler | null = null;\n\nasync function getDefaultDocumentRequestHandler(): Promise<DocumentRequestHandler> {\n  if (!defaultDocumentRequestHandler) {\n    const { ServerRouter } = await import(\"react-router\");\n    defaultDocumentRequestHandler = createDocumentRequestHandler(ServerRouter);\n  }\n  return defaultDocumentRequestHandler;\n}\n\n/**\n * Backwards-compatible default for older generated apps.\n *\n * New templates should call `createDocumentRequestHandler(ServerRouter)` from\n * their own `entry.server.tsx` so React Router framework context always comes\n * from the app-local singleton.\n */\nexport async function handleDocumentRequest(\n  request: Request,\n  responseStatusCode: number,\n  responseHeaders: Headers,\n  routerContext: EntryContext,\n  loadContext: AppLoadContext,\n): Promise<Response> {\n  const handler = await getDefaultDocumentRequestHandler();\n  return handler(\n    request,\n    responseStatusCode,\n    responseHeaders,\n    routerContext,\n    loadContext,\n  );\n}\n\nexport default handleDocumentRequest;\n"]}

package/dist/server/onboarding-html.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding-html.d.ts","sourceRoot":"","sources":["../../src/server/onboarding-html.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AA0C/B,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE;QACV,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,qBAA0B,GAAG,MAAM,CAk7D1E;AAED,kDAAkD;AAClD,eAAO,MAAM,eAAe,QAAsB,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CA0G7C"}
+{"version":3,"file":"onboarding-html.d.ts","sourceRoot":"","sources":["../../src/server/onboarding-html.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AA2C/B,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE;QACV,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,qBAA0B,GAAG,MAAM,CAo7D1E;AAED,kDAAkD;AAClD,eAAO,MAAM,eAAe,QAAsB,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CA0G7C"}

package/dist/server/onboarding-html.js

@@ -12,7 +12,7 @@ import { getWorkspaceGatewayReturnOrigin } from "./oauth-return-url.js";
 import { identitySsoLoginButtonHtml } from "./identity-sso-store.js";
 import { resolveBuiltInAuthMarketing, } from "./auth-marketing.js";
 import { AUTH_REDIRECT_QUERY_PARAM } from "../shared/auth-redirect-url.js";
-import { AGENT_NATIVE_SOCIAL_IMAGE_ALT, AGENT_NATIVE_SOCIAL_IMAGE_HEIGHT, AGENT_NATIVE_SOCIAL_IMAGE_PATH, AGENT_NATIVE_SOCIAL_IMAGE_TYPE, AGENT_NATIVE_SOCIAL_IMAGE_WIDTH, } from "../shared/social-meta.js";
+import { AGENT_NATIVE_SOCIAL_IMAGE_ALT, AGENT_NATIVE_SOCIAL_IMAGE_HEIGHT, AGENT_NATIVE_SOCIAL_IMAGE_PATH, AGENT_NATIVE_SOCIAL_IMAGE_TYPE, AGENT_NATIVE_SOCIAL_IMAGE_WIDTH, withAgentNativeSocialImageCacheBuster, } from "../shared/social-meta.js";
 import { normalizeAppBasePath } from "./app-base-path.js";
 function hasGoogleOAuth() {
     return !!(process.env.GOOGLE_CLIENT_ID && process.env.GOOGLE_CLIENT_SECRET);
@@ -62,9 +62,9 @@ export function getOnboardingHtml(opts = {}) {
     const hasMarketing = !!marketing;
     const runLocalCommand = marketing?.runLocalCommand?.trim();
     const brandMarkSrc = withAppBasePath("/agent-native-icon-dark.svg");
-    const socialImageUrl = opts.requestOrigin
+    const socialImageUrl = withAgentNativeSocialImageCacheBuster(opts.requestOrigin
         ? `${opts.requestOrigin}${withAppBasePath(AGENT_NATIVE_SOCIAL_IMAGE_PATH)}`
-        : withAppBasePath(AGENT_NATIVE_SOCIAL_IMAGE_PATH);
+        : withAppBasePath(AGENT_NATIVE_SOCIAL_IMAGE_PATH));
     const esc = (s) => s
         .replace(/&/g, "&")
         .replace(/</g, "&lt;")