@stndrds/schema 1.0.0-alpha.350 → 1.0.0-alpha.351

package/dist/index.d.ts

@@ -1,15 +1,15 @@
 
-import { A as SearchBackendError, B as isNotFoundError, C as RepositoryError, D as SchemaError, E as RoleNotFoundError, F as SyncError, G as isValidationError, H as isProtectedResourceError, I as SystemEntityImmutableError, L as ValidationError, M as StorageOperation, N as SyncCascadeError, O as SchemaErrorCode, P as SyncConflictError, R as ValidationErrorDetail, S as RecordReferencedError, T as ReservedObjectNameError, U as isRecordReferencedError, V as isObjectReferencedError, W as isSchemaError, _ as RealtimeDeliveryError, a as AttributeUsage, b as RecordNotFoundError, c as ForbiddenError, d as NotImplementedError, f as ObjectNotFoundError, g as ProtectedRoleError, h as ProtectedResourceError, i as AttributeNotFoundError, j as StorageError, k as SchemaPlanNotFoundError, l as MemoryNotFoundError, m as OrphanSystemAttributeError, n as AmbiguousSchemaChangeError, o as ConcurrentModificationError, p as ObjectReferencedError, r as AttributeInUseError, s as DuplicateError, t as AccessDeniedError, u as NotFoundError, v as RealtimeRateLimitedError, w as RepositoryOperation, x as RecordReference, y as RealtimeSubscriptionError, z as isAttributeInUseError } from "./exceptions-DxzT8POW.js";
-import { $ as COMPUTED_FUNCTION_METADATA, A as RichTextAttribute, At as ComputedFormulaAstNode, B as UserAttribute, C as NumberUnit, Ct as isComputedFunctionName, D as RELATION_TARGET_ANY, Dt as ComputedPlan, E as PhoneAttribute, Et as ComputedOptionsSource, F as SingleRelationAttribute, Ft as ComputedFormulaParseError, G as isUniversalRelation, H as inferInverseCardinality, I as StatusAttribute, It as ComputedFormulaPathNode, J as PropertyAttribute, K as relationTargetsOf, L as StatusGroup, Lt as parseComputedFormula, M as RollupAttribute, Mt as ComputedFormulaBinaryOperator, N as RollupFunction, Nt as ComputedFormulaCallNode, O as RelationAttribute, Ot as ComputedReturnType, P as SelectAttribute, Pt as ComputedFormulaLiteralNode, Q as resolvePropertyDefinitions, R as TextAttribute, S as NumberAttribute, St as ComputedFunctionSignature, T as Phone, Tt as ComputedFieldKind, U as isAttributeSortable, V as UserReferenceType, W as isBilateralRelation, X as PropertyType, Y as PropertySchema, Z as hasOptions, _ as Location, _t as assertAcyclicComputedDependencies, a as BaseAttribute, at as evaluateComputedFormulaWithResult, b as MultiRelationAttribute, bt as COMPUTED_FUNCTION_NAMES, c as Currency, ct as compileRollupAttribute, d as DateFormat, dt as CompileComputedFormulaInput, et as ComputedFunctionCategory, f as DateRangeValue, ft as ComputedCompileAttribute, g as FormulaReturnType, gt as ComputedFormulaCompileError, h as FormulaAttribute, ht as ComputedDependencyGraphNode, i as AttributeType, it as evaluateComputedFormula, j as RichtextAttribute, jt as ComputedFormulaBinaryNode, k as RelationTarget, kt as ComputedValueType, l as CurrencyAttribute, lt as inferRollupReturnType, m as DocumentAttribute, mt as ComputedCompileSchema, n as Attribute, nt as ComputedFormulaResult, o as BilateralConfig, ot as formatComputedResult, p as DateValue, pt as ComputedCompileObject, q as OptionPropertyAttribute, r as AttributeGroup, rt as evaluateComputedAst, s as CheckboxAttribute, st as isPlainRecord, t as ATTRIBUTE_TYPES, tt as ComputedFunctionMetadata, u as DateAttribute, ut as rollupToFormulaExpression, v as LocationAttribute, vt as compileComputedFormula, w as Option, wt as ComputedDependency, x as MultiselectAttribute, xt as ComputedFunctionName, y as LocationGranularity, yt as COMPUTED_FUNCTIONS, z as TimeFormat } from "./attributes-C2gm0hUJ.js";
-import { a as asUserId, c as indexBy, d as sameStableValue, f as serializeCanonicalJson, i as asTenantId, l as NonJsonValueError, n as UserId, o as deepEqual, p as serializeStableJson, r as Uuid, s as generateId, t as TenantId, u as canonicalStringify } from "./utils-Du-He6Ct.js";
-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-CPMOHYla.js";
-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-D9OhYX-t.js";
-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-CRtiKFTH.js";
-import { n as DEFAULT_VALIDATION_MESSAGES, r as ValidationMessages, t as formatZodErrors } from "./index-BL7EA39F.js";
-import { t as createTextValidator } from "./text-DHg2cmFd.js";
-import { t as createNumberValidator } from "./number-Ck0PPSkK.js";
-import { t as createCheckboxValidator } from "./checkbox-Ce8gAyQf.js";
-import { t as createDateValidator } from "./date-DikDGfre.js";
+import { A as SearchBackendError, B as ValidationErrorDetail, C as RepositoryError, D as SchemaError, E as RoleNotFoundError, F as SyncCascadeError, G as isRecordReferencedError, H as isNotFoundError, I as SyncConflictError, K as isSchemaError, L as SyncError, M as SearchBackendFailureKind, N as StorageError, O as SchemaErrorCode, P as StorageOperation, R as SystemEntityImmutableError, S as RecordReferencedError, T as ReservedObjectNameError, U as isObjectReferencedError, V as isAttributeInUseError, W as isProtectedResourceError, _ as RealtimeDeliveryError, a as AttributeUsage, b as RecordNotFoundError, c as ForbiddenError, d as NotImplementedError, f as ObjectNotFoundError, g as ProtectedRoleError, h as ProtectedResourceError, i as AttributeNotFoundError, j as SearchBackendErrorOptions, k as SchemaPlanNotFoundError, l as MemoryNotFoundError, m as OrphanSystemAttributeError, n as AmbiguousSchemaChangeError, o as ConcurrentModificationError, p as ObjectReferencedError, q as isValidationError, r as AttributeInUseError, s as DuplicateError, t as AccessDeniedError, u as NotFoundError, v as RealtimeRateLimitedError, w as RepositoryOperation, x as RecordReference, y as RealtimeSubscriptionError, z as ValidationError } from "./exceptions-DrrzAhuA.js";
+import { $ as COMPUTED_FUNCTION_METADATA, A as RichTextAttribute, At as ComputedFormulaAstNode, B as UserAttribute, C as NumberUnit, Ct as isComputedFunctionName, D as RELATION_TARGET_ANY, Dt as ComputedPlan, E as PhoneAttribute, Et as ComputedOptionsSource, F as SingleRelationAttribute, Ft as ComputedFormulaParseError, G as isUniversalRelation, H as inferInverseCardinality, I as StatusAttribute, It as ComputedFormulaPathNode, J as PropertyAttribute, K as relationTargetsOf, L as StatusGroup, Lt as parseComputedFormula, M as RollupAttribute, Mt as ComputedFormulaBinaryOperator, N as RollupFunction, Nt as ComputedFormulaCallNode, O as RelationAttribute, Ot as ComputedReturnType, P as SelectAttribute, Pt as ComputedFormulaLiteralNode, Q as resolvePropertyDefinitions, R as TextAttribute, S as NumberAttribute, St as ComputedFunctionSignature, T as Phone, Tt as ComputedFieldKind, U as isAttributeSortable, V as UserReferenceType, W as isBilateralRelation, X as PropertyType, Y as PropertySchema, Z as hasOptions, _ as Location, _t as assertAcyclicComputedDependencies, a as BaseAttribute, at as evaluateComputedFormulaWithResult, b as MultiRelationAttribute, bt as COMPUTED_FUNCTION_NAMES, c as Currency, ct as compileRollupAttribute, d as DateFormat, dt as CompileComputedFormulaInput, et as ComputedFunctionCategory, f as DateRangeValue, ft as ComputedCompileAttribute, g as FormulaReturnType, gt as ComputedFormulaCompileError, h as FormulaAttribute, ht as ComputedDependencyGraphNode, i as AttributeType, it as evaluateComputedFormula, j as RichtextAttribute, jt as ComputedFormulaBinaryNode, k as RelationTarget, kt as ComputedValueType, l as CurrencyAttribute, lt as inferRollupReturnType, m as DocumentAttribute, mt as ComputedCompileSchema, n as Attribute, nt as ComputedFormulaResult, o as BilateralConfig, ot as formatComputedResult, p as DateValue, pt as ComputedCompileObject, q as OptionPropertyAttribute, r as AttributeGroup, rt as evaluateComputedAst, s as CheckboxAttribute, st as isPlainRecord, t as ATTRIBUTE_TYPES, tt as ComputedFunctionMetadata, u as DateAttribute, ut as rollupToFormulaExpression, v as LocationAttribute, vt as compileComputedFormula, w as Option, wt as ComputedDependency, x as MultiselectAttribute, xt as ComputedFunctionName, y as LocationGranularity, yt as COMPUTED_FUNCTIONS, z as TimeFormat } from "./attributes-DF899HOt.js";
+import { a as asUserId, c as indexBy, d as sameStableValue, f as serializeCanonicalJson, i as asTenantId, l as NonJsonValueError, n as UserId, o as deepEqual, p as serializeStableJson, r as Uuid, s as generateId, t as TenantId, u as canonicalStringify } from "./utils-Cuz_wSKI.js";
+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-DgCMEIjc.js";
+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-DCw-X_sc.js";
+import { C as UpdateObjectInput, S as RelationOptionsResponse, _ as statusOptionWriteSchema, b as CreateCustomObjectInput, 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 withoutUnknownOptionKeys, x as RelationOption, y as AddAttributeInput } from "./index-BOibflWy.js";
+import { n as DEFAULT_VALIDATION_MESSAGES, r as ValidationMessages, t as formatZodErrors } from "./index-OvRk1isl.js";
+import { t as createTextValidator } from "./text-Z8QjbxUx.js";
+import { t as createNumberValidator } from "./number-CoTBX03I.js";
+import { t as createCheckboxValidator } from "./checkbox-DdyYfy8E.js";
+import { t as createDateValidator } from "./date-DhwNqFU4.js";
 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";
@@ -840,6 +840,11 @@ export interface ApiKeyPermission {
   target: string;
   actions: Action[];
 }
+/**
+ * A role an API key's actor holds — the identifying slice only, never the
+ * role's permissions.
+ */
+export type ApiKeyRole = Pick<Role, "id" | "name" | "label">;
 export interface ApiKey {
   id: string;
   tenantId: string;
@@ -853,6 +858,15 @@ export interface ApiKey {
   revokedAt: string | null;
   createdAt: string;
   createdBy: string;
+  /**
+   * The roles the key's actor holds in this workspace, which is what the key
+   * may do. A key minted with `roleId` holds that role; one minted without it
+   * holds the copies of its creator's roles made at creation. `[]` means the
+   * key holds no role and has no access. Present on list and single-key reads;
+   * absent where the roles were not read (the creation response, or a host
+   * with no permission store) — absent is "unknown", never "no role".
+   */
+  roles?: ApiKeyRole[];
 }
 /** Returned only at creation time — the only time the plaintext secret is available. */
 export interface ApiKeyWithSecret extends ApiKey {
@@ -3984,6 +3998,9 @@ export interface AgentUIDataTypes {
   "message-persisted": {
     message: AgentSessionMessage;
   };
+  "message-persisted-ref": {
+    messageId: string;
+  };
   "message-updated": {
     message: AgentSessionMessage;
   };
@@ -4880,14 +4897,6 @@ export interface AIAvailableModel {
   isCompactionModel?: boolean;
   /** If true, this model is used for fast utility generations (regex, formula, …) */
   isUtilityModel?: boolean;
-  /**
-   * How the UI reveals this model's streamed text. `"character"` (the default
-   * when absent) paces graphemes at reading speed — right for fast models.
-   * `"word"` flushes text at network rhythm and fades each new word in —
-   * right for slow models whose token cadence the pacer would turn into
-   * jerky bursts.
-   */
-  revealStyle?: "character" | "word";
 }
 /**
  * Tool call status during execution
@@ -5752,6 +5761,16 @@ export interface DocumentFile {
 export type DocumentWithFiles = Document & {
   files: DocumentFile[];
 };
+/**
+ * One row of a record's drive at a given level: the document with its sub
+ * count and its pack files (#4332). A drive-only attachment, one that exists
+ * only as a reference edge and is named nowhere in `record.values`, has no
+ * other source for its files, and without them its row menu cannot offer
+ * Download. A folder has no pack: its `files` is always `[]`.
+ */
+export interface RecordDriveChild extends DocumentWithSubCount {
+  files: DocumentFile[];
+}
 export interface CreateDocument {
   title: string;
   kind?: DocumentKind;
@@ -7169,6 +7188,23 @@ export interface ConnectionCapabilities {
 }
 /** What to ask for so a re-consent keeps what the connection already holds: the held flags beyond `read`, in capability order. */
 export declare function requestedCapabilities(held: ConnectionCapabilities): Exclude<ConnectorCapability, "read">[];
+/**
+ * How far a connection's full-history walk (backfill) has gone.
+ *
+ * `processed` counts the items the current walk has stored so far, across every
+ * continuation job; once the walk ends it keeps the final count. `total` is what
+ * the provider says the walk will cover, captured when the walk starts: exact or
+ * an estimate (Gmail's `resultSizeEstimate`), so `processed` may end above or
+ * below it. It is `null` when the provider offers no total (calendars), so a
+ * bar stays indeterminate rather than inventing a 100%. A connection that has
+ * never walked reads `{ processed: 0, total: null, backfilling: false }`.
+ */
+export interface ConnectionSyncProgress {
+  processed: number;
+  total: number | null;
+  /** True while the walk is mid-flight and continuation jobs are still due. */
+  backfilling: boolean;
+}
 /**
  * Token-free projection of a connection for client/UI consumption.
  * Access/refresh tokens NEVER cross this boundary.
@@ -7185,6 +7221,8 @@ export interface ConnectionView {
   lastSyncedAt: string | null;
   createdAt: string;
   capabilities: ConnectionCapabilities;
+  /** Backfill progress of a mail or calendar connection. */
+  syncProgress: ConnectionSyncProgress;
 }
 /** Scope a connection is created under. Implied by the originating settings section. */
 export type ConnectorScope = "actor" | "tenant";
@@ -7239,6 +7277,15 @@ export declare function isMailProvider(provider: string): provider is EmailProvi
  * (#1907) — do not merge them back.
  */
 export type MailboxAccountVisibility = "shared" | "private";
+/**
+ * The label a message the provider still holds as a draft carries in
+ * `MailboxEmail.labels`: Gmail's own `DRAFT` system label, and the one the
+ * Graph parser derives from Outlook's `isDraft` (#4353). Unrelated to
+ * `MailDraft`, the composer's local draft.
+ */
+export declare const PROVIDER_DRAFT_LABEL = "DRAFT";
+/** Whether a stored message is a provider draft — Gmail or Outlook alike. */
+export declare function isProviderDraft(labels: readonly string[]): boolean;
 export type EmailDirection = "inbound" | "outbound";
 export type MailboxReadState = "all" | "unread" | "read";
 export type ConnectionStatus = "active" | "reauth_required" | "error" | "disconnected";
@@ -9001,11 +9048,26 @@ declare class StatusAttributeBuilder<TName extends string, TOptions extends read
   /**
    * Set all options at once (preserves literal types for values)
    */
-  options<const T extends readonly Option[]>(value: T): StatusAttributeBuilder<TName, T, TRequired>;
-  option(config: Option): this;
+  options<const T extends readonly Option[]>(value: T & ExactOptions<T>): StatusAttributeBuilder<TName, T, TRequired>;
+  option<const O extends Option>(config: O & ExactOption<O>): this;
   required(): StatusAttributeBuilder<TName, TOptions, true>;
   optional(): StatusAttributeBuilder<TName, TOptions, false>;
 }
+/**
+ * Every element of `T` with the keys an {@link Option} does not have typed as
+ * `never`. A generic constraint does no excess-property check, so
+ * `{ id, value, label }` satisfied `readonly Option[]`, sync stored `id`, and
+ * the schema state then answered 400 for the whole tenant (#4356). Refused at
+ * the type level only (#4413): the storage strip from #4412 still guards
+ * whatever reaches it at runtime.
+ */
+type ExactOptions<T extends readonly Option[]> = { readonly [K in keyof T]: T[K] & ExactOption<T[K]>; };
+/**
+ * The keys of `O` an {@link Option} does not have, typed as `never`. A fresh
+ * literal gets an excess-property check against `Option`, a declared object
+ * does not, so `.option(declared)` needs this as much as `.options()` does.
+ */
+type ExactOption<O> = Record<Exclude<keyof O, keyof Option>, never>;
 export declare function status<TName extends string>(config: TypedBuilderConfig<TName>): StatusAttributeBuilder<TName, Option[], false>;
 declare class SelectAttributeBuilder<TName extends string, TOptions extends readonly Option[] = Option[], TRequired extends boolean = false> extends BaseAttributeBuilder<SelectAttribute> {
   readonly _types: {
@@ -9031,8 +9093,8 @@ declare class SelectAttributeBuilder<TName extends string, TOptions extends read
   /**
    * Set all options at once (preserves literal types for values)
    */
-  options<const T extends readonly Option[]>(value: T): SelectAttributeBuilder<TName, T, TRequired>;
-  option(config: Option): this;
+  options<const T extends readonly Option[]>(value: T & ExactOptions<T>): SelectAttributeBuilder<TName, T, TRequired>;
+  option<const O extends Option>(config: O & ExactOption<O>): this;
   renderAs(value: "badges"): this;
   required(): SelectAttributeBuilder<TName, TOptions, true>;
   optional(): SelectAttributeBuilder<TName, TOptions, false>;
@@ -9062,8 +9124,8 @@ declare class MultiselectAttributeBuilder<TName extends string, TOptions extends
   /**
    * Set all options at once (preserves literal types for values)
    */
-  options<const T extends readonly Option[]>(value: T): MultiselectAttributeBuilder<TName, T, TRequired>;
-  option(config: Option): this;
+  options<const T extends readonly Option[]>(value: T & ExactOptions<T>): MultiselectAttributeBuilder<TName, T, TRequired>;
+  option<const O extends Option>(config: O & ExactOption<O>): this;
   renderAs(value: "badges"): this;
   required(): MultiselectAttributeBuilder<TName, TOptions, true>;
   optional(): MultiselectAttributeBuilder<TName, TOptions, false>;
@@ -9385,7 +9447,7 @@ declare class RollupAttributeBuilder<TName extends string> extends BaseAttribute
    * Required when function="original" and target is select/status/multiselect
    * @param options - The options array from the target attribute
    */
-  targetOptions(options: Option[]): this;
+  targetOptions<const T extends readonly Option[]>(options: T & ExactOptions<T>): this;
   /**
    * Set the currency code a sum/avg over a currency target renders with
    * (#2644). Mirror of the target attribute's `defaultCurrency` — the stored
@@ -12867,6 +12929,98 @@ export declare function assertSchemaSourceId(sourceId: string): void;
  */
 export declare function markdownToPlainText(markdown: string): string;
 //#endregion
+//#region src/utils/read-artifact-result.d.ts
+/**
+ * A published result as it reads BACK, which is not quite what may be written.
+ *
+ * `kind` is whatever was stored. A newer server can publish a kind this client
+ * has not shipped yet, and refusing the whole value over that made the artifact
+ * render as nothing at all — the reader was told an artifact existed and saw no
+ * artifact (#4075). Karl's ruling of 2026-09-21: visible and degraded.
+ *
+ * `PublishArtifactResult` itself stays closed. This type describes history, not
+ * what the product may emit, and the two are genuinely different questions —
+ * which is also why the annotation below stays honest instead of being cast
+ * away. A schema that needs a cast to claim its own return type has stopped
+ * validating what it says it validates.
+ */
+type StoredArtifactResult = Omit<PublishArtifactResult, "kind"> & {
+  kind: StoredArtifactKind;
+};
+/**
+ * Narrows an untrusted persisted tool result.
+ *
+ * Strict in every field but `kind`: a value that fails for any other reason is
+ * still refused whole.
+ */
+export declare function readArtifactResult(value: unknown): StoredArtifactResult | null;
+//#endregion
+//#region src/utils/read-generated-image-result.d.ts
+/** Untrusted history must carry a real nested image receipt, never bytes or a signed URL. */
+export declare function readGeneratedImageResult(value: unknown): GenerateImageResult | null;
+//#endregion
+//#region src/utils/extract-touched-records.d.ts
+interface TouchedRecord {
+  recordId: string;
+  objectName: string;
+  label: string;
+  kind: "created" | "modified";
+}
+/**
+ * Derives the records an agent run created or modified, from the session's
+ * tool-call results. Dedups by `recordId`, keeping the highest-precedence
+ * kind seen (`created` beats `modified`) while re-anchoring the entry's
+ * position to its most recent occurrence.
+ */
+export declare function extractTouchedRecords(messages: readonly Pick<AgentSessionMessage, "role" | "parts">[]): TouchedRecord[];
+//#endregion
+//#region src/utils/extract-touched-documents.d.ts
+interface TouchedDocument {
+  id: string;
+  fileId?: string;
+  title: string;
+  kind: "modified" | "consulted";
+  mimeType?: string;
+}
+/**
+ * Derives the documents an agent run touched, from tool-call results and
+ * assistant-message file attachments. Dedups by `id`, keeping the
+ * highest-precedence kind seen (`modified` beats `consulted`) while
+ * re-anchoring the entry's position to its most recent occurrence.
+ */
+export declare function extractTouchedDocuments(messages: readonly Pick<AgentSessionMessage, "role" | "parts">[]): TouchedDocument[];
+//#endregion
+//#region src/utils/extract-touched-artifacts.d.ts
+/**
+ * Read back out of a conversation, so `kind` is whatever was stored — a newer
+ * server may have published one this client does not know (#4075).
+ */
+type TouchedArtifact = StoredArtifactResult;
+/**
+ * Finds immutable Artifact revisions published by the assistant. Repeated
+ * occurrences move to their latest position and carry the latest metadata.
+ */
+export declare function extractTouchedArtifacts(messages: readonly Pick<AgentSessionMessage, "role" | "parts">[]): TouchedArtifact[];
+//#endregion
+//#region src/utils/agent-conversation-overview.d.ts
+interface AgentConversationOverview {
+  touchedRecords: TouchedRecord[];
+  touchedDocuments: TouchedDocument[];
+  touchedArtifacts: TouchedArtifact[];
+  openHumanRequests: Array<{
+    messageId: string;
+    createdAt: string;
+    part: Extract<AgentMessagePart, {
+      type: "tool";
+    }>;
+  }>;
+  firstUserPreview: string | null;
+  designReviewOutcomes: Array<{
+    requestId: string;
+    outcome: "approved" | "changesRequested" | "unknown";
+  }>;
+}
+//#endregion
 //#region src/utils/calendar-day.d.ts
 /**
  * A `YYYY-MM-DD` string that actually names a calendar day.
@@ -14264,6 +14418,9 @@ export declare const customDataChunkSchemas: {
       createdAt: z$1.ZodUnion<readonly [z$1.ZodDate, z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<Date, string>>]>;
     }, z$1.core.$strict>;
   }, z$1.core.$strict>;
+  readonly "message-persisted-ref": z$1.ZodObject<{
+    messageId: z$1.ZodString;
+  }, z$1.core.$strict>;
   readonly "message-updated": z$1.ZodObject<{
     message: z$1.ZodObject<{
       id: z$1.ZodString;
@@ -14636,10 +14793,6 @@ export declare function catalogTextModelSchema(id: string, free: boolean): z$1.Z
   unverified: z$1.ZodOptional<z$1.ZodBoolean>;
   isCompactionModel: z$1.ZodOptional<z$1.ZodBoolean>;
   isUtilityModel: z$1.ZodOptional<z$1.ZodBoolean>;
-  revealStyle: z$1.ZodOptional<z$1.ZodEnum<{
-    character: "character";
-    word: "word";
-  }>>;
   tasks: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodEnum<{
     conversation: "conversation";
     writing: "writing";
@@ -14762,4 +14915,4 @@ export declare function schemaStateSourcePayload(entries: readonly SchemaStateEn
 export declare function parseSchemaState(input: unknown): SchemaState;
 export declare function diffSchemaState(state: SchemaState): SchemaStateDiff;
 //#endregion
-export { ATTRIBUTE_TYPES, AccessDeniedError, type ActivityContentDefinition, AddAttributeInput, AmbiguousSchemaChangeError, type ArchitectChange, type ArchitectFocus, type ArchitectImpact, type ArchitectNavigation, type ArchitectPresentation, type ArchitectProjection, Attribute, type AttributeAgentCapabilities, type AttributeAuthoringCapabilities, type AttributeCapabilities, type AttributeCardinality, type AttributeDefaultValueCapability, type AttributeExchangeCapabilities, AttributeGroup, AttributeInUseError, type AttributeLifecycleCapabilities, type AttributeLike, AttributeNotFoundError, type AttributePolymorphicCapability, type AttributePresentationCapabilities, type AttributeQueryCapabilities, type AttributeRemovalContentAddress, type AttributeRemovalPlan, type AttributeRemovalView, type AttributeRequiredCapability, type AttributeStorageCapabilities, type AttributeStorageMode, AttributeType, AttributeUsage, BaseAttribute, type BaseOperation, type BatchGuidance, BilateralConfig, type BlockedContent, COMPUTED_FUNCTIONS, COMPUTED_FUNCTION_METADATA, COMPUTED_FUNCTION_NAMES, type CanonicalViewOperationInput, type CatalogueViolation, CheckboxAttribute, type CollectionAction, type CollectionContentDefinition, type CollectionContentSource, type CollectionSourceAddress, type ColumnReference, type ColumnsNeeded, CompileComputedFormulaInput, ComputedCompileAttribute, ComputedCompileObject, ComputedCompileSchema, ComputedDependency, ComputedDependencyGraphNode, ComputedFieldKind, ComputedFormulaAstNode, ComputedFormulaBinaryNode, ComputedFormulaBinaryOperator, ComputedFormulaCallNode, ComputedFormulaCompileError, ComputedFormulaLiteralNode, ComputedFormulaParseError, ComputedFormulaPathNode, ComputedFormulaResult, ComputedFunctionCategory, ComputedFunctionMetadata, ComputedFunctionName, ComputedFunctionSignature, ComputedOptionsSource, ComputedPlan, ComputedReturnType, ComputedValueType, ConcurrentModificationError, type ContentCreateMode, type ContentExtensionDefinition, type ContentField, type ContentFieldGroup, type ContentNavigation, type ContentOpenMode, type ContentPlacement, type ContentViewCatalogueCollection, type ContentViewCatalogueInput, type ContentViewCatalogueResult, type ContentViewContext, type ContentViewDefinition, type ConversationDisplayTitleInput, CreateCustomObjectInput, type CreateDBForm, type CreateDBFormSubmission, Currency, CurrencyAttribute, type CurrencyFilterValue, type CustomContentDefinition, type DBForm, type DBFormSubmission, DEFAULT_VALIDATION_MESSAGES, DateAttribute, DateFormat, DateRangeValue, DateValue, type DayMonthValue, type DefaultResolutionContext, type DefaultViewType, DocumentAttribute, DocumentLayout, DocumentLayoutVariant, type DocumentsContentDefinition, type DraftAppendCommand, type DraftAppendReceipt, type DraftCommandGuard, type DraftContentState, type DraftFocus, type DraftObjectSettings, type DraftOperationContext, type DraftPublishCommand, type DraftRefusal, type DraftSummary, type DraftViewAuthoring, type DraftableAttribute, type DraftableObject, type DraftableSampleRecord, type DraftableState, type DraftableView, type DroppedContent, DuplicateError, type DwellMode, type DynamicValue, type EdgeQuantifier, type EditingCapability, type EditingScope, type EmailsContentDefinition, type ExhaustiveDraftObjectSettings, type ExtendedFilterRule, type FilterCombinator, type FilterOperator, type FilterRule, type FilterState, type FilterValue, type FlagResolutionContext, FolderPreset, ForbiddenError, type FormContentDefinition, type FormDensity, FormRegistry, type FormsContentDefinition, FormulaAttribute, FormulaReturnType, type GatewayFastPricing, type GatewayPriceTier, type GatewayPricing, type KanbanCollectionContentDefinition, LIST_VIEW_TAB_VISIBILITIES, type LabelContext, type ListViewLayout, ListViewTabVisibility, type ListedObjectResolver, Location, LocationAttribute, type LocationFilterProperty, LocationGranularity, MAX_PRESET_DEPTH, type MeetingsContentDefinition, MemoryNotFoundError, MultiRelationAttribute, MultiselectAttribute, type MutationReceipt, NO_VALUE_OPERATORS, type NamedTarget, type NextStep, type NoValueOperator, NonJsonValueError, NotFoundError, NotImplementedError, NumberAttribute, NumberUnit, OPERATORS_BY_TYPE, ObjectAttribute, ObjectDefinition, ObjectNotFoundError, ObjectRecord, ObjectReferencedError, type OperationDef, type OperationFamily, type OperationPace, Option, OptionPropertyAttribute, OrphanSystemAttributeError, Phone, PhoneAttribute, type PhoneFilterValue, PresetNode, PropertyAttribute, PropertySchema, PropertyType, type ProposalRevision, type ProposalTarget, ProtectedResourceError, ProtectedRoleError, type QueryState, RELATION_TARGET_ANY, RESERVED_ATTRIBUTE_NAMES, RESERVED_OBJECT_NAMES, RESOURCE_VISIBILITIES, RealtimeDeliveryError, RealtimeRateLimitedError, RealtimeSubscriptionError, type ReconcileRelationAttributesInput, type ReconciledRelationAttributes, RecordNotFoundError, RecordReference, RecordReferencedError, RelationAttribute, RelationOption, RelationOptionsResponse, type RelationPair, RelationTarget, type RelativeDateValue, type RemovedAttribute, type RenameDraftAttributeOperation, RepositoryError, RepositoryOperation, ReservedAttributeName, ReservedObjectName, ReservedObjectNameError, ResourceVisibility, RichTextAttribute, RichtextAttribute, type RichtextContentDefinition, RoleNotFoundError, RollupAttribute, RollupFunction, SCHEMA_LIMITS, SIMPLE_PROPERTY_TYPES, SYSTEM_FIELD_NAMES, type SamplePublication, SchemaError, SchemaErrorCode, SchemaPlanNotFoundError, type ScrubbedContent, SearchBackendError, SelectAttribute, SingleRelationAttribute, type SortDirection, type SortRule, type StandardSchemaV1, StatusAttribute, StatusGroup, StorageError, StorageOperation, type StoredContentDefinition, SyncCascadeError, SyncConflictError, SyncError, SystemEntityImmutableError, SystemFieldName, type TenantId, TextAttribute, TimeFormat, Timestamps, type UpdateDBForm, type UpdateDBFormSubmission, UpdateObjectInput, UserAttribute, type UserId, type UserLike, UserReferenceType, type Uuid, ValidationError, ValidationErrorDetail, type ValidationMessages, type ValueRef, type ViewContentDefinition, type ViewOperation, type ViewRead, WIRE_OMITTED_CONFIG_KEYS, asTenantId, asUserId, assertAcyclicComputedDependencies, attributeConfigSchemas, canonicalStringify, collectionContentSourceSchema, colorIdSchema, columnsSchema, compileComputedFormula, compileRollupAttribute, contentViewDefinitionSchema, contentViewDefinitionSchemaFor, createCheckboxValidator, createDateValidator, createFormAttributeValidator, createNumberValidator, createTextValidator, deepEqual, displayAttributesSchema, draftContentViewDefinitionSchema, draftContentViewDefinitionSchemaFor, evaluateComputedAst, evaluateComputedFormula, evaluateComputedFormulaWithResult, filterOperatorsByTypeForGeneration, filterStateSchema, formatComputedResult, formatZodErrors, generateId, getRollupFilterOperators, hasOptions, iconNameSchema, indexBy, inferInverseCardinality, inferRollupReturnType, isAttributeInUseError, isAttributeSortable, isBilateralRelation, isComputedFunctionName, isNoValueOperator, isNotFoundError, isObjectReferencedError, isPlainRecord, isProtectedResourceError, isRecordReferencedError, isSchemaError, isUniversalRelation, isValidationError, multiselectOptionWriteSchema, parseAttributeConfig, parseAttributeConfigForCreate, parseAttributeConfigForUpdate, parseComputedFormula, parseResourceVisibility, propertyAttributeSchema, propertyAttributeWireSchema, propertySchemaSchema, propertySchemaWireSchema, publishedViewContentDefinitionSchema, refuseForeignKeys, rejectUnknownAttributesOrThrow, relationTargetsOf, resolvePropertyDefinitions, rollupToFormulaExpression, sameStableValue, selectOptionWriteSchema, serializeCanonicalJson, serializeStableJson, sortsSchema, statusGroupSchema, statusOptionWriteSchema, validateDraft, validateDraftOrThrow, validateObject, validateObjectOrThrow };
+export { ATTRIBUTE_TYPES, AccessDeniedError, type ActivityContentDefinition, AddAttributeInput, type AgentConversationOverview, AmbiguousSchemaChangeError, type ArchitectChange, type ArchitectFocus, type ArchitectImpact, type ArchitectNavigation, type ArchitectPresentation, type ArchitectProjection, Attribute, type AttributeAgentCapabilities, type AttributeAuthoringCapabilities, type AttributeCapabilities, type AttributeCardinality, type AttributeDefaultValueCapability, type AttributeExchangeCapabilities, AttributeGroup, AttributeInUseError, type AttributeLifecycleCapabilities, type AttributeLike, AttributeNotFoundError, type AttributePolymorphicCapability, type AttributePresentationCapabilities, type AttributeQueryCapabilities, type AttributeRemovalContentAddress, type AttributeRemovalPlan, type AttributeRemovalView, type AttributeRequiredCapability, type AttributeStorageCapabilities, type AttributeStorageMode, AttributeType, AttributeUsage, BaseAttribute, type BaseOperation, type BatchGuidance, BilateralConfig, type BlockedContent, COMPUTED_FUNCTIONS, COMPUTED_FUNCTION_METADATA, COMPUTED_FUNCTION_NAMES, type CanonicalViewOperationInput, type CatalogueViolation, CheckboxAttribute, type CollectionAction, type CollectionContentDefinition, type CollectionContentSource, type CollectionSourceAddress, type ColumnReference, type ColumnsNeeded, CompileComputedFormulaInput, ComputedCompileAttribute, ComputedCompileObject, ComputedCompileSchema, ComputedDependency, ComputedDependencyGraphNode, ComputedFieldKind, ComputedFormulaAstNode, ComputedFormulaBinaryNode, ComputedFormulaBinaryOperator, ComputedFormulaCallNode, ComputedFormulaCompileError, ComputedFormulaLiteralNode, ComputedFormulaParseError, ComputedFormulaPathNode, ComputedFormulaResult, ComputedFunctionCategory, ComputedFunctionMetadata, ComputedFunctionName, ComputedFunctionSignature, ComputedOptionsSource, ComputedPlan, ComputedReturnType, ComputedValueType, ConcurrentModificationError, type ContentCreateMode, type ContentExtensionDefinition, type ContentField, type ContentFieldGroup, type ContentNavigation, type ContentOpenMode, type ContentPlacement, type ContentViewCatalogueCollection, type ContentViewCatalogueInput, type ContentViewCatalogueResult, type ContentViewContext, type ContentViewDefinition, type ConversationDisplayTitleInput, CreateCustomObjectInput, type CreateDBForm, type CreateDBFormSubmission, Currency, CurrencyAttribute, type CurrencyFilterValue, type CustomContentDefinition, type DBForm, type DBFormSubmission, DEFAULT_VALIDATION_MESSAGES, DateAttribute, DateFormat, DateRangeValue, DateValue, type DayMonthValue, type DefaultResolutionContext, type DefaultViewType, DocumentAttribute, DocumentLayout, DocumentLayoutVariant, type DocumentsContentDefinition, type DraftAppendCommand, type DraftAppendReceipt, type DraftCommandGuard, type DraftContentState, type DraftFocus, type DraftObjectSettings, type DraftOperationContext, type DraftPublishCommand, type DraftRefusal, type DraftSummary, type DraftViewAuthoring, type DraftableAttribute, type DraftableObject, type DraftableSampleRecord, type DraftableState, type DraftableView, type DroppedContent, DuplicateError, type DwellMode, type DynamicValue, type EdgeQuantifier, type EditingCapability, type EditingScope, type EmailsContentDefinition, type ExhaustiveDraftObjectSettings, type ExtendedFilterRule, type FilterCombinator, type FilterOperator, type FilterRule, type FilterState, type FilterValue, type FlagResolutionContext, FolderPreset, ForbiddenError, type FormContentDefinition, type FormDensity, FormRegistry, type FormsContentDefinition, FormulaAttribute, FormulaReturnType, type GatewayFastPricing, type GatewayPriceTier, type GatewayPricing, type KanbanCollectionContentDefinition, LIST_VIEW_TAB_VISIBILITIES, type LabelContext, type ListViewLayout, ListViewTabVisibility, type ListedObjectResolver, Location, LocationAttribute, type LocationFilterProperty, LocationGranularity, MAX_PRESET_DEPTH, type MeetingsContentDefinition, MemoryNotFoundError, MultiRelationAttribute, MultiselectAttribute, type MutationReceipt, NO_VALUE_OPERATORS, type NamedTarget, type NextStep, type NoValueOperator, NonJsonValueError, NotFoundError, NotImplementedError, NumberAttribute, NumberUnit, OPERATORS_BY_TYPE, ObjectAttribute, ObjectDefinition, ObjectNotFoundError, ObjectRecord, ObjectReferencedError, type OperationDef, type OperationFamily, type OperationPace, Option, OptionPropertyAttribute, OrphanSystemAttributeError, Phone, PhoneAttribute, type PhoneFilterValue, PresetNode, PropertyAttribute, PropertySchema, PropertyType, type ProposalRevision, type ProposalTarget, ProtectedResourceError, ProtectedRoleError, type QueryState, RELATION_TARGET_ANY, RESERVED_ATTRIBUTE_NAMES, RESERVED_OBJECT_NAMES, RESOURCE_VISIBILITIES, RealtimeDeliveryError, RealtimeRateLimitedError, RealtimeSubscriptionError, type ReconcileRelationAttributesInput, type ReconciledRelationAttributes, RecordNotFoundError, RecordReference, RecordReferencedError, RelationAttribute, RelationOption, RelationOptionsResponse, type RelationPair, RelationTarget, type RelativeDateValue, type RemovedAttribute, type RenameDraftAttributeOperation, RepositoryError, RepositoryOperation, ReservedAttributeName, ReservedObjectName, ReservedObjectNameError, ResourceVisibility, RichTextAttribute, RichtextAttribute, type RichtextContentDefinition, RoleNotFoundError, RollupAttribute, RollupFunction, SCHEMA_LIMITS, SIMPLE_PROPERTY_TYPES, SYSTEM_FIELD_NAMES, type SamplePublication, SchemaError, SchemaErrorCode, SchemaPlanNotFoundError, type ScrubbedContent, SearchBackendError, SearchBackendErrorOptions, SearchBackendFailureKind, SelectAttribute, SingleRelationAttribute, type SortDirection, type SortRule, type StandardSchemaV1, StatusAttribute, StatusGroup, StorageError, StorageOperation, type StoredArtifactResult, type StoredContentDefinition, SyncCascadeError, SyncConflictError, SyncError, SystemEntityImmutableError, SystemFieldName, type TenantId, TextAttribute, TimeFormat, Timestamps, type TouchedArtifact, type TouchedDocument, type TouchedRecord, type UpdateDBForm, type UpdateDBFormSubmission, UpdateObjectInput, UserAttribute, type UserId, type UserLike, UserReferenceType, type Uuid, ValidationError, ValidationErrorDetail, type ValidationMessages, type ValueRef, type ViewContentDefinition, type ViewOperation, type ViewRead, WIRE_OMITTED_CONFIG_KEYS, asTenantId, asUserId, assertAcyclicComputedDependencies, attributeConfigSchemas, canonicalStringify, collectionContentSourceSchema, colorIdSchema, columnsSchema, compileComputedFormula, compileRollupAttribute, contentViewDefinitionSchema, contentViewDefinitionSchemaFor, createCheckboxValidator, createDateValidator, createFormAttributeValidator, createNumberValidator, createTextValidator, deepEqual, displayAttributesSchema, draftContentViewDefinitionSchema, draftContentViewDefinitionSchemaFor, evaluateComputedAst, evaluateComputedFormula, evaluateComputedFormulaWithResult, filterOperatorsByTypeForGeneration, filterStateSchema, formatComputedResult, formatZodErrors, generateId, getRollupFilterOperators, hasOptions, iconNameSchema, indexBy, inferInverseCardinality, inferRollupReturnType, isAttributeInUseError, isAttributeSortable, isBilateralRelation, isComputedFunctionName, isNoValueOperator, isNotFoundError, isObjectReferencedError, isPlainRecord, isProtectedResourceError, isRecordReferencedError, isSchemaError, isUniversalRelation, isValidationError, multiselectOptionWriteSchema, parseAttributeConfig, parseAttributeConfigForCreate, parseAttributeConfigForUpdate, parseComputedFormula, parseResourceVisibility, propertyAttributeSchema, propertyAttributeWireSchema, propertySchemaSchema, propertySchemaWireSchema, publishedViewContentDefinitionSchema, refuseForeignKeys, rejectUnknownAttributesOrThrow, relationTargetsOf, resolvePropertyDefinitions, rollupToFormulaExpression, sameStableValue, selectOptionWriteSchema, serializeCanonicalJson, serializeStableJson, sortsSchema, statusGroupSchema, statusOptionWriteSchema, validateDraft, validateDraftOrThrow, validateObject, validateObjectOrThrow, withoutUnknownOptionKeys };