@proteos/sdk 0.39.0 → 0.41.0

package/dist/index.d.ts

@@ -182,8 +182,10 @@ type ListSkillsOptions = AgentResourceListOptions;
  * - `client` is a host-provided builtin and carries no binding.
  * - `platform` binds to one tool of the platform MCP server (mcp-service),
  *   executed server-side as the acting user.
+ * - `query` stores a SQL query with declared params, executed server-side
+ *   against data-service as the acting user.
  */
-type ToolKind = 'action' | 'mcp' | 'client' | 'platform';
+type ToolKind = 'action' | 'mcp' | 'client' | 'platform' | 'query';
 /** Binds to a function-service Action by its key (kind=action). */
 interface ActionBinding {
     action_key: string;
@@ -201,8 +203,18 @@ interface PlatformBinding {
     toolset: string;
     tool_name: string;
 }
+/**
+ * Stores a SELECT-only SQL query (data-service dialect) whose `{{param}}`
+ * placeholders are filled from the declared `params` at execution time
+ * (kind=query). Params are scalar attribute definitions (string, number,
+ * integer, boolean, datetime, enum); they generate the tool's input schema.
+ */
+interface QueryBinding {
+    sql: string;
+    params?: Attribute[];
+}
 /** Kind-discriminated binding payload. `kind=client` carries no binding. */
-type ToolBinding = ActionBinding | McpBinding | PlatformBinding;
+type ToolBinding = ActionBinding | McpBinding | PlatformBinding | QueryBinding;
 /**
  * A thin registry entry over one of three binding sources. `key` is the wire
  * name the model calls (`tool_use.name`) and what `Agent.tools` lists.
@@ -639,8 +651,15 @@ interface StopReason {
     type: string;
 }
 /**
- * Emitted when a turn ends. `event_ids` carries the tool_use event ids awaiting a
- * client response when `stop_reason.type` is `user_action_required`.
+ * Ends a turn — published once per turn by the server, not an echo of the upstream
+ * provider's session status (which flips idle/running once per server-side tool
+ * round, mid-turn).
+ *
+ * `event_ids` is set only with `stop_reason.type: 'user_action_required'`, and lists
+ * the tool_use events still OUTSTANDING — the ones a client must answer. Tools the
+ * server executes itself are resolved before this event exists, so seeing this event
+ * at all means the turn cannot continue without you: answer each id with a
+ * `user.tool_result`.
  */
 interface SessionIdlePayload {
     stop_reason: StopReason;
@@ -2749,6 +2768,118 @@ interface ListConversationTypesQuery extends PaginationQuery {
     search?: string;
     module_slug?: string;
 }
+/** Who assigned a contact's group membership. */
+type ContactGroupSource = 'manual' | 'model';
+/**
+ * A generic org-shared audience taxonomy entry ("external-client",
+ * "internal-colleague", …) — NOT tone-specific. Membership lives on the
+ * contact (`Contact.group_key`, one group per contact) and is assignable by
+ * any flow; tone-of-voice synthesis both reads and auto-assigns groups.
+ * Module-deployable (contact-groups/<key>.json).
+ */
+interface ContactGroup {
+    org_id: string;
+    /** Immutable identity within the org — what models answer with. */
+    key: string;
+    name: string;
+    /** Who belongs in the group — injected verbatim into the synthesis prompt. */
+    description?: string;
+    /** True when tone synthesis proposed the group. Server-owned. */
+    is_auto_created: boolean;
+    /** Module that deployed the group; absent when not module-owned. */
+    module_slug?: string;
+    created_at: string;
+    created_by: UserRef;
+    updated_at: string;
+    updated_by: UserRef;
+}
+interface CreateContactGroupRequest {
+    /** Lowercase kebab/snake/camel handle — no spaces. */
+    key: string;
+    name: string;
+    description?: string;
+    module_slug?: string;
+}
+interface UpdateContactGroupRequest {
+    name?: string;
+    description?: string;
+}
+interface ListContactGroupsQuery extends PaginationQuery {
+    /** Case-insensitive substring match on key or name. */
+    search?: string;
+    module_slug?: string;
+}
+/** The whole-user synthesis lifecycle on a tone profile setup. */
+type ToneProfileSetupStatus = 'empty' | 'processing' | 'ready';
+/** A tone profile row's tier — derived, most specific wins at read time. */
+type ToneProfileScope = 'user' | 'channel' | 'group' | 'contact';
+/**
+ * The per-user opt-in for tone-of-voice synthesis: only set-up users are
+ * swept. Also carries the whole-user synthesis claim (status/started_at).
+ */
+interface ToneProfileSetup {
+    id: string;
+    org_id: string;
+    /** The profiled platform user. */
+    owned_by: UserRef;
+    status: ToneProfileSetupStatus;
+    started_at?: string;
+    last_synthesized_at?: string;
+    created_at: string;
+    created_by: UserRef;
+    updated_at: string;
+    updated_by: UserRef;
+}
+/**
+ * One generated tone-of-voice instruction row. Rows form a specificity
+ * hierarchy — user aggregate (the constant voice), per-channel base, per
+ * contact-group, per individual contact — and every row is SELF-CONTAINED: a
+ * drafting consumer injects exactly one row's `instructions` verbatim (use
+ * the resolve endpoint), never a concatenation of tiers.
+ */
+interface ToneProfile {
+    id: string;
+    org_id: string;
+    /** The profiled platform user. */
+    owned_by: UserRef;
+    /** Absent = the cross-channel user aggregate (the voice proper). */
+    channel?: Channel;
+    /** Scopes the row to one contact group; absent = the (user, channel) base. */
+    contact_group_key?: string;
+    /** Scopes the row to one individual contact within the group. */
+    contact_id?: string;
+    scope: ToneProfileScope;
+    /** COMPLETE markdown instruction set, served verbatim to a drafting model. */
+    instructions: string;
+    /** Short delta vs the tier above — what a human scans; empty on root tiers. */
+    differences?: string;
+    sample_count: number;
+    last_message_at?: string;
+    last_synthesized_at?: string;
+    created_at: string;
+    created_by: UserRef;
+    updated_at: string;
+    updated_by: UserRef;
+}
+interface CreateToneProfileSetupRequest {
+    /** Bare platform user id; the service resolves the full ref. */
+    owned_by_id: string;
+}
+type ListToneProfileSetupsQuery = PaginationQuery;
+interface ListToneProfilesQuery extends PaginationQuery {
+    owned_by_id?: string;
+    channel?: Channel;
+    scope?: ToneProfileScope;
+}
+/**
+ * A drafting context to resolve the single most-specific profile for:
+ * contact → group → channel base → user aggregate.
+ */
+interface ResolveToneProfileQuery {
+    owned_by_id: string;
+    channel?: Channel;
+    contact_id?: string;
+}
 interface PaginationQuery {
     page?: number;
     page_size?: number;
@@ -2761,6 +2892,16 @@ interface ListConnectionsQuery extends PaginationQuery {
     scope?: string;
     status?: string;
 }
+/**
+ * The delete's escape hatch. A connection delete makes the connector release
+ * its provider-side registration first and refuses with a 502
+ * `connector_uninstall_failed` when that fails — the row is the only handle on
+ * that state. `is_forced` drops the row anyway, leaving the provider-side
+ * leftovers as a manual cleanup.
+ */
+interface DeleteConnectionQuery {
+    is_forced?: boolean;
+}
 interface ListConversationsQuery extends PaginationQuery {
     channel?: string;
     status?: string;
@@ -2810,14 +2951,26 @@ interface ListAgentListenersQuery extends PaginationQuery {
     is_enabled?: boolean;
 }
 /**
- * Conversation filters: ingest-time rules that drop matching inbound messages
- * BEFORE persistence (no message, no contact — only a content-free audit
- * event). Scope-first evaluation: connection-scoped rules are final when one
- * matches; global rules apply otherwise. Specificity within a scope:
- * address > domain > role_based > automated > internal_conversations > all,
- * allow beats block within a class.
- */
-type ConversationFilterType = 'address' | 'domain' | 'role_based' | 'automated' | 'internal_conversations' | 'all';
+ * Conversation filters: rules that drop matching inbound messages BEFORE
+ * persistence (no message, no contact — only a content-free audit event) and,
+ * on meeting calendar connections, gate whether the meeting bot is scheduled
+ * at all (pre-join enforcement of the same rules — earliest possible point).
+ * Scope-first evaluation: connection-scoped rules are final when one matches;
+ * global rules apply otherwise. Specificity within a scope:
+ * address > domain > title_keyword > role_based > automated >
+ * self_originated > internal_participant > internal_conversations > all,
+ * allow beats block within a class; an allow match is a final keep, which is
+ * the auto-join composition mechanism (e.g. "organized by me" = a
+ * connection-scoped all-block plus a self_originated allow).
+ *
+ * Channel matrix: address/self_originated/all act on every channel;
+ * domain/title_keyword/internal_participant/internal_conversations act on
+ * email + meeting connections; role_based/automated are email-only. A
+ * connection-scoped rule of a type inert on that connection's channel is
+ * rejected (invalid_filter_config); global rules are unrestricted and stay
+ * inert where their facts are missing.
+ */
+type ConversationFilterType = 'address' | 'domain' | 'title_keyword' | 'role_based' | 'automated' | 'self_originated' | 'internal_participant' | 'internal_conversations' | 'all';
 type ConversationFilterAction = 'block' | 'allow';
 /** Which side of the message address/domain rules test (default: sender). */
 type FilterMatchOn = 'sender' | 'any_participant';
@@ -2842,13 +2995,23 @@ interface RoleBasedFilterConfig {
 interface AutomatedFilterConfig {
     signals?: AutomatedSignal[];
 }
+/** Title/subject contains any keyword (case-insensitive substring; stored lowercased). */
+interface TitleKeywordFilterConfig {
+    keywords: string[];
+}
+/** Conversation originates from the connection owner (meeting organizer / self sender). Empty config. */
+type SelfOriginatedFilterConfig = Record<string, never>;
+/** ≥1 participant OTHER than the connection self is on one of these domains (any-internal). */
+interface InternalParticipantFilterConfig {
+    domains: string[];
+}
 /** Drops only when sender AND every recipient are on these domains. Always block. */
 interface InternalConversationsFilterConfig {
     domains: string[];
 }
 /** Matches every message (empty config) — the scope-control primitive. */
 type AllFilterConfig = Record<string, never>;
-type ConversationFilterConfig = AddressFilterConfig | DomainFilterConfig | RoleBasedFilterConfig | AutomatedFilterConfig | InternalConversationsFilterConfig | AllFilterConfig;
+type ConversationFilterConfig = AddressFilterConfig | DomainFilterConfig | TitleKeywordFilterConfig | RoleBasedFilterConfig | AutomatedFilterConfig | SelfOriginatedFilterConfig | InternalParticipantFilterConfig | InternalConversationsFilterConfig | AllFilterConfig;
 interface ConversationFilter {
     id: string;
     org_id: string;
@@ -2944,6 +3107,13 @@ interface Contact {
     /** Merge tombstone redirect (set when status is 'merged'). */
     merged_into_contact_id?: string;
     source: ContactSource;
+    /** ContactGroup membership (one group per contact); absent = unassigned. */
+    group_key?: string;
+    /**
+     * Who assigned the group: 'manual' assignments are authoritative (tone
+     * synthesis never overrides them), 'model' ones may be reassigned by a run.
+     */
+    group_source?: ContactGroupSource;
     has_manual_edits: boolean;
     /** The contact's reachable endpoints, embedded on reads. */
     addresses?: ContactAddress[];
@@ -3036,11 +3206,18 @@ interface ListContactsQuery extends PaginationQuery {
     /** Free-text needle matched against contact name + address values. */
     q?: string;
     status?: ContactStatus;
+    /** Members of one contact group (drives group-member lists). */
+    group_key?: string;
 }
 interface UpdateContactRequest {
     name?: string;
     status?: 'active' | 'archived';
     has_legal_hold?: boolean;
+    /**
+     * Assigns the contact to a contact group ('' clears). A PATCH assignment is
+     * stamped group_source='manual' — tone synthesis never overrides it.
+     */
+    group_key?: string;
 }
 interface AttachContactAddressRequest {
     kind: ContactAddressKind;
@@ -3314,6 +3491,10 @@ declare class ConversationClient {
     readonly glossaryTerms: GlossaryTermService;
     /** Conversation taxonomy: the types the pre-summary classifier assigns. */
     readonly conversationTypes: ConversationTypeService;
+    /** Generic audience taxonomy; membership lives on the contact. */
+    readonly contactGroups: ContactGroupService;
+    /** Tone-of-voice synthesis: per-user setups + the generated profiles. */
+    readonly toneProfiles: ToneProfileService;
     readonly transcriptions: TranscriptionService;
     /** Review-pass findings: likely misheard terms awaiting accept/reject. */
     readonly mistranscribedTerms: MistranscribedTermService;
@@ -3354,7 +3535,14 @@ interface ConnectionService {
     get(id: string): Promise<Connection>;
     create(request: CreateConnectionRequest): Promise<Connection>;
     update(id: string, request: UpdateConnectionRequest): Promise<Connection>;
-    delete(id: string): Promise<void>;
+    /**
+     * Delete a connection. The connector first releases its provider-side
+     * registration (a Recall calendar and the OAuth grant behind it); when that
+     * fails the delete is refused with a `connector_uninstall_failed` 502 rather
+     * than orphaning it. Pass `{ is_forced: true }` to drop the row anyway and
+     * 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>;
     /**
@@ -3396,6 +3584,11 @@ interface ConversationService {
     /** Patch the user-editable surface (subject, summary, status, metadata). */
     update(id: string, request: UpdateConversationRequest): Promise<Conversation>;
     end(id: string): Promise<Conversation>;
+    /**
+     * Hard-delete the conversation, its thread children, and every dependent
+     * row (messages, attachments, read markers, transcriptions). Irreversible.
+     */
+    delete(id: string): Promise<void>;
     /** Upsert the requesting user's read marker to now (open a conversation). */
     markRead(id: string): Promise<void>;
     /** Remove the marker — the conversation reads as unread again. */
@@ -3485,6 +3678,43 @@ interface ConversationTypeService {
     upsert(key: string, request: CreateConversationTypeRequest): Promise<ConversationType>;
     delete(key: string): Promise<void>;
 }
+/**
+ * Contact groups: the generic org-shared audience taxonomy. Membership lives
+ * on the contact (`Contact.group_key`, one group per contact — assign via
+ * `contacts.update`); tone-of-voice synthesis reads the groups and
+ * auto-assigns ungrouped correspondents. Keyed by `key` (not id); `upsert` is
+ * the idempotent module-deploy door. Deleting a group clears its members'
+ * membership and purges its tone profile rows.
+ */
+interface ContactGroupService {
+    list(query?: ListContactGroupsQuery): Promise<ListResponse<ContactGroup>>;
+    get(key: string): Promise<ContactGroup>;
+    create(request: CreateContactGroupRequest): Promise<ContactGroup>;
+    update(key: string, request: UpdateContactGroupRequest): Promise<ContactGroup>;
+    /** Idempotent create-or-update by key (PUT) — what `pro module deploy` calls. */
+    upsert(key: string, request: CreateContactGroupRequest): Promise<ContactGroup>;
+    delete(key: string): Promise<void>;
+}
+/**
+ * Tone-of-voice synthesis. A setup opts one platform user in (only set-up
+ * users are swept); `synthesize` triggers a whole-user run immediately (202;
+ * 409 `synthesis_in_progress` while one is live). Generated profiles form a
+ * specificity hierarchy — fetch a user's rows with `listProfiles`, or let the
+ * server pick the single most-specific row for a drafting context with
+ * `resolve` (each row is self-contained; never concatenate tiers).
+ */
+interface ToneProfileService {
+    listSetups(query?: ListToneProfileSetupsQuery): Promise<ListResponse<ToneProfileSetup>>;
+    createSetup(request: CreateToneProfileSetupRequest): Promise<ToneProfileSetup>;
+    /** Removes the setup AND the user's generated profiles. */
+    deleteSetup(id: string): Promise<void>;
+    /** Kicks a whole-user synthesis run off-request (bypasses cadence checks). */
+    synthesize(setupId: string): Promise<void>;
+    listProfiles(query?: ListToneProfilesQuery): Promise<ListResponse<ToneProfile>>;
+    getProfile(id: string): Promise<ToneProfile>;
+    /** The single most-specific profile for a drafting context; 404 when none. */
+    resolve(query: ResolveToneProfileQuery): Promise<ToneProfile>;
+}
 /** Batch transcription of stored audio files + materialization. */
 interface TranscriptionService {
     /**
@@ -6241,4 +6471,4 @@ declare class WorkflowClient {
     constructor(client: ProteosClient);
 }
 
-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 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 };
+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

@@ -1314,6 +1314,10 @@ var ConversationClient = class {
   glossaryTerms;
   /** Conversation taxonomy: the types the pre-summary classifier assigns. */
   conversationTypes;
+  /** Generic audience taxonomy; membership lives on the contact. */
+  contactGroups;
+  /** Tone-of-voice synthesis: per-user setups + the generated profiles. */
+  toneProfiles;
   transcriptions;
   /** Review-pass findings: likely misheard terms awaiting accept/reject. */
   mistranscribedTerms;
@@ -1330,6 +1334,8 @@ var ConversationClient = class {
     this.conversationFilters = new ConversationFilterServiceImpl(client);
     this.glossaryTerms = new GlossaryTermServiceImpl(client);
     this.conversationTypes = new ConversationTypeServiceImpl(client);
+    this.contactGroups = new ContactGroupServiceImpl(client);
+    this.toneProfiles = new ToneProfileServiceImpl(client);
     this.transcriptions = new TranscriptionServiceImpl(client);
     this.mistranscribedTerms = new MistranscribedTermServiceImpl(client);
     this.meetings = new MeetingServiceImpl(client);
@@ -1381,10 +1387,11 @@ var ConnectionServiceImpl = class {
       request
     );
   }
-  async delete(id) {
-    await this.client.request(
+  async delete(id, query = {}) {
+    await this.client.requestWithQuery(
       "DELETE",
-      `${CONVERSATION_BASE_PATH}/connections/${encodeURIComponent(id)}`
+      `${CONVERSATION_BASE_PATH}/connections/${encodeURIComponent(id)}`,
+      query
     );
   }
   install(id) {
@@ -1536,6 +1543,12 @@ var ConversationServiceImpl = class {
       `${CONVERSATION_BASE_PATH}/conversations/${encodeURIComponent(id)}/end`
     );
   }
+  delete(id) {
+    return this.client.request(
+      "DELETE",
+      `${CONVERSATION_BASE_PATH}/conversations/${encodeURIComponent(id)}`
+    );
+  }
   markRead(id) {
     return this.client.request(
       "POST",
@@ -1764,6 +1777,88 @@ var ConversationTypeServiceImpl = class {
     );
   }
 };
+var ContactGroupServiceImpl = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  list(query = {}) {
+    return this.client.requestWithQuery("GET", `${CONVERSATION_BASE_PATH}/contact-groups`, query);
+  }
+  get(key) {
+    return this.client.request(
+      "GET",
+      `${CONVERSATION_BASE_PATH}/contact-groups/${encodeURIComponent(key)}`
+    );
+  }
+  create(request) {
+    return this.client.request("POST", `${CONVERSATION_BASE_PATH}/contact-groups`, request);
+  }
+  update(key, request) {
+    return this.client.request(
+      "PATCH",
+      `${CONVERSATION_BASE_PATH}/contact-groups/${encodeURIComponent(key)}`,
+      request
+    );
+  }
+  upsert(key, request) {
+    return this.client.request(
+      "PUT",
+      `${CONVERSATION_BASE_PATH}/contact-groups/${encodeURIComponent(key)}`,
+      { ...request, key }
+    );
+  }
+  async delete(key) {
+    await this.client.request(
+      "DELETE",
+      `${CONVERSATION_BASE_PATH}/contact-groups/${encodeURIComponent(key)}`
+    );
+  }
+};
+var ToneProfileServiceImpl = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  listSetups(query = {}) {
+    return this.client.requestWithQuery(
+      "GET",
+      `${CONVERSATION_BASE_PATH}/tone-profile-setups`,
+      query
+    );
+  }
+  createSetup(request) {
+    return this.client.request("POST", `${CONVERSATION_BASE_PATH}/tone-profile-setups`, request);
+  }
+  async deleteSetup(id) {
+    await this.client.request(
+      "DELETE",
+      `${CONVERSATION_BASE_PATH}/tone-profile-setups/${encodeURIComponent(id)}`
+    );
+  }
+  async synthesize(setupId) {
+    await this.client.request(
+      "POST",
+      `${CONVERSATION_BASE_PATH}/tone-profile-setups/${encodeURIComponent(setupId)}/synthesize`
+    );
+  }
+  listProfiles(query = {}) {
+    return this.client.requestWithQuery("GET", `${CONVERSATION_BASE_PATH}/tone-profiles`, query);
+  }
+  getProfile(id) {
+    return this.client.request(
+      "GET",
+      `${CONVERSATION_BASE_PATH}/tone-profiles/${encodeURIComponent(id)}`
+    );
+  }
+  resolve(query) {
+    return this.client.requestWithQuery(
+      "GET",
+      `${CONVERSATION_BASE_PATH}/tone-profiles/resolve`,
+      query
+    );
+  }
+};
 var TranscriptionServiceImpl = class {
   constructor(client) {
     this.client = client;