agentid-sdk 0.1.22 → 0.1.24

package/dist/index.mjs

@@ -6,9 +6,169 @@ import {
   SecurityBlockError,
   getInjectionScanner,
   scanWithRegex
-} from "./chunk-FVTL572H.mjs";
+} from "./chunk-JLHAS2EE.mjs";
+
+// src/transparency-badge.tsx
+import * as React from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+var DEFAULT_MESSAGE = "You are interacting with an AI.";
+var DEFAULT_BASE_URL = "https://api.getagentid.com/v1";
+function resolveBadgeMessage(params) {
+  if (typeof params.message === "string" && params.message.trim().length > 0) {
+    return params.message.trim();
+  }
+  if (params.metadata?.disclosure) {
+    return params.metadata.disclosure;
+  }
+  return DEFAULT_MESSAGE;
+}
+function normalizeBaseUrl(baseUrl) {
+  const candidate = typeof baseUrl === "string" && baseUrl.trim().length > 0 ? baseUrl.trim() : DEFAULT_BASE_URL;
+  return candidate.replace(/\/+$/, "");
+}
+function createEventId() {
+  try {
+    if (typeof globalThis !== "undefined" && globalThis.crypto?.randomUUID) {
+      return globalThis.crypto.randomUUID();
+    }
+  } catch {
+  }
+  const seed = Math.random().toString(16).slice(2).padEnd(12, "0").slice(0, 12);
+  return `00000000-0000-4000-8000-${seed}`;
+}
+async function sendTransparencyBadgeRenderedTelemetry(params) {
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  const eventId = createEventId();
+  const payload = {
+    event_id: eventId,
+    system_id: params.telemetry.systemId,
+    input: "__agentid_transparency_badge_rendered__",
+    output: params.disclosureText,
+    model: params.telemetry.model ?? "agentid-transparency-badge",
+    user_id: params.telemetry.userId,
+    event_type: "transparency_badge_rendered",
+    severity: "info",
+    timestamp,
+    metadata: {
+      compliance_event: "transparency_badge_rendered",
+      rendered_at: timestamp,
+      placement: params.placement,
+      disclosure_text: params.disclosureText,
+      ...params.telemetry.metadata ?? {}
+    }
+  };
+  const targetIngestUrl = typeof params.telemetry.ingestUrl === "string" && params.telemetry.ingestUrl.trim().length > 0 ? params.telemetry.ingestUrl.trim() : `${normalizeBaseUrl(params.telemetry.baseUrl)}/ingest`;
+  const headers = {
+    "Content-Type": "application/json",
+    "X-AgentID-SDK-Version": "js-1.1.0",
+    ...params.telemetry.headers ?? {}
+  };
+  if (typeof params.telemetry.apiKey === "string" && params.telemetry.apiKey.trim().length > 0) {
+    headers["x-agentid-api-key"] = params.telemetry.apiKey.trim();
+  }
+  const response = await fetch(targetIngestUrl, {
+    method: "POST",
+    headers,
+    body: JSON.stringify(payload),
+    keepalive: true
+  });
+  if (!response.ok) {
+    throw new Error(
+      `AgentID transparency badge telemetry failed (status=${response.status})`
+    );
+  }
+}
+function AgentIDTransparencyBadge(props) {
+  const placement = props.placement ?? "chat-header";
+  const fixed = props.fixed ?? true;
+  const text = resolveBadgeMessage({
+    metadata: props.metadata,
+    message: props.message
+  });
+  const hasLoggedRenderRef = React.useRef(false);
+  React.useEffect(() => {
+    if (hasLoggedRenderRef.current) {
+      return;
+    }
+    hasLoggedRenderRef.current = true;
+    void sendTransparencyBadgeRenderedTelemetry({
+      telemetry: props.telemetry,
+      disclosureText: text,
+      placement
+    }).catch((error) => {
+      if (typeof props.telemetry.onError === "function") {
+        props.telemetry.onError(error);
+        return;
+      }
+      console.warn(error);
+    });
+  }, [placement, props.telemetry, text]);
+  const containerStyle = placement === "watermark-overlay" ? {
+    position: fixed ? "fixed" : "absolute",
+    right: 16,
+    bottom: 16,
+    zIndex: 2147483e3,
+    pointerEvents: "none",
+    opacity: 0.95
+  } : {
+    position: fixed ? "fixed" : "sticky",
+    top: 0,
+    left: 0,
+    right: 0,
+    zIndex: 2147483e3,
+    pointerEvents: "none"
+  };
+  const badgeStyle = placement === "watermark-overlay" ? {
+    display: "inline-flex",
+    alignItems: "center",
+    gap: 8,
+    background: "rgba(15, 23, 42, 0.9)",
+    color: "#f8fafc",
+    borderRadius: 9999,
+    padding: "8px 12px",
+    fontFamily: "ui-sans-serif, -apple-system, BlinkMacSystemFont, Segoe UI, Helvetica, Arial, sans-serif",
+    fontSize: 12,
+    fontWeight: 600,
+    boxShadow: "0 8px 24px rgba(15, 23, 42, 0.28)",
+    pointerEvents: "none"
+  } : {
+    display: "flex",
+    alignItems: "center",
+    justifyContent: "center",
+    gap: 8,
+    background: "#0f172a",
+    color: "#f8fafc",
+    borderBottom: "1px solid rgba(148, 163, 184, 0.35)",
+    padding: "9px 12px",
+    fontFamily: "ui-sans-serif, -apple-system, BlinkMacSystemFont, Segoe UI, Helvetica, Arial, sans-serif",
+    fontSize: 13,
+    fontWeight: 600,
+    pointerEvents: "none"
+  };
+  const iconStyle = {
+    width: 22,
+    height: 22,
+    minWidth: 22,
+    borderRadius: 9999,
+    background: "#2563eb",
+    color: "#eff6ff",
+    display: "inline-flex",
+    alignItems: "center",
+    justifyContent: "center",
+    fontSize: 10,
+    fontWeight: 800,
+    letterSpacing: 0.5,
+    lineHeight: 1,
+    border: "1px solid rgba(191, 219, 254, 0.55)"
+  };
+  return /* @__PURE__ */ jsx("div", { className: props.className, style: containerStyle, "aria-live": "polite", role: "status", children: /* @__PURE__ */ jsxs("div", { style: badgeStyle, children: [
+    /* @__PURE__ */ jsx("span", { "aria-hidden": "true", style: iconStyle, children: "AI" }),
+    /* @__PURE__ */ jsx("span", { children: text })
+  ] }) });
+}
 export {
   AgentID,
+  AgentIDTransparencyBadge,
   InjectionScanner,
   OpenAIAdapter,
   PIIManager,

package/dist/langchain.d.mts

@@ -1,5 +1,5 @@
 import { BaseCallbackHandler } from '@langchain/core/callbacks/base';
-import { A as AgentID } from './agentid-BmsXTOCc.mjs';
+import { A as AgentID } from './agentid-BGCUoYV7.mjs';
 
 /**
  * LangChainJS callback handler (dependency-free shape).

package/dist/langchain.d.ts

@@ -1,5 +1,5 @@
 import { BaseCallbackHandler } from '@langchain/core/callbacks/base';
-import { A as AgentID } from './agentid-BmsXTOCc.js';
+import { A as AgentID } from './agentid-BGCUoYV7.js';
 
 /**
  * LangChainJS callback handler (dependency-free shape).

package/dist/langchain.js

@@ -27,7 +27,7 @@ var import_base = require("@langchain/core/callbacks/base");
 
 // src/sdk-version.ts
 var FALLBACK_SDK_VERSION = "js-0.0.0-dev";
-var AGENTID_SDK_VERSION_HEADER = "js-0.1.22".trim().length > 0 ? "js-0.1.22" : FALLBACK_SDK_VERSION;
+var AGENTID_SDK_VERSION_HEADER = "js-0.1.24".trim().length > 0 ? "js-0.1.24" : FALLBACK_SDK_VERSION;
 
 // src/pii-national-identifiers.ts
 var REGION_ANCHORS = {
@@ -215,6 +215,21 @@ var SecurityBlockError = class extends Error {
 function safeString(val) {
   return typeof val === "string" ? val : "";
 }
+function coerceTransparencyMetadata(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
+  }
+  const raw = value;
+  if (raw.is_ai_generated !== true || raw.disclosure !== "You are interacting with an AI." || raw.article !== "EU_AI_ACT_ARTICLE_50" || raw.injection_mode !== "deterministic") {
+    return void 0;
+  }
+  return {
+    is_ai_generated: true,
+    disclosure: "You are interacting with an AI.",
+    article: "EU_AI_ACT_ARTICLE_50",
+    injection_mode: "deterministic"
+  };
+}
 function callbackDebugEnabled() {
   try {
     return typeof process !== "undefined" && process?.env?.AGENTID_DEBUG_CALLBACK === "1";
@@ -483,6 +498,7 @@ var AgentIDCallbackHandler = class extends import_base.BaseCallbackHandler {
     }
     const requestedClientEventId = isUuidLike(id) ? id.trim() : createClientEventId();
     const modelName = extractModel(serialized, extraParams);
+    const pipelineStartedAtMs = Date.now();
     const verdict = await this.agent.guard({
       input: sanitizedInput,
       system_id: this.systemId,
@@ -495,6 +511,8 @@ var AgentIDCallbackHandler = class extends import_base.BaseCallbackHandler {
     }
     const canonicalClientEventId = isUuidLike(verdict.client_event_id) ? verdict.client_event_id.trim() : requestedClientEventId;
     const guardEventId = typeof verdict.guard_event_id === "string" && verdict.guard_event_id.length > 0 ? verdict.guard_event_id : void 0;
+    const guardLatencyMs = typeof verdict.guard_latency_ms === "number" && Number.isFinite(verdict.guard_latency_ms) ? Math.max(0, Math.trunc(verdict.guard_latency_ms)) : Math.max(0, Date.now() - pipelineStartedAtMs);
+    const transparency = coerceTransparencyMetadata(verdict.transparency);
     let transformedInput = typeof verdict.transformed_input === "string" && verdict.transformed_input.length > 0 ? verdict.transformed_input : sanitizedInput;
     if (transformedInput !== sanitizedInput) {
       const mutated = setPromptInPrompts(prompts, transformedInput);
@@ -505,9 +523,12 @@ var AgentIDCallbackHandler = class extends import_base.BaseCallbackHandler {
     this.runs.set(id, {
       input: transformedInput,
       startedAtMs: Date.now(),
+      pipelineStartedAtMs,
+      guardLatencyMs,
       model: modelName,
       clientEventId: canonicalClientEventId,
-      guardEventId
+      guardEventId,
+      transparency
     });
     logCallbackDebug("handleLLMStart state_set", {
       runId: id,
@@ -534,6 +555,7 @@ var AgentIDCallbackHandler = class extends import_base.BaseCallbackHandler {
     }
     const requestedClientEventId = isUuidLike(id) ? id.trim() : createClientEventId();
     const modelName = extractModel(serialized, extraParams);
+    const pipelineStartedAtMs = Date.now();
     const verdict = await this.agent.guard({
       input: sanitizedInput,
       system_id: this.systemId,
@@ -546,6 +568,8 @@ var AgentIDCallbackHandler = class extends import_base.BaseCallbackHandler {
     }
     const canonicalClientEventId = isUuidLike(verdict.client_event_id) ? verdict.client_event_id.trim() : requestedClientEventId;
     const guardEventId = typeof verdict.guard_event_id === "string" && verdict.guard_event_id.length > 0 ? verdict.guard_event_id : void 0;
+    const guardLatencyMs = typeof verdict.guard_latency_ms === "number" && Number.isFinite(verdict.guard_latency_ms) ? Math.max(0, Math.trunc(verdict.guard_latency_ms)) : Math.max(0, Date.now() - pipelineStartedAtMs);
+    const transparency = coerceTransparencyMetadata(verdict.transparency);
     let transformedInput = typeof verdict.transformed_input === "string" && verdict.transformed_input.length > 0 ? verdict.transformed_input : sanitizedInput;
     if (transformedInput !== sanitizedInput) {
       const mutated = setPromptInMessages(messages, transformedInput);
@@ -556,9 +580,12 @@ var AgentIDCallbackHandler = class extends import_base.BaseCallbackHandler {
     this.runs.set(id, {
       input: transformedInput,
       startedAtMs: Date.now(),
+      pipelineStartedAtMs,
+      guardLatencyMs,
       model: modelName,
       clientEventId: canonicalClientEventId,
-      guardEventId
+      guardEventId,
+      transparency
     });
     logCallbackDebug("handleChatModelStart state_set", {
       runId: id,
@@ -575,7 +602,11 @@ var AgentIDCallbackHandler = class extends import_base.BaseCallbackHandler {
       return;
     }
     this.runs.delete(id);
-    const latency = Date.now() - state.startedAtMs;
+    const modelLatencyMs = Math.max(0, Date.now() - state.startedAtMs);
+    const totalPipelineLatencyMs = Math.max(
+      0,
+      Date.now() - (state.pipelineStartedAtMs ?? state.startedAtMs)
+    );
     const outText = extractOutputText(output);
     const usage = extractTokenUsage(output);
     const metadata = {};
@@ -585,6 +616,14 @@ var AgentIDCallbackHandler = class extends import_base.BaseCallbackHandler {
     if (state.guardEventId) {
       metadata.guard_event_id = state.guardEventId;
     }
+    if (typeof state.guardLatencyMs === "number" && Number.isFinite(state.guardLatencyMs)) {
+      metadata.guard_latency_ms = state.guardLatencyMs;
+    }
+    if (state.transparency) {
+      metadata.transparency = state.transparency;
+    }
+    metadata.model_latency_ms = modelLatencyMs;
+    metadata.total_pipeline_latency_ms = totalPipelineLatencyMs;
     const resolvedModel = state.model ?? extractModelFromOutput(output) ?? "unknown";
     await this.agent.log({
       system_id: this.systemId,
@@ -593,7 +632,7 @@ var AgentIDCallbackHandler = class extends import_base.BaseCallbackHandler {
       event_id: state.clientEventId,
       model: resolvedModel,
       usage,
-      latency,
+      latency: modelLatencyMs,
       metadata: Object.keys(metadata).length > 0 ? metadata : void 0,
       client_capabilities: this.getLangchainCapabilities()
     }, this.requestOptions);
@@ -617,6 +656,12 @@ var AgentIDCallbackHandler = class extends import_base.BaseCallbackHandler {
     if (state?.guardEventId) {
       metadata.guard_event_id = state.guardEventId;
     }
+    if (typeof state?.guardLatencyMs === "number" && Number.isFinite(state.guardLatencyMs)) {
+      metadata.guard_latency_ms = state.guardLatencyMs;
+    }
+    if (state?.transparency) {
+      metadata.transparency = state.transparency;
+    }
     await this.agent.log({
       system_id: this.systemId,
       input: state?.input ?? "",

package/dist/langchain.mjs

@@ -1,12 +1,27 @@
 import {
   SecurityBlockError
-} from "./chunk-FVTL572H.mjs";
+} from "./chunk-JLHAS2EE.mjs";
 
 // src/langchain.ts
 import { BaseCallbackHandler } from "@langchain/core/callbacks/base";
 function safeString(val) {
   return typeof val === "string" ? val : "";
 }
+function coerceTransparencyMetadata(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
+  }
+  const raw = value;
+  if (raw.is_ai_generated !== true || raw.disclosure !== "You are interacting with an AI." || raw.article !== "EU_AI_ACT_ARTICLE_50" || raw.injection_mode !== "deterministic") {
+    return void 0;
+  }
+  return {
+    is_ai_generated: true,
+    disclosure: "You are interacting with an AI.",
+    article: "EU_AI_ACT_ARTICLE_50",
+    injection_mode: "deterministic"
+  };
+}
 function callbackDebugEnabled() {
   try {
     return typeof process !== "undefined" && process?.env?.AGENTID_DEBUG_CALLBACK === "1";
@@ -275,6 +290,7 @@ var AgentIDCallbackHandler = class extends BaseCallbackHandler {
     }
     const requestedClientEventId = isUuidLike(id) ? id.trim() : createClientEventId();
     const modelName = extractModel(serialized, extraParams);
+    const pipelineStartedAtMs = Date.now();
     const verdict = await this.agent.guard({
       input: sanitizedInput,
       system_id: this.systemId,
@@ -287,6 +303,8 @@ var AgentIDCallbackHandler = class extends BaseCallbackHandler {
     }
     const canonicalClientEventId = isUuidLike(verdict.client_event_id) ? verdict.client_event_id.trim() : requestedClientEventId;
     const guardEventId = typeof verdict.guard_event_id === "string" && verdict.guard_event_id.length > 0 ? verdict.guard_event_id : void 0;
+    const guardLatencyMs = typeof verdict.guard_latency_ms === "number" && Number.isFinite(verdict.guard_latency_ms) ? Math.max(0, Math.trunc(verdict.guard_latency_ms)) : Math.max(0, Date.now() - pipelineStartedAtMs);
+    const transparency = coerceTransparencyMetadata(verdict.transparency);
     let transformedInput = typeof verdict.transformed_input === "string" && verdict.transformed_input.length > 0 ? verdict.transformed_input : sanitizedInput;
     if (transformedInput !== sanitizedInput) {
       const mutated = setPromptInPrompts(prompts, transformedInput);
@@ -297,9 +315,12 @@ var AgentIDCallbackHandler = class extends BaseCallbackHandler {
     this.runs.set(id, {
       input: transformedInput,
       startedAtMs: Date.now(),
+      pipelineStartedAtMs,
+      guardLatencyMs,
       model: modelName,
       clientEventId: canonicalClientEventId,
-      guardEventId
+      guardEventId,
+      transparency
     });
     logCallbackDebug("handleLLMStart state_set", {
       runId: id,
@@ -326,6 +347,7 @@ var AgentIDCallbackHandler = class extends BaseCallbackHandler {
     }
     const requestedClientEventId = isUuidLike(id) ? id.trim() : createClientEventId();
     const modelName = extractModel(serialized, extraParams);
+    const pipelineStartedAtMs = Date.now();
     const verdict = await this.agent.guard({
       input: sanitizedInput,
       system_id: this.systemId,
@@ -338,6 +360,8 @@ var AgentIDCallbackHandler = class extends BaseCallbackHandler {
     }
     const canonicalClientEventId = isUuidLike(verdict.client_event_id) ? verdict.client_event_id.trim() : requestedClientEventId;
     const guardEventId = typeof verdict.guard_event_id === "string" && verdict.guard_event_id.length > 0 ? verdict.guard_event_id : void 0;
+    const guardLatencyMs = typeof verdict.guard_latency_ms === "number" && Number.isFinite(verdict.guard_latency_ms) ? Math.max(0, Math.trunc(verdict.guard_latency_ms)) : Math.max(0, Date.now() - pipelineStartedAtMs);
+    const transparency = coerceTransparencyMetadata(verdict.transparency);
     let transformedInput = typeof verdict.transformed_input === "string" && verdict.transformed_input.length > 0 ? verdict.transformed_input : sanitizedInput;
     if (transformedInput !== sanitizedInput) {
       const mutated = setPromptInMessages(messages, transformedInput);
@@ -348,9 +372,12 @@ var AgentIDCallbackHandler = class extends BaseCallbackHandler {
     this.runs.set(id, {
       input: transformedInput,
       startedAtMs: Date.now(),
+      pipelineStartedAtMs,
+      guardLatencyMs,
       model: modelName,
       clientEventId: canonicalClientEventId,
-      guardEventId
+      guardEventId,
+      transparency
     });
     logCallbackDebug("handleChatModelStart state_set", {
       runId: id,
@@ -367,7 +394,11 @@ var AgentIDCallbackHandler = class extends BaseCallbackHandler {
       return;
     }
     this.runs.delete(id);
-    const latency = Date.now() - state.startedAtMs;
+    const modelLatencyMs = Math.max(0, Date.now() - state.startedAtMs);
+    const totalPipelineLatencyMs = Math.max(
+      0,
+      Date.now() - (state.pipelineStartedAtMs ?? state.startedAtMs)
+    );
     const outText = extractOutputText(output);
     const usage = extractTokenUsage(output);
     const metadata = {};
@@ -377,6 +408,14 @@ var AgentIDCallbackHandler = class extends BaseCallbackHandler {
     if (state.guardEventId) {
       metadata.guard_event_id = state.guardEventId;
     }
+    if (typeof state.guardLatencyMs === "number" && Number.isFinite(state.guardLatencyMs)) {
+      metadata.guard_latency_ms = state.guardLatencyMs;
+    }
+    if (state.transparency) {
+      metadata.transparency = state.transparency;
+    }
+    metadata.model_latency_ms = modelLatencyMs;
+    metadata.total_pipeline_latency_ms = totalPipelineLatencyMs;
     const resolvedModel = state.model ?? extractModelFromOutput(output) ?? "unknown";
     await this.agent.log({
       system_id: this.systemId,
@@ -385,7 +424,7 @@ var AgentIDCallbackHandler = class extends BaseCallbackHandler {
       event_id: state.clientEventId,
       model: resolvedModel,
       usage,
-      latency,
+      latency: modelLatencyMs,
       metadata: Object.keys(metadata).length > 0 ? metadata : void 0,
       client_capabilities: this.getLangchainCapabilities()
     }, this.requestOptions);
@@ -409,6 +448,12 @@ var AgentIDCallbackHandler = class extends BaseCallbackHandler {
     if (state?.guardEventId) {
       metadata.guard_event_id = state.guardEventId;
     }
+    if (typeof state?.guardLatencyMs === "number" && Number.isFinite(state.guardLatencyMs)) {
+      metadata.guard_latency_ms = state.guardLatencyMs;
+    }
+    if (state?.transparency) {
+      metadata.transparency = state.transparency;
+    }
     await this.agent.log({
       system_id: this.systemId,
       input: state?.input ?? "",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentid-sdk",
-  "version": "0.1.22",
+  "version": "0.1.24",
   "description": "AgentID JavaScript/TypeScript SDK for guard, ingest, tracing, and analytics.",
   "license": "MIT",
   "homepage": "https://agentid.ai",
@@ -40,8 +40,9 @@
   },
   "peerDependencies": {
     "@langchain/core": "^0.3.0 || ^1.0.0",
+    "langchain": "^0.1.0",
     "openai": "^4.0.0 || ^5.0.0 || ^6.0.0",
-    "langchain": "^0.1.0"
+    "react": "^18.0.0 || ^19.0.0"
   },
   "peerDependenciesMeta": {
     "@langchain/core": {
@@ -49,10 +50,17 @@
     },
     "langchain": {
       "optional": true
+    },
+    "react": {
+      "optional": true
     }
   },
   "devDependencies": {
+    "@types/react": "^19.2.2",
     "tsup": "^8.3.5",
     "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "agentid-sdk": "^0.1.21"
   }
 }