@krischoichoi/channel-harness 0.6.0

package/lib/interactions/question-presenter.js

@@ -0,0 +1,425 @@
+import { renderQuestionMessage } from './question-renderer.js';
+import { parseQuestionTextAnswer } from './question-text-answer.js';
+import { newReplyToken, QuestionStateStore, } from './question-state.js';
+function targetKey(target) {
+    return `${target.channelId}:${target.accountId}:${target.conversationId}:${target.threadId ?? ''}`;
+}
+function eventKey(event) {
+    return `${event.channel}:${event.accountId}:${event.conversation.id}:${event.conversation.threadId ?? ''}`;
+}
+function textOf(event) {
+    return event.message.content
+        .filter((part) => part.type === 'text')
+        .map((part) => part.text)
+        .join('')
+        .trim();
+}
+/**
+ * Presents Harness-origin questions (the official `user-questions/request`
+ * waterfall) through generic channel actions.
+ */
+export class ChannelQuestionPresenter {
+    options;
+    state = new QuestionStateStore();
+    constructor(options) {
+        this.options = options;
+    }
+    /** Connect the sink and open the backend transport. */
+    start() {
+        this.options.backend.start(this);
+    }
+    /** Cancel every open question, then tear the backend transport down. */
+    async stop() {
+        for (const pending of this.state.all()) {
+            await this.cancel(pending, 'channel question bridge stopped');
+        }
+        await this.options.backend.stop();
+    }
+    // ---------------------------------------------------------------------------
+    // QuestionInteractionSink — harness -> channel
+    // ---------------------------------------------------------------------------
+    /**
+     * Present one question batch on the channel conversation bound to the
+     * asking session. Returns false when the channel cannot take ownership
+     * (no active reply context, no binding, adapter absent / text unsupported,
+     * or another question already pending on that conversation) — the backend
+     * decides what a decline means per transport.
+     *
+     * `interactiveActions` decides only presentation quality, never admission:
+     * any `text: true` adapter can answer via numbered plain text; a
+     * `interactiveActions: true` adapter upgrades to native buttons.
+     */
+    async questionRequested(request) {
+        // Mux replay of a still-pending question (the official stream reuses the
+        // rpcId verbatim on reopen): already owned, keep presenting it.
+        if (this.state.getByKey(request.key))
+            return true;
+        const sessionId = request.sessionId;
+        const active = this.options.replyContexts.getActiveForSession(sessionId);
+        const binding = this.options.agentManager.bindingFor(sessionId);
+        if (!active || !binding || !active.context.senderId)
+            return false;
+        const adapter = this.options.getAdapter(binding.channelId);
+        if (!adapter || !adapter.capabilities.text)
+            return false;
+        const presentationMode = adapter.capabilities.interactiveActions === true ? 'actions' : 'text';
+        const target = {
+            channelId: binding.channelId,
+            accountId: binding.accountId,
+            conversationId: binding.conversationId,
+            conversationType: active.context.conversationType,
+            ...(binding.threadId ? { threadId: binding.threadId } : {}),
+            ...(active.context.replyToMessageId
+                ? { replyToMessageId: active.context.replyToMessageId }
+                : {}),
+            ...(active.context.raw === undefined ? {} : { raw: active.context.raw }),
+            ...(active.context.runId ? { runId: active.context.runId } : {}),
+        };
+        const pending = {
+            key: request.key,
+            sessionId,
+            questions: request.questions,
+            answers: [],
+            questionIndex: 0,
+            selected: new Set(),
+            awaitingCustom: false,
+            state: 'pending',
+            processing: false,
+            responding: false,
+            target,
+            conversationKey: targetKey(target),
+            allowedSenderId: active.context.senderId,
+            actionIds: new Set(),
+            presentationMode,
+            replyToken: newReplyToken(),
+        };
+        if (!this.state.register(pending)) {
+            // One pending question per conversation at a time.
+            this.options.logger.warn('[channel-harness] channel question already pending', {
+                channel: binding.channelId,
+                account: binding.accountId,
+                conversation: binding.conversationId,
+            });
+            return false;
+        }
+        this.state.armTimeout(pending, this.options.timeoutMs, (expired) => {
+            void this.cancel(expired, '问题已超时，请重新发起。', 'expired');
+        });
+        this.options.logger.info('[channel-harness] presenting user question on channel', {
+            sessionId,
+            channel: binding.channelId,
+            questionCount: request.questions.length,
+            presentationMode,
+        });
+        try {
+            await this.present(pending, adapter, false);
+        }
+        catch (error) {
+            this.options.logger.error('[channel-harness] failed to present user question', error);
+            await this.cancel(pending, '无法在当前渠道展示问题，已取消。');
+        }
+        return true;
+    }
+    /** Another client answered, or the owning tool call aborted: drop controls. */
+    async questionSettledExternally(key, state = 'externally-settled') {
+        const pending = this.state.getByKey(key);
+        if (!pending)
+            return;
+        // Mark terminal before the first await. A channel handler may still hold
+        // this object after the store indexes are removed.
+        if (pending.state === 'pending')
+            pending.state = state;
+        await this.cleanup(pending);
+    }
+    // ---------------------------------------------------------------------------
+    // Channel -> answer collection
+    // ---------------------------------------------------------------------------
+    /** Consume an already-authorized channel answer before it reaches the Agent inbox. */
+    async handleChannelEvent(event) {
+        if (event.type === 'interaction.received')
+            return this.handleInteraction(event);
+        if (event.type === 'message.received')
+            return this.handleMessage(event);
+        return false;
+    }
+    async present(pending, adapter, edit) {
+        if (pending.state !== 'pending')
+            return;
+        const question = pending.questions[pending.questionIndex];
+        if (!question)
+            return this.submit(pending);
+        this.state.clearActions(pending);
+        const message = renderQuestionMessage(pending, question, (action) => this.state.bindAction(pending, action));
+        pending.renderedText = message.text;
+        if (edit && pending.messageId && adapter.edit) {
+            await adapter.edit(pending.target, pending.messageId, message);
+            return;
+        }
+        let result;
+        try {
+            result = await adapter.send(pending.target, message);
+        }
+        catch (error) {
+            // A DECLARED native-actions capability can still be unusable in a live
+            // deployment: a DingTalk interactive-card template that is not published
+            // in THIS org, a missing card/markdown-keyboard permission, … The
+            // capability flag is a declaration, never a probe, so a failed
+            // interactive presentation must NOT kill the question — every
+            // `text: true` adapter can answer the numbered-text form. Degrade this
+            // batch to text and re-render (that rendering adds the reply
+            // instructions and, in a group, the correlation token).
+            if (pending.presentationMode !== 'actions')
+                throw error;
+            this.options.logger.warn('[channel-harness] interactive actions failed to present; falling back to numbered text', {
+                channel: pending.target.channelId,
+                conversationType: pending.target.conversationType,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            pending.presentationMode = 'text';
+            return this.present(pending, adapter, false);
+        }
+        if (pending.state !== 'pending') {
+            if (message.actions?.length && result.messageId && adapter.edit) {
+                await adapter.edit(pending.target, result.messageId, { actions: [] }).catch(() => { });
+            }
+            return;
+        }
+        if (message.replyPrompt)
+            pending.promptMessageId = result.messageId;
+        else
+            pending.messageId = result.messageId;
+    }
+    async handleInteraction(event) {
+        const ref = this.state.findAction(event.action);
+        if (!ref || ref.pending.conversationKey !== eventKey(event))
+            return false;
+        const pending = ref.pending;
+        if (String(event.sender.id) !== pending.allowedSenderId)
+            return true;
+        if (pending.state !== 'pending' || pending.processing || pending.responding)
+            return true;
+        const question = pending.questions[pending.questionIndex];
+        if (!question)
+            return true;
+        const action = ref.action;
+        pending.processing = true;
+        try {
+            if (action.kind === 'skip') {
+                await this.advance(pending, { id: question.id, selected: [] });
+            }
+            else if (action.kind === 'custom') {
+                pending.awaitingCustom = true;
+                const adapter = this.options.getAdapter(pending.target.channelId);
+                if (adapter) {
+                    await this.removeButtons(pending);
+                    if (pending.state !== 'pending')
+                        return true;
+                    await this.present(pending, adapter, false);
+                }
+            }
+            else if (action.kind === 'done') {
+                if (pending.selected.size > 0) {
+                    await this.advance(pending, { id: question.id, selected: [...pending.selected] });
+                }
+            }
+            else if (action.optionIndex !== undefined) {
+                const option = question.options?.[action.optionIndex];
+                if (!option)
+                    return true;
+                if (!question.multiSelect) {
+                    await this.advance(pending, { id: question.id, selected: [option.label] });
+                }
+                else {
+                    if (pending.selected.has(option.label))
+                        pending.selected.delete(option.label);
+                    else
+                        pending.selected.add(option.label);
+                    const adapter = this.options.getAdapter(pending.target.channelId);
+                    if (adapter)
+                        await this.present(pending, adapter, true);
+                }
+            }
+        }
+        catch (error) {
+            this.options.logger.error('[channel-harness] failed to process question interaction', error);
+            await this.cancel(pending, '提交答案失败，问题已取消。');
+        }
+        finally {
+            pending.processing = false;
+        }
+        return true;
+    }
+    /**
+     * Route one authorized text message into the question flow. DM answers parse
+     * directly; group/thread answers must correlate via the platform `replyTo`
+     * mapping or the per-question `replyToken` (stripped before parsing).
+     * Returns true when the message was consumed by a pending question (never
+     * falls through to Agent routing); false otherwise.
+     */
+    async handleMessage(event) {
+        const pending = this.state.getByConversation(eventKey(event));
+        if (!pending)
+            return false;
+        if (String(event.sender.id) !== pending.allowedSenderId)
+            return false;
+        const text = textOf(event);
+        if (!text || text.startsWith('/'))
+            return false;
+        if (pending.state !== 'pending' || pending.processing || pending.responding)
+            return true;
+        const question = pending.questions[pending.questionIndex];
+        if (!question)
+            return false;
+        const body = this.correlateMessageBody(pending, event, text);
+        if (body === undefined)
+            return false;
+        pending.processing = true;
+        try {
+            const parsed = parseQuestionTextAnswer(question, body);
+            if (parsed.kind === 'invalid') {
+                if (parsed.reason === 'option-out-of-range') {
+                    this.options.logger.debug('[channel-harness] invalid text answer for pending question', {
+                        channel: pending.target.channelId,
+                        conversationType: pending.target.conversationType,
+                        reason: parsed.reason,
+                    });
+                    const adapter = this.options.getAdapter(pending.target.channelId);
+                    const n = question.options?.length ?? 0;
+                    // Keep pending — do NOT cancel, do NOT re-arm the timeout. Only a
+                    // genuine send/backend failure, timeout or external settlement ends.
+                    if (adapter) {
+                        await adapter
+                            .send(pending.target, { text: `选项无效，请回复 1-${n}；多选可回复 1,3。` })
+                            .catch(() => { });
+                    }
+                }
+                return true;
+            }
+            if (parsed.kind === 'skip') {
+                await this.advance(pending, { id: question.id, selected: [] });
+                return true;
+            }
+            if (parsed.kind === 'selected') {
+                await this.advance(pending, { id: question.id, selected: parsed.labels });
+                return true;
+            }
+            await this.advance(pending, {
+                id: question.id,
+                selected: question.multiSelect ? [...pending.selected] : [],
+                custom: parsed.text,
+            });
+        }
+        catch (error) {
+            this.options.logger.error('[channel-harness] failed to process question reply', error);
+            await this.cancel(pending, '提交答案失败，问题已取消。');
+        }
+        finally {
+            pending.processing = false;
+        }
+        return true;
+    }
+    /**
+     * Resolve the answerable text of an inbound message against a pending
+     * question. Returns:
+     * - the message body for DMs (parse directly), or
+     * - the token-stripped body when the platform `replyTo` maps to the prompt,
+     *   or
+     * - the token-stripped body when the reply carries `pending.replyToken`
+     *   anywhere (`Q-XXXX 2`, `Q-XXXX: 2`, `@bot Q-XXXX 2`), or
+     * - `undefined` when nothing correlates (leave for ordinary routing).
+     */
+    correlateMessageBody(pending, event, text) {
+        if (pending.target.conversationType !== 'group')
+            return text;
+        if (pending.promptMessageId && event.message.replyTo === pending.promptMessageId) {
+            return text;
+        }
+        // A reliable adapter-supplied mention is an explicit correlation signal:
+        // after the Access Gate has authorized + activated it, `@bot 2` from the
+        // pending question's allowed sender is an answer, not a new queued turn.
+        if (event.message.activation?.mentionedBot === true)
+            return text;
+        const token = pending.replyToken;
+        if (!token)
+            return undefined;
+        const index = text.indexOf(token);
+        if (index === -1)
+            return undefined;
+        const before = text
+            .slice(0, index)
+            .replace(/@\S+\s*$/u, '')
+            .replace(/[\s:：,，]+$/u, '');
+        const after = text.slice(index + token.length).replace(/^[\s:：,，]+/u, '');
+        const body = `${before} ${after}`.trim();
+        return body.length > 0 ? body : undefined;
+    }
+    async advance(pending, answer) {
+        if (pending.state !== 'pending')
+            return;
+        await this.removeButtons(pending);
+        if (pending.state !== 'pending')
+            return;
+        pending.answers.push(answer);
+        pending.questionIndex += 1;
+        // Reset per-question transient state so a delayed answer to a previous
+        // question does not leak into the next one.
+        pending.selected.clear();
+        pending.awaitingCustom = false;
+        pending.promptMessageId = undefined;
+        pending.replyToken = newReplyToken();
+        const adapter = this.options.getAdapter(pending.target.channelId);
+        if (!adapter)
+            return this.cancel(pending, '渠道已断开，问题已取消。');
+        await this.present(pending, adapter, false);
+    }
+    async submit(pending) {
+        if (pending.state !== 'pending' || pending.responding)
+            return;
+        pending.responding = true;
+        try {
+            await this.options.backend.resolve({
+                key: pending.key,
+                sessionId: pending.sessionId,
+                answer: { answers: pending.answers },
+            });
+            if (pending.state === 'pending')
+                pending.state = 'resolved';
+            await this.cleanup(pending);
+        }
+        catch (error) {
+            if (pending.state !== 'pending') {
+                await this.cleanup(pending);
+                return;
+            }
+            pending.responding = false;
+            throw error;
+        }
+    }
+    async cancel(pending, notice, state = 'aborted') {
+        if (pending.state !== 'pending' || pending.responding)
+            return;
+        pending.state = state;
+        pending.responding = true;
+        await this.removeButtons(pending);
+        const adapter = this.options.getAdapter(pending.target.channelId);
+        if (adapter)
+            await adapter.send(pending.target, { text: notice }).catch(() => { });
+        await this.options.backend.cancel({ key: pending.key, reason: notice }).catch(() => undefined);
+        await this.cleanup(pending);
+    }
+    async removeButtons(pending) {
+        this.state.clearActions(pending);
+        if (!pending.messageId)
+            return;
+        const adapter = this.options.getAdapter(pending.target.channelId);
+        if (adapter?.edit) {
+            await adapter.edit(pending.target, pending.messageId, { actions: [] }).catch(() => { });
+        }
+        pending.messageId = undefined;
+    }
+    async cleanup(pending) {
+        await this.removeButtons(pending);
+        this.state.remove(pending);
+    }
+}
+//# sourceMappingURL=question-presenter.js.map

package/lib/interactions/question-presenter.js.map

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

package/lib/interactions/question-renderer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Pure renderer for one pending Harness question -> `OutboundMessage`.
+ *
+ * Pure by construction: given the pending presentation state and the official
+ * `AskUserQuestionItem`, it produces the exact outbound message — no adapter
+ * sends, no backend calls, no session lookups, no platform payloads. The only
+ * injected dependency is `bindAction`, which maps a pending action intent to
+ * its bound opaque channel-facing id (the presenter wires
+ * `state.bindAction`), keeping this module a plain unit-test target.
+ *
+ * Presentation is capability-driven:
+ *
+ * - `'actions'` — native buttons via `OutboundMessage.actions` (option rows,
+ *   `其他` custom, `完成` done for multi-select, `跳过本题` skip; `✓ ` toggle
+ *   for multi-select; plan-review approve gets `primary`).
+ * - `'text'`    — numbered plain-text options ALWAYS emitted when options
+ *   exist (description is an indented note, never a gate for showing the
+ *   option), plus free-text instructions. No `actions` attached. In group
+ *   chats a short correlation hint (`replyToken`) is appended so the answer
+ *   can be routed without platform reply correlation.
+ *
+ * `replyPrompt` stays a best-effort hint for free-text questions
+ * (`needsTextReply`), never a usability precondition.
+ */
+import type { AskUserQuestionItem } from '@deepseek-ai/dsh-user-questions/types';
+import type { OutboundMessage } from '@krischoichoi/channel-core';
+import type { PendingChannelQuestion, PendingQuestionAction } from './question-state.js';
+/**
+ * Render the current question of a pending batch as an outbound channel
+ * message. Every official field is honoured: `header` / `question` / `detail`
+ * as text, `options` / `multiSelect` as numbered options (+ native actions
+ * when available), and `intent` as a minimal presentation cue (a plan-review
+ * heading tag plus a primary-styled approve button — the answer encoding is
+ * identical either way, so nothing is lost when a UI ignores the tag).
+ */
+export declare function renderQuestionMessage(pending: PendingChannelQuestion, question: AskUserQuestionItem, bindAction: (action: PendingQuestionAction) => string): OutboundMessage;
+//# sourceMappingURL=question-renderer.d.ts.map

package/lib/interactions/question-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-renderer.d.ts","sourceRoot":"","sources":["../../src/interactions/question-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,KAAK,EAAqB,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,qBAAqB,CAAC;AAS7B;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,EAC/B,QAAQ,EAAE,mBAAmB,EAC7B,UAAU,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,MAAM,GACpD,eAAe,CAoEjB"}

package/lib/interactions/question-renderer.js

@@ -0,0 +1,79 @@
+/** Options-mode reply instructions shown in text presentation (with options). */
+const TEXT_OPTION_INSTRUCTIONS = [
+    '回复 1 / 2 / 3，或直接回复选项文字。',
+    '也可以直接输入自定义答案。',
+    '回复"跳过"可跳过本题。',
+];
+/**
+ * Render the current question of a pending batch as an outbound channel
+ * message. Every official field is honoured: `header` / `question` / `detail`
+ * as text, `options` / `multiSelect` as numbered options (+ native actions
+ * when available), and `intent` as a minimal presentation cue (a plan-review
+ * heading tag plus a primary-styled approve button — the answer encoding is
+ * identical either way, so nothing is lost when a UI ignores the tag).
+ */
+export function renderQuestionMessage(pending, question, bindAction) {
+    const textMode = pending.presentationMode === 'text';
+    const intent = question.intent;
+    const planReview = intent?.kind === 'plan-review';
+    const heading = question.header ? `**${question.header}**` : '';
+    const lines = [
+        planReview ? (heading ? `${heading}（计划评审）` : '**计划评审**') : heading,
+        question.question,
+        question.detail ?? '',
+    ];
+    // Numbered options are ALWAYS emitted when options exist — a description is
+    // an indented note, never a condition for showing the option.
+    if (question.options?.length) {
+        lines.push(...question.options.map((option, index) => `${index + 1}. ${option.label}${option.description ? `\n   ${option.description}` : ''}`));
+    }
+    const needsTextReply = pending.awaitingCustom || !question.options?.length;
+    if (pending.awaitingCustom) {
+        lines.push('请直接回复你的自定义答案。');
+    }
+    else if (!question.options?.length) {
+        lines.push('请直接回复文字，或输入"跳过"。');
+    }
+    else if (textMode) {
+        lines.push(...TEXT_OPTION_INSTRUCTIONS);
+    }
+    // Group text presentation carries a platform-independent correlation hint so
+    // an answer can be routed when replyTo correlation is unavailable.
+    if (textMode && pending.target.conversationType === 'group' && pending.replyToken) {
+        lines.push(`如果当前渠道无法关联回复，请发送：${pending.replyToken} 2`);
+    }
+    if (textMode) {
+        return {
+            text: lines.filter(Boolean).join('\n\n'),
+            ...(needsTextReply ? { replyPrompt: { kind: 'text' } } : {}),
+        };
+    }
+    const approveLabel = planReview ? intent.approve : undefined;
+    const actions = [];
+    if (!needsTextReply) {
+        for (const [index, option] of (question.options ?? []).entries()) {
+            const selected = pending.selected.has(option.label);
+            actions.push({
+                actions: [{
+                        id: bindAction({ kind: 'option', optionIndex: index }),
+                        label: `${selected ? '✓ ' : ''}${option.label}`,
+                        ...(option.label === approveLabel ? { style: 'primary' } : {}),
+                    }],
+            });
+        }
+        if (question.options?.length) {
+            actions.push({ actions: [{ id: bindAction({ kind: 'custom' }), label: '其他' }] });
+            if (question.multiSelect) {
+                actions.push({ actions: [{ id: bindAction({ kind: 'done' }), label: '完成', style: 'primary' }] });
+            }
+        }
+    }
+    if (!needsTextReply) {
+        actions.push({ actions: [{ id: bindAction({ kind: 'skip' }), label: '跳过本题' }] });
+    }
+    return {
+        text: lines.filter(Boolean).join('\n\n'),
+        ...(needsTextReply ? { replyPrompt: { kind: 'text' } } : { actions }),
+    };
+}
+//# sourceMappingURL=question-renderer.js.map

package/lib/interactions/question-renderer.js.map

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