opc-agent 1.1.1 → 1.1.3

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/providers/index.d.ts

@@ -5,5 +5,5 @@ export interface LLMProvider {
     chatStream(messages: Message[], systemPrompt?: string): AsyncIterable<string>;
 }
 export declare function createProvider(name?: string, model?: string, baseUrl?: string, apiKey?: string): LLMProvider;
-export declare const SUPPORTED_PROVIDERS: readonly ["openai", "deepseek", "qwen"];
+export declare const SUPPORTED_PROVIDERS: readonly ["openai", "deepseek", "qwen", "gemini"];
 //# sourceMappingURL=index.d.ts.map

package/dist/providers/index.js

@@ -69,20 +69,27 @@ class OpenAICompatibleProvider {
             throw new Error('No API key configured. Set OPC_LLM_API_KEY or OPENAI_API_KEY environment variable.');
         }
         const url = new URL(`${this.baseUrl}/chat/completions`);
+        const isGemini = url.hostname.includes('googleapis.com');
+        if (isGemini) {
+            url.searchParams.set('key', this.apiKey);
+        }
         const isHttps = url.protocol === 'https:';
         const lib = isHttps ? https : http;
         const postData = JSON.stringify(body);
+        const headers = {
+            'Content-Type': 'application/json',
+            'Content-Length': String(Buffer.byteLength(postData)),
+        };
+        if (!isGemini) {
+            headers['Authorization'] = `Bearer ${this.apiKey}`;
+        }
         return new Promise((resolve, reject) => {
             const req = lib.request({
                 hostname: url.hostname,
                 port: url.port || (isHttps ? 443 : 80),
-                path: url.pathname,
+                path: url.pathname + url.search,
                 method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    Authorization: `Bearer ${this.apiKey}`,
-                    'Content-Length': Buffer.byteLength(postData),
-                },
+                headers,
             }, (res) => {
                 let data = '';
                 res.on('data', (chunk) => (data += chunk.toString()));
@@ -127,6 +134,10 @@ class OpenAICompatibleProvider {
         }
         const formatted = this.formatMessages(messages, systemPrompt);
         const url = new URL(`${this.baseUrl}/chat/completions`);
+        const isGemini = url.hostname.includes('googleapis.com');
+        if (isGemini) {
+            url.searchParams.set('key', this.apiKey);
+        }
         const isHttps = url.protocol === 'https:';
         const lib = isHttps ? https : http;
         const postData = JSON.stringify({
@@ -136,17 +147,20 @@ class OpenAICompatibleProvider {
             max_tokens: 2048,
             stream: true,
         });
+        const streamHeaders = {
+            'Content-Type': 'application/json',
+            'Content-Length': String(Buffer.byteLength(postData)),
+        };
+        if (!isGemini) {
+            streamHeaders['Authorization'] = `Bearer ${this.apiKey}`;
+        }
         const response = await new Promise((resolve, reject) => {
             const req = lib.request({
                 hostname: url.hostname,
                 port: url.port || (isHttps ? 443 : 80),
-                path: url.pathname,
+                path: url.pathname + url.search,
                 method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    Authorization: `Bearer ${this.apiKey}`,
-                    'Content-Length': Buffer.byteLength(postData),
-                },
+                headers: streamHeaders,
             }, resolve);
             req.on('error', reject);
             req.write(postData);
@@ -183,9 +197,130 @@ class OpenAICompatibleProvider {
         }
     }
 }
+class GeminiNativeProvider {
+    name = 'gemini';
+    model;
+    apiKey;
+    constructor(model, apiKey) {
+        this.model = model;
+        this.apiKey = apiKey || getApiKey();
+    }
+    buildUrl(stream) {
+        const action = stream ? 'streamGenerateContent?alt=sse&' : 'generateContent?';
+        return `https://generativelanguage.googleapis.com/v1beta/models/${this.model}:${action}key=${this.apiKey}`;
+    }
+    formatContents(messages, systemPrompt) {
+        const contents = [];
+        for (const m of messages) {
+            contents.push({ role: m.role === 'assistant' ? 'model' : 'user', parts: [{ text: m.content }] });
+        }
+        const result = { contents };
+        if (systemPrompt) {
+            result.systemInstruction = { parts: [{ text: systemPrompt }] };
+        }
+        return result;
+    }
+    async chat(messages, systemPrompt) {
+        if (!this.apiKey) {
+            const last = messages[messages.length - 1];
+            return `[gemini/${this.model} - no API key] Echo: ${last?.content ?? ''}`;
+        }
+        const body = this.formatContents(messages, systemPrompt);
+        const url = this.buildUrl(false);
+        const postData = JSON.stringify(body);
+        return new Promise((resolve, reject) => {
+            const parsedUrl = new URL(url);
+            const req = https.request({
+                hostname: parsedUrl.hostname,
+                path: parsedUrl.pathname + parsedUrl.search,
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', 'Content-Length': String(Buffer.byteLength(postData)) },
+            }, (res) => {
+                let data = '';
+                res.on('data', (chunk) => (data += chunk.toString()));
+                res.on('end', () => {
+                    if (res.statusCode && res.statusCode >= 400) {
+                        reject(new Error(`Gemini API error ${res.statusCode}: ${data}`));
+                        return;
+                    }
+                    try {
+                        const parsed = JSON.parse(data);
+                        resolve(parsed.candidates?.[0]?.content?.parts?.[0]?.text ?? '');
+                    }
+                    catch {
+                        reject(new Error(`Invalid Gemini response: ${data.slice(0, 200)}`));
+                    }
+                });
+            });
+            req.on('error', reject);
+            req.write(postData);
+            req.end();
+        });
+    }
+    async *chatStream(messages, systemPrompt) {
+        if (!this.apiKey) {
+            const last = messages[messages.length - 1];
+            yield `[gemini/${this.model} - no API key] Echo: ${last?.content ?? ''}`;
+            return;
+        }
+        const body = this.formatContents(messages, systemPrompt);
+        const url = this.buildUrl(true);
+        const postData = JSON.stringify(body);
+        const parsedUrl = new URL(url);
+        const response = await new Promise((resolve, reject) => {
+            const req = https.request({
+                hostname: parsedUrl.hostname,
+                path: parsedUrl.pathname + parsedUrl.search,
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', 'Content-Length': String(Buffer.byteLength(postData)) },
+            }, resolve);
+            req.on('error', reject);
+            req.write(postData);
+            req.end();
+        });
+        if (response.statusCode && response.statusCode >= 400) {
+            let data = '';
+            for await (const chunk of response)
+                data += chunk.toString();
+            throw new Error(`Gemini API error ${response.statusCode}: ${data}`);
+        }
+        let buffer = '';
+        for await (const chunk of response) {
+            buffer += chunk.toString();
+            const lines = buffer.split('\n');
+            buffer = lines.pop() ?? '';
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed.startsWith('data: '))
+                    continue;
+                const data = trimmed.slice(6);
+                if (data === '[DONE]')
+                    return;
+                try {
+                    const parsed = JSON.parse(data);
+                    const text = parsed.candidates?.[0]?.content?.parts?.[0]?.text;
+                    if (text)
+                        yield text;
+                }
+                catch { }
+            }
+        }
+    }
+}
+function isGeminiNative() {
+    const baseUrl = process.env.OPC_LLM_BASE_URL || '';
+    const key = getApiKey();
+    // Use native Gemini API when: key starts with AQ. (new format) OR base URL points to googleapis
+    return key.startsWith('AQ.') || (baseUrl.includes('googleapis.com') && !baseUrl.includes('/openai'));
+}
 function createProvider(name = 'openai', model, baseUrl, apiKey) {
     const finalModel = model || process.env.OPC_LLM_MODEL || 'gpt-4o-mini';
+    const finalKey = apiKey || getApiKey();
+    // Auto-detect Gemini native when key is new format
+    if (finalKey.startsWith('AQ.') || isGeminiNative()) {
+        return new GeminiNativeProvider(finalModel, finalKey);
+    }
     return new OpenAICompatibleProvider(name, finalModel, baseUrl, apiKey);
 }
-exports.SUPPORTED_PROVIDERS = ['openai', 'deepseek', 'qwen'];
+exports.SUPPORTED_PROVIDERS = ['openai', 'deepseek', 'qwen', 'gemini'];
 //# sourceMappingURL=index.js.map

package/dist/schema/oad.d.ts

@@ -577,6 +577,7 @@ export declare const SpecSchema: z.ZodObject<{
         config?: Record<string, unknown> | undefined;
     }[] | undefined;
 }, {
+    model?: string | undefined;
     auth?: {
         enabled?: boolean | undefined;
         apiKeys?: string[] | undefined;
@@ -597,7 +598,6 @@ export declare const SpecSchema: z.ZodObject<{
         default?: string | undefined;
         allowed?: string[] | undefined;
     } | undefined;
-    model?: string | undefined;
     systemPrompt?: string | undefined;
     skills?: {
         name: string;
@@ -995,6 +995,7 @@ export declare const OADSchema: z.ZodObject<{
             config?: Record<string, unknown> | undefined;
         }[] | undefined;
     }, {
+        model?: string | undefined;
         auth?: {
             enabled?: boolean | undefined;
             apiKeys?: string[] | undefined;
@@ -1015,7 +1016,6 @@ export declare const OADSchema: z.ZodObject<{
             default?: string | undefined;
             allowed?: string[] | undefined;
         } | undefined;
-        model?: string | undefined;
         systemPrompt?: string | undefined;
         skills?: {
             name: string;
@@ -1183,6 +1183,7 @@ export declare const OADSchema: z.ZodObject<{
         } | undefined;
     };
     spec: {
+        model?: string | undefined;
         auth?: {
             enabled?: boolean | undefined;
             apiKeys?: string[] | undefined;
@@ -1203,7 +1204,6 @@ export declare const OADSchema: z.ZodObject<{
             default?: string | undefined;
             allowed?: string[] | undefined;
         } | undefined;
-        model?: string | undefined;
         systemPrompt?: string | undefined;
         skills?: {
             name: string;

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