@getsupervisor/agents-studio-sdk 1.41.2 → 1.42.0

package/dist/index.cjs

@@ -43,12 +43,16 @@ __export(index_exports, {
   createAgentVersionsApi: () => createAgentVersionsApi,
   createAgentsApi: () => createAgentsApi,
   createApiKeysApi: () => createApiKeysApi,
+  createBillingApi: () => createBillingApi,
+  createCallsApi: () => createCallsApi,
   createCampaignsApi: () => createCampaignsApi,
   createCatalogTemplatesApi: () => createCatalogTemplatesApi,
   createCatalogsApi: () => createCatalogsApi,
   createClient: () => createClient,
   createHttp: () => createHttp,
+  createSipTrunksApi: () => createSipTrunksApi,
   createToolsApi: () => createToolsApi,
+  createUsageApi: () => createUsageApi,
   createVoicesApi: () => createVoicesApi,
   createWebhooksApi: () => createWebhooksApi,
   createWorkspacesApi: () => createWorkspacesApi,
@@ -238,7 +242,8 @@ function createHttp(cfg) {
         }
         return res;
       } catch (e) {
-        if (e.name === "AbortError") throw new TimeoutError(timeout, targetUrl);
+        if (e?.name === "AbortError")
+          throw new TimeoutError(timeout, targetUrl);
         if (e instanceof HttpError) throw e;
         throw new NetworkError(e, targetUrl);
       }
@@ -259,6 +264,11 @@ function createHttp(cfg) {
 }
 
 // src/utils/query.ts
+function buildSearchParams(entries) {
+  const searchParams = new URLSearchParams();
+  entries.forEach(([key, value]) => appendParam(searchParams, key, value));
+  return searchParams;
+}
 function serializeListOptions(options = {}, extra = {}) {
   const params = new URLSearchParams();
   appendParam(params, "page", options.page);
@@ -1130,7 +1140,8 @@ var createAgentEntity = (dto, options) => {
     stageTriggersApi,
     reload,
     updateAgent,
-    deleteAgent
+    deleteAgent,
+    cloneAgent
   } = options;
   const schedulesHelper = bindAgentSchedules(
     scheduleApi,
@@ -1149,6 +1160,9 @@ var createAgentEntity = (dto, options) => {
     async save(patch) {
       return updateAgent(dto.agentId, patch);
     },
+    async clone(payload) {
+      return cloneAgent(dto.agentId, payload);
+    },
     async delete() {
       await deleteAgent(dto.agentId);
     },
@@ -1174,6 +1188,22 @@ function createAgentsApi(cfg, relatedApis) {
     throw new WorkspaceNotSelectedError();
   };
   const jsonHeaders = { "content-type": "application/json" };
+  const normalizeCloneSelection = (selection) => {
+    if (!selection) {
+      return [];
+    }
+    if (Array.isArray(selection)) {
+      return selection;
+    }
+    return Object.entries(selection).filter(([, enabled]) => enabled).map(([component]) => component);
+  };
+  const buildCloneAgentRequest = (payload) => {
+    const { clone, ...rest } = payload;
+    return {
+      ...rest,
+      clone: normalizeCloneSelection(clone)
+    };
+  };
   const fetchAgentsPage = async (options = {}) => {
     requireWorkspace();
     const sanitizedOptions = {
@@ -1218,6 +1248,16 @@ function createAgentsApi(cfg, relatedApis) {
     });
     return res.json();
   };
+  const cloneAgent = async (agentId, payload) => {
+    requireWorkspace();
+    const requestPayload = buildCloneAgentRequest(payload);
+    const res = await doFetch(`${base}/agents/${agentId}/clone`, {
+      method: "POST",
+      body: JSON.stringify(requestPayload),
+      headers: jsonHeaders
+    });
+    return res.json();
+  };
   const updateAgent = async (agentId, payload) => {
     requireWorkspace();
     const res = await doFetch(`${base}/agents/${agentId}`, {
@@ -1241,6 +1281,7 @@ function createAgentsApi(cfg, relatedApis) {
     list: listAgents,
     get: getAgentDetail,
     create: createAgent,
+    clone: cloneAgent,
     forkFromTemplate: forkAgentFromTemplate,
     update: updateAgent,
     delete: deleteAgent
@@ -1267,6 +1308,10 @@ function createAgentsApi(cfg, relatedApis) {
     },
     deleteAgent: async (agentId) => {
       await deleteAgent(agentId);
+    },
+    cloneAgent: async (agentId, payload) => {
+      const cloned = await cloneAgent(agentId, payload);
+      return wrapAgent(cloned);
     }
   });
   return {
@@ -1292,6 +1337,10 @@ function createAgentsApi(cfg, relatedApis) {
       const detail = await createAgent(payload);
       return wrapAgent(detail);
     },
+    async clone(agentId, payload) {
+      const detail = await cloneAgent(agentId, payload);
+      return wrapAgent(detail);
+    },
     async forkFromTemplate(payload) {
       const detail = await forkAgentFromTemplate(payload);
       return wrapAgent(detail);
@@ -1334,6 +1383,82 @@ function createApiKeysApi(cfg) {
   };
 }
 
+// src/api/billing.ts
+function createBillingApi(cfg) {
+  const { base, doFetch } = createHttp(cfg);
+  return {
+    async getBalance() {
+      const res = await doFetch(`${base}/billing/balance`, {
+        method: "GET"
+      });
+      return res.json();
+    }
+  };
+}
+
+// src/api/calls.ts
+function createCallsApi(cfg) {
+  const { base, doFetch } = createHttp(cfg);
+  const fetchCallsPage = async (options = {}) => {
+    const {
+      agentBatchId,
+      agentId,
+      executionId,
+      recordedAfter,
+      recordedBefore,
+      durationBucket,
+      goalStatus,
+      query: searchQuery,
+      ...listOptions
+    } = options ?? {};
+    const query = serializeListOptions(listOptions, {
+      agentBatchId,
+      agentId,
+      executionId,
+      recordedAfter,
+      recordedBefore,
+      durationBucket,
+      goalStatus,
+      query: searchQuery
+    });
+    const res = await doFetch(`${base}/calls`, {
+      method: "GET",
+      query
+    });
+    return res.json();
+  };
+  return {
+    async list(options = {}) {
+      const normalizedOptions = { ...options ?? {} };
+      const response = await fetchCallsPage(normalizedOptions);
+      return attachPaginator(response, fetchCallsPage, normalizedOptions);
+    },
+    async stream(options) {
+      const query = buildSearchParams([
+        ["after", options.after],
+        ["limit", options.limit],
+        ["agentBatchId", options.agentBatchId],
+        ["agentId", options.agentId],
+        ["executionId", options.executionId],
+        ["durationBucket", options.durationBucket],
+        ["goalStatus", options.goalStatus],
+        ["query", options.query]
+      ]);
+      const res = await doFetch(`${base}/calls/stream`, {
+        method: "GET",
+        query
+      });
+      return res.json();
+    },
+    async get(callId) {
+      const res = await doFetch(`${base}/calls/${callId}`, {
+        method: "GET"
+      });
+      return res.json();
+    }
+  };
+}
+
 // src/api/campaigns.ts
 function createCampaignsApi(cfg) {
   const { base, doFetch } = createHttp(cfg);
@@ -1349,10 +1474,7 @@ function createCampaignsApi(cfg) {
     return res.json();
   };
   const fetchExecutionsPage = async (campaignId, options = {}) => {
-    const query = serializeListOptions({
-      page: options.page,
-      limit: options.limit
-    });
+    const query = serializeListOptions(options ?? {});
     const res = await doFetch(`${base}/campaigns/${campaignId}/executions`, {
       method: "GET",
       query
@@ -1406,6 +1528,51 @@ function createCampaignsApi(cfg) {
       const response = await fetchExecutionsPage(campaignId, normalizedOptions);
       const fetchPage = (opts) => fetchExecutionsPage(campaignId, opts);
       return attachPaginator(response, fetchPage, normalizedOptions);
+    },
+    /**
+     * Pausa una campaña en curso. Los reintentos ya programados se
+     * reagendan al ejecutarse (sin consumir intentos) hasta `resume()`.
+     */
+    async pause(campaignId) {
+      const res = await doFetch(`${base}/campaigns/${campaignId}/pause`, {
+        method: "POST"
+      });
+      return res.json();
+    },
+    /**
+     * Reanuda una campaña pausada. Re-encola los reintentos pendientes
+     * según su `nextRetryAt`.
+     */
+    async resume(campaignId) {
+      const res = await doFetch(`${base}/campaigns/${campaignId}/resume`, {
+        method: "POST"
+      });
+      return res.json();
+    },
+    /**
+     * Cancela definitivamente una campaña no terminal. Los reintentos
+     * pendientes se descartan — operación destructiva.
+     */
+    async cancel(campaignId) {
+      const res = await doFetch(`${base}/campaigns/${campaignId}/cancel`, {
+        method: "POST"
+      });
+      return res.json();
+    },
+    /**
+     * Descarga el CSV con todas las ejecuciones de la campaña. Devuelve un
+     * `Blob` con `text/csv; charset=utf-8` (BOM UTF-8 incluido). Para
+     * campañas > 20,000 filas la API responde 413.
+     */
+    async exportExecutions(campaignId) {
+      const res = await doFetch(
+        `${base}/campaigns/${campaignId}/executions/export`,
+        {
+          method: "GET",
+          headers: { Accept: "text/csv" }
+        }
+      );
+      return res.blob();
     }
   };
 }
@@ -1486,6 +1653,42 @@ function createCatalogsApi(cfg) {
   };
 }
 
+// src/api/sip-trunks.ts
+function createSipTrunksApi(cfg) {
+  const { base, doFetch } = createHttp(cfg);
+  return {
+    async list() {
+      const res = await doFetch(`${base}/sip/trunks`, { method: "GET" });
+      return res.json();
+    },
+    async get(trunkId) {
+      const res = await doFetch(`${base}/sip/trunks/${trunkId}`, {
+        method: "GET"
+      });
+      return res.json();
+    },
+    async create(body) {
+      const res = await doFetch(`${base}/sip/trunks`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body)
+      });
+      return res.json();
+    },
+    async update(trunkId, body) {
+      const res = await doFetch(`${base}/sip/trunks/${trunkId}`, {
+        method: "PATCH",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body)
+      });
+      return res.json();
+    },
+    async delete(trunkId) {
+      await doFetch(`${base}/sip/trunks/${trunkId}`, { method: "DELETE" });
+    }
+  };
+}
+
 // src/api/tools.ts
 var IDEMPOTENCY_HEADER = "Idempotency-Key";
 var generateIdempotencyKey = (explicit) => {
@@ -1675,6 +1878,74 @@ function createToolsApi(cfg) {
   };
 }
 
+// src/api/usage.ts
+var import_api_query_builder = require("@getsupervisor/api-query-builder");
+function createUsageApi(cfg) {
+  const { base, doFetch } = createHttp(cfg);
+  const fetchUsageAgentsPage = async (options = {}) => {
+    const { resource, from, to, ...listOptions } = options;
+    const query = serializeListOptions({
+      ...listOptions,
+      filter: resolveFilter(
+        buildUsageFilter(resource, from, to),
+        listOptions.filter
+      )
+    });
+    const res = await doFetch(`${base}/usage/agents`, {
+      method: "GET",
+      query
+    });
+    return res.json();
+  };
+  return {
+    async agents(options = {}) {
+      const normalizedOptions = {
+        ...options
+      };
+      const response = await fetchUsageAgentsPage(normalizedOptions);
+      return attachPaginator(response, fetchUsageAgentsPage, normalizedOptions);
+    }
+  };
+}
+function resolveFilter(usageFilter, fallback) {
+  if (usageFilter) {
+    return usageFilter;
+  }
+  return fallback;
+}
+function appendCondition(query, factory) {
+  if (query) {
+    query.and(factory);
+    return query;
+  }
+  return new import_api_query_builder.Query(factory);
+}
+var DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
+function toISOString(value) {
+  const input = DATE_ONLY.test(value) ? `${value}T00:00:00` : value;
+  const date = new Date(input);
+  if (Number.isNaN(date.getTime())) {
+    return value;
+  }
+  return date.toISOString();
+}
+function buildUsageFilter(resource, from, to) {
+  let query;
+  if (resource) {
+    query = appendCondition(query, (qb) => qb.eq("resource", resource));
+  }
+  if (from) {
+    query = appendCondition(
+      query,
+      (qb) => qb.mte("createdAt", toISOString(from))
+    );
+  }
+  if (to) {
+    query = appendCondition(query, (qb) => qb.lt("createdAt", toISOString(to)));
+  }
+  return query;
+}
+
 // src/utils/catalog-voices.ts
 var FALLBACK_LOCALE = "und";
 var FALLBACK_PROVIDER = "catalog";
@@ -1733,9 +2004,9 @@ function pickGender(value) {
 }
 
 // src/utils/catalog-filter.ts
-var import_api_query_builder = require("@getsupervisor/api-query-builder");
+var import_api_query_builder2 = require("@getsupervisor/api-query-builder");
 function createCatalogTypeQuery(type) {
-  return new import_api_query_builder.Query((qb) => qb.eq("type", type));
+  return new import_api_query_builder2.Query((qb) => qb.eq("type", type));
 }
 function ensureCatalogTypeFilter(filter, type) {
   const requiredQuery = createCatalogTypeQuery(type);
@@ -1971,6 +2242,35 @@ function createWebhooksApi(cfg) {
         `${base}/webhooks/${webhookId}/subscriptions/${subscriptionId}`,
         { method: "DELETE" }
       );
+    },
+    // Deliveries
+    async listDeliveries(webhookId, options = {}) {
+      const fetchPage = async (opts) => {
+        const query = serializeListOptions({
+          page: opts.page,
+          limit: opts.limit,
+          sort: opts.sort,
+          fields: opts.fields,
+          include: opts.include,
+          search: opts.search,
+          filter: opts.filter
+        });
+        const res = await doFetch(`${base}/webhooks/${webhookId}/deliveries`, {
+          method: "GET",
+          query
+        });
+        return res.json();
+      };
+      const normalized = { ...options ?? {} };
+      const response = await fetchPage(normalized);
+      return attachPaginator(response, fetchPage, normalized);
+    },
+    async getDelivery(webhookId, deliveryId) {
+      const res = await doFetch(
+        `${base}/webhooks/${webhookId}/deliveries/${deliveryId}`,
+        { method: "GET" }
+      );
+      return res.json();
     }
   };
 }
@@ -2034,8 +2334,8 @@ function createWorkspacesApi(cfg) {
       const fetchPage = (options) => fetchPhonesPage(workspaceId, options);
       return attachPaginator(response, fetchPage, normalizedOptions);
     },
-    async enable(workspaceId, payload) {
-      const res = await doFetch(`${base}/workspaces/${workspaceId}/enable`, {
+    async enable(payload) {
+      const res = await doFetch(`${base}/workspaces/enable`, {
         method: "POST",
         headers: jsonHeaders,
         body: JSON.stringify(payload)
@@ -2081,6 +2381,7 @@ function createClient(initialCfg) {
   const stagesApi = createAgentStagesApi(runtimeCfg);
   const voicesApi = createVoicesApi(runtimeCfg);
   const apiKeysApi = createApiKeysApi(runtimeCfg);
+  const callsApi = createCallsApi(runtimeCfg);
   const catalogsApi = createCatalogsApi(runtimeCfg);
   const catalogTemplatesApi = createCatalogTemplatesApi(runtimeCfg);
   const webhooksApi = createWebhooksApi(runtimeCfg);
@@ -2152,6 +2453,10 @@ function createClient(initialCfg) {
     campaigns: createCampaignsApi(runtimeCfg),
     voices: voicesApi,
     apiKeys: apiKeysApi,
+    billing: createBillingApi(runtimeCfg),
+    calls: callsApi,
+    usage: createUsageApi(runtimeCfg),
+    sip: createSipTrunksApi(runtimeCfg),
     webhooks: webhooksApi
   };
   return {
@@ -2235,12 +2540,16 @@ function createClient(initialCfg) {
   createAgentVersionsApi,
   createAgentsApi,
   createApiKeysApi,
+  createBillingApi,
+  createCallsApi,
   createCampaignsApi,
   createCatalogTemplatesApi,
   createCatalogsApi,
   createClient,
   createHttp,
+  createSipTrunksApi,
   createToolsApi,
+  createUsageApi,
   createVoicesApi,
   createWebhooksApi,
   createWorkspacesApi,