@xgjktech/xg_cwork_im 1.19.21 → 1.19.22

package/dist/src/turn/run-usage.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 一轮 dispatch 结束后的用量：从 OpenClaw session store 的结构化字段汇总，
+ * 供 WS `RUN_USAGE` 回传业务系统。
+ *
+ * 数据源唯一：`sessions.json` 中本 sessionKey 的 entry
+ * （agent-runner 在回合结束时写入 modelProvider / model / inputTokens / outputTokens 等）。
+ * 不解析 deliver 正文 usage footer / usage bar。
+ */
+import type { RunModelContext } from "../session/run-model-context.js";
+/** session store 中与用量相关的字段（子集） */
+export type SessionUsageFields = {
+    modelProvider?: string;
+    model?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    /** totalTokens 是否为最新上下文快照；false 表示已过期，前端以「~」近似展示 */
+    totalTokensFresh?: boolean;
+    /** 模型上下文窗口上限（圆环分母兜底） */
+    contextTokens?: number;
+    /** 提示词预算（contextBudgetStatus.promptBudgetBeforeReserve，圆环优先分母） */
+    promptBudgetBeforeReserve?: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+    estimatedCostUsd?: number;
+};
+export type RunUsageSnapshot = {
+    provider?: string;
+    model?: string;
+    modelRef?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    totalTokensFresh?: boolean;
+    contextTokens?: number;
+    promptBudgetBeforeReserve?: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+    estimatedCostUsd?: number;
+    runId?: string;
+    /** 固定为 session：结构化 session entry */
+    source: "session";
+};
+export type ImStreamRunUsageData = {
+    groupId: string;
+    replyToMsgId: string;
+    usage: RunUsageSnapshot;
+};
+/**
+ * entry 优先、`llm_output` 缓存兜底：entry 缺 model / contextTokens 时（preserveRuntimeModel
+ * 场景）用缓存的有效上下文预算与生效模型补全，保证前端用量圆环有分母。
+ */
+export declare function mergeRunModelContextFields(fields: SessionUsageFields, modelContext: RunModelContext): SessionUsageFields;
+/** 本轮是否值得发 RUN_USAGE（至少有模型或 token 之一）。 */
+export declare function hasReportableUsage(usage: RunUsageSnapshot | undefined): boolean;
+/**
+ * 从 session entry 构建用量快照。
+ * entry 缺字段时不捏造；完全无信息返回 undefined。
+ */
+export declare function buildRunUsageFromSessionEntry(entry: SessionUsageFields | undefined | null, opts?: {
+    runId?: string;
+}): RunUsageSnapshot | undefined;
+export declare function toImStreamRunUsageData(usage: RunUsageSnapshot, anchors: {
+    groupId: string;
+    replyToMsgId: string;
+}): ImStreamRunUsageData;
+//# sourceMappingURL=run-usage.d.ts.map

package/dist/src/turn/run-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-usage.d.ts","sourceRoot":"","sources":["../../../src/turn/run-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,kCAAkC;AAClC,MAAM,MAAM,kBAAkB,GAAG;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wBAAwB;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,MAAM,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,gBAAgB,CAAC;CAC3B,CAAC;AAaF;;;GAGG;AACH,wBAAgB,0BAA0B,CACtC,MAAM,EAAE,kBAAkB,EAC1B,YAAY,EAAE,eAAe,GAC9B,kBAAkB,CAWpB;AAED,0CAA0C;AAC1C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAa/E;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CACzC,KAAK,EAAE,kBAAkB,GAAG,SAAS,GAAG,IAAI,EAC5C,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,gBAAgB,GAAG,SAAS,CA0C9B;AAuBD,wBAAgB,sBAAsB,CAClC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACnD,oBAAoB,CAMtB"}

package/dist/src/turn/run-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-usage.js","sourceRoot":"","sources":["../../../src/turn/run-usage.ts"],"names":[],"mappings":"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"}

package/dist/src/turn/run-usage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-usage.test.d.ts","sourceRoot":"","sources":["../../../src/turn/run-usage.test.ts"],"names":[],"mappings":""}

package/dist/src/turn/run-usage.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-usage.test.js","sourceRoot":"","sources":["../../../src/turn/run-usage.test.ts"],"names":[],"mappings":"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"}

package/dist/src/turn/subagent-monitor.d.ts

@@ -0,0 +1,45 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/channel-plugin-common";
+import type { ImStreamClient } from "../connection/connection.js";
+interface SubagentSpawnInfo {
+    childSessionKey: string;
+    runId: string;
+    label?: string;
+}
+export interface InterruptedSubagent {
+    runId: string;
+    label: string;
+    status: "completed" | "suspended";
+    messages: string[];
+}
+export declare function setPluginApi(api: OpenClawPluginApi): void;
+export declare function getSubagentMonitorInstanceId(): string;
+export declare function startMonitor(params: {
+    roundKey: string;
+    generation: number;
+    groupId: string;
+    agentId: string;
+    streamClient: ImStreamClient;
+    replyToMsgId: string;
+    spawn: SubagentSpawnInfo;
+}): boolean;
+export declare function hasActiveSubagents(roundKey: string, generation: number): boolean;
+/** 子任务结束事件定位其所属轮次（供 turn-end-controller 递减活跃子任务数）。 */
+export declare function findChildRoundIndex(childSessionKey: string): {
+    roundKey: string;
+    generation: number;
+    runId: string;
+} | undefined;
+export declare function deferFinished(roundKey: string, generation: number, reason: string): void;
+export declare function prepareSubagentInterrupt(roundKey: string, generation: number, now?: number): InterruptedSubagent[];
+export declare function markSubagentCompleted(childSessionKey: string, runId?: string): void;
+/**
+ * 整轮收尾时（dispatch wrapper 在 turn-end-controller 放行后）清理本轮监控。
+ * 与 removeMonitor 的 settle 路径不同：此处轮次真正结束，直接拆监控与子任务索引。
+ */
+export declare function finalizeRoundMonitoring(roundKey: string, generation: number): void;
+export declare function __tickForTests(): Promise<void>;
+export declare function __resetSubagentMonitorForTests(): void;
+/** 插件卸载/重载时停掉 subagent-monitor 的全部轮询与状态，避免旧实例 ticker 泄漏。 */
+export declare function disposeSubagentMonitor(): void;
+export {};
+//# sourceMappingURL=subagent-monitor.d.ts.map

package/dist/src/turn/subagent-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-monitor.d.ts","sourceRoot":"","sources":["../../../src/turn/subagent-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAGnF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,UAAU,iBAAiB;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AA4BD,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,GAAG,WAAW,CAAC;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAkDD,wBAAgB,YAAY,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,CAsCzD;AA+CD,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAsCD,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,cAAc,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,iBAAiB,CAAC;CAC5B,GAAG,OAAO,CAsDV;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAOhF;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,CAC/B,eAAe,EAAE,MAAM,GACxB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAErE;AAED,wBAAgB,aAAa,CACzB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACf,IAAI,CAEN;AAED,wBAAgB,wBAAwB,CACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,GAAG,SAAa,GACjB,mBAAmB,EAAE,CAoBvB;AAED,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CA+CnF;AA4BD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAIlF;AAsKD,wBAAgB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9C;AAED,wBAAgB,8BAA8B,IAAI,IAAI,CAErD;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,IAAI,IAAI,CAW7C"}

package/dist/src/turn/subagent-monitor.js

@@ -0,0 +1,498 @@
+import { getOrCreateShared, getSharedMap } from "../plugin/process-shared-store.js";
+import { turnOnAllChildrenDone } from "./turn-end-controller.js";
+/** 模块实例 ID：用于确认插件是否被重复加载（若日志出现两个不同 id，则存在双实例，spawn/end 可能被不同实例处理）。 */
+const MODULE_INSTANCE_ID = `m${Date.now().toString(36)}${Math.random().toString(36).slice(2, 8)}`;
+console.log(`[subagent-monitor] module loaded instance=${MODULE_INSTANCE_ID} pid=${process.pid} title=${(process.title || "(none)").trim()}`);
+// 进程级共享：跨模块重载后监控不中断——各代模块读写同一份 maps/轮询/api 候选。
+const childToRound = getSharedMap("subagent-child-to-round");
+const roundMonitors = getSharedMap("subagent-round-monitors");
+const deferredFinished = getSharedMap("subagent-deferred-finished");
+const roundAdmissionTombstones = getSharedMap("subagent-round-admission-tombstones");
+/** 记录被 `/stop` 中断的 subagent run（按 childSessionKey 索引，存被中断 runId 与过期时间）。 */
+const childTombstones = getSharedMap("subagent-child-tombstones");
+const POLL_INTERVAL_MS = 15_000;
+/**
+ * apiCandidates 保留上限：OpenClaw 会对同一模块反复重注册（多代 registry 并存且从不触发
+ * cleanup，见日志 `registerSeq` 递增而 `cleanup` 为 0）。每代 register 都会 push 一个新 api 进
+ * 进程级 candidates，若不停老代则数组无限增长、引用无法回收。该数组仅作为「当前 runtime 探测
+ * 不可用时的回退池」（resolveUsablePluginApi），而单进程内 register 是按时间顺序的短爆发（通常
+ * 2~4 次），功能上只需最近几代即可，故截断更早的候选。
+ */
+const MAX_API_CANDIDATES = 4;
+const ROUND_TOMBSTONE_TTL_MS = 30_000;
+const CHILD_TOMBSTONE_TTL_MS = 5 * 60_000;
+const MAX_INCR_MSGS = 5;
+const MSG_TRUNCATE_LEN = 40;
+/** 单次 tick 用 openclaw `agent.wait` 对账 subagent run 状态的探测超时。 */
+const RUN_STATUS_PROBE_TIMEOUT_MS = 1_000;
+const m = getOrCreateShared("subagent-monitor-runtime", () => ({
+    api: null,
+    apiCandidates: [],
+    apiProbe: "unverified",
+    ticker: null,
+}));
+export function setPluginApi(api) {
+    const isNewCandidate = api !== m.api && !m.apiCandidates.includes(api);
+    if (isNewCandidate) {
+        m.apiCandidates.push(api);
+        if (m.apiCandidates.length > MAX_API_CANDIDATES) {
+            m.apiCandidates.splice(0, m.apiCandidates.length - MAX_API_CANDIDATES);
+        }
+    }
+    if (m.api === null) {
+        m.api = api;
+        m.apiProbe = "unverified";
+        console.log(`[subagent-monitor] setPluginApi instance=${MODULE_INSTANCE_ID} adopt=first`);
+        return;
+    }
+    if (m.apiProbe === "good") {
+        // 已有确认可用的 runtime：拒绝未验证的新 runtime 覆盖，防止无绑定 registry 劫持监控。
+        if (isNewCandidate) {
+            console.warn(`[subagent-monitor] setPluginApi instance=${MODULE_INSTANCE_ID} keep=verified ` +
+                `candidates=${m.apiCandidates.length}`);
+        }
+        return;
+    }
+    if (m.apiProbe === "unverified") {
+        // 当前尚未探测：不切换，等首次 tick 探测出结果再决定。
+        console.log(`[subagent-monitor] setPluginApi instance=${MODULE_INSTANCE_ID} keep=unverified ` +
+            `candidates=${m.apiCandidates.length}`);
+        return;
+    }
+    // 当前已确认为不可用：采纳新候选重新探测。
+    m.api = api;
+    m.apiProbe = "unverified";
+    console.log(`[subagent-monitor] setPluginApi instance=${MODULE_INSTANCE_ID} adopt=switch candidates=${m.apiCandidates.length}`);
+}
+function isRequestScopedSubagentError(err) {
+    return err instanceof Error && err.name === "RequestScopedSubagentRuntimeError";
+}
+/**
+ * 探测某个 plugin api 的 runtime.subagent 是否可用。
+ * RequestScopedSubagentRuntimeError = 绑定不可用（无绑定 registry / 非 gateway 上下文）；
+ * 其它结果（如 runId 不存在返回 error/timeout）说明绑定存在、dispatch 通了，视为可用。
+ */
+async function probeApiUsable(api) {
+    try {
+        await api.runtime.subagent.waitForRun({ runId: "probe", timeoutMs: 1 });
+        return true;
+    }
+    catch (err) {
+        return !isRequestScopedSubagentError(err);
+    }
+}
+/**
+ * 确认当前 m.api 可用；若不可用，尝试从候选里切回可用的 runtime。
+ * 返回最终使用的 m.api（所有候选都不可用时仍返回当前，由事件路径兜底）。
+ */
+async function resolveUsablePluginApi() {
+    if (!m.api)
+        return null;
+    if (m.apiProbe === "good")
+        return m.api;
+    if (await probeApiUsable(m.api)) {
+        m.apiProbe = "good";
+        return m.api;
+    }
+    for (const candidate of m.apiCandidates) {
+        if (candidate === m.api)
+            continue;
+        if (await probeApiUsable(candidate)) {
+            console.warn(`[subagent-monitor] m.api switch instance=${MODULE_INSTANCE_ID} ` +
+                `candidates=${m.apiCandidates.length}`);
+            m.api = candidate;
+            m.apiProbe = "good";
+            return m.api;
+        }
+    }
+    m.apiProbe = "bad";
+    return m.api;
+}
+export function getSubagentMonitorInstanceId() {
+    return MODULE_INSTANCE_ID;
+}
+function pruneTombstones(now = Date.now()) {
+    for (const [key, expiresAt] of roundAdmissionTombstones) {
+        if (expiresAt <= now)
+            roundAdmissionTombstones.delete(key);
+    }
+    for (const [key, tombstone] of childTombstones) {
+        if (tombstone.expiresAt <= now)
+            childTombstones.delete(key);
+    }
+}
+function stopTickerIfIdle() {
+    if (roundMonitors.size === 0 && m.ticker) {
+        clearInterval(m.ticker);
+        m.ticker = null;
+    }
+}
+function removeMonitor(monitor, reason) {
+    console.warn(`[subagent-monitor] removeMonitor instance=${MODULE_INSTANCE_ID} reason=${reason} roundKey=${monitor.roundKey} gen=${monitor.generation} ` +
+        `subagents=${Array.from(monitor.subagents.values()).map((r) => r.runId).join(",") || "(none)"}`);
+    if (roundMonitors.get(monitor.roundKey)?.generation === monitor.generation) {
+        roundMonitors.delete(monitor.roundKey);
+    }
+    if (deferredFinished.get(monitor.roundKey)?.generation === monitor.generation) {
+        deferredFinished.delete(monitor.roundKey);
+    }
+    for (const record of monitor.subagents.values()) {
+        const indexed = childToRound.get(record.childSessionKey);
+        if (indexed?.roundKey === monitor.roundKey && indexed.generation === monitor.generation) {
+            childToRound.delete(record.childSessionKey);
+        }
+    }
+    stopTickerIfIdle();
+}
+export function startMonitor(params) {
+    pruneTombstones();
+    if (roundAdmissionTombstones.has(params.roundKey)) {
+        console.warn(`[subagent-monitor] startMonitor rejected instance=${MODULE_INSTANCE_ID} reason=roundAdmissionTombstone roundKey=${params.roundKey} runId=${params.spawn.runId}`);
+        return false;
+    }
+    let monitor = roundMonitors.get(params.roundKey);
+    if (monitor && monitor.generation !== params.generation) {
+        removeMonitor(monitor, "generation-change");
+        monitor = undefined;
+    }
+    if (!monitor) {
+        monitor = {
+            roundKey: params.roundKey,
+            generation: params.generation,
+            groupId: params.groupId,
+            agentId: params.agentId,
+            streamClient: params.streamClient,
+            replyToMsgId: params.replyToMsgId,
+            subagents: new Map(),
+        };
+        roundMonitors.set(params.roundKey, monitor);
+    }
+    if (monitor.subagents.has(params.spawn.runId)) {
+        console.warn(`[subagent-monitor] startMonitor rejected instance=${MODULE_INSTANCE_ID} reason=duplicateRunId roundKey=${params.roundKey} runId=${params.spawn.runId}`);
+        return false;
+    }
+    const record = {
+        ...params.spawn,
+        lastMsgIndex: 0,
+        completed: false,
+        messages: [],
+        sendFrom: 0,
+        reading: false,
+    };
+    monitor.subagents.set(record.runId, record);
+    childToRound.set(record.childSessionKey, {
+        roundKey: monitor.roundKey,
+        generation: monitor.generation,
+        runId: record.runId,
+    });
+    console.warn(`[subagent-monitor] startMonitor ok instance=${MODULE_INSTANCE_ID} roundKey=${monitor.roundKey} gen=${monitor.generation} ` +
+        `childSessionKey=${record.childSessionKey} runId=${record.runId}`);
+    sendWsStat(monitor, monitor.streamClient);
+    ensureTickerRunning();
+    return true;
+}
+export function hasActiveSubagents(roundKey, generation) {
+    const monitor = roundMonitors.get(roundKey);
+    return Boolean(monitor &&
+        monitor.generation === generation &&
+        Array.from(monitor.subagents.values()).some((record) => !record.completed));
+}
+/** 子任务结束事件定位其所属轮次（供 turn-end-controller 递减活跃子任务数）。 */
+export function findChildRoundIndex(childSessionKey) {
+    return childToRound.get(childSessionKey);
+}
+export function deferFinished(roundKey, generation, reason) {
+    deferredFinished.set(roundKey, { reason, generation });
+}
+export function prepareSubagentInterrupt(roundKey, generation, now = Date.now()) {
+    pruneTombstones(now);
+    roundAdmissionTombstones.set(roundKey, now + ROUND_TOMBSTONE_TTL_MS);
+    const monitor = roundMonitors.get(roundKey);
+    if (!monitor || monitor.generation !== generation)
+        return [];
+    const result = Array.from(monitor.subagents.values()).map((record) => {
+        childTombstones.set(record.childSessionKey, {
+            runId: record.runId,
+            expiresAt: now + CHILD_TOMBSTONE_TTL_MS,
+        });
+        return {
+            runId: record.runId,
+            label: record.label ?? record.runId.slice(0, 8),
+            status: record.completed ? "completed" : "suspended",
+            messages: record.messages,
+        };
+    });
+    removeMonitor(monitor, "interrupt");
+    return result;
+}
+export function markSubagentCompleted(childSessionKey, runId) {
+    pruneTombstones();
+    // 仅拦截被 `/stop` 中断的同一 runId 的迟到结束事件；新 run（不同 runId 复用同 key）不受影响。
+    const tombstone = childTombstones.get(childSessionKey);
+    if (tombstone && runId && runId === tombstone.runId)
+        return;
+    const entry = childToRound.get(childSessionKey);
+    if (!entry) {
+        console.debug(`[subagent-monitor] markSubagentCompleted: no round entry instance=${MODULE_INSTANCE_ID} childSessionKey=${childSessionKey}`);
+        return;
+    }
+    console.debug(`[subagent-monitor] markSubagentCompleted: entry found instance=${MODULE_INSTANCE_ID} childSessionKey=${childSessionKey} runId=${runId ?? "(none)"} ` +
+        `roundKey=${entry.roundKey} gen=${entry.generation}`);
+    const monitor = roundMonitors.get(entry.roundKey);
+    if (!monitor || monitor.generation !== entry.generation) {
+        console.debug(`[subagent-monitor] markSubagentCompleted: monitor mismatch childSessionKey=${childSessionKey} runId=${runId ?? "(none)"} gen=${entry.generation}`);
+        return;
+    }
+    // runId 可能与 spawn 时不同（steer-restart / run 重建）：优先精确匹配，回退到 childSessionKey。
+    let record = runId ? monitor.subagents.get(runId) : undefined;
+    if (!record) {
+        record = Array.from(monitor.subagents.values()).find((r) => r.childSessionKey === childSessionKey);
+        if (record && runId && record.runId !== runId) {
+            console.debug(`[subagent-monitor] markSubagentCompleted: runId fallback childSessionKey=${childSessionKey} ` +
+                `eventRunId=${runId} recordRunId=${record.runId}`);
+        }
+    }
+    if (!record) {
+        console.debug(`[subagent-monitor] markSubagentCompleted: no record childSessionKey=${childSessionKey} runId=${runId ?? "(none)"}`);
+        return;
+    }
+    void (async () => {
+        try {
+            await readSubagentMessages(record);
+        }
+        catch (err) {
+            console.error(`[subagent-monitor] completion read failed: ${String(err)}`);
+        }
+        if (record.completed)
+            return;
+        record.completed = true;
+        await settleMonitorIfComplete(monitor);
+    })();
+}
+async function settleMonitorIfComplete(monitor) {
+    if (roundMonitors.get(monitor.roundKey) !== monitor)
+        return;
+    if (!Array.from(monitor.subagents.values()).every((record) => record.completed))
+        return;
+    const signature = statSignature(monitor);
+    if (signature === monitor.lastPushedSignature)
+        return;
+    // 整轮收尾（WS FINISHED + RUN_USAGE + completeActiveRound）改由 turn-end-controller 在
+    // 主会话出现非 yield 段终态（或静默兜底）后，由 dispatch wrapper 统一执行；
+    // 这里只负责推送 SUBAGENT_STAT 快照，绝不自行 end/remove/complete ——
+    // OpenClaw 7.1+/8.x 中「所有已知子任务完成」不代表整轮结束（主会话可能 resume
+    // 继续派发新一批子任务），因此本快照允许多波次多次推送，仅对完全相同的状态去重。
+    try {
+        await sendFinalStat(monitor, monitor.streamClient);
+        for (const record of monitor.subagents.values()) {
+            record.sendFrom = record.messages.length;
+        }
+        monitor.lastPushedSignature = signature;
+        console.log(`[subagent-monitor] final SUBAGENT_STAT sent (settle) roundKey=${monitor.roundKey} gen=${monitor.generation} ` +
+            `subagents=${Array.from(monitor.subagents.values()).length} — waiting turn-end for FINISHED`);
+    }
+    catch (err) {
+        console.error(`[subagent-monitor] final state send failed: ${String(err)}`);
+    }
+    turnOnAllChildrenDone(monitor.roundKey, monitor.generation);
+}
+/**
+ * 整轮收尾时（dispatch wrapper 在 turn-end-controller 放行后）清理本轮监控。
+ * 与 removeMonitor 的 settle 路径不同：此处轮次真正结束，直接拆监控与子任务索引。
+ */
+export function finalizeRoundMonitoring(roundKey, generation) {
+    const monitor = roundMonitors.get(roundKey);
+    if (!monitor || monitor.generation !== generation)
+        return;
+    removeMonitor(monitor, "round-finished");
+}
+async function readSubagentMessages(record) {
+    if (!m.api || record.reading)
+        return;
+    record.reading = true;
+    try {
+        let messages = [];
+        try {
+            const result = await m.api.runtime.subagent.getSessionMessages({
+                sessionKey: record.childSessionKey,
+            });
+            messages = Array.isArray(result.messages) ? result.messages : [];
+        }
+        catch (err) {
+            // runtime.subagent 可能只在 gateway 请求上下文内可用（openclaw 7.x request-scoped）；
+            // 读取失败不能拖垮整个 tick，这里吞掉并继续，消息下次再拉。
+            console.warn(`[subagent-monitor] getSessionMessages failed childSessionKey=${record.childSessionKey} runId=${record.runId}: ${String(err)}`);
+        }
+        for (const msg of messages.slice(record.lastMsgIndex))
+            record.messages.push(cleanMsg(msg));
+        record.lastMsgIndex = messages.length;
+    }
+    finally {
+        record.reading = false;
+    }
+}
+/**
+ * 用 openclaw 权威 run 状态对账：run 已结束（ok/error）返回 true，仍在运行（timeout）返回 false。
+ * 探测失败（如 runId 已不存在、状态码异常）保守按「仍在运行」处理，交给事件路径兜底。
+ */
+async function probeRunStatus(record) {
+    if (!m.api)
+        return false;
+    try {
+        const result = await m.api.runtime.subagent.waitForRun({
+            runId: record.runId,
+            timeoutMs: RUN_STATUS_PROBE_TIMEOUT_MS,
+        });
+        return result.status !== "timeout";
+    }
+    catch (err) {
+        console.warn(`[subagent-monitor] waitForRun probe failed runId=${record.runId}: ${String(err)}`);
+        return false;
+    }
+}
+function ensureTickerRunning() {
+    if (m.ticker)
+        return;
+    void tick();
+    m.ticker = setInterval(() => void tick(), POLL_INTERVAL_MS);
+    m.ticker.unref?.();
+}
+async function tick() {
+    if (roundMonitors.size === 0) {
+        stopTickerIfIdle();
+        return;
+    }
+    // 确保使用可用的 runtime：探测并必要时切回候选中的可用 api，避免坏 runtime 继续抛 RequestScoped。
+    await resolveUsablePluginApi();
+    for (const monitor of Array.from(roundMonitors.values())) {
+        try {
+            const runningRecords = Array.from(monitor.subagents.values()).filter((record) => !record.completed);
+            await Promise.all(runningRecords.map((record) => readSubagentMessages(record)));
+            if (roundMonitors.get(monitor.roundKey) !== monitor)
+                continue;
+            // 并行对账：已结束的 run 在 gateway 侧有 terminal snapshot 缓存，立即返回；仍在跑的会阻塞至探测超时。
+            await Promise.all(runningRecords.map(async (record) => {
+                if (record.completed)
+                    return;
+                if (await probeRunStatus(record))
+                    record.completed = true;
+            }));
+            if (roundMonitors.get(monitor.roundKey) !== monitor)
+                continue;
+            sendWsStat(monitor, monitor.streamClient);
+            await settleMonitorIfComplete(monitor);
+        }
+        catch (err) {
+            console.error(`[subagent-monitor] poll failed roundKey=${monitor.roundKey}: ${String(err)}`);
+        }
+    }
+    stopTickerIfIdle();
+}
+function cleanMsg(msg) {
+    if (!msg || typeof msg !== "object")
+        return "";
+    const src = msg;
+    const role = typeof src.role === "string" ? src.role : "";
+    if (role === "user")
+        return "";
+    if (role === "toolResult" || role === "tool" || typeof src.toolCallId === "string") {
+        const toolName = typeof src.toolName === "string" && src.toolName.trim() ? src.toolName.trim() : "工具";
+        return `[工具] ${toolName} 已调用`;
+    }
+    if (role !== "assistant")
+        return "";
+    const content = Array.isArray(src.content)
+        ? src.content
+        : typeof src.content === "string"
+            ? [{ type: "text", text: src.content }]
+            : [];
+    let text = "";
+    let toolCount = 0;
+    for (const part of content) {
+        if (!part || typeof part !== "object")
+            continue;
+        const value = part;
+        if (value.type === "text" && typeof value.text === "string")
+            text += value.text;
+        else if (value.type === "toolCall" || value.type === "tool_use")
+            toolCount += 1;
+    }
+    if (text.length > MSG_TRUNCATE_LEN)
+        text = `${text.slice(0, MSG_TRUNCATE_LEN)}…`;
+    return `[助手] ${text}${toolCount > 0 ? ` [调用${toolCount}个工具]` : ""}`;
+}
+function toSubagentList(monitor, incremental) {
+    return Array.from(monitor.subagents.values()).map((record) => ({
+        runId: record.runId,
+        label: record.label ?? record.runId.slice(0, 8),
+        status: record.completed ? "completed" : "running",
+        messages: incremental
+            ? record.messages.slice(record.sendFrom, record.sendFrom + MAX_INCR_MSGS)
+            : record.messages,
+    }));
+}
+/**
+ * 客户端可见状态的稳定签名：新增子任务、状态翻转（running→completed）或消息数变化都会改变。
+ * 仅凭它做「无变化不重复推送」的去重；同一轮多波次派发不会被锁死。
+ */
+function statSignature(monitor) {
+    return Array.from(monitor.subagents.values())
+        .map((r) => `${r.runId}:${r.completed ? "completed" : "running"}:${r.messages.length}`)
+        .join("|");
+}
+function sendWsStat(monitor, client) {
+    const signature = statSignature(monitor);
+    // 有 running 子任务时保持逐 tick 推送（running/新增消息语义不变）；
+    // 全部已完成且状态无变化（等 turn-end 的空窗）则去重，避免 tick 刷同一份完成快照。
+    const hasRunning = Array.from(monitor.subagents.values()).some((r) => !r.completed);
+    if (!hasRunning && signature === monitor.lastPushedSignature)
+        return;
+    const subagentList = toSubagentList(monitor, true);
+    client
+        .sendEvent({
+        groupId: monitor.groupId,
+        replyToMsgId: monitor.replyToMsgId,
+        event: "SUBAGENT_STAT",
+        data: { subagentList },
+    })
+        .then(() => {
+        subagentList.forEach((item) => {
+            const record = monitor.subagents.get(item.runId);
+            if (record)
+                record.sendFrom += item.messages.length;
+        });
+        monitor.lastPushedSignature = signature;
+    })
+        .catch((err) => {
+        console.error(`[subagent-monitor] SUBAGENT_STAT failed: ${String(err)}`);
+    });
+}
+async function sendFinalStat(monitor, client) {
+    await client.sendEvent({
+        groupId: monitor.groupId,
+        replyToMsgId: monitor.replyToMsgId,
+        event: "SUBAGENT_STAT",
+        data: { subagentList: toSubagentList(monitor, false) },
+    });
+}
+export function __tickForTests() {
+    return tick();
+}
+export function __resetSubagentMonitorForTests() {
+    disposeSubagentMonitor();
+}
+/** 插件卸载/重载时停掉 subagent-monitor 的全部轮询与状态，避免旧实例 ticker 泄漏。 */
+export function disposeSubagentMonitor() {
+    if (m.ticker)
+        clearInterval(m.ticker);
+    m.ticker = null;
+    m.api = null;
+    m.apiProbe = "unverified";
+    m.apiCandidates.length = 0;
+    childToRound.clear();
+    roundMonitors.clear();
+    deferredFinished.clear();
+    roundAdmissionTombstones.clear();
+    childTombstones.clear();
+}
+//# sourceMappingURL=subagent-monitor.js.map