opc-agent 1.1.3 → 1.2.1

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/dist/tools/gateway.d.ts

@@ -0,0 +1,28 @@
+import type { MCPTool, MCPToolDefinition, MCPToolResult } from './mcp';
+export interface ToolGatewayConfig {
+    enabled: boolean;
+    endpoint: string;
+    apiKey: string;
+    enabledTools?: GatewayToolName[];
+    timeout?: number;
+}
+export type GatewayToolName = 'web-search' | 'image-gen' | 'tts' | 'browser';
+export declare class ToolGateway {
+    private config;
+    private availableTools;
+    private connected;
+    constructor(config: ToolGatewayConfig);
+    /** Discover available tools from the gateway endpoint. */
+    connect(): Promise<void>;
+    /** Load default tool definitions (used as fallback). */
+    private loadDefaults;
+    /** Invoke a tool through the gateway. */
+    invokeTool(name: GatewayToolName, input: Record<string, unknown>): Promise<MCPToolResult>;
+    /** Get all gateway tools as MCPTool instances for registry integration. */
+    getTools(): MCPTool[];
+    /** Get tool definitions (without execute). */
+    listTools(): MCPToolDefinition[];
+    get isConnected(): boolean;
+    get toolCount(): number;
+}
+//# sourceMappingURL=gateway.d.ts.map

package/dist/tools/gateway.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolGateway = void 0;
+// ─── Gateway Tool Wrapper ────────────────────────────────────
+class GatewayTool {
+    gateway;
+    meta;
+    name;
+    description;
+    inputSchema;
+    constructor(gateway, meta) {
+        this.gateway = gateway;
+        this.meta = meta;
+        this.name = `gateway:${meta.name}`;
+        this.description = `[Gateway] ${meta.description}`;
+        this.inputSchema = meta.inputSchema;
+    }
+    async execute(input, _context) {
+        return this.gateway.invokeTool(this.meta.name, input);
+    }
+}
+// ─── Default Tool Definitions ────────────────────────────────
+const DEFAULT_TOOL_DEFS = [
+    {
+        name: 'web-search',
+        description: 'Search the web and return results',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Search query' },
+                count: { type: 'number', description: 'Number of results (1-10)' },
+            },
+            required: ['query'],
+        },
+        available: true,
+    },
+    {
+        name: 'image-gen',
+        description: 'Generate images from text prompts',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                prompt: { type: 'string', description: 'Image generation prompt' },
+                size: { type: 'string', description: 'Image size (e.g. 1024x1024)' },
+            },
+            required: ['prompt'],
+        },
+        available: true,
+    },
+    {
+        name: 'tts',
+        description: 'Convert text to speech audio',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                text: { type: 'string', description: 'Text to synthesize' },
+                voice: { type: 'string', description: 'Voice identifier' },
+            },
+            required: ['text'],
+        },
+        available: true,
+    },
+    {
+        name: 'browser',
+        description: 'Automated browser actions — navigate, screenshot, extract content',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: { type: 'string', description: 'Action: navigate | screenshot | extract' },
+                url: { type: 'string', description: 'Target URL' },
+                selector: { type: 'string', description: 'CSS selector for extraction' },
+            },
+            required: ['action', 'url'],
+        },
+        available: true,
+    },
+];
+// ─── ToolGateway ─────────────────────────────────────────────
+class ToolGateway {
+    config;
+    availableTools = new Map();
+    connected = false;
+    constructor(config) {
+        this.config = {
+            timeout: 30_000,
+            ...config,
+        };
+    }
+    /** Discover available tools from the gateway endpoint. */
+    async connect() {
+        if (!this.config.enabled)
+            return;
+        try {
+            const res = await fetch(`${this.config.endpoint}/tools`, {
+                headers: { Authorization: `Bearer ${this.config.apiKey}` },
+                signal: AbortSignal.timeout(this.config.timeout),
+            });
+            if (!res.ok) {
+                throw new Error(`Gateway returned ${res.status}`);
+            }
+            const data = (await res.json());
+            const enabledSet = this.config.enabledTools
+                ? new Set(this.config.enabledTools)
+                : null;
+            for (const tool of data.tools) {
+                if (!enabledSet || enabledSet.has(tool.name)) {
+                    this.availableTools.set(tool.name, tool);
+                }
+            }
+            this.connected = true;
+        }
+        catch {
+            // Auto-detect failed — fall back to default definitions
+            this.loadDefaults();
+            this.connected = false;
+        }
+    }
+    /** Load default tool definitions (used as fallback). */
+    loadDefaults() {
+        const enabledSet = this.config.enabledTools
+            ? new Set(this.config.enabledTools)
+            : null;
+        for (const def of DEFAULT_TOOL_DEFS) {
+            if (!enabledSet || enabledSet.has(def.name)) {
+                this.availableTools.set(def.name, def);
+            }
+        }
+    }
+    /** Invoke a tool through the gateway. */
+    async invokeTool(name, input) {
+        try {
+            const res = await fetch(`${this.config.endpoint}/tools/${name}/invoke`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.config.apiKey}`,
+                },
+                body: JSON.stringify({ input }),
+                signal: AbortSignal.timeout(this.config.timeout),
+            });
+            if (!res.ok) {
+                return { content: `Gateway error: HTTP ${res.status}`, isError: true };
+            }
+            const data = (await res.json());
+            if (data.error) {
+                return { content: data.error, isError: true, metadata: data.metadata };
+            }
+            return { content: data.content, metadata: data.metadata };
+        }
+        catch (err) {
+            return {
+                content: `Gateway invocation failed: ${err instanceof Error ? err.message : String(err)}`,
+                isError: true,
+            };
+        }
+    }
+    /** Get all gateway tools as MCPTool instances for registry integration. */
+    getTools() {
+        return Array.from(this.availableTools.values()).map((meta) => new GatewayTool(this, meta));
+    }
+    /** Get tool definitions (without execute). */
+    listTools() {
+        return Array.from(this.availableTools.values()).map(({ name, description, inputSchema }) => ({
+            name: `gateway:${name}`,
+            description: `[Gateway] ${description}`,
+            inputSchema,
+        }));
+    }
+    get isConnected() {
+        return this.connected;
+    }
+    get toolCount() {
+        return this.availableTools.size;
+    }
+}
+exports.ToolGateway = ToolGateway;
+//# sourceMappingURL=gateway.js.map

package/docs/.vitepress/config.ts

@@ -1,103 +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',
-      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 跃盟科技',
-    },
-  },
-});
+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
+```

package/docs/api/oad-schema.md

@@ -1,64 +1,64 @@
-# OAD Schema v1 Specification
-
-**OAD** (Open Agent Definition) is a declarative YAML/JSON format for defining AI agents.
-
-## Full Schema
-
-```yaml
-apiVersion: opc/v1          # Required. Must be "opc/v1"
-kind: Agent                  # Required. Must be "Agent"
-
-metadata:
-  name: string               # Required. Agent identifier
-  version: string            # Semver. Default: "1.0.0"
-  description: string        # Optional. Human-readable description
-  author: string             # Optional. Author name
-  license: string            # Default: "Apache-2.0"
-  marketplace:               # Optional. Marketplace settings
-    certified: boolean       # Default: false
-    category: string         # e.g., "customer-service"
-
-spec:
-  provider:                  # LLM provider configuration
-    default: string          # Default provider. Default: "deepseek"
-    allowed: string[]        # Allowed providers. Default: ["openai", "deepseek", "qwen"]
-  model: string              # Model name. Default: "deepseek-chat"
-  systemPrompt: string       # System prompt for the agent
-
-  skills:                    # List of skills
-    - name: string           # Skill identifier
-      description: string    # What the skill does
-      config: object         # Optional skill-specific config
-
-  channels:                  # Communication channels
-    - type: web|websocket|cli
-      port: number           # Port for web channels
-      config: object         # Optional channel config
-
-  memory:
-    shortTerm: boolean       # Enable conversation memory. Default: true
-    longTerm: boolean        # Enable persistent memory. Default: false
-    provider: string         # Memory backend (optional)
-
-  dtv:
-    trust:
-      level: sandbox|verified|certified|listed  # Default: "sandbox"
-    value:
-      metrics: string[]      # Metrics to track. Default: []
-```
-
-## Validation
-
-OAD files are validated using Zod schemas. Use the CLI to validate:
-
-```bash
-opc build -f oad.yaml
-```
-
-Or programmatically:
-
-```typescript
-import { validateOAD } from 'opc-agent';
-
-const config = validateOAD(yamlData);
-```
+# OAD Schema v1 Specification
+
+**OAD** (Open Agent Definition) is a declarative YAML/JSON format for defining AI agents.
+
+## Full Schema
+
+```yaml
+apiVersion: opc/v1          # Required. Must be "opc/v1"
+kind: Agent                  # Required. Must be "Agent"
+
+metadata:
+  name: string               # Required. Agent identifier
+  version: string            # Semver. Default: "1.0.0"
+  description: string        # Optional. Human-readable description
+  author: string             # Optional. Author name
+  license: string            # Default: "Apache-2.0"
+  marketplace:               # Optional. Marketplace settings
+    certified: boolean       # Default: false
+    category: string         # e.g., "customer-service"
+
+spec:
+  provider:                  # LLM provider configuration
+    default: string          # Default provider. Default: "deepseek"
+    allowed: string[]        # Allowed providers. Default: ["openai", "deepseek", "qwen"]
+  model: string              # Model name. Default: "deepseek-chat"
+  systemPrompt: string       # System prompt for the agent
+
+  skills:                    # List of skills
+    - name: string           # Skill identifier
+      description: string    # What the skill does
+      config: object         # Optional skill-specific config
+
+  channels:                  # Communication channels
+    - type: web|websocket|cli
+      port: number           # Port for web channels
+      config: object         # Optional channel config
+
+  memory:
+    shortTerm: boolean       # Enable conversation memory. Default: true
+    longTerm: boolean        # Enable persistent memory. Default: false
+    provider: string         # Memory backend (optional)
+
+  dtv:
+    trust:
+      level: sandbox|verified|certified|listed  # Default: "sandbox"
+    value:
+      metrics: string[]      # Metrics to track. Default: []
+```
+
+## Validation
+
+OAD files are validated using Zod schemas. Use the CLI to validate:
+
+```bash
+opc build -f oad.yaml
+```
+
+Or programmatically:
+
+```typescript
+import { validateOAD } from 'opc-agent';
+
+const config = validateOAD(yamlData);
+```