@driftgard/node 1.4.0 → 1.5.0

package/README.md

@@ -27,10 +27,32 @@ const result = await dg.evaluate({
 if (result.evaluation.allowed) {
   console.log("Safe to return to user");
 } else {
+  // Use the fallback message if configured in your control pack
+  if (result.fallback) {
+    console.log("Show to user:", result.fallback.message);
+  }
   console.log("Blocked:", result.evaluation.violations);
 }
 ```
 
+## Conversation tracking
+
+Link evaluations within an agent session using `session_id` and `parent_evaluation_id`:
+
+```typescript
+const result = await dg.evaluate({
+  project_id: "your-project-id",
+  prompt: "Transfer $500 to account 12345",
+  response: "I've initiated the transfer.",
+  model_id: "gpt-4o",
+  session_id: "sess_abc123",              // groups evals in a conversation
+  parent_evaluation_id: "eval_prev_id",   // chains to the previous eval
+});
+```
+
+This enables chain depth protection (prevents infinite agent loops) and lets you trace evaluation lineage in the dashboard.
+```
+
 ## A/B experiments
 
 Tag evaluations with an `experiment_id` to compare governance metrics across models:
@@ -73,7 +95,7 @@ All fields in `usage` are optional. When provided, token and cost data appears i
 
 - Single `evaluate()` method — send prompt/response, get verdict
 - Auto-retry with exponential backoff on 5xx and network errors
-- Typed errors: `AuthError`, `RateLimitError`, `FeatureNotAvailableError`
+- Typed errors: `AuthError`, `RateLimitError`, `FeatureNotAvailableError`, `ChainDepthExceededError`
 - Full TypeScript types for requests and responses
 - Zero dependencies (uses native `fetch`)
 
@@ -91,7 +113,7 @@ const dg = new Driftgard({
 ## Error handling
 
 ```typescript
-import { Driftgard, AuthError, RateLimitError, FeatureNotAvailableError } from "@driftgard/node";
+import { Driftgard, AuthError, RateLimitError, FeatureNotAvailableError, ChainDepthExceededError } from "@driftgard/node";
 
 try {
   const result = await dg.evaluate({ ... });
@@ -100,6 +122,9 @@ try {
     // Invalid or revoked API key (401)
   } else if (e instanceof RateLimitError) {
     // Too many requests (429)
+  } else if (e instanceof ChainDepthExceededError) {
+    // Agent loop detected — chain depth exceeded (429)
+    console.log(`Depth ${e.depth} exceeds max ${e.max}`);
   } else if (e instanceof FeatureNotAvailableError) {
     // API evaluate requires Compliance+ tier (403)
   }

package/dist/errors.d.ts

@@ -13,3 +13,8 @@ export declare class FeatureNotAvailableError extends DriftgardError {
     tier: string;
     constructor(message?: string, tier?: string);
 }
+export declare class ChainDepthExceededError extends DriftgardError {
+    depth: number;
+    max: number;
+    constructor(message?: string, depth?: number, max?: number);
+}

package/dist/errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FeatureNotAvailableError = exports.RateLimitError = exports.AuthError = exports.DriftgardError = void 0;
+exports.ChainDepthExceededError = exports.FeatureNotAvailableError = exports.RateLimitError = exports.AuthError = exports.DriftgardError = void 0;
 class DriftgardError extends Error {
     constructor(message, status, code) {
         super(message);
@@ -32,3 +32,12 @@ class FeatureNotAvailableError extends DriftgardError {
     }
 }
 exports.FeatureNotAvailableError = FeatureNotAvailableError;
+class ChainDepthExceededError extends DriftgardError {
+    constructor(message = "Evaluation chain depth exceeded", depth = 0, max = 0) {
+        super(message, 429, "chain_depth_exceeded");
+        this.name = "ChainDepthExceededError";
+        this.depth = depth;
+        this.max = max;
+    }
+}
+exports.ChainDepthExceededError = ChainDepthExceededError;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { DriftgardConfig, EvaluateRequest, EvaluateResponse } from "./types";
 export { DriftgardConfig, EvaluateRequest, EvaluateResponse } from "./types";
-export { Violation, EvaluationResult, HitlInfo } from "./types";
-export { DriftgardError, AuthError, RateLimitError, FeatureNotAvailableError } from "./errors";
+export { Violation, EvaluationResult, FallbackResponse, HitlInfo } from "./types";
+export { DriftgardError, AuthError, RateLimitError, FeatureNotAvailableError, ChainDepthExceededError } from "./errors";
 export declare class Driftgard {
     private apiKey;
     private baseUrl;

package/dist/index.js

@@ -1,12 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Driftgard = exports.FeatureNotAvailableError = exports.RateLimitError = exports.AuthError = exports.DriftgardError = void 0;
+exports.Driftgard = exports.ChainDepthExceededError = exports.FeatureNotAvailableError = exports.RateLimitError = exports.AuthError = exports.DriftgardError = void 0;
 const errors_1 = require("./errors");
 var errors_2 = require("./errors");
 Object.defineProperty(exports, "DriftgardError", { enumerable: true, get: function () { return errors_2.DriftgardError; } });
 Object.defineProperty(exports, "AuthError", { enumerable: true, get: function () { return errors_2.AuthError; } });
 Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return errors_2.RateLimitError; } });
 Object.defineProperty(exports, "FeatureNotAvailableError", { enumerable: true, get: function () { return errors_2.FeatureNotAvailableError; } });
+Object.defineProperty(exports, "ChainDepthExceededError", { enumerable: true, get: function () { return errors_2.ChainDepthExceededError; } });
 const DEFAULT_BASE_URL = "https://api.driftgard.com";
 const DEFAULT_TIMEOUT = 30000;
 const DEFAULT_MAX_RETRIES = 2;
@@ -31,6 +32,11 @@ class Driftgard {
             model_id: req.model_id,
             timestamp: req.timestamp || new Date().toISOString(),
             ...(req.experiment_id ? { experiment_id: req.experiment_id } : {}),
+            ...(req.session_id ? { session_id: req.session_id } : {}),
+            ...(req.parent_evaluation_id ? { parent_evaluation_id: req.parent_evaluation_id } : {}),
+            ...(req.control_pack_id ? { control_pack_id: req.control_pack_id } : {}),
+            ...(req.control_pack_version ? { control_pack_version: req.control_pack_version } : {}),
+            ...(req.dry_run ? { dry_run: req.dry_run } : {}),
             ...(req.usage ? { usage: req.usage } : {}),
         });
     }
@@ -49,8 +55,13 @@ class Driftgard {
             });
             if (res.status === 401)
                 throw new errors_1.AuthError();
-            if (res.status === 429)
+            if (res.status === 429) {
+                const payload = await res.json().catch(() => ({}));
+                if (payload?.error === "chain_depth_exceeded") {
+                    throw new errors_1.ChainDepthExceededError(payload.message, payload.depth, payload.max);
+                }
                 throw new errors_1.RateLimitError();
+            }
             if (res.status === 403) {
                 const payload = await res.json().catch(() => ({}));
                 if (payload?.error === "feature_not_available") {

package/dist/types.d.ts

@@ -11,6 +11,11 @@ export interface EvaluateRequest {
     model_id: string;
     timestamp?: string;
     experiment_id?: string;
+    session_id?: string;
+    parent_evaluation_id?: string;
+    control_pack_id?: string;
+    control_pack_version?: number;
+    dry_run?: boolean;
     usage?: {
         prompt_tokens?: number;
         completion_tokens?: number;
@@ -32,6 +37,10 @@ export interface EvaluationResult {
     flags?: {
         pii_detected?: boolean;
         pii_in_prompt?: boolean;
+        secret_detected?: boolean;
+        adversarial_input?: boolean;
+        adversarial_score?: number;
+        dlp_findings_count?: number;
         meta_bypass_detected?: boolean;
         judge_used?: boolean;
         judge_called?: boolean;
@@ -39,6 +48,14 @@ export interface EvaluationResult {
         hard_blocked?: boolean;
     };
 }
+export interface FallbackResponse {
+    message: string;
+    code: string;
+    action: string;
+    source: string;
+    escalated: boolean;
+    retry_after_ms?: number | null;
+}
 export interface HitlInfo {
     queued: boolean;
     hitl_id?: string;
@@ -53,6 +70,17 @@ export interface EvaluateResponse {
     active_control_pack_version: number;
     data_mode: string;
     telemetry_mode: string;
-    hitl: HitlInfo;
+    dry_run?: boolean;
+    experiment_id?: string;
+    session_id?: string;
+    parent_evaluation_id?: string;
+    usage?: {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+        total_tokens?: number;
+        cost?: number;
+    };
+    hitl?: HitlInfo;
     evaluation: EvaluationResult;
+    fallback?: FallbackResponse;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@driftgard/node",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Official Driftgard Node.js SDK — evaluate LLM interactions against your compliance policy",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",