family-ai-agent 1.0.0

package/dist/safety/audit-logger.js

@@ -0,0 +1,215 @@
+import { createHash } from 'crypto';
+import { query } from '../database/client.js';
+import { config } from '../config/index.js';
+import { createLogger } from '../utils/logger.js';
+const logger = createLogger('AuditLogger');
+export class AuditLogger {
+    enabled;
+    constructor() {
+        this.enabled = config.ENABLE_AUDIT_LOGGING;
+    }
+    // Hash sensitive content for logging
+    hashContent(content) {
+        return createHash('sha256').update(content).digest('hex').slice(0, 16);
+    }
+    // Log an action
+    async log(actionType, details, options = {}) {
+        if (!this.enabled) {
+            return null;
+        }
+        try {
+            const result = await query(`INSERT INTO audit_logs
+         (user_id, agent_id, action_type, action_details, input_hash, output_hash, status, error_message, execution_time_ms)
+         VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9)
+         RETURNING id`, [
+                options.userId ?? null,
+                options.agentId ?? null,
+                actionType,
+                JSON.stringify(details),
+                options.input ? this.hashContent(options.input) : null,
+                options.output ? this.hashContent(options.output) : null,
+                options.status ?? 'success',
+                options.error ?? null,
+                options.executionTimeMs ?? null,
+            ]);
+            const logId = result.rows[0]?.id;
+            logger.debug('Audit log created', { logId, actionType });
+            return logId ?? null;
+        }
+        catch (error) {
+            logger.error('Failed to create audit log', { error, actionType });
+            // Don't throw - audit logging should not break the main flow
+            return null;
+        }
+    }
+    // Log user input
+    async logUserInput(input, options = {}) {
+        return this.log('user_input', {
+            inputLength: input.length,
+            ...options.metadata,
+        }, {
+            userId: options.userId,
+            input,
+            status: 'success',
+        });
+    }
+    // Log agent execution
+    async logAgentExecution(agentId, input, output, executionTimeMs, options = {}) {
+        return this.log('agent_execution', {
+            inputLength: input.length,
+            outputLength: output.length,
+            executionTimeMs,
+        }, {
+            userId: options.userId,
+            agentId,
+            input,
+            output,
+            status: options.success !== false ? 'success' : 'failure',
+            error: options.error,
+            executionTimeMs,
+        });
+    }
+    // Log tool call
+    async logToolCall(toolName, input, output, options = {}) {
+        return this.log('tool_call', {
+            toolName,
+            inputType: typeof input,
+            outputType: typeof output,
+        }, {
+            agentId: options.agentId,
+            userId: options.userId,
+            input: JSON.stringify(input),
+            output: JSON.stringify(output),
+            status: options.success !== false ? 'success' : 'failure',
+            error: options.error,
+            executionTimeMs: options.executionTimeMs,
+        });
+    }
+    // Log safety block
+    async logSafetyBlock(reason, details, options = {}) {
+        return this.log('safety_block', {
+            reason,
+            ...details,
+        }, {
+            userId: options.userId,
+            input: options.input,
+            status: 'blocked',
+            error: reason,
+        });
+    }
+    // Query audit logs
+    async query(filters = {}, options = {}) {
+        const { limit = 50, offset = 0 } = options;
+        let sql = `
+      SELECT id, user_id, agent_id, action_type, action_details,
+             input_hash, output_hash, status, error_message,
+             execution_time_ms, created_at
+      FROM audit_logs
+      WHERE 1=1
+    `;
+        const params = [];
+        let paramIndex = 1;
+        if (filters.userId) {
+            sql += ` AND user_id = $${paramIndex}`;
+            params.push(filters.userId);
+            paramIndex++;
+        }
+        if (filters.agentId) {
+            sql += ` AND agent_id = $${paramIndex}`;
+            params.push(filters.agentId);
+            paramIndex++;
+        }
+        if (filters.actionType) {
+            sql += ` AND action_type = $${paramIndex}`;
+            params.push(filters.actionType);
+            paramIndex++;
+        }
+        if (filters.status) {
+            sql += ` AND status = $${paramIndex}`;
+            params.push(filters.status);
+            paramIndex++;
+        }
+        if (filters.startDate) {
+            sql += ` AND created_at >= $${paramIndex}`;
+            params.push(filters.startDate);
+            paramIndex++;
+        }
+        if (filters.endDate) {
+            sql += ` AND created_at <= $${paramIndex}`;
+            params.push(filters.endDate);
+            paramIndex++;
+        }
+        sql += ` ORDER BY created_at DESC LIMIT $${paramIndex} OFFSET $${paramIndex + 1}`;
+        params.push(limit, offset);
+        try {
+            const result = await query(sql, params);
+            return result.rows.map((row) => ({
+                id: row.id,
+                userId: row.user_id ?? undefined,
+                agentId: row.agent_id ?? undefined,
+                actionType: row.action_type,
+                actionDetails: row.action_details,
+                inputHash: row.input_hash ?? undefined,
+                outputHash: row.output_hash ?? undefined,
+                status: row.status,
+                errorMessage: row.error_message ?? undefined,
+                executionTimeMs: row.execution_time_ms ?? undefined,
+                createdAt: row.created_at,
+            }));
+        }
+        catch (error) {
+            logger.error('Failed to query audit logs', { error });
+            return [];
+        }
+    }
+    // Get statistics
+    async getStats(userId, days = 7) {
+        const startDate = new Date();
+        startDate.setDate(startDate.getDate() - days);
+        let sql = `
+      SELECT
+        COUNT(*) as total,
+        COUNT(*) FILTER (WHERE status = 'success') as success_count,
+        COUNT(*) FILTER (WHERE status = 'blocked') as blocked_count,
+        AVG(execution_time_ms) FILTER (WHERE execution_time_ms IS NOT NULL) as avg_time
+      FROM audit_logs
+      WHERE created_at >= $1
+    `;
+        const params = [startDate];
+        if (userId) {
+            sql += ' AND user_id = $2';
+            params.push(userId);
+        }
+        try {
+            const result = await query(sql, params);
+            const row = result.rows[0];
+            const total = parseInt(row?.total ?? '0', 10);
+            const successCount = parseInt(row?.success_count ?? '0', 10);
+            return {
+                totalRequests: total,
+                successRate: total > 0 ? (successCount / total) * 100 : 100,
+                avgExecutionTime: parseFloat(row?.avg_time ?? '0'),
+                blockedCount: parseInt(row?.blocked_count ?? '0', 10),
+            };
+        }
+        catch (error) {
+            logger.error('Failed to get audit stats', { error });
+            return {
+                totalRequests: 0,
+                successRate: 100,
+                avgExecutionTime: 0,
+                blockedCount: 0,
+            };
+        }
+    }
+}
+// Singleton instance
+let auditInstance = null;
+export function getAuditLogger() {
+    if (!auditInstance) {
+        auditInstance = new AuditLogger();
+    }
+    return auditInstance;
+}
+export default AuditLogger;
+//# sourceMappingURL=audit-logger.js.map

package/dist/safety/audit-logger.js.map

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

package/dist/safety/guardrails/input-guardrail.d.ts

@@ -0,0 +1,21 @@
+export interface InputValidationResult {
+    valid: boolean;
+    sanitizedInput: string;
+    warnings: string[];
+    blockedReason?: string;
+}
+export declare class InputGuardrail {
+    private enabled;
+    private enablePiiDetection;
+    constructor();
+    validate(input: string): Promise<InputValidationResult>;
+    private detectPii;
+    private sanitize;
+    isObviouslyHarmful(input: string): boolean;
+    estimateTokens(input: string): number;
+    isWithinTokenLimit(input: string, maxTokens?: number): boolean;
+}
+export declare function getInputGuardrail(): InputGuardrail;
+export declare function validateInput(input: string): Promise<InputValidationResult>;
+export default InputGuardrail;
+//# sourceMappingURL=input-guardrail.d.ts.map

package/dist/safety/guardrails/input-guardrail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-guardrail.d.ts","sourceRoot":"","sources":["../../../src/safety/guardrails/input-guardrail.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAkCD,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,kBAAkB,CAAU;;IAQ9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAwD7D,OAAO,CAAC,SAAS;IAgBjB,OAAO,CAAC,QAAQ;IAmBhB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAgB1C,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAMrC,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO;CAI/D;AAKD,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD;AAGD,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAGjF;AAED,eAAe,cAAc,CAAC"}

package/dist/safety/guardrails/input-guardrail.js

@@ -0,0 +1,145 @@
+import { config } from '../../config/index.js';
+import { createLogger, logSafetyEvent } from '../../utils/logger.js';
+import { SafetyError, ValidationError } from '../../utils/errors.js';
+const logger = createLogger('InputGuardrail');
+// Patterns that indicate potentially harmful content
+const HARMFUL_PATTERNS = [
+    // Injection attempts
+    /ignore\s+(previous|all)\s+instructions/i,
+    /disregard\s+(your|the)\s+(rules|guidelines)/i,
+    /you\s+are\s+now\s+(a|an)\s+different/i,
+    /pretend\s+you\s+(are|have)\s+no\s+restrictions/i,
+    /jailbreak/i,
+    /bypass\s+(safety|security|filters)/i,
+    // Dangerous requests
+    /how\s+to\s+(make|build|create)\s+(a\s+)?(bomb|weapon|explosive)/i,
+    /how\s+to\s+(hack|break\s+into)/i,
+    /how\s+to\s+harm\s+(myself|others|someone)/i,
+    // Personal information extraction
+    /give\s+me\s+(your|the)\s+(api|secret)\s+key/i,
+    /what\s+is\s+(your|the)\s+password/i,
+];
+// Patterns for PII detection
+const PII_PATTERNS = [
+    { name: 'SSN', pattern: /\b\d{3}-\d{2}-\d{4}\b/ },
+    { name: 'Credit Card', pattern: /\b\d{4}[\s-]?\d{4}[\s-]?\d{4}[\s-]?\d{4}\b/ },
+    { name: 'Email', pattern: /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b/ },
+    { name: 'Phone', pattern: /\b\d{3}[-.]?\d{3}[-.]?\d{4}\b/ },
+];
+// Maximum input lengths
+const MAX_INPUT_LENGTH = 50000; // 50k characters
+const MAX_TOKENS_ESTIMATE = 12500; // Roughly 50k chars / 4
+export class InputGuardrail {
+    enabled;
+    enablePiiDetection;
+    constructor() {
+        this.enabled = config.ENABLE_CONTENT_FILTER;
+        this.enablePiiDetection = config.ENABLE_PII_DETECTION;
+    }
+    // Main validation method
+    async validate(input) {
+        const warnings = [];
+        let sanitizedInput = input;
+        // Check if guardrails are enabled
+        if (!this.enabled) {
+            return { valid: true, sanitizedInput, warnings };
+        }
+        // Length validation
+        if (input.length > MAX_INPUT_LENGTH) {
+            throw new ValidationError(`Input exceeds maximum length of ${MAX_INPUT_LENGTH} characters`);
+        }
+        // Empty input check
+        if (!input.trim()) {
+            throw new ValidationError('Input cannot be empty');
+        }
+        // Check for harmful patterns
+        for (const pattern of HARMFUL_PATTERNS) {
+            if (pattern.test(input)) {
+                logSafetyEvent('harmful_content_detected', true, 'Input matches harmful pattern');
+                throw new SafetyError('Your request contains content that violates safety guidelines');
+            }
+        }
+        // PII detection
+        if (this.enablePiiDetection) {
+            const piiResult = this.detectPii(input);
+            if (piiResult.detected) {
+                warnings.push(`Potential PII detected: ${piiResult.types.join(', ')}. ` +
+                    'Please be careful with personal information.');
+                logSafetyEvent('pii_detected', false, 'PII detected in input', {
+                    types: piiResult.types,
+                });
+            }
+        }
+        // Sanitize input
+        sanitizedInput = this.sanitize(input);
+        return {
+            valid: true,
+            sanitizedInput,
+            warnings,
+        };
+    }
+    // Detect PII in input
+    detectPii(input) {
+        const detectedTypes = [];
+        for (const { name, pattern } of PII_PATTERNS) {
+            if (pattern.test(input)) {
+                detectedTypes.push(name);
+            }
+        }
+        return {
+            detected: detectedTypes.length > 0,
+            types: detectedTypes,
+        };
+    }
+    // Sanitize input
+    sanitize(input) {
+        let sanitized = input;
+        // Remove null bytes
+        sanitized = sanitized.replace(/\0/g, '');
+        // Normalize unicode
+        sanitized = sanitized.normalize('NFC');
+        // Remove control characters (except newlines and tabs)
+        sanitized = sanitized.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g, '');
+        // Trim excessive whitespace
+        sanitized = sanitized.replace(/\s{10,}/g, '          ');
+        return sanitized.trim();
+    }
+    // Quick check for obviously harmful content
+    isObviouslyHarmful(input) {
+        const lowerInput = input.toLowerCase();
+        const obviousPatterns = [
+            'ignore previous instructions',
+            'ignore all instructions',
+            'you are now',
+            'pretend you have no',
+            'jailbreak',
+            'bypass safety',
+        ];
+        return obviousPatterns.some((pattern) => lowerInput.includes(pattern));
+    }
+    // Estimate token count
+    estimateTokens(input) {
+        // Rough estimate: 1 token ≈ 4 characters
+        return Math.ceil(input.length / 4);
+    }
+    // Check if input is within token limits
+    isWithinTokenLimit(input, maxTokens) {
+        const limit = maxTokens ?? config.MAX_TOKENS_PER_REQUEST;
+        return this.estimateTokens(input) <= limit;
+    }
+}
+// Singleton instance
+let guardrailInstance = null;
+export function getInputGuardrail() {
+    if (!guardrailInstance) {
+        guardrailInstance = new InputGuardrail();
+    }
+    return guardrailInstance;
+}
+// Convenience function
+export async function validateInput(input) {
+    const guardrail = getInputGuardrail();
+    return guardrail.validate(input);
+}
+export default InputGuardrail;
+//# sourceMappingURL=input-guardrail.js.map

package/dist/safety/guardrails/input-guardrail.js.map

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

package/dist/safety/guardrails/output-guardrail.d.ts

@@ -0,0 +1,18 @@
+export interface OutputValidationResult {
+    valid: boolean;
+    sanitizedOutput: string;
+    warnings: string[];
+    redactions: string[];
+}
+export declare class OutputGuardrail {
+    private enabled;
+    constructor();
+    validate(output: string): OutputValidationResult;
+    containsDangerousCode(output: string): boolean;
+    truncate(output: string, maxLength?: number): string;
+    formatCodeSafely(code: string, language?: string): string;
+}
+export declare function getOutputGuardrail(): OutputGuardrail;
+export declare function validateOutput(output: string): OutputValidationResult;
+export default OutputGuardrail;
+//# sourceMappingURL=output-guardrail.d.ts.map

package/dist/safety/guardrails/output-guardrail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-guardrail.d.ts","sourceRoot":"","sources":["../../../src/safety/guardrails/output-guardrail.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AA4BD,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAU;;IAOzB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB;IAmDhD,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAsB9C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,MAAc,GAAG,MAAM;IAiB3D,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM;CAK9D;AAKD,wBAAgB,kBAAkB,IAAI,eAAe,CAKpD;AAGD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,CAGrE;AAED,eAAe,eAAe,CAAC"}

package/dist/safety/guardrails/output-guardrail.js

@@ -0,0 +1,125 @@
+import { config } from '../../config/index.js';
+import { createLogger, logSafetyEvent } from '../../utils/logger.js';
+const logger = createLogger('OutputGuardrail');
+// Patterns for sensitive information in outputs
+const SENSITIVE_PATTERNS = [
+    // API keys and tokens
+    { name: 'API Key', pattern: /\b(sk|pk|api[_-]?key)[_-]?[a-zA-Z0-9]{20,}\b/gi },
+    { name: 'Bearer Token', pattern: /bearer\s+[a-zA-Z0-9_-]{20,}/gi },
+    { name: 'JWT', pattern: /eyJ[a-zA-Z0-9_-]*\.eyJ[a-zA-Z0-9_-]*\.[a-zA-Z0-9_-]*/g },
+    // Credentials
+    { name: 'Password Field', pattern: /password['":\s]*['"]?[^'"\s,]{8,}['"]?/gi },
+    { name: 'Secret', pattern: /secret['":\s]*['"]?[a-zA-Z0-9_-]{16,}['"]?/gi },
+    // Personal Information
+    { name: 'SSN', pattern: /\b\d{3}-\d{2}-\d{4}\b/g },
+    { name: 'Credit Card', pattern: /\b\d{4}[\s-]?\d{4}[\s-]?\d{4}[\s-]?\d{4}\b/g },
+    // Private keys
+    { name: 'Private Key', pattern: /-----BEGIN\s+(?:RSA\s+)?PRIVATE\s+KEY-----[\s\S]*?-----END\s+(?:RSA\s+)?PRIVATE\s+KEY-----/g },
+];
+// Harmful content patterns in output
+const HARMFUL_OUTPUT_PATTERNS = [
+    /how\s+to\s+(make|build|create)\s+(a\s+)?(bomb|weapon|explosive)/i,
+    /instructions\s+for\s+(making|building)\s+(a\s+)?weapon/i,
+    /step[\s-]by[\s-]step\s+guide\s+to\s+harm/i,
+];
+export class OutputGuardrail {
+    enabled;
+    constructor() {
+        this.enabled = config.ENABLE_CONTENT_FILTER;
+    }
+    // Main validation method
+    validate(output) {
+        const warnings = [];
+        const redactions = [];
+        let sanitizedOutput = output;
+        if (!this.enabled) {
+            return { valid: true, sanitizedOutput, warnings, redactions };
+        }
+        // Check for harmful content
+        for (const pattern of HARMFUL_OUTPUT_PATTERNS) {
+            if (pattern.test(output)) {
+                logSafetyEvent('harmful_output_blocked', true, 'Output contains harmful content');
+                return {
+                    valid: false,
+                    sanitizedOutput: '[Content blocked due to safety guidelines]',
+                    warnings: ['Output contained potentially harmful content'],
+                    redactions: [],
+                };
+            }
+        }
+        // Redact sensitive information
+        for (const { name, pattern } of SENSITIVE_PATTERNS) {
+            const matches = output.match(pattern);
+            if (matches) {
+                for (const match of matches) {
+                    sanitizedOutput = sanitizedOutput.replace(match, `[REDACTED: ${name}]`);
+                    redactions.push(name);
+                }
+            }
+        }
+        if (redactions.length > 0) {
+            logSafetyEvent('sensitive_data_redacted', false, 'Sensitive data redacted from output', {
+                redactionTypes: [...new Set(redactions)],
+            });
+            warnings.push(`Sensitive information was redacted from the output: ${[...new Set(redactions)].join(', ')}`);
+        }
+        return {
+            valid: true,
+            sanitizedOutput,
+            warnings,
+            redactions: [...new Set(redactions)],
+        };
+    }
+    // Check if output contains code that might be dangerous
+    containsDangerousCode(output) {
+        const dangerousPatterns = [
+            // Shell commands that could be harmful
+            /rm\s+-rf\s+\//,
+            /mkfs\./,
+            /dd\s+if=.*of=\/dev/,
+            /:(){ :|:& };:/, // Fork bomb
+            // Dangerous SQL
+            /drop\s+table/i,
+            /delete\s+from\s+.*where\s+1\s*=\s*1/i,
+            /truncate\s+table/i,
+            // Dangerous code patterns
+            /eval\s*\(\s*['"`].*['"`]\s*\)/,
+            /exec\s*\(\s*['"`].*['"`]\s*\)/,
+        ];
+        return dangerousPatterns.some((pattern) => pattern.test(output));
+    }
+    // Truncate output if too long
+    truncate(output, maxLength = 10000) {
+        if (output.length <= maxLength) {
+            return output;
+        }
+        const truncated = output.slice(0, maxLength);
+        const lastNewline = truncated.lastIndexOf('\n');
+        // Try to truncate at a natural break point
+        if (lastNewline > maxLength * 0.8) {
+            return truncated.slice(0, lastNewline) + '\n\n[Output truncated...]';
+        }
+        return truncated + '\n\n[Output truncated...]';
+    }
+    // Format code blocks safely
+    formatCodeSafely(code, language = '') {
+        // Escape any existing code fence markers
+        const escapedCode = code.replace(/```/g, '\\`\\`\\`');
+        return `\`\`\`${language}\n${escapedCode}\n\`\`\``;
+    }
+}
+// Singleton instance
+let guardrailInstance = null;
+export function getOutputGuardrail() {
+    if (!guardrailInstance) {
+        guardrailInstance = new OutputGuardrail();
+    }
+    return guardrailInstance;
+}
+// Convenience function
+export function validateOutput(output) {
+    const guardrail = getOutputGuardrail();
+    return guardrail.validate(output);
+}
+export default OutputGuardrail;
+//# sourceMappingURL=output-guardrail.js.map

package/dist/safety/guardrails/output-guardrail.js.map

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

package/dist/safety/index.d.ts

@@ -0,0 +1,4 @@
+export { InputGuardrail, getInputGuardrail, validateInput, type InputValidationResult, } from './guardrails/input-guardrail.js';
+export { OutputGuardrail, getOutputGuardrail, validateOutput, type OutputValidationResult, } from './guardrails/output-guardrail.js';
+export { AuditLogger, getAuditLogger, type AuditLogEntry, type AuditActionType, } from './audit-logger.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/safety/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/safety/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,KAAK,qBAAqB,GAC3B,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,KAAK,sBAAsB,GAC5B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,WAAW,EACX,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC"}

package/dist/safety/index.js

@@ -0,0 +1,5 @@
+// Safety module exports
+export { InputGuardrail, getInputGuardrail, validateInput, } from './guardrails/input-guardrail.js';
+export { OutputGuardrail, getOutputGuardrail, validateOutput, } from './guardrails/output-guardrail.js';
+export { AuditLogger, getAuditLogger, } from './audit-logger.js';
+//# sourceMappingURL=index.js.map

package/dist/safety/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/safety/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,aAAa,GAEd,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,cAAc,GAEf,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,WAAW,EACX,cAAc,GAGf,MAAM,mBAAmB,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,36 @@
+export declare class FamilyAIError extends Error {
+    readonly code: string;
+    readonly statusCode: number;
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, code: string, statusCode?: number, details?: Record<string, unknown>);
+}
+export declare class ConfigurationError extends FamilyAIError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class LLMError extends FamilyAIError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class MemoryError extends FamilyAIError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class ToolExecutionError extends FamilyAIError {
+    constructor(message: string, toolName: string, details?: Record<string, unknown>);
+}
+export declare class SafetyError extends FamilyAIError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class ValidationError extends FamilyAIError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class AgentError extends FamilyAIError {
+    constructor(message: string, agentId: string, details?: Record<string, unknown>);
+}
+export declare class RateLimitError extends FamilyAIError {
+    constructor(retryAfter?: number);
+}
+export declare class SandboxError extends FamilyAIError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare function isRetryableError(error: unknown): boolean;
+export declare function formatErrorForUser(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGhD,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAY,EACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASpC;AAED,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,QAAS,SAAQ,aAAa;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,WAAY,SAAQ,aAAa;gBAChC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,kBAAmB,SAAQ,aAAa;gBAEjD,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKpC;AAED,qBAAa,WAAY,SAAQ,aAAa;gBAChC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,UAAW,SAAQ,aAAa;gBAEzC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKpC;AAED,qBAAa,cAAe,SAAQ,aAAa;gBACnC,UAAU,CAAC,EAAE,MAAM;CAIhC;AAED,qBAAa,YAAa,SAAQ,aAAa;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASxD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAiBzD"}