@aglyn/plugins-ai 1.0.0-beta.288 → 1.0.0-beta.290

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

@@ -16,9 +16,12 @@
  */
 import { type PluginMediaIngest } from '@aglyn/aglyn/plugin-manager/plugin-media-ingest';
 import type { AiJob, AiJobItemLedger } from '../model/ai-jobs.types';
-import { type AiSiteImportLeftOutReason, type AiSiteImportPage, type AiSiteImportPageRead, type AiSiteImportState, type AiSiteImportWave } from '../model/ai-site-import';
+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 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';
@@ -91,6 +94,13 @@ export interface AiSiteImportStepDeps {
     pageWritten?: typeof aiSitePageWritten;
     mintId?: () => string;
     clock?: () => number;
+    /** The first wave's look pass (AGL-4084), and what it reads and writes through. */
+    look?: typeof aiRunSiteImportLook;
+    lookDeps?: AiSiteImportLookDeps;
+    /** A closed wave's pages into the site's preview (AGL-4084). */
+    publishWave?: typeof aiPublishImportedWave;
+    /** The words a page that came in shows, read off its draft (AGL-4084). */
+    draftWords?: (firestore: FirebaseFirestore.Firestore, hostId: string, draftId: string) => Promise<number | null>;
 }
 /** The proved domain an import job is for, or `null`. */
 export declare function aiSiteImportDomainOf(job: Pick<AiJob, 'inputs'>): string | null;
@@ -100,12 +110,41 @@ export declare function aiSiteImportDomainOf(job: Pick<AiJob, 'inputs'>): string
  * seven. A page of a later wave is not linked: it may never be brought in.
  */
 export declare function aiSiteImportLinkedPages(state: AiSiteImportState, items: readonly AiJobItemLedger[], wave: number): AiLayoutSitePage[];
-/** The header and footer's job: a layout of the site's name, linking the wave's pages, in the layout language. */
+/**
+ * How a page is built (AGL-4084): a collection's page, or a long page, is
+ * copied as it is; a main page is arranged. The home page is always
+ * arranged, however long: it is the site's front door, never a document.
+ */
+export declare function aiSiteImportBuildOf(page: Pick<AiSiteImportPage, 'group' | 'words' | 'slug'>): AiSiteImportBuild;
+/**
+ * The name the header and footer carry (AGL-4084): the site's own name where
+ * it is the name the person gave Create site but for its case or its
+ * punctuation, else the person's.
+ */
+export declare function aiSiteImportBrandName(given: string, own: string): string;
+/** 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;
-/** One page's job: a page job's plan of one screen, its sections from the old page's headings, its text fenced. */
+/** 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 declare function aiSiteImportDocumentFor(state: AiSiteImportState, page: AiSiteImportPage): AiSiteImportDocument | null;
+/** 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 declare function aiSiteImportPageJob(job: AiJob, state: AiSiteImportState, page: AiSiteImportPage, items: readonly AiJobItemLedger[]): AiJob;
+/** What the home page says of the site as a whole (AGL-4084), kept for the look, the header and footer and the listing. */
+export declare function aiSiteImportHomeOf(crawled: Pick<SiteImportInventory, 'pages'>): AiSiteImportHome | null;
 /** 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 declare function aiSiteImportRunMinimumMs(job: AiJob, runnerFor?: typeof aiJobStepRunnerFor): number;
+/**
+ * The state with how each page is built (AGL-4084): from its main region's
+ * words as the inventory listed them, and again from a wave's fresh read,
+ * which is what the page is built from.
+ */
+export declare function aiSiteImportWithBuilds(state: AiSiteImportState, mainWords?: ReadonlyMap<string, number>): AiSiteImportState;
+/** The words a stored page shows (AGL-4084): its text, its list lines and its buttons. */
+export declare function aiSiteImportShownWords(nodes: Readonly<Record<string, unknown>>): number;
+/**
+ * The review a wave that went live in the site's preview parks on (AGL-4084):
+ * where its pages are now, who sees them, and the next wave's start.
+ */
+export declare function aiSiteImportPreviewMessage(state: AiSiteImportState, wave: Pick<AiSiteImportWave, 'label'>, published: number): string;
 export declare function createAiJobImportStep(deps?: AiSiteImportStepDeps): AiJobStepRunner;
 /** The home page's menu, as same-site paths in its order. */
 export declare function siteImportMenu(crawled: Pick<SiteImportInventory, 'pages' | 'origins'>): string[];
@@ -118,6 +157,17 @@ export declare function siteImportWaveReads(asked: readonly AiSiteImportPage[],
     /** The read's clock ran out: a page it did not reach is left for the next pass, not left out. */
     cutShort?: boolean;
 }): Map<string, AiSiteImportPageRead | AiSiteImportLeftOutReason>;
+/**
+ * "Start every remaining wave" (AGL-4083, wired by AGL-4084), as the resume
+ * door writes it onto an import waiting to start its next wave: every
+ * remaining wave starts after the one before it closes, with no review
+ * between them, and the person's one start is the one the day's limit
+ * counts. `null` when the job is not an import waiting for a wave.
+ */
+export declare function aiSiteImportStartAllUpdate(job: Pick<AiJob, 'kind' | 'status' | 'review' | 'siteImport'>): {
+    'siteImport.autoContinue': true;
+    'siteImport.autoContinueFrom': number;
+} | null;
 export interface AiSiteImportAdmissionDeps {
     releaseFlagOn?: (orgId: string) => Promise<boolean>;
     ownership?: (orgId: string, domain: string) => Promise<AiSiteImportOwnership | null>;