@aglyn/plugins-ai 1.0.0-beta.228 → 1.0.0-beta.230

package/src/lib/server/ai-media-image.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/server/ai-media-image.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// lockdown-423: via libs/plugins/ai/src/lib/runtime/ai-gate.ts\n// The POST climbs `aiGateLadder`, whose lockdown rung is the verdict, and\n// every stored picture also passes the upload route's.\n\nimport { mediaFilterKeys } from '@aglyn/aglyn/app-utils/media-metadata'\nimport { MEDIA_ALT_MAX_LENGTH } from '@aglyn/aglyn/app-utils/media-alt'\nimport { aiMediaCreditsPerPicture } from '../model/ai-media-credits'\nimport { aiSvgThemePalette, isAiSvgColor } from '../model/ai-svg'\nimport { estimateAiBilledUsd } from '../providers/catalog'\nimport { AI_UPSTREAM_FAILURE_COPY, AiUpstreamError, type AiUsage } from '../providers/contract'\nimport {\n  AI_IMAGE_ASPECT_RATIOS,\n  AI_IMAGE_MAX_COUNT,\n  AI_IMAGE_PROMPT_MAX_CHARS,\n  AI_SVG_MAX_COLORS,\n  AI_SVG_STYLES,\n  AiImageSafetyRefusal,\n  isAiImageAspectRatio,\n  type AiImageAspectRatio,\n  type AiImageMode,\n  type AiImageProvider,\n  type AiSvgStyle,\n} from '../providers/image-contract'\nimport { vertexImageProvider } from '../providers/vertex-image'\nimport { aiGateLadder, type AiGateContext } from '../runtime/ai-gate'\nimport { aiInventoryTheme } from '../runtime/site-inventory'\nimport { assistBandRefuses, assistCreditsFromUsd } from '../usage/assist-credits'\nimport {\n  publicAssistQuota,\n  recordAssistCost,\n  releaseAssistMessage,\n} from '../usage/assist-usage'\nimport { aiMediaSvgModel, generateAiMediaSvg, type AiMediaSvgOutcome } from './ai-media-svg'\n\n/**\n * \"Create with AI\" in Media (AGL-3602): pictures from a description, stored\n * in the library that asked.\n *\n * `POST /api/ai/media/images { orgId, library, hostId?, folderId?, mode,\n * prompt, aspectRatio, count, style?, palette? }` answers\n * `{ mediaIds, filtered, failed, credits, warning? }`.\n *\n * Two modes:\n *\n * - `photo` — Google's image models on Vertex AI (`vertex-image.ts`). Off\n *   unless the deployment configured them; the door answers 404 with a\n *   sentence the dialog shows.\n * - `illustration` — an SVG drawn by the text provider every other AI door\n *   uses (`ai-media-svg.ts`): an illustration, an icon, a tileable pattern or\n *   a simple logo mark, in the site's theme colors or the person's own. No\n *   new vendor, so it runs wherever text AI does.\n *\n * There is no GET: the button draws from the shell's own gates, and this door\n * decides when someone asks for a picture.\n *\n * ## A request, not a job\n *\n * Both modes answer inside the request, the way \"Save as a component with\n * AI\" does, and are metered on the same meter every door uses.\n *\n * ## The money, in order\n *\n * 1. `aiGateLadder` RESERVES before anything is spent: the `aiGenerative`\n *    entitlement, `release_ai_generative`, the `ai-generate` kill switch,\n *    `ai.generate` on the site, the per-account and per-address windows, the\n *    Free taste's own rungs and the band.\n * 2. A workspace whose band is a wall (Free, or a hard cap) is refused before\n *    the provider is called when the pictures' estimate is more than it has\n *    left.\n * 3. The provider is called. A fault of ours or the provider's hands the\n *    reservation back and charges nothing. A declined description charges\n *    only what the decline spent, recorded as a declined request (which a\n *    Free workspace is never charged for, and which its daily refusal pause\n *    counts).\n * 4. Each picture is stored, and only what was stored is SETTLED, at billed\n *    rates above the provider's: a photo per picture plus its prompt and\n *    thinking, an illustration as the tokens that drew it. A picture held\n *    back, one the library refused, and an illustration that failed its\n *    safety check twice are never charged — that last one is ours.\n *\n * ## Stored the way any upload is stored\n *\n * Each picture is posted to the console's own `/api/media/upload` with the\n * caller's credential, so the scope, the uploads lockdown, the structural\n * inspection, SVG sanitizing, the quarantine list, the storage band, the CDN\n * variants and the storage counter all apply exactly as they do to a file\n * the person dropped in. This door writes no media document of its own; it\n * only adds, to the documents that route made, the alt text and the record\n * of how the picture was made.\n */\n\n/** The per-account window: a person makes a few sets a minute, not dozens. */\nconst RATE_LIMIT = { key: 'ai-media-image', limit: 6, windowMs: 60_000 }\n\n/** What a person reads when a picture failed on our side. */\nexport const AI_MEDIA_OURS_COPY =\n  \"This one's on us — you weren't charged. The picture didn't come out right; try again, or describe it a little differently.\"\n\n/** What the door answers on a deployment that makes no photos. */\nexport const AI_MEDIA_NO_PHOTOS_COPY =\n  \"Photos aren't available here yet. Choose Illustration to draw one instead.\"\n\n/** The provider photos come from; a spec stands one in through jest. */\nfunction imageProvider(): AiImageProvider {\n  return vertexImageProvider\n}\n\n/** Every control character as a space, squeezed, trimmed and cut. */\nexport function cleanAiImagePrompt(value: unknown): string {\n  let out = ''\n  for (const char of String(value ?? '')) {\n    const code = char.charCodeAt(0)\n    out += code < 32 || code === 127 || code === 0x2028 || code === 0x2029 ? ' ' : char\n  }\n  return out.replace(/\\s+/g, ' ').trim().slice(0, AI_IMAGE_PROMPT_MAX_CHARS)\n}\n\n/**\n * The alt text a picture is stored with: the sentence given, as a sentence,\n * cut at a word inside the library's alt limit. A person edits it like any\n * other.\n */\nexport function aiImageAltText(text: string): string {\n  const clean = text.replace(/\\s+/g, ' ').trim()\n  if (!clean) return ''\n  const sentence = clean.charAt(0).toUpperCase() + clean.slice(1)\n  if (sentence.length <= MEDIA_ALT_MAX_LENGTH) return sentence\n  const cut = sentence.slice(0, MEDIA_ALT_MAX_LENGTH - 1)\n  const space = cut.lastIndexOf(' ')\n  return `${(space > 40 ? cut.slice(0, space) : cut).trim()}…`\n}\n\nconst EXTENSIONS: Readonly<Record<string, string>> = {\n  'image/png': 'png',\n  'image/jpeg': 'jpg',\n  'image/webp': 'webp',\n  'image/svg+xml': 'svg',\n}\n\n/** A file name from the description's first words: `ai-a-red-barn-2.png`. */\nexport function aiImageFileName(prompt: string, index: number, mimeType: string): string {\n  const words = prompt\n    .toLowerCase()\n    .normalize('NFKD')\n    .replace(/[^a-z0-9\\s-]/g, ' ')\n    .split(/\\s+/)\n    .filter(Boolean)\n    .slice(0, 6)\n    .join('-')\n    .slice(0, 60)\n    .replace(/-+$/, '')\n  return `ai-${words || 'image'}-${index + 1}.${EXTENSIONS[mimeType] ?? 'png'}`\n}\n\n/** What the library asked for, read and bounded. */\nexport interface AiMediaImageInput {\n  orgId: string\n  library: 'host' | 'org'\n  /** The site whose library this is, or the site on screen for the org's. */\n  hostId: string | null\n  folderId: string | null\n  mode: AiImageMode\n  prompt: string\n  aspectRatio: string\n  count: number\n  /** An illustration's kind; unread for a photo. */\n  style: string\n  /** An illustration's colors: the site theme's, or these. */\n  palette: { source: 'theme' } | { source: 'custom'; colors: string[] }\n}\n\nexport function parseAiMediaImageInput(body: Record<string, unknown> | null): AiMediaImageInput {\n  const text = (key: string, limit = 128) => {\n    const value = body?.[key]\n    return typeof value === 'string' ? value.trim().slice(0, limit) : ''\n  }\n  const count = Math.floor(Number(body?.['count'] ?? 1))\n  const palette = body?.['palette'] as Record<string, unknown> | undefined\n  const colors = Array.isArray(palette?.['colors']) ? (palette?.['colors'] as unknown[]) : []\n  return {\n    orgId: text('orgId'),\n    library: body?.['library'] === 'org' ? 'org' : 'host',\n    hostId: text('hostId') || null,\n    folderId: text('folderId', 64) || null,\n    mode: body?.['mode'] === 'illustration' ? 'illustration' : 'photo',\n    prompt: cleanAiImagePrompt(body?.['prompt']),\n    aspectRatio: text('aspectRatio', 8),\n    count: Number.isFinite(count) ? count : 0,\n    style: text('style', 24) || 'illustration',\n    palette:\n      palette?.['source'] === 'custom'\n        ? {\n            source: 'custom',\n            colors: colors\n              .map((color) => String(color ?? '').trim().toLowerCase())\n              .slice(0, AI_SVG_MAX_COLORS + 1),\n          }\n        : { source: 'theme' },\n  }\n}\n\n/** One stored picture, or the upload route's refusal. */\ntype StoreOutcome = { mediaId: string } | { error: string; status: number }\n\n/**\n * Posts one picture to the console's own upload route, as the caller. The\n * same body the library's Upload button sends, so the route cannot tell the\n * two apart and applies every check it applies to that one.\n */\nasync function storeThroughUploadRoute(\n  request: Request,\n  input: AiMediaImageInput,\n  image: { base64: string; mimeType: string },\n  fileName: string,\n): Promise<StoreOutcome> {\n  const scope =\n    input.library === 'org'\n      ? { orgId: input.orgId, ...(input.hostId ? { forHostId: input.hostId } : {}) }\n      : { hostId: input.hostId }\n  let response: Response\n  try {\n    response = await fetch(new URL('/api/media/upload', request.url), {\n      method: 'POST',\n      headers: {\n        Authorization: request.headers.get('authorization') ?? '',\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        ...scope,\n        fileName,\n        contentType: image.mimeType,\n        folderId: input.folderId,\n        data: image.base64,\n      }),\n    })\n  } catch {\n    return { error: 'The picture could not be saved to the media library.', status: 502 }\n  }\n  const payload = (await response.json().catch(() => ({}))) as Record<string, unknown>\n  const mediaId = typeof payload['mediaId'] === 'string' ? payload['mediaId'] : ''\n  if (response.ok && mediaId) return { mediaId }\n  return {\n    error:\n      typeof payload['error'] === 'string'\n        ? payload['error']\n        : 'The picture could not be saved to the media library.',\n    status: response.ok ? 502 : response.status,\n  }\n}\n\n/** The record a generated picture keeps of how it was made. */\nexport interface AiMediaProvenance {\n  model: string\n  prompt: string\n  mode: AiImageMode\n  /** An illustration's kind; absent on a photo. */\n  style?: AiSvgStyle\n  aspectRatio: string\n  /** The meter's signal id for the request that made it. */\n  signalId: string | null\n  generatedBy: string\n}\n\n/**\n * Adds the alt text and the provenance to a document the upload route made.\n * An `update`, which cannot mint a document: the route minted it.\n */\nasync function annotateStoredImage(\n  gate: AiGateContext,\n  input: AiMediaImageInput,\n  mediaId: string,\n  alt: string,\n  provenance: AiMediaProvenance,\n): Promise<void> {\n  const scopeRef =\n    input.library === 'org'\n      ? gate.firestore.collection('orgs').doc(input.orgId)\n      : gate.firestore.collection('hosts').doc(String(input.hostId))\n  const mediaRef = scopeRef.collection('media').doc(mediaId)\n  const stored = ((await mediaRef.get()).data() ?? {}) as Parameters<typeof mediaFilterKeys>[0]\n  await mediaRef.update({\n    alt,\n    description: 'Created with AI from a description.',\n    aiGenerated: { ...provenance, createdAt: new Date() },\n    // What the library filters by, restamped with the alt now set: the upload\n    // route wrote \"Alt text is missing\" before the alt existed.\n    ...mediaFilterKeys({ ...stored, alt }),\n  })\n}\n\n/** The colors an illustration is drawn in. */\nasync function illustrationPalette(\n  gate: AiGateContext,\n  input: AiMediaImageInput,\n): Promise<string[]> {\n  if (input.palette.source === 'custom') return input.palette.colors\n  if (!input.hostId) return []\n  const snapshot = await gate.firestore.collection('hosts').doc(input.hostId).get()\n  return aiSvgThemePalette(aiInventoryTheme(snapshot.exists ? snapshot.data() ?? null : null)?.colors)\n}\n\nconst ZERO_USAGE: AiUsage = { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0 }\n\nconst sumUsage = (usages: readonly AiUsage[]): AiUsage =>\n  usages.reduce<AiUsage>(\n    (sum, usage) => ({\n      inputTokens: sum.inputTokens + usage.inputTokens,\n      outputTokens: sum.outputTokens + usage.outputTokens,\n      cacheReadTokens: sum.cacheReadTokens + usage.cacheReadTokens,\n      cacheWriteTokens: sum.cacheWriteTokens + usage.cacheWriteTokens,\n    }),\n    ZERO_USAGE,\n  )\n\n/** A picture made, before it is stored. */\ninterface MadePicture {\n  base64: string\n  mimeType: string\n  alt: string\n  /** What making it spent, charged only once it is stored. */\n  usage: AiUsage\n}\n\nexport async function POST(request: Request): Promise<Response> {\n  let body: Record<string, unknown> | null\n  try {\n    body = (await request.json()) as Record<string, unknown>\n  } catch {\n    body = null\n  }\n  const input = parseAiMediaImageInput(body)\n  const provider = imageProvider()\n  const svgModel = input.mode === 'illustration' ? aiMediaSvgModel() : undefined\n  // A deployment that makes no pictures of this kind has no such door, so\n  // nothing about the caller or the workspace is read first.\n  if (input.mode === 'photo' && !provider.configured()) {\n    return Response.json({ error: AI_MEDIA_NO_PHOTOS_COPY, reason: 'unavailable' }, { status: 404 })\n  }\n  if (input.mode === 'illustration' && !svgModel) {\n    return Response.json({ error: 'Not found' }, { status: 404 })\n  }\n\n  const gate = await aiGateLadder(\n    { request, orgId: input.orgId, hostId: input.hostId },\n    {\n      feature: 'aiGenerative',\n      releaseFlag: 'release_ai_generative',\n      lockdownFeature: 'ai-generate',\n      permission: 'ai.generate',\n      rateLimit: RATE_LIMIT,\n    },\n  )\n  if (gate instanceof Response) return gate\n  // Nothing is spent until a provider answers, so every exit before it\n  // hands the reservation back.\n  const release = () =>\n    releaseAssistMessage(gate.firestore, gate.orgId, gate.reservation).catch(() => undefined)\n  const refuse = async (error: string, status: number, extra: Record<string, unknown> = {}) => {\n    await release()\n    return Response.json({ error, ...extra }, { status })\n  }\n\n  if (input.library === 'host' && !input.hostId) {\n    return refuse('Open the site whose media library the pictures go in.', 400)\n  }\n  if (!input.prompt) return refuse('Describe the picture you want first.', 400)\n  if (!isAiImageAspectRatio(input.aspectRatio)) {\n    return refuse(`Choose a shape: ${AI_IMAGE_ASPECT_RATIOS.join(', ')}.`, 400)\n  }\n  const aspectRatio: AiImageAspectRatio = input.aspectRatio\n  if (input.count < 1 || input.count > AI_IMAGE_MAX_COUNT) {\n    return refuse(`Make between 1 and ${AI_IMAGE_MAX_COUNT} pictures at a time.`, 400)\n  }\n  if (input.mode === 'illustration') {\n    if (!(AI_SVG_STYLES as readonly string[]).includes(input.style)) {\n      return refuse('Choose an illustration, an icon, a pattern or a logo mark.', 400)\n    }\n    if (\n      input.palette.source === 'custom' &&\n      (!input.palette.colors.length ||\n        input.palette.colors.length > AI_SVG_MAX_COLORS ||\n        !input.palette.colors.every(isAiSvgColor))\n    ) {\n      return refuse(`Give between 1 and ${AI_SVG_MAX_COLORS} colors as hex values, such as #1a73e8.`, 400)\n    }\n  }\n\n  const model = input.mode === 'photo' ? provider.defaultModel() : (svgModel as string)\n  const perPicture = aiMediaCreditsPerPicture(input.mode, model)\n  const estimate = perPicture * input.count\n  const credits = publicAssistQuota(gate.reservation).credits\n  if (credits && assistBandRefuses(gate.org) && credits.remaining < estimate) {\n    return refuse(\n      credits.remaining < perPicture\n        ? 'This workspace has used its AI credits for the month.'\n        : `That needs about ${estimate} credits and this workspace has ${credits.remaining} left this month. Make fewer pictures.`,\n      429,\n      { reason: 'quota', quota: publicAssistQuota(gate.reservation) },\n    )\n  }\n\n  /** Records what a decline spent: a declined request, never a picture. */\n  const recordDecline = (usage: AiUsage, declinedModel: string) =>\n    recordAssistCost(gate.firestore, gate.orgId, {\n      route: '/api/ai/media/images',\n      hostId: input.hostId,\n      model: declinedModel,\n      tier: 'entitled',\n      usage: { ...usage, images: 0 },\n      docsPaths: [],\n      stopReason: 'refusal',\n      free: gate.reservation.free ?? null,\n      uid: gate.uid,\n      kind: 'image',\n    }).catch((meterError) =>\n      console.error('ai media refusal not recorded', { orgId: gate.orgId, meterError }),\n    )\n\n  let made: MadePicture[]\n  /** Pictures asked for and not made: held back, declined or failed on our side. */\n  let unmade: number\n  /** Tokens a photo request spent beside its pictures, charged once any is stored. */\n  let photoUsage: AiUsage = ZERO_USAGE\n  let declineReason: string | null = null\n  let style: AiSvgStyle | undefined\n\n  if (input.mode === 'photo') {\n    try {\n      const result = await provider.generate({\n        model,\n        prompt: input.prompt,\n        aspectRatio,\n        count: input.count,\n      })\n      photoUsage = result.usage\n      unmade = result.filtered\n      made = result.images.map((image) => ({\n        ...image,\n        alt: aiImageAltText(input.prompt),\n        usage: ZERO_USAGE,\n      }))\n    } catch (error) {\n      if (error instanceof AiImageSafetyRefusal) {\n        // Declined, not failed: no picture is charged, and the request is\n        // recorded as a declined one so the Free taste's refusal pause\n        // counts it.\n        await recordDecline(ZERO_USAGE, model)\n        return Response.json({ error: error.message, reason: 'safety' }, { status: 422 })\n      }\n      await release()\n      console.error('ai photo generation failed', { orgId: gate.orgId, error })\n      const status = error instanceof AiUpstreamError && error.accountProblem ? 503 : 502\n      return Response.json({ error: AI_UPSTREAM_FAILURE_COPY }, { status })\n    }\n  } else {\n    style = input.style as AiSvgStyle\n    const palette = await illustrationPalette(gate, input)\n    const settled = await Promise.allSettled(\n      Array.from({ length: input.count }, (_unused, variant) =>\n        generateAiMediaSvg({\n          model,\n          prompt: input.prompt,\n          style: style as AiSvgStyle,\n          aspectRatio,\n          palette,\n          variant,\n          count: input.count,\n        }),\n      ),\n    )\n    const outcomes = settled.flatMap((entry) =>\n      entry.status === 'fulfilled' ? [entry.value] : [],\n    )\n    if (!outcomes.length) {\n      await release()\n      console.error('ai illustration generation failed', {\n        orgId: gate.orgId,\n        error: (settled[0] as PromiseRejectedResult | undefined)?.reason,\n      })\n      return Response.json({ error: AI_UPSTREAM_FAILURE_COPY }, { status: 502 })\n    }\n    const drawn = outcomes.filter(\n      (outcome): outcome is Extract<AiMediaSvgOutcome, { kind: 'drawn' }> => outcome.kind === 'drawn',\n    )\n    const declined = outcomes.filter((outcome) => outcome.kind === 'declined')\n    unmade = input.count - drawn.length\n    declineReason =\n      (declined[0] as Extract<AiMediaSvgOutcome, { kind: 'declined' }> | undefined)?.reason ?? null\n    made = drawn.map((outcome) => ({\n      base64: Buffer.from(outcome.svg, 'utf8').toString('base64'),\n      mimeType: 'image/svg+xml',\n      alt: aiImageAltText(outcome.alt || input.prompt),\n      usage: outcome.usage,\n    }))\n    if (!made.length) {\n      if (declined.length) {\n        // The model declined: what it spent is a declined request.\n        await recordDecline(sumUsage(declined.map((outcome) => outcome.usage)), model)\n        return Response.json({ error: declineReason, reason: 'safety' }, { status: 422 })\n      }\n      // Every picture failed its check twice. Ours, so nothing is charged.\n      await release()\n      return Response.json({ error: AI_MEDIA_OURS_COPY, reason: 'ours' }, { status: 502 })\n    }\n  }\n\n  const stored: Array<{ mediaId: string; picture: MadePicture }> = []\n  let refusal: { error: string; status: number } | null = null\n  for (const [index, picture] of made.entries()) {\n    const outcome = await storeThroughUploadRoute(\n      request,\n      input,\n      picture,\n      aiImageFileName(input.prompt, index, picture.mimeType),\n    )\n    if ('mediaId' in outcome) stored.push({ mediaId: outcome.mediaId, picture })\n    else refusal ??= outcome\n  }\n\n  if (!stored.length) {\n    // Made and not kept: the library refused every picture (its storage\n    // band, a lockdown, a permission), so nothing is charged.\n    await release()\n    return Response.json(\n      { error: refusal?.error ?? 'The pictures could not be saved.' },\n      { status: refusal?.status ?? 502 },\n    )\n  }\n\n  // Only what was stored is settled: a photo's pictures at the per-picture\n  // rate with the request's prompt and thinking, an illustration's tokens.\n  const usage =\n    input.mode === 'photo'\n      ? { ...photoUsage, images: stored.length }\n      : sumUsage(stored.map((entry) => entry.picture.usage))\n  let signalId: string | null = null\n  try {\n    signalId = await recordAssistCost(gate.firestore, gate.orgId, {\n      route: '/api/ai/media/images',\n      hostId: input.hostId,\n      model,\n      tier: 'entitled',\n      usage,\n      docsPaths: [],\n      stopReason: 'end_turn',\n      free: gate.reservation.free ?? null,\n      uid: gate.uid,\n      kind: 'image',\n    })\n  } catch (error) {\n    // The pictures are in the library and were paid for by us; a meter\n    // that could not be written is not a reason to hide them.\n    console.error('ai media usage not recorded', { orgId: gate.orgId, error })\n  }\n\n  await Promise.all(\n    stored.map(({ mediaId, picture }) =>\n      annotateStoredImage(gate, input, mediaId, picture.alt, {\n        model,\n        prompt: input.prompt,\n        mode: input.mode,\n        ...(style ? { style } : {}),\n        aspectRatio,\n        signalId,\n        generatedBy: gate.uid,\n      }).catch((error) => console.error('ai media alt text not written', { mediaId, error })),\n    ),\n  )\n\n  const warning =\n    refusal?.error ??\n    (declineReason && unmade > 0 ? declineReason : unmade > 0 && input.mode === 'illustration'\n      ? AI_MEDIA_OURS_COPY\n      : null)\n  return Response.json({\n    mediaIds: stored.map((entry) => entry.mediaId),\n    filtered: unmade,\n    failed: made.length - stored.length,\n    // What was charged, as the meter priced it.\n    credits: assistCreditsFromUsd(estimateAiBilledUsd(usage, model)),\n    ...(warning ? { warning } : {}),\n  })\n}\n"],"names":["mediaFilterKeys","MEDIA_ALT_MAX_LENGTH","aiMediaCreditsPerPicture","aiSvgThemePalette","isAiSvgColor","estimateAiBilledUsd","AI_UPSTREAM_FAILURE_COPY","AiUpstreamError","AI_IMAGE_ASPECT_RATIOS","AI_IMAGE_MAX_COUNT","AI_IMAGE_PROMPT_MAX_CHARS","AI_SVG_MAX_COLORS","AI_SVG_STYLES","AiImageSafetyRefusal","isAiImageAspectRatio","vertexImageProvider","aiGateLadder","aiInventoryTheme","assistBandRefuses","assistCreditsFromUsd","publicAssistQuota","recordAssistCost","releaseAssistMessage","aiMediaSvgModel","generateAiMediaSvg","RATE_LIMIT","key","limit","windowMs","AI_MEDIA_OURS_COPY","AI_MEDIA_NO_PHOTOS_COPY","imageProvider","cleanAiImagePrompt","value","out","char","String","code","charCodeAt","replace","trim","slice","aiImageAltText","text","clean","sentence","charAt","toUpperCase","length","cut","space","lastIndexOf","EXTENSIONS","aiImageFileName","prompt","index","mimeType","words","toLowerCase","normalize","split","filter","Boolean","join","parseAiMediaImageInput","body","count","Math","floor","Number","palette","colors","Array","isArray","orgId","library","hostId","folderId","mode","aspectRatio","isFinite","style","source","map","color","storeThroughUploadRoute","request","input","image","fileName","scope","forHostId","response","fetch","URL","url","method","headers","Authorization","get","JSON","stringify","contentType","data","base64","error","status","payload","json","catch","mediaId","ok","annotateStoredImage","gate","alt","provenance","scopeRef","firestore","collection","doc","mediaRef","stored","update","description","aiGenerated","createdAt","Date","illustrationPalette","snapshot","exists","ZERO_USAGE","inputTokens","outputTokens","cacheReadTokens","cacheWriteTokens","sumUsage","usages","reduce","sum","usage","POST","provider","svgModel","undefined","configured","Response","reason","feature","releaseFlag","lockdownFeature","permission","rateLimit","release","reservation","refuse","extra","includes","every","model","defaultModel","perPicture","estimate","credits","org","remaining","quota","recordDecline","declinedModel","route","tier","images","docsPaths","stopReason","free","uid","kind","meterError","console","made","unmade","photoUsage","declineReason","result","generate","filtered","message","accountProblem","declined","settled","Promise","allSettled","from","_unused","variant","outcomes","flatMap","entry","drawn","outcome","Buffer","svg","toString","refusal","picture","entries","push","signalId","all","generatedBy","warning","mediaIds","failed"],"mappings":"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"}

package/src/lib/server/ai-media-svg.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @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 { AiSystemBlock, AiTool, AiUsage } from '../providers/contract';
+import type { AiImageAspectRatio, AiSvgStyle } from '../providers/image-contract';
+import { type AiGenerationCheckResult } from '../runtime/ai-doctrine';
+/**
+ * Illustrations in Media (AGL-3602): an SVG drawn by the TEXT provider every
+ * other AI door uses — the same registry, the same meter, the same data flow
+ * the published subprocessor row for the text provider already describes —
+ * so this mode needs no new vendor and runs wherever text AI does.
+ *
+ * One generation per picture, through `runValidatedGeneration`: the answer
+ * arrives through a strict tool, `checkAiSvgMarkup` is its check, and an
+ * answer with a problem is sent back once with what to fix. A second answer
+ * with a problem is not stored and, being our failure, not charged.
+ *
+ * It runs on the provider's fast tier: an SVG is a few thousand tokens of
+ * markup and the door answers inside one request, so the model that writes
+ * them quickest is the one that fits.
+ */
+/** The doctrine kind the generation runs under; it reads no site tree. */
+export declare const AI_MEDIA_SVG_KIND = "media-svg";
+/** The name of the tool the picture arrives through. */
+export declare const AI_MEDIA_SVG_TOOL_NAME = "submit_svg";
+/** The answer ceiling: room for a compact picture and a re-ask's worth of care. */
+export declare const AI_MEDIA_SVG_MAX_TOKENS = 6000;
+export declare const AI_MEDIA_SVG_INSTRUCTIONS: AiSystemBlock[];
+export declare function aiMediaSvgTool(): AiTool;
+/** The question one picture is asked as. */
+export declare function aiMediaSvgPrompt(input: {
+    prompt: string;
+    style: AiSvgStyle;
+    aspectRatio: AiImageAspectRatio;
+    palette: readonly string[];
+    variant: number;
+    count: number;
+}): string;
+/** What one picture's answer holds once it is read. */
+export type AiMediaSvgAnswer = {
+    svg: string;
+    alt: string;
+} | {
+    declined: string;
+};
+/** The check one answer is held to: the SVG gate, or a decline. */
+export declare function checkAiMediaSvgAnswer(answer: Record<string, unknown>, aspectRatio: AiImageAspectRatio, style: AiSvgStyle): AiGenerationCheckResult<AiMediaSvgAnswer>;
+/** The model an illustration runs on: the text provider's fast tier. */
+export declare function aiMediaSvgModel(): string | undefined;
+/** One picture's outcome. */
+export type AiMediaSvgOutcome = {
+    kind: 'drawn';
+    svg: string;
+    alt: string;
+    usage: AiUsage;
+    model: string;
+} | {
+    kind: 'declined';
+    reason: string;
+    usage: AiUsage;
+    model: string;
+}
+/** The re-ask still failed the gate, or the model stopped: ours, never charged. */
+ | {
+    kind: 'failed';
+    usage: AiUsage;
+    model: string;
+};
+/** Draws one picture. A provider fault propagates for the door to answer. */
+export declare function generateAiMediaSvg(input: {
+    model: string;
+    prompt: string;
+    style: AiSvgStyle;
+    aspectRatio: AiImageAspectRatio;
+    palette: readonly string[];
+    variant: number;
+    count: number;
+}): Promise<AiMediaSvgOutcome>;

package/src/lib/server/ai-media-svg.js

@@ -0,0 +1,186 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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 { aiDefaultModelFor } from "../providers/catalog.js";
+import { resolveAiProvider } from "../providers/routing.js";
+import { AI_SVG_MAX_BYTES, AI_SVG_VIEWBOX, checkAiSvgMarkup } from "../model/ai-svg.js";
+import { runValidatedGeneration } from "../runtime/ai-doctrine.js";
+/**
+ * Illustrations in Media (AGL-3602): an SVG drawn by the TEXT provider every
+ * other AI door uses — the same registry, the same meter, the same data flow
+ * the published subprocessor row for the text provider already describes —
+ * so this mode needs no new vendor and runs wherever text AI does.
+ *
+ * One generation per picture, through `runValidatedGeneration`: the answer
+ * arrives through a strict tool, `checkAiSvgMarkup` is its check, and an
+ * answer with a problem is sent back once with what to fix. A second answer
+ * with a problem is not stored and, being our failure, not charged.
+ *
+ * It runs on the provider's fast tier: an SVG is a few thousand tokens of
+ * markup and the door answers inside one request, so the model that writes
+ * them quickest is the one that fits.
+ */ /** The doctrine kind the generation runs under; it reads no site tree. */ export const AI_MEDIA_SVG_KIND = 'media-svg';
+/** The name of the tool the picture arrives through. */ export const AI_MEDIA_SVG_TOOL_NAME = 'submit_svg';
+/** The answer ceiling: room for a compact picture and a re-ask's worth of care. */ export const AI_MEDIA_SVG_MAX_TOKENS = 6000;
+/** What each kind of illustration is, in the words the model is given. */ const STYLE_BRIEF = {
+    illustration: 'A spot illustration or small scene: flat or lightly shaded vector shapes, clear silhouettes, no photographic detail.',
+    icon: 'A single icon: bold, simple geometry centered with even padding, in ONE color, or two tones of the palette at most. Readable at 24 pixels.',
+    pattern: 'A seamless, tileable background pattern: every shape that leaves one edge re-enters at the opposite edge, so tiles join without a seam. Low contrast, suitable behind text.',
+    logo: "A simple abstract logo MARK: a symbol made of a few shapes, with no lettering at all. Never a real company's logo, a trademark, a brand's symbol or anything imitating one."
+};
+const INSTRUCTIONS = [
+    'You draw SVG pictures for a website owner. You receive what to draw, which kind of picture it is, its shape and the colors to use, and you answer through the submit_svg tool.',
+    '',
+    'The SVG you write must:',
+    '- be exactly one <svg> element with xmlns="http://www.w3.org/2000/svg" and the viewBox you are given, and no width or height attributes;',
+    '- use only shapes, paths, groups, gradients, clipPaths and masks drawn in the document itself: never <image>, <foreignObject>, <script>, <a>, animation elements, event attributes, or a href or url(...) pointing anywhere but #ids in the same SVG;',
+    '- use no web fonts, @import or @font-face; prefer no text at all, and use only generic font families (sans-serif, serif) when text is essential;',
+    `- stay compact: well under ${Math.round(AI_SVG_MAX_BYTES / 1024 / 4)} KB, with few paths and coordinates rounded to at most one decimal place;`,
+    '- use the colors given, plus white, black and transparency, and no others.',
+    '',
+    'Write alt text: one plain sentence describing what the picture shows, for someone who cannot see it.',
+    '',
+    "Decline instead of drawing — set declined to one short sentence and leave svg and alt empty — when you are asked for a real company's or organization's logo, a trademark, a recognizable brand symbol or anything imitating one; for a real, named person; or for anything sexual, hateful, violent or otherwise unsafe. Otherwise set declined to an empty string."
+].join('\n');
+export const AI_MEDIA_SVG_INSTRUCTIONS = [
+    {
+        text: INSTRUCTIONS,
+        cacheBreakpoint: true
+    }
+];
+export function aiMediaSvgTool() {
+    return {
+        name: AI_MEDIA_SVG_TOOL_NAME,
+        description: 'Submit the SVG picture and its alt text, or decline.',
+        strict: true,
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            required: [
+                'svg',
+                'alt',
+                'declined'
+            ],
+            properties: {
+                svg: {
+                    type: 'string',
+                    description: 'The whole SVG document, starting with <svg and ending with </svg>.'
+                },
+                alt: {
+                    type: 'string',
+                    description: 'One plain sentence describing the picture.'
+                },
+                declined: {
+                    type: 'string',
+                    description: 'Empty, or one short sentence saying why this picture is not drawn.'
+                }
+            }
+        }
+    };
+}
+/** The question one picture is asked as. */ export function aiMediaSvgPrompt(input) {
+    const colors = input.palette.length ? `Colors: ${input.palette.join(', ')}.` : 'Colors: a restrained palette of three to five colors of your choice.';
+    const lines = [
+        `Kind: ${input.style}. ${STYLE_BRIEF[input.style]}`,
+        `Shape: ${input.aspectRatio}, viewBox="${AI_SVG_VIEWBOX[input.aspectRatio]}".`,
+        colors
+    ];
+    if (input.count > 1) {
+        lines.push(`This is version ${input.variant + 1} of ${input.count}: make it a distinct take on the same description.`);
+    }
+    lines.push('', 'Draw:', input.prompt);
+    return lines.join('\n');
+}
+/** The check one answer is held to: the SVG gate, or a decline. */ export function checkAiMediaSvgAnswer(answer, aspectRatio, style) {
+    const declined = typeof answer['declined'] === 'string' ? answer['declined'].trim() : '';
+    if (declined) return {
+        value: {
+            declined: declined.slice(0, 300)
+        },
+        violations: []
+    };
+    const result = checkAiSvgMarkup(answer['svg'], aspectRatio, style);
+    const alt = typeof answer['alt'] === 'string' ? answer['alt'].replace(/\s+/g, ' ').trim().slice(0, 300) : '';
+    if (result.svg) return {
+        value: {
+            svg: result.svg,
+            alt
+        },
+        violations: []
+    };
+    const violations = result.problems.map((problem)=>({
+            rule: null,
+            code: `svg-${problem.code}`,
+            message: 'The picture could not be drawn safely.',
+            detail: problem.detail
+        }));
+    return {
+        value: {
+            svg: '',
+            alt
+        },
+        violations,
+        offending: {
+            svg: '(see the problems listed)'
+        }
+    };
+}
+/** The model an illustration runs on: the text provider's fast tier. */ export function aiMediaSvgModel() {
+    const provider = resolveAiProvider();
+    return provider ? aiDefaultModelFor(provider.id, 'fast') : undefined;
+}
+/** Draws one picture. A provider fault propagates for the door to answer. */ export async function generateAiMediaSvg(input) {
+    const generation = {
+        model: input.model,
+        instructions: AI_MEDIA_SVG_INSTRUCTIONS,
+        inventory: undefined,
+        messages: [
+            {
+                role: 'user',
+                content: aiMediaSvgPrompt(input)
+            }
+        ],
+        tool: aiMediaSvgTool(),
+        maxTokens: AI_MEDIA_SVG_MAX_TOKENS,
+        check: (answer)=>checkAiMediaSvgAnswer(answer, input.aspectRatio, input.style)
+    };
+    const result = await runValidatedGeneration(AI_MEDIA_SVG_KIND, generation);
+    const spent = {
+        usage: result.usage,
+        model: result.model
+    };
+    if (result.status === 'ok') {
+        return 'declined' in result.value ? _extends({
+            kind: 'declined',
+            reason: result.value.declined
+        }, spent) : _extends({
+            kind: 'drawn',
+            svg: result.value.svg,
+            alt: result.value.alt
+        }, spent);
+    }
+    if (result.status === 'refused') {
+        return _extends({
+            kind: 'declined',
+            reason: 'The assistant would not draw this.'
+        }, spent);
+    }
+    return _extends({
+        kind: 'failed'
+    }, spent);
+}
+
+//# sourceMappingURL=ai-media-svg.js.map

package/src/lib/server/ai-media-svg.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/server/ai-media-svg.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 { aiDefaultModelFor } from '../providers/catalog'\nimport type { AiSystemBlock, AiTool, AiUsage } from '../providers/contract'\nimport type { AiImageAspectRatio, AiSvgStyle } from '../providers/image-contract'\nimport { resolveAiProvider } from '../providers/routing'\nimport { AI_SVG_MAX_BYTES, AI_SVG_VIEWBOX, checkAiSvgMarkup } from '../model/ai-svg'\nimport type { AiDoctrineViolation } from '../runtime/ai-doctrine-validators'\nimport {\n  runValidatedGeneration,\n  type AiCustomGenerationInput,\n  type AiGenerationCheckResult,\n  type AiValidatedGeneration,\n} from '../runtime/ai-doctrine'\n\n/**\n * Illustrations in Media (AGL-3602): an SVG drawn by the TEXT provider every\n * other AI door uses — the same registry, the same meter, the same data flow\n * the published subprocessor row for the text provider already describes —\n * so this mode needs no new vendor and runs wherever text AI does.\n *\n * One generation per picture, through `runValidatedGeneration`: the answer\n * arrives through a strict tool, `checkAiSvgMarkup` is its check, and an\n * answer with a problem is sent back once with what to fix. A second answer\n * with a problem is not stored and, being our failure, not charged.\n *\n * It runs on the provider's fast tier: an SVG is a few thousand tokens of\n * markup and the door answers inside one request, so the model that writes\n * them quickest is the one that fits.\n */\n\n/** The doctrine kind the generation runs under; it reads no site tree. */\nexport const AI_MEDIA_SVG_KIND = 'media-svg'\n\n/** The name of the tool the picture arrives through. */\nexport const AI_MEDIA_SVG_TOOL_NAME = 'submit_svg'\n\n/** The answer ceiling: room for a compact picture and a re-ask's worth of care. */\nexport const AI_MEDIA_SVG_MAX_TOKENS = 6_000\n\n/** What each kind of illustration is, in the words the model is given. */\nconst STYLE_BRIEF: Readonly<Record<AiSvgStyle, string>> = {\n  illustration:\n    'A spot illustration or small scene: flat or lightly shaded vector shapes, clear silhouettes, no photographic detail.',\n  icon: 'A single icon: bold, simple geometry centered with even padding, in ONE color, or two tones of the palette at most. Readable at 24 pixels.',\n  pattern:\n    'A seamless, tileable background pattern: every shape that leaves one edge re-enters at the opposite edge, so tiles join without a seam. Low contrast, suitable behind text.',\n  logo: \"A simple abstract logo MARK: a symbol made of a few shapes, with no lettering at all. Never a real company's logo, a trademark, a brand's symbol or anything imitating one.\",\n}\n\nconst INSTRUCTIONS = [\n  'You draw SVG pictures for a website owner. You receive what to draw, which kind of picture it is, its shape and the colors to use, and you answer through the submit_svg tool.',\n  '',\n  'The SVG you write must:',\n  '- be exactly one <svg> element with xmlns=\"http://www.w3.org/2000/svg\" and the viewBox you are given, and no width or height attributes;',\n  '- use only shapes, paths, groups, gradients, clipPaths and masks drawn in the document itself: never <image>, <foreignObject>, <script>, <a>, animation elements, event attributes, or a href or url(...) pointing anywhere but #ids in the same SVG;',\n  '- use no web fonts, @import or @font-face; prefer no text at all, and use only generic font families (sans-serif, serif) when text is essential;',\n  `- stay compact: well under ${Math.round(AI_SVG_MAX_BYTES / 1024 / 4)} KB, with few paths and coordinates rounded to at most one decimal place;`,\n  '- use the colors given, plus white, black and transparency, and no others.',\n  '',\n  'Write alt text: one plain sentence describing what the picture shows, for someone who cannot see it.',\n  '',\n  \"Decline instead of drawing — set declined to one short sentence and leave svg and alt empty — when you are asked for a real company's or organization's logo, a trademark, a recognizable brand symbol or anything imitating one; for a real, named person; or for anything sexual, hateful, violent or otherwise unsafe. Otherwise set declined to an empty string.\",\n].join('\\n')\n\nexport const AI_MEDIA_SVG_INSTRUCTIONS: AiSystemBlock[] = [{ text: INSTRUCTIONS, cacheBreakpoint: true }]\n\nexport function aiMediaSvgTool(): AiTool {\n  return {\n    name: AI_MEDIA_SVG_TOOL_NAME,\n    description: 'Submit the SVG picture and its alt text, or decline.',\n    strict: true,\n    inputSchema: {\n      type: 'object',\n      additionalProperties: false,\n      required: ['svg', 'alt', 'declined'],\n      properties: {\n        svg: { type: 'string', description: 'The whole SVG document, starting with <svg and ending with </svg>.' },\n        alt: { type: 'string', description: 'One plain sentence describing the picture.' },\n        declined: {\n          type: 'string',\n          description: 'Empty, or one short sentence saying why this picture is not drawn.',\n        },\n      },\n    },\n  }\n}\n\n/** The question one picture is asked as. */\nexport function aiMediaSvgPrompt(input: {\n  prompt: string\n  style: AiSvgStyle\n  aspectRatio: AiImageAspectRatio\n  palette: readonly string[]\n  variant: number\n  count: number\n}): string {\n  const colors = input.palette.length\n    ? `Colors: ${input.palette.join(', ')}.`\n    : 'Colors: a restrained palette of three to five colors of your choice.'\n  const lines = [\n    `Kind: ${input.style}. ${STYLE_BRIEF[input.style]}`,\n    `Shape: ${input.aspectRatio}, viewBox=\"${AI_SVG_VIEWBOX[input.aspectRatio]}\".`,\n    colors,\n  ]\n  if (input.count > 1) {\n    lines.push(\n      `This is version ${input.variant + 1} of ${input.count}: make it a distinct take on the same description.`,\n    )\n  }\n  lines.push('', 'Draw:', input.prompt)\n  return lines.join('\\n')\n}\n\n/** What one picture's answer holds once it is read. */\nexport type AiMediaSvgAnswer = { svg: string; alt: string } | { declined: string }\n\n/** The check one answer is held to: the SVG gate, or a decline. */\nexport function checkAiMediaSvgAnswer(\n  answer: Record<string, unknown>,\n  aspectRatio: AiImageAspectRatio,\n  style: AiSvgStyle,\n): AiGenerationCheckResult<AiMediaSvgAnswer> {\n  const declined = typeof answer['declined'] === 'string' ? answer['declined'].trim() : ''\n  if (declined) return { value: { declined: declined.slice(0, 300) }, violations: [] }\n  const result = checkAiSvgMarkup(answer['svg'], aspectRatio, style)\n  const alt = typeof answer['alt'] === 'string' ? answer['alt'].replace(/\\s+/g, ' ').trim().slice(0, 300) : ''\n  if (result.svg) return { value: { svg: result.svg, alt }, violations: [] }\n  const violations: AiDoctrineViolation[] = result.problems.map((problem) => ({\n    rule: null,\n    code: `svg-${problem.code}`,\n    message: 'The picture could not be drawn safely.',\n    detail: problem.detail,\n  }))\n  return { value: { svg: '', alt }, violations, offending: { svg: '(see the problems listed)' } }\n}\n\n/** The model an illustration runs on: the text provider's fast tier. */\nexport function aiMediaSvgModel(): string | undefined {\n  const provider = resolveAiProvider()\n  return provider ? aiDefaultModelFor(provider.id, 'fast') : undefined\n}\n\n/** One picture's outcome. */\nexport type AiMediaSvgOutcome =\n  | { kind: 'drawn'; svg: string; alt: string; usage: AiUsage; model: string }\n  | { kind: 'declined'; reason: string; usage: AiUsage; model: string }\n  /** The re-ask still failed the gate, or the model stopped: ours, never charged. */\n  | { kind: 'failed'; usage: AiUsage; model: string }\n\n/** Draws one picture. A provider fault propagates for the door to answer. */\nexport async function generateAiMediaSvg(input: {\n  model: string\n  prompt: string\n  style: AiSvgStyle\n  aspectRatio: AiImageAspectRatio\n  palette: readonly string[]\n  variant: number\n  count: number\n}): Promise<AiMediaSvgOutcome> {\n  const generation: AiCustomGenerationInput<AiMediaSvgAnswer> = {\n    model: input.model,\n    instructions: AI_MEDIA_SVG_INSTRUCTIONS,\n    inventory: undefined,\n    messages: [{ role: 'user', content: aiMediaSvgPrompt(input) }],\n    tool: aiMediaSvgTool(),\n    maxTokens: AI_MEDIA_SVG_MAX_TOKENS,\n    check: (answer) => checkAiMediaSvgAnswer(answer, input.aspectRatio, input.style),\n  }\n  const result = (await runValidatedGeneration(\n    AI_MEDIA_SVG_KIND,\n    generation,\n  )) as AiValidatedGeneration<AiMediaSvgAnswer>\n  const spent = { usage: result.usage, model: result.model }\n  if (result.status === 'ok') {\n    return 'declined' in result.value\n      ? { kind: 'declined', reason: result.value.declined, ...spent }\n      : { kind: 'drawn', svg: result.value.svg, alt: result.value.alt, ...spent }\n  }\n  if (result.status === 'refused') {\n    return { kind: 'declined', reason: 'The assistant would not draw this.', ...spent }\n  }\n  return { kind: 'failed', ...spent }\n}\n"],"names":["aiDefaultModelFor","resolveAiProvider","AI_SVG_MAX_BYTES","AI_SVG_VIEWBOX","checkAiSvgMarkup","runValidatedGeneration","AI_MEDIA_SVG_KIND","AI_MEDIA_SVG_TOOL_NAME","AI_MEDIA_SVG_MAX_TOKENS","STYLE_BRIEF","illustration","icon","pattern","logo","INSTRUCTIONS","Math","round","join","AI_MEDIA_SVG_INSTRUCTIONS","text","cacheBreakpoint","aiMediaSvgTool","name","description","strict","inputSchema","type","additionalProperties","required","properties","svg","alt","declined","aiMediaSvgPrompt","input","colors","palette","length","lines","style","aspectRatio","count","push","variant","prompt","checkAiMediaSvgAnswer","answer","trim","value","slice","violations","result","replace","problems","map","problem","rule","code","message","detail","offending","aiMediaSvgModel","provider","id","undefined","generateAiMediaSvg","generation","model","instructions","inventory","messages","role","content","tool","maxTokens","check","spent","usage","status","kind","reason"],"mappings":"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"}

package/src/lib/server/assist-build.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @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 AssistBuildProposal } from '../model/assist-build';
+import type { AiTool } from '../providers/contract';
+import { aiBuildOps } from '../jobs/ai-build-capabilities';
+/** The strict tool the model proposes a build through. */
+export declare function assistBuildTool(): AiTool;
+/**
+ * The build protocol — the same for every site, so it sits inside the cached
+ * prefix. What a build can make on THIS site is per site and rides
+ * `assistBuildIntentsBlock`, after every breakpoint.
+ */
+export declare function assistBuildBlock(): string;
+/** What a build can make on this site, in each owner's own words. Per site: volatile. */
+export declare function assistBuildIntentsBlock(intents: readonly string[]): string;
+/**
+ * The tool call held to what a build job accepts, or `null` when it is
+ * unusable. The site is the request's own, never the model's; the brief is
+ * clamped to the job door's limit, with a line naming the console page it
+ * was asked from so the plan step can read "this page" against it.
+ */
+export declare function resolveAssistBuild(input: Record<string, unknown> | null, scope: {
+    hostId: string;
+    screen: string | null;
+}): AssistBuildProposal | null;
+export interface AssistBuildIntentsDeps {
+    ops?: typeof aiBuildOps;
+    hasBuildRunner?: () => boolean;
+}
+/**
+ * What a build may make on this site, or `null` where none can be built: a
+ * deployment that has not loaded the build kind, or a site where no
+ * operation passes its owner's gates. The same operations the build's plan
+ * step offers, so the chat never offers what the plan cannot make.
+ */
+export declare function assistBuildIntents(firestore: FirebaseFirestore.Firestore, input: {
+    orgId: string;
+    hostId: string;
+    org: Record<string, unknown>;
+}, deps?: AssistBuildIntentsDeps): Promise<string[] | null>;

package/src/lib/server/assist-build.js

@@ -0,0 +1,121 @@
+/**
+ * @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 { ASSIST_BUILD_ACTION_ID, ASSIST_BUILD_SUMMARY_MAX_CHARS, ASSIST_BUILD_TOOL_NAME } from "../model/assist-build.js";
+import { aiBuildIntents, aiBuildOps } from "../jobs/ai-build-capabilities.js";
+import { aiBuildFreeTaste } from "../jobs/ai-job-build-step.js";
+import { AI_JOB_BRIEF_MAX_CHARS } from "../jobs/ai-job-text-step.js";
+import { aiJobStepRunnerFor } from "../jobs/ai-jobs.js";
+/**
+ * The chat's build rung (AGL-3616): on a site, a request that names things
+ * to make — "a few new pages, a booking form and a contact form, then an
+ * about page" — is proposed as ONE build through a strict tool. The tool
+ * carries the request, not a plan: planning is the build job's own plan
+ * step, against the site's real inventory, with its re-ask and its limits.
+ * The panel starts that job and shows its plan card with one price; nothing
+ * is built until the person confirms it, and what is built is a draft unless
+ * they asked to publish and tick the card's box.
+ */ const STRING = {
+    type: 'string'
+};
+/** The strict tool the model proposes a build through. */ export function assistBuildTool() {
+    return {
+        name: ASSIST_BUILD_TOOL_NAME,
+        description: 'Propose building what the user asked for on this site: pages, a header ' + 'and footer, forms and the other things listed. The user sees a plan with ' + 'its price and confirms it before anything is made. Call at most once per ' + 'message, with the whole request.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                summary: STRING,
+                brief: STRING,
+                publish: {
+                    type: 'boolean'
+                }
+            },
+            required: [
+                'summary',
+                'brief',
+                'publish'
+            ],
+            additionalProperties: false
+        },
+        strict: true
+    };
+}
+/**
+ * The build protocol — the same for every site, so it sits inside the cached
+ * prefix. What a build can make on THIS site is per site and rides
+ * `assistBuildIntentsBlock`, after every breakpoint.
+ */ export function assistBuildBlock() {
+    return [
+        'Building on this site:',
+        `- When the user asks you to make or set up things on their site — pages, a header and footer, forms, or anything listed in the "A build here can make" block — write one or two sentences saying what you will plan, then call the ${ASSIST_BUILD_TOOL_NAME} tool once with the whole request. Write no JSON in your message.`,
+        '- brief: everything they asked for, in their words, with each page, form and other part named and what each is for. Include what the conversation already settled. Do not invent parts they did not ask for beyond what their request plainly needs (a page that shows a form needs that form).',
+        '- publish: true only when they asked for the new pages to go live or be published; otherwise false. New work is an unpublished draft by default.',
+        '- summary: one short sentence, such as "Plan three pages, a contact form and a booking service".',
+        '- Nothing is built when you call the tool: the user is shown a plan with its price and confirms it. Never say anything is made, and never quote a price.',
+        '- Only offer what the "A build here can make" block lists. If they ask for something it does not list, say plainly it cannot be built here from the chat and build the rest.',
+        '- A question, or a change to the canvas the user has open, is not a build: answer it, or use the canvas edit tool where it is offered.'
+    ].join('\n');
+}
+/** What a build can make on this site, in each owner's own words. Per site: volatile. */ export function assistBuildIntentsBlock(intents) {
+    return [
+        'A build here can make:',
+        ...intents.map((intent)=>`- ${intent}`)
+    ].join('\n');
+}
+/**
+ * The tool call held to what a build job accepts, or `null` when it is
+ * unusable. The site is the request's own, never the model's; the brief is
+ * clamped to the job door's limit, with a line naming the console page it
+ * was asked from so the plan step can read "this page" against it.
+ */ export function resolveAssistBuild(input, scope) {
+    if (!input) return null;
+    const asked = typeof input['brief'] === 'string' ? input['brief'].trim() : '';
+    if (!asked) return null;
+    const where = scope.screen ? `\nAsked from the console page: ${scope.screen}` : '';
+    const brief = `${asked.slice(0, AI_JOB_BRIEF_MAX_CHARS - where.length)}${where}`.trim();
+    const summary = typeof input['summary'] === 'string' && input['summary'].trim() ? input['summary'].trim().slice(0, ASSIST_BUILD_SUMMARY_MAX_CHARS) : 'Plan what you asked for';
+    return {
+        id: ASSIST_BUILD_ACTION_ID,
+        hostId: scope.hostId,
+        brief,
+        publish: input['publish'] === true,
+        summary
+    };
+}
+/**
+ * What a build may make on this site, or `null` where none can be built: a
+ * deployment that has not loaded the build kind, or a site where no
+ * operation passes its owner's gates. The same operations the build's plan
+ * step offers, so the chat never offers what the plan cannot make.
+ */ export async function assistBuildIntents(firestore, input, deps = {}) {
+    var _deps_hasBuildRunner, _data, _deps_ops;
+    const hasBuildRunner = (_deps_hasBuildRunner = deps.hasBuildRunner) != null ? _deps_hasBuildRunner : ()=>aiJobStepRunnerFor('build') !== null;
+    if (!hasBuildRunner()) return null;
+    const host = (_data = (await firestore.collection('hosts').doc(input.hostId).get()).data()) != null ? _data : null;
+    if (!host) return null;
+    const org = input.org;
+    const ops = await ((_deps_ops = deps.ops) != null ? _deps_ops : aiBuildOps)({
+        orgId: input.orgId,
+        hostId: input.hostId,
+        org,
+        host,
+        freeTaste: aiBuildFreeTaste(org)
+    });
+    const intents = aiBuildIntents(ops);
+    return intents.length ? intents : null;
+}
+
+//# sourceMappingURL=assist-build.js.map

package/src/lib/server/assist-build.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/server/assist-build.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 { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport {\n  ASSIST_BUILD_ACTION_ID,\n  ASSIST_BUILD_SUMMARY_MAX_CHARS,\n  ASSIST_BUILD_TOOL_NAME,\n  type AssistBuildProposal,\n} from '../model/assist-build'\nimport type { AiTool } from '../providers/contract'\nimport { aiBuildIntents, aiBuildOps } from '../jobs/ai-build-capabilities'\nimport { aiBuildFreeTaste } from '../jobs/ai-job-build-step'\nimport { AI_JOB_BRIEF_MAX_CHARS } from '../jobs/ai-job-text-step'\nimport { aiJobStepRunnerFor } from '../jobs/ai-jobs'\n\n/**\n * The chat's build rung (AGL-3616): on a site, a request that names things\n * to make — \"a few new pages, a booking form and a contact form, then an\n * about page\" — is proposed as ONE build through a strict tool. The tool\n * carries the request, not a plan: planning is the build job's own plan\n * step, against the site's real inventory, with its re-ask and its limits.\n * The panel starts that job and shows its plan card with one price; nothing\n * is built until the person confirms it, and what is built is a draft unless\n * they asked to publish and tick the card's box.\n */\n\nconst STRING = { type: 'string' } as const\n\n/** The strict tool the model proposes a build through. */\nexport function assistBuildTool(): AiTool {\n  return {\n    name: ASSIST_BUILD_TOOL_NAME,\n    description:\n      'Propose building what the user asked for on this site: pages, a header ' +\n      'and footer, forms and the other things listed. The user sees a plan with ' +\n      'its price and confirms it before anything is made. Call at most once per ' +\n      'message, with the whole request.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        summary: STRING,\n        brief: STRING,\n        publish: { type: 'boolean' },\n      },\n      required: ['summary', 'brief', 'publish'],\n      additionalProperties: false,\n    },\n    strict: true,\n  }\n}\n\n/**\n * The build protocol — the same for every site, so it sits inside the cached\n * prefix. What a build can make on THIS site is per site and rides\n * `assistBuildIntentsBlock`, after every breakpoint.\n */\nexport function assistBuildBlock(): string {\n  return [\n    'Building on this site:',\n    `- When the user asks you to make or set up things on their site — pages, a header and footer, forms, or anything listed in the \"A build here can make\" block — write one or two sentences saying what you will plan, then call the ${ASSIST_BUILD_TOOL_NAME} tool once with the whole request. Write no JSON in your message.`,\n    '- brief: everything they asked for, in their words, with each page, form and other part named and what each is for. Include what the conversation already settled. Do not invent parts they did not ask for beyond what their request plainly needs (a page that shows a form needs that form).',\n    '- publish: true only when they asked for the new pages to go live or be published; otherwise false. New work is an unpublished draft by default.',\n    '- summary: one short sentence, such as \"Plan three pages, a contact form and a booking service\".',\n    '- Nothing is built when you call the tool: the user is shown a plan with its price and confirms it. Never say anything is made, and never quote a price.',\n    '- Only offer what the \"A build here can make\" block lists. If they ask for something it does not list, say plainly it cannot be built here from the chat and build the rest.',\n    '- A question, or a change to the canvas the user has open, is not a build: answer it, or use the canvas edit tool where it is offered.',\n  ].join('\\n')\n}\n\n/** What a build can make on this site, in each owner's own words. Per site: volatile. */\nexport function assistBuildIntentsBlock(intents: readonly string[]): string {\n  return ['A build here can make:', ...intents.map((intent) => `- ${intent}`)].join('\\n')\n}\n\n/**\n * The tool call held to what a build job accepts, or `null` when it is\n * unusable. The site is the request's own, never the model's; the brief is\n * clamped to the job door's limit, with a line naming the console page it\n * was asked from so the plan step can read \"this page\" against it.\n */\nexport function resolveAssistBuild(\n  input: Record<string, unknown> | null,\n  scope: { hostId: string; screen: string | null },\n): AssistBuildProposal | null {\n  if (!input) return null\n  const asked = typeof input['brief'] === 'string' ? input['brief'].trim() : ''\n  if (!asked) return null\n  const where = scope.screen ? `\\nAsked from the console page: ${scope.screen}` : ''\n  const brief = `${asked.slice(0, AI_JOB_BRIEF_MAX_CHARS - where.length)}${where}`.trim()\n  const summary =\n    typeof input['summary'] === 'string' && input['summary'].trim()\n      ? input['summary'].trim().slice(0, ASSIST_BUILD_SUMMARY_MAX_CHARS)\n      : 'Plan what you asked for'\n  return {\n    id: ASSIST_BUILD_ACTION_ID,\n    hostId: scope.hostId,\n    brief,\n    publish: input['publish'] === true,\n    summary,\n  }\n}\n\nexport interface AssistBuildIntentsDeps {\n  ops?: typeof aiBuildOps\n  hasBuildRunner?: () => boolean\n}\n\n/**\n * What a build may make on this site, or `null` where none can be built: a\n * deployment that has not loaded the build kind, or a site where no\n * operation passes its owner's gates. The same operations the build's plan\n * step offers, so the chat never offers what the plan cannot make.\n */\nexport async function assistBuildIntents(\n  firestore: FirebaseFirestore.Firestore,\n  input: { orgId: string; hostId: string; org: Record<string, unknown> },\n  deps: AssistBuildIntentsDeps = {},\n): Promise<string[] | null> {\n  const hasBuildRunner = deps.hasBuildRunner ?? (() => aiJobStepRunnerFor('build') !== null)\n  if (!hasBuildRunner()) return null\n  const host = ((await firestore.collection('hosts').doc(input.hostId).get()).data() ?? null) as Record<\n    string,\n    unknown\n  > | null\n  if (!host) return null\n  const org = input.org as Partial<AglynOrgBilling>\n  const ops = await (deps.ops ?? aiBuildOps)({\n    orgId: input.orgId,\n    hostId: input.hostId,\n    org,\n    host,\n    freeTaste: aiBuildFreeTaste(org),\n  })\n  const intents = aiBuildIntents(ops)\n  return intents.length ? intents : null\n}\n"],"names":["ASSIST_BUILD_ACTION_ID","ASSIST_BUILD_SUMMARY_MAX_CHARS","ASSIST_BUILD_TOOL_NAME","aiBuildIntents","aiBuildOps","aiBuildFreeTaste","AI_JOB_BRIEF_MAX_CHARS","aiJobStepRunnerFor","STRING","type","assistBuildTool","name","description","inputSchema","properties","summary","brief","publish","required","additionalProperties","strict","assistBuildBlock","join","assistBuildIntentsBlock","intents","map","intent","resolveAssistBuild","input","scope","asked","trim","where","screen","slice","length","id","hostId","assistBuildIntents","firestore","deps","hasBuildRunner","host","collection","doc","get","data","org","ops","orgId","freeTaste"],"mappings":"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"}