@qmuse/qmuse-cli 1.0.9 → 1.0.10-dev.1

package/dist/app/chat.js

@@ -0,0 +1,291 @@
+/**
+ * 对话域（C05）与模型列表：基于 musepub 预发已上线路由。
+ *
+ *  - POST /api/chat（mode=continue）已有应用继续对话，复用统一入口与首轮流协议
+ *  - POST /api/code/queryChatByAppIdAndSprintId 会话与会话历史
+ *  - POST /api/code/getChatState 会话状态与阶段
+ *  - POST /api/code/chat/cancel 显式停止当前任务
+ *  - POST /api/code/clearChatContext 清理会话上下文
+ *  - GET  /api/model/list 可选模型列表
+ */
+import { apiCall, authHeaders, buildUrl, requestSourceHeaders } from '../client.js';
+import { chatEventType, parseChatEvent, SseParser } from './sse.js';
+export function queryChatByAppIdAndSprintId(appId, sprintId, cfg) {
+    return apiCall('POST', '/api/code/queryChatByAppIdAndSprintId', { appId, sprintId }, cfg);
+}
+export function getChatState(chatId, cfg) {
+    return apiCall('POST', '/api/code/getChatState', { chatId }, cfg);
+}
+export function cancelChat(appId, chatId, cfg) {
+    return apiCall('POST', '/api/code/chat/cancel', { appId, chatId }, cfg);
+}
+export function clearChatContext(appId, chatId, sprintId, cfg) {
+    return apiCall('POST', '/api/code/clearChatContext', { appId, chatId, sprintId }, cfg);
+}
+export function listModels(cfg) {
+    return apiCall('GET', '/api/model/list', undefined, cfg);
+}
+/**
+ * 消息附件上传（C05.12）：POST /api/file/upload（multipart 流）。
+ * 服务端契约校验 appId+versionId 的版本写权限；返回上传产物信息。
+ */
+export async function uploadAttachment(cfg, filePath, versionId, appId) {
+    const { basename } = await import('node:path');
+    const form = new FormData();
+    const stat = await import('node:fs/promises');
+    const bytes = await stat.readFile(filePath);
+    form.append('file', new Blob([new Uint8Array(bytes)]), basename(filePath));
+    form.append('appId', appId);
+    form.append('versionId', versionId);
+    const headers = { ...authHeadersOf(cfg) };
+    delete headers['Content-Type'];
+    let res;
+    try {
+        res = await fetch(buildUrlOf(cfg, '/api/file/upload'), {
+            method: 'POST',
+            headers,
+            body: form,
+        });
+    }
+    catch (err) {
+        return {
+            ok: false,
+            status: 0,
+            raw: null,
+            setCookie: [],
+            errorCode: 'NETWORK_ERROR',
+            errorMessage: `上传失败: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    const text = await res.text().catch(() => '');
+    let json = null;
+    try {
+        json = text ? JSON.parse(text) : null;
+    }
+    catch {
+        json = null;
+    }
+    const payload = json && typeof json === 'object' && !Array.isArray(json)
+        ? json
+        : undefined;
+    const data = payload?.data ?? payload?.resultObj;
+    return {
+        ok: payload?.success === true,
+        data: data,
+        errorCode: typeof payload?.errorCode === 'string' ? payload.errorCode : undefined,
+        errorMessage: typeof payload?.errorMessage === 'string' ? payload.errorMessage : undefined,
+        raw: json,
+        status: res.status,
+        setCookie: [],
+    };
+}
+export async function continueChat(cfg, request, opts = {}) {
+    const chatId = typeof request.chatId === 'string' ? request.chatId : '';
+    const result = {
+        status: 'FAILED',
+        chatId,
+        toolConsumed: false,
+        eventCount: 0,
+    };
+    const headers = {
+        ...(authHeadersOf(cfg)),
+        Accept: 'text/event-stream',
+        'Cache-Control': 'no-cache',
+    };
+    let res;
+    try {
+        res = await fetch(buildUrlOf(cfg, '/api/chat'), {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({ mode: 'continue', request }),
+            signal: opts.signal,
+        });
+    }
+    catch (err) {
+        if (opts.signal?.aborted)
+            return { ...result, status: 'INTERRUPTED' };
+        return { ...result, errorText: `请求失败: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        result.errorText = summarizeJsonError(text) ?? `HTTP ${res.status}`;
+        return result;
+    }
+    return await readChatStream(res, result, opts);
+}
+// ---------- 低层共享工具 ----------
+function authHeadersOf(cfg) {
+    return { ...authHeaders(cfg), ...requestSourceHeaders(cfg) };
+}
+function buildUrlOf(cfg, path) {
+    return buildUrl(cfg, path);
+}
+export function summarizeJsonError(text) {
+    try {
+        const parsed = text ? JSON.parse(text) : null;
+        const payload = (parsed && typeof parsed === 'object')
+            ? parsed
+            : undefined;
+        const message = payload?.errorMessage ?? payload?.message;
+        if (typeof message === 'string' && message.trim())
+            return message;
+    }
+    catch {
+        /* 非 JSON 响应按原文截断 */
+    }
+    return text && text.trim() ? text.trim().slice(0, 200) : undefined;
+}
+async function readChatStream(res, result, opts) {
+    const reader = res.body?.getReader?.();
+    if (!reader)
+        return { ...result, errorText: result.errorText ?? '响应没有可读生成流' };
+    const decoder = new TextDecoder();
+    let terminal;
+    let errorText;
+    let sawInterrupt = false;
+    const parser = new SseParser(frame => {
+        if (frame.data === null)
+            return true;
+        const payload = parseChatEvent(frame.data);
+        const type = chatEventType(payload);
+        opts.onEvent?.({ sequence: ++result.eventCount, type, payload });
+        if (type === 'finish') {
+            terminal = 'SUCCEEDED';
+            return true;
+        }
+        if (type === 'error' || type === 'llm-error' || type === 'data-llm-error') {
+            terminal = 'FAILED';
+            errorText = extractStreamError(payload, type);
+            return true;
+        }
+        if (typeof payload === 'object') {
+            const record = payload;
+            if (type === 'tool-input-start' || type === 'tool-input-end')
+                result.toolConsumed = true;
+            const interrupts = record.interrupts
+                ?? record.data?.interrupts;
+            if (Array.isArray(interrupts) && interrupts.length > 0)
+                sawInterrupt = true;
+        }
+        return false;
+    });
+    try {
+        let stopped = false;
+        while (!stopped) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            stopped = parser.push(decoder.decode(value, { stream: true }));
+        }
+        if (!stopped)
+            parser.end();
+        const status = terminal ?? (sawInterrupt ? 'WAITING_INPUT' : undefined);
+        return {
+            ...result,
+            status: status ?? 'FAILED',
+            errorText: errorText ?? (!terminal && !sawInterrupt ? '生成流在完成事件前结束' : undefined),
+        };
+    }
+    catch (err) {
+        if (opts.signal?.aborted)
+            return { ...result, status: 'INTERRUPTED', toolConsumed: result.toolConsumed };
+        return {
+            ...result,
+            status: terminal ?? 'FAILED',
+            errorText: errorText ?? `读取生成流失败: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    finally {
+        reader.cancel().catch(() => undefined);
+    }
+}
+function extractStreamError(payload, type) {
+    if (typeof payload === 'string' && payload.trim())
+        return payload;
+    if (typeof payload !== 'object')
+        return `生成失败（${type || '未知'}）`;
+    const data = payload.data;
+    const candidates = [
+        payload.errorText,
+        payload.errorMessage,
+        payload.message,
+        data && typeof data === 'object' ? data.errorText : undefined,
+    ];
+    for (const candidate of candidates) {
+        if (typeof candidate === 'string' && candidate.trim())
+            return candidate;
+    }
+    return type ? `生成失败（${type}）` : '生成失败';
+}
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/**
+ * 从 getChatState 现有响应归纳待恢复中断（同 id 去重）；纯展示层，不改服务端契约。
+ * 表单类给出问题/选项与 answers 结构提示；bash 拦截类给出 continue/skip 决定结构。
+ */
+export function summarizePendingInterrupts(data, chatId) {
+    const interrupts = isRecord(data) && Array.isArray(data['interrupts']) ? data['interrupts'] : [];
+    const seen = new Set();
+    const views = [];
+    for (const item of interrupts) {
+        if (!isRecord(item))
+            continue;
+        const interruptId = typeof item['id'] === 'string' ? item['id'] : '';
+        if (!interruptId || seen.has(interruptId))
+            continue;
+        seen.add(interruptId);
+        const value = isRecord(item['value']) ? item['value'] : {};
+        const resumeCommand = `qmuse chat resume ${chatId} --interrupt-id ${interruptId} --file <answer.json>`;
+        if (typeof value['formId'] === 'string' || Array.isArray(value['fields'])) {
+            const fields = Array.isArray(value['fields']) ? value['fields'] : [];
+            const questions = [];
+            for (const field of fields) {
+                if (!isRecord(field) || typeof field['id'] !== 'string')
+                    continue;
+                const optionList = Array.isArray(field['options'])
+                    ? field['options']
+                        .map(option => isRecord(option) && typeof option['label'] === 'string' ? option['label'] : '')
+                        .filter(Boolean)
+                        .slice(0, 5)
+                    : undefined;
+                questions.push({
+                    questionId: field['id'],
+                    label: typeof field['label'] === 'string' ? field['label'] : field['id'],
+                    ...(typeof field['control'] === 'string' ? { control: field['control'] } : {}),
+                    ...(field['required'] === true ? { required: true } : {}),
+                    ...(optionList && optionList.length > 0 ? { options: optionList } : {}),
+                });
+            }
+            views.push({
+                interruptId,
+                kind: 'form',
+                label: typeof value['title'] === 'string' ? value['title'] : '待确认问题',
+                questions,
+                answerHint: '{"response":{"answers":[{"questionId":"<问题ID>","selectedOptionIds":["<选项value>"]}]}}',
+                resumeCommand,
+            });
+            continue;
+        }
+        const payload = isRecord(value['payload']) ? value['payload'] : {};
+        if (value['type'] === 'bash-command-interception' || typeof value['interceptionId'] === 'string') {
+            const interceptionId = typeof value['interceptionId'] === 'string' ? value['interceptionId'] : '<interceptionId>';
+            views.push({
+                interruptId,
+                kind: 'bash-interception',
+                label: `${typeof payload['command'] === 'string' ? payload['command'] : String(value['interceptorId'] ?? '命令拦截')}${typeof payload['message'] === 'string' ? `：${payload['message']}` : ''}`,
+                questions: [],
+                answerHint: `{"response":{"type":"bash-command-interception","interceptionId":"${interceptionId}","data":{"action":"continue"}}}（跳过则 action=skip）`,
+                resumeCommand,
+            });
+            continue;
+        }
+        views.push({
+            interruptId,
+            kind: 'unknown',
+            label: '未识别的中断类型（原始结构见 --json）',
+            questions: [],
+            answerHint: '按服务端中断结构构造 response 后提交',
+            resumeCommand,
+        });
+    }
+    return views;
+}

package/dist/app/cloud.js

@@ -0,0 +1,28 @@
+/**
+ * 云服务域（C14）：云服务开通、多环境状态与 local-dev 公开配置。
+ * POST /api/appwrite/cloud/storage/enable —— 开通实际云服务（AppwriteStorageActivationService）
+ * POST /api/appwrite/environment/status —— 集中查询架构/环境/初始化状态（AppwriteMultiEnvironmentService）
+ * POST /api/appwrite/environment/retry-initialization —— 复用原初始化任务的动作（分布式锁幂等）
+ * POST /api/appwrite/local-dev context   —— 导出实际环境的公开连接与运行配置（不含管理凭证）
+ */
+import { apiCall } from '../client.js';
+/** C14.02 实际开通云服务：返回真实资源与初始化状态。 */
+export function enableCloudService(appId, cfg) {
+    return apiCall('POST', '/api/appwrite/cloud/storage/enable', { appId }, cfg);
+}
+/** C14.03 查询云服务与环境状态（activationStatus、publishAllowed、失败原因等）。 */
+export function cloudEnvironmentStatus(appId, cfg) {
+    return apiCall('POST', '/api/appwrite/environment/status', { appId }, cfg);
+}
+/** C14.08 重试云环境初始化：服务端幂等且受分布式锁保护，返回 INITIALIZING 心跳。 */
+export function retryCloudEnvironment(appId, cfg) {
+    return apiCall('POST', '/api/appwrite/environment/retry-initialization', { appId }, cfg);
+}
+/** C14.09 导出安全公开配置：local-dev 上下文（endpoint/projectId/functionId/databaseId/domain）。 */
+export function localDevContext(appId, cfg) {
+    return apiCall('POST', '/api/appwrite/local-dev/context', { appId }, cfg);
+}
+/** C29.01 数据库用量摘要：按应用返回 database overview（表数量/文档数等现有状态）。 */
+export function databaseOverview(appId, cfg) {
+    return apiCall('POST', '/api/appwrite/usage/database-overview', { appId }, cfg);
+}

package/dist/app/create.js

@@ -0,0 +1,358 @@
+/**
+ * 统一创建与首轮对话（POST /api/chat，mode=create）。
+ *
+ * 契约要点：
+ *  - 请求体：{ mode:"create", requestId, create, message, settings? }，create 不含 firstMessage，
+ *    首条输入只放 message.content；requestId 形如 `cc_<13位毫秒时间戳>_<32位小写十六进制>`，
+ *    是业务去重键：同 requestId 恢复身份，不重复创建。
+ *  - 创建成功先 flush 身份响应头 x-qmuse-app-id / x-qmuse-chat-id / x-qmuse-sprint-id /
+ *    x-qmuse-chat-reused，随后同一次响应内透传领域聊天 SSE；HTTP 200 不代表生成完成。
+ *  - reused=true 时响应体是 JSON 身份（CommonHttpResult 包装），沿用已有会话，不启动新一轮生成。
+ *  - 生成失败保留已创建应用；断开本地流不会取消服务端任务。
+ */
+import { randomBytes, createHash } from 'node:crypto';
+import { authHeaders, buildUrl, requestSourceHeaders } from '../client.js';
+import { chatEventType, parseChatEvent, SseParser, } from './sse.js';
+/** 服务端 requestId 校验规则（CreateChatSchema）。 */
+export const CREATE_REQUEST_ID_PATTERN = /^cc_[0-9]{13}_[a-f0-9]{32}$/u;
+/** message.content 上限（服务端 Schema）。 */
+export const CHAT_CONTENT_MAX_LENGTH = 100000;
+/** CLI 应用类型到统一创建 appType 的映射（首期范围：web / h5）。 */
+export const UNIFIED_APP_TYPE_BY_CLI_TYPE = {
+    web: 'GENERAL',
+    webapp: 'GENERAL',
+    h5: 'MOBILE',
+    mobile: 'MOBILE',
+    ai: 'AI_APP',
+};
+/** CLI 类型映射为服务端 appType；未知类型返回带用法的错误。 */
+export function normalizeAppType(cliType) {
+    const value = (cliType || '').trim().toLowerCase();
+    const mapped = UNIFIED_APP_TYPE_BY_CLI_TYPE[value];
+    if (!mapped) {
+        throw new Error(`--type 仅支持 web / h5 / ai（${String(cliType ?? '(空)')} 不是可创建类型）`);
+    }
+    return mapped;
+}
+/** 生成服务端可校验的创建请求 ID。 */
+export function generateCreateRequestId() {
+    return `cc_${Date.now()}_${randomBytes(16).toString('hex')}`;
+}
+/**
+ * 首条用户消息的稳定 ID：同一 requestId 与内容的恢复请求使用相同 messageId，
+ * 保证重发的 `message` 与首次受理一致。
+ */
+export function stableMessageId(requestId, content) {
+    const digest = createHash('sha256').update(`${requestId}\n${content}`, 'utf8').digest('hex');
+    return `cm_${digest.slice(0, 32)}`;
+}
+/** 从已受理或新发起的请求中构造统一创建请求体。 */
+export function buildCreateChatRequest(input) {
+    const content = input.content;
+    if (!content.trim())
+        throw new Error('首条创作内容不能为空（--file <路径> 或 - 读取 stdin）');
+    if (content.length > CHAT_CONTENT_MAX_LENGTH) {
+        throw new Error(`首条创作内容超过 ${CHAT_CONTENT_MAX_LENGTH} 字符上限`);
+    }
+    const requestId = input.requestId?.trim() || generateCreateRequestId();
+    if (!CREATE_REQUEST_ID_PATTERN.test(requestId)) {
+        throw new Error('--request-id 需匹配 cc_<13位毫秒时间戳>_<32位小写十六进制>，例如 cc_1762060000000_<32位hex>');
+    }
+    const title = input.title.trim();
+    if (!title)
+        throw new Error('应用标题不能为空（--title 或从内容首行推导）');
+    if (!input.spaceId?.trim())
+        throw new Error('缺少目标空间：先执行 qmuse space use <spaceId> 或传 --space-id');
+    const messageId = stableMessageId(requestId, content);
+    const create = {
+        spaceId: input.spaceId.trim(),
+        appType: input.appType,
+        title,
+        // 预发 AppCoreService.createAppMeta 要求 selectedModel 必填（MODEL_REQUIRED）；
+        // 'auto' 是服务端一等合法值，--model 可覆盖。
+        selectedModel: input.selectedModel?.trim() || 'auto',
+    };
+    for (const key of [
+        'defaultDevice',
+        'width',
+        'height',
+        'promotionMode',
+        'publishType',
+        'sourceType',
+    ]) {
+        const value = input[key];
+        if (typeof value === 'string' && value.trim())
+            create[key] = value.trim();
+    }
+    return {
+        requestId,
+        messageId,
+        body: {
+            mode: 'create',
+            requestId,
+            create,
+            message: { id: messageId, role: 'user', content },
+        },
+    };
+}
+/** 提取身份与错误信息时 tolerated 的响应包装。 */
+function unwrapCommonResult(json) {
+    if (json && typeof json === 'object' && !Array.isArray(json)) {
+        const record = json;
+        const payload = record.data ?? record.resultObj;
+        if (payload && typeof payload === 'object' && !Array.isArray(payload)) {
+            return payload;
+        }
+        return record;
+    }
+    return undefined;
+}
+function readIdentityFromPayload(payload) {
+    const pick = (key) => {
+        const value = payload?.[key];
+        return typeof value === 'string' ? value : '';
+    };
+    return { appId: pick('appId'), chatId: pick('chatId'), sprintId: pick('sprintId') };
+}
+function extractErrorText(payload, type) {
+    if (typeof payload === 'string' && payload.trim())
+        return payload;
+    if (typeof payload !== 'object')
+        return `首轮生成失败（${type || '未知事件'}）`;
+    const data = payload.data;
+    const candidates = [
+        payload.errorText,
+        payload.errorMessage,
+        payload.message,
+        data && typeof data === 'object' ? data.errorText : undefined,
+        data && typeof data === 'object' ? data.message : undefined,
+    ];
+    for (const candidate of candidates) {
+        if (typeof candidate === 'string' && candidate.trim())
+            return candidate;
+    }
+    return type ? `首轮生成失败（${type}）` : '首轮生成失败';
+}
+function extractInterrupts(payload) {
+    if (typeof payload !== 'object')
+        return false;
+    const data = payload.data;
+    const candidates = [
+        payload.interrupts,
+        data && typeof data === 'object' ? data.interrupts : undefined,
+    ];
+    return candidates.some(candidate => Array.isArray(candidate) && candidate.length > 0);
+}
+/**
+ * 执行统一创建：一次请求完成应用创建并消费首轮 SSE。
+ * 返回终态结果；不影响服务端任务（本地中断仅结束读取）。
+ */
+export async function createAppChat(cfg, input, opts = {}) {
+    const { requestId, messageId, body } = buildCreateChatRequest(input);
+    const base = {
+        status: 'FAILED',
+        requestId,
+        messageId,
+        reused: false,
+        httpStatus: 0,
+        interrupted: false,
+        identity: { appId: '', chatId: '', sprintId: '' },
+        textChars: 0,
+        eventCount: 0,
+    };
+    const headers = {
+        ...authHeaders(cfg),
+        ...requestSourceHeaders(cfg),
+        Accept: 'text/event-stream',
+        'Cache-Control': 'no-cache',
+    };
+    let res;
+    try {
+        res = await fetch(buildUrl(cfg, '/api/chat'), {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+            signal: opts.signal,
+        });
+    }
+    catch (err) {
+        const interrupted = opts.signal?.aborted === true;
+        return {
+            ...base,
+            status: interrupted ? 'INTERRUPTED' : 'FAILED',
+            interrupted,
+            errorCode: interrupted ? undefined : 'NETWORK_ERROR',
+            errorMessage: interrupted
+                ? undefined
+                : `请求失败 ${buildUrl(cfg, '/api/chat')}: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    const headerIdentity = {
+        appId: res.headers.get('x-qmuse-app-id') ?? '',
+        chatId: res.headers.get('x-qmuse-chat-id') ?? '',
+        sprintId: res.headers.get('x-qmuse-sprint-id') ?? '',
+    };
+    const reusedHeader = (res.headers.get('x-qmuse-chat-reused') ?? '').trim().toLowerCase();
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        let parsed;
+        try {
+            parsed = text ? JSON.parse(text) : null;
+        }
+        catch {
+            parsed = null;
+        }
+        const payload = unwrapCommonResult(parsed);
+        return {
+            ...base,
+            httpStatus: res.status,
+            identity: headerIdentity,
+            errorText: typeof payload?.errorMessage === 'string' ? payload.errorMessage : undefined,
+            errorCode: typeof payload?.errorCode === 'string' ? payload.errorCode : undefined,
+            traceId: typeof payload?.traceId === 'string' ? payload.traceId : undefined,
+            errorMessage: `创建请求被拒绝：HTTP ${res.status}${payload?.errorMessage ? `，${payload.errorMessage}` : ''}`,
+        };
+    }
+    if (reusedHeader === 'true') {
+        const text = await res.text().catch(() => '');
+        let parsed;
+        try {
+            parsed = text ? JSON.parse(text) : null;
+        }
+        catch {
+            parsed = null;
+        }
+        const payload = unwrapCommonResult(parsed);
+        const identity = readIdentityFromPayload(payload);
+        const merged = {
+            appId: headerIdentity.appId || identity.appId,
+            chatId: headerIdentity.chatId || identity.chatId,
+            sprintId: headerIdentity.sprintId || identity.sprintId,
+        };
+        if (!merged.appId) {
+            return {
+                ...base,
+                httpStatus: res.status,
+                reused: true,
+                errorText: '已受理请求恢复成功，但响应未返回应用身份',
+            };
+        }
+        return {
+            ...base,
+            status: 'REUSED',
+            httpStatus: res.status,
+            reused: true,
+            identity: merged,
+            created: payload,
+        };
+    }
+    if (!headerIdentity.appId) {
+        const text = await res.text().catch(() => '').then(t => t.slice(0, 200));
+        return {
+            ...base,
+            httpStatus: res.status,
+            errorText: '创建请求未返回 x-qmuse-app-id 身份响应头',
+            errorMessage: text ? `响应片段：${text}` : undefined,
+        };
+    }
+    // 消费同一次响应内的首轮 SSE；终态帧出现后主动停止读取。
+    return new Promise(resolve => {
+        const identity = { ...headerIdentity };
+        let terminal;
+        let errorText;
+        let versionId;
+        let sawInterrupt = false;
+        let sequence = 0;
+        const decoder = new TextDecoder();
+        const dispatch = (payload) => {
+            sequence += 1;
+            const type = chatEventType(payload);
+            opts.onEvent?.({ sequence, type, payload });
+            if (type === 'finish') {
+                terminal = 'SUCCEEDED';
+                return true;
+            }
+            if (type === 'error' || type === 'llm-error' || type === 'data-llm-error') {
+                terminal = 'FAILED';
+                errorText = extractErrorText(payload, type);
+                return true;
+            }
+            if (typeof payload === 'object') {
+                if (type === 'version-saved' && typeof payload.versionId === 'string') {
+                    versionId = payload.versionId;
+                }
+                if (extractInterrupts(payload))
+                    sawInterrupt = true;
+                if (type === 'text-delta' || type === 'text') {
+                    const delta = payload.delta ?? payload.text;
+                    if (typeof delta === 'string')
+                        base.textChars += delta.length;
+                }
+            }
+            return false;
+        };
+        const parser = new SseParser(frame => {
+            if (frame.data === null) {
+                // data: [DONE] —— 服务端收尾标记；终态以已收到的 finish/error 为准。
+                return true;
+            }
+            return dispatch(parseChatEvent(frame.data));
+        });
+        const finish = (status, extra) => {
+            resolve({
+                ...base,
+                status,
+                httpStatus: res.status,
+                identity,
+                ...(versionId ? { versionId } : {}),
+                eventCount: sequence,
+                ...(errorText ? { errorText } : {}),
+                ...extra,
+            });
+        };
+        const consume = async () => {
+            const reader = res.body?.getReader?.();
+            try {
+                if (!reader) {
+                    finish(terminal ?? 'FAILED', {
+                        errorText: errorText ?? '创建响应没有可读的生成流',
+                    });
+                    return;
+                }
+                let stopped = false;
+                while (!stopped) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    const text = decoder.decode(value, { stream: true });
+                    stopped = parser.push(text);
+                }
+                if (!stopped) {
+                    parser.end();
+                    decoder.decode();
+                }
+                const status = terminal
+                    ?? (sawInterrupt ? 'WAITING_INPUT' : undefined);
+                finish(status ?? 'FAILED', !terminal && !sawInterrupt
+                    ? { errorText: errorText ?? '首轮生成流在完成事件前结束' }
+                    : undefined);
+            }
+            catch (err) {
+                if (opts.signal?.aborted) {
+                    finish('INTERRUPTED', { interrupted: true });
+                    return;
+                }
+                const message = err instanceof Error ? err.message : String(err);
+                finish(terminal ?? 'FAILED', {
+                    errorText: errorText ?? `读取生成流失败：${message}`,
+                    interrupted: false,
+                });
+            }
+            finally {
+                // 终态后停读；服务端会继续收尾，不受客户端断开影响。
+                reader?.cancel().catch(() => undefined);
+            }
+        };
+        void consume();
+    });
+}