@aglyn/plugins-ai 1.0.0-beta.291 → 1.0.0-beta.293

package/src/lib/declarations.server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/ai/src/lib/declarations.server.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// Each registry from its own module, not the `@aglyn/aglyn/server` barrel:\n// boot needs three registries rather than the whole server surface, and a\n// suite that stubs that barrel wholesale still loads these declarations\n// against the real registries.\nimport {\n  listPluginEventHandlers,\n  registerPluginEventHandler,\n} from '@aglyn/aglyn/plugin-manager/plugin-events'\nimport {\n  listPluginUserErasers,\n  registerPluginUserEraser,\n} from '@aglyn/aglyn/plugin-manager/plugin-user-erasure'\nimport {\n  listUsageAlertContributors,\n  registerUsageAlertContributor,\n} from '@aglyn/aglyn/plugin-manager/usage-alert-contributors'\nimport { registerPluginUsageMeter } from '@aglyn/aglyn/plugin-manager/plugin-usage-meters'\nimport { registerOperatorAlerts } from '@aglyn/aglyn/plugin-manager/operator-alerts'\nimport { registerStockPhotoPicker } from '@aglyn/aglyn/plugin-manager/stock-photo-provider'\nimport { AI_PLUGIN_ID, AI_USAGE_METER_ID } from './constants'\nimport { AI_BUILD_PARTLY_FAILED, AI_JOB_FAILED, AI_PROVIDER_UNAVAILABLE } from './operator-alerts'\nimport { registerAiDeclarations } from './declarations'\n\n/** The provider-spend staff alerts' contributor id under the plugin. */\nconst AI_USAGE_ALERTS_ID = 'provider-spend'\n\n/**\n * The plugin's SERVER declarations (AGL-2939): what the server must know\n * at boot, before any door of the plugin has been called. The two platform\n * events the plugin writes activity for — the AI add-on bought or dropped,\n * an `ai.*` permission moved — are raised by core billing and membership\n * routes that never load the plugin's API surface, so the subscriptions\n * have to be in place from the first request. So does the eraser: an\n * account erasure is a core route too, and a person's AI usage months sit\n * under each org, keyed by the uid, where no core delete reaches them. So\n * does the usage alert contributor (AGL-2984): the usage-alerts sweep is a\n * core cron, and it evaluates the plugin's staff alerts on provider spend for\n * every org it reads.\n *\n * Light at boot by construction: the writers behind the handlers are\n * imported when the first event arrives, and the alert rules when the sweep\n * first evaluates an org, not when the process starts, so the boot cost is\n * the registration and nothing that touches Firestore.\n */\nexport function registerAiServerDeclarations(): void {\n  registerAiDeclarations()\n  // Idempotent against each REGISTRY rather than a module flag, so a\n  // registry reset (a spec) or a second module instance registers again.\n  if (!listPluginEventHandlers('org.seatAddons.changed').includes(AI_PLUGIN_ID)) {\n    registerPluginEventHandler(\n      'org.seatAddons.changed',\n      async ({ orgId, actor, before, after }) => {\n        const { logAiAddonChanged } = await import('./activity/ai-activity')\n        await logAiAddonChanged(orgId, actor, { before, after })\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'org.permissions.changed',\n      async ({ orgId, actor, subject, permission, granted }) => {\n        if (!permission.startsWith('ai.')) return\n        const { logAiPermissionChanged } = await import('./activity/ai-activity')\n        await logAiPermissionChanged(orgId, actor, { subject, permission, granted })\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // THE PLATFORM'S PER-SITE TOGGLE DOOR (AGL-4047). The collaborators card\n  // sets every per-site key through the platform's generic door now, so this\n  // plugin keeps its display copy (`aiPermissions` on the site's roster row,\n  // which the native apps read) in step from the verdict that door wrote.\n  if (!listPluginEventHandlers('host.member.permissions.changed').includes(AI_PLUGIN_ID)) {\n    registerPluginEventHandler(\n      'host.member.permissions.changed',\n      async ({ hostId, memberId, permissions }) => {\n        const { recordAiPermissionsOnRoster } = await import('./server/ai-host-permissions-roster')\n        await recordAiPermissionsOnRoster(hostId, memberId, permissions)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // THE PLATFORM'S BILLING EVENTS (AGL-3011). Subscribed at boot for the\n  // same reason as the two above: they are raised by the billing webhook,\n  // which never loads an AI door, and a workspace's overage standing moving\n  // late is a workspace charged or refused against a fact we already had.\n  //\n  // The handler modules are imported when the first event arrives, so a\n  // process that never receives one pays only for the registration.\n  if (!listPluginEventHandlers('billing.invoice.paid').includes(AI_PLUGIN_ID)) {\n    registerPluginEventHandler(\n      'billing.invoice.paid',\n      async (payload) => {\n        const { onAiBillingInvoicePaid } = await import('./billing/ai-overage-events')\n        await onAiBillingInvoicePaid(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.invoice.failed',\n      async (payload) => {\n        const { onAiBillingInvoiceFailed } = await import('./billing/ai-overage-events')\n        await onAiBillingInvoiceFailed(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.invoice.closed',\n      async (payload) => {\n        const { onAiBillingInvoiceClosed } = await import('./billing/ai-overage-events')\n        await onAiBillingInvoiceClosed(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.dispute.opened',\n      async (payload) => {\n        const { onAiBillingDisputeOpened } = await import('./billing/ai-overage-events')\n        await onAiBillingDisputeOpened(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.paymentMethod.changed',\n      async (payload) => {\n        const { onAiBillingPaymentMethodChanged } = await import(\n          './billing/ai-overage-events'\n        )\n        await onAiBillingPaymentMethodChanged(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // The plugin's meter in the monthly usage sweep: the month's provider spend\n  // onto the rollup, the credits past the band onto the invoice, and — from\n  // the cutover month (AGL-3011) — the close-out of what the plugin invoices\n  // itself. Registered at boot because the sweep is a core cron, and declared\n  // in `usageAxes` so the sweep refuses to bill a month without it. The same\n  // registration again replaces itself.\n  registerPluginUsageMeter({\n    pluginId: AI_PLUGIN_ID,\n    id: AI_USAGE_METER_ID,\n    measure: async (context) => {\n      const { measureAiMonth } = await import('./billing/ai-month-meter')\n      return measureAiMonth(context)\n    },\n    closeMonth: async (context) => {\n      const { closeAiMonth } = await import('./billing/ai-month-meter')\n      await closeAiMonth(context)\n    },\n  })\n  if (!listPluginUserErasers().includes(AI_PLUGIN_ID)) {\n    registerPluginUserEraser(\n      async (request) => {\n        const { eraseAiUsageForUser } = await import('./usage/ai-usage-eraser')\n        return eraseAiUsageForUser(request)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // The platform provider account alert (AGL-3377), and a job failing or a\n  // build finishing with parts failed on our side (AGL-3683), listed on\n  // Staff → Operator alerts before the first one is raised.\n  registerOperatorAlerts([AI_PROVIDER_UNAVAILABLE, AI_JOB_FAILED, AI_BUILD_PARTLY_FAILED], {\n    pluginId: AI_PLUGIN_ID,\n  })\n  // The stock photo picker another plugin's draft writer asks for (AGL-3755):\n  // an event's cover, chosen as a page's pictures are. The choosing loads on\n  // the first pick; registering again replaces it.\n  registerStockPhotoPicker(\n    {\n      pick: async (request) => {\n        const { aiStockPhotoPick } = await import('./jobs/ai-stock-photo-picker')\n        return aiStockPhotoPick(request)\n      },\n    },\n    { pluginId: AI_PLUGIN_ID },\n  )\n  if (\n    !listUsageAlertContributors().some(\n      (contributor) =>\n        contributor.pluginId === AI_PLUGIN_ID &&\n        contributor.id === AI_USAGE_ALERTS_ID,\n    )\n  ) {\n    registerUsageAlertContributor({\n      pluginId: AI_PLUGIN_ID,\n      id: AI_USAGE_ALERTS_ID,\n      evaluate: async (context) => {\n        const { evaluateAiUsageAlerts } = await import('./usage/ai-usage-alerts')\n        await evaluateAiUsageAlerts(context)\n      },\n      quotaChecks: async (context) => {\n        const { aiQuotaChecks } = await import('./usage/ai-quota-checks')\n        return aiQuotaChecks(context)\n      },\n    })\n  }\n}\n\nregisterAiServerDeclarations()\n"],"names":["listPluginEventHandlers","registerPluginEventHandler","listPluginUserErasers","registerPluginUserEraser","listUsageAlertContributors","registerUsageAlertContributor","registerPluginUsageMeter","registerOperatorAlerts","registerStockPhotoPicker","AI_PLUGIN_ID","AI_USAGE_METER_ID","AI_BUILD_PARTLY_FAILED","AI_JOB_FAILED","AI_PROVIDER_UNAVAILABLE","registerAiDeclarations","AI_USAGE_ALERTS_ID","registerAiServerDeclarations","includes","orgId","actor","before","after","logAiAddonChanged","pluginId","subject","permission","granted","startsWith","logAiPermissionChanged","hostId","memberId","permissions","recordAiPermissionsOnRoster","payload","onAiBillingInvoicePaid","onAiBillingInvoiceFailed","onAiBillingInvoiceClosed","onAiBillingDisputeOpened","onAiBillingPaymentMethodChanged","id","measure","context","measureAiMonth","closeMonth","closeAiMonth","request","eraseAiUsageForUser","pick","aiStockPhotoPick","some","contributor","evaluate","evaluateAiUsageAlerts","quotaChecks","aiQuotaChecks"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../libs/plugins/ai/src/lib/declarations.server.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// Each registry from its own module, not the `@aglyn/aglyn/server` barrel:\n// boot needs three registries rather than the whole server surface, and a\n// suite that stubs that barrel wholesale still loads these declarations\n// against the real registries.\nimport {\n  listPluginEventHandlers,\n  registerPluginEventHandler,\n} from '@aglyn/aglyn/plugin-manager/plugin-events'\nimport {\n  listPluginUserErasers,\n  registerPluginUserEraser,\n} from '@aglyn/aglyn/plugin-manager/plugin-user-erasure'\nimport {\n  listUsageAlertContributors,\n  registerUsageAlertContributor,\n} from '@aglyn/aglyn/plugin-manager/usage-alert-contributors'\nimport { registerPluginUsageMeter } from '@aglyn/aglyn/plugin-manager/plugin-usage-meters'\nimport { registerOperatorAlerts } from '@aglyn/aglyn/plugin-manager/operator-alerts'\nimport { registerStockPhotoPicker } from '@aglyn/aglyn/plugin-manager/stock-photo-provider'\nimport { registerPluginSiteStyleLooks } from '@aglyn/aglyn/plugin-manager/plugin-site-style-looks'\nimport { listServerThemePresets } from '@aglyn/aglyn/plugin-manager/plugin-theme-presets'\nimport { AI_PLUGIN_ID, AI_USAGE_METER_ID } from './constants'\nimport { AI_BUILD_PARTLY_FAILED, AI_JOB_FAILED, AI_PROVIDER_UNAVAILABLE } from './operator-alerts'\nimport { registerAiDeclarations } from './declarations'\n\n/** The provider-spend staff alerts' contributor id under the plugin. */\nconst AI_USAGE_ALERTS_ID = 'provider-spend'\n\n/**\n * The plugin's SERVER declarations (AGL-2939): what the server must know\n * at boot, before any door of the plugin has been called. The two platform\n * events the plugin writes activity for — the AI add-on bought or dropped,\n * an `ai.*` permission moved — are raised by core billing and membership\n * routes that never load the plugin's API surface, so the subscriptions\n * have to be in place from the first request. So does the eraser: an\n * account erasure is a core route too, and a person's AI usage months sit\n * under each org, keyed by the uid, where no core delete reaches them. So\n * does the usage alert contributor (AGL-2984): the usage-alerts sweep is a\n * core cron, and it evaluates the plugin's staff alerts on provider spend for\n * every org it reads.\n *\n * Light at boot by construction: the writers behind the handlers are\n * imported when the first event arrives, and the alert rules when the sweep\n * first evaluates an org, not when the process starts, so the boot cost is\n * the registration and nothing that touches Firestore.\n */\nexport function registerAiServerDeclarations(): void {\n  registerAiDeclarations()\n  // Idempotent against each REGISTRY rather than a module flag, so a\n  // registry reset (a spec) or a second module instance registers again.\n  if (!listPluginEventHandlers('org.seatAddons.changed').includes(AI_PLUGIN_ID)) {\n    registerPluginEventHandler(\n      'org.seatAddons.changed',\n      async ({ orgId, actor, before, after }) => {\n        const { logAiAddonChanged } = await import('./activity/ai-activity')\n        await logAiAddonChanged(orgId, actor, { before, after })\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'org.permissions.changed',\n      async ({ orgId, actor, subject, permission, granted }) => {\n        if (!permission.startsWith('ai.')) return\n        const { logAiPermissionChanged } = await import('./activity/ai-activity')\n        await logAiPermissionChanged(orgId, actor, { subject, permission, granted })\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // THE PLATFORM'S PER-SITE TOGGLE DOOR (AGL-4047). The collaborators card\n  // sets every per-site key through the platform's generic door now, so this\n  // plugin keeps its display copy (`aiPermissions` on the site's roster row,\n  // which the native apps read) in step from the verdict that door wrote.\n  if (!listPluginEventHandlers('host.member.permissions.changed').includes(AI_PLUGIN_ID)) {\n    registerPluginEventHandler(\n      'host.member.permissions.changed',\n      async ({ hostId, memberId, permissions }) => {\n        const { recordAiPermissionsOnRoster } = await import('./server/ai-host-permissions-roster')\n        await recordAiPermissionsOnRoster(hostId, memberId, permissions)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // THE PLATFORM'S BILLING EVENTS (AGL-3011). Subscribed at boot for the\n  // same reason as the two above: they are raised by the billing webhook,\n  // which never loads an AI door, and a workspace's overage standing moving\n  // late is a workspace charged or refused against a fact we already had.\n  //\n  // The handler modules are imported when the first event arrives, so a\n  // process that never receives one pays only for the registration.\n  if (!listPluginEventHandlers('billing.invoice.paid').includes(AI_PLUGIN_ID)) {\n    registerPluginEventHandler(\n      'billing.invoice.paid',\n      async (payload) => {\n        const { onAiBillingInvoicePaid } = await import('./billing/ai-overage-events')\n        await onAiBillingInvoicePaid(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.invoice.failed',\n      async (payload) => {\n        const { onAiBillingInvoiceFailed } = await import('./billing/ai-overage-events')\n        await onAiBillingInvoiceFailed(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.invoice.closed',\n      async (payload) => {\n        const { onAiBillingInvoiceClosed } = await import('./billing/ai-overage-events')\n        await onAiBillingInvoiceClosed(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.dispute.opened',\n      async (payload) => {\n        const { onAiBillingDisputeOpened } = await import('./billing/ai-overage-events')\n        await onAiBillingDisputeOpened(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.paymentMethod.changed',\n      async (payload) => {\n        const { onAiBillingPaymentMethodChanged } = await import(\n          './billing/ai-overage-events'\n        )\n        await onAiBillingPaymentMethodChanged(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // The plugin's meter in the monthly usage sweep: the month's provider spend\n  // onto the rollup, the credits past the band onto the invoice, and — from\n  // the cutover month (AGL-3011) — the close-out of what the plugin invoices\n  // itself. Registered at boot because the sweep is a core cron, and declared\n  // in `usageAxes` so the sweep refuses to bill a month without it. The same\n  // registration again replaces itself.\n  registerPluginUsageMeter({\n    pluginId: AI_PLUGIN_ID,\n    id: AI_USAGE_METER_ID,\n    measure: async (context) => {\n      const { measureAiMonth } = await import('./billing/ai-month-meter')\n      return measureAiMonth(context)\n    },\n    closeMonth: async (context) => {\n      const { closeAiMonth } = await import('./billing/ai-month-meter')\n      await closeAiMonth(context)\n    },\n  })\n  if (!listPluginUserErasers().includes(AI_PLUGIN_ID)) {\n    registerPluginUserEraser(\n      async (request) => {\n        const { eraseAiUsageForUser } = await import('./usage/ai-usage-eraser')\n        return eraseAiUsageForUser(request)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // The platform provider account alert (AGL-3377), and a job failing or a\n  // build finishing with parts failed on our side (AGL-3683), listed on\n  // Staff → Operator alerts before the first one is raised.\n  registerOperatorAlerts([AI_PROVIDER_UNAVAILABLE, AI_JOB_FAILED, AI_BUILD_PARTLY_FAILED], {\n    pluginId: AI_PLUGIN_ID,\n  })\n  // The stock photo picker another plugin's draft writer asks for (AGL-3755):\n  // an event's cover, chosen as a page's pictures are. The choosing loads on\n  // the first pick; registering again replaces it.\n  registerStockPhotoPicker(\n    {\n      pick: async (request) => {\n        const { aiStockPhotoPick } = await import('./jobs/ai-stock-photo-picker')\n        return aiStockPhotoPick(request)\n      },\n    },\n    { pluginId: AI_PLUGIN_ID },\n  )\n  // The look each style starts a new site in (AGL-4049): Create site asks a\n  // style before it creates anything, and the 21 styles are this plugin's\n  // kinds of site. Asked on the create, so the look module loads then; the\n  // built-in themes this deployment has are read at that moment too.\n  registerPluginSiteStyleLooks(\n    {\n      look: async (styleId) => {\n        const [{ aiSiteKind }, { aiSiteKindDefaultLook }] = await Promise.all([\n          import('./model/ai-site-kinds'),\n          import('./model/ai-site-look'),\n        ])\n        const kind = aiSiteKind(styleId)\n        if (!kind) return null\n        const presetIds = new Set(listServerThemePresets().map((preset) => preset.id))\n        return aiSiteKindDefaultLook(kind, { presetIds }).theme\n      },\n    },\n    { pluginId: AI_PLUGIN_ID },\n  )\n  if (\n    !listUsageAlertContributors().some(\n      (contributor) =>\n        contributor.pluginId === AI_PLUGIN_ID &&\n        contributor.id === AI_USAGE_ALERTS_ID,\n    )\n  ) {\n    registerUsageAlertContributor({\n      pluginId: AI_PLUGIN_ID,\n      id: AI_USAGE_ALERTS_ID,\n      evaluate: async (context) => {\n        const { evaluateAiUsageAlerts } = await import('./usage/ai-usage-alerts')\n        await evaluateAiUsageAlerts(context)\n      },\n      quotaChecks: async (context) => {\n        const { aiQuotaChecks } = await import('./usage/ai-quota-checks')\n        return aiQuotaChecks(context)\n      },\n    })\n  }\n}\n\nregisterAiServerDeclarations()\n"],"names":["listPluginEventHandlers","registerPluginEventHandler","listPluginUserErasers","registerPluginUserEraser","listUsageAlertContributors","registerUsageAlertContributor","registerPluginUsageMeter","registerOperatorAlerts","registerStockPhotoPicker","registerPluginSiteStyleLooks","listServerThemePresets","AI_PLUGIN_ID","AI_USAGE_METER_ID","AI_BUILD_PARTLY_FAILED","AI_JOB_FAILED","AI_PROVIDER_UNAVAILABLE","registerAiDeclarations","AI_USAGE_ALERTS_ID","registerAiServerDeclarations","includes","orgId","actor","before","after","logAiAddonChanged","pluginId","subject","permission","granted","startsWith","logAiPermissionChanged","hostId","memberId","permissions","recordAiPermissionsOnRoster","payload","onAiBillingInvoicePaid","onAiBillingInvoiceFailed","onAiBillingInvoiceClosed","onAiBillingDisputeOpened","onAiBillingPaymentMethodChanged","id","measure","context","measureAiMonth","closeMonth","closeAiMonth","request","eraseAiUsageForUser","pick","aiStockPhotoPick","look","styleId","aiSiteKind","aiSiteKindDefaultLook","Promise","all","kind","presetIds","Set","map","preset","theme","some","contributor","evaluate","evaluateAiUsageAlerts","quotaChecks","aiQuotaChecks"],"mappings":"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"}

package/src/lib/jobs/ai-job-import-step.d.ts

@@ -19,10 +19,10 @@ import type { AiJob, AiJobItemLedger } from '../model/ai-jobs.types';
 import { type AiSiteImportBuild, type AiSiteImportHome, type AiSiteImportLeftOutReason, type AiSiteImportPage, type AiSiteImportPageRead, type AiSiteImportState, type AiSiteImportWave } from '../model/ai-site-import';
 import { crawlSiteForImport, type SiteImportCrawlSeams, type SiteImportInventory } from '../site-import/site-import-crawl';
 import { type SiteImportPhotosDeps } from '../site-import/site-import-images';
+import { type AiLayoutFrameSource, type AiLayoutFrameSourceGround, type AiLayoutFrameSourceTo } from '../layout-language/ai-layout-frame-source';
 import { type AiSiteImportDocument } from './ai-site-import-document';
 import { aiRunSiteImportLook, type AiSiteImportLookDeps } from './ai-site-import-look';
 import { aiPublishImportedWave } from './ai-site-import-publish';
-import { fileSiteImportReview } from '../site-import/site-import-review';
 import { type AiJobAdmission } from './ai-job-admission';
 import { readAiScreenRoom } from './ai-job-drafts';
 import { type AiLayoutSitePage } from './ai-job-layout-site-pages';
@@ -90,7 +90,6 @@ export interface AiSiteImportStepDeps {
     fetchImage?: SiteImportPhotosDeps['fetch'];
     readRoom?: typeof readAiScreenRoom;
     readSiteName?: (firestore: FirebaseFirestore.Firestore, hostId: string) => Promise<string>;
-    fileReview?: typeof fileSiteImportReview;
     pageWritten?: typeof aiSitePageWritten;
     mintId?: () => string;
     clock?: () => number;
@@ -122,6 +121,26 @@ export declare function aiSiteImportBuildOf(page: Pick<AiSiteImportPage, 'group'
  * punctuation, else the person's.
  */
 export declare function aiSiteImportBrandName(given: string, own: string): string;
+/**
+ * Where a link of the source's header or footer goes on the new site
+ * (AGL-4108): a page the import brings in by its id, once its wave is the
+ * header's or before it; a page of a later wave by its address on the new
+ * site, which the page takes when its wave lands, since a link by id to a
+ * page not yet live is taken out when a wave goes live; and anywhere else by
+ * the source's own address, so a button that leaves the source leaves the
+ * new site too. `null` for an address no link may carry.
+ */
+export declare function aiSiteImportFrameLinkTo(state: Pick<AiSiteImportState, 'domain' | 'pages'>, wave: number): (href: string | null | undefined) => AiLayoutFrameSourceTo | null;
+/** The ground a source's header bar sits on (AGL-4108): dark, the brand's color, the page's own, or paper. */
+export declare function aiSiteImportHeaderGround(background: string | null, look: AiSiteImportHome['look']): AiLayoutFrameSourceGround;
+/**
+ * The site's header and footer as the source builds them (AGL-4108): its
+ * menu with its menus and their entries, its buttons with their own
+ * addresses and how they are drawn, and its footer, every link resolved
+ * (`aiSiteImportFrameLinkTo`). Every label is the source's, as written.
+ * `null` where the reader found no menu on the home page.
+ */
+export declare function aiSiteImportFrameSource(state: AiSiteImportState, wave: Pick<AiSiteImportWave, 'index'>): AiLayoutFrameSource | null;
 /** The header and footer's job: a layout of the site's brand, linking the wave's pages, in the layout language. */
 export declare function aiSiteImportFrameJob(job: AiJob, state: AiSiteImportState, wave: AiSiteImportWave, items: readonly AiJobItemLedger[]): AiJob;
 /** The page brought in, as its page job carries it: its lines, its photos, and the pages its links may go to (AGL-4084). */

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

@@ -21,8 +21,8 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  *
  *   1. READ the proved site (no model): the crawler reads it as AglynBot,
  *      main pages first, up to the plan's page count; the inventory is cut
- *      into waves (`model/ai-site-import.ts`), every page gets a ledger row,
- *      and Trust & Safety gets its row. The job then WAITS (`needs_review`,
+ *      into waves (`model/ai-site-import.ts`) and every page gets a ledger
+ *      row. The job then WAITS (`needs_review`,
  *      reason `wave`): nothing is brought in until the person starts wave 1.
  *   2. START A WAVE (no model), on the person's say-so: the proof is still
  *      current, the day's limit has room, the plan still has room; the
@@ -31,9 +31,13 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  *   3. THE LOOK, in the first wave (no model, AGL-4084): the theme drawn
  *      from the owner's own home page, its logo into the library, the site's
  *      listing from the home page's own words (`ai-site-import-look.ts`).
- *   4. THE HEADER AND FOOTER, in the first wave: the layout step's own pass,
- *      with the source's brand as its header draws it, its own header and
- *      footer words as the footer's facts, and the site's menu order.
+ *   4. THE HEADER AND FOOTER, in the first wave: the source's own menu, its
+ *      menus, its buttons and its footer as its home page builds them
+ *      (AGL-4108, `aiSiteImportFrameSource`), drawn by the layout step with
+ *      no model; for a source whose menu could not be read, the layout
+ *      step's own pass, with the source's brand as its header draws it, its
+ *      own header and footer words as the footer's facts, and the site's
+ *      menu order.
  *   5. EACH PAGE: its photos into the media library (no model, deduped by
  *      source key), then the page step's own passes, NEVER REWRITTEN
  *      (AGL-4084, `ai-site-import-document.ts`): a collection's page or a
@@ -57,18 +61,20 @@ import { listDomainOwnershipClaims, normalizeOwnershipDomain } from "@aglyn/tena
 import { getOrgForUser, memberHasOrgPermission } from "@aglyn/tenant-data-admin/server/organizations";
 import { consumeRateLimit } from "@aglyn/tenant-data-admin/server/rate-limit-store";
 import { isServerReleaseFlagOnForOrg } from "@aglyn/tenant-data-admin/server/release-flags";
-import { AI_SITE_IMPORT_DOMAIN_INPUT, AI_SITE_IMPORT_FRAME_SLOT, AI_SITE_IMPORT_LABEL_MAX_CHARS, AI_SITE_IMPORT_LEFT_OUT_COPY, AI_SITE_IMPORT_MAX_PAGES, AI_SITE_IMPORT_MIN_WORDS, AI_SITE_IMPORT_WAVE_PAGES, aiSiteImportInventory, aiSiteImportItemOpen, aiSiteImportLedger, aiSiteImportNextWork, aiSiteImportPageBuild, aiSiteImportPageSettled, aiSiteImportPagesRead, aiSiteImportPhotosIn, aiSiteImportReadStops, aiSiteImportReadVerdict, aiSiteImportReadVerdictMessage, aiSiteImportReadVerdictReason, aiSiteImportWaveClosed, aiSiteImportWaveMessage, aiSiteImportWaveStarted } from "../model/ai-site-import.js";
+import { AI_SITE_IMPORT_DOMAIN_INPUT, AI_SITE_IMPORT_FRAME_SLOT, AI_SITE_IMPORT_LABEL_MAX_CHARS, AI_SITE_IMPORT_LEFT_OUT_COPY, AI_SITE_IMPORT_MAX_PAGES, AI_SITE_IMPORT_MIN_WORDS, AI_SITE_IMPORT_WAVE_PAGES, aiSiteImportFrameIsRead, aiSiteImportInventory, aiSiteImportItemOpen, aiSiteImportLedger, aiSiteImportNextWork, aiSiteImportPageBuild, aiSiteImportPageSettled, aiSiteImportPagesRead, aiSiteImportPhotosIn, aiSiteImportReadStops, aiSiteImportReadVerdict, aiSiteImportReadVerdictMessage, aiSiteImportReadVerdictReason, aiSiteImportWaveClosed, aiSiteImportWaveMessage, aiSiteImportWaveStarted } from "../model/ai-site-import.js";
 import { aiModelForStep } from "../providers/routing.js";
 import { SITE_IMPORT_RELEASE_FLAG } from "../site-import/site-import-flag.js";
-import { crawlSiteForImport } from "../site-import/site-import-crawl.js";
+import { crawlSiteForImport, siteImportOrigins } from "../site-import/site-import-crawl.js";
 import { bringInSiteImportPhotos } from "../site-import/site-import-images.js";
 import { siteImportHeaderBrand, siteImportLabel, siteImportLeftOutReason, siteImportListedPage, siteImportPageRead, siteImportPageWords, siteImportSiteFacts, siteImportSiteName } from "../site-import/site-import-page.js";
 import { aiSiteKindFor } from "../model/ai-site-kinds.js";
-import { AI_LAYOUT_SITE_BRAND_INPUT, AI_LAYOUT_SITE_FACTS_INPUT } from "./ai-job-layout-language.js";
-import { AI_LAYOUT_IMPORTED_SECTIONS_INPUT, aiSiteImportDocLines } from "./ai-site-import-document.js";
+import { AI_LAYOUT_SITE_BRAND_INPUT, AI_LAYOUT_SITE_FACTS_INPUT, AI_LAYOUT_SITE_FRAME_INPUT } from "./ai-job-layout-language.js";
+import { aiLayoutTelHref } from "../layout-language/ai-layout-frame-source.js";
+import { aiHexOklch } from "../model/ai-site-look.js";
+import { AI_LAYOUT_IMPORTED_SECTIONS_INPUT } from "./ai-site-import-document.js";
+import { aiSiteImportSectionNames } from "./ai-site-import-compile.js";
 import { aiRunSiteImportLook } from "./ai-site-import-look.js";
 import { aiPublishImportedWave } from "./ai-site-import-publish.js";
-import { fileSiteImportReview } from "../site-import/site-import-review.js";
 import { aiUnitErrorRetryable, aiUnitFailure, aiUnitSpend } from "./ai-build-unit-outcome.js";
 import { registerAiJobAdmission } from "./ai-job-admission.js";
 import { AI_JOB_STEP_OVERHEAD_MS } from "./ai-job-budget.js";
@@ -210,9 +216,127 @@ const delivered = (items, slot)=>items.some((row)=>row.slot === slot && (row.sta
         } : {})
     } : {});
 }
+/**
+ * Where a link of the source's header or footer goes on the new site
+ * (AGL-4108): a page the import brings in by its id, once its wave is the
+ * header's or before it; a page of a later wave by its address on the new
+ * site, which the page takes when its wave lands, since a link by id to a
+ * page not yet live is taken out when a wave goes live; and anywhere else by
+ * the source's own address, so a button that leaves the source leaves the
+ * new site too. `null` for an address no link may carry.
+ */ export function aiSiteImportFrameLinkTo(state, wave) {
+    const origins = new Set(siteImportOrigins(state.domain));
+    const key = (path)=>path.replace(/\/+$/, '') || '/';
+    const pages = new Map(state.pages.filter((page)=>!page.refused).map((page)=>[
+            key(page.path),
+            page
+        ]));
+    return (href)=>{
+        const raw = String(href != null ? href : '').trim();
+        if (!raw) return null;
+        if (/^tel:/i.test(raw)) return aiLayoutTelHref(raw.slice(4));
+        if (/^mailto:/i.test(raw)) return /^mailto:[^\s@<>?#"]+@[^\s@<>?#"]+\.[^\s@<>?#".]{2,}$/i.test(raw) ? raw : null;
+        let url;
+        try {
+            url = new URL(raw);
+        } catch (unused) {
+            return null;
+        }
+        if (url.protocol !== 'https:' && url.protocol !== 'http:') return null;
+        if (origins.has(`https://${url.host}`)) {
+            const page = pages.get(key(decodeURIComponent(url.pathname)));
+            if (page) return page.slug === '/' || page.wave <= wave ? `page:${page.draftId}` : `/${page.slug}`;
+        }
+        // Anywhere else stays where the source sends it, over https.
+        url.protocol = 'https:';
+        return url.toString();
+    };
+}
+/** The ground a source's header bar sits on (AGL-4108): dark, the brand's color, the page's own, or paper. */ export function aiSiteImportHeaderGround(background, look) {
+    const hex = /^#[0-9a-f]{6}$/i.test(background != null ? background : '') ? background : null;
+    if (!hex) return 'paper';
+    const own = aiHexOklch(hex);
+    if (own.L < 0.4) return 'dark';
+    const near = (other, within)=>{
+        if (!other || !/^#[0-9a-f]{6}$/i.test(other)) return false;
+        const them = aiHexOklch(other);
+        const a = own.C * Math.cos(own.h * Math.PI / 180) - them.C * Math.cos(them.h * Math.PI / 180);
+        const b = own.C * Math.sin(own.h * Math.PI / 180) - them.C * Math.sin(them.h * Math.PI / 180);
+        return Math.hypot(own.L - them.L, a, b) <= within;
+    };
+    if (near(look == null ? void 0 : look.buttonFill, 0.05)) return 'brand';
+    // The page's own ground, unless that ground is white, which paper is.
+    if (near(look == null ? void 0 : look.background, 0.02) && own.L < 0.99) return 'page';
+    return 'paper';
+}
+/**
+ * The site's header and footer as the source builds them (AGL-4108): its
+ * menu with its menus and their entries, its buttons with their own
+ * addresses and how they are drawn, and its footer, every link resolved
+ * (`aiSiteImportFrameLinkTo`). Every label is the source's, as written.
+ * `null` where the reader found no menu on the home page.
+ */ export function aiSiteImportFrameSource(state, wave) {
+    var _home_footer, _home_look, _footer_copyright;
+    const home = state.home;
+    const nav = home == null ? void 0 : home.nav;
+    if (!home || !nav || !aiSiteImportFrameIsRead(state)) return null;
+    const to = aiSiteImportFrameLinkTo(state, wave.index);
+    const link = (label, href)=>{
+        const target = to(href);
+        return label && target ? {
+            label,
+            to: target
+        } : null;
+    };
+    const present = (value)=>value !== null;
+    const footer = (_home_footer = home.footer) != null ? _home_footer : null;
+    return {
+        nav: nav.items.map((group)=>({
+                label: group.label,
+                to: to(group.href),
+                items: group.items.map((entry)=>{
+                    var _entry_viewBox;
+                    const target = link(entry.label, entry.href);
+                    if (!target) return null;
+                    return _extends({}, target, entry.text ? {
+                        text: entry.text
+                    } : {}, entry.iconPath && ((_entry_viewBox = entry.viewBox) != null ? _entry_viewBox : '0 0 24 24') === '0 0 24 24' ? {
+                        iconPath: entry.iconPath
+                    } : {}, entry.column ? {
+                        column: entry.column
+                    } : {});
+                }).filter(present)
+            })).filter((group)=>group.items.length || group.to),
+        ctas: nav.ctas.map((cta)=>{
+            const target = link(cta.label, cta.href);
+            return target ? _extends({}, target, {
+                style: cta.style
+            }) : null;
+        }).filter(present),
+        header: aiSiteImportHeaderGround(nav.background, (_home_look = home.look) != null ? _home_look : null),
+        footer: footer ? {
+            columns: footer.columns.map((column)=>({
+                    heading: column.heading,
+                    links: column.links.map((entry)=>link(entry.label, entry.href)).filter(present)
+                })).filter((column)=>column.links.length),
+            links: footer.links.map((entry)=>link(entry.label, entry.href)).filter(present),
+            text: footer.text,
+            social: footer.social.map((entry)=>/^https:\/\//i.test(entry.href) ? {
+                    label: entry.label,
+                    to: entry.href,
+                    network: entry.network
+                } : null).filter(present),
+            address: footer.address,
+            phone: footer.phone,
+            email: footer.email,
+            // The © line as the source writes it; where it writes none, the source's own name.
+            copyright: (_footer_copyright = footer.copyright) != null ? _footer_copyright : home.siteName ? `© ${home.siteName}` : null
+        } : null
+    };
+}
 /** The header and footer's job: a layout of the site's brand, linking the wave's pages, in the layout language. */ export function aiSiteImportFrameJob(job, state, wave, items) {
     var _ref, _state_home, _ref1, _ref2;
-    var _state_frame, _state_look;
+    var _state_frame, _state_look, _home_brand_logo;
     const draftId = (_ref = (_state_frame = state.frame) == null ? void 0 : _state_frame.draftId) != null ? _ref : `${job.$id}-${AI_SITE_IMPORT_FRAME_SLOT}`;
     const creation = {
         kind: 'layout',
@@ -230,13 +354,23 @@ const delivered = (items, slot)=>items.some((row)=>row.slot === slot && (row.sta
     const home = (_state_home = state.home) != null ? _state_home : null;
     const logo = (_ref1 = (_state_look = state.look) == null ? void 0 : _state_look.logo) != null ? _ref1 : null;
     // The brand as the source's header draws it; with no logo in the library, its name.
-    const brand = home ? _extends({}, logo && home.brand.kind !== 'name-only' ? {
+    // The logo is named as the source names it, never by the host's name (AGL-4108).
+    const withLogo = !!logo && !!home && home.brand.kind !== 'name-only';
+    const alt = home ? (((_home_brand_logo = home.brand.logo) == null ? void 0 : _home_brand_logo.alt) || home.siteName || home.brand.text).replace(/\s+/g, ' ').trim().slice(0, 120) : '';
+    const aspect = (logo == null ? void 0 : logo.width) && logo.height ? Math.round(logo.width / logo.height * 1000) / 1000 : null;
+    const brand = home ? _extends({}, withLogo ? _extends({
         logo: {
             src: logo.src
         }
-    } : {}, {
+    }, alt ? {
+        alt
+    } : {}, aspect ? {
+        aspect
+    } : {}) : {}, {
         name: !logo || home.brand.kind !== 'logo-only'
     }) : null;
+    // The source's own menu, buttons and footer, drawn with no model (AGL-4108).
+    const source = aiSiteImportFrameSource(state, wave);
     return _extends({}, job, {
         $id: draftId,
         kind: 'layout',
@@ -256,6 +390,8 @@ const delivered = (items, slot)=>items.some((row)=>row.slot === slot && (row.sta
             [AI_LAYOUT_SITE_PAGES_INPUT]: aiSiteImportLinkedPages(state, items, wave.index)
         }, aiSiteImportDesignInputs(state), brand ? {
             [AI_LAYOUT_SITE_BRAND_INPUT]: brand
+        } : {}, source ? {
+            [AI_LAYOUT_SITE_FRAME_INPUT]: source
         } : {}, home ? {
             [AI_LAYOUT_SITE_FACTS_INPUT]: {
                 url: home.url,
@@ -269,16 +405,18 @@ const delivered = (items, slot)=>items.some((row)=>row.slot === slot && (row.sta
 }
 /** The page brought in, as its page job carries it: its lines, its photos, and the pages its links may go to (AGL-4084). */ export function aiSiteImportDocumentFor(state, page) {
     var _page_build, _ref;
-    var _page_read, _page_photos;
+    var _page_read, _page_photos, _page_read1;
     const blocks = (_page_read = page.read) == null ? void 0 : _page_read.blocks;
     if (!(blocks == null ? void 0 : blocks.length)) return null;
-    return {
+    return _extends({
         build: (_page_build = page.build) != null ? _page_build : aiSiteImportBuildOf(page),
         title: page.title,
         url: page.url,
         blocks,
         photos: (_ref = (_page_photos = page.photos) == null ? void 0 : _page_photos.assets) != null ? _ref : [],
-        // Home's own links are words: a link home says home, which the source's words may not.
+        // Every page the import plans, in any wave (AGL-4107): a link to one still
+        // to come shows its words until it is live. Home's own links are words: a
+        // link home says home, which the source's words may not.
         links: state.pages.filter((entry)=>entry.slug !== '/' && !entry.refused).map((entry)=>({
                 path: entry.path.replace(/\/+$/, '') || '/',
                 id: entry.draftId
@@ -287,14 +425,17 @@ const delivered = (items, slot)=>items.some((row)=>row.slot === slot && (row.sta
             `https://${state.domain}`,
             `https://www.${state.domain.replace(/^www\./, '')}`
         ]
-    };
+    }, ((_page_read1 = page.read) == null ? void 0 : _page_read1.layout) ? {
+        layout: page.read.layout
+    } : {});
 }
 /** One page's job: a page job's plan of one screen, its sections the old page's own, its words carried as they are. */ export function aiSiteImportPageJob(job, state, page, items) {
-    var _ref, _ref1, _ref2, _ref3;
-    var _page_read, _state_home, _page_read1, _page_photos;
+    var _ref, _ref1, _ref2, _ref3, _ref4;
+    var _page_read, _page_read_meta, _page_read1, _page_read_meta1, _page_read2, _state_home, _page_read3, _page_photos;
     const doc = aiSiteImportDocumentFor(state, page);
-    // The page's sections are the source's own (AGL-4084): its opening, then one at each second-level heading.
-    const names = doc ? aiSiteImportDocLines(doc.blocks, doc.title).sections.map((section)=>section.name) : (_ref = (_page_read = page.read) == null ? void 0 : _page_read.sections) != null ? _ref : [];
+    // The page's sections are the source's own (AGL-4107): as its layout names
+    // them, else its opening and one at each second-level heading.
+    const names = doc ? aiSiteImportSectionNames(doc) : (_ref = (_page_read = page.read) == null ? void 0 : _page_read.sections) != null ? _ref : [];
     const sections = (names.length ? names : [
         'Introduction'
     ]).map((name)=>({
@@ -310,8 +451,9 @@ const delivered = (items, slot)=>items.some((row)=>row.slot === slot && (row.sta
         template: null,
         duplicateOf: null,
         nav: false,
-        seoTitle: page.title,
-        seoDescription: '',
+        // The source's own title and description, word for word (AGL-4107).
+        seoTitle: ((_page_read1 = page.read) == null ? void 0 : (_page_read_meta = _page_read1.meta) == null ? void 0 : _page_read_meta.title) || page.title,
+        seoDescription: (_ref1 = (_page_read2 = page.read) == null ? void 0 : (_page_read_meta1 = _page_read2.meta) == null ? void 0 : _page_read_meta1.description) != null ? _ref1 : '',
         sections,
         record: null,
         id: page.draftId
@@ -332,7 +474,7 @@ const delivered = (items, slot)=>items.some((row)=>row.slot === slot && (row.sta
         }),
         inputs: _extends({
             originJobId: job.$id,
-            businessName: aiSiteImportBrandName(state.siteName, (_ref1 = (_state_home = state.home) == null ? void 0 : _state_home.siteName) != null ? _ref1 : ''),
+            businessName: aiSiteImportBrandName(state.siteName, (_ref2 = (_state_home = state.home) == null ? void 0 : _state_home.siteName) != null ? _ref2 : ''),
             [AI_LAYOUT_LANGUAGE_INPUT]: true,
             [AI_LAYOUT_SITE_PAGES_INPUT]: aiSiteImportLinkedPages(state, items, page.wave)
         }, aiSiteImportDesignInputs(state), doc ? {
@@ -340,10 +482,10 @@ const delivered = (items, slot)=>items.some((row)=>row.slot === slot && (row.sta
         } : {
             [AI_LAYOUT_IMPORTED_PAGE_INPUT]: {
                 url: page.url,
-                text: (_ref2 = (_page_read1 = page.read) == null ? void 0 : _page_read1.text) != null ? _ref2 : ''
+                text: (_ref3 = (_page_read3 = page.read) == null ? void 0 : _page_read3.text) != null ? _ref3 : ''
             }
         }, {
-            [AI_LAYOUT_PAGE_PHOTOS_INPUT]: (_ref3 = (_page_photos = page.photos) == null ? void 0 : _page_photos.assets) != null ? _ref3 : []
+            [AI_LAYOUT_PAGE_PHOTOS_INPUT]: (_ref4 = (_page_photos = page.photos) == null ? void 0 : _page_photos.assets) != null ? _ref4 : []
         }, others.length ? {
             [AI_STOCK_PHOTO_PAGES_INPUT]: others
         } : {}),
@@ -380,7 +522,7 @@ const delivered = (items, slot)=>items.some((row)=>row.slot === slot && (row.sta
         const text = (line != null ? line : '').replace(/\s+/g, ' ').trim();
         if (text && !lines.some((entry)=>entry.includes(text))) lines.push(text);
     }
-    return {
+    return _extends({
         url: page.url,
         title: siteImportLabel((_page_title = page.title) != null ? _page_title : '', 160),
         description: siteImportLabel((_page_description = page.description) != null ? _page_description : '', 320),
@@ -402,7 +544,13 @@ const delivered = (items, slot)=>items.some((row)=>row.slot === slot && (row.sta
             social: facts.social,
             address: (_ref = (_facts_organization = facts.organization) == null ? void 0 : _facts_organization.address) != null ? _ref : ''
         }
-    };
+    }, page.nav ? {
+        nav: page.nav
+    } : {}, page.footer ? {
+        footer: page.footer
+    } : {}, page.look ? {
+        look: page.look
+    } : {});
 }
 /** The least time the import's next pass needs: a read's, a photo pass's, or the time of the step its unit is handed to. */ export function aiSiteImportRunMinimumMs(job, runnerFor = aiJobStepRunnerFor) {
     var _job_siteImport, _job_items;
@@ -499,7 +647,7 @@ async function readDraftWords(firestore, hostId, draftId) {
     return wave.slots.every((slot)=>!aiSiteImportItemOpen(items, slot));
 }
 export function createAiJobImportStep(deps = {}) {
-    var _deps_crawl, _deps_runnerFor, _deps_ownership, _deps_rateLimit, _deps_releaseFlagOn, _deps_ingest, _deps_readRoom, _deps_readSiteName, _deps_fileReview, _deps_pageWritten, _deps_mintId, _deps_clock, _deps_look, _deps_publishWave, _deps_draftWords;
+    var _deps_crawl, _deps_runnerFor, _deps_ownership, _deps_rateLimit, _deps_releaseFlagOn, _deps_ingest, _deps_readRoom, _deps_readSiteName, _deps_pageWritten, _deps_mintId, _deps_clock, _deps_look, _deps_publishWave, _deps_draftWords;
     const crawl = (_deps_crawl = deps.crawl) != null ? _deps_crawl : crawlSiteForImport;
     const runnerFor = (_deps_runnerFor = deps.runnerFor) != null ? _deps_runnerFor : aiJobStepRunnerFor;
     const ownershipOf = (_deps_ownership = deps.ownership) != null ? _deps_ownership : readOwnership;
@@ -508,7 +656,6 @@ export function createAiJobImportStep(deps = {}) {
     const ingestOf = (_deps_ingest = deps.ingest) != null ? _deps_ingest : pluginMediaIngest;
     const readRoom = (_deps_readRoom = deps.readRoom) != null ? _deps_readRoom : readAiScreenRoom;
     const siteNameOf = (_deps_readSiteName = deps.readSiteName) != null ? _deps_readSiteName : readSiteName;
-    const fileReview = (_deps_fileReview = deps.fileReview) != null ? _deps_fileReview : fileSiteImportReview;
     const pageWritten = (_deps_pageWritten = deps.pageWritten) != null ? _deps_pageWritten : aiSitePageWritten;
     const mintId = (_deps_mintId = deps.mintId) != null ? _deps_mintId : createResourceUid;
     const clock = (_deps_clock = deps.clock) != null ? _deps_clock : Date.now;
@@ -533,17 +680,6 @@ export function createAiJobImportStep(deps = {}) {
         const items = (_job_items = job.items) != null ? _job_items : [];
         const work = aiSiteImportNextWork(state, items);
         const nowIso = now.toISOString();
-        const review = (event, next, ledger, wave)=>fileReview(firestore, _extends({
-                orgId: job.orgId,
-                hostId,
-                jobId: job.$id,
-                state: next,
-                items: ledger,
-                event,
-                nowMs: now.getTime()
-            }, wave !== undefined ? {
-                wave
-            } : {}));
         /** Closes the wave when this pass settled its last row: the review, or the job's end after the last wave. */ const closing = async (next, ledger, wave, outcome)=>{
             var _closed_waves_find;
             if (!waveSettled(next, wave, ledger)) return _extends({}, outcome, {
@@ -578,7 +714,6 @@ export function createAiJobImportStep(deps = {}) {
             const published = sitePublish ? {
                 sitePublish
             } : {};
-            await review('wave-finished', closed, ledger, wave.index);
             const waiting = ((_closed_waves_find = closed.waves.find((entry)=>entry.index === wave.index)) == null ? void 0 : _closed_waves_find.status) === 'review';
             if (waiting) {
                 const message = (sitePublish == null ? void 0 : sitePublish.published.length) ? aiSiteImportPreviewMessage(closed, wave, sitePublish.published.length) : aiSiteImportWaveMessage(closed, ledger);
@@ -701,14 +836,10 @@ export function createAiJobImportStep(deps = {}) {
                 home: aiSiteImportHomeOf(crawled)
             });
             const ledger = aiSiteImportLedger(planned);
-            const reviewId = await review('read', planned, ledger);
-            const next = _extends({}, planned, {
-                reviewId
-            });
             return unspent({
                 items: ledger,
-                siteImport: next,
-                review: waveReview(aiSiteImportWaveMessage(next, ledger))
+                siteImport: planned,
+                review: waveReview(aiSiteImportWaveMessage(planned, ledger))
             });
         }
         if (!state) return unspent({
@@ -771,7 +902,6 @@ export function createAiJobImportStep(deps = {}) {
                     }) : row);
             }
             const started = aiSiteImportWithBuilds(aiSiteImportWaveStarted(state, wave.index, nowIso, reads));
-            await review('wave-started', started, ledger, wave.index);
             const running = started.waves.find((entry)=>entry.index === wave.index);
             return closing(started, ledger, running, unspent({
                 items: ledger