@agent-native/core 0.0.0-beta-20260820220930 → 0.0.0-beta-20260820222620

package/corpus/templates/analytics/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/corpus/templates/assets/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/corpus/templates/brain/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/corpus/templates/calendar/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/corpus/templates/chat/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/corpus/templates/clips/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/corpus/templates/clips/app/routes/download.tsx

@@ -4,20 +4,12 @@ import {
   IconBrandChrome,
   IconBrandApple,
   IconBrandWindows,
-  IconChevronDown,
-  IconDeviceDesktop,
   IconExternalLink,
+  IconTerminal2,
 } from "@tabler/icons-react";
 import { useEffect, useState } from "react";
 
 import { Button } from "@/components/ui/button";
-import {
-  DropdownMenu,
-  DropdownMenuContent,
-  DropdownMenuRadioGroup,
-  DropdownMenuRadioItem,
-  DropdownMenuTrigger,
-} from "@/components/ui/dropdown-menu";
 import { Skeleton } from "@/components/ui/skeleton";
 import enMessages from "@/i18n/en-US";
 import {
@@ -45,7 +37,6 @@ type PlatformId = "mac" | "windows" | "linux";
 interface PlatformVariant {
   id: PlatformId;
   label: string;
-  sublabel: string;
   assetKinds: readonly (
     | "mac-universal"
     | "mac-arm64"
@@ -64,23 +55,20 @@ const VARIANTS: PlatformVariant[] = [
   {
     id: "mac",
     label: "macOS",
-    sublabel: "Universal (Apple Silicon + Intel)",
     assetKinds: ["mac-universal", "mac-arm64", "mac-x64"],
     icon: IconBrandApple,
   },
   {
     id: "windows",
     label: "Windows",
-    sublabel: "64-bit MSI installer",
     assetKinds: ["windows-msi"],
     icon: IconBrandWindows,
   },
   {
     id: "linux",
     label: "Linux",
-    sublabel: "AppImage, Debian, and RPM packages",
     assetKinds: ["linux-appimage", "linux-deb", "linux-rpm"],
-    icon: IconDeviceDesktop,
+    icon: IconTerminal2,
   },
 ];
 
@@ -171,47 +159,6 @@ function primaryDownloadButton(
   );
 }
 
-function secondaryDownloadButton(
-  variant: PlatformVariant,
-  manifest: Manifest | null,
-  manifestError: boolean,
-  downloadLabel: string,
-  retryLabel: string,
-  onRetry: () => void,
-) {
-  const asset = pickAsset(manifest, variant);
-  const Icon = variant.icon;
-  const className =
-    "h-auto gap-1.5 px-2 py-1 text-sm font-normal text-muted-foreground hover:bg-transparent hover:text-foreground";
-  if (asset) {
-    return (
-      <Button asChild variant="ghost" className={className}>
-        <a href={asset.url} download onClick={markDesktopAppDownloaded}>
-          <Icon className="h-4 w-4" />
-          {downloadLabel}
-        </a>
-      </Button>
-    );
-  }
-  if (manifest === null && !manifestError) {
-    return <Skeleton className="h-7 w-[208px] rounded-md" />;
-  }
-  if (manifestError) {
-    return (
-      <Button variant="ghost" className={className} onClick={onRetry}>
-        <Icon className="h-4 w-4" />
-        {retryLabel}
-      </Button>
-    );
-  }
-  return (
-    <Button variant="ghost" className={className} disabled>
-      <Icon className="h-4 w-4" />
-      {downloadLabel}
-    </Button>
-  );
-}
-
 export default function DownloadPage() {
   const chromeExtensionEnabled = useClipsChromeExtensionEnabled();
   const t = useT();
@@ -267,7 +214,11 @@ export default function DownloadPage() {
   };
 
   const primary = VARIANTS.find((v) => v.id === detected) ?? VARIANTS[0];
-  const secondary = VARIANTS.filter((v) => v.id !== primary.id);
+
+  const handlePlatformChange = (nextPlatform: PlatformId) => {
+    if (nextPlatform === detected) return;
+    setDetected(nextPlatform);
+  };
 
   return (
     <div className="min-h-screen bg-background text-foreground">
@@ -317,87 +268,83 @@ export default function DownloadPage() {
             {t("downloadRoute.heroDescription")}
           </p>
 
-          <div className="mt-10 flex flex-col items-center gap-3">
-            {primaryDownloadButton(
-              primary,
-              manifest,
-              manifestError,
-              t("downloadRoute.downloadFor", { platform: primary.label }),
-              t("downloadRoute.retry"),
-              retryManifest,
-            )}
-            {secondary.map((variant) => (
-              <div key={variant.id}>
-                {secondaryDownloadButton(
-                  variant,
-                  manifest,
-                  manifestError,
-                  t("downloadRoute.alsoFor", { platform: variant.label }),
-                  t("downloadRoute.retry"),
-                  retryManifest,
-                )}
-              </div>
-            ))}
-            <div className="text-xs text-muted-foreground">
-              {manifest ? (
-                <>
-                  {manifest.pub_date
-                    ? t("downloadRoute.versionReleased", {
-                        version: manifest.version,
-                        date: new Date(manifest.pub_date).toLocaleDateString(),
-                      })
-                    : t("downloadRoute.version", {
-                        version: manifest.version,
-                      })}
-                </>
-              ) : manifestError ? (
-                <>{t("downloadRoute.manifestError")}</>
-              ) : (
-                <>{t("downloadRoute.loadingRelease")}</>
-              )}
+          <div className="mt-10 flex flex-col items-center">
+            <div className="mb-2 flex justify-center gap-2">
+              {VARIANTS.map((variant) => {
+                const Icon = variant.icon;
+                const active = primary.id === variant.id;
+                return (
+                  <button
+                    key={variant.id}
+                    type="button"
+                    aria-label={variant.label}
+                    aria-pressed={active}
+                    onClick={() => handlePlatformChange(variant.id)}
+                    className={`group flex items-center justify-center rounded-lg p-4 transition-opacity focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 ${
+                      active
+                        ? "text-foreground"
+                        : "text-muted-foreground opacity-40 hover:opacity-65"
+                    }`}
+                  >
+                    <Icon className="size-6" aria-hidden="true" />
+                  </button>
+                );
+              })}
             </div>
-            <div className="mt-2 flex items-center justify-center text-xs text-muted-foreground">
-              <DropdownMenu>
-                <DropdownMenuTrigger asChild>
-                  <Button
+
+            <div className="mx-auto mt-8 max-w-2xl text-center">
+              {primaryDownloadButton(
+                primary,
+                manifest,
+                manifestError,
+                t("downloadRoute.downloadFor", { platform: primary.label }),
+                t("downloadRoute.retry"),
+                retryManifest,
+              )}
+
+              <div className="mt-5 flex justify-center">
+                <div className="flex items-center gap-2 text-xs text-muted-foreground">
+                  <span>{t("downloadRoute.stable")}</span>
+                  <button
                     type="button"
-                    variant="ghost"
-                    size="sm"
-                    className="h-7 gap-1.5 px-2 font-normal text-muted-foreground hover:bg-muted/50 hover:text-foreground"
-                    data-release-channel={channel}
+                    role="switch"
+                    aria-checked={channel === "nightly"}
+                    aria-label={t(
+                      channel === "nightly"
+                        ? "downloadRoute.switchToStable"
+                        : "downloadRoute.switchToNightly",
+                    )}
+                    onClick={() =>
+                      handleChannelChange(
+                        channel === "nightly" ? "production" : "nightly",
+                      )
+                    }
+                    className={`relative inline-flex h-5 w-9 shrink-0 items-center rounded-full border border-border transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 ${
+                      channel === "nightly"
+                        ? "bg-foreground"
+                        : "bg-muted-foreground/20"
+                    }`}
                   >
                     <span
-                      className={
+                      aria-hidden="true"
+                      className={`block size-3.5 rounded-full bg-primary-foreground shadow-sm transition-transform ${
                         channel === "nightly"
-                          ? "font-medium text-foreground"
-                          : undefined
-                      }
-                    >
-                      {channel === "nightly"
-                        ? t("downloadRoute.nightly")
-                        : t("downloadRoute.stable")}
-                    </span>
-                    <IconChevronDown className="size-3.5" aria-hidden="true" />
-                  </Button>
-                </DropdownMenuTrigger>
-                <DropdownMenuContent align="center" className="w-44">
-                  <DropdownMenuRadioGroup
-                    value={channel}
-                    onValueChange={(value) => {
-                      if (value === "production" || value === "nightly") {
-                        handleChannelChange(value);
-                      }
-                    }}
+                          ? "translate-x-[18px]"
+                          : "translate-x-[2px]"
+                      }`}
+                    />
+                  </button>
+                  <span
+                    className={
+                      channel === "nightly"
+                        ? "font-medium text-foreground"
+                        : "text-muted-foreground"
+                    }
                   >
-                    <DropdownMenuRadioItem value="production">
-                      {t("downloadRoute.stable")}
-                    </DropdownMenuRadioItem>
-                    <DropdownMenuRadioItem value="nightly">
-                      {t("downloadRoute.nightly")}
-                    </DropdownMenuRadioItem>
-                  </DropdownMenuRadioGroup>
-                </DropdownMenuContent>
-              </DropdownMenu>
+                    {t("downloadRoute.nightly")}
+                  </span>
+                </div>
+              </div>
             </div>
           </div>
 

package/corpus/templates/content/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/corpus/templates/crm/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/corpus/templates/design/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/corpus/templates/dispatch/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/corpus/templates/factory/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/corpus/templates/forms/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/corpus/templates/macros/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/corpus/templates/mail/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/corpus/templates/plan/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/corpus/templates/slides/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/corpus/templates/tasks/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/dist/client/blocks/library/diagram.config.d.ts

@@ -37,7 +37,10 @@ export interface DiagramData {
      */
     html?: string;
     css?: string;
-    /** `design` forces clean HTML/CSS rendering without the sketch overlay. */
+    /**
+     * `design` forces clean HTML/CSS rendering without the sketch overlay. Use it
+     * for UI-like blocks such as cards, logo walls, tables, and controls.
+     */
     renderMode?: "wireframe" | "design";
     caption?: string;
     /** Outer surface frame. `auto` lets the host choose the right default. */

package/dist/client/blocks/library/diagram.js

@@ -393,7 +393,7 @@ export const diagramBlock = defineBlock({
     // edit from a corner button + panel rather than inline.
     editSurface: "panel",
     label: "Diagram",
-    description: "A flexible inline architecture/code diagram. Prefer html/css with SVG or semantic HTML for polished two-dimensional layouts; use renderMode design for clean presentation or .diagram-* primitives and --wf-* tokens for theme/sketch compatibility. Legacy nodes/edges are only for simple previews.",
+    description: "A flexible inline architecture/code diagram. Prefer html/css with SVG or semantic HTML for polished two-dimensional layouts; use renderMode design for UI-like blocks such as cards, logo walls, tables, and controls, or .diagram-* primitives and --wf-* tokens for actual diagrams that need theme/sketch compatibility. Legacy nodes/edges are only for simple previews.",
     // Seed the legacy fallback shape so a fresh block validates while agents can
     // replace it with html/css when layout quality matters.
     empty: () => ({ nodes: [{ id: "n1", label: "Module" }], edges: [] }),

package/dist/client/chat/run-recovery.js

@@ -298,17 +298,25 @@ export function RunErrorRecoveryCard({ info, onContinue, onRetry, onFork, onDism
     return (_jsxs("div", { className: "rounded-lg border border-amber-500/25 bg-amber-500/[0.06] p-3 text-sm", children: [_jsxs("div", { className: "flex items-start gap-2", children: [_jsx("span", { className: "mt-0.5 flex h-6 w-6 shrink-0 items-center justify-center rounded-md bg-amber-500/10 text-amber-700 dark:text-amber-300", children: _jsx(IconAlertTriangle, { size: 14 }) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: "font-medium text-foreground", children: runErrorHeadline(info, {
                                     recoverable: t("agentChat.error.stopped"),
                                     terminal: t("agentChat.error.failed"),
-                                }) }), _jsx("p", { className: "mt-1 text-xs leading-relaxed text-muted-foreground", children: localizeKnownChatErrorText(info.message, t) }), isProviderAuthError && (_jsx("div", { className: "mt-3 rounded-md border border-border/70 bg-background/60 p-2.5", children: _jsx(BuilderSetupContent, { layout: "sidebar", onConnected: handleProviderConnected }) })), shouldShowBuilderReconnect && !builderReconnectResolved && (_jsx("p", { className: "mt-2 text-xs leading-relaxed text-muted-foreground", children: t("agentChat.recovery.credentialRejected") })), isConnectionRecoveryError && (_jsx("p", { className: "mt-2 text-xs leading-relaxed text-muted-foreground", children: t("agentChat.recovery.newChatHint") })), (info.runId || info.errorCode || info.details) && (_jsxs("button", { type: "button", onClick: () => setDetailsOpen((v) => !v), className: "mt-2 inline-flex items-center gap-1 text-[11px] font-medium text-muted-foreground hover:text-foreground", children: [_jsx(IconChevronDown, { size: 12, className: cn("transition-transform", detailsOpen && "rotate-180") }), t("agentChat.common.details")] })), detailsOpen && (_jsxs("div", { className: "mt-2 rounded-md border border-border/60 bg-background/70 p-2 font-mono text-[11px] leading-relaxed text-muted-foreground", children: [info.runId && _jsxs("div", { children: ["run: ", info.runId] }), info.errorCode && _jsxs("div", { children: ["code: ", info.errorCode] }), info.details && (_jsx("pre", { className: "mt-2 max-h-28 overflow-auto whitespace-pre-wrap break-words font-mono", children: info.details }))] }))] }), _jsx("button", { type: "button", onClick: onDismiss, "aria-label": t("agentChat.common.dismiss"), className: "flex h-6 w-6 shrink-0 items-center justify-center rounded-md text-muted-foreground hover:bg-background/80 hover:text-foreground", children: _jsx(IconX, { size: 14 }) })] }), _jsxs("div", { className: "mt-3 flex flex-wrap items-center gap-2", children: [shouldShowBuilderReconnect && !builderReconnectResolved && (_jsxs("button", { type: "button", onClick: () => builderReconnect.start(), disabled: builderReconnect.connecting, className: "inline-flex h-8 items-center gap-1.5 rounded-md bg-foreground px-3 text-xs font-medium text-background hover:opacity-90 disabled:cursor-wait disabled:opacity-70", children: [builderReconnect.connecting ? (_jsx(IconLoader2, { size: 13, className: "animate-spin" })) : null, builderReconnect.connecting
+                                }) }), _jsx("p", { className: "mt-1 text-xs leading-relaxed text-muted-foreground", children: localizeKnownChatErrorText(info.message, t) }), isProviderAuthError && (_jsx("div", { className: "mt-3 rounded-md border border-border/70 bg-background/60 p-2.5", children: _jsx(BuilderSetupContent, { layout: "sidebar", onConnected: handleProviderConnected }) })), shouldShowBuilderReconnect && !builderReconnectResolved && (_jsx("p", { className: "mt-2 text-xs leading-relaxed text-muted-foreground", children: t("agentChat.recovery.credentialRejected") })), isConnectionRecoveryError && (_jsx("p", { className: "mt-2 text-xs leading-relaxed text-muted-foreground", children: t("agentChat.recovery.newChatHint") })), (info.runId || info.errorCode || info.details) && (_jsxs("button", { type: "button", onClick: () => setDetailsOpen((v) => !v), className: "mt-2 inline-flex items-center gap-1 text-[11px] font-medium text-muted-foreground hover:text-foreground", children: [_jsx(IconChevronDown, { size: 12, className: cn("transition-transform", detailsOpen && "rotate-180") }), t("agentChat.common.details")] })), detailsOpen && (_jsxs("div", { className: "mt-2 rounded-md border border-border/60 bg-background/70 p-2 font-mono text-[11px] leading-relaxed text-muted-foreground", children: [info.runId && _jsxs("div", { children: ["run: ", info.runId] }), info.errorCode && _jsxs("div", { children: ["code: ", info.errorCode] }), info.details && (_jsx("pre", { className: "mt-2 max-h-28 overflow-auto whitespace-pre-wrap break-words font-mono", children: info.details }))] }))] }), _jsx("button", { type: "button", onClick: onDismiss, "aria-label": t("agentChat.common.dismiss"), className: "flex h-6 w-6 shrink-0 items-center justify-center rounded-md text-muted-foreground hover:bg-background/80 hover:text-foreground", children: _jsx(IconX, { size: 14 }) })] }), _jsxs("div", { className: "mt-3 flex min-w-0 items-center gap-2", children: [shouldShowBuilderReconnect && !builderReconnectResolved && (_jsxs("button", { type: "button", onClick: () => builderReconnect.start(), disabled: builderReconnect.connecting, className: "inline-flex h-8 items-center gap-1.5 rounded-md bg-foreground px-3 text-xs font-medium text-background hover:opacity-90 disabled:cursor-wait disabled:opacity-70", children: [builderReconnect.connecting ? (_jsx(IconLoader2, { size: 13, className: "animate-spin" })) : null, builderReconnect.connecting
                                 ? t("agentChat.recovery.connectingBuilder")
-                                : t("agentChat.recovery.reconnectBuilder")] })), canRecover && (_jsx(_Fragment, { children: _jsxs("button", { type: "button", onClick: onContinue, className: "inline-flex h-8 items-center gap-1.5 rounded-md bg-foreground px-3 text-xs font-medium text-background hover:opacity-90", children: [_jsx(IconPlayerPlay, { size: 13 }), t("agentChat.common.continue")] }) })), canRetry && (_jsxs("button", { type: "button", onClick: onRetry, className: "inline-flex h-8 items-center gap-1.5 rounded-md border border-border bg-background px-3 text-xs font-medium text-foreground hover:bg-accent", children: [_jsx(IconRefresh, { size: 13 }), isQueryError
-                                ? t("agentChat.recovery.diagnoseRetry")
-                                : t("agentChat.common.retry")] })), canRecover && isConnectionRecoveryError && (_jsxs("button", { type: "button", onClick: startNewChat, className: "inline-flex h-8 items-center gap-1.5 rounded-md border border-border bg-background px-3 text-xs font-medium text-foreground hover:bg-accent", children: [_jsx(IconPlus, { size: 13 }), t("agentChat.tabs.newChat")] })), canRecover && onFork && !isConnectionRecoveryError && (_jsxs("button", { type: "button", onClick: handleFork, disabled: forking, title: t("agentChat.recovery.forkDescription"), "aria-label": t("agentChat.recovery.forkDescription"), className: "inline-flex h-8 items-center gap-1.5 rounded-md border border-border bg-background px-3 text-xs font-medium text-foreground hover:bg-accent disabled:cursor-wait disabled:opacity-70", children: [forking ? (_jsx(IconLoader2, { size: 13, className: "animate-spin" })) : (_jsx(IconGitFork, { size: 13 })), forking
-                                ? t("agentChat.recovery.forking")
-                                : t("agentChat.message.forkChat")] })), _jsxs("button", { type: "button", onClick: copyDetails, className: "ms-auto inline-flex h-8 items-center gap-1.5 rounded-md px-2.5 text-xs font-medium text-muted-foreground hover:bg-background/80 hover:text-foreground", children: [copyState === "copied" ? (_jsx(IconCheck, { size: 13 })) : copyState === "failed" ? (_jsx(IconX, { size: 13 })) : (_jsx(IconCopy, { size: 13 })), _jsx("span", { "aria-live": "polite", children: copyState === "copied"
+                                : t("agentChat.recovery.reconnectBuilder")] })), canRecover && (_jsxs("button", { type: "button", onClick: onContinue, className: "inline-flex min-w-0 flex-1 items-center justify-center gap-1.5 rounded-md bg-foreground px-3 text-xs font-medium text-background hover:opacity-90", children: [_jsx(IconPlayerPlay, { size: 13 }), _jsx("span", { className: "truncate", children: t("agentChat.common.continue") })] })), _jsxs("div", { className: "flex shrink-0 items-center gap-0.5 rounded-md border border-border/70 bg-background/60 p-0.5", children: [canRetry && (_jsx("button", { type: "button", onClick: onRetry, title: isQueryError
+                                    ? t("agentChat.recovery.diagnoseRetry")
+                                    : t("agentChat.common.retry"), "aria-label": isQueryError
+                                    ? t("agentChat.recovery.diagnoseRetry")
+                                    : t("agentChat.common.retry"), className: "inline-flex h-7 w-7 items-center justify-center rounded-md text-muted-foreground hover:bg-accent hover:text-foreground", children: _jsx(IconRefresh, { size: 14 }) })), canRecover && isConnectionRecoveryError && (_jsx("button", { type: "button", onClick: startNewChat, title: t("agentChat.tabs.newChat"), "aria-label": t("agentChat.tabs.newChat"), className: "inline-flex h-7 w-7 items-center justify-center rounded-md text-muted-foreground hover:bg-accent hover:text-foreground", children: _jsx(IconPlus, { size: 14 }) })), canRecover && onFork && !isConnectionRecoveryError && (_jsx("button", { type: "button", onClick: handleFork, disabled: forking, title: t("agentChat.recovery.forkDescription"), "aria-label": t("agentChat.recovery.forkDescription"), className: "inline-flex h-7 w-7 items-center justify-center rounded-md text-muted-foreground hover:bg-accent hover:text-foreground disabled:cursor-wait disabled:opacity-70", children: forking ? (_jsx(IconLoader2, { size: 14, className: "animate-spin" })) : (_jsx(IconGitFork, { size: 14 })) })), _jsxs("button", { type: "button", onClick: copyDetails, title: copyState === "copied"
                                     ? t("agentChat.common.copied")
                                     : copyState === "failed"
                                         ? t("agentChat.recovery.copyFailed")
-                                        : copyLabel })] })] }), shouldShowBuilderReconnect && builderReconnect.error && (_jsx("p", { className: "mt-2 text-xs leading-relaxed text-red-500", children: builderReconnect.error })), forkError && (_jsx("p", { className: "mt-2 text-xs leading-relaxed text-red-500", children: forkError }))] }));
+                                        : copyLabel, "aria-label": copyState === "copied"
+                                    ? t("agentChat.common.copied")
+                                    : copyState === "failed"
+                                        ? t("agentChat.recovery.copyFailed")
+                                        : copyLabel, className: "inline-flex h-7 w-7 items-center justify-center rounded-md text-muted-foreground hover:bg-accent hover:text-foreground", children: [copyState === "copied" ? (_jsx(IconCheck, { size: 14 })) : copyState === "failed" ? (_jsx(IconX, { size: 14 })) : (_jsx(IconCopy, { size: 14 })), _jsx("span", { className: "sr-only", "aria-live": "polite", children: copyState === "copied"
+                                            ? t("agentChat.common.copied")
+                                            : copyState === "failed"
+                                                ? t("agentChat.recovery.copyFailed")
+                                                : copyLabel })] })] })] }), shouldShowBuilderReconnect && builderReconnect.error && (_jsx("p", { className: "mt-2 text-xs leading-relaxed text-red-500", children: builderReconnect.error })), forkError && (_jsx("p", { className: "mt-2 text-xs leading-relaxed text-red-500", children: forkError }))] }));
 }
 // ─── LoopLimitContinueCard ────────────────────────────────────────────────────
 export function LoopLimitContinueCard({ info, onContinue, }) {

package/dist/notifications/routes.d.ts

@@ -13,13 +13,13 @@
 export declare function createNotificationsHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<"" | import("./types.js").Notification[] | {
     count: number;
     updated?: undefined;
-    ok?: undefined;
     error?: undefined;
+    ok?: undefined;
 } | {
     count?: undefined;
     updated: number;
-    ok?: undefined;
     error?: undefined;
+    ok?: undefined;
 } | {
     count?: undefined;
     updated?: undefined;
@@ -28,6 +28,6 @@ export declare function createNotificationsHandler(): import("h3").EventHandlerW
 } | {
     count?: undefined;
     updated?: undefined;
-    ok: boolean;
     error?: undefined;
+    ok: boolean;
 }>>;

package/dist/server/attribution.d.ts

@@ -35,6 +35,18 @@ export interface FirstTouchAttribution {
     /** ISO timestamp of when the visitor first landed. */
     landed_at?: string;
 }
+/**
+ * Request-scoped browser attribution captured at the signup boundary.
+ * Better Auth may create the user in a later async callback where the
+ * original request headers are no longer available, so the values must be
+ * carried explicitly through that boundary.
+ */
+export interface SignupAttributionContext {
+    attribution: Record<string, string>;
+    anonymousId?: string;
+}
+/** Internal Better Auth handoff header; attribution is analytics-only. */
+export declare const SIGNUP_ATTRIBUTION_HEADER_NAME = "x-agent-native-signup-attribution";
 /** Cookie name written by the client (non-HttpOnly; non-sensitive). */
 export declare const FIRST_TOUCH_COOKIE_NAME = "an_ft";
 /**
@@ -87,3 +99,20 @@ export declare function deriveSignupAttribution(ft: FirstTouchAttribution | null
  * error.
  */
 export declare function signupAttributionFromCookieHeader(cookieHeader: string | null | undefined): Record<string, string>;
+/**
+ * Capture all browser attribution needed by the server-side signup event.
+ * Keep this as one boundary helper so every signup entry point carries the
+ * same values into Better Auth's user-create hook.
+ */
+export declare function signupAttributionContextFromCookieHeader(cookieHeader: string | null | undefined): SignupAttributionContext;
+/** Serialize the bounded attribution handoff for a Better Auth request. */
+export declare function encodeSignupAttributionContext(context: SignupAttributionContext): string;
+/**
+ * Decode the internal handoff header. Invalid input is absent, not a direct
+ * attribution, so the caller can safely fall back to the request cookie.
+ */
+export declare function decodeSignupAttributionContext(value: string | null | undefined): SignupAttributionContext | undefined;
+/** Add the explicit handoff to a Better Auth request/API header set. */
+export declare function addSignupAttributionHeader(headers: HeadersInit | undefined, context: SignupAttributionContext): Headers;
+/** Read the explicit handoff from Better Auth's request context headers. */
+export declare function signupAttributionContextFromHeaders(headers: Headers | null | undefined): SignupAttributionContext | undefined;

package/dist/server/attribution.js

@@ -1,4 +1,7 @@
 import { ANALYTICS_ANONYMOUS_ID_COOKIE_NAME, normalizeAnalyticsAnonymousId, } from "../shared/analytics-anonymous-id.js";
+/** Internal Better Auth handoff header; attribution is analytics-only. */
+export const SIGNUP_ATTRIBUTION_HEADER_NAME = "x-agent-native-signup-attribution";
+const SIGNUP_ATTRIBUTION_HEADER_MAX_LENGTH = 4096;
 /** Cookie name written by the client (non-HttpOnly; non-sensitive). */
 export const FIRST_TOUCH_COOKIE_NAME = "an_ft";
 const STRING_FIELDS = [
@@ -178,3 +181,68 @@ export function signupAttributionFromCookieHeader(cookieHeader) {
         return { referral_source: "direct" };
     }
 }
+/**
+ * Capture all browser attribution needed by the server-side signup event.
+ * Keep this as one boundary helper so every signup entry point carries the
+ * same values into Better Auth's user-create hook.
+ */
+export function signupAttributionContextFromCookieHeader(cookieHeader) {
+    const anonymousId = readAnalyticsAnonymousId(cookieHeader);
+    return {
+        attribution: signupAttributionFromCookieHeader(cookieHeader),
+        ...(anonymousId ? { anonymousId } : {}),
+    };
+}
+/** Serialize the bounded attribution handoff for a Better Auth request. */
+export function encodeSignupAttributionContext(context) {
+    return encodeURIComponent(JSON.stringify(context));
+}
+/**
+ * Decode the internal handoff header. Invalid input is absent, not a direct
+ * attribution, so the caller can safely fall back to the request cookie.
+ */
+export function decodeSignupAttributionContext(value) {
+    if (!value || value.length > SIGNUP_ATTRIBUTION_HEADER_MAX_LENGTH) {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(decodeURIComponent(value));
+        const rawAttribution = parsed?.attribution;
+        if (!rawAttribution ||
+            typeof rawAttribution !== "object" ||
+            Array.isArray(rawAttribution)) {
+            return undefined;
+        }
+        const attribution = {};
+        for (const [key, rawValue] of Object.entries(rawAttribution)) {
+            if (/^[A-Za-z0-9_]+$/.test(key) &&
+                key.length <= 64 &&
+                typeof rawValue === "string" &&
+                rawValue.length > 0) {
+                attribution[key] = rawValue.slice(0, 120);
+            }
+        }
+        if (Object.keys(attribution).length === 0)
+            return undefined;
+        const anonymousId = normalizeAnalyticsAnonymousId(parsed?.anonymousId);
+        return {
+            attribution,
+            ...(anonymousId ? { anonymousId } : {}),
+        };
+    }
+    catch (error) {
+        // `undefined` distinguishes an unreadable handoff from direct attribution.
+        void error;
+        return undefined;
+    }
+}
+/** Add the explicit handoff to a Better Auth request/API header set. */
+export function addSignupAttributionHeader(headers, context) {
+    const result = new Headers(headers);
+    result.set(SIGNUP_ATTRIBUTION_HEADER_NAME, encodeSignupAttributionContext(context));
+    return result;
+}
+/** Read the explicit handoff from Better Auth's request context headers. */
+export function signupAttributionContextFromHeaders(headers) {
+    return decodeSignupAttributionContext(headers?.get(SIGNUP_ATTRIBUTION_HEADER_NAME));
+}

package/dist/server/auth.js

@@ -58,7 +58,7 @@ import { isValidWorkspaceAppIdFormat } from "../shared/workspace-app-id.js";
 import { injectAnalyticsIntoHtml } from "./analytics.js";
 import { getConfiguredAppBasePath } from "./app-base-path.js";
 import { getAppProductionUrl } from "./app-url.js";
-import { readAnalyticsAnonymousId, readFirstTouchAttribution, signupAttributionFromCookieHeader, } from "./attribution.js";
+import { addSignupAttributionHeader, readAnalyticsAnonymousId, readFirstTouchAttribution, signupAttributionContextFromCookieHeader, signupAttributionFromCookieHeader, } from "./attribution.js";
 import { getAuthLoginMode } from "./auth-login-mode.js";
 import { injectBetaOptOutPersistence } from "./beta-opt-out-html.js";
 import { createBetterAuthSessionForEmail, ensureGoogleAuthIdentity, getAuthSecret, getBetterAuth, getBetterAuthSync, isDeployPreview, } from "./better-auth-instance.js";
@@ -73,6 +73,7 @@ import { ensureCanonicalUserForLegacySession } from "./legacy-auth-migration.js"
 import { encodeMagicLinkSignupAttribution, MAGIC_LINK_ATTRIBUTION_PARAM, } from "./magic-link-attribution.js";
 import { safeOAuthReturnUrl } from "./oauth-return-url.js";
 import { getOnboardingHtml, getResetPasswordHtml, } from "./onboarding-html.js";
+import { getRequestContext, hasContinuationLocalRequestContext, runWithRequestContext, } from "./request-context.js";
 import { captureAuthError } from "./sentry.js";
 import { forgetCachedSessionEmail, getCachedSessionEmail, invalidateSessionEmailCache, setCachedSessionEmail, } from "./session-email-cache.js";
 import { isWorkspaceOAuthCallbackRelayEnabled } from "./workspace-oauth.js";
@@ -83,6 +84,23 @@ import { isWorkspaceOAuthCallbackRelayEnabled } from "./workspace-oauth.js";
 export function getSessionMaxAge() {
     return sessionMaxAge;
 }
+function withSignupAttributionContext(cookieHeader, fn) {
+    const signupAttribution = signupAttributionContextFromCookieHeader(cookieHeader);
+    if (!hasContinuationLocalRequestContext())
+        return fn();
+    return runWithRequestContext({
+        ...(getRequestContext() ?? {}),
+        signupAttribution,
+    }, fn);
+}
+function requestWithSignupAttribution(request, signupAttribution) {
+    return new Request(request, {
+        headers: addSignupAttributionHeader(request.headers, signupAttribution),
+    });
+}
+function headersWithSignupAttribution(headers, cookieHeader) {
+    return addSignupAttributionHeader(headers, signupAttributionContextFromCookieHeader(cookieHeader));
+}
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
@@ -416,6 +434,9 @@ async function readDesktopSsoSafely(event) {
         return null;
     return await readDesktopSso();
 }
+function isDesktopSessionCookieOnlyCheck(event) {
+    return getHeader(event, "x-agent-native-session-check") === "cookie-only";
+}
 /**
  * Extract the framework session token from a Better Auth response's
  * Set-Cookie headers, if any. Used by the password-reset path to skip
@@ -2688,6 +2709,7 @@ export async function getSession(event) {
     })());
 }
 async function resolveSessionUncached(event) {
+    const cookieOnlyDesktopCheck = isDesktopSessionCookieOnlyCheck(event);
     // 1. MCP App embed session. This is a short-lived browser session minted
     // from a one-time ticket that was scoped to the authenticated MCP caller.
     // It lets an inline MCP App iframe load the real app without reusing the
@@ -2724,9 +2746,11 @@ async function resolveSessionUncached(event) {
         // templates too. Gated on `readDesktopSsoSafely` so a non-loopback
         // request that spoofs `User-Agent: ... Electron/...` cannot read the
         // home-dir broker file (and so production builds never consult it).
-        const sso = await readDesktopSsoSafely(event);
-        if (sso?.email)
-            return { email: sso.email, token: sso.token };
+        if (!cookieOnlyDesktopCheck) {
+            const sso = await readDesktopSsoSafely(event);
+            if (sso?.email)
+                return { email: sso.email, token: sso.token };
+        }
         // Fall through to mobile _session check
     }
     else {
@@ -2765,9 +2789,11 @@ async function resolveSessionUncached(event) {
         // a loopback (127.0.0.1 / ::1) source IP, and a non-production NODE_ENV
         // — anything else is rejected so a hostile network request cannot
         // impersonate whichever email last signed into the desktop app.
-        const sso = await readDesktopSsoSafely(event);
-        if (sso?.email) {
-            return { email: sso.email, token: sso.token };
+        if (!cookieOnlyDesktopCheck) {
+            const sso = await readDesktopSsoSafely(event);
+            if (sso?.email) {
+                return { email: sso.email, token: sso.token };
+            }
         }
     }
     // 8. Mobile WebView bridge — _session query param
@@ -3699,11 +3725,18 @@ async function mountBetterAuthRoutes(app, options) {
             getMethod(event) === "POST";
         const isMagicLinkRequest = reqPath.includes("/sign-in/magic-link") && getMethod(event) === "POST";
         const isMagicLinkVerification = reqPath.includes("/magic-link/verify") && getMethod(event) === "GET";
+        const isEmailSignup = reqPath.includes("/sign-up/email") && getMethod(event) === "POST";
         const isSignOut = reqPath.includes("sign-out") && getMethod(event) === "POST";
         if (isSignOut)
             optOutOfAuthDisabledSession(event);
         const authRequest = toWebRequest(event);
         let requestForAuth = authRequest;
+        const signupCookieHeader = isEmailSignup
+            ? authRequest.headers.get("cookie")
+            : undefined;
+        const signupAttribution = isEmailSignup
+            ? signupAttributionContextFromCookieHeader(signupCookieHeader)
+            : undefined;
         let magicLinkPreConsume;
         if (isMagicLinkVerification) {
             const verificationURL = new URL(authRequest.url);
@@ -3820,9 +3853,14 @@ async function mountBetterAuthRoutes(app, options) {
                 // validation error.
             }
         }
+        if (signupAttribution) {
+            requestForAuth = requestWithSignupAttribution(requestForAuth, signupAttribution);
+        }
         let response;
         try {
-            response = await auth.handler(requestForAuth);
+            response = await (isEmailSignup
+                ? withSignupAttributionContext(signupCookieHeader, () => auth.handler(requestForAuth))
+                : auth.handler(requestForAuth));
         }
         catch (error) {
             if (isMagicLinkVerification) {
@@ -4127,10 +4165,15 @@ async function mountBetterAuthRoutes(app, options) {
             return { error: GOOGLE_AUTH_REQUIRED_MESSAGE };
         }
         try {
-            await auth.api.signUpEmail({
-                body: { email, password, name: email.split("@")[0], callbackURL },
-                headers: event.headers,
-            });
+            await withSignupAttributionContext(getHeader(event, "cookie") ?? null, () => auth.api.signUpEmail({
+                body: {
+                    email,
+                    password,
+                    name: email.split("@")[0],
+                    callbackURL,
+                },
+                headers: headersWithSignupAttribution(event.headers, getHeader(event, "cookie") ?? null),
+            }));
             setFirstRunOnboardingCookie(event);
             return { ok: true };
         }
@@ -4384,10 +4427,10 @@ function mountAuthFallbackRoutes(app) {
         }
         try {
             const auth = await getBetterAuth();
-            await auth.api.signUpEmail({
+            await withSignupAttributionContext(getHeader(event, "cookie") ?? null, () => auth.api.signUpEmail({
                 body: { email, password, name: email.split("@")[0] },
-                headers: event.headers,
-            });
+                headers: headersWithSignupAttribution(event.headers, getHeader(event, "cookie") ?? null),
+            }));
             setFirstRunOnboardingCookie(event);
             return { ok: true };
         }

package/dist/server/better-auth-instance.js

@@ -26,13 +26,14 @@ import { PASSWORD_MAX_LENGTH, PASSWORD_MIN_LENGTH, } from "../shared/password-po
 import { formatRuntimeConfigReport, getRuntimeConfigReport, } from "../shared/runtime-config.js";
 import { flushTracking, identify, track } from "../tracking/index.js";
 import { getAppProductionUrl } from "./app-url.js";
-import { readAnalyticsAnonymousId, signupAttributionFromCookieHeader, } from "./attribution.js";
+import { signupAttributionContextFromCookieHeader, signupAttributionContextFromHeaders, } from "./attribution.js";
 import { resolveAuthCookieNamespace } from "./cookie-namespace.js";
 import { getWorkspaceA2ADerivedSecret } from "./derived-secret.js";
 import { renderMagicLinkEmail, renderResetPasswordEmail, renderVerifySignupEmail, } from "./email-templates.js";
 import { getEmailReadiness, sendEmail } from "./email.js";
 import { resolveGoogleSignInCredentials } from "./google-oauth-credentials.js";
 import { readMagicLinkSignupAttribution } from "./magic-link-attribution.js";
+import { getRequestContext, hasContinuationLocalRequestContext, } from "./request-context.js";
 export { getAuthLoginMode, resolveAuthLoginMode, resolveAuthLoginModeFromReadiness, } from "./auth-login-mode.js";
 async function flushSignupTracking() {
     try {
@@ -1045,14 +1046,25 @@ async function createBetterAuthInstance(config) {
                             const cookieHeader = context?.headers?.get("cookie") ??
                                 context?.request?.headers?.get("cookie") ??
                                 null;
+                            const scopedSignupAttribution = hasContinuationLocalRequestContext()
+                                ? getRequestContext()?.signupAttribution
+                                : undefined;
+                            const requestSignupAttribution = signupAttributionContextFromCookieHeader(cookieHeader);
+                            const headerSignupAttribution = signupAttributionContextFromHeaders(context?.headers) ??
+                                signupAttributionContextFromHeaders(context?.request?.headers);
                             const magicLinkAttribution = context?.request?.url?.includes("newUserCallbackURL")
                                 ? readMagicLinkSignupAttribution(context.request.url, getAuthSecret())
                                 : undefined;
-                            attribution = signupAttributionFromCookieHeader(cookieHeader);
-                            attribution = magicLinkAttribution?.attribution ?? attribution;
+                            attribution =
+                                magicLinkAttribution?.attribution ??
+                                    scopedSignupAttribution?.attribution ??
+                                    headerSignupAttribution?.attribution ??
+                                    requestSignupAttribution.attribution;
                             anonymousId =
                                 magicLinkAttribution?.anonymousId ??
-                                    readAnalyticsAnonymousId(cookieHeader);
+                                    scopedSignupAttribution?.anonymousId ??
+                                    headerSignupAttribution?.anonymousId ??
+                                    requestSignupAttribution.anonymousId;
                         }
                         catch (err) {
                             console.error("[auth] failed to derive signup attribution", err);

package/dist/server/identity-sso.js

@@ -19,10 +19,12 @@ import { getAppConfig } from "../app-config/index.js";
 import { GOOGLE_AUTH_REQUIRED_MESSAGE, isGoogleSignInRequiredForEmail, } from "../org/auth-policy.js";
 import { SIGN_IN_ENTRY_PATH } from "../shared/sign-in-journey.js";
 import { getAppName } from "./app-name.js";
+import { addSignupAttributionHeader, signupAttributionContextFromCookieHeader, } from "./attribution.js";
 import { getSession, isExpectedAuthFailure, safeReturnPath } from "./auth.js";
 import { getBetterAuth, getBetterAuthInternalAdapter, } from "./better-auth-instance.js";
 import { createOAuthSession, getOrigin } from "./google-oauth.js";
 import { consumeSsoState, createSsoState, CANONICAL_IDENTITY_SSO_HUB_URL, getIdentityHubUrl, identitySsoLoginButtonHtml, isCanonicalIdentitySsoClientRequest, isDesktopSsoUserAgent, isIdentitySsoExplicitlyEnabled, isIdentitySsoEnabled, isJtiReplayed, SSO_STATE_TTL_MS, } from "./identity-sso-store.js";
+import { getRequestContext, hasContinuationLocalRequestContext, runWithRequestContext, } from "./request-context.js";
 export { getIdentityHubUrl, identitySsoLoginButtonHtml, isIdentitySsoEnabled };
 export const IDENTITY_SSO_PROVIDER_ID = "agent-native";
 export const IDENTITY_SSO_SCOPE = "identity";
@@ -269,7 +271,7 @@ async function exchangeIdentityCode(hub, binding, input) {
         return null;
     }
 }
-async function jitLinkIdentity(identity) {
+async function jitLinkIdentity(identity, signupHeaders) {
     const adapter = await getBetterAuthInternalAdapter();
     let existing = adapter
         ? await adapter
@@ -288,6 +290,7 @@ async function jitLinkIdentity(identity) {
                     password: createUnusableSsoCredential(),
                     name: identity.name || identity.email.split("@")[0] || "User",
                 },
+                ...(signupHeaders ? { headers: signupHeaders } : {}),
             });
         }
         catch (error) {
@@ -463,7 +466,16 @@ export async function handleIdentitySso(event, subpath) {
             return errorPage(GOOGLE_AUTH_REQUIRED_MESSAGE, loginPath);
         }
         try {
-            await jitLinkIdentity(identity);
+            const signupCookieHeader = getHeader(event, "cookie") ?? null;
+            const signupAttribution = signupAttributionContextFromCookieHeader(signupCookieHeader);
+            const signupHeaders = addSignupAttributionHeader(event.headers, signupAttribution);
+            const linkIdentity = () => jitLinkIdentity(identity, signupHeaders);
+            await (hasContinuationLocalRequestContext()
+                ? runWithRequestContext({
+                    ...(getRequestContext() ?? {}),
+                    signupAttribution,
+                }, linkIdentity)
+                : linkIdentity());
         }
         catch {
             return errorPage("Could not finish linking your account. Please try again.", loginPath);

package/dist/server/request-context.d.ts

@@ -15,6 +15,7 @@
  * process.env so existing `AGENT_USER_EMAIL=x pnpm action foo` invocations
  * continue to work.
  */
+import type { SignupAttributionContext } from "./attribution.js";
 /**
  * Per-request agent-run state. Lives on `RequestContext.run` so the
  * agent-chat plugin can populate fields as the run progresses (owner,
@@ -109,6 +110,11 @@ export interface RequestContext {
      * replay; never used for authorization.
      */
     browserSessionId?: string;
+    /**
+     * Browser attribution captured before a Better Auth signup crosses into its
+     * async user-create hook. Analytics-only; never used for authorization.
+     */
+    signupAttribution?: SignupAttributionContext;
     /** Canonical client surface for analytics attribution. */
     clientPlatform?: import("../shared/analytics-platform.js").AnalyticsClientPlatform;
     /**
@@ -188,6 +194,8 @@ type RequestContextObserver = (ctx: RequestContext) => void;
  * overlapping async requests are only isolated by native AsyncLocalStorage.
  */
 export declare function assertRequestActionSurfaceIsolation(): void;
+/** Whether request context values are isolated across overlapping promises. */
+export declare function hasContinuationLocalRequestContext(): boolean;
 /**
  * Register a callback fired every time `runWithRequestContext` enters a new
  * scope. The hook runs INSIDE the AsyncLocalStorage scope, so observability

package/dist/server/request-context.js

@@ -80,6 +80,10 @@ export function assertRequestActionSurfaceIsolation() {
     throw new Error("Request-scoped action surfaces require continuation-local request context storage; " +
         "this runtime only provides the non-isolated fallback.");
 }
+/** Whether request context values are isolated across overlapping promises. */
+export function hasContinuationLocalRequestContext() {
+    return globalRef[CONTINUATION_LOCAL_KEY] === true;
+}
 /**
  * Register a callback fired every time `runWithRequestContext` enters a new
  * scope. The hook runs INSIDE the AsyncLocalStorage scope, so observability

package/dist/templates/chat/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/dist/templates/default/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/dist/templates/headless/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/dist/templates/workspace-core/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/docs/content/deployment.mdx

@@ -65,7 +65,9 @@ In a workspace, every app inherits the root `DATABASE_URL` by default. Set
 Set a Nitro preset for the target you choose. The app code and database
 contract stay the same.
 
-<Diagram id="doc-block-deployment-targets" title="Supported deployment targets" summary="Agent-Native apps can deploy to Node.js, Docker, Vercel, Netlify, Cloudflare Pages, Cloudflare Workers, AWS Lambda, Deno Deploy, Azure Static Web Apps, Koyeb, and Render.">
+<!-- i18n-copy-ignore: renderer-only Diagram attributes keep this shared UI block in clean mode. -->
+
+<Diagram id="doc-block-deployment-targets" title="Supported deployment targets" summary="Agent-Native apps can deploy to Node.js, Docker, Vercel, Netlify, Cloudflare Pages, Cloudflare Workers, AWS Lambda, Deno Deploy, Azure Static Web Apps, Koyeb, and Render." frame="hide" renderMode="design">
 
 ```html
 <!-- i18n-copy-ignore: deployment target logo markup is visual-only; labels are unchanged. -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.0.0-beta-20260820220930",
+  "version": "0.0.0-beta-20260820222620",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {
@@ -427,7 +427,7 @@
     "y-protocols": "^1.0.7",
     "yjs": "^13.6.32",
     "zod": "^4.3.6",
-    "@agent-native/recap-cli": "0.0.0-beta-20260820220930",
+    "@agent-native/recap-cli": "0.5.7",
     "@agent-native/toolkit": "^0.16.9"
   },
   "devDependencies": {

package/src/templates/chat/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/src/templates/default/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/src/templates/headless/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.

package/src/templates/workspace-core/.agents/skills/agent-native-docs/SKILL.md

@@ -134,3 +134,14 @@ hand-duplicating framework logic.
   `agent-surfaces`.
 - Do not copy framework runtime internals when a public API or narrow UI copy
   will do; read `customizing-agent-native` for the supported override ladder.
+
+## Authoring visual docs blocks
+
+Treat the shared `Diagram` block as a renderer, not as a reason to style every
+docs UI as a sketch. Use the hand-drawn font and Rough.js only for actual
+diagrams or wireframes that communicate structure, flow, or a design draft.
+For polished UI-like content - cards, logo walls, tables, controls, or product
+shells — set `renderMode="design"` (and usually `frame="hide"` when the block
+is the content itself). Design mode preserves normal docs typography and
+disables the Rough.js overlay. Keep `data-rough` only on elements intentionally
+sketched inside a real diagram.