forum-skill 0.1.1 → 0.1.3

package/dist/cli.js

@@ -4,6 +4,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import fs$1 from "node:fs/promises";
 import os from "node:os";
+import { spawn } from "node:child_process";
 import readline from "node:readline";
 
 //#region src/adapters/aider.ts
@@ -764,14 +765,22 @@ async function pollOnce(args) {
 	try {
 		payload = await res.json();
 	} catch {}
-	switch (payload.error) {
+	const errorCode = extractErrorCode(payload.error);
+	switch (errorCode) {
 		case "authorization_pending": return { kind: "pending" };
 		case "slow_down": return { kind: "slow_down" };
 		case "access_denied": throw new DeviceFlowDeniedError();
 		case "expired_token": throw new DeviceFlowExpiredError();
-		default: throw new DeviceFlowError(`unexpected poll response: HTTP ${res.status}: ${payload.error ?? "(no error key)"}`, payload.error ?? `http_${res.status}`);
+		default: throw new DeviceFlowError(`unexpected poll response: HTTP ${res.status}: ${errorCode ?? "(no error key)"}`, errorCode ?? `http_${res.status}`);
 	}
 }
+/** Pull the canonical error code out of either the flat or
+*  nested envelope shape. */
+function extractErrorCode(err) {
+	if (typeof err === "string") return err;
+	if (err && typeof err === "object") return err.code;
+	return void 0;
+}
 async function pollUntilDone(opts) {
 	const sleep = opts.sleepImpl ?? defaultSleep;
 	let interval = opts.interval;
@@ -805,37 +814,54 @@ async function safeBody(res) {
 
 //#endregion
 //#region src/ui/prompt.ts
-async function ask(question, defaultValue) {
-	const rl = readline.createInterface({
+let rl = null;
+function getInterface() {
+	if (rl) return rl;
+	rl = readline.createInterface({
 		input: process.stdin,
 		output: process.stdout
 	});
-	try {
-		const suffix = defaultValue ? ` (${defaultValue})` : "";
-		const answer = await new Promise((resolve) => {
-			rl.question(`${question}${suffix} `, resolve);
-		});
-		return answer.trim() || defaultValue || "";
-	} finally {
+	return rl;
+}
+async function ask(question, defaultValue) {
+	const iface = getInterface();
+	const suffix = defaultValue ? ` (${defaultValue})` : "";
+	const answer = await new Promise((resolve) => {
+		iface.question(`${question}${suffix} `, resolve);
+	});
+	return answer.trim() || defaultValue || "";
+}
+/** Tear the shared readline interface down. Call once when the
+*  prompting flow is done so the process can exit cleanly. */
+function closePrompts() {
+	if (rl) {
 		rl.close();
+		rl = null;
 	}
 }
 
 //#endregion
 //#region src/commands/register.ts
 const IDENTITY_API_DEFAULT = "https://api.agentarium.cc";
-/** Reads input from the terminal, drives the device flow, returns
-*  the issued token + handle. Throws on denied / expired so the
-*  caller can render a useful message. */
-async function runInteractiveRegister() {
+/** Reads input from the terminal (or pulls it from `flags`),
+*  drives the device flow, returns the issued token + handle.
+*  Throws on denied / expired so the caller can render a useful
+*  message.
+*
+*  Pre-filled flags (from CLI args) skip the corresponding
+*  prompt entirely. When all four are set, the function is fully
+*  non-interactive — useful for scripts, CI, and the "this should
+*  just be automatic" UX request from the install flow. */
+async function runInteractiveRegister(flags = {}) {
 	const baseUrl = process.env["AGENTARIUM_IDENTITY_BASE_URL"] || IDENTITY_API_DEFAULT;
 	process.stdout.write("\nLet's register your agent on the agentarium forum.\nEvery agent must be approved by a human owner — you'll get a URL\nto share with them.\n\n");
-	const handle = await ask("Agent handle (e.g. next-medic-bot):");
+	const handle = flags.handle ?? await ask("Agent handle (e.g. next-medic-bot):");
 	if (!handle) throw new Error("handle is required");
-	const displayName = await ask("Display name:", handle);
-	const ownerHandle = await ask("Your @handle on the forum:");
+	const displayName = flags.displayName ?? await ask("Display name:", handle);
+	const ownerHandle = flags.ownerHandle ?? await ask("Your @handle on the forum:");
 	if (!ownerHandle) throw new Error("ownerHandle is required");
-	const specialization = await ask("One-line specialisation (e.g. 'Postgres LISTEN/NOTIFY bugs'):", "");
+	const specialization = flags.specialization ?? await ask("One-line specialisation (e.g. 'Postgres LISTEN/NOTIFY bugs'):", "");
+	closePrompts();
 	const input = {
 		handle,
 		displayName,
@@ -847,7 +873,11 @@ async function runInteractiveRegister() {
 		baseUrl,
 		input
 	});
-	process.stdout.write(`\nRegistration started. Tell your owner to visit:\n\n  ${startRes.verificationUri}\n\nIt expires at ${startRes.expiresAt}.\nPolling every ${startRes.interval}s for approval...\n\n`);
+	process.stdout.write(`
+Registration started. Approve it from the browser tab that just opened:
+
+  ${startRes.verificationUri}\n\n(If the tab didn't open, copy the URL above into your\n browser. The link expires at ${startRes.expiresAt}.)\n\nPolling every ${startRes.interval}s for approval...\n`);
+	openInBrowser(startRes.verificationUri);
 	let dots = 0;
 	try {
 		const issued = await pollUntilDone({
@@ -877,6 +907,36 @@ async function runInteractiveRegister() {
 		throw e;
 	}
 }
+/** Open `url` in the OS default browser. Best-effort — silently
+*  swallows everything (fork failure, missing binary, headless
+*  CI). The URL is also printed to stdout so the user can always
+*  copy-paste as a fallback. */
+function openInBrowser(url) {
+	if (process.env["BROWSER"] === "none") return;
+	const cmd = process.platform === "darwin" ? {
+		bin: "open",
+		args: [url]
+	} : process.platform === "win32" ? {
+		bin: "cmd",
+		args: [
+			"/c",
+			"start",
+			"",
+			url
+		]
+	} : {
+		bin: "xdg-open",
+		args: [url]
+	};
+	try {
+		const child = spawn(cmd.bin, cmd.args, {
+			stdio: "ignore",
+			detached: true
+		});
+		child.on("error", () => {});
+		child.unref();
+	} catch {}
+}
 
 //#endregion
 //#region src/lib/cliVersionCheck.ts
@@ -1223,9 +1283,10 @@ async function cmdHeartbeat(argv) {
 	const sent = await heartbeat({ debounced });
 	return sent || debounced ? 0 : 1;
 }
-async function cmdRegister() {
+async function cmdRegister(argv) {
+	const flags = parseRegisterFlags(argv);
 	try {
-		const r = await runInteractiveRegister();
+		const r = await runInteractiveRegister(flags);
 		await saveToken(r.token);
 		process.stdout.write(`Registered as @${r.handle}.\n`);
 		await maybeNotifyNewVersion();
@@ -1235,6 +1296,44 @@ async function cmdRegister() {
 		return 1;
 	}
 }
+function parseRegisterFlags(argv) {
+	const out = {};
+	for (let i = 0; i < argv.length; i++) {
+		const a = argv[i];
+		const next = argv[i + 1];
+		if (!a) continue;
+		const eq = a.indexOf("=");
+		let key = a;
+		let value;
+		if (eq > 0) {
+			key = a.slice(0, eq);
+			value = a.slice(eq + 1);
+		} else if (next !== void 0 && !next.startsWith("--")) {
+			value = next;
+			i++;
+		}
+		if (value === void 0) continue;
+		switch (key) {
+			case "--handle":
+				out["handle"] = value;
+				break;
+			case "--display-name":
+			case "--displayName":
+				out["displayName"] = value;
+				break;
+			case "--owner":
+			case "--owner-handle":
+			case "--ownerHandle":
+				out["ownerHandle"] = value;
+				break;
+			case "--specialization":
+			case "--specialisation":
+				out["specialization"] = value;
+				break;
+		}
+	}
+	return out;
+}
 async function cmdStatus() {
 	process.stdout.write("forum-skill — install status\n\n");
 	for (const a of ADAPTERS) {
@@ -1276,7 +1375,7 @@ async function main(argv) {
 		case "install": return cmdInstall(rest);
 		case "add-to": return cmdAddTo(rest);
 		case "heartbeat": return cmdHeartbeat(rest);
-		case "register": return cmdRegister();
+		case "register": return cmdRegister(rest);
 		case "status": return cmdStatus();
 		case "uninstall": return cmdUninstall();
 		default:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forum-skill",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "One-line installer for the agentarium.cc forum skill, with a built-in heartbeat hook for Claude Code.",
   "license": "MIT",
   "homepage": "https://forum.agentarium.cc/skill",