opc-agent 3.0.1 → 4.0.1

package/install.ps1

@@ -0,0 +1,154 @@
+# ============================================================================
+# OPC Agent 一键安装脚本 for Windows
+# 用法: irm https://raw.githubusercontent.com/Deepleaper/opc-agent/main/install.ps1 | iex
+# 高级: $env:OPC_YES='1'; $env:OPC_NO_OLLAMA='1'; irm ... | iex
+# ============================================================================
+
+$ErrorActionPreference = "Stop"
+
+# ── 颜色输出 ──────────────────────────────────────────────────
+function Write-Step($msg)  { Write-Host "`n━━━ $msg ━━━" -ForegroundColor Blue }
+function Write-Ok($msg)    { Write-Host "✅ $msg" -ForegroundColor Green }
+function Write-Warn($msg)  { Write-Host "⚠️  $msg" -ForegroundColor Yellow }
+function Write-Err($msg)   { Write-Host "❌ $msg" -ForegroundColor Red }
+function Write-Info($msg)  { Write-Host "ℹ️  $msg" -ForegroundColor Cyan }
+
+$AutoYes    = $env:OPC_YES -eq '1'
+$SkipOllama = $env:OPC_NO_OLLAMA -eq '1'
+
+function Confirm-Action($prompt) {
+    if ($AutoYes) { return $true }
+    $choice = Read-Host "❓ $prompt [Y/n]"
+    return ($choice -ne 'n' -and $choice -ne 'N' -and $choice -ne 'no')
+}
+
+# ── 检测操作系统 ──────────────────────────────────────────────
+Write-Step "🔍 检测操作系统 / Detecting OS"
+Write-Ok "Windows $([System.Environment]::OSVersion.Version) detected"
+
+# ── 检测 & 安装 Node.js ──────────────────────────────────────
+Write-Step "📦 检测 Node.js / Checking Node.js"
+$NeedNode = $false
+
+try {
+    $nodeVer = (node -v) -replace 'v','' -split '\.' | Select-Object -First 1
+    if ([int]$nodeVer -ge 18) {
+        Write-Ok "Node.js $(node -v) 已安装 / installed"
+    } else {
+        Write-Warn "Node.js $(node -v) 版本过低，需要 18+ / version too old"
+        $NeedNode = $true
+    }
+} catch {
+    Write-Warn "未检测到 Node.js / Node.js not found"
+    $NeedNode = $true
+}
+
+if ($NeedNode) {
+    Write-Info "将安装 Node.js 22 LTS / Installing Node.js 22 LTS"
+    if (Confirm-Action "安装 Node.js 22? / Install Node.js 22?") {
+        $installed = $false
+        # 尝试 winget
+        try {
+            winget install OpenJS.NodeJS.LTS --accept-package-agreements --accept-source-agreements
+            $installed = $true
+            Write-Ok "Node.js 通过 winget 安装成功 / installed via winget"
+        } catch {}
+
+        # 尝试 choco
+        if (-not $installed) {
+            try {
+                choco install nodejs-lts -y
+                $installed = $true
+                Write-Ok "Node.js 通过 Chocolatey 安装成功 / installed via Chocolatey"
+            } catch {}
+        }
+
+        if (-not $installed) {
+            Write-Err "自动安装失败 / Auto-install failed"
+            Write-Info "请手动下载安装 / Please download manually: https://nodejs.org/"
+            Start-Process "https://nodejs.org/en/download/"
+            exit 1
+        }
+
+        # 刷新 PATH
+        $env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
+    } else {
+        Write-Err "Node.js 是必需的 / Node.js is required"
+        Write-Info "下载地址 / Download: https://nodejs.org/"
+        exit 1
+    }
+}
+
+# ── 安装 OPC Agent ────────────────────────────────────────────
+Write-Step "🚀 安装 OPC Agent / Installing OPC Agent"
+Write-Info "npm install -g opc-agent ..."
+npm install -g opc-agent
+Write-Ok "OPC Agent 安装成功 / installed"
+
+# ── Ollama（可选）─────────────────────────────────────────────
+if (-not $SkipOllama) {
+    Write-Step "🦙 检测 Ollama / Checking Ollama"
+
+    $hasOllama = $false
+    try { ollama --version 2>$null; $hasOllama = $true } catch {}
+
+    if ($hasOllama) {
+        Write-Ok "Ollama 已安装 / installed"
+    } else {
+        Write-Warn "未检测到 Ollama / Ollama not found"
+        Write-Info "Ollama 可让你在本地运行 AI 模型（免费、数据不出门）"
+        Write-Info "Ollama lets you run AI models locally (free, private)"
+
+        if (Confirm-Action "安装 Ollama? / Install Ollama?") {
+            try {
+                winget install Ollama.Ollama --accept-package-agreements --accept-source-agreements
+                $env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
+                Write-Ok "Ollama 安装成功 / installed"
+                $hasOllama = $true
+            } catch {
+                Write-Warn "winget 安装失败，请手动下载 / Please download manually: https://ollama.com/download"
+                Start-Process "https://ollama.com/download"
+            }
+        }
+    }
+
+    # 拉取推荐模型
+    if ($hasOllama) {
+        Write-Step "🧠 推荐模型 / Recommended Models"
+        Write-Info "推荐拉取以下模型用于本地 Agent："
+        Write-Info "  • qwen2.5:7b — 中英文对话（4.7GB）"
+        Write-Info "  • nomic-embed-text — 文本向量化（274MB）"
+
+        if (Confirm-Action "拉取推荐模型? / Pull recommended models?") {
+            Write-Info "拉取 qwen2.5:7b ... (可能需要几分钟)"
+            try { ollama pull qwen2.5:7b; Write-Ok "qwen2.5:7b ✓" } catch { Write-Warn "拉取失败，可稍后手动: ollama pull qwen2.5:7b" }
+
+            Write-Info "拉取 nomic-embed-text ..."
+            try { ollama pull nomic-embed-text; Write-Ok "nomic-embed-text ✓" } catch { Write-Warn "拉取失败，可稍后手动: ollama pull nomic-embed-text" }
+        }
+    }
+}
+
+# ── 完成 ──────────────────────────────────────────────────────
+Write-Step "🎉 安装完成！/ Installation Complete!"
+Write-Host ""
+Write-Host "┌─────────────────────────────────────────────────┐" -ForegroundColor Green
+Write-Host "│  OPC Agent 已安装成功！                          │" -ForegroundColor Green
+Write-Host "│  OPC Agent installed successfully!               │" -ForegroundColor Green
+Write-Host "│                                                  │" -ForegroundColor Green
+Write-Host "│  快速开始 / Quick Start:                         │" -ForegroundColor Green
+Write-Host "│    opc init my-agent    # 创建 Agent             │" -ForegroundColor Green
+Write-Host "│    cd my-agent; npm i                            │" -ForegroundColor Green
+Write-Host "│    opc chat             # 开始对话               │" -ForegroundColor Green
+Write-Host "│                                                  │" -ForegroundColor Green
+Write-Host "│  可视化面板 / Dashboard:                          │" -ForegroundColor Green
+Write-Host "│    opc studio                                    │" -ForegroundColor Green
+Write-Host "│                                                  │" -ForegroundColor Green
+Write-Host "│  交互式设置 / Setup wizard:                       │" -ForegroundColor Green
+Write-Host "│    opc setup                                     │" -ForegroundColor Green
+Write-Host "└─────────────────────────────────────────────────┘" -ForegroundColor Green
+Write-Host ""
+
+if (Confirm-Action "现在打开 OPC Studio? / Open OPC Studio now?") {
+    opc studio
+}

package/install.sh

@@ -0,0 +1,164 @@
+#!/bin/bash
+# ============================================================================
+# OPC Agent 一键安装脚本 (macOS / Linux / WSL)
+# 用法: curl -fsSL https://raw.githubusercontent.com/Deepleaper/opc-agent/main/install.sh | bash
+# 高级: curl -fsSL ... | bash -s -- --yes --no-ollama
+# ============================================================================
+
+set -e
+
+# ── 颜色 & Emoji ──────────────────────────────────────────────
+RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'; BLUE='\033[0;34m'; CYAN='\033[0;36m'; NC='\033[0m'
+info()  { echo -e "${CYAN}ℹ️  $1${NC}"; }
+ok()    { echo -e "${GREEN}✅ $1${NC}"; }
+warn()  { echo -e "${YELLOW}⚠️  $1${NC}"; }
+err()   { echo -e "${RED}❌ $1${NC}"; }
+step()  { echo -e "\n${BLUE}━━━ $1 ━━━${NC}"; }
+
+# ── 参数解析 ──────────────────────────────────────────────────
+AUTO_YES=false
+SKIP_OLLAMA=false
+for arg in "$@"; do
+  case "$arg" in
+    --yes|-y)       AUTO_YES=true ;;
+    --no-ollama)    SKIP_OLLAMA=true ;;
+  esac
+done
+
+confirm() {
+  if $AUTO_YES; then return 0; fi
+  read -r -p "$(echo -e "${YELLOW}❓ $1 [Y/n]: ${NC}")" choice
+  case "$choice" in n|N|no|NO) return 1 ;; *) return 0 ;; esac
+}
+
+# ── 检测操作系统 ──────────────────────────────────────────────
+step "🔍 检测操作系统 / Detecting OS"
+OS="unknown"
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  OS="macos"
+  ok "macOS detected"
+elif grep -qi microsoft /proc/version 2>/dev/null; then
+  OS="wsl"
+  ok "WSL (Windows Subsystem for Linux) detected"
+elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+  OS="linux"
+  ok "Linux detected"
+else
+  err "不支持的操作系统 / Unsupported OS: $OSTYPE"
+  exit 1
+fi
+
+# ── 检测 & 安装 Node.js ──────────────────────────────────────
+step "📦 检测 Node.js / Checking Node.js"
+NEED_NODE=false
+
+if command -v node &>/dev/null; then
+  NODE_VER=$(node -v | sed 's/v//' | cut -d. -f1)
+  if [ "$NODE_VER" -ge 18 ]; then
+    ok "Node.js $(node -v) 已安装 / installed"
+  else
+    warn "Node.js $(node -v) 版本过低，需要 18+ / version too old, need 18+"
+    NEED_NODE=true
+  fi
+else
+  warn "未检测到 Node.js / Node.js not found"
+  NEED_NODE=true
+fi
+
+if $NEED_NODE; then
+  info "将通过 nvm 安装 Node.js 22 LTS / Installing Node.js 22 via nvm"
+  if confirm "安装 Node.js 22? / Install Node.js 22?"; then
+    if command -v nvm &>/dev/null || [ -s "$HOME/.nvm/nvm.sh" ]; then
+      [ -s "$HOME/.nvm/nvm.sh" ] && . "$HOME/.nvm/nvm.sh"
+      info "nvm 已存在，安装 Node 22... / nvm found, installing Node 22..."
+    else
+      info "安装 nvm... / Installing nvm..."
+      curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
+      export NVM_DIR="$HOME/.nvm"
+      [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
+    fi
+    nvm install 22
+    nvm use 22
+    ok "Node.js $(node -v) 安装成功 / installed successfully"
+  else
+    err "Node.js 是必需的 / Node.js is required"
+    echo "手动安装 / Manual install: https://nodejs.org/"
+    exit 1
+  fi
+fi
+
+# ── 安装 OPC Agent ────────────────────────────────────────────
+step "🚀 安装 OPC Agent / Installing OPC Agent"
+info "npm install -g opc-agent ..."
+npm install -g opc-agent
+ok "OPC Agent $(opc --version 2>/dev/null || echo '') 安装成功 / installed"
+
+# ── Ollama（可选）─────────────────────────────────────────────
+if ! $SKIP_OLLAMA; then
+  step "🦙 检测 Ollama / Checking Ollama"
+
+  if command -v ollama &>/dev/null; then
+    ok "Ollama 已安装 / installed ($(ollama --version 2>/dev/null || echo 'ok'))"
+  else
+    warn "未检测到 Ollama / Ollama not found"
+    info "Ollama 可让你在本地运行 AI 模型（免费、数据不出门）"
+    info "Ollama lets you run AI models locally (free, private)"
+
+    if confirm "安装 Ollama? / Install Ollama?"; then
+      if [ "$OS" = "macos" ]; then
+        if command -v brew &>/dev/null; then
+          brew install ollama
+        else
+          info "请从 https://ollama.com/download 下载安装"
+          info "Download from https://ollama.com/download"
+          open "https://ollama.com/download" 2>/dev/null || true
+        fi
+      else
+        curl -fsSL https://ollama.com/install.sh | sh
+      fi
+      ok "Ollama 安装成功 / installed"
+    else
+      info "跳过 Ollama / Skipping Ollama"
+    fi
+  fi
+
+  # 拉取推荐模型
+  if command -v ollama &>/dev/null; then
+    step "🧠 推荐模型 / Recommended Models"
+    info "推荐拉取以下模型用于本地 Agent："
+    info "  • qwen2.5:7b — 中英文对话（4.7GB）"
+    info "  • nomic-embed-text — 文本向量化（274MB）"
+
+    if confirm "拉取推荐模型? / Pull recommended models?"; then
+      info "拉取 qwen2.5:7b ... (可能需要几分钟)"
+      ollama pull qwen2.5:7b && ok "qwen2.5:7b ✓" || warn "qwen2.5:7b 拉取失败，可稍后手动: ollama pull qwen2.5:7b"
+
+      info "拉取 nomic-embed-text ..."
+      ollama pull nomic-embed-text && ok "nomic-embed-text ✓" || warn "拉取失败，可稍后手动: ollama pull nomic-embed-text"
+    fi
+  fi
+fi
+
+# ── 启动 Studio ───────────────────────────────────────────────
+step "🎉 安装完成！/ Installation Complete!"
+echo ""
+echo -e "${GREEN}┌─────────────────────────────────────────────────┐${NC}"
+echo -e "${GREEN}│  OPC Agent 已安装成功！                          │${NC}"
+echo -e "${GREEN}│  OPC Agent installed successfully!               │${NC}"
+echo -e "${GREEN}│                                                  │${NC}"
+echo -e "${GREEN}│  快速开始 / Quick Start:                         │${NC}"
+echo -e "${GREEN}│    opc init my-agent    # 创建 Agent             │${NC}"
+echo -e "${GREEN}│    cd my-agent && npm i                          │${NC}"
+echo -e "${GREEN}│    opc chat             # 开始对话               │${NC}"
+echo -e "${GREEN}│                                                  │${NC}"
+echo -e "${GREEN}│  可视化面板 / Dashboard:                          │${NC}"
+echo -e "${GREEN}│    opc studio                                    │${NC}"
+echo -e "${GREEN}│                                                  │${NC}"
+echo -e "${GREEN}│  交互式设置 / Setup wizard:                       │${NC}"
+echo -e "${GREEN}│    opc setup                                     │${NC}"
+echo -e "${GREEN}└─────────────────────────────────────────────────┘${NC}"
+echo ""
+
+if confirm "现在打开 OPC Studio? / Open OPC Studio now?"; then
+  opc studio
+fi

package/package.json

@@ -1,52 +1,63 @@
-{
-  "name": "opc-agent",
-  "version": "3.0.1",
-  "description": "Open Agent Framework — Build, test, and run AI Agents for business workstations",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "opc": "dist/cli.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "postbuild": "xcopy /E /I /Y src\\studio-ui dist\\studio-ui",
-    "test": "vitest run",
-    "dev": "tsc --watch",
-    "lint": "tsc --noEmit",
-    "docs:dev": "vitepress dev docs",
-    "docs:build": "vitepress build docs",
-    "docs:preview": "vitepress preview docs"
-  },
-  "keywords": [
-    "agent",
-    "ai",
-    "llm",
-    "framework",
-    "typescript",
-    "agent-framework"
-  ],
-  "author": "Deepleaper",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Deepleaper/opc-agent.git"
-  },
-  "dependencies": {
-    "agent-workstation": "^2.0.1",
-    "agentkits": "^1.10.2",
-    "commander": "^12.0.0",
-    "express": "^4.21.0",
-    "js-yaml": "^4.1.0",
-    "ws": "^8.20.0",
-    "zod": "^3.23.0"
-  },
-  "devDependencies": {
-    "@types/express": "^4.17.21",
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^20.11.0",
-    "@types/ws": "^8.18.1",
-    "typescript": "^5.5.0",
-    "vitepress": "^1.5.0",
-    "vitest": "^2.0.0"
-  }
-}
+{
+  "name": "opc-agent",
+  "version": "4.0.1",
+  "description": "Open Agent Framework — Build, test, and run AI Agents for business workstations",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "opc": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "postbuild": "xcopy /E /I /Y src\\studio-ui dist\\studio-ui",
+    "test": "vitest run",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit",
+    "setup": "opc setup",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
+  },
+  "keywords": [
+    "agent",
+    "ai",
+    "llm",
+    "framework",
+    "typescript",
+    "agent-framework"
+  ],
+  "author": "Deepleaper",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Deepleaper/opc-agent.git"
+  },
+  "dependencies": {
+    "agent-workstation": "^2.0.1",
+    "agentkits": "^2.0.0",
+    "commander": "^12.0.0",
+    "express": "^4.21.0",
+    "js-yaml": "^4.1.0",
+    "mammoth": "^1.12.0",
+    "pdf-parse": "^1.1.4",
+    "ws": "^8.20.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.11.0",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.5.0",
+    "vitepress": "^1.5.0",
+    "vitest": "^2.0.0"
+  },
+  "peerDependencies": {
+    "deepbrain": "^2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "deepbrain": {
+      "optional": true
+    }
+  }
+}

package/src/channels/dingtalk.ts

@@ -0,0 +1,46 @@
+import { BaseChannel } from './index';
+import type { Message } from '../core/types';
+
+export interface DingTalkChannelConfig {
+  webhookUrl: string;
+  secret?: string;
+  appKey?: string;
+  appSecret?: string;
+}
+
+export class DingTalkChannel extends BaseChannel {
+  readonly type = 'dingtalk';
+  private config: DingTalkChannelConfig;
+  private running = false;
+
+  constructor(config: DingTalkChannelConfig) {
+    super();
+    if (!config.webhookUrl) {
+      throw new Error('DingTalkChannel requires webhookUrl in config');
+    }
+    this.config = config;
+  }
+
+  async start(): Promise<void> {
+    this.running = true;
+  }
+
+  async stop(): Promise<void> {
+    this.running = false;
+  }
+
+  async send(chatId: string, text: string): Promise<void> {
+    if (!this.running) {
+      throw new Error('DingTalkChannel: not started. Call start() first.');
+    }
+    const body = JSON.stringify({ msgtype: 'text', text: { content: text } });
+    const res = await fetch(this.config.webhookUrl, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body,
+    });
+    if (!res.ok) {
+      throw new Error(`DingTalk webhook failed: ${res.status}`);
+    }
+  }
+}

package/src/channels/googlechat.ts

@@ -0,0 +1,42 @@
+import { BaseChannel } from './index';
+import type { Message } from '../core/types';
+
+export interface GoogleChatChannelConfig {
+  webhookUrl: string;
+}
+
+export class GoogleChatChannel extends BaseChannel {
+  readonly type = 'googlechat';
+  private config: GoogleChatChannelConfig;
+  private running = false;
+
+  constructor(config: GoogleChatChannelConfig) {
+    super();
+    if (!config.webhookUrl) {
+      throw new Error('GoogleChatChannel requires webhookUrl in config');
+    }
+    this.config = config;
+  }
+
+  async start(): Promise<void> {
+    this.running = true;
+  }
+
+  async stop(): Promise<void> {
+    this.running = false;
+  }
+
+  async send(spaceId: string, text: string): Promise<void> {
+    if (!this.running) {
+      throw new Error('GoogleChatChannel: not started. Call start() first.');
+    }
+    const res = await fetch(this.config.webhookUrl, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ text }),
+    });
+    if (!res.ok) {
+      throw new Error(`Google Chat webhook failed: ${res.status}`);
+    }
+  }
+}

package/src/channels/imessage.ts

@@ -0,0 +1,32 @@
+import { BaseChannel } from './index';
+import type { Message } from '../core/types';
+
+export interface IMessageChannelConfig {
+  applescriptPath?: string;
+}
+
+export class IMessageChannel extends BaseChannel {
+  readonly type = 'imessage';
+  private config: IMessageChannelConfig;
+
+  constructor(config: IMessageChannelConfig = {}) {
+    super();
+    this.config = config;
+  }
+
+  async start(): Promise<void> {
+    try {
+      require('macOS iMessage CLI');
+    } catch {
+      throw new Error('Install macOS iMessage CLI to use the IMessageChannel. Run: npm install macOS iMessage CLI');
+    }
+  }
+
+  async stop(): Promise<void> {
+    // cleanup
+  }
+
+  async send(chatId: string, text: string): Promise<void> {
+    throw new Error('IMessageChannel: not yet connected. Call start() first.');
+  }
+}

package/src/channels/irc.ts

@@ -0,0 +1,82 @@
+import { BaseChannel } from './index';
+import type { Message } from '../core/types';
+
+export interface IRCChannelConfig {
+  host: string;
+  port?: number;
+  nick: string;
+  channels: string[];
+  tls?: boolean;
+  password?: string;
+}
+
+export class IRCChannel extends BaseChannel {
+  readonly type = 'irc';
+  private config: IRCChannelConfig;
+  private client: any = null;
+  private running = false;
+
+  constructor(config: IRCChannelConfig) {
+    super();
+    if (!config.host || !config.nick || !config.channels?.length) {
+      throw new Error('IRCChannel requires host, nick, and channels in config');
+    }
+    this.config = config;
+  }
+
+  async start(): Promise<void> {
+    let IRC: any;
+    try {
+      IRC = require('irc-framework');
+    } catch {
+      throw new Error('Install irc-framework to use the IRCChannel. Run: npm install irc-framework');
+    }
+    this.client = new IRC.Client();
+    this.client.connect({
+      host: this.config.host,
+      port: this.config.port ?? (this.config.tls ? 6697 : 6667),
+      nick: this.config.nick,
+      tls: this.config.tls ?? false,
+      password: this.config.password,
+    });
+
+    await new Promise<void>((resolve, reject) => {
+      this.client.on('registered', () => {
+        for (const ch of this.config.channels) {
+          this.client.join(ch);
+        }
+        resolve();
+      });
+      this.client.on('error', (err: any) => reject(new Error(`IRC connection error: ${err.message || err}`)));
+    });
+
+    this.running = true;
+
+    this.client.on('privmsg', async (event: any) => {
+      if (!this.handler) return;
+      const msg: Message = {
+        id: Date.now().toString(),
+        role: 'user',
+        content: event.message,
+        timestamp: Date.now(),
+        metadata: { channel: event.target, nick: event.nick },
+      };
+      await this.handler(msg);
+    });
+  }
+
+  async stop(): Promise<void> {
+    if (this.client) {
+      this.client.quit('Goodbye');
+      this.client = null;
+    }
+    this.running = false;
+  }
+
+  async send(target: string, text: string): Promise<void> {
+    if (!this.running || !this.client) {
+      throw new Error('IRCChannel: not started. Call start() first.');
+    }
+    this.client.say(target, text);
+  }
+}

package/src/channels/line.ts

@@ -0,0 +1,33 @@
+import { BaseChannel } from './index';
+import type { Message } from '../core/types';
+
+export interface LINEChannelConfig {
+  channelAccessToken?: string;
+  channelSecret?: string;
+}
+
+export class LINEChannel extends BaseChannel {
+  readonly type = 'line';
+  private config: LINEChannelConfig;
+
+  constructor(config: LINEChannelConfig = {}) {
+    super();
+    this.config = config;
+  }
+
+  async start(): Promise<void> {
+    try {
+      require('@line/bot-sdk');
+    } catch {
+      throw new Error('Install @line/bot-sdk to use the LINEChannel. Run: npm install @line/bot-sdk');
+    }
+  }
+
+  async stop(): Promise<void> {
+    // cleanup
+  }
+
+  async send(chatId: string, text: string): Promise<void> {
+    throw new Error('LINEChannel: not yet connected. Call start() first.');
+  }
+}