@lightyearminds/dotline-agent 0.1.0

package/README.md

@@ -0,0 +1,34 @@
+# Dotline Agent (CLI)
+
+The Dotline backend cannot reach `localhost` or private network addresses from the cloud.
+Dotline Agent runs on the user's machine and **executes HTTP requests locally**, then
+returns the response back to Dotline.
+
+## Install (dev)
+
+From the repo root:
+
+```bash
+cd agent-cli
+npm install
+npm run build
+node dist/index.js --help
+```
+
+## Pair (from the UI)
+
+1) Your Dotline UI calls `POST /agents/pairing-code` (authenticated) and shows the code.
+
+2) On your machine:
+
+```bash
+dotline-agent login --api https://<DOTLINE_API> --code <PAIRING_CODE> --name "My Machine"
+dotline-agent start --api https://<DOTLINE_API>
+```
+
+## What it supports
+
+* JSON/text requests (GET/POST/PUT/PATCH/DELETE)
+* Localhost/private IP targets
+
+Multipart/FormData support can be added next (it requires streaming files and boundaries).

package/dist/index.js

@@ -0,0 +1,218 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { setTimeout as sleep } from "node:timers/promises";
+function hasTask(r) {
+    return typeof r.id === "string";
+}
+const CONFIG_DIR = path.join(os.homedir(), ".dotline");
+const CONFIG_PATH = path.join(CONFIG_DIR, "agent.json");
+function usage() {
+    console.log(`
+Dotline Agent
+
+Commands:
+  dotline-agent login --api <DOTLINE_API_BASE> --code <PAIRING_CODE> [--name "My Machine"]
+  dotline-agent start --api <DOTLINE_API_BASE>
+  dotline-agent status
+
+Examples:
+  dotline-agent login --api https://api.dotline.app --code ABCDEF1234 --name "MacBook"
+  dotline-agent start --api https://api.dotline.app
+`);
+}
+function parseArgs(argv) {
+    const out = {};
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (!a)
+            continue;
+        if (a.startsWith("--")) {
+            const k = a.slice(2);
+            const next = argv[i + 1];
+            if (next && !next.startsWith("--")) {
+                out[k] = next;
+                i++;
+            }
+            else {
+                out[k] = true;
+            }
+        }
+    }
+    return out;
+}
+function loadConfig() {
+    try {
+        const raw = fs.readFileSync(CONFIG_PATH, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+function saveConfig(cfg) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 2), "utf8");
+}
+function normalizeApiBase(api) {
+    return api.replace(/\/$/, "");
+}
+async function httpJson(url, init) {
+    const res = await fetch(url, init);
+    const text = await res.text();
+    let json = null;
+    try {
+        json = JSON.parse(text);
+    }
+    catch {
+        // ignore
+    }
+    if (!res.ok) {
+        const msg = json?.message || text || `${res.status} ${res.statusText}`;
+        throw new Error(msg);
+    }
+    return json;
+}
+async function cmdLogin(args) {
+    const api = args.api;
+    const code = args.code;
+    const name = args.name ?? "My Machine";
+    if (!api || !code) {
+        usage();
+        process.exit(1);
+    }
+    const apiBase = normalizeApiBase(api);
+    const resp = (await httpJson(`${apiBase}/agents/claim`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ code, name }),
+    }));
+    saveConfig({ api: apiBase, token: resp.agentToken, agentId: resp.agentId });
+    console.log(`✅ Agent paired as "${resp.name}" (agentId=${resp.agentId}).`);
+    console.log(`Config saved to ${CONFIG_PATH}`);
+}
+async function cmdStatus() {
+    const cfg = loadConfig();
+    if (!cfg.api || !cfg.token) {
+        console.log("Not logged in. Run: dotline-agent login --api <...> --code <...>");
+        process.exit(1);
+    }
+    try {
+        const me = await httpJson(`${cfg.api}/agents/me`, {
+            method: "GET",
+            headers: { "x-dotline-agent-token": cfg.token },
+        });
+        console.log(JSON.stringify(me, null, 2));
+    }
+    catch (e) {
+        console.error(`❌ ${e instanceof Error ? e.message : String(e)}`);
+        process.exit(1);
+    }
+}
+async function runHttpTask(api, token, task) {
+    const req = task.request ?? {};
+    const url = String(req.url ?? "");
+    const method = String(req.method ?? "GET").toUpperCase();
+    const headers = (req.headers ?? {});
+    const bodyText = req.bodyText;
+    const started = Date.now();
+    try {
+        const res = await fetch(url, {
+            method,
+            headers,
+            body: bodyText === undefined ? undefined : String(bodyText),
+        });
+        const text = await res.text();
+        const elapsedMs = Date.now() - started;
+        await httpJson(`${api}/agents/tasks/${task.id}/complete`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-dotline-agent-token": token,
+            },
+            body: JSON.stringify({
+                statusCode: res.status,
+                headers: Object.fromEntries(res.headers.entries()),
+                bodyText: text,
+                elapsedMs,
+            }),
+        });
+    }
+    catch (e) {
+        const elapsedMs = Date.now() - started;
+        await httpJson(`${api}/agents/tasks/${task.id}/complete`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-dotline-agent-token": token,
+            },
+            body: JSON.stringify({
+                error: e instanceof Error ? e.message : String(e),
+                elapsedMs,
+            }),
+        });
+    }
+}
+async function cmdStart(args) {
+    const cfg = loadConfig();
+    const api = normalizeApiBase(args.api ?? cfg.api ?? "");
+    const token = cfg.token ?? undefined;
+    if (!api || !token) {
+        console.log("Not logged in. Run: dotline-agent login --api <...> --code <...>");
+        process.exit(1);
+    }
+    console.log(`🤖 Dotline Agent started. Polling ${api} ...`);
+    while (true) {
+        try {
+            // heartbeat (best effort)
+            fetch(`${api}/agents/heartbeat`, {
+                method: "POST",
+                headers: { "x-dotline-agent-token": token },
+            }).catch(() => void 0);
+            const next = (await httpJson(`${api}/agents/tasks/next?waitMs=25000`, {
+                method: "GET",
+                headers: { "x-dotline-agent-token": token },
+            }));
+            if (!hasTask(next)) {
+                continue;
+            }
+            if (next.kind === "HTTP" || next.kind === "HTTP_REQUEST") {
+                await runHttpTask(api, token, next);
+            }
+            else {
+                await httpJson(`${api}/agents/tasks/${next.id}/complete`, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json",
+                        "x-dotline-agent-token": token,
+                    },
+                    body: JSON.stringify({ error: `Unknown task kind: ${next.kind}` }),
+                });
+            }
+        }
+        catch (e) {
+            console.error(`⚠️ ${e instanceof Error ? e.message : String(e)}`);
+            await sleep(1000);
+        }
+    }
+}
+async function main() {
+    const [cmd, ...rest] = process.argv.slice(2);
+    if (!cmd) {
+        usage();
+        return;
+    }
+    const args = parseArgs(rest);
+    if (cmd === "login")
+        return cmdLogin(args);
+    if (cmd === "start")
+        return cmdStart(args);
+    if (cmd === "status")
+        return cmdStatus();
+    usage();
+    process.exit(1);
+}
+main().catch((e) => {
+    console.error(`❌ ${e instanceof Error ? e.message : String(e)}`);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@lightyearminds/dotline-agent",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "bin": {
+    "dotline-agent": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}