agentid-sdk 0.1.24 → 0.1.25

package/README.md

@@ -99,6 +99,7 @@ const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY! });
 const secured = agent.wrapOpenAI(openai, {
   system_id: process.env.AGENTID_SYSTEM_ID!,
   user_id: "customer-123",
+  expected_languages: ["en"],
 });
 
 const response = await secured.chat.completions.create({
@@ -127,6 +128,7 @@ import { StringOutputParser } from "@langchain/core/output_parsers";
 const agent = new AgentID();
 const handler = new AgentIDCallbackHandler(agent, {
   system_id: process.env.AGENTID_SYSTEM_ID!,
+  expected_languages: ["en"],
 });
 
 const prompt = ChatPromptTemplate.fromTemplate("Answer in one sentence: {question}");

package/dist/{agentid-BGCUoYV7.d.mts → agentid-B5Y1g2Ko.d.mts}

@@ -5,6 +5,7 @@ type CapabilityConfig = {
     block_on_heuristic: boolean;
     inject_transparency_metadata: boolean;
     block_pii_leakage: boolean;
+    enable_sdk_pii_masking?: boolean;
     block_db_access: boolean;
     block_code_execution: boolean;
     block_toxicity: boolean;
@@ -37,9 +38,14 @@ interface GuardResponse {
     simulated_decision?: "allowed" | "masked" | "blocked";
     shadow_blocked?: boolean;
     policy_pack_matcher_backend?: "rust_wasm" | "js_hybrid" | "legacy_fallback";
-    policy_pack_scan_profile?: "expected_languages" | "core_en_fallback";
+    policy_pack_scan_profile?: "expected_languages" | "auto_detected" | "global_high_priority" | "core_en_fallback";
     policy_pack_scan_mode?: "full" | "segmented";
     exotic_language_detected?: boolean;
+    langid_primary?: string;
+    langid_confidence?: "high" | "medium" | "low";
+    langid_secondary?: string[];
+    langid_mixed?: boolean;
+    langid_source?: "input_detection" | "input_detection_with_hint";
     transparency?: TransparencyMetadata;
 }
 interface TransparencyMetadata {
@@ -51,6 +57,10 @@ interface TransparencyMetadata {
 interface RequestOptions {
     apiKey?: string;
 }
+type InjectionScanRequestOptions = RequestOptions & {
+    clientEventId?: string;
+    systemId?: string;
+};
 interface LogParams {
     event_id?: string;
     system_id?: string;
@@ -81,6 +91,7 @@ type AgentIDConfig = {
     aiScanEnabled?: boolean;
     storePii?: boolean;
     strictMode?: boolean;
+    failureMode?: "fail_open" | "fail_close";
     guardTimeoutMs?: number;
     ingestTimeoutMs?: number;
 };
@@ -93,14 +104,25 @@ declare class SecurityBlockError extends Error {
     reason: string;
     constructor(reason?: string);
 }
+declare class DependencyError extends Error {
+    dependency: "ingest";
+    reason: string;
+    status: number | null;
+    constructor(params: {
+        dependency: "ingest";
+        reason: string;
+        status: number | null;
+    });
+}
 declare class AgentID {
     private baseUrl;
     private apiKey;
-    private piiMasking;
+    private configuredPiiMasking;
     private checkInjection;
     private aiScanEnabled;
     private storePii;
     private strictMode;
+    private configuredFailureMode;
     private guardTimeoutMs;
     private ingestTimeoutMs;
     private pii;
@@ -108,6 +130,9 @@ declare class AgentID {
     private injectionScanner;
     private recentGuardVerdicts;
     constructor(config?: AgentIDConfig);
+    get piiMasking(): boolean | undefined;
+    private resolveEffectivePiiMasking;
+    getEffectivePiiMasking(options?: RequestOptions): boolean;
     private buildClientCapabilities;
     private resolveApiKey;
     private resolveClientEventId;
@@ -117,6 +142,7 @@ declare class AgentID {
     getCapabilityConfig(force?: boolean, options?: RequestOptions): Promise<CapabilityConfig>;
     private getCachedCapabilityConfig;
     private resolveEffectiveStrictMode;
+    private maybeRaiseStrictIngestDependencyError;
     private shouldRunLocalInjectionScan;
     prepareInputForDispatch(params: {
         input: string;
@@ -124,7 +150,7 @@ declare class AgentID {
         stream: boolean;
         skipInjectionScan?: boolean;
     }, options?: RequestOptions): Promise<PreparedInput>;
-    scanPromptInjection(input: string, options?: RequestOptions): Promise<void>;
+    scanPromptInjection(input: string, options?: InjectionScanRequestOptions): Promise<void>;
     private withMaskedOpenAIRequest;
     private logSecurityPolicyViolation;
     private logGuardFallback;
@@ -159,10 +185,12 @@ declare class AgentID {
     wrapOpenAI<T>(openai: T, options: {
         system_id: string;
         user_id?: string;
+        expected_languages?: string[];
+        expectedLanguages?: string[];
         apiKey?: string;
         api_key?: string;
         resolveApiKey?: (request: Record<string, unknown>) => string | undefined;
     }): T;
 }
 
-export { AgentID as A, type GuardParams as G, type LogParams as L, type PreparedInput as P, type RequestOptions as R, SecurityBlockError as S, type TransparencyMetadata as T, type GuardResponse as a };
+export { AgentID as A, DependencyError as D, type GuardParams as G, type LogParams as L, type PreparedInput as P, type RequestOptions as R, SecurityBlockError as S, type TransparencyMetadata as T, type GuardResponse as a };

package/dist/{agentid-BGCUoYV7.d.ts → agentid-B5Y1g2Ko.d.ts}

@@ -5,6 +5,7 @@ type CapabilityConfig = {
     block_on_heuristic: boolean;
     inject_transparency_metadata: boolean;
     block_pii_leakage: boolean;
+    enable_sdk_pii_masking?: boolean;
     block_db_access: boolean;
     block_code_execution: boolean;
     block_toxicity: boolean;
@@ -37,9 +38,14 @@ interface GuardResponse {
     simulated_decision?: "allowed" | "masked" | "blocked";
     shadow_blocked?: boolean;
     policy_pack_matcher_backend?: "rust_wasm" | "js_hybrid" | "legacy_fallback";
-    policy_pack_scan_profile?: "expected_languages" | "core_en_fallback";
+    policy_pack_scan_profile?: "expected_languages" | "auto_detected" | "global_high_priority" | "core_en_fallback";
     policy_pack_scan_mode?: "full" | "segmented";
     exotic_language_detected?: boolean;
+    langid_primary?: string;
+    langid_confidence?: "high" | "medium" | "low";
+    langid_secondary?: string[];
+    langid_mixed?: boolean;
+    langid_source?: "input_detection" | "input_detection_with_hint";
     transparency?: TransparencyMetadata;
 }
 interface TransparencyMetadata {
@@ -51,6 +57,10 @@ interface TransparencyMetadata {
 interface RequestOptions {
     apiKey?: string;
 }
+type InjectionScanRequestOptions = RequestOptions & {
+    clientEventId?: string;
+    systemId?: string;
+};
 interface LogParams {
     event_id?: string;
     system_id?: string;
@@ -81,6 +91,7 @@ type AgentIDConfig = {
     aiScanEnabled?: boolean;
     storePii?: boolean;
     strictMode?: boolean;
+    failureMode?: "fail_open" | "fail_close";
     guardTimeoutMs?: number;
     ingestTimeoutMs?: number;
 };
@@ -93,14 +104,25 @@ declare class SecurityBlockError extends Error {
     reason: string;
     constructor(reason?: string);
 }
+declare class DependencyError extends Error {
+    dependency: "ingest";
+    reason: string;
+    status: number | null;
+    constructor(params: {
+        dependency: "ingest";
+        reason: string;
+        status: number | null;
+    });
+}
 declare class AgentID {
     private baseUrl;
     private apiKey;
-    private piiMasking;
+    private configuredPiiMasking;
     private checkInjection;
     private aiScanEnabled;
     private storePii;
     private strictMode;
+    private configuredFailureMode;
     private guardTimeoutMs;
     private ingestTimeoutMs;
     private pii;
@@ -108,6 +130,9 @@ declare class AgentID {
     private injectionScanner;
     private recentGuardVerdicts;
     constructor(config?: AgentIDConfig);
+    get piiMasking(): boolean | undefined;
+    private resolveEffectivePiiMasking;
+    getEffectivePiiMasking(options?: RequestOptions): boolean;
     private buildClientCapabilities;
     private resolveApiKey;
     private resolveClientEventId;
@@ -117,6 +142,7 @@ declare class AgentID {
     getCapabilityConfig(force?: boolean, options?: RequestOptions): Promise<CapabilityConfig>;
     private getCachedCapabilityConfig;
     private resolveEffectiveStrictMode;
+    private maybeRaiseStrictIngestDependencyError;
     private shouldRunLocalInjectionScan;
     prepareInputForDispatch(params: {
         input: string;
@@ -124,7 +150,7 @@ declare class AgentID {
         stream: boolean;
         skipInjectionScan?: boolean;
     }, options?: RequestOptions): Promise<PreparedInput>;
-    scanPromptInjection(input: string, options?: RequestOptions): Promise<void>;
+    scanPromptInjection(input: string, options?: InjectionScanRequestOptions): Promise<void>;
     private withMaskedOpenAIRequest;
     private logSecurityPolicyViolation;
     private logGuardFallback;
@@ -159,10 +185,12 @@ declare class AgentID {
     wrapOpenAI<T>(openai: T, options: {
         system_id: string;
         user_id?: string;
+        expected_languages?: string[];
+        expectedLanguages?: string[];
         apiKey?: string;
         api_key?: string;
         resolveApiKey?: (request: Record<string, unknown>) => string | undefined;
     }): T;
 }
 
-export { AgentID as A, type GuardParams as G, type LogParams as L, type PreparedInput as P, type RequestOptions as R, SecurityBlockError as S, type TransparencyMetadata as T, type GuardResponse as a };
+export { AgentID as A, DependencyError as D, type GuardParams as G, type LogParams as L, type PreparedInput as P, type RequestOptions as R, SecurityBlockError as S, type TransparencyMetadata as T, type GuardResponse as a };