@zhin.js/adapter-qq 1.1.19 → 1.1.21

package/lib/self-profile.js

@@ -0,0 +1,14 @@
+import { createEndpointOperation } from 'zhin.js/adapter';
+/** QQ official Bot.Info has an actual bot id, display username and public avatar URL. */
+export function createQqSelfProfile({ client, reportAccount }) {
+    return Object.freeze({
+        writableFields: Object.freeze([]),
+        async read({ signal }) {
+            const self = await createEndpointOperation({ signal }).prepare(() => client.getSelfInfo());
+            if (!self?.id || typeof self.username !== 'string')
+                throw new Error('QQ returned an incomplete bot profile');
+            reportAccount(self.id);
+            return { nickname: self.username, ...(typeof self.avatar === 'string' ? { avatar: self.avatar } : {}) };
+        },
+    });
+}

package/lib/stream-markdown.d.ts

@@ -0,0 +1,5 @@
+/** Only source-level fenced context is portable to a fresh native Markdown message. */
+export declare function qqMarkdownContinuation(precedingText: string): {
+    readonly opening: string;
+};
+export declare function qqMarkdownClosing(source: string): string;

package/lib/stream-markdown.js

@@ -0,0 +1,41 @@
+import { EndpointDeliveryError } from '@zhin.js/im-contract';
+/** Only source-level fenced context is portable to a fresh native Markdown message. */
+export function qqMarkdownContinuation(precedingText) {
+    if (!precedingText)
+        return { opening: '' };
+    const fence = openFence(precedingText);
+    if (fence) {
+        if (!precedingText.includes('\n', fence.offset))
+            throw unsupported();
+        return { opening: `${fence.marker}${fence.info}\n` };
+    }
+    if (/(?:^|\n) {0,3}(?:`{3,}|~{3,})[ \t]*\n?$/.test(precedingText))
+        return { opening: '' };
+    const boundary = precedingText.lastIndexOf('\n\n');
+    const block = precedingText.slice(boundary >= 0 ? boundary + 2 : 0);
+    // No native contract permits retroactively recreating an unfinished inline
+    // construct in another message. Admit plain continuations and closed blocks.
+    if (/[`*_\[\]~]/.test(block))
+        throw unsupported();
+    return { opening: '' };
+}
+export function qqMarkdownClosing(source) {
+    const fence = openFence(source);
+    return fence ? `${source.endsWith('\n') ? '' : '\n'}${fence.marker}` : '';
+}
+function openFence(source) {
+    let active;
+    for (const line of source.matchAll(/^ {0,3}(`{3,}|~{3,})([^\n]*)/gm)) {
+        const marker = line[1], info = line[2];
+        if (active) {
+            if (marker[0] === active.marker[0] && marker.length >= active.marker.length && !info.trim())
+                active = undefined;
+        }
+        else if (marker[0] !== '`' || !info.includes('`'))
+            active = { marker, info, offset: line.index };
+    }
+    return active;
+}
+function unsupported() {
+    return new EndpointDeliveryError('unsupported_operation', 'QQ Markdown continuation requires a plain block boundary or a complete fenced-code header', 'not_sent');
+}

package/lib/streaming.d.ts

@@ -0,0 +1,5 @@
+import type { Bot } from 'qq-official-bot';
+import { type EndpointStreaming } from 'zhin.js/adapter';
+import { type QqPassiveReplyLedger } from './passive-reply.js';
+/** C2C native streams share the ordinary passive ledger, source and sequence. */
+export declare function createQqStreaming(getBot: () => Bot, ledger: QqPassiveReplyLedger, minIntervalMs?: number): EndpointStreaming;

package/lib/streaming.js

@@ -0,0 +1,105 @@
+import { createEndpointOperation } from 'zhin.js/adapter';
+import { EndpointDeliveryError } from '@zhin.js/im-contract';
+import { qqDeliveryFailure } from './delivery-error.js';
+import { QQ_PASSIVE_SOURCE_CODES } from './passive-reply.js';
+import { qqOutboundKind, resolveOutboundMessageId } from './protocol.js';
+import { qqMarkdownClosing, qqMarkdownContinuation } from './stream-markdown.js';
+function supportsQqStream(request) {
+    return qqOutboundKind(request.conversation) === 'private';
+}
+/** C2C native streams share the ordinary passive ledger, source and sequence. */
+export function createQqStreaming(getBot, ledger, minIntervalMs = 500) {
+    return {
+        mode: 'native',
+        minIntervalMs,
+        supports: supportsQqStream,
+        open(request) {
+            if (!supportsQqStream(request))
+                return undefined;
+            // stream_messages has no verified canonical mention/keyboard projection.
+            // Keep these combinations on the complete-message codec instead of guessing.
+            if (request.prefix?.some(segment => segment.type !== 'reply'))
+                return undefined;
+            const reply = request.prefix?.find(segment => segment.type === 'reply');
+            const explicitId = reply && 'message_id' in reply.data ? reply.data.message_id : undefined;
+            const preferred = typeof explicitId === 'string' && explicitId
+                ? { id: explicitId }
+                : request.source?.messageId ? { id: request.source.messageId } : undefined;
+            if (!ledger.hasUsableSource('private', request.conversation.id, preferred))
+                return undefined;
+            const precedingText = request.continuation?.precedingText ?? '';
+            const opening = request.format === 'markdown' ? qqMarkdownContinuation(precedingText).opening : '';
+            const cancellation = new AbortController();
+            const signal = request.signal ? AbortSignal.any([request.signal, cancellation.signal]) : cancellation.signal;
+            const operation = createEndpointOperation({ signal });
+            let native;
+            let grant;
+            let acceptedText = '';
+            let messageId;
+            let exhausted = false;
+            let contentUnavailable = Boolean(opening);
+            let openingSent = false;
+            let failure;
+            let completion;
+            const acknowledgement = () => ({
+                status: messageId ? 'sent' : 'buffered', acceptedText, ...(messageId ? { messageId } : {}),
+                ...(exhausted ? { exhausted: true } : {}),
+                ...(contentUnavailable ? { contentUnavailable: true } : {}),
+            });
+            const send = async (text, final) => {
+                if (failure)
+                    throw failure;
+                if (signal.aborted)
+                    throw new EndpointDeliveryError('endpoint_inactive', 'QQ stream cancelled', 'not_sent');
+                if (!text.startsWith(acceptedText))
+                    throw new EndpointDeliveryError('invalid_payload', 'QQ stream cannot replace its accepted prefix', 'not_sent');
+                if (!final && (text === acceptedText || exhausted))
+                    return acknowledgement();
+                if (final && exhausted && text !== acceptedText)
+                    throw new EndpointDeliveryError('stream_capacity', 'QQ exhausted stream must finish its accepted prefix', 'not_sent');
+                if (!native) {
+                    if (!text)
+                        return acknowledgement();
+                    grant = ledger.acquire('private', request.conversation.id, preferred);
+                    if (!grant)
+                        throw new EndpointDeliveryError('unsupported_operation', 'QQ stream has no usable passive reply source', 'not_sent');
+                    native = getBot().createPrivateStream(request.conversation.id, {
+                        source: grant.source, msgSeq: grant.msgSeq,
+                        contentType: request.format, inputMode: 'append',
+                    });
+                }
+                try {
+                    const closing = final && request.format === 'markdown' ? qqMarkdownClosing(precedingText + text) : '';
+                    // An exhausted container permits only the terminating state frame;
+                    // no extra formatting characters may exceed its confirmed capacity.
+                    const suffix = exhausted ? '' : closing;
+                    const delta = (openingSent ? '' : opening) + text.slice(acceptedText.length) + suffix;
+                    const result = await operation.run(() => final ? native.end(delta) : native.write(delta));
+                    const id = resolveOutboundMessageId(result);
+                    messageId = `private-${request.conversation.id}:${id}`;
+                    acceptedText = text;
+                    openingSent = true;
+                    contentUnavailable ||= Boolean(closing);
+                    // Zero is exhausted regardless of the platform's otherwise unspecified unit.
+                    exhausted = result.remain_msg_len === 0;
+                    return acknowledgement();
+                }
+                catch (error) {
+                    const result = qqDeliveryFailure(error);
+                    if (grant && result.diagnostic.platformCode !== undefined && QQ_PASSIVE_SOURCE_CODES.has(result.diagnostic.platformCode)) {
+                        ledger.exhaust('private', request.conversation.id, grant.source);
+                    }
+                    failure = result.failure;
+                    throw failure;
+                }
+            };
+            return {
+                write: text => completion
+                    ? Promise.reject(new EndpointDeliveryError('stream_closed', 'QQ stream is finishing', 'not_sent'))
+                    : send(text, false),
+                finish: text => completion ??= send(text, true),
+                cancel: () => { cancellation.abort(); },
+            };
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-qq",
-  "version": "1.1.19",
+  "version": "1.1.21",
   "description": "Zhin.js QQ Official adapter for Plugin Runtime (WebSocket gateway)",
   "type": "module",
   "main": "./lib/index.js",
@@ -34,27 +34,27 @@
   },
   "dependencies": {
     "qq-official-bot": "^1.3.3",
-    "@zhin.js/adapter": "1.1.26",
-    "@zhin.js/agent-feature": "1.1.11",
-    "@zhin.js/client": "1.1.22",
+    "@zhin.js/adapter": "1.1.27",
+    "@zhin.js/agent-feature": "1.1.12",
+    "@zhin.js/client": "1.1.23",
     "@zhin.js/console-contract": "1.1.3",
-    "@zhin.js/core": "1.1.54",
-    "@zhin.js/feature-kit": "1.1.10",
-    "@zhin.js/host-http": "1.1.12",
-    "@zhin.js/im-contract": "1.1.9",
+    "@zhin.js/core": "1.1.55",
+    "@zhin.js/feature-kit": "1.1.11",
+    "@zhin.js/host-http": "1.1.13",
+    "@zhin.js/im-contract": "1.1.10",
     "@zhin.js/logger": "1.1.2",
-    "@zhin.js/page": "1.1.11",
-    "@zhin.js/permission": "1.1.10",
-    "@zhin.js/skill": "1.1.11",
-    "@zhin.js/tool": "1.1.13"
+    "@zhin.js/page": "1.1.13",
+    "@zhin.js/permission": "1.1.11",
+    "@zhin.js/skill": "1.1.12",
+    "@zhin.js/tool": "1.1.14"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.26",
-    "@zhin.js/command": "^1.1.12",
-    "@zhin.js/core": "^1.1.54",
-    "@zhin.js/middleware": "^1.1.11",
-    "zhin.js": "^1.1.19"
+    "@zhin.js/adapter": "^1.1.27",
+    "@zhin.js/command": "^1.1.13",
+    "@zhin.js/core": "^1.1.55",
+    "@zhin.js/middleware": "^1.1.12",
+    "zhin.js": "^1.1.20"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -75,8 +75,8 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/host-http": "1.1.12",
-    "zhin.js": "1.1.19"
+    "@zhin.js/host-http": "1.1.13",
+    "zhin.js": "1.1.20"
   },
   "files": [
     "adapters",
@@ -109,7 +109,7 @@
     "features": [
       {
         "package": "@zhin.js/adapter",
-        "api": "^2.0.0"
+        "api": "^2.1.0"
       },
       {
         "package": "@zhin.js/command",
@@ -121,7 +121,7 @@
       },
       {
         "package": "@zhin.js/tool",
-        "api": "^1.0.0"
+        "api": "^1.1.0"
       },
       {
         "package": "@zhin.js/skill",

package/schema.json

@@ -284,6 +284,46 @@
               "endpoint",
               "id"
             ]
+          },
+          "streaming": {
+            "type": "boolean",
+            "description": "在支持的会话中渐进发送回复。设为 false 时仅发送完整回复。",
+            "x-i18n": {
+              "en": {
+                "description": "Publish supported replies while generating. Set false to send only complete replies."
+              }
+            }
+          },
+          "streamingIntervalMs": {
+            "type": "number",
+            "minimum": 0,
+            "description": "后续回复更新的最小间隔（毫秒）；首段立即发送。",
+            "x-i18n": {
+              "en": {
+                "description": "Minimum delay in milliseconds between reply updates; the first update is immediate."
+              }
+            }
+          },
+          "nickname": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "账号昵称兜底",
+            "x-i18n": {
+              "en": {
+                "description": "Fallback account nickname"
+              }
+            }
+          },
+          "profile": {
+            "$ref": "#/$defs/selfProfileFallback",
+            "description": "账号资料兜底",
+            "x-i18n": {
+              "en": {
+                "description": "Fallback account profile"
+              }
+            }
           }
         },
         "required": [
@@ -414,9 +454,114 @@
         "endpoint",
         "id"
       ]
+    },
+    "streaming": {
+      "type": "boolean",
+      "default": true,
+      "description": "在支持的会话中渐进发送回复。设为 false 时仅发送完整回复。",
+      "x-i18n": {
+        "en": {
+          "description": "Publish supported replies while generating. Set false to send only complete replies."
+        }
+      }
+    },
+    "streamingIntervalMs": {
+      "type": "number",
+      "minimum": 0,
+      "default": 500,
+      "description": "后续回复更新的最小间隔（毫秒）；首段立即发送。",
+      "x-i18n": {
+        "en": {
+          "description": "Minimum delay in milliseconds between reply updates; the first update is immediate."
+        }
+      }
+    },
+    "nickname": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "账号昵称兜底",
+      "x-i18n": {
+        "en": {
+          "description": "Fallback account nickname"
+        }
+      }
+    },
+    "profile": {
+      "$ref": "#/$defs/selfProfileFallback",
+      "description": "账号资料兜底",
+      "x-i18n": {
+        "en": {
+          "description": "Fallback account profile"
+        }
+      }
     }
   },
   "required": [
     "endpoints"
-  ]
+  ],
+  "$defs": {
+    "selfProfileFallback": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "gender": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "enum": [
+            "male",
+            "female",
+            "other",
+            "unknown",
+            null
+          ]
+        },
+        "age": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 0
+        },
+        "birthday": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$"
+        },
+        "signature": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "avatar": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "pattern": "^(https?://[^\\s/?#]+(?:[/?#].*)?|)$"
+        },
+        "interests": {
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {
+            "type": "string"
+          }
+        },
+        "bio": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      }
+    }
+  }
 }

package/src/adapter.ts

@@ -9,7 +9,7 @@ export class QqAdapter extends Adapter<QqHttpEndpoint | QqWebsocketEndpoint, QqE
   constructor(private readonly context: AdapterContext<QqEndpointConfig>) { super(); }
   override get configurationIdentityFields(): readonly string[] { return ['id', 'appid']; }
   override get configurationIdentityProbeFields(): readonly string[] { return ['accessTokenUrl', 'gatewayUrl']; }
-  override get configurationUpdateFields(): readonly string[] { return ['secret', 'mode', 'sandbox', 'intents', 'botKind',
+  override get configurationUpdateFields(): readonly string[] { return ['secret', 'mode', 'sandbox', 'streaming', 'streamingIntervalMs', 'intents', 'botKind',
     'accessTokenUrl', 'gatewayUrl', 'streamProxy', 'streamProxy.port', 'streamProxy.serverName', 'webhookPath']; }
   protected override validateConfiguration(input: QqEndpointConfig): void { resolveQqConfig(input); }
   protected createEndpoint(input: QqEndpointConfig, execution: EndpointCreationContext): QqHttpEndpoint | QqWebsocketEndpoint {

package/src/endpoint.ts

@@ -1,9 +1,11 @@
+import { createQqSelfProfile } from './self-profile.js';
 import { Bot, ReceiverMode } from 'qq-official-bot';
 import { installQqUploadDiagnostics } from './upload-diagnostics.js';
 import { projectQqGuildSenderRoles } from './platform-permit.js';
 import { qqDeliveryFailure } from './delivery-error.js';
 import { normalizeQqInteraction } from './interaction.js';
 import { awaitQqStartup } from './start-deadline.js';
+import { createQqStreaming } from './streaming.js';
 import { EndpointDeliveryError, type MessageRef } from '@zhin.js/im-contract';
 import {
   inspectQqGroupMember,
@@ -111,6 +113,8 @@ export class QqWebsocketEndpoint extends Bot<ReceiverMode.WEBSOCKET> implements
       start: signal => this.#startFramework(signal), open: () => this.#openFramework(), close: () => this.#closeFramework(),
       stop: () => this.#stopFramework(), send: request => this.#sendFramework(request), name: options.config.id,
       get transportState() { return endpoint.#transportState; }, management: this.#management, control: this.#control,
+      streaming: options.config.streaming !== false ? createQqStreaming(() => this.#requireBot(), this.#passiveReplies, options.config.streamingIntervalMs) : undefined,
+      profile: createQqSelfProfile({ client: this, reportAccount: id => this[endpointSpec].reportSelfUserId(id) }),
     });
     this.#bindBot(this);
   }
@@ -416,6 +420,8 @@ export class QqHttpEndpoint extends Bot<ReceiverMode.MIDDLEWARE, 'koa'> implemen
       stop: () => this.#stopFramework(), send: request => this.#sendFramework(request), name: options.config.id,
       get transportState() { return endpoint.#transportState; },
       management: this.#management, control: this.#control,
+      streaming: options.config.streaming !== false ? createQqStreaming(() => this.#requireBot(), this.#passiveReplies, options.config.streamingIntervalMs) : undefined,
+      profile: createQqSelfProfile({ client: this, reportAccount: id => this[endpointSpec].reportSelfUserId(id) }),
     });
     this.#bindBot(this);
   }

package/src/outbound.ts

@@ -302,70 +302,61 @@ export interface FormatOutboundMessagesOptions {
   readonly imageSizes?: ReadonlyMap<string, QqImageSize>;
 }
 
-function isElemOf(types: Set<string>) {
-  return (part: string | QqOutboundElem): part is QqOutboundElem => typeof part !== 'string' && types.has(part.type);
+function requireKeyboardMarkdown(messages: QqOutboundMessage[]): QqOutboundMessage[] {
+  if (!messages.length) throw new EndpointDeliveryError('unsupported_operation', 'QQ payload has no sendable content', 'not_sent');
+  for (const message of messages) {
+    const parts: readonly (string | QqOutboundElem)[] = Array.isArray(message) ? message : [message as string | QqOutboundElem];
+    if (parts.some(part => typeof part !== 'string' && (part.type === 'keyboard' || part.type === 'button'))
+      && !parts.some(part => typeof part !== 'string' && part.type === 'markdown')) {
+      throw new EndpointDeliveryError('unsupported_operation', 'QQ keyboard requires Markdown in the same physical message', 'not_sent');
+    }
+  }
+  return messages;
 }
 
 /**
- * 渲染后 payload → 按序发送的 QQ Sendable 列表。
- *
- * QQ 单条消息的 msg_type 只能是一种：富媒体（7，media.file_info）与 markdown/按钮（2）
- * 互斥，SDK 后处理的段会覆盖 msg_type，导致图片被静默丢弃。处理顺序：
- * 1. 公网 URL 图片且已知尺寸：按 QQ markdown 语法 `![图片 #宽px #高px](url)` 嵌入同一
- *    markdown 段（开放平台会下载转存），仍为一条消息；
- * 2. 其余媒体（base64 / 本地渲染图：v2 /files 上传只返回 file_info，拿不到 URL；或尺寸
- *    未知、模板 markdown 无法拼接）降级为独立富媒体消息先发，markdown + 按钮作为最后一条
- *    （返回其消息 ID）。reply 段随每条消息携带，保持被动回复。
- * 不含媒体与 markdown/按钮冲突时与 formatOutbound 一致（单条）。
+ * Preserve the original segment order before formatOutbound merges Markdown.
+ * Public images with known dimensions become inline Markdown at their original
+ * position. Other media form physical-message barriers; reply routing is copied
+ * to every resulting message, without moving text across a media barrier.
  */
 export function formatOutboundMessages(payload: unknown, options: FormatOutboundMessagesOptions = {}): QqOutboundMessage[] {
-  const body = formatOutbound(payload);
-  if (!Array.isArray(body)) return [body as QqOutboundMessage];
-  const elems = body as ReadonlyArray<string | QqOutboundElem>;
-  const isMedia = isElemOf(SPLIT_MEDIA_TYPES);
-  if (!elems.some(isMedia) || !elems.some(isElemOf(MARKDOWN_MESSAGE_TYPES))) return [body];
+  const items = toSegmentList(payload);
+  const rich = items.some(item => typeof item !== 'string' && MARKDOWN_MESSAGE_TYPES.has(item.type));
+  const media = items.some(item => typeof item !== 'string' && SPLIT_MEDIA_TYPES.has(item.type));
+  if (!rich || !media) return requireKeyboardMarkdown([formatOutbound(payload)]);
 
-  const markdownIndex = elems.findIndex(isElemOf(new Set(['markdown'])));
-  const markdownElem = markdownIndex >= 0 ? elems[markdownIndex] as QqOutboundElem : undefined;
-  const markdownContent = markdownElem ? markdownElem.data.content : '';
-  const embedded = new Set<QqOutboundElem>();
-  let merged: QqOutboundElem | undefined;
-  if (typeof markdownContent === 'string') {
-    const before: string[] = [];
-    const after: string[] = [];
-    elems.forEach((part, index) => {
-      if (!isMedia(part) || part.type !== 'image' || typeof part.data.url !== 'string') return;
-      const size = options.imageSizes?.get(part.data.url);
-      if (!size) return;
-      (markdownIndex < 0 || index < markdownIndex ? before : after)
-        .push(`![图片 #${size.width}px #${size.height}px](${part.data.url})`);
-      embedded.add(part);
-    });
-    if (embedded.size > 0) {
-      merged = { type: 'markdown', data: { content: [...before, markdownContent, ...after].filter((piece) => piece.trim()).join('\n\n') } };
-    }
-  }
-
-  const replies = elems.filter(isElemOf(new Set(['reply'])));
-  const separate: QqOutboundElem[] = [];
-  const rest: Array<string | QqOutboundElem> = [];
-  let mergedPlaced = false;
-  for (const part of elems) {
-    if (merged && (part === markdownElem || (!markdownElem && embedded.has(part as QqOutboundElem)))) {
-      if (!mergedPlaced) rest.push(merged);
-      mergedPlaced = true;
-    } else if (embedded.has(part as QqOutboundElem)) {
-      continue;
-    } else if (isMedia(part)) {
-      separate.push(part);
+  const replies = items.filter(item => typeof item !== 'string' && item.type === 'reply');
+  const templates = items.some(item => typeof item !== 'string' && item.type === 'markdown' && markdownTemplateId(item.data ?? {}));
+  const messages: QqOutboundMessage[] = [];
+  let pending: Array<string | QqWireSegment> = [];
+  const append = (items: Array<string | QqWireSegment>): void => {
+    const message = formatOutbound(items);
+    const parts = Array.isArray(message) ? message : [message];
+    if (parts.some(part => typeof part === 'string' ? part.length > 0 : part.type !== 'reply')) messages.push(message);
+  };
+  const flush = (): void => {
+    if (!pending.length) return;
+    append([...replies, ...pending]);
+    pending = [];
+  };
+  for (const item of items) {
+    if (typeof item !== 'string' && item.type === 'reply') continue;
+    if (typeof item !== 'string' && SPLIT_MEDIA_TYPES.has(item.type)) {
+      const source = item.type === 'image' && isMediaRef(item.data?.media) ? item.data.media : undefined;
+      const size = !templates && source?.kind === 'url' ? options.imageSizes?.get(source.value) : undefined;
+      if (source?.kind === 'url' && size) {
+        pending.push({ type: 'markdown', data: { content: `![图片 #${size.width}px #${size.height}px](${source.value})` } });
+      } else {
+        flush();
+        append([...replies, item]);
+      }
     } else {
-      rest.push(part);
+      pending.push(item);
     }
   }
-  return [
-    ...separate.map((item): QqOutboundMessage => (replies.length ? [...replies, item] : item)),
-    rest.length === 1 ? rest[0]! : rest,
-  ];
+  flush();
+  return requireKeyboardMarkdown(messages);
 }
 
 /**

package/src/passive-reply.ts

@@ -72,6 +72,18 @@ export class QqPassiveReplyLedger {
    * newest usable source in the conversation. Undefined when only an active message is possible.
    */
   acquire(kind: QqOutboundKind, conversationId: string, preferred?: QqReplySource): PassiveReplyGrant | undefined {
+    const entry = this.#usableSource(kind, conversationId, preferred);
+    if (!entry) return undefined;
+    entry.replies += 1;
+    return { source: entry.source, msgSeq: entry.replies };
+  }
+
+  /** Local stream preflight must not reserve a reply before any content exists. */
+  hasUsableSource(kind: QqOutboundKind, conversationId: string, preferred?: QqReplySource): boolean {
+    return this.#usableSource(kind, conversationId, preferred) !== undefined;
+  }
+
+  #usableSource(kind: QqOutboundKind, conversationId: string, preferred?: QqReplySource): SourceEntry | undefined {
     const limit = QQ_PASSIVE_LIMITS[kind];
     const now = this.now();
     const entries = this.#conversations.get(`${kind}:${conversationId}`) ?? [];
@@ -79,11 +91,8 @@ export class QqPassiveReplyLedger {
       && entry.replies < limit.maxReplies
       && now - entry.receivedAt < limit.windowMs - SAFETY_MARGIN_MS;
     const preferredKey = preferred ? sourceKey(preferred) : undefined;
-    const entry = (preferredKey ? entries.find(item => sourceKey(item.source) === preferredKey && usable(item)) : undefined)
+    return (preferredKey ? entries.find(item => sourceKey(item.source) === preferredKey && usable(item)) : undefined)
       ?? [...entries].reverse().find(usable);
-    if (!entry) return undefined;
-    entry.replies += 1;
-    return { source: entry.source, msgSeq: entry.replies };
   }
 
   /** The platform said this source can no longer be replied to (expired, over the limit, invalid id). */