@proteos/sdk 0.40.0 → 0.41.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -2768,6 +2768,118 @@ interface ListConversationTypesQuery extends PaginationQuery {
2768
2768
  search?: string;
2769
2769
  module_slug?: string;
2770
2770
  }
2771
+ /** Who assigned a contact's group membership. */
2772
+ type ContactGroupSource = 'manual' | 'model';
2773
+ /**
2774
+ * A generic org-shared audience taxonomy entry ("external-client",
2775
+ * "internal-colleague", …) — NOT tone-specific. Membership lives on the
2776
+ * contact (`Contact.group_key`, one group per contact) and is assignable by
2777
+ * any flow; tone-of-voice synthesis both reads and auto-assigns groups.
2778
+ * Module-deployable (contact-groups/<key>.json).
2779
+ */
2780
+ interface ContactGroup {
2781
+ org_id: string;
2782
+ /** Immutable identity within the org — what models answer with. */
2783
+ key: string;
2784
+ name: string;
2785
+ /** Who belongs in the group — injected verbatim into the synthesis prompt. */
2786
+ description?: string;
2787
+ /** True when tone synthesis proposed the group. Server-owned. */
2788
+ is_auto_created: boolean;
2789
+ /** Module that deployed the group; absent when not module-owned. */
2790
+ module_slug?: string;
2791
+ created_at: string;
2792
+ created_by: UserRef;
2793
+ updated_at: string;
2794
+ updated_by: UserRef;
2795
+ }
2796
+ interface CreateContactGroupRequest {
2797
+ /** Lowercase kebab/snake/camel handle — no spaces. */
2798
+ key: string;
2799
+ name: string;
2800
+ description?: string;
2801
+ module_slug?: string;
2802
+ }
2803
+ interface UpdateContactGroupRequest {
2804
+ name?: string;
2805
+ description?: string;
2806
+ }
2807
+ interface ListContactGroupsQuery extends PaginationQuery {
2808
+ /** Case-insensitive substring match on key or name. */
2809
+ search?: string;
2810
+ module_slug?: string;
2811
+ }
2812
+ /** The whole-user synthesis lifecycle on a tone profile setup. */
2813
+ type ToneProfileSetupStatus = 'empty' | 'processing' | 'ready';
2814
+ /** A tone profile row's tier — derived, most specific wins at read time. */
2815
+ type ToneProfileScope = 'user' | 'channel' | 'group' | 'contact';
2816
+ /**
2817
+ * The per-user opt-in for tone-of-voice synthesis: only set-up users are
2818
+ * swept. Also carries the whole-user synthesis claim (status/started_at).
2819
+ */
2820
+ interface ToneProfileSetup {
2821
+ id: string;
2822
+ org_id: string;
2823
+ /** The profiled platform user. */
2824
+ owned_by: UserRef;
2825
+ status: ToneProfileSetupStatus;
2826
+ started_at?: string;
2827
+ last_synthesized_at?: string;
2828
+ created_at: string;
2829
+ created_by: UserRef;
2830
+ updated_at: string;
2831
+ updated_by: UserRef;
2832
+ }
2833
+ /**
2834
+ * One generated tone-of-voice instruction row. Rows form a specificity
2835
+ * hierarchy — user aggregate (the constant voice), per-channel base, per
2836
+ * contact-group, per individual contact — and every row is SELF-CONTAINED: a
2837
+ * drafting consumer injects exactly one row's `instructions` verbatim (use
2838
+ * the resolve endpoint), never a concatenation of tiers.
2839
+ */
2840
+ interface ToneProfile {
2841
+ id: string;
2842
+ org_id: string;
2843
+ /** The profiled platform user. */
2844
+ owned_by: UserRef;
2845
+ /** Absent = the cross-channel user aggregate (the voice proper). */
2846
+ channel?: Channel;
2847
+ /** Scopes the row to one contact group; absent = the (user, channel) base. */
2848
+ contact_group_key?: string;
2849
+ /** Scopes the row to one individual contact within the group. */
2850
+ contact_id?: string;
2851
+ scope: ToneProfileScope;
2852
+ /** COMPLETE markdown instruction set, served verbatim to a drafting model. */
2853
+ instructions: string;
2854
+ /** Short delta vs the tier above — what a human scans; empty on root tiers. */
2855
+ differences?: string;
2856
+ sample_count: number;
2857
+ last_message_at?: string;
2858
+ last_synthesized_at?: string;
2859
+ created_at: string;
2860
+ created_by: UserRef;
2861
+ updated_at: string;
2862
+ updated_by: UserRef;
2863
+ }
2864
+ interface CreateToneProfileSetupRequest {
2865
+ /** Bare platform user id; the service resolves the full ref. */
2866
+ owned_by_id: string;
2867
+ }
2868
+ type ListToneProfileSetupsQuery = PaginationQuery;
2869
+ interface ListToneProfilesQuery extends PaginationQuery {
2870
+ owned_by_id?: string;
2871
+ channel?: Channel;
2872
+ scope?: ToneProfileScope;
2873
+ }
2874
+ /**
2875
+ * A drafting context to resolve the single most-specific profile for:
2876
+ * contact → group → channel base → user aggregate.
2877
+ */
2878
+ interface ResolveToneProfileQuery {
2879
+ owned_by_id: string;
2880
+ channel?: Channel;
2881
+ contact_id?: string;
2882
+ }
2771
2883
  interface PaginationQuery {
2772
2884
  page?: number;
2773
2885
  page_size?: number;
@@ -2995,6 +3107,13 @@ interface Contact {
2995
3107
  /** Merge tombstone redirect (set when status is 'merged'). */
2996
3108
  merged_into_contact_id?: string;
2997
3109
  source: ContactSource;
3110
+ /** ContactGroup membership (one group per contact); absent = unassigned. */
3111
+ group_key?: string;
3112
+ /**
3113
+ * Who assigned the group: 'manual' assignments are authoritative (tone
3114
+ * synthesis never overrides them), 'model' ones may be reassigned by a run.
3115
+ */
3116
+ group_source?: ContactGroupSource;
2998
3117
  has_manual_edits: boolean;
2999
3118
  /** The contact's reachable endpoints, embedded on reads. */
3000
3119
  addresses?: ContactAddress[];
@@ -3087,11 +3206,18 @@ interface ListContactsQuery extends PaginationQuery {
3087
3206
  /** Free-text needle matched against contact name + address values. */
3088
3207
  q?: string;
3089
3208
  status?: ContactStatus;
3209
+ /** Members of one contact group (drives group-member lists). */
3210
+ group_key?: string;
3090
3211
  }
3091
3212
  interface UpdateContactRequest {
3092
3213
  name?: string;
3093
3214
  status?: 'active' | 'archived';
3094
3215
  has_legal_hold?: boolean;
3216
+ /**
3217
+ * Assigns the contact to a contact group ('' clears). A PATCH assignment is
3218
+ * stamped group_source='manual' — tone synthesis never overrides it.
3219
+ */
3220
+ group_key?: string;
3095
3221
  }
3096
3222
  interface AttachContactAddressRequest {
3097
3223
  kind: ContactAddressKind;
@@ -3365,6 +3491,10 @@ declare class ConversationClient {
3365
3491
  readonly glossaryTerms: GlossaryTermService;
3366
3492
  /** Conversation taxonomy: the types the pre-summary classifier assigns. */
3367
3493
  readonly conversationTypes: ConversationTypeService;
3494
+ /** Generic audience taxonomy; membership lives on the contact. */
3495
+ readonly contactGroups: ContactGroupService;
3496
+ /** Tone-of-voice synthesis: per-user setups + the generated profiles. */
3497
+ readonly toneProfiles: ToneProfileService;
3368
3498
  readonly transcriptions: TranscriptionService;
3369
3499
  /** Review-pass findings: likely misheard terms awaiting accept/reject. */
3370
3500
  readonly mistranscribedTerms: MistranscribedTermService;
@@ -3548,6 +3678,43 @@ interface ConversationTypeService {
3548
3678
  upsert(key: string, request: CreateConversationTypeRequest): Promise<ConversationType>;
3549
3679
  delete(key: string): Promise<void>;
3550
3680
  }
3681
+ /**
3682
+ * Contact groups: the generic org-shared audience taxonomy. Membership lives
3683
+ * on the contact (`Contact.group_key`, one group per contact — assign via
3684
+ * `contacts.update`); tone-of-voice synthesis reads the groups and
3685
+ * auto-assigns ungrouped correspondents. Keyed by `key` (not id); `upsert` is
3686
+ * the idempotent module-deploy door. Deleting a group clears its members'
3687
+ * membership and purges its tone profile rows.
3688
+ */
3689
+ interface ContactGroupService {
3690
+ list(query?: ListContactGroupsQuery): Promise<ListResponse<ContactGroup>>;
3691
+ get(key: string): Promise<ContactGroup>;
3692
+ create(request: CreateContactGroupRequest): Promise<ContactGroup>;
3693
+ update(key: string, request: UpdateContactGroupRequest): Promise<ContactGroup>;
3694
+ /** Idempotent create-or-update by key (PUT) — what `pro module deploy` calls. */
3695
+ upsert(key: string, request: CreateContactGroupRequest): Promise<ContactGroup>;
3696
+ delete(key: string): Promise<void>;
3697
+ }
3698
+ /**
3699
+ * Tone-of-voice synthesis. A setup opts one platform user in (only set-up
3700
+ * users are swept); `synthesize` triggers a whole-user run immediately (202;
3701
+ * 409 `synthesis_in_progress` while one is live). Generated profiles form a
3702
+ * specificity hierarchy — fetch a user's rows with `listProfiles`, or let the
3703
+ * server pick the single most-specific row for a drafting context with
3704
+ * `resolve` (each row is self-contained; never concatenate tiers).
3705
+ */
3706
+ interface ToneProfileService {
3707
+ listSetups(query?: ListToneProfileSetupsQuery): Promise<ListResponse<ToneProfileSetup>>;
3708
+ createSetup(request: CreateToneProfileSetupRequest): Promise<ToneProfileSetup>;
3709
+ /** Removes the setup AND the user's generated profiles. */
3710
+ deleteSetup(id: string): Promise<void>;
3711
+ /** Kicks a whole-user synthesis run off-request (bypasses cadence checks). */
3712
+ synthesize(setupId: string): Promise<void>;
3713
+ listProfiles(query?: ListToneProfilesQuery): Promise<ListResponse<ToneProfile>>;
3714
+ getProfile(id: string): Promise<ToneProfile>;
3715
+ /** The single most-specific profile for a drafting context; 404 when none. */
3716
+ resolve(query: ResolveToneProfileQuery): Promise<ToneProfile>;
3717
+ }
3551
3718
  /** Batch transcription of stored audio files + materialization. */
3552
3719
  interface TranscriptionService {
3553
3720
  /**
@@ -6304,4 +6471,4 @@ declare class WorkflowClient {
6304
6471
  constructor(client: ProteosClient);
6305
6472
  }
6306
6473
 
6307
- export { type AcceptMistranscribedTermRequest, AccountClient, type Action, type ActionBinding, ActionSchema, type ActionScope, ActionScopeSchema, type ActionService, type AddressFilterConfig, type Agent, type AgentActionParams, type AgentArtifactsPayload, AgentClient, type AgentListener, type AgentListenerAcknowledgementConfig, type AgentListenerAcknowledgementType, type AgentListenerActingUserMode, type AgentListenerService, type AgentListenerTriggerType, type AgentMessagePayload, type AgentResourceListOptions, type AgentService, type AllFilterConfig, type ApiErrorResponse, type AppendEventRequest, type AssignPermissionRequest, type AssignRoleRequest, type AttachContactAddressRequest, type Attachment, Attribute, AuditFields, type AuthListOptions, type AutomatedFilterConfig, type AutomatedSignal, type BatchTransactionError, BatchTransactionErrorSchema, type BatchTransactionStatus, type BatchUpsertRecordsResponse, BatchUpsertRecordsResponseSchema, type BatchUpsertTransaction, type BatchUpsertTransactionResult, BatchUpsertTransactionResultSchema, BatchUpsertTransactionSchema, type BinaryRef, type BlockContactRequest, type Channel, type ClientEventType, type ClientToolSchema, type Connection, type ConnectionCredentials, type ConnectionEndpoint, type ConnectionScope, type ConnectionService, type ConnectionStatus, type ConnectionSyncRange, type ConnectionSyncStatus, type Connector, ConnectorClient, type ConnectorConnection, type ConnectionScope$1 as ConnectorConnectionScope, type ConnectionStatus$1 as ConnectorConnectionStatus, type ConnectionTokenResponse as ConnectorConnectionTokenResponse, type CredentialKind as ConnectorCredentialKind, type ConnectorKey, type ConnectorMethod, type ConnectorProvider, type ConsentStatus, type ConsumerGroup, type Contact, type ContactAddress, type ContactAddressKind, type ContactAddressSource, type ContactErasureRequest, type ContactMergeProposal, type ContactRef, type ContactService, type ContactSource, type ContactStatus, type ContentBlock$1 as ContentBlock, type ContentMatch, type ContentResponse, type ContextCompactedPayload, type Conversation, ConversationClient, type ConversationFilter, type ConversationFilterAction, type ConversationFilterConfig, type ConversationFilterEvent, type ConversationFilterService, type ConversationFilterType, type ConversationParticipant, type ConversationService, type ConversationStatus, type ConversationSummaryStatus, type ConversationType, type ConversationTypeConfig, type ConversationTypeService, type CreateAgentListenerRequest, type CreateAgentRequest, type CreateConnectionRequest, type CreateConnectorConnectionRequest, type CreateConversationFilterRequest, type CreateConversationTypeRequest, type CreateFileMetadata, type CreateGlossaryTermRequest, type CreateLabelRequest, type CreateLinkRequest, type CreateMcpServerRequest, type CreateNodeRequest, type CreateOrganizationRequest, type CreatePromptRequest, type CreateRecordLinkRequest, type CreateRoleRequest, type CreateSessionRequest, type CreateToolRequest, type CreateToolsetRequest, type CreateUserRequest, type CreateWorkflowRequest, type CredentialSpec, type CronTriggerParams, DEFAULT_PORT, DataClient, type DependentAgent, type DependentSyncResult, type DispatchMeetingBotRequest, type DisplayOptions, type DomainFilterConfig, ERROR_PORT, type EditContentRequest, type EditContentResponse, type EmptyPayload, type ErasureRequestStatus, ErrorCode, type ErrorCodeType, type ErrorPayload, type EventTriggerParams, type EventType, type EventVerb, EventsClient, type ExecutionError, type ExecutionStatus, type ExecutionTriggerContext, type FileBlock, FileRef, type FileService, type FileVersionContent, type FilterMatchOn, FunctionsClient, type GetExecutionDetailResponse, type GetGraphOptions, type GetNodeExecutionItemsOptions, type GetNodeExecutionItemsResponse, type GetNodeTypesResponse, type GlossaryTerm, type GlossaryTermService, type GraphService, type InlineLinkRequest, type InstallConnectionResponse, type InstallConnectorConnectionResponse, type InternalConversationsFilterConfig, type InvokeActionResponse, type InvokeNodeMethodRequest, type InvokeNodeMethodResponse, type Item, type KickoffSource, type KickoffType, KnowledgeClient, type KnowledgeGraph, type KnowledgeGraphLink, type KnowledgeGraphNode, type KnowledgeLabel, KnowledgeLabelSchema, type KnowledgeLink, KnowledgeLinkSchema, type KnowledgeNode, type KnowledgeNodeLabel, KnowledgeNodeLabelSchema, type KnowledgeNodeMetadata, KnowledgeNodeMetadataSchema, KnowledgeNodeSchema, type KnowledgeNodeSearchResult, KnowledgeNodeSearchResultSchema, type KnowledgeRecordLink, KnowledgeRecordLinkSchema, type LabelService, type LinkService, type LinkType, type ListActionsOptions, type ListAgentListenersQuery, type ListAgentsOptions, type ListConnectionsQuery, type ListConnectorConnectionsQuery, type ListConnectorsQuery, type ListContactAddressesQuery, type ListContactMergeProposalsQuery, type ListContactsQuery, type ListConversationFilterEventsQuery, type ListConversationFiltersQuery, type ListConversationTypesQuery, type ListConversationsQuery, type ListEventsOptions, type ListExecutionsOptions, type ListGlossaryTermsQuery, type ListLabelsOptions, type ListLinksOptions, type ListMcpServersOptions, type ListMessagesQuery, type ListMistranscribedTermsQuery, type ListNodesOptions, ListOptions, type ListOrganizationsOptions, type ListPromptsOptions, type ListRecordLinksOptions, type ListRecordsOptions, type ListResponse, ListResult, type ListRolePermissionsOptions, type ListRolesOptions, type ListRoomsQuery, type ListSessionsOptions, type ListSkillsOptions, type ListToolsOptions, type ListToolsetsOptions, type ListUserRoleAssignmentsOptions, type ListUsersOptions, type ListWorkflowsOptions, type ManualTriggerParams, type MatchMode, type McpBinding, type McpConnectionState, type McpConnectionStatus, type McpServer, type McpServerAuth, type McpServerOAuth, type McpServerService, type McpToolSummary, type MeService, type MeetingService, type MergeContactsRequest, type MergeProposalStatus, type Message, type ContentBlock as MessageContentBlock, type MessageDirection, type MessagePreview, type MessageRecipient, type MessageService, type MessageStatus, type MessageTriggerParams, type MistranscribedTerm, type MistranscribedTermService, type MistranscribedTermStatus, type MistranscriptionSuggestionSource, type ModelCallParams, type ModelConfig, type ModelRequestEndPayload, type ModelRequestStartPayload, type ModelUsage, type NeighborDirection, type NeighborEdge, type NeighborNode, type NeighborsOptions, type NodeContentMatches, type NodeDescriptor, type NodeExecution, type NodeGroup, type NodeMethodOption, type NodeNeighborhood, NodeNeighborhoodSchema, type NodeOutline, type NodePosition, type NodeProperty, type NodeRetryPolicy, type NodeRuntime, type NodeService, type NodeStatus, type NodeType, type NodeTypeKey, type NodeTypeService, type NodeTypeStatus, type OnErrorPolicy, type Organization, OrganizationSchema, type OrganizationService, type OutlineHeading, type OutlineRequest, type OutlineResponse, PLATFORM_ENTITIES, PLATFORM_ENTITY_SLUGS, PageIterator, type PairedItem, type ParseStatus, type Permission, type PermissionEventSource, type PermissionEventType, type PlatformBinding, type PlatformEntity, type PlatformEvent, type PortSpec, type Prompt, type PromptService, type PromptVersion, type PropertyOption, type PropertyType, ProteosClient, ProteosError, PublicAccessOperation, type PublishEventRequest, type QueryBinding, type QueryExecuteMeta, type QueryExecuteResponse, type QueryObject, type QueryRow, type QueryService, type QueryValidateMeta, type QueryValidateResponse, type QueryValue, type Reaction, type ReactionCapability, type ReactionOption, type ReactionSetKind, type ReasoningPayload, type RecipientKind, type RecipientRole, type RecordData, type RecordLinkService, type RecordPermissionEventRequest, type RecordService, type RedriveResult, type ResultBlock, type Role, type RoleBasedFilterConfig, type RoleEntityPermission, RoleEntityPermissionSchema, RoleSchema, type RoleService, type Room, type RunWorkflowRequest, type SearchContentRequest, type SearchContentResponse, type SearchNodesRequest, type SendMessageRequest, type SendRecipient, type Session, type SessionEvent, type SessionEventEnvelope, type SessionEventsOptions, type SessionIdlePayload, type SessionService, type SessionStatus, type SessionStreamOptions, type SessionUpdatedPayload, type Skill, type SkillBundle, type SkillService, type SkillVersion, type StartMcpOAuthResponse, type StopReason, StorageClient, type StorageFile, type StorageFileVersion, type SyncConnectionRequest, type SystemSource, type TailOptions, type TestNodeCandidate, type TestNodeInputSource, type TestNodeRequest, type TestNodeResponse, type TextBlock, type Tool, type ToolBinding, type ToolConfirmationPayload, type ToolKind, type ToolResultPayload, type ToolService, type ToolUsePayload, type Toolset, type ToolsetKind, type ToolsetService, type ToolsetToolSummary, type Topic, type TopicKind, type TopicService, type TranscribeStreamOptions, type TranscriptResult, type TranscriptTurn, type Transcription, type TranscriptionReviewStatus, type TranscriptionStatus, type TriggerKind, type Turn, type UnreadCounts, type UpdateAgentListenerRequest, type UpdateAgentRequest, type UpdateConnectionRequest, type UpdateConnectorConnectionRequest, type UpdateContactRequest, type UpdateConversationFilterRequest, type UpdateConversationTypeRequest, type UpdateDraftRequest, type UpdateFileMetadata, type UpdateGlossaryTermRequest, type UpdateLabelRequest, type UpdateLinkRequest, type UpdateMcpServerRequest, type UpdateNodeRequest, type UpdateOrganizationRequest, type UpdatePromptRequest, type UpdateRoleRequest, type UpdateToolRequest, type UpdateToolsetRequest, type UpdateUserRequest, type UpdateWorkflowRequest, type User, type UserMessagePayload, UserRef$2 as UserRef, type UserRoleAssignment, UserRoleAssignmentSchema, UserSchema, type UserService, type VoiceService, type VoiceTranscriptionStream, type WebhookTriggerParams, type Workflow, WorkflowClient, type WorkflowConnection, type WorkflowExecution, type WorkflowGraph, type WorkflowNode, type WorkflowNodeType, type WorkflowStatus, type WorkflowVersion, type WorkflowVersionAuthor, type WorkflowVersionSummary, type WriteContentResponse, type WriteCredentialsRequest, buildUrl, getDefaultErrorCode, isBadRequest, isConflict, isForbidden, isNotFound, isPlatformEntity, isProteosError, isUnauthorized, parseErrorResponse, toQueryParams, toQueryString };
6474
+ export { type AcceptMistranscribedTermRequest, AccountClient, type Action, type ActionBinding, ActionSchema, type ActionScope, ActionScopeSchema, type ActionService, type AddressFilterConfig, type Agent, type AgentActionParams, type AgentArtifactsPayload, AgentClient, type AgentListener, type AgentListenerAcknowledgementConfig, type AgentListenerAcknowledgementType, type AgentListenerActingUserMode, type AgentListenerService, type AgentListenerTriggerType, type AgentMessagePayload, type AgentResourceListOptions, type AgentService, type AllFilterConfig, type ApiErrorResponse, type AppendEventRequest, type AssignPermissionRequest, type AssignRoleRequest, type AttachContactAddressRequest, type Attachment, Attribute, AuditFields, type AuthListOptions, type AutomatedFilterConfig, type AutomatedSignal, type BatchTransactionError, BatchTransactionErrorSchema, type BatchTransactionStatus, type BatchUpsertRecordsResponse, BatchUpsertRecordsResponseSchema, type BatchUpsertTransaction, type BatchUpsertTransactionResult, BatchUpsertTransactionResultSchema, BatchUpsertTransactionSchema, type BinaryRef, type BlockContactRequest, type Channel, type ClientEventType, type ClientToolSchema, type Connection, type ConnectionCredentials, type ConnectionEndpoint, type ConnectionScope, type ConnectionService, type ConnectionStatus, type ConnectionSyncRange, type ConnectionSyncStatus, type Connector, ConnectorClient, type ConnectorConnection, type ConnectionScope$1 as ConnectorConnectionScope, type ConnectionStatus$1 as ConnectorConnectionStatus, type ConnectionTokenResponse as ConnectorConnectionTokenResponse, type CredentialKind as ConnectorCredentialKind, type ConnectorKey, type ConnectorMethod, type ConnectorProvider, type ConsentStatus, type ConsumerGroup, type Contact, type ContactAddress, type ContactAddressKind, type ContactAddressSource, type ContactErasureRequest, type ContactGroup, type ContactGroupService, type ContactGroupSource, type ContactMergeProposal, type ContactRef, type ContactService, type ContactSource, type ContactStatus, type ContentBlock$1 as ContentBlock, type ContentMatch, type ContentResponse, type ContextCompactedPayload, type Conversation, ConversationClient, type ConversationFilter, type ConversationFilterAction, type ConversationFilterConfig, type ConversationFilterEvent, type ConversationFilterService, type ConversationFilterType, type ConversationParticipant, type ConversationService, type ConversationStatus, type ConversationSummaryStatus, type ConversationType, type ConversationTypeConfig, type ConversationTypeService, type CreateAgentListenerRequest, type CreateAgentRequest, type CreateConnectionRequest, type CreateConnectorConnectionRequest, type CreateContactGroupRequest, type CreateConversationFilterRequest, type CreateConversationTypeRequest, type CreateFileMetadata, type CreateGlossaryTermRequest, type CreateLabelRequest, type CreateLinkRequest, type CreateMcpServerRequest, type CreateNodeRequest, type CreateOrganizationRequest, type CreatePromptRequest, type CreateRecordLinkRequest, type CreateRoleRequest, type CreateSessionRequest, type CreateToneProfileSetupRequest, type CreateToolRequest, type CreateToolsetRequest, type CreateUserRequest, type CreateWorkflowRequest, type CredentialSpec, type CronTriggerParams, DEFAULT_PORT, DataClient, type DependentAgent, type DependentSyncResult, type DispatchMeetingBotRequest, type DisplayOptions, type DomainFilterConfig, ERROR_PORT, type EditContentRequest, type EditContentResponse, type EmptyPayload, type ErasureRequestStatus, ErrorCode, type ErrorCodeType, type ErrorPayload, type EventTriggerParams, type EventType, type EventVerb, EventsClient, type ExecutionError, type ExecutionStatus, type ExecutionTriggerContext, type FileBlock, FileRef, type FileService, type FileVersionContent, type FilterMatchOn, FunctionsClient, type GetExecutionDetailResponse, type GetGraphOptions, type GetNodeExecutionItemsOptions, type GetNodeExecutionItemsResponse, type GetNodeTypesResponse, type GlossaryTerm, type GlossaryTermService, type GraphService, type InlineLinkRequest, type InstallConnectionResponse, type InstallConnectorConnectionResponse, type InternalConversationsFilterConfig, type InvokeActionResponse, type InvokeNodeMethodRequest, type InvokeNodeMethodResponse, type Item, type KickoffSource, type KickoffType, KnowledgeClient, type KnowledgeGraph, type KnowledgeGraphLink, type KnowledgeGraphNode, type KnowledgeLabel, KnowledgeLabelSchema, type KnowledgeLink, KnowledgeLinkSchema, type KnowledgeNode, type KnowledgeNodeLabel, KnowledgeNodeLabelSchema, type KnowledgeNodeMetadata, KnowledgeNodeMetadataSchema, KnowledgeNodeSchema, type KnowledgeNodeSearchResult, KnowledgeNodeSearchResultSchema, type KnowledgeRecordLink, KnowledgeRecordLinkSchema, type LabelService, type LinkService, type LinkType, type ListActionsOptions, type ListAgentListenersQuery, type ListAgentsOptions, type ListConnectionsQuery, type ListConnectorConnectionsQuery, type ListConnectorsQuery, type ListContactAddressesQuery, type ListContactGroupsQuery, type ListContactMergeProposalsQuery, type ListContactsQuery, type ListConversationFilterEventsQuery, type ListConversationFiltersQuery, type ListConversationTypesQuery, type ListConversationsQuery, type ListEventsOptions, type ListExecutionsOptions, type ListGlossaryTermsQuery, type ListLabelsOptions, type ListLinksOptions, type ListMcpServersOptions, type ListMessagesQuery, type ListMistranscribedTermsQuery, type ListNodesOptions, ListOptions, type ListOrganizationsOptions, type ListPromptsOptions, type ListRecordLinksOptions, type ListRecordsOptions, type ListResponse, ListResult, type ListRolePermissionsOptions, type ListRolesOptions, type ListRoomsQuery, type ListSessionsOptions, type ListSkillsOptions, type ListToneProfileSetupsQuery, type ListToneProfilesQuery, type ListToolsOptions, type ListToolsetsOptions, type ListUserRoleAssignmentsOptions, type ListUsersOptions, type ListWorkflowsOptions, type ManualTriggerParams, type MatchMode, type McpBinding, type McpConnectionState, type McpConnectionStatus, type McpServer, type McpServerAuth, type McpServerOAuth, type McpServerService, type McpToolSummary, type MeService, type MeetingService, type MergeContactsRequest, type MergeProposalStatus, type Message, type ContentBlock as MessageContentBlock, type MessageDirection, type MessagePreview, type MessageRecipient, type MessageService, type MessageStatus, type MessageTriggerParams, type MistranscribedTerm, type MistranscribedTermService, type MistranscribedTermStatus, type MistranscriptionSuggestionSource, type ModelCallParams, type ModelConfig, type ModelRequestEndPayload, type ModelRequestStartPayload, type ModelUsage, type NeighborDirection, type NeighborEdge, type NeighborNode, type NeighborsOptions, type NodeContentMatches, type NodeDescriptor, type NodeExecution, type NodeGroup, type NodeMethodOption, type NodeNeighborhood, NodeNeighborhoodSchema, type NodeOutline, type NodePosition, type NodeProperty, type NodeRetryPolicy, type NodeRuntime, type NodeService, type NodeStatus, type NodeType, type NodeTypeKey, type NodeTypeService, type NodeTypeStatus, type OnErrorPolicy, type Organization, OrganizationSchema, type OrganizationService, type OutlineHeading, type OutlineRequest, type OutlineResponse, PLATFORM_ENTITIES, PLATFORM_ENTITY_SLUGS, PageIterator, type PairedItem, type ParseStatus, type Permission, type PermissionEventSource, type PermissionEventType, type PlatformBinding, type PlatformEntity, type PlatformEvent, type PortSpec, type Prompt, type PromptService, type PromptVersion, type PropertyOption, type PropertyType, ProteosClient, ProteosError, PublicAccessOperation, type PublishEventRequest, type QueryBinding, type QueryExecuteMeta, type QueryExecuteResponse, type QueryObject, type QueryRow, type QueryService, type QueryValidateMeta, type QueryValidateResponse, type QueryValue, type Reaction, type ReactionCapability, type ReactionOption, type ReactionSetKind, type ReasoningPayload, type RecipientKind, type RecipientRole, type RecordData, type RecordLinkService, type RecordPermissionEventRequest, type RecordService, type RedriveResult, type ResolveToneProfileQuery, type ResultBlock, type Role, type RoleBasedFilterConfig, type RoleEntityPermission, RoleEntityPermissionSchema, RoleSchema, type RoleService, type Room, type RunWorkflowRequest, type SearchContentRequest, type SearchContentResponse, type SearchNodesRequest, type SendMessageRequest, type SendRecipient, type Session, type SessionEvent, type SessionEventEnvelope, type SessionEventsOptions, type SessionIdlePayload, type SessionService, type SessionStatus, type SessionStreamOptions, type SessionUpdatedPayload, type Skill, type SkillBundle, type SkillService, type SkillVersion, type StartMcpOAuthResponse, type StopReason, StorageClient, type StorageFile, type StorageFileVersion, type SyncConnectionRequest, type SystemSource, type TailOptions, type TestNodeCandidate, type TestNodeInputSource, type TestNodeRequest, type TestNodeResponse, type TextBlock, type ToneProfile, type ToneProfileScope, type ToneProfileService, type ToneProfileSetup, type ToneProfileSetupStatus, type Tool, type ToolBinding, type ToolConfirmationPayload, type ToolKind, type ToolResultPayload, type ToolService, type ToolUsePayload, type Toolset, type ToolsetKind, type ToolsetService, type ToolsetToolSummary, type Topic, type TopicKind, type TopicService, type TranscribeStreamOptions, type TranscriptResult, type TranscriptTurn, type Transcription, type TranscriptionReviewStatus, type TranscriptionStatus, type TriggerKind, type Turn, type UnreadCounts, type UpdateAgentListenerRequest, type UpdateAgentRequest, type UpdateConnectionRequest, type UpdateConnectorConnectionRequest, type UpdateContactGroupRequest, type UpdateContactRequest, type UpdateConversationFilterRequest, type UpdateConversationTypeRequest, type UpdateDraftRequest, type UpdateFileMetadata, type UpdateGlossaryTermRequest, type UpdateLabelRequest, type UpdateLinkRequest, type UpdateMcpServerRequest, type UpdateNodeRequest, type UpdateOrganizationRequest, type UpdatePromptRequest, type UpdateRoleRequest, type UpdateToolRequest, type UpdateToolsetRequest, type UpdateUserRequest, type UpdateWorkflowRequest, type User, type UserMessagePayload, UserRef$2 as UserRef, type UserRoleAssignment, UserRoleAssignmentSchema, UserSchema, type UserService, type VoiceService, type VoiceTranscriptionStream, type WebhookTriggerParams, type Workflow, WorkflowClient, type WorkflowConnection, type WorkflowExecution, type WorkflowGraph, type WorkflowNode, type WorkflowNodeType, type WorkflowStatus, type WorkflowVersion, type WorkflowVersionAuthor, type WorkflowVersionSummary, type WriteContentResponse, type WriteCredentialsRequest, buildUrl, getDefaultErrorCode, isBadRequest, isConflict, isForbidden, isNotFound, isPlatformEntity, isProteosError, isUnauthorized, parseErrorResponse, toQueryParams, toQueryString };
package/dist/index.d.ts CHANGED
@@ -2768,6 +2768,118 @@ interface ListConversationTypesQuery extends PaginationQuery {
2768
2768
  search?: string;
2769
2769
  module_slug?: string;
2770
2770
  }
2771
+ /** Who assigned a contact's group membership. */
2772
+ type ContactGroupSource = 'manual' | 'model';
2773
+ /**
2774
+ * A generic org-shared audience taxonomy entry ("external-client",
2775
+ * "internal-colleague", …) — NOT tone-specific. Membership lives on the
2776
+ * contact (`Contact.group_key`, one group per contact) and is assignable by
2777
+ * any flow; tone-of-voice synthesis both reads and auto-assigns groups.
2778
+ * Module-deployable (contact-groups/<key>.json).
2779
+ */
2780
+ interface ContactGroup {
2781
+ org_id: string;
2782
+ /** Immutable identity within the org — what models answer with. */
2783
+ key: string;
2784
+ name: string;
2785
+ /** Who belongs in the group — injected verbatim into the synthesis prompt. */
2786
+ description?: string;
2787
+ /** True when tone synthesis proposed the group. Server-owned. */
2788
+ is_auto_created: boolean;
2789
+ /** Module that deployed the group; absent when not module-owned. */
2790
+ module_slug?: string;
2791
+ created_at: string;
2792
+ created_by: UserRef;
2793
+ updated_at: string;
2794
+ updated_by: UserRef;
2795
+ }
2796
+ interface CreateContactGroupRequest {
2797
+ /** Lowercase kebab/snake/camel handle — no spaces. */
2798
+ key: string;
2799
+ name: string;
2800
+ description?: string;
2801
+ module_slug?: string;
2802
+ }
2803
+ interface UpdateContactGroupRequest {
2804
+ name?: string;
2805
+ description?: string;
2806
+ }
2807
+ interface ListContactGroupsQuery extends PaginationQuery {
2808
+ /** Case-insensitive substring match on key or name. */
2809
+ search?: string;
2810
+ module_slug?: string;
2811
+ }
2812
+ /** The whole-user synthesis lifecycle on a tone profile setup. */
2813
+ type ToneProfileSetupStatus = 'empty' | 'processing' | 'ready';
2814
+ /** A tone profile row's tier — derived, most specific wins at read time. */
2815
+ type ToneProfileScope = 'user' | 'channel' | 'group' | 'contact';
2816
+ /**
2817
+ * The per-user opt-in for tone-of-voice synthesis: only set-up users are
2818
+ * swept. Also carries the whole-user synthesis claim (status/started_at).
2819
+ */
2820
+ interface ToneProfileSetup {
2821
+ id: string;
2822
+ org_id: string;
2823
+ /** The profiled platform user. */
2824
+ owned_by: UserRef;
2825
+ status: ToneProfileSetupStatus;
2826
+ started_at?: string;
2827
+ last_synthesized_at?: string;
2828
+ created_at: string;
2829
+ created_by: UserRef;
2830
+ updated_at: string;
2831
+ updated_by: UserRef;
2832
+ }
2833
+ /**
2834
+ * One generated tone-of-voice instruction row. Rows form a specificity
2835
+ * hierarchy — user aggregate (the constant voice), per-channel base, per
2836
+ * contact-group, per individual contact — and every row is SELF-CONTAINED: a
2837
+ * drafting consumer injects exactly one row's `instructions` verbatim (use
2838
+ * the resolve endpoint), never a concatenation of tiers.
2839
+ */
2840
+ interface ToneProfile {
2841
+ id: string;
2842
+ org_id: string;
2843
+ /** The profiled platform user. */
2844
+ owned_by: UserRef;
2845
+ /** Absent = the cross-channel user aggregate (the voice proper). */
2846
+ channel?: Channel;
2847
+ /** Scopes the row to one contact group; absent = the (user, channel) base. */
2848
+ contact_group_key?: string;
2849
+ /** Scopes the row to one individual contact within the group. */
2850
+ contact_id?: string;
2851
+ scope: ToneProfileScope;
2852
+ /** COMPLETE markdown instruction set, served verbatim to a drafting model. */
2853
+ instructions: string;
2854
+ /** Short delta vs the tier above — what a human scans; empty on root tiers. */
2855
+ differences?: string;
2856
+ sample_count: number;
2857
+ last_message_at?: string;
2858
+ last_synthesized_at?: string;
2859
+ created_at: string;
2860
+ created_by: UserRef;
2861
+ updated_at: string;
2862
+ updated_by: UserRef;
2863
+ }
2864
+ interface CreateToneProfileSetupRequest {
2865
+ /** Bare platform user id; the service resolves the full ref. */
2866
+ owned_by_id: string;
2867
+ }
2868
+ type ListToneProfileSetupsQuery = PaginationQuery;
2869
+ interface ListToneProfilesQuery extends PaginationQuery {
2870
+ owned_by_id?: string;
2871
+ channel?: Channel;
2872
+ scope?: ToneProfileScope;
2873
+ }
2874
+ /**
2875
+ * A drafting context to resolve the single most-specific profile for:
2876
+ * contact → group → channel base → user aggregate.
2877
+ */
2878
+ interface ResolveToneProfileQuery {
2879
+ owned_by_id: string;
2880
+ channel?: Channel;
2881
+ contact_id?: string;
2882
+ }
2771
2883
  interface PaginationQuery {
2772
2884
  page?: number;
2773
2885
  page_size?: number;
@@ -2995,6 +3107,13 @@ interface Contact {
2995
3107
  /** Merge tombstone redirect (set when status is 'merged'). */
2996
3108
  merged_into_contact_id?: string;
2997
3109
  source: ContactSource;
3110
+ /** ContactGroup membership (one group per contact); absent = unassigned. */
3111
+ group_key?: string;
3112
+ /**
3113
+ * Who assigned the group: 'manual' assignments are authoritative (tone
3114
+ * synthesis never overrides them), 'model' ones may be reassigned by a run.
3115
+ */
3116
+ group_source?: ContactGroupSource;
2998
3117
  has_manual_edits: boolean;
2999
3118
  /** The contact's reachable endpoints, embedded on reads. */
3000
3119
  addresses?: ContactAddress[];
@@ -3087,11 +3206,18 @@ interface ListContactsQuery extends PaginationQuery {
3087
3206
  /** Free-text needle matched against contact name + address values. */
3088
3207
  q?: string;
3089
3208
  status?: ContactStatus;
3209
+ /** Members of one contact group (drives group-member lists). */
3210
+ group_key?: string;
3090
3211
  }
3091
3212
  interface UpdateContactRequest {
3092
3213
  name?: string;
3093
3214
  status?: 'active' | 'archived';
3094
3215
  has_legal_hold?: boolean;
3216
+ /**
3217
+ * Assigns the contact to a contact group ('' clears). A PATCH assignment is
3218
+ * stamped group_source='manual' — tone synthesis never overrides it.
3219
+ */
3220
+ group_key?: string;
3095
3221
  }
3096
3222
  interface AttachContactAddressRequest {
3097
3223
  kind: ContactAddressKind;
@@ -3365,6 +3491,10 @@ declare class ConversationClient {
3365
3491
  readonly glossaryTerms: GlossaryTermService;
3366
3492
  /** Conversation taxonomy: the types the pre-summary classifier assigns. */
3367
3493
  readonly conversationTypes: ConversationTypeService;
3494
+ /** Generic audience taxonomy; membership lives on the contact. */
3495
+ readonly contactGroups: ContactGroupService;
3496
+ /** Tone-of-voice synthesis: per-user setups + the generated profiles. */
3497
+ readonly toneProfiles: ToneProfileService;
3368
3498
  readonly transcriptions: TranscriptionService;
3369
3499
  /** Review-pass findings: likely misheard terms awaiting accept/reject. */
3370
3500
  readonly mistranscribedTerms: MistranscribedTermService;
@@ -3548,6 +3678,43 @@ interface ConversationTypeService {
3548
3678
  upsert(key: string, request: CreateConversationTypeRequest): Promise<ConversationType>;
3549
3679
  delete(key: string): Promise<void>;
3550
3680
  }
3681
+ /**
3682
+ * Contact groups: the generic org-shared audience taxonomy. Membership lives
3683
+ * on the contact (`Contact.group_key`, one group per contact — assign via
3684
+ * `contacts.update`); tone-of-voice synthesis reads the groups and
3685
+ * auto-assigns ungrouped correspondents. Keyed by `key` (not id); `upsert` is
3686
+ * the idempotent module-deploy door. Deleting a group clears its members'
3687
+ * membership and purges its tone profile rows.
3688
+ */
3689
+ interface ContactGroupService {
3690
+ list(query?: ListContactGroupsQuery): Promise<ListResponse<ContactGroup>>;
3691
+ get(key: string): Promise<ContactGroup>;
3692
+ create(request: CreateContactGroupRequest): Promise<ContactGroup>;
3693
+ update(key: string, request: UpdateContactGroupRequest): Promise<ContactGroup>;
3694
+ /** Idempotent create-or-update by key (PUT) — what `pro module deploy` calls. */
3695
+ upsert(key: string, request: CreateContactGroupRequest): Promise<ContactGroup>;
3696
+ delete(key: string): Promise<void>;
3697
+ }
3698
+ /**
3699
+ * Tone-of-voice synthesis. A setup opts one platform user in (only set-up
3700
+ * users are swept); `synthesize` triggers a whole-user run immediately (202;
3701
+ * 409 `synthesis_in_progress` while one is live). Generated profiles form a
3702
+ * specificity hierarchy — fetch a user's rows with `listProfiles`, or let the
3703
+ * server pick the single most-specific row for a drafting context with
3704
+ * `resolve` (each row is self-contained; never concatenate tiers).
3705
+ */
3706
+ interface ToneProfileService {
3707
+ listSetups(query?: ListToneProfileSetupsQuery): Promise<ListResponse<ToneProfileSetup>>;
3708
+ createSetup(request: CreateToneProfileSetupRequest): Promise<ToneProfileSetup>;
3709
+ /** Removes the setup AND the user's generated profiles. */
3710
+ deleteSetup(id: string): Promise<void>;
3711
+ /** Kicks a whole-user synthesis run off-request (bypasses cadence checks). */
3712
+ synthesize(setupId: string): Promise<void>;
3713
+ listProfiles(query?: ListToneProfilesQuery): Promise<ListResponse<ToneProfile>>;
3714
+ getProfile(id: string): Promise<ToneProfile>;
3715
+ /** The single most-specific profile for a drafting context; 404 when none. */
3716
+ resolve(query: ResolveToneProfileQuery): Promise<ToneProfile>;
3717
+ }
3551
3718
  /** Batch transcription of stored audio files + materialization. */
3552
3719
  interface TranscriptionService {
3553
3720
  /**
@@ -6304,4 +6471,4 @@ declare class WorkflowClient {
6304
6471
  constructor(client: ProteosClient);
6305
6472
  }
6306
6473
 
6307
- export { type AcceptMistranscribedTermRequest, AccountClient, type Action, type ActionBinding, ActionSchema, type ActionScope, ActionScopeSchema, type ActionService, type AddressFilterConfig, type Agent, type AgentActionParams, type AgentArtifactsPayload, AgentClient, type AgentListener, type AgentListenerAcknowledgementConfig, type AgentListenerAcknowledgementType, type AgentListenerActingUserMode, type AgentListenerService, type AgentListenerTriggerType, type AgentMessagePayload, type AgentResourceListOptions, type AgentService, type AllFilterConfig, type ApiErrorResponse, type AppendEventRequest, type AssignPermissionRequest, type AssignRoleRequest, type AttachContactAddressRequest, type Attachment, Attribute, AuditFields, type AuthListOptions, type AutomatedFilterConfig, type AutomatedSignal, type BatchTransactionError, BatchTransactionErrorSchema, type BatchTransactionStatus, type BatchUpsertRecordsResponse, BatchUpsertRecordsResponseSchema, type BatchUpsertTransaction, type BatchUpsertTransactionResult, BatchUpsertTransactionResultSchema, BatchUpsertTransactionSchema, type BinaryRef, type BlockContactRequest, type Channel, type ClientEventType, type ClientToolSchema, type Connection, type ConnectionCredentials, type ConnectionEndpoint, type ConnectionScope, type ConnectionService, type ConnectionStatus, type ConnectionSyncRange, type ConnectionSyncStatus, type Connector, ConnectorClient, type ConnectorConnection, type ConnectionScope$1 as ConnectorConnectionScope, type ConnectionStatus$1 as ConnectorConnectionStatus, type ConnectionTokenResponse as ConnectorConnectionTokenResponse, type CredentialKind as ConnectorCredentialKind, type ConnectorKey, type ConnectorMethod, type ConnectorProvider, type ConsentStatus, type ConsumerGroup, type Contact, type ContactAddress, type ContactAddressKind, type ContactAddressSource, type ContactErasureRequest, type ContactMergeProposal, type ContactRef, type ContactService, type ContactSource, type ContactStatus, type ContentBlock$1 as ContentBlock, type ContentMatch, type ContentResponse, type ContextCompactedPayload, type Conversation, ConversationClient, type ConversationFilter, type ConversationFilterAction, type ConversationFilterConfig, type ConversationFilterEvent, type ConversationFilterService, type ConversationFilterType, type ConversationParticipant, type ConversationService, type ConversationStatus, type ConversationSummaryStatus, type ConversationType, type ConversationTypeConfig, type ConversationTypeService, type CreateAgentListenerRequest, type CreateAgentRequest, type CreateConnectionRequest, type CreateConnectorConnectionRequest, type CreateConversationFilterRequest, type CreateConversationTypeRequest, type CreateFileMetadata, type CreateGlossaryTermRequest, type CreateLabelRequest, type CreateLinkRequest, type CreateMcpServerRequest, type CreateNodeRequest, type CreateOrganizationRequest, type CreatePromptRequest, type CreateRecordLinkRequest, type CreateRoleRequest, type CreateSessionRequest, type CreateToolRequest, type CreateToolsetRequest, type CreateUserRequest, type CreateWorkflowRequest, type CredentialSpec, type CronTriggerParams, DEFAULT_PORT, DataClient, type DependentAgent, type DependentSyncResult, type DispatchMeetingBotRequest, type DisplayOptions, type DomainFilterConfig, ERROR_PORT, type EditContentRequest, type EditContentResponse, type EmptyPayload, type ErasureRequestStatus, ErrorCode, type ErrorCodeType, type ErrorPayload, type EventTriggerParams, type EventType, type EventVerb, EventsClient, type ExecutionError, type ExecutionStatus, type ExecutionTriggerContext, type FileBlock, FileRef, type FileService, type FileVersionContent, type FilterMatchOn, FunctionsClient, type GetExecutionDetailResponse, type GetGraphOptions, type GetNodeExecutionItemsOptions, type GetNodeExecutionItemsResponse, type GetNodeTypesResponse, type GlossaryTerm, type GlossaryTermService, type GraphService, type InlineLinkRequest, type InstallConnectionResponse, type InstallConnectorConnectionResponse, type InternalConversationsFilterConfig, type InvokeActionResponse, type InvokeNodeMethodRequest, type InvokeNodeMethodResponse, type Item, type KickoffSource, type KickoffType, KnowledgeClient, type KnowledgeGraph, type KnowledgeGraphLink, type KnowledgeGraphNode, type KnowledgeLabel, KnowledgeLabelSchema, type KnowledgeLink, KnowledgeLinkSchema, type KnowledgeNode, type KnowledgeNodeLabel, KnowledgeNodeLabelSchema, type KnowledgeNodeMetadata, KnowledgeNodeMetadataSchema, KnowledgeNodeSchema, type KnowledgeNodeSearchResult, KnowledgeNodeSearchResultSchema, type KnowledgeRecordLink, KnowledgeRecordLinkSchema, type LabelService, type LinkService, type LinkType, type ListActionsOptions, type ListAgentListenersQuery, type ListAgentsOptions, type ListConnectionsQuery, type ListConnectorConnectionsQuery, type ListConnectorsQuery, type ListContactAddressesQuery, type ListContactMergeProposalsQuery, type ListContactsQuery, type ListConversationFilterEventsQuery, type ListConversationFiltersQuery, type ListConversationTypesQuery, type ListConversationsQuery, type ListEventsOptions, type ListExecutionsOptions, type ListGlossaryTermsQuery, type ListLabelsOptions, type ListLinksOptions, type ListMcpServersOptions, type ListMessagesQuery, type ListMistranscribedTermsQuery, type ListNodesOptions, ListOptions, type ListOrganizationsOptions, type ListPromptsOptions, type ListRecordLinksOptions, type ListRecordsOptions, type ListResponse, ListResult, type ListRolePermissionsOptions, type ListRolesOptions, type ListRoomsQuery, type ListSessionsOptions, type ListSkillsOptions, type ListToolsOptions, type ListToolsetsOptions, type ListUserRoleAssignmentsOptions, type ListUsersOptions, type ListWorkflowsOptions, type ManualTriggerParams, type MatchMode, type McpBinding, type McpConnectionState, type McpConnectionStatus, type McpServer, type McpServerAuth, type McpServerOAuth, type McpServerService, type McpToolSummary, type MeService, type MeetingService, type MergeContactsRequest, type MergeProposalStatus, type Message, type ContentBlock as MessageContentBlock, type MessageDirection, type MessagePreview, type MessageRecipient, type MessageService, type MessageStatus, type MessageTriggerParams, type MistranscribedTerm, type MistranscribedTermService, type MistranscribedTermStatus, type MistranscriptionSuggestionSource, type ModelCallParams, type ModelConfig, type ModelRequestEndPayload, type ModelRequestStartPayload, type ModelUsage, type NeighborDirection, type NeighborEdge, type NeighborNode, type NeighborsOptions, type NodeContentMatches, type NodeDescriptor, type NodeExecution, type NodeGroup, type NodeMethodOption, type NodeNeighborhood, NodeNeighborhoodSchema, type NodeOutline, type NodePosition, type NodeProperty, type NodeRetryPolicy, type NodeRuntime, type NodeService, type NodeStatus, type NodeType, type NodeTypeKey, type NodeTypeService, type NodeTypeStatus, type OnErrorPolicy, type Organization, OrganizationSchema, type OrganizationService, type OutlineHeading, type OutlineRequest, type OutlineResponse, PLATFORM_ENTITIES, PLATFORM_ENTITY_SLUGS, PageIterator, type PairedItem, type ParseStatus, type Permission, type PermissionEventSource, type PermissionEventType, type PlatformBinding, type PlatformEntity, type PlatformEvent, type PortSpec, type Prompt, type PromptService, type PromptVersion, type PropertyOption, type PropertyType, ProteosClient, ProteosError, PublicAccessOperation, type PublishEventRequest, type QueryBinding, type QueryExecuteMeta, type QueryExecuteResponse, type QueryObject, type QueryRow, type QueryService, type QueryValidateMeta, type QueryValidateResponse, type QueryValue, type Reaction, type ReactionCapability, type ReactionOption, type ReactionSetKind, type ReasoningPayload, type RecipientKind, type RecipientRole, type RecordData, type RecordLinkService, type RecordPermissionEventRequest, type RecordService, type RedriveResult, type ResultBlock, type Role, type RoleBasedFilterConfig, type RoleEntityPermission, RoleEntityPermissionSchema, RoleSchema, type RoleService, type Room, type RunWorkflowRequest, type SearchContentRequest, type SearchContentResponse, type SearchNodesRequest, type SendMessageRequest, type SendRecipient, type Session, type SessionEvent, type SessionEventEnvelope, type SessionEventsOptions, type SessionIdlePayload, type SessionService, type SessionStatus, type SessionStreamOptions, type SessionUpdatedPayload, type Skill, type SkillBundle, type SkillService, type SkillVersion, type StartMcpOAuthResponse, type StopReason, StorageClient, type StorageFile, type StorageFileVersion, type SyncConnectionRequest, type SystemSource, type TailOptions, type TestNodeCandidate, type TestNodeInputSource, type TestNodeRequest, type TestNodeResponse, type TextBlock, type Tool, type ToolBinding, type ToolConfirmationPayload, type ToolKind, type ToolResultPayload, type ToolService, type ToolUsePayload, type Toolset, type ToolsetKind, type ToolsetService, type ToolsetToolSummary, type Topic, type TopicKind, type TopicService, type TranscribeStreamOptions, type TranscriptResult, type TranscriptTurn, type Transcription, type TranscriptionReviewStatus, type TranscriptionStatus, type TriggerKind, type Turn, type UnreadCounts, type UpdateAgentListenerRequest, type UpdateAgentRequest, type UpdateConnectionRequest, type UpdateConnectorConnectionRequest, type UpdateContactRequest, type UpdateConversationFilterRequest, type UpdateConversationTypeRequest, type UpdateDraftRequest, type UpdateFileMetadata, type UpdateGlossaryTermRequest, type UpdateLabelRequest, type UpdateLinkRequest, type UpdateMcpServerRequest, type UpdateNodeRequest, type UpdateOrganizationRequest, type UpdatePromptRequest, type UpdateRoleRequest, type UpdateToolRequest, type UpdateToolsetRequest, type UpdateUserRequest, type UpdateWorkflowRequest, type User, type UserMessagePayload, UserRef$2 as UserRef, type UserRoleAssignment, UserRoleAssignmentSchema, UserSchema, type UserService, type VoiceService, type VoiceTranscriptionStream, type WebhookTriggerParams, type Workflow, WorkflowClient, type WorkflowConnection, type WorkflowExecution, type WorkflowGraph, type WorkflowNode, type WorkflowNodeType, type WorkflowStatus, type WorkflowVersion, type WorkflowVersionAuthor, type WorkflowVersionSummary, type WriteContentResponse, type WriteCredentialsRequest, buildUrl, getDefaultErrorCode, isBadRequest, isConflict, isForbidden, isNotFound, isPlatformEntity, isProteosError, isUnauthorized, parseErrorResponse, toQueryParams, toQueryString };
6474
+ export { type AcceptMistranscribedTermRequest, AccountClient, type Action, type ActionBinding, ActionSchema, type ActionScope, ActionScopeSchema, type ActionService, type AddressFilterConfig, type Agent, type AgentActionParams, type AgentArtifactsPayload, AgentClient, type AgentListener, type AgentListenerAcknowledgementConfig, type AgentListenerAcknowledgementType, type AgentListenerActingUserMode, type AgentListenerService, type AgentListenerTriggerType, type AgentMessagePayload, type AgentResourceListOptions, type AgentService, type AllFilterConfig, type ApiErrorResponse, type AppendEventRequest, type AssignPermissionRequest, type AssignRoleRequest, type AttachContactAddressRequest, type Attachment, Attribute, AuditFields, type AuthListOptions, type AutomatedFilterConfig, type AutomatedSignal, type BatchTransactionError, BatchTransactionErrorSchema, type BatchTransactionStatus, type BatchUpsertRecordsResponse, BatchUpsertRecordsResponseSchema, type BatchUpsertTransaction, type BatchUpsertTransactionResult, BatchUpsertTransactionResultSchema, BatchUpsertTransactionSchema, type BinaryRef, type BlockContactRequest, type Channel, type ClientEventType, type ClientToolSchema, type Connection, type ConnectionCredentials, type ConnectionEndpoint, type ConnectionScope, type ConnectionService, type ConnectionStatus, type ConnectionSyncRange, type ConnectionSyncStatus, type Connector, ConnectorClient, type ConnectorConnection, type ConnectionScope$1 as ConnectorConnectionScope, type ConnectionStatus$1 as ConnectorConnectionStatus, type ConnectionTokenResponse as ConnectorConnectionTokenResponse, type CredentialKind as ConnectorCredentialKind, type ConnectorKey, type ConnectorMethod, type ConnectorProvider, type ConsentStatus, type ConsumerGroup, type Contact, type ContactAddress, type ContactAddressKind, type ContactAddressSource, type ContactErasureRequest, type ContactGroup, type ContactGroupService, type ContactGroupSource, type ContactMergeProposal, type ContactRef, type ContactService, type ContactSource, type ContactStatus, type ContentBlock$1 as ContentBlock, type ContentMatch, type ContentResponse, type ContextCompactedPayload, type Conversation, ConversationClient, type ConversationFilter, type ConversationFilterAction, type ConversationFilterConfig, type ConversationFilterEvent, type ConversationFilterService, type ConversationFilterType, type ConversationParticipant, type ConversationService, type ConversationStatus, type ConversationSummaryStatus, type ConversationType, type ConversationTypeConfig, type ConversationTypeService, type CreateAgentListenerRequest, type CreateAgentRequest, type CreateConnectionRequest, type CreateConnectorConnectionRequest, type CreateContactGroupRequest, type CreateConversationFilterRequest, type CreateConversationTypeRequest, type CreateFileMetadata, type CreateGlossaryTermRequest, type CreateLabelRequest, type CreateLinkRequest, type CreateMcpServerRequest, type CreateNodeRequest, type CreateOrganizationRequest, type CreatePromptRequest, type CreateRecordLinkRequest, type CreateRoleRequest, type CreateSessionRequest, type CreateToneProfileSetupRequest, type CreateToolRequest, type CreateToolsetRequest, type CreateUserRequest, type CreateWorkflowRequest, type CredentialSpec, type CronTriggerParams, DEFAULT_PORT, DataClient, type DependentAgent, type DependentSyncResult, type DispatchMeetingBotRequest, type DisplayOptions, type DomainFilterConfig, ERROR_PORT, type EditContentRequest, type EditContentResponse, type EmptyPayload, type ErasureRequestStatus, ErrorCode, type ErrorCodeType, type ErrorPayload, type EventTriggerParams, type EventType, type EventVerb, EventsClient, type ExecutionError, type ExecutionStatus, type ExecutionTriggerContext, type FileBlock, FileRef, type FileService, type FileVersionContent, type FilterMatchOn, FunctionsClient, type GetExecutionDetailResponse, type GetGraphOptions, type GetNodeExecutionItemsOptions, type GetNodeExecutionItemsResponse, type GetNodeTypesResponse, type GlossaryTerm, type GlossaryTermService, type GraphService, type InlineLinkRequest, type InstallConnectionResponse, type InstallConnectorConnectionResponse, type InternalConversationsFilterConfig, type InvokeActionResponse, type InvokeNodeMethodRequest, type InvokeNodeMethodResponse, type Item, type KickoffSource, type KickoffType, KnowledgeClient, type KnowledgeGraph, type KnowledgeGraphLink, type KnowledgeGraphNode, type KnowledgeLabel, KnowledgeLabelSchema, type KnowledgeLink, KnowledgeLinkSchema, type KnowledgeNode, type KnowledgeNodeLabel, KnowledgeNodeLabelSchema, type KnowledgeNodeMetadata, KnowledgeNodeMetadataSchema, KnowledgeNodeSchema, type KnowledgeNodeSearchResult, KnowledgeNodeSearchResultSchema, type KnowledgeRecordLink, KnowledgeRecordLinkSchema, type LabelService, type LinkService, type LinkType, type ListActionsOptions, type ListAgentListenersQuery, type ListAgentsOptions, type ListConnectionsQuery, type ListConnectorConnectionsQuery, type ListConnectorsQuery, type ListContactAddressesQuery, type ListContactGroupsQuery, type ListContactMergeProposalsQuery, type ListContactsQuery, type ListConversationFilterEventsQuery, type ListConversationFiltersQuery, type ListConversationTypesQuery, type ListConversationsQuery, type ListEventsOptions, type ListExecutionsOptions, type ListGlossaryTermsQuery, type ListLabelsOptions, type ListLinksOptions, type ListMcpServersOptions, type ListMessagesQuery, type ListMistranscribedTermsQuery, type ListNodesOptions, ListOptions, type ListOrganizationsOptions, type ListPromptsOptions, type ListRecordLinksOptions, type ListRecordsOptions, type ListResponse, ListResult, type ListRolePermissionsOptions, type ListRolesOptions, type ListRoomsQuery, type ListSessionsOptions, type ListSkillsOptions, type ListToneProfileSetupsQuery, type ListToneProfilesQuery, type ListToolsOptions, type ListToolsetsOptions, type ListUserRoleAssignmentsOptions, type ListUsersOptions, type ListWorkflowsOptions, type ManualTriggerParams, type MatchMode, type McpBinding, type McpConnectionState, type McpConnectionStatus, type McpServer, type McpServerAuth, type McpServerOAuth, type McpServerService, type McpToolSummary, type MeService, type MeetingService, type MergeContactsRequest, type MergeProposalStatus, type Message, type ContentBlock as MessageContentBlock, type MessageDirection, type MessagePreview, type MessageRecipient, type MessageService, type MessageStatus, type MessageTriggerParams, type MistranscribedTerm, type MistranscribedTermService, type MistranscribedTermStatus, type MistranscriptionSuggestionSource, type ModelCallParams, type ModelConfig, type ModelRequestEndPayload, type ModelRequestStartPayload, type ModelUsage, type NeighborDirection, type NeighborEdge, type NeighborNode, type NeighborsOptions, type NodeContentMatches, type NodeDescriptor, type NodeExecution, type NodeGroup, type NodeMethodOption, type NodeNeighborhood, NodeNeighborhoodSchema, type NodeOutline, type NodePosition, type NodeProperty, type NodeRetryPolicy, type NodeRuntime, type NodeService, type NodeStatus, type NodeType, type NodeTypeKey, type NodeTypeService, type NodeTypeStatus, type OnErrorPolicy, type Organization, OrganizationSchema, type OrganizationService, type OutlineHeading, type OutlineRequest, type OutlineResponse, PLATFORM_ENTITIES, PLATFORM_ENTITY_SLUGS, PageIterator, type PairedItem, type ParseStatus, type Permission, type PermissionEventSource, type PermissionEventType, type PlatformBinding, type PlatformEntity, type PlatformEvent, type PortSpec, type Prompt, type PromptService, type PromptVersion, type PropertyOption, type PropertyType, ProteosClient, ProteosError, PublicAccessOperation, type PublishEventRequest, type QueryBinding, type QueryExecuteMeta, type QueryExecuteResponse, type QueryObject, type QueryRow, type QueryService, type QueryValidateMeta, type QueryValidateResponse, type QueryValue, type Reaction, type ReactionCapability, type ReactionOption, type ReactionSetKind, type ReasoningPayload, type RecipientKind, type RecipientRole, type RecordData, type RecordLinkService, type RecordPermissionEventRequest, type RecordService, type RedriveResult, type ResolveToneProfileQuery, type ResultBlock, type Role, type RoleBasedFilterConfig, type RoleEntityPermission, RoleEntityPermissionSchema, RoleSchema, type RoleService, type Room, type RunWorkflowRequest, type SearchContentRequest, type SearchContentResponse, type SearchNodesRequest, type SendMessageRequest, type SendRecipient, type Session, type SessionEvent, type SessionEventEnvelope, type SessionEventsOptions, type SessionIdlePayload, type SessionService, type SessionStatus, type SessionStreamOptions, type SessionUpdatedPayload, type Skill, type SkillBundle, type SkillService, type SkillVersion, type StartMcpOAuthResponse, type StopReason, StorageClient, type StorageFile, type StorageFileVersion, type SyncConnectionRequest, type SystemSource, type TailOptions, type TestNodeCandidate, type TestNodeInputSource, type TestNodeRequest, type TestNodeResponse, type TextBlock, type ToneProfile, type ToneProfileScope, type ToneProfileService, type ToneProfileSetup, type ToneProfileSetupStatus, type Tool, type ToolBinding, type ToolConfirmationPayload, type ToolKind, type ToolResultPayload, type ToolService, type ToolUsePayload, type Toolset, type ToolsetKind, type ToolsetService, type ToolsetToolSummary, type Topic, type TopicKind, type TopicService, type TranscribeStreamOptions, type TranscriptResult, type TranscriptTurn, type Transcription, type TranscriptionReviewStatus, type TranscriptionStatus, type TriggerKind, type Turn, type UnreadCounts, type UpdateAgentListenerRequest, type UpdateAgentRequest, type UpdateConnectionRequest, type UpdateConnectorConnectionRequest, type UpdateContactGroupRequest, type UpdateContactRequest, type UpdateConversationFilterRequest, type UpdateConversationTypeRequest, type UpdateDraftRequest, type UpdateFileMetadata, type UpdateGlossaryTermRequest, type UpdateLabelRequest, type UpdateLinkRequest, type UpdateMcpServerRequest, type UpdateNodeRequest, type UpdateOrganizationRequest, type UpdatePromptRequest, type UpdateRoleRequest, type UpdateToolRequest, type UpdateToolsetRequest, type UpdateUserRequest, type UpdateWorkflowRequest, type User, type UserMessagePayload, UserRef$2 as UserRef, type UserRoleAssignment, UserRoleAssignmentSchema, UserSchema, type UserService, type VoiceService, type VoiceTranscriptionStream, type WebhookTriggerParams, type Workflow, WorkflowClient, type WorkflowConnection, type WorkflowExecution, type WorkflowGraph, type WorkflowNode, type WorkflowNodeType, type WorkflowStatus, type WorkflowVersion, type WorkflowVersionAuthor, type WorkflowVersionSummary, type WriteContentResponse, type WriteCredentialsRequest, buildUrl, getDefaultErrorCode, isBadRequest, isConflict, isForbidden, isNotFound, isPlatformEntity, isProteosError, isUnauthorized, parseErrorResponse, toQueryParams, toQueryString };
package/dist/index.js CHANGED
@@ -1314,6 +1314,10 @@ var ConversationClient = class {
1314
1314
  glossaryTerms;
1315
1315
  /** Conversation taxonomy: the types the pre-summary classifier assigns. */
1316
1316
  conversationTypes;
1317
+ /** Generic audience taxonomy; membership lives on the contact. */
1318
+ contactGroups;
1319
+ /** Tone-of-voice synthesis: per-user setups + the generated profiles. */
1320
+ toneProfiles;
1317
1321
  transcriptions;
1318
1322
  /** Review-pass findings: likely misheard terms awaiting accept/reject. */
1319
1323
  mistranscribedTerms;
@@ -1330,6 +1334,8 @@ var ConversationClient = class {
1330
1334
  this.conversationFilters = new ConversationFilterServiceImpl(client);
1331
1335
  this.glossaryTerms = new GlossaryTermServiceImpl(client);
1332
1336
  this.conversationTypes = new ConversationTypeServiceImpl(client);
1337
+ this.contactGroups = new ContactGroupServiceImpl(client);
1338
+ this.toneProfiles = new ToneProfileServiceImpl(client);
1333
1339
  this.transcriptions = new TranscriptionServiceImpl(client);
1334
1340
  this.mistranscribedTerms = new MistranscribedTermServiceImpl(client);
1335
1341
  this.meetings = new MeetingServiceImpl(client);
@@ -1771,6 +1777,88 @@ var ConversationTypeServiceImpl = class {
1771
1777
  );
1772
1778
  }
1773
1779
  };
1780
+ var ContactGroupServiceImpl = class {
1781
+ constructor(client) {
1782
+ this.client = client;
1783
+ }
1784
+ client;
1785
+ list(query = {}) {
1786
+ return this.client.requestWithQuery("GET", `${CONVERSATION_BASE_PATH}/contact-groups`, query);
1787
+ }
1788
+ get(key) {
1789
+ return this.client.request(
1790
+ "GET",
1791
+ `${CONVERSATION_BASE_PATH}/contact-groups/${encodeURIComponent(key)}`
1792
+ );
1793
+ }
1794
+ create(request) {
1795
+ return this.client.request("POST", `${CONVERSATION_BASE_PATH}/contact-groups`, request);
1796
+ }
1797
+ update(key, request) {
1798
+ return this.client.request(
1799
+ "PATCH",
1800
+ `${CONVERSATION_BASE_PATH}/contact-groups/${encodeURIComponent(key)}`,
1801
+ request
1802
+ );
1803
+ }
1804
+ upsert(key, request) {
1805
+ return this.client.request(
1806
+ "PUT",
1807
+ `${CONVERSATION_BASE_PATH}/contact-groups/${encodeURIComponent(key)}`,
1808
+ { ...request, key }
1809
+ );
1810
+ }
1811
+ async delete(key) {
1812
+ await this.client.request(
1813
+ "DELETE",
1814
+ `${CONVERSATION_BASE_PATH}/contact-groups/${encodeURIComponent(key)}`
1815
+ );
1816
+ }
1817
+ };
1818
+ var ToneProfileServiceImpl = class {
1819
+ constructor(client) {
1820
+ this.client = client;
1821
+ }
1822
+ client;
1823
+ listSetups(query = {}) {
1824
+ return this.client.requestWithQuery(
1825
+ "GET",
1826
+ `${CONVERSATION_BASE_PATH}/tone-profile-setups`,
1827
+ query
1828
+ );
1829
+ }
1830
+ createSetup(request) {
1831
+ return this.client.request("POST", `${CONVERSATION_BASE_PATH}/tone-profile-setups`, request);
1832
+ }
1833
+ async deleteSetup(id) {
1834
+ await this.client.request(
1835
+ "DELETE",
1836
+ `${CONVERSATION_BASE_PATH}/tone-profile-setups/${encodeURIComponent(id)}`
1837
+ );
1838
+ }
1839
+ async synthesize(setupId) {
1840
+ await this.client.request(
1841
+ "POST",
1842
+ `${CONVERSATION_BASE_PATH}/tone-profile-setups/${encodeURIComponent(setupId)}/synthesize`
1843
+ );
1844
+ }
1845
+ listProfiles(query = {}) {
1846
+ return this.client.requestWithQuery("GET", `${CONVERSATION_BASE_PATH}/tone-profiles`, query);
1847
+ }
1848
+ getProfile(id) {
1849
+ return this.client.request(
1850
+ "GET",
1851
+ `${CONVERSATION_BASE_PATH}/tone-profiles/${encodeURIComponent(id)}`
1852
+ );
1853
+ }
1854
+ resolve(query) {
1855
+ return this.client.requestWithQuery(
1856
+ "GET",
1857
+ `${CONVERSATION_BASE_PATH}/tone-profiles/resolve`,
1858
+ query
1859
+ );
1860
+ }
1861
+ };
1774
1862
  var TranscriptionServiceImpl = class {
1775
1863
  constructor(client) {
1776
1864
  this.client = client;