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

package/src/lib/components/use-ai-job-run.js

@@ -20,56 +20,6 @@ import { useCallback, useEffect, useRef, useState } from "react";
 import { AI_JOB_TERMINAL_STATUSES } from "../model/ai-jobs.types.js";
 import { followAiJobEvents } from "./ai-job-events.js";
 import { publishAiJob } from "./ai-jobs-store.js";
-/**
- * One answer per member and workspace, however many controls ask. The
- * automation run history draws a control on every failed run, and each asking
- * the route would be a request a row.
- */ const verdicts = new Map();
-/** Forgets every answer, so the next control to mount asks the route again. */ export function forgetAiJobsVerdicts() {
-    verdicts.clear();
-}
-function askJobsRoute(user, uid, orgId) {
-    const key = `${uid}\n${orgId}`;
-    const known = verdicts.get(key);
-    if (known) return known;
-    const answer = authorizedFetch(user, `/api/ai/jobs?orgId=${encodeURIComponent(orgId)}&limit=1`)// The release flag off (404) and a plan or member without generation
-    // (403): the feature is not this workspace's, so the control is absent.
-    .then((response)=>response.status === 404 || response.status === 403 ? 'hidden' : 'ready').catch(()=>{
-        // A request that never arrived is no answer, so the next control asks again.
-        verdicts.delete(key);
-        return 'hidden';
-    });
-    verdicts.set(key, answer);
-    return answer;
-}
-/**
- * Whether a control that starts a job should be drawn. The shell decided the
- * plan and the member's permission before mounting it; the release flag is the
- * route's to decide.
- */ export function useAiJobsVerdict(user, orgId) {
-    var _ref;
-    // Held in a ref so the question keys on WHO is signed in, never on the
-    // identity of the object that says so.
-    const userRef = useRef(user);
-    userRef.current = user;
-    const uid = (_ref = user == null ? void 0 : user.uid) != null ? _ref : null;
-    const [verdict, setVerdict] = useState('checking');
-    useEffect(()=>{
-        if (!orgId || !uid) return;
-        let active = true;
-        setVerdict('checking');
-        void askJobsRoute(userRef.current, uid, orgId).then((answer)=>{
-            if (active) setVerdict(answer);
-        });
-        return ()=>{
-            active = false;
-        };
-    }, [
-        orgId,
-        uid
-    ]);
-    return verdict;
-}
 /** Whether a job has stopped moving: finished, or waiting on something only a person can change. */ export function aiJobSettled(job) {
     if (!job) return false;
     return AI_JOB_TERMINAL_STATUSES.includes(job.status) || job.status === 'needs_input' || job.status === 'needs_review';

package/src/lib/components/use-ai-job-run.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/use-ai-job-run.ts"],"sourcesContent":["'use client'\n\n/**\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 { lockdownRefusalText, parseLockdownRefusal } from '@aglyn/aglyn'\nimport {\n  authorizedFetch,\n  type MaybeTokenSource,\n  type TokenSource,\n} from '@aglyn/shared-util-http/authorized-token'\nimport { useCallback, useEffect, useRef, useState } from 'react'\nimport {\n  AI_JOB_TERMINAL_STATUSES,\n  type AiJobKind,\n  type AiJobSummary,\n} from '../model/ai-jobs.types'\nimport { followAiJobEvents } from './ai-job-events'\nimport { publishAiJob } from './ai-jobs-store'\n\n/**\n * Starting one AI job from a console control, and following it until it\n * settles (AGL-2919): the jobs route's create door, then its events door, the\n * way the SEO card follows its jobs. A control that starts a job the beat\n * runs shows its progress here and its result when it arrives; closing the\n * control stops following, and the job carries on in AI jobs.\n */\n\n/** Whether the jobs route serves a workspace: still asking, yes, or no. */\nexport type AiJobsVerdict = 'checking' | 'ready' | 'hidden'\n\n/**\n * One answer per member and workspace, however many controls ask. The\n * automation run history draws a control on every failed run, and each asking\n * the route would be a request a row.\n */\nconst verdicts = new Map<string, Promise<Exclude<AiJobsVerdict, 'checking'>>>()\n\n/** Forgets every answer, so the next control to mount asks the route again. */\nexport function forgetAiJobsVerdicts(): void {\n  verdicts.clear()\n}\n\nfunction askJobsRoute(\n  user: MaybeTokenSource,\n  uid: string,\n  orgId: string,\n): Promise<Exclude<AiJobsVerdict, 'checking'>> {\n  const key = `${uid}\\n${orgId}`\n  const known = verdicts.get(key)\n  if (known) return known\n  const answer = authorizedFetch(user, `/api/ai/jobs?orgId=${encodeURIComponent(orgId)}&limit=1`)\n    // The release flag off (404) and a plan or member without generation\n    // (403): the feature is not this workspace's, so the control is absent.\n    .then((response): Exclude<AiJobsVerdict, 'checking'> =>\n      response.status === 404 || response.status === 403 ? 'hidden' : 'ready',\n    )\n    .catch((): Exclude<AiJobsVerdict, 'checking'> => {\n      // A request that never arrived is no answer, so the next control asks again.\n      verdicts.delete(key)\n      return 'hidden'\n    })\n  verdicts.set(key, answer)\n  return answer\n}\n\n/**\n * Whether a control that starts a job should be drawn. The shell decided the\n * plan and the member's permission before mounting it; the release flag is the\n * route's to decide.\n */\nexport function useAiJobsVerdict(\n  user: (TokenSource & { uid?: string | null }) | null | undefined,\n  orgId: string | undefined,\n): AiJobsVerdict {\n  // Held in a ref so the question keys on WHO is signed in, never on the\n  // identity of the object that says so.\n  const userRef = useRef(user)\n  userRef.current = user\n  const uid = user?.uid ?? null\n  const [verdict, setVerdict] = useState<AiJobsVerdict>('checking')\n\n  useEffect(() => {\n    if (!orgId || !uid) return\n    let active = true\n    setVerdict('checking')\n    void askJobsRoute(userRef.current, uid, orgId).then((answer) => {\n      if (active) setVerdict(answer)\n    })\n    return () => {\n      active = false\n    }\n  }, [orgId, uid])\n\n  return verdict\n}\n\n/** What a control asks the create door for. */\nexport interface AiJobRequest {\n  orgId: string\n  hostId: string\n  kind: AiJobKind\n  brief: string\n  inputs: Record<string, string>\n}\n\n/** Whether a job has stopped moving: finished, or waiting on something only a person can change. */\nexport function aiJobSettled(job: AiJobSummary | null): boolean {\n  if (!job) return false\n  return (\n    AI_JOB_TERMINAL_STATUSES.includes(job.status) ||\n    job.status === 'needs_input' ||\n    job.status === 'needs_review'\n  )\n}\n\n/**\n * Why a settled job has no result to show, in words a person can act on, or\n * `null` for a job that finished.\n */\nexport function aiJobProblem(job: AiJobSummary | null, failed: string): string | null {\n  if (!job || !aiJobSettled(job) || job.status === 'done') return null\n  if (job.status === 'canceled') return 'The job was canceled.'\n  if (job.status === 'needs_review') return job.review?.message || job.error || failed\n  return job.error || failed\n}\n\nexport interface AiJobRun {\n  /** The job as it last arrived; `null` before one is started. */\n  job: AiJobSummary | null\n  /** The create door is being asked. */\n  starting: boolean\n  /** The job exists and has not settled. */\n  running: boolean\n  /** Why the create door refused, or could not be reached. */\n  notice: string | null\n  /** Starts the job, `true` once it exists, and follows it from there; `false` when the door refused. */\n  start: (request: AiJobRequest) => Promise<boolean>\n  /** Stops following and forgets the job, for a control asked again. */\n  reset: () => void\n}\n\nexport function useAiJobRun(user: MaybeTokenSource, failed: string): AiJobRun {\n  const userRef = useRef(user)\n  userRef.current = user\n  const [job, setJob] = useState<AiJobSummary | null>(null)\n  const [starting, setStarting] = useState(false)\n  const [notice, setNotice] = useState<string | null>(null)\n  const watchRef = useRef<AbortController | null>(null)\n\n  useEffect(() => () => watchRef.current?.abort(), [])\n\n  /** Follows a job through the events route until it settles or the control goes. */\n  const watch = useCallback(async (jobId: string, orgId: string) => {\n    watchRef.current?.abort()\n    const controller = new AbortController()\n    watchRef.current = controller\n    await followAiJobEvents(() => userRef.current, orgId, jobId, controller.signal, setJob)\n  }, [])\n\n  const start = useCallback(\n    async (request: AiJobRequest) => {\n      watchRef.current?.abort()\n      setStarting(true)\n      setNotice(null)\n      setJob(null)\n      let next: AiJobSummary | undefined\n      try {\n        const response = await authorizedFetch(userRef.current, '/api/ai/jobs', {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify(request),\n        })\n        const payload = await response.json().catch(() => null)\n        if (!response.ok) {\n          const locked = parseLockdownRefusal(response.status, payload)\n          setNotice(locked ? lockdownRefusalText(locked) : String(payload?.error ?? failed))\n          return false\n        }\n        next = payload?.job as AiJobSummary | undefined\n        if (!next) {\n          setNotice(failed)\n          return false\n        }\n        setJob(next)\n        // The indicator counts it from the moment it exists (AGL-3593).\n        publishAiJob(next)\n      } catch {\n        setNotice(failed)\n        return false\n      } finally {\n        setStarting(false)\n      }\n      if (!aiJobSettled(next)) void watch(next.id, request.orgId)\n      return true\n    },\n    [failed, watch],\n  )\n\n  const reset = useCallback(() => {\n    watchRef.current?.abort()\n    setJob(null)\n    setNotice(null)\n  }, [])\n\n  return { job, starting, running: Boolean(job && !aiJobSettled(job)), notice, start, reset }\n}\n"],"names":["lockdownRefusalText","parseLockdownRefusal","authorizedFetch","useCallback","useEffect","useRef","useState","AI_JOB_TERMINAL_STATUSES","followAiJobEvents","publishAiJob","verdicts","Map","forgetAiJobsVerdicts","clear","askJobsRoute","user","uid","orgId","key","known","get","answer","encodeURIComponent","then","response","status","catch","delete","set","useAiJobsVerdict","userRef","current","verdict","setVerdict","active","aiJobSettled","job","includes","aiJobProblem","failed","review","message","error","useAiJobRun","setJob","starting","setStarting","notice","setNotice","watchRef","abort","watch","jobId","controller","AbortController","signal","start","request","next","method","headers","body","JSON","stringify","payload","json","ok","locked","String","id","reset","running","Boolean"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/use-ai-job-run.ts"],"sourcesContent":["'use client'\n\n/**\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 { lockdownRefusalText, parseLockdownRefusal } from '@aglyn/aglyn'\nimport {\n  authorizedFetch,\n  type MaybeTokenSource,\n} from '@aglyn/shared-util-http/authorized-token'\nimport { useCallback, useEffect, useRef, useState } from 'react'\nimport {\n  AI_JOB_TERMINAL_STATUSES,\n  type AiJobKind,\n  type AiJobSummary,\n} from '../model/ai-jobs.types'\nimport { followAiJobEvents } from './ai-job-events'\nimport { publishAiJob } from './ai-jobs-store'\n\n/**\n * Starting one AI job from a console control, and following it until it\n * settles (AGL-2919): the jobs route's create door, then its events door, the\n * way the SEO card follows its jobs. A control that starts a job the beat\n * runs shows its progress here and its result when it arrives; closing the\n * control stops following, and the job carries on in AI jobs.\n */\n\n/** What a control asks the create door for. */\nexport interface AiJobRequest {\n  orgId: string\n  /** `null` for a job about the workspace rather than one site. */\n  hostId: string | null\n  kind: AiJobKind\n  brief: string\n  inputs: Record<string, string>\n}\n\n/** Whether a job has stopped moving: finished, or waiting on something only a person can change. */\nexport function aiJobSettled(job: AiJobSummary | null): boolean {\n  if (!job) return false\n  return (\n    AI_JOB_TERMINAL_STATUSES.includes(job.status) ||\n    job.status === 'needs_input' ||\n    job.status === 'needs_review'\n  )\n}\n\n/**\n * Why a settled job has no result to show, in words a person can act on, or\n * `null` for a job that finished.\n */\nexport function aiJobProblem(job: AiJobSummary | null, failed: string): string | null {\n  if (!job || !aiJobSettled(job) || job.status === 'done') return null\n  if (job.status === 'canceled') return 'The job was canceled.'\n  if (job.status === 'needs_review') return job.review?.message || job.error || failed\n  return job.error || failed\n}\n\nexport interface AiJobRun {\n  /** The job as it last arrived; `null` before one is started. */\n  job: AiJobSummary | null\n  /** The create door is being asked. */\n  starting: boolean\n  /** The job exists and has not settled. */\n  running: boolean\n  /** Why the create door refused, or could not be reached. */\n  notice: string | null\n  /** Starts the job, `true` once it exists, and follows it from there; `false` when the door refused. */\n  start: (request: AiJobRequest) => Promise<boolean>\n  /** Stops following and forgets the job, for a control asked again. */\n  reset: () => void\n}\n\nexport function useAiJobRun(user: MaybeTokenSource, failed: string): AiJobRun {\n  const userRef = useRef(user)\n  userRef.current = user\n  const [job, setJob] = useState<AiJobSummary | null>(null)\n  const [starting, setStarting] = useState(false)\n  const [notice, setNotice] = useState<string | null>(null)\n  const watchRef = useRef<AbortController | null>(null)\n\n  useEffect(() => () => watchRef.current?.abort(), [])\n\n  /** Follows a job through the events route until it settles or the control goes. */\n  const watch = useCallback(async (jobId: string, orgId: string) => {\n    watchRef.current?.abort()\n    const controller = new AbortController()\n    watchRef.current = controller\n    await followAiJobEvents(() => userRef.current, orgId, jobId, controller.signal, setJob)\n  }, [])\n\n  const start = useCallback(\n    async (request: AiJobRequest) => {\n      watchRef.current?.abort()\n      setStarting(true)\n      setNotice(null)\n      setJob(null)\n      let next: AiJobSummary | undefined\n      try {\n        const response = await authorizedFetch(userRef.current, '/api/ai/jobs', {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify(request),\n        })\n        const payload = await response.json().catch(() => null)\n        if (!response.ok) {\n          const locked = parseLockdownRefusal(response.status, payload)\n          setNotice(locked ? lockdownRefusalText(locked) : String(payload?.error ?? failed))\n          return false\n        }\n        next = payload?.job as AiJobSummary | undefined\n        if (!next) {\n          setNotice(failed)\n          return false\n        }\n        setJob(next)\n        // The indicator counts it from the moment it exists (AGL-3593).\n        publishAiJob(next)\n      } catch {\n        setNotice(failed)\n        return false\n      } finally {\n        setStarting(false)\n      }\n      if (!aiJobSettled(next)) void watch(next.id, request.orgId)\n      return true\n    },\n    [failed, watch],\n  )\n\n  const reset = useCallback(() => {\n    watchRef.current?.abort()\n    setJob(null)\n    setNotice(null)\n  }, [])\n\n  return { job, starting, running: Boolean(job && !aiJobSettled(job)), notice, start, reset }\n}\n"],"names":["lockdownRefusalText","parseLockdownRefusal","authorizedFetch","useCallback","useEffect","useRef","useState","AI_JOB_TERMINAL_STATUSES","followAiJobEvents","publishAiJob","aiJobSettled","job","includes","status","aiJobProblem","failed","review","message","error","useAiJobRun","user","userRef","current","setJob","starting","setStarting","notice","setNotice","watchRef","abort","watch","jobId","orgId","controller","AbortController","signal","start","request","next","response","method","headers","body","JSON","stringify","payload","json","catch","ok","locked","String","id","reset","running","Boolean"],"mappings":"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"}

package/src/lib/jobs/ai-build-capabilities.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types';
+import { type PluginAiCapability, type ResolvedPluginAiCapability } from '@aglyn/aglyn/plugin-manager/plugin-ai-capabilities';
+import type { AiBuildOps } from '../model/ai-build-job';
+/** The operations this plugin owns, as it registers them. */
+export declare const AI_OWNED_CAPABILITIES: readonly PluginAiCapability[];
+/** Registers this plugin's build operations; the console surface calls it. */
+export declare function registerAiBuildCapabilities(): void;
+/** What decides which operations a build may use here. */
+export interface AiBuildOpsContext {
+    orgId: string;
+    hostId: string | null;
+    org: Partial<AglynOrgBilling> | null;
+    /** The site document, for the plugins switched on and off on it. */
+    host: Readonly<Record<string, unknown>> | null;
+    freeTaste: boolean;
+}
+export interface AiBuildOpsDeps {
+    /** The registered capabilities; the core registry's otherwise. */
+    capabilities?: () => ResolvedPluginAiCapability[];
+    /** The release-flag read; the platform's otherwise. */
+    releasedPlugins?: (pluginIds: string[], orgId: string) => Promise<string[]>;
+    /** Whether a runner is registered for a kind; the machine's otherwise. */
+    hasRunner?: (kind: string) => boolean;
+}
+/**
+ * The operations a build may plan on this site, by op (AGL-3616): every
+ * registered capability whose owner runs here — switched on for the
+ * workspace and the site, past its release flag — whose entitlement the plan
+ * holds, which the Free taste may use where the workspace is on it, and,
+ * for an AI-run operation, whose runner this process loaded. One release-flag
+ * read for every owner at once. What a member may do and what an allowance
+ * has left are the owner's to say when the item runs (`refusal`).
+ */
+export declare function aiBuildOps(context: AiBuildOpsContext, deps?: AiBuildOpsDeps): Promise<AiBuildOps>;
+/**
+ * The lines the plan step's request lists the item operations in: each op
+ * with what it makes, its arguments and their meaning. Per site, so they ride
+ * the job's own turn and never a cached system block.
+ */
+export declare function aiBuildOpLines(ops: AiBuildOps, structural: readonly string[]): string[];
+/** What a build can make here, in the owner's words, for the chat's instructions. */
+export declare function aiBuildIntents(ops: AiBuildOps): string[];

package/src/lib/jobs/ai-build-capabilities.js

@@ -0,0 +1,256 @@
+/**
+ * @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 { checkEntitlement } from "@aglyn/aglyn/app-utils/plan-entitlements";
+import { isHostPluginEnabled } from "@aglyn/aglyn/plugin-manager/enabled-plugins";
+import { pluginAiCapabilities, registerPluginAiCapability } from "@aglyn/aglyn/plugin-manager/plugin-ai-capabilities";
+import { filterEnabledPluginsByReleaseFlags } from "@aglyn/tenant-data-admin/server/release-flags";
+import { AI_TEMPLATE_SUBJECTS } from "../model/ai-template-subjects.js";
+import { AI_SITE_PASS_CREDITS } from "../model/ai-site-job.js";
+import { aiJobStepRunnerFor } from "./ai-jobs.js";
+/**
+ * What THIS plugin lets a build make (AGL-3616), registered on the core's
+ * capability contract exactly as any other plugin registers its own, so the
+ * planner, the gates and the estimate read one list and name no plugin.
+ *
+ * Every one is built by a runner this plugin already has (`runnerKind`):
+ * pages, layouts, forms, components and email designs are the plan's
+ * creations and screens; templates, campaigns and automations are items with
+ * arguments. A campaign and an automation are still WRITTEN by the marketing
+ * and workflows plugins, through the writers their runners already call.
+ */ /** This plugin's id, as its registrations name their owner. */ const AI_PLUGIN_ID = 'ai';
+const NO_ARGS = {
+    type: 'object',
+    properties: {},
+    additionalProperties: false
+};
+const passes = (count)=>()=>count * AI_SITE_PASS_CREDITS;
+/** The operations this plugin owns, as it registers them. */ export const AI_OWNED_CAPABILITIES = [
+    {
+        op: 'page',
+        noun: 'page',
+        where: 'Pages',
+        intents: [
+            'new pages: home, about, services, contact, pricing, a landing page'
+        ],
+        argsSchema: NO_ARGS,
+        maxPerPlan: 8,
+        freeAllowed: true,
+        runnerKind: 'page',
+        estimateCredits: passes(6),
+        degrade: 'omit'
+    },
+    {
+        op: 'layout',
+        noun: 'layout',
+        where: 'Layouts',
+        intents: [
+            'a header and footer shared by pages'
+        ],
+        argsSchema: NO_ARGS,
+        maxPerPlan: 1,
+        freeAllowed: true,
+        runnerKind: 'layout',
+        estimateCredits: passes(1),
+        degrade: 'fallback'
+    },
+    {
+        op: 'form',
+        noun: 'form',
+        where: 'Forms',
+        intents: [
+            'a contact form, a quote request, a sign-up form'
+        ],
+        argsSchema: NO_ARGS,
+        maxPerPlan: 3,
+        freeAllowed: true,
+        runnerKind: 'form',
+        estimateCredits: passes(1),
+        degrade: 'omit'
+    },
+    {
+        op: 'component',
+        noun: 'component',
+        where: 'Components',
+        intents: [
+            'a reusable card or block placed on several pages'
+        ],
+        argsSchema: NO_ARGS,
+        maxPerPlan: 4,
+        freeAllowed: false,
+        runnerKind: 'component',
+        estimateCredits: passes(1),
+        degrade: 'omit'
+    },
+    {
+        op: 'email',
+        noun: 'email design',
+        where: 'Emails → Templates',
+        intents: [
+            'an email design: a welcome, a reply, an announcement'
+        ],
+        argsSchema: NO_ARGS,
+        maxPerPlan: 2,
+        freeAllowed: false,
+        runnerKind: 'email',
+        estimateCredits: passes(1),
+        degrade: 'omit'
+    },
+    {
+        op: 'template',
+        noun: 'page template',
+        where: 'Templates',
+        intents: [
+            'a page template for blog posts, products or authors'
+        ],
+        argsSchema: {
+            type: 'object',
+            properties: {
+                subject: {
+                    type: 'string',
+                    description: 'What each page shows: entry (a collection entry), product or author.',
+                    enum: AI_TEMPLATE_SUBJECTS
+                },
+                collectionId: {
+                    type: 'string',
+                    description: 'For entry: the collection id from the site inventory.',
+                    maxLength: 100
+                }
+            },
+            required: [
+                'subject'
+            ],
+            additionalProperties: false
+        },
+        maxPerPlan: 2,
+        freeAllowed: false,
+        runnerKind: 'template',
+        estimateCredits: passes(6),
+        degrade: 'omit'
+    },
+    {
+        op: 'campaign',
+        noun: 'email campaign',
+        where: 'Marketing → Campaigns',
+        intents: [
+            'an email campaign drafted and left unsent'
+        ],
+        argsSchema: {
+            type: 'object',
+            properties: {
+                name: {
+                    type: 'string',
+                    description: 'What the campaign is called.',
+                    maxLength: 120
+                }
+            },
+            additionalProperties: false
+        },
+        maxPerPlan: 2,
+        freeAllowed: false,
+        runnerKind: 'campaign',
+        estimateCredits: passes(2),
+        degrade: 'omit'
+    },
+    {
+        op: 'workflow',
+        noun: 'automation',
+        where: 'Automations',
+        intents: [
+            'an automation: when a form is sent, do something'
+        ],
+        argsSchema: NO_ARGS,
+        maxPerPlan: 2,
+        freeAllowed: false,
+        runnerKind: 'workflow',
+        estimateCredits: passes(1),
+        degrade: 'omit'
+    }
+];
+/** Registers this plugin's build operations; the console surface calls it. */ export function registerAiBuildCapabilities() {
+    for (const capability of AI_OWNED_CAPABILITIES){
+        registerPluginAiCapability(capability, {
+            pluginId: AI_PLUGIN_ID
+        });
+    }
+}
+/**
+ * The operations a build may plan on this site, by op (AGL-3616): every
+ * registered capability whose owner runs here — switched on for the
+ * workspace and the site, past its release flag — whose entitlement the plan
+ * holds, which the Free taste may use where the workspace is on it, and,
+ * for an AI-run operation, whose runner this process loaded. One release-flag
+ * read for every owner at once. What a member may do and what an allowance
+ * has left are the owner's to say when the item runs (`refusal`).
+ */ export async function aiBuildOps(context, deps = {}) {
+    var _deps_capabilities, _deps_hasRunner, _deps_releasedPlugins;
+    const all = ((_deps_capabilities = deps.capabilities) != null ? _deps_capabilities : pluginAiCapabilities)();
+    const hasRunner = (_deps_hasRunner = deps.hasRunner) != null ? _deps_hasRunner : (kind)=>aiJobStepRunnerFor(kind) !== null;
+    const owners = [
+        ...new Set(all.map((one)=>one.pluginId).filter((id)=>id !== AI_PLUGIN_ID))
+    ];
+    const released = new Set(owners.length ? await ((_deps_releasedPlugins = deps.releasedPlugins) != null ? _deps_releasedPlugins : (ids, orgId)=>filterEnabledPluginsByReleaseFlags(ids, {
+            orgId,
+            authorization: null
+        }))(owners, context.orgId) : []);
+    const ops = new Map();
+    for (const { pluginId, capability } of all){
+        if (pluginId !== AI_PLUGIN_ID) {
+            if (!released.has(pluginId)) continue;
+            if (!isHostPluginEnabled(context.org, context.host, pluginId)) continue;
+        }
+        if (capability.feature && !checkEntitlement(context.org, capability.feature)) continue;
+        if (context.freeTaste && !capability.freeAllowed) continue;
+        if (capability.runnerKind && !hasRunner(capability.runnerKind)) continue;
+        ops.set(capability.op, capability);
+    }
+    return ops;
+}
+/**
+ * The lines the plan step's request lists the item operations in: each op
+ * with what it makes, its arguments and their meaning. Per site, so they ride
+ * the job's own turn and never a cached system block.
+ */ export function aiBuildOpLines(ops, structural) {
+    const items = [
+        ...ops.values()
+    ].filter((one)=>!structural.includes(one.op));
+    if (!items.length) return [
+        'Operations for items: none on this site. Leave items empty.'
+    ];
+    const lines = [
+        'Operations for items (anything else goes in create or screens):'
+    ];
+    for (const one of items){
+        var _one_pageBlocks;
+        const args = Object.entries(one.argsSchema.properties).map(([name, property])=>{
+            var _one_argsSchema_required;
+            const required = ((_one_argsSchema_required = one.argsSchema.required) == null ? void 0 : _one_argsSchema_required.includes(name)) ? '' : ' (optional)';
+            const choices = property.enum ? ` one of ${property.enum.join('|')}` : '';
+            return `${name}: ${property.type}${choices}${required} — ${property.description}`;
+        });
+        lines.push(`- ${one.op}: ${aiNounWithArticle(one.noun)}, at most ${one.maxPerPlan}; for ${one.intents.join('; ')}.${((_one_pageBlocks = one.pageBlocks) == null ? void 0 : _one_pageBlocks.length) ? ` A page section that uses it places the ${one.pageBlocks.join(' or ')} block: put new:<name> in that section's uses.` : ''} Args: ${args.length ? `{ ${args.join('; ')} }` : '{}'}.`);
+    }
+    return lines;
+}
+function aiNounWithArticle(noun) {
+    return `${/^[aeiou]/i.test(noun) ? 'an' : 'a'} ${noun}`;
+}
+/** What a build can make here, in the owner's words, for the chat's instructions. */ export function aiBuildIntents(ops) {
+    return [
+        ...ops.values()
+    ].flatMap((one)=>one.intents);
+}
+
+//# sourceMappingURL=ai-build-capabilities.js.map

package/src/lib/jobs/ai-build-capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-build-capabilities.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { checkEntitlement } from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport type { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport { isHostPluginEnabled } from '@aglyn/aglyn/plugin-manager/enabled-plugins'\nimport {\n  pluginAiCapabilities,\n  registerPluginAiCapability,\n  type PluginAiCapability,\n  type ResolvedPluginAiCapability,\n} from '@aglyn/aglyn/plugin-manager/plugin-ai-capabilities'\nimport { filterEnabledPluginsByReleaseFlags } from '@aglyn/tenant-data-admin/server/release-flags'\nimport { AI_TEMPLATE_SUBJECTS } from '../model/ai-template-subjects'\nimport { AI_SITE_PASS_CREDITS } from '../model/ai-site-job'\nimport type { AiBuildOps } from '../model/ai-build-job'\nimport { aiJobStepRunnerFor } from './ai-jobs'\n\n/**\n * What THIS plugin lets a build make (AGL-3616), registered on the core's\n * capability contract exactly as any other plugin registers its own, so the\n * planner, the gates and the estimate read one list and name no plugin.\n *\n * Every one is built by a runner this plugin already has (`runnerKind`):\n * pages, layouts, forms, components and email designs are the plan's\n * creations and screens; templates, campaigns and automations are items with\n * arguments. A campaign and an automation are still WRITTEN by the marketing\n * and workflows plugins, through the writers their runners already call.\n */\n\n/** This plugin's id, as its registrations name their owner. */\nconst AI_PLUGIN_ID = 'ai'\n\nconst NO_ARGS = { type: 'object', properties: {}, additionalProperties: false } as const\n\nconst passes = (count: number) => () => count * AI_SITE_PASS_CREDITS\n\n/** The operations this plugin owns, as it registers them. */\nexport const AI_OWNED_CAPABILITIES: readonly PluginAiCapability[] = [\n  {\n    op: 'page',\n    noun: 'page',\n    where: 'Pages',\n    intents: ['new pages: home, about, services, contact, pricing, a landing page'],\n    argsSchema: NO_ARGS,\n    maxPerPlan: 8,\n    freeAllowed: true,\n    runnerKind: 'page',\n    estimateCredits: passes(6),\n    degrade: 'omit',\n  },\n  {\n    op: 'layout',\n    noun: 'layout',\n    where: 'Layouts',\n    intents: ['a header and footer shared by pages'],\n    argsSchema: NO_ARGS,\n    maxPerPlan: 1,\n    freeAllowed: true,\n    runnerKind: 'layout',\n    estimateCredits: passes(1),\n    degrade: 'fallback',\n  },\n  {\n    op: 'form',\n    noun: 'form',\n    where: 'Forms',\n    intents: ['a contact form, a quote request, a sign-up form'],\n    argsSchema: NO_ARGS,\n    maxPerPlan: 3,\n    freeAllowed: true,\n    runnerKind: 'form',\n    estimateCredits: passes(1),\n    degrade: 'omit',\n  },\n  {\n    op: 'component',\n    noun: 'component',\n    where: 'Components',\n    intents: ['a reusable card or block placed on several pages'],\n    argsSchema: NO_ARGS,\n    maxPerPlan: 4,\n    freeAllowed: false,\n    runnerKind: 'component',\n    estimateCredits: passes(1),\n    degrade: 'omit',\n  },\n  {\n    op: 'email',\n    noun: 'email design',\n    where: 'Emails → Templates',\n    intents: ['an email design: a welcome, a reply, an announcement'],\n    argsSchema: NO_ARGS,\n    maxPerPlan: 2,\n    freeAllowed: false,\n    runnerKind: 'email',\n    estimateCredits: passes(1),\n    degrade: 'omit',\n  },\n  {\n    op: 'template',\n    noun: 'page template',\n    where: 'Templates',\n    intents: ['a page template for blog posts, products or authors'],\n    argsSchema: {\n      type: 'object',\n      properties: {\n        subject: {\n          type: 'string',\n          description: 'What each page shows: entry (a collection entry), product or author.',\n          enum: AI_TEMPLATE_SUBJECTS,\n        },\n        collectionId: {\n          type: 'string',\n          description: 'For entry: the collection id from the site inventory.',\n          maxLength: 100,\n        },\n      },\n      required: ['subject'],\n      additionalProperties: false,\n    },\n    maxPerPlan: 2,\n    freeAllowed: false,\n    runnerKind: 'template',\n    estimateCredits: passes(6),\n    degrade: 'omit',\n  },\n  {\n    op: 'campaign',\n    noun: 'email campaign',\n    where: 'Marketing → Campaigns',\n    intents: ['an email campaign drafted and left unsent'],\n    argsSchema: {\n      type: 'object',\n      properties: {\n        name: { type: 'string', description: 'What the campaign is called.', maxLength: 120 },\n      },\n      additionalProperties: false,\n    },\n    maxPerPlan: 2,\n    freeAllowed: false,\n    runnerKind: 'campaign',\n    estimateCredits: passes(2),\n    degrade: 'omit',\n  },\n  {\n    op: 'workflow',\n    noun: 'automation',\n    where: 'Automations',\n    intents: ['an automation: when a form is sent, do something'],\n    argsSchema: NO_ARGS,\n    maxPerPlan: 2,\n    freeAllowed: false,\n    runnerKind: 'workflow',\n    estimateCredits: passes(1),\n    degrade: 'omit',\n  },\n]\n\n/** Registers this plugin's build operations; the console surface calls it. */\nexport function registerAiBuildCapabilities(): void {\n  for (const capability of AI_OWNED_CAPABILITIES) {\n    registerPluginAiCapability(capability, { pluginId: AI_PLUGIN_ID })\n  }\n}\n\n/** What decides which operations a build may use here. */\nexport interface AiBuildOpsContext {\n  orgId: string\n  hostId: string | null\n  org: Partial<AglynOrgBilling> | null\n  /** The site document, for the plugins switched on and off on it. */\n  host: Readonly<Record<string, unknown>> | null\n  freeTaste: boolean\n}\n\nexport interface AiBuildOpsDeps {\n  /** The registered capabilities; the core registry's otherwise. */\n  capabilities?: () => ResolvedPluginAiCapability[]\n  /** The release-flag read; the platform's otherwise. */\n  releasedPlugins?: (pluginIds: string[], orgId: string) => Promise<string[]>\n  /** Whether a runner is registered for a kind; the machine's otherwise. */\n  hasRunner?: (kind: string) => boolean\n}\n\n/**\n * The operations a build may plan on this site, by op (AGL-3616): every\n * registered capability whose owner runs here — switched on for the\n * workspace and the site, past its release flag — whose entitlement the plan\n * holds, which the Free taste may use where the workspace is on it, and,\n * for an AI-run operation, whose runner this process loaded. One release-flag\n * read for every owner at once. What a member may do and what an allowance\n * has left are the owner's to say when the item runs (`refusal`).\n */\nexport async function aiBuildOps(context: AiBuildOpsContext, deps: AiBuildOpsDeps = {}): Promise<AiBuildOps> {\n  const all = (deps.capabilities ?? pluginAiCapabilities)()\n  const hasRunner = deps.hasRunner ?? ((kind: string) => aiJobStepRunnerFor(kind as never) !== null)\n  const owners = [...new Set(all.map((one) => one.pluginId).filter((id) => id !== AI_PLUGIN_ID))]\n  const released = new Set(\n    owners.length\n      ? await (deps.releasedPlugins ??\n          ((ids, orgId) => filterEnabledPluginsByReleaseFlags(ids, { orgId, authorization: null })))(owners, context.orgId)\n      : [],\n  )\n  const ops = new Map<string, PluginAiCapability>()\n  for (const { pluginId, capability } of all) {\n    if (pluginId !== AI_PLUGIN_ID) {\n      if (!released.has(pluginId)) continue\n      if (!isHostPluginEnabled(context.org as { enabledPlugins?: string[] } | null, context.host, pluginId)) continue\n    }\n    if (capability.feature && !checkEntitlement(context.org, capability.feature)) continue\n    if (context.freeTaste && !capability.freeAllowed) continue\n    if (capability.runnerKind && !hasRunner(capability.runnerKind)) continue\n    ops.set(capability.op, capability)\n  }\n  return ops\n}\n\n/**\n * The lines the plan step's request lists the item operations in: each op\n * with what it makes, its arguments and their meaning. Per site, so they ride\n * the job's own turn and never a cached system block.\n */\nexport function aiBuildOpLines(ops: AiBuildOps, structural: readonly string[]): string[] {\n  const items = [...ops.values()].filter((one) => !structural.includes(one.op))\n  if (!items.length) return ['Operations for items: none on this site. Leave items empty.']\n  const lines = ['Operations for items (anything else goes in create or screens):']\n  for (const one of items) {\n    const args = Object.entries(one.argsSchema.properties).map(([name, property]) => {\n      const required = one.argsSchema.required?.includes(name) ? '' : ' (optional)'\n      const choices = property.enum ? ` one of ${property.enum.join('|')}` : ''\n      return `${name}: ${property.type}${choices}${required} — ${property.description}`\n    })\n    lines.push(\n      `- ${one.op}: ${aiNounWithArticle(one.noun)}, at most ${one.maxPerPlan}; for ${one.intents.join('; ')}.${\n        one.pageBlocks?.length ? ` A page section that uses it places the ${one.pageBlocks.join(' or ')} block: put new:<name> in that section's uses.` : ''\n      } Args: ${args.length ? `{ ${args.join('; ')} }` : '{}'}.`,\n    )\n  }\n  return lines\n}\n\nfunction aiNounWithArticle(noun: string): string {\n  return `${/^[aeiou]/i.test(noun) ? 'an' : 'a'} ${noun}`\n}\n\n/** What a build can make here, in the owner's words, for the chat's instructions. */\nexport function aiBuildIntents(ops: AiBuildOps): string[] {\n  return [...ops.values()].flatMap((one) => one.intents)\n}\n"],"names":["checkEntitlement","isHostPluginEnabled","pluginAiCapabilities","registerPluginAiCapability","filterEnabledPluginsByReleaseFlags","AI_TEMPLATE_SUBJECTS","AI_SITE_PASS_CREDITS","aiJobStepRunnerFor","AI_PLUGIN_ID","NO_ARGS","type","properties","additionalProperties","passes","count","AI_OWNED_CAPABILITIES","op","noun","where","intents","argsSchema","maxPerPlan","freeAllowed","runnerKind","estimateCredits","degrade","subject","description","enum","collectionId","maxLength","required","name","registerAiBuildCapabilities","capability","pluginId","aiBuildOps","context","deps","all","capabilities","hasRunner","kind","owners","Set","map","one","filter","id","released","length","releasedPlugins","ids","orgId","authorization","ops","Map","has","org","host","feature","freeTaste","set","aiBuildOpLines","structural","items","values","includes","lines","args","Object","entries","property","choices","join","push","aiNounWithArticle","pageBlocks","test","aiBuildIntents","flatMap"],"mappings":"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"}

package/src/lib/jobs/ai-build-unit-outcome.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type AiBuildUnit } from '../model/ai-build-job';
+import type { AiJobItemLedger, AiJobOutput } from '../model/ai-jobs.types';
+import type { AiSiteBuiltRef } from './ai-job-site-step';
+import type { AiJobItemOutcome, AiJobStepOutcome } from './ai-job-text-step';
+/**
+ * One delegated unit's pass as an ITEM of a job settled item by item
+ * (AGL-3616) — a `build`, and a site scaffold, which is the build's preset.
+ * The runner's spend is the pass's; what the runner came to is the item's
+ * row: still running, built (or built without something that failed),
+ * failed on our side, or failed on the model's or the workspace's.
+ *
+ * Shared by both steps, and importing neither, so neither imports the other.
+ */
+/** What a unit says when it finished without reporting anything. */
+export declare const AI_BUILD_UNIT_EMPTY_COPY = "It could not be built this time.";
+/** What a unit's model declining the request says. */
+export declare const AI_BUILD_UNIT_REFUSED_COPY = "The AI declined to build this one.";
+/** A runner's outcome narrowed to its spend: no plan, no review, nothing the delegating job keeps. */
+export declare function aiUnitSpend(outcome: AiJobStepOutcome): AiJobStepOutcome;
+/**
+ * What a runner's outcome comes to for its item; `null` when the unit
+ * reported what it built and the caller decides whether that counts.
+ */
+export declare function aiUnitFailure(slot: string, outcome: AiJobStepOutcome): AiJobItemOutcome | null;
+/**
+ * Whether an error a unit's runner threw is the machine's to retry — a
+ * provider that will answer later, or a budget that ended — rather than this
+ * item's failure.
+ */
+export declare function aiUnitErrorRetryable(error: unknown): boolean;
+/**
+ * What the build has created that a later unit can name: each delivered
+ * creation's record, by its plan name. A creation's first output is the
+ * record it wrote.
+ */
+export declare function aiBuildBuiltRefs(units: readonly AiBuildUnit[], ledger: readonly AiJobItemLedger[], outputs: readonly Pick<AiJobOutput, 'id' | 'label'>[]): Map<string, AiSiteBuiltRef>;

package/src/lib/jobs/ai-build-unit-outcome.js

@@ -0,0 +1,140 @@
+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 { aiBuildItemDelivered } from "../model/ai-build-job.js";
+import { AiUpstreamError } from "../runtime/ai-runtime.js";
+/**
+ * One delegated unit's pass as an ITEM of a job settled item by item
+ * (AGL-3616) — a `build`, and a site scaffold, which is the build's preset.
+ * The runner's spend is the pass's; what the runner came to is the item's
+ * row: still running, built (or built without something that failed),
+ * failed on our side, or failed on the model's or the workspace's.
+ *
+ * Shared by both steps, and importing neither, so neither imports the other.
+ */ /** What a unit says when it finished without reporting anything. */ export const AI_BUILD_UNIT_EMPTY_COPY = 'It could not be built this time.';
+/** What a unit's model declining the request says. */ export const AI_BUILD_UNIT_REFUSED_COPY = 'The AI declined to build this one.';
+/** A runner's outcome narrowed to its spend: no plan, no review, nothing the delegating job keeps. */ export function aiUnitSpend(outcome) {
+    return _extends({
+        outputs: outcome.outputs,
+        usage: outcome.usage,
+        estCostUsd: outcome.estCostUsd,
+        model: outcome.model,
+        stopReason: outcome.stopReason
+    }, outcome.effort ? {
+        effort: outcome.effort
+    } : {});
+}
+/**
+ * What a runner's outcome comes to for its item; `null` when the unit
+ * reported what it built and the caller decides whether that counts.
+ */ export function aiUnitFailure(slot, outcome) {
+    const outputs = outcome.outputs.map((output)=>output.id);
+    if (outcome.refused) {
+        return {
+            slot,
+            status: 'failed',
+            failure: {
+                ours: false,
+                reason: 'refused',
+                message: AI_BUILD_UNIT_REFUSED_COPY
+            },
+            outputs
+        };
+    }
+    if (outcome.review) {
+        // A building rule still broken after its re-ask is ours (AGL-3596); a
+        // site at an allowance is the workspace's to change.
+        const ours = outcome.review.reason === 'doctrine';
+        return {
+            slot,
+            status: 'failed',
+            failure: _extends({
+                ours,
+                reason: ours ? 'doctrine-refused' : 'review',
+                message: outcome.review.message || AI_BUILD_UNIT_EMPTY_COPY
+            }, outcome.review.detail ? {
+                detail: outcome.review.detail
+            } : {}),
+            outputs
+        };
+    }
+    if (outcome.failure) {
+        return {
+            slot,
+            status: 'failed',
+            failure: {
+                ours: true,
+                reason: 'step-failure',
+                message: outcome.failure
+            },
+            outputs
+        };
+    }
+    if (outcome.continue) return {
+        slot,
+        status: 'running',
+        outputs
+    };
+    if (!outcome.outputs.length) {
+        return {
+            slot,
+            status: 'failed',
+            failure: {
+                ours: true,
+                reason: 'step-failure',
+                message: AI_BUILD_UNIT_EMPTY_COPY
+            }
+        };
+    }
+    return null;
+}
+/**
+ * Whether an error a unit's runner threw is the machine's to retry — a
+ * provider that will answer later, or a budget that ended — rather than this
+ * item's failure.
+ */ export function aiUnitErrorRetryable(error) {
+    if (error instanceof AiUpstreamError && error.retryable) return true;
+    const name = error == null ? void 0 : error.name;
+    return name === 'AbortError' || name === 'TimeoutError';
+}
+/**
+ * What the build has created that a later unit can name: each delivered
+ * creation's record, by its plan name. A creation's first output is the
+ * record it wrote.
+ */ export function aiBuildBuiltRefs(units, ledger, outputs) {
+    const rows = new Map(ledger.map((row)=>[
+            row.slot,
+            row
+        ]));
+    const built = new Map();
+    for (const unit of units){
+        var _outputs_find;
+        const creation = unit.creation;
+        const row = rows.get(unit.slot);
+        if (!creation || !row || !aiBuildItemDelivered(row) || !row.outputs.length) continue;
+        if (creation.kind !== 'layout' && creation.kind !== 'form' && creation.kind !== 'component') continue;
+        const id = row.outputs[0];
+        const label = ((_outputs_find = outputs.find((output)=>output.id === id)) == null ? void 0 : _outputs_find.label) || creation.name;
+        built.set(creation.name.toLowerCase(), {
+            id,
+            label,
+            kind: creation.kind
+        });
+    }
+    return built;
+}
+
+//# sourceMappingURL=ai-build-unit-outcome.js.map