@proteos/sdk 0.19.0 → 0.20.0

package/dist/index.d.cts

@@ -1838,21 +1838,30 @@ interface VoiceService {
  * mirror of packages/go/model/conversation (snake_case, Is-prefixed booleans).
  */
 
-/** Platform medium a conversation lives on (closed enum; platform identity). */
-type Channel = 'slack' | 'email' | 'linkedin' | 'sms' | 'teams' | 'telegram' | 'whatsapp' | 'meeting' | 'adhoc' | 'instagram' | 'messenger' | 'x';
+/**
+ * Platform medium a conversation lives on (closed enum; platform identity).
+ * Where a provider brand spans both a chat product and a meeting platform the
+ * channel is suffixed -chat / -meeting (teams-chat vs teams-meeting). The
+ * *-meeting channels are the platforms the Ava meeting-bot family serves;
+ * `meeting` stays the generic fallback for unclassified platforms.
+ */
+type Channel = 'slack' | 'email' | 'linkedin' | 'sms' | 'teams-chat' | 'telegram' | 'whatsapp' | 'meeting' | 'zoom-meeting' | 'google-meet' | 'teams-meeting' | 'webex-meeting' | 'adhoc' | 'instagram' | 'messenger' | 'x';
 /**
  * Concrete integration serving a channel (typed union — one value per shipped
  * connector; runtime availability is decided by the service's registry).
  * The unipile-* family serves the six messaging systems aggregated through
- * Unipile — one key per messaging system.
+ * Unipile — one key per messaging system. The meeting keys are the Ava
+ * meeting-bot family: adhoc-meeting dispatches by meeting URL; the calendar
+ * keys auto-join through a user's connected calendar.
  */
-type ConnectorKey = 'slack' | 'gmail' | 'echo' | 'unipile-whatsapp' | 'unipile-linkedin' | 'unipile-telegram' | 'unipile-instagram' | 'unipile-messenger' | 'unipile-x';
+type ConnectorKey = 'slack' | 'gmail' | 'echo' | 'unipile-whatsapp' | 'unipile-linkedin' | 'unipile-telegram' | 'unipile-instagram' | 'unipile-messenger' | 'unipile-x' | 'adhoc-meeting' | 'google-calendar-meeting' | 'microsoft-calendar-meeting';
 /**
  * Who operates the integration mechanics behind a connector: Proteos' own
- * integration (native) or an account aggregated through Unipile (unipile).
- * Computed on connection reads; the UI groups the connector catalog by it.
+ * integration (native), an account aggregated through Unipile (unipile), or
+ * the Ava meeting-bot family (ava). Computed on connection reads; the UI
+ * groups the connector catalog by it.
  */
-type ConnectorProvider = 'native' | 'unipile';
+type ConnectorProvider = 'native' | 'unipile' | 'ava';
 type MessageDirection = 'inbound' | 'outbound';
 type MessageStatus = 'received' | 'pending' | 'sent' | 'failed';
 type ConnectionScope$1 = 'org' | 'user';
@@ -2115,6 +2124,12 @@ interface AgentListener {
     agent_key: string;
     trigger_type: AgentListenerTriggerType;
     trigger_config: AgentListenerTriggerConfig;
+    /**
+     * When set, gates the listener behind a wake word: the trigger stays dormant
+     * until a message containing this phrase starts a session; once a session is
+     * connected the trigger drives it normally. Empty/absent ⇒ no gate.
+     */
+    wake_phrase?: string;
     /** The user the dispatcher acts as when driving the agent. */
     acting_user: UserRef$1;
     is_enabled: boolean;
@@ -2181,6 +2196,8 @@ interface CreateAgentListenerRequest {
     agent_key: string;
     trigger_type: AgentListenerTriggerType;
     trigger_config?: AgentListenerTriggerConfig;
+    /** Gate the listener behind a wake word; omit or leave empty for no gate. */
+    wake_phrase?: string;
     /** A bare user id; the service wraps it into a person UserRef. */
     acting_user_id: string;
     /** Omit to default to enabled. */
@@ -2192,6 +2209,8 @@ interface UpdateAgentListenerRequest {
     agent_key?: string;
     trigger_type?: AgentListenerTriggerType;
     trigger_config?: AgentListenerTriggerConfig;
+    /** Set to gate the listener; pass "" to clear an existing wake phrase. */
+    wake_phrase?: string;
     acting_user_id?: string;
     is_enabled?: boolean;
     priority?: number;
@@ -2343,6 +2362,22 @@ interface MaterializeTranscriptionRequest {
 }
 interface ListTranscriptionsQuery extends PaginationQuery {
     status?: string;
+    /** List a conversation's transcription artifacts. */
+    conversation_id?: string;
+    /** Narrow to the provider-side transcript identity. */
+    provider_request_id?: string;
+}
+/**
+ * Sends a meeting bot (Ava) into a meeting through an active meeting
+ * connection (adhoc-meeting). join_at schedules the bot ahead of time (ISO
+ * instant; a scheduled bot joins reliably on time — omit to join now); title
+ * seeds the meeting conversation's subject.
+ */
+interface DispatchMeetingBotRequest {
+    connection_id: string;
+    meeting_url: string;
+    title?: string;
+    join_at?: string;
 }
 
 /**
@@ -2361,10 +2396,23 @@ declare class ConversationClient {
     readonly messages: MessageService;
     readonly agentListeners: AgentListenerService;
     readonly transcriptions: TranscriptionService;
+    /** Meeting bots (Ava): dispatch into a meeting URL, remove from a meeting. */
+    readonly meetings: MeetingService;
     /** Realtime speech-to-text (dictation) — moved here from agent-service. */
     readonly voice: VoiceService;
     constructor(client: ProteosClient);
 }
+/** Meeting bots (Ava) — dispatch by meeting URL and removal. */
+interface MeetingService {
+    /**
+     * Send Ava to a meeting URL. Resolves with the pre-minted meeting
+     * conversation (channel = the platform classified from the URL); transcript
+     * turns then stream in as inbound messages while the meeting runs.
+     */
+    dispatch(request: DispatchMeetingBotRequest): Promise<Conversation>;
+    /** Make the bot leave the meeting and end the conversation (by conversation id). */
+    remove(conversationId: string): Promise<Conversation>;
+}
 /** Configured integration instances (Slack workspace, Gmail grant, …). */
 interface ConnectionService {
     list(query?: ListConnectionsQuery): Promise<ListResponse$1<Connection>>;
@@ -5222,4 +5270,4 @@ declare class WorkflowClient {
     constructor(client: ProteosClient);
 }
 
-export { AccountClient, type Action, type ActionBinding, ActionSchema, type ActionScope, ActionScopeSchema, type ActionService, type Agent, type AgentActionParams, type AgentArtifactsPayload, AgentClient, type AgentKickoff, type AgentListener, type AgentListenerService, type AgentListenerTriggerType, type AgentMessagePayload, type AgentResourceListOptions, type AgentService, type ApiErrorResponse, type AppendEventRequest, type AssignPermissionRequest, type AssignRoleRequest, type Attachment, Attribute, AuditFields, type AuthListOptions, type BatchTransactionError, BatchTransactionErrorSchema, type BatchTransactionStatus, type BatchUpsertRecordsResponse, BatchUpsertRecordsResponseSchema, type BatchUpsertTransaction, type BatchUpsertTransactionResult, BatchUpsertTransactionResultSchema, BatchUpsertTransactionSchema, type BinaryRef, type Channel, type ClientEventType, type ClientToolSchema, type Connection, type ConnectionCredentials, type ConnectionEndpoint, type ConnectionScope$1 as ConnectionScope, type ConnectionService, type ConnectionStatus$1 as ConnectionStatus, type Connector, ConnectorClient, type ConnectorConnection, type ConnectionScope as ConnectorConnectionScope, type ConnectionStatus as ConnectorConnectionStatus, type ConnectionTokenResponse as ConnectorConnectionTokenResponse, type CredentialKind as ConnectorCredentialKind, type ConnectorKey, type ConnectorMethod, type ConnectorProvider, type ConsumerGroup, type ContentBlock$1 as ContentBlock, type ContentMatch, type ContentResponse, type ContextCompactedPayload, type Conversation, ConversationClient, type ConversationParticipant, type ConversationService, type ConversationStatus, type CreateAgentListenerRequest, type CreateAgentRequest, type CreateConnectionRequest, type CreateConnectorConnectionRequest, type CreateFileMetadata, type CreateLabelRequest, type CreateLinkRequest, type CreateMcpServerRequest, type CreateNodeRequest, type CreateOrganizationRequest, type CreatePromptRequest, type CreateRecordLinkRequest, type CreateRoleRequest, type CreateSessionRequest, type CreateToolRequest, type CreateUserRequest, type CreateWorkflowRequest, type CredentialSpec, type CronTriggerParams, DEFAULT_PORT, DataClient, type DisplayOptions, ERROR_PORT, type EditContentRequest, type EditContentResponse, type EmptyPayload, 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, FunctionsClient, type GetExecutionDetailResponse, type GetGraphOptions, type GetNodeExecutionItemsOptions, type GetNodeExecutionItemsResponse, type GetNodeTypesResponse, type GraphService, type InlineLinkRequest, type InstallConnectionResponse, type InstallConnectorConnectionResponse, 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 ListConversationsQuery, type ListEventsOptions, type ListExecutionsOptions, type ListLabelsOptions, type ListLinksOptions, type ListMcpServersOptions, type ListMessagesQuery, type ListNodesOptions, ListOptions, type ListOrganizationsOptions, type ListParticipantsQuery, type ListPromptsOptions, type ListRecordLinksOptions, type ListRecordsOptions, type ListResponse$1 as ListResponse, ListResult, type ListRolePermissionsOptions, type ListRolesOptions, type ListRoomsQuery, type ListSessionsOptions, type ListSkillsOptions, type ListToolsOptions, 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 Message, type ContentBlock as MessageContentBlock, type MessageDirection, type MessageKickoff, type MessagePreview, type MessageRecipient, type MessageService, type MessageStatus, type MessageTriggerParams, 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 OutcomeKickoff, type OutcomeRubric, type OutlineHeading, type OutlineRequest, type OutlineResponse, PLATFORM_ENTITIES, PLATFORM_ENTITY_SLUGS, PageIterator, type PairedItem, type ParseStatus, type Participant, type ParticipantRef, type ParticipantSource, type Permission, type PlatformEntity, type PlatformEvent, type PortSpec, type Prompt, type PromptService, type PromptVersion, type PropertyOption, type PropertyType, ProteosClient, ProteosError, 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 RecordService, type RedriveResult, type ResultBlock, type Role, 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 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 Topic, type TopicKind, type TopicService, type TranscribeStreamOptions, type TranscriptResult, type TriggerKind, type Turn, type UnreadCounts, type UpdateAgentListenerRequest, type UpdateAgentRequest, type UpdateConnectionRequest, type UpdateConnectorConnectionRequest, type UpdateLabelRequest, type UpdateLinkRequest, type UpdateMcpServerRequest, type UpdateNodeRequest, type UpdateOrganizationRequest, type UpdatePromptRequest, type UpdateRoleRequest, type UpdateToolRequest, 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 WorkflowContentBlock, 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 { AccountClient, type Action, type ActionBinding, ActionSchema, type ActionScope, ActionScopeSchema, type ActionService, type Agent, type AgentActionParams, type AgentArtifactsPayload, AgentClient, type AgentKickoff, type AgentListener, type AgentListenerService, type AgentListenerTriggerType, type AgentMessagePayload, type AgentResourceListOptions, type AgentService, type ApiErrorResponse, type AppendEventRequest, type AssignPermissionRequest, type AssignRoleRequest, type Attachment, Attribute, AuditFields, type AuthListOptions, type BatchTransactionError, BatchTransactionErrorSchema, type BatchTransactionStatus, type BatchUpsertRecordsResponse, BatchUpsertRecordsResponseSchema, type BatchUpsertTransaction, type BatchUpsertTransactionResult, BatchUpsertTransactionResultSchema, BatchUpsertTransactionSchema, type BinaryRef, type Channel, type ClientEventType, type ClientToolSchema, type Connection, type ConnectionCredentials, type ConnectionEndpoint, type ConnectionScope$1 as ConnectionScope, type ConnectionService, type ConnectionStatus$1 as ConnectionStatus, type Connector, ConnectorClient, type ConnectorConnection, type ConnectionScope as ConnectorConnectionScope, type ConnectionStatus as ConnectorConnectionStatus, type ConnectionTokenResponse as ConnectorConnectionTokenResponse, type CredentialKind as ConnectorCredentialKind, type ConnectorKey, type ConnectorMethod, type ConnectorProvider, type ConsumerGroup, type ContentBlock$1 as ContentBlock, type ContentMatch, type ContentResponse, type ContextCompactedPayload, type Conversation, ConversationClient, type ConversationParticipant, type ConversationService, type ConversationStatus, type CreateAgentListenerRequest, type CreateAgentRequest, type CreateConnectionRequest, type CreateConnectorConnectionRequest, type CreateFileMetadata, type CreateLabelRequest, type CreateLinkRequest, type CreateMcpServerRequest, type CreateNodeRequest, type CreateOrganizationRequest, type CreatePromptRequest, type CreateRecordLinkRequest, type CreateRoleRequest, type CreateSessionRequest, type CreateToolRequest, type CreateUserRequest, type CreateWorkflowRequest, type CredentialSpec, type CronTriggerParams, DEFAULT_PORT, DataClient, type DispatchMeetingBotRequest, type DisplayOptions, ERROR_PORT, type EditContentRequest, type EditContentResponse, type EmptyPayload, 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, FunctionsClient, type GetExecutionDetailResponse, type GetGraphOptions, type GetNodeExecutionItemsOptions, type GetNodeExecutionItemsResponse, type GetNodeTypesResponse, type GraphService, type InlineLinkRequest, type InstallConnectionResponse, type InstallConnectorConnectionResponse, 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 ListConversationsQuery, type ListEventsOptions, type ListExecutionsOptions, type ListLabelsOptions, type ListLinksOptions, type ListMcpServersOptions, type ListMessagesQuery, type ListNodesOptions, ListOptions, type ListOrganizationsOptions, type ListParticipantsQuery, type ListPromptsOptions, type ListRecordLinksOptions, type ListRecordsOptions, type ListResponse$1 as ListResponse, ListResult, type ListRolePermissionsOptions, type ListRolesOptions, type ListRoomsQuery, type ListSessionsOptions, type ListSkillsOptions, type ListToolsOptions, 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 Message, type ContentBlock as MessageContentBlock, type MessageDirection, type MessageKickoff, type MessagePreview, type MessageRecipient, type MessageService, type MessageStatus, type MessageTriggerParams, 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 OutcomeKickoff, type OutcomeRubric, type OutlineHeading, type OutlineRequest, type OutlineResponse, PLATFORM_ENTITIES, PLATFORM_ENTITY_SLUGS, PageIterator, type PairedItem, type ParseStatus, type Participant, type ParticipantRef, type ParticipantSource, type Permission, type PlatformEntity, type PlatformEvent, type PortSpec, type Prompt, type PromptService, type PromptVersion, type PropertyOption, type PropertyType, ProteosClient, ProteosError, 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 RecordService, type RedriveResult, type ResultBlock, type Role, 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 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 Topic, type TopicKind, type TopicService, type TranscribeStreamOptions, type TranscriptResult, type TriggerKind, type Turn, type UnreadCounts, type UpdateAgentListenerRequest, type UpdateAgentRequest, type UpdateConnectionRequest, type UpdateConnectorConnectionRequest, type UpdateLabelRequest, type UpdateLinkRequest, type UpdateMcpServerRequest, type UpdateNodeRequest, type UpdateOrganizationRequest, type UpdatePromptRequest, type UpdateRoleRequest, type UpdateToolRequest, 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 WorkflowContentBlock, 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

@@ -1838,21 +1838,30 @@ interface VoiceService {
  * mirror of packages/go/model/conversation (snake_case, Is-prefixed booleans).
  */
 
-/** Platform medium a conversation lives on (closed enum; platform identity). */
-type Channel = 'slack' | 'email' | 'linkedin' | 'sms' | 'teams' | 'telegram' | 'whatsapp' | 'meeting' | 'adhoc' | 'instagram' | 'messenger' | 'x';
+/**
+ * Platform medium a conversation lives on (closed enum; platform identity).
+ * Where a provider brand spans both a chat product and a meeting platform the
+ * channel is suffixed -chat / -meeting (teams-chat vs teams-meeting). The
+ * *-meeting channels are the platforms the Ava meeting-bot family serves;
+ * `meeting` stays the generic fallback for unclassified platforms.
+ */
+type Channel = 'slack' | 'email' | 'linkedin' | 'sms' | 'teams-chat' | 'telegram' | 'whatsapp' | 'meeting' | 'zoom-meeting' | 'google-meet' | 'teams-meeting' | 'webex-meeting' | 'adhoc' | 'instagram' | 'messenger' | 'x';
 /**
  * Concrete integration serving a channel (typed union — one value per shipped
  * connector; runtime availability is decided by the service's registry).
  * The unipile-* family serves the six messaging systems aggregated through
- * Unipile — one key per messaging system.
+ * Unipile — one key per messaging system. The meeting keys are the Ava
+ * meeting-bot family: adhoc-meeting dispatches by meeting URL; the calendar
+ * keys auto-join through a user's connected calendar.
  */
-type ConnectorKey = 'slack' | 'gmail' | 'echo' | 'unipile-whatsapp' | 'unipile-linkedin' | 'unipile-telegram' | 'unipile-instagram' | 'unipile-messenger' | 'unipile-x';
+type ConnectorKey = 'slack' | 'gmail' | 'echo' | 'unipile-whatsapp' | 'unipile-linkedin' | 'unipile-telegram' | 'unipile-instagram' | 'unipile-messenger' | 'unipile-x' | 'adhoc-meeting' | 'google-calendar-meeting' | 'microsoft-calendar-meeting';
 /**
  * Who operates the integration mechanics behind a connector: Proteos' own
- * integration (native) or an account aggregated through Unipile (unipile).
- * Computed on connection reads; the UI groups the connector catalog by it.
+ * integration (native), an account aggregated through Unipile (unipile), or
+ * the Ava meeting-bot family (ava). Computed on connection reads; the UI
+ * groups the connector catalog by it.
  */
-type ConnectorProvider = 'native' | 'unipile';
+type ConnectorProvider = 'native' | 'unipile' | 'ava';
 type MessageDirection = 'inbound' | 'outbound';
 type MessageStatus = 'received' | 'pending' | 'sent' | 'failed';
 type ConnectionScope$1 = 'org' | 'user';
@@ -2115,6 +2124,12 @@ interface AgentListener {
     agent_key: string;
     trigger_type: AgentListenerTriggerType;
     trigger_config: AgentListenerTriggerConfig;
+    /**
+     * When set, gates the listener behind a wake word: the trigger stays dormant
+     * until a message containing this phrase starts a session; once a session is
+     * connected the trigger drives it normally. Empty/absent ⇒ no gate.
+     */
+    wake_phrase?: string;
     /** The user the dispatcher acts as when driving the agent. */
     acting_user: UserRef$1;
     is_enabled: boolean;
@@ -2181,6 +2196,8 @@ interface CreateAgentListenerRequest {
     agent_key: string;
     trigger_type: AgentListenerTriggerType;
     trigger_config?: AgentListenerTriggerConfig;
+    /** Gate the listener behind a wake word; omit or leave empty for no gate. */
+    wake_phrase?: string;
     /** A bare user id; the service wraps it into a person UserRef. */
     acting_user_id: string;
     /** Omit to default to enabled. */
@@ -2192,6 +2209,8 @@ interface UpdateAgentListenerRequest {
     agent_key?: string;
     trigger_type?: AgentListenerTriggerType;
     trigger_config?: AgentListenerTriggerConfig;
+    /** Set to gate the listener; pass "" to clear an existing wake phrase. */
+    wake_phrase?: string;
     acting_user_id?: string;
     is_enabled?: boolean;
     priority?: number;
@@ -2343,6 +2362,22 @@ interface MaterializeTranscriptionRequest {
 }
 interface ListTranscriptionsQuery extends PaginationQuery {
     status?: string;
+    /** List a conversation's transcription artifacts. */
+    conversation_id?: string;
+    /** Narrow to the provider-side transcript identity. */
+    provider_request_id?: string;
+}
+/**
+ * Sends a meeting bot (Ava) into a meeting through an active meeting
+ * connection (adhoc-meeting). join_at schedules the bot ahead of time (ISO
+ * instant; a scheduled bot joins reliably on time — omit to join now); title
+ * seeds the meeting conversation's subject.
+ */
+interface DispatchMeetingBotRequest {
+    connection_id: string;
+    meeting_url: string;
+    title?: string;
+    join_at?: string;
 }
 
 /**
@@ -2361,10 +2396,23 @@ declare class ConversationClient {
     readonly messages: MessageService;
     readonly agentListeners: AgentListenerService;
     readonly transcriptions: TranscriptionService;
+    /** Meeting bots (Ava): dispatch into a meeting URL, remove from a meeting. */
+    readonly meetings: MeetingService;
     /** Realtime speech-to-text (dictation) — moved here from agent-service. */
     readonly voice: VoiceService;
     constructor(client: ProteosClient);
 }
+/** Meeting bots (Ava) — dispatch by meeting URL and removal. */
+interface MeetingService {
+    /**
+     * Send Ava to a meeting URL. Resolves with the pre-minted meeting
+     * conversation (channel = the platform classified from the URL); transcript
+     * turns then stream in as inbound messages while the meeting runs.
+     */
+    dispatch(request: DispatchMeetingBotRequest): Promise<Conversation>;
+    /** Make the bot leave the meeting and end the conversation (by conversation id). */
+    remove(conversationId: string): Promise<Conversation>;
+}
 /** Configured integration instances (Slack workspace, Gmail grant, …). */
 interface ConnectionService {
     list(query?: ListConnectionsQuery): Promise<ListResponse$1<Connection>>;
@@ -5222,4 +5270,4 @@ declare class WorkflowClient {
     constructor(client: ProteosClient);
 }
 
-export { AccountClient, type Action, type ActionBinding, ActionSchema, type ActionScope, ActionScopeSchema, type ActionService, type Agent, type AgentActionParams, type AgentArtifactsPayload, AgentClient, type AgentKickoff, type AgentListener, type AgentListenerService, type AgentListenerTriggerType, type AgentMessagePayload, type AgentResourceListOptions, type AgentService, type ApiErrorResponse, type AppendEventRequest, type AssignPermissionRequest, type AssignRoleRequest, type Attachment, Attribute, AuditFields, type AuthListOptions, type BatchTransactionError, BatchTransactionErrorSchema, type BatchTransactionStatus, type BatchUpsertRecordsResponse, BatchUpsertRecordsResponseSchema, type BatchUpsertTransaction, type BatchUpsertTransactionResult, BatchUpsertTransactionResultSchema, BatchUpsertTransactionSchema, type BinaryRef, type Channel, type ClientEventType, type ClientToolSchema, type Connection, type ConnectionCredentials, type ConnectionEndpoint, type ConnectionScope$1 as ConnectionScope, type ConnectionService, type ConnectionStatus$1 as ConnectionStatus, type Connector, ConnectorClient, type ConnectorConnection, type ConnectionScope as ConnectorConnectionScope, type ConnectionStatus as ConnectorConnectionStatus, type ConnectionTokenResponse as ConnectorConnectionTokenResponse, type CredentialKind as ConnectorCredentialKind, type ConnectorKey, type ConnectorMethod, type ConnectorProvider, type ConsumerGroup, type ContentBlock$1 as ContentBlock, type ContentMatch, type ContentResponse, type ContextCompactedPayload, type Conversation, ConversationClient, type ConversationParticipant, type ConversationService, type ConversationStatus, type CreateAgentListenerRequest, type CreateAgentRequest, type CreateConnectionRequest, type CreateConnectorConnectionRequest, type CreateFileMetadata, type CreateLabelRequest, type CreateLinkRequest, type CreateMcpServerRequest, type CreateNodeRequest, type CreateOrganizationRequest, type CreatePromptRequest, type CreateRecordLinkRequest, type CreateRoleRequest, type CreateSessionRequest, type CreateToolRequest, type CreateUserRequest, type CreateWorkflowRequest, type CredentialSpec, type CronTriggerParams, DEFAULT_PORT, DataClient, type DisplayOptions, ERROR_PORT, type EditContentRequest, type EditContentResponse, type EmptyPayload, 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, FunctionsClient, type GetExecutionDetailResponse, type GetGraphOptions, type GetNodeExecutionItemsOptions, type GetNodeExecutionItemsResponse, type GetNodeTypesResponse, type GraphService, type InlineLinkRequest, type InstallConnectionResponse, type InstallConnectorConnectionResponse, 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 ListConversationsQuery, type ListEventsOptions, type ListExecutionsOptions, type ListLabelsOptions, type ListLinksOptions, type ListMcpServersOptions, type ListMessagesQuery, type ListNodesOptions, ListOptions, type ListOrganizationsOptions, type ListParticipantsQuery, type ListPromptsOptions, type ListRecordLinksOptions, type ListRecordsOptions, type ListResponse$1 as ListResponse, ListResult, type ListRolePermissionsOptions, type ListRolesOptions, type ListRoomsQuery, type ListSessionsOptions, type ListSkillsOptions, type ListToolsOptions, 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 Message, type ContentBlock as MessageContentBlock, type MessageDirection, type MessageKickoff, type MessagePreview, type MessageRecipient, type MessageService, type MessageStatus, type MessageTriggerParams, 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 OutcomeKickoff, type OutcomeRubric, type OutlineHeading, type OutlineRequest, type OutlineResponse, PLATFORM_ENTITIES, PLATFORM_ENTITY_SLUGS, PageIterator, type PairedItem, type ParseStatus, type Participant, type ParticipantRef, type ParticipantSource, type Permission, type PlatformEntity, type PlatformEvent, type PortSpec, type Prompt, type PromptService, type PromptVersion, type PropertyOption, type PropertyType, ProteosClient, ProteosError, 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 RecordService, type RedriveResult, type ResultBlock, type Role, 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 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 Topic, type TopicKind, type TopicService, type TranscribeStreamOptions, type TranscriptResult, type TriggerKind, type Turn, type UnreadCounts, type UpdateAgentListenerRequest, type UpdateAgentRequest, type UpdateConnectionRequest, type UpdateConnectorConnectionRequest, type UpdateLabelRequest, type UpdateLinkRequest, type UpdateMcpServerRequest, type UpdateNodeRequest, type UpdateOrganizationRequest, type UpdatePromptRequest, type UpdateRoleRequest, type UpdateToolRequest, 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 WorkflowContentBlock, 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 { AccountClient, type Action, type ActionBinding, ActionSchema, type ActionScope, ActionScopeSchema, type ActionService, type Agent, type AgentActionParams, type AgentArtifactsPayload, AgentClient, type AgentKickoff, type AgentListener, type AgentListenerService, type AgentListenerTriggerType, type AgentMessagePayload, type AgentResourceListOptions, type AgentService, type ApiErrorResponse, type AppendEventRequest, type AssignPermissionRequest, type AssignRoleRequest, type Attachment, Attribute, AuditFields, type AuthListOptions, type BatchTransactionError, BatchTransactionErrorSchema, type BatchTransactionStatus, type BatchUpsertRecordsResponse, BatchUpsertRecordsResponseSchema, type BatchUpsertTransaction, type BatchUpsertTransactionResult, BatchUpsertTransactionResultSchema, BatchUpsertTransactionSchema, type BinaryRef, type Channel, type ClientEventType, type ClientToolSchema, type Connection, type ConnectionCredentials, type ConnectionEndpoint, type ConnectionScope$1 as ConnectionScope, type ConnectionService, type ConnectionStatus$1 as ConnectionStatus, type Connector, ConnectorClient, type ConnectorConnection, type ConnectionScope as ConnectorConnectionScope, type ConnectionStatus as ConnectorConnectionStatus, type ConnectionTokenResponse as ConnectorConnectionTokenResponse, type CredentialKind as ConnectorCredentialKind, type ConnectorKey, type ConnectorMethod, type ConnectorProvider, type ConsumerGroup, type ContentBlock$1 as ContentBlock, type ContentMatch, type ContentResponse, type ContextCompactedPayload, type Conversation, ConversationClient, type ConversationParticipant, type ConversationService, type ConversationStatus, type CreateAgentListenerRequest, type CreateAgentRequest, type CreateConnectionRequest, type CreateConnectorConnectionRequest, type CreateFileMetadata, type CreateLabelRequest, type CreateLinkRequest, type CreateMcpServerRequest, type CreateNodeRequest, type CreateOrganizationRequest, type CreatePromptRequest, type CreateRecordLinkRequest, type CreateRoleRequest, type CreateSessionRequest, type CreateToolRequest, type CreateUserRequest, type CreateWorkflowRequest, type CredentialSpec, type CronTriggerParams, DEFAULT_PORT, DataClient, type DispatchMeetingBotRequest, type DisplayOptions, ERROR_PORT, type EditContentRequest, type EditContentResponse, type EmptyPayload, 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, FunctionsClient, type GetExecutionDetailResponse, type GetGraphOptions, type GetNodeExecutionItemsOptions, type GetNodeExecutionItemsResponse, type GetNodeTypesResponse, type GraphService, type InlineLinkRequest, type InstallConnectionResponse, type InstallConnectorConnectionResponse, 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 ListConversationsQuery, type ListEventsOptions, type ListExecutionsOptions, type ListLabelsOptions, type ListLinksOptions, type ListMcpServersOptions, type ListMessagesQuery, type ListNodesOptions, ListOptions, type ListOrganizationsOptions, type ListParticipantsQuery, type ListPromptsOptions, type ListRecordLinksOptions, type ListRecordsOptions, type ListResponse$1 as ListResponse, ListResult, type ListRolePermissionsOptions, type ListRolesOptions, type ListRoomsQuery, type ListSessionsOptions, type ListSkillsOptions, type ListToolsOptions, 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 Message, type ContentBlock as MessageContentBlock, type MessageDirection, type MessageKickoff, type MessagePreview, type MessageRecipient, type MessageService, type MessageStatus, type MessageTriggerParams, 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 OutcomeKickoff, type OutcomeRubric, type OutlineHeading, type OutlineRequest, type OutlineResponse, PLATFORM_ENTITIES, PLATFORM_ENTITY_SLUGS, PageIterator, type PairedItem, type ParseStatus, type Participant, type ParticipantRef, type ParticipantSource, type Permission, type PlatformEntity, type PlatformEvent, type PortSpec, type Prompt, type PromptService, type PromptVersion, type PropertyOption, type PropertyType, ProteosClient, ProteosError, 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 RecordService, type RedriveResult, type ResultBlock, type Role, 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 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 Topic, type TopicKind, type TopicService, type TranscribeStreamOptions, type TranscriptResult, type TriggerKind, type Turn, type UnreadCounts, type UpdateAgentListenerRequest, type UpdateAgentRequest, type UpdateConnectionRequest, type UpdateConnectorConnectionRequest, type UpdateLabelRequest, type UpdateLinkRequest, type UpdateMcpServerRequest, type UpdateNodeRequest, type UpdateOrganizationRequest, type UpdatePromptRequest, type UpdateRoleRequest, type UpdateToolRequest, 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 WorkflowContentBlock, 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

@@ -1139,6 +1139,8 @@ var ConversationClient = class {
   messages;
   agentListeners;
   transcriptions;
+  /** Meeting bots (Ava): dispatch into a meeting URL, remove from a meeting. */
+  meetings;
   /** Realtime speech-to-text (dictation) — moved here from agent-service. */
   voice;
   constructor(client) {
@@ -1147,9 +1149,22 @@ var ConversationClient = class {
     this.messages = new MessageServiceImpl(client);
     this.agentListeners = new AgentListenerServiceImpl(client);
     this.transcriptions = new TranscriptionServiceImpl(client);
+    this.meetings = new MeetingServiceImpl(client);
     this.voice = new VoiceServiceImpl(client);
   }
 };
+var MeetingServiceImpl = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  dispatch(request) {
+    return this.client.request("POST", `${CONVERSATION_BASE_PATH}/meetings`, request);
+  }
+  remove(conversationId) {
+    return this.client.request("DELETE", `${CONVERSATION_BASE_PATH}/meetings/${encodeURIComponent(conversationId)}`);
+  }
+};
 var ConnectionServiceImpl = class {
   constructor(client) {
     this.client = client;