opc-agent 1.4.0 → 2.0.0

package/dist/daemon.js

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Daemon entry point — spawned by `opc start` as a detached background process.
+ * Loads agent.yaml, creates runtime, starts all channels, writes heartbeat.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const runtime_1 = require("./core/runtime");
+const OPC_DIR = path.resolve('.opc');
+const HEARTBEAT_FILE = path.join(OPC_DIR, 'heartbeat');
+const LOG_FILE = path.join(OPC_DIR, 'agent.log');
+const PID_FILE = path.join(OPC_DIR, 'agent.pid');
+const HEARTBEAT_INTERVAL = 30_000;
+function ensureDir(dir) {
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+}
+function log(msg) {
+    const line = `[${new Date().toISOString()}] ${msg}\n`;
+    try {
+        fs.appendFileSync(LOG_FILE, line);
+    }
+    catch { /* ignore */ }
+}
+async function main() {
+    ensureDir(OPC_DIR);
+    // Redirect stdout/stderr to log file
+    const logStream = fs.createWriteStream(LOG_FILE, { flags: 'a' });
+    process.stdout.write = logStream.write.bind(logStream);
+    process.stderr.write = logStream.write.bind(logStream);
+    // Write PID
+    fs.writeFileSync(PID_FILE, String(process.pid));
+    log(`Daemon started, PID=${process.pid}`);
+    // Write start time for uptime calculation
+    fs.writeFileSync(path.join(OPC_DIR, 'started'), String(Date.now()));
+    // Heartbeat
+    const heartbeatTimer = setInterval(() => {
+        try {
+            fs.writeFileSync(HEARTBEAT_FILE, String(Date.now()));
+        }
+        catch { /* ignore */ }
+    }, HEARTBEAT_INTERVAL);
+    fs.writeFileSync(HEARTBEAT_FILE, String(Date.now()));
+    // Load .env
+    const envPath = path.resolve('.env');
+    if (fs.existsSync(envPath)) {
+        try {
+            const content = fs.readFileSync(envPath, 'utf-8');
+            for (const line of content.split('\n')) {
+                const trimmed = line.trim();
+                if (!trimmed || trimmed.startsWith('#'))
+                    continue;
+                const eqIdx = trimmed.indexOf('=');
+                if (eqIdx === -1)
+                    continue;
+                const key = trimmed.slice(0, eqIdx).trim();
+                const value = trimmed.slice(eqIdx + 1).trim();
+                if (!process.env[key])
+                    process.env[key] = value;
+            }
+        }
+        catch { /* ignore */ }
+    }
+    // Determine config file
+    const configFile = fs.existsSync('agent.yaml') ? 'agent.yaml' : 'oad.yaml';
+    const runtime = new runtime_1.AgentRuntime();
+    await runtime.loadConfig(configFile);
+    await runtime.initialize();
+    await runtime.start();
+    log(`Agent running (config=${configFile})`);
+    // Graceful shutdown
+    const shutdown = async (signal) => {
+        log(`Received ${signal}, shutting down...`);
+        clearInterval(heartbeatTimer);
+        await runtime.stop();
+        try {
+            fs.unlinkSync(PID_FILE);
+        }
+        catch { /* ignore */ }
+        log('Daemon stopped');
+        process.exit(0);
+    };
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+    process.on('SIGINT', () => shutdown('SIGINT'));
+    // On Windows, handle the message-based kill
+    process.on('message', (msg) => {
+        if (msg === 'shutdown')
+            shutdown('message:shutdown');
+    });
+}
+main().catch((err) => {
+    log(`Fatal error: ${err instanceof Error ? err.message : String(err)}`);
+    try {
+        fs.unlinkSync(PID_FILE);
+    }
+    catch { /* ignore */ }
+    process.exit(1);
+});
+//# sourceMappingURL=daemon.js.map

package/dist/index.d.ts

@@ -65,6 +65,8 @@ export { SchedulerSkill } from './skills/scheduler';
 export type { ScheduledTask } from './skills/scheduler';
 export { DocumentSkill } from './skills/document';
 export type { DocumentChunk } from './skills/document';
+export { SkillLearner, skillToMarkdown, parseSkillMarkdown } from './skills/auto-learn';
+export type { LearnedSkill } from './skills/auto-learn';
 export { runTests, loadTestCases, formatReport } from './testing';
 export type { TestCase, TestResult, TestReport } from './testing';
 export { AnalyticsEngine } from './core/analytics-engine';
@@ -92,4 +94,9 @@ export { StreamingManager, StreamableResponse } from './core/streaming';
 export type { StreamChunk, StreamOptions } from './core/streaming';
 export { TraceCollector, ConsoleExporter, DeepBrainExporter } from './traces';
 export type { Span, SpanEvent, TraceExporter } from './traces';
+export { Scheduler, parseCron, cronMatches } from './core/scheduler';
+export type { CronJob, JobHandler } from './core/scheduler';
+export { getBuiltinTools, getBuiltinToolsByName } from './tools/builtin';
+export { MCPClient } from './tools/mcp-client';
+export type { MCPServerConfig } from './tools/mcp-client';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.JsonTransformTool = exports.DateTimeTool = exports.CalculatorTool = exports.WeChatChannel = exports.SlackChannel = exports.EmailChannel = exports.compose = exports.AgentPipeline = exports.Orchestrator = exports.getActiveSessions = exports.createAuthMiddleware = exports.deployToHermes = exports.KnowledgeBase = exports.addMessages = exports.detectLocale = exports.getLocale = exports.setLocale = exports.t = exports.LazyLoader = exports.RequestBatcher = exports.ConnectionPool = exports.VersionManager = exports.WebhookChannel = exports.VoiceChannel = exports.HITLManager = exports.AgentRegistry = exports.WorkflowEngine = exports.Analytics = exports.Sandbox = exports.PluginManager = exports.createMCPTool = exports.MCPToolRegistry = exports.Room = exports.SUPPORTED_PROVIDERS = exports.createProvider = exports.DeepBrainMemoryStore = exports.InMemoryStore = exports.SkillRegistry = exports.BaseSkill = exports.WebSocketChannel = exports.TelegramChannel = exports.WebChannel = exports.BaseChannel = exports.OADSchema = exports.validateOAD = exports.loadOAD = exports.Logger = exports.truncateOutput = exports.AgentRuntime = exports.BaseAgent = void 0;
-exports.DeepBrainExporter = exports.ConsoleExporter = exports.TraceCollector = exports.StreamableResponse = exports.StreamingManager = exports.ToolGateway = exports.ProcessWatcher = exports.DiscordChannel = exports.FeishuChannel = exports.createRateLimitPlugin = exports.createAnalyticsPlugin = exports.createLoggingPlugin = exports.inputValidation = exports.APIKeyManager = exports.corsMiddleware = exports.securityHeaders = exports.detectInjection = exports.sanitizeInput = exports.formatErrorForUser = exports.wrapError = exports.TimeoutError = exports.SecurityError = exports.RateLimitError = exports.PluginError = exports.ChannelError = exports.ConfigError = exports.ValidationError = exports.ProviderError = exports.OPCError = exports.createTeacherConfig = exports.createDataAnalystConfig = exports.getSupportedLocales = exports.LLMCache = exports.RateLimiter = exports.AnalyticsEngine = exports.formatReport = exports.loadTestCases = exports.runTests = exports.DocumentSkill = exports.SchedulerSkill = exports.WebhookTriggerSkill = exports.HttpSkill = exports.TextAnalysisTool = void 0;
+exports.getBuiltinTools = exports.cronMatches = exports.parseCron = exports.Scheduler = exports.DeepBrainExporter = exports.ConsoleExporter = exports.TraceCollector = exports.StreamableResponse = exports.StreamingManager = exports.ToolGateway = exports.ProcessWatcher = exports.DiscordChannel = exports.FeishuChannel = exports.createRateLimitPlugin = exports.createAnalyticsPlugin = exports.createLoggingPlugin = exports.inputValidation = exports.APIKeyManager = exports.corsMiddleware = exports.securityHeaders = exports.detectInjection = exports.sanitizeInput = exports.formatErrorForUser = exports.wrapError = exports.TimeoutError = exports.SecurityError = exports.RateLimitError = exports.PluginError = exports.ChannelError = exports.ConfigError = exports.ValidationError = exports.ProviderError = exports.OPCError = exports.createTeacherConfig = exports.createDataAnalystConfig = exports.getSupportedLocales = exports.LLMCache = exports.RateLimiter = exports.AnalyticsEngine = exports.formatReport = exports.loadTestCases = exports.runTests = exports.parseSkillMarkdown = exports.skillToMarkdown = exports.SkillLearner = exports.DocumentSkill = exports.SchedulerSkill = exports.WebhookTriggerSkill = exports.HttpSkill = exports.TextAnalysisTool = void 0;
+exports.MCPClient = exports.getBuiltinToolsByName = void 0;
 // OPC Agent — Open Agent Framework
 var agent_1 = require("./core/agent");
 Object.defineProperty(exports, "BaseAgent", { enumerable: true, get: function () { return agent_1.BaseAgent; } });
@@ -106,6 +107,10 @@ var scheduler_1 = require("./skills/scheduler");
 Object.defineProperty(exports, "SchedulerSkill", { enumerable: true, get: function () { return scheduler_1.SchedulerSkill; } });
 var document_1 = require("./skills/document");
 Object.defineProperty(exports, "DocumentSkill", { enumerable: true, get: function () { return document_1.DocumentSkill; } });
+var auto_learn_1 = require("./skills/auto-learn");
+Object.defineProperty(exports, "SkillLearner", { enumerable: true, get: function () { return auto_learn_1.SkillLearner; } });
+Object.defineProperty(exports, "skillToMarkdown", { enumerable: true, get: function () { return auto_learn_1.skillToMarkdown; } });
+Object.defineProperty(exports, "parseSkillMarkdown", { enumerable: true, get: function () { return auto_learn_1.parseSkillMarkdown; } });
 // v0.9.0 modules
 var testing_1 = require("./testing");
 Object.defineProperty(exports, "runTests", { enumerable: true, get: function () { return testing_1.runTests; } });
@@ -165,4 +170,15 @@ var traces_1 = require("./traces");
 Object.defineProperty(exports, "TraceCollector", { enumerable: true, get: function () { return traces_1.TraceCollector; } });
 Object.defineProperty(exports, "ConsoleExporter", { enumerable: true, get: function () { return traces_1.ConsoleExporter; } });
 Object.defineProperty(exports, "DeepBrainExporter", { enumerable: true, get: function () { return traces_1.DeepBrainExporter; } });
+// v1.4.0 modules
+var scheduler_2 = require("./core/scheduler");
+Object.defineProperty(exports, "Scheduler", { enumerable: true, get: function () { return scheduler_2.Scheduler; } });
+Object.defineProperty(exports, "parseCron", { enumerable: true, get: function () { return scheduler_2.parseCron; } });
+Object.defineProperty(exports, "cronMatches", { enumerable: true, get: function () { return scheduler_2.cronMatches; } });
+// v1.5.0 — built-in tools + MCP client
+var builtin_1 = require("./tools/builtin");
+Object.defineProperty(exports, "getBuiltinTools", { enumerable: true, get: function () { return builtin_1.getBuiltinTools; } });
+Object.defineProperty(exports, "getBuiltinToolsByName", { enumerable: true, get: function () { return builtin_1.getBuiltinToolsByName; } });
+var mcp_client_1 = require("./tools/mcp-client");
+Object.defineProperty(exports, "MCPClient", { enumerable: true, get: function () { return mcp_client_1.MCPClient; } });
 //# sourceMappingURL=index.js.map

package/dist/providers/index.d.ts

@@ -1,7 +1,11 @@
 import type { Message } from '../core/types';
+import type { MCPToolDefinition } from '../tools/mcp';
+export interface ChatOptions {
+    tools?: MCPToolDefinition[];
+}
 export interface LLMProvider {
     name: string;
-    chat(messages: Message[], systemPrompt?: string): Promise<string>;
+    chat(messages: Message[], systemPrompt?: string, options?: ChatOptions): Promise<string>;
     chatStream(messages: Message[], systemPrompt?: string): AsyncIterable<string>;
 }
 export declare function createProvider(name?: string, model?: string, baseUrl?: string, apiKey?: string): LLMProvider;

package/dist/providers/index.js

@@ -43,6 +43,10 @@ function getApiKey() {
 function getBaseUrl() {
     return process.env.OPC_LLM_BASE_URL || 'https://api.openai.com/v1';
 }
+function buildToolPrompt(tools) {
+    const toolsDesc = tools.map(t => `- ${t.name}: ${t.description}\n  Input schema: ${JSON.stringify(t.inputSchema)}`).join('\n');
+    return `\n\nYou have access to the following tools. To use a tool, respond with ONLY a JSON object in this format:\n<tool_call>{"name": "tool_name", "arguments": {...}}</tool_call>\n\nAvailable tools:\n${toolsDesc}\n\nIf you don't need a tool, respond normally with text.`;
+}
 class OpenAICompatibleProvider {
     name;
     model;
@@ -111,13 +115,16 @@ class OpenAICompatibleProvider {
             req.end();
         });
     }
-    async chat(messages, systemPrompt) {
+    async chat(messages, systemPrompt, options) {
         if (!this.apiKey) {
-            // Stub mode when no API key
             const last = messages[messages.length - 1];
             return `[${this.name}/${this.model} - no API key] Echo: ${last?.content ?? ''}`;
         }
-        const formatted = this.formatMessages(messages, systemPrompt);
+        let effectivePrompt = systemPrompt;
+        if (options?.tools && options.tools.length > 0) {
+            effectivePrompt = (systemPrompt || '') + buildToolPrompt(options.tools);
+        }
+        const formatted = this.formatMessages(messages, effectivePrompt);
         const result = await this.request({
             model: this.model,
             messages: formatted,
@@ -220,12 +227,16 @@ class GeminiNativeProvider {
         }
         return result;
     }
-    async chat(messages, systemPrompt) {
+    async chat(messages, systemPrompt, options) {
         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);
+        let effectivePrompt = systemPrompt;
+        if (options?.tools && options.tools.length > 0) {
+            effectivePrompt = (systemPrompt || '') + buildToolPrompt(options.tools);
+        }
+        const body = this.formatContents(messages, effectivePrompt);
         const url = this.buildUrl(false);
         const postData = JSON.stringify(body);
         return new Promise((resolve, reject) => {
@@ -310,12 +321,10 @@ class GeminiNativeProvider {
 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';
-    // Auto-detect ollama: use localhost:11434/v1 and dummy apiKey
     if (name === 'ollama') {
         const ollamaBase = baseUrl || process.env.OPC_LLM_BASE_URL || 'http://localhost:11434/v1';
         const ollamaKey = apiKey || process.env.OPC_LLM_API_KEY || 'ollama';
@@ -323,11 +332,9 @@ function createProvider(name = 'openai', model, baseUrl, apiKey) {
     }
     const finalKey = apiKey || getApiKey();
     const finalBaseUrl = baseUrl || getBaseUrl();
-    // Auto-detect Gemini native when key is new format or base URL points to googleapis
     if (finalKey.startsWith('AQ.') || isGeminiNative()) {
         return new GeminiNativeProvider(finalModel, finalKey);
     }
-    // Auto-detect provider name from base URL
     let resolvedName = name;
     if (finalBaseUrl.includes('deepseek.com')) {
         resolvedName = 'deepseek';

package/dist/schema/oad.d.ts

@@ -286,6 +286,57 @@ export declare const StreamingSchema: z.ZodObject<{
     enabled?: boolean | undefined;
     chunkSize?: number | undefined;
 }>;
+export declare const MCPServerSchema: z.ZodObject<{
+    name: z.ZodString;
+    command: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    command: string;
+    args?: string[] | undefined;
+    env?: Record<string, string> | undefined;
+}, {
+    name: string;
+    command: string;
+    args?: string[] | undefined;
+    env?: Record<string, string> | undefined;
+}>;
+export declare const ToolsSchema: z.ZodObject<{
+    builtin: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    mcp: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }, {
+        name: string;
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    builtin?: string[] | undefined;
+    mcp?: {
+        name: string;
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }[] | undefined;
+}, {
+    builtin?: string[] | undefined;
+    mcp?: {
+        name: string;
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }[] | undefined;
+}>;
 export declare const SpecSchema: z.ZodObject<{
     provider: z.ZodOptional<z.ZodObject<{
         default: z.ZodDefault<z.ZodString>;
@@ -358,6 +409,41 @@ export declare const SpecSchema: z.ZodObject<{
             collection?: string | undefined;
         } | undefined;
     }>>;
+    tools: z.ZodOptional<z.ZodObject<{
+        builtin: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        mcp: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            command: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        }, {
+            name: string;
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        builtin?: string[] | undefined;
+        mcp?: {
+            name: string;
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        }[] | undefined;
+    }, {
+        builtin?: string[] | undefined;
+        mcp?: {
+            name: string;
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        }[] | undefined;
+    }>>;
     dtv: z.ZodOptional<z.ZodObject<{
         trust: z.ZodOptional<z.ZodObject<{
             level: z.ZodDefault<z.ZodEnum<["sandbox", "verified", "certified", "listed"]>>;
@@ -515,6 +601,15 @@ export declare const SpecSchema: z.ZodObject<{
         enabled: boolean;
         chunkSize?: number | undefined;
     };
+    tools?: {
+        builtin?: string[] | undefined;
+        mcp?: {
+            name: string;
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        }[] | undefined;
+    } | undefined;
     auth?: {
         enabled: boolean;
         apiKeys: string[];
@@ -577,6 +672,15 @@ export declare const SpecSchema: z.ZodObject<{
         config?: Record<string, unknown> | undefined;
     }[] | undefined;
 }, {
+    tools?: {
+        builtin?: string[] | undefined;
+        mcp?: {
+            name: string;
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        }[] | undefined;
+    } | undefined;
     model?: string | undefined;
     auth?: {
         enabled?: boolean | undefined;
@@ -776,6 +880,41 @@ export declare const OADSchema: z.ZodObject<{
                 collection?: string | undefined;
             } | undefined;
         }>>;
+        tools: z.ZodOptional<z.ZodObject<{
+            builtin: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            mcp: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                command: z.ZodString;
+                args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                command: string;
+                args?: string[] | undefined;
+                env?: Record<string, string> | undefined;
+            }, {
+                name: string;
+                command: string;
+                args?: string[] | undefined;
+                env?: Record<string, string> | undefined;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            builtin?: string[] | undefined;
+            mcp?: {
+                name: string;
+                command: string;
+                args?: string[] | undefined;
+                env?: Record<string, string> | undefined;
+            }[] | undefined;
+        }, {
+            builtin?: string[] | undefined;
+            mcp?: {
+                name: string;
+                command: string;
+                args?: string[] | undefined;
+                env?: Record<string, string> | undefined;
+            }[] | undefined;
+        }>>;
         dtv: z.ZodOptional<z.ZodObject<{
             trust: z.ZodOptional<z.ZodObject<{
                 level: z.ZodDefault<z.ZodEnum<["sandbox", "verified", "certified", "listed"]>>;
@@ -933,6 +1072,15 @@ export declare const OADSchema: z.ZodObject<{
             enabled: boolean;
             chunkSize?: number | undefined;
         };
+        tools?: {
+            builtin?: string[] | undefined;
+            mcp?: {
+                name: string;
+                command: string;
+                args?: string[] | undefined;
+                env?: Record<string, string> | undefined;
+            }[] | undefined;
+        } | undefined;
         auth?: {
             enabled: boolean;
             apiKeys: string[];
@@ -995,6 +1143,15 @@ export declare const OADSchema: z.ZodObject<{
             config?: Record<string, unknown> | undefined;
         }[] | undefined;
     }, {
+        tools?: {
+            builtin?: string[] | undefined;
+            mcp?: {
+                name: string;
+                command: string;
+                args?: string[] | undefined;
+                env?: Record<string, string> | undefined;
+            }[] | undefined;
+        } | undefined;
         model?: string | undefined;
         auth?: {
             enabled?: boolean | undefined;
@@ -1073,8 +1230,6 @@ export declare const OADSchema: z.ZodObject<{
         }[] | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
-    apiVersion: "opc/v1";
-    kind: "Agent";
     metadata: {
         name: string;
         version: string;
@@ -1088,6 +1243,8 @@ export declare const OADSchema: z.ZodObject<{
             tags?: string[] | undefined;
         } | undefined;
     };
+    apiVersion: "opc/v1";
+    kind: "Agent";
     spec: {
         model: string;
         skills: {
@@ -1104,6 +1261,15 @@ export declare const OADSchema: z.ZodObject<{
             enabled: boolean;
             chunkSize?: number | undefined;
         };
+        tools?: {
+            builtin?: string[] | undefined;
+            mcp?: {
+                name: string;
+                command: string;
+                args?: string[] | undefined;
+                env?: Record<string, string> | undefined;
+            }[] | undefined;
+        } | undefined;
         auth?: {
             enabled: boolean;
             apiKeys: string[];
@@ -1167,8 +1333,6 @@ export declare const OADSchema: z.ZodObject<{
         }[] | undefined;
     };
 }, {
-    apiVersion: "opc/v1";
-    kind: "Agent";
     metadata: {
         name: string;
         description?: string | undefined;
@@ -1182,7 +1346,18 @@ export declare const OADSchema: z.ZodObject<{
             tags?: string[] | undefined;
         } | undefined;
     };
+    apiVersion: "opc/v1";
+    kind: "Agent";
     spec: {
+        tools?: {
+            builtin?: string[] | undefined;
+            mcp?: {
+                name: string;
+                command: string;
+                args?: string[] | undefined;
+                env?: Record<string, string> | undefined;
+            }[] | undefined;
+        } | undefined;
         model?: string | undefined;
         auth?: {
             enabled?: boolean | undefined;

package/dist/schema/oad.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OADSchema = exports.SpecSchema = exports.StreamingSchema = exports.RoomSchema = exports.MetadataSchema = exports.MarketplaceSchema = exports.ProviderSchema = exports.DTVSchema = exports.TrustLevel = exports.MemorySchema = exports.LongTermMemorySchema = exports.ChannelSchema = exports.AuthSchema = exports.PluginRefSchema = exports.HITLSchema = exports.WebhookSchema = exports.VoiceSchema = exports.WorkflowSchema = exports.WorkflowStepSchema = exports.SkillRefSchema = void 0;
+exports.OADSchema = exports.SpecSchema = exports.ToolsSchema = exports.MCPServerSchema = exports.StreamingSchema = exports.RoomSchema = exports.MetadataSchema = exports.MarketplaceSchema = exports.ProviderSchema = exports.DTVSchema = exports.TrustLevel = exports.MemorySchema = exports.LongTermMemorySchema = exports.ChannelSchema = exports.AuthSchema = exports.PluginRefSchema = exports.HITLSchema = exports.WebhookSchema = exports.VoiceSchema = exports.WorkflowSchema = exports.WorkflowStepSchema = exports.SkillRefSchema = void 0;
 const zod_1 = require("zod");
 // ─── OAD Schema v1 ───────────────────────────────────────────
 exports.SkillRefSchema = zod_1.z.object({
@@ -103,6 +103,16 @@ exports.StreamingSchema = zod_1.z.object({
     enabled: zod_1.z.boolean().default(false),
     chunkSize: zod_1.z.number().optional(),
 });
+exports.MCPServerSchema = zod_1.z.object({
+    name: zod_1.z.string(),
+    command: zod_1.z.string(),
+    args: zod_1.z.array(zod_1.z.string()).optional(),
+    env: zod_1.z.record(zod_1.z.string()).optional(),
+});
+exports.ToolsSchema = zod_1.z.object({
+    builtin: zod_1.z.array(zod_1.z.string()).optional(),
+    mcp: zod_1.z.array(exports.MCPServerSchema).optional(),
+});
 exports.SpecSchema = zod_1.z.object({
     provider: exports.ProviderSchema.optional(),
     model: zod_1.z.string().default('deepseek-chat'),
@@ -110,6 +120,7 @@ exports.SpecSchema = zod_1.z.object({
     skills: zod_1.z.array(exports.SkillRefSchema).default([]),
     channels: zod_1.z.array(exports.ChannelSchema).default([]),
     memory: exports.MemorySchema.optional(),
+    tools: exports.ToolsSchema.optional(),
     dtv: exports.DTVSchema.optional(),
     room: exports.RoomSchema.optional(),
     streaming: zod_1.z.union([zod_1.z.boolean(), exports.StreamingSchema]).default(false),

package/dist/skills/auto-learn.d.ts

@@ -0,0 +1,28 @@
+import type { Message } from '../core/types';
+import type { LLMProvider } from '../providers';
+export interface LearnedSkill {
+    name: string;
+    description: string;
+    trigger: string;
+    instructions: string;
+    examples: string[];
+    createdAt: Date;
+    usageCount: number;
+    lastUsed?: Date;
+    version: number;
+}
+export declare class SkillLearner {
+    private skillsDir;
+    private skills;
+    private loaded;
+    constructor(skillsDir: string);
+    analyzeForSkillCreation(conversation: Message[], provider: LLMProvider): Promise<LearnedSkill | null>;
+    saveSkill(skill: LearnedSkill): Promise<void>;
+    loadLearnedSkills(): Promise<LearnedSkill[]>;
+    matchSkill(message: string): LearnedSkill | null;
+    improveSkill(skill: LearnedSkill, conversation: Message[], provider: LLMProvider): Promise<void>;
+    getSkills(): LearnedSkill[];
+}
+export declare function skillToMarkdown(skill: LearnedSkill): string;
+export declare function parseSkillMarkdown(content: string): LearnedSkill | null;
+//# sourceMappingURL=auto-learn.d.ts.map