larkin 0.5.14 → 0.5.16

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/agent-readiness.cjs

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isRuntimeReadinessCurrent = isRuntimeReadinessCurrent;
+exports.isSessionCurrent = isSessionCurrent;
 exports.isCurrentOwnedDaemon = isCurrentOwnedDaemon;
 exports.isChannelReconnecting = isChannelReconnecting;
 exports.projectAgentReadiness = projectAgentReadiness;
@@ -16,6 +17,14 @@ function isRuntimeReadinessCurrent(readiness, daemonStartedAt) {
     const epoch = timestamp(daemonStartedAt);
     return observedAt !== null && epoch !== null && observedAt >= epoch;
 }
+function isSessionCurrent(session, daemonStartedAt) {
+    // A resumed session deliberately retains its original creation time.  Its
+    // current daemon-epoch proof is the fresh session observation, not that
+    // historic creation timestamp.
+    const epoch = timestamp(daemonStartedAt);
+    const sessionObservedAt = timestamp(session?.lastSeenAt) ?? timestamp(session?.startedAt);
+    return epoch !== null && sessionObservedAt !== null && sessionObservedAt >= epoch;
+}
 function isCurrentOwnedDaemon(daemon) {
     return daemon?.state === "owned"
         && Number(daemon.pid) > 0
@@ -34,11 +43,7 @@ function projectAgentReadiness(input) {
     const daemonOwned = isCurrentOwnedDaemon(input.daemon) && (0, process_state_js_1.daemonHasAgent)(input.daemon, input.agentId);
     const daemonStartedAt = timestamp(input.daemon.startedAt);
     const connectedAt = timestamp(status?.connectedAt);
-    // A resumed session deliberately retains its original creation time.  Its
-    // current daemon-epoch proof is the fresh session observation, not that
-    // historic creation timestamp.
-    const sessionObservedAt = timestamp(status?.session?.lastSeenAt) ?? timestamp(status?.session?.startedAt);
-    const sessionCurrent = daemonStartedAt !== null && sessionObservedAt !== null && sessionObservedAt >= daemonStartedAt;
+    const sessionCurrent = isSessionCurrent(status?.session, input.daemon.startedAt);
     const channelConnected = daemonOwned
         && status?.connectedVia === "channel"
         && daemonStartedAt !== null

package/dist/app/agent-readiness.mjs

@@ -10,6 +10,14 @@ export function isRuntimeReadinessCurrent(readiness, daemonStartedAt) {
     const epoch = timestamp(daemonStartedAt);
     return observedAt !== null && epoch !== null && observedAt >= epoch;
 }
+export function isSessionCurrent(session, daemonStartedAt) {
+    // A resumed session deliberately retains its original creation time.  Its
+    // current daemon-epoch proof is the fresh session observation, not that
+    // historic creation timestamp.
+    const epoch = timestamp(daemonStartedAt);
+    const sessionObservedAt = timestamp(session?.lastSeenAt) ?? timestamp(session?.startedAt);
+    return epoch !== null && sessionObservedAt !== null && sessionObservedAt >= epoch;
+}
 export function isCurrentOwnedDaemon(daemon) {
     return daemon?.state === "owned"
         && Number(daemon.pid) > 0
@@ -28,11 +36,7 @@ export function projectAgentReadiness(input) {
     const daemonOwned = isCurrentOwnedDaemon(input.daemon) && daemonHasAgent(input.daemon, input.agentId);
     const daemonStartedAt = timestamp(input.daemon.startedAt);
     const connectedAt = timestamp(status?.connectedAt);
-    // A resumed session deliberately retains its original creation time.  Its
-    // current daemon-epoch proof is the fresh session observation, not that
-    // historic creation timestamp.
-    const sessionObservedAt = timestamp(status?.session?.lastSeenAt) ?? timestamp(status?.session?.startedAt);
-    const sessionCurrent = daemonStartedAt !== null && sessionObservedAt !== null && sessionObservedAt >= daemonStartedAt;
+    const sessionCurrent = isSessionCurrent(status?.session, input.daemon.startedAt);
     const channelConnected = daemonOwned
         && status?.connectedVia === "channel"
         && daemonStartedAt !== null

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/dashboard/dashboard-view-model.mjs

@@ -7,7 +7,7 @@ import path from "node:path";
 import { StringDecoder } from "node:string_decoder";
 import { fileURLToPath } from "node:url";
 import { readJson, readProcessState } from "../platform/process-state.mjs";
-import { isRuntimeReadinessCurrent } from "../app/agent-readiness.mjs";
+import { isRuntimeReadinessCurrent, isSessionCurrent } from "../app/agent-readiness.mjs";
 import { isAllowedDashboardAvatarUrl } from "./dashboard-avatar.mjs";
 import { collectWorkspaceEntry as collectTypedWorkspaceEntry } from "./dashboard-workspace.mjs";
 import { buildFingerprint, packageVersion } from "../platform/build-info.mjs";
@@ -480,9 +480,7 @@ async function collectAgentStatus(a, configDir, daemonStartedAt, piModelResolver
     // 本 agent 专属时间线：三路历史合并按时间倒序，不是全局一条汇总——每个 agent 只看自己的故事。
     const { recentErrors, lastActivity, lastDeliver, feed } = projectStatusTimeline(status);
     const statusReadiness = status.runtimeReadiness;
-    const sessionStartedAt = finiteTime(status.session?.startedAt);
-    const daemonEpoch = finiteTime(daemonStartedAt);
-    const sessionCurrent = sessionStartedAt !== null && daemonEpoch !== null && sessionStartedAt >= daemonEpoch;
+    const sessionCurrent = isSessionCurrent(status.session, daemonStartedAt);
     const runtimeReadiness = sessionCurrent && isRuntimeReadinessCurrent(statusReadiness, daemonStartedAt)
         || statusReadiness?.state !== "ready"
         ? statusReadiness || null

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}`);
         }
@@ -1563,9 +1599,9 @@ function createHostShell({ env = process.env, runtimeHost, channelPackage, event
                 const status = hostState.readStatus(agent);
                 const turns = status.session && typeof status.session === "object"
                     ? Math.max(0, Number(status.session.turns) || 0) : 0;
-                const sessionStartedAt = status.session && typeof status.session === "object"
-                    ? Date.parse(String(status.session.startedAt || "")) : Number.NaN;
-                const sessionCurrent = Number.isFinite(sessionStartedAt) && sessionStartedAt >= Date.parse(daemonStartedAt);
+                const sessionCurrent = (0, agent_readiness_js_1.isSessionCurrent)(status.session && typeof status.session === "object"
+                    ? status.session
+                    : null, daemonStartedAt);
                 const runtimeReady = sessionCurrent && (0, agent_readiness_js_1.isRuntimeReadinessCurrent)(status.runtimeReadiness, daemonStartedAt);
                 const pendingCount = stateStore(agent).withInboxTransaction(() => stateStore(agent).readNdjson("inbox").length);
                 return { turns, runtimeReady, ...connectionState(status), pendingCount };
@@ -1650,9 +1686,9 @@ function createHostShell({ env = process.env, runtimeHost, channelPackage, event
                 const status = hostState.readStatus(agent);
                 const turns = status.session && typeof status.session === "object"
                     ? Math.max(0, Number(status.session.turns) || 0) : 0;
-                const sessionStartedAt = status.session && typeof status.session === "object"
-                    ? Date.parse(String(status.session.startedAt || "")) : Number.NaN;
-                const sessionCurrent = Number.isFinite(sessionStartedAt) && sessionStartedAt >= Date.parse(daemonStartedAt);
+                const sessionCurrent = (0, agent_readiness_js_1.isSessionCurrent)(status.session && typeof status.session === "object"
+                    ? status.session
+                    : null, daemonStartedAt);
                 const runtimeReady = sessionCurrent && (0, agent_readiness_js_1.isRuntimeReadinessCurrent)(status.runtimeReadiness, daemonStartedAt);
                 const pendingCount = stateStore(agent).withInboxTransaction(() => stateStore(agent).readNdjson("inbox").length);
                 return { turns, runtimeReady, ...connectionState(status), pendingCount };

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";
@@ -22,7 +23,7 @@ import { readDocumentCommentSubscription, verifyCallbackProbe } from "../platfor
 import { loadConfig, resolveInboxAuditSchedule, resolveMentionPolicy } from "../platform/config.mjs";
 import { processCommandToken } from "../app/internal-command.mjs";
 import { managedOfficialLarkCli } from "../app/agent-lark-cli-workspace.mjs";
-import { isChannelReconnecting, isRuntimeReadinessCurrent } from "../app/agent-readiness.mjs";
+import { isChannelReconnecting, isRuntimeReadinessCurrent, isSessionCurrent } from "../app/agent-readiness.mjs";
 import { documentCommentMessageId, documentCommentNoticeType, projectDocumentCommentEnvelope, resolveDocumentCommentContext, } from "./document-comment.mjs";
 import { isOpenPlatformHost, requireOpenDomain } from "./platform-hosts.mjs";
 const PENDING_DOCUMENT_COMMENT_LIMIT = 256;
@@ -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}`);
         }
@@ -1523,9 +1558,9 @@ export function createHostShell({ env = process.env, runtimeHost, channelPackage
                 const status = hostState.readStatus(agent);
                 const turns = status.session && typeof status.session === "object"
                     ? Math.max(0, Number(status.session.turns) || 0) : 0;
-                const sessionStartedAt = status.session && typeof status.session === "object"
-                    ? Date.parse(String(status.session.startedAt || "")) : Number.NaN;
-                const sessionCurrent = Number.isFinite(sessionStartedAt) && sessionStartedAt >= Date.parse(daemonStartedAt);
+                const sessionCurrent = isSessionCurrent(status.session && typeof status.session === "object"
+                    ? status.session
+                    : null, daemonStartedAt);
                 const runtimeReady = sessionCurrent && isRuntimeReadinessCurrent(status.runtimeReadiness, daemonStartedAt);
                 const pendingCount = stateStore(agent).withInboxTransaction(() => stateStore(agent).readNdjson("inbox").length);
                 return { turns, runtimeReady, ...connectionState(status), pendingCount };
@@ -1610,9 +1645,9 @@ export function createHostShell({ env = process.env, runtimeHost, channelPackage
                 const status = hostState.readStatus(agent);
                 const turns = status.session && typeof status.session === "object"
                     ? Math.max(0, Number(status.session.turns) || 0) : 0;
-                const sessionStartedAt = status.session && typeof status.session === "object"
-                    ? Date.parse(String(status.session.startedAt || "")) : Number.NaN;
-                const sessionCurrent = Number.isFinite(sessionStartedAt) && sessionStartedAt >= Date.parse(daemonStartedAt);
+                const sessionCurrent = isSessionCurrent(status.session && typeof status.session === "object"
+                    ? status.session
+                    : null, daemonStartedAt);
                 const runtimeReady = sessionCurrent && isRuntimeReadinessCurrent(status.runtimeReadiness, daemonStartedAt);
                 const pendingCount = stateStore(agent).withInboxTransaction(() => stateStore(agent).readNdjson("inbox").length);
                 return { turns, runtimeReady, ...connectionState(status), pendingCount };

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.14",
+  "version": "0.5.16",
   "private": false,
   "larkinPackageRole": "npm-published",
   "files": [