opc-agent 1.1.0 → 1.1.2

package/dist/deploy/openclaw.js

@@ -41,27 +41,27 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 function generateIdentityMd(oad) {
     const m = oad.metadata;
-    return `# IDENTITY.md
-
-- **Name:** ${m.name}
-- **Version:** ${m.version}
-- **Description:** ${m.description ?? 'An AI agent'}
-- **Author:** ${m.author ?? 'Unknown'}
-- **License:** ${m.license}
+    return `# IDENTITY.md
+
+- **Name:** ${m.name}
+- **Version:** ${m.version}
+- **Description:** ${m.description ?? 'An AI agent'}
+- **Author:** ${m.author ?? 'Unknown'}
+- **License:** ${m.license}
 `;
 }
 function generateSoulMd(oad) {
     const prompt = oad.spec.systemPrompt ?? 'You are a helpful AI assistant.';
-    return `# SOUL.md - ${oad.metadata.name}
-
-## System Prompt
-
-${prompt}
-
-## Model Configuration
-
-- **Model:** ${oad.spec.model}
-- **Provider:** ${oad.spec.provider?.default ?? 'deepseek'}
+    return `# SOUL.md - ${oad.metadata.name}
+
+## System Prompt
+
+${prompt}
+
+## Model Configuration
+
+- **Model:** ${oad.spec.model}
+- **Provider:** ${oad.spec.provider?.default ?? 'deepseek'}
 `;
 }
 function generateAgentsMd(oad) {
@@ -112,23 +112,23 @@ function generateAgentsMd(oad) {
     return md;
 }
 function generateUserMd(oad) {
-    return `# USER.md
-
-- **Name:** (your name)
-- **Role:** User
-- **Notes:** Configure this file with your preferences for ${oad.metadata.name}.
+    return `# USER.md
+
+- **Name:** (your name)
+- **Role:** User
+- **Notes:** Configure this file with your preferences for ${oad.metadata.name}.
 `;
 }
 function generateMemoryMd(oad) {
-    return `# MEMORY.md - ${oad.metadata.name}
-
-## Persistent Knowledge
-
-(Agent will store learned information here)
-
-## User Preferences
-
-(Discovered user preferences will be noted here)
+    return `# MEMORY.md - ${oad.metadata.name}
+
+## Persistent Knowledge
+
+(Agent will store learned information here)
+
+## User Preferences
+
+(Discovered user preferences will be noted here)
 `;
 }
 function generateOpenClawConfig(oad, agentDir) {

package/dist/i18n/index.js

@@ -16,16 +16,33 @@ const messages = {
         'agent.notUnderstood': 'I\'m not sure I understand. Could you rephrase?',
         'agent.handoff': 'Let me connect you with a human agent.',
         'cli.init.success': 'Created agent project: {name}',
+        'cli.init.prompt.name': 'Agent name:',
+        'cli.init.prompt.template': 'Choose a template:',
+        'cli.init.prompt.provider': 'Choose an LLM provider:',
         'cli.build.success': 'Build successful: {name} v{version}',
         'cli.test.pass': 'All tests passed',
         'cli.test.fail': '{count} test(s) failed',
+        'cli.run.starting': 'Starting agent "{name}"...',
+        'cli.run.listening': 'Agent "{name}" is running at http://localhost:{port}',
+        'cli.deploy.success': 'Deployed "{name}" to {target}',
+        'cli.deploy.error': 'Deploy failed: {error}',
+        'cli.validate.success': 'OAD validation passed',
+        'cli.validate.error': 'OAD validation failed: {error}',
+        'cli.analytics.title': 'Agent Analytics',
+        'cli.analytics.noData': 'No analytics data yet',
         'cli.stats.title': 'Agent Analytics',
         'cli.stats.messages': 'Messages Processed',
         'cli.stats.avgTime': 'Avg Response Time',
         'cli.stats.errors': 'Errors',
         'cli.stats.uptime': 'Uptime',
+        'cli.chat.welcome': 'Chat with your agent. Type "exit" to quit.',
+        'cli.dev.watching': 'Watching for changes...',
+        'cli.publish.success': 'Published "{name}" v{version}',
         'plugin.loaded': 'Plugin "{name}" loaded',
         'plugin.error': 'Plugin "{name}" failed: {error}',
+        'kb.added': 'Added "{file}" to knowledge base',
+        'kb.searchResults': '{count} results found',
+        'kb.noResults': 'No results found',
         'web.title': 'OPC Agent',
         'web.chat.placeholder': 'Type a message...',
         'web.chat.send': 'Send',
@@ -48,22 +65,39 @@ const messages = {
     'zh-CN': {
         'agent.started': '智能体 "{name}" 启动成功',
         'agent.stopped': '智能体 "{name}" 已停止',
-        'agent.error': '发生错误: {error}',
-        'agent.greeting': '您好！有什么可以帮您的？',
-        'agent.farewell': '再见！祝您愉快。',
-        'agent.notUnderstood': '抱歉，我没有理解您的意思。能换个方式描述吗？',
-        'agent.handoff': '我来为您转接人工客服。',
-        'cli.init.success': '已创建智能体项目: {name}',
-        'cli.build.success': '构建成功: {name} v{version}',
+        'agent.error': '发生错误：{error}',
+        'agent.greeting': '你好！有什么可以帮你的？',
+        'agent.farewell': '再见！祝你愉快。',
+        'agent.notUnderstood': '抱歉，我没太理解你的意思。能换个方式描述一下吗？',
+        'agent.handoff': '我来帮你转接人工客服。',
+        'cli.init.success': '已创建智能体项目：{name}',
+        'cli.init.prompt.name': '智能体名称：',
+        'cli.init.prompt.template': '选择一个模板：',
+        'cli.init.prompt.provider': '选择大语言模型供应商：',
+        'cli.build.success': '构建成功：{name} v{version}',
         'cli.test.pass': '所有测试通过',
         'cli.test.fail': '{count} 个测试失败',
-        'cli.stats.title': '智能体分析',
+        'cli.run.starting': '正在启动智能体 "{name}"...',
+        'cli.run.listening': '智能体 "{name}" 已在 http://localhost:{port} 上运行',
+        'cli.deploy.success': '已将 "{name}" 部署到 {target}',
+        'cli.deploy.error': '部署失败：{error}',
+        'cli.validate.success': 'OAD 配置校验通过',
+        'cli.validate.error': 'OAD 配置校验失败：{error}',
+        'cli.analytics.title': '智能体数据分析',
+        'cli.analytics.noData': '暂无分析数据',
+        'cli.stats.title': '智能体数据分析',
         'cli.stats.messages': '已处理消息',
         'cli.stats.avgTime': '平均响应时间',
         'cli.stats.errors': '错误数',
         'cli.stats.uptime': '运行时间',
+        'cli.chat.welcome': '开始和智能体对话吧。输入 "exit" 退出。',
+        'cli.dev.watching': '正在监听文件变更...',
+        'cli.publish.success': '已发布 "{name}" v{version}',
         'plugin.loaded': '插件 "{name}" 已加载',
-        'plugin.error': '插件 "{name}" 失败: {error}',
+        'plugin.error': '插件 "{name}" 出错：{error}',
+        'kb.added': '已将 "{file}" 添加到知识库',
+        'kb.searchResults': '找到 {count} 条结果',
+        'kb.noResults': '未找到相关结果',
         'web.title': 'OPC 智能体',
         'web.chat.placeholder': '输入消息...',
         'web.chat.send': '发送',
@@ -92,16 +126,33 @@ const messages = {
         'agent.notUnderstood': '申し訳ございません、理解できませんでした。別の言い方でお願いできますか？',
         'agent.handoff': 'オペレーターにおつなぎします。',
         'cli.init.success': 'エージェントプロジェクトを作成しました: {name}',
+        'cli.init.prompt.name': 'エージェント名:',
+        'cli.init.prompt.template': 'テンプレートを選択:',
+        'cli.init.prompt.provider': 'LLMプロバイダーを選択:',
         'cli.build.success': 'ビルド成功: {name} v{version}',
         'cli.test.pass': '全テスト合格',
         'cli.test.fail': '{count} 件のテストが失敗しました',
+        'cli.run.starting': 'エージェント「{name}」を起動中...',
+        'cli.run.listening': 'エージェント「{name}」が http://localhost:{port} で稼働中',
+        'cli.deploy.success': '「{name}」を {target} にデプロイしました',
+        'cli.deploy.error': 'デプロイ失敗: {error}',
+        'cli.validate.success': 'OADバリデーション成功',
+        'cli.validate.error': 'OADバリデーション失敗: {error}',
+        'cli.analytics.title': 'エージェント分析',
+        'cli.analytics.noData': '分析データがありません',
         'cli.stats.title': 'エージェント分析',
         'cli.stats.messages': '処理済みメッセージ',
         'cli.stats.avgTime': '平均応答時間',
         'cli.stats.errors': 'エラー数',
         'cli.stats.uptime': '稼働時間',
+        'cli.chat.welcome': 'エージェントとチャットしましょう。"exit"で終了。',
+        'cli.dev.watching': 'ファイル変更を監視中...',
+        'cli.publish.success': '「{name}」v{version} を公開しました',
         'plugin.loaded': 'プラグイン「{name}」を読み込みました',
         'plugin.error': 'プラグイン「{name}」でエラー: {error}',
+        'kb.added': '「{file}」をナレッジベースに追加しました',
+        'kb.searchResults': '{count} 件の結果が見つかりました',
+        'kb.noResults': '結果が見つかりませんでした',
         'web.title': 'OPC エージェント',
         'web.chat.placeholder': 'メッセージを入力...',
         'web.chat.send': '送信',

package/dist/templates/code-reviewer.js

@@ -2,11 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CODE_REVIEWER_SYSTEM_PROMPT = void 0;
 exports.createCodeReviewerConfig = createCodeReviewerConfig;
-exports.CODE_REVIEWER_SYSTEM_PROMPT = `You are an expert code reviewer. When given code:
-1. Check for bugs, security issues, and performance problems
-2. Suggest improvements for readability and maintainability
-3. Follow language-specific best practices
-4. Be constructive and explain your reasoning
+exports.CODE_REVIEWER_SYSTEM_PROMPT = `You are an expert code reviewer. When given code:
+1. Check for bugs, security issues, and performance problems
+2. Suggest improvements for readability and maintainability
+3. Follow language-specific best practices
+4. Be constructive and explain your reasoning
 Rate severity: 🔴 Critical | 🟡 Warning | 🔵 Info`;
 function createCodeReviewerConfig() {
     return {

package/dist/templates/customer-service.js

@@ -41,8 +41,8 @@ class HandoffSkill extends base_1.BaseSkill {
     }
 }
 exports.HandoffSkill = HandoffSkill;
-exports.CUSTOMER_SERVICE_SYSTEM_PROMPT = `You are a friendly and professional customer service agent. 
-You help customers with their questions about products, orders, shipping, and returns.
+exports.CUSTOMER_SERVICE_SYSTEM_PROMPT = `You are a friendly and professional customer service agent. 
+You help customers with their questions about products, orders, shipping, and returns.
 Be concise, helpful, and empathetic. If you're unsure, offer to connect them with a human agent.`;
 function createCustomerServiceConfig() {
     return {

package/dist/templates/data-analyst.js

@@ -33,11 +33,11 @@ class InsightSkill extends base_1.BaseSkill {
     }
 }
 exports.InsightSkill = InsightSkill;
-exports.DATA_ANALYST_SYSTEM_PROMPT = `You are a professional data analyst assistant. Your goals:
-1. Help users query, transform, and analyze data
-2. Create clear visualizations and summaries
-3. Identify trends, patterns, and anomalies
-4. Explain findings in plain language
+exports.DATA_ANALYST_SYSTEM_PROMPT = `You are a professional data analyst assistant. Your goals:
+1. Help users query, transform, and analyze data
+2. Create clear visualizations and summaries
+3. Identify trends, patterns, and anomalies
+4. Explain findings in plain language
 Be precise with numbers, always cite your data source, and suggest next steps for deeper analysis.`;
 function createDataAnalystConfig() {
     return {

package/dist/templates/knowledge-base.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KNOWLEDGE_BASE_SYSTEM_PROMPT = void 0;
 exports.createKnowledgeBaseConfig = createKnowledgeBaseConfig;
-exports.KNOWLEDGE_BASE_SYSTEM_PROMPT = `You are a knowledge base assistant. Answer questions using the company documents
-and knowledge provided to you. If you don't have enough information, say so honestly.
+exports.KNOWLEDGE_BASE_SYSTEM_PROMPT = `You are a knowledge base assistant. Answer questions using the company documents
+and knowledge provided to you. If you don't have enough information, say so honestly.
 Always cite sources when possible. Be accurate and concise.`;
 function createKnowledgeBaseConfig() {
     return {

package/dist/templates/sales-assistant.js

@@ -43,10 +43,10 @@ class LeadCaptureSkill extends base_1.BaseSkill {
     }
 }
 exports.LeadCaptureSkill = LeadCaptureSkill;
-exports.SALES_ASSISTANT_SYSTEM_PROMPT = `You are a professional sales assistant. Your goals:
-1. Answer product questions accurately and enthusiastically
-2. Capture leads by collecting name, email, and company info
-3. Book appointments when prospects are ready
+exports.SALES_ASSISTANT_SYSTEM_PROMPT = `You are a professional sales assistant. Your goals:
+1. Answer product questions accurately and enthusiastically
+2. Capture leads by collecting name, email, and company info
+3. Book appointments when prospects are ready
 Be friendly, persuasive but not pushy. Always provide value first.`;
 function createSalesAssistantConfig() {
     return {

package/dist/templates/teacher.js

@@ -39,12 +39,12 @@ class ExplainSkill extends base_1.BaseSkill {
     }
 }
 exports.ExplainSkill = ExplainSkill;
-exports.TEACHER_SYSTEM_PROMPT = `You are a patient and encouraging teacher assistant. Your goals:
-1. Create engaging lesson plans tailored to student level
-2. Generate quizzes and assessments with answer keys
-3. Explain complex concepts using analogies and examples
-4. Provide constructive feedback and encouragement
-5. Adapt teaching style to different learning preferences
+exports.TEACHER_SYSTEM_PROMPT = `You are a patient and encouraging teacher assistant. Your goals:
+1. Create engaging lesson plans tailored to student level
+2. Generate quizzes and assessments with answer keys
+3. Explain complex concepts using analogies and examples
+4. Provide constructive feedback and encouragement
+5. Adapt teaching style to different learning preferences
 Be patient, use clear language, and always check for understanding. Use the Socratic method when appropriate.`;
 function createTeacherConfig() {
     return {

package/docs/.vitepress/config.ts

@@ -1,92 +1,103 @@
-import { defineConfig } from 'vitepress';
-
-export default defineConfig({
-  title: 'OPC Agent',
-  description: 'Open Agent Framework - Build, test, and run AI Agents for business workstations',
-  
-  locales: {
-    root: {
-      label: 'English',
-      lang: 'en',
-      themeConfig: {
-        nav: [
-          { text: 'Guide', link: '/guide/getting-started' },
-          { text: 'API', link: '/api/oad-schema' },
-          { text: 'GitHub', link: 'https://github.com/Deepleaper/opc-agent' },
-        ],
-        sidebar: {
-          '/guide/': [
-            {
-              text: 'Introduction',
-              items: [
-                { text: 'Getting Started', link: '/guide/getting-started' },
-                { text: 'Core Concepts', link: '/guide/concepts' },
-              ],
-            },
-            {
-              text: 'Usage',
-              items: [
-                { text: 'Templates', link: '/guide/templates' },
-                { text: 'Configuration', link: '/guide/configuration' },
-                { text: 'Testing', link: '/guide/testing' },
-                { text: 'Deployment', link: '/guide/deployment' },
-              ],
-            },
-          ],
-          '/api/': [
-            {
-              text: 'Reference',
-              items: [
-                { text: 'OAD Schema', link: '/api/oad-schema' },
-                { text: 'CLI Commands', link: '/api/cli' },
-                { text: 'SDK', link: '/api/sdk' },
-              ],
-            },
-          ],
-        },
-      },
-    },
-    zh: {
-      label: '中文',
-      lang: 'zh-CN',
-      themeConfig: {
-        nav: [
-          { text: '指南', link: '/zh/guide/getting-started' },
-          { text: 'API', link: '/zh/api/oad-schema' },
-          { text: 'GitHub', link: 'https://github.com/Deepleaper/opc-agent' },
-        ],
-        sidebar: {
-          '/zh/guide/': [
-            {
-              text: '介绍',
-              items: [
-                { text: '快速开始', link: '/zh/guide/getting-started' },
-                { text: '核心概念', link: '/zh/guide/concepts' },
-              ],
-            },
-            {
-              text: '使用',
-              items: [
-                { text: '模板', link: '/zh/guide/templates' },
-                { text: '配置', link: '/zh/guide/configuration' },
-                { text: '测试', link: '/zh/guide/testing' },
-                { text: '部署', link: '/zh/guide/deployment' },
-              ],
-            },
-          ],
-        },
-      },
-    },
-  },
-
-  themeConfig: {
-    logo: '/logo.svg',
-    socialLinks: [
-      { icon: 'github', link: 'https://github.com/Deepleaper/opc-agent' },
-    ],
-    footer: {
-      message: 'Released under the Apache-2.0 License.',
-      copyright: 'Copyright © 2025 Deepleaper',
-    },
-  },
-});
+import { defineConfig } from 'vitepress';
+
+export default defineConfig({
+  title: 'OPC Agent',
+  description: 'Open Agent Framework - Build, test, and run AI Agents for business workstations',
+  
+  locales: {
+    root: {
+      label: 'English',
+      lang: 'en',
+      themeConfig: {
+        nav: [
+          { text: 'Guide', link: '/guide/getting-started' },
+          { text: 'API', link: '/api/oad-schema' },
+          { text: 'GitHub', link: 'https://github.com/Deepleaper/opc-agent' },
+        ],
+        sidebar: {
+          '/guide/': [
+            {
+              text: 'Introduction',
+              items: [
+                { text: 'Getting Started', link: '/guide/getting-started' },
+                { text: 'Core Concepts', link: '/guide/concepts' },
+              ],
+            },
+            {
+              text: 'Usage',
+              items: [
+                { text: 'Templates', link: '/guide/templates' },
+                { text: 'Configuration', link: '/guide/configuration' },
+                { text: 'Testing', link: '/guide/testing' },
+                { text: 'Deployment', link: '/guide/deployment' },
+              ],
+            },
+          ],
+          '/api/': [
+            {
+              text: 'Reference',
+              items: [
+                { text: 'OAD Schema', link: '/api/oad-schema' },
+                { text: 'CLI Commands', link: '/api/cli' },
+                { text: 'SDK', link: '/api/sdk' },
+              ],
+            },
+          ],
+        },
+      },
+    },
+    zh: {
+      label: '中文',
+      lang: 'zh-CN',
+      description: '开放智能体框架 — 构建、测试、运行企业级 AI 智能体',
+      themeConfig: {
+        nav: [
+          { text: '指南', link: '/zh/guide/getting-started' },
+          { text: 'API', link: '/zh/api/oad-schema' },
+          { text: 'GitHub', link: 'https://github.com/Deepleaper/opc-agent' },
+        ],
+        sidebar: {
+          '/zh/guide/': [
+            {
+              text: '入门',
+              items: [
+                { text: '快速开始', link: '/zh/guide/getting-started' },
+                { text: '核心概念', link: '/zh/guide/concepts' },
+              ],
+            },
+            {
+              text: '使用',
+              items: [
+                { text: '模板', link: '/zh/guide/templates' },
+                { text: '配置', link: '/zh/guide/configuration' },
+                { text: '测试', link: '/zh/guide/testing' },
+                { text: '部署', link: '/zh/guide/deployment' },
+              ],
+            },
+          ],
+          '/zh/api/': [
+            {
+              text: '参考',
+              items: [
+                { text: 'OAD Schema', link: '/zh/api/oad-schema' },
+                { text: 'CLI 命令', link: '/zh/api/cli' },
+                { text: 'SDK', link: '/zh/api/sdk' },
+              ],
+            },
+          ],
+        },
+      },
+    },
+  },
+
+  themeConfig: {
+    logo: '/logo.svg',
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/Deepleaper/opc-agent' },
+    ],
+    footer: {
+      message: 'Released under the Apache-2.0 License.',
+      copyright: 'Copyright © 2025 Deepleaper 跃盟科技',
+    },
+  },
+});

package/docs/api/cli.md

@@ -1,48 +1,48 @@
-# CLI Commands
-
-## Reference
-
-| Command | Description |
-|---------|-------------|
-| `opc init [name]` | Initialize a new agent project |
-| `opc run` | Start agent with web server |
-| `opc chat` | Interactive CLI chat |
-| `opc test` | Run agent tests |
-| `opc analytics` | Show usage analytics |
-| `opc info` | Show agent info from OAD |
-| `opc build` | Validate OAD |
-| `opc dev` | Hot-reload development mode |
-| `opc create <name>` | Create agent from template |
-| `opc deploy` | Deploy to OpenClaw or Hermes |
-| `opc publish` | Package for distribution |
-| `opc install <source>` | Install agent from package |
-| `opc search <query>` | Search OPC Registry |
-| `opc stats` | Show runtime stats |
-| `opc kb add <file>` | Add file to knowledge base |
-| `opc kb search <query>` | Search knowledge base |
-| `opc tool list` | List MCP tools |
-| `opc workflow run <name>` | Run a workflow |
-| `opc version-mgmt list` | List saved versions |
-
-## Common Options
-
-- `-f, --file <file>` — OAD file path (default: `oad.yaml`)
-- `-t, --template <name>` — Template name
-- `-p, --port <port>` — Port override
-- `--json` — JSON output (for test/analytics)
-
-## Examples
-
-```bash
-# Create a new project
-opc init my-bot -t teacher
-
-# Run tests
-opc test --json
-
-# View analytics
-opc analytics
-
-# Deploy
-opc deploy --target openclaw --install
-```
+# CLI Commands
+
+## Reference
+
+| Command | Description |
+|---------|-------------|
+| `opc init [name]` | Initialize a new agent project |
+| `opc run` | Start agent with web server |
+| `opc chat` | Interactive CLI chat |
+| `opc test` | Run agent tests |
+| `opc analytics` | Show usage analytics |
+| `opc info` | Show agent info from OAD |
+| `opc build` | Validate OAD |
+| `opc dev` | Hot-reload development mode |
+| `opc create <name>` | Create agent from template |
+| `opc deploy` | Deploy to OpenClaw or Hermes |
+| `opc publish` | Package for distribution |
+| `opc install <source>` | Install agent from package |
+| `opc search <query>` | Search OPC Registry |
+| `opc stats` | Show runtime stats |
+| `opc kb add <file>` | Add file to knowledge base |
+| `opc kb search <query>` | Search knowledge base |
+| `opc tool list` | List MCP tools |
+| `opc workflow run <name>` | Run a workflow |
+| `opc version-mgmt list` | List saved versions |
+
+## Common Options
+
+- `-f, --file <file>` — OAD file path (default: `oad.yaml`)
+- `-t, --template <name>` — Template name
+- `-p, --port <port>` — Port override
+- `--json` — JSON output (for test/analytics)
+
+## Examples
+
+```bash
+# Create a new project
+opc init my-bot -t teacher
+
+# Run tests
+opc test --json
+
+# View analytics
+opc analytics
+
+# Deploy
+opc deploy --target openclaw --install
+```