agent-hub-relay 1.0.0

package/README.md

@@ -0,0 +1,113 @@
+# agent-hub-relay
+
+A small Node.js relay that exposes your local **Craft Agents** and **OpenClaw Gateway** to your Tailscale network, so the [Agent Hub](../../) mobile app can auto-discover and connect from anywhere on your tailnet.
+
+## What it does
+
+| Port | Service | What it does |
+|------|---------|--------------|
+| `9100` | Craft Agents | Forwards WS traffic to the Craft Agents macOS app's local port |
+| `18789` (or whatever OpenClaw uses) | OpenClaw Gateway | Forwards WS traffic to OpenClaw |
+| `9999` | Config server | HTTP endpoint serving connection credentials (URL + token) for the mobile app |
+
+All three are bound to your **Tailscale IP only** (not `0.0.0.0`), so they're reachable from your phone over the tailnet but never exposed to the public internet.
+
+The relay auto-detects:
+- Your Tailscale IP (via `tailscale ip -4`)
+- Craft Agents port/token from `~/.craft-agent/config.json` (server mode) or `~/.craft-agent/rpc.json` (packaged app)
+- OpenClaw port/credentials from `~/.openclaw/openclaw.json`
+
+## Requirements
+
+- **Node.js ≥ 18** (uses native `net`, `http`, `child_process` — no dependencies)
+- **Tailscale** running on the host
+- One or both of: Craft Agents (running) or OpenClaw (configured)
+
+## Install & run
+
+### Option A — npx (no install)
+
+```bash
+npx agent-hub-relay
+```
+
+### Option B — Global install from this folder
+
+```bash
+cd packages/relay
+npm link                 # makes `agent-hub-relay` available globally
+agent-hub-relay
+```
+
+### Option C — Direct invocation
+
+```bash
+node packages/relay/index.js
+```
+
+## Output
+
+```text
+  agent-hub-relay
+  ───────────────────────────────────────────────
+  ✓ Craft Agents   ws://100.64.0.2:9100 → 127.0.0.1:53124
+    token          rpc_abc123...
+  ✓ OpenClaw       ws://100.64.0.2:18789 → 127.0.0.1:18789
+  ✓ Config server  http://100.64.0.2:9999/config
+  ───────────────────────────────────────────────
+  Mobile app → tap "Auto-detect from Mac"
+  Tailscale IP → 100.64.0.2
+  ───────────────────────────────────────────────
+
+  Press Ctrl+C to stop.
+```
+
+## Usage with the Agent Hub mobile app
+
+1. Run `agent-hub-relay` on your Mac
+2. Open Agent Hub on your phone
+3. Tap **"Auto-detect from Mac"** (or enter your Tailscale IP manually)
+4. The app fetches `http://<tailscale-ip>:9999/config` and populates both profiles
+
+## Configuration
+
+The relay reads from fixed paths in `$HOME`:
+
+| File | Purpose |
+|------|---------|
+| `~/.craft-agent/config.json` | Craft Agents server mode (source-built) — preferred when present |
+| `~/.craft-agent/rpc.json` | Craft Agents packaged app — fallback |
+| `~/.openclaw/openclaw.json` | OpenClaw Gateway config |
+
+If a config file is missing, the corresponding relay is skipped (not fatal — OpenClaw and Craft Agents are both optional).
+
+## Standalone manual relays
+
+For quick manual fallbacks, see [`../../scripts/`](../../scripts/):
+
+- `tailscale-relay.sh` — socat-based Craft Agents relay (no Node required)
+- `openclaw-relay.sh` — socat-based OpenClaw relay (no Node required)
+
+These are kept for environments where Node isn't available, but the npm package is the recommended approach.
+
+## Publishing to npm
+
+```bash
+# 1. Make sure you're logged in
+npm login
+
+# 2. From this folder:
+npm publish --dry-run    # preview what gets published
+npm publish              # actually publish (becomes `npx agent-hub-relay`)
+```
+
+The `package.json` declares:
+- `name`: `agent-hub-relay`
+- `bin`: maps `agent-hub-relay` → `./index.js`
+- `files`: only ships `index.js` (no extraneous files)
+- `engines.node`: `>=18`
+- Zero runtime dependencies
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,271 @@
+#!/usr/bin/env node
+/**
+ * agent-hub-relay
+ *
+ * Relays Craft Agents + OpenClaw to your Tailscale IP so the Agent Hub
+ * mobile app can auto-detect and connect from anywhere on your tailnet.
+ *
+ * Usage:  npx agent-hub-relay
+ *         bunx agent-hub-relay
+ *         pnpm dlx agent-hub-relay
+ */
+
+import net from 'net';
+import http from 'http';
+import { execSync } from 'child_process';
+import { readFileSync, existsSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+
+// ── Helpers ───────────────────────────────────────────────────────────────────
+
+function getTailscaleIp() {
+  const cmds = [
+    'tailscale ip -4',
+    '/Applications/Tailscale.app/Contents/MacOS/Tailscale ip -4',
+    '/usr/local/bin/tailscale ip -4',
+  ];
+  for (const cmd of cmds) {
+    try {
+      const ip = execSync(cmd, { stdio: ['ignore', 'pipe', 'ignore'] })
+        .toString()
+        .trim()
+        .split('\n')[0]
+        .trim();
+      if (ip && /^\d+\.\d+\.\d+\.\d+$/.test(ip)) return ip;
+    } catch {}
+  }
+  return null;
+}
+
+function readJson(filePath) {
+  try {
+    return JSON.parse(readFileSync(filePath, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+function getCraftAgents() {
+  const configPath = join(homedir(), '.craft-agent', 'config.json');
+  const rpcPath    = join(homedir(), '.craft-agent', 'rpc.json');
+
+  if (existsSync(configPath)) {
+    const cfg = readJson(configPath);
+    const sc  = cfg?.serverConfig;
+    if (sc?.enabled && sc?.port) {
+      return { localPort: Number(sc.port), token: sc.token || '' };
+    }
+  }
+
+  if (existsSync(rpcPath)) {
+    const rpc = readJson(rpcPath);
+    if (rpc?.url) {
+      const localPort = Number(rpc.url.split(':').pop());
+      return { localPort, token: rpc.token || '' };
+    }
+  }
+
+  return null;
+}
+
+function getOpenclaw() {
+  const cfgPath = join(homedir(), '.openclaw', 'openclaw.json');
+  if (!existsSync(cfgPath)) return null;
+
+  const cfg  = readJson(cfgPath);
+  const gw   = cfg?.gateway   || {};
+  const auth = gw.auth        || {};
+
+  return {
+    localPort: Number(gw.port) || 18789,
+    password:  auth.password   || '',
+    token:     auth.token      || '',
+  };
+}
+
+// ── TCP relay ─────────────────────────────────────────────────────────────────
+
+function createRelay(bindIp, publicPort, localPort) {
+  return new Promise((resolve, reject) => {
+    const server = net.createServer((client) => {
+      const upstream = net.connect(localPort, '127.0.0.1');
+
+      client.pipe(upstream);
+      upstream.pipe(client);
+
+      const cleanup = () => {
+        try { client.destroy();   } catch {}
+        try { upstream.destroy(); } catch {}
+      };
+      client.on('error',   cleanup);
+      upstream.on('error', cleanup);
+      client.on('close',   () => { try { upstream.destroy(); } catch {} });
+      upstream.on('close', () => { try { client.destroy();   } catch {} });
+    });
+
+    server.on('error', reject);
+    server.listen(publicPort, bindIp, () => resolve(server));
+  });
+}
+
+// ── Config HTTP server ────────────────────────────────────────────────────────
+
+function createConfigServer(tailscaleIp, configPort, craftConfig, openclawConfig) {
+  return new Promise((resolve, reject) => {
+    const craftPayload = craftConfig
+      ? { url: `ws://${tailscaleIp}:9100`, token: craftConfig.token }
+      : { error: 'Craft Agents not found (~/.craft-agent/)' };
+
+    const openclawPayload = openclawConfig
+      ? {
+          url:      `ws://${tailscaleIp}:${openclawConfig.localPort}`,
+          password: openclawConfig.password,
+          token:    openclawConfig.token,
+        }
+      : { error: 'OpenClaw not found (~/.openclaw/)' };
+
+    const body = JSON.stringify({
+      craftAgents: craftPayload,
+      openclaw:    openclawPayload,
+    });
+
+    const server = http.createServer((req, res) => {
+      if (req.method === 'OPTIONS') {
+        res.writeHead(204, { 'Access-Control-Allow-Origin': '*' });
+        res.end();
+        return;
+      }
+      if (req.url !== '/config') {
+        res.writeHead(404);
+        res.end();
+        return;
+      }
+      res.writeHead(200, {
+        'Content-Type':                 'application/json',
+        'Content-Length':               Buffer.byteLength(body),
+        'Access-Control-Allow-Origin':  '*',
+      });
+      res.end(body);
+    });
+
+    server.on('error', reject);
+    server.listen(configPort, '0.0.0.0', () => resolve(server));
+  });
+}
+
+// ── Kill anything already using a port ───────────────────────────────────────
+
+function freePort(port) {
+  try {
+    const pids = execSync(`lsof -ti:${port} 2>/dev/null`, { stdio: ['ignore', 'pipe', 'ignore'] })
+      .toString()
+      .trim();
+    if (pids) {
+      execSync(`kill ${pids.split('\n').join(' ')} 2>/dev/null || true`, { stdio: 'ignore' });
+    }
+  } catch {}
+}
+
+// ── Main ─────────────────────────────────────────────────────────────────────
+
+const CONFIG_PORT = 9999;
+const CRAFT_PORT  = 9100;
+
+const servers = [];
+
+process.on('SIGINT',  shutdown);
+process.on('SIGTERM', shutdown);
+
+function shutdown() {
+  process.stdout.write('\n\nStopping relays...\n');
+  for (const s of servers) {
+    try { s.close(); } catch {}
+  }
+  process.exit(0);
+}
+
+async function main() {
+  // ── Tailscale ──
+  const tailscaleIp = getTailscaleIp();
+  if (!tailscaleIp) {
+    console.error('ERROR: Could not get Tailscale IP. Is Tailscale running?');
+    console.error('       Install: https://tailscale.com/download');
+    process.exit(1);
+  }
+
+  // ── Read service configs ──
+  const craftConfig    = getCraftAgents();
+  const openclawConfig = getOpenclaw();
+
+  if (!craftConfig && !openclawConfig) {
+    console.error('ERROR: No services found.');
+    console.error('       Expected: ~/.craft-agent/config.json  or  ~/.craft-agent/rpc.json');
+    console.error('                 ~/.openclaw/openclaw.json');
+    process.exit(1);
+  }
+
+  console.log('');
+  console.log('  agent-hub-relay');
+  console.log('  ───────────────────────────────────────────────');
+
+  // ── Craft Agents relay ──
+  if (craftConfig) {
+    freePort(CRAFT_PORT);
+    try {
+      const srv = await createRelay(tailscaleIp, CRAFT_PORT, craftConfig.localPort);
+      servers.push(srv);
+      console.log(`  ✓ Craft Agents   ws://${tailscaleIp}:${CRAFT_PORT} → 127.0.0.1:${craftConfig.localPort}`);
+      if (craftConfig.token) {
+        console.log(`    token          ${craftConfig.token}`);
+      }
+    } catch (err) {
+      console.warn(`  ✗ Craft Agents   ${err.message}`);
+    }
+  } else {
+    console.log('  – Craft Agents   not found (skipped)');
+  }
+
+  // ── OpenClaw relay ──
+  if (openclawConfig) {
+    const ocPort = openclawConfig.localPort;
+    freePort(ocPort);
+    try {
+      const srv = await createRelay(tailscaleIp, ocPort, ocPort);
+      servers.push(srv);
+      console.log(`  ✓ OpenClaw       ws://${tailscaleIp}:${ocPort} → 127.0.0.1:${ocPort}`);
+    } catch (err) {
+      console.warn(`  ✗ OpenClaw       ${err.message}`);
+    }
+  } else {
+    console.log('  – OpenClaw       not found (skipped)');
+  }
+
+  // ── Config server ──
+  freePort(CONFIG_PORT);
+  try {
+    const srv = await createConfigServer(tailscaleIp, CONFIG_PORT, craftConfig, openclawConfig);
+    servers.push(srv);
+    console.log(`  ✓ Config server  http://${tailscaleIp}:${CONFIG_PORT}/config`);
+  } catch (err) {
+    console.warn(`  ✗ Config server  ${err.message}`);
+  }
+
+  console.log('  ───────────────────────────────────────────────');
+  console.log('  Mobile app → tap "Auto-detect from Mac"');
+  console.log(`  Tailscale IP → ${tailscaleIp}`);
+  console.log('  ───────────────────────────────────────────────');
+  console.log('');
+  console.log('  Press Ctrl+C to stop.');
+  console.log('');
+
+  if (servers.length === 0) {
+    console.error('  No relays started — exiting.');
+    process.exit(1);
+  }
+}
+
+main().catch((err) => {
+  console.error('Fatal:', err.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "agent-hub-relay",
+  "version": "1.0.0",
+  "description": "Relay Craft Agents + OpenClaw to your Tailscale IP for the Agent Hub mobile app",
+  "type": "module",
+  "bin": "index.js",
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "tailscale",
+    "relay",
+    "craft-agents",
+    "openclaw",
+    "agent-hub"
+  ],
+  "homepage": "https://github.com/ChrisKalathas/agent-hub#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ChrisKalathas/agent-hub.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ChrisKalathas/agent-hub/issues"
+  },
+  "license": "MIT",
+  "files": [
+    "index.js",
+    "README.md"
+  ]
+}