@stndrds/schema 1.0.0-alpha.347 → 1.0.0-alpha.348

package/dist/index.d.mts

@@ -1,13 +1,13 @@
 
-import { $ as AttributeGroup, $t as asUserId, A as SchemaErrorCode, An as ComputedFunctionName, At as SelectAttribute, B as ValidationErrorDetail, Bn as ComputedFormulaBinaryNode, Bt as isBilateralRelation, C as RecordReference, Cn as ComputedCompileSchema, Ct as RELATION_TARGET_ANY, D as ReservedObjectNameError, Dn as compileComputedFormula, Dt as RichtextAttribute, E as RepositoryOperation, En as assertAcyclicComputedDependencies, Et as RichTextAttribute, F as SyncCascadeError, Fn as ComputedOptionsSource, Ft as TimeFormat, G as isRecordReferencedError, Gn as ComputedFormulaPathNode, Gt as PropertySchema, H as isNotFoundError, Hn as ComputedFormulaCallNode, Ht as relationTargetsOf, I as SyncConflictError, In as ComputedPlan, It as UserAttribute, J as BuiltInTransform, Jt as resolvePropertyDefinitions, K as isSchemaError, Kn as parseComputedFormula, Kt as PropertyType, L as SyncError, Ln as ComputedReturnType, Lt as UserReferenceType, M as SearchBackendError, Mn as isComputedFunctionName, Mt as StatusAttribute, N as StorageError, Nn as ComputedDependency, Nt as StatusGroup, O as RoleNotFoundError, On as COMPUTED_FUNCTIONS, Ot as RollupAttribute, P as StorageOperation, Pn as ComputedFieldKind, Pt as TextAttribute, Q as Attribute, Qt as asTenantId, R as SystemEntityImmutableError, Rn as ComputedValueType, Rt as inferInverseCardinality, S as RecordNotFoundError, Sn as ComputedCompileObject, St as PhoneAttribute, T as RepositoryError, Tn as ComputedFormulaCompileError, Tt as RelationTarget, U as isObjectReferencedError, Un as ComputedFormulaLiteralNode, Ut as OptionPropertyAttribute, V as isAttributeInUseError, Vn as ComputedFormulaBinaryOperator, Vt as isUniversalRelation, W as isProtectedResourceError, Wn as ComputedFormulaParseError, Wt as PropertyAttribute, X as SchemaOperation, Xt as UserId, Y as MigrationDefinition, Yt as TenantId, Z as ATTRIBUTE_TYPES, Zt as Uuid, _ as ProtectedResourceError, _n as compileRollupAttribute, _t as MultiselectAttribute, a as ChangeTypeNotSupportedError, an as sameStableValue, at as CurrencyAttribute, b as RealtimeRateLimitedError, bn as CompileComputedFormulaInput, bt as Option, c as DuplicateError, cn as COMPUTED_FUNCTION_METADATA, ct as DateRangeValue, d as MigrationTimeoutError, dn as ComputedFormulaResult, dt as FormulaAttribute, en as deepEqual, et as AttributeType, f as NotFoundError, fn as evaluateComputedAst, ft as FormulaReturnType, g as OrphanSystemAttributeError, gn as isPlainRecord, gt as MultiRelationAttribute, h as ObjectReferencedError, hn as formatComputedResult, ht as LocationGranularity, i as AttributeUsage, in as canonicalStringify, it as Currency, j as SchemaPlanNotFoundError, jn as ComputedFunctionSignature, jt as SingleRelationAttribute, k as SchemaError, kn as COMPUTED_FUNCTION_NAMES, kt as RollupFunction, l as ForbiddenError, ln as ComputedFunctionCategory, lt as DateValue, m as ObjectNotFoundError, mn as evaluateComputedFormulaWithResult, mt as LocationAttribute, n as AttributeInUseError, nn as indexBy, nt as BilateralConfig, o as ConcurrentModificationError, on as serializeCanonicalJson, ot as DateAttribute, p as NotImplementedError, pn as evaluateComputedFormula, pt as Location, q as isValidationError, qt as hasOptions, r as AttributeNotFoundError, rn as NonJsonValueError, rt as CheckboxAttribute, s as DestructiveSyncNotAllowedError, sn as serializeStableJson, st as DateFormat, t as AccessDeniedError, tn as generateId, tt as BaseAttribute, u as MemoryNotFoundError, un as ComputedFunctionMetadata, ut as DocumentAttribute, v as ProtectedRoleError, vn as inferRollupReturnType, vt as NumberAttribute, w as RecordReferencedError, wn as ComputedDependencyGraphNode, wt as RelationAttribute, x as RealtimeSubscriptionError, xn as ComputedCompileAttribute, xt as Phone, y as RealtimeDeliveryError, yn as rollupToFormulaExpression, yt as NumberUnit, z as ValidationError, zn as ComputedFormulaAstNode, zt as isAttributeSortable } from "./exceptions-Bon8Edct.mjs";
-import { $ as RelativeDateValue, A as FormDensity, B as DynamicValue, C as ContentPlacement, D as DocumentsContentDefinition, E as CustomContentDefinition, F as RichtextContentDefinition, G as FilterRule, H as ExtendedFilterRule, I as ViewContentDefinition, J as NO_VALUE_OPERATORS, K as FilterState, L as ViewRead, M as KanbanCollectionContentDefinition, N as ListViewLayout, O as EmailsContentDefinition, P as MeetingsContentDefinition, Q as QueryState, R as CurrencyFilterValue, S as ContentOpenMode, T as ContentViewDefinition, U as FilterCombinator, V as EdgeQuantifier, W as FilterOperator, X as OPERATORS_BY_TYPE, Y as NoValueOperator, Z as PhoneFilterValue, _ as CollectionContentSource, a as displayAttributesSchema, b as ContentField, c as filterStateSchema, d as colorIdSchema, et as SortDirection, f as iconNameSchema, g as CollectionContentDefinition, h as CollectionAction, i as contentViewDefinitionSchemaFor, it as isNoValueOperator, j as FormsContentDefinition, k as FormContentDefinition, l as publishedViewContentDefinitionSchema, m as ActivityContentDefinition, n as columnsSchema, nt as filterOperatorsByTypeForGeneration, o as draftContentViewDefinitionSchema, p as SCHEMA_LIMITS, q as FilterValue, r as contentViewDefinitionSchema, rt as getRollupFilterOperators, s as draftContentViewDefinitionSchemaFor, t as collectionContentSourceSchema, tt as SortRule, u as sortsSchema, v as ColumnReference, w as ContentViewContext, x as ContentFieldGroup, y as ContentCreateMode, z as DayMonthValue } from "./all-BDkJ5lPJ.mjs";
-import { A as FolderPreset, C as ResourceVisibility, D as parseResourceVisibility, E as Timestamps, M as PresetNode, O as DocumentLayout, S as ReservedObjectName, T as SystemFieldName, _ as ObjectRecord, a as validateDraft, b as RESOURCE_VISIBILITIES, c as validateObjectOrThrow, f as createFormAttributeValidator, g as ObjectDefinition, h as ObjectAttribute, j as MAX_PRESET_DEPTH, k as DocumentLayoutVariant, m as ListViewTabVisibility, o as validateDraftOrThrow, p as LIST_VIEW_TAB_VISIBILITIES, r as rejectUnknownAttributesOrThrow, s as validateObject, v as RESERVED_ATTRIBUTE_NAMES, w as SYSTEM_FIELD_NAMES, x as ReservedAttributeName, y as RESERVED_OBJECT_NAMES } from "./index-ChtJn338.mjs";
-import { S as UpdateObjectInput, _ as statusOptionWriteSchema, b as RelationOption, c as parseAttributeConfigForCreate, d as propertyAttributeWireSchema, f as propertySchemaSchema, g as statusGroupSchema, h as selectOptionWriteSchema, l as parseAttributeConfigForUpdate, m as refuseForeignKeys, n as WIRE_OMITTED_CONFIG_KEYS, o as multiselectOptionWriteSchema, p as propertySchemaWireSchema, r as attributeConfigSchemas, s as parseAttributeConfig, t as SIMPLE_PROPERTY_TYPES, u as propertyAttributeSchema, v as AddAttributeInput, x as RelationOptionsResponse, y as CreateCustomObjectInput } from "./index-By2s4V9c.mjs";
-import { n as DEFAULT_VALIDATION_MESSAGES, r as ValidationMessages, t as formatZodErrors } from "./index-DF2Os8Es.mjs";
-import { t as createTextValidator } from "./text-BrCsJIFO.mjs";
-import { t as createNumberValidator } from "./number-C1HpLQUY.mjs";
-import { t as createCheckboxValidator } from "./checkbox-BR-7mIkg.mjs";
-import { t as createDateValidator } from "./date-CJWfx4s2.mjs";
+import { $ as AttributeGroup, $t as asUserId, A as SchemaErrorCode, An as ComputedFunctionName, At as SelectAttribute, B as ValidationErrorDetail, Bn as ComputedFormulaBinaryNode, Bt as isBilateralRelation, C as RecordReference, Cn as ComputedCompileSchema, Ct as RELATION_TARGET_ANY, D as ReservedObjectNameError, Dn as compileComputedFormula, Dt as RichtextAttribute, E as RepositoryOperation, En as assertAcyclicComputedDependencies, Et as RichTextAttribute, F as SyncCascadeError, Fn as ComputedOptionsSource, Ft as TimeFormat, G as isRecordReferencedError, Gn as ComputedFormulaPathNode, Gt as PropertySchema, H as isNotFoundError, Hn as ComputedFormulaCallNode, Ht as relationTargetsOf, I as SyncConflictError, In as ComputedPlan, It as UserAttribute, J as BuiltInTransform, Jt as resolvePropertyDefinitions, K as isSchemaError, Kn as parseComputedFormula, Kt as PropertyType, L as SyncError, Ln as ComputedReturnType, Lt as UserReferenceType, M as SearchBackendError, Mn as isComputedFunctionName, Mt as StatusAttribute, N as StorageError, Nn as ComputedDependency, Nt as StatusGroup, O as RoleNotFoundError, On as COMPUTED_FUNCTIONS, Ot as RollupAttribute, P as StorageOperation, Pn as ComputedFieldKind, Pt as TextAttribute, Q as Attribute, Qt as asTenantId, R as SystemEntityImmutableError, Rn as ComputedValueType, Rt as inferInverseCardinality, S as RecordNotFoundError, Sn as ComputedCompileObject, St as PhoneAttribute, T as RepositoryError, Tn as ComputedFormulaCompileError, Tt as RelationTarget, U as isObjectReferencedError, Un as ComputedFormulaLiteralNode, Ut as OptionPropertyAttribute, V as isAttributeInUseError, Vn as ComputedFormulaBinaryOperator, Vt as isUniversalRelation, W as isProtectedResourceError, Wn as ComputedFormulaParseError, Wt as PropertyAttribute, X as SchemaOperation, Xt as UserId, Y as MigrationDefinition, Yt as TenantId, Z as ATTRIBUTE_TYPES, Zt as Uuid, _ as ProtectedResourceError, _n as compileRollupAttribute, _t as MultiselectAttribute, a as ChangeTypeNotSupportedError, an as sameStableValue, at as CurrencyAttribute, b as RealtimeRateLimitedError, bn as CompileComputedFormulaInput, bt as Option, c as DuplicateError, cn as COMPUTED_FUNCTION_METADATA, ct as DateRangeValue, d as MigrationTimeoutError, dn as ComputedFormulaResult, dt as FormulaAttribute, en as deepEqual, et as AttributeType, f as NotFoundError, fn as evaluateComputedAst, ft as FormulaReturnType, g as OrphanSystemAttributeError, gn as isPlainRecord, gt as MultiRelationAttribute, h as ObjectReferencedError, hn as formatComputedResult, ht as LocationGranularity, i as AttributeUsage, in as canonicalStringify, it as Currency, j as SchemaPlanNotFoundError, jn as ComputedFunctionSignature, jt as SingleRelationAttribute, k as SchemaError, kn as COMPUTED_FUNCTION_NAMES, kt as RollupFunction, l as ForbiddenError, ln as ComputedFunctionCategory, lt as DateValue, m as ObjectNotFoundError, mn as evaluateComputedFormulaWithResult, mt as LocationAttribute, n as AttributeInUseError, nn as indexBy, nt as BilateralConfig, o as ConcurrentModificationError, on as serializeCanonicalJson, ot as DateAttribute, p as NotImplementedError, pn as evaluateComputedFormula, pt as Location, q as isValidationError, qt as hasOptions, r as AttributeNotFoundError, rn as NonJsonValueError, rt as CheckboxAttribute, s as DestructiveSyncNotAllowedError, sn as serializeStableJson, st as DateFormat, t as AccessDeniedError, tn as generateId, tt as BaseAttribute, u as MemoryNotFoundError, un as ComputedFunctionMetadata, ut as DocumentAttribute, v as ProtectedRoleError, vn as inferRollupReturnType, vt as NumberAttribute, w as RecordReferencedError, wn as ComputedDependencyGraphNode, wt as RelationAttribute, x as RealtimeSubscriptionError, xn as ComputedCompileAttribute, xt as Phone, y as RealtimeDeliveryError, yn as rollupToFormulaExpression, yt as NumberUnit, z as ValidationError, zn as ComputedFormulaAstNode, zt as isAttributeSortable } from "./exceptions-S2lmNz74.mjs";
+import { $ as RelativeDateValue, A as FormDensity, B as DynamicValue, C as ContentPlacement, D as DocumentsContentDefinition, E as CustomContentDefinition, F as RichtextContentDefinition, G as FilterRule, H as ExtendedFilterRule, I as ViewContentDefinition, J as NO_VALUE_OPERATORS, K as FilterState, L as ViewRead, M as KanbanCollectionContentDefinition, N as ListViewLayout, O as EmailsContentDefinition, P as MeetingsContentDefinition, Q as QueryState, R as CurrencyFilterValue, S as ContentOpenMode, T as ContentViewDefinition, U as FilterCombinator, V as EdgeQuantifier, W as FilterOperator, X as OPERATORS_BY_TYPE, Y as NoValueOperator, Z as PhoneFilterValue, _ as CollectionContentSource, a as displayAttributesSchema, b as ContentField, c as filterStateSchema, d as colorIdSchema, et as SortDirection, f as iconNameSchema, g as CollectionContentDefinition, h as CollectionAction, i as contentViewDefinitionSchemaFor, it as isNoValueOperator, j as FormsContentDefinition, k as FormContentDefinition, l as publishedViewContentDefinitionSchema, m as ActivityContentDefinition, n as columnsSchema, nt as filterOperatorsByTypeForGeneration, o as draftContentViewDefinitionSchema, p as SCHEMA_LIMITS, q as FilterValue, r as contentViewDefinitionSchema, rt as getRollupFilterOperators, s as draftContentViewDefinitionSchemaFor, t as collectionContentSourceSchema, tt as SortRule, u as sortsSchema, v as ColumnReference, w as ContentViewContext, x as ContentFieldGroup, y as ContentCreateMode, z as DayMonthValue } from "./all-CpdLgGJS.mjs";
+import { A as FolderPreset, C as ResourceVisibility, D as parseResourceVisibility, E as Timestamps, M as PresetNode, O as DocumentLayout, S as ReservedObjectName, T as SystemFieldName, _ as ObjectRecord, a as validateDraft, b as RESOURCE_VISIBILITIES, c as validateObjectOrThrow, f as createFormAttributeValidator, g as ObjectDefinition, h as ObjectAttribute, j as MAX_PRESET_DEPTH, k as DocumentLayoutVariant, m as ListViewTabVisibility, o as validateDraftOrThrow, p as LIST_VIEW_TAB_VISIBILITIES, r as rejectUnknownAttributesOrThrow, s as validateObject, v as RESERVED_ATTRIBUTE_NAMES, w as SYSTEM_FIELD_NAMES, x as ReservedAttributeName, y as RESERVED_OBJECT_NAMES } from "./index-wvMnaDN-.mjs";
+import { S as UpdateObjectInput, _ as statusOptionWriteSchema, b as RelationOption, c as parseAttributeConfigForCreate, d as propertyAttributeWireSchema, f as propertySchemaSchema, g as statusGroupSchema, h as selectOptionWriteSchema, l as parseAttributeConfigForUpdate, m as refuseForeignKeys, n as WIRE_OMITTED_CONFIG_KEYS, o as multiselectOptionWriteSchema, p as propertySchemaWireSchema, r as attributeConfigSchemas, s as parseAttributeConfig, t as SIMPLE_PROPERTY_TYPES, u as propertyAttributeSchema, v as AddAttributeInput, x as RelationOptionsResponse, y as CreateCustomObjectInput } from "./index-BCihfYR9.mjs";
+import { n as DEFAULT_VALIDATION_MESSAGES, r as ValidationMessages, t as formatZodErrors } from "./index-DkmrYLFg.mjs";
+import { t as createTextValidator } from "./text-ClvAbA62.mjs";
+import { t as createNumberValidator } from "./number-Bo9vQnrk.mjs";
+import { t as createCheckboxValidator } from "./checkbox-BLcG591z.mjs";
+import { t as createDateValidator } from "./date-DFpmksL8.mjs";
 import z, { z as z$1 } from "zod";
 import { ColorId, CountryIso3, CurrencyCode, IconName, MimeType } from "@stndrds/constants";
 import { StandardSchemaV1, StandardSchemaV1 as StandardSchemaV1$1 } from "@standard-schema/spec";
@@ -948,6 +948,28 @@ export interface MentionedContext {
   /** Summary text for AI system prompt */
   summary: string;
 }
+/**
+ * A span the person selected in an Artifact preview and carried into their
+ * next message as a removable chip (#4117).
+ *
+ * Deliberately NOT a {@link MentionReference}: that one requires `startIndex`
+ * and `endIndex` into the message text, so the transcript can place it inline.
+ * A quote chip is not in the text and has no honest value for them. It travels
+ * beside `attachments`, which is the message's existing shape for a removable
+ * chip that is not part of what was typed.
+ *
+ * `revision` is what closes the loop: `publish_artifact` already takes
+ * `artifactId` + `baseRevision`, so the agent can revise exactly the revision
+ * the span was read from rather than whatever is newest when it answers.
+ */
+export interface ArtifactQuote {
+  /** Unique per chip, so removing one of two quotes of the same span works. */
+  id: string;
+  artifactId: string;
+  /** The revision the span was read from. */
+  revision: number;
+  selectedText: string;
+}
 //#endregion
 //#region src/types/notifications.d.ts
 export declare const NOTIFICATION_KINDS: readonly ["fyi", "task", "question", "handoff", "system"];
@@ -1520,6 +1542,38 @@ export declare function describeOperations(operations: readonly ViewOperation[],
  */
 export declare function parseOperation(candidate: unknown): ViewOperation;
 //#endregion
+//#region src/architect/published-config-exception.d.ts
+/**
+ * The one key a PUBLISHED attribute's configuration may still change (#4165).
+ *
+ * A published attribute's config is frozen in a draft. The writer does publish
+ * config — it forwards every changed key to `updateAttribute` — so the freeze
+ * is not about a change vanishing: it is that a config change reinterprets the
+ * values already stored under it (options, targets, cardinality), and the
+ * route for that stays a new attribute plus a migration. `bilateral` binds an
+ * inverse without touching the values on this side, which is why Karl's
+ * ruling of 2026-09-21 — « Déroger pour `config.bilateral` seul » — opens
+ * exactly that key, so that Architect can pair two one-sided relations that
+ * are already published instead of recreating them and losing their data.
+ *
+ * A named exception, not a thaw. Select options stay frozen, explicitly.
+ *
+ * It lives in `@stndrds/schema` because both sides enforce it and they must
+ * not drift: the runtime refuses the operation, and the editor decides whether
+ * to send a config at all. Two spellings of one rule is how a carve-out
+ * quietly becomes a thaw on one side only.
+ */
+export declare const PUBLISHED_CONFIG_EXCEPTION = "bilateral";
+/**
+ * Whether `next` differs from `published` in the exempt key ALONE.
+ *
+ * `update_attribute` replaces the whole config rather than merging it, so this
+ * cannot be read off the incoming keys: it is everything else being identical
+ * that makes a change the exception, and not a way to carry an options change
+ * past the freeze alongside a bilateral one.
+ */
+export declare function isPublishedConfigChangeAllowed(next: unknown, published: unknown): boolean;
+//#endregion
 //#region src/architect/presentation.d.ts
 export declare function presentationOf(operation: ViewOperation): ArchitectPresentation;
 export declare function episodeImpactOf(operations: readonly ViewOperation[]): ArchitectImpact;
@@ -2220,6 +2274,7 @@ export declare function toDraftableAttributes(object: ObjectDefinition): Draftab
  * never more, never less than publish creates (#3028).
  */
 export declare function toAttribute(attribute: DraftableAttribute): Attribute;
+export declare function toDraftableAttribute(attribute: Attribute, objectId: string): DraftableAttribute;
 /** The record label a drafted object publishes with: its first drafted attribute, else the id. */
 export declare function draftedLabelExpression(attributes: readonly DraftableAttribute[]): string;
 /**
@@ -4467,6 +4522,8 @@ export interface AgentSessionMessage {
   parts: AgentMessagePart[];
   attachments?: AgentMessageAttachment[];
   mentions?: MentionReference[];
+  /** Spans quoted from an Artifact preview, as removable composer chips (#4117). */
+  quotes?: ArtifactQuote[];
   model?: ModelDefinition;
   tokenUsage?: {
     input: number;
@@ -5459,6 +5516,30 @@ export interface Document extends Timestamps {
 export interface DocumentWithSubCount extends Document {
   subCount: number | null;
 }
+/**
+ * One hit of a drive-wide name search: a folder or a file of the record's
+ * drive whose title contains the query, with the path that places it. The
+ * walk is the agent tool's (`listRecordDrive` in query mode); this is what
+ * the open-drive loupe reads (#3217).
+ */
+export interface RecordDriveSearchHit {
+  id: string;
+  kind: "folder" | "file";
+  title: string;
+  /** The hit's titles from the drive root down to itself, `/`-joined — the agent tool's shape. */
+  path: string;
+  parentId: string | null;
+  depth: number;
+}
+export interface RecordDriveSearchResult {
+  recordId: string;
+  hits: RecordDriveSearchHit[];
+  /** Present when the walk stopped at its entry cap: more may match than are listed. */
+  truncated?: {
+    maxEntries: number;
+    returnedEntries: number;
+  };
+}
 /** OCR processing lifecycle for a single file within a document pack. */
 export type FileOcrStatus = "pending" | "processing" | "completed" | "failed";
 /**
@@ -5860,6 +5941,48 @@ export interface BuilderConfig {
   label: string;
 }
 //#endregion
+//#region src/types/recent-activity.d.ts
+/** The browser ledger holds fifty entries; the wire and the server read the
+ * same cap, so it is declared once here and imported on both sides. */
+export declare const RECENT_ACTIVITY_LEDGER_LIMIT = 50;
+export type RecentActivityLedgerEntry = {
+  kind: "record";
+  objectName: string;
+  recordId: string;
+  interactedAt: string;
+} | {
+  kind: "conversation";
+  sessionId: string;
+  interactedAt: string;
+};
+export interface ResolvedRecentRecord {
+  kind: "record";
+  objectName: string;
+  recordId: string;
+  /** The record's persisted display label. */
+  label: string;
+  interactedAt: string;
+}
+export interface ResolvedRecentConversation {
+  kind: "conversation";
+  /** The session as the viewer may read it — what the sidebar row is drawn from. */
+  session: AgentSession;
+  interactedAt: string;
+}
+export type ResolvedRecentActivityItem = ResolvedRecentRecord | ResolvedRecentConversation;
+/** The ledger, resolved: only what the viewer may see, in the ledger's order. */
+export interface ResolvedRecentActivity {
+  items: ResolvedRecentActivityItem[];
+}
+/**
+ * The identity of one ledger subject — the record it points at, or the
+ * conversation it points at — encoded once for every side that needs it: the
+ * browser ledger's de-duplication, the query key that carries the ledger, and
+ * the pairing of the server's answer back onto the entry that asked for it.
+ * JSON keeps it unambiguous whatever an object name contains.
+ */
+export declare function recentActivityEntryKey(entry: RecentActivityLedgerEntry | ResolvedRecentActivityItem): string;
+//#endregion
 //#region src/types/errors.d.ts
 /**
  * Extracts a safe error message from an unknown error value.
@@ -7438,6 +7561,29 @@ export interface ImageModelCatalog {
   defaultModelId: string | null;
   models: readonly ImageModelOption[];
 }
+/** The shape the format/request coherence rule reads, on either side of the boundary. */
+interface ImageFormatDeclaration {
+  readonly formats: readonly ImageFormat[];
+  readonly requests: Readonly<Partial<Record<ImageFormat, unknown>>>;
+}
+/**
+ * The single coherence rule between an image model's declared formats and its
+ * Gateway request mappings, written once for every gate that enforces it: the
+ * remote catalogue door and the host catalogue the runtime accepts.
+ *
+ * Returns the defect as a clause a caller can fold into its own error type and
+ * wording, or `undefined` when the model is coherent.
+ */
+export declare function imageModelFormatDefect(model: ImageFormatDeclaration): string | undefined;
+/**
+ * The request mappings a model actually declares. A stray key is dropped rather
+ * than read: `requests` is looked up by the requested format, so a mapping the
+ * model never advertised would otherwise serve a format `formats` denies.
+ */
+export declare function declaredImageRequests<T>(model: {
+  readonly formats: readonly ImageFormat[];
+  readonly requests: Readonly<Partial<Record<ImageFormat, T>>>;
+}): Partial<Record<ImageFormat, T>>;
 /** Image attempts carry the shared usage cost; kept as a name for existing callers. */
 export type ImageCost = UsageCost;
 export interface GenerateImageInput {
@@ -7496,8 +7642,9 @@ export type ImageFormatRequest = {
 } | {
   readonly aspectRatio: `${number}:${number}`;
 };
+/** `id` carries its provider (`openai/gpt-image-2`) — see the asymmetry above. */
 export interface CatalogImageModel extends ImageModelOption {
-  readonly requests: Readonly<Record<ImageFormat, ImageFormatRequest>>;
+  readonly requests: Readonly<Partial<Record<ImageFormat, ImageFormatRequest>>>;
   readonly isDefault?: boolean;
 }
 export interface CatalogEmbeddingModel {
@@ -13531,6 +13678,13 @@ export declare const agentMessageAttachmentSchema: z$1.ZodObject<{
   mimeType: z$1.ZodString;
   size: z$1.ZodNumber;
 }, z$1.core.$strict>;
+/** A span quoted from an Artifact preview and carried as a composer chip (#4117). */
+export declare const artifactQuoteSchema: z$1.ZodObject<{
+  id: z$1.ZodString;
+  artifactId: z$1.ZodString;
+  revision: z$1.ZodNumber;
+  selectedText: z$1.ZodString;
+}, z$1.core.$strict>;
 export declare const mentionReferenceSchema: z$1.ZodObject<{
   id: z$1.ZodString;
   type: z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<"record" | "user" | (string & {}), string>>;
@@ -13673,6 +13827,12 @@ export declare const agentSessionMessageSchema: z$1.ZodObject<{
     startIndex: z$1.ZodNumber;
     endIndex: z$1.ZodNumber;
   }, z$1.core.$strict>>>;
+  quotes: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
+    id: z$1.ZodString;
+    artifactId: z$1.ZodString;
+    revision: z$1.ZodNumber;
+    selectedText: z$1.ZodString;
+  }, z$1.core.$strict>>>;
   model: z$1.ZodOptional<z$1.ZodObject<{
     provider: z$1.ZodEnum<{
       openai: "openai";
@@ -13889,6 +14049,12 @@ export declare const customDataChunkSchemas: {
         startIndex: z$1.ZodNumber;
         endIndex: z$1.ZodNumber;
       }, z$1.core.$strict>>>;
+      quotes: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
+        id: z$1.ZodString;
+        artifactId: z$1.ZodString;
+        revision: z$1.ZodNumber;
+        selectedText: z$1.ZodString;
+      }, z$1.core.$strict>>>;
       model: z$1.ZodOptional<z$1.ZodObject<{
         provider: z$1.ZodEnum<{
           openai: "openai";
@@ -14030,6 +14196,12 @@ export declare const customDataChunkSchemas: {
         startIndex: z$1.ZodNumber;
         endIndex: z$1.ZodNumber;
       }, z$1.core.$strict>>>;
+      quotes: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
+        id: z$1.ZodString;
+        artifactId: z$1.ZodString;
+        revision: z$1.ZodNumber;
+        selectedText: z$1.ZodString;
+      }, z$1.core.$strict>>>;
       model: z$1.ZodOptional<z$1.ZodObject<{
         provider: z$1.ZodEnum<{
           openai: "openai";
@@ -14310,7 +14482,7 @@ export declare function catalogTextModelSchema(id: string, free: boolean): z$1.Z
  * are absent from it, so the check the text door applies would refuse a valid
  * catalogue outright.
  */
-export declare function catalogImageModelSchema(id: string): z$1.ZodObject<{
+export declare function catalogImageModelSchema(id: string): z$1.ZodPipe<z$1.ZodObject<{
   id: z$1.ZodString;
   name: z$1.ZodString;
   provider: z$1.ZodString;
@@ -14320,24 +14492,68 @@ export declare function catalogImageModelSchema(id: string): z$1.ZodObject<{
     portrait: "portrait";
   }>>;
   requests: z$1.ZodObject<{
-    square: z$1.ZodUnion<readonly [z$1.ZodObject<{
+    square: z$1.ZodOptional<z$1.ZodUnion<readonly [z$1.ZodObject<{
       size: z$1.ZodCustom<`${number}x${number}`, `${number}x${number}`>;
     }, z$1.core.$loose>, z$1.ZodObject<{
       aspectRatio: z$1.ZodCustom<`${number}:${number}`, `${number}:${number}`>;
-    }, z$1.core.$loose>]>;
-    landscape: z$1.ZodUnion<readonly [z$1.ZodObject<{
+    }, z$1.core.$loose>]>>;
+    landscape: z$1.ZodOptional<z$1.ZodUnion<readonly [z$1.ZodObject<{
       size: z$1.ZodCustom<`${number}x${number}`, `${number}x${number}`>;
     }, z$1.core.$loose>, z$1.ZodObject<{
       aspectRatio: z$1.ZodCustom<`${number}:${number}`, `${number}:${number}`>;
-    }, z$1.core.$loose>]>;
-    portrait: z$1.ZodUnion<readonly [z$1.ZodObject<{
+    }, z$1.core.$loose>]>>;
+    portrait: z$1.ZodOptional<z$1.ZodUnion<readonly [z$1.ZodObject<{
       size: z$1.ZodCustom<`${number}x${number}`, `${number}x${number}`>;
     }, z$1.core.$loose>, z$1.ZodObject<{
       aspectRatio: z$1.ZodCustom<`${number}:${number}`, `${number}:${number}`>;
-    }, z$1.core.$loose>]>;
+    }, z$1.core.$loose>]>>;
   }, z$1.core.$loose>;
   isDefault: z$1.ZodOptional<z$1.ZodBoolean>;
-}, z$1.core.$loose>;
+}, z$1.core.$loose>, z$1.ZodTransform<{
+  requests: Partial<Record<"square" | "landscape" | "portrait", {
+    [x: string]: unknown;
+    size: `${number}x${number}`;
+  } | {
+    [x: string]: unknown;
+    aspectRatio: `${number}:${number}`;
+  }>>;
+  id: string;
+  name: string;
+  provider: string;
+  formats: ("square" | "landscape" | "portrait")[];
+  isDefault?: boolean | undefined;
+}, {
+  [x: string]: unknown;
+  id: string;
+  name: string;
+  provider: string;
+  formats: ("square" | "landscape" | "portrait")[];
+  requests: {
+    [x: string]: unknown;
+    square?: {
+      [x: string]: unknown;
+      size: `${number}x${number}`;
+    } | {
+      [x: string]: unknown;
+      aspectRatio: `${number}:${number}`;
+    } | undefined;
+    landscape?: {
+      [x: string]: unknown;
+      size: `${number}x${number}`;
+    } | {
+      [x: string]: unknown;
+      aspectRatio: `${number}:${number}`;
+    } | undefined;
+    portrait?: {
+      [x: string]: unknown;
+      size: `${number}x${number}`;
+    } | {
+      [x: string]: unknown;
+      aspectRatio: `${number}:${number}`;
+    } | undefined;
+  };
+  isDefault?: boolean | undefined;
+}>>;
 export declare const catalogEmbeddingSchema: z$1.ZodObject<{
   model: z$1.ZodString;
   dimensions: z$1.ZodNumber;