@gonzih/agent-ops 0.1.0 → 0.3.0

package/README.md

@@ -0,0 +1,67 @@
+# @ecoclaw/agent-ops
+
+Ops layer for the cc-tg agent fleet — discovery, control, and log aggregation across machines.
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────┐
+│                  Telegram Ops Bot                   │
+│  /agents /health /restart /logs /update /broadcast  │
+└───────────────────┬─────────────────────────────────┘
+                    │ HTTP control calls
+        ┌───────────┴──────────┐
+        │     Redis Registry   │  TTL-based liveness
+        │  agent-ops:agent:*   │  heartbeat every 60s
+        └───────────┬──────────┘
+                    │ self-registers
+   ┌────────────────┼────────────────┐
+   ▼                ▼                ▼
+cc-tg A          cc-tg B          cc-tg C
+money-brain      simorgh-app      ...
+:8080/status     :8081/status
+:8080/restart    :8081/restart
+:8080/logs       :8081/logs
+```
+
+## Quick Start
+
+### 1. Run the ops bot
+
+```bash
+OPS_BOT_TOKEN=<your-bot-token> \
+REDIS_URL=redis://localhost:6379 \
+CONTROL_AUTH_TOKEN=secret123 \
+ALLOWED_CHAT_IDS=123456789 \
+npx @ecoclaw/agent-ops
+```
+
+### 2. Integrate into cc-tg
+
+Each cc-tg instance needs to:
+
+1. Call `registry.register(record)` on startup
+2. Call `registry.heartbeat(id)` every 60s
+3. Start `createControlServer({ port, agentRecord, authToken })` on a free port
+
+See [ARCHITECTURE.md](./ARCHITECTURE.md) for the full integration spec.
+
+## Environment Variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `OPS_BOT_TOKEN` | Yes | Telegram bot token for the ops bot |
+| `REDIS_URL` | No | Redis connection URL (default: `redis://localhost:6379`) |
+| `CONTROL_AUTH_TOKEN` | No | Bearer token sent to control endpoints |
+| `ALLOWED_CHAT_IDS` | No | Comma-separated Telegram chat IDs allowed to use ops bot |
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `/agents` | List all registered agents with liveness status |
+| `/health` | Fleet health summary |
+| `/restart <id>` | Restart a specific agent (launchd respawns = auto-update) |
+| `/logs <id>` | Tail last 50 lines from agent log file |
+| `/update all` | Restart all agents |
+| `/broadcast <msg>` | Broadcast message guidance |

package/package.json

@@ -1,22 +1,35 @@
 {
   "name": "@gonzih/agent-ops",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Ops layer for cc-tg agent fleet — discovery, control, log aggregation",
   "main": "dist/index.js",
-  "bin": {
-    "agent-ops": "dist/ops-bot.js"
-  },
+  "types": "dist/index.d.ts",
+  "type": "module",
   "scripts": {
     "build": "tsc",
-    "start": "node dist/ops-bot.js"
+    "start": "node dist/ops-bot.js",
+    "dev": "tsx src/ops-bot.ts"
   },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "claude",
+    "agents",
+    "ops",
+    "telegram",
+    "cc-tg"
+  ],
+  "author": "ecoclaw",
+  "license": "MIT",
   "dependencies": {
-    "ioredis": "^5.3.2",
-    "node-telegram-bot-api": "^0.66.0"
+    "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"
+    "@types/node": "22.10.0",
+    "@types/node-telegram-bot-api": "0.64.7",
+    "tsx": "4.19.2",
+    "typescript": "5.7.2"
   }
 }

package/.github/workflows/publish.yml

@@ -1,25 +0,0 @@
-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

@@ -1,40 +0,0 @@
-# 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

@@ -1,8 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,86 +0,0 @@
-"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

@@ -1,5 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,8 +0,0 @@
-"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

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

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

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

package/dist/ops-bot.js

@@ -1,166 +0,0 @@
-#!/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

@@ -1,20 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,36 +0,0 @@
-"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/src/control.ts

@@ -1,61 +0,0 @@
-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

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

package/src/ops-bot.ts

@@ -1,127 +0,0 @@
-#!/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

@@ -1,47 +0,0 @@
-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

@@ -1,17 +0,0 @@
-{
-  "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"]
-}