@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/jobs/ai-job-crm-step.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-crm-step.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 { createHash } from 'node:crypto'\nimport { pluginRecordFactsReader } from '@aglyn/aglyn/plugin-manager/plugin-record-facts'\nimport {\n  AI_CRM_ANSWER_RETENTION_DAYS,\n  AI_CRM_ANSWERS_COLLECTION,\n  AI_CRM_EMAIL_REQUEST_MAX_CHARS,\n  AI_CRM_OUTPUT_IDS,\n  AI_CRM_PLUGIN_ID,\n  aiCrmAnswerExpiry,\n  parseAiCrmRequest,\n  readAiCrmProposal,\n  type AiCrmAnswerRecord,\n  type AiCrmEmailProposal,\n  type AiCrmMappingProposal,\n  type AiCrmOutputRef,\n  type AiCrmProposal,\n  type AiCrmRecordKind,\n  type AiCrmRecordProposal,\n} from '../model/ai-crm'\nimport { AI_STEP_TIERS } from '../providers/catalog'\nimport type { AiTool } from '../providers/contract'\nimport { AI_ROUTING_TABLE, aiModelForStep } from '../providers/routing'\nimport { aiDoctrineScopeFor, aiDoctrineSystemBlocks, runValidatedGeneration } from '../runtime/ai-doctrine'\nimport type { AiSystemBlock } from '../runtime/ai-runtime'\nimport {\n  AI_CRM_EMAIL_TOOL,\n  AI_CRM_EMAIL_TOOL_NAME,\n  AI_CRM_MAPPING_TOOL,\n  AI_CRM_MAPPING_TOOL_NAME,\n  AI_CRM_RECORD_TOOL_NAME,\n  aiCrmEmailMergeFields,\n  aiCrmImportFields,\n  aiCrmRecordCheckContext,\n  aiCrmRecordTool,\n  checkAiCrmEmail,\n  checkAiCrmMapping,\n  checkAiCrmRecord,\n  type AiCrmImportField,\n} from '../tools/ai-crm-tool'\nimport {\n  AI_CRM_UNAVAILABLE_COPY,\n  aiCrmAccessRefusal,\n  aiCrmFactsResource,\n  type AiCrmReaderLookup,\n} from './ai-crm-access'\nimport { registerAiJobAdmission, type AiJobAdmission, type AiJobAdmissionRefusal } from './ai-job-admission'\nimport { aiJobStepBudget } from './ai-job-budget'\nimport { aiGenerationSpent, aiUnspentOutcome } from './ai-job-generation'\nimport type { AiJobStepContext, AiJobStepOutcome, AiJobStepRunner } from './ai-job-text-step'\nimport { registerAiJobStep } from './ai-jobs'\n\n/**\n * The `crm` step (AGL-2917): CRM by AI, as proposals.\n *\n * `inputs.task` says what the job is asked (`model/ai-crm.ts`):\n *\n * - `record` — one contact, company, deal or lead (`record`, `recordId`): a\n *   summary, the next step as a task, a deal's stage, a lead's standing;\n * - `email` — a draft for the CRM composer, from what the member asked for\n *   (the brief) and the record's facts;\n * - `mapping` — an import's columns (`collection`, `columns`) matched to the\n *   fields the CRM's import fills.\n *\n * ## The CRM decides what is read\n *\n * The step never reads a CRM document. It asks the CRM's readers on the core's\n * record-facts seam for the job's creator, and the CRM applies its own rules —\n * the member's reach and `data.manage`, the plan, the record's visibility on\n * the site — and reports the facts it chooses to. The admission below asks the\n * same reader before the job exists, beside what an in-process call skips of\n * the plugin API dispatcher: the CRM switched on and released where the job\n * runs. A mapping sends the file's headers and each column's shape, never a\n * cell.\n *\n * ## It writes no CRM record\n *\n * The CRM's task form, stage route, composer and import drawer are the\n * writes, and a member makes each one. No email is sent by a job.\n *\n * ## The answer is kept apart from the job\n *\n * Every member of a workspace may read its jobs, and not every member may\n * read every record. So a job's output names only the question — which\n * record, which import — and the answer is kept at\n * `orgs/{orgId}/aiCrmAnswers/{jobId}`, which no client may read, for two\n * weeks (`AI_CRM_ANSWER_RETENTION_DAYS`). The answer door\n * (`server/ai-crm-answer.ts`) serves it to a member the CRM still lets read\n * the record, asking the same reader again.\n *\n * ## A summary is asked once per timeline\n *\n * A record answer is keyed on the whole request — the record, the site, the\n * model, the rules, the tool and the facts as the CRM reported them — and a\n * later job whose key matches a kept answer reuses it and spends nothing.\n * The facts change exactly when something the model was told changes, so an\n * unchanged record is never asked twice while its answer is kept.\n */\n\n/**\n * ASSUMED: the step's own round trips — the facts read (the record and its\n * three windowed queries, in parallel), a record's reuse lookup, and the\n * answer's write.\n */\nexport const AI_CRM_FACTS_READS_MS = 1_500\n\n/**\n * The step's time (AGL-3035): one generation and its re-ask on the tier\n * `job.crm` is served from, after the facts read, with no site inventory and\n * so no lookup round. It fits an inline door's budget, so a member who asks on\n * a record page is answered in the request.\n */\nexport const AI_JOB_CRM_STEP_BUDGET = aiJobStepBudget({\n  tier: AI_STEP_TIERS['job.crm'],\n  maxTokens: AI_ROUTING_TABLE['job.crm'].maxTokens,\n  lookups: 0,\n  ownReadsMs: AI_CRM_FACTS_READS_MS,\n})\n\n/** The least time one CRM step needs before it starts. */\nexport const AI_JOB_CRM_STEP_MINIMUM_MS = AI_JOB_CRM_STEP_BUDGET.minimumMs\n\n/** Kept answers to one request a reuse lookup reads. */\nexport const AI_CRM_REUSE_CANDIDATES = 20\n\n/** How long a record answer stays reusable, beside its facts being unchanged: as long as it is kept. */\nexport const AI_CRM_REUSE_WINDOW_MS = AI_CRM_ANSWER_RETENTION_DAYS * 24 * 60 * 60_000\n\nexport const AI_CRM_FACTS_FAILURE_COPY = 'The CRM record could not be read. Try again.'\nexport const AI_CRM_KEEP_FAILURE_COPY = 'The answer could not be kept. Try again.'\n\n/** The generation kinds the step asks under, which the doctrine states only its field rules to. */\nexport const AI_CRM_GENERATION_KINDS = {\n  record: 'crm-record',\n  email: 'crm-email',\n  mapping: 'crm-mapping',\n} as const\n\nconst OUTPUT_LABELS = {\n  record: 'CRM summary',\n  email: 'CRM email draft',\n  mapping: 'Import column matches',\n} as const\n\ntype Facts = Readonly<Record<string, unknown>>\n\n/* ------------------------------------------------------------------------ *\n * The rules\n * ------------------------------------------------------------------------ */\n\nconst WRITE_ONLY_FROM_FACTS =\n  'Write only from the facts. Never invent an event, a date, an amount, a name or a promise the facts do not state, and write dates as the facts do.'\n\nconst NEXT_STEP_RULE =\n  'nextStep: the one task that should come next, or null when an open task already covers it or nothing is worth doing. Its title starts with a verb, and its reason names the fact behind it.'\n\nconst LANGUAGE_RULE = 'Write in the language of the facts’ notes and timeline.'\n\nfunction rulesBlock(opening: string, toolName: string, rules: readonly string[]): AiSystemBlock[] {\n  return [\n    {\n      text:\n        `${opening}\\n\\n` +\n        `Answer by calling ${toolName} exactly once. A reply in prose cannot be used.\\n\\n` +\n        `Rules:\\n${rules.map((rule) => `- ${rule}`).join('\\n')}`,\n      cacheBreakpoint: true,\n    },\n  ]\n}\n\n/**\n * The rules for a record of one kind. Each kind is sent the rules its tool can\n * be refused for, and no others: on a model that caches no prompt this short,\n * a rule a request cannot break is paid for on every request.\n */\nexport function aiCrmRecordInstructions(kind: AiCrmRecordKind): AiSystemBlock[] {\n  const opening = `You help a small business's team work its customer records. You are given one ${kind} a team member opened, as facts read from their CRM.`\n  const rules =\n    kind === 'lead'\n      ? [\n          WRITE_ONLY_FROM_FACTS,\n          'summary: two sentences at most: how the lead came in, what it did, and when it was last seen.',\n          'standing: two sentences at most on why the lead stands where it does: its status, how it came in, and how often and how recently it was active. There is no lead score; never give one.',\n          LANGUAGE_RULE,\n        ]\n      : [\n          WRITE_ONLY_FROM_FACTS,\n          `summary: two sentences at most: when the ${kind} was last in touch and how, and what is still open.`,\n          NEXT_STEP_RULE,\n          ...(kind === 'deal'\n            ? [\n                'stage: the open stage the deal should move to, by its id in the facts, only when the timeline shows the deal has moved there; otherwise null, and always null for a deal that is won or lost. Never propose winning or losing a deal.',\n              ]\n            : []),\n          LANGUAGE_RULE,\n        ]\n  return rulesBlock(opening, AI_CRM_RECORD_TOOL_NAME, rules)\n}\n\nexport const AI_CRM_EMAIL_INSTRUCTIONS: AiSystemBlock[] = rulesBlock(\n  'You draft a one-to-one email that a team member reviews, edits and sends themselves from a customer record in their CRM. Nothing is sent until they press Send.',\n  AI_CRM_EMAIL_TOOL_NAME,\n  [\n    'Write what the team member asks for, from the record’s facts. Never invent a price, a date, an offer, a meeting time or a promise that neither states.',\n    'body: plain text in short paragraphs separated by a blank line, with no markdown, no links and no signature block beyond the sign-off.',\n    'Greet the person and sign off only with the merge fields the request lists, written exactly as listed. Use no other merge field.',\n    'Never write an email address or a phone number.',\n    'Write in the language of the team member’s request.',\n  ],\n)\n\nexport const AI_CRM_MAPPING_INSTRUCTIONS: AiSystemBlock[] = rulesBlock(\n  'You match the columns of a spreadsheet a team member is importing into their CRM to the fields the import fills. You are given each column’s header and the shape of its values, never the values.',\n  AI_CRM_MAPPING_TOOL_NAME,\n  [\n    'Match a column only to a field the request lists, both by their numbers, and only when the column’s header says it holds that field. Leave out a column no field fits.',\n    'A field takes at most one column, and a column one field.',\n    'A column’s shape must suit its field: an email field takes an email column; a phone field a phone or number column; a number, date or yes-no field a column of that shape. Only an email field takes an email column. An empty column takes any field its header names.',\n  ],\n)\n\n/* ------------------------------------------------------------------------ *\n * The facts, as the model reads them\n * ------------------------------------------------------------------------ */\n\nconst text = (value: unknown): string => (typeof value === 'string' ? value : '')\nconst list = (value: unknown): Array<Record<string, unknown>> =>\n  Array.isArray(value) ? value.filter((entry): entry is Record<string, unknown> => Boolean(entry) && typeof entry === 'object') : []\nconst words = (value: unknown): string[] => (Array.isArray(value) ? value.map(text).filter(Boolean) : [])\n\nfunction line(label: string, value: unknown): string[] {\n  const shown = typeof value === 'number' ? String(value) : text(value)\n  return shown ? [`${label}: ${shown}`] : []\n}\n\nfunction timelineLines(value: unknown): string[] {\n  const entries = list(value)\n  if (!entries.length) return ['Timeline: nothing logged or captured yet']\n  return [\n    'Timeline, newest first:',\n    ...entries.map((entry) => {\n      const detail = [text(entry['direction']), text(entry['delivery']), text(entry['outcome'])].filter(Boolean)\n      const subject = text(entry['subject'])\n      return (\n        `- ${text(entry['on'])} ${text(entry['kind'])}` +\n        (detail.length ? ` (${detail.join(', ')})` : '') +\n        (subject || entry['text'] ? ':' : '') +\n        (subject ? ` \"${subject}\"` : '') +\n        (text(entry['text']) ? ` ${text(entry['text'])}` : '')\n      )\n    }),\n  ]\n}\n\nfunction taskLines(value: unknown): string[] {\n  const tasks = list(value)\n  if (!tasks.length) return ['Open tasks: none']\n  return [\n    'Open tasks:',\n    ...tasks.map(\n      (task) =>\n        `- ${text(task['title'])} (${[\n          text(task['kind']),\n          `${text(task['priority']) || 'normal'} priority`,\n          task['due'] ? `due ${text(task['due'])}` : 'no due date',\n          ...(task['overdue'] === true ? ['overdue'] : []),\n        ].join(', ')})`,\n    ),\n  ]\n}\n\nfunction dealLines(value: unknown): string[] {\n  const deals = list(value)\n  if (!deals.length) return ['Deals: none']\n  return [\n    'Deals:',\n    ...deals.map(\n      (deal) =>\n        `- ${text(deal['title'])}: ${[\n          text(deal['stage']),\n          text(deal['status']),\n          text(deal['amount']),\n          deal['expectedClose'] ? `expected to close ${text(deal['expectedClose'])}` : '',\n        ]\n          .filter(Boolean)\n          .join(', ')}`,\n    ),\n  ]\n}\n\n/**\n * The facts as lines of text. Only the fields named here are written, whatever\n * else a reader reports, so what reaches a prompt is decided in two places\n * that both have to agree: the CRM's builders and this list.\n */\nexport function aiCrmFactsLines(kind: AiCrmRecordKind, facts: Facts): string[] {\n  if (kind === 'contact') {\n    const orders = Number(facts['orders']) || 0\n    return [\n      ...line('Contact', facts['name']),\n      ...line('Job title', facts['jobTitle']),\n      ...line('Company', facts['company']),\n      ...line('Lifecycle stage', facts['lifecycleStage']),\n      ...line('Tags', words(facts['tags']).join(', ')),\n      ...line('Came in through', words(facts['sources']).join(', ')),\n      ...(orders ? [`Orders: ${orders}${facts['lastPurchase'] ? `, the last on ${text(facts['lastPurchase'])}` : ''}`] : []),\n      ...line('In the CRM since', facts['since']),\n      ...line('Last opened or clicked an email', facts['lastEmailEngagement']),\n      ...line('Notes', facts['notes']),\n      ...timelineLines(facts['timeline']),\n      ...taskLines(facts['openTasks']),\n      ...dealLines(facts['deals']),\n    ]\n  }\n  if (kind === 'company') {\n    return [\n      ...line('Company', facts['name']),\n      ...line('Domain', facts['domain']),\n      ...line('Industry', facts['industry']),\n      ...line('Tags', words(facts['tags']).join(', ')),\n      ...line('People in the CRM', facts['people']),\n      ...line('In the CRM since', facts['since']),\n      ...line('Notes', facts['notes']),\n      ...timelineLines(facts['timeline']),\n      ...taskLines(facts['openTasks']),\n      ...dealLines(facts['deals']),\n    ]\n  }\n  if (kind === 'deal') {\n    const stages = list(facts['stages'])\n    const withWhom = [text(facts['contact']), text(facts['company'])].filter(Boolean).join(' at ')\n    return [\n      ...line('Deal', facts['title']),\n      ...line('Pipeline', facts['pipeline']),\n      ...line('Status', facts['status']),\n      ...line('Stage', facts['stage'] ? `${text(facts['stage'])} (id ${text(facts['stageId'])})` : ''),\n      ...line('Stages in order', stages.map((stage) => `${text(stage['id'])} \"${text(stage['name'])}\" (${text(stage['kind'])})`).join('; ')),\n      ...line('In this stage since', facts['inStageSince']),\n      ...line('Amount', facts['amount']),\n      ...line('Expected to close', facts['expectedClose']),\n      ...line('Lost reason', facts['lostReason']),\n      ...line('With', withWhom),\n      ...line('Products on the deal', Number(facts['products']) || ''),\n      ...line('In the CRM since', facts['since']),\n      ...line('Notes', facts['notes']),\n      ...timelineLines(facts['timeline']),\n      ...taskLines(facts['openTasks']),\n    ]\n  }\n  return [\n    ...line('Lead', facts['name']),\n    ...line('Status', facts['status']),\n    ...line('Captured through', words(facts['sources']).join(', ')),\n    ...line('Captures', Number(facts['captures']) || ''),\n    ...line('First seen', facts['firstSeen']),\n    ...line('Last seen', facts['lastSeen']),\n    `Assigned to a teammate: ${facts['assigned'] === true ? 'yes' : 'no'}`,\n    `Converted to a contact: ${facts['converted'] === true ? 'yes' : 'no'}`,\n    ...line('Unqualified reason', facts['unqualifiedReason']),\n    ...line('Notes', facts['notes']),\n    ...timelineLines(facts['timeline']),\n  ]\n}\n\n/** The user turn for a record. */\nexport function aiCrmRecordPrompt(kind: AiCrmRecordKind, facts: Facts): string {\n  return [`Record: ${kind}`, ...aiCrmFactsLines(kind, facts)].join('\\n')\n}\n\n/** The user turn for an email draft. */\nexport function aiCrmEmailPrompt(input: { kind: AiCrmRecordKind; facts: Facts; request: string }): string {\n  return [\n    `Record: ${input.kind}`,\n    `Merge fields: ${aiCrmEmailMergeFields(input.kind).map((key) => `{{${key}}}`).join(', ')}`,\n    `The team member asks: ${input.request.replace(/\\s+/g, ' ').trim().slice(0, AI_CRM_EMAIL_REQUEST_MAX_CHARS)}`,\n    '',\n    'Facts:',\n    ...aiCrmFactsLines(input.kind, input.facts),\n  ].join('\\n')\n}\n\n/** The user turn for an import's columns. */\nexport function aiCrmMappingPrompt(input: {\n  collection: string\n  fields: readonly AiCrmImportField[]\n  columns: ReadonlyArray<{ header: string; shape: string }>\n}): string {\n  return [\n    `Import: ${input.collection}`,\n    'Fields (number: label, type):',\n    ...input.fields.map(\n      (field, index) => `- ${index}: ${field.label}, ${field.type}${field.required ? ', required' : ''}`,\n    ),\n    'Columns (number: header, shape):',\n    ...input.columns.map((column, index) => `- ${index}: ${column.header || '(no header)'}, ${column.shape}`),\n  ].join('\\n')\n}\n\n/* ------------------------------------------------------------------------ *\n * A record answer, asked once per timeline\n * ------------------------------------------------------------------------ */\n\n/**\n * A digest of the whole request a record answer is produced for. A hash of the\n * request, never of the answer, and nothing of the facts is recoverable from\n * it. The version tag strands every old key when what a key means changes.\n */\nexport function aiCrmRecordKey(input: {\n  kind: AiCrmRecordKind\n  id: string\n  hostId: string | null\n  model: string\n  prompt: string\n  system: readonly AiSystemBlock[]\n  tool: AiTool\n}): string {\n  const digest = createHash('sha256')\n  for (const part of [\n    'crm-record.v1',\n    input.kind,\n    input.id,\n    input.hostId ?? '',\n    input.model,\n    input.prompt,\n    ...input.system.map((block) => block.text),\n    JSON.stringify(input.tool),\n  ]) {\n    digest.update(`${part.length}:${part}\\u0000`)\n  }\n  return digest.digest('hex')\n}\n\n/** A kept answer about a record, as the reuse lookup reads it. */\nexport interface AiCrmAnswerCandidate {\n  jobId: string\n  hostId: string | null\n  task: string\n  key: string | null\n  createdAtMs: number | null\n  proposal: AiCrmProposal | null\n}\n\nexport type AiCrmAnswerFinder = (\n  orgId: string,\n  key: string,\n  firestore?: FirebaseFirestore.Firestore,\n) => Promise<AiCrmAnswerCandidate[]>\n\nconst millis = (value: unknown): number | null => {\n  if (value instanceof Date) return value.getTime()\n  const toMillis = (value as { toMillis?: () => number } | null)?.toMillis\n  return typeof toMillis === 'function' ? toMillis.call(value) : null\n}\n\n/**\n * The finder the step uses in production: one equality on the request key\n * inside the org's kept answers. Firestore's automatic single-field index\n * answers it, so no composite index is deployed; the site and the window are\n * applied in memory.\n */\nexport const findAiCrmAnswersByKey: AiCrmAnswerFinder = async (orgId, key, firestore) => {\n  if (!firestore) return []\n  const snapshot = await firestore\n    .collection('orgs')\n    .doc(orgId)\n    .collection(AI_CRM_ANSWERS_COLLECTION)\n    .where('key', '==', key)\n    .limit(AI_CRM_REUSE_CANDIDATES)\n    .get()\n  return snapshot.docs.map((doc) => {\n    const data = (doc.data() ?? {}) as Partial<AiCrmAnswerRecord>\n    return {\n      jobId: doc.id,\n      hostId: data.hostId ?? null,\n      task: String(data.task ?? ''),\n      key: data.key ?? null,\n      createdAtMs: millis(data.createdAt),\n      proposal: readAiCrmProposal(data.proposal),\n    }\n  })\n}\n\n/** The newest answer another job kept for the same request, inside the window. */\nexport function aiReusableCrmRecord(\n  candidates: readonly AiCrmAnswerCandidate[],\n  context: { jobId: string; hostId: string | null; key: string; now: Date },\n): { jobId: string; proposal: AiCrmRecordProposal } | null {\n  const floor = context.now.getTime() - AI_CRM_REUSE_WINDOW_MS\n  let best: { jobId: string; proposal: AiCrmRecordProposal; at: number } | null = null\n  for (const candidate of candidates) {\n    if (candidate.jobId === context.jobId || candidate.task !== 'record') continue\n    if (candidate.hostId !== context.hostId || candidate.key !== context.key) continue\n    if (candidate.proposal?.kind !== 'record') continue\n    const at = candidate.createdAtMs ?? 0\n    if (at < floor) continue\n    if (!best || at > best.at) best = { jobId: candidate.jobId, proposal: candidate.proposal, at }\n  }\n  return best ? { jobId: best.jobId, proposal: best.proposal } : null\n}\n\n/* ------------------------------------------------------------------------ *\n * Admission\n * ------------------------------------------------------------------------ */\n\nexport interface AiCrmAdmissionDeps {\n  readerFor?: AiCrmReaderLookup\n  now?: () => Date\n}\n\n/**\n * Whether a `crm` job may start here for this member; `null` admits it: its\n * inputs name a record or an import, and the CRM would let the member read it\n * ({@link aiCrmAccessRefusal}). Asked at the create door before the job\n * exists, so a refusal spends nothing. A door that names no member asks\n * nothing of the reader.\n */\nexport async function aiCrmAdmissionRefusal(\n  context: Parameters<AiJobAdmission>[0],\n  deps: AiCrmAdmissionDeps = {},\n): Promise<AiJobAdmissionRefusal | null> {\n  const request = parseAiCrmRequest(context.inputs)\n  if (typeof request === 'string') return { status: 400, error: request }\n  return aiCrmAccessRefusal({\n    firestore: context.firestore,\n    orgId: context.orgId,\n    hostId: context.hostId ?? null,\n    ...aiCrmFactsResource(request),\n    org: context.org,\n    uid: context.uid,\n    ...(deps.readerFor ? { readerFor: deps.readerFor } : {}),\n    now: deps.now?.() ?? new Date(),\n  })\n}\n\nexport const aiCrmJobAdmission: AiJobAdmission = (context) => aiCrmAdmissionRefusal(context)\n\n/* ------------------------------------------------------------------------ *\n * The runner\n * ------------------------------------------------------------------------ */\n\nexport interface AiJobCrmStepDeps {\n  readerFor?: AiCrmReaderLookup\n  /** The reuse lookup; specs hand in a fake, and `null` turns reuse off. */\n  findAnswersByKey?: AiCrmAnswerFinder | null\n}\n\nfunction modelOf(context: AiJobStepContext): string {\n  return context.modelFor?.('job.crm') ?? aiModelForStep('job.crm')\n}\n\n/** An answer as the step hands it to be kept; the job's ids and the clock are added. */\ntype AiCrmAnswerToKeep = Pick<AiCrmAnswerRecord, 'task' | 'resource' | 'recordId' | 'proposal' | 'key'>\n\n/** What a step spent, whatever outputs it goes on to name. */\ntype AiCrmSpent = Omit<AiJobStepOutcome, 'outputs'>\n\n/**\n * Keeps an answer at `orgs/{orgId}/aiCrmAnswers/{jobId}`, which no client may\n * read, on its own clock.\n */\nasync function keepAiCrmAnswer(context: AiJobStepContext, answer: AiCrmAnswerToKeep): Promise<void> {\n  const { job, now, firestore } = context\n  const record = JSON.parse(\n    JSON.stringify({ jobId: job.$id, orgId: job.orgId, hostId: job.hostId ?? null, createdBy: job.createdBy, ...answer }),\n  ) as AiCrmAnswerRecord\n  await firestore\n    .collection('orgs')\n    .doc(job.orgId)\n    .collection(AI_CRM_ANSWERS_COLLECTION)\n    .doc(job.$id)\n    .set({ ...record, createdAt: now, expiresAt: aiCrmAnswerExpiry(now) })\n}\n\nexport function createAiJobCrmStep(deps: AiJobCrmStepDeps = {}): AiJobStepRunner {\n  const readerFor = deps.readerFor ?? pluginRecordFactsReader\n  const findAnswersByKey = deps.findAnswersByKey === undefined ? findAiCrmAnswersByKey : deps.findAnswersByKey\n  return async (context): Promise<AiJobStepOutcome> => {\n    const { job, now, signal, firestore } = context\n    const model = modelOf(context)\n    const request = parseAiCrmRequest(job.inputs)\n    if (typeof request === 'string') return { ...aiUnspentOutcome(model), failure: request }\n    const { resource, id } = aiCrmFactsResource(request)\n    const found = readerFor(resource)\n    if (!found || found.pluginId !== AI_CRM_PLUGIN_ID) {\n      return { ...aiUnspentOutcome(model), failure: AI_CRM_UNAVAILABLE_COPY }\n    }\n    let facts: Facts\n    try {\n      const read = await found.reader.read({\n        orgId: job.orgId,\n        hostId: job.hostId ?? null,\n        id,\n        // The job's creator: the CRM reads the record as the member who asked.\n        uid: job.createdBy,\n        org: (context.org as Record<string, unknown> | null | undefined) ?? null,\n        now,\n      })\n      if (read.ok === false) return { ...aiUnspentOutcome(model), failure: read.error }\n      facts = read.facts\n    } catch (error) {\n      console.error('ai crm facts read failed', { orgId: job.orgId, jobId: job.$id, resource, error })\n      return { ...aiUnspentOutcome(model), failure: AI_CRM_FACTS_FAILURE_COPY }\n    }\n    const maxTokens = AI_JOB_CRM_STEP_BUDGET.maxTokens(model)\n    const hostId = job.hostId ?? null\n\n    // Keeps the answer, then names it on the job. A keep that fails fails the\n    // step as spent: the tokens were used, and there is nothing to show.\n    const keep = async (\n      spent: AiCrmSpent,\n      answer: AiCrmAnswerToKeep,\n      output: { id: string; label: string; ref: AiCrmOutputRef },\n    ): Promise<AiJobStepOutcome> => {\n      try {\n        await keepAiCrmAnswer(context, answer)\n      } catch (error) {\n        console.error('ai crm answer keep failed', { orgId: job.orgId, jobId: job.$id, error })\n        return { ...spent, outputs: [], failure: AI_CRM_KEEP_FAILURE_COPY }\n      }\n      return {\n        ...spent,\n        outputs: [{ resource: 'crm', id: output.id, hostId, label: output.label, proposal: { ...output.ref } }],\n      }\n    }\n\n    if (request.task === 'record') {\n      const { kind } = request.record\n      if (facts['record'] !== kind) return { ...aiUnspentOutcome(model), failure: AI_CRM_FACTS_FAILURE_COPY }\n      const instructions = aiCrmRecordInstructions(kind)\n      const tool = aiCrmRecordTool(kind)\n      const prompt = aiCrmRecordPrompt(kind, facts)\n      const key = aiCrmRecordKey({\n        kind,\n        id,\n        hostId,\n        model,\n        prompt,\n        system: aiDoctrineSystemBlocks(undefined, {\n          instructions,\n          scope: aiDoctrineScopeFor(AI_CRM_GENERATION_KINDS.record),\n        }),\n        tool,\n      })\n      const output = { id: AI_CRM_OUTPUT_IDS.record(kind, id), label: OUTPUT_LABELS.record, ref: { kind: 'record', record: { kind, id } } } as const\n      // Reuse before asking: an answer kept for the same key is the same\n      // request, so the member reads it again at no cost.\n      const reused = findAnswersByKey\n        ? aiReusableCrmRecord(await findAnswersByKey(job.orgId, key, firestore).catch(() => []), {\n            jobId: job.$id,\n            hostId,\n            key,\n            now,\n          })\n        : null\n      if (reused) {\n        return keep(\n          aiUnspentOutcome(model),\n          { task: 'record', resource, recordId: id, key, proposal: { ...reused.proposal, reusedFrom: reused.jobId } },\n          output,\n        )\n      }\n      const generation = await runValidatedGeneration(AI_CRM_GENERATION_KINDS.record, {\n        step: 'job.crm',\n        model,\n        instructions,\n        messages: [{ role: 'user', content: prompt }],\n        tool,\n        maxTokens,\n        ...(signal ? { signal } : {}),\n        check: (answer) => checkAiCrmRecord(answer, aiCrmRecordCheckContext(kind, facts)),\n      })\n      const spent = aiGenerationSpent(generation)\n      if (generation.status === 'refused') return { ...spent, refused: true }\n      if (generation.status === 'needs_input') return { ...spent, failure: generation.message }\n      const proposal: AiCrmRecordProposal = {\n        kind: 'record',\n        record: { kind, id },\n        summary: generation.value.summary,\n        nextStep: generation.value.nextStep,\n        stage: generation.value.stage,\n        standing: generation.value.standing,\n        asOf: now.toISOString().slice(0, 10),\n      }\n      return keep(spent, { task: 'record', resource, recordId: id, key, proposal }, output)\n    }\n\n    if (request.task === 'email') {\n      const { kind } = request.record\n      if (facts['record'] !== kind) return { ...aiUnspentOutcome(model), failure: AI_CRM_FACTS_FAILURE_COPY }\n      const mergeFields = aiCrmEmailMergeFields(kind)\n      const generation = await runValidatedGeneration(AI_CRM_GENERATION_KINDS.email, {\n        step: 'job.crm',\n        model,\n        instructions: AI_CRM_EMAIL_INSTRUCTIONS,\n        messages: [{ role: 'user', content: aiCrmEmailPrompt({ kind, facts, request: job.brief }) }],\n        tool: AI_CRM_EMAIL_TOOL,\n        maxTokens,\n        ...(signal ? { signal } : {}),\n        check: (answer) => checkAiCrmEmail(answer, { mergeFields }),\n      })\n      const spent = aiGenerationSpent(generation)\n      if (generation.status === 'refused') return { ...spent, refused: true }\n      if (generation.status === 'needs_input') return { ...spent, failure: generation.message }\n      const proposal: AiCrmEmailProposal = {\n        kind: 'email',\n        record: { kind, id },\n        subject: generation.value.subject,\n        body: generation.value.body,\n      }\n      return keep(\n        spent,\n        { task: 'email', resource, recordId: id, key: null, proposal },\n        { id: AI_CRM_OUTPUT_IDS.email(kind, id), label: OUTPUT_LABELS.email, ref: { kind: 'email', record: { kind, id } } },\n      )\n    }\n\n    const fields = aiCrmImportFields(facts)\n    if (facts['record'] !== 'import' || !fields.length) {\n      return { ...aiUnspentOutcome(model), failure: AI_CRM_FACTS_FAILURE_COPY }\n    }\n    const generation = await runValidatedGeneration(AI_CRM_GENERATION_KINDS.mapping, {\n      step: 'job.crm',\n      model,\n      instructions: AI_CRM_MAPPING_INSTRUCTIONS,\n      messages: [\n        {\n          role: 'user',\n          content: aiCrmMappingPrompt({ collection: request.collection, fields, columns: request.columns }),\n        },\n      ],\n      tool: AI_CRM_MAPPING_TOOL,\n      maxTokens,\n      ...(signal ? { signal } : {}),\n      check: (answer) => checkAiCrmMapping(answer, { columns: request.columns, fields }),\n    })\n    const spent = aiGenerationSpent(generation)\n    if (generation.status === 'refused') return { ...spent, refused: true }\n    if (generation.status === 'needs_input') return { ...spent, failure: generation.message }\n    const proposal: AiCrmMappingProposal = {\n      kind: 'mapping',\n      collection: request.collection,\n      matches: generation.value,\n      columns: request.columns.length,\n    }\n    return keep(\n      spent,\n      { task: 'mapping', resource, recordId: request.collection, key: null, proposal },\n      {\n        id: AI_CRM_OUTPUT_IDS.mapping(request.collection),\n        label: OUTPUT_LABELS.mapping,\n        ref: { kind: 'mapping', collection: request.collection },\n      },\n    )\n  }\n}\n\nexport const runAiJobCrmStep = createAiJobCrmStep()\n\n/** Registers the CRM step and the check a `crm` job passes before it is created. */\nexport function registerAiCrmJob(): void {\n  registerAiJobStep('crm', runAiJobCrmStep, { minimumMs: AI_JOB_CRM_STEP_MINIMUM_MS })\n  registerAiJobAdmission('crm', aiCrmJobAdmission)\n}\n"],"names":["createHash","pluginRecordFactsReader","AI_CRM_ANSWER_RETENTION_DAYS","AI_CRM_ANSWERS_COLLECTION","AI_CRM_EMAIL_REQUEST_MAX_CHARS","AI_CRM_OUTPUT_IDS","AI_CRM_PLUGIN_ID","aiCrmAnswerExpiry","parseAiCrmRequest","readAiCrmProposal","AI_STEP_TIERS","AI_ROUTING_TABLE","aiModelForStep","aiDoctrineScopeFor","aiDoctrineSystemBlocks","runValidatedGeneration","AI_CRM_EMAIL_TOOL","AI_CRM_EMAIL_TOOL_NAME","AI_CRM_MAPPING_TOOL","AI_CRM_MAPPING_TOOL_NAME","AI_CRM_RECORD_TOOL_NAME","aiCrmEmailMergeFields","aiCrmImportFields","aiCrmRecordCheckContext","aiCrmRecordTool","checkAiCrmEmail","checkAiCrmMapping","checkAiCrmRecord","AI_CRM_UNAVAILABLE_COPY","aiCrmAccessRefusal","aiCrmFactsResource","registerAiJobAdmission","aiJobStepBudget","aiGenerationSpent","aiUnspentOutcome","registerAiJobStep","AI_CRM_FACTS_READS_MS","AI_JOB_CRM_STEP_BUDGET","tier","maxTokens","lookups","ownReadsMs","AI_JOB_CRM_STEP_MINIMUM_MS","minimumMs","AI_CRM_REUSE_CANDIDATES","AI_CRM_REUSE_WINDOW_MS","AI_CRM_FACTS_FAILURE_COPY","AI_CRM_KEEP_FAILURE_COPY","AI_CRM_GENERATION_KINDS","record","email","mapping","OUTPUT_LABELS","WRITE_ONLY_FROM_FACTS","NEXT_STEP_RULE","LANGUAGE_RULE","rulesBlock","opening","toolName","rules","text","map","rule","join","cacheBreakpoint","aiCrmRecordInstructions","kind","AI_CRM_EMAIL_INSTRUCTIONS","AI_CRM_MAPPING_INSTRUCTIONS","value","list","Array","isArray","filter","entry","Boolean","words","line","label","shown","String","timelineLines","entries","length","detail","subject","taskLines","tasks","task","dealLines","deals","deal","aiCrmFactsLines","facts","orders","Number","stages","withWhom","stage","aiCrmRecordPrompt","aiCrmEmailPrompt","input","key","request","replace","trim","slice","aiCrmMappingPrompt","collection","fields","field","index","type","required","columns","column","header","shape","aiCrmRecordKey","digest","part","id","hostId","model","prompt","system","block","JSON","stringify","tool","update","millis","Date","getTime","toMillis","call","findAiCrmAnswersByKey","orgId","firestore","snapshot","doc","where","limit","get","docs","data","jobId","createdAtMs","createdAt","proposal","aiReusableCrmRecord","candidates","context","floor","now","best","candidate","at","aiCrmAdmissionRefusal","deps","inputs","status","error","org","uid","readerFor","aiCrmJobAdmission","modelOf","modelFor","keepAiCrmAnswer","answer","job","parse","$id","createdBy","set","expiresAt","createAiJobCrmStep","findAnswersByKey","undefined","signal","failure","resource","found","pluginId","read","reader","ok","console","keep","spent","output","outputs","ref","instructions","scope","reused","catch","recordId","reusedFrom","generation","step","messages","role","content","check","refused","message","summary","nextStep","standing","asOf","toISOString","mergeFields","brief","body","matches","runAiJobCrmStep","registerAiCrmJob"],"mappings":"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"}

package/src/lib/jobs/ai-job-draft-ids.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @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 { AiBuildPlan } from '../model/ai-build-plan';
+import type { AiJob, AiJobDraftSlot, AiJobKind } from '../model/ai-jobs.types';
+/**
+ * The ids a job's drafts are written under (AGL-3079).
+ *
+ * A draft a job writes is the resource a member would otherwise have made in
+ * the console, so it is named the way the console names one: by
+ * `createResourceUid()`. Each id is minted ONCE and recorded on the job before
+ * the draft is written. That record is what lets a step run again safely: a
+ * run cut off after its write reads the same id, finds the draft, and reports
+ * it rather than writing a second.
+ *
+ * Where an id is recorded follows what decides the draft exists:
+ *
+ *  - A draft the job's KIND always writes — a layout job's layout, a page
+ *    job's screen, a campaign's design and campaign — is minted when the job
+ *    is created, on the step that writes it (`AiJobStep.draftIds`).
+ *  - A draft the PLAN decides — what a page job's plan creates, a scaffold's
+ *    layout, form and pages — is minted when the plan is kept, on the plan's
+ *    own entry (`AiBuildPlanCreate.id`, `AiBuildPlanScreen.id`). Those are
+ *    built one unit a pass by the step that owns their kind, under a job named
+ *    by the entry's id (`aiSiteUnitJob`).
+ *
+ * A job whose step records no id names its draft by the job's own id, which
+ * is the id every draft of such a job was written under.
+ */
+/** The drafts each kind's step writes of its own, whatever its plan says. */
+export declare const AI_JOB_DRAFT_SLOTS: Readonly<Partial<Record<AiJobKind, readonly AiJobDraftSlot[]>>>;
+/** Fresh ids for the drafts a job of this kind writes of its own; `null` for a kind that writes none. */
+export declare function aiMintJobDraftIds(kind: AiJobKind): Partial<Record<AiJobDraftSlot, string>> | null;
+/** The id recorded on the job's steps for its draft of `slot`; `null` where none is. */
+export declare function aiRecordedJobDraftId(job: Pick<AiJob, 'steps'>, slot: AiJobDraftSlot): string | null;
+/**
+ * The id the job writes its draft of `slot` under, and finds it by when the
+ * step runs again: the id recorded on its step, else the job's own id — which
+ * names a unit's job by its plan entry's id, and a job whose step records none.
+ */
+export declare function aiJobDraftId(job: Pick<AiJob, '$id' | 'steps'>, slot: AiJobDraftSlot): string;
+/**
+ * The plan as a job of `kind` keeps it: for a kind that builds what its plan
+ * names, a fresh id on every creation it writes as a document and, for a
+ * scaffold, on every screen. An id the plan already carried is replaced —
+ * a plan reused from another job names that job's drafts — so the drafts
+ * this job builds are its own. Any other kind's plan is kept as it is.
+ */
+export declare function aiPlanWithDraftIds<T extends AiBuildPlan>(kind: AiJobKind, plan: T): T;

package/src/lib/jobs/ai-job-draft-ids.js

@@ -0,0 +1,132 @@
+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 { createResourceUid } from "@aglyn/aglyn/app-utils/create-resource-uid";
+/**
+ * The ids a job's drafts are written under (AGL-3079).
+ *
+ * A draft a job writes is the resource a member would otherwise have made in
+ * the console, so it is named the way the console names one: by
+ * `createResourceUid()`. Each id is minted ONCE and recorded on the job before
+ * the draft is written. That record is what lets a step run again safely: a
+ * run cut off after its write reads the same id, finds the draft, and reports
+ * it rather than writing a second.
+ *
+ * Where an id is recorded follows what decides the draft exists:
+ *
+ *  - A draft the job's KIND always writes — a layout job's layout, a page
+ *    job's screen, a campaign's design and campaign — is minted when the job
+ *    is created, on the step that writes it (`AiJobStep.draftIds`).
+ *  - A draft the PLAN decides — what a page job's plan creates, a scaffold's
+ *    layout, form and pages — is minted when the plan is kept, on the plan's
+ *    own entry (`AiBuildPlanCreate.id`, `AiBuildPlanScreen.id`). Those are
+ *    built one unit a pass by the step that owns their kind, under a job named
+ *    by the entry's id (`aiSiteUnitJob`).
+ *
+ * A job whose step records no id names its draft by the job's own id, which
+ * is the id every draft of such a job was written under.
+ */ /** The drafts each kind's step writes of its own, whatever its plan says. */ export const AI_JOB_DRAFT_SLOTS = {
+    page: [
+        'screen'
+    ],
+    layout: [
+        'layout'
+    ],
+    template: [
+        'template'
+    ],
+    form: [
+        'form'
+    ],
+    component: [
+        'component'
+    ],
+    email: [
+        'email'
+    ],
+    campaign: [
+        'email',
+        'campaign'
+    ],
+    workflow: [
+        'workflow'
+    ],
+    // The welcome email a scaffold builds; its pages and creations are its plan's.
+    site: [
+        'email'
+    ]
+};
+/** Fresh ids for the drafts a job of this kind writes of its own; `null` for a kind that writes none. */ export function aiMintJobDraftIds(kind) {
+    const slots = AI_JOB_DRAFT_SLOTS[kind];
+    if (!(slots == null ? void 0 : slots.length)) return null;
+    return Object.fromEntries(slots.map((slot)=>[
+            slot,
+            createResourceUid()
+        ]));
+}
+/** The id recorded on the job's steps for its draft of `slot`; `null` where none is. */ export function aiRecordedJobDraftId(job, slot) {
+    var _job_steps;
+    for (const step of (_job_steps = job.steps) != null ? _job_steps : []){
+        var _step_draftIds;
+        const id = (_step_draftIds = step.draftIds) == null ? void 0 : _step_draftIds[slot];
+        if (typeof id === 'string' && id) return id;
+    }
+    return null;
+}
+/**
+ * The id the job writes its draft of `slot` under, and finds it by when the
+ * step runs again: the id recorded on its step, else the job's own id — which
+ * names a unit's job by its plan entry's id, and a job whose step records none.
+ */ export function aiJobDraftId(job, slot) {
+    var _aiRecordedJobDraftId;
+    return (_aiRecordedJobDraftId = aiRecordedJobDraftId(job, slot)) != null ? _aiRecordedJobDraftId : job.$id;
+}
+/** The creations a job writes as documents: a theme change is a proposal, and no job writes a dataset. */ const DRAFT_CREATION_KINDS = new Set([
+    'component',
+    'form',
+    'layout',
+    'template',
+    'email'
+]);
+/** The kinds whose step builds what their plan names, one unit a draft, and whether that includes its screens. */ const UNIT_PLAN_KINDS = {
+    // A page job's own screen is its kind's draft; its plan's creations are units.
+    page: {
+        screens: false
+    },
+    site: {
+        screens: true
+    }
+};
+/**
+ * The plan as a job of `kind` keeps it: for a kind that builds what its plan
+ * names, a fresh id on every creation it writes as a document and, for a
+ * scaffold, on every screen. An id the plan already carried is replaced —
+ * a plan reused from another job names that job's drafts — so the drafts
+ * this job builds are its own. Any other kind's plan is kept as it is.
+ */ export function aiPlanWithDraftIds(kind, plan) {
+    const units = UNIT_PLAN_KINDS[kind];
+    if (!units) return plan;
+    return _extends({}, plan, {
+        create: plan.create.map((entry)=>DRAFT_CREATION_KINDS.has(entry.kind) ? _extends({}, entry, {
+                id: createResourceUid()
+            }) : entry),
+        screens: units.screens ? plan.screens.map((screen)=>_extends({}, screen, {
+                id: createResourceUid()
+            })) : plan.screens
+    });
+}
+
+//# sourceMappingURL=ai-job-draft-ids.js.map

package/src/lib/jobs/ai-job-draft-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-draft-ids.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 { createResourceUid } from '@aglyn/aglyn/app-utils/create-resource-uid'\nimport type { AiBuildPlan, AiBuildPlanCreateKind } from '../model/ai-build-plan'\nimport type { AiJob, AiJobDraftSlot, AiJobKind } from '../model/ai-jobs.types'\n\n/**\n * The ids a job's drafts are written under (AGL-3079).\n *\n * A draft a job writes is the resource a member would otherwise have made in\n * the console, so it is named the way the console names one: by\n * `createResourceUid()`. Each id is minted ONCE and recorded on the job before\n * the draft is written. That record is what lets a step run again safely: a\n * run cut off after its write reads the same id, finds the draft, and reports\n * it rather than writing a second.\n *\n * Where an id is recorded follows what decides the draft exists:\n *\n *  - A draft the job's KIND always writes — a layout job's layout, a page\n *    job's screen, a campaign's design and campaign — is minted when the job\n *    is created, on the step that writes it (`AiJobStep.draftIds`).\n *  - A draft the PLAN decides — what a page job's plan creates, a scaffold's\n *    layout, form and pages — is minted when the plan is kept, on the plan's\n *    own entry (`AiBuildPlanCreate.id`, `AiBuildPlanScreen.id`). Those are\n *    built one unit a pass by the step that owns their kind, under a job named\n *    by the entry's id (`aiSiteUnitJob`).\n *\n * A job whose step records no id names its draft by the job's own id, which\n * is the id every draft of such a job was written under.\n */\n\n/** The drafts each kind's step writes of its own, whatever its plan says. */\nexport const AI_JOB_DRAFT_SLOTS: Readonly<Partial<Record<AiJobKind, readonly AiJobDraftSlot[]>>> = {\n  page: ['screen'],\n  layout: ['layout'],\n  template: ['template'],\n  form: ['form'],\n  component: ['component'],\n  email: ['email'],\n  campaign: ['email', 'campaign'],\n  workflow: ['workflow'],\n  // The welcome email a scaffold builds; its pages and creations are its plan's.\n  site: ['email'],\n}\n\n/** Fresh ids for the drafts a job of this kind writes of its own; `null` for a kind that writes none. */\nexport function aiMintJobDraftIds(kind: AiJobKind): Partial<Record<AiJobDraftSlot, string>> | null {\n  const slots = AI_JOB_DRAFT_SLOTS[kind]\n  if (!slots?.length) return null\n  return Object.fromEntries(slots.map((slot) => [slot, createResourceUid()]))\n}\n\n/** The id recorded on the job's steps for its draft of `slot`; `null` where none is. */\nexport function aiRecordedJobDraftId(job: Pick<AiJob, 'steps'>, slot: AiJobDraftSlot): string | null {\n  for (const step of job.steps ?? []) {\n    const id = step.draftIds?.[slot]\n    if (typeof id === 'string' && id) return id\n  }\n  return null\n}\n\n/**\n * The id the job writes its draft of `slot` under, and finds it by when the\n * step runs again: the id recorded on its step, else the job's own id — which\n * names a unit's job by its plan entry's id, and a job whose step records none.\n */\nexport function aiJobDraftId(job: Pick<AiJob, '$id' | 'steps'>, slot: AiJobDraftSlot): string {\n  return aiRecordedJobDraftId(job, slot) ?? job.$id\n}\n\n/** The creations a job writes as documents: a theme change is a proposal, and no job writes a dataset. */\nconst DRAFT_CREATION_KINDS: ReadonlySet<AiBuildPlanCreateKind> = new Set<AiBuildPlanCreateKind>([\n  'component',\n  'form',\n  'layout',\n  'template',\n  'email',\n])\n\n/** The kinds whose step builds what their plan names, one unit a draft, and whether that includes its screens. */\nconst UNIT_PLAN_KINDS: Readonly<Partial<Record<AiJobKind, { screens: boolean }>>> = {\n  // A page job's own screen is its kind's draft; its plan's creations are units.\n  page: { screens: false },\n  site: { screens: true },\n}\n\n/**\n * The plan as a job of `kind` keeps it: for a kind that builds what its plan\n * names, a fresh id on every creation it writes as a document and, for a\n * scaffold, on every screen. An id the plan already carried is replaced —\n * a plan reused from another job names that job's drafts — so the drafts\n * this job builds are its own. Any other kind's plan is kept as it is.\n */\nexport function aiPlanWithDraftIds<T extends AiBuildPlan>(kind: AiJobKind, plan: T): T {\n  const units = UNIT_PLAN_KINDS[kind]\n  if (!units) return plan\n  return {\n    ...plan,\n    create: plan.create.map((entry) =>\n      DRAFT_CREATION_KINDS.has(entry.kind) ? { ...entry, id: createResourceUid() } : entry,\n    ),\n    screens: units.screens ? plan.screens.map((screen) => ({ ...screen, id: createResourceUid() })) : plan.screens,\n  }\n}\n"],"names":["createResourceUid","AI_JOB_DRAFT_SLOTS","page","layout","template","form","component","email","campaign","workflow","site","aiMintJobDraftIds","kind","slots","length","Object","fromEntries","map","slot","aiRecordedJobDraftId","job","step","steps","id","draftIds","aiJobDraftId","$id","DRAFT_CREATION_KINDS","Set","UNIT_PLAN_KINDS","screens","aiPlanWithDraftIds","plan","units","create","entry","has","screen"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,iBAAiB,QAAQ,6CAA4C;AAI9E;;;;;;;;;;;;;;;;;;;;;;;CAuBC,GAED,2EAA2E,GAC3E,OAAO,MAAMC,qBAAsF;IACjGC,MAAM;QAAC;KAAS;IAChBC,QAAQ;QAAC;KAAS;IAClBC,UAAU;QAAC;KAAW;IACtBC,MAAM;QAAC;KAAO;IACdC,WAAW;QAAC;KAAY;IACxBC,OAAO;QAAC;KAAQ;IAChBC,UAAU;QAAC;QAAS;KAAW;IAC/BC,UAAU;QAAC;KAAW;IACtB,+EAA+E;IAC/EC,MAAM;QAAC;KAAQ;AACjB,EAAC;AAED,uGAAuG,GACvG,OAAO,SAASC,kBAAkBC,IAAe;IAC/C,MAAMC,QAAQZ,kBAAkB,CAACW,KAAK;IACtC,IAAI,EAACC,yBAAAA,MAAOC,MAAM,GAAE,OAAO;IAC3B,OAAOC,OAAOC,WAAW,CAACH,MAAMI,GAAG,CAAC,CAACC,OAAS;YAACA;YAAMlB;SAAoB;AAC3E;AAEA,sFAAsF,GACtF,OAAO,SAASmB,qBAAqBC,GAAyB,EAAEF,IAAoB;QAC/DE;IAAnB,KAAK,MAAMC,SAAQD,aAAAA,IAAIE,KAAK,YAATF,aAAa,EAAE,CAAE;YACvBC;QAAX,MAAME,MAAKF,iBAAAA,KAAKG,QAAQ,qBAAbH,cAAe,CAACH,KAAK;QAChC,IAAI,OAAOK,OAAO,YAAYA,IAAI,OAAOA;IAC3C;IACA,OAAO;AACT;AAEA;;;;CAIC,GACD,OAAO,SAASE,aAAaL,GAAiC,EAAEF,IAAoB;QAC3EC;IAAP,QAAOA,wBAAAA,qBAAqBC,KAAKF,iBAA1BC,wBAAmCC,IAAIM,GAAG;AACnD;AAEA,wGAAwG,GACxG,MAAMC,uBAA2D,IAAIC,IAA2B;IAC9F;IACA;IACA;IACA;IACA;CACD;AAED,gHAAgH,GAChH,MAAMC,kBAA8E;IAClF,+EAA+E;IAC/E3B,MAAM;QAAE4B,SAAS;IAAM;IACvBpB,MAAM;QAAEoB,SAAS;IAAK;AACxB;AAEA;;;;;;CAMC,GACD,OAAO,SAASC,mBAA0CnB,IAAe,EAAEoB,IAAO;IAChF,MAAMC,QAAQJ,eAAe,CAACjB,KAAK;IACnC,IAAI,CAACqB,OAAO,OAAOD;IACnB,OAAO,aACFA;QACHE,QAAQF,KAAKE,MAAM,CAACjB,GAAG,CAAC,CAACkB,QACvBR,qBAAqBS,GAAG,CAACD,MAAMvB,IAAI,IAAI,aAAKuB;gBAAOZ,IAAIvB;iBAAwBmC;QAEjFL,SAASG,MAAMH,OAAO,GAAGE,KAAKF,OAAO,CAACb,GAAG,CAAC,CAACoB,SAAY,aAAKA;gBAAQd,IAAIvB;kBAA0BgC,KAAKF,OAAO;;AAElH"}

package/src/lib/jobs/ai-job-drafts.d.ts

@@ -0,0 +1,304 @@
+/**
+ * @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 FormFieldDecl, type FormRouting } from '@aglyn/aglyn/app-utils/forms';
+import type { AglynOrgBilling, OrgFeatureFlags } from '@aglyn/aglyn/foundation/definitions/org-billing.types';
+import type { ReusableComponentProp } from '@aglyn/aglyn/foundation/definitions/platform.types';
+import type { NodesMap } from '@aglyn/aglyn/types/nodes';
+import { type AiPlanCapabilities } from '../model/ai-plan-capabilities';
+import type { AiJobAdmissionRefusal } from './ai-job-admission';
+/**
+ * Where a generation job's layout, page template, form, reusable component
+ * or page lands (AGL-2909, AGL-2913, AGL-2908, AGL-2907): a new draft, made
+ * as the console's host resources route makes one.
+ *
+ * ── The document the create route makes ─────────────────────────────────
+ *
+ * `AI_DRAFT_FIELDS` is that route's allow-list for each kind, and a spec
+ * reads the route's source to hold the two together. Nothing outside the
+ * list is written except the route's own stamps: `createdAt`, `updatedAt`,
+ * `createdBy`, a screen's `nameLower`, and a template's `source`, which is
+ * `authored` — a template a member's job generated is theirs, never a starter
+ * or a listing. A layout's or a screen's first version carries the keys the
+ * versions route seeds one with. A form is the document the Forms page's
+ * Create sends: its design canvas-shaped under `rootId` with the form node
+ * bound to the form's id and captioned with its name, a slug read from that
+ * name, and no version — the form's page mints the first one when someone
+ * opens it. Where Create sends an empty `fields`, a generated form sends the
+ * declaration read off its own design, so the two agree from the start. A
+ * component carries its tree and the props it declares on its own document,
+ * as Use template writes one, and gets its first version where every
+ * component does: when a member opens it.
+ *
+ * ── Counted like a create ────────────────────────────────────────────────
+ *
+ * The band is met INSIDE the transaction that writes (AGL-2231), with the
+ * route's arithmetic: every layout document counts against
+ * `sharedLayoutsPerHost`; a template counts against `templatesPerHost` when it
+ * records a source other than a platform starter — the route's `!=` query,
+ * which never matches a document with no `source.type` at all; a screen counts
+ * against `screensPerHost` by `billableScreenIds`, over the screens and the
+ * host's routing map, which counts an unrouted screen too (AGL-1445); and a
+ * form needs the plan to include the route's `entitlement` first, refused in
+ * the route's own words, after which every form document counts against
+ * `formsPerHost`. A reusable component counts against no allowance at all:
+ * the route admits one on a plan with the `reusableComponents` entitlement
+ * and refuses it otherwise, and so does the writer.
+ *
+ * ── Applied to nothing ───────────────────────────────────────────────────
+ *
+ * A layout renders only around a screen or layout that names it, or as the
+ * built-in page layout the host document names; a template is inert until a
+ * member uses it; a form renders only where a page places it; a component
+ * renders only where an instance places it, and a new one has no instance;
+ * and a screen serves nothing until the host's routing map names it, which is
+ * what publishing writes (`publishScreenRoute`). So the writer touches the new
+ * documents and nothing else — no host document, no routing map, no
+ * collection, store setting, other layout or component — and never a
+ * `publishedAt` or a publish schedule. What the job hands back is a link to
+ * the draft, never a binding.
+ *
+ * ── One draft per recorded id ────────────────────────────────────────────
+ *
+ * The caller names the document id: the console resource id the job recorded
+ * for the draft before its first write (`ai-job-draft-ids.ts`). A step run
+ * again after its draft was written — a process cut off before the machine
+ * recorded the step — reads the same id, finds that draft and reports it,
+ * rather than writing a second.
+ */
+type Firestore = FirebaseFirestore.Firestore;
+export type AiDraftKind = 'layout' | 'template' | 'form' | 'component' | 'screen';
+/** The draft kinds that keep their tree in versions, as the besigner opens them. */
+export type AiVersionedDraftKind = Extract<AiDraftKind, 'layout' | 'screen'>;
+/** The console host resources route's allow-list for each kind. */
+export declare const AI_DRAFT_FIELDS: Readonly<Record<AiDraftKind, readonly string[]>>;
+/** The keys a layout's first version is seeded with, all on the versions route's list. */
+export declare const AI_DRAFT_VERSION_FIELDS: readonly string[];
+/**
+ * The keys a screen's first version is seeded with, all on the versions
+ * route's list: the screen it belongs to, the site, the label, the tree, and
+ * the layout it renders inside when the plan names one the site has.
+ */
+export declare const AI_DRAFT_SCREEN_VERSION_FIELDS: readonly string[];
+/** The label on a generated draft's first version, as on one Use template makes. */
+export declare const AI_DRAFT_VERSION_NAME = "Initial version";
+/** The route's refusal when the site's plan does not include the kind at all. */
+export declare const AI_DRAFT_ENTITLEMENT_REFUSAL = "This feature is not included in your plan \u2014 see Billing";
+export interface AiDraftBand {
+    collection: 'layouts' | 'templates' | 'forms' | 'components' | 'screens';
+    /** The allowance the route counts the kind against, where it counts one. */
+    quotaKey?: 'sharedLayoutsPerHost' | 'templatesPerHost' | 'formsPerHost' | 'screensPerHost';
+    /** The feature the plan must include before any document of the kind counts. */
+    entitlement?: keyof OrgFeatureFlags;
+    /** The route's plural label, in the refusal it gives. */
+    label: string;
+}
+/** Each kind's collection, counter, feature and label, as the create route declares them. */
+export declare const AI_DRAFT_BANDS: Readonly<Record<AiDraftKind, AiDraftBand>>;
+interface SiblingRow {
+    id: string;
+    name: string;
+    slug: string;
+    kind: unknown;
+    sourceType: unknown;
+    deletedAt: unknown;
+    deleted: boolean;
+}
+/** A host's routing map: screen id → the path it is published at. */
+type RoutingMap = Record<string, unknown> | null | undefined;
+/**
+ * The route's refusal when the site's plan does not include the kind, or
+ * holds no more of it; `null` while it does. The feature is asked first, as
+ * the route asks it before it counts.
+ */
+export declare function aiDraftBandRefusal(kind: AiDraftKind, rows: ReadonlyArray<Pick<SiblingRow, 'id' | 'kind' | 'sourceType' | 'deletedAt'>>, org: Partial<AglynOrgBilling> | null, routingMap?: RoutingMap): string | null;
+/** The draft kinds a plan's creations land as, whose band a plan is told about (AGL-3030). */
+declare const AI_PLAN_DRAFT_KINDS: readonly ["component", "form", "layout", "template"];
+type AiPlanDraftKind = (typeof AI_PLAN_DRAFT_KINDS)[number];
+/**
+ * What a plan may create on this site (AGL-3030), from the workspace's plan
+ * and the rows each counted kind already holds — pure, so the specs and the
+ * eval harness hold the arithmetic without a Firestore. A kind whose rows
+ * are not given is counted as having room, which is what an unlimited
+ * allowance means.
+ *
+ * A theme change is a proposal a member applies, never a draft, so it counts
+ * against nothing. A dataset is org data that no job writes; a plan may name
+ * one only where the workspace's plan includes datasets at all. An email
+ * design is written by the email plugin, whose own gate decides.
+ *
+ * A workspace on the Free plan spends the Free taste, a wall of monthly
+ * credits, so its plan is held to the sections that wall pays for (AGL-3070).
+ * The effective plan decides, as it decides the taste's own allowance: a
+ * workspace whose subscription died is Free again.
+ */
+export declare function aiPlanCapabilitiesFrom(org: Partial<AglynOrgBilling> | null, rows?: Partial<Record<AiPlanDraftKind, ReadonlyArray<Pick<SiblingRow, 'id' | 'kind' | 'sourceType' | 'deletedAt'>>>>): AiPlanCapabilities;
+/**
+ * What a plan may create on this site, read: the rows of each kind whose
+ * allowance the workspace's plan counts, as the draft writer reads them, and
+ * nothing for a kind the plan leaves out or leaves unlimited.
+ */
+export declare function readAiPlanCapabilities(firestore: Firestore, input: {
+    hostId: string;
+    org: Partial<AglynOrgBilling> | null;
+}): Promise<AiPlanCapabilities>;
+/**
+ * Whether the site can take one more draft of the kind: a read, for a door
+ * that asks before it spends. The write asks again inside its transaction.
+ */
+export declare function aiDraftAllowanceRefusal(firestore: Firestore, input: {
+    kind: AiDraftKind;
+    hostId: string;
+    org: Partial<AglynOrgBilling> | null;
+}): Promise<string | null>;
+/**
+ * A draft screen's one-segment address: the one asked for, else one from its
+ * name, never a reserved segment, and never an address a live screen keeps
+ * or the routing map already serves — so the member's publish at it later
+ * takes nothing from a live page. The root is asked for only while no screen
+ * holds it.
+ */
+export declare function aiDraftScreenSlug(requested: string | null | undefined, name: string, rows: ReadonlyArray<Pick<SiblingRow, 'slug' | 'deleted'>>, routingMap: RoutingMap): string;
+export interface AiDraftRecord {
+    id: string;
+    /** A layout's or a screen's first version; `null` for every other kind, which the writer gives none. */
+    versionId: string | null;
+    name: string;
+    hostSubdomain: string | null;
+    /** A screen's search listing as the draft holds it now; absent on other kinds. */
+    seo?: {
+        title?: string;
+        description?: string;
+    } | null;
+    /** Whether a member deleted the draft since it was written. */
+    deleted?: boolean;
+}
+/** The draft a job already wrote under `id`, when a run of its step got that far. */
+export declare function readAiDraft(firestore: Firestore, input: {
+    kind: AiDraftKind;
+    hostId: string;
+    id: string;
+}): Promise<AiDraftRecord | null>;
+/** The tree a versioned draft's first version holds now, decoded; `null` when there is none. */
+export declare function readAiDraftNodes(firestore: Firestore, input: {
+    kind: AiVersionedDraftKind;
+    hostId: string;
+    id: string;
+}): Promise<{
+    versionId: string;
+    nodes: NodesMap;
+} | null>;
+export interface AiDraftInput {
+    kind: AiDraftKind;
+    hostId: string;
+    /** The draft's document id: the id the job recorded for this draft. */
+    id: string;
+    /** Whose work the draft is: the job's creator, whose brief it built. */
+    uid: string;
+    org: Partial<AglynOrgBilling> | null;
+    /** The name asked for; a live sibling already called that gets a number. */
+    name: string;
+    nodes: NodesMap;
+    /** A page template's suggested address, or a screen's one-segment address. */
+    slug?: string | null;
+    /** A form's declaration and the ids its design hangs from; required for a form. */
+    form?: AiFormDraftDeclaration;
+    /** A component's root, which the node map holds; required for a component. */
+    rootId?: string;
+    /** The properties a component declares, which its tree binds. */
+    props?: readonly ReusableComponentProp[];
+    /** A screen's layout, for its first version to render inside; a layout the site has. */
+    layoutId?: string | null;
+    now: Date;
+}
+/** What a form draft declares beside its design, read off that design. */
+export interface AiFormDraftDeclaration {
+    /** The canvas root `nodes` is stored under, as the Forms page's Create stores it. */
+    rootId: string;
+    /** The form node, which carries the form's id and is captioned with the draft's name. */
+    formNodeId: string;
+    fields: FormFieldDecl[];
+    consentFieldName: string | null;
+    routing: FormRouting | null;
+}
+export type AiDraftWrite = (AiDraftRecord & {
+    ok: true;
+    replayed: boolean;
+}) | {
+    ok: false;
+    status: 403 | 404;
+    error: string;
+};
+/**
+ * Write one draft: the band met, the name made unique among the live
+ * siblings, the node map stored as msgpack, all in one transaction. A
+ * refusal is returned, never thrown; a Firestore failure propagates, so the
+ * machine's retry applies.
+ */
+export declare function writeAiDraft(firestore: Firestore, input: AiDraftInput): Promise<AiDraftWrite>;
+export type AiDraftNodesUpdate = {
+    ok: true;
+    changed: boolean;
+} | {
+    ok: false;
+    status: 404;
+    error: string;
+};
+/**
+ * Change the tree of a versioned draft the job wrote, in one transaction:
+ * read the first version as it is stored NOW — a member may have opened and
+ * saved it — hand it to `update`, and store what comes back with a fresh
+ * `updatedAt`, which is what the besigner's save guard compares. `update`
+ * answering `null` changes nothing: a pass run again after its write.
+ */
+export declare function updateAiDraftNodes(firestore: Firestore, input: {
+    kind: AiVersionedDraftKind;
+    hostId: string;
+    id: string;
+    now: Date;
+    update: (nodes: NodesMap) => NodesMap | null;
+}): Promise<AiDraftNodesUpdate>;
+/**
+ * Put a search title and description on a draft screen the job wrote, each
+ * only where the draft has none: a value a member typed since is theirs.
+ */
+export declare function writeAiDraftScreenSeo(firestore: Firestore, input: {
+    hostId: string;
+    id: string;
+    seo: {
+        title?: string | null;
+        description?: string | null;
+    };
+    now: Date;
+}): Promise<void>;
+/** The site's subdomain, which a console link names the site by. */
+export declare function aiSiteSubdomain(firestore: Firestore, hostId: string): Promise<string | null>;
+/**
+ * What a door says before a job that writes a draft of this kind exists: a
+ * site is named, and it is the job's own org's; whatever the kind checks of
+ * its own; then the allowance. `null` admits the job.
+ */
+export declare function aiDraftAdmissionRefusal(firestore: Firestore, input: {
+    orgId: string;
+    hostId: string | null;
+    kind: AiDraftKind;
+    /** What the refusal calls the job's output; the kind when absent. */
+    noun?: string;
+    org: object | null;
+    /** The kind's own check, asked once the site is known to be the org's. */
+    ownCheck?: (hostId: string) => Promise<AiJobAdmissionRefusal | null>;
+}): Promise<AiJobAdmissionRefusal | null>;
+export {};