@standards/schema 1.0.0-alpha.387 → 1.0.0-alpha.389

package/dist/{index-Dc724-qa.d.mts → index-BPfX8Dj2.d.mts}

@@ -814,6 +814,9 @@ export interface LinkedRecordRef {
 export type MeetingStatus = "confirmed" | "tentative" | "cancelled";
 export type MeetingParticipantRole = "organizer" | "required" | "optional";
 export type MeetingResponseStatus = "accepted" | "declined" | "tentative" | "needs_action";
+/** An invitation's answer; "needs_action" is no answer and is not sent. */
+export declare const MEETING_RESPONSES: readonly ["accepted", "declined", "tentative"];
+export type MeetingResponse = (typeof MEETING_RESPONSES)[number];
 /** Lifecycle of the recording bot's transcript for one meeting. */
 export type TranscriptStatus = "scheduled" | "recording" | "completed" | "failed";
 /** An explicit per-meeting choice that beats the workspace policy. */
@@ -1029,6 +1032,19 @@ export interface MeetingsListResponse {
   meetings: Meeting[];
   /** Offset to request next, absent when the page was the last one. */
   nextOffset?: number;
+  /**
+   * The calls a record's meetings tab lists — one per call however many of
+   * its copies the viewer sees, and only meetings the viewer can see — not
+   * the page. Present only when `meetings.forRecord` was asked a `countMode`:
+   * `null` under `countMode: "none"`, which is "not counted" and never "zero".
+   */
+  total?: number | null;
+  /**
+   * False when `total` is a lower bound rather than the real count, as on the
+   * records page: see `ContinuationPage.totalIsExact`. Present beside a
+   * numeric `total`; derive it from the response, never from the mode asked.
+   */
+  totalIsExact?: boolean;
 }
 //#endregion
 //#region src/api/meetings.operations.d.ts
@@ -1059,7 +1075,7 @@ export declare const meetingsQuery: z$2.ZodDefault<z$2.ZodObject<{
   limit: z$2.ZodOptional<z$2.ZodNumber>;
   offset: z$2.ZodOptional<z$2.ZodNumber>;
 }, z$2.core.$strip>>;
-/** `POST /meetings/records/:recordId` — the record's email attributes and the same query. */
+/** `POST /meetings/records/:recordId` — the record's email attributes, the same query and the count asked for. */
 export declare const recordMeetingsBody: z$2.ZodDefault<z$2.ZodObject<{
   emailAttributeIds: z$2.ZodOptional<z$2.ZodArray<z$2.ZodString>>;
   query: z$2.ZodOptional<z$2.ZodObject<{
@@ -1075,6 +1091,11 @@ export declare const recordMeetingsBody: z$2.ZodDefault<z$2.ZodObject<{
     limit: z$2.ZodOptional<z$2.ZodNumber>;
     offset: z$2.ZodOptional<z$2.ZodNumber>;
   }, z$2.core.$strip>>;
+  countMode: z$2.ZodOptional<z$2.ZodEnum<{
+    exact: "exact";
+    none: "none";
+    estimated: "estimated";
+  }>>;
 }, z$2.core.$strip>>;
 export declare const meetingsOperations: {
   search: Operation<{
@@ -1227,6 +1248,11 @@ export declare const meetingsOperations: {
         limit: z$2.ZodOptional<z$2.ZodNumber>;
         offset: z$2.ZodOptional<z$2.ZodNumber>;
       }, z$2.core.$strip>>;
+      countMode: z$2.ZodOptional<z$2.ZodEnum<{
+        exact: "exact";
+        none: "none";
+        estimated: "estimated";
+      }>>;
     }, z$2.core.$strip>;
     readonly output: OutputType<MeetingsListResponse>;
   }>;
@@ -1363,6 +1389,15 @@ export declare const NOTIFICATION_TYPE_CONNECTOR_CONNECTION_ERROR = "connector.c
  * `objectPluralLabel`, `recordLabel`, `actorName` and `count`.
  */
 export declare const NOTIFICATION_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
+ * `objectName`, `objectLabel`, `objectPluralLabel`, `recordLabel`,
+ * `actorName` and `count`.
+ */
+export declare const NOTIFICATION_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`
@@ -1370,13 +1405,13 @@ export declare const NOTIFICATION_TYPE_RECORD_ASSIGNED = "record.assigned";
  * 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", "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", "sharing"];
+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):
@@ -1418,6 +1453,10 @@ export declare const NOTIFICATION_TYPE_KINDS: {
     readonly kind: "fyi";
     readonly area: "assignment";
   };
+  readonly "record.mentioned": {
+    readonly kind: "fyi";
+    readonly area: "mentions";
+  };
   readonly "access.granted": {
     readonly kind: "fyi";
     readonly area: "sharing";
@@ -3109,7 +3148,7 @@ export declare function harnessModelChoices(harness: EnvironmentHarnessId, model
  * 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", "draft"];
+export declare const REFERENCE_KINDS: readonly ["record", "document", "file", "email", "thread", "event", "memory", "skill", "schema", "user", "guide", "catalog", "draft"];
 export type ReferenceKind = (typeof REFERENCE_KINDS)[number];
 export type Reference = {
   kind: ReferenceKind;
@@ -3336,11 +3375,11 @@ export declare const RESOURCE_KIND_CATALOG: {
   };
   readonly browser: {
     readonly icon: "link";
-    readonly tools: readonly ["browser_autopilot", "browser_batch", "browser_computer", "browser_find", "browser_form_input", "browser_get_text", "browser_javascript", "browser_navigate", "browser_read_page", "browser_tabs"];
+    readonly tools: readonly ["browser_autopilot", "browser_batch", "browser_computer", "browser_find", "browser_form_input", "browser_get_text", "browser_javascript", "browser_navigate", "browser_read_page", "browser_sign_in", "browser_tabs"];
   };
   readonly "browser-profile": {
     readonly icon: "globe";
-    readonly tools: readonly ["browser_launch", "browser_autopilot", "browser_batch", "browser_computer", "browser_find", "browser_form_input", "browser_get_text", "browser_javascript", "browser_navigate", "browser_read_page", "browser_tabs"];
+    readonly tools: readonly ["browser_launch", "browser_autopilot", "browser_batch", "browser_computer", "browser_find", "browser_form_input", "browser_get_text", "browser_javascript", "browser_navigate", "browser_read_page", "browser_sign_in", "browser_tabs"];
   };
   readonly login: {
     readonly icon: "key";
@@ -3442,12 +3481,12 @@ export declare const GRANT_ENABLES: {
   readonly browser: {
     readonly kinds: readonly [];
     readonly capabilities: readonly [];
-    readonly tools: readonly ["browser_autopilot", "browser_batch", "browser_computer", "browser_find", "browser_form_input", "browser_get_text", "browser_javascript", "browser_navigate", "browser_read_page", "browser_tabs"];
+    readonly tools: readonly ["browser_autopilot", "browser_batch", "browser_computer", "browser_find", "browser_form_input", "browser_get_text", "browser_javascript", "browser_navigate", "browser_read_page", "browser_sign_in", "browser_tabs"];
   };
   readonly "browser-profile": {
     readonly kinds: readonly [];
     readonly capabilities: readonly [];
-    readonly tools: readonly ["browser_launch", "browser_autopilot", "browser_batch", "browser_computer", "browser_find", "browser_form_input", "browser_get_text", "browser_javascript", "browser_navigate", "browser_read_page", "browser_tabs"];
+    readonly tools: readonly ["browser_launch", "browser_autopilot", "browser_batch", "browser_computer", "browser_find", "browser_form_input", "browser_get_text", "browser_javascript", "browser_navigate", "browser_read_page", "browser_sign_in", "browser_tabs"];
   };
   readonly login: {
     readonly kinds: readonly [];
@@ -4045,7 +4084,7 @@ export interface AgentTodoPlanView {
   id: string;
   sessionId: string;
   status: AgentTodoPlanStatus;
-  todos: AITodoItem[];
+  todos: AgentTodoPlanViewItem[];
   version: number;
   createdAt: string;
   updatedAt: string;
@@ -5127,6 +5166,65 @@ export interface AITodoItem {
   description: string;
   status: AITodoStatus;
   updatedAt?: number;
+  /**
+   * What an architect build todo is anchored on in the draft. A targeted
+   * todo's status is the server's: `draft_schema` recomputes it from the
+   * folded draft, and `write_todos` keeps the stored one.
+   */
+  target?: AITodoTarget;
+}
+/**
+ * The phases of an architect build, always worked in this order: a plan
+ * whose targeted todos run out of this order is refused.
+ */
+export declare const TODO_PHASES: readonly ["objects", "fields", "relations", "views", "samples"];
+export type AITodoPhase = (typeof TODO_PHASES)[number];
+/** Where a build todo is anchored, by phase. */
+export type AITodoTarget =
+/** Completed when the folded draft has the object. */
+{
+  phase: "objects";
+  objectName: string;
+} |
+/** Completed when every named attribute is on the object. */
+{
+  phase: "fields";
+  objectName: string;
+  attributes: string[];
+} |
+/** Completed when every named relation attribute is on the object. */
+{
+  phase: "relations";
+  objectName: string;
+  attributes: string[];
+} |
+/**
+ * Completed when an executed operation of the draft writes that view (and,
+ * when named, that content). The empty default views `add_object` folds do
+ * not count, nor does a view that is merely published.
+ */
+{
+  phase: "views";
+  objectName: string;
+  viewName: string;
+  contentName?: string;
+} | {
+  phase: "views";
+  pageId: string;
+} |
+/** Completed when the draft holds at least one sample record of the object. */
+{
+  phase: "samples";
+  objectName: string;
+};
+/**
+ * A todo as clients read it: a target is exposed by its phase only, which is
+ * all the progress surfaces need.
+ */
+export interface AgentTodoPlanViewItem extends Omit<AITodoItem, "target"> {
+  target?: {
+    phase: AITodoPhase;
+  };
 }
 /**
  * Persisted bounds on a todo, beside the type they constrain.
@@ -6016,6 +6114,88 @@ export interface BundleSyncResult {
   }>;
 }
 //#endregion
+//#region src/types/catalog.d.ts
+/** The languages a catalog piece compiles in; the routes accept no other. */
+export declare const CATALOG_LOCALES: readonly ["fr", "en"];
+export type CatalogLocale = (typeof CATALOG_LOCALES)[number];
+/** What a catalog entry installs; the `kind` filter of `catalog.list` accepts no other. */
+export declare const CATALOG_KINDS: readonly ["object", "view", "agent"];
+export type CatalogEntryKind = (typeof CATALOG_KINDS)[number];
+/** Where an installed piece came from; stamped on every draft operation it produces. */
+export interface OperationOrigin {
+  entryId: string;
+  version: number;
+  packId?: string;
+  /** The language the piece was compiled in; its install row records it. */
+  locale: CatalogLocale;
+}
+export interface CatalogSummary {
+  label: string;
+  description: string;
+  icon: IconName;
+  category?: string;
+}
+export interface CatalogEntrySummary extends CatalogSummary {
+  id: string;
+  kind: CatalogEntryKind;
+  version: number;
+  requires: string[];
+  installed: boolean;
+}
+export interface CatalogPackSummary extends CatalogSummary {
+  id: string;
+  version: number;
+  entries: string[];
+  hasSamples: boolean;
+  installed: boolean;
+}
+/** A summary plus the ids it pulls in when installed. */
+export type CatalogEntryDetail = (CatalogEntrySummary | CatalogPackSummary) & {
+  closure: string[];
+};
+export interface CatalogSelection {
+  entries?: string[];
+  packs?: string[];
+}
+export type CatalogDecision = "bind" | "skip" | {
+  rename: string;
+};
+export interface CatalogPlanPiece {
+  entryId: string;
+  kind: CatalogEntryKind;
+  status: "new" | "collides";
+  existingName?: string;
+  installable: boolean;
+  reason?: string;
+  inverseRelations?: {
+    objectName: string;
+    attributeName: string;
+  }[];
+}
+export interface CatalogInstallPlan {
+  pieces: CatalogPlanPiece[];
+  fingerprint: string;
+}
+export interface CatalogInstallInput {
+  selection: CatalogSelection;
+  locale: CatalogLocale;
+  withSamples: boolean;
+  decisions: Record<string, CatalogDecision>;
+  fingerprint: string;
+}
+export interface CatalogInstallResult {
+  installed: {
+    entryId: string;
+    version: number;
+    targetKind: CatalogEntryKind;
+    targetId: string;
+  }[];
+  failed: {
+    entryId: string;
+    reason: string;
+  }[];
+}
+//#endregion
 //#region src/types/schema-state.d.ts
 type Without<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
 export type ViewSourceOwner = "core" | `bundle:${string}` | `source:${string}`;
@@ -10633,10 +10813,13 @@ export declare const RECORD_LINKS_BLOCK: BlockDefinition<"record_links", import(
   /** The chosen record's object; absent, the block centres on the host record. */
   readonly object: BlockInput<"object", import("zod").ZodString, true>;
   readonly record: BlockInput<"record", import("zod").ZodString, true>;
-  /** How many rings are expanded on open; two when absent. */
+  /** How many rings are expanded on open, one to five; two when absent. */
   readonly depth: ListableBlockInput<"enum", import("zod").ZodEnum<{
     1: "1";
     2: "2";
+    3: "3";
+    4: "4";
+    5: "5";
   }>, true>;
 }>, import("zod/v4/core").$strip>>;
 /**
@@ -11027,10 +11210,13 @@ export declare const NATIVE_BLOCKS: readonly [BlockDefinition<"artifact_preview"
   /** The chosen record's object; absent, the block centres on the host record. */
   readonly object: BlockInput<"object", import("zod").ZodString, true>;
   readonly record: BlockInput<"record", import("zod").ZodString, true>;
-  /** How many rings are expanded on open; two when absent. */
+  /** How many rings are expanded on open, one to five; two when absent. */
   readonly depth: ListableBlockInput<"enum", import("zod").ZodEnum<{
     1: "1";
     2: "2";
+    3: "3";
+    4: "4";
+    5: "5";
   }>, true>;
 }>, import("zod/v4/core").$strip>>];
 //#endregion
@@ -11811,6 +11997,20 @@ export declare function collectContentViewCatalogue(input: ContentViewCatalogueI
  * `rule` discriminator that carried it. A reader refuses every violation.
  */
 export declare function validateStoredViews(input: ContentViewCatalogueInput): void;
+/** The first rule a view breaks and where: `<message> (<path>)`, the path left out at the root. */
+export declare function describeViewIssue(issue: {
+  message: string;
+  path: readonly PropertyKey[];
+}): string;
+/**
+ * Says which view was refused and the first rule it breaks: the bare "Invalid
+ * content view" reached the person and the agent with nothing to fix (#5888).
+ * The architect's publish blockers word the same refusal through it (#5932).
+ */
+export declare function invalidViewMessage(raw: unknown, issue: {
+  message: string;
+  path: readonly PropertyKey[];
+} | undefined): string;
 /** Resolves names against a collected snapshot; it performs no writes or adoption. */
 export declare function validateContentViewCatalogue(input: ContentViewCatalogueInput): ContentViewCatalogueResult;
 //#endregion
@@ -12356,6 +12556,8 @@ export interface ArchitectChange {
   after: unknown;
   /** The agent's note on this operation, when it wrote one (D9). */
   note?: string;
+  /** Set when the operation was produced by a catalog install. */
+  origin?: OperationOrigin;
 }
 /** One operation of a draft as stored and sent: its shared fields plus its type's payload. */
 export type ViewOperation = BaseOperation & Record<string, unknown>;
@@ -12448,6 +12650,8 @@ export interface BaseOperation {
   type: string;
   /** The architect's own sentence — what it does and why; ≤ 160 chars. Persisted with the operation. */
   note?: string;
+  /** Set on every operation a catalog install produced; the publish records it in `catalog_installs`. */
+  origin?: OperationOrigin;
 }
 //#endregion
 //#region src/architect/proposal-types.d.ts
@@ -12489,6 +12693,45 @@ export declare const namedTargetSchema: z$2.ZodUnion<readonly [z$2.ZodObject<{
 }, z$2.core.$strict>]>;
 export type NamedTarget = z$2.infer<typeof namedTargetSchema>;
 export declare function parseNamedTarget(input: unknown): NamedTarget;
+/** How much a step deserves the person's eye: a new object is dwelt on, a rename flown past. */
+export type DraftStepPace = "major" | "normal" | "minor";
+/**
+ * An operation's focus, resolved on the draft it was committed to: the ids the
+ * draft minted, and what a route needs that the operation itself does not
+ * name. A step routes from this alone, with no catalogue and no projection.
+ */
+export interface DraftStepFocus extends DraftFocus {
+  /** The focused view's id, the minted one for a view only the draft holds. */
+  viewId?: string;
+  /** The focused content's id within its view. */
+  contentId?: string;
+  /** How the focused object view is reached: its context, and whether it is its object's default. */
+  viewRoute?: {
+    context: "collection" | "record";
+    default: boolean;
+  };
+  /**
+   * How the focused page is reached: a record page through its object's record
+   * view (on the tab rendering it, when one does), a standalone page by the key
+   * its route carries.
+   */
+  pageRoute?: {
+    objectName: string;
+    tabName?: string;
+  } | {
+    key: string;
+  };
+}
+/** One committed operation, as the follow shows it. */
+export interface DraftStep {
+  /** The draft version the operation's commit produced. */
+  version: number;
+  operationId: string;
+  focus: DraftStepFocus;
+  pace: DraftStepPace;
+  /** The agent's note on the operation, when it wrote one. */
+  note?: string;
+}
 export interface MutationReceipt {
   operationIds: string[];
   revision: ProposalRevision;
@@ -12498,10 +12741,81 @@ export interface MutationReceipt {
   }>;
   /** Operation id → the agent's note, for the committed operations that carry one. Absent when none does. */
   notes?: Readonly<Record<string, string>>;
+  /**
+   * One step per operation this receipt committed, in order. Empty for a
+   * receipt that commits none (a removal, a discard, a publication); absent
+   * from a receipt sent before steps existed.
+   */
+  steps?: DraftStep[];
+}
+/**
+ * What a publish refusal or a publish blocker names: an object, one of its
+ * attributes or views, or a page (addressed by id). Its kind is the most
+ * specific key present.
+ */
+export interface PublishTarget {
+  objectName?: string;
+  attributeName?: string;
+  viewName?: string;
+  pageId?: string;
+}
+export type PublishTargetKind = "object" | "attribute" | "view" | "page";
+/** The target a publish refusal carries in its `details.target`. */
+export interface PublishRefusalTarget extends PublishTarget {
+  kind: PublishTargetKind;
+}
+/**
+ * The code a stored publish refusal carries: the refusal's own
+ * `SchemaErrorCode`, or `INTERNAL` for a failure that was not a refusal at
+ * all, whose server text is never stored (#5933).
+ */
+export type PublishOutcomeCode = SchemaErrorCode | "INTERNAL";
+/**
+ * Why the last publish of a draft was refused, as the draft row keeps it
+ * (`schema_drafts.last_publish_error`). Written after the publish rolled
+ * back, so it survives the rollback and a response the client never read.
+ */
+export interface LastPublishError {
+  code: PublishOutcomeCode;
+  /** What was refused, when the refusal named it. */
+  target?: PublishRefusalTarget;
+  /** The last operation of the draft that changed `target`. */
+  operationId?: string;
+  /** The refusal's own words: only a refusal of the draft (a 4xx) keeps them. */
+  message?: string;
+  /** ISO 8601. */
+  at: string;
+}
+/**
+ * How the owner's last publication ended, whichever is later: its most
+ * recent published draft, or the refusal stored on its composing draft.
+ */
+export interface LastPublication {
+  draftId: string;
+  outcome: "published" | "refused";
+  /** ISO 8601: when the draft was published, or when the refusal was stored. */
+  at: string;
+  /** Present when `outcome` is `refused`. */
+  error?: LastPublishError;
+}
+/**
+ * The publish rules the append runs on the folded draft, beyond its own: what
+ * no single operation breaks, so the append accepts it, and the publish then
+ * refuses (#5932).
+ */
+export type PublishBlockerRule = "computed-cycle" | "bilateral-pair" | "content-view";
+/** One thing the publish would refuse in the draft as it stands. */
+export interface PublishBlocker {
+  rule: PublishBlockerRule;
+  target: PublishTarget;
+  /** The refusal the publish would raise, word for word. */
+  message: string;
 }
 /** HTTP append result: enough to continue editing without a second guard request. */
 export interface DraftAppendReceipt extends MutationReceipt {
   commandGuard: DraftCommandGuard;
+  /** What the publish would refuse in the draft after this append; empty when nothing. */
+  publishBlockers: PublishBlocker[];
 }
 export interface DraftPublishCommand {
   revision: ProposalRevision;
@@ -13680,6 +13994,15 @@ export declare const todoItemSchema: z$2.ZodObject<{
   }>;
   result: z$2.ZodOptional<z$2.ZodString>;
   updatedAt: z$2.ZodOptional<z$2.ZodNumber>;
+  target: z$2.ZodOptional<z$2.ZodObject<{
+    phase: z$2.ZodEnum<{
+      fields: "fields";
+      relations: "relations";
+      views: "views";
+      objects: "objects";
+      samples: "samples";
+    }>;
+  }, z$2.core.$strict>>;
 }, z$2.core.$strict>;
 export declare const todoPlanSchema: z$2.ZodObject<{
   id: z$2.ZodString;
@@ -13700,6 +14023,15 @@ export declare const todoPlanSchema: z$2.ZodObject<{
     }>;
     result: z$2.ZodOptional<z$2.ZodString>;
     updatedAt: z$2.ZodOptional<z$2.ZodNumber>;
+    target: z$2.ZodOptional<z$2.ZodObject<{
+      phase: z$2.ZodEnum<{
+        fields: "fields";
+        relations: "relations";
+        views: "views";
+        objects: "objects";
+        samples: "samples";
+      }>;
+    }, z$2.core.$strict>>;
   }, z$2.core.$strict>>;
   version: z$2.ZodNumber;
   createdAt: z$2.ZodString;