@xgjktech/xg_cwork_im 1.19.22 → 1.19.23

package/dist/src/run-model-context.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 回合内「生效模型 + 有效上下文预算」的进程级缓存。
+ *
+ * 背景：OpenClaw 在 `preserveRuntimeModel`（模型 fallback / live switch 等）场景下，
+ * session entry 只写用量、不写 `model` / `contextTokens`，导致插件从 entry 读不到
+ * 上下文窗口，前端用量圆环拿不到分母。
+ *
+ * 数据源：OpenClaw 的 `llm_output` hook 事件带 `contextTokenBudget`（解析后的有效
+ * 上下文预算）、`contextWindowSource`、`provider` / `model` / `resolvedRef`，
+ * 且发生在嵌入式 runner 回合结束时（早于 FINISHED），可作 entry 缺字段时的兜底。
+ *
+ * 进程级共享（getSharedMap）：跨模块热重载存活，与 per-message-model-pending 同一套机制。
+ */
+/** llm_output 事件中与用量圆环相关的字段（结构化子集，避免依赖宿主内部类型）。 */
+export interface RunModelContextInput {
+    provider?: string;
+    model?: string;
+    resolvedRef?: string;
+    contextTokenBudget?: number;
+    contextWindowSource?: string;
+    contextWindowReferenceTokens?: number;
+    runId?: string;
+}
+export interface RunModelContext {
+    provider?: string;
+    model?: string;
+    resolvedRef?: string;
+    /** 解析后的有效上下文预算（圆环分母兜底）。 */
+    contextTokenBudget?: number;
+    contextWindowSource?: string;
+    contextWindowReferenceTokens?: number;
+    runId?: string;
+    updatedAt: number;
+}
+/** 记录一次 llm_output（按 sessionKey 覆盖；空 sessionKey 忽略）。 */
+export declare function recordRunModelContext(sessionKey: string | undefined, input: RunModelContextInput): RunModelContext | undefined;
+/** 读取某 session 最近一次 llm_output 的模型上下文（过期返回 undefined）。 */
+export declare function readRunModelContext(sessionKey: string | undefined): RunModelContext | undefined;
+/** 清除某 session 的记录。 */
+export declare function clearRunModelContext(sessionKey: string | undefined): void;
+/** 插件卸载/重载时清空全部记录。 */
+export declare function clearAllRunModelContext(): void;
+/** 仅供测试：直接写入/读取内部 map 的条目数。 */
+export declare function __runModelContextSizeForTests(): number;
+//# sourceMappingURL=run-model-context.d.ts.map

package/dist/src/run-model-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-model-context.d.ts","sourceRoot":"","sources":["../../src/run-model-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,kDAAkD;AAClD,MAAM,WAAW,oBAAoB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACrB;AA4BD,wDAAwD;AACxD,wBAAgB,qBAAqB,CACjC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,KAAK,EAAE,oBAAoB,GAC5B,eAAe,GAAG,SAAS,CAyC7B;AAED,0DAA0D;AAC1D,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,CAU/F;AAED,uBAAuB;AACvB,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAIzE;AAED,sBAAsB;AACtB,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED,+BAA+B;AAC/B,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD"}

package/dist/src/run-model-context.js

@@ -0,0 +1,108 @@
+/**
+ * 回合内「生效模型 + 有效上下文预算」的进程级缓存。
+ *
+ * 背景：OpenClaw 在 `preserveRuntimeModel`（模型 fallback / live switch 等）场景下，
+ * session entry 只写用量、不写 `model` / `contextTokens`，导致插件从 entry 读不到
+ * 上下文窗口，前端用量圆环拿不到分母。
+ *
+ * 数据源：OpenClaw 的 `llm_output` hook 事件带 `contextTokenBudget`（解析后的有效
+ * 上下文预算）、`contextWindowSource`、`provider` / `model` / `resolvedRef`，
+ * 且发生在嵌入式 runner 回合结束时（早于 FINISHED），可作 entry 缺字段时的兜底。
+ *
+ * 进程级共享（getSharedMap）：跨模块热重载存活，与 per-message-model-pending 同一套机制。
+ */
+import { getSharedMap } from "./process-shared-store.js";
+/** 缓存条目上限（防御无界增长）。 */
+const MAX_ENTRIES = 500;
+/** 条目有效期：超过则视为过期（避免用上一轮/陈旧预算）。 */
+const TTL_MS = 10 * 60_000;
+const bySessionKey = getSharedMap("run-model-context");
+function nonEmpty(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const text = value.trim();
+    return text.length > 0 ? text : undefined;
+}
+function positiveInt(value) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0)
+        return undefined;
+    return Math.round(value);
+}
+function pruneExpired(now) {
+    for (const [key, entry] of bySessionKey) {
+        if (now - entry.updatedAt > TTL_MS) {
+            bySessionKey.delete(key);
+        }
+    }
+}
+/** 记录一次 llm_output（按 sessionKey 覆盖；空 sessionKey 忽略）。 */
+export function recordRunModelContext(sessionKey, input) {
+    const key = nonEmpty(sessionKey);
+    if (!key)
+        return undefined;
+    const provider = nonEmpty(input.provider);
+    const model = nonEmpty(input.model);
+    const resolvedRef = nonEmpty(input.resolvedRef);
+    const contextTokenBudget = positiveInt(input.contextTokenBudget);
+    const contextWindowSource = nonEmpty(input.contextWindowSource);
+    const contextWindowReferenceTokens = positiveInt(input.contextWindowReferenceTokens);
+    const runId = nonEmpty(input.runId);
+    const now = Date.now();
+    pruneExpired(now);
+    if (!bySessionKey.has(key) && bySessionKey.size >= MAX_ENTRIES) {
+        // 容量兜底：淘汰最旧一条。
+        let oldestKey;
+        let oldestAt = Number.POSITIVE_INFINITY;
+        for (const [candidateKey, entry] of bySessionKey) {
+            if (entry.updatedAt < oldestAt) {
+                oldestAt = entry.updatedAt;
+                oldestKey = candidateKey;
+            }
+        }
+        if (oldestKey !== undefined) {
+            bySessionKey.delete(oldestKey);
+        }
+    }
+    const context = {
+        ...(provider ? { provider } : {}),
+        ...(model ? { model } : {}),
+        ...(resolvedRef ? { resolvedRef } : {}),
+        ...(contextTokenBudget != null ? { contextTokenBudget } : {}),
+        ...(contextWindowSource ? { contextWindowSource } : {}),
+        ...(contextWindowReferenceTokens != null ? { contextWindowReferenceTokens } : {}),
+        ...(runId ? { runId } : {}),
+        updatedAt: now,
+    };
+    bySessionKey.set(key, context);
+    return context;
+}
+/** 读取某 session 最近一次 llm_output 的模型上下文（过期返回 undefined）。 */
+export function readRunModelContext(sessionKey) {
+    const key = nonEmpty(sessionKey);
+    if (!key)
+        return undefined;
+    const entry = bySessionKey.get(key);
+    if (!entry)
+        return undefined;
+    if (Date.now() - entry.updatedAt > TTL_MS) {
+        bySessionKey.delete(key);
+        return undefined;
+    }
+    return entry;
+}
+/** 清除某 session 的记录。 */
+export function clearRunModelContext(sessionKey) {
+    const key = nonEmpty(sessionKey);
+    if (!key)
+        return;
+    bySessionKey.delete(key);
+}
+/** 插件卸载/重载时清空全部记录。 */
+export function clearAllRunModelContext() {
+    bySessionKey.clear();
+}
+/** 仅供测试：直接写入/读取内部 map 的条目数。 */
+export function __runModelContextSizeForTests() {
+    return bySessionKey.size;
+}
+//# sourceMappingURL=run-model-context.js.map

package/dist/src/run-model-context.js.map

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

package/dist/src/run-model-context.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run-model-context.test.d.ts.map

package/dist/src/run-model-context.test.d.ts.map

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

package/dist/src/run-model-context.test.js

@@ -0,0 +1,68 @@
+import assert from "node:assert/strict";
+import { beforeEach, describe, it } from "node:test";
+import { __runModelContextSizeForTests, clearAllRunModelContext, clearRunModelContext, readRunModelContext, recordRunModelContext, } from "./run-model-context.js";
+describe("run-model-context", () => {
+    beforeEach(() => {
+        clearAllRunModelContext();
+    });
+    it("records and reads the latest llm_output context per session", () => {
+        recordRunModelContext("session-1", {
+            provider: "openai",
+            model: "gpt-5.5",
+            resolvedRef: "openai/gpt-5.5",
+            contextTokenBudget: 200_000,
+            contextWindowSource: "model",
+            contextWindowReferenceTokens: 200_000,
+            runId: "run-1",
+        });
+        const ctx = readRunModelContext("session-1");
+        assert.ok(ctx);
+        assert.equal(ctx.provider, "openai");
+        assert.equal(ctx.model, "gpt-5.5");
+        assert.equal(ctx.resolvedRef, "openai/gpt-5.5");
+        assert.equal(ctx.contextTokenBudget, 200_000);
+        assert.equal(ctx.contextWindowSource, "model");
+        assert.equal(ctx.contextWindowReferenceTokens, 200_000);
+        assert.equal(ctx.runId, "run-1");
+        assert.equal(typeof ctx.updatedAt, "number");
+    });
+    it("overwrites the previous entry for the same session", () => {
+        recordRunModelContext("session-1", { model: "a", contextTokenBudget: 100_000 });
+        recordRunModelContext("session-1", { model: "b", contextTokenBudget: 128_000 });
+        const ctx = readRunModelContext("session-1");
+        assert.equal(ctx.model, "b");
+        assert.equal(ctx.contextTokenBudget, 128_000);
+        assert.equal(__runModelContextSizeForTests(), 1);
+    });
+    it("isolates sessions", () => {
+        recordRunModelContext("session-1", { model: "a", contextTokenBudget: 100_000 });
+        recordRunModelContext("session-2", { model: "b", contextTokenBudget: 200_000 });
+        assert.equal(readRunModelContext("session-1").model, "a");
+        assert.equal(readRunModelContext("session-2").model, "b");
+        assert.equal(readRunModelContext("session-3"), undefined);
+    });
+    it("ignores empty session key and empty input", () => {
+        assert.equal(recordRunModelContext("", { model: "a" }), undefined);
+        assert.equal(recordRunModelContext(undefined, { model: "a" }), undefined);
+        const recorded = recordRunModelContext("session-1", {});
+        assert.ok(recorded);
+        assert.equal(recorded.model, undefined);
+        assert.equal(recorded.contextTokenBudget, undefined);
+    });
+    it("drops non-positive / non-finite context budgets", () => {
+        recordRunModelContext("session-1", { contextTokenBudget: 0 });
+        assert.equal(readRunModelContext("session-1").contextTokenBudget, undefined);
+        recordRunModelContext("session-1", { contextTokenBudget: -5 });
+        assert.equal(readRunModelContext("session-1").contextTokenBudget, undefined);
+        recordRunModelContext("session-1", { contextTokenBudget: Number.NaN });
+        assert.equal(readRunModelContext("session-1").contextTokenBudget, undefined);
+    });
+    it("clearRunModelContext removes a single session", () => {
+        recordRunModelContext("session-1", { model: "a" });
+        recordRunModelContext("session-2", { model: "b" });
+        clearRunModelContext("session-1");
+        assert.equal(readRunModelContext("session-1"), undefined);
+        assert.equal(readRunModelContext("session-2").model, "b");
+    });
+});
+//# sourceMappingURL=run-model-context.test.js.map

package/dist/src/run-model-context.test.js.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * 从 OpenClaw session store 读取本轮结束后的用量 entry。
+ * 使用 `skipCache: true`，避免读到 dispatch 前的缓存快照。
+ *
+ * entry 缺 `model` / `contextTokens` 时（preserveRuntimeModel 场景），用 `llm_output`
+ * 缓存的「生效模型 + 有效上下文预算」兜底，保证前端用量圆环有分母。
+ */
+import { type SessionUsageFields } from "./run-usage.js";
+export declare function readSessionUsageFields(args: {
+    storePath: string;
+    sessionKey: string;
+}): SessionUsageFields | undefined;
+//# sourceMappingURL=run-usage-session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-usage-session.d.ts","sourceRoot":"","sources":["../../src/run-usage-session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAA8B,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGrF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACtB,GAAG,kBAAkB,GAAG,SAAS,CAYjC"}

package/dist/src/run-usage-session.js

@@ -0,0 +1,41 @@
+/**
+ * 从 OpenClaw session store 读取本轮结束后的用量 entry。
+ * 使用 `skipCache: true`，避免读到 dispatch 前的缓存快照。
+ *
+ * entry 缺 `model` / `contextTokens` 时（preserveRuntimeModel 场景），用 `llm_output`
+ * 缓存的「生效模型 + 有效上下文预算」兜底，保证前端用量圆环有分母。
+ */
+import { loadSessionStore, resolveSessionStoreEntry, } from "openclaw/plugin-sdk/session-store-runtime";
+import { mergeRunModelContextFields } from "./run-usage.js";
+import { readRunModelContext } from "./run-model-context.js";
+export function readSessionUsageFields(args) {
+    const storePath = args.storePath?.trim();
+    const sessionKey = args.sessionKey?.trim();
+    if (!storePath || !sessionKey)
+        return undefined;
+    const store = loadSessionStore(storePath, { skipCache: true });
+    const { existing } = resolveSessionStoreEntry({ store, sessionKey });
+    if (!existing)
+        return undefined;
+    const fields = pickUsageFields(existing);
+    const modelContext = readRunModelContext(sessionKey);
+    return modelContext ? mergeRunModelContextFields(fields, modelContext) : fields;
+}
+function pickUsageFields(entry) {
+    return {
+        ...(entry.modelProvider != null ? { modelProvider: entry.modelProvider } : {}),
+        ...(entry.model != null ? { model: entry.model } : {}),
+        ...(entry.inputTokens != null ? { inputTokens: entry.inputTokens } : {}),
+        ...(entry.outputTokens != null ? { outputTokens: entry.outputTokens } : {}),
+        ...(entry.totalTokens != null ? { totalTokens: entry.totalTokens } : {}),
+        ...(entry.totalTokensFresh != null ? { totalTokensFresh: entry.totalTokensFresh } : {}),
+        ...(entry.contextTokens != null ? { contextTokens: entry.contextTokens } : {}),
+        ...(entry.contextBudgetStatus?.promptBudgetBeforeReserve != null
+            ? { promptBudgetBeforeReserve: entry.contextBudgetStatus.promptBudgetBeforeReserve }
+            : {}),
+        ...(entry.cacheRead != null ? { cacheRead: entry.cacheRead } : {}),
+        ...(entry.cacheWrite != null ? { cacheWrite: entry.cacheWrite } : {}),
+        ...(entry.estimatedCostUsd != null ? { estimatedCostUsd: entry.estimatedCostUsd } : {}),
+    };
+}
+//# sourceMappingURL=run-usage-session.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-usage-session.js","sourceRoot":"","sources":["../../src/run-usage-session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACH,gBAAgB,EAChB,wBAAwB,GAE3B,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,0BAA0B,EAA2B,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,UAAU,sBAAsB,CAAC,IAGtC;IACG,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;IACzC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAEhD,MAAM,KAAK,GAAG,gBAAgB,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,MAAM,EAAE,QAAQ,EAAE,GAAG,wBAAwB,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhC,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,YAAY,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACrD,OAAO,YAAY,CAAC,CAAC,CAAC,0BAA0B,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AACpF,CAAC;AAED,SAAS,eAAe,CAAC,KAAmB;IACxC,OAAO;QACH,GAAG,CAAC,KAAK,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,KAAK,CAAC,gBAAgB,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,GAAG,CAAC,KAAK,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,GAAG,CAAC,KAAK,CAAC,mBAAmB,EAAE,yBAAyB,IAAI,IAAI;YAC5D,CAAC,CAAC,EAAE,yBAAyB,EAAE,KAAK,CAAC,mBAAmB,CAAC,yBAAyB,EAAE;YACpF,CAAC,CAAC,EAAE,CAAC;QACT,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,GAAG,CAAC,KAAK,CAAC,gBAAgB,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1F,CAAC;AACN,CAAC"}

package/dist/src/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 "./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/run-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-usage.d.ts","sourceRoot":"","sources":["../../src/run-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,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/run-usage.js

@@ -0,0 +1,119 @@
+/**
+ * 一轮 dispatch 结束后的用量：从 OpenClaw session store 的结构化字段汇总，
+ * 供 WS `RUN_USAGE` 回传业务系统。
+ *
+ * 数据源唯一：`sessions.json` 中本 sessionKey 的 entry
+ * （agent-runner 在回合结束时写入 modelProvider / model / inputTokens / outputTokens 等）。
+ * 不解析 deliver 正文 usage footer / usage bar。
+ */
+function positiveInt(n) {
+    if (typeof n !== "number" || !Number.isFinite(n) || n < 0)
+        return undefined;
+    return Math.round(n);
+}
+function nonEmpty(s) {
+    if (typeof s !== "string")
+        return undefined;
+    const t = s.trim();
+    return t.length > 0 ? t : undefined;
+}
+/**
+ * entry 优先、`llm_output` 缓存兜底：entry 缺 model / contextTokens 时（preserveRuntimeModel
+ * 场景）用缓存的有效上下文预算与生效模型补全，保证前端用量圆环有分母。
+ */
+export function mergeRunModelContextFields(fields, modelContext) {
+    return {
+        ...fields,
+        ...(fields.modelProvider == null && modelContext.provider
+            ? { modelProvider: modelContext.provider }
+            : {}),
+        ...(fields.model == null && modelContext.model ? { model: modelContext.model } : {}),
+        ...(fields.contextTokens == null && modelContext.contextTokenBudget != null
+            ? { contextTokens: modelContext.contextTokenBudget }
+            : {}),
+    };
+}
+/** 本轮是否值得发 RUN_USAGE（至少有模型或 token 之一）。 */
+export function hasReportableUsage(usage) {
+    if (!usage)
+        return false;
+    if (usage.modelRef || usage.model || usage.provider)
+        return true;
+    if (usage.inputTokens != null ||
+        usage.outputTokens != null ||
+        usage.totalTokens != null ||
+        usage.cacheReadTokens != null ||
+        usage.cacheWriteTokens != null) {
+        return true;
+    }
+    return false;
+}
+/**
+ * 从 session entry 构建用量快照。
+ * entry 缺字段时不捏造；完全无信息返回 undefined。
+ */
+export function buildRunUsageFromSessionEntry(entry, opts) {
+    if (!entry)
+        return undefined;
+    const provider = nonEmpty(entry.modelProvider);
+    const model = nonEmpty(entry.model);
+    const modelRef = provider && model ? `${provider}/${model}` : model || undefined;
+    const inputTokens = positiveInt(entry.inputTokens);
+    const outputTokens = positiveInt(entry.outputTokens);
+    const cacheReadTokens = positiveInt(entry.cacheRead);
+    const cacheWriteTokens = positiveInt(entry.cacheWrite);
+    const estimatedCostUsd = typeof entry.estimatedCostUsd === "number" && Number.isFinite(entry.estimatedCostUsd)
+        ? entry.estimatedCostUsd
+        : undefined;
+    // totalTokens 为 OpenClaw 上下文 prompt 快照，用于「当前会话用量圆环」的分子。
+    // 缺 entry 值时**不做** input+output 兜底，避免把计费合计误当上下文占用。
+    const totalTokens = positiveInt(entry.totalTokens);
+    const totalTokensFresh = typeof entry.totalTokensFresh === "boolean" ? entry.totalTokensFresh : undefined;
+    const contextTokens = positiveInt(entry.contextTokens);
+    const promptBudgetBeforeReserve = positiveInt(entry.promptBudgetBeforeReserve);
+    const snapshot = {
+        ...(provider ? { provider } : {}),
+        ...(model ? { model } : {}),
+        ...(modelRef ? { modelRef } : {}),
+        ...(inputTokens != null ? { inputTokens } : {}),
+        ...(outputTokens != null ? { outputTokens } : {}),
+        ...(totalTokens != null ? { totalTokens } : {}),
+        ...(totalTokensFresh != null ? { totalTokensFresh } : {}),
+        ...(contextTokens != null ? { contextTokens } : {}),
+        ...(promptBudgetBeforeReserve != null ? { promptBudgetBeforeReserve } : {}),
+        ...(cacheReadTokens != null ? { cacheReadTokens } : {}),
+        ...(cacheWriteTokens != null ? { cacheWriteTokens } : {}),
+        ...(estimatedCostUsd != null ? { estimatedCostUsd } : {}),
+        ...(opts?.runId?.trim() ? { runId: opts.runId.trim() } : {}),
+        source: "session",
+    };
+    return hasReportableUsage(snapshot) ? snapshot : undefined;
+}
+function runUsageSnapshotToWire(usage) {
+    return {
+        source: usage.source,
+        ...(usage.provider ? { provider: usage.provider } : {}),
+        ...(usage.model ? { model: usage.model } : {}),
+        ...(usage.modelRef ? { modelRef: usage.modelRef } : {}),
+        ...(usage.inputTokens != null ? { inputTokens: usage.inputTokens } : {}),
+        ...(usage.outputTokens != null ? { outputTokens: usage.outputTokens } : {}),
+        ...(usage.totalTokens != null ? { totalTokens: usage.totalTokens } : {}),
+        ...(usage.totalTokensFresh != null ? { totalTokensFresh: usage.totalTokensFresh } : {}),
+        ...(usage.contextTokens != null ? { contextTokens: usage.contextTokens } : {}),
+        ...(usage.promptBudgetBeforeReserve != null
+            ? { promptBudgetBeforeReserve: usage.promptBudgetBeforeReserve }
+            : {}),
+        ...(usage.cacheReadTokens != null ? { cacheReadTokens: usage.cacheReadTokens } : {}),
+        ...(usage.cacheWriteTokens != null ? { cacheWriteTokens: usage.cacheWriteTokens } : {}),
+        ...(usage.estimatedCostUsd != null ? { estimatedCostUsd: usage.estimatedCostUsd } : {}),
+        ...(usage.runId ? { runId: usage.runId } : {}),
+    };
+}
+export function toImStreamRunUsageData(usage, anchors) {
+    return {
+        groupId: anchors.groupId,
+        replyToMsgId: anchors.replyToMsgId,
+        usage: runUsageSnapshotToWire(usage),
+    };
+}
+//# sourceMappingURL=run-usage.js.map

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

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run-usage.test.d.ts.map

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

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