clawconnect-agent 0.2.13 → 0.2.14

package/dist/hermes/runtime/hermes-runtime-chat-file-transfer.js

@@ -0,0 +1,323 @@
+// Hermes 文件发送校验：按 sourceRunId 精确定位当前轮次，只认第一方 send-file 回执与 terminal 结构化结果。
+import { stringValue } from "./hermes-runtime-values.js";
+import { hermesSourceRunIdFromMessage } from "./hermes-runtime-history-completion.js";
+import { readHermesSessionMessages } from "./hermes-runtime-state-db.js";
+import { clearPendingHermesFileTransfer, getPendingHermesFileTransfer, recordPendingHermesFileTransfer, } from "./hermes-file-transfer-state.js";
+const HERMES_FILE_TRANSFER_NOT_SENT_MESSAGE = "文件尚未发送：没有检测到可验证的 clawconnect send-file 成功结果，请补充或确认要发送的文件后重试。";
+const HERMES_FILE_TRANSFER_CONTENT_MISSING_MESSAGE = "本轮没有可显示的结构化回答。";
+const HERMES_FILE_TRANSFER_CANCELLED_MESSAGE = "文件发送已取消。";
+export async function planHermesChatPreparation(params) {
+    // A continuation is enabled only by a durable host-side pending state from
+    // the same gateway/mobile/Hermes session.  The user's wording is deliberately
+    // opaque to this router; Hermes receives the full history and decides what it
+    // means (including any language, selection, or clarification).
+    const pending = params.sessionId
+        ? await getPendingHermesFileTransfer({
+            gatewayId: params.gatewayId,
+            sessionKey: params.sessionKey,
+            hermesSessionId: params.sessionId,
+            sourceRunId: params.sourceRunId,
+        })
+        : undefined;
+    return {
+        // The mobile relay explicitly grants the typed CLI file-transfer
+        // capability on every turn. The model/tool protocol, rather than a
+        // language-specific intent table, decides whether a send is needed. This
+        // deliberately trades the API fast path for a buffered CLI path on mobile
+        // turns, where send-file receipts are persisted atomically.
+        preloadFileTransferSkill: params.fileTransferCapability === "cli" || pending !== undefined,
+        fileTransferMode: pending ? "continuation" : undefined,
+        ...(pending ? { pendingFileTransfer: pending } : {}),
+    };
+}
+function normalizeHermesRole(value) {
+    return typeof value === "string" ? value.trim().toLowerCase() : "";
+}
+export async function verifyHermesFileTransferIfRequired(params) {
+    if (!params.plan.preloadFileTransferSkill) {
+        return {};
+    }
+    const messages = params.sessionId ? await readHermesSessionMessages(params.sessionId) : undefined;
+    const evidence = params.sourceRunId
+        ? collectHermesFileTransferEvidence(messages, params.sourceRunId)
+        : [];
+    if (evidence.length > 0) {
+        await clearPendingHermesFileTransfer(params.gatewayId, params.sessionKey, params.plan.pendingFileTransfer?.sourceRunId);
+        return {
+            verifiedFileTransferCount: evidence.length,
+            output: `已发送 ${evidence.length} 个文件，请查收。`,
+        };
+    }
+    const outcome = params.sourceRunId
+        ? collectHermesFileTransferOutcome(messages, params.sourceRunId)
+        : undefined;
+    if (outcome?.kind === "clarification") {
+        if (params.sessionId && params.sourceRunId) {
+            await recordPendingHermesFileTransfer({
+                gatewayId: params.gatewayId,
+                sessionKey: params.sessionKey,
+                hermesSessionId: params.sessionId,
+                sourceRunId: params.sourceRunId,
+                continuation: false,
+            });
+        }
+        // Only the typed content field is displayable. Raw assistant prose is
+        // deliberately discarded, and this outcome is never delivery evidence.
+        return {
+            output: outcome.assistantText ?? HERMES_FILE_TRANSFER_CONTENT_MISSING_MESSAGE,
+        };
+    }
+    if (outcome?.kind === "cancelled") {
+        await clearPendingHermesFileTransfer(params.gatewayId, params.sessionKey, params.plan.pendingFileTransfer?.sourceRunId);
+        return {
+            output: outcome.assistantText ?? HERMES_FILE_TRANSFER_CANCELLED_MESSAGE,
+        };
+    }
+    if (outcome?.kind === "ordinary") {
+        await clearPendingHermesFileTransfer(params.gatewayId, params.sessionKey, params.plan.pendingFileTransfer?.sourceRunId);
+        // Ordinary chat is shown only through the typed assistantText field. The
+        // model's ordinary label is routing metadata, never proof of delivery.
+        return {
+            output: outcome.assistantText ?? HERMES_FILE_TRANSFER_CONTENT_MISSING_MESSAGE,
+        };
+    }
+    if (outcome?.kind === "attempted") {
+        await clearPendingHermesFileTransfer(params.gatewayId, params.sessionKey, params.plan.pendingFileTransfer?.sourceRunId);
+        return {
+            verifiedFileTransferCount: 0,
+            output: HERMES_FILE_TRANSFER_NOT_SENT_MESSAGE,
+        };
+    }
+    if (params.sourceRunId && hasHermesSendFileAttempt(messages, params.sourceRunId)) {
+        return {
+            verifiedFileTransferCount: 0,
+            output: HERMES_FILE_TRANSFER_NOT_SENT_MESSAGE,
+        };
+    }
+    // File-transfer capability is available on every mobile turn, but capability
+    // alone does not turn ordinary chat into a file operation. Preserve the Host
+    // answer unless this exact turn emitted a typed outcome or actually invoked
+    // the first-party terminal command. This keeps failure closed around a real
+    // send attempt without replacing unrelated Hermes replies.
+    return {};
+}
+function hasHermesSendFileAttempt(messages, sourceRunId) {
+    const currentIndex = currentHermesTurnIndex(messages, sourceRunId);
+    if (currentIndex < 0 || !messages)
+        return false;
+    for (const message of messages.slice(currentIndex + 1)) {
+        if (normalizeHermesRole(message.role) === "user")
+            break;
+        if (normalizeHermesRole(message.role) !== "assistant")
+            continue;
+        const rawToolCalls = typeof message.tool_calls === "string"
+            ? parseJsonValue(message.tool_calls)
+            : message.tool_calls;
+        if (!Array.isArray(rawToolCalls))
+            continue;
+        for (const rawToolCall of rawToolCalls) {
+            const toolCall = rawToolCall && typeof rawToolCall === "object" && !Array.isArray(rawToolCall)
+                ? rawToolCall
+                : undefined;
+            const fn = toolCall?.function && typeof toolCall.function === "object" && !Array.isArray(toolCall.function)
+                ? toolCall.function
+                : undefined;
+            const functionName = normalizeHermesRole(fn?.name);
+            if (functionName === "clawconnect_send_file")
+                return true;
+            if (functionName !== "terminal")
+                continue;
+            const rawArguments = typeof fn?.arguments === "string"
+                ? parseJsonValue(fn.arguments)
+                : fn?.arguments;
+            const args = rawArguments && typeof rawArguments === "object" && !Array.isArray(rawArguments)
+                ? rawArguments
+                : undefined;
+            if (typeof args?.command === "string" && isClawConnectSendFileCommand(args.command)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+function isClawConnectSendFileCommand(command) {
+    return /(?:^|[\s;&|])(?:["'][^"']*clawconnect["']|[^\s;&|]*clawconnect)\s+send-file(?:\s|$)/i.test(command);
+}
+function parseJsonValue(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Read only first-party terminal outcome records for the exact current turn. */
+export function collectHermesFileTransferOutcome(messages, sourceRunId) {
+    const currentIndex = currentHermesTurnIndex(messages, sourceRunId);
+    if (currentIndex < 0 || !messages)
+        return undefined;
+    const outcomes = [];
+    for (const message of messages.slice(currentIndex + 1)) {
+        if (normalizeHermesRole(message.role) === "user")
+            break;
+        if (normalizeHermesRole(message.role) !== "tool" || normalizeHermesRole(message.tool_name) !== "terminal")
+            continue;
+        for (const record of terminalResultRecords(message)) {
+            if (record.protocol !== "clawconnect.hermes-file-transfer-outcome.v1"
+                || record.sourceRunId !== sourceRunId
+                || record.sourceRole !== "assistant"
+                || record.status !== "completed"
+                || record.exit_code !== 0
+                || (record.kind !== "ordinary" && record.kind !== "clarification" && record.kind !== "attempted" && record.kind !== "cancelled"))
+                continue;
+            const assistantText = typeof record.assistantText === "string" ? record.assistantText.trim() : "";
+            if (record.kind !== "attempted" && !assistantText)
+                continue;
+            outcomes.push({
+                protocol: "clawconnect.hermes-file-transfer-outcome.v1",
+                kind: record.kind,
+                sourceRunId,
+                sourceRole: "assistant",
+                status: "completed",
+                ...(assistantText ? { assistantText } : {}),
+            });
+        }
+    }
+    if (outcomes.length !== 1)
+        return undefined;
+    return outcomes[0];
+}
+export function collectHermesFileTransferEvidence(messages, sourceRunId) {
+    if (!messages) {
+        return [];
+    }
+    const currentIndex = currentHermesTurnIndex(messages, sourceRunId);
+    if (currentIndex < 0) {
+        return [];
+    }
+    const ids = new Set();
+    for (const message of messages.slice(currentIndex + 1)) {
+        if (normalizeHermesRole(message.role) === "user") {
+            break;
+        }
+        if (normalizeHermesRole(message.role) !== "tool")
+            continue;
+        const toolName = normalizeHermesRole(message.tool_name);
+        if (toolName === "clawconnect_send_file") {
+            const receipt = parseJsonRecord(stringValue(message.content) ?? "");
+            if (receipt?.ok === true
+                && receipt.sourceRunId === sourceRunId
+                && receipt.status === "completed"
+                && typeof receipt.fileId === "string"
+                && /^file_[a-z0-9]+$/i.test(receipt.fileId)) {
+                ids.add(receipt.fileId);
+            }
+            continue;
+        }
+        // Only the legacy first-party terminal result is additional evidence. A
+        // delegate summary, wrapper output, or assistant claim cannot manufacture
+        // an attachment by repeating the command name and a success word.
+        if (toolName !== "terminal")
+            continue;
+        for (const record of terminalResultRecords(message)) {
+            if (record.sourceRunId !== sourceRunId
+                || record.sourceRole !== "assistant"
+                || record.status !== "completed"
+                || record.exit_code !== 0
+                || typeof record.fileId !== "string"
+                || !/^file_[a-z0-9]+$/i.test(record.fileId)) {
+                continue;
+            }
+            ids.add(record.fileId);
+        }
+    }
+    return [...ids];
+}
+function currentHermesTurnIndex(messages, sourceRunId) {
+    if (!messages || !sourceRunId.trim())
+        return -1;
+    let currentIndex = -1;
+    for (let index = 0; index < messages.length; index += 1) {
+        const message = messages[index];
+        if (normalizeHermesRole(message?.role) === "user" && hermesSourceRunIdFromMessage(message) === sourceRunId) {
+            currentIndex = index;
+        }
+    }
+    return currentIndex;
+}
+function terminalResultRecords(message) {
+    const content = stringValue(message.content);
+    if (!content) {
+        return [];
+    }
+    const outer = parseJsonRecord(content);
+    if (!outer) {
+        return [];
+    }
+    const records = [outer];
+    const output = stringValue(outer.output);
+    if (output) {
+        for (const fragment of extractJsonObjects(output)) {
+            const record = parseJsonRecord(fragment);
+            if (record) {
+                // Hermes stores the command envelope's exit_code beside the textual
+                // send-file JSON payload; the payload itself carries the Relay fields.
+                records.push(record.exit_code === undefined && outer.exit_code !== undefined
+                    ? { ...record, exit_code: outer.exit_code }
+                    : record);
+            }
+        }
+    }
+    return records;
+}
+function parseJsonRecord(value) {
+    try {
+        const parsed = JSON.parse(value);
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed)
+            ? parsed
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function extractJsonObjects(value) {
+    const fragments = [];
+    let start = -1;
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let index = 0; index < value.length; index += 1) {
+        const character = value[index];
+        if (inString) {
+            if (escaped) {
+                escaped = false;
+            }
+            else if (character === "\\") {
+                escaped = true;
+            }
+            else if (character === '"') {
+                inString = false;
+            }
+            continue;
+        }
+        if (character === '"') {
+            inString = true;
+        }
+        else if (character === "{") {
+            if (depth === 0) {
+                start = index;
+            }
+            depth += 1;
+        }
+        else if (character === "}" && depth > 0) {
+            depth -= 1;
+            if (depth === 0 && start >= 0) {
+                fragments.push(value.slice(start, index + 1));
+                start = -1;
+            }
+        }
+    }
+    return fragments;
+}
+//# sourceMappingURL=hermes-runtime-chat-file-transfer.js.map

package/dist/hermes/runtime/hermes-runtime-chat-file-transfer.js.map

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

package/dist/hermes/runtime/hermes-runtime-chat-message.d.ts

@@ -0,0 +1,10 @@
+import type { HermesUsageSnapshot } from "./hermes-runtime-types.js";
+export type PreparedHermesMessage = {
+    apiMessage: string;
+    apiInstructions?: string;
+    cliMessage: string;
+};
+export declare function prepareRequiredHermesMessage(rawMessage: string, attachments: unknown, sessionKey: string, sourceRunId: string | undefined): Promise<PreparedHermesMessage>;
+export declare function sanitizeHermesUserAttachmentMarkers(message: string): string;
+export declare function cleanupExpiredHermesInbox(inboxDir?: string, nowMs?: number, ttlMs?: number): Promise<void>;
+export declare function buildHermesRuntimeContextHint(snapshot: HermesUsageSnapshot): string | undefined;

package/dist/hermes/runtime/hermes-runtime-chat-message.js

@@ -0,0 +1,133 @@
+// Hermes 对话消息准备：附件落盘到 inbox、用户附件标记失活、运行时上下文提示与移动端轮次身份元数据。
+import { randomUUID } from "crypto";
+import { mkdir, readdir, rm, stat, writeFile } from "fs/promises";
+import { join } from "path";
+import { CLAWCONNECT_MOBILE_BRIDGE_HINT, HERMES_INBOX_DIR, } from "./hermes-runtime-process.js";
+import { readCachedHermesStatusSnapshot } from "./hermes-runtime-usage.js";
+import { compactStringArray, sanitizeFileName } from "./hermes-runtime-values.js";
+const HERMES_RUNTIME_CONTEXT_CACHE_MAX_AGE_MS = 5 * 60_000;
+const HERMES_INBOX_TTL_MS = 24 * 60 * 60 * 1000;
+const USER_FILE_MARKER_PREFIX_RE = /\[file attached:/gi;
+export async function prepareRequiredHermesMessage(rawMessage, attachments, sessionKey, sourceRunId) {
+    const preparedMessage = await prepareHermesMessage(rawMessage, attachments, sessionKey, sourceRunId);
+    if (!preparedMessage.cliMessage.trim()) {
+        throw new Error("message_required");
+    }
+    return preparedMessage;
+}
+const CLAWCONNECT_MOBILE_TURN_INSTRUCTION = "Use [ClawConnect mobile turn] metadata only for ClawConnect file-transfer attribution and message identity. Do not mention it in the answer.";
+function buildClawConnectMobileTurnMetadata(sourceRunId, sessionKey) {
+    if (!sourceRunId) {
+        return undefined;
+    }
+    // 这个块是 ClawConnect 和 Hermes history 的稳定身份合同；客户端展示时会剥离它。
+    return [
+        "[ClawConnect mobile turn]",
+        `sourceRunId: ${sourceRunId}`,
+        `sessionKey: ${sessionKey}`,
+    ].join("\n");
+}
+async function prepareHermesMessage(message, attachments, sessionKey, sourceRunId) {
+    const refs = [];
+    if (Array.isArray(attachments)) {
+        await cleanupExpiredHermesInbox();
+        const safeSession = sessionKey.replace(/[^\w.-]/g, "_") || "main";
+        for (const attachment of attachments) {
+            if (!attachment || typeof attachment !== "object" || Array.isArray(attachment)) {
+                continue;
+            }
+            const record = attachment;
+            if (typeof record.content !== "string" || record.content.length === 0) {
+                continue;
+            }
+            const fileName = sanitizeFileName(typeof record.fileName === "string" ? record.fileName
+                : typeof record.name === "string" ? record.name
+                    : `attachment-${randomUUID()}`);
+            const dir = join(HERMES_INBOX_DIR, safeSession, randomUUID());
+            await mkdir(dir, { recursive: true });
+            const filePath = join(dir, fileName);
+            await writeFile(filePath, Buffer.from(record.content, "base64"));
+            const mimeType = typeof record.mimeType === "string" ? record.mimeType : "application/octet-stream";
+            refs.push(`[file attached: ${filePath} (${mimeType})]`);
+        }
+    }
+    const userSections = [sanitizeHermesUserAttachmentMarkers(message).trim()];
+    if (refs.length > 0) {
+        userSections.push(refs.join("\n"));
+    }
+    const runtimeHint = buildHermesRuntimeContextHint(readCachedHermesStatusSnapshot(HERMES_RUNTIME_CONTEXT_CACHE_MAX_AGE_MS));
+    const turnMetadata = buildClawConnectMobileTurnMetadata(sourceRunId, sessionKey);
+    const apiMessageSections = [...userSections];
+    if (turnMetadata) {
+        apiMessageSections.push(turnMetadata);
+    }
+    const apiInstructionSections = [
+        runtimeHint,
+        CLAWCONNECT_MOBILE_BRIDGE_HINT,
+        turnMetadata ? CLAWCONNECT_MOBILE_TURN_INSTRUCTION : undefined,
+    ];
+    const cliMessageSections = [
+        ...userSections,
+        runtimeHint,
+        CLAWCONNECT_MOBILE_BRIDGE_HINT,
+        turnMetadata
+            ? [turnMetadata, CLAWCONNECT_MOBILE_TURN_INSTRUCTION].join("\n")
+            : undefined,
+    ];
+    return {
+        apiMessage: apiMessageSections.filter(Boolean).join("\n\n").trim(),
+        apiInstructions: apiInstructionSections.filter(Boolean).join("\n\n").trim() || undefined,
+        cliMessage: cliMessageSections.filter(Boolean).join("\n\n").trim(),
+    };
+}
+export function sanitizeHermesUserAttachmentMarkers(message) {
+    // Hermes 的本地文件提示只能由桥接层生成；让用户输入的同形标记失活，
+    // 避免把任意 Host 路径伪装成移动端附件交给运行时读取。
+    return message.replace(USER_FILE_MARKER_PREFIX_RE, "［file attached:");
+}
+export async function cleanupExpiredHermesInbox(inboxDir = HERMES_INBOX_DIR, nowMs = Date.now(), ttlMs = HERMES_INBOX_TTL_MS) {
+    let sessions;
+    try {
+        sessions = await readdir(inboxDir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    await Promise.all(sessions.filter((entry) => entry.isDirectory() && !entry.isSymbolicLink()).map(async (session) => {
+        const sessionDir = join(inboxDir, session.name);
+        let runs;
+        try {
+            runs = await readdir(sessionDir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        await Promise.all(runs.filter((entry) => entry.isDirectory() && !entry.isSymbolicLink()).map(async (run) => {
+            const runDir = join(sessionDir, run.name);
+            try {
+                const metadata = await stat(runDir);
+                if (nowMs - metadata.mtimeMs >= Math.max(0, ttlMs)) {
+                    await rm(runDir, { recursive: true, force: true });
+                }
+            }
+            catch {
+                // 清理失败不能阻断当前聊天；下一轮发送会再次尝试。
+            }
+        }));
+    }));
+}
+export function buildHermesRuntimeContextHint(snapshot) {
+    const details = compactStringArray([
+        snapshot.currentModel ? `model=${snapshot.currentModel}` : undefined,
+        snapshot.provider ? `provider=${snapshot.provider}` : undefined,
+    ]);
+    if (details.length === 0) {
+        return undefined;
+    }
+    return [
+        "[Hermes runtime context]",
+        `Current runtime: ${details.join(", ")}.`,
+        "If the user asks which model or provider is currently being used, answer from this runtime context.",
+    ].join("\n");
+}
+//# sourceMappingURL=hermes-runtime-chat-message.js.map

package/dist/hermes/runtime/hermes-runtime-chat-message.js.map

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

package/dist/hermes/runtime/hermes-runtime-chat-output.d.ts

@@ -0,0 +1,17 @@
+export declare function isHermesChatAbortedError(error: unknown): boolean;
+export declare function recoverHermesCliSessionAfterAbort(params: {
+    sessionKey: string;
+    resume: string | undefined;
+    mappedResume: string | undefined;
+    activeHead: number | undefined;
+    sourceRunId: string | undefined;
+}): Promise<void>;
+export declare function requireVisibleHermesOutput(output: string): string;
+export declare function recoverEmptyHermesApiOutputFromHistory(params: {
+    output: string;
+    hermesSessionId?: string;
+    sessionKey: string;
+    userMessage: string;
+    sourceRunId?: string;
+    abortSignal?: AbortSignal;
+}): Promise<string | undefined>;

package/dist/hermes/runtime/hermes-runtime-chat-output.js

@@ -0,0 +1,90 @@
+// Hermes 对话输出校验与恢复：可见输出约束、Provider 失败识别、API 空输出的历史回补以及 CLI 中止后的会话回卷。
+import { forgetHermesSession } from "../hermes-session-store.js";
+import { sanitizeHermesChatOutput } from "./hermes-runtime-process.js";
+import { detectHermesHistoryCompletion } from "./hermes-runtime-history-completion.js";
+import { rewindHermesSessionAfterActiveHead } from "./hermes-runtime-state-db.js";
+const HERMES_API_EMPTY_OUTPUT_HISTORY_COMPLETION_TIMEOUT_MS = 12_000;
+const HERMES_API_EMPTY_OUTPUT_HISTORY_COMPLETION_POLL_MS = 500;
+const HERMES_EMPTY_RESPONSE_MESSAGE = "Hermes 未返回可见回复，请检查当前模型额度或 Provider 凭据后重试。";
+export function isHermesChatAbortedError(error) {
+    return error instanceof Error && error.message === "hermes_chat_aborted";
+}
+export async function recoverHermesCliSessionAfterAbort(params) {
+    if (!params.resume) {
+        return;
+    }
+    // Hermes CLI writes the new user row before it reacts to SIGTERM. Rewind
+    // only rows beyond the stable pre-run head so completed context remains
+    // resumable and the canceled row cannot be answered on the next request.
+    if (params.activeHead !== undefined && params.sourceRunId) {
+        const recovered = await rewindHermesSessionAfterActiveHead(params.resume, params.activeHead, params.sourceRunId);
+        if (recovered) {
+            return;
+        }
+    }
+    // Old/unavailable state.db schemas cannot provide a safe row boundary. For
+    // an implicit alias, fail closed by dropping only that alias instead of
+    // risking a replay of the canceled prompt. Explicit Hermes session ids are
+    // never silently deleted or remapped.
+    if (params.mappedResume !== params.resume) {
+        return;
+    }
+    try {
+        await forgetHermesSession(params.sessionKey, params.mappedResume);
+    }
+    catch {
+        // Abort delivery must not be replaced by a best-effort recovery failure.
+    }
+}
+export function requireVisibleHermesOutput(output) {
+    const visibleOutput = sanitizeHermesChatOutput(output).trim();
+    if (!visibleOutput) {
+        // 空完成会让移动端永久留下无内容回复；没有可见文本时必须走显式失败事件。
+        throw new Error(HERMES_EMPTY_RESPONSE_MESSAGE);
+    }
+    if (isHermesProviderFailureOutput(visibleOutput)) {
+        // Hermes 某些 Provider 会以 exit 0 返回错误文本；这仍是失败，不能渲染成正常 assistant 回复。
+        throw new Error(visibleOutput);
+    }
+    return visibleOutput;
+}
+function isHermesProviderFailureOutput(output) {
+    const firstLine = output.split(/\r?\n/, 1)[0]?.trim() || "";
+    return /^(?:[❌✕x]\s*)?API call failed(?: after \d+ retries)?\s*:/i.test(firstLine)
+        || /^(?:[❌✕x]\s*)?HTTP\s+(?:401|402|403|429|5\d\d)\b/i.test(firstLine)
+        || /^Error code:\s*(?:401|402|403|429|5\d\d)\b/i.test(firstLine);
+}
+export async function recoverEmptyHermesApiOutputFromHistory(params) {
+    if (sanitizeHermesChatOutput(params.output).trim()) {
+        return undefined;
+    }
+    if (!params.hermesSessionId?.trim()) {
+        return undefined;
+    }
+    const deadline = Date.now() + HERMES_API_EMPTY_OUTPUT_HISTORY_COMPLETION_TIMEOUT_MS;
+    while (Date.now() <= deadline) {
+        if (params.abortSignal?.aborted) {
+            throw new Error("hermes_chat_aborted");
+        }
+        const detectedOutput = await detectHermesHistoryCompletion({
+            beforeSessions: [],
+            resume: params.hermesSessionId,
+            sessionKey: params.sessionKey,
+            userMessage: params.userMessage,
+            sourceRunId: params.sourceRunId,
+        });
+        if (detectedOutput) {
+            return detectedOutput;
+        }
+        const remainingMs = deadline - Date.now();
+        if (remainingMs <= 0) {
+            break;
+        }
+        await sleep(Math.min(HERMES_API_EMPTY_OUTPUT_HISTORY_COMPLETION_POLL_MS, remainingMs));
+    }
+    return undefined;
+}
+async function sleep(ms) {
+    await new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=hermes-runtime-chat-output.js.map

package/dist/hermes/runtime/hermes-runtime-chat-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-runtime-chat-output.js","sourceRoot":"","sources":["../../../src/hermes/runtime/hermes-runtime-chat-output.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AACvF,OAAO,EAAE,kCAAkC,EAAE,MAAM,8BAA8B,CAAC;AAElF,MAAM,qDAAqD,GAAG,MAAM,CAAC;AACrE,MAAM,kDAAkD,GAAG,GAAG,CAAC;AAC/D,MAAM,6BAA6B,GAAG,2CAA2C,CAAC;AAElF,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,OAAO,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,qBAAqB,CAAC;AAC3E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iCAAiC,CAAC,MAMvD;IACC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO;IACT,CAAC;IACD,yEAAyE;IACzE,wEAAwE;IACxE,yEAAyE;IACzE,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QAC1D,MAAM,SAAS,GAAG,MAAM,kCAAkC,CACxD,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,WAAW,CACnB,CAAC;QACF,IAAI,SAAS,EAAE,CAAC;YACd,OAAO;QACT,CAAC;IACH,CAAC;IAED,2EAA2E;IAC3E,wEAAwE;IACxE,2EAA2E;IAC3E,sCAAsC;IACtC,IAAI,MAAM,CAAC,YAAY,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;QAC1C,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,MAAM,mBAAmB,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;IAC3E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAAc;IACvD,MAAM,aAAa,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9D,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,sCAAsC;QACtC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,6BAA6B,CAAC,aAAa,CAAC,EAAE,CAAC;QACjD,kEAAkE;QAClE,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,SAAS,6BAA6B,CAAC,MAAc;IACnD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC5D,OAAO,2DAA2D,CAAC,IAAI,CAAC,SAAS,CAAC;WAC7E,mDAAmD,CAAC,IAAI,CAAC,SAAS,CAAC;WACnE,6CAA6C,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sCAAsC,CAAC,MAO5D;IACC,IAAI,wBAAwB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACnD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,qDAAqD,CAAC;IACpF,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QACD,MAAM,cAAc,GAAG,MAAM,6BAA6B,CAAC;YACzD,cAAc,EAAE,EAAE;YAClB,MAAM,EAAE,MAAM,CAAC,eAAe;YAC9B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC,CAAC;QACH,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,cAAc,CAAC;QACxB,CAAC;QACD,MAAM,WAAW,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1C,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM;QACR,CAAC;QACD,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,kDAAkD,EAAE,WAAW,CAAC,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,KAAK,CAAC,EAAU;IAC7B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/hermes/runtime/hermes-runtime-chat-queue.d.ts

@@ -0,0 +1 @@
+export declare function runSerializedHermesChat<T>(sessionKey: string, operation: () => Promise<T>): Promise<T>;

package/dist/hermes/runtime/hermes-runtime-chat-queue.js

@@ -0,0 +1,18 @@
+// Hermes 对话按 sessionKey 串行执行；队列状态只保存在本模块，保证同一会话的轮次严格按提交顺序处理。
+const hermesChatQueues = new Map();
+export async function runSerializedHermesChat(sessionKey, operation) {
+    const queueKey = sessionKey.trim() || "main";
+    const previous = hermesChatQueues.get(queueKey) ?? Promise.resolve();
+    const current = previous.catch(() => undefined).then(operation);
+    const stored = current.then(() => undefined, () => undefined);
+    hermesChatQueues.set(queueKey, stored);
+    try {
+        return await current;
+    }
+    finally {
+        if (hermesChatQueues.get(queueKey) === stored) {
+            hermesChatQueues.delete(queueKey);
+        }
+    }
+}
+//# sourceMappingURL=hermes-runtime-chat-queue.js.map

package/dist/hermes/runtime/hermes-runtime-chat-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-runtime-chat-queue.js","sourceRoot":"","sources":["../../../src/hermes/runtime/hermes-runtime-chat-queue.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAyB,CAAC;AAE1D,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,UAAkB,EAClB,SAA2B;IAE3B,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC;IAC7C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IACrE,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC9D,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC;IACvB,CAAC;YAAS,CAAC;QACT,IAAI,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,MAAM,EAAE,CAAC;YAC9C,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;AACH,CAAC"}