@klars/agentobs 0.1.1 → 0.1.2

package/README.md

@@ -168,6 +168,26 @@ across calls to manufacture a number.
 Model prices live in `~/.agentobs/pricing.json` and are yours to edit. A model
 missing from that file shows cost as `—`, never `$0.00`.
 
+
+### Hook latency
+
+The hook does its own work in **well under 1ms** (measured: ~0.3ms per
+invocation, including the SQLite write). What you actually pay per tool call is
+**Node.js process startup**, since Claude Code spawns the hook as a fresh
+process each time.
+
+On a typical Linux/macOS machine that is ~40-80ms. On Windows with real-time
+antivirus scanning it can reach **1-1.5 seconds** - and that cost is not
+specific to AgentObs: a bare `node -e "0"` measures the same. Check yours with:
+
+```bash
+node -e "0"          # time this; it is the floor for any Node-based hook
+```
+
+If it is slow, adding an exclusion for your Node install directory and
+`~/.agentobs` in your antivirus settings is the fix. There is no code change
+that avoids it - the cost is paid before AgentObs runs at all.
+
 ---
 
 ## Dashboard access

package/dist/commands/hook-config.js

@@ -22,7 +22,31 @@ import { existsSync } from 'node:fs';
  */
 export function hookCommandPath() {
     const here = dirname(fileURLToPath(import.meta.url));
-    // dist/commands -> package root
+    // On Windows, prefer npm's generated .cmd shim in the global bin directory.
+    //
+    // The raw bin/agentobs-hook file has no extension, and Windows cannot
+    // execute an extensionless file - cmd.exe reports "not recognized as an
+    // internal or external command". Claude Code swallows that, so the hook
+    // silently never runs and no data is ever recorded: the worst possible
+    // failure for an observability tool, because it looks like "no activity"
+    // rather than "broken". npm generates the .cmd shim for exactly this.
+    if (process.platform === 'win32') {
+        // dist/commands -> .../node_modules/@klars/agentobs -> up to the dir
+        // holding npm's shims (node_modules/.bin, or the global npm root).
+        const packageRoot = resolve(here, '..', '..');
+        const shims = [
+            resolve(packageRoot, '..', '..', '..', 'agentobs-hook.cmd'), // global npm root
+            resolve(packageRoot, '..', '..', '.bin', 'agentobs-hook.cmd'), // local node_modules/.bin
+        ];
+        for (const shim of shims) {
+            if (existsSync(shim))
+                return shim;
+        }
+        // No shim found (e.g. running from a source checkout): fall back to the
+        // bare name so PATH resolution can still find it, rather than emitting a
+        // path that is guaranteed not to execute.
+        return 'agentobs-hook.cmd';
+    }
     const candidate = resolve(here, '..', '..', 'bin', 'agentobs-hook');
     if (existsSync(candidate))
         return candidate;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@klars/agentobs",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Observability and control layer for AI coding agents - see every tool call, token, and dollar your agents spend, and stop them before they do something risky.",
   "license": "MIT",
   "author": "Klars AI",