@proteos/sdk 0.47.0 → 0.48.0

package/dist/{types-oECz4xTQ.d.ts → types-COxVBT4w.d.ts}

@@ -1430,6 +1430,7 @@ declare const LayoutElementType: {
     readonly Text: "text";
     readonly RecordFilter: "record_filter";
     readonly List: "list";
+    readonly WorkflowTrigger: "workflow_trigger";
 };
 type LayoutElementType = (typeof LayoutElementType)[keyof typeof LayoutElementType];
 type RowElement = CommonProps & {
@@ -1471,11 +1472,19 @@ type CardElement = CommonProps & {
     default_collapsed?: boolean;
     content: LayoutElement;
 };
+/**
+ * One switchable view inside a `tabs` element. `visible_when` hides the tab
+ * when it does not match the record; `default_when` makes it the initially
+ * shown tab when it matches. Both are evaluated live against the record being
+ * viewed or edited. Resolution order: first visible tab (document order) whose
+ * `default_when` matches → `TabsElement.default_tab_id` → first visible tab.
+ */
 type LayoutTab = {
     id: string;
     label: string;
     icon?: string;
     visible_when?: FilterGroup;
+    default_when?: FilterGroup;
     content: LayoutElement;
 };
 type TabsElement = CommonProps & {
@@ -1617,13 +1626,35 @@ type ListElement = CommonProps & {
 type DividerElement = CommonProps & {
     type: 'divider';
 };
+/**
+ * An always-visible button that starts a manual run of `workflow` (by key) —
+ * the in-layout counterpart of a `kind: workflow` toolbar action. `inputs`
+ * maps the manual trigger's input_schema field names to Liquid templates
+ * rendered against the page scope; `skip_confirmation` fires immediately when
+ * every required input resolves. While the run is in flight the element shows
+ * the step progress inline in place of the button.
+ */
+type WorkflowTriggerElement = CommonProps & {
+    type: 'workflow_trigger';
+    workflow: string;
+    label: string;
+    icon?: string;
+    inputs?: Record<string, string>;
+    skip_confirmation?: boolean;
+    /**
+     * Optional string attribute on the page's record where the element persists
+     * the id of the execution it starts — and reads it back, so progress
+     * survives reloads and is shared by every viewer. Record pages only.
+     */
+    execution_attribute?: string;
+};
 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;
+type LayoutElement = RowElement | ColumnElement | SectionElement | CardElement | TabsElement | FieldElement | RelatedListElement | RelatedRecordElement | ComponentElement | DividerElement | TextElement | RecordFilterElement | ListElement | WorkflowTriggerElement;
 declare const LayoutElementSchema: z.ZodType<LayoutElement>;
 
 /**
@@ -3188,20 +3219,20 @@ declare const PageActionSchema: z.ZodObject<{
     label: string;
     icon: string;
     params?: Record<string, string> | undefined;
-    action?: string | undefined;
     workflow?: string | undefined;
-    kind?: "action" | "workflow" | undefined;
     inputs?: Record<string, string> | undefined;
     skip_confirmation?: boolean | undefined;
+    action?: string | undefined;
+    kind?: "workflow" | "action" | undefined;
 }, {
     label: string;
     icon: string;
     params?: Record<string, string> | undefined;
-    action?: string | undefined;
     workflow?: string | undefined;
-    kind?: "action" | "workflow" | undefined;
     inputs?: Record<string, string> | undefined;
     skip_confirmation?: boolean | undefined;
+    action?: string | undefined;
+    kind?: "workflow" | "action" | undefined;
 }>;
 /**
  * Whether a list's rows can be checked, and whether the checkboxes show from
@@ -3314,20 +3345,20 @@ declare const ListSchema: z.ZodObject<{
         label: string;
         icon: string;
         params?: Record<string, string> | undefined;
-        action?: string | undefined;
         workflow?: string | undefined;
-        kind?: "action" | "workflow" | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
+        action?: string | undefined;
+        kind?: "workflow" | "action" | undefined;
     }, {
         label: string;
         icon: string;
         params?: Record<string, string> | undefined;
-        action?: string | undefined;
         workflow?: string | undefined;
-        kind?: "action" | "workflow" | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
+        action?: string | undefined;
+        kind?: "workflow" | "action" | undefined;
     }>, "many">>;
     selection_mode: z.ZodOptional<z.ZodEnum<["on_demand", "always", "off"]>>;
     default_page_slug: z.ZodOptional<z.ZodString>;
@@ -3371,11 +3402,11 @@ declare const ListSchema: z.ZodObject<{
         label: string;
         icon: string;
         params?: Record<string, string> | undefined;
-        action?: string | undefined;
         workflow?: string | undefined;
-        kind?: "action" | "workflow" | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
+        action?: string | undefined;
+        kind?: "workflow" | "action" | undefined;
     }[] | undefined;
     selection_mode?: "on_demand" | "always" | "off" | undefined;
     default_page_slug?: string | undefined;
@@ -3408,11 +3439,11 @@ declare const ListSchema: z.ZodObject<{
         label: string;
         icon: string;
         params?: Record<string, string> | undefined;
-        action?: string | undefined;
         workflow?: string | undefined;
-        kind?: "action" | "workflow" | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
+        action?: string | undefined;
+        kind?: "workflow" | "action" | undefined;
     }[] | undefined;
     selection_mode?: "on_demand" | "always" | "off" | undefined;
     default_page_slug?: string | undefined;
@@ -3677,20 +3708,20 @@ declare const PageSchema: z.ZodObject<{
         label: string;
         icon: string;
         params?: Record<string, string> | undefined;
-        action?: string | undefined;
         workflow?: string | undefined;
-        kind?: "action" | "workflow" | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
+        action?: string | undefined;
+        kind?: "workflow" | "action" | undefined;
     }, {
         label: string;
         icon: string;
         params?: Record<string, string> | undefined;
-        action?: string | undefined;
         workflow?: string | undefined;
-        kind?: "action" | "workflow" | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
+        action?: string | undefined;
+        kind?: "workflow" | "action" | undefined;
     }>, "many">;
     layout: z.ZodObject<{
         version: z.ZodLiteral<1>;
@@ -3772,11 +3803,11 @@ declare const PageSchema: z.ZodObject<{
         label: string;
         icon: string;
         params?: Record<string, string> | undefined;
-        action?: string | undefined;
         workflow?: string | undefined;
-        kind?: "action" | "workflow" | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
+        action?: string | undefined;
+        kind?: "workflow" | "action" | undefined;
     }[];
     layout: {
         version: 1;
@@ -3813,11 +3844,11 @@ declare const PageSchema: z.ZodObject<{
         label: string;
         icon: string;
         params?: Record<string, string> | undefined;
-        action?: string | undefined;
         workflow?: string | undefined;
-        kind?: "action" | "workflow" | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
+        action?: string | undefined;
+        kind?: "workflow" | "action" | undefined;
     }[];
     layout: {
         version: 1;
@@ -4255,4 +4286,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 EntityWithSchema as $, type AuditFields as A, type CreateListViewRequest as B, CURRENT_USER_DEFAULT as C, type CreateMenuConfigurationRequest as D, type CreatePageRequest as E, type FileRef as F, type CreateVariableRequest as G, type CurrencyAttributeMeta as H, CurrencyAttributeMetaSchema as I, type CurrencySymbolSide as J, type CurrencyValue as K, type ListOptions as L, type CurrentUserDefault as M, DEFAULT_OPTIONS as N, DEFAULT_PAGE_SIZE as O, PageIterator as P, DONE as Q, type DeployModuleRequest as R, type DesignReference as S, type DesignReferenceContent as T, type UserRef as U, DesignReferenceSchema as V, type DesignReferenceService as W, type Done as X, type Entity as Y, EntitySchema as Z, type EntityService as _, type Attribute as a, type Timestamps as a$, EntityWithSchemaSchema as a0, type EnumAttributeMeta as a1, type EnumValue as a2, type FileAttributeMeta as a3, FileRefSchema as a4, type FilterElement as a5, FilterElementSchema as a6, type FilterGroup as a7, FilterGroupSchema as a8, type List as a9, ModuleSchema as aA, type ModuleService as aB, type ModuleStatus as aC, type OnDeleteAction as aD, OnDeleteActionSchema as aE, PLATFORM_ATTRIBUTE_NAMES as aF, PLATFORM_USER_ID as aG, type Page as aH, type PageAction as aI, type PageActionKind as aJ, PageActionSchema as aK, type PageLayout as aL, PageLayoutSchema as aM, PageSchema as aN, type PageService as aO, type PageType as aP, type PublicPageComponent as aQ, type PublicPageResponse as aR, type RelationAttributeMeta as aS, RelationAttributeMetaSchema as aT, type RequestOptions as aU, type ResolvedClientOptions as aV, type ResponseMeta as aW, ResponseMetaSchema as aX, type SortConfig as aY, SortConfigSchema as aZ, type SortDirection as a_, type ListAppsOptions as aa, type ListComponentsOptions as ab, type ListDesignReferencesOptions as ac, type ListEntitiesOptions as ad, type ListFn as ae, type ListListViewsOptions as af, type ListListsOptions as ag, type ListMenuConfigurationsOptions as ah, type ListModulesOptions as ai, type ListPagesOptions as aj, ListSchema as ak, type ListService as al, type ListVariablesOptions as am, type ListView as an, ListViewSchema as ao, type ListViewService as ap, type LogicalOperator as aq, type MenuConfiguration as ar, MenuConfigurationSchema as as, type MenuConfigurationService as at, type MenuItem as au, MenuItemSchema as av, MenuItemType as aw, MetaClient as ax, type MetaListOptions as ay, type Module as az, type ListResult as b, type PrincipalAttributeMeta as b$, type TokenProvider as b0, type UpdateAppRequest as b1, type UpdateComponentRequest as b2, type UpdateDesignReferenceRequest as b3, type UpdateEntityRequest as b4, type UpdateListRequest as b5, type UpdateListViewRequest as b6, type UpdateMenuConfigurationRequest as b7, type UpdatePageRequest as b8, type UpdateVariableRequest as b9, type BuiltInControlSlug as bA, type CardElement as bB, type ColumnElement as bC, type CommonProps as bD, type ComponentElement as bE, type ControlBucket as bF, type DatetimeAttributeMeta as bG, type DatetimeFormat as bH, type DividerElement as bI, type FieldElement as bJ, FileAttributeMetaSchema as bK, type LayoutAlign as bL, type LayoutElement as bM, LayoutElementSchema as bN, LayoutElementType as bO, type LayoutGap as bP, type LayoutJustify as bQ, type LayoutTab as bR, type ListElement as bS, type NumberAttributeMeta as bT, type ObjectAttributeMeta as bU, PAGE_BACKGROUND_TOKENS as bV, type PageBackgroundToken as bW, type PageLayoutSidePanel as bX, PageLayoutSidePanelSchema as bY, type PageStyle as bZ, PageStyleSchema as b_, UserRefSchema as ba, type UserType as bb, type Variable as bc, VariableSchema as bd, type VariableService as be, acceptsCurrentUserDefault as bf, allCurrencyCodes as bg, createIterator as bh, createListResultSchema as bi, currencyLabel as bj, currencySymbol as bk, currencySymbolSide as bl, formatAmount as bm, formatMoney as bn, isCurrentUserDefault as bo, isPlatformAttributeName as bp, localeNumberSeparators as bq, parseAmount as br, parseCurrencyMeta as bs, parseFileMeta as bt, parseRelationMeta as bu, platformAttributes as bv, resolveOptions as bw, type AttributeForLookup as bx, type AttributeMeta as by, BUILT_IN_CONTROLS as bz, ProteosClient as c, type PrincipalType as c0, type RecordFilterElement as c1, type RelatedListElement as c2, type RelatedRecordElement as c3, type ResponsiveSizing as c4, type RowElement as c5, type SectionElement as c6, type SizeValue as c7, SizeValueSchema as c8, type SizingProps as c9, type StringAttributeMeta as ca, type StringFormat as cb, type TabsElement as cc, type TextElement as cd, type TextVariant as ce, type UserAttributeMeta as cf, UserAttributeMetaSchema as cg, isBuiltInControl as ch, lookupCompatibleControls as ci, lookupControls as cj, lookupPrimaryControl as ck, parsePrincipalMeta as cl, parseUserMeta as cm, type PrincipalRef as d, type PublicAccessOperation as e, type App as f, AppSchema as g, type AppService as h, type ArrayAttributeMeta as i, type AttributeAccessRule as j, type AttributeRestrictions as k, AttributeSchema as l, type AttributeType as m, AuditFieldsSchema as n, type ClientOptions as o, type Column as p, ColumnSchema as q, type ComparisonOperator as r, type Component as s, ComponentSchema as t, type ComponentService as u, type CreateAppRequest as v, type CreateComponentRequest as w, type CreateDesignReferenceRequest as x, type CreateEntityRequest as y, type CreateListRequest as z };
+export { type EntityWithSchema as $, type AuditFields as A, type CreateListViewRequest as B, CURRENT_USER_DEFAULT as C, type CreateMenuConfigurationRequest as D, type CreatePageRequest as E, type FileRef as F, type CreateVariableRequest as G, type CurrencyAttributeMeta as H, CurrencyAttributeMetaSchema as I, type CurrencySymbolSide as J, type CurrencyValue as K, type ListOptions as L, type CurrentUserDefault as M, DEFAULT_OPTIONS as N, DEFAULT_PAGE_SIZE as O, PageIterator as P, DONE as Q, type DeployModuleRequest as R, type DesignReference as S, type DesignReferenceContent as T, type UserRef as U, DesignReferenceSchema as V, type DesignReferenceService as W, type Done as X, type Entity as Y, EntitySchema as Z, type EntityService as _, type Attribute as a, type Timestamps as a$, EntityWithSchemaSchema as a0, type EnumAttributeMeta as a1, type EnumValue as a2, type FileAttributeMeta as a3, FileRefSchema as a4, type FilterElement as a5, FilterElementSchema as a6, type FilterGroup as a7, FilterGroupSchema as a8, type List as a9, ModuleSchema as aA, type ModuleService as aB, type ModuleStatus as aC, type OnDeleteAction as aD, OnDeleteActionSchema as aE, PLATFORM_ATTRIBUTE_NAMES as aF, PLATFORM_USER_ID as aG, type Page as aH, type PageAction as aI, type PageActionKind as aJ, PageActionSchema as aK, type PageLayout as aL, PageLayoutSchema as aM, PageSchema as aN, type PageService as aO, type PageType as aP, type PublicPageComponent as aQ, type PublicPageResponse as aR, type RelationAttributeMeta as aS, RelationAttributeMetaSchema as aT, type RequestOptions as aU, type ResolvedClientOptions as aV, type ResponseMeta as aW, ResponseMetaSchema as aX, type SortConfig as aY, SortConfigSchema as aZ, type SortDirection as a_, type ListAppsOptions as aa, type ListComponentsOptions as ab, type ListDesignReferencesOptions as ac, type ListEntitiesOptions as ad, type ListFn as ae, type ListListViewsOptions as af, type ListListsOptions as ag, type ListMenuConfigurationsOptions as ah, type ListModulesOptions as ai, type ListPagesOptions as aj, ListSchema as ak, type ListService as al, type ListVariablesOptions as am, type ListView as an, ListViewSchema as ao, type ListViewService as ap, type LogicalOperator as aq, type MenuConfiguration as ar, MenuConfigurationSchema as as, type MenuConfigurationService as at, type MenuItem as au, MenuItemSchema as av, MenuItemType as aw, MetaClient as ax, type MetaListOptions as ay, type Module as az, type ListResult as b, type PrincipalAttributeMeta as b$, type TokenProvider as b0, type UpdateAppRequest as b1, type UpdateComponentRequest as b2, type UpdateDesignReferenceRequest as b3, type UpdateEntityRequest as b4, type UpdateListRequest as b5, type UpdateListViewRequest as b6, type UpdateMenuConfigurationRequest as b7, type UpdatePageRequest as b8, type UpdateVariableRequest as b9, type BuiltInControlSlug as bA, type CardElement as bB, type ColumnElement as bC, type CommonProps as bD, type ComponentElement as bE, type ControlBucket as bF, type DatetimeAttributeMeta as bG, type DatetimeFormat as bH, type DividerElement as bI, type FieldElement as bJ, FileAttributeMetaSchema as bK, type LayoutAlign as bL, type LayoutElement as bM, LayoutElementSchema as bN, LayoutElementType as bO, type LayoutGap as bP, type LayoutJustify as bQ, type LayoutTab as bR, type ListElement as bS, type NumberAttributeMeta as bT, type ObjectAttributeMeta as bU, PAGE_BACKGROUND_TOKENS as bV, type PageBackgroundToken as bW, type PageLayoutSidePanel as bX, PageLayoutSidePanelSchema as bY, type PageStyle as bZ, PageStyleSchema as b_, UserRefSchema as ba, type UserType as bb, type Variable as bc, VariableSchema as bd, type VariableService as be, acceptsCurrentUserDefault as bf, allCurrencyCodes as bg, createIterator as bh, createListResultSchema as bi, currencyLabel as bj, currencySymbol as bk, currencySymbolSide as bl, formatAmount as bm, formatMoney as bn, isCurrentUserDefault as bo, isPlatformAttributeName as bp, localeNumberSeparators as bq, parseAmount as br, parseCurrencyMeta as bs, parseFileMeta as bt, parseRelationMeta as bu, platformAttributes as bv, resolveOptions as bw, type AttributeForLookup as bx, type AttributeMeta as by, BUILT_IN_CONTROLS as bz, ProteosClient as c, type PrincipalType as c0, type RecordFilterElement as c1, type RelatedListElement as c2, type RelatedRecordElement as c3, type ResponsiveSizing as c4, type RowElement as c5, type SectionElement as c6, type SizeValue as c7, SizeValueSchema as c8, type SizingProps as c9, type StringAttributeMeta as ca, type StringFormat as cb, type TabsElement as cc, type TextElement as cd, type TextVariant as ce, type UserAttributeMeta as cf, UserAttributeMetaSchema as cg, type WorkflowTriggerElement as ch, isBuiltInControl as ci, lookupCompatibleControls as cj, lookupControls as ck, lookupPrimaryControl as cl, parsePrincipalMeta as cm, parseUserMeta as cn, type PrincipalRef as d, type PublicAccessOperation as e, type App as f, AppSchema as g, type AppService as h, type ArrayAttributeMeta as i, type AttributeAccessRule as j, type AttributeRestrictions as k, AttributeSchema as l, type AttributeType as m, AuditFieldsSchema as n, type ClientOptions as o, type Column as p, ColumnSchema as q, type ComparisonOperator as r, type Component as s, ComponentSchema as t, type ComponentService as u, type CreateAppRequest as v, type CreateComponentRequest as w, type CreateDesignReferenceRequest as x, type CreateEntityRequest as y, type CreateListRequest as z };

package/package.json

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

package/src/conversation/index.ts

@@ -29,6 +29,7 @@ import type {
   DeleteConnectionQuery,
   DispatchMeetingBotRequest,
   GlossaryTerm,
+  InstallConnectionRequest,
   InstallConnectionResponse,
   ListAgentListenersQuery,
   ListConnectionsQuery,
@@ -49,7 +50,11 @@ import type {
   ListToneProfileSetupsQuery,
   ListToneProfilesQuery,
   ListTranscriptionsQuery,
+  CallTokenResponse,
   MaterializeTranscriptionRequest,
+  MintCallTokenRequest,
+  PhoneNumber,
+  UpdatePhoneNumberRequest,
   MergeContactsRequest,
   Message,
   MistranscribedTerm,
@@ -112,6 +117,7 @@ export class ConversationClient {
   readonly meetings: MeetingService
   /** Realtime speech-to-text (dictation) — moved here from agent-service. */
   readonly voice: VoiceService
+  readonly calls: CallService
 
   constructor(client: ProteosClient) {
     this.connections = new ConnectionServiceImpl(client)
@@ -128,6 +134,7 @@ export class ConversationClient {
     this.mistranscribedTerms = new MistranscribedTermServiceImpl(client)
     this.meetings = new MeetingServiceImpl(client)
     this.voice = new VoiceServiceImpl(client)
+    this.calls = new CallServiceImpl(client)
   }
 }
 
@@ -193,8 +200,13 @@ export interface ConnectionService {
    * clean up at the provider by hand.
    */
   delete(id: string, query?: DeleteConnectionQuery): Promise<void>
-  /** Begin the connector's install flow; open the returned URL in a popup. */
-  install(id: string): Promise<InstallConnectionResponse>
+  /**
+   * Begin the connector's install flow. OAuth connectors return an
+   * `authorization_url` to open in a popup; direct-install connectors take
+   * `{ input }` (user-supplied credentials) and complete server-side,
+   * returning `is_completed` plus a one-time `setup` handout.
+   */
+  install(id: string, request?: InstallConnectionRequest): 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
@@ -247,10 +259,11 @@ class ConnectionServiceImpl implements ConnectionService {
     )
   }
 
-  install(id: string): Promise<InstallConnectionResponse> {
+  install(id: string, request?: InstallConnectionRequest): Promise<InstallConnectionResponse> {
     return this.client.request(
       'POST',
       `${CONVERSATION_BASE_PATH}/connections/${encodeURIComponent(id)}/install`,
+      request,
     )
   }
 
@@ -1107,6 +1120,77 @@ class MistranscribedTermServiceImpl implements MistranscribedTermService {
   }
 }
 
+/**
+ * Softphone calling: the browser Voice token grant. The client identity is
+ * derived server-side from the authenticated user; refresh by minting again
+ * (the Voice SDK's tokenWillExpire event is the cue).
+ */
+export interface CallService {
+  mintToken(request: MintCallTokenRequest): Promise<CallTokenResponse>
+  /** A phone connection's provider numbers with status + routing. */
+  listPhoneNumbers(connectionId: string): Promise<{ data: PhoneNumber[] }>
+  /** Replace one number's routing (who it rings). Returns the refreshed list. */
+  updatePhoneNumber(
+    connectionId: string,
+    numberExternalId: string,
+    request: UpdatePhoneNumberRequest,
+  ): Promise<{ data: PhoneNumber[] }>
+  /** Point one number at the platform. Returns the refreshed list. */
+  connectPhoneNumber(connectionId: string, numberExternalId: string): Promise<{ data: PhoneNumber[] }>
+  /** Release one number (restores its previous handler). Returns the refreshed list. */
+  disconnectPhoneNumber(
+    connectionId: string,
+    numberExternalId: string,
+  ): Promise<{ data: PhoneNumber[] }>
+}
+
+class CallServiceImpl implements CallService {
+  constructor(private readonly client: ProteosClient) {}
+
+  mintToken(request: MintCallTokenRequest): Promise<CallTokenResponse> {
+    return this.client.request('POST', `${CONVERSATION_BASE_PATH}/calls/token`, request)
+  }
+
+  listPhoneNumbers(connectionId: string): Promise<{ data: PhoneNumber[] }> {
+    return this.client.request(
+      'GET',
+      `${CONVERSATION_BASE_PATH}/connections/${encodeURIComponent(connectionId)}/phone-numbers`,
+    )
+  }
+
+  updatePhoneNumber(
+    connectionId: string,
+    numberExternalId: string,
+    request: UpdatePhoneNumberRequest,
+  ): Promise<{ data: PhoneNumber[] }> {
+    return this.client.request(
+      'PUT',
+      `${CONVERSATION_BASE_PATH}/connections/${encodeURIComponent(connectionId)}/phone-numbers/${encodeURIComponent(numberExternalId)}`,
+      request,
+    )
+  }
+
+  connectPhoneNumber(
+    connectionId: string,
+    numberExternalId: string,
+  ): Promise<{ data: PhoneNumber[] }> {
+    return this.client.request(
+      'POST',
+      `${CONVERSATION_BASE_PATH}/connections/${encodeURIComponent(connectionId)}/phone-numbers/${encodeURIComponent(numberExternalId)}/connect`,
+    )
+  }
+
+  disconnectPhoneNumber(
+    connectionId: string,
+    numberExternalId: string,
+  ): Promise<{ data: PhoneNumber[] }> {
+    return this.client.request(
+      'POST',
+      `${CONVERSATION_BASE_PATH}/connections/${encodeURIComponent(connectionId)}/phone-numbers/${encodeURIComponent(numberExternalId)}/disconnect`,
+    )
+  }
+}
+
 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

@@ -26,6 +26,7 @@ export type Channel =
   | 'teams-meeting'
   | 'webex-meeting'
   | 'adhoc'
+  | 'phone'
   | 'instagram'
   | 'messenger'
   | 'x'
@@ -52,6 +53,83 @@ export type ConnectorKey =
   | 'adhoc-meeting'
   | 'google-calendar-meeting'
   | 'microsoft-calendar-meeting'
+  | 'twilio-phone'
+  | 'aircall'
+  | 'webhook-cti'
+
+/**
+ * Telephony lifecycle of one phone call, carried in the call conversation's
+ * `metadata.call_status` (a call is a conversation plus call facts — no
+ * dedicated resource). Status callbacks apply through a monotonic guard, so a
+ * terminal value never regresses.
+ */
+/**
+ * Body of POST /conversations/v1/calls/token — the softphone's browser-calling
+ * grant for one connection. The client identity is derived server-side from
+ * the authenticated user.
+ */
+export interface MintCallTokenRequest {
+  connection_id: string
+}
+
+/**
+ * Which system answers a provider phone number: connected to this platform,
+ * in use by another integration (connecting takes it over, disconnecting
+ * restores it), or configured nowhere (available).
+ */
+export type PhoneNumberStatus = 'connected' | 'available' | 'in_use'
+
+/** One dispatch target: a platform user (id) or a team (slug). */
+export interface RoutingTarget {
+  type: 'user' | 'team'
+  id: string
+}
+
+/**
+ * A connected number's user-level dispatch: who a call rings. v1 rings every
+ * expanded target in parallel (teams expand to their direct members at ring
+ * time); the object shape leaves room for later strategy options. Empty
+ * targets fall back to the connection-wide routing, then busy.
+ */
+export interface PhoneNumberRouting {
+  targets: RoutingTarget[]
+}
+
+/** One provider phone number on a phone connection. */
+export interface PhoneNumber {
+  /** Provider-side number identity (vendor vocabulary stays in the adapter). */
+  external_id: string
+  phone_number: string
+  friendly_name: string
+  status: PhoneNumberStatus
+  /** Display-only description of what an in_use number is used by. */
+  used_by?: string
+  routing: PhoneNumberRouting
+}
+
+/** Routing update for one phone number (connect/disconnect are actions). */
+export interface UpdatePhoneNumberRequest {
+  routing?: PhoneNumberRouting
+}
+
+/** The minted grant the Voice JS SDK consumes (`new Device(token, { edge })`). */
+export interface CallTokenResponse {
+  token: string
+  identity: string
+  /** Vendor edge to connect through ('dublin' for the EU default). */
+  edge?: string
+  expires_at: string
+}
+
+export type CallStatus =
+  | 'queued'
+  | 'ringing'
+  | 'in_progress'
+  | 'completed'
+  | 'no_answer'
+  | 'busy'
+  | 'failed'
+  | 'canceled'
 
 /**
  * Who operates the integration mechanics behind a connector: Proteos' own
@@ -486,8 +564,27 @@ export interface UpdateConnectionRequest {
   settings?: Record<string, unknown>
 }
 
+/**
+ * Optional body of POST /connections/:id/install. `input` carries
+ * user-supplied install credentials for direct-install connectors
+ * (twilio-phone, aircall, webhook-cti — connector-documented snake_case
+ * keys); omit it for OAuth/hosted connectors.
+ */
+export interface InstallConnectionRequest {
+  input?: Record<string, string>
+}
+
 export interface InstallConnectionResponse {
-  authorization_url: string
+  /** OAuth/hosted installs: open this in a popup. Absent on direct installs. */
+  authorization_url?: string
+  /** Direct installs complete server-side in this request. */
+  is_completed?: boolean
+  /**
+   * A direct-install connector's one-time setup handout (callback URLs to
+   * paste provider-side; a minted token shown exactly once — only its hash is
+   * stored server-side). Never retrievable again.
+   */
+  setup?: Record<string, string>
 }
 
 export interface SendMessageRequest {
@@ -852,6 +949,11 @@ export interface ListConnectionsQuery extends PaginationQuery {
   connector_key?: string
   channel?: string
   scope?: string
+  /**
+   * Narrows to the user-scoped connections one person owns. Org-scoped
+   * connections have no owner and never match.
+   */
+  owner_id?: string
   status?: string
 }
 

package/src/data/types.ts

@@ -18,6 +18,15 @@ export type RecordData = Record<string, any>
  * (via bracket syntax) include `[eq]`, `[ne]`, `[gt]`, `[gte]`, `[lt]`,
  * `[lte]`, `[in]` (pipe-separated), `[not_in]`, `[contains]`, `[starts_with]`,
  * `[ends_with]`, `[empty]`, `[not_empty]`. Missing operator defaults to `[eq]`.
+ * A filter key may reach one hop through a relation attribute with a dotted
+ * path (`"company_id.name[contains]": "acme"`).
+ *
+ * For nested AND/OR trees, pass a filter group (the same wire dialect as
+ * `List.filters` / `visible_when`: `{logical_operator, elements: [{field,
+ * operator, value}], groups}`, string values, pipe-joined for in/not_in)
+ * JSON-encoded under the reserved `_filter` key:
+ * `{ _filter: JSON.stringify(group) }`. The server ANDs it with any flat
+ * filter params.
  */
 export interface ListRecordsOptions {
   /** Page number (0-indexed). First page is 0. */

package/src/index.ts

@@ -227,6 +227,8 @@ export type {
   AutomatedFilterConfig,
   AutomatedSignal,
   BlockContactRequest,
+  CallStatus,
+  CallTokenResponse,
   Channel,
   Connection,
   ConnectionCredentials,
@@ -310,7 +312,12 @@ export type {
   MessageRecipient,
   MessageService,
   MessageStatus,
+  MintCallTokenRequest,
   MistranscribedTerm,
+  PhoneNumber,
+  PhoneNumberRouting,
+  PhoneNumberStatus,
+  RoutingTarget,
   MistranscribedTermService,
   MistranscribedTermStatus,
   MistranscriptionSuggestionSource,
@@ -349,6 +356,7 @@ export type {
   UpdateConversationTypeRequest,
   UpdateDraftRequest,
   UpdateGlossaryTermRequest,
+  UpdatePhoneNumberRequest,
   VoiceService,
   VoiceTranscriptionStream,
 } from './conversation/index.js'

package/src/meta/layout/elements.ts

@@ -22,6 +22,7 @@ export const LayoutElementType = {
   Text: 'text',
   RecordFilter: 'record_filter',
   List: 'list',
+  WorkflowTrigger: 'workflow_trigger',
 } as const
 export type LayoutElementType = (typeof LayoutElementType)[keyof typeof LayoutElementType]
 
@@ -68,11 +69,19 @@ export type CardElement = CommonProps & {
   content: LayoutElement
 }
 
+/**
+ * One switchable view inside a `tabs` element. `visible_when` hides the tab
+ * when it does not match the record; `default_when` makes it the initially
+ * shown tab when it matches. Both are evaluated live against the record being
+ * viewed or edited. Resolution order: first visible tab (document order) whose
+ * `default_when` matches → `TabsElement.default_tab_id` → first visible tab.
+ */
 export type LayoutTab = {
   id: string
   label: string
   icon?: string
   visible_when?: FilterGroup
+  default_when?: FilterGroup
   content: LayoutElement
 }
 
@@ -223,6 +232,29 @@ export type DividerElement = CommonProps & {
   type: 'divider'
 }
 
+/**
+ * An always-visible button that starts a manual run of `workflow` (by key) —
+ * the in-layout counterpart of a `kind: workflow` toolbar action. `inputs`
+ * maps the manual trigger's input_schema field names to Liquid templates
+ * rendered against the page scope; `skip_confirmation` fires immediately when
+ * every required input resolves. While the run is in flight the element shows
+ * the step progress inline in place of the button.
+ */
+export type WorkflowTriggerElement = CommonProps & {
+  type: 'workflow_trigger'
+  workflow: string
+  label: string
+  icon?: string
+  inputs?: Record<string, string>
+  skip_confirmation?: boolean
+  /**
+   * Optional string attribute on the page's record where the element persists
+   * the id of the execution it starts — and reads it back, so progress
+   * survives reloads and is shared by every viewer. Record pages only.
+   */
+  execution_attribute?: string
+}
+
 export type TextVariant = 'heading' | 'subheading' | 'body' | 'caption' | 'callout'
 
 export type TextElement = CommonProps & {
@@ -245,6 +277,7 @@ export type LayoutElement =
   | TextElement
   | RecordFilterElement
   | ListElement
+  | WorkflowTriggerElement
 
 // ──────────────────────────────────────────────────────────── Schemas ──
 
@@ -294,6 +327,7 @@ export const LayoutElementSchema: z.ZodType<LayoutElement> = z.lazy(() =>
           label: z.string().min(1),
           icon: z.string().optional(),
           visible_when: FilterGroupSchema.optional(),
+          default_when: FilterGroupSchema.optional(),
           content: LayoutElementSchema,
         }),
       ),
@@ -355,6 +389,16 @@ export const LayoutElementSchema: z.ZodType<LayoutElement> = z.lazy(() =>
       type: z.literal('divider'),
       ...commonPropsShape,
     }),
+    z.object({
+      type: z.literal('workflow_trigger'),
+      ...commonPropsShape,
+      workflow: z.string().min(1),
+      label: z.string().min(1),
+      icon: z.string().optional(),
+      inputs: z.record(z.string()).optional(),
+      skip_confirmation: z.boolean().optional(),
+      execution_attribute: z.string().min(1).optional(),
+    }),
     z.object({
       type: z.literal('text'),
       ...commonPropsShape,

package/src/meta/layout/index.ts

@@ -28,6 +28,7 @@ export {
   type LayoutTab,
   type ListElement,
   type RecordFilterElement,
+  type WorkflowTriggerElement,
   type RelatedListElement,
   type RelatedRecordElement,
   type RowElement,