@getsupervisor/agents-studio-sdk 1.18.0 → 1.19.0

package/CHANGELOG.md

@@ -1,3 +1,24 @@
+## 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)

package/dist/index.cjs

@@ -1144,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;
 };
@@ -1226,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();