@theclawlab/xgw-tui 1.0.3

package/README.md

@@ -0,0 +1 @@
+Terminal UI for TheClaw.

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+declare function formatAgentMessage(text: string): string;
+declare function computeBackoffMs(attempt: number): number;
+declare function formatConnectionStatus(channel: string, peer: string): string;
+
+export { computeBackoffMs, formatAgentMessage, formatConnectionStatus };

package/dist/index.js

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import { WebSocket } from "ws";
+import { createInterface } from "readline";
+
+// src/helpers.ts
+function formatAgentMessage(text) {
+  return `agent> ${text}`;
+}
+function computeBackoffMs(attempt) {
+  return Math.pow(2, attempt - 1) * 1e3;
+}
+function formatConnectionStatus(channel, peer) {
+  return `[${channel}/${peer}] Connected.`;
+}
+var MAX_RECONNECT_ATTEMPTS = 3;
+
+// src/index.ts
+var PING_INTERVAL_MS = 3e4;
+function buildWsUrl(host, port) {
+  return `ws://${host}:${port}`;
+}
+function createClient(opts) {
+  let reconnectAttempt = 0;
+  let rl = null;
+  let pingTimer = null;
+  let ws = null;
+  let intentionalClose = false;
+  function cleanup() {
+    if (pingTimer) {
+      clearInterval(pingTimer);
+      pingTimer = null;
+    }
+    if (rl) {
+      rl.close();
+      rl = null;
+    }
+  }
+  function connect() {
+    const url = buildWsUrl(opts.host, opts.port);
+    ws = new WebSocket(url);
+    ws.on("open", () => {
+      const hello = {
+        type: "hello",
+        channel_id: opts.channel,
+        peer_id: opts.peer
+      };
+      ws.send(JSON.stringify(hello));
+    });
+    ws.on("message", (data) => {
+      let frame;
+      try {
+        frame = JSON.parse(String(data));
+      } catch {
+        return;
+      }
+      switch (frame.type) {
+        case "hello_ack":
+          onConnected();
+          break;
+        case "error":
+          process.stderr.write(`Error: ${frame.message}
+`);
+          intentionalClose = true;
+          ws?.close();
+          process.exit(1);
+          break;
+        case "message":
+          process.stdout.write(formatAgentMessage(frame.text) + "\n");
+          break;
+        case "pong":
+          break;
+        default:
+          break;
+      }
+    });
+    ws.on("close", () => {
+      cleanup();
+      if (intentionalClose) return;
+      attemptReconnect();
+    });
+    ws.on("error", () => {
+    });
+  }
+  function onConnected() {
+    reconnectAttempt = 0;
+    process.stdout.write(formatConnectionStatus(opts.channel, opts.peer) + "\n");
+    pingTimer = setInterval(() => {
+      if (ws && ws.readyState === WebSocket.OPEN) {
+        ws.send(JSON.stringify({ type: "ping" }));
+      }
+    }, PING_INTERVAL_MS);
+    rl = createInterface({ input: process.stdin, output: process.stdout, prompt: "" });
+    rl.on("line", (line) => {
+      const trimmed = line.trim();
+      if (trimmed === "/quit") {
+        intentionalClose = true;
+        ws?.close();
+        cleanup();
+        process.exit(0);
+      }
+      if (ws && ws.readyState === WebSocket.OPEN && trimmed.length > 0) {
+        const msg = { type: "message", text: trimmed };
+        ws.send(JSON.stringify(msg));
+      }
+    });
+    rl.on("close", () => {
+      intentionalClose = true;
+      ws?.close();
+      cleanup();
+      process.exit(0);
+    });
+  }
+  function attemptReconnect() {
+    reconnectAttempt++;
+    if (reconnectAttempt > MAX_RECONNECT_ATTEMPTS) {
+      process.stderr.write("Error: Failed to reconnect after 3 attempts - Check that the xgw daemon is running\n");
+      process.exit(1);
+    }
+    const delayMs = computeBackoffMs(reconnectAttempt);
+    process.stderr.write(`Reconnecting (attempt ${reconnectAttempt}/${MAX_RECONNECT_ATTEMPTS}) in ${delayMs / 1e3}s...
+`);
+    setTimeout(connect, delayMs);
+  }
+  process.on("SIGINT", () => {
+    intentionalClose = true;
+    ws?.close();
+    cleanup();
+    process.exit(0);
+  });
+  connect();
+}
+var program = new Command();
+program.name("xgw-tui").description("Terminal chat client for xgw TUI plugin").requiredOption("--channel <id>", "Channel ID to connect to").requiredOption("--peer <id>", "Peer ID to identify as").option("--host <host>", "TUI plugin host", "127.0.0.1").option("--port <port>", "TUI plugin port", "18791").action((opts) => {
+  const port = parseInt(opts.port, 10);
+  if (isNaN(port) || port < 1 || port > 65535) {
+    process.stderr.write("Error: Invalid value for --port - Expected a number between 1 and 65535\n");
+    process.exit(2);
+  }
+  createClient({
+    channel: opts.channel,
+    peer: opts.peer,
+    host: opts.host,
+    port
+  });
+});
+program.parse();
+export {
+  computeBackoffMs,
+  formatAgentMessage,
+  formatConnectionStatus
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/helpers.ts"],"sourcesContent":["import { Command } from 'commander';\r\nimport { WebSocket } from 'ws';\r\nimport { createInterface, type Interface as ReadlineInterface } from 'node:readline';\r\nimport { formatAgentMessage, computeBackoffMs, formatConnectionStatus, MAX_RECONNECT_ATTEMPTS } from './helpers.js';\r\n\r\n// Re-export helpers for backwards compatibility\r\nexport { formatAgentMessage, computeBackoffMs, formatConnectionStatus } from './helpers.js';\r\n\r\n// ── TUI Frame types ──\r\n\r\ntype TuiFrame =\r\n  | { type: 'hello'; channel_id: string; peer_id: string }\r\n  | { type: 'hello_ack'; channel_id: string; peer_id: string }\r\n  | { type: 'error'; code: string; message: string }\r\n  | { type: 'message'; text: string }\r\n  | { type: 'ping' }\r\n  | { type: 'pong' };\r\n\r\n// ── Core client logic ──\r\nconst PING_INTERVAL_MS = 30_000;\r\n\r\ninterface ClientOptions {\r\n  channel: string;\r\n  peer: string;\r\n  host: string;\r\n  port: number;\r\n}\r\n\r\nfunction buildWsUrl(host: string, port: number): string {\r\n  return `ws://${host}:${port}`;\r\n}\r\n\r\nfunction createClient(opts: ClientOptions): void {\r\n  let reconnectAttempt = 0;\r\n  let rl: ReadlineInterface | null = null;\r\n  let pingTimer: ReturnType<typeof setInterval> | null = null;\r\n  let ws: WebSocket | null = null;\r\n  let intentionalClose = false;\r\n\r\n  function cleanup(): void {\r\n    if (pingTimer) {\r\n      clearInterval(pingTimer);\r\n      pingTimer = null;\r\n    }\r\n    if (rl) {\r\n      rl.close();\r\n      rl = null;\r\n    }\r\n  }\r\n\r\n  function connect(): void {\r\n    const url = buildWsUrl(opts.host, opts.port);\r\n    ws = new WebSocket(url);\r\n\r\n    ws.on('open', () => {\r\n      const hello: TuiFrame = {\r\n        type: 'hello',\r\n        channel_id: opts.channel,\r\n        peer_id: opts.peer,\r\n      };\r\n      ws!.send(JSON.stringify(hello));\r\n    });\r\n\r\n    ws.on('message', (data) => {\r\n      let frame: TuiFrame;\r\n      try {\r\n        frame = JSON.parse(String(data)) as TuiFrame;\r\n      } catch {\r\n        return;\r\n      }\r\n\r\n      switch (frame.type) {\r\n        case 'hello_ack':\r\n          onConnected();\r\n          break;\r\n        case 'error':\r\n          process.stderr.write(`Error: ${frame.message}\\n`);\r\n          intentionalClose = true;\r\n          ws?.close();\r\n          process.exit(1);\r\n          break;\r\n        case 'message':\r\n          process.stdout.write(formatAgentMessage(frame.text) + '\\n');\r\n          break;\r\n        case 'pong':\r\n          // keepalive ack, nothing to do\r\n          break;\r\n        default:\r\n          break;\r\n      }\r\n    });\r\n\r\n    ws.on('close', () => {\r\n      cleanup();\r\n      if (intentionalClose) return;\r\n      attemptReconnect();\r\n    });\r\n\r\n    ws.on('error', () => {\r\n      // 'close' event will fire after this, reconnect handled there\r\n    });\r\n  }\r\n\r\n  function onConnected(): void {\r\n    reconnectAttempt = 0;\r\n    process.stdout.write(formatConnectionStatus(opts.channel, opts.peer) + '\\n');\r\n\r\n    // Start ping keepalive\r\n    pingTimer = setInterval(() => {\r\n      if (ws && ws.readyState === WebSocket.OPEN) {\r\n        ws.send(JSON.stringify({ type: 'ping' } satisfies TuiFrame));\r\n      }\r\n    }, PING_INTERVAL_MS);\r\n\r\n    // Start readline loop\r\n    rl = createInterface({ input: process.stdin, output: process.stdout, prompt: '' });\r\n\r\n    rl.on('line', (line) => {\r\n      const trimmed = line.trim();\r\n      if (trimmed === '/quit') {\r\n        intentionalClose = true;\r\n        ws?.close();\r\n        cleanup();\r\n        process.exit(0);\r\n      }\r\n      if (ws && ws.readyState === WebSocket.OPEN && trimmed.length > 0) {\r\n        const msg: TuiFrame = { type: 'message', text: trimmed };\r\n        ws.send(JSON.stringify(msg));\r\n      }\r\n    });\r\n\r\n    rl.on('close', () => {\r\n      // Ctrl+C or EOF\r\n      intentionalClose = true;\r\n      ws?.close();\r\n      cleanup();\r\n      process.exit(0);\r\n    });\r\n  }\r\n\r\n  function attemptReconnect(): void {\r\n    reconnectAttempt++;\r\n    if (reconnectAttempt > MAX_RECONNECT_ATTEMPTS) {\r\n      process.stderr.write('Error: Failed to reconnect after 3 attempts - Check that the xgw daemon is running\\n');\r\n      process.exit(1);\r\n    }\r\n    const delayMs = computeBackoffMs(reconnectAttempt);\r\n    process.stderr.write(`Reconnecting (attempt ${reconnectAttempt}/${MAX_RECONNECT_ATTEMPTS}) in ${delayMs / 1000}s...\\n`);\r\n    setTimeout(connect, delayMs);\r\n  }\r\n\r\n  // Handle Ctrl+C globally\r\n  process.on('SIGINT', () => {\r\n    intentionalClose = true;\r\n    ws?.close();\r\n    cleanup();\r\n    process.exit(0);\r\n  });\r\n\r\n  connect();\r\n}\r\n\r\n// ── CLI ──\r\n\r\nconst program = new Command();\r\n\r\nprogram\r\n  .name('xgw-tui')\r\n  .description('Terminal chat client for xgw TUI plugin')\r\n  .requiredOption('--channel <id>', 'Channel ID to connect to')\r\n  .requiredOption('--peer <id>', 'Peer ID to identify as')\r\n  .option('--host <host>', 'TUI plugin host', '127.0.0.1')\r\n  .option('--port <port>', 'TUI plugin port', '18791')\r\n  .action((opts: { channel: string; peer: string; host: string; port: string }) => {\r\n    const port = parseInt(opts.port, 10);\r\n    if (isNaN(port) || port < 1 || port > 65535) {\r\n      process.stderr.write('Error: Invalid value for --port - Expected a number between 1 and 65535\\n');\r\n      process.exit(2);\r\n    }\r\n    createClient({\r\n      channel: opts.channel,\r\n      peer: opts.peer,\r\n      host: opts.host,\r\n      port,\r\n    });\r\n  });\r\n\r\nprogram.parse();\r\n","// ── Helpers (extracted for testability) ──\r\n\r\nexport function formatAgentMessage(text: string): string {\r\n  return `agent> ${text}`;\r\n}\r\n\r\nexport function computeBackoffMs(attempt: number): number {\r\n  return Math.pow(2, attempt - 1) * 1000;\r\n}\r\n\r\nexport function formatConnectionStatus(channel: string, peer: string): string {\r\n  return `[${channel}/${peer}] Connected.`;\r\n}\r\n\r\nexport const MAX_RECONNECT_ATTEMPTS = 3;\r\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@theclawlab/xgw-tui",
+  "type": "module",
+  "version": "1.0.3",
+  "description": "Terminal chat client for TheClaw",
+  "bin": {
+    "xgw-tui": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "release:local": "npm run build && npm link",
+    "release:public": "npm run build && npm publish --access public",
+    "release:public:skip-test": "npm run build && npm publish --access public"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "devDependencies": {
+    "@types/node": "^25.4.0",
+    "@types/ws": "^8.18.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "ws": "^8.18.0"
+  }
+}