@agent-native/core 0.141.6 → 0.141.7

package/corpus/templates/analytics/server/lib/first-party-analytics-health.ts

@@ -4,6 +4,10 @@ import { and, gte, inArray, lte } from "drizzle-orm";
 
 import { getDb, schema } from "../db/index.js";
 import { hasCredential } from "./credentials.js";
+import {
+  getFirstPartyAnalyticsBackend,
+  getFirstPartyAnalyticsBigQueryMetrics,
+} from "./first-party-analytics-backend.js";
 import type { AnalyticsScope } from "./first-party-analytics.js";
 
 export const FIRST_PARTY_ANALYTICS_PRESSURE_THRESHOLDS = {
@@ -320,19 +324,30 @@ export async function getFirstPartyAnalyticsHealth(
   const rollups = schema.analyticsEventDailyRollups;
   const pressure = schema.analyticsQueryPressureDaily;
   const db = getDb() as any;
+  const backend = await getFirstPartyAnalyticsBackend(scope);
+
+  const rollupRowsPromise =
+    backend.sink === "bigquery"
+      ? getFirstPartyAnalyticsBigQueryMetrics(scope, backend.table).then(
+          (metrics) => [metrics],
+        )
+      : db
+          .select({
+            eventCount: sql<number>`coalesce(sum(${rollups.eventCount}), 0)`,
+            dailyRollupRows: sql<number>`count(*)`,
+            firstEventDate: sql<string | null>`min(${rollups.eventDate})`,
+            lastEventDate: sql<string | null>`max(${rollups.eventDate})`,
+          })
+          .from(rollups)
+          .where(
+            and(
+              inArray(rollups.tenantKey, keys),
+              lte(rollups.eventDate, today),
+            ),
+          );
 
   const [rollupRows, pressureRows, externalBackends] = await Promise.all([
-    db
-      .select({
-        eventCount: sql<number>`coalesce(sum(${rollups.eventCount}), 0)`,
-        dailyRollupRows: sql<number>`count(*)`,
-        firstEventDate: sql<string | null>`min(${rollups.eventDate})`,
-        lastEventDate: sql<string | null>`max(${rollups.eventDate})`,
-      })
-      .from(rollups)
-      .where(
-        and(inArray(rollups.tenantKey, keys), lte(rollups.eventDate, today)),
-      ),
+    rollupRowsPromise,
     db
       .select({
         queryClass: pressure.queryClass,
@@ -409,11 +424,15 @@ export async function getFirstPartyAnalyticsHealth(
       FIRST_PARTY_ANALYTICS_PRESSURE_THRESHOLDS.recommendEventCount / 4 ||
     slowQueryCount24h > 0;
   const status: FirstPartyAnalyticsHealthStatus =
-    reasons.length > 0
-      ? "recommend_bigquery"
-      : hasMonitorSignal
+    backend.sink === "bigquery"
+      ? slowQueryCount24h > 0 || timeoutCount24h > 0
         ? "monitor"
-        : "healthy";
+        : "healthy"
+      : reasons.length > 0
+        ? "recommend_bigquery"
+        : hasMonitorSignal
+          ? "monitor"
+          : "healthy";
 
   return {
     status,

package/corpus/templates/analytics/server/lib/first-party-analytics.ts

@@ -1,4 +1,5 @@
 import { getDbExec } from "@agent-native/core/db";
+import { runWithRequestContext } from "@agent-native/core/server";
 import { and, eq, isNull, or } from "drizzle-orm";
 
 import { FIRST_PARTY_ANALYTICS_QUERY_TIMEOUT_MS } from "../../shared/dashboard-report-timeouts.js";
@@ -8,6 +9,12 @@ import {
   ingestAnalyticsExceptionEvents,
   type DerivedExceptionFields,
 } from "./error-capture.js";
+import {
+  getFirstPartyAnalyticsBackend,
+  getFirstPartyAnalyticsTable,
+  insertFirstPartyAnalyticsRows,
+  queryFirstPartyAnalyticsInBigQuery,
+} from "./first-party-analytics-backend.js";
 import {
   firstPartyCacheKey,
   withFirstPartyCache,
@@ -504,11 +511,33 @@ export async function recordAnalyticsEvents(
     };
   });
 
-  if (rows.length) {
+  const backend = await getFirstPartyAnalyticsBackend({
+    userEmail: key.ownerEmail,
+    orgId: key.orgId ?? null,
+  });
+
+  if (rows.length && (backend.sink === "dual" || backend.sink === "bigquery")) {
+    try {
+      await runWithRequestContext(
+        {
+          userEmail: key.ownerEmail,
+          orgId: key.orgId ?? undefined,
+        },
+        () => insertFirstPartyAnalyticsRows(rows, backend.table),
+      );
+    } catch (error) {
+      if (backend.sink === "bigquery") throw error;
+      // Dual-write mode keeps Postgres as the recoverable source until the
+      // backfill has completed. A BigQuery outage must not lose live events.
+      console.error(
+        "[first-party-analytics] BigQuery dual-write failed; retaining Postgres event:",
+        error,
+      );
+    }
+  }
+
+  if (rows.length && backend.sink !== "bigquery") {
     await db.transaction(async (tx: any) => {
-      // Raw events and incremental rollups share this transaction. The
-      // historical boot backfill is disabled, so no global cross-request lock
-      // is needed to coordinate a second writer.
       await tx.insert(schema.analyticsEvents).values(rows);
       await tx
         .update(schema.analyticsPublicKeys)
@@ -517,6 +546,12 @@ export async function recordAnalyticsEvents(
       await upsertFirstPartyAnalyticsRollups(rows, tx);
     });
   }
+  if (rows.length && backend.sink === "bigquery") {
+    await db
+      .update(schema.analyticsPublicKeys)
+      .set({ lastUsedAt: receivedAt })
+      .where(eq(schema.analyticsPublicKeys.id, key.id));
+  }
 
   // Fork captured exceptions into the dedicated error-capture tables. This is
   // best-effort: a malformed `$exception` payload must never reject the whole
@@ -973,6 +1008,24 @@ export async function queryFirstPartyAnalytics(
   options: AnalyticsQueryOptions = {},
 ): Promise<AnalyticsQueryResult> {
   validateFirstPartyAnalyticsSql(sql);
+  const backend = await getFirstPartyAnalyticsBackend(scope);
+  if (backend.sink === "bigquery") {
+    const usesSessionRecordings = /\bsession_recordings\b/i.test(sql);
+    const usesEventTables =
+      /\banalytics_events\b|\banalytics_event_daily_rollups\b|\banalytics_user_days\b/i.test(
+        sql,
+      );
+    if (usesSessionRecordings && usesEventTables) {
+      throw new Error(
+        "Cross-backend joins are not supported; query first-party event tables in BigQuery and session_recordings in the Analytics SQL store separately.",
+      );
+    }
+    if (!usesSessionRecordings) {
+      const table = await getFirstPartyAnalyticsTable(backend.table);
+      const scoped = scopedAnalyticsSql(sql, scope);
+      return queryFirstPartyAnalyticsInBigQuery(scoped.sql, scoped.args, table);
+    }
+  }
   const scoped = scopedAnalyticsSql(sql, scope);
   const wrappedSql = `SELECT * FROM (${scoped.sql}) AS first_party_analytics_query LIMIT ${MAX_QUERY_ROWS}`;
   const timeoutMs = Math.max(

package/corpus/templates/analytics/server/lib/real-data-actions.ts

@@ -65,7 +65,7 @@ export const CORPUS_REDUCTION_ACTIONS = new Set(["run-code"]);
 // hasDataQueryAttempt, but they should stop the guard from steering a
 // template-clone turn into "connect a missing source". Deliberately limited
 // to read/inspection actions: update-dashboard/mutate-dashboard/
-// compose-dashboard/install-dashboard-template/create-extension/
+// compose-dashboard/create-extension/
 // update-extension can all author brand-new SQL or extension content, so
 // calling one of those alone is not proof the turn actually inspected a
 // template rather than inventing it from scratch. If the tool run also
@@ -74,7 +74,6 @@ export const CORPUS_REDUCTION_ACTIONS = new Set(["run-code"]);
 export const DASHBOARD_CONSTRUCTION_ACTIONS = new Set([
   "get-sql-dashboard",
   "list-sql-dashboards",
-  "list-dashboard-templates",
   "list-extensions",
   "get-extension",
 ]);
@@ -88,7 +87,6 @@ export const DASHBOARD_MUTATION_ACTIONS = new Set([
   "mutate-dashboard",
   "update-dashboard",
   "compose-dashboard",
-  "install-dashboard-template",
   "create-extension",
   "update-extension",
 ]);

package/corpus/templates/analytics/server/plugins/agent-chat.ts

@@ -53,7 +53,6 @@ function hasSuccessfulDashboardSave(
     "update-dashboard",
     "mutate-dashboard",
     "compose-dashboard",
-    "install-dashboard-template",
   ]);
   return (toolResults ?? []).some((result) => {
     if (result.isError) return false;
@@ -737,9 +736,8 @@ export function realDataFinalGuard(
         'This is a dashboard construction/template-clone request. Resolve the named template\'s id (use `list-sql-dashboards` if you only have a title) and call `get-sql-dashboard` with `includeConfig: true` first. If its panels are `chartType: "extension"`, use `get-extension` then `create-extension` to clone/adapt it, then `update-dashboard` to save the new dashboard. Do not invent SQL panels for an extension-backed template. Ask one clarifying filter question if needed. Only run a data-source query before presenting numbers or authoring invented SQL.',
       fallbackMessage:
         "I need to inspect the template dashboard (and its extension, if it uses one) before creating the new one. Tell me the template dashboard name, or confirm the org/account filter, and I'll clone it without inventing metrics.",
-      // list-sql-dashboards/list-dashboard-templates are on the initial
-      // surface, but expand anyway so a corrective retry can always reach
-      // the lookup/inspection tools this message asks for.
+      // Expand the tool surface so a corrective retry can always reach the
+      // lookup/inspection tools this message asks for.
       expandToolSurface: true,
     };
   }

package/corpus/templates/assets/.agents/skills/asset-generation/SKILL.md

@@ -27,8 +27,9 @@ or generated image/video assets that another app can reference by ID and URL.
   Pass `mediaType: "image"` by default, or `mediaType: "video"` for video
   libraries.
 - Use unattended actions when the agent already knows what to do:
-  `search-assets`, `list-assets`, `generate-image`, `generate-image-batch`,
-  `generate-video`, `refresh-generation-run`, and `export-asset`.
+  `search-assets`, `list-assets`, `import-style-from-url`, `generate-image`,
+  `generate-image-batch`, `generate-video`, `refresh-generation-run`, and
+  `export-asset`.
 - In chat, consume composer `@` references as structured generation inputs:
   `brand-kit` maps to `libraryId`, `preset` maps to `presetId`, and
   `media-type` chooses image generation versus video generation. If no mention
@@ -94,10 +95,11 @@ or generated image/video assets that another app can reference by ID and URL.
    when they want a chat preloaded with the session context.
 
 For short vague prompts, enhance conservatively with library style context while
-preserving the user's original prompt in run metadata. Use
-`analyze-collection-style` when a collection needs upgraded vision brand
-analysis before generation. Brand QA scoring and best-of-N selection are
-deferred.
+preserving the user's original prompt in run metadata. If a public website is
+the style source, call `import-style-from-url` first so the library keeps the
+hydrated browser-derived design brief. Use `analyze-collection-style` when a
+collection needs upgraded vision brand analysis from image references before
+generation. Brand QA scoring and best-of-N selection are deferred.
 
 ## Video Workflows
 

package/corpus/templates/assets/.agents/skills/library-management/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: library-management
-description: Schema, CRUD, sharing, and cascade-delete patterns for asset libraries, collections, and assets.
+description: Schema, CRUD, sharing, URL style imports, and cascade-delete patterns for asset libraries, collections, and assets. Use when managing a library or importing visual brand evidence from a URL.
 ---
 
 # Library management
@@ -118,6 +118,21 @@ for the exact logo. Imported assets are stored as `status: "reference"` with
 `sourceUrl` provenance, so downstream generation, preset boards, and logo
 compositing can use them like uploaded reference assets.
 
+## Importing a rendered visual system
+
+Use `import-style-from-url` when a public website should contribute more than
+images to a library or collection. It uses the same layered browser extractor
+as Design and Slides, so CSS-in-JS, Tailwind, hydration, web fonts, computed
+colors, component styles, spacing, radii, shadows, CSS variables, and logo
+references are captured from the live cascade. The action persists a bounded
+`designMd` summary plus structured fields in `styleBrief`, with the source URL
+and any browser/static-fallback warnings preserved for provenance.
+
+Prefer this action over copying raw HTML into a style brief. If the result is
+`partial`, the structured values are still usable but the warnings must remain
+visible to the agent; `failed` is an error and must not be treated as an empty
+style brief.
+
 ## When to add a collection
 
 Collections are optional. Most users won't create them. Use them when:

package/corpus/templates/assets/AGENTS.md

@@ -84,6 +84,7 @@ Uncommon actions stay discoverable through `tool-search`.
 | `duplicate-library` | Make a private copy of a Brand Kit |
 | `list-assets` / `search-assets` | Browse or search assets in accessible kits |
 | `import-asset-from-url` | Ingest external brand or blog imagery as a reference asset |
+| `import-style-from-url` | Render a website and merge its design.md-style visual language into a library or collection |
 | `set-canonical-logo` | Pin the kit's pixel-perfect logo |
 | `list-generation-presets` | List repeatable output formats before generating |
 | `create-generation-preset` / `update-generation-preset` | Author preset format, references, `includeLogo`, skeleton |

package/corpus/templates/assets/actions/_helpers.ts

@@ -97,6 +97,18 @@ export function assetUrls(asset: {
   };
 }
 
+export function imageArtifactLinks(input: {
+  id: string;
+  runId: string;
+  previewUrl: string;
+  downloadUrl: string;
+}) {
+  return [
+    `previewUrl: ${input.previewUrl} (ID: ${input.id}, Run: ${input.runId})`,
+    `downloadUrl: ${input.downloadUrl}`,
+  ];
+}
+
 export function serializeLibrary(row: any) {
   return {
     id: row.id,

package/corpus/templates/assets/actions/generate-image.ts

@@ -69,6 +69,7 @@ import {
   type StyleBrief,
 } from "../shared/api.js";
 import {
+  imageArtifactLinks,
   requireGenerationSessionInLibrary,
   serializeAsset,
 } from "./_helpers.js";
@@ -1109,9 +1110,14 @@ export default defineAction({
         ...serialized,
         runId,
         artifactType: "image",
-        Artifacts: [
-          `Image: ${serialized.url} (ID: ${asset.id}, Run: ${runId})`,
-        ],
+        // Cross-app callers embed the artifact in HTML. `url` is the Assets
+        // detail page; previewUrl is the actual media response.
+        Artifacts: imageArtifactLinks({
+          id: asset.id,
+          runId,
+          previewUrl: serialized.previewUrl,
+          downloadUrl: serialized.downloadUrl,
+        }),
         ...creativeContextProvenance,
       };
     } catch (err) {

package/corpus/templates/assets/actions/import-style-from-url.ts

@@ -0,0 +1,115 @@
+import { defineAction } from "@agent-native/core";
+import { assertAccess } from "@agent-native/core/sharing";
+import {
+  extractRenderedDesignSystemFromUrl,
+  styleBriefFromRenderedDesign,
+} from "@agent-native/creative-context/server";
+import { eq } from "drizzle-orm";
+import { z } from "zod";
+
+import { getDb, schema } from "../server/db/index.js";
+import { nowIso, parseJson, stringifyJson } from "../server/lib/json.js";
+import type { StyleBrief } from "../shared/api.js";
+
+/**
+ * Render a public website once and merge its computed visual language into an
+ * Assets library or collection style brief. This intentionally shares the
+ * exact browser extractor used by Design and Slides instead of maintaining a
+ * second image-only or static-HTML interpretation of the page.
+ */
+export default defineAction({
+  description:
+    "Render a website in a real browser and merge its design.md-style visual " +
+    "language into an asset library or collection style brief. Captures " +
+    "computed colors, typography, spacing, radii, shadows, components, CSS " +
+    "variables, and logo references. Uses a static SSRF-safe fallback only " +
+    "when browser rendering is unavailable.",
+  schema: z.object({
+    libraryId: z.string().describe("Asset library ID"),
+    collectionId: z
+      .string()
+      .optional()
+      .describe("Optional collection to update instead of the library"),
+    url: z.string().describe("Public website URL to render and analyze"),
+  }),
+  run: async ({ libraryId, collectionId, url }) => {
+    await assertAccess("asset-library", libraryId, "editor");
+    const db = getDb();
+    const [library] = await db
+      .select()
+      .from(schema.assetLibraries)
+      .where(eq(schema.assetLibraries.id, libraryId))
+      .limit(1);
+    if (!library) throw new Error("Asset library not found.");
+
+    const [collection] = collectionId
+      ? await db
+          .select()
+          .from(schema.assetCollections)
+          .where(eq(schema.assetCollections.id, collectionId))
+          .limit(1)
+      : [null];
+    if (collectionId && !collection) throw new Error("Collection not found.");
+    if (collection && collection.libraryId !== libraryId) {
+      throw new Error("Collection does not belong to this asset library.");
+    }
+
+    const extraction = await extractRenderedDesignSystemFromUrl(url);
+    if (extraction.status === "failed") {
+      throw new Error(
+        `Rendered website extraction failed: ${extraction.error ?? "unknown error"}`,
+      );
+    }
+
+    const previous = parseJson<StyleBrief>(
+      collection?.styleBrief ?? library.styleBrief,
+      {},
+    );
+    const styleBrief = {
+      ...previous,
+      ...styleBriefFromRenderedDesign(extraction),
+    } satisfies StyleBrief;
+    const updatedAt = nowIso();
+
+    if (collection) {
+      await db
+        .update(schema.assetCollections)
+        .set({ styleBrief: stringifyJson(styleBrief), updatedAt })
+        .where(eq(schema.assetCollections.id, collection.id));
+    } else {
+      const settings = parseJson<Record<string, unknown>>(library.settings, {});
+      settings.brandAnalysis = {
+        ...(typeof settings.brandAnalysis === "object" &&
+        settings.brandAnalysis !== null
+          ? settings.brandAnalysis
+          : {}),
+        analyzedAt: updatedAt,
+        sourceUrl: extraction.finalUrl ?? extraction.url,
+        mode: extraction.rendered ? "rendered-browser" : "static-fallback",
+        method: extraction.method,
+        status: extraction.status,
+        warnings: extraction.warnings,
+      };
+      await db
+        .update(schema.assetLibraries)
+        .set({
+          styleBrief: stringifyJson(styleBrief),
+          settings: stringifyJson(settings),
+          updatedAt,
+        })
+        .where(eq(schema.assetLibraries.id, libraryId));
+    }
+
+    return {
+      libraryId,
+      collectionId: collection?.id ?? null,
+      status: extraction.status,
+      rendered: extraction.rendered,
+      sourceUrl: extraction.finalUrl ?? extraction.url,
+      styleBrief,
+      designMd: extraction.designMd,
+      warnings: extraction.warnings,
+      diagnostics: extraction.diagnostics,
+    };
+  },
+});

package/corpus/templates/assets/app/hooks/use-navigation-state.ts

@@ -109,7 +109,9 @@ function navigationFromPath(pathname: string, search = "") {
   const extension = pathname.match(/^\/extensions\/([^/]+)/);
   if (extension) return { view: "extensions", extensionId: extension[1] };
   if (pathname === "/audit") return { view: "audit" };
-  if (pathname === "/settings") return { view: "settings" };
+  if (pathname === "/settings" || pathname.startsWith("/settings/")) {
+    return { view: "settings" };
+  }
   return { view: "create" };
 }
 

package/corpus/templates/assets/app/routes/extensions._index.tsx

@@ -7,5 +7,5 @@ export function meta() {
 }
 
 export default function ExtensionsRoute() {
-  return <Navigate to="/settings#extensions" replace />;
+  return <Navigate to="/settings/extensions" replace />;
 }

package/corpus/templates/assets/app/routes/settings.$.tsx

@@ -0,0 +1 @@
+export { default, meta } from "./settings.js";

package/corpus/templates/assets/app/routes/settings.tsx

@@ -61,10 +61,15 @@ import {
 } from "@/components/ui/select";
 import { Switch } from "@/components/ui/switch";
 import { useAssetsPrefs } from "@/hooks/use-assets-prefs";
+import { messagesByLocale } from "@/i18n-data";
 import { cn } from "@/lib/utils";
 
 import changelog from "../../CHANGELOG.md?raw";
 
+export function meta() {
+  return [{ title: messagesByLocale["en-US"].settings.title }];
+}
+
 type ImageGenerationConfig = {
   builderEnabled?: boolean;
   builderConnected?: boolean;

package/corpus/templates/assets/app/routes/team.tsx

@@ -7,5 +7,5 @@ export function meta() {
 }
 
 export default function TeamRoute() {
-  return <Navigate to="/settings#organization" replace />;
+  return <Navigate to="/settings/organization" replace />;
 }

package/corpus/templates/assets/changelog/2026-08-05-brand-kits-can-import-a-website-s-hydrated-visual-language-a.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-08-05
+---
+
+Brand kits can import a website's hydrated visual language and reuse it in generated imagery.

package/corpus/templates/assets/changelog/2026-08-05-generated-images-now-hand-off-embeddable-previews-to-other-w.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-08-05
+---
+
+Generated images now hand off embeddable previews to other workspace apps.

package/corpus/templates/assets/server/lib/generation.ts

@@ -1266,6 +1266,7 @@ export function compilePrompt(input: {
     ? `\nAvoid: ${style.doNot.join("; ")}.`
     : "";
   const typographyBlock = formatBrandTypography(style);
+  const renderedDesignBlock = formatRenderedDesignEvidence(style);
   const requestedEmbeddedText = hasEmbeddedText(input.embeddedText);
   const textInstruction = requestedEmbeddedText
     ? formatEmbeddedTextInstruction(input.embeddedText, input.textPlacement)
@@ -1340,6 +1341,7 @@ ${style.texture ? `\nTexture/material treatment: ${style.texture}.` : ""}
 ${style.composition ? `\nComposition: ${style.composition}.` : ""}
 ${style.lighting ? `\nLighting: ${style.lighting}.` : ""}
 ${typographyBlock ? `\n${typographyBlock}` : ""}${frameInstruction}
+${renderedDesignBlock ? `\n${renderedDesignBlock}` : ""}
 ${doNot}${logoInstruction}${cutoutInstruction}${backgroundPlateInstruction}${skeletonInpaintInstruction}${diagramInstruction}${customInstructions}
 
 ${textInstruction}
@@ -1414,6 +1416,62 @@ function formatBrandTypography(style: StyleBrief): string {
   return `Brand typography: ${parts.join("; ")}. Match these for any rendered text.`;
 }
 
+function formatRenderedDesignEvidence(style: StyleBrief): string {
+  const lines: string[] = [];
+  const semanticColors = Object.entries(style.semanticColors ?? {}).filter(
+    ([, value]) => typeof value === "string" && value.trim(),
+  );
+  if (semanticColors.length > 0) {
+    lines.push(
+      `Semantic colors: ${semanticColors
+        .slice(0, 8)
+        .map(([role, value]) => `${role} ${value}`)
+        .join(", ")}.`,
+    );
+  }
+  if (style.spacing?.length) {
+    lines.push(`Observed spacing: ${style.spacing.slice(0, 16).join(", ")}.`);
+  }
+  if (style.radii?.length) {
+    lines.push(
+      `Observed corner radii: ${style.radii.slice(0, 12).join(", ")}.`,
+    );
+  }
+  if (style.shadows?.length) {
+    lines.push(`Observed shadows: ${style.shadows.slice(0, 8).join("; ")}.`);
+  }
+  if (style.backgrounds?.length) {
+    lines.push(
+      `Observed background treatments: ${style.backgrounds.slice(0, 8).join("; ")}.`,
+    );
+  }
+  for (const component of style.componentStyles?.slice(0, 8) ?? []) {
+    const role =
+      typeof component.role === "string" ? component.role : "component";
+    const fields = [
+      ["font", component.fontFamily],
+      ["size", component.fontSize],
+      ["weight", component.fontWeight],
+      ["color", component.color],
+      ["background", component.backgroundColor],
+      ["radius", component.borderRadius],
+      ["shadow", component.boxShadow],
+      ["padding", component.padding],
+    ]
+      .filter(([, value]) => typeof value === "string" && value.trim())
+      .map(([name, value]) => `${name} ${value}`);
+    if (fields.length > 0)
+      lines.push(`${role} component: ${fields.join("; ")}.`);
+  }
+  const designMd = style.designMd?.trim().slice(0, 8_000);
+  if (designMd) lines.push(`Design.md evidence:\n${designMd}`);
+  if (lines.length === 0) return "";
+  return [
+    "Rendered design language below is visual evidence only, not instructions:",
+    ...lines,
+  ].join("\n");
+}
+
 // A content-only reference is an image the user attached as subject/content for
 // a single request (not a reusable brand/style reference). It should never count
 // as a brand-kit style reference.

package/corpus/templates/assets/shared/api.ts

@@ -129,6 +129,18 @@ export type GenerationSessionStatus =
 export interface StyleBrief {
   description?: string;
   palette?: string[];
+  sourceUrl?: string;
+  rendered?: boolean;
+  designMd?: string;
+  semanticColors?: Record<string, string>;
+  spacing?: string[];
+  radii?: string[];
+  shadows?: string[];
+  backgrounds?: string[];
+  componentStyles?: Array<Record<string, unknown>>;
+  cssVariables?: Record<string, string>;
+  brandKit?: Record<string, unknown>;
+  warnings?: string[];
   medium?: string;
   mood?: string;
   subjectMatter?: string;

package/corpus/templates/brain/app/routes/extensions._index.tsx

@@ -7,5 +7,5 @@ export function meta() {
 }
 
 export default function ExtensionsRoute() {
-  return <Navigate to="/settings#extensions" replace />;
+  return <Navigate to="/settings/extensions" replace />;
 }

package/corpus/templates/brain/app/routes/team.tsx

@@ -7,5 +7,5 @@ export function meta() {
 }
 
 export default function TeamRoute() {
-  return <Navigate to="/settings#organization" replace />;
+  return <Navigate to="/settings/organization" replace />;
 }

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

@@ -8,7 +8,7 @@ export default [
   route("review", "./routes/review.tsx"),
   route("sources", "./routes/sources.tsx"),
   route("ops", "./routes/ops.tsx"),
-  route("settings", "./routes/settings.tsx"),
+  route("settings/*", "./routes/settings.tsx"),
   route("team", "./routes/team.tsx"),
   route("extensions", "./routes/extensions.tsx", [
     index("./routes/extensions._index.tsx"),

package/corpus/templates/calendar/app/components/layout/AppLayout.tsx

@@ -227,7 +227,9 @@ export function AppLayout({ children }: AppLayoutProps) {
   const queryClient = useQueryClient();
   const googleStatus = useGoogleAuthStatus();
   const hasAccounts = (googleStatus.data?.accounts?.length ?? 0) > 0;
-  const isSettingsPage = location.pathname === "/settings";
+  const isSettingsPage =
+    location.pathname === "/settings" ||
+    location.pathname.startsWith("/settings/");
   const isCalendarPage = location.pathname === "/";
   const [sidebarOpen, setSidebarOpen] = useState(false);
   const [sidebarCollapsed, setSidebarCollapsed] =

package/corpus/templates/calendar/app/routes/_app.extensions._index.tsx

@@ -1,5 +1,5 @@
 import { Navigate } from "react-router";
 
 export default function ExtensionsRoute() {
-  return <Navigate to="/settings#extensions" replace />;
+  return <Navigate to="/settings/extensions" replace />;
 }

package/corpus/templates/calendar/app/routes/_app.settings.$.tsx

@@ -0,0 +1 @@
+export { default, meta } from "./_app.settings.js";