@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/jobs/ai-job-generation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-generation.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 {\n  REUSABLE_INSTANCE_COMPONENT_ID,\n  REUSABLE_INSTANCE_PROP_VALUES_KEY,\n} from '@aglyn/aglyn/app-utils/reusable-component-keys'\nimport type { AiBuildPlanCreate, AiBuildPlanCreateKind } from '../model/ai-build-plan'\nimport type {\n  AiJob,\n  AiJobOutput,\n  AiJobPlan,\n  AiJobReview,\n  AiJobReviewOutlineNode,\n} from '../model/ai-jobs.types'\nimport type { AiSiteInventory } from '../model/ai-site-inventory'\nimport { aiAnswerTree, type AiGenerationSpend, type AiValidatedTree } from '../runtime/ai-doctrine'\nimport {\n  aiBracketedFacts,\n  aiTreeCopy,\n  walkTree,\n  type AiDoctrineNode,\n  type AiDoctrineTree,\n  type AiDoctrineViolation,\n} from '../runtime/ai-doctrine-validators'\nimport { AI_INSTANCE_REF_PROP } from '../runtime/ai-node-tree'\nimport type { AssistTokenUsage } from '../usage/assist-usage'\nimport { AI_JOB_BRIEF_MAX_CHARS, type AiJobStepOutcome } from './ai-job-text-step'\n\n/**\n * What the generation steps share (AGL-2909): reading the plan a member\n * confirmed, stating it to the model as references, and turning what a\n * generation spent or refused into the outcome the machine records.\n *\n * A generation step runs after its job's plan step, once a member confirmed\n * the plan, so the plan is part of what it executes: the records it reuses,\n * and the creation it builds. The plan travels as references — ids, names,\n * reasons — never as a document (AGL-2937).\n */\n\nexport const AI_JOB_ZERO_USAGE: AssistTokenUsage = {\n  inputTokens: 0,\n  outputTokens: 0,\n  cacheReadTokens: 0,\n  cacheWriteTokens: 0,\n}\n\n/** The job's plan once a member confirmed it; `null` before that, or for a job that never planned. */\nexport function aiConfirmedPlan(job: Pick<AiJob, 'plan'>): AiJobPlan | null {\n  return job.plan?.status === 'confirmed' ? job.plan : null\n}\n\n/** The creation of one kind the plan names; the first when it names several. */\nexport function aiPlanCreation(\n  plan: AiJobPlan | null,\n  kind: AiBuildPlanCreateKind,\n): AiBuildPlanCreate | null {\n  return plan?.create.find((entry) => entry.kind === kind) ?? null\n}\n\n/** A plan reference as the model reads it: the id with the name it was planned under. */\nfunction referenceOf(plan: AiJobPlan, ref: string): string {\n  const label = plan.labels?.[ref]\n  return label ? `${ref} (\"${label}\")` : ref\n}\n\n/** The user turn's opening: the brief, cut at the ceiling every job step keeps. */\nexport function aiJobBriefLine(job: Pick<AiJob, 'brief'>): string {\n  return `Brief: ${job.brief.slice(0, AI_JOB_BRIEF_MAX_CHARS)}`\n}\n\n/** The confirmed plan as reference lines; none when there is no confirmed plan. */\nexport function aiPlanReferenceLines(plan: AiJobPlan | null): string[] {\n  if (!plan) return []\n  const lines = ['Confirmed plan:']\n  for (const entry of plan.reuse) {\n    lines.push(`- reuse the ${entry.kind} ${referenceOf(plan, entry.id)}: ${entry.purpose}`)\n  }\n  for (const entry of plan.create) {\n    const from = entry.duplicateOf ? `, from a copy of ${referenceOf(plan, entry.duplicateOf)}` : ''\n    const fields = entry.fields.length ? ` Fields: ${entry.fields.join(', ')}.` : ''\n    lines.push(`- create the ${entry.kind} \"${entry.name}\"${from}: ${entry.why}${fields}`)\n  }\n  for (const screen of plan.screens) {\n    const sections = screen.sections.map((section) => section.name).join(', ')\n    lines.push(`- the screen \"${screen.title}\" at ${screen.slug}${sections ? `: ${sections}` : ''}`)\n  }\n  return lines.length > 1 ? lines : []\n}\n\n/** The reusable components a tree places, by the id each instance names. */\nexport function aiPlacedComponentIds(tree: Pick<AiValidatedTree, 'rootId' | 'nodes'>): Set<string> {\n  const placed = new Set<string>()\n  const nodes = tree.nodes as unknown as Record<string, AiDoctrineNode>\n  for (const { node } of walkTree({ rootId: tree.rootId, nodes })) {\n    const ref = node.props?.[AI_INSTANCE_REF_PROP]\n    if (node.componentId === REUSABLE_INSTANCE_COMPONENT_ID && typeof ref === 'string') {\n      placed.add(ref)\n    }\n  }\n  return placed\n}\n\n/**\n * Rule 7 on a generated tree: every component the confirmed plan reuses is\n * placed. `noun` names what the tree builds, in the finding.\n */\nexport function aiPlanReuseViolations(\n  inventory: AiSiteInventory | null,\n  plan: AiJobPlan | null,\n  placed: ReadonlySet<string>,\n  noun: string,\n): AiDoctrineViolation[] {\n  const names = new Map((inventory?.components ?? []).map((component) => [component.id, component.name]))\n  const reused = [\n    ...new Set(\n      (plan?.reuse ?? []).filter((entry) => entry.kind === 'component').map((entry) => entry.id),\n    ),\n  ]\n  const missing = reused.filter((id) => !placed.has(id))\n  if (!missing.length) return []\n  const listed = missing.map((id) => `\"${names.get(id) ?? id}\"`).join(', ')\n  return [\n    {\n      rule: 7,\n      code: 'plan-reuse-not-placed',\n      message: `The confirmed plan reuses ${listed}, and the ${noun} does not place ${\n        missing.length === 1 ? 'it' : 'them'\n      }. Place every component the plan reuses.`,\n    },\n  ]\n}\n\n/** What a generation spent, as the step's outcome carries it for the meter. */\nexport function aiGenerationSpent(\n  spend: AiGenerationSpend,\n): Pick<AiJobStepOutcome, 'outputs' | 'usage' | 'estCostUsd' | 'model' | 'stopReason'> {\n  return {\n    outputs: [],\n    usage: spend.usage,\n    estCostUsd: spend.estCostUsd,\n    model: spend.model,\n    stopReason: spend.stopReason,\n  }\n}\n\n/** The most node ids, or plan paths, one finding keeps on its review (AGL-3078). */\nexport const AI_JOB_REVIEW_REFS_MAX = 24\n/** The longest node id or plan path a review keeps, in characters. */\nexport const AI_JOB_REVIEW_REF_MAX_CHARS = 64\n/** How far below a node a finding names its outline goes: the node, its children and theirs. */\nexport const AI_JOB_REVIEW_OUTLINE_MAX_DEPTH = 2\n/** The most nodes a review outlines, across all its findings. */\nexport const AI_JOB_REVIEW_OUTLINE_MAX_NODES = 40\n/** The most names an outlined node lists of its props, of its sx keys, or of its children. */\nexport const AI_JOB_REVIEW_OUTLINE_MAX_NAMES = 16\n/** The most bytes a review's outline takes as JSON, whatever the counts above allow. */\nexport const AI_JOB_REVIEW_OUTLINE_MAX_BYTES = 4_096\n\n/** A Grid's layout props, whose written values an outline keeps. */\nconst AI_JOB_REVIEW_GRID_PROPS = [\n  'container',\n  'size',\n  'offset',\n  'direction',\n  'wrap',\n  'spacing',\n  'rowSpacing',\n  'columnSpacing',\n  'columns',\n] as const\n\n/** A node id or plan path a review keeps: no whitespace, slash or quote, so never copy or an address. */\nconst REVIEW_REF = /^[^\\s/\\\\\"'<>]+$/\n/** An element id an outline names. */\nconst OUTLINE_ELEMENT = /^[\\w.-]{1,64}$/\n/** A prop or sx name an outline lists. */\nconst OUTLINE_NAME = /^[A-Za-z_$][\\w$-]{0,39}$/\n/** The longest layout value an outline keeps as written. */\nconst OUTLINE_VALUE_MAX_CHARS = 40\n/**\n * The words a Grid's layout is written in, besides numbers: breakpoints, span\n * words, switch words, directions and wraps. Nothing else is kept, so no copy is.\n */\nconst OUTLINE_LAYOUT_WORDS = new Set([\n  'xs',\n  'sm',\n  'md',\n  'lg',\n  'xl',\n  'auto',\n  'grow',\n  'true',\n  'false',\n  'yes',\n  'no',\n  'on',\n  'off',\n  'row',\n  'row-reverse',\n  'column',\n  'column-reverse',\n  'wrap',\n  'nowrap',\n  'wrap-reverse',\n])\n/** A number a layout value is written in, with a CSS length unit where it has one. */\nconst OUTLINE_LAYOUT_NUMBER = /^[-+]?(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|%)?$/i\n/** What stands between the words of a layout value, as in `xs:12 md:4` or `{ xs: 12, md: 4 }`. */\nconst OUTLINE_LAYOUT_SEPARATORS = /[\\s,:;=/{}()[\\]\"']+/\n/** A binding token, which a component's Grid may carry for a layout value. */\nconst OUTLINE_BINDING = /^\\{\\{\\s*[\\w.-]+\\s*\\}\\}$/\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\n/** Whether text is a layout value: a binding token, or only layout words and numbers. */\nfunction isLayoutText(value: string): boolean {\n  if (value.length > OUTLINE_VALUE_MAX_CHARS) return false\n  if (OUTLINE_BINDING.test(value.trim())) return true\n  return value\n    .split(OUTLINE_LAYOUT_SEPARATORS)\n    .every((word) => word === '' || OUTLINE_LAYOUT_WORDS.has(word.toLowerCase()) || OUTLINE_LAYOUT_NUMBER.test(word))\n}\n\n/** An id or a path as a review keeps it: cut to its ceiling, and `?` for one it cannot show. */\nfunction reviewRef(ref: string): string {\n  const cut = ref.slice(0, AI_JOB_REVIEW_REF_MAX_CHARS)\n  return REVIEW_REF.test(cut) ? cut : '?'\n}\n\nfunction reviewRefs(refs: readonly string[]): string[] {\n  return refs.slice(0, AI_JOB_REVIEW_REFS_MAX).map(reviewRef)\n}\n\n/** A written layout value as an outline keeps it; text that is no layout value is kept as a marker. */\nfunction outlineValue(value: unknown): string | number | boolean | null {\n  if (value === null) return null\n  if (typeof value === 'boolean') return value\n  if (typeof value === 'number') return Number.isFinite(value) ? value : null\n  if (typeof value === 'string') return isLayoutText(value) ? value : '<text>'\n  return Array.isArray(value) ? '<list>' : '<object>'\n}\n\nfunction childIdsOf(node: Record<string, unknown>): string[] {\n  return Array.isArray(node['nodes']) ? node['nodes'].filter((child): child is string => typeof child === 'string') : []\n}\n\nfunction elementOf(node: unknown): string {\n  const componentId = isRecord(node) ? node['componentId'] : undefined\n  return typeof componentId === 'string' && OUTLINE_ELEMENT.test(componentId) ? componentId : '?'\n}\n\n/** One node of an outline: where it sits, what it is and the names of what it sets, never a copy value. */\nfunction outlineNodeOf(\n  id: string,\n  depth: number,\n  node: Record<string, unknown>,\n  nodes: Readonly<Record<string, unknown>>,\n): AiJobReviewOutlineNode {\n  const props = isRecord(node['props']) ? node['props'] : {}\n  const sx = isRecord(node['sx']) ? node['sx'] : isRecord(props['sx']) ? props['sx'] : {}\n  const names = (keys: string[]) =>\n    keys.filter((key) => OUTLINE_NAME.test(key)).slice(0, AI_JOB_REVIEW_OUTLINE_MAX_NAMES)\n  const componentId = elementOf(node)\n  const grid =\n    componentId === 'muiGrid'\n      ? Object.fromEntries(\n          AI_JOB_REVIEW_GRID_PROPS.filter((name) => props[name] !== undefined).map((name) => [\n            name,\n            outlineValue(props[name]),\n          ]),\n        )\n      : {}\n  const sxNames = names(Object.keys(sx))\n  return {\n    id: reviewRef(id),\n    depth,\n    componentId,\n    props: names(Object.keys(props).filter((key) => key !== 'sx')),\n    ...(sxNames.length ? { sx: sxNames } : {}),\n    ...(Object.keys(grid).length ? { grid } : {}),\n    children: childIdsOf(node)\n      .filter((child) => isRecord(nodes[child]))\n      .slice(0, AI_JOB_REVIEW_OUTLINE_MAX_NAMES)\n      .map((child) => elementOf(nodes[child])),\n  }\n}\n\n/**\n * The parts of a refused answer its findings name, as a review keeps them\n * (AGL-3078): each node a finding names by id, with the nodes below it to\n * `AI_JOB_REVIEW_OUTLINE_MAX_DEPTH`, in document order and each once. A node\n * keeps its id, its element, the names of its props and sx keys and its\n * children's elements, and a Grid the values of its layout props as written;\n * no copy, and no address, is kept. The outline stops at\n * `AI_JOB_REVIEW_OUTLINE_MAX_NODES` nodes or `AI_JOB_REVIEW_OUTLINE_MAX_BYTES`\n * bytes, whichever comes first. An answer that is no node map, and findings\n * that name no node, outline nothing.\n */\nexport function aiDoctrineReviewOutline(\n  answer: Record<string, unknown> | null | undefined,\n  violations: readonly AiDoctrineViolation[],\n): AiJobReviewOutlineNode[] {\n  const outline: AiJobReviewOutlineNode[] = []\n  const tree = answer ? aiAnswerTree(answer) : null\n  const nodes = isRecord(tree) && isRecord(tree['nodes']) ? tree['nodes'] : null\n  if (!nodes) return outline\n  const encoder = new TextEncoder()\n  const seen = new Set<string>()\n  let bytes = 2\n  // False once the outline is full, which ends the walk.\n  const add = (id: string, depth: number): boolean => {\n    const node = nodes[id]\n    if (seen.has(id) || !isRecord(node)) return true\n    seen.add(id)\n    const entry = outlineNodeOf(id, depth, node, nodes)\n    const size = encoder.encode(JSON.stringify(entry)).length + 1\n    if (outline.length === AI_JOB_REVIEW_OUTLINE_MAX_NODES || bytes + size > AI_JOB_REVIEW_OUTLINE_MAX_BYTES) {\n      return false\n    }\n    outline.push(entry)\n    bytes += size\n    return depth === AI_JOB_REVIEW_OUTLINE_MAX_DEPTH || childIdsOf(node).every((child) => add(child, depth + 1))\n  }\n  const named = violations.flatMap((violation) => (violation.nodeIds ?? []).slice(0, AI_JOB_REVIEW_REFS_MAX))\n  for (const id of new Set(named)) {\n    if (!add(id, 0)) break\n  }\n  return outline\n}\n\n/**\n * The review a generation stops its job for when the re-ask still broke a\n * rule: the sentence a person reads, each finding with the nodes or plan\n * entries it names, and an outline of those parts of the answer it was found\n * in (AGL-3078), so why a job stopped can be read back from the job once the\n * answer itself is gone.\n */\nexport function aiDoctrineReview(result: {\n  message: string\n  violations: readonly AiDoctrineViolation[]\n  /** The refused answer, whose nodes the findings name by id; outlined, never kept. */\n  answer?: Record<string, unknown> | null\n}): AiJobReview {\n  const outline = aiDoctrineReviewOutline(result.answer, result.violations)\n  return {\n    reason: 'doctrine',\n    message: result.message,\n    findings: result.violations.map(({ rule, code, message, nodeIds, paths }) => ({\n      rule,\n      code,\n      message,\n      ...(nodeIds?.length ? { nodeIds: reviewRefs(nodeIds) } : {}),\n      ...(paths?.length ? { paths: reviewRefs(paths) } : {}),\n    })),\n    ...(outline.length ? { outline } : {}),\n  }\n}\n\n/** The review a step stops its job for when the site cannot take the draft. */\nexport function aiLimitReview(message: string): AiJobReview {\n  return { reason: 'limit', message, findings: [] }\n}\n\n/**\n * An outcome that reached no model: a draft an earlier run already wrote, a\n * copy the plan asked for, or a person asked before anything was spent.\n */\nexport function aiUnspentOutcome(\n  model: string,\n  rest: { outputs?: AiJobOutput[]; review?: AiJobReview } = {},\n): AiJobStepOutcome {\n  return {\n    outputs: rest.outputs ?? [],\n    usage: AI_JOB_ZERO_USAGE,\n    estCostUsd: 0,\n    model,\n    stopReason: null,\n    ...(rest.review ? { review: rest.review } : {}),\n  }\n}\n\n/** Node ids as the MODEL wrote them, from the minted ids a check reads. */\nexport function aiModelNodeIds(\n  ids: readonly string[],\n  sourceIds: Readonly<Record<string, string>>,\n): string[] {\n  return ids.map((id) => sourceIds[id] ?? id)\n}\n\n/** The most facts a note names before it counts the rest. */\nconst AI_NOTE_MAX_FACTS = 8\n\n/** Facts as a sentence lists them: \"a, b and c\", the ones past the cap counted. */\nfunction factList(facts: readonly string[]): string {\n  const shown = facts.slice(0, AI_NOTE_MAX_FACTS)\n  const items = facts.length > shown.length ? [...shown, `${facts.length - shown.length} more`] : shown\n  return items.length <= 1 ? items.join('') : `${items.slice(0, -1).join(', ')} and ${items[items.length - 1]}`\n}\n\n/**\n * What a draft asks the member to fill in before it is published (AGL-3056),\n * in the words the job's output note shows: the facts in square brackets its\n * copy holds, which the brief did not give (rule 14), each once. A page's\n * placed components show their own defaults wherever the page sets no value\n * of its own, so a component whose defaults hold such facts is named once,\n * however often the page places it. `copy` is what the draft shows beside its\n * tree, such as a component's defaults. `null` when there is nothing to fill.\n */\nexport function aiBracketedFactsNote(input: {\n  tree: AiDoctrineTree\n  inventory: AiSiteInventory | null\n  copy?: readonly string[]\n}): string | null {\n  const components = input.inventory?.components ?? []\n  const componentProps = Object.fromEntries(components.map((component) => [component.id, component.props]))\n  const facts = aiBracketedFacts([\n    ...aiTreeCopy(input.tree, { componentProps }).map((sample) => sample.text),\n    ...(input.copy ?? []),\n  ])\n  const listed = new Set(facts.map((fact) => fact.toLowerCase()))\n  const byComponent = new Map<string, string[]>()\n  for (const { node } of walkTree(input.tree)) {\n    const component = components.find((row) => row.id === node.props?.[AI_INSTANCE_REF_PROP])\n    if (node.componentId !== REUSABLE_INSTANCE_COMPONENT_ID || !component?.bracketedDefaults) continue\n    const values = node.props?.[REUSABLE_INSTANCE_PROP_VALUES_KEY]\n    const set = (name: string): boolean => {\n      const value = values && typeof values === 'object' ? (values as Record<string, unknown>)[name] : undefined\n      return value !== undefined && value !== null && String(value).trim() !== ''\n    }\n    const shown = byComponent.get(component.name) ?? []\n    for (const [name, defaults] of Object.entries(component.bracketedDefaults)) {\n      if (set(name)) continue\n      for (const fact of defaults) {\n        if (!listed.has(fact.toLowerCase()) && !shown.some((known) => known.toLowerCase() === fact.toLowerCase())) {\n          shown.push(fact)\n        }\n      }\n    }\n    if (shown.length) byComponent.set(component.name, shown)\n  }\n  const sentences = [\n    ...(facts.length\n      ? [`Before you publish, replace the facts in square brackets, which the brief did not give: ${factList(facts)}.`]\n      : []),\n    ...[...byComponent.entries()].map(\n      ([name, shown]) =>\n        `The \"${name}\" component on this page shows ${factList(shown)} until you replace ${shown.length === 1 ? 'it' : 'them'}.`,\n    ),\n  ]\n  return sentences.length ? sentences.join(' ') : null\n}\n"],"names":["REUSABLE_INSTANCE_COMPONENT_ID","REUSABLE_INSTANCE_PROP_VALUES_KEY","aiAnswerTree","aiBracketedFacts","aiTreeCopy","walkTree","AI_INSTANCE_REF_PROP","AI_JOB_BRIEF_MAX_CHARS","AI_JOB_ZERO_USAGE","inputTokens","outputTokens","cacheReadTokens","cacheWriteTokens","aiConfirmedPlan","job","plan","status","aiPlanCreation","kind","create","find","entry","referenceOf","ref","label","labels","aiJobBriefLine","brief","slice","aiPlanReferenceLines","lines","reuse","push","id","purpose","from","duplicateOf","fields","length","join","name","why","screen","screens","sections","map","section","title","slug","aiPlacedComponentIds","tree","placed","Set","nodes","node","rootId","props","componentId","add","aiPlanReuseViolations","inventory","noun","names","Map","components","component","reused","filter","missing","has","listed","get","rule","code","message","aiGenerationSpent","spend","outputs","usage","estCostUsd","model","stopReason","AI_JOB_REVIEW_REFS_MAX","AI_JOB_REVIEW_REF_MAX_CHARS","AI_JOB_REVIEW_OUTLINE_MAX_DEPTH","AI_JOB_REVIEW_OUTLINE_MAX_NODES","AI_JOB_REVIEW_OUTLINE_MAX_NAMES","AI_JOB_REVIEW_OUTLINE_MAX_BYTES","AI_JOB_REVIEW_GRID_PROPS","REVIEW_REF","OUTLINE_ELEMENT","OUTLINE_NAME","OUTLINE_VALUE_MAX_CHARS","OUTLINE_LAYOUT_WORDS","OUTLINE_LAYOUT_NUMBER","OUTLINE_LAYOUT_SEPARATORS","OUTLINE_BINDING","isRecord","value","Array","isArray","isLayoutText","test","trim","split","every","word","toLowerCase","reviewRef","cut","reviewRefs","refs","outlineValue","Number","isFinite","childIdsOf","child","elementOf","undefined","outlineNodeOf","depth","sx","keys","key","grid","Object","fromEntries","sxNames","children","aiDoctrineReviewOutline","answer","violations","outline","encoder","TextEncoder","seen","bytes","size","encode","JSON","stringify","named","flatMap","violation","nodeIds","aiDoctrineReview","result","reason","findings","paths","aiLimitReview","aiUnspentOutcome","rest","review","aiModelNodeIds","ids","sourceIds","AI_NOTE_MAX_FACTS","factList","facts","shown","items","aiBracketedFactsNote","input","componentProps","sample","text","copy","fact","byComponent","row","bracketedDefaults","values","set","String","defaults","entries","some","known","sentences"],"mappings":"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"}

package/src/lib/jobs/ai-job-insight-budget.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @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 time an insight step needs (AGL-2915, AGL-3035), declared apart from the
+ * step so the machine and the specs read it without loading the readers.
+ */
+/**
+ * The read call's ceiling: a few reads, each a reader id, a window and its
+ * parameters. It is spent from the same allowance as the answer, so it adds a
+ * wait for a first token and no output of its own to the worst case.
+ */
+export declare const AI_INSIGHT_READ_MAX_TOKENS = 400;
+/**
+ * ASSUMED: how long the readers take between the two calls — up to four
+ * tables, the heaviest a store's two windows of up to 1,000 orders each, or a
+ * dataset's first 2,000 records.
+ */
+export declare const AI_INSIGHT_READS_MS = 8000;
+/**
+ * The step's time: the read call and the answer with its one re-ask, sharing
+ * one allowance of twice the routing table's ceiling, on the tier `job.insight`
+ * is served from, after the readers read. A digest makes no read call and
+ * fits the same time.
+ */
+export declare const AI_JOB_INSIGHT_STEP_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+/** The least time one insight step needs before it starts. */
+export declare const AI_JOB_INSIGHT_STEP_MINIMUM_MS: number;

package/src/lib/jobs/ai-job-insight-budget.js

@@ -0,0 +1,46 @@
+/**
+ * @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 { AI_STEP_TIERS } from "../providers/catalog.js";
+import { AI_ROUTING_TABLE } from "../providers/routing.js";
+import { aiJobStepBudget } from "./ai-job-budget.js";
+/**
+ * The time an insight step needs (AGL-2915, AGL-3035), declared apart from the
+ * step so the machine and the specs read it without loading the readers.
+ */ /**
+ * The read call's ceiling: a few reads, each a reader id, a window and its
+ * parameters. It is spent from the same allowance as the answer, so it adds a
+ * wait for a first token and no output of its own to the worst case.
+ */ export const AI_INSIGHT_READ_MAX_TOKENS = 400;
+/**
+ * ASSUMED: how long the readers take between the two calls — up to four
+ * tables, the heaviest a store's two windows of up to 1,000 orders each, or a
+ * dataset's first 2,000 records.
+ */ export const AI_INSIGHT_READS_MS = 8000;
+/**
+ * The step's time: the read call and the answer with its one re-ask, sharing
+ * one allowance of twice the routing table's ceiling, on the tier `job.insight`
+ * is served from, after the readers read. A digest makes no read call and
+ * fits the same time.
+ */ export const AI_JOB_INSIGHT_STEP_BUDGET = aiJobStepBudget({
+    tier: AI_STEP_TIERS['job.insight'],
+    maxTokens: AI_ROUTING_TABLE['job.insight'].maxTokens,
+    attempts: 2,
+    lookups: 1,
+    ownReadsMs: AI_INSIGHT_READS_MS
+});
+/** The least time one insight step needs before it starts. */ export const AI_JOB_INSIGHT_STEP_MINIMUM_MS = AI_JOB_INSIGHT_STEP_BUDGET.minimumMs;
+
+//# sourceMappingURL=ai-job-insight-budget.js.map

package/src/lib/jobs/ai-job-insight-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-insight-budget.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 { AI_STEP_TIERS } from '../providers/catalog'\nimport { AI_ROUTING_TABLE } from '../providers/routing'\nimport { aiJobStepBudget } from './ai-job-budget'\n\n/**\n * The time an insight step needs (AGL-2915, AGL-3035), declared apart from the\n * step so the machine and the specs read it without loading the readers.\n */\n\n/**\n * The read call's ceiling: a few reads, each a reader id, a window and its\n * parameters. It is spent from the same allowance as the answer, so it adds a\n * wait for a first token and no output of its own to the worst case.\n */\nexport const AI_INSIGHT_READ_MAX_TOKENS = 400\n\n/**\n * ASSUMED: how long the readers take between the two calls — up to four\n * tables, the heaviest a store's two windows of up to 1,000 orders each, or a\n * dataset's first 2,000 records.\n */\nexport const AI_INSIGHT_READS_MS = 8_000\n\n/**\n * The step's time: the read call and the answer with its one re-ask, sharing\n * one allowance of twice the routing table's ceiling, on the tier `job.insight`\n * is served from, after the readers read. A digest makes no read call and\n * fits the same time.\n */\nexport const AI_JOB_INSIGHT_STEP_BUDGET = aiJobStepBudget({\n  tier: AI_STEP_TIERS['job.insight'],\n  maxTokens: AI_ROUTING_TABLE['job.insight'].maxTokens,\n  attempts: 2,\n  lookups: 1,\n  ownReadsMs: AI_INSIGHT_READS_MS,\n})\n\n/** The least time one insight step needs before it starts. */\nexport const AI_JOB_INSIGHT_STEP_MINIMUM_MS = AI_JOB_INSIGHT_STEP_BUDGET.minimumMs\n"],"names":["AI_STEP_TIERS","AI_ROUTING_TABLE","aiJobStepBudget","AI_INSIGHT_READ_MAX_TOKENS","AI_INSIGHT_READS_MS","AI_JOB_INSIGHT_STEP_BUDGET","tier","maxTokens","attempts","lookups","ownReadsMs","AI_JOB_INSIGHT_STEP_MINIMUM_MS","minimumMs"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,aAAa,QAAQ,0BAAsB;AACpD,SAASC,gBAAgB,QAAQ,0BAAsB;AACvD,SAASC,eAAe,QAAQ,qBAAiB;AAEjD;;;CAGC,GAED;;;;CAIC,GACD,OAAO,MAAMC,6BAA6B,IAAG;AAE7C;;;;CAIC,GACD,OAAO,MAAMC,sBAAsB,KAAK;AAExC;;;;;CAKC,GACD,OAAO,MAAMC,6BAA6BH,gBAAgB;IACxDI,MAAMN,aAAa,CAAC,cAAc;IAClCO,WAAWN,gBAAgB,CAAC,cAAc,CAACM,SAAS;IACpDC,UAAU;IACVC,SAAS;IACTC,YAAYN;AACd,GAAE;AAEF,4DAA4D,GAC5D,OAAO,MAAMO,iCAAiCN,2BAA2BO,SAAS,CAAA"}

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

@@ -0,0 +1,58 @@
+/**
+ * @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 { ResolvedPluginFigureReader } from '@aglyn/aglyn/plugin-manager/plugin-figures';
+import { type AiInsightTable } from '../model/ai-insight';
+import { type AiSystemBlock } from '../runtime/ai-runtime';
+import { type AiInsightCheck } from '../runtime/ai-insight-check';
+import { type AiJobAdmissionContext, type AiJobAdmissionRefusal } from './ai-job-admission';
+import type { AiJobStepRunner } from './ai-job-text-step';
+export declare const AI_INSIGHT_NO_SURFACE_COPY = "This question does not say which page it was asked from.";
+export declare const AI_INSIGHT_NO_SITE_COPY = "Open the site whose numbers you are asking about.";
+export declare const AI_INSIGHT_NO_READERS_COPY = "There are no figures to answer from here yet: the features this page reports on are not on for this workspace.";
+export declare const AI_INSIGHT_NO_TABLES_COPY = "The figures could not be read. Try again in a moment.";
+export declare const AI_INSIGHT_UNREADABLE_COPY = "The AI did not answer with insights. Try asking in different words.";
+/** The digest's question: what a week's insights cover, in the order a person reads them. */
+export declare const AI_INSIGHT_DIGEST_QUESTION = "What changed on this site this week? Write the week\u2019s insights: the change in traffic, the most viewed page, the form that turned the most views into submissions, a campaign that did better than the rest, and any day that stood out \u2014 only those the tables support.";
+/** The rules both calls are sent: static, byte-identical for every workspace. */
+export declare const AI_INSIGHT_RULES: string;
+/** The system blocks both calls send: the rules and the platform's acceptable-use rules. */
+export declare const AI_JOB_INSIGHT_SYSTEM: AiSystemBlock[];
+/** The read call's user turn: the question, the window asked for, the readers and, for datasets, the datasets. */
+export declare function aiInsightReadPrompt(input: {
+    question: string;
+    days: number;
+    readers: readonly ResolvedPluginFigureReader[];
+    datasets: string | null;
+}): string;
+/** The answer call's user turn: the question and every table. */
+export declare function aiInsightAnswerPrompt(question: string, tables: readonly AiInsightTable[]): string;
+/** What a re-ask tells the model: why nothing it wrote could be kept. */
+export declare function aiInsightReaskMessage(check: AiInsightCheck | null): string;
+export declare const runAiJobInsightStep: AiJobStepRunner;
+/**
+ * Whether a question may be asked here: a surface a person asks from, a site
+ * of the job's own org where the surface needs one, and at least one reader
+ * the workspace may read. A digest is made by the weekly sweep and never at a
+ * door.
+ */
+export declare function aiInsightAdmissionRefusal(context: AiJobAdmissionContext): Promise<AiJobAdmissionRefusal | null>;
+/**
+ * The insight kind's registrations, called by the console surface
+ * (`registerAiJobKinds` in `server.ts`), never made by importing this module
+ * (AGL-3025).
+ */
+export declare function registerAiInsightJob(): void;

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

@@ -0,0 +1,350 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { AI_INSIGHT_ASK_SURFACES, AI_INSIGHT_DIGEST_DAYS, AI_INSIGHT_DIGEST_READERS, AI_INSIGHT_QUESTION_MAX_CHARS, AI_INSIGHTS_COLLECTION, aiInsightDays, aiInsightOutput, aiInsightSurface, aiInsightSurfaceNeedsSite } from "../model/ai-insight.js";
+import { AI_ROUTING_TABLE, aiModelForStep } from "../providers/routing.js";
+import { AI_ACCEPTABLE_USE_BLOCK, runAiRequest } from "../runtime/ai-runtime.js";
+import { AI_GENERATION_MAX_ATTEMPTS } from "../runtime/ai-generation-bounds.js";
+import { checkAiInsightAnswer } from "../runtime/ai-insight-check.js";
+import { AI_INSIGHT_ANSWER_TOOL_NAME, AI_INSIGHT_READ_TOOL_NAME, aiInsightAnswerTool, aiInsightReadTool, parseAiInsightAnswer, parseAiInsightReads } from "../tools/ai-insight-tool.js";
+import { aiDatasetCatalog } from "../insights/ai-figure-readers.js";
+import { aiInsightDatasetCatalog, aiInsightReaderCatalog, aiInsightReaderDays, aiInsightReaders, aiInsightTableText, readAiInsightTables } from "../insights/ai-insight-readers.js";
+import { assistExchangeExpiry } from "../usage/assist-usage.js";
+import { registerAiJobAdmission } from "./ai-job-admission.js";
+import { AI_INSIGHT_READ_MAX_TOKENS, AI_JOB_INSIGHT_STEP_BUDGET, AI_JOB_INSIGHT_STEP_MINIMUM_MS } from "./ai-job-insight-budget.js";
+import { registerAiJobStep } from "./ai-jobs.js";
+export const AI_INSIGHT_NO_SURFACE_COPY = 'This question does not say which page it was asked from.';
+export const AI_INSIGHT_NO_SITE_COPY = 'Open the site whose numbers you are asking about.';
+export const AI_INSIGHT_NO_READERS_COPY = 'There are no figures to answer from here yet: the features this page reports on are not on for this workspace.';
+export const AI_INSIGHT_NO_TABLES_COPY = 'The figures could not be read. Try again in a moment.';
+export const AI_INSIGHT_UNREADABLE_COPY = 'The AI did not answer with insights. Try asking in different words.';
+/** The digest's question: what a week's insights cover, in the order a person reads them. */ export const AI_INSIGHT_DIGEST_QUESTION = 'What changed on this site this week? Write the week’s insights: the change in traffic, the most viewed page, the form that turned the most views into submissions, a campaign that did better than the rest, and any day that stood out — only those the tables support.';
+/** The rules both calls are sent: static, byte-identical for every workspace. */ export const AI_INSIGHT_RULES = [
+    'You answer a workspace owner’s questions about their own figures: page views, orders, bookings, forms, campaigns, A/B tests and datasets. You never see a record, and you never write a query: code reads figures through fixed readers and gives you their tables.',
+    '',
+    `When you are given a question and a list of readers, call ${AI_INSIGHT_READ_TOOL_NAME} once with the readers whose tables answer it, most useful first, and the window each should cover. Choose only readers from the list, with their parameters' values taken from what the list and the question give you.`,
+    '',
+    `When you are given tables, call ${AI_INSIGHT_ANSWER_TOOL_NAME} once. Each table has a handle (t1, t2, …) and numbered rows. Rules for the insights:`,
+    '- Say what matters most to the question first. Leave out what the tables do not support.',
+    '- Every insight cites the table and the rows its figures come from.',
+    '- Every number you write appears in a row you cite, as the table shows it or rounded. Never add, subtract, average or otherwise compute a figure yourself. The only other numbers you may write are the length of a table’s window, a date in it, and how many rows you cite.',
+    '- Say a figure rose or fell only when a change you quote shows it.',
+    '- Name nobody, and write no email address or phone number.',
+    '- Plain sentences: no markdown, no headings, no lists.',
+    '- When the tables cannot answer part of the question, say so in gap in one sentence with no numbers; otherwise gap is null.',
+    '- Write in the language of the question.'
+].join('\n');
+/** The system blocks both calls send: the rules and the platform's acceptable-use rules. */ export const AI_JOB_INSIGHT_SYSTEM = [
+    {
+        text: `${AI_INSIGHT_RULES}\n\n${AI_ACCEPTABLE_USE_BLOCK}`,
+        cacheBreakpoint: true
+    }
+];
+const ZERO_USAGE = {
+    inputTokens: 0,
+    outputTokens: 0,
+    cacheReadTokens: 0,
+    cacheWriteTokens: 0
+};
+const str = (value)=>typeof value === 'string' ? value.trim() : '';
+/** What the step's calls have spent so far, in the outcome's shape. */ let InsightSpend = class InsightSpend {
+    add(result) {
+        this.usage = {
+            inputTokens: this.usage.inputTokens + result.usage.inputTokens,
+            outputTokens: this.usage.outputTokens + result.usage.outputTokens,
+            cacheReadTokens: this.usage.cacheReadTokens + result.usage.cacheReadTokens,
+            cacheWriteTokens: this.usage.cacheWriteTokens + result.usage.cacheWriteTokens
+        };
+        this.estCostUsd = Math.round((this.estCostUsd + result.estCostUsd) * 1000000) / 1000000;
+        this.stopReason = result.stopReason;
+    }
+    outcome() {
+        return {
+            usage: this.usage,
+            estCostUsd: this.estCostUsd,
+            model: this.model,
+            stopReason: this.stopReason,
+            effort: null
+        };
+    }
+    constructor(model){
+        this.model = model;
+        this.usage = _extends({}, ZERO_USAGE);
+        this.estCostUsd = 0;
+        this.stopReason = null;
+    }
+};
+/** The read call's user turn: the question, the window asked for, the readers and, for datasets, the datasets. */ export function aiInsightReadPrompt(input) {
+    return [
+        `Question: ${input.question}`,
+        `The window picked on the page: ${input.days} days. Use it unless the question names another window a reader lists.`,
+        'Readers you may read here:',
+        aiInsightReaderCatalog(input.readers),
+        ...input.datasets === null ? [] : [
+            '',
+            'Datasets you may read, with their fields:',
+            input.datasets
+        ]
+    ].join('\n');
+}
+/** The answer call's user turn: the question and every table. */ export function aiInsightAnswerPrompt(question, tables) {
+    return [
+        `Question: ${question}`,
+        '',
+        'Tables:',
+        '',
+        tables.map(aiInsightTableText).join('\n\n')
+    ].join('\n');
+}
+/** What a re-ask tells the model: why nothing it wrote could be kept. */ export function aiInsightReaskMessage(check) {
+    const reasons = (check == null ? void 0 : check.findings.length) ? `None of those insights could be kept: ${[
+        ...new Set(check.findings)
+    ].slice(0, 8).join('; ')}.` : `That answer did not come through ${AI_INSIGHT_ANSWER_TOOL_NAME}.`;
+    return `${reasons} Answer again with ${AI_INSIGHT_ANSWER_TOOL_NAME}: cite the rows each insight's figures are in, and write every number as a row you cite shows it.`;
+}
+/** The reads a surface falls back to when the model named none it may read: the digest's own readers. */ function defaultReads(readers, days) {
+    const ids = readers.map(({ reader })=>reader.id);
+    const preferred = AI_INSIGHT_DIGEST_READERS.filter((id)=>ids.includes(id));
+    const chosen = preferred.length ? preferred : ids;
+    return chosen.map((id)=>{
+        var _ref;
+        var _readers_find;
+        return {
+            reader: id,
+            days: aiInsightReaderDays((_ref = (_readers_find = readers.find(({ reader })=>reader.id === id)) == null ? void 0 : _readers_find.reader.windows) != null ? _ref : [], days),
+            params: {}
+        };
+    });
+}
+async function readHost(firestore, orgId, hostId) {
+    var _snapshot_data;
+    if (!hostId) return {
+        host: null,
+        ok: true
+    };
+    const snapshot = await firestore.collection('hosts').doc(hostId).get();
+    const host = snapshot.exists ? (_snapshot_data = snapshot.data()) != null ? _snapshot_data : {} : null;
+    return {
+        host,
+        ok: Boolean(host) && (host == null ? void 0 : host['orgId']) === orgId
+    };
+}
+export const runAiJobInsightStep = async (context)=>{
+    var _ref, _job_hostId, _context_org, _job_expiresAt;
+    var _job_inputs, _job_inputs1, _site_host;
+    const { job, firestore, signal, now } = context;
+    const model = (_ref = context.modelFor == null ? void 0 : context.modelFor.call(context, 'job.insight')) != null ? _ref : aiModelForStep('job.insight');
+    const spend = new InsightSpend(model);
+    const stop = (failure)=>_extends({
+            outputs: []
+        }, spend.outcome(), {
+            failure
+        });
+    const surface = aiInsightSurface(job.inputs);
+    if (!surface) return stop(AI_INSIGHT_NO_SURFACE_COPY);
+    const hostId = (_job_hostId = job.hostId) != null ? _job_hostId : null;
+    if (aiInsightSurfaceNeedsSite(surface) && !hostId) return stop(AI_INSIGHT_NO_SITE_COPY);
+    // The door checks the caller belongs to the org; that the site does is
+    // checked here, before anything about it is read.
+    const site = await readHost(firestore, job.orgId, hostId);
+    if (!site.ok) return stop(AI_INSIGHT_NO_SITE_COPY);
+    const readers = await aiInsightReaders({
+        orgId: job.orgId,
+        hostId,
+        org: (_context_org = context.org) != null ? _context_org : null,
+        host: site.host,
+        surface
+    });
+    if (!readers.length) return stop(AI_INSIGHT_NO_READERS_COPY);
+    const digest = surface === 'digest';
+    const days = digest ? AI_INSIGHT_DIGEST_DAYS : aiInsightDays((_job_inputs = job.inputs) == null ? void 0 : _job_inputs['days']);
+    const question = digest ? AI_INSIGHT_DIGEST_QUESTION : job.brief.slice(0, AI_INSIGHT_QUESTION_MAX_CHARS);
+    const maxTokens = AI_JOB_INSIGHT_STEP_BUDGET.maxTokens(model);
+    const allowance = AI_GENERATION_MAX_ATTEMPTS * maxTokens;
+    const left = ()=>allowance - spend.usage.outputTokens;
+    const ask = (messages, tool, ceiling)=>runAiRequest(_extends({
+            model,
+            system: AI_JOB_INSIGHT_SYSTEM,
+            messages,
+            tools: [
+                tool === 'read' ? aiInsightReadTool() : aiInsightAnswerTool()
+            ],
+            maxTokens: Math.max(1, Math.min(ceiling, left()))
+        }, AI_ROUTING_TABLE['job.insight'].thinking ? {
+            thinking: AI_ROUTING_TABLE['job.insight'].thinking
+        } : {}, {
+            stream: false
+        }, signal ? {
+            signal
+        } : {}));
+    // 1. The reads.
+    const base = {
+        orgId: job.orgId,
+        hostId,
+        uid: digest ? null : job.createdBy,
+        now
+    };
+    let requests;
+    if (digest) {
+        requests = defaultReads(readers, days);
+    } else {
+        var _result_toolUse_find;
+        const datasets = surface === 'datasets' ? aiInsightDatasetCatalog(await aiDatasetCatalog(firestore, {
+            orgId: job.orgId,
+            hostId,
+            uid: job.createdBy
+        })) : null;
+        const result = await ask([
+            {
+                role: 'user',
+                content: aiInsightReadPrompt({
+                    question,
+                    days,
+                    readers,
+                    datasets
+                })
+            }
+        ], 'read', AI_INSIGHT_READ_MAX_TOKENS);
+        spend.add(result);
+        if (result.kind === 'refusal') return _extends({
+            outputs: []
+        }, spend.outcome(), {
+            refused: true
+        });
+        requests = parseAiInsightReads((_result_toolUse_find = result.toolUse.find((use)=>use.name === AI_INSIGHT_READ_TOOL_NAME)) == null ? void 0 : _result_toolUse_find.input);
+    }
+    const maxTables = digest ? AI_INSIGHT_DIGEST_READERS.length : undefined;
+    let read = await readAiInsightTables(readers, requests, base, maxTables);
+    if (!read.tables.length && !digest) read = await readAiInsightTables(readers, defaultReads(readers, days), base);
+    if (read.refusals.length) console.warn('ai insight reads refused', {
+        jobId: job.$id,
+        refusals: read.refusals
+    });
+    if (!read.tables.length) return stop(AI_INSIGHT_NO_TABLES_COPY);
+    const { tables } = read;
+    // 2. The answer, and at most one re-ask.
+    let messages = [
+        {
+            role: 'user',
+            content: aiInsightAnswerPrompt(question, tables)
+        }
+    ];
+    let checked = null;
+    for(let attempt = 0; attempt < AI_GENERATION_MAX_ATTEMPTS && left() > 0; attempt += 1){
+        var _result_toolUse_find1;
+        const result = await ask(messages, 'answer', maxTokens);
+        spend.add(result);
+        if (result.kind === 'refusal') return _extends({
+            outputs: []
+        }, spend.outcome(), {
+            refused: true
+        });
+        const answer = parseAiInsightAnswer((_result_toolUse_find1 = result.toolUse.find((use)=>use.name === AI_INSIGHT_ANSWER_TOOL_NAME)) == null ? void 0 : _result_toolUse_find1.input);
+        const check = answer ? checkAiInsightAnswer(answer, tables) : null;
+        if (check) checked = check;
+        if (check && (check.kept.length || !(answer == null ? void 0 : answer.insights.length))) break;
+        messages = [
+            ...messages,
+            {
+                role: 'assistant',
+                content: `Answered with ${AI_INSIGHT_ANSWER_TOOL_NAME}.`
+            },
+            {
+                role: 'user',
+                content: aiInsightReaskMessage(check)
+            }
+        ];
+    }
+    if (!checked) return stop(AI_INSIGHT_UNREADABLE_COPY);
+    const record = {
+        jobId: job.$id,
+        orgId: job.orgId,
+        hostId,
+        surface,
+        createdBy: job.createdBy,
+        question: digest ? str(job.brief) || 'Weekly insights' : question,
+        days,
+        insights: checked.kept,
+        gap: checked.gap,
+        tables,
+        left: checked.left.length,
+        week: digest ? str((_job_inputs1 = job.inputs) == null ? void 0 : _job_inputs1['week']) || null : null,
+        createdAtMs: now.getTime()
+    };
+    if (checked.left.length) {
+        console.info('ai insight left out untraced insights', {
+            jobId: job.$id,
+            findings: checked.findings
+        });
+    }
+    // Keyed by the job, so a step run again replaces its own answer.
+    await firestore.collection('orgs').doc(job.orgId).collection(AI_INSIGHTS_COLLECTION).doc(job.$id).set(_extends({}, JSON.parse(JSON.stringify(record)), {
+        expiresAt: (_job_expiresAt = job.expiresAt) != null ? _job_expiresAt : assistExchangeExpiry(now)
+    }));
+    return _extends({
+        outputs: [
+            aiInsightOutput(job, record, str((_site_host = site.host) == null ? void 0 : _site_host['subdomain']) || null)
+        ]
+    }, spend.outcome());
+};
+/**
+ * Whether a question may be asked here: a surface a person asks from, a site
+ * of the job's own org where the surface needs one, and at least one reader
+ * the workspace may read. A digest is made by the weekly sweep and never at a
+ * door.
+ */ export async function aiInsightAdmissionRefusal(context) {
+    const surface = aiInsightSurface(context.inputs);
+    if (!surface || !AI_INSIGHT_ASK_SURFACES.includes(surface)) {
+        return {
+            status: 400,
+            error: 'Ask about your numbers from a site’s Analytics, Data or CRM Reports page.'
+        };
+    }
+    if (aiInsightSurfaceNeedsSite(surface) && !context.hostId) {
+        return {
+            status: 400,
+            error: AI_INSIGHT_NO_SITE_COPY
+        };
+    }
+    const site = await readHost(context.firestore, context.orgId, context.hostId);
+    if (!site.ok) return {
+        status: 404,
+        error: 'Unknown site'
+    };
+    const readers = await aiInsightReaders({
+        orgId: context.orgId,
+        hostId: context.hostId,
+        org: context.org,
+        host: site.host,
+        surface
+    });
+    return readers.length ? null : {
+        status: 403,
+        error: AI_INSIGHT_NO_READERS_COPY
+    };
+}
+/**
+ * The insight kind's registrations, called by the console surface
+ * (`registerAiJobKinds` in `server.ts`), never made by importing this module
+ * (AGL-3025).
+ */ export function registerAiInsightJob() {
+    registerAiJobStep('insight', runAiJobInsightStep, {
+        minimumMs: AI_JOB_INSIGHT_STEP_MINIMUM_MS
+    });
+    registerAiJobAdmission('insight', aiInsightAdmissionRefusal);
+}
+
+//# sourceMappingURL=ai-job-insight-step.js.map