@getsupervisor/agents-studio-sdk 1.41.0 → 1.41.1

package/dist/index.cjs

@@ -22,6 +22,7 @@ __export(index_exports, {
   HttpError: () => HttpError,
   NetworkError: () => NetworkError,
   TimeoutError: () => TimeoutError,
+  WorkspaceNotSelectedError: () => WorkspaceNotSelectedError,
   bindAgentBlueprints: () => bindAgentBlueprints,
   bindAgentPhones: () => bindAgentPhones,
   bindAgentSchedule: () => bindAgentSchedule,
@@ -50,7 +51,9 @@ __export(index_exports, {
   createToolsApi: () => createToolsApi,
   createVoicesApi: () => createVoicesApi,
   createWebhooksApi: () => createWebhooksApi,
-  createWorkspacesApi: () => createWorkspacesApi
+  createWorkspacesApi: () => createWorkspacesApi,
+  isApiErrorBody: () => isApiErrorBody,
+  isApiHttpError: () => isApiHttpError
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -65,6 +68,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`);
@@ -81,6 +92,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) {
@@ -1144,9 +1161,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,
@@ -1165,12 +1194,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),
@@ -1179,6 +1210,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),
@@ -1187,6 +1219,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),
@@ -1198,6 +1231,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"
@@ -1520,7 +1554,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);
@@ -1534,6 +1576,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`, {
@@ -1579,8 +1632,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
@@ -1887,6 +1979,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(
@@ -1909,6 +2021,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 ?? {}
@@ -2097,6 +2214,7 @@ function createClient(initialCfg) {
   HttpError,
   NetworkError,
   TimeoutError,
+  WorkspaceNotSelectedError,
   bindAgentBlueprints,
   bindAgentPhones,
   bindAgentSchedule,
@@ -2125,6 +2243,8 @@ function createClient(initialCfg) {
   createToolsApi,
   createVoicesApi,
   createWebhooksApi,
-  createWorkspacesApi
+  createWorkspacesApi,
+  isApiErrorBody,
+  isApiHttpError
 });
 //# sourceMappingURL=index.cjs.map