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

package/src/lib/model/ai-workflow-job.js

@@ -20,7 +20,7 @@ import { HOST_EVENT_LABELS, HOST_EVENT_TYPES } from "@aglyn/aglyn/app-utils/host
  * A `workflow` job (AGL-2919): an automation drafted from a description, or an
  * existing automation explained — what it does, or why one of its runs failed.
  *
- * One kind, three modes, because the three share everything a job carries:
+ * One kind, four modes, because the four share everything a job carries:
  * the site, the gates, the meter and the automation vocabulary. `inputs.mode`
  * picks the mode, and a job created without one drafts.
  *
@@ -32,12 +32,31 @@ import { HOST_EVENT_LABELS, HOST_EVENT_TYPES } from "@aglyn/aglyn/app-utils/host
  *    answers in plain words what it does.
  *  - `diagnose` reads a saved automation and one of its FAILED runs, as the
  *    run history recorded it, and answers why it failed and what to change.
+ *  - `revise` reads a saved ACTION and a change asked of it — "fix it", or
+ *    "also tag them" — and writes the action as it would be after the change
+ *    as a NEW draft, OFF, through the same draft writer and vocabulary as
+ *    `draft`. The saved action is never written: the person compares the two,
+ *    switches the new one on and the old one off. An action that holds what
+ *    the vocabulary cannot write (an on-page step, a page event, a filter
+ *    expression) is refused rather than revised without it.
  *
- * Nothing in any mode switches an automation on, runs one, or changes one.
+ * `draft` has a second scope (AGL-3603): `scope: 'org'` drafts one of the
+ * WORKSPACE's automations — the ones the workflows plugin's Org automations
+ * section places on several sites — with no site named. Its vocabulary is
+ * the narrower one that section's zone hands the widget (`triggers` and
+ * `steps`, each a comma-separated list, intersected here with the drafting
+ * vocabulary below), its records are the workspace's, and nothing is written:
+ * the automation rides on an `orgAutomation` output as a proposal that the
+ * section's editor opens unsaved, switched off, where the person picks its
+ * sites and saves it through that section's own route.
+ *
+ * Nothing in any mode switches an automation on, runs one, or changes a saved
+ * one.
  */ export const AI_WORKFLOW_JOB_MODES = [
     'draft',
     'explain',
-    'diagnose'
+    'diagnose',
+    'revise'
 ];
 /** What an explained automation is: an action, or a workflow of function calls. */ export const AI_WORKFLOW_TARGET_TYPES = [
     'action',
@@ -48,11 +67,18 @@ const DOCUMENT_ID = /^[A-Za-z0-9_-]{1,128}$/;
     var _ref;
     const mode = (_ref = inputs == null ? void 0 : inputs['mode']) != null ? _ref : 'draft';
     if (!AI_WORKFLOW_JOB_MODES.includes(mode)) {
-        return 'inputs.mode must be draft, explain or diagnose';
+        return 'inputs.mode must be draft, explain, diagnose or revise';
+    }
+    if (mode === 'draft') {
+        if ((inputs == null ? void 0 : inputs['scope']) !== 'org') return {
+            mode
+        };
+        const vocabulary = readAiOrgAutomationVocabulary(inputs);
+        return vocabulary ? _extends({
+            mode,
+            scope: 'org'
+        }, vocabulary) : AI_ORG_AUTOMATION_NO_VOCABULARY_COPY;
     }
-    if (mode === 'draft') return {
-        mode
-    };
     const targetType = inputs == null ? void 0 : inputs['targetType'];
     const targetId = inputs == null ? void 0 : inputs['targetId'];
     if (!AI_WORKFLOW_TARGET_TYPES.includes(targetType) || typeof targetId !== 'string' || !DOCUMENT_ID.test(targetId)) {
@@ -65,6 +91,15 @@ const DOCUMENT_ID = /^[A-Za-z0-9_-]{1,128}$/;
     if (mode === 'explain') return _extends({
         mode
     }, target);
+    if (mode === 'revise') {
+        // A workflow is a list of function calls the draft writer does not write.
+        if (targetType !== 'action') return AI_WORKFLOW_REVISE_WORKFLOW_COPY;
+        return {
+            mode,
+            targetType,
+            targetId
+        };
+    }
     const runId = inputs == null ? void 0 : inputs['runId'];
     if (typeof runId !== 'string' || !DOCUMENT_ID.test(runId)) return 'Pick the run to explain';
     return _extends({
@@ -73,6 +108,31 @@ const DOCUMENT_ID = /^[A-Za-z0-9_-]{1,128}$/;
         runId
     });
 }
+/** A comma-separated list of names, each kept only when `known` has it, in `known`'s order. */ function knownNames(raw, known) {
+    const asked = new Set((typeof raw === 'string' ? raw : '').split(',').map((name)=>name.trim()).filter(Boolean));
+    return known.filter((name)=>asked.has(name));
+}
+/**
+ * An org automation's vocabulary from a job's inputs: the triggers and steps
+ * the zone named that the drafting vocabulary also has, or `null` when that
+ * leaves no trigger or no step. The zone can only narrow what is drafted;
+ * the section's save route holds what is saved to its own rules.
+ */ export function readAiOrgAutomationVocabulary(inputs) {
+    const triggers = knownNames(inputs == null ? void 0 : inputs['triggers'], AI_AUTOMATION_TRIGGERS);
+    const steps = knownNames(inputs == null ? void 0 : inputs['steps'], AI_AUTOMATION_STEP_TYPES);
+    return triggers.length && steps.length ? {
+        triggers,
+        steps
+    } : null;
+}
+/** An org automation's vocabulary as a job's inputs carry it. */ export function aiOrgAutomationInputs(vocabulary) {
+    return {
+        mode: 'draft',
+        scope: 'org',
+        triggers: vocabulary.triggers.join(','),
+        steps: vocabulary.steps.join(',')
+    };
+}
 /** Each need as a sentence names it. */ export const AI_AUTOMATION_NEED_LABELS = {
     crm: 'the CRM',
     webhooks: 'webhooks',
@@ -178,5 +238,62 @@ export const AI_WORKFLOW_RUN_NOT_FAILED_COPY = 'That run did not fail, so there
 export const AI_WORKFLOW_NO_DRAFT_COPY = 'The AI could not draft an automation from this description. Try describing what happens, and what should happen then.';
 export const AI_WORKFLOW_NO_EXPLANATION_COPY = 'The AI could not explain this automation. Try again.';
 export const AI_WORKFLOW_SAVE_FAILURE_COPY = 'The automation was drafted but could not be saved. Try the job again.';
+export const AI_ORG_AUTOMATION_NO_VOCABULARY_COPY = 'Open Org automations to draft one: the page says what an org automation can start on and do.';
+export const AI_ORG_AUTOMATION_UNAVAILABLE_COPY = 'Turn on Automation for this workspace before drafting an org automation.';
+export const AI_ORG_AUTOMATION_PLAN_COPY = 'Org automations are built from the actions builder, which this workspace’s plan does not include. Upgrade in Billing to build them.';
+/**
+ * The output resource an org automation's proposal rides on (AGL-3603): never
+ * a document — the Org automations editor opens it unsaved.
+ */ export const AI_ORG_AUTOMATION_RESOURCE = 'orgAutomation';
+/** An output's proposal read back, or `null` for one that is not an org automation. */ export function readAiOrgAutomationProposal(value) {
+    const automation = value == null ? void 0 : value.automation;
+    if (!automation || typeof automation !== 'object') return null;
+    const trigger = automation['trigger'];
+    const steps = automation['steps'];
+    if (!trigger || typeof trigger['event'] !== 'string' || !Array.isArray(steps)) return null;
+    if (!steps.every((step)=>step && typeof step === 'object' && typeof step.type === 'string')) {
+        return null;
+    }
+    return {
+        name: typeof automation['name'] === 'string' ? automation['name'] : '',
+        trigger: _extends({
+            event: trigger['event']
+        }, Array.isArray(trigger['conditions']) ? {
+            conditions: trigger['conditions']
+        } : {}, trigger['combinator'] === 'or' || trigger['combinator'] === 'and' ? {
+            combinator: trigger['combinator']
+        } : {}),
+        steps: steps
+    };
+}
+export const AI_WORKFLOW_REVISE_WORKFLOW_COPY = 'Only an action can be changed with AI. A workflow can be explained, and edited in its own editor.';
+// ── An action AI can revise ───────────────────────────────────────────────
+/** Why a saved action cannot be revised, each with the sentence a person reads. */ export const AI_WORKFLOW_REVISE_BLOCKERS = [
+    'page-event',
+    'page-step',
+    'filter'
+];
+export const AI_WORKFLOW_REVISE_BLOCKER_COPY = {
+    'page-event': 'This action starts on something a visitor does on a page, which AI does not write, so it cannot be changed with AI. Edit it here instead.',
+    'page-step': 'This action has a step that runs on the page, which AI does not write, so it cannot be changed with AI without losing that step. Edit it here instead.',
+    filter: 'This action only runs when an expression is true, which AI does not write, so it cannot be changed with AI without losing it. Edit it here instead.'
+};
+/**
+ * Why a saved action cannot be revised, or `null` when every part of it is
+ * one the drafting vocabulary writes — so the revised draft can hold the
+ * whole action and lose nothing the person did not ask to change.
+ */ export function aiActionReviseBlocker(action) {
+    var _action_steps;
+    var _action_trigger, _action_trigger1;
+    const event = (_action_trigger = action.trigger) == null ? void 0 : _action_trigger.event;
+    if (!AI_AUTOMATION_TRIGGERS.includes(event)) return 'page-event';
+    const steps = (_action_steps = action.steps) != null ? _action_steps : [];
+    if (steps.some((step)=>!AI_AUTOMATION_STEP_TYPES.includes(step == null ? void 0 : step.type))) {
+        return 'page-step';
+    }
+    const filter = (_action_trigger1 = action.trigger) == null ? void 0 : _action_trigger1.filter;
+    if (typeof filter === 'string' && filter.trim()) return 'filter';
+    return null;
+}
 
 //# sourceMappingURL=ai-workflow-job.js.map

package/src/lib/model/ai-workflow-job.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-workflow-job.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { checkEntitlement } from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport {\n  HOST_EVENT_LABELS,\n  HOST_EVENT_TYPES,\n  type HostEventType,\n} from '@aglyn/aglyn/app-utils/host-events'\nimport type { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport type { AiAutomationFormatStepType } from './ai-automation-format'\n\n/**\n * A `workflow` job (AGL-2919): an automation drafted from a description, or an\n * existing automation explained — what it does, or why one of its runs failed.\n *\n * One kind, three modes, because the three share everything a job carries:\n * the site, the gates, the meter and the automation vocabulary. `inputs.mode`\n * picks the mode, and a job created without one drafts.\n *\n *  - `draft` writes a new automation to the site's Actions through the\n *    workflows plugin's draft writer, OFF, built only from the triggers and\n *    steps below that this workspace can run. What the description names that\n *    the site does not have is left as a placeholder, never guessed.\n *  - `explain` reads a saved automation — an action or a workflow — and\n *    answers in plain words what it does.\n *  - `diagnose` reads a saved automation and one of its FAILED runs, as the\n *    run history recorded it, and answers why it failed and what to change.\n *\n * Nothing in any mode switches an automation on, runs one, or changes one.\n */\n\nexport const AI_WORKFLOW_JOB_MODES = ['draft', 'explain', 'diagnose'] as const\nexport type AiWorkflowJobMode = (typeof AI_WORKFLOW_JOB_MODES)[number]\n\n/** What an explained automation is: an action, or a workflow of function calls. */\nexport const AI_WORKFLOW_TARGET_TYPES = ['action', 'workflow'] as const\nexport type AiWorkflowTargetType = (typeof AI_WORKFLOW_TARGET_TYPES)[number]\n\nexport type AiWorkflowJobInputs =\n  | { mode: 'draft' }\n  | { mode: 'explain'; targetType: AiWorkflowTargetType; targetId: string }\n  | { mode: 'diagnose'; targetType: AiWorkflowTargetType; targetId: string; runId: string }\n\nconst DOCUMENT_ID = /^[A-Za-z0-9_-]{1,128}$/\n\n/** A job's inputs read into its mode, or the sentence that says what is wrong with them. */\nexport function parseAiWorkflowJobInputs(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n): AiWorkflowJobInputs | string {\n  const mode = inputs?.['mode'] ?? 'draft'\n  if (!(AI_WORKFLOW_JOB_MODES as readonly unknown[]).includes(mode)) {\n    return 'inputs.mode must be draft, explain or diagnose'\n  }\n  if (mode === 'draft') return { mode }\n  const targetType = inputs?.['targetType']\n  const targetId = inputs?.['targetId']\n  if (\n    !(AI_WORKFLOW_TARGET_TYPES as readonly unknown[]).includes(targetType) ||\n    typeof targetId !== 'string' ||\n    !DOCUMENT_ID.test(targetId)\n  ) {\n    return 'Pick the automation to explain'\n  }\n  const target = { targetType: targetType as AiWorkflowTargetType, targetId }\n  if (mode === 'explain') return { mode, ...target }\n  const runId = inputs?.['runId']\n  if (typeof runId !== 'string' || !DOCUMENT_ID.test(runId)) return 'Pick the run to explain'\n  return { mode: 'diagnose', ...target, runId }\n}\n\n// ── What a workspace can run ──────────────────────────────────────────────\n\n/** A part of the platform some triggers and steps need beyond the actions builder itself. */\nexport type AiAutomationNeed = 'crm' | 'webhooks' | 'bookings'\n\nexport type AiAutomationCapabilities = Readonly<Record<AiAutomationNeed, boolean>>\n\n/** Each need as a sentence names it. */\nexport const AI_AUTOMATION_NEED_LABELS: Readonly<Record<AiAutomationNeed, string>> = {\n  crm: 'the CRM',\n  webhooks: 'webhooks',\n  bookings: 'bookings',\n}\n\n/**\n * What this workspace can run, from the entitlements the executor itself\n * reads before it runs a step: `crm` for the CRM steps, `webhooks` for a\n * webhook post, and `bookings` for the booking trigger's door.\n */\nexport function aiAutomationCapabilities(\n  org: Partial<AglynOrgBilling> | Readonly<Record<string, unknown>> | null | undefined,\n): AiAutomationCapabilities {\n  const billing = org as Partial<AglynOrgBilling> | null | undefined\n  return {\n    crm: checkEntitlement(billing, 'crm'),\n    webhooks: checkEntitlement(billing, 'webhooks'),\n    bookings: checkEntitlement(billing, 'bookings'),\n  }\n}\n\n// ── The vocabulary ────────────────────────────────────────────────────────\n\n/**\n * The triggers a drafted automation may start on: every host event, which is\n * every event a server door emits. The on-page events (a click, a scroll) are\n * left out: they watch one element of one page, which a description cannot\n * name, and they belong to the page's own interactions.\n */\nexport const AI_AUTOMATION_TRIGGERS: readonly HostEventType[] = HOST_EVENT_TYPES\n\n/** The triggers only a door of a part of the platform emits. */\nexport const AI_AUTOMATION_TRIGGER_NEEDS: Readonly<Partial<Record<HostEventType, AiAutomationNeed>>> = {\n  booking: 'bookings',\n  taskCompleted: 'crm',\n  contactStageChanged: 'crm',\n  dealStageChanged: 'crm',\n  dealWon: 'crm',\n  dealLost: 'crm',\n}\n\n/**\n * The steps a drafted automation may take: the server steps and the flow\n * steps, which act on the person an event names. The on-page steps — show an\n * element, open a menu, run a script — are left out for the reason the\n * on-page triggers are: they need a selector on a page a description cannot\n * name.\n */\nexport const AI_AUTOMATION_STEP_TYPES = [\n  'sendEmail',\n  'notifyAdmins',\n  'enrollList',\n  'assignCampaign',\n  'runWorkflow',\n  'datasetAppend',\n  'updateDataset',\n  'webhookPost',\n  'siteAlert',\n  'wait',\n  'waitForEvent',\n  'exitFlow',\n  'setContactStage',\n  'addContactTag',\n  'assignContactOwner',\n  'createCrmTask',\n  'logCrmActivity',\n] as const satisfies readonly AiAutomationFormatStepType[]\n\nexport type AiAutomationStepType = (typeof AI_AUTOMATION_STEP_TYPES)[number]\n\n/** The steps the executor refuses without a part of the platform. */\nexport const AI_AUTOMATION_STEP_NEEDS: Readonly<Partial<Record<AiAutomationStepType, AiAutomationNeed>>> = {\n  webhookPost: 'webhooks',\n  setContactStage: 'crm',\n  addContactTag: 'crm',\n  assignContactOwner: 'crm',\n  createCrmTask: 'crm',\n  logCrmActivity: 'crm',\n}\n\n/** The trigger's name as the Actions editor labels it. */\nexport function aiAutomationTriggerLabel(event: string): string {\n  return HOST_EVENT_LABELS[event as HostEventType] ?? event\n}\n\n// ── A description the vocabulary cannot build ─────────────────────────────\n\n/**\n * Why a description was answered with no automation. Each is a fixed reason\n * with a fixed sentence, so what a person reads is never the model's own\n * account of itself.\n */\nexport const AI_AUTOMATION_UNSUPPORTED = [\n  'not-an-automation',\n  'no-trigger',\n  'no-step',\n  'needs-crm',\n  'needs-webhooks',\n  'needs-bookings',\n] as const\n\nexport type AiAutomationUnsupported = (typeof AI_AUTOMATION_UNSUPPORTED)[number]\n\n/** The need an unsupported reason names, for the reasons that name one. */\nexport const AI_AUTOMATION_UNSUPPORTED_NEED: Readonly<\n  Partial<Record<AiAutomationUnsupported, AiAutomationNeed>>\n> = {\n  'needs-crm': 'crm',\n  'needs-webhooks': 'webhooks',\n  'needs-bookings': 'bookings',\n}\n\nexport const AI_AUTOMATION_UNSUPPORTED_COPY: Readonly<Record<AiAutomationUnsupported, string>> = {\n  'not-an-automation':\n    'This description is not an automation — something that happens, and what to do then — so nothing was drafted.',\n  'no-trigger':\n    'Nothing on the platform can start an automation like this one, so nothing was drafted. Describe it as something that happens on your site, such as a form being submitted.',\n  'no-step': 'An automation cannot do what this description asks yet, so nothing was drafted.',\n  'needs-crm':\n    'This automation needs the CRM, which this workspace’s plan does not include, so nothing was drafted.',\n  'needs-webhooks':\n    'This automation needs webhooks, which this workspace’s plan does not include, so nothing was drafted.',\n  'needs-bookings':\n    'This automation needs bookings, which this workspace’s plan does not include, so nothing was drafted.',\n}\n\n// ── What a job tells a person ─────────────────────────────────────────────\n\n/** The resource the workflows plugin writes a drafted automation under. */\nexport const AI_AUTOMATION_RESOURCE = 'automation'\n\nexport const AI_WORKFLOW_NO_SITE_COPY = 'This automation job names a site this workspace does not have.'\nexport const AI_WORKFLOW_UNAVAILABLE_COPY = 'Automations are not available on this site.'\nexport const AI_WORKFLOW_GONE_COPY = 'That automation no longer exists.'\nexport const AI_WORKFLOW_RUN_GONE_COPY = 'That run is no longer in the automation’s history.'\nexport const AI_WORKFLOW_RUN_NOT_FAILED_COPY = 'That run did not fail, so there is nothing to explain.'\nexport const AI_WORKFLOW_NO_DRAFT_COPY =\n  'The AI could not draft an automation from this description. Try describing what happens, and what should happen then.'\nexport const AI_WORKFLOW_NO_EXPLANATION_COPY =\n  'The AI could not explain this automation. Try again.'\nexport const AI_WORKFLOW_SAVE_FAILURE_COPY =\n  'The automation was drafted but could not be saved. Try the job again.'\n"],"names":["checkEntitlement","HOST_EVENT_LABELS","HOST_EVENT_TYPES","AI_WORKFLOW_JOB_MODES","AI_WORKFLOW_TARGET_TYPES","DOCUMENT_ID","parseAiWorkflowJobInputs","inputs","mode","includes","targetType","targetId","test","target","runId","AI_AUTOMATION_NEED_LABELS","crm","webhooks","bookings","aiAutomationCapabilities","org","billing","AI_AUTOMATION_TRIGGERS","AI_AUTOMATION_TRIGGER_NEEDS","booking","taskCompleted","contactStageChanged","dealStageChanged","dealWon","dealLost","AI_AUTOMATION_STEP_TYPES","AI_AUTOMATION_STEP_NEEDS","webhookPost","setContactStage","addContactTag","assignContactOwner","createCrmTask","logCrmActivity","aiAutomationTriggerLabel","event","AI_AUTOMATION_UNSUPPORTED","AI_AUTOMATION_UNSUPPORTED_NEED","AI_AUTOMATION_UNSUPPORTED_COPY","AI_AUTOMATION_RESOURCE","AI_WORKFLOW_NO_SITE_COPY","AI_WORKFLOW_UNAVAILABLE_COPY","AI_WORKFLOW_GONE_COPY","AI_WORKFLOW_RUN_GONE_COPY","AI_WORKFLOW_RUN_NOT_FAILED_COPY","AI_WORKFLOW_NO_DRAFT_COPY","AI_WORKFLOW_NO_EXPLANATION_COPY","AI_WORKFLOW_SAVE_FAILURE_COPY"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-workflow-job.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { checkEntitlement } from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport {\n  HOST_EVENT_LABELS,\n  HOST_EVENT_TYPES,\n  type HostEventType,\n} from '@aglyn/aglyn/app-utils/host-events'\nimport type { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport type { AiAutomationFormatStepType } from './ai-automation-format'\n\n/**\n * A `workflow` job (AGL-2919): an automation drafted from a description, or an\n * existing automation explained — what it does, or why one of its runs failed.\n *\n * One kind, four modes, because the four share everything a job carries:\n * the site, the gates, the meter and the automation vocabulary. `inputs.mode`\n * picks the mode, and a job created without one drafts.\n *\n *  - `draft` writes a new automation to the site's Actions through the\n *    workflows plugin's draft writer, OFF, built only from the triggers and\n *    steps below that this workspace can run. What the description names that\n *    the site does not have is left as a placeholder, never guessed.\n *  - `explain` reads a saved automation — an action or a workflow — and\n *    answers in plain words what it does.\n *  - `diagnose` reads a saved automation and one of its FAILED runs, as the\n *    run history recorded it, and answers why it failed and what to change.\n *  - `revise` reads a saved ACTION and a change asked of it — \"fix it\", or\n *    \"also tag them\" — and writes the action as it would be after the change\n *    as a NEW draft, OFF, through the same draft writer and vocabulary as\n *    `draft`. The saved action is never written: the person compares the two,\n *    switches the new one on and the old one off. An action that holds what\n *    the vocabulary cannot write (an on-page step, a page event, a filter\n *    expression) is refused rather than revised without it.\n *\n * `draft` has a second scope (AGL-3603): `scope: 'org'` drafts one of the\n * WORKSPACE's automations — the ones the workflows plugin's Org automations\n * section places on several sites — with no site named. Its vocabulary is\n * the narrower one that section's zone hands the widget (`triggers` and\n * `steps`, each a comma-separated list, intersected here with the drafting\n * vocabulary below), its records are the workspace's, and nothing is written:\n * the automation rides on an `orgAutomation` output as a proposal that the\n * section's editor opens unsaved, switched off, where the person picks its\n * sites and saves it through that section's own route.\n *\n * Nothing in any mode switches an automation on, runs one, or changes a saved\n * one.\n */\n\nexport const AI_WORKFLOW_JOB_MODES = ['draft', 'explain', 'diagnose', 'revise'] as const\nexport type AiWorkflowJobMode = (typeof AI_WORKFLOW_JOB_MODES)[number]\n\n/** What an explained automation is: an action, or a workflow of function calls. */\nexport const AI_WORKFLOW_TARGET_TYPES = ['action', 'workflow'] as const\nexport type AiWorkflowTargetType = (typeof AI_WORKFLOW_TARGET_TYPES)[number]\n\n/** What an org automation may start on and do, as the zone that asks for one says. */\nexport interface AiOrgAutomationVocabulary {\n  triggers: HostEventType[]\n  steps: AiAutomationStepType[]\n}\n\nexport type AiWorkflowJobInputs =\n  | { mode: 'draft'; scope?: 'site' }\n  | ({ mode: 'draft'; scope: 'org' } & AiOrgAutomationVocabulary)\n  | { mode: 'explain'; targetType: AiWorkflowTargetType; targetId: string }\n  | { mode: 'diagnose'; targetType: AiWorkflowTargetType; targetId: string; runId: string }\n  | { mode: 'revise'; targetType: 'action'; targetId: string }\n\nconst DOCUMENT_ID = /^[A-Za-z0-9_-]{1,128}$/\n\n/** A job's inputs read into its mode, or the sentence that says what is wrong with them. */\nexport function parseAiWorkflowJobInputs(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n): AiWorkflowJobInputs | string {\n  const mode = inputs?.['mode'] ?? 'draft'\n  if (!(AI_WORKFLOW_JOB_MODES as readonly unknown[]).includes(mode)) {\n    return 'inputs.mode must be draft, explain, diagnose or revise'\n  }\n  if (mode === 'draft') {\n    if (inputs?.['scope'] !== 'org') return { mode }\n    const vocabulary = readAiOrgAutomationVocabulary(inputs)\n    return vocabulary ? { mode, scope: 'org', ...vocabulary } : AI_ORG_AUTOMATION_NO_VOCABULARY_COPY\n  }\n  const targetType = inputs?.['targetType']\n  const targetId = inputs?.['targetId']\n  if (\n    !(AI_WORKFLOW_TARGET_TYPES as readonly unknown[]).includes(targetType) ||\n    typeof targetId !== 'string' ||\n    !DOCUMENT_ID.test(targetId)\n  ) {\n    return 'Pick the automation to explain'\n  }\n  const target = { targetType: targetType as AiWorkflowTargetType, targetId }\n  if (mode === 'explain') return { mode, ...target }\n  if (mode === 'revise') {\n    // A workflow is a list of function calls the draft writer does not write.\n    if (targetType !== 'action') return AI_WORKFLOW_REVISE_WORKFLOW_COPY\n    return { mode, targetType, targetId }\n  }\n  const runId = inputs?.['runId']\n  if (typeof runId !== 'string' || !DOCUMENT_ID.test(runId)) return 'Pick the run to explain'\n  return { mode: 'diagnose', ...target, runId }\n}\n\n/** A comma-separated list of names, each kept only when `known` has it, in `known`'s order. */\nfunction knownNames<T extends string>(raw: unknown, known: readonly T[]): T[] {\n  const asked = new Set(\n    (typeof raw === 'string' ? raw : '')\n      .split(',')\n      .map((name) => name.trim())\n      .filter(Boolean),\n  )\n  return known.filter((name) => asked.has(name))\n}\n\n/**\n * An org automation's vocabulary from a job's inputs: the triggers and steps\n * the zone named that the drafting vocabulary also has, or `null` when that\n * leaves no trigger or no step. The zone can only narrow what is drafted;\n * the section's save route holds what is saved to its own rules.\n */\nexport function readAiOrgAutomationVocabulary(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n): AiOrgAutomationVocabulary | null {\n  const triggers = knownNames(inputs?.['triggers'], AI_AUTOMATION_TRIGGERS)\n  const steps = knownNames(inputs?.['steps'], AI_AUTOMATION_STEP_TYPES)\n  return triggers.length && steps.length ? { triggers, steps } : null\n}\n\n/** An org automation's vocabulary as a job's inputs carry it. */\nexport function aiOrgAutomationInputs(vocabulary: {\n  triggers: readonly string[]\n  steps: readonly string[]\n}): Record<string, string> {\n  return {\n    mode: 'draft',\n    scope: 'org',\n    triggers: vocabulary.triggers.join(','),\n    steps: vocabulary.steps.join(','),\n  }\n}\n\n// ── What a workspace can run ──────────────────────────────────────────────\n\n/** A part of the platform some triggers and steps need beyond the actions builder itself. */\nexport type AiAutomationNeed = 'crm' | 'webhooks' | 'bookings'\n\nexport type AiAutomationCapabilities = Readonly<Record<AiAutomationNeed, boolean>>\n\n/** Each need as a sentence names it. */\nexport const AI_AUTOMATION_NEED_LABELS: Readonly<Record<AiAutomationNeed, string>> = {\n  crm: 'the CRM',\n  webhooks: 'webhooks',\n  bookings: 'bookings',\n}\n\n/**\n * What this workspace can run, from the entitlements the executor itself\n * reads before it runs a step: `crm` for the CRM steps, `webhooks` for a\n * webhook post, and `bookings` for the booking trigger's door.\n */\nexport function aiAutomationCapabilities(\n  org: Partial<AglynOrgBilling> | Readonly<Record<string, unknown>> | null | undefined,\n): AiAutomationCapabilities {\n  const billing = org as Partial<AglynOrgBilling> | null | undefined\n  return {\n    crm: checkEntitlement(billing, 'crm'),\n    webhooks: checkEntitlement(billing, 'webhooks'),\n    bookings: checkEntitlement(billing, 'bookings'),\n  }\n}\n\n// ── The vocabulary ────────────────────────────────────────────────────────\n\n/**\n * The triggers a drafted automation may start on: every host event, which is\n * every event a server door emits. The on-page events (a click, a scroll) are\n * left out: they watch one element of one page, which a description cannot\n * name, and they belong to the page's own interactions.\n */\nexport const AI_AUTOMATION_TRIGGERS: readonly HostEventType[] = HOST_EVENT_TYPES\n\n/** The triggers only a door of a part of the platform emits. */\nexport const AI_AUTOMATION_TRIGGER_NEEDS: Readonly<Partial<Record<HostEventType, AiAutomationNeed>>> = {\n  booking: 'bookings',\n  taskCompleted: 'crm',\n  contactStageChanged: 'crm',\n  dealStageChanged: 'crm',\n  dealWon: 'crm',\n  dealLost: 'crm',\n}\n\n/**\n * The steps a drafted automation may take: the server steps and the flow\n * steps, which act on the person an event names. The on-page steps — show an\n * element, open a menu, run a script — are left out for the reason the\n * on-page triggers are: they need a selector on a page a description cannot\n * name.\n */\nexport const AI_AUTOMATION_STEP_TYPES = [\n  'sendEmail',\n  'notifyAdmins',\n  'enrollList',\n  'assignCampaign',\n  'runWorkflow',\n  'datasetAppend',\n  'updateDataset',\n  'webhookPost',\n  'siteAlert',\n  'wait',\n  'waitForEvent',\n  'exitFlow',\n  'setContactStage',\n  'addContactTag',\n  'assignContactOwner',\n  'createCrmTask',\n  'logCrmActivity',\n] as const satisfies readonly AiAutomationFormatStepType[]\n\nexport type AiAutomationStepType = (typeof AI_AUTOMATION_STEP_TYPES)[number]\n\n/** The steps the executor refuses without a part of the platform. */\nexport const AI_AUTOMATION_STEP_NEEDS: Readonly<Partial<Record<AiAutomationStepType, AiAutomationNeed>>> = {\n  webhookPost: 'webhooks',\n  setContactStage: 'crm',\n  addContactTag: 'crm',\n  assignContactOwner: 'crm',\n  createCrmTask: 'crm',\n  logCrmActivity: 'crm',\n}\n\n/** The trigger's name as the Actions editor labels it. */\nexport function aiAutomationTriggerLabel(event: string): string {\n  return HOST_EVENT_LABELS[event as HostEventType] ?? event\n}\n\n// ── A description the vocabulary cannot build ─────────────────────────────\n\n/**\n * Why a description was answered with no automation. Each is a fixed reason\n * with a fixed sentence, so what a person reads is never the model's own\n * account of itself.\n */\nexport const AI_AUTOMATION_UNSUPPORTED = [\n  'not-an-automation',\n  'no-trigger',\n  'no-step',\n  'needs-crm',\n  'needs-webhooks',\n  'needs-bookings',\n] as const\n\nexport type AiAutomationUnsupported = (typeof AI_AUTOMATION_UNSUPPORTED)[number]\n\n/** The need an unsupported reason names, for the reasons that name one. */\nexport const AI_AUTOMATION_UNSUPPORTED_NEED: Readonly<\n  Partial<Record<AiAutomationUnsupported, AiAutomationNeed>>\n> = {\n  'needs-crm': 'crm',\n  'needs-webhooks': 'webhooks',\n  'needs-bookings': 'bookings',\n}\n\nexport const AI_AUTOMATION_UNSUPPORTED_COPY: Readonly<Record<AiAutomationUnsupported, string>> = {\n  'not-an-automation':\n    'This description is not an automation — something that happens, and what to do then — so nothing was drafted.',\n  'no-trigger':\n    'Nothing on the platform can start an automation like this one, so nothing was drafted. Describe it as something that happens on your site, such as a form being submitted.',\n  'no-step': 'An automation cannot do what this description asks yet, so nothing was drafted.',\n  'needs-crm':\n    'This automation needs the CRM, which this workspace’s plan does not include, so nothing was drafted.',\n  'needs-webhooks':\n    'This automation needs webhooks, which this workspace’s plan does not include, so nothing was drafted.',\n  'needs-bookings':\n    'This automation needs bookings, which this workspace’s plan does not include, so nothing was drafted.',\n}\n\n// ── What a job tells a person ─────────────────────────────────────────────\n\n/** The resource the workflows plugin writes a drafted automation under. */\nexport const AI_AUTOMATION_RESOURCE = 'automation'\n\nexport const AI_WORKFLOW_NO_SITE_COPY = 'This automation job names a site this workspace does not have.'\nexport const AI_WORKFLOW_UNAVAILABLE_COPY = 'Automations are not available on this site.'\nexport const AI_WORKFLOW_GONE_COPY = 'That automation no longer exists.'\nexport const AI_WORKFLOW_RUN_GONE_COPY = 'That run is no longer in the automation’s history.'\nexport const AI_WORKFLOW_RUN_NOT_FAILED_COPY = 'That run did not fail, so there is nothing to explain.'\nexport const AI_WORKFLOW_NO_DRAFT_COPY =\n  'The AI could not draft an automation from this description. Try describing what happens, and what should happen then.'\nexport const AI_WORKFLOW_NO_EXPLANATION_COPY =\n  'The AI could not explain this automation. Try again.'\nexport const AI_WORKFLOW_SAVE_FAILURE_COPY =\n  'The automation was drafted but could not be saved. Try the job again.'\nexport const AI_ORG_AUTOMATION_NO_VOCABULARY_COPY =\n  'Open Org automations to draft one: the page says what an org automation can start on and do.'\nexport const AI_ORG_AUTOMATION_UNAVAILABLE_COPY =\n  'Turn on Automation for this workspace before drafting an org automation.'\nexport const AI_ORG_AUTOMATION_PLAN_COPY =\n  'Org automations are built from the actions builder, which this workspace’s plan does not include. Upgrade in Billing to build them.'\n\n/**\n * The output resource an org automation's proposal rides on (AGL-3603): never\n * a document — the Org automations editor opens it unsaved.\n */\nexport const AI_ORG_AUTOMATION_RESOURCE = 'orgAutomation'\n\n/** The automation an `orgAutomation` output proposes, as the editor opens it. */\nexport interface AiOrgAutomationProposal {\n  name: string\n  trigger: {\n    event: string\n    conditions?: Array<{ field: string; op: string; value?: string }>\n    combinator?: 'and' | 'or'\n  }\n  steps: Array<Record<string, unknown> & { type: string }>\n}\n\n/** An output's proposal read back, or `null` for one that is not an org automation. */\nexport function readAiOrgAutomationProposal(value: unknown): AiOrgAutomationProposal | null {\n  const automation = (value as { automation?: unknown } | null | undefined)?.automation as\n    | Record<string, unknown>\n    | null\n    | undefined\n  if (!automation || typeof automation !== 'object') return null\n  const trigger = automation['trigger'] as Record<string, unknown> | null | undefined\n  const steps = automation['steps']\n  if (!trigger || typeof trigger['event'] !== 'string' || !Array.isArray(steps)) return null\n  if (!steps.every((step) => step && typeof step === 'object' && typeof (step as { type?: unknown }).type === 'string')) {\n    return null\n  }\n  return {\n    name: typeof automation['name'] === 'string' ? automation['name'] : '',\n    trigger: {\n      event: trigger['event'],\n      ...(Array.isArray(trigger['conditions'])\n        ? { conditions: trigger['conditions'] as NonNullable<AiOrgAutomationProposal['trigger']['conditions']> }\n        : {}),\n      ...(trigger['combinator'] === 'or' || trigger['combinator'] === 'and'\n        ? { combinator: trigger['combinator'] }\n        : {}),\n    },\n    steps: steps as AiOrgAutomationProposal['steps'],\n  }\n}\n\nexport const AI_WORKFLOW_REVISE_WORKFLOW_COPY =\n  'Only an action can be changed with AI. A workflow can be explained, and edited in its own editor.'\n\n// ── An action AI can revise ───────────────────────────────────────────────\n\n/** Why a saved action cannot be revised, each with the sentence a person reads. */\nexport const AI_WORKFLOW_REVISE_BLOCKERS = ['page-event', 'page-step', 'filter'] as const\nexport type AiWorkflowReviseBlocker = (typeof AI_WORKFLOW_REVISE_BLOCKERS)[number]\n\nexport const AI_WORKFLOW_REVISE_BLOCKER_COPY: Readonly<Record<AiWorkflowReviseBlocker, string>> = {\n  'page-event':\n    'This action starts on something a visitor does on a page, which AI does not write, so it cannot be changed with AI. Edit it here instead.',\n  'page-step':\n    'This action has a step that runs on the page, which AI does not write, so it cannot be changed with AI without losing that step. Edit it here instead.',\n  filter:\n    'This action only runs when an expression is true, which AI does not write, so it cannot be changed with AI without losing it. Edit it here instead.',\n}\n\n/**\n * Why a saved action cannot be revised, or `null` when every part of it is\n * one the drafting vocabulary writes — so the revised draft can hold the\n * whole action and lose nothing the person did not ask to change.\n */\nexport function aiActionReviseBlocker(action: {\n  trigger?: { event?: unknown; filter?: unknown } | null\n  steps?: ReadonlyArray<{ type?: unknown } | null | undefined> | null\n}): AiWorkflowReviseBlocker | null {\n  const event = action.trigger?.event\n  if (!(AI_AUTOMATION_TRIGGERS as readonly unknown[]).includes(event)) return 'page-event'\n  const steps = action.steps ?? []\n  if (steps.some((step) => !(AI_AUTOMATION_STEP_TYPES as readonly unknown[]).includes(step?.type))) {\n    return 'page-step'\n  }\n  const filter = action.trigger?.filter\n  if (typeof filter === 'string' && filter.trim()) return 'filter'\n  return null\n}\n"],"names":["checkEntitlement","HOST_EVENT_LABELS","HOST_EVENT_TYPES","AI_WORKFLOW_JOB_MODES","AI_WORKFLOW_TARGET_TYPES","DOCUMENT_ID","parseAiWorkflowJobInputs","inputs","mode","includes","vocabulary","readAiOrgAutomationVocabulary","scope","AI_ORG_AUTOMATION_NO_VOCABULARY_COPY","targetType","targetId","test","target","AI_WORKFLOW_REVISE_WORKFLOW_COPY","runId","knownNames","raw","known","asked","Set","split","map","name","trim","filter","Boolean","has","triggers","AI_AUTOMATION_TRIGGERS","steps","AI_AUTOMATION_STEP_TYPES","length","aiOrgAutomationInputs","join","AI_AUTOMATION_NEED_LABELS","crm","webhooks","bookings","aiAutomationCapabilities","org","billing","AI_AUTOMATION_TRIGGER_NEEDS","booking","taskCompleted","contactStageChanged","dealStageChanged","dealWon","dealLost","AI_AUTOMATION_STEP_NEEDS","webhookPost","setContactStage","addContactTag","assignContactOwner","createCrmTask","logCrmActivity","aiAutomationTriggerLabel","event","AI_AUTOMATION_UNSUPPORTED","AI_AUTOMATION_UNSUPPORTED_NEED","AI_AUTOMATION_UNSUPPORTED_COPY","AI_AUTOMATION_RESOURCE","AI_WORKFLOW_NO_SITE_COPY","AI_WORKFLOW_UNAVAILABLE_COPY","AI_WORKFLOW_GONE_COPY","AI_WORKFLOW_RUN_GONE_COPY","AI_WORKFLOW_RUN_NOT_FAILED_COPY","AI_WORKFLOW_NO_DRAFT_COPY","AI_WORKFLOW_NO_EXPLANATION_COPY","AI_WORKFLOW_SAVE_FAILURE_COPY","AI_ORG_AUTOMATION_UNAVAILABLE_COPY","AI_ORG_AUTOMATION_PLAN_COPY","AI_ORG_AUTOMATION_RESOURCE","readAiOrgAutomationProposal","value","automation","trigger","Array","isArray","every","step","type","conditions","combinator","AI_WORKFLOW_REVISE_BLOCKERS","AI_WORKFLOW_REVISE_BLOCKER_COPY","aiActionReviseBlocker","action","some"],"mappings":"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"}

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

@@ -0,0 +1,58 @@
+/**
+ * @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.
+ */
+/**
+ * A build proposed from the Assist chat (AGL-3616): one request that names
+ * several things to make on a site — pages, a header and footer, a form, a
+ * booking service — turned into ONE `build` job. The chat proposes; the panel
+ * starts the job, whose plan step plans it against the site's real inventory
+ * and stops with one plan card and one price; nothing is built until the
+ * person confirms that card.
+ *
+ * Shared by the chat door that resolves it and the panel that starts it.
+ * Pure: no request, no React.
+ */
+/** The strict tool the chat model proposes a build through. */
+export declare const ASSIST_BUILD_TOOL_NAME = "propose_build";
+/** The proposal's fixed id, as `assistant_proposal_shown` records it. */
+export declare const ASSIST_BUILD_ACTION_ID = "build";
+/** The longest one-line summary the panel shows above the plan card. */
+export declare const ASSIST_BUILD_SUMMARY_MAX_CHARS = 200;
+export interface AssistBuildProposal {
+    id: typeof ASSIST_BUILD_ACTION_ID;
+    /** The site the request was asked on; the job is created for it. */
+    hostId: string;
+    /** What to build, in the person's words plus what the console page implies. */
+    brief: string;
+    /** Whether the request asked for the new pages to go live; the plan card still asks. */
+    publish: boolean;
+    /** One line saying what will be planned. */
+    summary: string;
+}
+/** Shape-checks a build proposal before it can start a job. */
+export declare function isAssistBuildProposal(value: unknown): value is AssistBuildProposal;
+/**
+ * The body of `POST /api/ai/jobs` a proposal starts: a `build` on its site,
+ * asking to publish only when the request did. The door climbs its own
+ * ladder and takes its own reservation, as every job does.
+ */
+export declare function assistBuildJobRequest(orgId: string, proposal: AssistBuildProposal): {
+    orgId: string;
+    hostId: string;
+    kind: 'build';
+    brief: string;
+    inputs: Record<string, boolean>;
+};

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

@@ -0,0 +1,52 @@
+/**
+ * @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.
+ */ /**
+ * A build proposed from the Assist chat (AGL-3616): one request that names
+ * several things to make on a site — pages, a header and footer, a form, a
+ * booking service — turned into ONE `build` job. The chat proposes; the panel
+ * starts the job, whose plan step plans it against the site's real inventory
+ * and stops with one plan card and one price; nothing is built until the
+ * person confirms that card.
+ *
+ * Shared by the chat door that resolves it and the panel that starts it.
+ * Pure: no request, no React.
+ */ /** The strict tool the chat model proposes a build through. */ export const ASSIST_BUILD_TOOL_NAME = 'propose_build';
+/** The proposal's fixed id, as `assistant_proposal_shown` records it. */ export const ASSIST_BUILD_ACTION_ID = 'build';
+/** The longest one-line summary the panel shows above the plan card. */ export const ASSIST_BUILD_SUMMARY_MAX_CHARS = 200;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Shape-checks a build proposal before it can start a job. */ export function isAssistBuildProposal(value) {
+    if (!isRecord(value) || value['id'] !== ASSIST_BUILD_ACTION_ID) return false;
+    return typeof value['hostId'] === 'string' && /^[A-Za-z0-9_-]{1,100}$/.test(value['hostId']) && typeof value['brief'] === 'string' && value['brief'].trim().length > 0 && typeof value['publish'] === 'boolean' && typeof value['summary'] === 'string';
+}
+/**
+ * The body of `POST /api/ai/jobs` a proposal starts: a `build` on its site,
+ * asking to publish only when the request did. The door climbs its own
+ * ladder and takes its own reservation, as every job does.
+ */ export function assistBuildJobRequest(orgId, proposal) {
+    return {
+        orgId,
+        hostId: proposal.hostId,
+        kind: 'build',
+        brief: proposal.brief,
+        inputs: proposal.publish ? {
+            publish: true
+        } : {}
+    };
+}
+
+//# sourceMappingURL=assist-build.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/assist-build.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * A build proposed from the Assist chat (AGL-3616): one request that names\n * several things to make on a site — pages, a header and footer, a form, a\n * booking service — turned into ONE `build` job. The chat proposes; the panel\n * starts the job, whose plan step plans it against the site's real inventory\n * and stops with one plan card and one price; nothing is built until the\n * person confirms that card.\n *\n * Shared by the chat door that resolves it and the panel that starts it.\n * Pure: no request, no React.\n */\n\n/** The strict tool the chat model proposes a build through. */\nexport const ASSIST_BUILD_TOOL_NAME = 'propose_build'\n\n/** The proposal's fixed id, as `assistant_proposal_shown` records it. */\nexport const ASSIST_BUILD_ACTION_ID = 'build'\n\n/** The longest one-line summary the panel shows above the plan card. */\nexport const ASSIST_BUILD_SUMMARY_MAX_CHARS = 200\n\nexport interface AssistBuildProposal {\n  id: typeof ASSIST_BUILD_ACTION_ID\n  /** The site the request was asked on; the job is created for it. */\n  hostId: string\n  /** What to build, in the person's words plus what the console page implies. */\n  brief: string\n  /** Whether the request asked for the new pages to go live; the plan card still asks. */\n  publish: boolean\n  /** One line saying what will be planned. */\n  summary: string\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\n/** Shape-checks a build proposal before it can start a job. */\nexport function isAssistBuildProposal(value: unknown): value is AssistBuildProposal {\n  if (!isRecord(value) || value['id'] !== ASSIST_BUILD_ACTION_ID) return false\n  return (\n    typeof value['hostId'] === 'string' &&\n    /^[A-Za-z0-9_-]{1,100}$/.test(value['hostId']) &&\n    typeof value['brief'] === 'string' &&\n    value['brief'].trim().length > 0 &&\n    typeof value['publish'] === 'boolean' &&\n    typeof value['summary'] === 'string'\n  )\n}\n\n/**\n * The body of `POST /api/ai/jobs` a proposal starts: a `build` on its site,\n * asking to publish only when the request did. The door climbs its own\n * ladder and takes its own reservation, as every job does.\n */\nexport function assistBuildJobRequest(\n  orgId: string,\n  proposal: AssistBuildProposal,\n): { orgId: string; hostId: string; kind: 'build'; brief: string; inputs: Record<string, boolean> } {\n  return {\n    orgId,\n    hostId: proposal.hostId,\n    kind: 'build',\n    brief: proposal.brief,\n    inputs: proposal.publish ? { publish: true } : {},\n  }\n}\n"],"names":["ASSIST_BUILD_TOOL_NAME","ASSIST_BUILD_ACTION_ID","ASSIST_BUILD_SUMMARY_MAX_CHARS","isRecord","value","Array","isArray","isAssistBuildProposal","test","trim","length","assistBuildJobRequest","orgId","proposal","hostId","kind","brief","inputs","publish"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;CAUC,GAED,6DAA6D,GAC7D,OAAO,MAAMA,yBAAyB,gBAAe;AAErD,uEAAuE,GACvE,OAAO,MAAMC,yBAAyB,QAAO;AAE7C,sEAAsE,GACtE,OAAO,MAAMC,iCAAiC,IAAG;AAcjD,SAASC,SAASC,KAAc;IAC9B,OAAO,OAAOA,UAAU,YAAYA,UAAU,QAAQ,CAACC,MAAMC,OAAO,CAACF;AACvE;AAEA,6DAA6D,GAC7D,OAAO,SAASG,sBAAsBH,KAAc;IAClD,IAAI,CAACD,SAASC,UAAUA,KAAK,CAAC,KAAK,KAAKH,wBAAwB,OAAO;IACvE,OACE,OAAOG,KAAK,CAAC,SAAS,KAAK,YAC3B,yBAAyBI,IAAI,CAACJ,KAAK,CAAC,SAAS,KAC7C,OAAOA,KAAK,CAAC,QAAQ,KAAK,YAC1BA,KAAK,CAAC,QAAQ,CAACK,IAAI,GAAGC,MAAM,GAAG,KAC/B,OAAON,KAAK,CAAC,UAAU,KAAK,aAC5B,OAAOA,KAAK,CAAC,UAAU,KAAK;AAEhC;AAEA;;;;CAIC,GACD,OAAO,SAASO,sBACdC,KAAa,EACbC,QAA6B;IAE7B,OAAO;QACLD;QACAE,QAAQD,SAASC,MAAM;QACvBC,MAAM;QACNC,OAAOH,SAASG,KAAK;QACrBC,QAAQJ,SAASK,OAAO,GAAG;YAAEA,SAAS;QAAK,IAAI,CAAC;IAClD;AACF"}

package/src/lib/model/assist-edit.d.ts

@@ -16,6 +16,7 @@
  */
 import type { ScreenSeoTextField } from '@aglyn/aglyn/app-utils/screen-seo-fields';
 import type { ReusableComponentProp } from '@aglyn/aglyn/foundation/definitions/platform.types';
+import type { NodeInteraction } from '@aglyn/aglyn/app-utils/node-interactions';
 /**
  * Assist level 3, the edit contract (AGL-2906): what the chat door proposes
  * for a besigner canvas, and what the panel applies once the author says so.
@@ -33,8 +34,8 @@ import type { ReusableComponentProp } from '@aglyn/aglyn/foundation/definitions/
  * an unsaved edit on the version the editor has open — a draft — and on a
  * version the live site serves, the editor's own new-version flow runs first.
  */
-/** The eight operations a proposal may carry. */
-export declare const ASSIST_EDIT_OP_KINDS: readonly ["insertSubtree", "updateProps", "updateSx", "move", "remove", "setSeo", "rename", "saveAsComponent"];
+/** The nine operations a proposal may carry. */
+export declare const ASSIST_EDIT_OP_KINDS: readonly ["insertSubtree", "updateProps", "updateSx", "move", "remove", "setSeo", "rename", "saveAsComponent", "addInteraction"];
 export type AssistEditOpKind = (typeof ASSIST_EDIT_OP_KINDS)[number];
 /** The id of the besigner view's edit action — the one edit a view offers. */
 export declare const ASSIST_EDIT_ACTION_ID = "edit.canvas";
@@ -91,7 +92,35 @@ export interface AssistEditCanvasNode {
      * the way the cards of a row are. Its own contents are left out.
      */
     like?: string;
+    /**
+     * The interactions the element carries (AGL-3603), each by its name, the
+     * event it listens for and its steps' kinds — carried for the selected
+     * element only, so Assist can say what it does. Never a selector, a script
+     * or HTML.
+     */
+    interactions?: AssistEditInteractionSummary[];
+}
+/** One interaction on an element, as an outline describes it. */
+export interface AssistEditInteractionSummary {
+    name: string;
+    event: string;
+    steps: string[];
+    enabled: boolean;
 }
+/**
+ * The events an interaction Assist adds may listen for: those that watch the
+ * element it is added to, the way the Besigner's Interactions section offers
+ * them on a selected element.
+ */
+export declare const ASSIST_EDIT_INTERACTION_EVENTS: readonly ["elementClick", "elementHoverEnter", "elementHoverLeave", "elementVisible", "scrollToElement"];
+export type AssistEditInteractionEvent = (typeof ASSIST_EDIT_INTERACTION_EVENTS)[number];
+/**
+ * The steps it may take: the platform's basic presentational client steps,
+ * which run on every plan and touch no data. No script, no HTML, no
+ * attribute, no overlay, no analytics event — and no server step.
+ */
+export declare const ASSIST_EDIT_INTERACTION_STEPS: readonly ["showElement", "hideElement", "toggleElement", "addClass", "removeClass", "toggleClass", "scrollTo", "playVideo", "openDrawer", "closeDrawer", "toggleDrawer", "openMenu", "closeMenu", "toggleMenu", "redirect", "siteAlert"];
+export type AssistEditInteractionStep = (typeof ASSIST_EDIT_INTERACTION_STEPS)[number];
 export interface AssistEditCanvasContext {
     /** The element the author has selected, or null. */
     selectedId: string | null;
@@ -198,7 +227,21 @@ export interface AssistEditSaveAsComponentOp extends AssistEditNodeOpBase {
     props: AssistEditComponentProp[];
     bindings: AssistEditPropBinding[];
 }
-export type AssistEditOp = AssistEditInsertOp | AssistEditUpdatePropsOp | AssistEditUpdateSxOp | AssistEditMoveOp | AssistEditRemoveOp | AssistEditRenameOp | AssistEditSetSeoOp | AssistEditSaveAsComponentOp;
+/**
+ * Add one interaction to an element (AGL-3603), in the shape the element
+ * stores it — its trigger with no selector, which the element's id derives.
+ * It never replaces or removes one the element already carries.
+ */
+export interface AssistEditAddInteractionOp extends AssistEditNodeOpBase {
+    op: 'addInteraction';
+    interaction: NodeInteraction;
+    /** Every other element a step acts on, each with the component it was validated as. */
+    targets: Array<{
+        nodeId: string;
+        componentId: string;
+    }>;
+}
+export type AssistEditOp = AssistEditAddInteractionOp | AssistEditInsertOp | AssistEditUpdatePropsOp | AssistEditUpdateSxOp | AssistEditMoveOp | AssistEditRemoveOp | AssistEditRenameOp | AssistEditSetSeoOp | AssistEditSaveAsComponentOp;
 /** Where a proposal applies, as the server read it off the request. */
 export interface AssistEditTarget extends AssistEditDocument {
     hostId: string;
@@ -219,6 +262,8 @@ export interface AssistEditDiff {
     componentProps: number;
     /** Selections saved as a reusable component — at most one per proposal. */
     componentsSaved: number;
+    /** Interactions added to elements. */
+    interactionsAdded: number;
 }
 /** The most reasons a proposal carries for the changes validation left out. */
 export declare const ASSIST_EDIT_MAX_DROPPED_REASONS = 10;

package/src/lib/model/assist-edit.js

@@ -29,7 +29,7 @@
  * guarded mutators, on confirm, as one undoable step. Every change lands as
  * an unsaved edit on the version the editor has open — a draft — and on a
  * version the live site serves, the editor's own new-version flow runs first.
- */ /** The eight operations a proposal may carry. */ export const ASSIST_EDIT_OP_KINDS = [
+ */ /** The nine operations a proposal may carry. */ export const ASSIST_EDIT_OP_KINDS = [
     'insertSubtree',
     'updateProps',
     'updateSx',
@@ -37,7 +37,8 @@
     'remove',
     'setSeo',
     'rename',
-    'saveAsComponent'
+    'saveAsComponent',
+    'addInteraction'
 ];
 /** The id of the besigner view's edit action — the one edit a view offers. */ export const ASSIST_EDIT_ACTION_ID = 'edit.canvas';
 /** The name of the structured-output tool a model proposes an edit through. */ export const ASSIST_EDIT_TOOL_NAME = 'propose_canvas_edit';
@@ -71,6 +72,41 @@ const BESIGNER_DOCUMENT_ROUTE = /^\/[^/]+\/hosts\/[^/]+\/(screens|components|lay
 /** Props described per element at most. */ export const ASSIST_EDIT_CONTEXT_MAX_PROPS = 16;
 /** Characters of a string prop the selected element carries into a request. */ export const ASSIST_EDIT_SELECTED_TEXT_CHARS = 400;
 /** Characters of a string prop every other element carries. */ export const ASSIST_EDIT_OUTLINE_TEXT_CHARS = 80;
+/* ------------------------------------------------------------------ *
+ * The interactions Assist may add (AGL-3603)
+ * ------------------------------------------------------------------ */ /**
+ * The events an interaction Assist adds may listen for: those that watch the
+ * element it is added to, the way the Besigner's Interactions section offers
+ * them on a selected element.
+ */ export const ASSIST_EDIT_INTERACTION_EVENTS = [
+    'elementClick',
+    'elementHoverEnter',
+    'elementHoverLeave',
+    'elementVisible',
+    'scrollToElement'
+];
+/**
+ * The steps it may take: the platform's basic presentational client steps,
+ * which run on every plan and touch no data. No script, no HTML, no
+ * attribute, no overlay, no analytics event — and no server step.
+ */ export const ASSIST_EDIT_INTERACTION_STEPS = [
+    'showElement',
+    'hideElement',
+    'toggleElement',
+    'addClass',
+    'removeClass',
+    'toggleClass',
+    'scrollTo',
+    'playVideo',
+    'openDrawer',
+    'closeDrawer',
+    'toggleDrawer',
+    'openMenu',
+    'closeMenu',
+    'toggleMenu',
+    'redirect',
+    'siteAlert'
+];
 /** The most reasons a proposal carries for the changes validation left out. */ export const ASSIST_EDIT_MAX_DROPPED_REASONS = 10;
 /** The counts for a list of ops. */ export function summarizeAssistEditOps(ops) {
     const diff = {
@@ -82,7 +118,8 @@ const BESIGNER_DOCUMENT_ROUTE = /^\/[^/]+\/hosts\/[^/]+\/(screens|components|lay
         renamed: 0,
         seoFields: 0,
         componentProps: 0,
-        componentsSaved: 0
+        componentsSaved: 0,
+        interactionsAdded: 0
     };
     for (const op of ops){
         switch(op.op){
@@ -111,6 +148,9 @@ const BESIGNER_DOCUMENT_ROUTE = /^\/[^/]+\/hosts\/[^/]+\/(screens|components|lay
                 diff.componentsSaved += 1;
                 diff.componentProps += op.props.length;
                 break;
+            case 'addInteraction':
+                diff.interactionsAdded += 1;
+                break;
         }
     }
     return diff;
@@ -131,6 +171,9 @@ const plural = (count, one, many)=>`${count} ${count === 1 ? one : many}`;
     if (diff.seoFields) {
         lines.push(`${plural(diff.seoFields, 'search field', 'search fields')} filled in`);
     }
+    if (diff.interactionsAdded) {
+        lines.push(`${plural(diff.interactionsAdded, 'interaction', 'interactions')} added`);
+    }
     if (diff.componentsSaved) {
         lines.push(`saved as a reusable component with ${plural(diff.componentProps, 'property', 'properties')}`);
     }
@@ -144,7 +187,8 @@ const plural = (count, one, many)=>`${count} ${count === 1 ? one : many}`;
     remove: 'remove',
     rename: 'rename',
     setSeo: 'seo',
-    saveAsComponent: 'component'
+    saveAsComponent: 'component',
+    addInteraction: 'interaction'
 };
 /** The applied ops counted by kind, as the activity row names them (`{ set: 3, insert: 1 }`). */ export function assistEditOpCounts(ops) {
     const counts = {};