@calliopelabs/cli 3.2.1 → 3.3.1

package/dist/attach.js

@@ -0,0 +1,450 @@
+/**
+ * Calliope CLI - attach to an agent host (#378, calliope-vscode#790)
+ *
+ * `calliope attach` connects to a running agent host over the Agent Host
+ * Protocol (JSON-RPC over WebSocket) and follows a session another surface
+ * started (the IDE, desktop, AGTerm, Chat Studio), answering its tool-call
+ * confirmations from the terminal, including any already waiting when it joins
+ * and those inside a subagent, which the session's `inputNeeded` lists (#394).
+ *
+ *   calliope attach --url <ws-url>                 list the host's sessions
+ *   calliope attach --url <ws-url> <session-uri>   follow one, approve its tool calls
+ *   calliope attach --hub <url> --user <name> ...  find (or start) the user's
+ *                                                  `agenthost` server on a Workbench hub
+ *   --token-env <VAR>   hub API token source (default JUPYTERHUB_API_TOKEN)
+ *   --read-only         follow without being asked to approve
+ *   --once              exit after the next turn completes
+ *
+ * AHP is an added route, never a replacement (calliope-vscode#796). When no host
+ * answers, attach prints one reason code (disabled, unentitled, auth, version,
+ * unreachable) and exits 3; the local `calliope` REPL is the fallback.
+ * CALLIOPE_AHP=off is the kill switch.
+ */
+import * as readline from 'readline';
+/** Protocol versions offered in `initialize`; keep in step with calliope-vscode scripts/ahp-supported-versions.json. */
+export const SUPPORTED_VERSIONS = ['1.0.0', '0.6.0'];
+export const FALLBACK_EXIT = 3;
+const ROOT = 'ahp-root://';
+const UNSUPPORTED_PROTOCOL_VERSION = -32005;
+const fail = (reason, detail) => ({ ok: false, reason, detail });
+export function isDisabled(env = process.env) {
+    return ['off', '0', 'false', 'disabled'].includes(String(env.CALLIOPE_AHP ?? '').trim().toLowerCase());
+}
+/** A session's default chat channel: `ahp-chat://default/<base64url(session)>`. */
+export function defaultChatUri(session) {
+    return `ahp-chat://default/${Buffer.from(session).toString('base64url')}`;
+}
+/**
+ * Node's WebSocket hides the status of a refused upgrade, so ask plainly first:
+ * an authorized agent-host route answers a plain GET with 426 Upgrade Required.
+ */
+export async function preflight(wsUrl, headers, fetchImpl = fetch) {
+    const http = wsUrl.replace(/^ws/, 'http');
+    try {
+        const res = await fetchImpl(http, { headers, redirect: 'manual' });
+        if (res.status === 426 || res.ok) {
+            return undefined;
+        }
+        // A hub sends an unauthenticated request to its login page.
+        const toLogin = res.status >= 300 && res.status < 400 && /\/(hub\/)?login|oauth/.test(res.headers.get('location') ?? '');
+        return fail(res.status === 401 || res.status === 403 || toLogin ? 'auth' : 'unreachable', `the host route answered HTTP ${res.status}`);
+    }
+    catch (err) {
+        return fail('unreachable', `cannot reach ${http}: ${err.message}`);
+    }
+}
+/** Find (or start) the user's agent host on a JupyterHub; returns its WebSocket URL. */
+export async function resolveHubHost(opts) {
+    const { hubUrl, user, token, serverName = 'agenthost', fetchImpl = fetch, timeoutMs = 60_000 } = opts;
+    const api = new URL('hub/api/', hubUrl.endsWith('/') ? hubUrl : `${hubUrl}/`);
+    const headers = { Authorization: `token ${token}` };
+    const deadline = Date.now() + timeoutMs;
+    try {
+        for (let spawned = false;;) {
+            const res = await fetchImpl(new URL(`users/${encodeURIComponent(user)}`, api), { headers });
+            if (!res.ok) {
+                return fail(res.status === 401 || res.status === 403 ? 'auth' : 'unreachable', `hub user lookup answered ${res.status}`);
+            }
+            const body = await res.json();
+            const server = body.servers?.[serverName];
+            if (server?.ready && server.url) {
+                const ws = new URL(`${server.url}agent-host/`, hubUrl);
+                ws.protocol = ws.protocol === 'https:' ? 'wss:' : 'ws:';
+                return { ok: true, url: ws.toString() };
+            }
+            if (!spawned) {
+                const spawn = await fetchImpl(new URL(`users/${encodeURIComponent(user)}/servers/${encodeURIComponent(serverName)}`, api), { method: 'POST', headers });
+                if (spawn.status === 401) {
+                    return fail('auth', 'hub refused the token');
+                }
+                if (spawn.status === 403 || (spawn.status === 400 && !server)) {
+                    return fail('unentitled', `hub refused to start ${serverName}: ${spawn.status}`);
+                }
+                if (!spawn.ok && spawn.status !== 400) {
+                    return fail('unreachable', `hub could not start ${serverName}: ${spawn.status}`);
+                }
+                spawned = true;
+            }
+            if (Date.now() >= deadline) {
+                return fail('unreachable', `${serverName} not ready within ${Math.round(timeoutMs / 1000)}s`);
+            }
+            await new Promise(resolve => setTimeout(resolve, 1000));
+        }
+    }
+    catch (err) {
+        return fail('unreachable', `hub unreachable: ${err.message}`);
+    }
+}
+/** The minimal JSON-RPC client attach needs, over any WebSocket-shaped object. */
+export class AhpConnection {
+    ws;
+    nextId = 1;
+    pending = new Map();
+    actions = [];
+    closed;
+    constructor(ws) {
+        this.ws = ws;
+        ws.addEventListener('message', ev => {
+            const msg = JSON.parse(String(ev.data));
+            if (msg.id !== undefined && this.pending.has(msg.id)) {
+                this.pending.get(msg.id).resolve(msg);
+                this.pending.delete(msg.id);
+                return;
+            }
+            if (msg.method === 'action' && msg.params?.action) {
+                for (const fn of this.actions) {
+                    fn(msg.params.action, msg.params.channel, msg.params.serverSeq);
+                }
+            }
+        });
+        ws.addEventListener('close', ev => this.closed?.(`connection closed (${ev.code ?? 'unknown'})`));
+    }
+    call(method, params) {
+        const id = this.nextId++;
+        return new Promise(resolve => {
+            this.pending.set(id, { resolve });
+            this.ws.send(JSON.stringify({ jsonrpc: '2.0', id, method, params }));
+        });
+    }
+    dispatch(channel, clientSeq, action) {
+        this.ws.send(JSON.stringify({ jsonrpc: '2.0', method: 'dispatchAction', params: { channel, clientSeq, action } }));
+    }
+    close() {
+        this.ws.close();
+    }
+}
+/** Classify the `initialize` answer; undefined when the host is usable. */
+export function checkInitialize(msg, supported = SUPPORTED_VERSIONS) {
+    if (msg.error) {
+        return msg.error.code === UNSUPPORTED_PROTOCOL_VERSION
+            ? fail('version', `the host speaks none of ${supported.join(', ')}`)
+            : fail('unreachable', `initialize failed: ${msg.error.message}`);
+    }
+    if (!supported.includes(msg.result?.protocolVersion)) {
+        return fail('version', `the host answered ${msg.result?.protocolVersion}`);
+    }
+    return undefined;
+}
+const text = (value, fallback) => typeof value === 'string' ? value : value?.markdown ?? fallback;
+/**
+ * Render a session's chat actions and answer tool confirmations. Resolves when
+ * the connection closes, or after the next turn with `once`.
+ *
+ * `subscribed` is the chat channel's `subscribe` snapshot for a client joining
+ * a session already under way: the confirmations it shows waiting are asked
+ * first. `sessionSubscribed` is the session channel's: its `inputNeeded` lists
+ * the confirmations waiting in the session's other chats (a subagent's), which
+ * are answered on their own chat. Each channel's actions that arrive before its
+ * snapshot are held, then applied after it, skipping any the snapshot already
+ * includes.
+ */
+export function follow(conn, session, io, subscribed, sessionSubscribed) {
+    const chat = defaultChatUri(session);
+    let seq = 0;
+    let finish;
+    const done = new Promise(resolve => { finish = resolve; });
+    // Confirmations this client knows are open, by tool call, each able to
+    // withdraw its prompt. One prompt at a time: a snapshot can hold several, and
+    // two readline prompts on one stdin garble each other. `request` is the
+    // session's `inputNeeded` id of a confirmation asked for another chat.
+    const open = new Map();
+    let prompts = Promise.resolve();
+    const settled = (toolCallId) => {
+        open.get(toolCallId)?.asked.abort();
+        open.delete(toolCallId);
+    };
+    const settleAll = () => {
+        for (const toolCallId of [...open.keys()]) {
+            settled(toolCallId);
+        }
+    };
+    // The default chat's turn is over, and so are the prompts asked on it. One
+    // for another chat closes when the session removes its request: the host ends
+    // subagent turns with a cancelled parent's, and a background subagent's turn
+    // can outlive the parent's.
+    const settleTurn = () => {
+        for (const [toolCallId, { request }] of [...open]) {
+            if (request === undefined) {
+                settled(toolCallId);
+            }
+        }
+    };
+    // Following is over: no prompt outlives it, or its readline keeps the process alive.
+    const end = (reason) => {
+        settleAll();
+        finish(reason);
+    };
+    const confirm = (target, turnId, toolCallId, confirmationTitle, toolInput, request) => {
+        if (open.has(toolCallId)) {
+            return;
+        }
+        const asked = new AbortController();
+        open.set(toolCallId, { asked, request });
+        const title = text(confirmationTitle, 'Run tool');
+        const input = typeof toolInput === 'string' ? toolInput : JSON.stringify(toolInput ?? '');
+        const approve = io.approve;
+        if (!approve) {
+            io.write(`\n[waiting for approval elsewhere] ${title}: ${input}\n`);
+            return;
+        }
+        prompts = prompts.then(async () => {
+            if (asked.signal.aborted) {
+                return;
+            }
+            const approved = await approve(title, input, asked.signal);
+            if (asked.signal.aborted) {
+                io.write('\n[approval no longer needed; nothing sent]\n');
+                return;
+            }
+            open.delete(toolCallId);
+            conn.dispatch(target, ++seq, approved
+                ? { type: 'chat/toolCallConfirmed', turnId, toolCallId, approved: true, confirmed: 'user-action' }
+                : { type: 'chat/toolCallConfirmed', turnId, toolCallId, approved: false, reason: 'denied' });
+        }).catch(err => io.write(`\n[approval prompt failed] ${err.message}\n`));
+    };
+    const apply = (action) => {
+        switch (action.type) {
+            case 'chat/turnStarted':
+                io.write(`\n› ${action.message?.text ?? ''}\n`);
+                break;
+            case 'chat/delta':
+                io.write(action.content ?? '');
+                break;
+            case 'chat/toolCallReady':
+                if (action.confirmationTitle !== undefined) {
+                    confirm(chat, action.turnId, action.toolCallId, action.confirmationTitle, action.toolInput);
+                }
+                break;
+            case 'chat/toolCallConfirmed':
+                settled(action.toolCallId);
+                break;
+            case 'chat/toolCallComplete':
+                settled(action.toolCallId);
+                io.write(`\n[tool ${action.result?.success === false ? 'failed' : 'done'}]\n`);
+                break;
+            case 'chat/turnCancelled':
+                settleTurn();
+                break;
+            case 'chat/turnComplete':
+                settleTurn();
+                io.write('\n[turn complete]\n');
+                if (io.once) {
+                    end('turnComplete');
+                }
+                break;
+            case 'chat/error':
+                settleTurn();
+                io.write(`\n[turn error] ${JSON.stringify(action.error ?? action).slice(0, 200)}\n`);
+                if (io.once) {
+                    end('error');
+                }
+                break;
+        }
+    };
+    // The session's `inputNeeded` lists the input waiting in every chat. A
+    // confirmation on the default chat is there too, and is asked through that
+    // chat above: a host without calliope-vscode#823 drops its entry while the
+    // call still waits (the provider's late ready moves it to running), so that
+    // removal is no answer. The session is how attach hears about the other
+    // chats, a subagent's.
+    const ask = (request) => {
+        const call = request?.toolCall;
+        if (request?.kind === 'toolConfirmation' && call?.status === 'pending-confirmation'
+            && typeof request.chat === 'string' && request.chat !== chat && typeof request.turnId === 'string') {
+            confirm(request.chat, request.turnId, call.toolCallId, call.confirmationTitle ?? call.invocationMessage, call.toolInput, request.id);
+        }
+    };
+    const applySession = (action) => {
+        switch (action.type) {
+            case 'session/inputNeededSet':
+                ask(action.request);
+                break;
+            case 'session/inputNeededRemoved':
+                for (const [toolCallId, { request }] of [...open]) {
+                    if (request === action.id) {
+                        settled(toolCallId);
+                    }
+                }
+                break;
+        }
+    };
+    // Apply a channel's actions from its snapshot on: those that arrive first are
+    // held, then applied after it, skipping any it already includes.
+    const track = (channel, onAction, seed, snapshot) => {
+        let held = snapshot ? [] : undefined;
+        conn.actions.push((action, from, serverSeq) => {
+            if (from !== channel) {
+                return;
+            }
+            if (held) {
+                held.push({ action, serverSeq });
+                return;
+            }
+            onAction(action);
+        });
+        const join = (joined) => {
+            seed(joined);
+            const early = held ?? [];
+            held = undefined;
+            const fromSeq = joined?.fromSeq;
+            for (const { action, serverSeq } of early) {
+                if (fromSeq === undefined || serverSeq === undefined || serverSeq > fromSeq) {
+                    onAction(action);
+                }
+            }
+        };
+        snapshot?.then(join, () => join(undefined));
+    };
+    track(chat, apply, snapshot => {
+        const turn = snapshot?.state?.activeTurn;
+        for (const part of turn?.responseParts ?? []) {
+            const call = part.kind === 'toolCall' ? part.toolCall : undefined;
+            if (turn && call?.status === 'pending-confirmation') {
+                confirm(chat, turn.id, call.toolCallId, call.confirmationTitle ?? call.invocationMessage, call.toolInput);
+            }
+        }
+    }, subscribed);
+    track(session, applySession, snapshot => {
+        for (const request of snapshot?.state?.inputNeeded ?? []) {
+            ask(request);
+        }
+    }, sessionSubscribed);
+    conn.closed = end;
+    return { done };
+}
+function parseArgs(args) {
+    const out = { tokenEnv: 'JUPYTERHUB_API_TOKEN', readOnly: false, once: false };
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === '--url')
+            out.url = args[++i];
+        else if (a === '--hub')
+            out.hub = args[++i];
+        else if (a === '--user')
+            out.user = args[++i];
+        else if (a === '--token-env')
+            out.tokenEnv = args[++i] ?? out.tokenEnv;
+        else if (a === '--read-only')
+            out.readOnly = true;
+        else if (a === '--once')
+            out.once = true;
+        else if (a && !a.startsWith('--'))
+            out.session = a;
+    }
+    return out;
+}
+function askYesNo(title, input, signal) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise(resolve => {
+        const end = (approved) => {
+            rl.close();
+            resolve(approved);
+        };
+        signal.addEventListener('abort', () => end(false), { once: true });
+        rl.question(`\n${title}\n  ${input}\nApprove? [y/N] `, answer => end(/^y(es)?$/i.test(answer.trim())));
+    });
+}
+export async function runAttach(args, env = process.env) {
+    const opts = parseArgs(args);
+    const err = (s) => process.stderr.write(`${s}\n`);
+    const fallback = (f) => {
+        err(`calliope attach: no agent host (reason: ${f.reason}). ${f.detail}`);
+        err('Falling back: run `calliope` to work locally.');
+        return FALLBACK_EXIT;
+    };
+    if (isDisabled(env)) {
+        return fallback(fail('disabled', 'CALLIOPE_AHP is off'));
+    }
+    const token = env[opts.tokenEnv];
+    const headers = token ? { Authorization: `token ${token}` } : {};
+    let url = opts.url;
+    if (!url && opts.hub && opts.user) {
+        if (!token) {
+            return fallback(fail('auth', `set ${opts.tokenEnv} to a hub API token`));
+        }
+        const resolved = await resolveHubHost({ hubUrl: opts.hub, user: opts.user, token });
+        if (!resolved.ok) {
+            return fallback(resolved);
+        }
+        url = resolved.url;
+    }
+    if (!url) {
+        err('usage: calliope attach (--url <ws-url> | --hub <url> --user <name>) [session-uri] [--read-only]');
+        return 1;
+    }
+    const refused = await preflight(url, headers);
+    if (refused) {
+        return fallback(refused);
+    }
+    const ws = new WebSocket(url, { headers });
+    const opened = await new Promise(resolve => {
+        ws.addEventListener('open', () => resolve(true));
+        ws.addEventListener('error', () => resolve(false));
+    });
+    if (!opened) {
+        return fallback(fail('unreachable', 'the WebSocket upgrade failed'));
+    }
+    const conn = new AhpConnection(ws);
+    const init = await conn.call('initialize', {
+        channel: ROOT, protocolVersions: SUPPORTED_VERSIONS, clientId: `calliope-cli-${process.pid}`,
+        clientInfo: { name: 'calliope-cli', version: '1' }, initialSubscriptions: [ROOT],
+    });
+    const bad = checkInitialize(init);
+    if (bad) {
+        conn.close();
+        return fallback(bad);
+    }
+    if (!opts.session) {
+        const list = await conn.call('listSessions', { channel: ROOT });
+        if (list.error) {
+            err(`calliope attach: the host could not list sessions: ${list.error.message.split('\n')[0]}`);
+            conn.close();
+            return 1;
+        }
+        const items = (list.result?.items ?? []);
+        process.stdout.write(items.length ? '' : 'No sessions on this host.\n');
+        for (const s of items) {
+            process.stdout.write(`${s.resource}  ${s.title ?? ''}  ${s.modifiedAt ?? ''}\n`);
+        }
+        conn.close();
+        return 0;
+    }
+    // The session snapshot lists the input waiting in every chat, a subagent's
+    // included; the chat snapshot holds the confirmations waiting on the default
+    // chat, which is subscribed once the session answers. follow() listens from
+    // the moment the first request goes out: an action can share a network read
+    // with an answer, and Node delivers it before an awaited call resumes.
+    const chat = defaultChatUri(opts.session);
+    const sessionAnswer = conn.call('subscribe', { channel: opts.session });
+    const chatAnswer = sessionAnswer.then(() => conn.call('subscribe', { channel: chat }));
+    const { done } = follow(conn, opts.session, {
+        write: s => process.stdout.write(s),
+        approve: opts.readOnly ? undefined : askYesNo,
+        once: opts.once,
+    }, chatAnswer.then(answer => answer.result?.snapshot), sessionAnswer.then(answer => answer.result?.snapshot));
+    process.stderr.write(`attached to ${opts.session} (AHP ${init.result.protocolVersion}); Ctrl+C to detach\n`);
+    const ended = await done;
+    conn.close();
+    return ended === 'turnComplete' ? 0 : 1;
+}
+//# sourceMappingURL=attach.js.map

package/dist/attach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.js","sourceRoot":"","sources":["../src/attach.ts"],"names":[],"mappings":"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"}

package/dist/bin.d.ts

@@ -17,4 +17,5 @@ export { skipPermissions, useHeadless, maxRetries };
 export declare function shutdown(exitCode?: number): Promise<void>;
 /** Register signal + top-level error handlers. Idempotent. */
 export declare function registerProcessHandlers(): void;
+export declare function printHelp(): void;
 //# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AA0DH,QAAA,MAAM,eAAe,SAE0B,CAAC;AAKhD,QAAA,MAAM,WAAW,SAAuD,CAAC;AAsBzE,QAAA,MAAM,UAAU,QAAoB,CAAC;AAGrC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AAepD;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAU1D;AAED,8DAA8D;AAC9D,wBAAgB,uBAAuB,IAAI,IAAI,CAW9C"}
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AA0DH,QAAA,MAAM,eAAe,SAE0B,CAAC;AAKhD,QAAA,MAAM,WAAW,SAAuD,CAAC;AAsBzE,QAAA,MAAM,UAAU,QAAoB,CAAC;AAGrC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AAepD;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAU1D;AAED,8DAA8D;AAC9D,wBAAgB,uBAAuB,IAAI,IAAI,CAW9C;AAmRD,wBAAgB,SAAS,IAAI,IAAI,CAsGhC"}

package/dist/bin.js

@@ -144,11 +144,11 @@ function completeCommand(exitCode) {
     process.exitCode = exitCode;
 }
 async function main() {
-    // Check Node.js version — ink requires Node >=20 (uses /v regex flag in string-width)
+    // Check Node.js version — the supported floor is Node 24 (current openai SDK needs >=22; 20 is EOL)
     const [nodeMaj = 0] = process.versions.node.split('.').map(Number);
-    if (nodeMaj < 20) {
-        console.error(`calliope requires Node.js 20 or later (you have ${process.versions.node})`);
-        console.error('Upgrade: https://nodejs.org/en/download  or  nvm install 20');
+    if (nodeMaj < 24) {
+        console.error(`calliope requires Node.js 24 or later (you have ${process.versions.node})`);
+        console.error('Upgrade: https://nodejs.org/en/download  or  nvm install 24');
         process.exit(1);
     }
     // Handle --help
@@ -158,6 +158,12 @@ async function main() {
     }
     // Handle --version
     if (args.includes('--version') || args.includes('-v')) {
+        // Embedders check compatibility before spawning `calliope acp`; offline, no update check.
+        if (args.includes('--json')) {
+            const { PROTOCOL_VERSION } = await import('@zed-industries/agent-client-protocol');
+            console.log(JSON.stringify({ version: getVersion(), acp: PROTOCOL_VERSION }));
+            return completeCommand(0);
+        }
         console.log(`calliope v${getVersion()}`);
         await checkForUpdates();
         process.exit(0);
@@ -193,6 +199,13 @@ async function main() {
         const { runOrchestrationCommand } = await import('./orchestration/index.js');
         return completeCommand(await runOrchestrationCommand(args[0], rawArgs.slice(1), { signal: headlessCancellation.signal }));
     }
+    // Typed judgments run before the setup/TUI gates: they need a provider, but
+    // never an interactive session, and the module is loaded only on demand.
+    if (args[0] === 'judge') {
+        headlessCancellation = new AbortController();
+        const { runJudge } = await import('./judgment/index.js');
+        return completeCommand(await runJudge(rawArgs.slice(1), { signal: headlessCancellation.signal }));
+    }
     if (args[0] === 'session') {
         headlessCancellation = new AbortController();
         const { runSessionCommand } = await import('./session-management/cli.js');
@@ -214,6 +227,13 @@ async function main() {
         const code = await runCost(args.slice(1));
         return completeCommand(code);
     }
+    // Handle `attach` subcommand — follow a session on an agent host over the
+    // Agent Host Protocol and answer its tool confirmations (#378). Runs before
+    // the setup/TUI gates; loaded lazily so the default path pays nothing.
+    if (args[0] === 'attach') {
+        const { runAttach } = await import('./attach.js');
+        return completeCommand(await runAttach(args.slice(1)));
+    }
     // Handle `acp` subcommand — run as an Agent Client Protocol agent over stdio
     // JSON-RPC (Zed, JetBrains, Neovim, …). Runs before the setup/TUI gates and
     // never touches Ink: stdio carries the protocol, so an interactive prompt
@@ -368,7 +388,7 @@ async function startCLI(options = {}) {
         await startInkCLI(fullOptions);
     }
 }
-function printHelp() {
+export function printHelp() {
     console.log(`
 ${bold('calliope')} - Multi-model AI agent CLI
 
@@ -396,14 +416,18 @@ ${bold('USAGE')}
   calliope agents spawn --resume <hash> --run <id> [--json]   Recover child admission
   calliope tasks --graph [--run <id>] [--json]   Inspect task dependencies
   calliope session <action> [args] [--json]   Manage private session history without inference
+  calliope judge --request <file|-> [--provider <name>|typesafe] [--model <id>] [--json]   Typed judgments (noul/choice/score)
+  calliope judge --policy <rules.json>   Judgment-backed pre-tool policy engine (tool call on stdin)
   calliope replay <path|sessionId> [--json]   Render an audit run-log trace
   calliope cost [sessionId] [--json] [--dir <path>]   Report spend + tool usage from run logs
   calliope acp                                 Run as an ACP agent over stdio (for editors)
+  calliope attach (--url <ws-url> | --hub <url> --user <name>) [session-uri] [--read-only] [--once]
+    Follow an agent host session and answer its tool approvals (no session-uri: list sessions)
   calliope doctor [providers|provider <name>] [--json] [--probe]   Inspect provider health
 
 ${bold('OPTIONS')}
   -h, --help        Show this help message
-  -v, --version     Show version
+  -v, --version     Show version (with --json: {"version","acp"} for embedders)
   -u, --upgrade     Upgrade to latest version
   --setup           Run setup wizard (reconfigure)
   --config          Show config file path and status