@qwen-code/channel-dingtalk 0.23.4 → 0.24.0

package/dist/DingtalkAdapter.d.ts

@@ -1,7 +1,7 @@
 import { ChannelBase } from '@qwen-code/channel-base';
 import { DingtalkInteractiveCardClient } from './interactive-card-client.js';
 import { type DingtalkCardCallback, type DingtalkCardCallbackResult } from './interactive-card-types.js';
-import type { ChannelConfig, ChannelBaseOptions, Envelope, ChannelAgentBridge, ChannelOutputSegmentContext, ChannelOutputSegmentEndReason, ChannelPermissionRequestContext, ChannelTaskLifecycleEvent, ChannelUserInputRequestContext, SessionTarget, UserInputPresentationResult } from '@qwen-code/channel-base';
+import type { BackgroundResponseContext, ChannelConfig, ChannelBaseOptions, Envelope, ChannelAgentBridge, ChannelOutputSegmentContext, ChannelOutputSegmentEndReason, ChannelPermissionRequestContext, ChannelTaskLifecycleEvent, ChannelUserInputRequestContext, SessionTarget, UserInputPresentationResult } from '@qwen-code/channel-base';
 export declare class DingtalkChannel extends ChannelBase {
     private client;
     private readonly atSender;
@@ -19,7 +19,7 @@ export declare class DingtalkChannel extends ChannelBase {
     private reactionStates;
     /** sessionId → reaction keys, so a dead session's reactions can be recalled. */
     private sessionReactionKeys;
-    /** Settles when the reaction cleanup queued by disconnect() has run. */
+    /** Settles after background output and reaction cleanup finish on disconnect. */
     private disconnectDrain;
     /**
      * Real inbound message ids (insertion-ordered, size-capped). Unlike the
@@ -33,6 +33,7 @@ export declare class DingtalkChannel extends ChannelBase {
      */
     private proactiveToken?;
     private readonly interactiveCardConfig;
+    private readonly outputMode?;
     protected readonly interactiveCardClient?: DingtalkInteractiveCardClient;
     private statusCardController?;
     private questionCardController?;
@@ -42,6 +43,7 @@ export declare class DingtalkChannel extends ChannelBase {
     private readonly cardRunBySession;
     private readonly cardRuns;
     private readonly fileProjectors;
+    private readonly backgroundOutputCoordinator;
     constructor(name: string, config: ChannelConfig, bridge: ChannelAgentBridge, options?: ChannelBaseOptions);
     private createClient;
     private installStructuredDownstreamHandler;
@@ -119,6 +121,7 @@ export declare class DingtalkChannel extends ChannelBase {
      * the sessions on a fresh bridge.
      */
     onBridgeDisconnected(): void;
+    protected onSessionRetiring(sessionId: string): void;
     protected onTaskLifecycle(event: ChannelTaskLifecycleEvent): void;
     protected onPromptBufferDropped(_chatId: string, sessionId: string, messageIds: string[]): void;
     protected onPromptBufferDrained(_chatId: string, sessionId: string, messageIds: string[]): void;
@@ -128,7 +131,28 @@ export declare class DingtalkChannel extends ChannelBase {
     protected processInbound(envelope: Envelope): Promise<void>;
     private untrackBufferedMentionTarget;
     protected onPromptEnd(chatId: string, sessionId: string, messageId?: string): void;
-    protected sendResponseMessage(chatId: string, text: string, sessionId: string, sourceLabel?: string, prepared?: boolean): Promise<void>;
+    dispatchBackgroundResponse(sessionId: string, text: string, context?: BackgroundResponseContext): Promise<void>;
+    private createBackgroundOutputDelivery;
+    private formatBackgroundOutputHeader;
+    private formatBackgroundTaskLabel;
+    private prepareBackgroundOutput;
+    protected deliverBackgroundResponseToTarget(sessionId: string, text: string, delivery: {
+        target: SessionTarget;
+        sourceLabel?: string;
+    }, prepared?: boolean, result?: {
+        status: string;
+        partial?: boolean;
+    }): Promise<void>;
+    /**
+     * Body-identical to the base implementation — this override exists only to
+     * widen the signature, which the base seam does not declare. The background
+     * output delivery passes `prepared` so the body it already projected isn't
+     * projected a second time (that would re-upload its files), and
+     * `failOnHttpError` so a failed send throws instead of being swallowed,
+     * letting the flush capture the delivery plan for the next retry.
+     */
+    protected deliverBackgroundReply(chatId: string, text: string, sessionId: string, sourceLabel?: string, prepared?: boolean, failOnHttpError?: boolean): Promise<void>;
+    protected sendResponseMessage(chatId: string, text: string, sessionId: string, sourceLabel?: string, prepared?: boolean, failOnHttpError?: boolean): Promise<void>;
     private sendFallbackReply;
     protected onResponseComplete(chatId: string, text: string, sessionId: string, segment?: ChannelOutputSegmentContext): Promise<void>;
     protected onOutputSegmentEnd(_chatId: string, _sessionId: string, segment: ChannelOutputSegmentContext, reason: ChannelOutputSegmentEndReason): void | Promise<void>;

package/dist/DingtalkAdapter.d.ts.map

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

package/dist/DingtalkAdapter.js

@@ -4,16 +4,16 @@ import { basename, join } from 'node:path';
 import { tmpdir } from 'node:os';
 import { Buffer } from 'node:buffer';
 import { DWClient, TOPIC_CARD, TOPIC_ROBOT, EventAck, } from 'dingtalk-stream-sdk-nodejs';
-import { ChannelBase, isTerminalTaskLifecycleType, sanitizeLogText, sanitizePromptText, sanitizeSenderName, truncateUtf16Units, } from '@qwen-code/channel-base';
+import { ChannelBase, BackgroundOutputCoordinator, parseChannelOutputMode, isTerminalTaskLifecycleType, sanitizeLogText, sanitizePromptText, sanitizeSenderName, truncateUtf16Units, } from '@qwen-code/channel-base';
 import { DINGTALK_CHUNK_LIMIT, escapeDingTalkMarkdown, normalizeDingTalkMarkdown, extractTitle, } from './markdown.js';
 import { downloadMedia } from './media.js';
 import { DingTalkMediaUploadError, findImageMarkers, readValidatedImage, replaceImageMarkers, uploadDingTalkImage, } from './outbound-image.js';
 import { FILE_UNAVAILABLE_NOTICE, OutboundFileProjector, projectFileText, readValidatedFile, safeFileName, uploadDingTalkFile, } from './outbound-file.js';
 import { DingtalkConnectionManager, } from './DingtalkConnectionManager.js';
-import { DingtalkCardRequestError, DingtalkInteractiveCardClient, } from './interactive-card-client.js';
+import { DingtalkCardRequestError, DingtalkInteractiveCardClient, isRetryableDingtalkStatus, } from './interactive-card-client.js';
 import { parseDingtalkCardActorId, parseDingtalkCardCallback, parseDingtalkInteractiveCardConfig, } from './interactive-card-types.js';
 import { StatusCardController } from './status-card-controller.js';
-import { isChinesePresentationLanguage, lifecyclePresentationPhase, presentationPhaseLabel, } from './presentation-phase.js';
+import { isChinesePresentationLanguage, lifecyclePresentationPhase, markPartialOutput, partialOutputLabel, presentationPhaseLabel, } from './presentation-phase.js';
 import { QuestionCardController } from './question-card-controller.js';
 import { PermissionCardController } from './permission-card-controller.js';
 import { DingtalkInteractionPresenter } from './interaction-presenter.js';
@@ -413,6 +413,10 @@ function formatChatRecord(content, budget = MAX_CHAT_RECORD_CHARS) {
 }
 /** Track seen msgIds to deduplicate retried callbacks. */
 const DEDUP_TTL_MS = 5 * 60 * 1000; // 5 minutes
+/** The charset ChannelBase's own slash classifier requires of a leading
+ * `/token`. Slash-prefixed prose — a path, a `//` or block comment — fails it
+ * and stays prose. */
+const SLASH_COMMAND_TOKEN_RE = /^[a-zA-Z0-9_:-]+$/;
 const ACK_REACTION_NAME = '👀';
 const ACK_EMOTION_ID = '2659900';
 const ACK_EMOTION_BG_ID = 'im_bg_1';
@@ -625,6 +629,28 @@ async function withConnectLoggingSuppressed(connect) {
         }
     }
 }
+class ProactiveTextDeliveryError extends Error {
+    plan;
+    retryable;
+    constructor(plan, cause) {
+        super(cause instanceof Error ? cause.message : String(cause), { cause });
+        this.plan = plan;
+        if (cause instanceof DingtalkCardRequestError) {
+            this.retryable = cause.retryable;
+        }
+    }
+}
+class ReplyTextDeliveryError extends Error {
+    plan;
+    retryable;
+    constructor(plan, cause) {
+        super(cause instanceof Error ? cause.message : String(cause), { cause });
+        this.plan = plan;
+        if (cause instanceof DingtalkCardRequestError) {
+            this.retryable = cause.retryable;
+        }
+    }
+}
 export class DingtalkChannel extends ChannelBase {
     client;
     atSender;
@@ -642,7 +668,7 @@ export class DingtalkChannel extends ChannelBase {
     reactionStates = new Map();
     /** sessionId → reaction keys, so a dead session's reactions can be recalled. */
     sessionReactionKeys = new Map();
-    /** Settles when the reaction cleanup queued by disconnect() has run. */
+    /** Settles after background output and reaction cleanup finish on disconnect. */
     disconnectDrain;
     /**
      * Real inbound message ids (insertion-ordered, size-capped). Unlike the
@@ -656,6 +682,7 @@ export class DingtalkChannel extends ChannelBase {
      */
     proactiveToken;
     interactiveCardConfig;
+    outputMode;
     interactiveCardClient;
     statusCardController;
     questionCardController;
@@ -668,6 +695,7 @@ export class DingtalkChannel extends ChannelBase {
     // boundary, input requested) mints a fresh segment UUID but the projection
     // state must survive it, or a marker split across the reset leaks.
     fileProjectors = new Map();
+    backgroundOutputCoordinator;
     constructor(name, config, bridge, options) {
         super(name, config, bridge, options);
         this.atSender =
@@ -688,6 +716,19 @@ export class DingtalkChannel extends ChannelBase {
             this.config.instructions += FILE_INSTRUCTIONS;
         }
         this.interactiveCardConfig = parseDingtalkInteractiveCardConfig(config.interactiveCards);
+        this.outputMode = parseChannelOutputMode(name, config.outputMode, true);
+        this.backgroundOutputCoordinator = new BackgroundOutputCoordinator({
+            outputMode: this.outputMode,
+            getTarget: (sessionId) => this.router.getTarget(sessionId),
+            getSourceLabel: (sessionId) => this.getBackgroundResponseSourceLabel(sessionId),
+            resolveDelivery: (sessionId) => this.resolveBackgroundResponseDelivery(sessionId),
+            createDelivery: (sessionId, target) => this.createBackgroundOutputDelivery(sessionId, target),
+            isRetryableError: (error) => !((error instanceof ProactiveTextDeliveryError ||
+                error instanceof ReplyTextDeliveryError ||
+                error instanceof DingtalkCardRequestError) &&
+                error.retryable === false),
+            log: (message) => process.stderr.write(`[DingTalk:${this.name}] ${message}`),
+        });
         if (!config.clientId || !config.clientSecret) {
             throw new Error(`Channel "${name}" requires clientId and clientSecret for DingTalk.`);
         }
@@ -744,20 +785,18 @@ export class DingtalkChannel extends ChannelBase {
                     },
                 });
             }
-            if (this.statusCardController ||
-                this.questionCardController ||
-                this.permissionCardController) {
-                this.interactionPresenter = new DingtalkInteractionPresenter({
-                    statusCards: this.statusCardController,
-                    questionCards: this.questionCardController,
-                    permissionCards: this.permissionCardController,
-                    ...(options?.displayLanguage
-                        ? { language: options.displayLanguage }
-                        : {}),
-                    sendFallback: (chatId, text, sessionId, sourceLabel) => this.sendFallbackReply(chatId, text, sessionId, sourceLabel),
-                });
-            }
         }
+        this.interactionPresenter = new DingtalkInteractionPresenter({
+            outputMode: this.outputMode,
+            prepareOutput: (chatId, text) => this.prepareReplyOutput(chatId, text),
+            statusCards: this.statusCardController,
+            questionCards: this.questionCardController,
+            permissionCards: this.permissionCardController,
+            ...(options?.displayLanguage
+                ? { language: options.displayLanguage }
+                : {}),
+            sendFallback: (chatId, text, sessionId, sourceLabel) => this.sendFallbackReply(chatId, text, sessionId, sourceLabel),
+        });
         if (useConnectionManager) {
             this.connectionManager = new DingtalkConnectionManager({
                 initialClient: this.client,
@@ -1121,11 +1160,14 @@ export class DingtalkChannel extends ChannelBase {
         }
         return replaceImageMarkers(text, markers, replacements);
     }
-    async sendReply(chatId, text, atUserId, sourceLabel, prepared = false) {
+    async sendReply(chatId, text, atUserId, sourceLabel, prepared = false, failOnHttpError = false) {
         // chatId is a conversationId — resolve to the latest sessionWebhook.
         const webhook = this.webhooks.get(chatId);
         if (!webhook) {
             process.stderr.write(`[DingTalk:${this.name}] No webhook for chatId ${chatId}, cannot send.\n`);
+            if (failOnHttpError) {
+                throw new Error('DingTalk session webhook unavailable');
+            }
             return;
         }
         const outgoingText = prepared
@@ -1134,7 +1176,12 @@ export class DingtalkChannel extends ChannelBase {
         if (!outgoingText.trim())
             return;
         const plan = this.createReplyTextDelivery(outgoingText, atUserId, sourceLabel);
-        await this.deliverReplyText(chatId, plan);
+        try {
+            await this.deliverReplyText(chatId, plan, failOnHttpError);
+        }
+        catch (error) {
+            throw new ReplyTextDeliveryError(plan, error);
+        }
     }
     createReplyTextDelivery(outgoingText, atUserId, sourceLabel) {
         const mentionPrefix = atUserId ? `@${atUserId}\n\n` : '';
@@ -1153,9 +1200,12 @@ export class DingtalkChannel extends ChannelBase {
             ...(atUserId ? { atUserId } : {}),
         };
     }
-    async deliverReplyText(chatId, plan) {
+    async deliverReplyText(chatId, plan, failOnHttpError = false) {
         const webhook = this.webhooks.get(chatId);
         if (!webhook) {
+            if (failOnHttpError) {
+                throw new Error('DingTalk session webhook unavailable');
+            }
             return;
         }
         while (plan.nextChunk < plan.chunks.length) {
@@ -1200,6 +1250,24 @@ export class DingtalkChannel extends ChannelBase {
             if (!resp.ok) {
                 const detail = await resp.text().catch(() => '');
                 process.stderr.write(`[DingTalk:${this.name}] sendMessage failed: HTTP ${resp.status} ${detail}\n`);
+                if (failOnHttpError) {
+                    throw new DingtalkCardRequestError(`DingTalk reply send failed: HTTP ${resp.status} ${detail}`, isRetryableDingtalkStatus(resp.status));
+                }
+            }
+            else if (failOnHttpError) {
+                const payload = (await resp
+                    .clone()
+                    .json()
+                    .catch(() => undefined));
+                const response = payload && typeof payload === 'object'
+                    ? payload
+                    : undefined;
+                const value = response?.['errcode'] ?? response?.['code'];
+                if (value !== undefined && String(value) !== '0') {
+                    const detail = sanitizeLogText(String(response?.['errmsg'] ?? response?.['message'] ?? value), 300);
+                    process.stderr.write(`[DingTalk:${this.name}] sendMessage failed: ${detail}\n`);
+                    throw new Error(`DingTalk reply send failed: ${detail}`);
+                }
             }
             plan.nextChunk++;
         }
@@ -1240,7 +1308,12 @@ export class DingtalkChannel extends ChannelBase {
         const plan = await this.createProactiveTextDelivery(target, text, sourceLabel);
         if (!plan)
             return;
-        await this.deliverProactiveText(target, plan);
+        try {
+            await this.deliverProactiveText(target, plan);
+        }
+        catch (error) {
+            throw new ProactiveTextDeliveryError(plan, error);
+        }
     }
     async createProactiveTextDelivery(target, text, sourceLabel) {
         const outgoingText = await this.prepareFileOutput(text, (file, mediaId) => this.sendProactiveFile(target, file, mediaId));
@@ -1362,7 +1435,7 @@ export class DingtalkChannel extends ChannelBase {
             if (!resp.ok) {
                 const detail = sanitizeLogText(await resp.text().catch(() => ''), 300);
                 process.stderr.write(`[DingTalk:${this.name}] proactive send failed (${targetKind}, ${chunkLabel}): HTTP ${resp.status} ${detail}\n`);
-                throw new Error(`DingTalk proactive send failed: HTTP ${resp.status}${detail ? ` ${detail}` : ''}`);
+                throw new DingtalkCardRequestError(`DingTalk proactive send failed: HTTP ${resp.status}${detail ? ` ${detail}` : ''}`, isRetryableDingtalkStatus(resp.status));
             }
             if (target.isGroup === true) {
                 if (msgKey !== PROACTIVE_FILE_MSG_KEY) {
@@ -1484,7 +1557,7 @@ export class DingtalkChannel extends ChannelBase {
         for (const state of reactionStates) {
             this.finishReaction(state.chatId, state.messageId, state.sessionId);
         }
-        this.statusCardController?.dispose();
+        const backgroundDrain = this.backgroundOutputCoordinator.drain();
         this.activeReactionKeys.clear();
         this.sessionReactionKeys.clear();
         this.reactionStates.clear();
@@ -1495,7 +1568,12 @@ export class DingtalkChannel extends ChannelBase {
             this.client.disconnect();
         }
         process.stderr.write(`[DingTalk:${this.name}] Disconnected.\n`);
-        this.disconnectDrain = Promise.allSettled(reactionStates.map((state) => state.tail)).then(() => undefined);
+        this.disconnectDrain = Promise.allSettled([
+            backgroundDrain,
+            ...reactionStates.map((state) => state.tail),
+        ]).then(() => {
+            this.statusCardController?.dispose();
+        });
     }
     waitForDisconnect() {
         return this.disconnectDrain ?? Promise.resolve();
@@ -1764,6 +1842,8 @@ export class DingtalkChannel extends ChannelBase {
             }
         }
         this.sessionMentionTargets.delete(sessionId);
+        // Preserve a pending background turn's latest result if its session dies.
+        this.backgroundOutputCoordinator.drain(sessionId);
         const cardRunId = this.cardRunBySession.get(sessionId);
         if (cardRunId) {
             this.cardRunBySession.delete(sessionId);
@@ -1787,6 +1867,7 @@ export class DingtalkChannel extends ChannelBase {
      * the sessions on a fresh bridge.
      */
     onBridgeDisconnected() {
+        void this.backgroundOutputCoordinator.drain();
         for (const [sessionId, keys] of this.sessionReactionKeys) {
             this.sessionReactionKeys.delete(sessionId);
             for (const { messageId, chatId } of keys.values()) {
@@ -1799,6 +1880,9 @@ export class DingtalkChannel extends ChannelBase {
             this.cardRuns.delete(runId);
         }
     }
+    onSessionRetiring(sessionId) {
+        this.backgroundOutputCoordinator.drain(sessionId);
+    }
     onTaskLifecycle(event) {
         if (event.type === 'started') {
             this.startReaction(event.chatId, event.messageId, event.sessionId);
@@ -1813,7 +1897,10 @@ export class DingtalkChannel extends ChannelBase {
                 this.cardRuns.set(event.runId, inboundOwner);
                 this.cardRunBySession.set(event.sessionId, event.runId);
                 const sourceLabel = this.getResponseSourceLabel(event.sessionId);
-                this.interactionPresenter?.registerRun(event.runId, event.owner.id, inboundOwner.target, event.sessionId, inboundOwner.sender, ...(sourceLabel ? [sourceLabel] : []));
+                const atUserId = this.atSender && event.messageId
+                    ? this.mentionTargets.get(event.messageId)
+                    : undefined;
+                this.interactionPresenter?.registerRun(event.runId, event.owner.id, inboundOwner.target, event.sessionId, inboundOwner.sender, sourceLabel, (chatId, text, _sessionId, label) => this.sendReply(chatId, text, atUserId, label));
                 this.interactionPresenter?.startStatusCard(event.runId);
             }
             return;
@@ -1944,13 +2031,177 @@ export class DingtalkChannel extends ChannelBase {
         this.sessionMentionTargets.delete(sessionId);
         this.stopReaction(chatId, messageId, sessionId);
     }
-    async sendResponseMessage(chatId, text, sessionId, sourceLabel, prepared = false) {
+    async dispatchBackgroundResponse(sessionId, text, context) {
+        const target = this.router.getTarget(sessionId);
+        if (!target || target.channelName !== this.name) {
+            return super.dispatchBackgroundResponse(sessionId, text, context);
+        }
+        if (await this.backgroundOutputCoordinator.dispatch(sessionId, text, context)) {
+            return;
+        }
+        if (!text.trim())
+            return;
+        const delivery = await this.resolveBackgroundResponseDelivery(sessionId);
+        if (!delivery || this.router.getTarget(sessionId) !== delivery.target)
+            return;
+        await this.deliverBackgroundResponseToTarget(sessionId, text, delivery, false, context);
+    }
+    createBackgroundOutputDelivery(sessionId, target) {
+        let proactivePlan;
+        let replyPlan;
+        // Prepared output can already have sent attachment messages.
+        let preparedReplyBody;
+        let composedHeader;
+        let composedTurnComplete = false;
+        return async (output) => {
+            const header = this.formatBackgroundOutputHeader(output);
+            const body = [header, output.text].filter(Boolean).join('\n\n');
+            const plan = proactivePlan ?? replyPlan;
+            if (!plan || plan.nextChunk === 0) {
+                const replaceHeader = (text) => {
+                    if (composedHeader === undefined || composedHeader === header) {
+                        return text;
+                    }
+                    const separator = output.text ? '\n\n' : '';
+                    const previous = composedHeader
+                        ? `${composedHeader}${separator}`
+                        : '';
+                    const next = header ? `${header}${separator}` : '';
+                    return text.startsWith(previous)
+                        ? `${next}${text.slice(previous.length)}`
+                        : text;
+                };
+                if (plan) {
+                    plan.title = extractTitle(body);
+                    const prefix = (replyPlan?.atUserId ? `@${replyPlan.atUserId}\n\n` : '') +
+                        (target.sourceLabel
+                            ? `${escapeDingTalkMarkdown(target.sourceLabel)}\n\n`
+                            : '');
+                    plan.chunks[0] =
+                        prefix + replaceHeader(plan.chunks[0].slice(prefix.length));
+                }
+                if (preparedReplyBody) {
+                    preparedReplyBody = replaceHeader(preparedReplyBody);
+                }
+                composedHeader = header;
+                composedTurnComplete = output.turnComplete;
+            }
+            try {
+                if (proactivePlan) {
+                    await this.deliverProactiveText(target.target, proactivePlan);
+                }
+                else if (replyPlan) {
+                    await this.deliverReplyText(target.target.chatId, replyPlan, true);
+                }
+                else {
+                    if (this.statusCardController ||
+                        !this.supportsProactiveSend() ||
+                        !this.supportsProactiveTarget(target.target)) {
+                        preparedReplyBody ??= await this.prepareBackgroundOutput(target.target, body);
+                    }
+                    await this.deliverBackgroundResponseToTarget(sessionId, preparedReplyBody ?? body, target, preparedReplyBody !== undefined, output);
+                }
+                return { turnComplete: composedTurnComplete };
+            }
+            catch (error) {
+                if (error instanceof ProactiveTextDeliveryError) {
+                    proactivePlan = error.plan;
+                }
+                else if (error instanceof ReplyTextDeliveryError) {
+                    replyPlan = error.plan;
+                }
+                throw error;
+            }
+        };
+    }
+    formatBackgroundOutputHeader(delivery) {
+        const chinese = isChinesePresentationLanguage(this.displayLanguage);
+        const partialLabel = partialOutputLabel(this.displayLanguage);
+        const icon = delivery.status === 'completed'
+            ? '✅'
+            : delivery.status === 'failed'
+                ? '❌'
+                : '⏹️';
+        if (delivery.kind === 'agent') {
+            if (delivery.text)
+                return delivery.partial ? partialLabel : '';
+            const status = delivery.status === 'completed'
+                ? chinese
+                    ? '已完成'
+                    : 'completed'
+                : delivery.status === 'failed'
+                    ? chinese
+                        ? '失败'
+                        : 'failed'
+                    : chinese
+                        ? '已停止'
+                        : 'stopped';
+            return chinese
+                ? `${icon} 后台任务${status}`
+                : `${icon} Background task ${status}`;
+        }
+        const label = this.formatBackgroundTaskLabel(delivery.label);
+        const kind = {
+            shell: 'Shell',
+            monitor: 'Monitor',
+            workflow: 'Workflow',
+        }[delivery.kind];
+        return `## ${icon} ${kind} · ${label}${delivery.partial ? `${chinese ? '' : ' '}${partialLabel}` : ''}`;
+    }
+    formatBackgroundTaskLabel(label) {
+        const normalized = label
+            ?.replace(/\p{Cc}+/gu, ' ')
+            .replace(/\s+/g, ' ')
+            .trim();
+        return escapeDingTalkMarkdown(normalized ||
+            (isChinesePresentationLanguage(this.displayLanguage)
+                ? '后台任务'
+                : 'Background task'));
+    }
+    prepareBackgroundOutput(target, text) {
+        return this.supportsProactiveSend() && this.supportsProactiveTarget(target)
+            ? this.prepareFileOutput(text, (file, mediaId) => this.sendProactiveFile(target, file, mediaId))
+            : this.prepareReplyOutput(target.chatId, text);
+    }
+    async deliverBackgroundResponseToTarget(sessionId, text, delivery, prepared = false, result) {
+        const { target, sourceLabel } = delivery;
+        if (this.statusCardController &&
+            this.supportsProactiveDeliveryTarget(target) &&
+            (target.isGroup === true || this.isStableTargetId(target.senderId))) {
+            if (!prepared) {
+                text = await this.prepareBackgroundOutput(target, text);
+                prepared = true;
+            }
+            if (await this.statusCardController.deliverCompletedResult({
+                chatId: target.isGroup ? target.chatId : target.senderId,
+                isGroup: target.isGroup === true,
+            }, text, sourceLabel, result)) {
+                return;
+            }
+        }
+        if (this.supportsProactiveSend() && this.supportsProactiveTarget(target)) {
+            return super.deliverBackgroundResponseToTarget(sessionId, text, delivery);
+        }
+        await this.deliverBackgroundReply(target.chatId, text, sessionId, sourceLabel, prepared, true);
+    }
+    /**
+     * Body-identical to the base implementation — this override exists only to
+     * widen the signature, which the base seam does not declare. The background
+     * output delivery passes `prepared` so the body it already projected isn't
+     * projected a second time (that would re-upload its files), and
+     * `failOnHttpError` so a failed send throws instead of being swallowed,
+     * letting the flush capture the delivery plan for the next retry.
+     */
+    async deliverBackgroundReply(chatId, text, sessionId, sourceLabel, prepared = false, failOnHttpError = false) {
+        await this.sendResponseMessage(chatId, text, sessionId, sourceLabel, prepared, failOnHttpError);
+    }
+    async sendResponseMessage(chatId, text, sessionId, sourceLabel, prepared = false, failOnHttpError = false) {
         const atUserId = this.atSender
             ? this.sessionMentionTargets.get(sessionId)
             : undefined;
         if (atUserId)
             this.sessionMentionTargets.delete(sessionId);
-        await this.sendReply(chatId, text, atUserId, sourceLabel ?? this.getResponseSourceLabel(sessionId), prepared);
+        await this.sendReply(chatId, text, atUserId, sourceLabel ?? this.getResponseSourceLabel(sessionId), prepared, failOnHttpError);
     }
     async sendFallbackReply(chatId, text, sessionId, sourceLabel) {
         // Mid-run fallbacks must not consume the prompt's mention target: the
@@ -1972,7 +2223,9 @@ export class DingtalkChannel extends ChannelBase {
                 return;
             }
         }
-        await this.sendResponseMessage(chatId, outgoingText, sessionId, segment?.sourceLabel, true);
+        await this.sendResponseMessage(chatId, segment?.partial
+            ? markPartialOutput(outgoingText, this.displayLanguage)
+            : outgoingText, sessionId, segment?.sourceLabel, true);
     }
     onOutputSegmentEnd(_chatId, _sessionId, segment, reason) {
         if (reason === 'completed' ||
@@ -2409,6 +2662,27 @@ export class DingtalkChannel extends ChannelBase {
             const mentionedMemberIds = isGroup ? collectNonBotMentionIds(data) : [];
             const senderId = senderStaffId || senderIdValue || '';
             const senderName = senderNick || senderId || 'Unknown';
+            // A user-scope 1:1 DM gets no [sender] tag from ChannelBase — that prefix
+            // needs isGroup or sessionScope 'single' — so neither the model nor the
+            // transcript (which renders exactly the prompt) would record who sent
+            // this. metadata is appended AFTER command parsing, so locally dispatched
+            // DM commands and `!` shell never see it; an agent-exposed command does,
+            // and its parser sweeps everything past the command path into `args`, so
+            // a DM opening on a bare command token gets no identity line. trimStart
+            // because the audio and chat-record branches hand back untrimmed text. It
+            // stays one line because that append folds CR/LF to spaces. The nick is
+            // attacker-controlled and the ID is platform-opaque, so both go through
+            // the shared name sanitizer. The ID is spelled out only next to a nick,
+            // otherwise the same value reads twice.
+            const dmSenderId = senderNick && senderId
+                ? ` (sender ID: ${sanitizeSenderName(senderId)})`
+                : '';
+            const dmCommandToken = content.text.trimStart().match(/^\/(\S+)/)?.[1] ?? '';
+            const dmSenderMetadata = !isGroup &&
+                this.config.sessionScope !== 'single' &&
+                !SLASH_COMMAND_TOKEN_RE.test(dmCommandToken)
+                ? `Direct message from ${sanitizeSenderName(senderNick || senderId)}${dmSenderId}`
+                : undefined;
             const envelope = {
                 channelName: this.name,
                 senderId,
@@ -2420,6 +2694,7 @@ export class DingtalkChannel extends ChannelBase {
                 text: content.text,
                 ...(content.syntheticText ? { syntheticText: true } : {}),
                 ...(mentionedMemberIds.length > 0 ? { mentionedMemberIds } : {}),
+                ...(dmSenderMetadata ? { metadata: dmSenderMetadata } : {}),
                 isGroup,
                 isMentioned,
                 isReplyToBot: quoted.isReplyToBot,