@getsupervisor/agents-studio-sdk 1.3.0 → 1.5.0

package/CHANGELOG.md

@@ -1,3 +1,54 @@
+## v1.4.0
+
+## [1.4.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.3.0...v1.4.0) (2025-10-12)
+
+### Features
+
+* Add new SVG icons, images, and documentation updates for Agents Studio API ([3687495](https://github.com/julio-supervisor/agents-studio-be/commit/3687495640477794754b731e912d3f15b9e6db4e))
+* enhance API documentation for agent management and workspace onboarding processes ([819c26c](https://github.com/julio-supervisor/agents-studio-be/commit/819c26cb662401b60004828ac7364aebd7eca039))
+
+## v1.3.0
+
+## [1.3.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.2.0...v1.3.0) (2025-10-11)
+
+### Features
+
+* actualizar la configuración de autenticación de npm para usar NODE_AUTH_TOKEN en los flujos de trabajo de despliegue y pruebas ([1817bde](https://github.com/julio-supervisor/agents-studio-be/commit/1817bdef6894d52d8be9b6c9649894446ae8dbf4))
+* actualizar la versión de @getsupervisor/api-query-builder a 1.3.0 y agregar script de ejemplos ([dfc83c5](https://github.com/julio-supervisor/agents-studio-be/commit/dfc83c5c7ffccac704a4212c20f054b37bf4c620))
+* **agents:** mejorar la API de agentes para incluir entidades y respuestas con datos adicionales ([7f0103a](https://github.com/julio-supervisor/agents-studio-be/commit/7f0103a4fd881f74cacaa7057562998ad6cd12a5))
+* agregar autenticación npm en flujos de trabajo y mejorar ejemplos de agente ([7ef9dd5](https://github.com/julio-supervisor/agents-studio-be/commit/7ef9dd54f548d017609e143f1a06200b8e7da121))
+* agregar configuración de autenticación npm para el alcance [@getsupervisor](https://github.com/getsupervisor) en flujos de trabajo ([7cd5890](https://github.com/julio-supervisor/agents-studio-be/commit/7cd5890936e96318f52852898a9d740b87b1eb2f))
+* agregar exclusión de ejemplos de SDK en tsconfig.build.json ([5fe700c](https://github.com/julio-supervisor/agents-studio-be/commit/5fe700c48a04f0419729bdb854f18ad7580d5850))
+* ajustar el directorio de trabajo y mejorar la depuración de autenticación npm en el flujo de trabajo de lanzamiento ([acef050](https://github.com/julio-supervisor/agents-studio-be/commit/acef0502b58d9edd15abf1d252c4c33052536661))
+* ajustar el directorio de trabajo y simplificar la instalación de dependencias en el flujo de trabajo de lanzamiento ([dd2b009](https://github.com/julio-supervisor/agents-studio-be/commit/dd2b0090f3e781472fb1401290ba7e971c4c7b17))
+* **api:** add query builder utilities and enhance OpenAPI spec ([1a6744a](https://github.com/julio-supervisor/agents-studio-be/commit/1a6744ac73c0eb4b5e35a7aadfb8093012c18b29))
+* especificar la ruta del Dockerfile en el proceso de construcción de la imagen ([1a7ac54](https://github.com/julio-supervisor/agents-studio-be/commit/1a7ac5406072a81b316e41014ad9bf482b9733fb))
+* habilitar la ejecución manual del flujo de trabajo de lanzamiento del SDK ([25c3654](https://github.com/julio-supervisor/agents-studio-be/commit/25c365481c81a9d7408e8846aee77af193c271e6))
+* reemplazar npm por yarn para la instalación de dependencias y construcción del paquete ([7f09844](https://github.com/julio-supervisor/agents-studio-be/commit/7f09844a26c311e6762570338063ff1a37002ee7))
+* simplificar la configuración de autenticación npm en el flujo de trabajo de lanzamiento ([94fce18](https://github.com/julio-supervisor/agents-studio-be/commit/94fce181286649a276e5556eb256ac6b62ac178e))
+
+## v1.2.0
+
+## [1.2.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.1.0...v1.2.0) (2025-10-10)
+
+### Features
+
+* **authorization:** mejorar la configuración y pruebas del sistema de autorización ([d963e9d](https://github.com/julio-supervisor/agents-studio-be/commit/d963e9da8d0f97547c7fb93b9b2fb5689e164cbb))
+* **authz:** add casbin authorization module and tests ([2340f5f](https://github.com/julio-supervisor/agents-studio-be/commit/2340f5f0dc6e3a439b78e8147053c30762cd9dad))
+* **authz:** ajustar rutas de mapeo y mejorar pruebas de autorización ([d8e10ef](https://github.com/julio-supervisor/agents-studio-be/commit/d8e10efcbcf41e07b929fa9578ec65d947d83c66))
+* **authz:** implementar configuración de características de la aplicación y adaptador Casbin sin operaciones ([74599a7](https://github.com/julio-supervisor/agents-studio-be/commit/74599a722452c19599e13be3318a096400a9b8e0))
+* **authz:** refactor NullAuthorizationCache methods and improve policy management logic ([93beddf](https://github.com/julio-supervisor/agents-studio-be/commit/93beddfdb832ab7d3d0562c42e99fdae6eb9fb8b))
+* **docker:** agregar copiado de modelos de Casbin y políticas en el Dockerfile ([8122479](https://github.com/julio-supervisor/agents-studio-be/commit/81224793ed1d6756734f884a1e01950713885ec8))
+* **docker:** ajustar Dockerfile para construir desde el directorio correcto y mejorar la gestión de dependencias ([b382edf](https://github.com/julio-supervisor/agents-studio-be/commit/b382edfd7aaac87b2f8c88cc8f9b270abeaff3a9))
+* enhance agent management with new API endpoints and entity bindings ([ff7fd49](https://github.com/julio-supervisor/agents-studio-be/commit/ff7fd49c572828b394cbc3724568cc1ac3a81664))
+* **issue-templates:** agregar plantillas para reportes de bugs, solicitudes de características y problemas de documentación ([eae8404](https://github.com/julio-supervisor/agents-studio-be/commit/eae840448e403afa783dd5301ff2ebe0e811a724))
+
+### Bug Fixes
+
+* **docker:** corregir rutas en el entrypoint y el comando de inicio para la aplicación ([a8e0c0b](https://github.com/julio-supervisor/agents-studio-be/commit/a8e0c0b7adcb1de5b6a409e99dfc4c4f6c4247ef))
+* **migrations:** corregir rutas de migraciones para asegurar la correcta ejecución ([b2a7ed1](https://github.com/julio-supervisor/agents-studio-be/commit/b2a7ed1eaa153a77646220e7d57d61653bb07919))
+
+
 ## v1.1.0
 
 ## [1.1.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.0.0...v1.1.0) (2025-10-09)

package/README.md

@@ -1,34 +1,39 @@
-# @getsupervisor/conversation-sdk
+# @getsupervisor/agents-studio-sdk
 
-SDK JS/TS para conectar con Conversational API.
+SDK JS/TS oficial para interactuar con la Public API de Agents Studio.
 
 ## Instalación
 
 ```bash
-npm i @getsupervisor/conversation-sdk
+npm i @getsupervisor/agents-studio-sdk
 ```
 
 ## Uso básico
 
 ```ts
-import { createClient } from '@getsupervisor/conversation-sdk';
+import { createClient } from '@getsupervisor/agents-studio-sdk';
 
-const client = createClient({ baseUrl: 'http://localhost:3000/v1' });
-const id = 'a3b2c1...';
+const client = createClient({
+  baseUrl: 'https://public-api.getsupervisor.ai',
+  headers: { Authorization: 'Bearer <token>' },
+  workspaceId: 'ws-123',
+});
 
-// iniciar auth y obtener QR
-const qr = await client.connections.auth(id);
-console.log(qr.qr);
+const { data: agents } = await client.agents.list({ limit: 10 });
+const agent = await client.agents.get('agent-123');
 
-// escuchar eventos SSE
-const off = client.connections.onEvents(id, (e) => console.log('evt', e.data));
+// administrar versiones e instrucciones
+await client.agents
+  .versions(agent.agentId)
+  .instructions('version-1')
+  .create({ order: 1, content: 'Saluda con empatía' });
 
-// obtener estado
-const state = await client.connections.getState(id);
+// catálogo y recursos de tools
+const tools = await client.tools.list({ agentType: 'chat' });
+await client.tools.uploadResource(tools.data[0].identifier, formData);
 
-// cerrar sesión
-await client.connections.disconnect(id);
-off();
+// eliminar un agente
+await client.agents.delete(agent.agentId);
 ```
 
 ## Configuración
@@ -69,16 +74,19 @@ const scoped = client.workspace.scoped('ws-789');
 await scoped.agents.get('agentId');
 ```
 
+## Novedades (septiembre 2024)
+
+- **Sincronización completa con el OpenAPI más reciente**: se regeneraron los tipos `openapi-types.ts` y se actualizó la superficie pública para reflejar nuevos contratos.
+- **Instrucciones por versión**: ahora puedes gestionar instrucciones directamente sobre versiones (`client.agents.versions(...).instructions(...)`) incluyendo operaciones de listar, crear, actualizar y eliminar.
+- **Catálogo y recursos de tools**: soporte para listar tools filtrando por `agentType`, subir/eliminar/recargar recursos y establecer conexiones (`connect`) de manera tipada.
+- **Deprecación de knowledge en agentes**: las rutas de knowledge fueron removidas del API. El helper anterior arroja un error explícito y los tipos asociados ya no se exportan.
+- **Pruebas actualizadas**: la suite de Vitest se ajustó para cubrir helpers de versiones e instrucciones; `npm test` reporta 11 pruebas exitosas.
+
 ## Errores tipados y reintentos
 
-- HttpError(status, statusText, body)
-- TimeoutError(ms)
-- NetworkError(cause)
-- Política de reintentos con backoff exponencial y jitter.
+Los errores siguen modelados como `HttpError`, `TimeoutError` y `NetworkError`. Puedes configurar la política de reintentos con `retry: { maxRetries, baseDelayMs }` en el `createClient`.
 
 ## Compatibilidad
 
 - Soporta ESM y CJS.
-- Navegador y Node (requiere EventSource global o polyfill para SSE).
-
-..
+- Compatible con navegadores y Node.js (requiere `fetch` y `FormData` disponibles en el entorno).