@getsupervisor/agents-studio-sdk 1.38.0 → 1.39.0-patch.1

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,