opc-agent 0.7.0 → 0.8.0

package/dist/tools/text-analysis.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextAnalysisTool = void 0;
+/**
+ * Text Analysis Tool — v0.8.0
+ * Summarize, translate (stub), sentiment analysis as an LLM function tool.
+ * Note: For production, connect to actual LLM/NLP APIs. This provides basic built-in analysis.
+ */
+exports.TextAnalysisTool = {
+    name: 'text_analysis',
+    description: 'Analyze text: word count, character count, reading time, keyword extraction, basic sentiment, and language detection.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['stats', 'keywords', 'sentiment', 'detect_language', 'truncate', 'split_sentences'],
+                description: 'Analysis operation to perform',
+            },
+            text: {
+                type: 'string',
+                description: 'Text to analyze',
+            },
+            maxLength: {
+                type: 'number',
+                description: 'Max length for truncate operation',
+            },
+            topN: {
+                type: 'number',
+                description: 'Number of top keywords to extract (default: 10)',
+            },
+        },
+        required: ['operation', 'text'],
+    },
+    async execute(input) {
+        try {
+            const op = String(input.operation);
+            const text = String(input.text ?? '');
+            switch (op) {
+                case 'stats': {
+                    const words = text.split(/\s+/).filter(Boolean);
+                    const sentences = text.split(/[.!?。！？]+/).filter(Boolean);
+                    const readingTimeMin = Math.ceil(words.length / 200);
+                    return {
+                        content: JSON.stringify({
+                            characters: text.length,
+                            words: words.length,
+                            sentences: sentences.length,
+                            paragraphs: text.split(/\n\s*\n/).filter(Boolean).length,
+                            readingTimeMinutes: readingTimeMin,
+                        }, null, 2),
+                    };
+                }
+                case 'keywords': {
+                    const topN = Number(input.topN ?? 10);
+                    const words = text.toLowerCase().replace(/[^\w\s\u4e00-\u9fff]/g, '').split(/\s+/).filter(Boolean);
+                    const stopWords = new Set(['the', 'a', 'an', 'is', 'are', 'was', 'were', 'in', 'on', 'at', 'to', 'for', 'of', 'and', 'or', 'but', 'not', 'with', 'this', 'that', 'it', 'be', 'has', 'have', 'had', 'do', 'does', 'did', 'will', 'would', 'can', 'could', 'should', 'may', 'might', 'from', 'by', 'as', 'if', 'so', 'than']);
+                    const freq = {};
+                    for (const w of words) {
+                        if (w.length < 2 || stopWords.has(w))
+                            continue;
+                        freq[w] = (freq[w] ?? 0) + 1;
+                    }
+                    const sorted = Object.entries(freq).sort((a, b) => b[1] - a[1]).slice(0, topN);
+                    return { content: JSON.stringify(sorted.map(([word, count]) => ({ word, count })), null, 2) };
+                }
+                case 'sentiment': {
+                    // Basic lexicon-based sentiment
+                    const positiveWords = new Set(['good', 'great', 'excellent', 'amazing', 'wonderful', 'fantastic', 'love', 'happy', 'best', 'awesome', 'perfect', 'brilliant', 'outstanding', 'superb', 'beautiful', 'nice', 'enjoy', 'like', 'positive', 'success']);
+                    const negativeWords = new Set(['bad', 'terrible', 'awful', 'horrible', 'hate', 'worst', 'poor', 'ugly', 'fail', 'wrong', 'sad', 'angry', 'frustrating', 'disappointing', 'negative', 'annoying', 'broken', 'useless', 'boring', 'painful']);
+                    const words = text.toLowerCase().split(/\s+/);
+                    let pos = 0, neg = 0;
+                    for (const w of words) {
+                        if (positiveWords.has(w))
+                            pos++;
+                        if (negativeWords.has(w))
+                            neg++;
+                    }
+                    const total = pos + neg || 1;
+                    const score = (pos - neg) / total; // -1 to 1
+                    const label = score > 0.1 ? 'positive' : score < -0.1 ? 'negative' : 'neutral';
+                    return {
+                        content: JSON.stringify({ score: Math.round(score * 100) / 100, label, positive: pos, negative: neg }, null, 2),
+                    };
+                }
+                case 'detect_language': {
+                    // Simple heuristic
+                    const hasChinese = /[\u4e00-\u9fff]/.test(text);
+                    const hasJapanese = /[\u3040-\u309f\u30a0-\u30ff]/.test(text);
+                    const hasKorean = /[\uac00-\ud7af]/.test(text);
+                    const hasArabic = /[\u0600-\u06ff]/.test(text);
+                    const lang = hasChinese ? 'zh' : hasJapanese ? 'ja' : hasKorean ? 'ko' : hasArabic ? 'ar' : 'en';
+                    return { content: JSON.stringify({ detected: lang, confidence: 'heuristic' }) };
+                }
+                case 'truncate': {
+                    const maxLen = Number(input.maxLength ?? 100);
+                    const truncated = text.length > maxLen ? text.slice(0, maxLen) + '...' : text;
+                    return { content: truncated };
+                }
+                case 'split_sentences': {
+                    const sentences = text.match(/[^.!?。！？]+[.!?。！？]+/g) ?? [text];
+                    return { content: JSON.stringify(sentences.map((s) => s.trim()), null, 2) };
+                }
+                default:
+                    return { content: `Unknown operation: ${op}`, isError: true };
+            }
+        }
+        catch (err) {
+            return { content: `Error: ${err.message}`, isError: true };
+        }
+    },
+};
+//# sourceMappingURL=text-analysis.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opc-agent",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Open Agent Framework — Build, test, and run AI Agents for business workstations",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/channels/email.ts

@@ -0,0 +1,177 @@
+import { BaseChannel } from './index';
+import type { Message } from '../core/types';
+
+/**
+ * Email Channel — v0.8.0
+ * IMAP polling for incoming emails, SMTP for sending replies.
+ * Parses email threads as conversations.
+ */
+
+export interface EmailChannelConfig {
+  imap: {
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    tls?: boolean;
+    /** Mailbox to monitor (default: INBOX) */
+    mailbox?: string;
+    /** Poll interval in ms (default: 30000) */
+    pollInterval?: number;
+  };
+  smtp: {
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    tls?: boolean;
+    from: string;
+  };
+  /** Filter: only process emails matching these patterns */
+  filters?: {
+    from?: string[];
+    subject?: string[];
+  };
+}
+
+export interface EmailMessage {
+  messageId: string;
+  from: string;
+  to: string[];
+  cc?: string[];
+  subject: string;
+  body: string;
+  html?: string;
+  date: Date;
+  inReplyTo?: string;
+  references?: string[];
+  threadId?: string;
+}
+
+export class EmailChannel extends BaseChannel {
+  type = 'email';
+  private config: EmailChannelConfig;
+  private pollTimer: ReturnType<typeof setInterval> | null = null;
+  private running = false;
+  private processedIds: Set<string> = new Set();
+
+  constructor(config: EmailChannelConfig) {
+    super();
+    this.config = config;
+  }
+
+  async start(): Promise<void> {
+    this.running = true;
+    const interval = this.config.imap.pollInterval ?? 30000;
+
+    // Initial poll
+    await this.poll();
+
+    // Set up recurring poll
+    this.pollTimer = setInterval(() => {
+      if (this.running) this.poll().catch(console.error);
+    }, interval);
+  }
+
+  async stop(): Promise<void> {
+    this.running = false;
+    if (this.pollTimer) {
+      clearInterval(this.pollTimer);
+      this.pollTimer = null;
+    }
+  }
+
+  /** Poll IMAP for new emails */
+  private async poll(): Promise<void> {
+    // In production, use a library like `imapflow` or `imap-simple`
+    // This is the integration point — actual IMAP connection logic goes here
+    const emails = await this.fetchEmails();
+
+    for (const email of emails) {
+      if (this.processedIds.has(email.messageId)) continue;
+      this.processedIds.add(email.messageId);
+
+      if (!this.matchesFilters(email)) continue;
+
+      const message = this.emailToMessage(email);
+      if (this.handler) {
+        const reply = await this.handler(message);
+        await this.sendReply(email, reply);
+      }
+    }
+  }
+
+  /** Convert email to Message format */
+  private emailToMessage(email: EmailMessage): Message {
+    return {
+      id: email.messageId,
+      role: 'user',
+      content: email.body,
+      timestamp: email.date.getTime(),
+      metadata: {
+        channel: 'email',
+        from: email.from,
+        to: email.to,
+        subject: email.subject,
+        threadId: email.threadId ?? email.messageId,
+        inReplyTo: email.inReplyTo,
+      },
+    };
+  }
+
+  /** Check if email matches configured filters */
+  private matchesFilters(email: EmailMessage): boolean {
+    if (!this.config.filters) return true;
+
+    if (this.config.filters.from?.length) {
+      const fromMatch = this.config.filters.from.some((f) =>
+        email.from.toLowerCase().includes(f.toLowerCase())
+      );
+      if (!fromMatch) return false;
+    }
+
+    if (this.config.filters.subject?.length) {
+      const subjectMatch = this.config.filters.subject.some((s) =>
+        email.subject.toLowerCase().includes(s.toLowerCase())
+      );
+      if (!subjectMatch) return false;
+    }
+
+    return true;
+  }
+
+  /** Fetch emails via IMAP — stub for actual implementation */
+  private async fetchEmails(): Promise<EmailMessage[]> {
+    // TODO: Implement with imapflow or similar library
+    // const { ImapFlow } = await import('imapflow');
+    // const client = new ImapFlow({ ...this.config.imap });
+    // await client.connect();
+    // ...
+    return [];
+  }
+
+  /** Send reply via SMTP — stub for actual implementation */
+  async sendReply(originalEmail: EmailMessage, reply: Message): Promise<void> {
+    // TODO: Implement with nodemailer or similar library
+    // const nodemailer = await import('nodemailer');
+    // const transport = nodemailer.createTransport({ ...this.config.smtp });
+    // await transport.sendMail({
+    //   from: this.config.smtp.from,
+    //   to: originalEmail.from,
+    //   subject: `Re: ${originalEmail.subject}`,
+    //   text: reply.content,
+    //   inReplyTo: originalEmail.messageId,
+    //   references: [originalEmail.messageId],
+    // });
+    void originalEmail;
+    void reply;
+  }
+
+  /** Send a standalone email */
+  async send(to: string, subject: string, body: string): Promise<void> {
+    void to;
+    void subject;
+    void body;
+    // TODO: Implement with nodemailer
+  }
+}

package/src/channels/slack.ts

@@ -0,0 +1,160 @@
+import { BaseChannel } from './index';
+import type { Message } from '../core/types';
+
+/**
+ * Slack Channel — v0.8.0
+ * Slack Bot with Socket Mode / Events API support, threads, and slash commands.
+ */
+
+export interface SlackChannelConfig {
+  /** Bot token (xoxb-...) */
+  botToken: string;
+  /** App-level token for Socket Mode (xapp-...) */
+  appToken?: string;
+  /** Signing secret for Events API verification */
+  signingSecret?: string;
+  /** Use Socket Mode (true) or Events API (false) */
+  socketMode?: boolean;
+  /** Port for Events API webhook server (default: 3001) */
+  port?: number;
+  /** Slash commands to register */
+  slashCommands?: SlashCommandConfig[];
+}
+
+export interface SlashCommandConfig {
+  command: string;
+  description: string;
+  handler?: (payload: SlashCommandPayload) => Promise<string>;
+}
+
+export interface SlashCommandPayload {
+  command: string;
+  text: string;
+  userId: string;
+  channelId: string;
+  triggerId: string;
+}
+
+export interface SlackMessageEvent {
+  type: string;
+  channel: string;
+  user: string;
+  text: string;
+  ts: string;
+  threadTs?: string;
+  botId?: string;
+}
+
+export class SlackChannel extends BaseChannel {
+  type = 'slack';
+  private config: SlackChannelConfig;
+  private running = false;
+  private slashHandlers: Map<string, SlashCommandConfig> = new Map();
+
+  constructor(config: SlackChannelConfig) {
+    super();
+    this.config = config;
+
+    for (const cmd of config.slashCommands ?? []) {
+      this.slashHandlers.set(cmd.command, cmd);
+    }
+  }
+
+  async start(): Promise<void> {
+    this.running = true;
+
+    if (this.config.socketMode && this.config.appToken) {
+      await this.startSocketMode();
+    } else {
+      await this.startEventsAPI();
+    }
+  }
+
+  async stop(): Promise<void> {
+    this.running = false;
+    // Cleanup connections
+  }
+
+  /** Start Socket Mode connection */
+  private async startSocketMode(): Promise<void> {
+    // TODO: Implement with @slack/socket-mode
+    // const { SocketModeClient } = await import('@slack/socket-mode');
+    // const client = new SocketModeClient({ appToken: this.config.appToken! });
+    // client.on('message', (event) => this.handleMessage(event));
+    // await client.start();
+  }
+
+  /** Start Events API HTTP server */
+  private async startEventsAPI(): Promise<void> {
+    // TODO: Implement with express or http
+    // const port = this.config.port ?? 3001;
+    // Listen for POST /slack/events and /slack/commands
+  }
+
+  /** Handle incoming Slack message */
+  async handleMessage(event: SlackMessageEvent): Promise<void> {
+    // Ignore bot messages
+    if (event.botId) return;
+
+    const message = this.slackToMessage(event);
+    if (this.handler) {
+      const reply = await this.handler(message);
+      await this.sendMessage(event.channel, reply.content, event.threadTs ?? event.ts);
+    }
+  }
+
+  /** Handle slash command */
+  async handleSlashCommand(payload: SlashCommandPayload): Promise<string> {
+    const cmd = this.slashHandlers.get(payload.command);
+    if (cmd?.handler) {
+      return cmd.handler(payload);
+    }
+
+    // Default: pass to message handler
+    const message: Message = {
+      id: `slack-cmd-${Date.now()}`,
+      role: 'user',
+      content: `${payload.command} ${payload.text}`.trim(),
+      timestamp: Date.now(),
+      metadata: {
+        channel: 'slack',
+        channelId: payload.channelId,
+        userId: payload.userId,
+        isSlashCommand: true,
+      },
+    };
+
+    if (this.handler) {
+      const reply = await this.handler(message);
+      return reply.content;
+    }
+    return 'Command received.';
+  }
+
+  /** Convert Slack event to Message */
+  private slackToMessage(event: SlackMessageEvent): Message {
+    return {
+      id: event.ts,
+      role: 'user',
+      content: event.text,
+      timestamp: parseFloat(event.ts) * 1000,
+      metadata: {
+        channel: 'slack',
+        channelId: event.channel,
+        userId: event.user,
+        threadTs: event.threadTs,
+      },
+    };
+  }
+
+  /** Send a message to a Slack channel */
+  async sendMessage(channel: string, text: string, threadTs?: string): Promise<void> {
+    // TODO: Implement with @slack/web-api
+    // const { WebClient } = await import('@slack/web-api');
+    // const client = new WebClient(this.config.botToken);
+    // await client.chat.postMessage({ channel, text, thread_ts: threadTs });
+    void channel;
+    void text;
+    void threadTs;
+  }
+}

package/src/channels/wechat.ts

@@ -0,0 +1,149 @@
+import { BaseChannel } from './index';
+import type { Message } from '../core/types';
+
+/**
+ * WeChat Channel (Stub) — v0.8.0
+ * WeChat Official Account message handling, template messages, QR code login.
+ */
+
+export interface WeChatChannelConfig {
+  /** WeChat Official Account AppID */
+  appId: string;
+  /** WeChat Official Account AppSecret */
+  appSecret: string;
+  /** Verification token for message validation */
+  token: string;
+  /** AES encoding key for encrypted messages */
+  encodingAESKey?: string;
+  /** HTTP server port (default: 3002) */
+  port?: number;
+}
+
+export interface WeChatMessage {
+  toUserName: string;
+  fromUserName: string;
+  createTime: number;
+  msgType: 'text' | 'image' | 'voice' | 'video' | 'event';
+  content?: string;
+  msgId?: string;
+  event?: string;
+  eventKey?: string;
+}
+
+export interface TemplateMessageData {
+  toUser: string;
+  templateId: string;
+  url?: string;
+  data: Record<string, { value: string; color?: string }>;
+}
+
+export class WeChatChannel extends BaseChannel {
+  type = 'wechat';
+  private config: WeChatChannelConfig;
+  private accessToken: string | null = null;
+  private tokenExpiry = 0;
+
+  constructor(config: WeChatChannelConfig) {
+    super();
+    this.config = config;
+  }
+
+  async start(): Promise<void> {
+    // TODO: Start HTTP server to receive WeChat push messages
+    // 1. Verify signature on GET requests
+    // 2. Parse XML messages on POST requests
+    // 3. Route to handler and reply with XML
+  }
+
+  async stop(): Promise<void> {
+    // TODO: Stop HTTP server
+  }
+
+  /** Get or refresh access token */
+  async getAccessToken(): Promise<string> {
+    if (this.accessToken && Date.now() < this.tokenExpiry) {
+      return this.accessToken;
+    }
+
+    // TODO: Implement token refresh
+    // const url = `https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=${this.config.appId}&secret=${this.config.appSecret}`;
+    // const res = await fetch(url);
+    // const data = await res.json();
+    // this.accessToken = data.access_token;
+    // this.tokenExpiry = Date.now() + (data.expires_in - 300) * 1000;
+
+    return this.accessToken ?? '';
+  }
+
+  /** Handle incoming WeChat message */
+  async handleMessage(wxMsg: WeChatMessage): Promise<string> {
+    if (wxMsg.msgType === 'event') {
+      return this.handleEvent(wxMsg);
+    }
+
+    const message = this.wechatToMessage(wxMsg);
+    if (this.handler) {
+      const reply = await this.handler(message);
+      return reply.content;
+    }
+    return '';
+  }
+
+  /** Handle WeChat events (subscribe, scan, etc.) */
+  private handleEvent(wxMsg: WeChatMessage): string {
+    switch (wxMsg.event) {
+      case 'subscribe':
+        return 'Welcome! How can I help you?';
+      case 'SCAN':
+        return `QR code scanned: ${wxMsg.eventKey}`;
+      default:
+        return '';
+    }
+  }
+
+  /** Convert WeChat message to internal Message */
+  private wechatToMessage(wxMsg: WeChatMessage): Message {
+    return {
+      id: wxMsg.msgId ?? `wx-${wxMsg.createTime}`,
+      role: 'user',
+      content: wxMsg.content ?? '',
+      timestamp: wxMsg.createTime * 1000,
+      metadata: {
+        channel: 'wechat',
+        fromUser: wxMsg.fromUserName,
+        toUser: wxMsg.toUserName,
+        msgType: wxMsg.msgType,
+      },
+    };
+  }
+
+  /** Send template message */
+  async sendTemplateMessage(data: TemplateMessageData): Promise<boolean> {
+    // TODO: Implement
+    // const token = await this.getAccessToken();
+    // const url = `https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=${token}`;
+    // const res = await fetch(url, {
+    //   method: 'POST',
+    //   body: JSON.stringify({
+    //     touser: data.toUser,
+    //     template_id: data.templateId,
+    //     url: data.url,
+    //     data: data.data,
+    //   }),
+    // });
+    void data;
+    return true;
+  }
+
+  /** Generate QR code for login (stub) */
+  async generateLoginQR(): Promise<{ ticket: string; url: string; expireSeconds: number }> {
+    // TODO: Implement with WeChat QR code API
+    // const token = await this.getAccessToken();
+    // POST to https://api.weixin.qq.com/cgi-bin/qrcode/create
+    return {
+      ticket: 'stub-ticket',
+      url: 'https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=stub-ticket',
+      expireSeconds: 300,
+    };
+  }
+}

package/src/core/compose.ts

@@ -0,0 +1,77 @@
+import type { AgentContext, Message } from './types';
+
+/**
+ * Agent Composition — v0.8.0
+ * Combine multiple agents into a pipeline: Agent A output → Agent B input.
+ * Configurable in OAD: `compose: [agent-a, agent-b]`
+ */
+
+export type AgentHandler = (context: AgentContext, message: Message) => Promise<Message>;
+
+export interface ComposableAgent {
+  id: string;
+  name: string;
+  handler: AgentHandler;
+}
+
+export interface ComposeOptions {
+  /** Stop pipeline if any agent returns empty content */
+  stopOnEmpty?: boolean;
+  /** Transform output between agents */
+  transform?: (output: Message, nextAgentId: string) => Message;
+  /** Timeout per agent in ms */
+  timeoutMs?: number;
+}
+
+export class AgentPipeline {
+  private agents: ComposableAgent[] = [];
+  private options: ComposeOptions;
+
+  constructor(agents: ComposableAgent[], options: ComposeOptions = {}) {
+    this.agents = agents;
+    this.options = options;
+  }
+
+  /** Run the pipeline sequentially: each agent's output becomes the next agent's input */
+  async execute(context: AgentContext, initialMessage: Message): Promise<Message> {
+    let currentMessage = initialMessage;
+
+    for (const agent of this.agents) {
+      if (this.options.stopOnEmpty && !currentMessage.content.trim()) {
+        break;
+      }
+
+      // Apply transform if provided
+      if (this.options.transform) {
+        currentMessage = this.options.transform(currentMessage, agent.id);
+      }
+
+      if (this.options.timeoutMs) {
+        const result = await Promise.race([
+          agent.handler(context, currentMessage),
+          new Promise<never>((_, reject) =>
+            setTimeout(() => reject(new Error(`Agent ${agent.id} timed out`)), this.options.timeoutMs)
+          ),
+        ]);
+        currentMessage = result;
+      } else {
+        currentMessage = await agent.handler(context, currentMessage);
+      }
+    }
+
+    return currentMessage;
+  }
+
+  /** Get the pipeline agent IDs in order */
+  getAgentIds(): string[] {
+    return this.agents.map((a) => a.id);
+  }
+}
+
+/**
+ * Create a pipeline from an array of composable agents.
+ * Usage in OAD: `compose: [agent-a, agent-b, agent-c]`
+ */
+export function compose(agents: ComposableAgent[], options?: ComposeOptions): AgentPipeline {
+  return new AgentPipeline(agents, options);
+}