@getsupervisor/agents-studio-sdk 1.17.0 → 1.19.0

package/CHANGELOG.md

@@ -1,3 +1,44 @@
+## v1.18.0
+
+## [1.18.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.17.0...v1.18.0) (2025-10-23)
+
+### Features
+
+* add webhooks management API ([bb1a1fb](https://github.com/julio-supervisor/agents-studio-be/commit/bb1a1fb17f48a7a52e82c07d12d32f57240c8604))
+* **docs:** add webhook terminology and definitions for agent association and URL reuse ([82985e8](https://github.com/julio-supervisor/agents-studio-be/commit/82985e8bbbc7e7cd2d0e15f0e77e0adc859d01a2))
+* **openapi:** enhance webhook descriptions with optional agent association and URL reuse details ([fc9b2d9](https://github.com/julio-supervisor/agents-studio-be/commit/fc9b2d9099116541d841548adf935f9c0f4a0c99))
+* **tests:** add WebhookEventKey setup and teardown for EventSubscriptionTypeormRepository tests ([b7c28c5](https://github.com/julio-supervisor/agents-studio-be/commit/b7c28c51bc86cf4bc08d83e511429a9cb8fab066))
+* **tests:** enhance WebhookEventKey setup and teardown in event subscription tests ([b717c89](https://github.com/julio-supervisor/agents-studio-be/commit/b717c8916c0147b467044387d9e73988454cf74f))
+* **webhooks:** add agent association to webhooks ([d2d5eb1](https://github.com/julio-supervisor/agents-studio-be/commit/d2d5eb175dc5c43c405a93f961ca70f2426f8d3f))
+* **webhooks:** add webhook event catalog and related migrations ([91ceec2](https://github.com/julio-supervisor/agents-studio-be/commit/91ceec203706bc79ce775063f9a9a9ba9eb698ca))
+* **webhooks:** implement event subscription and webhook entities, specifications, and factories ([7ba841e](https://github.com/julio-supervisor/agents-studio-be/commit/7ba841e21697ab2f38dedd8b5243091e250cff98))
+
+### Bug Fixes
+
+* update EventSubscription references to use EventSubscriptionDetail ([a1ff2f6](https://github.com/julio-supervisor/agents-studio-be/commit/a1ff2f611748783c87dfe43c8597de0a2ee89ae4))
+* update reference in EventSubscriptionListResponse from EventSubscriptionSummary to EventSubscriptionDetail ([9bc602f](https://github.com/julio-supervisor/agents-studio-be/commit/9bc602f14b36612ba993888e9c0354f6431b824e))
+
+
+## v1.17.0
+
+## [1.17.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.16.0...v1.17.0) (2025-10-22)
+
+### Features
+
+* actualizar documentación del SDK y especificaciones de API, eliminando referencias a 'retell' y mejorando ejemplos ([362a379](https://github.com/julio-supervisor/agents-studio-be/commit/362a379f4b44123a19f9f8921fe7674994ecbf8c))
+## v1.16.0
+
+## [1.16.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.15.0...v1.16.0) (2025-10-22)
+
+### Features
+
+* add centralized catalogs management API ([4a6cb3e](https://github.com/julio-supervisor/agents-studio-be/commit/4a6cb3ef36e5ed9f1752438df59cf3f7e94083c3))
+* add tests and mappers for catalog items, including CRUD operations and specifications ([f20d939](https://github.com/julio-supervisor/agents-studio-be/commit/f20d939819e4e29bcfb9ae73fa5c0b3c87211bcd))
+* **catalogs:** implement CatalogItem entity and related value objects ([7f06e93](https://github.com/julio-supervisor/agents-studio-be/commit/7f06e93288ed909b3db08380a4c47e4b9616bd04))
+* refactor sorting logic and add unit tests for resolveSingleSort utility ([a8d9812](https://github.com/julio-supervisor/agents-studio-be/commit/a8d981219aaa4f2c91705ee121a08225436f4166))
+* simplify toPrimitives method in CatalogItemMetadata class ([cf8d91c](https://github.com/julio-supervisor/agents-studio-be/commit/cf8d91c61c419cd487967311b1fedeeb8a439993))
+
+
 ## v1.15.0
 
 ## [1.15.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.14.0...v1.15.0) (2025-10-21)

package/dist/index.cjs

@@ -44,6 +44,7 @@ __export(index_exports, {
   createHttp: () => createHttp,
   createToolsApi: () => createToolsApi,
   createVoicesApi: () => createVoicesApi,
+  createWebhooksApi: () => createWebhooksApi,
   createWorkspacesApi: () => createWorkspacesApi
 });
 module.exports = __toCommonJS(index_exports);
@@ -1143,6 +1144,27 @@ function createCatalogsApi(cfg) {
 }
 
 // src/api/tools.ts
+var IDEMPOTENCY_HEADER = "Idempotency-Key";
+var generateIdempotencyKey = (explicit) => {
+  if (explicit && explicit.length > 0) {
+    return explicit;
+  }
+  const globalRef = globalThis;
+  const cryptoRef = globalRef?.crypto;
+  if (cryptoRef?.randomUUID) {
+    return cryptoRef.randomUUID();
+  }
+  if (cryptoRef?.getRandomValues) {
+    const buffer = new Uint8Array(16);
+    cryptoRef.getRandomValues(buffer);
+    return Array.from(
+      buffer,
+      (byte) => byte.toString(16).padStart(2, "0")
+    ).join("");
+  }
+  const randomChunk = () => Math.random().toString(36).slice(2, 10);
+  return `idemp_${Date.now().toString(36)}_${randomChunk()}${randomChunk()}`;
+};
 var isFormData = (value) => {
   return typeof FormData !== "undefined" && value instanceof FormData;
 };
@@ -1225,18 +1247,26 @@ function createToolsApi(cfg) {
       );
       return res.json();
     },
-    async execute(toolId, payload) {
+    async execute(toolId, payload, options = {}) {
+      const idempotencyKey = generateIdempotencyKey(options.idempotencyKey);
       const res = await doFetch(`${base}/v1/tools/${toolId}/execute`, {
         method: "POST",
-        headers: jsonHeaders,
+        headers: {
+          ...jsonHeaders,
+          [IDEMPOTENCY_HEADER]: idempotencyKey
+        },
         body: JSON.stringify(payload)
       });
       return res.json();
     },
-    async connect(toolId, payload) {
-      const res = await doFetch(`${base}/v1/tools/${toolId}/connect`, {
+    async connect(toolId, payload, options = {}) {
+      const idempotencyKey = generateIdempotencyKey(options.idempotencyKey);
+      const res = await doFetch(`${base}/v1/tools/${toolId}/connections`, {
         method: "POST",
-        headers: jsonHeaders,
+        headers: {
+          ...jsonHeaders,
+          [IDEMPOTENCY_HEADER]: idempotencyKey
+        },
         body: JSON.stringify(payload)
       });
       return res.json();
@@ -1282,6 +1312,117 @@ function createVoicesApi(cfg) {
   };
 }
 
+// src/api/webhooks.ts
+function createWebhooksApi(cfg) {
+  const { base, doFetch } = createHttp(cfg);
+  const jsonHeaders = { "content-type": "application/json" };
+  const fetchWebhooksPage = async (options = {}) => {
+    const query = serializeListOptions({
+      page: options.page,
+      limit: options.limit,
+      sort: options.sort,
+      fields: options.fields,
+      include: options.include,
+      search: options.search,
+      filter: options.filter
+    });
+    const res = await doFetch(`${base}/v1/webhooks`, {
+      method: "GET",
+      query
+    });
+    return res.json();
+  };
+  return {
+    async list(options = {}) {
+      const normalized = { ...options ?? {} };
+      const response = await fetchWebhooksPage(normalized);
+      return attachPaginator(response, fetchWebhooksPage, normalized);
+    },
+    async create(payload) {
+      const res = await doFetch(`${base}/v1/webhooks`, {
+        method: "POST",
+        headers: jsonHeaders,
+        body: JSON.stringify(payload)
+      });
+      return res.json();
+    },
+    async get(webhookId) {
+      const res = await doFetch(`${base}/v1/webhooks/${webhookId}`, {
+        method: "GET"
+      });
+      return res.json();
+    },
+    async update(webhookId, payload) {
+      const res = await doFetch(`${base}/v1/webhooks/${webhookId}`, {
+        method: "PATCH",
+        headers: jsonHeaders,
+        body: JSON.stringify(payload)
+      });
+      return res.json();
+    },
+    async delete(webhookId) {
+      await doFetch(`${base}/v1/webhooks/${webhookId}`, { method: "DELETE" });
+    },
+    // Subscriptions
+    async listSubscriptions(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}/v1/webhooks/${webhookId}/subscriptions`,
+          { method: "GET", query }
+        );
+        return res.json();
+      };
+      const normalized = { ...options ?? {} };
+      const response = await fetchPage(normalized);
+      return attachPaginator(response, fetchPage, normalized);
+    },
+    async createSubscription(webhookId, payload) {
+      const res = await doFetch(
+        `${base}/v1/webhooks/${webhookId}/subscriptions`,
+        {
+          method: "POST",
+          headers: jsonHeaders,
+          body: JSON.stringify(payload)
+        }
+      );
+      return res.json();
+    },
+    async getSubscription(webhookId, subscriptionId) {
+      const res = await doFetch(
+        `${base}/v1/webhooks/${webhookId}/subscriptions/${subscriptionId}`,
+        { method: "GET" }
+      );
+      return res.json();
+    },
+    async updateSubscription(webhookId, subscriptionId, payload) {
+      const res = await doFetch(
+        `${base}/v1/webhooks/${webhookId}/subscriptions/${subscriptionId}`,
+        {
+          method: "PATCH",
+          headers: jsonHeaders,
+          body: JSON.stringify(payload)
+        }
+      );
+      return res.json();
+    },
+    async deleteSubscription(webhookId, subscriptionId) {
+      await doFetch(
+        `${base}/v1/webhooks/${webhookId}/subscriptions/${subscriptionId}`,
+        { method: "DELETE" }
+      );
+    }
+  };
+}
+
 // src/api/workspaces.ts
 function createWorkspacesApi(cfg) {
   const { base, doFetch } = createHttp(cfg);
@@ -1363,6 +1504,7 @@ function createClient(initialCfg) {
   const voicesApi = createVoicesApi(runtimeCfg);
   const apiKeysApi = createApiKeysApi(runtimeCfg);
   const catalogsApi = createCatalogsApi(runtimeCfg);
+  const webhooksApi = createWebhooksApi(runtimeCfg);
   const agentsApi = createAgentsApi(runtimeCfg, {
     instructionsApi,
     tagsApi,
@@ -1417,7 +1559,8 @@ function createClient(initialCfg) {
     tools: createToolsApi(runtimeCfg),
     catalogs: catalogsApi,
     voices: voicesApi,
-    apiKeys: apiKeysApi
+    apiKeys: apiKeysApi,
+    webhooks: webhooksApi
   };
   return {
     ...apis,
@@ -1501,6 +1644,7 @@ function createClient(initialCfg) {
   createHttp,
   createToolsApi,
   createVoicesApi,
+  createWebhooksApi,
   createWorkspacesApi
 });
 //# sourceMappingURL=index.cjs.map