npm - opc-agent - Versions diffs - 0.6.0 → 0.7.0 - Mend

opc-agent 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (26) hide show

package/dist/channels/web.d.ts +7 -1
package/dist/channels/web.js +165 -4
package/dist/core/auth.d.ts +13 -0
package/dist/core/auth.js +41 -0
package/dist/index.d.ts +9 -0
package/dist/index.js +13 -1
package/dist/schema/oad.d.ts +69 -0
package/dist/schema/oad.js +7 -1
package/dist/skills/document.d.ts +27 -0
package/dist/skills/document.js +80 -0
package/dist/skills/http.d.ts +8 -0
package/dist/skills/http.js +34 -0
package/dist/skills/scheduler.d.ts +21 -0
package/dist/skills/scheduler.js +70 -0
package/dist/skills/webhook-trigger.d.ts +17 -0
package/dist/skills/webhook-trigger.js +49 -0
package/package.json +1 -1
package/src/channels/web.ts +175 -4
package/src/core/auth.ts +57 -0
package/src/index.ts +11 -0
package/src/schema/oad.ts +7 -0
package/src/skills/document.ts +100 -0
package/src/skills/http.ts +35 -0
package/src/skills/scheduler.ts +80 -0
package/src/skills/webhook-trigger.ts +59 -0
package/tests/v070.test.ts +76 -0

package/dist/channels/web.d.ts CHANGED Viewed

@@ -1,6 +1,7 @@
 import { type Response } from 'express';
 import type { Message } from '../core/types';
 import { BaseChannel } from './index';
+import { type AuthConfig } from '../core/auth';
 export declare class WebChannel extends BaseChannel {
     readonly type = "web";
     private app;
@@ -11,11 +12,16 @@ export declare class WebChannel extends BaseChannel {
     private currentProvider;
     private stats;
     private eventHandlers;
+    private conversations;
+    private requestCount;
+    private llmLatencySum;
+    private llmCalls;
     private emit;
     onConfigChange(handler: (config: any) => void): void;
     trackMessage(responseMs: number, tokens?: number): void;
+    trackError(): void;
     trackSession(): void;
-    constructor(port?: number);
+    constructor(port?: number, authConfig?: AuthConfig);
     setAgentName(name: string): void;
     onStreamMessage(handler: (msg: Message, res: Response) => Promise<void>): void;
     private setupRoutes;

package/dist/channels/web.js CHANGED Viewed

@@ -7,6 +7,57 @@ exports.WebChannel = void 0;
 const express_1 = __importDefault(require("express"));
 const index_1 = require("./index");
 const knowledge_1 = require("../core/knowledge");
+const auth_1 = require("../core/auth");
+const AGENT_TEMPLATES = [
+    { id: 'customer-service', name: 'Customer Service', description: 'Handle support tickets, FAQs, and customer inquiries', icon: '🎧', category: 'Business' },
+    { id: 'code-reviewer', name: 'Code Reviewer', description: 'Review PRs, suggest improvements, check for bugs', icon: '🔍', category: 'Engineering' },
+    { id: 'content-writer', name: 'Content Writer', description: 'Write blogs, social media posts, and marketing copy', icon: '✍️', category: 'Marketing' },
+    { id: 'executive-assistant', name: 'Executive Assistant', description: 'Schedule management, email drafting, meeting prep', icon: '📋', category: 'Business' },
+    { id: 'knowledge-base', name: 'Knowledge Base', description: 'RAG-powered Q&A over your documents', icon: '📚', category: 'Knowledge' },
+    { id: 'project-manager', name: 'Project Manager', description: 'Track tasks, milestones, and team coordination', icon: '📊', category: 'Business' },
+    { id: 'sales-assistant', name: 'Sales Assistant', description: 'Lead qualification, outreach drafting, CRM updates', icon: '💼', category: 'Sales' },
+    { id: 'financial-advisor', name: 'Financial Advisor', description: 'Budget analysis, financial planning, cost optimization', icon: '💰', category: 'Finance' },
+    { id: 'hr-recruiter', name: 'HR Recruiter', description: 'Resume screening, interview scheduling, candidate comms', icon: '👥', category: 'HR' },
+    { id: 'legal-assistant', name: 'Legal Assistant', description: 'Contract review, compliance checks, legal research', icon: '⚖️', category: 'Legal' },
+];
+const TEMPLATES_HTML = `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1.0">
+<title>Agent Templates</title>
+<style>
+*{margin:0;padding:0;box-sizing:border-box}
+body{background:#0a0a0f;color:#e0e0e0;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;padding:24px}
+h1{font-size:28px;margin-bottom:8px;color:#fff}
+.sub{color:#888;margin-bottom:32px;font-size:14px}
+nav{margin-bottom:24px}
+nav a{color:#818cf8;text-decoration:none;margin-right:16px;font-size:14px}
+.grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(280px,1fr));gap:16px}
+.card{background:#12121a;border:1px solid #1e1e2e;border-radius:12px;padding:24px;cursor:pointer;transition:all .2s}
+.card:hover{border-color:#818cf8;transform:translateY(-2px)}
+.card .icon{font-size:32px;margin-bottom:12px}
+.card h3{font-size:16px;color:#fff;margin-bottom:8px}
+.card p{font-size:13px;color:#888;line-height:1.5}
+.card .cat{font-size:11px;color:#818cf8;text-transform:uppercase;letter-spacing:1px;margin-top:12px}
+.btn{display:inline-block;background:#2563eb;color:#fff;border:none;border-radius:8px;padding:8px 16px;font-size:13px;cursor:pointer;margin-top:12px}
+.btn:hover{background:#1d4ed8}
+</style>
+</head>
+<body>
+<nav><a href="/">← Chat</a><a href="/dashboard">Dashboard</a><a href="/templates">Templates</a></nav>
+<h1>🧩 Agent Templates</h1>
+<p class="sub">Create a new agent from a pre-built template in one click.</p>
+<div class="grid" id="grid"></div>
+<script>
+fetch('/api/templates').then(r=>r.json()).then(d=>{
+  const g=document.getElementById('grid');
+  d.templates.forEach(t=>{
+    g.innerHTML+=\`<div class="card"><div class="icon">\${t.icon}</div><h3>\${t.name}</h3><p>\${t.description}</p><div class="cat">\${t.category}</div><button class="btn" onclick="alert('Creating agent from template: '+'\${t.id}'+'\\\\nRun: opc init --template \${t.id}')">Use Template</button></div>\`;
+  });
+});
+</script>
+</body>
+</html>`;
 const CHAT_HTML = `<!DOCTYPE html>
 <html lang="en">
 <head>
@@ -157,8 +208,12 @@ class WebChannel extends index_1.BaseChannel {
     streamHandler = null;
     agentName = 'OPC Agent';
     currentProvider = 'openai';
-    stats = { sessions: 0, messages: 0, totalResponseMs: 0, tokenUsage: 0, knowledgeFiles: 0, startedAt: Date.now() };
+    stats = { sessions: 0, messages: 0, totalResponseMs: 0, tokenUsage: 0, knowledgeFiles: 0, startedAt: Date.now(), errors: 0 };
     eventHandlers = new Map();
+    conversations = new Map();
+    requestCount = 0;
+    llmLatencySum = 0;
+    llmCalls = 0;
     emit(event, data) {
         const handlers = this.eventHandlers.get(event) ?? [];
         for (const h of handlers)
@@ -173,13 +228,20 @@ class WebChannel extends index_1.BaseChannel {
         this.stats.messages++;
         this.stats.totalResponseMs += responseMs;
         this.stats.tokenUsage += tokens;
+        this.requestCount++;
+        this.llmLatencySum += responseMs;
+        this.llmCalls++;
     }
+    trackError() { this.stats.errors++; }
     trackSession() { this.stats.sessions++; }
-    constructor(port = 3000) {
+    constructor(port = 3000, authConfig) {
         super();
         this.port = port;
         this.app = (0, express_1.default)();
-        this.app.use(express_1.default.json());
+        this.app.use(express_1.default.json({ limit: '10mb' }));
+        if (authConfig && authConfig.apiKeys.length > 0) {
+            this.app.use((0, auth_1.createAuthMiddleware)(authConfig));
+        }
         this.setupRoutes();
     }
     setAgentName(name) {
@@ -201,6 +263,7 @@ class WebChannel extends index_1.BaseChannel {
         // Streaming chat endpoint
         this.app.post('/api/chat', async (req, res) => {
             const { message, sessionId } = req.body;
+            const sid = sessionId ?? 'default';
             if (!message) {
                 res.status(400).json({ error: 'message is required' });
                 return;
@@ -210,8 +273,12 @@ class WebChannel extends index_1.BaseChannel {
                 role: 'user',
                 content: message,
                 timestamp: Date.now(),
-                metadata: { sessionId: sessionId ?? 'default' },
+                metadata: { sessionId: sid },
             };
+            // Track conversation
+            if (!this.conversations.has(sid))
+                this.conversations.set(sid, []);
+            this.conversations.get(sid).push(msg);
             if (this.streamHandler) {
                 try {
                     await this.streamHandler(msg, res);
@@ -290,6 +357,100 @@ class WebChannel extends index_1.BaseChannel {
                 res.json({ totalEntries: 0, sources: [] });
             }
         });
+        // --- Health Check (detailed) ---
+        this.app.get('/api/health', (_req, res) => {
+            const uptimeMs = Date.now() - this.stats.startedAt;
+            res.json({
+                status: 'ok',
+                timestamp: Date.now(),
+                uptime: uptimeMs,
+                uptimeHuman: `${Math.floor(uptimeMs / 3600000)}h ${Math.floor((uptimeMs % 3600000) / 60000)}m`,
+                version: '0.7.0',
+                agent: this.agentName,
+                stats: {
+                    sessions: this.stats.sessions,
+                    messages: this.stats.messages,
+                    errors: this.stats.errors,
+                    avgResponseMs: this.stats.messages > 0 ? Math.round(this.stats.totalResponseMs / this.stats.messages) : 0,
+                },
+                memory: {
+                    rss: process.memoryUsage().rss,
+                    heapUsed: process.memoryUsage().heapUsed,
+                },
+            });
+        });
+        // --- Prometheus Metrics ---
+        this.app.get('/api/metrics', (_req, res) => {
+            const uptimeMs = Date.now() - this.stats.startedAt;
+            const avgLatency = this.llmCalls > 0 ? this.llmLatencySum / this.llmCalls : 0;
+            const mem = process.memoryUsage();
+            res.type('text/plain').send(`# HELP opc_uptime_seconds Agent uptime in seconds\n` +
+                `# TYPE opc_uptime_seconds gauge\n` +
+                `opc_uptime_seconds ${(uptimeMs / 1000).toFixed(1)}\n` +
+                `# HELP opc_requests_total Total requests\n` +
+                `# TYPE opc_requests_total counter\n` +
+                `opc_requests_total ${this.requestCount}\n` +
+                `# HELP opc_messages_total Total messages processed\n` +
+                `# TYPE opc_messages_total counter\n` +
+                `opc_messages_total ${this.stats.messages}\n` +
+                `# HELP opc_errors_total Total errors\n` +
+                `# TYPE opc_errors_total counter\n` +
+                `opc_errors_total ${this.stats.errors}\n` +
+                `# HELP opc_llm_latency_avg_ms Average LLM response latency\n` +
+                `# TYPE opc_llm_latency_avg_ms gauge\n` +
+                `opc_llm_latency_avg_ms ${avgLatency.toFixed(1)}\n` +
+                `# HELP opc_sessions_total Total sessions\n` +
+                `# TYPE opc_sessions_total counter\n` +
+                `opc_sessions_total ${this.stats.sessions}\n` +
+                `# HELP opc_token_usage_total Total token usage\n` +
+                `# TYPE opc_token_usage_total counter\n` +
+                `opc_token_usage_total ${this.stats.tokenUsage}\n` +
+                `# HELP process_resident_memory_bytes Resident memory size\n` +
+                `# TYPE process_resident_memory_bytes gauge\n` +
+                `process_resident_memory_bytes ${mem.rss}\n`);
+        });
+        // --- Conversation tracking & export ---
+        this.app.get('/api/conversations/export', (req, res) => {
+            const sessionId = req.query.sessionId;
+            const format = req.query.format ?? 'json';
+            const messages = sessionId ? (this.conversations.get(sessionId) ?? []) : Array.from(this.conversations.values()).flat();
+            if (format === 'markdown') {
+                const md = messages.map(m => `**${m.role}** (${new Date(m.timestamp).toISOString()}):\n${m.content}`).join('\n\n---\n\n');
+                res.type('text/markdown').send(md);
+            }
+            else if (format === 'csv') {
+                const header = 'id,role,content,timestamp\n';
+                const rows = messages.map(m => `"${m.id}","${m.role}","${m.content.replace(/"/g, '""')}",${m.timestamp}`).join('\n');
+                res.type('text/csv').send(header + rows);
+            }
+            else {
+                res.json({ sessionId: sessionId ?? 'all', messages, count: messages.length });
+            }
+        });
+        // --- Document Upload ---
+        this.app.post('/api/documents/upload', async (req, res) => {
+            try {
+                const { content, filename, mimeType } = req.body;
+                if (!content || !filename) {
+                    res.status(400).json({ error: 'content and filename are required' });
+                    return;
+                }
+                const kb = new knowledge_1.KnowledgeBase('.');
+                const result = await kb.addText(content, filename);
+                this.stats.knowledgeFiles++;
+                res.json({ ok: true, filename, chunks: result.chunks, chars: content.length });
+            }
+            catch (err) {
+                res.status(500).json({ error: err instanceof Error ? err.message : 'Upload failed' });
+            }
+        });
+        // --- Agent Templates Gallery ---
+        this.app.get('/api/templates', (_req, res) => {
+            res.json({ templates: AGENT_TEMPLATES });
+        });
+        this.app.get('/templates', (_req, res) => {
+            res.type('html').send(TEMPLATES_HTML);
+        });
         // Legacy endpoint
         this.app.post('/chat', async (req, res) => {
             if (!this.handler) {

package/dist/core/auth.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+import type { Request, Response, NextFunction } from 'express';
+export interface AuthConfig {
+    apiKeys: string[];
+    sessionIsolation?: boolean;
+}
+export interface AuthSession {
+    apiKey: string;
+    userId: string;
+    createdAt: number;
+}
+export declare function createAuthMiddleware(config: AuthConfig): (req: Request, res: Response, next: NextFunction) => void;
+export declare function getActiveSessions(): AuthSession[];
+//# sourceMappingURL=auth.d.ts.map

package/dist/core/auth.js ADDED Viewed

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuthMiddleware = createAuthMiddleware;
+exports.getActiveSessions = getActiveSessions;
+const sessions = new Map();
+function createAuthMiddleware(config) {
+    return (req, res, next) => {
+        // Skip auth for non-API routes and health/metrics
+        if (!req.path.startsWith('/api/') || req.path === '/api/health' || req.path === '/api/metrics') {
+            next();
+            return;
+        }
+        const apiKey = req.headers['x-api-key']
+            ?? req.headers['authorization']?.replace(/^Bearer\s+/i, '')
+            ?? req.query.apiKey;
+        if (!apiKey || !config.apiKeys.includes(apiKey)) {
+            res.status(401).json({ error: 'Unauthorized. Provide a valid API key via X-API-Key header, Bearer token, or ?apiKey query.' });
+            return;
+        }
+        // Derive userId from API key for session isolation
+        const userId = `user_${hashKey(apiKey)}`;
+        if (!sessions.has(apiKey)) {
+            sessions.set(apiKey, { apiKey, userId, createdAt: Date.now() });
+        }
+        // Attach user info to request
+        req.userId = userId;
+        req.sessionPrefix = config.sessionIsolation ? `${userId}:` : '';
+        next();
+    };
+}
+function hashKey(key) {
+    let h = 0;
+    for (let i = 0; i < key.length; i++) {
+        h = ((h << 5) - h + key.charCodeAt(i)) | 0;
+    }
+    return Math.abs(h).toString(36);
+}
+function getActiveSessions() {
+    return Array.from(sessions.values());
+}
+//# sourceMappingURL=auth.js.map

package/dist/index.d.ts CHANGED Viewed

@@ -47,4 +47,13 @@ export { deployToHermes } from './deploy/hermes';
 export type { HermesDeployOptions, HermesDeployResult } from './deploy/hermes';
 export { publishAgent, installAgent } from './marketplace';
 export type { AgentManifest, PublishOptions, InstallOptions } from './marketplace';
+export { createAuthMiddleware, getActiveSessions } from './core/auth';
+export type { AuthConfig, AuthSession } from './core/auth';
+export { HttpSkill } from './skills/http';
+export { WebhookTriggerSkill } from './skills/webhook-trigger';
+export type { WebhookTarget } from './skills/webhook-trigger';
+export { SchedulerSkill } from './skills/scheduler';
+export type { ScheduledTask } from './skills/scheduler';
+export { DocumentSkill } from './skills/document';
+export type { DocumentChunk } from './skills/document';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js CHANGED Viewed

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.installAgent = exports.publishAgent = 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.MRGConfigReader = exports.ValueTracker = exports.TrustManager = 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.DocumentSkill = exports.SchedulerSkill = exports.WebhookTriggerSkill = exports.HttpSkill = exports.getActiveSessions = exports.createAuthMiddleware = exports.installAgent = exports.publishAgent = 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.MRGConfigReader = exports.ValueTracker = exports.TrustManager = 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;
 // OPC Agent — Open Agent Framework
 var agent_1 = require("./core/agent");
 Object.defineProperty(exports, "BaseAgent", { enumerable: true, get: function () { return agent_1.BaseAgent; } });
@@ -82,4 +82,16 @@ Object.defineProperty(exports, "deployToHermes", { enumerable: true, get: functi
 var marketplace_1 = require("./marketplace");
 Object.defineProperty(exports, "publishAgent", { enumerable: true, get: function () { return marketplace_1.publishAgent; } });
 Object.defineProperty(exports, "installAgent", { enumerable: true, get: function () { return marketplace_1.installAgent; } });
+// v0.7.0 modules
+var auth_1 = require("./core/auth");
+Object.defineProperty(exports, "createAuthMiddleware", { enumerable: true, get: function () { return auth_1.createAuthMiddleware; } });
+Object.defineProperty(exports, "getActiveSessions", { enumerable: true, get: function () { return auth_1.getActiveSessions; } });
+var http_1 = require("./skills/http");
+Object.defineProperty(exports, "HttpSkill", { enumerable: true, get: function () { return http_1.HttpSkill; } });
+var webhook_trigger_1 = require("./skills/webhook-trigger");
+Object.defineProperty(exports, "WebhookTriggerSkill", { enumerable: true, get: function () { return webhook_trigger_1.WebhookTriggerSkill; } });
+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; } });
 //# sourceMappingURL=index.js.map

package/dist/schema/oad.d.ts CHANGED Viewed

@@ -77,6 +77,19 @@ export declare const HITLSchema: z.ZodObject<{
     defaultTimeoutMs?: number | undefined;
     defaultAction?: "approve" | "deny" | undefined;
 }>;
+export declare const AuthSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    apiKeys: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    sessionIsolation: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    apiKeys: string[];
+    sessionIsolation: boolean;
+}, {
+    enabled?: boolean | undefined;
+    apiKeys?: string[] | undefined;
+    sessionIsolation?: boolean | undefined;
+}>;
 export declare const ChannelSchema: z.ZodObject<{
     type: z.ZodEnum<["web", "websocket", "telegram", "cli", "voice", "webhook"]>;
     port: z.ZodOptional<z.ZodNumber>;
@@ -453,6 +466,19 @@ export declare const SpecSchema: z.ZodObject<{
         defaultTimeoutMs?: number | undefined;
         defaultAction?: "approve" | "deny" | undefined;
     }>>;
+    auth: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        apiKeys: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        sessionIsolation: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        apiKeys: string[];
+        sessionIsolation: boolean;
+    }, {
+        enabled?: boolean | undefined;
+        apiKeys?: string[] | undefined;
+        sessionIsolation?: boolean | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     model: string;
     skills: {
@@ -469,6 +495,11 @@ export declare const SpecSchema: z.ZodObject<{
         enabled: boolean;
         chunkSize?: number | undefined;
     };
+    auth?: {
+        enabled: boolean;
+        apiKeys: string[];
+        sessionIsolation: boolean;
+    } | undefined;
     voice?: {
         enabled: boolean;
         sttProvider?: string | undefined;
@@ -522,6 +553,11 @@ export declare const SpecSchema: z.ZodObject<{
         defaultAction: "approve" | "deny";
     } | undefined;
 }, {
+    auth?: {
+        enabled?: boolean | undefined;
+        apiKeys?: string[] | undefined;
+        sessionIsolation?: boolean | undefined;
+    } | undefined;
     voice?: {
         enabled?: boolean | undefined;
         sttProvider?: string | undefined;
@@ -830,6 +866,19 @@ export declare const OADSchema: z.ZodObject<{
             defaultTimeoutMs?: number | undefined;
             defaultAction?: "approve" | "deny" | undefined;
         }>>;
+        auth: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            apiKeys: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            sessionIsolation: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            apiKeys: string[];
+            sessionIsolation: boolean;
+        }, {
+            enabled?: boolean | undefined;
+            apiKeys?: string[] | undefined;
+            sessionIsolation?: boolean | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         model: string;
         skills: {
@@ -846,6 +895,11 @@ export declare const OADSchema: z.ZodObject<{
             enabled: boolean;
             chunkSize?: number | undefined;
         };
+        auth?: {
+            enabled: boolean;
+            apiKeys: string[];
+            sessionIsolation: boolean;
+        } | undefined;
         voice?: {
             enabled: boolean;
             sttProvider?: string | undefined;
@@ -899,6 +953,11 @@ export declare const OADSchema: z.ZodObject<{
             defaultAction: "approve" | "deny";
         } | undefined;
     }, {
+        auth?: {
+            enabled?: boolean | undefined;
+            apiKeys?: string[] | undefined;
+            sessionIsolation?: boolean | undefined;
+        } | undefined;
         voice?: {
             enabled?: boolean | undefined;
             sttProvider?: string | undefined;
@@ -999,6 +1058,11 @@ export declare const OADSchema: z.ZodObject<{
             enabled: boolean;
             chunkSize?: number | undefined;
         };
+        auth?: {
+            enabled: boolean;
+            apiKeys: string[];
+            sessionIsolation: boolean;
+        } | undefined;
         voice?: {
             enabled: boolean;
             sttProvider?: string | undefined;
@@ -1069,6 +1133,11 @@ export declare const OADSchema: z.ZodObject<{
         } | undefined;
     };
     spec: {
+        auth?: {
+            enabled?: boolean | undefined;
+            apiKeys?: string[] | undefined;
+            sessionIsolation?: boolean | undefined;
+        } | undefined;
         voice?: {
             enabled?: boolean | undefined;
             sttProvider?: string | undefined;

package/dist/schema/oad.js CHANGED Viewed

@@ -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.HITLSchema = exports.WebhookSchema = exports.VoiceSchema = exports.WorkflowSchema = exports.WorkflowStepSchema = exports.SkillRefSchema = void 0;
+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.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({
@@ -43,6 +43,11 @@ exports.HITLSchema = zod_1.z.object({
     defaultTimeoutMs: zod_1.z.number().default(60000),
     defaultAction: zod_1.z.enum(['approve', 'deny']).default('deny'),
 });
+exports.AuthSchema = zod_1.z.object({
+    enabled: zod_1.z.boolean().default(false),
+    apiKeys: zod_1.z.array(zod_1.z.string()).default([]),
+    sessionIsolation: zod_1.z.boolean().default(true),
+});
 exports.ChannelSchema = zod_1.z.object({
     type: zod_1.z.enum(['web', 'websocket', 'telegram', 'cli', 'voice', 'webhook']),
     port: zod_1.z.number().optional(),
@@ -109,6 +114,7 @@ exports.SpecSchema = zod_1.z.object({
     voice: exports.VoiceSchema.optional(),
     webhook: exports.WebhookSchema.optional(),
     hitl: exports.HITLSchema.optional(),
+    auth: exports.AuthSchema.optional(),
 });
 exports.OADSchema = zod_1.z.object({
     apiVersion: zod_1.z.literal('opc/v1'),

package/dist/skills/document.d.ts ADDED Viewed

@@ -0,0 +1,27 @@
+import { BaseSkill } from './base';
+import type { AgentContext, Message, SkillResult } from '../core/types';
+export interface DocumentChunk {
+    content: string;
+    metadata: {
+        filename: string;
+        mimeType: string;
+        chunkIndex: number;
+        totalChunks: number;
+    };
+}
+export declare class DocumentSkill extends BaseSkill {
+    name: string;
+    description: string;
+    private knowledgeBase;
+    constructor(kbPath?: string);
+    execute(context: AgentContext, message: Message): Promise<SkillResult>;
+    extractText(content: string, mimeType: string): string;
+    chunk(text: string, size?: number, overlap?: number): DocumentChunk[];
+    private guessMime;
+    /** Process raw text content directly (for API uploads) */
+    processText(content: string, filename: string): Promise<{
+        chunks: number;
+        chars: number;
+    }>;
+}
+//# sourceMappingURL=document.d.ts.map

package/dist/skills/document.js ADDED Viewed

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentSkill = void 0;
+const base_1 = require("./base");
+const knowledge_1 = require("../core/knowledge");
+class DocumentSkill extends base_1.BaseSkill {
+    name = 'document';
+    description = 'Process uploaded documents (PDF, TXT, MD, DOCX). Chunks content and adds to knowledge base.';
+    knowledgeBase;
+    constructor(kbPath = '.') {
+        super();
+        this.knowledgeBase = new knowledge_1.KnowledgeBase(kbPath);
+    }
+    async execute(context, message) {
+        // Check if message has document attachment metadata
+        const meta = message.metadata;
+        if (!meta?.document)
+            return this.noMatch();
+        const { content, filename, mimeType } = meta.document;
+        try {
+            const text = this.extractText(content, mimeType ?? this.guessMime(filename));
+            const chunks = this.chunk(text, 1000, 100);
+            const result = await this.knowledgeBase.addText(chunks.map(c => c.content).join('\n\n---\n\n'), filename);
+            return this.match(`📄 Processed "${filename}": ${chunks.length} chunks, ${text.length} chars → added to knowledge base (${result.chunks} KB entries)`);
+        }
+        catch (err) {
+            return this.match(`Document processing error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    extractText(content, mimeType) {
+        // For plain text formats, content is already text
+        if (mimeType.includes('text/') || mimeType.includes('markdown')) {
+            return content;
+        }
+        // For other formats, assume base64-encoded or pre-extracted text
+        // In a real implementation, you'd use pdf-parse, mammoth, etc.
+        return content;
+    }
+    chunk(text, size = 1000, overlap = 100) {
+        const chunks = [];
+        let start = 0;
+        while (start < text.length) {
+            const end = Math.min(start + size, text.length);
+            chunks.push({
+                content: text.slice(start, end),
+                metadata: {
+                    filename: '',
+                    mimeType: '',
+                    chunkIndex: chunks.length,
+                    totalChunks: 0, // filled after
+                },
+            });
+            start = end - overlap;
+            if (start >= text.length)
+                break;
+        }
+        // Fill totalChunks
+        for (const c of chunks)
+            c.metadata.totalChunks = chunks.length;
+        return chunks;
+    }
+    guessMime(filename) {
+        const ext = filename.split('.').pop()?.toLowerCase();
+        switch (ext) {
+            case 'pdf': return 'application/pdf';
+            case 'txt': return 'text/plain';
+            case 'md': return 'text/markdown';
+            case 'docx': return 'application/vnd.openxmlformats-officedocument.wordprocessingml.document';
+            default: return 'text/plain';
+        }
+    }
+    /** Process raw text content directly (for API uploads) */
+    async processText(content, filename) {
+        const chunks = this.chunk(content);
+        const result = await this.knowledgeBase.addText(content, filename);
+        return { chunks: chunks.length, chars: content.length };
+    }
+}
+exports.DocumentSkill = DocumentSkill;
+//# sourceMappingURL=document.js.map

package/dist/skills/http.d.ts ADDED Viewed

@@ -0,0 +1,8 @@
+import { BaseSkill } from './base';
+import type { AgentContext, Message, SkillResult } from '../core/types';
+export declare class HttpSkill extends BaseSkill {
+    name: string;
+    description: string;
+    execute(context: AgentContext, message: Message): Promise<SkillResult>;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/skills/http.js ADDED Viewed

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpSkill = void 0;
+const base_1 = require("./base");
+class HttpSkill extends base_1.BaseSkill {
+    name = 'http';
+    description = 'Make HTTP requests to external APIs. Usage: http GET|POST|PUT|DELETE <url> [body]';
+    async execute(context, message) {
+        const text = message.content.trim();
+        const match = text.match(/^http\s+(GET|POST|PUT|PATCH|DELETE)\s+(\S+)(?:\s+(.+))?$/is);
+        if (!match)
+            return this.noMatch();
+        const [, method, url, bodyStr] = match;
+        try {
+            const opts = {
+                method: method.toUpperCase(),
+                headers: { 'Content-Type': 'application/json', 'User-Agent': 'OPC-Agent/0.7.0' },
+            };
+            if (bodyStr && ['POST', 'PUT', 'PATCH'].includes(method.toUpperCase())) {
+                opts.body = bodyStr;
+            }
+            const res = await fetch(url, opts);
+            const contentType = res.headers.get('content-type') ?? '';
+            const body = contentType.includes('json') ? JSON.stringify(await res.json(), null, 2) : await res.text();
+            const truncated = body.length > 4000 ? body.slice(0, 4000) + '\n...[truncated]' : body;
+            return this.match(`HTTP ${res.status} ${res.statusText}\n\n${truncated}`);
+        }
+        catch (err) {
+            return this.match(`HTTP Error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+exports.HttpSkill = HttpSkill;
+//# sourceMappingURL=http.js.map