@proteos/sdk 0.33.0 → 0.35.0

package/src/conversation/index.ts

@@ -1,5 +1,6 @@
 import type { ProteosClient } from '../client.js'
 import type {
+  AcceptMistranscribedTermRequest,
   AgentListener,
   AttachContactAddressRequest,
   BlockContactRequest,
@@ -11,9 +12,11 @@ import type {
   Conversation,
   ConversationFilter,
   ConversationFilterEvent,
+  ConversationType,
   CreateAgentListenerRequest,
   CreateConnectionRequest,
   CreateConversationFilterRequest,
+  CreateConversationTypeRequest,
   CreateGlossaryTermRequest,
   CreateTranscriptionRequest,
   DispatchMeetingBotRequest,
@@ -27,8 +30,10 @@ import type {
   ListConversationFilterEventsQuery,
   ListConversationFiltersQuery,
   ListConversationsQuery,
+  ListConversationTypesQuery,
   ListGlossaryTermsQuery,
   ListMessagesQuery,
+  ListMistranscribedTermsQuery,
   ListReactionsResponse,
   ListResponse,
   ListRoomsQuery,
@@ -36,10 +41,12 @@ import type {
   MaterializeTranscriptionRequest,
   MergeContactsRequest,
   Message,
+  MistranscribedTerm,
   Reaction,
   RecordPermissionEventRequest,
   Room,
   SendMessageRequest,
+  SyncConnectionRequest,
   Transcription,
   UnreadCounts,
   UpdateAgentListenerRequest,
@@ -47,8 +54,10 @@ import type {
   UpdateContactRequest,
   UpdateConversationFilterRequest,
   UpdateConversationRequest,
+  UpdateConversationTypeRequest,
   UpdateDraftRequest,
   UpdateGlossaryTermRequest,
+  UpdateTranscriptionRequest,
 } from './types.js'
 import { type VoiceService, VoiceServiceImpl } from './voice.js'
 
@@ -75,7 +84,11 @@ export class ConversationClient {
   readonly conversationFilters: ConversationFilterService
   /** Per-org glossary: custom vocabulary that boosts transcription accuracy. */
   readonly glossaryTerms: GlossaryTermService
+  /** Conversation taxonomy: the types the pre-summary classifier assigns. */
+  readonly conversationTypes: ConversationTypeService
   readonly transcriptions: TranscriptionService
+  /** Review-pass findings: likely misheard terms awaiting accept/reject. */
+  readonly mistranscribedTerms: MistranscribedTermService
   /** Meeting bots (Ava): dispatch into a meeting URL, remove from a meeting. */
   readonly meetings: MeetingService
   /** Realtime speech-to-text (dictation) — moved here from agent-service. */
@@ -89,7 +102,9 @@ export class ConversationClient {
     this.agentListeners = new AgentListenerServiceImpl(client)
     this.conversationFilters = new ConversationFilterServiceImpl(client)
     this.glossaryTerms = new GlossaryTermServiceImpl(client)
+    this.conversationTypes = new ConversationTypeServiceImpl(client)
     this.transcriptions = new TranscriptionServiceImpl(client)
+    this.mistranscribedTerms = new MistranscribedTermServiceImpl(client)
     this.meetings = new MeetingServiceImpl(client)
     this.voice = new VoiceServiceImpl(client)
   }
@@ -152,6 +167,15 @@ export interface ConnectionService {
   delete(id: string): Promise<void>
   /** Begin the connector's install flow; open the returned URL in a popup. */
   install(id: string): Promise<InstallConnectionResponse>
+  /**
+   * Trigger a historical backfill ("sync all") on an email connection: the
+   * server fetches provider mail in the chosen range and ingests it through
+   * the normal pipeline (conversation filters, dedupe, agent listeners).
+   * Returns 202 with the connection already showing
+   * settings.sync_status='in_progress' — poll get(id) until it flips to
+   * done/failed. A running sync answers 409 (sync_already_running).
+   */
+  sync(id: string, request: SyncConnectionRequest): Promise<Connection>
   /** Search the contact addresses this connection can reach (org-deduped) for the compose picker. */
   listContactAddresses(
     connectionId: string,
@@ -201,6 +225,14 @@ class ConnectionServiceImpl implements ConnectionService {
     )
   }
 
+  sync(id: string, request: SyncConnectionRequest): Promise<Connection> {
+    return this.client.request(
+      'POST',
+      `${CONVERSATION_BASE_PATH}/connections/${encodeURIComponent(id)}/sync`,
+      request,
+    )
+  }
+
   listContactAddresses(
     connectionId: string,
     query: ListContactAddressesQuery = {},
@@ -685,6 +717,70 @@ class GlossaryTermServiceImpl implements GlossaryTermService {
   }
 }
 
+/**
+ * The org's conversation taxonomy. Before a meeting summary is generated, a
+ * cheap classifier reads the transcript head plus every type's `definition`
+ * and picks the matching `key` — the result lands on `Conversation.type_key`,
+ * and a type whose `config.summary_prompt_key` names an agent-service prompt
+ * swaps the summary system prompt for that prompt's current body. Keyed by
+ * `key` (not id); `upsert` is the idempotent module-deploy door.
+ */
+export interface ConversationTypeService {
+  list(query?: ListConversationTypesQuery): Promise<ListResponse<ConversationType>>
+  get(key: string): Promise<ConversationType>
+  create(request: CreateConversationTypeRequest): Promise<ConversationType>
+  update(key: string, request: UpdateConversationTypeRequest): Promise<ConversationType>
+  /** Idempotent create-or-update by key (PUT) — what `pro module deploy` calls. */
+  upsert(key: string, request: CreateConversationTypeRequest): Promise<ConversationType>
+  delete(key: string): Promise<void>
+}
+
+class ConversationTypeServiceImpl implements ConversationTypeService {
+  constructor(private readonly client: ProteosClient) {}
+
+  list(query: ListConversationTypesQuery = {}): Promise<ListResponse<ConversationType>> {
+    return this.client.requestWithQuery(
+      'GET',
+      `${CONVERSATION_BASE_PATH}/conversation-types`,
+      query,
+    )
+  }
+
+  get(key: string): Promise<ConversationType> {
+    return this.client.request(
+      'GET',
+      `${CONVERSATION_BASE_PATH}/conversation-types/${encodeURIComponent(key)}`,
+    )
+  }
+
+  create(request: CreateConversationTypeRequest): Promise<ConversationType> {
+    return this.client.request('POST', `${CONVERSATION_BASE_PATH}/conversation-types`, request)
+  }
+
+  update(key: string, request: UpdateConversationTypeRequest): Promise<ConversationType> {
+    return this.client.request(
+      'PATCH',
+      `${CONVERSATION_BASE_PATH}/conversation-types/${encodeURIComponent(key)}`,
+      request,
+    )
+  }
+
+  upsert(key: string, request: CreateConversationTypeRequest): Promise<ConversationType> {
+    return this.client.request(
+      'PUT',
+      `${CONVERSATION_BASE_PATH}/conversation-types/${encodeURIComponent(key)}`,
+      { ...request, key },
+    )
+  }
+
+  async delete(key: string): Promise<void> {
+    await this.client.request(
+      'DELETE',
+      `${CONVERSATION_BASE_PATH}/conversation-types/${encodeURIComponent(key)}`,
+    )
+  }
+}
+
 /** Batch transcription of stored audio files + materialization. */
 export interface TranscriptionService {
   /**
@@ -695,6 +791,17 @@ export interface TranscriptionService {
   createFromFile(request: CreateTranscriptionRequest): Promise<Transcription>
   list(query?: ListTranscriptionsQuery): Promise<ListResponse<Transcription>>
   get(id: string): Promise<Transcription>
+  /**
+   * Edits a completed transcription (turn text, speaker labels, language).
+   * Does NOT retro-update messages of an already-materialized conversation.
+   */
+  update(id: string, request: UpdateTranscriptionRequest): Promise<Transcription>
+  /**
+   * Kicks off the mistranscription review pass (glossary-aware LLM hunt for
+   * misheard terms) — resolves immediately with review_status `processing`;
+   * poll `get(id)` until it flips to feedback_pending/completed/failed.
+   */
+  review(id: string): Promise<Transcription>
   /** Turns a completed transcription into an adhoc/meeting conversation. */
   materialize(id: string, request?: MaterializeTranscriptionRequest): Promise<Conversation>
 }
@@ -717,6 +824,22 @@ class TranscriptionServiceImpl implements TranscriptionService {
     )
   }
 
+  update(id: string, request: UpdateTranscriptionRequest): Promise<Transcription> {
+    return this.client.request(
+      'PATCH',
+      `${CONVERSATION_BASE_PATH}/transcriptions/${encodeURIComponent(id)}`,
+      request,
+    )
+  }
+
+  review(id: string): Promise<Transcription> {
+    return this.client.request(
+      'POST',
+      `${CONVERSATION_BASE_PATH}/transcriptions/${encodeURIComponent(id)}/review`,
+      {},
+    )
+  }
+
   materialize(id: string, request: MaterializeTranscriptionRequest = {}): Promise<Conversation> {
     return this.client.request(
       'POST',
@@ -726,6 +849,55 @@ class TranscriptionServiceImpl implements TranscriptionService {
   }
 }
 
+/**
+ * Findings of the post-transcription review pass: terms likely misheard by the
+ * transcription provider, awaiting accept/reject. Accepting applies the
+ * replacement to the transcription's turns and (optionally) promotes it into
+ * the glossary; resolving the last open finding flips the transcription's
+ * review_status to completed.
+ */
+export interface MistranscribedTermService {
+  list(query?: ListMistranscribedTermsQuery): Promise<ListResponse<MistranscribedTerm>>
+  get(id: string): Promise<MistranscribedTerm>
+  accept(id: string, request?: AcceptMistranscribedTermRequest): Promise<MistranscribedTerm>
+  reject(id: string): Promise<MistranscribedTerm>
+}
+
+class MistranscribedTermServiceImpl implements MistranscribedTermService {
+  constructor(private readonly client: ProteosClient) {}
+
+  list(query: ListMistranscribedTermsQuery = {}): Promise<ListResponse<MistranscribedTerm>> {
+    return this.client.requestWithQuery(
+      'GET',
+      `${CONVERSATION_BASE_PATH}/mistranscribed-terms`,
+      query,
+    )
+  }
+
+  get(id: string): Promise<MistranscribedTerm> {
+    return this.client.request(
+      'GET',
+      `${CONVERSATION_BASE_PATH}/mistranscribed-terms/${encodeURIComponent(id)}`,
+    )
+  }
+
+  accept(id: string, request: AcceptMistranscribedTermRequest = {}): Promise<MistranscribedTerm> {
+    return this.client.request(
+      'POST',
+      `${CONVERSATION_BASE_PATH}/mistranscribed-terms/${encodeURIComponent(id)}/accept`,
+      request,
+    )
+  }
+
+  reject(id: string): Promise<MistranscribedTerm> {
+    return this.client.request(
+      'POST',
+      `${CONVERSATION_BASE_PATH}/mistranscribed-terms/${encodeURIComponent(id)}/reject`,
+      {},
+    )
+  }
+}
+
 export type * from './types.js'
 // Re-export voice types (the live dictation stream lives on this service now)
 export type {

package/src/conversation/types.ts

@@ -176,6 +176,20 @@ export interface ReactionCapability {
   max_per_actor: number
 }
 
+/** How far back a historical backfill ("sync all") reaches. */
+export type ConnectionSyncRange = '30d' | '90d' | '365d' | 'all'
+
+/**
+ * Lifecycle of a historical backfill, carried as settings.sync_status.
+ * Absent key = 'none' (never synced). 'in_progress' is claimed before the
+ * trigger request returns — poll get(id) until it flips to done/failed.
+ */
+export type ConnectionSyncStatus = 'none' | 'in_progress' | 'done' | 'failed'
+
+export interface SyncConnectionRequest {
+  range: ConnectionSyncRange
+}
+
 export interface Connection {
   id: string
   org_id: string
@@ -187,6 +201,11 @@ export interface Connection {
   owner?: UserRef
   external_account_id: string
   credentials: ConnectionCredentials
+  /**
+   * Connector-shaped configuration + state. A historical backfill writes the
+   * sync_* keys here: sync_status (ConnectionSyncStatus), sync_range,
+   * sync_started_at, sync_completed_at, sync_synced_count, sync_error.
+   */
   settings: Record<string, unknown>
   status: ConnectionStatus
   /** Computed on read: the connector implements the reaction capability. */
@@ -227,6 +246,11 @@ export interface Conversation {
    * claim server-side and gives clients an elapsed time to show.
    */
   summary_started_at?: string
+  /**
+   * ConversationType key the pre-summary classifier assigned; absent when never
+   * classified or no type matched.
+   */
+  type_key?: string
   status: ConversationStatus
   /**
    * Room directory row a room-borne thread (Slack channel conversation) lives
@@ -559,6 +583,61 @@ export interface ListGlossaryTermsQuery extends PaginationQuery {
   search?: string
 }
 
+/** Optional per-type behavior configuration. */
+export interface ConversationTypeConfig {
+  /**
+   * Agent-service prompt key whose CURRENT version body replaces the built-in
+   * summary system prompt for conversations classified as this type. Absent ⇒
+   * built-in prompt.
+   */
+  summary_prompt_key?: string
+}
+
+/**
+ * A per-org conversation taxonomy entry. Before a meeting summary is
+ * generated, a cheap classifier reads the transcript head plus every type's
+ * `definition` and picks the matching `key` (or none); the result lands on
+ * `Conversation.type_key` and `config.summary_prompt_key` may swap the summary
+ * system prompt. Module-deployable (conversation-types/<key>.json).
+ */
+export interface ConversationType {
+  org_id: string
+  /** Immutable identity within the org — what the classifier answers with. */
+  key: string
+  name?: string
+  /** When a conversation IS this type — injected verbatim into the classifier prompt. */
+  definition: string
+  config: ConversationTypeConfig
+  /** Module that deployed the type; absent when not module-owned. */
+  module_slug?: string
+  created_at: string
+  created_by: UserRef
+  updated_at: string
+  updated_by: UserRef
+}
+
+export interface CreateConversationTypeRequest {
+  /** Lowercase kebab/snake/camel handle — no spaces. */
+  key: string
+  name?: string
+  definition: string
+  config?: ConversationTypeConfig
+  module_slug?: string
+}
+
+export interface UpdateConversationTypeRequest {
+  name?: string
+  definition?: string
+  /** Replaces the stored config wholesale; send `{}` to clear the prompt link. */
+  config?: ConversationTypeConfig
+}
+
+export interface ListConversationTypesQuery extends PaginationQuery {
+  /** Case-insensitive substring match on key or name. */
+  search?: string
+  module_slug?: string
+}
+
 export interface PaginationQuery {
   page?: number
   page_size?: number
@@ -974,6 +1053,18 @@ export interface ListResponse<T> {
 
 export type TranscriptionStatus = 'pending' | 'processing' | 'completed' | 'failed'
 
+/**
+ * Post-transcription review lifecycle — the glossary-aware LLM pass that hunts
+ * mistranscribed terms. `feedback_pending` means proposed mistranscribed terms
+ * await human resolution; resolving the last one flips it to `completed`.
+ */
+export type TranscriptionReviewStatus =
+  | 'open'
+  | 'processing'
+  | 'feedback_pending'
+  | 'completed'
+  | 'failed'
+
 export interface TranscriptTurn {
   speaker: number
   speaker_label: string
@@ -990,6 +1081,8 @@ export interface Transcription {
   audio_file_id: string
   transcript_file_id: string
   status: TranscriptionStatus
+  review_status: TranscriptionReviewStatus
+  review_started_at?: string
   language: string
   duration_seconds: number
   model: string
@@ -1012,6 +1105,18 @@ export interface CreateTranscriptionRequest {
   is_diarized?: boolean
 }
 
+/**
+ * Edits a COMPLETED transcription in place. `turns`, when present, replace the
+ * diarized turns wholesale; `speaker_labels` maps diarized speaker indexes
+ * ("0", "1", …) to display labels and is applied across all turns. Editing
+ * does NOT retro-update messages of an already-materialized conversation.
+ */
+export interface UpdateTranscriptionRequest {
+  turns?: TranscriptTurn[]
+  speaker_labels?: Record<string, string>
+  language?: string
+}
+
 /** Channel defaults to adhoc; meeting is the only other allowed target. */
 export interface MaterializeTranscriptionRequest {
   channel?: Channel
@@ -1028,6 +1133,63 @@ export interface ListTranscriptionsQuery extends PaginationQuery {
   provider_request_id?: string
 }
 
+export type MistranscribedTermStatus = 'auto_replaced' | 'proposed' | 'accepted' | 'rejected'
+
+export type MistranscriptionSuggestionSource = 'glossary' | 'model'
+
+/**
+ * One term the post-transcription review pass judged likely misheard. High-
+ * confidence findings are auto-replaced; the rest await accept/reject. An
+ * accepted row referencing the glossary term it became (glossary_term_id) is a
+ * known "misheard → term" mapping future passes replace deterministically.
+ */
+export interface MistranscribedTerm {
+  id: string
+  org_id: string
+  transcription_id: string
+  conversation_id?: string
+  /** The text as transcribed. */
+  term: string
+  context_snippet?: string
+  /** Indexes into the transcription's turns where the term occurs. */
+  turn_indexes: number[]
+  suggested_replacement?: string
+  suggestion_source?: MistranscriptionSuggestionSource
+  glossary_term_id?: string
+  /** Confidence (0..1) the term IS mistranscribed. */
+  misheard_confidence: number
+  /** Confidence (0..1) the suggested replacement fits. */
+  replacement_confidence: number
+  status: MistranscribedTermStatus
+  /** The text actually written into the transcript, once applied. */
+  applied_replacement?: string
+  resolved_by?: UserRef
+  resolved_at?: string
+  created_at: string
+  created_by: UserRef
+  updated_at: string
+  updated_by: UserRef
+}
+
+/**
+ * Accepts a proposed finding: `replacement` overrides the reviewer's
+ * suggestion when set; `create_glossary_term` promotes the applied replacement
+ * into the org glossary and links the finding to it.
+ */
+export interface AcceptMistranscribedTermRequest {
+  replacement?: string
+  create_glossary_term?: {
+    definition?: string
+    priority?: number
+  }
+}
+
+export interface ListMistranscribedTermsQuery extends PaginationQuery {
+  status?: MistranscribedTermStatus
+  transcription_id?: string
+  conversation_id?: string
+}
+
 /**
  * Sends a meeting bot (Ava) into a meeting through an active meeting
  * connection (adhoc-meeting). join_at schedules the bot ahead of time (ISO

package/src/index.ts

@@ -182,6 +182,7 @@ export type {
 export { ConnectorClient } from './connector/index.js'
 // Conversation types (conversation-service: connections, conversations, messages, listeners)
 export type {
+  AcceptMistranscribedTermRequest,
   AddressFilterConfig,
   AgentListener,
   AgentListenerService,
@@ -198,6 +199,8 @@ export type {
   ConnectionScope,
   ConnectionService,
   ConnectionStatus,
+  ConnectionSyncRange,
+  ConnectionSyncStatus,
   ConnectorKey,
   ConnectorProvider,
   ConsentStatus,
@@ -224,9 +227,13 @@ export type {
   ConversationService,
   ConversationStatus,
   ConversationSummaryStatus,
+  ConversationType,
+  ConversationTypeConfig,
+  ConversationTypeService,
   CreateAgentListenerRequest,
   CreateConnectionRequest,
   CreateConversationFilterRequest,
+  CreateConversationTypeRequest,
   CreateGlossaryTermRequest,
   DispatchMeetingBotRequest,
   DomainFilterConfig,
@@ -244,8 +251,10 @@ export type {
   ListConversationFilterEventsQuery,
   ListConversationFiltersQuery,
   ListConversationsQuery,
+  ListConversationTypesQuery,
   ListGlossaryTermsQuery,
   ListMessagesQuery,
+  ListMistranscribedTermsQuery,
   // Conversation-local page envelope ({meta, data}) — distinct from the
   // PageIterator-based ListResult used by the other modules.
   ListResponse,
@@ -259,6 +268,10 @@ export type {
   MessageRecipient,
   MessageService,
   MessageStatus,
+  MistranscribedTerm,
+  MistranscribedTermService,
+  MistranscribedTermStatus,
+  MistranscriptionSuggestionSource,
   PermissionEventSource,
   PermissionEventType,
   Reaction,
@@ -272,13 +285,19 @@ export type {
   Room,
   SendMessageRequest,
   SendRecipient,
+  SyncConnectionRequest,
   TranscribeStreamOptions,
+  Transcription,
+  TranscriptionReviewStatus,
+  TranscriptionStatus,
   TranscriptResult,
+  TranscriptTurn,
   UnreadCounts,
   UpdateAgentListenerRequest,
   UpdateConnectionRequest,
   UpdateContactRequest,
   UpdateConversationFilterRequest,
+  UpdateConversationTypeRequest,
   UpdateDraftRequest,
   UpdateGlossaryTermRequest,
   VoiceService,
@@ -422,6 +441,8 @@ export type {
   // App types
   App,
   AppService,
+  // Array/enum attribute metas (config_schema renderers narrow on these)
+  ArrayAttributeMeta,
   Attribute,
   AttributeType,
   Column,
@@ -451,6 +472,8 @@ export type {
   Entity,
   EntityService,
   EntityWithSchema,
+  EnumAttributeMeta,
+  EnumValue,
   // File attribute meta
   FileAttributeMeta,
   FilterElement,
@@ -614,6 +637,7 @@ export type {
   ListWorkflowsOptions,
   ManualTriggerParams,
   MessageTriggerParams,
+  ModelCallParams,
   NodeDescriptor,
   NodeExecution,
   NodeGroup,
@@ -631,6 +655,7 @@ export type {
   PropertyOption,
   PropertyType,
   RunWorkflowRequest,
+  SystemSource,
   TestNodeCandidate,
   TestNodeInputSource,
   TestNodeRequest,

package/src/meta/layout/elements.ts

@@ -15,6 +15,7 @@ export const LayoutElementType = {
   Tabs: 'tabs',
   Field: 'field',
   RelatedList: 'related_list',
+  RelatedRecord: 'related_record',
   Component: 'component',
   Divider: 'divider',
   Text: 'text',
@@ -96,6 +97,31 @@ export type RelatedListElement = CommonProps & {
   follows_parent_edit_mode?: boolean
 }
 
+/**
+ * Renders the FIRST record of `related_entity_slug` that references the
+ * current record through the `via_attribute` relation attribute — the
+ * singular counterpart of `related_list`, addressing the relation the same
+ * inbound way. The match is taken oldest-first so the choice is stable.
+ *
+ * `page_slug` optionally pins which record page supplies the layout; when
+ * omitted (or dangling) the renderer falls back to the related entity's
+ * default record page. The element renders that page bare — wrap it in a
+ * `section` element for a title or collapse affordance.
+ */
+export type RelatedRecordElement = CommonProps & {
+  type: 'related_record'
+  related_entity_slug: string
+  via_attribute: string
+  page_slug?: string
+  /**
+   * When absent or true, the element enters edit mode together with the host
+   * page's edit mode. False keeps it independent — editable only through its
+   * own hover control. Either way the element saves the related record
+   * itself; the host page's Save never covers it.
+   */
+  follows_parent_edit_mode?: boolean
+}
+
 export type ComponentElement = CommonProps & {
   type: 'component'
   component_slug: string
@@ -127,6 +153,7 @@ export type LayoutElement =
   | TabsElement
   | FieldElement
   | RelatedListElement
+  | RelatedRecordElement
   | ComponentElement
   | DividerElement
   | TextElement
@@ -196,6 +223,14 @@ export const LayoutElementSchema: z.ZodType<LayoutElement> = z.lazy(() =>
       list_slug: z.string().min(1).optional(),
       follows_parent_edit_mode: z.boolean().optional(),
     }),
+    z.object({
+      type: z.literal('related_record'),
+      ...commonPropsShape,
+      related_entity_slug: z.string().min(1),
+      via_attribute: z.string().min(1),
+      page_slug: z.string().min(1).optional(),
+      follows_parent_edit_mode: z.boolean().optional(),
+    }),
     z.object({
       type: z.literal('component'),
       ...commonPropsShape,

package/src/meta/layout/index.ts

@@ -26,6 +26,7 @@ export {
   LayoutElementType,
   type LayoutTab,
   type RelatedListElement,
+  type RelatedRecordElement,
   type RowElement,
   type SectionElement,
   type TabsElement,

package/src/meta/types.ts

@@ -782,6 +782,8 @@ export interface List extends AuditFields {
   name: string
   entity_slug: string
   columns: Column[]
+  /** Record page to open from this list; empty/absent = org default for the entity. */
+  default_page_slug?: string
   sorting: SortConfig[]
   filters: FilterGroup[]
 }
@@ -803,6 +805,7 @@ export const ListSchema = AuditFieldsSchema.extend({
   name: z.string(),
   entity_slug: z.string(),
   columns: z.array(ColumnSchema),
+  default_page_slug: z.string().optional(),
   sorting: z.array(SortConfigSchema),
   filters: z.array(FilterGroupSchema),
 })
@@ -826,6 +829,7 @@ export interface CreateListRequest {
   entity_slug: string
   name: string
   columns: Column[]
+  default_page_slug?: string
   sorting: SortConfig[]
   filters: FilterGroup[]
 }
@@ -837,6 +841,8 @@ export interface UpdateListRequest {
   name?: string
   module_slug?: string
   columns?: Column[]
+  /** Set to '' to clear back to the org default. */
+  default_page_slug?: string
   sorting?: SortConfig[]
   filters?: FilterGroup[]
 }