larkin 0.5.17 → 0.5.18

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.5.18
+
+The Feishu processing-eye OnIt reaction is now off by default. New installs and existing configs that omit `processingEye` no longer auto-react on inbound messages after upgrade; there is no migration prompt. Opt back in with `larkin config processing-eye global on`, a per-Agent `on`/`off`/`inherit` override, or the Dashboard 处理中表情 toggle. Explicit `enabled: false` and a missing key both skip the reactions API.
+
 ## 0.5.8
 
 Lark setup now reconciles requested tenant permissions with actual grants and links missing scopes to the same application in the developer console. Required permissions still block setup until granted; optional permissions and event/callback verification are reported separately. Existing-application authorization preserves and checks its App ID before recording any capability state.

package/README.md

@@ -114,6 +114,17 @@ larkin config inbox-audit global off
 
 When enabled, audit only revisits originally wake-eligible human group/topic work and does not wake a model for an empty work list. Reading an audit list does not complete it: the managed Agent follows the returned inspection instructions and explicitly confirms the receipt after checking. A failed check remains retryable; newer messages cannot be completed by an older receipt. Old audit-index records without proven eligibility or observation identity are ignored; ordinary Inbox messages and conversation history are preserved.
 
+### Optional processing eye (OnIt)
+
+The Feishu "processing eye" (OnIt reaction on inbound messages while the Agent works) is **off by default**. A missing `processingEye` key is treated as off, so upgrading to this version stops the auto-reaction without a migration prompt. In the Dashboard, use **Global settings → 处理中表情** or the selected Agent's **Configuration → 处理中表情**. The same settings are available through the CLI:
+
+```bash
+larkin config processing-eye global on
+larkin config processing-eye agent off --agent <App-ID>
+larkin config processing-eye agent inherit --agent <App-ID>
+larkin config processing-eye global off
+```
+
 <details>
 <summary>Windows support and optional autostart</summary>
 

package/dist/agent/config-cli-contract.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CONFIG_CLI_VALUES = exports.CONFIG_CLI_USAGE = exports.CONFIG_CLI_OPERATIONS = void 0;
-exports.CONFIG_CLI_OPERATIONS = Object.freeze(["show", "runtime", "model", "effort", "mention", "inbox-audit", "apply"]);
+exports.CONFIG_CLI_OPERATIONS = Object.freeze(["show", "runtime", "model", "effort", "mention", "inbox-audit", "processing-eye", "apply"]);
 exports.CONFIG_CLI_USAGE = Object.freeze([
     "larkin config show [--agent <App ID>] [--chat <oc_id>] [--json]",
     "larkin config runtime <runtime> [--model <model>] [--agent <App ID>]",
@@ -12,6 +12,8 @@ exports.CONFIG_CLI_USAGE = Object.freeze([
     "larkin config mention chat <oc_id> <inherit|require|free> [--agent <App ID>]",
     "larkin config inbox-audit global <on|off> [--interval <15m|1h>]",
     "larkin config inbox-audit agent <inherit|on|off> [--agent <App ID>] [--interval <15m|inherit>]",
+    "larkin config processing-eye global <on|off>",
+    "larkin config processing-eye agent <inherit|on|off> [--agent <App ID>]",
     "larkin config apply [--agent <App ID>]",
 ]);
 exports.CONFIG_CLI_VALUES = Object.freeze({

package/dist/agent/config-cli-contract.mjs

@@ -1,4 +1,4 @@
-export const CONFIG_CLI_OPERATIONS = Object.freeze(["show", "runtime", "model", "effort", "mention", "inbox-audit", "apply"]);
+export const CONFIG_CLI_OPERATIONS = Object.freeze(["show", "runtime", "model", "effort", "mention", "inbox-audit", "processing-eye", "apply"]);
 export const CONFIG_CLI_USAGE = Object.freeze([
     "larkin config show [--agent <App ID>] [--chat <oc_id>] [--json]",
     "larkin config runtime <runtime> [--model <model>] [--agent <App ID>]",
@@ -9,6 +9,8 @@ export const CONFIG_CLI_USAGE = Object.freeze([
     "larkin config mention chat <oc_id> <inherit|require|free> [--agent <App ID>]",
     "larkin config inbox-audit global <on|off> [--interval <15m|1h>]",
     "larkin config inbox-audit agent <inherit|on|off> [--agent <App ID>] [--interval <15m|inherit>]",
+    "larkin config processing-eye global <on|off>",
+    "larkin config processing-eye agent <inherit|on|off> [--agent <App ID>]",
     "larkin config apply [--agent <App ID>]",
 ]);
 export const CONFIG_CLI_VALUES = Object.freeze({

package/dist/app/agent-cli.mjs

@@ -256,6 +256,23 @@ function agentConfigRequest(argv, env, config, agent, dependencies) {
             agentId: targetId,
         });
     }
+    else if (operation === "processing-eye") {
+        const [scope, first] = options.positionals;
+        if (scope === "global")
+            assertOnlyFlags([]);
+        else if (scope === "agent")
+            assertOnlyFlags(["--agent"]);
+        else
+            assertOnlyFlags([]);
+        if (options.positionals.length !== 2) {
+            throw new Error("用法: larkin config processing-eye global <on|off> | processing-eye agent <inherit|on|off> [--agent <App ID>]");
+        }
+        mutation = larkinConfig.processingEyeMutationFromCli({
+            scope: scope || "",
+            enabled: first,
+            agentId: targetId,
+        });
+    }
     else if (operation === "apply") {
         assertOnlyFlags(["--agent"]);
         if (options.positionals.length)
@@ -269,7 +286,7 @@ function agentConfigRequest(argv, env, config, agent, dependencies) {
         }).catch((error) => { throw new Error(`配置已保存但未应用：${error instanceof Error ? error.message : String(error)}`); });
     }
     else
-        throw new Error("config 只支持 show/runtime/model/effort/mention/inbox-audit/apply；运行 larkin config --help");
+        throw new Error("config 只支持 show/runtime/model/effort/mention/inbox-audit/processing-eye/apply；运行 larkin config --help");
     const result = larkinConfig.mutateConfig(env, mutation, authority);
     return { ok: true, revision: result.revision, persisted: true, applyState: result.applyState, changedScope: result.changedScope };
 }

package/dist/app/agent-config.mjs

@@ -52,7 +52,7 @@ const die = (message) => {
     process.exit(1);
 };
 if (!kind || !["agents", "model", "runtime", "effort", "chats", "config"].includes(kind)) {
-    die("用法: larkin agents | larkin config <show|mention|inbox-audit|apply> | larkin model [<id>] | larkin runtime [<id>] [--model <id>] | larkin effort [<level>|clear] | larkin chats [free|strict <oc_id>]");
+    die("用法: larkin agents | larkin config <show|mention|inbox-audit|processing-eye|apply> | larkin model [<id>] | larkin runtime [<id>] [--model <id>] | larkin effort [<level>|clear] | larkin chats [free|strict <oc_id>]");
 }
 const allowedValueFlags = {
     agents: new Set(), model: new Set(["--agent"]), runtime: new Set(["--agent", "--model"]),
@@ -162,13 +162,23 @@ else if (kind === "config") {
         if (positionals.length !== 3)
             die("用法: larkin config inbox-audit agent <inherit|on|off> [--agent <App ID>] [--interval <15m|inherit>]");
     }
+    else if (operation === "processing-eye" && scope === "global") {
+        assertOnlyFlags([]);
+        if (positionals.length !== 3)
+            die("用法: larkin config processing-eye global <on|off>");
+    }
+    else if (operation === "processing-eye" && scope === "agent") {
+        assertOnlyFlags(["--agent"]);
+        if (positionals.length !== 3)
+            die("用法: larkin config processing-eye agent <inherit|on|off> [--agent <App ID>]");
+    }
     else if (operation === "apply") {
         assertOnlyFlags(["--agent"]);
         if (positionals.length !== 1)
             die("用法: larkin config apply [--agent <App ID>]");
     }
     else {
-        die("config 只支持 show/mention/inbox-audit/apply；运行 larkin config --help");
+        die("config 只支持 show/mention/inbox-audit/processing-eye/apply；运行 larkin config --help");
     }
 }
 const loaded = (() => {
@@ -352,15 +362,20 @@ if (kind === "config") {
             say(`全局群消息策略=${String(view.mentionPolicy)}（free 会唤醒所有继承它的 Agent）`);
             const inboxAudit = view.inboxAudit;
             say(`全局 Inbox Audit=${inboxAudit?.enabled ? "on" : "off"} interval=${larkinConfig.formatInboxAuditInterval(Number(inboxAudit?.intervalMs || larkinConfig.DEFAULT_INBOX_AUDIT_INTERVAL_MS))}（默认关闭；未 @ 的 require 群消息不会进入审计）`);
+            const processingEye = view.processingEye;
+            say(`全局处理中表情=${processingEye?.enabled ? "on" : "off"}（默认关闭；缺 key 视为关闭，升级后不再自动点 OnIt）`);
             for (const item of view.agents) {
                 const mention = item.mention;
                 const agentAudit = item.inboxAudit;
+                const agentEye = item.processingEye;
                 const apply = item.apply;
-                say(`agent=${item.agentId} runtime=${item.runtime} model=${item.model} effort=${item.effort || "default"} mention=${mention.override} inbox-audit=${agentAudit?.override?.enabled || "inherit"} apply=${apply.applyState || "unknown"}`);
+                say(`agent=${item.agentId} runtime=${item.runtime} model=${item.model} effort=${item.effort || "default"} mention=${mention.override} inbox-audit=${agentAudit?.override?.enabled || "inherit"} processing-eye=${agentEye?.override?.enabled || "inherit"} apply=${apply.applyState || "unknown"}`);
                 if (mention.chat)
                     say(`  chat=${mention.chat.chatId} override=${mention.chat.override} effective=${mention.chat.effective} source=${mention.chat.source}`);
                 if (agentAudit?.effective)
                     say(`  inbox-audit effective=${agentAudit.effective.enabled ? "on" : "off"} interval=${larkinConfig.formatInboxAuditInterval(Number(agentAudit.effective.intervalMs || larkinConfig.DEFAULT_INBOX_AUDIT_INTERVAL_MS))}`);
+                if (agentEye?.effective)
+                    say(`  processing-eye effective=${agentEye.effective.enabled ? "on" : "off"}`);
             }
         }
         process.exit(0);
@@ -405,6 +420,20 @@ if (kind === "config") {
         }
         process.exit(0);
     }
+    if (operation === "processing-eye") {
+        try {
+            const result = larkinConfig.mutateConfig(process.env, larkinConfig.processingEyeMutationFromCli({
+                scope: scope || "",
+                enabled: first,
+                agentId: scope === "agent" ? requireTarget() : (selected || keys[0] || ""),
+            }), authority);
+            say(JSON.stringify({ ok: true, revision: result.revision, persisted: result.persisted, applyState: result.applyState, changedScope: result.changedScope }, null, 2));
+        }
+        catch (error) {
+            die(error instanceof Error ? error.message : String(error));
+        }
+        process.exit(0);
+    }
     if (operation === "apply") {
         const agentId = requireTarget();
         const expectedSignature = larkinConfig.runtimeConfigSignature(config, agentId);
@@ -424,7 +453,7 @@ if (kind === "config") {
         }
         process.exit(0);
     }
-    die("config 只支持 show/mention/inbox-audit/apply");
+    die("config 只支持 show/mention/inbox-audit/processing-eye/apply");
 }
 let key = flagAgent;
 if (!key && runtimeAgentId)

package/dist/app/cli.mjs

@@ -87,6 +87,7 @@ Examples:
   larkin config runtime pi --agent cli_x --model default
   larkin config mention chat oc_x free --agent cli_x
   larkin config inbox-audit global on --interval 15m
+  larkin config processing-eye global on
 
 Credentials, internal paths, serverId, activeAgent, and raw config are never exposed here.`,
     session: `Usage: larkin session reset --agent <App ID> --json [--wait-ready <seconds>]

package/dist/dashboard/dashboard-config-controller.mjs

@@ -402,11 +402,17 @@ function dashboardMutation(value) {
         "set-chat-mention": ["operation", "agentId", "chatId", "value"], "set-agent-runtime": ["operation", "agentId", "runtime", "model"],
         "set-agent-model": ["operation", "agentId", "model"], "set-agent-effort": ["operation", "agentId", "effort"],
         "set-global-inbox-audit": ["operation", "enabled", "intervalMs"], "set-agent-inbox-audit": ["operation", "agentId", "enabled", "intervalMs"],
+        "set-global-processing-eye": ["operation", "enabled"], "set-agent-processing-eye": ["operation", "agentId", "enabled"],
     };
     if (!allowed[operation] || Object.keys(value).some((key) => !allowed[operation].includes(key)))
         throw new Error("unsupported operation");
     if (operation === "set-global-mention")
         return { kind: operation, value: String(value.value) };
+    if (operation === "set-global-processing-eye") {
+        if (typeof value.enabled !== "boolean")
+            throw new Error("invalid processing-eye enabled");
+        return { kind: operation, enabled: value.enabled };
+    }
     if (operation === "set-global-inbox-audit") {
         if (value.enabled !== undefined && typeof value.enabled !== "boolean")
             throw new Error("invalid inbox-audit enabled");
@@ -422,6 +428,11 @@ function dashboardMutation(value) {
             throw new Error("invalid inbox-audit interval");
         return { kind: operation, agentId, ...(value.enabled !== undefined ? { enabled: value.enabled } : {}), ...(value.intervalMs !== undefined ? { intervalMs: value.intervalMs } : {}) };
     }
+    if (operation === "set-agent-processing-eye") {
+        if (value.enabled !== "inherit" && typeof value.enabled !== "boolean")
+            throw new Error("invalid processing-eye enabled");
+        return { kind: operation, agentId, enabled: value.enabled };
+    }
     if (operation === "set-agent-mention")
         return { kind: operation, agentId, value: String(value.value) };
     if (operation === "set-chat-mention")