larkin 0.4.13 → 0.4.14

package/dist/feishu/host-business-state.mjs

@@ -302,31 +302,50 @@ export class HostEnvelopeProjector {
     }
     createReminderEnvelope(agentId, reminder, overdueMs, repeatDescription) {
         const seq = this.nextSequence(agentId);
-        const anchorMessageId = typeof reminder.msgRef === "string" && /^om_[A-Za-z0-9_-]+$/.test(reminder.msgRef)
-            ? reminder.msgRef
-            : null;
+        const legacyChannel = typeof reminder.channel === "string" ? reminder.channel.trim() : "";
+        const legacyChatTarget = /^oc_[A-Za-z0-9_-]+$/.test(legacyChannel) ? `chat:${legacyChannel}` : null;
+        const deliveryTarget = typeof reminder.deliveryTarget === "string" && reminder.deliveryTarget
+            ? reminder.deliveryTarget : legacyChatTarget;
+        const anchorMessageId = typeof reminder.deliveryAnchor === "string" && /^om_[A-Za-z0-9_-]+$/.test(reminder.deliveryAnchor)
+            ? reminder.deliveryAnchor
+            : typeof reminder.msgRef === "string" && /^om_[A-Za-z0-9_-]+$/.test(reminder.msgRef)
+                ? reminder.msgRef
+                : null;
+        const commentAnchorId = deliveryTarget?.startsWith("document-comment:") && typeof reminder.deliveryAnchor === "string"
+            && /^doc_comment_[A-Za-z0-9_-]+$/.test(reminder.deliveryAnchor) ? reminder.deliveryAnchor : null;
+        const anchorId = anchorMessageId || commentAnchorId;
+        const chatId = deliveryTarget?.match(/^chat:(oc_[A-Za-z0-9_-]+)$/)?.[1] || null;
         const lines = [
             `[定时提醒触发] ${reminder.title}`,
             `提醒ID: #${reminder.reminderId.slice(0, 8)}` + (reminder.repeat && repeatDescription
                 ? `　重复: ${repeatDescription}（下次已自动排在 ${reminder.fireAt}）`
                 : "　类型: 一次性"),
             overdueMs > 120_000 ? `注意: 原定时间已过 ${Math.round(overdueMs / 60_000)} 分钟（Runtime Host 离线期间错过，现补触发）` : null,
-            anchorMessageId ? `锚定消息: ${anchorMessageId}` : reminder.msgRef ? `历史锚点 ${String(reminder.msgRef)} 不是飞书 om_ message_id，不能用于回复` : null,
+            deliveryTarget ? `原始 deliveryTarget: ${deliveryTarget}`
+                : anchorId ? "这是升级前存量 user-facing reminder，优先回复其安全锚点；不得向标题中的任何人或第三方发送消息"
+                    : "本条为 internal/no-delivery reminder，不得向标题中的任何人或第三方发送消息",
+            anchorId ? `锚定消息: ${anchorId}` : reminder.msgRef ? `历史锚点 ${String(reminder.msgRef)} 不是可用的 delivery anchor，不能用于回复` : null,
             anchorMessageId
-                ? `回复原会话: ${this.larkCommand(`im +messages-reply --message-id ${anchorMessageId} ...`)}`
-                : null,
-            reminder.channel && /^oc_[A-Za-z0-9_-]+$/.test(reminder.channel)
-                ? `发送到原群: ${this.larkCommand(`im +messages-send --chat-id ${reminder.channel} ...`)}`
-                : reminder.channel
-                    ? `历史目标 ${reminder.channel} 不是 chat_id；${anchorMessageId ? "若不回复锚定消息，" : ""}先用 ${this.larkCommand("im +chat-search")} 查询并确认 oc_ chat_id，禁止按名称猜测发送目标`
-                    : anchorMessageId
-                        ? null
-                        : `本条存量提醒缺少可用的飞书 message_id/chat_id，无法安全推断原会话；请先用 ${this.larkCommand("im +chat-search")} 确认目标，禁止猜测发送`,
+                ? [
+                    `回复原会话: ${this.larkCommand(`im +messages-reply --message-id ${anchorMessageId}${deliveryTarget?.startsWith("thread:") ? " --reply-in-thread" : ""} ...`)}`,
+                    chatId ? `若 ${anchorMessageId} 无法由当前 Inbox 解析（例如 interaction_* 卡片锚点或已淘汰的历史消息），改用聊天兜底发送: ${this.larkCommand(`im +messages-send --chat-id ${chatId} ...`)}；仅使用这个持久化 chat_id，不得猜测收件人` : null,
+                ].filter((line) => Boolean(line)).join("\n")
+                : commentAnchorId
+                    ? `回复原文档评论: ${this.agentCommand(`comment reply --message-id ${commentAnchorId} --text ...`)}`
+                    : deliveryTarget
+                        ? chatId
+                            ? `发送到原始 target: ${deliveryTarget}: ${this.larkCommand(`im +messages-send --chat-id ${chatId} ...`)}（不得从提醒标题推断收件人）`
+                            : `发送到原始 target: ${deliveryTarget}（不得从提醒标题推断收件人）`
+                        : null,
             `这是你之前用 ${this.agentCommand("reminder schedule")} 设置的提醒，请按标题执行相应动作。管理: ${this.agentCommand("reminder list")} / ${this.agentCommand("reminder snooze")} / ${this.agentCommand("reminder cancel")}`,
         ].filter((line) => Boolean(line));
         const envelope = {
             kind: "reminder",
-            message_id: `rem_${reminder.reminderId.slice(0, 16)}_${seq}`,
+            // The random suffix keeps each firing's occurrence identity unique across
+            // Host restarts: the in-memory seq restarts at 1 and would otherwise let a
+            // recurring reminder reuse a prior occurrenceId in the delivery audit.
+            message_id: `rem_${reminder.reminderId.slice(0, 16)}_${seq}_${this.randomHex(6)}`,
+            reminderId: reminder.reminderId,
             seq,
             sender_name: "定时提醒",
             sender_type: "system",
@@ -336,6 +355,8 @@ export class HostEnvelopeProjector {
             timestamp: this.now().toISOString(),
             thread_id: null,
             wake: true,
+            deliveryTarget,
+            deliveryAnchor: anchorId,
         };
         return { ...envelope, target: RUNTIME_REMINDER_TARGET };
     }

package/dist/feishu/interaction-orchestrator.cjs

@@ -93,6 +93,8 @@ class HostInteractionOrchestrator {
             const reminderId = `int_${(0, node_crypto_1.createHash)("sha256").update(run.run_id).digest("hex").slice(0, 24)}`;
             const current = this.now();
             const fireAt = effect.args.fire_at ? Date.parse(effect.args.fire_at) : current + Number(effect.args.delay_seconds) * 1_000;
+            const deliveryTarget = typeof run.chat_id === "string" && run.chat_id ? `chat:${run.chat_id}` : null;
+            const deliveryAnchor = typeof run.message_id === "string" && /^om_[A-Za-z0-9_-]+$/.test(run.message_id) ? run.message_id : null;
             const reminder = ReminderStore.mutate(file, (store) => {
                 const existing = store.reminders.find((candidate) => candidate.reminderId === reminderId);
                 if (existing)
@@ -107,6 +109,9 @@ class HostInteractionOrchestrator {
                     status: "scheduled",
                     msgRef: run.message_id,
                     msgPermalink: null,
+                    deliveryTarget,
+                    deliveryAnchor,
+                    deliveryMode: "user",
                     repeat: null,
                     tz: null,
                     channel: run.chat_id,
@@ -114,7 +119,9 @@ class HostInteractionOrchestrator {
                     version: 1,
                     events: [],
                 };
-                ReminderStore.appendEvent(created, "scheduled", "interaction", run.run_id, created.fireAt, current);
+                ReminderStore.appendEvent(created, "scheduled", "interaction", run.run_id, created.fireAt, current, {
+                    deliveryTarget, deliveryAnchor, deliveryMode: "user",
+                });
                 store.reminders.push(created);
                 return created;
             }, Math.max(1, Math.min(350, deadline - this.now() - 100)));

package/dist/feishu/interaction-orchestrator.mjs

@@ -57,6 +57,8 @@ export class HostInteractionOrchestrator {
             const reminderId = `int_${createHash("sha256").update(run.run_id).digest("hex").slice(0, 24)}`;
             const current = this.now();
             const fireAt = effect.args.fire_at ? Date.parse(effect.args.fire_at) : current + Number(effect.args.delay_seconds) * 1_000;
+            const deliveryTarget = typeof run.chat_id === "string" && run.chat_id ? `chat:${run.chat_id}` : null;
+            const deliveryAnchor = typeof run.message_id === "string" && /^om_[A-Za-z0-9_-]+$/.test(run.message_id) ? run.message_id : null;
             const reminder = ReminderStore.mutate(file, (store) => {
                 const existing = store.reminders.find((candidate) => candidate.reminderId === reminderId);
                 if (existing)
@@ -71,6 +73,9 @@ export class HostInteractionOrchestrator {
                     status: "scheduled",
                     msgRef: run.message_id,
                     msgPermalink: null,
+                    deliveryTarget,
+                    deliveryAnchor,
+                    deliveryMode: "user",
                     repeat: null,
                     tz: null,
                     channel: run.chat_id,
@@ -78,7 +83,9 @@ export class HostInteractionOrchestrator {
                     version: 1,
                     events: [],
                 };
-                ReminderStore.appendEvent(created, "scheduled", "interaction", run.run_id, created.fireAt, current);
+                ReminderStore.appendEvent(created, "scheduled", "interaction", run.run_id, created.fireAt, current, {
+                    deliveryTarget, deliveryAnchor, deliveryMode: "user",
+                });
                 store.reminders.push(created);
                 return created;
             }, Math.max(1, Math.min(350, deadline - this.now() - 100)));

package/dist/feishu/outbound-transport.cjs

@@ -155,16 +155,30 @@ function createOutboundTransport(options) {
     };
     const handleSend = (body) => {
         const target = body.target || "";
+        const targetKey = String(target);
+        const report = (succeeded, details = {}) => {
+            if (options.dryRun)
+                return;
+            try {
+                options.onDeliveryOutcome?.({ target: targetKey, succeeded, ...details });
+            }
+            catch (error) {
+                options.log("delivery outcome hook 失败:", error.message);
+            }
+        };
         const content = String(body.content ?? "").replace(/\n+$/, "");
         const chatId = options.resolveChatId(target);
         if (!chatId) {
-            return { ok: false, status: 400, error: `该 target 没有已知 chat_id：${JSON.stringify(target)}。只能回复 canonical Inbox 给出的确切会话；不会兜底发往默认群。` };
+            const error = `该 target 没有已知 chat_id：${JSON.stringify(target)}。只能回复 canonical Inbox 给出的确切会话；不会兜底发往默认群。`;
+            report(false, { reason: error });
+            return { ok: false, status: 400, error };
         }
         const idempotencyKey = body.idempotencyKey
             || node_crypto_1.default.createHash("sha256").update(`${String(target)}\0${content}`).digest("hex").slice(0, 32);
         const replyContext = options.replyContextFor(String(target)) || options.replyContextFor(chatId);
         const attachmentIds = Array.isArray(body.attachmentIds) ? body.attachmentIds.filter(Boolean) : [];
         let messageId = "sent";
+        let committedProviderCalls = 0;
         if (content !== "" || attachmentIds.length === 0) {
             const replyInThread = Boolean(replyContext?.in_topic && replyContext.reply_to);
             const result = replyInThread
@@ -172,7 +186,9 @@ function createOutboundTransport(options) {
                 : options.sendText(chatId, content, idempotencyKey);
             if (result.code !== 0) {
                 options.log("send 失败 FULL:", `${result.stdout || ""} || ${result.stderr || ""}`);
-                return { ok: false, status: 502, error: `lark-cli send failed: ${(result.stdout || result.stderr || "").trim().split("\n")[0]}` };
+                const error = `lark-cli send failed: ${(result.stdout || result.stderr || "").trim().split("\n")[0]}`;
+                report(false, { reason: error });
+                return { ok: false, status: 502, error };
             }
             try {
                 const parsed = JSON.parse(result.stdout);
@@ -181,8 +197,10 @@ function createOutboundTransport(options) {
             catch {
                 messageId = options.dryRun ? "dryrun" : "sent";
             }
+            committedProviderCalls += 1;
             options.log(`${replyInThread ? "reply-in-thread" : "send"} → chat=${chatId} len=${content.length} id=${messageId}${options.dryRun ? " (dry-run)" : ""}`);
         }
+        const missingAttachmentIds = [];
         if (attachmentIds.length) {
             const index = loadAttachmentIndex();
             for (let position = 0; position < attachmentIds.length; position += 1) {
@@ -190,21 +208,34 @@ function createOutboundTransport(options) {
                 const attachment = index[attachmentId];
                 if (!attachment) {
                     options.log(`attachment 未找到 id=${attachmentId}（跳过）`);
+                    missingAttachmentIds.push(attachmentId);
                     continue;
                 }
                 const result = options.sendMedia(chatId, replyContext, attachment, `${idempotencyKey}:a${position}`);
                 if (result.code !== 0) {
                     options.log("attachment 发送失败 FULL:", `${result.stdout || ""} || ${result.stderr || ""}`);
-                    return { ok: false, status: 502, error: `lark-cli 发送附件失败: ${(result.stdout || result.stderr || "").trim().split("\n")[0]}` };
+                    const error = `lark-cli 发送附件失败: ${(result.stdout || result.stderr || "").trim().split("\n")[0]}`;
+                    report(false, { reason: error });
+                    return { ok: false, status: 502, error };
                 }
                 try {
                     const parsed = JSON.parse(result.stdout);
                     messageId = parsed?.data?.message_id || messageId;
                 }
                 catch { /* retain prior message id */ }
+                committedProviderCalls += 1;
                 options.log(`attach → chat=${chatId} name=${attachment.filename} id=${messageId}${options.dryRun ? " (dry-run)" : ""}`);
             }
         }
+        // Empty content plus attachment IDs that are all absent from the index
+        // reaches this point without any provider call; claiming success here would
+        // record delivery_succeeded for a reminder turn in which the user received
+        // nothing.
+        if (committedProviderCalls === 0) {
+            const error = `没有可发送的内容：附件不存在（${missingAttachmentIds.join(", ")}），且消息正文为空。`;
+            report(false, { reason: error });
+            return { ok: false, status: 400, error };
+        }
         options.appendConversation({
             direction: "out",
             from: options.botDisplayName() || options.agentName,
@@ -215,6 +246,9 @@ function createOutboundTransport(options) {
             messageId,
             at: new Date().toISOString(),
         });
+        // This is deliberately after every guarded provider call succeeds and after
+        // the local outbound projection, not at Runtime acceptance.
+        report(true, { messageId });
         return { ok: true, status: 200, data: { ok: true, state: "sent", messageId, messageSeq: 1 } };
     };
     return { handleSend, stageUpload };

package/dist/feishu/outbound-transport.mjs

@@ -149,16 +149,30 @@ export function createOutboundTransport(options) {
     };
     const handleSend = (body) => {
         const target = body.target || "";
+        const targetKey = String(target);
+        const report = (succeeded, details = {}) => {
+            if (options.dryRun)
+                return;
+            try {
+                options.onDeliveryOutcome?.({ target: targetKey, succeeded, ...details });
+            }
+            catch (error) {
+                options.log("delivery outcome hook 失败:", error.message);
+            }
+        };
         const content = String(body.content ?? "").replace(/\n+$/, "");
         const chatId = options.resolveChatId(target);
         if (!chatId) {
-            return { ok: false, status: 400, error: `该 target 没有已知 chat_id：${JSON.stringify(target)}。只能回复 canonical Inbox 给出的确切会话；不会兜底发往默认群。` };
+            const error = `该 target 没有已知 chat_id：${JSON.stringify(target)}。只能回复 canonical Inbox 给出的确切会话；不会兜底发往默认群。`;
+            report(false, { reason: error });
+            return { ok: false, status: 400, error };
         }
         const idempotencyKey = body.idempotencyKey
             || crypto.createHash("sha256").update(`${String(target)}\0${content}`).digest("hex").slice(0, 32);
         const replyContext = options.replyContextFor(String(target)) || options.replyContextFor(chatId);
         const attachmentIds = Array.isArray(body.attachmentIds) ? body.attachmentIds.filter(Boolean) : [];
         let messageId = "sent";
+        let committedProviderCalls = 0;
         if (content !== "" || attachmentIds.length === 0) {
             const replyInThread = Boolean(replyContext?.in_topic && replyContext.reply_to);
             const result = replyInThread
@@ -166,7 +180,9 @@ export function createOutboundTransport(options) {
                 : options.sendText(chatId, content, idempotencyKey);
             if (result.code !== 0) {
                 options.log("send 失败 FULL:", `${result.stdout || ""} || ${result.stderr || ""}`);
-                return { ok: false, status: 502, error: `lark-cli send failed: ${(result.stdout || result.stderr || "").trim().split("\n")[0]}` };
+                const error = `lark-cli send failed: ${(result.stdout || result.stderr || "").trim().split("\n")[0]}`;
+                report(false, { reason: error });
+                return { ok: false, status: 502, error };
             }
             try {
                 const parsed = JSON.parse(result.stdout);
@@ -175,8 +191,10 @@ export function createOutboundTransport(options) {
             catch {
                 messageId = options.dryRun ? "dryrun" : "sent";
             }
+            committedProviderCalls += 1;
             options.log(`${replyInThread ? "reply-in-thread" : "send"} → chat=${chatId} len=${content.length} id=${messageId}${options.dryRun ? " (dry-run)" : ""}`);
         }
+        const missingAttachmentIds = [];
         if (attachmentIds.length) {
             const index = loadAttachmentIndex();
             for (let position = 0; position < attachmentIds.length; position += 1) {
@@ -184,21 +202,34 @@ export function createOutboundTransport(options) {
                 const attachment = index[attachmentId];
                 if (!attachment) {
                     options.log(`attachment 未找到 id=${attachmentId}（跳过）`);
+                    missingAttachmentIds.push(attachmentId);
                     continue;
                 }
                 const result = options.sendMedia(chatId, replyContext, attachment, `${idempotencyKey}:a${position}`);
                 if (result.code !== 0) {
                     options.log("attachment 发送失败 FULL:", `${result.stdout || ""} || ${result.stderr || ""}`);
-                    return { ok: false, status: 502, error: `lark-cli 发送附件失败: ${(result.stdout || result.stderr || "").trim().split("\n")[0]}` };
+                    const error = `lark-cli 发送附件失败: ${(result.stdout || result.stderr || "").trim().split("\n")[0]}`;
+                    report(false, { reason: error });
+                    return { ok: false, status: 502, error };
                 }
                 try {
                     const parsed = JSON.parse(result.stdout);
                     messageId = parsed?.data?.message_id || messageId;
                 }
                 catch { /* retain prior message id */ }
+                committedProviderCalls += 1;
                 options.log(`attach → chat=${chatId} name=${attachment.filename} id=${messageId}${options.dryRun ? " (dry-run)" : ""}`);
             }
         }
+        // Empty content plus attachment IDs that are all absent from the index
+        // reaches this point without any provider call; claiming success here would
+        // record delivery_succeeded for a reminder turn in which the user received
+        // nothing.
+        if (committedProviderCalls === 0) {
+            const error = `没有可发送的内容：附件不存在（${missingAttachmentIds.join(", ")}），且消息正文为空。`;
+            report(false, { reason: error });
+            return { ok: false, status: 400, error };
+        }
         options.appendConversation({
             direction: "out",
             from: options.botDisplayName() || options.agentName,
@@ -209,6 +240,9 @@ export function createOutboundTransport(options) {
             messageId,
             at: new Date().toISOString(),
         });
+        // This is deliberately after every guarded provider call succeeds and after
+        // the local outbound projection, not at Runtime acceptance.
+        report(true, { messageId });
         return { ok: true, status: 200, data: { ok: true, state: "sent", messageId, messageSeq: 1 } };
     };
     return { handleSend, stageUpload };

package/dist/runtime/runtime-host.cjs

@@ -9,6 +9,7 @@ const node_crypto_1 = __importDefault(require("node:crypto"));
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const agent_cli_capabilities_js_1 = require("../agent/agent-cli-capabilities.cjs");
+const reminder_delivery_audit_js_1 = require("../agent/reminder-delivery-audit.cjs");
 const inbox_projection_js_1 = require("../agent/inbox-projection.cjs");
 const api_1 = require("@opentelemetry/api");
 const provider_error_classifier_js_1 = require("./provider-error-classifier.cjs");
@@ -1071,6 +1072,33 @@ function createRuntimeHost(options) {
         agent.piProactiveCompaction = tracked;
         return tracked;
     };
+    // Reminder audit contexts are in-turn capabilities. Finalize any survivors
+    // at both turn boundaries: turn end reconciles the turn that consumed them,
+    // and turn start expires contexts left by a crashed/aborted prior turn so a
+    // direct outbound cannot be falsely attributed to a stale reminder.
+    const finalizeReminderContexts = (agent, reason) => {
+        const legacyReminder = agent.stateStore?.resolveCurrentReminders ? null : agent.stateStore?.resolveCurrentReminder?.() ?? null;
+        const reminderContexts = agent.stateStore?.resolveCurrentReminders?.() ?? (legacyReminder ? [legacyReminder] : []);
+        let reminderAuditComplete = true;
+        if (agent.stateStore?.paths?.reminders && agent.stateStore.clearCurrentReminder) {
+            for (const reminder of reminderContexts) {
+                try {
+                    (0, reminder_delivery_audit_js_1.auditReminderDelivery)({ stateStore: agent.stateStore, agentId: agent.config.agentId,
+                        reminderId: reminder.reminderId, deliveryAnchor: reminder.deliveryAnchor, target: reminder.deliveryTarget,
+                        succeeded: reminder.deliveryCommitted === true, finalize: true,
+                        ...(reminder.deliveryMessageId ? { messageId: reminder.deliveryMessageId } : {}),
+                        ...(!reminder.deliveryCommitted ? { reason } : {}) });
+                }
+                catch {
+                    // Retain the context if the failure could not be durably recorded;
+                    // a later matching outbound or turn can reconcile it.
+                    reminderAuditComplete = false;
+                }
+            }
+        }
+        if (reminderAuditComplete)
+            agent.stateStore?.clearCurrentReminders?.();
+    };
     const observe = (agent, session, event) => {
         if (agent.session !== session)
             return; // Ignore late output from a replaced child.
@@ -1113,6 +1141,10 @@ function createRuntimeHost(options) {
                 ...(event.model ? { model: event.model } : {}), ...(event.reasoningEffort ? { reasoningEffort: event.reasoningEffort } : {}) });
         }
         else if (event.type === "turn-start") {
+            // Clear a source left by a crashed/aborted prior turn before a new turn
+            // can execute a direct task without an Inbox poll.
+            agent.stateStore?.clearCurrentInboxSource?.();
+            finalizeReminderContexts(agent, "Runtime turn started before a prior turn reconciled this reminder delivery");
             agent.busy = true;
             agent.turnInProgress = true;
             agent.turnHadFailure = false;
@@ -1134,6 +1166,11 @@ function createRuntimeHost(options) {
             agent.busy = false;
             emit({ type: "activity", agentId: agent.config.agentId, activity: "idle", activityKind: "idle", detailKind: "turn_ended" });
             reconcileAcceptedAtTurnEnd(agent);
+            // last_source and reminder audit contexts are in-turn capabilities,
+            // never cross-turn defaults. A later direct Runtime task must fail
+            // closed instead of inheriting a previous turn's chat or reminder.
+            agent.stateStore?.clearCurrentInboxSource?.();
+            finalizeReminderContexts(agent, "Runtime turn ended without a matching Feishu write");
             if (agent.backgroundCompletionInFlight) {
                 if (agent.turnHadFailure)
                     failBackgroundCompletionWake(agent);

package/dist/runtime/runtime-host.mjs

@@ -2,6 +2,7 @@ import crypto from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";
 import { agentCliPromptCapabilities } from "../agent/agent-cli-capabilities.mjs";
+import { auditReminderDelivery } from "../agent/reminder-delivery-audit.mjs";
 import { isCanonicalInboxTarget, targetKeyOfInboxEnvelope } from "../agent/inbox-projection.mjs";
 import { SpanKind } from "@opentelemetry/api";
 import { buildStrictProviderErrorInput, classifyStrictProviderError } from "./provider-error-classifier.mjs";
@@ -1062,6 +1063,33 @@ export function createRuntimeHost(options) {
         agent.piProactiveCompaction = tracked;
         return tracked;
     };
+    // Reminder audit contexts are in-turn capabilities. Finalize any survivors
+    // at both turn boundaries: turn end reconciles the turn that consumed them,
+    // and turn start expires contexts left by a crashed/aborted prior turn so a
+    // direct outbound cannot be falsely attributed to a stale reminder.
+    const finalizeReminderContexts = (agent, reason) => {
+        const legacyReminder = agent.stateStore?.resolveCurrentReminders ? null : agent.stateStore?.resolveCurrentReminder?.() ?? null;
+        const reminderContexts = agent.stateStore?.resolveCurrentReminders?.() ?? (legacyReminder ? [legacyReminder] : []);
+        let reminderAuditComplete = true;
+        if (agent.stateStore?.paths?.reminders && agent.stateStore.clearCurrentReminder) {
+            for (const reminder of reminderContexts) {
+                try {
+                    auditReminderDelivery({ stateStore: agent.stateStore, agentId: agent.config.agentId,
+                        reminderId: reminder.reminderId, deliveryAnchor: reminder.deliveryAnchor, target: reminder.deliveryTarget,
+                        succeeded: reminder.deliveryCommitted === true, finalize: true,
+                        ...(reminder.deliveryMessageId ? { messageId: reminder.deliveryMessageId } : {}),
+                        ...(!reminder.deliveryCommitted ? { reason } : {}) });
+                }
+                catch {
+                    // Retain the context if the failure could not be durably recorded;
+                    // a later matching outbound or turn can reconcile it.
+                    reminderAuditComplete = false;
+                }
+            }
+        }
+        if (reminderAuditComplete)
+            agent.stateStore?.clearCurrentReminders?.();
+    };
     const observe = (agent, session, event) => {
         if (agent.session !== session)
             return; // Ignore late output from a replaced child.
@@ -1104,6 +1132,10 @@ export function createRuntimeHost(options) {
                 ...(event.model ? { model: event.model } : {}), ...(event.reasoningEffort ? { reasoningEffort: event.reasoningEffort } : {}) });
         }
         else if (event.type === "turn-start") {
+            // Clear a source left by a crashed/aborted prior turn before a new turn
+            // can execute a direct task without an Inbox poll.
+            agent.stateStore?.clearCurrentInboxSource?.();
+            finalizeReminderContexts(agent, "Runtime turn started before a prior turn reconciled this reminder delivery");
             agent.busy = true;
             agent.turnInProgress = true;
             agent.turnHadFailure = false;
@@ -1125,6 +1157,11 @@ export function createRuntimeHost(options) {
             agent.busy = false;
             emit({ type: "activity", agentId: agent.config.agentId, activity: "idle", activityKind: "idle", detailKind: "turn_ended" });
             reconcileAcceptedAtTurnEnd(agent);
+            // last_source and reminder audit contexts are in-turn capabilities,
+            // never cross-turn defaults. A later direct Runtime task must fail
+            // closed instead of inheriting a previous turn's chat or reminder.
+            agent.stateStore?.clearCurrentInboxSource?.();
+            finalizeReminderContexts(agent, "Runtime turn ended without a matching Feishu write");
             if (agent.backgroundCompletionInFlight) {
                 if (agent.turnHadFailure)
                     failBackgroundCompletionWake(agent);

package/package.json

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