agentid-sdk 0.1.37 → 0.1.40

package/dist/agentid-JQx2Iy7B.d.mts

@@ -1,240 +0,0 @@
-type PIIMapping = Record<string, string>;
-declare class PIIManager {
-    /**
-     * Reversible local-first masking using <TYPE_INDEX> placeholders.
-     *
-     * Zero-dependency fallback with strict checksum validation for CEE national IDs.
-     */
-    anonymize(text: string): {
-        maskedText: string;
-        mapping: PIIMapping;
-    };
-    deanonymize(text: string, mapping: PIIMapping): string;
-}
-
-type CapabilityConfig = {
-    version?: number | null;
-    shadow_mode: boolean;
-    strict_security_mode: boolean;
-    failure_mode: "fail_open" | "fail_close";
-    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;
-};
-
-interface GuardParams {
-    input: string;
-    system_id: string;
-    model?: string;
-    user_id?: string;
-    client_event_id?: string;
-    expected_languages?: string[];
-    request_identity?: Record<string, unknown>;
-    client_capabilities?: {
-        capabilities: {
-            has_feedback_handler: boolean;
-            pii_masking_enabled: boolean;
-            framework: string;
-        };
-    };
-}
-interface GuardResponse {
-    allowed: boolean;
-    reason?: string;
-    detected_pii?: boolean;
-    transformed_input?: string;
-    guard_event_id?: string;
-    client_event_id?: string;
-    guard_latency_ms?: number;
-    shadow_mode?: boolean;
-    simulated_decision?: "allowed" | "masked" | "blocked";
-    shadow_blocked?: boolean;
-    policy_pack_matcher_backend?: "rust_wasm" | "js_hybrid" | "legacy_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 {
-    is_ai_generated: true;
-    disclosure: "You are interacting with an AI.";
-    article: "EU_AI_ACT_ARTICLE_50";
-    injection_mode: "deterministic";
-}
-interface RequestOptions {
-    apiKey?: string;
-}
-type InjectionScanRequestOptions = RequestOptions & {
-    clientEventId?: string;
-    systemId?: string;
-};
-interface LogParams {
-    event_id?: string;
-    system_id?: string;
-    input: string;
-    output: string;
-    model: string;
-    usage?: Record<string, unknown>;
-    tokens?: Record<string, unknown>;
-    latency?: number;
-    user_id?: string;
-    request_identity?: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-    event_type?: "start" | "complete" | "error" | "human_override" | "security_alert" | "security_block" | "security_policy_violation" | "transparency_badge_rendered";
-    severity?: "info" | "warning" | "error" | "high";
-    timestamp?: string;
-    client_capabilities?: {
-        capabilities: {
-            has_feedback_handler: boolean;
-            pii_masking_enabled: boolean;
-            framework: string;
-        };
-    };
-}
-type AgentIDConfig = {
-    apiKey?: string;
-    baseUrl?: string;
-    piiMasking?: boolean;
-    checkInjection?: boolean;
-    clientFastFail?: boolean;
-    client_fast_fail?: boolean;
-    aiScanEnabled?: boolean;
-    storePii?: boolean;
-    strictMode?: boolean;
-    failureMode?: "fail_open" | "fail_close";
-    guardTimeoutMs?: number;
-    ingestTimeoutMs?: number;
-};
-
-type PreparedInput = {
-    sanitizedInput: string;
-    capabilityConfig: CapabilityConfig;
-    sdkConfigFetchMs?: number;
-    sdkLocalScanMs?: number;
-    piiMapping?: PIIMapping;
-    shouldDeanonymize?: boolean;
-};
-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 configuredPiiMasking;
-    private checkInjection;
-    private clientFastFail;
-    private aiScanEnabled;
-    private storePii;
-    private strictMode;
-    private configuredFailureMode;
-    private guardTimeoutMs;
-    private ingestTimeoutMs;
-    private pii;
-    private localEnforcer;
-    private injectionScanner;
-    private recentGuardVerdicts;
-    constructor(config?: AgentIDConfig);
-    get piiMasking(): boolean | undefined;
-    private resolveEffectivePiiMasking;
-    getEffectivePiiMasking(options?: RequestOptions): boolean;
-    getEffectivePiiMaskingForConfig(capabilityConfig?: CapabilityConfig): boolean;
-    private buildClientCapabilities;
-    private resolveApiKey;
-    private resolveClientEventId;
-    private buildGuardCacheKey;
-    private readCachedGuardVerdict;
-    private cacheGuardVerdict;
-    getCapabilityConfig(force?: boolean, options?: RequestOptions): Promise<CapabilityConfig>;
-    private getCapabilityConfigWithTelemetry;
-    private getCachedCapabilityConfig;
-    private resolveEffectiveStrictMode;
-    private maybeRaiseStrictIngestDependencyError;
-    private shouldRunLocalInjectionScan;
-    private refreshCapabilityConfigBeforeClientControl;
-    private applyLocalPolicyChecks;
-    prepareInputForDispatch(params: {
-        input: string;
-        systemId: string;
-        stream: boolean;
-        skipInjectionScan?: boolean;
-        clientEventId?: string;
-    }, options?: RequestOptions): Promise<PreparedInput>;
-    applyLocalFallbackForGuardFailure(params: {
-        input: string;
-        systemId: string;
-        stream: boolean;
-        clientEventId?: string;
-        capabilityConfig?: CapabilityConfig;
-        sdkConfigFetchMs?: number;
-    }, options?: RequestOptions): Promise<PreparedInput>;
-    scanPromptInjection(input: string, options?: InjectionScanRequestOptions): Promise<void>;
-    private withMaskedOpenAIRequest;
-    private logSecurityPolicyViolation;
-    private logGuardFallback;
-    private finalizeIngestTelemetry;
-    /**
-     * GUARD: Checks limits, PII, and security before execution.
-     * strictMode=false (default): FAIL-OPEN on connectivity/timeouts.
-     * strictMode=true: FAIL-CLOSED and throws on connectivity/timeouts.
-     */
-    guard(params: GuardParams, options?: RequestOptions): Promise<GuardResponse>;
-    private sendIngest;
-    private extractStreamChunkText;
-    private extractStreamChunkUsage;
-    private isOpenAIStreamFinishChunk;
-    private setOpenAIStreamChunkText;
-    private createSyntheticOpenAIStreamChunk;
-    private rewriteOpenAIStreamChunkForClient;
-    private wrapCompletion;
-    /**
-     * LOG: Sends telemetry after execution.
-     * Returns a Promise so callers can await persistence when needed.
-     */
-    log(params: LogParams, options?: RequestOptions): Promise<void>;
-    /**
-     * Analytics alias for telemetry logging.
-     */
-    analytics(params: LogParams, options?: RequestOptions): Promise<void>;
-    /**
-     * Trace alias for telemetry logging.
-     */
-    trace(params: LogParams, options?: RequestOptions): Promise<void>;
-    /**
-     * Wrap an OpenAI client once; AgentID will automatically:
-     * - run guard() before chat.completions.create
-     * - measure latency
-     * - persist ingest telemetry for the wrapped call
-     */
-    wrapOpenAI<T>(openai: T, options: {
-        system_id: string;
-        user_id?: string;
-        expected_languages?: string[];
-        expectedLanguages?: string[];
-        request_identity?: Record<string, unknown>;
-        apiKey?: string;
-        api_key?: string;
-        resolveApiKey?: (request: Record<string, unknown>) => string | undefined;
-    }): T;
-}
-
-export { AgentID as A, DependencyError as D, type GuardParams as G, type LogParams as L, PIIManager as P, type RequestOptions as R, SecurityBlockError as S, type TransparencyMetadata as T, type GuardResponse as a, type PIIMapping as b, type PreparedInput as c };

package/dist/agentid-JQx2Iy7B.d.ts

@@ -1,240 +0,0 @@
-type PIIMapping = Record<string, string>;
-declare class PIIManager {
-    /**
-     * Reversible local-first masking using <TYPE_INDEX> placeholders.
-     *
-     * Zero-dependency fallback with strict checksum validation for CEE national IDs.
-     */
-    anonymize(text: string): {
-        maskedText: string;
-        mapping: PIIMapping;
-    };
-    deanonymize(text: string, mapping: PIIMapping): string;
-}
-
-type CapabilityConfig = {
-    version?: number | null;
-    shadow_mode: boolean;
-    strict_security_mode: boolean;
-    failure_mode: "fail_open" | "fail_close";
-    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;
-};
-
-interface GuardParams {
-    input: string;
-    system_id: string;
-    model?: string;
-    user_id?: string;
-    client_event_id?: string;
-    expected_languages?: string[];
-    request_identity?: Record<string, unknown>;
-    client_capabilities?: {
-        capabilities: {
-            has_feedback_handler: boolean;
-            pii_masking_enabled: boolean;
-            framework: string;
-        };
-    };
-}
-interface GuardResponse {
-    allowed: boolean;
-    reason?: string;
-    detected_pii?: boolean;
-    transformed_input?: string;
-    guard_event_id?: string;
-    client_event_id?: string;
-    guard_latency_ms?: number;
-    shadow_mode?: boolean;
-    simulated_decision?: "allowed" | "masked" | "blocked";
-    shadow_blocked?: boolean;
-    policy_pack_matcher_backend?: "rust_wasm" | "js_hybrid" | "legacy_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 {
-    is_ai_generated: true;
-    disclosure: "You are interacting with an AI.";
-    article: "EU_AI_ACT_ARTICLE_50";
-    injection_mode: "deterministic";
-}
-interface RequestOptions {
-    apiKey?: string;
-}
-type InjectionScanRequestOptions = RequestOptions & {
-    clientEventId?: string;
-    systemId?: string;
-};
-interface LogParams {
-    event_id?: string;
-    system_id?: string;
-    input: string;
-    output: string;
-    model: string;
-    usage?: Record<string, unknown>;
-    tokens?: Record<string, unknown>;
-    latency?: number;
-    user_id?: string;
-    request_identity?: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-    event_type?: "start" | "complete" | "error" | "human_override" | "security_alert" | "security_block" | "security_policy_violation" | "transparency_badge_rendered";
-    severity?: "info" | "warning" | "error" | "high";
-    timestamp?: string;
-    client_capabilities?: {
-        capabilities: {
-            has_feedback_handler: boolean;
-            pii_masking_enabled: boolean;
-            framework: string;
-        };
-    };
-}
-type AgentIDConfig = {
-    apiKey?: string;
-    baseUrl?: string;
-    piiMasking?: boolean;
-    checkInjection?: boolean;
-    clientFastFail?: boolean;
-    client_fast_fail?: boolean;
-    aiScanEnabled?: boolean;
-    storePii?: boolean;
-    strictMode?: boolean;
-    failureMode?: "fail_open" | "fail_close";
-    guardTimeoutMs?: number;
-    ingestTimeoutMs?: number;
-};
-
-type PreparedInput = {
-    sanitizedInput: string;
-    capabilityConfig: CapabilityConfig;
-    sdkConfigFetchMs?: number;
-    sdkLocalScanMs?: number;
-    piiMapping?: PIIMapping;
-    shouldDeanonymize?: boolean;
-};
-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 configuredPiiMasking;
-    private checkInjection;
-    private clientFastFail;
-    private aiScanEnabled;
-    private storePii;
-    private strictMode;
-    private configuredFailureMode;
-    private guardTimeoutMs;
-    private ingestTimeoutMs;
-    private pii;
-    private localEnforcer;
-    private injectionScanner;
-    private recentGuardVerdicts;
-    constructor(config?: AgentIDConfig);
-    get piiMasking(): boolean | undefined;
-    private resolveEffectivePiiMasking;
-    getEffectivePiiMasking(options?: RequestOptions): boolean;
-    getEffectivePiiMaskingForConfig(capabilityConfig?: CapabilityConfig): boolean;
-    private buildClientCapabilities;
-    private resolveApiKey;
-    private resolveClientEventId;
-    private buildGuardCacheKey;
-    private readCachedGuardVerdict;
-    private cacheGuardVerdict;
-    getCapabilityConfig(force?: boolean, options?: RequestOptions): Promise<CapabilityConfig>;
-    private getCapabilityConfigWithTelemetry;
-    private getCachedCapabilityConfig;
-    private resolveEffectiveStrictMode;
-    private maybeRaiseStrictIngestDependencyError;
-    private shouldRunLocalInjectionScan;
-    private refreshCapabilityConfigBeforeClientControl;
-    private applyLocalPolicyChecks;
-    prepareInputForDispatch(params: {
-        input: string;
-        systemId: string;
-        stream: boolean;
-        skipInjectionScan?: boolean;
-        clientEventId?: string;
-    }, options?: RequestOptions): Promise<PreparedInput>;
-    applyLocalFallbackForGuardFailure(params: {
-        input: string;
-        systemId: string;
-        stream: boolean;
-        clientEventId?: string;
-        capabilityConfig?: CapabilityConfig;
-        sdkConfigFetchMs?: number;
-    }, options?: RequestOptions): Promise<PreparedInput>;
-    scanPromptInjection(input: string, options?: InjectionScanRequestOptions): Promise<void>;
-    private withMaskedOpenAIRequest;
-    private logSecurityPolicyViolation;
-    private logGuardFallback;
-    private finalizeIngestTelemetry;
-    /**
-     * GUARD: Checks limits, PII, and security before execution.
-     * strictMode=false (default): FAIL-OPEN on connectivity/timeouts.
-     * strictMode=true: FAIL-CLOSED and throws on connectivity/timeouts.
-     */
-    guard(params: GuardParams, options?: RequestOptions): Promise<GuardResponse>;
-    private sendIngest;
-    private extractStreamChunkText;
-    private extractStreamChunkUsage;
-    private isOpenAIStreamFinishChunk;
-    private setOpenAIStreamChunkText;
-    private createSyntheticOpenAIStreamChunk;
-    private rewriteOpenAIStreamChunkForClient;
-    private wrapCompletion;
-    /**
-     * LOG: Sends telemetry after execution.
-     * Returns a Promise so callers can await persistence when needed.
-     */
-    log(params: LogParams, options?: RequestOptions): Promise<void>;
-    /**
-     * Analytics alias for telemetry logging.
-     */
-    analytics(params: LogParams, options?: RequestOptions): Promise<void>;
-    /**
-     * Trace alias for telemetry logging.
-     */
-    trace(params: LogParams, options?: RequestOptions): Promise<void>;
-    /**
-     * Wrap an OpenAI client once; AgentID will automatically:
-     * - run guard() before chat.completions.create
-     * - measure latency
-     * - persist ingest telemetry for the wrapped call
-     */
-    wrapOpenAI<T>(openai: T, options: {
-        system_id: string;
-        user_id?: string;
-        expected_languages?: string[];
-        expectedLanguages?: string[];
-        request_identity?: Record<string, unknown>;
-        apiKey?: string;
-        api_key?: string;
-        resolveApiKey?: (request: Record<string, unknown>) => string | undefined;
-    }): T;
-}
-
-export { AgentID as A, DependencyError as D, type GuardParams as G, type LogParams as L, PIIManager as P, type RequestOptions as R, SecurityBlockError as S, type TransparencyMetadata as T, type GuardResponse as a, type PIIMapping as b, type PreparedInput as c };