aisnitch 0.2.22 → 0.2.24

package/dist/cli/index.js

@@ -743,7 +743,7 @@ import { Command, InvalidArgumentError } from "commander";
 
 // src/package-info.ts
 var AISNITCH_PACKAGE_NAME = "aisnitch";
-var AISNITCH_VERSION = "0.2.22";
+var AISNITCH_VERSION = "0.2.24";
 var AISNITCH_DESCRIPTION = "Universal bridge for AI coding tool activity \u2014 capture, normalize, stream.";
 
 // src/core/events/schema.ts
@@ -1927,6 +1927,9 @@ var OpenClawSetup = class {
   hookHandlerPath;
   hookUrl;
   openclawHomeDirectory;
+  pluginDirectory;
+  pluginFilePath;
+  pluginDocumentPath;
   toolName = "openclaw";
   constructor(httpPort, dependencies = {}) {
     this.binaryExists = dependencies.binaryExists ?? isBinaryAvailable;
@@ -1940,6 +1943,13 @@ var OpenClawSetup = class {
     this.hookDocumentPath = join2(this.hookDirectory, "HOOK.md");
     this.hookHandlerPath = join2(this.hookDirectory, "handler.ts");
     this.hookUrl = `http://localhost:${httpPort}/hooks/openclaw`;
+    this.pluginDirectory = join2(
+      this.openclawHomeDirectory,
+      "plugins",
+      "aisnitch-monitor"
+    );
+    this.pluginFilePath = join2(this.pluginDirectory, "index.ts");
+    this.pluginDocumentPath = join2(this.pluginDirectory, "README.md");
   }
   async detect() {
     return await this.binaryExists("openclaw") || await fileExists(this.openclawHomeDirectory) || await fileExists("/Applications/OpenClaw.app");
@@ -1951,9 +1961,13 @@ var OpenClawSetup = class {
     const currentConfigContent = await readOptionalFile(this.configPath);
     const currentHookDocument = await readOptionalFile(this.hookDocumentPath);
     const currentHookHandler = await readOptionalFile(this.hookHandlerPath);
+    const currentPluginDocument = await readOptionalFile(this.pluginDocumentPath);
+    const currentPluginFile = await readOptionalFile(this.pluginFilePath);
     const nextConfigContent = this.buildNextConfigContent(currentConfigContent);
     const nextHookDocument = buildOpenClawHookDocumentSource();
     const nextHookHandler = buildOpenClawHookHandlerSource(this.hookUrl);
+    const nextPluginDocument = buildOpenClawPluginDocumentSource();
+    const nextPluginFile = buildOpenClawPluginSource(this.hookUrl);
     return [
       renderColoredDiff(
         this.configPath,
@@ -1971,6 +1985,18 @@ var OpenClawSetup = class {
         this.hookHandlerPath,
         currentHookHandler,
         nextHookHandler
+      ),
+      "",
+      renderColoredDiff(
+        this.pluginDocumentPath,
+        currentPluginDocument,
+        nextPluginDocument
+      ),
+      "",
+      renderColoredDiff(
+        this.pluginFilePath,
+        currentPluginFile,
+        nextPluginFile
       )
     ].join("\n");
   }
@@ -1978,11 +2004,16 @@ var OpenClawSetup = class {
     const currentConfigContent = await readOptionalFile(this.configPath);
     const currentHookDocument = await readOptionalFile(this.hookDocumentPath);
     const currentHookHandler = await readOptionalFile(this.hookHandlerPath);
+    const currentPluginDocument = await readOptionalFile(this.pluginDocumentPath);
+    const currentPluginFile = await readOptionalFile(this.pluginFilePath);
     const nextConfigContent = this.buildNextConfigContent(currentConfigContent);
     const nextHookDocument = buildOpenClawHookDocumentSource();
     const nextHookHandler = buildOpenClawHookHandlerSource(this.hookUrl);
+    const nextPluginDocument = buildOpenClawPluginDocumentSource();
+    const nextPluginFile = buildOpenClawPluginSource(this.hookUrl);
     await mkdir2(dirname2(this.configPath), { recursive: true });
     await mkdir2(this.hookDirectory, { recursive: true });
+    await mkdir2(this.pluginDirectory, { recursive: true });
     if (currentConfigContent !== null) {
       await copyFile(this.configPath, this.getBackupPath(this.configPath));
     }
@@ -1998,14 +2029,30 @@ var OpenClawSetup = class {
         this.getBackupPath(this.hookHandlerPath)
       );
     }
+    if (currentPluginDocument !== null) {
+      await copyFile(
+        this.pluginDocumentPath,
+        this.getBackupPath(this.pluginDocumentPath)
+      );
+    }
+    if (currentPluginFile !== null) {
+      await copyFile(
+        this.pluginFilePath,
+        this.getBackupPath(this.pluginFilePath)
+      );
+    }
     await writeFile2(this.configPath, nextConfigContent, "utf8");
     await writeFile2(this.hookDocumentPath, nextHookDocument, "utf8");
     await writeFile2(this.hookHandlerPath, nextHookHandler, "utf8");
+    await writeFile2(this.pluginDocumentPath, nextPluginDocument, "utf8");
+    await writeFile2(this.pluginFilePath, nextPluginFile, "utf8");
   }
   async revert() {
     await restoreBackupOrRemove(this.configPath);
     await restoreBackupOrRemove(this.hookDocumentPath);
     await restoreBackupOrRemove(this.hookHandlerPath);
+    await restoreBackupOrRemove(this.pluginDocumentPath);
+    await restoreBackupOrRemove(this.pluginFilePath);
   }
   buildNextConfigContent(currentContent) {
     const parsedConfig = parseOpenClawSettings(currentContent);
@@ -2027,6 +2074,15 @@ var OpenClawSetup = class {
         enabled: true
       }
     };
+    const currentPlugins = parsedConfig.plugins ?? {};
+    const currentPluginEntries = currentPlugins.entries ?? {};
+    const nextPluginEntries = {
+      ...currentPluginEntries,
+      "aisnitch-monitor": {
+        ...currentPluginEntries["aisnitch-monitor"] ?? {},
+        enabled: true
+      }
+    };
     const nextConfig = {
       ...parsedConfig,
       hooks: {
@@ -2036,6 +2092,10 @@ var OpenClawSetup = class {
           enabled: true,
           entries: nextEntries
         }
+      },
+      plugins: {
+        ...currentPlugins,
+        entries: nextPluginEntries
       }
     };
     return `${JSON.stringify(nextConfig, null, 2)}
@@ -2870,6 +2930,231 @@ export default async function aisnitchForward(event) {
 }
 `;
 }
+function buildOpenClawPluginDocumentSource() {
+  return `# AISnitch Monitor Plugin
+
+\u{1F4D6} This managed plugin uses OpenClaw's Plugin SDK to forward rich real-time
+events to the local AISnitch HTTP receiver. Unlike the internal hook handler,
+the plugin has access to tool-level hooks (before_tool_call, after_tool_call),
+model-level hooks (model_call_started, model_call_ended), and agent turn hooks
+(agent_end, before_agent_run) \u2014 providing maximum observability fidelity.
+
+## Hooked Events
+
+| Hook | AISnitch Event |
+|:---|:---|
+| gateway_start | session.start |
+| gateway_stop | session.end |
+| before_agent_run | task.start |
+| agent_end | task.complete |
+| before_tool_call | agent.coding / agent.tool_call |
+| after_tool_call | agent.coding / agent.tool_call + results |
+| model_call_started | agent.thinking |
+| model_call_ended | agent.streaming |
+| before_compaction | agent.compact |
+| after_compaction | agent.compact |
+| message_received | context info |
+
+## Managed by AISnitch
+
+This file is managed by \`aisnitch setup openclaw\`. Re-running setup will
+overwrite it. Use \`aisnitch setup openclaw --revert\` to remove it.
+`;
+}
+function buildOpenClawPluginSource(hookUrl) {
+  return `/**
+ * AISnitch OpenClaw Plugin
+ *
+ * \u{1F4D6} Uses OpenClaw's Plugin SDK to forward rich real-time events to AISnitch.
+ * Provides maximum visibility into tool calls, model usage, agent turns,
+ * and lifecycle events \u2014 far beyond what passive file-watching can achieve.
+ *
+ * Managed by \`aisnitch setup openclaw\`. Re-running setup overwrites this file.
+ */
+
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+
+const AISNITCH_ENDPOINT = ${JSON.stringify(hookUrl)};
+
+async function postToAISnitch(payload: Record<string, unknown>): Promise<void> {
+  try {
+    await fetch(AISNITCH_ENDPOINT, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(payload),
+    });
+  } catch {
+    // Silently ignore transport errors so OpenClaw keeps running.
+  }
+}
+
+function getSessionKey(ctx: Record<string, unknown> | undefined): string | undefined {
+  if (!ctx) return undefined;
+  return (
+    (typeof ctx.sessionKey === "string" && ctx.sessionKey.length > 0 ? ctx.sessionKey : undefined) ??
+    (typeof ctx.sessionId === "string" && ctx.sessionId.length > 0 ? ctx.sessionId : undefined)
+  );
+}
+
+function getWorkspaceDir(ctx: Record<string, unknown> | undefined): string | undefined {
+  if (!ctx) return undefined;
+  return (
+    (typeof ctx.workspaceDir === "string" && ctx.workspaceDir.length > 0 ? ctx.workspaceDir : undefined) ??
+    (typeof ctx.cwd === "string" && ctx.cwd.length > 0 ? ctx.cwd : undefined)
+  );
+}
+
+export default definePluginEntry({
+  id: "aisnitch-monitor",
+  name: "AISnitch Monitor",
+  register(api) {
+    // \u2500\u2500 Gateway lifecycle \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+    api.on("gateway_start", (event) => {
+      const ctx = event.ctx as Record<string, unknown> | undefined;
+      void postToAISnitch({
+        event: "gateway:startup",
+        sessionKey: getSessionKey(ctx),
+        context: ctx ?? {},
+        timestamp: new Date().toISOString(),
+      });
+    });
+
+    api.on("gateway_stop", () => {
+      void postToAISnitch({
+        event: "gateway:shutdown",
+        timestamp: new Date().toISOString(),
+      });
+    });
+
+    // \u2500\u2500 Agent turn lifecycle \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+    api.on("before_agent_run", (event) => {
+      const ctx = event.ctx as Record<string, unknown> | undefined;
+      void postToAISnitch({
+        event: "command:new",
+        sessionKey: getSessionKey(ctx),
+        context: {
+          ...ctx,
+          message: event.prompt ?? event.message ?? (ctx as any)?.bodyForAgent,
+        },
+        timestamp: new Date().toISOString(),
+      });
+    });
+
+    api.on("agent_end", (event) => {
+      const ctx = event.ctx as Record<string, unknown> | undefined;
+      void postToAISnitch({
+        event: "command:stop",
+        sessionKey: getSessionKey(ctx),
+        context: ctx ?? {},
+        success: event.success,
+        durationMs: event.durationMs,
+        timestamp: new Date().toISOString(),
+      });
+    });
+
+    // \u2500\u2500 Model calls \u2192 thinking / streaming \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+    api.on("model_call_started", (event) => {
+      const ctx = event.ctx as Record<string, unknown> | undefined;
+      void postToAISnitch({
+        event: "model_call_started",
+        sessionKey: getSessionKey(ctx),
+        cwd: getWorkspaceDir(ctx),
+        context: ctx ?? {},
+        model: event.model,
+        provider: event.provider,
+        timestamp: new Date().toISOString(),
+      });
+    });
+
+    api.on("model_call_ended", (event) => {
+      const ctx = event.ctx as Record<string, unknown> | undefined;
+      void postToAISnitch({
+        event: "model_call_ended",
+        sessionKey: getSessionKey(ctx),
+        cwd: getWorkspaceDir(ctx),
+        context: ctx ?? {},
+        model: event.model,
+        durationMs: event.durationMs,
+        outcome: event.outcome,
+        timestamp: new Date().toISOString(),
+      });
+    });
+
+    // \u2500\u2500 Tool calls \u2014 richest signal for AISnitch \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+    api.on("before_tool_call", (event) => {
+      const ctx = event.ctx as Record<string, unknown> | undefined;
+      void postToAISnitch({
+        event: "before_tool_call",
+        sessionKey: getSessionKey(ctx),
+        cwd: getWorkspaceDir(ctx),
+        context: ctx ?? {},
+        toolName: event.toolName,
+        toolInput: event.params,
+        timestamp: new Date().toISOString(),
+      });
+    });
+
+    api.on("after_tool_call", (event) => {
+      const ctx = event.ctx as Record<string, unknown> | undefined;
+      void postToAISnitch({
+        event: "tool_result_persist",
+        sessionKey: getSessionKey(ctx),
+        cwd: getWorkspaceDir(ctx),
+        context: ctx ?? {},
+        toolName: event.toolName,
+        toolInput: event.params,
+        error: event.error,
+        duration: event.duration,
+        result: event.result,
+        timestamp: new Date().toISOString(),
+      });
+    });
+
+    // \u2500\u2500 Compaction \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+    api.on("before_compaction", (event) => {
+      const ctx = event.ctx as Record<string, unknown> | undefined;
+      void postToAISnitch({
+        event: "before_compaction",
+        sessionKey: getSessionKey(ctx),
+        cwd: getWorkspaceDir(ctx),
+        context: ctx ?? {},
+        timestamp: new Date().toISOString(),
+      });
+    });
+
+    api.on("after_compaction", (event) => {
+      const ctx = event.ctx as Record<string, unknown> | undefined;
+      void postToAISnitch({
+        event: "session:compact:after",
+        sessionKey: getSessionKey(ctx),
+        cwd: getWorkspaceDir(ctx),
+        context: ctx ?? {},
+        timestamp: new Date().toISOString(),
+      });
+    });
+
+    // \u2500\u2500 Messages \u2014 user input context \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+    api.on("message_received", (event) => {
+      const ctx = event.ctx as Record<string, unknown> | undefined;
+      void postToAISnitch({
+        event: "message:received",
+        sessionKey: getSessionKey(ctx),
+        cwd: getWorkspaceDir(ctx),
+        context: ctx ?? {},
+        message: event.message,
+        timestamp: new Date().toISOString(),
+      });
+    });
+  },
+});
+`;
+}
 function parseOpenClawSettings(currentContent) {
   if (currentContent === null || currentContent.trim().length === 0) {
     return {};
@@ -3182,8 +3467,8 @@ function toConfigPathOptions(options) {
 
 // src/cli/runtime.ts
 import { execFile as execFileCallback14, spawn as spawnChildProcess2 } from "child_process";
-import { closeSync, openSync } from "fs";
-import { mkdtemp, readFile as readFile15, rename, rm as rm4, writeFile as writeFile5 } from "fs/promises";
+import { closeSync, constants as fsConstants4, openSync } from "fs";
+import { access as access4, mkdtemp, readFile as readFile15, rename, rm as rm4, writeFile as writeFile5 } from "fs/promises";
 import { createConnection as createConnection3 } from "net";
 import { tmpdir } from "os";
 import { basename as basename12, join as join18 } from "path";
@@ -10725,6 +11010,7 @@ var OpenClawAdapter = class extends BaseAdapter {
   displayName = "OpenClaw";
   name = "openclaw";
   strategies = [
+    "plugin",
     "hooks",
     "log-watch",
     "jsonl-watch",
@@ -10944,11 +11230,32 @@ var OpenClawAdapter = class extends BaseAdapter {
         await this.emitOpenClawSessionEnd(sharedData, context);
         return;
       }
-      case "session:compact:before":
-      case "before_compaction": {
+      case "model_call_started": {
         await this.ensureSessionStarted(sharedData, context);
         this.clearThinking(sessionId);
-        await this.emitStateChange("agent.compact", sharedData, context);
+        await this.emitStateChange("agent.thinking", sharedData, context);
+        return;
+      }
+      case "model_call_ended": {
+        await this.ensureSessionStarted(sharedData, context);
+        await this.emitStateChange("agent.streaming", {
+          ...sharedData,
+          raw: {
+            ...sharedData.raw ?? {},
+            durationMs: getNumber7(payload, "durationMs"),
+            outcome: getString9(payload, "outcome"),
+            source: "plugin"
+          }
+        }, context);
+        return;
+      }
+      case "before_tool_call": {
+        await this.ensureSessionStarted(sharedData, context);
+        await this.emitStateChange(
+          isOpenClawCodingTool(sharedData.toolName, sharedData.toolInput) ? "agent.coding" : "agent.tool_call",
+          sharedData,
+          context
+        );
         return;
       }
       case "tool_result_persist": {
@@ -10961,6 +11268,13 @@ var OpenClawAdapter = class extends BaseAdapter {
         this.scheduleThinking(sessionId, sharedData, context, POST_TOOL_THINKING_DELAY_MS);
         return;
       }
+      case "session:compact:before":
+      case "before_compaction": {
+        await this.ensureSessionStarted(sharedData, context);
+        this.clearThinking(sessionId);
+        await this.emitStateChange("agent.compact", sharedData, context);
+        return;
+      }
       case "message:received":
       case "message:preprocessed":
       case "session:compact:after":
@@ -11420,6 +11734,7 @@ function buildOpenClawEventData(payload) {
   return {
     activeFile: extractOpenClawActiveFile(payload) ?? toolInput?.filePath,
     cwd,
+    duration: getNumber7(payload, "duration") ?? getNumber7(payload, "durationMs"),
     errorMessage: extractOpenClawErrorMessage(payload),
     errorType: inferOpenClawErrorType(payload),
     model: extractOpenClawModel(payload),
@@ -11484,7 +11799,7 @@ function extractOpenClawToolInput(payload) {
   };
 }
 function extractOpenClawErrorMessage(payload) {
-  return getString9(payload, "error") ?? getString9(payload, "message") ?? getString9(getRecord8(payload.error), "message") ?? getString9(getRecord8(payload.result), "error");
+  return getString9(payload, "error") ?? getString9(payload, "errorMessage") ?? getString9(payload, "message") ?? getString9(getRecord8(payload.error), "message") ?? getString9(getRecord8(payload.result), "error") ?? getString9(getRecord8(payload.result), "message");
 }
 function inferOpenClawErrorType(payload) {
   const errorMessage = extractOpenClawErrorMessage(payload);
@@ -15605,6 +15920,20 @@ var DAEMON_READY_POLL_INTERVAL_MS = 100;
 var DAEMON_STOP_TIMEOUT_MS = 4e3;
 var DAEMON_LOG_MAX_BYTES = 5 * 1024 * 1024;
 var LAUNCH_AGENT_LABEL = "com.aisnitch.daemon";
+async function resolveNodeExecutable() {
+  try {
+    await access4(process.execPath, fsConstants4.X_OK);
+    return process.execPath;
+  } catch {
+    return "node";
+  }
+}
+function formatSpawnError(error) {
+  if (error instanceof Error) {
+    return error.message;
+  }
+  return String(error);
+}
 function createCliRuntime(dependencies = {}) {
   const output = dependencies.output ?? createProcessOutput();
   const fetchImplementation = dependencies.fetch ?? globalThis.fetch;
@@ -16104,11 +16433,11 @@ function createCliRuntime(dependencies = {}) {
   }
   async function fullscreen(options) {
     const snapshot = await getStatusSnapshot(options);
-    if (!snapshot.running && options.daemonMode) {
+    if (!snapshot.running && options.daemon) {
       output.stdout("Starting daemon...\n");
       await startDetachedDaemon(options);
     }
-    if (!snapshot.running && !options.daemonMode) {
+    if (!snapshot.running && !options.daemon) {
       throw new Error(
         "AISnitch daemon is not running. Start one with `aisnitch start --daemon` or use `aisnitch fs --daemon` to start and open the dashboard."
       );
@@ -16123,7 +16452,8 @@ function createCliRuntime(dependencies = {}) {
     const distPath = join18(process.cwd(), "examples", "fullscreen-dashboard", "dist");
     output.stdout(`Starting dashboard server on port ${dashboardPort}...
 `);
-    const viteProcess = spawnImplementation(process.execPath, [
+    const nodeExecutable = await resolveNodeExecutable();
+    const viteProcess = spawnImplementation(nodeExecutable, [
       "-e",
       `
 import { createServer } from 'vite';
@@ -16155,6 +16485,12 @@ process.stdin.resume();
       stdio: ["pipe", "pipe", "pipe"]
     });
     let serverOutput = "";
+    let serverSpawnError;
+    viteProcess.on("error", (error) => {
+      serverSpawnError = error;
+      serverOutput += `Dashboard server process failed: ${formatSpawnError(error)}
+`;
+    });
     viteProcess.stdout?.on("data", (data) => {
       serverOutput += data.toString();
     });
@@ -16172,11 +16508,19 @@ process.stdin.resume();
         }
       } catch {
       }
+      if (serverSpawnError !== void 0) {
+        break;
+      }
       if (!viteProcess.pid) break;
     }
     if (!serverReady) {
       output.stdout(`Server output: ${serverOutput}
 `);
+      if (serverSpawnError !== void 0) {
+        throw new Error(
+          `Failed to start dashboard server process with ${nodeExecutable}: ${formatSpawnError(serverSpawnError)}`
+        );
+      }
       throw new Error("Failed to start dashboard server");
     }
     output.stdout(`Dashboard ready at ${dashboardUrl}