helixlife-expert-cli 0.1.0

package/cli/dist/core/output/index.js

@@ -0,0 +1,153 @@
+// Commander --format 选项归一化（仅 json 走 JSON 模式，其余均视为 markdown）
+export function parseOutputFormat(raw) {
+    return raw === "json" ? "json" : "markdown";
+}
+// 创建写入 stderr 的进度心跳上报器
+//
+// 背景：JSON 模式下 stdout 只在最后一次性输出结果，生成期间若无任何信号，
+// 上游 Agent/管道无法区分「仍在生成」与「卡死/已结束」；若 stdout 被重定向到文件，
+// 观察方更是完全看不到进度。因此进度统一走 stderr，并用墙钟定时器兜底，
+// 即便服务端长时间静默也能持续输出「仍在运行」的心跳。
+export function createStderrProgress(enabled, intervalMs = 3000) {
+    let startedAt = 0;
+    let received = 0;
+    let timer;
+    const clearTimer = () => {
+        if (timer) {
+            clearInterval(timer);
+            timer = undefined;
+        }
+    };
+    const elapsedSeconds = () => ((Date.now() - startedAt) / 1000).toFixed(0);
+    return {
+        start(message) {
+            if (!enabled) {
+                return;
+            }
+            startedAt = Date.now();
+            received = 0;
+            process.stderr.write(`${message}\n`);
+            timer = setInterval(() => {
+                process.stderr.write(`... 生成中：已用 ${elapsedSeconds()}s，已接收 ${received} 字\n`);
+            }, intervalMs);
+            // 心跳定时器不应阻止进程在主逻辑结束后退出
+            if (timer && typeof timer.unref === "function") {
+                timer.unref();
+            }
+        },
+        update(receivedChars) {
+            received = receivedChars;
+        },
+        finish(message) {
+            if (!enabled) {
+                return;
+            }
+            clearTimer();
+            process.stderr.write(`${message}（耗时 ${((Date.now() - startedAt) / 1000).toFixed(1)}s）\n`);
+        },
+        dispose() {
+            clearTimer();
+        },
+    };
+}
+// 转义 Markdown 表格单元格：竖线转义、换行折叠为空格，避免破坏表格结构
+function escapeTableCell(value) {
+    return String(value ?? "")
+        .replace(/\|/g, "\\|")
+        .replace(/\r?\n|\u2028|\u2029/g, " ");
+}
+// 将列表数据渲染为 Markdown 表格，便于 Agent 直接展示
+export function renderListAsMarkdown(rows, columns) {
+    if (rows.length === 0) {
+        return "_暂无数据_";
+    }
+    const header = `| ${columns.map((c) => escapeTableCell(c.label)).join(" | ")} |`;
+    const separator = `| ${columns.map(() => "---").join(" | ")} |`;
+    const body = rows
+        .map((row) => {
+        const cells = columns.map((c) => escapeTableCell(row[c.key]));
+        return `| ${cells.join(" | ")} |`;
+    })
+        .join("\n");
+    return `${header}\n${separator}\n${body}`;
+}
+/** HTML 文本转义（保留后续主动插入的 <br>） */
+function escapeHtmlText(value) {
+    return value
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+/**
+ * 将单元格内换行（\n / U+2028 等）转为 <br>，并对纯文本做 HTML 转义。
+ * 用于需要「同一单元格内上下堆叠」的场景（Markdown 管道表会剥掉 <br>）。
+ */
+function formatHtmlTableCell(value) {
+    return String(value ?? "")
+        .split(/\r?\n|\u2028|\u2029/)
+        .map((part) => escapeHtmlText(part))
+        .join("<br>");
+}
+/**
+ * 将列表渲染为 HTML 表格；单元格内换行会变成 <br>，供聊天端真实换行展示。
+ */
+export function renderListAsHtmlTable(rows, columns) {
+    if (rows.length === 0) {
+        return "<p><em>暂无数据</em></p>";
+    }
+    const thead = `<tr>${columns
+        .map((column) => `<th>${escapeHtmlText(column.label)}</th>`)
+        .join("")}</tr>`;
+    const tbody = rows
+        .map((row) => {
+        const cells = columns
+            .map((column) => `<td>${formatHtmlTableCell(row[column.key])}</td>`)
+            .join("");
+        return `<tr>${cells}</tr>`;
+    })
+        .join("\n");
+    return `<table>\n<thead>\n${thead}\n</thead>\n<tbody>\n${tbody}\n</tbody>\n</table>`;
+}
+/**
+ * 将非 ASCII 字符转为 \\uXXXX，保证 JSON stdout 在 Windows GBK 管道下不被误解码。
+ * 宿主（PowerShell / GB2312 控制台）按字节流捕获时，原始中文 UTF-8 会被读成「乳腺�?」类乱码。
+ */
+export function stringifyJsonAscii(data) {
+    return JSON.stringify(data, null, 2).replace(/[-￿]/g, (ch) => "\\u" + ch.charCodeAt(0).toString(16).padStart(4, "0"));
+}
+/** 向 stdout 写入 UTF-8 文本（避免 console 走系统代码页） */
+function writeStdoutUtf8(text) {
+    process.stdout.write(Buffer.from(text.endsWith("\n") ? text : `${text}\n`, "utf8"));
+}
+// 以缩进 JSON 输出到 stdout，供命令层统一机器可读输出，便于宿主 Agent 解析
+export function emitJson(data) {
+    writeStdoutUtf8(stringifyJsonAscii(data));
+}
+// 按指定格式输出命令结果到 stdout
+export function printOutput(data, format) {
+    if (format === "json") {
+        writeStdoutUtf8(stringifyJsonAscii(data));
+        return;
+    }
+    if (Array.isArray(data) && data.length > 0 && typeof data[0] === "object" && data[0] !== null) {
+        const keys = Object.keys(data[0]);
+        const columns = keys.map((key) => ({ key, label: key }));
+        writeStdoutUtf8(renderListAsMarkdown(data, columns));
+        return;
+    }
+    writeStdoutUtf8(String(data));
+}
+// 创建格式化的日志输出函数
+// JSON 模式下所有状态文本走 stderr，避免污染 stdout（最终 JSON 结果走 printOutput）
+export function createFormatLogger(format) {
+    return (message) => {
+        if (format === "json") {
+            process.stderr.write(message + "\n");
+        }
+        else {
+            console.log(message);
+        }
+    };
+}
+//# sourceMappingURL=index.js.map

package/cli/dist/core/output/index.js.map

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

package/cli/dist/core/parse.d.ts

@@ -0,0 +1,9 @@
+export declare function parseIntegerOption(raw: string | number | undefined, name: string, options?: {
+    min?: number;
+    max?: number;
+}): number;
+export declare function parseEnumOption<T extends string>(raw: string | undefined, candidates: readonly T[], options: {
+    label: string;
+    defaultValue?: T;
+}): T;
+//# sourceMappingURL=parse.d.ts.map

package/cli/dist/core/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/core/parse.ts"],"names":[],"mappings":"AAGA,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EAChC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3C,MAAM,CA+BR;AAID,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAC9C,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,UAAU,EAAE,SAAS,CAAC,EAAE,EACxB,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,CAAC,CAAA;CAAE,GAC3C,CAAC,CAYH"}

package/cli/dist/core/parse.js

@@ -0,0 +1,31 @@
+import { helixlifeError, helixlifeErrorCode } from "./errors.js";
+// 整数参数校验：拒绝 NaN / 小数 / 越界，避免非法值透传到业务层导致崩溃
+export function parseIntegerOption(raw, name, options = {}) {
+    if (raw === undefined || raw === null || raw === "") {
+        throw new helixlifeError(helixlifeErrorCode.INVALID_ARGUMENT, `缺少参数 ${name}`);
+    }
+    const value = Number(raw);
+    if (!Number.isFinite(value) || !Number.isInteger(value)) {
+        throw new helixlifeError(helixlifeErrorCode.INVALID_ARGUMENT, `参数 ${name} 必须为整数，收到: ${raw}`);
+    }
+    if (options.min !== undefined && value < options.min) {
+        throw new helixlifeError(helixlifeErrorCode.INVALID_ARGUMENT, `参数 ${name} 不能小于 ${options.min}，收到: ${raw}`);
+    }
+    if (options.max !== undefined && value > options.max) {
+        throw new helixlifeError(helixlifeErrorCode.INVALID_ARGUMENT, `参数 ${name} 不能大于 ${options.max}，收到: ${raw}`);
+    }
+    return value;
+}
+// 枚举参数校验：raw 去空后须命中候选集，否则回退默认值或抛错
+// options.defaultValue 存在时，空输入返回默认值；不存在时空输入按非法处理
+export function parseEnumOption(raw, candidates, options) {
+    const value = (raw ?? options.defaultValue ?? "").trim();
+    if (!value && options.defaultValue !== undefined) {
+        return options.defaultValue;
+    }
+    if (candidates.includes(value)) {
+        return value;
+    }
+    throw new helixlifeError(helixlifeErrorCode.INVALID_ARGUMENT, `无效${options.label}: ${raw}，可选: ${candidates.join(" | ")}`);
+}
+//# sourceMappingURL=parse.js.map

package/cli/dist/core/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/core/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjE,0CAA0C;AAC1C,MAAM,UAAU,kBAAkB,CAChC,GAAgC,EAChC,IAAY,EACZ,UAA0C,EAAE;IAE5C,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACpD,MAAM,IAAI,cAAc,CACtB,kBAAkB,CAAC,gBAAgB,EACnC,QAAQ,IAAI,EAAE,CACf,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,cAAc,CACtB,kBAAkB,CAAC,gBAAgB,EACnC,MAAM,IAAI,cAAc,GAAG,EAAE,CAC9B,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QACrD,MAAM,IAAI,cAAc,CACtB,kBAAkB,CAAC,gBAAgB,EACnC,MAAM,IAAI,SAAS,OAAO,CAAC,GAAG,QAAQ,GAAG,EAAE,CAC5C,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QACrD,MAAM,IAAI,cAAc,CACtB,kBAAkB,CAAC,gBAAgB,EACnC,MAAM,IAAI,SAAS,OAAO,CAAC,GAAG,QAAQ,GAAG,EAAE,CAC5C,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,kCAAkC;AAClC,iDAAiD;AACjD,MAAM,UAAU,eAAe,CAC7B,GAAuB,EACvB,UAAwB,EACxB,OAA4C;IAE5C,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACzD,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACjD,OAAO,OAAO,CAAC,YAAY,CAAC;IAC9B,CAAC;IACD,IAAK,UAAgC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,KAAU,CAAC;IACpB,CAAC;IACD,MAAM,IAAI,cAAc,CACtB,kBAAkB,CAAC,gBAAgB,EACnC,KAAK,OAAO,CAAC,KAAK,KAAK,GAAG,QAAQ,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAC3D,CAAC;AACJ,CAAC"}

package/cli/dist/core/paths.d.ts

@@ -0,0 +1,21 @@
+export declare function getUserDownloadsDir(): string;
+export interface SanitizeFilenameOptions {
+    /**
+     * 文件名主体（不含扩展名）最大码点数。
+     * 默认 80；传 `null` 表示不截断（对齐官网整题文件名，仅做非法字符清洗）。
+     */
+    maxLength?: number | null;
+}
+/**
+ * 清理文件名中的非法/控制字符，可选截断，避免 Windows 等系统写入失败。
+ * 若含扩展名（如 .docx），只截断 stem，保留扩展名。
+ */
+export declare function sanitizeFilename(name: string, options?: SanitizeFilenameOptions): string;
+/**
+ * 解析用户传入的文件路径，兼容 Windows 上 Git Bash / MSYS 与 Node.js 的路径语义差异。
+ *
+ * 典型问题：Git Bash 将 `/tmp/foo` 映射到 `%TEMP%\foo`，而 Node 的 `path.resolve('/tmp/foo')`
+ * 会得到 `C:\tmp\foo`，导致 Agent 写入的文件与 CLI 读取位置不一致。
+ */
+export declare function resolveUserPath(rawPath: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/cli/dist/core/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAIA,wBAAgB,mBAAmB,IAAI,MAAM,CAI5C;AAED,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAsBR;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA6BvD"}

package/cli/dist/core/paths.js

@@ -0,0 +1,65 @@
+import { homedir, tmpdir } from "node:os";
+import { join, resolve } from "node:path";
+// 获取用户系统下载目录，供 docx 等文件默认保存
+export function getUserDownloadsDir() {
+    const home = homedir();
+    // Windows 与 macOS/Linux 均使用 ~/Downloads 作为默认下载路径
+    return join(home, "Downloads");
+}
+/**
+ * 清理文件名中的非法/控制字符，可选截断，避免 Windows 等系统写入失败。
+ * 若含扩展名（如 .docx），只截断 stem，保留扩展名。
+ */
+export function sanitizeFilename(name, options = {}) {
+    const maxLength = options.maxLength === undefined ? 80 : options.maxLength;
+    let base = name.normalize("NFC");
+    // 剥控制字符与换行，避免正文换行泄漏进路径
+    base = base.replace(/[\u0000-\u001f\u007f]/g, " ");
+    base = base.replace(/[<>:"/\\|?*]/g, "_");
+    base = base.replace(/\s+/g, " ").trim();
+    const extMatch = base.match(/^(.+?)(\.[A-Za-z0-9]{1,8})$/);
+    let stem = extMatch ? extMatch[1].trim() : base;
+    const ext = extMatch ? extMatch[2] : "";
+    if (maxLength != null) {
+        const chars = [...stem];
+        if (chars.length > maxLength) {
+            stem = chars.slice(0, maxLength).join("").trim();
+        }
+    }
+    if (!stem) {
+        stem = "未命名";
+    }
+    return `${stem}${ext}`;
+}
+/**
+ * 解析用户传入的文件路径，兼容 Windows 上 Git Bash / MSYS 与 Node.js 的路径语义差异。
+ *
+ * 典型问题：Git Bash 将 `/tmp/foo` 映射到 `%TEMP%\foo`，而 Node 的 `path.resolve('/tmp/foo')`
+ * 会得到 `C:\tmp\foo`，导致 Agent 写入的文件与 CLI 读取位置不一致。
+ */
+export function resolveUserPath(rawPath) {
+    if (!rawPath?.trim()) {
+        return resolve(rawPath);
+    }
+    if (process.platform !== "win32") {
+        return resolve(rawPath);
+    }
+    const slashes = rawPath.replace(/\\/g, "/");
+    // MSYS/Git Bash 盘符前缀：/c/Users/... → C:\Users\...
+    const driveMatch = slashes.match(/^\/([a-zA-Z])(\/.*)?$/);
+    if (driveMatch) {
+        const rest = driveMatch[2] ?? "";
+        return resolve(`${driveMatch[1].toUpperCase()}:${rest}`);
+    }
+    // POSIX 临时目录：对齐 Git Bash / MSYS2 语义（/tmp → os.tmpdir()）
+    if (slashes === "/tmp" || slashes.startsWith("/tmp/")) {
+        const rest = slashes.slice("/tmp".length).replace(/^\//, "");
+        return rest ? join(tmpdir(), ...rest.split("/")) : tmpdir();
+    }
+    if (slashes === "/var/tmp" || slashes.startsWith("/var/tmp/")) {
+        const rest = slashes.slice("/var/tmp".length).replace(/^\//, "");
+        return rest ? join(tmpdir(), ...rest.split("/")) : tmpdir();
+    }
+    return resolve(rawPath);
+}
+//# sourceMappingURL=paths.js.map

package/cli/dist/core/paths.js.map

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

package/cli/dist/core/sse-utils.d.ts

@@ -0,0 +1,49 @@
+import { type SseDataPayload } from "./index.js";
+export interface ExtractSseTextOptions {
+    /** 是否检查嵌套的 data.text/data.answer 字段 */
+    nested?: boolean;
+}
+/**
+ * 从 SSE 事件载荷中提取可追加的流式文本片段
+ * @param payload SSE 事件载荷
+ * @param options 提取选项
+ */
+export declare function extractSseText(payload: SseDataPayload, options?: ExtractSseTextOptions): string;
+/**
+ * 校验 SSE workflow 是否成功完成
+ * @param payload SSE 事件载荷
+ * @param failureMessage 失败时的错误消息
+ * @param terminalEvents 终端事件列表（检测是否收到）
+ */
+export declare function assertWorkflowSucceeded(payload: SseDataPayload, failureMessage: string, terminalEvents?: string[]): void;
+/**
+ * 从 workflow outputs 提取正文，优先 result/text/output 并排除 reference 字段
+ * @param outputs workflow 输出对象
+ * @param maxDepth 最大递归深度，默认 3
+ */
+export declare function pickWorkflowOutputText(outputs: Record<string, unknown> | undefined, maxDepth?: number): string;
+/**
+ * 从 workflow outputs 提取参考文献列表。
+ *
+ * 与网站 Proofread/Writing 一致：outputs.reference / outputs.references
+ * 可能是 string[]，也可能是换行分隔的 string（JOVA 常见）。
+ */
+export declare function extractReferences(outputs: Record<string, unknown> | undefined): string[];
+/**
+ * 从 SSE 事件流收集按 output id 分组的正文（用于 Application 模块）
+ * @param events SSE 事件列表
+ * @param options 提取选项
+ */
+export declare function collectOutputs(events: SseDataPayload[], options?: ExtractSseTextOptions): Record<string, string>;
+/**
+ * 从 SSE 事件流提取 record_id
+ * @param events SSE 事件列表
+ */
+export declare function extractRecordId(events: SseDataPayload[]): string | undefined;
+/**
+ * 合并多 output 为单一 markdown 文本（用于导出）
+ * @param outputs 按 output id 分组的文本
+ * @param labels 可选的 output 标签映射
+ */
+export declare function joinOutputsAsMarkdown(outputs: Record<string, string>, labels?: Record<string, string>): string;
+//# sourceMappingURL=sse-utils.d.ts.map

package/cli/dist/core/sse-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-utils.d.ts","sourceRoot":"","sources":["../../src/core/sse-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAgCR;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,IAAI,CAyBN;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC5C,QAAQ,SAAI,GACX,MAAM,CAKR;AA0CD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC3C,MAAM,EAAE,CAmBV;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,cAAc,EAAE,EACxB,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsBxB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,GAAG,SAAS,CAO5E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAQR"}

package/cli/dist/core/sse-utils.js

@@ -0,0 +1,181 @@
+import { helixlifeError, helixlifeErrorCode, } from "./index.js";
+/**
+ * 从 SSE 事件载荷中提取可追加的流式文本片段
+ * @param payload SSE 事件载荷
+ * @param options 提取选项
+ */
+export function extractSseText(payload, options = {}) {
+    if (typeof payload.answer === "string") {
+        return payload.answer;
+    }
+    if (typeof payload.text === "string") {
+        return payload.text;
+    }
+    if (options.nested) {
+        const data = payload.data;
+        if (typeof data === "object" && data !== null) {
+            const record = data;
+            if (typeof record.text === "string") {
+                return record.text;
+            }
+            if (typeof record.answer === "string") {
+                return record.answer;
+            }
+            // 新增：支持 result、content、output 等常见字段
+            if (typeof record.result === "string") {
+                return record.result;
+            }
+            if (typeof record.content === "string") {
+                return record.content;
+            }
+            if (typeof record.output === "string") {
+                return record.output;
+            }
+        }
+    }
+    return "";
+}
+/**
+ * 校验 SSE workflow 是否成功完成
+ * @param payload SSE 事件载荷
+ * @param failureMessage 失败时的错误消息
+ * @param terminalEvents 终端事件列表（检测是否收到）
+ */
+export function assertWorkflowSucceeded(payload, failureMessage, terminalEvents) {
+    if (payload.event === "error") {
+        const message = typeof payload.message === "string"
+            ? payload.message
+            : "SSE 流返回错误事件";
+        throw new helixlifeError(helixlifeErrorCode.REQUEST_FAILED, message);
+    }
+    if (terminalEvents && payload.event) {
+        // 检查是否为终端事件
+        if (terminalEvents.includes(payload.event)) {
+            const data = payload.data;
+            if (typeof data === "object" && data !== null) {
+                const status = data.status;
+                if (status === "failed") {
+                    const error = typeof data.error === "string"
+                        ? data.error
+                        : failureMessage;
+                    throw new helixlifeError(helixlifeErrorCode.REQUEST_FAILED, error);
+                }
+            }
+        }
+    }
+}
+/**
+ * 从 workflow outputs 提取正文，优先 result/text/output 并排除 reference 字段
+ * @param outputs workflow 输出对象
+ * @param maxDepth 最大递归深度，默认 3
+ */
+export function pickWorkflowOutputText(outputs, maxDepth = 3) {
+    if (!outputs) {
+        return "";
+    }
+    return pickWorkflowOutputTextRecursive(outputs, 0, maxDepth);
+}
+function pickWorkflowOutputTextRecursive(outputs, depth, maxDepth) {
+    if (depth > maxDepth) {
+        return "";
+    }
+    if (typeof outputs.result === "string" && outputs.result.trim()) {
+        return outputs.result;
+    }
+    if (typeof outputs.text === "string" && outputs.text.trim()) {
+        return outputs.text;
+    }
+    if (typeof outputs.output === "string" && outputs.output.trim()) {
+        return outputs.output;
+    }
+    const parts = Object.entries(outputs)
+        .filter(([key, value]) => key !== "reference" && typeof value === "string")
+        .map(([, value]) => value);
+    const joined = parts.join("\n\n").trim();
+    if (joined) {
+        return joined;
+    }
+    const first = Object.values(outputs)[0];
+    if (typeof first === "string") {
+        return first;
+    }
+    if (typeof first === "object" && first !== null) {
+        return pickWorkflowOutputTextRecursive(first, depth + 1, maxDepth);
+    }
+    return "";
+}
+/**
+ * 从 workflow outputs 提取参考文献列表。
+ *
+ * 与网站 Proofread/Writing 一致：outputs.reference / outputs.references
+ * 可能是 string[]，也可能是换行分隔的 string（JOVA 常见）。
+ */
+export function extractReferences(outputs) {
+    if (!outputs) {
+        return [];
+    }
+    const raw = outputs.reference ?? outputs.references;
+    if (Array.isArray(raw)) {
+        return raw
+            .filter((item) => typeof item === "string")
+            .map((item) => item.trim())
+            .filter(Boolean);
+    }
+    if (typeof raw === "string" && raw.trim()) {
+        return raw
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter(Boolean);
+    }
+    return [];
+}
+/**
+ * 从 SSE 事件流收集按 output id 分组的正文（用于 Application 模块）
+ * @param events SSE 事件列表
+ * @param options 提取选项
+ */
+export function collectOutputs(events, options = {}) {
+    const buffers = {};
+    for (const event of events) {
+        const chunk = extractSseText(event, options);
+        if (!chunk) {
+            continue;
+        }
+        const outputId = typeof event.output === "string" && event.output
+            ? event.output
+            : "_default";
+        if (!buffers[outputId]) {
+            buffers[outputId] = [];
+        }
+        buffers[outputId].push(chunk);
+    }
+    // 使用数组累积，避免 O(n²) 字符串拼接
+    return Object.fromEntries(Object.entries(buffers).map(([k, v]) => [k, v.join("")]));
+}
+/**
+ * 从 SSE 事件流提取 record_id
+ * @param events SSE 事件列表
+ */
+export function extractRecordId(events) {
+    for (const event of events) {
+        if (typeof event.record_id === "string" && event.record_id) {
+            return event.record_id;
+        }
+    }
+    return undefined;
+}
+/**
+ * 合并多 output 为单一 markdown 文本（用于导出）
+ * @param outputs 按 output id 分组的文本
+ * @param labels 可选的 output 标签映射
+ */
+export function joinOutputsAsMarkdown(outputs, labels) {
+    const parts = Object.entries(outputs)
+        .filter(([, value]) => value.trim())
+        .map(([id, value]) => {
+        const label = labels?.[id];
+        return label ? `## ${label}\n\n${value.trim()}` : value.trim();
+    });
+    return parts.join("\n\n");
+}
+//# sourceMappingURL=sse-utils.js.map

package/cli/dist/core/sse-utils.js.map

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

package/cli/dist/core/terminal.d.ts

@@ -0,0 +1,2 @@
+export declare function isInteractiveTerminal(): boolean;
+//# sourceMappingURL=terminal.d.ts.map

package/cli/dist/core/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/core/terminal.ts"],"names":[],"mappings":"AAGA,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C"}

package/cli/dist/core/terminal.js

@@ -0,0 +1,6 @@
+import { stdin as input, stdout as output } from "node:process";
+// 判断当前终端是否支持交互式 readline（stdin/stdout 均为 TTY）
+export function isInteractiveTerminal() {
+    return Boolean(input.isTTY && output.isTTY);
+}
+//# sourceMappingURL=terminal.js.map

package/cli/dist/core/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../src/core/terminal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,KAAK,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,cAAc,CAAC;AAEhE,8CAA8C;AAC9C,MAAM,UAAU,qBAAqB;IACnC,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC"}

package/cli/dist/core/token/index.d.ts

@@ -0,0 +1,5 @@
+export declare const TOKEN_DIR_NAME = "helixlife";
+export declare const TOKEN_FILE_NAME = "user-access-token.txt";
+export declare function getTokenFilePath(): string;
+export declare function loadTokenFromFile(): string | undefined;
+//# sourceMappingURL=index.d.ts.map

package/cli/dist/core/token/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/token/index.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,cAAc,cAAc,CAAC;AAG1C,eAAO,MAAM,eAAe,0BAA0B,CAAC;AAGvD,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAGD,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAYtD"}

package/cli/dist/core/token/index.js

@@ -0,0 +1,26 @@
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+// 凭证固定落盘目录名
+export const TOKEN_DIR_NAME = "helixlife";
+// 凭证固定文件名
+export const TOKEN_FILE_NAME = "user-access-token.txt";
+// 解析全平台默认 token 文件路径：~/.config/helixlife/user-access-token.txt
+export function getTokenFilePath() {
+    return join(homedir(), ".config", TOKEN_DIR_NAME, TOKEN_FILE_NAME);
+}
+// 从本地 token 文件读取凭证，供 API 请求附加 Authorization
+export function loadTokenFromFile() {
+    const filePath = getTokenFilePath();
+    if (!existsSync(filePath)) {
+        return undefined;
+    }
+    try {
+        const content = readFileSync(filePath, "utf8").trim();
+        return content || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=index.js.map

package/cli/dist/core/token/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/token/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,YAAY;AACZ,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC;AAE1C,UAAU;AACV,MAAM,CAAC,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEvD,+DAA+D;AAC/D,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC;AACrE,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,iBAAiB;IAC/B,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACtD,OAAO,OAAO,IAAI,SAAS,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/cli/dist/core/types/config.d.ts

@@ -0,0 +1,8 @@
+export interface helixlifeConfig {
+    baseUrl: string;
+    token?: string;
+}
+export declare function getDefaultBaseUrl(): string;
+export declare function getDefaultAuthBaseUrl(): string;
+export declare function getDefaultNewideaBaseUrl(): string;
+//# sourceMappingURL=config.d.ts.map

package/cli/dist/core/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/core/types/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4BD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAGD,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAGD,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD"}