openclaw-lark-multi-agent 1.4.4 → 1.4.6

package/README.md

@@ -99,22 +99,20 @@ On Windows, install [NSSM](https://nssm.cc/download), make sure `nssm.exe` is in
 lma install-windows-service
 ```
 
-### Optional: real-time steering plugin
+### Real-time steering
 
-To let users nudge/correct a long-running agent turn in real time (instead of
-waiting for it to finish), install the bundled `lma-steer` OpenClaw plugin:
+When the agent is mid-run and a new message arrives, the bridge submits it via
+OpenClaw's public `chat.send` API with `queueMode: "steer"`. The RPC
+acknowledgment is provisional: LMA retains its durable pending trigger until a
+matching `session.message` proves transcript commitment/consumption, and only
+then switches Feishu from Typing to Get. Async `error`/`aborted` terminals are
+routed by run id, while unconsumed input remains available for normal queue
+fallback. This replaces the deprecated synchronous plugin primitive whose
+boolean could not represent later runtime rejection.
 
-```bash
-lma install-steer-plugin
-# then restart the OpenClaw gateway so it loads the plugin:
-systemctl --user restart openclaw-gateway.service
-```
-
-When the agent is mid-run and a new message arrives, the bridge injects it into
-the active run at the next tool-call boundary (Feishu shows the "Get" reaction).
-Without the plugin, the bridge falls back to queuing the message until the run
-finishes — everything still works, just without real-time steering. See
-`plugins/lma-steer/README.md` for details.
+OpenClaw 2026.8+ no longer requires the bundled `lma-steer` plugin. The
+`install-steer-plugin` command remains temporarily for older installations but
+current LMA releases do not call its private Gateway method.
 
 Useful CLI commands:
 
@@ -124,7 +122,7 @@ lma doctor
 lma start [config]
 lma init [--state-dir DIR] [--force]
 lma install-systemd [--user|--system] [--state-dir DIR]
-lma install-steer-plugin [--no-force]
+lma install-steer-plugin [--no-force]  # legacy; not needed on OpenClaw 2026.8+
 ```
 
 ## Quick start from source
@@ -450,6 +448,26 @@ Assistant replies are sent as Feishu CardKit v2 cards. Markdown is preprocessed
 
 For generated files/images/documents, agents should use the bridge attachment marker protocol instead of calling Feishu messaging tools directly. The bridge strips the marker from the visible reply, validates the file path under the configured attachment directory, uploads/sends the attachment, and records it in local context. Markdown documents can be converted into Feishu cloud documents through this path.
 
+## OpenClaw 2026.8 compatibility
+
+LMA targets Gateway protocol 4 and is built/tested against `openclaw@2026.8.2`.
+OpenClaw 2026.8 moves active session rows and transcripts into the per-agent
+SQLite database. LMA never opens that database or rewrites archived JSONL:
+`/compact` first requests semantic `sessions.compact`, then uses the same
+Gateway RPC with a bounded `maxLines` tail only if semantic compaction cannot
+run. Set `OPENCLAW_LARK_MULTI_AGENT_COMPACT_FALLBACK_MAX_LINES` to change the
+default tail size (`200`, minimum `20`).
+
+OpenClaw 2026.8 also separates model metadata from the override allowlist. Every
+model configured in LMA must be permitted by `agents.defaults.modelPolicy.allow`
+when that list is non-empty. Exact refs and `provider/*` wildcards are accepted.
+LMA now surfaces a model-policy rejection instead of logging a false “model
+ensured” success.
+
+Mid-run messages use the public `chat.send { queueMode: "steer" }` path. LMA
+keeps the durable trigger until `session.message` confirms consumption; this is
+also the signal for the visible Typing-to-Get transition.
+
 ## Live status
 
 In non-verbose mode, each run shows a single self-updating Feishu interactive

package/README.zh-CN.md

@@ -408,6 +408,14 @@ v1 行为边界：如果消息已经进入 OpenClaw 正在处理，暂不 abort
 
 如果 Agent 需要发送生成的文件、图片或文档，应使用 bridge attachment marker 协议，而不是直接调用飞书消息工具。桥接层会从可见回复中剥离 marker，校验文件路径位于配置的附件目录下，然后上传/发送附件，并写入本地上下文。Markdown 文档也可以通过这个路径转换成飞书云文档。
 
+## OpenClaw 2026.8 兼容性
+
+LMA 以 Gateway protocol 4 为基线，并使用 `openclaw@2026.8.2` 构建和测试。OpenClaw 2026.8 把活动 session row 与 transcript 迁入每个 Agent 的 SQLite 数据库。LMA 不再直接查找或改写 JSONL：`/compact` 先调用语义化 `sessions.compact`，如果语义压缩无法执行，再通过同一个 Gateway RPC 的 `maxLines` 安全保留最近一段转录。可用 `OPENCLAW_LARK_MULTI_AGENT_COMPACT_FALLBACK_MAX_LINES` 调整默认保留数量（默认 `200`，最小 `20`）。
+
+新版把模型元数据与模型覆盖允许列表分开。如果 `agents.defaults.modelPolicy.allow` 非空，LMA 配置中的每个模型都必须被该列表的精确模型引用或 `provider/*` 通配符允许。遇到拒绝时，LMA 会直接报告 model policy 错误，不再错误记录“模型已确保”。
+
+执行中插入的消息改用公开的 `chat.send { queueMode: "steer" }`。RPC 成功返回只是暂时接受；LMA 会继续保留本地 pending trigger，只有匹配的 `session.message` 确认消息已写入转录并被消费后才清除，同时把飞书标记从 Typing 切换为 Get。异步 `error`/`aborted` 按 runId 投递，未消费的输入仍由普通队列兜底。这样不再依赖无法表达后续异步拒绝的旧同步插件原语。
+
 ## Live Status 与最终回复
 
 非 verbose 模式下，执行过程显示一张可更新的 live status 卡片。运行中显示最近活动和耗时；完成后收缩为“累计工具调用次数 + 总耗时”。

package/dist/cli.js

@@ -206,12 +206,12 @@ function runCapture(cmd, args) {
     }
 }
 /**
- * Install the bundled lma-steer OpenClaw plugin into the local OpenClaw gateway.
- * The plugin registers the `lma.steer` gateway method that the bridge uses to
- * inject a message into an active run at the next tool-call boundary. The plugin
- * ships inside this package under plugins/lma-steer (built to dist).
+ * Install the legacy bundled lma-steer plugin. Current LMA uses OpenClaw's
+ * public `chat.send { queueMode: "steer" }` API and does not call this plugin;
+ * the command remains only for operators maintaining older LMA deployments.
  */
 function cmdInstallSteerPlugin(args) {
+    console.warn("Note: current LMA releases use native chat.send queueMode=steer; this legacy plugin is not required on OpenClaw 2026.8+.");
     // Default to --force so reinstalling an updated bundled plugin overwrites the
     // previously installed copy. Pass --no-force to keep an existing install.
     const noForce = hasFlag(args, "--no-force");

package/dist/compact-progress.d.ts

@@ -1,5 +1,5 @@
 /** Coarse phase of the compaction flow, drives the card's primary line. */
-export type CompactPhase = "native" | "tool-trim";
+export type CompactPhase = "native" | "transcript-trim";
 /** Terminal outcome used by the renderer to pick color/emoji. */
 export type CompactState = "running" | "done" | "failed" | "noop";
 /** Structured snapshot the renderer turns into a Feishu interactive card. */
@@ -27,7 +27,7 @@ export type CompactProgressOptions = {
     tickMs?: number;
 };
 /**
- * Lifecycle: start() → (optional) toToolTrim() when native gives up → one of
+ * Lifecycle: start() → (optional) toTranscriptTrim() when native gives up → one of
  * done()/noop()/fail(). The card is created lazily after `delayMs` so a fast
  * compaction that finishes first never shows a card at all. All terminal calls
  * are idempotent and safe even if the card was never created.
@@ -50,8 +50,8 @@ export declare class CompactProgressController {
     get id(): string | undefined;
     /** Begin the flow; schedules lazy card creation after delayMs. */
     start(): void;
-    /** Native compaction gave up (timeout/no-op); switch the card to fast-trim. */
-    toToolTrim(): Promise<void>;
+    /** Native compaction gave up; switch to Gateway-owned transcript-tail trim. */
+    toTranscriptTrim(): Promise<void>;
     /** Finished successfully; patch the card to the done state with a detail line. */
     done(detail?: string): Promise<void>;
     /** Nothing to compact; patch the card to a neutral "no-op" state. */

package/dist/compact-progress.js

@@ -10,7 +10,7 @@
 const DEFAULT_DELAY_MS = Number(process.env.OPENCLAW_LARK_MULTI_AGENT_COMPACT_STATUS_DELAY_MS || 500);
 const DEFAULT_TICK_MS = Number(process.env.OPENCLAW_LARK_MULTI_AGENT_COMPACT_STATUS_TICK_MS || 1000);
 /**
- * Lifecycle: start() → (optional) toToolTrim() when native gives up → one of
+ * Lifecycle: start() → (optional) toTranscriptTrim() when native gives up → one of
  * done()/noop()/fail(). The card is created lazily after `delayMs` so a fast
  * compaction that finishes first never shows a card at all. All terminal calls
  * are idempotent and safe even if the card was never created.
@@ -45,11 +45,11 @@ export class CompactProgressController {
         }, this.opts.delayMs ?? DEFAULT_DELAY_MS);
         this.createTimer.unref?.();
     }
-    /** Native compaction gave up (timeout/no-op); switch the card to fast-trim. */
-    async toToolTrim() {
-        if (this.finalized || this.phase === "tool-trim")
+    /** Native compaction gave up; switch to Gateway-owned transcript-tail trim. */
+    async toTranscriptTrim() {
+        if (this.finalized || this.phase === "transcript-trim")
             return;
-        this.phase = "tool-trim";
+        this.phase = "transcript-trim";
         await this.refresh();
     }
     /** Finished successfully; patch the card to the done state with a detail line. */

package/dist/feishu-bot.d.ts

@@ -46,8 +46,15 @@ export declare class FeishuBot {
     private lastRealDeliveryAt;
     /** Per-chat: whether we've already sent the high-context alert this cycle. */
     private contextAlerted;
-    /** Active chatSend trigger target so final replies and proactive session.message share one delivery key. */
+    /** Active pre-admission target for the current chat operation. */
     private activeDeliveryTargets;
+    /** Stable targets for concurrent runs in one chat. A steer admission can
+     * become an ordinary run while another run remains active. */
+    private deliveryTargetsByRun;
+    /** Provisional native-steer correlations keyed by durable message row. If the
+     * message falls back to a normal run, cancel these before submission so a
+     * later identical steer cannot consume the stale observer/correlation. */
+    private pendingSteerCleanups;
     private adminOpenId;
     private locale;
     private configPath?;
@@ -181,6 +188,9 @@ export declare class FeishuBot {
      */
     private autoRetryUntilComplete;
     private cancelDelayedFailure;
+    private deliveryRunTargetKey;
+    private bindRunDeliveryTarget;
+    private releaseRunDeliveryTargetAfter;
     private setActiveDeliveryTarget;
     private scheduleDelayedFailure;
     private deliverySessionKey;
@@ -305,14 +315,14 @@ export declare class FeishuBot {
      * Handle /compact command: compress session context.
      */
     /**
-     * Compact a session with a fallback chain:
-     *   1. OpenClaw's native (LLM-summary) compaction — best semantics.
-     *   2. If that did not compact (or threw), fall back to "tool-trim": rewrite
-     *      the transcript file to drop tool calls/results while keeping the
-     *      conversation. This needs no model, so it works no matter how large the
-     *      session is (the native path itself fails to fit an oversized session
-     *      into the model). A backup is always written before any file change.
-     * Returns a structured result describing what happened.
+     * Compact a session with a Gateway-owned fallback chain:
+     *   1. Semantic compaction through `sessions.compact`.
+     *   2. If summarization cannot run, ask the same RPC to retain only a bounded
+     *      transcript tail via `maxLines`. This works with legacy JSONL and the
+     *      SQLite session store introduced in OpenClaw 2026.8.x, and preserves
+     *      OpenClaw's write locks, transcript invariants, and migration ownership.
+     *
+     * LMA deliberately never opens or rewrites OpenClaw transcript storage.
      */
     private compactWithFallback;
     private handleCompactCommand;