agentid-sdk 0.1.12 → 0.1.14

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-BGP3qxvW.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-CmUK7sna.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-BGP3qxvW.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-CmUK7sna.js';
 
 type PIIMapping = Record<string, string>;
 declare class PIIManager {

package/dist/index.js

@@ -1809,6 +1809,10 @@ var MIN_GUARD_TIMEOUT_MS = 500;
 var MAX_GUARD_TIMEOUT_MS = 15e3;
 var GUARD_MAX_ATTEMPTS = 3;
 var GUARD_RETRY_DELAYS_MS = [250, 500];
+var INGEST_MAX_ATTEMPTS = 3;
+var INGEST_RETRY_DELAYS_MS = [250, 500];
+var GUARD_VERDICT_CACHE_TTL_MS = 15e3;
+var MAX_INGEST_TEXT_CHARS = 32e3;
 function normalizeBaseUrl3(baseUrl) {
   return baseUrl.replace(/\/+$/, "");
 }
@@ -1882,18 +1886,41 @@ function isUuidLike(value) {
     value
   );
 }
+function createPseudoUuidV4() {
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (token) => {
+    const rand = Math.floor(Math.random() * 16);
+    const value = token === "x" ? rand : rand & 3 | 8;
+    return value.toString(16);
+  });
+}
+function sanitizeIngestText(value) {
+  const text = typeof value === "string" ? value : String(value ?? "");
+  return text.slice(0, MAX_INGEST_TEXT_CHARS);
+}
+function createEventId(seed) {
+  if (isUuidLike(seed)) return seed;
+  if (typeof globalThis.crypto?.randomUUID === "function") {
+    return globalThis.crypto.randomUUID();
+  }
+  return createPseudoUuidV4();
+}
 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)}`;
+  return createPseudoUuidV4();
 }
 async function waitForRetry(attemptIndex) {
   const delay = GUARD_RETRY_DELAYS_MS[attemptIndex];
   if (!delay) return;
   await new Promise((resolve) => setTimeout(resolve, delay));
 }
+async function waitForIngestRetry(attemptIndex) {
+  const delay = INGEST_RETRY_DELAYS_MS[attemptIndex];
+  if (!delay) return;
+  await new Promise((resolve) => setTimeout(resolve, delay));
+}
 async function safeReadJson2(response) {
   try {
     return await response.json();
@@ -1968,6 +1995,8 @@ function createCompletionChunkCollector() {
 var AgentID = class {
   constructor(config) {
     this.injectionScanner = getInjectionScanner();
+    this.requestClientEventIds = /* @__PURE__ */ new WeakMap();
+    this.recentGuardVerdicts = /* @__PURE__ */ new Map();
     this.apiKey = config.apiKey.trim();
     this.baseUrl = normalizeBaseUrl3(config.baseUrl ?? "https://app.getagentid.com/api/v1");
     this.piiMasking = Boolean(config.piiMasking);
@@ -1996,6 +2025,60 @@ var AgentID = class {
     }
     return this.apiKey;
   }
+  resolveClientEventId(requestBody) {
+    const directClientEventId = requestBody.client_event_id;
+    if (typeof directClientEventId === "string" && isUuidLike(directClientEventId)) {
+      return directClientEventId;
+    }
+    const metadata = requestBody.metadata;
+    if (metadata && typeof metadata === "object" && !Array.isArray(metadata)) {
+      const metadataClientEventId = metadata.client_event_id;
+      if (typeof metadataClientEventId === "string" && isUuidLike(metadataClientEventId)) {
+        return metadataClientEventId;
+      }
+    }
+    const cached = this.requestClientEventIds.get(requestBody);
+    if (cached) {
+      return cached;
+    }
+    const generated = createEventId();
+    this.requestClientEventIds.set(requestBody, generated);
+    return generated;
+  }
+  buildGuardCacheKey(params) {
+    if (!params.system_id || !params.input) {
+      return null;
+    }
+    const userId = params.user_id?.trim() ?? "";
+    const normalizedInput = params.input.slice(0, 2048);
+    return `${params.system_id}|${userId}|${normalizedInput.length}|${normalizedInput}`;
+  }
+  readCachedGuardVerdict(cacheKey) {
+    if (!cacheKey) return null;
+    const cached = this.recentGuardVerdicts.get(cacheKey);
+    if (!cached) return null;
+    if (Date.now() > cached.expiresAt) {
+      this.recentGuardVerdicts.delete(cacheKey);
+      return null;
+    }
+    return cached.verdict;
+  }
+  cacheGuardVerdict(cacheKey, verdict) {
+    if (!cacheKey || !verdict.allowed) {
+      return;
+    }
+    this.recentGuardVerdicts.set(cacheKey, {
+      verdict,
+      expiresAt: Date.now() + GUARD_VERDICT_CACHE_TTL_MS
+    });
+    if (this.recentGuardVerdicts.size > 100) {
+      for (const [key, value] of this.recentGuardVerdicts.entries()) {
+        if (Date.now() > value.expiresAt) {
+          this.recentGuardVerdicts.delete(key);
+        }
+      }
+    }
+  }
   async getCapabilityConfig(force = false, options) {
     const effectiveApiKey = this.resolveApiKey(options?.apiKey);
     return ensureCapabilityConfig({
@@ -2153,6 +2236,11 @@ var AgentID = class {
       ...params,
       client_capabilities: params.client_capabilities ?? this.buildClientCapabilities()
     };
+    const guardCacheKey = this.buildGuardCacheKey(payload);
+    const cachedVerdict = this.readCachedGuardVerdict(guardCacheKey);
+    if (cachedVerdict) {
+      return cachedVerdict;
+    }
     const correlationId = createCorrelationId(payload.client_event_id);
     let lastStatusCode = null;
     let lastAbort = false;
@@ -2199,6 +2287,7 @@ var AgentID = class {
             });
             return { allowed: true, reason: "system_failure_fail_open" };
           }
+          this.cacheGuardVerdict(guardCacheKey, verdict);
           return verdict;
         }
         if (!res.ok) {
@@ -2272,6 +2361,59 @@ var AgentID = class {
     }
     return { allowed: true, reason: "guard_unreachable" };
   }
+  async sendIngest(params, options) {
+    const effectiveApiKey = this.resolveApiKey(options?.apiKey);
+    const eventId = createEventId(params.event_id);
+    const timestamp = params.timestamp ?? (/* @__PURE__ */ new Date()).toISOString();
+    const metadata = {
+      ...params.metadata ?? {}
+    };
+    if (!Object.prototype.hasOwnProperty.call(metadata, "agentid_base_url")) {
+      metadata.agentid_base_url = this.baseUrl;
+    }
+    void this.getCapabilityConfig(false, { apiKey: effectiveApiKey }).catch(() => void 0);
+    const payload = {
+      ...params,
+      event_id: eventId,
+      timestamp,
+      input: sanitizeIngestText(params.input),
+      output: sanitizeIngestText(params.output),
+      metadata,
+      client_capabilities: params.client_capabilities ?? this.buildClientCapabilities()
+    };
+    for (let attempt = 0; attempt < INGEST_MAX_ATTEMPTS; attempt += 1) {
+      try {
+        const response = await fetch(`${this.baseUrl}/ingest`, {
+          method: "POST",
+          keepalive: true,
+          headers: {
+            "Content-Type": "application/json",
+            "x-agentid-api-key": effectiveApiKey,
+            "X-AgentID-SDK-Version": AGENTID_SDK_VERSION_HEADER2
+          },
+          body: JSON.stringify(payload)
+        });
+        const responseBody = await safeReadJson2(response);
+        if (response.ok) {
+          return { ok: true, status: response.status, reason: null };
+        }
+        const reason = responseBody && typeof responseBody === "object" && typeof responseBody.reason === "string" ? responseBody.reason ?? null : null;
+        const retryable = response.status >= 500 || response.status === 429;
+        if (retryable && attempt < INGEST_MAX_ATTEMPTS - 1) {
+          await waitForIngestRetry(attempt);
+          continue;
+        }
+        return { ok: false, status: response.status, reason };
+      } catch {
+        if (attempt < INGEST_MAX_ATTEMPTS - 1) {
+          await waitForIngestRetry(attempt);
+          continue;
+        }
+        return { ok: false, status: null, reason: "network_error" };
+      }
+    }
+    return { ok: false, status: null, reason: "unknown_ingest_failure" };
+  }
   extractStreamChunkText(chunk) {
     if (typeof chunk === "string") {
       return chunk;
@@ -2373,35 +2515,11 @@ var AgentID = class {
   log(params, options) {
     queueMicrotask(() => {
       void (async () => {
-        try {
-          const effectiveApiKey = this.resolveApiKey(options?.apiKey);
-          const eventId = params.event_id ?? (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `evt_${Date.now()}_${Math.random().toString(36).slice(2)}`);
-          const timestamp = params.timestamp ?? (/* @__PURE__ */ new Date()).toISOString();
-          void this.getCapabilityConfig(false, { apiKey: effectiveApiKey }).catch(() => void 0);
-          const metadata = {
-            ...params.metadata ?? {}
-          };
-          if (!Object.prototype.hasOwnProperty.call(metadata, "agentid_base_url")) {
-            metadata.agentid_base_url = this.baseUrl;
-          }
-          await fetch(`${this.baseUrl}/ingest`, {
-            method: "POST",
-            keepalive: true,
-            headers: {
-              "Content-Type": "application/json",
-              "x-agentid-api-key": effectiveApiKey,
-              "X-AgentID-SDK-Version": AGENTID_SDK_VERSION_HEADER2
-            },
-            body: JSON.stringify({
-              ...params,
-              event_id: eventId,
-              timestamp,
-              metadata,
-              client_capabilities: params.client_capabilities ?? this.buildClientCapabilities()
-            })
-          });
-        } catch (error) {
-          console.error("[AgentID] Log failed:", error);
+        const result = await this.sendIngest(params, options);
+        if (!result.ok) {
+          console.warn(
+            `[AgentID] Ingest telemetry failed (status=${result.status ?? "network"}, reason=${result.reason ?? "unknown"}).`
+          );
         }
       })();
     });
@@ -2501,7 +2619,7 @@ var AgentID = class {
                     "AgentID: No user message found. Security guard requires string input."
                   );
                 }
-                const clientEventId = typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `evt_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+                const clientEventId = this.resolveClientEventId(req);
                 const verdict = await this.guard({
                   input: maskedText,
                   system_id: systemId,
@@ -2515,6 +2633,8 @@ var AgentID = class {
                     `AgentID: Security Blocked (${verdict.reason ?? "guard_denied"})`
                   );
                 }
+                const canonicalClientEventId = typeof verdict.client_event_id === "string" && isUuidLike(verdict.client_event_id) ? verdict.client_event_id : clientEventId;
+                const guardEventId = typeof verdict.guard_event_id === "string" && verdict.guard_event_id.length > 0 ? verdict.guard_event_id : null;
                 const isShadowMode = verdict.shadow_mode === true;
                 const transformedInput = isShadowMode ? maskedText : typeof verdict.transformed_input === "string" && verdict.transformed_input.length > 0 ? verdict.transformed_input : maskedText;
                 if (transformedInput !== maskedText) {
@@ -2537,10 +2657,10 @@ var AgentID = class {
                     })()
                   );
                   if (maskedText && wrappedCompletion.mode === "stream") {
-                    void wrappedCompletion.done.then((result) => {
+                    void wrappedCompletion.done.then(async (result) => {
                       const outputForLog = isShadowMode ? result.rawOutput : result.transformedOutput;
-                      this.log({
-                        event_id: clientEventId,
+                      const ingestResult = await this.sendIngest({
+                        event_id: canonicalClientEventId,
                         system_id: systemId,
                         user_id: options.user_id,
                         input: maskedText,
@@ -2548,6 +2668,7 @@ var AgentID = class {
                         model: adapter.getModelName(maskedReq),
                         usage: void 0,
                         latency: void 0,
+                        event_type: "complete",
                         metadata: {
                           transformed_input: maskedText,
                           transformed_output: result.transformedOutput,
@@ -2555,10 +2676,17 @@ var AgentID = class {
                           shadow_mode: isShadowMode,
                           simulated_decision: verdict.simulated_decision ?? null,
                           simulated_output_decision: isShadowMode && result.outputMasked ? "masked" : "allowed",
-                          response_streamed: true
+                          response_streamed: true,
+                          guard_event_id: guardEventId,
+                          client_event_id: canonicalClientEventId
                         },
                         client_capabilities: this.buildClientCapabilities("openai", false)
                       }, requestOptions);
+                      if (!ingestResult.ok) {
+                        console.warn(
+                          `[AgentID] Stream ingest telemetry failed (status=${ingestResult.status ?? "network"}, reason=${ingestResult.reason ?? "unknown"}).`
+                        );
+                      }
                     }).catch((error) => {
                       console.error("[AgentID] Stream completion wrapping failed:", error);
                     });
@@ -2574,8 +2702,8 @@ var AgentID = class {
                   const model = adapter.getModelName(maskedReq, res);
                   const usage = adapter.getTokenUsage(res);
                   const outputForLog = isShadowMode ? wrappedCompletion.rawOutput : wrappedCompletion.transformedOutput;
-                  this.log({
-                    event_id: clientEventId,
+                  const ingestResult = await this.sendIngest({
+                    event_id: canonicalClientEventId,
                     system_id: systemId,
                     user_id: options.user_id,
                     input: maskedText,
@@ -2583,6 +2711,7 @@ var AgentID = class {
                     model,
                     usage,
                     latency,
+                    event_type: "complete",
                     metadata: {
                       transformed_input: maskedText,
                       transformed_output: wrappedCompletion.transformedOutput,
@@ -2590,10 +2719,17 @@ var AgentID = class {
                       shadow_mode: isShadowMode,
                       simulated_decision: verdict.simulated_decision ?? null,
                       simulated_output_decision: isShadowMode && wrappedCompletion.outputMasked ? "masked" : "allowed",
-                      response_streamed: false
+                      response_streamed: false,
+                      guard_event_id: guardEventId,
+                      client_event_id: canonicalClientEventId
                     },
                     client_capabilities: this.buildClientCapabilities("openai", false)
                   }, requestOptions);
+                  if (!ingestResult.ok) {
+                    console.warn(
+                      `[AgentID] Ingest telemetry failed (status=${ingestResult.status ?? "network"}, reason=${ingestResult.reason ?? "unknown"}).`
+                    );
+                  }
                 }
                 if (!capabilityConfig.block_pii_leakage && this.piiMasking && shouldDeanonymize) {
                   const deanon = this.pii.deanonymize(adapter.extractOutput(res), mapping);

package/dist/index.mjs

@@ -1771,6 +1771,10 @@ var MIN_GUARD_TIMEOUT_MS = 500;
 var MAX_GUARD_TIMEOUT_MS = 15e3;
 var GUARD_MAX_ATTEMPTS = 3;
 var GUARD_RETRY_DELAYS_MS = [250, 500];
+var INGEST_MAX_ATTEMPTS = 3;
+var INGEST_RETRY_DELAYS_MS = [250, 500];
+var GUARD_VERDICT_CACHE_TTL_MS = 15e3;
+var MAX_INGEST_TEXT_CHARS = 32e3;
 function normalizeBaseUrl3(baseUrl) {
   return baseUrl.replace(/\/+$/, "");
 }
@@ -1844,18 +1848,41 @@ function isUuidLike(value) {
     value
   );
 }
+function createPseudoUuidV4() {
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (token) => {
+    const rand = Math.floor(Math.random() * 16);
+    const value = token === "x" ? rand : rand & 3 | 8;
+    return value.toString(16);
+  });
+}
+function sanitizeIngestText(value) {
+  const text = typeof value === "string" ? value : String(value ?? "");
+  return text.slice(0, MAX_INGEST_TEXT_CHARS);
+}
+function createEventId(seed) {
+  if (isUuidLike(seed)) return seed;
+  if (typeof globalThis.crypto?.randomUUID === "function") {
+    return globalThis.crypto.randomUUID();
+  }
+  return createPseudoUuidV4();
+}
 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)}`;
+  return createPseudoUuidV4();
 }
 async function waitForRetry(attemptIndex) {
   const delay = GUARD_RETRY_DELAYS_MS[attemptIndex];
   if (!delay) return;
   await new Promise((resolve) => setTimeout(resolve, delay));
 }
+async function waitForIngestRetry(attemptIndex) {
+  const delay = INGEST_RETRY_DELAYS_MS[attemptIndex];
+  if (!delay) return;
+  await new Promise((resolve) => setTimeout(resolve, delay));
+}
 async function safeReadJson2(response) {
   try {
     return await response.json();
@@ -1930,6 +1957,8 @@ function createCompletionChunkCollector() {
 var AgentID = class {
   constructor(config) {
     this.injectionScanner = getInjectionScanner();
+    this.requestClientEventIds = /* @__PURE__ */ new WeakMap();
+    this.recentGuardVerdicts = /* @__PURE__ */ new Map();
     this.apiKey = config.apiKey.trim();
     this.baseUrl = normalizeBaseUrl3(config.baseUrl ?? "https://app.getagentid.com/api/v1");
     this.piiMasking = Boolean(config.piiMasking);
@@ -1958,6 +1987,60 @@ var AgentID = class {
     }
     return this.apiKey;
   }
+  resolveClientEventId(requestBody) {
+    const directClientEventId = requestBody.client_event_id;
+    if (typeof directClientEventId === "string" && isUuidLike(directClientEventId)) {
+      return directClientEventId;
+    }
+    const metadata = requestBody.metadata;
+    if (metadata && typeof metadata === "object" && !Array.isArray(metadata)) {
+      const metadataClientEventId = metadata.client_event_id;
+      if (typeof metadataClientEventId === "string" && isUuidLike(metadataClientEventId)) {
+        return metadataClientEventId;
+      }
+    }
+    const cached = this.requestClientEventIds.get(requestBody);
+    if (cached) {
+      return cached;
+    }
+    const generated = createEventId();
+    this.requestClientEventIds.set(requestBody, generated);
+    return generated;
+  }
+  buildGuardCacheKey(params) {
+    if (!params.system_id || !params.input) {
+      return null;
+    }
+    const userId = params.user_id?.trim() ?? "";
+    const normalizedInput = params.input.slice(0, 2048);
+    return `${params.system_id}|${userId}|${normalizedInput.length}|${normalizedInput}`;
+  }
+  readCachedGuardVerdict(cacheKey) {
+    if (!cacheKey) return null;
+    const cached = this.recentGuardVerdicts.get(cacheKey);
+    if (!cached) return null;
+    if (Date.now() > cached.expiresAt) {
+      this.recentGuardVerdicts.delete(cacheKey);
+      return null;
+    }
+    return cached.verdict;
+  }
+  cacheGuardVerdict(cacheKey, verdict) {
+    if (!cacheKey || !verdict.allowed) {
+      return;
+    }
+    this.recentGuardVerdicts.set(cacheKey, {
+      verdict,
+      expiresAt: Date.now() + GUARD_VERDICT_CACHE_TTL_MS
+    });
+    if (this.recentGuardVerdicts.size > 100) {
+      for (const [key, value] of this.recentGuardVerdicts.entries()) {
+        if (Date.now() > value.expiresAt) {
+          this.recentGuardVerdicts.delete(key);
+        }
+      }
+    }
+  }
   async getCapabilityConfig(force = false, options) {
     const effectiveApiKey = this.resolveApiKey(options?.apiKey);
     return ensureCapabilityConfig({
@@ -2115,6 +2198,11 @@ var AgentID = class {
       ...params,
       client_capabilities: params.client_capabilities ?? this.buildClientCapabilities()
     };
+    const guardCacheKey = this.buildGuardCacheKey(payload);
+    const cachedVerdict = this.readCachedGuardVerdict(guardCacheKey);
+    if (cachedVerdict) {
+      return cachedVerdict;
+    }
     const correlationId = createCorrelationId(payload.client_event_id);
     let lastStatusCode = null;
     let lastAbort = false;
@@ -2161,6 +2249,7 @@ var AgentID = class {
             });
             return { allowed: true, reason: "system_failure_fail_open" };
           }
+          this.cacheGuardVerdict(guardCacheKey, verdict);
           return verdict;
         }
         if (!res.ok) {
@@ -2234,6 +2323,59 @@ var AgentID = class {
     }
     return { allowed: true, reason: "guard_unreachable" };
   }
+  async sendIngest(params, options) {
+    const effectiveApiKey = this.resolveApiKey(options?.apiKey);
+    const eventId = createEventId(params.event_id);
+    const timestamp = params.timestamp ?? (/* @__PURE__ */ new Date()).toISOString();
+    const metadata = {
+      ...params.metadata ?? {}
+    };
+    if (!Object.prototype.hasOwnProperty.call(metadata, "agentid_base_url")) {
+      metadata.agentid_base_url = this.baseUrl;
+    }
+    void this.getCapabilityConfig(false, { apiKey: effectiveApiKey }).catch(() => void 0);
+    const payload = {
+      ...params,
+      event_id: eventId,
+      timestamp,
+      input: sanitizeIngestText(params.input),
+      output: sanitizeIngestText(params.output),
+      metadata,
+      client_capabilities: params.client_capabilities ?? this.buildClientCapabilities()
+    };
+    for (let attempt = 0; attempt < INGEST_MAX_ATTEMPTS; attempt += 1) {
+      try {
+        const response = await fetch(`${this.baseUrl}/ingest`, {
+          method: "POST",
+          keepalive: true,
+          headers: {
+            "Content-Type": "application/json",
+            "x-agentid-api-key": effectiveApiKey,
+            "X-AgentID-SDK-Version": AGENTID_SDK_VERSION_HEADER2
+          },
+          body: JSON.stringify(payload)
+        });
+        const responseBody = await safeReadJson2(response);
+        if (response.ok) {
+          return { ok: true, status: response.status, reason: null };
+        }
+        const reason = responseBody && typeof responseBody === "object" && typeof responseBody.reason === "string" ? responseBody.reason ?? null : null;
+        const retryable = response.status >= 500 || response.status === 429;
+        if (retryable && attempt < INGEST_MAX_ATTEMPTS - 1) {
+          await waitForIngestRetry(attempt);
+          continue;
+        }
+        return { ok: false, status: response.status, reason };
+      } catch {
+        if (attempt < INGEST_MAX_ATTEMPTS - 1) {
+          await waitForIngestRetry(attempt);
+          continue;
+        }
+        return { ok: false, status: null, reason: "network_error" };
+      }
+    }
+    return { ok: false, status: null, reason: "unknown_ingest_failure" };
+  }
   extractStreamChunkText(chunk) {
     if (typeof chunk === "string") {
       return chunk;
@@ -2335,35 +2477,11 @@ var AgentID = class {
   log(params, options) {
     queueMicrotask(() => {
       void (async () => {
-        try {
-          const effectiveApiKey = this.resolveApiKey(options?.apiKey);
-          const eventId = params.event_id ?? (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `evt_${Date.now()}_${Math.random().toString(36).slice(2)}`);
-          const timestamp = params.timestamp ?? (/* @__PURE__ */ new Date()).toISOString();
-          void this.getCapabilityConfig(false, { apiKey: effectiveApiKey }).catch(() => void 0);
-          const metadata = {
-            ...params.metadata ?? {}
-          };
-          if (!Object.prototype.hasOwnProperty.call(metadata, "agentid_base_url")) {
-            metadata.agentid_base_url = this.baseUrl;
-          }
-          await fetch(`${this.baseUrl}/ingest`, {
-            method: "POST",
-            keepalive: true,
-            headers: {
-              "Content-Type": "application/json",
-              "x-agentid-api-key": effectiveApiKey,
-              "X-AgentID-SDK-Version": AGENTID_SDK_VERSION_HEADER2
-            },
-            body: JSON.stringify({
-              ...params,
-              event_id: eventId,
-              timestamp,
-              metadata,
-              client_capabilities: params.client_capabilities ?? this.buildClientCapabilities()
-            })
-          });
-        } catch (error) {
-          console.error("[AgentID] Log failed:", error);
+        const result = await this.sendIngest(params, options);
+        if (!result.ok) {
+          console.warn(
+            `[AgentID] Ingest telemetry failed (status=${result.status ?? "network"}, reason=${result.reason ?? "unknown"}).`
+          );
         }
       })();
     });
@@ -2463,7 +2581,7 @@ var AgentID = class {
                     "AgentID: No user message found. Security guard requires string input."
                   );
                 }
-                const clientEventId = typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `evt_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+                const clientEventId = this.resolveClientEventId(req);
                 const verdict = await this.guard({
                   input: maskedText,
                   system_id: systemId,
@@ -2477,6 +2595,8 @@ var AgentID = class {
                     `AgentID: Security Blocked (${verdict.reason ?? "guard_denied"})`
                   );
                 }
+                const canonicalClientEventId = typeof verdict.client_event_id === "string" && isUuidLike(verdict.client_event_id) ? verdict.client_event_id : clientEventId;
+                const guardEventId = typeof verdict.guard_event_id === "string" && verdict.guard_event_id.length > 0 ? verdict.guard_event_id : null;
                 const isShadowMode = verdict.shadow_mode === true;
                 const transformedInput = isShadowMode ? maskedText : typeof verdict.transformed_input === "string" && verdict.transformed_input.length > 0 ? verdict.transformed_input : maskedText;
                 if (transformedInput !== maskedText) {
@@ -2499,10 +2619,10 @@ var AgentID = class {
                     })()
                   );
                   if (maskedText && wrappedCompletion.mode === "stream") {
-                    void wrappedCompletion.done.then((result) => {
+                    void wrappedCompletion.done.then(async (result) => {
                       const outputForLog = isShadowMode ? result.rawOutput : result.transformedOutput;
-                      this.log({
-                        event_id: clientEventId,
+                      const ingestResult = await this.sendIngest({
+                        event_id: canonicalClientEventId,
                         system_id: systemId,
                         user_id: options.user_id,
                         input: maskedText,
@@ -2510,6 +2630,7 @@ var AgentID = class {
                         model: adapter.getModelName(maskedReq),
                         usage: void 0,
                         latency: void 0,
+                        event_type: "complete",
                         metadata: {
                           transformed_input: maskedText,
                           transformed_output: result.transformedOutput,
@@ -2517,10 +2638,17 @@ var AgentID = class {
                           shadow_mode: isShadowMode,
                           simulated_decision: verdict.simulated_decision ?? null,
                           simulated_output_decision: isShadowMode && result.outputMasked ? "masked" : "allowed",
-                          response_streamed: true
+                          response_streamed: true,
+                          guard_event_id: guardEventId,
+                          client_event_id: canonicalClientEventId
                         },
                         client_capabilities: this.buildClientCapabilities("openai", false)
                       }, requestOptions);
+                      if (!ingestResult.ok) {
+                        console.warn(
+                          `[AgentID] Stream ingest telemetry failed (status=${ingestResult.status ?? "network"}, reason=${ingestResult.reason ?? "unknown"}).`
+                        );
+                      }
                     }).catch((error) => {
                       console.error("[AgentID] Stream completion wrapping failed:", error);
                     });
@@ -2536,8 +2664,8 @@ var AgentID = class {
                   const model = adapter.getModelName(maskedReq, res);
                   const usage = adapter.getTokenUsage(res);
                   const outputForLog = isShadowMode ? wrappedCompletion.rawOutput : wrappedCompletion.transformedOutput;
-                  this.log({
-                    event_id: clientEventId,
+                  const ingestResult = await this.sendIngest({
+                    event_id: canonicalClientEventId,
                     system_id: systemId,
                     user_id: options.user_id,
                     input: maskedText,
@@ -2545,6 +2673,7 @@ var AgentID = class {
                     model,
                     usage,
                     latency,
+                    event_type: "complete",
                     metadata: {
                       transformed_input: maskedText,
                       transformed_output: wrappedCompletion.transformedOutput,
@@ -2552,10 +2681,17 @@ var AgentID = class {
                       shadow_mode: isShadowMode,
                       simulated_decision: verdict.simulated_decision ?? null,
                       simulated_output_decision: isShadowMode && wrappedCompletion.outputMasked ? "masked" : "allowed",
-                      response_streamed: false
+                      response_streamed: false,
+                      guard_event_id: guardEventId,
+                      client_event_id: canonicalClientEventId
                     },
                     client_capabilities: this.buildClientCapabilities("openai", false)
                   }, requestOptions);
+                  if (!ingestResult.ok) {
+                    console.warn(
+                      `[AgentID] Ingest telemetry failed (status=${ingestResult.status ?? "network"}, reason=${ingestResult.reason ?? "unknown"}).`
+                    );
+                  }
                 }
                 if (!capabilityConfig.block_pii_leakage && this.piiMasking && shouldDeanonymize) {
                   const deanon = this.pii.deanonymize(adapter.extractOutput(res), mapping);

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

@@ -82,9 +82,15 @@ declare class AgentID {
     private pii;
     private localEnforcer;
     private injectionScanner;
+    private requestClientEventIds;
+    private recentGuardVerdicts;
     constructor(config: AgentIDConfig);
     private buildClientCapabilities;
     private resolveApiKey;
+    private resolveClientEventId;
+    private buildGuardCacheKey;
+    private readCachedGuardVerdict;
+    private cacheGuardVerdict;
     getCapabilityConfig(force?: boolean, options?: RequestOptions): Promise<CapabilityConfig>;
     private getCachedCapabilityConfig;
     prepareInputForDispatch(params: {
@@ -103,6 +109,7 @@ declare class AgentID {
      * strictMode=true: FAIL-CLOSED and throws on connectivity/timeouts.
      */
     guard(params: GuardParams, options?: RequestOptions): Promise<GuardResponse>;
+    private sendIngest;
     private extractStreamChunkText;
     private wrapCompletion;
     /**

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

@@ -82,9 +82,15 @@ declare class AgentID {
     private pii;
     private localEnforcer;
     private injectionScanner;
+    private requestClientEventIds;
+    private recentGuardVerdicts;
     constructor(config: AgentIDConfig);
     private buildClientCapabilities;
     private resolveApiKey;
+    private resolveClientEventId;
+    private buildGuardCacheKey;
+    private readCachedGuardVerdict;
+    private cacheGuardVerdict;
     getCapabilityConfig(force?: boolean, options?: RequestOptions): Promise<CapabilityConfig>;
     private getCachedCapabilityConfig;
     prepareInputForDispatch(params: {
@@ -103,6 +109,7 @@ declare class AgentID {
      * strictMode=true: FAIL-CLOSED and throws on connectivity/timeouts.
      */
     guard(params: GuardParams, options?: RequestOptions): Promise<GuardResponse>;
+    private sendIngest;
     private extractStreamChunkText;
     private wrapCompletion;
     /**

package/dist/langchain.d.mts

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

package/dist/langchain.d.ts

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

package/package.json

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