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

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

@@ -14,7 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { AiJobItemLedger, AiJobSummary } from './ai-jobs.types';
+import { type AiJobItemLedger, type AiJobSummary } from './ai-jobs.types';
 /**
  * What a `build` job shows of each item (AGL-3616), wherever it is shown —
  * the AI jobs drawer, the job's own page, the chat card: the item, where it
@@ -31,6 +31,8 @@ export interface AiBuildItemRow {
     state: AiBuildItemRowState;
     /** What the person should know: the failure, the note, what was given back. */
     detail: string | null;
+    /** When the active item started, for the elapsed time beside it; absent on every other row. */
+    startedAt?: string | null;
 }
 /** What an operation is called at the start of a row: its own noun, or the op spelled as words. */
 export declare function aiBuildOpNoun(op: string): string;
@@ -42,8 +44,23 @@ export declare function aiBuildOpNoun(op: string): string;
  * did not fail.
  */
 export declare function aiBuildItemRefundCopy(row: Pick<AiJobItemLedger, 'status' | 'failure' | 'creditsRefunded' | 'creditsSpent'>): string | null;
-/** One row an item, in the order the build planned them. */
-export declare function aiBuildItemRows(job: Pick<AiJobSummary, 'items'>): AiBuildItemRow[];
+/**
+ * The item the build is on (AGL-3596): the one its ledger marks running, else
+ * — while the job moves — the first still pending, which is the one its runner
+ * builds next. The runner settles an item in the write that records its pass,
+ * so the item it is writing reads `pending` until it is done; read as such,
+ * every row waited and the build looked stalled. `null` when the job is not
+ * moving or nothing is left.
+ */
+export declare function aiBuildActiveSlot(job: Pick<AiJobSummary, 'items'> & Partial<Pick<AiJobSummary, 'status'>>): string | null;
+/**
+ * When the active item started: when the last item before it settled, which
+ * the ledger records, else when the build step started — the first item's
+ * start, and the best a ledger written before settling was recorded has.
+ */
+export declare function aiBuildActiveStartedAt(job: Pick<AiJobSummary, 'items'> & Partial<Pick<AiJobSummary, 'steps'>>): string | null;
+/** One row an item, in the order the build planned them; the item it is on is the active one. */
+export declare function aiBuildItemRows(job: Pick<AiJobSummary, 'items'> & Partial<Pick<AiJobSummary, 'status' | 'steps'>>): AiBuildItemRow[];
 /** How a build came out, in one line: "4 of 5 built; 1 failed." `null` while it runs. */
 export declare function aiBuildOutcomeLine(job: Pick<AiJobSummary, 'items' | 'status'>): string | null;
 /** Whether a finished build — or a site that built part of itself — has failed items to try again. */

package/src/lib/model/ai-build-progress.js

@@ -1,3 +1,4 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
 /**
  * @license
  * Copyright 2026 Aglyn LLC
@@ -13,7 +14,9 @@
  * 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.
- */ const OP_NOUNS = {
+ */ import { aiCustomerSafeItem } from "./ai-job-failure-copy.js";
+import { AI_JOB_PLAN_STEP } from "./ai-jobs.types.js";
+const OP_NOUNS = {
     page: 'Page',
     layout: 'Layout',
     form: 'Form',
@@ -21,7 +24,10 @@
     email: 'Email design',
     template: 'Page template',
     campaign: 'Email campaign',
-    workflow: 'Automation'
+    workflow: 'Automation',
+    // A guided start's first posts and products (AGL-3676).
+    posts: 'Blog',
+    products: 'Store'
 };
 /** What an operation is called at the start of a row: its own noun, or the op spelled as words. */ export function aiBuildOpNoun(op) {
     const known = OP_NOUNS[op];
@@ -58,22 +64,61 @@ const STATES = {
     failed: 'failed',
     skipped: 'skipped'
 };
-/** One row an item, in the order the build planned them. */ export function aiBuildItemRows(job) {
+/**
+ * The item the build is on (AGL-3596): the one its ledger marks running, else
+ * — while the job moves — the first still pending, which is the one its runner
+ * builds next. The runner settles an item in the write that records its pass,
+ * so the item it is writing reads `pending` until it is done; read as such,
+ * every row waited and the build looked stalled. `null` when the job is not
+ * moving or nothing is left.
+ */ export function aiBuildActiveSlot(job) {
+    var _job_items, _ref;
+    var _items_find;
+    const items = (_job_items = job.items) != null ? _job_items : [];
+    const running = items.find((row)=>row.status === 'running');
+    if (running) return running.slot;
+    if (job.status !== 'queued' && job.status !== 'running') return null;
+    return (_ref = (_items_find = items.find((row)=>row.status === 'pending')) == null ? void 0 : _items_find.slot) != null ? _ref : null;
+}
+/**
+ * When the active item started: when the last item before it settled, which
+ * the ledger records, else when the build step started — the first item's
+ * start, and the best a ledger written before settling was recorded has.
+ */ export function aiBuildActiveStartedAt(job) {
+    var _job_items, _job_steps, _ref;
+    let latest = null;
+    for (const row of (_job_items = job.items) != null ? _job_items : []){
+        const at = row.settledAt ? Date.parse(row.settledAt) : NaN;
+        if (Number.isFinite(at) && (!latest || at > latest.at)) latest = {
+            at,
+            iso: row.settledAt
+        };
+    }
+    if (latest) return latest.iso;
+    const step = ((_job_steps = job.steps) != null ? _job_steps : []).find((one)=>one.name !== AI_JOB_PLAN_STEP && one.startedAt);
+    return (_ref = step == null ? void 0 : step.startedAt) != null ? _ref : null;
+}
+/** One row an item, in the order the build planned them; the item it is on is the active one. */ export function aiBuildItemRows(job) {
     var _job_items;
-    return ((_job_items = job.items) != null ? _job_items : []).map((row)=>{
+    const active = aiBuildActiveSlot(job);
+    return ((_job_items = job.items) != null ? _job_items : []).map((ledger)=>{
         var _STATES_row_status;
         var _row_failure;
+        // A building rule's own words never reach a customer (AGL-3596).
+        const row = aiCustomerSafeItem(ledger);
         const parts = [];
         if (row.status === 'failed' && ((_row_failure = row.failure) == null ? void 0 : _row_failure.message)) parts.push(row.failure.message);
         if (row.note) parts.push(row.note);
         const refund = aiBuildItemRefundCopy(row);
         if (refund) parts.push(refund);
-        return {
+        return _extends({
             slot: row.slot,
             label: `${aiBuildOpNoun(row.op)}: ${row.label}`,
-            state: (_STATES_row_status = STATES[row.status]) != null ? _STATES_row_status : 'waiting',
+            state: row.slot === active ? 'active' : (_STATES_row_status = STATES[row.status]) != null ? _STATES_row_status : 'waiting',
             detail: parts.length ? parts.join(' ') : null
-        };
+        }, row.slot === active ? {
+            startedAt: aiBuildActiveStartedAt(job)
+        } : {});
     });
 }
 /** How a build came out, in one line: "4 of 5 built; 1 failed." `null` while it runs. */ export function aiBuildOutcomeLine(job) {

package/src/lib/model/ai-build-progress.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-build-progress.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 { AiJobItemLedger, AiJobSummary } from './ai-jobs.types'\n\n/**\n * What a `build` job shows of each item (AGL-3616), wherever it is shown —\n * the AI jobs drawer, the job's own page, the chat card: the item, where it\n * stands, what it cost, and what became of its credits when it failed.\n *\n * Pure: no React, no request.\n */\n\n/** Where one item stands, as a row's icon reads it. */\nexport type AiBuildItemRowState = 'done' | 'active' | 'waiting' | 'failed' | 'skipped'\n\nexport interface AiBuildItemRow {\n  slot: string\n  /** \"Page: About\", \"Form: Contact\". */\n  label: string\n  state: AiBuildItemRowState\n  /** What the person should know: the failure, the note, what was given back. */\n  detail: string | null\n}\n\nconst OP_NOUNS: Readonly<Record<string, string>> = {\n  page: 'Page',\n  layout: 'Layout',\n  form: 'Form',\n  component: 'Component',\n  email: 'Email design',\n  template: 'Page template',\n  campaign: 'Email campaign',\n  workflow: 'Automation',\n}\n\n/** What an operation is called at the start of a row: its own noun, or the op spelled as words. */\nexport function aiBuildOpNoun(op: string): string {\n  const known = OP_NOUNS[op]\n  if (known) return known\n  const words = op.replace(/[-_]+/g, ' ').trim()\n  return words ? `${words[0].toUpperCase()}${words.slice(1)}` : 'Item'\n}\n\n/**\n * What became of a failed item's credits (AGL-3616), in the words every\n * surface uses for a failure on our side: \"This one’s on us — you weren’t\n * charged.\" A failure that was not ours — the model declining, a site at its\n * allowance — says what it used, which was charged. `null` for an item that\n * did not fail.\n */\nexport function aiBuildItemRefundCopy(\n  row: Pick<AiJobItemLedger, 'status' | 'failure' | 'creditsRefunded' | 'creditsSpent'>,\n): string | null {\n  if (row.status !== 'failed') return null\n  if (row.failure?.ours) {\n    const refunded = Math.max(0, Math.floor(row.creditsRefunded ?? 0))\n    if (refunded > 0) {\n      return `This one’s on us — you weren’t charged. The ${refunded} ${refunded === 1 ? 'credit' : 'credits'} it used ${refunded === 1 ? 'is' : 'are'} back in your AI credits.`\n    }\n    return 'This one’s on us — you weren’t charged.'\n  }\n  const spent = Math.max(0, Math.floor(row.creditsSpent ?? 0))\n  return spent > 0 ? `It used ${spent} ${spent === 1 ? 'credit' : 'credits'}.` : null\n}\n\nconst STATES: Readonly<Record<AiJobItemLedger['status'], AiBuildItemRowState>> = {\n  pending: 'waiting',\n  running: 'active',\n  succeeded: 'done',\n  degraded: 'done',\n  failed: 'failed',\n  skipped: 'skipped',\n}\n\n/** One row an item, in the order the build planned them. */\nexport function aiBuildItemRows(job: Pick<AiJobSummary, 'items'>): AiBuildItemRow[] {\n  return (job.items ?? []).map((row) => {\n    const parts: string[] = []\n    if (row.status === 'failed' && row.failure?.message) parts.push(row.failure.message)\n    if (row.note) parts.push(row.note)\n    const refund = aiBuildItemRefundCopy(row)\n    if (refund) parts.push(refund)\n    return {\n      slot: row.slot,\n      label: `${aiBuildOpNoun(row.op)}: ${row.label}`,\n      state: STATES[row.status] ?? 'waiting',\n      detail: parts.length ? parts.join(' ') : null,\n    }\n  })\n}\n\n/** How a build came out, in one line: \"4 of 5 built; 1 failed.\" `null` while it runs. */\nexport function aiBuildOutcomeLine(job: Pick<AiJobSummary, 'items' | 'status'>): string | null {\n  const items = job.items ?? []\n  if (!items.length || (job.status !== 'done' && job.status !== 'failed')) return null\n  const built = items.filter((row) => row.status === 'succeeded' || row.status === 'degraded').length\n  const failed = items.filter((row) => row.status === 'failed').length\n  const skipped = items.filter((row) => row.status === 'skipped').length\n  const tail = [failed ? `${failed} failed` : '', skipped ? `${skipped} not built` : ''].filter(Boolean)\n  return `${built} of ${items.length} built${tail.length ? `; ${tail.join(', ')}` : ''}.`\n}\n\n/** Whether a finished build — or a site that built part of itself — has failed items to try again. */\nexport function aiBuildCanRetry(job: Pick<AiJobSummary, 'kind' | 'status' | 'items'>): boolean {\n  // A site that built nothing starts over from its own answers instead.\n  const finished = job.kind === 'build' ? job.status === 'done' || job.status === 'failed' : job.kind === 'site' && job.status === 'done'\n  return (\n    finished &&\n    (job.items ?? []).some((row) => row.status === 'failed' || (row.status === 'skipped' && !row.degradedBy?.length))\n  )\n}\n\n/**\n * What a guided start that built part of its site says (AGL-3616), in the\n * words every surface uses: \"Built 1 of 2 pages. Home couldn’t be built —\n * that one’s on us…\". `null` when every page was built, or none was.\n */\nexport function aiSitePartialCopy(job: Pick<AiJobSummary, 'items' | 'status'>): string | null {\n  const pages = (job.items ?? []).filter((row) => row.op === 'page')\n  const built = pages.filter((row) => row.status === 'succeeded' || row.status === 'degraded')\n  const unbuilt = (job.items ?? []).filter((row) => row.status === 'failed' || row.status === 'skipped')\n  if (job.status !== 'done' || !unbuilt.length || !built.length) return null\n  const names = unbuilt.map((row) => (row.op === 'page' ? row.label : `The ${aiBuildOpNoun(row.op).toLowerCase()} “${row.label}”`))\n  const list = names.length === 1 ? names[0] : `${names.slice(0, -1).join(', ')} and ${names[names.length - 1]}`\n  const refunded = unbuilt.reduce((total, row) => total + Math.max(0, Math.floor(row.creditsRefunded ?? 0)), 0)\n  const back = refunded > 0 ? ` The ${refunded} ${refunded === 1 ? 'credit' : 'credits'} it used ${refunded === 1 ? 'is' : 'are'} back in your AI credits.` : ''\n  // Only a failure on our side says so; a part the AI declined or an allowance\n  // stopped was charged for what it used, and the row says that.\n  const ours = unbuilt.every((row) => row.status === 'skipped' || row.failure?.ours === true)\n  const why = ours ? ` — that one’s on us, you weren’t charged for ${unbuilt.length === 1 ? 'it' : 'them'}.` : '.'\n  return `Built ${built.length} of ${pages.length} ${pages.length === 1 ? 'page' : 'pages'}. ${list} couldn’t be built${why}${back} Try again builds only what failed.`\n}\n"],"names":["OP_NOUNS","page","layout","form","component","email","template","campaign","workflow","aiBuildOpNoun","op","known","words","replace","trim","toUpperCase","slice","aiBuildItemRefundCopy","row","status","failure","ours","refunded","Math","max","floor","creditsRefunded","spent","creditsSpent","STATES","pending","running","succeeded","degraded","failed","skipped","aiBuildItemRows","job","items","map","parts","message","push","note","refund","slot","label","state","detail","length","join","aiBuildOutcomeLine","built","filter","tail","Boolean","aiBuildCanRetry","finished","kind","some","degradedBy","aiSitePartialCopy","pages","unbuilt","names","toLowerCase","list","reduce","total","back","every","why"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-build-progress.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 { aiCustomerSafeItem } from './ai-job-failure-copy'\nimport { AI_JOB_PLAN_STEP, type AiJobItemLedger, type AiJobSummary } from './ai-jobs.types'\n\n/**\n * What a `build` job shows of each item (AGL-3616), wherever it is shown —\n * the AI jobs drawer, the job's own page, the chat card: the item, where it\n * stands, what it cost, and what became of its credits when it failed.\n *\n * Pure: no React, no request.\n */\n\n/** Where one item stands, as a row's icon reads it. */\nexport type AiBuildItemRowState = 'done' | 'active' | 'waiting' | 'failed' | 'skipped'\n\nexport interface AiBuildItemRow {\n  slot: string\n  /** \"Page: About\", \"Form: Contact\". */\n  label: string\n  state: AiBuildItemRowState\n  /** What the person should know: the failure, the note, what was given back. */\n  detail: string | null\n  /** When the active item started, for the elapsed time beside it; absent on every other row. */\n  startedAt?: string | null\n}\n\nconst OP_NOUNS: Readonly<Record<string, string>> = {\n  page: 'Page',\n  layout: 'Layout',\n  form: 'Form',\n  component: 'Component',\n  email: 'Email design',\n  template: 'Page template',\n  campaign: 'Email campaign',\n  workflow: 'Automation',\n  // A guided start's first posts and products (AGL-3676).\n  posts: 'Blog',\n  products: 'Store',\n}\n\n/** What an operation is called at the start of a row: its own noun, or the op spelled as words. */\nexport function aiBuildOpNoun(op: string): string {\n  const known = OP_NOUNS[op]\n  if (known) return known\n  const words = op.replace(/[-_]+/g, ' ').trim()\n  return words ? `${words[0].toUpperCase()}${words.slice(1)}` : 'Item'\n}\n\n/**\n * What became of a failed item's credits (AGL-3616), in the words every\n * surface uses for a failure on our side: \"This one’s on us — you weren’t\n * charged.\" A failure that was not ours — the model declining, a site at its\n * allowance — says what it used, which was charged. `null` for an item that\n * did not fail.\n */\nexport function aiBuildItemRefundCopy(\n  row: Pick<AiJobItemLedger, 'status' | 'failure' | 'creditsRefunded' | 'creditsSpent'>,\n): string | null {\n  if (row.status !== 'failed') return null\n  if (row.failure?.ours) {\n    const refunded = Math.max(0, Math.floor(row.creditsRefunded ?? 0))\n    if (refunded > 0) {\n      return `This one’s on us — you weren’t charged. The ${refunded} ${refunded === 1 ? 'credit' : 'credits'} it used ${refunded === 1 ? 'is' : 'are'} back in your AI credits.`\n    }\n    return 'This one’s on us — you weren’t charged.'\n  }\n  const spent = Math.max(0, Math.floor(row.creditsSpent ?? 0))\n  return spent > 0 ? `It used ${spent} ${spent === 1 ? 'credit' : 'credits'}.` : null\n}\n\nconst STATES: Readonly<Record<AiJobItemLedger['status'], AiBuildItemRowState>> = {\n  pending: 'waiting',\n  running: 'active',\n  succeeded: 'done',\n  degraded: 'done',\n  failed: 'failed',\n  skipped: 'skipped',\n}\n\n/**\n * The item the build is on (AGL-3596): the one its ledger marks running, else\n * — while the job moves — the first still pending, which is the one its runner\n * builds next. The runner settles an item in the write that records its pass,\n * so the item it is writing reads `pending` until it is done; read as such,\n * every row waited and the build looked stalled. `null` when the job is not\n * moving or nothing is left.\n */\nexport function aiBuildActiveSlot(\n  job: Pick<AiJobSummary, 'items'> & Partial<Pick<AiJobSummary, 'status'>>,\n): string | null {\n  const items = job.items ?? []\n  const running = items.find((row) => row.status === 'running')\n  if (running) return running.slot\n  if (job.status !== 'queued' && job.status !== 'running') return null\n  return items.find((row) => row.status === 'pending')?.slot ?? null\n}\n\n/**\n * When the active item started: when the last item before it settled, which\n * the ledger records, else when the build step started — the first item's\n * start, and the best a ledger written before settling was recorded has.\n */\nexport function aiBuildActiveStartedAt(\n  job: Pick<AiJobSummary, 'items'> & Partial<Pick<AiJobSummary, 'steps'>>,\n): string | null {\n  let latest: { at: number; iso: string } | null = null\n  for (const row of job.items ?? []) {\n    const at = row.settledAt ? Date.parse(row.settledAt) : NaN\n    if (Number.isFinite(at) && (!latest || at > latest.at)) latest = { at, iso: row.settledAt as string }\n  }\n  if (latest) return latest.iso\n  const step = (job.steps ?? []).find((one) => one.name !== AI_JOB_PLAN_STEP && one.startedAt)\n  return step?.startedAt ?? null\n}\n\n/** One row an item, in the order the build planned them; the item it is on is the active one. */\nexport function aiBuildItemRows(\n  job: Pick<AiJobSummary, 'items'> & Partial<Pick<AiJobSummary, 'status' | 'steps'>>,\n): AiBuildItemRow[] {\n  const active = aiBuildActiveSlot(job)\n  return (job.items ?? []).map((ledger) => {\n    // A building rule's own words never reach a customer (AGL-3596).\n    const row = aiCustomerSafeItem(ledger)\n    const parts: string[] = []\n    if (row.status === 'failed' && row.failure?.message) parts.push(row.failure.message)\n    if (row.note) parts.push(row.note)\n    const refund = aiBuildItemRefundCopy(row)\n    if (refund) parts.push(refund)\n    return {\n      slot: row.slot,\n      label: `${aiBuildOpNoun(row.op)}: ${row.label}`,\n      state: row.slot === active ? 'active' : (STATES[row.status] ?? 'waiting'),\n      detail: parts.length ? parts.join(' ') : null,\n      ...(row.slot === active ? { startedAt: aiBuildActiveStartedAt(job) } : {}),\n    }\n  })\n}\n\n/** How a build came out, in one line: \"4 of 5 built; 1 failed.\" `null` while it runs. */\nexport function aiBuildOutcomeLine(job: Pick<AiJobSummary, 'items' | 'status'>): string | null {\n  const items = job.items ?? []\n  if (!items.length || (job.status !== 'done' && job.status !== 'failed')) return null\n  const built = items.filter((row) => row.status === 'succeeded' || row.status === 'degraded').length\n  const failed = items.filter((row) => row.status === 'failed').length\n  const skipped = items.filter((row) => row.status === 'skipped').length\n  const tail = [failed ? `${failed} failed` : '', skipped ? `${skipped} not built` : ''].filter(Boolean)\n  return `${built} of ${items.length} built${tail.length ? `; ${tail.join(', ')}` : ''}.`\n}\n\n/** Whether a finished build — or a site that built part of itself — has failed items to try again. */\nexport function aiBuildCanRetry(job: Pick<AiJobSummary, 'kind' | 'status' | 'items'>): boolean {\n  // A site that built nothing starts over from its own answers instead.\n  const finished = job.kind === 'build' ? job.status === 'done' || job.status === 'failed' : job.kind === 'site' && job.status === 'done'\n  return (\n    finished &&\n    (job.items ?? []).some((row) => row.status === 'failed' || (row.status === 'skipped' && !row.degradedBy?.length))\n  )\n}\n\n/**\n * What a guided start that built part of its site says (AGL-3616), in the\n * words every surface uses: \"Built 1 of 2 pages. Home couldn’t be built —\n * that one’s on us…\". `null` when every page was built, or none was.\n */\nexport function aiSitePartialCopy(job: Pick<AiJobSummary, 'items' | 'status'>): string | null {\n  const pages = (job.items ?? []).filter((row) => row.op === 'page')\n  const built = pages.filter((row) => row.status === 'succeeded' || row.status === 'degraded')\n  const unbuilt = (job.items ?? []).filter((row) => row.status === 'failed' || row.status === 'skipped')\n  if (job.status !== 'done' || !unbuilt.length || !built.length) return null\n  const names = unbuilt.map((row) => (row.op === 'page' ? row.label : `The ${aiBuildOpNoun(row.op).toLowerCase()} “${row.label}”`))\n  const list = names.length === 1 ? names[0] : `${names.slice(0, -1).join(', ')} and ${names[names.length - 1]}`\n  const refunded = unbuilt.reduce((total, row) => total + Math.max(0, Math.floor(row.creditsRefunded ?? 0)), 0)\n  const back = refunded > 0 ? ` The ${refunded} ${refunded === 1 ? 'credit' : 'credits'} it used ${refunded === 1 ? 'is' : 'are'} back in your AI credits.` : ''\n  // Only a failure on our side says so; a part the AI declined or an allowance\n  // stopped was charged for what it used, and the row says that.\n  const ours = unbuilt.every((row) => row.status === 'skipped' || row.failure?.ours === true)\n  const why = ours ? ` — that one’s on us, you weren’t charged for ${unbuilt.length === 1 ? 'it' : 'them'}.` : '.'\n  return `Built ${built.length} of ${pages.length} ${pages.length === 1 ? 'page' : 'pages'}. ${list} couldn’t be built${why}${back} Try again builds only what failed.`\n}\n"],"names":["aiCustomerSafeItem","AI_JOB_PLAN_STEP","OP_NOUNS","page","layout","form","component","email","template","campaign","workflow","posts","products","aiBuildOpNoun","op","known","words","replace","trim","toUpperCase","slice","aiBuildItemRefundCopy","row","status","failure","ours","refunded","Math","max","floor","creditsRefunded","spent","creditsSpent","STATES","pending","running","succeeded","degraded","failed","skipped","aiBuildActiveSlot","job","items","find","slot","aiBuildActiveStartedAt","latest","at","settledAt","Date","parse","NaN","Number","isFinite","iso","step","steps","one","name","startedAt","aiBuildItemRows","active","map","ledger","parts","message","push","note","refund","label","state","detail","length","join","aiBuildOutcomeLine","built","filter","tail","Boolean","aiBuildCanRetry","finished","kind","some","degradedBy","aiSitePartialCopy","pages","unbuilt","names","toLowerCase","list","reduce","total","back","every","why"],"mappings":"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"}

package/src/lib/model/ai-edit-job.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @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.
+ */
+/**
+ * An `edit` job (AGL-3616): a change to a page or a layout the site already
+ * has, asked for in words, made without the Besigner open.
+ *
+ * It speaks the Assist edit rung's own protocol — the same tool, the same
+ * closed world of element ids, the same validators, the same canvas mutators
+ * — against the stored document instead of an open canvas, and the change is
+ * saved where no visitor sees it:
+ *
+ *  - on a plan with version history, as a NEW version beside the one it
+ *    started from, which becomes the page's current version only when the
+ *    page is not published (no visitor reaches it); a published page's and a
+ *    layout's current version never move;
+ *  - on a plan without it, in place, and only on a version no visitor
+ *    reaches — an unpublished page's, or a version that is not the current
+ *    one. Anything else is refused, before anything is spent.
+ *
+ * Pure: the inputs, the sentences a person reads, and the outline the model
+ * is shown. The runner is `jobs/ai-job-edit-step.ts`.
+ */
+/** The documents an edit job changes: those that keep versions and render on a site. */
+export declare const AI_EDIT_TARGET_KINDS: readonly ["screen", "layout"];
+export type AiEditTargetKind = (typeof AI_EDIT_TARGET_KINDS)[number];
+export interface AiEditJobInputs {
+    /** The page's or layout's document id, on the job's site. */
+    target: string;
+    /** Which collection the id is in; both are looked in, a page's first, when absent. */
+    targetKind: AiEditTargetKind | null;
+    /** The version to start from; the document's current version when absent. */
+    versionId: string | null;
+}
+export declare const AI_EDIT_TARGET_REQUIRED_COPY = "Name the page or layout to change.";
+export declare const AI_EDIT_TARGET_KIND_COPY = "inputs.targetKind must be screen or layout";
+export declare const AI_EDIT_VERSION_ID_COPY = "inputs.versionId must name a version of the page or layout";
+/** A job's inputs read, or the sentence that says what is wrong with them. */
+export declare function parseAiEditJobInputs(inputs: Readonly<Record<string, unknown>> | null | undefined): AiEditJobInputs | string;
+export declare const AI_EDIT_NO_SITE_COPY = "Open the site the change is for before starting the job";
+export declare const AI_EDIT_GONE_COPY = "The page or layout to change is not on the site.";
+export declare const AI_EDIT_VERSION_GONE_COPY = "The version to start from is no longer on the page or layout.";
+export declare const AI_EDIT_EMAIL_COPY = "That is an email design, not a page \u2014 change it from Emails \u2192 Templates.";
+export declare const AI_EDIT_NO_NODES_COPY = "That version has nothing on it to change.";
+/**
+ * A change that would land on a version visitors see, on a plan without
+ * version history: the versions route's own sentence, after what it means
+ * here.
+ */
+export declare const AI_EDIT_NEEDS_VERSIONING_COPY = "Visitors see that version, so the change has to go into a new version beside it. Version history requires a Pro plan \u2014 see Billing to upgrade.";
+/** The model answered and no change survived its checks, even after its re-ask. */
+export declare const AI_EDIT_NOTHING_COPY = "No change could be made from that request. Say which part of the page to change, the way it reads on the page, and ask again.";
+/** The stored document moved under the change between the read and the write. */
+export declare const AI_EDIT_STALE_COPY = "The page changed while this edit was being written, so nothing was saved. Ask again.";
+/** The canvas's own guards refused part of the change. */
+export declare const AI_EDIT_REFUSED_COPY = "The editor refused part of this change, so none of it was saved.";
+/** What a version an edit job makes is called, from the change's one-line summary. */
+export declare const AI_EDIT_VERSION_PREFIX = "AI edit";
+/** The longest label a version takes, as the versions route cuts one. */
+export declare const AI_EDIT_VERSION_NAME_MAX_CHARS = 200;
+export declare function aiEditVersionName(summary: string): string;
+/** Where the change landed, which decides what the output's note says. */
+export type AiEditPlacement = 
+/** A new version, now the unpublished page's current one. */
+'new-current'
+/** A new version beside the one it started from, which is unchanged. */
+ | 'new-beside'
+/** The version it started from, changed in place: one no visitor reaches. */
+ | 'in-place';
+/** The output's note: where the change is, that nothing visitors see moved, and what was left out. */
+export declare function aiEditOutputNote(input: {
+    kind: AiEditTargetKind;
+    placement: AiEditPlacement;
+    leftOut: readonly string[];
+}): string;
+/** What the output says of search fields a published page keeps on the page itself. */
+export declare const AI_EDIT_SEO_LEFT_OUT = "the search title and description, which a published page uses as soon as they are saved \u2014 change them in Page properties";
+/** What the output says of a part a job cannot save on its own. */
+export declare const AI_EDIT_COMPONENT_LEFT_OUT = "saving part of the page as a reusable component, which is done in the editor";
+/**
+ * The stored document as the outline the edit rung's protocol reads
+ * (`parseAssistEditContext` holds it to its limits): the document root, then
+ * every element level by level — each after its parent, so every ancestor
+ * chain the check walks is whole — until the rung's cap.
+ *
+ * In the editor, an outline is the neighborhood of what the author selected.
+ * A job has no selection, so it is the TOP of the document, read breadth
+ * first: every section, and as deep inside each as the cap reaches. Each
+ * element keeps its real child count and the document its real size, so the
+ * prompt can say how much the outline leaves out. `null` without a root.
+ */
+export declare function aiEditJobOutline(nodes: Readonly<Record<string, unknown>>): {
+    selectedId: null;
+    total: number;
+    nodes: Array<Record<string, unknown>>;
+} | null;

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

@@ -0,0 +1,157 @@
+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 { CANVAS_ROOT_ELEMENT_ID } from "@aglyn/aglyn/foundation/constants/canvas";
+import { ASSIST_EDIT_CONTEXT_MAX_NODES } from "./assist-edit.js";
+/**
+ * An `edit` job (AGL-3616): a change to a page or a layout the site already
+ * has, asked for in words, made without the Besigner open.
+ *
+ * It speaks the Assist edit rung's own protocol — the same tool, the same
+ * closed world of element ids, the same validators, the same canvas mutators
+ * — against the stored document instead of an open canvas, and the change is
+ * saved where no visitor sees it:
+ *
+ *  - on a plan with version history, as a NEW version beside the one it
+ *    started from, which becomes the page's current version only when the
+ *    page is not published (no visitor reaches it); a published page's and a
+ *    layout's current version never move;
+ *  - on a plan without it, in place, and only on a version no visitor
+ *    reaches — an unpublished page's, or a version that is not the current
+ *    one. Anything else is refused, before anything is spent.
+ *
+ * Pure: the inputs, the sentences a person reads, and the outline the model
+ * is shown. The runner is `jobs/ai-job-edit-step.ts`.
+ */ /** The documents an edit job changes: those that keep versions and render on a site. */ export const AI_EDIT_TARGET_KINDS = [
+    'screen',
+    'layout'
+];
+const DOCUMENT_ID = /^[A-Za-z0-9_-]{1,64}$/;
+export const AI_EDIT_TARGET_REQUIRED_COPY = 'Name the page or layout to change.';
+export const AI_EDIT_TARGET_KIND_COPY = 'inputs.targetKind must be screen or layout';
+export const AI_EDIT_VERSION_ID_COPY = 'inputs.versionId must name a version of the page or layout';
+/** A job's inputs read, or the sentence that says what is wrong with them. */ export function parseAiEditJobInputs(inputs) {
+    const target = inputs == null ? void 0 : inputs['target'];
+    if (typeof target !== 'string' || !DOCUMENT_ID.test(target)) return AI_EDIT_TARGET_REQUIRED_COPY;
+    const kind = inputs == null ? void 0 : inputs['targetKind'];
+    if (kind != null && kind !== '' && !AI_EDIT_TARGET_KINDS.includes(kind)) {
+        return AI_EDIT_TARGET_KIND_COPY;
+    }
+    const versionId = inputs == null ? void 0 : inputs['versionId'];
+    if (versionId != null && versionId !== '' && (typeof versionId !== 'string' || !DOCUMENT_ID.test(versionId))) {
+        return AI_EDIT_VERSION_ID_COPY;
+    }
+    return {
+        target,
+        targetKind: kind ? kind : null,
+        versionId: typeof versionId === 'string' && versionId ? versionId : null
+    };
+}
+// ── What a person reads ───────────────────────────────────────────────────
+export const AI_EDIT_NO_SITE_COPY = 'Open the site the change is for before starting the job';
+export const AI_EDIT_GONE_COPY = 'The page or layout to change is not on the site.';
+export const AI_EDIT_VERSION_GONE_COPY = 'The version to start from is no longer on the page or layout.';
+export const AI_EDIT_EMAIL_COPY = 'That is an email design, not a page — change it from Emails → Templates.';
+export const AI_EDIT_NO_NODES_COPY = 'That version has nothing on it to change.';
+/**
+ * A change that would land on a version visitors see, on a plan without
+ * version history: the versions route's own sentence, after what it means
+ * here.
+ */ export const AI_EDIT_NEEDS_VERSIONING_COPY = 'Visitors see that version, so the change has to go into a new version beside it. Version history requires a Pro plan — see Billing to upgrade.';
+/** The model answered and no change survived its checks, even after its re-ask. */ export const AI_EDIT_NOTHING_COPY = 'No change could be made from that request. Say which part of the page to change, the way it reads on the page, and ask again.';
+/** The stored document moved under the change between the read and the write. */ export const AI_EDIT_STALE_COPY = 'The page changed while this edit was being written, so nothing was saved. Ask again.';
+/** The canvas's own guards refused part of the change. */ export const AI_EDIT_REFUSED_COPY = 'The editor refused part of this change, so none of it was saved.';
+/** What a version an edit job makes is called, from the change's one-line summary. */ export const AI_EDIT_VERSION_PREFIX = 'AI edit';
+/** The longest label a version takes, as the versions route cuts one. */ export const AI_EDIT_VERSION_NAME_MAX_CHARS = 200;
+export function aiEditVersionName(summary) {
+    const said = String(summary != null ? summary : '').replace(/\s+/g, ' ').trim();
+    return (said ? `${AI_EDIT_VERSION_PREFIX}: ${said}` : AI_EDIT_VERSION_PREFIX).slice(0, AI_EDIT_VERSION_NAME_MAX_CHARS);
+}
+const NOUNS = {
+    screen: 'page',
+    layout: 'layout'
+};
+/** The output's note: where the change is, that nothing visitors see moved, and what was left out. */ export function aiEditOutputNote(input) {
+    const noun = NOUNS[input.kind];
+    const where = input.placement === 'new-current' ? `Saved as a new version, now this ${noun}’s current one. The ${noun} is not published, so no visitor sees it until you publish it.` : input.placement === 'new-beside' ? `Saved as a new version beside the one it started from. Nothing visitors see has changed: open it to review it, and publish it when it is ready.` : `Saved on the version it started from, which no visitor sees: open it to review it.`;
+    const leftOut = input.leftOut.length ? ` Left out: ${input.leftOut.join('; ')}.` : '';
+    return `${where}${leftOut}`.slice(0, 1000);
+}
+/** What the output says of search fields a published page keeps on the page itself. */ export const AI_EDIT_SEO_LEFT_OUT = 'the search title and description, which a published page uses as soon as they are saved — change them in Page properties';
+/** What the output says of a part a job cannot save on its own. */ export const AI_EDIT_COMPONENT_LEFT_OUT = 'saving part of the page as a reusable component, which is done in the editor';
+// ── The outline the model is shown ────────────────────────────────────────
+const isRecord = (value)=>typeof value === 'object' && value !== null && !Array.isArray(value);
+/**
+ * The stored document as the outline the edit rung's protocol reads
+ * (`parseAssistEditContext` holds it to its limits): the document root, then
+ * every element level by level — each after its parent, so every ancestor
+ * chain the check walks is whole — until the rung's cap.
+ *
+ * In the editor, an outline is the neighborhood of what the author selected.
+ * A job has no selection, so it is the TOP of the document, read breadth
+ * first: every section, and as deep inside each as the cap reaches. Each
+ * element keeps its real child count and the document its real size, so the
+ * prompt can say how much the outline leaves out. `null` without a root.
+ */ export function aiEditJobOutline(nodes) {
+    const root = nodes[CANVAS_ROOT_ELEMENT_ID];
+    if (!isRecord(root)) return null;
+    const childrenOf = (node)=>Array.isArray(node['nodes']) ? node['nodes'].filter((id)=>typeof id === 'string' && isRecord(nodes[id])) : [];
+    const order = [
+        {
+            id: CANVAS_ROOT_ELEMENT_ID,
+            parentId: null,
+            index: 0
+        }
+    ];
+    const seen = new Set([
+        CANVAS_ROOT_ELEMENT_ID
+    ]);
+    // Every element reachable through child lists, for the document's size.
+    let total = 1;
+    for(let at = 0; at < order.length; at += 1){
+        const { id } = order[at];
+        childrenOf(nodes[id]).forEach((child, index)=>{
+            if (seen.has(child)) return;
+            seen.add(child);
+            total += 1;
+            order.push({
+                id: child,
+                parentId: id,
+                index
+            });
+        });
+    }
+    return {
+        selectedId: null,
+        total,
+        nodes: order.slice(0, ASSIST_EDIT_CONTEXT_MAX_NODES).map(({ id, parentId, index })=>{
+            const node = nodes[id];
+            return _extends({
+                id,
+                componentId: node['componentId'],
+                parentId,
+                index,
+                childCount: childrenOf(node).length
+            }, typeof node['name'] === 'string' && node['name'] ? {
+                name: node['name']
+            } : {}, isRecord(node['props']) ? {
+                props: node['props']
+            } : {});
+        })
+    };
+}
+
+//# sourceMappingURL=ai-edit-job.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-edit-job.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { CANVAS_ROOT_ELEMENT_ID } from '@aglyn/aglyn/foundation/constants/canvas'\nimport { ASSIST_EDIT_CONTEXT_MAX_NODES } from './assist-edit'\n\n/**\n * An `edit` job (AGL-3616): a change to a page or a layout the site already\n * has, asked for in words, made without the Besigner open.\n *\n * It speaks the Assist edit rung's own protocol — the same tool, the same\n * closed world of element ids, the same validators, the same canvas mutators\n * — against the stored document instead of an open canvas, and the change is\n * saved where no visitor sees it:\n *\n *  - on a plan with version history, as a NEW version beside the one it\n *    started from, which becomes the page's current version only when the\n *    page is not published (no visitor reaches it); a published page's and a\n *    layout's current version never move;\n *  - on a plan without it, in place, and only on a version no visitor\n *    reaches — an unpublished page's, or a version that is not the current\n *    one. Anything else is refused, before anything is spent.\n *\n * Pure: the inputs, the sentences a person reads, and the outline the model\n * is shown. The runner is `jobs/ai-job-edit-step.ts`.\n */\n\n/** The documents an edit job changes: those that keep versions and render on a site. */\nexport const AI_EDIT_TARGET_KINDS = ['screen', 'layout'] as const\nexport type AiEditTargetKind = (typeof AI_EDIT_TARGET_KINDS)[number]\n\nexport interface AiEditJobInputs {\n  /** The page's or layout's document id, on the job's site. */\n  target: string\n  /** Which collection the id is in; both are looked in, a page's first, when absent. */\n  targetKind: AiEditTargetKind | null\n  /** The version to start from; the document's current version when absent. */\n  versionId: string | null\n}\n\nconst DOCUMENT_ID = /^[A-Za-z0-9_-]{1,64}$/\n\nexport const AI_EDIT_TARGET_REQUIRED_COPY = 'Name the page or layout to change.'\nexport const AI_EDIT_TARGET_KIND_COPY = 'inputs.targetKind must be screen or layout'\nexport const AI_EDIT_VERSION_ID_COPY = 'inputs.versionId must name a version of the page or layout'\n\n/** A job's inputs read, or the sentence that says what is wrong with them. */\nexport function parseAiEditJobInputs(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n): AiEditJobInputs | string {\n  const target = inputs?.['target']\n  if (typeof target !== 'string' || !DOCUMENT_ID.test(target)) return AI_EDIT_TARGET_REQUIRED_COPY\n  const kind = inputs?.['targetKind']\n  if (kind != null && kind !== '' && !(AI_EDIT_TARGET_KINDS as readonly unknown[]).includes(kind)) {\n    return AI_EDIT_TARGET_KIND_COPY\n  }\n  const versionId = inputs?.['versionId']\n  if (versionId != null && versionId !== '' && (typeof versionId !== 'string' || !DOCUMENT_ID.test(versionId))) {\n    return AI_EDIT_VERSION_ID_COPY\n  }\n  return {\n    target,\n    targetKind: kind ? (kind as AiEditTargetKind) : null,\n    versionId: typeof versionId === 'string' && versionId ? versionId : null,\n  }\n}\n\n// ── What a person reads ───────────────────────────────────────────────────\n\nexport const AI_EDIT_NO_SITE_COPY = 'Open the site the change is for before starting the job'\nexport const AI_EDIT_GONE_COPY = 'The page or layout to change is not on the site.'\nexport const AI_EDIT_VERSION_GONE_COPY = 'The version to start from is no longer on the page or layout.'\nexport const AI_EDIT_EMAIL_COPY = 'That is an email design, not a page — change it from Emails → Templates.'\nexport const AI_EDIT_NO_NODES_COPY = 'That version has nothing on it to change.'\n\n/**\n * A change that would land on a version visitors see, on a plan without\n * version history: the versions route's own sentence, after what it means\n * here.\n */\nexport const AI_EDIT_NEEDS_VERSIONING_COPY =\n  'Visitors see that version, so the change has to go into a new version beside it. Version history requires a Pro plan — see Billing to upgrade.'\n\n/** The model answered and no change survived its checks, even after its re-ask. */\nexport const AI_EDIT_NOTHING_COPY =\n  'No change could be made from that request. Say which part of the page to change, the way it reads on the page, and ask again.'\n\n/** The stored document moved under the change between the read and the write. */\nexport const AI_EDIT_STALE_COPY =\n  'The page changed while this edit was being written, so nothing was saved. Ask again.'\n\n/** The canvas's own guards refused part of the change. */\nexport const AI_EDIT_REFUSED_COPY = 'The editor refused part of this change, so none of it was saved.'\n\n/** What a version an edit job makes is called, from the change's one-line summary. */\nexport const AI_EDIT_VERSION_PREFIX = 'AI edit'\n\n/** The longest label a version takes, as the versions route cuts one. */\nexport const AI_EDIT_VERSION_NAME_MAX_CHARS = 200\n\nexport function aiEditVersionName(summary: string): string {\n  const said = String(summary ?? '').replace(/\\s+/g, ' ').trim()\n  return (said ? `${AI_EDIT_VERSION_PREFIX}: ${said}` : AI_EDIT_VERSION_PREFIX).slice(0, AI_EDIT_VERSION_NAME_MAX_CHARS)\n}\n\n/** Where the change landed, which decides what the output's note says. */\nexport type AiEditPlacement =\n  /** A new version, now the unpublished page's current one. */\n  | 'new-current'\n  /** A new version beside the one it started from, which is unchanged. */\n  | 'new-beside'\n  /** The version it started from, changed in place: one no visitor reaches. */\n  | 'in-place'\n\nconst NOUNS: Readonly<Record<AiEditTargetKind, string>> = { screen: 'page', layout: 'layout' }\n\n/** The output's note: where the change is, that nothing visitors see moved, and what was left out. */\nexport function aiEditOutputNote(input: {\n  kind: AiEditTargetKind\n  placement: AiEditPlacement\n  leftOut: readonly string[]\n}): string {\n  const noun = NOUNS[input.kind]\n  const where =\n    input.placement === 'new-current'\n      ? `Saved as a new version, now this ${noun}’s current one. The ${noun} is not published, so no visitor sees it until you publish it.`\n      : input.placement === 'new-beside'\n        ? `Saved as a new version beside the one it started from. Nothing visitors see has changed: open it to review it, and publish it when it is ready.`\n        : `Saved on the version it started from, which no visitor sees: open it to review it.`\n  const leftOut = input.leftOut.length ? ` Left out: ${input.leftOut.join('; ')}.` : ''\n  return `${where}${leftOut}`.slice(0, 1_000)\n}\n\n/** What the output says of search fields a published page keeps on the page itself. */\nexport const AI_EDIT_SEO_LEFT_OUT =\n  'the search title and description, which a published page uses as soon as they are saved — change them in Page properties'\n\n/** What the output says of a part a job cannot save on its own. */\nexport const AI_EDIT_COMPONENT_LEFT_OUT = 'saving part of the page as a reusable component, which is done in the editor'\n\n// ── The outline the model is shown ────────────────────────────────────────\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\n/**\n * The stored document as the outline the edit rung's protocol reads\n * (`parseAssistEditContext` holds it to its limits): the document root, then\n * every element level by level — each after its parent, so every ancestor\n * chain the check walks is whole — until the rung's cap.\n *\n * In the editor, an outline is the neighborhood of what the author selected.\n * A job has no selection, so it is the TOP of the document, read breadth\n * first: every section, and as deep inside each as the cap reaches. Each\n * element keeps its real child count and the document its real size, so the\n * prompt can say how much the outline leaves out. `null` without a root.\n */\nexport function aiEditJobOutline(nodes: Readonly<Record<string, unknown>>): {\n  selectedId: null\n  total: number\n  nodes: Array<Record<string, unknown>>\n} | null {\n  const root = nodes[CANVAS_ROOT_ELEMENT_ID]\n  if (!isRecord(root)) return null\n  const childrenOf = (node: Record<string, unknown>): string[] =>\n    Array.isArray(node['nodes']) ? node['nodes'].filter((id): id is string => typeof id === 'string' && isRecord(nodes[id])) : []\n  const order: Array<{ id: string; parentId: string | null; index: number }> = [\n    { id: CANVAS_ROOT_ELEMENT_ID, parentId: null, index: 0 },\n  ]\n  const seen = new Set<string>([CANVAS_ROOT_ELEMENT_ID])\n  // Every element reachable through child lists, for the document's size.\n  let total = 1\n  for (let at = 0; at < order.length; at += 1) {\n    const { id } = order[at]\n    childrenOf(nodes[id] as Record<string, unknown>).forEach((child, index) => {\n      if (seen.has(child)) return\n      seen.add(child)\n      total += 1\n      order.push({ id: child, parentId: id, index })\n    })\n  }\n  return {\n    selectedId: null,\n    total,\n    nodes: order.slice(0, ASSIST_EDIT_CONTEXT_MAX_NODES).map(({ id, parentId, index }) => {\n      const node = nodes[id] as Record<string, unknown>\n      return {\n        id,\n        componentId: node['componentId'],\n        parentId,\n        index,\n        childCount: childrenOf(node).length,\n        ...(typeof node['name'] === 'string' && node['name'] ? { name: node['name'] } : {}),\n        ...(isRecord(node['props']) ? { props: node['props'] } : {}),\n      }\n    }),\n  }\n}\n"],"names":["CANVAS_ROOT_ELEMENT_ID","ASSIST_EDIT_CONTEXT_MAX_NODES","AI_EDIT_TARGET_KINDS","DOCUMENT_ID","AI_EDIT_TARGET_REQUIRED_COPY","AI_EDIT_TARGET_KIND_COPY","AI_EDIT_VERSION_ID_COPY","parseAiEditJobInputs","inputs","target","test","kind","includes","versionId","targetKind","AI_EDIT_NO_SITE_COPY","AI_EDIT_GONE_COPY","AI_EDIT_VERSION_GONE_COPY","AI_EDIT_EMAIL_COPY","AI_EDIT_NO_NODES_COPY","AI_EDIT_NEEDS_VERSIONING_COPY","AI_EDIT_NOTHING_COPY","AI_EDIT_STALE_COPY","AI_EDIT_REFUSED_COPY","AI_EDIT_VERSION_PREFIX","AI_EDIT_VERSION_NAME_MAX_CHARS","aiEditVersionName","summary","said","String","replace","trim","slice","NOUNS","screen","layout","aiEditOutputNote","input","noun","where","placement","leftOut","length","join","AI_EDIT_SEO_LEFT_OUT","AI_EDIT_COMPONENT_LEFT_OUT","isRecord","value","Array","isArray","aiEditJobOutline","nodes","root","childrenOf","node","filter","id","order","parentId","index","seen","Set","total","at","forEach","child","has","add","push","selectedId","map","componentId","childCount","name","props"],"mappings":"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"}

package/src/lib/model/ai-host-publish-context.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @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 { AiInsightTable } from './ai-insight';
+/**
+ * Whether a site is published and where, read off its host document — the
+ * facts an AI job must be told rather than left to infer. Pure: no read, so
+ * every job that already holds the host can use it, and the site inventory
+ * every AI job will get (AGL-3661) absorbs it rather than duplicating it.
+ */
+export interface AiHostPublishContext {
+    /** At least one page a visitor can open. */
+    published: boolean;
+    /** The address visitors use: a custom domain only once it serves, else the platform subdomain. */
+    liveUrl: string | null;
+    /** The published pages' paths, `/` first. */
+    publishedPages: string[];
+    /** When the first page went live, in ms, when the screens passed say so. */
+    firstPublishedAt: number | null;
+}
+/**
+ * `host.screens` is the routing map publishing writes — screen id to path —
+ * so its entries are exactly the pages a visitor can reach. `screens`, when a
+ * caller has the page documents, adds when the first one went live.
+ */
+export declare function aiHostPublishContext(host: Record<string, unknown> | null | undefined, screens?: ReadonlyArray<{
+    publishedAt?: unknown;
+    deletedAt?: unknown;
+}>): AiHostPublishContext;
+/** The reader id the site-status table carries. Code writes it; the model never chooses it. */
+export declare const AI_SITE_STATUS_READER = "site.status";
+/**
+ * The site's publish state as a table an insight can cite (AGL-2915's trace
+ * holds it like any other). Without it, a question about launch was answered
+ * from traffic alone, and "no views yet" was read as "not live" for a site
+ * that had been live for a minute.
+ */
+export declare function aiSiteStatusTable(context: AiHostPublishContext, ref: string): AiInsightTable;