@standards/schema 1.0.0-alpha.434 → 1.0.0-alpha.438

package/dist/{index-D15KKwMX.d.ts → index-CTEU8_BN.d.ts}

@@ -917,8 +917,12 @@ export declare const DECISION_TITLE_MAX_LENGTH = 120;
 export declare const DECISION_LINE_MAX_LENGTH = 200;
 /** The `questions` batch of a `send` (`{ questions: [...] }`), or an approval's tool summary. */
 export type DecisionQuestions = Readonly<Record<string, unknown>>;
-/** Where an answer was given, when not in the app: a chat front's card (spec § 2). */
-export type DecisionAnswerOrigin = "slack";
+/**
+ * Where an answer was given, when not in the app: a chat front's card (spec
+ * § 2), a Slack card or a WhatsApp card on the person's private front (spec
+ * 2026-11-09 § 5 "Cards").
+ */
+export type DecisionAnswerOrigin = "slack" | "whatsapp";
 /**
  * What the answerer chose, as stored: `{ kind: "answers", skipped, answers }`
  * for a question batch. `via` names where it was given when not in the app;
@@ -3885,6 +3889,13 @@ export declare function isWildcard(ref: Reference): boolean;
  * the scopes differ and a user may connect one without the other. */
 export declare const CONNECTOR_PROVIDER_IDS: readonly ["gmail", "outlook", "google-calendar", "outlook-calendar", "github", "slack"];
 export type ConnectorProviderId = (typeof CONNECTOR_PROVIDER_IDS)[number];
+/**
+ * Providers a person can chat with an agent on (private fronts): a
+ * workspace's Slack app, and the one WhatsApp number of the Standards
+ * instance, which is no connector.
+ */
+export declare const CHAT_PROVIDERS: readonly ["slack", "whatsapp"];
+export type ChatProvider = (typeof CHAT_PROVIDERS)[number];
 /** Providers that sync a mailbox. */
 export type EmailConnectorProviderId = Extract<ConnectorProviderId, "gmail" | "outlook">;
 /** Providers that sync a calendar. */
@@ -4781,6 +4792,7 @@ export declare const agentSessionSchema: z$2.ZodObject<{
     execute: "execute";
   }>;
   focus: z$2.ZodBoolean;
+  personConversation: z$2.ZodBoolean;
   workModeVersion: z$2.ZodNumber;
   version: z$2.ZodNumber;
   loadedToolsets: z$2.ZodArray<z$2.ZodString>;
@@ -4929,6 +4941,7 @@ export declare const setAgentSessionWorkPostureResultSchema: z$2.ZodDiscriminate
       execute: "execute";
     }>;
     focus: z$2.ZodBoolean;
+    personConversation: z$2.ZodBoolean;
     workModeVersion: z$2.ZodNumber;
     version: z$2.ZodNumber;
     loadedToolsets: z$2.ZodArray<z$2.ZodString>;
@@ -5074,6 +5087,7 @@ export declare const setAgentSessionWorkPostureResultSchema: z$2.ZodDiscriminate
       execute: "execute";
     }>;
     focus: z$2.ZodBoolean;
+    personConversation: z$2.ZodBoolean;
     workModeVersion: z$2.ZodNumber;
     version: z$2.ZodNumber;
     loadedToolsets: z$2.ZodArray<z$2.ZodString>;
@@ -6896,6 +6910,7 @@ export declare const agentDefinitionSchema: z$2.ZodObject<{
     maxRetries: z$2.ZodOptional<z$2.ZodNumber>;
   }, z$2.core.$strip>>;
   autoDecide: z$2.ZodOptional<z$2.ZodBoolean>;
+  singleConversation: z$2.ZodOptional<z$2.ZodBoolean>;
   active: z$2.ZodOptional<z$2.ZodBoolean>;
   scheduleNextRunAt: z$2.ZodOptional<z$2.ZodCodec<z$2.ZodISODateTime, z$2.ZodDate>>;
   viewerAccess: z$2.ZodOptional<z$2.ZodEnum<{
@@ -7079,6 +7094,7 @@ export declare const agentSetupResponseSchema: z$2.ZodObject<{
       maxRetries: z$2.ZodOptional<z$2.ZodNumber>;
     }, z$2.core.$strip>>;
     autoDecide: z$2.ZodOptional<z$2.ZodBoolean>;
+    singleConversation: z$2.ZodOptional<z$2.ZodBoolean>;
     active: z$2.ZodOptional<z$2.ZodBoolean>;
     scheduleNextRunAt: z$2.ZodOptional<z$2.ZodCodec<z$2.ZodISODateTime, z$2.ZodDate>>;
     viewerAccess: z$2.ZodOptional<z$2.ZodEnum<{
@@ -14153,6 +14169,12 @@ export interface AIBatchQuestionAnswer {
    * optional; only a chosen option's precision is kept.
    */
   notes?: Record<string, Record<string, string>>;
+  /**
+   * The files the person added on the card to go with the answer, each a
+   * `file:<id>` or `document:<id>` ref; empty when none was. Files the
+   * question itself attached are not among them.
+   */
+  addedFiles?: string[];
 }
 /**
  * Todo item status
@@ -15244,7 +15266,11 @@ export interface RecordAggregateGroup {
   /**
    * The measure over the group's records. With no value to measure, `count`
    * and `sum` read 0; `avg`, `min` and `max` read `null`. `null` too when
-   * the answer met several currencies: see `byCurrency`.
+   * the answer met several currencies: see `byCurrency`. A `cumulative` sum
+   * along a date grouping reads the running total of the group's series (its
+   * other key) from the oldest bucket through this one; with no date grouping,
+   * the plain sum. It adds only the groups returned: a `truncated` answer
+   * grouped by a field first leaves the cut groups out of their series.
    */
   value: number | null;
   /**
@@ -15264,12 +15290,13 @@ export interface RecordAggregates {
   groups: RecordAggregateGroup[];
   /**
    * The measure over every matching record, the groups cut by the cap
-   * included; `null` as `value`, and `null` when several currencies were met.
+   * included (for `cumulative`, their plain sum); `null` as `value`, and
+   * `null` when several currencies were met.
    */
   total: number | null;
   /**
    * The total per currency, sorted by currency code, present only for a
-   * `sum | avg | min | max` over a currency attribute that met more than one
+   * `sum | cumulative | avg | min | max` over a currency attribute that met more than one
    * currency (then `total` and `previous` are `null` and `currency` is absent).
    */
   byCurrency?: CurrencyValue[];
@@ -15287,7 +15314,7 @@ export interface RecordAggregates {
   appliedBucket2?: AggregateBucket;
   /**
    * The currency code (`"USD"`) the measure was taken in: present only for a
-   * `sum | avg | min | max` over a currency attribute that met at least one
+   * `sum | cumulative | avg | min | max` over a currency attribute that met at least one
    * record, in the current or the previous period, all in that one currency:
    * write the amounts in it, not in the attribute's `defaultCurrency`. Absent
    * when several were met: the answer is then per currency (`byCurrency`).
@@ -15308,8 +15335,11 @@ export interface RecordAggregates {
  * `truncated` says so.
  */
 export declare const MAX_AGGREGATE_GROUPS = 100;
-/** What an aggregate measures: the records, or a number / currency attribute's values. */
-export declare const AGGREGATE_MEASURES: readonly ["count", "sum", "avg", "min", "max"];
+/**
+ * What an aggregate measures: the records, or a number / currency attribute's
+ * values. `cumulative` is a sum running along a date grouping, oldest first.
+ */
+export declare const AGGREGATE_MEASURES: readonly ["count", "sum", "cumulative", "avg", "min", "max"];
 export type AggregateMeasure = (typeof AGGREGATE_MEASURES)[number];
 /** The date groupings, as {@link AggregateBucket} names them. */
 export declare const AGGREGATE_BUCKETS: readonly ["day", "week", "month", "quarter", "year"];
@@ -16862,6 +16892,10 @@ export declare const ASK_QUESTIONS_MAX_BATCH = 4;
 export declare const ASK_QUESTIONS_ANSWER_MAX_LENGTH = 2000;
 /** Most values one multi-select answer may carry: its options plus one "Other". */
 export declare const ASK_QUESTIONS_ANSWER_MAX_VALUES = 50;
+/** Most files a person may add to one answer: as many as one chat message carries. */
+export declare const ASK_QUESTIONS_MAX_ADDED_FILES = 10;
+/** A file a person added to an answer: a stored file or a document, by ref. */
+export declare const ASK_QUESTIONS_FILE_REF: RegExp;
 /**
  * One answer of an `ask_questions` result, written on the call by the server
  * (#5229). Each carries the option's value AND its label, so the model reads
@@ -16905,6 +16939,7 @@ export declare const askQuestionsOutputSchema: z$2.ZodObject<{
     id: z$2.ZodString;
     name: z$2.ZodString;
   }, z$2.core.$strip>>;
+  addedFiles: z$2.ZodOptional<z$2.ZodArray<z$2.ZodString>>;
 }, z$2.core.$strip>;
 export type AskQuestionsAnswer = z$2.infer<typeof askQuestionsAnswerSchema>;
 export type AskQuestionsResult = z$2.infer<typeof askQuestionsOutputSchema>;
@@ -17271,6 +17306,7 @@ declare const resolvedRecentActivitySchema: z$2.ZodObject<{
         execute: "execute";
       }>;
       focus: z$2.ZodBoolean;
+      personConversation: z$2.ZodBoolean;
       workModeVersion: z$2.ZodNumber;
       version: z$2.ZodNumber;
       loadedToolsets: z$2.ZodArray<z$2.ZodString>;
@@ -22034,6 +22070,7 @@ export declare const METRIC_BLOCK: BlockDefinition<"metric", import("zod").ZodOb
   readonly measure: ListableBlockInput<"enum", import("zod").ZodEnum<{
     avg: "avg";
     count: "count";
+    cumulative: "cumulative";
     max: "max";
     min: "min";
     sum: "sum";
@@ -22153,6 +22190,7 @@ export declare const CHART_BLOCK: BlockDefinition<"chart", import("zod").ZodObje
   readonly measure: ListableBlockInput<"enum", import("zod").ZodEnum<{
     avg: "avg";
     count: "count";
+    cumulative: "cumulative";
     max: "max";
     min: "min";
     sum: "sum";
@@ -22458,6 +22496,7 @@ export declare const NATIVE_BLOCKS: readonly [BlockDefinition<"artifact_preview"
   readonly measure: ListableBlockInput<"enum", import("zod").ZodEnum<{
     avg: "avg";
     count: "count";
+    cumulative: "cumulative";
     max: "max";
     min: "min";
     sum: "sum";
@@ -22576,6 +22615,7 @@ export declare const NATIVE_BLOCKS: readonly [BlockDefinition<"artifact_preview"
   readonly measure: ListableBlockInput<"enum", import("zod").ZodEnum<{
     avg: "avg";
     count: "count";
+    cumulative: "cumulative";
     max: "max";
     min: "min";
     sum: "sum";
@@ -22821,6 +22861,8 @@ declare abstract class Measures<TB, R> {
   protected abstract measured(measure: AggregateMeasure, attribute?: string): R;
   count(): R;
   sum(attribute: MeasurableAttribute<TB>): R;
+  /** The sum running along a date grouping: each period reads the total through it. */
+  cumulative(attribute: MeasurableAttribute<TB>): R;
   avg(attribute: MeasurableAttribute<TB>): R;
   min(attribute: MeasurableAttribute<TB>): R;
   max(attribute: MeasurableAttribute<TB>): R;
@@ -24484,11 +24526,13 @@ export declare const EMAIL_DIRECTIONS: readonly ["inbound", "outbound"];
 export type EmailDirection = (typeof EMAIL_DIRECTIONS)[number];
 export type MailboxReadState = "all" | "unread" | "read";
 /**
- * Where the mailbox looks: the inbox, the drafts, or what the viewer archived
- * or trashed. Read state is not a location: it stays the « Non lues » Filters
- * condition (`readState`), combinable with any of them.
+ * Where the mailbox looks: the inbox, the drafts, what the viewer sent, or
+ * what they archived or trashed. `sent` is a filter, not a place mail is moved
+ * into: the threads holding a message the viewer sent outside the trash,
+ * wherever they sit. Read state is not a location: it stays the « Non lues »
+ * Filters condition (`readState`), combinable with any of them.
  */
-export type MailboxLocation = "inbox" | "drafts" | "archived" | "trash";
+export type MailboxLocation = "inbox" | "sent" | "drafts" | "archived" | "trash";
 export type ConnectionStatus = (typeof CONNECTION_STATUS_IDS)[number];
 /**
  * One triage gesture on mail (spec 2026-10-25 § 4): read state, or a move to
@@ -24676,6 +24720,12 @@ export type MailboxAccount = z$2.output<typeof mailboxAccountSchema>;
 /** How the mailbox lists mail: one row per conversation, or one row per message. */
 export declare const MAILBOX_LIST_MODES: readonly ["threads", "messages"];
 export type MailboxListMode = (typeof MAILBOX_LIST_MODES)[number];
+/**
+ * Where an opened mail reads, as Gmail offers: in a `panel` beside the list,
+ * or `fullscreen` in the list's place, walked with the arrow keys.
+ */
+export declare const MAILBOX_READER_LAYOUTS: readonly ["panel", "fullscreen"];
+export type MailboxReaderLayout = (typeof MAILBOX_READER_LAYOUTS)[number];
 /** Narrows a wire or form value to a list mode without a cast at the call site. */
 export declare function isMailboxListMode(value: unknown): value is MailboxListMode;
 export declare const mailboxCursorSchema: z$2.ZodObject<{
@@ -29039,7 +29089,7 @@ export declare const CORE_PREFERENCES: readonly [PreferenceDeclaration<"workPost
     model: string;
   } | undefined;
   routing?: "auto" | undefined;
-}>, PreferenceDeclaration<"conversationSurface", "fullscreen" | "panel">, PreferenceDeclaration<"mailboxListMode", "messages" | "threads">, PreferenceDeclaration<"home", string | null>, PreferenceDeclaration<"memory.learnFromEmail", boolean>, PreferenceDeclaration<"memory.shareWithTeam", boolean>, PreferenceDeclaration<"onboarding.completed", boolean>, PreferenceDeclaration<"decisions.seenAt", string | null>, PreferenceDeclaration<"decisions.delivery", DecisionDelivery>];
+}>, PreferenceDeclaration<"conversationSurface", "fullscreen" | "panel">, PreferenceDeclaration<"mailboxListMode", "messages" | "threads">, PreferenceDeclaration<"mailboxReaderLayout", "fullscreen" | "panel">, PreferenceDeclaration<"home", string | null>, PreferenceDeclaration<"memory.learnFromEmail", boolean>, PreferenceDeclaration<"memory.shareWithTeam", boolean>, PreferenceDeclaration<"onboarding.completed", 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, {