@jclaw/core 0.6.1 → 0.8.0

package/dist/cli/jclaw.js.backup

@@ -0,0 +1,212 @@
+#!/usr/bin/env node
+import { JClawAgent } from '../runtime/agent.js';
+import { createSimpleMemoryClient } from '../context/simple-memory-client.js';
+import { readFile, writeFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Read version from package.json
+const packageJsonPath = join(__dirname, '../../package.json');
+const packageJson = JSON.parse(await readFile(packageJsonPath, 'utf-8'));
+const VERSION = packageJson.version;
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+function showHelp() {
+  console.log(`
+🧬 JClaw - Universal Self-Evolving Agent Framework
+
+用法:
+  jclaw <command> [options]
+
+命令:
+  execute <prompt>     执行任务
+  chat                 交互模式
+  init                 初始化项目
+  help                 显示帮助
+
+环境变量:
+  LLM_API_KEY          API 密钥
+  LLM_BASE_URL         API 地址
+  LLM_MODEL_NAME       模型名称
+`);
+}
+
+async function loadLLMConfig() {
+  if (existsSync('./jclaw.config.js')) {
+    try {
+      const config = await import('./jclaw.config.js');
+      const { llm, providers } = config.default || config;
+      if (llm && llm.provider && providers && providers[llm.provider]) {
+        const provider = providers[llm.provider];
+        const apiKey = process.env[provider.apiKeyEnv];
+        if (!apiKey) {
+          console.error(`❌ 请设置 ${provider.apiKeyEnv}`);
+          process.exit(1);
+        }
+        return {
+          apiBase: provider.baseURL,
+          apiKey: apiKey,
+          model: llm.model || provider.models[0]
+        };
+      }
+      if (llm && llm.apiKey) {
+        return {
+          apiBase: llm.apiBase || 'https://api.openai.com/v1',
+          apiKey: llm.apiKey,
+          model: llm.model || 'gpt-4'
+        };
+      }
+    } catch (e) {}
+  }
+  return null;
+}
+
+async function getLLMConfig() {
+  const configFile = await loadLLMConfig();
+  if (configFile) return configFile;
+  
+  if (process.env.LLM_API_KEY) {
+    return {
+      apiBase: process.env.LLM_BASE_URL || 'https://api.openai.com/v1',
+      apiKey: process.env.LLM_API_KEY,
+      model: process.env.LLM_MODEL_NAME || 'gpt-4',
+      temperature: process.env.LLM_TEMPERATURE ? parseFloat(process.env.LLM_TEMPERATURE) : 1.0
+    };
+  }
+  
+  if (process.env.OPENAI_API_KEY) {
+    return {
+      apiBase: process.env.LLM_BASE_URL || 'https://api.openai.com/v1',
+      apiKey: process.env.OPENAI_API_KEY,
+      model: process.env.LLM_MODEL_NAME || 'gpt-4',
+      temperature: process.env.LLM_TEMPERATURE ? parseFloat(process.env.LLM_TEMPERATURE) : 1.0
+    };
+  }
+  
+  console.error('❌ 请设置 LLM_API_KEY 或 OPENAI_API_KEY');
+  process.exit(1);
+}
+
+async function execute(prompt) {
+  const llmConfig = await getLLMConfig();
+  console.log('🧬 启动 JClaw...\n');
+  console.log(`📡 模型：${llmConfig.model}`);
+  console.log(`🔌 API: ${llmConfig.apiBase}\n`);
+
+  const agent = new JClawAgent({
+    name: 'jclaw-cli',
+    version: VERSION,
+    enableAutoSkill: true,
+    skillShConfig: { enableCache: true },
+    llm: llmConfig,
+    contextManager: createSimpleMemoryClient({
+      enableSynonyms: true,
+      enableFuzzyMatch: true
+    })
+  });
+
+  await agent.start();
+  console.log('✅ JClaw 已启动\n');
+  console.log('📝 任务:', prompt, '\n');
+
+  const result = await agent.execute({ id: 'cli-task', prompt });
+
+  console.log('\n✅ 结果:\n');
+  console.log(result.output || result.error);
+  await agent.stop();
+  console.log('\n🎉 完成！\n');
+}
+
+async function chat() {
+  const llmConfig = await getLLMConfig();
+  console.log('🧬 JClaw 交互模式 (输入 "exit" 退出)\n');
+  console.log(`📡 模型：${llmConfig.model}\n`);
+
+  const agent = new JClawAgent({ name: 'jclaw-chat', version: VERSION, enableAutoSkill: true, llm: llmConfig });
+  await agent.start();
+
+  const readline = await import('readline');
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  const ask = () => {
+    rl.question('你：', async (input) => {
+      if (input.toLowerCase() === 'exit') {
+        await agent.stop();
+        rl.close();
+        console.log('\n👋 再见！\n');
+        return;
+      }
+      console.log('\n🤖 JClaw:\n');
+      const result = await agent.execute({ id: 'chat', prompt: input });
+      console.log(result.output || result.error);
+      console.log('');
+      ask();
+    });
+  };
+  ask();
+}
+
+async function init() {
+  console.log('🧬 初始化 JClaw 项目...\n');
+  const configTemplate = `export default {
+  enableAutoSkill: true,
+  llm: { provider: 'openai', model: 'gpt-4' },
+  providers: {
+    'openai': {
+      baseURL: 'https://api.openai.com/v1',
+      apiKeyEnv: 'OPENAI_API_KEY',
+      models: ['gpt-4', 'gpt-4o']
+    }
+  }
+};
+`;
+  if (!existsSync('jclaw.config.js')) {
+    await writeFile('jclaw.config.js', configTemplate);
+    console.log('✅ 创建：jclaw.config.js');
+  }
+  console.log('\n🎉 初始化完成！\n');
+}
+
+switch (command) {
+  case 'execute':
+  case 'exec':
+  case 'e':
+    const prompt = args.slice(1).join(' ');
+    if (!prompt) {
+      console.error('❌ 请提供任务描述');
+      process.exit(1);
+    }
+    execute(prompt);
+    break;
+  case 'chat':
+  case 'c':
+    chat();
+    break;
+  case 'init':
+  case 'i':
+    init();
+    break;
+  case 'help':
+  case 'h':
+  case '--help':
+  case '-h':
+    showHelp();
+    break;
+  default:
+    if (command) {
+      execute(args.join(' '));
+    } else {
+      showHelp();
+    }
+}
+
+// Add temperature env var support

package/dist/context/index.d.ts

@@ -1,6 +1,7 @@
 /**
  * Context Module
  */
+export { MemSearchTsClient, type MemSearchTsConfig, createMemSearchTsClient } from './memsearch-ts-client.js';
 export { SimpleMemoryClient, type SimpleMemoryConfig, createSimpleMemoryClient } from './simple-memory-client.js';
 export { MockClient } from './mock-client.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AASlH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAG9G,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAQlH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/context/index.js

@@ -1,11 +1,12 @@
 /**
  * Context Module
  */
-// SimpleMemory (推荐 - 纯 JavaScript，零依赖)
+// MemSearch-TS (推荐 - 纯 TypeScript，零 Python 依赖，语义搜索)
+export { MemSearchTsClient, createMemSearchTsClient } from './memsearch-ts-client.js';
+// SimpleMemory (备选 - 纯 JavaScript，无需向量数据库)
 export { SimpleMemoryClient, createSimpleMemoryClient } from './simple-memory-client.js';
-// MemSearch (需要 Python，有兼容性问题)
+// MemSearch (已弃用 - 需要 Python)
 // export { MemSearchClient, type MemSearchConfig, createMemSearchClient } from './memsearch-client.js';
-// OpenViking (已弃用 - 需要 Docker，安装复杂)
+// OpenViking (已弃用 - 需要 Docker)
 // export { OpenVikingClient, type OpenVikingConfig } from './openviking-client.js';
-// export { OpenVikingMCPClient, type OpenVikingMCPConfig, createOpenVikingMCPClient } from './openviking-mcp-client.js';
 export { MockClient } from './mock-client.js';

package/dist/context/memsearch-ts-client.d.ts

@@ -0,0 +1,37 @@
+/**
+ * MemSearch-TS Client
+ *
+ * TypeScript-native semantic memory client using memsearch-core.
+ * Zero Python dependency, built on Milvus vector database.
+ *
+ * @module @jclaw/core/context/memsearch-ts-client
+ */
+import type { ContextManager } from '../types.js';
+export interface MemSearchTsConfig {
+    memoryPath?: string;
+    embeddingProvider?: 'openai' | 'ollama';
+    embeddingModel?: string;
+    milvusUri?: string;
+    collectionName?: string;
+    verbose?: boolean;
+}
+export declare class MemSearchTsClient implements ContextManager {
+    private initialized;
+    private readonly config;
+    private mem;
+    constructor(config?: MemSearchTsConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    query(question: string, options?: {
+        topK?: number;
+    }): Promise<string>;
+    saveMemory(content: string, title?: string): Promise<void>;
+    addResource(resourcePath: string): Promise<string>;
+    isConnected(): boolean;
+    getStats(): {
+        memoryPath: string;
+        connected: boolean;
+    };
+}
+export declare function createMemSearchTsClient(config?: MemSearchTsConfig): MemSearchTsClient;
+//# sourceMappingURL=memsearch-ts-client.d.ts.map

package/dist/context/memsearch-ts-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memsearch-ts-client.d.ts","sourceRoot":"","sources":["../../src/context/memsearch-ts-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAcD,qBAAa,iBAAkB,YAAW,cAAc;IACtD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,GAAG,CAAkC;gBAEjC,MAAM,GAAE,iBAAsB;IAWpC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgCxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAsBrE,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB1D,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBxD,WAAW,IAAI,OAAO;IAItB,QAAQ,IAAI;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE;CAMvD;AAED,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,iBAAiB,CAErF"}

package/dist/context/memsearch-ts-client.js

@@ -0,0 +1,121 @@
+/**
+ * MemSearch-TS Client
+ *
+ * TypeScript-native semantic memory client using memsearch-core.
+ * Zero Python dependency, built on Milvus vector database.
+ *
+ * @module @jclaw/core/context/memsearch-ts-client
+ */
+import { writeFile, mkdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'path';
+export class MemSearchTsClient {
+    initialized = false;
+    config;
+    mem = null;
+    constructor(config = {}) {
+        this.config = {
+            memoryPath: config.memoryPath || './.jclaw/memory',
+            embeddingProvider: config.embeddingProvider || 'openai',
+            embeddingModel: config.embeddingModel || 'text-embedding-3-small',
+            milvusUri: config.milvusUri || join(process.env.HOME || '.', '.jclaw', 'milvus.db'),
+            collectionName: config.collectionName || 'jclaw_memories',
+            verbose: config.verbose || false,
+        };
+    }
+    async connect() {
+        try {
+            if (!existsSync(this.config.memoryPath)) {
+                await mkdir(this.config.memoryPath, { recursive: true });
+            }
+            const { MemSearch } = await import('memsearch-core');
+            this.mem = new MemSearch({
+                paths: [this.config.memoryPath],
+                embedding: {
+                    provider: this.config.embeddingProvider,
+                    model: this.config.embeddingModel,
+                },
+                milvus: {
+                    uri: this.config.milvusUri,
+                    collection: this.config.collectionName,
+                },
+            });
+            await this.mem.index();
+            this.initialized = true;
+            if (this.config.verbose) {
+                console.log('[MemSearch-TS] Connected, memory path: ' + this.config.memoryPath);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            throw new Error('Failed to initialize MemSearch-TS: ' + message);
+        }
+    }
+    async disconnect() {
+        if (this.mem) {
+            this.mem.close();
+            this.mem = null;
+        }
+        this.initialized = false;
+    }
+    async query(question, options) {
+        if (!this.initialized || !this.mem) {
+            throw new Error('MemSearch-TS client not initialized');
+        }
+        try {
+            await this.mem.index();
+            const results = await this.mem.search(question, { topK: options?.topK ?? 5 });
+            if (this.config.verbose) {
+                console.log('[MemSearch-TS] Found ' + results.length + ' results');
+            }
+            return results.map((r, i) => '[' + (i + 1) + '] (score: ' + r.score.toFixed(2) + ')\n' + r.content).join('\n\n---\n\n');
+        }
+        catch (error) {
+            if (this.config.verbose) {
+                console.error('[MemSearch-TS] Search failed:', error);
+            }
+            return '';
+        }
+    }
+    async saveMemory(content, title) {
+        const date = new Date().toISOString().split('T')[0];
+        const timestamp = new Date().toISOString();
+        const fileName = date + '.md';
+        const filePath = join(this.config.memoryPath, fileName);
+        const entry = title
+            ? '\n## ' + title + '\n\n> Saved at: ' + timestamp + '\n\n' + content + '\n\n---\n'
+            : '\n> Saved at: ' + timestamp + '\n\n' + content + '\n\n---\n';
+        await writeFile(filePath, entry, { flag: 'a' });
+        if (this.config.verbose) {
+            console.log('[MemSearch-TS] Saved memory: ' + (title || 'untitled'));
+        }
+        if (this.mem) {
+            await this.mem.index();
+        }
+    }
+    async addResource(resourcePath) {
+        if (!this.initialized) {
+            throw new Error('MemSearch-TS client not initialized');
+        }
+        const { copyFile } = await import('fs/promises');
+        const { basename } = await import('path');
+        const destPath = join(this.config.memoryPath, basename(resourcePath));
+        await copyFile(resourcePath, destPath);
+        if (this.mem) {
+            await this.mem.index();
+        }
+        return destPath;
+    }
+    isConnected() {
+        return this.initialized;
+    }
+    getStats() {
+        return {
+            memoryPath: this.config.memoryPath,
+            connected: this.initialized,
+        };
+    }
+}
+export function createMemSearchTsClient(config) {
+    return new MemSearchTsClient(config);
+}

package/dist/index.d.ts

@@ -12,4 +12,5 @@ export { MutationGenerator, createMutationGenerator, type MutationGeneratorConfi
 export { AutoSkillGenerator, createAutoSkillGenerator, AutoSkillInstaller, createAutoSkillInstaller, type AutoSkillConfig, type CapabilityGap, type DiscoveryResult, type GeneratedExtension, type GenerationResult, type GenerationStep, type InstallationResult, type SkillUsageStats, type AutoSkillMetadata, type SkillVersion, } from './auto-skill/index.js';
 export { A2AProtocol, GEPProtocol, type A2AMessage, type A2AMessageType, type GEPPacket, type NodeInfo, type GeneSharePayload, type GeneRequestPayload, type TaskDelegatePayload, EvoMapClient, createEvoMapClient, type EvoMapConfig, type GeneResponse, } from './network/index.js';
 export { fileOperationsExtension } from './extensions/built-in/file-operations.js';
+export { Planner, createPlanner, type Step, type StepStatus, type Plan, type PlannerConfig, type PlanAdjustment, } from './planning/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,IAAI,EACJ,UAAU,EACV,cAAc,EACd,aAAa,EACb,QAAQ,EACR,cAAc,EACd,UAAU,EACV,SAAS,EACT,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAGzE,OAAO,EACL,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,wBAAwB,EACxB,UAAU,GACX,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAG3E,OAAO,EACL,SAAS,EACT,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,YAAY,EACZ,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,UAAU,EACV,WAAW,EACX,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,uBAAuB,EAC5B,gBAAgB,EAChB,aAAa,EACb,KAAK,aAAa,EAClB,eAAe,EACf,qBAAqB,EACrB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,IAAI,EACT,KAAK,eAAe,EACpB,cAAc,EACd,oBAAoB,EACpB,KAAK,oBAAoB,EACzB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,WAAW,EACX,WAAW,EACX,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,YAAY,EACZ,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,IAAI,EACJ,UAAU,EACV,cAAc,EACd,aAAa,EACb,QAAQ,EACR,cAAc,EACd,UAAU,EACV,SAAS,EACT,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAGzE,OAAO,EACL,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,wBAAwB,EACxB,UAAU,GACX,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAG3E,OAAO,EACL,SAAS,EACT,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,YAAY,EACZ,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,UAAU,EACV,WAAW,EACX,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,uBAAuB,EAC5B,gBAAgB,EAChB,aAAa,EACb,KAAK,aAAa,EAClB,eAAe,EACf,qBAAqB,EACrB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,IAAI,EACT,KAAK,eAAe,EACpB,cAAc,EACd,oBAAoB,EACpB,KAAK,oBAAoB,EACzB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,WAAW,EACX,WAAW,EACX,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,YAAY,EACZ,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAGnF,OAAO,EACL,OAAO,EACP,aAAa,EACb,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,IAAI,EACT,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -18,3 +18,5 @@ export { AutoSkillGenerator, createAutoSkillGenerator, AutoSkillInstaller, creat
 // Network
 export { A2AProtocol, GEPProtocol, EvoMapClient, createEvoMapClient, } from './network/index.js';
 export { fileOperationsExtension } from './extensions/built-in/file-operations.js';
+// Planning Module (任务规划)
+export { Planner, createPlanner, } from './planning/index.js';

package/dist/planning/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Planning Module
+ *
+ * @module @jclaw/core/planning
+ */
+export type { Step, StepStatus, Plan, PlannerConfig, PlanAdjustment } from './types.js';
+export { Planner, createPlanner } from './planner.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/planning/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/planning/index.js

@@ -0,0 +1,6 @@
+/**
+ * Planning Module
+ *
+ * @module @jclaw/core/planning
+ */
+export { Planner, createPlanner } from './planner.js';

package/dist/planning/planner.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Task Planner
+ *
+ * Breaks down tasks into executable steps using LLM.
+ *
+ * @module @jclaw/core/planning/planner
+ */
+import type { LLMClient } from '../runtime/llm-client.js';
+import type { Plan, Step, PlannerConfig, PlanAdjustment } from './types.js';
+export declare class Planner {
+    private readonly llmClient;
+    private readonly config;
+    constructor(llmClient: LLMClient, config?: PlannerConfig);
+    plan(taskPrompt: string, relevantExperiences?: string): Promise<Plan>;
+    adjust(plan: Plan, failedStep: Step, error: string): Promise<PlanAdjustment>;
+    getNextStep(plan: Plan): Step | null;
+    advanceStep(plan: Plan, output?: unknown): Plan;
+    markStepFailed(plan: Plan, error: string): Plan;
+    isComplete(plan: Plan): boolean;
+    private parseSteps;
+}
+export declare function createPlanner(llmClient: LLMClient, config?: PlannerConfig): Planner;
+//# sourceMappingURL=planner.d.ts.map

package/dist/planning/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/planning/planner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA+B5E,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;gBAErC,SAAS,EAAE,SAAS,EAAE,MAAM,GAAE,aAAkB;IAQtD,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDrE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA8BlF,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI;IAOpC,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAkB/C,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAgB/C,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO;IAI/B,OAAO,CAAC,UAAU;CA6BnB;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAEnF"}

package/dist/planning/planner.js

@@ -0,0 +1,184 @@
+/**
+ * Task Planner
+ *
+ * Breaks down tasks into executable steps using LLM.
+ *
+ * @module @jclaw/core/planning/planner
+ */
+const PLANNING_PROMPT = `You are a task planner. Break down the given task into clear, sequential steps.
+
+Available capabilities:
+- file_read: Read file contents
+- file_write: Write to file
+- file_create: Create new file
+- file_delete: Delete file
+- dir_create: Create directory
+- dir_list: List directory contents
+- file_glob: Search files by pattern
+- file_find: Find file by name
+
+Task: {TASK}
+
+{CONTEXT}
+
+Output ONLY a JSON array of steps, each with:
+- description: What to do (string)
+- capability: Which capability to use (string, optional)
+
+Example:
+[
+  {"description": "Read the configuration file", "capability": "file_read"},
+  {"description": "Analyze the content and prepare modifications"},
+  {"description": "Write the updated configuration", "capability": "file_write"}
+]
+
+Steps:`;
+export class Planner {
+    llmClient;
+    config;
+    constructor(llmClient, config = {}) {
+        this.llmClient = llmClient;
+        this.config = {
+            maxSteps: config.maxSteps ?? 5,
+            verbose: config.verbose ?? false,
+        };
+    }
+    async plan(taskPrompt, relevantExperiences) {
+        const taskId = 'plan-' + Date.now() + '-' + Math.random().toString(36).substr(2, 9);
+        // Build prompt
+        let prompt = PLANNING_PROMPT.replace('{TASK}', taskPrompt);
+        prompt = prompt.replace('{CONTEXT}', relevantExperiences
+            ? 'Relevant past experiences:\n' + relevantExperiences
+            : 'No relevant past experiences found.');
+        try {
+            // Get plan from LLM
+            const response = await this.llmClient.chat([
+                { role: 'user', content: prompt }
+            ]);
+            // Parse steps
+            const steps = this.parseSteps(response.content);
+            if (this.config.verbose) {
+                console.log('[Planner] Created plan with ' + steps.length + ' steps');
+            }
+            return {
+                taskId,
+                taskPrompt,
+                steps,
+                currentStepIndex: 0,
+                createdAt: Date.now(),
+                relevantExperiences,
+            };
+        }
+        catch (error) {
+            // Fallback: single-step plan
+            if (this.config.verbose) {
+                console.log('[Planner] Using fallback single-step plan');
+            }
+            return {
+                taskId,
+                taskPrompt,
+                steps: [{
+                        id: 'step-1',
+                        description: taskPrompt,
+                        status: 'pending',
+                    }],
+                currentStepIndex: 0,
+                createdAt: Date.now(),
+                relevantExperiences,
+            };
+        }
+    }
+    async adjust(plan, failedStep, error) {
+        // Simple adjustment logic
+        const stepIndex = plan.steps.findIndex(s => s.id === failedStep.id);
+        if (stepIndex === -1) {
+            return { type: 'abort', reason: 'Step not found in plan' };
+        }
+        // Check if we should retry
+        const retryCount = failedStep.retryCount || 0;
+        if (retryCount < 2) {
+            return {
+                type: 'retry',
+                reason: 'Retrying failed step',
+                newSteps: plan.steps.map(s => s.id === failedStep.id
+                    ? { ...s, retryCount: retryCount + 1 }
+                    : s),
+            };
+        }
+        // Check if we can skip
+        if (plan.steps.length > stepIndex + 1) {
+            return { type: 'skip', reason: 'Skipping failed step, continuing with next' };
+        }
+        return { type: 'abort', reason: error };
+    }
+    getNextStep(plan) {
+        if (plan.currentStepIndex >= plan.steps.length) {
+            return null;
+        }
+        return plan.steps[plan.currentStepIndex];
+    }
+    advanceStep(plan, output) {
+        const updatedSteps = [...plan.steps];
+        if (output !== undefined && plan.currentStepIndex < updatedSteps.length) {
+            updatedSteps[plan.currentStepIndex] = {
+                ...updatedSteps[plan.currentStepIndex],
+                status: 'completed',
+                output,
+            };
+        }
+        return {
+            ...plan,
+            steps: updatedSteps,
+            currentStepIndex: plan.currentStepIndex + 1,
+            completedAt: plan.currentStepIndex + 1 >= plan.steps.length ? Date.now() : undefined,
+        };
+    }
+    markStepFailed(plan, error) {
+        const updatedSteps = [...plan.steps];
+        if (plan.currentStepIndex < updatedSteps.length) {
+            updatedSteps[plan.currentStepIndex] = {
+                ...updatedSteps[plan.currentStepIndex],
+                status: 'failed',
+                error,
+            };
+        }
+        return {
+            ...plan,
+            steps: updatedSteps,
+        };
+    }
+    isComplete(plan) {
+        return plan.currentStepIndex >= plan.steps.length;
+    }
+    parseSteps(content) {
+        try {
+            // Try to extract JSON array from response
+            const jsonMatch = content.match(/\[[\s\S]*\]/);
+            if (!jsonMatch) {
+                throw new Error('No JSON array found');
+            }
+            const parsed = JSON.parse(jsonMatch[0]);
+            if (!Array.isArray(parsed)) {
+                throw new Error('Parsed content is not an array');
+            }
+            return parsed.slice(0, this.config.maxSteps).map((step, i) => ({
+                id: 'step-' + (i + 1),
+                description: step.description || step,
+                status: 'pending',
+                capability: step.capability,
+                input: step.input,
+            }));
+        }
+        catch {
+            // Fallback: treat entire response as single step
+            return [{
+                    id: 'step-1',
+                    description: content.slice(0, 200),
+                    status: 'pending',
+                }];
+        }
+    }
+}
+export function createPlanner(llmClient, config) {
+    return new Planner(llmClient, config);
+}