@getsupervisor/agents-studio-sdk 1.31.0 → 1.33.0

package/CHANGELOG.md

@@ -1,3 +1,56 @@
+## v1.32.0
+
+## [1.32.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.31.0...v1.32.0) (2025-11-14)
+
+### Features
+
+* add AgentVersionsApi and related functionality ([c797b12](https://github.com/julio-supervisor/agents-studio-be/commit/c797b12e41d717cb7e0b29cc387a0fd4ff929d2e))
+* add API reference documentation for agent templates and update navigation structure ([103c67d](https://github.com/julio-supervisor/agents-studio-be/commit/103c67dee465cea19819a10967ea62a4aa9f9493))
+* add endpoint to create agent from template with request schema and response examples ([0f4b9a3](https://github.com/julio-supervisor/agents-studio-be/commit/0f4b9a327f388edb2bf6eb1d724aa4585f530359))
+* create migration for agent_instructions table with foreign key constraints ([f5cadbd](https://github.com/julio-supervisor/agents-studio-be/commit/f5cadbdad5601a8ffd761781284a408650f7f097))
+* implement reorder blueprint stages functionality with command and handler ([8d2f6c9](https://github.com/julio-supervisor/agents-studio-be/commit/8d2f6c901e03851d3960abde340ca96191ecdf89))
+
+### Bug Fixes
+
+* correct description formatting for UpdateAgentBlueprintRequest in API documentation ([8e0ebce](https://github.com/julio-supervisor/agents-studio-be/commit/8e0ebced952516965e3cfc8778bbdb20297810ab))
+* remove unused CatalogItemsCreateTool and CatalogItemsDeleteTool imports from mcp.module.ts ([d787d4e](https://github.com/julio-supervisor/agents-studio-be/commit/d787d4e707fdbab229f988de375183d3707bde12))
+
+## v1.31.0
+
+## [1.31.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.30.0...v1.31.0) (2025-11-10)
+
+### Features
+
+* add migration for Prospecting Agent Template with initial agent configuration and stages ([0560563](https://github.com/julio-supervisor/agents-studio-be/commit/05605631e051c7cd4705e34bc3c76c90f8373702))
+
+### Bug Fixes
+
+* update endpoint path for forking agents from template to use correct URL format ([9d00f93](https://github.com/julio-supervisor/agents-studio-be/commit/9d00f9350b33847a6fd582417654336769c645c3))
+
+## v1.30.0
+
+## [1.30.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.29.0...v1.30.0) (2025-11-10)
+
+### Features
+
+* implement catalog templates API and tools, including listing and filtering functionality ([9467fb2](https://github.com/julio-supervisor/agents-studio-be/commit/9467fb21c19a35f45e8ec8dcb2bfc26254558371))
+* use forwardRef for AgentBlueprintsModule import in blueprint-stages.module.ts ([63420a1](https://github.com/julio-supervisor/agents-studio-be/commit/63420a1710305fee8e22f0826665b0eedb866107))
+* 
+## v1.29.0
+
+## [1.29.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.28.0...v1.29.0) (2025-11-10)
+
+### Features
+
+* add comprehensive tests for catalog templates, including handlers, controller, and DTOs; implement in-memory repository specifications ([1a2d81e](https://github.com/julio-supervisor/agents-studio-be/commit/1a2d81e1b25d4495c240d8af021894e30c6a814c))
+* add ForkAgentFromTemplateRequest schema and endpoint ([394c9d7](https://github.com/julio-supervisor/agents-studio-be/commit/394c9d7ed327f0a7cccedf0e8b18218357976c15))
+* add unit tests for CatalogTemplateTypeormSpecificationFactory, covering various filtering and ordering scenarios ([827825b](https://github.com/julio-supervisor/agents-studio-be/commit/827825b55cf97ab21de8698025ad611abe377771))
+
+### Bug Fixes
+
+* update workspaceId parameter to be required in createAgent and forkAgentFromTemplate methods; improve error messages for UUID validation ([b272a8f](https://github.com/julio-supervisor/agents-studio-be/commit/b272a8fbc1b56a9d511bb2ecc904d8aed59c07b6))
+
+
 ## v1.27.0
 
 ## [1.27.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.26.1...v1.27.0) (2025-11-08)

package/README.md

@@ -22,15 +22,29 @@ const client = createClient({
 const { data: agents } = await client.agents.list({ limit: 10 });
 const agent = await client.agents.get('agent-123');
 
+const { data: versions } = await client.agents
+  .versions(agent.agentId)
+  .list({ limit: 1 });
+const versionId = versions[0]?.id;
+if (!versionId) {
+  throw new Error('Agent has no versions yet');
+}
+
 // helpers de agente sin repetir IDs
-const instructions = client.agents.instructions(agent.agentId);
-await instructions.create({ order: 1, content: 'Responde en español neutro' });
+const instructions = client.agents
+  .versions(agent.agentId)
+  .instructions(versionId);
+await instructions.create({
+  order: 1,
+  content: 'Responde en español neutro',
+  status: 'inactive',
+});
 
 // administrar versiones e instrucciones
 await client.agents
   .versions(agent.agentId)
   .instructions('version-1')
-  .create({ order: 1, content: 'Saluda con empatía' });
+  .create({ order: 1, content: 'Saluda con empatía', status: 'active' });
 
 // administrar blueprints por versión
 const blueprints = client.agents.blueprints(agent.agentId);

package/dist/index.cjs

@@ -23,7 +23,6 @@ __export(index_exports, {
   NetworkError: () => NetworkError,
   TimeoutError: () => TimeoutError,
   bindAgentBlueprints: () => bindAgentBlueprints,
-  bindAgentInstructions: () => bindAgentInstructions,
   bindAgentPhones: () => bindAgentPhones,
   bindAgentSchedule: () => bindAgentSchedule,
   bindAgentScheduleExceptions: () => bindAgentScheduleExceptions,
@@ -33,7 +32,6 @@ __export(index_exports, {
   bindAgentVersions: () => bindAgentVersions,
   createAgentBlueprintsApi: () => createAgentBlueprintsApi,
   createAgentEntity: () => createAgentEntity,
-  createAgentInstructionsApi: () => createAgentInstructionsApi,
   createAgentPhonesApi: () => createAgentPhonesApi,
   createAgentScheduleApi: () => createAgentScheduleApi,
   createAgentScheduleExceptionsApi: () => createAgentScheduleExceptionsApi,
@@ -403,6 +401,27 @@ function createAgentBlueprintsApi(cfg) {
   };
 }
 
+// src/api/agent-phones.ts
+function createAgentPhonesApi(cfg) {
+  const { base, doFetch } = createHttp(cfg);
+  const jsonHeaders = { "content-type": "application/json" };
+  return {
+    async connect(agentId, payload) {
+      const res = await doFetch(`${base}/agents/${agentId}/phones`, {
+        method: "POST",
+        headers: jsonHeaders,
+        body: JSON.stringify(payload)
+      });
+      return res.json();
+    },
+    async disconnect(agentId, phoneId) {
+      await doFetch(`${base}/agents/${agentId}/phones/${phoneId}`, {
+        method: "DELETE"
+      });
+    }
+  };
+}
+
 // src/utils/pagination.ts
 var toNumber = (value) => {
   return typeof value === "number" ? value : void 0;
@@ -495,76 +514,6 @@ function attachPaginator(response, fetchPage, options) {
   });
 }
 
-// src/api/agent-instructions.ts
-function createAgentInstructionsApi(cfg) {
-  const { base, doFetch } = createHttp(cfg);
-  const jsonHeaders = { "content-type": "application/json" };
-  const fetchInstructionPage = async (agentId, opts = {}) => {
-    const { versionId, ...queryOptions } = opts ?? {};
-    const query = serializeListOptions(queryOptions, { versionId });
-    const res = await doFetch(`${base}/agents/${agentId}/instructions`, {
-      method: "GET",
-      query
-    });
-    return res.json();
-  };
-  return {
-    async list(agentId, opts = {}) {
-      const normalizedOptions = {
-        ...opts ?? {}
-      };
-      const fetchPage = (options) => fetchInstructionPage(agentId, options);
-      const response = await fetchPage(normalizedOptions);
-      return attachPaginator(response, fetchPage, normalizedOptions);
-    },
-    async create(agentId, payload) {
-      const res = await doFetch(`${base}/agents/${agentId}/instructions`, {
-        method: "POST",
-        headers: jsonHeaders,
-        body: JSON.stringify(payload)
-      });
-      return res.json();
-    },
-    async update(agentId, instructionId, payload) {
-      const res = await doFetch(
-        `${base}/agents/${agentId}/instructions/${instructionId}`,
-        {
-          method: "PATCH",
-          headers: jsonHeaders,
-          body: JSON.stringify(payload)
-        }
-      );
-      return res.json();
-    },
-    async delete(agentId, instructionId) {
-      await doFetch(`${base}/agents/${agentId}/instructions/${instructionId}`, {
-        method: "DELETE"
-      });
-    }
-  };
-}
-
-// src/api/agent-phones.ts
-function createAgentPhonesApi(cfg) {
-  const { base, doFetch } = createHttp(cfg);
-  const jsonHeaders = { "content-type": "application/json" };
-  return {
-    async connect(agentId, payload) {
-      const res = await doFetch(`${base}/agents/${agentId}/phones`, {
-        method: "POST",
-        headers: jsonHeaders,
-        body: JSON.stringify(payload)
-      });
-      return res.json();
-    },
-    async disconnect(agentId, phoneId) {
-      await doFetch(`${base}/agents/${agentId}/phones/${phoneId}`, {
-        method: "DELETE"
-      });
-    }
-  };
-}
-
 // src/api/agent-schedule-exceptions.ts
 function createAgentScheduleExceptionsApi(cfg) {
   const { base, doFetch } = createHttp(cfg);
@@ -954,20 +903,6 @@ function createAgentVersionsApi(cfg) {
 }
 
 // src/entities/agent.ts
-var bindAgentInstructions = (api, agentId) => ({
-  list(opts) {
-    return api.list(agentId, opts);
-  },
-  create(payload) {
-    return api.create(agentId, payload);
-  },
-  update(instructionId, payload) {
-    return api.update(agentId, instructionId, payload);
-  },
-  delete(instructionId) {
-    return api.delete(agentId, instructionId);
-  }
-});
 var bindAgentStageTriggers = (api, agentId, blueprintId, stageId) => ({
   list(opts) {
     return api.list(agentId, blueprintId, stageId, opts);
@@ -1139,7 +1074,6 @@ var bindAgentBlueprints = (api, agentId) => ({
 });
 var createAgentEntity = (dto, options) => {
   const {
-    instructionsApi,
     tagsApi,
     phonesApi,
     scheduleApi,
@@ -1154,7 +1088,6 @@ var createAgentEntity = (dto, options) => {
   } = options;
   const entity = {
     ...dto,
-    instructions: bindAgentInstructions(instructionsApi, dto.agentId),
     tagAssignments: bindAgentTags(tagsApi, dto.agentId),
     phones: bindAgentPhones(phonesApi, dto.agentId),
     schedule: bindAgentSchedule(
@@ -1251,7 +1184,6 @@ function createAgentsApi(cfg, relatedApis) {
     return baseApi;
   }
   const wrapAgent = (detail) => createAgentEntity(detail, {
-    instructionsApi: relatedApis.instructionsApi,
     tagsApi: relatedApis.tagsApi,
     phonesApi: relatedApis.phonesApi,
     scheduleApi: relatedApis.scheduleApi,
@@ -1915,7 +1847,6 @@ function createClient(initialCfg) {
   const setAccessTokenGetter = (getter) => {
     runtimeCfg.getAccessToken = getter;
   };
-  const instructionsApi = createAgentInstructionsApi(runtimeCfg);
   const tagsApi = createAgentTagsApi(runtimeCfg);
   const phonesApi = createAgentPhonesApi(runtimeCfg);
   const scheduleApi = createAgentScheduleApi(runtimeCfg);
@@ -1930,7 +1861,6 @@ function createClient(initialCfg) {
   const catalogTemplatesApi = createCatalogTemplatesApi(runtimeCfg);
   const webhooksApi = createWebhooksApi(runtimeCfg);
   const agentsApi = createAgentsApi(runtimeCfg, {
-    instructionsApi,
     tagsApi,
     phonesApi,
     scheduleApi,
@@ -1940,10 +1870,6 @@ function createClient(initialCfg) {
     stagesApi,
     stageTriggersApi
   });
-  const instructionsNamespace = Object.assign(
-    (agentId) => bindAgentInstructions(instructionsApi, agentId),
-    instructionsApi
-  );
   const tagsNamespace = Object.assign(
     (agentId) => bindAgentTags(tagsApi, agentId),
     tagsApi
@@ -1985,7 +1911,6 @@ function createClient(initialCfg) {
   const apis = {
     agents: {
       ...agentsApi,
-      instructions: instructionsNamespace,
       tags: tagsNamespace,
       phones: phonesNamespace,
       schedule: scheduleNamespace,
@@ -2064,7 +1989,6 @@ function createClient(initialCfg) {
   NetworkError,
   TimeoutError,
   bindAgentBlueprints,
-  bindAgentInstructions,
   bindAgentPhones,
   bindAgentSchedule,
   bindAgentScheduleExceptions,
@@ -2074,7 +1998,6 @@ function createClient(initialCfg) {
   bindAgentVersions,
   createAgentBlueprintsApi,
   createAgentEntity,
-  createAgentInstructionsApi,
   createAgentPhonesApi,
   createAgentScheduleApi,
   createAgentScheduleExceptionsApi,