guardrail-core 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,365 @@
+export interface FilesystemPermissions {
+    allowedPaths: string[];
+    deniedPaths: string[];
+    operations: ('read' | 'write' | 'delete' | 'execute')[];
+    maxFileSize: number;
+    [key: string]: unknown;
+}
+export interface NetworkPermissions {
+    allowedDomains: string[];
+    deniedDomains: string[];
+    maxRequests: number;
+    allowedProtocols: ('http' | 'https' | 'ws' | 'wss')[];
+    [key: string]: unknown;
+}
+export interface ShellPermissions {
+    allowedCommands: string[];
+    deniedCommands: string[];
+    requireConfirmation: string[];
+    allowEnvironmentVariables: boolean;
+    [key: string]: unknown;
+}
+export interface ResourceLimits {
+    maxMemoryMB: number;
+    maxCpuPercent: number;
+    maxTokens: number;
+    maxExecutionTimeMs: number;
+    [key: string]: unknown;
+}
+export interface AgentPermissionScope {
+    filesystem: FilesystemPermissions;
+    network: NetworkPermissions;
+    shell: ShellPermissions;
+    resources: ResourceLimits;
+}
+export interface FilesystemDetails {
+    operation: 'read' | 'write' | 'delete' | 'execute';
+    path: string;
+    content?: string;
+    size?: number;
+}
+export interface NetworkDetails {
+    method: string;
+    url: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+}
+export interface ShellDetails {
+    command: string;
+    args: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+}
+export type ActionDetails = FilesystemDetails | NetworkDetails | ShellDetails;
+export interface ActionAttempt {
+    agentId: string;
+    taskId: string;
+    actionType: string;
+    category: 'code' | 'file' | 'network' | 'shell';
+    details: ActionDetails;
+    reasoning?: string;
+}
+export interface ActionDecision {
+    allowed: boolean;
+    reason: string;
+    alternativeSuggestion?: string;
+    riskLevel: 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+    requiresApproval: boolean;
+}
+export interface Evaluation {
+    passed: boolean;
+    reason: string;
+    violatedRules: string[];
+    suggestions: string[];
+}
+export interface SimpleValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export interface FileSnapshot {
+    path: string;
+    originalContent: string;
+    originalHash: string;
+    [key: string]: unknown;
+}
+export interface Checkpoint {
+    id: string;
+    agentId: string;
+    taskId: string;
+    modifiedFiles: FileSnapshot[];
+    resourcesUsed: ResourceUsage;
+    createdAt: Date;
+}
+export interface ResourceUsage {
+    memoryMB: number;
+    cpuPercent: number;
+    tokensUsed: number;
+    executionTimeMs: number;
+    apiCalls: number;
+    [key: string]: unknown;
+}
+export interface LimitCheck {
+    withinLimits: boolean;
+    violations: string[];
+    current: ResourceUsage;
+    limits: ResourceLimits;
+}
+export interface RollbackResult {
+    success: boolean;
+    filesRestored: number;
+    errors: string[];
+}
+export interface InjectionScanRequest {
+    content: string;
+    contentType: 'user_input' | 'code' | 'data_source';
+    context?: {
+        source: string;
+        metadata?: Record<string, unknown>;
+    };
+}
+export interface Detection {
+    type: string;
+    pattern: string;
+    location: {
+        start: number;
+        end: number;
+        line?: number;
+    };
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    confidence: number;
+    description: string;
+}
+export interface InjectionScanResult {
+    verdict: 'CLEAN' | 'SUSPICIOUS' | 'MALICIOUS' | 'BLOCKED';
+    confidence: number;
+    detections: Detection[];
+    sanitizedContent?: string;
+    recommendation: {
+        action: 'allow' | 'sanitize' | 'block' | 'review';
+        reason: string;
+    };
+    scanDuration: number;
+}
+export interface ProcessedInput {
+    original: string;
+    processed: string;
+    wasSanitized: boolean;
+    detections: Detection[];
+}
+export interface CodeOutput {
+    code: string;
+    language: string;
+    outputType: 'code' | 'config' | 'documentation';
+    metadata?: Record<string, unknown>;
+}
+export interface Context {
+    projectPath?: string;
+    existingFiles?: string[];
+    dependencies?: Record<string, string>;
+    framework?: string;
+}
+export interface StageResult {
+    stageName: string;
+    passed: boolean;
+    score: number;
+    issues: ValidationIssue[];
+    warnings: string[];
+    duration: number;
+}
+export interface ValidationIssue {
+    type: string;
+    severity: 'error' | 'warning' | 'info';
+    message: string;
+    location?: {
+        line: number;
+        column: number;
+    };
+    suggestion?: string;
+}
+export interface ValidationRequest {
+    output: CodeOutput;
+    context?: Context;
+    request?: string;
+}
+export interface DetailedValidationResult {
+    verdict: 'ACCEPT' | 'MODIFY' | 'REJECT' | 'HUMAN_REVIEW';
+    confidence: number;
+    stages: StageResult[];
+    overallScore: number;
+    modifiedOutput?: string;
+    recommendation: string;
+}
+export interface PackageCheck {
+    exists: boolean;
+    name: string;
+    version?: string;
+    registry: string;
+    alternativeSuggestions?: string[];
+}
+export interface APICheck {
+    exists: boolean;
+    package: string;
+    method: string;
+    signature?: string;
+    documentation?: string;
+    alternativeSuggestions?: string[];
+}
+export interface CodeIntent {
+    primary: string;
+    secondary: string[];
+    entities: string[];
+    operations: string[];
+}
+export interface RequestIntent {
+    goal: string;
+    constraints: string[];
+    expectedEntities: string[];
+    expectedOperations: string[];
+}
+export interface IntentComparison {
+    alignmentScore: number;
+    matches: string[];
+    mismatches: string[];
+    recommendation: string;
+}
+export interface AuditEvent {
+    agentId: string;
+    taskId: string;
+    correlationId: string;
+    sequenceNumber: number;
+    actionType: string;
+    category: string;
+    input?: unknown;
+    output?: unknown;
+    target?: {
+        type: string;
+        path?: string;
+        url?: string;
+    };
+    reasoning: {
+        summary: string;
+        considerations: string[];
+        confidence: number;
+    };
+    status: 'SUCCESS' | 'FAILURE' | 'BLOCKED' | 'PENDING_APPROVAL' | 'ROLLED_BACK';
+    error?: {
+        message: string;
+        code: string;
+        stack?: string;
+    };
+    impact?: {
+        filesModified?: string[];
+        linesAdded?: number;
+        linesDeleted?: number;
+    };
+    diff?: {
+        before: string;
+        after: string;
+        unified: string;
+    };
+    riskLevel: 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+    riskFactors: string[];
+    sensitiveData: boolean;
+    piiInvolved: boolean;
+    duration?: number;
+    timestamp: Date;
+    previousHash?: string;
+}
+export interface Diff {
+    before: string;
+    after: string;
+    unified: string;
+}
+export interface CodeGenParams {
+    taskId: string;
+    agentId: string;
+    prompt: string;
+    generatedCode: string;
+    language: string;
+    reasoning: string;
+}
+export interface CodeModParams {
+    taskId: string;
+    agentId: string;
+    filePath: string;
+    originalCode: string;
+    modifiedCode: string;
+    reasoning: string;
+}
+export interface ShellParams {
+    taskId: string;
+    agentId: string;
+    command: string;
+    args: string[];
+    output: string;
+    exitCode: number;
+}
+export interface AuditQuery {
+    agentId?: string;
+    taskId?: string;
+    correlationId?: string;
+    startDate?: Date;
+    endDate?: Date;
+    actionType?: string;
+    status?: string;
+    riskLevel?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface QueryResult {
+    events: AuditEvent[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+export interface Timeline {
+    taskId: string;
+    events: AuditEvent[];
+    summary: {
+        totalActions: number;
+        successfulActions: number;
+        failedActions: number;
+        blockedActions: number;
+        duration: number;
+    };
+}
+export interface Changes {
+    filePath: string;
+    timestamp: Date;
+    diff: Diff;
+    agent: string;
+    reasoning: string;
+}
+export interface Attribution {
+    projectId: string;
+    period: DateRange;
+    aiGenerated: {
+        lines: number;
+        files: number;
+        percentage: number;
+    };
+    humanWritten: {
+        lines: number;
+        files: number;
+        percentage: number;
+    };
+    breakdown: {
+        agent: string;
+        lines: number;
+        files: number;
+    }[];
+}
+export interface DateRange {
+    start: Date;
+    end: Date;
+}
+export type ReportType = 'audit' | 'compliance' | 'security' | 'attribution';
+export interface Report {
+    type: ReportType;
+    period: DateRange;
+    summary: Record<string, unknown>;
+    details: unknown[];
+    generatedAt: Date;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,5 @@
+"use strict";
+// ==========================================
+// PERMISSION TYPES
+// ==========================================
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Generate a unique correlation ID for tracking related actions
+ */
+export declare function generateCorrelationId(): string;
+/**
+ * Generate a task ID
+ */
+export declare function generateTaskId(): string;
+/**
+ * Calculate SHA-256 hash of content
+ */
+export declare function calculateHash(content: string): string;
+/**
+ * Calculate content entropy (randomness measure for secret detection)
+ */
+export declare function calculateEntropy(str: string): number;
+/**
+ * Mask sensitive value for logging
+ */
+export declare function maskSensitiveValue(value: string): string;
+/**
+ * Check if a path is within allowed paths
+ */
+export declare function isPathAllowed(path: string, allowedPaths: string[], deniedPaths: string[]): boolean;
+/**
+ * Check if a domain is allowed
+ */
+export declare function isDomainAllowed(url: string, allowedDomains: string[], deniedDomains: string[]): boolean;
+/**
+ * Sanitize error message for safe logging
+ */
+export declare function sanitizeError(error: unknown): {
+    message: string;
+    code?: string;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAqBpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EAAE,EACtB,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAuBT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,MAAM,EAAE,EACxB,aAAa,EAAE,MAAM,EAAE,GACtB,OAAO,CA4BT;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAQhF"}

package/dist/utils.js

@@ -0,0 +1,127 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCorrelationId = generateCorrelationId;
+exports.generateTaskId = generateTaskId;
+exports.calculateHash = calculateHash;
+exports.calculateEntropy = calculateEntropy;
+exports.maskSensitiveValue = maskSensitiveValue;
+exports.isPathAllowed = isPathAllowed;
+exports.isDomainAllowed = isDomainAllowed;
+exports.sanitizeError = sanitizeError;
+const crypto_1 = __importDefault(require("crypto"));
+/**
+ * Generate a unique correlation ID for tracking related actions
+ */
+function generateCorrelationId() {
+    return `corr_${Date.now()}_${crypto_1.default.randomBytes(8).toString('hex')}`;
+}
+/**
+ * Generate a task ID
+ */
+function generateTaskId() {
+    return `task_${Date.now()}_${crypto_1.default.randomBytes(8).toString('hex')}`;
+}
+/**
+ * Calculate SHA-256 hash of content
+ */
+function calculateHash(content) {
+    return crypto_1.default.createHash('sha256').update(content).digest('hex');
+}
+/**
+ * Calculate content entropy (randomness measure for secret detection)
+ */
+function calculateEntropy(str) {
+    const len = str.length;
+    const frequencies = {};
+    for (let i = 0; i < len; i++) {
+        const char = str[i];
+        if (char) {
+            frequencies[char] = (frequencies[char] || 0) + 1;
+        }
+    }
+    let entropy = 0;
+    for (const char in frequencies) {
+        const frequency = frequencies[char];
+        if (frequency !== undefined) {
+            const p = frequency / len;
+            entropy -= p * Math.log2(p);
+        }
+    }
+    return entropy;
+}
+/**
+ * Mask sensitive value for logging
+ */
+function maskSensitiveValue(value) {
+    if (value.length <= 8) {
+        return '***';
+    }
+    return `${value.substring(0, 4)}...${value.substring(value.length - 4)}`;
+}
+/**
+ * Check if a path is within allowed paths
+ */
+function isPathAllowed(path, allowedPaths, deniedPaths) {
+    const normalizedPath = path.replace(/\\/g, '/');
+    // Check denied paths first (more restrictive)
+    for (const deniedPath of deniedPaths) {
+        if (normalizedPath.startsWith(deniedPath.replace(/\\/g, '/'))) {
+            return false;
+        }
+    }
+    // If no allowed paths specified, allow all (except denied)
+    if (allowedPaths.length === 0) {
+        return true;
+    }
+    // Check allowed paths
+    for (const allowedPath of allowedPaths) {
+        if (normalizedPath.startsWith(allowedPath.replace(/\\/g, '/'))) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Check if a domain is allowed
+ */
+function isDomainAllowed(url, allowedDomains, deniedDomains) {
+    try {
+        const urlObj = new URL(url);
+        const hostname = urlObj.hostname;
+        // Check denied domains first
+        for (const deniedDomain of deniedDomains) {
+            if (hostname === deniedDomain || hostname.endsWith(`.${deniedDomain}`)) {
+                return false;
+            }
+        }
+        // If no allowed domains specified, allow all (except denied)
+        if (allowedDomains.length === 0) {
+            return true;
+        }
+        // Check allowed domains
+        for (const allowedDomain of allowedDomains) {
+            if (hostname === allowedDomain || hostname.endsWith(`.${allowedDomain}`)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    catch (error) {
+        return false;
+    }
+}
+/**
+ * Sanitize error message for safe logging
+ */
+function sanitizeError(error) {
+    if (error instanceof Error) {
+        return {
+            message: error.message.replace(/\/[^\s:]+/g, '[path]'),
+            code: error.code,
+        };
+    }
+    return { message: 'Unknown error occurred' };
+}

package/dist/verified-autofix/__tests__/format-validator.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Format Validator Tests
+ *
+ * Tests for the verified autofix format validation:
+ * - JSON shape validation
+ * - Unified diff parsing
+ * - Path safety checks
+ * - Stub detection
+ */
+export {};
+//# sourceMappingURL=format-validator.test.d.ts.map

package/dist/verified-autofix/__tests__/format-validator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-validator.test.d.ts","sourceRoot":"","sources":["../../../src/verified-autofix/__tests__/format-validator.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}