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

package/CHANGELOG.md

@@ -93,7 +93,7 @@
 
 ### Features
 
-- add default language constant and update RetellBlueprintMapper to use it ([85d2d8c](https://github.com/julio-supervisor/agents-studio-be/commit/85d2d8ccc908254d351855158ecc09f14dbf6c6f))
+- add default language constant and update blueprint mapper to use it ([85d2d8c](https://github.com/julio-supervisor/agents-studio-be/commit/85d2d8ccc908254d351855158ecc09f14dbf6c6f))
 - implement delete instruction functionality with command handler and controller ([af983f5](https://github.com/julio-supervisor/agents-studio-be/commit/af983f5254055d35d3972d0bcbdb12a52b48c785))
 
 ## v1.34.0
@@ -102,8 +102,8 @@
 
 ### Features
 
-- enhance instruction management by adding active and non-deleted filtering, and integrate instructions into the Retell blueprint mapping ([baadb5f](https://github.com/julio-supervisor/agents-studio-be/commit/baadb5f561749d441c4757435fb920bb48556d7d))
-- implement VoiceBlueprintSyncService for Retell synchronization ([6b8f03f](https://github.com/julio-supervisor/agents-studio-be/commit/6b8f03f77ca1d2b91a9628db055e2799aa039f53))
+- enhance instruction management by adding active and non-deleted filtering, and integrate instructions into the agent blueprint mapping ([baadb5f](https://github.com/julio-supervisor/agents-studio-be/commit/baadb5f561749d441c4757435fb920bb48556d7d))
+- implement VoiceBlueprintSyncService for blueprint synchronization ([6b8f03f](https://github.com/julio-supervisor/agents-studio-be/commit/6b8f03f77ca1d2b91a9628db055e2799aa039f53))
 - introduce buildClientMock helper for consistent workspaceId handling in tests ([ae6eb30](https://github.com/julio-supervisor/agents-studio-be/commit/ae6eb305b16f677dea03a21bdfc8559c13cc641a))
 
 ## v1.33.0
@@ -277,7 +277,7 @@
 
 ### Features
 
-- Agrega `RetellToolGuidelinesService` y lineamientos de uso para voice calls dentro del SDK, permitiendo mostrar requisitos y recomendaciones antes de ejecutar herramientas de voz ([db0e013](https://github.com/julio-supervisor/agents-studio-be/commit/db0e013d8f09d2a0a794efccb7700729ad752fd4)).
+- Agrega `ToolGuidelinesService` y lineamientos de uso para voice calls dentro del SDK, permitiendo mostrar requisitos y recomendaciones antes de ejecutar herramientas de voz ([db0e013](https://github.com/julio-supervisor/agents-studio-be/commit/db0e013d8f09d2a0a794efccb7700729ad752fd4)).
 
 ## [1.19.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.18.0...v1.19.0) (2025-10-29)
 

package/README.md

@@ -524,26 +524,36 @@ const { key, ...metadata } = await http
 
 ### Scopes disponibles (octubre 2025)
 
-| Scope                      | Permiso principal                                                                        |
-| -------------------------- | ---------------------------------------------------------------------------------------- |
-| `agents:read`              | Consultar agentes, versiones, instrucciones, teléfonos y blueprints asociados.           |
-| `agents:write`             | Crear, actualizar o eliminar agentes, versiones, teléfonos y su configuración operativa. |
-| `agent-instructions:read`  | Leer instrucciones tanto a nivel agente como por versión publicada.                      |
-| `agent-instructions:write` | Crear, actualizar o borrar instrucciones personalizadas.                                 |
-| `agent-blueprints:read`    | Consultar blueprint y resúmenes sincronizados con proveedores externos.                  |
-| `agent-blueprints:write`   | Editar blueprint, personalidad y reglas de cada versión.                                 |
-| `agent-schedules:read`     | Consultar horario semanal y excepciones vigentes.                                        |
-| `agent-schedules:write`    | Crear o modificar horarios y excepciones.                                                |
-| `catalogs:read`            | Navegar catálogos globales y por workspace (idiomas, estilos, voces, etc.).              |
-| `catalogs:write`           | Registrar o ajustar ítems de catálogo.                                                   |
-| `tools:read`               | Descubrir tools disponibles, recursos y capacidades declaradas.                          |
-| `tools:connections:write`  | Crear conexiones entre agentes y tools (p. ej. `voice.calls`).                           |
-| `tools:execute`            | Ejecutar acciones de una tool (`startCall`, `reload`, etc.).                             |
-| `webhooks:read`            | Listar webhooks y sus suscripciones activas.                                             |
-| `webhooks:write`           | Crear, actualizar o eliminar webhooks y suscripciones.                                   |
-| `api-keys:read`            | Listar credenciales existentes y revelar su valor.                                       |
-| `api-keys:write`           | Emitir o revocar API Keys.                                                               |
-| `workspaces:read`          | Consultar metadatos y estado de habilitación de un workspace.                            |
+| Scope                      | Permiso principal                                                         |
+| -------------------------- | ------------------------------------------------------------------------- |
+| `agents:read`              | Listar y consultar agentes del workspace.                                 |
+| `agents:write`             | Crear/actualizar/eliminar agentes y gestionar su configuración operativa. |
+| `agent-versions:read`      | Listar y consultar versiones de un agente.                                |
+| `agent-versions:write`     | Crear, clonar, restaurar y publicar versiones de un agente.               |
+| `agent-instructions:read`  | Leer instrucciones (a nivel agente y por versión).                        |
+| `agent-instructions:write` | Crear, actualizar o borrar instrucciones personalizadas.                  |
+| `agent-blueprints:read`    | Consultar el blueprint (personalidad) de una versión de agente.           |
+| `agent-blueprints:write`   | Editar blueprint: personalidad, reglas, audiencia, objetivos, etc.        |
+| `blueprint-stages:read`    | Listar y consultar stages del blueprint.                                  |
+| `blueprint-stages:write`   | Crear, actualizar o reordenar stages del blueprint.                       |
+| `stage-triggers:read`      | Consultar triggers que conectan stages y sus condiciones.                 |
+| `stage-triggers:write`     | Crear, actualizar o eliminar triggers entre stages.                       |
+| `agent-schedules:read`     | Consultar horario semanal y excepciones vigentes.                         |
+| `agent-schedules:write`    | Crear o modificar horarios y excepciones.                                 |
+| `campaigns:read`           | Consultar campañas y sus ejecuciones.                                     |
+| `campaigns:write`          | Crear y disparar campañas batch.                                          |
+| `calls:read`               | Consultar llamadas (Speech Analytics) del workspace.                      |
+| `catalogs:read`            | Navegar catálogos globales y por workspace (idiomas, tonos, voces, etc.). |
+| `catalogs:write`           | Registrar o ajustar ítems de catálogo.                                    |
+| `tools:read`               | Descubrir tools disponibles, recursos y capacidades declaradas.           |
+| `tools:connections:read`   | Listar conexiones configuradas entre agentes y tools.                     |
+| `tools:connections:write`  | Crear o actualizar conexiones entre agentes y tools.                      |
+| `tools:execute`            | Ejecutar acciones de una tool.                                            |
+| `webhooks:read`            | Listar webhooks y sus suscripciones activas.                              |
+| `webhooks:write`           | Crear, actualizar o eliminar webhooks y suscripciones.                    |
+| `api-keys:read`            | Listar credenciales existentes y revelar su valor.                        |
+| `api-keys:write`           | Emitir o revocar API Keys.                                                |
+| `workspaces:read`          | Consultar workspaces disponibles y sus metadatos.                         |
 
 Consulta el OpenAPI (`docs/api-spec/openapi.yaml`) para validar scopes adicionales (por ejemplo, específicos de conocimientos o teléfonos) y su mapeo exacto por operación.
 

package/dist/index.cjs

@@ -43,12 +43,15 @@ __export(index_exports, {
   createAgentVersionsApi: () => createAgentVersionsApi,
   createAgentsApi: () => createAgentsApi,
   createApiKeysApi: () => createApiKeysApi,
+  createBillingApi: () => createBillingApi,
+  createCallsApi: () => createCallsApi,
   createCampaignsApi: () => createCampaignsApi,
   createCatalogTemplatesApi: () => createCatalogTemplatesApi,
   createCatalogsApi: () => createCatalogsApi,
   createClient: () => createClient,
   createHttp: () => createHttp,
   createToolsApi: () => createToolsApi,
+  createUsageApi: () => createUsageApi,
   createVoicesApi: () => createVoicesApi,
   createWebhooksApi: () => createWebhooksApi,
   createWorkspacesApi: () => createWorkspacesApi,
@@ -259,6 +262,11 @@ function createHttp(cfg) {
 }
 
 // src/utils/query.ts
+function buildSearchParams(entries) {
+  const searchParams = new URLSearchParams();
+  entries.forEach(([key, value]) => appendParam(searchParams, key, value));
+  return searchParams;
+}
 function serializeListOptions(options = {}, extra = {}) {
   const params = new URLSearchParams();
   appendParam(params, "page", options.page);
@@ -1130,7 +1138,8 @@ var createAgentEntity = (dto, options) => {
     stageTriggersApi,
     reload,
     updateAgent,
-    deleteAgent
+    deleteAgent,
+    cloneAgent
   } = options;
   const schedulesHelper = bindAgentSchedules(
     scheduleApi,
@@ -1149,6 +1158,9 @@ var createAgentEntity = (dto, options) => {
     async save(patch) {
       return updateAgent(dto.agentId, patch);
     },
+    async clone(payload) {
+      return cloneAgent(dto.agentId, payload);
+    },
     async delete() {
       await deleteAgent(dto.agentId);
     },
@@ -1174,6 +1186,22 @@ function createAgentsApi(cfg, relatedApis) {
     throw new WorkspaceNotSelectedError();
   };
   const jsonHeaders = { "content-type": "application/json" };
+  const normalizeCloneSelection = (selection) => {
+    if (!selection) {
+      return [];
+    }
+    if (Array.isArray(selection)) {
+      return selection;
+    }
+    return Object.entries(selection).filter(([, enabled]) => enabled).map(([component]) => component);
+  };
+  const buildCloneAgentRequest = (payload) => {
+    const { clone, ...rest } = payload;
+    return {
+      ...rest,
+      clone: normalizeCloneSelection(clone)
+    };
+  };
   const fetchAgentsPage = async (options = {}) => {
     requireWorkspace();
     const sanitizedOptions = {
@@ -1218,6 +1246,16 @@ function createAgentsApi(cfg, relatedApis) {
     });
     return res.json();
   };
+  const cloneAgent = async (agentId, payload) => {
+    requireWorkspace();
+    const requestPayload = buildCloneAgentRequest(payload);
+    const res = await doFetch(`${base}/agents/${agentId}/clone`, {
+      method: "POST",
+      body: JSON.stringify(requestPayload),
+      headers: jsonHeaders
+    });
+    return res.json();
+  };
   const updateAgent = async (agentId, payload) => {
     requireWorkspace();
     const res = await doFetch(`${base}/agents/${agentId}`, {
@@ -1241,6 +1279,7 @@ function createAgentsApi(cfg, relatedApis) {
     list: listAgents,
     get: getAgentDetail,
     create: createAgent,
+    clone: cloneAgent,
     forkFromTemplate: forkAgentFromTemplate,
     update: updateAgent,
     delete: deleteAgent
@@ -1267,6 +1306,10 @@ function createAgentsApi(cfg, relatedApis) {
     },
     deleteAgent: async (agentId) => {
       await deleteAgent(agentId);
+    },
+    cloneAgent: async (agentId, payload) => {
+      const cloned = await cloneAgent(agentId, payload);
+      return wrapAgent(cloned);
     }
   });
   return {
@@ -1292,6 +1335,10 @@ function createAgentsApi(cfg, relatedApis) {
       const detail = await createAgent(payload);
       return wrapAgent(detail);
     },
+    async clone(agentId, payload) {
+      const detail = await cloneAgent(agentId, payload);
+      return wrapAgent(detail);
+    },
     async forkFromTemplate(payload) {
       const detail = await forkAgentFromTemplate(payload);
       return wrapAgent(detail);
@@ -1334,6 +1381,82 @@ function createApiKeysApi(cfg) {
   };
 }
 
+// src/api/billing.ts
+function createBillingApi(cfg) {
+  const { base, doFetch } = createHttp(cfg);
+  return {
+    async getBalance() {
+      const res = await doFetch(`${base}/billing/balance`, {
+        method: "GET"
+      });
+      return res.json();
+    }
+  };
+}
+
+// src/api/calls.ts
+function createCallsApi(cfg) {
+  const { base, doFetch } = createHttp(cfg);
+  const fetchCallsPage = async (options = {}) => {
+    const {
+      agentBatchId,
+      agentId,
+      executionId,
+      recordedAfter,
+      recordedBefore,
+      durationBucket,
+      goalStatus,
+      query: searchQuery,
+      ...listOptions
+    } = options ?? {};
+    const query = serializeListOptions(listOptions, {
+      agentBatchId,
+      agentId,
+      executionId,
+      recordedAfter,
+      recordedBefore,
+      durationBucket,
+      goalStatus,
+      query: searchQuery
+    });
+    const res = await doFetch(`${base}/calls`, {
+      method: "GET",
+      query
+    });
+    return res.json();
+  };
+  return {
+    async list(options = {}) {
+      const normalizedOptions = { ...options ?? {} };
+      const response = await fetchCallsPage(normalizedOptions);
+      return attachPaginator(response, fetchCallsPage, normalizedOptions);
+    },
+    async stream(options) {
+      const query = buildSearchParams([
+        ["after", options.after],
+        ["limit", options.limit],
+        ["agentBatchId", options.agentBatchId],
+        ["agentId", options.agentId],
+        ["executionId", options.executionId],
+        ["durationBucket", options.durationBucket],
+        ["goalStatus", options.goalStatus],
+        ["query", options.query]
+      ]);
+      const res = await doFetch(`${base}/calls/stream`, {
+        method: "GET",
+        query
+      });
+      return res.json();
+    },
+    async get(callId) {
+      const res = await doFetch(`${base}/calls/${callId}`, {
+        method: "GET"
+      });
+      return res.json();
+    }
+  };
+}
+
 // src/api/campaigns.ts
 function createCampaignsApi(cfg) {
   const { base, doFetch } = createHttp(cfg);
@@ -1675,6 +1798,33 @@ function createToolsApi(cfg) {
   };
 }
 
+// src/api/usage.ts
+function createUsageApi(cfg) {
+  const { base, doFetch } = createHttp(cfg);
+  const fetchUsageAgentsPage = async (options = {}) => {
+    const { resource, from, to, ...listOptions } = options ?? {};
+    const query = serializeListOptions(listOptions, {
+      resource,
+      from,
+      to
+    });
+    const res = await doFetch(`${base}/usage/agents`, {
+      method: "GET",
+      query
+    });
+    return res.json();
+  };
+  return {
+    async agents(options = {}) {
+      const normalizedOptions = {
+        ...options ?? {}
+      };
+      const response = await fetchUsageAgentsPage(normalizedOptions);
+      return attachPaginator(response, fetchUsageAgentsPage, normalizedOptions);
+    }
+  };
+}
+
 // src/utils/catalog-voices.ts
 var FALLBACK_LOCALE = "und";
 var FALLBACK_PROVIDER = "catalog";
@@ -1971,6 +2121,35 @@ function createWebhooksApi(cfg) {
         `${base}/webhooks/${webhookId}/subscriptions/${subscriptionId}`,
         { method: "DELETE" }
       );
+    },
+    // Deliveries
+    async listDeliveries(webhookId, options = {}) {
+      const fetchPage = async (opts) => {
+        const query = serializeListOptions({
+          page: opts.page,
+          limit: opts.limit,
+          sort: opts.sort,
+          fields: opts.fields,
+          include: opts.include,
+          search: opts.search,
+          filter: opts.filter
+        });
+        const res = await doFetch(`${base}/webhooks/${webhookId}/deliveries`, {
+          method: "GET",
+          query
+        });
+        return res.json();
+      };
+      const normalized = { ...options ?? {} };
+      const response = await fetchPage(normalized);
+      return attachPaginator(response, fetchPage, normalized);
+    },
+    async getDelivery(webhookId, deliveryId) {
+      const res = await doFetch(
+        `${base}/webhooks/${webhookId}/deliveries/${deliveryId}`,
+        { method: "GET" }
+      );
+      return res.json();
     }
   };
 }
@@ -2034,8 +2213,8 @@ function createWorkspacesApi(cfg) {
       const fetchPage = (options) => fetchPhonesPage(workspaceId, options);
       return attachPaginator(response, fetchPage, normalizedOptions);
     },
-    async enable(workspaceId, payload) {
-      const res = await doFetch(`${base}/workspaces/${workspaceId}/enable`, {
+    async enable(payload) {
+      const res = await doFetch(`${base}/workspaces/enable`, {
         method: "POST",
         headers: jsonHeaders,
         body: JSON.stringify(payload)
@@ -2081,6 +2260,7 @@ function createClient(initialCfg) {
   const stagesApi = createAgentStagesApi(runtimeCfg);
   const voicesApi = createVoicesApi(runtimeCfg);
   const apiKeysApi = createApiKeysApi(runtimeCfg);
+  const callsApi = createCallsApi(runtimeCfg);
   const catalogsApi = createCatalogsApi(runtimeCfg);
   const catalogTemplatesApi = createCatalogTemplatesApi(runtimeCfg);
   const webhooksApi = createWebhooksApi(runtimeCfg);
@@ -2152,6 +2332,9 @@ function createClient(initialCfg) {
     campaigns: createCampaignsApi(runtimeCfg),
     voices: voicesApi,
     apiKeys: apiKeysApi,
+    billing: createBillingApi(runtimeCfg),
+    calls: callsApi,
+    usage: createUsageApi(runtimeCfg),
     webhooks: webhooksApi
   };
   return {
@@ -2235,12 +2418,15 @@ function createClient(initialCfg) {
   createAgentVersionsApi,
   createAgentsApi,
   createApiKeysApi,
+  createBillingApi,
+  createCallsApi,
   createCampaignsApi,
   createCatalogTemplatesApi,
   createCatalogsApi,
   createClient,
   createHttp,
   createToolsApi,
+  createUsageApi,
   createVoicesApi,
   createWebhooksApi,
   createWorkspacesApi,