opc-agent 3.0.1 → 4.0.0

package/dist/core/session-manager.js

@@ -0,0 +1,157 @@
+"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.SessionManager = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const crypto = __importStar(require("crypto"));
+class SessionManager {
+    sessions = new Map();
+    storageDir;
+    constructor(storageDir) {
+        this.storageDir = storageDir || path.join(process.env.HOME || process.env.USERPROFILE || '~', '.opc', 'sessions');
+    }
+    create(agentId, channel, parentId) {
+        const session = {
+            id: crypto.randomUUID(),
+            agentId,
+            channel,
+            messages: [],
+            metadata: {},
+            createdAt: Date.now(),
+            lastActivity: Date.now(),
+            parentId,
+        };
+        this.sessions.set(session.id, session);
+        return session;
+    }
+    get(id) {
+        return this.sessions.get(id) || null;
+    }
+    list(filter) {
+        let result = Array.from(this.sessions.values());
+        if (filter?.agentId)
+            result = result.filter(s => s.agentId === filter.agentId);
+        if (filter?.channel)
+            result = result.filter(s => s.channel === filter.channel);
+        if (filter?.active !== undefined) {
+            const cutoff = Date.now() - 30 * 60 * 1000; // 30 min
+            result = result.filter(s => filter.active ? s.lastActivity > cutoff : s.lastActivity <= cutoff);
+        }
+        return result;
+    }
+    addMessage(sessionId, message) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            throw new Error(`Session ${sessionId} not found`);
+        session.messages.push(message);
+        session.lastActivity = Date.now();
+    }
+    async compact(sessionId, brain) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            throw new Error(`Session ${sessionId} not found`);
+        if (brain && typeof brain.compress === 'function') {
+            const compressed = await brain.compress(session.messages);
+            session.messages = [{ id: 'compacted', role: 'system', content: compressed, timestamp: Date.now() }];
+        }
+        else {
+            // Simple: keep first and last 5 messages
+            if (session.messages.length > 10) {
+                const first = session.messages.slice(0, 2);
+                const last = session.messages.slice(-5);
+                session.messages = [...first, { id: 'compacted', role: 'system', content: `[${session.messages.length - 7} messages compacted]`, timestamp: Date.now() }, ...last];
+            }
+        }
+        session.compactedAt = Date.now();
+    }
+    prune(maxAge) {
+        const cutoff = Date.now() - maxAge;
+        let pruned = 0;
+        for (const [id, session] of this.sessions) {
+            if (session.lastActivity < cutoff) {
+                this.sessions.delete(id);
+                pruned++;
+            }
+        }
+        return pruned;
+    }
+    getLineage(sessionId) {
+        const lineage = [];
+        let current = this.sessions.get(sessionId);
+        while (current) {
+            lineage.unshift(current);
+            current = current.parentId ? this.sessions.get(current.parentId) || undefined : undefined;
+        }
+        return lineage;
+    }
+    fork(sessionId) {
+        const parent = this.sessions.get(sessionId);
+        if (!parent)
+            throw new Error(`Session ${sessionId} not found`);
+        return this.create(parent.agentId, parent.channel, parent.id);
+    }
+    export(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            throw new Error(`Session ${sessionId} not found`);
+        const lines = [`# Session ${session.id}`, `Agent: ${session.agentId} | Channel: ${session.channel}`, `Created: ${new Date(session.createdAt).toISOString()}`, ''];
+        for (const msg of session.messages) {
+            lines.push(`**${msg.role}** (${new Date(msg.timestamp).toISOString()}):`);
+            lines.push(msg.content);
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    save() {
+        if (!fs.existsSync(this.storageDir)) {
+            fs.mkdirSync(this.storageDir, { recursive: true });
+        }
+        for (const [id, session] of this.sessions) {
+            fs.writeFileSync(path.join(this.storageDir, `${id}.json`), JSON.stringify(session, null, 2));
+        }
+    }
+    load() {
+        if (!fs.existsSync(this.storageDir))
+            return;
+        const files = fs.readdirSync(this.storageDir).filter(f => f.endsWith('.json'));
+        for (const file of files) {
+            const data = JSON.parse(fs.readFileSync(path.join(this.storageDir, file), 'utf-8'));
+            this.sessions.set(data.id, data);
+        }
+    }
+}
+exports.SessionManager = SessionManager;
+//# sourceMappingURL=session-manager.js.map

package/dist/core/vision.d.ts

@@ -0,0 +1,45 @@
+export interface ImageInput {
+    type: 'base64' | 'url' | 'file';
+    data: string;
+    mimeType?: string;
+}
+export interface VisionResult {
+    description: string;
+    text_content?: string;
+    objects?: string[];
+}
+export declare function detectMimeType(buffer: Buffer): string;
+export interface VisionManagerConfig {
+    model?: string;
+    apiKey?: string;
+    baseURL?: string;
+    maxImageSize?: number;
+}
+export declare class VisionManager {
+    private config;
+    constructor(config?: VisionManagerConfig);
+    /**
+     * Load image data as base64, detecting MIME type.
+     */
+    loadImage(input: ImageInput): Promise<{
+        base64: string;
+        mimeType: string;
+    }>;
+    /**
+     * Prepare messages in OpenAI multimodal format.
+     */
+    prepareMessage(images: ImageInput[], text: string): Array<Record<string, unknown>>;
+    /**
+     * Analyze an image with optional prompt.
+     */
+    analyze(image: ImageInput, prompt?: string): Promise<VisionResult>;
+    /**
+     * Extract text (OCR) from an image.
+     */
+    extractText(image: ImageInput): Promise<string>;
+    /**
+     * Compare multiple images.
+     */
+    compareImages(images: ImageInput[], prompt?: string): Promise<string>;
+}
+//# sourceMappingURL=vision.d.ts.map

package/dist/core/vision.js

@@ -0,0 +1,177 @@
+"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.VisionManager = void 0;
+exports.detectMimeType = detectMimeType;
+const fs = __importStar(require("fs"));
+// ─── MIME detection from magic bytes ─────────────────────────
+const MAGIC_BYTES = [
+    { bytes: [0x89, 0x50, 0x4E, 0x47], mime: 'image/png' },
+    { bytes: [0xFF, 0xD8, 0xFF], mime: 'image/jpeg' },
+    { bytes: [0x47, 0x49, 0x46, 0x38], mime: 'image/gif' },
+    { bytes: [0x52, 0x49, 0x46, 0x46], mime: 'image/webp' }, // RIFF header (WebP)
+];
+function detectMimeType(buffer) {
+    for (const { bytes, mime } of MAGIC_BYTES) {
+        if (bytes.every((b, i) => buffer[i] === b)) {
+            return mime;
+        }
+    }
+    return 'application/octet-stream';
+}
+class VisionManager {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            model: config.model ?? 'gpt-4o',
+            apiKey: config.apiKey ?? process.env.OPENAI_API_KEY ?? '',
+            baseURL: config.baseURL ?? 'https://api.openai.com/v1',
+            maxImageSize: config.maxImageSize ?? 20 * 1024 * 1024,
+        };
+    }
+    /**
+     * Load image data as base64, detecting MIME type.
+     */
+    async loadImage(input) {
+        if (input.type === 'base64') {
+            const buf = Buffer.from(input.data, 'base64');
+            return { base64: input.data, mimeType: input.mimeType ?? detectMimeType(buf) };
+        }
+        if (input.type === 'file') {
+            const buf = fs.readFileSync(input.data);
+            if (buf.length > this.config.maxImageSize) {
+                throw new Error(`Image exceeds max size: ${buf.length} > ${this.config.maxImageSize}`);
+            }
+            return { base64: buf.toString('base64'), mimeType: input.mimeType ?? detectMimeType(buf) };
+        }
+        // URL — return as-is for API
+        return { base64: '', mimeType: input.mimeType ?? 'image/jpeg' };
+    }
+    /**
+     * Prepare messages in OpenAI multimodal format.
+     */
+    prepareMessage(images, text) {
+        const content = [];
+        if (text) {
+            content.push({ type: 'text', text });
+        }
+        for (const img of images) {
+            if (img.type === 'url') {
+                content.push({
+                    type: 'image_url',
+                    image_url: { url: img.data },
+                });
+            }
+            else {
+                // base64 or file — will need to be loaded first
+                const mime = img.mimeType ?? 'image/jpeg';
+                const data = img.type === 'base64' ? img.data : fs.readFileSync(img.data).toString('base64');
+                content.push({
+                    type: 'image_url',
+                    image_url: { url: `data:${mime};base64,${data}` },
+                });
+            }
+        }
+        return [{ role: 'user', content }];
+    }
+    /**
+     * Analyze an image with optional prompt.
+     */
+    async analyze(image, prompt) {
+        const messages = this.prepareMessage([image], prompt ?? 'Describe this image in detail.');
+        if (!this.config.apiKey) {
+            throw new Error('Vision API key not configured. Set OPENAI_API_KEY or pass apiKey in config.');
+        }
+        const response = await fetch(`${this.config.baseURL}/chat/completions`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.config.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: this.config.model,
+                messages,
+                max_tokens: 1000,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`Vision API error: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        const text = data.choices?.[0]?.message?.content ?? '';
+        return {
+            description: text,
+            text_content: undefined,
+            objects: [],
+        };
+    }
+    /**
+     * Extract text (OCR) from an image.
+     */
+    async extractText(image) {
+        const result = await this.analyze(image, 'Extract all visible text from this image. Return only the text, nothing else.');
+        return result.description;
+    }
+    /**
+     * Compare multiple images.
+     */
+    async compareImages(images, prompt) {
+        if (images.length < 2)
+            throw new Error('Need at least 2 images to compare');
+        const messages = this.prepareMessage(images, prompt ?? 'Compare these images and describe the differences.');
+        if (!this.config.apiKey) {
+            throw new Error('Vision API key not configured.');
+        }
+        const response = await fetch(`${this.config.baseURL}/chat/completions`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.config.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: this.config.model,
+                messages,
+                max_tokens: 1000,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`Vision API error: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        return data.choices?.[0]?.message?.content ?? '';
+    }
+}
+exports.VisionManager = VisionManager;
+//# sourceMappingURL=vision.js.map

package/dist/index.d.ts

@@ -67,6 +67,22 @@ export { TextAnalysisTool } from './tools/text-analysis';
 export { HttpSkill } from './skills/http';
 export { WebhookTriggerSkill } from './skills/webhook-trigger';
 export type { WebhookTarget } from './skills/webhook-trigger';
+export { DingTalkChannel } from './channels/dingtalk';
+export type { DingTalkChannelConfig } from './channels/dingtalk';
+export { MattermostChannel } from './channels/mattermost';
+export type { MattermostChannelConfig } from './channels/mattermost';
+export { GoogleChatChannel } from './channels/googlechat';
+export type { GoogleChatChannelConfig } from './channels/googlechat';
+export { TwitchChannel } from './channels/twitch';
+export type { TwitchChannelConfig } from './channels/twitch';
+export { IRCChannel } from './channels/irc';
+export type { IRCChannelConfig } from './channels/irc';
+export { ContextDiscovery } from './core/context-discovery';
+export type { ContextFile } from './core/context-discovery';
+export { SessionManager } from './core/session-manager';
+export type { Session } from './core/session-manager';
+export { HeartbeatManager } from './core/heartbeat';
+export type { HeartbeatConfig } from './core/heartbeat';
 export { SchedulerSkill } from './skills/scheduler';
 export type { ScheduledTask } from './skills/scheduler';
 export { DocumentSkill } from './skills/document';
@@ -93,6 +109,16 @@ export { rateLimiterPlugin, createRateLimiterPlugin as createEnhancedRateLimiter
 export { contentFilterPlugin, createContentFilterPlugin } from './plugins/content-filter';
 export { GuardrailManager, createGuardrailsFromConfig } from './security/guardrails';
 export type { GuardrailConfig, GuardrailRule, GuardrailResult, GuardrailViolation } from './security/guardrails';
+export { ExecApprovalManager } from './security/approvals';
+export type { ExecApprovalPolicy, ExecApprovalRequest, ExecApprovalHistory, ApprovalRequestCallback } from './security/approvals';
+export { ElevatedManager } from './security/elevated';
+export type { ElevationMode, ElevationAuditEntry } from './security/elevated';
+export { SecretsManager } from './security/secrets';
+export type { SecretsStore } from './security/secrets';
+export { HookManager, ALL_HOOK_EVENTS } from './core/hooks';
+export type { HookEvent, HookContext, HookHandler } from './core/hooks';
+export { AudioProcessor } from './core/audio';
+export type { AudioFormat, TranscribeOptions, SynthesizeOptions, TranscribeResult, SynthesizeResult } from './core/audio';
 export { FeishuChannel } from './channels/feishu';
 export type { FeishuChannelConfig } from './channels/feishu';
 export { DiscordChannel } from './channels/discord';
@@ -111,7 +137,7 @@ export { SubAgentManager } from './core/subagent';
 export type { SubAgentConfig, SubAgentResult } from './core/subagent';
 export { Scheduler, parseCron, cronMatches } from './core/scheduler';
 export type { CronJob, JobHandler } from './core/scheduler';
-export { getBuiltinTools, getBuiltinToolsByName } from './tools/builtin';
+export { getBuiltinTools, getBuiltinToolsByName, rlTools, homeAssistantTools, configureHomeAssistant } from './tools/builtin';
 export { MCPClient } from './tools/mcp-client';
 export type { MCPServerConfig } from './tools/mcp-client';
 export { AgentPackager, AgentPublisher, AgentInstaller } from './publish';
@@ -130,5 +156,42 @@ export { AGUI_EVENT_TYPES, isValidEventType } from './protocols/agui';
 export { DebatePattern, VotingPattern, PipelinePattern, HierarchyPattern, SharedContext, ConversationProtocol } from './core/collaboration';
 export type { DebateResult, DebateArgument, VoteResult, VoteEntry, PipelineResult, PipelineStageResult, HierarchyResult, WorkerResult } from './core/collaboration';
 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';
+export { APIServer } from './core/api-server';
+export type { APIServerConfig } from './core/api-server';
+export { ContextRefResolver } from './core/context-refs';
+export type { ContextRef, RefType } from './core/context-refs';
+export { VisionManager, detectMimeType } from './core/vision';
+export type { ImageInput, VisionResult, VisionManagerConfig } from './core/vision';
+export { visionTools, visionAnalyzeTool, visionExtractTextTool, visionCompareTool } from './tools/builtin/vision';
+export { WhatsAppChannel } from './channels/whatsapp';
+export type { WhatsAppChannelConfig } from './channels/whatsapp';
+export { SignalChannel } from './channels/signal';
+export type { SignalChannelConfig } from './channels/signal';
+export { MatrixChannel } from './channels/matrix';
+export type { MatrixChannelConfig } from './channels/matrix';
+export { IMessageChannel } from './channels/imessage';
+export type { IMessageChannelConfig } from './channels/imessage';
+export { LINEChannel } from './channels/line';
+export type { LINEChannelConfig } from './channels/line';
+export { MSTeamsChannel } from './channels/msteams';
+export type { MSTeamsChannelConfig } from './channels/msteams';
+export { QQChannel } from './channels/qq';
+export type { QQChannelConfig } from './channels/qq';
+export { NostrChannel } from './channels/nostr';
+export type { NostrChannelConfig } from './channels/nostr';
+export { SMSChannel } from './channels/sms';
+export type { SMSChannelConfig } from './channels/sms';
+export { VoiceCallManager } from './channels/voice-call';
+export type { VoiceCallConfig } from './channels/voice-call';
+export { IDEBridge } from './core/ide-bridge';
+export type { IDEConfig, Diagnostic, TextEdit, Range, SearchOptions, SearchResult } from './core/ide-bridge';
+export { NodeNetwork } from './core/node-network';
+export type { RemoteNode } from './core/node-network';
+export { Gateway } from './core/gateway';
+export type { AgentConfig as GatewayAgentConfig, ChannelConfig as GatewayChannelConfig, GatewayConfig } from './core/gateway';
+export { SandboxManager } from './core/sandbox';
+export type { RemoteSandboxConfig, ExecResult } from './core/sandbox';
+export { ProfileManager } from './core/profiles';
+export type { Profile, ProfileConfig } from './core/profiles';
 export { SlackTool, EmailSendTool, WebhookTool, NotionTool, GitHubTool, JiraTool, CalendarTool, TrelloTool, WebSearchTool, WebScraperTool, DatabaseTool, VectorSearchTool, CodeExecutionTool, GitTool, NpmTool, ImageGenerationTool, PDFReaderTool, CSVAnalyzerTool, SummarizerTool, TranslatorTool, getAllIntegrationTools, getIntegrationTool, } from './tools/integrations';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KnowledgeBase = exports.addMessages = exports.detectLocale = exports.getLocale = exports.setLocale = exports.t = exports.LazyLoader = exports.RequestBatcher = exports.ConnectionPool = exports.VersionManager = exports.WebhookChannel = exports.createVoiceProviders = exports.ElevenLabsTTSProvider = exports.OpenAITTSProvider = exports.EdgeTTSProvider = exports.DeepgramSTTProvider = exports.WhisperSTTProvider = 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.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 = exports.compose = exports.AgentPipeline = exports.Orchestrator = exports.getActiveSessions = exports.createAuthMiddleware = exports.deployToHermes = void 0;
-exports.SharedContext = exports.HierarchyPattern = exports.PipelinePattern = exports.VotingPattern = exports.DebatePattern = 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.SubAgentManager = 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 = exports.DiscordChannel = exports.FeishuChannel = exports.createGuardrailsFromConfig = exports.GuardrailManager = exports.createContentFilterPlugin = exports.contentFilterPlugin = exports.createEnhancedRateLimiterPlugin = exports.rateLimiterPlugin = void 0;
-exports.getIntegrationTool = exports.getAllIntegrationTools = exports.TranslatorTool = exports.SummarizerTool = exports.CSVAnalyzerTool = exports.PDFReaderTool = exports.ImageGenerationTool = exports.NpmTool = exports.GitTool = exports.CodeExecutionTool = exports.VectorSearchTool = exports.DatabaseTool = exports.WebScraperTool = exports.WebSearchTool = exports.TrelloTool = exports.CalendarTool = exports.JiraTool = exports.GitHubTool = exports.NotionTool = exports.WebhookTool = exports.EmailSendTool = exports.SlackTool = exports.ConversationProtocol = void 0;
+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.HeartbeatManager = exports.SessionManager = exports.ContextDiscovery = exports.IRCChannel = exports.TwitchChannel = exports.GoogleChatChannel = exports.MattermostChannel = exports.DingTalkChannel = exports.WebhookTriggerSkill = exports.HttpSkill = exports.TextAnalysisTool = exports.JsonTransformTool = exports.DateTimeTool = exports.CalculatorTool = exports.WeChatChannel = exports.SlackChannel = exports.EmailChannel = exports.compose = exports.AgentPipeline = exports.Orchestrator = exports.getActiveSessions = exports.createAuthMiddleware = exports.deployToHermes = void 0;
+exports.A2AServer = exports.StudioServer = exports.AgentInstaller = exports.AgentPublisher = exports.AgentPackager = exports.MCPClient = exports.configureHomeAssistant = exports.homeAssistantTools = exports.rlTools = exports.getBuiltinToolsByName = exports.getBuiltinTools = exports.cronMatches = exports.parseCron = exports.Scheduler = exports.SubAgentManager = 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 = exports.DiscordChannel = exports.FeishuChannel = exports.AudioProcessor = exports.ALL_HOOK_EVENTS = exports.HookManager = exports.SecretsManager = exports.ElevatedManager = exports.ExecApprovalManager = exports.createGuardrailsFromConfig = exports.GuardrailManager = exports.createContentFilterPlugin = exports.contentFilterPlugin = exports.createEnhancedRateLimiterPlugin = exports.rateLimiterPlugin = exports.loggerPlugin = exports.createRateLimitPlugin = exports.createAnalyticsPlugin = exports.createLoggingPlugin = exports.inputValidation = exports.APIKeyManager = exports.corsMiddleware = exports.securityHeaders = void 0;
+exports.WebSearchTool = exports.TrelloTool = exports.CalendarTool = exports.JiraTool = exports.GitHubTool = exports.NotionTool = exports.WebhookTool = exports.EmailSendTool = exports.SlackTool = exports.ProfileManager = exports.SandboxManager = exports.Gateway = exports.NodeNetwork = exports.IDEBridge = exports.VoiceCallManager = exports.SMSChannel = exports.NostrChannel = exports.QQChannel = exports.MSTeamsChannel = exports.LINEChannel = exports.IMessageChannel = exports.MatrixChannel = exports.SignalChannel = exports.WhatsAppChannel = exports.visionCompareTool = exports.visionExtractTextTool = exports.visionAnalyzeTool = exports.visionTools = exports.detectMimeType = exports.VisionManager = exports.ContextRefResolver = exports.APIServer = exports.ConversationProtocol = exports.SharedContext = exports.HierarchyPattern = exports.PipelinePattern = exports.VotingPattern = exports.DebatePattern = 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 = void 0;
+exports.getIntegrationTool = exports.getAllIntegrationTools = exports.TranslatorTool = exports.SummarizerTool = exports.CSVAnalyzerTool = exports.PDFReaderTool = exports.ImageGenerationTool = exports.NpmTool = exports.GitTool = exports.CodeExecutionTool = exports.VectorSearchTool = exports.DatabaseTool = exports.WebScraperTool = 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; } });
@@ -120,6 +121,24 @@ 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; } });
+// v0.9.0 channels
+var dingtalk_1 = require("./channels/dingtalk");
+Object.defineProperty(exports, "DingTalkChannel", { enumerable: true, get: function () { return dingtalk_1.DingTalkChannel; } });
+var mattermost_1 = require("./channels/mattermost");
+Object.defineProperty(exports, "MattermostChannel", { enumerable: true, get: function () { return mattermost_1.MattermostChannel; } });
+var googlechat_1 = require("./channels/googlechat");
+Object.defineProperty(exports, "GoogleChatChannel", { enumerable: true, get: function () { return googlechat_1.GoogleChatChannel; } });
+var twitch_1 = require("./channels/twitch");
+Object.defineProperty(exports, "TwitchChannel", { enumerable: true, get: function () { return twitch_1.TwitchChannel; } });
+var irc_1 = require("./channels/irc");
+Object.defineProperty(exports, "IRCChannel", { enumerable: true, get: function () { return irc_1.IRCChannel; } });
+// v0.9.0 core
+var context_discovery_1 = require("./core/context-discovery");
+Object.defineProperty(exports, "ContextDiscovery", { enumerable: true, get: function () { return context_discovery_1.ContextDiscovery; } });
+var session_manager_1 = require("./core/session-manager");
+Object.defineProperty(exports, "SessionManager", { enumerable: true, get: function () { return session_manager_1.SessionManager; } });
+var heartbeat_1 = require("./core/heartbeat");
+Object.defineProperty(exports, "HeartbeatManager", { enumerable: true, get: function () { return heartbeat_1.HeartbeatManager; } });
 var scheduler_1 = require("./skills/scheduler");
 Object.defineProperty(exports, "SchedulerSkill", { enumerable: true, get: function () { return scheduler_1.SchedulerSkill; } });
 var document_1 = require("./skills/document");
@@ -181,6 +200,19 @@ Object.defineProperty(exports, "createContentFilterPlugin", { enumerable: true,
 var guardrails_1 = require("./security/guardrails");
 Object.defineProperty(exports, "GuardrailManager", { enumerable: true, get: function () { return guardrails_1.GuardrailManager; } });
 Object.defineProperty(exports, "createGuardrailsFromConfig", { enumerable: true, get: function () { return guardrails_1.createGuardrailsFromConfig; } });
+// v3.1.0 — Exec Approvals + Elevated + Secrets
+var approvals_1 = require("./security/approvals");
+Object.defineProperty(exports, "ExecApprovalManager", { enumerable: true, get: function () { return approvals_1.ExecApprovalManager; } });
+var elevated_1 = require("./security/elevated");
+Object.defineProperty(exports, "ElevatedManager", { enumerable: true, get: function () { return elevated_1.ElevatedManager; } });
+var secrets_1 = require("./security/secrets");
+Object.defineProperty(exports, "SecretsManager", { enumerable: true, get: function () { return secrets_1.SecretsManager; } });
+// v3.1.0 — Hooks + Audio
+var hooks_1 = require("./core/hooks");
+Object.defineProperty(exports, "HookManager", { enumerable: true, get: function () { return hooks_1.HookManager; } });
+Object.defineProperty(exports, "ALL_HOOK_EVENTS", { enumerable: true, get: function () { return hooks_1.ALL_HOOK_EVENTS; } });
+var audio_1 = require("./core/audio");
+Object.defineProperty(exports, "AudioProcessor", { enumerable: true, get: function () { return audio_1.AudioProcessor; } });
 // v1.1.0 modules
 var feishu_1 = require("./channels/feishu");
 Object.defineProperty(exports, "FeishuChannel", { enumerable: true, get: function () { return feishu_1.FeishuChannel; } });
@@ -219,6 +251,9 @@ Object.defineProperty(exports, "cronMatches", { enumerable: true, get: function
 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; } });
+Object.defineProperty(exports, "rlTools", { enumerable: true, get: function () { return builtin_1.rlTools; } });
+Object.defineProperty(exports, "homeAssistantTools", { enumerable: true, get: function () { return builtin_1.homeAssistantTools; } });
+Object.defineProperty(exports, "configureHomeAssistant", { enumerable: true, get: function () { return builtin_1.configureHomeAssistant; } });
 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
@@ -260,6 +295,54 @@ Object.defineProperty(exports, "PipelinePattern", { enumerable: true, get: funct
 Object.defineProperty(exports, "HierarchyPattern", { enumerable: true, get: function () { return collaboration_1.HierarchyPattern; } });
 Object.defineProperty(exports, "SharedContext", { enumerable: true, get: function () { return collaboration_1.SharedContext; } });
 Object.defineProperty(exports, "ConversationProtocol", { enumerable: true, get: function () { return collaboration_1.ConversationProtocol; } });
+// v2.1.0 — API Server + Context References
+var api_server_1 = require("./core/api-server");
+Object.defineProperty(exports, "APIServer", { enumerable: true, get: function () { return api_server_1.APIServer; } });
+var context_refs_1 = require("./core/context-refs");
+Object.defineProperty(exports, "ContextRefResolver", { enumerable: true, get: function () { return context_refs_1.ContextRefResolver; } });
+// v2.2.0 — Vision
+var vision_1 = require("./core/vision");
+Object.defineProperty(exports, "VisionManager", { enumerable: true, get: function () { return vision_1.VisionManager; } });
+Object.defineProperty(exports, "detectMimeType", { enumerable: true, get: function () { return vision_1.detectMimeType; } });
+var vision_2 = require("./tools/builtin/vision");
+Object.defineProperty(exports, "visionTools", { enumerable: true, get: function () { return vision_2.visionTools; } });
+Object.defineProperty(exports, "visionAnalyzeTool", { enumerable: true, get: function () { return vision_2.visionAnalyzeTool; } });
+Object.defineProperty(exports, "visionExtractTextTool", { enumerable: true, get: function () { return vision_2.visionExtractTextTool; } });
+Object.defineProperty(exports, "visionCompareTool", { enumerable: true, get: function () { return vision_2.visionCompareTool; } });
+// v2.2.0 — Additional channels
+var whatsapp_1 = require("./channels/whatsapp");
+Object.defineProperty(exports, "WhatsAppChannel", { enumerable: true, get: function () { return whatsapp_1.WhatsAppChannel; } });
+var signal_1 = require("./channels/signal");
+Object.defineProperty(exports, "SignalChannel", { enumerable: true, get: function () { return signal_1.SignalChannel; } });
+var matrix_1 = require("./channels/matrix");
+Object.defineProperty(exports, "MatrixChannel", { enumerable: true, get: function () { return matrix_1.MatrixChannel; } });
+var imessage_1 = require("./channels/imessage");
+Object.defineProperty(exports, "IMessageChannel", { enumerable: true, get: function () { return imessage_1.IMessageChannel; } });
+var line_1 = require("./channels/line");
+Object.defineProperty(exports, "LINEChannel", { enumerable: true, get: function () { return line_1.LINEChannel; } });
+var msteams_1 = require("./channels/msteams");
+Object.defineProperty(exports, "MSTeamsChannel", { enumerable: true, get: function () { return msteams_1.MSTeamsChannel; } });
+var qq_1 = require("./channels/qq");
+Object.defineProperty(exports, "QQChannel", { enumerable: true, get: function () { return qq_1.QQChannel; } });
+var nostr_1 = require("./channels/nostr");
+Object.defineProperty(exports, "NostrChannel", { enumerable: true, get: function () { return nostr_1.NostrChannel; } });
+var sms_1 = require("./channels/sms");
+Object.defineProperty(exports, "SMSChannel", { enumerable: true, get: function () { return sms_1.SMSChannel; } });
+// v2.3.0 — Voice Calls + IDE + Node Network + Gateway
+var voice_call_1 = require("./channels/voice-call");
+Object.defineProperty(exports, "VoiceCallManager", { enumerable: true, get: function () { return voice_call_1.VoiceCallManager; } });
+var ide_bridge_1 = require("./core/ide-bridge");
+Object.defineProperty(exports, "IDEBridge", { enumerable: true, get: function () { return ide_bridge_1.IDEBridge; } });
+var node_network_1 = require("./core/node-network");
+Object.defineProperty(exports, "NodeNetwork", { enumerable: true, get: function () { return node_network_1.NodeNetwork; } });
+var gateway_2 = require("./core/gateway");
+Object.defineProperty(exports, "Gateway", { enumerable: true, get: function () { return gateway_2.Gateway; } });
+// v2.2.0 — Remote Sandbox
+var sandbox_2 = require("./core/sandbox");
+Object.defineProperty(exports, "SandboxManager", { enumerable: true, get: function () { return sandbox_2.SandboxManager; } });
+// v2.2.0 — Profiles
+var profiles_1 = require("./core/profiles");
+Object.defineProperty(exports, "ProfileManager", { enumerable: true, get: function () { return profiles_1.ProfileManager; } });
 // v2.0.0 - Pre-built tool integrations (20 tools)
 var integrations_1 = require("./tools/integrations");
 Object.defineProperty(exports, "SlackTool", { enumerable: true, get: function () { return integrations_1.SlackTool; } });

package/dist/memory/context-compressor.d.ts

@@ -0,0 +1,43 @@
+import type { Message } from '../core/types';
+export interface CompressorConfig {
+    maxTokens: number;
+    compressThreshold: number;
+    preserveRecent: number;
+    brain?: any;
+}
+export interface CompressResult {
+    messages: Message[];
+    learnedCount: number;
+    savedTokens: number;
+    summary: string;
+}
+/**
+ * Context compression with optional DeepBrain memory offloading.
+ */
+export declare class ContextCompressor {
+    private config;
+    constructor(config?: Partial<CompressorConfig>);
+    /**
+     * Estimate token count using language-aware heuristic.
+     * English: ~1 token per 4 chars. Chinese: ~1 token per 2 chars.
+     */
+    estimateTokens(text: string): number;
+    private estimateMessagesTokens;
+    /**
+     * Extract key insights from messages for brain storage.
+     */
+    private extractInsights;
+    /**
+     * Generate a simple summary from messages (no-brain fallback).
+     */
+    private summarize;
+    /**
+     * Compress messages when token count exceeds threshold.
+     */
+    compress(messages: Message[], config?: Partial<CompressorConfig>): Promise<CompressResult>;
+    /**
+     * Restore context from brain for a given query.
+     */
+    restore(query: string, brain: any): Promise<string[]>;
+}
+//# sourceMappingURL=context-compressor.d.ts.map