@getsupervisor/agents-studio-sdk 1.23.0 → 1.25.0

package/CHANGELOG.md

@@ -1,3 +1,28 @@
+## v1.24.0
+
+## [1.24.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.23.0...v1.24.0) (2025-11-05)
+
+### Features
+
+* add optional avatarUrl and debounceDelayMs to agent schema ([b909f45](https://github.com/julio-supervisor/agents-studio-be/commit/b909f457ef82df455e77ae8ec772a4ff1de3b763))
+* 
+## v1.23.0
+
+## [1.23.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.22.2...v1.23.0) (2025-11-05)
+
+### Features
+
+* implement Agent Stages and Triggers API ([c0b997f](https://github.com/julio-supervisor/agents-studio-be/commit/c0b997fd233f8cb1fb4fc2f43b36344e46675191))
+
+## v1.22.2
+
+## [1.22.2](https://github.com/julio-supervisor/agents-studio-be/compare/v1.22.1...v1.22.2) (2025-11-03)
+
+### Bug Fixes
+
+* update API base URL to production endpoint across multiple files ([7491ce7](https://github.com/julio-supervisor/agents-studio-be/commit/7491ce700f348682d6559a5f3e9cf93f4aa9bc70))
+
+
 ## v1.22.1
 
 ## [1.22.1](https://github.com/julio-supervisor/agents-studio-be/compare/v1.22.0...v1.22.1) (2025-11-03)

package/README.md

@@ -164,6 +164,49 @@ const v2 = await client.agentVersions.clone(agent.agentId, active.id);
 
 Estados soportados: `draft`, `active`, `archived`.
 
+## Stages del blueprint
+
+Modela el flujo conversacional de cada agente con los helpers `client.agents.stages(agentId)`.
+
+```ts
+const stages = client.agents.stages(agent.agentId);
+
+// Paginar stages existentes
+const page = await stages.list({ limit: 10, search: 'greeting' });
+console.log(page.meta.total);
+
+// Crear un stage
+const created = await stages.create({
+  name: 'proposal',
+  title: 'Propuesta y cierre',
+  prompt: 'Explica la solución recomendada y ofrece una llamada con humano.',
+  order: 2,
+  metadata: { requiresSupervisor: false },
+});
+
+// Actualizar y reordenar
+await stages.update(created.id, {
+  prompt: 'Resume beneficios en < 3 bullets y ofrece agendar demo.',
+});
+
+await stages.reorder({
+  stageIds: [page.data[0].id, created.id],
+  startingStageName: 'greeting',
+});
+
+// Triggers por stage
+const triggers = stages.triggers(created.id);
+await triggers.create({
+  condition: { type: 'intent', value: 'schedule_call' },
+  nextStageName: 'handoff',
+});
+
+const listing = await triggers.list();
+console.log(listing.data[0].condition);
+```
+
+Los métodos de triggers permiten `list`, `get`, `create`, `update` y `delete`. Recuerda habilitar los scopes `stages:*` y `stage-triggers:*` en la credencial utilizada.
+
 ## Horarios del agente (Agent Schedules)
 
 Namespaces: `client.agentSchedule` y `client.agentScheduleExceptions`
@@ -427,6 +470,7 @@ Consulta el OpenAPI (`docs/api-spec/openapi.yaml`) para validar scopes adicional
 - **Guías de uso para voice.calls**: las conexiones creadas con `client.tools.connect('voice.calls', ...)` ahora devuelven valores predeterminados en `descriptionUsage` y `usageExample` (ver `docs/mcp/tools_execution.md`).
 - **Gestión de API Keys desde el SDK**: `client.apiKeys` expone helpers tipados para listar, crear y revocar credenciales con el mismo manejo de cabeceras, timeouts y reintentos del resto del cliente.
 - **Scopes documentados**: tabla de scopes disponibles y recomendaciones para definir permisos mínimos por workspace.
+- **Blueprint stages y triggers**: nuevos helpers `client.agents.stages(agentId)` y `stages.triggers(stageId)` para CRUD completo y reordenamiento del flujo conversacional.
 - **Mejoras de gobernanza**: se incorporaron pautas de rotación, almacenamiento seguro y segmentación por entorno directamente en la guía del SDK.
 - **Catálogos**: nuevo namespace `client.catalogs` con CRUD y paginación para `language`, `message_style`, `tone_style`, `tag` y `voice`.
 - **Versiones de agente**: namespace `client.agentVersions` con operaciones para crear, clonar, publicar y gestionar instrucciones por versión.

package/dist/index.cjs

@@ -1531,7 +1531,7 @@ function ensureCatalogTypeFilter(filter, type) {
   if (isQueryBuilderLike(filter)) {
     return ensureTypeForBuilder(filter, requiredQuery, requiredExpression);
   }
-  if (isPlainObject2(filter)) {
+  if (isFilterRecord(filter)) {
     return ensureTypeForObject(filter, type);
   }
   return filter;
@@ -1561,7 +1561,7 @@ function ensureTypeForObject(candidate, type) {
     return candidate;
   }
   const typeConfig = candidate.type;
-  const normalizedType = isPlainObject2(typeConfig) ? { ...typeConfig, eq: type } : { eq: type };
+  const normalizedType = isFilterOperators(typeConfig) ? { ...typeConfig, eq: type } : { eq: type };
   return {
     ...candidate,
     type: normalizedType
@@ -1572,10 +1572,11 @@ function hasTypeEquality(candidate, type) {
   if (typeof typeConfig === "string") {
     return typeConfig === type;
   }
-  if (!isPlainObject2(typeConfig)) {
+  if (!isFilterOperators(typeConfig)) {
     return false;
   }
-  return typeConfig.eq === type;
+  const equality = typeConfig.eq;
+  return typeof equality === "string" ? equality === type : false;
 }
 function containsTypePredicate(expression, required) {
   const normalizedExpression = expression.replace(/\s+/g, "").toLowerCase();
@@ -1592,6 +1593,12 @@ function isPlainObject2(value) {
   const proto = Object.getPrototypeOf(value);
   return proto === Object.prototype || proto === null;
 }
+function isFilterRecord(value) {
+  return isPlainObject2(value);
+}
+function isFilterOperators(value) {
+  return isPlainObject2(value);
+}
 
 // src/api/voices.ts
 function mapCatalogResponseToVoiceList(response) {