@getsupervisor/agents-studio-sdk 1.40.0 → 1.41.0

package/CHANGELOG.md

@@ -1,3 +1,80 @@
+## v1.40.0
+
+## [1.40.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.39.0...v1.40.0) (2025-12-04)
+
+### Features
+
+* integrate BlueprintVariablesService into agent blueprint and stage handlers, enhancing variable management ([a798152](https://github.com/julio-supervisor/agents-studio-be/commit/a798152b3ee2b99f594ad0f16d79653d7a3abbff))
+
+## v1.39.0
+
+## [1.39.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.38.0...v1.39.0) (2025-12-02)
+
+### Features
+
+* add content hash and variable management to blueprints and stages ([632ff03](https://github.com/julio-supervisor/agents-studio-be/commit/632ff031aaf4a63af09985ba336c67f7a69bfdf9))
+* enhance DomainExceptionFilter to handle multiple domain exceptions and improve response structure ([02371e8](https://github.com/julio-supervisor/agents-studio-be/commit/02371e8d2bc197d6e04f169b75ffa1a57591a9f2))
+* update voiceId usage in agent blueprint tests and integration specs ([560373d](https://github.com/julio-supervisor/agents-studio-be/commit/560373da338c0525a27352a59ffe5c97c2b38372))
+* validate workspace identifier as UUID in WorkspaceGuard ([645d7a6](https://github.com/julio-supervisor/agents-studio-be/commit/645d7a668cfc424cacfd4829aa36c622b187d559))
+
+## v1.38.0
+
+## [1.38.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.37.0...v1.38.0) (2025-12-01)
+
+### Features
+
+* add ListAgentSchedulesHandler to query handlers ([a29436f](https://github.com/julio-supervisor/agents-studio-be/commit/a29436f0c514a7257742ae1c7920ed7a040cd94e))
+* add normalization for HH:mm:ss time values in AgentScheduleTypeormMapper ([de560f6](https://github.com/julio-supervisor/agents-studio-be/commit/de560f61a2c15f98f5004a062faea8bc4edcde3c))
+* add test for ignoring orphaned slot values when the day is disabled ([65c699c](https://github.com/julio-supervisor/agents-studio-be/commit/65c699cf3405fae26d561563808dc87044ccaf72))
+* add voiceId support to agent blueprints and related services ([00897a8](https://github.com/julio-supervisor/agents-studio-be/commit/00897a8bc5d0728d763b690ee7cc3bc9e27c1645))
+* format listAgentScheduleExceptions method for improved readability ([f72000b](https://github.com/julio-supervisor/agents-studio-be/commit/f72000bdea34a8786035fae8c77650393d50c89f))
+* implement AgentInitialVersionSubscriber to create initial agent versions and update related events ([76d59aa](https://github.com/julio-supervisor/agents-studio-be/commit/76d59aaa20288fe55835c70b9de81f9f55f1a29b))
+* refactor listAgentScheduleExceptions method in AgentSchedulesController ([bf0494f](https://github.com/julio-supervisor/agents-studio-be/commit/bf0494f2159bcca7c7dcd875b6d20741d2c927fb))
+
+## v1.37.0
+
+## [1.37.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.36.1...v1.37.0) (2025-11-28)
+
+### Features
+
+* add BlueprintWorkflowClonerService and integrate it into agent version handlers ([f585285](https://github.com/julio-supervisor/agents-studio-be/commit/f585285c827760567622ca6f63b5e5ca8a19ba3f))
+* add tests for SDK APIs and enhance agent schedule tools ([5af2da3](https://github.com/julio-supervisor/agents-studio-be/commit/5af2da3ec0cc8acd2d6a06fb71cb5271a4348042))
+* add unit tests for ListAgentSchedulesHandler with pagination, sorting, and error handling ([eb142f4](https://github.com/julio-supervisor/agents-studio-be/commit/eb142f4c47925eda6e989dd5987f0ae2645e3c74))
+* enhance version publishing logic to prevent publishing active versions and unsupported statuses ([c332dd9](https://github.com/julio-supervisor/agents-studio-be/commit/c332dd912a4cbc5bee15836ff6676d6a48c55cc8))
+* implement cloning of the latest blueprint in CreateAgentVersionHandler ([33eca82](https://github.com/julio-supervisor/agents-studio-be/commit/33eca82553190d48147382b4da3befe5a7506f63))
+* implement listing and querying of agent schedules with pagination and sorting ([35dd513](https://github.com/julio-supervisor/agents-studio-be/commit/35dd513078a3081a4bafbc1094f0927efd44359e))
+* update agent schedule handler tests to include scheduleId and improve specifications ([1e9c228](https://github.com/julio-supervisor/agents-studio-be/commit/1e9c2284b7fe4d220b14d82b5dc44cd332ac7cac))
+
+### Bug Fixes
+
+* remove unused workspaceId from ToolConnectionsCreateTool test ([b2702c8](https://github.com/julio-supervisor/agents-studio-be/commit/b2702c8e80cab01c02e2bcb87bc90e6325f368cb))
+
+## v1.36.1
+
+## [1.36.1](https://github.com/julio-supervisor/agents-studio-be/compare/v1.36.0...v1.36.1) (2025-11-27)
+
+### Bug Fixes
+
+* reorder imports and exports for consistency across modules ([23cfc68](https://github.com/julio-supervisor/agents-studio-be/commit/23cfc6823789532f6198d9f4362f808f27fc9b3a))
+
+## v1.36.0
+
+## [1.36.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.35.0...v1.36.0) (2025-11-27)
+
+### Features
+
+* add BlueprintCatalogValidationService and integrate catalog validation in agent blueprint handlers ([e611fe4](https://github.com/julio-supervisor/agents-studio-be/commit/e611fe41e075811353b4c51aea4e4651f8493d01))
+* add type aliases for agent and webhook requests and responses ([48224ec](https://github.com/julio-supervisor/agents-studio-be/commit/48224ec1a0617b9224ebca0ef41637e44fd8f7d2))
+
+## v1.35.0
+
+## [1.35.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.34.0...v1.35.0) (2025-11-16)
+
+### Features
+
+* add default language constant and update RetellBlueprintMapper to use it ([85d2d8c](https://github.com/julio-supervisor/agents-studio-be/commit/85d2d8ccc908254d351855158ecc09f14dbf6c6f))
+* implement delete instruction functionality with command handler and controller ([af983f5](https://github.com/julio-supervisor/agents-studio-be/commit/af983f5254055d35d3972d0bcbdb12a52b48c785))
+
 ## v1.34.0
 
 ## [1.34.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.33.0...v1.34.0) (2025-11-16)

package/README.md

@@ -73,6 +73,28 @@ await client.tools.uploadResource(tools.data[0].identifier, formData);
 
 // eliminar un agente
 await client.agents.delete(agent.agentId);
+
+// campañas masivas desde CSV
+const campaign = await client.campaigns.create(agent.agentId, versionId, {
+  name: 'Holiday follow-up',
+  objective: 'Re-engage dormant customers',
+  file: new File([csvBlob], 'campaign-rows.csv', { type: 'text/csv' }),
+});
+
+const recentCampaigns = await client.campaigns.list({ limit: 10 });
+console.log(recentCampaigns.data.map((item) => item.name));
+
+// ejecuciones individuales con correlación al toolExecutionId
+const executions = await client.campaigns.listExecutions(campaign.campaignId, {
+  limit: 20,
+});
+
+executions.data.forEach((row) => {
+  console.log(
+    `Row ${row.rowNumber} => status=${row.status} agentExecutionId=${row.agentExecutionId}`,
+  );
+});
+// agentExecutionId coincide con el toolExecutionId expuesto por client.tools.execute
 ```
 
 ## Catálogos (Catalogs)

package/dist/index.cjs

@@ -42,6 +42,7 @@ __export(index_exports, {
   createAgentVersionsApi: () => createAgentVersionsApi,
   createAgentsApi: () => createAgentsApi,
   createApiKeysApi: () => createApiKeysApi,
+  createCampaignsApi: () => createCampaignsApi,
   createCatalogTemplatesApi: () => createCatalogTemplatesApi,
   createCatalogsApi: () => createCatalogsApi,
   createClient: () => createClient,
@@ -515,6 +516,56 @@ function attachPaginator(response, fetchPage, options) {
   });
 }
 
+// src/api/agent-schedule.ts
+function createAgentScheduleApi(cfg) {
+  const { base, doFetch } = createHttp(cfg);
+  const jsonHeaders = { "content-type": "application/json" };
+  const fetchSchedulesPage = async (agentId, options = {}) => {
+    const query = serializeListOptions({ ...options ?? {} });
+    const res = await doFetch(`${base}/agents/${agentId}/schedules`, {
+      method: "GET",
+      query
+    });
+    return res.json();
+  };
+  return {
+    async list(agentId, options = {}) {
+      const normalized = { ...options ?? {} };
+      const fetchPage = (pageOptions) => fetchSchedulesPage(agentId, pageOptions);
+      const response = await fetchPage(normalized);
+      return attachPaginator(response, fetchPage, normalized);
+    },
+    async get(agentId, scheduleId) {
+      const res = await doFetch(
+        `${base}/agents/${agentId}/schedules/${scheduleId}`,
+        {
+          method: "GET"
+        }
+      );
+      return res.json();
+    },
+    async create(agentId, payload) {
+      const res = await doFetch(`${base}/agents/${agentId}/schedules`, {
+        method: "POST",
+        headers: jsonHeaders,
+        body: JSON.stringify(payload)
+      });
+      return res.json();
+    },
+    async update(agentId, scheduleId, payload) {
+      const res = await doFetch(
+        `${base}/agents/${agentId}/schedules/${scheduleId}`,
+        {
+          method: "PUT",
+          headers: jsonHeaders,
+          body: JSON.stringify(payload)
+        }
+      );
+      return res.json();
+    }
+  };
+}
+
 // src/api/agent-schedule-exceptions.ts
 function createAgentScheduleExceptionsApi(cfg) {
   const { base, doFetch } = createHttp(cfg);
@@ -581,56 +632,6 @@ function createAgentScheduleExceptionsApi(cfg) {
   };
 }
 
-// src/api/agent-schedule.ts
-function createAgentScheduleApi(cfg) {
-  const { base, doFetch } = createHttp(cfg);
-  const jsonHeaders = { "content-type": "application/json" };
-  const fetchSchedulesPage = async (agentId, options = {}) => {
-    const query = serializeListOptions({ ...options ?? {} });
-    const res = await doFetch(`${base}/agents/${agentId}/schedules`, {
-      method: "GET",
-      query
-    });
-    return res.json();
-  };
-  return {
-    async list(agentId, options = {}) {
-      const normalized = { ...options ?? {} };
-      const fetchPage = (pageOptions) => fetchSchedulesPage(agentId, pageOptions);
-      const response = await fetchPage(normalized);
-      return attachPaginator(response, fetchPage, normalized);
-    },
-    async get(agentId, scheduleId) {
-      const res = await doFetch(
-        `${base}/agents/${agentId}/schedules/${scheduleId}`,
-        {
-          method: "GET"
-        }
-      );
-      return res.json();
-    },
-    async create(agentId, payload) {
-      const res = await doFetch(`${base}/agents/${agentId}/schedules`, {
-        method: "POST",
-        headers: jsonHeaders,
-        body: JSON.stringify(payload)
-      });
-      return res.json();
-    },
-    async update(agentId, scheduleId, payload) {
-      const res = await doFetch(
-        `${base}/agents/${agentId}/schedules/${scheduleId}`,
-        {
-          method: "PUT",
-          headers: jsonHeaders,
-          body: JSON.stringify(payload)
-        }
-      );
-      return res.json();
-    }
-  };
-}
-
 // src/api/agent-stage-triggers.ts
 function createAgentStageTriggersApi(cfg) {
   const { base, doFetch } = createHttp(cfg);
@@ -1299,6 +1300,82 @@ function createApiKeysApi(cfg) {
   };
 }
 
+// src/api/campaigns.ts
+function createCampaignsApi(cfg) {
+  const { base, doFetch } = createHttp(cfg);
+  const isFormData2 = (value) => {
+    return typeof FormData !== "undefined" && value instanceof FormData;
+  };
+  const fetchCampaignsPage = async (options = {}) => {
+    const query = serializeListOptions(options ?? {});
+    const res = await doFetch(`${base}/campaigns`, {
+      method: "GET",
+      query
+    });
+    return res.json();
+  };
+  const fetchExecutionsPage = async (campaignId, options = {}) => {
+    const query = serializeListOptions({
+      page: options.page,
+      limit: options.limit
+    });
+    const res = await doFetch(`${base}/campaigns/${campaignId}/executions`, {
+      method: "GET",
+      query
+    });
+    return res.json();
+  };
+  const buildMultipart = (payload) => {
+    if (isFormData2(payload)) {
+      return payload;
+    }
+    if (typeof FormData === "undefined") {
+      throw new TypeError(
+        "FormData is not available in this environment. Pass a FormData instance instead."
+      );
+    }
+    const form = new FormData();
+    form.append("name", payload.name);
+    if (payload.objective !== void 0 && payload.objective !== null) {
+      form.append("objective", payload.objective);
+    }
+    form.append("file", payload.file);
+    return form;
+  };
+  return {
+    async list(options = {}) {
+      const normalizedOptions = { ...options ?? {} };
+      const response = await fetchCampaignsPage(normalizedOptions);
+      return attachPaginator(response, fetchCampaignsPage, normalizedOptions);
+    },
+    async get(campaignId) {
+      const res = await doFetch(`${base}/campaigns/${campaignId}`, {
+        method: "GET"
+      });
+      return res.json();
+    },
+    async create(agentId, versionId, payload) {
+      const body = buildMultipart(payload);
+      const res = await doFetch(
+        `${base}/agents/${agentId}/versions/${versionId}/campaigns`,
+        {
+          method: "POST",
+          body
+        }
+      );
+      return res.json();
+    },
+    async listExecutions(campaignId, options = {}) {
+      const normalizedOptions = {
+        ...options ?? {}
+      };
+      const response = await fetchExecutionsPage(campaignId, normalizedOptions);
+      const fetchPage = (opts) => fetchExecutionsPage(campaignId, opts);
+      return attachPaginator(response, fetchPage, normalizedOptions);
+    }
+  };
+}
+
 // src/api/catalog-templates.ts
 function createCatalogTemplatesApi(cfg) {
   const { base, doFetch } = createHttp(cfg);
@@ -1955,6 +2032,7 @@ function createClient(initialCfg) {
       ...catalogsApi,
       templates: catalogTemplatesApi
     },
+    campaigns: createCampaignsApi(runtimeCfg),
     voices: voicesApi,
     apiKeys: apiKeysApi,
     webhooks: webhooksApi
@@ -2039,6 +2117,7 @@ function createClient(initialCfg) {
   createAgentVersionsApi,
   createAgentsApi,
   createApiKeysApi,
+  createCampaignsApi,
   createCatalogTemplatesApi,
   createCatalogsApi,
   createClient,