@proteos/sdk 0.38.0 → 0.40.0

package/dist/index.d.ts

@@ -54,6 +54,8 @@ interface Agent extends AuditFields {
     tools: string[];
     subagents: string[];
     mcp_servers: string[];
+    /** Toolset keys (platform or custom) attached as whole tool groups. */
+    toolsets: string[];
     /** Marks the single agent surfaced by default for the org (at most one). */
     is_org_default: boolean;
     version: number;
@@ -69,6 +71,7 @@ interface CreateAgentRequest {
     tools?: string[];
     subagents?: string[];
     mcp_servers?: string[];
+    toolsets?: string[];
     is_org_default?: boolean;
 }
 interface UpdateAgentRequest {
@@ -81,6 +84,7 @@ interface UpdateAgentRequest {
     tools?: string[];
     subagents?: string[];
     mcp_servers?: string[];
+    toolsets?: string[];
     is_org_default?: boolean;
 }
 type ListAgentsOptions = AgentResourceListOptions;
@@ -176,8 +180,12 @@ type ListSkillsOptions = AgentResourceListOptions;
  * - `action` binds to a function-service Action.
  * - `mcp` binds to one tool on a registered {@link McpServer}.
  * - `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';
+type ToolKind = 'action' | 'mcp' | 'client' | 'platform' | 'query';
 /** Binds to a function-service Action by its key (kind=action). */
 interface ActionBinding {
     action_key: string;
@@ -187,8 +195,26 @@ interface McpBinding {
     server_key: string;
     tool_name: string;
 }
+/**
+ * Binds to one tool of the platform MCP server (kind=platform). `toolset` pins
+ * the server mount the tool lives in.
+ */
+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;
+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.
@@ -229,6 +255,55 @@ interface ListToolsOptions extends AgentResourceListOptions {
     /** Filter by binding source. */
     kind?: ToolKind;
 }
+/**
+ * Toolset origin: `platform` toolsets are the hardcoded groups of the platform
+ * MCP server (read-only, one per server mount); `custom` toolsets are
+ * org-authored groups of the org's own {@link Tool} rows.
+ */
+type ToolsetKind = 'platform' | 'custom';
+/**
+ * A named group of tools an agent attaches as one unit (`Agent.toolsets`).
+ * Platform and custom toolsets share one key namespace (platform keys are
+ * reserved). For platform toolsets `tools` is empty — the members live in
+ * mcp-service and are listed via `toolsets.listTools`; for custom toolsets it
+ * carries the member Tool keys. Keyed by (org_id, key).
+ */
+interface Toolset extends AuditFields {
+    org_id: string;
+    key: string;
+    name: string;
+    module_slug: string;
+    description: string;
+    kind: ToolsetKind;
+    tools: string[];
+    version: number;
+}
+/** Creates a CUSTOM toolset — platform toolsets are hardcoded and read-only. */
+interface CreateToolsetRequest {
+    key: string;
+    name: string;
+    module_slug?: string;
+    description?: string;
+    /** Member Tool keys; existence is validated on write. */
+    tools?: string[];
+}
+/** Fully replaces the custom toolset's definition (membership is a set). */
+interface UpdateToolsetRequest {
+    name: string;
+    module_slug?: string;
+    description?: string;
+    tools?: string[];
+}
+interface ListToolsetsOptions extends AgentResourceListOptions {
+    /** Filter the merged listing by origin. */
+    kind?: ToolsetKind;
+}
+/** One tool inside a toolset, for pickers: the wire name + display metadata. */
+interface ToolsetToolSummary {
+    name: string;
+    title?: string;
+    description?: string;
+}
 /**
  * Auth config for reaching an MCP server. When `is_secret` is set, the bearer
  * `token` is secret-managed and redacted to `''` on read. For `type: 'oauth'` the
@@ -576,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;
@@ -893,6 +975,34 @@ interface ToolService {
     syncDependents(key: string): Promise<DependentSyncResult[]>;
 }
 
+/**
+ * Service for managing Toolsets — the hardcoded platform toolsets (read-only)
+ * merged with the org's custom groups of its own tools. Writes apply to custom
+ * toolsets only; a platform key is rejected with `toolset_read_only`.
+ */
+interface ToolsetService {
+    /** Lists toolsets (platform + custom merged), auto-paginating. Filterable by `kind`. */
+    list(options?: ListToolsetsOptions): PageIterator<Toolset, ListToolsetsOptions>;
+    /** Fetches a single page of toolsets with pagination metadata. */
+    listPage(options?: ListToolsetsOptions): Promise<ListResult<Toolset>>;
+    /** Gets a single toolset by key (platform or custom). @throws {ProteosError} 404. */
+    get(key: string): Promise<Toolset>;
+    /**
+     * Lists the tools inside a toolset — platform members proxied from the
+     * platform MCP server, custom members summarized from the org's Tool rows.
+     * @throws {ProteosError} 404.
+     */
+    listTools(key: string): Promise<ToolsetToolSummary[]>;
+    /** Creates a custom toolset. @throws {ProteosError} 400/409. */
+    create(request: CreateToolsetRequest): Promise<Toolset>;
+    /** Fully replaces a custom toolset's definition. @throws {ProteosError} 404/400. */
+    update(key: string, request: UpdateToolsetRequest): Promise<Toolset>;
+    /** Creates or fully replaces a custom toolset (idempotent deploy entry point). */
+    upsert(key: string, request: CreateToolsetRequest): Promise<Toolset>;
+    /** Deletes a custom toolset. @throws {ProteosError} 404/400. */
+    delete(key: string): Promise<void>;
+}
+
 /**
  * Client for the Proteos Agent Service API.
  *
@@ -920,6 +1030,8 @@ declare class AgentClient {
     readonly skills: SkillService;
     /** Service for managing tools. */
     readonly tools: ToolService;
+    /** Service for managing toolsets (platform + custom tool groups). */
+    readonly toolsets: ToolsetService;
     /** Service for managing MCP server registrations. */
     readonly mcpServers: McpServerService;
     /** Service for managing chat sessions (conversations + event log + stream). */
@@ -2373,6 +2485,13 @@ interface AgentListenerAcknowledgementConfig {
     /** Message type: the acknowledgement text. */
     text?: string;
 }
+/**
+ * Where the dispatcher takes its acting user from: 'defined' (the listener's
+ * stored acting_user — the default) or 'inferred' (the triggering message
+ * sender's resolved platform user, with acting_user as OPTIONAL fallback — no
+ * platform user and no fallback means the dispatch is skipped).
+ */
+type AgentListenerActingUserMode = 'defined' | 'inferred';
 interface AgentListener {
     id: string;
     org_id: string;
@@ -2402,7 +2521,12 @@ interface AgentListener {
      */
     acknowledgement_type: AgentListenerAcknowledgementType;
     acknowledgement_config?: AgentListenerAcknowledgementConfig;
-    /** The user the dispatcher acts as when driving the agent. */
+    acting_user_mode: AgentListenerActingUserMode;
+    /**
+     * The user the dispatcher acts as (mode 'defined'), or the optional fallback
+     * when the sender has no platform user (mode 'inferred'; an empty ref means
+     * no fallback).
+     */
     acting_user: UserRef;
     is_enabled: boolean;
     /**
@@ -2513,8 +2637,14 @@ interface CreateAgentListenerRequest {
      */
     acknowledgement_type?: AgentListenerAcknowledgementType;
     acknowledgement_config?: AgentListenerAcknowledgementConfig;
-    /** A bare user id; the service wraps it into a person UserRef. */
-    acting_user_id: string;
+    /** Omit to default to 'defined'. */
+    acting_user_mode?: AgentListenerActingUserMode;
+    /**
+     * A bare user id; the service wraps it into a person UserRef. Required in
+     * 'defined' mode (the default); optional in 'inferred' mode, where it is the
+     * fallback when the sender has no platform user.
+     */
+    acting_user_id?: string;
     /** Omit to default to enabled. */
     is_enabled?: boolean;
     /**
@@ -2544,6 +2674,9 @@ interface UpdateAgentListenerRequest {
      */
     acknowledgement_type?: AgentListenerAcknowledgementType;
     acknowledgement_config?: AgentListenerAcknowledgementConfig;
+    /** Switching to 'defined' requires an effective acting user (stored or in this request). */
+    acting_user_mode?: AgentListenerActingUserMode;
+    /** Pass "" to clear the user — only valid when the effective mode is 'inferred'. */
     acting_user_id?: string;
     is_enabled?: boolean;
     /** Toggle whether the platform auto-forwards the agent's text reply. */
@@ -2647,6 +2780,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;
@@ -2696,14 +2839,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';
@@ -2728,13 +2883,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;
@@ -3240,7 +3405,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>;
     /**
@@ -3282,6 +3454,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. */
@@ -6127,4 +6304,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 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 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 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 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 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 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 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 };

package/dist/index.js

@@ -340,6 +340,43 @@ var ToolServiceImpl = class {
   }
 };
 
+// src/agent/toolsets.ts
+var TOOLSETS_BASE_PATH = "/agents/v1/toolsets";
+var ToolsetServiceImpl = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  list(options = {}) {
+    return new PageIterator((opts) => this.listPage(opts), options);
+  }
+  async listPage(options = {}) {
+    return this.client.requestWithQuery("GET", TOOLSETS_BASE_PATH, options);
+  }
+  async get(key) {
+    return this.client.request("GET", `${TOOLSETS_BASE_PATH}/${key}`);
+  }
+  async listTools(key) {
+    const response = await this.client.request(
+      "GET",
+      `${TOOLSETS_BASE_PATH}/${key}/tools`
+    );
+    return response.data;
+  }
+  async create(request) {
+    return this.client.request("POST", TOOLSETS_BASE_PATH, request);
+  }
+  async update(key, request) {
+    return this.client.request("PATCH", `${TOOLSETS_BASE_PATH}/${key}`, request);
+  }
+  async upsert(key, request) {
+    return this.client.request("PUT", `${TOOLSETS_BASE_PATH}/${key}`, request);
+  }
+  async delete(key) {
+    await this.client.request("DELETE", `${TOOLSETS_BASE_PATH}/${key}`);
+  }
+};
+
 // src/agent/index.ts
 var AgentClient = class {
   /** Service for managing agents. */
@@ -350,6 +387,8 @@ var AgentClient = class {
   skills;
   /** Service for managing tools. */
   tools;
+  /** Service for managing toolsets (platform + custom tool groups). */
+  toolsets;
   /** Service for managing MCP server registrations. */
   mcpServers;
   /** Service for managing chat sessions (conversations + event log + stream). */
@@ -364,6 +403,7 @@ var AgentClient = class {
     this.prompts = new PromptServiceImpl(client);
     this.skills = new SkillServiceImpl(client);
     this.tools = new ToolServiceImpl(client);
+    this.toolsets = new ToolsetServiceImpl(client);
     this.mcpServers = new McpServerServiceImpl(client);
     this.sessions = new SessionServiceImpl(client);
   }
@@ -571,6 +611,7 @@ var PLATFORM_ENTITIES = [
   { slug: "prompts", name: "Prompts" },
   { slug: "skills", name: "Skills" },
   { slug: "tools", name: "Tools" },
+  { slug: "toolsets", name: "Toolsets" },
   { slug: "mcp-servers", name: "MCP Servers" },
   { slug: "agent-sessions", name: "Agent Sessions" },
   // Messaging bus (event-service)
@@ -1340,10 +1381,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) {
@@ -1495,6 +1537,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",