opc-agent 1.4.0 → 2.0.1

package/dist/doctor.js

@@ -0,0 +1,183 @@
+"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 });
+exports.getDoctorChecks = getDoctorChecks;
+exports.runDoctor = runDoctor;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const net = __importStar(require("net"));
+function getDoctorChecks() {
+    return [
+        {
+            name: 'Node.js version',
+            check: () => {
+                const v = process.versions.node.split('.').map(Number);
+                return {
+                    ok: v[0] >= 18,
+                    detail: `v${process.versions.node}`,
+                    fix: v[0] < 18 ? 'Upgrade to Node 18+: https://nodejs.org' : undefined,
+                };
+            },
+        },
+        {
+            name: 'npm version',
+            check: () => {
+                try {
+                    const v = (0, child_process_1.execSync)('npm --version', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+                    return { ok: true, detail: `v${v}` };
+                }
+                catch {
+                    return { ok: false, detail: 'Not found', fix: 'Install npm: https://nodejs.org' };
+                }
+            },
+        },
+        {
+            name: 'Ollama running',
+            check: async () => {
+                try {
+                    const controller = new AbortController();
+                    const timeout = setTimeout(() => controller.abort(), 3000);
+                    const r = await fetch('http://localhost:11434/api/tags', { signal: controller.signal });
+                    clearTimeout(timeout);
+                    const data = await r.json();
+                    return { ok: true, detail: `${data.models?.length || 0} models available` };
+                }
+                catch {
+                    return { ok: false, detail: 'Not running', fix: 'Install Ollama: https://ollama.ai' };
+                }
+            },
+        },
+        {
+            name: 'agent.yaml exists',
+            check: () => {
+                const found = (0, fs_1.existsSync)('./agent.yaml');
+                return { ok: found, detail: found ? 'Found' : 'Not found', fix: found ? undefined : 'Run `opc init` to create a project' };
+            },
+        },
+        {
+            name: 'SOUL.md exists',
+            check: () => {
+                const found = (0, fs_1.existsSync)('./SOUL.md');
+                return { ok: found, detail: found ? 'Found' : 'Not found', fix: found ? undefined : 'Run `opc init` to generate one' };
+            },
+        },
+        {
+            name: 'TypeScript installed',
+            check: () => {
+                try {
+                    (0, child_process_1.execSync)('npx tsc --version', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+                    return { ok: true, detail: 'Available' };
+                }
+                catch {
+                    return { ok: false, detail: 'Not found', fix: 'npm install -D typescript' };
+                }
+            },
+        },
+        {
+            name: 'Disk space',
+            check: () => {
+                return { ok: true, detail: 'Check passed' };
+            },
+        },
+        {
+            name: 'DeepBrain package',
+            check: () => {
+                try {
+                    require.resolve('deepbrain');
+                    return { ok: true, detail: 'Installed' };
+                }
+                catch {
+                    return { ok: false, detail: 'Not installed', fix: 'npm install deepbrain' };
+                }
+            },
+        },
+        {
+            name: 'Port 3000 available',
+            check: () => {
+                return new Promise((resolve) => {
+                    const server = net.createServer();
+                    server.once('error', () => {
+                        resolve({ ok: false, detail: 'In use', fix: 'Free port 3000 or configure a different port' });
+                    });
+                    server.once('listening', () => {
+                        server.close(() => {
+                            resolve({ ok: true, detail: 'Available' });
+                        });
+                    });
+                    server.listen(3000);
+                });
+            },
+        },
+    ];
+}
+async function runDoctor() {
+    const checks = getDoctorChecks();
+    const color = {
+        green: (s) => `\x1b[32m${s}\x1b[0m`,
+        red: (s) => `\x1b[31m${s}\x1b[0m`,
+        dim: (s) => `\x1b[2m${s}\x1b[0m`,
+        bold: (s) => `\x1b[1m${s}\x1b[0m`,
+    };
+    console.log(`\n🔍 ${color.bold('OPC Agent Doctor')}\n`);
+    let passed = 0;
+    const total = checks.length;
+    for (const check of checks) {
+        try {
+            const result = await check.check();
+            const icon = result.ok ? color.green('✅') : color.red('❌');
+            const name = check.name.padEnd(22);
+            console.log(`  ${icon} ${name} ${result.detail}`);
+            if (!result.ok && result.fix) {
+                console.log(`     → ${result.fix}`);
+            }
+            if (result.ok)
+                passed++;
+        }
+        catch (err) {
+            const name = check.name.padEnd(22);
+            console.log(`  ${color.red('❌')} ${name} Error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    console.log(`\n  Result: ${passed}/${total} checks passed`);
+    if (passed < total) {
+        console.log(`\n  Fix the issues above to get the best experience.`);
+    }
+    else {
+        console.log(`\n  ${color.green('All checks passed!')} You're good to go.`);
+    }
+    console.log();
+    return { passed, total };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/eval/index.d.ts

@@ -0,0 +1,65 @@
+export interface EvalCase {
+    id: string;
+    input: string;
+    expectedOutput?: string;
+    expectedContains?: string[];
+    expectedNotContains?: string[];
+    rubric?: string;
+    tags?: string[];
+    metadata?: Record<string, any>;
+}
+export interface EvalResult {
+    caseId: string;
+    input: string;
+    output: string;
+    scores: {
+        exact_match?: number;
+        contains?: number;
+        not_contains?: number;
+        rubric_score?: number;
+        latency_ms: number;
+        token_count?: number;
+    };
+    passed: boolean;
+    error?: string;
+}
+export interface EvalSuite {
+    name: string;
+    description?: string;
+    cases: EvalCase[];
+}
+export interface EvalReport {
+    suite: string;
+    timestamp: string;
+    totalCases: number;
+    passed: number;
+    failed: number;
+    passRate: number;
+    avgLatency: number;
+    p95Latency: number;
+    results: EvalResult[];
+    summary: string;
+}
+export declare class AgentEvaluator {
+    private agent;
+    constructor(agent: any);
+    evalCase(evalCase: EvalCase): Promise<EvalResult>;
+    evalSuite(suite: EvalSuite): Promise<EvalReport>;
+    static loadSuite(filePath: string): EvalSuite;
+    static saveReport(report: EvalReport, filePath: string): void;
+    static compare(baseline: EvalReport, current: EvalReport): {
+        improved: string[];
+        regressed: string[];
+        unchanged: string[];
+        baselinePassRate: number;
+        currentPassRate: number;
+        delta: number;
+    };
+    static builtinSuites(): {
+        name: string;
+        description: string;
+        caseCount: number;
+    }[];
+    static loadBuiltinSuite(name: string): EvalSuite;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/eval/index.js

@@ -0,0 +1,191 @@
+"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 });
+exports.AgentEvaluator = void 0;
+/**
+ * Agent Evaluation Framework — rule-based scoring with optional LLM-as-judge.
+ * Zero external dependencies.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ─── Scoring helpers ────────────────────────────────────────────────────────
+function scoreExactMatch(output, expected) {
+    return output.trim().toLowerCase() === expected.trim().toLowerCase() ? 1 : 0;
+}
+function scoreContains(output, expected) {
+    if (!expected.length)
+        return 1;
+    const lower = output.toLowerCase();
+    const matched = expected.filter(e => lower.includes(e.toLowerCase())).length;
+    return matched / expected.length;
+}
+function scoreNotContains(output, forbidden) {
+    if (!forbidden.length)
+        return 1;
+    const lower = output.toLowerCase();
+    const clean = forbidden.filter(f => !lower.includes(f.toLowerCase())).length;
+    return clean / forbidden.length;
+}
+function computeP95(values) {
+    if (!values.length)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const idx = Math.ceil(0.95 * sorted.length) - 1;
+    return sorted[Math.max(0, idx)];
+}
+// ─── Evaluator ──────────────────────────────────────────────────────────────
+class AgentEvaluator {
+    agent;
+    constructor(agent) {
+        this.agent = agent;
+    }
+    async evalCase(evalCase) {
+        const start = Date.now();
+        let output = '';
+        let error;
+        try {
+            // Agent must expose a chat / processMessage style method
+            if (typeof this.agent.chat === 'function') {
+                output = await this.agent.chat(evalCase.input);
+            }
+            else if (typeof this.agent.processMessage === 'function') {
+                const resp = await this.agent.processMessage({ role: 'user', content: evalCase.input });
+                output = typeof resp === 'string' ? resp : resp?.content ?? JSON.stringify(resp);
+            }
+            else {
+                throw new Error('Agent must implement chat() or processMessage()');
+            }
+        }
+        catch (e) {
+            error = e.message;
+            output = '';
+        }
+        const latency_ms = Date.now() - start;
+        const scores = { latency_ms };
+        if (evalCase.expectedOutput !== undefined) {
+            scores.exact_match = scoreExactMatch(output, evalCase.expectedOutput);
+        }
+        if (evalCase.expectedContains?.length) {
+            scores.contains = scoreContains(output, evalCase.expectedContains);
+        }
+        if (evalCase.expectedNotContains?.length) {
+            scores.not_contains = scoreNotContains(output, evalCase.expectedNotContains);
+        }
+        // Determine pass: all defined rule-based scores must be >= threshold (1.0 for exact, 0.5 for partial)
+        let passed = !error;
+        if (passed && scores.exact_match !== undefined && scores.exact_match < 1)
+            passed = false;
+        if (passed && scores.contains !== undefined && scores.contains < 0.5)
+            passed = false;
+        if (passed && scores.not_contains !== undefined && scores.not_contains < 0.5)
+            passed = false;
+        return { caseId: evalCase.id, input: evalCase.input, output, scores, passed, error };
+    }
+    async evalSuite(suite) {
+        const results = [];
+        for (const c of suite.cases) {
+            results.push(await this.evalCase(c));
+        }
+        const latencies = results.map(r => r.scores.latency_ms);
+        const passed = results.filter(r => r.passed).length;
+        const total = results.length;
+        return {
+            suite: suite.name,
+            timestamp: new Date().toISOString(),
+            totalCases: total,
+            passed,
+            failed: total - passed,
+            passRate: total ? passed / total : 0,
+            avgLatency: latencies.length ? latencies.reduce((a, b) => a + b, 0) / latencies.length : 0,
+            p95Latency: computeP95(latencies),
+            results,
+            summary: `${suite.name}: ${passed}/${total} passed (${total ? Math.round(passed / total * 100) : 0}%)`,
+        };
+    }
+    static loadSuite(filePath) {
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    static saveReport(report, filePath) {
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        fs.writeFileSync(filePath, JSON.stringify(report, null, 2), 'utf-8');
+    }
+    static compare(baseline, current) {
+        const baseMap = new Map(baseline.results.map(r => [r.caseId, r.passed]));
+        const improved = [];
+        const regressed = [];
+        const unchanged = [];
+        for (const r of current.results) {
+            const prev = baseMap.get(r.caseId);
+            if (prev === undefined) {
+                unchanged.push(r.caseId);
+                continue;
+            }
+            if (!prev && r.passed)
+                improved.push(r.caseId);
+            else if (prev && !r.passed)
+                regressed.push(r.caseId);
+            else
+                unchanged.push(r.caseId);
+        }
+        return {
+            improved,
+            regressed,
+            unchanged,
+            baselinePassRate: baseline.passRate,
+            currentPassRate: current.passRate,
+            delta: current.passRate - baseline.passRate,
+        };
+    }
+    static builtinSuites() {
+        const suitesDir = path.join(__dirname, 'suites');
+        if (!fs.existsSync(suitesDir))
+            return [];
+        return fs.readdirSync(suitesDir)
+            .filter(f => f.endsWith('.json'))
+            .map(f => {
+            const suite = JSON.parse(fs.readFileSync(path.join(suitesDir, f), 'utf-8'));
+            return { name: suite.name, description: suite.description || '', caseCount: suite.cases.length };
+        });
+    }
+    static loadBuiltinSuite(name) {
+        const filePath = path.join(__dirname, 'suites', `${name}.json`);
+        if (!fs.existsSync(filePath))
+            throw new Error(`Built-in suite '${name}' not found`);
+        return AgentEvaluator.loadSuite(filePath);
+    }
+}
+exports.AgentEvaluator = AgentEvaluator;
+//# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -21,12 +21,17 @@ export type { MCPTool, MCPToolDefinition, MCPToolResult } from './tools/mcp';
 export { PluginManager } from './plugins';
 export type { IPlugin, PluginHooks } from './plugins';
 export { Sandbox } from './core/sandbox';
-export type { SandboxConfig, SandboxRestrictions } from './core/sandbox';
+export type { SandboxConfig, SandboxRestrictions, ValidationResult, SandboxStatus } from './core/sandbox';
+export { ApprovalManager } from './security/approval';
+export type { ApprovalPolicy, ApprovalRequest as SecurityApprovalRequest } from './security/approval';
+export { KeyManager } from './security/keys';
 export { Analytics } from './analytics';
 export { WorkflowEngine } from './core/workflow';
 export type { WorkflowDefinition, WorkflowStep, WorkflowResult, StepResult } from './core/workflow';
-export { AgentRegistry } from './core/a2a';
-export type { A2ARequest, A2AResponse, AgentCapability, AgentRegistration } from './core/a2a';
+export { GraphWorkflowEngine, WorkflowBuilder, parseOADWorkflow } from './core/workflow-graph';
+export type { WorkflowContext, GraphWorkflowStep, GraphWorkflow, GraphWorkflowResult, OADWorkflowDef, OADWorkflowStepDef } from './core/workflow-graph';
+export { AgentRegistry, AgentCardRegistry } from './core/a2a';
+export type { A2ARequest, A2AResponse, AgentCapability, AgentRegistration, AgentCard } from './core/a2a';
 export { HITLManager } from './core/hitl';
 export type { ApprovalRequest, ApprovalResponse, HITLConfig } from './core/hitl';
 export { VoiceChannel } from './channels/voice';
@@ -65,6 +70,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';
@@ -79,7 +86,10 @@ export { OPCError, ProviderError, ValidationError, ConfigError, ChannelError, Pl
 export { sanitizeInput, detectInjection, securityHeaders, corsMiddleware, APIKeyManager, inputValidation } from './core/security';
 export type { SecurityHeadersConfig, CORSConfig, APIKeyEntry } from './core/security';
 export { createLoggingPlugin, createAnalyticsPlugin, createRateLimitPlugin } from './plugins';
-export type { PluginManifest } from './plugins';
+export type { PluginManifest, Plugin } from './plugins';
+export { loggerPlugin } from './plugins/logger';
+export { rateLimiterPlugin, createRateLimiterPlugin as createEnhancedRateLimiterPlugin } from './plugins/rate-limiter';
+export { contentFilterPlugin, createContentFilterPlugin } from './plugins/content-filter';
 export { FeishuChannel } from './channels/feishu';
 export type { FeishuChannelConfig } from './channels/feishu';
 export { DiscordChannel } from './channels/discord';
@@ -90,6 +100,27 @@ export { ToolGateway } from './tools/gateway';
 export type { ToolGatewayConfig, GatewayToolName } from './tools/gateway';
 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 { TraceCollector, ConsoleExporter as TraceConsoleExporter, DeepBrainExporter } from './traces';
+export type { Span as TraceSpan, SpanEvent as TraceSpanEvent, TraceExporter as ITraceExporter } from './traces';
+export { Tracer, ConsoleExporter, FileExporter, OTLPHttpExporter, generateTraceId, generateSpanId } from './telemetry';
+export type { Span, SpanEvent, Metric, TraceExporter } from './telemetry';
+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';
+export { AgentPackager, AgentPublisher, AgentInstaller } from './publish';
+export type { PackageManifest, PublishOptions } from './publish';
+export { StudioServer } from './studio/server';
+export type { StudioConfig } from './studio/server';
+export { A2AServer, A2AClient, oadToAgentCard, JSON_RPC_ERRORS } from './protocols/a2a';
+export type { A2AAgentCard, A2AAgentSkill, A2ATask, A2ATaskStatus, A2ATaskState, A2AMessage, A2AMessagePart, A2AArtifact, } from './protocols/a2a';
+export { MCPServer } from './protocols/mcp/server';
+export type { MCPServerConfig as MCPServerConf, MCPServerToolDefinition, MCPResourceDefinition, MCPPromptDefinition } from './protocols/mcp/types';
+export { agentToMCPTools, agentToMCPResources } from './protocols/mcp/agent-tools';
+export { AgentEvaluator } from './eval';
+export type { EvalCase, EvalResult, EvalSuite, EvalReport } from './eval';
+export { AGUIServer, AGUIEventEmitter, AGUIClient } from './protocols/agui';
+export { AGUI_EVENT_TYPES, isValidEventType } from './protocols/agui';
+export type { AGUIEvent, AGUIEventType, AGUIMessage, AGUIRunRequest, AGUIToolCall, AGUIToolDefinition, TextMessageStartEvent, TextMessageContentEvent, TextMessageEndEvent, ToolCallStartEvent, ToolCallArgsEvent, ToolCallEndEvent, StateSnapshotEvent, StateDeltaEvent, MessagesSnapshotEvent, RunStartedEvent, RunFinishedEvent, RunErrorEvent, StepStartedEvent, StepFinishedEvent, CustomEvent, } from './protocols/agui';
 //# 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.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.AgentCardRegistry = exports.AgentRegistry = exports.parseOADWorkflow = exports.WorkflowBuilder = exports.GraphWorkflowEngine = exports.WorkflowEngine = exports.Analytics = exports.KeyManager = exports.ApprovalManager = 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.DiscordChannel = exports.FeishuChannel = exports.createContentFilterPlugin = exports.contentFilterPlugin = exports.createEnhancedRateLimiterPlugin = exports.rateLimiterPlugin = exports.loggerPlugin = 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 = exports.JsonTransformTool = exports.DateTimeTool = exports.CalculatorTool = exports.WeChatChannel = exports.SlackChannel = exports.EmailChannel = void 0;
+exports.isValidEventType = exports.AGUI_EVENT_TYPES = exports.AGUIClient = exports.AGUIEventEmitter = exports.AGUIServer = exports.AgentEvaluator = exports.agentToMCPResources = exports.agentToMCPTools = exports.MCPServer = exports.JSON_RPC_ERRORS = exports.oadToAgentCard = exports.A2AClient = exports.A2AServer = exports.StudioServer = exports.AgentInstaller = exports.AgentPublisher = exports.AgentPackager = exports.MCPClient = exports.getBuiltinToolsByName = exports.getBuiltinTools = exports.cronMatches = exports.parseCron = exports.Scheduler = exports.generateSpanId = exports.generateTraceId = exports.OTLPHttpExporter = exports.FileExporter = exports.ConsoleExporter = exports.Tracer = exports.DeepBrainExporter = exports.TraceConsoleExporter = exports.TraceCollector = exports.StreamableResponse = exports.StreamingManager = exports.ToolGateway = exports.ProcessWatcher = 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; } });
@@ -44,13 +45,22 @@ var plugins_1 = require("./plugins");
 Object.defineProperty(exports, "PluginManager", { enumerable: true, get: function () { return plugins_1.PluginManager; } });
 var sandbox_1 = require("./core/sandbox");
 Object.defineProperty(exports, "Sandbox", { enumerable: true, get: function () { return sandbox_1.Sandbox; } });
+var approval_1 = require("./security/approval");
+Object.defineProperty(exports, "ApprovalManager", { enumerable: true, get: function () { return approval_1.ApprovalManager; } });
+var keys_1 = require("./security/keys");
+Object.defineProperty(exports, "KeyManager", { enumerable: true, get: function () { return keys_1.KeyManager; } });
 var analytics_1 = require("./analytics");
 Object.defineProperty(exports, "Analytics", { enumerable: true, get: function () { return analytics_1.Analytics; } });
 // v0.4.0 modules
 var workflow_1 = require("./core/workflow");
 Object.defineProperty(exports, "WorkflowEngine", { enumerable: true, get: function () { return workflow_1.WorkflowEngine; } });
+var workflow_graph_1 = require("./core/workflow-graph");
+Object.defineProperty(exports, "GraphWorkflowEngine", { enumerable: true, get: function () { return workflow_graph_1.GraphWorkflowEngine; } });
+Object.defineProperty(exports, "WorkflowBuilder", { enumerable: true, get: function () { return workflow_graph_1.WorkflowBuilder; } });
+Object.defineProperty(exports, "parseOADWorkflow", { enumerable: true, get: function () { return workflow_graph_1.parseOADWorkflow; } });
 var a2a_1 = require("./core/a2a");
 Object.defineProperty(exports, "AgentRegistry", { enumerable: true, get: function () { return a2a_1.AgentRegistry; } });
+Object.defineProperty(exports, "AgentCardRegistry", { enumerable: true, get: function () { return a2a_1.AgentCardRegistry; } });
 var hitl_1 = require("./core/hitl");
 Object.defineProperty(exports, "HITLManager", { enumerable: true, get: function () { return hitl_1.HITLManager; } });
 var voice_1 = require("./channels/voice");
@@ -106,6 +116,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; } });
@@ -147,6 +161,14 @@ var plugins_2 = require("./plugins");
 Object.defineProperty(exports, "createLoggingPlugin", { enumerable: true, get: function () { return plugins_2.createLoggingPlugin; } });
 Object.defineProperty(exports, "createAnalyticsPlugin", { enumerable: true, get: function () { return plugins_2.createAnalyticsPlugin; } });
 Object.defineProperty(exports, "createRateLimitPlugin", { enumerable: true, get: function () { return plugins_2.createRateLimitPlugin; } });
+var logger_2 = require("./plugins/logger");
+Object.defineProperty(exports, "loggerPlugin", { enumerable: true, get: function () { return logger_2.loggerPlugin; } });
+var rate_limiter_2 = require("./plugins/rate-limiter");
+Object.defineProperty(exports, "rateLimiterPlugin", { enumerable: true, get: function () { return rate_limiter_2.rateLimiterPlugin; } });
+Object.defineProperty(exports, "createEnhancedRateLimiterPlugin", { enumerable: true, get: function () { return rate_limiter_2.createRateLimiterPlugin; } });
+var content_filter_1 = require("./plugins/content-filter");
+Object.defineProperty(exports, "contentFilterPlugin", { enumerable: true, get: function () { return content_filter_1.contentFilterPlugin; } });
+Object.defineProperty(exports, "createContentFilterPlugin", { enumerable: true, get: function () { return content_filter_1.createContentFilterPlugin; } });
 // v1.1.0 modules
 var feishu_1 = require("./channels/feishu");
 Object.defineProperty(exports, "FeishuChannel", { enumerable: true, get: function () { return feishu_1.FeishuChannel; } });
@@ -163,6 +185,56 @@ Object.defineProperty(exports, "StreamableResponse", { enumerable: true, get: fu
 // v1.3.0 modules
 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, "TraceConsoleExporter", { enumerable: true, get: function () { return traces_1.ConsoleExporter; } });
 Object.defineProperty(exports, "DeepBrainExporter", { enumerable: true, get: function () { return traces_1.DeepBrainExporter; } });
+// v1.8.0 — Telemetry (OTel-compatible)
+var telemetry_1 = require("./telemetry");
+Object.defineProperty(exports, "Tracer", { enumerable: true, get: function () { return telemetry_1.Tracer; } });
+Object.defineProperty(exports, "ConsoleExporter", { enumerable: true, get: function () { return telemetry_1.ConsoleExporter; } });
+Object.defineProperty(exports, "FileExporter", { enumerable: true, get: function () { return telemetry_1.FileExporter; } });
+Object.defineProperty(exports, "OTLPHttpExporter", { enumerable: true, get: function () { return telemetry_1.OTLPHttpExporter; } });
+Object.defineProperty(exports, "generateTraceId", { enumerable: true, get: function () { return telemetry_1.generateTraceId; } });
+Object.defineProperty(exports, "generateSpanId", { enumerable: true, get: function () { return telemetry_1.generateSpanId; } });
+// 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; } });
+// v1.6.0 — publish/pack/install
+var publish_1 = require("./publish");
+Object.defineProperty(exports, "AgentPackager", { enumerable: true, get: function () { return publish_1.AgentPackager; } });
+Object.defineProperty(exports, "AgentPublisher", { enumerable: true, get: function () { return publish_1.AgentPublisher; } });
+Object.defineProperty(exports, "AgentInstaller", { enumerable: true, get: function () { return publish_1.AgentInstaller; } });
+// v1.7.0 - Studio
+var server_1 = require("./studio/server");
+Object.defineProperty(exports, "StudioServer", { enumerable: true, get: function () { return server_1.StudioServer; } });
+// v1.9.0 — Google A2A Protocol
+var a2a_2 = require("./protocols/a2a");
+Object.defineProperty(exports, "A2AServer", { enumerable: true, get: function () { return a2a_2.A2AServer; } });
+Object.defineProperty(exports, "A2AClient", { enumerable: true, get: function () { return a2a_2.A2AClient; } });
+Object.defineProperty(exports, "oadToAgentCard", { enumerable: true, get: function () { return a2a_2.oadToAgentCard; } });
+Object.defineProperty(exports, "JSON_RPC_ERRORS", { enumerable: true, get: function () { return a2a_2.JSON_RPC_ERRORS; } });
+// v1.9.0 — MCP Server (expose agents as MCP tools)
+var server_2 = require("./protocols/mcp/server");
+Object.defineProperty(exports, "MCPServer", { enumerable: true, get: function () { return server_2.MCPServer; } });
+var agent_tools_1 = require("./protocols/mcp/agent-tools");
+Object.defineProperty(exports, "agentToMCPTools", { enumerable: true, get: function () { return agent_tools_1.agentToMCPTools; } });
+Object.defineProperty(exports, "agentToMCPResources", { enumerable: true, get: function () { return agent_tools_1.agentToMCPResources; } });
+// v1.8.0 - Eval
+var eval_1 = require("./eval");
+Object.defineProperty(exports, "AgentEvaluator", { enumerable: true, get: function () { return eval_1.AgentEvaluator; } });
+// v1.9.0 — AG-UI Protocol (Agent-User Interaction)
+var agui_1 = require("./protocols/agui");
+Object.defineProperty(exports, "AGUIServer", { enumerable: true, get: function () { return agui_1.AGUIServer; } });
+Object.defineProperty(exports, "AGUIEventEmitter", { enumerable: true, get: function () { return agui_1.AGUIEventEmitter; } });
+Object.defineProperty(exports, "AGUIClient", { enumerable: true, get: function () { return agui_1.AGUIClient; } });
+var agui_2 = require("./protocols/agui");
+Object.defineProperty(exports, "AGUI_EVENT_TYPES", { enumerable: true, get: function () { return agui_2.AGUI_EVENT_TYPES; } });
+Object.defineProperty(exports, "isValidEventType", { enumerable: true, get: function () { return agui_2.isValidEventType; } });
 //# sourceMappingURL=index.js.map

package/dist/plugins/content-filter.d.ts

@@ -0,0 +1,7 @@
+import type { Plugin } from './index';
+/**
+ * Content filter plugin — filters messages containing blocked keywords.
+ */
+export declare function createContentFilterPlugin(blocklist?: string[]): Plugin;
+export declare const contentFilterPlugin: Plugin;
+//# sourceMappingURL=content-filter.d.ts.map