@cicctencent/agent-server 0.2.27 → 0.2.30

package/dist/cjs/model/automation.d.ts

@@ -1,5 +1,5 @@
 /** 自动化任务运行状态 */
-export type AutomationStatus = 'idle' | 'running' | 'success' | 'error';
+export type AutomationStatus = 'idle' | 'running' | 'success' | 'error' | 'cancelled';
 /** 自动化定时任务实体 */
 export interface AutomationEntity {
     id: number;
@@ -16,6 +16,12 @@ export interface AutomationEntity {
     nextRunAt?: string;
     createdAt: string;
     updatedAt: string;
+    /** 运行时类型：prompt（Agent 指令型）| nodejs（Code 代码型） */
+    runtime?: 'prompt' | 'nodejs';
+    /** Code 型任务包 */
+    codePackage?: import('@cicctencent/agent-core').NodeAutomationTaskPackage;
+    /** 代码版本 */
+    version?: string;
 }
 /** 自动化任务执行记录 */
 export interface AutomationRunEntity {
@@ -30,5 +36,17 @@ export interface AutomationRunEntity {
     finishedAt: string;
     duration: number;
     sessionId: string;
+    /** 运行时类型 */
+    runtime?: string;
+    /** Code 型任务 stdout */
+    stdout?: string;
+    /** Code 型任务 stderr */
+    stderr?: string;
+    /** Code 型任务退出码 */
+    exitCode?: number;
+    /** Code 型任务日志 */
+    logs?: import('@cicctencent/agent-core').NodeAutomationLogEntry[];
+    /** Code 型任务产物 */
+    artifacts?: string[];
 }
 //# sourceMappingURL=automation.d.ts.map

package/dist/cjs/model/automation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../../src/model/automation.ts"],"names":[],"mappings":"AAIA,gBAAgB;AAChB,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAExE,gBAAgB;AAChB,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,UAAU,GAAG,QAAQ,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../../src/model/automation.ts"],"names":[],"mappings":"AAIA,gBAAgB;AAChB,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;AAEtF,gBAAgB;AAChB,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC9B,gBAAgB;IAChB,WAAW,CAAC,EAAE,OAAO,yBAAyB,EAAE,yBAAyB,CAAC;IAC1E,WAAW;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,UAAU,GAAG,QAAQ,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,IAAI,CAAC,EAAE,OAAO,yBAAyB,EAAE,sBAAsB,EAAE,CAAC;IAClE,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB"}

package/dist/cjs/tool/tools/automation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../../../src/tool/tools/automation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAI9D,wBAAgB,qBAAqB,IAAI,cAAc,EAAE,CAsJxD"}
+{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../../../src/tool/tools/automation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAM9D,wBAAgB,qBAAqB,IAAI,cAAc,EAAE,CAmnBxD"}

package/dist/cjs/tool/tools/automation.js

@@ -1,6 +1,8 @@
 "use strict";
 // ============================================================
-// 自动化任务工具：create_automation, list_automations, delete_automation
+// 自动化任务工具：create_automation, create_code_automation,
+//   trial_run_automation, list_automations, delete_automation,
+//   stop_automation
 // ============================================================
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -38,29 +40,55 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createAutomationTools = createAutomationTools;
 const app_stores_ts_1 = require("../../store/app-stores.js");
+const index_ts_1 = require("../../automation/index.js");
 function createAutomationTools() {
     return [
         // ---- create_automation ----
-        // 创建定时自动化任务（cron 表达式 + Agent prompt）
+        // 创建定时自动化任务（Prompt 型或 Code 型）
         {
             definition: {
                 type: 'function',
                 function: {
                     name: 'create_automation',
-                    description: 'Create a scheduled automation task that runs an Agent prompt on a cron schedule. ' +
-                        'The task will automatically trigger at the specified time and execute the prompt as a new Agent session. ' +
-                        'Common cron examples: "0 9 * * *" (daily 9AM), "0 9 * * 1" (every Monday 9AM), "*/30 * * * *" (every 30 min). ' +
-                        'Use this to set up recurring reports, monitoring, data sync, or any periodic Agent task.',
+                    description: 'Create a scheduled automation task that runs on a cron schedule. ' +
+                        'By default creates a Prompt-type task (runs an Agent prompt). ' +
+                        'Set runtime="nodejs" to create a Code-type task that executes JavaScript code in a sandboxed container. ' +
+                        'For Code-type tasks, you must provide codePackage with entry and sourceFiles. ' +
+                        'Common cron examples: "0 9 * * *" (daily 9AM), "0 9 * * 1" (every Monday 9AM), "*/30 * * * *" (every 30 min).',
                     parameters: {
                         type: 'object',
                         properties: {
                             name: { type: 'string', description: 'Task name (e.g. "Daily Summary Report")' },
                             description: { type: 'string', description: 'Task description (optional)' },
                             schedule: { type: 'string', description: 'Cron expression (5 fields: min hour day month weekday). e.g. "0 9 * * *" for daily at 9AM' },
-                            prompt: { type: 'string', description: 'The Agent prompt to execute when the task triggers. This should be a complete instruction, e.g. "Generate a summary of today\'s key metrics and send it via email to admin@example.com"' },
+                            prompt: { type: 'string', description: 'The Agent prompt to execute when the task triggers (for Prompt-type tasks). This should be a complete instruction, e.g. "Generate a summary of today\'s key metrics and send it via email to admin@example.com"' },
+                            runtime: { type: 'string', enum: ['prompt', 'nodejs'], description: 'Task runtime type. "prompt" (default) runs an Agent prompt; "nodejs" runs JavaScript code in a sandboxed container.' },
+                            codePackage: {
+                                type: 'object',
+                                description: 'Required for Code-type (runtime="nodejs") tasks. Contains the task code package.',
+                                properties: {
+                                    entry: { type: 'string', description: 'Entry file name, e.g. "index.js"' },
+                                    sourceFiles: {
+                                        type: 'object',
+                                        description: 'Map of filename to file content. e.g. {"index.js": "module.exports.run = async function(ctx) { ... }"}',
+                                    },
+                                    version: { type: 'string', description: 'Code package version (default: "1.0.0")' },
+                                    dependencies: { type: 'object', description: 'npm dependencies, e.g. {"axios": "^1.0.0"}' },
+                                    requiredLibraries: { type: 'array', items: { type: 'string' }, description: 'Names of registered base libraries to inject into the task context' },
+                                    runtimeConfig: {
+                                        type: 'object',
+                                        description: 'Runtime configuration',
+                                        properties: {
+                                            timeoutMs: { type: 'number', description: 'Execution timeout in milliseconds (default: 60000)' },
+                                            memoryLimitMb: { type: 'number', description: 'Memory limit in MB' },
+                                            envKeys: { type: 'array', items: { type: 'string' }, description: 'Whitelist of environment variable keys' },
+                                        },
+                                    },
+                                },
+                            },
                             enabled: { type: 'boolean', description: 'Whether to enable the task immediately (default: true)' },
                         },
-                        required: ['name', 'schedule', 'prompt'],
+                        required: ['name', 'schedule'],
                     },
                 },
             },
@@ -71,6 +99,41 @@ function createAutomationTools() {
                     if (!cron.validate(schedule)) {
                         return `ERROR: Invalid cron expression "${schedule}". Use 5-field format: min hour day month weekday.\nExamples: "0 9 * * *" (daily 9AM), "0 9 * * 1" (Monday 9AM), "*/30 * * * *" (every 30min)`;
                     }
+                    const runtime = args.runtime || 'prompt';
+                    // Code 型任务必须有 codePackage
+                    if (runtime === 'nodejs') {
+                        if (!args.codePackage) {
+                            return `ERROR: Code-type (runtime="nodejs") tasks require a "codePackage" parameter with "entry" and "sourceFiles".\nExample:\n{\n  "runtime": "nodejs",\n  "codePackage": {\n    "entry": "index.js",\n    "sourceFiles": {\n      "index.js": "module.exports.run = async function(ctx) { ctx.logger.info('Hello'); return { ok: true }; }"\n    }\n  }\n}`;
+                        }
+                        // 构建并校验 codePackage
+                        const codePackage = buildCodePackage(args.codePackage, args.name);
+                        const validation = (0, index_ts_1.validateNodeAutomationTaskPackage)(codePackage);
+                        if (!validation.valid) {
+                            const issues = validation.issues.map(i => `  - [${i.severity}] ${i.code}: ${i.message}`).join('\n');
+                            return `ERROR: Code package validation failed:\n${issues}`;
+                        }
+                        const store = (0, app_stores_ts_1.getAutomationStore)();
+                        const item = store.create({
+                            name: args.name,
+                            description: args.description || '',
+                            schedule,
+                            prompt: args.prompt || `Code task: ${args.name}`,
+                            enabled: args.enabled !== false,
+                            lastStatus: 'idle',
+                            runtime: 'nodejs',
+                            codePackage,
+                            version: codePackage.version,
+                        });
+                        const automationProvider = ctx.custom?.automationProvider;
+                        if (automationProvider?.refreshScheduler) {
+                            automationProvider.refreshScheduler();
+                        }
+                        return `Code automation created successfully!\n  Name: ${item.name}\n  Schedule: ${schedule}\n  ID: ${item.id}\n  Runtime: nodejs\n  Entry: ${codePackage.entry}\n  Version: ${codePackage.version}\n  Enabled: ${item.enabled}\n\nThe task will trigger automatically according to the schedule.`;
+                    }
+                    // Prompt 型任务
+                    if (!args.prompt) {
+                        return `ERROR: Prompt-type tasks require a "prompt" parameter.`;
+                    }
                     const store = (0, app_stores_ts_1.getAutomationStore)();
                     const item = store.create({
                         name: args.name,
@@ -79,8 +142,8 @@ function createAutomationTools() {
                         prompt: args.prompt,
                         enabled: args.enabled !== false,
                         lastStatus: 'idle',
+                        runtime: 'prompt',
                     });
-                    // 通过 SPI Provider 刷新调度器
                     const automationProvider = ctx.custom?.automationProvider;
                     if (automationProvider?.refreshScheduler) {
                         automationProvider.refreshScheduler();
@@ -94,6 +157,338 @@ function createAutomationTools() {
             category: 'builtin',
             concurrent: false,
         },
+        // ---- get_automation_environment ----
+        // 查询 Code 型任务执行环境（可用库、API、安全规则、代码模板）
+        {
+            definition: {
+                type: 'function',
+                function: {
+                    name: 'get_automation_environment',
+                    description: 'Get the Code automation execution environment info BEFORE writing task code. ' +
+                        'Returns available base libraries (with names, descriptions, and APIs), the context API shape, ' +
+                        'security rules (forbidden patterns), sandbox constraints, and a multi-file code template. ' +
+                        'Always call this first when creating Code-type automation tasks to ensure generated code matches the environment.',
+                    parameters: {
+                        type: 'object',
+                        properties: {
+                            detail: { type: 'string', enum: ['summary', 'full'], description: 'Level of detail. "summary" (default) returns library names + descriptions; "full" also returns library API signatures and code templates.' },
+                        },
+                    },
+                },
+            },
+            executor: async (args) => {
+                try {
+                    const registry = (0, index_ts_1.getNodeAutomationLibraryRegistry)();
+                    const libraries = registry.list();
+                    const detail = args.detail || 'summary';
+                    const lines = [];
+                    lines.push('=== Code Automation Execution Environment ===\n');
+                    // 1. 可用基础库
+                    lines.push('## Available Base Libraries');
+                    if (libraries.length === 0) {
+                        lines.push('  (none registered)');
+                    }
+                    else {
+                        for (const lib of libraries) {
+                            lines.push(`  - ${lib.name} v${lib.version}: ${lib.description || '(no description)'}`);
+                            if (lib.permissions?.length) {
+                                lines.push(`    Permissions: ${lib.permissions.join(', ')}`);
+                            }
+                        }
+                    }
+                    lines.push('');
+                    // 2. Context API
+                    lines.push('## Context API (run function receives this)');
+                    lines.push('  context = {');
+                    lines.push('    taskId:   number | string   // Task ID');
+                    lines.push('    inputs:   Record<string, unknown>  // Input parameters');
+                    lines.push('    env:      Record<string, string>    // Whitelisted env vars');
+                    lines.push('    logger:   { debug, info, warn, error }  // Structured logger');
+                    lines.push('    artifacts: { writeText(path, content), writeJson(path, data) }  // File output');
+                    lines.push('    libs:     Record<string, unknown>  // Injected base libraries (by name)');
+                    lines.push('    workspace: Record<string, unknown> | undefined  // Workspace context');
+                    lines.push('  }');
+                    lines.push('');
+                    // 3. 安全规则
+                    lines.push('## Security Rules (forbidden in task code)');
+                    lines.push('  - Cannot require/import "child_process" — use libs instead');
+                    lines.push('  - Cannot write to absolute paths (writeFile("/...")) — use context.artifacts');
+                    lines.push('  - Cannot dump process.env (JSON.stringify(process.env))');
+                    lines.push('  - Cannot run npm/pnpm/yarn install at runtime');
+                    lines.push('  - Source file paths must be relative, no ".." traversal');
+                    lines.push('');
+                    // 4. 沙箱约束
+                    lines.push('## Sandbox Constraints');
+                    lines.push('  - Runtime: Node.js (CommonJS, .cjs)');
+                    lines.push('  - Timeout: 1000ms ~ 600000ms (default: 60000ms)');
+                    lines.push('  - Entry file must export: module.exports.run = async function(context) { ... }');
+                    lines.push('  - Multiple files supported via sourceFiles map');
+                    lines.push('  - Files can require() each other by relative path');
+                    lines.push('');
+                    // 5. 完整模板
+                    if (detail === 'full') {
+                        lines.push('## Multi-File Code Template');
+                        lines.push('```javascript');
+                        lines.push('// === index.js (entry) ===');
+                        lines.push('const { analyzeStocks } = require("./analyzer.js");');
+                        lines.push('');
+                        lines.push('module.exports.run = async function(context) {');
+                        lines.push('  const { inputs, logger, libs, artifacts } = context;');
+                        lines.push('  logger.info("Task started", { taskId: context.taskId });');
+                        lines.push('');
+                        lines.push('  // Use injected libraries:');
+                        lines.push('  // const http = libs.http;  // if requiredLibraries includes "http"');
+                        lines.push('  // const resp = await http.get("https://api.example.com/data");');
+                        lines.push('');
+                        lines.push('  const result = await analyzeStocks(inputs.symbols || []);');
+                        lines.push('');
+                        lines.push('  // Write output artifacts:');
+                        lines.push('  await artifacts.writeJson("result.json", result);');
+                        lines.push('');
+                        lines.push('  return { success: true, count: result.length };');
+                        lines.push('};');
+                        lines.push('');
+                        lines.push('// === analyzer.js (helper module) ===');
+                        lines.push('async function analyzeStocks(symbols) {');
+                        lines.push('  // Business logic here');
+                        lines.push('  return symbols.map(s => ({ symbol: s, score: Math.random() }));');
+                        lines.push('}');
+                        lines.push('module.exports = { analyzeStocks };');
+                        lines.push('```');
+                        lines.push('');
+                        lines.push('## How to create multi-file tasks:');
+                        lines.push('  Use create_code_automation with the "files" parameter:');
+                        lines.push('  {');
+                        lines.push('    "name": "Stock Analysis",');
+                        lines.push('    "schedule": "*/10 * * * *",');
+                        lines.push('    "entry": "index.js",');
+                        lines.push('    "files": {');
+                        lines.push('      "index.js": "const { analyzeStocks } = require(\'./analyzer.js\'); ...",');
+                        lines.push('      "analyzer.js": "async function analyzeStocks(symbols) { ... } module.exports = { analyzeStocks };"');
+                        lines.push('    },');
+                        lines.push('    "requiredLibraries": ["http", "data"]');
+                        lines.push('  }');
+                    }
+                    return lines.join('\n');
+                }
+                catch (e) {
+                    return `ERROR getting environment: ${e.message || e}`;
+                }
+            },
+            category: 'builtin',
+            concurrent: true,
+        },
+        // ---- create_code_automation ----
+        // 便捷工具：创建 Code 型自动化任务（支持单文件和多文件）
+        {
+            definition: {
+                type: 'function',
+                function: {
+                    name: 'create_code_automation',
+                    description: 'Create a Code-type automation task that runs JavaScript code on a cron schedule. ' +
+                        'The code runs in a sandboxed NodeJS container with access to registered base libraries. ' +
+                        'The entry code must export a run(context) function that receives { inputs, env, logger, artifacts, libs, workspace }. ' +
+                        'Supports multi-file projects: use "files" (map of filename to content) for complex tasks, or "code" (single string) for simple tasks. ' +
+                        'TIP: Call get_automation_environment first to discover available libraries, APIs, and security rules.',
+                    parameters: {
+                        type: 'object',
+                        properties: {
+                            name: { type: 'string', description: 'Task name (e.g. "Stock Analysis Every 10min")' },
+                            description: { type: 'string', description: 'Task description (optional)' },
+                            schedule: { type: 'string', description: 'Cron expression (5 fields). e.g. "*/10 * * * *" for every 10 min' },
+                            code: { type: 'string', description: 'JavaScript code for a SINGLE-FILE task entry. Use this for simple tasks. Must export run(context). Mutually exclusive with "files".' },
+                            files: {
+                                type: 'object',
+                                description: 'Multi-file project: map of filename to file content. Use this for complex tasks requiring multiple modules. ' +
+                                    'Files can require() each other by relative path. Example: {"index.js": "const { analyze } = require(\'./analyzer.js\'); ...", "analyzer.js": "..."}. ' +
+                                    'Mutually exclusive with "code".',
+                            },
+                            entry: { type: 'string', description: 'Entry file name (default: "index.js"). Must match a key in "files" or be the name for "code".' },
+                            version: { type: 'string', description: 'Code package version (default: "1.0.0")' },
+                            requiredLibraries: { type: 'array', items: { type: 'string' }, description: 'Names of registered base libraries to inject (e.g. ["http", "data", "datetime"]). Call get_automation_environment to see available libraries.' },
+                            timeoutMs: { type: 'number', description: 'Execution timeout in milliseconds (default: 60000, max: 600000)' },
+                            enabled: { type: 'boolean', description: 'Whether to enable the task immediately (default: true)' },
+                        },
+                        required: ['name', 'schedule'],
+                    },
+                },
+            },
+            executor: async (args, ctx) => {
+                try {
+                    const cron = await Promise.resolve().then(() => __importStar(require('node-cron')));
+                    const schedule = args.schedule;
+                    if (!cron.validate(schedule)) {
+                        return `ERROR: Invalid cron expression "${schedule}".`;
+                    }
+                    const entry = args.entry || 'index.js';
+                    // 构建 sourceFiles：支持 code（单文件）或 files（多文件）
+                    let sourceFiles;
+                    if (args.files && typeof args.files === 'object') {
+                        sourceFiles = args.files;
+                        if (!sourceFiles[entry]) {
+                            return `ERROR: Entry file "${entry}" not found in "files". Available files: ${Object.keys(sourceFiles).join(', ')}`;
+                        }
+                    }
+                    else if (args.code) {
+                        sourceFiles = { [entry]: args.code };
+                    }
+                    else {
+                        return `ERROR: Either "code" (single file) or "files" (multi-file) must be provided.`;
+                    }
+                    const codePackage = {
+                        id: String(Date.now()),
+                        name: args.name,
+                        version: args.version || '1.0.0',
+                        runtime: 'nodejs',
+                        entry,
+                        sourceFiles,
+                        requiredLibraries: args.requiredLibraries,
+                        runtimeConfig: args.timeoutMs ? { timeoutMs: args.timeoutMs } : undefined,
+                    };
+                    // 校验
+                    const validation = (0, index_ts_1.validateNodeAutomationTaskPackage)(codePackage);
+                    if (!validation.valid) {
+                        const issues = validation.issues.map(i => `  - [${i.severity}] ${i.code}: ${i.message}`).join('\n');
+                        return `ERROR: Code validation failed:\n${issues}`;
+                    }
+                    const store = (0, app_stores_ts_1.getAutomationStore)();
+                    const item = store.create({
+                        name: args.name,
+                        description: args.description || '',
+                        schedule,
+                        prompt: `Code task: ${args.name}`,
+                        enabled: args.enabled !== false,
+                        lastStatus: 'idle',
+                        runtime: 'nodejs',
+                        codePackage,
+                        version: codePackage.version,
+                    });
+                    const automationProvider = ctx.custom?.automationProvider;
+                    if (automationProvider?.refreshScheduler) {
+                        automationProvider.refreshScheduler();
+                    }
+                    const fileCount = Object.keys(sourceFiles).length;
+                    return `Code automation created successfully!\n  Name: ${item.name}\n  Schedule: ${schedule}\n  ID: ${item.id}\n  Runtime: nodejs\n  Entry: ${entry}\n  Files: ${fileCount} (${Object.keys(sourceFiles).join(', ')})\n  Version: ${codePackage.version}\n  Enabled: ${item.enabled}\n\nThe task code will run in a sandboxed NodeJS container on the schedule.`;
+                }
+                catch (e) {
+                    return `ERROR creating code automation: ${e.message || e}`;
+                }
+            },
+            category: 'builtin',
+            concurrent: false,
+        },
+        // ---- trial_run_automation ----
+        // 试运行 Code 型任务（校验 + 执行，不保存记录，支持多文件）
+        {
+            definition: {
+                type: 'function',
+                function: {
+                    name: 'trial_run_automation',
+                    description: 'Trial-run a Code-type automation task without saving a run record. ' +
+                        'Validates the code package and executes it in the sandbox, returning stdout, stderr, exit code, logs, and result. ' +
+                        'Supports multi-file projects via "files" parameter. ' +
+                        'If automationId is provided, uses the stored codePackage (can override with code/files); otherwise uses provided code/files.',
+                    parameters: {
+                        type: 'object',
+                        properties: {
+                            automationId: { type: 'number', description: 'Existing automation task ID to trial-run (uses its stored codePackage)' },
+                            code: { type: 'string', description: 'Single-file code to trial-run (mutually exclusive with "files")' },
+                            files: { type: 'object', description: 'Multi-file project: map of filename to content (mutually exclusive with "code")' },
+                            entry: { type: 'string', description: 'Entry file name (default: "index.js")' },
+                            inputs: { type: 'object', description: 'Input parameters to pass to the task run(context) function' },
+                            timeoutMs: { type: 'number', description: 'Execution timeout in milliseconds (default: 30000)' },
+                        },
+                    },
+                },
+            },
+            executor: async (args) => {
+                try {
+                    let codePackage;
+                    const entry = args.entry || 'index.js';
+                    if (args.automationId) {
+                        // 使用已存储的 codePackage
+                        const store = (0, app_stores_ts_1.getAutomationStore)();
+                        const automation = store.findById(Number(args.automationId));
+                        if (!automation) {
+                            return `ERROR: Automation task with ID ${args.automationId} not found.`;
+                        }
+                        if (!automation.codePackage) {
+                            return `ERROR: Automation task "${automation.name}" (ID: ${args.automationId}) is not a Code-type task.`;
+                        }
+                        codePackage = automation.codePackage;
+                        // 如果提供了 code 或 files，覆盖源码
+                        if (args.files) {
+                            codePackage = { ...codePackage, entry, sourceFiles: args.files };
+                        }
+                        else if (args.code) {
+                            codePackage = { ...codePackage, entry, sourceFiles: { ...codePackage.sourceFiles, [entry]: args.code } };
+                        }
+                    }
+                    else if (args.files) {
+                        // 多文件试运行
+                        codePackage = {
+                            id: `trial_${Date.now()}`,
+                            version: '0.0.0-trial',
+                            runtime: 'nodejs',
+                            entry,
+                            sourceFiles: args.files,
+                        };
+                    }
+                    else if (args.code) {
+                        // 单文件试运行
+                        codePackage = {
+                            id: `trial_${Date.now()}`,
+                            version: '0.0.0-trial',
+                            runtime: 'nodejs',
+                            entry,
+                            sourceFiles: { [entry]: args.code },
+                        };
+                    }
+                    else {
+                        return `ERROR: Either "automationId", "code", or "files" must be provided.`;
+                    }
+                    // 校验
+                    const validation = (0, index_ts_1.validateNodeAutomationTaskPackage)(codePackage);
+                    if (!validation.valid) {
+                        const issues = validation.issues.map(i => `  - [${i.severity}] ${i.code}: ${i.message}`).join('\n');
+                        return `Validation FAILED:\n${issues}`;
+                    }
+                    // 执行
+                    const result = await (0, index_ts_1.getNodeAutomationRuntimeRunner)().execute(codePackage, {
+                        taskId: Number(args.automationId) || 0,
+                        inputs: args.inputs || {},
+                        env: {},
+                        timeoutMs: args.timeoutMs || 30000,
+                    });
+                    const lines = [];
+                    lines.push(`Trial run completed.`);
+                    lines.push(`  Exit code: ${result.exitCode}`);
+                    lines.push(`  Duration: ${result.duration}ms`);
+                    if (result.stdout)
+                        lines.push(`  stdout:\n${result.stdout.slice(0, 2000)}`);
+                    if (result.stderr)
+                        lines.push(`  stderr:\n${result.stderr.slice(0, 2000)}`);
+                    if (result.logs && result.logs.length > 0) {
+                        lines.push(`  Logs:`);
+                        for (const log of result.logs.slice(0, 50)) {
+                            lines.push(`    [${log.level}] ${log.message}`);
+                        }
+                    }
+                    if (result.artifacts && result.artifacts.length > 0) {
+                        lines.push(`  Artifacts: ${result.artifacts.join(', ')}`);
+                    }
+                    if (result.result !== undefined) {
+                        lines.push(`  Result: ${JSON.stringify(result.result).slice(0, 2000)}`);
+                    }
+                    return lines.join('\n');
+                }
+                catch (e) {
+                    return `ERROR during trial run: ${e.message || e}`;
+                }
+            },
+            category: 'builtin',
+            concurrent: false,
+        },
         // ---- list_automations ----
         // 列出所有自动化任务
         {
@@ -101,7 +496,7 @@ function createAutomationTools() {
                 type: 'function',
                 function: {
                     name: 'list_automations',
-                    description: 'List all scheduled automation tasks. Returns task details including name, schedule, prompt, status, and last run time. ' +
+                    description: 'List all scheduled automation tasks. Returns task details including name, schedule, runtime type, prompt/code info, status, and last run time. ' +
                         'Use this to review existing automations before creating or modifying them.',
                     parameters: {
                         type: 'object',
@@ -124,7 +519,18 @@ function createAutomationTools() {
                     const lines = items.map((i, idx) => {
                         const parts = [`[${idx + 1}] ${i.name} (ID: ${i.id})`];
                         parts.push(`    Schedule: ${i.schedule}`);
-                        parts.push(`    Prompt: ${(i.prompt || '').slice(0, 100)}${i.prompt?.length > 100 ? '...' : ''}`);
+                        parts.push(`    Runtime: ${i.runtime || 'prompt'}`);
+                        if (i.runtime === 'nodejs') {
+                            parts.push(`    Entry: ${i.codePackage?.entry || 'index.js'}`);
+                            parts.push(`    Version: ${i.version || '1.0.0'}`);
+                            if (i.codePackage?.requiredLibraries?.length) {
+                                parts.push(`    Libraries: ${i.codePackage.requiredLibraries.join(', ')}`);
+                            }
+                        }
+                        else {
+                            const promptPreview = (i.prompt || '').slice(0, 100);
+                            parts.push(`    Prompt: ${promptPreview}${i.prompt?.length > 100 ? '...' : ''}`);
+                        }
                         parts.push(`    Enabled: ${i.enabled}`);
                         if (i.lastRunAt)
                             parts.push(`    Last run: ${i.lastRunAt} (${i.lastStatus})`);
@@ -161,7 +567,7 @@ function createAutomationTools() {
             },
             executor: async (args, ctx) => {
                 try {
-                    const id = args.id;
+                    const id = Number(args.id);
                     const store = (0, app_stores_ts_1.getAutomationStore)();
                     const existing = store.findById(id);
                     if (!existing) {
@@ -182,6 +588,72 @@ function createAutomationTools() {
             category: 'builtin',
             concurrent: false,
         },
+        // ---- stop_automation ----
+        // 停止正在运行的自动化任务（中止执行 + 禁用调度）
+        {
+            definition: {
+                type: 'function',
+                function: {
+                    name: 'stop_automation',
+                    description: 'Stop a running automation task. Aborts the current execution (for Prompt-type tasks, aborts the Agent engine; for Code-type tasks, marks as cancelled) ' +
+                        'and disables the task from future scheduled runs. ' +
+                        'Use this when the user asks to stop/cancel/abort a task. ' +
+                        'If running inside an automation task context, the ID is auto-detected — no need to provide it. ' +
+                        'Use list_automations first if you need to find the task ID in other cases.',
+                    parameters: {
+                        type: 'object',
+                        properties: {
+                            id: { type: 'number', description: 'The automation task ID to stop. If omitted, uses the current automation context ID.' },
+                        },
+                    },
+                },
+            },
+            executor: async (args, ctx) => {
+                try {
+                    // 优先使用参数中的 id，否则从上下文中获取当前自动化任务 ID
+                    const id = args.id != null ? Number(args.id) : ctx.custom?.automationId;
+                    if (id == null || isNaN(id)) {
+                        return `ERROR: No automation task ID provided and no automation context found. Use list_automations to find the task ID.`;
+                    }
+                    const store = (0, app_stores_ts_1.getAutomationStore)();
+                    const existing = store.findById(id);
+                    if (!existing) {
+                        return `ERROR: Automation task with ID ${id} not found.`;
+                    }
+                    // 优先通过 AutomationProvider 停止（能中止正在运行的 Agent 执行）
+                    const automationProvider = ctx.custom?.automationProvider;
+                    if (automationProvider?.stopAutomation) {
+                        const result = await automationProvider.stopAutomation(id);
+                        return result.message;
+                    }
+                    // Fallback：仅禁用任务 + 停止调度
+                    store.patch(id, { enabled: false, lastStatus: 'cancelled' });
+                    if (automationProvider?.refreshScheduler) {
+                        automationProvider.refreshScheduler();
+                    }
+                    return `Automation task "${existing.name}" (ID: ${id}) has been disabled. Note: could not abort active execution (no stopAutomation provider).`;
+                }
+                catch (e) {
+                    return `ERROR stopping automation: ${e.message || e}`;
+                }
+            },
+            category: 'builtin',
+            concurrent: false,
+        },
     ];
 }
+/** 从工具参数构建 NodeAutomationTaskPackage */
+function buildCodePackage(args, name) {
+    return {
+        id: String(Date.now()),
+        name,
+        version: args.version || '1.0.0',
+        runtime: 'nodejs',
+        entry: args.entry || 'index.js',
+        sourceFiles: args.sourceFiles || {},
+        dependencies: args.dependencies,
+        requiredLibraries: args.requiredLibraries,
+        runtimeConfig: args.runtimeConfig,
+    };
+}
 //# sourceMappingURL=automation.js.map