workerclaw 0.2.0

package/dist/agent/session-manager.js

@@ -0,0 +1,205 @@
+/**
+ * 会话管理器
+ *
+ * 管理多轮会话的上下文累积
+ * 每个任务有独立会话，支持会话复用
+ */
+import { createLogger } from '../core/logger.js';
+import { ContextWindow } from './context-window.js';
+export const DEFAULT_SESSION_CONFIG = {
+    maxActiveSessions: 50,
+    sessionTTL: 30 * 60 * 1000, // 30 分钟
+    contextWindow: {
+        maxTokens: 8000,
+        keepRecentMessages: 4,
+    },
+};
+// ==================== SessionManager ====================
+export class SessionManager {
+    logger;
+    config;
+    sessions = new Map();
+    contextWindow;
+    constructor(config) {
+        this.config = { ...DEFAULT_SESSION_CONFIG, ...config };
+        this.contextWindow = new ContextWindow(this.config.contextWindow);
+        this.logger = createLogger('SessionManager');
+    }
+    /**
+     * 创建新会话
+     */
+    createSession(id, systemPrompt) {
+        if (this.sessions.has(id)) {
+            this.logger.warn(`会话 ${id} 已存在，将被重置`);
+        }
+        // 检查会话数量限制
+        if (this.sessions.size >= this.config.maxActiveSessions) {
+            this.evictExpiredSessions();
+        }
+        const session = {
+            id,
+            messages: systemPrompt ? [{ role: 'system', content: systemPrompt }] : [],
+            createdAt: Date.now(),
+            updatedAt: Date.now(),
+            turnCount: 0,
+            totalTokensUsed: 0,
+            completed: false,
+        };
+        this.sessions.set(id, session);
+        this.logger.debug(`创建会话 [${id}]`);
+        return session;
+    }
+    /**
+     * 获取会话
+     */
+    getSession(id) {
+        return this.sessions.get(id);
+    }
+    /**
+     * 添加消息到会话
+     */
+    addMessage(sessionId, message) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            this.logger.warn(`会话 ${sessionId} 不存在`);
+            return undefined;
+        }
+        session.messages.push(message);
+        session.updatedAt = Date.now();
+        session.totalTokensUsed += this.contextWindow.estimateTokens(message);
+        // 计算轮次（user 消息计为 1 轮）
+        if (message.role === 'user') {
+            session.turnCount++;
+        }
+        return session;
+    }
+    /**
+     * 获取会话的上下文窗口适配消息
+     */
+    getFittedMessages(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return {
+                messages: [],
+                stats: {
+                    totalTokens: 0,
+                    systemTokens: 0,
+                    conversationTokens: 0,
+                    messageCount: 0,
+                    isTruncated: false,
+                },
+            };
+        }
+        return this.contextWindow.fitToWindow(session.messages);
+    }
+    /**
+     * 标记会话完成
+     */
+    completeSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (session) {
+            session.completed = true;
+            session.updatedAt = Date.now();
+        }
+    }
+    /**
+     * 删除会话
+     */
+    deleteSession(sessionId) {
+        return this.sessions.delete(sessionId);
+    }
+    /**
+     * 检查会话是否存在
+     */
+    hasSession(sessionId) {
+        return this.sessions.has(sessionId);
+    }
+    /**
+     * 获取所有活跃会话 ID
+     */
+    getActiveSessionIds() {
+        return [...this.sessions.keys()].filter(id => !this.sessions.get(id).completed);
+    }
+    /**
+     * 获取会话统计
+     */
+    getSessionStats(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return null;
+        const contextStats = this.contextWindow.getStats(session.messages);
+        return {
+            messageCount: session.messages.length,
+            turnCount: session.turnCount,
+            totalTokensUsed: session.totalTokensUsed,
+            ageMs: Date.now() - session.createdAt,
+            contextStats,
+        };
+    }
+    /**
+     * 获取全局统计
+     */
+    getStats() {
+        let active = 0;
+        let completed = 0;
+        let totalTokens = 0;
+        for (const session of this.sessions.values()) {
+            if (session.completed) {
+                completed++;
+            }
+            else {
+                active++;
+            }
+            totalTokens += session.totalTokensUsed;
+        }
+        return {
+            totalSessions: this.sessions.size,
+            activeSessions: active,
+            completedSessions: completed,
+            totalTokensUsed: totalTokens,
+        };
+    }
+    /**
+     * 清理过期会话
+     */
+    evictExpiredSessions() {
+        const now = Date.now();
+        let evicted = 0;
+        for (const [id, session] of this.sessions) {
+            if (now - session.updatedAt > this.config.sessionTTL) {
+                this.sessions.delete(id);
+                evicted++;
+            }
+        }
+        if (evicted > 0) {
+            this.logger.info(`清理了 ${evicted} 个过期会话`);
+        }
+        return evicted;
+    }
+    /**
+     * 清理所有已完成会话
+     */
+    evictCompletedSessions() {
+        let evicted = 0;
+        for (const [id, session] of this.sessions) {
+            if (session.completed) {
+                this.sessions.delete(id);
+                evicted++;
+            }
+        }
+        return evicted;
+    }
+    /**
+     * 获取上下文窗口实例（供外部使用）
+     */
+    getContextWindow() {
+        return this.contextWindow;
+    }
+    /**
+     * 清理资源
+     */
+    dispose() {
+        this.sessions.clear();
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/agent/session-manager.js.map

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

package/dist/agent/tool-executor.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 工具执行器
+ *
+ * 在安全沙箱内执行工具调用
+ * 每次执行前检查权限和资源限制
+ */
+import { EventBus } from '../core/events.js';
+import { ToolRegistry } from './tool-registry.js';
+import type { ToolCall, ToolResult, ToolExecutionContext } from '../types/agent.js';
+import type { SecurityConfig } from '../core/config.js';
+export interface ToolExecutorConfig {
+    /** 安全配置 */
+    security: SecurityConfig;
+}
+export declare class ToolExecutor {
+    private logger;
+    private eventBus;
+    private registry;
+    private config;
+    constructor(registry: ToolRegistry, config: ToolExecutorConfig, eventBus: EventBus);
+    /**
+     * 执行工具调用
+     */
+    execute(toolCall: ToolCall, context: ToolExecutionContext): Promise<ToolResult>;
+    /**
+     * 带超时的执行
+     */
+    private executeWithTimeout;
+    /**
+     * 获取工具注册表（用于查询）
+     */
+    getRegistry(): ToolRegistry;
+}
+//# sourceMappingURL=tool-executor.d.ts.map

package/dist/agent/tool-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../src/agent/tool-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAmB,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,oBAAoB,EAAmB,MAAM,mBAAmB,CAAC;AACrG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,WAAW;IACX,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,MAAM,CAAqB;gBAEvB,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,QAAQ;IAMlF;;OAEG;IACG,OAAO,CACX,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC;IA2GtB;;OAEG;YACW,kBAAkB;IA2BhC;;OAEG;IACH,WAAW,IAAI,YAAY;CAG5B"}

package/dist/agent/tool-executor.js

@@ -0,0 +1,145 @@
+/**
+ * 工具执行器
+ *
+ * 在安全沙箱内执行工具调用
+ * 每次执行前检查权限和资源限制
+ */
+import { createLogger } from '../core/logger.js';
+import { WorkerClawEvent } from '../core/events.js';
+export class ToolExecutor {
+    logger = createLogger('ToolExecutor');
+    eventBus;
+    registry;
+    config;
+    constructor(registry, config, eventBus) {
+        this.registry = registry;
+        this.config = config;
+        this.eventBus = eventBus;
+    }
+    /**
+     * 执行工具调用
+     */
+    async execute(toolCall, context) {
+        const { name, id: toolCallId, arguments: argsStr } = toolCall;
+        // 1. 检查工具是否存在
+        if (!this.registry.isToolAllowed(name, context.permissionLevel)) {
+            this.eventBus.emit(WorkerClawEvent.TOOL_BLOCKED, {
+                taskId: context.taskId,
+                toolName: name,
+                reason: `工具 "${name}" 在权限级别 "${context.permissionLevel}" 下不可用`,
+            });
+            return {
+                toolCallId,
+                success: false,
+                content: `工具 "${name}" 在当前权限级别下不可用`,
+                error: 'permission_denied',
+            };
+        }
+        // 2. 检查工具调用次数限制
+        if (context.toolCallCount >= context.maxToolCalls) {
+            this.eventBus.emit(WorkerClawEvent.TOOL_BLOCKED, {
+                taskId: context.taskId,
+                toolName: name,
+                reason: `已达到最大工具调用次数 ${context.maxToolCalls}`,
+            });
+            return {
+                toolCallId,
+                success: false,
+                content: `已达到最大工具调用次数 (${context.maxToolCalls})`,
+                error: 'tool_call_limit',
+            };
+        }
+        // 3. 解析参数
+        let params;
+        try {
+            params = typeof argsStr === 'string' ? JSON.parse(argsStr) : argsStr;
+        }
+        catch (err) {
+            return {
+                toolCallId,
+                success: false,
+                content: `工具参数解析失败: ${argsStr}`,
+                error: 'invalid_arguments',
+            };
+        }
+        // 4. 获取执行器
+        const executor = this.registry.getExecutor(name);
+        this.eventBus.emit(WorkerClawEvent.TOOL_CALLED, {
+            taskId: context.taskId,
+            toolName: name,
+            toolCallId,
+        });
+        // 5. 执行
+        try {
+            if (!executor) {
+                // 无执行器：返回工具描述（说明可用但未实现）
+                const tool = this.registry.getTool(name);
+                return {
+                    toolCallId,
+                    success: true,
+                    content: JSON.stringify({
+                        status: 'not_implemented',
+                        tool: name,
+                        description: tool?.description || '未知工具',
+                        hint: '该工具已注册但执行器未绑定。在 Phase 4 技能系统中将实现具体执行逻辑。',
+                    }),
+                };
+            }
+            // 在超时限制内执行
+            const result = await this.executeWithTimeout(() => executor(params, context), context.remainingMs);
+            this.eventBus.emit(WorkerClawEvent.TOOL_COMPLETED, {
+                taskId: context.taskId,
+                toolName: name,
+                toolCallId,
+                success: result.success,
+            });
+            return result;
+        }
+        catch (err) {
+            const error = err;
+            this.logger.error(`工具执行失败: ${name}`, { taskId: context.taskId, error: error.message });
+            this.eventBus.emit(WorkerClawEvent.TOOL_COMPLETED, {
+                taskId: context.taskId,
+                toolName: name,
+                toolCallId,
+                success: false,
+            });
+            return {
+                toolCallId,
+                success: false,
+                content: `工具执行异常: ${error.message}`,
+                error: error.message,
+            };
+        }
+    }
+    /**
+     * 带超时的执行
+     */
+    async executeWithTimeout(fn, timeoutMs) {
+        if (timeoutMs <= 0) {
+            throw new Error('执行超时：无剩余时间');
+        }
+        const effectiveTimeout = Math.min(timeoutMs, this.config.security.sandbox.commandTimeoutMs);
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error(`工具执行超时 (${effectiveTimeout}ms)`));
+            }, effectiveTimeout);
+            fn()
+                .then(result => {
+                clearTimeout(timer);
+                resolve(result);
+            })
+                .catch(err => {
+                clearTimeout(timer);
+                reject(err);
+            });
+        });
+    }
+    /**
+     * 获取工具注册表（用于查询）
+     */
+    getRegistry() {
+        return this.registry;
+    }
+}
+//# sourceMappingURL=tool-executor.js.map

package/dist/agent/tool-executor.js.map

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

package/dist/agent/tool-registry.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 工具注册表
+ *
+ * 管理所有可用工具，按权限级别过滤
+ *
+ * 内置工具:
+ *   read_only:  llm_query
+ *   limited:    web_search, read_file
+ *   standard:   write_file, image_generate, data_analyze
+ *   elevated:   run_code, system_command
+ */
+import type { ToolDefinition, PermissionLevel, ToolExecutorFn } from '../types/agent.js';
+export declare class ToolRegistry {
+    private logger;
+    private tools;
+    /**
+     * 注册工具
+     */
+    register(tool: ToolDefinition): void;
+    /**
+     * 注销工具
+     */
+    unregister(name: string): boolean;
+    /**
+     * 获取指定权限级别允许的工具列表
+     */
+    getTools(level: PermissionLevel): ToolDefinition[];
+    /**
+     * 转换为 OpenAI function calling 格式
+     */
+    getToolsForLLM(level: PermissionLevel): Array<{
+        type: 'function';
+        function: {
+            name: string;
+            description: string;
+            parameters: Record<string, any>;
+        };
+    }>;
+    /**
+     * 检查工具是否允许在指定权限级别下使用
+     */
+    isToolAllowed(toolName: string, level: PermissionLevel): boolean;
+    /**
+     * 获取工具的执行器
+     */
+    getExecutor(toolName: string): ToolExecutorFn | undefined;
+    /**
+     * 获取工具定义
+     */
+    getTool(name: string): ToolDefinition | undefined;
+    /**
+     * 获取所有已注册的工具名
+     */
+    getToolNames(): string[];
+    /**
+     * 获取统计信息
+     */
+    getStats(): {
+        total: number;
+        byLevel: Record<PermissionLevel, number>;
+    };
+}
+/**
+ * 创建内置工具注册表
+ */
+export declare function createBuiltinToolRegistry(): ToolRegistry;
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/agent/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/agent/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AASzF,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,KAAK,CAAqC;IAElD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAQpC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,EAAE;IAOlD;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,KAAK,CAAC;QAC5C,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;SACjC,CAAC;KACH,CAAC;IAWF;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO;IAMhE;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIzD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIjD;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,QAAQ,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAA;KAAE;CAYxE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,YAAY,CA8KxD"}