@agent-native/core 0.167.1 → 0.168.0

package/corpus/README.md

@@ -31,4 +31,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 
 ## Generated Counts
 
-- template files: 8490
+- template files: 8491

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/brain/actions/list-sources.ts

@@ -6,6 +6,7 @@ import { z } from "zod";
 import { getDb, schema } from "../server/db/index.js";
 import { nextBrainSourceSyncAt } from "../server/jobs/sync-sources.js";
 import { listAccessibleAudienceIds } from "../server/lib/audiences.js";
+import { sourceHealthState } from "../server/lib/brain-health.js";
 import { parseJson, serializeSource } from "../server/lib/brain.js";
 import { sourceProviderSchema } from "./_schemas.js";
 
@@ -71,14 +72,23 @@ export default defineAction({
       .from(schema.brainSources)
       .where(and(...clauses))
       .orderBy(desc(schema.brainSources.updatedAt));
+    const nowMs = Date.now();
     const sources = await Promise.all(
-      rows.map(async (row) => ({
-        ...serializeSource(row),
-        recordCount: await sourceRecordCount(row.id),
-        latestRun: await latestRun(row.id),
-        nextSyncAt: nextBrainSourceSyncAt(row),
-      })),
+      rows.map(async (row) => {
+        const latest = await latestRun(row.id);
+        const nextSyncAt = nextBrainSourceSyncAt(row);
+        return {
+          ...serializeSource(row),
+          recordCount: await sourceRecordCount(row.id),
+          latestRun: latest,
+          nextSyncAt,
+          health: sourceHealthState(row, latest, nextSyncAt, nowMs),
+        };
+      }),
     );
-    return { count: rows.length, sources };
+    return {
+      count: rows.length,
+      sources,
+    };
   },
 });

package/corpus/templates/brain/app/components/brain/Surface.tsx

@@ -117,7 +117,8 @@ export function StatusBadge({ status }: { status: string }) {
       ? IconCircleCheck
       : normalized.includes("review") ||
           normalized.includes("degraded") ||
-          normalized.includes("stale")
+          normalized.includes("stale") ||
+          normalized.includes("needs")
         ? IconClock
         : normalized.includes("error")
           ? IconAlertTriangle
@@ -132,7 +133,8 @@ export function StatusBadge({ status }: { status: string }) {
           "border-border bg-secondary text-secondary-foreground",
         (normalized.includes("review") ||
           normalized.includes("degraded") ||
-          normalized.includes("stale")) &&
+          normalized.includes("stale") ||
+          normalized.includes("needs")) &&
           "border-amber-500/35 bg-amber-500/10 text-amber-700 dark:text-amber-300",
         normalized.includes("error") &&
           "border-destructive/35 bg-destructive/10 text-destructive",

package/corpus/templates/brain/app/lib/brain.ts

@@ -20,7 +20,14 @@ export type BrainView =
   | "settings";
 
 export type KnowledgeStatus = "approved" | "needs_review" | "draft" | "stale";
-export type SourceHealth = "healthy" | "degraded" | "paused" | "error";
+export type SourceHealth =
+  | "healthy"
+  | "needs_setup"
+  | "needs_sync"
+  | "stale"
+  | "degraded"
+  | "paused"
+  | "error";
 export type ReviewPriority = "high" | "medium" | "low";
 
 export interface Citation {
@@ -1144,8 +1151,11 @@ export function sourceDescription(source: BrainSource) {
 export function sourceHealth(source: BrainSource): SourceHealth {
   if (source.health) return source.health;
   if (sourceRetryAfter(source)) return "degraded";
-  if (source.status === "active")
-    return source.lastError ? "degraded" : "healthy";
+  if (source.status === "active") {
+    if (source.lastError) return "degraded";
+    if (sourceAutoSync(source) && !source.lastSyncedAt) return "needs_sync";
+    return "healthy";
+  }
   if (source.status === "error") return "error";
   if (source.status === "paused" || source.status === "archived")
     return "paused";

package/corpus/templates/brain/server/lib/brain-health.ts

@@ -189,9 +189,9 @@ function latestIso(values: Array<string | null | undefined>) {
   return latest;
 }
 
-function sourceHealthState(
+export function sourceHealthState(
   source: SourceRow,
-  latestRun: SyncRunRow | null,
+  latestRun: Pick<SyncRunRow, "status"> | null,
   nextSyncAt: string | null,
   nowMs: number,
 ): BrainSourceHealthState {
@@ -530,12 +530,9 @@ export async function readBrainHealth() {
     };
   });
 
-  const sourceHealthCounts = countStatuses<
-    BrainSourceHealthState | "active" | "paused" | "error"
-  >([
-    ...sourceSummaries.map((source) => ({ status: source.health })),
-    ...sourceRows.map((source) => ({ status: source.status })),
-  ]);
+  const sourceHealthCounts = countStatuses<BrainSourceHealthState>(
+    sourceSummaries.map((source) => ({ status: source.health })),
+  );
   const captureCounts = countStatuses(captureRows);
   const captureDispositionCounts = countStatuses(
     captureRows.map((capture) => ({

package/corpus/templates/brain/server/lib/brain.ts

@@ -755,6 +755,7 @@ export async function createCapture(values: {
       title: source.title,
       provider: source.provider as BrainSourceProvider,
       ownerEmail: source.ownerEmail,
+      orgId: source.orgId,
     },
     sourceConfig: parseJson<Record<string, unknown>>(source.configJson, {}),
     settings,

package/corpus/templates/brain/server/lib/capture-sanitization.ts

@@ -71,6 +71,7 @@ export interface CaptureSanitizationInput {
     title: string;
     provider: BrainSourceProvider;
     ownerEmail: string;
+    orgId?: string | null;
   };
   sourceConfig?: Record<string, unknown>;
   settings: BrainSettings;
@@ -440,6 +441,10 @@ async function classifyWithApprovedModel(
     apiKeyEnvVar: userApiKey.apiKeyEnvVar,
     appId: "brain",
     engineOption: engineName,
+    credentialIdentity: {
+      userEmail: input.source.ownerEmail,
+      orgId: input.source.orgId ?? undefined,
+    },
   });
 
   const maxChars = Math.min(

package/corpus/templates/brain/server/routes/api/brain/queue/run.post.ts

@@ -10,7 +10,8 @@ declare global {
   var __AGENT_NATIVE_BRAIN_SCHEDULED_RUNTIME__: boolean | undefined;
 }
 
-export const BRAIN_QUEUE_SWEEP_LIMIT = 10;
+export const BRAIN_QUEUE_SWEEP_LIMIT = 25;
+export const BRAIN_MAX_DISTILLATIONS_PER_SWEEP = 2;
 
 function productionLike() {
   return (
@@ -53,7 +54,7 @@ export default defineEventHandler(async (event) => {
     processBrainIngestQueueOnce({
       limit: BRAIN_QUEUE_SWEEP_LIMIT,
       runDistillation: true,
-      maxDistillations: 1,
+      maxDistillations: BRAIN_MAX_DISTILLATIONS_PER_SWEEP,
     }),
     expireSensitivityQuarantines(),
   ]);

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/clips/desktop/src/app.tsx

@@ -67,6 +67,7 @@ import {
   startBubbleWebrtc,
   type BubbleWebrtcHandle,
 } from "./lib/bubble-webrtc";
+import { openBoundOAuthWindow } from "./lib/desktop-oauth-window";
 import {
   getCameraStreamWithFallback,
   isMediaConstraintFailure,
@@ -2126,15 +2127,17 @@ export function App() {
     void tick();
   }
 
-  // Google verification stays in the bound Tauri WebView so the callback sees
-  // the same browser-binding cookie. Magic-link verification still completes
-  // in the system browser through its own exchange flow.
+  // Google verification stays in a child of the bound Tauri WebView so the
+  // callback sees the same browser-binding cookie. Magic-link verification
+  // still completes in the system browser through its own exchange flow.
   async function signInExternal() {
     if (signInInflightRef.current) return;
     signInInflightRef.current = true;
+    let oauthWindow: ReturnType<typeof openBoundOAuthWindow> | null = null;
 
     try {
       setSignInError(null);
+      oauthWindow = openBoundOAuthWindow();
       const flowId = crypto.randomUUID?.() ?? null;
       const verifier = (() => {
         const randomUuid = crypto.randomUUID;
@@ -2163,7 +2166,6 @@ export function App() {
       const authParams = new URLSearchParams({
         desktop: "1",
         flow_id: flowId,
-        webview: "1",
       });
       const authResponse = await fetch(
         `${base}/_agent-native/google/auth-url?${authParams.toString()}`,
@@ -2194,13 +2196,12 @@ export function App() {
               : "Could not start Google sign-in.";
         throw new Error(message);
       }
+      oauthWindow.location.href = authPayload.url;
       setSignInPending("google");
-      // Stay in this exact WebView: the auth bootstrap set the HttpOnly
-      // browser-binding cookie here, and the callback returns this page with
-      // the staged session cookie after Google completes.
-      window.location.href = authPayload.url;
+      startDesktopAuthExchange(flowId, "google", verifier);
     } catch (err) {
       console.error("[clips-tray] signInExternal failed:", err);
+      oauthWindow?.close();
       signInInflightRef.current = false;
       setSignInPending(null);
       setSignInError(
@@ -3962,8 +3963,8 @@ export function App() {
   // (not a separate Tauri window). This avoids Tauri 2's separate-WebKit-
   // data-store-per-WebviewWindow cookie-jar issue — the cookie is set in
   // the same webview that reads it on the next /auth/session poll.
-  // Google verification uses the bound WebView, while magic-link verification
-  // uses the system browser and password stays inline here.
+  // Google verification uses a popup in the bound WebView, while magic-link
+  // verification uses the system browser and password stays inline here.
   if (authStatus === "anon") {
     return (
       <div className="app" ref={appRef}>

package/corpus/templates/clips/desktop/src/lib/desktop-oauth-window.ts

@@ -0,0 +1,23 @@
+type OAuthWindow = Pick<Window, "close"> & {
+  location: Pick<Location, "href">;
+};
+
+type OpenOAuthWindow = (url: string, target: string) => OAuthWindow | null;
+
+/**
+ * Open a same-WebView OAuth child before awaiting the auth URL.
+ *
+ * The parent keeps polling the exchange while the child completes Google
+ * OAuth. Using window.open keeps both pages in the Tauri WebView cookie
+ * partition; the system-browser shell opener would lose the binding cookie.
+ */
+export function openBoundOAuthWindow(
+  openWindow: OpenOAuthWindow = (url, target) =>
+    window.open(url, target) as OAuthWindow | null,
+): OAuthWindow {
+  const oauthWindow = openWindow("about:blank", "_blank");
+  if (!oauthWindow) {
+    throw new Error("Could not open the Google sign-in window.");
+  }
+  return oauthWindow;
+}

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.