@proteos/sdk 0.51.1 → 0.52.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteos/sdk",
-  "version": "0.51.1",
+  "version": "0.52.0",
   "license": "Apache-2.0",
   "description": "TypeScript SDK for the Proteos platform",
   "repository": {

package/src/conversation/index.ts

@@ -33,6 +33,7 @@ import type {
   CreateGlossaryTermRequest,
   CreateSendingRuleRequest,
   CreateToneProfileSetupRequest,
+  CreateTranscriptionFromTextRequest,
   CreateTranscriptionRequest,
   DeleteConnectionQuery,
   DispatchMeetingBotRequest,
@@ -106,6 +107,7 @@ import type {
   UpdatePhoneNumberRequest,
   UpdateSendingRuleRequest,
   UpdateTranscriptionRequest,
+  UpsertToneProfileRequest,
 } from './types.js'
 import { type VoiceService, VoiceServiceImpl } from './voice.js'
 
@@ -1121,6 +1123,20 @@ export interface ToneProfileService {
   getProfile(id: string): Promise<ToneProfile>
   /** The single most-specific profile for a drafting context; 404 when none. */
   resolve(query: ResolveToneProfileQuery): Promise<ToneProfile>
+  /**
+   * Writes a HAND-AUTHORED profile, addressed by its scope tuple rather than an
+   * id — so re-sending the same scope updates the row it created. The row lands
+   * `source: 'manual'`, which locks that scope against synthesis forever after;
+   * it also takes the scope over from a `model` row already there. Needs no
+   * setup: a setup is the opt-in to AI synthesis, and writing a voice by hand is
+   * the opposite of asking for one.
+   */
+  upsertProfile(request: UpsertToneProfileRequest): Promise<ToneProfile>
+  /**
+   * Removes one profile row, manual or model. A deleted model row comes back on
+   * the next run; a deleted manual row hands its scope back to synthesis.
+   */
+  deleteProfile(id: string): Promise<void>
 }
 
 class ToneProfileServiceImpl implements ToneProfileService {
@@ -1170,6 +1186,17 @@ class ToneProfileServiceImpl implements ToneProfileService {
       query,
     )
   }
+
+  upsertProfile(request: UpsertToneProfileRequest): Promise<ToneProfile> {
+    return this.client.request('PUT', `${CONVERSATION_BASE_PATH}/tone-profiles`, request)
+  }
+
+  async deleteProfile(id: string): Promise<void> {
+    await this.client.request(
+      'DELETE',
+      `${CONVERSATION_BASE_PATH}/tone-profiles/${encodeURIComponent(id)}`,
+    )
+  }
 }
 
 /** Batch transcription of stored audio files + materialization. */
@@ -1180,6 +1207,14 @@ export interface TranscriptionService {
    * status is `completed` (or `failed`), then `materialize`.
    */
   createFromFile(request: CreateTranscriptionRequest): Promise<Transcription>
+  /**
+   * Lands an ALREADY WRITTEN transcript. Synchronous — no provider runs, and
+   * the entity comes back `completed`, ready to `materialize` straight away.
+   * The door for authoring a transcript (and so a conversation) from text with
+   * nothing to upload. Same endpoint as `createFromFile`; the shape of the body
+   * chooses the mode, and exactly one of the two is allowed.
+   */
+  createFromText(request: CreateTranscriptionFromTextRequest): Promise<Transcription>
   list(query?: ListTranscriptionsQuery): Promise<ListResponse<Transcription>>
   get(id: string): Promise<Transcription>
   /**
@@ -1204,6 +1239,10 @@ class TranscriptionServiceImpl implements TranscriptionService {
     return this.client.request('POST', `${CONVERSATION_BASE_PATH}/transcriptions`, request)
   }
 
+  createFromText(request: CreateTranscriptionFromTextRequest): Promise<Transcription> {
+    return this.client.request('POST', `${CONVERSATION_BASE_PATH}/transcriptions`, request)
+  }
+
   list(query: ListTranscriptionsQuery = {}): Promise<ListResponse<Transcription>> {
     return this.client.requestWithQuery('GET', `${CONVERSATION_BASE_PATH}/transcriptions`, query)
   }

package/src/conversation/types.ts

@@ -914,6 +914,14 @@ export type ToneProfileSetupStatus = 'empty' | 'processing' | 'ready'
 /** A tone profile row's tier — derived, most specific wins at read time. */
 export type ToneProfileScope = 'user' | 'channel' | 'group' | 'contact'
 
+/**
+ * Who wrote a tone profile, and therefore who may change it. `manual` rows are
+ * hand-authored and authoritative: synthesis never overwrites or prunes them,
+ * and deleting the user's setup (the AI opt-in) leaves them standing. `model`
+ * rows belong to the synthesis sweep, which owns them outright.
+ */
+export type ToneProfileSource = 'manual' | 'model'
+
 /**
  * The per-user opt-in for tone-of-voice synthesis: only set-up users are
  * swept. Also carries the whole-user synthesis claim (status/started_at).
@@ -933,7 +941,8 @@ export interface ToneProfileSetup {
 }
 
 /**
- * One generated tone-of-voice instruction row. Rows form a specificity
+ * One tone-of-voice instruction row — synthesized or hand-authored (`source`).
+ * Rows form a specificity
  * hierarchy — user aggregate (the constant voice), per-channel base, per
  * contact-group, per individual contact — and every row is SELF-CONTAINED: a
  * drafting consumer injects exactly one row's `instructions` verbatim (use
@@ -951,6 +960,8 @@ export interface ToneProfile {
   /** Scopes the row to one individual contact within the group. */
   contact_id?: string
   scope: ToneProfileScope
+  /** Who owns this row — see ToneProfileSource. */
+  source: ToneProfileSource
   /** COMPLETE markdown instruction set, served verbatim to a drafting model. */
   instructions: string
   /** Short delta vs the tier above — what a human scans; empty on root tiers. */
@@ -975,6 +986,30 @@ export interface ListToneProfilesQuery extends PaginationQuery {
   owned_by_id?: string
   channel?: Channel
   scope?: ToneProfileScope
+  /** Narrow to hand-authored (`manual`) or synthesized (`model`) rows. */
+  source?: ToneProfileSource
+}
+
+/**
+ * Writes ONE hand-authored tone profile. The identity is the scope tuple, not
+ * an id — re-sending the same scope updates the row it created. The row lands
+ * `source: 'manual'`, which locks that scope against synthesis; it also takes
+ * the scope over from a `model` row already sitting there.
+ *
+ * Scope grammar (mirrors the resolve precedence): omit `channel` for the
+ * cross-channel base voice; `contact_group_key` needs a `channel`;
+ * `contact_id` needs both, because resolution reaches a contact row only
+ * through its group.
+ */
+export interface UpsertToneProfileRequest {
+  owned_by_id: string
+  channel?: Channel
+  contact_group_key?: string
+  contact_id?: string
+  /** COMPLETE markdown style guide for this tier; never a delta. */
+  instructions: string
+  /** Optional human-facing note on how this tier differs from the one above. */
+  differences?: string
 }
 
 /**
@@ -1595,6 +1630,10 @@ export interface Transcription {
   updated_by: UserRef
 }
 
+/**
+ * Transcribes a storage-service audio file. Asynchronous: the row lands
+ * `processing` and the caller polls until `completed`.
+ */
 export interface CreateTranscriptionRequest {
   file_id: string
   language?: string
@@ -1602,6 +1641,38 @@ export interface CreateTranscriptionRequest {
   is_diarized?: boolean
 }
 
+/**
+ * Lands an ALREADY WRITTEN transcript — no provider runs and the row is
+ * `completed` when the call returns. This is how a transcript, and through
+ * `materialize` a conversation, is authored from text with nothing to upload.
+ * `source_file_id` stays empty, which is how a reader tells the two kinds apart.
+ *
+ * Timings are optional: plain text has none, and materialization then sequences
+ * the turns by their position instead of by `start_ms`.
+ */
+/**
+ * One turn of an authored transcript. Distinct from TranscriptTurn (the read
+ * shape, always fully populated) because everything but who-said-what is
+ * derived server-side: an unlabelled speaker becomes "Speaker N", and text with
+ * no timings is sequenced by position at materialization.
+ */
+export interface AuthoredTranscriptTurn {
+  /** Speaker index — the same number means the same person. */
+  speaker: number
+  speaker_label?: string
+  text: string
+  start_ms?: number
+  end_ms?: number
+  confidence?: number
+}
+
+export interface CreateTranscriptionFromTextRequest {
+  turns: AuthoredTranscriptTurn[]
+  language?: string
+  /** Defaults to whether the turns name more than one speaker. */
+  is_diarized?: boolean
+}
+
 /**
  * Edits a COMPLETED transcription in place. `turns`, when present, replace the
  * diarized turns wholesale; `speaker_labels` maps diarized speaker indexes

package/src/index.ts

@@ -238,6 +238,7 @@ export type {
   AttachContactAddressRequest,
   AttachConversationBriefRequest,
   Attachment,
+  AuthoredTranscriptTurn,
   AutomatedFilterConfig,
   AutomatedSignal,
   BlockContactRequest,
@@ -310,6 +311,7 @@ export type {
   CreateGlossaryTermRequest,
   CreateSendingRuleRequest,
   CreateToneProfileSetupRequest,
+  CreateTranscriptionFromTextRequest,
   DispatchMeetingBotRequest,
   DomainFilterConfig,
   EmailDnsRecord,
@@ -412,6 +414,7 @@ export type {
   ToneProfileService,
   ToneProfileSetup,
   ToneProfileSetupStatus,
+  ToneProfileSource,
   TranscribeStreamOptions,
   Transcription,
   TranscriptionReviewStatus,
@@ -430,6 +433,7 @@ export type {
   UpdateGlossaryTermRequest,
   UpdatePhoneNumberRequest,
   UpdateSendingRuleRequest,
+  UpsertToneProfileRequest,
   VoiceService,
   VoiceTranscriptionStream,
   WarmupRuleConfig,
@@ -602,10 +606,14 @@ export type {
   CreateAppRequest,
   CreateComponentRequest,
   CreateDesignReferenceRequest,
+  CreateEntityExtensionRequest,
   CreateEntityRequest,
+  CreateListExtensionRequest,
   CreateListRequest,
   CreateListViewRequest,
+  CreateMenuConfigurationExtensionRequest,
   CreateMenuConfigurationRequest,
+  CreatePageExtensionRequest,
   CreatePageRequest,
   CreateVariableRequest,
   // Currency attribute meta + value
@@ -620,10 +628,13 @@ export type {
   DesignReferenceService,
   // Entity types
   Entity,
+  EntityExtension,
+  EntityExtensionService,
   EntityService,
   EntityWithSchema,
   EnumAttributeMeta,
   EnumValue,
+  ExtensionPosition,
   // File attribute meta
   FileAttributeMeta,
   FilterElement,
@@ -635,10 +646,17 @@ export type {
   ListComponentsOptions,
   ListDesignReferencesOptions,
   ListEntitiesOptions,
+  ListEntityExtensionsOptions,
+  ListExtension,
+  ListExtensionColumnPlacement,
+  ListExtensionService,
+  ListListExtensionsOptions,
   ListListsOptions,
   ListListViewsOptions,
+  ListMenuConfigurationExtensionsOptions,
   ListMenuConfigurationsOptions,
   ListModulesOptions,
+  ListPageExtensionsOptions,
   ListPagesOptions,
   ListService,
   ListVariablesOptions,
@@ -648,6 +666,10 @@ export type {
   LogicalOperator,
   // MenuConfiguration types
   MenuConfiguration,
+  MenuConfigurationExtension,
+  MenuConfigurationExtensionPlacement,
+  MenuConfigurationExtensionPosition,
+  MenuConfigurationExtensionService,
   MenuConfigurationService,
   MenuItem,
   // Shared meta types
@@ -661,6 +683,9 @@ export type {
   Page,
   PageAction,
   PageActionKind,
+  PageExtension,
+  PageExtensionPlacement,
+  PageExtensionService,
   PageLayout,
   PageService,
   PageType,
@@ -675,10 +700,14 @@ export type {
   UpdateAppRequest,
   UpdateComponentRequest,
   UpdateDesignReferenceRequest,
+  UpdateEntityExtensionRequest,
   UpdateEntityRequest,
+  UpdateListExtensionRequest,
   UpdateListRequest,
   UpdateListViewRequest,
+  UpdateMenuConfigurationExtensionRequest,
   UpdateMenuConfigurationRequest,
+  UpdatePageExtensionRequest,
   UpdatePageRequest,
   UpdateVariableRequest,
   // Variable types
@@ -703,24 +732,36 @@ export {
   currencySymbol,
   currencySymbolSide,
   DesignReferenceSchema,
+  EntityExtensionSchema,
   EntitySchema,
   EntityWithSchemaSchema,
+  ExtensionPositionSchema,
   FilterElementSchema,
   FilterGroupSchema,
   formatAmount,
   formatMoney,
   isCurrentUserDefault,
   isPlatformAttributeName,
+  ListExtensionColumnPlacementSchema,
+  ListExtensionSchema,
   ListSchema,
   ListViewSchema,
   localeNumberSeparators,
+  MENU_CONFIGURATION_EXTENSION_ANCHOR_ITEMS,
+  MenuConfigurationExtensionPlacementSchema,
+  MenuConfigurationExtensionPositionSchema,
+  MenuConfigurationExtensionSchema,
   MenuConfigurationSchema,
   MenuItemSchema,
   MenuItemType,
   MetaClient,
   ModuleSchema,
   OnDeleteActionSchema,
+  PAGE_EXTENSION_ANCHOR_MAIN,
+  PAGE_EXTENSION_ANCHOR_SIDE_PANEL,
   PageActionSchema,
+  PageExtensionPlacementSchema,
+  PageExtensionSchema,
   PageLayoutSchema,
   PageSchema,
   PLATFORM_ATTRIBUTE_NAMES,

package/src/meta/entity-extensions.ts

@@ -0,0 +1,98 @@
+import type { ProteosClient } from '../client.js'
+import { PageIterator } from '../iterator.js'
+import type { ListResult } from '../types/common.js'
+import type {
+  CreateEntityExtensionRequest,
+  EntityExtension,
+  ListEntityExtensionsOptions,
+  UpdateEntityExtensionRequest,
+} from './types.js'
+
+const ENTITY_EXTENSIONS_BASE_PATH = '/meta/v1/entity-extensions'
+
+/**
+ * Service for entity extensions — attributes contributed to an EXISTING host
+ * entity by a resource that does not own it (typically a second module). The
+ * host's `attributes` are the materialized merge: its own attributes plus every
+ * extension's, each stamped with `extension_key`. Every write here
+ * re-materializes the host; an attribute name shared with the host or another
+ * extension is refused (`entity_extension_attribute_collision`).
+ */
+export interface EntityExtensionService {
+  /** Lists entity extensions (auto-paginating iterator). */
+  list(
+    options?: ListEntityExtensionsOptions,
+  ): PageIterator<EntityExtension, ListEntityExtensionsOptions>
+
+  /** Fetches a single page of entity extensions. */
+  listPage(options?: ListEntityExtensionsOptions): Promise<ListResult<EntityExtension>>
+
+  /** Gets an entity extension by key (404 when unknown). */
+  get(key: string): Promise<EntityExtension>
+
+  /**
+   * Creates an entity extension and merges its attributes into the host.
+   * @throws {ProteosError} 409 `entity_extension_already_exists` when the key
+   *   is taken; 400 `entity_extension_entity_not_found` when the host does
+   *   not exist; 400 `entity_extension_attribute_collision` on a name clash.
+   */
+  create(request: CreateEntityExtensionRequest): Promise<EntityExtension>
+
+  /**
+   * Creates or replaces an entity extension idempotently by key
+   * (`PUT /meta/v1/entity-extensions/:key`). Replaces the whole definition;
+   * the host binding (`entity_slug`) of an existing key is immutable.
+   */
+  upsert(key: string, request: CreateEntityExtensionRequest): Promise<EntityExtension>
+
+  /** Partially updates an entity extension (`attributes` replaces the whole list). */
+  update(key: string, request: UpdateEntityExtensionRequest): Promise<EntityExtension>
+
+  /** Deletes an entity extension and removes its attributes from the host. */
+  delete(key: string): Promise<void>
+}
+
+export class EntityExtensionServiceImpl implements EntityExtensionService {
+  constructor(private readonly client: ProteosClient) {}
+
+  list(
+    options: ListEntityExtensionsOptions = {},
+  ): PageIterator<EntityExtension, ListEntityExtensionsOptions> {
+    return new PageIterator((opts) => this.listPage(opts), options)
+  }
+
+  async listPage(options: ListEntityExtensionsOptions = {}): Promise<ListResult<EntityExtension>> {
+    return this.client.requestWithQuery<ListResult<EntityExtension>>(
+      'GET',
+      ENTITY_EXTENSIONS_BASE_PATH,
+      options,
+    )
+  }
+
+  async get(key: string): Promise<EntityExtension> {
+    return this.client.request<EntityExtension>('GET', `${ENTITY_EXTENSIONS_BASE_PATH}/${key}`)
+  }
+
+  async create(request: CreateEntityExtensionRequest): Promise<EntityExtension> {
+    return this.client.request<EntityExtension>('POST', ENTITY_EXTENSIONS_BASE_PATH, request)
+  }
+
+  async upsert(key: string, request: CreateEntityExtensionRequest): Promise<EntityExtension> {
+    return this.client.request<EntityExtension>('PUT', `${ENTITY_EXTENSIONS_BASE_PATH}/${key}`, {
+      ...request,
+      key,
+    })
+  }
+
+  async update(key: string, request: UpdateEntityExtensionRequest): Promise<EntityExtension> {
+    return this.client.request<EntityExtension>(
+      'PATCH',
+      `${ENTITY_EXTENSIONS_BASE_PATH}/${key}`,
+      request,
+    )
+  }
+
+  async delete(key: string): Promise<void> {
+    await this.client.request<void>('DELETE', `${ENTITY_EXTENSIONS_BASE_PATH}/${key}`)
+  }
+}

package/src/meta/index.ts

@@ -4,13 +4,20 @@ import { type AppService, AppServiceImpl } from './apps.js'
 import { type ComponentService, ComponentServiceImpl } from './components.js'
 import { type DesignReferenceService, DesignReferenceServiceImpl } from './design-references.js'
 import { type EntityService, EntityServiceImpl } from './entities.js'
+import { type EntityExtensionService, EntityExtensionServiceImpl } from './entity-extensions.js'
+import { type ListExtensionService, ListExtensionServiceImpl } from './list-extensions.js'
 import { type ListViewService, ListViewServiceImpl } from './list-views.js'
 import { type ListService, ListServiceImpl } from './lists.js'
+import {
+  type MenuConfigurationExtensionService,
+  MenuConfigurationExtensionServiceImpl,
+} from './menu-configuration-extensions.js'
 import {
   type MenuConfigurationService,
   MenuConfigurationServiceImpl,
 } from './menu-configurations.js'
 import { type ModuleService, ModuleServiceImpl } from './modules.js'
+import { type PageExtensionService, PageExtensionServiceImpl } from './page-extensions.js'
 import { type PageService, PageServiceImpl } from './pages.js'
 import { type VariableService, VariableServiceImpl } from './variables.js'
 
@@ -40,6 +47,30 @@ export class MetaClient {
    */
   readonly entities: EntityService
 
+  /**
+   * Service for managing entity extensions — attributes contributed to a host
+   * entity by a resource that does not own it.
+   */
+  readonly entityExtensions: EntityExtensionService
+
+  /**
+   * Service for managing page extensions — anchored layout blocks contributed
+   * to a host page by a resource that does not own it.
+   */
+  readonly pageExtensions: PageExtensionService
+
+  /**
+   * Service for managing list extensions — columns and toolbar actions
+   * contributed to a host list by a resource that does not own it.
+   */
+  readonly listExtensions: ListExtensionService
+
+  /**
+   * Service for managing menu-configuration extensions — items contributed
+   * to a host menu by another module or resource.
+   */
+  readonly menuConfigurationExtensions: MenuConfigurationExtensionService
+
   /**
    * Service for managing WebAssembly modules.
    */
@@ -98,6 +129,10 @@ export class MetaClient {
    */
   constructor(client: ProteosClient) {
     this.entities = new EntityServiceImpl(client)
+    this.entityExtensions = new EntityExtensionServiceImpl(client)
+    this.pageExtensions = new PageExtensionServiceImpl(client)
+    this.listExtensions = new ListExtensionServiceImpl(client)
+    this.menuConfigurationExtensions = new MenuConfigurationExtensionServiceImpl(client)
     this.modules = new ModuleServiceImpl(client)
     this.variables = new VariableServiceImpl(client)
     this.components = new ComponentServiceImpl(client)
@@ -118,12 +153,16 @@ export * from './currency/index.js'
 export type { DesignReferenceService } from './design-references.js'
 // Re-export service interfaces
 export type { EntityService } from './entities.js'
+export type { EntityExtensionService } from './entity-extensions.js'
 // Re-export the layout module (PageLayout types + Zod schemas + control registry)
 export * from './layout/index.js'
+export type { ListExtensionService } from './list-extensions.js'
 export type { ListViewService } from './list-views.js'
 export type { ListService } from './lists.js'
+export type { MenuConfigurationExtensionService } from './menu-configuration-extensions.js'
 export type { MenuConfigurationService } from './menu-configurations.js'
 export type { ModuleService } from './modules.js'
+export type { PageExtensionService } from './page-extensions.js'
 export type { PageService } from './pages.js'
 // Re-export types
 export type {
@@ -147,10 +186,14 @@ export type {
   CreateAppRequest,
   CreateComponentRequest,
   CreateDesignReferenceRequest,
+  CreateEntityExtensionRequest,
   CreateEntityRequest,
+  CreateListExtensionRequest,
   CreateListRequest,
   CreateListViewRequest,
+  CreateMenuConfigurationExtensionRequest,
   CreateMenuConfigurationRequest,
+  CreatePageExtensionRequest,
   CreatePageRequest,
   CreateVariableRequest,
   // Currency attribute meta + value
@@ -165,9 +208,12 @@ export type {
   DesignReferenceContent,
   // Entity types
   Entity,
+  // EntityExtension types
+  EntityExtension,
   EntityWithSchema,
   EnumAttributeMeta,
   EnumValue,
+  ExtensionPosition,
   // File attribute meta
   FileAttributeMeta,
   FilterElement,
@@ -179,10 +225,17 @@ export type {
   ListComponentsOptions,
   ListDesignReferencesOptions,
   ListEntitiesOptions,
+  ListEntityExtensionsOptions,
+  // ListExtension types
+  ListExtension,
+  ListExtensionColumnPlacement,
+  ListListExtensionsOptions,
   ListListsOptions,
   ListListViewsOptions,
+  ListMenuConfigurationExtensionsOptions,
   ListMenuConfigurationsOptions,
   ListModulesOptions,
+  ListPageExtensionsOptions,
   ListPagesOptions,
   ListVariablesOptions,
   // ListView types
@@ -190,6 +243,10 @@ export type {
   LogicalOperator,
   // MenuConfiguration types
   MenuConfiguration,
+  // MenuConfigurationExtension types
+  MenuConfigurationExtension,
+  MenuConfigurationExtensionPlacement,
+  MenuConfigurationExtensionPosition,
   MenuItem,
   // Shared types
   MetaListOptions,
@@ -203,6 +260,9 @@ export type {
   Page,
   PageAction,
   PageActionKind,
+  // PageExtension types
+  PageExtension,
+  PageExtensionPlacement,
   PageType,
   // User attribute meta
   PrincipalAttributeMeta,
@@ -221,10 +281,14 @@ export type {
   UpdateAppRequest,
   UpdateComponentRequest,
   UpdateDesignReferenceRequest,
+  UpdateEntityExtensionRequest,
   UpdateEntityRequest,
+  UpdateListExtensionRequest,
   UpdateListRequest,
   UpdateListViewRequest,
+  UpdateMenuConfigurationExtensionRequest,
   UpdateMenuConfigurationRequest,
+  UpdatePageExtensionRequest,
   UpdatePageRequest,
   UpdateVariableRequest,
   UserAttributeMeta,
@@ -244,21 +308,33 @@ export {
   CURRENT_USER_DEFAULT,
   CurrencyAttributeMetaSchema,
   DesignReferenceSchema,
+  EntityExtensionSchema,
   EntitySchema,
   EntityWithSchemaSchema,
+  ExtensionPositionSchema,
   FileAttributeMetaSchema,
   FilterElementSchema,
   FilterGroupSchema,
   isCurrentUserDefault,
   isPlatformAttributeName,
+  ListExtensionColumnPlacementSchema,
+  ListExtensionSchema,
   ListSchema,
   ListViewSchema,
+  MENU_CONFIGURATION_EXTENSION_ANCHOR_ITEMS,
+  MenuConfigurationExtensionPlacementSchema,
+  MenuConfigurationExtensionPositionSchema,
+  MenuConfigurationExtensionSchema,
   MenuConfigurationSchema,
   MenuItemSchema,
   MenuItemType,
   ModuleSchema,
   OnDeleteActionSchema,
+  PAGE_EXTENSION_ANCHOR_MAIN,
+  PAGE_EXTENSION_ANCHOR_SIDE_PANEL,
   PageActionSchema,
+  PageExtensionPlacementSchema,
+  PageExtensionSchema,
   PageSchema,
   PLATFORM_ATTRIBUTE_NAMES,
   parseCurrencyMeta,

package/src/meta/layout/common-props.ts

@@ -62,6 +62,13 @@ const ResponsiveSizingSchema = z.object({
  */
 export interface CommonProps {
   id?: string
+  /**
+   * Server-stamped back-reference to the page extension that contributes this
+   * element to its host page. Present only on a host's merged layout; ignored
+   * (stripped and re-derived) on writes. Mirrors `ExtensionKey` in the Go
+   * `metamodel.CommonProps`.
+   */
+  extension_key?: string
   visible_when?: FilterGroup
   read_only_when?: FilterGroup
   width?: SizeValue
@@ -78,6 +85,7 @@ export interface CommonProps {
  */
 export const commonPropsShape = {
   id: z.string().optional(),
+  extension_key: z.string().optional(),
   visible_when: FilterGroupSchema.optional(),
   read_only_when: FilterGroupSchema.optional(),
   width: SizeValueSchema.optional(),