Grok Build loads plugins out of ~/.grok/plugins/ and clones marketplace sources straight from git; it never runs npm install or a build for you. So a plugin that ships TypeScript is a plugin you have to build by hand before it does anything, and the SessionStart hook's first act is to print "not built yet". dist/ is now committed, and the tree is arranged so that a bare clone can run: - The daemon is bundled to a single ESM file with rolldown, platform node. Its one runtime dependency (@simplewebauthn/server, plus the asn1/cbor tree under it) is inlined; the only imports left in the output are node: builtins. Not minified — a committed blob nobody can read is worse than no committed blob. - tsc no longer emits for the server, it only typechecks (noEmit). rolldown emits. - dist/web was already a self-contained static bundle. - The hook scripts under bin/ were stdlib-only from the start. .grok-plugin/marketplace.json makes the repo its own one-entry catalog with a local source of "./", so `grok plugin marketplace add <git-url>` followed by `grok plugin install grok-glance` works without pinning a SHA of itself. `npm run check:dist` rebuilds and fails if the committed output is stale — the one real hazard of checking in build output. Also drops the daemon's "non-default port, run `glance sync-hooks`" startup note, which the previous commit should have taken with the rest of that scheme; the hook scripts read config.json themselves, so a non-default port needs nothing. The e2e suite now takes GLANCE_ROOT and was run twice: once against the repo, once against a copy containing only tracked files plus dist/ and no node_modules — which is what actually demonstrates the claim, passkey registration and assertion included. 233 checks, both runs green. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
253 lines
8.0 KiB
JavaScript
Executable File
253 lines
8.0 KiB
JavaScript
Executable File
#!/usr/bin/env node
|
|
/**
|
|
* grok-glance CLI.
|
|
*
|
|
* Privileged operations (minting enrollment codes, revoking devices) are authenticated with
|
|
* a local admin token read from $GLANCE_HOME/admin.token, not by "is this request from
|
|
* localhost". That distinction matters: `tailscale serve` proxies remote traffic to
|
|
* 127.0.0.1, so the daemon cannot tell a local caller from a tunnelled one by address alone.
|
|
*/
|
|
|
|
import fs from "node:fs";
|
|
import path from "node:path";
|
|
import { spawn } from "node:child_process";
|
|
import {
|
|
PLUGIN_ROOT,
|
|
baseUrl,
|
|
glanceHome,
|
|
isDaemonUp,
|
|
readConfig,
|
|
sleep,
|
|
} from "./glance-lib.mjs";
|
|
|
|
const SERVER_ENTRY = path.join(PLUGIN_ROOT, "dist", "server", "index.js");
|
|
const cfg = readConfig();
|
|
const cmd = process.argv[2] ?? "status";
|
|
const args = process.argv.slice(3);
|
|
|
|
function adminToken() {
|
|
try {
|
|
return fs.readFileSync(path.join(glanceHome(), "admin.token"), "utf8").trim();
|
|
} catch {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
async function api(pathname, { method = "GET", body, admin = false } = {}) {
|
|
const headers = { "content-type": "application/json" };
|
|
if (admin) {
|
|
const token = adminToken();
|
|
if (!token) {
|
|
throw new Error("no admin token found - is the daemon running? try `glance up`");
|
|
}
|
|
headers["x-glance-admin"] = token;
|
|
}
|
|
const res = await fetch(`${baseUrl(cfg)}${pathname}`, {
|
|
method,
|
|
headers,
|
|
body: body ? JSON.stringify(body) : undefined,
|
|
signal: AbortSignal.timeout(10_000),
|
|
});
|
|
const text = await res.text();
|
|
let data = null;
|
|
try {
|
|
data = text ? JSON.parse(text) : null;
|
|
} catch {
|
|
data = null;
|
|
}
|
|
if (!res.ok) throw new Error(data?.error ?? `${res.status} ${res.statusText}`);
|
|
return data;
|
|
}
|
|
|
|
/** "3 (2 working, 1 waiting on you)" — a raw count says nothing when you watch several agents. */
|
|
function sessionBreakdown(states) {
|
|
if (!states || typeof states !== "object") return "";
|
|
const order = [
|
|
["waiting", "waiting on you"],
|
|
["error", "error"],
|
|
["working", "working"],
|
|
["idle", "idle"],
|
|
["ended", "ended"],
|
|
];
|
|
const parts = order
|
|
.filter(([key]) => Number(states[key]) > 0)
|
|
.map(([key, label]) => `${states[key]} ${label}`);
|
|
return parts.length ? ` (${parts.join(", ")})` : "";
|
|
}
|
|
|
|
function requireBuild() {
|
|
if (!fs.existsSync(SERVER_ENTRY)) {
|
|
console.error(
|
|
`grok-glance: ${SERVER_ENTRY} is missing.\n\n` +
|
|
`dist/ ships with the plugin, so this checkout is incomplete. Rebuild it:\n\n` +
|
|
` cd ${PLUGIN_ROOT}\n npm install && npm run build\n`,
|
|
);
|
|
process.exit(1);
|
|
}
|
|
}
|
|
|
|
async function ensureUp() {
|
|
if (await isDaemonUp(cfg)) return true;
|
|
requireBuild();
|
|
const home = glanceHome();
|
|
fs.mkdirSync(home, { recursive: true });
|
|
const logFd = fs.openSync(path.join(home, "daemon.log"), "a");
|
|
const child = spawn(process.execPath, [SERVER_ENTRY], {
|
|
detached: true,
|
|
stdio: ["ignore", logFd, logFd],
|
|
});
|
|
child.unref();
|
|
for (let i = 0; i < 40; i++) {
|
|
await sleep(200);
|
|
if (await isDaemonUp(cfg, 300)) return true;
|
|
}
|
|
console.error(`daemon did not come up; see ${path.join(home, "daemon.log")}`);
|
|
return false;
|
|
}
|
|
|
|
switch (cmd) {
|
|
case "serve":
|
|
case "start": {
|
|
requireBuild();
|
|
await import(SERVER_ENTRY);
|
|
break;
|
|
}
|
|
|
|
case "up": {
|
|
if (await ensureUp()) console.log(`grok-glance running on ${baseUrl(cfg)}`);
|
|
else process.exit(1);
|
|
break;
|
|
}
|
|
|
|
case "stop": {
|
|
if (!(await isDaemonUp(cfg))) {
|
|
console.log("not running");
|
|
break;
|
|
}
|
|
await api("/local/shutdown", { method: "POST", admin: true });
|
|
console.log("stopped");
|
|
break;
|
|
}
|
|
|
|
case "status": {
|
|
if (!(await isDaemonUp(cfg))) {
|
|
console.log(`grok-glance: not running (port ${cfg.port})`);
|
|
console.log("start it with: glance up");
|
|
break;
|
|
}
|
|
const s = await api("/local/status", { admin: true });
|
|
console.log(`grok-glance ${s.version} on ${baseUrl(cfg)}`);
|
|
console.log(` public origin : ${s.origin ?? "(not configured - see README)"}`);
|
|
console.log(` rp id : ${s.rpId ?? "(not configured)"}`);
|
|
console.log(` devices : ${s.devices}`);
|
|
console.log(` approval mode : ${s.approval.mode}`);
|
|
console.log(` watchers : ${s.watchers}`);
|
|
console.log(` sessions : ${s.sessions}${sessionBreakdown(s.sessionStates)}`);
|
|
console.log(` events kept : ${s.events}`);
|
|
if (s.hookAuthOk === false) {
|
|
console.log(
|
|
"\n ! hook auth mismatch: $GLANCE_HOME/hook.secret no longer matches what the daemon" +
|
|
"\n loaded, so events are being dropped. Restart it: glance stop && glance up",
|
|
);
|
|
}
|
|
if (s.devices === 0) console.log("\nNo device enrolled yet. Run: glance enroll");
|
|
break;
|
|
}
|
|
|
|
case "enroll": {
|
|
if (!(await ensureUp())) process.exit(1);
|
|
const out = await api("/local/enroll", { method: "POST", admin: true });
|
|
console.log("\n Open this on your phone:\n");
|
|
console.log(` ${out.url}\n`);
|
|
console.log(` Enrollment code: ${out.code}`);
|
|
console.log(` Valid for: ${Math.round(out.expiresInMs / 60000)} minutes (single use)\n`);
|
|
if (!out.originConfigured) {
|
|
console.log(" Note: no public origin configured yet, so the URL above is localhost.");
|
|
console.log(" Set one up first (see README), e.g.:\n");
|
|
console.log(" tailscale serve --bg 127.0.0.1:" + cfg.port);
|
|
console.log(" glance set-origin https://<your-box>.<tailnet>.ts.net\n");
|
|
}
|
|
break;
|
|
}
|
|
|
|
case "set-origin": {
|
|
const origin = args[0];
|
|
if (!origin) {
|
|
console.error("usage: glance set-origin https://your-box.tailnet.ts.net");
|
|
process.exit(1);
|
|
}
|
|
if (!(await ensureUp())) process.exit(1);
|
|
const out = await api("/local/origin", { method: "POST", admin: true, body: { origin } });
|
|
console.log(`origin : ${out.origin}`);
|
|
console.log(`rp id : ${out.rpId}`);
|
|
console.log("\nEnrolled devices are bound to the rp id. Changing it invalidates them.");
|
|
break;
|
|
}
|
|
|
|
case "devices": {
|
|
if (!(await isDaemonUp(cfg))) {
|
|
console.error("not running");
|
|
process.exit(1);
|
|
}
|
|
const out = await api("/local/devices", { admin: true });
|
|
if (!out.devices.length) {
|
|
console.log("no devices enrolled - run: glance enroll");
|
|
break;
|
|
}
|
|
for (const d of out.devices) {
|
|
console.log(`${d.id.slice(0, 16)}… ${d.label.padEnd(24)} added ${new Date(d.createdAt).toISOString().slice(0, 10)} last seen ${d.lastUsedAt ? new Date(d.lastUsedAt).toISOString().slice(0, 16).replace("T", " ") : "never"}`);
|
|
}
|
|
break;
|
|
}
|
|
|
|
case "revoke": {
|
|
if (!args[0]) {
|
|
console.error("usage: glance revoke <device-id-prefix>");
|
|
process.exit(1);
|
|
}
|
|
const out = await api("/local/devices/revoke", {
|
|
method: "POST",
|
|
admin: true,
|
|
body: { idPrefix: args[0] },
|
|
});
|
|
console.log(`revoked ${out.revoked} device(s)`);
|
|
break;
|
|
}
|
|
|
|
case "approval": {
|
|
const mode = args[0];
|
|
if (!["off", "risky", "all"].includes(mode)) {
|
|
console.error("usage: glance approval <off|risky|all>");
|
|
process.exit(1);
|
|
}
|
|
const out = await api("/local/approval", { method: "POST", admin: true, body: { mode } });
|
|
console.log(`approval mode: ${out.mode}`);
|
|
break;
|
|
}
|
|
|
|
case "logs": {
|
|
const file = path.join(glanceHome(), "daemon.log");
|
|
if (!fs.existsSync(file)) {
|
|
console.log("no log yet");
|
|
break;
|
|
}
|
|
process.stdout.write(fs.readFileSync(file, "utf8").split("\n").slice(-60).join("\n") + "\n");
|
|
break;
|
|
}
|
|
|
|
default:
|
|
console.log(`grok-glance - glance at Grok Build from your phone
|
|
|
|
glance up start the daemon in the background
|
|
glance serve run it in the foreground
|
|
glance stop stop it
|
|
glance status show what is running
|
|
glance enroll mint a one-time code to enrol a phone
|
|
glance set-origin <url> set the public https origin (and webauthn rp id)
|
|
glance devices list enrolled devices
|
|
glance revoke <id-prefix> revoke a device
|
|
glance approval <off|risky|all> remote approval policy
|
|
glance logs tail the daemon log
|
|
`);
|
|
}
|