larkin 0.5.17 → 0.5.18

package/dist/feishu/host-shell.cjs

@@ -509,6 +509,15 @@ function createHostShell({ env = process.env, runtimeHost, channelPackage, event
     });
     const seenEventIds = new Set();
     const inFlightEventIds = new Set();
+    const processingEyeEnabled = (agent) => {
+        // 缺 key / 读配置失败都关闭，避免升级后继续自动点 OnIt。
+        try {
+            return (0, config_js_1.resolveProcessingEye)((0, config_js_1.loadConfig)(env).config, agent.agentId).enabled;
+        }
+        catch {
+            return false;
+        }
+    };
     const onFeishuMessage = async (agent, event, options) => {
         const wake = options?.wake !== false;
         const eventKey = `${agent.agentId}:${event.event_id || event.message_id || ""}`;
@@ -599,7 +608,8 @@ 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") {
+            if ((inboxEnvelope.sender_type === "human" || inboxEnvelope.sender_type === "agent")
+                && processingEyeEnabled(agent)) {
                 processingEyes.add(agent, String(inboxEnvelope.message_id || ""), {
                     replyInThread: String(inboxEnvelope.target || "").startsWith("thread:"),
                     target: String(inboxEnvelope.target || ""),

package/dist/feishu/host-shell.mjs

@@ -20,7 +20,7 @@ import { targetFor } from "./message-policy.mjs";
 import { authFailureAppliesTo, parsePersistedAuthFailure, providerAuthenticationFailureReadiness, readinessForPersistedAuthFailure, RuntimePrerequisiteError, } from "../runtime/runtime-readiness.mjs";
 import { providerFinishReason, safeProviderDiagnostic } from "../runtime/provider-error-classifier.mjs";
 import { readDocumentCommentSubscription, verifyCallbackProbe } from "../platform/callback-capability.mjs";
-import { loadConfig, resolveInboxAuditSchedule, resolveMentionPolicy } from "../platform/config.mjs";
+import { loadConfig, resolveInboxAuditSchedule, resolveMentionPolicy, resolveProcessingEye } from "../platform/config.mjs";
 import { processCommandToken } from "../app/internal-command.mjs";
 import { managedOfficialLarkCli } from "../app/agent-lark-cli-workspace.mjs";
 import { isChannelReconnecting, isRuntimeReadinessCurrent, isSessionCurrent } from "../app/agent-readiness.mjs";
@@ -468,6 +468,15 @@ export function createHostShell({ env = process.env, runtimeHost, channelPackage
     });
     const seenEventIds = new Set();
     const inFlightEventIds = new Set();
+    const processingEyeEnabled = (agent) => {
+        // 缺 key / 读配置失败都关闭，避免升级后继续自动点 OnIt。
+        try {
+            return resolveProcessingEye(loadConfig(env).config, agent.agentId).enabled;
+        }
+        catch {
+            return false;
+        }
+    };
     const onFeishuMessage = async (agent, event, options) => {
         const wake = options?.wake !== false;
         const eventKey = `${agent.agentId}:${event.event_id || event.message_id || ""}`;
@@ -558,7 +567,8 @@ 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") {
+            if ((inboxEnvelope.sender_type === "human" || inboxEnvelope.sender_type === "agent")
+                && processingEyeEnabled(agent)) {
                 processingEyes.add(agent, String(inboxEnvelope.message_id || ""), {
                     replyInThread: String(inboxEnvelope.target || "").startsWith("thread:"),
                     target: String(inboxEnvelope.target || ""),

package/dist/platform/config.cjs

@@ -46,6 +46,7 @@ exports.assertInboxAuditInterval = assertInboxAuditInterval;
 exports.parseInboxAuditInterval = parseInboxAuditInterval;
 exports.formatInboxAuditInterval = formatInboxAuditInterval;
 exports.inboxAuditMutationFromCli = inboxAuditMutationFromCli;
+exports.processingEyeMutationFromCli = processingEyeMutationFromCli;
 exports.hydrateAgent = hydrateAgent;
 exports.normalizeConfig = normalizeConfig;
 exports.assertPrivateConfigMetadata = assertPrivateConfigMetadata;
@@ -55,6 +56,7 @@ exports.toStored = toStored;
 exports.resolveMentionPolicy = resolveMentionPolicy;
 exports.resolveAgentGlobalMentionPolicy = resolveAgentGlobalMentionPolicy;
 exports.resolveInboxAuditSchedule = resolveInboxAuditSchedule;
+exports.resolveProcessingEye = resolveProcessingEye;
 exports.runtimeConfigSignature = runtimeConfigSignature;
 exports.configApplyState = configApplyState;
 exports.markConfigApplied = markConfigApplied;
@@ -86,11 +88,12 @@ 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 OPTIONAL_TOP_FIELDS_V4 = new Set(["inboxAudit", "processingEye"]);
 const AGENT_FIELDS_V3 = new Set(["runtime", "model", "effort", "noMentionChats", "createdAt"]);
-const AGENT_FIELDS_V4 = new Set(["runtime", "model", "effort", "mentionPolicy", "chatMentionPolicies", "inboxAudit", "createdAt"]);
+const AGENT_FIELDS_V4 = new Set(["runtime", "model", "effort", "mentionPolicy", "chatMentionPolicies", "inboxAudit", "processingEye", "createdAt"]);
 const LEGACY_AGENT_FIELDS = new Set(["piDistribution", "runtimeOption"]);
 const INBOX_AUDIT_FIELDS = new Set(["enabled", "intervalMs"]);
+const PROCESSING_EYE_FIELDS = new Set(["enabled"]);
 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"]);
@@ -203,6 +206,22 @@ function resolvedInboxAudit(settings) {
         intervalMs: settings?.intervalMs ?? exports.DEFAULT_INBOX_AUDIT_INTERVAL_MS,
     };
 }
+function parseStoredProcessingEye(value, label) {
+    if (!isPlainObject(value))
+        throw new Error(`${label} 必须是普通 object`);
+    assertAllowedFields(value, PROCESSING_EYE_FIELDS, label);
+    const settings = {};
+    if (Object.hasOwn(value, "enabled")) {
+        if (typeof value.enabled !== "boolean")
+            throw new Error(`${label}.enabled 必须是 boolean`);
+        settings.enabled = value.enabled;
+    }
+    return settings;
+}
+function resolvedProcessingEye(settings) {
+    // 缺 key 视为关闭。升级后不再保留旧的自动 OnIt 行为，除非用户显式开启。
+    return { enabled: settings?.enabled ?? false };
+}
 function inboxAuditMutationFromCli(input) {
     if (input.scope === "global") {
         if (input.enabled !== "on" && input.enabled !== "off") {
@@ -233,6 +252,25 @@ function inboxAuditMutationFromCli(input) {
     }
     throw new Error("inbox-audit scope 只支持 global/agent");
 }
+function processingEyeMutationFromCli(input) {
+    if (input.scope === "global") {
+        if (input.enabled !== "on" && input.enabled !== "off") {
+            throw new Error("用法: larkin config processing-eye global <on|off>");
+        }
+        return { kind: "set-global-processing-eye", enabled: input.enabled === "on" };
+    }
+    if (input.scope === "agent") {
+        if (input.enabled !== "on" && input.enabled !== "off" && input.enabled !== "inherit") {
+            throw new Error("用法: larkin config processing-eye agent <inherit|on|off> [--agent <App ID>]");
+        }
+        return {
+            kind: "set-agent-processing-eye",
+            agentId: input.agentId,
+            enabled: input.enabled === "inherit" ? "inherit" : input.enabled === "on",
+        };
+    }
+    throw new Error("processing-eye scope 只支持 global/agent");
+}
 function assertModel(runtime, model) {
     if (model === "default")
         return;
@@ -302,6 +340,8 @@ function validateStoredAgent(key, agent, version) {
         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, "processingEye"))
+        parseStoredProcessingEye(agent.processingEye, `Agent ${key}.processingEye`);
     if (version === 4 && Object.hasOwn(agent, "chatMentionPolicies")) {
         if (!isPlainObject(agent.chatMentionPolicies))
             throw new Error(`Agent ${key}.chatMentionPolicies 必须是普通 object`);
@@ -331,6 +371,7 @@ function hydratedStoredAgent(key, agent, version) {
         ...(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`) } : {}),
+        ...(version === 4 && Object.hasOwn(agent, "processingEye") ? { processingEye: parseStoredProcessingEye(agent.processingEye, `Agent ${key}.processingEye`) } : {}),
         ...(Object.keys(chatMentionPolicies).length ? { chatMentionPolicies, noMentionChats: Object.entries(chatMentionPolicies).filter(([, policy]) => policy === "free").map(([chatId]) => chatId) } : {}),
         ...(typeof agent.createdAt === "string" ? { createdAt: agent.createdAt } : {}),
     };
@@ -345,6 +386,7 @@ function hydrateAgent(key, agent, configDir) {
         ...(agent.effort ? { effort: agent.effort } : {}),
         ...(agent.mentionPolicy ? { mentionPolicy: agent.mentionPolicy } : {}),
         ...(agent.inboxAudit ? { inboxAudit: { ...agent.inboxAudit } } : {}),
+        ...(agent.processingEye ? { processingEye: { ...agent.processingEye } } : {}),
         ...(agent.chatMentionPolicies ? { chatMentionPolicies: { ...agent.chatMentionPolicies } } : {}),
         ...(agent.noMentionChats ? { noMentionChats: [...agent.noMentionChats] } : {}),
         ...(agent.createdAt ? { createdAt: agent.createdAt } : {}),
@@ -385,9 +427,13 @@ function normalizeConfig(raw, configDir, { mint } = {}) {
     const inboxAudit = version === 4 && Object.hasOwn(raw, "inboxAudit")
         ? resolvedInboxAudit(parseStoredInboxAudit(raw.inboxAudit, "config.inboxAudit"))
         : undefined;
+    const processingEye = version === 4 && Object.hasOwn(raw, "processingEye")
+        ? resolvedProcessingEye(parseStoredProcessingEye(raw.processingEye, "config.processingEye"))
+        : undefined;
     return {
         version: 4, serverId: raw.serverId, mentionPolicy: version === 4 ? raw.mentionPolicy : "require",
         ...(inboxAudit ? { inboxAudit } : {}),
+        ...(processingEye ? { processingEye } : {}),
         configDir: layout.configDir, larkinHome: layout.larkinHome, larkConfigDir: resolveLarkConfigDir({}, layout.root), activeAgent: raw.activeAgent, agents,
     };
 }
@@ -618,6 +664,8 @@ function toStored(config) {
     };
     if (config.inboxAudit)
         out.inboxAudit = { enabled: config.inboxAudit.enabled, intervalMs: config.inboxAudit.intervalMs };
+    if (config.processingEye)
+        out.processingEye = { enabled: config.processingEye.enabled };
     for (const [key, agent] of Object.entries(config.agents || {})) {
         const stored = { runtime: agent.runtime, model: agent.model };
         if (typeof agent.effort === "string" && agent.effort)
@@ -629,6 +677,9 @@ function toStored(config) {
         if (agent.inboxAudit && (agent.inboxAudit.enabled !== undefined || agent.inboxAudit.intervalMs !== undefined)) {
             stored.inboxAudit = { ...agent.inboxAudit };
         }
+        if (agent.processingEye && agent.processingEye.enabled !== undefined) {
+            stored.processingEye = { enabled: agent.processingEye.enabled };
+        }
         if (typeof agent.createdAt === "string" && agent.createdAt)
             stored.createdAt = agent.createdAt;
         out.agents[key] = stored;
@@ -669,6 +720,16 @@ function resolveInboxAuditSchedule(config, agentId) {
         intervalSource: agent.inboxAudit?.intervalMs !== undefined ? "agent" : config.inboxAudit?.intervalMs !== undefined ? "global" : "default",
     };
 }
+function resolveProcessingEye(config, agentId) {
+    const agent = config.agents[agentId];
+    if (!agent)
+        throw new Error(`Agent 不存在：${agentId}`);
+    const enabled = agent.processingEye?.enabled ?? config.processingEye?.enabled ?? false;
+    return {
+        enabled,
+        enabledSource: agent.processingEye?.enabled !== undefined ? "agent" : config.processingEye ? "global" : "default",
+    };
+}
 function revision(bytes) {
     return `sha256:${crypto.createHash("sha256").update(bytes).digest("hex")}`;
 }
@@ -682,6 +743,7 @@ function agentSignature(config, agentId) {
         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,
+        globalProcessingEye: config.processingEye ?? null, agentProcessingEye: agent.processingEye ?? null,
     }));
 }
 function runtimeConfigSignature(config, agentId) {
@@ -832,6 +894,10 @@ function applyMutation(config, mutation) {
         config.inboxAudit = current;
         return { scope: "global", runtimeChange: false, affectedAgentIds: Object.keys(config.agents) };
     }
+    if (mutation.kind === "set-global-processing-eye") {
+        config.processingEye = { enabled: mutation.enabled };
+        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];
@@ -864,6 +930,13 @@ function applyMutation(config, mutation) {
             agent.inboxAudit = current;
         return { scope: "agent", agentId: mutation.agentId, runtimeChange: false, affectedAgentIds: [mutation.agentId] };
     }
+    if (mutation.kind === "set-agent-processing-eye") {
+        if (mutation.enabled === "inherit")
+            delete agent.processingEye;
+        else
+            agent.processingEye = { enabled: mutation.enabled };
+        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}`);
@@ -1361,13 +1434,23 @@ function safeConfigView(config, onlyAgentId, chatId, applyState) {
                 source: { enabled: resolved.enabledSource, intervalMs: resolved.intervalSource },
             };
         })(),
+        processingEye: (() => {
+            const resolved = resolveProcessingEye(config, agentId);
+            return {
+                override: { enabled: agent.processingEye?.enabled === undefined ? "inherit" : agent.processingEye.enabled ? "on" : "off" },
+                effective: { enabled: resolved.enabled },
+                source: { enabled: resolved.enabledSource },
+            };
+        })(),
         chatMentionPolicies: { ...(agent.chatMentionPolicies || {}) },
         apply: applyState?.agents?.[agentId] ?? { applyState: "unknown" },
     }));
     const inboxAudit = resolvedInboxAudit(config.inboxAudit);
+    const processingEye = resolvedProcessingEye(config.processingEye);
     return {
         version: 4, mentionPolicy: config.mentionPolicy,
         inboxAudit: { enabled: inboxAudit.enabled, intervalMs: inboxAudit.intervalMs },
+        processingEye: { enabled: processingEye.enabled },
         persistedRevision: applyState?.persistedRevision ?? "unknown", agents,
     };
 }

package/dist/platform/config.mjs

@@ -13,11 +13,12 @@ export const MIN_INBOX_AUDIT_INTERVAL_MS = 60_000;
 export const 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 OPTIONAL_TOP_FIELDS_V4 = new Set(["inboxAudit", "processingEye"]);
 const AGENT_FIELDS_V3 = new Set(["runtime", "model", "effort", "noMentionChats", "createdAt"]);
-const AGENT_FIELDS_V4 = new Set(["runtime", "model", "effort", "mentionPolicy", "chatMentionPolicies", "inboxAudit", "createdAt"]);
+const AGENT_FIELDS_V4 = new Set(["runtime", "model", "effort", "mentionPolicy", "chatMentionPolicies", "inboxAudit", "processingEye", "createdAt"]);
 const LEGACY_AGENT_FIELDS = new Set(["piDistribution", "runtimeOption"]);
 const INBOX_AUDIT_FIELDS = new Set(["enabled", "intervalMs"]);
+const PROCESSING_EYE_FIELDS = new Set(["enabled"]);
 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"]);
@@ -130,6 +131,22 @@ function resolvedInboxAudit(settings) {
         intervalMs: settings?.intervalMs ?? DEFAULT_INBOX_AUDIT_INTERVAL_MS,
     };
 }
+function parseStoredProcessingEye(value, label) {
+    if (!isPlainObject(value))
+        throw new Error(`${label} 必须是普通 object`);
+    assertAllowedFields(value, PROCESSING_EYE_FIELDS, label);
+    const settings = {};
+    if (Object.hasOwn(value, "enabled")) {
+        if (typeof value.enabled !== "boolean")
+            throw new Error(`${label}.enabled 必须是 boolean`);
+        settings.enabled = value.enabled;
+    }
+    return settings;
+}
+function resolvedProcessingEye(settings) {
+    // 缺 key 视为关闭。升级后不再保留旧的自动 OnIt 行为，除非用户显式开启。
+    return { enabled: settings?.enabled ?? false };
+}
 export function inboxAuditMutationFromCli(input) {
     if (input.scope === "global") {
         if (input.enabled !== "on" && input.enabled !== "off") {
@@ -160,6 +177,25 @@ export function inboxAuditMutationFromCli(input) {
     }
     throw new Error("inbox-audit scope 只支持 global/agent");
 }
+export function processingEyeMutationFromCli(input) {
+    if (input.scope === "global") {
+        if (input.enabled !== "on" && input.enabled !== "off") {
+            throw new Error("用法: larkin config processing-eye global <on|off>");
+        }
+        return { kind: "set-global-processing-eye", enabled: input.enabled === "on" };
+    }
+    if (input.scope === "agent") {
+        if (input.enabled !== "on" && input.enabled !== "off" && input.enabled !== "inherit") {
+            throw new Error("用法: larkin config processing-eye agent <inherit|on|off> [--agent <App ID>]");
+        }
+        return {
+            kind: "set-agent-processing-eye",
+            agentId: input.agentId,
+            enabled: input.enabled === "inherit" ? "inherit" : input.enabled === "on",
+        };
+    }
+    throw new Error("processing-eye scope 只支持 global/agent");
+}
 function assertModel(runtime, model) {
     if (model === "default")
         return;
@@ -229,6 +265,8 @@ function validateStoredAgent(key, agent, version) {
         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, "processingEye"))
+        parseStoredProcessingEye(agent.processingEye, `Agent ${key}.processingEye`);
     if (version === 4 && Object.hasOwn(agent, "chatMentionPolicies")) {
         if (!isPlainObject(agent.chatMentionPolicies))
             throw new Error(`Agent ${key}.chatMentionPolicies 必须是普通 object`);
@@ -258,6 +296,7 @@ function hydratedStoredAgent(key, agent, version) {
         ...(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`) } : {}),
+        ...(version === 4 && Object.hasOwn(agent, "processingEye") ? { processingEye: parseStoredProcessingEye(agent.processingEye, `Agent ${key}.processingEye`) } : {}),
         ...(Object.keys(chatMentionPolicies).length ? { chatMentionPolicies, noMentionChats: Object.entries(chatMentionPolicies).filter(([, policy]) => policy === "free").map(([chatId]) => chatId) } : {}),
         ...(typeof agent.createdAt === "string" ? { createdAt: agent.createdAt } : {}),
     };
@@ -272,6 +311,7 @@ export function hydrateAgent(key, agent, configDir) {
         ...(agent.effort ? { effort: agent.effort } : {}),
         ...(agent.mentionPolicy ? { mentionPolicy: agent.mentionPolicy } : {}),
         ...(agent.inboxAudit ? { inboxAudit: { ...agent.inboxAudit } } : {}),
+        ...(agent.processingEye ? { processingEye: { ...agent.processingEye } } : {}),
         ...(agent.chatMentionPolicies ? { chatMentionPolicies: { ...agent.chatMentionPolicies } } : {}),
         ...(agent.noMentionChats ? { noMentionChats: [...agent.noMentionChats] } : {}),
         ...(agent.createdAt ? { createdAt: agent.createdAt } : {}),
@@ -312,9 +352,13 @@ export function normalizeConfig(raw, configDir, { mint } = {}) {
     const inboxAudit = version === 4 && Object.hasOwn(raw, "inboxAudit")
         ? resolvedInboxAudit(parseStoredInboxAudit(raw.inboxAudit, "config.inboxAudit"))
         : undefined;
+    const processingEye = version === 4 && Object.hasOwn(raw, "processingEye")
+        ? resolvedProcessingEye(parseStoredProcessingEye(raw.processingEye, "config.processingEye"))
+        : undefined;
     return {
         version: 4, serverId: raw.serverId, mentionPolicy: version === 4 ? raw.mentionPolicy : "require",
         ...(inboxAudit ? { inboxAudit } : {}),
+        ...(processingEye ? { processingEye } : {}),
         configDir: layout.configDir, larkinHome: layout.larkinHome, larkConfigDir: resolveLarkConfigDir({}, layout.root), activeAgent: raw.activeAgent, agents,
     };
 }
@@ -545,6 +589,8 @@ export function toStored(config) {
     };
     if (config.inboxAudit)
         out.inboxAudit = { enabled: config.inboxAudit.enabled, intervalMs: config.inboxAudit.intervalMs };
+    if (config.processingEye)
+        out.processingEye = { enabled: config.processingEye.enabled };
     for (const [key, agent] of Object.entries(config.agents || {})) {
         const stored = { runtime: agent.runtime, model: agent.model };
         if (typeof agent.effort === "string" && agent.effort)
@@ -556,6 +602,9 @@ export function toStored(config) {
         if (agent.inboxAudit && (agent.inboxAudit.enabled !== undefined || agent.inboxAudit.intervalMs !== undefined)) {
             stored.inboxAudit = { ...agent.inboxAudit };
         }
+        if (agent.processingEye && agent.processingEye.enabled !== undefined) {
+            stored.processingEye = { enabled: agent.processingEye.enabled };
+        }
         if (typeof agent.createdAt === "string" && agent.createdAt)
             stored.createdAt = agent.createdAt;
         out.agents[key] = stored;
@@ -596,6 +645,16 @@ export function resolveInboxAuditSchedule(config, agentId) {
         intervalSource: agent.inboxAudit?.intervalMs !== undefined ? "agent" : config.inboxAudit?.intervalMs !== undefined ? "global" : "default",
     };
 }
+export function resolveProcessingEye(config, agentId) {
+    const agent = config.agents[agentId];
+    if (!agent)
+        throw new Error(`Agent 不存在：${agentId}`);
+    const enabled = agent.processingEye?.enabled ?? config.processingEye?.enabled ?? false;
+    return {
+        enabled,
+        enabledSource: agent.processingEye?.enabled !== undefined ? "agent" : config.processingEye ? "global" : "default",
+    };
+}
 function revision(bytes) {
     return `sha256:${crypto.createHash("sha256").update(bytes).digest("hex")}`;
 }
@@ -609,6 +668,7 @@ function agentSignature(config, agentId) {
         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,
+        globalProcessingEye: config.processingEye ?? null, agentProcessingEye: agent.processingEye ?? null,
     }));
 }
 export function runtimeConfigSignature(config, agentId) {
@@ -759,6 +819,10 @@ function applyMutation(config, mutation) {
         config.inboxAudit = current;
         return { scope: "global", runtimeChange: false, affectedAgentIds: Object.keys(config.agents) };
     }
+    if (mutation.kind === "set-global-processing-eye") {
+        config.processingEye = { enabled: mutation.enabled };
+        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];
@@ -791,6 +855,13 @@ function applyMutation(config, mutation) {
             agent.inboxAudit = current;
         return { scope: "agent", agentId: mutation.agentId, runtimeChange: false, affectedAgentIds: [mutation.agentId] };
     }
+    if (mutation.kind === "set-agent-processing-eye") {
+        if (mutation.enabled === "inherit")
+            delete agent.processingEye;
+        else
+            agent.processingEye = { enabled: mutation.enabled };
+        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}`);
@@ -1288,13 +1359,23 @@ export function safeConfigView(config, onlyAgentId, chatId, applyState) {
                 source: { enabled: resolved.enabledSource, intervalMs: resolved.intervalSource },
             };
         })(),
+        processingEye: (() => {
+            const resolved = resolveProcessingEye(config, agentId);
+            return {
+                override: { enabled: agent.processingEye?.enabled === undefined ? "inherit" : agent.processingEye.enabled ? "on" : "off" },
+                effective: { enabled: resolved.enabled },
+                source: { enabled: resolved.enabledSource },
+            };
+        })(),
         chatMentionPolicies: { ...(agent.chatMentionPolicies || {}) },
         apply: applyState?.agents?.[agentId] ?? { applyState: "unknown" },
     }));
     const inboxAudit = resolvedInboxAudit(config.inboxAudit);
+    const processingEye = resolvedProcessingEye(config.processingEye);
     return {
         version: 4, mentionPolicy: config.mentionPolicy,
         inboxAudit: { enabled: inboxAudit.enabled, intervalMs: inboxAudit.intervalMs },
+        processingEye: { enabled: processingEye.enabled },
         persistedRevision: applyState?.persistedRevision ?? "unknown", agents,
     };
 }

package/package.json

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