@aglyn/plugins-workflows 1.0.0-beta.218 → 1.0.0-beta.220

package/src/lib/model/workflows.js

@@ -0,0 +1,167 @@
+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 "@aglyn/aglyn/app-utils/functions";
+export const WORKFLOW_MAX_STEPS = 25;
+/** Max nesting across workflow→function→workflow cross-calls (AGL-129). */ export const CROSS_MAX_DEPTH = 3;
+/** How deep one custom event may chain into another automation's run. */ export const ACTION_MAX_EVENT_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 naming a workflow takes that
+ * workflow's result as its value at compose time — by id first, then by
+ * name; 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;
+        const source = variable;
+        const workflowId = typeof source.workflowId === 'string' ? source.workflowId.trim() : '';
+        const workflowName = typeof source.workflowName === 'string' ? source.workflowName.trim() : '';
+        const workflow = (_ref = workflowId ? workflows[workflowId] : undefined) != null ? _ref : 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/model/workflows.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/workflows/src/lib/model/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 '@aglyn/aglyn/app-utils/functions'\nimport type { HostEventType } from '@aglyn/aglyn/app-utils/host-events'\nimport type { HostVariable } from '@aglyn/aglyn/app-utils/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\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\n/** How deep one custom event may chain into another automation's run. */\nexport const ACTION_MAX_EVENT_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 * The reference a computed site variable carries to the workflow that\n * computes it: the workflow's document id (AGL-261), and the name it had when\n * it was picked, which a variable computed before ids existed carries alone.\n * Written by the variables editor; read here.\n */\nexport interface WorkflowComputedVariable extends HostVariable {\n  workflowId?: string\n  workflowName?: string\n}\n\n/**\n * Computed variables (AGL-129): a variable naming a workflow takes that\n * workflow's result as its value at compose time — by id first, then by\n * name; failures keep the stored fallback value. Each computed variable\n * evaluates once, bounded 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 source = variable as WorkflowComputedVariable\n    const workflowId =\n      typeof source.workflowId === 'string' ? source.workflowId.trim() : ''\n    const workflowName =\n      typeof source.workflowName === 'string' ? source.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","WORKFLOW_MAX_STEPS","CROSS_MAX_DEPTH","ACTION_MAX_EVENT_DEPTH","variableScope","variables","scope","key","variable","Object","entries","value","type","Number","name","prototype","hasOwnProperty","call","runWorkflow","workflow","functions","extraScope","context","steps","length","ok","error","depth","invokeWorkflow","callScope","nested","workflows","trim","Error","run","siteVariables","results","index","step","definition","functionId","functionName","args","parameters","forEach","parameter","parameterIndex","expression","String","message","globals","resultName","returnName","returnValue","values","at","resolveComputedVariables","resolved","memo","Map","workflowId","source","workflowName","undefined","cached","get","next","set"],"mappings":"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"}

package/src/lib/plan-entitlements.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @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 { OrgPlan } from '@aglyn/aglyn/foundation/definitions/org-billing.types';
+import type { PluginPlanEntitlementsDeclaration } from '@aglyn/aglyn/plugin-manager/plugin-plan-entitlements';
+/**
+ * THE WORKFLOWS PLUGIN'S PLAN BAND (AGL-3080): the workflow runs each plan
+ * includes a month. Compiled into core's `PLAN_ENTITLEMENTS` by the manifest
+ * generator (`register.planEntitlements`).
+ */
+declare module '@aglyn/aglyn/plugin-manager/plugin-entitlement-keys' {
+    interface PluginEntitlementQuotas {
+        /** Event-triggered workflow runs per calendar month (AGL-165). */
+        workflowRunsPerMonth?: number;
+    }
+}
+/**
+ * The workflow runs each plan includes a month. Priced into the cost model at
+ * `perRun` beside the action-run band, since 2026-09-07.
+ */
+export declare const WORKFLOW_RUNS_PER_MONTH_BY_PLAN: Readonly<Record<OrgPlan, number>>;
+/** The workflows plugin's plan figures, for the manifest generator. */
+export declare function workflowsPlanEntitlements(): PluginPlanEntitlementsDeclaration;

package/src/lib/plan-entitlements.js

@@ -0,0 +1,44 @@
+/**
+ * @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.
+ */ // Types only: the manifest generator loads this module on its own to compile
+// the plan figures, so nothing here may reach a core module at runtime.
+/**
+ * The workflow runs each plan includes a month. Priced into the cost model at
+ * `perRun` beside the action-run band, since 2026-09-07.
+ */ export const WORKFLOW_RUNS_PER_MONTH_BY_PLAN = {
+    free: 0,
+    starter: 500,
+    pro: 5000,
+    business: 50000,
+    scale: 150000,
+    advanced: 500000,
+    agency: 2000000,
+    // Agency's band × 2, the rule every Enterprise fallback follows.
+    enterprise: 4000000
+};
+/** The workflows plugin's plan figures, for the manifest generator. */ export function workflowsPlanEntitlements() {
+    return {
+        quotas: [
+            {
+                key: 'workflowRunsPerMonth',
+                label: 'Workflow runs / mo',
+                byPlan: WORKFLOW_RUNS_PER_MONTH_BY_PLAN
+            }
+        ]
+    };
+}
+
+//# sourceMappingURL=plan-entitlements.js.map

package/src/lib/plan-entitlements.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/plugins/workflows/src/lib/plan-entitlements.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// Types only: the manifest generator loads this module on its own to compile\n// the plan figures, so nothing here may reach a core module at runtime.\nimport type { OrgPlan } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport type { PluginPlanEntitlementsDeclaration } from '@aglyn/aglyn/plugin-manager/plugin-plan-entitlements'\n\n/**\n * THE WORKFLOWS PLUGIN'S PLAN BAND (AGL-3080): the workflow runs each plan\n * includes a month. Compiled into core's `PLAN_ENTITLEMENTS` by the manifest\n * generator (`register.planEntitlements`).\n */\ndeclare module '@aglyn/aglyn/plugin-manager/plugin-entitlement-keys' {\n  interface PluginEntitlementQuotas {\n    /** Event-triggered workflow runs per calendar month (AGL-165). */\n    workflowRunsPerMonth?: number\n  }\n}\n\n/**\n * The workflow runs each plan includes a month. Priced into the cost model at\n * `perRun` beside the action-run band, since 2026-09-07.\n */\nexport const WORKFLOW_RUNS_PER_MONTH_BY_PLAN: Readonly<Record<OrgPlan, number>> = {\n  free: 0,\n  starter: 500,\n  pro: 5000,\n  business: 50000,\n  scale: 150000,\n  advanced: 500000,\n  agency: 2000000,\n  // Agency's band × 2, the rule every Enterprise fallback follows.\n  enterprise: 4_000_000,\n}\n\n/** The workflows plugin's plan figures, for the manifest generator. */\nexport function workflowsPlanEntitlements(): PluginPlanEntitlementsDeclaration {\n  return {\n    quotas: [\n      {\n        key: 'workflowRunsPerMonth',\n        label: 'Workflow runs / mo',\n        byPlan: WORKFLOW_RUNS_PER_MONTH_BY_PLAN,\n      },\n    ],\n  }\n}\n"],"names":["WORKFLOW_RUNS_PER_MONTH_BY_PLAN","free","starter","pro","business","scale","advanced","agency","enterprise","workflowsPlanEntitlements","quotas","key","label","byPlan"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,6EAA6E;AAC7E,wEAAwE;AAgBxE;;;CAGC,GACD,OAAO,MAAMA,kCAAqE;IAChFC,MAAM;IACNC,SAAS;IACTC,KAAK;IACLC,UAAU;IACVC,OAAO;IACPC,UAAU;IACVC,QAAQ;IACR,iEAAiE;IACjEC,YAAY;AACd,EAAC;AAED,qEAAqE,GACrE,OAAO,SAASC;IACd,OAAO;QACLC,QAAQ;YACN;gBACEC,KAAK;gBACLC,OAAO;gBACPC,QAAQb;YACV;SACD;IACH;AACF"}

package/src/lib/plugin.js

@@ -20,8 +20,11 @@ import { HostActivityCard } from "./components/host-activity-card.component.js";
 import { StaffOrgAutomationsCard, StaffSiteAutomationsCard } from "./components/staff-automations-card.component.js";
 import { WORKFLOWS_CONSOLE_SECTIONS, WORKFLOWS_ORG_CONSOLE_SECTIONS } from "./components/workflows-console-sections.js";
 import { registerPluginZone } from "@aglyn/aglyn/plugin-manager/plugin-zones";
-import { WORKFLOW_USAGE_ZONE } from "./components/workflow-zones.js";
+import { AUTOMATION_EDITOR_ZONE, AUTOMATION_RUN_ZONE, HOST_AUTOMATIONS_ZONE, WORKFLOW_USAGE_ZONE } from "./components/workflow-zones.js";
 import { BUNDLE_ID } from "./constants/bundle-common.js";
+import { registerWorkflowsRecordLists } from "./model/workflows-record-lists.js";
+import { registerWorkflowsRecordRoutes } from "./model/workflows-record-routes.js";
+import { WORKFLOWS_SEARCH_SOURCES } from "./model/workflows-search-sources.js";
 /** Code-split: the Automation console page only loads when opened. */ const WorkflowsConsolePage = lazy(()=>import("./components/workflows-console-page.js"));
 /**
  * Workflows feature plugin (AGL-395). Console-only — workflows, actions,
@@ -37,6 +40,8 @@ import { BUNDLE_ID } from "./constants/bundle-common.js";
  * Remote Config release flag — and a section's name is not a reason to orphan
  * them. Only what a reader sees carries the new name.
  */ export function registerWorkflowsConsole() {
+    registerWorkflowsRecordRoutes();
+    registerWorkflowsRecordLists();
     registerPluginZone({
         zone: WORKFLOW_USAGE_ZONE,
         label: 'Where a workflow is used',
@@ -46,6 +51,35 @@ import { BUNDLE_ID } from "./constants/bundle-common.js";
     {
         pluginId: BUNDLE_ID
     });
+    // The zones the Automation page draws in its own layouts (AGL-2919): one
+    // item in the Actions row, inside an open editor, on a failed run's row.
+    registerPluginZone({
+        zone: HOST_AUTOMATIONS_ZONE,
+        label: 'Automation page actions',
+        surface: 'console',
+        layout: 'bare',
+        description: 'On the Automation page, beside Add action and Recipes: another way to start an automation. `openAction` opens a listed action in the Actions editor; a widget here writes nothing through the page.'
+    }, {
+        pluginId: BUNDLE_ID
+    });
+    registerPluginZone({
+        zone: AUTOMATION_EDITOR_ZONE,
+        label: 'An automation’s editor',
+        surface: 'console',
+        layout: 'bare',
+        description: 'Inside the editor of one saved automation, an action or a workflow. A widget here reads the automation as it is stored and changes nothing in the editor.'
+    }, {
+        pluginId: BUNDLE_ID
+    });
+    registerPluginZone({
+        zone: AUTOMATION_RUN_ZONE,
+        label: 'A failed automation run',
+        surface: 'console',
+        layout: 'bare',
+        description: 'On each failed run in an automation’s run history. A widget here reads the run as it was recorded and changes nothing.'
+    }, {
+        pluginId: BUNDLE_ID
+    });
     Aglyn.registerConsoleExtension({
         // Host activity feed (AGL-419): rendered by the shell's
         // 'hostActivity' widget slot (dashboard + editor view page).
@@ -74,13 +108,14 @@ import { BUNDLE_ID } from "./constants/bundle-common.js";
         pluginId: BUNDLE_ID,
         displayName: 'Automation',
         featureFlag: 'workflows',
+        searchSources: WORKFLOWS_SEARCH_SOURCES,
         navItems: [
             {
                 label: 'Automation',
                 // Workflows, Actions and Webhooks are the tabs INSIDE this section, so
                 // the section is named for what they have in common. `/workflows` —
                 // the address before the section had its own name — is redirected here
-                // by the console (see `Route.HOST_WORKFLOWS`).
+                // by this plugin's `consoleRedirects`.
                 href: '/automation',
                 // Sections as ROUTES (AGL-2501): each is a real URL the shell
                 // resolves and gates, so the page mounts the one being read.

package/src/lib/plugin.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/workflows/src/lib/plugin.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 * as Aglyn from '@aglyn/aglyn'\nimport { mdiSitemap } from '@aglyn/shared-data-mdi'\nimport { lazy } from 'react'\nimport { HostActivityCard } from './components/host-activity-card.component'\nimport {\n  StaffOrgAutomationsCard,\n  StaffSiteAutomationsCard,\n} from './components/staff-automations-card.component'\nimport {\n  WORKFLOWS_CONSOLE_SECTIONS,\n  WORKFLOWS_ORG_CONSOLE_SECTIONS,\n} from './components/workflows-console-sections'\nimport { registerPluginZone } from '@aglyn/aglyn/plugin-manager/plugin-zones'\nimport { WORKFLOW_USAGE_ZONE } from './components/workflow-zones'\nimport { BUNDLE_ID } from './constants/bundle-common'\n\n/** Code-split: the Automation console page only loads when opened. */\nconst WorkflowsConsolePage = lazy(\n  () => import('./components/workflows-console-page'),\n)\n\n/**\n * Workflows feature plugin (AGL-395). Console-only — workflows, actions,\n * and webhooks run server-side (event pipelines, `/api/hooks`), not through\n * a canvas element, so there is no UI bundle. The console half declares the\n * Automation nav + page through the ConsoleExtension registry, gated by the\n * `workflows` entitlement (the Actions/Webhooks tabs run their own per-plan\n * checks off the passed `org`). Where a workflow is used is asked of the\n * platform's scan and drawn in a zone this plugin hosts.\n *\n * `pluginId`, `featureFlag` and `navTabId` all still read `workflows`: they\n * are stored — an org's enabled-plugin ids, the plan's entitlement flags, the\n * Remote Config release flag — and a section's name is not a reason to orphan\n * them. Only what a reader sees carries the new name.\n */\nexport function registerWorkflowsConsole(): void {\n  registerPluginZone(\n    {\n      zone: WORKFLOW_USAGE_ZONE,\n      label: 'Where a workflow is used',\n      surface: 'console',\n      description:\n        'On the Automation page, after a reader asks where a workflow is used. A widget here lays out the scan the page already ran; it is handed the site, the answer and a way to close, and it writes nothing.',\n    },\n    // Named, because a spec calls this registrar without the loader.\n    { pluginId: BUNDLE_ID },\n  )\n  Aglyn.registerConsoleExtension({\n    // Host activity feed (AGL-419): rendered by the shell's\n    // 'hostActivity' widget slot (dashboard + editor view page).\n    widgets: [\n      {\n        slot: 'hostActivity',\n        widgetId: 'workflows-host-activity',\n        title: 'Recent Activity',\n        Component: HostActivityCard,\n      },\n      // The staff site and organization pages' automations (AGL-3379), read\n      // only: staff see what runs on a site without joining it.\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.staffSite,\n        widgetId: 'workflows-staff-site-automations',\n        title: 'Automations',\n        Component: StaffSiteAutomationsCard,\n      },\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.adminOrgDetail,\n        widgetId: 'workflows-staff-org-automations',\n        title: 'Organization automations',\n        Component: StaffOrgAutomationsCard,\n      },\n    ],\n    pluginId: BUNDLE_ID,\n    displayName: 'Automation',\n    featureFlag: 'workflows',\n    navItems: [\n      {\n        label: 'Automation',\n        // Workflows, Actions and Webhooks are the tabs INSIDE this section, so\n        // the section is named for what they have in common. `/workflows` —\n        // the address before the section had its own name — is redirected here\n        // by the console (see `Route.HOST_WORKFLOWS`).\n        href: '/automation',\n        // Sections as ROUTES (AGL-2501): each is a real URL the shell\n        // resolves and gates, so the page mounts the one being read.\n        sections: WORKFLOWS_CONSOLE_SECTIONS,\n        // Reuse the existing release-flag nav-tab so staff-preview gating is\n        // unchanged now that the tab comes from the plugin (AGL-395).\n        navTabId: 'nav-tab-workflows',\n        icon: { path: mdiSitemap.path },\n        header: {\n          title: 'Automation',\n          icon: { path: mdiSitemap.path },\n          docsTopic: 'workflows',\n        },\n        Component: WorkflowsConsolePage,\n      },\n    ],\n    /*\n     * The ORGANIZATION's Automation hub (AGL-3302), at `/[orgSlug]/automation`:\n     * the org automations placed across the organization's sites, and every\n     * site's own workflows, actions and webhooks side by side. The same page\n     * component, mounted with no site; the site tab's release flag gates both\n     * levels, so one flag rolls the surface out at once.\n     */\n    orgNavItems: [\n      {\n        label: 'Automation',\n        href: '/automation',\n        sections: WORKFLOWS_ORG_CONSOLE_SECTIONS,\n        navTabId: 'nav-tab-workflows',\n        icon: { path: mdiSitemap.path },\n        header: {\n          title: 'Automation',\n          icon: { path: mdiSitemap.path },\n          docsTopic: 'workflows',\n        },\n        Component: WorkflowsConsolePage,\n      },\n    ],\n  })\n}\n\n// Activity feed consumed directly by the app (dashboard + screen view).\nexport { default as HostActivityCard } from './components/host-activity-card.component'\nexport type { HostActivityCardProps } from './components/host-activity-card.component'\n"],"names":["Aglyn","mdiSitemap","lazy","HostActivityCard","StaffOrgAutomationsCard","StaffSiteAutomationsCard","WORKFLOWS_CONSOLE_SECTIONS","WORKFLOWS_ORG_CONSOLE_SECTIONS","registerPluginZone","WORKFLOW_USAGE_ZONE","BUNDLE_ID","WorkflowsConsolePage","registerWorkflowsConsole","zone","label","surface","description","pluginId","registerConsoleExtension","widgets","slot","widgetId","title","Component","CONSOLE_WIDGET_SLOTS","staffSite","adminOrgDetail","displayName","featureFlag","navItems","href","sections","navTabId","icon","path","header","docsTopic","orgNavItems","default"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,YAAYA,WAAW,eAAc;AACrC,SAASC,UAAU,QAAQ,yBAAwB;AACnD,SAASC,IAAI,QAAQ,QAAO;AAC5B,SAASC,gBAAgB,QAAQ,+CAA2C;AAC5E,SACEC,uBAAuB,EACvBC,wBAAwB,QACnB,mDAA+C;AACtD,SACEC,0BAA0B,EAC1BC,8BAA8B,QACzB,6CAAyC;AAChD,SAASC,kBAAkB,QAAQ,2CAA0C;AAC7E,SAASC,mBAAmB,QAAQ,iCAA6B;AACjE,SAASC,SAAS,QAAQ,+BAA2B;AAErD,oEAAoE,GACpE,MAAMC,uBAAuBT,KAC3B,IAAM,MAAM,CAAC;AAGf;;;;;;;;;;;;;CAaC,GACD,OAAO,SAASU;IACdJ,mBACE;QACEK,MAAMJ;QACNK,OAAO;QACPC,SAAS;QACTC,aACE;IACJ,GACA,iEAAiE;IACjE;QAAEC,UAAUP;IAAU;IAExBV,MAAMkB,wBAAwB,CAAC;QAC7B,wDAAwD;QACxD,6DAA6D;QAC7DC,SAAS;YACP;gBACEC,MAAM;gBACNC,UAAU;gBACVC,OAAO;gBACPC,WAAWpB;YACb;YACA,sEAAsE;YACtE,0DAA0D;YAC1D;gBACEiB,MAAMpB,MAAMwB,oBAAoB,CAACC,SAAS;gBAC1CJ,UAAU;gBACVC,OAAO;gBACPC,WAAWlB;YACb;YACA;gBACEe,MAAMpB,MAAMwB,oBAAoB,CAACE,cAAc;gBAC/CL,UAAU;gBACVC,OAAO;gBACPC,WAAWnB;YACb;SACD;QACDa,UAAUP;QACViB,aAAa;QACbC,aAAa;QACbC,UAAU;YACR;gBACEf,OAAO;gBACP,uEAAuE;gBACvE,oEAAoE;gBACpE,uEAAuE;gBACvE,+CAA+C;gBAC/CgB,MAAM;gBACN,8DAA8D;gBAC9D,6DAA6D;gBAC7DC,UAAUzB;gBACV,qEAAqE;gBACrE,8DAA8D;gBAC9D0B,UAAU;gBACVC,MAAM;oBAAEC,MAAMjC,WAAWiC,IAAI;gBAAC;gBAC9BC,QAAQ;oBACNb,OAAO;oBACPW,MAAM;wBAAEC,MAAMjC,WAAWiC,IAAI;oBAAC;oBAC9BE,WAAW;gBACb;gBACAb,WAAWZ;YACb;SACD;QACD;;;;;;KAMC,GACD0B,aAAa;YACX;gBACEvB,OAAO;gBACPgB,MAAM;gBACNC,UAAUxB;gBACVyB,UAAU;gBACVC,MAAM;oBAAEC,MAAMjC,WAAWiC,IAAI;gBAAC;gBAC9BC,QAAQ;oBACNb,OAAO;oBACPW,MAAM;wBAAEC,MAAMjC,WAAWiC,IAAI;oBAAC;oBAC9BE,WAAW;gBACb;gBACAb,WAAWZ;YACb;SACD;IACH;AACF;AAEA,wEAAwE;AACxE,SAAS2B,WAAWnC,gBAAgB,QAAQ,+CAA2C"}
+{"version":3,"sources":["../../../../../../libs/plugins/workflows/src/lib/plugin.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 * as Aglyn from '@aglyn/aglyn'\nimport { mdiSitemap } from '@aglyn/shared-data-mdi'\nimport { lazy } from 'react'\nimport { HostActivityCard } from './components/host-activity-card.component'\nimport {\n  StaffOrgAutomationsCard,\n  StaffSiteAutomationsCard,\n} from './components/staff-automations-card.component'\nimport {\n  WORKFLOWS_CONSOLE_SECTIONS,\n  WORKFLOWS_ORG_CONSOLE_SECTIONS,\n} from './components/workflows-console-sections'\nimport { registerPluginZone } from '@aglyn/aglyn/plugin-manager/plugin-zones'\nimport {\n  AUTOMATION_EDITOR_ZONE,\n  AUTOMATION_RUN_ZONE,\n  HOST_AUTOMATIONS_ZONE,\n  WORKFLOW_USAGE_ZONE,\n} from './components/workflow-zones'\nimport { BUNDLE_ID } from './constants/bundle-common'\nimport { registerWorkflowsRecordLists } from './model/workflows-record-lists'\nimport { registerWorkflowsRecordRoutes } from './model/workflows-record-routes'\nimport { WORKFLOWS_SEARCH_SOURCES } from './model/workflows-search-sources'\n\n/** Code-split: the Automation console page only loads when opened. */\nconst WorkflowsConsolePage = lazy(\n  () => import('./components/workflows-console-page'),\n)\n\n/**\n * Workflows feature plugin (AGL-395). Console-only — workflows, actions,\n * and webhooks run server-side (event pipelines, `/api/hooks`), not through\n * a canvas element, so there is no UI bundle. The console half declares the\n * Automation nav + page through the ConsoleExtension registry, gated by the\n * `workflows` entitlement (the Actions/Webhooks tabs run their own per-plan\n * checks off the passed `org`). Where a workflow is used is asked of the\n * platform's scan and drawn in a zone this plugin hosts.\n *\n * `pluginId`, `featureFlag` and `navTabId` all still read `workflows`: they\n * are stored — an org's enabled-plugin ids, the plan's entitlement flags, the\n * Remote Config release flag — and a section's name is not a reason to orphan\n * them. Only what a reader sees carries the new name.\n */\nexport function registerWorkflowsConsole(): void {\n  registerWorkflowsRecordRoutes()\n  registerWorkflowsRecordLists()\n  registerPluginZone(\n    {\n      zone: WORKFLOW_USAGE_ZONE,\n      label: 'Where a workflow is used',\n      surface: 'console',\n      description:\n        'On the Automation page, after a reader asks where a workflow is used. A widget here lays out the scan the page already ran; it is handed the site, the answer and a way to close, and it writes nothing.',\n    },\n    // Named, because a spec calls this registrar without the loader.\n    { pluginId: BUNDLE_ID },\n  )\n  // The zones the Automation page draws in its own layouts (AGL-2919): one\n  // item in the Actions row, inside an open editor, on a failed run's row.\n  registerPluginZone(\n    {\n      zone: HOST_AUTOMATIONS_ZONE,\n      label: 'Automation page actions',\n      surface: 'console',\n      layout: 'bare',\n      description:\n        'On the Automation page, beside Add action and Recipes: another way to start an automation. `openAction` opens a listed action in the Actions editor; a widget here writes nothing through the page.',\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  registerPluginZone(\n    {\n      zone: AUTOMATION_EDITOR_ZONE,\n      label: 'An automation’s editor',\n      surface: 'console',\n      layout: 'bare',\n      description:\n        'Inside the editor of one saved automation, an action or a workflow. A widget here reads the automation as it is stored and changes nothing in the editor.',\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  registerPluginZone(\n    {\n      zone: AUTOMATION_RUN_ZONE,\n      label: 'A failed automation run',\n      surface: 'console',\n      layout: 'bare',\n      description:\n        'On each failed run in an automation’s run history. A widget here reads the run as it was recorded and changes nothing.',\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  Aglyn.registerConsoleExtension({\n    // Host activity feed (AGL-419): rendered by the shell's\n    // 'hostActivity' widget slot (dashboard + editor view page).\n    widgets: [\n      {\n        slot: 'hostActivity',\n        widgetId: 'workflows-host-activity',\n        title: 'Recent Activity',\n        Component: HostActivityCard,\n      },\n      // The staff site and organization pages' automations (AGL-3379), read\n      // only: staff see what runs on a site without joining it.\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.staffSite,\n        widgetId: 'workflows-staff-site-automations',\n        title: 'Automations',\n        Component: StaffSiteAutomationsCard,\n      },\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.adminOrgDetail,\n        widgetId: 'workflows-staff-org-automations',\n        title: 'Organization automations',\n        Component: StaffOrgAutomationsCard,\n      },\n    ],\n    pluginId: BUNDLE_ID,\n    displayName: 'Automation',\n    featureFlag: 'workflows',\n    searchSources: WORKFLOWS_SEARCH_SOURCES,\n    navItems: [\n      {\n        label: 'Automation',\n        // Workflows, Actions and Webhooks are the tabs INSIDE this section, so\n        // the section is named for what they have in common. `/workflows` —\n        // the address before the section had its own name — is redirected here\n        // by this plugin's `consoleRedirects`.\n        href: '/automation',\n        // Sections as ROUTES (AGL-2501): each is a real URL the shell\n        // resolves and gates, so the page mounts the one being read.\n        sections: WORKFLOWS_CONSOLE_SECTIONS,\n        // Reuse the existing release-flag nav-tab so staff-preview gating is\n        // unchanged now that the tab comes from the plugin (AGL-395).\n        navTabId: 'nav-tab-workflows',\n        icon: { path: mdiSitemap.path },\n        header: {\n          title: 'Automation',\n          icon: { path: mdiSitemap.path },\n          docsTopic: 'workflows',\n        },\n        Component: WorkflowsConsolePage,\n      },\n    ],\n    /*\n     * The ORGANIZATION's Automation hub (AGL-3302), at `/[orgSlug]/automation`:\n     * the org automations placed across the organization's sites, and every\n     * site's own workflows, actions and webhooks side by side. The same page\n     * component, mounted with no site; the site tab's release flag gates both\n     * levels, so one flag rolls the surface out at once.\n     */\n    orgNavItems: [\n      {\n        label: 'Automation',\n        href: '/automation',\n        sections: WORKFLOWS_ORG_CONSOLE_SECTIONS,\n        navTabId: 'nav-tab-workflows',\n        icon: { path: mdiSitemap.path },\n        header: {\n          title: 'Automation',\n          icon: { path: mdiSitemap.path },\n          docsTopic: 'workflows',\n        },\n        Component: WorkflowsConsolePage,\n      },\n    ],\n  })\n}\n\n// Activity feed consumed directly by the app (dashboard + screen view).\nexport { default as HostActivityCard } from './components/host-activity-card.component'\nexport type { HostActivityCardProps } from './components/host-activity-card.component'\n"],"names":["Aglyn","mdiSitemap","lazy","HostActivityCard","StaffOrgAutomationsCard","StaffSiteAutomationsCard","WORKFLOWS_CONSOLE_SECTIONS","WORKFLOWS_ORG_CONSOLE_SECTIONS","registerPluginZone","AUTOMATION_EDITOR_ZONE","AUTOMATION_RUN_ZONE","HOST_AUTOMATIONS_ZONE","WORKFLOW_USAGE_ZONE","BUNDLE_ID","registerWorkflowsRecordLists","registerWorkflowsRecordRoutes","WORKFLOWS_SEARCH_SOURCES","WorkflowsConsolePage","registerWorkflowsConsole","zone","label","surface","description","pluginId","layout","registerConsoleExtension","widgets","slot","widgetId","title","Component","CONSOLE_WIDGET_SLOTS","staffSite","adminOrgDetail","displayName","featureFlag","searchSources","navItems","href","sections","navTabId","icon","path","header","docsTopic","orgNavItems","default"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,YAAYA,WAAW,eAAc;AACrC,SAASC,UAAU,QAAQ,yBAAwB;AACnD,SAASC,IAAI,QAAQ,QAAO;AAC5B,SAASC,gBAAgB,QAAQ,+CAA2C;AAC5E,SACEC,uBAAuB,EACvBC,wBAAwB,QACnB,mDAA+C;AACtD,SACEC,0BAA0B,EAC1BC,8BAA8B,QACzB,6CAAyC;AAChD,SAASC,kBAAkB,QAAQ,2CAA0C;AAC7E,SACEC,sBAAsB,EACtBC,mBAAmB,EACnBC,qBAAqB,EACrBC,mBAAmB,QACd,iCAA6B;AACpC,SAASC,SAAS,QAAQ,+BAA2B;AACrD,SAASC,4BAA4B,QAAQ,oCAAgC;AAC7E,SAASC,6BAA6B,QAAQ,qCAAiC;AAC/E,SAASC,wBAAwB,QAAQ,sCAAkC;AAE3E,oEAAoE,GACpE,MAAMC,uBAAuBf,KAC3B,IAAM,MAAM,CAAC;AAGf;;;;;;;;;;;;;CAaC,GACD,OAAO,SAASgB;IACdH;IACAD;IACAN,mBACE;QACEW,MAAMP;QACNQ,OAAO;QACPC,SAAS;QACTC,aACE;IACJ,GACA,iEAAiE;IACjE;QAAEC,UAAUV;IAAU;IAExB,yEAAyE;IACzE,yEAAyE;IACzEL,mBACE;QACEW,MAAMR;QACNS,OAAO;QACPC,SAAS;QACTG,QAAQ;QACRF,aACE;IACJ,GACA;QAAEC,UAAUV;IAAU;IAExBL,mBACE;QACEW,MAAMV;QACNW,OAAO;QACPC,SAAS;QACTG,QAAQ;QACRF,aACE;IACJ,GACA;QAAEC,UAAUV;IAAU;IAExBL,mBACE;QACEW,MAAMT;QACNU,OAAO;QACPC,SAAS;QACTG,QAAQ;QACRF,aACE;IACJ,GACA;QAAEC,UAAUV;IAAU;IAExBb,MAAMyB,wBAAwB,CAAC;QAC7B,wDAAwD;QACxD,6DAA6D;QAC7DC,SAAS;YACP;gBACEC,MAAM;gBACNC,UAAU;gBACVC,OAAO;gBACPC,WAAW3B;YACb;YACA,sEAAsE;YACtE,0DAA0D;YAC1D;gBACEwB,MAAM3B,MAAM+B,oBAAoB,CAACC,SAAS;gBAC1CJ,UAAU;gBACVC,OAAO;gBACPC,WAAWzB;YACb;YACA;gBACEsB,MAAM3B,MAAM+B,oBAAoB,CAACE,cAAc;gBAC/CL,UAAU;gBACVC,OAAO;gBACPC,WAAW1B;YACb;SACD;QACDmB,UAAUV;QACVqB,aAAa;QACbC,aAAa;QACbC,eAAepB;QACfqB,UAAU;YACR;gBACEjB,OAAO;gBACP,uEAAuE;gBACvE,oEAAoE;gBACpE,uEAAuE;gBACvE,uCAAuC;gBACvCkB,MAAM;gBACN,8DAA8D;gBAC9D,6DAA6D;gBAC7DC,UAAUjC;gBACV,qEAAqE;gBACrE,8DAA8D;gBAC9DkC,UAAU;gBACVC,MAAM;oBAAEC,MAAMzC,WAAWyC,IAAI;gBAAC;gBAC9BC,QAAQ;oBACNd,OAAO;oBACPY,MAAM;wBAAEC,MAAMzC,WAAWyC,IAAI;oBAAC;oBAC9BE,WAAW;gBACb;gBACAd,WAAWb;YACb;SACD;QACD;;;;;;KAMC,GACD4B,aAAa;YACX;gBACEzB,OAAO;gBACPkB,MAAM;gBACNC,UAAUhC;gBACViC,UAAU;gBACVC,MAAM;oBAAEC,MAAMzC,WAAWyC,IAAI;gBAAC;gBAC9BC,QAAQ;oBACNd,OAAO;oBACPY,MAAM;wBAAEC,MAAMzC,WAAWyC,IAAI;oBAAC;oBAC9BE,WAAW;gBACb;gBACAd,WAAWb;YACb;SACD;IACH;AACF;AAEA,wEAAwE;AACxE,SAAS6B,WAAW3C,gBAAgB,QAAQ,+CAA2C"}

package/src/lib/server/automation-record-index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @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 { PluginRecordIndex } from '@aglyn/aglyn/plugin-manager/plugin-record-index';
+export declare const workflowRecordIndex: PluginRecordIndex;
+export declare const webhookRecordIndex: PluginRecordIndex;
+export declare const actionRecordIndex: PluginRecordIndex;

package/src/lib/server/automation-record-index.js

@@ -0,0 +1,59 @@
+/**
+ * @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 { firebaseAdmin } from "@aglyn/tenant-data-admin/server/firebase-admin";
+import { AUTOMATION_COLLECTIONS, automationIndexedRecord } from "../model/automation-record.js";
+/**
+ * The workflows plugin's record indexes (AGL-3080): a site's workflows,
+ * webhooks and actions, as another surface reads them — an AI job drafting an
+ * automation that names a workflow, the "Used by" scan asking which workflows
+ * call a function — without knowing where they are stored or what a deleted
+ * one looks like.
+ *
+ * All three are a SITE's (`hostId` required; an org-only scope answers
+ * nothing). Each record is `automationIndexedRecord`'s
+ * (`model/automation-record.ts`), which leaves out a deleted record and
+ * documents the facts each kind shares.
+ */ function hostCollection(hostId, kind) {
+    return firebaseAdmin.app().firestore().collection('hosts').doc(hostId).collection(AUTOMATION_COLLECTIONS[kind]);
+}
+function indexOf(kind) {
+    return {
+        async list ({ hostId, limit }) {
+            if (!hostId || limit <= 0) return {
+                records: [],
+                truncated: false
+            };
+            // One more than asked, so `truncated` is a fact rather than a guess;
+            // deleted and unnamed records are filtered after the read.
+            const snapshot = await hostCollection(hostId, kind).limit(limit + 1).get();
+            const records = snapshot.docs.map((doc)=>automationIndexedRecord(kind, doc.id, doc.data())).filter((record)=>record !== null);
+            return {
+                records: records.slice(0, limit),
+                truncated: snapshot.size > limit
+            };
+        },
+        async get ({ hostId, id }) {
+            if (!hostId || !id) return null;
+            const snapshot = await hostCollection(hostId, kind).doc(id).get();
+            return snapshot.exists ? automationIndexedRecord(kind, snapshot.id, snapshot.data()) : null;
+        }
+    };
+}
+export const workflowRecordIndex = indexOf('workflow');
+export const webhookRecordIndex = indexOf('webhook');
+export const actionRecordIndex = indexOf('action');
+
+//# sourceMappingURL=automation-record-index.js.map

package/src/lib/server/automation-record-index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/workflows/src/lib/server/automation-record-index.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 type {\n  PluginIndexedRecord,\n  PluginRecordIndex,\n} from '@aglyn/aglyn/plugin-manager/plugin-record-index'\nimport { firebaseAdmin } from '@aglyn/tenant-data-admin/server/firebase-admin'\nimport {\n  AUTOMATION_COLLECTIONS,\n  automationIndexedRecord,\n  type AutomationRecordKind,\n} from '../model/automation-record'\n\n/**\n * The workflows plugin's record indexes (AGL-3080): a site's workflows,\n * webhooks and actions, as another surface reads them — an AI job drafting an\n * automation that names a workflow, the \"Used by\" scan asking which workflows\n * call a function — without knowing where they are stored or what a deleted\n * one looks like.\n *\n * All three are a SITE's (`hostId` required; an org-only scope answers\n * nothing). Each record is `automationIndexedRecord`'s\n * (`model/automation-record.ts`), which leaves out a deleted record and\n * documents the facts each kind shares.\n */\n\nfunction hostCollection(hostId: string, kind: AutomationRecordKind) {\n  return firebaseAdmin\n    .app()\n    .firestore()\n    .collection('hosts')\n    .doc(hostId)\n    .collection(AUTOMATION_COLLECTIONS[kind])\n}\n\nfunction indexOf(kind: AutomationRecordKind): PluginRecordIndex {\n  return {\n    async list({ hostId, limit }) {\n      if (!hostId || limit <= 0) return { records: [], truncated: false }\n      // One more than asked, so `truncated` is a fact rather than a guess;\n      // deleted and unnamed records are filtered after the read.\n      const snapshot = await hostCollection(hostId, kind).limit(limit + 1).get()\n      const records = snapshot.docs\n        .map((doc) => automationIndexedRecord(kind, doc.id, doc.data()))\n        .filter((record): record is PluginIndexedRecord => record !== null)\n      return { records: records.slice(0, limit), truncated: snapshot.size > limit }\n    },\n    async get({ hostId, id }) {\n      if (!hostId || !id) return null\n      const snapshot = await hostCollection(hostId, kind).doc(id).get()\n      return snapshot.exists ? automationIndexedRecord(kind, snapshot.id, snapshot.data()) : null\n    },\n  }\n}\n\nexport const workflowRecordIndex = indexOf('workflow')\nexport const webhookRecordIndex = indexOf('webhook')\nexport const actionRecordIndex = indexOf('action')\n"],"names":["firebaseAdmin","AUTOMATION_COLLECTIONS","automationIndexedRecord","hostCollection","hostId","kind","app","firestore","collection","doc","indexOf","list","limit","records","truncated","snapshot","get","docs","map","id","data","filter","record","slice","size","exists","workflowRecordIndex","webhookRecordIndex","actionRecordIndex"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAMD,SAASA,aAAa,QAAQ,iDAAgD;AAC9E,SACEC,sBAAsB,EACtBC,uBAAuB,QAElB,gCAA4B;AAEnC;;;;;;;;;;;CAWC,GAED,SAASC,eAAeC,MAAc,EAAEC,IAA0B;IAChE,OAAOL,cACJM,GAAG,GACHC,SAAS,GACTC,UAAU,CAAC,SACXC,GAAG,CAACL,QACJI,UAAU,CAACP,sBAAsB,CAACI,KAAK;AAC5C;AAEA,SAASK,QAAQL,IAA0B;IACzC,OAAO;QACL,MAAMM,MAAK,EAAEP,MAAM,EAAEQ,KAAK,EAAE;YAC1B,IAAI,CAACR,UAAUQ,SAAS,GAAG,OAAO;gBAAEC,SAAS,EAAE;gBAAEC,WAAW;YAAM;YAClE,qEAAqE;YACrE,2DAA2D;YAC3D,MAAMC,WAAW,MAAMZ,eAAeC,QAAQC,MAAMO,KAAK,CAACA,QAAQ,GAAGI,GAAG;YACxE,MAAMH,UAAUE,SAASE,IAAI,CAC1BC,GAAG,CAAC,CAACT,MAAQP,wBAAwBG,MAAMI,IAAIU,EAAE,EAAEV,IAAIW,IAAI,KAC3DC,MAAM,CAAC,CAACC,SAA0CA,WAAW;YAChE,OAAO;gBAAET,SAASA,QAAQU,KAAK,CAAC,GAAGX;gBAAQE,WAAWC,SAASS,IAAI,GAAGZ;YAAM;QAC9E;QACA,MAAMI,KAAI,EAAEZ,MAAM,EAAEe,EAAE,EAAE;YACtB,IAAI,CAACf,UAAU,CAACe,IAAI,OAAO;YAC3B,MAAMJ,WAAW,MAAMZ,eAAeC,QAAQC,MAAMI,GAAG,CAACU,IAAIH,GAAG;YAC/D,OAAOD,SAASU,MAAM,GAAGvB,wBAAwBG,MAAMU,SAASI,EAAE,EAAEJ,SAASK,IAAI,MAAM;QACzF;IACF;AACF;AAEA,OAAO,MAAMM,sBAAsBhB,QAAQ,YAAW;AACtD,OAAO,MAAMiB,qBAAqBjB,QAAQ,WAAU;AACpD,OAAO,MAAMkB,oBAAoBlB,QAAQ,UAAS"}

package/src/lib/server/workflow-dependents.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @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 { PluginDependentsAnswer, PluginDependentsRequest } from '@aglyn/aglyn/plugin-manager/plugin-dependents';
+/**
+ * Which of a site's workflows call a function, for the "Used by" scan.
+ *
+ * A workflow step calls a site function by its document id, with the name it
+ * had when the step was written beside it as a display hint (AGL-261); a step
+ * written before ids existed carries the name alone. Either reference is a
+ * dependent: the id survives a rename of the function, the name does not.
+ */
+/** How many of a site's workflows one scan reads. */
+export declare const FUNCTION_DEPENDENTS_WORKFLOWS_READ = 100;
+export declare function findFunctionDependents(request: PluginDependentsRequest): Promise<PluginDependentsAnswer>;

package/src/lib/server/workflow-dependents.js

@@ -0,0 +1,61 @@
+/**
+ * @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 { workflowRecordIndex } from "./automation-record-index.js";
+/**
+ * Which of a site's workflows call a function, for the "Used by" scan.
+ *
+ * A workflow step calls a site function by its document id, with the name it
+ * had when the step was written beside it as a display hint (AGL-261); a step
+ * written before ids existed carries the name alone. Either reference is a
+ * dependent: the id survives a rename of the function, the name does not.
+ */ /** How many of a site's workflows one scan reads. */ export const FUNCTION_DEPENDENTS_WORKFLOWS_READ = 100;
+const text = (value)=>typeof value === 'string' ? value.trim() : '';
+export async function findFunctionDependents(request) {
+    const id = request.id.trim();
+    const name = text(request.name);
+    const { records, truncated } = await workflowRecordIndex.list({
+        hostId: request.hostId,
+        limit: FUNCTION_DEPENDENTS_WORKFLOWS_READ
+    });
+    const dependents = [];
+    for (const record of records){
+        const steps = Array.isArray(record.facts['steps']) ? record.facts['steps'] : [];
+        const via = new Set();
+        for (const step of steps){
+            if (!step || typeof step !== 'object') continue;
+            const { functionId, functionName } = step;
+            if (id && text(functionId) === id) via.add('id');
+            if (name && text(functionName) === name) via.add('name');
+        }
+        if (via.size) {
+            dependents.push({
+                type: 'workflow',
+                id: record.id,
+                name: record.name,
+                via: [
+                    'id',
+                    'name'
+                ].filter((one)=>via.has(one))
+            });
+        }
+    }
+    return {
+        dependents,
+        truncated
+    };
+}
+
+//# sourceMappingURL=workflow-dependents.js.map

package/src/lib/server/workflow-dependents.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/workflows/src/lib/server/workflow-dependents.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 type { BindingRefVia } from '@aglyn/aglyn/app-utils/binding-tokens'\nimport type {\n  PluginDependent,\n  PluginDependentsAnswer,\n  PluginDependentsRequest,\n} from '@aglyn/aglyn/plugin-manager/plugin-dependents'\nimport { workflowRecordIndex } from './automation-record-index'\n\n/**\n * Which of a site's workflows call a function, for the \"Used by\" scan.\n *\n * A workflow step calls a site function by its document id, with the name it\n * had when the step was written beside it as a display hint (AGL-261); a step\n * written before ids existed carries the name alone. Either reference is a\n * dependent: the id survives a rename of the function, the name does not.\n */\n\n/** How many of a site's workflows one scan reads. */\nexport const FUNCTION_DEPENDENTS_WORKFLOWS_READ = 100\n\nconst text = (value: unknown): string => (typeof value === 'string' ? value.trim() : '')\n\nexport async function findFunctionDependents(\n  request: PluginDependentsRequest,\n): Promise<PluginDependentsAnswer> {\n  const id = request.id.trim()\n  const name = text(request.name)\n  const { records, truncated } = await workflowRecordIndex.list({\n    hostId: request.hostId,\n    limit: FUNCTION_DEPENDENTS_WORKFLOWS_READ,\n  })\n  const dependents: PluginDependent[] = []\n  for (const record of records) {\n    const steps = Array.isArray(record.facts['steps']) ? (record.facts['steps'] as unknown[]) : []\n    const via = new Set<BindingRefVia>()\n    for (const step of steps) {\n      if (!step || typeof step !== 'object') continue\n      const { functionId, functionName } = step as Record<string, unknown>\n      if (id && text(functionId) === id) via.add('id')\n      if (name && text(functionName) === name) via.add('name')\n    }\n    if (via.size) {\n      dependents.push({\n        type: 'workflow',\n        id: record.id,\n        name: record.name,\n        via: (['id', 'name'] as const).filter((one) => via.has(one)),\n      })\n    }\n  }\n  return { dependents, truncated }\n}\n"],"names":["workflowRecordIndex","FUNCTION_DEPENDENTS_WORKFLOWS_READ","text","value","trim","findFunctionDependents","request","id","name","records","truncated","list","hostId","limit","dependents","record","steps","Array","isArray","facts","via","Set","step","functionId","functionName","add","size","push","type","filter","one","has"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAQD,SAASA,mBAAmB,QAAQ,+BAA2B;AAE/D;;;;;;;CAOC,GAED,mDAAmD,GACnD,OAAO,MAAMC,qCAAqC,IAAG;AAErD,MAAMC,OAAO,CAACC,QAA4B,OAAOA,UAAU,WAAWA,MAAMC,IAAI,KAAK;AAErF,OAAO,eAAeC,uBACpBC,OAAgC;IAEhC,MAAMC,KAAKD,QAAQC,EAAE,CAACH,IAAI;IAC1B,MAAMI,OAAON,KAAKI,QAAQE,IAAI;IAC9B,MAAM,EAAEC,OAAO,EAAEC,SAAS,EAAE,GAAG,MAAMV,oBAAoBW,IAAI,CAAC;QAC5DC,QAAQN,QAAQM,MAAM;QACtBC,OAAOZ;IACT;IACA,MAAMa,aAAgC,EAAE;IACxC,KAAK,MAAMC,UAAUN,QAAS;QAC5B,MAAMO,QAAQC,MAAMC,OAAO,CAACH,OAAOI,KAAK,CAAC,QAAQ,IAAKJ,OAAOI,KAAK,CAAC,QAAQ,GAAiB,EAAE;QAC9F,MAAMC,MAAM,IAAIC;QAChB,KAAK,MAAMC,QAAQN,MAAO;YACxB,IAAI,CAACM,QAAQ,OAAOA,SAAS,UAAU;YACvC,MAAM,EAAEC,UAAU,EAAEC,YAAY,EAAE,GAAGF;YACrC,IAAIf,MAAML,KAAKqB,gBAAgBhB,IAAIa,IAAIK,GAAG,CAAC;YAC3C,IAAIjB,QAAQN,KAAKsB,kBAAkBhB,MAAMY,IAAIK,GAAG,CAAC;QACnD;QACA,IAAIL,IAAIM,IAAI,EAAE;YACZZ,WAAWa,IAAI,CAAC;gBACdC,MAAM;gBACNrB,IAAIQ,OAAOR,EAAE;gBACbC,MAAMO,OAAOP,IAAI;gBACjBY,KAAK,AAAC;oBAAC;oBAAM;iBAAO,CAAWS,MAAM,CAAC,CAACC,MAAQV,IAAIW,GAAG,CAACD;YACzD;QACF;IACF;IACA,OAAO;QAAEhB;QAAYJ;IAAU;AACjC"}

package/src/lib/server/workflow-variables.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @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 { VariableComputation } from '@aglyn/aglyn/plugin-manager/computed-variables';
+/** How many of a site's workflows a page reads to compute its variables. */
+export declare const COMPUTED_VARIABLE_WORKFLOWS_READ = 100;
+export declare function prepareWorkflowVariables(hostId: string): Promise<VariableComputation>;