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

package/README.md

@@ -415,6 +415,8 @@ createClient({
 
 Puedes fijar el workspace al crear el cliente, actualizarlo en caliente o delegar en una función:
 
+> Nota: los recursos _scoped por workspace_ (por ejemplo `client.agents.*`) requieren un workspace seleccionado. Si `client.workspace.get()` retorna `undefined`, el SDK lanzará un error antes de hacer la request.
+
 ```ts
 const client = createClient({
   baseUrl,

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,
@@ -81,6 +82,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 +1151,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 +1184,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 +1200,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 +1209,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 +1221,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 +1544,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 +1566,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 +1622,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
@@ -2122,6 +2204,7 @@ function createClient(initialCfg) {
   HttpError,
   NetworkError,
   TimeoutError,
+  WorkspaceNotSelectedError,
   bindAgentBlueprints,
   bindAgentPhones,
   bindAgentSchedule,