@getsupervisor/agents-studio-sdk 1.24.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.d.cts

@@ -882,10 +882,25 @@ type UpdateAgentBlueprintRequest = {
     topicsAllowed?: string[];
     topicsForbidden?: string[];
 };
-type BlueprintStage = components['schemas']['BlueprintStage'];
-type BlueprintStageListResponse = components['schemas']['BlueprintStageListResponse'];
-type CreateBlueprintStageRequest = components['schemas']['CreateBlueprintStageRequest'];
-type UpdateBlueprintStageRequest = components['schemas']['UpdateBlueprintStageRequest'];
+type BlueprintStageSchema = components['schemas']['BlueprintStage'];
+type BlueprintStage = Omit<BlueprintStageSchema, 'prompt' | 'promptInstructions'> & {
+    goalPrompt: string;
+    promptInstructions: string[];
+};
+type BlueprintStageListResponseSchema = components['schemas']['BlueprintStageListResponse'];
+type BlueprintStageListResponse = Omit<BlueprintStageListResponseSchema, 'data'> & {
+    data: BlueprintStage[];
+};
+type CreateBlueprintStageRequestSchema = components['schemas']['CreateBlueprintStageRequest'];
+type CreateBlueprintStageRequest = Omit<CreateBlueprintStageRequestSchema, 'prompt'> & {
+    goalPrompt: string;
+    promptInstructions?: string[];
+};
+type UpdateBlueprintStageRequestSchema = components['schemas']['UpdateBlueprintStageRequest'];
+type UpdateBlueprintStageRequest = Omit<UpdateBlueprintStageRequestSchema, 'prompt'> & {
+    goalPrompt?: string;
+    promptInstructions?: string[];
+};
 type BlueprintStageReorderRequest = components['schemas']['BlueprintStageReorderRequest'];
 type BlueprintStageTrigger = components['schemas']['BlueprintStageTrigger'];
 type BlueprintStageTriggerListResponse = components['schemas']['BlueprintStageTriggerListResponse'];
@@ -1139,10 +1154,7 @@ declare const bindAgentStageTriggers: (api: AgentStageTriggersApi, agentId: stri
     delete(triggerId: string): Promise<void>;
 };
 declare const bindAgentStages: (stagesApi: AgentStagesApi, triggersApi: AgentStageTriggersApi, agentId: string) => {
-    list(opts?: ListAgentStagesOptions): Promise<PaginatedResult<{
-        data: components["schemas"]["BlueprintStage"][];
-        meta: components["schemas"]["PaginationMeta"];
-    }, Partial<{
+    list(opts?: ListAgentStagesOptions): Promise<PaginatedResult<BlueprintStageListResponse, Partial<{
         page: number;
         limit: number;
         sort: string | string[];
@@ -1153,41 +1165,10 @@ declare const bindAgentStages: (stagesApi: AgentStagesApi, triggersApi: AgentSta
         or: QueryOrGroups | QueryBuilderInput;
     }>>>;
     get(stageId: string): Promise<BlueprintStage>;
-    create(payload: CreateBlueprintStageRequest): Promise<{
-        id: string;
-        agentId: string;
-        blueprintId: string;
-        name: string;
-        title?: string | null;
-        prompt: string;
-        order: number;
-        triggers: components["schemas"]["BlueprintStageTrigger"][];
-        metadata?: {
-            [key: string]: unknown;
-        } | null;
-        createdAt: string;
-        updatedAt: string;
-    }>;
-    update(stageId: string, payload: UpdateBlueprintStageRequest): Promise<{
-        id: string;
-        agentId: string;
-        blueprintId: string;
-        name: string;
-        title?: string | null;
-        prompt: string;
-        order: number;
-        triggers: components["schemas"]["BlueprintStageTrigger"][];
-        metadata?: {
-            [key: string]: unknown;
-        } | null;
-        createdAt: string;
-        updatedAt: string;
-    }>;
+    create(payload: CreateBlueprintStageRequest): Promise<BlueprintStage>;
+    update(stageId: string, payload: UpdateBlueprintStageRequest): Promise<BlueprintStage>;
     delete(stageId: string): Promise<void>;
-    reorder(payload: BlueprintStageReorderRequest): Promise<{
-        data: components["schemas"]["BlueprintStage"][];
-        meta: components["schemas"]["PaginationMeta"];
-    }>;
+    reorder(payload: BlueprintStageReorderRequest): Promise<BlueprintStageListResponse>;
     triggers(stageId: string): AgentStageTriggersHelper;
 };
 declare const bindAgentTags: (api: AgentTagsApi, agentId: string) => {

package/dist/index.d.ts

@@ -882,10 +882,25 @@ type UpdateAgentBlueprintRequest = {
     topicsAllowed?: string[];
     topicsForbidden?: string[];
 };
-type BlueprintStage = components['schemas']['BlueprintStage'];
-type BlueprintStageListResponse = components['schemas']['BlueprintStageListResponse'];
-type CreateBlueprintStageRequest = components['schemas']['CreateBlueprintStageRequest'];
-type UpdateBlueprintStageRequest = components['schemas']['UpdateBlueprintStageRequest'];
+type BlueprintStageSchema = components['schemas']['BlueprintStage'];
+type BlueprintStage = Omit<BlueprintStageSchema, 'prompt' | 'promptInstructions'> & {
+    goalPrompt: string;
+    promptInstructions: string[];
+};
+type BlueprintStageListResponseSchema = components['schemas']['BlueprintStageListResponse'];
+type BlueprintStageListResponse = Omit<BlueprintStageListResponseSchema, 'data'> & {
+    data: BlueprintStage[];
+};
+type CreateBlueprintStageRequestSchema = components['schemas']['CreateBlueprintStageRequest'];
+type CreateBlueprintStageRequest = Omit<CreateBlueprintStageRequestSchema, 'prompt'> & {
+    goalPrompt: string;
+    promptInstructions?: string[];
+};
+type UpdateBlueprintStageRequestSchema = components['schemas']['UpdateBlueprintStageRequest'];
+type UpdateBlueprintStageRequest = Omit<UpdateBlueprintStageRequestSchema, 'prompt'> & {
+    goalPrompt?: string;
+    promptInstructions?: string[];
+};
 type BlueprintStageReorderRequest = components['schemas']['BlueprintStageReorderRequest'];
 type BlueprintStageTrigger = components['schemas']['BlueprintStageTrigger'];
 type BlueprintStageTriggerListResponse = components['schemas']['BlueprintStageTriggerListResponse'];
@@ -1139,10 +1154,7 @@ declare const bindAgentStageTriggers: (api: AgentStageTriggersApi, agentId: stri
     delete(triggerId: string): Promise<void>;
 };
 declare const bindAgentStages: (stagesApi: AgentStagesApi, triggersApi: AgentStageTriggersApi, agentId: string) => {
-    list(opts?: ListAgentStagesOptions): Promise<PaginatedResult<{
-        data: components["schemas"]["BlueprintStage"][];
-        meta: components["schemas"]["PaginationMeta"];
-    }, Partial<{
+    list(opts?: ListAgentStagesOptions): Promise<PaginatedResult<BlueprintStageListResponse, Partial<{
         page: number;
         limit: number;
         sort: string | string[];
@@ -1153,41 +1165,10 @@ declare const bindAgentStages: (stagesApi: AgentStagesApi, triggersApi: AgentSta
         or: QueryOrGroups | QueryBuilderInput;
     }>>>;
     get(stageId: string): Promise<BlueprintStage>;
-    create(payload: CreateBlueprintStageRequest): Promise<{
-        id: string;
-        agentId: string;
-        blueprintId: string;
-        name: string;
-        title?: string | null;
-        prompt: string;
-        order: number;
-        triggers: components["schemas"]["BlueprintStageTrigger"][];
-        metadata?: {
-            [key: string]: unknown;
-        } | null;
-        createdAt: string;
-        updatedAt: string;
-    }>;
-    update(stageId: string, payload: UpdateBlueprintStageRequest): Promise<{
-        id: string;
-        agentId: string;
-        blueprintId: string;
-        name: string;
-        title?: string | null;
-        prompt: string;
-        order: number;
-        triggers: components["schemas"]["BlueprintStageTrigger"][];
-        metadata?: {
-            [key: string]: unknown;
-        } | null;
-        createdAt: string;
-        updatedAt: string;
-    }>;
+    create(payload: CreateBlueprintStageRequest): Promise<BlueprintStage>;
+    update(stageId: string, payload: UpdateBlueprintStageRequest): Promise<BlueprintStage>;
     delete(stageId: string): Promise<void>;
-    reorder(payload: BlueprintStageReorderRequest): Promise<{
-        data: components["schemas"]["BlueprintStage"][];
-        meta: components["schemas"]["PaginationMeta"];
-    }>;
+    reorder(payload: BlueprintStageReorderRequest): Promise<BlueprintStageListResponse>;
     triggers(stageId: string): AgentStageTriggersHelper;
 };
 declare const bindAgentTags: (api: AgentTagsApi, agentId: string) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getsupervisor/agents-studio-sdk",
-  "version": "1.24.0",
+  "version": "1.25.0",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",