@gonzih/agent-ops 0.1.0

package/.github/workflows/publish.yml

@@ -0,0 +1,25 @@
+name: Publish to GitHub Packages
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://npm.pkg.github.com'
+          scope: '@ecoclaw'
+      - run: npm ci
+      - run: npm run build
+      - run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/ARCHITECTURE.md

@@ -0,0 +1,40 @@
+# agent-ops Architecture
+
+## Control Endpoints (HTTP)
+
+Each cc-tg agent exposes a lightweight HTTP server on `CC_AGENT_OPS_PORT`. Endpoints:
+
+- `GET /status` — returns JSON with namespace, pid, uptime, version
+- `POST /restart` — triggers `process.exit(0)` after 200ms (supervisor/pm2 restarts the process)
+- `GET /logs?lines=N` — tails the last N lines from `LOG_FILE`
+
+**Why HTTP over SSH/pipes:** Works transparently over Tailscale and LAN without additional auth setup. cc-tg already has `process.exit` restart logic, so `/restart` is a thin wrapper. Zero TLS/key management on a trusted local network.
+
+## Agent Registry (Redis)
+
+Each agent self-registers at startup and refreshes a 90-second TTL key every 60 seconds. If a process dies, its entry expires automatically. The ops-bot queries Redis to discover all live agents.
+
+Key schema: `agent-ops:agent:<namespace>` → Redis Hash with fields matching `AgentRecord`.
+
+## Integration with cc-tg
+
+cc-tg reads two optional env vars:
+
+- `CC_AGENT_OPS_PORT` — if set, start the HTTP control server on this port and register with Redis
+- `REDIS_URL` — already used by cc-agent; reused for the agent registry
+
+```typescript
+import { Registry, startControlServer } from '@ecoclaw/agent-ops'
+// on start:
+if (process.env.CC_AGENT_OPS_PORT) {
+  const redis = new Redis(process.env.REDIS_URL || 'redis://localhost:6379')
+  const registry = new Registry(redis)
+  await registry.register({ namespace, hostname, pid, version, cwd, control_port, ... })
+  setInterval(() => registry.heartbeat(namespace), 60_000)
+  startControlServer(Number(process.env.CC_AGENT_OPS_PORT), { logFile: process.env.LOG_FILE })
+}
+```
+
+## ops-bot
+
+Telegram bot that queries Redis for live agents and proxies commands to their control endpoints. Set `OPS_BOT_TOKEN`, `REDIS_URL`, and optionally `ALLOWED_USER_IDS` (comma-separated Telegram user IDs).

package/dist/control.d.ts

@@ -0,0 +1,8 @@
+import * as http from 'http';
+export interface ControlServerOptions {
+    namespace?: string;
+    version?: string;
+    logFile?: string;
+}
+export declare function startControlServer(port: number, opts?: ControlServerOptions): http.Server;
+//# sourceMappingURL=control.d.ts.map

package/dist/control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../src/control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAG5B,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,oBAAyB,GAAG,IAAI,CAAC,MAAM,CAmD7F"}

package/dist/control.js

@@ -0,0 +1,86 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startControlServer = startControlServer;
+const http = __importStar(require("http"));
+const fs = __importStar(require("fs"));
+function startControlServer(port, opts = {}) {
+    const startTime = Date.now();
+    const server = http.createServer((req, res) => {
+        const url = new URL(req.url || '/', `http://localhost:${port}`);
+        if (req.method === 'GET' && url.pathname === '/status') {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                namespace: opts.namespace || process.env.NAMESPACE || 'unknown',
+                pid: process.pid,
+                uptime: Math.floor((Date.now() - startTime) / 1000),
+                version: opts.version || process.env.VERSION || '0.0.0',
+            }));
+            return;
+        }
+        if (req.method === 'POST' && url.pathname === '/restart') {
+            res.writeHead(200, { 'Content-Type': 'text/plain' });
+            res.end('restarting');
+            setTimeout(() => process.exit(0), 200);
+            return;
+        }
+        if (req.method === 'GET' && url.pathname === '/logs') {
+            const lines = parseInt(url.searchParams.get('lines') || '50', 10);
+            const logFile = opts.logFile || process.env.LOG_FILE;
+            if (!logFile) {
+                res.writeHead(404, { 'Content-Type': 'text/plain' });
+                res.end('LOG_FILE not configured');
+                return;
+            }
+            try {
+                const content = fs.readFileSync(logFile, 'utf8');
+                const allLines = content.split('\n');
+                const tail = allLines.slice(-lines).join('\n');
+                res.writeHead(200, { 'Content-Type': 'text/plain' });
+                res.end(tail);
+            }
+            catch (e) {
+                res.writeHead(500, { 'Content-Type': 'text/plain' });
+                res.end(`Error reading log file: ${e}`);
+            }
+            return;
+        }
+        res.writeHead(404, { 'Content-Type': 'text/plain' });
+        res.end('Not found');
+    });
+    server.listen(port);
+    return server;
+}
+//# sourceMappingURL=control.js.map

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { Registry } from './registry';
+export type { AgentRecord } from './registry';
+export { startControlServer } from './control';
+export type { ControlServerOptions } from './control';
+//# 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":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAC9C,YAAY,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startControlServer = exports.Registry = void 0;
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "Registry", { enumerable: true, get: function () { return registry_1.Registry; } });
+var control_1 = require("./control");
+Object.defineProperty(exports, "startControlServer", { enumerable: true, get: function () { return control_1.startControlServer; } });
+//# sourceMappingURL=index.js.map

package/dist/ops-bot.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=ops-bot.d.ts.map

package/dist/ops-bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops-bot.d.ts","sourceRoot":"","sources":["../src/ops-bot.ts"],"names":[],"mappings":""}

package/dist/ops-bot.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_telegram_bot_api_1 = __importDefault(require("node-telegram-bot-api"));
+const ioredis_1 = __importDefault(require("ioredis"));
+const http = __importStar(require("http"));
+const registry_1 = require("./registry");
+const OPS_BOT_TOKEN = process.env.OPS_BOT_TOKEN;
+const REDIS_URL = process.env.REDIS_URL || 'redis://localhost:6379';
+const ALLOWED_USER_IDS = (process.env.ALLOWED_USER_IDS || '').split(',').map(s => parseInt(s.trim(), 10)).filter(Boolean);
+if (!OPS_BOT_TOKEN) {
+    console.error('OPS_BOT_TOKEN env var is required');
+    process.exit(1);
+}
+const redis = new ioredis_1.default(REDIS_URL);
+const registry = new registry_1.Registry(redis);
+const bot = new node_telegram_bot_api_1.default(OPS_BOT_TOKEN, { polling: true });
+function isAllowed(userId) {
+    return ALLOWED_USER_IDS.length === 0 || ALLOWED_USER_IDS.includes(userId);
+}
+function httpGet(url) {
+    return new Promise((resolve, reject) => {
+        http.get(url, (res) => {
+            let data = '';
+            res.on('data', (chunk) => data += chunk);
+            res.on('end', () => resolve(data));
+        }).on('error', reject);
+    });
+}
+function httpPost(url) {
+    return new Promise((resolve, reject) => {
+        const parsed = new URL(url);
+        const req = http.request({ hostname: parsed.hostname, port: parsed.port, path: parsed.pathname, method: 'POST' }, (res) => {
+            let data = '';
+            res.on('data', (chunk) => data += chunk);
+            res.on('end', () => resolve(data));
+        });
+        req.on('error', reject);
+        req.end();
+    });
+}
+bot.onText(/\/agents/, async (msg) => {
+    if (!isAllowed(msg.from?.id || 0))
+        return;
+    try {
+        const agents = await registry.listAgents();
+        if (agents.length === 0) {
+            await bot.sendMessage(msg.chat.id, 'No agents registered.');
+            return;
+        }
+        const now = Date.now();
+        const lines = agents.map(a => {
+            const ageMs = now - parseInt(a.started_at, 10);
+            const ageSec = Math.floor(ageMs / 1000);
+            const ageStr = ageSec > 3600 ? `${Math.floor(ageSec / 3600)}h` : ageSec > 60 ? `${Math.floor(ageSec / 60)}m` : `${ageSec}s`;
+            return `• ${a.namespace} @ ${a.hostname} pid=${a.pid} v${a.version} age=${ageStr}`;
+        });
+        await bot.sendMessage(msg.chat.id, `Registered agents:\n${lines.join('\n')}`);
+    }
+    catch (e) {
+        await bot.sendMessage(msg.chat.id, `Error: ${e}`);
+    }
+});
+bot.onText(/\/health/, async (msg) => {
+    if (!isAllowed(msg.from?.id || 0))
+        return;
+    try {
+        const agents = await registry.listAgents();
+        if (agents.length === 0) {
+            await bot.sendMessage(msg.chat.id, 'No agents registered.');
+            return;
+        }
+        const results = await Promise.all(agents.map(async (a) => {
+            try {
+                await httpGet(`http://${a.hostname}:${a.control_port}/status`);
+                return `✓ ${a.namespace}`;
+            }
+            catch {
+                return `✗ ${a.namespace}`;
+            }
+        }));
+        await bot.sendMessage(msg.chat.id, results.join('\n'));
+    }
+    catch (e) {
+        await bot.sendMessage(msg.chat.id, `Error: ${e}`);
+    }
+});
+bot.onText(/\/restart (.+)/, async (msg, match) => {
+    if (!isAllowed(msg.from?.id || 0))
+        return;
+    const namespace = match?.[1]?.trim();
+    if (!namespace)
+        return;
+    try {
+        const agents = await registry.listAgents();
+        const agent = agents.find(a => a.namespace === namespace);
+        if (!agent) {
+            await bot.sendMessage(msg.chat.id, `Agent ${namespace} not found.`);
+            return;
+        }
+        await httpPost(`http://${agent.hostname}:${agent.control_port}/restart`);
+        await bot.sendMessage(msg.chat.id, `Restart signal sent to ${namespace}.`);
+    }
+    catch (e) {
+        await bot.sendMessage(msg.chat.id, `Error: ${e}`);
+    }
+});
+bot.onText(/\/logs (.+)/, async (msg, match) => {
+    if (!isAllowed(msg.from?.id || 0))
+        return;
+    const namespace = match?.[1]?.trim();
+    if (!namespace)
+        return;
+    try {
+        const agents = await registry.listAgents();
+        const agent = agents.find(a => a.namespace === namespace);
+        if (!agent) {
+            await bot.sendMessage(msg.chat.id, `Agent ${namespace} not found.`);
+            return;
+        }
+        const logs = await httpGet(`http://${agent.hostname}:${agent.control_port}/logs?lines=50`);
+        const truncated = logs.length > 4000 ? logs.slice(-4000) : logs;
+        await bot.sendMessage(msg.chat.id, `Logs for ${namespace}:\n\`\`\`\n${truncated}\n\`\`\``, { parse_mode: 'Markdown' });
+    }
+    catch (e) {
+        await bot.sendMessage(msg.chat.id, `Error: ${e}`);
+    }
+});
+console.log('ops-bot running');
+//# sourceMappingURL=ops-bot.js.map

package/dist/registry.d.ts

@@ -0,0 +1,20 @@
+import type { Redis } from 'ioredis';
+export interface AgentRecord {
+    hostname: string;
+    user: string;
+    bot_username: string;
+    cwd: string;
+    namespace: string;
+    pid: string;
+    version: string;
+    started_at: string;
+    control_port: string;
+}
+export declare class Registry {
+    private redis;
+    constructor(redis: Redis);
+    register(record: AgentRecord): Promise<void>;
+    heartbeat(namespace: string): Promise<void>;
+    listAgents(): Promise<AgentRecord[]>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,qBAAa,QAAQ;IACP,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,KAAK;IAE1B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3C,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAkB3C"}

package/dist/registry.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Registry = void 0;
+class Registry {
+    constructor(redis) {
+        this.redis = redis;
+    }
+    async register(record) {
+        const key = `agent-ops:agent:${record.namespace}`;
+        await this.redis.hset(key, record);
+        await this.redis.expire(key, 90);
+    }
+    async heartbeat(namespace) {
+        const key = `agent-ops:agent:${namespace}`;
+        await this.redis.expire(key, 90);
+    }
+    async listAgents() {
+        const keys = [];
+        let cursor = '0';
+        do {
+            const [nextCursor, found] = await this.redis.scan(cursor, 'MATCH', 'agent-ops:agent:*', 'COUNT', 100);
+            cursor = nextCursor;
+            keys.push(...found);
+        } while (cursor !== '0');
+        const agents = [];
+        for (const key of keys) {
+            const data = await this.redis.hgetall(key);
+            if (data && Object.keys(data).length > 0) {
+                agents.push(data);
+            }
+        }
+        return agents;
+    }
+}
+exports.Registry = Registry;
+//# sourceMappingURL=registry.js.map

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@gonzih/agent-ops",
+  "version": "0.1.0",
+  "description": "Ops layer for cc-tg agent fleet — discovery, control, log aggregation",
+  "main": "dist/index.js",
+  "bin": {
+    "agent-ops": "dist/ops-bot.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/ops-bot.js"
+  },
+  "dependencies": {
+    "ioredis": "^5.3.2",
+    "node-telegram-bot-api": "^0.66.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "@types/node": "^20.0.0",
+    "@types/node-telegram-bot-api": "^0.64.0"
+  }
+}

package/src/control.ts

@@ -0,0 +1,61 @@
+import * as http from 'http'
+import * as fs from 'fs'
+
+export interface ControlServerOptions {
+  namespace?: string
+  version?: string
+  logFile?: string
+}
+
+export function startControlServer(port: number, opts: ControlServerOptions = {}): http.Server {
+  const startTime = Date.now()
+
+  const server = http.createServer((req, res) => {
+    const url = new URL(req.url || '/', `http://localhost:${port}`)
+
+    if (req.method === 'GET' && url.pathname === '/status') {
+      res.writeHead(200, { 'Content-Type': 'application/json' })
+      res.end(JSON.stringify({
+        namespace: opts.namespace || process.env.NAMESPACE || 'unknown',
+        pid: process.pid,
+        uptime: Math.floor((Date.now() - startTime) / 1000),
+        version: opts.version || process.env.VERSION || '0.0.0',
+      }))
+      return
+    }
+
+    if (req.method === 'POST' && url.pathname === '/restart') {
+      res.writeHead(200, { 'Content-Type': 'text/plain' })
+      res.end('restarting')
+      setTimeout(() => process.exit(0), 200)
+      return
+    }
+
+    if (req.method === 'GET' && url.pathname === '/logs') {
+      const lines = parseInt(url.searchParams.get('lines') || '50', 10)
+      const logFile = opts.logFile || process.env.LOG_FILE
+      if (!logFile) {
+        res.writeHead(404, { 'Content-Type': 'text/plain' })
+        res.end('LOG_FILE not configured')
+        return
+      }
+      try {
+        const content = fs.readFileSync(logFile, 'utf8')
+        const allLines = content.split('\n')
+        const tail = allLines.slice(-lines).join('\n')
+        res.writeHead(200, { 'Content-Type': 'text/plain' })
+        res.end(tail)
+      } catch (e) {
+        res.writeHead(500, { 'Content-Type': 'text/plain' })
+        res.end(`Error reading log file: ${e}`)
+      }
+      return
+    }
+
+    res.writeHead(404, { 'Content-Type': 'text/plain' })
+    res.end('Not found')
+  })
+
+  server.listen(port)
+  return server
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export { Registry } from './registry'
+export type { AgentRecord } from './registry'
+export { startControlServer } from './control'
+export type { ControlServerOptions } from './control'

package/src/ops-bot.ts

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+import TelegramBot from 'node-telegram-bot-api'
+import Redis from 'ioredis'
+import * as http from 'http'
+import { Registry } from './registry'
+
+const OPS_BOT_TOKEN = process.env.OPS_BOT_TOKEN
+const REDIS_URL = process.env.REDIS_URL || 'redis://localhost:6379'
+const ALLOWED_USER_IDS = (process.env.ALLOWED_USER_IDS || '').split(',').map(s => parseInt(s.trim(), 10)).filter(Boolean)
+
+if (!OPS_BOT_TOKEN) {
+  console.error('OPS_BOT_TOKEN env var is required')
+  process.exit(1)
+}
+
+const redis = new Redis(REDIS_URL)
+const registry = new Registry(redis)
+const bot = new TelegramBot(OPS_BOT_TOKEN, { polling: true })
+
+function isAllowed(userId: number): boolean {
+  return ALLOWED_USER_IDS.length === 0 || ALLOWED_USER_IDS.includes(userId)
+}
+
+function httpGet(url: string): Promise<string> {
+  return new Promise((resolve, reject) => {
+    http.get(url, (res) => {
+      let data = ''
+      res.on('data', (chunk: string) => data += chunk)
+      res.on('end', () => resolve(data))
+    }).on('error', reject)
+  })
+}
+
+function httpPost(url: string): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const parsed = new URL(url)
+    const req = http.request({ hostname: parsed.hostname, port: parsed.port, path: parsed.pathname, method: 'POST' }, (res) => {
+      let data = ''
+      res.on('data', (chunk: string) => data += chunk)
+      res.on('end', () => resolve(data))
+    })
+    req.on('error', reject)
+    req.end()
+  })
+}
+
+bot.onText(/\/agents/, async (msg) => {
+  if (!isAllowed(msg.from?.id || 0)) return
+  try {
+    const agents = await registry.listAgents()
+    if (agents.length === 0) {
+      await bot.sendMessage(msg.chat.id, 'No agents registered.')
+      return
+    }
+    const now = Date.now()
+    const lines = agents.map(a => {
+      const ageMs = now - parseInt(a.started_at, 10)
+      const ageSec = Math.floor(ageMs / 1000)
+      const ageStr = ageSec > 3600 ? `${Math.floor(ageSec/3600)}h` : ageSec > 60 ? `${Math.floor(ageSec/60)}m` : `${ageSec}s`
+      return `• ${a.namespace} @ ${a.hostname} pid=${a.pid} v${a.version} age=${ageStr}`
+    })
+    await bot.sendMessage(msg.chat.id, `Registered agents:\n${lines.join('\n')}`)
+  } catch (e) {
+    await bot.sendMessage(msg.chat.id, `Error: ${e}`)
+  }
+})
+
+bot.onText(/\/health/, async (msg) => {
+  if (!isAllowed(msg.from?.id || 0)) return
+  try {
+    const agents = await registry.listAgents()
+    if (agents.length === 0) {
+      await bot.sendMessage(msg.chat.id, 'No agents registered.')
+      return
+    }
+    const results = await Promise.all(agents.map(async (a) => {
+      try {
+        await httpGet(`http://${a.hostname}:${a.control_port}/status`)
+        return `✓ ${a.namespace}`
+      } catch {
+        return `✗ ${a.namespace}`
+      }
+    }))
+    await bot.sendMessage(msg.chat.id, results.join('\n'))
+  } catch (e) {
+    await bot.sendMessage(msg.chat.id, `Error: ${e}`)
+  }
+})
+
+bot.onText(/\/restart (.+)/, async (msg, match) => {
+  if (!isAllowed(msg.from?.id || 0)) return
+  const namespace = match?.[1]?.trim()
+  if (!namespace) return
+  try {
+    const agents = await registry.listAgents()
+    const agent = agents.find(a => a.namespace === namespace)
+    if (!agent) {
+      await bot.sendMessage(msg.chat.id, `Agent ${namespace} not found.`)
+      return
+    }
+    await httpPost(`http://${agent.hostname}:${agent.control_port}/restart`)
+    await bot.sendMessage(msg.chat.id, `Restart signal sent to ${namespace}.`)
+  } catch (e) {
+    await bot.sendMessage(msg.chat.id, `Error: ${e}`)
+  }
+})
+
+bot.onText(/\/logs (.+)/, async (msg, match) => {
+  if (!isAllowed(msg.from?.id || 0)) return
+  const namespace = match?.[1]?.trim()
+  if (!namespace) return
+  try {
+    const agents = await registry.listAgents()
+    const agent = agents.find(a => a.namespace === namespace)
+    if (!agent) {
+      await bot.sendMessage(msg.chat.id, `Agent ${namespace} not found.`)
+      return
+    }
+    const logs = await httpGet(`http://${agent.hostname}:${agent.control_port}/logs?lines=50`)
+    const truncated = logs.length > 4000 ? logs.slice(-4000) : logs
+    await bot.sendMessage(msg.chat.id, `Logs for ${namespace}:\n\`\`\`\n${truncated}\n\`\`\``, { parse_mode: 'Markdown' })
+  } catch (e) {
+    await bot.sendMessage(msg.chat.id, `Error: ${e}`)
+  }
+})
+
+console.log('ops-bot running')

package/src/registry.ts

@@ -0,0 +1,47 @@
+import type { Redis } from 'ioredis'
+
+export interface AgentRecord {
+  hostname: string
+  user: string
+  bot_username: string
+  cwd: string
+  namespace: string
+  pid: string
+  version: string
+  started_at: string
+  control_port: string
+}
+
+export class Registry {
+  constructor(private redis: Redis) {}
+
+  async register(record: AgentRecord): Promise<void> {
+    const key = `agent-ops:agent:${record.namespace}`
+    await this.redis.hset(key, record as unknown as Record<string, string>)
+    await this.redis.expire(key, 90)
+  }
+
+  async heartbeat(namespace: string): Promise<void> {
+    const key = `agent-ops:agent:${namespace}`
+    await this.redis.expire(key, 90)
+  }
+
+  async listAgents(): Promise<AgentRecord[]> {
+    const keys: string[] = []
+    let cursor = '0'
+    do {
+      const [nextCursor, found] = await this.redis.scan(cursor, 'MATCH', 'agent-ops:agent:*', 'COUNT', 100)
+      cursor = nextCursor
+      keys.push(...found)
+    } while (cursor !== '0')
+
+    const agents: AgentRecord[] = []
+    for (const key of keys) {
+      const data = await this.redis.hgetall(key)
+      if (data && Object.keys(data).length > 0) {
+        agents.push(data as unknown as AgentRecord)
+      }
+    }
+    return agents
+  }
+}

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}