@aglyn/plugins-ai 1.0.0-beta.271 → 1.0.0-beta.273

package/src/lib/model/ai-site-import-view.d.ts

@@ -0,0 +1,130 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { AiJobSummary } from './ai-jobs.types';
+import { type AiSiteImportLeftOutReason, type AiSiteImportState, type AiSiteImportWave } from './ai-site-import';
+/** A domain ownership claim, as the ownership door answers it. */
+export interface AiSiteImportClaim {
+    domain: string;
+    status: 'pending' | 'proven';
+    current: boolean;
+    provenMethod: 'dns' | 'meta' | 'email' | null;
+    provenAt: number | null;
+    provenDetail: string | null;
+    lastChecks: Partial<Record<'dns' | 'meta' | 'email', 'proven' | 'not-yet' | 'unreachable'>>;
+    dns: {
+        host: string;
+        type: 'TXT';
+        value: string;
+    };
+    meta: {
+        name: string;
+        content: string;
+        tag: string;
+    };
+    email: {
+        domain: string;
+        pendingAddress: string | null;
+        expiresAt: number | null;
+        attemptsLeft: number | null;
+    };
+}
+/** Whether "Bring my site" is offered here, and if not why. */
+export type AiSiteImportAvailability = {
+    state: 'checking';
+}
+/** The release flag is off, or the doors cannot be reached: the card is not drawn. */
+ | {
+    state: 'hidden';
+}
+/** Something the workspace can change stands in the way: the card is drawn disabled, with the reason. */
+ | {
+    state: 'blocked';
+    reason: 'plan' | 'role';
+    message: string;
+} | {
+    state: 'ready';
+    claims: AiSiteImportClaim[];
+};
+/** What the card says to a plan that does not include it. */
+export declare const AI_SITE_IMPORT_PLAN_COPY = "Bring your current website in, every page and photo, on any paid plan. Upgrade to bring yours in.";
+/** What the card says to a member who cannot. */
+export declare const AI_SITE_IMPORT_ROLE_COPY = "Only the workspace owner or an admin can bring a site in.";
+/**
+ * The jobs list's `siteImport` offer (AGL-3976), as the card's state: absent
+ * is the flag off, and the card is not drawn; `plan` and `role` are drawn
+ * disabled with the reason.
+ */
+export declare function aiSiteImportOfferOf(offer: unknown): AiSiteImportAvailability;
+/** Where an import job's page is. */
+export type AiSiteImportPhase = 
+/** The site is being read. */
+'reading'
+/** Read and planned; the first wave waits to be started. */
+ | 'ready'
+/** A wave was started and has not begun yet. */
+ | 'starting' | 'running'
+/** A wave is in; the next waits to be started. */
+ | 'review'
+/** Held for something the person does: verify again, wait for tomorrow, read again. */
+ | 'held'
+/** Out of AI credits or at a cap: the meter's pause, carried on by Resume. */
+ | 'paused' | 'done' | 'stopped';
+export declare function aiSiteImportPhaseOf(job: Pick<AiJobSummary, 'status' | 'review' | 'siteImport'>): AiSiteImportPhase;
+export type AiSiteImportRowState = 'waiting' | 'active' | 'done' | 'failed' | 'skipped';
+export interface AiSiteImportRowView {
+    slot: string;
+    title: string;
+    /** Where it is on the old site. */
+    from: string;
+    /** Where it is on the new one. */
+    to: string;
+    state: AiSiteImportRowState;
+    /** Why it failed or was left out, or what the person should know. */
+    note: string | null;
+    /** "3 photos added, 1 already in your library". */
+    photos: string | null;
+    /** The draft the row wrote, by its output id. */
+    outputId: string | null;
+}
+/** "3 photos added", "2 photos added, 1 already in your library". */
+export declare function aiSiteImportPhotosText(photos: {
+    brought: number;
+    reused: number;
+} | null | undefined): string | null;
+/** One wave's rows, the header and footer first where the wave builds them. */
+export declare function aiSiteImportWaveRows(job: Pick<AiJobSummary, 'items' | 'siteImport' | 'status'>, wave: AiSiteImportWave): AiSiteImportRowView[];
+/** "About 189 credits (up to 650)" for the wave, as it stands. */
+export declare function aiSiteImportWaveQuote(job: Pick<AiJobSummary, 'items' | 'siteImport'>, wave: AiSiteImportWave): string;
+/** What a wave cost, its pages' credits less what was given back. */
+export declare function aiSiteImportWaveSpent(job: Pick<AiJobSummary, 'items'>, wave: AiSiteImportWave): number;
+/** The read site in one sentence: "Found 21 pages on harbor-dental.com: Main pages (6) and Blog (14)." */
+export declare function aiSiteImportFoundText(state: AiSiteImportState): string;
+/** The plan's page count against the site: "Your plan includes 25 pages and this site has 0, so 20 are brought in." */
+export declare function aiSiteImportPlanText(state: AiSiteImportState): string;
+/** What was left out, by reason, most first. */
+export declare function aiSiteImportLeftOutLines(state: AiSiteImportState): Array<{
+    reason: AiSiteImportLeftOutReason;
+    count: number;
+    text: string;
+    paths: string[];
+}>;
+/** The wave a page offers to start next, and its button's words. */
+export declare function aiSiteImportStartAction(job: Pick<AiJobSummary, 'siteImport' | 'items'>): {
+    wave: AiSiteImportWave;
+    label: string;
+    quote: string;
+} | null;

package/src/lib/model/ai-site-import-view.js

@@ -0,0 +1,182 @@
+/**
+ * @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.
+ */ /*==========================================
+ * BRING MY SITE, AS THE CONSOLE SHOWS IT (AGL-3976).
+ *
+ * Pure: what the "Create site" choice card says before anyone clicks, and
+ * what an import job's page shows in each of its states — the site read and
+ * its waves planned, a wave running, a wave in for review, a wave held for a
+ * proof or the day's limit, the import done. The components draw these; the
+ * specs hold them.
+ *=========================================*/ import { aiCreditRangeText } from "./ai-credit-estimate.js";
+import { AI_SITE_IMPORT_FRAME_SLOT, AI_SITE_IMPORT_LEFT_OUT_COPY, AI_SITE_IMPORT_LEFT_OUT_REASONS, aiSiteImportNextWave, aiSiteImportPagesText, aiSiteImportReviewWave, aiSiteImportRunningWave, aiSiteImportWaveCreditRange } from "./ai-site-import.js";
+/** What the card says to a plan that does not include it. */ export const AI_SITE_IMPORT_PLAN_COPY = 'Bring your current website in, every page and photo, on any paid plan. Upgrade to bring yours in.';
+/** What the card says to a member who cannot. */ export const AI_SITE_IMPORT_ROLE_COPY = 'Only the workspace owner or an admin can bring a site in.';
+/**
+ * The jobs list's `siteImport` offer (AGL-3976), as the card's state: absent
+ * is the flag off, and the card is not drawn; `plan` and `role` are drawn
+ * disabled with the reason.
+ */ export function aiSiteImportOfferOf(offer) {
+    if (offer === 'ready') return {
+        state: 'ready',
+        claims: []
+    };
+    if (offer === 'plan') return {
+        state: 'blocked',
+        reason: 'plan',
+        message: AI_SITE_IMPORT_PLAN_COPY
+    };
+    if (offer === 'role') return {
+        state: 'blocked',
+        reason: 'role',
+        message: AI_SITE_IMPORT_ROLE_COPY
+    };
+    return {
+        state: 'hidden'
+    };
+}
+export function aiSiteImportPhaseOf(job) {
+    var _job_siteImport;
+    const state = (_job_siteImport = job.siteImport) != null ? _job_siteImport : null;
+    if (job.status === 'done') return 'done';
+    if (job.status === 'failed' || job.status === 'canceled') return 'stopped';
+    if (job.status === 'needs_input') return 'paused';
+    if (job.status === 'needs_review') {
+        var _job_review;
+        if (((_job_review = job.review) == null ? void 0 : _job_review.reason) !== 'wave' || !state) return 'held';
+        return aiSiteImportReviewWave(state) ? 'review' : 'ready';
+    }
+    if (!state) return 'reading';
+    return aiSiteImportRunningWave(state) ? 'running' : 'starting';
+}
+function rowState(row, active) {
+    if (!row) return 'waiting';
+    if (row.status === 'succeeded' || row.status === 'degraded') return 'done';
+    if (row.status === 'failed') return 'failed';
+    if (row.status === 'skipped') return 'skipped';
+    return active ? 'active' : 'waiting';
+}
+/** "3 photos added", "2 photos added, 1 already in your library". */ export function aiSiteImportPhotosText(photos) {
+    if (!photos || photos.brought + photos.reused === 0) return null;
+    const added = photos.brought ? `${photos.brought} ${photos.brought === 1 ? 'photo' : 'photos'} added` : '';
+    const reused = photos.reused ? `${photos.reused} already in your media library` : '';
+    return [
+        added,
+        reused
+    ].filter(Boolean).join(', ');
+}
+/** One wave's rows, the header and footer first where the wave builds them. */ export function aiSiteImportWaveRows(job, wave) {
+    var _job_items;
+    const state = job.siteImport;
+    const items = new Map(((_job_items = job.items) != null ? _job_items : []).map((row)=>[
+            row.slot,
+            row
+        ]));
+    const running = wave.status === 'running' && (job.status === 'running' || job.status === 'queued');
+    let activeTaken = false;
+    const active = (row)=>{
+        if (!running || activeTaken || !row || row.status !== 'pending' && row.status !== 'running') return false;
+        activeTaken = true;
+        return true;
+    };
+    const rows = [];
+    if (wave.frame && state.frame) {
+        var _ref, _ref1, _ref2;
+        var _row_failure;
+        const row = items.get(AI_SITE_IMPORT_FRAME_SLOT);
+        rows.push({
+            slot: AI_SITE_IMPORT_FRAME_SLOT,
+            title: 'Header and footer',
+            from: `Your menu on ${state.domain}`,
+            to: 'Every page',
+            state: rowState(row, active(row)),
+            note: (_ref = (_ref1 = row == null ? void 0 : (_row_failure = row.failure) == null ? void 0 : _row_failure.message) != null ? _ref1 : row == null ? void 0 : row.note) != null ? _ref : null,
+            photos: null,
+            outputId: (_ref2 = row == null ? void 0 : row.outputs[0]) != null ? _ref2 : null
+        });
+    }
+    for (const slot of wave.slots){
+        var _ref3, _ref4, _ref5;
+        var _row_failure1;
+        const page = state.pages.find((entry)=>entry.slot === slot);
+        if (!page) continue;
+        const row = items.get(slot);
+        rows.push({
+            slot,
+            title: page.title,
+            from: page.path,
+            to: page.slug === '/' ? '/' : `/${page.slug}`,
+            state: rowState(row, active(row)),
+            note: (_ref3 = (_ref4 = row == null ? void 0 : (_row_failure1 = row.failure) == null ? void 0 : _row_failure1.message) != null ? _ref4 : row == null ? void 0 : row.note) != null ? _ref3 : page.refused ? AI_SITE_IMPORT_LEFT_OUT_COPY[page.refused] : null,
+            photos: aiSiteImportPhotosText(page.photos),
+            outputId: (_ref5 = row == null ? void 0 : row.outputs[0]) != null ? _ref5 : null
+        });
+    }
+    return rows;
+}
+/** "About 189 credits (up to 650)" for the wave, as it stands. */ export function aiSiteImportWaveQuote(job, wave) {
+    var _job_items;
+    return aiCreditRangeText(aiSiteImportWaveCreditRange(job.siteImport, wave, (_job_items = job.items) != null ? _job_items : null));
+}
+/** What a wave cost, its pages' credits less what was given back. */ export function aiSiteImportWaveSpent(job, wave) {
+    var _job_items;
+    const slots = new Set([
+        ...wave.slots,
+        ...wave.frame ? [
+            AI_SITE_IMPORT_FRAME_SLOT
+        ] : []
+    ]);
+    return ((_job_items = job.items) != null ? _job_items : []).filter((row)=>slots.has(row.slot)).reduce((total, row)=>{
+        var _row_creditsSpent, _row_creditsRefunded;
+        return total + Math.max(0, ((_row_creditsSpent = row.creditsSpent) != null ? _row_creditsSpent : 0) - ((_row_creditsRefunded = row.creditsRefunded) != null ? _row_creditsRefunded : 0));
+    }, 0);
+}
+/** The read site in one sentence: "Found 21 pages on harbor-dental.com: Main pages (6) and Blog (14)." */ export function aiSiteImportFoundText(state) {
+    const groups = state.groups.map((group)=>`${group.label} (${group.pages})`);
+    const listed = groups.length <= 1 ? groups.join('') : `${groups.slice(0, -1).join(', ')} and ${groups[groups.length - 1]}`;
+    const found = `Found ${aiSiteImportPagesText(state.found)} on ${state.domain}`;
+    return listed ? `${found}: ${listed}.` : `${found}.`;
+}
+/** The plan's page count against the site: "Your plan includes 25 pages and this site has 0, so 20 are brought in." */ export function aiSiteImportPlanText(state) {
+    const kept = state.pages.length;
+    const waves = state.waves.length;
+    const plan = state.pageLimit === null ? 'Your plan has no page limit' : `Your plan includes ${aiSiteImportPagesText(state.pageLimit)} and this site has ${state.existingPages}`;
+    return `${plan}, so ${aiSiteImportPagesText(kept)} ${kept === 1 ? 'is' : 'are'} brought in, in ${waves === 1 ? 'one wave' : `${waves} waves`}.`;
+}
+/** What was left out, by reason, most first. */ export function aiSiteImportLeftOutLines(state) {
+    return AI_SITE_IMPORT_LEFT_OUT_REASONS.map((reason)=>{
+        var _state_leftOutCount_reason;
+        return {
+            reason,
+            count: (_state_leftOutCount_reason = state.leftOutCount[reason]) != null ? _state_leftOutCount_reason : 0,
+            text: AI_SITE_IMPORT_LEFT_OUT_COPY[reason],
+            paths: state.leftOut.filter((entry)=>entry.reason === reason).map((entry)=>entry.path)
+        };
+    }).filter((line)=>line.count > 0).sort((a, b)=>b.count - a.count);
+}
+/** The wave a page offers to start next, and its button's words. */ export function aiSiteImportStartAction(job) {
+    var _job_siteImport;
+    const state = (_job_siteImport = job.siteImport) != null ? _job_siteImport : null;
+    const wave = aiSiteImportNextWave(state);
+    if (!state || !wave) return null;
+    return {
+        wave,
+        label: `Start ${wave.label}`,
+        quote: aiSiteImportWaveQuote(job, wave)
+    };
+}
+
+//# sourceMappingURL=ai-site-import-view.js.map

package/src/lib/model/ai-site-import-view.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-site-import-view.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/*==========================================\n * BRING MY SITE, AS THE CONSOLE SHOWS IT (AGL-3976).\n *\n * Pure: what the \"Create site\" choice card says before anyone clicks, and\n * what an import job's page shows in each of its states — the site read and\n * its waves planned, a wave running, a wave in for review, a wave held for a\n * proof or the day's limit, the import done. The components draw these; the\n * specs hold them.\n *=========================================*/\n\nimport { aiCreditRangeText } from './ai-credit-estimate'\nimport type { AiJobItemLedger, AiJobSummary } from './ai-jobs.types'\nimport {\n  AI_SITE_IMPORT_FRAME_SLOT,\n  AI_SITE_IMPORT_LEFT_OUT_COPY,\n  AI_SITE_IMPORT_LEFT_OUT_REASONS,\n  aiSiteImportNextWave,\n  aiSiteImportPagesText,\n  aiSiteImportReviewWave,\n  aiSiteImportRunningWave,\n  aiSiteImportWaveCreditRange,\n  type AiSiteImportLeftOutReason,\n  type AiSiteImportState,\n  type AiSiteImportWave,\n} from './ai-site-import'\n\n/** A domain ownership claim, as the ownership door answers it. */\nexport interface AiSiteImportClaim {\n  domain: string\n  status: 'pending' | 'proven'\n  current: boolean\n  provenMethod: 'dns' | 'meta' | 'email' | null\n  provenAt: number | null\n  provenDetail: string | null\n  lastChecks: Partial<Record<'dns' | 'meta' | 'email', 'proven' | 'not-yet' | 'unreachable'>>\n  dns: { host: string; type: 'TXT'; value: string }\n  meta: { name: string; content: string; tag: string }\n  email: { domain: string; pendingAddress: string | null; expiresAt: number | null; attemptsLeft: number | null }\n}\n\n/** Whether \"Bring my site\" is offered here, and if not why. */\nexport type AiSiteImportAvailability =\n  | { state: 'checking' }\n  /** The release flag is off, or the doors cannot be reached: the card is not drawn. */\n  | { state: 'hidden' }\n  /** Something the workspace can change stands in the way: the card is drawn disabled, with the reason. */\n  | { state: 'blocked'; reason: 'plan' | 'role'; message: string }\n  | { state: 'ready'; claims: AiSiteImportClaim[] }\n\n/** What the card says to a plan that does not include it. */\nexport const AI_SITE_IMPORT_PLAN_COPY =\n  'Bring your current website in, every page and photo, on any paid plan. Upgrade to bring yours in.'\n\n/** What the card says to a member who cannot. */\nexport const AI_SITE_IMPORT_ROLE_COPY = 'Only the workspace owner or an admin can bring a site in.'\n\n/**\n * The jobs list's `siteImport` offer (AGL-3976), as the card's state: absent\n * is the flag off, and the card is not drawn; `plan` and `role` are drawn\n * disabled with the reason.\n */\nexport function aiSiteImportOfferOf(offer: unknown): AiSiteImportAvailability {\n  if (offer === 'ready') return { state: 'ready', claims: [] }\n  if (offer === 'plan') return { state: 'blocked', reason: 'plan', message: AI_SITE_IMPORT_PLAN_COPY }\n  if (offer === 'role') return { state: 'blocked', reason: 'role', message: AI_SITE_IMPORT_ROLE_COPY }\n  return { state: 'hidden' }\n}\n\n/** Where an import job's page is. */\nexport type AiSiteImportPhase =\n  /** The site is being read. */\n  | 'reading'\n  /** Read and planned; the first wave waits to be started. */\n  | 'ready'\n  /** A wave was started and has not begun yet. */\n  | 'starting'\n  | 'running'\n  /** A wave is in; the next waits to be started. */\n  | 'review'\n  /** Held for something the person does: verify again, wait for tomorrow, read again. */\n  | 'held'\n  /** Out of AI credits or at a cap: the meter's pause, carried on by Resume. */\n  | 'paused'\n  | 'done'\n  | 'stopped'\n\nexport function aiSiteImportPhaseOf(job: Pick<AiJobSummary, 'status' | 'review' | 'siteImport'>): AiSiteImportPhase {\n  const state = job.siteImport ?? null\n  if (job.status === 'done') return 'done'\n  if (job.status === 'failed' || job.status === 'canceled') return 'stopped'\n  if (job.status === 'needs_input') return 'paused'\n  if (job.status === 'needs_review') {\n    if (job.review?.reason !== 'wave' || !state) return 'held'\n    return aiSiteImportReviewWave(state) ? 'review' : 'ready'\n  }\n  if (!state) return 'reading'\n  return aiSiteImportRunningWave(state) ? 'running' : 'starting'\n}\n\nexport type AiSiteImportRowState = 'waiting' | 'active' | 'done' | 'failed' | 'skipped'\n\nexport interface AiSiteImportRowView {\n  slot: string\n  title: string\n  /** Where it is on the old site. */\n  from: string\n  /** Where it is on the new one. */\n  to: string\n  state: AiSiteImportRowState\n  /** Why it failed or was left out, or what the person should know. */\n  note: string | null\n  /** \"3 photos added, 1 already in your library\". */\n  photos: string | null\n  /** The draft the row wrote, by its output id. */\n  outputId: string | null\n}\n\nfunction rowState(row: AiJobItemLedger | undefined, active: boolean): AiSiteImportRowState {\n  if (!row) return 'waiting'\n  if (row.status === 'succeeded' || row.status === 'degraded') return 'done'\n  if (row.status === 'failed') return 'failed'\n  if (row.status === 'skipped') return 'skipped'\n  return active ? 'active' : 'waiting'\n}\n\n/** \"3 photos added\", \"2 photos added, 1 already in your library\". */\nexport function aiSiteImportPhotosText(photos: { brought: number; reused: number } | null | undefined): string | null {\n  if (!photos || photos.brought + photos.reused === 0) return null\n  const added = photos.brought ? `${photos.brought} ${photos.brought === 1 ? 'photo' : 'photos'} added` : ''\n  const reused = photos.reused ? `${photos.reused} already in your media library` : ''\n  return [added, reused].filter(Boolean).join(', ')\n}\n\n/** One wave's rows, the header and footer first where the wave builds them. */\nexport function aiSiteImportWaveRows(\n  job: Pick<AiJobSummary, 'items' | 'siteImport' | 'status'>,\n  wave: AiSiteImportWave,\n): AiSiteImportRowView[] {\n  const state = job.siteImport as AiSiteImportState\n  const items = new Map((job.items ?? []).map((row) => [row.slot, row]))\n  const running = wave.status === 'running' && (job.status === 'running' || job.status === 'queued')\n  let activeTaken = false\n  const active = (row: AiJobItemLedger | undefined) => {\n    if (!running || activeTaken || !row || (row.status !== 'pending' && row.status !== 'running')) return false\n    activeTaken = true\n    return true\n  }\n  const rows: AiSiteImportRowView[] = []\n  if (wave.frame && state.frame) {\n    const row = items.get(AI_SITE_IMPORT_FRAME_SLOT)\n    rows.push({\n      slot: AI_SITE_IMPORT_FRAME_SLOT,\n      title: 'Header and footer',\n      from: `Your menu on ${state.domain}`,\n      to: 'Every page',\n      state: rowState(row, active(row)),\n      note: row?.failure?.message ?? row?.note ?? null,\n      photos: null,\n      outputId: row?.outputs[0] ?? null,\n    })\n  }\n  for (const slot of wave.slots) {\n    const page = state.pages.find((entry) => entry.slot === slot)\n    if (!page) continue\n    const row = items.get(slot)\n    rows.push({\n      slot,\n      title: page.title,\n      from: page.path,\n      to: page.slug === '/' ? '/' : `/${page.slug}`,\n      state: rowState(row, active(row)),\n      note: row?.failure?.message ?? row?.note ?? (page.refused ? AI_SITE_IMPORT_LEFT_OUT_COPY[page.refused] : null),\n      photos: aiSiteImportPhotosText(page.photos),\n      outputId: row?.outputs[0] ?? null,\n    })\n  }\n  return rows\n}\n\n/** \"About 189 credits (up to 650)\" for the wave, as it stands. */\nexport function aiSiteImportWaveQuote(job: Pick<AiJobSummary, 'items' | 'siteImport'>, wave: AiSiteImportWave): string {\n  return aiCreditRangeText(aiSiteImportWaveCreditRange(job.siteImport as AiSiteImportState, wave, job.items ?? null))\n}\n\n/** What a wave cost, its pages' credits less what was given back. */\nexport function aiSiteImportWaveSpent(job: Pick<AiJobSummary, 'items'>, wave: AiSiteImportWave): number {\n  const slots = new Set([...wave.slots, ...(wave.frame ? [AI_SITE_IMPORT_FRAME_SLOT] : [])])\n  return (job.items ?? [])\n    .filter((row) => slots.has(row.slot))\n    .reduce((total, row) => total + Math.max(0, (row.creditsSpent ?? 0) - (row.creditsRefunded ?? 0)), 0)\n}\n\n/** The read site in one sentence: \"Found 21 pages on harbor-dental.com: Main pages (6) and Blog (14).\" */\nexport function aiSiteImportFoundText(state: AiSiteImportState): string {\n  const groups = state.groups.map((group) => `${group.label} (${group.pages})`)\n  const listed =\n    groups.length <= 1 ? groups.join('') : `${groups.slice(0, -1).join(', ')} and ${groups[groups.length - 1]}`\n  const found = `Found ${aiSiteImportPagesText(state.found)} on ${state.domain}`\n  return listed ? `${found}: ${listed}.` : `${found}.`\n}\n\n/** The plan's page count against the site: \"Your plan includes 25 pages and this site has 0, so 20 are brought in.\" */\nexport function aiSiteImportPlanText(state: AiSiteImportState): string {\n  const kept = state.pages.length\n  const waves = state.waves.length\n  const plan =\n    state.pageLimit === null\n      ? 'Your plan has no page limit'\n      : `Your plan includes ${aiSiteImportPagesText(state.pageLimit)} and this site has ${state.existingPages}`\n  return `${plan}, so ${aiSiteImportPagesText(kept)} ${kept === 1 ? 'is' : 'are'} brought in, in ${waves === 1 ? 'one wave' : `${waves} waves`}.`\n}\n\n/** What was left out, by reason, most first. */\nexport function aiSiteImportLeftOutLines(state: AiSiteImportState): Array<{ reason: AiSiteImportLeftOutReason; count: number; text: string; paths: string[] }> {\n  return AI_SITE_IMPORT_LEFT_OUT_REASONS.map((reason) => ({\n    reason,\n    count: state.leftOutCount[reason] ?? 0,\n    text: AI_SITE_IMPORT_LEFT_OUT_COPY[reason],\n    paths: state.leftOut.filter((entry) => entry.reason === reason).map((entry) => entry.path),\n  }))\n    .filter((line) => line.count > 0)\n    .sort((a, b) => b.count - a.count)\n}\n\n/** The wave a page offers to start next, and its button's words. */\nexport function aiSiteImportStartAction(\n  job: Pick<AiJobSummary, 'siteImport' | 'items'>,\n): { wave: AiSiteImportWave; label: string; quote: string } | null {\n  const state = job.siteImport ?? null\n  const wave = aiSiteImportNextWave(state)\n  if (!state || !wave) return null\n  return { wave, label: `Start ${wave.label}`, quote: aiSiteImportWaveQuote(job, wave) }\n}\n"],"names":["aiCreditRangeText","AI_SITE_IMPORT_FRAME_SLOT","AI_SITE_IMPORT_LEFT_OUT_COPY","AI_SITE_IMPORT_LEFT_OUT_REASONS","aiSiteImportNextWave","aiSiteImportPagesText","aiSiteImportReviewWave","aiSiteImportRunningWave","aiSiteImportWaveCreditRange","AI_SITE_IMPORT_PLAN_COPY","AI_SITE_IMPORT_ROLE_COPY","aiSiteImportOfferOf","offer","state","claims","reason","message","aiSiteImportPhaseOf","job","siteImport","status","review","rowState","row","active","aiSiteImportPhotosText","photos","brought","reused","added","filter","Boolean","join","aiSiteImportWaveRows","wave","items","Map","map","slot","running","activeTaken","rows","frame","get","push","title","from","domain","to","note","failure","outputId","outputs","slots","page","pages","find","entry","path","slug","refused","aiSiteImportWaveQuote","aiSiteImportWaveSpent","Set","has","reduce","total","Math","max","creditsSpent","creditsRefunded","aiSiteImportFoundText","groups","group","label","listed","length","slice","found","aiSiteImportPlanText","kept","waves","plan","pageLimit","existingPages","aiSiteImportLeftOutLines","count","leftOutCount","text","paths","leftOut","line","sort","a","b","aiSiteImportStartAction","quote"],"mappings":"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"}

package/src/lib/model/ai-site-import.d.ts

@@ -0,0 +1,302 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type AiCreditRange } from './ai-credit-estimate';
+import type { AiJobItemLedger } from './ai-jobs.types';
+/** The job kind. */
+export declare const AI_SITE_IMPORT_KIND: "import";
+/** The input naming the proved domain the job brings in. */
+export declare const AI_SITE_IMPORT_DOMAIN_INPUT = "domain";
+/** The most pages one wave brings in. */
+export declare const AI_SITE_IMPORT_WAVE_PAGES = 10;
+/**
+ * The most pages one import reads, whatever the plan allows: an unlimited
+ * plan is still one crawl's worth, and the crawl's own time budget may stop
+ * sooner (the inventory then says so).
+ */
+export declare const AI_SITE_IMPORT_MAX_PAGES = 200;
+/** The fewest pages under one address prefix that make it a collection. */
+export declare const AI_SITE_IMPORT_COLLECTION_MIN = 3;
+/** The most photos brought in from one page. */
+export declare const AI_SITE_IMPORT_IMAGES_PER_PAGE = 8;
+/** The most characters of one page's text a wave keeps for its model answer. */
+export declare const AI_SITE_IMPORT_PAGE_TEXT_MAX_CHARS = 6000;
+/** The most sections one imported page is planned with. */
+export declare const AI_SITE_IMPORT_MAX_SECTIONS = 6;
+/** The most characters a section's name, a page's title or a label keeps. */
+export declare const AI_SITE_IMPORT_LABEL_MAX_CHARS = 60;
+/** A page with fewer words than this and no photo has nothing to bring in. */
+export declare const AI_SITE_IMPORT_MIN_WORDS = 5;
+/** The item ledger slot of the site's header and footer. */
+export declare const AI_SITE_IMPORT_FRAME_SLOT = "frame";
+/** The ceiling one imported page reserves: its answer pass and its listing pass, at 50 each. */
+export declare const AI_SITE_IMPORT_PAGE_CEILING_CREDITS = 100;
+/** The ceiling the header and footer reserve: one answer at 50. */
+export declare const AI_SITE_IMPORT_FRAME_CEILING_CREDITS = 50;
+/** The most left-out pages listed by address; the rest are counted. */
+export declare const AI_SITE_IMPORT_LEFT_OUT_LISTED = 60;
+/** A page the crawl read, as the inventory keeps it: no text, only what plans it. */
+export interface AiSiteImportListedPage {
+    url: string;
+    path: string;
+    title: string;
+    foundBy: 'home' | 'sitemap' | 'link';
+    words: number;
+    images: number;
+}
+export type AiSiteImportGroupKind = 'main' | 'collection';
+export interface AiSiteImportGroup {
+    /** `main`, or `c:<prefix>` for a collection. */
+    id: string;
+    label: string;
+    kind: AiSiteImportGroupKind;
+    /** Pages of the group the crawl read, kept or not. */
+    pages: number;
+}
+/** Why a page the site has is not brought in. */
+export type AiSiteImportLeftOutReason = 
+/** Past the site's room under its plan's page count. */
+'plan-limit'
+/** robots.txt keeps AglynBot off it. */
+ | 'robots'
+/** A sign-in page: refused outright. */
+ | 'login-form'
+/** No text and no photo: nothing to bring in. */
+ | 'empty'
+/** It could not be read: an error, no answer, or not a web page. */
+ | 'unreadable'
+/** Over the size one page may be. */
+ | 'too-large'
+/** It sends visitors to another website. */
+ | 'off-site';
+export declare const AI_SITE_IMPORT_LEFT_OUT_REASONS: readonly AiSiteImportLeftOutReason[];
+export interface AiSiteImportLeftOut {
+    url: string;
+    path: string;
+    title: string;
+    reason: AiSiteImportLeftOutReason;
+}
+/** A photo brought into the site's media library, as a page places it. */
+export interface AiSiteImportPhoto {
+    mediaId: string;
+    src: string;
+    width?: number;
+    height?: number;
+    alt?: string;
+}
+/** What a wave's read found on one page, for its model answer. Never on the wire. */
+export interface AiSiteImportPageRead {
+    at: string;
+    title: string;
+    /** The page's text in order, cut to `AI_SITE_IMPORT_PAGE_TEXT_MAX_CHARS`; fenced only when a prompt reads it. */
+    text: string;
+    /** The page's sections, from its headings. */
+    sections: string[];
+    /** Its photos' addresses, at most `AI_SITE_IMPORT_IMAGES_PER_PAGE`. */
+    images: Array<{
+        url: string;
+        alt: string;
+    }>;
+}
+export interface AiSiteImportPage {
+    /** The item ledger slot: `p0`, `p1`, … */
+    slot: string;
+    url: string;
+    path: string;
+    title: string;
+    group: string;
+    wave: number;
+    /** The id the page's draft is written under, minted with the inventory. */
+    draftId: string;
+    /** The page's address on the new site. */
+    slug: string;
+    words: number;
+    images: number;
+    /** Filled by the wave's read; the text is cleared once the page is in. */
+    read?: AiSiteImportPageRead | null;
+    /** Set when the wave's read found the page cannot be brought in after all. */
+    refused?: AiSiteImportLeftOutReason | null;
+    /** Filled once the page's photos are in the library. */
+    photos?: {
+        brought: number;
+        /** Already in the library from an earlier page or import: the same file, never a second copy. */
+        reused: number;
+        skipped: number;
+        assets: AiSiteImportPhoto[];
+    } | null;
+}
+export type AiSiteImportWaveStatus = 'waiting' | 'running' | 'review' | 'done';
+export interface AiSiteImportWave {
+    index: number;
+    label: string;
+    /** The group the wave brings in; the first wave's is `main`. */
+    group: string;
+    slots: string[];
+    /** Whether the wave builds the site's header and footer first. */
+    frame: boolean;
+    status: AiSiteImportWaveStatus;
+    startedAt: string | null;
+    finishedAt: string | null;
+}
+export interface AiSiteImportState {
+    domain: string;
+    /** The site's name, as Create site was given it: the header's name. */
+    siteName: string;
+    ownership: {
+        method: string | null;
+        provenAt: number | null;
+        detail: string | null;
+    };
+    readAt: string;
+    /** The plan's page count; `null` when it has none. */
+    pageLimit: number | null;
+    /** Pages the site already had when its import read the old site. */
+    existingPages: number;
+    /** Pages the crawl read. */
+    found: number;
+    /** Why the crawl stopped short of the whole site, or `null` when it did not. */
+    stoppedBy: string | null;
+    groups: AiSiteImportGroup[];
+    pages: AiSiteImportPage[];
+    waves: AiSiteImportWave[];
+    /** At most `AI_SITE_IMPORT_LEFT_OUT_LISTED`, by address. */
+    leftOut: AiSiteImportLeftOut[];
+    /** Every page left out, by reason, listed or not. */
+    leftOutCount: Partial<Record<AiSiteImportLeftOutReason, number>>;
+    /** The header and footer's draft id, built in the first wave; `null` when there are no main pages. */
+    frame: {
+        draftId: string;
+    } | null;
+    /** The Trust & Safety row this import is logged under. */
+    reviewId: string | null;
+}
+/** A collection's prefix for a page address: its first segment, a dated archive's `posts`; `null` for a top-level page. */
+export declare function aiSiteImportPrefix(path: string): string | null;
+/** "news-and-events" → "News and events". */
+export declare function aiSiteImportPrefixLabel(prefix: string): string;
+/**
+ * The inventory's groups, in the order they are brought in: the main pages,
+ * then each collection — one the home page's menu links first, in menu order,
+ * then the larger before the smaller.
+ */
+export declare function aiSiteImportGroups(pages: readonly AiSiteImportListedPage[], menu?: readonly string[]): {
+    groups: AiSiteImportGroup[];
+    groupOf: (page: AiSiteImportListedPage) => string;
+};
+/**
+ * The address a page takes on the new site: one segment, as every Aglyn page
+ * has, from the last segment of its old address; home is the root. Two pages
+ * that would take the same address are told apart by their collection, then
+ * by a number. The draft writer still makes it unique on the site itself.
+ */
+export declare function aiSiteImportSlug(path: string, taken: Set<string>): string;
+export interface AiSiteImportInventoryInput {
+    domain: string;
+    siteName: string;
+    ownership: AiSiteImportState['ownership'];
+    readAt: string;
+    pages: readonly AiSiteImportListedPage[];
+    /** Addresses the home page's menu links, in its order. */
+    menu: readonly string[];
+    /** What the crawl could not read, by reason. */
+    skipped: ReadonlyArray<{
+        url: string;
+        reason: AiSiteImportLeftOutReason;
+    }>;
+    /** Skips the crawl only counted. */
+    skippedOverflow?: number;
+    stoppedBy: string | null;
+    /** The plan's page count; `null` for none. */
+    pageLimit: number | null;
+    existingPages: number;
+    /** Mints one draft id; the inventory names every page's draft before any is written. */
+    mintId: () => string;
+    reviewId?: string | null;
+    wavePages?: number;
+}
+/**
+ * The site's inventory cut into waves, every page left out said with its
+ * reason. Pure: the step reads the site, this decides what comes in.
+ */
+export declare function aiSiteImportInventory(input: AiSiteImportInventoryInput): AiSiteImportState;
+/** The item ledger an inventory starts: the header and footer, then every page, all pending. */
+export declare function aiSiteImportLedger(state: AiSiteImportState): AiJobItemLedger[];
+export type AiSiteImportWork = {
+    kind: 'inventory';
+} | {
+    kind: 'start-wave';
+    wave: AiSiteImportWave;
+}
+/** Pages of the running wave its read did not reach before its clock ran out. */
+ | {
+    kind: 'read';
+    wave: AiSiteImportWave;
+    pages: AiSiteImportPage[];
+} | {
+    kind: 'frame';
+    wave: AiSiteImportWave;
+} | {
+    kind: 'images';
+    wave: AiSiteImportWave;
+    page: AiSiteImportPage;
+} | {
+    kind: 'page';
+    wave: AiSiteImportWave;
+    page: AiSiteImportPage;
+} | {
+    kind: 'close-wave';
+    wave: AiSiteImportWave;
+} | {
+    kind: 'done';
+};
+/** Whether an item is still to be built. */
+export declare function aiSiteImportItemOpen(items: readonly AiJobItemLedger[] | null | undefined, slot: string): boolean;
+/** The wave running now, else `null`. */
+export declare function aiSiteImportRunningWave(state: AiSiteImportState | null | undefined): AiSiteImportWave | null;
+/** The next wave a person may start, else `null`. */
+export declare function aiSiteImportNextWave(state: AiSiteImportState | null | undefined): AiSiteImportWave | null;
+/** The wave a person is reviewing, else `null`. */
+export declare function aiSiteImportReviewWave(state: AiSiteImportState | null | undefined): AiSiteImportWave | null;
+/** What the next pass of the step does. */
+export declare function aiSiteImportNextWork(state: AiSiteImportState | null | undefined, items: readonly AiJobItemLedger[] | null | undefined): AiSiteImportWork;
+/** A wave started: running, with what its read found on each page. */
+export declare function aiSiteImportWaveStarted(state: AiSiteImportState, index: number, at: string, reads: ReadonlyMap<string, AiSiteImportPageRead | AiSiteImportLeftOutReason>): AiSiteImportState;
+/** More of a running wave's pages, read now. */
+export declare function aiSiteImportPagesRead(state: AiSiteImportState, reads: ReadonlyMap<string, AiSiteImportPageRead | AiSiteImportLeftOutReason>): AiSiteImportState;
+/** A page's photos are in the library. */
+export declare function aiSiteImportPhotosIn(state: AiSiteImportState, slot: string, photos: NonNullable<AiSiteImportPage['photos']>): AiSiteImportState;
+/** A page is in: its text is no longer kept. */
+export declare function aiSiteImportPageSettled(state: AiSiteImportState, slot: string): AiSiteImportState;
+/** A wave is in: waiting for its review, or done when no wave follows it. */
+export declare function aiSiteImportWaveClosed(state: AiSiteImportState, index: number, at: string): AiSiteImportState;
+/** The state as the console reads it: every page's read text left off. */
+export declare function aiSiteImportWire(state: AiSiteImportState | null | undefined): AiSiteImportState | null;
+/**
+ * What bringing in this many pages costs, quoted before it starts (AGL-3976):
+ * each page an AI page as measured, its ceiling its two passes, and the
+ * site's header and footer once when the wave builds them.
+ */
+export declare function aiSiteImportCreditRange(pages: number, options?: {
+    frame?: boolean;
+}): AiCreditRange;
+/** A wave's quote: the pages it has still to bring in, and its header and footer while they are owed. */
+export declare function aiSiteImportWaveCreditRange(state: AiSiteImportState, wave: AiSiteImportWave, items?: readonly AiJobItemLedger[] | null): AiCreditRange;
+/** Why a page is not brought in, as a person reads it. */
+export declare const AI_SITE_IMPORT_LEFT_OUT_COPY: Readonly<Record<AiSiteImportLeftOutReason, string>>;
+/** "3 pages" / "1 page". */
+export declare function aiSiteImportPagesText(count: number): string;
+/** The review a finished wave parks on, or the first wave's go-ahead once the site is read. */
+export declare function aiSiteImportWaveMessage(state: AiSiteImportState, items: readonly AiJobItemLedger[] | null | undefined): string;