@proteos/sdk 0.37.0 → 0.39.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -54,6 +54,8 @@ interface Agent extends AuditFields {
54
54
  tools: string[];
55
55
  subagents: string[];
56
56
  mcp_servers: string[];
57
+ /** Toolset keys (platform or custom) attached as whole tool groups. */
58
+ toolsets: string[];
57
59
  /** Marks the single agent surfaced by default for the org (at most one). */
58
60
  is_org_default: boolean;
59
61
  version: number;
@@ -69,6 +71,7 @@ interface CreateAgentRequest {
69
71
  tools?: string[];
70
72
  subagents?: string[];
71
73
  mcp_servers?: string[];
74
+ toolsets?: string[];
72
75
  is_org_default?: boolean;
73
76
  }
74
77
  interface UpdateAgentRequest {
@@ -81,6 +84,7 @@ interface UpdateAgentRequest {
81
84
  tools?: string[];
82
85
  subagents?: string[];
83
86
  mcp_servers?: string[];
87
+ toolsets?: string[];
84
88
  is_org_default?: boolean;
85
89
  }
86
90
  type ListAgentsOptions = AgentResourceListOptions;
@@ -176,8 +180,10 @@ type ListSkillsOptions = AgentResourceListOptions;
176
180
  * - `action` binds to a function-service Action.
177
181
  * - `mcp` binds to one tool on a registered {@link McpServer}.
178
182
  * - `client` is a host-provided builtin and carries no binding.
183
+ * - `platform` binds to one tool of the platform MCP server (mcp-service),
184
+ * executed server-side as the acting user.
179
185
  */
180
- type ToolKind = 'action' | 'mcp' | 'client';
186
+ type ToolKind = 'action' | 'mcp' | 'client' | 'platform';
181
187
  /** Binds to a function-service Action by its key (kind=action). */
182
188
  interface ActionBinding {
183
189
  action_key: string;
@@ -187,8 +193,16 @@ interface McpBinding {
187
193
  server_key: string;
188
194
  tool_name: string;
189
195
  }
196
+ /**
197
+ * Binds to one tool of the platform MCP server (kind=platform). `toolset` pins
198
+ * the server mount the tool lives in.
199
+ */
200
+ interface PlatformBinding {
201
+ toolset: string;
202
+ tool_name: string;
203
+ }
190
204
  /** Kind-discriminated binding payload. `kind=client` carries no binding. */
191
- type ToolBinding = ActionBinding | McpBinding;
205
+ type ToolBinding = ActionBinding | McpBinding | PlatformBinding;
192
206
  /**
193
207
  * A thin registry entry over one of three binding sources. `key` is the wire
194
208
  * name the model calls (`tool_use.name`) and what `Agent.tools` lists.
@@ -229,6 +243,55 @@ interface ListToolsOptions extends AgentResourceListOptions {
229
243
  /** Filter by binding source. */
230
244
  kind?: ToolKind;
231
245
  }
246
+ /**
247
+ * Toolset origin: `platform` toolsets are the hardcoded groups of the platform
248
+ * MCP server (read-only, one per server mount); `custom` toolsets are
249
+ * org-authored groups of the org's own {@link Tool} rows.
250
+ */
251
+ type ToolsetKind = 'platform' | 'custom';
252
+ /**
253
+ * A named group of tools an agent attaches as one unit (`Agent.toolsets`).
254
+ * Platform and custom toolsets share one key namespace (platform keys are
255
+ * reserved). For platform toolsets `tools` is empty — the members live in
256
+ * mcp-service and are listed via `toolsets.listTools`; for custom toolsets it
257
+ * carries the member Tool keys. Keyed by (org_id, key).
258
+ */
259
+ interface Toolset extends AuditFields {
260
+ org_id: string;
261
+ key: string;
262
+ name: string;
263
+ module_slug: string;
264
+ description: string;
265
+ kind: ToolsetKind;
266
+ tools: string[];
267
+ version: number;
268
+ }
269
+ /** Creates a CUSTOM toolset — platform toolsets are hardcoded and read-only. */
270
+ interface CreateToolsetRequest {
271
+ key: string;
272
+ name: string;
273
+ module_slug?: string;
274
+ description?: string;
275
+ /** Member Tool keys; existence is validated on write. */
276
+ tools?: string[];
277
+ }
278
+ /** Fully replaces the custom toolset's definition (membership is a set). */
279
+ interface UpdateToolsetRequest {
280
+ name: string;
281
+ module_slug?: string;
282
+ description?: string;
283
+ tools?: string[];
284
+ }
285
+ interface ListToolsetsOptions extends AgentResourceListOptions {
286
+ /** Filter the merged listing by origin. */
287
+ kind?: ToolsetKind;
288
+ }
289
+ /** One tool inside a toolset, for pickers: the wire name + display metadata. */
290
+ interface ToolsetToolSummary {
291
+ name: string;
292
+ title?: string;
293
+ description?: string;
294
+ }
232
295
  /**
233
296
  * Auth config for reaching an MCP server. When `is_secret` is set, the bearer
234
297
  * `token` is secret-managed and redacted to `''` on read. For `type: 'oauth'` the
@@ -893,6 +956,34 @@ interface ToolService {
893
956
  syncDependents(key: string): Promise<DependentSyncResult[]>;
894
957
  }
895
958
 
959
+ /**
960
+ * Service for managing Toolsets — the hardcoded platform toolsets (read-only)
961
+ * merged with the org's custom groups of its own tools. Writes apply to custom
962
+ * toolsets only; a platform key is rejected with `toolset_read_only`.
963
+ */
964
+ interface ToolsetService {
965
+ /** Lists toolsets (platform + custom merged), auto-paginating. Filterable by `kind`. */
966
+ list(options?: ListToolsetsOptions): PageIterator<Toolset, ListToolsetsOptions>;
967
+ /** Fetches a single page of toolsets with pagination metadata. */
968
+ listPage(options?: ListToolsetsOptions): Promise<ListResult<Toolset>>;
969
+ /** Gets a single toolset by key (platform or custom). @throws {ProteosError} 404. */
970
+ get(key: string): Promise<Toolset>;
971
+ /**
972
+ * Lists the tools inside a toolset — platform members proxied from the
973
+ * platform MCP server, custom members summarized from the org's Tool rows.
974
+ * @throws {ProteosError} 404.
975
+ */
976
+ listTools(key: string): Promise<ToolsetToolSummary[]>;
977
+ /** Creates a custom toolset. @throws {ProteosError} 400/409. */
978
+ create(request: CreateToolsetRequest): Promise<Toolset>;
979
+ /** Fully replaces a custom toolset's definition. @throws {ProteosError} 404/400. */
980
+ update(key: string, request: UpdateToolsetRequest): Promise<Toolset>;
981
+ /** Creates or fully replaces a custom toolset (idempotent deploy entry point). */
982
+ upsert(key: string, request: CreateToolsetRequest): Promise<Toolset>;
983
+ /** Deletes a custom toolset. @throws {ProteosError} 404/400. */
984
+ delete(key: string): Promise<void>;
985
+ }
986
+
896
987
  /**
897
988
  * Client for the Proteos Agent Service API.
898
989
  *
@@ -920,6 +1011,8 @@ declare class AgentClient {
920
1011
  readonly skills: SkillService;
921
1012
  /** Service for managing tools. */
922
1013
  readonly tools: ToolService;
1014
+ /** Service for managing toolsets (platform + custom tool groups). */
1015
+ readonly toolsets: ToolsetService;
923
1016
  /** Service for managing MCP server registrations. */
924
1017
  readonly mcpServers: McpServerService;
925
1018
  /** Service for managing chat sessions (conversations + event log + stream). */
@@ -2373,6 +2466,13 @@ interface AgentListenerAcknowledgementConfig {
2373
2466
  /** Message type: the acknowledgement text. */
2374
2467
  text?: string;
2375
2468
  }
2469
+ /**
2470
+ * Where the dispatcher takes its acting user from: 'defined' (the listener's
2471
+ * stored acting_user — the default) or 'inferred' (the triggering message
2472
+ * sender's resolved platform user, with acting_user as OPTIONAL fallback — no
2473
+ * platform user and no fallback means the dispatch is skipped).
2474
+ */
2475
+ type AgentListenerActingUserMode = 'defined' | 'inferred';
2376
2476
  interface AgentListener {
2377
2477
  id: string;
2378
2478
  org_id: string;
@@ -2402,7 +2502,12 @@ interface AgentListener {
2402
2502
  */
2403
2503
  acknowledgement_type: AgentListenerAcknowledgementType;
2404
2504
  acknowledgement_config?: AgentListenerAcknowledgementConfig;
2405
- /** The user the dispatcher acts as when driving the agent. */
2505
+ acting_user_mode: AgentListenerActingUserMode;
2506
+ /**
2507
+ * The user the dispatcher acts as (mode 'defined'), or the optional fallback
2508
+ * when the sender has no platform user (mode 'inferred'; an empty ref means
2509
+ * no fallback).
2510
+ */
2406
2511
  acting_user: UserRef;
2407
2512
  is_enabled: boolean;
2408
2513
  /**
@@ -2513,8 +2618,14 @@ interface CreateAgentListenerRequest {
2513
2618
  */
2514
2619
  acknowledgement_type?: AgentListenerAcknowledgementType;
2515
2620
  acknowledgement_config?: AgentListenerAcknowledgementConfig;
2516
- /** A bare user id; the service wraps it into a person UserRef. */
2517
- acting_user_id: string;
2621
+ /** Omit to default to 'defined'. */
2622
+ acting_user_mode?: AgentListenerActingUserMode;
2623
+ /**
2624
+ * A bare user id; the service wraps it into a person UserRef. Required in
2625
+ * 'defined' mode (the default); optional in 'inferred' mode, where it is the
2626
+ * fallback when the sender has no platform user.
2627
+ */
2628
+ acting_user_id?: string;
2518
2629
  /** Omit to default to enabled. */
2519
2630
  is_enabled?: boolean;
2520
2631
  /**
@@ -2544,6 +2655,9 @@ interface UpdateAgentListenerRequest {
2544
2655
  */
2545
2656
  acknowledgement_type?: AgentListenerAcknowledgementType;
2546
2657
  acknowledgement_config?: AgentListenerAcknowledgementConfig;
2658
+ /** Switching to 'defined' requires an effective acting user (stored or in this request). */
2659
+ acting_user_mode?: AgentListenerActingUserMode;
2660
+ /** Pass "" to clear the user — only valid when the effective mode is 'inferred'. */
2547
2661
  acting_user_id?: string;
2548
2662
  is_enabled?: boolean;
2549
2663
  /** Toggle whether the platform auto-forwards the agent's text reply. */
@@ -6127,4 +6241,4 @@ declare class WorkflowClient {
6127
6241
  constructor(client: ProteosClient);
6128
6242
  }
6129
6243
 
6130
- 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 };
6244
+ 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 };
package/dist/index.d.ts CHANGED
@@ -54,6 +54,8 @@ interface Agent extends AuditFields {
54
54
  tools: string[];
55
55
  subagents: string[];
56
56
  mcp_servers: string[];
57
+ /** Toolset keys (platform or custom) attached as whole tool groups. */
58
+ toolsets: string[];
57
59
  /** Marks the single agent surfaced by default for the org (at most one). */
58
60
  is_org_default: boolean;
59
61
  version: number;
@@ -69,6 +71,7 @@ interface CreateAgentRequest {
69
71
  tools?: string[];
70
72
  subagents?: string[];
71
73
  mcp_servers?: string[];
74
+ toolsets?: string[];
72
75
  is_org_default?: boolean;
73
76
  }
74
77
  interface UpdateAgentRequest {
@@ -81,6 +84,7 @@ interface UpdateAgentRequest {
81
84
  tools?: string[];
82
85
  subagents?: string[];
83
86
  mcp_servers?: string[];
87
+ toolsets?: string[];
84
88
  is_org_default?: boolean;
85
89
  }
86
90
  type ListAgentsOptions = AgentResourceListOptions;
@@ -176,8 +180,10 @@ type ListSkillsOptions = AgentResourceListOptions;
176
180
  * - `action` binds to a function-service Action.
177
181
  * - `mcp` binds to one tool on a registered {@link McpServer}.
178
182
  * - `client` is a host-provided builtin and carries no binding.
183
+ * - `platform` binds to one tool of the platform MCP server (mcp-service),
184
+ * executed server-side as the acting user.
179
185
  */
180
- type ToolKind = 'action' | 'mcp' | 'client';
186
+ type ToolKind = 'action' | 'mcp' | 'client' | 'platform';
181
187
  /** Binds to a function-service Action by its key (kind=action). */
182
188
  interface ActionBinding {
183
189
  action_key: string;
@@ -187,8 +193,16 @@ interface McpBinding {
187
193
  server_key: string;
188
194
  tool_name: string;
189
195
  }
196
+ /**
197
+ * Binds to one tool of the platform MCP server (kind=platform). `toolset` pins
198
+ * the server mount the tool lives in.
199
+ */
200
+ interface PlatformBinding {
201
+ toolset: string;
202
+ tool_name: string;
203
+ }
190
204
  /** Kind-discriminated binding payload. `kind=client` carries no binding. */
191
- type ToolBinding = ActionBinding | McpBinding;
205
+ type ToolBinding = ActionBinding | McpBinding | PlatformBinding;
192
206
  /**
193
207
  * A thin registry entry over one of three binding sources. `key` is the wire
194
208
  * name the model calls (`tool_use.name`) and what `Agent.tools` lists.
@@ -229,6 +243,55 @@ interface ListToolsOptions extends AgentResourceListOptions {
229
243
  /** Filter by binding source. */
230
244
  kind?: ToolKind;
231
245
  }
246
+ /**
247
+ * Toolset origin: `platform` toolsets are the hardcoded groups of the platform
248
+ * MCP server (read-only, one per server mount); `custom` toolsets are
249
+ * org-authored groups of the org's own {@link Tool} rows.
250
+ */
251
+ type ToolsetKind = 'platform' | 'custom';
252
+ /**
253
+ * A named group of tools an agent attaches as one unit (`Agent.toolsets`).
254
+ * Platform and custom toolsets share one key namespace (platform keys are
255
+ * reserved). For platform toolsets `tools` is empty — the members live in
256
+ * mcp-service and are listed via `toolsets.listTools`; for custom toolsets it
257
+ * carries the member Tool keys. Keyed by (org_id, key).
258
+ */
259
+ interface Toolset extends AuditFields {
260
+ org_id: string;
261
+ key: string;
262
+ name: string;
263
+ module_slug: string;
264
+ description: string;
265
+ kind: ToolsetKind;
266
+ tools: string[];
267
+ version: number;
268
+ }
269
+ /** Creates a CUSTOM toolset — platform toolsets are hardcoded and read-only. */
270
+ interface CreateToolsetRequest {
271
+ key: string;
272
+ name: string;
273
+ module_slug?: string;
274
+ description?: string;
275
+ /** Member Tool keys; existence is validated on write. */
276
+ tools?: string[];
277
+ }
278
+ /** Fully replaces the custom toolset's definition (membership is a set). */
279
+ interface UpdateToolsetRequest {
280
+ name: string;
281
+ module_slug?: string;
282
+ description?: string;
283
+ tools?: string[];
284
+ }
285
+ interface ListToolsetsOptions extends AgentResourceListOptions {
286
+ /** Filter the merged listing by origin. */
287
+ kind?: ToolsetKind;
288
+ }
289
+ /** One tool inside a toolset, for pickers: the wire name + display metadata. */
290
+ interface ToolsetToolSummary {
291
+ name: string;
292
+ title?: string;
293
+ description?: string;
294
+ }
232
295
  /**
233
296
  * Auth config for reaching an MCP server. When `is_secret` is set, the bearer
234
297
  * `token` is secret-managed and redacted to `''` on read. For `type: 'oauth'` the
@@ -893,6 +956,34 @@ interface ToolService {
893
956
  syncDependents(key: string): Promise<DependentSyncResult[]>;
894
957
  }
895
958
 
959
+ /**
960
+ * Service for managing Toolsets — the hardcoded platform toolsets (read-only)
961
+ * merged with the org's custom groups of its own tools. Writes apply to custom
962
+ * toolsets only; a platform key is rejected with `toolset_read_only`.
963
+ */
964
+ interface ToolsetService {
965
+ /** Lists toolsets (platform + custom merged), auto-paginating. Filterable by `kind`. */
966
+ list(options?: ListToolsetsOptions): PageIterator<Toolset, ListToolsetsOptions>;
967
+ /** Fetches a single page of toolsets with pagination metadata. */
968
+ listPage(options?: ListToolsetsOptions): Promise<ListResult<Toolset>>;
969
+ /** Gets a single toolset by key (platform or custom). @throws {ProteosError} 404. */
970
+ get(key: string): Promise<Toolset>;
971
+ /**
972
+ * Lists the tools inside a toolset — platform members proxied from the
973
+ * platform MCP server, custom members summarized from the org's Tool rows.
974
+ * @throws {ProteosError} 404.
975
+ */
976
+ listTools(key: string): Promise<ToolsetToolSummary[]>;
977
+ /** Creates a custom toolset. @throws {ProteosError} 400/409. */
978
+ create(request: CreateToolsetRequest): Promise<Toolset>;
979
+ /** Fully replaces a custom toolset's definition. @throws {ProteosError} 404/400. */
980
+ update(key: string, request: UpdateToolsetRequest): Promise<Toolset>;
981
+ /** Creates or fully replaces a custom toolset (idempotent deploy entry point). */
982
+ upsert(key: string, request: CreateToolsetRequest): Promise<Toolset>;
983
+ /** Deletes a custom toolset. @throws {ProteosError} 404/400. */
984
+ delete(key: string): Promise<void>;
985
+ }
986
+
896
987
  /**
897
988
  * Client for the Proteos Agent Service API.
898
989
  *
@@ -920,6 +1011,8 @@ declare class AgentClient {
920
1011
  readonly skills: SkillService;
921
1012
  /** Service for managing tools. */
922
1013
  readonly tools: ToolService;
1014
+ /** Service for managing toolsets (platform + custom tool groups). */
1015
+ readonly toolsets: ToolsetService;
923
1016
  /** Service for managing MCP server registrations. */
924
1017
  readonly mcpServers: McpServerService;
925
1018
  /** Service for managing chat sessions (conversations + event log + stream). */
@@ -2373,6 +2466,13 @@ interface AgentListenerAcknowledgementConfig {
2373
2466
  /** Message type: the acknowledgement text. */
2374
2467
  text?: string;
2375
2468
  }
2469
+ /**
2470
+ * Where the dispatcher takes its acting user from: 'defined' (the listener's
2471
+ * stored acting_user — the default) or 'inferred' (the triggering message
2472
+ * sender's resolved platform user, with acting_user as OPTIONAL fallback — no
2473
+ * platform user and no fallback means the dispatch is skipped).
2474
+ */
2475
+ type AgentListenerActingUserMode = 'defined' | 'inferred';
2376
2476
  interface AgentListener {
2377
2477
  id: string;
2378
2478
  org_id: string;
@@ -2402,7 +2502,12 @@ interface AgentListener {
2402
2502
  */
2403
2503
  acknowledgement_type: AgentListenerAcknowledgementType;
2404
2504
  acknowledgement_config?: AgentListenerAcknowledgementConfig;
2405
- /** The user the dispatcher acts as when driving the agent. */
2505
+ acting_user_mode: AgentListenerActingUserMode;
2506
+ /**
2507
+ * The user the dispatcher acts as (mode 'defined'), or the optional fallback
2508
+ * when the sender has no platform user (mode 'inferred'; an empty ref means
2509
+ * no fallback).
2510
+ */
2406
2511
  acting_user: UserRef;
2407
2512
  is_enabled: boolean;
2408
2513
  /**
@@ -2513,8 +2618,14 @@ interface CreateAgentListenerRequest {
2513
2618
  */
2514
2619
  acknowledgement_type?: AgentListenerAcknowledgementType;
2515
2620
  acknowledgement_config?: AgentListenerAcknowledgementConfig;
2516
- /** A bare user id; the service wraps it into a person UserRef. */
2517
- acting_user_id: string;
2621
+ /** Omit to default to 'defined'. */
2622
+ acting_user_mode?: AgentListenerActingUserMode;
2623
+ /**
2624
+ * A bare user id; the service wraps it into a person UserRef. Required in
2625
+ * 'defined' mode (the default); optional in 'inferred' mode, where it is the
2626
+ * fallback when the sender has no platform user.
2627
+ */
2628
+ acting_user_id?: string;
2518
2629
  /** Omit to default to enabled. */
2519
2630
  is_enabled?: boolean;
2520
2631
  /**
@@ -2544,6 +2655,9 @@ interface UpdateAgentListenerRequest {
2544
2655
  */
2545
2656
  acknowledgement_type?: AgentListenerAcknowledgementType;
2546
2657
  acknowledgement_config?: AgentListenerAcknowledgementConfig;
2658
+ /** Switching to 'defined' requires an effective acting user (stored or in this request). */
2659
+ acting_user_mode?: AgentListenerActingUserMode;
2660
+ /** Pass "" to clear the user — only valid when the effective mode is 'inferred'. */
2547
2661
  acting_user_id?: string;
2548
2662
  is_enabled?: boolean;
2549
2663
  /** Toggle whether the platform auto-forwards the agent's text reply. */
@@ -6127,4 +6241,4 @@ declare class WorkflowClient {
6127
6241
  constructor(client: ProteosClient);
6128
6242
  }
6129
6243
 
6130
- 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 };
6244
+ 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 };
package/dist/index.js CHANGED
@@ -340,6 +340,43 @@ var ToolServiceImpl = class {
340
340
  }
341
341
  };
342
342
 
343
+ // src/agent/toolsets.ts
344
+ var TOOLSETS_BASE_PATH = "/agents/v1/toolsets";
345
+ var ToolsetServiceImpl = class {
346
+ constructor(client) {
347
+ this.client = client;
348
+ }
349
+ client;
350
+ list(options = {}) {
351
+ return new PageIterator((opts) => this.listPage(opts), options);
352
+ }
353
+ async listPage(options = {}) {
354
+ return this.client.requestWithQuery("GET", TOOLSETS_BASE_PATH, options);
355
+ }
356
+ async get(key) {
357
+ return this.client.request("GET", `${TOOLSETS_BASE_PATH}/${key}`);
358
+ }
359
+ async listTools(key) {
360
+ const response = await this.client.request(
361
+ "GET",
362
+ `${TOOLSETS_BASE_PATH}/${key}/tools`
363
+ );
364
+ return response.data;
365
+ }
366
+ async create(request) {
367
+ return this.client.request("POST", TOOLSETS_BASE_PATH, request);
368
+ }
369
+ async update(key, request) {
370
+ return this.client.request("PATCH", `${TOOLSETS_BASE_PATH}/${key}`, request);
371
+ }
372
+ async upsert(key, request) {
373
+ return this.client.request("PUT", `${TOOLSETS_BASE_PATH}/${key}`, request);
374
+ }
375
+ async delete(key) {
376
+ await this.client.request("DELETE", `${TOOLSETS_BASE_PATH}/${key}`);
377
+ }
378
+ };
379
+
343
380
  // src/agent/index.ts
344
381
  var AgentClient = class {
345
382
  /** Service for managing agents. */
@@ -350,6 +387,8 @@ var AgentClient = class {
350
387
  skills;
351
388
  /** Service for managing tools. */
352
389
  tools;
390
+ /** Service for managing toolsets (platform + custom tool groups). */
391
+ toolsets;
353
392
  /** Service for managing MCP server registrations. */
354
393
  mcpServers;
355
394
  /** Service for managing chat sessions (conversations + event log + stream). */
@@ -364,6 +403,7 @@ var AgentClient = class {
364
403
  this.prompts = new PromptServiceImpl(client);
365
404
  this.skills = new SkillServiceImpl(client);
366
405
  this.tools = new ToolServiceImpl(client);
406
+ this.toolsets = new ToolsetServiceImpl(client);
367
407
  this.mcpServers = new McpServerServiceImpl(client);
368
408
  this.sessions = new SessionServiceImpl(client);
369
409
  }
@@ -571,6 +611,7 @@ var PLATFORM_ENTITIES = [
571
611
  { slug: "prompts", name: "Prompts" },
572
612
  { slug: "skills", name: "Skills" },
573
613
  { slug: "tools", name: "Tools" },
614
+ { slug: "toolsets", name: "Toolsets" },
574
615
  { slug: "mcp-servers", name: "MCP Servers" },
575
616
  { slug: "agent-sessions", name: "Agent Sessions" },
576
617
  // Messaging bus (event-service)