@aglyn/plugins-ai 1.0.0-beta.270 → 1.0.0-beta.272

package/src/lib/model/ai-jobs.types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-jobs.types.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { ITimestamp } from '@aglyn/shared-util-timestamp'\nimport type { AiEffort } from '../providers/contract'\nimport type { AiLoadEstimate } from '../runtime/ai-palette'\nimport type { AiBuildPlan } from './ai-build-plan'\nimport type { AiFreeCreditsLeft } from './ai-site-job'\nimport type { AiJobCreditsConfirmation } from './ai-credit-estimate'\n\n/**\n * AI generation jobs (AGL-2904).\n *\n * A job is one customer brief carried through one or more model steps by a\n * Firestore state machine, so that work longer than a request can survive\n * the request: the console route runs what it can inline, and the platform\n * job beat resumes whatever is left. The document is the whole state — no\n * process holds anything the next beat cannot read back.\n *\n * ── Outputs are drafts, never a publish ──────────────────────────────────\n *\n * Every output a job produces is a NEW draft or a new unpublished version of\n * an existing resource. A job never flips a version pointer, never registers\n * a route and never sends anything; a person opens the draft the job names\n * and publishes it through the door that already exists for that resource.\n * That is what lets a job run with no visitor, no session and no confirm\n * gate — the thing it writes cannot be seen by anyone but the workspace\n * until a member chooses otherwise.\n *\n * ── The lease ────────────────────────────────────────────────────────────\n *\n * A step runs under a lease: an owner id and an `until` instant. Two beats\n * fire a minute apart against a 120 s function timeout, and a console route\n * may still be running the first step when the first beat looks, so the\n * lease is what stops the same step being run — and metered — twice. A\n * claim is a transaction that refuses while another owner's lease is live;\n * an expired lease is simply claimable, which is also how a step abandoned\n * by a frozen process is recovered.\n */\n\n/**\n * What a job produces. `text` and `theme` have runners; every other kind is\n * registered and refuses with \"not available yet\" until its own issue lands,\n * so a kind's presence in the union says the job model accepts it, not that\n * a runner exists.\n */\nexport type AiJobKind =\n  | 'page'\n  | 'component'\n  | 'layout'\n  | 'template'\n  | 'edit'\n  | 'seo'\n  | 'site'\n  | 'email'\n  | 'campaign'\n  | 'form'\n  | 'experiment'\n  | 'insight'\n  | 'products'\n  | 'crm'\n  | 'onboarding'\n  | 'workflow'\n  | 'logic'\n  | 'text'\n  | 'theme'\n  | 'build'\n  /** A change to a site's header or footer menu, made by code (AGL-3728). */\n  | 'navigation'\n  /** A copy of something a site already has, made by core's duplicate (AGL-3740). */\n  | 'duplicate'\n  /** A change to a site's settings, made by code and saved live (AGL-3748). */\n  | 'settings'\n  /** Folders, tags, alt text and names in a site's media library, made by code and saved live (AGL-3752). */\n  | 'media'\n  /** A change to a site's analytics and advertising tags, made by code and saved live (AGL-3751). */\n  | 'tracking'\n\n/** The union as a value, so a route can validate a body against it. */\nexport const AI_JOB_KINDS: readonly AiJobKind[] = [\n  'page',\n  'component',\n  'layout',\n  'template',\n  'edit',\n  'seo',\n  'site',\n  'email',\n  'campaign',\n  'form',\n  'experiment',\n  'insight',\n  'products',\n  'crm',\n  'onboarding',\n  'workflow',\n  'logic',\n  'text',\n  'theme',\n  'build',\n  'navigation',\n  'duplicate',\n  'settings',\n  'media',\n  'tracking',\n]\n\n/**\n * `queued` — waiting for a runner; `running` — a step holds the lease;\n * `needs_input` — the job stopped for something only the workspace can\n * change (credits, a cap, a switch), and the beat tries it again once that\n * may have changed; `needs_review` — the job stopped for a person's decision\n * (AGL-2935): its plan is ready to confirm, or an answer broke a building\n * rule on its re-ask. No timer can make that decision, so neither the beat\n * nor anything but that person resumes it. The last three are terminal.\n */\nexport type AiJobStatus =\n  | 'queued'\n  | 'running'\n  | 'needs_input'\n  | 'needs_review'\n  | 'done'\n  | 'failed'\n  | 'canceled'\n\nexport const AI_JOB_TERMINAL_STATUSES: readonly AiJobStatus[] = [\n  'done',\n  'failed',\n  'canceled',\n]\n\nexport type AiJobStepStatus = 'pending' | 'running' | 'done' | 'failed'\n\n/** The step a planned kind runs first (AGL-2935): its plan, before anything is built. */\nexport const AI_JOB_PLAN_STEP = 'plan'\n\nexport interface AiJobStep {\n  /** Stable within the job (`plan`, `draft`, `generate`), unique per job. */\n  name: string\n  status: AiJobStepStatus\n  startedAt?: ITimestamp | null\n  endedAt?: ITimestamp | null\n  /** Credits this step has actually cost, at the plan's credit rate. */\n  creditsSpent: number\n  /** Customer-safe only; provider detail goes to the server log. */\n  error?: string | null\n  /**\n   * How many times a runner has been handed this step. A retryable provider\n   * failure hands the step back as `pending`; the count is what stops a\n   * provider outage re-running a step forever.\n   */\n  attempts?: number\n  /**\n   * Passes of a step that works through a list (AGL-2910): each one a\n   * recorded, metered exchange that asked to continue. Attempts count again\n   * from zero after a pass; this count is what bounds the step.\n   */\n  passes?: number\n  /**\n   * What the step's model calls cost in tokens and time (AGL-2937), summed\n   * over every run that reached the provider. Absent on a step none has.\n   */\n  tokens?: AiJobStepTokens\n  /**\n   * The ids the step writes its drafts under, by draft (AGL-3079): minted\n   * when the job is created, so every run of the step names the same drafts.\n   * Absent on a step that writes none; a step that records none names its\n   * drafts by the job's own id.\n   */\n  draftIds?: Partial<Record<AiJobDraftSlot, string>>\n}\n\n/**\n * A draft a job's kind always writes (AGL-3079): a screen, layout, template,\n * form or component; an email design; a campaign; an automation.\n */\nexport type AiJobDraftSlot =\n  | 'screen'\n  | 'layout'\n  | 'template'\n  | 'form'\n  | 'component'\n  | 'email'\n  | 'campaign'\n  | 'workflow'\n\n/**\n * A step's measure (AGL-2937): the four token counts the meter prices, the\n * time spent in the runner, and the model and thinking effort of the last\n * run. The machine writes it beside `creditsSpent`, so what a kind of step\n * costs in tokens is read off the job rather than inferred from the month.\n */\nexport interface AiJobStepTokens {\n  /** Prompt tokens sent uncached. */\n  input: number\n  /** Prompt tokens read from the prompt cache. */\n  cachedRead: number\n  /** Prompt tokens written to the prompt cache. */\n  cacheWrite: number\n  /** Tokens generated, thinking included. */\n  output: number\n  /** The model the last run was served by. */\n  model: string | null\n  /** The thinking effort the last run asked for; `null` when it named none. */\n  effort: AiEffort | null\n  /** Milliseconds spent in the runner, summed over runs. */\n  latencyMs: number\n  /** Runs that reached the provider. */\n  runs: number\n  /**\n   * Why the step's latest runs stopped (AGL-3042), oldest first and the last\n   * run last: each run's stop reason and the tokens it generated, so a pass\n   * cut off at its ceiling reads off the job rather than out of the sums. At\n   * most `AI_JOB_STEP_LAST_RUNS` are kept; absent on a step measured before.\n   */\n  lastRuns?: AiJobStepRunStop[]\n}\n\n/** One run of a step, by why it stopped (AGL-3042). */\nexport interface AiJobStepRunStop {\n  /**\n   * The stop reason of the run's last model call — `tool_use` or `end_turn`\n   * for an answer, `max_tokens` for one cut off at its ceiling, `refusal` —\n   * and `null` when the provider named none.\n   */\n  stopReason: string | null\n  /** Tokens the run generated, over every model call it made. */\n  output: number\n}\n\nexport type AiJobOutputResource =\n  | 'screen'\n  | 'reusableComponent'\n  | 'layout'\n  | 'template'\n  | 'form'\n  | 'emailScreen'\n  | 'campaign'\n  | 'product'\n  | 'experiment'\n  | 'workflow'\n  | 'text'\n  | 'theme'\n  | 'seo'\n  | 'insight'\n  | 'crm'\n  /** A draft another plugin wrote for a build (AGL-3616), named by `draftResource`. */\n  | 'draft'\n  | 'logic'\n  | 'orgAutomation'\n  /** A post a guided start wrote into the site's blog (AGL-3676): a content collection entry. */\n  | 'entry'\n  /** A site's settings a build changed (AGL-3748): saved live, on the host document. */\n  | 'settings'\n  /** Files in a site's media library a build organized (AGL-3752): saved live, on their documents. */\n  | 'media'\n  /** A site's tracking tags a build changed (AGL-3751): saved live, on the host document. */\n  | 'tracking'\n\n/**\n * One thing a job wrote. Addressed by resource and id so the console can\n * build the \"open draft\" link without knowing what the runner did; `text`\n * has no document of its own, so its body rides on the output itself.\n *\n * A `theme` output is a proposal rather than a document (AGL-2938). A site's\n * theme is fields on its host document, and writing those fields is the save\n * the Theme section's editor performs, which a job never does. So the change\n * set rides on the output as `proposal`, and a person puts it in the editor\n * and saves it there, or does not.\n *\n * An `seo` output is a proposal rather than a document (AGL-2910): search\n * listing values for a page or a product, or a site audit's findings and\n * fixes. A screen's listing is served from the screen document itself, so a\n * job never writes it; the values ride on the output as `proposal`, a person\n * puts them in the editor and saves them there, and an audit's content fixes\n * become new versions only when a person applies them.\n *\n * A `crm` output is a proposal too (AGL-2917): a record's summary and next\n * step, an email draft, or an import's column matches. The CRM's own task\n * form, stage route, composer and import drawer are the writes, and a person\n * makes each of them, or does not.\n *\n * A `logic` output is a proposal too (AGL-3603): a site function or variable\n * the Functions & Variables editor opens unsaved. Saving it is the editor's\n * write, which a person makes, or does not.\n *\n * An `orgAutomation` output is a proposal too (AGL-3603): one of the\n * workspace's automations, which the Org automations editor opens unsaved and\n * switched off. `hostId` is `null`: it belongs to no one site.\n */\nexport interface AiJobOutput {\n  resource: AiJobOutputResource\n  id: string\n  /** The unpublished version the job created, where the resource has versions. */\n  versionId?: string | null\n  /** `null` for an output that belongs to the org rather than one site. */\n  hostId: string | null\n  /**\n   * The site's subdomain, which is what a console URL names a site by: the\n   * `[host]` segment resolves by subdomain, so a link built from `hostId`\n   * names no site the console can open.\n   */\n  hostSubdomain?: string | null\n  label: string\n  /** The body of a `text` output. Absent on every other resource. */\n  text?: string\n  /**\n   * The change set of an output a person applies rather than opens — a\n   * `theme` or `seo` proposal — in the shape its job kind's runner defines.\n   */\n  proposal?: Record<string, unknown>\n  /**\n   * What the person decides next about this output, in customer-safe words:\n   * a routing the draft could not store, or part of the brief it could not\n   * build. Absent when there is nothing to decide.\n   */\n  note?: string | null\n  /**\n   * What a first visit is estimated to transfer, as the doctrine measured\n   * the generated document (AGL-2935) — the weight the proposal shows before\n   * anything is applied. Absent where the output is not a page's document.\n   */\n  load?: AiLoadEstimate | null\n  /**\n   * For a `draft` output (AGL-3616): the resource whose owner wrote it, as\n   * its writer is registered on the resource-draft seam.\n   */\n  draftResource?: string\n}\n\nexport interface AiJobLease {\n  /** The process that holds the step: a route request id or a beat id. */\n  owner: string\n  until: ITimestamp\n}\n\n/** Why a job stopped for a person (AGL-2935). */\nexport type AiJobReviewReason =\n  /** The plan step proposed a plan; generation waits for it to be confirmed. */\n  | 'plan'\n  /** An answer broke a building rule, and so did the answer to the re-ask. */\n  | 'doctrine'\n  /**\n   * The site is at an allowance its plan sets for what the step writes, such\n   * as its shared layouts or its templates (AGL-2909). Freeing one, or a plan\n   * that holds more, is the member's decision; trying again runs the step\n   * again.\n   */\n  | 'limit'\n\n/**\n * A building rule an answer broke, as the job keeps it: the number, the code,\n * the sentence, and where in the answer it was broken (AGL-3078).\n */\nexport interface AiJobRuleFinding {\n  rule: number | null\n  code: string\n  /** Customer-safe. */\n  message: string\n  /** The nodes the finding names, by the ids the refused answer gave them. Absent when it names none. */\n  nodeIds?: string[]\n  /** The plan entries or answer fields it names, as `screens[0].sections[2]`. Absent when it names none. */\n  paths?: string[]\n}\n\n/**\n * One node of the parts of a refused answer its findings name (AGL-3078), as\n * the review keeps it: the node's place, its element and the names of what it\n * sets, and never its copy. A Grid keeps the values of its layout props as\n * they were written, so a review can tell a shape the rules refuse from one\n * the model was asked to mend and did not.\n */\nexport interface AiJobReviewOutlineNode {\n  /** The node's id, as the refused answer wrote it. */\n  id: string\n  /** How far below a node a finding names it sits: 0 for that node. */\n  depth: number\n  componentId: string\n  /** The props it sets, by name only. */\n  props: string[]\n  /** The `sx` keys it sets, by name only; absent when it sets none. */\n  sx?: string[]\n  /** A Grid's layout props, `container`, `size`, `direction`, `spacing` and the rest, as written. */\n  grid?: Record<string, string | number | boolean | null>\n  /** Its children's element ids, in order. */\n  children: string[]\n}\n\nexport interface AiJobReview {\n  reason: AiJobReviewReason\n  /** Customer-safe: what the person is asked to decide. */\n  message: string\n  /** The rules the last answer broke; empty for a plan. */\n  findings: AiJobRuleFinding[]\n  /**\n   * The parts of the refused answer its findings name, each node with the\n   * nodes below it (AGL-3078); absent when they name none. Kept with the job\n   * for diagnosis, and shown to staff.\n   */\n  outline?: AiJobReviewOutlineNode[]\n  /**\n   * The checks' own sentence, where `message` was written for the member\n   * instead (AGL-3594): rule numbers and all, for staff. Its presence is what\n   * tells the drawer the findings are staff reading too.\n   */\n  detail?: string\n  /**\n   * Why trying again cannot work yet (AGL-3594) — the Free allowance left is\n   * less than the step can cost — or absent when it can. The button is drawn\n   * disabled with this beside it.\n   */\n  retryRefusal?: string\n  /**\n   * What a Free workspace had left when a build's plan was kept (AGL-3722),\n   * so its plan card says, before Confirm, whether the build fits and offers\n   * the go-ahead or a smaller first build when it does not. The confirm door\n   * reads what is left again; this is what the card shows.\n   */\n  freeCredits?: AiFreeCreditsLeft\n}\n\nexport type AiJobPlanStatus = 'proposed' | 'confirmed'\n\n/** The plan a job builds from, as the job keeps it once its plan step proposed it. */\nexport interface AiJobPlan extends AiBuildPlan {\n  status: AiJobPlanStatus\n  /** Names for the inventory ids the plan references, read when it was made. */\n  labels: Record<string, string>\n  proposedAt: ITimestamp\n  confirmedAt: ITimestamp | null\n  /** The member who confirmed it. */\n  confirmedBy: string | null\n  /**\n   * A digest of the whole request that produced this plan (AGL-2937): the\n   * job's kind, site, brief and scalar inputs, the model that answered, and\n   * the prompt as it was rendered — the site inventory included. A later job\n   * whose request hashes the same reuses this plan rather than paying for the\n   * same answer again. A hash of the request, never of the answer, and no\n   * part of the brief is recoverable from it.\n   */\n  key?: string\n  /** The job this plan was reused from, when it was not asked for again. */\n  reusedFrom?: string\n}\n\n/**\n * Where one item of a `build` job stands (AGL-3616). A build settles item by\n * item: a failed item gives back its own spend and the rest of the plan still\n * runs, so the job keeps one row per item, written only by the machine's\n * `recordStep` — in the same transaction as the spend it accounts for — and\n * by the resume door's retry.\n */\nexport type AiJobItemStatus = 'pending' | 'running' | 'succeeded' | 'degraded' | 'failed' | 'skipped'\n\n/** Why an item failed: a give-back reason when it was ours, else the model's refusal or a review. */\nexport type AiJobItemFailureReason =\n  | 'plan-refused'\n  | 'doctrine-refused'\n  | 'provider'\n  | 'timeout'\n  | 'step-failure'\n  | 'unavailable'\n  | 'refused'\n  | 'review'\n\nexport interface AiJobItemFailure {\n  /** Whether the failure was on our side: only then is the item's spend given back. */\n  ours: boolean\n  reason: AiJobItemFailureReason\n  /** Customer-safe. */\n  message: string\n  /**\n   * The checks' own sentence behind a `doctrine-refused` failure (AGL-3596),\n   * rule numbers and all: kept on the job for staff and debugging, never on\n   * the wire a customer reads.\n   */\n  detail?: string\n}\n\nexport interface AiJobItemLedger {\n  /** The unit's slot within the plan: `c0` a creation, `p0` a page, `i0` an item. */\n  slot: string\n  /** The capability operation that builds it: `page`, `form`, or an owner's op. */\n  op: string\n  /** What a person reads: the page's title, the creation's or item's name. */\n  label: string\n  status: AiJobItemStatus\n  /** Bumped by Try again; the refund key names it, so each attempt gives back once. */\n  attempt: number\n  /** What this item's passes cost, every attempt. */\n  creditsSpent: number\n  /** What this attempt's passes cost so far: what a failure of this attempt gives back. */\n  attemptCredits?: number\n  /** What was given back for this item's failures. */\n  creditsRefunded: number\n  /** The key the latest give-back for this item was made under. */\n  refundKey?: string\n  failure?: AiJobItemFailure | null\n  /** The ids of the outputs this item produced. */\n  outputs: string[]\n  /** The slots whose failure changed how this item was built. */\n  degradedBy?: string[]\n  /** Customer-safe: what the person should know about this item. */\n  note?: string | null\n  /**\n   * When this attempt settled, as an ISO string (AGL-3596): the moment the\n   * next item started, which is what its progress row counts from. Absent\n   * while the item is open, and on a ledger written before it was kept.\n   */\n  settledAt?: string | null\n}\n\n/** Whether a build's own planning was charged or given back (AGL-3616). */\nexport interface AiJobOrchestration {\n  /** What the plan step spent. */\n  creditsSpent: number\n  /** `charged` once anything was delivered; `refunded` when nothing was. */\n  settled: 'pending' | 'charged' | 'refunded'\n}\n\nexport interface AiJob {\n  $id: string\n  orgId: string\n  hostId?: string | null\n  kind: AiJobKind\n  status: AiJobStatus\n  /** The customer's brief, verbatim. Expires with the document. */\n  brief: string\n  /** Kind-specific inputs the runner reads (a screen id to edit, a tone). */\n  inputs: Record<string, unknown>\n  /**\n   * The model the creator picked for the job's steps (AGL-2942), or `null`\n   * for Auto. Each step honors it only where the plan and the allotment\n   * allowlists allow it, and runs on the routing table otherwise.\n   */\n  model?: string | null\n  steps: AiJobStep[]\n  outputs: AiJobOutput[]\n  /**\n   * The nominal credit figure held against the job while steps are\n   * outstanding. The meter's real bound is the per-step message reservation\n   * and the org's monthly ceiling; this is the number the console shows so\n   * a running job is not read as free.\n   */\n  creditsReserved: number\n  creditsSpent: number\n  /**\n   * Credits the job gave back because it failed on our side (AGL-3594),\n   * summed over its give-backs; absent when it gave none. `creditsSpent`\n   * stays what ran, so what the job cost is the one less the other.\n   */\n  refundedCredits?: number\n  /** Why the latest give-back was made (`AiJobRefundReason`). */\n  refundReason?: string\n  /** How many give-backs the job has had: the next one's key. */\n  refunds?: number\n  createdBy: string\n  createdAt: ITimestamp\n  updatedAt: ITimestamp\n  /** TTL — the brief is verbatim customer text and expires like an exchange. */\n  expiresAt: ITimestamp\n  /** Customer-safe only. */\n  error?: string | null\n  lease?: AiJobLease | null\n  /** The plan the job builds from, once its plan step proposed one. */\n  plan?: AiJobPlan | null\n  /** What the person is asked to decide while the job is `needs_review`. */\n  review?: AiJobReview | null\n  /**\n   * What a person applied from the job's outputs (AGL-2910). Written by the\n   * door that applied them, never by a step runner, and absent until then.\n   */\n  applied?: AiJobApplied | null\n  /**\n   * What a guided site start put live when it finished (AGL-3596): written\n   * once by the site step's last pass, never by a person. Absent on every\n   * other job, which leaves its pages as drafts.\n   */\n  sitePublish?: AiJobSitePublish | null\n  /** A `build` job's items, one row each (AGL-3616); absent on every other kind. */\n  items?: AiJobItemLedger[] | null\n  /** A `build` job's planning spend and how it settled (AGL-3616). */\n  orchestration?: AiJobOrchestration | null\n  /**\n   * A Free job started past what was left (AGL-3722): the person chose to\n   * build what fits, knowing it pauses where the credits run out. Who, when,\n   * what was left and the range they were shown; absent on every job that fit.\n   */\n  creditsConfirmed?: AiJobCreditsConfirmation | null\n  /**\n   * A person asked to stop the job (AGL-3616): written only by the cancel\n   * door, in the transaction that decides it. A job no step holds ends\n   * `canceled` in that same write; a job whose step holds a live lease keeps\n   * running until the step finishes or aborts, and the machine ends it\n   * `canceled` at its next write. Absent on a job nobody canceled.\n   */\n  cancelRequested?: AiJobCancelRequest | null\n  /**\n   * The empty site this guided start was for was removed (AGL-3936): the\n   * job was cancelled or failed before it built anything, nobody chose what\n   * to do next within the grace period, and the AI jobs beat deleted the\n   * site. Written once, by the beat, after the site is gone. Absent on every\n   * other job.\n   */\n  siteRemoved?: AiJobSiteRemoved | null\n}\n\n/** When the AI jobs beat removed a guided start's empty site, and which (AGL-3936). */\nexport interface AiJobSiteRemoved {\n  at: ITimestamp\n  /** The site's name as it was, for a sentence that names it. */\n  name: string | null\n}\n\n/** Who asked to cancel a job, and when (AGL-3616). */\nexport interface AiJobCancelRequest {\n  at: ITimestamp\n  /** The member or staff account that asked; `null` when nobody was named. */\n  by: string | null\n}\n\n/**\n * A guided site start's publish (AGL-3596): the pages that went live, with\n * the address each answers, and the pages that stayed drafts, each with the\n * plain sentence for why. A page that stayed a draft never fails the job.\n */\nexport interface AiJobSitePublish {\n  /** The site's live address, `https://<subdomain>.aglyn.app/`; `null` when the site has no subdomain. */\n  liveUrl: string | null\n  published: Array<{ id: string; label: string; path: string }>\n  drafts: Array<{ id: string; label: string; reason: string }>\n}\n\n/**\n * The record of an apply (AGL-2910): what became a new unpublished version,\n * and what waits in its editor for a person to save.\n */\nexport interface AiJobApplied {\n  at: ITimestamp\n  /** The member who applied. */\n  by: string\n  /** The new version opened for each resource, by resource id. */\n  versions: Record<string, string>\n  /** Resource ids whose proposed values wait in their editor, unsaved. */\n  staged: string[]\n}\n\n/** The plan on the wire: every instant an ISO string. */\nexport interface AiJobPlanSummary extends AiBuildPlan {\n  status: AiJobPlanStatus\n  labels: Record<string, string>\n  proposedAt: string | null\n  confirmedAt: string | null\n  confirmedBy: string | null\n  key?: string\n  reusedFrom?: string\n}\n\n/**\n * The wire form the console reads: every instant an ISO string, the lease\n * reduced to whether a runner holds the job. The brief and the outputs\n * travel as they are — the reader is a member of the org that wrote them.\n */\nexport interface AiJobSummary {\n  id: string\n  orgId: string\n  hostId: string | null\n  kind: AiJobKind\n  status: AiJobStatus\n  brief: string\n  /**\n   * The batch a door created this job as one of (AGL-2911), read off the\n   * job's inputs; `null` for a job created on its own. The console groups a\n   * run of jobs by it, which is the one thing it cannot do from a list whose\n   * rows carry no inputs — and the only input the wire form carries, because\n   * a batch id names nothing the member wrote.\n   */\n  batch: string | null\n  steps: Array<{\n    name: string\n    status: AiJobStepStatus\n    startedAt: string | null\n    endedAt: string | null\n    creditsSpent: number\n    error: string | null\n  }>\n  outputs: AiJobOutput[]\n  creditsReserved: number\n  creditsSpent: number\n  /** Credits given back for a failure on our side (AGL-3594); 0 when none. */\n  refundedCredits?: number\n  createdBy: string\n  createdAt: string\n  updatedAt: string\n  error: string | null\n  running: boolean\n  plan: AiJobPlanSummary | null\n  review: AiJobReview | null\n  /** What a person applied from the outputs (AGL-2910); instants as ISO strings. */\n  applied?: {\n    at: string | null\n    by: string\n    versions: Record<string, string>\n    staged: string[]\n  } | null\n  /** What a guided site start put live (AGL-3596); absent on every other job. */\n  sitePublish?: AiJobSitePublish | null\n  /**\n   * A site job's answers (AGL-3596): the guided start's questions as the person\n   * answered them, so a failed start's Try again reopens them filled in. The\n   * scalar site inputs only, never anything else a job's inputs carry; absent\n   * on every other kind.\n   */\n  siteInputs?: Record<string, unknown> | null\n  /**\n   * Whether the machine confirms this job's plan itself (AGL-3594): a guided\n   * site start. Its plan parks for the instant the confirmation takes, and a\n   * surface reads that park as the build going on (AGL-3596). Absent on every\n   * other job.\n   */\n  autoConfirm?: boolean\n  /** A `build` job's items (AGL-3616); absent on every other job. */\n  items?: AiJobItemLedger[]\n  /**\n   * Whether a build's request asked to publish (AGL-3616), so its plan card\n   * offers the box that confirms it. Absent on every other job.\n   */\n  publishAsked?: boolean\n  /** A `build` job's planning spend and how it settled (AGL-3616). */\n  orchestration?: AiJobOrchestration\n  /**\n   * A cancel was asked and the job has not ended yet (AGL-3616): the step in\n   * flight is finishing or aborting, and nothing after it runs. Absent once\n   * the job is terminal, and on every job nobody canceled.\n   */\n  cancelRequested?: boolean\n  /**\n   * The empty site this guided start was for was removed (AGL-3936): its\n   * page is gone, and Start again opens Create site with the same answers.\n   * Absent on every other job.\n   */\n  siteRemoved?: boolean\n}\n"],"names":["AI_JOB_KINDS","AI_JOB_TERMINAL_STATUSES","AI_JOB_PLAN_STEP"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GA6ED,qEAAqE,GACrE,OAAO,MAAMA,eAAqC;IAChD;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAA;AAoBD,OAAO,MAAMC,2BAAmD;IAC9D;IACA;IACA;CACD,CAAA;AAID,uFAAuF,GACvF,OAAO,MAAMC,mBAAmB,OAAM"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-jobs.types.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { ITimestamp } from '@aglyn/shared-util-timestamp'\nimport type { AiEffort } from '../providers/contract'\nimport type { AiLoadEstimate } from '../runtime/ai-palette'\nimport type { AiBuildPlan } from './ai-build-plan'\nimport type { AiFreeCreditsLeft } from './ai-site-job'\nimport type { AiJobCreditsConfirmation } from './ai-credit-estimate'\nimport type { AiSiteImportState } from './ai-site-import'\nimport type { AiSiteInspiration } from '../jobs/ai-site-inspiration-signals'\n\n/**\n * AI generation jobs (AGL-2904).\n *\n * A job is one customer brief carried through one or more model steps by a\n * Firestore state machine, so that work longer than a request can survive\n * the request: the console route runs what it can inline, and the platform\n * job beat resumes whatever is left. The document is the whole state — no\n * process holds anything the next beat cannot read back.\n *\n * ── Outputs are drafts, never a publish ──────────────────────────────────\n *\n * Every output a job produces is a NEW draft or a new unpublished version of\n * an existing resource. A job never flips a version pointer, never registers\n * a route and never sends anything; a person opens the draft the job names\n * and publishes it through the door that already exists for that resource.\n * That is what lets a job run with no visitor, no session and no confirm\n * gate — the thing it writes cannot be seen by anyone but the workspace\n * until a member chooses otherwise.\n *\n * ── The lease ────────────────────────────────────────────────────────────\n *\n * A step runs under a lease: an owner id and an `until` instant. Two beats\n * fire a minute apart against a 120 s function timeout, and a console route\n * may still be running the first step when the first beat looks, so the\n * lease is what stops the same step being run — and metered — twice. A\n * claim is a transaction that refuses while another owner's lease is live;\n * an expired lease is simply claimable, which is also how a step abandoned\n * by a frozen process is recovered.\n */\n\n/**\n * What a job produces. `text` and `theme` have runners; every other kind is\n * registered and refuses with \"not available yet\" until its own issue lands,\n * so a kind's presence in the union says the job model accepts it, not that\n * a runner exists.\n */\nexport type AiJobKind =\n  | 'page'\n  | 'component'\n  | 'layout'\n  | 'template'\n  | 'edit'\n  | 'seo'\n  | 'site'\n  | 'email'\n  | 'campaign'\n  | 'form'\n  | 'experiment'\n  | 'insight'\n  | 'products'\n  | 'crm'\n  | 'onboarding'\n  | 'workflow'\n  | 'logic'\n  | 'text'\n  | 'theme'\n  | 'build'\n  /** A change to a site's header or footer menu, made by code (AGL-3728). */\n  | 'navigation'\n  /** A copy of something a site already has, made by core's duplicate (AGL-3740). */\n  | 'duplicate'\n  /** A change to a site's settings, made by code and saved live (AGL-3748). */\n  | 'settings'\n  /** Folders, tags, alt text and names in a site's media library, made by code and saved live (AGL-3752). */\n  | 'media'\n  /** A change to a site's analytics and advertising tags, made by code and saved live (AGL-3751). */\n  | 'tracking'\n  /** A person's own website brought in, page by page, in reviewed waves (AGL-3976). */\n  | 'import'\n\n/** The union as a value, so a route can validate a body against it. */\nexport const AI_JOB_KINDS: readonly AiJobKind[] = [\n  'page',\n  'component',\n  'layout',\n  'template',\n  'edit',\n  'seo',\n  'site',\n  'email',\n  'campaign',\n  'form',\n  'experiment',\n  'insight',\n  'products',\n  'crm',\n  'onboarding',\n  'workflow',\n  'logic',\n  'text',\n  'theme',\n  'build',\n  'navigation',\n  'duplicate',\n  'settings',\n  'media',\n  'tracking',\n  'import',\n]\n\n/**\n * `queued` — waiting for a runner; `running` — a step holds the lease;\n * `needs_input` — the job stopped for something only the workspace can\n * change (credits, a cap, a switch), and the beat tries it again once that\n * may have changed — or, carrying `input`, for an answer only the person can\n * give (AGL-3978), which the beat leaves alone; `needs_review` — the job stopped for a person's decision\n * (AGL-2935): its plan is ready to confirm, or an answer broke a building\n * rule on its re-ask. No timer can make that decision, so neither the beat\n * nor anything but that person resumes it. The last three are terminal.\n */\nexport type AiJobStatus =\n  | 'queued'\n  | 'running'\n  | 'needs_input'\n  | 'needs_review'\n  | 'done'\n  | 'failed'\n  | 'canceled'\n\nexport const AI_JOB_TERMINAL_STATUSES: readonly AiJobStatus[] = [\n  'done',\n  'failed',\n  'canceled',\n]\n\nexport type AiJobStepStatus = 'pending' | 'running' | 'done' | 'failed'\n\n/** The step a planned kind runs first (AGL-2935): its plan, before anything is built. */\nexport const AI_JOB_PLAN_STEP = 'plan'\n\nexport interface AiJobStep {\n  /** Stable within the job (`plan`, `draft`, `generate`), unique per job. */\n  name: string\n  status: AiJobStepStatus\n  startedAt?: ITimestamp | null\n  endedAt?: ITimestamp | null\n  /** Credits this step has actually cost, at the plan's credit rate. */\n  creditsSpent: number\n  /** Customer-safe only; provider detail goes to the server log. */\n  error?: string | null\n  /**\n   * How many times a runner has been handed this step. A retryable provider\n   * failure hands the step back as `pending`; the count is what stops a\n   * provider outage re-running a step forever.\n   */\n  attempts?: number\n  /**\n   * Passes of a step that works through a list (AGL-2910): each one a\n   * recorded, metered exchange that asked to continue. Attempts count again\n   * from zero after a pass; this count is what bounds the step.\n   */\n  passes?: number\n  /**\n   * What the step's model calls cost in tokens and time (AGL-2937), summed\n   * over every run that reached the provider. Absent on a step none has.\n   */\n  tokens?: AiJobStepTokens\n  /**\n   * The ids the step writes its drafts under, by draft (AGL-3079): minted\n   * when the job is created, so every run of the step names the same drafts.\n   * Absent on a step that writes none; a step that records none names its\n   * drafts by the job's own id.\n   */\n  draftIds?: Partial<Record<AiJobDraftSlot, string>>\n}\n\n/**\n * A draft a job's kind always writes (AGL-3079): a screen, layout, template,\n * form or component; an email design; a campaign; an automation.\n */\nexport type AiJobDraftSlot =\n  | 'screen'\n  | 'layout'\n  | 'template'\n  | 'form'\n  | 'component'\n  | 'email'\n  | 'campaign'\n  | 'workflow'\n\n/**\n * A step's measure (AGL-2937): the four token counts the meter prices, the\n * time spent in the runner, and the model and thinking effort of the last\n * run. The machine writes it beside `creditsSpent`, so what a kind of step\n * costs in tokens is read off the job rather than inferred from the month.\n */\nexport interface AiJobStepTokens {\n  /** Prompt tokens sent uncached. */\n  input: number\n  /** Prompt tokens read from the prompt cache. */\n  cachedRead: number\n  /** Prompt tokens written to the prompt cache. */\n  cacheWrite: number\n  /** Tokens generated, thinking included. */\n  output: number\n  /** The model the last run was served by. */\n  model: string | null\n  /** The thinking effort the last run asked for; `null` when it named none. */\n  effort: AiEffort | null\n  /** Milliseconds spent in the runner, summed over runs. */\n  latencyMs: number\n  /** Runs that reached the provider. */\n  runs: number\n  /**\n   * Why the step's latest runs stopped (AGL-3042), oldest first and the last\n   * run last: each run's stop reason and the tokens it generated, so a pass\n   * cut off at its ceiling reads off the job rather than out of the sums. At\n   * most `AI_JOB_STEP_LAST_RUNS` are kept; absent on a step measured before.\n   */\n  lastRuns?: AiJobStepRunStop[]\n}\n\n/** One run of a step, by why it stopped (AGL-3042). */\nexport interface AiJobStepRunStop {\n  /**\n   * The stop reason of the run's last model call — `tool_use` or `end_turn`\n   * for an answer, `max_tokens` for one cut off at its ceiling, `refusal` —\n   * and `null` when the provider named none.\n   */\n  stopReason: string | null\n  /** Tokens the run generated, over every model call it made. */\n  output: number\n}\n\nexport type AiJobOutputResource =\n  | 'screen'\n  | 'reusableComponent'\n  | 'layout'\n  | 'template'\n  | 'form'\n  | 'emailScreen'\n  | 'campaign'\n  | 'product'\n  | 'experiment'\n  | 'workflow'\n  | 'text'\n  | 'theme'\n  | 'seo'\n  | 'insight'\n  | 'crm'\n  /** A draft another plugin wrote for a build (AGL-3616), named by `draftResource`. */\n  | 'draft'\n  | 'logic'\n  | 'orgAutomation'\n  /** A post a guided start wrote into the site's blog (AGL-3676): a content collection entry. */\n  | 'entry'\n  /** A site's settings a build changed (AGL-3748): saved live, on the host document. */\n  | 'settings'\n  /** Files in a site's media library a build organized (AGL-3752): saved live, on their documents. */\n  | 'media'\n  /** A site's tracking tags a build changed (AGL-3751): saved live, on the host document. */\n  | 'tracking'\n\n/**\n * One thing a job wrote. Addressed by resource and id so the console can\n * build the \"open draft\" link without knowing what the runner did; `text`\n * has no document of its own, so its body rides on the output itself.\n *\n * A `theme` output is a proposal rather than a document (AGL-2938). A site's\n * theme is fields on its host document, and writing those fields is the save\n * the Theme section's editor performs, which a job never does. So the change\n * set rides on the output as `proposal`, and a person puts it in the editor\n * and saves it there, or does not.\n *\n * An `seo` output is a proposal rather than a document (AGL-2910): search\n * listing values for a page or a product, or a site audit's findings and\n * fixes. A screen's listing is served from the screen document itself, so a\n * job never writes it; the values ride on the output as `proposal`, a person\n * puts them in the editor and saves them there, and an audit's content fixes\n * become new versions only when a person applies them.\n *\n * A `crm` output is a proposal too (AGL-2917): a record's summary and next\n * step, an email draft, or an import's column matches. The CRM's own task\n * form, stage route, composer and import drawer are the writes, and a person\n * makes each of them, or does not.\n *\n * A `logic` output is a proposal too (AGL-3603): a site function or variable\n * the Functions & Variables editor opens unsaved. Saving it is the editor's\n * write, which a person makes, or does not.\n *\n * An `orgAutomation` output is a proposal too (AGL-3603): one of the\n * workspace's automations, which the Org automations editor opens unsaved and\n * switched off. `hostId` is `null`: it belongs to no one site.\n */\nexport interface AiJobOutput {\n  resource: AiJobOutputResource\n  id: string\n  /** The unpublished version the job created, where the resource has versions. */\n  versionId?: string | null\n  /** `null` for an output that belongs to the org rather than one site. */\n  hostId: string | null\n  /**\n   * The site's subdomain, which is what a console URL names a site by: the\n   * `[host]` segment resolves by subdomain, so a link built from `hostId`\n   * names no site the console can open.\n   */\n  hostSubdomain?: string | null\n  label: string\n  /** The body of a `text` output. Absent on every other resource. */\n  text?: string\n  /**\n   * The change set of an output a person applies rather than opens — a\n   * `theme` or `seo` proposal — in the shape its job kind's runner defines.\n   */\n  proposal?: Record<string, unknown>\n  /**\n   * What the person decides next about this output, in customer-safe words:\n   * a routing the draft could not store, or part of the brief it could not\n   * build. Absent when there is nothing to decide.\n   */\n  note?: string | null\n  /**\n   * What a first visit is estimated to transfer, as the doctrine measured\n   * the generated document (AGL-2935) — the weight the proposal shows before\n   * anything is applied. Absent where the output is not a page's document.\n   */\n  load?: AiLoadEstimate | null\n  /**\n   * For a `draft` output (AGL-3616): the resource whose owner wrote it, as\n   * its writer is registered on the resource-draft seam.\n   */\n  draftResource?: string\n}\n\nexport interface AiJobLease {\n  /** The process that holds the step: a route request id or a beat id. */\n  owner: string\n  until: ITimestamp\n}\n\n/** Why a job stopped for a person (AGL-2935). */\nexport type AiJobReviewReason =\n  /** The plan step proposed a plan; generation waits for it to be confirmed. */\n  | 'plan'\n  /** An answer broke a building rule, and so did the answer to the re-ask. */\n  | 'doctrine'\n  /**\n   * The site is at an allowance its plan sets for what the step writes, such\n   * as its shared layouts or its templates (AGL-2909). Freeing one, or a plan\n   * that holds more, is the member's decision; trying again runs the step\n   * again.\n   */\n  | 'limit'\n  /**\n   * A site import's wave is in (AGL-3976): its pages are drafts for the\n   * person to review, and the next wave starts only when they say so. Or the\n   * import has read the site and waits for the first wave to be started.\n   */\n  | 'wave'\n  /**\n   * A site import's next wave needs a current proof that the workspace owns\n   * the site (AGL-3976): the proof is older than its 30 days, or was never\n   * made. Verifying again and starting the wave runs it.\n   */\n  | 'ownership'\n\n/**\n * A building rule an answer broke, as the job keeps it: the number, the code,\n * the sentence, and where in the answer it was broken (AGL-3078).\n */\nexport interface AiJobRuleFinding {\n  rule: number | null\n  code: string\n  /** Customer-safe. */\n  message: string\n  /** The nodes the finding names, by the ids the refused answer gave them. Absent when it names none. */\n  nodeIds?: string[]\n  /** The plan entries or answer fields it names, as `screens[0].sections[2]`. Absent when it names none. */\n  paths?: string[]\n}\n\n/**\n * One node of the parts of a refused answer its findings name (AGL-3078), as\n * the review keeps it: the node's place, its element and the names of what it\n * sets, and never its copy. A Grid keeps the values of its layout props as\n * they were written, so a review can tell a shape the rules refuse from one\n * the model was asked to mend and did not.\n */\nexport interface AiJobReviewOutlineNode {\n  /** The node's id, as the refused answer wrote it. */\n  id: string\n  /** How far below a node a finding names it sits: 0 for that node. */\n  depth: number\n  componentId: string\n  /** The props it sets, by name only. */\n  props: string[]\n  /** The `sx` keys it sets, by name only; absent when it sets none. */\n  sx?: string[]\n  /** A Grid's layout props, `container`, `size`, `direction`, `spacing` and the rest, as written. */\n  grid?: Record<string, string | number | boolean | null>\n  /** Its children's element ids, in order. */\n  children: string[]\n}\n\nexport interface AiJobReview {\n  reason: AiJobReviewReason\n  /** Customer-safe: what the person is asked to decide. */\n  message: string\n  /** The rules the last answer broke; empty for a plan. */\n  findings: AiJobRuleFinding[]\n  /**\n   * The parts of the refused answer its findings name, each node with the\n   * nodes below it (AGL-3078); absent when they name none. Kept with the job\n   * for diagnosis, and shown to staff.\n   */\n  outline?: AiJobReviewOutlineNode[]\n  /**\n   * The checks' own sentence, where `message` was written for the member\n   * instead (AGL-3594): rule numbers and all, for staff. Its presence is what\n   * tells the drawer the findings are staff reading too.\n   */\n  detail?: string\n  /**\n   * Why trying again cannot work yet (AGL-3594) — the Free allowance left is\n   * less than the step can cost — or absent when it can. The button is drawn\n   * disabled with this beside it.\n   */\n  retryRefusal?: string\n  /**\n   * What a Free workspace had left when a build's plan was kept (AGL-3722),\n   * so its plan card says, before Confirm, whether the build fits and offers\n   * the go-ahead or a smaller first build when it does not. The confirm door\n   * reads what is left again; this is what the card shows.\n   */\n  freeCredits?: AiFreeCreditsLeft\n}\n\n/**\n * One answer a job waits for (AGL-3978): an id only the person has, which the\n * operation that needs it describes — a tracking change's Meta pixel ID.\n */\nexport interface AiJobInputField {\n  /** The plan item the answer fills, by its name in the plan. */\n  item: string\n  /** The item's argument the answer is written to. */\n  arg: string\n  /** The field's label, naming the provider: \"Meta pixel ID\". */\n  label: string\n  /** What an answer looks like, in the words of the card that sets it: \"8–20 digits\". */\n  shape: string\n  /** The pattern an answer is held to, as a RegExp's source. */\n  pattern: string\n}\n\n/** What a job parked `needs_input` for a person asks (AGL-3978). */\nexport interface AiJobInputRequest {\n  /** Customer-safe: the question, in the operation's own words. */\n  message: string\n  fields: AiJobInputField[]\n}\n\nexport type AiJobPlanStatus = 'proposed' | 'confirmed'\n\n/** The plan a job builds from, as the job keeps it once its plan step proposed it. */\nexport interface AiJobPlan extends AiBuildPlan {\n  status: AiJobPlanStatus\n  /** Names for the inventory ids the plan references, read when it was made. */\n  labels: Record<string, string>\n  proposedAt: ITimestamp\n  confirmedAt: ITimestamp | null\n  /** The member who confirmed it. */\n  confirmedBy: string | null\n  /**\n   * A digest of the whole request that produced this plan (AGL-2937): the\n   * job's kind, site, brief and scalar inputs, the model that answered, and\n   * the prompt as it was rendered — the site inventory included. A later job\n   * whose request hashes the same reuses this plan rather than paying for the\n   * same answer again. A hash of the request, never of the answer, and no\n   * part of the brief is recoverable from it.\n   */\n  key?: string\n  /** The job this plan was reused from, when it was not asked for again. */\n  reusedFrom?: string\n  /**\n   * What a site start read of the sites the person likes (AGL-3975): signals\n   * only, each from a closed set or a hex color, which the plan was told the\n   * structure of and the look pins the style of. Absent without them.\n   */\n  inspiration?: AiSiteInspiration\n}\n\n/**\n * Where one item of a `build` job stands (AGL-3616). A build settles item by\n * item: a failed item gives back its own spend and the rest of the plan still\n * runs, so the job keeps one row per item, written only by the machine's\n * `recordStep` — in the same transaction as the spend it accounts for — and\n * by the resume door's retry.\n */\nexport type AiJobItemStatus = 'pending' | 'running' | 'succeeded' | 'degraded' | 'failed' | 'skipped'\n\n/** Why an item failed: a give-back reason when it was ours, else the model's refusal or a review. */\nexport type AiJobItemFailureReason =\n  | 'plan-refused'\n  | 'doctrine-refused'\n  | 'provider'\n  | 'timeout'\n  | 'step-failure'\n  | 'unavailable'\n  | 'refused'\n  | 'review'\n\nexport interface AiJobItemFailure {\n  /** Whether the failure was on our side: only then is the item's spend given back. */\n  ours: boolean\n  reason: AiJobItemFailureReason\n  /** Customer-safe. */\n  message: string\n  /**\n   * The checks' own sentence behind a `doctrine-refused` failure (AGL-3596),\n   * rule numbers and all: kept on the job for staff and debugging, never on\n   * the wire a customer reads.\n   */\n  detail?: string\n}\n\nexport interface AiJobItemLedger {\n  /** The unit's slot within the plan: `c0` a creation, `p0` a page, `i0` an item. */\n  slot: string\n  /** The capability operation that builds it: `page`, `form`, or an owner's op. */\n  op: string\n  /** What a person reads: the page's title, the creation's or item's name. */\n  label: string\n  status: AiJobItemStatus\n  /** Bumped by Try again; the refund key names it, so each attempt gives back once. */\n  attempt: number\n  /** What this item's passes cost, every attempt. */\n  creditsSpent: number\n  /** What this attempt's passes cost so far: what a failure of this attempt gives back. */\n  attemptCredits?: number\n  /** What was given back for this item's failures. */\n  creditsRefunded: number\n  /** The key the latest give-back for this item was made under. */\n  refundKey?: string\n  failure?: AiJobItemFailure | null\n  /** The ids of the outputs this item produced. */\n  outputs: string[]\n  /** The slots whose failure changed how this item was built. */\n  degradedBy?: string[]\n  /** Customer-safe: what the person should know about this item. */\n  note?: string | null\n  /**\n   * When this attempt settled, as an ISO string (AGL-3596): the moment the\n   * next item started, which is what its progress row counts from. Absent\n   * while the item is open, and on a ledger written before it was kept.\n   */\n  settledAt?: string | null\n}\n\n/** Whether a build's own planning was charged or given back (AGL-3616). */\nexport interface AiJobOrchestration {\n  /** What the plan step spent. */\n  creditsSpent: number\n  /** `charged` once anything was delivered; `refunded` when nothing was. */\n  settled: 'pending' | 'charged' | 'refunded'\n}\n\nexport interface AiJob {\n  $id: string\n  orgId: string\n  hostId?: string | null\n  kind: AiJobKind\n  status: AiJobStatus\n  /** The customer's brief, verbatim. Expires with the document. */\n  brief: string\n  /** Kind-specific inputs the runner reads (a screen id to edit, a tone). */\n  inputs: Record<string, unknown>\n  /**\n   * The model the creator picked for the job's steps (AGL-2942), or `null`\n   * for Auto. Each step honors it only where the plan and the allotment\n   * allowlists allow it, and runs on the routing table otherwise.\n   */\n  model?: string | null\n  steps: AiJobStep[]\n  outputs: AiJobOutput[]\n  /**\n   * The nominal credit figure held against the job while steps are\n   * outstanding. The meter's real bound is the per-step message reservation\n   * and the org's monthly ceiling; this is the number the console shows so\n   * a running job is not read as free.\n   */\n  creditsReserved: number\n  creditsSpent: number\n  /**\n   * Credits the job gave back because it failed on our side (AGL-3594),\n   * summed over its give-backs; absent when it gave none. `creditsSpent`\n   * stays what ran, so what the job cost is the one less the other.\n   */\n  refundedCredits?: number\n  /** Why the latest give-back was made (`AiJobRefundReason`). */\n  refundReason?: string\n  /** How many give-backs the job has had: the next one's key. */\n  refunds?: number\n  createdBy: string\n  createdAt: ITimestamp\n  updatedAt: ITimestamp\n  /** TTL — the brief is verbatim customer text and expires like an exchange. */\n  expiresAt: ITimestamp\n  /** Customer-safe only. */\n  error?: string | null\n  lease?: AiJobLease | null\n  /** The plan the job builds from, once its plan step proposed one. */\n  plan?: AiJobPlan | null\n  /** What the person is asked to decide while the job is `needs_review`. */\n  review?: AiJobReview | null\n  /**\n   * What the job waits for while it is `needs_input` for a person rather than\n   * the meter (AGL-3978): the fields only they can fill, an id the planner\n   * must never make up. Its plan and the plan's review are kept beside it,\n   * and the answer returns the job to that review.\n   */\n  input?: AiJobInputRequest | null\n  /**\n   * What a person applied from the job's outputs (AGL-2910). Written by the\n   * door that applied them, never by a step runner, and absent until then.\n   */\n  applied?: AiJobApplied | null\n  /**\n   * What a guided site start put live when it finished (AGL-3596): written\n   * once by the site step's last pass, never by a person. Absent on every\n   * other job, which leaves its pages as drafts.\n   */\n  sitePublish?: AiJobSitePublish | null\n  /** A `build` job's items, one row each (AGL-3616); absent on every other kind. */\n  items?: AiJobItemLedger[] | null\n  /** A `build` job's planning spend and how it settled (AGL-3616). */\n  orchestration?: AiJobOrchestration | null\n  /**\n   * A Free job started past what was left (AGL-3722): the person chose to\n   * build what fits, knowing it pauses where the credits run out. Who, when,\n   * what was left and the range they were shown; absent on every job that fit.\n   */\n  creditsConfirmed?: AiJobCreditsConfirmation | null\n  /**\n   * A person asked to stop the job (AGL-3616): written only by the cancel\n   * door, in the transaction that decides it. A job no step holds ends\n   * `canceled` in that same write; a job whose step holds a live lease keeps\n   * running until the step finishes or aborts, and the machine ends it\n   * `canceled` at its next write. Absent on a job nobody canceled.\n   */\n  cancelRequested?: AiJobCancelRequest | null\n  /**\n   * The empty site this guided start was for was removed (AGL-3936): the\n   * job was cancelled or failed before it built anything, nobody chose what\n   * to do next within the grace period, and the AI jobs beat deleted the\n   * site. Written once, by the beat, after the site is gone. Absent on every\n   * other job.\n   */\n  siteRemoved?: AiJobSiteRemoved | null\n  /**\n   * An `import` job's site, read and cut into waves (AGL-3976): what was\n   * found, what is brought in in which wave, what was left out and why, and\n   * each wave's state. Written only by the machine's `recordStep`, from what\n   * the import step returns; absent on every other kind.\n   */\n  siteImport?: AiSiteImportState | null\n}\n\n/** When the AI jobs beat removed a guided start's empty site, and which (AGL-3936). */\nexport interface AiJobSiteRemoved {\n  at: ITimestamp\n  /** The site's name as it was, for a sentence that names it. */\n  name: string | null\n}\n\n/** Who asked to cancel a job, and when (AGL-3616). */\nexport interface AiJobCancelRequest {\n  at: ITimestamp\n  /** The member or staff account that asked; `null` when nobody was named. */\n  by: string | null\n}\n\n/**\n * A guided site start's publish (AGL-3596): the pages that went live, with\n * the address each answers, and the pages that stayed drafts, each with the\n * plain sentence for why. A page that stayed a draft never fails the job.\n */\nexport interface AiJobSitePublish {\n  /** The site's live address, `https://<subdomain>.aglyn.app/`; `null` when the site has no subdomain. */\n  liveUrl: string | null\n  published: Array<{ id: string; label: string; path: string }>\n  drafts: Array<{ id: string; label: string; reason: string }>\n}\n\n/**\n * The record of an apply (AGL-2910): what became a new unpublished version,\n * and what waits in its editor for a person to save.\n */\nexport interface AiJobApplied {\n  at: ITimestamp\n  /** The member who applied. */\n  by: string\n  /** The new version opened for each resource, by resource id. */\n  versions: Record<string, string>\n  /** Resource ids whose proposed values wait in their editor, unsaved. */\n  staged: string[]\n}\n\n/** The plan on the wire: every instant an ISO string. */\nexport interface AiJobPlanSummary extends AiBuildPlan {\n  status: AiJobPlanStatus\n  labels: Record<string, string>\n  proposedAt: string | null\n  confirmedAt: string | null\n  confirmedBy: string | null\n  key?: string\n  reusedFrom?: string\n}\n\n/**\n * The wire form the console reads: every instant an ISO string, the lease\n * reduced to whether a runner holds the job. The brief and the outputs\n * travel as they are — the reader is a member of the org that wrote them.\n */\nexport interface AiJobSummary {\n  id: string\n  orgId: string\n  hostId: string | null\n  kind: AiJobKind\n  status: AiJobStatus\n  brief: string\n  /**\n   * The batch a door created this job as one of (AGL-2911), read off the\n   * job's inputs; `null` for a job created on its own. The console groups a\n   * run of jobs by it, which is the one thing it cannot do from a list whose\n   * rows carry no inputs — and the only input the wire form carries, because\n   * a batch id names nothing the member wrote.\n   */\n  batch: string | null\n  steps: Array<{\n    name: string\n    status: AiJobStepStatus\n    startedAt: string | null\n    endedAt: string | null\n    creditsSpent: number\n    error: string | null\n  }>\n  outputs: AiJobOutput[]\n  creditsReserved: number\n  creditsSpent: number\n  /** Credits given back for a failure on our side (AGL-3594); 0 when none. */\n  refundedCredits?: number\n  createdBy: string\n  createdAt: string\n  updatedAt: string\n  error: string | null\n  running: boolean\n  plan: AiJobPlanSummary | null\n  review: AiJobReview | null\n  /** The fields a `needs_input` job waits for a person to fill (AGL-3978); absent otherwise. */\n  input?: AiJobInputRequest | null\n  /** What a person applied from the outputs (AGL-2910); instants as ISO strings. */\n  applied?: {\n    at: string | null\n    by: string\n    versions: Record<string, string>\n    staged: string[]\n  } | null\n  /** What a guided site start put live (AGL-3596); absent on every other job. */\n  sitePublish?: AiJobSitePublish | null\n  /**\n   * A site job's answers (AGL-3596): the guided start's questions as the person\n   * answered them, so a failed start's Try again reopens them filled in. The\n   * scalar site inputs only, never anything else a job's inputs carry; absent\n   * on every other kind.\n   */\n  siteInputs?: Record<string, unknown> | null\n  /**\n   * Whether the machine confirms this job's plan itself (AGL-3594): a guided\n   * site start. Its plan parks for the instant the confirmation takes, and a\n   * surface reads that park as the build going on (AGL-3596). Absent on every\n   * other job.\n   */\n  autoConfirm?: boolean\n  /** A `build` job's items (AGL-3616); absent on every other job. */\n  items?: AiJobItemLedger[]\n  /**\n   * Whether a build's request asked to publish (AGL-3616), so its plan card\n   * offers the box that confirms it. Absent on every other job.\n   */\n  publishAsked?: boolean\n  /** A `build` job's planning spend and how it settled (AGL-3616). */\n  orchestration?: AiJobOrchestration\n  /**\n   * A cancel was asked and the job has not ended yet (AGL-3616): the step in\n   * flight is finishing or aborting, and nothing after it runs. Absent once\n   * the job is terminal, and on every job nobody canceled.\n   */\n  cancelRequested?: boolean\n  /**\n   * The empty site this guided start was for was removed (AGL-3936): its\n   * page is gone, and Start again opens Create site with the same answers.\n   * Absent on every other job.\n   */\n  siteRemoved?: boolean\n  /**\n   * An `import` job's waves (AGL-3976), without the page text a wave read\n   * holds for the model; absent on every other job.\n   */\n  siteImport?: AiSiteImportState | null\n}\n"],"names":["AI_JOB_KINDS","AI_JOB_TERMINAL_STATUSES","AI_JOB_PLAN_STEP"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAiFD,qEAAqE,GACrE,OAAO,MAAMA,eAAqC;IAChD;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAA;AAqBD,OAAO,MAAMC,2BAAmD;IAC9D;IACA;IACA;CACD,CAAA;AAID,uFAAuF,GACvF,OAAO,MAAMC,mBAAmB,OAAM"}

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

@@ -0,0 +1,122 @@
+/**
+ * @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.
+ */
+/**
+ * The business details a guided start may be given beyond what the site is
+ * for (AGL-3979): how to reach it, where it is, when it is open, where it
+ * works and the profiles that are its own. Every one is optional. Given,
+ * they are what makes a new site read as this business the first time its
+ * owner opens it — the phone number in the footer, the email on the contact
+ * page — and what its structured data and its `/llms.txt` say about it.
+ *
+ * They travel as flat strings among the `site` job's scalar inputs, like the
+ * answers before them, so a failed start's summary carries them back and Try
+ * again reopens the questions filled in. Each one has its own rule here,
+ * shared by the questions (which say what is wrong beside the field) and the
+ * create door (`parseAiSiteJobInputs`, which refuses what the questions would
+ * not have sent).
+ *
+ * Pure: strings in, strings out.
+ */
+/** Every detail, by its input key. */
+export declare const AI_SITE_DETAIL_KEYS: readonly ["phone", "email", "tagline", "founded", "serviceArea", "priceRange", "languages", "street", "region", "postalCode", "country", "hours", "social"];
+export type AiSiteDetailKey = (typeof AI_SITE_DETAIL_KEYS)[number];
+/** The details as a job's inputs carry them, each `''` where nobody said. */
+export type AiSiteDetails = Record<AiSiteDetailKey, string>;
+/** The longest each detail may be, in characters. Together far under the door's 8,000. */
+export declare const AI_SITE_DETAIL_MAX_CHARS: Readonly<Record<AiSiteDetailKey, number>>;
+/** The most profile links a start takes. */
+export declare const AI_SITE_SOCIAL_MAX = 6;
+/** No details at all. */
+export declare const AI_SITE_NO_DETAILS: Readonly<AiSiteDetails>;
+/** Why a detail cannot be used, as a closed code the funnel counts and a sentence beside the field. */
+export interface AiSiteDetailProblem {
+    code: 'too_long' | 'invalid';
+    message: string;
+}
+/** Whether a phone number reads as one: digits with the usual separators, a `+` only first, 7 to 15 digits. */
+export declare function aiSitePhoneValid(value: string): boolean;
+/**
+ * The `tel:` address of a phone number, or `''` for one that does not read.
+ *
+ * Its digits are the number's own, with a `+` only where the person typed one:
+ * no country is inferred, so the link dials the number exactly as given, and
+ * the layout's own check, which reads a number by its digits, finds the same
+ * digits in the brief as in the link.
+ */
+export declare function aiSitePhoneHref(value: string): string;
+/** Whether an email address reads as one. */
+export declare function aiSiteEmailValid(value: string): boolean;
+/** The `mailto:` address of an email, or `''` for one that does not read. */
+export declare function aiSiteEmailHref(value: string): string;
+/**
+ * The profile links a detail names, one a line (commas and spaces separate
+ * them too), each an https page, at most {@link AI_SITE_SOCIAL_MAX}, each
+ * once; `null` when one of them is not a link at all.
+ */
+export declare function aiSiteSocialLinks(value: string): string[] | null;
+/** The areas a detail names, one a line or separated by commas, each once, at most twenty. */
+export declare function aiSiteServiceAreas(value: string): string[];
+/** The opening hours a detail holds, as the lines that read (`Mo-Fr 09:00-17:00`), one a line. */
+export declare function aiSiteHoursText(value: string): string;
+/**
+ * The opening hours as a person reads them — "Mon–Fri 9am–5pm; Sat 10am–2pm"
+ * — which is how the brief states them: the layout's own check admits a
+ * footer's hours only where the brief gives hours it can read as hours, and
+ * `Mo-Fr 09:00-17:00` is written for a machine.
+ */
+export declare function aiSiteHoursSentence(value: string): string;
+/**
+ * What is wrong with one detail, worded for the person beside its field; `null`
+ * when it may be used. An empty detail is always fine: every one is optional.
+ */
+export declare function aiSiteDetailProblem(key: AiSiteDetailKey, raw: unknown, options?: {
+    now?: Date;
+}): AiSiteDetailProblem | null;
+/**
+ * The details a job's inputs carry, each held to its rule and tidied — the
+ * profile links as https pages one a line, the areas one a line, only the
+ * opening hours that read — or the sentence the create door refuses them
+ * with. A key the inputs leave out is `''`.
+ */
+export declare function parseAiSiteDetails(inputs: Readonly<Record<string, unknown>> | null | undefined, options?: {
+    now?: Date;
+}): AiSiteDetails | string;
+/** A job's details, read leniently: anything that breaks its rule reads as not given. */
+export declare function aiSiteDetailsOf(inputs: Readonly<Record<string, unknown>> | null | undefined): AiSiteDetails;
+/** How a visitor reaches the business, as the pages link it; `null` when neither was given. */
+export interface AiSiteContact {
+    /** The number as the person wrote it, which is how the pages show it. */
+    phone: string;
+    phoneHref: string;
+    email: string;
+    emailHref: string;
+}
+/** The phone and email a job's inputs give, with the links they make; `null` for neither. */
+export declare function aiSiteContactOf(inputs: Readonly<Record<string, unknown>> | null | undefined): AiSiteContact | null;
+/** The street address the details and the city make, as one line: "214 Main Street, Austin, TX 78701, US". */
+export declare function aiSiteAddressLine(details: Pick<AiSiteDetails, 'street' | 'region' | 'postalCode' | 'country'>, city?: string): string;
+/**
+ * What every unit of a site job is told about the business beyond what it is
+ * (AGL-3979), on the job's own turn: its contact details, place and hours,
+ * then everything else the person gave, then — where there is a phone or an
+ * email — that the pages show them as written and how a link calls or writes.
+ * Empty when the person gave no details, so a start without them is told
+ * exactly what it was told before.
+ */
+export declare function aiSiteDetailsBriefLines(details: AiSiteDetails, options?: {
+    city?: string;
+}): string[];

package/src/lib/model/ai-site-details.js

@@ -0,0 +1,300 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { AREA_SERVED_MAX, PRICE_RANGE_MAX_LENGTH, normalizeAreaServed, parseOpeningHours } from "@aglyn/aglyn/app-utils/local-business";
+/**
+ * The business details a guided start may be given beyond what the site is
+ * for (AGL-3979): how to reach it, where it is, when it is open, where it
+ * works and the profiles that are its own. Every one is optional. Given,
+ * they are what makes a new site read as this business the first time its
+ * owner opens it — the phone number in the footer, the email on the contact
+ * page — and what its structured data and its `/llms.txt` say about it.
+ *
+ * They travel as flat strings among the `site` job's scalar inputs, like the
+ * answers before them, so a failed start's summary carries them back and Try
+ * again reopens the questions filled in. Each one has its own rule here,
+ * shared by the questions (which say what is wrong beside the field) and the
+ * create door (`parseAiSiteJobInputs`, which refuses what the questions would
+ * not have sent).
+ *
+ * Pure: strings in, strings out.
+ */ /** Every detail, by its input key. */ export const AI_SITE_DETAIL_KEYS = [
+    'phone',
+    'email',
+    'tagline',
+    'founded',
+    'serviceArea',
+    'priceRange',
+    'languages',
+    'street',
+    'region',
+    'postalCode',
+    'country',
+    'hours',
+    'social'
+];
+/** The longest each detail may be, in characters. Together far under the door's 8,000. */ export const AI_SITE_DETAIL_MAX_CHARS = {
+    phone: 32,
+    email: 254,
+    tagline: 120,
+    founded: 4,
+    serviceArea: 400,
+    priceRange: PRICE_RANGE_MAX_LENGTH,
+    languages: 120,
+    street: 120,
+    region: 80,
+    postalCode: 20,
+    country: 80,
+    hours: 600,
+    social: 1200
+};
+/** The most profile links a start takes. */ export const AI_SITE_SOCIAL_MAX = 6;
+/** No details at all. */ export const AI_SITE_NO_DETAILS = Object.fromEntries(AI_SITE_DETAIL_KEYS.map((key)=>[
+        key,
+        ''
+    ]));
+const PHONE_CHARS = /^\+?[\d\s().-]+$/;
+/** Whether a phone number reads as one: digits with the usual separators, a `+` only first, 7 to 15 digits. */ export function aiSitePhoneValid(value) {
+    const text = value.trim();
+    if (!PHONE_CHARS.test(text)) return false;
+    const digits = text.replace(/\D/g, '');
+    return digits.length >= 7 && digits.length <= 15;
+}
+/**
+ * The `tel:` address of a phone number, or `''` for one that does not read.
+ *
+ * Its digits are the number's own, with a `+` only where the person typed one:
+ * no country is inferred, so the link dials the number exactly as given, and
+ * the layout's own check, which reads a number by its digits, finds the same
+ * digits in the brief as in the link.
+ */ export function aiSitePhoneHref(value) {
+    if (!aiSitePhoneValid(value)) return '';
+    const text = value.trim();
+    return `tel:${text.startsWith('+') ? '+' : ''}${text.replace(/\D/g, '')}`;
+}
+const EMAIL = /^[^\s@<>()[\]\\,;:"]+@[^\s@<>()[\]\\,;:"]+\.[^\s@<>()[\]\\,;:".]{2,}$/;
+/** Whether an email address reads as one. */ export function aiSiteEmailValid(value) {
+    const text = value.trim();
+    return text.length <= AI_SITE_DETAIL_MAX_CHARS.email && EMAIL.test(text);
+}
+/** The `mailto:` address of an email, or `''` for one that does not read. */ export function aiSiteEmailHref(value) {
+    return aiSiteEmailValid(value) ? `mailto:${value.trim()}` : '';
+}
+/** A link typed without its scheme is the https page it names; a plain `http:` one is read as https. */ function asHttps(value) {
+    const text = value.trim();
+    if (/^https:\/\//i.test(text)) return text;
+    if (/^http:\/\//i.test(text)) return `https://${text.slice(7)}`;
+    if (/^(?:www\.)?[a-z0-9-]+(?:\.[a-z0-9-]+)*\.[a-z]{2,}(?:[/?#]\S*)?$/i.test(text)) return `https://${text}`;
+    return text;
+}
+function isHttps(value) {
+    try {
+        const url = new URL(value);
+        return url.protocol === 'https:' && url.hostname.includes('.');
+    } catch (unused) {
+        return false;
+    }
+}
+/**
+ * The profile links a detail names, one a line (commas and spaces separate
+ * them too), each an https page, at most {@link AI_SITE_SOCIAL_MAX}, each
+ * once; `null` when one of them is not a link at all.
+ */ export function aiSiteSocialLinks(value) {
+    const links = [];
+    for (const part of value.split(/[\s,]+/)){
+        if (!part.trim()) continue;
+        const link = asHttps(part);
+        if (!isHttps(link)) return null;
+        if (!links.some((seen)=>seen.toLowerCase() === link.toLowerCase())) links.push(link);
+    }
+    return links.slice(0, AI_SITE_SOCIAL_MAX);
+}
+/** The areas a detail names, one a line or separated by commas, each once, at most twenty. */ export function aiSiteServiceAreas(value) {
+    return normalizeAreaServed(value.split(/\r?\n|,|;/)).slice(0, AREA_SERVED_MAX);
+}
+/** The opening hours a detail holds, as the lines that read (`Mo-Fr 09:00-17:00`), one a line. */ export function aiSiteHoursText(value) {
+    return value.split(/\r?\n/).map((line)=>line.trim()).filter((line)=>line && parseOpeningHours(line).length).join('\n');
+}
+const DAY_SHORT = {
+    Monday: 'Mon',
+    Tuesday: 'Tue',
+    Wednesday: 'Wed',
+    Thursday: 'Thu',
+    Friday: 'Fri',
+    Saturday: 'Sat',
+    Sunday: 'Sun'
+};
+const WEEK = Object.keys(DAY_SHORT);
+/** "09:00" as "9am", "17:30" as "5:30pm", "00:00" as "12am". */ function clock(time) {
+    const [h = 0, m = 0] = time.split(':').map(Number);
+    const suffix = h < 12 ? 'am' : 'pm';
+    const hour = h % 12 === 0 ? 12 : h % 12;
+    return `${hour}${m ? `:${String(m).padStart(2, '0')}` : ''}${suffix}`;
+}
+/** A row's days as a reader says them: "Mon–Fri" for a run, "Mon, Wed" otherwise. */ function daysOf(row) {
+    const at = row.days.map((day)=>WEEK.indexOf(day)).sort((a, b)=>a - b);
+    const run = at.every((index, position)=>position === 0 || index === at[position - 1] + 1);
+    if (run && at.length > 2) return `${DAY_SHORT[WEEK[at[0]]]}–${DAY_SHORT[WEEK[at[at.length - 1]]]}`;
+    return at.map((index)=>DAY_SHORT[WEEK[index]]).join(', ');
+}
+/**
+ * The opening hours as a person reads them — "Mon–Fri 9am–5pm; Sat 10am–2pm"
+ * — which is how the brief states them: the layout's own check admits a
+ * footer's hours only where the brief gives hours it can read as hours, and
+ * `Mo-Fr 09:00-17:00` is written for a machine.
+ */ export function aiSiteHoursSentence(value) {
+    return parseOpeningHours(value).map((row)=>`${daysOf(row)} ${clock(row.opens)}–${clock(row.closes)}`).join('; ');
+}
+/**
+ * What is wrong with one detail, worded for the person beside its field; `null`
+ * when it may be used. An empty detail is always fine: every one is optional.
+ */ export function aiSiteDetailProblem(key, raw, options = {}) {
+    if (raw === undefined || raw === null || raw === '') return null;
+    if (typeof raw !== 'string') return {
+        code: 'invalid',
+        message: 'Use plain text here.'
+    };
+    const value = raw.trim();
+    if (!value) return null;
+    const max = AI_SITE_DETAIL_MAX_CHARS[key];
+    if (value.length > max) return {
+        code: 'too_long',
+        message: `Keep this under ${max} characters.`
+    };
+    switch(key){
+        case 'phone':
+            return aiSitePhoneValid(value) ? null : {
+                code: 'invalid',
+                message: 'Enter the phone number with its area code, like (512) 555-0142 or +44 20 7946 0958.'
+            };
+        case 'email':
+            return aiSiteEmailValid(value) ? null : {
+                code: 'invalid',
+                message: 'Enter an email address, like hello@yourbusiness.com.'
+            };
+        case 'founded':
+            {
+                var _options_now;
+                const year = Number(value);
+                const latest = ((_options_now = options.now) != null ? _options_now : new Date()).getFullYear();
+                return /^\d{4}$/.test(value) && year >= 1000 && year <= latest ? null : {
+                    code: 'invalid',
+                    message: `Enter the year as four digits, like ${latest - 10}.`
+                };
+            }
+        case 'social':
+            return aiSiteSocialLinks(value) ? null : {
+                code: 'invalid',
+                message: 'Paste each profile’s address, one a line, like instagram.com/yourbusiness.'
+            };
+        default:
+            return null;
+    }
+}
+/**
+ * The details a job's inputs carry, each held to its rule and tidied — the
+ * profile links as https pages one a line, the areas one a line, only the
+ * opening hours that read — or the sentence the create door refuses them
+ * with. A key the inputs leave out is `''`.
+ */ export function parseAiSiteDetails(inputs, options = {}) {
+    const details = _extends({}, AI_SITE_NO_DETAILS);
+    for (const key of AI_SITE_DETAIL_KEYS){
+        var _aiSiteSocialLinks;
+        const raw = inputs == null ? void 0 : inputs[key];
+        const problem = aiSiteDetailProblem(key, raw, options);
+        if (problem) return `${key}: ${problem.message}`;
+        const value = typeof raw === 'string' ? raw.trim() : '';
+        if (!value) continue;
+        details[key] = key === 'social' ? ((_aiSiteSocialLinks = aiSiteSocialLinks(value)) != null ? _aiSiteSocialLinks : []).join('\n') : key === 'serviceArea' ? aiSiteServiceAreas(value).join('\n') : key === 'hours' ? aiSiteHoursText(value) : value.replace(/[ \t]+/g, ' ');
+    }
+    return details;
+}
+/** A job's details, read leniently: anything that breaks its rule reads as not given. */ export function aiSiteDetailsOf(inputs) {
+    const details = _extends({}, AI_SITE_NO_DETAILS);
+    for (const key of AI_SITE_DETAIL_KEYS){
+        const one = parseAiSiteDetails({
+            [key]: inputs == null ? void 0 : inputs[key]
+        });
+        if (typeof one !== 'string') details[key] = one[key];
+    }
+    return details;
+}
+/** The phone and email a job's inputs give, with the links they make; `null` for neither. */ export function aiSiteContactOf(inputs) {
+    const details = aiSiteDetailsOf(inputs);
+    const phoneHref = aiSitePhoneHref(details.phone);
+    const emailHref = aiSiteEmailHref(details.email);
+    if (!phoneHref && !emailHref) return null;
+    return {
+        phone: phoneHref ? details.phone : '',
+        phoneHref,
+        email: emailHref ? details.email : '',
+        emailHref
+    };
+}
+/** The street address the details and the city make, as one line: "214 Main Street, Austin, TX 78701, US". */ export function aiSiteAddressLine(details, city = '') {
+    const regional = [
+        details.region,
+        details.postalCode
+    ].map((part)=>part.trim()).filter(Boolean).join(' ');
+    return [
+        details.street,
+        city,
+        regional,
+        details.country
+    ].map((part)=>part.trim()).filter(Boolean).join(', ');
+}
+/**
+ * What every unit of a site job is told about the business beyond what it is
+ * (AGL-3979), on the job's own turn: its contact details, place and hours,
+ * then everything else the person gave, then — where there is a phone or an
+ * email — that the pages show them as written and how a link calls or writes.
+ * Empty when the person gave no details, so a start without them is told
+ * exactly what it was told before.
+ */ export function aiSiteDetailsBriefLines(details, options = {}) {
+    var _options_city;
+    const lines = [];
+    const address = details.street ? aiSiteAddressLine(details, (_options_city = options.city) != null ? _options_city : '') : '';
+    const hours = aiSiteHoursSentence(details.hours);
+    const contact = [
+        details.phone ? `phone: ${details.phone}` : '',
+        details.email ? `email: ${details.email}` : '',
+        address ? `address: ${address}` : '',
+        hours ? `hours: ${hours}` : ''
+    ].filter(Boolean);
+    if (contact.length) lines.push(`Contact — ${contact.join('; ')}.`);
+    const areas = aiSiteServiceAreas(details.serviceArea);
+    const social = details.social ? details.social.split('\n').filter(Boolean) : [];
+    const more = [
+        details.tagline ? `tagline: ${details.tagline}` : '',
+        details.founded ? `founded: ${details.founded}` : '',
+        areas.length ? `serves: ${areas.join(', ')}` : '',
+        details.priceRange ? `price range: ${details.priceRange}` : '',
+        details.languages ? `languages: ${details.languages}` : '',
+        social.length ? `profiles: ${social.join(', ')}` : ''
+    ].filter(Boolean);
+    if (more.length) lines.push(`About the business — ${more.join('; ')}.`);
+    if (details.phone || details.email) {
+        const what = details.phone && details.email ? 'phone number and email' : details.phone ? 'phone number' : 'email';
+        const links = [
+            details.phone ? 'a link that calls goes to "phone"' : '',
+            details.email ? 'a link that writes goes to "email"' : ''
+        ].filter(Boolean).join(' and ');
+        lines.push(`Show the ${what} exactly as written wherever a visitor looks for a way to get in touch: the contact page, the footer, and the buttons that ask a visitor to call or write; ${links}.`);
+    }
+    return lines;
+}
+
+//# sourceMappingURL=ai-site-details.js.map