@standards/schema 1.0.0-alpha.404 → 1.0.0-alpha.406

package/dist/{index-DcEEDCAI.d.mts → index-DDYMnrrw.d.ts}

@@ -1,15 +1,15 @@
 
-import { SchemaError, SchemaErrorCode, ValidationError } from "./exceptions-RCZEE1uQ.mjs";
-import { TenantId, Uuid } from "./utils-C8viP5ET.mjs";
-import { DocumentLayout, ImageShape, ListViewTabVisibility, ObjectDefinition, ObjectImage, ObjectRecord, RecordAppearance, ResourceVisibility, Timestamps, ViewerAccess } from "./objects-Dmn8ZIXZ.mjs";
-import { Attribute, AttributeType, BilateralConfig, CheckboxAttribute, Currency, CurrencyAttribute, DateAttribute, DatePrecision, DateRangeValue, DocumentAttribute, FormulaAttribute, FormulaReturnType, Location, LocationAttribute, LocationGranularity, MultiRelationAttribute, MultiselectAttribute, NumberAttribute, Option, Phone, PhoneAttribute, PropertyAttribute, PropertySchema, RelationAttribute, RelationTarget, RichtextAttribute, RollupAttribute, RollupFunction, SelectAttribute, SingleRelationAttribute, StatusAttribute, TextAttribute, TimeFormat, UserAttribute, UserReferenceType } from "./attributes-CAYOHQLt.mjs";
-import { ActivityContentDefinition, BLOCK_PERIODS, BlockContext, BlockDefinition, BlockInput, BlockWidth, CollectionAction, CollectionContentDefinition, CollectionContentSource, ColumnReference, ContentConfiguration, ContentCreateMode, ContentField, ContentFieldGroup, ContentOpenMode, ContentViewContext, ContentViewDefinition, CustomContentDefinition, DocumentsContentDefinition, DynamicValue, Eager, EmailsContentDefinition, FilterOperator, FilterRule, FilterState, FilterValue, FormContentDefinition, FormDensity, FormsContentDefinition, GridPosition, GridViolation, HeightMode, InferAttributeValue, InferQualifiedProps, InputShape, LayoutTraits, ListableBlockInput, MeetingsContentDefinition, ObjectBuilderLike, ObjectViewContext, ObjectViewDefinition, PageContentDefinition, PageViewDefinition, QualifiedDocumentAttributeBuilder, QualifiedDocumentBrand, RecordMetadata, RecordQuery, RecordQueryDefinition, RelativeDateValue, RichtextContentDefinition, SortRule, ViewContentDefinition, WithCustomAttributes, WithCustomRecordAttributes, WithoutSystemFields } from "./all-XirVn9fd.mjs";
-import { UpdateObjectInput } from "./index-Bw0zjY3f.mjs";
+import { SchemaError, SchemaErrorCode, ValidationError } from "./exceptions-DXqs9eEl.js";
+import { TenantId, Uuid } from "./utils-BUDoiMT0.js";
+import { DocumentLayout, ImageShape, ListViewTabVisibility, ObjectDefinition, ObjectImage, ObjectRecord, RecordAppearance, RecordListScope, ResourceVisibility, Timestamps, ViewerAccess } from "./objects-BaZWr4GU.js";
+import { Attribute, AttributeType, BilateralConfig, CheckboxAttribute, Currency, CurrencyAttribute, DateAttribute, DatePrecision, DateRangeValue, DocumentAttribute, FormulaAttribute, FormulaReturnType, Location, LocationAttribute, LocationGranularity, MultiRelationAttribute, MultiselectAttribute, NumberAttribute, Option, Phone, PhoneAttribute, PropertyAttribute, PropertySchema, RelationAttribute, RelationTarget, RichtextAttribute, RollupAttribute, RollupFunction, SelectAttribute, SingleRelationAttribute, StatusAttribute, TextAttribute, TimeFormat, UserAttribute, UserReferenceType } from "./attributes-DW963WrS.js";
+import { ActivityContentDefinition, BLOCK_PERIODS, BlockContext, BlockDefinition, BlockInput, BlockWidth, CollectionAction, CollectionContentDefinition, CollectionContentSource, ColumnReference, ContentConfiguration, ContentCreateMode, ContentField, ContentFieldGroup, ContentOpenMode, ContentViewContext, ContentViewDefinition, CustomContentDefinition, DocumentsContentDefinition, DynamicValue, Eager, EmailsContentDefinition, FilterOperator, FilterRule, FilterState, FilterValue, FormContentDefinition, FormDensity, FormsContentDefinition, GridPosition, GridViolation, HeightMode, InferAttributeValue, InferQualifiedProps, InputShape, LayoutTraits, ListableBlockInput, MeetingsContentDefinition, ObjectBuilderLike, ObjectViewContext, ObjectViewDefinition, PageContentDefinition, PageViewDefinition, QualifiedDocumentAttributeBuilder, QualifiedDocumentBrand, QueryState, RecordMetadata, RecordQuery, RecordQueryDefinition, RelativeDateValue, RichtextContentDefinition, SortRule, ViewContentDefinition, ViewRead, WithCustomAttributes, WithCustomRecordAttributes, WithoutSystemFields } from "./all-B85Wnp0r.js";
+import { UpdateObjectInput } from "./index-DOGNjgeo.js";
 import * as z$2 from "zod";
 import z, { z as z$1 } from "zod";
 import { ColorId, CountryIso3, CurrencyCode, IconName, MimeType } from "@standards/constants";
-import "libphonenumber-js";
 import { StandardSchemaV1, StandardSchemaV1 as StandardSchemaV1$1 } from "@standard-schema/spec";
+import "libphonenumber-js";
 //#region src/types/permissions.d.ts
 /**
  * Scope of a permission rule.
@@ -327,6 +327,13 @@ export declare const PERMISSION_CATALOG: readonly [{
       readonly id: "use";
       readonly add: readonly ["create"];
     }];
+  }, {
+    readonly id: "supervision";
+    readonly resources: readonly ["supervision"];
+    readonly levels: readonly [{
+      readonly id: "use";
+      readonly add: readonly ["create"];
+    }];
   }];
 }, {
   readonly id: "files";
@@ -570,6 +577,14 @@ export interface OperationDefinition {
    * would otherwise skip the actor-scoped checks.
    */
   actor?: "required";
+  /**
+   * `"session"`: refused 403 `SCHEMA_SESSION_REQUIRED` before its handler runs
+   * unless a person's own session authenticated the request — an API key or a
+   * delegated OAuth token never reaches it. For the routes that serve the
+   * platform UI: they carry no stability promise to an integration. A
+   * host-served operation's controller asserts it itself (`assertOperationCredential`).
+   */
+  credential?: "session";
   /** Multipart: the request carries files under `upload.field` (see `OperationUpload`). */
   upload?: OperationUpload;
   /**
@@ -1048,6 +1063,13 @@ export interface MeetingsListResponse {
    */
   totalIsExact?: boolean;
 }
+/** A record's meetings counted; `isExact: false` when `total` is a lower bound. */
+export interface RecordMeetingsCount {
+  total: number;
+  isExact: boolean;
+}
+/** A meetings answer's count as a tab states it; `null` when the server did not count. */
+export declare function recordMeetingsCount(answer: Pick<MeetingsListResponse, "total" | "totalIsExact">): RecordMeetingsCount | null;
 //#endregion
 //#region src/api/meetings.operations.d.ts
 /**
@@ -1386,103 +1408,166 @@ export interface ArtifactQuote {
   selectedText: string;
 }
 //#endregion
-//#region src/types/notifications.d.ts
-export declare const NOTIFICATION_KINDS: readonly ["fyi", "task", "question", "handoff", "system"];
-export type NotificationKind = (typeof NOTIFICATION_KINDS)[number];
-export declare const NOTIFICATION_PRIORITIES: readonly ["low", "normal", "high", "urgent"];
-export type NotificationPriority = (typeof NOTIFICATION_PRIORITIES)[number];
-/** Spec 2026-10-14 §7: priorities compare by rank, never as text ('high' < 'low' as text). */
-export declare const NOTIFICATION_PRIORITY_RANK: Record<NotificationPriority, number>;
-export declare const NOTIFICATION_SENSITIVITIES: readonly ["public", "internal", "sensitive"];
-export type NotificationSensitivity = (typeof NOTIFICATION_SENSITIVITIES)[number];
-export declare const NOTIFICATION_INBOX_STATES: readonly ["unread", "read", "archived", "snoozed"];
-export type NotificationInboxState = (typeof NOTIFICATION_INBOX_STATES)[number];
-export declare const NOTIFICATION_WORK_STATES: readonly ["none", "pending", "processing", "completed", "dismissed", "expired", "failed"];
-export type NotificationWorkState = (typeof NOTIFICATION_WORK_STATES)[number];
-export type NotificationType = string;
-export declare const NOTIFICATION_TYPE_AGENT_SESSION_WAITING_HUMAN = "agent.session.waiting_human";
-export declare const NOTIFICATION_TYPE_AGENT_TASK_ASSIGNED = "agent.task.assigned";
-export declare const NOTIFICATION_TYPE_AGENT_QUESTION_REQUESTED = "agent.question.requested";
-/** A routine run whose run status became `failed`; `payload.routineName` names the routine. */
-export declare const NOTIFICATION_TYPE_AGENT_ROUTINE_RUN_FAILED = "agent.routine_run.failed";
+//#region src/types/decisions.d.ts
+/**
+ * What a decision asks of its recipient (spec 2026-10-29 § 3): `question`,
+ * `approval`, `review` and `handoff` await an answer; `report` (work a
+ * routine did for you) and `fyi` are informational, shown under « Pour toi ».
+ */
+export declare const DECISION_KINDS: readonly ["question", "approval", "review", "handoff", "report", "fyi"];
+export type DecisionKind = (typeof DECISION_KINDS)[number];
+export declare const DECISION_INBOX_STATES: readonly ["unread", "read", "archived"];
+export type DecisionInboxState = (typeof DECISION_INBOX_STATES)[number];
+/** `pending` open, `completed` answered, `dismissed` withdrawn, `expired` expired; `none` informational. */
+export declare const DECISION_WORK_STATES: readonly ["none", "pending", "completed", "dismissed", "expired"];
+export type DecisionWorkState = (typeof DECISION_WORK_STATES)[number];
+/** What `decisions.list` filters on (`state`); absent = everything not archived. */
+export declare const DECISION_LIST_STATES: readonly ["open", "snoozed", "closed", "answered", "withdrawn", "expired", "unread", "read", "archived"];
+export type DecisionListState = (typeof DECISION_LIST_STATES)[number];
+/** What a decision can be about (§ 3): its links' target types. */
+export declare const DECISION_LINK_TARGET_TYPES: readonly ["record", "session", "document", "agent", "routine", "page", "email_thread"];
+export type DecisionLinkTargetType = (typeof DECISION_LINK_TARGET_TYPES)[number];
+/** One thing a decision is about. `objectName` only on a `record` (its page is addressed by its object). */
+export interface DecisionLink {
+  targetType: DecisionLinkTargetType;
+  targetId: string;
+  objectName?: string;
+  /**
+   * What the chip reads (a record's label, a document's title). Never
+   * stored: `decisions.list` sets it for a viewer allowed to see the target,
+   * and drops a link they may not see (spec § 5, A21).
+   */
+  label?: string;
+}
+/** `record:<object>:<id>`, or `<targetType>:<id>`: the `link` filter's and `thread_key`'s text form. */
+export declare function formatDecisionLink(link: DecisionLink): string;
+/** The inverse of {@link formatDecisionLink}; `null` for anything else (unknown type, a record without its object, an empty id). */
+export declare function parseDecisionLink(raw: string): DecisionLink | null;
+/** `decision:<id>`: the thread key of a person's first decision (§ 3c). */
+export declare function decisionThreadKey(decisionId: string): string;
+/** The longest title of a person's decision (« Nouvelle décision »). */
+export declare const DECISION_TITLE_MAX_LENGTH = 120;
+/** The longest `why` and `change` line (§ 3): enforced by the service and a database check. */
+export declare const DECISION_LINE_MAX_LENGTH = 200;
+/** The `ask_questions` batch (`{ questions: [...] }`), or an approval's tool summary. */
+export type DecisionQuestions = Readonly<Record<string, unknown>>;
+/** What the answerer chose, as stored: `{ kind: "answers", skipped, answers }` for a question batch. */
+export type DecisionAnswer = Readonly<Record<string, unknown>>;
+export type DecisionType = string;
+/**
+ * An agent's `ask_questions` call, one decision per call (spec § 4.1). Its
+ * payload is an {@link AgentDecisionPayload}; the session part stays the
+ * source and every close of it projects onto the decision (D10).
+ */
+export declare const DECISION_TYPE_AGENT_QUESTION = "agent.question";
+/** A tool call awaiting the session approver's approval (spec § 4.3); payload {@link AgentDecisionPayload}. */
+export declare const DECISION_TYPE_AGENT_APPROVAL = "agent.approval";
+/** A `request_design_review` gate awaiting the session approver (spec § 4.3); payload {@link AgentDecisionPayload}. */
+export declare const DECISION_TYPE_AGENT_REVIEW = "agent.review";
+/**
+ * An agent's `request_setup` call (spec § 4.4), a `handoff`: `questions` is
+ * the call's `{ items }`, what the connection card renders; payload an
+ * {@link AgentDecisionPayload} whose `connector` names what to set up.
+ */
+export declare const DECISION_TYPE_AGENT_SETUP = "agent.setup";
+/** A routine run whose run status became `failed`: one question to its owner, « relancer ou ignorer ? » (spec § 4.6); `payload.routineName` names the routine. */
+export declare const DECISION_TYPE_AGENT_ROUTINE_RUN_FAILED = "agent.routine_run.failed";
 /** A routine run's message to its authority, written by the `notify` tool (spec 2026-10-14 §6). */
-export declare const NOTIFICATION_TYPE_AGENT_ROUTINE_RUN_NOTICE = "agent.routine_run.notice";
+export declare const DECISION_TYPE_AGENT_ROUTINE_RUN_NOTICE = "agent.routine_run.notice";
 /**
  * A connected account a sync pass moved to `reauth_required`: its owner must
  * sign in again. `payload.provider` and `payload.account` name it.
  */
-export declare const NOTIFICATION_TYPE_CONNECTOR_CONNECTION_REAUTH_REQUIRED = "connector.connection.reauth_required";
+export declare const DECISION_TYPE_CONNECTOR_CONNECTION_REAUTH_REQUIRED = "connector.connection.reauth_required";
 /**
  * A connected account a sync pass moved to `error`: it keeps retrying, but
  * nothing has synced. `payload.provider` and `payload.account` name it.
  */
-export declare const NOTIFICATION_TYPE_CONNECTOR_CONNECTION_ERROR = "connector.connection.error";
+export declare const DECISION_TYPE_CONNECTOR_CONNECTION_ERROR = "connector.connection.error";
 /**
  * A person added to a `user` attribute marked `.notifiesOnAssign()` (#5308).
  * The subject is the record when one write is announced; several assignments
- * of one window by the same actor on one object are one notification with
+ * of one window by the same actor on one object are one decision with
  * `payload.count`. `payload` carries `objectName`, `objectLabel`,
  * `objectPluralLabel`, `recordLabel`, `actorName` and `count`.
  */
-export declare const NOTIFICATION_TYPE_RECORD_ASSIGNED = "record.assigned";
+export declare const DECISION_TYPE_RECORD_ASSIGNED = "record.assigned";
 /**
  * A person newly mentioned (`[@Name](stndrds:user/<id>)`) in a record's
  * richtext (#5828). Shaped like `record.assigned`: the subject is the record
  * when one is announced; the mentions of one window by the same actor on one
- * object are one notification with `payload.count`. `payload` carries
+ * object are one decision with `payload.count`. `payload` carries
  * `objectName`, `objectLabel`, `objectPluralLabel`, `recordLabel`,
  * `actorName` and `count`.
  */
-export declare const NOTIFICATION_TYPE_RECORD_MENTIONED = "record.mentioned";
+export declare const DECISION_TYPE_RECORD_MENTIONED = "record.mentioned";
 /**
  * Someone gave the recipient access to an agent, a routine or a record, or
  * raised it (#5303). `payload.role` is the level granted, `payload.actorName`
  * who granted it and `payload.name` what was shared; a record notice also
  * carries `payload.objectName`.
  */
-export declare const NOTIFICATION_TYPE_ACCESS_GRANTED = "access.granted";
-export declare const NOTIFICATION_TYPES_V1: readonly ["agent.session.waiting_human", "agent.task.assigned", "agent.question.requested", "agent.routine_run.failed", "agent.routine_run.notice", "connector.connection.reauth_required", "connector.connection.error", "record.assigned", "record.mentioned", "access.granted"];
-export type NotificationV1Type = (typeof NOTIFICATION_TYPES_V1)[number];
-/** Kinds that ask the recipient to act: always delivered in-app (#5448). */
-export declare const ACTIONABLE_NOTIFICATION_KINDS: readonly ["task", "question", "handoff"];
-export declare function isActionableNotificationKind(kind: NotificationKind): boolean;
-/** Where a type's delivery switches sit on the Account ▸ Notifications screen. */
-export declare const NOTIFICATION_SETTINGS_AREAS: readonly ["agents", "connectors", "assignment", "mentions", "sharing"];
-export type NotificationSettingsArea = (typeof NOTIFICATION_SETTINGS_AREAS)[number];
-/**
- * Every declared notification type, its kind and its settings area (#5448):
- * the parameters `notifications.delivery` accepts, and whether a type may be
+export declare const DECISION_TYPE_ACCESS_GRANTED = "access.granted";
+/**
+ * An automatic rebuild of the recipient's environment failed (environments
+ * v2 §4); runs keep its last published machine. An `fyi`: no link (an
+ * environment is not a link target); `payload.environmentId` and
+ * `payload.environmentName` name it and `payload.step` says where the build
+ * stopped.
+ */
+export declare const DECISION_TYPE_ENVIRONMENT_BUILD_FAILED = "environment.build.failed";
+/**
+ * A person's decision (spec § 4.5): raised from « Nouvelle décision » or
+ * « Transformer en décision ». The decision row is its source; answering it
+ * wakes no agent.
+ */
+export declare const DECISION_TYPE_PERSON = "person.decision";
+export declare const DECISION_TYPES_V1: readonly ["agent.question", "agent.approval", "agent.review", "agent.setup", "agent.routine_run.failed", "agent.routine_run.notice", "connector.connection.reauth_required", "connector.connection.error", "record.assigned", "record.mentioned", "access.granted", "environment.build.failed", "person.decision"];
+export type DecisionV1Type = (typeof DECISION_TYPES_V1)[number];
+/** Kinds that await an answer: always delivered in-app (#5448), and the only ones « À trancher » lists. */
+export declare const ACTIONABLE_DECISION_KINDS: readonly ["question", "approval", "review", "handoff"];
+export declare function isActionableDecisionKind(kind: DecisionKind): boolean;
+/** Where a type's delivery switches sit on the Account ▸ Decisions screen. */
+export declare const DECISION_SETTINGS_AREAS: readonly ["agents", "connectors", "assignment", "mentions", "sharing"];
+export type DecisionSettingsArea = (typeof DECISION_SETTINGS_AREAS)[number];
+/**
+ * Every declared decision type, its kind and its settings area (#5448):
+ * the parameters `decisions.delivery` accepts, and whether a type may be
  * turned off in-app (an actionable kind never may). The Account ▸
- * Notifications screen lists a type under its area; a type whose area is
+ * Decisions screen lists a type under its area; a type whose area is
  * `null` is not sent by anything yet and gets no row (#5449).
  */
-export declare const NOTIFICATION_TYPE_KINDS: {
-  readonly "agent.session.waiting_human": {
+export declare const DECISION_TYPE_KINDS: {
+  readonly "agent.question": {
     readonly kind: "question";
-    readonly area: "agents";
+    readonly area: null;
   };
-  readonly "agent.task.assigned": {
-    readonly kind: "task";
+  readonly "agent.approval": {
+    readonly kind: "approval";
     readonly area: null;
   };
-  readonly "agent.question.requested": {
-    readonly kind: "question";
+  readonly "agent.review": {
+    readonly kind: "review";
+    readonly area: null;
+  };
+  readonly "agent.setup": {
+    readonly kind: "handoff";
     readonly area: null;
   };
   readonly "agent.routine_run.failed": {
-    readonly kind: "system";
+    readonly kind: "question";
     readonly area: "agents";
   };
   readonly "agent.routine_run.notice": {
-    readonly kind: "fyi";
+    readonly kind: "report";
     readonly area: "agents";
   };
   readonly "connector.connection.reauth_required": {
-    readonly kind: "system";
+    readonly kind: "handoff";
     readonly area: "connectors";
   };
   readonly "connector.connection.error": {
-    readonly kind: "system";
+    readonly kind: "handoff";
     readonly area: "connectors";
   };
   readonly "record.assigned": {
@@ -1497,117 +1582,210 @@ export declare const NOTIFICATION_TYPE_KINDS: {
     readonly kind: "fyi";
     readonly area: "sharing";
   };
+  readonly "environment.build.failed": {
+    readonly kind: "fyi";
+    readonly area: "agents";
+  };
+  readonly "person.decision": {
+    readonly kind: "question";
+    readonly area: null;
+  };
 };
-/** The types the Account ▸ Notifications screen lists: those with a settings area. */
-export type NotificationSettingsType = { [Type in keyof typeof NOTIFICATION_TYPE_KINDS]: (typeof NOTIFICATION_TYPE_KINDS)[Type]["area"] extends null ? never : Type; }[keyof typeof NOTIFICATION_TYPE_KINDS];
-/** How a person receives one notification type: `notifications.delivery`'s value. */
-export interface NotificationDelivery {
+/** The types the Account ▸ Decisions screen lists: those with a settings area. */
+export type DecisionSettingsType = { [Type in keyof typeof DECISION_TYPE_KINDS]: (typeof DECISION_TYPE_KINDS)[Type]["area"] extends null ? never : Type; }[keyof typeof DECISION_TYPE_KINDS];
+/** How a person receives one decision type: `decisions.delivery`'s value (the email channel is deleted, § 3b). */
+export interface DecisionDelivery {
   inApp: boolean;
-  email: boolean;
-}
-/** The channels a notification can reach a person through, as `GET /notifications/channels` lists them. */
-export declare const NOTIFICATION_CHANNELS: readonly ["in_app", "email"];
-export type NotificationChannel = (typeof NOTIFICATION_CHANNELS)[number];
-export interface NotificationSubject {
-  type: string;
-  id: string;
 }
-/**
- * The subject types a notice can be opened on (#5450). `record` also needs
- * `payload.objectName`, since a record's page is addressed by its object.
- */
-export declare const NOTIFICATION_SUBJECT_TYPES: {
-  readonly agentSession: "agent_session";
-  readonly agent: "agent";
-  readonly routine: "routine";
-  readonly record: "record";
-  readonly page: "page";
-};
-export interface Notification {
+export interface Decision {
   id: Uuid;
   tenantId: string;
   senderActorId?: Uuid;
   rootActorId?: Uuid;
   triggeredByActorId?: Uuid;
-  kind: NotificationKind;
-  type: NotificationType;
-  subject?: NotificationSubject;
+  kind: DecisionKind;
+  type: DecisionType;
   title: string;
   summary?: string;
+  /** Why it is asked, at most {@link DECISION_LINE_MAX_LENGTH} characters. */
+  why?: string;
+  /** What answering will make possible, in the future, at most {@link DECISION_LINE_MAX_LENGTH} characters. */
+  change?: string;
+  questions?: DecisionQuestions;
+  /** Written once, with `answeredBy` and `effect`, when the decision is answered. */
+  answer?: DecisionAnswer;
+  answeredBy?: Uuid;
+  /** What the answer did, e.g. `relaunched Exécuteur`. */
+  effect?: string;
+  /** In position order; the first is the primary link. */
+  links: DecisionLink[];
+  /** Who raised it, as `decisions.list` reads it; absent elsewhere and for a system decision. */
+  sender?: DecisionSender;
   payload: Record<string, unknown>;
-  priority: NotificationPriority;
-  sensitivity: NotificationSensitivity;
-  threadKey?: string;
+  /** Always set (§ 3c): its primary link's text form, or `decision:<id>`. */
+  threadKey: string;
   idempotencyKey?: string;
-  expiresAt?: Date;
   createdAt: Date;
   updatedAt: Date;
 }
-export interface NotificationRecipient {
+/** Who raised a decision: a person, an agent, or the system. */
+export type DecisionSenderKind = "person" | "agent" | "system";
+export interface DecisionSender {
+  actorId: Uuid;
+  kind: DecisionSenderKind;
+  label: string;
+}
+/** One file of a document attached to a decision, as its recipients read it (`decisions.attachments`). */
+export interface DecisionAttachment {
+  documentId: Uuid;
+  fileId: Uuid;
+  name: string;
+  mimeType: string;
+  size: number;
+  /** A signed URL; without a storage adapter, the file's stored URL. */
+  url: string;
+}
+export interface DecisionRecipient {
   id: Uuid;
   tenantId: string;
-  notificationId: Uuid;
+  decisionId: Uuid;
   recipientActorId: Uuid;
-  inboxState: NotificationInboxState;
-  workState: NotificationWorkState;
-  lockedAt?: Date;
-  lockedByActorId?: Uuid;
+  inboxState: DecisionInboxState;
+  workState: DecisionWorkState;
   readAt?: Date;
   archivedAt?: Date;
+  /** « Plus tard »: out of « À trancher » until then. */
   snoozedUntil?: Date;
+  /** The answer time (§ 3). */
   completedAt?: Date;
   dismissedAt?: Date;
   createdAt: Date;
   updatedAt: Date;
 }
-export interface NotificationWithRecipient {
-  notification: Notification;
-  recipient: NotificationRecipient;
+export interface DecisionWithRecipient {
+  decision: Decision;
+  recipient: DecisionRecipient;
 }
-export interface NotificationListParams {
-  state?: NotificationInboxState;
-  kind?: NotificationKind;
-  /** Only notifications at or above this priority rank. */
-  minPriority?: NotificationPriority;
-  /** Only notifications created strictly after this instant (ISO). */
+export interface DecisionListParams {
+  state?: DecisionListState;
+  kind?: DecisionKind[];
+  /** {@link formatDecisionLink} text: `record:<object>:<id>`, `session:<id>`, … */
+  link?: string;
+  /** Only decisions created strictly after this instant (ISO). */
   since?: string;
   limit?: number;
   cursor?: string;
 }
-export interface NotificationListResult {
-  items: NotificationWithRecipient[];
+export interface DecisionListResult {
+  items: DecisionWithRecipient[];
   nextCursor?: string;
 }
-export interface NotificationCounts {
+/** A decision's state as an agent reads it, folded over its recipient rows. */
+export declare const DECISION_READ_STATES: readonly ["open", "answered", "withdrawn", "expired", "info"];
+export type DecisionReadState = (typeof DECISION_READ_STATES)[number];
+/** A decision as an agent reads it (spec § 8): one item per decision, not per recipient. */
+export interface DecisionView {
+  id: Uuid;
+  kind: DecisionKind;
+  type: DecisionType;
+  title: string;
+  why?: string;
+  change?: string;
+  questions?: DecisionQuestions;
+  answer?: DecisionAnswer;
+  answeredBy?: Uuid;
+  effect?: string;
+  links: DecisionLink[];
+  threadKey: string;
+  /** `open` if any row is pending; else `answered`, `withdrawn`, `expired`; `info` when every row is informational. */
+  state: DecisionReadState;
+  /** The earliest `completedAt` among its rows: the answer time. */
+  completedAt?: Date;
+  createdAt: Date;
+}
+/** What an agent's `search` narrows the decisions it can see by. */
+export interface DecisionVisibleListParams {
+  /** {@link formatDecisionLink} text. */
+  link?: string;
+  kind?: readonly DecisionKind[];
+  state?: DecisionReadState;
+  /** Free text over the title, why and change lines. */
+  query?: string;
+  limit: number;
+  offset: number;
+}
+export interface DecisionVisibleListResult {
+  items: DecisionView[];
+  hasMore: boolean;
+}
+export interface DecisionCounts {
+  /** Recipient rows `pending`, not archived, not snoozed: the sidebar number. */
+  open: number;
+  /**
+   * Unread rows of a person reaching you (a mention, an assignment): the
+   * sidebar dot, never the count (A33). A share or a report lights nothing.
+   */
   unread: number;
-  pendingWork: number;
-  urgentUnread: number;
 }
-export interface NotificationArchiveAllResult {
+export interface DecisionArchiveAllResult {
   archivedCount: number;
 }
-export interface CreateNotificationRecipientInput {
+export interface CreateDecisionRecipientInput {
   recipientActorId: Uuid;
-  inboxState?: NotificationInboxState;
-  workState?: NotificationWorkState;
+  inboxState?: DecisionInboxState;
+  workState?: DecisionWorkState;
   snoozedUntil?: Date;
 }
-export interface CreateNotificationInput {
+export interface CreateDecisionInput {
   senderActorId?: Uuid;
   rootActorId?: Uuid;
   triggeredByActorId?: Uuid;
-  kind: NotificationKind;
-  type: NotificationType;
-  subject?: NotificationSubject;
+  kind: DecisionKind;
+  type: DecisionType;
   title: string;
   summary?: string;
-  payload?: Record<string, unknown>;
-  priority?: NotificationPriority;
-  sensitivity?: NotificationSensitivity;
+  why?: string;
+  change?: string;
+  questions?: DecisionQuestions;
+  links?: DecisionLink[];
+  /** Absent: `decision:<id of this decision>`. */
   threadKey?: string;
+  payload?: Record<string, unknown>;
   idempotencyKey?: string;
-  expiresAt?: Date;
-  recipients: CreateNotificationRecipientInput[];
+  recipients: CreateDecisionRecipientInput[];
+}
+/** The one conditional answer write (§ 3, Answer immutability). */
+export interface DecisionAnswerWrite {
+  answer: DecisionAnswer;
+  /** Absent only when the source recorded nobody (a part closed before answerers were stamped). */
+  answeredBy?: Uuid;
+  effect?: string;
+}
+/**
+ * How a decision whose source is elsewhere (an agent's part, D10) closes:
+ * answered, with what the part says was answered, or withdrawn, or expired.
+ */
+export type DecisionSettlement = ({
+  workState: "completed";
+} & DecisionAnswerWrite) | {
+  workState: "dismissed" | "expired";
+};
+/** The payload every agent decision carries: what its answer routes back to. */
+export interface AgentDecisionPayload {
+  sessionId: string;
+  /** `humanRequestId(part)`: the tool call id for a question, else the approval id, else the tool call id. */
+  requestId: string;
+  toolCallId: string;
+  toolName: string;
+  definitionId?: string;
+  /** `request_setup` only: the first item's name (catalog id, key, site or login name). */
+  connector?: string;
+  /**
+   * `harness`: raised by a harness host tool (spec § 4.2). No session part
+   * waits on it: the decision is the source, and its answer starts the next
+   * harness turn.
+   */
+  lane?: "harness";
 }
 //#endregion
 //#region src/connectors/trigger-match.d.ts
@@ -1866,12 +2044,12 @@ export declare const githubTriggerMatchSchema: z$2.ZodPipe<z$2.ZodObject<{
     check: "check";
     push: "push";
     ref: "ref";
+    review: "review";
     pull_request: "pull_request";
     release: "release";
     discussion: "discussion";
     repository: "repository";
     issue: "issue";
-    review: "review";
     comment: "comment";
     workflow: "workflow";
     project_item: "project_item";
@@ -2041,9 +2219,21 @@ export declare const githubTriggerMatchSchema: z$2.ZodPipe<z$2.ZodObject<{
     field: "refType";
     value: "tag" | "branch";
   })[];
+} | {
+  family: "review";
+  actions: ("edited" | "submitted" | "dismissed")[];
+  repositories: string[];
+  sender: GithubTriggerSender;
+  conditions: ({
+    field: "prAuthor";
+    value: string;
+  } | {
+    field: "reviewState";
+    value: "approved" | "commented" | "changes_requested";
+  })[];
 } | {
   family: "pull_request";
-  actions: ("opened" | "edited" | "closed" | "reopened" | "labeled" | "assigned" | "ready_for_review" | "synchronize" | "review_requested" | "merged" | "converted_to_draft")[];
+  actions: ("closed" | "opened" | "edited" | "reopened" | "labeled" | "assigned" | "ready_for_review" | "synchronize" | "review_requested" | "merged" | "converted_to_draft")[];
   repositories: string[];
   sender: GithubTriggerSender;
   conditions: ({
@@ -2080,7 +2270,7 @@ export declare const githubTriggerMatchSchema: z$2.ZodPipe<z$2.ZodObject<{
   })[];
 } | {
   family: "discussion";
-  actions: ("closed" | "labeled" | "created" | "commented" | "answered")[];
+  actions: ("closed" | "answered" | "labeled" | "created" | "commented")[];
   repositories: string[];
   sender: GithubTriggerSender;
   conditions: ({
@@ -2103,7 +2293,7 @@ export declare const githubTriggerMatchSchema: z$2.ZodPipe<z$2.ZodObject<{
   conditions: never[];
 } | {
   family: "issue";
-  actions: ("opened" | "edited" | "closed" | "reopened" | "labeled" | "unlabeled" | "assigned" | "unassigned" | "milestoned" | "demilestoned" | "transferred" | "pinned")[];
+  actions: ("closed" | "opened" | "edited" | "reopened" | "labeled" | "unlabeled" | "assigned" | "unassigned" | "milestoned" | "demilestoned" | "transferred" | "pinned")[];
   repositories: string[];
   sender: GithubTriggerSender;
   conditions: ({
@@ -2128,18 +2318,6 @@ export declare const githubTriggerMatchSchema: z$2.ZodPipe<z$2.ZodObject<{
     field: "issueType";
     value: string;
   })[];
-} | {
-  family: "review";
-  actions: ("edited" | "submitted" | "dismissed")[];
-  repositories: string[];
-  sender: GithubTriggerSender;
-  conditions: ({
-    field: "prAuthor";
-    value: string;
-  } | {
-    field: "reviewState";
-    value: "approved" | "commented" | "changes_requested";
-  })[];
 } | {
   family: "comment";
   actions: ("deleted" | "edited" | "created")[];
@@ -2196,7 +2374,7 @@ export declare const githubTriggerMatchSchema: z$2.ZodPipe<z$2.ZodObject<{
     value: "draft" | "pull_request" | "issue";
   })[];
 }, {
-  family: "check" | "push" | "ref" | "pull_request" | "release" | "discussion" | "repository" | "issue" | "review" | "comment" | "workflow" | "project_item";
+  family: "check" | "push" | "ref" | "review" | "pull_request" | "release" | "discussion" | "repository" | "issue" | "comment" | "workflow" | "project_item";
   actions: string[];
   repositories: string[];
   sender: "any" | "me" | "human" | {
@@ -2417,12 +2595,12 @@ export declare const connectorTriggerMatchSchema: z$2.ZodUnion<readonly [z$2.Zod
     check: "check";
     push: "push";
     ref: "ref";
+    review: "review";
     pull_request: "pull_request";
     release: "release";
     discussion: "discussion";
     repository: "repository";
     issue: "issue";
-    review: "review";
     comment: "comment";
     workflow: "workflow";
     project_item: "project_item";
@@ -2592,9 +2770,21 @@ export declare const connectorTriggerMatchSchema: z$2.ZodUnion<readonly [z$2.Zod
     field: "refType";
     value: "tag" | "branch";
   })[];
+} | {
+  family: "review";
+  actions: ("edited" | "submitted" | "dismissed")[];
+  repositories: string[];
+  sender: GithubTriggerSender;
+  conditions: ({
+    field: "prAuthor";
+    value: string;
+  } | {
+    field: "reviewState";
+    value: "approved" | "commented" | "changes_requested";
+  })[];
 } | {
   family: "pull_request";
-  actions: ("opened" | "edited" | "closed" | "reopened" | "labeled" | "assigned" | "ready_for_review" | "synchronize" | "review_requested" | "merged" | "converted_to_draft")[];
+  actions: ("closed" | "opened" | "edited" | "reopened" | "labeled" | "assigned" | "ready_for_review" | "synchronize" | "review_requested" | "merged" | "converted_to_draft")[];
   repositories: string[];
   sender: GithubTriggerSender;
   conditions: ({
@@ -2631,7 +2821,7 @@ export declare const connectorTriggerMatchSchema: z$2.ZodUnion<readonly [z$2.Zod
   })[];
 } | {
   family: "discussion";
-  actions: ("closed" | "labeled" | "created" | "commented" | "answered")[];
+  actions: ("closed" | "answered" | "labeled" | "created" | "commented")[];
   repositories: string[];
   sender: GithubTriggerSender;
   conditions: ({
@@ -2654,7 +2844,7 @@ export declare const connectorTriggerMatchSchema: z$2.ZodUnion<readonly [z$2.Zod
   conditions: never[];
 } | {
   family: "issue";
-  actions: ("opened" | "edited" | "closed" | "reopened" | "labeled" | "unlabeled" | "assigned" | "unassigned" | "milestoned" | "demilestoned" | "transferred" | "pinned")[];
+  actions: ("closed" | "opened" | "edited" | "reopened" | "labeled" | "unlabeled" | "assigned" | "unassigned" | "milestoned" | "demilestoned" | "transferred" | "pinned")[];
   repositories: string[];
   sender: GithubTriggerSender;
   conditions: ({
@@ -2679,18 +2869,6 @@ export declare const connectorTriggerMatchSchema: z$2.ZodUnion<readonly [z$2.Zod
     field: "issueType";
     value: string;
   })[];
-} | {
-  family: "review";
-  actions: ("edited" | "submitted" | "dismissed")[];
-  repositories: string[];
-  sender: GithubTriggerSender;
-  conditions: ({
-    field: "prAuthor";
-    value: string;
-  } | {
-    field: "reviewState";
-    value: "approved" | "commented" | "changes_requested";
-  })[];
 } | {
   family: "comment";
   actions: ("deleted" | "edited" | "created")[];
@@ -2747,7 +2925,7 @@ export declare const connectorTriggerMatchSchema: z$2.ZodUnion<readonly [z$2.Zod
     value: "draft" | "pull_request" | "issue";
   })[];
 }, {
-  family: "check" | "push" | "ref" | "pull_request" | "release" | "discussion" | "repository" | "issue" | "review" | "comment" | "workflow" | "project_item";
+  family: "check" | "push" | "ref" | "review" | "pull_request" | "release" | "discussion" | "repository" | "issue" | "comment" | "workflow" | "project_item";
   actions: string[];
   repositories: string[];
   sender: "any" | "me" | "human" | {
@@ -3065,8 +3243,6 @@ export type NormalizedConnectorEvent = NormalizedGithubEvent | NormalizedSlackEv
 //#region src/constants/environment-harnesses.d.ts
 /** An environment name's longest accepted length, trimmed (environments spec §1.1). */
 export declare const ENVIRONMENT_NAME_MAX_CHARS = 100;
-/** A setup script's longest accepted length (spec §2.2). */
-export declare const SETUP_SCRIPT_MAX_CHARS = 64000;
 /**
  * The harness working directory, relative to the sandbox's default one
  * (`/vercel/sandbox`): the harness template joins it, and `~` is never used
@@ -3291,7 +3467,7 @@ export interface MemoryUpdateMetadata {
  * Typed agent references: `<kind>:<id>`. The one parser shared by the runtime
  * verbs and the UI tool views; it never guesses a kind from a bare id.
  */
-export declare const REFERENCE_KINDS: readonly ["record", "document", "file", "email", "thread", "event", "memory", "skill", "schema", "user", "guide", "bundle", "draft"];
+export declare const REFERENCE_KINDS: readonly ["record", "document", "file", "email", "thread", "event", "memory", "skill", "schema", "user", "guide", "bundle", "draft", "decision"];
 export type ReferenceKind = (typeof REFERENCE_KINDS)[number];
 export type Reference = {
   kind: ReferenceKind;
@@ -3484,7 +3660,7 @@ export declare const NATIVE_TOOL_GROUP_CATALOG: {
     readonly icon: "globe";
     readonly tools: readonly ["browser_launch"];
   };
-  readonly notifications: {
+  readonly decisions: {
     readonly icon: "bell";
     readonly tools: readonly ["notify"];
   };
@@ -3582,7 +3758,7 @@ export declare const GRANT_ENABLES: {
     readonly capabilities: readonly [];
     readonly tools: readonly ["browser_launch"];
   };
-  readonly notifications: {
+  readonly decisions: {
     readonly kinds: readonly [];
     readonly capabilities: readonly [];
     readonly tools: readonly ["notify"];
@@ -3707,7 +3883,7 @@ export declare function canonicalToolGroups<T extends string>(grants: readonly T
 //#endregion
 //#region src/types/agent-tool-grants.d.ts
 /** Native tool groups an agent may be granted, in catalogue order. */
-export declare const NATIVE_TOOL_GROUPS: readonly ["sandbox", "web", "image", "memory", "bulk", "activity", "orchestration", "host", "cloud-browser", "notifications"];
+export declare const NATIVE_TOOL_GROUPS: readonly ["sandbox", "web", "image", "memory", "bulk", "activity", "orchestration", "host", "cloud-browser", "decisions"];
 export type NativeToolGroup = (typeof NATIVE_TOOL_GROUPS)[number];
 /** The tool that starts the session's cloud browser — read by the runtime and the chat. */
 export declare const BROWSER_LAUNCH_TOOL_NAME = "browser_launch";
@@ -3901,6 +4077,14 @@ export type AgentSessionMode = "interactive" | "autonomous";
  */
 export declare const AGENT_SESSION_LIST_ORDERS: readonly ["createdAt", "lastActivity"];
 export type AgentSessionListOrder = (typeof AGENT_SESSION_LIST_ORDERS)[number];
+/**
+ * Whose conversations a session list reads (spec 2026-10-27 §4.4). `mine` is
+ * everyone's own history, the default and the access clause as ever. `shared`
+ * is the root conversations shared with the caller. `team` is every root
+ * conversation of the tenant, for a holder of `supervision` only (403 else).
+ */
+export declare const AGENT_SESSION_PROVENANCES: readonly ["mine", "shared", "team"];
+export type AgentSessionProvenance = (typeof AGENT_SESSION_PROVENANCES)[number];
 /** Whether a class of tool call is confirmed by a human or executed straight away. */
 export type ApprovalMode = "ask" | "auto";
 /**
@@ -4107,6 +4291,26 @@ export interface AgentTriggerDefinition {
   createdAt: Date;
   updatedAt: Date;
 }
+/** Who a routine in audience mode runs for (spec 2026-10-27 §4.2). */
+export interface RoutineAudience {
+  /** Every member of the workspace. */
+  workspace: boolean;
+  roleIds: string[];
+  actorIds: string[];
+}
+/** Why a person is in a routine audience; the most specific reason wins: the armer, then a named person, a role, the whole workspace. */
+export type RoutineAudienceSource = "workspace" | `role:${string}` | "direct" | "armer";
+/** One person a supervised audience resolves to, with why. */
+export interface RoutineAudienceMember {
+  actorId: string;
+  source: RoutineAudienceSource;
+}
+/** `GET /agents/definitions/:id/audience/preview`: the audience resolved now (spec 2026-10-27 §5). */
+export interface RoutineAudiencePreview {
+  people: Array<RoutineAudienceMember & {
+    missingConnections: string[];
+  }>;
+}
 export interface AgentSchedule {
   cron: string;
   timezone?: string;
@@ -4118,6 +4322,8 @@ export interface AgentSchedule {
    * routine. Writes that replace the schedule keep it when they omit it.
    */
   runFor?: "armer" | "audience";
+  /** Read only when `runFor === "audience"`: absent keeps the people the routine is shared with. */
+  audience?: RoutineAudience;
   /**
    * Whether an occurrence continues the conversation the last one opened
    * (#5719), under the guards of a threaded trigger fire (#4914): `true`
@@ -4283,6 +4489,12 @@ export interface AgentDefinition {
   scheduleNextRunAt?: Date;
   /** Read-only, computed for the reader by the query (spec 2026-10-08 §4.4). */
   viewerAccess?: ViewerAccess;
+  /**
+   * Read-only, computed for the reader by the query: one of their actors is a
+   * person the supervised audience resolves to, its armer counted (spec
+   * 2026-10-27 §4.2, the fan-out's own membership definition).
+   */
+  viewerInAudience?: boolean;
   /** Read-only: the number of manual grants on a private definition (0 on a workspace one). */
   sharedWithCount?: number;
   /** The harness that drives it; absent = the Standards engine (environments spec §1.4). */
@@ -4410,6 +4622,34 @@ export interface AgentSession {
   environmentId?: string;
   /** Server-managed resume state of the harness (its own session id and the like). */
   harnessState?: unknown;
+  /**
+   * Set only on a read that reached the conversation past its definition's
+   * visibility (supervision, spec 2026-10-27 §4.4) and on every row of a
+   * `shared` or `team` list: the definition's name and face, never its
+   * configuration. Absent when the reader may open the conversation itself
+   * (a `mine` list), or when the definition is gone.
+   */
+  definitionAppearance?: AgentSessionDefinitionAppearance;
+  /**
+   * Set when the reader reached another person's conversation through the
+   * read clause (a share of its root, or supervision; spec 2026-10-27 §4.4),
+   * on one session's read and on each such row of a `shared` or `team` list,
+   * whatever its definition. A supervised read is audited, so a client reads
+   * such a session once per open and never writes to it.
+   */
+  readThrough?: true;
+  /**
+   * Set only on the rows of a `lastActivity` list: this row's keyset position,
+   * opaque. The last row's, passed back as `cursor`, reads the next page.
+   */
+  listCursor?: string;
+}
+/** What a conversation's reader learns of a definition it cannot see. */
+export interface AgentSessionDefinitionAppearance {
+  name: string;
+  kind: AgentDefinitionKind;
+  label?: string;
+  avatar?: AgentAvatar;
 }
 /**
  * Lifecycle of a persisted tool part. The three `approval-*` values are the
@@ -4725,6 +4965,12 @@ export interface AgentSessionHistoryPage {
   nextCursor: string | null;
   hasMore: boolean;
   committedSeq: number;
+  /**
+   * The session's state as of this page. A reader of another person's
+   * conversation (spec 2026-10-27 §4.4) has no stream and reads the session
+   * row once per open: this is how its view learns a turn started or ended.
+   */
+  sessionState?: SessionState;
 }
 /** Canonical persisted-message order: creation time ASC, then id ASC. */
 export declare function compareAgentSessionMessages(left: Pick<AgentSessionMessage, "createdAt" | "id">, right: Pick<AgentSessionMessage, "createdAt" | "id">): number;
@@ -7624,9 +7870,9 @@ export interface EnvVarScope {
   id: string;
 }
 /**
- * Returned by list endpoints.
- * The encrypted value is NEVER included — only metadata.
- * `isSet: true` is the only indicator that a value exists.
+ * Returned by list endpoints. The encrypted value is NEVER included.
+ * `value` is the readable text of a non-sensitive variable, `null` for a
+ * sensitive one; `isSet: true` says a value exists either way.
  */
 export interface EnvVarEntry {
   id: string;
@@ -7634,6 +7880,7 @@ export interface EnvVarEntry {
   key: string;
   isSensitive: boolean;
   isSet: true;
+  value: string | null;
   scopeType: string;
   scopeId: string | null;
   /**
@@ -7679,6 +7926,42 @@ export interface EnvironmentRepositorySource {
 }
 /** Where the background build of an environment stands (environments spec §2.2). */
 export type EnvironmentBuildState = "idle" | "building" | "failed";
+/**
+ * The image an environment's machine starts from (environments v2 §1):
+ * `code` = `standards-code:default`, `documents` = `standards:default`. A
+ * `standards` environment (no harness) is always `documents`.
+ */
+export type EnvironmentImage = "code" | "documents";
+/** The machine's size, `ENVIRONMENT_SIZE_VCPUS` gives its vCPUs (environments v2 §1). */
+export type EnvironmentSize = "small" | "default" | "large";
+/**
+ * What the agent's machine may reach (environments v2 §6). `trusted` adds the
+ * package registries to the always-on hosts, `none` keeps only those, `custom`
+ * adds `allow` (domains, an optional `*.` prefix), `full` is unbounded.
+ */
+export type EnvironmentNetworkPolicy = {
+  mode: "trusted";
+} | {
+  mode: "full";
+} | {
+  mode: "none";
+} | {
+  mode: "custom";
+  allow: string[];
+};
+/** A named command a build runs after setup; every one must exit 0 (environments v2 §2). */
+export interface EnvironmentCheck {
+  name: string;
+  command: string;
+}
+/** Where the last build failed (environments v2 §3); `interrupted` = its task stopped running. */
+export interface EnvironmentBuildFailure {
+  step: "setup" | "bake" | "check" | "publish" | "interrupted";
+  /** The failed check's name, `step: "check"` only. */
+  check?: string;
+  /** `124` when the step hit its time cap. */
+  exitCode?: number;
+}
 /** An environment as every read returns it. No secret ever leaves the server. */
 export interface Environment {
   id: string;
@@ -7692,6 +7975,18 @@ export interface Environment {
   version: number;
   savedAt?: string;
   buildState: EnvironmentBuildState;
+  /** `null` unless the last build failed. */
+  buildFailure: EnvironmentBuildFailure | null;
+  image: EnvironmentImage;
+  size: EnvironmentSize;
+  networkPolicy: EnvironmentNetworkPolicy;
+  /**
+   * What the machine is made of changed since its last v2 build: a rebuild is
+   * due. Always `false` for a legacy row (`v2BuiltAt: null`).
+   */
+  stale: boolean;
+  /** Last successful v2 build (ISO); `null` = a legacy row, never rebuilt automatically. */
+  v2BuiltAt: string | null;
   /** Names of the captured login-shell variables; their values stay encrypted. */
   shellEnvNames: string[];
   /** Only with `?include=usedBy`. */
@@ -7700,9 +7995,12 @@ export interface Environment {
     conversations: number;
   };
 }
-/** One environment with its setup script and last build log (`GET /environments/:id`). */
+/** One environment with its scripts, checks and last build log (`GET /environments/:id`). */
 export interface EnvironmentDetail extends Environment {
   setupScript: string;
+  /** Runs every time a copy opens, new or resumed, before the harness. */
+  maintenanceScript: string;
+  checks: EnvironmentCheck[];
   repositories: EnvironmentRepositorySource[];
   buildLog: string;
 }
@@ -7725,12 +8023,12 @@ export interface EnvironmentList {
 /**
  * Type of resource that can be audited
  */
-export declare const AUDIT_RESOURCE_TYPES: readonly ["record", "object", "attribute", "view", "user", "role", "settings", "file", "agent", "bundle", "tenant_invitation", "api_key"];
+export declare const AUDIT_RESOURCE_TYPES: readonly ["record", "object", "attribute", "view", "user", "role", "settings", "file", "agent", "bundle", "tenant_invitation", "api_key", "agent_session"];
 export type AuditResourceType = (typeof AUDIT_RESOURCE_TYPES)[number];
 /**
  * Actions that can be audited
  */
-export declare const AUDIT_ACTIONS: readonly ["record.created", "record.updated", "record.deleted", "record.restored", "record.purged", "record.access_changed", "agent.access_changed", "object.created", "object.updated", "object.deleted", "attribute.created", "attribute.updated", "attribute.deleted", "view.created", "view.updated", "view.deleted", "bundle.synced", "bundle.removed", "bundle.added", "user.created", "user.invited", "user.updated", "user.deleted", "user.login", "user.logout", "tenant_invitation.created", "tenant_invitation.delivery_failed", "tenant_invitation.resent", "tenant_invitation.revoked", "tenant_invitation.accepted", "role.created", "role.updated", "role.deleted", "role.assigned", "role.revoked", "api_key.detached", "settings.updated", "file.uploaded", "file.updated", "file.deleted"];
+export declare const AUDIT_ACTIONS: readonly ["record.created", "record.updated", "record.deleted", "record.restored", "record.purged", "record.access_changed", "agent.access_changed", "agent_session.supervised_read", "object.created", "object.updated", "object.deleted", "attribute.created", "attribute.updated", "attribute.deleted", "view.created", "view.updated", "view.deleted", "bundle.synced", "bundle.removed", "bundle.added", "user.created", "user.invited", "user.updated", "user.deleted", "user.login", "user.logout", "tenant_invitation.created", "tenant_invitation.delivery_failed", "tenant_invitation.resent", "tenant_invitation.revoked", "tenant_invitation.accepted", "role.created", "role.updated", "role.deleted", "role.assigned", "role.revoked", "api_key.detached", "settings.updated", "file.uploaded", "file.updated", "file.deleted"];
 export type AuditAction = (typeof AUDIT_ACTIONS)[number];
 /**
  * Actor type - who performed the action
@@ -7937,6 +8235,10 @@ export declare const askQuestionsOutputSchema: z$2.ZodObject<{
   }, z$2.core.$strict>, z$2.ZodObject<{
     text: z$2.ZodString;
   }, z$2.core.$strict>]>>;
+  answeredBy: z$2.ZodOptional<z$2.ZodObject<{
+    id: z$2.ZodString;
+    name: z$2.ZodString;
+  }, z$2.core.$strip>>;
 }, z$2.core.$strip>;
 export type AskQuestionsAnswer = z$2.infer<typeof askQuestionsAnswerSchema>;
 export type AskQuestionsResult = z$2.infer<typeof askQuestionsOutputSchema>;
@@ -7946,13 +8248,23 @@ export type HumanRequestKind = "approval" | "question" | "review";
 /** The fields every tier's tool part carries (persisted part, browser `ToolPartData`). */
 export interface HumanRequestPart {
   name: string;
+  args?: unknown;
   state: ToolPartState;
   approvalId?: string | null;
   approved?: boolean;
   result?: unknown;
   error?: unknown;
 }
-/** The one ladder: an approval id wins, then the tool's family. */
+/**
+ * A person is asked a question: `ask_questions`, `request_setup`, or a `send`
+ * carrying `questions`. A `send` question is gated by an `approvalId` it never
+ * answers to, so the question test comes before the approval one.
+ */
+export declare function isQuestionPart(part: {
+  name: string;
+  args?: unknown;
+}): boolean;
+/** The one ladder: a question first, then an approval id, then the tool's family. */
 export declare function humanRequestKind(part: HumanRequestPart): HumanRequestKind | null;
 /** A person is being asked and has not decided: what the overview and the sticky zone show. */
 export declare function isAwaitingHuman(part: HumanRequestPart): boolean;
@@ -7962,7 +8274,10 @@ export declare function isAwaitingHuman(part: HumanRequestPart): boolean;
  * guards the refusal window: the decision write records `approved = false` before the closing write lands.
  */
 export declare function isBlocking(part: HumanRequestPart): boolean;
+/** A question is keyed by its call id, an approval by its approval id. */
 export declare function humanRequestId(part: {
+  name: string;
+  args?: unknown;
   approvalId?: string | null;
   toolCallId: string;
 }): string;
@@ -8669,12 +8984,86 @@ export type PageBlockData = {
 export interface PageData {
   blocks: Record<string, PageBlockData>;
 }
-/** What `POST /pages/:id/data` is asked: the reader's timezone, the record a record page shows. */
+/** What `POST /screens/page/:id` is asked: the reader's timezone, the record a record page shows. */
 export interface PageDataInput {
   hostRecordId?: string;
   timezone: string;
 }
 //#endregion
+//#region src/types/screens.d.ts
+/** What a collection lists before anyone searches or filters it. */
+export interface CollectionScopeParams {
+  q: string;
+  filters?: FilterState;
+  relationScope?: RelationScope;
+  visibility?: RecordListScope;
+}
+/**
+ * The search a collection's id list runs: its scope under the reader's query.
+ * The engine's `collectionIdListRequest` derives it; `screens.collection`
+ * answers it, so a client seeds the id-list cache entry its grid reads.
+ */
+export interface CollectionIdListParams extends CollectionScopeParams {
+  userFilters?: FilterState;
+  sorts?: SortRule[];
+}
+/** One collection's id-list request: the object it lists and the search it runs. */
+export interface CollectionIdListRequest {
+  object: string;
+  params: CollectionIdListParams;
+}
+/** The reader's own query a list opens with: its search, filters and sorts. */
+export type CollectionScreenReader = Pick<QueryState, "search" | "filters" | "sorts">;
+/**
+ * What `POST /screens/collection/:objectName` answers: the object, the view
+ * the list opens, its entry tab and, when that tab is a non-kanban
+ * collection, the id list it reads and its first page. A session UI loader:
+ * it pre-fills what the list's own reads would fetch.
+ */
+export interface CollectionScreen {
+  object: ObjectDefinition;
+  view: ViewRead;
+  /** The entry tab: the main content the request names, else the view's first one. */
+  tab: string;
+  /** `null` when the entry tab is not a collection, or is a kanban. */
+  idList: CollectionIdListRequest | null;
+  /** The id list's first page; `null` exactly when `idList` is. */
+  page: CollectionResponse<ObjectRecord> | null;
+}
+/**
+ * What a record's tab strip counts, for the tabs the engine's
+ * `recordTabCounts` names, when its `recordStripShown` draws the strip. A
+ * count the server could not read is absent (`documents`, `meetings` are
+ * `null`); the client then reads it itself.
+ */
+export interface RecordScreenCounts {
+  /** Each counted collection tab's total, zero included; a tab the reader cannot read is absent. */
+  collections: Record<string, number>;
+  /** The record's drive root items; `null` without a counted documents tab, `documents:read` or a read. */
+  documents: number | null;
+  /**
+   * The record's linked meetings, one count every meetings tab states;
+   * `null` without a meetings tab, a read, or for an archived record (the
+   * meetings route answers it nothing).
+   */
+  meetings: RecordMeetingsCount | null;
+}
+/**
+ * What `POST /screens/record/:objectName/:recordId` answers: the object, the
+ * record (archived ones included), its default record view, the objects its
+ * collection tabs read besides the host, and the counts its tab strip draws
+ * (empty when the strip is not drawn). A session UI loader: it pre-fills
+ * what the record page's own reads would fetch.
+ */
+export interface RecordScreen {
+  object: ObjectDefinition;
+  record: ObjectRecord;
+  view: ViewRead;
+  /** Every distinct non-host object a main or aside collection reads. */
+  targets: ObjectDefinition[];
+  counts: RecordScreenCounts;
+}
+//#endregion
 //#region src/types/tenant-settings.d.ts
 /**
  * Tenant-level settings.
@@ -8803,6 +9192,8 @@ export declare const USER_WORK_POSTURES: readonly UserWorkPosture[];
  */
 export declare const CONVERSATION_SURFACES: readonly ["panel", "fullscreen"];
 export type ConversationSurface = (typeof CONVERSATION_SURFACES)[number];
+/** The most profiles one `POST /users/resolve` reads; a client batches above it in chunks. */
+export declare const USERS_RESOLVE_MAX_IDS = 200;
 /**
  * User Profile - Represents application user data (authorization)
  *
@@ -8918,7 +9309,7 @@ export interface UpdateUserProfile {
 //#endregion
 //#region src/types/ai-generation.d.ts
 /** Supported generator types in V1. */
-export type AIGenerationType = "regex" | "formula" | "filter";
+export type AIGenerationType = "regex" | "formula" | "filter" | "sort";
 /** Request payload for a regex generation. */
 export interface RegexGenerationInput {
   /** Natural-language description of what to validate. */
@@ -8976,11 +9367,30 @@ export interface FilterGenerationInput {
   /** Attributes a rule may reference. */
   attributes: FilterGenerationAttribute[];
 }
+/** An attribute the sort generator may order by: one the view can sort on. */
+export interface SortGenerationAttribute {
+  id: string;
+  /** Technical name — what a sort rule references. */
+  name: string;
+  /** Human label — what the person's sentence is likely to use. */
+  label: string;
+  type: string;
+}
+/** Request payload for a sort generation (#6269). */
+export interface SortGenerationInput {
+  /** Natural-language description of the order. */
+  description: string;
+  /** Label of the object being sorted, for context. */
+  objectLabel: string;
+  /** Attributes a sort rule may reference. */
+  attributes: SortGenerationAttribute[];
+}
 /** Map from generator type to its input payload. */
 export interface AIGenerationInputMap {
   regex: RegexGenerationInput;
   formula: FormulaGenerationInput;
   filter: FilterGenerationInput;
+  sort: SortGenerationInput;
 }
 /** Token usage returned to the caller (mirrors AI SDK usage). */
 export interface AIGenerationUsage {
@@ -9033,8 +9443,6 @@ 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 {
   prompt: string;
   name: string;
@@ -9068,7 +9476,7 @@ export interface SessionImageUsage {
     requestedModelId: string;
     executedModelId: string | null;
     provider: string | null;
-    cost: ImageCost;
+    cost: UsageCost;
   }[];
 }
 //#endregion
@@ -9438,6 +9846,30 @@ export declare function getSingleAttributeFromExpression(template: string): stri
  */
 export declare function getEditableLabelAttribute(labelExpression: string, attributes: Attribute[]): Attribute | null;
 //#endregion
+//#region src/constants/environments.d.ts
+/** Every image an environment can choose (environments v2 §1). */
+export declare const ENVIRONMENT_IMAGES: readonly ["code", "documents"];
+/** Every size an environment can choose (environments v2 §1). */
+export declare const ENVIRONMENT_SIZES: readonly ["small", "default", "large"];
+/** A size's vCPUs, the machine's `resources.vcpus` (environments v2 §1). */
+export declare const ENVIRONMENT_SIZE_VCPUS: Readonly<Record<EnvironmentSize, number>>;
+/** Memory per vCPU on the machine, in GB (environments v2 §1). */
+export declare const ENVIRONMENT_MEMORY_GB_PER_VCPU = 2;
+/** The prefix of a build log's step header line: `── setup`, `── check: lint`. */
+export declare const ENVIRONMENT_BUILD_LOG_STEP_PREFIX = "── ";
+/** A setup or maintenance script's largest accepted size, in UTF-8 bytes (environments v2 §2). */
+export declare const ENVIRONMENT_SCRIPT_MAX_BYTES = 65536;
+/** At most this many checks per environment (environments v2 §2). */
+export declare const ENVIRONMENT_CHECKS_MAX = 10;
+/** A check name's longest accepted length; names are unique per environment. */
+export declare const ENVIRONMENT_CHECK_NAME_MAX_CHARS = 40;
+/** A check command's longest accepted length. */
+export declare const ENVIRONMENT_CHECK_COMMAND_MAX_CHARS = 4096;
+/** At most this many domains in a `custom` network policy (environments v2 §6). */
+export declare const ENVIRONMENT_NETWORK_ALLOW_MAX = 100;
+/** A string's size in UTF-8 bytes, the unit of `ENVIRONMENT_SCRIPT_MAX_BYTES`. */
+export declare function utf8ByteLength(value: string): number;
+//#endregion
 //#region src/constants/email-categories.d.ts
 export type SystemEmailCategoryKey = "direct" | "transactional" | "notifications" | "newsletters" | "marketing";
 export interface SystemEmailCategory {
@@ -11530,13 +11962,14 @@ export declare const HEADING_BLOCK: BlockDefinition<"heading", import("zod").Zod
   readonly description: BlockInput<"text", import("zod").ZodString, true>;
   readonly icon: BlockInput<"text", import("zod").ZodString, true>;
 }>, import("zod/v4/core").$strip>>;
-export declare const INBOX_BLOCK: BlockDefinition<"inbox", import("zod").ZodObject<InputShape<{
+export declare const DECISIONS_BLOCK: BlockDefinition<"decisions", import("zod").ZodObject<InputShape<{
   readonly kinds: BlockInput<"enum", import("zod").ZodArray<import("zod").ZodEnum<{
-    system: "system";
     question: "question";
-    fyi: "fyi";
-    task: "task";
+    approval: "approval";
+    review: "review";
     handoff: "handoff";
+    report: "report";
+    fyi: "fyi";
   }>>, true>;
   readonly limit: BlockInput<"number", import("zod").ZodNumber, true>;
 }>, import("zod/v4/core").$strip>>;
@@ -11957,13 +12390,14 @@ export declare const NATIVE_BLOCKS: readonly [BlockDefinition<"artifact_preview"
   readonly title: BlockInput<"text", import("zod").ZodString, false>;
   readonly description: BlockInput<"text", import("zod").ZodString, true>;
   readonly icon: BlockInput<"text", import("zod").ZodString, true>;
-}>, import("zod/v4/core").$strip>>, BlockDefinition<"inbox", import("zod").ZodObject<InputShape<{
+}>, import("zod/v4/core").$strip>>, BlockDefinition<"decisions", import("zod").ZodObject<InputShape<{
   readonly kinds: BlockInput<"enum", import("zod").ZodArray<import("zod").ZodEnum<{
-    system: "system";
     question: "question";
-    fyi: "fyi";
-    task: "task";
+    approval: "approval";
+    review: "review";
     handoff: "handoff";
+    report: "report";
+    fyi: "fyi";
   }>>, true>;
   readonly limit: BlockInput<"number", import("zod").ZodNumber, true>;
 }>, import("zod/v4/core").$strip>>, BlockDefinition<"meetings_upcoming", import("zod").ZodObject<InputShape<{
@@ -12123,8 +12557,8 @@ export declare class CardBuilder<TB> extends BlockContentBuilder {
   /** Shows this record of the card's object instead of the host record. */
   record(id: string): this;
 }
-export declare class InboxBuilder extends BlockContentBuilder {
-  kinds(...kinds: [NotificationKind, ...NotificationKind[]]): this;
+export declare class DecisionsBuilder extends BlockContentBuilder {
+  kinds(...kinds: [DecisionKind, ...DecisionKind[]]): this;
   limit(count: number): this;
 }
 declare class MeetingsUpcomingBuilder extends BlockContentBuilder {
@@ -12149,7 +12583,7 @@ declare function card<TB extends ObjectBuilderLike>(object: TB): CardBuilder<TB>
 declare function card(object?: string): CardBuilder<unknown>;
 /** Markdown, without raw HTML or remote images, with `{{ me }}`, `{{ today }}` and `{{ record }}`. */
 declare function text(markdown: string): BlockContentBuilder;
-declare function inbox(): InboxBuilder;
+declare function decisions(): DecisionsBuilder;
 declare function meetingsUpcoming(): MeetingsUpcomingBuilder;
 /** The viewer's email threads, newest first; every thread until a verb narrows them. */
 declare function mailbox(): MailboxBuilder;
@@ -12409,7 +12843,7 @@ export declare const content: {
   agenda: typeof agenda;
   card: typeof card;
   text: typeof text;
-  inbox: typeof inbox;
+  decisions: typeof decisions;
   meetingsUpcoming: typeof meetingsUpcoming;
   mailbox: typeof mailbox;
   page: typeof page;
@@ -12585,6 +13019,8 @@ export type CollectionSourceAddress = {
   object: string;
   relation: string;
 };
+/** A content that lists records: a collection, whatever its layout. */
+export declare function isCollectionContent(content: ViewContentDefinition): content is CollectionContentDefinition;
 /**
  * The only reading of a collection source. Branching on `source.object !== undefined`
  * at a call site treats an inverse address as "every record of the object" — the whole
@@ -13920,6 +14356,27 @@ export type AgentSessionLink = {
   sessionId: string;
 };
 //#endregion
+//#region src/utils/agent-session-list-cursor.d.ts
+/**
+ * The keyset position of a session in a `lastActivity` list (spec 2026-10-27
+ * §4.4): its activity instant and its id, the list's two sort keys. The server
+ * issues it on every row of such a list (`AgentSession.listCursor`); a client
+ * passes the last row's back as `cursor` and never reads inside it.
+ *
+ * `at` keeps the store's own precision (Postgres stamps to the microsecond):
+ * a cursor rebuilt from a JS `Date` would round it to the millisecond and skip
+ * the rows written later in that millisecond.
+ */
+export interface AgentSessionListPosition {
+  /** ISO-8601 UTC instant, `Z`-suffixed, up to six fractional digits. */
+  at: string;
+  id: string;
+}
+/** ASCII only (an instant and a uuid), so `btoa` serves both Node and the browser. */
+export declare function encodeAgentSessionListCursor(position: AgentSessionListPosition): string;
+/** The position a cursor encodes, or `null` for anything the server never issued. */
+export declare function decodeAgentSessionListCursor(cursor: string): AgentSessionListPosition | null;
+//#endregion
 //#region src/validators/agent-message.schema.d.ts
 type AgentDataChunkOptions = {
   id?: string;
@@ -13945,10 +14402,10 @@ export declare const inferenceSpeedSchema: z$2.ZodEnum<{
 }>;
 export declare const inferenceReasoningSchema: z$2.ZodEnum<{
   none: "none";
-  low: "low";
-  high: "high";
   minimal: "minimal";
+  low: "low";
   medium: "medium";
+  high: "high";
   xhigh: "xhigh";
 }>;
 export declare const inferenceRoutingSchema: z$2.ZodEnum<{
@@ -13979,10 +14436,10 @@ export declare const agentInferencePreferencesSchema: z$2.ZodObject<{
   }>>;
   reasoning: z$2.ZodOptional<z$2.ZodEnum<{
     none: "none";
-    low: "low";
-    high: "high";
     minimal: "minimal";
+    low: "low";
     medium: "medium";
+    high: "high";
     xhigh: "xhigh";
   }>>;
   routing: z$2.ZodOptional<z$2.ZodEnum<{
@@ -14016,10 +14473,10 @@ export declare const agentSessionInferenceOverridesInputSchema: z$2.ZodObject<{
   }>>;
   reasoning: z$2.ZodOptional<z$2.ZodEnum<{
     none: "none";
-    low: "low";
-    high: "high";
     minimal: "minimal";
+    low: "low";
     medium: "medium";
+    high: "high";
     xhigh: "xhigh";
   }>>;
   imageModel: z$2.ZodOptional<z$2.ZodString>;
@@ -14052,10 +14509,10 @@ export declare const agentSessionInferenceOverridesSchema: z$2.ZodObject<{
   }>>;
   reasoning: z$2.ZodOptional<z$2.ZodEnum<{
     none: "none";
-    low: "low";
-    high: "high";
     minimal: "minimal";
+    low: "low";
     medium: "medium";
+    high: "high";
     xhigh: "xhigh";
   }>>;
   imageModel: z$2.ZodOptional<z$2.ZodString>;
@@ -14090,10 +14547,10 @@ export declare const sessionInferencePatchSchema: z$2.ZodObject<{
   }>>>;
   reasoning: z$2.ZodOptional<z$2.ZodNullable<z$2.ZodEnum<{
     none: "none";
-    low: "low";
-    high: "high";
     minimal: "minimal";
+    low: "low";
     medium: "medium";
+    high: "high";
     xhigh: "xhigh";
   }>>>;
   imageModel: z$2.ZodOptional<z$2.ZodNullable<z$2.ZodString>>;
@@ -15005,6 +15462,11 @@ export declare const agentScheduleSchema: z$2.ZodObject<{
     armer: "armer";
     audience: "audience";
   }>>;
+  audience: z$2.ZodOptional<z$2.ZodObject<{
+    workspace: z$2.ZodBoolean;
+    roleIds: z$2.ZodArray<z$2.ZodUUID>;
+    actorIds: z$2.ZodArray<z$2.ZodUUID>;
+  }, z$2.core.$strip>>;
   continueConversation: z$2.ZodOptional<z$2.ZodBoolean>;
 }, z$2.core.$strip>;
 /** `event.thread_ts`: names joined by single dots, no empty segment (#4914). */
@@ -15042,12 +15504,12 @@ export declare const agentTriggerBaseSchema: z$2.ZodObject<{
       check: "check";
       push: "push";
       ref: "ref";
+      review: "review";
       pull_request: "pull_request";
       release: "release";
       discussion: "discussion";
       repository: "repository";
       issue: "issue";
-      review: "review";
       comment: "comment";
       workflow: "workflow";
       project_item: "project_item";
@@ -15217,9 +15679,21 @@ export declare const agentTriggerBaseSchema: z$2.ZodObject<{
       field: "refType";
       value: "tag" | "branch";
     })[];
+  } | {
+    family: "review";
+    actions: ("edited" | "submitted" | "dismissed")[];
+    repositories: string[];
+    sender: GithubTriggerSender;
+    conditions: ({
+      field: "prAuthor";
+      value: string;
+    } | {
+      field: "reviewState";
+      value: "approved" | "commented" | "changes_requested";
+    })[];
   } | {
     family: "pull_request";
-    actions: ("opened" | "edited" | "closed" | "reopened" | "labeled" | "assigned" | "ready_for_review" | "synchronize" | "review_requested" | "merged" | "converted_to_draft")[];
+    actions: ("closed" | "opened" | "edited" | "reopened" | "labeled" | "assigned" | "ready_for_review" | "synchronize" | "review_requested" | "merged" | "converted_to_draft")[];
     repositories: string[];
     sender: GithubTriggerSender;
     conditions: ({
@@ -15256,7 +15730,7 @@ export declare const agentTriggerBaseSchema: z$2.ZodObject<{
     })[];
   } | {
     family: "discussion";
-    actions: ("closed" | "labeled" | "created" | "commented" | "answered")[];
+    actions: ("closed" | "answered" | "labeled" | "created" | "commented")[];
     repositories: string[];
     sender: GithubTriggerSender;
     conditions: ({
@@ -15279,7 +15753,7 @@ export declare const agentTriggerBaseSchema: z$2.ZodObject<{
     conditions: never[];
   } | {
     family: "issue";
-    actions: ("opened" | "edited" | "closed" | "reopened" | "labeled" | "unlabeled" | "assigned" | "unassigned" | "milestoned" | "demilestoned" | "transferred" | "pinned")[];
+    actions: ("closed" | "opened" | "edited" | "reopened" | "labeled" | "unlabeled" | "assigned" | "unassigned" | "milestoned" | "demilestoned" | "transferred" | "pinned")[];
     repositories: string[];
     sender: GithubTriggerSender;
     conditions: ({
@@ -15304,18 +15778,6 @@ export declare const agentTriggerBaseSchema: z$2.ZodObject<{
       field: "issueType";
       value: string;
     })[];
-  } | {
-    family: "review";
-    actions: ("edited" | "submitted" | "dismissed")[];
-    repositories: string[];
-    sender: GithubTriggerSender;
-    conditions: ({
-      field: "prAuthor";
-      value: string;
-    } | {
-      field: "reviewState";
-      value: "approved" | "commented" | "changes_requested";
-    })[];
   } | {
     family: "comment";
     actions: ("deleted" | "edited" | "created")[];
@@ -15372,7 +15834,7 @@ export declare const agentTriggerBaseSchema: z$2.ZodObject<{
       value: "draft" | "pull_request" | "issue";
     })[];
   }, {
-    family: "check" | "push" | "ref" | "pull_request" | "release" | "discussion" | "repository" | "issue" | "review" | "comment" | "workflow" | "project_item";
+    family: "check" | "push" | "ref" | "review" | "pull_request" | "release" | "discussion" | "repository" | "issue" | "comment" | "workflow" | "project_item";
     actions: string[];
     repositories: string[];
     sender: "any" | "me" | "human" | {
@@ -15655,9 +16117,21 @@ export declare const agentTriggerSchema: z$2.ZodPipe<z$2.ZodType<{
       field: "refType";
       value: "tag" | "branch";
     })[];
+  } | {
+    family: "review";
+    actions: ("edited" | "submitted" | "dismissed")[];
+    repositories: string[];
+    sender: GithubTriggerSender;
+    conditions: ({
+      field: "prAuthor";
+      value: string;
+    } | {
+      field: "reviewState";
+      value: "approved" | "commented" | "changes_requested";
+    })[];
   } | {
     family: "pull_request";
-    actions: ("opened" | "edited" | "closed" | "reopened" | "labeled" | "assigned" | "ready_for_review" | "synchronize" | "review_requested" | "merged" | "converted_to_draft")[];
+    actions: ("closed" | "opened" | "edited" | "reopened" | "labeled" | "assigned" | "ready_for_review" | "synchronize" | "review_requested" | "merged" | "converted_to_draft")[];
     repositories: string[];
     sender: GithubTriggerSender;
     conditions: ({
@@ -15694,7 +16168,7 @@ export declare const agentTriggerSchema: z$2.ZodPipe<z$2.ZodType<{
     })[];
   } | {
     family: "discussion";
-    actions: ("closed" | "labeled" | "created" | "commented" | "answered")[];
+    actions: ("closed" | "answered" | "labeled" | "created" | "commented")[];
     repositories: string[];
     sender: GithubTriggerSender;
     conditions: ({
@@ -15717,7 +16191,7 @@ export declare const agentTriggerSchema: z$2.ZodPipe<z$2.ZodType<{
     conditions: never[];
   } | {
     family: "issue";
-    actions: ("opened" | "edited" | "closed" | "reopened" | "labeled" | "unlabeled" | "assigned" | "unassigned" | "milestoned" | "demilestoned" | "transferred" | "pinned")[];
+    actions: ("closed" | "opened" | "edited" | "reopened" | "labeled" | "unlabeled" | "assigned" | "unassigned" | "milestoned" | "demilestoned" | "transferred" | "pinned")[];
     repositories: string[];
     sender: GithubTriggerSender;
     conditions: ({
@@ -15742,18 +16216,6 @@ export declare const agentTriggerSchema: z$2.ZodPipe<z$2.ZodType<{
       field: "issueType";
       value: string;
     })[];
-  } | {
-    family: "review";
-    actions: ("edited" | "submitted" | "dismissed")[];
-    repositories: string[];
-    sender: GithubTriggerSender;
-    conditions: ({
-      field: "prAuthor";
-      value: string;
-    } | {
-      field: "reviewState";
-      value: "approved" | "commented" | "changes_requested";
-    })[];
   } | {
     family: "comment";
     actions: ("deleted" | "edited" | "created")[];
@@ -15933,9 +16395,21 @@ export declare const agentTriggerSchema: z$2.ZodPipe<z$2.ZodType<{
       field: "refType";
       value: "tag" | "branch";
     })[];
+  } | {
+    family: "review";
+    actions: ("edited" | "submitted" | "dismissed")[];
+    repositories: string[];
+    sender: GithubTriggerSender;
+    conditions: ({
+      field: "prAuthor";
+      value: string;
+    } | {
+      field: "reviewState";
+      value: "approved" | "commented" | "changes_requested";
+    })[];
   } | {
     family: "pull_request";
-    actions: ("opened" | "edited" | "closed" | "reopened" | "labeled" | "assigned" | "ready_for_review" | "synchronize" | "review_requested" | "merged" | "converted_to_draft")[];
+    actions: ("closed" | "opened" | "edited" | "reopened" | "labeled" | "assigned" | "ready_for_review" | "synchronize" | "review_requested" | "merged" | "converted_to_draft")[];
     repositories: string[];
     sender: GithubTriggerSender;
     conditions: ({
@@ -15972,7 +16446,7 @@ export declare const agentTriggerSchema: z$2.ZodPipe<z$2.ZodType<{
     })[];
   } | {
     family: "discussion";
-    actions: ("closed" | "labeled" | "created" | "commented" | "answered")[];
+    actions: ("closed" | "answered" | "labeled" | "created" | "commented")[];
     repositories: string[];
     sender: GithubTriggerSender;
     conditions: ({
@@ -15995,7 +16469,7 @@ export declare const agentTriggerSchema: z$2.ZodPipe<z$2.ZodType<{
     conditions: never[];
   } | {
     family: "issue";
-    actions: ("opened" | "edited" | "closed" | "reopened" | "labeled" | "unlabeled" | "assigned" | "unassigned" | "milestoned" | "demilestoned" | "transferred" | "pinned")[];
+    actions: ("closed" | "opened" | "edited" | "reopened" | "labeled" | "unlabeled" | "assigned" | "unassigned" | "milestoned" | "demilestoned" | "transferred" | "pinned")[];
     repositories: string[];
     sender: GithubTriggerSender;
     conditions: ({
@@ -16020,18 +16494,6 @@ export declare const agentTriggerSchema: z$2.ZodPipe<z$2.ZodType<{
       field: "issueType";
       value: string;
     })[];
-  } | {
-    family: "review";
-    actions: ("edited" | "submitted" | "dismissed")[];
-    repositories: string[];
-    sender: GithubTriggerSender;
-    conditions: ({
-      field: "prAuthor";
-      value: string;
-    } | {
-      field: "reviewState";
-      value: "approved" | "commented" | "changes_requested";
-    })[];
   } | {
     family: "comment";
     actions: ("deleted" | "edited" | "created")[];
@@ -16212,9 +16674,21 @@ export declare const agentTriggerSchema: z$2.ZodPipe<z$2.ZodType<{
       field: "refType";
       value: "tag" | "branch";
     })[];
+  } | {
+    family: "review";
+    actions: ("edited" | "submitted" | "dismissed")[];
+    repositories: string[];
+    sender: GithubTriggerSender;
+    conditions: ({
+      field: "prAuthor";
+      value: string;
+    } | {
+      field: "reviewState";
+      value: "approved" | "commented" | "changes_requested";
+    })[];
   } | {
     family: "pull_request";
-    actions: ("opened" | "edited" | "closed" | "reopened" | "labeled" | "assigned" | "ready_for_review" | "synchronize" | "review_requested" | "merged" | "converted_to_draft")[];
+    actions: ("closed" | "opened" | "edited" | "reopened" | "labeled" | "assigned" | "ready_for_review" | "synchronize" | "review_requested" | "merged" | "converted_to_draft")[];
     repositories: string[];
     sender: GithubTriggerSender;
     conditions: ({
@@ -16251,7 +16725,7 @@ export declare const agentTriggerSchema: z$2.ZodPipe<z$2.ZodType<{
     })[];
   } | {
     family: "discussion";
-    actions: ("closed" | "labeled" | "created" | "commented" | "answered")[];
+    actions: ("closed" | "answered" | "labeled" | "created" | "commented")[];
     repositories: string[];
     sender: GithubTriggerSender;
     conditions: ({
@@ -16274,7 +16748,7 @@ export declare const agentTriggerSchema: z$2.ZodPipe<z$2.ZodType<{
     conditions: never[];
   } | {
     family: "issue";
-    actions: ("opened" | "edited" | "closed" | "reopened" | "labeled" | "unlabeled" | "assigned" | "unassigned" | "milestoned" | "demilestoned" | "transferred" | "pinned")[];
+    actions: ("closed" | "opened" | "edited" | "reopened" | "labeled" | "unlabeled" | "assigned" | "unassigned" | "milestoned" | "demilestoned" | "transferred" | "pinned")[];
     repositories: string[];
     sender: GithubTriggerSender;
     conditions: ({
@@ -16299,18 +16773,6 @@ export declare const agentTriggerSchema: z$2.ZodPipe<z$2.ZodType<{
       field: "issueType";
       value: string;
     })[];
-  } | {
-    family: "review";
-    actions: ("edited" | "submitted" | "dismissed")[];
-    repositories: string[];
-    sender: GithubTriggerSender;
-    conditions: ({
-      field: "prAuthor";
-      value: string;
-    } | {
-      field: "reviewState";
-      value: "approved" | "commented" | "changes_requested";
-    })[];
   } | {
     family: "comment";
     actions: ("deleted" | "edited" | "created")[];
@@ -16489,9 +16951,21 @@ export declare const agentTriggerSchema: z$2.ZodPipe<z$2.ZodType<{
       field: "refType";
       value: "tag" | "branch";
     })[];
+  } | {
+    family: "review";
+    actions: ("edited" | "submitted" | "dismissed")[];
+    repositories: string[];
+    sender: GithubTriggerSender;
+    conditions: ({
+      field: "prAuthor";
+      value: string;
+    } | {
+      field: "reviewState";
+      value: "approved" | "commented" | "changes_requested";
+    })[];
   } | {
     family: "pull_request";
-    actions: ("opened" | "edited" | "closed" | "reopened" | "labeled" | "assigned" | "ready_for_review" | "synchronize" | "review_requested" | "merged" | "converted_to_draft")[];
+    actions: ("closed" | "opened" | "edited" | "reopened" | "labeled" | "assigned" | "ready_for_review" | "synchronize" | "review_requested" | "merged" | "converted_to_draft")[];
     repositories: string[];
     sender: GithubTriggerSender;
     conditions: ({
@@ -16528,7 +17002,7 @@ export declare const agentTriggerSchema: z$2.ZodPipe<z$2.ZodType<{
     })[];
   } | {
     family: "discussion";
-    actions: ("closed" | "labeled" | "created" | "commented" | "answered")[];
+    actions: ("closed" | "answered" | "labeled" | "created" | "commented")[];
     repositories: string[];
     sender: GithubTriggerSender;
     conditions: ({
@@ -16551,7 +17025,7 @@ export declare const agentTriggerSchema: z$2.ZodPipe<z$2.ZodType<{
     conditions: never[];
   } | {
     family: "issue";
-    actions: ("opened" | "edited" | "closed" | "reopened" | "labeled" | "unlabeled" | "assigned" | "unassigned" | "milestoned" | "demilestoned" | "transferred" | "pinned")[];
+    actions: ("closed" | "opened" | "edited" | "reopened" | "labeled" | "unlabeled" | "assigned" | "unassigned" | "milestoned" | "demilestoned" | "transferred" | "pinned")[];
     repositories: string[];
     sender: GithubTriggerSender;
     conditions: ({
@@ -16576,18 +17050,6 @@ export declare const agentTriggerSchema: z$2.ZodPipe<z$2.ZodType<{
       field: "issueType";
       value: string;
     })[];
-  } | {
-    family: "review";
-    actions: ("edited" | "submitted" | "dismissed")[];
-    repositories: string[];
-    sender: GithubTriggerSender;
-    conditions: ({
-      field: "prAuthor";
-      value: string;
-    } | {
-      field: "reviewState";
-      value: "approved" | "commented" | "changes_requested";
-    })[];
   } | {
     family: "comment";
     actions: ("deleted" | "edited" | "created")[];
@@ -16739,12 +17201,12 @@ export declare const agentTriggerPatchSchema: z$2.ZodObject<{
       check: "check";
       push: "push";
       ref: "ref";
+      review: "review";
       pull_request: "pull_request";
       release: "release";
       discussion: "discussion";
       repository: "repository";
       issue: "issue";
-      review: "review";
       comment: "comment";
       workflow: "workflow";
       project_item: "project_item";
@@ -16914,9 +17376,21 @@ export declare const agentTriggerPatchSchema: z$2.ZodObject<{
       field: "refType";
       value: "tag" | "branch";
     })[];
+  } | {
+    family: "review";
+    actions: ("edited" | "submitted" | "dismissed")[];
+    repositories: string[];
+    sender: GithubTriggerSender;
+    conditions: ({
+      field: "prAuthor";
+      value: string;
+    } | {
+      field: "reviewState";
+      value: "approved" | "commented" | "changes_requested";
+    })[];
   } | {
     family: "pull_request";
-    actions: ("opened" | "edited" | "closed" | "reopened" | "labeled" | "assigned" | "ready_for_review" | "synchronize" | "review_requested" | "merged" | "converted_to_draft")[];
+    actions: ("closed" | "opened" | "edited" | "reopened" | "labeled" | "assigned" | "ready_for_review" | "synchronize" | "review_requested" | "merged" | "converted_to_draft")[];
     repositories: string[];
     sender: GithubTriggerSender;
     conditions: ({
@@ -16953,7 +17427,7 @@ export declare const agentTriggerPatchSchema: z$2.ZodObject<{
     })[];
   } | {
     family: "discussion";
-    actions: ("closed" | "labeled" | "created" | "commented" | "answered")[];
+    actions: ("closed" | "answered" | "labeled" | "created" | "commented")[];
     repositories: string[];
     sender: GithubTriggerSender;
     conditions: ({
@@ -16976,7 +17450,7 @@ export declare const agentTriggerPatchSchema: z$2.ZodObject<{
     conditions: never[];
   } | {
     family: "issue";
-    actions: ("opened" | "edited" | "closed" | "reopened" | "labeled" | "unlabeled" | "assigned" | "unassigned" | "milestoned" | "demilestoned" | "transferred" | "pinned")[];
+    actions: ("closed" | "opened" | "edited" | "reopened" | "labeled" | "unlabeled" | "assigned" | "unassigned" | "milestoned" | "demilestoned" | "transferred" | "pinned")[];
     repositories: string[];
     sender: GithubTriggerSender;
     conditions: ({
@@ -17001,18 +17475,6 @@ export declare const agentTriggerPatchSchema: z$2.ZodObject<{
       field: "issueType";
       value: string;
     })[];
-  } | {
-    family: "review";
-    actions: ("edited" | "submitted" | "dismissed")[];
-    repositories: string[];
-    sender: GithubTriggerSender;
-    conditions: ({
-      field: "prAuthor";
-      value: string;
-    } | {
-      field: "reviewState";
-      value: "approved" | "commented" | "changes_requested";
-    })[];
   } | {
     family: "comment";
     actions: ("deleted" | "edited" | "created")[];
@@ -17069,7 +17531,7 @@ export declare const agentTriggerPatchSchema: z$2.ZodObject<{
       value: "draft" | "pull_request" | "issue";
     })[];
   }, {
-    family: "check" | "push" | "ref" | "pull_request" | "release" | "discussion" | "repository" | "issue" | "review" | "comment" | "workflow" | "project_item";
+    family: "check" | "push" | "ref" | "review" | "pull_request" | "release" | "discussion" | "repository" | "issue" | "comment" | "workflow" | "project_item";
     actions: string[];
     repositories: string[];
     sender: "any" | "me" | "human" | {
@@ -17502,7 +17964,7 @@ export declare const CORE_PREFERENCES: readonly [PreferenceDeclaration<"workPost
     model: string;
   } | undefined;
   routing?: "auto" | undefined;
-}>, PreferenceDeclaration<"conversationSurface", "panel" | "fullscreen">, PreferenceDeclaration<"mailboxListMode", "threads" | "messages">, PreferenceDeclaration<"home", string | null>, PreferenceDeclaration<"memory.learnFromEmail", boolean>, PreferenceDeclaration<"memory.shareWithTeam", boolean>, PreferenceDeclaration<"notifications.briefingSeenAt", string | null>, PreferenceDeclaration<"notifications.delivery", NotificationDelivery>];
+}>, PreferenceDeclaration<"conversationSurface", "panel" | "fullscreen">, PreferenceDeclaration<"mailboxListMode", "threads" | "messages">, PreferenceDeclaration<"home", string | null>, PreferenceDeclaration<"memory.learnFromEmail", boolean>, PreferenceDeclaration<"memory.shareWithTeam", boolean>, PreferenceDeclaration<"decisions.seenAt", string | null>, PreferenceDeclaration<"decisions.delivery", DecisionDelivery>];
 export type CorePreference = (typeof CORE_PREFERENCES)[number];
 export type PreferenceKey = CorePreference["key"];
 export type PreferenceValue<Key extends PreferenceKey> = Extract<CorePreference, {