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

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

@@ -0,0 +1,73 @@
+/**
+ * @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 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
+ * stands, what it cost, and what became of its credits when it failed.
+ *
+ * Pure: no React, no request.
+ */
+/** Where one item stands, as a row's icon reads it. */
+export type AiBuildItemRowState = 'done' | 'active' | 'waiting' | 'failed' | 'skipped';
+export interface AiBuildItemRow {
+    slot: string;
+    /** "Page: About", "Form: Contact". */
+    label: string;
+    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;
+/**
+ * What became of a failed item's credits (AGL-3616), in the words every
+ * surface uses for a failure on our side: "This one’s on us — you weren’t
+ * charged." A failure that was not ours — the model declining, a site at its
+ * allowance — says what it used, which was charged. `null` for an item that
+ * did not fail.
+ */
+export declare function aiBuildItemRefundCopy(row: Pick<AiJobItemLedger, 'status' | 'failure' | 'creditsRefunded' | 'creditsSpent'>): string | null;
+/**
+ * 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. */
+export declare function aiBuildCanRetry(job: Pick<AiJobSummary, 'kind' | 'status' | 'items'>): boolean;
+/**
+ * What a guided start that built part of its site says (AGL-3616), in the
+ * words every surface uses: "Built 1 of 2 pages. Home couldn’t be built —
+ * that one’s on us…". `null` when every page was built, or none was.
+ */
+export declare function aiSitePartialCopy(job: Pick<AiJobSummary, 'items' | 'status'>): string | null;

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

@@ -0,0 +1,170 @@
+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 { 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',
+    component: 'Component',
+    email: 'Email design',
+    template: 'Page template',
+    campaign: 'Email campaign',
+    workflow: 'Automation'
+};
+/** 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];
+    if (known) return known;
+    const words = op.replace(/[-_]+/g, ' ').trim();
+    return words ? `${words[0].toUpperCase()}${words.slice(1)}` : 'Item';
+}
+/**
+ * What became of a failed item's credits (AGL-3616), in the words every
+ * surface uses for a failure on our side: "This one’s on us — you weren’t
+ * charged." A failure that was not ours — the model declining, a site at its
+ * allowance — says what it used, which was charged. `null` for an item that
+ * did not fail.
+ */ export function aiBuildItemRefundCopy(row) {
+    var _row_creditsSpent;
+    var _row_failure;
+    if (row.status !== 'failed') return null;
+    if ((_row_failure = row.failure) == null ? void 0 : _row_failure.ours) {
+        var _row_creditsRefunded;
+        const refunded = Math.max(0, Math.floor((_row_creditsRefunded = row.creditsRefunded) != null ? _row_creditsRefunded : 0));
+        if (refunded > 0) {
+            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.`;
+        }
+        return 'This one’s on us — you weren’t charged.';
+    }
+    const spent = Math.max(0, Math.floor((_row_creditsSpent = row.creditsSpent) != null ? _row_creditsSpent : 0));
+    return spent > 0 ? `It used ${spent} ${spent === 1 ? 'credit' : 'credits'}.` : null;
+}
+const STATES = {
+    pending: 'waiting',
+    running: 'active',
+    succeeded: 'done',
+    degraded: 'done',
+    failed: 'failed',
+    skipped: 'skipped'
+};
+/**
+ * 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;
+    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 _extends({
+            slot: row.slot,
+            label: `${aiBuildOpNoun(row.op)}: ${row.label}`,
+            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) {
+    var _job_items;
+    const items = (_job_items = job.items) != null ? _job_items : [];
+    if (!items.length || job.status !== 'done' && job.status !== 'failed') return null;
+    const built = items.filter((row)=>row.status === 'succeeded' || row.status === 'degraded').length;
+    const failed = items.filter((row)=>row.status === 'failed').length;
+    const skipped = items.filter((row)=>row.status === 'skipped').length;
+    const tail = [
+        failed ? `${failed} failed` : '',
+        skipped ? `${skipped} not built` : ''
+    ].filter(Boolean);
+    return `${built} of ${items.length} built${tail.length ? `; ${tail.join(', ')}` : ''}.`;
+}
+/** Whether a finished build — or a site that built part of itself — has failed items to try again. */ export function aiBuildCanRetry(job) {
+    var _job_items;
+    // A site that built nothing starts over from its own answers instead.
+    const finished = job.kind === 'build' ? job.status === 'done' || job.status === 'failed' : job.kind === 'site' && job.status === 'done';
+    return finished && ((_job_items = job.items) != null ? _job_items : []).some((row)=>{
+        var _row_degradedBy;
+        return row.status === 'failed' || row.status === 'skipped' && !((_row_degradedBy = row.degradedBy) == null ? void 0 : _row_degradedBy.length);
+    });
+}
+/**
+ * What a guided start that built part of its site says (AGL-3616), in the
+ * words every surface uses: "Built 1 of 2 pages. Home couldn’t be built —
+ * that one’s on us…". `null` when every page was built, or none was.
+ */ export function aiSitePartialCopy(job) {
+    var _job_items, _job_items1;
+    const pages = ((_job_items = job.items) != null ? _job_items : []).filter((row)=>row.op === 'page');
+    const built = pages.filter((row)=>row.status === 'succeeded' || row.status === 'degraded');
+    const unbuilt = ((_job_items1 = job.items) != null ? _job_items1 : []).filter((row)=>row.status === 'failed' || row.status === 'skipped');
+    if (job.status !== 'done' || !unbuilt.length || !built.length) return null;
+    const names = unbuilt.map((row)=>row.op === 'page' ? row.label : `The ${aiBuildOpNoun(row.op).toLowerCase()} “${row.label}”`);
+    const list = names.length === 1 ? names[0] : `${names.slice(0, -1).join(', ')} and ${names[names.length - 1]}`;
+    const refunded = unbuilt.reduce((total, row)=>{
+        var _row_creditsRefunded;
+        return total + Math.max(0, Math.floor((_row_creditsRefunded = row.creditsRefunded) != null ? _row_creditsRefunded : 0));
+    }, 0);
+    const back = refunded > 0 ? ` The ${refunded} ${refunded === 1 ? 'credit' : 'credits'} it used ${refunded === 1 ? 'is' : 'are'} back in your AI credits.` : '';
+    // Only a failure on our side says so; a part the AI declined or an allowance
+    // stopped was charged for what it used, and the row says that.
+    const ours = unbuilt.every((row)=>{
+        var _row_failure;
+        return row.status === 'skipped' || ((_row_failure = row.failure) == null ? void 0 : _row_failure.ours) === true;
+    });
+    const why = ours ? ` — that one’s on us, you weren’t charged for ${unbuilt.length === 1 ? 'it' : 'them'}.` : '.';
+    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.`;
+}
+
+//# sourceMappingURL=ai-build-progress.js.map

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

@@ -0,0 +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 { 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}\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","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-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;

package/src/lib/model/ai-host-publish-context.js

@@ -0,0 +1,104 @@
+/**
+ * @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 { liveCustomDomain, TENANT_APEX } from "@aglyn/aglyn/app-utils/host-naming";
+const millis = (value)=>{
+    if (typeof value === 'number' && Number.isFinite(value)) return value;
+    if (value && typeof value.toMillis === 'function') {
+        return value.toMillis();
+    }
+    if (typeof value === 'string') {
+        const parsed = Date.parse(value);
+        return Number.isNaN(parsed) ? null : parsed;
+    }
+    return 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 function aiHostPublishContext(host, screens) {
+    const routes = host == null ? void 0 : host['screens'];
+    const paths = routes && typeof routes === 'object' ? [
+        ...new Set(Object.values(routes).filter((path)=>typeof path === 'string' && path.startsWith('/')))
+    ] : [];
+    paths.sort((a, b)=>a === '/' ? -1 : b === '/' ? 1 : a.localeCompare(b));
+    const domain = host ? liveCustomDomain(host) : undefined;
+    const subdomain = typeof (host == null ? void 0 : host['subdomain']) === 'string' ? host['subdomain'] : '';
+    const liveUrl = domain ? `https://${domain}` : subdomain ? `https://${subdomain}.${TENANT_APEX}` : null;
+    const firsts = (screens != null ? screens : []).filter((screen)=>!screen.deletedAt).map((screen)=>millis(screen.publishedAt)).filter((ms)=>ms !== null);
+    return {
+        published: paths.length > 0,
+        liveUrl,
+        publishedPages: paths,
+        firstPublishedAt: firsts.length ? Math.min(...firsts) : null
+    };
+}
+/** The reader id the site-status table carries. Code writes it; the model never chooses it. */ export const AI_SITE_STATUS_READER = 'site.status';
+/** At most this many paths are named; the rest are counted after them. */ const SITE_STATUS_MAX_PAGES = 12;
+/**
+ * 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 function aiSiteStatusTable(context, ref) {
+    var _context_liveUrl;
+    const pages = context.publishedPages.slice(0, SITE_STATUS_MAX_PAGES);
+    const more = context.publishedPages.length - pages.length;
+    return {
+        ref,
+        reader: AI_SITE_STATUS_READER,
+        days: 0,
+        scope: 'site',
+        title: 'Site status',
+        source: {
+            label: 'Pages',
+            path: 'screens'
+        },
+        period: null,
+        columns: [
+            {
+                key: 'figure',
+                label: 'Figure',
+                kind: 'text'
+            },
+            {
+                key: 'value',
+                label: 'Now',
+                kind: 'text'
+            }
+        ],
+        rows: [
+            {
+                figure: 'Published',
+                value: context.published ? 'Yes: visitors can open the site now' : 'No: no page is published yet'
+            },
+            {
+                figure: 'Address',
+                value: (_context_liveUrl = context.liveUrl) != null ? _context_liveUrl : 'None yet'
+            },
+            {
+                figure: 'Published pages',
+                value: pages.length ? `${pages.join(', ')}${more > 0 ? `, and ${more} more` : ''}` : 'None'
+            }
+        ],
+        omitted: 0,
+        notes: [
+            'Page views count visits, not whether the site is up: a published site with no views yet is still live.'
+        ]
+    };
+}
+
+//# sourceMappingURL=ai-host-publish-context.js.map

package/src/lib/model/ai-host-publish-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-host-publish-context.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 { liveCustomDomain, TENANT_APEX } from '@aglyn/aglyn/app-utils/host-naming'\nimport type { AiInsightTable } from './ai-insight'\n\n/**\n * Whether a site is published and where, read off its host document — the\n * facts an AI job must be told rather than left to infer. Pure: no read, so\n * every job that already holds the host can use it, and the site inventory\n * every AI job will get (AGL-3661) absorbs it rather than duplicating it.\n */\nexport interface AiHostPublishContext {\n  /** At least one page a visitor can open. */\n  published: boolean\n  /** The address visitors use: a custom domain only once it serves, else the platform subdomain. */\n  liveUrl: string | null\n  /** The published pages' paths, `/` first. */\n  publishedPages: string[]\n  /** When the first page went live, in ms, when the screens passed say so. */\n  firstPublishedAt: number | null\n}\n\nconst millis = (value: unknown): number | null => {\n  if (typeof value === 'number' && Number.isFinite(value)) return value\n  if (value && typeof (value as { toMillis?: unknown }).toMillis === 'function') {\n    return (value as { toMillis: () => number }).toMillis()\n  }\n  if (typeof value === 'string') {\n    const parsed = Date.parse(value)\n    return Number.isNaN(parsed) ? null : parsed\n  }\n  return null\n}\n\n/**\n * `host.screens` is the routing map publishing writes — screen id to path —\n * so its entries are exactly the pages a visitor can reach. `screens`, when a\n * caller has the page documents, adds when the first one went live.\n */\nexport function aiHostPublishContext(\n  host: Record<string, unknown> | null | undefined,\n  screens?: ReadonlyArray<{ publishedAt?: unknown; deletedAt?: unknown }>,\n): AiHostPublishContext {\n  const routes = host?.['screens']\n  const paths =\n    routes && typeof routes === 'object'\n      ? [...new Set(Object.values(routes as Record<string, unknown>).filter((path): path is string => typeof path === 'string' && path.startsWith('/')))]\n      : []\n  paths.sort((a, b) => (a === '/' ? -1 : b === '/' ? 1 : a.localeCompare(b)))\n  const domain = host ? liveCustomDomain(host as Parameters<typeof liveCustomDomain>[0]) : undefined\n  const subdomain = typeof host?.['subdomain'] === 'string' ? (host['subdomain'] as string) : ''\n  const liveUrl = domain ? `https://${domain}` : subdomain ? `https://${subdomain}.${TENANT_APEX}` : null\n  const firsts = (screens ?? [])\n    .filter((screen) => !screen.deletedAt)\n    .map((screen) => millis(screen.publishedAt))\n    .filter((ms): ms is number => ms !== null)\n  return {\n    published: paths.length > 0,\n    liveUrl,\n    publishedPages: paths,\n    firstPublishedAt: firsts.length ? Math.min(...firsts) : null,\n  }\n}\n\n/** The reader id the site-status table carries. Code writes it; the model never chooses it. */\nexport const AI_SITE_STATUS_READER = 'site.status'\n\n/** At most this many paths are named; the rest are counted after them. */\nconst SITE_STATUS_MAX_PAGES = 12\n\n/**\n * The site's publish state as a table an insight can cite (AGL-2915's trace\n * holds it like any other). Without it, a question about launch was answered\n * from traffic alone, and \"no views yet\" was read as \"not live\" for a site\n * that had been live for a minute.\n */\nexport function aiSiteStatusTable(context: AiHostPublishContext, ref: string): AiInsightTable {\n  const pages = context.publishedPages.slice(0, SITE_STATUS_MAX_PAGES)\n  const more = context.publishedPages.length - pages.length\n  return {\n    ref,\n    reader: AI_SITE_STATUS_READER,\n    days: 0,\n    scope: 'site',\n    title: 'Site status',\n    source: { label: 'Pages', path: 'screens' },\n    period: null,\n    columns: [\n      { key: 'figure', label: 'Figure', kind: 'text' },\n      { key: 'value', label: 'Now', kind: 'text' },\n    ],\n    rows: [\n      { figure: 'Published', value: context.published ? 'Yes: visitors can open the site now' : 'No: no page is published yet' },\n      { figure: 'Address', value: context.liveUrl ?? 'None yet' },\n      {\n        figure: 'Published pages',\n        value: pages.length ? `${pages.join(', ')}${more > 0 ? `, and ${more} more` : ''}` : 'None',\n      },\n    ],\n    omitted: 0,\n    notes: [\n      'Page views count visits, not whether the site is up: a published site with no views yet is still live.',\n    ],\n  }\n}\n"],"names":["liveCustomDomain","TENANT_APEX","millis","value","Number","isFinite","toMillis","parsed","Date","parse","isNaN","aiHostPublishContext","host","screens","routes","paths","Set","Object","values","filter","path","startsWith","sort","a","b","localeCompare","domain","undefined","subdomain","liveUrl","firsts","screen","deletedAt","map","publishedAt","ms","published","length","publishedPages","firstPublishedAt","Math","min","AI_SITE_STATUS_READER","SITE_STATUS_MAX_PAGES","aiSiteStatusTable","context","ref","pages","slice","more","reader","days","scope","title","source","label","period","columns","key","kind","rows","figure","join","omitted","notes"],"mappings":"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"}

package/src/lib/model/ai-insight.d.ts

@@ -44,10 +44,12 @@ import type { AiJob, AiJobOutput } from './ai-jobs.types';
  * weekly digest, to the members who reach its site.
  */
 /**
- * Where an insight was asked: the console page whose Assist panel asked it,
- * or the weekly digest, which no person asked.
+ * Where an insight was asked: the console page whose Assist panel — or
+ * whose "Ask AI about these numbers" card — asked it, or the weekly digest,
+ * which no person asked. A site's Marketing, Automation and Bookings pages
+ * and the workspace's own pages joined at AGL-3603.
  */
-export type AiInsightSurface = 'analytics' | 'datasets' | 'crm-reports' | 'digest';
+export type AiInsightSurface = 'analytics' | 'datasets' | 'crm-reports' | 'marketing' | 'automations' | 'bookings' | 'workspace' | 'digest';
 export declare const AI_INSIGHT_SURFACES: readonly AiInsightSurface[];
 /** The surfaces a person asks from. */
 export declare const AI_INSIGHT_ASK_SURFACES: readonly AiInsightSurface[];
@@ -55,12 +57,17 @@ export declare const AI_INSIGHT_ASK_SURFACES: readonly AiInsightSurface[];
 export declare function aiInsightSurface(inputs: Readonly<Record<string, unknown>> | null | undefined): AiInsightSurface | null;
 /**
  * The readers a surface may offer, by the first word of a reader's id. The
- * Analytics page answers about the site's traffic and what it sold, took and
- * collected; a Data page about its datasets; CRM Reports about where people
- * came from and what they did.
+ * Analytics page — and a site's dashboard — answers about the site's traffic,
+ * what it sold, took and collected, its automations' runs and its CRM
+ * pipeline; a Data page about its datasets; CRM Reports about where people
+ * came from, what they did and the pipeline; the Marketing page about what
+ * its campaigns, overlays and tests caused and earned, beside the traffic and
+ * the forms they drove; the Automation page about its runs; the Bookings page
+ * about its bookings; and the workspace's own pages about its pipeline and
+ * its datasets.
  */
 export declare const AI_INSIGHT_SURFACE_READERS: Readonly<Record<AiInsightSurface, readonly string[]>>;
-/** Whether a surface answers about one site; the Data page may answer about the whole workspace. */
+/** Whether a surface answers about one site; the Data page and the workspace's pages may answer about the whole workspace. */
 export declare function aiInsightSurfaceNeedsSite(surface: AiInsightSurface): boolean;
 /**
  * The readers a weekly digest reads, in the order the digest names them:
@@ -157,9 +164,12 @@ export declare function aiInsightOutput(job: Pick<AiJob, '$id' | 'hostId'>, reco
 /** The answer on the wire: the stored record, with nothing a client does not render. */
 export type AiInsightAnswerWire = AiInsightRecord;
 /**
- * The Assist panel's insight surface for a console path, or `null` off one.
- * A site's Analytics, Data and CRM Reports pages, and the workspace's Data
- * page; the workspace's CRM Reports reads site figures, so it is not one.
+ * The Assist panel's insight surface for a console path, or `null` off one:
+ * a site's dashboard, Analytics, Data, CRM Reports, Marketing, Automation and
+ * Bookings pages; the workspace's Data page; and the workspace's sites page
+ * and CRM Reports, which read the workspace's pipeline and datasets. The
+ * organization's Marketing page reads site figures, so it is not one — it
+ * asks about the site it is showing, through its own in-page entry.
  */
 export declare function aiInsightSurfaceForPath(pathname: string | null | undefined): {
     surface: Exclude<AiInsightSurface, 'digest'>;