clawconnect-agent 0.2.13 → 0.2.15

package/dist/hermes/runtime/hermes-cron-change-watcher.js

@@ -0,0 +1,135 @@
+import { createHash } from "node:crypto";
+import { readFileSync, watch } from "node:fs";
+import { basename, dirname } from "node:path";
+/** jobs.json 不存在时的内容摘要哨兵；与任何真实文件内容的 sha256 都不可能相同。 */
+export const HERMES_CRON_JOBS_MISSING_DIGEST = "missing";
+/**
+ * 监听 Hermes cron 任务库的内容变化。
+ *
+ * 正确性只由“文件内容 sha256 摘要是否与基线不同”决定：fs.watch 通知仅是唤醒信号，
+ * 重复、合并或额外的通知（例如同目录 ticker_heartbeat、executions.db 的写入）都只会
+ * 触发一次重新读取，摘要相同即不发事件，因此同一份内容永远不会重复通知。
+ *
+ * 监听的是 jobs.json 所在目录而非文件本身：Hermes 以“写临时文件再 rename”的方式原子替换
+ * jobs.json，文件级 watch 会停留在被替换掉的旧 inode 上，目录级 watch 才能持续看到新文件。
+ * 同时监听上一级目录（Hermes home），当 cron 目录稍后被创建或被删除重建时重新挂载目录监听。
+ * 若 Hermes home 本身尚不存在，则只记录日志；下次 Relay 连接会重新创建本监听器。
+ */
+export function watchHermesCronJobs(options) {
+    const cronDirectory = dirname(options.jobsFile);
+    const cronDirectoryName = basename(cronDirectory);
+    const hermesHomeDirectory = dirname(cronDirectory);
+    const logWarning = options.logWarning ?? ((message) => console.warn(`[hermes-cron-watch] ${message}`));
+    let baselineDigest = options.baselineDigest;
+    let baselineEstablished = false;
+    let closed = false;
+    let pendingCheck;
+    let cronDirectoryWatcher;
+    let hermesHomeWatcher;
+    const checkNow = () => {
+        if (closed)
+            return;
+        const digest = readJobsDigest(options.jobsFile, logWarning);
+        if (digest === undefined)
+            return;
+        const hadBaseline = baselineEstablished || baselineDigest !== undefined;
+        const changed = hadBaseline && digest !== baselineDigest;
+        baselineDigest = digest;
+        baselineEstablished = true;
+        if (!changed)
+            return;
+        try {
+            options.onChange();
+        }
+        catch (error) {
+            logWarning(`change listener failed: ${errorMessage(error)}`);
+        }
+    };
+    // 同一事件循环轮次内的多次通知只合并为一次读取；这只是减少重复 I/O，
+    // 是否发事件仍完全由摘要比较决定。
+    const scheduleCheck = () => {
+        if (closed || pendingCheck)
+            return;
+        pendingCheck = setImmediate(() => {
+            pendingCheck = undefined;
+            checkNow();
+        });
+    };
+    const closeCronDirectoryWatcher = () => {
+        cronDirectoryWatcher?.close();
+        cronDirectoryWatcher = undefined;
+    };
+    const armCronDirectoryWatcher = () => {
+        closeCronDirectoryWatcher();
+        try {
+            const directoryWatcher = watch(cronDirectory, () => scheduleCheck());
+            directoryWatcher.on("error", (error) => {
+                logWarning(`cron directory watch failed: ${errorMessage(error)}`);
+                if (cronDirectoryWatcher === directoryWatcher)
+                    closeCronDirectoryWatcher();
+                scheduleCheck();
+            });
+            cronDirectoryWatcher = directoryWatcher;
+        }
+        catch (error) {
+            if (!isMissingPathError(error))
+                logWarning(`cannot watch cron directory: ${errorMessage(error)}`);
+        }
+    };
+    try {
+        hermesHomeWatcher = watch(hermesHomeDirectory, (_eventType, changedName) => {
+            // cron 目录被创建、删除或替换时重新挂载目录监听，并重新比较内容。
+            if (changedName !== null && String(changedName) !== cronDirectoryName)
+                return;
+            if (closed)
+                return;
+            armCronDirectoryWatcher();
+            scheduleCheck();
+        });
+        hermesHomeWatcher.on("error", (error) => {
+            logWarning(`Hermes home watch failed: ${errorMessage(error)}`);
+            hermesHomeWatcher?.close();
+            hermesHomeWatcher = undefined;
+        });
+    }
+    catch (error) {
+        logWarning(`cannot watch Hermes home; cron changes resume on next relay connect: ${errorMessage(error)}`);
+    }
+    armCronDirectoryWatcher();
+    checkNow();
+    return {
+        checkNow,
+        currentDigest: () => baselineDigest,
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            if (pendingCheck)
+                clearImmediate(pendingCheck);
+            pendingCheck = undefined;
+            closeCronDirectoryWatcher();
+            hermesHomeWatcher?.close();
+            hermesHomeWatcher = undefined;
+        },
+    };
+}
+/** 读取失败（非“不存在”）时返回 undefined，保留原基线，不把未知状态当成变化。 */
+function readJobsDigest(jobsFile, logWarning) {
+    try {
+        return createHash("sha256").update(readFileSync(jobsFile)).digest("hex");
+    }
+    catch (error) {
+        if (isMissingPathError(error))
+            return HERMES_CRON_JOBS_MISSING_DIGEST;
+        logWarning(`cannot read cron jobs file: ${errorMessage(error)}`);
+        return undefined;
+    }
+}
+function isMissingPathError(error) {
+    const code = error?.code;
+    return code === "ENOENT" || code === "ENOTDIR";
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=hermes-cron-change-watcher.js.map

package/dist/hermes/runtime/hermes-cron-change-watcher.js.map

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

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,57 @@
+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>;
+/**
+ * 一个移动端轮次最终应该展示的文本，以及它是怎么来的。
+ *
+ * 这是实时路径（`verifyHermesFileTransferIfRequired`）和历史投影（`runHermesChatHistory`）
+ * 共用的唯一规则：同一份 state.db 行只能算出同一个答案，两处不能各算一遍。
+ * 模型在 outcome 工具之后补的收尾文字（"已发送 ✅"之类）不是可信的最终回答，
+ * 只有 typed outcome 的 assistantText、第一方 send-file 回执和宿主生成的失败提示才算。
+ */
+export type HermesTurnOutput = {
+    kind: "none";
+} | {
+    kind: "file-evidence";
+    text: string;
+    fileCount: number;
+} | {
+    kind: "clarification";
+    text: string;
+} | {
+    kind: "cancelled";
+    text: string;
+} | {
+    kind: "ordinary";
+    text: string;
+} | {
+    kind: "attempted-unverified";
+    text: string;
+};
+export declare function resolveHermesTurnOutput(messages: Array<Record<string, unknown>> | undefined, sourceRunId: string): HermesTurnOutput;
+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[];