agentid-sdk 0.1.11 → 0.1.12

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-export { A as AgentID, a as AgentIDCallbackHandler, G as GuardParams, b as GuardResponse, L as LogParams, P as PreparedInput, R as RequestOptions } from './langchain-DVPOWfCC.mjs';
+export { A as AgentID, a as AgentIDCallbackHandler, G as GuardParams, b as GuardResponse, L as LogParams, P as PreparedInput, R as RequestOptions } from './langchain-BGP3qxvW.mjs';
 
 type PIIMapping = Record<string, string>;
 declare class PIIManager {

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { A as AgentID, a as AgentIDCallbackHandler, G as GuardParams, b as GuardResponse, L as LogParams, P as PreparedInput, R as RequestOptions } from './langchain-DVPOWfCC.js';
+export { A as AgentID, a as AgentIDCallbackHandler, G as GuardParams, b as GuardResponse, L as LogParams, P as PreparedInput, R as RequestOptions } from './langchain-BGP3qxvW.js';
 
 type PIIMapping = Record<string, string>;
 declare class PIIManager {

package/dist/index.js

@@ -1807,6 +1807,8 @@ var AGENTID_SDK_VERSION_HEADER2 = "js-1.0.8";
 var DEFAULT_GUARD_TIMEOUT_MS = 1e4;
 var MIN_GUARD_TIMEOUT_MS = 500;
 var MAX_GUARD_TIMEOUT_MS = 15e3;
+var GUARD_MAX_ATTEMPTS = 3;
+var GUARD_RETRY_DELAYS_MS = [250, 500];
 function normalizeBaseUrl3(baseUrl) {
   return baseUrl.replace(/\/+$/, "");
 }
@@ -1874,6 +1876,24 @@ function isInfrastructureGuardReason(reason) {
   if (!reason) return false;
   return reason === "system_failure" || reason === "system_failure_db_unavailable" || reason === "logging_failed" || reason === "server_error" || reason === "guard_unreachable" || reason === "api_key_pepper_missing" || reason === "encryption_key_missing";
 }
+function isUuidLike(value) {
+  if (!value) return false;
+  return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(
+    value
+  );
+}
+function createCorrelationId(seed) {
+  if (isUuidLike(seed)) return seed;
+  if (typeof globalThis.crypto?.randomUUID === "function") {
+    return globalThis.crypto.randomUUID();
+  }
+  return `cid_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+}
+async function waitForRetry(attemptIndex) {
+  const delay = GUARD_RETRY_DELAYS_MS[attemptIndex];
+  if (!delay) return;
+  await new Promise((resolve) => setTimeout(resolve, delay));
+}
 async function safeReadJson2(response) {
   try {
     return await response.json();
@@ -2133,79 +2153,124 @@ var AgentID = class {
       ...params,
       client_capabilities: params.client_capabilities ?? this.buildClientCapabilities()
     };
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), this.guardTimeoutMs);
-    try {
-      const res = await fetch(`${this.baseUrl}/guard`, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          "x-agentid-api-key": effectiveApiKey,
-          "X-AgentID-SDK-Version": AGENTID_SDK_VERSION_HEADER2
-        },
-        body: JSON.stringify(payload),
-        signal: controller.signal
-      });
-      const responseBody = await safeReadJson2(res);
-      if (responseBody && typeof responseBody.allowed === "boolean") {
-        const verdict = responseBody;
-        if (verdict.allowed === false && (isInfrastructureGuardReason(verdict.reason) || res.status >= 500)) {
-          if (this.strictMode) {
+    const correlationId = createCorrelationId(payload.client_event_id);
+    let lastStatusCode = null;
+    let lastAbort = false;
+    let lastError = null;
+    for (let attempt = 0; attempt < GUARD_MAX_ATTEMPTS; attempt += 1) {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), this.guardTimeoutMs);
+      try {
+        const res = await fetch(`${this.baseUrl}/guard`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "x-agentid-api-key": effectiveApiKey,
+            "X-AgentID-SDK-Version": AGENTID_SDK_VERSION_HEADER2,
+            "x-correlation-id": correlationId
+          },
+          body: JSON.stringify(payload),
+          signal: controller.signal
+        });
+        lastStatusCode = res.status;
+        const responseBody = await safeReadJson2(res);
+        if (responseBody && typeof responseBody.allowed === "boolean") {
+          const verdict = responseBody;
+          const infrastructureFailure = verdict.allowed === false && (isInfrastructureGuardReason(verdict.reason) || res.status >= 500);
+          if (infrastructureFailure) {
+            if (attempt < GUARD_MAX_ATTEMPTS - 1) {
+              await waitForRetry(attempt);
+              continue;
+            }
+            if (this.strictMode) {
+              console.warn(
+                `[AgentID] Guard API infrastructure failure in strict mode (${verdict.reason ?? `http_${res.status}`}). Blocking request.`
+              );
+              return { allowed: false, reason: verdict.reason ?? "network_error_strict_mode" };
+            }
             console.warn(
-              `[AgentID] Guard API infrastructure failure in strict mode (${verdict.reason ?? `http_${res.status}`}). Blocking request.`
+              `[AgentID] Guard API infrastructure fallback in fail-open mode (${verdict.reason ?? `http_${res.status}`}).`
             );
-            return { allowed: false, reason: verdict.reason ?? "network_error_strict_mode" };
+            this.logGuardFallback({
+              reason: verdict.reason ?? `http_${res.status}`,
+              status: "upstream_error",
+              guardParams: params,
+              apiKey: effectiveApiKey
+            });
+            return { allowed: true, reason: "system_failure_fail_open" };
           }
-          console.warn(
-            `[AgentID] Guard API infrastructure fallback in fail-open mode (${verdict.reason ?? `http_${res.status}`}).`
-          );
+          return verdict;
+        }
+        if (!res.ok) {
+          if (res.status >= 500 && attempt < GUARD_MAX_ATTEMPTS - 1) {
+            await waitForRetry(attempt);
+            continue;
+          }
+          throw new Error(`API Error ${res.status}`);
+        }
+        throw new Error("Invalid guard response");
+      } catch (error) {
+        lastError = error;
+        const isAbortError2 = Boolean(
+          error && typeof error === "object" && error.name === "AbortError"
+        );
+        lastAbort = isAbortError2;
+        if (attempt < GUARD_MAX_ATTEMPTS - 1) {
+          await waitForRetry(attempt);
+          continue;
+        }
+        if (isAbortError2) {
+          const timeoutMessage = "AgentID API Warning: Connection timeout exceeded.";
+          console.warn(timeoutMessage);
           this.logGuardFallback({
-            reason: verdict.reason ?? `http_${res.status}`,
-            status: "upstream_error",
+            reason: "timeout_fallback",
+            status: "latency_timeout",
             guardParams: params,
             apiKey: effectiveApiKey
           });
-          return { allowed: true, reason: "system_failure_fail_open" };
+          if (this.strictMode) {
+            return { allowed: false, reason: "network_error_strict_mode" };
+          }
+          return { allowed: true, reason: "timeout_fallback" };
         }
-        return verdict;
-      }
-      if (!res.ok) {
-        throw new Error(`API Error ${res.status}`);
-      }
-      throw new Error("Invalid guard response");
-    } catch (error) {
-      const isAbortError2 = error && typeof error === "object" && error.name === "AbortError";
-      if (isAbortError2) {
-        const timeoutMessage = "AgentID API Warning: Connection timeout exceeded.";
-        console.warn(timeoutMessage);
+        console.warn(
+          this.strictMode ? "[AgentID] Guard check failed (Strict mode active):" : "[AgentID] Guard check failed (Fail-Open active):",
+          error
+        );
         this.logGuardFallback({
-          reason: "timeout_fallback",
-          status: "latency_timeout",
+          reason: "guard_unreachable",
+          status: "guard_unreachable",
           guardParams: params,
           apiKey: effectiveApiKey
         });
         if (this.strictMode) {
           return { allowed: false, reason: "network_error_strict_mode" };
         }
-        return { allowed: true, reason: "timeout_fallback" };
+        return { allowed: true, reason: "guard_unreachable" };
+      } finally {
+        clearTimeout(timeoutId);
       }
-      console.warn(
-        this.strictMode ? "[AgentID] Guard check failed (Strict mode active):" : "[AgentID] Guard check failed (Fail-Open active):",
-        error
-      );
-      this.logGuardFallback({
-        reason: "guard_unreachable",
-        status: "guard_unreachable",
-        guardParams: params,
-        apiKey: effectiveApiKey
-      });
+    }
+    if (lastAbort) {
       if (this.strictMode) {
         return { allowed: false, reason: "network_error_strict_mode" };
       }
-      return { allowed: true, reason: "guard_unreachable" };
-    } finally {
-      clearTimeout(timeoutId);
+      return { allowed: true, reason: "timeout_fallback" };
+    }
+    if (typeof lastStatusCode === "number" && lastStatusCode >= 500) {
+      if (this.strictMode) {
+        return { allowed: false, reason: "server_error" };
+      }
+      return { allowed: true, reason: "system_failure_fail_open" };
+    }
+    console.warn(
+      this.strictMode ? "[AgentID] Guard check failed (Strict mode active):" : "[AgentID] Guard check failed (Fail-Open active):",
+      lastError
+    );
+    if (this.strictMode) {
+      return { allowed: false, reason: "network_error_strict_mode" };
     }
+    return { allowed: true, reason: "guard_unreachable" };
   }
   extractStreamChunkText(chunk) {
     if (typeof chunk === "string") {

package/dist/index.mjs

@@ -1769,6 +1769,8 @@ var AGENTID_SDK_VERSION_HEADER2 = "js-1.0.8";
 var DEFAULT_GUARD_TIMEOUT_MS = 1e4;
 var MIN_GUARD_TIMEOUT_MS = 500;
 var MAX_GUARD_TIMEOUT_MS = 15e3;
+var GUARD_MAX_ATTEMPTS = 3;
+var GUARD_RETRY_DELAYS_MS = [250, 500];
 function normalizeBaseUrl3(baseUrl) {
   return baseUrl.replace(/\/+$/, "");
 }
@@ -1836,6 +1838,24 @@ function isInfrastructureGuardReason(reason) {
   if (!reason) return false;
   return reason === "system_failure" || reason === "system_failure_db_unavailable" || reason === "logging_failed" || reason === "server_error" || reason === "guard_unreachable" || reason === "api_key_pepper_missing" || reason === "encryption_key_missing";
 }
+function isUuidLike(value) {
+  if (!value) return false;
+  return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(
+    value
+  );
+}
+function createCorrelationId(seed) {
+  if (isUuidLike(seed)) return seed;
+  if (typeof globalThis.crypto?.randomUUID === "function") {
+    return globalThis.crypto.randomUUID();
+  }
+  return `cid_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+}
+async function waitForRetry(attemptIndex) {
+  const delay = GUARD_RETRY_DELAYS_MS[attemptIndex];
+  if (!delay) return;
+  await new Promise((resolve) => setTimeout(resolve, delay));
+}
 async function safeReadJson2(response) {
   try {
     return await response.json();
@@ -2095,79 +2115,124 @@ var AgentID = class {
       ...params,
       client_capabilities: params.client_capabilities ?? this.buildClientCapabilities()
     };
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), this.guardTimeoutMs);
-    try {
-      const res = await fetch(`${this.baseUrl}/guard`, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          "x-agentid-api-key": effectiveApiKey,
-          "X-AgentID-SDK-Version": AGENTID_SDK_VERSION_HEADER2
-        },
-        body: JSON.stringify(payload),
-        signal: controller.signal
-      });
-      const responseBody = await safeReadJson2(res);
-      if (responseBody && typeof responseBody.allowed === "boolean") {
-        const verdict = responseBody;
-        if (verdict.allowed === false && (isInfrastructureGuardReason(verdict.reason) || res.status >= 500)) {
-          if (this.strictMode) {
+    const correlationId = createCorrelationId(payload.client_event_id);
+    let lastStatusCode = null;
+    let lastAbort = false;
+    let lastError = null;
+    for (let attempt = 0; attempt < GUARD_MAX_ATTEMPTS; attempt += 1) {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), this.guardTimeoutMs);
+      try {
+        const res = await fetch(`${this.baseUrl}/guard`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "x-agentid-api-key": effectiveApiKey,
+            "X-AgentID-SDK-Version": AGENTID_SDK_VERSION_HEADER2,
+            "x-correlation-id": correlationId
+          },
+          body: JSON.stringify(payload),
+          signal: controller.signal
+        });
+        lastStatusCode = res.status;
+        const responseBody = await safeReadJson2(res);
+        if (responseBody && typeof responseBody.allowed === "boolean") {
+          const verdict = responseBody;
+          const infrastructureFailure = verdict.allowed === false && (isInfrastructureGuardReason(verdict.reason) || res.status >= 500);
+          if (infrastructureFailure) {
+            if (attempt < GUARD_MAX_ATTEMPTS - 1) {
+              await waitForRetry(attempt);
+              continue;
+            }
+            if (this.strictMode) {
+              console.warn(
+                `[AgentID] Guard API infrastructure failure in strict mode (${verdict.reason ?? `http_${res.status}`}). Blocking request.`
+              );
+              return { allowed: false, reason: verdict.reason ?? "network_error_strict_mode" };
+            }
             console.warn(
-              `[AgentID] Guard API infrastructure failure in strict mode (${verdict.reason ?? `http_${res.status}`}). Blocking request.`
+              `[AgentID] Guard API infrastructure fallback in fail-open mode (${verdict.reason ?? `http_${res.status}`}).`
             );
-            return { allowed: false, reason: verdict.reason ?? "network_error_strict_mode" };
+            this.logGuardFallback({
+              reason: verdict.reason ?? `http_${res.status}`,
+              status: "upstream_error",
+              guardParams: params,
+              apiKey: effectiveApiKey
+            });
+            return { allowed: true, reason: "system_failure_fail_open" };
+          }
+          return verdict;
+        }
+        if (!res.ok) {
+          if (res.status >= 500 && attempt < GUARD_MAX_ATTEMPTS - 1) {
+            await waitForRetry(attempt);
+            continue;
           }
-          console.warn(
-            `[AgentID] Guard API infrastructure fallback in fail-open mode (${verdict.reason ?? `http_${res.status}`}).`
-          );
+          throw new Error(`API Error ${res.status}`);
+        }
+        throw new Error("Invalid guard response");
+      } catch (error) {
+        lastError = error;
+        const isAbortError2 = Boolean(
+          error && typeof error === "object" && error.name === "AbortError"
+        );
+        lastAbort = isAbortError2;
+        if (attempt < GUARD_MAX_ATTEMPTS - 1) {
+          await waitForRetry(attempt);
+          continue;
+        }
+        if (isAbortError2) {
+          const timeoutMessage = "AgentID API Warning: Connection timeout exceeded.";
+          console.warn(timeoutMessage);
           this.logGuardFallback({
-            reason: verdict.reason ?? `http_${res.status}`,
-            status: "upstream_error",
+            reason: "timeout_fallback",
+            status: "latency_timeout",
             guardParams: params,
             apiKey: effectiveApiKey
           });
-          return { allowed: true, reason: "system_failure_fail_open" };
+          if (this.strictMode) {
+            return { allowed: false, reason: "network_error_strict_mode" };
+          }
+          return { allowed: true, reason: "timeout_fallback" };
         }
-        return verdict;
-      }
-      if (!res.ok) {
-        throw new Error(`API Error ${res.status}`);
-      }
-      throw new Error("Invalid guard response");
-    } catch (error) {
-      const isAbortError2 = error && typeof error === "object" && error.name === "AbortError";
-      if (isAbortError2) {
-        const timeoutMessage = "AgentID API Warning: Connection timeout exceeded.";
-        console.warn(timeoutMessage);
+        console.warn(
+          this.strictMode ? "[AgentID] Guard check failed (Strict mode active):" : "[AgentID] Guard check failed (Fail-Open active):",
+          error
+        );
         this.logGuardFallback({
-          reason: "timeout_fallback",
-          status: "latency_timeout",
+          reason: "guard_unreachable",
+          status: "guard_unreachable",
           guardParams: params,
           apiKey: effectiveApiKey
         });
         if (this.strictMode) {
           return { allowed: false, reason: "network_error_strict_mode" };
         }
-        return { allowed: true, reason: "timeout_fallback" };
+        return { allowed: true, reason: "guard_unreachable" };
+      } finally {
+        clearTimeout(timeoutId);
       }
-      console.warn(
-        this.strictMode ? "[AgentID] Guard check failed (Strict mode active):" : "[AgentID] Guard check failed (Fail-Open active):",
-        error
-      );
-      this.logGuardFallback({
-        reason: "guard_unreachable",
-        status: "guard_unreachable",
-        guardParams: params,
-        apiKey: effectiveApiKey
-      });
+    }
+    if (lastAbort) {
       if (this.strictMode) {
         return { allowed: false, reason: "network_error_strict_mode" };
       }
-      return { allowed: true, reason: "guard_unreachable" };
-    } finally {
-      clearTimeout(timeoutId);
+      return { allowed: true, reason: "timeout_fallback" };
+    }
+    if (typeof lastStatusCode === "number" && lastStatusCode >= 500) {
+      if (this.strictMode) {
+        return { allowed: false, reason: "server_error" };
+      }
+      return { allowed: true, reason: "system_failure_fail_open" };
+    }
+    console.warn(
+      this.strictMode ? "[AgentID] Guard check failed (Strict mode active):" : "[AgentID] Guard check failed (Fail-Open active):",
+      lastError
+    );
+    if (this.strictMode) {
+      return { allowed: false, reason: "network_error_strict_mode" };
     }
+    return { allowed: true, reason: "guard_unreachable" };
   }
   extractStreamChunkText(chunk) {
     if (typeof chunk === "string") {

package/dist/{langchain-DVPOWfCC.d.mts → langchain-BGP3qxvW.d.mts}

@@ -25,6 +25,8 @@ interface GuardResponse {
     reason?: string;
     detected_pii?: boolean;
     transformed_input?: string;
+    guard_event_id?: string;
+    client_event_id?: string;
     shadow_mode?: boolean;
     simulated_decision?: "allowed" | "masked" | "blocked";
 }

package/dist/{langchain-DVPOWfCC.d.ts → langchain-BGP3qxvW.d.ts}

@@ -25,6 +25,8 @@ interface GuardResponse {
     reason?: string;
     detected_pii?: boolean;
     transformed_input?: string;
+    guard_event_id?: string;
+    client_event_id?: string;
     shadow_mode?: boolean;
     simulated_decision?: "allowed" | "masked" | "blocked";
 }

package/dist/langchain.d.mts

@@ -1 +1 @@
-export { a as AgentIDCallbackHandler } from './langchain-DVPOWfCC.mjs';
+export { a as AgentIDCallbackHandler } from './langchain-BGP3qxvW.mjs';

package/dist/langchain.d.ts

@@ -1 +1 @@
-export { a as AgentIDCallbackHandler } from './langchain-DVPOWfCC.js';
+export { a as AgentIDCallbackHandler } from './langchain-BGP3qxvW.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentid-sdk",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "AgentID JavaScript/TypeScript SDK for guard, ingest, tracing, and analytics.",
   "license": "MIT",
   "homepage": "https://agentid.ai",