@getsupervisor/agents-studio-sdk 1.41.2-patch.3 → 1.41.2-patch.5

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,6 +43,7 @@ __export(index_exports, {
   createAgentVersionsApi: () => createAgentVersionsApi,
   createAgentsApi: () => createAgentsApi,
   createApiKeysApi: () => createApiKeysApi,
+  createCallsApi: () => createCallsApi,
   createCampaignsApi: () => createCampaignsApi,
   createCatalogTemplatesApi: () => createCatalogTemplatesApi,
   createCatalogsApi: () => createCatalogsApi,
@@ -259,6 +260,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);
@@ -1334,6 +1340,60 @@ function createApiKeysApi(cfg) {
   };
 }
 
+// src/api/calls.ts
+function createCallsApi(cfg) {
+  const { base, doFetch } = createHttp(cfg);
+  const fetchCallsPage = async (options = {}) => {
+    const {
+      agentBatchId,
+      agentId,
+      executionId,
+      recordedAfter,
+      recordedBefore,
+      ...listOptions
+    } = options ?? {};
+    const query = serializeListOptions(listOptions, {
+      agentBatchId,
+      agentId,
+      executionId,
+      recordedAfter,
+      recordedBefore
+    });
+    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]
+      ]);
+      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);
@@ -2081,6 +2141,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 +2213,7 @@ function createClient(initialCfg) {
     campaigns: createCampaignsApi(runtimeCfg),
     voices: voicesApi,
     apiKeys: apiKeysApi,
+    calls: callsApi,
     webhooks: webhooksApi
   };
   return {
@@ -2235,6 +2297,7 @@ function createClient(initialCfg) {
   createAgentVersionsApi,
   createAgentsApi,
   createApiKeysApi,
+  createCallsApi,
   createCampaignsApi,
   createCatalogTemplatesApi,
   createCatalogsApi,