@clawnitor/plugin 1.0.0

package/README.md

@@ -0,0 +1,60 @@
+# @clawnitor/plugin
+
+OpenClaw plugin for Clawnitor — agent monitoring, alerting, and kill switch.
+
+## Installation
+
+```bash
+openclaw plugins install @clawnitor/plugin
+```
+
+## Configuration
+
+Add to your `openclaw.json`:
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "clawnitor": {
+        "config": {
+          "apiKey": "clw_live_your_key_here"
+        }
+      }
+    }
+  }
+}
+```
+
+### Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `apiKey` | required | Your Clawnitor API key |
+| `backendUrl` | `https://api.clawnitor.io` | Backend URL |
+| `spendLimit` | `100` | Max spend per session ($) before auto-pause |
+| `rateLimit` | `120` | Max tool calls per minute before auto-pause |
+| `toolBlocklist` | `[]` | Tool names to always block |
+| `redactionPatterns` | `[]` | Additional regex patterns for secret redaction |
+
+## What it monitors
+
+- Tool calls (before and after execution)
+- LLM requests (input/output, token usage, cost)
+- Messages (sending, sent, received)
+- Session lifecycle (start, end, agent completion)
+- Sub-agent spawning and completion
+
+## Safety features
+
+- **Kill switch** — blocks tool calls and messages when agent is paused (server or local)
+- **Spend circuit breaker** — auto-pauses at configurable spend limit
+- **Rate limiter** — auto-pauses at configurable tool call rate
+- **Tool blocklist** — prevents specific tools from ever executing
+- **Secret redaction** — strips API keys, passwords, tokens from logged data
+
+## Privacy
+
+Event data streams to the Clawnitor backend for monitoring. Sensitive data (API keys, passwords, tokens) is automatically redacted before transmission. Data sharing for aggregate pattern improvement is opt-in (default OFF).
+
+Learn more at https://clawnitor.io

package/dist/config.d.ts

@@ -0,0 +1,10 @@
+export interface PluginConfig {
+    apiKey: string;
+    backendUrl: string;
+    spendLimit: number;
+    rateLimit: number;
+    toolBlocklist: string[];
+    redactionPatterns: string[];
+}
+export declare function parseConfig(raw: Record<string, unknown>): PluginConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CActE"}

package/dist/config.js

@@ -0,0 +1,16 @@
+import { DEFAULT_SPEND_LIMIT, DEFAULT_RATE_LIMIT, } from "@clawnitor/shared";
+export function parseConfig(raw) {
+    const apiKey = raw.apiKey;
+    if (!apiKey) {
+        throw new Error("Clawnitor: apiKey is required. Sign up at https://clawnitor.io");
+    }
+    return {
+        apiKey,
+        backendUrl: raw.backendUrl || "https://api.clawnitor.io",
+        spendLimit: raw.spendLimit ?? DEFAULT_SPEND_LIMIT,
+        rateLimit: raw.rateLimit ?? DEFAULT_RATE_LIMIT,
+        toolBlocklist: raw.toolBlocklist ?? [],
+        redactionPatterns: raw.redactionPatterns ?? [],
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAW3B,MAAM,UAAU,WAAW,CAAC,GAA4B;IACtD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAgB,CAAC;IACpC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IAED,OAAO;QACL,MAAM;QACN,UAAU,EAAG,GAAG,CAAC,UAAqB,IAAI,0BAA0B;QACpE,UAAU,EAAG,GAAG,CAAC,UAAqB,IAAI,mBAAmB;QAC7D,SAAS,EAAG,GAAG,CAAC,SAAoB,IAAI,kBAAkB;QAC1D,aAAa,EAAG,GAAG,CAAC,aAA0B,IAAI,EAAE;QACpD,iBAAiB,EAAG,GAAG,CAAC,iBAA8B,IAAI,EAAE;KAC7D,CAAC;AACJ,CAAC"}

package/dist/event-builder.d.ts

@@ -0,0 +1,15 @@
+import { type ClawnitorEvent, type EventType } from "@clawnitor/shared";
+import { type RateTracker } from "./severity.js";
+interface BuildEventParams {
+    agentId: string;
+    sessionId: string;
+    eventType: EventType;
+    action: string;
+    target: string;
+    metadata?: Record<string, unknown>;
+    rateTracker?: RateTracker;
+    customRedactionPatterns?: string[];
+}
+export declare function buildEvent(params: BuildEventParams): ClawnitorEvent;
+export {};
+//# sourceMappingURL=event-builder.d.ts.map

package/dist/event-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-builder.d.ts","sourceRoot":"","sources":["../src/event-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,KAAK,SAAS,EAAqB,MAAM,mBAAmB,CAAC;AAC1G,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAKjE,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;CACpC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,CA6CnE"}

package/dist/event-builder.js

@@ -0,0 +1,34 @@
+import { createEventId } from "@clawnitor/shared";
+import { assignSeverity } from "./severity.js";
+import { redact, DEFAULT_PATTERNS } from "./redaction.js";
+const PLUGIN_VERSION = "0.0.1";
+export function buildEvent(params) {
+    const { agentId, sessionId, eventType, action, target, metadata = {}, rateTracker, customRedactionPatterns = [], } = params;
+    // Redact sensitive data from raw_snippet
+    const patterns = [...DEFAULT_PATTERNS, ...customRedactionPatterns];
+    const cleaned = { ...metadata };
+    if (typeof cleaned.raw_snippet === "string") {
+        cleaned.raw_snippet = redact(cleaned.raw_snippet, patterns);
+        // Truncate to 500 chars
+        if (cleaned.raw_snippet.length > 500) {
+            cleaned.raw_snippet = cleaned.raw_snippet.slice(0, 500);
+        }
+    }
+    const severity = assignSeverity(eventType, cleaned, rateTracker);
+    // Redact action and target fields too
+    const redactedAction = redact(action, patterns);
+    const redactedTarget = redact(target, patterns);
+    return {
+        agent_id: agentId,
+        session_id: sessionId,
+        timestamp: new Date().toISOString(),
+        event_type: eventType,
+        action: redactedAction,
+        target: redactedTarget,
+        metadata: cleaned,
+        severity_hint: severity,
+        event_id: createEventId(),
+        plugin_version: PLUGIN_VERSION,
+    };
+}
+//# sourceMappingURL=event-builder.js.map

package/dist/event-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-builder.js","sourceRoot":"","sources":["../src/event-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA0D,MAAM,mBAAmB,CAAC;AAC1G,OAAO,EAAE,cAAc,EAAoB,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,cAAc,GAAG,OAAO,CAAC;AAa/B,MAAM,UAAU,UAAU,CAAC,MAAwB;IACjD,MAAM,EACJ,OAAO,EACP,SAAS,EACT,SAAS,EACT,MAAM,EACN,MAAM,EACN,QAAQ,GAAG,EAAE,EACb,WAAW,EACX,uBAAuB,GAAG,EAAE,GAC7B,GAAG,MAAM,CAAC;IAEX,yCAAyC;IACzC,MAAM,QAAQ,GAAG,CAAC,GAAG,gBAAgB,EAAE,GAAG,uBAAuB,CAAC,CAAC;IACnE,MAAM,OAAO,GAA4B,EAAE,GAAG,QAAQ,EAAE,CAAC;IACzD,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC5D,wBAAwB;QACxB,IAAK,OAAO,CAAC,WAAsB,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACjD,OAAO,CAAC,WAAW,GAAI,OAAO,CAAC,WAAsB,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,cAAc,CAC7B,SAAS,EACT,OAAO,EACP,WAAW,CACZ,CAAC;IAEF,sCAAsC;IACtC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChD,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEhD,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,UAAU,EAAE,SAAS;QACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,UAAU,EAAE,SAAS;QACrB,MAAM,EAAE,cAAc;QACtB,MAAM,EAAE,cAAc;QACtB,QAAQ,EAAE,OAAc;QACxB,aAAa,EAAE,QAAQ;QACvB,QAAQ,EAAE,aAAa,EAAE;QACzB,cAAc,EAAE,cAAc;KAC/B,CAAC;AACJ,CAAC"}

package/dist/hooks/lifecycle.d.ts

@@ -0,0 +1,18 @@
+import type { HttpsSender } from "../transport/https-sender.js";
+interface LifecycleContext {
+    agentId: string;
+    sessionId: string;
+    sender: HttpsSender;
+    redactionPatterns: string[];
+    onSessionStart?: (sessionId: string) => void;
+    onSessionEnd?: (sessionId: string) => void;
+}
+export declare function createSessionStartHandler(ctx: LifecycleContext): (event: any) => void;
+export declare function createSessionEndHandler(ctx: LifecycleContext): (event: any) => void;
+export declare function createAgentEndHandler(ctx: LifecycleContext): (event: any) => void;
+export declare function createSubagentHandlers(ctx: LifecycleContext): {
+    spawning: (event: any) => void;
+    ended: (event: any) => void;
+};
+export {};
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/hooks/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/hooks/lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,gBAAgB,IACrD,OAAO,GAAG,UAenB;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,gBAAgB,IACnD,OAAO,GAAG,UAiBnB;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,gBAAgB,IACjD,OAAO,GAAG,UAgBnB;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,gBAAgB;sBAEtC,GAAG;mBAYN,GAAG;EAarB"}

package/dist/hooks/lifecycle.js

@@ -0,0 +1,79 @@
+import { buildEvent } from "../event-builder.js";
+export function createSessionStartHandler(ctx) {
+    return (event) => {
+        ctx.onSessionStart?.(event.sessionId || ctx.sessionId);
+        const clawnitorEvent = buildEvent({
+            agentId: ctx.agentId,
+            sessionId: event.sessionId || ctx.sessionId,
+            eventType: "agent_lifecycle",
+            action: "session started",
+            target: "session",
+            metadata: {},
+            customRedactionPatterns: ctx.redactionPatterns,
+        });
+        ctx.sender.enqueue(clawnitorEvent);
+    };
+}
+export function createSessionEndHandler(ctx) {
+    return (event) => {
+        ctx.onSessionEnd?.(event.sessionId || ctx.sessionId);
+        const clawnitorEvent = buildEvent({
+            agentId: ctx.agentId,
+            sessionId: event.sessionId || ctx.sessionId,
+            eventType: "agent_lifecycle",
+            action: "session ended",
+            target: "session",
+            metadata: {
+                duration_ms: event.duration,
+            },
+            customRedactionPatterns: ctx.redactionPatterns,
+        });
+        ctx.sender.enqueue(clawnitorEvent);
+    };
+}
+export function createAgentEndHandler(ctx) {
+    return (event) => {
+        const clawnitorEvent = buildEvent({
+            agentId: ctx.agentId,
+            sessionId: ctx.sessionId,
+            eventType: "agent_lifecycle",
+            action: event.error ? "agent ended with error" : "agent ended",
+            target: "agent",
+            metadata: {
+                duration_ms: event.duration,
+                error: event.error?.message,
+            },
+            customRedactionPatterns: ctx.redactionPatterns,
+        });
+        ctx.sender.enqueue(clawnitorEvent);
+    };
+}
+export function createSubagentHandlers(ctx) {
+    return {
+        spawning: (event) => {
+            const clawnitorEvent = buildEvent({
+                agentId: ctx.agentId,
+                sessionId: ctx.sessionId,
+                eventType: "subagent",
+                action: "subagent spawning",
+                target: event.subagentId || "unknown",
+                metadata: {},
+                customRedactionPatterns: ctx.redactionPatterns,
+            });
+            ctx.sender.enqueue(clawnitorEvent);
+        },
+        ended: (event) => {
+            const clawnitorEvent = buildEvent({
+                agentId: ctx.agentId,
+                sessionId: ctx.sessionId,
+                eventType: "subagent",
+                action: "subagent ended",
+                target: event.subagentId || "unknown",
+                metadata: { duration_ms: event.duration },
+                customRedactionPatterns: ctx.redactionPatterns,
+            });
+            ctx.sender.enqueue(clawnitorEvent);
+        },
+    };
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/hooks/lifecycle.js.map

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

package/dist/hooks/llm.d.ts

@@ -0,0 +1,11 @@
+import type { HttpsSender } from "../transport/https-sender.js";
+interface LlmContext {
+    agentId: string;
+    sessionId: string;
+    sender: HttpsSender;
+    redactionPatterns: string[];
+}
+export declare function createLlmInputHandler(ctx: LlmContext): (event: any) => void;
+export declare function createLlmOutputHandler(ctx: LlmContext): (event: any) => void;
+export {};
+//# sourceMappingURL=llm.d.ts.map

package/dist/hooks/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/hooks/llm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,UAAU,IAC3C,OAAO,GAAG,UAenB;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,UAAU,IAC5C,OAAO,GAAG,UAgBnB"}

package/dist/hooks/llm.js

@@ -0,0 +1,35 @@
+import { buildEvent } from "../event-builder.js";
+export function createLlmInputHandler(ctx) {
+    return (event) => {
+        const clawnitorEvent = buildEvent({
+            agentId: ctx.agentId,
+            sessionId: ctx.sessionId,
+            eventType: "llm_call",
+            action: `llm_input: ${event.model || "unknown"}`,
+            target: event.provider || "unknown",
+            metadata: {
+                tool_name: event.model,
+            },
+            customRedactionPatterns: ctx.redactionPatterns,
+        });
+        ctx.sender.enqueue(clawnitorEvent);
+    };
+}
+export function createLlmOutputHandler(ctx) {
+    return (event) => {
+        const clawnitorEvent = buildEvent({
+            agentId: ctx.agentId,
+            sessionId: ctx.sessionId,
+            eventType: "llm_call",
+            action: `llm_output: ${event.model || "unknown"}`,
+            target: event.provider || "unknown",
+            metadata: {
+                tokens_used: event.usage?.totalTokens,
+                cost_usd: event.usage?.cost,
+            },
+            customRedactionPatterns: ctx.redactionPatterns,
+        });
+        ctx.sender.enqueue(clawnitorEvent);
+    };
+}
+//# sourceMappingURL=llm.js.map

package/dist/hooks/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../../src/hooks/llm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAUjD,MAAM,UAAU,qBAAqB,CAAC,GAAe;IACnD,OAAO,CAAC,KAAU,EAAE,EAAE;QACpB,MAAM,cAAc,GAAG,UAAU,CAAC;YAChC,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,SAAS,EAAE,UAAU;YACrB,MAAM,EAAE,cAAc,KAAK,CAAC,KAAK,IAAI,SAAS,EAAE;YAChD,MAAM,EAAE,KAAK,CAAC,QAAQ,IAAI,SAAS;YACnC,QAAQ,EAAE;gBACR,SAAS,EAAE,KAAK,CAAC,KAAK;aACvB;YACD,uBAAuB,EAAE,GAAG,CAAC,iBAAiB;SAC/C,CAAC,CAAC;QAEH,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACrC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAe;IACpD,OAAO,CAAC,KAAU,EAAE,EAAE;QACpB,MAAM,cAAc,GAAG,UAAU,CAAC;YAChC,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,SAAS,EAAE,UAAU;YACrB,MAAM,EAAE,eAAe,KAAK,CAAC,KAAK,IAAI,SAAS,EAAE;YACjD,MAAM,EAAE,KAAK,CAAC,QAAQ,IAAI,SAAS;YACnC,QAAQ,EAAE;gBACR,WAAW,EAAE,KAAK,CAAC,KAAK,EAAE,WAAW;gBACrC,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI;aAC5B;YACD,uBAAuB,EAAE,GAAG,CAAC,iBAAiB;SAC/C,CAAC,CAAC;QAEH,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACrC,CAAC,CAAC;AACJ,CAAC"}

package/dist/hooks/message.d.ts

@@ -0,0 +1,14 @@
+import type { HttpsSender } from "../transport/https-sender.js";
+interface MessageContext {
+    agentId: string;
+    sessionId: string;
+    sender: HttpsSender;
+    redactionPatterns: string[];
+}
+export declare function createMessageSendingHandler(ctx: MessageContext): (event: any) => {
+    cancel: boolean;
+} | undefined;
+export declare function createMessageSentHandler(ctx: MessageContext): (event: any) => void;
+export declare function createMessageReceivedHandler(ctx: MessageContext): (event: any) => void;
+export {};
+//# sourceMappingURL=message.d.ts.map

package/dist/hooks/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/hooks/message.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAGhE,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,cAAc,IACrD,OAAO,GAAG;;cAsBnB;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,cAAc,IAClD,OAAO,GAAG,UAanB;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,cAAc,IACtD,OAAO,GAAG,UAanB"}

package/dist/hooks/message.js

@@ -0,0 +1,52 @@
+import { buildEvent } from "../event-builder.js";
+import { killState } from "../kill-switch/kill-state.js";
+export function createMessageSendingHandler(ctx) {
+    return (event) => {
+        const clawnitorEvent = buildEvent({
+            agentId: ctx.agentId,
+            sessionId: ctx.sessionId,
+            eventType: "message_sent",
+            action: `sending message`,
+            target: event.channel || "unknown",
+            metadata: {
+                raw_snippet: event.text ? String(event.text).slice(0, 500) : undefined,
+            },
+            customRedactionPatterns: ctx.redactionPatterns,
+        });
+        ctx.sender.enqueue(clawnitorEvent);
+        // Block outbound messages when killed
+        if (killState.isKilled()) {
+            return { cancel: true };
+        }
+        return undefined;
+    };
+}
+export function createMessageSentHandler(ctx) {
+    return (event) => {
+        const clawnitorEvent = buildEvent({
+            agentId: ctx.agentId,
+            sessionId: ctx.sessionId,
+            eventType: "message_sent",
+            action: `message sent`,
+            target: event.channel || "unknown",
+            metadata: {},
+            customRedactionPatterns: ctx.redactionPatterns,
+        });
+        ctx.sender.enqueue(clawnitorEvent);
+    };
+}
+export function createMessageReceivedHandler(ctx) {
+    return (event) => {
+        const clawnitorEvent = buildEvent({
+            agentId: ctx.agentId,
+            sessionId: ctx.sessionId,
+            eventType: "message_received",
+            action: `message received`,
+            target: event.channel || "unknown",
+            metadata: {},
+            customRedactionPatterns: ctx.redactionPatterns,
+        });
+        ctx.sender.enqueue(clawnitorEvent);
+    };
+}
+//# sourceMappingURL=message.js.map

package/dist/hooks/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../src/hooks/message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AASzD,MAAM,UAAU,2BAA2B,CAAC,GAAmB;IAC7D,OAAO,CAAC,KAAU,EAAE,EAAE;QACpB,MAAM,cAAc,GAAG,UAAU,CAAC;YAChC,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,SAAS,EAAE,cAAc;YACzB,MAAM,EAAE,iBAAiB;YACzB,MAAM,EAAE,KAAK,CAAC,OAAO,IAAI,SAAS;YAClC,QAAQ,EAAE;gBACR,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;aACvE;YACD,uBAAuB,EAAE,GAAG,CAAC,iBAAiB;SAC/C,CAAC,CAAC;QAEH,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAEnC,sCAAsC;QACtC,IAAI,SAAS,CAAC,QAAQ,EAAE,EAAE,CAAC;YACzB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,GAAmB;IAC1D,OAAO,CAAC,KAAU,EAAE,EAAE;QACpB,MAAM,cAAc,GAAG,UAAU,CAAC;YAChC,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,SAAS,EAAE,cAAc;YACzB,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,KAAK,CAAC,OAAO,IAAI,SAAS;YAClC,QAAQ,EAAE,EAAE;YACZ,uBAAuB,EAAE,GAAG,CAAC,iBAAiB;SAC/C,CAAC,CAAC;QAEH,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACrC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,GAAmB;IAC9D,OAAO,CAAC,KAAU,EAAE,EAAE;QACpB,MAAM,cAAc,GAAG,UAAU,CAAC;YAChC,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,SAAS,EAAE,kBAAkB;YAC7B,MAAM,EAAE,kBAAkB;YAC1B,MAAM,EAAE,KAAK,CAAC,OAAO,IAAI,SAAS;YAClC,QAAQ,EAAE,EAAE;YACZ,uBAAuB,EAAE,GAAG,CAAC,iBAAiB;SAC/C,CAAC,CAAC;QAEH,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACrC,CAAC,CAAC;AACJ,CAAC"}

package/dist/hooks/tool-call.d.ts

@@ -0,0 +1,20 @@
+import type { HttpsSender } from "../transport/https-sender.js";
+import type { RateTracker } from "../severity.js";
+import type { LocalFailsafe } from "../kill-switch/local-failsafe.js";
+import type { RuleCache } from "../rule-cache.js";
+interface ToolCallContext {
+    agentId: string;
+    sessionId: string;
+    sender: HttpsSender;
+    rateTracker: RateTracker;
+    redactionPatterns: string[];
+    failsafe: LocalFailsafe;
+    ruleCache: RuleCache;
+}
+export declare function createBeforeToolCallHandler(ctx: ToolCallContext): (event: any) => {
+    block: boolean;
+    blockReason: string | undefined;
+} | undefined;
+export declare function createAfterToolCallHandler(ctx: ToolCallContext): (event: any) => void;
+export {};
+//# sourceMappingURL=tool-call.d.ts.map

package/dist/hooks/tool-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call.d.ts","sourceRoot":"","sources":["../../src/hooks/tool-call.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,EAAE,aAAa,CAAC;IACxB,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,eAAe,IACtD,OAAO,GAAG;;;cA+DnB;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,eAAe,IACrD,OAAO,GAAG,UA+BnB"}

package/dist/hooks/tool-call.js

@@ -0,0 +1,89 @@
+import { buildEvent } from "../event-builder.js";
+import { killState } from "../kill-switch/kill-state.js";
+export function createBeforeToolCallHandler(ctx) {
+    return (event) => {
+        ctx.rateTracker.record();
+        ctx.failsafe.recordToolCall();
+        // Record event in rule cache for time-window based rules
+        ctx.ruleCache.recordEvent({
+            timestamp: Date.now(),
+            toolName: event.toolName,
+            eventType: "tool_use",
+            costUsd: event.cost,
+            action: event.toolName,
+            target: event.toolName,
+        });
+        const clawnitorEvent = buildEvent({
+            agentId: ctx.agentId,
+            sessionId: ctx.sessionId,
+            eventType: "tool_use",
+            action: `before: ${event.toolName || "unknown"}`,
+            target: event.toolName || "unknown",
+            metadata: {
+                tool_name: event.toolName,
+                ...(event.params ? { raw_snippet: JSON.stringify(event.params).slice(0, 500) } : {}),
+            },
+            rateTracker: ctx.rateTracker,
+            customRedactionPatterns: ctx.redactionPatterns,
+        });
+        ctx.sender.enqueue(clawnitorEvent);
+        // 1. Check kill state (server-triggered)
+        if (killState.isKilled()) {
+            return {
+                block: true,
+                blockReason: `Clawnitor: agent paused — ${killState.getReason() || "unknown reason"}`,
+            };
+        }
+        // 2. Check local failsafe (spend/rate/blocklist)
+        const failsafeResult = ctx.failsafe.check(event.toolName || "");
+        if (failsafeResult.block) {
+            killState.setKilled(failsafeResult.reason);
+            return {
+                block: true,
+                blockReason: failsafeResult.reason,
+            };
+        }
+        // 3. Check cached server rules locally (PRE-ACTION for pattern rules)
+        const ruleResult = ctx.ruleCache.checkBeforeToolCall(event.toolName || "", event.params);
+        if (ruleResult.blocked) {
+            killState.setKilled(ruleResult.reason || "Rule triggered");
+            return {
+                block: true,
+                blockReason: ruleResult.reason,
+            };
+        }
+        return undefined;
+    };
+}
+export function createAfterToolCallHandler(ctx) {
+    return (event) => {
+        // Track spend for failsafe and rule cache
+        if (typeof event.cost === "number") {
+            ctx.failsafe.addSpend(event.cost);
+            ctx.ruleCache.recordEvent({
+                timestamp: Date.now(),
+                toolName: event.toolName,
+                eventType: "tool_use",
+                costUsd: event.cost,
+            });
+        }
+        const clawnitorEvent = buildEvent({
+            agentId: ctx.agentId,
+            sessionId: ctx.sessionId,
+            eventType: "tool_use",
+            action: `after: ${event.toolName || "unknown"}`,
+            target: event.toolName || "unknown",
+            metadata: {
+                tool_name: event.toolName,
+                duration_ms: event.duration,
+                error: event.error?.message,
+                cost_usd: event.cost,
+                raw_snippet: event.result ? String(event.result).slice(0, 500) : undefined,
+            },
+            rateTracker: ctx.rateTracker,
+            customRedactionPatterns: ctx.redactionPatterns,
+        });
+        ctx.sender.enqueue(clawnitorEvent);
+    };
+}
+//# sourceMappingURL=tool-call.js.map

package/dist/hooks/tool-call.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export default function register(api: any): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAyBA,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,QA0GxC"}

package/dist/index.js

@@ -0,0 +1,105 @@
+import { parseConfig } from "./config.js";
+import { HttpsSender } from "./transport/https-sender.js";
+import { SqliteCache } from "./transport/sqlite-cache.js";
+import { WebSocketClient } from "./transport/websocket-client.js";
+import { createRateTracker } from "./severity.js";
+import { killState } from "./kill-switch/kill-state.js";
+import { LocalFailsafe } from "./kill-switch/local-failsafe.js";
+import { RuleCache } from "./rule-cache.js";
+import { createBeforeToolCallHandler, createAfterToolCallHandler, } from "./hooks/tool-call.js";
+import { createLlmInputHandler, createLlmOutputHandler } from "./hooks/llm.js";
+import { createMessageSendingHandler, createMessageSentHandler, createMessageReceivedHandler, } from "./hooks/message.js";
+import { createSessionStartHandler, createSessionEndHandler, createAgentEndHandler, createSubagentHandlers, } from "./hooks/lifecycle.js";
+export default function register(api) {
+    const rawConfig = api.config || {};
+    const config = parseConfig(rawConfig);
+    const rateTracker = createRateTracker();
+    const failsafe = new LocalFailsafe(config);
+    const ruleCache = new RuleCache(config);
+    // Initialize SQLite cache for offline resilience
+    const cache = new SqliteCache();
+    // Initialize HTTPS sender
+    const sender = new HttpsSender(config, {
+        onKillState: (killed, reason) => {
+            // HTTPS fallback for kill state
+            if (killed && !killState.isKilled()) {
+                killState.setKilled(reason || "Killed by server (HTTPS fallback)");
+            }
+            else if (!killed && killState.isKilled()) {
+                killState.clearKilled();
+            }
+        },
+        onFlushFail: (events) => {
+            cache.cache(events);
+        },
+    });
+    sender.start();
+    // Initialize WebSocket client for real-time kill signals
+    const wsClient = new WebSocketClient(config, {
+        onKill: (reason, ruleId) => {
+            killState.setKilled(reason);
+        },
+        onUnkill: () => {
+            killState.clearKilled();
+        },
+    });
+    wsClient.start();
+    ruleCache.start();
+    // Periodically flush cached events
+    const cacheFlushInterval = setInterval(() => {
+        const cached = cache.flush(50);
+        if (cached.length > 0) {
+            for (const event of cached) {
+                sender.enqueue(event);
+            }
+        }
+    }, 30_000);
+    // Shared context for all hooks
+    let currentSessionId = "default";
+    const agentId = rawConfig.agentId || "unknown";
+    const ctx = {
+        get agentId() {
+            return agentId;
+        },
+        get sessionId() {
+            return currentSessionId;
+        },
+        sender,
+        rateTracker,
+        redactionPatterns: config.redactionPatterns,
+        failsafe,
+        ruleCache,
+    };
+    // Register hooks
+    api.on("before_tool_call", createBeforeToolCallHandler(ctx), {
+        priority: 10,
+    });
+    api.on("after_tool_call", createAfterToolCallHandler(ctx), { priority: 10 });
+    api.on("llm_input", createLlmInputHandler(ctx), { priority: 10 });
+    api.on("llm_output", createLlmOutputHandler(ctx), { priority: 10 });
+    api.on("message_sending", createMessageSendingHandler(ctx), {
+        priority: 10,
+    });
+    api.on("message_sent", createMessageSentHandler(ctx), { priority: 10 });
+    api.on("message_received", createMessageReceivedHandler(ctx), {
+        priority: 10,
+    });
+    api.on("session_start", createSessionStartHandler({
+        ...ctx,
+        onSessionStart: (sid) => {
+            currentSessionId = sid;
+            failsafe.resetSession();
+        },
+    }), { priority: 10 });
+    api.on("session_end", createSessionEndHandler({
+        ...ctx,
+        onSessionEnd: () => {
+            currentSessionId = "default";
+        },
+    }), { priority: 10 });
+    api.on("agent_end", createAgentEndHandler(ctx), { priority: 10 });
+    const subagent = createSubagentHandlers(ctx);
+    api.on("subagent_spawning", subagent.spawning, { priority: 10 });
+    api.on("subagent_ended", subagent.ended, { priority: 10 });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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