tokenusage-cli 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (131) hide show
  1. package/CHANGELOG.md +39 -19
  2. package/LICENSE +22 -22
  3. package/README.md +94 -94
  4. package/THIRD_PARTY_NOTICES.md +140 -140
  5. package/bin/tokenusage.js +69 -69
  6. package/package.json +59 -59
  7. package/src/cli.js +146 -134
  8. package/src/commands/device-login.js +205 -205
  9. package/src/commands/diagnostics.js +38 -38
  10. package/src/commands/doctor.js +110 -110
  11. package/src/commands/init.js +2484 -2436
  12. package/src/commands/pause.js +77 -0
  13. package/src/commands/sessions.js +29 -29
  14. package/src/commands/status.js +1758 -1747
  15. package/src/commands/sync.js +8048 -7934
  16. package/src/commands/uninstall.js +322 -312
  17. package/src/lib/account-usage-dedup.js +267 -267
  18. package/src/lib/antigravity-paths.js +48 -48
  19. package/src/lib/ark-agent-plan-limits.js +438 -438
  20. package/src/lib/ark-coding-plan-limits.js +537 -537
  21. package/src/lib/async-queue-reader.js +138 -138
  22. package/src/lib/atomic-json.js +27 -27
  23. package/src/lib/bearer-token.js +11 -11
  24. package/src/lib/categorizer-utils.js +232 -232
  25. package/src/lib/claude-categorizer.js +1343 -1343
  26. package/src/lib/claude-config.js +279 -279
  27. package/src/lib/claude-user-identity.js +56 -56
  28. package/src/lib/cli-ui.js +179 -179
  29. package/src/lib/cloud-account.js +541 -541
  30. package/src/lib/cloud-device-token.js +141 -141
  31. package/src/lib/cloud-sync-prefs.js +14 -14
  32. package/src/lib/cloud-usage-reset.js +115 -115
  33. package/src/lib/codex-config.js +595 -595
  34. package/src/lib/codex-context-breakdown.js +806 -806
  35. package/src/lib/codex-model-attribution.js +128 -128
  36. package/src/lib/codex-rollout-parser.js +1471 -1471
  37. package/src/lib/codex-service-tier.js +49 -49
  38. package/src/lib/codex-token-refresh.js +140 -140
  39. package/src/lib/codex-token-usage.js +195 -195
  40. package/src/lib/codex-usage-record.js +195 -195
  41. package/src/lib/collection-pause.js +77 -0
  42. package/src/lib/command-runner.js +313 -313
  43. package/src/lib/commandcode-limits.js +317 -317
  44. package/src/lib/context-health.js +124 -124
  45. package/src/lib/cursor-config.js +605 -605
  46. package/src/lib/cursor-store.js +1918 -1918
  47. package/src/lib/debug-flags.js +7 -7
  48. package/src/lib/devin-limits.js +249 -249
  49. package/src/lib/devin-usage.js +212 -212
  50. package/src/lib/diagnostics.js +383 -383
  51. package/src/lib/doctor.js +385 -385
  52. package/src/lib/dumate.js +95 -95
  53. package/src/lib/fs.js +455 -455
  54. package/src/lib/function-url.js +14 -14
  55. package/src/lib/gemini-config.js +291 -291
  56. package/src/lib/git-outcomes.js +243 -243
  57. package/src/lib/grok-context-breakdown.js +890 -890
  58. package/src/lib/grok-hook.js +360 -360
  59. package/src/lib/grok-limits.js +865 -865
  60. package/src/lib/grok-usage.js +98 -98
  61. package/src/lib/heatmap-compact.js +114 -114
  62. package/src/lib/ingest-sanitize.js +41 -41
  63. package/src/lib/init-flow.js +42 -42
  64. package/src/lib/install-resolver.js +170 -170
  65. package/src/lib/jsonl-lines.js +134 -134
  66. package/src/lib/kimi-model-repair.js +173 -173
  67. package/src/lib/kimi-profile.js +61 -61
  68. package/src/lib/kimi-session.js +216 -216
  69. package/src/lib/local-api.js +3588 -3588
  70. package/src/lib/machine-id.js +238 -238
  71. package/src/lib/multi-install-parser.js +113 -113
  72. package/src/lib/notify-command.js +38 -38
  73. package/src/lib/omp-hook.js +589 -589
  74. package/src/lib/openclaw-cli.js +104 -104
  75. package/src/lib/openclaw-hook.js +375 -375
  76. package/src/lib/openclaw-session-plugin.js +560 -560
  77. package/src/lib/opencode-config.js +121 -121
  78. package/src/lib/opencode-go-limits.js +807 -807
  79. package/src/lib/outcomes-engine.js +253 -253
  80. package/src/lib/passive-mode.js +219 -219
  81. package/src/lib/pet-packages.js +722 -722
  82. package/src/lib/pricing/curated-overrides.json +822 -822
  83. package/src/lib/pricing/index.js +379 -379
  84. package/src/lib/pricing/litellm-fetcher.js +172 -172
  85. package/src/lib/pricing/matcher.js +456 -456
  86. package/src/lib/pricing/seed-snapshot.json +1 -1
  87. package/src/lib/progress.js +76 -76
  88. package/src/lib/project-usage-purge.js +117 -117
  89. package/src/lib/prompt.js +24 -24
  90. package/src/lib/provider-status.js +104 -104
  91. package/src/lib/proxy-env.js +489 -489
  92. package/src/lib/proxy-settings.js +163 -163
  93. package/src/lib/qoder-cn-cli-limits.js +119 -119
  94. package/src/lib/qoder-limits.js +880 -880
  95. package/src/lib/quiet-warnings.js +26 -26
  96. package/src/lib/rollout.js +26005 -25966
  97. package/src/lib/runtime-config.js +9 -4
  98. package/src/lib/scan-roots.js +277 -277
  99. package/src/lib/scheduled-task.js +145 -0
  100. package/src/lib/sentry.js +231 -231
  101. package/src/lib/session-analytics.js +2972 -2972
  102. package/src/lib/session-performance.js +237 -237
  103. package/src/lib/session-upload.js +379 -379
  104. package/src/lib/skill-usage.js +267 -267
  105. package/src/lib/skills-manager.js +1591 -1591
  106. package/src/lib/source-metadata.js +48 -48
  107. package/src/lib/sqlite-reader.js +215 -215
  108. package/src/lib/star-cta.js +73 -73
  109. package/src/lib/subscription-manager.js +293 -293
  110. package/src/lib/subscriptions.js +508 -508
  111. package/src/lib/sync-report.js +138 -0
  112. package/src/lib/telemetry.js +193 -193
  113. package/src/lib/tracker-paths.js +16 -16
  114. package/src/lib/trae-cn-config.js +548 -548
  115. package/src/lib/trae-db.js +127 -127
  116. package/src/lib/trae-snapshot.js +230 -230
  117. package/src/lib/trae-sqlite.js +143 -143
  118. package/src/lib/trae-usage.js +121 -121
  119. package/src/lib/upload-queue.js +134 -134
  120. package/src/lib/upload-throttle.js +171 -171
  121. package/src/lib/usage-limits.js +4552 -4552
  122. package/src/lib/wrapped-aggregator.js +236 -236
  123. package/src/lib/wsl-probe.js +281 -281
  124. package/src/lib/zcode-limits.js +1172 -1172
  125. package/src/lib/zcode-reset-credits.js +66 -66
  126. package/test/audit-fixes.test.js +200 -0
  127. package/test/cli-smoke.test.js +53 -53
  128. package/test/collection-controls.test.js +181 -0
  129. package/test/ingest-sanitize.test.js +162 -162
  130. package/test/quiet-warnings.test.js +53 -53
  131. package/test/session-upload.test.js +427 -427
@@ -1,560 +1,560 @@
1
- const os = require("node:os");
2
- const path = require("node:path");
3
- const fs = require("node:fs/promises");
4
- const fssync = require("node:fs");
5
- const { runOpenclawCli } = require("./openclaw-cli");
6
-
7
- const OPENCLAW_SESSION_PLUGIN_ID = "openclaw-session-sync";
8
- const OPENCLAW_SESSION_PLUGIN_DIRNAME = "openclaw-plugin";
9
-
10
- function resolveOpenclawSessionPluginPaths({
11
- home = os.homedir(),
12
- trackerDir,
13
- env = process.env,
14
- } = {}) {
15
- if (!trackerDir) throw new Error("trackerDir is required");
16
-
17
- const openclawConfigPath =
18
- normalizeString(env.OPENCLAW_CONFIG_PATH) || path.join(home, ".openclaw", "openclaw.json");
19
-
20
- const openclawHome =
21
- normalizeString(env.TOKENUSAGE_OPENCLAW_HOME) ||
22
- normalizeString(env.OPENCLAW_STATE_DIR) ||
23
- path.join(home, ".openclaw");
24
-
25
- const pluginDir = path.join(trackerDir, OPENCLAW_SESSION_PLUGIN_DIRNAME);
26
- const pluginEntryDir = path.join(pluginDir, OPENCLAW_SESSION_PLUGIN_ID);
27
-
28
- return {
29
- pluginId: OPENCLAW_SESSION_PLUGIN_ID,
30
- pluginDir,
31
- pluginEntryDir,
32
- openclawConfigPath,
33
- openclawHome,
34
- };
35
- }
36
-
37
- async function installOpenclawSessionPlugin({
38
- home = os.homedir(),
39
- trackerDir,
40
- packageName = "tokenusage-cli",
41
- env = process.env,
42
- } = {}) {
43
- const paths = resolveOpenclawSessionPluginPaths({ home, trackerDir, env });
44
-
45
- await ensureOpenclawSessionPluginFiles({
46
- pluginDir: paths.pluginDir,
47
- trackerDir,
48
- packageName,
49
- openclawHome: paths.openclawHome,
50
- });
51
-
52
- const installResult = runOpenclawCli(["plugins", "install", "--link", paths.pluginEntryDir], env);
53
- if (installResult.skippedReason) {
54
- return { configured: false, ...paths, ...installResult };
55
- }
56
-
57
- const enableResult = runOpenclawCli(["plugins", "enable", paths.pluginId], env);
58
- if (enableResult.skippedReason) {
59
- return {
60
- configured: false,
61
- ...paths,
62
- skippedReason: enableResult.skippedReason,
63
- error: enableResult.error,
64
- stdout: `${installResult.stdout || ""}\n${enableResult.stdout || ""}`.trim(),
65
- stderr: `${installResult.stderr || ""}\n${enableResult.stderr || ""}`.trim(),
66
- code: enableResult.code,
67
- };
68
- }
69
-
70
- const policyResult = await ensureOpenclawSessionPluginPolicy(paths);
71
- const state = await probeOpenclawSessionPluginState({ home, trackerDir, env });
72
- return {
73
- configured: state.configured,
74
- changed:
75
- /Linked plugin path:/i.test(installResult.stdout || "") ||
76
- /Enabled plugin/i.test(enableResult.stdout || "") ||
77
- /already enabled/i.test(enableResult.stdout || "") ||
78
- policyResult.changed,
79
- ...paths,
80
- stdout: `${installResult.stdout || ""}\n${enableResult.stdout || ""}`.trim(),
81
- stderr: `${installResult.stderr || ""}\n${enableResult.stderr || ""}`.trim(),
82
- code: enableResult.code,
83
- };
84
- }
85
-
86
- async function ensureOpenclawSessionPluginFiles({
87
- pluginDir,
88
- trackerDir,
89
- packageName = "tokenusage-cli",
90
- openclawHome,
91
- } = {}) {
92
- if (!pluginDir || !trackerDir) throw new Error("pluginDir and trackerDir are required");
93
-
94
- const pluginEntryDir = path.join(pluginDir, OPENCLAW_SESSION_PLUGIN_ID);
95
- await fs.mkdir(pluginEntryDir, { recursive: true });
96
-
97
- const packageJsonPath = path.join(pluginEntryDir, "package.json");
98
- const pluginMetaPath = path.join(pluginEntryDir, "openclaw.plugin.json");
99
- const indexPath = path.join(pluginEntryDir, "index.js");
100
-
101
- await fs.writeFile(packageJsonPath, buildSessionPluginPackageJson(), "utf8");
102
- await fs.writeFile(pluginMetaPath, buildSessionPluginMeta(), "utf8");
103
- await fs.writeFile(
104
- indexPath,
105
- buildSessionPluginIndex({
106
- trackerDir,
107
- packageName,
108
- openclawHome: openclawHome || path.join(os.homedir(), ".openclaw"),
109
- }),
110
- "utf8",
111
- );
112
- }
113
-
114
- async function probeOpenclawSessionPluginState({
115
- home = os.homedir(),
116
- trackerDir,
117
- env = process.env,
118
- } = {}) {
119
- const paths = resolveOpenclawSessionPluginPaths({ home, trackerDir, env });
120
- const { openclawConfigPath, pluginEntryDir, pluginId } = paths;
121
-
122
- const pluginFilesReady =
123
- fssync.existsSync(path.join(pluginEntryDir, "package.json")) &&
124
- fssync.existsSync(path.join(pluginEntryDir, "index.js"));
125
-
126
- let cfg = null;
127
- try {
128
- const raw = await fs.readFile(openclawConfigPath, "utf8");
129
- cfg = JSON.parse(raw);
130
- } catch (err) {
131
- if (err?.code === "ENOENT" || err?.code === "ENOTDIR") {
132
- return {
133
- configured: false,
134
- enabled: false,
135
- linked: false,
136
- installed: false,
137
- pluginFilesReady,
138
- skippedReason: "openclaw-config-missing",
139
- ...paths,
140
- };
141
- }
142
- return {
143
- configured: false,
144
- enabled: false,
145
- linked: false,
146
- installed: false,
147
- pluginFilesReady,
148
- skippedReason: "openclaw-config-unreadable",
149
- error: err?.message || String(err),
150
- ...paths,
151
- };
152
- }
153
-
154
- const pluginEntry = cfg?.plugins?.entries?.[pluginId];
155
- const enabled = pluginEntry ? pluginEntry.enabled !== false : false;
156
- const conversationAccess = pluginEntry?.hooks?.allowConversationAccess === true;
157
-
158
- const loadPaths = Array.isArray(cfg?.plugins?.load?.paths) ? cfg.plugins.load.paths : [];
159
- const normalizedPluginEntryDir = path.resolve(pluginEntryDir);
160
- const linked = loadPaths.some(
161
- (entry) => path.resolve(String(entry || "")) === normalizedPluginEntryDir,
162
- );
163
-
164
- const installs =
165
- cfg?.plugins?.installs && typeof cfg.plugins.installs === "object" ? cfg.plugins.installs : {};
166
- const installEntry = installs[pluginId];
167
- const installed = Boolean(installEntry);
168
-
169
- return {
170
- configured: enabled && linked && pluginFilesReady && conversationAccess,
171
- enabled,
172
- linked,
173
- installed,
174
- pluginFilesReady,
175
- conversationAccess,
176
- ...paths,
177
- };
178
- }
179
-
180
- async function ensureOpenclawSessionPluginPolicy({ openclawConfigPath, pluginId } = {}) {
181
- if (!openclawConfigPath || !pluginId) {
182
- throw new Error("openclawConfigPath and pluginId are required");
183
- }
184
-
185
- let cfg = JSON.parse(await fs.readFile(openclawConfigPath, "utf8"));
186
- if (!cfg || typeof cfg !== "object" || Array.isArray(cfg)) {
187
- cfg = {};
188
- }
189
- if (!cfg.plugins || typeof cfg.plugins !== "object" || Array.isArray(cfg.plugins)) {
190
- cfg.plugins = {};
191
- }
192
- if (
193
- !cfg.plugins.entries ||
194
- typeof cfg.plugins.entries !== "object" ||
195
- Array.isArray(cfg.plugins.entries)
196
- ) {
197
- cfg.plugins.entries = {};
198
- }
199
-
200
- const existingEntry = cfg.plugins.entries[pluginId];
201
- const entry =
202
- existingEntry && typeof existingEntry === "object" && !Array.isArray(existingEntry)
203
- ? existingEntry
204
- : {};
205
- cfg.plugins.entries[pluginId] = entry;
206
-
207
- let changed = existingEntry !== entry;
208
- if (entry.enabled === false) {
209
- entry.enabled = true;
210
- changed = true;
211
- }
212
- if (!entry.hooks || typeof entry.hooks !== "object" || Array.isArray(entry.hooks)) {
213
- entry.hooks = {};
214
- changed = true;
215
- }
216
-
217
- if (entry.hooks.allowConversationAccess === true) {
218
- if (!changed) return { changed: false };
219
- } else {
220
- entry.hooks.allowConversationAccess = true;
221
- changed = true;
222
- }
223
-
224
- await fs.writeFile(openclawConfigPath, `${JSON.stringify(cfg, null, 2)}\n`, "utf8");
225
- return { changed: true };
226
- }
227
-
228
- async function removeOpenclawSessionPluginConfig({
229
- home = os.homedir(),
230
- trackerDir,
231
- env = process.env,
232
- } = {}) {
233
- const paths = resolveOpenclawSessionPluginPaths({ home, trackerDir, env });
234
- const { openclawConfigPath, pluginEntryDir, pluginId } = paths;
235
-
236
- let cfg;
237
- try {
238
- cfg = JSON.parse(await fs.readFile(openclawConfigPath, "utf8"));
239
- } catch (err) {
240
- if (err?.code === "ENOENT" || err?.code === "ENOTDIR") {
241
- return { removed: false, skippedReason: "openclaw-config-missing", ...paths };
242
- }
243
- return {
244
- removed: false,
245
- skippedReason: "openclaw-config-unreadable",
246
- error: err?.message || String(err),
247
- ...paths,
248
- };
249
- }
250
-
251
- let changed = false;
252
- const plugins = cfg?.plugins;
253
-
254
- if (plugins?.entries && Object.prototype.hasOwnProperty.call(plugins.entries, pluginId)) {
255
- delete plugins.entries[pluginId];
256
- changed = true;
257
- if (Object.keys(plugins.entries).length === 0) delete plugins.entries;
258
- }
259
-
260
- if (plugins?.load && Array.isArray(plugins.load.paths)) {
261
- const target = path.resolve(pluginEntryDir);
262
- const after = plugins.load.paths.filter(
263
- (entry) => path.resolve(String(entry || "")) !== target,
264
- );
265
- if (after.length !== plugins.load.paths.length) {
266
- plugins.load.paths = after;
267
- changed = true;
268
- if (after.length === 0) delete plugins.load.paths;
269
- if (Object.keys(plugins.load).length === 0) delete plugins.load;
270
- }
271
- }
272
-
273
- if (plugins?.installs && typeof plugins.installs === "object") {
274
- const installs = plugins.installs;
275
- if (Object.prototype.hasOwnProperty.call(installs, pluginId)) {
276
- delete installs[pluginId];
277
- changed = true;
278
- }
279
-
280
- const target = path.resolve(pluginEntryDir);
281
- for (const [id, entry] of Object.entries(installs)) {
282
- const sourcePath = normalizeString(entry?.sourcePath);
283
- const installPath = normalizeString(entry?.installPath);
284
- if (
285
- (sourcePath && path.resolve(sourcePath) === target) ||
286
- (installPath && path.resolve(installPath) === target)
287
- ) {
288
- delete installs[id];
289
- changed = true;
290
- }
291
- }
292
-
293
- if (Object.keys(installs).length === 0) delete plugins.installs;
294
- }
295
-
296
- if (plugins && Object.keys(plugins).length === 0) {
297
- delete cfg.plugins;
298
- changed = true;
299
- }
300
-
301
- if (changed) {
302
- await fs.writeFile(openclawConfigPath, `${JSON.stringify(cfg, null, 2)}\n`, "utf8");
303
- }
304
-
305
- const hadFiles = await fs
306
- .stat(pluginEntryDir)
307
- .then((st) => st.isDirectory())
308
- .catch(() => false);
309
- await fs.rm(pluginEntryDir, { recursive: true, force: true }).catch(() => {});
310
-
311
- return { removed: changed || hadFiles, ...paths };
312
- }
313
-
314
- function buildSessionPluginPackageJson() {
315
- return `${JSON.stringify(
316
- {
317
- name: "@tokenusage/openclaw-session-sync",
318
- version: "0.0.0",
319
- private: true,
320
- type: "module",
321
- openclaw: {
322
- extensions: ["./index.js"],
323
- },
324
- },
325
- null,
326
- 2,
327
- )}\n`;
328
- }
329
-
330
- function buildSessionPluginMeta() {
331
- return `${JSON.stringify(
332
- {
333
- id: OPENCLAW_SESSION_PLUGIN_ID,
334
- name: "Token Usage OpenClaw Session Sync",
335
- description: "Trigger tokenusage sync on OpenClaw agent/session lifecycle events.",
336
- configSchema: {
337
- type: "object",
338
- additionalProperties: false,
339
- properties: {},
340
- },
341
- },
342
- null,
343
- 2,
344
- )}\n`;
345
- }
346
-
347
- function buildSessionPluginIndex({ trackerDir, packageName = "tokenusage-cli", openclawHome }) {
348
- const trackerBinPath = path.join(trackerDir, "app", "bin", "tracker.js");
349
- const fallbackPkg = packageName || "tokenusage-cli";
350
- const safeOpenclawHome = openclawHome || path.join(os.homedir(), ".openclaw");
351
-
352
- return (
353
- `import fs from 'node:fs';\n` +
354
- `import path from 'node:path';\n` +
355
- `import cp from 'node:child_process';\n` +
356
- `\n` +
357
- `const trackerDir = ${JSON.stringify(trackerDir)};\n` +
358
- `const trackerBinPath = ${JSON.stringify(trackerBinPath)};\n` +
359
- `const fallbackPkg = ${JSON.stringify(fallbackPkg)};\n` +
360
- `const openclawHome = ${JSON.stringify(safeOpenclawHome)};\n` +
361
- `const depsMarkerPath = path.join(trackerDir, 'app', 'bin', 'tracker.js');\n` +
362
- `const triggerStatePath = path.join(trackerDir, 'openclaw.session-sync.trigger-state.json');\n` +
363
- `const SESSION_TRIGGER_THROTTLE_MS = 15_000;\n` +
364
- `\n` +
365
- `export default function register(api) {\n` +
366
- ` api.on('agent_end', async (_event, ctx) => {\n` +
367
- ` try {\n` +
368
- ` const sessionKey = normalize(ctx && ctx.sessionKey);\n` +
369
- ` if (!sessionKey) return;\n` +
370
- `\n` +
371
- ` const agentId = normalize(ctx && ctx.agentId) || parseAgentId(sessionKey);\n` +
372
- ` if (!agentId) return;\n` +
373
- `\n` +
374
- ` const sessionInfo = await resolveSessionInfo(agentId, sessionKey);\n` +
375
- ` const sessionId = normalize(sessionInfo && sessionInfo.sessionId);\n` +
376
- ` if (!sessionId) return;\n` +
377
- `\n` +
378
- ` if (!allowTrigger('agent_end', agentId, sessionId)) return;\n` +
379
- `\n` +
380
- ` spawnSync({\n` +
381
- ` args: ['sync', '--auto', '--from-openclaw'],\n` +
382
- ` env: buildSessionEnv({\n` +
383
- ` agentId,\n` +
384
- ` sessionId,\n` +
385
- ` sessionKey,\n` +
386
- ` sessionEntry: sessionInfo && sessionInfo.entry\n` +
387
- ` })\n` +
388
- ` });\n` +
389
- ` } catch (_) {}\n` +
390
- ` });\n` +
391
- `\n` +
392
- ` api.on('gateway_start', async () => {\n` +
393
- ` try {\n` +
394
- ` if (!allowTrigger('gateway_start', 'gateway', 'startup')) return;\n` +
395
- ` spawnSync({ args: ['sync', '--auto', '--from-openclaw'] });\n` +
396
- ` } catch (_) {}\n` +
397
- ` });\n` +
398
- `\n` +
399
- ` api.on('gateway_stop', async () => {\n` +
400
- ` try {\n` +
401
- ` if (!allowTrigger('gateway_stop', 'gateway', 'stop')) return;\n` +
402
- ` spawnSync({ args: ['sync', '--auto', '--from-openclaw'] });\n` +
403
- ` } catch (_) {}\n` +
404
- ` });\n` +
405
- `}\n` +
406
- `\n` +
407
- `function spawnSync({ args, env = {} }) {\n` +
408
- ` const hasLocalRuntime = fs.existsSync(trackerBinPath);\n` +
409
- ` const hasLocalDeps = fs.existsSync(depsMarkerPath);\n` +
410
- ` const argv = Array.isArray(args) && args.length > 0 ? args : ['sync', '--auto'];\n` +
411
- ` const cmd = hasLocalRuntime && hasLocalDeps\n` +
412
- ` ? [process.execPath, trackerBinPath, ...argv]\n` +
413
- ` : ['npx', '--yes', fallbackPkg, ...argv];\n` +
414
- ` const child = cp.spawn(cmd[0], cmd.slice(1), {\n` +
415
- ` detached: true,\n` +
416
- ` stdio: 'ignore',\n` +
417
- ` env: { ...process.env, ...env }\n` +
418
- ` });\n` +
419
- ` child.unref();\n` +
420
- `}\n` +
421
- `\n` +
422
- `function buildSessionEnv({ agentId, sessionId, sessionKey, sessionEntry }) {\n` +
423
- ` const out = {\n` +
424
- ` TOKENUSAGE_OPENCLAW_AGENT_ID: agentId,\n` +
425
- ` TOKENUSAGE_OPENCLAW_PREV_SESSION_ID: sessionId,\n` +
426
- ` TOKENUSAGE_OPENCLAW_HOME: openclawHome\n` +
427
- ` };\n` +
428
- ` const key = normalize(sessionKey);\n` +
429
- ` if (key) out.TOKENUSAGE_OPENCLAW_SESSION_KEY = key;\n` +
430
- ` const prevTotalTokens = toNonNegativeInt(sessionEntry && sessionEntry.totalTokens);\n` +
431
- ` const prevInputTokens = toNonNegativeInt(sessionEntry && sessionEntry.inputTokens);\n` +
432
- ` const prevOutputTokens = toNonNegativeInt(sessionEntry && sessionEntry.outputTokens);\n` +
433
- ` const prevModel = normalize(sessionEntry && sessionEntry.model);\n` +
434
- ` const prevUpdatedAt = toIso(sessionEntry && sessionEntry.updatedAt);\n` +
435
- ` if (prevTotalTokens != null) out.TOKENUSAGE_OPENCLAW_PREV_TOTAL_TOKENS = String(prevTotalTokens);\n` +
436
- ` if (prevInputTokens != null) out.TOKENUSAGE_OPENCLAW_PREV_INPUT_TOKENS = String(prevInputTokens);\n` +
437
- ` if (prevOutputTokens != null) out.TOKENUSAGE_OPENCLAW_PREV_OUTPUT_TOKENS = String(prevOutputTokens);\n` +
438
- ` if (prevModel) out.TOKENUSAGE_OPENCLAW_PREV_MODEL = prevModel;\n` +
439
- ` if (prevUpdatedAt) out.TOKENUSAGE_OPENCLAW_PREV_UPDATED_AT = prevUpdatedAt;\n` +
440
- ` return out;\n` +
441
- `}\n` +
442
- `\n` +
443
- `async function resolveSessionInfo(agentId, sessionKey) {\n` +
444
- ` const key = normalize(sessionKey);\n` +
445
- ` if (!key) return null;\n` +
446
- ` const sessionsPath = path.join(openclawHome, 'agents', agentId, 'sessions', 'sessions.json');\n` +
447
- ` if (fs.existsSync(sessionsPath)) {\n` +
448
- ` try {\n` +
449
- ` const raw = fs.readFileSync(sessionsPath, 'utf8');\n` +
450
- ` const parsed = JSON.parse(raw);\n` +
451
- ` if (parsed && typeof parsed === 'object') {\n` +
452
- ` const entry = parsed[key];\n` +
453
- ` if (entry && typeof entry === 'object' && normalize(entry.sessionId)) {\n` +
454
- ` return { sessionKey: key, sessionId: normalize(entry.sessionId), entry };\n` +
455
- ` }\n` +
456
- ` }\n` +
457
- ` } catch (_) {}\n` +
458
- ` }\n` +
459
- ` // OpenClaw >= 2026.9.9 keeps session state in a per-agent SQLite\n` +
460
- ` // database (~/.openclaw/agents/<id>/agent/openclaw-agent.sqlite);\n` +
461
- ` // sessions.json is no longer written. Without this fallback the\n` +
462
- ` // plugin would silently no-op on every agent_end for anyone on a\n` +
463
- ` // current OpenClaw install (issue: openclaw migration to sqlite).\n` +
464
- ` return resolveSessionInfoFromSqlite(agentId, key);\n` +
465
- `}\n` +
466
- `\n` +
467
- `async function resolveSessionInfoFromSqlite(agentId, sessionKey) {\n` +
468
- ` const sqliteModule = await importSqliteSync();\n` +
469
- ` if (!sqliteModule) return null;\n` +
470
- ` const { DatabaseSync } = sqliteModule;\n` +
471
- ` const currentSessionQuery = "SELECT w.session_id FROM session_nodes n JOIN session_windows w ON w.session_id = n.current_session_id WHERE n.session_key = ? AND COALESCE(w.reason, '') != 'compaction'";\n` +
472
- ` const sessionQuery = "SELECT session_id FROM session_windows WHERE session_key = ? AND COALESCE(reason, '') != 'compaction' ORDER BY updated_at DESC LIMIT 1";\n` +
473
- ` const dbCandidates = [path.join(openclawHome, 'agents', agentId, 'agent', 'openclaw-agent.sqlite'), path.join(openclawHome, 'agents', agentId, 'openclaw-agent.sqlite')];\n` +
474
- ` for (const dbPath of dbCandidates) {\n` +
475
- ` if (!fs.existsSync(dbPath)) continue;\n` +
476
- ` let db;\n` +
477
- ` try { db = new DatabaseSync(dbPath, { readOnly: true }); } catch (_) { continue; }\n` +
478
- ` try {\n` +
479
- ` let row;\n` +
480
- ` try { row = db.prepare(currentSessionQuery).get(sessionKey); } catch (_) {}\n` +
481
- ` if (!row || !row.session_id) row = db.prepare(sessionQuery).get(sessionKey);\n` +
482
- ` if (!row || !row.session_id) continue;\n` +
483
- ` // The passive SQLite reader owns per-event accounting; never synthesize lifetime sums.\n` +
484
- ` return { sessionKey, sessionId: row.session_id, entry: {} };\n` +
485
- ` } catch (_) {}\n` +
486
- ` finally { try { db.close(); } catch (_) {} }\n` +
487
- ` }\n` +
488
- ` return null;\n` +
489
- `}\n` +
490
- `\n` +
491
- `async function importSqliteSync() {\n` +
492
- ` try { return await import('node:sqlite'); } catch (_) { return null; }\n` +
493
- `}\n` +
494
- `\n` +
495
- `function parseAgentId(sessionKey) {\n` +
496
- ` const s = normalize(sessionKey);\n` +
497
- ` if (!s || !s.startsWith('agent:')) return null;\n` +
498
- ` const parts = s.split(':');\n` +
499
- ` return parts.length >= 2 ? normalize(parts[1]) : null;\n` +
500
- `}\n` +
501
- `\n` +
502
- `function allowTrigger(kind, scope, target) {\n` +
503
- ` const key = [kind, scope || 'na', target || 'na'].join(':');\n` +
504
- ` const now = Date.now();\n` +
505
- ` let state = {};\n` +
506
- ` try {\n` +
507
- ` state = JSON.parse(fs.readFileSync(triggerStatePath, 'utf8'));\n` +
508
- ` if (!state || typeof state !== 'object') state = {};\n` +
509
- ` } catch (_) {}\n` +
510
- ` const last = Number(state[key] || 0);\n` +
511
- ` if (Number.isFinite(last) && now - last < SESSION_TRIGGER_THROTTLE_MS) return false;\n` +
512
- ` state[key] = now;\n` +
513
- ` try {\n` +
514
- ` fs.mkdirSync(path.dirname(triggerStatePath), { recursive: true });\n` +
515
- ` fs.writeFileSync(triggerStatePath, JSON.stringify(state), 'utf8');\n` +
516
- ` } catch (_) {}\n` +
517
- ` return true;\n` +
518
- `}\n` +
519
- `\n` +
520
- `function normalize(v) {\n` +
521
- ` if (typeof v !== 'string') return null;\n` +
522
- ` const s = v.trim();\n` +
523
- ` return s.length > 0 ? s : null;\n` +
524
- `}\n` +
525
- `\n` +
526
- `function toNonNegativeInt(v) {\n` +
527
- ` const n = Number(v);\n` +
528
- ` if (!Number.isFinite(n) || n < 0) return null;\n` +
529
- ` return Math.floor(n);\n` +
530
- `}\n` +
531
- `\n` +
532
- `function toIso(v) {\n` +
533
- ` if (typeof v === 'string') {\n` +
534
- ` const s = normalize(v);\n` +
535
- ` if (s && !Number.isNaN(Date.parse(s))) return s;\n` +
536
- ` }\n` +
537
- ` const n = Number(v);\n` +
538
- ` if (!Number.isFinite(n) || n <= 0) return null;\n` +
539
- ` const ms = n < 1e12 ? Math.floor(n * 1000) : Math.floor(n);\n` +
540
- ` const d = new Date(ms);\n` +
541
- ` return Number.isNaN(d.getTime()) ? null : d.toISOString();\n` +
542
- `}\n`
543
- );
544
- }
545
-
546
- function normalizeString(value) {
547
- if (typeof value !== "string") return null;
548
- const trimmed = value.trim();
549
- return trimmed.length > 0 ? trimmed : null;
550
- }
551
-
552
- module.exports = {
553
- OPENCLAW_SESSION_PLUGIN_ID,
554
- OPENCLAW_SESSION_PLUGIN_DIRNAME,
555
- resolveOpenclawSessionPluginPaths,
556
- ensureOpenclawSessionPluginFiles,
557
- installOpenclawSessionPlugin,
558
- probeOpenclawSessionPluginState,
559
- removeOpenclawSessionPluginConfig,
560
- };
1
+ const os = require("node:os");
2
+ const path = require("node:path");
3
+ const fs = require("node:fs/promises");
4
+ const fssync = require("node:fs");
5
+ const { runOpenclawCli } = require("./openclaw-cli");
6
+
7
+ const OPENCLAW_SESSION_PLUGIN_ID = "openclaw-session-sync";
8
+ const OPENCLAW_SESSION_PLUGIN_DIRNAME = "openclaw-plugin";
9
+
10
+ function resolveOpenclawSessionPluginPaths({
11
+ home = os.homedir(),
12
+ trackerDir,
13
+ env = process.env,
14
+ } = {}) {
15
+ if (!trackerDir) throw new Error("trackerDir is required");
16
+
17
+ const openclawConfigPath =
18
+ normalizeString(env.OPENCLAW_CONFIG_PATH) || path.join(home, ".openclaw", "openclaw.json");
19
+
20
+ const openclawHome =
21
+ normalizeString(env.TOKENUSAGE_OPENCLAW_HOME) ||
22
+ normalizeString(env.OPENCLAW_STATE_DIR) ||
23
+ path.join(home, ".openclaw");
24
+
25
+ const pluginDir = path.join(trackerDir, OPENCLAW_SESSION_PLUGIN_DIRNAME);
26
+ const pluginEntryDir = path.join(pluginDir, OPENCLAW_SESSION_PLUGIN_ID);
27
+
28
+ return {
29
+ pluginId: OPENCLAW_SESSION_PLUGIN_ID,
30
+ pluginDir,
31
+ pluginEntryDir,
32
+ openclawConfigPath,
33
+ openclawHome,
34
+ };
35
+ }
36
+
37
+ async function installOpenclawSessionPlugin({
38
+ home = os.homedir(),
39
+ trackerDir,
40
+ packageName = "tokenusage-cli",
41
+ env = process.env,
42
+ } = {}) {
43
+ const paths = resolveOpenclawSessionPluginPaths({ home, trackerDir, env });
44
+
45
+ await ensureOpenclawSessionPluginFiles({
46
+ pluginDir: paths.pluginDir,
47
+ trackerDir,
48
+ packageName,
49
+ openclawHome: paths.openclawHome,
50
+ });
51
+
52
+ const installResult = runOpenclawCli(["plugins", "install", "--link", paths.pluginEntryDir], env);
53
+ if (installResult.skippedReason) {
54
+ return { configured: false, ...paths, ...installResult };
55
+ }
56
+
57
+ const enableResult = runOpenclawCli(["plugins", "enable", paths.pluginId], env);
58
+ if (enableResult.skippedReason) {
59
+ return {
60
+ configured: false,
61
+ ...paths,
62
+ skippedReason: enableResult.skippedReason,
63
+ error: enableResult.error,
64
+ stdout: `${installResult.stdout || ""}\n${enableResult.stdout || ""}`.trim(),
65
+ stderr: `${installResult.stderr || ""}\n${enableResult.stderr || ""}`.trim(),
66
+ code: enableResult.code,
67
+ };
68
+ }
69
+
70
+ const policyResult = await ensureOpenclawSessionPluginPolicy(paths);
71
+ const state = await probeOpenclawSessionPluginState({ home, trackerDir, env });
72
+ return {
73
+ configured: state.configured,
74
+ changed:
75
+ /Linked plugin path:/i.test(installResult.stdout || "") ||
76
+ /Enabled plugin/i.test(enableResult.stdout || "") ||
77
+ /already enabled/i.test(enableResult.stdout || "") ||
78
+ policyResult.changed,
79
+ ...paths,
80
+ stdout: `${installResult.stdout || ""}\n${enableResult.stdout || ""}`.trim(),
81
+ stderr: `${installResult.stderr || ""}\n${enableResult.stderr || ""}`.trim(),
82
+ code: enableResult.code,
83
+ };
84
+ }
85
+
86
+ async function ensureOpenclawSessionPluginFiles({
87
+ pluginDir,
88
+ trackerDir,
89
+ packageName = "tokenusage-cli",
90
+ openclawHome,
91
+ } = {}) {
92
+ if (!pluginDir || !trackerDir) throw new Error("pluginDir and trackerDir are required");
93
+
94
+ const pluginEntryDir = path.join(pluginDir, OPENCLAW_SESSION_PLUGIN_ID);
95
+ await fs.mkdir(pluginEntryDir, { recursive: true });
96
+
97
+ const packageJsonPath = path.join(pluginEntryDir, "package.json");
98
+ const pluginMetaPath = path.join(pluginEntryDir, "openclaw.plugin.json");
99
+ const indexPath = path.join(pluginEntryDir, "index.js");
100
+
101
+ await fs.writeFile(packageJsonPath, buildSessionPluginPackageJson(), "utf8");
102
+ await fs.writeFile(pluginMetaPath, buildSessionPluginMeta(), "utf8");
103
+ await fs.writeFile(
104
+ indexPath,
105
+ buildSessionPluginIndex({
106
+ trackerDir,
107
+ packageName,
108
+ openclawHome: openclawHome || path.join(os.homedir(), ".openclaw"),
109
+ }),
110
+ "utf8",
111
+ );
112
+ }
113
+
114
+ async function probeOpenclawSessionPluginState({
115
+ home = os.homedir(),
116
+ trackerDir,
117
+ env = process.env,
118
+ } = {}) {
119
+ const paths = resolveOpenclawSessionPluginPaths({ home, trackerDir, env });
120
+ const { openclawConfigPath, pluginEntryDir, pluginId } = paths;
121
+
122
+ const pluginFilesReady =
123
+ fssync.existsSync(path.join(pluginEntryDir, "package.json")) &&
124
+ fssync.existsSync(path.join(pluginEntryDir, "index.js"));
125
+
126
+ let cfg = null;
127
+ try {
128
+ const raw = await fs.readFile(openclawConfigPath, "utf8");
129
+ cfg = JSON.parse(raw);
130
+ } catch (err) {
131
+ if (err?.code === "ENOENT" || err?.code === "ENOTDIR") {
132
+ return {
133
+ configured: false,
134
+ enabled: false,
135
+ linked: false,
136
+ installed: false,
137
+ pluginFilesReady,
138
+ skippedReason: "openclaw-config-missing",
139
+ ...paths,
140
+ };
141
+ }
142
+ return {
143
+ configured: false,
144
+ enabled: false,
145
+ linked: false,
146
+ installed: false,
147
+ pluginFilesReady,
148
+ skippedReason: "openclaw-config-unreadable",
149
+ error: err?.message || String(err),
150
+ ...paths,
151
+ };
152
+ }
153
+
154
+ const pluginEntry = cfg?.plugins?.entries?.[pluginId];
155
+ const enabled = pluginEntry ? pluginEntry.enabled !== false : false;
156
+ const conversationAccess = pluginEntry?.hooks?.allowConversationAccess === true;
157
+
158
+ const loadPaths = Array.isArray(cfg?.plugins?.load?.paths) ? cfg.plugins.load.paths : [];
159
+ const normalizedPluginEntryDir = path.resolve(pluginEntryDir);
160
+ const linked = loadPaths.some(
161
+ (entry) => path.resolve(String(entry || "")) === normalizedPluginEntryDir,
162
+ );
163
+
164
+ const installs =
165
+ cfg?.plugins?.installs && typeof cfg.plugins.installs === "object" ? cfg.plugins.installs : {};
166
+ const installEntry = installs[pluginId];
167
+ const installed = Boolean(installEntry);
168
+
169
+ return {
170
+ configured: enabled && linked && pluginFilesReady && conversationAccess,
171
+ enabled,
172
+ linked,
173
+ installed,
174
+ pluginFilesReady,
175
+ conversationAccess,
176
+ ...paths,
177
+ };
178
+ }
179
+
180
+ async function ensureOpenclawSessionPluginPolicy({ openclawConfigPath, pluginId } = {}) {
181
+ if (!openclawConfigPath || !pluginId) {
182
+ throw new Error("openclawConfigPath and pluginId are required");
183
+ }
184
+
185
+ let cfg = JSON.parse(await fs.readFile(openclawConfigPath, "utf8"));
186
+ if (!cfg || typeof cfg !== "object" || Array.isArray(cfg)) {
187
+ cfg = {};
188
+ }
189
+ if (!cfg.plugins || typeof cfg.plugins !== "object" || Array.isArray(cfg.plugins)) {
190
+ cfg.plugins = {};
191
+ }
192
+ if (
193
+ !cfg.plugins.entries ||
194
+ typeof cfg.plugins.entries !== "object" ||
195
+ Array.isArray(cfg.plugins.entries)
196
+ ) {
197
+ cfg.plugins.entries = {};
198
+ }
199
+
200
+ const existingEntry = cfg.plugins.entries[pluginId];
201
+ const entry =
202
+ existingEntry && typeof existingEntry === "object" && !Array.isArray(existingEntry)
203
+ ? existingEntry
204
+ : {};
205
+ cfg.plugins.entries[pluginId] = entry;
206
+
207
+ let changed = existingEntry !== entry;
208
+ if (entry.enabled === false) {
209
+ entry.enabled = true;
210
+ changed = true;
211
+ }
212
+ if (!entry.hooks || typeof entry.hooks !== "object" || Array.isArray(entry.hooks)) {
213
+ entry.hooks = {};
214
+ changed = true;
215
+ }
216
+
217
+ if (entry.hooks.allowConversationAccess === true) {
218
+ if (!changed) return { changed: false };
219
+ } else {
220
+ entry.hooks.allowConversationAccess = true;
221
+ changed = true;
222
+ }
223
+
224
+ await fs.writeFile(openclawConfigPath, `${JSON.stringify(cfg, null, 2)}\n`, "utf8");
225
+ return { changed: true };
226
+ }
227
+
228
+ async function removeOpenclawSessionPluginConfig({
229
+ home = os.homedir(),
230
+ trackerDir,
231
+ env = process.env,
232
+ } = {}) {
233
+ const paths = resolveOpenclawSessionPluginPaths({ home, trackerDir, env });
234
+ const { openclawConfigPath, pluginEntryDir, pluginId } = paths;
235
+
236
+ let cfg;
237
+ try {
238
+ cfg = JSON.parse(await fs.readFile(openclawConfigPath, "utf8"));
239
+ } catch (err) {
240
+ if (err?.code === "ENOENT" || err?.code === "ENOTDIR") {
241
+ return { removed: false, skippedReason: "openclaw-config-missing", ...paths };
242
+ }
243
+ return {
244
+ removed: false,
245
+ skippedReason: "openclaw-config-unreadable",
246
+ error: err?.message || String(err),
247
+ ...paths,
248
+ };
249
+ }
250
+
251
+ let changed = false;
252
+ const plugins = cfg?.plugins;
253
+
254
+ if (plugins?.entries && Object.prototype.hasOwnProperty.call(plugins.entries, pluginId)) {
255
+ delete plugins.entries[pluginId];
256
+ changed = true;
257
+ if (Object.keys(plugins.entries).length === 0) delete plugins.entries;
258
+ }
259
+
260
+ if (plugins?.load && Array.isArray(plugins.load.paths)) {
261
+ const target = path.resolve(pluginEntryDir);
262
+ const after = plugins.load.paths.filter(
263
+ (entry) => path.resolve(String(entry || "")) !== target,
264
+ );
265
+ if (after.length !== plugins.load.paths.length) {
266
+ plugins.load.paths = after;
267
+ changed = true;
268
+ if (after.length === 0) delete plugins.load.paths;
269
+ if (Object.keys(plugins.load).length === 0) delete plugins.load;
270
+ }
271
+ }
272
+
273
+ if (plugins?.installs && typeof plugins.installs === "object") {
274
+ const installs = plugins.installs;
275
+ if (Object.prototype.hasOwnProperty.call(installs, pluginId)) {
276
+ delete installs[pluginId];
277
+ changed = true;
278
+ }
279
+
280
+ const target = path.resolve(pluginEntryDir);
281
+ for (const [id, entry] of Object.entries(installs)) {
282
+ const sourcePath = normalizeString(entry?.sourcePath);
283
+ const installPath = normalizeString(entry?.installPath);
284
+ if (
285
+ (sourcePath && path.resolve(sourcePath) === target) ||
286
+ (installPath && path.resolve(installPath) === target)
287
+ ) {
288
+ delete installs[id];
289
+ changed = true;
290
+ }
291
+ }
292
+
293
+ if (Object.keys(installs).length === 0) delete plugins.installs;
294
+ }
295
+
296
+ if (plugins && Object.keys(plugins).length === 0) {
297
+ delete cfg.plugins;
298
+ changed = true;
299
+ }
300
+
301
+ if (changed) {
302
+ await fs.writeFile(openclawConfigPath, `${JSON.stringify(cfg, null, 2)}\n`, "utf8");
303
+ }
304
+
305
+ const hadFiles = await fs
306
+ .stat(pluginEntryDir)
307
+ .then((st) => st.isDirectory())
308
+ .catch(() => false);
309
+ await fs.rm(pluginEntryDir, { recursive: true, force: true }).catch(() => {});
310
+
311
+ return { removed: changed || hadFiles, ...paths };
312
+ }
313
+
314
+ function buildSessionPluginPackageJson() {
315
+ return `${JSON.stringify(
316
+ {
317
+ name: "@tokenusage/openclaw-session-sync",
318
+ version: "0.0.0",
319
+ private: true,
320
+ type: "module",
321
+ openclaw: {
322
+ extensions: ["./index.js"],
323
+ },
324
+ },
325
+ null,
326
+ 2,
327
+ )}\n`;
328
+ }
329
+
330
+ function buildSessionPluginMeta() {
331
+ return `${JSON.stringify(
332
+ {
333
+ id: OPENCLAW_SESSION_PLUGIN_ID,
334
+ name: "Token Usage OpenClaw Session Sync",
335
+ description: "Trigger tokenusage sync on OpenClaw agent/session lifecycle events.",
336
+ configSchema: {
337
+ type: "object",
338
+ additionalProperties: false,
339
+ properties: {},
340
+ },
341
+ },
342
+ null,
343
+ 2,
344
+ )}\n`;
345
+ }
346
+
347
+ function buildSessionPluginIndex({ trackerDir, packageName = "tokenusage-cli", openclawHome }) {
348
+ const trackerBinPath = path.join(trackerDir, "app", "bin", "tracker.js");
349
+ const fallbackPkg = packageName || "tokenusage-cli";
350
+ const safeOpenclawHome = openclawHome || path.join(os.homedir(), ".openclaw");
351
+
352
+ return (
353
+ `import fs from 'node:fs';\n` +
354
+ `import path from 'node:path';\n` +
355
+ `import cp from 'node:child_process';\n` +
356
+ `\n` +
357
+ `const trackerDir = ${JSON.stringify(trackerDir)};\n` +
358
+ `const trackerBinPath = ${JSON.stringify(trackerBinPath)};\n` +
359
+ `const fallbackPkg = ${JSON.stringify(fallbackPkg)};\n` +
360
+ `const openclawHome = ${JSON.stringify(safeOpenclawHome)};\n` +
361
+ `const depsMarkerPath = path.join(trackerDir, 'app', 'bin', 'tracker.js');\n` +
362
+ `const triggerStatePath = path.join(trackerDir, 'openclaw.session-sync.trigger-state.json');\n` +
363
+ `const SESSION_TRIGGER_THROTTLE_MS = 15_000;\n` +
364
+ `\n` +
365
+ `export default function register(api) {\n` +
366
+ ` api.on('agent_end', async (_event, ctx) => {\n` +
367
+ ` try {\n` +
368
+ ` const sessionKey = normalize(ctx && ctx.sessionKey);\n` +
369
+ ` if (!sessionKey) return;\n` +
370
+ `\n` +
371
+ ` const agentId = normalize(ctx && ctx.agentId) || parseAgentId(sessionKey);\n` +
372
+ ` if (!agentId) return;\n` +
373
+ `\n` +
374
+ ` const sessionInfo = await resolveSessionInfo(agentId, sessionKey);\n` +
375
+ ` const sessionId = normalize(sessionInfo && sessionInfo.sessionId);\n` +
376
+ ` if (!sessionId) return;\n` +
377
+ `\n` +
378
+ ` if (!allowTrigger('agent_end', agentId, sessionId)) return;\n` +
379
+ `\n` +
380
+ ` spawnSync({\n` +
381
+ ` args: ['sync', '--auto', '--from-openclaw'],\n` +
382
+ ` env: buildSessionEnv({\n` +
383
+ ` agentId,\n` +
384
+ ` sessionId,\n` +
385
+ ` sessionKey,\n` +
386
+ ` sessionEntry: sessionInfo && sessionInfo.entry\n` +
387
+ ` })\n` +
388
+ ` });\n` +
389
+ ` } catch (_) {}\n` +
390
+ ` });\n` +
391
+ `\n` +
392
+ ` api.on('gateway_start', async () => {\n` +
393
+ ` try {\n` +
394
+ ` if (!allowTrigger('gateway_start', 'gateway', 'startup')) return;\n` +
395
+ ` spawnSync({ args: ['sync', '--auto', '--from-openclaw'] });\n` +
396
+ ` } catch (_) {}\n` +
397
+ ` });\n` +
398
+ `\n` +
399
+ ` api.on('gateway_stop', async () => {\n` +
400
+ ` try {\n` +
401
+ ` if (!allowTrigger('gateway_stop', 'gateway', 'stop')) return;\n` +
402
+ ` spawnSync({ args: ['sync', '--auto', '--from-openclaw'] });\n` +
403
+ ` } catch (_) {}\n` +
404
+ ` });\n` +
405
+ `}\n` +
406
+ `\n` +
407
+ `function spawnSync({ args, env = {} }) {\n` +
408
+ ` const hasLocalRuntime = fs.existsSync(trackerBinPath);\n` +
409
+ ` const hasLocalDeps = fs.existsSync(depsMarkerPath);\n` +
410
+ ` const argv = Array.isArray(args) && args.length > 0 ? args : ['sync', '--auto'];\n` +
411
+ ` const cmd = hasLocalRuntime && hasLocalDeps\n` +
412
+ ` ? [process.execPath, trackerBinPath, ...argv]\n` +
413
+ ` : ['npx', '--yes', fallbackPkg, ...argv];\n` +
414
+ ` const child = cp.spawn(cmd[0], cmd.slice(1), {\n` +
415
+ ` detached: true,\n` +
416
+ ` stdio: 'ignore',\n` +
417
+ ` env: { ...process.env, ...env }\n` +
418
+ ` });\n` +
419
+ ` child.unref();\n` +
420
+ `}\n` +
421
+ `\n` +
422
+ `function buildSessionEnv({ agentId, sessionId, sessionKey, sessionEntry }) {\n` +
423
+ ` const out = {\n` +
424
+ ` TOKENUSAGE_OPENCLAW_AGENT_ID: agentId,\n` +
425
+ ` TOKENUSAGE_OPENCLAW_PREV_SESSION_ID: sessionId,\n` +
426
+ ` TOKENUSAGE_OPENCLAW_HOME: openclawHome\n` +
427
+ ` };\n` +
428
+ ` const key = normalize(sessionKey);\n` +
429
+ ` if (key) out.TOKENUSAGE_OPENCLAW_SESSION_KEY = key;\n` +
430
+ ` const prevTotalTokens = toNonNegativeInt(sessionEntry && sessionEntry.totalTokens);\n` +
431
+ ` const prevInputTokens = toNonNegativeInt(sessionEntry && sessionEntry.inputTokens);\n` +
432
+ ` const prevOutputTokens = toNonNegativeInt(sessionEntry && sessionEntry.outputTokens);\n` +
433
+ ` const prevModel = normalize(sessionEntry && sessionEntry.model);\n` +
434
+ ` const prevUpdatedAt = toIso(sessionEntry && sessionEntry.updatedAt);\n` +
435
+ ` if (prevTotalTokens != null) out.TOKENUSAGE_OPENCLAW_PREV_TOTAL_TOKENS = String(prevTotalTokens);\n` +
436
+ ` if (prevInputTokens != null) out.TOKENUSAGE_OPENCLAW_PREV_INPUT_TOKENS = String(prevInputTokens);\n` +
437
+ ` if (prevOutputTokens != null) out.TOKENUSAGE_OPENCLAW_PREV_OUTPUT_TOKENS = String(prevOutputTokens);\n` +
438
+ ` if (prevModel) out.TOKENUSAGE_OPENCLAW_PREV_MODEL = prevModel;\n` +
439
+ ` if (prevUpdatedAt) out.TOKENUSAGE_OPENCLAW_PREV_UPDATED_AT = prevUpdatedAt;\n` +
440
+ ` return out;\n` +
441
+ `}\n` +
442
+ `\n` +
443
+ `async function resolveSessionInfo(agentId, sessionKey) {\n` +
444
+ ` const key = normalize(sessionKey);\n` +
445
+ ` if (!key) return null;\n` +
446
+ ` const sessionsPath = path.join(openclawHome, 'agents', agentId, 'sessions', 'sessions.json');\n` +
447
+ ` if (fs.existsSync(sessionsPath)) {\n` +
448
+ ` try {\n` +
449
+ ` const raw = fs.readFileSync(sessionsPath, 'utf8');\n` +
450
+ ` const parsed = JSON.parse(raw);\n` +
451
+ ` if (parsed && typeof parsed === 'object') {\n` +
452
+ ` const entry = parsed[key];\n` +
453
+ ` if (entry && typeof entry === 'object' && normalize(entry.sessionId)) {\n` +
454
+ ` return { sessionKey: key, sessionId: normalize(entry.sessionId), entry };\n` +
455
+ ` }\n` +
456
+ ` }\n` +
457
+ ` } catch (_) {}\n` +
458
+ ` }\n` +
459
+ ` // OpenClaw >= 2026.9.9 keeps session state in a per-agent SQLite\n` +
460
+ ` // database (~/.openclaw/agents/<id>/agent/openclaw-agent.sqlite);\n` +
461
+ ` // sessions.json is no longer written. Without this fallback the\n` +
462
+ ` // plugin would silently no-op on every agent_end for anyone on a\n` +
463
+ ` // current OpenClaw install (issue: openclaw migration to sqlite).\n` +
464
+ ` return resolveSessionInfoFromSqlite(agentId, key);\n` +
465
+ `}\n` +
466
+ `\n` +
467
+ `async function resolveSessionInfoFromSqlite(agentId, sessionKey) {\n` +
468
+ ` const sqliteModule = await importSqliteSync();\n` +
469
+ ` if (!sqliteModule) return null;\n` +
470
+ ` const { DatabaseSync } = sqliteModule;\n` +
471
+ ` const currentSessionQuery = "SELECT w.session_id FROM session_nodes n JOIN session_windows w ON w.session_id = n.current_session_id WHERE n.session_key = ? AND COALESCE(w.reason, '') != 'compaction'";\n` +
472
+ ` const sessionQuery = "SELECT session_id FROM session_windows WHERE session_key = ? AND COALESCE(reason, '') != 'compaction' ORDER BY updated_at DESC LIMIT 1";\n` +
473
+ ` const dbCandidates = [path.join(openclawHome, 'agents', agentId, 'agent', 'openclaw-agent.sqlite'), path.join(openclawHome, 'agents', agentId, 'openclaw-agent.sqlite')];\n` +
474
+ ` for (const dbPath of dbCandidates) {\n` +
475
+ ` if (!fs.existsSync(dbPath)) continue;\n` +
476
+ ` let db;\n` +
477
+ ` try { db = new DatabaseSync(dbPath, { readOnly: true }); } catch (_) { continue; }\n` +
478
+ ` try {\n` +
479
+ ` let row;\n` +
480
+ ` try { row = db.prepare(currentSessionQuery).get(sessionKey); } catch (_) {}\n` +
481
+ ` if (!row || !row.session_id) row = db.prepare(sessionQuery).get(sessionKey);\n` +
482
+ ` if (!row || !row.session_id) continue;\n` +
483
+ ` // The passive SQLite reader owns per-event accounting; never synthesize lifetime sums.\n` +
484
+ ` return { sessionKey, sessionId: row.session_id, entry: {} };\n` +
485
+ ` } catch (_) {}\n` +
486
+ ` finally { try { db.close(); } catch (_) {} }\n` +
487
+ ` }\n` +
488
+ ` return null;\n` +
489
+ `}\n` +
490
+ `\n` +
491
+ `async function importSqliteSync() {\n` +
492
+ ` try { return await import('node:sqlite'); } catch (_) { return null; }\n` +
493
+ `}\n` +
494
+ `\n` +
495
+ `function parseAgentId(sessionKey) {\n` +
496
+ ` const s = normalize(sessionKey);\n` +
497
+ ` if (!s || !s.startsWith('agent:')) return null;\n` +
498
+ ` const parts = s.split(':');\n` +
499
+ ` return parts.length >= 2 ? normalize(parts[1]) : null;\n` +
500
+ `}\n` +
501
+ `\n` +
502
+ `function allowTrigger(kind, scope, target) {\n` +
503
+ ` const key = [kind, scope || 'na', target || 'na'].join(':');\n` +
504
+ ` const now = Date.now();\n` +
505
+ ` let state = {};\n` +
506
+ ` try {\n` +
507
+ ` state = JSON.parse(fs.readFileSync(triggerStatePath, 'utf8'));\n` +
508
+ ` if (!state || typeof state !== 'object') state = {};\n` +
509
+ ` } catch (_) {}\n` +
510
+ ` const last = Number(state[key] || 0);\n` +
511
+ ` if (Number.isFinite(last) && now - last < SESSION_TRIGGER_THROTTLE_MS) return false;\n` +
512
+ ` state[key] = now;\n` +
513
+ ` try {\n` +
514
+ ` fs.mkdirSync(path.dirname(triggerStatePath), { recursive: true });\n` +
515
+ ` fs.writeFileSync(triggerStatePath, JSON.stringify(state), 'utf8');\n` +
516
+ ` } catch (_) {}\n` +
517
+ ` return true;\n` +
518
+ `}\n` +
519
+ `\n` +
520
+ `function normalize(v) {\n` +
521
+ ` if (typeof v !== 'string') return null;\n` +
522
+ ` const s = v.trim();\n` +
523
+ ` return s.length > 0 ? s : null;\n` +
524
+ `}\n` +
525
+ `\n` +
526
+ `function toNonNegativeInt(v) {\n` +
527
+ ` const n = Number(v);\n` +
528
+ ` if (!Number.isFinite(n) || n < 0) return null;\n` +
529
+ ` return Math.floor(n);\n` +
530
+ `}\n` +
531
+ `\n` +
532
+ `function toIso(v) {\n` +
533
+ ` if (typeof v === 'string') {\n` +
534
+ ` const s = normalize(v);\n` +
535
+ ` if (s && !Number.isNaN(Date.parse(s))) return s;\n` +
536
+ ` }\n` +
537
+ ` const n = Number(v);\n` +
538
+ ` if (!Number.isFinite(n) || n <= 0) return null;\n` +
539
+ ` const ms = n < 1e12 ? Math.floor(n * 1000) : Math.floor(n);\n` +
540
+ ` const d = new Date(ms);\n` +
541
+ ` return Number.isNaN(d.getTime()) ? null : d.toISOString();\n` +
542
+ `}\n`
543
+ );
544
+ }
545
+
546
+ function normalizeString(value) {
547
+ if (typeof value !== "string") return null;
548
+ const trimmed = value.trim();
549
+ return trimmed.length > 0 ? trimmed : null;
550
+ }
551
+
552
+ module.exports = {
553
+ OPENCLAW_SESSION_PLUGIN_ID,
554
+ OPENCLAW_SESSION_PLUGIN_DIRNAME,
555
+ resolveOpenclawSessionPluginPaths,
556
+ ensureOpenclawSessionPluginFiles,
557
+ installOpenclawSessionPlugin,
558
+ probeOpenclawSessionPluginState,
559
+ removeOpenclawSessionPluginConfig,
560
+ };