idlewatch 0.1.0

package/test/fixtures/openclaw-status-snake-session-wrapper.json

@@ -0,0 +1,13 @@
+{
+  "status": {
+    "current_session": {
+      "session_id": "snake-current-1",
+      "agent_id": "agent-snake",
+      "model": "gpt-5.3-codex",
+      "total_tokens": 8888,
+      "updated_at": 1771299000,
+      "ts": 1771299012345
+    },
+    "default_model": "gpt-5.3-codex"
+  }
+}

package/test/fixtures/openclaw-status-stats-current-sessions-snake-tokens.json

@@ -0,0 +1,25 @@
+{
+  "status": {
+    "stats": {
+      "current": {
+        "sessions": [
+          {
+            "sessionId": "legacy-1",
+            "agentId": "agent-legacy-1",
+            "model": "gpt-4.1",
+            "total_tokens": "111",
+            "updatedAt": 1771261000000
+          },
+          {
+            "session_id": "active-string-tokens",
+            "agent_id": "agent-legacy-2",
+            "defaultModel": "gpt-5.3-codex",
+            "total_tokens": "4321",
+            "updatedAt": 1771279100000,
+            "tokensPerMinute": 42.0
+          }
+        ]
+      }
+    }
+  }
+}

package/test/fixtures/openclaw-status-stats-current-sessions.json

@@ -0,0 +1,28 @@
+{
+  "status": {
+    "stats": {
+      "current": {
+        "sessions": [
+          {
+            "sessionId": "old-session",
+            "agentId": "agent-old",
+            "model": "gpt-4.1",
+            "totalTokens": 100,
+            "updatedAt": 1771270000000
+          },
+          {
+            "sessionId": "active-session",
+            "agentId": "agent-active",
+            "model": "gpt-5.3-codex",
+            "totalTokens": 4321,
+            "updatedAt": 1771279100000,
+            "tokensPerMinute": 66.6
+          }
+        ],
+        "totals": {
+          "totalTokens": 4421
+        }
+      }
+    }
+  }
+}

package/test/fixtures/openclaw-status-stats-current-usage-time-camelcase.json

@@ -0,0 +1,19 @@
+{
+  "status": {
+    "current": {
+      "stats": {
+        "current": {
+          "session": {
+            "sessionId": "camelcase-session",
+            "agentId": "agent-camel",
+            "model": "gpt-5.3-codex",
+            "totalTokens": 555,
+            "tokensPerMinute": 22,
+            "usageTime": "2026-02-27T11:30:00.000Z"
+          }
+        }
+      }
+    }
+  },
+  "ts": 1771323000000
+}

package/test/fixtures/openclaw-status-stats-session-default-model.json

@@ -0,0 +1,27 @@
+{
+  "status": {
+    "stats": {
+      "current": {
+        "sessions": [
+          {
+            "sessionId": "legacy-model",
+            "defaultModel": "claude-mini-3.7",
+            "agentId": "agent-default-model",
+            "totalTokens": "777",
+            "updatedAt": 1771274000000,
+            "tokensPerMinute": "12.34"
+          },
+          {
+            "sessionId": "better-total",
+            "default_model": "gpt-4.1-mini",
+            "defaultModel": "should-not-win",
+            "agentId": "agent-legacy",
+            "total_tokens": "999",
+            "updatedAt": 1771264000000,
+            "tokens_per_minute": 9.87
+          }
+        ]
+      }
+    }
+  }
+}

package/test/fixtures/openclaw-status-status-wrapper.json

@@ -0,0 +1,13 @@
+{
+  "status": {
+    "current": {
+      "model": "gpt-5.3-codex-spark",
+      "totalTokens": 4321,
+      "sessionId": "status-wrap-session",
+      "agent_id": "agent-status-wrap",
+      "updatedAt": 1771300100,
+      "updatedAtMs": 1771300100
+    },
+    "defaultModel": "gpt-5.3-codex-spark"
+  }
+}

package/test/fixtures/openclaw-status-strings.json

@@ -0,0 +1,38 @@
+{
+  "sessions": {
+    "defaults": {
+      "model": "gpt-5.3-codex",
+      "defaultModel": "gpt-5.3-codex-spark"
+    },
+    "recent": [
+      {
+        "agentId": "agent-1",
+        "sessionId": "a9f2d3",
+        "updatedAt": "1771278800000",
+        "age": "600000",
+        "total_tokens": "120",
+        "totalTokensFresh": "false",
+        "model": "gpt-5.3-codex",
+        "tokens_per_minute": "12.75"
+      },
+      {
+        "agentId": "agent-2",
+        "sessionId": "b7e1f8",
+        "updatedAt": 1771278820000,
+        "ageMs": "30000",
+        "totalTokens": "450",
+        "totalTokensFresh": "true",
+        "model": "claude-opus-4-6",
+        "tokensPerMinute": "45"
+      },
+      {
+        "agentId": "agent-3",
+        "sessionId": "f2c9aa",
+        "updatedAt": 1771278830000,
+        "age": 15000,
+        "totalTokens": null,
+        "model": "gpt-5.3-codex"
+      }
+    ]
+  }
+}

package/test/fixtures/openclaw-status-ts-ms-alias.json

@@ -0,0 +1,14 @@
+{
+  "status": {
+    "current": {
+      "session": {
+        "sessionId": "ts-ms-session",
+        "agentId": "agent-ts-ms",
+        "model": "gpt-5.3-codex",
+        "totalTokens": 1500,
+        "tokensPerMinute": 77,
+        "usage_ts_ms": 1771319900000
+      }
+    }
+  }
+}

package/test/fixtures/openclaw-status-updated-at-ms-alias.json

@@ -0,0 +1,14 @@
+{
+  "status": {
+    "current": {
+      "session": {
+        "sessionId": "ts-ms-updated-at-session",
+        "agentId": "agent-ts-ms-updated-at",
+        "model": "gpt-5.3-codex-spark",
+        "totalTokens": 2500,
+        "tokensPerMinute": 31.2,
+        "updated_at_ms": 1771325000000
+      }
+    }
+  }
+}

package/test/fixtures/openclaw-status-usage-timestamp-ms-alias.json

@@ -0,0 +1,14 @@
+{
+  "status": {
+    "current": {
+      "session": {
+        "sessionId": "ts-ms-underscore-session",
+        "agentId": "agent-ts-ms-underscore",
+        "model": "qwen3",
+        "totalTokens": 1717,
+        "tokensPerMinute": 22,
+        "usage_timestamp_ms": 1771321200000
+      }
+    }
+  }
+}

package/test/fixtures/openclaw-status-usage-ts-alias.json

@@ -0,0 +1,14 @@
+{
+  "status": {
+    "current": {
+      "session": {
+        "sessionId": "usage-ts-session",
+        "agentId": "agent-usage-ts",
+        "model": "gpt-5.3-codex",
+        "totalTokens": 1900,
+        "tokensPerMinute": 44,
+        "usage_ts": 1771319000
+      }
+    }
+  }
+}

package/test/fixtures/openclaw-status-wrap-session-object.json

@@ -0,0 +1,24 @@
+{
+  "result": {
+    "defaultModel": "gpt-4.1",
+    "defaults": {
+      "defaultModel": "gpt-4.1"
+    },
+    "sessions": [
+      {
+        "id": "wrapped-session-a",
+        "agentId": "agent-wrap",
+        "usage": {
+          "model": "claude-opus-4.6",
+          "totals": {
+            "totalTokens": "789"
+          },
+          "updatedAt": "2026-02-17T09:00:00Z",
+          "tokensPerMinute": "12.5",
+          "sessionId": "wrapped-session-a"
+        },
+        "age": 120000
+      }
+    ]
+  }
+}

package/test/fixtures/openclaw-status.json

@@ -0,0 +1,41 @@
+{
+  "sessions": {
+    "defaults": {
+      "model": "gpt-5.3-codex",
+      "contextTokens": 272000
+    },
+    "recent": [
+      {
+        "agentId": "main",
+        "sessionId": "781280ba-01a6-49d9-9c75-09519f28f709",
+        "updatedAt": 1771278795632,
+        "age": 29308,
+        "totalTokens": null,
+        "totalTokensFresh": false,
+        "model": "gpt-5.3-codex"
+      },
+      {
+        "agentId": "main",
+        "sessionId": "45f23527-d596-469a-882c-9bba6dc8b5a0",
+        "updatedAt": 1771278693678,
+        "age": 131262,
+        "inputTokens": 1036,
+        "outputTokens": 96,
+        "totalTokens": 67980,
+        "totalTokensFresh": true,
+        "model": "gpt-5.3-codex"
+      },
+      {
+        "agentId": "main",
+        "sessionId": "90d2a820-6d77-42f0-8db4-12b90f9f7203",
+        "updatedAt": 1771278893678,
+        "age": 11000,
+        "inputTokens": 1200,
+        "outputTokens": 210,
+        "totalTokens": 70500,
+        "totalTokensFresh": true,
+        "model": "gpt-5.3-codex"
+      }
+    ]
+  }
+}

package/test/fixtures/openclaw-usage-model-name-generic.json

@@ -0,0 +1,9 @@
+{
+  "model_name": "llama-3.3",
+  "total_tokens": "135",
+  "tokens_per_minute": "21.5",
+  "session_id": "generic-model-name",
+  "agent_id": "agent-generic",
+  "updatedAt": 1771324000000,
+  "ageMs": 12000
+}

package/test/gpu.test.mjs

@@ -0,0 +1,58 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { gpuSampleDarwin, __gpuTestUtils } from '../src/gpu.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+const fixture = (name) => fs.readFileSync(path.join(__dirname, 'fixtures', name), 'utf8').trim()
+
+const { parseIoregGpuUtilization, parseGpuPercent } = __gpuTestUtils
+
+test('parses ioreg AGX performance statistics device utilization', () => {
+  const sample = fixture('gpu-agx.txt')
+  assert.equal(parseIoregGpuUtilization(sample), 34)
+})
+
+test('parses ioreg IOGPU performance statistics when AGX is unavailable', () => {
+  const sample = fixture('gpu-iogpu.txt')
+  assert.equal(parseIoregGpuUtilization(sample), 1.2)
+})
+
+test('parses powermetrics GPU residency percent', () => {
+  const sample = 'GPU HW active residency: 18.25%\nGPU SW requested state: 5'
+  assert.equal(parseGpuPercent(sample, 'powermetrics'), 18.25)
+})
+
+test('parses top grep fallback output', () => {
+  const sample = fixture('gpu-top-grep.txt')
+  assert.equal(parseGpuPercent(sample, 'top-grep'), 7.8)
+})
+
+test('gpu sampler captures three distinct macOS telemetry sources deterministically', () => {
+  const fakeExec = (cmd) => {
+    if (cmd.includes('AGXAccelerator')) {
+      return fixture('gpu-agx.txt')
+    }
+    if (cmd.includes('IOGPU')) {
+      return fixture('gpu-iogpu.txt')
+    }
+    if (cmd.includes('powermetrics')) {
+      return 'GPU HW active residency: 11.11%\nGPU SW requested state: 5'
+    }
+    if (cmd.includes('top -l 1 | grep -i \'GPU\'')) {
+      return fixture('gpu-top-grep.txt')
+    }
+    throw new Error(`unexpected command in test: ${cmd}`)
+  }
+
+  const gpu = gpuSampleDarwin(fakeExec)
+  assert.deepEqual(gpu, {
+    pct: 34,
+    source: 'ioreg-agx',
+    confidence: 'high',
+    sampleWindowMs: null
+  })
+})

package/test/memory.test.mjs

@@ -0,0 +1,35 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { parseMemoryPressurePct, memoryPressureDarwin } from '../src/memory.js'
+
+test('parseMemoryPressurePct derives pressure from free percentage output', () => {
+  const raw = 'System-wide memory free percentage: 24%\nPages free: 12345.'
+  assert.equal(parseMemoryPressurePct(raw), 76)
+})
+
+test('parseMemoryPressurePct supports explicit pressure output', () => {
+  const raw = 'System-wide memory pressure: 67.5%\n'
+  assert.equal(parseMemoryPressurePct(raw), 67.5)
+})
+
+test('memoryPressureDarwin returns unavailable when command fails', () => {
+  const sample = memoryPressureDarwin(() => {
+    throw new Error('boom')
+  })
+
+  assert.deepEqual(sample, {
+    pct: null,
+    cls: 'unavailable',
+    source: 'unavailable'
+  })
+})
+
+test('memoryPressureDarwin returns classified value when parse succeeds', () => {
+  const sample = memoryPressureDarwin(() => 'System-wide memory free percentage: 12%')
+
+  assert.deepEqual(sample, {
+    pct: 88,
+    cls: 'warning',
+    source: 'memory_pressure'
+  })
+})

package/test/openclaw-cache.test.mjs

@@ -0,0 +1,48 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { mkdtempSync, rmSync, writeFileSync, readdirSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import path from 'node:path'
+import { loadLastGoodUsageSnapshot, persistLastGoodUsageSnapshot } from '../src/openclaw-cache.js'
+
+test('persists and reloads last-good usage snapshot', () => {
+  const dir = mkdtempSync(path.join(tmpdir(), 'idlewatch-cache-test-'))
+  const cachePath = path.join(dir, 'last-good.json')
+  const now = Date.now()
+
+  const saved = persistLastGoodUsageSnapshot(cachePath, {
+    at: now - 500,
+    usage: { model: 'gpt-5.3-codex', totalTokens: 12345 }
+  })
+  assert.equal(saved, true)
+
+  const loaded = loadLastGoodUsageSnapshot(cachePath, now)
+  assert.ok(loaded)
+  assert.equal(loaded.usage.model, 'gpt-5.3-codex')
+  assert.equal(loaded.usage.totalTokens, 12345)
+  assert.ok(Number.isFinite(loaded.ageMs) && loaded.ageMs >= 0)
+
+  const files = readdirSync(dir)
+  assert.ok(files.includes('last-good.json'))
+  assert.equal(files.some((name) => name.startsWith('last-good.json.tmp-')), false)
+
+  rmSync(dir, { recursive: true, force: true })
+})
+
+test('returns null on corrupt cache payload', () => {
+  const dir = mkdtempSync(path.join(tmpdir(), 'idlewatch-cache-test-'))
+  const cachePath = path.join(dir, 'last-good.json')
+
+  persistLastGoodUsageSnapshot(cachePath, {
+    at: Date.now(),
+    usage: { model: 'ok' }
+  })
+
+  // corrupt file after write
+  writeFileSync(cachePath, '{nope', 'utf8')
+
+  const loaded = loadLastGoodUsageSnapshot(cachePath)
+  assert.equal(loaded, null)
+
+  rmSync(dir, { recursive: true, force: true })
+})