@just-every/manager 0.1.65 → 0.1.67

package/README.md

@@ -17,6 +17,29 @@ justevery-manager
 Use `--download-only` to cache the installer without launching it, and
 `--print-path` to print the cached path.
 
+### Queue commands
+
+```bash
+justevery-manager queue devices
+
+justevery-manager queue start \
+  --device dev_123 \
+  --message "Start a new session"
+
+justevery-manager queue followup \
+  --session sess_123 \
+  --message "Add tests"
+
+justevery-manager queue state --session sess_123
+```
+
+Queue commands require a Manager org id and session cookie:
+
+```bash
+export ORG_ID=acct-...
+export SESSION_COOKIE=better-auth.session_token_value
+```
+
 On headless Linux, the wrapper will download and run the headless daemon
 (`Every.Manager_*_linux_amd64_headless`) when available.
 
@@ -30,3 +53,6 @@ On headless Linux, the wrapper will download and run the headless daemon
 - `JE_AGENT_GITHUB_TOKEN` – optional GitHub token for private releases (also supports `GH_TOKEN` / `GITHUB_TOKEN`).
 - `JE_AGENT_SKIP_DOWNLOAD=1` – skip the postinstall download/caching step.
 - `JE_AGENT_SKIP_LAUNCH=1` – skip launching the installer after download (also supports `JE_MANAGER_SKIP_LAUNCH`).
+- `ORG_ID` – Manager org id for queue commands.
+- `SESSION_COOKIE` – `better-auth.session_token` value for queue commands.
+- `BASE_URL` – Manager base URL (defaults to https://manager.justevery.com).

package/bin/justevery-manager.js

@@ -3,31 +3,40 @@ import { ensureInstaller, launchInstaller } from '../lib/installer.js';
 import { platform as osPlatform } from 'os';
 
 const args = process.argv.slice(2);
-const wantsHelp = args.includes('--help') || args.includes('-h');
-const skipLaunchEnv = process.env.JE_AGENT_SKIP_LAUNCH === '1' || process.env.JE_MANAGER_SKIP_LAUNCH === '1';
-const forceForeground = args.includes('--foreground') || args.includes('--no-daemon');
-const forceDaemon = args.includes('--daemon');
-const sessionType = (process.env.XDG_SESSION_TYPE || '').toLowerCase();
-const hasDisplay = Boolean(process.env.DISPLAY || process.env.WAYLAND_DISPLAY);
-const hasGuiSession = hasDisplay || (Boolean(sessionType) && sessionType !== 'tty');
-const isHeadlessLinux = osPlatform() === 'linux' && !hasGuiSession;
-const downloadOnly = args.includes('--download-only') || args.includes('--no-open') || skipLaunchEnv;
-const printPath = args.includes('--print-path');
-const launchMode = forceForeground ? 'foreground' : forceDaemon ? 'daemon' : 'auto';
-
-if (wantsHelp) {
-  console.log(`Every Manager installer helper
+
+const runInstaller = async () => {
+  const wantsHelp = args.includes('--help') || args.includes('-h');
+  const skipLaunchEnv = process.env.JE_AGENT_SKIP_LAUNCH === '1' || process.env.JE_MANAGER_SKIP_LAUNCH === '1';
+  const forceForeground = args.includes('--foreground') || args.includes('--no-daemon');
+  const forceDaemon = args.includes('--daemon');
+  const sessionType = (process.env.XDG_SESSION_TYPE || '').toLowerCase();
+  const hasDisplay = Boolean(process.env.DISPLAY || process.env.WAYLAND_DISPLAY);
+  const hasGuiSession = hasDisplay || (Boolean(sessionType) && sessionType !== 'tty');
+  const isHeadlessLinux = osPlatform() === 'linux' && !hasGuiSession;
+  const downloadOnly = args.includes('--download-only') || args.includes('--no-open') || skipLaunchEnv;
+  const printPath = args.includes('--print-path');
+  const launchMode = forceForeground ? 'foreground' : forceDaemon ? 'daemon' : 'auto';
+
+  if (wantsHelp) {
+    console.log(`Every Manager CLI
 
 Usage:
   justevery-manager [--download-only] [--print-path]
+  justevery-manager queue <command>
 
-Options:
+Installer Options:
   --download-only   Download the installer but do not launch it.
   --print-path      Print the installer path after download.
   --foreground      Run the Linux headless daemon in the foreground.
   --daemon          Force the Linux headless daemon to run in the background.
   -h, --help        Show this help message.
 
+Queue Commands:
+  queue start       Start a new session on a device.
+  queue followup    Enqueue a follow-up message for a session.
+  queue state       Show queue state for a session.
+  queue devices     List available devices.
+
 Environment:
   JE_AGENT_VERSION           Override the agent version.
   JE_AGENT_RELEASE_TAG       Override the GitHub release tag.
@@ -35,21 +44,36 @@ Environment:
   JE_AGENT_FALLBACK_BASE_URL Add fallback base URLs (comma-separated).
   JE_AGENT_ASSET             Override the installer filename.
   JE_AGENT_GITHUB_TOKEN      Optional GitHub token for private releases.
+  ORG_ID                      Manager org id for queue commands.
+  SESSION_COOKIE              better-auth.session_token value for queue commands.
+  BASE_URL                    Manager base URL (default https://manager.justevery.com).
 `);
-  process.exit(0);
-}
+    process.exit(0);
+  }
 
-try {
-  const result = await ensureInstaller({ allowDownload: true });
-  if (printPath || downloadOnly) {
-    console.log(result.path);
+  try {
+    const result = await ensureInstaller({ allowDownload: true });
+    if (printPath || downloadOnly) {
+      console.log(result.path);
+    }
+    if (!downloadOnly) {
+      await launchInstaller(result.path, { mode: launchMode });
+    } else if (isHeadlessLinux) {
+      console.log('No desktop session detected. Run the installer on a machine with a GUI.');
+    }
+  } catch (error) {
+    console.error(`Failed to prepare installer: ${error.message}`);
+    process.exit(1);
   }
-  if (!downloadOnly) {
-    await launchInstaller(result.path, { mode: launchMode });
-  } else if (isHeadlessLinux) {
-    console.log('No desktop session detected. Run the installer on a machine with a GUI.');
+};
+
+const main = async () => {
+  if (args[0] === 'queue') {
+    const { runQueueCommand } = await import('../lib/queue-cli.js');
+    await runQueueCommand(args.slice(1));
+    return;
   }
-} catch (error) {
-  console.error(`Failed to prepare installer: ${error.message}`);
-  process.exit(1);
-}
+  await runInstaller();
+};
+
+await main();

package/lib/queue-cli.js

@@ -0,0 +1,260 @@
+import { parseArgs } from 'node:util';
+
+const DEFAULT_BASE_URL = 'https://manager.justevery.com';
+
+const USAGE = `
+Every Manager queue commands
+
+Usage:
+  justevery-manager queue <command> [options]
+
+Commands:
+  start      Start a new session on a device
+  followup   Enqueue a follow-up message for a session
+  state      Show queue state for a session
+  devices    List devices (id, name, run status)
+
+Options:
+  --org               Manager org id (or ORG_ID env)
+  --cookie            better-auth.session_token value (or SESSION_COOKIE env)
+  --base-url          Manager base URL (default: https://manager.justevery.com)
+  --device            Device id
+  --session           Session id
+  --message           Message/prompt
+  --prompt            Alias for --message
+  --project           Project id
+  --cli               CLI name (code|codex|claude|gemini|qwen)
+  --cwd               Working directory
+  --action            followup action override (resume|new)
+  -h, --help          Show help
+`;
+
+const normalizeCookie = (value) => {
+  if (!value) return '';
+  if (value.includes('better-auth.session_token=')) return value;
+  return `better-auth.session_token=${value}`;
+};
+
+const resolveBaseUrl = (value) => value || process.env.BASE_URL || process.env.MANAGER_API_BASE || DEFAULT_BASE_URL;
+
+const resolveOrgId = (value) => value || process.env.ORG_ID || process.env.MANAGER_ORG_ID || '';
+
+const resolveCookie = (value) => value || process.env.SESSION_COOKIE || process.env.MANAGER_SESSION_COOKIE || '';
+
+const buildAuthHeaders = (orgId, cookie) => {
+  if (!orgId) throw new Error('ORG_ID is required (--org or ORG_ID env)');
+  if (!cookie) throw new Error('SESSION_COOKIE is required (--cookie or SESSION_COOKIE env)');
+  return {
+    'Content-Type': 'application/json',
+    'x-manager-org': orgId,
+    Cookie: normalizeCookie(cookie),
+  };
+};
+
+const parseResponse = async (response) => {
+  const text = await response.text();
+  if (!text) return null;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
+};
+
+const request = async (baseUrl, path, options = {}) => {
+  const url = `${baseUrl}${path}`;
+  const response = await fetch(url, options);
+  const data = await parseResponse(response);
+  if (!response.ok) {
+    const detail = data?.error || (data?.message ?? null) || response.statusText || 'Request failed';
+    throw new Error(detail);
+  }
+  return data;
+};
+
+const listDevices = async (baseUrl, headers) => {
+  const data = await request(baseUrl, '/api/manager/devices', {
+    method: 'GET',
+    headers,
+  });
+  return Array.isArray(data?.devices) ? data.devices : [];
+};
+
+const printQueueState = (queueState) => {
+  if (!queueState) {
+    console.log('Queue state unavailable.');
+    return;
+  }
+  const queued = queueState.queuedCount ?? 0;
+  const running = queueState.runningCount ?? 0;
+  const status = queueState.status || 'unknown';
+  console.log(`Queue: ${queued} queued, ${running} running (status=${status}).`);
+  if (queueState.error) {
+    console.log(`Last error: ${queueState.error}`);
+  }
+};
+
+const handleStart = async (baseUrl, headers, values) => {
+  const deviceId = values.device || '';
+  const message = (values.message || values.prompt || '').trim();
+  const projectId = values.project || '';
+  const cliNameInput = (values.cli || '').trim();
+  const cwd = (values.cwd || '').trim();
+
+  if (!deviceId) throw new Error('device id required (--device)');
+  if (!message) throw new Error('message required (--message)');
+
+  let cliName = cliNameInput;
+  let device = null;
+  if (!cliName) {
+    const devices = await listDevices(baseUrl, headers);
+    device = devices.find((entry) => entry.id === deviceId) || null;
+    cliName = (device?.cliName || '').trim();
+    if (!cliName) {
+      throw new Error('CLI name required. Provide --cli or update device metadata.');
+    }
+  }
+
+  const payload = {
+    deviceId,
+    message,
+    cliName,
+    ...(projectId ? { projectId } : {}),
+    ...(cwd ? { workingDirectory: cwd } : {}),
+  };
+
+  const response = await request(baseUrl, '/api/manager/sessions/start', {
+    method: 'POST',
+    headers,
+    body: JSON.stringify(payload),
+  });
+
+  console.log(`Queued start: ${response?.queueItem?.id ?? 'unknown'}`);
+  if (!device) {
+    const devices = await listDevices(baseUrl, headers);
+    device = devices.find((entry) => entry.id === deviceId) || null;
+  }
+  if (device) {
+    console.log(`Device ${device.name || device.deviceName || device.prefix}: ${device.runStatus || 'idle'}`);
+    if (device.lastError) {
+      console.log(`Device last error: ${device.lastError}`);
+    }
+  }
+};
+
+const handleFollowup = async (baseUrl, headers, values) => {
+  const sessionId = values.session || '';
+  const message = (values.message || values.prompt || '').trim();
+  const deviceId = (values.device || '').trim();
+  const cliName = (values.cli || '').trim();
+  const cwd = (values.cwd || '').trim();
+  const action = (values.action || '').trim();
+
+  if (!sessionId) throw new Error('session id required (--session)');
+  if (!message) throw new Error('message required (--message)');
+
+  const metadata = {};
+  if (action) metadata.action = action;
+  if (cliName) metadata.cliName = cliName;
+  if (cwd) metadata.workingDirectory = cwd;
+
+  const payload = {
+    message,
+    ...(deviceId ? { deviceId } : {}),
+    ...(Object.keys(metadata).length ? { metadata } : {}),
+  };
+
+  const response = await request(baseUrl, `/api/manager/sessions/${sessionId}/queue`, {
+    method: 'POST',
+    headers,
+    body: JSON.stringify(payload),
+  });
+
+  console.log(`Queued follow-up: ${response?.queueItem?.id ?? 'unknown'}`);
+  printQueueState(response?.queueState);
+};
+
+const handleState = async (baseUrl, headers, values) => {
+  const sessionId = values.session || '';
+  if (!sessionId) throw new Error('session id required (--session)');
+  const response = await request(baseUrl, `/api/manager/sessions/${sessionId}/queue`, {
+    method: 'GET',
+    headers,
+  });
+  printQueueState(response?.queueState);
+};
+
+const handleDevices = async (baseUrl, headers) => {
+  const devices = await listDevices(baseUrl, headers);
+  if (devices.length === 0) {
+    console.log('No devices found.');
+    return;
+  }
+  for (const device of devices) {
+    const name = device.name || device.deviceName || device.prefix;
+    const cliName = device.cliName ? ` cli=${device.cliName}` : '';
+    const status = device.runStatus || 'idle';
+    console.log(`${device.id}  ${name}  ${status}${cliName}`);
+  }
+};
+
+const printHelp = () => {
+  console.log(USAGE.trim());
+};
+
+export const runQueueCommand = async (argv = process.argv.slice(2)) => {
+  const { values, positionals } = parseArgs({
+    args: argv,
+    options: {
+      help: { type: 'boolean', short: 'h' },
+      org: { type: 'string' },
+      cookie: { type: 'string' },
+      'base-url': { type: 'string' },
+      device: { type: 'string' },
+      session: { type: 'string' },
+      message: { type: 'string' },
+      prompt: { type: 'string' },
+      project: { type: 'string' },
+      cli: { type: 'string' },
+      cwd: { type: 'string' },
+      action: { type: 'string' },
+    },
+    allowPositionals: true,
+  });
+
+  const command = positionals[0];
+  if (values.help || !command || command === 'help') {
+    printHelp();
+    return;
+  }
+
+  try {
+    const baseUrl = resolveBaseUrl(values['base-url']);
+    const orgId = resolveOrgId(values.org);
+    const cookie = resolveCookie(values.cookie);
+    const headers = buildAuthHeaders(orgId, cookie);
+
+    if (command === 'start') {
+      await handleStart(baseUrl, headers, values);
+      return;
+    }
+    if (command === 'followup' || command === 'queue' || command === 'continue') {
+      await handleFollowup(baseUrl, headers, values);
+      return;
+    }
+    if (command === 'state') {
+      await handleState(baseUrl, headers, values);
+      return;
+    }
+    if (command === 'devices') {
+      await handleDevices(baseUrl, headers);
+      return;
+    }
+
+    printHelp();
+    process.exit(1);
+  } catch (error) {
+    console.error(`Error: ${error instanceof Error ? error.message : error}`);
+    process.exit(1);
+  }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@just-every/manager",
-  "version": "0.1.65",
+  "version": "0.1.67",
   "description": "Installer wrapper for Every Manager",
   "license": "UNLICENSED",
   "type": "module",
@@ -11,11 +11,13 @@
   "files": [
     "bin/justevery-manager.js",
     "lib/installer.js",
+    "lib/queue-cli.js",
     "postinstall.js",
     "README.md"
   ],
   "scripts": {
-    "postinstall": "node postinstall.js"
+    "postinstall": "node postinstall.js",
+    "test": "node --test test/cli-routing.test.mjs"
   },
   "engines": {
     "node": ">=18"