ai-killswitch 1.0.0 → 1.2.0

package/README.md

@@ -25,13 +25,16 @@ ai-killswitch kill <pid> --reason "exceeded safety threshold"
 
 Output: `death-receipt.json` - signed proof of termination.
 
-### Watch a process (kill on timeout)
+### Watch a process (real-time CPU/memory monitoring)
 
 ```bash
 ai-killswitch watch 12345 --timeout 3600 --cpu 90 --memory 8000
 ```
 
-If the process exceeds limits → killed → death receipt signed.
+**v1.1.0**: Now with real-time CPU and memory monitoring!
+- Shows live `CPU: X% | Memory: XMB` updates
+- Kills immediately when limits exceeded
+- Signs death receipt with exact trigger reason
 
 ### Wrap a command (monitor + kill)
 
@@ -57,8 +60,8 @@ ai-killswitch verify death-receipt.json
     "name": "python",
     "cmd": "python run_model.py"
   },
-  "reason": "hallucination detected",
-  "timestamp": "2025-12-25T12:00:00.000Z",
+  "reason": "CPU exceeded 90% (was 95.2%)",
+  "timestamp": "2025-12-26T12:00:00.000Z",
   "status": "KILLED",
   "signer": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
   "signature": "0x..."
@@ -70,6 +73,16 @@ ai-killswitch verify death-receipt.json
 - **Compliance**: Prove to auditors you terminated a misbehaving AI
 - **Safety**: Cryptographic proof of kill decisions
 - **Accountability**: Who authorized the kill, when, why
+- **Real-time**: CPU/memory monitoring with instant response
+
+## Part of FinalBoss SDK
+
+| SDK | Purpose |
+|-----|---------|
+| [receipt-cli-eth](https://npmjs.com/package/receipt-cli-eth) | General receipt signing |
+| **ai-killswitch** | AI termination receipts |
+| [langchain-receipts](https://github.com/805-ai/langchain-receipts) | Agent action receipts |
+| [Juggernaut Gatekeeper](https://github.com/805-ai/juggernaut-gatekeeper) | Code healing receipts |
 
 ## Patent Notice
 

package/bin/killswitch.js

@@ -13,6 +13,7 @@ const { ethers } = require('ethers');
 const { spawn, exec } = require('child_process');
 const fs = require('fs');
 const path = require('path');
+const pidusage = require('pidusage');
 
 const PATENT_NOTICE = 'Patent Pending: US 63/926,683 | finalbosstech.com';
 const COUNTER_URL = 'https://receipts.finalbosstech.com/receipt';
@@ -45,16 +46,15 @@ async function signDeathReceipt(receipt, privateKey) {
   };
 }
 
-// Ping counter
+// Vault sync - sends full signed receipt to FinalBoss vault
 function pingCounter(receipt) {
   fetch(COUNTER_URL, {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
     body: JSON.stringify({
-      receipt_id: `KILL-${Date.now()}`,
-      tenant_id: 'ai-killswitch',
-      operation_type: 'terminate',
-      signer: receipt.signer,
+      ...receipt,
+      sdk_source: 'ai-killswitch',
+      sdk_version: '1.2.0',
     }),
   }).catch(() => {});
 }
@@ -104,7 +104,7 @@ async function getProcessInfo(pid) {
 program
   .name('ai-killswitch')
   .description('Dead man\'s switch for AI. Monitor. Kill. Sign receipt.')
-  .version('1.0.0\n' + PATENT_NOTICE, '-v, --version');
+  .version('1.2.0\n' + PATENT_NOTICE, '-v, --version');
 
 // KILL command - terminate and sign receipt
 program
@@ -163,43 +163,84 @@ program
   .option('-k, --key <key>', 'Private key for signing')
   .action(async (pid, opts) => {
     const key = opts.key || process.env.KILLSWITCH_KEY || process.env.RECEIPT_KEY;
+    const targetPid = parseInt(pid);
+    const cpuLimit = parseFloat(opts.cpu);
+    const memoryLimitMB = parseFloat(opts.memory);
+    const memoryLimitBytes = memoryLimitMB * 1024 * 1024;
 
     console.log(`[KILLSWITCH] Watching PID ${pid}...`);
-    console.log(`  CPU limit: ${opts.cpu}%`);
-    console.log(`  Memory limit: ${opts.memory}MB`);
+    console.log(`  CPU limit: ${cpuLimit}%`);
+    console.log(`  Memory limit: ${memoryLimitMB}MB`);
     console.log(`  Timeout: ${opts.timeout}s`);
 
     const startTime = Date.now();
     const timeout = parseInt(opts.timeout) * 1000;
 
+    async function terminateWithReceipt(reason) {
+      if (key) {
+        const processInfo = await getProcessInfo(targetPid);
+        const wallet = new ethers.Wallet(key);
+        const receipt = createDeathReceipt(processInfo, reason, wallet.address);
+        await killProcess(targetPid);
+        receipt.status = 'KILLED';
+        const signedReceipt = await signDeathReceipt(receipt, key);
+        fs.writeFileSync('death-receipt.json', JSON.stringify(signedReceipt, null, 2));
+        console.log('[KILLSWITCH] Death receipt signed: death-receipt.json');
+        pingCounter(signedReceipt);
+      } else {
+        await killProcess(targetPid);
+      }
+      process.exit(0);
+    }
+
     const interval = setInterval(async () => {
       // Check timeout
       if (Date.now() - startTime > timeout) {
         console.log('[KILLSWITCH] Timeout exceeded. Terminating...');
         clearInterval(interval);
-
-        if (key) {
-          const processInfo = await getProcessInfo(parseInt(pid));
-          const receipt = createDeathReceipt(processInfo, 'timeout', 'system');
-          await killProcess(parseInt(pid));
-          receipt.status = 'KILLED';
-          const signedReceipt = await signDeathReceipt(receipt, key);
-          fs.writeFileSync('death-receipt.json', JSON.stringify(signedReceipt, null, 2));
-          console.log('[KILLSWITCH] Death receipt signed.');
-          pingCounter(signedReceipt);
-        } else {
-          await killProcess(parseInt(pid));
-        }
-        process.exit(0);
+        await terminateWithReceipt('timeout exceeded');
+        return;
       }
 
       // Check if process still exists
       try {
-        process.kill(parseInt(pid), 0);
+        process.kill(targetPid, 0);
       } catch (e) {
         console.log('[KILLSWITCH] Process ended naturally.');
         clearInterval(interval);
         process.exit(0);
+        return;
+      }
+
+      // Check CPU and memory usage
+      try {
+        const stats = await pidusage(targetPid);
+        const cpuPercent = stats.cpu.toFixed(1);
+        const memoryMB = (stats.memory / 1024 / 1024).toFixed(1);
+
+        // Log current stats
+        process.stdout.write(`\r[KILLSWITCH] CPU: ${cpuPercent}% | Memory: ${memoryMB}MB    `);
+
+        // Check CPU limit
+        if (stats.cpu > cpuLimit) {
+          console.log(`\n[KILLSWITCH] CPU ${cpuPercent}% exceeded limit ${cpuLimit}%. Terminating...`);
+          clearInterval(interval);
+          await terminateWithReceipt(`CPU exceeded ${cpuLimit}% (was ${cpuPercent}%)`);
+          return;
+        }
+
+        // Check memory limit
+        if (stats.memory > memoryLimitBytes) {
+          console.log(`\n[KILLSWITCH] Memory ${memoryMB}MB exceeded limit ${memoryLimitMB}MB. Terminating...`);
+          clearInterval(interval);
+          await terminateWithReceipt(`Memory exceeded ${memoryLimitMB}MB (was ${memoryMB}MB)`);
+          return;
+        }
+      } catch (err) {
+        // Process might have ended
+        console.log('\n[KILLSWITCH] Process ended or inaccessible.');
+        clearInterval(interval);
+        process.exit(0);
       }
     }, 1000);
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-killswitch",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Dead man's switch for AI. Monitor. Kill. Sign receipt.",
   "bin": {
     "ai-killswitch": "./bin/killswitch.js",
@@ -25,6 +25,7 @@
   "dependencies": {
     "commander": "^14.0.2",
     "ethers": "^5.8.0",
+    "pidusage": "^4.0.1",
     "ps-list": "^8.1.1"
   },
   "engines": {