@vrs-soft/wecom-aibot-mcp 2.4.25 → 2.6.0

package/dist/hooks/permission-hook.js

@@ -0,0 +1,325 @@
+#!/usr/bin/env node
+/**
+ * wecom-aibot-mcp PermissionRequest hook (Node.js, 跨平台)
+ *
+ * 由 Claude Code 在工具调用前 stdin 喂入 JSON：
+ *   { tool_name, tool_input, ... }
+ * 我们 stdout 输出：
+ *   { hookSpecificOutput: { hookEventName, decision: { behavior, message? } } }
+ *
+ * 决策逻辑：
+ *   1. MCP 工具 / 只读工具 → 直接 allow
+ *   2. 沿进程树向上查 active-projects.json，未匹配 → exit 0（不拦截）
+ *   3. 项目无 .claude/wecom-aibot.json 或 wechatMode!=true → exit 0
+ *   4. 探测本地 daemon /health；channel 模式或本地不通则尝试远程
+ *   5. POST /approve 拿 taskId，轮询 /approval_status/:taskId
+ *   6. 超时（autoApproveTimeout）→ 智能策略：
+ *      - rm 命令 → 拒
+ *      - 项目内 → 允许，项目外 → 拒
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { execSync } from 'child_process';
+const MCP_PORT = 18963;
+const HOME = os.homedir();
+const ACTIVE_INDEX = path.join(HOME, '.wecom-aibot-mcp', 'active-projects.json');
+const DEBUG_FILE = path.join(HOME, '.wecom-aibot-mcp', 'debug');
+const CLAUDE_JSON = path.join(HOME, '.claude.json');
+const IS_WIN = process.platform === 'win32';
+function log(msg) {
+    if (fs.existsSync(DEBUG_FILE)) {
+        process.stderr.write(`[${new Date().toISOString()}] ${msg}\n`);
+    }
+}
+function emit(decision) {
+    const out = {
+        hookSpecificOutput: {
+            hookEventName: 'PermissionRequest',
+            decision,
+        },
+    };
+    process.stdout.write(JSON.stringify(out) + '\n');
+    // 显式退出，避免事件循环里残留的 timer / fetch 让进程多挂几秒
+    process.exit(0);
+}
+function readStdinSync() {
+    // hook 进程很短命，同步读 stdin 完整内容
+    const chunks = [];
+    try {
+        const buf = Buffer.alloc(65536);
+        while (true) {
+            const n = fs.readSync(0, buf, 0, buf.length, null);
+            if (!n)
+                break;
+            chunks.push(Buffer.from(buf.subarray(0, n)));
+        }
+    }
+    catch {
+        // EAGAIN / closed
+    }
+    return Buffer.concat(chunks).toString('utf-8');
+}
+function getParentPid(pid) {
+    if (!pid || pid <= 1)
+        return 0;
+    try {
+        if (IS_WIN) {
+            const out = execSync(`wmic process where ProcessId=${pid} get ParentProcessId /value`, {
+                stdio: ['ignore', 'pipe', 'ignore'],
+            }).toString();
+            const m = out.match(/ParentProcessId=(\d+)/);
+            return m ? parseInt(m[1], 10) : 0;
+        }
+        return parseInt(execSync(`ps -o ppid= -p ${pid}`, {
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).toString().trim(), 10) || 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function findProjectFromActiveIndex(startPid) {
+    if (!fs.existsSync(ACTIVE_INDEX)) {
+        log('No active-projects index');
+        return null;
+    }
+    let entries = [];
+    try {
+        entries = JSON.parse(fs.readFileSync(ACTIVE_INDEX, 'utf-8'));
+        if (!Array.isArray(entries))
+            return null;
+    }
+    catch {
+        return null;
+    }
+    let pid = startPid;
+    for (let i = 0; i < 8; i++) {
+        if (!pid || pid <= 1)
+            break;
+        const hit = entries.find((e) => e?.pid === pid);
+        if (hit?.projectDir) {
+            log(`Matched PID ${pid} -> ${hit.projectDir}`);
+            return hit.projectDir;
+        }
+        const parent = getParentPid(pid);
+        if (!parent || parent === pid)
+            break;
+        pid = parent;
+    }
+    return null;
+}
+async function fetchJson(url, init) {
+    const ctrl = new AbortController();
+    const t = setTimeout(() => ctrl.abort(), init?.timeoutMs ?? 5000);
+    try {
+        const res = await fetch(url, { ...init, signal: ctrl.signal });
+        if (!res.ok)
+            return null;
+        return await res.json().catch(() => null);
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(t);
+    }
+}
+async function probeLocal() {
+    const baseUrl = `http://127.0.0.1:${MCP_PORT}`;
+    const data = await fetchJson(`${baseUrl}/health`, { timeoutMs: 2000 });
+    return data?.status === 'ok' ? { baseUrl } : null;
+}
+async function probeRemote() {
+    if (!fs.existsSync(CLAUDE_JSON))
+        return null;
+    let claudeConfig;
+    try {
+        claudeConfig = JSON.parse(fs.readFileSync(CLAUDE_JSON, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+    const channel = claudeConfig?.mcpServers?.['wecom-aibot-channel'];
+    const remoteUrl = channel?.env?.MCP_URL;
+    const remoteToken = channel?.env?.MCP_AUTH_TOKEN;
+    if (!remoteUrl)
+        return null;
+    const baseUrl = remoteUrl.replace(/\/+$/, '');
+    const headers = {};
+    if (remoteToken)
+        headers['Authorization'] = `Bearer ${remoteToken}`;
+    const data = await fetchJson(`${baseUrl}/health`, { timeoutMs: 5000, headers });
+    if (data?.status !== 'ok')
+        return null;
+    return remoteToken ? { baseUrl, authHeader: `Bearer ${remoteToken}` } : { baseUrl };
+}
+function authedHeaders(ep, extra) {
+    const h = { ...(extra || {}) };
+    if (ep.authHeader)
+        h['Authorization'] = ep.authHeader;
+    return h;
+}
+function extractStringField(obj, ...keys) {
+    for (const k of keys) {
+        if (typeof obj?.[k] === 'string' && obj[k])
+            return obj[k];
+    }
+    return '';
+}
+function isInProject(toolName, toolInput, projectDir) {
+    if (toolName === 'Bash') {
+        const cmd = toolInput?.command || '';
+        if (cmd.includes(projectDir))
+            return true;
+        const absPaths = cmd.match(/(^|[ \t])(\/[A-Za-z0-9][^ \t>|;&]*|[A-Za-z]:\\[^ \t>|;&]+)/g) || [];
+        const safe = (p) => p.startsWith(projectDir) ||
+            /^(\/tmp\/|\/var\/tmp\/|\/dev\/null|\/dev\/std|\/dev\/fd\/)/.test(p) ||
+            /^[A-Za-z]:\\(Users\\[^\\]+\\AppData\\Local\\Temp\\|Windows\\Temp\\)/i.test(p);
+        const outside = absPaths.map(s => s.trim()).filter(p => !safe(p));
+        if (absPaths.length > 0 && outside.length > 0)
+            return false;
+        // 无可疑外部路径 → 以 cwd 为准
+        return process.cwd().startsWith(projectDir);
+    }
+    if (toolName === 'Write' || toolName === 'Edit') {
+        const fp = extractStringField(toolInput, 'file_path');
+        return !fp || fp.startsWith(projectDir) || !path.isAbsolute(fp);
+    }
+    const fp = extractStringField(toolInput, 'file_path', 'path', 'directory');
+    if (!fp)
+        return true; // 无路径信息时倾向放行
+    return fp.startsWith(projectDir) || !path.isAbsolute(fp);
+}
+function isDeleteCommand(toolName, toolInput) {
+    if (toolName !== 'Bash')
+        return false;
+    const cmd = (toolInput?.command || '').toString();
+    const firstLine = cmd.split('\n')[0] || '';
+    return /(^|[;&|(]\s*)(rm\s|rmdir\s|del\s|Remove-Item\s)/i.test(firstLine);
+}
+async function notifyTimeout(ep, taskId, result, reason) {
+    await fetchJson(`${ep.baseUrl}/approval_timeout/${taskId}`, {
+        method: 'POST',
+        timeoutMs: 5000,
+        headers: authedHeaders(ep, { 'Content-Type': 'application/json' }),
+        body: JSON.stringify({ result, reason }),
+    });
+}
+async function main() {
+    const raw = readStdinSync();
+    let input = {};
+    try {
+        input = raw ? JSON.parse(raw) : {};
+    }
+    catch {
+        log('stdin not JSON, exit 0');
+        process.exit(0);
+    }
+    const toolName = input?.tool_name || '';
+    log(`tool_name=${toolName}`);
+    // MCP 工具：放行
+    if (toolName.startsWith('mcp__')) {
+        emit({ behavior: 'allow' });
+        return;
+    }
+    // 只读工具：放行
+    const readOnly = new Set([
+        'Read', 'Glob', 'Grep', 'LS', 'TaskList', 'TaskGet', 'TaskOutput', 'TaskStop',
+        'CronList', 'CronCreate', 'CronDelete', 'AskUserQuestion', 'Skill',
+        'ListMcpResourcesTool', 'EnterPlanMode', 'ExitPlanMode',
+        'WebSearch', 'WebFetch', 'NotebookEdit',
+    ]);
+    if (readOnly.has(toolName)) {
+        emit({ behavior: 'allow' });
+        return;
+    }
+    // 沿进程树查 active-projects.json
+    const projectDir = findProjectFromActiveIndex(process.ppid || process.pid);
+    if (!projectDir) {
+        log('No active project match');
+        process.exit(0);
+    }
+    const configFile = path.join(projectDir, '.claude', 'wecom-aibot.json');
+    if (!fs.existsSync(configFile)) {
+        log('No wecom-aibot.json in project');
+        process.exit(0);
+    }
+    let cfg;
+    try {
+        cfg = JSON.parse(fs.readFileSync(configFile, 'utf-8'));
+    }
+    catch {
+        process.exit(0);
+    }
+    if (cfg?.wechatMode !== true) {
+        log('wechatMode not true');
+        process.exit(0);
+    }
+    const mode = cfg?.mode === 'channel' ? 'channel' : 'http';
+    const endpoint = mode === 'channel'
+        ? (await probeRemote())
+        : ((await probeLocal()) || (await probeRemote()));
+    if (!endpoint) {
+        log('No reachable MCP server');
+        process.exit(0);
+    }
+    // 提交审批
+    const body = {
+        tool_name: toolName,
+        tool_input: input?.tool_input ?? {},
+        projectDir,
+        robotName: cfg?.robotName || '',
+        ccId: cfg?.ccId || '',
+    };
+    const approveRes = await fetchJson(`${endpoint.baseUrl}/approve`, {
+        method: 'POST',
+        timeoutMs: 10000,
+        headers: authedHeaders(endpoint, { 'Content-Type': 'application/json' }),
+        body: JSON.stringify(body),
+    });
+    const taskId = approveRes?.taskId || '';
+    if (!taskId) {
+        log('No taskId returned');
+        process.exit(0);
+    }
+    // 轮询
+    const timeoutSec = Number(cfg?.autoApproveTimeout) || 300;
+    const maxPoll = Math.max(1, Math.ceil(timeoutSec / 2));
+    log(`Polling taskId=${taskId} maxPoll=${maxPoll}`);
+    for (let i = 0; i < maxPoll; i++) {
+        await new Promise(r => setTimeout(r, 2000));
+        const data = await fetchJson(`${endpoint.baseUrl}/approval_status/${taskId}`, {
+            timeoutMs: 3000,
+            headers: authedHeaders(endpoint),
+        });
+        const result = data?.result;
+        if (result === 'allow-once' || result === 'allow-always') {
+            emit({ behavior: 'allow' });
+            return;
+        }
+        if (result === 'deny') {
+            emit({ behavior: 'deny', message: '用户拒绝' });
+            return;
+        }
+    }
+    // 超时智能决策
+    const toolInput = input?.tool_input ?? {};
+    if (isDeleteCommand(toolName, toolInput)) {
+        await notifyTimeout(endpoint, taskId, 'deny', '超时自动拒绝：删除操作需人工确认');
+        emit({ behavior: 'deny', message: '超时自动拒绝：删除操作需人工确认' });
+        return;
+    }
+    if (isInProject(toolName, toolInput, projectDir)) {
+        await notifyTimeout(endpoint, taskId, 'allow-once', '超时自动允许：项目内操作');
+        emit({ behavior: 'allow', message: '超时自动允许：项目内操作' });
+        return;
+    }
+    await notifyTimeout(endpoint, taskId, 'deny', '超时自动拒绝：项目外操作需人工确认');
+    emit({ behavior: 'deny', message: '超时自动拒绝：项目外操作需人工确认' });
+}
+main().catch(err => {
+    log(`hook error: ${err?.message || err}`);
+    // 任何错误都让 Claude 继续（exit 0 表示不干预）
+    process.exit(0);
+});

package/dist/hooks/stop-hook.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/hooks/stop-hook.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+/**
+ * wecom-aibot-mcp Stop hook (Node.js, 跨平台)
+ *
+ * Claude 准备停止时触发。如果当前项目处于微信模式，输出 exit code 2 阻止停止，
+ * 同时通过 stderr 提示 Claude 调用 get_pending_messages 恢复轮询。
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+const MCP_PORT = 18963;
+const HOME = os.homedir();
+const DEBUG_FILE = path.join(HOME, '.wecom-aibot-mcp', 'debug');
+const CLAUDE_JSON = path.join(HOME, '.claude.json');
+function log(msg) {
+    if (fs.existsSync(DEBUG_FILE)) {
+        process.stderr.write(`[${new Date().toISOString()}] [stop] ${msg}\n`);
+    }
+}
+function readStdinSync() {
+    const chunks = [];
+    try {
+        const buf = Buffer.alloc(65536);
+        while (true) {
+            const n = fs.readSync(0, buf, 0, buf.length, null);
+            if (!n)
+                break;
+            chunks.push(Buffer.from(buf.subarray(0, n)));
+        }
+    }
+    catch { /* ignore */ }
+    return Buffer.concat(chunks).toString('utf-8');
+}
+async function fetchHealth(url, headers, timeoutMs = 2000) {
+    const ctrl = new AbortController();
+    const t = setTimeout(() => ctrl.abort(), timeoutMs);
+    try {
+        const res = await fetch(`${url}/health`, { signal: ctrl.signal, headers });
+        if (!res.ok)
+            return false;
+        const data = await res.json().catch(() => null);
+        return data?.status === 'ok';
+    }
+    catch {
+        return false;
+    }
+    finally {
+        clearTimeout(t);
+    }
+}
+async function main() {
+    // 消费 stdin（Claude 会传 stop 事件 JSON，我们不需要内容）
+    readStdinSync();
+    const projectDir = process.cwd();
+    const configFile = path.join(projectDir, '.claude', 'wecom-aibot.json');
+    if (!fs.existsSync(configFile)) {
+        log('no config, allow stop');
+        process.exit(0);
+    }
+    let cfg;
+    try {
+        cfg = JSON.parse(fs.readFileSync(configFile, 'utf-8'));
+    }
+    catch {
+        process.exit(0);
+    }
+    if (cfg?.wechatMode !== true) {
+        log('wechatMode not true, allow stop');
+        process.exit(0);
+    }
+    const ccId = cfg?.ccId || '';
+    if (!ccId) {
+        log('no ccId, allow stop');
+        process.exit(0);
+    }
+    // 探测 daemon 是否在线，离线就允许停止
+    let alive = await fetchHealth(`http://127.0.0.1:${MCP_PORT}`);
+    if (!alive && fs.existsSync(CLAUDE_JSON)) {
+        try {
+            const claudeConfig = JSON.parse(fs.readFileSync(CLAUDE_JSON, 'utf-8'));
+            const channel = claudeConfig?.mcpServers?.['wecom-aibot-channel'];
+            const remoteUrl = channel?.env?.MCP_URL;
+            const token = channel?.env?.MCP_AUTH_TOKEN;
+            if (remoteUrl) {
+                const headers = {};
+                if (token)
+                    headers['Authorization'] = `Bearer ${token}`;
+                alive = await fetchHealth(remoteUrl.replace(/\/+$/, ''), headers, 5000);
+            }
+        }
+        catch { /* ignore */ }
+    }
+    if (!alive) {
+        log('MCP server offline, allow stop');
+        process.exit(0);
+    }
+    log(`WeChat mode active, blocking stop for ccId=${ccId}`);
+    process.stderr.write(`任务已完成，请调用 mcp__wecom-aibot__get_pending_messages(cc_id="${ccId}", timeout_ms=30000) 恢复微信消息轮询\n`);
+    process.exit(2);
+}
+main().catch(() => process.exit(0));

package/dist/http-server.d.ts

@@ -57,6 +57,7 @@ export declare function clearCcIdRegistry(): {
     entries: string[];
 };
 export declare function getRobotByCcId(ccId: string): string | null;
+export declare function touchCcId(ccId: string): void;
 export declare function getProjectDirByCcId(ccId: string): string | null;
 export declare function getCCRegistryEntry(ccId: string): CCRegistryEntry | null;
 export declare function getCCCount(): number;

package/dist/http-server.js

@@ -23,7 +23,7 @@ import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/
 import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
 import { registerTools } from './tools/index.js';
 import { getClient, getConnectionState, getAllConnectionStates, connectAllRobots } from './connection-manager.js';
-import { subscribeWecomMessage } from './message-bus.js';
+import { subscribeWecomMessage, subscribeCcMessageByTarget } from './message-bus.js';
 import { listAllRobots, VERSION, getAuthToken } from './config-wizard.js';
 import { logger } from './logger.js';
 // ESM 兼容的 __dirname
@@ -171,7 +171,19 @@ export function clearCcIdRegistry() {
     return { cleared: entries.length, entries };
 }
 export function getRobotByCcId(ccId) {
-    return ccIdRegistry.get(ccId)?.robotName || null;
+    const entry = ccIdRegistry.get(ccId);
+    if (!entry)
+        return null;
+    // 任何 lookup 都视为 CC 还活着，刷新 lastOnline 防止 30 分钟 idle 被 stale-cleanup
+    // 否则 channel 模式下 SSE 长连接还活、但 ccIdRegistry 被清，send_message 立刻报「未在微信模式」
+    entry.lastOnline = Date.now();
+    return entry.robotName;
+}
+// 显式刷新 ccId 的 lastOnline（SSE 心跳等场景调用）
+export function touchCcId(ccId) {
+    const entry = ccIdRegistry.get(ccId);
+    if (entry)
+        entry.lastOnline = Date.now();
 }
 export function getProjectDirByCcId(ccId) {
     return ccIdRegistry.get(ccId)?.projectDir || null;
@@ -661,6 +673,41 @@ export async function startHttpServer(_server, port = HTTP_PORT, httpsConfig) {
                 res.end(JSON.stringify({ ok: true, ...result }));
                 return;
             }
+            // DELETE /admin/ccid/:id - 注销单个 ccId 并断开它的所有 SSE 客户端连接
+            // 让对应 channel-server 在 3s 内自动 re-call enter_headless_mode → connectRobot 重建链路
+            // 必须配置全局 auth token 才能用（避免裸暴露）
+            const ccidAdminMatch = url.match(/^\/admin\/ccid\/(.+)$/);
+            if (req.method === 'DELETE' && ccidAdminMatch) {
+                if (!getAuthToken()) {
+                    res.writeHead(403, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: '/admin/ccid 需要先配置 Auth Token（--set-token）' }));
+                    return;
+                }
+                const targetCcId = decodeURIComponent(ccidAdminMatch[1]);
+                const entry = ccIdRegistry.get(targetCcId);
+                if (!entry) {
+                    res.writeHead(404, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'ccId not found', ccId: targetCcId }));
+                    return;
+                }
+                // 关闭并清理所有匹配该 ccId 的 SSE 客户端
+                const closedClients = [];
+                for (const [clientId, client] of sseClients) {
+                    if (client.ccId === targetCcId) {
+                        try {
+                            client.res.end();
+                        }
+                        catch { /* ignore */ }
+                        sseClients.delete(clientId);
+                        closedClients.push(clientId);
+                    }
+                }
+                unregisterCcId(targetCcId);
+                logger.info('ccId admin unregister', { ccId: targetCcId, robot: entry.robotName, closedSse: closedClients.length });
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: true, ccId: targetCcId, robot: entry.robotName, closedSseClients: closedClients.length }));
+                return;
+            }
             // ============================================
             // 调试端点统一拦截
             // ============================================
@@ -1121,15 +1168,28 @@ function handleSSEConnect(req, res, _url) {
     logger.log(`[http] SSE 客户端连接: clientId=${clientId}, ccId=${targetCcId}, robotName=${entry.robotName}`);
     // 发送连接确认
     res.write(`event: connected\ndata: {"clientId":"${clientId}","ccId":"${targetCcId}"}\n\n`);
-    // 心跳机制：每 15 秒发送注释行保持连接活跃
+    // 心跳机制：每 15 秒发送注释行保持连接活跃 + 刷新 ccIdRegistry 的 lastOnline
+    // 避免 channel 模式 CC 长时间 idle 时 SSE 还活但 ccIdRegistry 被 30 分钟 stale-cleanup
     const heartbeatInterval = setInterval(() => {
-        // SSE 注释行（以冒号开头）会被客户端忽略，但保持连接
         res.write(': heartbeat\n\n');
+        touchCcId(targetCcId);
         logger.log(`[http] SSE 心跳发送: clientId=${clientId}`);
     }, 15000);
+    // 订阅发往当前 ccId 的 CC 间消息，转发为 cc_message SSE event
+    const ccSub = subscribeCcMessageByTarget(targetCcId, (msg) => {
+        try {
+            const data = JSON.stringify(msg);
+            res.write(`event: cc_message\ndata: ${data}\n\n`);
+            logger.info('cc_message pushed', { from: msg.fromCc, to: msg.toCc, msgId: msg.msgId, kind: msg.kind });
+        }
+        catch (err) {
+            logger.error(`[http] cc_message 推送失败 clientId=${clientId}:`, err);
+        }
+    });
     // 处理客户端断开
     req.on('close', () => {
         clearInterval(heartbeatInterval);
+        ccSub.unsubscribe();
         sseClients.delete(clientId);
         logger.log(`[http] SSE 客户端断开: clientId=${clientId}`);
     });

package/dist/message-bus.d.ts

@@ -23,6 +23,16 @@ export interface WecomMessage {
     timestamp: number;
     quoteContent?: string;
 }
+export interface CcMessage {
+    msgId: string;
+    fromCc: string;
+    toCc: string;
+    content: string;
+    kind: 'request' | 'reply' | 'notify';
+    replyTo?: string;
+    hopCount: number;
+    timestamp: number;
+}
 export interface ApprovalEvent {
     robotName: string;
     taskId: string;
@@ -32,6 +42,7 @@ export interface ApprovalEvent {
 }
 export declare function getSubscriberCount(robotName: string): number;
 declare const wecomMessage$: Subject<WecomMessage>;
+declare const ccMessage$: Subject<CcMessage>;
 /**
  * 发布微信消息（由 WecomClient 调用）
  */
@@ -57,4 +68,7 @@ export declare function subscribeWecomMessageByRobot(robotName: string, callback
  * 用于多 CC 共用一个机器人场景的过滤
  */
 export declare function subscribeWecomMessageByCcId(robotName: string, ccId: string, callback: (msg: WecomMessage) => void): import("rxjs").Subscription;
-export { wecomMessage$ };
+export declare function publishCcMessage(msg: CcMessage): void;
+/** 订阅发往指定 ccId 的所有 CC 间消息 */
+export declare function subscribeCcMessageByTarget(toCc: string, callback: (msg: CcMessage) => void): import("rxjs").Subscription;
+export { wecomMessage$, ccMessage$ };

package/dist/message-bus.js

@@ -36,6 +36,7 @@ function decrementSubscriberCount(robotName) {
 // ============================================
 const wecomMessage$ = new Subject();
 const approvalEvent$ = new Subject();
+const ccMessage$ = new Subject();
 // ============================================
 // 发布/订阅接口
 // ============================================
@@ -99,5 +100,15 @@ function isMessageForCcId(msg, ccId) {
     // 在多 CC 场景下，需要用户指定
     return false;
 }
+// ============================================
+// CC 间消息（v2.6.0+）
+// ============================================
+export function publishCcMessage(msg) {
+    ccMessage$.next(msg);
+}
+/** 订阅发往指定 ccId 的所有 CC 间消息 */
+export function subscribeCcMessageByTarget(toCc, callback) {
+    return ccMessage$.pipe(filter(m => m.toCc === toCc)).subscribe(callback);
+}
 // 导出 Observable（供高级用法）
-export { wecomMessage$ };
+export { wecomMessage$, ccMessage$ };

package/dist/platform.d.ts

@@ -0,0 +1,14 @@
+/** 通过 fetch /health 探测 daemon 是否在该端口监听（跨平台） */
+export declare function isDaemonAlive(port: number, timeoutMs?: number): Promise<boolean>;
+/** 取指定 PID 的父进程 PID；不存在返回 0 */
+export declare function getParentPid(pid: number): number;
+/** 取指定 PID 的可执行文件名（comm 字段，如 "claude" / "node") */
+export declare function getProcessName(pid: number): string;
+/**
+ * 沿进程树向上查找 Claude Code 进程的 PID。
+ * 用于 channel-server 注册 active-projects 时定位真正的 TUI 进程
+ * （npx 安装下 process.ppid 是 npx 不是 claude）。
+ */
+export declare function findClaudePid(startPid: number, maxDepth?: number): number;
+/** 进程是否还在（process.kill(pid, 0) 在 Win/Unix 都可用） */
+export declare function isProcessAlive(pid: number): boolean;