larkin 0.5.13 → 0.5.15

package/dist/agent/context-prompt.cjs

@@ -16,7 +16,7 @@ const agent_cli_capabilities_js_1 = require("./agent-cli-capabilities.cjs");
  * 5. 版本化：每次实质改动 bump LARKIN_STANDING_PROMPT_VERSION，并同步 eval 数据集/graders/断言。
  * 6. 用 eval 验证：行为变化必须配套固定场景 + rubric（evals/*、test/support/*-grader.mjs、live 测试）。
  */
-exports.LARKIN_STANDING_PROMPT_VERSION = "larkin-standing-v32";
+exports.LARKIN_STANDING_PROMPT_VERSION = "larkin-standing-v33";
 /**
  * Pi 长命令引导的唯一来源。仅在当前工具列表出现 tmux-backed bash 时适用；
  * 不声明 tmux 一定可用，也不复述扩展的工具细节。
@@ -43,6 +43,8 @@ const FEISHU_IM_COMMAND_GROUPS = [
     ["Messages", ["im +messages-send", "im +messages-reply", "im messages delete", "im +chat-messages-list", "im +threads-messages-list", "im +messages-mget"]],
     ["Chats", ["im +chat-list", "im +chat-search", "im chats get"]],
 ];
+// 云文档 shortcut 与 IM 一样是官方 lark-cli 直通，不属于 Agent CLI 自有命令清单。
+const FEISHU_DOCS_COMMANDS = ["docs +create", "docs +update", "docs +fetch"];
 function clean(value) {
     return value.replaceAll("\r", "").trim();
 }
@@ -187,6 +189,15 @@ class ContextPromptBuilder {
             ...FEISHU_IM_COMMAND_GROUPS.map(([label, suffixes]) => `- ${label}: ${suffixes.map((suffix) => `\`${executable} ${suffix}\``).join(", ")}.`),
             `- Attachments: for an attachment-only send/reply, use its native attachment flag without a text body flag; download with \`${executable} im +messages-resources-download\`.`,
             "",
+            "## Feishu docs command map",
+            "",
+            `Create, read, or update a Feishu cloud document only through these Larkin-owned shortcuts. Identity stays Runtime-locked: use \`${executable}\`, never invoke bare \`lark-cli\`, and never pass \`--agent\`, \`--as user\`, \`--profile\`, or \`--config-dir\`. If a docs command reports a missing scope, relay that error unchanged and ask the user to authorize it; do not bypass the scope boundary or invent a scope grant.`,
+            "A missing document URL or token is fail-closed: stop and report the missing locator. Do not guess a token, and do not call any docs shortcut that is absent from this map.",
+            `To create a document from supplied Markdown or plain text, run \`${executable} docs +create --doc-format markdown --content '<exact_markdown_body>' --json\`. Pass \`--content\` as one literal argument, using the same ANSI-C quoting rule as message bodies when the body is multiline. For a local file, use \`--content @<file>\` instead of inlining it. Create an empty document only with \`${executable} docs +create --title '<exact_title>' --json\` and no \`--content\`. \`--parent-token\` and \`--parent-position\` are optional and mutually exclusive. Official default \`--doc-format\` is \`xml\`; use \`markdown\` for this ordinary supplied-text recipe.`,
+            `To read an existing document, run \`${executable} docs +fetch --doc <doc_url_or_token> --json\`. Add \`--scope outline|range|keyword|section\` only for a partial read. Add \`--detail with-ids\` before an update that needs block ids. Omit \`--scope\` only when the whole document is required.`,
+            `To change an existing document, fetch its current content first, then run \`${executable} docs +update --doc <doc_url_or_token> --command <command> --json\`. For a simple inline replacement use \`--command str_replace --pattern '<exact_old>' --content '<exact_new>'\`. To append, use \`--command append --content '<exact_body>'\`. Use \`--command overwrite\` only when the user explicitly asks to replace the whole document. If the fetch fails or the scope is missing, fail closed and do not write from memory.`,
+            `- Documents: ${FEISHU_DOCS_COMMANDS.map((suffix) => `\`${executable} ${suffix}\``).join(", ")}.`,
+            "",
             "Do not invent Larkin commands that are absent from this list. Project instructions and memory remain owned by the runtime's native workspace discovery.",
         ].filter((line, index, all) => line !== "" || (index > 0 && all[index - 1] !== ""));
         const content = `${sections.join("\n").trim()}\n`;

package/dist/agent/context-prompt.mjs

@@ -13,7 +13,7 @@ import { agentCliPromptCapabilities } from "./agent-cli-capabilities.mjs";
  * 5. 版本化：每次实质改动 bump LARKIN_STANDING_PROMPT_VERSION，并同步 eval 数据集/graders/断言。
  * 6. 用 eval 验证：行为变化必须配套固定场景 + rubric（evals/*、test/support/*-grader.mjs、live 测试）。
  */
-export const LARKIN_STANDING_PROMPT_VERSION = "larkin-standing-v32";
+export const LARKIN_STANDING_PROMPT_VERSION = "larkin-standing-v33";
 /**
  * Pi 长命令引导的唯一来源。仅在当前工具列表出现 tmux-backed bash 时适用；
  * 不声明 tmux 一定可用，也不复述扩展的工具细节。
@@ -40,6 +40,8 @@ const FEISHU_IM_COMMAND_GROUPS = [
     ["Messages", ["im +messages-send", "im +messages-reply", "im messages delete", "im +chat-messages-list", "im +threads-messages-list", "im +messages-mget"]],
     ["Chats", ["im +chat-list", "im +chat-search", "im chats get"]],
 ];
+// 云文档 shortcut 与 IM 一样是官方 lark-cli 直通，不属于 Agent CLI 自有命令清单。
+const FEISHU_DOCS_COMMANDS = ["docs +create", "docs +update", "docs +fetch"];
 function clean(value) {
     return value.replaceAll("\r", "").trim();
 }
@@ -184,6 +186,15 @@ export class ContextPromptBuilder {
             ...FEISHU_IM_COMMAND_GROUPS.map(([label, suffixes]) => `- ${label}: ${suffixes.map((suffix) => `\`${executable} ${suffix}\``).join(", ")}.`),
             `- Attachments: for an attachment-only send/reply, use its native attachment flag without a text body flag; download with \`${executable} im +messages-resources-download\`.`,
             "",
+            "## Feishu docs command map",
+            "",
+            `Create, read, or update a Feishu cloud document only through these Larkin-owned shortcuts. Identity stays Runtime-locked: use \`${executable}\`, never invoke bare \`lark-cli\`, and never pass \`--agent\`, \`--as user\`, \`--profile\`, or \`--config-dir\`. If a docs command reports a missing scope, relay that error unchanged and ask the user to authorize it; do not bypass the scope boundary or invent a scope grant.`,
+            "A missing document URL or token is fail-closed: stop and report the missing locator. Do not guess a token, and do not call any docs shortcut that is absent from this map.",
+            `To create a document from supplied Markdown or plain text, run \`${executable} docs +create --doc-format markdown --content '<exact_markdown_body>' --json\`. Pass \`--content\` as one literal argument, using the same ANSI-C quoting rule as message bodies when the body is multiline. For a local file, use \`--content @<file>\` instead of inlining it. Create an empty document only with \`${executable} docs +create --title '<exact_title>' --json\` and no \`--content\`. \`--parent-token\` and \`--parent-position\` are optional and mutually exclusive. Official default \`--doc-format\` is \`xml\`; use \`markdown\` for this ordinary supplied-text recipe.`,
+            `To read an existing document, run \`${executable} docs +fetch --doc <doc_url_or_token> --json\`. Add \`--scope outline|range|keyword|section\` only for a partial read. Add \`--detail with-ids\` before an update that needs block ids. Omit \`--scope\` only when the whole document is required.`,
+            `To change an existing document, fetch its current content first, then run \`${executable} docs +update --doc <doc_url_or_token> --command <command> --json\`. For a simple inline replacement use \`--command str_replace --pattern '<exact_old>' --content '<exact_new>'\`. To append, use \`--command append --content '<exact_body>'\`. Use \`--command overwrite\` only when the user explicitly asks to replace the whole document. If the fetch fails or the scope is missing, fail closed and do not write from memory.`,
+            `- Documents: ${FEISHU_DOCS_COMMANDS.map((suffix) => `\`${executable} ${suffix}\``).join(", ")}.`,
+            "",
             "Do not invent Larkin commands that are absent from this list. Project instructions and memory remain owned by the runtime's native workspace discovery.",
         ].filter((line, index, all) => line !== "" || (index > 0 && all[index - 1] !== ""));
         const content = `${sections.join("\n").trim()}\n`;

package/dist/agent/freshness-gate.cjs

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateFreshness = evaluateFreshness;
+/** Provider-neutral optimistic gate. Provider fields and cursor ordering stay adapter-owned. */
+function evaluateFreshness(input) {
+    let snapshot;
+    try {
+        snapshot = input.probe();
+    }
+    catch (error) {
+        return { status: "unavailable", reason: error instanceof Error ? error.message : String(error) };
+    }
+    try {
+        const current = input.adapter.cursor(snapshot);
+        const comparison = input.adapter.compare(input.seen, current);
+        if (comparison === "gap")
+            return { status: "unavailable", reason: "authoritative history cannot establish a comparable head" };
+        if (comparison === "fresh")
+            return { status: "fresh", current, snapshot };
+        if (!current)
+            return { status: "unavailable", reason: "authoritative history returned an invalid empty cursor" };
+        return { status: "conflict", current, snapshot, context: input.adapter.unseen(input.seen, snapshot) };
+    }
+    catch (error) {
+        return { status: "unavailable", reason: error instanceof Error ? error.message : String(error) };
+    }
+}

package/dist/app/lark-cli.mjs

@@ -284,6 +284,45 @@ function parseCommentReply(argv) {
     return { messageId, text };
 }
 const IM_WRITE_MEMO_LIMIT = 512;
+function normalizeImBodyEscapes(argv) {
+    const next = [...argv];
+    const boundary = next.indexOf("--");
+    const limit = boundary < 0 ? next.length : boundary;
+    for (let index = 0; index < limit; index += 1) {
+        const argument = next[index];
+        const flag = ["--text", "--markdown"].find((candidate) => argument === candidate || argument.startsWith(`${candidate}=`));
+        if (!flag)
+            continue;
+        const valueIndex = argument === flag ? index + 1 : index;
+        if (valueIndex >= limit)
+            continue;
+        const value = argument === flag ? next[valueIndex] : argument.slice(flag.length + 1);
+        const hasEscapedWhitespace = /\\[nt]/.test(value);
+        // 已含真实换行、Windows 路径和 fenced code 的反斜杠均可能是用户的原文；
+        // 仅修复无歧义的单行普通文本，避免破坏代码、正则或路径。
+        const preserveVerbatim = /[\r\n]/.test(value)
+            || value.includes("```")
+            || /(?:^|[\s("'`])[A-Za-z]:\\/.test(value);
+        const normalized = hasEscapedWhitespace && !preserveVerbatim
+            ? value.replace(/\\([nt])/g, (_match, escape) => escape === "n" ? "\n" : "\t")
+            : value;
+        if (argument === flag)
+            next[valueIndex] = normalized;
+        else
+            next[index] = `${flag}=${normalized}`;
+        if (argument === flag)
+            index += 1;
+    }
+    return next;
+}
+function recordOutboundAt(store, target) {
+    store.mutateJson("freshnessState", { version: 1, cursors: {} }, (state) => {
+        const at = new Date().toISOString();
+        state.last_outbound_at = at;
+        state.last_outbound_by_target ??= {};
+        state.last_outbound_by_target[target] = at;
+    });
+}
 // 只标注、不拦截：每次成功写把「实际生效的幂等 key → 服务端返回的 message_id」记进备忘。
 // 同 key 再次成功且服务端返回同一个 message_id，说明服务端走了幂等去重（没有产生新消息），
 // 返回 true 供输出标注 duplicate。拦截权始终在服务端，备忘不会吞掉任何发送。
@@ -1117,7 +1156,7 @@ function emitCommittedUnverified(result, io, input) {
 }
 export function runLarkCli(argv, env = process.env, dependencies = {}) {
     const io = dependencies.io ?? defaultIo();
-    const effectiveArgv = argv;
+    let effectiveArgv = argv;
     const runtimeAgentId = larkinConfig.resolveRuntimeAuthority(env);
     if (!runtimeAgentId) {
         try {
@@ -1175,6 +1214,9 @@ export function runLarkCli(argv, env = process.env, dependencies = {}) {
     }
     if (decision.kind === "passthrough")
         return passthroughWithObservation(effectiveArgv, privateEnv, io, nativeDependencies, store);
+    if (decision.kind === "guarded" && (decision.operation === "send" || decision.operation === "reply")) {
+        effectiveArgv = normalizeImBodyEscapes(effectiveArgv);
+    }
     try {
         const recallMessageId = decision.operation === "recall" ? assertRecallSyntax(effectiveArgv) : null;
         const priorRecall = recallMessageId ? recallLedgerEntry(store, recallMessageId) : null;
@@ -1233,6 +1275,9 @@ export function runLarkCli(argv, env = process.env, dependencies = {}) {
         }
         const intentKey = policyFlagValue(effectiveArgv, "--idempotency-key") ?? intentId(targetKey, effectiveArgv);
         const write = callNative(botArgv(effectiveArgv, intentKey, decision), privateEnv, io, nativeDependencies);
+        if (!write.error && write.status === 0 && (decision.operation === "send" || decision.operation === "reply")) {
+            recordOutboundAt(store, targetKey);
+        }
         if (decision.operation === "urgent-app") {
             try {
                 assertUrgentAppNativeAccepted(write);

package/dist/feishu/host-processing-eye.cjs

@@ -15,6 +15,7 @@ class ProcessingEyeOrchestrator {
     recordError;
     setTimer;
     clearTimer;
+    now;
     constructor(options = {}) {
         this.options = options;
         this.execFile = options.execFile ?? node_child_process_1.execFile;
@@ -22,6 +23,7 @@ class ProcessingEyeOrchestrator {
         this.recordError = options.recordStatusError ?? (() => { });
         this.setTimer = options.setTimer ?? setTimeout;
         this.clearTimer = options.clearTimer ?? clearTimeout;
+        this.now = options.now ?? Date.now;
     }
     larkApi(agent, method, apiPath, data, callback) {
         const args = ["api", method, apiPath];
@@ -64,7 +66,7 @@ class ProcessingEyeOrchestrator {
         const existing = this.state.get(agent.agentId);
         if (existing)
             return existing;
-        const created = { sawActive: false, fallbackTimer: null, completionTimer: null, gen: 0 };
+        const created = { sawActive: false, fallbackTimer: null, completionTimer: null, progressTimer: null, turnStartedAt: 0, gen: 0 };
         this.state.set(agent.agentId, created);
         return created;
     }
@@ -74,6 +76,12 @@ class ProcessingEyeOrchestrator {
         this.clearTimer(state.completionTimer);
         state.completionTimer = null;
     }
+    cancelProgress(state) {
+        if (!state.progressTimer)
+            return;
+        this.clearTimer(state.progressTimer);
+        state.progressTimer = null;
+    }
     restoreAndClear(agent) {
         let leftovers = [];
         try {
@@ -87,7 +95,7 @@ class ProcessingEyeOrchestrator {
         this.pending.set(agent.agentId, leftovers);
         this.clear(agent, "启动清扫遗留");
     }
-    add(agent, msgId) {
+    add(agent, msgId, options = {}) {
         if (!agent.feishuProfile || !msgId || !msgId.startsWith("om_")) {
             this.log(`👀 跳过 agent=${agent.name} msg=${msgId || "?"} profile=${agent.feishuProfile || "缺"}（不满足点表情条件）`);
             return;
@@ -100,7 +108,9 @@ class ProcessingEyeOrchestrator {
         // add itself therefore establishes an active generation instead of
         // erasing activity already observed for that turn.
         state.sawActive = true;
+        state.turnStartedAt = this.now();
         this.cancelCompletion(state);
+        this.cancelProgress(state);
         if (state.fallbackTimer)
             this.clearTimer(state.fallbackTimer);
         const generation = state.gen;
@@ -112,6 +122,22 @@ class ProcessingEyeOrchestrator {
             this.clear(agent, "15分钟兜底");
         }, 15 * 60 * 1000);
         state.fallbackTimer = fallbackTimer;
+        let progressTimer;
+        progressTimer = this.setTimer(() => {
+            const current = this.state.get(agent.agentId);
+            if (current?.gen !== generation || current.progressTimer !== progressTimer)
+                return;
+            current.progressTimer = null;
+            const pending = this.pending.get(agent.agentId) || [];
+            const anchor = pending.at(-1);
+            if (!anchor)
+                return;
+            const lastOutboundAt = this.options.lastOutboundAt?.(agent, anchor.target) ?? null;
+            if (lastOutboundAt !== null && lastOutboundAt >= current.turnStartedAt)
+                return;
+            this.sendProgress(agent, anchor);
+        }, 2 * 60 * 1000);
+        state.progressTimer = progressTimer;
         this.larkApi(agent, "POST", `/open-apis/im/v1/messages/${msgId}/reactions`, { reaction_type: { emoji_type: "OnIt" } }, (error, result) => {
             const reactionId = result?.data?.reaction_id;
             if (!reactionId) {
@@ -124,7 +150,8 @@ class ProcessingEyeOrchestrator {
                 return;
             }
             const list = this.pending.get(agent.agentId) || [];
-            list.push({ msgId, reactionId });
+            list.push({ msgId, reactionId, ...(options.replyInThread ? { replyInThread: true } : {}),
+                ...(options.target ? { target: options.target } : {}) });
             this.pending.set(agent.agentId, list);
             this.save(agent);
         });
@@ -139,6 +166,7 @@ class ProcessingEyeOrchestrator {
                 state.fallbackTimer = null;
             }
             this.cancelCompletion(state);
+            this.cancelProgress(state);
         }
         const list = this.pending.get(agent.agentId) || [];
         if (!list.length) {
@@ -157,6 +185,25 @@ class ProcessingEyeOrchestrator {
         // 执行结束（含正常完成）：只摘除 👀，不再追加任何完成 reaction（用户 2026-08-12 要求）。
         this.log(`👀 已摘 agent=${agent.name} n=${list.length} 原因=${reason || "?"}`);
     }
+    sendProgress(agent, anchor) {
+        const selected = this.options.cliForAgent?.(agent) ?? (() => {
+            const managed = (0, agent_lark_cli_workspace_js_1.managedOfficialLarkCli)(agent, this.options.envForAgent?.(agent) ?? process.env);
+            return { command: managed.command.command, argsPrefix: managed.command.argsPrefix, env: managed.env };
+        })();
+        const args = ["im", "+messages-reply", "--message-id", anchor.msgId,
+            ...(anchor.replyInThread ? ["--reply-in-thread"] : []),
+            "--text", "我还在处理中，完成后会汇总更新。", "--json", "--as", "bot"];
+        this.execFile(selected.command, [...selected.argsPrefix, ...args], { encoding: "utf8", timeout: 10_000, env: selected.env }, (error, stdout, stderr) => {
+            if (error) {
+                const code = error.code;
+                const detail = String(stderr || "").trim().slice(0, 160) || String(stdout || "").trim().slice(0, 120);
+                this.log(`长任务进度发送失败 agent=${agent.name}: exit=${code ?? "?"}${detail ? ` | ${detail}` : ""}`);
+                return;
+            }
+            this.options.recordOutboundAt?.(agent, anchor.target);
+            this.log(`长任务进度已发送 agent=${agent.name} msg=${anchor.msgId}`);
+        });
+    }
     observeActivity(agent, activity) {
         const state = this.getState(agent);
         if (activity === "error" || activity === "offline") {

package/dist/feishu/host-processing-eye.mjs

@@ -12,6 +12,7 @@ export class ProcessingEyeOrchestrator {
     recordError;
     setTimer;
     clearTimer;
+    now;
     constructor(options = {}) {
         this.options = options;
         this.execFile = options.execFile ?? nodeExecFile;
@@ -19,6 +20,7 @@ export class ProcessingEyeOrchestrator {
         this.recordError = options.recordStatusError ?? (() => { });
         this.setTimer = options.setTimer ?? setTimeout;
         this.clearTimer = options.clearTimer ?? clearTimeout;
+        this.now = options.now ?? Date.now;
     }
     larkApi(agent, method, apiPath, data, callback) {
         const args = ["api", method, apiPath];
@@ -61,7 +63,7 @@ export class ProcessingEyeOrchestrator {
         const existing = this.state.get(agent.agentId);
         if (existing)
             return existing;
-        const created = { sawActive: false, fallbackTimer: null, completionTimer: null, gen: 0 };
+        const created = { sawActive: false, fallbackTimer: null, completionTimer: null, progressTimer: null, turnStartedAt: 0, gen: 0 };
         this.state.set(agent.agentId, created);
         return created;
     }
@@ -71,6 +73,12 @@ export class ProcessingEyeOrchestrator {
         this.clearTimer(state.completionTimer);
         state.completionTimer = null;
     }
+    cancelProgress(state) {
+        if (!state.progressTimer)
+            return;
+        this.clearTimer(state.progressTimer);
+        state.progressTimer = null;
+    }
     restoreAndClear(agent) {
         let leftovers = [];
         try {
@@ -84,7 +92,7 @@ export class ProcessingEyeOrchestrator {
         this.pending.set(agent.agentId, leftovers);
         this.clear(agent, "启动清扫遗留");
     }
-    add(agent, msgId) {
+    add(agent, msgId, options = {}) {
         if (!agent.feishuProfile || !msgId || !msgId.startsWith("om_")) {
             this.log(`👀 跳过 agent=${agent.name} msg=${msgId || "?"} profile=${agent.feishuProfile || "缺"}（不满足点表情条件）`);
             return;
@@ -97,7 +105,9 @@ export class ProcessingEyeOrchestrator {
         // add itself therefore establishes an active generation instead of
         // erasing activity already observed for that turn.
         state.sawActive = true;
+        state.turnStartedAt = this.now();
         this.cancelCompletion(state);
+        this.cancelProgress(state);
         if (state.fallbackTimer)
             this.clearTimer(state.fallbackTimer);
         const generation = state.gen;
@@ -109,6 +119,22 @@ export class ProcessingEyeOrchestrator {
             this.clear(agent, "15分钟兜底");
         }, 15 * 60 * 1000);
         state.fallbackTimer = fallbackTimer;
+        let progressTimer;
+        progressTimer = this.setTimer(() => {
+            const current = this.state.get(agent.agentId);
+            if (current?.gen !== generation || current.progressTimer !== progressTimer)
+                return;
+            current.progressTimer = null;
+            const pending = this.pending.get(agent.agentId) || [];
+            const anchor = pending.at(-1);
+            if (!anchor)
+                return;
+            const lastOutboundAt = this.options.lastOutboundAt?.(agent, anchor.target) ?? null;
+            if (lastOutboundAt !== null && lastOutboundAt >= current.turnStartedAt)
+                return;
+            this.sendProgress(agent, anchor);
+        }, 2 * 60 * 1000);
+        state.progressTimer = progressTimer;
         this.larkApi(agent, "POST", `/open-apis/im/v1/messages/${msgId}/reactions`, { reaction_type: { emoji_type: "OnIt" } }, (error, result) => {
             const reactionId = result?.data?.reaction_id;
             if (!reactionId) {
@@ -121,7 +147,8 @@ export class ProcessingEyeOrchestrator {
                 return;
             }
             const list = this.pending.get(agent.agentId) || [];
-            list.push({ msgId, reactionId });
+            list.push({ msgId, reactionId, ...(options.replyInThread ? { replyInThread: true } : {}),
+                ...(options.target ? { target: options.target } : {}) });
             this.pending.set(agent.agentId, list);
             this.save(agent);
         });
@@ -136,6 +163,7 @@ export class ProcessingEyeOrchestrator {
                 state.fallbackTimer = null;
             }
             this.cancelCompletion(state);
+            this.cancelProgress(state);
         }
         const list = this.pending.get(agent.agentId) || [];
         if (!list.length) {
@@ -154,6 +182,25 @@ export class ProcessingEyeOrchestrator {
         // 执行结束（含正常完成）：只摘除 👀，不再追加任何完成 reaction（用户 2026-08-12 要求）。
         this.log(`👀 已摘 agent=${agent.name} n=${list.length} 原因=${reason || "?"}`);
     }
+    sendProgress(agent, anchor) {
+        const selected = this.options.cliForAgent?.(agent) ?? (() => {
+            const managed = managedOfficialLarkCli(agent, this.options.envForAgent?.(agent) ?? process.env);
+            return { command: managed.command.command, argsPrefix: managed.command.argsPrefix, env: managed.env };
+        })();
+        const args = ["im", "+messages-reply", "--message-id", anchor.msgId,
+            ...(anchor.replyInThread ? ["--reply-in-thread"] : []),
+            "--text", "我还在处理中，完成后会汇总更新。", "--json", "--as", "bot"];
+        this.execFile(selected.command, [...selected.argsPrefix, ...args], { encoding: "utf8", timeout: 10_000, env: selected.env }, (error, stdout, stderr) => {
+            if (error) {
+                const code = error.code;
+                const detail = String(stderr || "").trim().slice(0, 160) || String(stdout || "").trim().slice(0, 120);
+                this.log(`长任务进度发送失败 agent=${agent.name}: exit=${code ?? "?"}${detail ? ` | ${detail}` : ""}`);
+                return;
+            }
+            this.options.recordOutboundAt?.(agent, anchor.target);
+            this.log(`长任务进度已发送 agent=${agent.name} msg=${anchor.msgId}`);
+        });
+    }
     observeActivity(agent, activity) {
         const state = this.getState(agent);
         if (activity === "error" || activity === "offline") {

package/dist/feishu/host-shell.cjs

@@ -37,6 +37,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.memberNamesFromPayloads = memberNamesFromPayloads;
+exports.lastOutboundAtForTarget = lastOutboundAtForTarget;
 exports.createHostShell = createHostShell;
 const node_child_process_1 = require("node:child_process");
 const node_fs_1 = __importDefault(require("node:fs"));
@@ -49,6 +50,7 @@ const workspace_service_js_1 = require("../platform/workspace-service.cjs");
 const agent_state_store_js_1 = require("../agent/agent-state-store.cjs");
 const host_business_state_js_1 = require("./host-business-state.cjs");
 const host_processing_eye_js_1 = require("./host-processing-eye.cjs");
+const im_freshness_adapter_js_1 = require("./im-freshness-adapter.cjs");
 const inbox_projection_js_1 = require("../agent/inbox-projection.cjs");
 const host_reminder_orchestrator_js_1 = require("../agent/host-reminder-orchestrator.cjs");
 const inbox_audit_heartbeat_js_1 = require("../agent/inbox-audit-heartbeat.cjs");
@@ -120,6 +122,34 @@ function memberNamesFromPayloads(payloads) {
     return names;
 }
 function errorMessage(error) { return error instanceof Error ? error.message : String(error); }
+function canonicalImTarget(target) {
+    if (!target)
+        return null;
+    try {
+        return (0, im_freshness_adapter_js_1.serializeFeishuImTarget)((0, im_freshness_adapter_js_1.feishuImTarget)(target));
+    }
+    catch {
+        return null;
+    }
+}
+function lastOutboundAtForTarget(store, target) {
+    const state = store.readJson("freshnessState", {});
+    const canonicalTarget = canonicalImTarget(target);
+    const value = canonicalTarget ? state.last_outbound_by_target?.[canonicalTarget] : state.last_outbound_at;
+    const timestamp = typeof value === "string" ? Date.parse(value) : Number.NaN;
+    return Number.isFinite(timestamp) ? timestamp : null;
+}
+function recordOutboundAtForTarget(store, target) {
+    const canonicalTarget = canonicalImTarget(target);
+    store.mutateJson("freshnessState", { version: 1, cursors: {} }, (state) => {
+        const at = new Date().toISOString();
+        state.last_outbound_at = at;
+        if (!canonicalTarget)
+            return;
+        state.last_outbound_by_target ??= {};
+        state.last_outbound_by_target[canonicalTarget] = at;
+    });
+}
 function safeRuntimeStatusDiagnostic(error) {
     return (0, provider_error_classifier_js_1.safeProviderDiagnostic)(error, "Runtime entered an error state", 500);
 }
@@ -338,6 +368,8 @@ function createHostShell({ env = process.env, runtimeHost, channelPackage, event
         recordStatusError: (agent, text) => hostState.recordStatusError(agent, text),
         readPending: (agent) => stateStore(agent).readJson("pendingReact", {}).items || [],
         writePending: (agent, items) => stateStore(agent).writeJson("pendingReact", { items }),
+        lastOutboundAt: (agent, target) => lastOutboundAtForTarget(stateStore(agent), target),
+        recordOutboundAt: (agent, target) => recordOutboundAtForTarget(stateStore(agent), target),
         cliForAgent: (agent) => {
             const managed = managedCliForAgent(agent);
             return { command: managed.command.command, argsPrefix: managed.command.argsPrefix, env: managed.env };
@@ -567,8 +599,12 @@ function createHostShell({ env = process.env, runtimeHost, channelPackage, event
                 excerpt: (0, host_business_state_js_1.safeConversationExcerpt)(event.content, 180),
                 at: new Date().toISOString(),
             }, 30);
-            if (inboxEnvelope.sender_type === "human" || inboxEnvelope.sender_type === "agent")
-                processingEyes.add(agent, String(inboxEnvelope.message_id || ""));
+            if (inboxEnvelope.sender_type === "human" || inboxEnvelope.sender_type === "agent") {
+                processingEyes.add(agent, String(inboxEnvelope.message_id || ""), {
+                    replyInThread: String(inboxEnvelope.target || "").startsWith("thread:"),
+                    target: String(inboxEnvelope.target || ""),
+                });
+            }
             if (receipt.status === "deferred")
                 log(`Runtime 暂缓投递，消息保留在 inbox seq=${inboxEnvelope.seq}: ${receipt.reason}`);
         }

package/dist/feishu/host-shell.mjs

@@ -9,6 +9,7 @@ import { reconcileAgentWorkspace } from "../platform/workspace-service.mjs";
 import { createAgentStateStore } from "../agent/agent-state-store.mjs";
 import { HostEnvelopeProjector, HostStateProjection, SenderIdentityCache, projectActivityStatus, projectSessionStatus, safeConversationExcerpt, shouldPreventiveReconnect, } from "./host-business-state.mjs";
 import { ProcessingEyeOrchestrator } from "./host-processing-eye.mjs";
+import { feishuImTarget, serializeFeishuImTarget } from "./im-freshness-adapter.mjs";
 import { projectInboxEnvelope, targetKeyOfInboxEnvelope } from "../agent/inbox-projection.mjs";
 import { HostReminderOrchestrator } from "../agent/host-reminder-orchestrator.mjs";
 import { boundedInboxAuditDiagnostic, InboxAuditHeartbeat, INBOX_AUDIT_CADENCE_MS } from "../agent/inbox-audit-heartbeat.mjs";
@@ -80,6 +81,34 @@ export function memberNamesFromPayloads(payloads) {
     return names;
 }
 function errorMessage(error) { return error instanceof Error ? error.message : String(error); }
+function canonicalImTarget(target) {
+    if (!target)
+        return null;
+    try {
+        return serializeFeishuImTarget(feishuImTarget(target));
+    }
+    catch {
+        return null;
+    }
+}
+export function lastOutboundAtForTarget(store, target) {
+    const state = store.readJson("freshnessState", {});
+    const canonicalTarget = canonicalImTarget(target);
+    const value = canonicalTarget ? state.last_outbound_by_target?.[canonicalTarget] : state.last_outbound_at;
+    const timestamp = typeof value === "string" ? Date.parse(value) : Number.NaN;
+    return Number.isFinite(timestamp) ? timestamp : null;
+}
+function recordOutboundAtForTarget(store, target) {
+    const canonicalTarget = canonicalImTarget(target);
+    store.mutateJson("freshnessState", { version: 1, cursors: {} }, (state) => {
+        const at = new Date().toISOString();
+        state.last_outbound_at = at;
+        if (!canonicalTarget)
+            return;
+        state.last_outbound_by_target ??= {};
+        state.last_outbound_by_target[canonicalTarget] = at;
+    });
+}
 function safeRuntimeStatusDiagnostic(error) {
     return safeProviderDiagnostic(error, "Runtime entered an error state", 500);
 }
@@ -298,6 +327,8 @@ export function createHostShell({ env = process.env, runtimeHost, channelPackage
         recordStatusError: (agent, text) => hostState.recordStatusError(agent, text),
         readPending: (agent) => stateStore(agent).readJson("pendingReact", {}).items || [],
         writePending: (agent, items) => stateStore(agent).writeJson("pendingReact", { items }),
+        lastOutboundAt: (agent, target) => lastOutboundAtForTarget(stateStore(agent), target),
+        recordOutboundAt: (agent, target) => recordOutboundAtForTarget(stateStore(agent), target),
         cliForAgent: (agent) => {
             const managed = managedCliForAgent(agent);
             return { command: managed.command.command, argsPrefix: managed.command.argsPrefix, env: managed.env };
@@ -527,8 +558,12 @@ export function createHostShell({ env = process.env, runtimeHost, channelPackage
                 excerpt: safeConversationExcerpt(event.content, 180),
                 at: new Date().toISOString(),
             }, 30);
-            if (inboxEnvelope.sender_type === "human" || inboxEnvelope.sender_type === "agent")
-                processingEyes.add(agent, String(inboxEnvelope.message_id || ""));
+            if (inboxEnvelope.sender_type === "human" || inboxEnvelope.sender_type === "agent") {
+                processingEyes.add(agent, String(inboxEnvelope.message_id || ""), {
+                    replyInThread: String(inboxEnvelope.target || "").startsWith("thread:"),
+                    target: String(inboxEnvelope.target || ""),
+                });
+            }
             if (receipt.status === "deferred")
                 log(`Runtime 暂缓投递，消息保留在 inbox seq=${inboxEnvelope.seq}: ${receipt.reason}`);
         }

package/dist/feishu/im-freshness-adapter.cjs

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.feishuImFreshnessAdapter = void 0;
+exports.messageRevisionTime = messageRevisionTime;
+exports.feishuImTarget = feishuImTarget;
+exports.serializeFeishuImTarget = serializeFeishuImTarget;
+exports.mergeFeishuImCursor = mergeFeishuImCursor;
+function integerMillis(value) {
+    if (typeof value !== "string" || !/^[0-9]+$/.test(value))
+        return null;
+    try {
+        return BigInt(value);
+    }
+    catch {
+        return null;
+    }
+}
+function messageRevisionTime(message) {
+    const created = integerMillis(message.create_time);
+    const updated = message.update_time === undefined || message.update_time === "" ? created : integerMillis(message.update_time);
+    if (created === null || updated === null)
+        throw new Error(`malformed Feishu IM revision for ${message.message_id || "unknown message"}`);
+    return created > updated ? created : updated;
+}
+function feishuImTarget(value) {
+    const thread = /^thread:([^:]+):(.+)$/.exec(value);
+    if (thread)
+        return { provider: "feishu.im", resourceKind: "thread", resourceId: `${thread[1]}/${thread[2]}` };
+    const chat = /^chat:(.+)$/.exec(value);
+    if (chat)
+        return { provider: "feishu.im", resourceKind: "chat", resourceId: chat[1] };
+    throw new Error(`unsupported Feishu IM freshness target: ${value}`);
+}
+function serializeFeishuImTarget(target) {
+    return `${target.provider}/${target.resourceKind}/${target.resourceId}`;
+}
+function normalizedMessages(snapshot) {
+    if (!snapshot || !Array.isArray(snapshot.messages))
+        throw new Error("malformed Feishu IM history payload: messages must be an array");
+    return snapshot.messages.map((message) => {
+        if (!message || typeof message !== "object" || typeof message.message_id !== "string" || !message.message_id) {
+            throw new Error("malformed Feishu IM history payload: message_id is required");
+        }
+        return { ...message, revision: messageRevisionTime(message) };
+    });
+}
+exports.feishuImFreshnessAdapter = {
+    cursor(snapshot) {
+        const messages = normalizedMessages(snapshot);
+        if (!messages.length)
+            return null;
+        const revision = messages.reduce((maximum, message) => message.revision > maximum ? message.revision : maximum, 0n);
+        return {
+            schema: 1,
+            revisionTime: revision.toString(),
+            messageIds: [...new Set(messages.filter((message) => message.revision === revision).map((message) => message.message_id))].sort(),
+        };
+    },
+    compare(seen, current) {
+        if (!current)
+            return seen ? "gap" : "fresh";
+        if (!seen)
+            return "conflict";
+        const seenTime = integerMillis(seen.revisionTime);
+        const currentTime = integerMillis(current.revisionTime);
+        if (seen.schema !== 1 || seenTime === null || currentTime === null)
+            return "gap";
+        if (currentTime < seenTime)
+            return "gap";
+        if (currentTime > seenTime)
+            return "conflict";
+        return current.messageIds.every((id) => seen.messageIds.includes(id)) ? "fresh" : "conflict";
+    },
+    unseen(seen, snapshot) {
+        const messages = normalizedMessages(snapshot);
+        if (!seen)
+            return messages.map(({ revision: _revision, ...message }) => message);
+        const seenTime = integerMillis(seen.revisionTime);
+        if (seenTime === null)
+            return messages.map(({ revision: _revision, ...message }) => message);
+        return messages.filter((message) => message.revision > seenTime
+            || (message.revision === seenTime && !seen.messageIds.includes(message.message_id)))
+            .map(({ revision: _revision, ...message }) => message);
+    },
+};
+function mergeFeishuImCursor(left, right) {
+    if (!left)
+        return { ...right, messageIds: [...right.messageIds] };
+    const leftTime = BigInt(left.revisionTime);
+    const rightTime = BigInt(right.revisionTime);
+    if (rightTime < leftTime)
+        return left;
+    if (rightTime > leftTime)
+        return { ...right, messageIds: [...right.messageIds] };
+    return { schema: 1, revisionTime: left.revisionTime, messageIds: [...new Set([...left.messageIds, ...right.messageIds])].sort() };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "larkin",
-  "version": "0.5.13",
+  "version": "0.5.15",
   "private": false,
   "larkinPackageRole": "npm-published",
   "files": [