openclaw-lark-multi-agent 1.4.3 → 1.4.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-lark-multi-agent",
-  "version": "1.4.3",
+  "version": "1.4.5",
   "description": "Multi-bot Lark/Feishu bridge for OpenClaw, with per-bot model routing and isolated sessions",
   "type": "module",
   "scripts": {
@@ -23,7 +23,7 @@
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^22.0.0",
     "@vitest/coverage-v8": "^4.1.5",
-    "openclaw": "^2026.6.0",
+    "openclaw": "^2026.8.2",
     "tsx": "^4.19.0",
     "typescript": "^5.7.0",
     "vitest": "^4.1.5"

package/plugins/lma-steer/README.md

@@ -1,45 +1,38 @@
-# lma-steer
+# lma-steer (legacy compatibility plugin)
 
-An OpenClaw plugin bundled with **openclaw-lark-multi-agent**. It registers a
-Gateway method `lma.steer` that the bridge uses to inject a message into an
-**active** OpenClaw run at the next tool-call boundary — so a user can nudge or
-correct a long-running task in real time instead of waiting for it to finish.
+This plugin is retained for older `openclaw-lark-multi-agent` deployments that
+called the private `lma.steer` Gateway method.
 
-## Why a plugin
+Current LMA releases on OpenClaw 2026.8+ do **not** use this plugin. They submit
+mid-run input through the public protocol API:
 
-Native `chat.send` with `queue.mode=steer` only acks `{status:"started"}` — it
-cannot tell the bridge whether the message actually steered into the active run,
-was queued as a followup, or was rejected. This plugin uses the runtime
-primitives `resolveActiveEmbeddedRunSessionId` + `queueAgentHarnessMessage`,
-which expose that distinction, so the bridge can render an accurate Feishu
-reaction.
-
-## Install
-
-From an installed `openclaw-lark-multi-agent`:
-
-```bash
-openclaw-lark-multi-agent install-steer-plugin
+```text
+chat.send { queueMode: "steer" }
 ```
 
-Then restart the OpenClaw gateway so it loads the plugin:
+The public path owns admission, while LMA retains its durable fallback trigger
+until a matching `session.message` confirms transcript consumption. Only then
+is the Feishu acknowledgement changed from Typing to Get, so provisional
+acceptance and actual model consumption remain distinct.
 
-```bash
-systemctl --user restart openclaw-gateway.service
-```
+## Legacy installation
 
-Verify (an idle session returns `no_active_run`):
+Only install this plugin when maintaining an older LMA release that explicitly
+requires `lma.steer`:
 
 ```bash
-openclaw gateway call lma.steer --params '{"sessionKey":"test","text":"ping"}'
+lma install-steer-plugin
 ```
 
-## Gateway method
+Restart the OpenClaw Gateway after installation. For new deployments, skip this
+step.
 
-`lma.steer`
+## Legacy method
 
+- method: `lma.steer`
 - params: `{ sessionKey: string, text: string }`
 - result: `{ status: "steered" | "no_active_run" | "rejected", sessionId?: string }`
-  - `steered` — queued into the active run; seen at the next tool-call boundary
-  - `no_active_run` — no active run; caller should send as a normal new message
-  - `rejected` — active run refused the injection (e.g. compacting / not streaming)
+
+Its synchronous `steered` result reflects immediate queue eligibility only; it
+cannot prove later runtime consumption. This limitation is why current LMA uses
+the public native steering path instead.

package/dist/session-file-compactor.d.ts

@@ -1,39 +0,0 @@
-export type ToolTrimResult = {
-    ok: boolean;
-    reason?: string;
-    /** Bytes before / after, and line counts, for reporting. */
-    bytesBefore?: number;
-    bytesAfter?: number;
-    linesBefore?: number;
-    linesAfter?: number;
-    removedToolResults?: number;
-    strippedToolCalls?: number;
-    removedEmptyAssistants?: number;
-    keptRecentToolCalls?: number;
-    backupPath?: string;
-};
-/**
- * Resolve the on-disk OpenClaw transcript file for a session.
- *
- * Session key looks like `agent:<agentId>:<label>` (e.g.
- * `agent:main:lma-claude-oc_xxx`). The transcript lives at
- * `<openclawHome>/agents/<agentId>/sessions/<sessionId>.jsonl`.
- */
-export declare function resolveSessionFilePath(sessionKey: string, sessionId: string, openclawHome?: string): string | null;
-/**
- * "Tool-trim" compaction: rewrite a session transcript in place, removing the
- * tool-call noise while keeping the conversation intact:
- *   - drop every toolResult message entirely;
- *   - strip the `toolCall` parts from assistant messages but KEEP their text
- *     (the model's "thinking out loud while acting"); if an assistant message
- *     had only tool calls and no text, drop the whole line;
- *   - fix `stopReason: "toolUse"` -> "stop" on messages that no longer have a
- *     tool call, so the loader is not confused.
- *
- * This does NOT call any model, so it works no matter how large the session is
- * (unlike OpenClaw's LLM-summary compaction, which itself fails to fit an
- * oversized session into the model). A backup is always written first.
- *
- * Typical reduction is ~70-90% for tool-heavy sessions.
- */
-export declare function toolTrimCompactFile(filePath: string, keepRecentToolCalls?: number): ToolTrimResult;

package/dist/session-file-compactor.js

@@ -1,176 +0,0 @@
-import { existsSync, copyFileSync, readFileSync, writeFileSync, renameSync } from "fs";
-import { join } from "path";
-import { homedir } from "os";
-/**
- * Resolve the on-disk OpenClaw transcript file for a session.
- *
- * Session key looks like `agent:<agentId>:<label>` (e.g.
- * `agent:main:lma-claude-oc_xxx`). The transcript lives at
- * `<openclawHome>/agents/<agentId>/sessions/<sessionId>.jsonl`.
- */
-export function resolveSessionFilePath(sessionKey, sessionId, openclawHome) {
-    if (!sessionId)
-        return null;
-    const home = openclawHome
-        || process.env.OPENCLAW_HOME
-        || process.env.OPENCLAW_CONFIG_DIR
-        || join(homedir(), ".openclaw");
-    // agentId is the second segment of agent:<agentId>:<label>; default to "main".
-    const parts = sessionKey.split(":");
-    const agentId = parts.length >= 3 && parts[0] === "agent" ? parts[1] : "main";
-    const file = join(home, "agents", agentId, "sessions", `${sessionId}.jsonl`);
-    return existsSync(file) ? file : null;
-}
-/**
- * "Tool-trim" compaction: rewrite a session transcript in place, removing the
- * tool-call noise while keeping the conversation intact:
- *   - drop every toolResult message entirely;
- *   - strip the `toolCall` parts from assistant messages but KEEP their text
- *     (the model's "thinking out loud while acting"); if an assistant message
- *     had only tool calls and no text, drop the whole line;
- *   - fix `stopReason: "toolUse"` -> "stop" on messages that no longer have a
- *     tool call, so the loader is not confused.
- *
- * This does NOT call any model, so it works no matter how large the session is
- * (unlike OpenClaw's LLM-summary compaction, which itself fails to fit an
- * oversized session into the model). A backup is always written first.
- *
- * Typical reduction is ~70-90% for tool-heavy sessions.
- */
-export function toolTrimCompactFile(filePath, keepRecentToolCalls = 3) {
-    if (!existsSync(filePath))
-        return { ok: false, reason: "transcript file not found" };
-    const original = readFileSync(filePath, "utf8");
-    const lines = original.split("\n");
-    const bytesBefore = Buffer.byteLength(original, "utf8");
-    // First pass: collect every toolCall id in order, so we can keep the most
-    // recent N of them (and their matching toolResults) intact. Recent tool calls
-    // are often still relevant to what the agent is doing next.
-    const toolCallIds = [];
-    for (const line of lines) {
-        if (line.trim() === "")
-            continue;
-        let d;
-        try {
-            d = JSON.parse(line);
-        }
-        catch {
-            continue;
-        }
-        if (d?.type !== "message")
-            continue;
-        const msg = d.message;
-        if (msg?.role === "assistant" && Array.isArray(msg.content)) {
-            for (const p of msg.content) {
-                if (p && typeof p === "object" && p.type === "toolCall" && p.id)
-                    toolCallIds.push(String(p.id));
-            }
-        }
-    }
-    const keepN = Math.max(0, Math.floor(keepRecentToolCalls));
-    const keepIds = new Set(keepN > 0 ? toolCallIds.slice(-keepN) : []);
-    const out = [];
-    let removedToolResults = 0;
-    let strippedToolCalls = 0;
-    let removedEmptyAssistants = 0;
-    let keptRecentToolCalls = 0;
-    let linesBefore = 0;
-    for (const line of lines) {
-        if (line.trim() === "") {
-            continue;
-        } // drop blank lines; we re-join with \n
-        linesBefore++;
-        let d;
-        try {
-            d = JSON.parse(line);
-        }
-        catch {
-            out.push(line);
-            continue;
-        }
-        if (d?.type !== "message") {
-            out.push(line);
-            continue;
-        }
-        const msg = d.message;
-        const role = msg?.role;
-        if (role === "toolResult") {
-            // Keep the toolResult only if its toolCall is in the recent keep-set.
-            if (msg?.toolCallId && keepIds.has(String(msg.toolCallId))) {
-                out.push(line);
-                continue;
-            }
-            removedToolResults++;
-            continue;
-        }
-        if (role === "assistant" && Array.isArray(msg?.content)) {
-            const content = msg.content;
-            const hasToolCall = content.some((p) => p && typeof p === "object" && p.type === "toolCall");
-            if (hasToolCall) {
-                // Keep toolCalls that are in the recent keep-set; strip the rest.
-                const kept = content.filter((p) => {
-                    if (!p || typeof p !== "object")
-                        return false;
-                    if (p.type !== "toolCall")
-                        return true;
-                    return p.id && keepIds.has(String(p.id));
-                });
-                const keptToolCall = kept.some((p) => p.type === "toolCall");
-                const hasText = kept.some((p) => p.type === "text" && typeof p.text === "string" && p.text.trim() !== "");
-                if (!keptToolCall && !hasText) {
-                    removedEmptyAssistants++;
-                    continue;
-                }
-                if (keptToolCall) {
-                    keptRecentToolCalls++;
-                    // stopReason stays toolUse since a toolCall remains.
-                    if (kept.length !== content.length)
-                        msg.content = kept;
-                    out.push(JSON.stringify(d));
-                    continue;
-                }
-                // All toolCalls stripped: keep text only, fix stopReason.
-                msg.content = kept;
-                if (msg.stopReason === "toolUse")
-                    msg.stopReason = "stop";
-                strippedToolCalls++;
-                out.push(JSON.stringify(d));
-                continue;
-            }
-        }
-        out.push(line);
-    }
-    // Safety: verify every output line is valid JSON before committing.
-    for (const l of out) {
-        try {
-            JSON.parse(l);
-        }
-        catch {
-            return { ok: false, reason: "produced invalid JSON; aborted" };
-        }
-    }
-    if (removedToolResults === 0 && strippedToolCalls === 0 && removedEmptyAssistants === 0) {
-        return { ok: true, reason: "no tool content to trim", bytesBefore, bytesAfter: bytesBefore, linesBefore, linesAfter: out.length, keptRecentToolCalls };
-    }
-    // Always back up first.
-    const stamp = new Date().toISOString().replace(/[:.]/g, "-");
-    const backupPath = `${filePath}.bak-tooltrim-${stamp}`;
-    copyFileSync(filePath, backupPath);
-    // Atomic write: temp file + rename.
-    const body = out.join("\n") + "\n";
-    const tmp = `${filePath}.tmp-tooltrim`;
-    writeFileSync(tmp, body, "utf8");
-    renameSync(tmp, filePath);
-    return {
-        ok: true,
-        bytesBefore,
-        bytesAfter: Buffer.byteLength(body, "utf8"),
-        linesBefore,
-        linesAfter: out.length,
-        removedToolResults,
-        strippedToolCalls,
-        removedEmptyAssistants,
-        keptRecentToolCalls,
-        backupPath,
-    };
-}