@aglyn/plugins-ai 1.0.0-beta.244 → 1.0.0-beta.246

package/src/lib/jobs/ai-job-navigation-step.js

@@ -0,0 +1,439 @@
+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 { hostRoleCanWrite } from "@aglyn/aglyn/app-utils/organizations";
+import { checkEntitlement } from "@aglyn/aglyn/app-utils/plan-entitlements";
+import { decodeStoredNodes, encodeStoredNodes } from "@aglyn/aglyn/app-utils/stored-nodes";
+import { getLockdownVerdict } from "@aglyn/tenant-data-admin/server/lockdown";
+import { resolveOrgIdForHost } from "@aglyn/tenant-data-admin/server/organizations";
+import { AI_EDIT_GONE_COPY, AI_EDIT_NEEDS_VERSIONING_COPY, AI_EDIT_NO_NODES_COPY, AI_EDIT_VERSION_GONE_COPY } from "../model/ai-edit-job.js";
+import { isAiPlanNewRef } from "../model/ai-build-plan.js";
+import { AI_BUILD_MADE_INPUT } from "../model/ai-build-job.js";
+import { aiBuildStoreLayoutOf } from "../model/ai-build-store-pages.js";
+import { aiLayoutWithMenuChanges, aiMenuChangesEmpty, aiMenuChangesOf, aiMenusOf } from "../model/ai-layout-menus.js";
+import { registerAiJobAdmission } from "./ai-job-admission.js";
+import { aiOriginJobId } from "./ai-job-draft-ids.js";
+import { aiEditPlacement, aiEditVersionId, aiJobEditModel, readAiEditTarget } from "./ai-job-edit-step.js";
+import { aiLimitReview, aiUnspentOutcome } from "./ai-job-generation.js";
+import { registerAiJobStep } from "./ai-jobs.js";
+/**
+ * The `navigation` step (AGL-3728): a change to a site's header or footer
+ * menu — add, take out, rename, relink or reorder its items — as a
+ * first-class build operation, so Assist's one plan card can say "add About
+ * and Pricing to the menu, and take Blog out" and have it done.
+ *
+ * NO MODEL. The planner already wrote the change as the item's arguments, in
+ * words (`aiMenuChangesOf`); this applies it to the layout's own Besigner
+ * elements in code (`aiLayoutWithMenuChanges`), so it costs no credits and
+ * cannot invent a link: every destination is one of the site's pages, a page
+ * this build made, a path on the site or an https address.
+ *
+ * ── Where it lands ───────────────────────────────────────────────────────
+ *
+ * As the `edit` step's change to a layout does: a NEW version beside the
+ * layout's current one, which visitors keep seeing until a person publishes
+ * the new one. A layout is always served, so without version history there is
+ * nowhere for it to land and it is refused as a plan limit, charged nothing.
+ * The version is named by the job's id, so a pass asked again finds what it
+ * wrote.
+ *
+ * ── Who may ──────────────────────────────────────────────────────────────
+ *
+ * The editor's own rule for a layout's versions (`canWriteHostContent` and
+ * `hostWritesFrozen` in the Firestore rules): a member with a write role on
+ * the site (admin, editor or author), while no lockdown freezes the site, its
+ * org or the platform. Asked at the door, again before the write, and the
+ * role once more inside the transaction that writes.
+ *
+ * ── Audit ────────────────────────────────────────────────────────────────
+ *
+ * The layout it wrote is the job's output, which the job machine records as
+ * an `ai.job.output` activity row on the site, as every other operation's is.
+ */ export const AI_NAVIGATION_KIND = 'navigation';
+/**
+ * ASSUMED: the least time the step needs — the site's pages, the layout and
+ * its version, the org, and the one transaction that writes. No model, so it
+ * fits an inline door.
+ */ export const AI_JOB_NAVIGATION_STEP_MINIMUM_MS = 5000;
+export const AI_NAVIGATION_NO_SITE_COPY = 'Open the site whose menu should change.';
+export const AI_NAVIGATION_ROLE_COPY = 'Changing the site’s menus needs the admin, editor or author role on this site.';
+export const AI_NAVIGATION_LOCKED_COPY = 'This site is not accepting changes right now.';
+export const AI_NAVIGATION_NO_LAYOUT_COPY = 'This site has no layout with a header or footer to change. Make one in Layouts first.';
+export const AI_NAVIGATION_NOTHING_COPY = 'The request named no menu change this could make.';
+/** The name the new version carries in the layout's versions. */ export const AI_NAVIGATION_VERSION_NAME = 'Menu changes';
+const text = (value)=>typeof value === 'string' ? value.trim() : '';
+/** A path on the site, as a menu item may link it. */ const SITE_PATH = /^\/(?:[A-Za-z0-9._~!$&'()*+,;=:@%-]+(?:\/[A-Za-z0-9._~!$&'()*+,;=:@%-]+)*)?\/?(?:[?#][^\s]*)?$/;
+const SCREEN_ID = /^[A-Za-z0-9_-]{1,128}$/;
+function buildMadeOf(inputs) {
+    var _ref;
+    const raw = (_ref = inputs == null ? void 0 : inputs[AI_BUILD_MADE_INPUT]) != null ? _ref : {};
+    const rows = (value, name)=>(Array.isArray(value) ? value : []).flatMap((entry)=>{
+            const row = entry != null ? entry : {};
+            return text(row[name]) && SCREEN_ID.test(text(row['id'])) ? [
+                {
+                    [name]: text(row[name]),
+                    id: text(row['id'])
+                }
+            ] : [];
+        });
+    return {
+        pages: rows(raw.pages, 'title'),
+        layouts: rows(raw.layouts, 'name')
+    };
+}
+/** The site's pages: not deleted, not an email design. */ export async function readAiNavigationSitePages(firestore, hostId) {
+    const snapshot = await firestore.collection('hosts').doc(hostId).collection('screens').select('displayName', 'slug', 'kind', 'deletedAt', 'layoutId').get();
+    return snapshot.docs.flatMap((doc)=>{
+        var _doc_get, _doc_get1;
+        const kind = doc.get('kind');
+        if (doc.get('deletedAt') || kind && kind !== 'template') return [];
+        const layoutId = doc.get('layoutId');
+        return [
+            {
+                id: doc.id,
+                slug: String((_doc_get = doc.get('slug')) != null ? _doc_get : ''),
+                title: String((_doc_get1 = doc.get('displayName')) != null ? _doc_get1 : ''),
+                template: kind === 'template',
+                layoutId: typeof layoutId === 'string' && layoutId ? layoutId : null
+            }
+        ];
+    });
+}
+/**
+ * What a destination in an item's words links (AGL-3728): a page this build
+ * made (`new:<title>`), one of the site's pages by id (`page:<id>` or the bare
+ * id), a path on the site, or an https address; `null` for anything else.
+ */ export function aiNavigationTarget(destination, context) {
+    const value = destination.trim();
+    const pageIds = new Set(context.pages.filter((page)=>!page.template).map((page)=>page.id));
+    if (isAiPlanNewRef(value)) {
+        const title = value.slice(value.indexOf(':') + 1).trim().toLowerCase();
+        const made = context.made.pages.find((page)=>page.title.trim().toLowerCase() === title);
+        // A page this build was to make and did not is no destination.
+        return made && pageIds.has(made.id) ? {
+            screenId: made.id
+        } : null;
+    }
+    const id = value.replace(/^page:/i, '');
+    if (pageIds.has(id)) return {
+        screenId: id
+    };
+    if (value.startsWith('/') && !value.startsWith('//') && SITE_PATH.test(value)) return {
+        href: value
+    };
+    if (/^https:\/\/[^\s/?#]+\.[^\s/?#]+(?:[/?#]\S*)?$/i.test(value)) return {
+        href: value
+    };
+    return null;
+}
+/** The layout an item changes: the one it names, else the one the site's pages render inside. */ export function aiNavigationLayoutOf(named, context) {
+    if (isAiPlanNewRef(named)) {
+        var _ref;
+        var _context_made_layouts_find;
+        const name = named.slice(named.indexOf(':') + 1).trim().toLowerCase();
+        return (_ref = (_context_made_layouts_find = context.made.layouts.find((layout)=>layout.name.trim().toLowerCase() === name)) == null ? void 0 : _context_made_layouts_find.id) != null ? _ref : null;
+    }
+    if (SCREEN_ID.test(named)) return named;
+    return aiBuildStoreLayoutOf(null, context.pages);
+}
+/** Why this member may not change this site's menus now, or `null`. */ export async function aiNavigationAccessRefusal(input, deps = {}) {
+    var _input_host_get, _deps_lockdown;
+    const roles = (_input_host_get = input.host.get('memberRoles')) != null ? _input_host_get : {};
+    if (!hostRoleCanWrite(roles[input.uid])) return AI_NAVIGATION_ROLE_COPY;
+    const locked = await ((_deps_lockdown = deps.lockdown) != null ? _deps_lockdown : getLockdownVerdict)({
+        staff: false,
+        uid: input.uid,
+        org: input.org,
+        host: input.host.data(),
+        intent: 'write'
+    });
+    return locked ? AI_NAVIGATION_LOCKED_COPY : null;
+}
+/** The new version's output note: what was done, what was not, and that it waits to be published. */ export function aiNavigationOutputNote(done, notDone) {
+    const did = done.length ? `${done.join(' ')} ` : '';
+    const not = notDone.length ? ` Not done: ${notDone.join(' ')}` : '';
+    return `${did}Saved as a new version of the layout beside the one visitors see: open it to review it, and publish it when it is ready.${not}`.slice(0, 1000);
+}
+/**
+ * The change written, in one transaction that reads the layout as it is
+ * stored NOW: it still exists, its version is still there, the member still
+ * holds a write role, and the plan still keeps version history. The change is
+ * applied again to that version's nodes, so a save made since is kept.
+ */ export async function writeAiNavigation(firestore, input) {
+    const hostRef = firestore.collection('hosts').doc(input.hostId);
+    const docRef = hostRef.collection('layouts').doc(input.layoutId);
+    const sourceRef = docRef.collection('versions').doc(input.sourceVersionId);
+    const newRef = docRef.collection('versions').doc(input.versionId);
+    return firestore.runTransaction(async (tx)=>{
+        var _host_get;
+        const [host, doc, source, already] = await Promise.all([
+            tx.get(hostRef),
+            tx.get(docRef),
+            tx.get(sourceRef),
+            tx.get(newRef)
+        ]);
+        if (already.exists) return {
+            ok: true,
+            versionId: input.versionId,
+            done: [],
+            notDone: []
+        };
+        if (!doc.exists || doc.get('deletedAt') != null) return {
+            ok: false,
+            error: AI_EDIT_GONE_COPY
+        };
+        if (!source.exists) return {
+            ok: false,
+            error: AI_EDIT_VERSION_GONE_COPY
+        };
+        const roles = (_host_get = host.get('memberRoles')) != null ? _host_get : {};
+        if (!hostRoleCanWrite(roles[input.uid])) return {
+            ok: false,
+            error: AI_NAVIGATION_ROLE_COPY
+        };
+        const pointer = text(doc.get('versionId')) || null;
+        const placement = aiEditPlacement({
+            versioning: input.versioning,
+            served: true,
+            sourceIsPointer: pointer === input.sourceVersionId,
+            sourceScheduled: false
+        });
+        if (placement === 'refused') return {
+            ok: false,
+            error: AI_EDIT_NEEDS_VERSIONING_COPY
+        };
+        const nodes = decodeStoredNodes(source.get('nodes'));
+        if (!nodes) return {
+            ok: false,
+            error: AI_EDIT_NO_NODES_COPY
+        };
+        const applied = aiLayoutWithMenuChanges(nodes, input.menus, input.changes);
+        if (!applied.nodes) return {
+            ok: false,
+            error: applied.notDone.join(' ') || AI_NAVIGATION_NOTHING_COPY
+        };
+        const packed = encodeStoredNodes(applied.nodes);
+        if (!packed) return {
+            ok: false,
+            error: AI_EDIT_NO_NODES_COPY
+        };
+        // A copy of the version it started from — everything the editor stored —
+        // with the changed menus, as the versions route copies one.
+        const copy = _extends({}, source.data());
+        delete copy['aiEditJobId'];
+        tx.create(newRef, _extends({}, copy, {
+            nodes: Buffer.from(packed),
+            displayName: AI_NAVIGATION_VERSION_NAME,
+            createdAt: input.now,
+            updatedAt: input.now,
+            createdBy: input.uid,
+            aiJobId: input.aiJobId
+        }));
+        return {
+            ok: true,
+            versionId: input.versionId,
+            done: applied.done,
+            notDone: applied.notDone
+        };
+    });
+}
+async function navigationPlanOf(firestore, job, readPages) {
+    var _job_inputs;
+    if (!job.hostId) return AI_NAVIGATION_NO_SITE_COPY;
+    const inputs = (_job_inputs = job.inputs) != null ? _job_inputs : {};
+    const pages = await readPages(firestore, job.hostId);
+    const made = buildMadeOf(inputs);
+    const layoutId = aiNavigationLayoutOf(text(inputs['layout']), {
+        pages,
+        made
+    });
+    if (!layoutId) return AI_NAVIGATION_NO_LAYOUT_COPY;
+    const read = aiMenuChangesOf(inputs, (destination)=>aiNavigationTarget(destination, {
+            pages,
+            made
+        }));
+    if (aiMenuChangesEmpty(read.changes)) return [
+        AI_NAVIGATION_NOTHING_COPY,
+        ...read.problems
+    ].join(' ');
+    return {
+        layoutId,
+        menus: aiMenusOf(inputs['menu']),
+        changes: read.changes,
+        problems: read.problems
+    };
+}
+export function createAiJobNavigationStep(deps = {}) {
+    var _deps_readTarget, _deps_readPages, _deps_write;
+    const readTarget = (_deps_readTarget = deps.readTarget) != null ? _deps_readTarget : readAiEditTarget;
+    const readPages = (_deps_readPages = deps.readPages) != null ? _deps_readPages : readAiNavigationSitePages;
+    const write = (_deps_write = deps.write) != null ? _deps_write : writeAiNavigation;
+    return async ({ job, now, firestore, org, modelFor })=>{
+        var _ref, _data;
+        // No model is asked: the outcome records the edit step's at no cost.
+        const model = (_ref = modelFor == null ? void 0 : modelFor('job.edit')) != null ? _ref : aiJobEditModel();
+        const unspent = (failure)=>_extends({}, aiUnspentOutcome(model), {
+                failure
+            });
+        const hostId = job.hostId;
+        if (!hostId) return unspent(AI_NAVIGATION_NO_SITE_COPY);
+        const plan = await navigationPlanOf(firestore, job, readPages);
+        if (typeof plan === 'string') return unspent(plan);
+        const versionId = aiEditVersionId(job);
+        const read = await readTarget(firestore, {
+            orgId: job.orgId,
+            hostId,
+            inputs: {
+                target: plan.layoutId,
+                targetKind: 'layout',
+                versionId: null
+            },
+            jobId: versionId
+        });
+        if ('error' in read) return unspent(read.error);
+        const output = (done, notDone)=>({
+                resource: 'layout',
+                id: read.id,
+                versionId,
+                hostId,
+                hostSubdomain: read.hostSubdomain,
+                label: read.name,
+                note: aiNavigationOutputNote(done, notDone)
+            });
+        if (read.written) return aiUnspentOutcome(model, {
+            outputs: [
+                output([], [])
+            ]
+        });
+        const orgData = org != null ? org : (_data = (await firestore.collection('orgs').doc(job.orgId).get()).data()) != null ? _data : null;
+        const host = await firestore.collection('hosts').doc(hostId).get();
+        const refused = await aiNavigationAccessRefusal({
+            host,
+            uid: job.createdBy,
+            org: orgData
+        }, {
+            lockdown: deps.lockdown
+        });
+        if (refused) return aiUnspentOutcome(model, {
+            review: aiLimitReview(refused)
+        });
+        const versioning = checkEntitlement(orgData, 'versioning');
+        const placement = aiEditPlacement({
+            versioning,
+            served: true,
+            sourceIsPointer: read.sourceVersionId === read.pointerVersionId,
+            sourceScheduled: read.scheduledVersionId === read.sourceVersionId
+        });
+        if (placement === 'refused') return aiUnspentOutcome(model, {
+            review: aiLimitReview(AI_EDIT_NEEDS_VERSIONING_COPY)
+        });
+        const written = await write(firestore, {
+            hostId,
+            layoutId: read.id,
+            sourceVersionId: read.sourceVersionId,
+            versionId,
+            menus: plan.menus,
+            changes: plan.changes,
+            uid: job.createdBy,
+            aiJobId: aiOriginJobId(job),
+            versioning,
+            now
+        });
+        if (written.ok === false) return unspent(written.error);
+        return aiUnspentOutcome(model, {
+            outputs: [
+                output(written.done, [
+                    ...written.notDone,
+                    ...plan.problems
+                ])
+            ]
+        });
+    };
+}
+export const runAiJobNavigationStep = createAiJobNavigationStep();
+/**
+ * A navigation change is admitted on a site of the job's own org, for a
+ * member who may write its content now, where the site has a layout and the
+ * change has somewhere to land that no visitor sees on this plan. Refused in
+ * those words before anything exists.
+ */ export function createAiNavigationJobAdmission(deps = {}) {
+    var _deps_ownerOf, _deps_readTarget, _deps_readPages;
+    const ownerOf = (_deps_ownerOf = deps.ownerOf) != null ? _deps_ownerOf : resolveOrgIdForHost;
+    const readTarget = (_deps_readTarget = deps.readTarget) != null ? _deps_readTarget : readAiEditTarget;
+    const readPages = (_deps_readPages = deps.readPages) != null ? _deps_readPages : readAiNavigationSitePages;
+    return async (context)=>{
+        var _context_uid;
+        if (!context.hostId) return {
+            status: 400,
+            error: AI_NAVIGATION_NO_SITE_COPY
+        };
+        const owner = await ownerOf(context.hostId);
+        if (!owner || owner !== context.orgId) return {
+            status: 404,
+            error: 'Unknown site'
+        };
+        const host = await context.firestore.collection('hosts').doc(context.hostId).get();
+        const refused = await aiNavigationAccessRefusal({
+            host,
+            uid: (_context_uid = context.uid) != null ? _context_uid : '',
+            org: context.org
+        }, {
+            lockdown: deps.lockdown
+        });
+        if (refused) return {
+            status: 403,
+            error: refused
+        };
+        const plan = await navigationPlanOf(context.firestore, {
+            hostId: context.hostId,
+            inputs: context.inputs
+        }, readPages);
+        if (typeof plan === 'string') return {
+            status: 400,
+            error: plan
+        };
+        const read = await readTarget(context.firestore, {
+            orgId: context.orgId,
+            hostId: context.hostId,
+            inputs: {
+                target: plan.layoutId,
+                targetKind: 'layout',
+                versionId: null
+            },
+            jobId: null
+        });
+        if ('error' in read) return read;
+        const placement = aiEditPlacement({
+            versioning: checkEntitlement(context.org, 'versioning'),
+            served: true,
+            sourceIsPointer: read.sourceVersionId === read.pointerVersionId,
+            sourceScheduled: read.scheduledVersionId === read.sourceVersionId
+        });
+        return placement === 'refused' ? {
+            status: 403,
+            error: AI_EDIT_NEEDS_VERSIONING_COPY
+        } : null;
+    };
+}
+export const aiNavigationJobAdmission = createAiNavigationJobAdmission();
+/** Registers the navigation step and its door (AGL-3728). */ export function registerAiNavigationJob() {
+    registerAiJobStep(AI_NAVIGATION_KIND, runAiJobNavigationStep, {
+        minimumMs: AI_JOB_NAVIGATION_STEP_MINIMUM_MS
+    });
+    registerAiJobAdmission(AI_NAVIGATION_KIND, aiNavigationJobAdmission);
+}
+
+//# sourceMappingURL=ai-job-navigation-step.js.map

package/src/lib/jobs/ai-job-navigation-step.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-navigation-step.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 { hostRoleCanWrite } from '@aglyn/aglyn/app-utils/organizations'\nimport { checkEntitlement } from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport { decodeStoredNodes, encodeStoredNodes } from '@aglyn/aglyn/app-utils/stored-nodes'\nimport { getLockdownVerdict } from '@aglyn/tenant-data-admin/server/lockdown'\nimport { resolveOrgIdForHost } from '@aglyn/tenant-data-admin/server/organizations'\nimport type { Firestore } from 'firebase-admin/firestore'\nimport { AI_EDIT_GONE_COPY, AI_EDIT_NEEDS_VERSIONING_COPY, AI_EDIT_NO_NODES_COPY, AI_EDIT_VERSION_GONE_COPY } from '../model/ai-edit-job'\nimport { isAiPlanNewRef } from '../model/ai-build-plan'\nimport { AI_BUILD_MADE_INPUT, type AiBuildMade } from '../model/ai-build-job'\nimport { aiBuildStoreLayoutOf } from '../model/ai-build-store-pages'\nimport type { AiJob, AiJobOutput } from '../model/ai-jobs.types'\nimport {\n  aiLayoutWithMenuChanges,\n  aiMenuChangesEmpty,\n  aiMenuChangesOf,\n  aiMenusOf,\n  type AiMenuChanges,\n  type AiMenuName,\n  type AiMenuTarget,\n} from '../model/ai-layout-menus'\nimport { registerAiJobAdmission, type AiJobAdmission, type AiJobAdmissionRefusal } from './ai-job-admission'\nimport { aiOriginJobId } from './ai-job-draft-ids'\nimport { aiEditPlacement, aiEditVersionId, aiJobEditModel, readAiEditTarget } from './ai-job-edit-step'\nimport { aiLimitReview, aiUnspentOutcome } from './ai-job-generation'\nimport type { AiJobStepOutcome, AiJobStepRunner } from './ai-job-text-step'\nimport { registerAiJobStep } from './ai-jobs'\n\n/**\n * The `navigation` step (AGL-3728): a change to a site's header or footer\n * menu — add, take out, rename, relink or reorder its items — as a\n * first-class build operation, so Assist's one plan card can say \"add About\n * and Pricing to the menu, and take Blog out\" and have it done.\n *\n * NO MODEL. The planner already wrote the change as the item's arguments, in\n * words (`aiMenuChangesOf`); this applies it to the layout's own Besigner\n * elements in code (`aiLayoutWithMenuChanges`), so it costs no credits and\n * cannot invent a link: every destination is one of the site's pages, a page\n * this build made, a path on the site or an https address.\n *\n * ── Where it lands ───────────────────────────────────────────────────────\n *\n * As the `edit` step's change to a layout does: a NEW version beside the\n * layout's current one, which visitors keep seeing until a person publishes\n * the new one. A layout is always served, so without version history there is\n * nowhere for it to land and it is refused as a plan limit, charged nothing.\n * The version is named by the job's id, so a pass asked again finds what it\n * wrote.\n *\n * ── Who may ──────────────────────────────────────────────────────────────\n *\n * The editor's own rule for a layout's versions (`canWriteHostContent` and\n * `hostWritesFrozen` in the Firestore rules): a member with a write role on\n * the site (admin, editor or author), while no lockdown freezes the site, its\n * org or the platform. Asked at the door, again before the write, and the\n * role once more inside the transaction that writes.\n *\n * ── Audit ────────────────────────────────────────────────────────────────\n *\n * The layout it wrote is the job's output, which the job machine records as\n * an `ai.job.output` activity row on the site, as every other operation's is.\n */\n\nexport const AI_NAVIGATION_KIND = 'navigation' as const\n\n/**\n * ASSUMED: the least time the step needs — the site's pages, the layout and\n * its version, the org, and the one transaction that writes. No model, so it\n * fits an inline door.\n */\nexport const AI_JOB_NAVIGATION_STEP_MINIMUM_MS = 5_000\n\nexport const AI_NAVIGATION_NO_SITE_COPY = 'Open the site whose menu should change.'\nexport const AI_NAVIGATION_ROLE_COPY = 'Changing the site’s menus needs the admin, editor or author role on this site.'\nexport const AI_NAVIGATION_LOCKED_COPY = 'This site is not accepting changes right now.'\nexport const AI_NAVIGATION_NO_LAYOUT_COPY = 'This site has no layout with a header or footer to change. Make one in Layouts first.'\nexport const AI_NAVIGATION_NOTHING_COPY = 'The request named no menu change this could make.'\n\n/** The name the new version carries in the layout's versions. */\nexport const AI_NAVIGATION_VERSION_NAME = 'Menu changes'\n\nconst text = (value: unknown): string => (typeof value === 'string' ? value.trim() : '')\n\n/** A path on the site, as a menu item may link it. */\nconst SITE_PATH = /^\\/(?:[A-Za-z0-9._~!$&'()*+,;=:@%-]+(?:\\/[A-Za-z0-9._~!$&'()*+,;=:@%-]+)*)?\\/?(?:[?#][^\\s]*)?$/\nconst SCREEN_ID = /^[A-Za-z0-9_-]{1,128}$/\n\nfunction buildMadeOf(inputs: Readonly<Record<string, unknown>> | null | undefined): AiBuildMade {\n  const raw = (inputs?.[AI_BUILD_MADE_INPUT] ?? {}) as Partial<Record<'pages' | 'layouts', unknown>>\n  const rows = (value: unknown, name: 'title' | 'name') =>\n    (Array.isArray(value) ? value : []).flatMap((entry) => {\n      const row = (entry ?? {}) as Record<string, unknown>\n      return text(row[name]) && SCREEN_ID.test(text(row['id'])) ? [{ [name]: text(row[name]), id: text(row['id']) }] : []\n    })\n  return { pages: rows(raw.pages, 'title') as AiBuildMade['pages'], layouts: rows(raw.layouts, 'name') as AiBuildMade['layouts'] }\n}\n\n/** The site's pages a menu may link, by id, with the layout each renders inside. */\nexport interface AiNavigationSitePage {\n  id: string\n  title: string\n  slug: string\n  template: boolean\n  layoutId: string | null\n}\n\n/** The site's pages: not deleted, not an email design. */\nexport async function readAiNavigationSitePages(firestore: Firestore, hostId: string): Promise<AiNavigationSitePage[]> {\n  const snapshot = await firestore.collection('hosts').doc(hostId).collection('screens').select('displayName', 'slug', 'kind', 'deletedAt', 'layoutId').get()\n  return snapshot.docs.flatMap((doc) => {\n    const kind = doc.get('kind')\n    if (doc.get('deletedAt') || (kind && kind !== 'template')) return []\n    const layoutId = doc.get('layoutId')\n    return [\n      {\n        id: doc.id,\n        slug: String(doc.get('slug') ?? ''),\n        title: String(doc.get('displayName') ?? ''),\n        template: kind === 'template',\n        layoutId: typeof layoutId === 'string' && layoutId ? layoutId : null,\n      },\n    ]\n  })\n}\n\n/**\n * What a destination in an item's words links (AGL-3728): a page this build\n * made (`new:<title>`), one of the site's pages by id (`page:<id>` or the bare\n * id), a path on the site, or an https address; `null` for anything else.\n */\nexport function aiNavigationTarget(\n  destination: string,\n  context: { pages: readonly Pick<AiNavigationSitePage, 'id' | 'template'>[]; made: AiBuildMade },\n): AiMenuTarget | null {\n  const value = destination.trim()\n  const pageIds = new Set(context.pages.filter((page) => !page.template).map((page) => page.id))\n  if (isAiPlanNewRef(value as string | null)) {\n    const title = value.slice(value.indexOf(':') + 1).trim().toLowerCase()\n    const made = context.made.pages.find((page) => page.title.trim().toLowerCase() === title)\n    // A page this build was to make and did not is no destination.\n    return made && pageIds.has(made.id) ? { screenId: made.id } : null\n  }\n  const id = value.replace(/^page:/i, '')\n  if (pageIds.has(id)) return { screenId: id }\n  if (value.startsWith('/') && !value.startsWith('//') && SITE_PATH.test(value)) return { href: value }\n  if (/^https:\\/\\/[^\\s/?#]+\\.[^\\s/?#]+(?:[/?#]\\S*)?$/i.test(value)) return { href: value }\n  return null\n}\n\n/** The layout an item changes: the one it names, else the one the site's pages render inside. */\nexport function aiNavigationLayoutOf(\n  named: string,\n  context: { pages: readonly AiNavigationSitePage[]; made: AiBuildMade },\n): string | null {\n  if (isAiPlanNewRef(named as string | null)) {\n    const name = named.slice(named.indexOf(':') + 1).trim().toLowerCase()\n    return context.made.layouts.find((layout) => layout.name.trim().toLowerCase() === name)?.id ?? null\n  }\n  if (SCREEN_ID.test(named)) return named\n  return aiBuildStoreLayoutOf(null, context.pages)\n}\n\n/** Why this member may not change this site's menus now, or `null`. */\nexport async function aiNavigationAccessRefusal(\n  input: { host: FirebaseFirestore.DocumentSnapshot; uid: string; org: object | null },\n  deps: { lockdown?: typeof getLockdownVerdict } = {},\n): Promise<string | null> {\n  const roles = (input.host.get('memberRoles') ?? {}) as Record<string, unknown>\n  if (!hostRoleCanWrite(roles[input.uid])) return AI_NAVIGATION_ROLE_COPY\n  const locked = await (deps.lockdown ?? getLockdownVerdict)({\n    staff: false,\n    uid: input.uid,\n    org: input.org as never,\n    host: input.host.data() as never,\n    intent: 'write',\n  })\n  return locked ? AI_NAVIGATION_LOCKED_COPY : null\n}\n\n/** The new version's output note: what was done, what was not, and that it waits to be published. */\nexport function aiNavigationOutputNote(done: readonly string[], notDone: readonly string[]): string {\n  const did = done.length ? `${done.join(' ')} ` : ''\n  const not = notDone.length ? ` Not done: ${notDone.join(' ')}` : ''\n  return `${did}Saved as a new version of the layout beside the one visitors see: open it to review it, and publish it when it is ready.${not}`.slice(0, 1_000)\n}\n\nexport type AiNavigationWrite =\n  | { ok: true; versionId: string; done: string[]; notDone: string[] }\n  | { ok: false; error: string }\n\n/**\n * The change written, in one transaction that reads the layout as it is\n * stored NOW: it still exists, its version is still there, the member still\n * holds a write role, and the plan still keeps version history. The change is\n * applied again to that version's nodes, so a save made since is kept.\n */\nexport async function writeAiNavigation(\n  firestore: Firestore,\n  input: {\n    hostId: string\n    layoutId: string\n    sourceVersionId: string\n    versionId: string\n    menus: readonly AiMenuName[]\n    changes: AiMenuChanges\n    uid: string\n    aiJobId: string\n    versioning: boolean\n    now: Date\n  },\n): Promise<AiNavigationWrite> {\n  const hostRef = firestore.collection('hosts').doc(input.hostId)\n  const docRef = hostRef.collection('layouts').doc(input.layoutId)\n  const sourceRef = docRef.collection('versions').doc(input.sourceVersionId)\n  const newRef = docRef.collection('versions').doc(input.versionId)\n  return firestore.runTransaction(async (tx): Promise<AiNavigationWrite> => {\n    const [host, doc, source, already] = await Promise.all([tx.get(hostRef), tx.get(docRef), tx.get(sourceRef), tx.get(newRef)])\n    if (already.exists) return { ok: true, versionId: input.versionId, done: [], notDone: [] }\n    if (!doc.exists || doc.get('deletedAt') != null) return { ok: false, error: AI_EDIT_GONE_COPY }\n    if (!source.exists) return { ok: false, error: AI_EDIT_VERSION_GONE_COPY }\n    const roles = (host.get('memberRoles') ?? {}) as Record<string, unknown>\n    if (!hostRoleCanWrite(roles[input.uid])) return { ok: false, error: AI_NAVIGATION_ROLE_COPY }\n    const pointer = text(doc.get('versionId')) || null\n    const placement = aiEditPlacement({\n      versioning: input.versioning,\n      served: true,\n      sourceIsPointer: pointer === input.sourceVersionId,\n      sourceScheduled: false,\n    })\n    if (placement === 'refused') return { ok: false, error: AI_EDIT_NEEDS_VERSIONING_COPY }\n    const nodes = decodeStoredNodes<Record<string, unknown>>(source.get('nodes'))\n    if (!nodes) return { ok: false, error: AI_EDIT_NO_NODES_COPY }\n    const applied = aiLayoutWithMenuChanges(nodes, input.menus, input.changes)\n    if (!applied.nodes) return { ok: false, error: applied.notDone.join(' ') || AI_NAVIGATION_NOTHING_COPY }\n    const packed = encodeStoredNodes(applied.nodes as never)\n    if (!packed) return { ok: false, error: AI_EDIT_NO_NODES_COPY }\n    // A copy of the version it started from — everything the editor stored —\n    // with the changed menus, as the versions route copies one.\n    const copy = { ...(source.data() as Record<string, unknown>) }\n    delete copy['aiEditJobId']\n    tx.create(newRef, {\n      ...copy,\n      nodes: Buffer.from(packed),\n      displayName: AI_NAVIGATION_VERSION_NAME,\n      createdAt: input.now,\n      updatedAt: input.now,\n      createdBy: input.uid,\n      aiJobId: input.aiJobId,\n    })\n    return { ok: true, versionId: input.versionId, done: applied.done, notDone: applied.notDone }\n  })\n}\n\nexport interface AiJobNavigationStepDeps {\n  readTarget?: typeof readAiEditTarget\n  readPages?: typeof readAiNavigationSitePages\n  write?: typeof writeAiNavigation\n  lockdown?: typeof getLockdownVerdict\n}\n\n/** What the step decided before writing: the layout, its version, the change and what was read away. */\ninterface AiNavigationPlan {\n  layoutId: string\n  menus: AiMenuName[]\n  changes: AiMenuChanges\n  problems: string[]\n}\n\nasync function navigationPlanOf(\n  firestore: Firestore,\n  job: Pick<AiJob, 'hostId' | 'inputs'>,\n  readPages: typeof readAiNavigationSitePages,\n): Promise<AiNavigationPlan | string> {\n  if (!job.hostId) return AI_NAVIGATION_NO_SITE_COPY\n  const inputs = job.inputs ?? {}\n  const pages = await readPages(firestore, job.hostId)\n  const made = buildMadeOf(inputs)\n  const layoutId = aiNavigationLayoutOf(text(inputs['layout']), { pages, made })\n  if (!layoutId) return AI_NAVIGATION_NO_LAYOUT_COPY\n  const read = aiMenuChangesOf(inputs, (destination) => aiNavigationTarget(destination, { pages, made }))\n  if (aiMenuChangesEmpty(read.changes)) return [AI_NAVIGATION_NOTHING_COPY, ...read.problems].join(' ')\n  return { layoutId, menus: aiMenusOf(inputs['menu']), changes: read.changes, problems: read.problems }\n}\n\nexport function createAiJobNavigationStep(deps: AiJobNavigationStepDeps = {}): AiJobStepRunner {\n  const readTarget = deps.readTarget ?? readAiEditTarget\n  const readPages = deps.readPages ?? readAiNavigationSitePages\n  const write = deps.write ?? writeAiNavigation\n  return async ({ job, now, firestore, org, modelFor }): Promise<AiJobStepOutcome> => {\n    // No model is asked: the outcome records the edit step's at no cost.\n    const model = modelFor?.('job.edit') ?? aiJobEditModel()\n    const unspent = (failure: string): AiJobStepOutcome => ({ ...aiUnspentOutcome(model), failure })\n    const hostId = job.hostId\n    if (!hostId) return unspent(AI_NAVIGATION_NO_SITE_COPY)\n    const plan = await navigationPlanOf(firestore, job, readPages)\n    if (typeof plan === 'string') return unspent(plan)\n    const versionId = aiEditVersionId(job)\n    const read = await readTarget(firestore, {\n      orgId: job.orgId,\n      hostId,\n      inputs: { target: plan.layoutId, targetKind: 'layout', versionId: null },\n      jobId: versionId,\n    })\n    if ('error' in read) return unspent(read.error)\n    const output = (done: readonly string[], notDone: readonly string[]): AiJobOutput => ({\n      resource: 'layout',\n      id: read.id,\n      versionId,\n      hostId,\n      hostSubdomain: read.hostSubdomain,\n      label: read.name,\n      note: aiNavigationOutputNote(done, notDone),\n    })\n    if (read.written) return aiUnspentOutcome(model, { outputs: [output([], [])] })\n    const orgData = org ?? ((await firestore.collection('orgs').doc(job.orgId).get()).data() ?? null)\n    const host = await firestore.collection('hosts').doc(hostId).get()\n    const refused = await aiNavigationAccessRefusal({ host, uid: job.createdBy, org: orgData }, { lockdown: deps.lockdown })\n    if (refused) return aiUnspentOutcome(model, { review: aiLimitReview(refused) })\n    const versioning = checkEntitlement(orgData as never, 'versioning')\n    const placement = aiEditPlacement({\n      versioning,\n      served: true,\n      sourceIsPointer: read.sourceVersionId === read.pointerVersionId,\n      sourceScheduled: read.scheduledVersionId === read.sourceVersionId,\n    })\n    if (placement === 'refused') return aiUnspentOutcome(model, { review: aiLimitReview(AI_EDIT_NEEDS_VERSIONING_COPY) })\n    const written = await write(firestore, {\n      hostId,\n      layoutId: read.id,\n      sourceVersionId: read.sourceVersionId,\n      versionId,\n      menus: plan.menus,\n      changes: plan.changes,\n      uid: job.createdBy,\n      aiJobId: aiOriginJobId(job),\n      versioning,\n      now,\n    })\n    if (written.ok === false) return unspent(written.error)\n    return aiUnspentOutcome(model, { outputs: [output(written.done, [...written.notDone, ...plan.problems])] })\n  }\n}\n\nexport const runAiJobNavigationStep = createAiJobNavigationStep()\n\n// ── Admission ─────────────────────────────────────────────────────────────\n\nexport interface AiNavigationJobAdmissionDeps {\n  ownerOf?: typeof resolveOrgIdForHost\n  readTarget?: typeof readAiEditTarget\n  readPages?: typeof readAiNavigationSitePages\n  lockdown?: typeof getLockdownVerdict\n}\n\n/**\n * A navigation change is admitted on a site of the job's own org, for a\n * member who may write its content now, where the site has a layout and the\n * change has somewhere to land that no visitor sees on this plan. Refused in\n * those words before anything exists.\n */\nexport function createAiNavigationJobAdmission(deps: AiNavigationJobAdmissionDeps = {}): AiJobAdmission {\n  const ownerOf = deps.ownerOf ?? resolveOrgIdForHost\n  const readTarget = deps.readTarget ?? readAiEditTarget\n  const readPages = deps.readPages ?? readAiNavigationSitePages\n  return async (context): Promise<AiJobAdmissionRefusal | null> => {\n    if (!context.hostId) return { status: 400, error: AI_NAVIGATION_NO_SITE_COPY }\n    const owner = await ownerOf(context.hostId)\n    if (!owner || owner !== context.orgId) return { status: 404, error: 'Unknown site' }\n    const host = await context.firestore.collection('hosts').doc(context.hostId).get()\n    const refused = await aiNavigationAccessRefusal({ host, uid: context.uid ?? '', org: context.org }, { lockdown: deps.lockdown })\n    if (refused) return { status: 403, error: refused }\n    const plan = await navigationPlanOf(context.firestore as Firestore, { hostId: context.hostId, inputs: context.inputs as Record<string, unknown> }, readPages)\n    if (typeof plan === 'string') return { status: 400, error: plan }\n    const read = await readTarget(context.firestore, {\n      orgId: context.orgId,\n      hostId: context.hostId,\n      inputs: { target: plan.layoutId, targetKind: 'layout', versionId: null },\n      jobId: null,\n    })\n    if ('error' in read) return read\n    const placement = aiEditPlacement({\n      versioning: checkEntitlement(context.org as never, 'versioning'),\n      served: true,\n      sourceIsPointer: read.sourceVersionId === read.pointerVersionId,\n      sourceScheduled: read.scheduledVersionId === read.sourceVersionId,\n    })\n    return placement === 'refused' ? { status: 403, error: AI_EDIT_NEEDS_VERSIONING_COPY } : null\n  }\n}\n\nexport const aiNavigationJobAdmission = createAiNavigationJobAdmission()\n\n/** Registers the navigation step and its door (AGL-3728). */\nexport function registerAiNavigationJob(): void {\n  registerAiJobStep(AI_NAVIGATION_KIND, runAiJobNavigationStep, { minimumMs: AI_JOB_NAVIGATION_STEP_MINIMUM_MS })\n  registerAiJobAdmission(AI_NAVIGATION_KIND, aiNavigationJobAdmission)\n}\n"],"names":["hostRoleCanWrite","checkEntitlement","decodeStoredNodes","encodeStoredNodes","getLockdownVerdict","resolveOrgIdForHost","AI_EDIT_GONE_COPY","AI_EDIT_NEEDS_VERSIONING_COPY","AI_EDIT_NO_NODES_COPY","AI_EDIT_VERSION_GONE_COPY","isAiPlanNewRef","AI_BUILD_MADE_INPUT","aiBuildStoreLayoutOf","aiLayoutWithMenuChanges","aiMenuChangesEmpty","aiMenuChangesOf","aiMenusOf","registerAiJobAdmission","aiOriginJobId","aiEditPlacement","aiEditVersionId","aiJobEditModel","readAiEditTarget","aiLimitReview","aiUnspentOutcome","registerAiJobStep","AI_NAVIGATION_KIND","AI_JOB_NAVIGATION_STEP_MINIMUM_MS","AI_NAVIGATION_NO_SITE_COPY","AI_NAVIGATION_ROLE_COPY","AI_NAVIGATION_LOCKED_COPY","AI_NAVIGATION_NO_LAYOUT_COPY","AI_NAVIGATION_NOTHING_COPY","AI_NAVIGATION_VERSION_NAME","text","value","trim","SITE_PATH","SCREEN_ID","buildMadeOf","inputs","raw","rows","name","Array","isArray","flatMap","entry","row","test","id","pages","layouts","readAiNavigationSitePages","firestore","hostId","snapshot","collection","doc","select","get","docs","kind","layoutId","slug","String","title","template","aiNavigationTarget","destination","context","pageIds","Set","filter","page","map","slice","indexOf","toLowerCase","made","find","has","screenId","replace","startsWith","href","aiNavigationLayoutOf","named","layout","aiNavigationAccessRefusal","input","deps","roles","host","uid","locked","lockdown","staff","org","data","intent","aiNavigationOutputNote","done","notDone","did","length","join","not","writeAiNavigation","hostRef","docRef","sourceRef","sourceVersionId","newRef","versionId","runTransaction","tx","source","already","Promise","all","exists","ok","error","pointer","placement","versioning","served","sourceIsPointer","sourceScheduled","nodes","applied","menus","changes","packed","copy","create","Buffer","from","displayName","createdAt","now","updatedAt","createdBy","aiJobId","navigationPlanOf","job","readPages","read","problems","createAiJobNavigationStep","readTarget","write","modelFor","model","unspent","failure","plan","orgId","target","targetKind","jobId","output","resource","hostSubdomain","label","note","written","outputs","orgData","refused","review","pointerVersionId","scheduledVersionId","runAiJobNavigationStep","createAiNavigationJobAdmission","ownerOf","status","owner","aiNavigationJobAdmission","registerAiNavigationJob","minimumMs"],"mappings":"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"}

package/src/lib/jobs/ai-job-page-language.d.ts

@@ -114,7 +114,8 @@ export declare function aiLayoutPageTargets(input: {
  * (AGL-3616): a records listing is kept only where the site has the dataset —
  * the tree check admits a repeat over no other, and a card left repeating
  * over nothing would show its `{{item.*}}` — and one that names no fields
- * takes the inventory's, in the dataset's order.
+ * takes the inventory's, in the dataset's order. Its cards link the record
+ * pages the plan makes, else those the site already serves (AGL-3747).
  */
 export declare function aiLayoutListingsWithDatasets(listings: readonly AiLayoutListing[], inventory: Pick<AiSiteInventory, 'datasets'> | null): AiLayoutListing[];
 /**

package/src/lib/jobs/ai-job-page-language.js

@@ -18,7 +18,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
 import { isAiPlanNewRef } from "../model/ai-build-plan.js";
 import { aiHomeScreenIds } from "../model/ai-site-inventory.js";
 import { AI_LAYOUT_POST_ADDRESS_TOKENS, aiCompileLayoutPage } from "../layout-language/ai-layout-compiler.js";
-import { aiLayoutListingAt, aiLayoutListingsOf } from "../layout-language/ai-layout-listings.js";
+import { aiLayoutListingAt, aiLayoutListingsOf, aiLayoutRecordHref } from "../layout-language/ai-layout-listings.js";
 import { AI_LAYOUT_LANGUAGE_TEXT, AI_LAYOUT_PAGE_TOOL, aiReadLayoutPage } from "../layout-language/ai-layout-language.js";
 import { aiLayoutCopyCheck } from "../layout-language/ai-layout-gaps.js";
 import { aiLayoutStoredTree } from "../layout-language/ai-layout-store.js";
@@ -169,10 +169,11 @@ export const AI_JOB_PAGE_LANGUAGE_BUDGET = aiJobStepBudget({
  * (AGL-3616): a records listing is kept only where the site has the dataset —
  * the tree check admits a repeat over no other, and a card left repeating
  * over nothing would show its `{{item.*}}` — and one that names no fields
- * takes the inventory's, in the dataset's order.
+ * takes the inventory's, in the dataset's order. Its cards link the record
+ * pages the plan makes, else those the site already serves (AGL-3747).
  */ export function aiLayoutListingsWithDatasets(listings, inventory) {
     return listings.flatMap((listing)=>{
-        var _listing_imageField;
+        var _listing_imageField, _listing_addressField, _listing_recordBase;
         var _listing_fields;
         if (listing.kind !== 'records') return [
             listing
@@ -181,6 +182,11 @@ export const AI_JOB_PAGE_LANGUAGE_BUDGET = aiJobStepBudget({
         if (!row) return [];
         // The photo field is the card's picture, never its words (AGL-3616).
         const imageField = (_listing_imageField = listing.imageField) != null ? _listing_imageField : row.imageField;
+        // The address is the card's link to its record's page, never its words (AGL-3727).
+        const addressField = (_listing_addressField = listing.addressField) != null ? _listing_addressField : row.addressField;
+        // A record page the site already serves for the dataset (AGL-3747), where
+        // the plan makes none of its own.
+        const recordBase = (_listing_recordBase = listing.recordBase) != null ? _listing_recordBase : row.recordBase;
         const fields = (((_listing_fields = listing.fields) == null ? void 0 : _listing_fields.length) ? listing.fields : row.fields.map((name, index)=>{
             var _row_fieldIds;
             return {
@@ -188,12 +194,15 @@ export const AI_JOB_PAGE_LANGUAGE_BUDGET = aiJobStepBudget({
                 name,
                 type: 'text'
             };
-        })).filter((field)=>field.id !== imageField);
+        })).filter((field)=>field.id !== imageField && field.id !== addressField);
         return fields.length ? [
             _extends({}, listing, {
                 fields
             }, imageField ? {
                 imageField
+            } : {}, recordBase && addressField ? {
+                recordBase,
+                addressField
             } : {})
         ] : [];
     });
@@ -218,7 +227,14 @@ export const AI_JOB_PAGE_LANGUAGE_BUDGET = aiJobStepBudget({
         ...here.some((listing)=>listing.kind === 'posts') ? AI_LAYOUT_POST_ADDRESS_TOKENS : [],
         ...here.flatMap((listing)=>listing.kind === 'records' && listing.imageField ? [
                 `{{item.${listing.imageField}}}`
-            ] : [])
+            ] : []),
+        // Each card's link to its record's own page (AGL-3727), admitted whole.
+        ...here.flatMap((listing)=>{
+            const href = aiLayoutRecordHref(listing);
+            return href ? [
+                href
+            ] : [];
+        })
     ];
     if (!tokens.length) return context;
     return _extends({}, context, {