@clawnitor/plugin 1.0.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 (62) hide show
  1. package/README.md +60 -0
  2. package/dist/config.d.ts +10 -0
  3. package/dist/config.d.ts.map +1 -0
  4. package/dist/config.js +16 -0
  5. package/dist/config.js.map +1 -0
  6. package/dist/event-builder.d.ts +15 -0
  7. package/dist/event-builder.d.ts.map +1 -0
  8. package/dist/event-builder.js +34 -0
  9. package/dist/event-builder.js.map +1 -0
  10. package/dist/hooks/lifecycle.d.ts +18 -0
  11. package/dist/hooks/lifecycle.d.ts.map +1 -0
  12. package/dist/hooks/lifecycle.js +79 -0
  13. package/dist/hooks/lifecycle.js.map +1 -0
  14. package/dist/hooks/llm.d.ts +11 -0
  15. package/dist/hooks/llm.d.ts.map +1 -0
  16. package/dist/hooks/llm.js +35 -0
  17. package/dist/hooks/llm.js.map +1 -0
  18. package/dist/hooks/message.d.ts +14 -0
  19. package/dist/hooks/message.d.ts.map +1 -0
  20. package/dist/hooks/message.js +52 -0
  21. package/dist/hooks/message.js.map +1 -0
  22. package/dist/hooks/tool-call.d.ts +20 -0
  23. package/dist/hooks/tool-call.d.ts.map +1 -0
  24. package/dist/hooks/tool-call.js +89 -0
  25. package/dist/hooks/tool-call.js.map +1 -0
  26. package/dist/index.d.ts +2 -0
  27. package/dist/index.d.ts.map +1 -0
  28. package/dist/index.js +105 -0
  29. package/dist/index.js.map +1 -0
  30. package/dist/kill-switch/kill-state.d.ts +16 -0
  31. package/dist/kill-switch/kill-state.d.ts.map +1 -0
  32. package/dist/kill-switch/kill-state.js +25 -0
  33. package/dist/kill-switch/kill-state.js.map +1 -0
  34. package/dist/kill-switch/local-failsafe.d.ts +19 -0
  35. package/dist/kill-switch/local-failsafe.d.ts.map +1 -0
  36. package/dist/kill-switch/local-failsafe.js +64 -0
  37. package/dist/kill-switch/local-failsafe.js.map +1 -0
  38. package/dist/redaction.d.ts +3 -0
  39. package/dist/redaction.d.ts.map +1 -0
  40. package/dist/redaction.js +46 -0
  41. package/dist/redaction.js.map +1 -0
  42. package/dist/rule-cache.d.ts +42 -0
  43. package/dist/rule-cache.d.ts.map +1 -0
  44. package/dist/rule-cache.js +138 -0
  45. package/dist/rule-cache.js.map +1 -0
  46. package/dist/severity.d.ts +8 -0
  47. package/dist/severity.d.ts.map +1 -0
  48. package/dist/severity.js +38 -0
  49. package/dist/severity.js.map +1 -0
  50. package/dist/transport/https-sender.d.ts +18 -0
  51. package/dist/transport/https-sender.d.ts.map +1 -0
  52. package/dist/transport/https-sender.js +62 -0
  53. package/dist/transport/https-sender.js.map +1 -0
  54. package/dist/transport/sqlite-cache.d.ts +12 -0
  55. package/dist/transport/sqlite-cache.d.ts.map +1 -0
  56. package/dist/transport/sqlite-cache.js +74 -0
  57. package/dist/transport/sqlite-cache.js.map +1 -0
  58. package/dist/transport/websocket-client.d.ts +19 -0
  59. package/dist/transport/websocket-client.d.ts.map +1 -0
  60. package/dist/transport/websocket-client.js +79 -0
  61. package/dist/transport/websocket-client.js.map +1 -0
  62. package/package.json +51 -0
@@ -0,0 +1,19 @@
1
+ import type { PluginConfig } from "../config.js";
2
+ export declare class WebSocketClient {
3
+ private ws;
4
+ private config;
5
+ private reconnectAttempt;
6
+ private reconnectTimer;
7
+ private stopped;
8
+ private onKill?;
9
+ private onUnkill?;
10
+ constructor(config: PluginConfig, opts: {
11
+ onKill?: (reason: string, ruleId?: string) => void;
12
+ onUnkill?: () => void;
13
+ });
14
+ start(): void;
15
+ stop(): void;
16
+ private connect;
17
+ private scheduleReconnect;
18
+ }
19
+ //# sourceMappingURL=websocket-client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"websocket-client.d.ts","sourceRoot":"","sources":["../../src/transport/websocket-client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAC,CAA4C;IAC3D,OAAO,CAAC,QAAQ,CAAC,CAAa;gBAG5B,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE;QACJ,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QACnD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;KACvB;IAOH,KAAK;IAKL,IAAI;IAYJ,OAAO,CAAC,OAAO;IA0Cf,OAAO,CAAC,iBAAiB;CAa1B"}
@@ -0,0 +1,79 @@
1
+ import { WS_RECONNECT_BASE_MS, WS_RECONNECT_MAX_MS, } from "@clawnitor/shared";
2
+ export class WebSocketClient {
3
+ ws = null;
4
+ config;
5
+ reconnectAttempt = 0;
6
+ reconnectTimer = null;
7
+ stopped = false;
8
+ onKill;
9
+ onUnkill;
10
+ constructor(config, opts) {
11
+ this.config = config;
12
+ this.onKill = opts.onKill;
13
+ this.onUnkill = opts.onUnkill;
14
+ }
15
+ start() {
16
+ this.stopped = false;
17
+ this.connect();
18
+ }
19
+ stop() {
20
+ this.stopped = true;
21
+ if (this.reconnectTimer) {
22
+ clearTimeout(this.reconnectTimer);
23
+ this.reconnectTimer = null;
24
+ }
25
+ if (this.ws) {
26
+ this.ws.close();
27
+ this.ws = null;
28
+ }
29
+ }
30
+ connect() {
31
+ if (this.stopped)
32
+ return;
33
+ const wsUrl = this.config.backendUrl
34
+ .replace("https://", "wss://")
35
+ .replace("http://", "ws://");
36
+ try {
37
+ this.ws = new WebSocket(`${wsUrl}/ws`);
38
+ this.ws.onopen = () => {
39
+ this.reconnectAttempt = 0;
40
+ // Authenticate via first message (not URL params)
41
+ this.ws?.send(JSON.stringify({ apiKey: this.config.apiKey }));
42
+ };
43
+ this.ws.onmessage = (event) => {
44
+ try {
45
+ const msg = JSON.parse(String(event.data));
46
+ if (msg.type === "kill") {
47
+ this.onKill?.(msg.reason, msg.rule_id);
48
+ }
49
+ else if (msg.type === "unkill") {
50
+ this.onUnkill?.();
51
+ }
52
+ }
53
+ catch {
54
+ // Ignore unparseable messages
55
+ }
56
+ };
57
+ this.ws.onclose = () => {
58
+ this.ws = null;
59
+ this.scheduleReconnect();
60
+ };
61
+ this.ws.onerror = () => {
62
+ // onclose will fire after onerror
63
+ };
64
+ }
65
+ catch {
66
+ this.scheduleReconnect();
67
+ }
68
+ }
69
+ scheduleReconnect() {
70
+ if (this.stopped)
71
+ return;
72
+ const delay = Math.min(WS_RECONNECT_BASE_MS * Math.pow(2, this.reconnectAttempt), WS_RECONNECT_MAX_MS);
73
+ // Add jitter (±25%)
74
+ const jitter = delay * (0.75 + Math.random() * 0.5);
75
+ this.reconnectAttempt++;
76
+ this.reconnectTimer = setTimeout(() => this.connect(), jitter);
77
+ }
78
+ }
79
+ //# sourceMappingURL=websocket-client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"websocket-client.js","sourceRoot":"","sources":["../../src/transport/websocket-client.ts"],"names":[],"mappings":"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"}
package/package.json ADDED
@@ -0,0 +1,51 @@
1
+ {
2
+ "name": "@clawnitor/plugin",
3
+ "version": "1.0.0",
4
+ "description": "OpenClaw plugin for Clawnitor — agent monitoring, alerting, and kill switch",
5
+ "type": "module",
6
+ "main": "./dist/index.js",
7
+ "types": "./dist/index.d.ts",
8
+ "openclaw": {
9
+ "extensions": ["./dist/index.js"]
10
+ },
11
+ "files": [
12
+ "dist",
13
+ "README.md"
14
+ ],
15
+ "scripts": {
16
+ "build": "tsc",
17
+ "typecheck": "tsc --noEmit",
18
+ "test": "vitest run",
19
+ "test:watch": "vitest",
20
+ "prepublishOnly": "pnpm run build"
21
+ },
22
+ "keywords": [
23
+ "clawnitor",
24
+ "openclaw",
25
+ "openclaw-plugin",
26
+ "agent-monitoring",
27
+ "ai-safety",
28
+ "kill-switch",
29
+ "anomaly-detection",
30
+ "observability"
31
+ ],
32
+ "author": "David Kogan <davidkny22@gmail.com>",
33
+ "license": "AGPL-3.0",
34
+ "repository": {
35
+ "type": "git",
36
+ "url": "https://github.com/davidkny22/clawnitor-plugin.git"
37
+ },
38
+ "homepage": "https://clawnitor.io",
39
+ "publishConfig": {
40
+ "access": "public"
41
+ },
42
+ "dependencies": {
43
+ "@clawnitor/shared": "workspace:^",
44
+ "better-sqlite3": "^11"
45
+ },
46
+ "devDependencies": {
47
+ "typescript": "^5.7",
48
+ "vitest": "^3",
49
+ "@types/better-sqlite3": "^7"
50
+ }
51
+ }