@zhin.js/agent 0.1.24 → 0.1.26

package/lib/security/sandbox-enhanced.d.ts

@@ -0,0 +1,170 @@
+/**
+ * 增强的沙箱环境
+ *
+ * 提供更细粒度的安全控制：
+ * - 文件系统访问控制（白名单/黑名单）
+ * - 网络隔离
+ * - 资源监控
+ * - 配置热更新
+ */
+export interface EnhancedSandboxConfig {
+    /** 是否启用沙箱 */
+    enabled: boolean;
+    /** 工作目录限制 */
+    workingDirectory?: string;
+    /** 最大执行时间（毫秒） */
+    timeout?: number;
+    /** 最大内存使用（MB） */
+    maxMemoryMB?: number;
+    /** 最大 CPU 使用率（百分比） */
+    maxCpuPercent?: number;
+    /** 最大输出大小（字节） */
+    maxOutputSize?: number;
+    /** 允许的环境变量 */
+    allowedEnvVars?: string[];
+    /** 禁止的环境变量 */
+    blockedEnvVars?: string[];
+    /** 是否保留 HOME 目录 */
+    preserveHome?: boolean;
+    /** 是否保留 PATH */
+    preservePath?: boolean;
+    /** 额外的环境变量 */
+    extraEnvVars?: Record<string, string>;
+    /** 是否启用网络（默认 false） */
+    enableNetwork?: boolean;
+    /** 允许的域名（如果启用网络） */
+    allowedDomains?: string[];
+    /** 文件系统访问控制 */
+    fileSystem?: {
+        /** 允许访问的路径白名单 */
+        allowedPaths?: string[];
+        /** 禁止访问的路径黑名单 */
+        blockedPaths?: string[];
+        /** 允许访问的文件扩展名 */
+        allowedExtensions?: string[];
+        /** 禁止访问的文件扩展名 */
+        blockedExtensions?: string[];
+        /** 是否允许创建临时文件 */
+        allowTempFiles?: boolean;
+        /** 是否允许删除文件 */
+        allowDelete?: boolean;
+    };
+    /** 资源监控配置 */
+    monitoring?: {
+        /** 是否启用资源监控 */
+        enabled?: boolean;
+        /** 监控间隔（毫秒） */
+        interval?: number;
+        /** 是否记录资源使用 */
+        logUsage?: boolean;
+        /** 资源使用阈值 */
+        thresholds?: {
+            /** CPU 使用率阈值（百分比） */
+            cpuPercent?: number;
+            /** 内存使用阈值（MB） */
+            memoryMB?: number;
+            /** 执行时间阈值（毫秒） */
+            executionTime?: number;
+        };
+    };
+}
+export interface ResourceUsage {
+    /** CPU 使用时间（毫秒） */
+    cpuTime: number;
+    /** 内存使用（字节） */
+    memoryUsage: number;
+    /** 峰值内存使用（字节） */
+    peakMemoryUsage: number;
+    /** 执行时间（毫秒） */
+    executionTime: number;
+    /** I/O 读取字节数 */
+    ioRead: number;
+    /** I/O 写入字节数 */
+    ioWrite: number;
+}
+export interface EnhancedSandboxResult {
+    /** 是否成功 */
+    success: boolean;
+    /** 标准输出 */
+    stdout: string;
+    /** 标准错误 */
+    stderr: string;
+    /** 退出码 */
+    exitCode: number | null;
+    /** 执行时间（毫秒） */
+    duration: number;
+    /** 是否超时 */
+    timedOut: boolean;
+    /** 是否被沙箱阻止 */
+    blocked: boolean;
+    /** 阻止原因 */
+    blockReason?: string;
+    /** 资源使用情况 */
+    resourceUsage?: ResourceUsage;
+    /** 资源使用警告 */
+    warnings?: string[];
+}
+export declare class EnhancedSandbox {
+    private config;
+    private configListeners;
+    constructor(config?: Partial<EnhancedSandboxConfig>);
+    /**
+     * 在沙箱中执行命令
+     */
+    execute(command: string, options?: {
+        cwd?: string;
+        env?: Record<string, string>;
+        timeout?: number;
+    }): Promise<EnhancedSandboxResult>;
+    /**
+     * 不安全的命令执行
+     */
+    private executeUnsafe;
+    /**
+     * 更新配置（热更新）
+     */
+    updateConfig(config: Partial<EnhancedSandboxConfig>): void;
+    /**
+     * 获取配置
+     */
+    getConfig(): EnhancedSandboxConfig;
+    /**
+     * 添加配置变更监听器
+     */
+    onConfigChange(listener: (config: EnhancedSandboxConfig) => void): () => void;
+    /**
+     * 通知配置变更监听器
+     */
+    private notifyConfigListeners;
+    /**
+     * 检查文件访问权限
+     */
+    checkFileAccess(filePath: string): {
+        allowed: boolean;
+        reason?: string;
+    };
+    /**
+     * 检查命令安全性
+     */
+    checkCommandSafety(command: string): {
+        safe: boolean;
+        reason?: string;
+    };
+}
+/**
+ * 获取全局增强沙箱实例
+ */
+export declare function getEnhancedSandbox(): EnhancedSandbox;
+/**
+ * 初始化增强沙箱
+ */
+export declare function initEnhancedSandbox(config: Partial<EnhancedSandboxConfig>): EnhancedSandbox;
+/**
+ * 在增强沙箱中执行命令
+ */
+export declare function executeInEnhancedSandbox(command: string, options?: {
+    cwd?: string;
+    env?: Record<string, string>;
+    timeout?: number;
+}): Promise<EnhancedSandboxResult>;
+//# sourceMappingURL=sandbox-enhanced.d.ts.map

package/lib/security/sandbox-enhanced.d.ts.map

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