@getsupervisor/agents-studio-sdk 1.20.0 → 1.22.0

package/CHANGELOG.md

@@ -1,3 +1,12 @@
+## v1.20.0
+
+## [1.20.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.19.0...v1.20.0) (2025-10-30)
+
+### Features
+
+* add RetellToolGuidelinesService and integrate usage guidelines for voice.calls ([db0e013](https://github.com/julio-supervisor/agents-studio-be/commit/db0e013d8f09d2a0a794efccb7700729ad752fd4))
+
+
 ## v1.19.0
 
 ## [1.19.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.18.0...v1.19.0) (2025-10-30)

package/dist/index.cjs

@@ -353,7 +353,7 @@ function createAgentBlueprintsApi(cfg) {
   const jsonHeaders = { "content-type": "application/json" };
   const list = async (agentId, options = {}) => {
     const query = serializeListOptions({ filter: options.filter });
-    const res = await doFetch(`${base}/v1/agents/${agentId}/blueprints`, {
+    const res = await doFetch(`${base}/agents/${agentId}/blueprints`, {
       method: "GET",
       query
     });
@@ -361,7 +361,7 @@ function createAgentBlueprintsApi(cfg) {
   };
   const get = async (agentId, versionId) => {
     const res = await doFetch(
-      `${base}/v1/agents/${agentId}/versions/${versionId}/blueprint`,
+      `${base}/agents/${agentId}/versions/${versionId}/blueprint`,
       {
         method: "GET"
       }
@@ -370,7 +370,7 @@ function createAgentBlueprintsApi(cfg) {
   };
   const create = async (agentId, versionId, payload) => {
     const res = await doFetch(
-      `${base}/v1/agents/${agentId}/versions/${versionId}/blueprint`,
+      `${base}/agents/${agentId}/versions/${versionId}/blueprint`,
       {
         method: "POST",
         body: JSON.stringify(payload),
@@ -381,7 +381,7 @@ function createAgentBlueprintsApi(cfg) {
   };
   const update = async (agentId, versionId, payload) => {
     const res = await doFetch(
-      `${base}/v1/agents/${agentId}/versions/${versionId}/blueprint`,
+      `${base}/agents/${agentId}/versions/${versionId}/blueprint`,
       {
         method: "PATCH",
         body: JSON.stringify(payload),
@@ -497,7 +497,7 @@ function createAgentInstructionsApi(cfg) {
   const fetchInstructionPage = async (agentId, opts = {}) => {
     const { versionId, ...queryOptions } = opts ?? {};
     const query = serializeListOptions(queryOptions, { versionId });
-    const res = await doFetch(`${base}/v1/agents/${agentId}/instructions`, {
+    const res = await doFetch(`${base}/agents/${agentId}/instructions`, {
       method: "GET",
       query
     });
@@ -513,7 +513,7 @@ function createAgentInstructionsApi(cfg) {
       return attachPaginator(response, fetchPage, normalizedOptions);
     },
     async create(agentId, payload) {
-      const res = await doFetch(`${base}/v1/agents/${agentId}/instructions`, {
+      const res = await doFetch(`${base}/agents/${agentId}/instructions`, {
         method: "POST",
         headers: jsonHeaders,
         body: JSON.stringify(payload)
@@ -522,7 +522,7 @@ function createAgentInstructionsApi(cfg) {
     },
     async update(agentId, instructionId, payload) {
       const res = await doFetch(
-        `${base}/v1/agents/${agentId}/instructions/${instructionId}`,
+        `${base}/agents/${agentId}/instructions/${instructionId}`,
         {
           method: "PATCH",
           headers: jsonHeaders,
@@ -532,12 +532,9 @@ function createAgentInstructionsApi(cfg) {
       return res.json();
     },
     async delete(agentId, instructionId) {
-      await doFetch(
-        `${base}/v1/agents/${agentId}/instructions/${instructionId}`,
-        {
-          method: "DELETE"
-        }
-      );
+      await doFetch(`${base}/agents/${agentId}/instructions/${instructionId}`, {
+        method: "DELETE"
+      });
     }
   };
 }
@@ -548,7 +545,7 @@ function createAgentPhonesApi(cfg) {
   const jsonHeaders = { "content-type": "application/json" };
   return {
     async connect(agentId, payload) {
-      const res = await doFetch(`${base}/v1/agents/${agentId}/phones`, {
+      const res = await doFetch(`${base}/agents/${agentId}/phones`, {
         method: "POST",
         headers: jsonHeaders,
         body: JSON.stringify(payload)
@@ -556,7 +553,7 @@ function createAgentPhonesApi(cfg) {
       return res.json();
     },
     async disconnect(agentId, phoneId) {
-      await doFetch(`${base}/v1/agents/${agentId}/phones/${phoneId}`, {
+      await doFetch(`${base}/agents/${agentId}/phones/${phoneId}`, {
         method: "DELETE"
       });
     }
@@ -569,13 +566,13 @@ function createAgentScheduleApi(cfg) {
   const jsonHeaders = { "content-type": "application/json" };
   return {
     async get(agentId) {
-      const res = await doFetch(`${base}/v1/agents/${agentId}/schedule`, {
+      const res = await doFetch(`${base}/agents/${agentId}/schedule`, {
         method: "GET"
       });
       return res.json();
     },
     async create(agentId, payload) {
-      const res = await doFetch(`${base}/v1/agents/${agentId}/schedule`, {
+      const res = await doFetch(`${base}/agents/${agentId}/schedule`, {
         method: "POST",
         headers: jsonHeaders,
         body: JSON.stringify(payload)
@@ -583,7 +580,7 @@ function createAgentScheduleApi(cfg) {
       return res.json();
     },
     async update(agentId, payload) {
-      const res = await doFetch(`${base}/v1/agents/${agentId}/schedule`, {
+      const res = await doFetch(`${base}/agents/${agentId}/schedule`, {
         method: "PUT",
         headers: jsonHeaders,
         body: JSON.stringify(payload)
@@ -599,13 +596,10 @@ function createAgentScheduleExceptionsApi(cfg) {
   const jsonHeaders = { "content-type": "application/json" };
   const fetchExceptionsPage = async (agentId, options = {}) => {
     const query = serializeListOptions(options ?? {});
-    const res = await doFetch(
-      `${base}/v1/agents/${agentId}/schedule/exceptions`,
-      {
-        method: "GET",
-        query
-      }
-    );
+    const res = await doFetch(`${base}/agents/${agentId}/schedule/exceptions`, {
+      method: "GET",
+      query
+    });
     return res.json();
   };
   return {
@@ -619,7 +613,7 @@ function createAgentScheduleExceptionsApi(cfg) {
     },
     async get(agentId, exceptionId) {
       const res = await doFetch(
-        `${base}/v1/agents/${agentId}/schedule/exceptions/${exceptionId}`,
+        `${base}/agents/${agentId}/schedule/exceptions/${exceptionId}`,
         {
           method: "GET"
         }
@@ -628,7 +622,7 @@ function createAgentScheduleExceptionsApi(cfg) {
     },
     async create(agentId, payload) {
       const res = await doFetch(
-        `${base}/v1/agents/${agentId}/schedule/exceptions`,
+        `${base}/agents/${agentId}/schedule/exceptions`,
         {
           method: "POST",
           headers: jsonHeaders,
@@ -639,7 +633,7 @@ function createAgentScheduleExceptionsApi(cfg) {
     },
     async update(agentId, exceptionId, payload) {
       const res = await doFetch(
-        `${base}/v1/agents/${agentId}/schedule/exceptions/${exceptionId}`,
+        `${base}/agents/${agentId}/schedule/exceptions/${exceptionId}`,
         {
           method: "PATCH",
           headers: jsonHeaders,
@@ -650,7 +644,7 @@ function createAgentScheduleExceptionsApi(cfg) {
     },
     async delete(agentId, exceptionId) {
       await doFetch(
-        `${base}/v1/agents/${agentId}/schedule/exceptions/${exceptionId}`,
+        `${base}/agents/${agentId}/schedule/exceptions/${exceptionId}`,
         {
           method: "DELETE"
         }
@@ -665,7 +659,7 @@ function createAgentTagsApi(cfg) {
   const jsonHeaders = { "content-type": "application/json" };
   return {
     async add(agentId, payload) {
-      const res = await doFetch(`${base}/v1/agents/${agentId}/tags`, {
+      const res = await doFetch(`${base}/agents/${agentId}/tags`, {
         method: "POST",
         headers: jsonHeaders,
         body: JSON.stringify(payload)
@@ -673,7 +667,7 @@ function createAgentTagsApi(cfg) {
       return res.json();
     },
     async remove(agentId, tagId) {
-      await doFetch(`${base}/v1/agents/${agentId}/tags/${tagId}`, {
+      await doFetch(`${base}/agents/${agentId}/tags/${tagId}`, {
         method: "DELETE"
       });
     }
@@ -691,7 +685,7 @@ function createAgentVersionsApi(cfg) {
       filter: opts.filter
     };
     const query = serializeListOptions(queryOptions);
-    const res = await doFetch(`${base}/v1/agents/${agentId}/versions`, {
+    const res = await doFetch(`${base}/agents/${agentId}/versions`, {
       method: "GET",
       query
     });
@@ -706,7 +700,7 @@ function createAgentVersionsApi(cfg) {
     },
     async get(agentId, versionId) {
       const res = await doFetch(
-        `${base}/v1/agents/${agentId}/versions/${versionId}`,
+        `${base}/agents/${agentId}/versions/${versionId}`,
         {
           method: "GET"
         }
@@ -714,7 +708,7 @@ function createAgentVersionsApi(cfg) {
       return res.json();
     },
     async create(agentId, payload) {
-      const res = await doFetch(`${base}/v1/agents/${agentId}/versions`, {
+      const res = await doFetch(`${base}/agents/${agentId}/versions`, {
         method: "POST",
         headers: jsonHeaders,
         body: JSON.stringify(payload ?? {})
@@ -723,7 +717,7 @@ function createAgentVersionsApi(cfg) {
     },
     async clone(agentId, versionId) {
       const res = await doFetch(
-        `${base}/v1/agents/${agentId}/versions/${versionId}/clone`,
+        `${base}/agents/${agentId}/versions/${versionId}/clone`,
         {
           method: "POST"
         }
@@ -732,7 +726,7 @@ function createAgentVersionsApi(cfg) {
     },
     async publish(agentId, versionId, payload) {
       const res = await doFetch(
-        `${base}/v1/agents/${agentId}/versions/${versionId}/publish`,
+        `${base}/agents/${agentId}/versions/${versionId}/publish`,
         {
           method: "POST",
           headers: jsonHeaders,
@@ -743,7 +737,7 @@ function createAgentVersionsApi(cfg) {
     },
     async updateNotes(agentId, versionId, payload) {
       const res = await doFetch(
-        `${base}/v1/agents/${agentId}/versions/${versionId}/notes`,
+        `${base}/agents/${agentId}/versions/${versionId}/notes`,
         {
           method: "PATCH",
           headers: jsonHeaders,
@@ -755,7 +749,7 @@ function createAgentVersionsApi(cfg) {
     async listInstructions(agentId, versionId, opts = {}) {
       const query = serializeListOptions(opts);
       const res = await doFetch(
-        `${base}/v1/agents/${agentId}/versions/${versionId}/instructions`,
+        `${base}/agents/${agentId}/versions/${versionId}/instructions`,
         {
           method: "GET",
           query
@@ -765,7 +759,7 @@ function createAgentVersionsApi(cfg) {
     },
     async createInstruction(agentId, versionId, payload) {
       const res = await doFetch(
-        `${base}/v1/agents/${agentId}/versions/${versionId}/instructions`,
+        `${base}/agents/${agentId}/versions/${versionId}/instructions`,
         {
           method: "POST",
           headers: jsonHeaders,
@@ -776,7 +770,7 @@ function createAgentVersionsApi(cfg) {
     },
     async updateInstruction(agentId, versionId, instructionId, payload) {
       const res = await doFetch(
-        `${base}/v1/agents/${agentId}/versions/${versionId}/instructions/${instructionId}`,
+        `${base}/agents/${agentId}/versions/${versionId}/instructions/${instructionId}`,
         {
           method: "PATCH",
           headers: jsonHeaders,
@@ -787,7 +781,7 @@ function createAgentVersionsApi(cfg) {
     },
     async deleteInstruction(agentId, versionId, instructionId) {
       await doFetch(
-        `${base}/v1/agents/${agentId}/versions/${versionId}/instructions/${instructionId}`,
+        `${base}/agents/${agentId}/versions/${versionId}/instructions/${instructionId}`,
         {
           method: "DELETE"
         }
@@ -964,7 +958,7 @@ function createAgentsApi(cfg, relatedApis) {
       filter: options.filter
     };
     const query = serializeListOptions(sanitizedOptions);
-    const res = await doFetch(`${base}/v1/agents`, {
+    const res = await doFetch(`${base}/agents`, {
       method: "GET",
       query
     });
@@ -976,13 +970,13 @@ function createAgentsApi(cfg, relatedApis) {
     return attachPaginator(response, fetchAgentsPage, normalizedOptions);
   };
   const getAgentDetail = async (agentId) => {
-    const res = await doFetch(`${base}/v1/agents/${agentId}`, {
+    const res = await doFetch(`${base}/agents/${agentId}`, {
       method: "GET"
     });
     return res.json();
   };
   const createAgent = async (payload) => {
-    const res = await doFetch(`${base}/v1/agents`, {
+    const res = await doFetch(`${base}/agents`, {
       method: "POST",
       body: JSON.stringify(payload),
       headers: jsonHeaders
@@ -990,7 +984,7 @@ function createAgentsApi(cfg, relatedApis) {
     return res.json();
   };
   const updateAgent = async (agentId, payload) => {
-    const res = await doFetch(`${base}/v1/agents/${agentId}`, {
+    const res = await doFetch(`${base}/agents/${agentId}`, {
       method: "PATCH",
       body: JSON.stringify(payload),
       headers: jsonHeaders
@@ -1002,7 +996,7 @@ function createAgentsApi(cfg, relatedApis) {
   };
   const deleteAgent = async (agent) => {
     const agentId = resolveAgentId(agent);
-    await doFetch(`${base}/v1/agents/${agentId}`, {
+    await doFetch(`${base}/agents/${agentId}`, {
       method: "DELETE"
     });
   };
@@ -1072,11 +1066,11 @@ function createApiKeysApi(cfg) {
   const jsonHeaders = { "content-type": "application/json" };
   return {
     async list() {
-      const res = await doFetch(`${base}/v1/api-keys`, { method: "GET" });
+      const res = await doFetch(`${base}/api-keys`, { method: "GET" });
       return res.json();
     },
     async create(payload) {
-      const res = await doFetch(`${base}/v1/api-keys`, {
+      const res = await doFetch(`${base}/api-keys`, {
         method: "POST",
         headers: jsonHeaders,
         body: JSON.stringify(payload)
@@ -1084,12 +1078,12 @@ function createApiKeysApi(cfg) {
       return res.json();
     },
     async revoke(apiKeyId) {
-      await doFetch(`${base}/v1/api-keys/${apiKeyId}`, {
+      await doFetch(`${base}/api-keys/${apiKeyId}`, {
         method: "DELETE"
       });
     },
     async show(apiKeyId) {
-      const res = await doFetch(`${base}/v1/api-keys/${apiKeyId}/show`, {
+      const res = await doFetch(`${base}/api-keys/${apiKeyId}/show`, {
         method: "GET"
       });
       return res.json();
@@ -1103,7 +1097,7 @@ function createCatalogsApi(cfg) {
   const jsonHeaders = { "content-type": "application/json" };
   const fetchCatalogItemsPage = async (options = {}) => {
     const query = serializeListOptions(options ?? {});
-    const res = await doFetch(`${base}/v1/catalogs/items`, {
+    const res = await doFetch(`${base}/catalogs/items`, {
       method: "GET",
       query
     });
@@ -1122,13 +1116,13 @@ function createCatalogsApi(cfg) {
       );
     },
     async get(itemId) {
-      const res = await doFetch(`${base}/v1/catalogs/items/${itemId}`, {
+      const res = await doFetch(`${base}/catalogs/items/${itemId}`, {
         method: "GET"
       });
       return res.json();
     },
     async create(payload) {
-      const res = await doFetch(`${base}/v1/catalogs/items`, {
+      const res = await doFetch(`${base}/catalogs/items`, {
         method: "POST",
         headers: jsonHeaders,
         body: JSON.stringify(payload)
@@ -1136,7 +1130,7 @@ function createCatalogsApi(cfg) {
       return res.json();
     },
     async remove(itemId) {
-      await doFetch(`${base}/v1/catalogs/items/${itemId}`, {
+      await doFetch(`${base}/catalogs/items/${itemId}`, {
         method: "DELETE"
       });
     }
@@ -1196,7 +1190,7 @@ function createToolsApi(cfg) {
   const fetchToolsPage = async (options = {}) => {
     const { agentType, ...queryOptions } = options ?? {};
     const query = serializeListOptions(queryOptions, { agentType });
-    const res = await doFetch(`${base}/v1/tools`, {
+    const res = await doFetch(`${base}/tools`, {
       method: "GET",
       query
     });
@@ -1205,7 +1199,7 @@ function createToolsApi(cfg) {
   const fetchToolResourcesPage = async (toolId, options = {}) => {
     const { type, ...queryOptions } = options ?? {};
     const query = serializeListOptions(queryOptions, { type });
-    const res = await doFetch(`${base}/v1/tools/${toolId}/resources`, {
+    const res = await doFetch(`${base}/tools/${toolId}/resources`, {
       method: "GET",
       query
     });
@@ -1227,20 +1221,20 @@ function createToolsApi(cfg) {
     },
     async uploadResource(toolId, payload) {
       const formData = toFormData(payload);
-      const res = await doFetch(`${base}/v1/tools/${toolId}/resources`, {
+      const res = await doFetch(`${base}/tools/${toolId}/resources`, {
         method: "POST",
         body: formData
       });
       return res.json();
     },
     async deleteResource(toolId, resourceId) {
-      await doFetch(`${base}/v1/tools/${toolId}/resources/${resourceId}`, {
+      await doFetch(`${base}/tools/${toolId}/resources/${resourceId}`, {
         method: "DELETE"
       });
     },
     async reloadResource(toolId, resourceId) {
       const res = await doFetch(
-        `${base}/v1/tools/${toolId}/resources/${resourceId}/reload`,
+        `${base}/tools/${toolId}/resources/${resourceId}/reload`,
         {
           method: "POST"
         }
@@ -1249,7 +1243,7 @@ function createToolsApi(cfg) {
     },
     async execute(toolId, payload, options = {}) {
       const idempotencyKey = generateIdempotencyKey(options.idempotencyKey);
-      const res = await doFetch(`${base}/v1/tools/${toolId}/execute`, {
+      const res = await doFetch(`${base}/tools/${toolId}/execute`, {
         method: "POST",
         headers: {
           ...jsonHeaders,
@@ -1261,7 +1255,7 @@ function createToolsApi(cfg) {
     },
     async connect(toolId, payload, options = {}) {
       const idempotencyKey = generateIdempotencyKey(options.idempotencyKey);
-      const res = await doFetch(`${base}/v1/tools/${toolId}/connections`, {
+      const res = await doFetch(`${base}/tools/${toolId}/connections`, {
         method: "POST",
         headers: {
           ...jsonHeaders,
@@ -1297,7 +1291,7 @@ function createVoicesApi(cfg) {
         locale
       }
     );
-    const res = await doFetch(`${base}/v1/voices`, {
+    const res = await doFetch(`${base}/voices`, {
       method: "GET",
       query
     });
@@ -1326,7 +1320,7 @@ function createWebhooksApi(cfg) {
       search: options.search,
       filter: options.filter
     });
-    const res = await doFetch(`${base}/v1/webhooks`, {
+    const res = await doFetch(`${base}/webhooks`, {
       method: "GET",
       query
     });
@@ -1339,7 +1333,7 @@ function createWebhooksApi(cfg) {
       return attachPaginator(response, fetchWebhooksPage, normalized);
     },
     async create(payload) {
-      const res = await doFetch(`${base}/v1/webhooks`, {
+      const res = await doFetch(`${base}/webhooks`, {
         method: "POST",
         headers: jsonHeaders,
         body: JSON.stringify(payload)
@@ -1347,13 +1341,13 @@ function createWebhooksApi(cfg) {
       return res.json();
     },
     async get(webhookId) {
-      const res = await doFetch(`${base}/v1/webhooks/${webhookId}`, {
+      const res = await doFetch(`${base}/webhooks/${webhookId}`, {
         method: "GET"
       });
       return res.json();
     },
     async update(webhookId, payload) {
-      const res = await doFetch(`${base}/v1/webhooks/${webhookId}`, {
+      const res = await doFetch(`${base}/webhooks/${webhookId}`, {
         method: "PATCH",
         headers: jsonHeaders,
         body: JSON.stringify(payload)
@@ -1361,7 +1355,7 @@ function createWebhooksApi(cfg) {
       return res.json();
     },
     async delete(webhookId) {
-      await doFetch(`${base}/v1/webhooks/${webhookId}`, { method: "DELETE" });
+      await doFetch(`${base}/webhooks/${webhookId}`, { method: "DELETE" });
     },
     // Subscriptions
     async listSubscriptions(webhookId, options = {}) {
@@ -1376,7 +1370,7 @@ function createWebhooksApi(cfg) {
           filter: opts.filter
         });
         const res = await doFetch(
-          `${base}/v1/webhooks/${webhookId}/subscriptions`,
+          `${base}/webhooks/${webhookId}/subscriptions`,
           { method: "GET", query }
         );
         return res.json();
@@ -1386,26 +1380,23 @@ function createWebhooksApi(cfg) {
       return attachPaginator(response, fetchPage, normalized);
     },
     async createSubscription(webhookId, payload) {
-      const res = await doFetch(
-        `${base}/v1/webhooks/${webhookId}/subscriptions`,
-        {
-          method: "POST",
-          headers: jsonHeaders,
-          body: JSON.stringify(payload)
-        }
-      );
+      const res = await doFetch(`${base}/webhooks/${webhookId}/subscriptions`, {
+        method: "POST",
+        headers: jsonHeaders,
+        body: JSON.stringify(payload)
+      });
       return res.json();
     },
     async getSubscription(webhookId, subscriptionId) {
       const res = await doFetch(
-        `${base}/v1/webhooks/${webhookId}/subscriptions/${subscriptionId}`,
+        `${base}/webhooks/${webhookId}/subscriptions/${subscriptionId}`,
         { method: "GET" }
       );
       return res.json();
     },
     async updateSubscription(webhookId, subscriptionId, payload) {
       const res = await doFetch(
-        `${base}/v1/webhooks/${webhookId}/subscriptions/${subscriptionId}`,
+        `${base}/webhooks/${webhookId}/subscriptions/${subscriptionId}`,
         {
           method: "PATCH",
           headers: jsonHeaders,
@@ -1416,7 +1407,7 @@ function createWebhooksApi(cfg) {
     },
     async deleteSubscription(webhookId, subscriptionId) {
       await doFetch(
-        `${base}/v1/webhooks/${webhookId}/subscriptions/${subscriptionId}`,
+        `${base}/webhooks/${webhookId}/subscriptions/${subscriptionId}`,
         { method: "DELETE" }
       );
     }
@@ -1442,7 +1433,7 @@ function createWorkspacesApi(cfg) {
       },
       { channel }
     );
-    const res = await doFetch(`${base}/v1/workspaces/${workspaceId}/phones`, {
+    const res = await doFetch(`${base}/workspaces/${workspaceId}/phones`, {
       method: "GET",
       query
     });
@@ -1458,7 +1449,7 @@ function createWorkspacesApi(cfg) {
       return attachPaginator(response, fetchPage, normalizedOptions);
     },
     async enable(workspaceId, payload) {
-      const res = await doFetch(`${base}/v1/workspaces/${workspaceId}/enable`, {
+      const res = await doFetch(`${base}/workspaces/${workspaceId}/enable`, {
         method: "POST",
         headers: jsonHeaders,
         body: JSON.stringify(payload)