@agent-native/core 0.32.1 → 0.32.17

package/dist/server/self-dispatch.js

@@ -0,0 +1,113 @@
+/**
+ * Shared self-dispatch helper for the framework's serverless background-work
+ * pattern: enqueue a unit of work to SQL, then fire a fresh HTTP POST back to
+ * this same deployment so the work runs in its own function invocation (with
+ * its own full timeout budget) instead of riding on the request that created
+ * it.
+ *
+ * This is the single mechanism that makes background work portable across every
+ * host Nitro deploys to:
+ *   - Netlify Lambda / Vercel Functions / AWS Lambda — the dispatched request
+ *     hits a fresh function with its own budget; no `waitUntil` needed.
+ *   - Cloudflare Workers — same (and `waitUntil` still works as a belt-and-
+ *     suspenders fallback where the in-process path is used).
+ *   - Self-hosted / long-lived Node — the dispatch comes back as another
+ *     request to the same process; each handler still runs to completion.
+ *
+ * Originally inlined in both `a2a/handlers.ts` (`resolveSelfBaseUrl` +
+ * `fireProcessTaskDispatch`) and `integrations/webhook-handler.ts`
+ * (`resolveBaseUrl` + the dispatch in `enqueueAndDispatch`). Extracted here so
+ * A2A, integration webhooks, and Agent Teams sub-agents share one tested
+ * implementation.
+ */
+import { withConfiguredAppBasePath } from "./app-base-path.js";
+import { isLocalDatabase } from "../db/client.js";
+import { signInternalToken } from "../integrations/internal-token.js";
+/**
+ * On serverless, returning from the dispatching handler before the outbound
+ * TCP handshake starts can freeze the function with the dispatch request stuck
+ * in the queue. Racing the fetch against a short timer gives the request a
+ * chance to leave the box at the cost of a little added latency on the
+ * dispatching call. Mirrors the 250ms used by the A2A/webhook paths.
+ */
+export const DEFAULT_DISPATCH_SETTLE_MS = 250;
+function readHeader(event, name) {
+    try {
+        const headers = event?.node?.req?.headers ?? event?.headers;
+        if (!headers)
+            return undefined;
+        if (typeof headers.get === "function") {
+            return headers.get(name) ?? undefined;
+        }
+        const map = headers;
+        return map[name] ?? map[String(name).toLowerCase()];
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Resolve the base URL to fire a self-dispatch request at. Prefers explicit env
+ * vars (most reliable on serverless, where inbound host headers can be the
+ * platform's internal hostname), falling back to the inbound request headers
+ * and finally localhost in dev.
+ *
+ * Throws in production / shared deployments when no env var is set — a silent
+ * fallback to a bad host there would drop background work invisibly.
+ */
+export function resolveSelfDispatchBaseUrl(event) {
+    const fromEnv = process.env.APP_URL ||
+        process.env.URL ||
+        process.env.DEPLOY_URL ||
+        process.env.BETTER_AUTH_URL;
+    if (fromEnv)
+        return withConfiguredAppBasePath(String(fromEnv));
+    if (process.env.NODE_ENV === "production" || !isLocalDatabase()) {
+        throw new Error("Self-dispatch requires APP_URL, URL, DEPLOY_URL, or BETTER_AUTH_URL in " +
+            "production/shared deployments so background work can reach this " +
+            "deployment's own URL.");
+    }
+    const proto = readHeader(event, "x-forwarded-proto") || "http";
+    const host = readHeader(event, "host") || `localhost:${process.env.PORT || 3000}`;
+    return withConfiguredAppBasePath(`${proto}://${host}`);
+}
+/**
+ * Fire a fresh, HMAC-signed POST to a processor route on this same deployment.
+ * Fire-and-forget: the dispatch is NOT awaited to completion (the processed run
+ * may take minutes); it is only raced against a short settle timer so the
+ * request reliably leaves a serverless box before it freezes.
+ *
+ * When `A2A_SECRET` is unset (local dev), the request is sent unsigned — the
+ * processor accepts unsigned dispatches in dev and relies on the SQL atomic
+ * claim for double-processing protection, mirroring the A2A/webhook flow.
+ */
+export async function fireInternalDispatch(options) {
+    const baseUrl = options.baseUrl ?? resolveSelfDispatchBaseUrl(options.event);
+    const url = `${baseUrl}${options.path}`;
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    try {
+        headers["Authorization"] = `Bearer ${signInternalToken(options.taskId)}`;
+    }
+    catch (err) {
+        // Distinguish the documented "no A2A_SECRET in dev" path from a real
+        // signing failure, so a malformed secret doesn't fail invisibly.
+        if (err instanceof Error && !/A2A_SECRET/i.test(err.message)) {
+            console.error(`[self-dispatch] signInternalToken failed unexpectedly for ${options.taskId}:`, err);
+        }
+    }
+    const dispatchPromise = fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ taskId: options.taskId, ...(options.body ?? {}) }),
+    }).catch((err) => {
+        console.error(`[self-dispatch] dispatch to ${options.path} failed:`, err);
+    });
+    const settleMs = options.settleMs ?? DEFAULT_DISPATCH_SETTLE_MS;
+    await Promise.race([
+        dispatchPromise,
+        new Promise((resolve) => setTimeout(resolve, settleMs)),
+    ]);
+}
+//# sourceMappingURL=self-dispatch.js.map

package/dist/server/self-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-dispatch.js","sourceRoot":"","sources":["../../src/server/self-dispatch.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared self-dispatch helper for the framework's serverless background-work\n * pattern: enqueue a unit of work to SQL, then fire a fresh HTTP POST back to\n * this same deployment so the work runs in its own function invocation (with\n * its own full timeout budget) instead of riding on the request that created\n * it.\n *\n * This is the single mechanism that makes background work portable across every\n * host Nitro deploys to:\n *   - Netlify Lambda / Vercel Functions / AWS Lambda — the dispatched request\n *     hits a fresh function with its own budget; no `waitUntil` needed.\n *   - Cloudflare Workers — same (and `waitUntil` still works as a belt-and-\n *     suspenders fallback where the in-process path is used).\n *   - Self-hosted / long-lived Node — the dispatch comes back as another\n *     request to the same process; each handler still runs to completion.\n *\n * Originally inlined in both `a2a/handlers.ts` (`resolveSelfBaseUrl` +\n * `fireProcessTaskDispatch`) and `integrations/webhook-handler.ts`\n * (`resolveBaseUrl` + the dispatch in `enqueueAndDispatch`). Extracted here so\n * A2A, integration webhooks, and Agent Teams sub-agents share one tested\n * implementation.\n */\nimport { withConfiguredAppBasePath } from \"./app-base-path.js\";\nimport { isLocalDatabase } from \"../db/client.js\";\nimport { signInternalToken } from \"../integrations/internal-token.js\";\n\n/**\n * On serverless, returning from the dispatching handler before the outbound\n * TCP handshake starts can freeze the function with the dispatch request stuck\n * in the queue. Racing the fetch against a short timer gives the request a\n * chance to leave the box at the cost of a little added latency on the\n * dispatching call. Mirrors the 250ms used by the A2A/webhook paths.\n */\nexport const DEFAULT_DISPATCH_SETTLE_MS = 250;\n\nfunction readHeader(event: any, name: string): string | undefined {\n  try {\n    const headers = event?.node?.req?.headers ?? event?.headers;\n    if (!headers) return undefined;\n    if (typeof headers.get === \"function\") {\n      return headers.get(name) ?? undefined;\n    }\n    const map = headers as Record<string, string | undefined>;\n    return map[name] ?? map[String(name).toLowerCase()];\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Resolve the base URL to fire a self-dispatch request at. Prefers explicit env\n * vars (most reliable on serverless, where inbound host headers can be the\n * platform's internal hostname), falling back to the inbound request headers\n * and finally localhost in dev.\n *\n * Throws in production / shared deployments when no env var is set — a silent\n * fallback to a bad host there would drop background work invisibly.\n */\nexport function resolveSelfDispatchBaseUrl(event?: any): string {\n  const fromEnv =\n    process.env.APP_URL ||\n    process.env.URL ||\n    process.env.DEPLOY_URL ||\n    process.env.BETTER_AUTH_URL;\n  if (fromEnv) return withConfiguredAppBasePath(String(fromEnv));\n\n  if (process.env.NODE_ENV === \"production\" || !isLocalDatabase()) {\n    throw new Error(\n      \"Self-dispatch requires APP_URL, URL, DEPLOY_URL, or BETTER_AUTH_URL in \" +\n        \"production/shared deployments so background work can reach this \" +\n        \"deployment's own URL.\",\n    );\n  }\n\n  const proto = readHeader(event, \"x-forwarded-proto\") || \"http\";\n  const host =\n    readHeader(event, \"host\") || `localhost:${process.env.PORT || 3000}`;\n  return withConfiguredAppBasePath(`${proto}://${host}`);\n}\n\nexport interface FireInternalDispatchOptions {\n  /** Base URL of this deployment. Defaults to `resolveSelfDispatchBaseUrl(event)`. */\n  baseUrl?: string;\n  /** Request event used to derive the base URL when `baseUrl` is omitted. */\n  event?: any;\n  /** Framework route path to POST to (e.g. \"/_agent-native/agent-teams/_process-run\"). */\n  path: string;\n  /** Task/run id the processor will claim. Used to sign the HMAC token and as the default body. */\n  taskId: string;\n  /** Extra fields merged into the JSON body alongside `{ taskId }`. */\n  body?: Record<string, unknown>;\n  /** Max ms to wait for the outbound request to leave the box. Default 250ms. */\n  settleMs?: number;\n}\n\n/**\n * Fire a fresh, HMAC-signed POST to a processor route on this same deployment.\n * Fire-and-forget: the dispatch is NOT awaited to completion (the processed run\n * may take minutes); it is only raced against a short settle timer so the\n * request reliably leaves a serverless box before it freezes.\n *\n * When `A2A_SECRET` is unset (local dev), the request is sent unsigned — the\n * processor accepts unsigned dispatches in dev and relies on the SQL atomic\n * claim for double-processing protection, mirroring the A2A/webhook flow.\n */\nexport async function fireInternalDispatch(\n  options: FireInternalDispatchOptions,\n): Promise<void> {\n  const baseUrl = options.baseUrl ?? resolveSelfDispatchBaseUrl(options.event);\n  const url = `${baseUrl}${options.path}`;\n  const headers: Record<string, string> = {\n    \"Content-Type\": \"application/json\",\n  };\n  try {\n    headers[\"Authorization\"] = `Bearer ${signInternalToken(options.taskId)}`;\n  } catch (err) {\n    // Distinguish the documented \"no A2A_SECRET in dev\" path from a real\n    // signing failure, so a malformed secret doesn't fail invisibly.\n    if (err instanceof Error && !/A2A_SECRET/i.test(err.message)) {\n      console.error(\n        `[self-dispatch] signInternalToken failed unexpectedly for ${options.taskId}:`,\n        err,\n      );\n    }\n  }\n\n  const dispatchPromise = fetch(url, {\n    method: \"POST\",\n    headers,\n    body: JSON.stringify({ taskId: options.taskId, ...(options.body ?? {}) }),\n  }).catch((err) => {\n    console.error(`[self-dispatch] dispatch to ${options.path} failed:`, err);\n  });\n\n  const settleMs = options.settleMs ?? DEFAULT_DISPATCH_SETTLE_MS;\n  await Promise.race([\n    dispatchPromise,\n    new Promise<void>((resolve) => setTimeout(resolve, settleMs)),\n  ]);\n}\n"]}

package/dist/server/social-og-image.d.ts

@@ -0,0 +1,14 @@
+export interface AgentNativeOgImageInput {
+    appName?: string | null;
+    title?: string | null;
+    accentText?: string | null;
+}
+export declare const AGENT_NATIVE_OG_IMAGE_WIDTH = 1200;
+export declare const AGENT_NATIVE_OG_IMAGE_HEIGHT = 630;
+export declare const AGENT_NATIVE_OG_IMAGE_CACHE_CONTROL = "public, max-age=60, stale-while-revalidate=604800, stale-if-error=3600";
+export declare const AGENT_NATIVE_OG_IMAGE_NETLIFY_CACHE_CONTROL = "public, durable, max-age=60, stale-while-revalidate=604800, stale-if-error=3600";
+export declare function renderAgentNativeOgImageSvg(input?: AgentNativeOgImageInput): string;
+export declare function renderAgentNativeOgImagePng(input?: AgentNativeOgImageInput): Promise<Uint8Array>;
+export declare function agentNativeOgImageResponseHeaders(byteLength?: number): Record<string, string>;
+export declare function createAgentNativeOgImageHandler(options?: AgentNativeOgImageInput): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<Response>>;
+//# sourceMappingURL=social-og-image.d.ts.map

package/dist/server/social-og-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"social-og-image.d.ts","sourceRoot":"","sources":["../../src/server/social-og-image.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAChD,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAChD,eAAO,MAAM,mCAAmC,2EAC0B,CAAC;AAC3E,eAAO,MAAM,2CAA2C,oFAC2B,CAAC;AAmOpF,wBAAgB,2BAA2B,CACzC,KAAK,GAAE,uBAA4B,GAClC,MAAM,CAsCR;AAED,wBAAsB,2BAA2B,CAC/C,KAAK,GAAE,uBAA4B,GAClC,OAAO,CAAC,UAAU,CAAC,CAWrB;AAED,wBAAgB,iCAAiC,CAC/C,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYxB;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,uBAA4B,2FAuBtC"}

package/dist/server/social-og-image.js

@@ -0,0 +1,251 @@
+import { defineEventHandler, getHeader, getMethod, getQuery, getRequestURL, } from "h3";
+import { resolveBuiltInAuthMarketing } from "./auth-marketing.js";
+import { getAppName } from "./app-name.js";
+export const AGENT_NATIVE_OG_IMAGE_WIDTH = 1200;
+export const AGENT_NATIVE_OG_IMAGE_HEIGHT = 630;
+export const AGENT_NATIVE_OG_IMAGE_CACHE_CONTROL = "public, max-age=60, stale-while-revalidate=604800, stale-if-error=3600";
+export const AGENT_NATIVE_OG_IMAGE_NETLIFY_CACHE_CONTROL = "public, durable, max-age=60, stale-while-revalidate=604800, stale-if-error=3600";
+const WIDTH = AGENT_NATIVE_OG_IMAGE_WIDTH;
+const HEIGHT = AGENT_NATIVE_OG_IMAGE_HEIGHT;
+const BRAND_BLUE = "#00B5FF";
+const BRAND_MINT = "#48FFE4";
+const BG = "#000000";
+const FG = "#f5f5f5";
+const FONT_FAMILY = "Inter, Liberation Sans, Arial, Helvetica, system-ui, sans-serif";
+const DEFAULT_ACCENT_TEXT = "100% free and open source";
+const LOGO_MARK = `
+  <path d="M24.5537 65.7695H0L15.0859 39.4619L37.708 0L60.4912 39.4619H39.6396L24.5537 65.7695Z" fill="white"/>
+  <path d="M89.446 0H114L76.2921 65.7704H51.7383L89.446 0Z" fill="url(#brand)"/>
+`;
+function escapeSvg(value) {
+    return value
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+function cleanText(value) {
+    return String(value ?? "")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function titleCase(value) {
+    return value
+        .split(/[\s._-]+/)
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1).toLowerCase())
+        .join(" ");
+}
+function titleFromAppName(appName) {
+    if (appName)
+        return appName;
+    const basePath = process.env.VITE_APP_BASE_PATH || process.env.APP_BASE_PATH || "";
+    const slug = basePath.split("/").filter(Boolean)[0] || "";
+    return titleCase(slug) || "Agent-Native";
+}
+function estimateTextWidth(value, fontSize) {
+    let units = 0;
+    for (const char of value) {
+        if (char === " ") {
+            units += 0.28;
+        }
+        else if (/[MW@#%&]/.test(char)) {
+            units += 0.86;
+        }
+        else if (/[A-Z]/.test(char)) {
+            units += 0.64;
+        }
+        else if (/[ilI.,:;|!']/u.test(char)) {
+            units += 0.26;
+        }
+        else if (/[0-9]/.test(char)) {
+            units += 0.56;
+        }
+        else {
+            units += 0.54;
+        }
+    }
+    return units * fontSize;
+}
+function trimTextToWidth(value, fontSize, maxWidth) {
+    const ellipsis = "...";
+    let trimmed = value.trim();
+    while (trimmed.length > 0 &&
+        estimateTextWidth(`${trimmed}${ellipsis}`, fontSize) > maxWidth) {
+        trimmed = trimmed.slice(0, -1).trimEnd();
+    }
+    return trimmed ? `${trimmed}${ellipsis}` : ellipsis;
+}
+function wrapTextToWidth(value, fontSize, maxWidth, maxLines) {
+    const words = value.split(/\s+/).filter(Boolean);
+    const lines = [];
+    let current = "";
+    let truncated = false;
+    for (const word of words) {
+        const next = current ? `${current} ${word}` : word;
+        if (estimateTextWidth(next, fontSize) <= maxWidth) {
+            current = next;
+            continue;
+        }
+        if (!current) {
+            lines.push(trimTextToWidth(word, fontSize, maxWidth));
+            truncated = true;
+            current = "";
+        }
+        else {
+            lines.push(current);
+            current = word;
+        }
+        if (lines.length === maxLines) {
+            truncated = true;
+            break;
+        }
+    }
+    if (current && lines.length < maxLines)
+        lines.push(current);
+    const usedWordCount = lines.join(" ").split(/\s+/).filter(Boolean).length;
+    if (usedWordCount < words.length && lines.length > 0) {
+        lines[lines.length - 1] = trimTextToWidth(lines[lines.length - 1], fontSize, maxWidth);
+        truncated = true;
+    }
+    return {
+        lines: lines.length ? lines : [trimTextToWidth(value, fontSize, maxWidth)],
+        truncated,
+    };
+}
+function getTitleLayout(title) {
+    const maxTitleWidth = 900;
+    if (estimateTextWidth(title, 88) <= maxTitleWidth) {
+        return {
+            lines: [title],
+            fontSize: 88,
+            lineHeight: 96,
+        };
+    }
+    for (const fontSize of [76, 70, 64, 58, 52]) {
+        const wrapped = wrapTextToWidth(title, fontSize, maxTitleWidth, 2);
+        if (!wrapped.truncated) {
+            const lineHeight = Math.round(fontSize * 1.1);
+            return {
+                lines: wrapped.lines,
+                fontSize,
+                lineHeight,
+            };
+        }
+    }
+    const fallbackFontSize = 52;
+    const wrapped = wrapTextToWidth(title, fallbackFontSize, maxTitleWidth, 2);
+    return {
+        lines: wrapped.lines,
+        fontSize: fallbackFontSize,
+        lineHeight: 60,
+    };
+}
+function textBlock({ lines, x, y, fontSize, lineHeight, weight, fill, anchor = "start", }) {
+    return `<text x="${x}" y="${y}" text-anchor="${anchor}" font-family="${FONT_FAMILY}" font-size="${fontSize}" font-weight="${weight}" fill="${fill}">${lines
+        .map((line, index) => `<tspan x="${x}" dy="${index === 0 ? 0 : lineHeight}">${escapeSvg(line)}</tspan>`)
+        .join("")}</text>`;
+}
+function resolveDefaultAppName(event) {
+    const requestHost = event
+        ? (getHeader(event, "x-forwarded-host") ?? getHeader(event, "host"))
+        : undefined;
+    const requestPath = event ? getRequestURL(event).pathname : undefined;
+    return (getAppName() ??
+        resolveBuiltInAuthMarketing({ requestHost, requestPath })?.appName ??
+        "Agent-Native");
+}
+function queryStringValue(value, maxLength) {
+    if (typeof value !== "string")
+        return undefined;
+    const clean = cleanText(value).slice(0, maxLength);
+    return clean || undefined;
+}
+function pngBody(bytes) {
+    const body = new ArrayBuffer(bytes.byteLength);
+    new Uint8Array(body).set(bytes);
+    return body;
+}
+export function renderAgentNativeOgImageSvg(input = {}) {
+    const appName = cleanText(input.appName) || resolveDefaultAppName();
+    const title = cleanText(input.title) || titleFromAppName(appName);
+    const accentText = cleanText(input.accentText) || DEFAULT_ACCENT_TEXT;
+    const titleLayout = getTitleLayout(title);
+    const titleY = titleLayout.lines.length > 1 ? 288 : 330;
+    const accentY = titleY + titleLayout.lineHeight * (titleLayout.lines.length - 1) + 70;
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${WIDTH}" height="${HEIGHT}" viewBox="0 0 ${WIDTH} ${HEIGHT}">
+  <title>${escapeSvg(title)} - Agent-Native preview</title>
+  <defs>
+    <linearGradient id="brand" x1="101.702" y1="67.4791" x2="113.672" y2="-37.4275" gradientUnits="userSpaceOnUse">
+      <stop stop-color="${BRAND_BLUE}"/>
+      <stop offset="1" stop-color="${BRAND_MINT}"/>
+    </linearGradient>
+    <pattern id="grid" width="48" height="48" patternUnits="userSpaceOnUse">
+      <path d="M 48 0 L 0 0 0 48" fill="none" stroke="#ffffff" stroke-opacity="0.07" stroke-width="1"/>
+    </pattern>
+  </defs>
+  <rect width="${WIDTH}" height="${HEIGHT}" fill="${BG}"/>
+  <rect width="${WIDTH}" height="${HEIGHT}" fill="url(#grid)"/>
+  <g transform="translate(80 116) scale(0.94)">
+    ${LOGO_MARK}
+  </g>
+  <g>
+    ${textBlock({
+        lines: titleLayout.lines,
+        x: 80,
+        y: titleY,
+        fontSize: titleLayout.fontSize,
+        lineHeight: titleLayout.lineHeight,
+        weight: 850,
+        fill: FG,
+    })}
+    <text x="84" y="${accentY}" font-family="${FONT_FAMILY}" font-size="34" font-weight="800" fill="${BRAND_BLUE}">${escapeSvg(accentText)}</text>
+  </g>
+</svg>`;
+}
+export async function renderAgentNativeOgImagePng(input = {}) {
+    const { Resvg } = await import(/* @vite-ignore */ "@resvg/resvg-js");
+    const image = new Resvg(renderAgentNativeOgImageSvg(input), {
+        fitTo: { mode: "width", value: WIDTH },
+        font: {
+            loadSystemFonts: true,
+            defaultFontFamily: "Arial",
+            sansSerifFamily: "Arial",
+        },
+    }).render();
+    return image.asPng();
+}
+export function agentNativeOgImageResponseHeaders(byteLength) {
+    const headers = {
+        "Content-Type": "image/png",
+        "Cache-Control": AGENT_NATIVE_OG_IMAGE_CACHE_CONTROL,
+        "CDN-Cache-Control": AGENT_NATIVE_OG_IMAGE_CACHE_CONTROL,
+        "Netlify-CDN-Cache-Control": AGENT_NATIVE_OG_IMAGE_NETLIFY_CACHE_CONTROL,
+        "Cross-Origin-Resource-Policy": "cross-origin",
+    };
+    if (typeof byteLength === "number") {
+        headers["Content-Length"] = String(byteLength);
+    }
+    return headers;
+}
+export function createAgentNativeOgImageHandler(options = {}) {
+    return defineEventHandler(async (event) => {
+        if (getMethod(event) === "HEAD") {
+            return new Response(null, {
+                headers: agentNativeOgImageResponseHeaders(),
+            });
+        }
+        const query = getQuery(event);
+        const appName = cleanText(options.appName) || resolveDefaultAppName(event);
+        const png = await renderAgentNativeOgImagePng({
+            ...options,
+            appName,
+            title: cleanText(options.title) || queryStringValue(query.title, 140),
+            accentText: cleanText(options.accentText) || queryStringValue(query.accentText, 80),
+        });
+        return new Response(pngBody(png), {
+            headers: agentNativeOgImageResponseHeaders(png.byteLength),
+        });
+    });
+}
+//# sourceMappingURL=social-og-image.js.map

package/dist/server/social-og-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"social-og-image.js","sourceRoot":"","sources":["../../src/server/social-og-image.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  defineEventHandler,\n  getHeader,\n  getMethod,\n  getQuery,\n  getRequestURL,\n  type H3Event,\n} from \"h3\";\nimport { resolveBuiltInAuthMarketing } from \"./auth-marketing.js\";\nimport { getAppName } from \"./app-name.js\";\n\nexport interface AgentNativeOgImageInput {\n  appName?: string | null;\n  title?: string | null;\n  accentText?: string | null;\n}\n\nexport const AGENT_NATIVE_OG_IMAGE_WIDTH = 1200;\nexport const AGENT_NATIVE_OG_IMAGE_HEIGHT = 630;\nexport const AGENT_NATIVE_OG_IMAGE_CACHE_CONTROL =\n  \"public, max-age=60, stale-while-revalidate=604800, stale-if-error=3600\";\nexport const AGENT_NATIVE_OG_IMAGE_NETLIFY_CACHE_CONTROL =\n  \"public, durable, max-age=60, stale-while-revalidate=604800, stale-if-error=3600\";\n\nconst WIDTH = AGENT_NATIVE_OG_IMAGE_WIDTH;\nconst HEIGHT = AGENT_NATIVE_OG_IMAGE_HEIGHT;\nconst BRAND_BLUE = \"#00B5FF\";\nconst BRAND_MINT = \"#48FFE4\";\nconst BG = \"#000000\";\nconst FG = \"#f5f5f5\";\nconst FONT_FAMILY =\n  \"Inter, Liberation Sans, Arial, Helvetica, system-ui, sans-serif\";\nconst DEFAULT_ACCENT_TEXT = \"100% free and open source\";\n\nconst LOGO_MARK = `\n  <path d=\"M24.5537 65.7695H0L15.0859 39.4619L37.708 0L60.4912 39.4619H39.6396L24.5537 65.7695Z\" fill=\"white\"/>\n  <path d=\"M89.446 0H114L76.2921 65.7704H51.7383L89.446 0Z\" fill=\"url(#brand)\"/>\n`;\n\nfunction escapeSvg(value: string): string {\n  return value\n    .replace(/&/g, \"&amp;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\")\n    .replace(/\"/g, \"&quot;\");\n}\n\nfunction cleanText(value: string | null | undefined): string {\n  return String(value ?? \"\")\n    .replace(/\\s+/g, \" \")\n    .trim();\n}\n\nfunction titleCase(value: string): string {\n  return value\n    .split(/[\\s._-]+/)\n    .filter(Boolean)\n    .map((part) => part.charAt(0).toUpperCase() + part.slice(1).toLowerCase())\n    .join(\" \");\n}\n\nfunction titleFromAppName(appName: string): string {\n  if (appName) return appName;\n  const basePath =\n    process.env.VITE_APP_BASE_PATH || process.env.APP_BASE_PATH || \"\";\n  const slug = basePath.split(\"/\").filter(Boolean)[0] || \"\";\n  return titleCase(slug) || \"Agent-Native\";\n}\n\ninterface WrappedText {\n  lines: string[];\n  truncated: boolean;\n}\n\ninterface TitleLayout {\n  lines: string[];\n  fontSize: number;\n  lineHeight: number;\n}\n\nfunction estimateTextWidth(value: string, fontSize: number): number {\n  let units = 0;\n  for (const char of value) {\n    if (char === \" \") {\n      units += 0.28;\n    } else if (/[MW@#%&]/.test(char)) {\n      units += 0.86;\n    } else if (/[A-Z]/.test(char)) {\n      units += 0.64;\n    } else if (/[ilI.,:;|!']/u.test(char)) {\n      units += 0.26;\n    } else if (/[0-9]/.test(char)) {\n      units += 0.56;\n    } else {\n      units += 0.54;\n    }\n  }\n  return units * fontSize;\n}\n\nfunction trimTextToWidth(\n  value: string,\n  fontSize: number,\n  maxWidth: number,\n): string {\n  const ellipsis = \"...\";\n  let trimmed = value.trim();\n  while (\n    trimmed.length > 0 &&\n    estimateTextWidth(`${trimmed}${ellipsis}`, fontSize) > maxWidth\n  ) {\n    trimmed = trimmed.slice(0, -1).trimEnd();\n  }\n  return trimmed ? `${trimmed}${ellipsis}` : ellipsis;\n}\n\nfunction wrapTextToWidth(\n  value: string,\n  fontSize: number,\n  maxWidth: number,\n  maxLines: number,\n): WrappedText {\n  const words = value.split(/\\s+/).filter(Boolean);\n  const lines: string[] = [];\n  let current = \"\";\n  let truncated = false;\n\n  for (const word of words) {\n    const next = current ? `${current} ${word}` : word;\n    if (estimateTextWidth(next, fontSize) <= maxWidth) {\n      current = next;\n      continue;\n    }\n    if (!current) {\n      lines.push(trimTextToWidth(word, fontSize, maxWidth));\n      truncated = true;\n      current = \"\";\n    } else {\n      lines.push(current);\n      current = word;\n    }\n    if (lines.length === maxLines) {\n      truncated = true;\n      break;\n    }\n  }\n  if (current && lines.length < maxLines) lines.push(current);\n\n  const usedWordCount = lines.join(\" \").split(/\\s+/).filter(Boolean).length;\n  if (usedWordCount < words.length && lines.length > 0) {\n    lines[lines.length - 1] = trimTextToWidth(\n      lines[lines.length - 1],\n      fontSize,\n      maxWidth,\n    );\n    truncated = true;\n  }\n\n  return {\n    lines: lines.length ? lines : [trimTextToWidth(value, fontSize, maxWidth)],\n    truncated,\n  };\n}\n\nfunction getTitleLayout(title: string): TitleLayout {\n  const maxTitleWidth = 900;\n  if (estimateTextWidth(title, 88) <= maxTitleWidth) {\n    return {\n      lines: [title],\n      fontSize: 88,\n      lineHeight: 96,\n    };\n  }\n\n  for (const fontSize of [76, 70, 64, 58, 52]) {\n    const wrapped = wrapTextToWidth(title, fontSize, maxTitleWidth, 2);\n    if (!wrapped.truncated) {\n      const lineHeight = Math.round(fontSize * 1.1);\n      return {\n        lines: wrapped.lines,\n        fontSize,\n        lineHeight,\n      };\n    }\n  }\n\n  const fallbackFontSize = 52;\n  const wrapped = wrapTextToWidth(title, fallbackFontSize, maxTitleWidth, 2);\n  return {\n    lines: wrapped.lines,\n    fontSize: fallbackFontSize,\n    lineHeight: 60,\n  };\n}\n\nfunction textBlock({\n  lines,\n  x,\n  y,\n  fontSize,\n  lineHeight,\n  weight,\n  fill,\n  anchor = \"start\",\n}: {\n  lines: string[];\n  x: number;\n  y: number;\n  fontSize: number;\n  lineHeight: number;\n  weight: number;\n  fill: string;\n  anchor?: \"start\" | \"middle\";\n}): string {\n  return `<text x=\"${x}\" y=\"${y}\" text-anchor=\"${anchor}\" font-family=\"${FONT_FAMILY}\" font-size=\"${fontSize}\" font-weight=\"${weight}\" fill=\"${fill}\">${lines\n    .map(\n      (line, index) =>\n        `<tspan x=\"${x}\" dy=\"${index === 0 ? 0 : lineHeight}\">${escapeSvg(line)}</tspan>`,\n    )\n    .join(\"\")}</text>`;\n}\n\nfunction resolveDefaultAppName(event?: H3Event): string {\n  const requestHost = event\n    ? (getHeader(event, \"x-forwarded-host\") ?? getHeader(event, \"host\"))\n    : undefined;\n  const requestPath = event ? getRequestURL(event).pathname : undefined;\n  return (\n    getAppName() ??\n    resolveBuiltInAuthMarketing({ requestHost, requestPath })?.appName ??\n    \"Agent-Native\"\n  );\n}\n\nfunction queryStringValue(\n  value: unknown,\n  maxLength: number,\n): string | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const clean = cleanText(value).slice(0, maxLength);\n  return clean || undefined;\n}\n\nfunction pngBody(bytes: Uint8Array): ArrayBuffer {\n  const body = new ArrayBuffer(bytes.byteLength);\n  new Uint8Array(body).set(bytes);\n  return body;\n}\n\nexport function renderAgentNativeOgImageSvg(\n  input: AgentNativeOgImageInput = {},\n): string {\n  const appName = cleanText(input.appName) || resolveDefaultAppName();\n  const title = cleanText(input.title) || titleFromAppName(appName);\n  const accentText = cleanText(input.accentText) || DEFAULT_ACCENT_TEXT;\n  const titleLayout = getTitleLayout(title);\n  const titleY = titleLayout.lines.length > 1 ? 288 : 330;\n  const accentY =\n    titleY + titleLayout.lineHeight * (titleLayout.lines.length - 1) + 70;\n\n  return `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"${WIDTH}\" height=\"${HEIGHT}\" viewBox=\"0 0 ${WIDTH} ${HEIGHT}\">\n  <title>${escapeSvg(title)} - Agent-Native preview</title>\n  <defs>\n    <linearGradient id=\"brand\" x1=\"101.702\" y1=\"67.4791\" x2=\"113.672\" y2=\"-37.4275\" gradientUnits=\"userSpaceOnUse\">\n      <stop stop-color=\"${BRAND_BLUE}\"/>\n      <stop offset=\"1\" stop-color=\"${BRAND_MINT}\"/>\n    </linearGradient>\n    <pattern id=\"grid\" width=\"48\" height=\"48\" patternUnits=\"userSpaceOnUse\">\n      <path d=\"M 48 0 L 0 0 0 48\" fill=\"none\" stroke=\"#ffffff\" stroke-opacity=\"0.07\" stroke-width=\"1\"/>\n    </pattern>\n  </defs>\n  <rect width=\"${WIDTH}\" height=\"${HEIGHT}\" fill=\"${BG}\"/>\n  <rect width=\"${WIDTH}\" height=\"${HEIGHT}\" fill=\"url(#grid)\"/>\n  <g transform=\"translate(80 116) scale(0.94)\">\n    ${LOGO_MARK}\n  </g>\n  <g>\n    ${textBlock({\n      lines: titleLayout.lines,\n      x: 80,\n      y: titleY,\n      fontSize: titleLayout.fontSize,\n      lineHeight: titleLayout.lineHeight,\n      weight: 850,\n      fill: FG,\n    })}\n    <text x=\"84\" y=\"${accentY}\" font-family=\"${FONT_FAMILY}\" font-size=\"34\" font-weight=\"800\" fill=\"${BRAND_BLUE}\">${escapeSvg(accentText)}</text>\n  </g>\n</svg>`;\n}\n\nexport async function renderAgentNativeOgImagePng(\n  input: AgentNativeOgImageInput = {},\n): Promise<Uint8Array> {\n  const { Resvg } = await import(/* @vite-ignore */ \"@resvg/resvg-js\");\n  const image = new Resvg(renderAgentNativeOgImageSvg(input), {\n    fitTo: { mode: \"width\", value: WIDTH },\n    font: {\n      loadSystemFonts: true,\n      defaultFontFamily: \"Arial\",\n      sansSerifFamily: \"Arial\",\n    },\n  }).render();\n  return image.asPng();\n}\n\nexport function agentNativeOgImageResponseHeaders(\n  byteLength?: number,\n): Record<string, string> {\n  const headers: Record<string, string> = {\n    \"Content-Type\": \"image/png\",\n    \"Cache-Control\": AGENT_NATIVE_OG_IMAGE_CACHE_CONTROL,\n    \"CDN-Cache-Control\": AGENT_NATIVE_OG_IMAGE_CACHE_CONTROL,\n    \"Netlify-CDN-Cache-Control\": AGENT_NATIVE_OG_IMAGE_NETLIFY_CACHE_CONTROL,\n    \"Cross-Origin-Resource-Policy\": \"cross-origin\",\n  };\n  if (typeof byteLength === \"number\") {\n    headers[\"Content-Length\"] = String(byteLength);\n  }\n  return headers;\n}\n\nexport function createAgentNativeOgImageHandler(\n  options: AgentNativeOgImageInput = {},\n) {\n  return defineEventHandler(async (event) => {\n    if (getMethod(event) === \"HEAD\") {\n      return new Response(null, {\n        headers: agentNativeOgImageResponseHeaders(),\n      });\n    }\n\n    const query = getQuery(event);\n    const appName = cleanText(options.appName) || resolveDefaultAppName(event);\n    const png = await renderAgentNativeOgImagePng({\n      ...options,\n      appName,\n      title: cleanText(options.title) || queryStringValue(query.title, 140),\n      accentText:\n        cleanText(options.accentText) || queryStringValue(query.accentText, 80),\n    });\n\n    return new Response(pngBody(png), {\n      headers: agentNativeOgImageResponseHeaders(png.byteLength),\n    });\n  });\n}\n"]}

package/dist/server/ssr-handler.d.ts

@@ -1,4 +1,4 @@
-export { DEFAULT_SPECULATION_RULES_HEADER, DEFAULT_SSR_CACHE_CONTROL, } from "../shared/cache-control.js";
+export { DEFAULT_SSR_CACHE_HEADERS, DEFAULT_SPECULATION_RULES_HEADER, DEFAULT_SSR_CACHE_CONTROL, } from "../shared/cache-control.js";
 /**
  * Create an h3 catch-all that hands page routes to React Router and
  * returns 404 for framework / asset paths that React Router doesn't own.

package/dist/server/ssr-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssr-handler.d.ts","sourceRoot":"","sources":["../../src/server/ssr-handler.ts"],"names":[],"mappings":"AAqCA,OAAO,EACL,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AA2UpC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,2FAuE5E"}
+{"version":3,"file":"ssr-handler.d.ts","sourceRoot":"","sources":["../../src/server/ssr-handler.ts"],"names":[],"mappings":"AA4CA,OAAO,EACL,yBAAyB,EACzB,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AAyWpC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,2FAyE5E"}

package/dist/server/ssr-handler.js

@@ -22,9 +22,9 @@ import { BETTER_AUTH_COOKIE_PREFIX, COOKIE_NAME, getSession } from "./auth.js";
 import { hasAuthContextAccess, runWithRequestContext, } from "./request-context.js";
 import { requestHasEmbedAuthMarker } from "./embed-session.js";
 import { EMBED_SESSION_COOKIE, EMBED_TOKEN_QUERY_PARAM, } from "../shared/embed-auth.js";
-import { AGENT_NATIVE_DEFAULT_SOCIAL_IMAGE } from "../shared/social-meta.js";
-import { DEFAULT_SPECULATION_RULES_PATH, DEFAULT_SSR_CACHE_CONTROL, } from "../shared/cache-control.js";
-export { DEFAULT_SPECULATION_RULES_HEADER, DEFAULT_SSR_CACHE_CONTROL, } from "../shared/cache-control.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 { DEFAULT_SSR_CACHE_HEADERS, DEFAULT_SPECULATION_RULES_PATH, } from "../shared/cache-control.js";
+export { DEFAULT_SSR_CACHE_HEADERS, DEFAULT_SPECULATION_RULES_HEADER, DEFAULT_SSR_CACHE_CONTROL, } from "../shared/cache-control.js";
 const ANONYMOUS_SESSION_COOKIE_NAMES = new Set(["an_docs_session"]);
 const BETTER_AUTH_SESSION_COOKIE_RE = /\.session_(?:token|data)$/;
 /**
@@ -132,20 +132,29 @@ function injectHeadScript(html, script) {
 const OG_IMAGE_META_RE = /<meta\b(?=[^>]*\bproperty=(["'])og:image\1)[^>]*>/i;
 const TWITTER_CARD_META_RE = /<meta\b(?=[^>]*\bname=(["'])twitter:card\1)[^>]*>/i;
 const TWITTER_IMAGE_META_RE = /<meta\b(?=[^>]*\bname=(["'])twitter:image\1)[^>]*>/i;
-function injectDefaultSocialImageMeta(html) {
+function defaultSocialImageUrl(requestUrl, basePath) {
+    return new URL(prefixMountedPath(AGENT_NATIVE_SOCIAL_IMAGE_PATH, basePath), requestUrl).toString();
+}
+function injectDefaultSocialImageMeta(html, imageUrl) {
     const headCloseIdx = html.indexOf("</head>");
     if (headCloseIdx === -1)
         return html;
     const hasAnySocialImage = OG_IMAGE_META_RE.test(html) || TWITTER_IMAGE_META_RE.test(html);
     const tags = [];
     if (!hasAnySocialImage) {
-        tags.push(`<meta property="og:image" content="${AGENT_NATIVE_DEFAULT_SOCIAL_IMAGE}">`);
+        tags.push(`<meta property="og:image" content="${imageUrl}">`);
+        tags.push(`<meta property="og:image:secure_url" content="${imageUrl}">`);
+        tags.push(`<meta property="og:image:type" content="${AGENT_NATIVE_SOCIAL_IMAGE_TYPE}">`);
+        tags.push(`<meta property="og:image:width" content="${AGENT_NATIVE_SOCIAL_IMAGE_WIDTH}">`);
+        tags.push(`<meta property="og:image:height" content="${AGENT_NATIVE_SOCIAL_IMAGE_HEIGHT}">`);
+        tags.push(`<meta property="og:image:alt" content="${AGENT_NATIVE_SOCIAL_IMAGE_ALT}">`);
     }
     if (!TWITTER_CARD_META_RE.test(html)) {
         tags.push(`<meta name="twitter:card" content="summary_large_image">`);
     }
     if (!hasAnySocialImage) {
-        tags.push(`<meta name="twitter:image" content="${AGENT_NATIVE_DEFAULT_SOCIAL_IMAGE}">`);
+        tags.push(`<meta name="twitter:image" content="${imageUrl}">`);
+        tags.push(`<meta name="twitter:image:alt" content="${AGENT_NATIVE_SOCIAL_IMAGE_ALT}">`);
     }
     if (tags.length === 0)
         return html;
@@ -221,7 +230,14 @@ function applyDefaultSsrCacheHeader(headers, status, pathname, authContextAccess
     if (!shouldUseDefaultSsrCacheHeader(headers, status, pathname, authContextAccessed)) {
         return;
     }
-    headers.set("cache-control", DEFAULT_SSR_CACHE_CONTROL);
+    // Netlify Functions/proxies are not cached by default, and production docs
+    // requests often carry stale auth/doc cookies. Keep all three cache headers:
+    // Cache-Control for browsers, CDN-Cache-Control for generic CDNs, and
+    // Netlify-CDN-Cache-Control (with durable) so Netlify's shared cache actually
+    // serves SSR HTML/.data instead of forwarding every request to origin.
+    for (const [name, value] of Object.entries(DEFAULT_SSR_CACHE_HEADERS)) {
+        headers.set(name, value);
+    }
 }
 function applyDefaultSpeculationRulesHeader(headers, status, basePath) {
     if (status < 200 || status >= 400)
@@ -256,7 +272,7 @@ function isFrameworkOrAssetPath(pathname) {
         pathname === "/favicon.png" ||
         (/\.\w+$/.test(pathname) && !pathname.endsWith(".data")));
 }
-async function rewriteMountedResponse(response, basePath, pathname, requestContext) {
+async function rewriteMountedResponse(response, basePath, pathname, requestUrl, requestContext) {
     const sentryClientConfigScript = getSentryClientConfigScript();
     const headers = new Headers(response.headers);
     applyDefaultSsrCacheHeader(headers, response.status, pathname, hasAuthContextAccess(requestContext));
@@ -275,7 +291,7 @@ async function rewriteMountedResponse(response, basePath, pathname, requestConte
     }
     const html = await response.text();
     headers.delete("content-length");
-    return new Response(injectHeadScript(injectDefaultSocialImageMeta(prefixMountedHtml(html, basePath)), sentryClientConfigScript), {
+    return new Response(injectHeadScript(injectDefaultSocialImageMeta(prefixMountedHtml(html, basePath), defaultSocialImageUrl(requestUrl, basePath)), sentryClientConfigScript), {
         status: response.status,
         statusText: response.statusText,
         headers,
@@ -326,9 +342,9 @@ export function createH3SSRHandler(getBuild) {
                     status: response.status,
                     statusText: response.statusText,
                     headers: response.headers,
-                }), basePath, p, ctx);
+                }), basePath, p, request.url, ctx);
             }
-            return await rewriteMountedResponse(await runWithRequestContext(ctx, () => handler(request)), basePath, p, ctx);
+            return await rewriteMountedResponse(await runWithRequestContext(ctx, () => handler(request)), basePath, p, request.url, ctx);
         }
         catch (err) {
             // Log the full stack server-side, but never leak it to the client.