@xevy/heny-connect 0.1.0

package/README.md

@@ -0,0 +1,32 @@
+# @xevy/heny-connect
+
+Heny Connect pairs a computer with a Heny workspace and keeps the device's availability current.
+
+## Requirements
+
+- Node.js 20 or newer
+- A six-digit pairing code from the Heny **Desktop** page
+
+## Pair a computer
+
+```bash
+npx @xevy/heny-connect pair --code 123456 --server https://heny.vyte.dev --run
+```
+
+The pairing code works once and expires after 15 minutes. Pairing state is stored in `.heny-connect.json` in the current user's home directory.
+
+## Run an existing pairing
+
+```bash
+npx @xevy/heny-connect run
+```
+
+The process sends a heartbeat every 30 seconds. Keep it running for the device to remain available in Heny.
+
+## Check status
+
+```bash
+npx @xevy/heny-connect status
+```
+
+Heny Connect currently provides device registration and availability reporting. Browser and shell execution are planned capabilities.

package/bin/heny-connect.mjs

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+/**
+ * Heny Connect — pairs this computer with a Heny workspace and keeps it
+ * reporting in. Node 20+; no dependencies.
+ *
+ *   npx @xevy/heny-connect pair --code 123456 --server https://heny.example
+ *   npx @xevy/heny-connect run
+ *   npx @xevy/heny-connect status
+ *
+ * Pairing state is stored in ~/.heny-connect.json (mode 600).
+ */
+import { chmod, readFile, writeFile } from "node:fs/promises";
+import { homedir, hostname, platform, release } from "node:os";
+import { join } from "node:path";
+
+const STATE_FILE = join(process.env.HENY_CONNECT_HOME || homedir(), ".heny-connect.json");
+const args = process.argv.slice(2);
+const command = args[0] || "help";
+const opt = (name, fallback) => { const i = args.indexOf(`--${name}`); return i >= 0 ? args[i + 1] : fallback; };
+
+function systemLabel() {
+  const os = platform();
+  if (os === "win32") return `Windows ${release().startsWith("10.0.2") ? "11" : release()}`;
+  if (os === "darwin") return `macOS ${release()}`;
+  return `${os} ${release()}`;
+}
+
+async function loadState() { try { return JSON.parse(await readFile(STATE_FILE, "utf8")); } catch { return null; } }
+async function saveState(state) { await writeFile(STATE_FILE, JSON.stringify(state, null, 2)); await chmod(STATE_FILE, 0o600).catch(() => undefined); }
+
+async function call(server, path, body, token) {
+  const res = await fetch(new URL(path, server), { method: "POST", headers: { "Content-Type": "application/json", ...(token ? { Authorization: `Bearer ${token}` } : {}) }, body: JSON.stringify(body), signal: AbortSignal.timeout(20_000) });
+  const text = await res.text();
+  let parsed; try { parsed = JSON.parse(text); } catch { parsed = { raw: text }; }
+  if (!res.ok) throw new Error(parsed?.error?.message || `HTTP ${res.status}`);
+  return parsed;
+}
+
+async function pair() {
+  const code = opt("code"); const server = opt("server", process.env.HENY_SERVER);
+  if (!code || !server) { console.error("Usage: heny-connect pair --code 123456 --server https://heny.example"); process.exitCode = 2; return; }
+  const result = await call(server, "/api/devices/pair", { code, system: systemLabel(), hostname: hostname(), capabilities: ["browser", "shell"] });
+  await saveState({ server, token: result.token, deviceId: result.deviceId, workspace: result.workspace, pairedAt: new Date().toISOString() });
+  console.log(`Paired with ${result.workspace?.name ?? "workspace"} as device ${result.deviceId}.`);
+  if (!args.includes("--once") && args.includes("--run")) await run();
+}
+
+async function heartbeat(state, detail) {
+  return call(state.server, "/api/devices/heartbeat", { state: "available", detail }, state.token);
+}
+
+async function run() {
+  const state = await loadState();
+  if (!state) { console.error("Not paired. Run: heny-connect pair --code … --server …"); process.exitCode = 2; return; }
+  const every = Number(opt("every", 30)) * 1000;
+  const beats = Number(opt("beats", 0)); let count = 0;
+  const tick = async () => {
+    try { await heartbeat(state, `${hostname()}: browser ready`); count += 1; console.log(`${new Date().toISOString()} heartbeat ok (${count})`); }
+    catch (err) { console.error(`${new Date().toISOString()} heartbeat failed: ${err.message}`); if (/Unknown device token/.test(err.message)) process.exit(3); }
+    if (beats && count >= beats) process.exit(0);
+  };
+  await tick();
+  if (!beats || count < beats) setInterval(tick, every);
+}
+
+async function status() {
+  const state = await loadState();
+  if (!state) { console.log("Not paired."); return; }
+  const res = await fetch(new URL("/api/devices/me", state.server), { headers: { Authorization: `Bearer ${state.token}` }, signal: AbortSignal.timeout(20_000) });
+  console.log(res.ok ? JSON.stringify(await res.json(), null, 2) : `Server answered HTTP ${res.status}`);
+}
+
+const commands = { pair, run, status, help: async () => console.log("Commands: pair --code <6 digits> --server <url> [--run] | run [--every 30] [--beats N] | status") };
+(commands[command] || commands.help)().catch((err) => { console.error(err.message); process.exit(1); });

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@xevy/heny-connect",
+  "version": "0.1.0",
+  "description": "Pair a computer with Heny and keep its device presence online.",
+  "type": "module",
+  "bin": {
+    "heny-connect": "bin/heny-connect.mjs"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test test/*.node-test.mjs"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xevytech/heny.ai.git",
+    "directory": "packages/connect"
+  },
+  "homepage": "https://heny.vyte.dev",
+  "bugs": {
+    "url": "https://github.com/xevytech/heny.ai/issues"
+  },
+  "license": "UNLICENSED",
+  "keywords": [
+    "heny",
+    "device-agent",
+    "desktop-agent"
+  ]
+}