larkin 0.5.3 → 0.5.4

package/dist/feishu/host-shell.cjs

@@ -424,13 +424,57 @@ function createHostShell({ env = process.env, runtimeHost, channelPackage, event
     for (const agent of agents)
         prepareAgentState(agent);
     const reminder = new host_reminder_orchestrator_js_1.HostReminderOrchestrator({ agents, stateStore, envelopeProjector, deliveryTarget: runtimeHost, log });
+    const auditRegistry = (0, missed_outbound_scan_js_1.inboxAuditRegistryFile)(larkinHome);
+    const auditRetryJournal = (0, missed_outbound_scan_js_1.inboxAuditRetryFile)(larkinHome);
+    let auditRetryTimer = null;
+    let auditRetryAttempt = 0;
+    const reconcileAuditRetries = () => {
+        try {
+            return (0, missed_outbound_scan_js_1.reconcileInboxAuditTargetRetries)(auditRegistry, auditRetryJournal).remaining;
+        }
+        catch (error) {
+            log(`inbox audit retry 读取失败: ${(0, inbox_audit_heartbeat_js_1.boundedInboxAuditDiagnostic)(error)}`);
+            return 1;
+        }
+    };
+    const scheduleAuditRetry = () => {
+        if (auditRetryTimer || auditRetryAttempt >= 5)
+            return;
+        const delay = [100, 250, 1_000, 3_000, 10_000][auditRetryAttempt++];
+        auditRetryTimer = setTimeout(() => {
+            auditRetryTimer = null;
+            if (reconcileAuditRetries() > 0)
+                scheduleAuditRetry();
+            else
+                auditRetryAttempt = 0;
+        }, delay);
+        auditRetryTimer.unref?.();
+    };
     const inboxAudit = new inbox_audit_heartbeat_js_1.InboxAuditHeartbeat({
         agents,
         stateStore,
         runtimeHost,
         log,
+        configFile: node_path_1.default.join(larkinHome, "config.json"),
+        schedule(agent) {
+            try {
+                return (0, config_js_1.resolveInboxAuditSchedule)((0, config_js_1.loadConfig)(env).config, agent.agentId);
+            }
+            catch (error) {
+                log(`inbox audit schedule 读取失败 agent=${agent.agentId}: ${errorMessage(error)}`);
+                return { enabled: false, intervalMs: inbox_audit_heartbeat_js_1.INBOX_AUDIT_CADENCE_MS };
+            }
+        },
+        shouldDispatch(agent) {
+            try {
+                return (0, missed_outbound_scan_js_1.hasPendingInboxAuditTargets)(auditRegistry, agent.agentId);
+            }
+            catch (error) {
+                log(`inbox audit pending 读取失败 agent=${agent.agentId}: ${errorMessage(error)}`);
+                return false;
+            }
+        },
     });
-    const auditRegistry = (0, missed_outbound_scan_js_1.inboxAuditRegistryFile)(larkinHome);
     const seenEventIds = new Set();
     const inFlightEventIds = new Set();
     const onFeishuMessage = async (agent, event, options) => {
@@ -477,14 +521,23 @@ function createHostShell({ env = process.env, runtimeHost, channelPackage, event
                 // append/dedupe decision is durable. Agent model-seen state is untouched.
                 if (event.event_id)
                     seenEventIds.add(eventKey);
+                if (append.status === "duplicate_consumed")
+                    return null;
+                const auditSourceSeq = Number(append.envelope.target_seq);
                 try {
-                    (0, missed_outbound_scan_js_1.observeInboxAuditTarget)(auditRegistry, agent.agentId, event);
+                    (0, missed_outbound_scan_js_1.observeInboxAuditTarget)(auditRegistry, agent.agentId, { ...event, wake, source_seq: auditSourceSeq });
+                    (0, missed_outbound_scan_js_1.discardInboxAuditTargetRetry)(auditRetryJournal, agent.agentId, { ...event, source_seq: auditSourceSeq });
                 }
                 catch (error) {
-                    log(`inbox audit target 未持久化: ${error.message}`);
+                    try {
+                        (0, missed_outbound_scan_js_1.enqueueInboxAuditTargetRetry)(auditRetryJournal, agent.agentId, { ...event, wake, source_seq: auditSourceSeq });
+                        scheduleAuditRetry();
+                        log(`inbox audit target 延后重试: ${(0, inbox_audit_heartbeat_js_1.boundedInboxAuditDiagnostic)(error)}`);
+                    }
+                    catch (retryError) {
+                        log(`inbox audit target 未持久化: ${(0, inbox_audit_heartbeat_js_1.boundedInboxAuditDiagnostic)(retryError)}`);
+                    }
                 }
-                if (append.status === "duplicate_consumed")
-                    return null;
                 const inboxEnvelope = append.envelope;
                 if (append.status === "appended")
                     hostState.appendConversation(agent, {
@@ -1452,6 +1505,9 @@ function createHostShell({ env = process.env, runtimeHost, channelPackage, event
             eventSourceStartTimer = null;
             await Promise.resolve(eventSourceStop());
             reminder.stopSync();
+            if (auditRetryTimer)
+                clearTimeout(auditRetryTimer);
+            auditRetryTimer = null;
             inboxAudit.stop();
             interaction.stopSync();
             await runtimeHost.shutdown(reason);
@@ -1670,6 +1726,8 @@ function createHostShell({ env = process.env, runtimeHost, channelPackage, event
                     previousSession: agentStates.get(agent.agentId)?.state.previousSessions?.[agent.runtime] ?? null,
                 })));
                 reminder.startSync();
+                if (reconcileAuditRetries() > 0)
+                    scheduleAuditRetry();
                 inboxAudit.start();
                 interaction.startSync();
                 eventSourceStartTimer = setTimeout(() => { eventSourceStartTimer = null; startEventSource(); }, eventSourceStartDelayMs);

package/dist/feishu/host-shell.mjs

@@ -11,15 +11,15 @@ import { HostEnvelopeProjector, HostStateProjection, SenderIdentityCache, projec
 import { ProcessingEyeOrchestrator } from "./host-processing-eye.mjs";
 import { projectInboxEnvelope, targetKeyOfInboxEnvelope } from "../agent/inbox-projection.mjs";
 import { HostReminderOrchestrator } from "../agent/host-reminder-orchestrator.mjs";
-import { InboxAuditHeartbeat } from "../agent/inbox-audit-heartbeat.mjs";
-import { inboxAuditRegistryFile, observeInboxAuditTarget } from "../agent/missed-outbound-scan.mjs";
+import { boundedInboxAuditDiagnostic, InboxAuditHeartbeat, INBOX_AUDIT_CADENCE_MS } from "../agent/inbox-audit-heartbeat.mjs";
+import { discardInboxAuditTargetRetry, enqueueInboxAuditTargetRetry, hasPendingInboxAuditTargets, inboxAuditRegistryFile, inboxAuditRetryFile, observeInboxAuditTarget, reconcileInboxAuditTargetRetries } from "../agent/missed-outbound-scan.mjs";
 import { HostChannelBusiness } from "./host-channel-business.mjs";
 import { HostInteractionOrchestrator } from "./interaction-orchestrator.mjs";
 import { targetFor } from "./message-policy.mjs";
 import { authFailureAppliesTo, parsePersistedAuthFailure, providerAuthenticationFailureReadiness, readinessForPersistedAuthFailure, RuntimePrerequisiteError, } from "../runtime/runtime-readiness.mjs";
 import { safeProviderDiagnostic } from "../runtime/provider-error-classifier.mjs";
 import { readDocumentCommentSubscription, verifyCallbackProbe } from "../platform/callback-capability.mjs";
-import { loadConfig, resolveMentionPolicy } from "../platform/config.mjs";
+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";
@@ -384,13 +384,57 @@ export function createHostShell({ env = process.env, runtimeHost, channelPackage
     for (const agent of agents)
         prepareAgentState(agent);
     const reminder = new HostReminderOrchestrator({ agents, stateStore, envelopeProjector, deliveryTarget: runtimeHost, log });
+    const auditRegistry = inboxAuditRegistryFile(larkinHome);
+    const auditRetryJournal = inboxAuditRetryFile(larkinHome);
+    let auditRetryTimer = null;
+    let auditRetryAttempt = 0;
+    const reconcileAuditRetries = () => {
+        try {
+            return reconcileInboxAuditTargetRetries(auditRegistry, auditRetryJournal).remaining;
+        }
+        catch (error) {
+            log(`inbox audit retry 读取失败: ${boundedInboxAuditDiagnostic(error)}`);
+            return 1;
+        }
+    };
+    const scheduleAuditRetry = () => {
+        if (auditRetryTimer || auditRetryAttempt >= 5)
+            return;
+        const delay = [100, 250, 1_000, 3_000, 10_000][auditRetryAttempt++];
+        auditRetryTimer = setTimeout(() => {
+            auditRetryTimer = null;
+            if (reconcileAuditRetries() > 0)
+                scheduleAuditRetry();
+            else
+                auditRetryAttempt = 0;
+        }, delay);
+        auditRetryTimer.unref?.();
+    };
     const inboxAudit = new InboxAuditHeartbeat({
         agents,
         stateStore,
         runtimeHost,
         log,
+        configFile: path.join(larkinHome, "config.json"),
+        schedule(agent) {
+            try {
+                return resolveInboxAuditSchedule(loadConfig(env).config, agent.agentId);
+            }
+            catch (error) {
+                log(`inbox audit schedule 读取失败 agent=${agent.agentId}: ${errorMessage(error)}`);
+                return { enabled: false, intervalMs: INBOX_AUDIT_CADENCE_MS };
+            }
+        },
+        shouldDispatch(agent) {
+            try {
+                return hasPendingInboxAuditTargets(auditRegistry, agent.agentId);
+            }
+            catch (error) {
+                log(`inbox audit pending 读取失败 agent=${agent.agentId}: ${errorMessage(error)}`);
+                return false;
+            }
+        },
     });
-    const auditRegistry = inboxAuditRegistryFile(larkinHome);
     const seenEventIds = new Set();
     const inFlightEventIds = new Set();
     const onFeishuMessage = async (agent, event, options) => {
@@ -437,14 +481,23 @@ export function createHostShell({ env = process.env, runtimeHost, channelPackage
                 // append/dedupe decision is durable. Agent model-seen state is untouched.
                 if (event.event_id)
                     seenEventIds.add(eventKey);
+                if (append.status === "duplicate_consumed")
+                    return null;
+                const auditSourceSeq = Number(append.envelope.target_seq);
                 try {
-                    observeInboxAuditTarget(auditRegistry, agent.agentId, event);
+                    observeInboxAuditTarget(auditRegistry, agent.agentId, { ...event, wake, source_seq: auditSourceSeq });
+                    discardInboxAuditTargetRetry(auditRetryJournal, agent.agentId, { ...event, source_seq: auditSourceSeq });
                 }
                 catch (error) {
-                    log(`inbox audit target 未持久化: ${error.message}`);
+                    try {
+                        enqueueInboxAuditTargetRetry(auditRetryJournal, agent.agentId, { ...event, wake, source_seq: auditSourceSeq });
+                        scheduleAuditRetry();
+                        log(`inbox audit target 延后重试: ${boundedInboxAuditDiagnostic(error)}`);
+                    }
+                    catch (retryError) {
+                        log(`inbox audit target 未持久化: ${boundedInboxAuditDiagnostic(retryError)}`);
+                    }
                 }
-                if (append.status === "duplicate_consumed")
-                    return null;
                 const inboxEnvelope = append.envelope;
                 if (append.status === "appended")
                     hostState.appendConversation(agent, {
@@ -1412,6 +1465,9 @@ export function createHostShell({ env = process.env, runtimeHost, channelPackage
             eventSourceStartTimer = null;
             await Promise.resolve(eventSourceStop());
             reminder.stopSync();
+            if (auditRetryTimer)
+                clearTimeout(auditRetryTimer);
+            auditRetryTimer = null;
             inboxAudit.stop();
             interaction.stopSync();
             await runtimeHost.shutdown(reason);
@@ -1630,6 +1686,8 @@ export function createHostShell({ env = process.env, runtimeHost, channelPackage
                     previousSession: agentStates.get(agent.agentId)?.state.previousSessions?.[agent.runtime] ?? null,
                 })));
                 reminder.startSync();
+                if (reconcileAuditRetries() > 0)
+                    scheduleAuditRetry();
                 inboxAudit.start();
                 interaction.startSync();
                 eventSourceStartTimer = setTimeout(() => { eventSourceStartTimer = null; startEventSource(); }, eventSourceStartDelayMs);

package/dist/platform/config.cjs

@@ -36,12 +36,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toUserRuntime = exports.runtimeOptionTarget = exports.runtimeOptionOf = exports.isUserRuntime = exports.isAdapterRuntime = exports.fromUserRuntime = exports.RUNTIME_OPTIONS = void 0;
+exports.MAX_INBOX_AUDIT_INTERVAL_MS = exports.MIN_INBOX_AUDIT_INTERVAL_MS = exports.DEFAULT_INBOX_AUDIT_INTERVAL_MS = exports.toUserRuntime = exports.runtimeOptionTarget = exports.runtimeOptionOf = exports.isUserRuntime = exports.isAdapterRuntime = exports.fromUserRuntime = exports.RUNTIME_OPTIONS = void 0;
 exports.loadRuntimeModels = loadRuntimeModels;
 exports.defaultModelFor = defaultModelFor;
 exports.resolveConfigDir = resolveConfigDir;
 exports.resolveLarkConfigDir = resolveLarkConfigDir;
 exports.resolveRuntimeAuthority = resolveRuntimeAuthority;
+exports.assertInboxAuditInterval = assertInboxAuditInterval;
+exports.parseInboxAuditInterval = parseInboxAuditInterval;
+exports.formatInboxAuditInterval = formatInboxAuditInterval;
+exports.inboxAuditMutationFromCli = inboxAuditMutationFromCli;
 exports.hydrateAgent = hydrateAgent;
 exports.normalizeConfig = normalizeConfig;
 exports.assertPrivateConfigMetadata = assertPrivateConfigMetadata;
@@ -50,6 +54,7 @@ exports.selectAgent = selectAgent;
 exports.toStored = toStored;
 exports.resolveMentionPolicy = resolveMentionPolicy;
 exports.resolveAgentGlobalMentionPolicy = resolveAgentGlobalMentionPolicy;
+exports.resolveInboxAuditSchedule = resolveInboxAuditSchedule;
 exports.runtimeConfigSignature = runtimeConfigSignature;
 exports.configApplyState = configApplyState;
 exports.markConfigApplied = markConfigApplied;
@@ -76,11 +81,16 @@ Object.defineProperty(exports, "isUserRuntime", { enumerable: true, get: functio
 Object.defineProperty(exports, "runtimeOptionOf", { enumerable: true, get: function () { return user_runtime_js_2.runtimeOptionOf; } });
 Object.defineProperty(exports, "runtimeOptionTarget", { enumerable: true, get: function () { return user_runtime_js_2.runtimeOptionTarget; } });
 Object.defineProperty(exports, "toUserRuntime", { enumerable: true, get: function () { return user_runtime_js_2.toUserRuntime; } });
+exports.DEFAULT_INBOX_AUDIT_INTERVAL_MS = 15 * 60_000;
+exports.MIN_INBOX_AUDIT_INTERVAL_MS = 60_000;
+exports.MAX_INBOX_AUDIT_INTERVAL_MS = 24 * 60 * 60_000;
 const TOP_FIELDS_V3 = new Set(["version", "serverId", "activeAgent", "agents"]);
 const TOP_FIELDS_V4 = new Set(["version", "serverId", "mentionPolicy", "activeAgent", "agents"]);
+const OPTIONAL_TOP_FIELDS_V4 = new Set(["inboxAudit"]);
 const AGENT_FIELDS_V3 = new Set(["runtime", "model", "effort", "noMentionChats", "createdAt"]);
-const AGENT_FIELDS_V4 = new Set(["runtime", "model", "effort", "mentionPolicy", "chatMentionPolicies", "createdAt"]);
+const AGENT_FIELDS_V4 = new Set(["runtime", "model", "effort", "mentionPolicy", "chatMentionPolicies", "inboxAudit", "createdAt"]);
 const LEGACY_AGENT_FIELDS = new Set(["piDistribution", "runtimeOption"]);
+const INBOX_AUDIT_FIELDS = new Set(["enabled", "intervalMs"]);
 const APP_ID = /^cli_[A-Za-z0-9]+$/;
 const CHAT_ID = /^oc_[A-Za-z0-9_-]+$/;
 const PI_EFFORTS = new Set(["off", "minimal", "low", "medium", "high", "xhigh", "max"]);
@@ -144,6 +154,85 @@ function assertPolicy(value, label) {
     if (value !== "require" && value !== "free")
         throw new Error(`${label} 只允许 require/free`);
 }
+function assertInboxAuditInterval(value, label = "inbox-audit interval") {
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < exports.MIN_INBOX_AUDIT_INTERVAL_MS || value > exports.MAX_INBOX_AUDIT_INTERVAL_MS) {
+        throw new Error(`${label} 必须是 ${exports.MIN_INBOX_AUDIT_INTERVAL_MS}–${exports.MAX_INBOX_AUDIT_INTERVAL_MS} 毫秒`);
+    }
+}
+function parseInboxAuditInterval(value) {
+    if (typeof value !== "string" || !value)
+        throw new Error("inbox-audit interval 不能为空");
+    let milliseconds;
+    if (/^[1-9]\d*$/.test(value))
+        milliseconds = Number(value);
+    else {
+        const match = /^([1-9]\d*)(m|h)$/.exec(value);
+        if (!match)
+            throw new Error("inbox-audit interval 只允许 15m/1h 或 60000–86400000 毫秒");
+        milliseconds = Number(match[1]) * (match[2] === "h" ? 3_600_000 : 60_000);
+    }
+    assertInboxAuditInterval(milliseconds);
+    return milliseconds;
+}
+function formatInboxAuditInterval(intervalMs) {
+    if (intervalMs % 3_600_000 === 0)
+        return `${intervalMs / 3_600_000}h`;
+    if (intervalMs % 60_000 === 0)
+        return `${intervalMs / 60_000}m`;
+    return `${intervalMs}ms`;
+}
+function parseStoredInboxAudit(value, label) {
+    if (!isPlainObject(value))
+        throw new Error(`${label} 必须是普通 object`);
+    assertAllowedFields(value, INBOX_AUDIT_FIELDS, label);
+    const settings = {};
+    if (Object.hasOwn(value, "enabled")) {
+        if (typeof value.enabled !== "boolean")
+            throw new Error(`${label}.enabled 必须是 boolean`);
+        settings.enabled = value.enabled;
+    }
+    if (Object.hasOwn(value, "intervalMs")) {
+        assertInboxAuditInterval(value.intervalMs, `${label}.intervalMs`);
+        settings.intervalMs = value.intervalMs;
+    }
+    return settings;
+}
+function resolvedInboxAudit(settings) {
+    return {
+        enabled: settings?.enabled ?? false,
+        intervalMs: settings?.intervalMs ?? exports.DEFAULT_INBOX_AUDIT_INTERVAL_MS,
+    };
+}
+function inboxAuditMutationFromCli(input) {
+    if (input.scope === "global") {
+        if (input.enabled !== "on" && input.enabled !== "off") {
+            throw new Error("用法: larkin config inbox-audit global <on|off> [--interval <15m|1h>]");
+        }
+        const mutation = {
+            kind: "set-global-inbox-audit", enabled: input.enabled === "on",
+        };
+        if (input.interval !== undefined) {
+            if (input.interval === "inherit")
+                throw new Error("全局 inbox-audit 不支持 interval=inherit");
+            mutation.intervalMs = parseInboxAuditInterval(input.interval);
+        }
+        return mutation;
+    }
+    if (input.scope === "agent") {
+        if (input.enabled !== "on" && input.enabled !== "off" && input.enabled !== "inherit") {
+            throw new Error("用法: larkin config inbox-audit agent <inherit|on|off> [--agent <App ID>] [--interval <15m|inherit>]");
+        }
+        const mutation = {
+            kind: "set-agent-inbox-audit", agentId: input.agentId,
+            enabled: input.enabled === "inherit" ? "inherit" : input.enabled === "on",
+        };
+        if (input.interval !== undefined) {
+            mutation.intervalMs = input.interval === "inherit" ? "inherit" : parseInboxAuditInterval(input.interval);
+        }
+        return mutation;
+    }
+    throw new Error("inbox-audit scope 只支持 global/agent");
+}
 function assertModel(runtime, model) {
     if (model === "default")
         return;
@@ -211,6 +300,8 @@ function validateStoredAgent(key, agent, version) {
     }
     if (version === 4 && Object.hasOwn(agent, "mentionPolicy"))
         assertPolicy(agent.mentionPolicy, `Agent ${key}.mentionPolicy`);
+    if (version === 4 && Object.hasOwn(agent, "inboxAudit"))
+        parseStoredInboxAudit(agent.inboxAudit, `Agent ${key}.inboxAudit`);
     if (version === 4 && Object.hasOwn(agent, "chatMentionPolicies")) {
         if (!isPlainObject(agent.chatMentionPolicies))
             throw new Error(`Agent ${key}.chatMentionPolicies 必须是普通 object`);
@@ -239,6 +330,7 @@ function hydratedStoredAgent(key, agent, version) {
         model: agent.model,
         ...(typeof agent.effort === "string" ? { effort: agent.effort } : {}),
         ...(version === 4 && (agent.mentionPolicy === "require" || agent.mentionPolicy === "free") ? { mentionPolicy: agent.mentionPolicy } : {}),
+        ...(version === 4 && Object.hasOwn(agent, "inboxAudit") ? { inboxAudit: parseStoredInboxAudit(agent.inboxAudit, `Agent ${key}.inboxAudit`) } : {}),
         ...(Object.keys(chatMentionPolicies).length ? { chatMentionPolicies, noMentionChats: Object.entries(chatMentionPolicies).filter(([, policy]) => policy === "free").map(([chatId]) => chatId) } : {}),
         ...(typeof agent.createdAt === "string" ? { createdAt: agent.createdAt } : {}),
     };
@@ -252,6 +344,7 @@ function hydrateAgent(key, agent, configDir) {
         larkConfigDir: path.join(layout.agentStateDir(key), "lark-cli-config"),
         ...(agent.effort ? { effort: agent.effort } : {}),
         ...(agent.mentionPolicy ? { mentionPolicy: agent.mentionPolicy } : {}),
+        ...(agent.inboxAudit ? { inboxAudit: { ...agent.inboxAudit } } : {}),
         ...(agent.chatMentionPolicies ? { chatMentionPolicies: { ...agent.chatMentionPolicies } } : {}),
         ...(agent.noMentionChats ? { noMentionChats: [...agent.noMentionChats] } : {}),
         ...(agent.createdAt ? { createdAt: agent.createdAt } : {}),
@@ -270,7 +363,7 @@ function normalizeConfig(raw, configDir, { mint } = {}) {
     if (version !== 3 && version !== 4)
         throw new Error("不支持该配置格式：larkin 只接受 version=3/4");
     const topFields = version === 3 ? TOP_FIELDS_V3 : TOP_FIELDS_V4;
-    assertAllowedFields(raw, topFields, "config");
+    assertAllowedFields(raw, version === 4 ? new Set([...TOP_FIELDS_V4, ...OPTIONAL_TOP_FIELDS_V4]) : topFields, "config");
     for (const field of topFields)
         if (!Object.hasOwn(raw, field))
             throw new Error(`config 缺少必需字段 ${field}`);
@@ -289,8 +382,12 @@ function normalizeConfig(raw, configDir, { mint } = {}) {
     const agents = {};
     for (const [key, agent] of Object.entries(raw.agents))
         agents[key] = hydrateAgent(key, hydratedStoredAgent(key, agent, version), layout.root);
+    const inboxAudit = version === 4 && Object.hasOwn(raw, "inboxAudit")
+        ? resolvedInboxAudit(parseStoredInboxAudit(raw.inboxAudit, "config.inboxAudit"))
+        : undefined;
     return {
         version: 4, serverId: raw.serverId, mentionPolicy: version === 4 ? raw.mentionPolicy : "require",
+        ...(inboxAudit ? { inboxAudit } : {}),
         configDir: layout.configDir, larkinHome: layout.larkinHome, larkConfigDir: resolveLarkConfigDir({}, layout.root), activeAgent: raw.activeAgent, agents,
     };
 }
@@ -516,7 +613,11 @@ function selectAgent(config, env = process.env) {
     return agents[config.activeAgent];
 }
 function toStored(config) {
-    const out = { version: 4, serverId: config.serverId, mentionPolicy: config.mentionPolicy, activeAgent: config.activeAgent, agents: {} };
+    const out = {
+        version: 4, serverId: config.serverId, mentionPolicy: config.mentionPolicy, activeAgent: config.activeAgent, agents: {},
+    };
+    if (config.inboxAudit)
+        out.inboxAudit = { enabled: config.inboxAudit.enabled, intervalMs: config.inboxAudit.intervalMs };
     for (const [key, agent] of Object.entries(config.agents || {})) {
         const stored = { runtime: agent.runtime, model: agent.model };
         if (typeof agent.effort === "string" && agent.effort)
@@ -525,6 +626,9 @@ function toStored(config) {
             stored.mentionPolicy = agent.mentionPolicy;
         if (agent.chatMentionPolicies && Object.keys(agent.chatMentionPolicies).length)
             stored.chatMentionPolicies = { ...agent.chatMentionPolicies };
+        if (agent.inboxAudit && (agent.inboxAudit.enabled !== undefined || agent.inboxAudit.intervalMs !== undefined)) {
+            stored.inboxAudit = { ...agent.inboxAudit };
+        }
         if (typeof agent.createdAt === "string" && agent.createdAt)
             stored.createdAt = agent.createdAt;
         out.agents[key] = stored;
@@ -551,6 +655,20 @@ function resolveAgentGlobalMentionPolicy(config, agentId) {
         return { effective: agent.mentionPolicy, source: "agent" };
     return { effective: config.mentionPolicy, source: "global" };
 }
+function resolveInboxAuditSchedule(config, agentId) {
+    const agent = config.agents[agentId];
+    if (!agent)
+        throw new Error(`Agent 不存在：${agentId}`);
+    const enabled = agent.inboxAudit?.enabled ?? config.inboxAudit?.enabled ?? false;
+    const intervalMs = agent.inboxAudit?.intervalMs ?? config.inboxAudit?.intervalMs ?? exports.DEFAULT_INBOX_AUDIT_INTERVAL_MS;
+    assertInboxAuditInterval(intervalMs);
+    return {
+        enabled,
+        intervalMs,
+        enabledSource: agent.inboxAudit?.enabled !== undefined ? "agent" : config.inboxAudit ? "global" : "default",
+        intervalSource: agent.inboxAudit?.intervalMs !== undefined ? "agent" : config.inboxAudit?.intervalMs !== undefined ? "global" : "default",
+    };
+}
 function revision(bytes) {
     return `sha256:${crypto.createHash("sha256").update(bytes).digest("hex")}`;
 }
@@ -563,6 +681,7 @@ function agentSignature(config, agentId) {
         schema: 2,
         runtime: agent.runtime, model: agent.model, effort: agent.effort ?? null,
         globalMentionPolicy: config.mentionPolicy, agentMentionPolicy: agent.mentionPolicy ?? null, chatMentionPolicies: chats,
+        globalInboxAudit: config.inboxAudit ?? null, agentInboxAudit: agent.inboxAudit ?? null,
     }));
 }
 function runtimeConfigSignature(config, agentId) {
@@ -700,6 +819,19 @@ function applyMutation(config, mutation) {
         config.mentionPolicy = mutation.value;
         return { scope: "global", runtimeChange: false, affectedAgentIds: Object.keys(config.agents) };
     }
+    if (mutation.kind === "set-global-inbox-audit") {
+        if (mutation.enabled === undefined && mutation.intervalMs === undefined)
+            throw new Error("inbox-audit 全局变更必须包含 enabled 或 interval");
+        const current = resolvedInboxAudit(config.inboxAudit);
+        if (mutation.enabled !== undefined)
+            current.enabled = mutation.enabled;
+        if (mutation.intervalMs !== undefined) {
+            assertInboxAuditInterval(mutation.intervalMs, "全局 inbox-audit interval");
+            current.intervalMs = mutation.intervalMs;
+        }
+        config.inboxAudit = current;
+        return { scope: "global", runtimeChange: false, affectedAgentIds: Object.keys(config.agents) };
+    }
     if (!APP_ID.test(mutation.agentId) || !config.agents[mutation.agentId])
         throw new Error(`Agent 不存在：${mutation.agentId}`);
     const agent = config.agents[mutation.agentId];
@@ -712,6 +844,26 @@ function applyMutation(config, mutation) {
         }
         return { scope: "agent", agentId: mutation.agentId, runtimeChange: false, affectedAgentIds: [mutation.agentId] };
     }
+    if (mutation.kind === "set-agent-inbox-audit") {
+        if (mutation.enabled === undefined && mutation.intervalMs === undefined)
+            throw new Error("inbox-audit Agent 变更必须包含 enabled 或 interval");
+        const current = { ...(agent.inboxAudit || {}) };
+        if (mutation.enabled === "inherit")
+            delete current.enabled;
+        else if (mutation.enabled !== undefined)
+            current.enabled = mutation.enabled;
+        if (mutation.intervalMs === "inherit")
+            delete current.intervalMs;
+        else if (mutation.intervalMs !== undefined) {
+            assertInboxAuditInterval(mutation.intervalMs, "Agent inbox-audit interval");
+            current.intervalMs = mutation.intervalMs;
+        }
+        if (current.enabled === undefined && current.intervalMs === undefined)
+            delete agent.inboxAudit;
+        else
+            agent.inboxAudit = current;
+        return { scope: "agent", agentId: mutation.agentId, runtimeChange: false, affectedAgentIds: [mutation.agentId] };
+    }
     if (mutation.kind === "set-chat-mention") {
         if (!CHAT_ID.test(mutation.chatId))
             throw new Error(`群 ID 格式无效：${mutation.chatId}`);
@@ -1198,8 +1350,24 @@ function safeConfigView(config, onlyAgentId, chatId, applyState) {
             source: agent.mentionPolicy ? "agent" : "global",
             ...(chatId ? { chat: { chatId, override: agent.chatMentionPolicies?.[chatId] ?? "inherit", ...resolveMentionPolicy(config, agentId, chatId) } } : {}),
         },
+        inboxAudit: (() => {
+            const resolved = resolveInboxAuditSchedule(config, agentId);
+            return {
+                override: {
+                    enabled: agent.inboxAudit?.enabled === undefined ? "inherit" : agent.inboxAudit.enabled ? "on" : "off",
+                    intervalMs: agent.inboxAudit?.intervalMs ?? "inherit",
+                },
+                effective: { enabled: resolved.enabled, intervalMs: resolved.intervalMs },
+                source: { enabled: resolved.enabledSource, intervalMs: resolved.intervalSource },
+            };
+        })(),
         chatMentionPolicies: { ...(agent.chatMentionPolicies || {}) },
         apply: applyState?.agents?.[agentId] ?? { applyState: "unknown" },
     }));
-    return { version: 4, mentionPolicy: config.mentionPolicy, persistedRevision: applyState?.persistedRevision ?? "unknown", agents };
+    const inboxAudit = resolvedInboxAudit(config.inboxAudit);
+    return {
+        version: 4, mentionPolicy: config.mentionPolicy,
+        inboxAudit: { enabled: inboxAudit.enabled, intervalMs: inboxAudit.intervalMs },
+        persistedRevision: applyState?.persistedRevision ?? "unknown", agents,
+    };
 }