@agent-native/core 0.140.0 → 0.141.0

package/corpus/templates/clips/server/lib/emails.ts

@@ -1,256 +0,0 @@
-/**
- * Catalog entries for the transactional emails Clips sends.
- *
- * Registered from `server/plugins/transactional-emails.ts` so Dispatch can list
- * and preview them without the app having sent anything yet.
- *
- * Every entry except the organization invite renders through
- * `renderClipsTransactionalEmail`, so a preview shows the real template rather
- * than a copy of it.
- */
-
-import { defineTransactionalEmail } from "@agent-native/core/email-catalog";
-
-import { renderClipsInviteEmail } from "../../actions/invite-member.js";
-import {
-  CLIPS_ACTIVITY_COMMENT_EMAIL_ID,
-  CLIPS_ACTIVITY_REACTION_EMAIL_ID,
-  CLIPS_FIRST_AGENT_VIEW_EMAIL_ID,
-  CLIPS_FIRST_IMPORT_EMAIL_ID,
-  CLIPS_FIRST_VIEW_EMAIL_ID,
-  CLIPS_MONTHLY_RECAP_EMAIL_ID,
-  CLIPS_TWO_CLIPS_EMAIL_ID,
-  CLIPS_UNVIEWED_REMINDER_EMAIL_ID,
-  renderClipsTransactionalEmail,
-  type ClipsTransactionalEmailInput,
-  type ClipsTransactionalEmailRenderOptions,
-} from "./transactional-email-templates.js";
-
-/** Obviously-fake sample data — these render in a preview pane, never send. */
-const PREVIEW_OPTIONS: ClipsTransactionalEmailRenderOptions = {
-  appUrl: "https://example.com",
-};
-const SAMPLE_RECORDING_ID = "rec_sample";
-const SAMPLE_TITLE = "Onboarding walkthrough";
-const SAMPLE_TO = "sam.rivera@example.com";
-
-function preview(input: ClipsTransactionalEmailInput) {
-  return renderClipsTransactionalEmail(input, PREVIEW_OPTIONS);
-}
-
-export const CLIPS_ORGANIZATION_INVITE_EMAIL_ID = "clips.organization-invite";
-
-/**
- * How the shared Clips sender resolves From and Reply-To for every kind it
- * renders, so each entry can say so without restating the mechanism.
- */
-const CLIPS_SENDER =
-  'From is the configured EMAIL_FROM with the display name "Agent-Native Clips"; on first-party agent-native.com deployments it becomes clips@agent-native.com. Reply-to is hello@agent-native.com.';
-
-let registered = false;
-
-export function registerClipsEmails(): void {
-  if (registered) return;
-  registered = true;
-
-  defineTransactionalEmail({
-    id: CLIPS_FIRST_VIEW_EMAIL_ID,
-    name: "First view on a Clip",
-    trigger:
-      "The background transactional-email sweep finds the first counted view of a Clip by someone other than its owner, recorded after transactional email was switched on. One per Clip.",
-    recipientLabel: "Clip owner",
-    recipient:
-      "The Clip's owner. Suppressed recipient addresses are skipped, and the send is dropped if the owner is no longer the recording's owner at send time.",
-    senderLabel: "Agent-Native Clips",
-    sender: CLIPS_SENDER,
-    preview: () =>
-      preview({
-        kind: "first-view",
-        to: SAMPLE_TO,
-        recordingId: SAMPLE_RECORDING_ID,
-        title: SAMPLE_TITLE,
-        viewerEmail: "alex.chen@example.com",
-      }),
-  });
-
-  defineTransactionalEmail({
-    id: CLIPS_UNVIEWED_REMINDER_EMAIL_ID,
-    name: "Unviewed Clip reminder",
-    trigger:
-      "A direct share is 48 hours old and the recipient still has no counted view of that Clip. Re-checked at send time, so a view in the meantime cancels it.",
-    recipientLabel: "Shared-with address",
-    recipient:
-      "The address the Clip was directly shared with. Requires the share to still exist.",
-    senderLabel: "Sharer via Clips",
-    sender:
-      'Same as the other Clips emails, except the display name becomes "<sharer> (via Agent-Native Clips)" and reply-to is the sharer\'s own address when it is a valid address, falling back to hello@agent-native.com.',
-    preview: () =>
-      preview({
-        kind: "unviewed-reminder",
-        to: SAMPLE_TO,
-        recordingId: SAMPLE_RECORDING_ID,
-        title: SAMPLE_TITLE,
-        senderEmail: "dana.hill@example.com",
-        senderName: "Dana Hill",
-      }),
-  });
-
-  defineTransactionalEmail({
-    id: CLIPS_FIRST_AGENT_VIEW_EMAIL_ID,
-    name: "First agent read of a Clip",
-    trigger:
-      "An AI agent reads one of an owner's Clips for the first time since transactional email was switched on. One per owner, not per Clip.",
-    recipientLabel: "Clip owner",
-    recipient:
-      "The owner of the Clip the agent read. Re-checked at send time against the owner's actual first agent view.",
-    senderLabel: "Agent-Native Clips",
-    sender: CLIPS_SENDER,
-    preview: () =>
-      preview({
-        kind: "first-agent-view",
-        to: SAMPLE_TO,
-        recordingId: SAMPLE_RECORDING_ID,
-        title: SAMPLE_TITLE,
-        agentName: "Claude Code",
-      }),
-  });
-
-  defineTransactionalEmail({
-    id: CLIPS_FIRST_IMPORT_EMAIL_ID,
-    name: "First imported video is ready",
-    trigger:
-      "An owner's first imported (rather than recorded) video finishes processing and becomes ready. One per owner.",
-    recipientLabel: "Clip owner",
-    recipient:
-      "The owner of the imported recording, re-checked at send time so a later import does not resend.",
-    senderLabel: "Agent-Native Clips",
-    sender: CLIPS_SENDER,
-    preview: () =>
-      preview({
-        kind: "first-import",
-        to: SAMPLE_TO,
-        recordingId: SAMPLE_RECORDING_ID,
-        title: "Quarterly demo recording",
-      }),
-  });
-
-  defineTransactionalEmail({
-    id: CLIPS_MONTHLY_RECAP_EMAIL_ID,
-    name: "Monthly Clips recap",
-    trigger:
-      "Once per owner per calendar month, from 14:00 UTC on the 1st, for owners whose Clips had any human views or agent reads in the closed month. Metrics and the top Clip are recomputed at send time.",
-    recipientLabel: "Clip owner",
-    recipient:
-      "The Clip owner whose audience the recap reports. Suppressed addresses are skipped.",
-    senderLabel: "Agent-Native Clips",
-    sender: CLIPS_SENDER,
-    preview: () =>
-      preview({
-        kind: "monthly-recap",
-        to: SAMPLE_TO,
-        month: "2025-02",
-        humanViews: 42,
-        agentSessions: 7,
-        topClip: {
-          recordingId: SAMPLE_RECORDING_ID,
-          title: SAMPLE_TITLE,
-          thumbnailUrl: "https://example.com/thumbnails/sample.png",
-          durationMs: 214_000,
-          recordedAt: "2025-02-11T16:00:00.000Z",
-          humanViews: 18,
-          agentSessions: 4,
-        },
-        copy: {
-          heroLine: "Your clips were watched 42 times. 7 agents read them.",
-          completionNote: "68% average completion · most stopped at 2:31",
-          agentBreakdown: "4 from Claude Code · 3 unidentified",
-        },
-      }),
-  });
-
-  defineTransactionalEmail({
-    id: CLIPS_TWO_CLIPS_EMAIL_ID,
-    name: "Two Clips received",
-    trigger:
-      "A one-time nudge once someone who owns no Clips of their own has had two distinct Clips directly shared with them. The summary line is AI-generated before the job is released to send.",
-    recipientLabel: "Shared-with address",
-    recipient:
-      "The shared-with address. Dropped at send time if they now own a Clip or no longer hold both shares.",
-    senderLabel: "Agent-Native Clips",
-    sender: CLIPS_SENDER,
-    preview: () =>
-      preview({
-        kind: "two-clips",
-        to: SAMPLE_TO,
-        generatedSummary:
-          "Two teammates walked you through the new onboarding flow.",
-      }),
-  });
-
-  defineTransactionalEmail({
-    id: CLIPS_ACTIVITY_COMMENT_EMAIL_ID,
-    name: "Clip comment",
-    trigger:
-      "Someone comments or replies on a Clip. Subject and copy differ slightly for a reply; both send under this id.",
-    recipientLabel: "Owner and thread authors",
-    recipient:
-      "The recording owner, plus every prior author in the thread when the comment is a reply. The list is re-checked against the recording's live ACL and filtered by each user's `emailNotifications` preference; the comment's own author never receives it.",
-    senderLabel: "Agent-Native Clips",
-    sender: CLIPS_SENDER,
-    preview: () =>
-      preview({
-        kind: "activity-comment",
-        to: SAMPLE_TO,
-        recordingId: SAMPLE_RECORDING_ID,
-        title: SAMPLE_TITLE,
-        authorEmail: "alex.chen@example.com",
-        authorName: "Alex Chen",
-        content: "The step at 1:20 is the part new hires always miss.",
-        videoTimestampMs: 80_000,
-        isReply: false,
-      }),
-  });
-
-  defineTransactionalEmail({
-    id: CLIPS_ACTIVITY_REACTION_EMAIL_ID,
-    name: "Clip reaction",
-    trigger: "A viewer reacts with an emoji on a Clip.",
-    recipientLabel: "Clip owner",
-    recipient:
-      "The recording owner plus any extra recipients the caller passes, re-checked against the recording's live ACL and filtered by each user's `emailNotifications` preference. The reacting viewer never receives it.",
-    senderLabel: "Agent-Native Clips",
-    sender: CLIPS_SENDER,
-    preview: () =>
-      preview({
-        kind: "activity-reaction",
-        to: SAMPLE_TO,
-        recordingId: SAMPLE_RECORDING_ID,
-        title: SAMPLE_TITLE,
-        emoji: "🎉",
-        authorEmail: "alex.chen@example.com",
-        authorName: "Alex Chen",
-        videoTimestampMs: 45_000,
-      }),
-  });
-
-  defineTransactionalEmail({
-    id: CLIPS_ORGANIZATION_INVITE_EMAIL_ID,
-    name: "Organization invitation",
-    trigger:
-      "An organization admin runs `invite-member`. Any earlier pending invite for the same address is cancelled first, so a re-invite sends a fresh email with a new token.",
-    recipientLabel: "Invited address",
-    recipient:
-      "The address passed to the action, exactly as typed. One email per invite.",
-    senderLabel: "Default sender",
-    sender:
-      "The configured default sender. This call site sets no `from`, `fromName`, `replyTo`, or `appSender`, so unlike the other Clips emails it does not send as Agent-Native Clips.",
-    preview: () =>
-      renderClipsInviteEmail({
-        appName: "Clips",
-        orgName: "Northwind Design",
-        inviter: "dana.hill@example.com",
-        role: "member",
-        inviteUrl: "https://example.com/invite/sample-token",
-      }),
-  });
-}

package/corpus/templates/clips/server/plugins/transactional-email-catalog.ts

@@ -1,5 +0,0 @@
-import { registerClipsEmails } from "../lib/emails.js";
-
-export default function registerTransactionalEmailCatalog(): void {
-  registerClipsEmails();
-}

package/corpus/templates/content/server/lib/emails.ts

@@ -1,70 +0,0 @@
-/**
- * Catalog entries for the transactional emails Documents sends.
- *
- * Registered from `server/plugins/transactional-emails.ts` so Dispatch can list
- * and preview them without the app having sent anything yet.
- */
-
-import { defineTransactionalEmail } from "@agent-native/core/email-catalog";
-
-import { renderDocumentCommentEmail } from "./comment-notifications.js";
-
-/** Obviously-fake sample data — these render in a preview pane, never send. */
-const SAMPLE_TITLE = "Q3 launch brief";
-const SAMPLE_URL = "https://example.com/page/doc_sample";
-const SAMPLE_COMMENT =
-  "Can we tighten the second paragraph? It repeats the intro.";
-
-export const CONTENT_DOCUMENT_COMMENT_EMAIL_ID = "content.document-comment";
-export const CONTENT_DOCUMENT_MENTION_EMAIL_ID = "content.document-mention";
-
-let registered = false;
-
-export function registerContentEmails(): void {
-  if (registered) return;
-  registered = true;
-
-  defineTransactionalEmail({
-    id: CONTENT_DOCUMENT_COMMENT_EMAIL_ID,
-    name: "Document comment",
-    trigger:
-      "Someone posts a comment or a thread reply on a document. Sent to recipients who were not mentioned in it; the copy and subject differ slightly for a reply.",
-    recipientLabel: "Owner and thread authors",
-    recipient:
-      "The document owner, plus every prior author in the thread when the new comment is a reply. The list is re-checked against the document's live ACL and filtered by each user's `emailNotifications` preference; the comment's own author never receives it.",
-    senderLabel: "Default sender",
-    sender:
-      "The configured default sender. This call site sets no `from`, `fromName`, `replyTo`, or `appSender`.",
-    preview: () =>
-      renderDocumentCommentEmail({
-        actor: "Sam Rivera",
-        title: SAMPLE_TITLE,
-        url: SAMPLE_URL,
-        content: SAMPLE_COMMENT,
-        isReply: false,
-        wasMentioned: false,
-      }),
-  });
-
-  defineTransactionalEmail({
-    id: CONTENT_DOCUMENT_MENTION_EMAIL_ID,
-    name: "Document mention",
-    trigger:
-      "A comment or reply mentions someone by email. Sent instead of the plain comment notification to each mentioned recipient.",
-    recipientLabel: "Mentioned users",
-    recipient:
-      "The mentioned addresses supplied by the caller, re-checked against the document's live ACL and filtered by each user's `emailNotifications` preference.",
-    senderLabel: "Default sender",
-    sender:
-      "The configured default sender. This call site sets no `from`, `fromName`, `replyTo`, or `appSender`.",
-    preview: () =>
-      renderDocumentCommentEmail({
-        actor: "Sam Rivera",
-        title: SAMPLE_TITLE,
-        url: SAMPLE_URL,
-        content: SAMPLE_COMMENT,
-        isReply: false,
-        wasMentioned: true,
-      }),
-  });
-}

package/corpus/templates/content/server/plugins/transactional-emails.ts

@@ -1,5 +0,0 @@
-import { registerContentEmails } from "../lib/emails.js";
-
-export default function registerTransactionalEmails(): void {
-  registerContentEmails();
-}

package/corpus/templates/design/app/components/design/edit-panel/design-system-swatches.ts

@@ -1,215 +0,0 @@
-import { parseCssColorExtended, rgbaToHex } from "@shared/color-utils";
-
-/** One colour token from the design's linked Brand Kit, as the kit names it. */
-export interface DesignSystemColorSwatch {
-  name: string;
-  cssVar: string;
-  value: string;
-  group?: string;
-  source?: string;
-}
-
-interface IndexedToken {
-  name: string;
-  cssVar: string;
-  value: string;
-  type: string;
-  group?: string;
-  source?: string;
-  origin?: string;
-}
-
-/** Extended: the classifier stores `oklch()`/`color()` tokens as colours. */
-function normalizeHex(value: string): string | null {
-  const parsed = parseCssColorExtended(value.trim());
-  return parsed ? rgbaToHex(parsed).toUpperCase() : null;
-}
-
-/** Guards a cyclic alias chain (`--a: var(--b); --b: var(--a)`). */
-const MAX_ALIAS_DEPTH = 8;
-
-/**
- * A token's value as a paintable literal, following aliases through the kit's
- * own vocabulary. A kit legitimately defines one token as another, and dropping
- * those loses a selectable token; painting them raw gives an empty swatch.
- */
-function paintableTokenValue(
-  value: string,
-  byCssVar: ReadonlyMap<string, string>,
-  depth = 0,
-): string | null {
-  if (normalizeHex(value)) return value;
-  if (depth >= MAX_ALIAS_DEPTH) return null;
-  const reference = parseTokenReference(value);
-  if (!reference) return null;
-
-  const aliased = byCssVar.get(reference.cssVar);
-  if (aliased !== undefined) {
-    const resolved = paintableTokenValue(aliased, byCssVar, depth + 1);
-    if (resolved) return resolved;
-  }
-  return reference.fallback
-    ? paintableTokenValue(reference.fallback, byCssVar, depth + 1)
-    : null;
-}
-
-/**
- * The linked kit's swatchable colour tokens from an `index-design-tokens`
- * result, which mixes the design's own `:root` colours into the same list.
- * Values that resolve to no colour at all are dropped, since they would paint
- * an empty swatch.
- */
-export function toDesignSystemColorSwatches(
-  tokens: readonly IndexedToken[] | undefined,
-  limit = 48,
-): DesignSystemColorSwatch[] {
-  if (!tokens) return [];
-  // Every token, not just kit ones: a kit alias may point at a design `:root`
-  // variable, and that still resolves to a real colour.
-  const byCssVar = new Map(tokens.map((token) => [token.cssVar, token.value]));
-  const seen = new Set<string>();
-  const out: DesignSystemColorSwatch[] = [];
-
-  for (const token of tokens) {
-    if (token.type !== "color") continue;
-    if (token.origin !== "brand-kit") continue;
-    const value = paintableTokenValue(token.value, byCssVar);
-    if (!value) continue;
-    if (seen.has(token.cssVar)) continue;
-    seen.add(token.cssVar);
-    out.push({
-      name: token.name,
-      cssVar: token.cssVar,
-      value,
-      ...(token.group ? { group: token.group } : {}),
-      ...(token.source ? { source: token.source } : {}),
-    });
-    if (out.length >= limit) break;
-  }
-
-  return out;
-}
-
-/**
- * What to call a token in the picker: its CSS variable, minus the leading `--`.
- *
- * The indexed `name` is title-cased for tokens the kit never named ("Color
- * Primary"), which reads as a different vocabulary than the kit's own
- * `cds-background-brand` sitting next to it. The variable is what the design
- * references, so it is the name worth showing.
- */
-export function swatchLabel(swatch: DesignSystemColorSwatch): string {
-  return swatch.cssVar.replace(/^--/, "");
-}
-
-const TOKEN_REFERENCE_HEAD = /^var\(\s*(--[-_a-zA-Z0-9]+)\s*(,?)/;
-
-export interface TokenReference {
-  cssVar: string;
-  /** Literal after the comma. Absent for a bare `var(--x)`. */
-  fallback: string | null;
-}
-
-/**
- * A fallback is itself a CSS value, so it can nest parentheses. Scanning to the
- * balanced close rather than matching `[^()]+` is what keeps a function-valued
- * token from reading as "not a token" and being dropped by the commit guard.
- */
-export function parseTokenReference(value: string): TokenReference | null {
-  const trimmed = value.trim();
-  const head = TOKEN_REFERENCE_HEAD.exec(trimmed);
-  if (!head) return null;
-
-  let depth = 1;
-  let index = head[0].length;
-  for (; index < trimmed.length && depth > 0; index += 1) {
-    const char = trimmed[index];
-    if (char === "(") depth += 1;
-    else if (char === ")") depth -= 1;
-  }
-  // Anything after the matching `)` means this is not a lone reference.
-  if (depth !== 0 || index !== trimmed.length) return null;
-
-  const fallback = trimmed.slice(head[0].length, index - 1).trim();
-  if (fallback && !head[2]) return null;
-  return { cssVar: head[1], fallback: fallback || null };
-}
-
-/**
- * The declaration to persist for a picked token.
- *
- * The fallback is not optional padding: outside the editor — an export, a
- * published page, a design whose kit link was removed — nothing defines the
- * custom property, and a bare `var(--x)` renders transparent.
- */
-export function tokenReferenceValue(swatch: DesignSystemColorSwatch): string {
-  return `var(${swatch.cssVar}, ${swatch.value})`;
-}
-
-const HIDDEN_TOKEN_MIX =
-  /^color-mix\(\s*in\s+srgb\s*,\s*(var\(.+\))\s+0%\s*,\s*transparent\s*\)$/i;
-
-/**
- * What to write when hiding a colour. Zeroing alpha needs literal channels,
- * which a `var()` reference has none of — so a token is hidden as a 0% mix that
- * keeps the reference inside the persisted CSS. React state would not survive
- * the deselect/reselect that unmounts the inspector.
- */
-export function hiddenColorWrite(
-  color: string,
-  zeroAlpha: (literal: string) => string | null,
-): string {
-  const reference = parseTokenReference(color);
-  if (reference) return `color-mix(in srgb, ${color} 0%, transparent)`;
-  return zeroAlpha(color) ?? "transparent";
-}
-
-/** The reference a hidden token colour carries, or null if it is not one. */
-export function hiddenTokenReference(value: string): string | null {
-  return HIDDEN_TOKEN_MIX.exec(value.trim())?.[1] ?? null;
-}
-
-/**
- * Name the token a value came from, or null when that cannot be known. A
- * `var()` reference names itself; a bare colour is matched by value, and a tie
- * returns null — Carbon points four tokens at one blue.
- */
-export function resolveTokenNameForColor(
-  value: string,
-  swatches: readonly DesignSystemColorSwatch[],
-): string | null {
-  const reference = parseTokenReference(value);
-  if (reference) return reference.cssVar.replace(/^--/, "");
-
-  const target = normalizeHex(value);
-  if (!target) return null;
-
-  let match: string | null = null;
-  for (const swatch of swatches) {
-    if (normalizeHex(swatch.value) !== target) continue;
-    if (match) return null;
-    match = swatchLabel(swatch);
-  }
-  return match;
-}
-
-/** Group swatches under their kit collection path, preserving token order. */
-export function groupColorSwatches(
-  swatches: readonly DesignSystemColorSwatch[],
-): { label: string | null; swatches: DesignSystemColorSwatch[] }[] {
-  const groups = new Map<
-    string,
-    { label: string | null; swatches: DesignSystemColorSwatch[] }
-  >();
-  for (const swatch of swatches) {
-    const label = swatch.group?.trim() || null;
-    const key = label ?? "";
-    const existing = groups.get(key);
-    if (existing) {
-      existing.swatches.push(swatch);
-      continue;
-    }
-    groups.set(key, { label, swatches: [swatch] });
-  }
-  return [...groups.values()];
-}

package/corpus/templates/design/changelog/2026-08-04-design-system-tokens-show-by-name-in-the-editor.md

@@ -1,6 +0,0 @@
----
-type: added
-date: 2026-08-04
----
-
-Design system tokens now show by name across the Brand Kit page and the fill, stroke, effects, page background and selection colour rows, so a colour reads as `cds-link-primary` instead of `0F62FE`.

package/corpus/templates/design/server/lib/design-system-tokens.ts

@@ -1,35 +0,0 @@
-import {
-  describeBrandKitTokenRejections,
-  normalizeBrandKitTokens,
-} from "@agent-native/core/brand-kit/tokens";
-
-/**
- * Reject a write whose named tokens cannot be stored verbatim. Keeping the
- * storable subset would read downstream as a genuinely smaller design system.
- */
-export function assertStorableDesignSystemTokens(dataJson: string): void {
-  let parsed: unknown;
-  try {
-    parsed = JSON.parse(dataJson);
-  } catch {
-    throw new Error("data must be a valid JSON object string");
-  }
-  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-    throw new Error("data must be a valid JSON object string");
-  }
-
-  const tokens = (parsed as Record<string, unknown>).tokens;
-  if (tokens === undefined) return;
-
-  const { rejected } = normalizeBrandKitTokens(tokens);
-  if (rejected.length > 0) {
-    throw new Error(
-      `data.tokens contains ${rejected.length} entr${
-        rejected.length === 1 ? "y" : "ies"
-      } that cannot be stored: ${describeBrandKitTokenRejections(rejected)}. ` +
-        "Each token needs a name, a CSS custom property (-- followed by " +
-        "letters, digits, hyphens or underscores), and a value with no " +
-        '";", "{", "}", "<", ">", or CSS comment.',
-    );
-  }
-}