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

package/src/lib/model/ai-automation-draft.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-automation-draft.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 {\n  describeInteractionPlaceholder,\n  draftPlaceholder,\n  type InteractionPlaceholder,\n  interactionPlaceholders,\n} from '@aglyn/aglyn/app-utils/draft-placeholders'\nimport type { InteractionCondition, InteractionStepGuard } from '@aglyn/aglyn/app-utils/site-interactions'\nimport type { AiAutomation, AiAutomationStep } from './ai-automation-format'\nimport type {\n  AiAutomationAnswer,\n  AiAutomationAnswerStep,\n  AiAutomationCondition,\n} from '../tools/ai-workflow-tool'\n\n/**\n * An answer made into the automation the workflows plugin stores (AGL-2919).\n *\n * The answer names each record in WORDS. Here, in code and after the answer,\n * each is looked up among the site's own records: a list, a campaign, a\n * workflow, a webhook, a dataset, a form or a deal stage the words name\n * without doubt becomes that record's id; words that name none, or name more\n * than one, become a placeholder — the words in square brackets where the\n * record belongs — for the person to pick in the Actions editor. Nothing is\n * guessed, and the model never saw the records it was matched against beyond\n * what the site inventory already sends.\n */\n\n/** One record a description may name. */\nexport interface AiAutomationNamedRecord {\n  id: string\n  name: string\n}\n\n/** A form, with the fields its submissions carry. */\nexport interface AiAutomationForm extends AiAutomationNamedRecord {\n  fields: string[]\n}\n\n/** The site's records an automation's words are looked up among. */\nexport interface AiAutomationRecords {\n  forms: AiAutomationForm[]\n  datasets: AiAutomationNamedRecord[]\n  lists: AiAutomationNamedRecord[]\n  campaigns: AiAutomationNamedRecord[]\n  workflows: AiAutomationNamedRecord[]\n  webhooks: AiAutomationNamedRecord[]\n  /** Every stage of every pipeline the site may see. */\n  stages: AiAutomationNamedRecord[]\n}\n\nexport function emptyAiAutomationRecords(): AiAutomationRecords {\n  return { forms: [], datasets: [], lists: [], campaigns: [], workflows: [], webhooks: [], stages: [] }\n}\n\n/** Words that say nothing about which record is meant. */\nconst FILLER = new Set(['the', 'a', 'an', 'our', 'my', 'your', 'this', 'that', 'new', 'called', 'named'])\n\nfunction tokens(value: string, noun: string): string[] {\n  const nouns = new Set([noun, `${noun}s`])\n  return value\n    .toLowerCase()\n    .replace(/[^\\p{L}\\p{N}]+/gu, ' ')\n    .split(' ')\n    .filter(Boolean)\n    .filter((word) => !FILLER.has(word) && !nouns.has(word))\n    .map((word) => (word.length > 3 && word.endsWith('s') && !word.endsWith('ss') ? word.slice(0, -1) : word))\n}\n\n/**\n * The one record `words` name, or `null`: its id written whole; else the one\n * record whose name is the same words; else the one record whose name holds\n * every word, or whose every word the words hold. Two records that fit\n * equally well name neither — a placeholder is better than a coin toss.\n */\nexport function aiMatchNamedRecord<T extends AiAutomationNamedRecord>(\n  words: string,\n  records: readonly T[],\n  noun: string,\n): T | null {\n  const wanted = words.trim()\n  if (!wanted) return null\n  const byId = records.filter((record) => record.id === wanted)\n  if (byId.length === 1) return byId[0]\n  const asked = tokens(wanted, noun)\n  if (!asked.length) return null\n  const same = (record: T) => {\n    const name = tokens(record.name, noun)\n    return name.length === asked.length && asked.every((word) => name.includes(word))\n  }\n  const exact = records.filter(same)\n  if (exact.length) return exact.length === 1 ? exact[0] : null\n  const within = records.filter((record) => {\n    const name = tokens(record.name, noun)\n    if (!name.length) return false\n    const [small, large] = name.length <= asked.length ? [name, asked] : [asked, name]\n    return small.every((word) => large.includes(word))\n  })\n  return within.length === 1 ? within[0] : null\n}\n\n/** A form by its id or its name, for a condition that names one. */\nfunction formOf(value: string, forms: readonly AiAutomationForm[]): AiAutomationForm | null {\n  return aiMatchNamedRecord(value, forms, 'form')\n}\n\nfunction conditionOf(\n  condition: AiAutomationCondition,\n  records: AiAutomationRecords,\n): InteractionCondition {\n  const { field, op, value } = condition\n  if (op === 'notEmpty' || value === null) return { field, op }\n  if (field === 'formId') {\n    const form = formOf(value, records.forms)\n    return { field, op, value: form ? form.id : draftPlaceholder(value) }\n  }\n  if (field === 'formName') {\n    const form = formOf(value, records.forms)\n    return { field, op, value: form ? form.name : draftPlaceholder(value) }\n  }\n  if (field === 'stageId' || field === 'previousStageId') {\n    const stage = aiMatchNamedRecord(value, records.stages, 'stage')\n    return { field, op, value: stage ? stage.id : draftPlaceholder(value) }\n  }\n  return { field, op, value }\n}\n\nfunction guardOf(\n  when: AiAutomationCondition | null,\n  records: AiAutomationRecords,\n): { when?: InteractionStepGuard } {\n  return when ? { when: { conditions: [conditionOf(when, records)] } } : {}\n}\n\n/** A named record as a step stores it: the id and the name, or a placeholder name and no id. */\nfunction referenceOf(\n  words: string | null,\n  records: readonly AiAutomationNamedRecord[],\n  noun: string,\n): { id: string | null; name: string } {\n  const record = aiMatchNamedRecord(words ?? '', records, noun)\n  return record ? { id: record.id, name: record.name } : { id: null, name: draftPlaceholder(words ?? '') }\n}\n\nfunction stepOf(step: AiAutomationAnswerStep, records: AiAutomationRecords): AiAutomationStep {\n  const guard = guardOf(step.when, records)\n  switch (step.type) {\n    case 'sendEmail':\n      return {\n        type: 'sendEmail',\n        subject: step.subject ?? '',\n        body: step.body ?? '',\n        ...(step.toField ? { toField: step.toField } : {}),\n        ...guard,\n      }\n    case 'notifyAdmins':\n      return { type: 'notifyAdmins', title: step.title ?? '', ...guard }\n    case 'enrollList': {\n      const { id, name } = referenceOf(step.list, records.lists, 'list')\n      return { type: 'enrollList', ...(id ? { listId: id } : {}), listName: name, ...guard }\n    }\n    case 'assignCampaign': {\n      const { id, name } = referenceOf(step.campaign, records.campaigns, 'campaign')\n      return { type: 'assignCampaign', ...(id ? { campaignId: id } : {}), campaignName: name, ...guard }\n    }\n    case 'runWorkflow': {\n      const { id, name } = referenceOf(step.workflow, records.workflows, 'workflow')\n      return { type: 'runWorkflow', ...(id ? { workflowId: id } : {}), workflowName: name, ...guard }\n    }\n    case 'webhookPost': {\n      const { id, name } = referenceOf(step.webhook, records.webhooks, 'webhook')\n      return { type: 'webhookPost', ...(id ? { webhookId: id } : {}), webhookName: name, ...guard }\n    }\n    case 'datasetAppend':\n    case 'updateDataset': {\n      const { id, name } = referenceOf(step.dataset, records.datasets, 'dataset')\n      return { type: step.type, ...(id ? { datasetId: id } : {}), datasetName: name, ...guard }\n    }\n    case 'siteAlert':\n      return { type: 'siteAlert', message: step.message ?? '', severity: step.severity ?? 'info', ...guard }\n    case 'wait':\n      return { type: 'wait', delayMinutes: step.minutes ?? 0, ...guard }\n    case 'waitForEvent':\n      return {\n        type: 'waitForEvent',\n        eventName: step.event ?? '',\n        timeoutMinutes: step.minutes ?? 0,\n        ...guard,\n      }\n    case 'exitFlow':\n      return { type: 'exitFlow', ...guard }\n    case 'setContactStage':\n      return { type: 'setContactStage', lifecycleStage: step.stage ?? 'lead', ...guard }\n    case 'addContactTag':\n      return { type: 'addContactTag', tag: step.tag ?? '', ...guard }\n    case 'assignContactOwner':\n      return step.owner === 'round robin'\n        ? { type: 'assignContactOwner', roundRobin: true, ...guard }\n        : { type: 'assignContactOwner', ownerEmail: step.owner ?? '', ...guard }\n    case 'createCrmTask':\n      return {\n        type: 'createCrmTask',\n        title: step.title ?? '',\n        kind: step.taskKind ?? 'todo',\n        // The runner stores the org's label for the meaning (AGL-3538).\n        ...(step.priority ? { priority: step.priority } : {}),\n        dueInDays: step.dueInDays ?? 0,\n        ...guard,\n      }\n    case 'logCrmActivity':\n      return {\n        type: 'logCrmActivity',\n        kind: step.activityKind ?? 'note',\n        body: step.body ?? '',\n        ...(step.direction ? { direction: step.direction } : {}),\n        ...guard,\n      }\n  }\n}\n\n/** The name an automation is drafted under when the answer gave none. */\nexport const AI_AUTOMATION_DEFAULT_NAME = 'New automation'\n\nexport interface AiAutomationDraft {\n  /** The automation as the workflows plugin stores it: OFF. */\n  action: AiAutomation\n  /** What a person still has to supply before switching it on. */\n  placeholders: InteractionPlaceholder[]\n}\n\n/** An answer as the automation to store, with every record it names looked up. */\nexport function aiAutomationDraft(\n  answer: AiAutomationAnswer,\n  records: AiAutomationRecords,\n): AiAutomationDraft {\n  const conditions = answer.trigger.conditions.map((condition) => conditionOf(condition, records))\n  const action: AiAutomation = {\n    name: answer.name || AI_AUTOMATION_DEFAULT_NAME,\n    trigger: {\n      event: answer.trigger.event,\n      ...(conditions.length ? { conditions, combinator: answer.trigger.combinator } : {}),\n    },\n    steps: answer.steps.map((step) => stepOf(step, records)),\n    enabled: false,\n  }\n  return { action, placeholders: interactionPlaceholders(action) }\n}\n\n/**\n * What a drafted automation's output tells a person: that it is off, what to\n * fill in before switching it on, and what the answer said needs deciding.\n */\nexport function aiAutomationDraftNote(draft: AiAutomationDraft, notes: readonly string[]): string {\n  const parts = ['It is off until you switch it on.']\n  if (draft.placeholders.length) {\n    parts.push(\n      `Fill in ${draft.placeholders.length === 1 ? 'its placeholder' : `its ${draft.placeholders.length} placeholders`} first — ${draft.placeholders\n        .map(describeInteractionPlaceholder)\n        .join('; ')}.`,\n    )\n  } else {\n    parts.push('Review its steps in the Actions editor, then switch it on from the list.')\n  }\n  parts.push(...notes)\n  return parts.join(' ')\n}\n"],"names":["describeInteractionPlaceholder","draftPlaceholder","interactionPlaceholders","emptyAiAutomationRecords","forms","datasets","lists","campaigns","workflows","webhooks","stages","FILLER","Set","tokens","value","noun","nouns","toLowerCase","replace","split","filter","Boolean","word","has","map","length","endsWith","slice","aiMatchNamedRecord","words","records","wanted","trim","byId","record","id","asked","same","name","every","includes","exact","within","small","large","formOf","conditionOf","condition","field","op","form","stage","guardOf","when","conditions","referenceOf","stepOf","step","guard","type","subject","body","toField","title","list","listId","listName","campaign","campaignId","campaignName","workflow","workflowId","workflowName","webhook","webhookId","webhookName","dataset","datasetId","datasetName","message","severity","delayMinutes","minutes","eventName","event","timeoutMinutes","lifecycleStage","tag","owner","roundRobin","ownerEmail","kind","taskKind","priority","dueInDays","activityKind","direction","AI_AUTOMATION_DEFAULT_NAME","aiAutomationDraft","answer","trigger","action","combinator","steps","enabled","placeholders","aiAutomationDraftNote","draft","notes","parts","push","join"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-automation-draft.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 {\n  describeInteractionPlaceholder,\n  draftPlaceholder,\n  type InteractionPlaceholder,\n  interactionPlaceholders,\n} from '@aglyn/aglyn/app-utils/draft-placeholders'\nimport type { InteractionCondition, InteractionStepGuard } from '@aglyn/aglyn/app-utils/site-interactions'\nimport type { AiAutomation, AiAutomationStep } from './ai-automation-format'\nimport type {\n  AiAutomationAnswer,\n  AiAutomationAnswerStep,\n  AiAutomationCondition,\n} from '../tools/ai-workflow-tool'\n\n/**\n * An answer made into the automation the workflows plugin stores (AGL-2919).\n *\n * The answer names each record in WORDS. Here, in code and after the answer,\n * each is looked up among the site's own records: a list, a campaign, a\n * workflow, a webhook, a dataset, a form or a deal stage the words name\n * without doubt becomes that record's id; words that name none, or name more\n * than one, become a placeholder — the words in square brackets where the\n * record belongs — for the person to pick in the Actions editor. Nothing is\n * guessed, and the model never saw the records it was matched against beyond\n * what the site inventory already sends.\n */\n\n/** One record a description may name. */\nexport interface AiAutomationNamedRecord {\n  id: string\n  name: string\n}\n\n/** A form, with the fields its submissions carry. */\nexport interface AiAutomationForm extends AiAutomationNamedRecord {\n  fields: string[]\n}\n\n/** The site's records an automation's words are looked up among. */\nexport interface AiAutomationRecords {\n  forms: AiAutomationForm[]\n  datasets: AiAutomationNamedRecord[]\n  lists: AiAutomationNamedRecord[]\n  campaigns: AiAutomationNamedRecord[]\n  workflows: AiAutomationNamedRecord[]\n  webhooks: AiAutomationNamedRecord[]\n  /** Every stage of every pipeline the site may see. */\n  stages: AiAutomationNamedRecord[]\n}\n\nexport function emptyAiAutomationRecords(): AiAutomationRecords {\n  return { forms: [], datasets: [], lists: [], campaigns: [], workflows: [], webhooks: [], stages: [] }\n}\n\n/** Words that say nothing about which record is meant. */\nconst FILLER = new Set(['the', 'a', 'an', 'our', 'my', 'your', 'this', 'that', 'new', 'called', 'named'])\n\nfunction tokens(value: string, noun: string): string[] {\n  const nouns = new Set([noun, `${noun}s`])\n  return value\n    .toLowerCase()\n    .replace(/[^\\p{L}\\p{N}]+/gu, ' ')\n    .split(' ')\n    .filter(Boolean)\n    .filter((word) => !FILLER.has(word) && !nouns.has(word))\n    .map((word) => (word.length > 3 && word.endsWith('s') && !word.endsWith('ss') ? word.slice(0, -1) : word))\n}\n\n/**\n * The one record `words` name, or `null`: its id written whole; else the one\n * record whose name is the same words; else the one record whose name holds\n * every word, or whose every word the words hold. Two records that fit\n * equally well name neither — a placeholder is better than a coin toss.\n */\nexport function aiMatchNamedRecord<T extends AiAutomationNamedRecord>(\n  words: string,\n  records: readonly T[],\n  noun: string,\n): T | null {\n  const wanted = words.trim()\n  if (!wanted) return null\n  const byId = records.filter((record) => record.id === wanted)\n  if (byId.length === 1) return byId[0]\n  const asked = tokens(wanted, noun)\n  if (!asked.length) return null\n  const same = (record: T) => {\n    const name = tokens(record.name, noun)\n    return name.length === asked.length && asked.every((word) => name.includes(word))\n  }\n  const exact = records.filter(same)\n  if (exact.length) return exact.length === 1 ? exact[0] : null\n  const within = records.filter((record) => {\n    const name = tokens(record.name, noun)\n    if (!name.length) return false\n    const [small, large] = name.length <= asked.length ? [name, asked] : [asked, name]\n    return small.every((word) => large.includes(word))\n  })\n  return within.length === 1 ? within[0] : null\n}\n\n/** A form by its id or its name, for a condition that names one. */\nfunction formOf(value: string, forms: readonly AiAutomationForm[]): AiAutomationForm | null {\n  return aiMatchNamedRecord(value, forms, 'form')\n}\n\nfunction conditionOf(\n  condition: AiAutomationCondition,\n  records: AiAutomationRecords,\n): InteractionCondition {\n  const { field, op, value } = condition\n  if (op === 'notEmpty' || value === null) return { field, op }\n  if (field === 'formId') {\n    const form = formOf(value, records.forms)\n    return { field, op, value: form ? form.id : draftPlaceholder(value) }\n  }\n  if (field === 'formName') {\n    const form = formOf(value, records.forms)\n    return { field, op, value: form ? form.name : draftPlaceholder(value) }\n  }\n  if (field === 'stageId' || field === 'previousStageId') {\n    const stage = aiMatchNamedRecord(value, records.stages, 'stage')\n    return { field, op, value: stage ? stage.id : draftPlaceholder(value) }\n  }\n  return { field, op, value }\n}\n\nfunction guardOf(\n  when: AiAutomationCondition | null,\n  records: AiAutomationRecords,\n): { when?: InteractionStepGuard } {\n  return when ? { when: { conditions: [conditionOf(when, records)] } } : {}\n}\n\n/** A named record as a step stores it: the id and the name, or a placeholder name and no id. */\nfunction referenceOf(\n  words: string | null,\n  records: readonly AiAutomationNamedRecord[],\n  noun: string,\n): { id: string | null; name: string } {\n  const record = aiMatchNamedRecord(words ?? '', records, noun)\n  return record ? { id: record.id, name: record.name } : { id: null, name: draftPlaceholder(words ?? '') }\n}\n\nfunction stepOf(step: AiAutomationAnswerStep, records: AiAutomationRecords): AiAutomationStep {\n  const guard = guardOf(step.when, records)\n  switch (step.type) {\n    case 'sendEmail':\n      return {\n        type: 'sendEmail',\n        subject: step.subject ?? '',\n        body: step.body ?? '',\n        ...(step.toField ? { toField: step.toField } : {}),\n        ...guard,\n      }\n    case 'notifyAdmins':\n      return { type: 'notifyAdmins', title: step.title ?? '', ...guard }\n    case 'enrollList': {\n      const { id, name } = referenceOf(step.list, records.lists, 'list')\n      return { type: 'enrollList', ...(id ? { listId: id } : {}), listName: name, ...guard }\n    }\n    case 'assignCampaign': {\n      const { id, name } = referenceOf(step.campaign, records.campaigns, 'campaign')\n      return { type: 'assignCampaign', ...(id ? { campaignId: id } : {}), campaignName: name, ...guard }\n    }\n    case 'runWorkflow': {\n      const { id, name } = referenceOf(step.workflow, records.workflows, 'workflow')\n      return { type: 'runWorkflow', ...(id ? { workflowId: id } : {}), workflowName: name, ...guard }\n    }\n    case 'webhookPost': {\n      const { id, name } = referenceOf(step.webhook, records.webhooks, 'webhook')\n      return { type: 'webhookPost', ...(id ? { webhookId: id } : {}), webhookName: name, ...guard }\n    }\n    case 'datasetAppend':\n    case 'updateDataset': {\n      const { id, name } = referenceOf(step.dataset, records.datasets, 'dataset')\n      return { type: step.type, ...(id ? { datasetId: id } : {}), datasetName: name, ...guard }\n    }\n    case 'siteAlert':\n      return { type: 'siteAlert', message: step.message ?? '', severity: step.severity ?? 'info', ...guard }\n    case 'wait':\n      return { type: 'wait', delayMinutes: step.minutes ?? 0, ...guard }\n    case 'waitForEvent':\n      return {\n        type: 'waitForEvent',\n        eventName: step.event ?? '',\n        timeoutMinutes: step.minutes ?? 0,\n        ...guard,\n      }\n    case 'exitFlow':\n      return { type: 'exitFlow', ...guard }\n    case 'setContactStage':\n      return { type: 'setContactStage', lifecycleStage: step.stage ?? 'lead', ...guard }\n    case 'addContactTag':\n      return { type: 'addContactTag', tag: step.tag ?? '', ...guard }\n    case 'assignContactOwner':\n      return step.owner === 'round robin'\n        ? { type: 'assignContactOwner', roundRobin: true, ...guard }\n        : { type: 'assignContactOwner', ownerEmail: step.owner ?? '', ...guard }\n    case 'createCrmTask':\n      return {\n        type: 'createCrmTask',\n        title: step.title ?? '',\n        kind: step.taskKind ?? 'todo',\n        // The runner stores the org's label for the meaning (AGL-3538).\n        ...(step.priority ? { priority: step.priority } : {}),\n        dueInDays: step.dueInDays ?? 0,\n        ...guard,\n      }\n    case 'logCrmActivity':\n      return {\n        type: 'logCrmActivity',\n        kind: step.activityKind ?? 'note',\n        body: step.body ?? '',\n        ...(step.direction ? { direction: step.direction } : {}),\n        ...guard,\n      }\n  }\n}\n\n/** The name an automation is drafted under when the answer gave none. */\nexport const AI_AUTOMATION_DEFAULT_NAME = 'New automation'\n\nexport interface AiAutomationDraft {\n  /** The automation as the workflows plugin stores it: OFF. */\n  action: AiAutomation\n  /** What a person still has to supply before switching it on. */\n  placeholders: InteractionPlaceholder[]\n}\n\n/** An answer as the automation to store, with every record it names looked up. */\nexport function aiAutomationDraft(\n  answer: AiAutomationAnswer,\n  records: AiAutomationRecords,\n): AiAutomationDraft {\n  const conditions = answer.trigger.conditions.map((condition) => conditionOf(condition, records))\n  const action: AiAutomation = {\n    name: answer.name || AI_AUTOMATION_DEFAULT_NAME,\n    trigger: {\n      event: answer.trigger.event,\n      ...(conditions.length ? { conditions, combinator: answer.trigger.combinator } : {}),\n    },\n    steps: answer.steps.map((step) => stepOf(step, records)),\n    enabled: false,\n  }\n  return { action, placeholders: interactionPlaceholders(action) }\n}\n\n/**\n * What a drafted automation's output tells a person: that it is off, what to\n * fill in before switching it on, and what the answer said needs deciding.\n */\nexport function aiAutomationDraftNote(draft: AiAutomationDraft, notes: readonly string[]): string {\n  const parts = ['It is off until you switch it on.']\n  if (draft.placeholders.length) {\n    parts.push(\n      `Fill in ${draft.placeholders.length === 1 ? 'its placeholder' : `its ${draft.placeholders.length} placeholders`} first — ${draft.placeholders\n        .map(describeInteractionPlaceholder)\n        .join('; ')}.`,\n    )\n  } else {\n    parts.push('Review its steps in the Actions editor, then switch it on from the list.')\n  }\n  parts.push(...notes)\n  return parts.join(' ')\n}\n\n/** A step as compared across a revision: its stored fields, in a fixed key order. */\nfunction stepSignature(step: AiAutomationStep): string {\n  const record = step as unknown as Record<string, unknown>\n  return JSON.stringify(Object.keys(record).sort().map((key) => [key, record[key]]))\n}\n\n/** The longest run of `after` that `before` holds in order, as a pair of kept flags. */\nfunction keptSteps(before: readonly string[], after: readonly string[]): [boolean[], boolean[]] {\n  const table = Array.from({ length: before.length + 1 }, () => new Array<number>(after.length + 1).fill(0))\n  for (let i = before.length - 1; i >= 0; i -= 1) {\n    for (let j = after.length - 1; j >= 0; j -= 1) {\n      table[i][j] = before[i] === after[j] ? table[i + 1][j + 1] + 1 : Math.max(table[i + 1][j], table[i][j + 1])\n    }\n  }\n  const keptBefore = before.map(() => false)\n  const keptAfter = after.map(() => false)\n  let i = 0\n  let j = 0\n  while (i < before.length && j < after.length) {\n    if (before[i] === after[j]) {\n      keptBefore[i] = true\n      keptAfter[j] = true\n      i += 1\n      j += 1\n    } else if (table[i + 1][j] >= table[i][j + 1]) i += 1\n    else j += 1\n  }\n  return [keptBefore, keptAfter]\n}\n\n/**\n * What a revised draft changed from the saved action it was drawn from\n * (AGL-3603), worked out in code from the two stored shapes — never the\n * model's own account of what it did. A step whose kind is both removed and\n * added — edited, or moved — is reported as changed.\n */\nexport function aiAutomationRevisionChanges(\n  before: Pick<AiAutomation, 'trigger' | 'steps'>,\n  after: Pick<AiAutomation, 'trigger' | 'steps'>,\n  label: (type: string) => string,\n): string[] {\n  const changes: string[] = []\n  if (before.trigger?.event !== after.trigger?.event) changes.push('It starts on a different event.')\n  else {\n    const conditions = (trigger: AiAutomation['trigger'] | undefined) =>\n      JSON.stringify({ conditions: trigger?.conditions ?? [], combinator: trigger?.conditions?.length ? trigger.combinator ?? 'and' : null })\n    if (conditions(before.trigger) !== conditions(after.trigger)) changes.push('Its conditions changed.')\n  }\n  const beforeSteps = before.steps ?? []\n  const afterSteps = after.steps ?? []\n  const [keptBefore, keptAfter] = keptSteps(beforeSteps.map(stepSignature), afterSteps.map(stepSignature))\n  const removed = beforeSteps.filter((_, index) => !keptBefore[index]).map((step) => label(step.type))\n  const added = afterSteps.filter((_, index) => !keptAfter[index]).map((step) => label(step.type))\n  const changed = [...new Set(removed.filter((name) => added.includes(name)))]\n  const only = (names: string[]) => [...new Set(names.filter((name) => !changed.includes(name)))]\n  if (changed.length) changes.push(`Changed: ${changed.join(', ')}.`)\n  if (only(added).length) changes.push(`Added: ${only(added).join(', ')}.`)\n  if (only(removed).length) changes.push(`Removed: ${only(removed).join(', ')}.`)\n  return changes\n}\n\n/**\n * What a revised draft's output tells a person: which saved action it was\n * drawn from, what changed, that the saved one is untouched, and the draft's\n * own note.\n */\nexport function aiAutomationRevisionNote(\n  input: { fromName: string; changes: readonly string[]; draft: AiAutomationDraft; notes: readonly string[] },\n): string {\n  const changes = input.changes.length ? input.changes : ['Nothing changed from the saved action.']\n  return [\n    `A changed copy of “${input.fromName}”, which is left as it is.`,\n    ...changes,\n    aiAutomationDraftNote(input.draft, input.notes),\n    'Switch the old one off when you switch this one on.',\n  ].join(' ')\n}\n"],"names":["describeInteractionPlaceholder","draftPlaceholder","interactionPlaceholders","emptyAiAutomationRecords","forms","datasets","lists","campaigns","workflows","webhooks","stages","FILLER","Set","tokens","value","noun","nouns","toLowerCase","replace","split","filter","Boolean","word","has","map","length","endsWith","slice","aiMatchNamedRecord","words","records","wanted","trim","byId","record","id","asked","same","name","every","includes","exact","within","small","large","formOf","conditionOf","condition","field","op","form","stage","guardOf","when","conditions","referenceOf","stepOf","step","guard","type","subject","body","toField","title","list","listId","listName","campaign","campaignId","campaignName","workflow","workflowId","workflowName","webhook","webhookId","webhookName","dataset","datasetId","datasetName","message","severity","delayMinutes","minutes","eventName","event","timeoutMinutes","lifecycleStage","tag","owner","roundRobin","ownerEmail","kind","taskKind","priority","dueInDays","activityKind","direction","AI_AUTOMATION_DEFAULT_NAME","aiAutomationDraft","answer","trigger","action","combinator","steps","enabled","placeholders","aiAutomationDraftNote","draft","notes","parts","push","join","stepSignature","JSON","stringify","Object","keys","sort","key","keptSteps","before","after","table","Array","from","fill","i","j","Math","max","keptBefore","keptAfter","aiAutomationRevisionChanges","label","changes","beforeSteps","afterSteps","removed","_","index","added","changed","only","names","aiAutomationRevisionNote","input","fromName"],"mappings":"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"}

package/src/lib/model/ai-build-job.d.ts

@@ -0,0 +1,201 @@
+/**
+ * @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 PluginAiCapability } from '@aglyn/aglyn/plugin-manager/plugin-ai-capabilities';
+import { type AiBuildItem, type AiBuildPlan, type AiBuildPlanCreate, type AiBuildPlanCreateKind, type AiBuildPlanScreen } from './ai-build-plan';
+import type { AiJobItemLedger } from './ai-jobs.types';
+/**
+ * What a `build` job is (AGL-3616): one request — "a few pages, a contact
+ * form and a way to book me" — planned as creations, pages and items, built
+ * one UNIT a pass in dependency order, and settled ITEM BY ITEM.
+ *
+ * A build is a generalized site scaffold. Every unit is handed to what
+ * already builds that kind of thing — a page to the page step, a form to the
+ * form step, another plugin's resource to that plugin's draft writer — so a
+ * build cannot drift from what it builds. What is new is the settlement: one
+ * failed unit does not end the job. It gives back its own spend, the units
+ * that depended on it are built without it (or skipped, when they cannot
+ * stand without it), and the job is `done` when anything was delivered.
+ *
+ * This module is the build's MODEL — its units, their order, how a failure
+ * travels to what depends on it, what it is estimated to cost, and the
+ * ledger arithmetic — and does no I/O, so the step, the machine, the doors
+ * and the console read one vocabulary.
+ */
+/** How much one build holds: what one proposal can describe and one person can read. */
+export declare const AI_BUILD_LIMITS: {
+    /** Creations, pages and items together. */
+    readonly units: 16;
+    readonly pages: 8;
+    /** A Free workspace's pages. */
+    readonly freePages: 2;
+};
+/** What a build creates through its `create` list; everything else beyond pages is an item. */
+export declare const AI_BUILD_CREATE_KINDS: readonly AiBuildPlanCreateKind[];
+/**
+ * The operations a build plans through `create` and `screens` rather than
+ * `items`: an item naming one is a plan that put it in the wrong list.
+ */
+export declare const AI_BUILD_STRUCTURAL_OPS: readonly string[];
+/** The job input a build's Assist proposal sets when the brief asked to publish. */
+export declare const AI_BUILD_PUBLISH_INPUT = "publish";
+/** A unit of a build: a creation, a page, or an item. */
+export interface AiBuildUnit {
+    slot: string;
+    /** The capability operation that builds it. */
+    op: string;
+    label: string;
+    creation?: AiBuildPlanCreate;
+    screen?: AiBuildPlanScreen;
+    item?: AiBuildItem;
+    /** The slots it is built after, in plan order. */
+    deps: string[];
+}
+/** The name a `new:<name>` reference gives, lowercased. */
+export declare function aiBuildRefName(ref: string): string;
+/** Every reference a page makes: its layout, template, starting page and what its sections place. */
+export declare function aiBuildScreenRefs(screen: AiBuildPlanScreen): string[];
+/**
+ * The units a plan implies, in plan order: creations, then items, then
+ * pages — the order a member reads them in, and the one a page that places
+ * a creation or an item is built after anyway. `aiBuildOrder` sorts them on
+ * their dependencies.
+ */
+export declare function aiBuildUnits(plan: AiBuildPlan): AiBuildUnit[];
+/**
+ * The units in an order that builds every dependency before what depends on
+ * it, plan order otherwise; `null` when the dependencies hold a cycle.
+ */
+export declare function aiBuildOrder(units: readonly AiBuildUnit[]): AiBuildUnit[] | null;
+/**
+ * What is wrong with a plan's references as a build reads them: a
+ * `new:<name>` an item depends on that nothing in the plan makes, and a
+ * cycle. Each is a sentence the plan's one re-ask carries.
+ */
+export declare function aiBuildGraphProblems(plan: AiBuildPlan): string[];
+/** The operations a build may plan, as the registry and the gates left them, by op. */
+export type AiBuildOps = ReadonlyMap<string, PluginAiCapability>;
+/** How many pages a build may hold on this workspace. */
+export declare function aiBuildPageLimit(freeTaste: boolean | null | undefined): number;
+/**
+ * Why a build cannot build a plan of this shape, in a sentence a member
+ * reads; `null` when it can. Held to the plan with the one re-ask (the plan
+ * step's scope), and again by the doors before a confirmed plan runs.
+ * `ops` is what may be planned on this site; absent, items are not judged
+ * against the registry (a console reading a kept plan).
+ */
+export declare function aiBuildPlanShapeRefusal(plan: AiBuildPlan, options?: {
+    freeTaste?: boolean;
+    ops?: AiBuildOps;
+}): string | null;
+/** "a booking service", "an email design". */
+export declare function aiArticle(noun: string): string;
+/**
+ * About what one unit costs, in credits: a page or a creation by the passes
+ * it implies at the nominal credits a pass is held against, as a site's are;
+ * an item by its capability's own estimate, recorded on the plan when it was
+ * kept.
+ */
+export declare function aiBuildUnitCreditEstimate(unit: AiBuildUnit, ops?: AiBuildOps): number;
+/**
+ * About what a build costs, in credits: every unit's estimate, or only the
+ * units named in `slots` — what Try again shows. The ceiling a member
+ * confirms; the meter charges what actually runs.
+ */
+export declare function aiBuildCreditEstimate(plan: AiBuildPlan, options?: {
+    ops?: AiBuildOps;
+    slots?: ReadonlySet<string>;
+}): number;
+/**
+ * About what a job of this kind costs to build from its plan: a build's
+ * units, every other planned kind as `aiJobPlanCreditEstimate` counts it.
+ */
+export declare function aiJobCreditEstimate(kind: string, plan: AiBuildPlan): number;
+/** A fresh ledger: one pending row per unit, first attempt. */
+export declare function aiBuildInitialLedger(units: readonly AiBuildUnit[]): AiJobItemLedger[];
+/** Whether an item is still to be built. */
+export declare function aiBuildItemOpen(row: Pick<AiJobItemLedger, 'status'>): boolean;
+/** Whether an item delivered: built as planned, or built without something that failed. */
+export declare function aiBuildItemDelivered(row: Pick<AiJobItemLedger, 'status'>): boolean;
+/**
+ * The next unit to build: the first in build order whose row is still open.
+ * Its dependencies come before it, so by then each is settled one way or the
+ * other. `null` when nothing is left.
+ */
+export declare function aiBuildNextUnit(ordered: readonly AiBuildUnit[], ledger: readonly AiJobItemLedger[]): AiBuildUnit | null;
+/** How a unit is built given what its dependencies came to. */
+export interface AiBuildDegradation {
+    /** The unit is not built at all, with the sentence why; nothing is spent. */
+    skip: string | null;
+    /** The failed dependencies that change how it is built. */
+    degradedBy: string[];
+    /** What the person reads about the change; one per failed dependency. */
+    notes: string[];
+    /** `new:<name>` references (lowercased names) to leave out. */
+    dropped: Set<string>;
+    /** Brief lines for the unit's own job: what to leave out, and what to place. */
+    briefLines: string[];
+}
+/**
+ * How a unit is built when some of what it depends on failed (AGL-3616).
+ *
+ * A PAGE is always built: a failed layout falls back to the site's own, a
+ * failed form or component is left out of its section, and a failed item a
+ * section places (a booking service) takes its block out of the page — each
+ * with a note. Any OTHER unit whose dependency failed is skipped when that
+ * dependency's capability says `omit` (a campaign whose email design failed
+ * has nothing to send), and built without it when it says `fallback`.
+ */
+export declare function aiBuildDegradation(unit: AiBuildUnit, context: {
+    units: readonly AiBuildUnit[];
+    ledger: readonly AiJobItemLedger[];
+    ops?: AiBuildOps;
+}): AiBuildDegradation;
+/** What each creation is called in a note. */
+export declare function aiBuildCreationNoun(kind: AiBuildPlanCreateKind): string;
+/**
+ * The brief lines a page is told about the items its sections place and
+ * that were built: the block to put there, in the owner's words.
+ */
+export declare function aiBuildPlacedItemLines(unit: AiBuildUnit, context: {
+    units: readonly AiBuildUnit[];
+    ledger: readonly AiJobItemLedger[];
+    ops?: AiBuildOps;
+}): string[];
+/** What a build came to: whether anything was delivered, and whether anything is left. */
+export declare function aiBuildSettlement(ledger: readonly AiJobItemLedger[]): {
+    delivered: boolean;
+    open: boolean;
+    failed: number;
+};
+/**
+ * The ledger Try again runs (AGL-3616): every failed item back to `pending`
+ * on its next attempt, with the items left unbuilt because of it — skipped,
+ * or degraded with no draft — and every item the build never reached. An
+ * item that succeeded is never run again, and a degraded page that has its
+ * draft keeps it, with a note that the page needs an edit. `retried` names
+ * the slots that will run, which is what the estimate is shown for.
+ */
+export declare function aiBuildRetryLedger(ledger: readonly AiJobItemLedger[], units: readonly AiBuildUnit[]): {
+    ledger: AiJobItemLedger[];
+    retried: string[];
+};
+/**
+ * Units read back off a ledger alone (AGL-3616), for a job whose units are
+ * not a build plan's — a site scaffold's: each row as its unit, and every
+ * page built after the layouts and forms the ledger holds.
+ */
+export declare function aiLedgerUnits(ledger: readonly AiJobItemLedger[]): AiBuildUnit[];