@proteos/sdk 0.53.0 → 0.54.0

package/dist/{types-D5P6yk1L.d.ts → types-amvSTwJy.d.ts}

@@ -1613,6 +1613,7 @@ declare const LayoutElementType: {
     readonly RecordFilter: "record_filter";
     readonly List: "list";
     readonly WorkflowTrigger: "workflow_trigger";
+    readonly SchedulingPicker: "scheduling_picker";
 };
 type LayoutElementType = (typeof LayoutElementType)[keyof typeof LayoutElementType];
 type RowElement = CommonProps & {
@@ -1832,13 +1833,30 @@ type WorkflowTriggerElement = CommonProps & {
      */
     execution_attribute?: string;
 };
+/**
+ * Embeds a scheduling link's booking flow (type → time → details →
+ * confirmation) in the layout — the in-page counterpart of /s/:orgId/:key.
+ * `type_key` pre-selects one of the link's types (the picker shows the choice
+ * otherwise), `host_user_id` pins one host, `contact_id` is a Liquid template
+ * over the page scope that binds the booking to a known contact (no name /
+ * email asked). Allowed on every page type; public pages book through the
+ * unauthenticated surface.
+ */
+type SchedulingPickerElement = CommonProps & {
+    type: 'scheduling_picker';
+    link_key: string;
+    type_key?: string;
+    host_user_id?: string;
+    contact_id?: string;
+    is_header_hidden?: boolean;
+};
 type TextVariant = 'heading' | 'subheading' | 'body' | 'caption' | 'callout';
 type TextElement = CommonProps & {
     type: 'text';
     variant: TextVariant;
     content: string;
 };
-type LayoutElement = RowElement | ColumnElement | SectionElement | CardElement | TabsElement | FieldElement | RelatedListElement | RelatedRecordElement | ComponentElement | DividerElement | TextElement | RecordFilterElement | ListElement | WorkflowTriggerElement;
+type LayoutElement = RowElement | ColumnElement | SectionElement | CardElement | TabsElement | FieldElement | RelatedListElement | RelatedRecordElement | ComponentElement | DividerElement | TextElement | RecordFilterElement | ListElement | WorkflowTriggerElement | SchedulingPickerElement;
 declare const LayoutTabSchema: z.ZodType<LayoutTab>;
 declare const LayoutElementSchema: z.ZodType<LayoutElement>;
 
@@ -5706,4 +5724,4 @@ declare function isCurrentUserDefault(value: unknown): value is CurrentUserDefau
 /** Only the identity-valued attribute types can carry the sentinel. */
 declare function acceptsCurrentUserDefault(type: AttributeType): boolean;
 
-export { type CurrencySymbolSide as $, type AuditFields as A, type ComponentService as B, CURRENT_USER_DEFAULT as C, type ContactAddressAttributeKind as D, type ContactAddressAttributeMeta as E, type FileRef as F, ContactAddressAttributeMetaSchema as G, type ContactBindingDuplicatePolicy as H, type CreateAppConfigurationRequest as I, type CreateAppRequest as J, type CreateComponentRequest as K, type ListOptions as L, type CreateDesignReferenceRequest as M, type CreateEntityExtensionRequest as N, type CreateEntityRequest as O, PageIterator as P, type CreateListExtensionRequest as Q, type CreateListRequest as R, type CreateListViewRequest as S, type CreateMenuConfigurationExtensionRequest as T, type UserRef as U, type CreateMenuConfigurationRequest as V, type CreatePageExtensionRequest as W, type CreatePageRequest as X, type CreateVariableRequest as Y, type CurrencyAttributeMeta as Z, CurrencyAttributeMetaSchema as _, type Attribute as a, MenuConfigurationExtensionPlacementSchema as a$, type CurrencyValue as a0, type CurrentUserDefault as a1, DEFAULT_OPTIONS as a2, DEFAULT_PAGE_SIZE as a3, DONE as a4, type DeployModuleRequest as a5, type DesignReference as a6, type DesignReferenceContent as a7, DesignReferenceSchema as a8, type DesignReferenceService as a9, type ListEntitiesOptions as aA, type ListEntityExtensionsOptions as aB, type ListExtension as aC, type ListExtensionColumnPlacement as aD, ListExtensionColumnPlacementSchema as aE, ListExtensionSchema as aF, type ListExtensionService as aG, type ListFn as aH, type ListListExtensionsOptions as aI, type ListListViewsOptions as aJ, type ListListsOptions as aK, type ListMenuConfigurationExtensionsOptions as aL, type ListMenuConfigurationsOptions as aM, type ListModulesOptions as aN, type ListPageExtensionsOptions as aO, type ListPagesOptions as aP, ListSchema as aQ, type ListService as aR, type ListVariablesOptions as aS, type ListView as aT, ListViewSchema as aU, type ListViewService as aV, type LogicalOperator as aW, MENU_CONFIGURATION_EXTENSION_ANCHOR_ITEMS as aX, type MenuConfiguration as aY, type MenuConfigurationExtension as aZ, type MenuConfigurationExtensionPlacement as a_, type Done as aa, type Entity as ab, type EntityContactBinding as ac, EntityContactBindingSchema as ad, type EntityExtension as ae, EntityExtensionSchema as af, type EntityExtensionService as ag, EntitySchema as ah, type EntityService as ai, type EntityWithSchema as aj, EntityWithSchemaSchema as ak, type EnumAttributeMeta as al, type EnumValue as am, type ExtensionPosition as an, ExtensionPositionSchema as ao, type FileAttributeMeta as ap, FileRefSchema as aq, type FilterElement as ar, FilterElementSchema as as, type FilterGroup as at, FilterGroupSchema as au, type List as av, type ListAppConfigurationsOptions as aw, type ListAppsOptions as ax, type ListComponentsOptions as ay, type ListDesignReferencesOptions as az, type ListResult as b, type UserType as b$, type MenuConfigurationExtensionPosition as b0, MenuConfigurationExtensionPositionSchema as b1, MenuConfigurationExtensionSchema as b2, type MenuConfigurationExtensionService as b3, MenuConfigurationSchema as b4, type MenuConfigurationService as b5, type MenuItem as b6, MenuItemSchema as b7, MenuItemType as b8, MetaClient as b9, type PublicPageResponse as bA, type RelationAttributeMeta as bB, RelationAttributeMetaSchema as bC, type RequestOptions as bD, type ResolvedClientOptions as bE, type ResponseMeta as bF, ResponseMetaSchema as bG, type SortConfig as bH, SortConfigSchema as bI, type SortDirection as bJ, type Timestamps as bK, type TokenProvider as bL, type UpdateAppConfigurationRequest as bM, type UpdateAppRequest as bN, type UpdateComponentRequest as bO, type UpdateDesignReferenceRequest as bP, type UpdateEntityExtensionRequest as bQ, type UpdateEntityRequest as bR, type UpdateListExtensionRequest as bS, type UpdateListRequest as bT, type UpdateListViewRequest as bU, type UpdateMenuConfigurationExtensionRequest as bV, type UpdateMenuConfigurationRequest as bW, type UpdatePageExtensionRequest as bX, type UpdatePageRequest as bY, type UpdateVariableRequest as bZ, UserRefSchema as b_, type MetaListOptions as ba, type Module as bb, ModuleSchema as bc, type ModuleService as bd, type ModuleStatus as be, type OnDeleteAction as bf, OnDeleteActionSchema as bg, PAGE_EXTENSION_ANCHOR_MAIN as bh, PAGE_EXTENSION_ANCHOR_SIDE_PANEL as bi, PLATFORM_ATTRIBUTE_NAMES as bj, PLATFORM_USER_ID as bk, type Page as bl, type PageAction as bm, type PageActionKind as bn, PageActionSchema as bo, type PageExtension as bp, type PageExtensionPlacement as bq, PageExtensionPlacementSchema as br, PageExtensionSchema as bs, type PageExtensionService as bt, type PageLayout as bu, PageLayoutSchema as bv, PageSchema as bw, type PageService as bx, type PageType as by, type PublicPageComponent as bz, ProteosClient as c, type SizingProps as c$, type Variable as c0, VariableSchema as c1, type VariableService as c2, acceptsCurrentUserDefault as c3, allCurrencyCodes as c4, createIterator as c5, createListResultSchema as c6, currencyLabel as c7, currencySymbol as c8, currencySymbolSide as c9, type LayoutAlign as cA, type LayoutElement as cB, LayoutElementSchema as cC, LayoutElementType as cD, type LayoutGap as cE, type LayoutJustify as cF, type LayoutTab as cG, LayoutTabSchema as cH, type ListElement as cI, type NumberAttributeMeta as cJ, type ObjectAttributeMeta as cK, PAGE_BACKGROUND_TOKENS as cL, type PageBackgroundToken as cM, type PageLayoutSidePanel as cN, PageLayoutSidePanelSchema as cO, type PageStyle as cP, PageStyleSchema as cQ, type PrincipalAttributeMeta as cR, type PrincipalType as cS, type RecordFilterElement as cT, type RelatedListElement as cU, type RelatedRecordElement as cV, type ResponsiveSizing as cW, type RowElement as cX, type SectionElement as cY, type SizeValue as cZ, SizeValueSchema as c_, formatAmount as ca, formatMoney as cb, isCurrentUserDefault as cc, isPlatformAttributeName as cd, localeNumberSeparators as ce, parseAmount as cf, parseContactAddressMeta as cg, parseCurrencyMeta as ch, parseFileMeta as ci, parseRelationMeta as cj, platformAttributes as ck, resolveOptions as cl, type AttributeForLookup as cm, type AttributeMeta as cn, BUILT_IN_CONTROLS as co, type BuiltInControlSlug as cp, type CardElement as cq, type ColumnElement as cr, type CommonProps as cs, type ComponentElement as ct, type ControlBucket as cu, type DatetimeAttributeMeta as cv, type DatetimeFormat as cw, type DividerElement as cx, type FieldElement as cy, FileAttributeMetaSchema as cz, type PrincipalRef as d, type StringAttributeMeta as d0, type StringFormat as d1, type TabsElement as d2, type TextElement as d3, type TextVariant as d4, type UserAttributeMeta as d5, UserAttributeMetaSchema as d6, type WorkflowTriggerElement as d7, isBuiltInControl as d8, lookupCompatibleControls as d9, lookupControls as da, lookupPrimaryControl as db, parsePrincipalMeta as dc, parseUserMeta as dd, type PublicAccessOperation as e, type App as f, type AppConfiguration as g, AppConfigurationSchema as h, type AppConfigurationService as i, type AppHome as j, AppHomeSchema as k, type AppHomeType as l, AppSchema as m, type AppService as n, type ArrayAttributeMeta as o, type AttributeAccessRule as p, type AttributeRestrictions as q, AttributeSchema as r, type AttributeType as s, AuditFieldsSchema as t, type ClientOptions as u, type Column as v, ColumnSchema as w, type ComparisonOperator as x, type Component as y, ComponentSchema as z };
+export { CurrencyAttributeMetaSchema as $, type AuditFields as A, type ComponentService as B, CURRENT_USER_DEFAULT as C, type ContactAddressAttributeKind as D, type ContactAddressAttributeMeta as E, type FileRef as F, ContactAddressAttributeMetaSchema as G, type ContactBindingDuplicatePolicy as H, type CreateAppConfigurationRequest as I, type CreateAppRequest as J, type CreateComponentRequest as K, type ListOptions as L, type CreateDesignReferenceRequest as M, type CreateEntityExtensionRequest as N, type CreateEntityRequest as O, PageIterator as P, type CreateListExtensionRequest as Q, type ResponseMeta as R, type CreateListRequest as S, type CreateListViewRequest as T, type UserRef as U, type CreateMenuConfigurationExtensionRequest as V, type CreateMenuConfigurationRequest as W, type CreatePageExtensionRequest as X, type CreatePageRequest as Y, type CreateVariableRequest as Z, type CurrencyAttributeMeta as _, type Attribute as a, type MenuConfigurationExtensionPlacement as a$, type CurrencySymbolSide as a0, type CurrencyValue as a1, type CurrentUserDefault as a2, DEFAULT_OPTIONS as a3, DEFAULT_PAGE_SIZE as a4, DONE as a5, type DeployModuleRequest as a6, type DesignReference as a7, type DesignReferenceContent as a8, DesignReferenceSchema as a9, type ListDesignReferencesOptions as aA, type ListEntitiesOptions as aB, type ListEntityExtensionsOptions as aC, type ListExtension as aD, type ListExtensionColumnPlacement as aE, ListExtensionColumnPlacementSchema as aF, ListExtensionSchema as aG, type ListExtensionService as aH, type ListFn as aI, type ListListExtensionsOptions as aJ, type ListListViewsOptions as aK, type ListListsOptions as aL, type ListMenuConfigurationExtensionsOptions as aM, type ListMenuConfigurationsOptions as aN, type ListModulesOptions as aO, type ListPageExtensionsOptions as aP, type ListPagesOptions as aQ, ListSchema as aR, type ListService as aS, type ListVariablesOptions as aT, type ListView as aU, ListViewSchema as aV, type ListViewService as aW, type LogicalOperator as aX, MENU_CONFIGURATION_EXTENSION_ANCHOR_ITEMS as aY, type MenuConfiguration as aZ, type MenuConfigurationExtension as a_, type DesignReferenceService as aa, type Done as ab, type Entity as ac, type EntityContactBinding as ad, EntityContactBindingSchema as ae, type EntityExtension as af, EntityExtensionSchema as ag, type EntityExtensionService as ah, EntitySchema as ai, type EntityService as aj, type EntityWithSchema as ak, EntityWithSchemaSchema as al, type EnumAttributeMeta as am, type EnumValue as an, type ExtensionPosition as ao, ExtensionPositionSchema as ap, type FileAttributeMeta as aq, FileRefSchema as ar, type FilterElement as as, FilterElementSchema as at, type FilterGroup as au, FilterGroupSchema as av, type List as aw, type ListAppConfigurationsOptions as ax, type ListAppsOptions as ay, type ListComponentsOptions as az, type ListResult as b, type UserType as b$, MenuConfigurationExtensionPlacementSchema as b0, type MenuConfigurationExtensionPosition as b1, MenuConfigurationExtensionPositionSchema as b2, MenuConfigurationExtensionSchema as b3, type MenuConfigurationExtensionService as b4, MenuConfigurationSchema as b5, type MenuConfigurationService as b6, type MenuItem as b7, MenuItemSchema as b8, MenuItemType as b9, type PublicPageComponent as bA, type PublicPageResponse as bB, type RelationAttributeMeta as bC, RelationAttributeMetaSchema as bD, type RequestOptions as bE, type ResolvedClientOptions as bF, ResponseMetaSchema as bG, type SortConfig as bH, SortConfigSchema as bI, type SortDirection as bJ, type Timestamps as bK, type TokenProvider as bL, type UpdateAppConfigurationRequest as bM, type UpdateAppRequest as bN, type UpdateComponentRequest as bO, type UpdateDesignReferenceRequest as bP, type UpdateEntityExtensionRequest as bQ, type UpdateEntityRequest as bR, type UpdateListExtensionRequest as bS, type UpdateListRequest as bT, type UpdateListViewRequest as bU, type UpdateMenuConfigurationExtensionRequest as bV, type UpdateMenuConfigurationRequest as bW, type UpdatePageExtensionRequest as bX, type UpdatePageRequest as bY, type UpdateVariableRequest as bZ, UserRefSchema as b_, MetaClient as ba, type MetaListOptions as bb, type Module as bc, ModuleSchema as bd, type ModuleService as be, type ModuleStatus as bf, type OnDeleteAction as bg, OnDeleteActionSchema as bh, PAGE_EXTENSION_ANCHOR_MAIN as bi, PAGE_EXTENSION_ANCHOR_SIDE_PANEL as bj, PLATFORM_ATTRIBUTE_NAMES as bk, PLATFORM_USER_ID as bl, type Page as bm, type PageAction as bn, type PageActionKind as bo, PageActionSchema as bp, type PageExtension as bq, type PageExtensionPlacement as br, PageExtensionPlacementSchema as bs, PageExtensionSchema as bt, type PageExtensionService as bu, type PageLayout as bv, PageLayoutSchema as bw, PageSchema as bx, type PageService as by, type PageType as bz, ProteosClient as c, SizeValueSchema as c$, type Variable as c0, VariableSchema as c1, type VariableService as c2, acceptsCurrentUserDefault as c3, allCurrencyCodes as c4, createIterator as c5, createListResultSchema as c6, currencyLabel as c7, currencySymbol as c8, currencySymbolSide as c9, type LayoutAlign as cA, type LayoutElement as cB, LayoutElementSchema as cC, LayoutElementType as cD, type LayoutGap as cE, type LayoutJustify as cF, type LayoutTab as cG, LayoutTabSchema as cH, type ListElement as cI, type NumberAttributeMeta as cJ, type ObjectAttributeMeta as cK, PAGE_BACKGROUND_TOKENS as cL, type PageBackgroundToken as cM, type PageLayoutSidePanel as cN, PageLayoutSidePanelSchema as cO, type PageStyle as cP, PageStyleSchema as cQ, type PrincipalAttributeMeta as cR, type PrincipalType as cS, type RecordFilterElement as cT, type RelatedListElement as cU, type RelatedRecordElement as cV, type ResponsiveSizing as cW, type RowElement as cX, type SchedulingPickerElement as cY, type SectionElement as cZ, type SizeValue as c_, formatAmount as ca, formatMoney as cb, isCurrentUserDefault as cc, isPlatformAttributeName as cd, localeNumberSeparators as ce, parseAmount as cf, parseContactAddressMeta as cg, parseCurrencyMeta as ch, parseFileMeta as ci, parseRelationMeta as cj, platformAttributes as ck, resolveOptions as cl, type AttributeForLookup as cm, type AttributeMeta as cn, BUILT_IN_CONTROLS as co, type BuiltInControlSlug as cp, type CardElement as cq, type ColumnElement as cr, type CommonProps as cs, type ComponentElement as ct, type ControlBucket as cu, type DatetimeAttributeMeta as cv, type DatetimeFormat as cw, type DividerElement as cx, type FieldElement as cy, FileAttributeMetaSchema as cz, type PrincipalRef as d, type SizingProps as d0, type StringAttributeMeta as d1, type StringFormat as d2, type TabsElement as d3, type TextElement as d4, type TextVariant as d5, type UserAttributeMeta as d6, UserAttributeMetaSchema as d7, type WorkflowTriggerElement as d8, isBuiltInControl as d9, lookupCompatibleControls as da, lookupControls as db, lookupPrimaryControl as dc, parsePrincipalMeta as dd, parseUserMeta as de, type PublicAccessOperation as e, type App as f, type AppConfiguration as g, AppConfigurationSchema as h, type AppConfigurationService as i, type AppHome as j, AppHomeSchema as k, type AppHomeType as l, AppSchema as m, type AppService as n, type ArrayAttributeMeta as o, type AttributeAccessRule as p, type AttributeRestrictions as q, AttributeSchema as r, type AttributeType as s, AuditFieldsSchema as t, type ClientOptions as u, type Column as v, ColumnSchema as w, type ComparisonOperator as x, type Component as y, ComponentSchema as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteos/sdk",
-  "version": "0.53.0",
+  "version": "0.54.0",
   "license": "Apache-2.0",
   "description": "TypeScript SDK for the Proteos platform",
   "repository": {
@@ -66,8 +66,8 @@
     "tsup": "^8.3.0",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0",
-    "@proteos/tsconfig": "0.0.0",
-    "@proteos/biome-config": "0.0.0"
+    "@proteos/biome-config": "0.0.0",
+    "@proteos/tsconfig": "0.0.0"
   },
   "scripts": {
     "build": "tsup",

package/src/auth/platform-entities.ts

@@ -108,6 +108,14 @@ export const PLATFORM_ENTITIES: readonly PlatformEntity[] = [
   // Connectors (connector-service). `connections` above is shared; this is the
   // manifest catalog.
   { slug: 'connectors', name: 'Connectors' },
+  // Scheduling (scheduling-service)
+  { slug: 'calendar-connections', name: 'Calendar Connections' },
+  { slug: 'calendars', name: 'Calendars' },
+  { slug: 'calendar-events', name: 'Calendar Events' },
+  { slug: 'calendar-event-types', name: 'Calendar Event Types' },
+  { slug: 'scheduling-links', name: 'Scheduling Links' },
+  { slug: 'scheduling-profiles', name: 'Scheduling Profiles' },
+  { slug: 'availability-constraints', name: 'Availability Constraints' },
 ] as const
 
 /** Just the platform entity slugs, in canonical order. */

package/src/connector/types.ts

@@ -81,6 +81,12 @@ export interface Connector {
   has_default_app_credentials?: boolean
   config_schema?: Attribute[]
   methods: ConnectorMethod[]
+  /**
+   * Coarse, provider-neutral tags a first-party service filters the catalog
+   * by (`calendar`: the grant can drive the platform calendar mirror).
+   * snake_case, declared by the manifest.
+   */
+  capabilities?: string[]
   origin: 'pre_built' | 'custom'
   module_slug?: string
   status: 'active' | 'inactive'
@@ -152,6 +158,8 @@ export interface ListConnectorsQuery {
   page?: number
   page_size?: number
   status?: string
+  /** Only connectors declaring this capability (e.g. `calendar`). */
+  capability?: string
 }
 
 export interface ListConnectorConnectionsQuery {

package/src/index.ts

@@ -792,6 +792,93 @@ export {
   SortConfigSchema,
   VariableSchema,
 } from './meta/index.js'
+// Scheduling types (scheduling-service: calendar connections, calendars,
+// scheduling profiles, the calendar_event mirror)
+export type {
+  Assignment,
+  AvailabilityConstraint,
+  AvailabilityConstraintService,
+  AvailabilityKind,
+  BookingContact,
+  BookSchedulingLinkRequest,
+  BookSchedulingLinkResponse,
+  Calendar,
+  CalendarAttendee,
+  CalendarAttendeeRequest,
+  CalendarConnection,
+  CalendarConnectionService,
+  CalendarConnectionStatus,
+  CalendarEvent,
+  CalendarEventService,
+  CalendarEventType,
+  CalendarEventTypeService,
+  CalendarEventsResponse,
+  CalendarProvider,
+  CalendarService,
+  CalendarSync,
+  CalendarSyncStatus,
+  CalendarVisibility,
+  CalendarWatch,
+  ConferencingProvider,
+  CreateAvailabilityConstraintRequest,
+  CreateCalendarConnectionRequest,
+  CancelPublicCalendarEventRequest,
+  CreateCalendarEventRequest,
+  CreateSchedulingLinkRequest,
+  EventLocation,
+  EventSource,
+  EventStatus,
+  EventTransparency,
+  EventVisibility,
+  EventWriteStatus,
+  GetPublicSlotsQuery,
+  GetSlotsRequest,
+  GetSlotsResponse,
+  HostsRequest,
+  ListAvailabilityConstraintsQuery,
+  ListCalendarConnectionsQuery,
+  ListCalendarEventTypesQuery,
+  ListCalendarEventsQuery,
+  ListCalendarsQuery,
+  ListSchedulingLinksQuery,
+  LocationKind,
+  // Aliased: the conversation module already exports its own ListResponse.
+  ListResponse as SchedulingListResponse,
+  NotifyMode,
+  ParticipationStatus,
+  PublicBookSchedulingLinkResponse,
+  PublicCalendarEvent,
+  PublicCalendarEventType,
+  PublicEventLocation,
+  PublicHost,
+  PublicSchedulingLink,
+  PublicSchedulingService,
+  PutCalendarEventTypeRequest,
+  PutSchedulingProfileRequest,
+  RecordRef,
+  RecurrenceScope,
+  ReschedulePublicCalendarEventRequest,
+  RescheduleHost,
+  RespondCalendarEventRequest,
+  SchedulingLink,
+  SchedulingLinkService,
+  SchedulingProfile,
+  SchedulingProfileService,
+  Slot,
+  SlotParameters,
+  SlotService,
+  SlotUnavailability,
+  SlotUnavailabilityReason,
+  UpdateCalendarSyncRequest,
+  UpdateAvailabilityConstraintRequest,
+  UpdateCalendarConnectionRequest,
+  UpdateCalendarEventRequest,
+  UpdateCalendarEventTypeRequest,
+  UpdateCalendarRequest,
+  UpdateSchedulingLinkRequest,
+} from './scheduling/index.js'
+// Scheduling client (scheduling-service)
+export { SchedulingClient } from './scheduling/index.js'
 export type {
   CreateFileMetadata,
   FileService,

package/src/meta/layout/elements.ts

@@ -23,6 +23,7 @@ export const LayoutElementType = {
   RecordFilter: 'record_filter',
   List: 'list',
   WorkflowTrigger: 'workflow_trigger',
+  SchedulingPicker: 'scheduling_picker',
 } as const
 export type LayoutElementType = (typeof LayoutElementType)[keyof typeof LayoutElementType]
 
@@ -257,6 +258,24 @@ export type WorkflowTriggerElement = CommonProps & {
   execution_attribute?: string
 }
 
+/**
+ * Embeds a scheduling link's booking flow (type → time → details →
+ * confirmation) in the layout — the in-page counterpart of /s/:orgId/:key.
+ * `type_key` pre-selects one of the link's types (the picker shows the choice
+ * otherwise), `host_user_id` pins one host, `contact_id` is a Liquid template
+ * over the page scope that binds the booking to a known contact (no name /
+ * email asked). Allowed on every page type; public pages book through the
+ * unauthenticated surface.
+ */
+export type SchedulingPickerElement = CommonProps & {
+  type: 'scheduling_picker'
+  link_key: string
+  type_key?: string
+  host_user_id?: string
+  contact_id?: string
+  is_header_hidden?: boolean
+}
+
 export type TextVariant = 'heading' | 'subheading' | 'body' | 'caption' | 'callout'
 
 export type TextElement = CommonProps & {
@@ -280,6 +299,7 @@ export type LayoutElement =
   | RecordFilterElement
   | ListElement
   | WorkflowTriggerElement
+  | SchedulingPickerElement
 
 // ──────────────────────────────────────────────────────────── Schemas ──
 
@@ -410,5 +430,14 @@ export const LayoutElementSchema: z.ZodType<LayoutElement> = z.lazy(() =>
       variant: z.enum(['heading', 'subheading', 'body', 'caption', 'callout']),
       content: z.string().min(1),
     }),
+    z.object({
+      type: z.literal('scheduling_picker'),
+      ...commonPropsShape,
+      link_key: z.string().min(1),
+      type_key: z.string().min(1).optional(),
+      host_user_id: z.string().min(1).optional(),
+      contact_id: z.string().optional(),
+      is_header_hidden: z.boolean().optional(),
+    }),
   ]),
 ) as unknown as z.ZodType<LayoutElement>

package/src/meta/layout/index.ts

@@ -29,6 +29,7 @@ export {
   LayoutTabSchema,
   type ListElement,
   type RecordFilterElement,
+  type SchedulingPickerElement,
   type WorkflowTriggerElement,
   type RelatedListElement,
   type RelatedRecordElement,