@getsupervisor/agents-studio-sdk 1.41.0 → 1.41.2-patch.1

package/dist/index.d.ts

@@ -409,6 +409,7 @@ type components = {
             auth: 'none' | 'oauth2' | 'api_key' | 'custom';
             requiresUserAuth: boolean;
             configSchema?: components['schemas']['ToolConfigSchema'] | null;
+            catalogMetadata: components['schemas']['ToolCatalogMetadata'];
         };
         ToolListResponse: {
             data: components['schemas']['ToolSummary'][];
@@ -452,6 +453,7 @@ type components = {
             message?: string;
         };
         ToolConnectionRequest: {
+            connectionKey?: string;
             agentId: string;
             metadata?: {
                 [key: string]: unknown;
@@ -459,7 +461,7 @@ type components = {
             auth?: components['schemas']['ToolConnectionAuth'];
         };
         ToolConnectionResponse: {
-            status: 'connected' | 'pending' | 'error';
+            status: 'connected' | 'pending' | 'error' | 'revoked';
             toolAgentConnectionId?: string | null;
             toolId: string;
             workspaceId: string;
@@ -472,7 +474,7 @@ type components = {
             };
         };
         ToolConnectionAuth: {
-            type: 'none' | 'oauth2' | 'api_key';
+            type: 'none' | 'oauth2' | 'api_key' | 'custom';
             data?: {
                 [key: string]: unknown;
             };
@@ -495,6 +497,7 @@ type components = {
             toolId: string;
             toolAgentConnectionId?: string | null;
             providerRef?: string | null;
+            toolExecutionId: string;
             message?: string | null;
         };
         CatalogItemLinks: {
@@ -545,6 +548,8 @@ type components = {
             code: string;
             message: string;
             details?: {
+                subcode?: string;
+                workspaceId?: string;
                 [key: string]: unknown;
             };
         };
@@ -692,6 +697,14 @@ type components = {
         CreateApiKeyResponse: components['schemas']['ApiKeySummary'] & {
             key: string;
         };
+        WorkspaceSummary: {
+            id: string;
+            name: string;
+        };
+        WorkspaceListResponse: {
+            data: components['schemas']['WorkspaceSummary'][];
+            meta: components['schemas']['PaginationMeta'];
+        };
         ToolConfigSchemaActionPrompts: {
             assistant?: string;
             user?: string;
@@ -715,6 +728,79 @@ type components = {
                 [key: string]: components['schemas']['ToolConfigSchemaAction'];
             };
         };
+        ToolCatalogAuthor: {
+            name: string;
+            url?: string | null;
+        };
+        ToolCatalogMedia: {
+            iconUrl: string | null;
+            coverImageUrl: string | null;
+        };
+        ToolCatalogDescription: {
+            short: string | null;
+            markdown: string | null;
+        };
+        ToolCatalogInstallation: {
+            requirements: string[];
+            permissions: string[];
+            steps: string[];
+            notes: string[];
+        };
+        ToolCatalogAppliesTo: {
+            chat: boolean | null;
+            voice: boolean | null;
+        };
+        ToolCatalogLinks: {
+            docsUrl: string | null;
+            privacyUrl: string | null;
+            termsUrl: string | null;
+        };
+        ToolCatalogCard: {
+            author: components['schemas']['ToolCatalogAuthor'];
+            media: components['schemas']['ToolCatalogMedia'];
+            description: components['schemas']['ToolCatalogDescription'];
+            features: string[];
+            useCases: string[];
+            installation: components['schemas']['ToolCatalogInstallation'];
+            appliesTo: components['schemas']['ToolCatalogAppliesTo'];
+            links: components['schemas']['ToolCatalogLinks'];
+        };
+        ToolCatalogMetadata: {
+            version: 1;
+            i18n: {
+                [key: string]: components['schemas']['ToolCatalogCard'];
+            };
+        };
+        ToolConnectionListItem: {
+            toolAgentConnectionId: string;
+            toolId: string;
+            workspaceId: string;
+            agentId: string;
+            connectionKey: string;
+            status: 'connected' | 'pending' | 'error' | 'revoked';
+            providerRef?: string | null;
+            descriptionUsage?: string | null;
+            usageExample?: string | null;
+        };
+        ToolConnectionListResponse: {
+            data: components['schemas']['ToolConnectionListItem'][];
+            meta: components['schemas']['PaginationMeta'];
+        };
+        CreateToolConnectionRequest: {
+            toolId: string;
+            agentId: string;
+            connectionKey?: string;
+            metadata?: {
+                [key: string]: unknown;
+            };
+            auth?: components['schemas']['ToolConnectionAuth'];
+        };
+        ExecuteToolConnectionRequest: {
+            action: string;
+            args?: {
+                [key: string]: unknown;
+            };
+        };
         CatalogItemLanguageMetadata: {
             code: string;
             locale?: string | null;
@@ -770,7 +856,9 @@ type components = {
         OrParam?: components['schemas']['QueryOrGroups'];
         ScheduleId: string;
         ApiKeyId: string;
+        XCacheRefresh?: boolean;
         IdempotencyKey: string;
+        XApiKey?: string;
     };
     requestBodies: never;
     headers: never;
@@ -839,6 +927,8 @@ type WorkspacePhonesResponse = components['schemas']['WorkspacePhonesResponse'];
 type WorkspacePhoneChannel = 'voice';
 type WorkspaceEnableRequest = components['schemas']['WorkspaceEnableRequest'];
 type WorkspaceEnableResponse = components['schemas']['WorkspaceEnableResponse'];
+type WorkspaceSummary = components['schemas']['WorkspaceSummary'];
+type WorkspaceListResponse = components['schemas']['WorkspaceListResponse'];
 type VoiceSummary = components['schemas']['VoiceSummary'];
 type VoiceListResponse = components['schemas']['VoiceListResponse'];
 type CatalogItemLinks = components['schemas']['CatalogItemLinks'];
@@ -1023,8 +1113,12 @@ type ToolResourceUploadRequest = components['schemas']['ToolResourceUploadReques
 type ToolResourceUploadResponse = components['schemas']['ToolResourceUploadResponse'];
 type ToolResourceReloadResponse = components['schemas']['ToolResourceReloadResponse'];
 type ToolConnectionAuth = components['schemas']['ToolConnectionAuth'];
+type CreateToolConnectionRequest = components['schemas']['CreateToolConnectionRequest'];
 type ToolConnectionRequest = components['schemas']['ToolConnectionRequest'];
 type ToolConnectionResponse = components['schemas']['ToolConnectionResponse'];
+type ToolConnectionListItem = components['schemas']['ToolConnectionListItem'];
+type ToolConnectionListResponse = components['schemas']['ToolConnectionListResponse'];
+type ExecuteToolConnectionRequest = components['schemas']['ExecuteToolConnectionRequest'];
 type ErrorResponse = components['schemas']['ErrorResponse'];
 type CampaignStatus = components['schemas']['CampaignStatus'];
 type Campaign = components['schemas']['Campaign'];
@@ -1042,13 +1136,17 @@ type EventSubscriptionListResponse = components['schemas']['EventSubscriptionLis
 type CreateEventSubscriptionRequest = components['schemas']['CreateEventSubscriptionRequest'];
 type UpdateEventSubscriptionRequest = components['schemas']['UpdateEventSubscriptionRequest'];
 
-declare class HttpError extends Error {
+declare class HttpError<TBody = unknown> extends Error {
     status: number;
     statusText: string;
-    body?: unknown;
+    body?: TBody;
     url?: string;
-    constructor(status: number, statusText: string, body?: unknown, url?: string);
+    constructor(status: number, statusText: string, body?: TBody, url?: string);
 }
+type ApiErrorBody = ErrorResponse;
+type ApiHttpError = HttpError<ApiErrorBody>;
+declare function isApiErrorBody(body: unknown): body is ApiErrorBody;
+declare function isApiHttpError(err: unknown): err is ApiHttpError;
 declare class TimeoutError extends Error {
     ms: number;
     url?: string;
@@ -1059,6 +1157,9 @@ declare class NetworkError extends Error {
     url?: string;
     constructor(cause?: unknown, url?: string);
 }
+declare class WorkspaceNotSelectedError extends Error {
+    constructor();
+}
 type RetryPolicy = {
     maxRetries?: number;
     baseDelayMs?: number;
@@ -1651,19 +1752,31 @@ type ListToolsOptions = ListQueryOptions & {
 type ListToolResourcesOptions = Pick<ListQueryOptions, 'page' | 'limit'> & {
     type?: 'document' | 'media' | 'file';
 };
+type ListToolConnectionsOptions = ListQueryOptions;
 type UploadToolResourcePayload = FormData | (Omit<ToolResourceUploadRequest, 'file'> & {
     file: unknown;
 });
 declare function createToolsApi(cfg: ClientConfig & {
     retry?: RetryPolicy;
 }): {
+    connections: {
+        readonly connect: (toolId: string, payload: ToolConnectionRequest, options?: IdempotentRequestOptions) => Promise<ToolConnectionResponse>;
+        readonly create: (payload: CreateToolConnectionRequest, options?: IdempotentRequestOptions) => Promise<ToolConnectionResponse>;
+        readonly execute: (toolAgentConnectionId: string, payload: ExecuteToolConnectionRequest, options?: IdempotentRequestOptions) => Promise<ExecuteToolResponse>;
+        readonly list: (options?: ListToolConnectionsOptions) => Promise<PaginatedResult<ToolConnectionListResponse, ListToolConnectionsOptions>>;
+        readonly createConnection: (payload: CreateToolConnectionRequest, options?: IdempotentRequestOptions) => Promise<ToolConnectionResponse>;
+        readonly executeConnection: (toolAgentConnectionId: string, payload: ExecuteToolConnectionRequest, options?: IdempotentRequestOptions) => Promise<ExecuteToolResponse>;
+    };
     list(options?: ListToolsOptions): Promise<PaginatedResult<ToolListResponse, ListToolsOptions>>;
     listResources(toolId: string, options?: ListToolResourcesOptions): Promise<PaginatedResult<ToolResourceListResponse, ListToolResourcesOptions>>;
+    listConnections(options?: ListToolConnectionsOptions): Promise<PaginatedResult<ToolConnectionListResponse, ListToolConnectionsOptions>>;
     uploadResource(toolId: string, payload: UploadToolResourcePayload): Promise<ToolResourceUploadResponse>;
     deleteResource(toolId: string, resourceId: string): Promise<void>;
     reloadResource(toolId: string, resourceId: string): Promise<ToolResourceReloadResponse>;
     execute(toolId: string, payload: ExecuteToolRequest, options?: IdempotentRequestOptions): Promise<ExecuteToolResponse>;
     connect(toolId: string, payload: ToolConnectionRequest, options?: IdempotentRequestOptions): Promise<ToolConnectionResponse>;
+    createConnection(payload: CreateToolConnectionRequest, options?: IdempotentRequestOptions): Promise<ToolConnectionResponse>;
+    executeConnection(toolAgentConnectionId: string, payload: ExecuteToolConnectionRequest, options?: IdempotentRequestOptions): Promise<ExecuteToolResponse>;
 };
 
 type ListVoicesOptions = ListQueryOptions & {
@@ -1699,9 +1812,13 @@ declare function createWebhooksApi(cfg: ClientConfig & {
 type ListWorkspacePhonesOptions = ListQueryOptions & {
     channel?: WorkspacePhoneChannel;
 };
+type ListWorkspacesOptions = ListQueryOptions & {
+    refreshCache?: boolean;
+};
 declare function createWorkspacesApi(cfg: ClientConfig & {
     retry?: RetryPolicy;
 }): {
+    list(options?: ListWorkspacesOptions): Promise<PaginatedResult<WorkspaceListResponse, ListWorkspacesOptions>>;
     listPhones(workspaceId: string, opts?: ListWorkspacePhonesOptions): Promise<PaginatedResult<WorkspacePhonesResponse, ListWorkspacePhonesOptions>>;
     enable(workspaceId: string, payload: WorkspaceEnableRequest): Promise<WorkspaceEnableResponse>;
 };
@@ -1796,12 +1913,32 @@ declare function createClient(initialCfg: ClientConfig & {
                 update(agentId: string, payload: UpdateAgentRequest): Promise<AgentEntity>;
             };
             workspaces: {
+                list(options?: ListWorkspacesOptions): Promise<PaginatedResult<WorkspaceListResponse, ListWorkspacesOptions>>;
                 listPhones(workspaceId: string, opts?: ListWorkspacePhonesOptions): Promise<PaginatedResult<WorkspacePhonesResponse, ListWorkspacePhonesOptions>>;
                 enable(workspaceId: string, payload: WorkspaceEnableRequest): Promise<WorkspaceEnableResponse>;
             };
             tools: {
+                connections: {
+                    readonly connect: (toolId: string, payload: ToolConnectionRequest, options?: {
+                        idempotencyKey?: string;
+                    }) => Promise<ToolConnectionResponse>;
+                    readonly create: (payload: CreateToolConnectionRequest, options?: {
+                        idempotencyKey?: string;
+                    }) => Promise<ToolConnectionResponse>;
+                    readonly execute: (toolAgentConnectionId: string, payload: ExecuteToolConnectionRequest, options?: {
+                        idempotencyKey?: string;
+                    }) => Promise<ExecuteToolResponse>;
+                    readonly list: (options?: ListToolConnectionsOptions) => Promise<PaginatedResult<ToolConnectionListResponse, ListToolConnectionsOptions>>;
+                    readonly createConnection: (payload: CreateToolConnectionRequest, options?: {
+                        idempotencyKey?: string;
+                    }) => Promise<ToolConnectionResponse>;
+                    readonly executeConnection: (toolAgentConnectionId: string, payload: ExecuteToolConnectionRequest, options?: {
+                        idempotencyKey?: string;
+                    }) => Promise<ExecuteToolResponse>;
+                };
                 list(options?: ListToolsOptions): Promise<PaginatedResult<ToolListResponse, ListToolsOptions>>;
                 listResources(toolId: string, options?: ListToolResourcesOptions): Promise<PaginatedResult<ToolResourceListResponse, ListToolResourcesOptions>>;
+                listConnections(options?: ListToolConnectionsOptions): Promise<PaginatedResult<ToolConnectionListResponse, ListToolConnectionsOptions>>;
                 uploadResource(toolId: string, payload: FormData | (Omit<{
                     file: string;
                     type?: "document" | "media" | "file";
@@ -1820,6 +1957,12 @@ declare function createClient(initialCfg: ClientConfig & {
                 connect(toolId: string, payload: ToolConnectionRequest, options?: {
                     idempotencyKey?: string;
                 }): Promise<ToolConnectionResponse>;
+                createConnection(payload: CreateToolConnectionRequest, options?: {
+                    idempotencyKey?: string;
+                }): Promise<ToolConnectionResponse>;
+                executeConnection(toolAgentConnectionId: string, payload: ExecuteToolConnectionRequest, options?: {
+                    idempotencyKey?: string;
+                }): Promise<ExecuteToolResponse>;
             };
             catalogs: {
                 templates: {
@@ -1909,12 +2052,32 @@ declare function createClient(initialCfg: ClientConfig & {
         update(agentId: string, payload: UpdateAgentRequest): Promise<AgentEntity>;
     };
     workspaces: {
+        list(options?: ListWorkspacesOptions): Promise<PaginatedResult<WorkspaceListResponse, ListWorkspacesOptions>>;
         listPhones(workspaceId: string, opts?: ListWorkspacePhonesOptions): Promise<PaginatedResult<WorkspacePhonesResponse, ListWorkspacePhonesOptions>>;
         enable(workspaceId: string, payload: WorkspaceEnableRequest): Promise<WorkspaceEnableResponse>;
     };
     tools: {
+        connections: {
+            readonly connect: (toolId: string, payload: ToolConnectionRequest, options?: {
+                idempotencyKey?: string;
+            }) => Promise<ToolConnectionResponse>;
+            readonly create: (payload: CreateToolConnectionRequest, options?: {
+                idempotencyKey?: string;
+            }) => Promise<ToolConnectionResponse>;
+            readonly execute: (toolAgentConnectionId: string, payload: ExecuteToolConnectionRequest, options?: {
+                idempotencyKey?: string;
+            }) => Promise<ExecuteToolResponse>;
+            readonly list: (options?: ListToolConnectionsOptions) => Promise<PaginatedResult<ToolConnectionListResponse, ListToolConnectionsOptions>>;
+            readonly createConnection: (payload: CreateToolConnectionRequest, options?: {
+                idempotencyKey?: string;
+            }) => Promise<ToolConnectionResponse>;
+            readonly executeConnection: (toolAgentConnectionId: string, payload: ExecuteToolConnectionRequest, options?: {
+                idempotencyKey?: string;
+            }) => Promise<ExecuteToolResponse>;
+        };
         list(options?: ListToolsOptions): Promise<PaginatedResult<ToolListResponse, ListToolsOptions>>;
         listResources(toolId: string, options?: ListToolResourcesOptions): Promise<PaginatedResult<ToolResourceListResponse, ListToolResourcesOptions>>;
+        listConnections(options?: ListToolConnectionsOptions): Promise<PaginatedResult<ToolConnectionListResponse, ListToolConnectionsOptions>>;
         uploadResource(toolId: string, payload: FormData | (Omit<{
             file: string;
             type?: "document" | "media" | "file";
@@ -1933,6 +2096,12 @@ declare function createClient(initialCfg: ClientConfig & {
         connect(toolId: string, payload: ToolConnectionRequest, options?: {
             idempotencyKey?: string;
         }): Promise<ToolConnectionResponse>;
+        createConnection(payload: CreateToolConnectionRequest, options?: {
+            idempotencyKey?: string;
+        }): Promise<ToolConnectionResponse>;
+        executeConnection(toolAgentConnectionId: string, payload: ExecuteToolConnectionRequest, options?: {
+            idempotencyKey?: string;
+        }): Promise<ExecuteToolResponse>;
     };
     catalogs: {
         templates: {
@@ -1991,4 +2160,4 @@ declare function createHttp(cfg: ClientConfig & {
     resolveAccessToken: () => string;
 };
 
-export { type AgentBlueprint, type AgentBlueprintListItem, type AgentBlueprintListResponse, type AgentBlueprintsApi$1 as AgentBlueprintsApi, type AgentDetail, type AgentEntity, type AgentEntityFactoryOptions, type AgentListResponse, type AgentSchedule, type AgentScheduleApi, type AgentScheduleException, type AgentScheduleExceptionListResponse, type AgentScheduleListResponse, type AgentStageTriggersApi$1 as AgentStageTriggersApi, type AgentStagesApi$1 as AgentStagesApi, type AgentSummary, type AgentTagRequest, type AgentTagsResponse, type AgentVersionDetail, type AgentVersionListResponse, type AgentVersionSummary, type AgentsApi, type AgentsApiWithEntities, type ApiKeyListResponse, type ApiKeySummary, type ApiKeysApi, type BlueprintStage, type BlueprintStageListResponse, type BlueprintStageReorderRequest, type BlueprintStageTrigger, type BlueprintStageTriggerListResponse, type Campaign, type CampaignExecution, type CampaignExecutionListResponse, type CampaignListResponse, type CampaignStatus, type CatalogItemCreateRequest, type CatalogItemDetail, type CatalogItemLinks, type CatalogItemListResponse, type CatalogItemSummary, type CatalogTemplateDetail, type CatalogTemplateListResponse, type CatalogTemplateSummary, type CatalogTemplateVisibility, type ClientConfig, type ConnectPhoneRequest, type CreateAgentBlueprintRequest, type CreateAgentRequest, type CreateAgentScheduleExceptionRequest, type CreateAgentVersionRequest, type CreateApiKeyRequest, type CreateApiKeyResponse, type CreateBlueprintStageRequest, type CreateBlueprintStageTriggerRequest, type CreateCampaignPayload, type CreateEventSubscriptionRequest, type CreateInstructionRequest, type CreateWebhookRequest, type ErrorResponse, type EventSubscriptionDetail, type EventSubscriptionListResponse, type EventSubscriptionSummary, type ExecuteToolRequest, type ExecuteToolResponse, type ForkAgentFromTemplateRequest, HttpError, type Instruction, type InstructionCreatedResponse, type InstructionListResponse, type ListAgentBlueprintsOptions, type ListAgentScheduleExceptionsOptions, type ListAgentSchedulesOptions, type ListAgentStageTriggersOptions, type ListAgentStagesOptions, type ListAgentVersionInstructionsOptions, type ListAgentVersionsOptions, type ListAgentsOptions, type ListCampaignExecutionsOptions, type ListCampaignsOptions, type ListCatalogItemsOptions, type ListCatalogTemplatesOptions, type ListQueryOptions, type ListToolResourcesOptions, type ListToolsOptions, type ListVoicesOptions, type ListWebhooksOptions, type ListWorkspacePhonesOptions, NetworkError, type PaginatedResult, type PaginationMeta, type PhoneAssignmentResponse, type PublishAgentVersionRequest, type QueryBuilderInput, type QueryBuilderSerializable, type QueryFilterOperators, type QueryFilters, type QueryOrGroups, type QueryValue, type RetryPolicy, TimeoutError, type ToolConnectionAuth, type ToolConnectionRequest, type ToolConnectionResponse, type ToolListResponse, type ToolResourceListResponse, type ToolResourceReloadResponse, type ToolResourceSummary, type ToolResourceUploadRequest, type ToolResourceUploadResponse, type ToolSummary, type UpdateAgentBlueprintRequest, type UpdateAgentRequest, type UpdateAgentScheduleExceptionRequest, type UpdateAgentScheduleRequest, type UpdateAgentVersionNotesRequest, type UpdateBlueprintStageRequest, type UpdateBlueprintStageTriggerRequest, type UpdateEventSubscriptionRequest, type UpdateInstructionRequest, type UpdateWebhookRequest, type VoiceListResponse, type VoiceSummary, type WebhookDetail, type WebhookListResponse, type WebhookSummary, type WorkspaceEnableRequest, type WorkspaceEnableResponse, type WorkspacePhone, type WorkspacePhoneChannel, type WorkspacePhonesResponse, bindAgentBlueprints, bindAgentPhones, bindAgentSchedule, bindAgentScheduleExceptions, bindAgentSchedules, bindAgentStageTriggers, bindAgentStages, bindAgentTags, bindAgentVersions, createAgentBlueprintsApi, createAgentEntity, createAgentPhonesApi, createAgentScheduleApi, createAgentScheduleExceptionsApi, createAgentStageTriggersApi, createAgentStagesApi, createAgentTagsApi, createAgentVersionsApi, createAgentsApi, createApiKeysApi, createCampaignsApi, createCatalogTemplatesApi, createCatalogsApi, createClient, createHttp, createToolsApi, createVoicesApi, createWebhooksApi, createWorkspacesApi };
+export { type AgentBlueprint, type AgentBlueprintListItem, type AgentBlueprintListResponse, type AgentBlueprintsApi$1 as AgentBlueprintsApi, type AgentDetail, type AgentEntity, type AgentEntityFactoryOptions, type AgentListResponse, type AgentSchedule, type AgentScheduleApi, type AgentScheduleException, type AgentScheduleExceptionListResponse, type AgentScheduleListResponse, type AgentStageTriggersApi$1 as AgentStageTriggersApi, type AgentStagesApi$1 as AgentStagesApi, type AgentSummary, type AgentTagRequest, type AgentTagsResponse, type AgentVersionDetail, type AgentVersionListResponse, type AgentVersionSummary, type AgentsApi, type AgentsApiWithEntities, type ApiErrorBody, type ApiHttpError, type ApiKeyListResponse, type ApiKeySummary, type ApiKeysApi, type BlueprintStage, type BlueprintStageListResponse, type BlueprintStageReorderRequest, type BlueprintStageTrigger, type BlueprintStageTriggerListResponse, type Campaign, type CampaignExecution, type CampaignExecutionListResponse, type CampaignListResponse, type CampaignStatus, type CatalogItemCreateRequest, type CatalogItemDetail, type CatalogItemLinks, type CatalogItemListResponse, type CatalogItemSummary, type CatalogTemplateDetail, type CatalogTemplateListResponse, type CatalogTemplateSummary, type CatalogTemplateVisibility, type ClientConfig, type ConnectPhoneRequest, type CreateAgentBlueprintRequest, type CreateAgentRequest, type CreateAgentScheduleExceptionRequest, type CreateAgentVersionRequest, type CreateApiKeyRequest, type CreateApiKeyResponse, type CreateBlueprintStageRequest, type CreateBlueprintStageTriggerRequest, type CreateCampaignPayload, type CreateEventSubscriptionRequest, type CreateInstructionRequest, type CreateToolConnectionRequest, type CreateWebhookRequest, type ErrorResponse, type EventSubscriptionDetail, type EventSubscriptionListResponse, type EventSubscriptionSummary, type ExecuteToolConnectionRequest, type ExecuteToolRequest, type ExecuteToolResponse, type ForkAgentFromTemplateRequest, HttpError, type Instruction, type InstructionCreatedResponse, type InstructionListResponse, type ListAgentBlueprintsOptions, type ListAgentScheduleExceptionsOptions, type ListAgentSchedulesOptions, type ListAgentStageTriggersOptions, type ListAgentStagesOptions, type ListAgentVersionInstructionsOptions, type ListAgentVersionsOptions, type ListAgentsOptions, type ListCampaignExecutionsOptions, type ListCampaignsOptions, type ListCatalogItemsOptions, type ListCatalogTemplatesOptions, type ListQueryOptions, type ListToolConnectionsOptions, type ListToolResourcesOptions, type ListToolsOptions, type ListVoicesOptions, type ListWebhooksOptions, type ListWorkspacePhonesOptions, type ListWorkspacesOptions, NetworkError, type PaginatedResult, type PaginationMeta, type PhoneAssignmentResponse, type PublishAgentVersionRequest, type QueryBuilderInput, type QueryBuilderSerializable, type QueryFilterOperators, type QueryFilters, type QueryOrGroups, type QueryValue, type RetryPolicy, TimeoutError, type ToolConnectionAuth, type ToolConnectionListItem, type ToolConnectionListResponse, type ToolConnectionRequest, type ToolConnectionResponse, type ToolListResponse, type ToolResourceListResponse, type ToolResourceReloadResponse, type ToolResourceSummary, type ToolResourceUploadRequest, type ToolResourceUploadResponse, type ToolSummary, type UpdateAgentBlueprintRequest, type UpdateAgentRequest, type UpdateAgentScheduleExceptionRequest, type UpdateAgentScheduleRequest, type UpdateAgentVersionNotesRequest, type UpdateBlueprintStageRequest, type UpdateBlueprintStageTriggerRequest, type UpdateEventSubscriptionRequest, type UpdateInstructionRequest, type UpdateWebhookRequest, type VoiceListResponse, type VoiceSummary, type WebhookDetail, type WebhookListResponse, type WebhookSummary, type WorkspaceEnableRequest, type WorkspaceEnableResponse, type WorkspaceListResponse, WorkspaceNotSelectedError, type WorkspacePhone, type WorkspacePhoneChannel, type WorkspacePhonesResponse, type WorkspaceSummary, bindAgentBlueprints, bindAgentPhones, bindAgentSchedule, bindAgentScheduleExceptions, bindAgentSchedules, bindAgentStageTriggers, bindAgentStages, bindAgentTags, bindAgentVersions, createAgentBlueprintsApi, createAgentEntity, createAgentPhonesApi, createAgentScheduleApi, createAgentScheduleExceptionsApi, createAgentStageTriggersApi, createAgentStagesApi, createAgentTagsApi, createAgentVersionsApi, createAgentsApi, createApiKeysApi, createCampaignsApi, createCatalogTemplatesApi, createCatalogsApi, createClient, createHttp, createToolsApi, createVoicesApi, createWebhooksApi, createWorkspacesApi, isApiErrorBody, isApiHttpError };

package/dist/index.js

@@ -9,6 +9,14 @@ var HttpError = class extends Error {
     this.name = "HttpError";
   }
 };
+function isApiErrorBody(body) {
+  if (!body || typeof body !== "object") return false;
+  const candidate = body;
+  return typeof candidate.code === "string" && typeof candidate.message === "string";
+}
+function isApiHttpError(err) {
+  return err instanceof HttpError && isApiErrorBody(err.body);
+}
 var TimeoutError = class extends Error {
   constructor(ms, url) {
     super(`Timeout after ${ms}ms`);
@@ -25,6 +33,12 @@ var NetworkError = class extends Error {
     this.name = "NetworkError";
   }
 };
+var WorkspaceNotSelectedError = class extends Error {
+  constructor() {
+    super("Workspace is not selected");
+    this.name = "WorkspaceNotSelectedError";
+  }
+};
 
 // src/http.ts
 function toQueryString(query) {
@@ -1088,9 +1102,21 @@ var createAgentEntity = (dto, options) => {
 
 // src/api/agents.ts
 function createAgentsApi(cfg, relatedApis) {
-  const { base, doFetch } = createHttp(cfg);
+  const { base, doFetch, resolveWorkspaceId, resolveApiKey } = createHttp(cfg);
+  const requireWorkspace = () => {
+    const workspaceId = resolveWorkspaceId();
+    if (typeof workspaceId === "string" && workspaceId.trim().length > 0) {
+      return;
+    }
+    const apiKey = resolveApiKey();
+    if (typeof apiKey === "string" && apiKey.trim().length > 0) {
+      return;
+    }
+    throw new WorkspaceNotSelectedError();
+  };
   const jsonHeaders = { "content-type": "application/json" };
   const fetchAgentsPage = async (options = {}) => {
+    requireWorkspace();
     const sanitizedOptions = {
       page: options.page,
       limit: options.limit,
@@ -1109,12 +1135,14 @@ function createAgentsApi(cfg, relatedApis) {
     return attachPaginator(response, fetchAgentsPage, normalizedOptions);
   };
   const getAgentDetail = async (agentId) => {
+    requireWorkspace();
     const res = await doFetch(`${base}/agents/${agentId}`, {
       method: "GET"
     });
     return res.json();
   };
   const createAgent = async (payload) => {
+    requireWorkspace();
     const res = await doFetch(`${base}/agents`, {
       method: "POST",
       body: JSON.stringify(payload),
@@ -1123,6 +1151,7 @@ function createAgentsApi(cfg, relatedApis) {
     return res.json();
   };
   const forkAgentFromTemplate = async (payload) => {
+    requireWorkspace();
     const res = await doFetch(`${base}/agents/from-template`, {
       method: "POST",
       body: JSON.stringify(payload),
@@ -1131,6 +1160,7 @@ function createAgentsApi(cfg, relatedApis) {
     return res.json();
   };
   const updateAgent = async (agentId, payload) => {
+    requireWorkspace();
     const res = await doFetch(`${base}/agents/${agentId}`, {
       method: "PATCH",
       body: JSON.stringify(payload),
@@ -1142,6 +1172,7 @@ function createAgentsApi(cfg, relatedApis) {
     return typeof agent === "string" ? agent : agent.agentId;
   };
   const deleteAgent = async (agent) => {
+    requireWorkspace();
     const agentId = resolveAgentId(agent);
     await doFetch(`${base}/agents/${agentId}`, {
       method: "DELETE"
@@ -1464,7 +1495,15 @@ function createToolsApi(cfg) {
     });
     return res.json();
   };
-  return {
+  const fetchToolConnectionsPage = async (options = {}) => {
+    const query = serializeListOptions(options ?? {});
+    const res = await doFetch(`${base}/tools/connections`, {
+      method: "GET",
+      query
+    });
+    return res.json();
+  };
+  const api = {
     async list(options = {}) {
       const normalizedOptions = { ...options ?? {} };
       const response = await fetchToolsPage(normalizedOptions);
@@ -1478,6 +1517,17 @@ function createToolsApi(cfg) {
       const response = await fetchPage(normalizedOptions);
       return attachPaginator(response, fetchPage, normalizedOptions);
     },
+    async listConnections(options = {}) {
+      const normalizedOptions = {
+        ...options ?? {}
+      };
+      const response = await fetchToolConnectionsPage(normalizedOptions);
+      return attachPaginator(
+        response,
+        fetchToolConnectionsPage,
+        normalizedOptions
+      );
+    },
     async uploadResource(toolId, payload) {
       const formData = toFormData(payload);
       const res = await doFetch(`${base}/tools/${toolId}/resources`, {
@@ -1523,8 +1573,47 @@ function createToolsApi(cfg) {
         body: JSON.stringify(payload)
       });
       return res.json();
+    },
+    async createConnection(payload, options = {}) {
+      const idempotencyKey = generateIdempotencyKey(options.idempotencyKey);
+      const res = await doFetch(`${base}/tools/connections`, {
+        method: "POST",
+        headers: {
+          ...jsonHeaders,
+          [IDEMPOTENCY_HEADER]: idempotencyKey
+        },
+        body: JSON.stringify(payload)
+      });
+      return res.json();
+    },
+    async executeConnection(toolAgentConnectionId, payload, options = {}) {
+      const idempotencyKey = generateIdempotencyKey(options.idempotencyKey);
+      const res = await doFetch(
+        `${base}/tools/connections/${toolAgentConnectionId}/execute`,
+        {
+          method: "POST",
+          headers: {
+            ...jsonHeaders,
+            [IDEMPOTENCY_HEADER]: idempotencyKey
+          },
+          body: JSON.stringify(payload)
+        }
+      );
+      return res.json();
     }
   };
+  const connections = {
+    connect: api.connect,
+    create: api.createConnection,
+    execute: api.executeConnection,
+    list: api.listConnections,
+    createConnection: api.createConnection,
+    executeConnection: api.executeConnection
+  };
+  return {
+    ...api,
+    connections
+  };
 }
 
 // src/utils/catalog-voices.ts
@@ -1831,6 +1920,26 @@ function createWebhooksApi(cfg) {
 function createWorkspacesApi(cfg) {
   const { base, doFetch } = createHttp(cfg);
   const jsonHeaders = { "content-type": "application/json" };
+  const fetchWorkspacesPage = async (options = {}) => {
+    const normalized = { ...options ?? {} };
+    const query = serializeListOptions({
+      page: normalized.page,
+      limit: normalized.limit,
+      sort: normalized.sort,
+      fields: normalized.fields,
+      include: normalized.include,
+      search: normalized.search,
+      filter: normalized.filter,
+      or: normalized.or
+    });
+    const headers = normalized.refreshCache ? { "X-Cache-Refresh": "true" } : void 0;
+    const res = await doFetch(`${base}/workspaces`, {
+      method: "GET",
+      query,
+      headers
+    });
+    return res.json();
+  };
   const fetchPhonesPage = async (workspaceId, opts = {}) => {
     const { channel } = opts ?? {};
     const query = serializeListOptions(
@@ -1853,6 +1962,11 @@ function createWorkspacesApi(cfg) {
     return res.json();
   };
   return {
+    async list(options = {}) {
+      const normalizedOptions = { ...options ?? {} };
+      const response = await fetchWorkspacesPage(normalizedOptions);
+      return attachPaginator(response, fetchWorkspacesPage, normalizedOptions);
+    },
     async listPhones(workspaceId, opts = {}) {
       const normalizedOptions = {
         ...opts ?? {}
@@ -2040,6 +2154,7 @@ export {
   HttpError,
   NetworkError,
   TimeoutError,
+  WorkspaceNotSelectedError,
   bindAgentBlueprints,
   bindAgentPhones,
   bindAgentSchedule,
@@ -2068,6 +2183,8 @@ export {
   createToolsApi,
   createVoicesApi,
   createWebhooksApi,
-  createWorkspacesApi
+  createWorkspacesApi,
+  isApiErrorBody,
+  isApiHttpError
 };
 //# sourceMappingURL=index.js.map