@trinityui/design-system 2.11.1 → 2.13.1

package/dist/components/AI/types/hitl.d.ts

@@ -0,0 +1,2294 @@
+/**
+ * Human-in-the-loop (HITL) contract types (master plan F-02, ADR-16 (4)).
+ *
+ * The data an AI backend sends to the HITL components, and the content-free interaction
+ * payloads the components report back. Every data type here is plain JSON: strings, numbers,
+ * booleans, arrays and objects. No functions, no Date objects and no ReactNode. A component
+ * that lets you replace rendered content does that through its own props, never through this
+ * data. The one non-data type is `AIStrings`, the strings catalog that `AIConfigProvider`
+ * overrides: its count strings are functions (ADR-06 (8)).
+ *
+ * Contract rules:
+ *
+ * 1. Confidence is a number from 0 to 1. 0.92 means 92%. Convert 0-100 data once, at the
+ *    boundary, with `normalizeConfidence(value, 'percent')`.
+ * 2. Timestamps are ISO 8601 strings, for example '2026-10-06T09:30:00Z'. Components format
+ *    them for display; the data never carries display text for a date.
+ * 3. Ids are stable strings. The same id names the same item across renders, reloads and
+ *    sessions, so components can key, restore and report on it.
+ * 4. Unions are open. A minor release may add a member to any union here, and never removes
+ *    one outside a major release. Give every switch over these unions a default branch.
+ * 5. Every new field is optional. A field added after a type ships is optional, so older
+ *    payloads keep type-checking.
+ *
+ * Plans and revisions (G-02): replanning keeps `AIPlan.id` and increments `AIPlan.revision`
+ * (1 for the first proposal, and a missing revision reads as 1). A plan with a new `id` is a
+ * different plan. So a client keeps per-plan history, such as which steps the user edited, by
+ * `id`, and starts a fresh draft for each `(id, revision)`.
+ *
+ * Low-confidence plan steps (G-43+): a step whose `confidence` is below the medium threshold
+ * (`AIConfidenceThresholds.medium`) must carry `clarification: { reason: 'low-confidence', ... }`,
+ * so the user is asked about the step before the plan runs. Confidence alone never blocks the
+ * confirm (that would leave the user nothing to do); AIPlanReview warns in development, naming the
+ * step id, when a below-threshold step has no clarification.
+ *
+ * Ownership: Workstream E owns this file (ADR-28 hot file `hot-file:hitl-types`, OD-F17).
+ * Workstreams F, G and H add their types to it through serialized changes.
+ *
+ * @module components/AI/types/hitl
+ */
+import type { AIResponse, AIResponseSource } from './response';
+/**
+ * Confidence band of a value from 0 to 1, computed against {@link AIConfidenceThresholds}.
+ *
+ * Open union (contract rule 4): handle a default branch.
+ *
+ * @since 2.13.0
+ */
+export type AIConfidenceLevel = 'low' | 'medium' | 'high';
+/**
+ * Where the confidence bands start. Both values are on the 0-1 scale, and
+ * `0 <= medium <= high <= 1`. A value below `medium` is `'low'`.
+ *
+ * The defaults are `DEFAULT_AI_CONFIDENCE_THRESHOLDS` ({ medium: 0.6, high: 0.85 }), placeholders
+ * owned by product.
+ *
+ * @since 2.13.0
+ */
+export interface AIConfidenceThresholds {
+    /** Lowest value rated `'medium'`, inclusive. 0-1. */
+    medium: number;
+    /** Lowest value rated `'high'`, inclusive. 0-1. */
+    high: number;
+}
+/**
+ * Review state of an answer.
+ *
+ * - `'verified'`: a person checked this answer.
+ * - `'golden'`: the answer matches a curated reference answer.
+ * - `'pending-review'`: queued for review, not checked yet.
+ * - `'flagged'`: someone reported a problem with it.
+ * - `'rejected'`: a reviewer marked it wrong.
+ *
+ * Answer states only. A plan state such as `'confirmed-plan'` is not assignable here; use
+ * {@link AIVerificationStatus} where both apply.
+ *
+ * Open union (contract rule 4): handle a default branch.
+ *
+ * @since 2.13.0
+ */
+export type AIAnswerVerificationStatus = 'verified' | 'golden' | 'pending-review' | 'flagged' | 'rejected';
+/**
+ * Review state of an answer or a plan: every {@link AIAnswerVerificationStatus}, plus
+ * `'confirmed-plan'`, which means a person confirmed the plan before it ran.
+ *
+ * Open union (contract rule 4): handle a default branch.
+ *
+ * @since 2.13.0
+ */
+export type AIVerificationStatus = AIAnswerVerificationStatus | 'confirmed-plan';
+/**
+ * Comparison in an {@link AIPlanFilter}.
+ *
+ * `'in'` and `'not-in'` take an array value. `'between'` takes a two-item array
+ * `[min, max]`, both ends inclusive. The others take a single value.
+ *
+ * Open union (contract rule 4): handle a default branch.
+ *
+ * @since 2.13.0
+ */
+export type AIFilterOperator = 'eq' | 'neq' | 'in' | 'not-in' | 'gt' | 'gte' | 'lt' | 'lte' | 'between' | 'contains';
+/**
+ * One filter the AI applied to the data, shared by response sources and plan steps.
+ *
+ * @example
+ * ```ts
+ * const region: AIPlanFilter = { field: 'region', operator: 'eq', value: 'EMEA', label: 'Region: EMEA' };
+ * const quarter: AIPlanFilter = { field: 'month', operator: 'between', value: ['2026-04', '2026-06'] };
+ * ```
+ *
+ * @since 2.13.0
+ */
+export interface AIPlanFilter {
+    /** Name of the filtered field, as the backend knows it. */
+    field: string;
+    /** How `field` compares with `value`. When omitted, read it as `'eq'`, or `'in'` for an array value. */
+    operator?: AIFilterOperator;
+    /** The value or values compared. An array for `'in'`, `'not-in'` and `'between'` (`[min, max]`). */
+    value: string | number | boolean | Array<string | number>;
+    /** Display text for the whole filter, for example 'Region: EMEA'. Shown instead of the raw field and value. */
+    label?: string;
+}
+/**
+ * Why the AI asks a clarifying question.
+ *
+ * - `'ambiguous-term'`: a term in the question has more than one meaning.
+ * - `'missing-value'`: the question needs a value it did not give (a date range, a region).
+ * - `'low-confidence'`: the AI could answer, but not confidently.
+ * - `'no-sources'`: no data source covers the question.
+ * - `'unfamiliar-term'`: a term in the question is unknown.
+ *
+ * Open union (contract rule 4): handle a default branch.
+ *
+ * @since 2.13.0
+ */
+export type AIClarificationReason = 'ambiguous-term' | 'missing-value' | 'low-confidence' | 'no-sources' | 'unfamiliar-term';
+/**
+ * One answer the user can pick in an {@link AIClarification}.
+ *
+ * @since 2.13.0
+ */
+export interface AIClarificationOption {
+    /** Stable id, reported in {@link AIClarificationAnswer.optionIds}. */
+    id: string;
+    /** Text of the option. */
+    label: string;
+    /** Longer explanation shown with the option. */
+    description?: string;
+    /** How likely the AI rates this option. 0-1. */
+    confidence?: number;
+}
+/**
+ * The user's answer to an {@link AIClarification}.
+ *
+ * @since 2.13.0
+ */
+export interface AIClarificationAnswer {
+    /** Ids of the chosen options, in the order chosen. Empty when the user only typed other text. */
+    optionIds: string[];
+    /** Free text the user typed instead of, or with, an option. Only when the clarification allows it. */
+    otherText?: string;
+}
+/**
+ * A clarifying question the AI asks before or instead of answering.
+ *
+ * `answer` is present when the question is already resolved, so a reloaded thread renders it
+ * resolved instead of asking again.
+ *
+ * @example
+ * ```ts
+ * const clarification: AIClarification = {
+ *   reason: 'ambiguous-term',
+ *   term: 'revenue',
+ *   question: 'Which revenue do you mean?',
+ *   options: [
+ *     { id: 'gross', label: 'Gross revenue' },
+ *     { id: 'net', label: 'Net revenue', confidence: 0.7 },
+ *   ],
+ * };
+ * ```
+ *
+ * @since 2.13.0
+ */
+export interface AIClarification {
+    /** Why the AI asks. */
+    reason: AIClarificationReason;
+    /** The term the question is about, as the user wrote it. */
+    term?: string;
+    /** The question shown to the user. */
+    question?: string;
+    /** Answers the user can pick. */
+    options?: AIClarificationOption[];
+    /** Whether the user picks one option or several. Default `'single'`. */
+    selectionMode?: 'single' | 'multiple';
+    /** Whether the user may type their own answer. Default `false`. */
+    allowOther?: boolean;
+    /** The recorded answer, when the question is already resolved. */
+    answer?: AIClarificationAnswer;
+}
+/**
+ * Thumbs up or down on a response.
+ *
+ * Open union (contract rule 4): handle a default branch.
+ *
+ * @since 2.13.0
+ */
+export type AIFeedbackRating = 'positive' | 'negative';
+/**
+ * Why a response was rated, usually after a negative rating. The listed ids are the built-in
+ * categories; any other string is a product-defined category.
+ *
+ * - `'wrong-number'`: a figure in the answer is wrong.
+ * - `'wrong-interpretation'`: the AI misread the question.
+ * - `'synthetic'`: the answer looks made up.
+ * - `'sources'`: the sources are wrong or missing.
+ * - `'outdated-data'`: the data is stale.
+ * - `'formatting'`: the answer is hard to read.
+ * - `'other'`: anything else.
+ *
+ * @since 2.13.0
+ */
+export type AIFeedbackCategory = 'wrong-number' | 'wrong-interpretation' | 'synthetic' | 'sources' | 'outdated-data' | 'formatting' | 'other' | (string & {});
+/**
+ * A feedback category offered to the user. A built-in id takes its text from the AI strings
+ * when `label` is omitted.
+ *
+ * @since 2.13.0
+ */
+export interface AIFeedbackCategoryOption {
+    /** Stable id: a built-in category or a product-defined one. */
+    id: AIFeedbackCategory;
+    /** Text of the option. */
+    label?: string;
+    /** Longer explanation shown with the option. */
+    description?: string;
+}
+/**
+ * The feedback form's state while the user fills it in.
+ *
+ * @since 2.13.0
+ */
+export interface AIFeedbackDraft {
+    /** Chosen category ids. */
+    categories: AIFeedbackCategory[];
+    /** Comment text; an empty string when the user wrote nothing. */
+    comment: string;
+    /** Whether the user asked for the question to run again. */
+    rerun: boolean;
+}
+/**
+ * Submitted feedback on a response, as the application receives it.
+ *
+ * @since 2.13.0
+ */
+export interface AIFeedbackEvent {
+    /** Id of the rated response. */
+    responseId?: string;
+    /** The rating. */
+    rating: AIFeedbackRating;
+    /** Chosen category ids; empty when none were chosen. */
+    categories: AIFeedbackCategory[];
+    /** Comment text, when the user wrote one. */
+    comment?: string;
+    /** Whether the user asked for the question to run again. */
+    rerun: boolean;
+}
+/**
+ * Facts about the query that produced a response.
+ *
+ * @since 2.13.0
+ */
+export interface AIQueryMetadata {
+    /** Stable id of the query. A response source with the same `queryId` points at this query. */
+    queryId?: string;
+    /** Rows the query returned. A whole number. */
+    rowCount?: number;
+    /** How long the query ran, in milliseconds. */
+    durationMs?: number;
+    /** Name of the dataset the query read. */
+    dataset?: string;
+    /** Query language, for example 'sql' or 'kql'. */
+    dialect?: string;
+    /** When the query ran. ISO 8601 date-time. */
+    executedAt?: string;
+}
+/**
+ * A query the AI ran or will run. The one query shape: a query block and a review item's
+ * `query` both use it.
+ *
+ * @example
+ * ```ts
+ * const query: AIQuery = {
+ *   query: 'SELECT region, SUM(net) FROM revenue GROUP BY region',
+ *   language: 'sql',
+ *   metadata: { queryId: 'q-42', rowCount: 4, durationMs: 845 },
+ * };
+ * ```
+ *
+ * @since 2.13.0
+ */
+export interface AIQuery {
+    /** The query text, as it ran. */
+    query: string;
+    /** Query language, for example 'sql' or 'kql'. */
+    language?: string;
+    /** Facts about the run. */
+    metadata?: AIQueryMetadata;
+}
+/**
+ * State of one plan step while the user reviews the plan.
+ *
+ * - `'ready'`: the step can run as written.
+ * - `'needs-input'`: the step waits for an answer to its clarification.
+ * - `'edited'`: the user changed the step.
+ * - `'replanning'`: the AI is rewriting the step after an edit.
+ *
+ * Open union (contract rule 4): handle a default branch.
+ *
+ * @since 2.13.0
+ */
+export type AIPlanStepStatus = 'ready' | 'needs-input' | 'edited' | 'replanning';
+/**
+ * One step of an {@link AIPlan}: what the AI will look up, and how.
+ *
+ * @since 2.13.0
+ */
+export interface AIPlanStep {
+    /** Stable id. It stays the same across revisions of the plan while the step exists. */
+    id: string;
+    /** What the step does, in words. */
+    text: string;
+    /** The measure the step reads, for example 'Net revenue'. Display text. */
+    metric?: string;
+    /** The field the step reads, as the backend knows it. */
+    field?: string;
+    /** Filters the step applies, in order. */
+    filters?: AIPlanFilter[];
+    /** The period the step covers, for example 'Q2 2026'. Display text. */
+    period?: string;
+    /** How confident the AI is in this step. 0-1. */
+    confidence?: number;
+    /** Why the AI has that confidence. Plain text. */
+    confidenceRationale?: string;
+    /** A question the user must answer before the step can run. */
+    clarification?: AIClarification;
+    /** Whether the user may edit the step. Default `false`. */
+    editable?: boolean;
+    /** The step's review state. Default `'ready'`. */
+    status?: AIPlanStepStatus;
+}
+/**
+ * State of a whole plan.
+ *
+ * - `'review'`: waiting for the user to confirm, edit or cancel.
+ * - `'replanning'`: the AI is writing the next revision.
+ * - `'confirmed'`: the user confirmed it; it has not started.
+ * - `'running'`: the steps are running.
+ * - `'superseded'`: a newer revision replaced it.
+ * - `'cancelled'`: the user cancelled it.
+ *
+ * Open union (contract rule 4): handle a default branch.
+ *
+ * @since 2.13.0
+ */
+export type AIPlanStatus = 'review' | 'replanning' | 'confirmed' | 'running' | 'superseded' | 'cancelled';
+/**
+ * The plan the AI proposes before it answers, for the user to confirm or edit.
+ *
+ * Replanning keeps `id` and increments `revision`; a plan with a new `id` is a different plan
+ * (header, "Plans and revisions").
+ *
+ * @example
+ * ```ts
+ * const plan: AIPlan = {
+ *   id: 'plan-7',
+ *   revision: 2,
+ *   question: 'How did EMEA revenue change in Q2?',
+ *   steps: [
+ *     { id: 'step-1', text: 'Sum net revenue by month', metric: 'Net revenue', period: 'Q2 2026' },
+ *     { id: 'step-2', text: 'Compare with Q1', status: 'edited', editable: true },
+ *   ],
+ *   status: 'review',
+ * };
+ * ```
+ *
+ * @since 2.13.0
+ */
+export interface AIPlan {
+    /** Stable id of the plan. Replanning keeps it. */
+    id: string;
+    /** Revision number: 1 for the first proposal, one more after each replan. A whole number. Read a missing value as 1. */
+    revision?: number;
+    /** The user's question the plan answers. */
+    question?: string;
+    /** A one-line summary of the plan. */
+    summary?: string;
+    /** The steps, in the order they run. */
+    steps: AIPlanStep[];
+    /** The plan's state. Default `'review'`. */
+    status?: AIPlanStatus;
+}
+/**
+ * State of an item in the review queue.
+ *
+ * Open union (contract rule 4): handle a default branch.
+ *
+ * @since 2.13.0
+ */
+export type AIReviewStatus = 'pending' | 'approved' | 'edited' | 'rejected';
+/**
+ * A part of a review item that a reviewer may edit.
+ *
+ * Open union (contract rule 4): handle a default branch.
+ *
+ * @since 2.13.0
+ */
+export type AIReviewEditableField = 'question' | 'query' | 'answer';
+/**
+ * A reviewer's edits: at least one of the editable fields, so an empty edit (`{}`) does not
+ * type-check.
+ *
+ * @since 2.13.0
+ */
+export type AIReviewEdits = {
+    question: string;
+    query?: string;
+    answer?: string;
+} | {
+    question?: string;
+    query: string;
+    answer?: string;
+} | {
+    question?: string;
+    query?: string;
+    answer: string;
+};
+/**
+ * One event in a review item's history. Kinds are past tense: they record what happened.
+ *
+ * @since 2.13.0
+ */
+export interface AIReviewHistoryEntry {
+    /** Stable id of the entry. */
+    id: string;
+    /** What happened. Open union (contract rule 4): handle a default branch. */
+    kind: 'submitted' | 'flagged' | 'approved' | 'edited' | 'rejected';
+    /** Who did it, as the application names people. */
+    actor?: string;
+    /** When it happened. ISO 8601 date-time. */
+    at: string;
+    /** Why, for example a rejection's reason. Plain text. */
+    reason?: string;
+}
+/**
+ * One answer in the review queue, with what produced it and what happened to it.
+ *
+ * Named `...Data` so the name does not collide with a review item component.
+ *
+ * @since 2.13.0
+ */
+export interface AIReviewItemData {
+    /** Stable id of the item. */
+    id: string;
+    /** The user's question. */
+    question: string;
+    /** The plan that ran, when there was one. */
+    plan?: AIPlan;
+    /** The query that ran, when there was one. */
+    query?: AIQuery;
+    /** The answer under review: a structured response, or plain text. */
+    answer: AIResponse | string;
+    /** Feedback users sent on the answer. */
+    flags?: AIFeedbackEvent[];
+    /** How confident the AI was in the answer. 0-1. */
+    confidence?: number;
+    /** The answer's verification state. */
+    verification?: AIVerificationStatus;
+    /** Who asked, as the application names people. */
+    submittedBy?: string;
+    /** When it was asked. ISO 8601 date-time. */
+    submittedAt?: string;
+    /** The item's review state. */
+    status: AIReviewStatus;
+    /** What happened to the item, oldest first. */
+    history?: AIReviewHistoryEntry[];
+}
+/**
+ * A reviewer's decision on one review item. Decisions are imperative: what the reviewer asks
+ * for. A rejection needs a reason, and an edit needs at least one edited field.
+ *
+ * @example
+ * ```ts
+ * const decisions: AIReviewDecision[] = [
+ *   { itemId: 'item-1', decision: 'approve' },
+ *   { itemId: 'item-2', decision: 'edit', edits: { answer: 'EMEA grew 4% in Q2.' } },
+ *   { itemId: 'item-3', decision: 'reject', reason: 'Uses gross, not net, revenue' },
+ * ];
+ * ```
+ *
+ * @since 2.13.0
+ */
+export type AIReviewDecision = {
+    itemId: string;
+    decision: 'approve';
+} | {
+    itemId: string;
+    decision: 'edit';
+    edits: AIReviewEdits;
+} | {
+    itemId: string;
+    decision: 'reject';
+    reason: string;
+};
+/**
+ * Where a failed action came from, passed as the second argument of every AI-family
+ * `onActionError(error, context)`. An open object: later releases add fields, and a handler
+ * that takes only `(error)` stays assignable, as Modal's and ConfirmDialog's `onActionError`
+ * are (ADR-07).
+ *
+ * @example
+ * ```ts
+ * const failures: Array<{ message: string; source: AIActionErrorContext['source']; actionId?: string }> = [];
+ * const onActionError = (error: unknown, context: AIActionErrorContext) => {
+ *   failures.push({ message: String(error), source: context.source, actionId: context.actionId });
+ * };
+ * ```
+ *
+ * @since 2.13.0
+ */
+export interface AIActionErrorContext {
+    /** What kind of action failed. */
+    source: 'action' | 'block' | 'task' | 'decision' | 'confirm';
+    /** Id of the failed action, for `'action'`. */
+    actionId?: string;
+    /** Id of the response block involved. */
+    blockId?: string;
+    /** Id of the message involved. */
+    messageId?: string;
+    /** Id of the chain-of-thought phase involved. */
+    phaseId?: string;
+    /** Id of the task involved, for `'task'`. */
+    taskId?: string;
+    /** Id of the review item involved, for `'decision'`. */
+    itemId?: string;
+    /** Further ids a later release or a host adds. */
+    [key: string]: unknown;
+}
+/**
+ * The user rated a response, cleared the rating, or used the detailed feedback form.
+ *
+ * @since 2.13.0
+ */
+export interface AIFeedbackInteraction {
+    type: 'feedback';
+    /** What happened: `'rate'`, `'clear'`, or the detail form opening, submitting or cancelling. */
+    action: 'rate' | 'clear' | 'detail-open' | 'detail-submit' | 'detail-cancel';
+    /** The rating, for `'rate'` and `'detail-submit'`. */
+    rating?: AIFeedbackRating;
+    /** Chosen category ids, for `'detail-submit'`. */
+    categoryIds?: AIFeedbackCategory[];
+    /** Whether the user wrote a comment. */
+    hasComment: boolean;
+    /** Whether the user asked for the question to run again. */
+    rerun?: boolean;
+    /** Id of the rated response. */
+    responseId?: string;
+    /** Id of the message that holds the rated response, to join this event with later ones (G-26). */
+    messageId?: string;
+    /** The comment text. includeContent only. */
+    comment?: string;
+}
+/**
+ * The user picked an option in, or submitted, a clarifying question.
+ *
+ * @since 2.13.0
+ */
+export interface AIClarificationInteraction {
+    type: 'clarification';
+    /** `'select'` when an option is picked, `'submit'` when the answer is sent. */
+    action: 'select' | 'submit';
+    /** The clarification's reason. */
+    reason: AIClarificationReason;
+    /** Options offered. A whole number. */
+    optionCount: number;
+    /** Options chosen at the time of the event. A whole number. */
+    selectedCount: number;
+    /** Whether the user typed their own answer. */
+    usedOther: boolean;
+    /** Id of the response block that holds the clarification. */
+    blockId?: string;
+    /** The typed answer. includeContent only. */
+    otherText?: string;
+}
+/**
+ * The user copied something from a response.
+ *
+ * @since 2.13.0
+ */
+export interface AICopyInteraction {
+    type: 'copy';
+    /** What was copied: a query block's text, or a whole response. */
+    target: 'query' | 'response';
+    /** Whether the clipboard write succeeded. */
+    success: boolean;
+    /** Id of the response block copied from. */
+    blockId?: string;
+    /** Id of the message copied from, to join this event with others (G-26). */
+    messageId?: string;
+}
+/**
+ * The user opened a source's details.
+ *
+ * @since 2.13.0
+ */
+export interface AISourceOpenInteraction {
+    type: 'source-open';
+    /** Id of the opened source. */
+    sourceId: string;
+    /** The source's `type`, when it has one. */
+    sourceType?: NonNullable<AIResponseSource['type']>;
+    /** The source chip variant that was opened: the numbered chip or the labelled chip. */
+    variant: 'number' | 'label';
+    /** The source's number in the response, starting at 1. */
+    index?: number;
+}
+/**
+ * The user expanded or collapsed a query view.
+ *
+ * @since 2.13.0
+ */
+export interface AIQueryViewInteraction {
+    type: 'query-view';
+    /** `'expand'` or `'collapse'`. */
+    action: 'expand' | 'collapse';
+    /** Id of the response block that holds the query. */
+    blockId?: string;
+}
+/**
+ * The user edited, confirmed, cancelled or answered a clarification in a plan review (G-26).
+ *
+ * `edited` on `'confirm'` drives the plan edit rate: confirms with `edited: true` divided by all
+ * confirms. Edits accumulate across revisions of the same `planId`. No text fields: the edited
+ * step text is not reported.
+ *
+ * @since 2.13.0
+ */
+export interface AIPlanInteraction {
+    type: 'plan';
+    /** What happened: a step edit, the confirm, the cancel, or a clarification answered inside the plan. */
+    action: 'step_edit' | 'confirm' | 'cancel' | 'clarify';
+    /** Id of the plan. Replanning keeps it. */
+    planId: string;
+    /** The plan's revision, when it has one. A whole number. */
+    revision?: number;
+    /** Id of the response block that holds the plan. */
+    blockId?: string;
+    /** Id of the step, for `'step_edit'` and `'clarify'`. */
+    stepId?: string;
+    /** Whether any step of the plan was edited, across its revisions, for `'confirm'`. */
+    edited?: boolean;
+    /** Ids of the edited steps, for `'confirm'`. */
+    editedStepIds?: string[];
+    /** Steps in the plan. A whole number. */
+    stepCount?: number;
+}
+/**
+ * The user decided on a review item, or started an edit or a rejection (G-26).
+ *
+ * No text fields: the edits and the rejection reason are not reported.
+ *
+ * @since 2.13.0
+ */
+export interface AIReviewInteraction {
+    type: 'review';
+    /** What happened: a decision, or the edit or reject form opening. */
+    action: 'decide' | 'edit_start' | 'reject_start';
+    /** Id of the review item. */
+    itemId: string;
+    /** The decision, for `'decide'`. */
+    decision?: AIReviewDecision['decision'];
+    /** Feedback flags on the item. A whole number. */
+    flagCount?: number;
+    /** The fields the reviewer edited, for an `'edit'` decision. */
+    editedFields?: AIReviewEditableField[];
+}
+/**
+ * The user retried a response or a task (G-26). Each retry is one event: the retry count is the
+ * number of these events. AIMessage's Regenerate action (G-04f, `onRegenerate`) is a response
+ * retry: the event type stays `'retry'`.
+ *
+ * @since 2.13.0
+ */
+export interface AIRetryInteraction {
+    type: 'retry';
+    /** Id of the retried message. */
+    messageId?: string;
+    /** Id of the chain-of-thought phase that holds the retried task. */
+    phaseId?: string;
+    /** Id of the retried task. */
+    taskId?: string;
+}
+/**
+ * The user picked a suggested follow-up question (G-26). A suggestion is not a correction: this
+ * event measures suggestion uptake.
+ *
+ * No text fields: the question text is not reported.
+ *
+ * @since 2.13.0
+ */
+export interface AIFollowupInteraction {
+    type: 'followup';
+    /** `'select'` when a suggested question is picked. */
+    action: 'select';
+    /** Whether the question was a verified suggestion. */
+    verified: boolean;
+    /** The question's place in the list, starting at 0. */
+    index: number;
+    /** Id of the question, when it has one. */
+    questionId?: string;
+}
+/**
+ * The user sent a message from the composer (G-26). A send after a negative rating of the
+ * previous answer counts as a correcting follow-up.
+ *
+ * No text fields: the message text is not reported.
+ *
+ * @since 2.13.0
+ */
+export interface AIMessageInteraction {
+    type: 'message';
+    /** `'send'` when the user sends a message. */
+    action: 'send';
+    /** Id of the latest assistant message when the user sent this one. */
+    previousAssistantMessageId?: string;
+}
+/**
+ * The user stopped an answer while it was generating (`answer.stopped`, DN-13).
+ *
+ * @since 2.13.0
+ */
+export interface AIAnswerInteraction {
+    type: 'answer';
+    /** `'stopped'` when the user stops the answer. */
+    action: 'stopped';
+    /** Id of the stopped message. */
+    messageId?: string;
+}
+/**
+ * The user added a message to the golden dataset with AIMessage's built-in action (GA-01,
+ * `goldenDataset`), reported once the app's `onAdd` settles: `success` is false when it rejected.
+ *
+ * No text fields: the message and its response are not reported.
+ *
+ * @since 2.13.0
+ */
+export interface AIGoldenInteraction {
+    type: 'golden';
+    /** `'add'` when the user adds the message to the golden dataset. */
+    action: 'add';
+    /** Whether the app's `onAdd` succeeded. */
+    success: boolean;
+    /** Id of the added message, to join this event with others (G-26). */
+    messageId?: string;
+}
+/**
+ * Every interaction the AI components report through `AIConfigProvider`'s `onInteraction`
+ * (ADR-06 (11), with G-26's plan, review, retry, followup, message and answer events, and GA-01's
+ * golden event). Each
+ * member is content-free by type: ids, enums, counts and flags. A field that holds user or model
+ * text is present only when the provider sets `includeContent`. Feedback, copy, retry and golden
+ * events carry `messageId`, so an application can join them with a later `message` send.
+ *
+ * Open union (contract rule 4): later minor releases add members. Switch on `type` and keep a
+ * default branch.
+ *
+ * @example
+ * ```ts
+ * function track(event: AIInteractionEvent): string {
+ *   switch (event.type) {
+ *     case 'feedback':
+ *       return `feedback:${event.action}`;
+ *     case 'copy':
+ *       return `copy:${event.success ? 'ok' : 'failed'}`;
+ *     default:
+ *       return event.type;
+ *   }
+ * }
+ * ```
+ *
+ * @since 2.13.0
+ */
+export type AIInteractionEvent = AIFeedbackInteraction | AIClarificationInteraction | AICopyInteraction | AISourceOpenInteraction | AIQueryViewInteraction | AIPlanInteraction | AIReviewInteraction | AIRetryInteraction | AIFollowupInteraction | AIMessageInteraction | AIAnswerInteraction | AIGoldenInteraction;
+/**
+ * What the user did in an interactive response block, reported through `onBlockEvent`
+ * (ADR-05 (3)). Unlike {@link AIInteractionEvent}, a block event is the user's input itself: the
+ * application acts on it, so it carries the answer, the confirm state and the edited text.
+ *
+ * - `'clarification.submit'`: the user answered a clarifying question.
+ * - `'plan.confirm'`: the user confirmed a plan. `edited` is `true` when any step was edited,
+ *   and `editedStepIds` lists those steps. `plan` is the plan as confirmed.
+ *   `clarificationAnswers` carries the answers to the steps' questions, by step id (G-41+).
+ * - `'plan.clarify'`: the user answered the question of one plan step, before confirming, so
+ *   the backend can replan (a new `revision` of the same plan). Sent once per distinct answer
+ *   (G-41+, ADR-05 amendment G-OD6, proposed).
+ * - `'plan.stepEdit'`: the user changed the text of one plan step.
+ * - `'plan.cancel'`: the user cancelled a plan.
+ * - `'query.copy'`: the user copied a query block's text.
+ *
+ * Open union (contract rule 4): later minor releases add members. Switch on `type` and keep a
+ * default branch.
+ *
+ * @example
+ * ```ts
+ * async function handleBlockEvent(event: AIBlockEvent): Promise<void> {
+ *   switch (event.type) {
+ *     case 'clarification.submit':
+ *       await fetch(`/api/blocks/${event.blockId}/answer`, { method: 'POST', body: JSON.stringify(event.answer) });
+ *       return;
+ *     case 'plan.cancel':
+ *       await fetch(`/api/blocks/${event.blockId}/cancel`, { method: 'POST' });
+ *       return;
+ *     default:
+ *       return;
+ *   }
+ * }
+ * ```
+ *
+ * @since 2.13.0
+ */
+export type AIBlockEvent = {
+    type: 'clarification.submit';
+    /** Id of the clarification block. */
+    blockId: string;
+    /** The user's answer. */
+    answer: AIClarificationAnswer;
+} | {
+    type: 'plan.confirm';
+    /** Id of the plan-review block. */
+    blockId: string;
+    /** Whether the user edited any step before confirming. */
+    edited: boolean;
+    /** Ids of the steps the user edited; empty when none was. */
+    editedStepIds: string[];
+    /** The plan as confirmed, with the user's step edits applied. */
+    plan: AIPlan;
+    /**
+     * The answers to the steps' clarifications, by step id (G-41+). Optional, so handlers
+     * written before it keep compiling.
+     * @since 2.13.0
+     */
+    clarificationAnswers?: Record<string, AIClarificationAnswer>;
+} | {
+    type: 'plan.clarify';
+    /** Id of the plan-review block. */
+    blockId: string;
+    /** Id of the plan. Replanning keeps it. */
+    planId: string;
+    /** The plan's revision when the user answered. A whole number. */
+    revision?: number;
+    /** Id of the step whose question was answered. */
+    stepId: string;
+    /** The user's answer. */
+    answer: AIClarificationAnswer;
+} | {
+    type: 'plan.stepEdit';
+    /** Id of the plan-review block. */
+    blockId: string;
+    /** Id of the edited step. */
+    stepId: string;
+    /** The step's new text. */
+    text: string;
+} | {
+    type: 'plan.cancel';
+    /** Id of the plan-review block. */
+    blockId: string;
+} | {
+    type: 'query.copy';
+    /** Id of the query block. */
+    blockId: string;
+};
+/**
+ * The AI components' built-in strings, grouped by component. A key's full name is
+ * `ai.<group>.<key>`, for example `ai.common.copied`. Override any of them with
+ * `AIConfigProvider`'s `strings` prop, which takes a deep partial of this type.
+ *
+ * A read type: you never build a whole `AIStrings`, so adding keys is a minor change. Renaming
+ * or removing a key, or changing a count function's arguments, is a major change. Count strings
+ * are functions of `{ count }`, so an override can use `Intl.PluralRules`.
+ *
+ * One group per component, named after it without the `AI` prefix (ADR-06 (3)): `ai.voiceMode.*`
+ * for AIVoiceMode, `ai.insightEngineInput.*` for InsightEngineInput. The catalog holds every
+ * English literal of the AI surfaces with its current text (master plan E-25); the map from each
+ * source literal to its key is docs/remediation/E-25-ai-strings-map.md. Components read their
+ * keys as their owners wire them; until then a key documents the text the component shows.
+ *
+ * @since 2.13.0
+ */
+export interface AIStrings {
+    /** Strings shared by several AI components (`ai.common.*`). */
+    common: {
+        /** Announced after a copy succeeds. @default 'Copied' */
+        copied: string;
+        /** Announced when a copy fails. @default "Couldn't copy" */
+        copyFailed: string;
+        /** Announced when a response has finished streaming. @default 'Response ready' */
+        responseReady: string;
+        /** Name of the control that retries a failed request. @default 'Try again' */
+        tryAgain: string;
+        /**
+         * Description of a link that opens in a new tab, linked through aria-describedby so the
+         * link's name stays the same (WI-56). @default 'Opens in a new tab'
+         */
+        opensInNewTab: string;
+    };
+    /** AppLayout's AI panel strings (`ai.appLayout.*`). Owner: workstream H. */
+    appLayout: {
+        /** Name of the AI panel's resize handle (ResizablePanel's default today). @default 'Resize panel' */
+        resizeHandle: string;
+        /**
+         * Name of the AI panel landmark (and of the mobile drawer) when AppLayout hosts a custom
+         * surface through `renderAiPanel` (H-11, H-13). @default 'AI assistant' @since 2.13.0
+         */
+        panelLabel: string;
+    };
+    /** AIChainOfThought strings (`ai.chainOfThought.*`). Owner: workstream I. */
+    chainOfThought: {
+        /** Name of a phase header toggle. @default ({ title, status }) => `${title} phase — ${status}` */
+        phaseToggle: (args: {
+            title: string;
+            status: string;
+        }) => string;
+        /** @default 'Sources consulted' */
+        sourcesConsulted: string;
+        /** @default 'Run' */
+        run: string;
+        /** @default 'Generated artifacts' */
+        generatedArtifacts: string;
+        /** @default 'Insight' */
+        insightFallbackTitle: string;
+        /** @default 'Confidence' */
+        confidence: string;
+        /** @default 'Sources & references' */
+        sourcesAndReferences: string;
+        /** @default 'Toggle thought process' */
+        toggleThoughtProcess: string;
+        /** @default 'Thought process' */
+        thoughtProcess: string;
+        /** Name of the chain when it has no query. @default 'AI reasoning chain' */
+        reasoningChain: string;
+        /** @default 'Generating response…' */
+        generatingResponse: string;
+        /** Name of the chain, from the query it reasons about (WI-44). @default ({ query }) => `Reasoning for ${query}` */
+        reasoningFor: (args: {
+            query: string;
+        }) => string;
+        /** Status of the chain while it is thinking. @default 'Thinking' */
+        thinking: string;
+        /**
+         * The chain's indicator and its one announcement while a plan-review phase waits for the user
+         * (G-22). Requirement copy (R9, the same text as `ai.planReview.ready`): change it only with
+         * product sign-off. @default "Plan's ready — needs your confirmation" @since 2.13.0
+         */
+        planReady: string;
+        /**
+         * The chain's indicator and announcement while a phase other than a plan review waits for the
+         * user, and the status text of an awaiting-input phase or task (G-22, G-43+).
+         * @default 'Needs your input' @since 2.13.0
+         */
+        awaitingInput: string;
+        /**
+         * The thought-process bar's progress for assistive technology (WI-13). `locale` is the
+         * resolved AI locale, for an override's own plural rules.
+         * @default ({ completed, total }) => `${completed} of ${total} step(s) complete` (English plural rules)
+         * @since 2.13.0
+         */
+        progressSummary: (args: {
+            completed: number;
+            total: number;
+            locale?: string;
+        }) => string;
+        /** Status text of a retrying task (WI-13). @default 'Retrying' @since 2.13.0 */
+        retrying: string;
+        /** Name of a failed task's Retry button (WI-13). @default 'Retry' @since 2.13.0 */
+        retryTask: string;
+        /** Shown when a task retry fails (WI-13). @default "Couldn't retry the task" @since 2.13.0 */
+        retryTaskFailed: string;
+        /**
+         * Announced, assertively, when a task fails after mount (WI-13).
+         * @default ({ label, message }) => `${label} failed: ${message}` @since 2.13.0
+         */
+        taskFailed: (args: {
+            label: string;
+            message: string;
+        }) => string;
+        /** Name of the insight metrics list (WI-13). @default 'Key metrics' @since 2.13.0 */
+        metrics: string;
+        /**
+         * The header's status line while the chain works (owner mockups 2026-10-08).
+         * @default 'Reasoning in progress…' @since 2.13.0
+         */
+        reasoningInProgress: string;
+        /** The header's status line once every phase is complete. @default 'Done' @since 2.13.0 */
+        done: string;
+        /** The header's status line when a phase failed and nothing runs. @default 'A step failed' @since 2.13.0 */
+        stepFailed: string;
+        /**
+         * The header's status line with the elapsed time ("Done · 4.2s").
+         * @default ({ status, elapsed }) => `${status} · ${elapsed}` @since 2.13.0
+         */
+        statusWithElapsed: (args: {
+            status: string;
+            elapsed: string;
+        }) => string;
+        /** The label of the insight confidence bar. @default 'Insight confidence' @since 2.13.0 */
+        insightConfidence: string;
+        /**
+         * An output file card's second line, its format and meta ("CSV · 5 rows").
+         * @default ({ format, meta }) => `${format} · ${meta}` @since 2.13.0
+         */
+        artifactMeta: (args: {
+            format: string;
+            meta: string;
+        }) => string;
+        /**
+         * Status words of a phase trigger and the thought-process bar (WI-13), so no raw status value
+         * reaches an accessible name. An awaiting-input phase reads `awaitingInput`.
+         * @since 2.13.0
+         */
+        phaseStatus: {
+            /** @default 'Not started' */
+            pending: string;
+            /** @default 'In progress' */
+            active: string;
+            /** @default 'Completed' */
+            completed: string;
+            /** @default 'Failed' */
+            error: string;
+        };
+    };
+    /** ChatHeader strings (`ai.chatHeader.*`). Owner: workstream I. */
+    chatHeader: {
+        /** @default 'Expand view' */
+        expandView: string;
+        /** @default 'Collapse to sidepanel' */
+        collapseToSidepanel: string;
+        /** Name and tooltip of the close button. @default 'Close panel' */
+        closePanel: string;
+    };
+    /** ChatHistoryList strings (`ai.chatHistoryList.*`). Owner: workstream I. */
+    chatHistoryList: {
+        /** @default 'No conversations yet' */
+        empty: string;
+        /** @default 'Conversation history' */
+        listLabel: string;
+        /** @default 'Chat options' */
+        chatOptions: string;
+        /** @default 'Pin' */
+        pin: string;
+        /** @default 'Unpin' */
+        unpin: string;
+        /** @default 'Rename' */
+        rename: string;
+        /** @default 'Share' */
+        share: string;
+        /** @default 'Add to project' */
+        addToProject: string;
+        /** @default 'Delete' */
+        delete: string;
+        /** Name of a chat's options menu button, unique per chat (WI-23b). @default ({ title }) => `Options for ${title}` */
+        optionsFor: (args: {
+            title: string;
+        }) => string;
+    };
+    /** ChatThread strings (`ai.chatThread.*`). Owner: workstream G. */
+    chatThread: {
+        /** Name of the message log. @default 'Chat messages' */
+        logLabel: string;
+        /** @default 'Start a conversation' */
+        empty: string;
+    };
+    /** AICircularAction strings (`ai.circularAction.*`). Owner: workstream I. */
+    circularAction: {
+        /**
+         * The button's name when its badge adds text: the label, then the badge text (WI-37).
+         * @default ({ label, badge }) => `${label}, ${badge}`
+         */
+        nameWithBadge: (args: {
+            label: string;
+            badge: string;
+        }) => string;
+    };
+    /** AIDigestCard strings (`ai.digestCard.*`). Owner: workstream I. */
+    digestCard: {
+        cadence: {
+            /** @default 'Daily briefing' */
+            daily: string;
+            /** @default 'Weekly briefing' */
+            weekly: string;
+            /** @default 'Monthly briefing' */
+            monthly: string;
+            /** @default 'Quarterly briefing' */
+            quarterly: string;
+            /** @default 'Briefing' */
+            custom: string;
+        };
+        /** @default 'Dismiss digest' */
+        dismiss: string;
+        /**
+         * The button that shows the hidden highlights; the English default picks the plural form with
+         * `Intl.PluralRules('en-US')`. @default ({ count }) => `Show ${count} more highlight` (one) or `Show ${count} more highlights` (other)
+         */
+        showMoreHighlights: (args: {
+            count: number;
+        }) => string;
+    };
+    /** AIExplainability strings (`ai.explainability.*`). Owner: workstream I. */
+    explainability: {
+        /** @default 'AI-generated content' */
+        title: string;
+        /** @default 'Model' */
+        model: string;
+        /** @default 'Confidence' */
+        confidence: string;
+        /** @default 'Last updated' */
+        lastUpdated: string;
+        /** The confidence level word with `showConfidenceLevel`, at or above the high threshold (WI-25). @default 'High' */
+        confidenceHigh: string;
+        /** The confidence level word with `showConfidenceLevel`, from the medium threshold (WI-25). @default 'Medium' */
+        confidenceMedium: string;
+        /** The confidence level word with `showConfidenceLevel`, below the medium threshold (WI-25). @default 'Low' */
+        confidenceLow: string;
+    };
+    /** AIFab strings (`ai.fab.*`). Owner: workstream H. */
+    fab: {
+        /** Tooltip and name of the floating action button. @default 'Ask AI' */
+        tooltip: string;
+    };
+    /** InsightEngine strings (`ai.insightEngine.*`). Owner: workstream G. */
+    insightEngine: {
+        /** @default 'Insight Engine' */
+        title: string;
+        /** Upper case on screen from CSS (textTransform). @default 'History' */
+        history: string;
+        /** The history heading with the number of chats. Upper case on screen from CSS. @default ({ count }) => `History (${count})` */
+        historyWithCount: (args: {
+            count: number;
+        }) => string;
+        /** @default 'Ask anything…' */
+        placeholder: string;
+        /**
+         * The inline alert when `onSendMessage` rejects (H-16); 'Try again' (`ai.common.tryAgain`)
+         * sends the same text again. @default "Your message wasn't sent. Check your connection and try again."
+         */
+        sendFailed: string;
+    };
+    /** InsightEngineInput strings (`ai.insightEngineInput.*`). Owner: workstream I. */
+    insightEngineInput: {
+        /** @default 'Add files and tools' */
+        addFilesAndTools: string;
+        /** @default 'Ask anything. Type @ for mentions and / for shortcuts.' */
+        placeholder: string;
+        /** @default 'Add files or photos' */
+        addFilesOrPhotos: string;
+        /** @default 'Web search' */
+        webSearch: string;
+        /** @default 'Deep thinking' */
+        deepThinking: string;
+        /** @default 'Upload failed' */
+        uploadFailed: string;
+        /** @default 'Insight engine input' */
+        inputLabel: string;
+        /** @default 'Data source toggles' */
+        dataSourceToggles: string;
+        /** @default 'Model' */
+        model: string;
+        /** @default 'AI model selection' */
+        modelSelection: string;
+        /** @default 'Dictate' */
+        dictate: string;
+        /** @default 'Stop dictation' */
+        stopDictation: string;
+        /** @default 'Voice mode' */
+        voiceMode: string;
+        /** Name and tooltip of the Send button (OD-E11 option A: the tooltip is the name, `aria-keyshortcuts="Enter"`). @default 'Send message' */
+        sendMessage: string;
+        /** Name and tooltip of the Stop button shown while an answer is generating (WI-61+). @default 'Stop generating' */
+        stopGenerating: string;
+        /** Upload progress of one attachment. @default ({ progress }) => `Uploading…${progress !== undefined ? ` ${Math.round(progress)}%` : ''}` */
+        uploading: (args: {
+            progress?: number;
+        }) => string;
+        /** Name of the retry button of a failed attachment. @default ({ name }) => `Retry upload of ${name}` */
+        retryUpload: (args: {
+            name: string;
+        }) => string;
+        /** Name of the remove button of an attachment. @default ({ name }) => `Remove ${name}` */
+        removeAttachment: (args: {
+            name: string;
+        }) => string;
+        /** Name of an attachment's upload progress bar (WI-29a). @default ({ name }) => `Uploading ${name}` */
+        uploadingFile: (args: {
+            name: string;
+        }) => string;
+        /** Name of a data source switch. @default ({ label }) => `Toggle ${label}` */
+        toggleSource: (args: {
+            label: string;
+        }) => string;
+        /**
+         * Name of the chip that shows how many sources are selected; the English default picks the
+         * plural form with `Intl.PluralRules('en-US')`. @default ({ count }) => '1 source selected' (one) or `${count} sources selected` (other)
+         */
+        sourcesSelected: (args: {
+            count: number;
+        }) => string;
+    };
+    /** InsightEnginePanel strings (`ai.insightEnginePanel.*`). Owner: workstream H. */
+    insightEnginePanel: {
+        /** @default 'Ask anything…' */
+        placeholder: string;
+        /** @default 'Insight Engine' */
+        title: string;
+        /** @default 'Show history' */
+        showHistory: string;
+        /** @default 'Hide history' */
+        hideHistory: string;
+        /** @default 'New thread' */
+        newThread: string;
+        /** @default 'Pro' */
+        proBadge: string;
+        /** @default 'Boxed layout' */
+        boxedLayout: string;
+        /** @default 'Full width' */
+        fullWidth: string;
+        /** @default 'Fullscreen' */
+        fullscreen: string;
+        /** @default 'Exit fullscreen' */
+        exitFullscreen: string;
+        /** @default 'Close' */
+        close: string;
+        /** @default 'What do you want to know?' */
+        emptyTitle: string;
+        /** @default "Ask anything and I'll search across your sources to find the answer" */
+        emptyDescription: string;
+        /**
+         * The typing indicator's text before H-08. Since H-08 the panel shows a streaming entry (a
+         * decorative shimmer, never announced) instead, so no component reads it; it stays in the
+         * catalog (removing a key is major).
+         * @default 'Searching…'
+         */
+        searching: string;
+        /** @default 'Ask anything. Type @ for mentions and / for shortcuts.' */
+        composerPlaceholder: string;
+        /** @default 'Insight Engine can make mistakes. Verify important information.' */
+        disclaimer: string;
+        /** The label that marks demo mode inside the panel heading (H-04). @default 'Demo responses' */
+        demoLabel: string;
+    };
+    /** AILabel strings (`ai.label.*`). Owner: workstream I. */
+    label: {
+        /** The label text. @default 'AI' */
+        text: string;
+        /** The name of the label's popover dialog (WI-16b). @default 'About this AI content' */
+        popoverLabel: string;
+    };
+    /** AIListeningIndicator strings (`ai.listeningIndicator.*`). Owner: workstream I. */
+    listeningIndicator: {
+        /** @default 'Listening… Speak now' */
+        text: string;
+        /** @default 'Stop listening' */
+        stop: string;
+    };
+    /** AIMessage strings (`ai.message.*`). Owner: workstream G. */
+    message: {
+        /** Name of the response region. @default 'AI response' */
+        regionLabel: string;
+        /** Name of the actions group (G-28). @default 'AI response actions' */
+        actionsLabel: string;
+        /** Name and tooltip of the copy action: one string for both (G-28, ADR-13 (3)). @default 'Copy response' */
+        copyResponse: string;
+        /** Name and tooltip of the action. @default 'Mark as good response' */
+        markGood: string;
+        /** Name and tooltip of the action. @default 'Mark as poor response' */
+        markPoor: string;
+        /** Name and tooltip of the share action: one string for both (G-28, ADR-13 (3)). @default 'Share response' */
+        shareResponse: string;
+        /** Name and tooltip of the download action: one string for both (G-28, ADR-13 (3)). @default 'Download response' */
+        downloadResponse: string;
+        /** Why copy is unavailable while the response streams, linked to the copy action (G-04b). @default 'Copy is unavailable while the response is streaming' */
+        copyUnavailableStreaming: string;
+        /**
+         * The short verb of the regenerate action (G-04f). Since G-28 AIMessage's footer button reads
+         * `regenerateResponse` for its tooltip and its name; the key stays for hosts that show the
+         * verb as text. @default 'Regenerate'
+         */
+        regenerate: string;
+        /** Name and tooltip of the regenerate action: one string for both (G-04f, G-28). @default 'Regenerate response' */
+        regenerateResponse: string;
+        /** Why regenerate is unavailable while the response streams, linked to the regenerate action (G-28). @default 'Regenerate is unavailable while the response is streaming' */
+        regenerateUnavailableStreaming: string;
+        /** Shown when regenerating fails (G-04f). @default "Couldn't regenerate the response" */
+        regenerateFailed: string;
+        /**
+         * Name and tooltip of the golden-dataset action (GA-01): one string for both (ADR-13 (3)).
+         * @default 'Add to golden dataset'
+         */
+        addToGolden: string;
+        /**
+         * The golden-dataset action's added state (GA-01): the pressed action's reason, the label of
+         * the message's golden verification badge, and the success announcement.
+         * @default 'Added to golden dataset'
+         */
+        addedToGolden: string;
+        /** Shown when adding to the golden dataset fails (GA-01). @default "Couldn't add to the golden dataset" */
+        addToGoldenFailed: string;
+        /**
+         * Why the golden-dataset action is unavailable while the response streams, linked to the action
+         * (GA-01). @default 'Adding to the golden dataset is unavailable while the response is streaming'
+         */
+        addToGoldenUnavailableStreaming: string;
+        /** Name of an assistant message without a visible timestamp (G-06). @default 'Assistant response' */
+        assistantResponse: string;
+        /** Name of an assistant message with its formatted time (G-06). @default ({ time }) => `Assistant response, ${time}` */
+        assistantResponseAt: (args: {
+            time: string;
+        }) => string;
+    };
+    /** AIRelatedQuestions strings (`ai.relatedQuestions.*`). Owner: workstream I. */
+    relatedQuestions: {
+        /** @default 'Related questions' */
+        title: string;
+        /** @default 'No related questions' */
+        emptyTitle: string;
+        /** @default 'Questions will appear here based on the conversation context.' */
+        emptyDescription: string;
+        /** @default 'Related questions list' */
+        listLabel: string;
+    };
+    /** AIResponseRenderer strings (`ai.responseRenderer.*`). Owner: workstream G. */
+    responseRenderer: {
+        /** Title of the inline error of a failed response (G-34). @default 'This response failed' */
+        errorTitle: string;
+        /** Shown in place of a block that cannot render (G-39+). @default 'This part of the response is unavailable' */
+        blockUnavailable: string;
+    };
+    /** AISource strings (`ai.source.*`): the text equivalent of each source type (WI-20a). Owner: workstream I. */
+    source: {
+        /** @default 'Web page' */
+        typeWebpage: string;
+        /** @default 'Document' */
+        typeDocument: string;
+        /** @default 'Article' */
+        typeArticle: string;
+        /** @default 'Video' */
+        typeVideo: string;
+        /** @default 'Other source' */
+        typeOther: string;
+    };
+    /** AISourcesPanel strings (`ai.sourcesPanel.*`). Owner: workstream I. */
+    sourcesPanel: {
+        /** @default 'Sources' */
+        title: string;
+        /** @default 'Hide' */
+        hide: string;
+        /** @default 'Show' */
+        show: string;
+        /** The panel's header: the title and the number of sources (WI-37). @default ({ title, count }) => `${title} (${count})` */
+        titleWithCount: (args: {
+            title: string;
+            count: number;
+        }) => string;
+        /** A category's row: its name and its number of sources (WI-37). @default ({ name, count }) => `${name} (${count})` */
+        categoryWithCount: (args: {
+            name: string;
+            count: number;
+        }) => string;
+    };
+    /** AISourcesSection strings (`ai.sourcesSection.*`). Owner: workstream I. */
+    sourcesSection: {
+        /** @default 'Sources' */
+        title: string;
+        /** @default 'Show less' */
+        showLess: string;
+        /** The button that shows the hidden sources. @default ({ count }) => `Show ${count} more` */
+        showMore: (args: {
+            count: number;
+        }) => string;
+    };
+    /** AITextBlock strings (`ai.textBlock.*`). Owner: workstream I. */
+    textBlock: {
+        /** The copy button of a fenced code block: its name and tooltip (D-34). @default 'Copy code' */
+        copyCode: string;
+        /** The name of a fenced code block's scroll region, while it scrolls (D-34). @default 'Code sample' */
+        codeRegion: string;
+    };
+    /** ThreadHistorySidebar strings (`ai.threadHistorySidebar.*`). Owner: workstream H. */
+    threadHistorySidebar: {
+        /** @default 'History' */
+        title: string;
+        /** @default 'New thread' */
+        newThread: string;
+        /** @default 'Close history' */
+        closeHistory: string;
+        /** @default 'Search threads…' */
+        searchPlaceholder: string;
+        /** @default 'Star' */
+        star: string;
+        /** @default 'Unstar' */
+        unstar: string;
+        /** @default 'Rename' */
+        rename: string;
+        /** @default 'Delete' */
+        delete: string;
+        /** @default 'No conversation history' */
+        emptyHistory: string;
+        /** @default 'No threads match your search' */
+        emptySearch: string;
+        /** @default 'More options' */
+        moreOptions: string;
+        /** The number of threads. @default ({ count }) => (count === 1 ? '1 thread' : `${count} threads`) */
+        threadCount: (args: {
+            count: number;
+        }) => string;
+        /** Name of the search field (H-42). @default 'Search threads' */
+        searchLabel: string;
+        /**
+         * The Star toggle's one name and tooltip; `aria-pressed` carries the state (D-40, H-13).
+         * @default 'Star thread' @since 2.13.0
+         */
+        starThread: string;
+        /** Name of the inline rename field (D-40, H-13). @default 'Thread name' @since 2.13.0 */
+        threadName: string;
+        /** The rename field's error for an empty name (D-40, H-13). @default 'Enter a thread name.' @since 2.13.0 */
+        threadNameRequired: string;
+    };
+    /** UserMessage strings (`ai.userMessage.*`). Owner: workstream G. */
+    userMessage: {
+        /** Name of a user message (G-06). @default 'Your message' */
+        label: string;
+    };
+    /** AIVoiceMode strings (`ai.voiceMode.*`). Owner: workstream I. */
+    voiceMode: {
+        status: {
+            /** @default 'Connecting…' */
+            connecting: string;
+            /** @default 'Listening…' */
+            listening: string;
+            /** @default 'Thinking…' */
+            thinking: string;
+            /** @default 'Speaking…' */
+            speaking: string;
+            /** @default 'Muted' */
+            paused: string;
+        };
+        /** @default 'Voice mode' */
+        title: string;
+        /** @default 'Start speaking…' */
+        startSpeaking: string;
+        /** @default 'Getting things ready…' */
+        gettingReady: string;
+        /** @default 'Microphone is muted' */
+        microphoneMuted: string;
+        /** @default 'Close voice mode' */
+        close: string;
+        /** @default 'Mute microphone' */
+        muteMicrophone: string;
+        /** @default 'End voice mode' */
+        end: string;
+    };
+    /** AIVoiceOverlay strings (`ai.voiceOverlay.*`). Owner: workstream I. */
+    voiceOverlay: {
+        /** @default 'Listening…' */
+        listening: string;
+        /** @default 'Tap to speak' */
+        ready: string;
+        /** @default 'Speak your question clearly' */
+        listeningInstruction: string;
+        /** @default 'Voice mode is ready' */
+        readyInstruction: string;
+        /** @default 'Voice input' */
+        voiceInput: string;
+        /** @default 'Close voice input' */
+        close: string;
+    };
+    /** Source categories and details from the source adapter, `toSourceCategories` (`ai.sources.*`, F-05). Owner: workstream F. */
+    sources: {
+        /** The name of each category when sources are grouped by type. */
+        type: {
+            /** @default 'Documents' */
+            document: string;
+            /** @default 'Web pages' */
+            webpage: string;
+            /** @default 'Databases' */
+            database: string;
+            /** @default 'APIs' */
+            api: string;
+            /** Sources without a type, and any type this version does not know. @default 'Other sources' */
+            other: string;
+        };
+        /** The name of the single category when sources are not grouped (`groupBy: 'none'`). @default 'Sources' */
+        all: string;
+        /**
+         * A numbered source as plain text, `number` being its 1-based place in the response's
+         * `sources`. AISourcesPanel shows the number in the chip itself, so the adapter labels panel
+         * items with the title alone.
+         * @default ({ number, title }) => `[${number}] ${title}`
+         */
+        itemLabel: (args: {
+            number: number;
+            title: string;
+        }) => string;
+        /** The terms of a source's details, in the order the adapter lists them. */
+        detail: {
+            /** @default 'Metric' */
+            metric: string;
+            /** @default 'Filters' */
+            filters: string;
+            /** @default 'Period' */
+            period: string;
+            /** @default 'Dataset' */
+            dataset: string;
+            /** @default 'As of' */
+            asOf: string;
+            /** @default 'Excerpt' */
+            excerpt: string;
+        };
+    };
+    /**
+     * Filter text from `formatFilter` (`ai.filters.*`, F-05). `field` and `value` arrive formatted
+     * for the locale: numbers through `Intl.NumberFormat`, a list of values through `values`.
+     * Owner: workstream F.
+     */
+    filters: {
+        /** One function per operator, so a locale can order the words its own way. */
+        operator: {
+            /** @default ({ field, value }) => `${field}: ${value}` */
+            eq: (args: {
+                field: string;
+                value: string;
+            }) => string;
+            /** @default ({ field, value }) => `${field} is not ${value}` */
+            neq: (args: {
+                field: string;
+                value: string;
+            }) => string;
+            /** `value` is the list of values, already joined by `values`. @default ({ field, value }) => `${field}: ${value}` */
+            in: (args: {
+                field: string;
+                value: string;
+            }) => string;
+            /** `value` is the list of values, already joined by `values`. @default ({ field, value }) => `${field} excludes ${value}` */
+            notIn: (args: {
+                field: string;
+                value: string;
+            }) => string;
+            /** @default ({ field, value }) => `${field} greater than ${value}` */
+            gt: (args: {
+                field: string;
+                value: string;
+            }) => string;
+            /** @default ({ field, value }) => `${field} at least ${value}` */
+            gte: (args: {
+                field: string;
+                value: string;
+            }) => string;
+            /** @default ({ field, value }) => `${field} less than ${value}` */
+            lt: (args: {
+                field: string;
+                value: string;
+            }) => string;
+            /** @default ({ field, value }) => `${field} at most ${value}` */
+            lte: (args: {
+                field: string;
+                value: string;
+            }) => string;
+            /** Both ends inclusive. @default ({ field, min, max }) => `${field} from ${min} to ${max}` */
+            between: (args: {
+                field: string;
+                min: string;
+                max: string;
+            }) => string;
+            /** @default ({ field, value }) => `${field} contains ${value}` */
+            contains: (args: {
+                field: string;
+                value: string;
+            }) => string;
+        };
+        /**
+         * Joins several filters into one phrase, as a source's details list them.
+         * @default ({ items, locale }) => new Intl.ListFormat(locale, { style: 'long', type: 'conjunction' }).format(items)
+         */
+        list: (args: {
+            items: string[];
+            locale: string;
+        }) => string;
+        /**
+         * Joins the values of one filter (`'in'`, `'not-in'`, or an array under another operator), so
+         * they read apart from the words that join filters: 'Region: EMEA, APAC'.
+         * @default ({ items, locale }) => new Intl.ListFormat(locale, { style: 'short', type: 'unit' }).format(items)
+         */
+        values: (args: {
+            items: string[];
+            locale: string;
+        }) => string;
+        /** A `true` filter value. @default 'Yes' */
+        booleanTrue: string;
+        /** A `false` filter value. @default 'No' */
+        booleanFalse: string;
+    };
+    /** AIConfidenceBadge strings (`ai.confidenceBadge.*`, F-10). Owner: workstream F. */
+    confidenceBadge: {
+        /** The word shown before the level in the bar variant and in the summary. @default 'Confidence' */
+        label: string;
+        level: {
+            /** @default 'Low' */
+            low: string;
+            /** @default 'Medium' */
+            medium: string;
+            /** @default 'High' */
+            high: string;
+        };
+        /**
+         * The visible text: the level word and, when the badge has a valid value, the formatted percentage.
+         * @default ({ level, value }) => (value ? `${level} · ${value}` : level)
+         */
+        display: (args: {
+            level: string;
+            value?: string;
+        }) => string;
+        /**
+         * The text for assistive technology, and the trigger's name when the badge opens details.
+         * @default ({ label, level, value }) => (value ? `${label}: ${level}, ${value}` : `${label}: ${level}`)
+         */
+        summary: (args: {
+            label: string;
+            level: string;
+            value?: string;
+        }) => string;
+        /** Shown for a value outside 0-1. @default 'Confidence unavailable' */
+        unavailable: string;
+        /** Read while the confidence loads. @default 'Calculating confidence' */
+        pending: string;
+        /** The heading of the details popover. @default 'Why this confidence' */
+        detailsTitle: string;
+        /** The terms of the details list. */
+        detail: {
+            /** @default 'Level' */
+            level: string;
+            /** @default 'Score' */
+            score: string;
+            /** @default 'Thresholds' */
+            thresholds: string;
+        };
+        /** The thresholds row, each threshold formatted as a percentage. @default ({ medium, high }) => `Medium from ${medium}, high from ${high}` */
+        thresholdsSummary: (args: {
+            medium: string;
+            high: string;
+        }) => string;
+    };
+    /** AIVerificationBadge strings (`ai.verificationBadge.*`, F-11). Owner: workstream F. */
+    verificationBadge: {
+        /** The label of each status. */
+        status: {
+            /** @default 'Verified' */
+            verified: string;
+            /** R26 requirement copy (G-42+, protected: change only with product sign-off). @default 'Answered from the verified dataset' */
+            golden: string;
+            /** @default 'Confirmed plan' */
+            confirmedPlan: string;
+            /** @default 'Pending review' */
+            pendingReview: string;
+            /** @default 'Flagged for review' */
+            flagged: string;
+            /** @default 'Rejected' */
+            rejected: string;
+        };
+        /** Announced when the status changes after mount (`live`). @default ({ label }) => `Verification status: ${label}` */
+        changed: (args: {
+            label: string;
+        }) => string;
+        /** The heading of the details popover. @default 'Verification details' */
+        detailsTitle: string;
+        /** The terms of the details list. */
+        detail: {
+            /** @default 'Verified on' */
+            verifiedAt: string;
+            /** @default 'Dataset' */
+            dataset: string;
+            /** @default 'Note' */
+            note: string;
+        };
+    };
+    /** AISourceChip strings (`ai.sourceChip.*`, F-12). Owner: workstream F. */
+    sourceChip: {
+        /**
+         * The visible text of the label variant: the metric (else the title), then the period.
+         * @default ({ metric, period, title }) => (period ? `${metric ?? title}, ${period}` : (metric ?? title))
+         */
+        label: (args: {
+            metric?: string;
+            period?: string;
+            title: string;
+        }) => string;
+        /** The name of the number variant. `index` is 1-based. @default ({ index, title }) => `Source ${index}: ${title}` */
+        numberName: (args: {
+            index: number;
+            title: string;
+        }) => string;
+        /**
+         * The name of the label variant. It starts with the visible label (WCAG 2.5.3).
+         * @default ({ label, title }) => (label === title ? `${label}, source` : `${label}, source: ${title}`)
+         */
+        labelName: (args: {
+            label: string;
+            title: string;
+        }) => string;
+        /** The link to the source. @default 'Open source' */
+        openSource: string;
+        /** Read after the link text. @default '(opens in new tab)' */
+        opensInNewTab: string;
+        /** The action that reveals the query behind the source. @default 'Show query' */
+        showQuery: string;
+        /** Shown when a source has nothing but a title. @default 'No additional details' */
+        noDetails: string;
+    };
+    /** AIQueryDisclosure strings (`ai.queryDisclosure.*`, F-14). Owner: workstream F. */
+    queryDisclosure: {
+        /** The trigger label. It never changes with the state. @default 'Query' */
+        title: string;
+        /** The trigger label when the query language is known. @default ({ language }) => `${language} query` */
+        titleWithLanguage: (args: {
+            language: string;
+        }) => string;
+        /** The name of the code area while it scrolls. @default ({ language }) => (language ? `${language} query text` : 'Query text') */
+        codeLabel: (args: {
+            language?: string;
+        }) => string;
+        /** Why the trigger is unavailable while streaming. @default 'The query is still being generated' */
+        streamingReason: string;
+        /** The copy button's name and tooltip. @default 'Copy query' */
+        copy: string;
+        /** Announced after a copy succeeds. @default 'Query copied' */
+        copied: string;
+        /** Announced when a copy fails. @default 'Copy failed' */
+        copyFailed: string;
+        /** The metadata list: terms, and the row count. */
+        meta: {
+            /** The term of the row count. @default 'Result' */
+            result: string;
+            /** The row count. @default ({ count }) => (count === 1 ? '1 row' : `${count} rows`), the count grouped for en-US */
+            rowCount: (args: {
+                count: number;
+            }) => string;
+            /** @default 'Duration' */
+            duration: string;
+            /** @default 'Dataset' */
+            dataset: string;
+            /** @default 'Dialect' */
+            dialect: string;
+            /** @default 'Executed' */
+            executedAt: string;
+        };
+    };
+    /** AIClarificationPrompt strings (`ai.clarificationPrompt.*`, F-15). Owner: workstream F. */
+    clarificationPrompt: {
+        /** The question by reason, used when the clarification carries no question of its own. */
+        question: {
+            /**
+             * `count` is the number of options, for a locale that pluralizes; the English text does not use it.
+             * R17 requirement copy (G-42+, protected: change only with product sign-off).
+             * @default ({ term }) => `Did you mean ${term}?`
+             */
+            ambiguousTerm: (args: {
+                count: number;
+                term: string;
+            }) => string;
+            /** R17 requirement copy (G-42+, protected). @default ({ term }) => `What about ${term}?` */
+            missingValue: (args: {
+                term: string;
+            }) => string;
+            /** @default ({ term }) => `Which “${term}” do you mean?` */
+            lowConfidence: (args: {
+                term: string;
+            }) => string;
+            /** @default ({ term }) => `No data source covers “${term}”. Which data do you want to use?` */
+            noSources: (args: {
+                term: string;
+            }) => string;
+            /** R17 requirement copy (G-42+, protected). @default ({ term }) => `What did you mean by ${term}?` */
+            unfamiliarTerm: (args: {
+                term: string;
+            }) => string;
+            /** Without a term, or for a reason this version does not know. @default 'Which of these do you mean?' */
+            generic: string;
+        };
+        /** The free-text option. @default 'Something else' */
+        other: string;
+        /** The free-text field's label. @default 'Describe what you meant' */
+        otherLabel: string;
+        /** The free-text field's helper text. @default 'Use a few words.' */
+        otherHelper: string;
+        /** @default 'Send answer' */
+        submit: string;
+        /** @default 'Sending answer…' */
+        submitting: string;
+        /** Shown when a required answer is missing. @default 'Choose an answer or describe what you meant.' */
+        requiredError: string;
+        /** Announced once when a streamed question becomes answerable. @default 'Question ready for your input' */
+        ready: string;
+        /** Why the controls are unavailable while streaming. @default 'The question is still being generated' */
+        streamingReason: string;
+        /** The summary after answering. @default ({ answer }) => `You answered: ${answer}` */
+        resolved: (args: {
+            answer: string;
+        }) => string;
+        /** @default "Couldn't send your answer." */
+        error: string;
+        /** @default 'Try again' */
+        retry: string;
+    };
+    /** AIFeedbackForm strings (`ai.feedbackForm.*`, F-16). Owner: workstream F. */
+    feedbackForm: {
+        /** @default 'Tell us what went wrong' */
+        title: string;
+        /** @default 'Problem type' */
+        categoriesLegend: string;
+        /** The label of each built-in category. */
+        category: {
+            /** @default 'Wrong number' */
+            wrongNumber: string;
+            /** @default 'Misread the question' */
+            wrongInterpretation: string;
+            /** @default 'Made-up content' */
+            synthetic: string;
+            /** @default 'Wrong or missing sources' */
+            sources: string;
+            /** @default 'Outdated data' */
+            outdatedData: string;
+            /** @default 'Hard to read' */
+            formatting: string;
+            /** @default 'Something else' */
+            other: string;
+        };
+        /** @default 'Details (optional)' */
+        comment: string;
+        /** @default 'Say what the answer should have been.' */
+        commentHelper: string;
+        /** @default 'Rerun with this correction' */
+        rerun: string;
+        /** @default 'Send feedback' */
+        submit: string;
+        /** @default 'Sending feedback…' */
+        submitting: string;
+        /** @default 'Cancel' */
+        cancel: string;
+        /** Shown when `requireCategory` is set and none is chosen. @default 'Choose at least one problem type.' */
+        requiredCategory: string;
+        /** @default "Couldn't send feedback." */
+        error: string;
+        /** @default 'Try again' */
+        retry: string;
+        /** The summary after sending. @default 'Thanks — sent for review' */
+        success: string;
+    };
+    /** AIFeedbackControl strings (`ai.feedbackControl.*`, F-17). Owner: workstream F. */
+    feedbackControl: {
+        /** The group's name. @default 'Rate this response' */
+        groupLabel: string;
+        /** The thumbs-up button's name and tooltip. @default 'Good response' */
+        positive: string;
+        /** The thumbs-down button's name and tooltip. @default 'Poor response' */
+        negative: string;
+        /** The button that opens the detailed feedback form. @default 'Tell us what went wrong' */
+        detailsTrigger: string;
+        /** The heading of the popover or dialog that holds the form. @default 'Tell us what went wrong' */
+        dialogTitle: string;
+        /** Announced, then shown, after detailed feedback is sent. @default 'Feedback sent' */
+        sent: string;
+        /** Why the control is unavailable, for example while the response streams. @default 'You can rate the response once it is complete.' */
+        disabledReason: string;
+    };
+    /**
+     * Strings of the helpers behind the interactive response blocks (`ai.blocks.*`, G-12). Plan
+     * review and clarification keep their own copy (`ai.planReview`, `ai.clarificationPrompt`).
+     * Owner: workstream G.
+     */
+    blocks: {
+        /**
+         * Announced once when an interactive block finishes streaming and becomes interactive, for a
+         * block with no better text of its own. @default 'Ready for your input'
+         */
+        ready: string;
+        /**
+         * Why the composer is unavailable while the latest answer asks a required question.
+         * @default 'Answer the question above to continue'
+         */
+        answerToContinue: string;
+    };
+    /**
+     * AIPlanReview strings (`ai.planReview.*`, G-18, G-42+). Owner: workstream G. `confirm`,
+     * `gatingNote` and `ready` are requirement copy (R5, R9): change them only with product sign-off.
+     */
+    planReview: {
+        /** The plan's heading, and the dialog's title in the dialog presentation. @default 'Proposed plan' */
+        title: string;
+        /** The plan's revision after a replan. @default ({ revision }) => `Revision ${revision}` */
+        revision: (args: {
+            revision: number;
+        }) => string;
+        /** How many steps the plan has, on the dialog presentation's card. @default ({ count }) => (count === 1 ? '1 step' : `${count} steps`) */
+        stepCount: (args: {
+            count: number;
+        }) => string;
+        /** The confirm button (R5). @default 'Confirm and run' */
+        confirm: string;
+        /** The confirm button while the confirm is pending. @default 'Confirming…' */
+        confirming: string;
+        /** The cancel button. @default 'Cancel' */
+        cancel: string;
+        /** Shown above the confirm button (R5). @default 'No query runs until you confirm the plan.' */
+        gatingNote: string;
+        /** The dialog presentation's trigger. @default 'Review plan' */
+        reviewPlan: string;
+        /** A step's metric chip. @default ({ value }) => `Metric: ${value}` */
+        metric: (args: {
+            value: string;
+        }) => string;
+        /** A step's field chip. @default ({ value }) => `Field: ${value}` */
+        field: (args: {
+            value: string;
+        }) => string;
+        /** A step's period chip. @default ({ value }) => `Period: ${value}` */
+        period: (args: {
+            value: string;
+        }) => string;
+        /** A step's filter chip; `label` is the filter in words. @default ({ label }) => `Filter: ${label}` */
+        filter: (args: {
+            label: string;
+        }) => string;
+        /** The visible text of a step's edit button. @default 'Edit' */
+        edit: string;
+        /** A step's edit button name; it starts with `edit` (WCAG 2.5.3). @default ({ n }) => `Edit step ${n}` */
+        editStep: (args: {
+            n: number;
+        }) => string;
+        /** A step's name: the edit field's label and the details term. @default ({ n }) => `Step ${n}` */
+        step: (args: {
+            n: number;
+        }) => string;
+        /** Saves a step edit. @default 'Save step' */
+        save: string;
+        /** Leaves a step edit without saving. @default 'Discard edit' */
+        discardEdit: string;
+        /** Announced after a step edit is saved. @default 'Step saved' */
+        saved: string;
+        /** Shown and announced when a step edit fails. @default "Couldn't save the step. Try again." */
+        saveError: string;
+        /** Shown when a step edit is empty. @default 'Enter the step.' */
+        required: string;
+        /** A step's status, shown as text beside its icon. */
+        status: {
+            /** @default 'Ready' */
+            ready: string;
+            /** @default 'Needs your input' */
+            needsInput: string;
+            /** @default 'Edited' */
+            edited: string;
+            /** @default 'Updating' */
+            replanning: string;
+        };
+        /** Shown on a step with low confidence; never blocks the confirm. @default 'Low confidence. Check this step.' */
+        lowConfidence: string;
+        /** Why Confirm and run is unavailable, shown and linked to it. */
+        gatingReason: {
+            /** @default 'The plan is still being written.' */
+            streaming: string;
+            /** @default 'The plan is being updated.' */
+            replanning: string;
+            /** @default ({ n }) => `Step ${n} is being updated.` */
+            stepReplanning: (args: {
+                n: number;
+            }) => string;
+            /** @default ({ n }) => `Answer the question in step ${n} to confirm.` */
+            answerStep: (args: {
+                n: number;
+            }) => string;
+            /** @default ({ n }) => `Edit step ${n} to confirm.` */
+            editStep: (args: {
+                n: number;
+            }) => string;
+        };
+        /** The plan's state when it is read-only. */
+        planStatus: {
+            /** @default 'Updating the plan…' */
+            replanning: string;
+            /** @default 'A newer version replaced this plan.' */
+            superseded: string;
+            /** @default 'Plan cancelled.' */
+            cancelled: string;
+        };
+        /** The summary after the plan is confirmed; it takes focus and is announced once. @default 'Plan confirmed. The query runs next.' */
+        resolved: string;
+        /** Announced once when a streamed plan becomes ready to review (R9). @default "Plan's ready — needs your confirmation" */
+        ready: string;
+        /** Shown when the confirm fails. @default "Couldn't confirm the plan." */
+        confirmError: string;
+        /** Shown when the cancel fails. @default "Couldn't cancel the plan." */
+        cancelError: string;
+        /** @default 'Try again' */
+        retry: string;
+        /** The details disclosure. @default 'Details' */
+        details: string;
+        /** Shown when the plan has no steps. @default 'The plan has no steps yet.' */
+        empty: string;
+    };
+    /**
+     * AIReviewItem strings (`ai.reviewItem.*`, G-19, G-42+): the golden-dataset review of one
+     * answer. Owner: workstream G. The reject reason's required message follows ConfirmDialog's
+     * (C-14) and waits for the same MICROCOPY review.
+     */
+    reviewItem: {
+        /** The item's review state, shown as a chip with an icon. */
+        status: {
+            /** The chip's label. @default 'Status' */
+            label: string;
+            /** @default 'Pending review' */
+            pending: string;
+            /** @default 'Approved' */
+            approved: string;
+            /** @default 'Edited' */
+            edited: string;
+            /** @default 'Rejected' */
+            rejected: string;
+        };
+        /** The terms of the item's details list. */
+        details: {
+            /** @default 'Asked by' */
+            submittedBy: string;
+            /** @default 'Asked' */
+            submittedAt: string;
+            /** @default 'Confidence' */
+            confidence: string;
+            /** @default 'Verification' */
+            verification: string;
+        };
+        /** The headings of the item's sections (the plan and the query bring their own). */
+        sections: {
+            /** @default 'Answer' */
+            answer: string;
+            /** @default 'User feedback' */
+            flags: string;
+            /** @default 'History' */
+            history: string;
+        };
+        /** One piece of user feedback on the answer. */
+        flag: {
+            /** A positive rating, beside its icon. @default 'Rated helpful' */
+            positive: string;
+            /** A negative rating, beside its icon. @default 'Rated not helpful' */
+            negative: string;
+            /** The name of a rating's problem types. @default 'Problems' */
+            categories: string;
+        };
+        /** The decision group's name. @default 'Decision' */
+        decisionsLabel: string;
+        /** The approve button. @default 'Approve' */
+        approve: string;
+        /** The approve button while the approval is pending. @default 'Approving…' */
+        approving: string;
+        /** The edit button. @default 'Edit' */
+        edit: string;
+        /** The reject button, and the reject dialog's confirm button. @default 'Reject' */
+        reject: string;
+        /** The heading of the edit form. @default 'Edit the item' */
+        editTitle: string;
+        /** The edit form's field labels. */
+        field: {
+            /** @default 'Question' */
+            question: string;
+            /** @default 'Query' */
+            query: string;
+            /** @default 'Answer' */
+            answer: string;
+        };
+        /**
+         * Under the answer field: an edited answer is sent as plain text, and the service rebuilds its
+         * structure. @default 'Plain text. Tables and charts are rebuilt after review.'
+         */
+        answerHelper: string;
+        /** Moves from the edit form to the changes; also the heading of that step. @default 'Review changes' */
+        reviewChanges: string;
+        /** Shown when Review changes finds no change. @default 'Change at least one field to review the changes.' */
+        noChanges: string;
+        /** Sends the edits. @default 'Submit changes' */
+        submitEdits: string;
+        /** The submit button while the edits are pending. @default 'Submitting…' */
+        submitting: string;
+        /** Returns from the changes to the edit form. @default 'Back to editing' */
+        backToEdit: string;
+        /** Leaves the edit without sending, and closes the reject dialog. @default 'Cancel' */
+        cancel: string;
+        /** The diff's title for the text before the edit. @default 'Before' */
+        diffBefore: string;
+        /** The diff's title for the text after the edit. @default 'After' */
+        diffAfter: string;
+        /** The name of one field's diff region. @default ({ field }) => `${field} changes` */
+        diffRegion: (args: {
+            field: string;
+        }) => string;
+        /** The reject dialog's title. @default 'Reject this answer?' */
+        rejectTitle: string;
+        /** The reject dialog's message. @default 'The reason is saved with the item.' */
+        rejectMessage: string;
+        /** The reject dialog's reason field. @default 'Reason' */
+        reasonLabel: string;
+        /** Shown on the reason field when it is empty (C-14). @default 'Enter a reason to continue.' */
+        reasonRequired: string;
+        /** Shown in the dialog when the rejection fails. @default "Couldn't reject the answer. Try again." */
+        rejectError: string;
+        /** Shown when the approval fails. @default "Couldn't approve the answer." */
+        approveError: string;
+        /** Shown when the edits fail. @default "Couldn't submit the changes." */
+        editError: string;
+        /** @default 'Try again' */
+        retry: string;
+        /** The summary after a decision; it is announced, and takes focus unless `focusOnResolve` is 'none'. */
+        resolved: {
+            /** @default 'Answer approved.' */
+            approved: string;
+            /** @default 'Changes submitted.' */
+            edited: string;
+            /** @default 'Answer rejected.' */
+            rejected: string;
+        };
+        /** Shown instead of the decisions when the reviewer cannot decide. @default "You can't decide on this item." */
+        blockedReason: string;
+        /** The history entries' text, beside an icon per kind. */
+        history: {
+            /** @default 'Submitted' */
+            submitted: string;
+            /** @default 'Flagged' */
+            flagged: string;
+            /** @default 'Approved' */
+            approved: string;
+            /** @default 'Edited' */
+            edited: string;
+            /** @default 'Rejected' */
+            rejected: string;
+            /** An entry with who did it. @default ({ action, actor }) => `${action} by ${actor}` */
+            byActor: (args: {
+                action: string;
+                actor: string;
+            }) => string;
+            /** An entry with its reason. @default ({ text, reason }) => `${text}: ${reason}` */
+            withReason: (args: {
+                text: string;
+                reason: string;
+            }) => string;
+        };
+    };
+    /**
+     * AIReviewQueueTemplate strings (`ai.reviewQueue.*`, H-25): the review queue around
+     * AIReviewItem (the status filter, the search, the rows' extra text, the empty, filtered-empty
+     * and error states, the announcements). Owner: workstream H. The item in the detail keeps
+     * `ai.reviewItem`; the status names, the field names and the problem types are read from
+     * `ai.reviewItem` and `ai.feedbackForm`, so one change reaches both.
+     *
+     * @since 2.13.0
+     */
+    reviewQueue: {
+        /** The status filter's legend. @default 'Status' */
+        filterLabel: string;
+        /**
+         * A status filter option with its count (`statusCounts`, or counted from `items`); without a
+         * count the option shows the status name alone. @default ({ label, count }) => `${label} (${count})`
+         */
+        statusOption: (args: {
+            label: string;
+            count: number;
+        }) => string;
+        /** The search field's name and placeholder. @default 'Search questions' */
+        search: string;
+        /** Name and tooltip of the button that clears the search. @default 'Clear search' */
+        clearSearch: string;
+        /** Name and tooltip of the button that closes the detail drawer of a narrow queue. @default 'Back to the list' */
+        back: string;
+        /** Visually hidden text of the list while it loads. @default 'Loading answers' */
+        loading: string;
+        /** The name of the detail drawer of a narrow queue, and of the detail while it scrolls. @default 'Answer review' */
+        detail: string;
+        /** The detail while nothing is selected. @default 'Select an answer to review it.' */
+        selectPrompt: string;
+        /**
+         * Announced after the search or the status filter changes: how many answers the list shows;
+         * the English default picks the plural form with `Intl.PluralRules('en-US')`.
+         * @default ({ count }) => 'No answers' (0), '1 answer' (one) or `${count} answers` (other)
+         */
+        resultsCount: (args: {
+            count: number;
+        }) => string;
+        /** The load-more button. @default 'Load more' */
+        loadMore: string;
+        /** The load-more button while more answers load. @default 'Loading more…' */
+        loadingMore: string;
+        /**
+         * Announced when a load-more adds answers.
+         * @default ({ count }) => '1 more answer loaded' (one) or `${count} more answers loaded` (other)
+         */
+        moreLoaded: (args: {
+            count: number;
+        }) => string;
+        /**
+         * A row's number of user flags, beside a flag icon.
+         * @default ({ count }) => '1 flag' (one) or `${count} flags` (other)
+         */
+        flagCount: (args: {
+            count: number;
+        }) => string;
+        /** The heading of the empty queue. @default 'No answers to review' */
+        emptyTitle: string;
+        /** The text of the empty queue. @default 'Flagged answers will appear here.' */
+        emptyDescription: string;
+        /** The heading when the search or the filter matches nothing (MICROCOPY, empty list). @default 'No results' */
+        filteredEmptyTitle: string;
+        /** The text when the search or the filter matches nothing. @default 'Try a different search term or clear filters.' */
+        filteredEmptyDescription: string;
+        /** Clears the search and the status filter. @default 'Clear filters' */
+        clearFilters: string;
+        /** The heading when the queue failed to load. @default "Couldn't load the review queue" */
+        errorTitle: string;
+        /** The text when the queue failed to load. @default 'Check your connection and try again.' */
+        errorDescription: string;
+        /** The retry button while the retry runs (its idle text is `ai.common.tryAgain`). @default 'Trying again…' */
+        retrying: string;
+        /**
+         * Announced after a decision when the queue moves on: the item's summary
+         * (`ai.reviewItem.resolved.*`) and how many answers the list still shows.
+         * @default ({ resolved, count }) => `${resolved} The list is empty.` (0), `${resolved} 1 answer left in the list.` (one) or `${resolved} ${count} answers left in the list.` (other)
+         */
+        afterDecision: (args: {
+            resolved: string;
+            count: number;
+        }) => string;
+    };
+    /**
+     * AICopilotPattern strings (`ai.copilotPattern.*`, H-29): the names of the regions the pattern
+     * adds around its organisms (ADR-12 (3): region labels come from strings). Owner: workstream H.
+     * The organisms inside keep their own groups (`ai.insightEngine`, `ai.chatThread`, ...).
+     *
+     * @since 2.13.0
+     */
+    copilotPattern: {
+        /**
+         * The name of the group around the app's controls in the panel header
+         * (`renderHeaderActions`). @default 'Conversation actions'
+         */
+        headerActions: string;
+    };
+    /**
+     * AIChatWelcome strings (`ai.chatWelcome.*`): the AI start screen shown before the first
+     * message (both variants, `'showcase'` and `'context'`). Owner: workstream G. The component
+     * holds no literal; a per-instance prop (`greeting`, `disclaimer`) wins.
+     *
+     * @since 2.13.0
+     */
+    chatWelcome: {
+        /** The greeting heading without a user name. @default 'How can I help you today?' */
+        greeting: string;
+        /** The greeting heading with the user's name (`userName`). @default ({ name }) => `Hi ${name}, how can I help you today?` */
+        greetingWithName: (args: {
+            name: string;
+        }) => string;
+        /** The name of the suggestion list (the showcase cards, the docked pills). @default 'Suggestions' */
+        suggestionsLabel: string;
+        /** The heading of the recent threads section (context). @default 'Continue' */
+        continueTitle: string;
+        /** The heading of the proactive updates section (context). @default 'New since yesterday' */
+        updatesTitle: string;
+        /** The heading of the category chips section (context). @default 'Try asking' */
+        tryAskingTitle: string;
+        /** The name of the scope chips' group on the composer (context). @default 'Scope' */
+        scopeLabel: string;
+        /** A scope chip's text: its label and value. @default ({ label, value }) => `${label}: ${value}` */
+        scopeItem: (args: {
+            label: string;
+            value: string;
+        }) => string;
+        /** The disclaimer line of the showcase variant. @default 'AI can make mistakes. Check important information.' */
+        disclaimer: string;
+        /** The trust note of the context variant. @default 'Answers cite your sources. Check important information.' */
+        trustNote: string;
+        /** The usage guidelines link after the disclaimer (with `guidelinesHref`). @default 'Usage guidelines' */
+        guidelinesLink: string;
+    };
+}
+//# sourceMappingURL=hitl.d.ts.map