@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/jobs/ai-theme-brand-inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-theme-brand-inputs.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { checkEntitlement } from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport type {\n  AglynOrgBilling,\n  OrgBrandingProfile,\n} from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport { normalizeThemeHex } from '../tools/ai-theme-tool'\nimport { AI_THEME_BRAND_BUDGET_MS } from './ai-job-theme-budget'\nimport {\n  aiMediaAssetLocation,\n  loadAiMediaSharp,\n  readAiMediaAssetBytes,\n  type AiMediaAssetLocation,\n} from './ai-media-asset'\n\n/**\n * The brand a theme job builds on (AGL-2938): the colors that belong to the\n * site before anyone describes them.\n *\n * - **The workspace's brand color** — a white-label workspace's, and only\n *   theirs: without the entitlement the resolved profile is the platform's,\n *   which is no customer's brand.\n * - **The site logo** — when the logo is an asset of the site's own media\n *   library or its org's, read from storage and reduced to its dominant\n *   colors. Never fetched from a URL: a logo that is not a library asset is\n *   left alone.\n * - **A page the brief links to** — fetched through the same SSRF guard the\n *   plugin fetch proxy uses (a public address, pinned; https only; every\n *   redirect re-validated), capped in bytes and time, and reduced to the\n *   colors its markup and stylesheets use.\n *\n * Only hex colors leave this module. Nothing a page or a logo SAYS reaches a\n * prompt, so there is nothing in them to follow. Each source is best effort:\n * one that cannot be read is named in a note and the proposal is made\n * without it.\n */\n\nexport type AiThemeBrandSource = 'organization' | 'logo' | 'reference'\n\n/** How the prompt names where each brand color came from. */\nexport const AI_THEME_BRAND_SOURCE_WORDS: Record<AiThemeBrandSource, string> = {\n  organization: 'the workspace brand color',\n  logo: 'from the site logo',\n  reference: 'from the page the brief links to',\n}\n\nexport interface AiThemeBrandColor {\n  hex: string\n  source: AiThemeBrandSource\n}\n\nexport interface AiThemeBrandInputs {\n  colors: AiThemeBrandColor[]\n  /** A source that could not be read, in customer-safe words. */\n  notes: string[]\n}\n\n/** The most colors one source contributes. */\nexport const AI_THEME_BRAND_COLORS_PER_SOURCE = 4\n\n/** The largest logo decoded for its colors. */\nexport const AI_THEME_LOGO_MAX_BYTES = 5 * 1024 * 1024\n\n/** The most of a linked page, and of each of its stylesheets, that is read. */\nexport const AI_THEME_REFERENCE_MAX_BYTES = 512 * 1024\nexport const AI_THEME_STYLESHEET_MAX_BYTES = 256 * 1024\n\n/** The stylesheets of a linked page that are read beside it. */\nexport const AI_THEME_REFERENCE_STYLESHEETS = 2\n\n/**\n * The wall clock brand colors may take, declared with the theme step's time\n * (`ai-job-theme-budget.ts`), which counts it (AGL-3035).\n */\nexport { AI_THEME_BRAND_BUDGET_MS }\n\nconst FETCH_TIMEOUT_MS = 4_000\nconst MAX_REDIRECT_HOPS = 3\nconst REDIRECT_STATUSES = new Set([301, 302, 303, 307, 308])\n\ntype Rgb = [red: number, green: number, blue: number]\n\nconst toHex = ([red, green, blue]: Rgb) =>\n  `#${[red, green, blue]\n    .map((channel) => Math.round(Math.min(255, Math.max(0, channel))).toString(16).padStart(2, '0'))\n    .join('')}`\n\nconst channelsOf = (hex: string): Rgb => [\n  parseInt(hex.slice(1, 3), 16),\n  parseInt(hex.slice(3, 5), 16),\n  parseInt(hex.slice(5, 7), 16),\n]\n\nconst distance = (a: Rgb, b: Rgb) => Math.hypot(a[0] - b[0], a[1] - b[1], a[2] - b[2])\n\n/** How far a color is from grey: the spread of its channels. */\nconst chroma = ([red, green, blue]: Rgb) => Math.max(red, green, blue) - Math.min(red, green, blue)\n\n/** Colors closer than this read as the same color in a palette. */\nconst SAME_COLOR_DISTANCE = 40\n\n/** A spread under this reads as a grey, which says little about a brand. */\nconst GREY_CHROMA = 38\n\n/** The distinct colors of a ranked list, colorful ones first when there are any. */\nfunction distinctColors(ranked: readonly Rgb[], count: number): string[] {\n  const colorful = ranked.filter((color) => chroma(color) > GREY_CHROMA)\n  const chosen: Rgb[] = []\n  for (const color of colorful.length ? colorful : ranked) {\n    if (chosen.some((other) => distance(other, color) < SAME_COLOR_DISTANCE)) continue\n    chosen.push(color)\n    if (chosen.length === count) break\n  }\n  return chosen.map(toHex)\n}\n\n/* ------------------------------------------------------------------------ *\n * The workspace's brand color\n * ------------------------------------------------------------------------ */\n\n/** A white-label workspace's own brand color; nothing for any other workspace. */\nexport function organizationBrandColors(\n  org: Partial<AglynOrgBilling> | null | undefined,\n): AiThemeBrandColor[] {\n  if (!checkEntitlement(org, 'whiteLabel')) return []\n  const raw = (org?.brandingProfile as OrgBrandingProfile | undefined)?.primaryColor\n  const hex = typeof raw === 'string' ? normalizeThemeHex(raw) : null\n  return hex ? [{ hex, source: 'organization' }] : []\n}\n\n/* ------------------------------------------------------------------------ *\n * The site logo\n * ------------------------------------------------------------------------ */\n\nexport type AiThemeLogoLocation = AiMediaAssetLocation\n\n/**\n * Where a site's logo lives in a media library: a media reference or a CDN\n * path naming this site's library, or its org's. Anything else — an external\n * URL, an asset of some other site or org — has no location, and the logo is\n * left alone. The media library's own rule, shared with every job that reads\n * an asset (`ai-media-asset.ts`).\n */\nexport const logoMediaLocation = aiMediaAssetLocation\n\n/**\n * The dominant colors of an image's pixels: transparent pixels skipped, the\n * rest grouped into coarse buckets, the busiest distinct buckets first, and\n * the near-white and near-black edges a logo sits on dropped while anything\n * else is there.\n */\nexport function dominantColorsFromPixels(\n  data: ArrayLike<number>,\n  channels: number,\n  count = AI_THEME_BRAND_COLORS_PER_SOURCE,\n): string[] {\n  const buckets = new Map<number, { sum: Rgb; pixels: number }>()\n  for (let index = 0; index + channels <= data.length; index += channels) {\n    if (channels >= 4 && data[index + 3] < 128) continue\n    const pixel: Rgb = [data[index], data[index + 1], data[index + 2]]\n    const key = ((pixel[0] >> 4) << 8) | ((pixel[1] >> 4) << 4) | (pixel[2] >> 4)\n    const bucket = buckets.get(key) ?? { sum: [0, 0, 0] as Rgb, pixels: 0 }\n    bucket.sum = [bucket.sum[0] + pixel[0], bucket.sum[1] + pixel[1], bucket.sum[2] + pixel[2]]\n    bucket.pixels += 1\n    buckets.set(key, bucket)\n  }\n  const ranked = [...buckets.values()]\n    .sort((a, b) => b.pixels - a.pixels)\n    .map(({ sum, pixels }): Rgb => [sum[0] / pixels, sum[1] / pixels, sum[2] / pixels])\n  const edge = (color: Rgb) => Math.min(...color) > 235 || Math.max(...color) < 20\n  const inside = ranked.filter((color) => !edge(color))\n  return distinctColors(inside.length ? inside : ranked, count)\n}\n\n/** The part of `sharp` the logo read uses. */\ninterface SharpPixelPipeline {\n  resize(width: number, height: number, options: { fit: 'inside' }): SharpPixelPipeline\n  ensureAlpha(): SharpPixelPipeline\n  raw(): SharpPixelPipeline\n  toBuffer(options: { resolveWithObject: true }): Promise<{\n    data: Buffer\n    info: { channels: number }\n  }>\n}\ntype SharpPixels = (input: Buffer, options?: { limitInputPixels?: number }) => SharpPixelPipeline\n\nconst LOGO_TYPES = /^image\\/(png|jpeg|webp|gif|avif|svg\\+xml)$/\n\n/**\n * A library logo's colors, read the way the media CDN would serve it\n * (`readAiMediaAssetBytes`). `null` when the asset may not be read or the bytes\n * cannot be decoded.\n */\nasync function readLogoColors(\n  firestore: FirebaseFirestore.Firestore,\n  location: AiThemeLogoLocation,\n  hostId: string,\n): Promise<string[] | null> {\n  const asset = await readAiMediaAssetBytes(firestore, location, hostId, {\n    maxBytes: AI_THEME_LOGO_MAX_BYTES,\n    types: LOGO_TYPES,\n  })\n  if (!asset) return null\n  const sharp = (await loadAiMediaSharp()) as SharpPixels\n  const { data, info } = await sharp(asset.buffer, { limitInputPixels: 64_000_000 })\n    .resize(48, 48, { fit: 'inside' })\n    .ensureAlpha()\n    .raw()\n    .toBuffer({ resolveWithObject: true })\n  return dominantColorsFromPixels(data, info.channels)\n}\n\n/* ------------------------------------------------------------------------ *\n * A page the brief links to\n * ------------------------------------------------------------------------ */\n\nconst URL_IN_BRIEF = /\\bhttps?:\\/\\/[^\\s<>\"'`)\\]]+/i\n\n/** The first https link in a brief, or `null` — an http link is not followed. */\nexport function referenceUrlOf(brief: string): URL | null {\n  const match = URL_IN_BRIEF.exec(brief)\n  if (!match) return null\n  try {\n    const url = new URL(match[0].replace(/[.,;:!?]+$/, ''))\n    return url.protocol === 'https:' ? url : null\n  } catch {\n    return null\n  }\n}\n\n/** How much a page's declared `theme-color` counts beside one use of a color. */\nexport const AI_THEME_THEME_COLOR_WEIGHT = 25\n\nconst THEME_COLOR_META = /<meta\\b[^>]*\\bname\\s*=\\s*[\"']?theme-color\\b[^>]*>/gi\nconst CONTENT_ATTRIBUTE = /\\bcontent\\s*=\\s*[\"']?\\s*([^\"'\\s>]+)/i\n// A `#` after `&` is a character reference (`&#039;`), not a color.\nconst HEX_LITERAL = /(?<!&)#(?:[0-9a-f]{6}|[0-9a-f]{3})(?![0-9a-z])/gi\nconst RGB_LITERAL = /rgba?\\(\\s*(\\d{1,3})\\s*[,\\s]\\s*(\\d{1,3})\\s*[,\\s]\\s*(\\d{1,3})/gi\n\n/** Every color a page's markup or a stylesheet uses, weighted by how often. */\nexport function colorsFromMarkup(text: string): Map<string, number> {\n  const weights = new Map<string, number>()\n  const add = (hex: string | null, weight: number) => {\n    if (hex) weights.set(hex, (weights.get(hex) ?? 0) + weight)\n  }\n  for (const tag of text.match(THEME_COLOR_META) ?? []) {\n    add(normalizeThemeHex(CONTENT_ATTRIBUTE.exec(tag)?.[1] ?? ''), AI_THEME_THEME_COLOR_WEIGHT)\n  }\n  for (const match of text.matchAll(HEX_LITERAL)) add(normalizeThemeHex(match[0]), 1)\n  for (const match of text.matchAll(RGB_LITERAL)) {\n    add(toHex([Number(match[1]), Number(match[2]), Number(match[3])]), 1)\n  }\n  return weights\n}\n\nconst STYLESHEET_LINK = /<link\\b[^>]*\\brel\\s*=\\s*[\"']?stylesheet\\b[^>]*>/gi\nconst HREF_ATTRIBUTE = /\\bhref\\s*=\\s*[\"']?\\s*([^\"'\\s>]+)/i\n\n/** The https stylesheets a page links, resolved against it, at most a few. */\nexport function stylesheetUrlsOf(html: string, pageUrl: string): string[] {\n  const urls: string[] = []\n  for (const tag of html.match(STYLESHEET_LINK) ?? []) {\n    const href = HREF_ATTRIBUTE.exec(tag)?.[1]\n    if (!href) continue\n    try {\n      const url = new URL(href, pageUrl)\n      if (url.protocol === 'https:' && !urls.includes(url.toString())) urls.push(url.toString())\n    } catch {\n      continue\n    }\n    if (urls.length === AI_THEME_REFERENCE_STYLESHEETS) break\n  }\n  return urls\n}\n\n/** The most used distinct colors, the colorful before the greys. */\nexport function rankBrandColors(\n  weights: ReadonlyMap<string, number>,\n  count = AI_THEME_BRAND_COLORS_PER_SOURCE,\n): string[] {\n  const ranked = [...weights.entries()]\n    .sort((a, b) => b[1] - a[1])\n    .map(([hex]) => channelsOf(hex))\n  return distinctColors(ranked, count)\n}\n\n/** One abort for the caller's signal and a clock, whichever ends first. */\nfunction deadline(signal: AbortSignal | undefined, ms: number) {\n  const controller = new AbortController()\n  const timer = setTimeout(() => controller.abort(), ms)\n  const onAbort = () => controller.abort()\n  if (signal?.aborted) controller.abort()\n  signal?.addEventListener('abort', onAbort)\n  return {\n    signal: controller.signal,\n    done: () => {\n      clearTimeout(timer)\n      signal?.removeEventListener('abort', onAbort)\n    },\n  }\n}\n\nasync function readCapped(body: ReadableStream<Uint8Array>, maxBytes: number): Promise<string> {\n  const reader = body.getReader()\n  const chunks: Uint8Array[] = []\n  let total = 0\n  for (;;) {\n    const { done, value } = await reader.read()\n    if (done || !value) break\n    const room = maxBytes - total\n    if (value.byteLength >= room) {\n      chunks.push(value.subarray(0, room))\n      await reader.cancel().catch(() => undefined)\n      break\n    }\n    chunks.push(value)\n    total += value.byteLength\n  }\n  const joined = new Uint8Array(chunks.reduce((sum, chunk) => sum + chunk.byteLength, 0))\n  let offset = 0\n  for (const chunk of chunks) {\n    joined.set(chunk, offset)\n    offset += chunk.byteLength\n  }\n  return new TextDecoder().decode(joined)\n}\n\n/**\n * A public https resource as text, through the plugin fetch proxy's SSRF\n * guard: the host must resolve only to public addresses and the socket is\n * pinned to the address checked; no credentials in the URL and no port but\n * the default; every redirect re-enters the same checks; the body is read to\n * a byte cap under a clock, and only a content type the caller accepts is\n * read at all. `null` for anything that does not hold.\n */\nexport async function fetchPublicText(\n  url: string,\n  options: { maxBytes: number; accept: RegExp; signal?: AbortSignal; timeoutMs?: number },\n): Promise<{ text: string; url: string } | null> {\n  const { createPinnedDispatcher, resolvePublicIp } = await import('./ai-theme-brand-server')\n  let current = url\n  for (let hop = 0; hop <= MAX_REDIRECT_HOPS; hop += 1) {\n    let parsed: URL\n    try {\n      parsed = new URL(current)\n    } catch {\n      return null\n    }\n    if (parsed.protocol !== 'https:' || parsed.username || parsed.password) return null\n    if (parsed.port && parsed.port !== '443') return null\n    const pinned = await resolvePublicIp(parsed.hostname)\n    if (!pinned) return null\n    const dispatcher = createPinnedDispatcher(pinned)\n    const clock = deadline(options.signal, options.timeoutMs ?? FETCH_TIMEOUT_MS)\n    try {\n      // `dispatcher` is undici's, which the global fetch honors; a variable\n      // rather than a literal keeps the DOM `RequestInit` check off it.\n      const init = {\n        method: 'GET',\n        redirect: 'manual' as const,\n        signal: clock.signal,\n        dispatcher,\n        headers: { Accept: 'text/html, text/css;q=0.9' },\n      }\n      const response = await fetch(parsed.toString(), init as RequestInit)\n      if (REDIRECT_STATUSES.has(response.status)) {\n        const location = response.headers.get('location')\n        if (!location) return null\n        current = new URL(location, parsed).toString()\n        continue\n      }\n      if (!response.ok || !response.body) return null\n      if (!options.accept.test(response.headers.get('content-type') ?? '')) return null\n      return { text: await readCapped(response.body, options.maxBytes), url: parsed.toString() }\n    } catch {\n      return null\n    } finally {\n      clock.done()\n      await dispatcher.close().catch(() => undefined)\n    }\n  }\n  return null\n}\n\n/** A linked page's colors, from its markup and its first stylesheets. */\nasync function readReferenceColors(url: URL, signal: AbortSignal): Promise<string[] | null> {\n  const page = await fetchPublicText(url.toString(), {\n    maxBytes: AI_THEME_REFERENCE_MAX_BYTES,\n    accept: /text\\/html|application\\/xhtml\\+xml/i,\n    signal,\n  })\n  if (!page) return null\n  const weights = colorsFromMarkup(page.text)\n  for (const sheet of stylesheetUrlsOf(page.text, page.url)) {\n    const css = await fetchPublicText(sheet, {\n      maxBytes: AI_THEME_STYLESHEET_MAX_BYTES,\n      accept: /text\\/css/i,\n      signal,\n    })\n    if (!css) continue\n    for (const [hex, weight] of colorsFromMarkup(css.text)) {\n      weights.set(hex, (weights.get(hex) ?? 0) + weight)\n    }\n  }\n  return rankBrandColors(weights)\n}\n\n/* ------------------------------------------------------------------------ *\n * Gathering\n * ------------------------------------------------------------------------ */\n\n/** The two reads that leave the process, replaceable where a spec needs to. */\nexport interface AiThemeBrandSeams {\n  logoColors?: (\n    firestore: FirebaseFirestore.Firestore,\n    location: AiThemeLogoLocation,\n    hostId: string,\n  ) => Promise<string[] | null>\n  referenceColors?: (url: URL, signal: AbortSignal) => Promise<string[] | null>\n}\n\nexport async function gatherAiThemeBrandInputs(\n  input: {\n    firestore: FirebaseFirestore.Firestore\n    org: Partial<AglynOrgBilling> | null\n    hostId: string\n    /** The site's host document. */\n    host: Record<string, unknown>\n    brief: string\n    signal?: AbortSignal\n  },\n  seams: AiThemeBrandSeams = {},\n): Promise<AiThemeBrandInputs> {\n  const colors: AiThemeBrandColor[] = [...organizationBrandColors(input.org)]\n  const notes: string[] = []\n  const clock = deadline(input.signal, AI_THEME_BRAND_BUDGET_MS)\n  const add = (found: readonly string[], source: AiThemeBrandSource) => {\n    for (const hex of found.slice(0, AI_THEME_BRAND_COLORS_PER_SOURCE)) {\n      if (!colors.some((color) => color.hex === hex)) colors.push({ hex, source })\n    }\n  }\n  try {\n    const location = logoMediaLocation(\n      input.host['logoUrl'],\n      input.hostId,\n      String(input.host['orgId'] ?? ''),\n    )\n    if (location) {\n      const found = await (seams.logoColors ?? readLogoColors)(\n        input.firestore,\n        location,\n        input.hostId,\n      ).catch(() => null)\n      if (found) add(found, 'logo')\n      else notes.push(\"The site logo's colors could not be read, so the proposal does not use them.\")\n    }\n    const reference = referenceUrlOf(input.brief)\n    if (reference) {\n      const found = clock.signal.aborted\n        ? null\n        : await (seams.referenceColors ?? readReferenceColors)(reference, clock.signal).catch(\n            () => null,\n          )\n      if (found?.length) add(found, 'reference')\n      else {\n        notes.push(\n          `The page at ${reference.hostname} could not be read for its colors, so the proposal does not use them.`,\n        )\n      }\n    }\n  } finally {\n    clock.done()\n  }\n  return { colors, notes }\n}\n"],"names":["checkEntitlement","normalizeThemeHex","AI_THEME_BRAND_BUDGET_MS","aiMediaAssetLocation","loadAiMediaSharp","readAiMediaAssetBytes","AI_THEME_BRAND_SOURCE_WORDS","organization","logo","reference","AI_THEME_BRAND_COLORS_PER_SOURCE","AI_THEME_LOGO_MAX_BYTES","AI_THEME_REFERENCE_MAX_BYTES","AI_THEME_STYLESHEET_MAX_BYTES","AI_THEME_REFERENCE_STYLESHEETS","FETCH_TIMEOUT_MS","MAX_REDIRECT_HOPS","REDIRECT_STATUSES","Set","toHex","red","green","blue","map","channel","Math","round","min","max","toString","padStart","join","channelsOf","hex","parseInt","slice","distance","a","b","hypot","chroma","SAME_COLOR_DISTANCE","GREY_CHROMA","distinctColors","ranked","count","colorful","filter","color","chosen","length","some","other","push","organizationBrandColors","org","raw","brandingProfile","primaryColor","source","logoMediaLocation","dominantColorsFromPixels","data","channels","buckets","Map","index","pixel","key","bucket","get","sum","pixels","set","values","sort","edge","inside","LOGO_TYPES","readLogoColors","firestore","location","hostId","asset","maxBytes","types","sharp","info","buffer","limitInputPixels","resize","fit","ensureAlpha","toBuffer","resolveWithObject","URL_IN_BRIEF","referenceUrlOf","brief","match","exec","url","URL","replace","protocol","AI_THEME_THEME_COLOR_WEIGHT","THEME_COLOR_META","CONTENT_ATTRIBUTE","HEX_LITERAL","RGB_LITERAL","colorsFromMarkup","text","weights","add","weight","tag","matchAll","Number","STYLESHEET_LINK","HREF_ATTRIBUTE","stylesheetUrlsOf","html","pageUrl","urls","href","includes","rankBrandColors","entries","deadline","signal","ms","controller","AbortController","timer","setTimeout","abort","onAbort","aborted","addEventListener","done","clearTimeout","removeEventListener","readCapped","body","reader","getReader","chunks","total","value","read","room","byteLength","subarray","cancel","catch","undefined","joined","Uint8Array","reduce","chunk","offset","TextDecoder","decode","fetchPublicText","options","createPinnedDispatcher","resolvePublicIp","current","hop","parsed","username","password","port","pinned","hostname","dispatcher","clock","timeoutMs","response","init","method","redirect","headers","Accept","fetch","has","status","ok","accept","test","close","readReferenceColors","page","sheet","css","gatherAiThemeBrandInputs","input","seams","colors","notes","found","host","String","logoColors","referenceColors"],"mappings":"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"}

package/src/lib/jobs/ai-theme-brand-server.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * The server helpers the theme brand reads defer (AGL-2938).
+ *
+ * A theme job loads the pinned fetch only when it actually reads a page the
+ * brief links to, so `ai-theme-brand-inputs` defers it; a logo is read through
+ * the media library's own read, which defers its storage helpers from
+ * `ai-media-asset-server.ts`. The deferral has to target THIS module by
+ * relative path. Nx treats a workspace lib that is ever `import()`ed by its
+ * package specifier as lazy-loaded everywhere, and
+ * `@nx/enforce-module-boundaries` then forbids every static import of
+ * `@aglyn/tenant-data-admin` across the plugin, the console and the tenant —
+ * the constraint `report-server-error.ts` documents in both apps. A relative
+ * specifier crosses no project boundary, so nx records no lazy edge.
+ *
+ * Import this module dynamically, and only from the brand reads.
+ */
+export { createPinnedDispatcher, resolvePublicIp, } from '@aglyn/tenant-data-admin/server/serve-plugin-fetch';

package/src/lib/jobs/ai-theme-brand-server.js

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * The server helpers the theme brand reads defer (AGL-2938).
+ *
+ * A theme job loads the pinned fetch only when it actually reads a page the
+ * brief links to, so `ai-theme-brand-inputs` defers it; a logo is read through
+ * the media library's own read, which defers its storage helpers from
+ * `ai-media-asset-server.ts`. The deferral has to target THIS module by
+ * relative path. Nx treats a workspace lib that is ever `import()`ed by its
+ * package specifier as lazy-loaded everywhere, and
+ * `@nx/enforce-module-boundaries` then forbids every static import of
+ * `@aglyn/tenant-data-admin` across the plugin, the console and the tenant —
+ * the constraint `report-server-error.ts` documents in both apps. A relative
+ * specifier crosses no project boundary, so nx records no lazy edge.
+ *
+ * Import this module dynamically, and only from the brand reads.
+ */ export { createPinnedDispatcher, resolvePublicIp } from "@aglyn/tenant-data-admin/server/serve-plugin-fetch";
+
+//# sourceMappingURL=ai-theme-brand-server.js.map

package/src/lib/jobs/ai-theme-brand-server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-theme-brand-server.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * The server helpers the theme brand reads defer (AGL-2938).\n *\n * A theme job loads the pinned fetch only when it actually reads a page the\n * brief links to, so `ai-theme-brand-inputs` defers it; a logo is read through\n * the media library's own read, which defers its storage helpers from\n * `ai-media-asset-server.ts`. The deferral has to target THIS module by\n * relative path. Nx treats a workspace lib that is ever `import()`ed by its\n * package specifier as lazy-loaded everywhere, and\n * `@nx/enforce-module-boundaries` then forbids every static import of\n * `@aglyn/tenant-data-admin` across the plugin, the console and the tenant —\n * the constraint `report-server-error.ts` documents in both apps. A relative\n * specifier crosses no project boundary, so nx records no lazy edge.\n *\n * Import this module dynamically, and only from the brand reads.\n */\nexport {\n  createPinnedDispatcher,\n  resolvePublicIp,\n} from '@aglyn/tenant-data-admin/server/serve-plugin-fetch'\n"],"names":["createPinnedDispatcher","resolvePublicIp"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;CAeC,GACD,SACEA,sBAAsB,EACtBC,eAAe,QACV,qDAAoD"}

package/src/lib/jobs/ai-workflow-records.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { HostAction } from '@aglyn/aglyn/app-utils/actions';
+import type { HostWorkflow } from '@aglyn/aglyn/app-utils/workflows';
+import type { AiAutomationNamedRecord, AiAutomationRecords } from '../model/ai-automation-draft';
+import type { AiRunRecord } from '../model/ai-automation-outline';
+import type { AiWorkflowTargetType } from '../model/ai-workflow-job';
+/**
+ * What a `workflow` job reads (AGL-2919), through the Admin SDK and scoped to
+ * the job's own site and org: the records a drafted automation's words are
+ * looked up among, the automation an explanation reads, and the run it
+ * explains. Every read is a projection of the fields named here, windowed the
+ * way the Actions editor's pickers are, so a lookup never reads more than the
+ * editor would offer.
+ */
+type Firestore = FirebaseFirestore.Firestore;
+/** Records of one kind a lookup reads: the Actions editor's picker window. */
+export declare const AI_WORKFLOW_RECORDS_WINDOW = 100;
+/** Pipelines a stage lookup reads. */
+export declare const AI_WORKFLOW_PIPELINES_WINDOW = 20;
+/**
+ * The site's records a drafted automation may name. Stages are read only for
+ * a workspace with the CRM, whose pipelines they are; a site without it has
+ * no stage a condition could name. `only`, when given, names the kinds to
+ * read, and every other kind is answered empty without a read.
+ */
+export declare function readAiAutomationRecords(firestore: Firestore, input: {
+    orgId: string;
+    hostId: string;
+    crm: boolean;
+    only?: ReadonlyArray<keyof AiAutomationRecords>;
+}): Promise<AiAutomationRecords>;
+/** The site's functions, for a workflow outline that says which of its calls still resolve. */
+export declare function readAiWorkflowFunctions(firestore: Firestore, hostId: string): Promise<AiAutomationNamedRecord[]>;
+export type AiWorkflowTarget = {
+    type: 'action';
+    id: string;
+    name: string;
+    action: HostAction;
+} | {
+    type: 'workflow';
+    id: string;
+    name: string;
+    workflow: HostWorkflow;
+};
+/** A saved automation of the site, or `null` for one that does not exist or was deleted. */
+export declare function readAiWorkflowTarget(firestore: Firestore, input: {
+    hostId: string;
+    type: AiWorkflowTargetType;
+    id: string;
+}): Promise<AiWorkflowTarget | null>;
+export type AiWorkflowRunRead = {
+    ok: true;
+    run: AiRunRecord;
+} | {
+    ok: false;
+    reason: 'gone' | 'not-failed';
+};
+/**
+ * One run of an automation, as the site's activity log recorded it: gone when
+ * there is no such entry or it belongs to another automation, and refused
+ * when it did not fail. Only what the run history shows is read — never the
+ * event's payload.
+ */
+export declare function readAiWorkflowRun(firestore: Firestore, input: {
+    hostId: string;
+    targetId: string;
+    runId: string;
+}): Promise<AiWorkflowRunRead>;
+export {};

package/src/lib/jobs/ai-workflow-records.js

@@ -0,0 +1,158 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { actionRunResult } from "@aglyn/aglyn/app-utils/activity-presenter";
+import { datasetDisplayName } from "@aglyn/aglyn/app-utils/datasets";
+import { isFormArchived } from "@aglyn/aglyn/app-utils/forms";
+import { scopedToHost } from "@aglyn/tenant-data-admin/server/organizations";
+/** Records of one kind a lookup reads: the Actions editor's picker window. */ export const AI_WORKFLOW_RECORDS_WINDOW = 100;
+/** Pipelines a stage lookup reads. */ export const AI_WORKFLOW_PIPELINES_WINDOW = 20;
+function text(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+async function named(query, fields, keep, nameOf) {
+    const snapshot = await query.select(...fields).limit(AI_WORKFLOW_RECORDS_WINDOW).get();
+    return snapshot.docs.map((doc)=>{
+        var _doc_data;
+        return {
+            data: (_doc_data = doc.data()) != null ? _doc_data : {},
+            id: doc.id
+        };
+    }).filter(({ data })=>keep(data)).map(({ data, id })=>({
+            id,
+            name: nameOf(data, id)
+        })).filter((record)=>record.name);
+}
+const live = (data)=>data['deletedAt'] == null;
+/** The site's forms that are not archived, with the field names their submissions carry. */ async function readForms(host) {
+    const snapshot = await host.collection('forms').select('displayName', 'slug', 'fields', 'archivedAt').limit(AI_WORKFLOW_RECORDS_WINDOW).get();
+    return snapshot.docs.filter((doc)=>{
+        var _doc_data;
+        return !isFormArchived((_doc_data = doc.data()) != null ? _doc_data : {});
+    }).map((doc)=>{
+        var _doc_data;
+        const data = (_doc_data = doc.data()) != null ? _doc_data : {};
+        return {
+            id: doc.id,
+            name: text(data['displayName']) || text(data['slug']) || doc.id,
+            fields: (Array.isArray(data['fields']) ? data['fields'] : []).map((field)=>text(field == null ? void 0 : field['fieldName'])).filter(Boolean)
+        };
+    });
+}
+/**
+ * The site's records a drafted automation may name. Stages are read only for
+ * a workspace with the CRM, whose pipelines they are; a site without it has
+ * no stage a condition could name. `only`, when given, names the kinds to
+ * read, and every other kind is answered empty without a read.
+ */ export async function readAiAutomationRecords(firestore, input) {
+    const host = firestore.collection('hosts').doc(input.hostId);
+    const org = firestore.collection('orgs').doc(input.orgId);
+    const wanted = (kind)=>!input.only || input.only.includes(kind);
+    const none = Promise.resolve([]);
+    const [forms, datasets, lists, campaigns, workflows, webhooks, stages] = await Promise.all([
+        !wanted('forms') ? Promise.resolve([]) : readForms(host),
+        !wanted('datasets') ? none : named(scopedToHost(org.collection('datasets'), input.hostId), [
+            'displayName',
+            'name',
+            'deletedAt'
+        ], live, (data, id)=>datasetDisplayName(data) || id),
+        !wanted('lists') ? none : named(org.collection('lists'), [
+            'name',
+            'deletedAt'
+        ], live, (data)=>text(data['name'])),
+        !wanted('campaigns') ? none : named(host.collection('emailCampaigns'), [
+            'name',
+            'deletedAt'
+        ], live, (data)=>text(data['name'])),
+        !wanted('workflows') ? none : named(host.collection('workflows'), [
+            'name',
+            'deletedAt'
+        ], live, (data)=>text(data['name'])),
+        !wanted('webhooks') ? none : named(host.collection('webhooks'), [
+            'name',
+            'direction',
+            'deletedAt'
+        ], (data)=>live(data) && data['direction'] === 'outbound', (data)=>text(data['name'])),
+        input.crm && wanted('stages') ? scopedToHost(org.collection('pipelines'), input.hostId).select('stages', 'archivedAt').limit(AI_WORKFLOW_PIPELINES_WINDOW).get().then((snapshot)=>snapshot.docs.filter((doc)=>!(Number(doc.get('archivedAt')) > 0)).flatMap((doc)=>Array.isArray(doc.get('stages')) ? doc.get('stages') : []).map((stage)=>({
+                    id: text(stage == null ? void 0 : stage['id']),
+                    name: text(stage == null ? void 0 : stage['name'])
+                })).filter((stage)=>stage.id && stage.name)) : none
+    ]);
+    return {
+        forms,
+        datasets,
+        lists,
+        campaigns,
+        workflows,
+        webhooks,
+        stages
+    };
+}
+/** The site's functions, for a workflow outline that says which of its calls still resolve. */ export async function readAiWorkflowFunctions(firestore, hostId) {
+    return named(firestore.collection('hosts').doc(hostId).collection('functions'), [
+        'name',
+        'deletedAt'
+    ], live, (data)=>text(data['name']));
+}
+/** A saved automation of the site, or `null` for one that does not exist or was deleted. */ export async function readAiWorkflowTarget(firestore, input) {
+    var _snapshot_data;
+    const collection = input.type === 'action' ? 'actions' : 'workflows';
+    const snapshot = await firestore.collection('hosts').doc(input.hostId).collection(collection).doc(input.id).get();
+    const data = snapshot.exists ? (_snapshot_data = snapshot.data()) != null ? _snapshot_data : {} : null;
+    if (!data || data['deletedAt'] != null) return null;
+    const name = text(data['name']) || input.id;
+    return input.type === 'action' ? {
+        type: 'action',
+        id: snapshot.id,
+        name,
+        action: data
+    } : {
+        type: 'workflow',
+        id: snapshot.id,
+        name,
+        workflow: data
+    };
+}
+/**
+ * One run of an automation, as the site's activity log recorded it: gone when
+ * there is no such entry or it belongs to another automation, and refused
+ * when it did not fail. Only what the run history shows is read — never the
+ * event's payload.
+ */ export async function readAiWorkflowRun(firestore, input) {
+    var _snapshot_data;
+    const snapshot = await firestore.collection('hosts').doc(input.hostId).collection('activity').doc(input.runId).get();
+    const data = snapshot.exists ? (_snapshot_data = snapshot.data()) != null ? _snapshot_data : {} : null;
+    const target = data == null ? void 0 : data['target'];
+    if (!data || (target == null ? void 0 : target.id) !== input.targetId) return {
+        ok: false,
+        reason: 'gone'
+    };
+    const run = {
+        result: data['result'],
+        trigger: data['trigger'],
+        summary: data['summary'],
+        action: data['action'],
+        createdAt: data['createdAt']
+    };
+    return actionRunResult(run) === 'failed' ? {
+        ok: true,
+        run
+    } : {
+        ok: false,
+        reason: 'not-failed'
+    };
+}
+
+//# sourceMappingURL=ai-workflow-records.js.map

package/src/lib/jobs/ai-workflow-records.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-workflow-records.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { HostAction } from '@aglyn/aglyn/app-utils/actions'\nimport { actionRunResult } from '@aglyn/aglyn/app-utils/activity-presenter'\nimport { datasetDisplayName } from '@aglyn/aglyn/app-utils/datasets'\nimport { isFormArchived } from '@aglyn/aglyn/app-utils/forms'\nimport type { HostWorkflow } from '@aglyn/aglyn/app-utils/workflows'\nimport { scopedToHost } from '@aglyn/tenant-data-admin/server/organizations'\nimport type {\n  AiAutomationForm,\n  AiAutomationNamedRecord,\n  AiAutomationRecords,\n} from '../model/ai-automation-draft'\nimport type { AiRunRecord } from '../model/ai-automation-outline'\nimport type { AiWorkflowTargetType } from '../model/ai-workflow-job'\n\n/**\n * What a `workflow` job reads (AGL-2919), through the Admin SDK and scoped to\n * the job's own site and org: the records a drafted automation's words are\n * looked up among, the automation an explanation reads, and the run it\n * explains. Every read is a projection of the fields named here, windowed the\n * way the Actions editor's pickers are, so a lookup never reads more than the\n * editor would offer.\n */\n\ntype Firestore = FirebaseFirestore.Firestore\ntype Data = Record<string, unknown>\n\n/** Records of one kind a lookup reads: the Actions editor's picker window. */\nexport const AI_WORKFLOW_RECORDS_WINDOW = 100\n\n/** Pipelines a stage lookup reads. */\nexport const AI_WORKFLOW_PIPELINES_WINDOW = 20\n\nfunction text(value: unknown): string {\n  return typeof value === 'string' ? value.trim() : ''\n}\n\nasync function named(\n  query: FirebaseFirestore.Query,\n  fields: string[],\n  keep: (data: Data) => boolean,\n  nameOf: (data: Data, id: string) => string,\n): Promise<AiAutomationNamedRecord[]> {\n  const snapshot = await query\n    .select(...fields)\n    .limit(AI_WORKFLOW_RECORDS_WINDOW)\n    .get()\n  return snapshot.docs\n    .map((doc) => ({ data: (doc.data() ?? {}) as Data, id: doc.id }))\n    .filter(({ data }) => keep(data))\n    .map(({ data, id }) => ({ id, name: nameOf(data, id) }))\n    .filter((record) => record.name)\n}\n\nconst live = (data: Data) => data['deletedAt'] == null\n\n/** The site's forms that are not archived, with the field names their submissions carry. */\nasync function readForms(host: FirebaseFirestore.DocumentReference): Promise<AiAutomationForm[]> {\n  const snapshot = await host\n    .collection('forms')\n    .select('displayName', 'slug', 'fields', 'archivedAt')\n    .limit(AI_WORKFLOW_RECORDS_WINDOW)\n    .get()\n  return snapshot.docs\n    .filter((doc) => !isFormArchived((doc.data() ?? {}) as { archivedAt?: unknown }))\n    .map((doc) => {\n      const data = (doc.data() ?? {}) as Data\n      return {\n        id: doc.id,\n        name: text(data['displayName']) || text(data['slug']) || doc.id,\n        fields: (Array.isArray(data['fields']) ? (data['fields'] as Data[]) : [])\n          .map((field) => text(field?.['fieldName']))\n          .filter(Boolean),\n      }\n    })\n}\n\n/**\n * The site's records a drafted automation may name. Stages are read only for\n * a workspace with the CRM, whose pipelines they are; a site without it has\n * no stage a condition could name. `only`, when given, names the kinds to\n * read, and every other kind is answered empty without a read.\n */\nexport async function readAiAutomationRecords(\n  firestore: Firestore,\n  input: { orgId: string; hostId: string; crm: boolean; only?: ReadonlyArray<keyof AiAutomationRecords> },\n): Promise<AiAutomationRecords> {\n  const host = firestore.collection('hosts').doc(input.hostId)\n  const org = firestore.collection('orgs').doc(input.orgId)\n  const wanted = (kind: keyof AiAutomationRecords) => !input.only || input.only.includes(kind)\n  const none = Promise.resolve([] as AiAutomationNamedRecord[])\n  const [forms, datasets, lists, campaigns, workflows, webhooks, stages] = await Promise.all([\n    !wanted('forms') ? Promise.resolve([] as AiAutomationForm[]) : readForms(host),\n    !wanted('datasets')\n      ? none\n      : named(\n          scopedToHost(org.collection('datasets'), input.hostId),\n          ['displayName', 'name', 'deletedAt'],\n          live,\n          (data, id) => datasetDisplayName(data) || id,\n        ),\n    !wanted('lists') ? none : named(org.collection('lists'), ['name', 'deletedAt'], live, (data) => text(data['name'])),\n    !wanted('campaigns')\n      ? none\n      : named(host.collection('emailCampaigns'), ['name', 'deletedAt'], live, (data) => text(data['name'])),\n    !wanted('workflows')\n      ? none\n      : named(host.collection('workflows'), ['name', 'deletedAt'], live, (data) => text(data['name'])),\n    !wanted('webhooks')\n      ? none\n      : named(\n          host.collection('webhooks'),\n          ['name', 'direction', 'deletedAt'],\n          (data) => live(data) && data['direction'] === 'outbound',\n          (data) => text(data['name']),\n        ),\n    input.crm && wanted('stages')\n      ? scopedToHost(org.collection('pipelines'), input.hostId)\n          .select('stages', 'archivedAt')\n          .limit(AI_WORKFLOW_PIPELINES_WINDOW)\n          .get()\n          .then((snapshot) =>\n            snapshot.docs\n              .filter((doc) => !(Number(doc.get('archivedAt')) > 0))\n              .flatMap((doc) => (Array.isArray(doc.get('stages')) ? (doc.get('stages') as Data[]) : []))\n              .map((stage) => ({ id: text(stage?.['id']), name: text(stage?.['name']) }))\n              .filter((stage) => stage.id && stage.name),\n          )\n      : none,\n  ])\n  return { forms, datasets, lists, campaigns, workflows, webhooks, stages }\n}\n\n/** The site's functions, for a workflow outline that says which of its calls still resolve. */\nexport async function readAiWorkflowFunctions(\n  firestore: Firestore,\n  hostId: string,\n): Promise<AiAutomationNamedRecord[]> {\n  return named(\n    firestore.collection('hosts').doc(hostId).collection('functions'),\n    ['name', 'deletedAt'],\n    live,\n    (data) => text(data['name']),\n  )\n}\n\nexport type AiWorkflowTarget =\n  | { type: 'action'; id: string; name: string; action: HostAction }\n  | { type: 'workflow'; id: string; name: string; workflow: HostWorkflow }\n\n/** A saved automation of the site, or `null` for one that does not exist or was deleted. */\nexport async function readAiWorkflowTarget(\n  firestore: Firestore,\n  input: { hostId: string; type: AiWorkflowTargetType; id: string },\n): Promise<AiWorkflowTarget | null> {\n  const collection = input.type === 'action' ? 'actions' : 'workflows'\n  const snapshot = await firestore.collection('hosts').doc(input.hostId).collection(collection).doc(input.id).get()\n  const data = snapshot.exists ? ((snapshot.data() ?? {}) as Data) : null\n  if (!data || data['deletedAt'] != null) return null\n  const name = text(data['name']) || input.id\n  return input.type === 'action'\n    ? { type: 'action', id: snapshot.id, name, action: data as unknown as HostAction }\n    : { type: 'workflow', id: snapshot.id, name, workflow: data as unknown as HostWorkflow }\n}\n\nexport type AiWorkflowRunRead =\n  | { ok: true; run: AiRunRecord }\n  | { ok: false; reason: 'gone' | 'not-failed' }\n\n/**\n * One run of an automation, as the site's activity log recorded it: gone when\n * there is no such entry or it belongs to another automation, and refused\n * when it did not fail. Only what the run history shows is read — never the\n * event's payload.\n */\nexport async function readAiWorkflowRun(\n  firestore: Firestore,\n  input: { hostId: string; targetId: string; runId: string },\n): Promise<AiWorkflowRunRead> {\n  const snapshot = await firestore\n    .collection('hosts')\n    .doc(input.hostId)\n    .collection('activity')\n    .doc(input.runId)\n    .get()\n  const data = snapshot.exists ? ((snapshot.data() ?? {}) as Data) : null\n  const target = data?.['target'] as { id?: unknown } | undefined\n  if (!data || target?.id !== input.targetId) return { ok: false, reason: 'gone' }\n  const run: AiRunRecord = {\n    result: data['result'],\n    trigger: data['trigger'],\n    summary: data['summary'],\n    action: data['action'],\n    createdAt: data['createdAt'],\n  }\n  return actionRunResult(run as never) === 'failed' ? { ok: true, run } : { ok: false, reason: 'not-failed' }\n}\n"],"names":["actionRunResult","datasetDisplayName","isFormArchived","scopedToHost","AI_WORKFLOW_RECORDS_WINDOW","AI_WORKFLOW_PIPELINES_WINDOW","text","value","trim","named","query","fields","keep","nameOf","snapshot","select","limit","get","docs","map","doc","data","id","filter","name","record","live","readForms","host","collection","Array","isArray","field","Boolean","readAiAutomationRecords","firestore","input","hostId","org","orgId","wanted","kind","only","includes","none","Promise","resolve","forms","datasets","lists","campaigns","workflows","webhooks","stages","all","crm","then","Number","flatMap","stage","readAiWorkflowFunctions","readAiWorkflowTarget","type","exists","action","workflow","readAiWorkflowRun","runId","target","targetId","ok","reason","run","result","trigger","summary","createdAt"],"mappings":"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"}

package/src/lib/jobs/fixtures/ai-free-page-built-recording.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { AiEvalRecording } from '../../runtime/ai-eval';
+/**
+ * RECORDED, NOT GOLDEN: the live recording of the Free page brief
+ * (`page-free-law-firm-about`, 2026-09-17) that built the page end to end, on
+ * `claude-sonnet-5` at 254 metered credits. A recording file is never
+ * committed; this is the part a spec needs, copied from it.
+ *
+ * Trimmed to the page's first section: the root lists only that section, and
+ * every node kept is as the draft stored it. The plan, the metered steps and
+ * the grade are whole. The grader was shown the tree alone, and its notes mark
+ * the page down for a layout, a main landmark and a listing the page had: the
+ * plan created `main-layout`, a layout pass built it, and the screen carried
+ * `/about` with a search title and description.
+ */
+export declare const AI_FREE_PAGE_BUILT_RECORDING: AiEvalRecording;