@cicctencent/agent-core 0.1.16 → 0.1.18

package/dist/cjs/index.js

@@ -3,8 +3,9 @@
 // Core 统一导出
 // ============================================================
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.listPermissionRequests = exports.createPermissionRequest = exports.setToolSecurityPolicyProvider = exports.clearRiskCache = exports.isLowRiskTool = exports.assessToolRisk = exports.SecurityGuard = exports.DEFAULT_PROXY_SETTINGS = exports.getWindowsSystemProxy = exports.clearSystemProxyCache = exports.getSystemProxyUrl = exports.resolveProxyUrlForCategory = exports.resolveProxyAgentForCategory = exports.HttpMCPClient = exports.StdioMCPClient = exports.MCPClientBase = exports.registerTransport = exports.createMCPClient = exports.sanitizeForToolName = exports.buildMCPToolName = exports.MCP_TOOL_PREFIX = exports.registerMCPTools = exports.createDelegateTool = exports.ToolRegistry = exports.SkillRouter = exports.SkillManager = exports.LocalEnvCollector = exports.ContextManager = exports.BUILTIN_PROVIDERS = exports.createLLMProvider = exports.OllamaProvider = exports.AnthropicProvider = exports.OpenAIProvider = exports.createAgentConfig = exports.AgentToolExecutor = exports.LLMCaller = exports.HistoryManager = exports.wrapTaskWithWorkflowInstructions = exports.parseStructuredAgentOutput = exports.parseDebateOutput = exports.getWorkflowTemplate = exports.getWorkflowRoleStage = exports.formatWorkflowTemplateForPrompt = exports.formatStructuredAgentOutput = exports.formatDebateOutput = exports.buildWorkflowDecisionMemory = exports.buildStructuredOutputInstruction = exports.buildDebateInstructions = exports.DEFAULT_COMPLEX_WORKFLOW_TEMPLATE = exports.AgentEngine = void 0;
-exports.extractTextFromMessage = exports.createA2ARemoteRunner = exports.buildAuthHeaders = exports.A2AClient = exports.collectEngineOutput = exports.getAppName = exports.setAppName = exports.expandEnvVars = exports.ensureProjectDataDir = exports.ensureDataDir = exports.getProjectDataPath = exports.getDataPath = exports.MemoryPipeline = exports.formatRecallForPrompt = exports.MemoryRecallEngine = exports.resetMemoryCheckpoint = exports.getMemoryCheckpoint = exports.MemoryCheckpoint = exports.PersonaGenerator = exports.SceneAggregator = exports.MemoryExtractor = exports.InMemoryMemoryStore = exports.AuditLogMiddleware = exports.ToolGuardMiddleware = exports.TimingMiddleware = exports.FileToolResultStore = exports.JsonListStore = exports.JsonStore = exports.InMemoryRunStateStore = exports.RunRegistry = exports.EnginePool = exports.setLogTransport = exports.logEvent = exports.DEFAULT_SANDBOX_CONFIG = exports.SANDBOX_SAFE_ENV_KEYS = exports.SANDBOX_BLOCKED_COMMANDS = exports.InMemoryPermissionStore = exports.configurePermissionManager = exports.decidePermissionRequest = exports.findApprovedPermission = void 0;
+exports.clearSystemProxyCache = exports.getSystemProxyUrl = exports.resolveProxyUrlForCategory = exports.resolveProxyAgentForCategory = exports.HttpMCPClient = exports.StdioMCPClient = exports.MCPClientBase = exports.registerTransport = exports.createMCPClient = exports.sanitizeForToolName = exports.buildMCPToolName = exports.MCP_TOOL_PREFIX = exports.registerMCPTools = exports.createToolDocTool = exports.createSkillLoaderTool = exports.createShellTools = exports.createFileSystemTools = exports.createBuiltinTools = exports.createDelegateTool = exports.ToolRegistry = exports.SkillRouter = exports.SkillManager = exports.LocalEnvCollector = exports.ContextManager = exports.BUILTIN_PROVIDERS = exports.createLLMProvider = exports.OllamaProvider = exports.AnthropicProvider = exports.OpenAIProvider = exports.createAgentConfig = exports.validateSkillRequirements = exports.createAgentRuntime = exports.buildResourceScope = exports.AgentRuntimeBuilder = exports.AgentToolExecutor = exports.LLMCaller = exports.HistoryManager = exports.wrapTaskWithWorkflowInstructions = exports.parseStructuredAgentOutput = exports.parseDebateOutput = exports.getWorkflowTemplate = exports.getWorkflowRoleStage = exports.formatWorkflowTemplateForPrompt = exports.formatStructuredAgentOutput = exports.formatDebateOutput = exports.buildWorkflowDecisionMemory = exports.buildStructuredOutputInstruction = exports.buildDebateInstructions = exports.DEFAULT_COMPLEX_WORKFLOW_TEMPLATE = exports.AgentEngine = void 0;
+exports.mapAgentEventStream = exports.mapAgentEvent = exports.defaultResolveToolDisplayName = exports.createAgentEventCollectorState = exports.collectEngineOutput = exports.getAppName = exports.setAppName = exports.expandEnvVars = exports.ensureProjectDataDir = exports.ensureDataDir = exports.getProjectDataPath = exports.getDataPath = exports.MemoryPipeline = exports.formatRecallForPrompt = exports.MemoryRecallEngine = exports.resetMemoryCheckpoint = exports.getMemoryCheckpoint = exports.MemoryCheckpoint = exports.PersonaGenerator = exports.SceneAggregator = exports.MemoryExtractor = exports.InMemoryMemoryStore = exports.AuditLogMiddleware = exports.ToolGuardMiddleware = exports.TimingMiddleware = exports.FileToolResultStore = exports.JsonListStore = exports.JsonStore = exports.RunController = exports.InMemoryRunStateStore = exports.RunRegistry = exports.EnginePool = exports.setLogTransport = exports.logEvent = exports.DEFAULT_SANDBOX_CONFIG = exports.SANDBOX_SAFE_ENV_KEYS = exports.SANDBOX_BLOCKED_COMMANDS = exports.InMemoryPermissionStore = exports.configurePermissionManager = exports.decidePermissionRequest = exports.findApprovedPermission = exports.listPermissionRequests = exports.createPermissionRequest = exports.setToolSecurityPolicyProvider = exports.clearRiskCache = exports.isLowRiskTool = exports.assessToolRisk = exports.SecurityGuard = exports.DEFAULT_PROXY_SETTINGS = exports.getWindowsSystemProxy = void 0;
+exports.mapAgentEventToA2AEvent = exports.extractTextFromMessage = exports.createA2ARemoteRunner = exports.createA2AMessage = exports.createA2AAgentCard = exports.buildAuthHeaders = exports.InMemoryA2ATaskStore = exports.A2AServerHandler = exports.A2AClient = void 0;
 // ---- Agent Engine ----
 var engine_ts_1 = require("./agent/engine.js");
 Object.defineProperty(exports, "AgentEngine", { enumerable: true, get: function () { return engine_ts_1.AgentEngine; } });
@@ -27,6 +28,11 @@ var llm_caller_ts_1 = require("./agent/llm-caller.js");
 Object.defineProperty(exports, "LLMCaller", { enumerable: true, get: function () { return llm_caller_ts_1.LLMCaller; } });
 var tool_executor_ts_1 = require("./agent/tool-executor.js");
 Object.defineProperty(exports, "AgentToolExecutor", { enumerable: true, get: function () { return tool_executor_ts_1.AgentToolExecutor; } });
+var runtime_builder_ts_1 = require("./agent/runtime-builder.js");
+Object.defineProperty(exports, "AgentRuntimeBuilder", { enumerable: true, get: function () { return runtime_builder_ts_1.AgentRuntimeBuilder; } });
+Object.defineProperty(exports, "buildResourceScope", { enumerable: true, get: function () { return runtime_builder_ts_1.buildResourceScope; } });
+Object.defineProperty(exports, "createAgentRuntime", { enumerable: true, get: function () { return runtime_builder_ts_1.createAgentRuntime; } });
+Object.defineProperty(exports, "validateSkillRequirements", { enumerable: true, get: function () { return runtime_builder_ts_1.validateSkillRequirements; } });
 var types_ts_1 = require("./agent/types.js");
 Object.defineProperty(exports, "createAgentConfig", { enumerable: true, get: function () { return types_ts_1.createAgentConfig; } });
 var openai_provider_ts_1 = require("./llm/openai-provider.js");
@@ -53,6 +59,12 @@ var registry_ts_1 = require("./tool/registry.js");
 Object.defineProperty(exports, "ToolRegistry", { enumerable: true, get: function () { return registry_ts_1.ToolRegistry; } });
 var delegate_ts_1 = require("./tool/delegate.js");
 Object.defineProperty(exports, "createDelegateTool", { enumerable: true, get: function () { return delegate_ts_1.createDelegateTool; } });
+var builtin_tools_ts_1 = require("./tool/builtin-tools.js");
+Object.defineProperty(exports, "createBuiltinTools", { enumerable: true, get: function () { return builtin_tools_ts_1.createBuiltinTools; } });
+Object.defineProperty(exports, "createFileSystemTools", { enumerable: true, get: function () { return builtin_tools_ts_1.createFileSystemTools; } });
+Object.defineProperty(exports, "createShellTools", { enumerable: true, get: function () { return builtin_tools_ts_1.createShellTools; } });
+Object.defineProperty(exports, "createSkillLoaderTool", { enumerable: true, get: function () { return builtin_tools_ts_1.createSkillLoaderTool; } });
+Object.defineProperty(exports, "createToolDocTool", { enumerable: true, get: function () { return builtin_tools_ts_1.createToolDocTool; } });
 // ---- MCP ----
 var client_ts_1 = require("./mcp/client.js");
 Object.defineProperty(exports, "registerMCPTools", { enumerable: true, get: function () { return client_ts_1.registerMCPTools; } });
@@ -105,6 +117,8 @@ Object.defineProperty(exports, "EnginePool", { enumerable: true, get: function (
 var run_registry_ts_1 = require("./runtime/run-registry.js");
 Object.defineProperty(exports, "RunRegistry", { enumerable: true, get: function () { return run_registry_ts_1.RunRegistry; } });
 Object.defineProperty(exports, "InMemoryRunStateStore", { enumerable: true, get: function () { return run_registry_ts_1.InMemoryRunStateStore; } });
+var run_controller_ts_1 = require("./runtime/run-controller.js");
+Object.defineProperty(exports, "RunController", { enumerable: true, get: function () { return run_controller_ts_1.RunController; } });
 // ---- Store ----
 var json_store_ts_1 = require("./store/json-store.js");
 Object.defineProperty(exports, "JsonStore", { enumerable: true, get: function () { return json_store_ts_1.JsonStore; } });
@@ -146,10 +160,20 @@ Object.defineProperty(exports, "setAppName", { enumerable: true, get: function (
 Object.defineProperty(exports, "getAppName", { enumerable: true, get: function () { return data_dir_ts_1.getAppName; } });
 var event_collector_ts_1 = require("./utils/event-collector.js");
 Object.defineProperty(exports, "collectEngineOutput", { enumerable: true, get: function () { return event_collector_ts_1.collectEngineOutput; } });
+var event_adapter_ts_1 = require("./utils/event-adapter.js");
+Object.defineProperty(exports, "createAgentEventCollectorState", { enumerable: true, get: function () { return event_adapter_ts_1.createAgentEventCollectorState; } });
+Object.defineProperty(exports, "defaultResolveToolDisplayName", { enumerable: true, get: function () { return event_adapter_ts_1.defaultResolveToolDisplayName; } });
+Object.defineProperty(exports, "mapAgentEvent", { enumerable: true, get: function () { return event_adapter_ts_1.mapAgentEvent; } });
+Object.defineProperty(exports, "mapAgentEventStream", { enumerable: true, get: function () { return event_adapter_ts_1.mapAgentEventStream; } });
 // ---- A2A (Agent-to-Agent Protocol) ----
 var index_ts_1 = require("./a2a/index.js");
 Object.defineProperty(exports, "A2AClient", { enumerable: true, get: function () { return index_ts_1.A2AClient; } });
+Object.defineProperty(exports, "A2AServerHandler", { enumerable: true, get: function () { return index_ts_1.A2AServerHandler; } });
+Object.defineProperty(exports, "InMemoryA2ATaskStore", { enumerable: true, get: function () { return index_ts_1.InMemoryA2ATaskStore; } });
 Object.defineProperty(exports, "buildAuthHeaders", { enumerable: true, get: function () { return index_ts_1.buildAuthHeaders; } });
+Object.defineProperty(exports, "createA2AAgentCard", { enumerable: true, get: function () { return index_ts_1.createA2AAgentCard; } });
+Object.defineProperty(exports, "createA2AMessage", { enumerable: true, get: function () { return index_ts_1.createA2AMessage; } });
 Object.defineProperty(exports, "createA2ARemoteRunner", { enumerable: true, get: function () { return index_ts_1.createA2ARemoteRunner; } });
 Object.defineProperty(exports, "extractTextFromMessage", { enumerable: true, get: function () { return index_ts_1.extractTextFromMessage; } });
+Object.defineProperty(exports, "mapAgentEventToA2AEvent", { enumerable: true, get: function () { return index_ts_1.mapAgentEventToA2AEvent; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

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

package/dist/cjs/runtime/run-controller.d.ts

@@ -0,0 +1,40 @@
+import type { AgentEngine } from '../agent/engine.js';
+import type { RunOptions } from '../agent/types.js';
+import type { AgentEvent } from '../types.js';
+import type { ToolRegistry } from '../tool/registry.js';
+import { RunRegistry, type ActiveRun, type BufferedEvent } from './run-registry.js';
+import { type AgentEventAdapterOptions, type MappedAgentEvent } from '../utils/event-adapter.js';
+export interface RunPersistenceAdapter {
+    onRunStart?(run: ActiveRun): void | Promise<void>;
+    onEvent?(run: ActiveRun, event: BufferedEvent, source: AgentEvent): void | Promise<void>;
+    onFlush?(run: ActiveRun): void | Promise<void>;
+    onRunFinish?(run: ActiveRun, status: 'done' | 'error', error?: string): void | Promise<void>;
+}
+export interface RunControllerOptions {
+    registry?: RunRegistry;
+    persistence?: RunPersistenceAdapter;
+    eventAdapter?: AgentEventAdapterOptions;
+    flushIntervalMs?: number;
+    flushChars?: number;
+}
+export interface RunEngineOptions extends RunOptions {
+    threadId: number | string;
+    traceId?: string;
+    toolRegistry?: ToolRegistry;
+}
+export interface RunControllerResult {
+    run: ActiveRun;
+    events: MappedAgentEvent[];
+}
+export declare class RunController {
+    readonly registry: RunRegistry;
+    private persistence?;
+    private eventAdapter;
+    private flushIntervalMs;
+    private flushChars;
+    constructor(options?: RunControllerOptions);
+    subscribe(threadId: number | string, callback: (event: BufferedEvent) => void): () => void;
+    getBufferedEvents(threadId: number | string): BufferedEvent[];
+    run(engine: AgentEngine, options: RunEngineOptions): Promise<RunControllerResult>;
+}
+//# sourceMappingURL=run-controller.d.ts.map

package/dist/cjs/runtime/run-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-controller.d.ts","sourceRoot":"","sources":["../../../src/runtime/run-controller.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,EAAiD,KAAK,wBAAwB,EAAE,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAEhJ,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzF,OAAO,CAAC,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,WAAW,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9F;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,SAAS,CAAC;IACf,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,qBAAa,aAAa;IACxB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,OAAO,CAAC,WAAW,CAAC,CAAwB;IAC5C,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,GAAE,oBAAyB;IAQ9C,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAI1F,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,EAAE;IAIvD,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA+DxF"}

package/dist/cjs/runtime/run-controller.js

@@ -0,0 +1,93 @@
+"use strict";
+// ============================================================
+// RunController — Engine 执行、事件映射、RunRegistry、持久化 Sink 编排
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunController = void 0;
+const run_registry_ts_1 = require("./run-registry.js");
+const event_adapter_ts_1 = require("../utils/event-adapter.js");
+class RunController {
+    registry;
+    persistence;
+    eventAdapter;
+    flushIntervalMs;
+    flushChars;
+    constructor(options = {}) {
+        this.registry = options.registry || new run_registry_ts_1.RunRegistry();
+        this.persistence = options.persistence;
+        this.eventAdapter = options.eventAdapter || {};
+        this.flushIntervalMs = options.flushIntervalMs ?? 5000;
+        this.flushChars = options.flushChars ?? 500;
+    }
+    subscribe(threadId, callback) {
+        return this.registry.subscribe(threadId, callback);
+    }
+    getBufferedEvents(threadId) {
+        return this.registry.getBufferedEvents(threadId);
+    }
+    async run(engine, options) {
+        const run = this.registry.startRun(options.threadId, options.sessionId, options.traceId);
+        const emitted = [];
+        let lastFlushedLen = 0;
+        let flushTimer = null;
+        let terminalStatus = 'done';
+        let terminalError;
+        const isCurrentRun = () => this.registry.getRun(options.threadId) === run;
+        await this.persistence?.onRunStart?.(run);
+        const flush = async () => {
+            if (!isCurrentRun())
+                return;
+            if (run.fullContent.length === lastFlushedLen && run.status === 'running')
+                return;
+            lastFlushedLen = run.fullContent.length;
+            run.lastFlushAt = Date.now();
+            await this.persistence?.onFlush?.(run);
+        };
+        flushTimer = setInterval(() => { flush().catch(() => undefined); }, this.flushIntervalMs);
+        if (typeof flushTimer === 'object' && 'unref' in flushTimer)
+            flushTimer.unref();
+        const state = (0, event_adapter_ts_1.createAgentEventCollectorState)();
+        const adapterOptions = { ...this.eventAdapter, toolRegistry: options.toolRegistry || this.eventAdapter.toolRegistry };
+        try {
+            for await (const event of engine.run(options)) {
+                if (!isCurrentRun())
+                    break;
+                const mapped = (0, event_adapter_ts_1.mapAgentEvent)(event, state, adapterOptions);
+                if (!mapped)
+                    continue;
+                emitted.push(mapped);
+                this.registry.addEvent(options.threadId, mapped.event, mapped.data);
+                const buffered = { event: mapped.event, data: mapped.data };
+                await this.persistence?.onEvent?.(run, buffered, event);
+                if (event.type === 'error') {
+                    terminalStatus = 'error';
+                    terminalError = event.error || 'Agent execution failed';
+                }
+                if (run.fullContent.length - lastFlushedLen >= this.flushChars) {
+                    await flush();
+                }
+            }
+            await flush();
+            if (isCurrentRun()) {
+                this.registry.finishRun(options.threadId, terminalStatus, terminalError);
+                await this.persistence?.onRunFinish?.(run, terminalStatus, terminalError);
+            }
+            return { run, events: emitted };
+        }
+        catch (err) {
+            const message = err?.message || String(err);
+            if (isCurrentRun()) {
+                this.registry.addEvent(options.threadId, 'error', { error: message });
+                this.registry.finishRun(options.threadId, 'error', message);
+                await this.persistence?.onRunFinish?.(run, 'error', message);
+            }
+            return { run, events: emitted };
+        }
+        finally {
+            if (flushTimer)
+                clearInterval(flushTimer);
+        }
+    }
+}
+exports.RunController = RunController;
+//# sourceMappingURL=run-controller.js.map

package/dist/cjs/runtime/run-controller.js.map

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

package/dist/cjs/sandbox/local-sandbox.d.ts

@@ -0,0 +1,59 @@
+import type { ShellExecutor, FileSystemExecutor } from '../tool/types.js';
+import type { Sandbox, SandboxConfig, SandboxManager, ScriptLanguage } from './types.js';
+export interface LocalSandboxOptions extends Partial<SandboxConfig> {
+    allowedReadDirs?: string[];
+    env?: Record<string, string | undefined>;
+    cleanupOnDestroy?: boolean;
+    strictPath?: boolean;
+}
+export declare class LocalSandboxFileSystemExecutor implements FileSystemExecutor {
+    private readonly rootDir;
+    private readonly maxFileSize;
+    private readonly allowedReadDirs;
+    private readonly strictPath;
+    constructor(rootDir: string, maxFileSize?: number, allowedReadDirs?: string[], strictPath?: boolean);
+    readFile(filePath: string): Promise<string>;
+    readFileBuffer(filePath: string): Promise<Buffer>;
+    writeFile(filePath: string, content: string): Promise<void>;
+    appendFile(filePath: string, content: string): Promise<void>;
+    listDir(dirPath: string): Promise<string[]>;
+    private isInside;
+    private safeInRoot;
+    private resolveWritePath;
+    private resolveReadPath;
+}
+export declare class LocalSandboxShellExecutor implements ShellExecutor {
+    private readonly rootDir;
+    private readonly commandRestriction;
+    private readonly maxBuffer;
+    private guard;
+    private outputBuffer;
+    private env;
+    constructor(rootDir: string, commandRestriction?: boolean, env?: Record<string, string | undefined>, maxBuffer?: number);
+    exec(command: string, timeout?: number): Promise<string>;
+    write(_data: string): void;
+    read(lines?: number): string;
+}
+export declare class LocalSandbox implements Sandbox {
+    readonly id: string;
+    readonly rootDir: string;
+    private fsExecutor;
+    private shellExecutor;
+    private cleanupOnDestroy;
+    constructor(id: string, options: LocalSandboxOptions);
+    init(): Promise<void>;
+    getShellExecutor(): ShellExecutor;
+    getFileSystemExecutor(): FileSystemExecutor;
+    runScript(language: ScriptLanguage, code: string, timeout?: number): Promise<string>;
+    destroy(): Promise<void>;
+}
+export declare class LocalSandboxManager implements SandboxManager {
+    private readonly options;
+    private sandboxes;
+    constructor(options?: LocalSandboxOptions);
+    create(id: string, config?: Partial<SandboxConfig>): Promise<Sandbox>;
+    get(id: string): Sandbox | undefined;
+    destroy(id: string): Promise<void>;
+    destroyAll(): Promise<void>;
+}
+//# sourceMappingURL=local-sandbox.d.ts.map

package/dist/cjs/sandbox/local-sandbox.d.ts.map

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

package/dist/cjs/sandbox/local-sandbox.js

@@ -0,0 +1,228 @@
+"use strict";
+// ============================================================
+// LocalSandbox — 基于本地进程的默认沙箱实现
+// ============================================================
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalSandboxManager = exports.LocalSandbox = exports.LocalSandboxShellExecutor = exports.LocalSandboxFileSystemExecutor = void 0;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const crypto = __importStar(require("crypto"));
+const fs_1 = require("fs");
+const data_dir_ts_1 = require("../utils/data-dir.js");
+const guard_ts_1 = require("../security/guard.js");
+const types_ts_1 = require("./types.js");
+function filterEnv(env) {
+    const filtered = {};
+    for (const key of types_ts_1.SANDBOX_SAFE_ENV_KEYS)
+        if (env[key])
+            filtered[key] = env[key];
+    filtered.PYTHONIOENCODING = 'utf-8';
+    filtered.PYTHONUTF8 = '1';
+    return filtered;
+}
+const LANGUAGE_MAP = {
+    python: { ext: '.py', command: 'python3' },
+    nodejs: { ext: '.cjs', command: 'node' },
+    shell: { ext: '.sh', command: process.platform === 'win32' ? 'bash' : 'bash' },
+};
+class LocalSandboxFileSystemExecutor {
+    rootDir;
+    maxFileSize;
+    allowedReadDirs;
+    strictPath;
+    constructor(rootDir, maxFileSize = types_ts_1.DEFAULT_SANDBOX_CONFIG.maxFileSize, allowedReadDirs = [], strictPath = false) {
+        this.rootDir = rootDir;
+        this.maxFileSize = maxFileSize;
+        this.allowedReadDirs = allowedReadDirs;
+        this.strictPath = strictPath;
+    }
+    async readFile(filePath) {
+        return fs.readFile(this.resolveReadPath(filePath), 'utf-8');
+    }
+    async readFileBuffer(filePath) {
+        return fs.readFile(this.resolveReadPath(filePath));
+    }
+    async writeFile(filePath, content) {
+        const resolved = this.resolveWritePath(filePath);
+        const size = Buffer.byteLength(content, 'utf-8');
+        if (size > this.maxFileSize)
+            throw new Error(`Sandbox: file size ${size} bytes exceeds limit ${this.maxFileSize} bytes`);
+        await fs.mkdir(path.dirname(resolved), { recursive: true });
+        await fs.writeFile(resolved, content, 'utf-8');
+    }
+    async appendFile(filePath, content) {
+        const resolved = this.resolveWritePath(filePath);
+        await fs.mkdir(path.dirname(resolved), { recursive: true });
+        await fs.appendFile(resolved, content, 'utf-8');
+    }
+    async listDir(dirPath) {
+        const entries = await fs.readdir(this.resolveReadPath(dirPath), { withFileTypes: true });
+        return entries.map(e => e.isDirectory() ? `${e.name}/` : e.name);
+    }
+    isInside(target, base) {
+        const rel = path.relative(path.resolve(base), path.resolve(target));
+        return !rel.startsWith('..') && !path.isAbsolute(rel);
+    }
+    safeInRoot(filePath) {
+        return path.resolve(this.rootDir, path.basename(filePath));
+    }
+    resolveWritePath(filePath) {
+        const resolved = path.isAbsolute(filePath) ? path.resolve(filePath) : path.resolve(this.rootDir, filePath);
+        return this.isInside(resolved, this.rootDir) ? resolved : this.safeInRoot(filePath);
+    }
+    resolveReadPath(filePath) {
+        const resolved = path.isAbsolute(filePath) ? path.resolve(filePath) : path.resolve(this.rootDir, filePath);
+        if (this.isInside(resolved, this.rootDir))
+            return resolved;
+        for (const dir of this.allowedReadDirs)
+            if (this.isInside(resolved, dir))
+                return resolved;
+        return this.safeInRoot(filePath);
+    }
+}
+exports.LocalSandboxFileSystemExecutor = LocalSandboxFileSystemExecutor;
+class LocalSandboxShellExecutor {
+    rootDir;
+    commandRestriction;
+    maxBuffer;
+    guard;
+    outputBuffer = [];
+    env;
+    constructor(rootDir, commandRestriction = true, env = process.env, maxBuffer = 500) {
+        this.rootDir = rootDir;
+        this.commandRestriction = commandRestriction;
+        this.maxBuffer = maxBuffer;
+        this.guard = new guard_ts_1.SecurityGuard({ deleteProtection: true, blacklistEnabled: true, rules: types_ts_1.SANDBOX_BLOCKED_COMMANDS });
+        this.env = filterEnv(env);
+    }
+    async exec(command, timeout = types_ts_1.DEFAULT_SANDBOX_CONFIG.execTimeout) {
+        if (this.commandRestriction) {
+            const sanitized = this.guard.sanitize(command.trim());
+            if (!sanitized.safe)
+                return `[Sandbox blocked] ${sanitized.reason}`;
+            if (sanitized.rewritten)
+                command = sanitized.rewritten;
+        }
+        const shellCommand = process.platform === 'win32' ? `chcp 65001 >nul 2>&1 & ${command}` : command;
+        return new Promise(resolve => {
+            (0, child_process_1.exec)(shellCommand, {
+                timeout,
+                maxBuffer: 1024 * 1024 * 5,
+                windowsHide: true,
+                encoding: 'buffer',
+                cwd: this.rootDir,
+                env: this.env,
+            }, (error, stdoutBuf, stderrBuf) => {
+                const stdout = stdoutBuf ? stdoutBuf.toString('utf-8') : '';
+                const stderr = stderrBuf ? stderrBuf.toString('utf-8') : '';
+                let output = [stdout, stderr].filter(Boolean).join('\n');
+                if (error && !output.trim())
+                    output = error.message;
+                this.outputBuffer.push(...output.split('\n'));
+                if (this.outputBuffer.length > this.maxBuffer)
+                    this.outputBuffer = this.outputBuffer.slice(-this.maxBuffer);
+                resolve(output || '(no output)');
+            });
+        });
+    }
+    write(_data) { }
+    read(lines = 50) {
+        return this.outputBuffer.slice(Math.max(0, this.outputBuffer.length - lines)).join('\n') || '(no terminal output)';
+    }
+}
+exports.LocalSandboxShellExecutor = LocalSandboxShellExecutor;
+class LocalSandbox {
+    id;
+    rootDir;
+    fsExecutor;
+    shellExecutor;
+    cleanupOnDestroy;
+    constructor(id, options) {
+        this.id = id;
+        this.rootDir = options.rootDir || path.join((0, data_dir_ts_1.getProjectDataPath)(), 'sandboxes', id);
+        this.cleanupOnDestroy = options.cleanupOnDestroy ?? false;
+        const maxFileSize = options.maxFileSize ?? types_ts_1.DEFAULT_SANDBOX_CONFIG.maxFileSize;
+        const allowedReadDirs = options.allowedReadDirs?.map(d => path.resolve(d)) || [];
+        this.fsExecutor = new LocalSandboxFileSystemExecutor(this.rootDir, maxFileSize, allowedReadDirs, options.strictPath ?? false);
+        this.shellExecutor = new LocalSandboxShellExecutor(this.rootDir, options.commandRestriction ?? types_ts_1.DEFAULT_SANDBOX_CONFIG.commandRestriction, options.env);
+    }
+    async init() {
+        await fs.mkdir(this.rootDir, { recursive: true });
+    }
+    getShellExecutor() { return this.shellExecutor; }
+    getFileSystemExecutor() { return this.fsExecutor; }
+    async runScript(language, code, timeout) {
+        const spec = LANGUAGE_MAP[language];
+        const filename = `script_${Date.now()}_${crypto.randomBytes(4).toString('hex')}${spec.ext}`;
+        await this.fsExecutor.writeFile(filename, code);
+        return this.shellExecutor.exec(`${spec.command} ${filename}`, timeout);
+    }
+    async destroy() {
+        if (this.cleanupOnDestroy && (0, fs_1.existsSync)(this.rootDir))
+            await fs.rm(this.rootDir, { recursive: true, force: true });
+    }
+}
+exports.LocalSandbox = LocalSandbox;
+class LocalSandboxManager {
+    options;
+    sandboxes = new Map();
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async create(id, config) {
+        const existing = this.sandboxes.get(id);
+        if (existing)
+            return existing;
+        const sandbox = new LocalSandbox(id, { ...this.options, ...config });
+        await sandbox.init();
+        this.sandboxes.set(id, sandbox);
+        return sandbox;
+    }
+    get(id) { return this.sandboxes.get(id); }
+    async destroy(id) {
+        const sandbox = this.sandboxes.get(id);
+        if (!sandbox)
+            return;
+        await sandbox.destroy();
+        this.sandboxes.delete(id);
+    }
+    async destroyAll() {
+        await Promise.all([...this.sandboxes.keys()].map(id => this.destroy(id)));
+    }
+}
+exports.LocalSandboxManager = LocalSandboxManager;
+//# sourceMappingURL=local-sandbox.js.map

package/dist/cjs/sandbox/local-sandbox.js.map

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

package/dist/cjs/tool/builtin-tools.d.ts

@@ -0,0 +1,22 @@
+import type { RegisteredTool } from './types.js';
+import type { ToolRegistry } from './registry.js';
+import type { SkillManager } from '../skill/manager.js';
+export interface BuiltinToolOptions {
+    includeShell?: boolean;
+    includeFileSystem?: boolean;
+    includeToolDoc?: boolean;
+    includeSkillLoader?: boolean;
+    toolRegistry?: ToolRegistry;
+    skillManager?: SkillManager;
+    toolResultStore?: ToolResultStoreLike;
+}
+export interface ToolResultStoreLike {
+    read(callId: string): string | null;
+    has?(callId: string): boolean;
+}
+export declare function createShellTools(): RegisteredTool[];
+export declare function createFileSystemTools(): RegisteredTool[];
+export declare function createToolDocTool(registry?: ToolRegistry): RegisteredTool;
+export declare function createSkillLoaderTool(skillManager?: SkillManager): RegisteredTool;
+export declare function createBuiltinTools(options?: BuiltinToolOptions): RegisteredTool[];
+//# sourceMappingURL=builtin-tools.d.ts.map

package/dist/cjs/tool/builtin-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-tools.d.ts","sourceRoot":"","sources":["../../../src/tool/builtin-tools.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,eAAe,CAAC,EAAE,mBAAmB,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED,wBAAgB,gBAAgB,IAAI,cAAc,EAAE,CA2CnD;AAED,wBAAgB,qBAAqB,IAAI,cAAc,EAAE,CAkFxD;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,cAAc,CA0BzE;AAED,wBAAgB,qBAAqB,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,cAAc,CAyBjF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,kBAAuB,GAAG,cAAc,EAAE,CAOrF"}