clawconnect-agent 0.2.13 → 0.2.14

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

@@ -0,0 +1,16 @@
+import type { LocalCommandContext } from "../../core/command-types.js";
+declare function runHermesChatOnce(params: {
+    message: string;
+    sessionKey: string;
+    resume?: string;
+    context: LocalCommandContext;
+    preloadedSkillArgs?: string[];
+    reasoningEffort?: string;
+    historyCompletion?: () => Promise<string | undefined>;
+}): Promise<string>;
+export declare function runHermesChatOnceWithMobileFileRoute(params: Parameters<typeof runHermesChatOnce>[0] & {
+    enableFileTransferRoute: boolean;
+    gatewayId: string;
+    sourceRunId?: string;
+}): Promise<string>;
+export {};

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

@@ -0,0 +1,359 @@
+// Hermes CLI 对话执行：构建 chat 参数、派生子进程、过滤展示输出并把工具/stderr 事件发布给 Relay。
+import { spawn } from "child_process";
+import { buildToolInvocationUpdatedEvent, } from "../../core/relay/timeline-event-builder.js";
+import { CHAT_TIMEOUT_MS, SUBPROCESS_ENV, hermesInvocation, isHermesCommandDeniedTimeoutLine, runHermes, stripAnsi, stripHermesSessionResumeNotices, } from "./hermes-runtime-process.js";
+import { buildHermesCliReasoningArgs } from "./hermes-runtime-reasoning.js";
+import { createHermesToolLogWatcher, hermesToolState, } from "./hermes-runtime-tool-log-watcher.js";
+import { clearHermesMobileFileRoute, registerHermesMobileFileRoute, } from "./hermes-mobile-file-route-store.js";
+const HERMES_HISTORY_COMPLETION_GRACE_MS = 2_000;
+const HERMES_HISTORY_COMPLETION_POLL_MS = 1_000;
+const HERMES_COMMAND_DENIED_TIMEOUT_MESSAGE = "Timeout – denying command";
+async function runHermesChatOnce(params) {
+    const args = [
+        "chat",
+        // Hermes 会按 display.interface 自动切到 TUI；移动端桥接必须强制经典 CLI，
+        // 再由 --quiet 只输出最终回答。Tools 过程仍由 agent.log watcher 独立发布。
+        "--cli",
+        "--query",
+        params.message,
+        "--quiet",
+        "--source",
+        "pocketclaw",
+        ...(params.preloadedSkillArgs ?? []),
+        ...buildHermesCliReasoningArgs(params.reasoningEffort),
+        "--yolo",
+    ];
+    if (params.resume) {
+        args.push("--resume", params.resume);
+    }
+    const runId = params.context.requestId ?? `hermes-${Date.now()}`;
+    const env = hermesChatSubprocessEnv(runId, params.sessionKey);
+    return params.context.publishEvent
+        ? await runHermesChatStreaming(args, params.sessionKey, params.context, runId, env, params.historyCompletion)
+        : runHermes(args, CHAT_TIMEOUT_MS, env);
+}
+export async function runHermesChatOnceWithMobileFileRoute(params) {
+    const hermesSessionId = params.resume?.trim();
+    const sourceRunId = params.sourceRunId?.trim();
+    if (!params.enableFileTransferRoute || !hermesSessionId || !sourceRunId) {
+        return await runHermesChatOnce(params);
+    }
+    await registerHermesMobileFileRoute({
+        hermesSessionId,
+        gatewayId: params.gatewayId,
+        sessionKey: params.sessionKey,
+        sourceRunId,
+    });
+    try {
+        return await runHermesChatOnce(params);
+    }
+    finally {
+        await clearHermesMobileFileRoute(hermesSessionId, sourceRunId);
+    }
+}
+async function runHermesChatStreaming(args, sessionKey, context, runId, env, historyCompletion) {
+    const invocation = hermesInvocation(args);
+    const child = spawn(invocation.command, invocation.args, {
+        env,
+        stdio: ["ignore", "pipe", "pipe"],
+        windowsHide: true,
+    });
+    let output = "";
+    let stderr = "";
+    let seq = 0;
+    let stdoutLineBuffer = "";
+    let inSecurityReview = false;
+    let commandDeniedTimeout = false;
+    let commandDeniedTimeoutKillTimer;
+    const toolCallIdsByName = new Map();
+    let toolCallCounter = 0;
+    const requestCommandDeniedTimeoutFailure = () => {
+        if (commandDeniedTimeout) {
+            return;
+        }
+        commandDeniedTimeout = true;
+        child.kill("SIGTERM");
+        commandDeniedTimeoutKillTimer = setTimeout(() => child.kill("SIGKILL"), 1000);
+        commandDeniedTimeoutKillTimer.unref?.();
+    };
+    const publishToolLogEvent = (event) => {
+        let toolCallId = toolCallIdsByName.get(event.toolName);
+        if (!toolCallId) {
+            toolCallCounter += 1;
+            toolCallId = `${runId}:hermes-tool-${toolCallCounter}`;
+            toolCallIdsByName.set(event.toolName, toolCallId);
+        }
+        if (event.phase === "completed" || event.phase === "failed") {
+            toolCallIdsByName.delete(event.toolName);
+        }
+        context.publishEvent?.({
+            type: "event",
+            event: "chat",
+            payload: {
+                runId,
+                sessionKey,
+                stream: "tool",
+                state: event.phase,
+                phase: event.phase,
+                role: "tool",
+                seq: seq += 1,
+                ts: Date.now(),
+                data: {
+                    phase: event.phase,
+                    tool_call_id: toolCallId,
+                    tool_name: event.toolName,
+                    text: event.text,
+                    is_error: event.isError === true,
+                },
+                timelineEvents: [
+                    buildToolInvocationUpdatedEvent({
+                        gatewayId: context.gatewayId ?? "clawconnect",
+                        sessionKey,
+                        turnId: runId,
+                        runId,
+                        toolInvocationId: toolCallId,
+                        toolState: hermesToolState(event),
+                        seq: seq,
+                        turnSeq: seq,
+                        content: [{
+                                type: event.phase === "completed" || event.phase === "failed" ? "tool_result" : "tool_call",
+                                toolName: event.toolName,
+                                text: event.text,
+                                isError: event.isError === true,
+                            }],
+                    }),
+                ],
+            },
+        });
+    };
+    const toolLogWatcher = createHermesToolLogWatcher(publishToolLogEvent);
+    const filterChatLine = (line) => {
+        const clean = stripAnsi(line).trim();
+        if (isHermesCommandDeniedTimeoutLine(clean)) {
+            requestCommandDeniedTimeoutFailure();
+            return null;
+        }
+        if (/DANGEROUS COMMAND:\s*Security scan/i.test(clean)) {
+            inSecurityReview = true;
+            return null;
+        }
+        if (inSecurityReview) {
+            if (/Choice\s*\[[^\]]+\]:/i.test(clean) || /(?:^|\s)[✕x]\s*Denied\b/i.test(clean) || /\bDenied\b/i.test(clean)) {
+                inSecurityReview = false;
+            }
+            return null;
+        }
+        return line;
+    };
+    const appendStdout = (text) => {
+        // Hermes CLI stdout is a presentation stream, not a semantic assistant stream.
+        // Some Windows builds emit transient TUI frames (Reasoning boxes, spinners, etc.)
+        // even with --cli --quiet. Buffer it for terminal completion, but never expose it
+        // as message.part.delta. The API path has typed assistant.delta events and remains
+        // the only Hermes path allowed to stream assistant text.
+        output += text;
+    };
+    const flushStdoutLineBuffer = () => {
+        if (!stdoutLineBuffer) {
+            return;
+        }
+        const clean = stripHermesSessionResumeNotices(filterChatLine(stdoutLineBuffer) ?? "");
+        stdoutLineBuffer = "";
+        if (!clean.trim()) {
+            return;
+        }
+        appendStdout(clean);
+    };
+    const publishText = (text) => {
+        stdoutLineBuffer += text;
+        const lines = stdoutLineBuffer.split(/\r?\n/);
+        stdoutLineBuffer = lines.pop() ?? "";
+        const clean = stripHermesSessionResumeNotices(lines
+            .map(filterChatLine)
+            .filter((line) => line !== null)
+            .join("\n"));
+        if (!clean.trim()) {
+            return;
+        }
+        const chunk = `${clean}\n`;
+        appendStdout(chunk);
+    };
+    const publishStderr = (text) => {
+        const clean = stripAnsi(text).trimEnd();
+        if (!clean) {
+            return;
+        }
+        stderr += `${clean}\n`;
+        context.publishEvent?.({
+            type: "event",
+            event: "maintenance_log",
+            payload: {
+                gatewayId: context.gatewayId,
+                requestId: context.requestId,
+                runId,
+                stream: "stderr",
+                seq: seq += 1,
+                ts: Date.now(),
+                text: clean,
+            },
+        });
+    };
+    const publishTypingMarker = () => {
+        // The local mobile client already owns the pending placeholder. Do not
+        // forward protocol-only typing markers as empty assistant chat events.
+    };
+    child.stdout?.on("data", (chunk) => publishText(chunk.toString()));
+    child.stderr?.on("data", (chunk) => publishStderr(chunk.toString()));
+    toolLogWatcher.start();
+    publishTypingMarker();
+    return await new Promise((resolveOutput, rejectOutput) => {
+        const abortSignal = context.abortSignal;
+        let abortRequested = abortSignal?.aborted === true;
+        let settled = false;
+        let historyCompletionTimer;
+        let historyCompletionInFlight = false;
+        const typingTimer = setInterval(publishTypingMarker, 5000);
+        typingTimer.unref?.();
+        const cleanup = () => {
+            clearInterval(typingTimer);
+            if (historyCompletionTimer) {
+                clearInterval(historyCompletionTimer);
+                historyCompletionTimer = undefined;
+            }
+            abortSignal?.removeEventListener("abort", abortChat);
+        };
+        const finishResolve = (value) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            cleanup();
+            clearTimeout(timeout);
+            toolLogWatcher.stop();
+            resolveOutput(value);
+        };
+        const finishReject = (error) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            cleanup();
+            clearTimeout(timeout);
+            toolLogWatcher.stop();
+            rejectOutput(error);
+        };
+        const timeout = setTimeout(() => {
+            child.kill("SIGTERM");
+            if (output.trim()) {
+                finishResolve(output);
+            }
+            else {
+                finishReject(new Error("hermes_chat_timeout"));
+            }
+        }, CHAT_TIMEOUT_MS);
+        timeout.unref?.();
+        const abortChat = () => {
+            abortRequested = true;
+            stdoutLineBuffer = "";
+            child.kill("SIGTERM");
+        };
+        const checkHistoryCompletion = () => {
+            if (!historyCompletion || settled || abortRequested || historyCompletionInFlight) {
+                return;
+            }
+            historyCompletionInFlight = true;
+            historyCompletion()
+                .then((detectedOutput) => {
+                if (!detectedOutput || settled || abortRequested) {
+                    return;
+                }
+                output = detectedOutput;
+                stdoutLineBuffer = "";
+                child.kill("SIGTERM");
+                setTimeout(() => {
+                    if (child.exitCode === null && child.signalCode === null) {
+                        child.kill("SIGKILL");
+                    }
+                }, 1000).unref?.();
+                finishResolve(detectedOutput);
+            })
+                .catch(() => {
+                // History completion is a best-effort escape hatch for Hermes processes
+                // that keep running after the assistant turn is already persisted.
+            })
+                .finally(() => {
+                historyCompletionInFlight = false;
+            });
+        };
+        if (abortRequested) {
+            abortChat();
+        }
+        else {
+            abortSignal?.addEventListener("abort", abortChat, { once: true });
+        }
+        if (historyCompletion) {
+            historyCompletionTimer = setInterval(checkHistoryCompletion, HERMES_HISTORY_COMPLETION_POLL_MS);
+            setTimeout(checkHistoryCompletion, HERMES_HISTORY_COMPLETION_GRACE_MS);
+        }
+        child.once("error", (error) => {
+            if (settled) {
+                return;
+            }
+            if (commandDeniedTimeoutKillTimer) {
+                clearTimeout(commandDeniedTimeoutKillTimer);
+                commandDeniedTimeoutKillTimer = undefined;
+            }
+            finishReject(error);
+        });
+        child.once("close", (code, signal) => {
+            void (async () => {
+                if (settled) {
+                    return;
+                }
+                if (commandDeniedTimeoutKillTimer) {
+                    clearTimeout(commandDeniedTimeoutKillTimer);
+                    commandDeniedTimeoutKillTimer = undefined;
+                }
+                if (abortRequested) {
+                    finishReject(new Error("hermes_chat_aborted"));
+                    return;
+                }
+                flushStdoutLineBuffer();
+                if (commandDeniedTimeout) {
+                    finishReject(new Error(HERMES_COMMAND_DENIED_TIMEOUT_MESSAGE));
+                    return;
+                }
+                if (code && code !== 0) {
+                    const reason = stderr.trim() || output.trim() || `hermes chat exited with code ${code}`;
+                    finishReject(new Error(signal ? `${reason} (${signal})` : reason));
+                    return;
+                }
+                if (historyCompletion) {
+                    try {
+                        // Prefer the persisted assistant message over CLI presentation stdout.
+                        // Hermes writes the semantic answer before a normal process exit, while
+                        // stdout may still contain transient TUI frames on Windows.
+                        const persistedOutput = await historyCompletion();
+                        if (persistedOutput) {
+                            output = persistedOutput;
+                        }
+                    }
+                    catch {
+                        // Older/test Hermes installations may not expose readable history.
+                        // In that case --cli --quiet stdout remains the compatibility fallback.
+                    }
+                }
+                finishResolve(output);
+            })().catch((error) => finishReject(error instanceof Error ? error : new Error(String(error))));
+        });
+    });
+}
+function hermesChatSubprocessEnv(runId, sessionKey) {
+    return {
+        ...SUBPROCESS_ENV,
+        CLAWCONNECT_SOURCE_RUN_ID: runId,
+        CLAWCONNECT_SESSION_KEY: sessionKey,
+        CLAWCONNECT_CHAT_SESSION_KEY: sessionKey,
+    };
+}
+//# sourceMappingURL=hermes-runtime-chat-cli.js.map

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

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

package/dist/hermes/runtime/hermes-runtime-chat-file-transfer.d.ts

@@ -0,0 +1,29 @@
+import { type PendingHermesFileTransfer } from "./hermes-file-transfer-state.js";
+import type { HermesFileTransferOutcome } from "../../commands/hermes-file-transfer-outcome.js";
+export type HermesChatPreparationPlan = {
+    preloadFileTransferSkill: boolean;
+    fileTransferMode: "continuation" | undefined;
+    pendingFileTransfer?: PendingHermesFileTransfer;
+};
+export declare function planHermesChatPreparation(params: {
+    message: string;
+    gatewayId: string;
+    sessionKey: string;
+    sessionId?: string;
+    sourceRunId?: string;
+    fileTransferCapability?: "cli";
+}): Promise<HermesChatPreparationPlan>;
+export declare function verifyHermesFileTransferIfRequired(params: {
+    plan: HermesChatPreparationPlan;
+    gatewayId: string;
+    sessionKey: string;
+    sessionId?: string;
+    sourceRunId?: string;
+    output?: string;
+}): Promise<{
+    verifiedFileTransferCount?: number;
+    output?: string;
+}>;
+/** Read only first-party terminal outcome records for the exact current turn. */
+export declare function collectHermesFileTransferOutcome(messages: Array<Record<string, unknown>> | undefined, sourceRunId: string): HermesFileTransferOutcome | undefined;
+export declare function collectHermesFileTransferEvidence(messages: Array<Record<string, unknown>> | undefined, sourceRunId: string): string[];