@mandatedev/agent 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,275 @@
+type AgentFramework = 'openai-assistants' | 'langchain' | 'autogen' | 'crewai' | 'anthropic' | 'custom';
+type AgentEnvironment = 'production' | 'staging' | 'development';
+type AgentRiskTier = 'LOW' | 'STANDARD' | 'HIGH' | 'CRITICAL';
+type DegradationTier = 'NOMINAL' | 'DEGRADED' | 'ISOLATED' | 'GRACE_STD' | 'GRACE_HIGH';
+type PolicyDecision = 'ALLOW' | 'DENY' | 'ESCALATE' | 'THROTTLE';
+type ResponseLevel = 1 | 2 | 3 | 4 | 5;
+interface IntentContext {
+    agentId: string;
+    sessionId: string;
+    environment: AgentEnvironment;
+    stepInChain: number;
+    framework: AgentFramework;
+    timestamp: number;
+}
+interface AgentIntent {
+    toolName: string;
+    args: Record<string, unknown>;
+    context: IntentContext;
+}
+interface EvaluationResult {
+    decision: PolicyDecision;
+    reason: string;
+    latencyMs: number;
+    ruleMatched?: string;
+    anomalyScore?: number;
+    responseLevel?: ResponseLevel;
+}
+type ConditionOperator = 'eq' | 'neq' | 'lt' | 'lte' | 'gt' | 'gte' | 'in' | 'nin' | 'startsWith' | 'endsWith' | 'contains';
+interface PolicyCondition {
+    field: string;
+    operator: ConditionOperator;
+    value: unknown;
+}
+interface PolicyRule {
+    tool: string;
+    conditions?: PolicyCondition[];
+}
+interface PolicyIdentity {
+    org: string;
+    env: AgentEnvironment;
+    framework?: string;
+}
+interface AnomalyThresholds {
+    alert: number;
+    throttle: number;
+}
+interface LocalAutonomyConfig {
+    gracePeriodMs: number;
+    postGrace: 'PAUSE' | 'STOP';
+}
+interface MandatePolicy {
+    agentId: string;
+    version: string;
+    policyHash: string;
+    identity: PolicyIdentity;
+    allow: PolicyRule[];
+    deny: PolicyRule[];
+    anomalyThresholds: AnomalyThresholds;
+    localAutonomy: LocalAutonomyConfig;
+}
+interface AuditEvent {
+    eventId: string;
+    prevHash: string;
+    eventHash: string;
+    timestamp: number;
+    source: 'REALTIME' | 'BUFFER_SYNC';
+    agentId: string;
+    orgId: string;
+    policyHash: string;
+    degradationTier: DegradationTier;
+    toolName: string;
+    toolArgs: Record<string, unknown>;
+    intentContext: IntentContext;
+    anomalyScore: number;
+    blastRadiusEst?: string;
+    policyDecision: PolicyDecision;
+    responseLevel: ResponseLevel;
+    evalLatencyMs: number;
+    tokensUsed?: number;
+    costUsd?: number;
+}
+interface MandateConfig {
+    agentId: string;
+    orgId: string;
+    apiKey?: string;
+    controlPlaneUrl?: string;
+    policy: MandatePolicy;
+    framework: AgentFramework;
+    environment: AgentEnvironment;
+    auditLevel: 'full' | 'minimal' | 'off';
+    riskTier?: AgentRiskTier;
+    onViolation?: (intent: AgentIntent, result: EvaluationResult) => void;
+    onAlert?: (intent: AgentIntent, score: number) => void;
+    onDegradation?: (from: DegradationTier, to: DegradationTier) => void;
+}
+
+declare class JSPolicyEvaluator {
+    private policy;
+    constructor(policy: MandatePolicy);
+    evaluate(intent: AgentIntent): EvaluationResult;
+    updatePolicy(policy: MandatePolicy): void;
+    getPolicyHash(): string;
+    private matchesRule;
+    private matchesToolPattern;
+    private evaluateCondition;
+    private resolveField;
+    private result;
+}
+
+interface BufferOptions {
+    maxSize?: number;
+    flushCallback?: (events: AuditEvent[]) => Promise<void>;
+}
+interface AppendInput {
+    timestamp: number;
+    source: 'REALTIME' | 'BUFFER_SYNC';
+    agentId: string;
+    orgId: string;
+    policyHash: string;
+    degradationTier: DegradationTier;
+    toolName: string;
+    toolArgs: Record<string, unknown>;
+    intentContext: AuditEvent['intentContext'];
+    anomalyScore: number;
+    policyDecision: PolicyDecision;
+    responseLevel: AuditEvent['responseLevel'];
+    evalLatencyMs: number;
+    blastRadiusEst?: string;
+    tokensUsed?: number;
+    costUsd?: number;
+}
+interface VerifyResult {
+    valid: boolean;
+    corruptedAt?: number;
+}
+declare class AuditBuffer {
+    private buffer;
+    private lastHash;
+    private maxSize;
+    private flushCallback?;
+    constructor(options?: BufferOptions);
+    append(input: AppendInput): AuditEvent;
+    flush(): Promise<AuditEvent[]>;
+    verify(): VerifyResult;
+    size(): number;
+    getLastHash(): string;
+    private sha256;
+    private generateId;
+}
+
+interface DegradationOptions {
+    gracePeriodMs?: number;
+    riskTier?: AgentRiskTier;
+    onTierChange?: (from: DegradationTier, to: DegradationTier) => void;
+}
+declare class DegradationManager {
+    private state;
+    private gracePeriodMs;
+    private riskTier;
+    private onTierChange?;
+    private graceTimer?;
+    constructor(options?: DegradationOptions);
+    onControlPlaneLatency(latencyMs: number): void;
+    onControlPlaneUnreachable(): void;
+    onControlPlaneReconnected(): void;
+    getCurrentTier(): DegradationTier;
+    shouldContinue(): boolean;
+    getIsolationDurationMs(): number;
+    private startGraceTimer;
+    private transition;
+}
+
+interface OpenAIFunctionCall {
+    name: string;
+    arguments: string;
+}
+interface OpenAIToolCall {
+    id: string;
+    type: 'function';
+    function: OpenAIFunctionCall;
+}
+interface InterceptResult$1 {
+    allowed: OpenAIToolCall[];
+    blocked: Array<{
+        toolCall: OpenAIToolCall;
+        result: EvaluationResult;
+    }>;
+}
+declare class MandateOpenAIHook {
+    private evaluator;
+    private buffer;
+    private degradation;
+    private config;
+    private sessionId;
+    constructor(config: MandateConfig, evaluator: JSPolicyEvaluator, buffer: AuditBuffer, degradation: DegradationManager);
+    interceptToolCalls(toolCalls: OpenAIToolCall[], stepInChain?: number): Promise<InterceptResult$1>;
+    private buildIntent;
+    private logToBuffer;
+    private generateSessionId;
+    private delay;
+}
+
+interface LangChainToolCall {
+    name: string;
+    args: Record<string, unknown>;
+    id?: string;
+}
+declare class MandateLangChainHook {
+    private evaluator;
+    private buffer;
+    private degradation;
+    private config;
+    private sessionId;
+    private stepCounter;
+    constructor(config: MandateConfig, evaluator: JSPolicyEvaluator, buffer: AuditBuffer, degradation: DegradationManager);
+    getBeforeToolCallHook(): (toolCall: LangChainToolCall) => Promise<LangChainToolCall | null>;
+    interceptToolCall(toolCall: LangChainToolCall): Promise<{
+        allowed: boolean;
+        result: EvaluationResult;
+    }>;
+    private buildIntent;
+    private logToBuffer;
+    private delay;
+}
+
+interface AnthropicToolUse {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+interface InterceptResult {
+    allowed: AnthropicToolUse[];
+    blocked: Array<{
+        block: AnthropicToolUse;
+        result: EvaluationResult;
+    }>;
+}
+declare class MandateAnthropicHook {
+    private evaluator;
+    private buffer;
+    private degradation;
+    private config;
+    private sessionId;
+    private stepCounter;
+    constructor(config: MandateConfig, evaluator: JSPolicyEvaluator, buffer: AuditBuffer, degradation: DegradationManager);
+    interceptToolUse(toolUseBlocks: AnthropicToolUse[]): Promise<InterceptResult>;
+    private buildIntent;
+    private logToBuffer;
+    private delay;
+}
+
+declare class MandateAgent {
+    private config;
+    private evaluator;
+    private buffer;
+    private degradation;
+    readonly openai: MandateOpenAIHook;
+    readonly langchain: MandateLangChainHook;
+    readonly anthropic: MandateAnthropicHook;
+    constructor(config: MandateConfig);
+    evaluate(intent: AgentIntent): EvaluationResult;
+    flushAuditBuffer(): Promise<AuditEvent[]>;
+    verifyAuditChain(): {
+        valid: boolean;
+        corruptedAt?: number;
+    };
+    getDegradationTier(): DegradationTier;
+    getBufferSize(): number;
+    updatePolicy(policy: MandatePolicy): void;
+    private sendToControlPlane;
+}
+declare function createMandateAgent(config: MandateConfig): MandateAgent;
+
+export { type AgentEnvironment, type AgentFramework, type AgentIntent, type AgentRiskTier, type AuditEvent, type DegradationTier, type EvaluationResult, MandateAgent, type MandateConfig, type MandatePolicy, type PolicyCondition, type PolicyDecision, type PolicyRule, type ResponseLevel, createMandateAgent };

package/dist/index.d.ts

@@ -0,0 +1,275 @@
+type AgentFramework = 'openai-assistants' | 'langchain' | 'autogen' | 'crewai' | 'anthropic' | 'custom';
+type AgentEnvironment = 'production' | 'staging' | 'development';
+type AgentRiskTier = 'LOW' | 'STANDARD' | 'HIGH' | 'CRITICAL';
+type DegradationTier = 'NOMINAL' | 'DEGRADED' | 'ISOLATED' | 'GRACE_STD' | 'GRACE_HIGH';
+type PolicyDecision = 'ALLOW' | 'DENY' | 'ESCALATE' | 'THROTTLE';
+type ResponseLevel = 1 | 2 | 3 | 4 | 5;
+interface IntentContext {
+    agentId: string;
+    sessionId: string;
+    environment: AgentEnvironment;
+    stepInChain: number;
+    framework: AgentFramework;
+    timestamp: number;
+}
+interface AgentIntent {
+    toolName: string;
+    args: Record<string, unknown>;
+    context: IntentContext;
+}
+interface EvaluationResult {
+    decision: PolicyDecision;
+    reason: string;
+    latencyMs: number;
+    ruleMatched?: string;
+    anomalyScore?: number;
+    responseLevel?: ResponseLevel;
+}
+type ConditionOperator = 'eq' | 'neq' | 'lt' | 'lte' | 'gt' | 'gte' | 'in' | 'nin' | 'startsWith' | 'endsWith' | 'contains';
+interface PolicyCondition {
+    field: string;
+    operator: ConditionOperator;
+    value: unknown;
+}
+interface PolicyRule {
+    tool: string;
+    conditions?: PolicyCondition[];
+}
+interface PolicyIdentity {
+    org: string;
+    env: AgentEnvironment;
+    framework?: string;
+}
+interface AnomalyThresholds {
+    alert: number;
+    throttle: number;
+}
+interface LocalAutonomyConfig {
+    gracePeriodMs: number;
+    postGrace: 'PAUSE' | 'STOP';
+}
+interface MandatePolicy {
+    agentId: string;
+    version: string;
+    policyHash: string;
+    identity: PolicyIdentity;
+    allow: PolicyRule[];
+    deny: PolicyRule[];
+    anomalyThresholds: AnomalyThresholds;
+    localAutonomy: LocalAutonomyConfig;
+}
+interface AuditEvent {
+    eventId: string;
+    prevHash: string;
+    eventHash: string;
+    timestamp: number;
+    source: 'REALTIME' | 'BUFFER_SYNC';
+    agentId: string;
+    orgId: string;
+    policyHash: string;
+    degradationTier: DegradationTier;
+    toolName: string;
+    toolArgs: Record<string, unknown>;
+    intentContext: IntentContext;
+    anomalyScore: number;
+    blastRadiusEst?: string;
+    policyDecision: PolicyDecision;
+    responseLevel: ResponseLevel;
+    evalLatencyMs: number;
+    tokensUsed?: number;
+    costUsd?: number;
+}
+interface MandateConfig {
+    agentId: string;
+    orgId: string;
+    apiKey?: string;
+    controlPlaneUrl?: string;
+    policy: MandatePolicy;
+    framework: AgentFramework;
+    environment: AgentEnvironment;
+    auditLevel: 'full' | 'minimal' | 'off';
+    riskTier?: AgentRiskTier;
+    onViolation?: (intent: AgentIntent, result: EvaluationResult) => void;
+    onAlert?: (intent: AgentIntent, score: number) => void;
+    onDegradation?: (from: DegradationTier, to: DegradationTier) => void;
+}
+
+declare class JSPolicyEvaluator {
+    private policy;
+    constructor(policy: MandatePolicy);
+    evaluate(intent: AgentIntent): EvaluationResult;
+    updatePolicy(policy: MandatePolicy): void;
+    getPolicyHash(): string;
+    private matchesRule;
+    private matchesToolPattern;
+    private evaluateCondition;
+    private resolveField;
+    private result;
+}
+
+interface BufferOptions {
+    maxSize?: number;
+    flushCallback?: (events: AuditEvent[]) => Promise<void>;
+}
+interface AppendInput {
+    timestamp: number;
+    source: 'REALTIME' | 'BUFFER_SYNC';
+    agentId: string;
+    orgId: string;
+    policyHash: string;
+    degradationTier: DegradationTier;
+    toolName: string;
+    toolArgs: Record<string, unknown>;
+    intentContext: AuditEvent['intentContext'];
+    anomalyScore: number;
+    policyDecision: PolicyDecision;
+    responseLevel: AuditEvent['responseLevel'];
+    evalLatencyMs: number;
+    blastRadiusEst?: string;
+    tokensUsed?: number;
+    costUsd?: number;
+}
+interface VerifyResult {
+    valid: boolean;
+    corruptedAt?: number;
+}
+declare class AuditBuffer {
+    private buffer;
+    private lastHash;
+    private maxSize;
+    private flushCallback?;
+    constructor(options?: BufferOptions);
+    append(input: AppendInput): AuditEvent;
+    flush(): Promise<AuditEvent[]>;
+    verify(): VerifyResult;
+    size(): number;
+    getLastHash(): string;
+    private sha256;
+    private generateId;
+}
+
+interface DegradationOptions {
+    gracePeriodMs?: number;
+    riskTier?: AgentRiskTier;
+    onTierChange?: (from: DegradationTier, to: DegradationTier) => void;
+}
+declare class DegradationManager {
+    private state;
+    private gracePeriodMs;
+    private riskTier;
+    private onTierChange?;
+    private graceTimer?;
+    constructor(options?: DegradationOptions);
+    onControlPlaneLatency(latencyMs: number): void;
+    onControlPlaneUnreachable(): void;
+    onControlPlaneReconnected(): void;
+    getCurrentTier(): DegradationTier;
+    shouldContinue(): boolean;
+    getIsolationDurationMs(): number;
+    private startGraceTimer;
+    private transition;
+}
+
+interface OpenAIFunctionCall {
+    name: string;
+    arguments: string;
+}
+interface OpenAIToolCall {
+    id: string;
+    type: 'function';
+    function: OpenAIFunctionCall;
+}
+interface InterceptResult$1 {
+    allowed: OpenAIToolCall[];
+    blocked: Array<{
+        toolCall: OpenAIToolCall;
+        result: EvaluationResult;
+    }>;
+}
+declare class MandateOpenAIHook {
+    private evaluator;
+    private buffer;
+    private degradation;
+    private config;
+    private sessionId;
+    constructor(config: MandateConfig, evaluator: JSPolicyEvaluator, buffer: AuditBuffer, degradation: DegradationManager);
+    interceptToolCalls(toolCalls: OpenAIToolCall[], stepInChain?: number): Promise<InterceptResult$1>;
+    private buildIntent;
+    private logToBuffer;
+    private generateSessionId;
+    private delay;
+}
+
+interface LangChainToolCall {
+    name: string;
+    args: Record<string, unknown>;
+    id?: string;
+}
+declare class MandateLangChainHook {
+    private evaluator;
+    private buffer;
+    private degradation;
+    private config;
+    private sessionId;
+    private stepCounter;
+    constructor(config: MandateConfig, evaluator: JSPolicyEvaluator, buffer: AuditBuffer, degradation: DegradationManager);
+    getBeforeToolCallHook(): (toolCall: LangChainToolCall) => Promise<LangChainToolCall | null>;
+    interceptToolCall(toolCall: LangChainToolCall): Promise<{
+        allowed: boolean;
+        result: EvaluationResult;
+    }>;
+    private buildIntent;
+    private logToBuffer;
+    private delay;
+}
+
+interface AnthropicToolUse {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+interface InterceptResult {
+    allowed: AnthropicToolUse[];
+    blocked: Array<{
+        block: AnthropicToolUse;
+        result: EvaluationResult;
+    }>;
+}
+declare class MandateAnthropicHook {
+    private evaluator;
+    private buffer;
+    private degradation;
+    private config;
+    private sessionId;
+    private stepCounter;
+    constructor(config: MandateConfig, evaluator: JSPolicyEvaluator, buffer: AuditBuffer, degradation: DegradationManager);
+    interceptToolUse(toolUseBlocks: AnthropicToolUse[]): Promise<InterceptResult>;
+    private buildIntent;
+    private logToBuffer;
+    private delay;
+}
+
+declare class MandateAgent {
+    private config;
+    private evaluator;
+    private buffer;
+    private degradation;
+    readonly openai: MandateOpenAIHook;
+    readonly langchain: MandateLangChainHook;
+    readonly anthropic: MandateAnthropicHook;
+    constructor(config: MandateConfig);
+    evaluate(intent: AgentIntent): EvaluationResult;
+    flushAuditBuffer(): Promise<AuditEvent[]>;
+    verifyAuditChain(): {
+        valid: boolean;
+        corruptedAt?: number;
+    };
+    getDegradationTier(): DegradationTier;
+    getBufferSize(): number;
+    updatePolicy(policy: MandatePolicy): void;
+    private sendToControlPlane;
+}
+declare function createMandateAgent(config: MandateConfig): MandateAgent;
+
+export { type AgentEnvironment, type AgentFramework, type AgentIntent, type AgentRiskTier, type AuditEvent, type DegradationTier, type EvaluationResult, MandateAgent, type MandateConfig, type MandatePolicy, type PolicyCondition, type PolicyDecision, type PolicyRule, type ResponseLevel, createMandateAgent };