@lemoncat7/dsh-partner 1.14.2 → 1.16.0

package/lib/channels/direct/transport.js

@@ -0,0 +1,152 @@
+import { randomUUID } from 'node:crypto';
+import { pollDiscovered } from './discovery.js';
+export class ChannelHttpError extends Error {
+    status;
+    retryAfterMs;
+    constructor(status, retryAfterMs = 0) {
+        super(`渠道请求失败（HTTP ${status}）`);
+        this.status = status;
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+export function directConfig(value) {
+    if (value.platform !== 'matrix' && value.platform !== 'mattermost')
+        throw new Error('请选择 Matrix 或 Mattermost');
+    if (typeof value.baseUrl !== 'string' || (value.targetId !== undefined && (typeof value.targetId !== 'string' || value.targetId.length > 512)))
+        throw new Error('服务器地址或会话 ID 无效');
+    const url = new URL(value.baseUrl);
+    if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password || url.search || url.hash)
+        throw new Error('服务器地址只能包含 HTTP(S) 地址和路径，不得带凭据或查询参数');
+    return { platform: value.platform, baseUrl: url.toString().replace(/\/$/, ''), targetId: value.targetId?.trim() ?? '' };
+}
+/** Explicit, two-member conversations only. No group inference from display names. */
+export class DirectTransport {
+    config;
+    token;
+    expected;
+    botId = '';
+    peerId = '';
+    constructor(config, token, expected) {
+        this.config = config;
+        this.token = token;
+        this.expected = expected;
+    }
+    async request(path, signal, body, method = body === undefined ? 'GET' : 'POST') {
+        const response = await fetch(this.config.baseUrl + path, {
+            method, redirect: 'error', headers: { Authorization: `Bearer ${this.token}`, ...(body === undefined ? {} : { 'Content-Type': 'application/json' }) },
+            ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+            signal: signal ? AbortSignal.any([signal, AbortSignal.timeout(35_000)]) : AbortSignal.timeout(35_000),
+        });
+        if (!response.ok) {
+            const header = response.headers.get('retry-after');
+            const retry = header ? (/^\d+$/.test(header) ? Number(header) * 1000 : Date.parse(header) - Date.now()) : 0;
+            throw new ChannelHttpError(response.status, Number.isFinite(retry) ? Math.max(0, Math.min(900_000, retry)) : 0);
+        }
+        if (!response.body)
+            throw new Error('渠道返回空响应');
+        let size = 0;
+        const chunks = [];
+        for await (const chunk of response.body) {
+            size += chunk.byteLength;
+            if (size > 4 * 1024 * 1024)
+                throw new Error('渠道响应超过大小限制');
+            chunks.push(chunk);
+        }
+        return JSON.parse(Buffer.concat(chunks).toString('utf8'));
+    }
+    async validate(signal) {
+        if (!this.config.targetId) {
+            const who = await this.request(this.config.platform === 'matrix' ? '/_matrix/client/v3/account/whoami' : '/api/v4/users/me', signal);
+            const id = this.config.platform === 'matrix' ? who.user_id : who.id;
+            if (typeof id !== 'string' || !id || this.expected && this.expected.accountId !== id)
+                throw new Error('渠道账号身份无效或已变化');
+            this.botId = id;
+            return { accountId: id, peerId: '' };
+        }
+        const target = encodeURIComponent(this.config.targetId);
+        if (this.config.platform === 'matrix') {
+            const who = await this.request('/_matrix/client/v3/account/whoami', signal);
+            if (typeof who.user_id !== 'string')
+                throw new Error('Matrix 用户身份无效');
+            const state = await this.request(`/_matrix/client/v3/rooms/${target}/state`, signal);
+            if (!Array.isArray(state))
+                throw new Error('Matrix 房间状态无效');
+            if (state.some(e => e.type === 'm.room.encryption'))
+                throw new Error('检测到 Matrix 加密房间：暂不支持端到端加密，无法读取消息或发送配对码。请新建未开启加密的双人会话，邀请机器人后发送文字消息。');
+            const members = state.filter(e => e.type === 'm.room.member' && e.content?.membership === 'join').map(e => e.state_key);
+            if (members.length !== 2 || !members.includes(who.user_id) || members.some(id => typeof id !== 'string'))
+                throw new Error('Matrix 房间必须只有机器人和一位已加入的联系人');
+            this.botId = who.user_id;
+            this.peerId = members.find(id => id !== this.botId);
+        }
+        else {
+            const who = await this.request('/api/v4/users/me', signal);
+            const room = await this.request(`/api/v4/channels/${target}`, signal);
+            const members = await this.request(`/api/v4/channels/${target}/members?page=0&per_page=3`, signal);
+            if (typeof who.id !== 'string' || room.type !== 'D' || !Array.isArray(members) || members.length !== 2 || !members.some(m => m.user_id === who.id))
+                throw new Error('Mattermost 目标必须是机器人已加入的双人 DM，不能是群组或公开频道');
+            const peer = members.find(m => m.user_id !== who.id)?.user_id;
+            if (typeof peer !== 'string')
+                throw new Error('Mattermost 联系人无效');
+            this.botId = who.id;
+            this.peerId = peer;
+        }
+        if (this.expected && (this.expected.accountId !== this.botId || this.expected.peerId !== this.peerId))
+            throw new Error('机器人或会话成员已变化，请重新配置，禁止沿用旧会话权限');
+        return { accountId: this.botId, peerId: this.peerId };
+    }
+    async poll(cursor, signal) {
+        await this.validate(signal);
+        if (!this.config.targetId)
+            return pollDiscovered(this.config.platform, this.botId, cursor, signal, (path, body) => this.request(path, signal, body), targetId => new DirectTransport({ ...this.config, targetId }, this.token));
+        if (this.config.platform === 'matrix') {
+            const filter = JSON.stringify({ room: { rooms: [this.config.targetId], timeline: { limit: 100 } }, presence: { types: [] } });
+            const data = await this.request('/_matrix/client/v3/sync?timeout=20000&filter=' + encodeURIComponent(filter) + (cursor ? '&since=' + encodeURIComponent(cursor) : ''), signal);
+            if (typeof data.next_batch !== 'string')
+                throw new Error('Matrix 同步游标缺失');
+            const room = data.rooms?.join?.[this.config.targetId];
+            if (cursor && room?.timeline?.limited)
+                throw new Error('Matrix 消息出现缺口，已暂停以免跳过未处理消息');
+            const messages = [];
+            // First sync establishes a watermark, never executes historical messages.
+            for (const event of cursor ? room?.timeline?.events ?? [] : []) {
+                if (event.sender !== this.peerId || event.type !== 'm.room.message' || event.content?.['m.relates_to']?.rel_type === 'm.replace')
+                    continue;
+                if (typeof event.event_id !== 'string')
+                    continue;
+                if (event.content?.msgtype !== 'm.text' || typeof event.content.body !== 'string') {
+                    messages.push({ id: event.event_id, sender: this.peerId, text: '' });
+                    continue;
+                }
+                messages.push({ id: event.event_id, sender: this.peerId, text: event.content.body });
+            }
+            return { cursor: data.next_batch, messages };
+        }
+        const data = await this.request(`/api/v4/channels/${encodeURIComponent(this.config.targetId)}/posts?per_page=200` + (cursor ? '&since=' + encodeURIComponent(cursor) : ''), signal);
+        if (!Array.isArray(data.order) || !data.posts)
+            throw new Error('Mattermost 消息响应无效');
+        if (cursor && data.order.length >= 200)
+            throw new Error('Mattermost 消息积压超出单批上限，已暂停以免遗漏');
+        const posts = data.order.map((id) => data.posts[id]).filter((p) => p && Number.isFinite(p.create_at)).sort((a, b) => a.create_at - b.create_at);
+        const next = Math.max(Number(cursor ?? 0), ...posts.map((p) => p.create_at));
+        return { cursor: String(next), messages: cursor ? posts.filter((p) => p.user_id === this.peerId && !p.type && !p.delete_at && !p.root_id).map((p) => ({ id: p.id, sender: this.peerId, text: Array.isArray(p.file_ids) && p.file_ids.length ? '' : p.message ?? '' })) : [] };
+    }
+    async sendText(userId, text, _context, signal) {
+        if (!this.config.targetId)
+            throw new Error('联系人尚未配对，不能投递');
+        await this.validate(signal);
+        if (userId !== this.peerId)
+            throw new Error('目标联系人与当前双人会话不匹配，拒绝投递');
+        for (let offset = 0; offset < text.length; offset += 4000) {
+            const content = text.slice(offset, offset + 4000);
+            if (this.config.platform === 'matrix')
+                await this.request(`/_matrix/client/v3/rooms/${encodeURIComponent(this.config.targetId)}/send/m.room.message/${randomUUID()}`, signal, { msgtype: 'm.text', body: content }, 'PUT');
+            else
+                await this.request('/api/v4/posts', signal, { channel_id: this.config.targetId, message: content });
+        }
+    }
+    async sendAttachment(_userId, _file, _context, _signal) {
+        throw new Error('Matrix / Mattermost 首版仅支持文本，附件尚未交付；请在 DSH 工作区查看文件');
+    }
+}
+//# sourceMappingURL=transport.js.map

package/lib/channels/direct/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/channels/direct/transport.ts"],"names":[],"mappings":"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"}

package/lib/channels/manager.d.ts

@@ -26,6 +26,7 @@ export declare class ChannelManager {
     private readonly operations;
     private readonly pendingQuestions;
     private readonly outboundQueues;
+    private readonly notificationDelivery;
     constructor(ctx: ChannelContext, store: PartnerStore, credentials: PartnerCredentialVault, agents: PartnerAgentRuntime, defaultCwd: string);
     attachQuestionAnswerer(agentCtx: Context, route: ChannelSession): () => void;
     views(): Promise<ChannelView[]>;
@@ -35,13 +36,15 @@ export declare class ChannelManager {
     close(): Promise<void>;
     delete(channelId: string): Promise<void>;
     setEnabled(channelId: string, enabled: boolean): Promise<void>;
-    sendProactive(channelId: string, userId: string, text: string): Promise<void>;
+    sendProactive(channelId: string, userId: string, text: string, receipt?: string): Promise<void>;
     sendExplicitAttachment(sessionId: string, file: PartnerOutboundAttachment, signal: AbortSignal): Promise<void>;
     notifyTaskResult(task: BoardTask): Promise<void>;
     notifyRequirementResult(item: BoardRequirement): Promise<void>;
     observeAutonomousResult(session: Session, event: SessionEvent): Promise<void>;
     private queueProactive;
+    private routeForSession;
     private sendProactiveReply;
+    private sendNotificationTarget;
     private pollLoop;
     private scheduleInbound;
     private handleInbound;
@@ -49,6 +52,11 @@ export declare class ChannelManager {
     private answerPendingQuestion;
     private clearPendingQuestion;
     private rememberReceipt;
+    private sender;
+    /** Independent connector loop. Cursor is persisted only after receipt handoff. */
+    private directLoop;
+    private handleDirect;
+    private markInbound;
 }
 export declare function requiredChannel(store: PartnerStore, id: string): WeixinChannel;
 export declare function requiredCompanion(store: PartnerStore, id: string): Companion;

package/lib/channels/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/channels/manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/channels/manager.ts"],"names":[],"mappings":"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"}

package/lib/channels/manager.js

@@ -1,5 +1,8 @@
 import { randomBytes } from 'node:crypto';
 import { WeixinApi } from './weixin/api.js';
+import { DirectTransport, ChannelHttpError } from './direct/transport.js';
+import { notificationRoutes } from './notification-route.js';
+import { NotificationDelivery } from './notification-delivery.js';
 import { receiveWeixinMedia } from './weixin/media.js';
 import { completedTurnEvents, extractOutboundAttachments, partnerCwd, selectTaskNotificationRoute } from '../agent-runtime.js';
 import { concernCreatedNoticeFromEvent } from '../concern-notification.js';
@@ -8,6 +11,9 @@ import { requirementIsIdle, requirementProgressKey } from '../requirements/progr
 import { channelReplyPartsAfter, isAutonomousDeliveryTurn } from './delivery-policy.js';
 import { prepareChannelReply } from './outbound-media.js';
 export { isAutonomousDeliveryTurn } from './delivery-policy.js';
+class DirectDeliveryError extends Error {
+    constructor() { super('消息处理或发送未完成，渠道已暂停。请在 DSH 查看执行结果后重连；同一消息不会自动重复执行。'); }
+}
 export class ChannelManager {
     ctx;
     store;
@@ -20,12 +26,14 @@ export class ChannelManager {
     operations = new Map();
     pendingQuestions = new Map();
     outboundQueues = new Map();
+    notificationDelivery;
     constructor(ctx, store, credentials, agents, defaultCwd) {
         this.ctx = ctx;
         this.store = store;
         this.credentials = credentials;
         this.agents = agents;
         this.defaultCwd = defaultCwd;
+        this.notificationDelivery = new NotificationDelivery(store);
     }
     attachQuestionAnswerer(agentCtx, route) {
         return agentCtx.on('user-questions/request', (request, next) => this.askThroughChannel(route, request, next), { prepend: true });
@@ -43,8 +51,14 @@ export class ChannelManager {
     }
     async startEnabled() {
         for (const channel of this.store.snapshot().channels)
-            if (channel.enabled)
-                await this.start(channel.id);
+            if (channel.enabled) {
+                try {
+                    await this.start(channel.id);
+                }
+                catch {
+                    this.runtime.set(channel.id, { status: 'error', lastError: '渠道启动失败，请检查凭据和配置' });
+                }
+            }
     }
     async start(channelId) {
         if (this.tasks.has(channelId))
@@ -53,7 +67,9 @@ export class ChannelManager {
         const credential = await this.credentials.read(channelId);
         const controller = new AbortController();
         this.runtime.set(channelId, { status: 'starting' });
-        const task = this.pollLoop(channel, new WeixinApi(credential.baseUrl, credential.botToken), controller.signal)
+        const task = (channel.platform && channel.platform !== 'weixin'
+            ? this.directLoop(channel, controller.signal)
+            : this.pollLoop(channel, new WeixinApi(credential.baseUrl, credential.botToken), controller.signal))
             .catch(error => {
             if (!controller.signal.aborted) {
                 const message = error instanceof Error ? error.message : String(error);
@@ -103,8 +119,8 @@ export class ChannelManager {
         else
             await this.stop(channelId);
     }
-    async sendProactive(channelId, userId, text) {
-        await this.sendProactiveReply(channelId, userId, { text, attachments: [] });
+    async sendProactive(channelId, userId, text, receipt) {
+        await this.sendProactiveReply(channelId, userId, { text, attachments: [] }, receipt);
     }
     async sendExplicitAttachment(sessionId, file, signal) {
         const route = this.store.snapshot().sessions.find(s => s.sessionId === sessionId);
@@ -116,7 +132,7 @@ export class ChannelManager {
         if (this.store.snapshot().pairings.find(p => p.channelId === route.channelId && p.userId === route.userId)?.status !== 'approved')
             throw new Error('渠道联系人尚未批准');
         const credential = await this.credentials.read(route.channelId);
-        await new WeixinApi(credential.baseUrl, credential.botToken).sendAttachment(route.userId, file, this.contextTokens.get(`${route.channelId}:${route.userId}`), signal);
+        await this.sender(channel, credential, route.userId).sendAttachment(route.userId, file, this.contextTokens.get(`${route.channelId}:${route.userId}`), signal);
     }
     async notifyTaskResult(task) {
         if (task.requirementId)
@@ -125,7 +141,7 @@ export class ChannelManager {
             return;
         const routes = this.store.snapshot().sessions.filter(item => item.companionId === task.creatorCompanionId);
         const route = selectTaskNotificationRoute(routes, task.creatorSessionId, () => false);
-        if (!route || route.kind === 'local')
+        if (!route || (route.kind === 'local' && !this.store.snapshot().companions.find(c => c.id === route.companionId)?.notificationDelivery))
             return;
         const cwd = route.cwd ?? partnerCwd(this.defaultCwd, task.creatorCompanionId);
         const delivery = await prepareTaskResultDelivery(task, cwd);
@@ -140,8 +156,8 @@ export class ChannelManager {
         if (!summary || !item.creatorSessionId)
             return;
         // A manually created board requirement must not leak into an unrelated chat.
-        const route = this.store.snapshot().sessions.find(route => route.sessionId === item.creatorSessionId);
-        if (!route || route.kind === 'local')
+        const route = this.routeForSession(item.creatorSessionId);
+        if (!route || (route.kind === 'local' && !this.store.snapshot().companions.find(c => c.id === route.companionId)?.notificationDelivery))
             return;
         const cwd = route.cwd ?? partnerCwd(this.defaultCwd, route.companionId);
         const delivery = await prepareTaskResultDelivery({ id: stage ? `${item.id}-stage-${item.stageReport.key.slice(0, 16)}` : item.id, title: item.title, description: item.description, status: 'done', priority: 'normal', createdBy: 'companion', skillIds: [], dependencyTaskIds: [], revision: item.revision, createdAt: item.createdAt, updatedAt: item.updatedAt, resultSummary: summary }, cwd);
@@ -159,8 +175,8 @@ export class ChannelManager {
         });
     }
     async observeAutonomousResult(session, event) {
-        const route = this.store.snapshot().sessions.find(item => item.sessionId === session.id);
-        if (route === undefined || route.kind === 'local')
+        const route = this.routeForSession(session.id);
+        if (route === undefined || (route.kind === 'local' && !this.store.snapshot().companions.find(c => c.id === route.companionId)?.notificationDelivery))
             return;
         const concernNotice = concernCreatedNoticeFromEvent(event);
         if (concernNotice !== undefined) {
@@ -189,7 +205,7 @@ export class ChannelManager {
                 return;
             if (stillValid && !stillValid())
                 throw new Error('需求已调整，取消旧结果投递');
-            await this.sendProactiveReply(route.channelId, route.userId, reply);
+            await this.sendProactiveReply(route.channelId, route.userId, reply, receipt, route.companionId);
             await this.rememberReceipt(receipt);
         });
         this.outboundQueues.set(key, current);
@@ -201,20 +217,38 @@ export class ChannelManager {
                 this.outboundQueues.delete(key);
         }
     }
-    async sendProactiveReply(channelId, userId, reply) {
+    routeForSession(sessionId) {
+        const state = this.store.snapshot();
+        const candidates = state.sessions.filter(item => item.sessionId === sessionId);
+        const inbound = (route) => state.pairings.find(p => p.channelId === route.channelId && p.userId === route.userId)?.lastInboundAt ?? 0;
+        return candidates.filter(item => item.kind === 'channel').sort((a, b) => inbound(b) - inbound(a))[0] ?? candidates[0];
+    }
+    async sendProactiveReply(channelId, userId, reply, receipt, owner) {
+        const state = this.store.snapshot();
+        const companionId = state.channels.find(c => c.id === channelId)?.companionId ?? owner;
+        if (!companionId)
+            throw new Error('通知来源伙伴不存在');
+        await this.notificationDelivery.deliver(receipt ?? randomBytes(16).toString('hex'), companionId, () => notificationRoutes(this.store.snapshot(), channelId, userId, companionId), reply, async (target, payload, sendPart) => {
+            const current = this.store.snapshot();
+            if (!current.channels.some(c => c.id === target.channelId && c.companionId === companionId))
+                throw new Error('通知目标不属于当前伙伴');
+            await this.sendNotificationTarget(target.channelId, target.userId, payload, sendPart);
+        });
+    }
+    async sendNotificationTarget(channelId, userId, reply, sendPart) {
         const channel = requiredChannel(this.store, channelId);
         if (!channel.enabled)
-            throw new Error('微信渠道已停用');
+            throw new Error('通知渠道已停用');
         const pairing = this.store.snapshot().pairings.find(item => item.channelId === channelId && item.userId === userId);
         if (pairing?.status !== 'approved')
-            throw new Error('微信联系人尚未批准');
+            throw new Error('通知接收人尚未批准');
         const credential = await this.credentials.read(channelId);
         const token = this.contextTokens.get(`${channelId}:${userId}`);
-        const api = new WeixinApi(credential.baseUrl, credential.botToken);
+        const api = this.sender(channel, credential, userId);
         const signal = AbortSignal.timeout(30_000);
-        await api.sendText(userId, reply.text, token, signal);
-        for (const attachment of reply.attachments)
-            await api.sendAttachment(userId, attachment, token, signal);
+        await sendPart(0, () => api.sendText(userId, reply.text, token, signal));
+        for (const [index, attachment] of reply.attachments.entries())
+            await sendPart(index + 1, () => api.sendAttachment(userId, attachment, token, signal));
     }
     async pollLoop(channel, api, signal) {
         let buffer = '';
@@ -288,6 +322,7 @@ export class ChannelManager {
             return;
         }
         const route = this.store.snapshot().sessions.find(item => item.channelId === channel.id && item.userId === userId);
+        await this.markInbound(channel.id, userId);
         if (route !== undefined && text && await this.answerPendingQuestion(route.sessionId, text, channel, api, userId, signal)) {
             await this.rememberReceipt(receipt);
             return;
@@ -335,6 +370,10 @@ export class ChannelManager {
         const state = this.store.snapshot();
         const current = state.sessions.find(item => item.id === route.id && item.sessionId === route.sessionId);
         const channel = state.channels.find(item => item.id === route.channelId);
+        // Direct connectors currently serialize reads with replies; interactive questions
+        // stay in DSH rather than waiting for an answer on a blocked receive loop.
+        if (channel?.platform && channel.platform !== 'weixin')
+            return next();
         const pairing = state.pairings.find(item => item.channelId === route.channelId && item.userId === route.userId);
         if (current === undefined || channel === undefined || !channel.enabled || pairing?.status !== 'approved')
             return next();
@@ -359,7 +398,7 @@ export class ChannelManager {
         this.pendingQuestions.set(route.sessionId, pending);
         try {
             const credential = await this.credentials.read(channel.id);
-            const api = new WeixinApi(credential.baseUrl, credential.botToken);
+            const api = this.sender(channel, credential, route.userId);
             await api.sendText(route.userId, renderQuestions(request.questions), this.contextTokens.get(`${channel.id}:${route.userId}`), request.signal ?? AbortSignal.timeout(30_000));
         }
         catch (error) {
@@ -397,6 +436,116 @@ export class ChannelManager {
                 state.recentReceipts.splice(0, state.recentReceipts.length - 800);
         });
     }
+    sender(channel, credential, userId) {
+        if (!channel.platform || channel.platform === 'weixin')
+            return new WeixinApi(credential.baseUrl, credential.botToken);
+        if (!channel.direct)
+            throw new Error('渠道会话配置缺失');
+        const pairing = this.store.snapshot().pairings.find(p => p.channelId === channel.id && p.userId === userId && p.status === 'approved');
+        const targetId = channel.direct.targetId || pairing?.directTargetId;
+        if (!targetId)
+            throw new Error('联系人尚未绑定私聊会话');
+        return new DirectTransport({ platform: channel.platform, baseUrl: credential.baseUrl, targetId }, credential.botToken, { accountId: channel.accountId, peerId: channel.direct.peerId || userId });
+    }
+    /** Independent connector loop. Cursor is persisted only after receipt handoff. */
+    async directLoop(channel, signal) {
+        if (!channel.direct || !channel.platform || channel.platform === 'weixin')
+            throw new Error('渠道配置无效');
+        const credential = await this.credentials.read(channel.id);
+        const api = new DirectTransport({ platform: channel.platform, baseUrl: credential.baseUrl, targetId: channel.direct.targetId }, credential.botToken, { accountId: channel.accountId, peerId: channel.direct.peerId });
+        let cursor = channel.direct.cursor;
+        let failures = 0;
+        let roomWarning;
+        while (!signal.aborted) {
+            try {
+                const batch = await api.poll(cursor, signal);
+                if (signal.aborted)
+                    break;
+                if (batch.warning)
+                    roomWarning = batch.warning;
+                else if (batch.messages.length)
+                    roomWarning = undefined;
+                this.runtime.set(channel.id, { status: 'running', ...(roomWarning ? { lastError: roomWarning } : {}) });
+                for (const message of batch.messages) {
+                    if (signal.aborted)
+                        break;
+                    try {
+                        const targetApi = message.targetId ? new DirectTransport({ platform: channel.platform, baseUrl: credential.baseUrl, targetId: message.targetId }, credential.botToken, { accountId: channel.accountId, peerId: message.sender }) : api;
+                        await targetApi.validate(signal);
+                        await this.handleDirect(channel, targetApi, message, signal);
+                    }
+                    catch {
+                        throw new DirectDeliveryError();
+                    }
+                }
+                if (signal.aborted)
+                    break;
+                await this.store.update(state => {
+                    const current = state.channels.find(c => c.id === channel.id && c.enabled);
+                    if (current?.direct)
+                        current.direct.cursor = batch.cursor;
+                });
+                cursor = batch.cursor;
+                failures = 0;
+                await delay(channel.platform === 'mattermost' ? 10_000 : 1000, signal);
+            }
+            catch (error) {
+                if (signal.aborted)
+                    break;
+                if (error instanceof DirectDeliveryError || (error instanceof ChannelHttpError && [401, 403].includes(error.status)))
+                    throw error;
+                if (++failures >= 6)
+                    throw error;
+                const reason = error instanceof ChannelHttpError ? `HTTP ${error.status}` : error instanceof Error && error.message === 'fetch failed' ? '网络连接失败，请检查地址、端口和容器 DNS' : error instanceof Error && error.name === 'TimeoutError' ? '服务器请求超时' : error instanceof Error ? error.message : '连接异常';
+                this.runtime.set(channel.id, { status: 'starting', lastError: `${reason}（重试 ${failures}/6）` });
+                await delay(Math.max(error instanceof ChannelHttpError ? error.retryAfterMs : 0, Math.min(60_000, 2000 * 2 ** failures)), signal);
+            }
+        }
+    }
+    async handleDirect(channel, api, event, signal) {
+        const receipt = `${channel.id}:${event.id}`;
+        if (this.store.snapshot().recentReceipts.includes(receipt))
+            return;
+        const pairing = this.store.snapshot().pairings.find(p => p.channelId === channel.id && p.userId === event.sender);
+        // A different room must not silently inherit the contact's existing grant.
+        if (pairing?.directTargetId && event.targetId && pairing.directTargetId !== event.targetId) {
+            await this.rememberReceipt(receipt);
+            return;
+        }
+        if (!pairing) {
+            const now = Date.now();
+            const pairingCode = randomBytes(4).toString('hex').toUpperCase();
+            await this.store.update(state => {
+                if (state.pairings.filter(p => p.channelId === channel.id).length >= 100)
+                    throw new Error('配对请求已达上限，请在面板清理');
+                if (!state.pairings.some(p => p.channelId === channel.id && p.userId === event.sender))
+                    state.pairings.push({ id: `pairing-${randomBytes(10).toString('hex')}`, channelId: channel.id, userId: event.sender, displayName: event.sender, directTargetId: event.targetId || channel.direct?.targetId || '', pairingCode, status: 'pending', createdAt: now, updatedAt: now });
+            });
+            await api.sendText(event.sender, `配对码：${pairingCode}\n请在「伙伴 → 渠道 → 配置」核对该码并批准联系人，然后重新发送消息。未批准前不会交给伙伴处理。`, undefined, signal);
+        }
+        else if (pairing.status === 'approved') {
+            await this.markInbound(channel.id, event.sender);
+            if (!event.text)
+                await api.sendText(event.sender, '此渠道首版仅支持文本；附件未交给伙伴处理。', undefined, signal);
+            else {
+                // Claim before starting tools. A delivery failure must not execute the same
+                // user command twice on reconnect; its result remains in the DSH session.
+                await this.rememberReceipt(receipt);
+                const companion = requiredCompanion(this.store, channel.companionId);
+                const reply = await this.agents.reply(companion, channel.id, event.sender, { text: event.text, attachments: [] });
+                signal.throwIfAborted();
+                const current = this.store.snapshot();
+                if (!current.channels.some(c => c.id === channel.id && c.enabled && c.companionId === channel.companionId) || !current.pairings.some(p => p.channelId === channel.id && p.userId === event.sender && p.status === 'approved'))
+                    throw new Error('渠道或联系人授权已撤销，取消回复');
+                await api.sendText(event.sender, reply.text + (reply.attachments.length ? '\n\n附件未交付：此渠道首版只发送文本，请在 DSH 工作区查看文件。' : ''), undefined, signal);
+            }
+        }
+        await this.rememberReceipt(receipt);
+    }
+    async markInbound(channelId, userId) {
+        await this.store.update(state => { const p = state.pairings.find(p => p.channelId === channelId && p.userId === userId && p.status === 'approved'); if (p)
+            p.lastInboundAt = Date.now(); });
+    }
 }
 export function requiredChannel(store, id) {
     const channel = store.snapshot().channels.find(item => item.id === id);