@getsupervisor/agents-studio-sdk 1.41.0-patch.4 → 1.41.1-beta.162
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +4 -4
- package/README.md +69 -20
- package/dist/index.cjs +598 -98
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +562 -35
- package/dist/index.d.ts +562 -35
- package/dist/index.js +593 -98
- package/dist/index.js.map +1 -1
- package/package.json +11 -6
package/CHANGELOG.md
CHANGED
|
@@ -93,7 +93,7 @@
|
|
|
93
93
|
|
|
94
94
|
### Features
|
|
95
95
|
|
|
96
|
-
- add default language constant and update
|
|
96
|
+
- add default language constant and update blueprint mapper to use it ([85d2d8c](https://github.com/julio-supervisor/agents-studio-be/commit/85d2d8ccc908254d351855158ecc09f14dbf6c6f))
|
|
97
97
|
- implement delete instruction functionality with command handler and controller ([af983f5](https://github.com/julio-supervisor/agents-studio-be/commit/af983f5254055d35d3972d0bcbdb12a52b48c785))
|
|
98
98
|
|
|
99
99
|
## v1.34.0
|
|
@@ -102,8 +102,8 @@
|
|
|
102
102
|
|
|
103
103
|
### Features
|
|
104
104
|
|
|
105
|
-
- enhance instruction management by adding active and non-deleted filtering, and integrate instructions into the
|
|
106
|
-
- implement VoiceBlueprintSyncService for
|
|
105
|
+
- 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))
|
|
106
|
+
- implement VoiceBlueprintSyncService for blueprint synchronization ([6b8f03f](https://github.com/julio-supervisor/agents-studio-be/commit/6b8f03f77ca1d2b91a9628db055e2799aa039f53))
|
|
107
107
|
- introduce buildClientMock helper for consistent workspaceId handling in tests ([ae6eb30](https://github.com/julio-supervisor/agents-studio-be/commit/ae6eb305b16f677dea03a21bdfc8559c13cc641a))
|
|
108
108
|
|
|
109
109
|
## v1.33.0
|
|
@@ -277,7 +277,7 @@
|
|
|
277
277
|
|
|
278
278
|
### Features
|
|
279
279
|
|
|
280
|
-
- Agrega `
|
|
280
|
+
- 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)).
|
|
281
281
|
|
|
282
282
|
## [1.19.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.18.0...v1.19.0) (2025-10-29)
|
|
283
283
|
|
package/README.md
CHANGED
|
@@ -397,6 +397,45 @@ npx tsx examples/custom-tool-connection.ts
|
|
|
397
397
|
|
|
398
398
|
El script envía la metadata de conexión (URL, método, headers) y, sobre todo, almacena un `configSchema` específico del workspace dentro de `tool_agent_connections.metadata`. Ese esquema describe los campos que el agente debe solicitar (en el ejemplo `agentId` y `customerName`) y coincide con la acción `triggerWorkflow` que expone el seed `custom.http.workflow`. Después de conectar la tool ejecuta `client.tools.execute('custom.http.workflow', { action: 'triggerWorkflow', args: { ... } })` respetando el schema definido en tu metadata.
|
|
399
399
|
|
|
400
|
+
## SIP Trunks
|
|
401
|
+
|
|
402
|
+
Namespace: `client.sip`
|
|
403
|
+
|
|
404
|
+
Gestiona trunks SIP para conectar agentes de voz a carriers PSTN (Twilio, ccc2.uno, etc.).
|
|
405
|
+
|
|
406
|
+
Operaciones disponibles:
|
|
407
|
+
|
|
408
|
+
- `sip.list()` — lista todos los SIP trunks del workspace.
|
|
409
|
+
- `sip.get(trunkId)` — obtiene un trunk por ID.
|
|
410
|
+
- `sip.create(payload)` — crea un trunk (devuelve `password` solo en la creación).
|
|
411
|
+
- `sip.update(trunkId, payload)` — actualiza un trunk (campos parciales).
|
|
412
|
+
- `sip.delete(trunkId)` — elimina un trunk y su subscriber asociado.
|
|
413
|
+
|
|
414
|
+
Ejemplo:
|
|
415
|
+
|
|
416
|
+
```ts
|
|
417
|
+
// crear un trunk SIP
|
|
418
|
+
const trunk = await client.sip.create({
|
|
419
|
+
name: 'Twilio Production',
|
|
420
|
+
carrierAddress: 'my-trunk.pstn.twilio.com',
|
|
421
|
+
// opcionales: carrierPort (default 5060), carrierTransport (default 'udp'), phoneNumbers
|
|
422
|
+
});
|
|
423
|
+
|
|
424
|
+
console.log(trunk.username); // auto-generado para SIP digest auth
|
|
425
|
+
console.log(trunk.password); // solo visible en la creación
|
|
426
|
+
|
|
427
|
+
// listar trunks del workspace
|
|
428
|
+
const trunks = await client.sip.list();
|
|
429
|
+
|
|
430
|
+
// actualizar
|
|
431
|
+
await client.sip.update(trunk.id, { name: 'Twilio Staging' });
|
|
432
|
+
|
|
433
|
+
// eliminar
|
|
434
|
+
await client.sip.delete(trunk.id);
|
|
435
|
+
```
|
|
436
|
+
|
|
437
|
+
Scopes requeridos: `sip:read` para lectura, `sip:write` para escritura.
|
|
438
|
+
|
|
400
439
|
## Configuración
|
|
401
440
|
|
|
402
441
|
```ts
|
|
@@ -524,26 +563,36 @@ const { key, ...metadata } = await http
|
|
|
524
563
|
|
|
525
564
|
### Scopes disponibles (octubre 2025)
|
|
526
565
|
|
|
527
|
-
| Scope | Permiso principal
|
|
528
|
-
| -------------------------- |
|
|
529
|
-
| `agents:read` |
|
|
530
|
-
| `agents:write` | Crear
|
|
531
|
-
| `agent-
|
|
532
|
-
| `agent-
|
|
533
|
-
| `agent-
|
|
534
|
-
| `agent-
|
|
535
|
-
| `agent-
|
|
536
|
-
| `agent-
|
|
537
|
-
| `
|
|
538
|
-
| `
|
|
539
|
-
| `
|
|
540
|
-
| `
|
|
541
|
-
| `
|
|
542
|
-
| `
|
|
543
|
-
| `
|
|
544
|
-
| `
|
|
545
|
-
| `
|
|
546
|
-
| `
|
|
566
|
+
| Scope | Permiso principal |
|
|
567
|
+
| -------------------------- | ------------------------------------------------------------------------- |
|
|
568
|
+
| `agents:read` | Listar y consultar agentes del workspace. |
|
|
569
|
+
| `agents:write` | Crear/actualizar/eliminar agentes y gestionar su configuración operativa. |
|
|
570
|
+
| `agent-versions:read` | Listar y consultar versiones de un agente. |
|
|
571
|
+
| `agent-versions:write` | Crear, clonar, restaurar y publicar versiones de un agente. |
|
|
572
|
+
| `agent-instructions:read` | Leer instrucciones (a nivel agente y por versión). |
|
|
573
|
+
| `agent-instructions:write` | Crear, actualizar o borrar instrucciones personalizadas. |
|
|
574
|
+
| `agent-blueprints:read` | Consultar el blueprint (personalidad) de una versión de agente. |
|
|
575
|
+
| `agent-blueprints:write` | Editar blueprint: personalidad, reglas, audiencia, objetivos, etc. |
|
|
576
|
+
| `blueprint-stages:read` | Listar y consultar stages del blueprint. |
|
|
577
|
+
| `blueprint-stages:write` | Crear, actualizar o reordenar stages del blueprint. |
|
|
578
|
+
| `stage-triggers:read` | Consultar triggers que conectan stages y sus condiciones. |
|
|
579
|
+
| `stage-triggers:write` | Crear, actualizar o eliminar triggers entre stages. |
|
|
580
|
+
| `agent-schedules:read` | Consultar horario semanal y excepciones vigentes. |
|
|
581
|
+
| `agent-schedules:write` | Crear o modificar horarios y excepciones. |
|
|
582
|
+
| `campaigns:read` | Consultar campañas y sus ejecuciones. |
|
|
583
|
+
| `campaigns:write` | Crear y disparar campañas batch. |
|
|
584
|
+
| `calls:read` | Consultar llamadas (Speech Analytics) del workspace. |
|
|
585
|
+
| `catalogs:read` | Navegar catálogos globales y por workspace (idiomas, tonos, voces, etc.). |
|
|
586
|
+
| `catalogs:write` | Registrar o ajustar ítems de catálogo. |
|
|
587
|
+
| `tools:read` | Descubrir tools disponibles, recursos y capacidades declaradas. |
|
|
588
|
+
| `tools:connections:read` | Listar conexiones configuradas entre agentes y tools. |
|
|
589
|
+
| `tools:connections:write` | Crear o actualizar conexiones entre agentes y tools. |
|
|
590
|
+
| `tools:execute` | Ejecutar acciones de una tool. |
|
|
591
|
+
| `webhooks:read` | Listar webhooks y sus suscripciones activas. |
|
|
592
|
+
| `webhooks:write` | Crear, actualizar o eliminar webhooks y suscripciones. |
|
|
593
|
+
| `api-keys:read` | Listar credenciales existentes y revelar su valor. |
|
|
594
|
+
| `api-keys:write` | Emitir o revocar API Keys. |
|
|
595
|
+
| `workspaces:read` | Consultar workspaces disponibles y sus metadatos. |
|
|
547
596
|
|
|
548
597
|
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.
|
|
549
598
|
|