@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/model/ai-automation-outline.js

@@ -0,0 +1,262 @@
+/**
+ * @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 { CLIENT_ACTION_STEP_TYPES, HOST_ACTION_STEP_LABELS, normalizeTriggerConditions } from "@aglyn/aglyn/app-utils/actions";
+import { automationPlaceholderIn } from "@aglyn/aglyn/app-utils/automation-placeholders";
+import { CONTACT_LIFECYCLE_STAGE_LABELS } from "@aglyn/aglyn/app-utils/crm";
+import { aiAutomationTriggerLabel } from "./ai-workflow-job.js";
+/**
+ * What an explanation is asked from (AGL-2919): a saved automation, and one of
+ * its failed runs, as plain lines a model reads — never the stored documents.
+ *
+ * WHAT IS LEFT OUT. An email address anywhere — a condition's value, an
+ * email's text, a run's error naming the contact it could not find — becomes
+ * `[email address]`. A teammate named by account id or address is "a named
+ * teammate". A selector, a script or HTML an on-page step holds is not shown
+ * at all; the step is named by its label. A run's event payload, which holds
+ * what a visitor submitted, is never read. What is shown is how the automation
+ * is set up, and what the run history recorded about the run.
+ *
+ * WHAT IS ADDED. Whether each list, campaign, workflow, webhook or dataset a
+ * step names still exists on the site, looked up in code, because "that list
+ * was deleted" is the answer to the most common failure and a model cannot
+ * find it out.
+ */ /** An email address, wherever it appears in a line. */ const EMAIL_ADDRESS = /[^\s@<>()[\]"',;:]+@[^\s@<>()[\]"',;:]+\.[A-Za-z]{2,}/g;
+/** How much of an email's text an outline quotes. */ export const AI_OUTLINE_BODY_MAX_CHARS = 300;
+/** How much of any other value an outline quotes. */ export const AI_OUTLINE_VALUE_MAX_CHARS = 120;
+/** The most errors of one run an outline lists. */ export const AI_OUTLINE_RUN_ERRORS_MAX = 10;
+/** A line with every email address replaced by what it is. */ export function aiRedactPersonal(text) {
+    return text.replace(EMAIL_ADDRESS, '[email address]');
+}
+function quoted(value, max = AI_OUTLINE_VALUE_MAX_CHARS) {
+    const text = aiRedactPersonal(String(value != null ? value : '').replace(/\s+/g, ' ').trim());
+    return `"${text.length > max ? `${text.slice(0, max)}…` : text}"`;
+}
+function conditionLine(condition) {
+    var _condition_field, _condition_value;
+    const field = String((_condition_field = condition.field) != null ? _condition_field : '');
+    if (condition.op === 'notEmpty') return `${field} is not empty`;
+    const value = String((_condition_value = condition.value) != null ? _condition_value : '');
+    const stage = CONTACT_LIFECYCLE_STAGE_LABELS[value];
+    const placeholder = automationPlaceholderIn(value) ? ' (a placeholder nobody has filled in)' : '';
+    return `${field} ${condition.op} ${stage ? `"${stage}"` : quoted(value)}${placeholder}`;
+}
+/** The kind of site record each step that names one names. */ export const AI_OUTLINE_RECORD_KINDS = {
+    enrollList: 'lists',
+    assignCampaign: 'campaigns',
+    runWorkflow: 'workflows',
+    webhookPost: 'webhooks',
+    datasetAppend: 'datasets',
+    updateDataset: 'datasets'
+};
+/** The kinds of site record an action's steps name, each once. */ export function aiActionRecordKinds(action) {
+    var _action_steps;
+    const kinds = ((_action_steps = action.steps) != null ? _action_steps : []).map((step)=>AI_OUTLINE_RECORD_KINDS[step == null ? void 0 : step.type]);
+    return [
+        ...new Set(kinds.filter((kind)=>Boolean(kind)))
+    ];
+}
+/** Whether the site holds a record by the id or the name a step stores. */ function standing(id, name, records) {
+    if (automationPlaceholderIn(name) && !String(id != null ? id : '').trim()) {
+        return ' — a placeholder nobody has filled in';
+    }
+    if (!records) return '';
+    const found = records.some((record)=>typeof id === 'string' && id && record.id === id || typeof name === 'string' && name && record.name.trim() === name.trim());
+    return found ? ' — the site has it' : ' — the site has none by that name';
+}
+function stepLine(step, records) {
+    var _HOST_ACTION_STEP_LABELS_step_type, _ref;
+    var _step_when, _step_when1;
+    const label = (_HOST_ACTION_STEP_LABELS_step_type = HOST_ACTION_STEP_LABELS[step.type]) != null ? _HOST_ACTION_STEP_LABELS_step_type : step.type;
+    const detail = (()=>{
+        switch(step.type){
+            case 'sendEmail':
+                return `subject ${quoted(step.subject)}, text ${quoted(step.body, AI_OUTLINE_BODY_MAX_CHARS)}, to the event's ${step.toField || 'email'} field`;
+            case 'notifyAdmins':
+                return quoted(step.title);
+            case 'enrollList':
+                var _ref;
+                return `${quoted(step.listName || step.listId)}${standing(step.listId, step.listName, (_ref = records == null ? void 0 : records.lists) != null ? _ref : null)}`;
+            case 'assignCampaign':
+                var _ref1;
+                return `${quoted(step.campaignName || step.campaignId)}${standing(step.campaignId, step.campaignName, (_ref1 = records == null ? void 0 : records.campaigns) != null ? _ref1 : null)}`;
+            case 'runWorkflow':
+                var _ref2;
+                return `${quoted(step.workflowName || step.workflowId)}${standing(step.workflowId, step.workflowName, (_ref2 = records == null ? void 0 : records.workflows) != null ? _ref2 : null)}`;
+            case 'webhookPost':
+                var _ref3;
+                return `${quoted(step.webhookName || step.webhookId)}${standing(step.webhookId, step.webhookName, (_ref3 = records == null ? void 0 : records.webhooks) != null ? _ref3 : null)}`;
+            case 'datasetAppend':
+            case 'updateDataset':
+                var _ref4;
+                return `${quoted(step.datasetName || step.datasetId)}${standing(step.datasetId, step.datasetName, (_ref4 = records == null ? void 0 : records.datasets) != null ? _ref4 : null)}`;
+            case 'siteAlert':
+                return quoted(step.message);
+            case 'wait':
+                return durationOf(step.delayMinutes);
+            case 'waitForEvent':
+                return `${aiAutomationTriggerLabel(step.eventName)}, giving up after ${durationOf(step.timeoutMinutes)}`;
+            case 'exitFlow':
+                return '';
+            case 'setContactStage':
+                var _CONTACT_LIFECYCLE_STAGE_LABELS_step_lifecycleStage;
+                return `"${(_CONTACT_LIFECYCLE_STAGE_LABELS_step_lifecycleStage = CONTACT_LIFECYCLE_STAGE_LABELS[step.lifecycleStage]) != null ? _CONTACT_LIFECYCLE_STAGE_LABELS_step_lifecycleStage : step.lifecycleStage}"`;
+            case 'addContactTag':
+                return quoted(step.tag);
+            case 'assignContactOwner':
+                return step.roundRobin ? 'by round robin' : 'a named teammate';
+            case 'createCrmTask':
+                return `${quoted(step.title)}, a ${step.kind}, due in ${step.dueInDays} ${step.dueInDays === 1 ? 'day' : 'days'}${step.assigneeUid || step.assigneeEmail ? ', for a named teammate' : ''}`;
+            case 'logCrmActivity':
+                return `a ${step.kind}: ${quoted(step.body)}`;
+            case 'customEvent':
+                return quoted(step.eventName);
+            default:
+                return CLIENT_ACTION_STEP_TYPES.has(step.type) ? 'runs in the visitor’s browser on the page' : '';
+        }
+    })();
+    const guard = ((_ref = (_step_when = step.when) == null ? void 0 : _step_when.conditions) != null ? _ref : []).filter(Boolean);
+    const only = guard.length ? ` Only if ${guard.map(conditionLine).join(((_step_when1 = step.when) == null ? void 0 : _step_when1.combinator) === 'or' ? ' or ' : ' and ')}.` : '';
+    return `${label}${detail ? `: ${detail}` : ''}.${only}`;
+}
+/** Minutes as a person says them. */ function durationOf(minutes) {
+    const value = Number(minutes);
+    if (!Number.isFinite(value) || value <= 0) return 'no time';
+    const units = [
+        [
+            60 * 24 * 7,
+            'week'
+        ],
+        [
+            60 * 24,
+            'day'
+        ],
+        [
+            60,
+            'hour'
+        ],
+        [
+            1,
+            'minute'
+        ]
+    ];
+    for (const [size, unit] of units){
+        if (value % size === 0) {
+            const count = value / size;
+            return `${count} ${unit}${count === 1 ? '' : 's'}`;
+        }
+    }
+    return `${value} minutes`;
+}
+/** A saved action as an outline. */ export function aiActionOutline(action, records) {
+    var _ref, _action_steps, _action_steps1;
+    var _action_trigger, _action_trigger_filter, _action_trigger1;
+    const lines = [
+        `Automation: ${quoted(action.name)} — an action, switched ${action.enabled === false ? 'off' : 'on'}.`,
+        `Starts when: ${aiAutomationTriggerLabel(String((_ref = (_action_trigger = action.trigger) == null ? void 0 : _action_trigger.event) != null ? _ref : ''))}.`
+    ];
+    const conditions = normalizeTriggerConditions(action.trigger);
+    if (conditions.length) {
+        var _action_trigger2;
+        lines.push(`Only when ${((_action_trigger2 = action.trigger) == null ? void 0 : _action_trigger2.combinator) === 'or' ? 'any' : 'all'} of these hold: ${conditions.map(conditionLine).join('; ')}.`);
+    }
+    if ((_action_trigger1 = action.trigger) == null ? void 0 : (_action_trigger_filter = _action_trigger1.filter) == null ? void 0 : _action_trigger_filter.trim()) {
+        lines.push(`And only when this expression is true: ${quoted(action.trigger.filter)}.`);
+    }
+    lines.push('Steps, in order:');
+    ((_action_steps = action.steps) != null ? _action_steps : []).forEach((step, index)=>{
+        lines.push(`${index + 1}. ${stepLine(step, records)}`);
+    });
+    if (!((_action_steps1 = action.steps) != null ? _action_steps1 : []).length) lines.push('(none)');
+    return lines.join('\n');
+}
+/** A saved workflow — a pipeline of function calls — as an outline. */ export function aiWorkflowOutline(workflow, functions) {
+    var _workflow_steps, _workflow_steps1;
+    var _workflow_trigger, _workflow_returnValue;
+    const lines = [
+        `Workflow: ${quoted(workflow.name)} — a workflow, a list of function calls.`
+    ];
+    if ((_workflow_trigger = workflow.trigger) == null ? void 0 : _workflow_trigger.event) {
+        var _workflow_trigger_filter;
+        const filter = (_workflow_trigger_filter = workflow.trigger.filter) == null ? void 0 : _workflow_trigger_filter.trim();
+        lines.push(`Starts when: ${aiAutomationTriggerLabel(workflow.trigger.event)}${filter ? `, only when this expression is true: ${quoted(filter)}` : ''}.`);
+    } else {
+        lines.push('Starts when: it is called — by an automation, an inbound webhook or a computed variable.');
+    }
+    lines.push('Steps, in order:');
+    ((_workflow_steps = workflow.steps) != null ? _workflow_steps : []).forEach((step, index)=>{
+        var _step_args;
+        const name = step.functionName || step.functionId || '';
+        const exists = standing(step.functionId, step.functionName, functions);
+        const args = ((_step_args = step.args) != null ? _step_args : []).filter((arg)=>String(arg != null ? arg : '').trim());
+        lines.push(`${index + 1}. Runs the function ${quoted(name)}${exists}${args.length ? `, given ${args.map((arg)=>quoted(arg)).join(', ')}` : ''}; its result is kept as ${quoted(step.resultName || `step${index + 1}`)}.`);
+    });
+    if (!((_workflow_steps1 = workflow.steps) != null ? _workflow_steps1 : []).length) lines.push('(none)');
+    if ((_workflow_returnValue = workflow.returnValue) == null ? void 0 : _workflow_returnValue.trim()) lines.push(`Returns: ${quoted(workflow.returnValue)}.`);
+    return lines.join('\n');
+}
+function whenOf(value) {
+    const toDate = value == null ? void 0 : value.toDate;
+    const date = typeof toDate === 'function' ? toDate.call(value) : value instanceof Date ? value : null;
+    return date && Number.isFinite(date.getTime()) ? `${date.toISOString().slice(0, 16).replace('T', ' ')} UTC` : null;
+}
+/** The errors a run recorded: the prose after "with errors:", or a workflow's failure. */ export function aiRunErrors(run) {
+    var _run_action, _ref, _run_summary;
+    var _action_match, _action_match1;
+    const action = String((_run_action = run.action) != null ? _run_action : '');
+    const listed = (_action_match = action.match(/with errors:\s*(.+)$/)) == null ? void 0 : _action_match[1];
+    if (listed) {
+        return listed.split(/;\s+/).map((error)=>error.trim()).filter(Boolean).slice(0, AI_OUTLINE_RUN_ERRORS_MAX);
+    }
+    const failed = (_ref = (_action_match1 = action.match(/failed on [^:]+:\s*(.+)$/)) == null ? void 0 : _action_match1[1]) != null ? _ref : run.result === 'failed' ? String((_run_summary = run.summary) != null ? _run_summary : '') : '';
+    return failed.trim() ? [
+        failed.trim()
+    ] : [];
+}
+/** A failed run as an outline: when, on what, what it did, and what went wrong. */ export function aiRunOutline(run) {
+    var _run_trigger, _run_summary;
+    const when = whenOf(run.createdAt);
+    const lines = [
+        `The run that failed: on ${aiAutomationTriggerLabel(String((_run_trigger = run.trigger) != null ? _run_trigger : ''))}${when ? `, ${when}` : ''}.`
+    ];
+    const summary = String((_run_summary = run.summary) != null ? _run_summary : '').trim();
+    const errors = aiRunErrors(run);
+    if (summary && !errors.includes(summary)) lines.push(`What it did: ${aiRedactPersonal(summary)}.`);
+    lines.push('What went wrong:');
+    lines.push(...errors.length ? errors.map((error)=>`- ${aiRedactPersonal(error)}`) : [
+        '- (the run recorded no error)'
+    ]);
+    return lines.join('\n');
+}
+/** An explanation as the text a person reads. */ export function aiWorkflowExplanationText(explanation, mode) {
+    const parts = [
+        explanation.summary
+    ];
+    if (explanation.points.length) {
+        parts.push([
+            mode === 'diagnose' ? 'What happened:' : 'What it does:',
+            ...explanation.points.map((point, index)=>`${index + 1}. ${point}`)
+        ].join('\n'));
+    }
+    if (explanation.suggestions.length) {
+        parts.push([
+            mode === 'diagnose' ? 'How to fix it:' : 'Worth checking:',
+            ...explanation.suggestions.map((suggestion)=>`- ${suggestion}`)
+        ].join('\n'));
+    }
+    return parts.join('\n\n');
+}
+
+//# sourceMappingURL=ai-automation-outline.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-automation-outline.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  CLIENT_ACTION_STEP_TYPES,\n  HOST_ACTION_STEP_LABELS,\n  type HostAction,\n  type HostActionStep,\n  type HostActionStepType,\n  type HostActionTriggerCondition,\n  normalizeTriggerConditions,\n} from '@aglyn/aglyn/app-utils/actions'\nimport { automationPlaceholderIn } from '@aglyn/aglyn/app-utils/automation-placeholders'\nimport { CONTACT_LIFECYCLE_STAGE_LABELS, type ContactLifecycleStage } from '@aglyn/aglyn/app-utils/crm'\nimport type { HostWorkflow } from '@aglyn/aglyn/app-utils/workflows'\nimport { aiAutomationTriggerLabel } from './ai-workflow-job'\nimport type { AiAutomationNamedRecord, AiAutomationRecords } from './ai-automation-draft'\nimport type { AiWorkflowExplanation } from '../tools/ai-workflow-tool'\n\n/**\n * What an explanation is asked from (AGL-2919): a saved automation, and one of\n * its failed runs, as plain lines a model reads — never the stored documents.\n *\n * WHAT IS LEFT OUT. An email address anywhere — a condition's value, an\n * email's text, a run's error naming the contact it could not find — becomes\n * `[email address]`. A teammate named by account id or address is \"a named\n * teammate\". A selector, a script or HTML an on-page step holds is not shown\n * at all; the step is named by its label. A run's event payload, which holds\n * what a visitor submitted, is never read. What is shown is how the automation\n * is set up, and what the run history recorded about the run.\n *\n * WHAT IS ADDED. Whether each list, campaign, workflow, webhook or dataset a\n * step names still exists on the site, looked up in code, because \"that list\n * was deleted\" is the answer to the most common failure and a model cannot\n * find it out.\n */\n\n/** An email address, wherever it appears in a line. */\nconst EMAIL_ADDRESS = /[^\\s@<>()[\\]\"',;:]+@[^\\s@<>()[\\]\"',;:]+\\.[A-Za-z]{2,}/g\n\n/** How much of an email's text an outline quotes. */\nexport const AI_OUTLINE_BODY_MAX_CHARS = 300\n/** How much of any other value an outline quotes. */\nexport const AI_OUTLINE_VALUE_MAX_CHARS = 120\n/** The most errors of one run an outline lists. */\nexport const AI_OUTLINE_RUN_ERRORS_MAX = 10\n\n/** A line with every email address replaced by what it is. */\nexport function aiRedactPersonal(text: string): string {\n  return text.replace(EMAIL_ADDRESS, '[email address]')\n}\n\nfunction quoted(value: unknown, max = AI_OUTLINE_VALUE_MAX_CHARS): string {\n  const text = aiRedactPersonal(String(value ?? '').replace(/\\s+/g, ' ').trim())\n  return `\"${text.length > max ? `${text.slice(0, max)}…` : text}\"`\n}\n\nfunction conditionLine(condition: HostActionTriggerCondition): string {\n  const field = String(condition.field ?? '')\n  if (condition.op === 'notEmpty') return `${field} is not empty`\n  const value = String(condition.value ?? '')\n  const stage = CONTACT_LIFECYCLE_STAGE_LABELS[value as ContactLifecycleStage]\n  const placeholder = automationPlaceholderIn(value) ? ' (a placeholder nobody has filled in)' : ''\n  return `${field} ${condition.op} ${stage ? `\"${stage}\"` : quoted(value)}${placeholder}`\n}\n\n/** The kind of site record each step that names one names. */\nexport const AI_OUTLINE_RECORD_KINDS: Readonly<\n  Partial<Record<HostActionStepType, 'lists' | 'campaigns' | 'workflows' | 'webhooks' | 'datasets'>>\n> = {\n  enrollList: 'lists',\n  assignCampaign: 'campaigns',\n  runWorkflow: 'workflows',\n  webhookPost: 'webhooks',\n  datasetAppend: 'datasets',\n  updateDataset: 'datasets',\n}\n\n/** The kinds of site record an action's steps name, each once. */\nexport function aiActionRecordKinds(action: Pick<HostAction, 'steps'>): Array<keyof AiAutomationRecords> {\n  const kinds = (action.steps ?? []).map((step) => AI_OUTLINE_RECORD_KINDS[step?.type as HostActionStepType])\n  return [...new Set(kinds.filter((kind): kind is NonNullable<typeof kind> => Boolean(kind)))]\n}\n\n/** Whether the site holds a record by the id or the name a step stores. */\nfunction standing(\n  id: unknown,\n  name: unknown,\n  records: readonly AiAutomationNamedRecord[] | null,\n): string {\n  if (automationPlaceholderIn(name) && !String(id ?? '').trim()) {\n    return ' — a placeholder nobody has filled in'\n  }\n  if (!records) return ''\n  const found = records.some(\n    (record) =>\n      (typeof id === 'string' && id && record.id === id) ||\n      (typeof name === 'string' && name && record.name.trim() === name.trim()),\n  )\n  return found ? ' — the site has it' : ' — the site has none by that name'\n}\n\nfunction stepLine(\n  step: HostActionStep,\n  records: AiAutomationRecords | null,\n): string {\n  const label = HOST_ACTION_STEP_LABELS[step.type as HostActionStepType] ?? step.type\n  const detail = (() => {\n    switch (step.type) {\n      case 'sendEmail':\n        return `subject ${quoted(step.subject)}, text ${quoted(step.body, AI_OUTLINE_BODY_MAX_CHARS)}, to the event's ${step.toField || 'email'} field`\n      case 'notifyAdmins':\n        return quoted(step.title)\n      case 'enrollList':\n        return `${quoted(step.listName || step.listId)}${standing(step.listId, step.listName, records?.lists ?? null)}`\n      case 'assignCampaign':\n        return `${quoted(step.campaignName || step.campaignId)}${standing(step.campaignId, step.campaignName, records?.campaigns ?? null)}`\n      case 'runWorkflow':\n        return `${quoted(step.workflowName || step.workflowId)}${standing(step.workflowId, step.workflowName, records?.workflows ?? null)}`\n      case 'webhookPost':\n        return `${quoted(step.webhookName || step.webhookId)}${standing(step.webhookId, step.webhookName, records?.webhooks ?? null)}`\n      case 'datasetAppend':\n      case 'updateDataset':\n        return `${quoted(step.datasetName || step.datasetId)}${standing(step.datasetId, step.datasetName, records?.datasets ?? null)}`\n      case 'siteAlert':\n        return quoted(step.message)\n      case 'wait':\n        return durationOf(step.delayMinutes)\n      case 'waitForEvent':\n        return `${aiAutomationTriggerLabel(step.eventName)}, giving up after ${durationOf(step.timeoutMinutes)}`\n      case 'exitFlow':\n        return ''\n      case 'setContactStage':\n        return `\"${CONTACT_LIFECYCLE_STAGE_LABELS[step.lifecycleStage] ?? step.lifecycleStage}\"`\n      case 'addContactTag':\n        return quoted(step.tag)\n      case 'assignContactOwner':\n        return step.roundRobin ? 'by round robin' : 'a named teammate'\n      case 'createCrmTask':\n        return `${quoted(step.title)}, a ${step.kind}, due in ${step.dueInDays} ${step.dueInDays === 1 ? 'day' : 'days'}${\n          step.assigneeUid || step.assigneeEmail ? ', for a named teammate' : ''\n        }`\n      case 'logCrmActivity':\n        return `a ${step.kind}: ${quoted(step.body)}`\n      case 'customEvent':\n        return quoted(step.eventName)\n      default:\n        return CLIENT_ACTION_STEP_TYPES.has(step.type) ? 'runs in the visitor’s browser on the page' : ''\n    }\n  })()\n  const guard = (step.when?.conditions ?? []).filter(Boolean)\n  const only = guard.length\n    ? ` Only if ${guard.map(conditionLine).join(step.when?.combinator === 'or' ? ' or ' : ' and ')}.`\n    : ''\n  return `${label}${detail ? `: ${detail}` : ''}.${only}`\n}\n\n/** Minutes as a person says them. */\nfunction durationOf(minutes: unknown): string {\n  const value = Number(minutes)\n  if (!Number.isFinite(value) || value <= 0) return 'no time'\n  const units: Array<[number, string]> = [\n    [60 * 24 * 7, 'week'],\n    [60 * 24, 'day'],\n    [60, 'hour'],\n    [1, 'minute'],\n  ]\n  for (const [size, unit] of units) {\n    if (value % size === 0) {\n      const count = value / size\n      return `${count} ${unit}${count === 1 ? '' : 's'}`\n    }\n  }\n  return `${value} minutes`\n}\n\n/** A saved action as an outline. */\nexport function aiActionOutline(\n  action: HostAction,\n  records: AiAutomationRecords | null,\n): string {\n  const lines = [\n    `Automation: ${quoted(action.name)} — an action, switched ${action.enabled === false ? 'off' : 'on'}.`,\n    `Starts when: ${aiAutomationTriggerLabel(String(action.trigger?.event ?? ''))}.`,\n  ]\n  const conditions = normalizeTriggerConditions(action.trigger)\n  if (conditions.length) {\n    lines.push(\n      `Only when ${action.trigger?.combinator === 'or' ? 'any' : 'all'} of these hold: ${conditions\n        .map(conditionLine)\n        .join('; ')}.`,\n    )\n  }\n  if (action.trigger?.filter?.trim()) {\n    lines.push(`And only when this expression is true: ${quoted(action.trigger.filter)}.`)\n  }\n  lines.push('Steps, in order:')\n  ;(action.steps ?? []).forEach((step, index) => {\n    lines.push(`${index + 1}. ${stepLine(step, records)}`)\n  })\n  if (!(action.steps ?? []).length) lines.push('(none)')\n  return lines.join('\\n')\n}\n\n/** A saved workflow — a pipeline of function calls — as an outline. */\nexport function aiWorkflowOutline(\n  workflow: HostWorkflow,\n  functions: readonly AiAutomationNamedRecord[] | null,\n): string {\n  const lines = [`Workflow: ${quoted(workflow.name)} — a workflow, a list of function calls.`]\n  if (workflow.trigger?.event) {\n    const filter = workflow.trigger.filter?.trim()\n    lines.push(\n      `Starts when: ${aiAutomationTriggerLabel(workflow.trigger.event)}${\n        filter ? `, only when this expression is true: ${quoted(filter)}` : ''\n      }.`,\n    )\n  } else {\n    lines.push('Starts when: it is called — by an automation, an inbound webhook or a computed variable.')\n  }\n  lines.push('Steps, in order:')\n  ;(workflow.steps ?? []).forEach((step, index) => {\n    const name = step.functionName || step.functionId || ''\n    const exists = standing(step.functionId, step.functionName, functions)\n    const args = (step.args ?? []).filter((arg) => String(arg ?? '').trim())\n    lines.push(\n      `${index + 1}. Runs the function ${quoted(name)}${exists}${\n        args.length ? `, given ${args.map((arg) => quoted(arg)).join(', ')}` : ''\n      }; its result is kept as ${quoted(step.resultName || `step${index + 1}`)}.`,\n    )\n  })\n  if (!(workflow.steps ?? []).length) lines.push('(none)')\n  if (workflow.returnValue?.trim()) lines.push(`Returns: ${quoted(workflow.returnValue)}.`)\n  return lines.join('\\n')\n}\n\n/** What the run history recorded about one run, as far as an outline reads it. */\nexport interface AiRunRecord {\n  result?: unknown\n  trigger?: unknown\n  summary?: unknown\n  action?: unknown\n  createdAt?: unknown\n}\n\nfunction whenOf(value: unknown): string | null {\n  const toDate = (value as { toDate?: () => Date } | null)?.toDate\n  const date =\n    typeof toDate === 'function'\n      ? toDate.call(value)\n      : value instanceof Date\n        ? value\n        : null\n  return date && Number.isFinite(date.getTime()) ? `${date.toISOString().slice(0, 16).replace('T', ' ')} UTC` : null\n}\n\n/** The errors a run recorded: the prose after \"with errors:\", or a workflow's failure. */\nexport function aiRunErrors(run: AiRunRecord): string[] {\n  const action = String(run.action ?? '')\n  const listed = action.match(/with errors:\\s*(.+)$/)?.[1]\n  if (listed) {\n    return listed\n      .split(/;\\s+/)\n      .map((error) => error.trim())\n      .filter(Boolean)\n      .slice(0, AI_OUTLINE_RUN_ERRORS_MAX)\n  }\n  const failed = action.match(/failed on [^:]+:\\s*(.+)$/)?.[1] ?? (run.result === 'failed' ? String(run.summary ?? '') : '')\n  return failed.trim() ? [failed.trim()] : []\n}\n\n/** A failed run as an outline: when, on what, what it did, and what went wrong. */\nexport function aiRunOutline(run: AiRunRecord): string {\n  const when = whenOf(run.createdAt)\n  const lines = [\n    `The run that failed: on ${aiAutomationTriggerLabel(String(run.trigger ?? ''))}${when ? `, ${when}` : ''}.`,\n  ]\n  const summary = String(run.summary ?? '').trim()\n  const errors = aiRunErrors(run)\n  if (summary && !errors.includes(summary)) lines.push(`What it did: ${aiRedactPersonal(summary)}.`)\n  lines.push('What went wrong:')\n  lines.push(...(errors.length ? errors.map((error) => `- ${aiRedactPersonal(error)}`) : ['- (the run recorded no error)']))\n  return lines.join('\\n')\n}\n\n/** An explanation as the text a person reads. */\nexport function aiWorkflowExplanationText(\n  explanation: AiWorkflowExplanation,\n  mode: 'explain' | 'diagnose',\n): string {\n  const parts = [explanation.summary]\n  if (explanation.points.length) {\n    parts.push(\n      [\n        mode === 'diagnose' ? 'What happened:' : 'What it does:',\n        ...explanation.points.map((point, index) => `${index + 1}. ${point}`),\n      ].join('\\n'),\n    )\n  }\n  if (explanation.suggestions.length) {\n    parts.push(\n      [\n        mode === 'diagnose' ? 'How to fix it:' : 'Worth checking:',\n        ...explanation.suggestions.map((suggestion) => `- ${suggestion}`),\n      ].join('\\n'),\n    )\n  }\n  return parts.join('\\n\\n')\n}\n"],"names":["CLIENT_ACTION_STEP_TYPES","HOST_ACTION_STEP_LABELS","normalizeTriggerConditions","automationPlaceholderIn","CONTACT_LIFECYCLE_STAGE_LABELS","aiAutomationTriggerLabel","EMAIL_ADDRESS","AI_OUTLINE_BODY_MAX_CHARS","AI_OUTLINE_VALUE_MAX_CHARS","AI_OUTLINE_RUN_ERRORS_MAX","aiRedactPersonal","text","replace","quoted","value","max","String","trim","length","slice","conditionLine","condition","field","op","stage","placeholder","AI_OUTLINE_RECORD_KINDS","enrollList","assignCampaign","runWorkflow","webhookPost","datasetAppend","updateDataset","aiActionRecordKinds","action","kinds","steps","map","step","type","Set","filter","kind","Boolean","standing","id","name","records","found","some","record","stepLine","label","detail","subject","body","toField","title","listName","listId","lists","campaignName","campaignId","campaigns","workflowName","workflowId","workflows","webhookName","webhookId","webhooks","datasetName","datasetId","datasets","message","durationOf","delayMinutes","eventName","timeoutMinutes","lifecycleStage","tag","roundRobin","dueInDays","assigneeUid","assigneeEmail","has","guard","when","conditions","only","join","combinator","minutes","Number","isFinite","units","size","unit","count","aiActionOutline","lines","enabled","trigger","event","push","forEach","index","aiWorkflowOutline","workflow","functions","functionName","functionId","exists","args","arg","resultName","returnValue","whenOf","toDate","date","call","Date","getTime","toISOString","aiRunErrors","run","listed","match","split","error","failed","result","summary","aiRunOutline","createdAt","errors","includes","aiWorkflowExplanationText","explanation","mode","parts","points","point","suggestions","suggestion"],"mappings":"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"}

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

@@ -0,0 +1,197 @@
+/**
+ * @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 { AiTool } from '../providers/contract';
+/**
+ * The plan a generation job builds from (AGL-2935): what the job's plan step
+ * (`jobs/ai-job-plan-step.ts`) returns, before a single node is generated.
+ *
+ * This module is the plan's MODEL — its shape, its tool schema and its
+ * reader — and imports nothing at runtime, so the doctrine validators, the
+ * plan step, the job document and the proposal can all read it without
+ * importing each other.
+ *
+ * A plan is REFERENCES, never documents (AGL-2937). It names what the site
+ * already has by inventory id, what the job will create by a short name, and
+ * which screens it builds from which of those — so the doctrine can be held
+ * against the plan while fixing it costs a sentence, not a regenerated page,
+ * and the customer reads what the job will do before it spends a credit on
+ * doing it.
+ *
+ * `new:<name>` is how an entry refers to something the plan itself creates;
+ * any other reference is an id from the site inventory.
+ */
+export declare const AI_PLAN_NEW_REF_PREFIX = "new:";
+/** Records a plan may reuse, by the inventory list they come from. */
+export type AiBuildPlanReuseKind = 'component' | 'layout' | 'template' | 'form' | 'dataset' | 'collection' | 'screen' | 'theme';
+export declare const AI_BUILD_PLAN_REUSE_KINDS: readonly AiBuildPlanReuseKind[];
+/** What a plan may create. A theme change is a draft through the theme door, never a literal. */
+export type AiBuildPlanCreateKind = 'component' | 'layout' | 'template' | 'form' | 'theme-change' | 'dataset' | 'email';
+/**
+ * What each creation is called in a sentence, and where a member makes one.
+ *
+ * Total over the union deliberately: a refusal that cannot name a creation is
+ * a refusal a member cannot act on, so widening `AiBuildPlanCreateKind`
+ * without saying where the new thing is made does not compile.
+ */
+export declare const AI_BUILD_PLAN_CREATION_NOUNS: Record<AiBuildPlanCreateKind, {
+    noun: string;
+    where: string;
+}>;
+export declare const AI_BUILD_PLAN_CREATE_KINDS: readonly AiBuildPlanCreateKind[];
+export interface AiBuildPlanReuse {
+    kind: AiBuildPlanReuseKind;
+    /** The inventory id. */
+    id: string;
+    /** What the plan uses it for, in a few words. */
+    purpose: string;
+}
+export interface AiBuildPlanCreate {
+    kind: AiBuildPlanCreateKind;
+    /** Unique within the plan; referenced as `new:<name>`. */
+    name: string;
+    /** Why nothing the site has will do — shown in the proposal. */
+    why: string;
+    /** The inventory id this starts from as a duplicate, or null. */
+    duplicateOf: string | null;
+    /**
+     * A component: its props as `name:type`, an icon as `name:icon`
+     * (AGL-3054). A layout: the regions it has, from the closed vocabulary
+     * `AI_LAYOUT_REGIONS` holds (AGL-3024) — a layout has no props, and a
+     * region named here is what the built layout is held to. A form or a
+     * dataset: its field names. A theme change: the palette paths it adds or
+     * changes.
+     */
+    fields: string[];
+    /**
+     * The id the draft this creation becomes is written under, where a unit of
+     * the job builds it (AGL-3079). Minted when the job keeps the plan, never
+     * part of the model's answer.
+     */
+    id?: string;
+}
+export interface AiBuildPlanSection {
+    /** A few words: "hero", "services grid", "contact form". */
+    name: string;
+    /** What the section places: inventory ids or `new:<name>` references. */
+    uses: string[];
+    /** How many repeated items it shows (cards, rows, tiles); 0 when none. */
+    items: number;
+}
+export interface AiBuildPlanScreen {
+    title: string;
+    slug: string;
+    /** The layout it renders inside. */
+    layout: string | null;
+    /** The template it applies, or null for a one-off page. */
+    template: string | null;
+    /** The inventory screen it starts from as a duplicate, or null. */
+    duplicateOf: string | null;
+    /** Whether the site navigation gains an entry for it. */
+    nav: boolean;
+    seoTitle: string;
+    seoDescription: string;
+    sections: AiBuildPlanSection[];
+    /**
+     * The id the draft screen is written under, where a unit of the job builds
+     * it (AGL-3079). Minted when the job keeps the plan, never part of the
+     * model's answer.
+     */
+    id?: string;
+}
+export interface AiBuildPlan {
+    reuse: AiBuildPlanReuse[];
+    create: AiBuildPlanCreate[];
+    screens: AiBuildPlanScreen[];
+}
+/**
+ * How much one plan may hold. A job builds what one proposal can describe
+ * and one person can read before confirming; a brief asking for more is
+ * several jobs.
+ */
+export declare const AI_BUILD_PLAN_LIMITS: {
+    readonly reuse: 40;
+    readonly create: 20;
+    readonly screens: 12;
+    readonly sections: 16;
+    readonly uses: 8;
+    readonly fields: 30;
+    readonly text: 200;
+    readonly seoDescription: 320;
+    readonly items: 500;
+};
+/**
+ * The plan as a strict tool's input schema. Only the keywords strict
+ * structured output accepts: every object closes its properties and lists
+ * every one as required, an optional value is a `null` branch, and no
+ * length or count bound appears as a keyword — those are enforced by
+ * `parseAiBuildPlan`, which every answer passes through anyway.
+ *
+ * A text ceiling is stated in words instead, on each field the model writes.
+ * A reference is copied from the inventory or from a creation's name, so its
+ * length is not the model's to choose. A search title and description are
+ * held by rule 10 to ceilings far inside the reader's, which the doctrine
+ * states, so naming the reader's here would contradict the rule.
+ */
+export declare const AI_BUILD_PLAN_TOOL: AiTool;
+export type AiBuildPlanParse = {
+    ok: true;
+    plan: AiBuildPlan;
+    repairs: string[];
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Read a plan out of a tool call, or name what makes it unreadable.
+ *
+ * Structure is refused — a missing list, an unknown kind, more screens than
+ * a job holds, two creations under one name — because a plan that reads
+ * differently from what the model meant is worse than a re-ask. Length is
+ * repaired: copy past a ceiling is cut and the cut is listed.
+ */
+export declare function parseAiBuildPlan(input: unknown): AiBuildPlanParse;
+/** Whether a reference names something the plan creates. */
+export declare function isAiPlanNewRef(ref: string | null | undefined): ref is string;
+/** The creation a `new:<name>` reference names, case-insensitively. */
+export declare function aiPlanCreateFor(plan: AiBuildPlan, ref: string): AiBuildPlanCreate | undefined;
+/**
+ * A `new:<name>` reference that names no entry of the plan's create list: a
+ * screen's own layout or template, or what one of its sections places, with
+ * that section's index.
+ */
+export type AiPlanUndeclaredRef = {
+    /** The name the reference gives the creation, as written after `new:`. */
+    name: string;
+    /** Where the plan writes it: `screens[0].template`, `screens[0].sections[4].uses[0]`. */
+    path: string;
+    /** The screen that writes it, by index. */
+    screenIndex: number;
+} & ({
+    field: 'layout' | 'template';
+    sectionIndex: null;
+} | {
+    field: 'uses';
+    sectionIndex: number;
+});
+/**
+ * Every `new:<name>` reference the plan's create list does not carry, in plan
+ * order: each screen's layout, then its template, then what its sections
+ * place. A plan that places a creation it never declares has nothing to build
+ * it from, so the plan rules refuse each (AGL-3040), and the page and
+ * scaffold doors still name one in a plan confirmed before they did.
+ */
+export declare function aiPlanUndeclaredRefs(plan: AiBuildPlan): AiPlanUndeclaredRef[];