@getsupervisor/agents-studio-sdk 1.41.2-patch.14 → 1.41.2-patch.15

package/README.md

@@ -397,6 +397,45 @@ npx tsx examples/custom-tool-connection.ts
 
 El script envía la metadata de conexión (URL, método, headers) y, sobre todo, almacena un `configSchema` específico del workspace dentro de `tool_agent_connections.metadata`. Ese esquema describe los campos que el agente debe solicitar (en el ejemplo `agentId` y `customerName`) y coincide con la acción `triggerWorkflow` que expone el seed `custom.http.workflow`. Después de conectar la tool ejecuta `client.tools.execute('custom.http.workflow', { action: 'triggerWorkflow', args: { ... } })` respetando el schema definido en tu metadata.
 
+## SIP Trunks
+
+Namespace: `client.sip`
+
+Gestiona trunks SIP para conectar agentes de voz a carriers PSTN (Twilio, ccc2.uno, etc.).
+
+Operaciones disponibles:
+
+- `sip.list()` — lista todos los SIP trunks del workspace.
+- `sip.get(trunkId)` — obtiene un trunk por ID.
+- `sip.create(payload)` — crea un trunk (devuelve `password` solo en la creación).
+- `sip.update(trunkId, payload)` — actualiza un trunk (campos parciales).
+- `sip.delete(trunkId)` — elimina un trunk y su subscriber asociado.
+
+Ejemplo:
+
+```ts
+// crear un trunk SIP
+const trunk = await client.sip.create({
+  name: 'Twilio Production',
+  carrierAddress: 'my-trunk.pstn.twilio.com',
+  // opcionales: carrierPort (default 5060), carrierTransport (default 'udp'), phoneNumbers
+});
+
+console.log(trunk.username); // auto-generado para SIP digest auth
+console.log(trunk.password); // solo visible en la creación
+
+// listar trunks del workspace
+const trunks = await client.sip.list();
+
+// actualizar
+await client.sip.update(trunk.id, { name: 'Twilio Staging' });
+
+// eliminar
+await client.sip.delete(trunk.id);
+```
+
+Scopes requeridos: `sip:read` para lectura, `sip:write` para escritura.
+
 ## Configuración
 
 ```ts

package/dist/index.cjs

@@ -50,6 +50,7 @@ __export(index_exports, {
   createCatalogsApi: () => createCatalogsApi,
   createClient: () => createClient,
   createHttp: () => createHttp,
+  createSipTrunksApi: () => createSipTrunksApi,
   createToolsApi: () => createToolsApi,
   createUsageApi: () => createUsageApi,
   createVoicesApi: () => createVoicesApi,
@@ -952,6 +953,102 @@ function createAgentVersionsApi(cfg) {
   };
 }
 
+// src/utils/sse-stream.ts
+function extractField(line, prefix) {
+  if (!line.startsWith(prefix)) {
+    return null;
+  }
+  return line.slice(prefix.length);
+}
+function parseSseMessage(raw) {
+  let type = "";
+  let data = "";
+  for (const line of raw.split("\n")) {
+    type = extractField(line, "event: ") ?? type;
+    data = extractField(line, "data: ") ?? data;
+  }
+  if (!type || !data) {
+    return null;
+  }
+  return { type, data };
+}
+function dispatchSseEvent(event, handlers) {
+  const handler = handlers[event.type];
+  if (!handler) {
+    return void 0;
+  }
+  try {
+    const parsed = JSON.parse(event.data);
+    handler(parsed);
+    return parsed;
+  } catch {
+    return void 0;
+  }
+}
+function processRawPart(raw, handlers, resolveEvent) {
+  const trimmed = raw.trim();
+  if (!trimmed) {
+    return void 0;
+  }
+  const event = parseSseMessage(trimmed);
+  if (!event) {
+    return void 0;
+  }
+  const result = dispatchSseEvent(event, handlers);
+  if (event.type !== resolveEvent) {
+    return void 0;
+  }
+  return result;
+}
+function flushRemainingBuffer(buffer) {
+  if (!buffer.trim()) {
+    return "";
+  }
+  return buffer + "\n\n";
+}
+function consumeSseStream(response, handlers, resolveEvent) {
+  if (!response.body) {
+    throw new Error("No response body for SSE stream");
+  }
+  return new Promise((resolve, reject) => {
+    let resolved;
+    let buffer = "";
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    const processBuffer = () => {
+      const parts = buffer.split("\n\n");
+      buffer = parts.pop() ?? "";
+      for (const part of parts) {
+        const result = processRawPart(part, handlers, resolveEvent);
+        if (result) {
+          resolved = result;
+        }
+      }
+    };
+    const finalize = () => {
+      buffer = flushRemainingBuffer(buffer);
+      processBuffer();
+      if (resolved) {
+        resolve(resolved);
+        return;
+      }
+      reject(new Error(`SSE stream ended without '${resolveEvent}' event`));
+    };
+    const read = () => {
+      reader.read().then(({ done, value }) => {
+        if (done) {
+          finalize();
+          return;
+        }
+        buffer += decoder.decode(value, { stream: true });
+        processBuffer();
+        read();
+      }).catch(reject);
+    };
+    read();
+  });
+}
+
 // src/entities/agent.ts
 var bindAgentStageTriggers = (api, agentId, blueprintId, stageId) => ({
   list(opts) {
@@ -1172,8 +1269,36 @@ var createAgentEntity = (dto, options) => {
 };
 
 // src/api/agents.ts
+function normalizeCloneSelection(selection) {
+  if (!selection) {
+    return [];
+  }
+  if (Array.isArray(selection)) {
+    return selection;
+  }
+  return Object.entries(selection).filter(([, enabled]) => enabled).map(([component]) => component);
+}
+function buildCloneRequest(payload) {
+  const { clone, ...rest } = payload;
+  return { ...rest, clone: normalizeCloneSelection(clone) };
+}
+function buildSseHandlers(callbacks) {
+  return {
+    "agent-created": (data) => callbacks.onAgentCreated?.(data),
+    "runtime-progress": (data) => callbacks.onProgress?.(data),
+    "runtime-complete": (data) => callbacks.onComplete?.(data),
+    "runtime-error": (data) => callbacks.onError?.(data)
+  };
+}
+function resolveAgentId(agent) {
+  if (typeof agent === "string") {
+    return agent;
+  }
+  return agent.agentId;
+}
 function createAgentsApi(cfg, relatedApis) {
-  const { base, doFetch, resolveWorkspaceId, resolveApiKey } = createHttp(cfg);
+  const { base, doFetch, buildHeaders, resolveWorkspaceId, resolveApiKey } = createHttp(cfg);
+  const jsonHeaders = { "content-type": "application/json" };
   const requireWorkspace = () => {
     const workspaceId = resolveWorkspaceId();
     if (typeof workspaceId === "string" && workspaceId.trim().length > 0) {
@@ -1185,167 +1310,144 @@ 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 = {
-      page: options.page,
-      limit: options.limit,
-      filter: options.filter
-    };
-    const query = serializeListOptions(sanitizedOptions);
-    const res = await doFetch(`${base}/agents`, {
-      method: "GET",
-      query
-    });
-    return res.json();
-  };
-  const listAgents = async (options = {}) => {
-    const normalizedOptions = { ...options ?? {} };
-    const response = await fetchAgentsPage(normalizedOptions);
-    return attachPaginator(response, fetchAgentsPage, normalizedOptions);
-  };
-  const getAgentDetail = async (agentId) => {
+  const postJson = async (url, payload) => {
     requireWorkspace();
-    const res = await doFetch(`${base}/agents/${agentId}`, {
-      method: "GET"
-    });
-    return res.json();
-  };
-  const createAgent = async (payload) => {
-    requireWorkspace();
-    const res = await doFetch(`${base}/agents`, {
+    const res = await doFetch(url, {
       method: "POST",
       body: JSON.stringify(payload),
       headers: jsonHeaders
     });
     return res.json();
   };
-  const forkAgentFromTemplate = async (payload) => {
+  const postWithSse = async (url, payload, callbacks) => {
     requireWorkspace();
-    const res = await doFetch(`${base}/agents/from-template`, {
+    const headers = buildHeaders({ "content-type": "application/json" });
+    const fx = cfg.fetchImpl ?? fetch;
+    const res = await fx(url, {
       method: "POST",
       body: JSON.stringify(payload),
-      headers: jsonHeaders
-    });
-    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
+      headers
     });
-    return res.json();
+    const contentType = res.headers.get("content-type") ?? "";
+    if (contentType.includes("application/json")) {
+      const agent = await res.json();
+      callbacks.onAgentCreated?.(agent);
+      return agent;
+    }
+    return consumeSseStream(
+      res,
+      buildSseHandlers(callbacks),
+      "agent-created"
+    );
   };
-  const updateAgent = async (agentId, payload) => {
+  const fetchPage = async (options = {}) => {
     requireWorkspace();
-    const res = await doFetch(`${base}/agents/${agentId}`, {
-      method: "PATCH",
-      body: JSON.stringify(payload),
-      headers: jsonHeaders
+    const query = serializeListOptions({
+      page: options.page,
+      limit: options.limit,
+      filter: options.filter
     });
+    const res = await doFetch(`${base}/agents`, { method: "GET", query });
     return res.json();
   };
-  const resolveAgentId = (agent) => {
-    return typeof agent === "string" ? agent : agent.agentId;
-  };
-  const deleteAgent = async (agent) => {
-    requireWorkspace();
-    const agentId = resolveAgentId(agent);
-    await doFetch(`${base}/agents/${agentId}`, {
-      method: "DELETE"
-    });
-  };
   const baseApi = {
-    list: listAgents,
-    get: getAgentDetail,
-    create: createAgent,
-    clone: cloneAgent,
-    forkFromTemplate: forkAgentFromTemplate,
-    update: updateAgent,
-    delete: deleteAgent
+    async list(options = {}) {
+      const opts = { ...options ?? {} };
+      const response = await fetchPage(opts);
+      return attachPaginator(response, fetchPage, opts);
+    },
+    async get(agentId) {
+      requireWorkspace();
+      const res = await doFetch(`${base}/agents/${agentId}`, { method: "GET" });
+      return res.json();
+    },
+    async create(payload, callbacks) {
+      if (callbacks) {
+        return postWithSse(`${base}/agents`, payload, callbacks);
+      }
+      return postJson(`${base}/agents`, payload);
+    },
+    async clone(agentId, payload) {
+      return postJson(
+        `${base}/agents/${agentId}/clone`,
+        buildCloneRequest(payload)
+      );
+    },
+    async forkFromTemplate(payload, callbacks) {
+      if (callbacks) {
+        return postWithSse(`${base}/agents/from-template`, payload, callbacks);
+      }
+      return postJson(`${base}/agents/from-template`, payload);
+    },
+    async update(agentId, payload) {
+      requireWorkspace();
+      const res = await doFetch(`${base}/agents/${agentId}`, {
+        method: "PATCH",
+        body: JSON.stringify(payload),
+        headers: jsonHeaders
+      });
+      return res.json();
+    },
+    async presignDocuments(files) {
+      return postJson(`${base}/documents`, { files });
+    },
+    async delete(agent) {
+      requireWorkspace();
+      await doFetch(`${base}/agents/${resolveAgentId(agent)}`, {
+        method: "DELETE"
+      });
+    }
   };
   if (!relatedApis) {
     return baseApi;
   }
+  return withEntityWrapping(baseApi, fetchPage, relatedApis);
+}
+function withEntityWrapping(api, fetchPage, deps) {
   const wrapAgent = (detail) => createAgentEntity(detail, {
-    tagsApi: relatedApis.tagsApi,
-    phonesApi: relatedApis.phonesApi,
-    scheduleApi: relatedApis.scheduleApi,
-    scheduleExceptionsApi: relatedApis.scheduleExceptionsApi,
-    versionsApi: relatedApis.versionsApi,
-    blueprintsApi: relatedApis.blueprintsApi,
-    stagesApi: relatedApis.stagesApi,
-    stageTriggersApi: relatedApis.stageTriggersApi,
+    ...deps,
     reload: async (agentId) => {
-      const latest = await getAgentDetail(agentId);
+      const latest = await api.get(agentId);
       return wrapAgent(latest);
     },
     updateAgent: async (agentId, payload) => {
-      const updated = await updateAgent(agentId, payload);
+      const updated = await api.update(agentId, payload);
       return wrapAgent(updated);
     },
     deleteAgent: async (agentId) => {
-      await deleteAgent(agentId);
+      await api.delete(agentId);
     },
     cloneAgent: async (agentId, payload) => {
-      const cloned = await cloneAgent(agentId, payload);
+      const cloned = await api.clone(agentId, payload);
       return wrapAgent(cloned);
     }
   });
+  const wrapList = async (opts) => {
+    const result = await fetchPage(opts);
+    const items = Array.isArray(result.data) ? result.data : [];
+    return { ...result, data: items.map(wrapAgent) };
+  };
   return {
-    ...baseApi,
+    ...api,
     async list(options = {}) {
-      const normalizedOptions = { ...options ?? {} };
-      const applyWrap = async (opts) => {
-        const result = await fetchAgentsPage(opts);
-        const items = Array.isArray(result.data) ? result.data : [];
-        return {
-          ...result,
-          data: items.map((summary) => wrapAgent(summary))
-        };
-      };
-      const initial = await applyWrap(normalizedOptions);
-      return attachPaginator(initial, applyWrap, normalizedOptions);
+      const opts = { ...options ?? {} };
+      const initial = await wrapList(opts);
+      return attachPaginator(initial, wrapList, opts);
     },
     async get(agentId) {
-      const detail = await getAgentDetail(agentId);
-      return wrapAgent(detail);
+      return wrapAgent(await api.get(agentId));
     },
-    async create(payload) {
-      const detail = await createAgent(payload);
-      return wrapAgent(detail);
+    async create(payload, callbacks) {
+      return wrapAgent(await api.create(payload, callbacks));
     },
     async clone(agentId, payload) {
-      const detail = await cloneAgent(agentId, payload);
-      return wrapAgent(detail);
+      return wrapAgent(await api.clone(agentId, payload));
     },
-    async forkFromTemplate(payload) {
-      const detail = await forkAgentFromTemplate(payload);
-      return wrapAgent(detail);
+    async forkFromTemplate(payload, callbacks) {
+      return wrapAgent(await api.forkFromTemplate(payload, callbacks));
     },
     async update(agentId, payload) {
-      const detail = await updateAgent(agentId, payload);
-      return wrapAgent(detail);
+      return wrapAgent(await api.update(agentId, payload));
     }
   };
 }
@@ -1609,6 +1711,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) => {
@@ -2376,6 +2514,7 @@ function createClient(initialCfg) {
     billing: createBillingApi(runtimeCfg),
     calls: callsApi,
     usage: createUsageApi(runtimeCfg),
+    sip: createSipTrunksApi(runtimeCfg),
     webhooks: webhooksApi
   };
   return {
@@ -2466,6 +2605,7 @@ function createClient(initialCfg) {
   createCatalogsApi,
   createClient,
   createHttp,
+  createSipTrunksApi,
   createToolsApi,
   createUsageApi,
   createVoicesApi,