@pixerate/editor 0.80.0 → 0.81.0

package/dist/generation/index.d.ts

@@ -2,9 +2,9 @@ import { J as JsonSchema } from '../schema-Di0CS6Pe.js';
 export { S as SchemaValidationError, v as validateJsonSchema } from '../schema-Di0CS6Pe.js';
 import { A as AgentToolProvider } from '../registry-7AZFuand.js';
 export { b as AgentTool, M as McpToolDefinition, a as McpToolResult } from '../registry-7AZFuand.js';
-import { S as SourceMapSegment } from '../sourcemap-DA1Evhrv.js';
 import { T as Template, P as PromptValues } from '../tokens-D7yXvUU6.js';
 import { S as StorageAdapter } from '../storage-BpFfspHm.js';
+import { S as SourceMapSegment } from '../sourcemap-DA1Evhrv.js';
 export { a as MentionRoleSyntax, T as TextMention, f as findTextMentions, b as formatMentionText, s as setMentionRoleInText } from '../mention-text-CDnCFd3c.js';
 
 /**
@@ -399,244 +399,6 @@ interface GenerationToolProvider extends AgentToolProvider {
  */
 declare function createGenerationToolProvider(options: GenerationToolProviderOptions): GenerationToolProvider;
 
-declare const PROVENANCE_FORMAT = "pixerate.generation-provenance";
-declare const PROVENANCE_VERSION = 1;
-/** The exact template body a generation used. */
-interface PinnedTemplate {
-    name: string;
-    templateId?: string;
-    /** Version id or version label the body came from (absent for unversioned templates). */
-    versionId?: string;
-    version?: string | number;
-    body: string;
-}
-/** Everything needed to explain and reproduce one generation. */
-interface GenerationProvenance {
-    format: typeof PROVENANCE_FORMAT;
-    version: typeof PROVENANCE_VERSION;
-    /** Raw prompt as typed, with `{{templates}}` and `{variables}`. */
-    rawPrompt: string;
-    /** Every template the prompt reached (recursively), pinned to the body used. */
-    templates: PinnedTemplate[];
-    /** Version bindings in effect (`{ templateName: versionId }`) for every pinned versioned template. */
-    bindings: Record<string, string>;
-    /** Variable values, or `null` when variables were left unresolved. */
-    values: PromptValues | null;
-    resolvedPrompt: string;
-    sourceMap: SourceMapSegment[];
-    modelId: string;
-    /** The planned (adjusted) request that was sent. */
-    request: GenerationRequest;
-    adjustments: PlanAdjustment[];
-    references: {
-        id: string;
-        role: ReferenceRole;
-    }[];
-    /** ISO timestamps. */
-    createdAt: string;
-    startedAt?: string;
-    completedAt?: string;
-    /** Ids of the outputs this generation produced. */
-    outputIds?: string[];
-    meta?: Record<string, unknown>;
-}
-interface CreateProvenanceOptions {
-    rawPrompt: string;
-    templates?: Template[];
-    /** Template version bindings (`{ templateName: versionIdOrVersion }`). */
-    bindings?: Record<string, string>;
-    values?: PromptValues;
-    model: string | ModelCapabilities;
-    /** The plan the request came from (its request and adjustments are recorded) … */
-    plan?: GenerationPlan;
-    /** … or the request that was sent. */
-    request?: GenerationRequest;
-    adjustments?: PlanAdjustment[];
-    /** Creation time (default `Date.now()`). */
-    createdAt?: Date | number | string;
-    startedAt?: Date | number | string;
-    completedAt?: Date | number | string;
-    outputIds?: string[];
-    meta?: Record<string, unknown>;
-    maxDepth?: number;
-}
-declare class ProvenanceParseError extends Error {
-    constructor(message: string);
-}
-/** Templates that reproduce the pinned bodies exactly (one single-version template each). */
-declare function pinnedTemplatesToTemplates(pinned: readonly PinnedTemplate[]): Template[];
-/**
- * Records what produced an output: the raw prompt, the exact template bodies
- * and versions it reached, variable values, the resolved prompt and its
- * source map, the model, the planned settings and adjustments, and the
- * references by role.
- */
-declare function createProvenance(options: CreateProvenanceOptions): GenerationProvenance;
-/** Versioned JSON for storage next to an output. */
-declare function serializeProvenance(provenance: GenerationProvenance): string;
-/** Parses and checks serialized provenance. Throws {@link ProvenanceParseError}. */
-declare function parseProvenance(input: string | unknown): GenerationProvenance;
-/**
- * Re-resolves the raw prompt against the pinned template bodies and values,
- * e.g. to check a record or to open it in an editor with its source map.
- */
-declare function replayProvenancePrompt(provenance: GenerationProvenance): {
-    text: string;
-    map: SourceMapSegment[];
-    matches: boolean;
-};
-
-interface BatchResolverOptions<K, V> {
-    /** Loads many keys at once. Keys missing from the map resolve to `undefined`. */
-    fetch: (keys: K[]) => Promise<Map<K, V>>;
-    /** Largest batch passed to `fetch` (default 50). */
-    maxBatch?: number;
-    /** How long to collect keys before fetching, in ms (default 0: the same tick). */
-    delayMs?: number;
-    /** Called once per failed batch. The batch's keys are recorded as resolved-empty. */
-    onError?: (error: unknown, keys: K[]) => void;
-}
-interface BatchResolver<K, V> {
-    /** Resolves one key, batched with other loads in the same window. Never rejects. */
-    load(key: K): Promise<V | undefined>;
-    loadMany(keys: readonly K[]): Promise<(V | undefined)[]>;
-    /** The settled value for a key, if it has been resolved. */
-    peek(key: K): V | undefined;
-    /** Whether a key has settled (found, missing or failed). */
-    has(key: K): boolean;
-    /** Whether a key's last fetch failed. */
-    failed(key: K): boolean;
-    /** Seeds a value without fetching. */
-    prime(key: K, value: V): void;
-    /** Forgets one key (or all) so the next `load` fetches again. */
-    clear(key?: K): void;
-    /** Fetches anything still waiting now, without waiting for `delayMs`. */
-    flush(): void;
-}
-/**
- * Coalesces lookups (e.g. asset ids → thumbnails, template ids → bodies) into
- * batched `fetch` calls: keys requested within `delayMs` share a batch of at
- * most `maxBatch`, duplicate keys are fetched once, and results are cached.
- * A failed batch resolves its keys to `undefined` and records them as
- * resolved-empty (`failed(key)` is `true`) so one bad response does not cause
- * a retry storm; `clear(key)` allows a retry.
- */
-declare function createBatchResolver<K, V>(options: BatchResolverOptions<K, V>): BatchResolver<K, V>;
-
-interface JobProgressInput {
-    /** Start time (ms since epoch, `Date` or ISO string). */
-    startedAt: number | Date | string;
-    /** Current time (default `Date.now()`). */
-    now?: number | Date | string;
-    /** Expected total duration in ms. Without it progress eases towards 95%. */
-    expectedMs?: number;
-    /** The job finished. */
-    done?: boolean;
-}
-interface JobProgressEstimate {
-    /** 0–100. Never above 95 until `done`. */
-    percent: number;
-    /** E.g. `~2m left`, `~40s left`, `Almost done…`, `Starting…`, `Done`. */
-    label: string;
-    elapsedMs: number;
-    /** Estimated ms left (`undefined` without `expectedMs`). */
-    remainingMs?: number;
-    /** Running longer than expected. */
-    overdue: boolean;
-}
-/** Highest percentage shown before a job reports completion. */
-declare const MAX_PENDING_PERCENT = 95;
-/** `~45s left`, `~2m left`, `~1h 5m left`. Minutes and seconds round up. */
-declare function formatRemaining(ms: number): string;
-/**
- * Progress for a job that reports no progress of its own: linear in elapsed
- * time over `expectedMs`, held at 95% until `done` (so the bar never sits at
- * 100% while still waiting), with a "~2m left" style label that turns into
- * "Almost done…" near or past the expected end. Pure: pass `now` to test.
- */
-declare function estimateJobProgress(input: JobProgressInput): JobProgressEstimate;
-/**
- * Expected duration of a request from the model's `timing`: `baseMs`, plus
- * `perItemMs` per output beyond the first, `perSecondMs` per second of
- * duration and `perMegapixelMs` per megapixel of resolution. `undefined` when
- * the model has no timing.
- */
-declare function expectedDurationFor(caps: ModelCapabilities, request?: GenerationRequest): number | undefined;
-
-interface GenerationControlOption {
-    value: string | number;
-    label: string;
-}
-/**
- * A UI control derived from capabilities. `key` is a request path:
- * `aspectRatio`, `count`, `params.guidance`, …
- */
-interface GenerationControl {
-    key: string;
-    label: string;
-    /** `select` for choices, `range` for bounded numbers, `number` for open numbers. */
-    kind: 'select' | 'range' | 'number' | 'textarea' | 'checkbox';
-    valueType: 'string' | 'number' | 'boolean';
-    options?: GenerationControlOption[];
-    min?: number;
-    max?: number;
-    step?: number;
-    maxLength?: number;
-    defaultValue?: string | number | boolean;
-    description?: string;
-}
-interface ReferenceSlot {
-    role: ReferenceRole;
-    label: string;
-    description?: string;
-    min: number;
-    max: number;
-    /** Media accepted for this role (see `ReferenceRoleCapability.accepts`). */
-    accepts?: string[];
-    references: GenerationReference[];
-    /** More references of this role fit (per role and in total). */
-    canAdd: boolean;
-}
-/**
- * The settings controls a model supports, in display order. Excludes the
- * prompt (edited by the prompt editor) and references (see
- * {@link getReferenceSlots}).
- */
-declare function getGenerationControls(caps: ModelCapabilities): GenerationControl[];
-/** Reads a request value by control key (`params.x` reads a param). */
-declare function getRequestValue(request: GenerationRequest, key: string): unknown;
-/** Returns a copy of `request` with `key` set (`undefined` or `''` removes it). */
-declare function setRequestValue(request: GenerationRequest, key: string, value: unknown): GenerationRequest;
-/** Parses a DOM control's string value into the control's value type. */
-declare function parseControlValue(control: GenerationControl, raw: string | boolean): string | number | boolean | undefined;
-/** Reference slots for every role the model accepts, filled from `request`. */
-declare function getReferenceSlots(caps: ModelCapabilities, request?: GenerationRequest): ReferenceSlot[];
-/** Returns a copy of `request` with a reference appended. */
-declare function addReference(request: GenerationRequest, reference: GenerationReference): GenerationRequest;
-/** Returns a copy of `request` without the reference `id` in `role`. */
-declare function removeReference(request: GenerationRequest, role: ReferenceRole, id: string): GenerationRequest;
-
-/**
- * Stable JSON: object keys sorted, `undefined` members left out, so equal
- * values always give the same string regardless of key order.
- */
-declare function stableStringify(value: unknown): string;
-/**
- * A short, stable, synchronous content hash (two independent 32-bit FNV-1a
- * lanes over the UTF-16 code units, 16 hex digits, prefixed with `h1-`).
- * It detects changes; it is not cryptographic, so do not use it to
- * authenticate content.
- */
-declare function hashText(text: string): string;
-/** {@link hashText} of the {@link stableStringify} form of `value`. */
-declare function hashValue(value: unknown): string;
-/**
- * Hash of what a model accepts. Presentation fields (`name`, `description`,
- * `badges`, `icon`, `group`) and `timing` are left out, so renaming a model or
- * changing its progress estimate is not reported as a capability change.
- */
-declare function hashCapabilities(caps: ModelCapabilities): string;
-
 /** A role a model accepts for asset mentions / references, for pickers. */
 interface AssetRoleOption {
     role: ReferenceRole;
@@ -733,6 +495,93 @@ declare function describeAssetMentions(mentions: readonly {
     start?: number;
 }[], assets: readonly AssetInfo[], caps?: ModelCapabilities): AssetMentionChip[];
 
+declare const PROVENANCE_FORMAT = "pixerate.generation-provenance";
+declare const PROVENANCE_VERSION = 1;
+/** The exact template body a generation used. */
+interface PinnedTemplate {
+    name: string;
+    templateId?: string;
+    /** Version id or version label the body came from (absent for unversioned templates). */
+    versionId?: string;
+    version?: string | number;
+    body: string;
+}
+/** Everything needed to explain and reproduce one generation. */
+interface GenerationProvenance {
+    format: typeof PROVENANCE_FORMAT;
+    version: typeof PROVENANCE_VERSION;
+    /** Raw prompt as typed, with `{{templates}}` and `{variables}`. */
+    rawPrompt: string;
+    /** Every template the prompt reached (recursively), pinned to the body used. */
+    templates: PinnedTemplate[];
+    /** Version bindings in effect (`{ templateName: versionId }`) for every pinned versioned template. */
+    bindings: Record<string, string>;
+    /** Variable values, or `null` when variables were left unresolved. */
+    values: PromptValues | null;
+    resolvedPrompt: string;
+    sourceMap: SourceMapSegment[];
+    modelId: string;
+    /** The planned (adjusted) request that was sent. */
+    request: GenerationRequest;
+    adjustments: PlanAdjustment[];
+    references: {
+        id: string;
+        role: ReferenceRole;
+    }[];
+    /** ISO timestamps. */
+    createdAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    /** Ids of the outputs this generation produced. */
+    outputIds?: string[];
+    meta?: Record<string, unknown>;
+}
+interface CreateProvenanceOptions {
+    rawPrompt: string;
+    templates?: Template[];
+    /** Template version bindings (`{ templateName: versionIdOrVersion }`). */
+    bindings?: Record<string, string>;
+    values?: PromptValues;
+    model: string | ModelCapabilities;
+    /** The plan the request came from (its request and adjustments are recorded) … */
+    plan?: GenerationPlan;
+    /** … or the request that was sent. */
+    request?: GenerationRequest;
+    adjustments?: PlanAdjustment[];
+    /** Creation time (default `Date.now()`). */
+    createdAt?: Date | number | string;
+    startedAt?: Date | number | string;
+    completedAt?: Date | number | string;
+    outputIds?: string[];
+    meta?: Record<string, unknown>;
+    maxDepth?: number;
+}
+declare class ProvenanceParseError extends Error {
+    constructor(message: string);
+}
+/** Templates that reproduce the pinned bodies exactly (one single-version template each). */
+declare function pinnedTemplatesToTemplates(pinned: readonly PinnedTemplate[]): Template[];
+/**
+ * Records what produced an output: the raw prompt, the exact template bodies
+ * and versions it reached, variable values, the resolved prompt and its
+ * source map, the model, the planned settings and adjustments, and the
+ * references by role.
+ */
+declare function createProvenance(options: CreateProvenanceOptions): GenerationProvenance;
+/** Versioned JSON for storage next to an output. */
+declare function serializeProvenance(provenance: GenerationProvenance): string;
+/** Parses and checks serialized provenance. Throws {@link ProvenanceParseError}. */
+declare function parseProvenance(input: string | unknown): GenerationProvenance;
+/**
+ * Re-resolves the raw prompt against the pinned template bodies and values,
+ * e.g. to check a record or to open it in an editor with its source map.
+ */
+declare function replayProvenancePrompt(provenance: GenerationProvenance): {
+    text: string;
+    map: SourceMapSegment[];
+    matches: boolean;
+};
+
 declare const GENERATION_RECORD_FORMAT = "pixerate.generation-record";
 declare const GENERATION_RECORD_VERSION = 1;
 /** How a record came about. */
@@ -1012,4 +861,181 @@ declare function matchesRecordFilter(summary: GenerationRecordSummary, filter?:
  */
 declare function createGenerationRecordStore(options: GenerationRecordStoreOptions): GenerationRecordStore;
 
-export { AgentToolProvider, type AssetInfo, type AssetLookup, type AssetMentionChip, type AssetMentionIssue, type AssetMentionIssueCode, type AssetMentionValidation, type AssetRoleOption, type BatchResolver, type BatchResolverOptions, type BooleanParamSpec, type BuiltinReferenceRole, type CapabilityOverlay, type CapabilityPresentation, type CountCapability, type CreateGenerationRecordOptions, type CreateProvenanceOptions, DRIFT_TYPE_LABELS, type DriftItem, type DriftType, type DurationCapability, type EnumCapability, type EnumParamSpec, type EstimateContext, type ExtraParamSpec, GENERATION_RECORD_FORMAT, GENERATION_RECORD_VERSION, GENERATION_REQUEST_FIELDS, type GenerateContext, type GenerationControl, type GenerationControlOption, type GenerationMediaKind, type GenerationMode, type GenerationParamValue, type GenerationPlan, type GenerationProvenance, type GenerationRecord, type GenerationRecordFilter, type GenerationRecordKind, type GenerationRecordStore, type GenerationRecordStoreOptions, type GenerationRecordSummary, type GenerationReference, type GenerationRequest, type GenerationToolProvider, type GenerationToolProviderOptions, type JobProgressEstimate, type JobProgressInput, JsonSchema, MAX_PENDING_PERCENT, type ModelCapabilities, type NumberParamSpec, PROVENANCE_FORMAT, PROVENANCE_VERSION, type PinnedTemplate, type PlanAdjustment, type PlanAdjustmentKind, type PlanAssetMention, type PlanError, type PlanOptions, type PlanStrategy, type PromptCapability, ProvenanceParseError, type PruneOptions, QUALITY_LADDER, REFERENCE_ROLES, REFERENCE_ROLE_ALIASES, REFERENCE_ROLE_LABELS, REFERENCE_ROLE_NAME_REGEX, type RecordedAsset, type RecordedTemplate, type RecreateMode, type RecreateOptions, type RecreateResult, type ReferenceCapability, type ReferenceRole, type ReferenceRoleCapability, type ReferenceSlot, type SeedCapability, type TextFieldCapability, type TimingCapability, type VariationOverrides, addReference, aspectRatioRank, blockingDrift, capabilitiesToJsonSchema, completeGenerationRecord, createBatchResolver, createGenerationRecord, createGenerationRecordId, createGenerationRecordStore, createGenerationToolProvider, createProvenance, defaultAssetRoleOptions, describeAssetMentions, estimateJobProgress, expectedDurationFor, formatRemaining, getAssetRoleOptions, getGenerationControls, getReferenceSlots, getRequestValue, hashCapabilities, hashText, hashValue, isGenerationRecord, isReferenceRoleName, matchesRecordFilter, mediaTypeMatches, mergeCapabilities, normalizeReferenceRole, parseControlValue, parseGenerationRecord, parseProvenance, pinnedTemplatesToTemplates, planGenerationRequest, qualityRank, recreateRequest, referenceRoleLabel, removeReference, replayProvenancePrompt, resolutionMegapixels, resolutionRank, resolveAssetMentions, seedCapability, serializeGenerationRecord, serializeProvenance, setRequestValue, snapToOption, stableStringify, summarizeGenerationRecord, supportedModes, supportedReferenceRoles, textFieldCapability, toAssetResolver, validateAssetMentions, variationRequest };
+interface GenerationHistoryToolProviderOptions {
+    /** Provider id (default `generation-history`). */
+    id?: string;
+    namespace?: string;
+    /** Where the generation records live. */
+    store: GenerationRecordStore;
+    /** Current models, to re-plan recreated requests and report drift (as `recreateRequest`'s `capabilities`). */
+    models?: readonly ModelCapabilities[] | (() => readonly ModelCapabilities[]);
+    /** Current templates, to report edits and resolve in `latest` mode. */
+    templates?: readonly Template[] | (() => readonly Template[]);
+    /** Current assets, to report missing or changed references (a lookup function stays live). */
+    assets?: AssetLookup;
+}
+/**
+ * Agent tools over a `GenerationRecordStore`, the history behind the generation history
+ * panel. All are read-only: `recreate_generation` and `vary_generation` return a request to
+ * pass to `generate` (from `createGenerationToolProvider`), so spending stays behind its
+ * idempotency key.
+ *
+ * - `list_generations {model?, template?, text?, kind?, limit?, offset?}`: summaries, newest first.
+ * - `get_generation {id}`: the full record (prompt, settings, seed, assets, templates).
+ * - `recreate_generation {id, mode?}`: the request that reproduces a record, with drift.
+ * - `vary_generation {id, seed?, values?, settings?}`: the same request with a new seed or changes.
+ */
+declare function createGenerationHistoryToolProvider(options: GenerationHistoryToolProviderOptions): AgentToolProvider;
+
+interface BatchResolverOptions<K, V> {
+    /** Loads many keys at once. Keys missing from the map resolve to `undefined`. */
+    fetch: (keys: K[]) => Promise<Map<K, V>>;
+    /** Largest batch passed to `fetch` (default 50). */
+    maxBatch?: number;
+    /** How long to collect keys before fetching, in ms (default 0: the same tick). */
+    delayMs?: number;
+    /** Called once per failed batch. The batch's keys are recorded as resolved-empty. */
+    onError?: (error: unknown, keys: K[]) => void;
+}
+interface BatchResolver<K, V> {
+    /** Resolves one key, batched with other loads in the same window. Never rejects. */
+    load(key: K): Promise<V | undefined>;
+    loadMany(keys: readonly K[]): Promise<(V | undefined)[]>;
+    /** The settled value for a key, if it has been resolved. */
+    peek(key: K): V | undefined;
+    /** Whether a key has settled (found, missing or failed). */
+    has(key: K): boolean;
+    /** Whether a key's last fetch failed. */
+    failed(key: K): boolean;
+    /** Seeds a value without fetching. */
+    prime(key: K, value: V): void;
+    /** Forgets one key (or all) so the next `load` fetches again. */
+    clear(key?: K): void;
+    /** Fetches anything still waiting now, without waiting for `delayMs`. */
+    flush(): void;
+}
+/**
+ * Coalesces lookups (e.g. asset ids → thumbnails, template ids → bodies) into
+ * batched `fetch` calls: keys requested within `delayMs` share a batch of at
+ * most `maxBatch`, duplicate keys are fetched once, and results are cached.
+ * A failed batch resolves its keys to `undefined` and records them as
+ * resolved-empty (`failed(key)` is `true`) so one bad response does not cause
+ * a retry storm; `clear(key)` allows a retry.
+ */
+declare function createBatchResolver<K, V>(options: BatchResolverOptions<K, V>): BatchResolver<K, V>;
+
+interface JobProgressInput {
+    /** Start time (ms since epoch, `Date` or ISO string). */
+    startedAt: number | Date | string;
+    /** Current time (default `Date.now()`). */
+    now?: number | Date | string;
+    /** Expected total duration in ms. Without it progress eases towards 95%. */
+    expectedMs?: number;
+    /** The job finished. */
+    done?: boolean;
+}
+interface JobProgressEstimate {
+    /** 0–100. Never above 95 until `done`. */
+    percent: number;
+    /** E.g. `~2m left`, `~40s left`, `Almost done…`, `Starting…`, `Done`. */
+    label: string;
+    elapsedMs: number;
+    /** Estimated ms left (`undefined` without `expectedMs`). */
+    remainingMs?: number;
+    /** Running longer than expected. */
+    overdue: boolean;
+}
+/** Highest percentage shown before a job reports completion. */
+declare const MAX_PENDING_PERCENT = 95;
+/** `~45s left`, `~2m left`, `~1h 5m left`. Minutes and seconds round up. */
+declare function formatRemaining(ms: number): string;
+/**
+ * Progress for a job that reports no progress of its own: linear in elapsed
+ * time over `expectedMs`, held at 95% until `done` (so the bar never sits at
+ * 100% while still waiting), with a "~2m left" style label that turns into
+ * "Almost done…" near or past the expected end. Pure: pass `now` to test.
+ */
+declare function estimateJobProgress(input: JobProgressInput): JobProgressEstimate;
+/**
+ * Expected duration of a request from the model's `timing`: `baseMs`, plus
+ * `perItemMs` per output beyond the first, `perSecondMs` per second of
+ * duration and `perMegapixelMs` per megapixel of resolution. `undefined` when
+ * the model has no timing.
+ */
+declare function expectedDurationFor(caps: ModelCapabilities, request?: GenerationRequest): number | undefined;
+
+interface GenerationControlOption {
+    value: string | number;
+    label: string;
+}
+/**
+ * A UI control derived from capabilities. `key` is a request path:
+ * `aspectRatio`, `count`, `params.guidance`, …
+ */
+interface GenerationControl {
+    key: string;
+    label: string;
+    /** `select` for choices, `range` for bounded numbers, `number` for open numbers. */
+    kind: 'select' | 'range' | 'number' | 'textarea' | 'checkbox';
+    valueType: 'string' | 'number' | 'boolean';
+    options?: GenerationControlOption[];
+    min?: number;
+    max?: number;
+    step?: number;
+    maxLength?: number;
+    defaultValue?: string | number | boolean;
+    description?: string;
+}
+interface ReferenceSlot {
+    role: ReferenceRole;
+    label: string;
+    description?: string;
+    min: number;
+    max: number;
+    /** Media accepted for this role (see `ReferenceRoleCapability.accepts`). */
+    accepts?: string[];
+    references: GenerationReference[];
+    /** More references of this role fit (per role and in total). */
+    canAdd: boolean;
+}
+/**
+ * The settings controls a model supports, in display order. Excludes the
+ * prompt (edited by the prompt editor) and references (see
+ * {@link getReferenceSlots}).
+ */
+declare function getGenerationControls(caps: ModelCapabilities): GenerationControl[];
+/** Reads a request value by control key (`params.x` reads a param). */
+declare function getRequestValue(request: GenerationRequest, key: string): unknown;
+/** Returns a copy of `request` with `key` set (`undefined` or `''` removes it). */
+declare function setRequestValue(request: GenerationRequest, key: string, value: unknown): GenerationRequest;
+/** Parses a DOM control's string value into the control's value type. */
+declare function parseControlValue(control: GenerationControl, raw: string | boolean): string | number | boolean | undefined;
+/** Reference slots for every role the model accepts, filled from `request`. */
+declare function getReferenceSlots(caps: ModelCapabilities, request?: GenerationRequest): ReferenceSlot[];
+/** Returns a copy of `request` with a reference appended. */
+declare function addReference(request: GenerationRequest, reference: GenerationReference): GenerationRequest;
+/** Returns a copy of `request` without the reference `id` in `role`. */
+declare function removeReference(request: GenerationRequest, role: ReferenceRole, id: string): GenerationRequest;
+
+/**
+ * Stable JSON: object keys sorted, `undefined` members left out, so equal
+ * values always give the same string regardless of key order.
+ */
+declare function stableStringify(value: unknown): string;
+/**
+ * A short, stable, synchronous content hash (two independent 32-bit FNV-1a
+ * lanes over the UTF-16 code units, 16 hex digits, prefixed with `h1-`).
+ * It detects changes; it is not cryptographic, so do not use it to
+ * authenticate content.
+ */
+declare function hashText(text: string): string;
+/** {@link hashText} of the {@link stableStringify} form of `value`. */
+declare function hashValue(value: unknown): string;
+/**
+ * Hash of what a model accepts. Presentation fields (`name`, `description`,
+ * `badges`, `icon`, `group`) and `timing` are left out, so renaming a model or
+ * changing its progress estimate is not reported as a capability change.
+ */
+declare function hashCapabilities(caps: ModelCapabilities): string;
+
+export { AgentToolProvider, type AssetInfo, type AssetLookup, type AssetMentionChip, type AssetMentionIssue, type AssetMentionIssueCode, type AssetMentionValidation, type AssetRoleOption, type BatchResolver, type BatchResolverOptions, type BooleanParamSpec, type BuiltinReferenceRole, type CapabilityOverlay, type CapabilityPresentation, type CountCapability, type CreateGenerationRecordOptions, type CreateProvenanceOptions, DRIFT_TYPE_LABELS, type DriftItem, type DriftType, type DurationCapability, type EnumCapability, type EnumParamSpec, type EstimateContext, type ExtraParamSpec, GENERATION_RECORD_FORMAT, GENERATION_RECORD_VERSION, GENERATION_REQUEST_FIELDS, type GenerateContext, type GenerationControl, type GenerationControlOption, type GenerationHistoryToolProviderOptions, type GenerationMediaKind, type GenerationMode, type GenerationParamValue, type GenerationPlan, type GenerationProvenance, type GenerationRecord, type GenerationRecordFilter, type GenerationRecordKind, type GenerationRecordStore, type GenerationRecordStoreOptions, type GenerationRecordSummary, type GenerationReference, type GenerationRequest, type GenerationToolProvider, type GenerationToolProviderOptions, type JobProgressEstimate, type JobProgressInput, JsonSchema, MAX_PENDING_PERCENT, type ModelCapabilities, type NumberParamSpec, PROVENANCE_FORMAT, PROVENANCE_VERSION, type PinnedTemplate, type PlanAdjustment, type PlanAdjustmentKind, type PlanAssetMention, type PlanError, type PlanOptions, type PlanStrategy, type PromptCapability, ProvenanceParseError, type PruneOptions, QUALITY_LADDER, REFERENCE_ROLES, REFERENCE_ROLE_ALIASES, REFERENCE_ROLE_LABELS, REFERENCE_ROLE_NAME_REGEX, type RecordedAsset, type RecordedTemplate, type RecreateMode, type RecreateOptions, type RecreateResult, type ReferenceCapability, type ReferenceRole, type ReferenceRoleCapability, type ReferenceSlot, type SeedCapability, type TextFieldCapability, type TimingCapability, type VariationOverrides, addReference, aspectRatioRank, blockingDrift, capabilitiesToJsonSchema, completeGenerationRecord, createBatchResolver, createGenerationHistoryToolProvider, createGenerationRecord, createGenerationRecordId, createGenerationRecordStore, createGenerationToolProvider, createProvenance, defaultAssetRoleOptions, describeAssetMentions, estimateJobProgress, expectedDurationFor, formatRemaining, getAssetRoleOptions, getGenerationControls, getReferenceSlots, getRequestValue, hashCapabilities, hashText, hashValue, isGenerationRecord, isReferenceRoleName, matchesRecordFilter, mediaTypeMatches, mergeCapabilities, normalizeReferenceRole, parseControlValue, parseGenerationRecord, parseProvenance, pinnedTemplatesToTemplates, planGenerationRequest, qualityRank, recreateRequest, referenceRoleLabel, removeReference, replayProvenancePrompt, resolutionMegapixels, resolutionRank, resolveAssetMentions, seedCapability, serializeGenerationRecord, serializeProvenance, setRequestValue, snapToOption, stableStringify, summarizeGenerationRecord, supportedModes, supportedReferenceRoles, textFieldCapability, toAssetResolver, validateAssetMentions, variationRequest };