@aglyn/aglyn 1.0.0-beta.217 → 1.0.0-beta.219

package/src/lib/app-utils/workflows.d.ts

@@ -1,136 +0,0 @@
-/**
- * @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 HostFunction } from './functions';
-import type { HostVariable } from './variables';
-/**
- * Workflows (Workflow Builder, AGL-101): named pipelines of host-function
- * calls. Each step evaluates its argument expressions over host variables
- * and previous step results, runs the function through the safe evaluator,
- * and stores the result under its name for later steps. Pure and bounded —
- * no I/O, no loops. Site-event triggers arrive in v2.
- */
-/**
- * Host events a workflow can trigger on (AGL-128). The tenant emits these
- * server-side: form submit API, analytics collector, membership APIs.
- *
- * SERVER DOORS ONLY. An event exists because a request handler that already
- * performed the write called `emitHostEvent` beside it; nothing watches the
- * database. So a contact created by a console user's client-direct Firestore
- * write fires nothing, and a CRM event (AGL-2605) is only as complete as the
- * set of server paths that emit it — the capture doors for `contactCreated`,
- * the `crm/contact-stage` route for `contactStageChanged`.
- */
-export declare const HOST_EVENT_TYPES: readonly ["formSubmission", "pageView", "memberSignUp", "memberSignIn", "memberSignOut", "lead", "booking", "taskCompleted", "contactCreated", "contactStageChanged", "dealStageChanged", "dealWon", "dealLost"];
-export type HostEventType = (typeof HOST_EVENT_TYPES)[number];
-/**
- * How a built-in event reads in a trigger picker and a run history row.
- *
- * `Partial`, deliberately. The event list grows a line at a time from
- * several hands, and an exhaustive record would make every addition a
- * compile error until its label landed in the same change — which is the
- * right pressure on a stage picker and the wrong one here, where two
- * branches adding events beside each other must merge cleanly. An unlabeled
- * event falls back to its identifier through {@link hostEventLabel}, which
- * is what every picker rendered for every event until AGL-2605.
- */
-export declare const HOST_EVENT_LABELS: Partial<Record<HostEventType, string>>;
-/**
- * `formSubmission` → `Form submitted`; a custom event keeps its own name,
- * because the author chose it and it is already the word they think in.
- */
-export declare function hostEventLabel(event: string | undefined | null): string;
-/**
- * The payload keys each built-in event puts in scope, for the filter
- * expression and the step conditions — the thing an author has to know to
- * write `lifecycleStage == "customer"` and had nowhere to read.
- *
- * Documented from the emitters, not from a schema, because the payload is
- * whatever the emitting door passed: `formSubmission` carries every
- * submitted field under its own name on top of the two fixed keys, which
- * no fixed list can enumerate. `Partial` for the same reason as the labels.
- */
-export declare const HOST_EVENT_PAYLOAD_KEYS: Partial<Record<HostEventType, readonly string[]>>;
-/**
- * One sentence naming what a trigger's filter and conditions can read, or
- * `null` for an event whose payload is not documented — a custom event, or
- * a built-in one nobody has written down yet.
- */
-export declare function hostEventPayloadHint(event: string | undefined | null): string | null;
-export interface HostWorkflowTrigger {
-    event: HostEventType;
-    /**
-     * Optional expression over the event payload (plus variables); the
-     * workflow only runs when it evaluates truthy (e.g. `path == "/pricing"`).
-     */
-    filter?: string;
-}
-export interface HostWorkflowStep {
-    /**
-     * Host function to run — by doc id (AGL-261), rename-safe. Steps saved
-     * before AGL-261 carry only `functionName`; executors resolve id first.
-     */
-    functionId?: string;
-    /** Legacy name reference, kept as the display hint; `functionId` wins. */
-    functionName: string;
-    /**
-     * One expression per function parameter, evaluated over variables and
-     * previous step results (e.g. `price * qty`, `step1 + 10`).
-     */
-    args: string[];
-    /** Scope name the step's result binds to; defaults to `step<N>`. */
-    resultName?: string;
-}
-/** `hosts/{hostId}/workflows/{id}` doc. */
-export interface HostWorkflow {
-    name: string;
-    steps: HostWorkflowStep[];
-    /** Scope name whose final value the workflow returns. */
-    returnValue?: string;
-    /** Event trigger (AGL-128); absent means manual/embedded use only. */
-    trigger?: HostWorkflowTrigger | null;
-}
-export declare const WORKFLOW_MAX_STEPS = 25;
-/** Max nesting across workflow→function→workflow cross-calls (AGL-129). */
-export declare const CROSS_MAX_DEPTH = 3;
-export type WorkflowRunResult = {
-    ok: true;
-    value: number | string | boolean;
-    results: Record<string, number | string | boolean>;
-} | {
-    ok: false;
-    error: string;
-    step?: number;
-};
-export interface WorkflowRunContext {
-    /** All host workflows by name, enabling function→workflow calls. */
-    workflows?: Record<string, HostWorkflow>;
-    /** Cross-call nesting depth; internal — callers omit it. */
-    depth?: number;
-}
-export declare function runWorkflow(workflow: HostWorkflow, functions: Record<string, HostFunction>, variables?: Record<string, HostVariable>, 
-/**
- * Extra scope entries seeded ahead of the steps — event payloads (path,
- * formName, field values) land here (AGL-128). Wins over variables.
- */
-extraScope?: Record<string, number | string | boolean>, context?: WorkflowRunContext): WorkflowRunResult;
-/**
- * Computed variables (AGL-129): a variable with `workflowName` takes the
- * named workflow's result as its value at compose time; failures keep the
- * stored fallback value. Each computed variable evaluates once, bounded
- * by the shared depth guard.
- */
-export declare function resolveComputedVariables(variables: Record<string, HostVariable>, functions: Record<string, HostFunction>, workflows: Record<string, HostWorkflow>): Record<string, HostVariable>;

package/src/lib/app-utils/workflows.js

@@ -1,346 +0,0 @@
-import { _ as _extends } from "@swc/helpers/_/_extends";
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */ import { evaluateExpression, evaluateHostFunction } from "./functions.js";
-/**
- * Workflows (Workflow Builder, AGL-101): named pipelines of host-function
- * calls. Each step evaluates its argument expressions over host variables
- * and previous step results, runs the function through the safe evaluator,
- * and stores the result under its name for later steps. Pure and bounded —
- * no I/O, no loops. Site-event triggers arrive in v2.
- */ /**
- * Host events a workflow can trigger on (AGL-128). The tenant emits these
- * server-side: form submit API, analytics collector, membership APIs.
- *
- * SERVER DOORS ONLY. An event exists because a request handler that already
- * performed the write called `emitHostEvent` beside it; nothing watches the
- * database. So a contact created by a console user's client-direct Firestore
- * write fires nothing, and a CRM event (AGL-2605) is only as complete as the
- * set of server paths that emit it — the capture doors for `contactCreated`,
- * the `crm/contact-stage` route for `contactStageChanged`.
- */ export const HOST_EVENT_TYPES = [
-    'formSubmission',
-    'pageView',
-    'memberSignUp',
-    'memberSignIn',
-    'memberSignOut',
-    'lead',
-    'booking',
-    // A CRM task was marked done (AGL-2599). Emitted by the console's
-    // `crm/task-complete` route rather than by a Firestore trigger, so the
-    // payload names who completed it and what it hung off.
-    'taskCompleted',
-    'contactCreated',
-    'contactStageChanged',
-    'dealStageChanged',
-    'dealWon',
-    'dealLost'
-];
-/**
- * How a built-in event reads in a trigger picker and a run history row.
- *
- * `Partial`, deliberately. The event list grows a line at a time from
- * several hands, and an exhaustive record would make every addition a
- * compile error until its label landed in the same change — which is the
- * right pressure on a stage picker and the wrong one here, where two
- * branches adding events beside each other must merge cleanly. An unlabeled
- * event falls back to its identifier through {@link hostEventLabel}, which
- * is what every picker rendered for every event until AGL-2605.
- */ export const HOST_EVENT_LABELS = {
-    formSubmission: 'Form submitted',
-    pageView: 'Page viewed',
-    memberSignUp: 'Member signed up',
-    memberSignIn: 'Member signed in',
-    memberSignOut: 'Member signed out',
-    lead: 'New lead',
-    booking: 'New booking',
-    contactCreated: 'Contact created',
-    contactStageChanged: 'Contact changed stage',
-    taskCompleted: 'CRM task completed',
-    dealStageChanged: 'Deal moved',
-    dealWon: 'Deal won',
-    dealLost: 'Deal lost'
-};
-/**
- * `formSubmission` → `Form submitted`; a custom event keeps its own name,
- * because the author chose it and it is already the word they think in.
- */ export function hostEventLabel(event) {
-    var _HOST_EVENT_LABELS_key;
-    const key = String(event != null ? event : '').trim();
-    if (!key) return 'Event';
-    return (_HOST_EVENT_LABELS_key = HOST_EVENT_LABELS[key]) != null ? _HOST_EVENT_LABELS_key : key;
-}
-/**
- * The payload keys each built-in event puts in scope, for the filter
- * expression and the step conditions — the thing an author has to know to
- * write `lifecycleStage == "customer"` and had nowhere to read.
- *
- * Documented from the emitters, not from a schema, because the payload is
- * whatever the emitting door passed: `formSubmission` carries every
- * submitted field under its own name on top of the two fixed keys, which
- * no fixed list can enumerate. `Partial` for the same reason as the labels.
- */ export const HOST_EVENT_PAYLOAD_KEYS = {
-    formSubmission: [
-        'formName',
-        'path',
-        'and every submitted field by name'
-    ],
-    pageView: [
-        'path'
-    ],
-    memberSignUp: [
-        'email'
-    ],
-    memberSignIn: [
-        'email'
-    ],
-    lead: [
-        'email',
-        'source',
-        'leadId'
-    ],
-    booking: [
-        'serviceName',
-        'email',
-        'startsAtMs'
-    ],
-    contactCreated: [
-        'contactId',
-        'email',
-        'name',
-        'source',
-        'hostId',
-        'lifecycleStage',
-        'campaignIds',
-        // Present only when the capture came through a form (AGL-2626), so
-        // `formId` equals a form's id is the condition that picks that
-        // form's people out of every other door's.
-        'formId'
-    ],
-    contactStageChanged: [
-        'contactId',
-        'email',
-        'lifecycleStage',
-        'previousStage'
-    ],
-    taskCompleted: [
-        'taskId',
-        'title',
-        'kind',
-        'priority',
-        'dueAtMs',
-        'completedAtMs',
-        'completedByUid',
-        'assigneeUid',
-        'createdByUid',
-        'contactId',
-        'companyId',
-        'dealId',
-        'taskHostId'
-    ],
-    dealStageChanged: [
-        'dealId',
-        'title',
-        'amountCents',
-        'currency',
-        'stageId',
-        'previousStageId',
-        'ownerUid',
-        'contactId',
-        'companyId'
-    ],
-    dealWon: [
-        'dealId',
-        'title',
-        'amountCents',
-        'currency',
-        'stageId',
-        'previousStageId',
-        'ownerUid',
-        'contactId',
-        'companyId'
-    ],
-    dealLost: [
-        'dealId',
-        'title',
-        'amountCents',
-        'currency',
-        'stageId',
-        'previousStageId',
-        'ownerUid',
-        'contactId',
-        'companyId',
-        'lostReason'
-    ]
-};
-/**
- * One sentence naming what a trigger's filter and conditions can read, or
- * `null` for an event whose payload is not documented — a custom event, or
- * a built-in one nobody has written down yet.
- */ export function hostEventPayloadHint(event) {
-    const keys = HOST_EVENT_PAYLOAD_KEYS[String(event != null ? event : '')];
-    if (!(keys == null ? void 0 : keys.length)) return null;
-    return `In scope: ${keys.join(', ')}.`;
-}
-export const WORKFLOW_MAX_STEPS = 25;
-/** Max nesting across workflow→function→workflow cross-calls (AGL-129). */ export const CROSS_MAX_DEPTH = 3;
-/** Variable values as a typed expression scope (mirrors resolveBindings). */ function variableScope(variables) {
-    const scope = {};
-    for (const [key, variable] of Object.entries(variables)){
-        var _variable_value, _variable_value1;
-        const value = variable.type === 'number' ? Number((_variable_value = variable.value) != null ? _variable_value : 0) : variable.type === 'boolean' ? variable.value === 'true' : (_variable_value1 = variable.value) != null ? _variable_value1 : '';
-        scope[key] = value;
-        // Under its NAME as well (AGL-3202). Callers key this map by name, by
-        // id, or by both; an expression only ever says the name, so a map keyed
-        // by id alone used to give it nothing to find.
-        if (variable.name && !Object.prototype.hasOwnProperty.call(scope, variable.name)) {
-            scope[variable.name] = value;
-        }
-    }
-    return scope;
-}
-export function runWorkflow(workflow, functions, variables = {}, /**
-   * Extra scope entries seeded ahead of the steps — event payloads (path,
-   * formName, field values) land here (AGL-128). Wins over variables.
-   */ extraScope = {}, context = {}) {
-    var _workflow_steps, _context_depth, _Object_values_at;
-    var _workflow_returnValue;
-    const steps = (_workflow_steps = workflow.steps) != null ? _workflow_steps : [];
-    if (steps.length > WORKFLOW_MAX_STEPS) {
-        return {
-            ok: false,
-            error: `Workflows are capped at ${WORKFLOW_MAX_STEPS} steps`
-        };
-    }
-    const depth = (_context_depth = context.depth) != null ? _context_depth : 0;
-    if (depth > CROSS_MAX_DEPTH) {
-        return {
-            ok: false,
-            error: 'Workflow nesting is too deep'
-        };
-    }
-    // Function steps may call other workflows (AGL-129); every hop shares
-    // this depth guard so mutual recursion terminates.
-    const invokeWorkflow = (name, callScope)=>{
-        var _context_workflows;
-        const nested = (_context_workflows = context.workflows) == null ? void 0 : _context_workflows[name == null ? void 0 : name.trim()];
-        if (!nested) throw new Error(`Unknown workflow "${name}"`);
-        const run = runWorkflow(nested, functions, variables, callScope, _extends({}, context, {
-            depth: depth + 1
-        }));
-        if (run.ok === false) throw new Error(run.error);
-        return run.value;
-    };
-    // The site's variables, apart from the step results layered over them:
-    // they are what a function may read by name (AGL-3202), wherever it runs.
-    const siteVariables = variableScope(variables);
-    const scope = _extends({}, siteVariables, extraScope);
-    const results = {};
-    for (const [index, step] of steps.entries()){
-        var _functions_, _ref, _ref1;
-        var _step_functionId, _step_functionName, _step_resultName;
-        // Id-first resolution (AGL-261): maps are double-keyed by id and name.
-        const definition = (_functions_ = functions[(_ref = (_step_functionId = step.functionId) == null ? void 0 : _step_functionId.trim()) != null ? _ref : '']) != null ? _functions_ : functions[(_ref1 = (_step_functionName = step.functionName) == null ? void 0 : _step_functionName.trim()) != null ? _ref1 : ''];
-        if (!definition) {
-            return {
-                ok: false,
-                error: `Unknown function "${step.functionName || step.functionId}"`,
-                step: index + 1
-            };
-        }
-        const args = {};
-        try {
-            var _definition_parameters;
-            (_definition_parameters = definition.parameters) == null ? void 0 : _definition_parameters.forEach((parameter, parameterIndex)=>{
-                var _step_args;
-                const expression = (_step_args = step.args) == null ? void 0 : _step_args[parameterIndex];
-                if (expression != null && String(expression).trim() !== '') {
-                    args[parameter.name] = evaluateExpression(String(expression), scope);
-                }
-            });
-        } catch (error) {
-            return {
-                ok: false,
-                error: `Step ${index + 1}: ${error.message}`,
-                step: index + 1
-            };
-        }
-        const run = evaluateHostFunction(definition, args, _extends({}, context.workflows ? {
-            invokeWorkflow
-        } : {}, {
-            // A function that prices from `extra_site_price` on a page must not
-            // fail with "Unknown name" the day a workflow calls it.
-            globals: siteVariables
-        }));
-        // `=== false` (not `!run.ok`): the union fails to narrow under the
-        // stricter lib build tsconfig otherwise (same quirk as publish.ts).
-        if (run.ok === false) {
-            return {
-                ok: false,
-                error: `Step ${index + 1} (${definition.name}): ${run.error}`,
-                step: index + 1
-            };
-        }
-        const resultName = ((_step_resultName = step.resultName) == null ? void 0 : _step_resultName.trim()) || `step${index + 1}`;
-        scope[resultName] = run.value;
-        results[resultName] = run.value;
-    }
-    const returnName = (_workflow_returnValue = workflow.returnValue) == null ? void 0 : _workflow_returnValue.trim();
-    const value = returnName && returnName in scope ? scope[returnName] : (_Object_values_at = Object.values(results).at(-1)) != null ? _Object_values_at : '';
-    return {
-        ok: true,
-        value,
-        results
-    };
-}
-/**
- * Computed variables (AGL-129): a variable with `workflowName` takes the
- * named workflow's result as its value at compose time; failures keep the
- * stored fallback value. Each computed variable evaluates once, bounded
- * by the shared depth guard.
- */ export function resolveComputedVariables(variables, functions, workflows) {
-    const resolved = {};
-    // Lookup maps are double-keyed by id and name (AGL-185), so the same doc
-    // can appear under two keys — evaluate each workflow once per doc.
-    const memo = new Map();
-    for (const [name, variable] of Object.entries(variables)){
-        var _ref, _ref1;
-        var _variable_workflowId_trim, _variable_workflowId, _variable_workflowName;
-        const workflowId = (_ref = (_variable_workflowId = variable.workflowId) == null ? void 0 : (_variable_workflowId_trim = _variable_workflowId.trim) == null ? void 0 : _variable_workflowId_trim.call(_variable_workflowId)) != null ? _ref : '';
-        const workflowName = (_variable_workflowName = variable.workflowName) == null ? void 0 : _variable_workflowName.trim();
-        const workflow = (_ref1 = workflowId ? workflows[workflowId] : undefined) != null ? _ref1 : workflowName ? workflows[workflowName] : undefined;
-        if (!workflow) {
-            resolved[name] = variable;
-            continue;
-        }
-        const cached = memo.get(variable);
-        if (cached) {
-            resolved[name] = cached;
-            continue;
-        }
-        const run = runWorkflow(workflow, functions, variables, {}, {
-            workflows
-        });
-        const next = run.ok === false ? variable : _extends({}, variable, {
-            value: String(run.value)
-        });
-        memo.set(variable, next);
-        resolved[name] = next;
-    }
-    return resolved;
-}
-
-//# sourceMappingURL=workflows.js.map

package/src/lib/app-utils/workflows.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/workflows.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  evaluateExpression,\n  evaluateHostFunction,\n  type HostFunction,\n} from './functions'\nimport type { HostVariable } from './variables'\n\n/**\n * Workflows (Workflow Builder, AGL-101): named pipelines of host-function\n * calls. Each step evaluates its argument expressions over host variables\n * and previous step results, runs the function through the safe evaluator,\n * and stores the result under its name for later steps. Pure and bounded —\n * no I/O, no loops. Site-event triggers arrive in v2.\n */\n\n/**\n * Host events a workflow can trigger on (AGL-128). The tenant emits these\n * server-side: form submit API, analytics collector, membership APIs.\n *\n * SERVER DOORS ONLY. An event exists because a request handler that already\n * performed the write called `emitHostEvent` beside it; nothing watches the\n * database. So a contact created by a console user's client-direct Firestore\n * write fires nothing, and a CRM event (AGL-2605) is only as complete as the\n * set of server paths that emit it — the capture doors for `contactCreated`,\n * the `crm/contact-stage` route for `contactStageChanged`.\n */\nexport const HOST_EVENT_TYPES = [\n  'formSubmission',\n  'pageView',\n  'memberSignUp',\n  'memberSignIn',\n  'memberSignOut',\n  'lead',\n  'booking',\n  // A CRM task was marked done (AGL-2599). Emitted by the console's\n  // `crm/task-complete` route rather than by a Firestore trigger, so the\n  // payload names who completed it and what it hung off.\n  'taskCompleted',\n  'contactCreated',\n  'contactStageChanged',\n  'dealStageChanged',\n  'dealWon',\n  'dealLost',\n] as const\n\nexport type HostEventType = (typeof HOST_EVENT_TYPES)[number]\n\n/**\n * How a built-in event reads in a trigger picker and a run history row.\n *\n * `Partial`, deliberately. The event list grows a line at a time from\n * several hands, and an exhaustive record would make every addition a\n * compile error until its label landed in the same change — which is the\n * right pressure on a stage picker and the wrong one here, where two\n * branches adding events beside each other must merge cleanly. An unlabeled\n * event falls back to its identifier through {@link hostEventLabel}, which\n * is what every picker rendered for every event until AGL-2605.\n */\nexport const HOST_EVENT_LABELS: Partial<Record<HostEventType, string>> = {\n  formSubmission: 'Form submitted',\n  pageView: 'Page viewed',\n  memberSignUp: 'Member signed up',\n  memberSignIn: 'Member signed in',\n  memberSignOut: 'Member signed out',\n  lead: 'New lead',\n  booking: 'New booking',\n  contactCreated: 'Contact created',\n  contactStageChanged: 'Contact changed stage',\n  taskCompleted: 'CRM task completed',\n  dealStageChanged: 'Deal moved',\n  dealWon: 'Deal won',\n  dealLost: 'Deal lost',\n}\n\n/**\n * `formSubmission` → `Form submitted`; a custom event keeps its own name,\n * because the author chose it and it is already the word they think in.\n */\nexport function hostEventLabel(event: string | undefined | null): string {\n  const key = String(event ?? '').trim()\n  if (!key) return 'Event'\n  return HOST_EVENT_LABELS[key as HostEventType] ?? key\n}\n\n/**\n * The payload keys each built-in event puts in scope, for the filter\n * expression and the step conditions — the thing an author has to know to\n * write `lifecycleStage == \"customer\"` and had nowhere to read.\n *\n * Documented from the emitters, not from a schema, because the payload is\n * whatever the emitting door passed: `formSubmission` carries every\n * submitted field under its own name on top of the two fixed keys, which\n * no fixed list can enumerate. `Partial` for the same reason as the labels.\n */\nexport const HOST_EVENT_PAYLOAD_KEYS: Partial<\n  Record<HostEventType, readonly string[]>\n> = {\n  formSubmission: ['formName', 'path', 'and every submitted field by name'],\n  pageView: ['path'],\n  memberSignUp: ['email'],\n  memberSignIn: ['email'],\n  lead: ['email', 'source', 'leadId'],\n  booking: ['serviceName', 'email', 'startsAtMs'],\n  contactCreated: [\n    'contactId',\n    'email',\n    'name',\n    'source',\n    'hostId',\n    'lifecycleStage',\n    'campaignIds',\n    // Present only when the capture came through a form (AGL-2626), so\n    // `formId` equals a form's id is the condition that picks that\n    // form's people out of every other door's.\n    'formId',\n  ],\n  contactStageChanged: ['contactId', 'email', 'lifecycleStage', 'previousStage'],\n  taskCompleted: [\n    'taskId',\n    'title',\n    'kind',\n    'priority',\n    'dueAtMs',\n    'completedAtMs',\n    'completedByUid',\n    'assigneeUid',\n    'createdByUid',\n    'contactId',\n    'companyId',\n    'dealId',\n    'taskHostId',\n  ],\n  dealStageChanged: [\n    'dealId',\n    'title',\n    'amountCents',\n    'currency',\n    'stageId',\n    'previousStageId',\n    'ownerUid',\n    'contactId',\n    'companyId',\n  ],\n  dealWon: [\n    'dealId',\n    'title',\n    'amountCents',\n    'currency',\n    'stageId',\n    'previousStageId',\n    'ownerUid',\n    'contactId',\n    'companyId',\n  ],\n  dealLost: [\n    'dealId',\n    'title',\n    'amountCents',\n    'currency',\n    'stageId',\n    'previousStageId',\n    'ownerUid',\n    'contactId',\n    'companyId',\n    'lostReason',\n  ],\n}\n\n/**\n * One sentence naming what a trigger's filter and conditions can read, or\n * `null` for an event whose payload is not documented — a custom event, or\n * a built-in one nobody has written down yet.\n */\nexport function hostEventPayloadHint(\n  event: string | undefined | null,\n): string | null {\n  const keys = HOST_EVENT_PAYLOAD_KEYS[String(event ?? '') as HostEventType]\n  if (!keys?.length) return null\n  return `In scope: ${keys.join(', ')}.`\n}\n\nexport interface HostWorkflowTrigger {\n  event: HostEventType\n  /**\n   * Optional expression over the event payload (plus variables); the\n   * workflow only runs when it evaluates truthy (e.g. `path == \"/pricing\"`).\n   */\n  filter?: string\n}\n\nexport interface HostWorkflowStep {\n  /**\n   * Host function to run — by doc id (AGL-261), rename-safe. Steps saved\n   * before AGL-261 carry only `functionName`; executors resolve id first.\n   */\n  functionId?: string\n  /** Legacy name reference, kept as the display hint; `functionId` wins. */\n  functionName: string\n  /**\n   * One expression per function parameter, evaluated over variables and\n   * previous step results (e.g. `price * qty`, `step1 + 10`).\n   */\n  args: string[]\n  /** Scope name the step's result binds to; defaults to `step<N>`. */\n  resultName?: string\n}\n\n/** `hosts/{hostId}/workflows/{id}` doc. */\nexport interface HostWorkflow {\n  name: string\n  steps: HostWorkflowStep[]\n  /** Scope name whose final value the workflow returns. */\n  returnValue?: string\n  /** Event trigger (AGL-128); absent means manual/embedded use only. */\n  trigger?: HostWorkflowTrigger | null\n}\n\nexport const WORKFLOW_MAX_STEPS = 25\n/** Max nesting across workflow→function→workflow cross-calls (AGL-129). */\nexport const CROSS_MAX_DEPTH = 3\n\nexport type WorkflowRunResult =\n  | {\n      ok: true\n      value: number | string | boolean\n      results: Record<string, number | string | boolean>\n    }\n  | { ok: false; error: string; step?: number }\n\n/** Variable values as a typed expression scope (mirrors resolveBindings). */\nfunction variableScope(\n  variables: Record<string, HostVariable>,\n): Record<string, number | string | boolean> {\n  const scope: Record<string, number | string | boolean> = {}\n  for (const [key, variable] of Object.entries(variables)) {\n    const value =\n      variable.type === 'number'\n        ? Number(variable.value ?? 0)\n        : variable.type === 'boolean'\n          ? variable.value === 'true'\n          : (variable.value ?? '')\n    scope[key] = value\n    // Under its NAME as well (AGL-3202). Callers key this map by name, by\n    // id, or by both; an expression only ever says the name, so a map keyed\n    // by id alone used to give it nothing to find.\n    if (\n      variable.name &&\n      !Object.prototype.hasOwnProperty.call(scope, variable.name)\n    ) {\n      scope[variable.name] = value\n    }\n  }\n  return scope\n}\n\nexport interface WorkflowRunContext {\n  /** All host workflows by name, enabling function→workflow calls. */\n  workflows?: Record<string, HostWorkflow>\n  /** Cross-call nesting depth; internal — callers omit it. */\n  depth?: number\n}\n\nexport function runWorkflow(\n  workflow: HostWorkflow,\n  functions: Record<string, HostFunction>,\n  variables: Record<string, HostVariable> = {},\n  /**\n   * Extra scope entries seeded ahead of the steps — event payloads (path,\n   * formName, field values) land here (AGL-128). Wins over variables.\n   */\n  extraScope: Record<string, number | string | boolean> = {},\n  context: WorkflowRunContext = {},\n): WorkflowRunResult {\n  const steps = workflow.steps ?? []\n  if (steps.length > WORKFLOW_MAX_STEPS) {\n    return { ok: false, error: `Workflows are capped at ${WORKFLOW_MAX_STEPS} steps` }\n  }\n  const depth = context.depth ?? 0\n  if (depth > CROSS_MAX_DEPTH) {\n    return { ok: false, error: 'Workflow nesting is too deep' }\n  }\n  // Function steps may call other workflows (AGL-129); every hop shares\n  // this depth guard so mutual recursion terminates.\n  const invokeWorkflow = (\n    name: string,\n    callScope: Record<string, number | string | boolean>,\n  ): number | string | boolean => {\n    const nested = context.workflows?.[name?.trim()]\n    if (!nested) throw new Error(`Unknown workflow \"${name}\"`)\n    const run = runWorkflow(nested, functions, variables, callScope, {\n      ...context,\n      depth: depth + 1,\n    })\n    if (run.ok === false) throw new Error(run.error)\n    return run.value\n  }\n  // The site's variables, apart from the step results layered over them:\n  // they are what a function may read by name (AGL-3202), wherever it runs.\n  const siteVariables = variableScope(variables)\n  const scope = { ...siteVariables, ...extraScope }\n  const results: Record<string, number | string | boolean> = {}\n\n  for (const [index, step] of steps.entries()) {\n    // Id-first resolution (AGL-261): maps are double-keyed by id and name.\n    const definition =\n      functions[step.functionId?.trim() ?? ''] ??\n      functions[step.functionName?.trim() ?? '']\n    if (!definition) {\n      return {\n        ok: false,\n        error: `Unknown function \"${step.functionName || step.functionId}\"`,\n        step: index + 1,\n      }\n    }\n    const args: Record<string, unknown> = {}\n    try {\n      definition.parameters?.forEach((parameter, parameterIndex) => {\n        const expression = step.args?.[parameterIndex]\n        if (expression != null && String(expression).trim() !== '') {\n          args[parameter.name] = evaluateExpression(String(expression), scope)\n        }\n      })\n    } catch (error) {\n      return {\n        ok: false,\n        error: `Step ${index + 1}: ${(error as Error).message}`,\n        step: index + 1,\n      }\n    }\n    const run = evaluateHostFunction(definition, args, {\n      ...(context.workflows ? { invokeWorkflow } : {}),\n      // A function that prices from `extra_site_price` on a page must not\n      // fail with \"Unknown name\" the day a workflow calls it.\n      globals: siteVariables,\n    })\n    // `=== false` (not `!run.ok`): the union fails to narrow under the\n    // stricter lib build tsconfig otherwise (same quirk as publish.ts).\n    if (run.ok === false) {\n      return {\n        ok: false,\n        error: `Step ${index + 1} (${definition.name}): ${run.error}`,\n        step: index + 1,\n      }\n    }\n    const resultName = step.resultName?.trim() || `step${index + 1}`\n    scope[resultName] = run.value\n    results[resultName] = run.value\n  }\n\n  const returnName = workflow.returnValue?.trim()\n  const value =\n    returnName && returnName in scope\n      ? scope[returnName]\n      : (Object.values(results).at(-1) ?? '')\n  return { ok: true, value, results }\n}\n\n/**\n * Computed variables (AGL-129): a variable with `workflowName` takes the\n * named workflow's result as its value at compose time; failures keep the\n * stored fallback value. Each computed variable evaluates once, bounded\n * by the shared depth guard.\n */\nexport function resolveComputedVariables(\n  variables: Record<string, HostVariable>,\n  functions: Record<string, HostFunction>,\n  workflows: Record<string, HostWorkflow>,\n): Record<string, HostVariable> {\n  const resolved: Record<string, HostVariable> = {}\n  // Lookup maps are double-keyed by id and name (AGL-185), so the same doc\n  // can appear under two keys — evaluate each workflow once per doc.\n  const memo = new Map<HostVariable, HostVariable>()\n  for (const [name, variable] of Object.entries(variables)) {\n    const workflowId = (variable as any).workflowId?.trim?.() ?? ''\n    const workflowName = variable.workflowName?.trim()\n    const workflow =\n      (workflowId ? workflows[workflowId] : undefined) ??\n      (workflowName ? workflows[workflowName] : undefined)\n    if (!workflow) {\n      resolved[name] = variable\n      continue\n    }\n    const cached = memo.get(variable)\n    if (cached) {\n      resolved[name] = cached\n      continue\n    }\n    const run = runWorkflow(workflow, functions, variables, {}, { workflows })\n    const next =\n      run.ok === false\n        ? variable\n        : { ...variable, value: String(run.value) }\n    memo.set(variable, next)\n    resolved[name] = next\n  }\n  return resolved\n}\n"],"names":["evaluateExpression","evaluateHostFunction","HOST_EVENT_TYPES","HOST_EVENT_LABELS","formSubmission","pageView","memberSignUp","memberSignIn","memberSignOut","lead","booking","contactCreated","contactStageChanged","taskCompleted","dealStageChanged","dealWon","dealLost","hostEventLabel","event","key","String","trim","HOST_EVENT_PAYLOAD_KEYS","hostEventPayloadHint","keys","length","join","WORKFLOW_MAX_STEPS","CROSS_MAX_DEPTH","variableScope","variables","scope","variable","Object","entries","value","type","Number","name","prototype","hasOwnProperty","call","runWorkflow","workflow","functions","extraScope","context","steps","ok","error","depth","invokeWorkflow","callScope","nested","workflows","Error","run","siteVariables","results","index","step","definition","functionId","functionName","args","parameters","forEach","parameter","parameterIndex","expression","message","globals","resultName","returnName","returnValue","values","at","resolveComputedVariables","resolved","memo","Map","workflowId","workflowName","undefined","cached","get","next","set"],"mappings":"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"}