@phnx-labs/agents-cli 1.22.113 → 1.22.115

package/dist/commands/artifacts.js

@@ -1,58 +0,0 @@
-/**
- * `agents artifacts` — the group that owns everything an agent publishes for a
- * human to open: HTML plans, reports, rendered visuals, screenshots.
- *
- * RUSH-2580 nested the former top-level `agents share` here. `artifacts` is the
- * noun, `share` is the action on it, so the surface reads noun-then-action like
- * the rest of the CLI:
- *
- *   agents artifacts share <file>          publish
- *   agents artifacts share list|delete|analytics|join|status|update
- *   agents artifacts setup                 provision (or join) the endpoint
- *
- * The subtree itself lives in commands/share.ts (publish + its subcommands) and
- * commands/artifacts-setup.ts (the provisioning door); this module only assembles
- * the group, so there is one place that says what `agents artifacts` contains.
- */
-import { setHelpSections } from '../lib/help.js';
-import { registerShareCommands, registerUnshareCommand } from './share.js';
-import { registerArtifactsSetupCommand } from './artifacts-setup.js';
-export function registerArtifactsCommands(program) {
-    const artifactsCmd = program
-        .command('artifacts')
-        .description('Publish agent-made artifacts (plans, reports, visuals) to a shareable link — managed if signed in, otherwise your Cloudflare R2.');
-    registerArtifactsSetupCommand(artifactsCmd);
-    registerShareCommands(artifactsCmd);
-    setHelpSections(artifactsCmd, {
-        examples: `
-      # Signed in? Just publish — no Cloudflare setup
-      agents auth login
-      agents artifacts share ./out/plan.html
-
-      # Or provision your own Cloudflare endpoint (or join a teammate's)
-      agents artifacts setup
-      agents artifacts share join https://share.getrush.ai
-
-      # What's live in your namespace, and taking one down
-      agents artifacts share list
-      agents artifacts unshare my-plan-a1b2
-
-      # Endpoint health, and pushing a new Worker template to it
-      agents artifacts share status
-      agents artifacts share update
-    `,
-        notes: `
-  agents artifacts share is the publish action; agents artifacts setup is the
-  one-time endpoint provisioning. It runs the interactive wizard only when you
-  type NO endpoint flag on a TTY; type any of --bundle/--worker/--bucket/
-  --account/--token/--domain/--analytics-token, or run non-interactively, and it
-  provisions directly with what you named.
-
-  agents artifacts unshare <targets...> is the nested alias of
-  agents artifacts share delete. Top-level \`agents unshare\` is gone.
-
-  Architecture: cli/docs/observability.md.
-    `,
-    });
-    registerUnshareCommand(artifactsCmd);
-}

package/dist/commands/attach.d.ts

@@ -1,12 +0,0 @@
-/**
- * `agents sessions attach <id>` — bring a backgrounded (or parked) agent session
- * back to the foreground: stop its headless continuation, then resume it
- * interactively in this terminal. The resume is version-pinned native resume
- * (claude/codex) or a `/continue` replay (others) — the same session, full
- * history, the exact inverse of `agents sessions detach`.
- */
-import type { Command } from 'commander';
-import type { SessionMeta } from '../lib/session/types.js';
-export declare function registerAttachCommand(program: Command): void;
-export declare function attachAction(id: string): Promise<void>;
-export declare function attachRecoveryArgs(session: Pick<SessionMeta, 'id'>): string[];

package/dist/commands/attach.js

@@ -1,86 +0,0 @@
-import chalk from 'chalk';
-import { runOnPeer } from '../lib/session/remote-list.js';
-import { sessionRecoveryPeer } from '../lib/session/recovery.js';
-import { resolveSessionMetadataValue, resumeSessionInPlace } from './sessions.js';
-import { readDetachRecord, clearDetachRecord, isHeadlessAlive } from '../lib/session/detached.js';
-import { attachLocalLiveSelector } from '../lib/session/local-tmux-attach.js';
-export function registerAttachCommand(program) {
-    // Deprecated: superseded by `agents sessions resume`, which detects the state
-    // (live pane / headless / ended) instead of making the caller pick a verb.
-    // Hidden from help; kept as a warned, functional alias for one release so old
-    // muscle-memory and scripts don't break.
-    program
-        .command('attach', { hidden: true })
-        .argument('<id>', 'Short or full id of the backgrounded/parked session to resume interactively')
-        .description('Deprecated — use `agents sessions resume <id>` instead.')
-        .action(async (id) => {
-        console.warn(chalk.yellow('`agents sessions attach` is deprecated — use `agents sessions resume` instead:'));
-        console.warn(chalk.gray(`  agents sessions resume ${id}`));
-        await attachAction(id);
-    });
-}
-export async function attachAction(id) {
-    // PHNX-3292: this deprecated spelling still gets the local-pane fast path —
-    // a live tmux alias/short id on THIS box attaches with zero SSH, matching
-    // `sessions resume`. `attach` takes no `--device`, so hosts is always empty.
-    if (await attachLocalLiveSelector(id.trim(), [])) {
-        return;
-    }
-    const outcome = await resolveSessionMetadataValue(id);
-    if (outcome.kind === 'partial') {
-        // RUSH-2492: an unreachable peer is a warning, not a hard failure. The
-        // resolver already resolves an id found on the reachable fleet (SES-9a), so
-        // reaching here means the session was not found on any device we COULD reach
-        // — it may live on one of the unreachable peers, which we could not check.
-        const offline = outcome.failedPeers;
-        console.error(chalk.yellow(`Warning: ${offline.length} device(s) unreachable, not checked: ${offline.join(', ')}`));
-        console.error(chalk.red(`No session matching "${id}" on any reachable device (${offline.length} unreachable, not checked).`));
-        console.error(chalk.gray('  If it lives on an offline box, wake it (agents devices) or run there: agents ssh <device>'));
-        process.exitCode = 1;
-        return;
-    }
-    if (outcome.kind === 'not-found') {
-        console.error(chalk.red(`No session matching "${id}".`));
-        console.error(chalk.gray('  See your sessions: agents sessions'));
-        process.exitCode = 1;
-        return;
-    }
-    if (outcome.kind === 'ambiguous') {
-        console.error(chalk.red(`"${id}" matches ${outcome.candidates.length} sessions. Pass the full session id.`));
-        process.exitCode = 1;
-        return;
-    }
-    const meta = outcome.session;
-    // Route the WHOLE attach operation to the origin, not just its eventual
-    // resume. The detach record and headless PID are device-local; clearing them
-    // here would leave the real background continuation running beside a second
-    // process on the owning machine.
-    const peer = sessionRecoveryPeer(meta);
-    if (peer) {
-        const routed = await runOnPeer(attachRecoveryArgs(meta), peer, { tty: true, sessionId: meta.id });
-        if (routed === 'no-target') {
-            console.error(chalk.red(`Cannot attach ${meta.shortId}: origin device ${peer} is not a registered reachable peer.`));
-            process.exitCode = 1;
-        }
-        return;
-    }
-    // If it's backgrounded, stop the headless continuation first so two processes
-    // don't resume the same transcript at once.
-    const rec = readDetachRecord(meta.id);
-    if (rec) {
-        if (isHeadlessAlive(rec)) {
-            try {
-                process.kill(rec.headlessPid, 'SIGTERM');
-            }
-            catch {
-                /* already gone */
-            }
-        }
-        clearDetachRecord(meta.id);
-    }
-    console.log(chalk.gray(`Attaching ${meta.agent} ${meta.id.slice(0, 8)} — resuming interactively…`));
-    await resumeSessionInPlace(meta);
-}
-export function attachRecoveryArgs(session) {
-    return ['sessions', 'attach', session.id];
-}

package/dist/commands/auth-mint.d.ts

@@ -1,12 +0,0 @@
-/**
- * Shared `mint` subcommand registered on both `agents auth` (the ticket
- * surface) and `agents accounts` (the credential noun). Hidden on both:
- * `agents accounts add <harness> [name]` / `agents accounts login <harness>#<name>`
- * is the taught path. Implementation lives in lib/auth-mint.ts so neither
- * command file owns the seed path.
- */
-import type { Command } from 'commander';
-import { type MintDriveHooks } from '../lib/auth-mint.js';
-export declare function registerMintCommand(parent: Command, testHooks?: MintDriveHooks, opts?: {
-    hidden?: boolean;
-}): Command;

package/dist/commands/auth-mint.js

@@ -1,108 +0,0 @@
-/**
- * Shared `mint` subcommand registered on both `agents auth` (the ticket
- * surface) and `agents accounts` (the credential noun). Hidden on both:
- * `agents accounts add <harness> [name]` / `agents accounts login <harness>#<name>`
- * is the taught path. Implementation lives in lib/auth-mint.ts so neither
- * command file owns the seed path.
- */
-import chalk from 'chalk';
-import { setHelpSections } from '../lib/help.js';
-import { readStdinSync, runOrDie } from '../lib/format.js';
-import { isInteractiveTerminal } from './utils.js';
-import { getMintFlow, listMintableHarnesses, mintAndSeed, } from '../lib/auth-mint.js';
-const MINT_POINTER = 'agents accounts add <harness> [name] / agents accounts login <harness>#<name>';
-function collect(value, previous) {
-    return [...previous, value];
-}
-function printResult(result, json) {
-    if (json) {
-        console.log(JSON.stringify({
-            harness: result.harness,
-            account: result.account,
-            email: result.email,
-            authBundleKey: result.authBundleKey,
-            rotated: result.rotated,
-            fleet: result.fleet,
-        }, null, 2));
-        return;
-    }
-    const verb = result.rotated ? 'Rotated' : 'Minted';
-    console.log(chalk.green(`${verb} ${result.harness} setup-token for ${result.email} into account '${result.account}' and reserved auth bundle key ${result.authBundleKey}.`));
-    console.log(chalk.gray('The token is never printed. Native OAuth was not copied.'));
-    console.log(chalk.gray(`Run: agents run ${result.harness} --account ${result.account}`));
-    if (result.fleet.length) {
-        for (const row of result.fleet) {
-            console.log(chalk.green(`  synced ${row.device} (${row.message})`));
-        }
-    }
-}
-export function registerMintCommand(parent, testHooks, opts) {
-    const hidden = opts?.hidden ?? true;
-    const mint = parent
-        .command('mint <harness>', { hidden })
-        .description('Mint a long-lived setup-token and seed it as a named account')
-        .option('--account <name-or-email>', 'Named account to create/rotate, or the account email')
-        .option('--email <email>', 'Email that keys the reserved auth bundle when --account is a name')
-        .option('--token-stdin', 'Seed an already-minted token from stdin (skip the PTY drive)')
-        .option('--code <code>', 'Authorization code to paste into the setup-token prompt')
-        .option('--no-open', 'Print the authorize URL instead of opening a browser')
-        .option('--fleet', 'Sync the minted account and reserved auth bundle to every other registered device')
-        .option('--device <name>', 'Sync to this device (repeatable)', collect, [])
-        .option('--json', 'Machine-readable result (never includes the token)')
-        .action((harness, o, command) => {
-        const json = !!o.json || !!command.optsWithGlobals().json;
-        return runOrDie(async () => {
-            getMintFlow(harness);
-            let token;
-            if (o.tokenStdin) {
-                token = readStdinSync();
-                if (!token)
-                    throw new Error('No value received on stdin. Pass the setup-token on stdin with --token-stdin.');
-            }
-            else if (!isInteractiveTerminal() && !o.code) {
-                throw new Error(`Minting ${harness} interactively needs a TTY (or --token-stdin / --code). Supported harnesses: ${listMintableHarnesses().join(', ')}.`);
-            }
-            const result = await mintAndSeed({
-                harness,
-                account: o.account,
-                email: o.email,
-                token,
-                code: o.code,
-                open: o.open,
-                fleet: o.fleet,
-                devices: o.device,
-                json,
-                hooks: {
-                    ...testHooks,
-                    ...(o.tokenStdin || o.code || !isInteractiveTerminal()
-                        ? {}
-                        : {
-                            readCode: async () => {
-                                const { input } = await import('@inquirer/prompts');
-                                return input({ message: 'Paste the authorization code from the browser' });
-                            },
-                        }),
-                },
-            });
-            printResult(result, json);
-        }, { json });
-    });
-    if (hidden) {
-        mint.hook('preAction', () => {
-            console.error(chalk.gray(`'agents ${parent.name()} mint' is a hidden alias; use \`${MINT_POINTER}\` — still works this release.`));
-        });
-    }
-    setHelpSections(mint, {
-        examples: `agents accounts add claude work
-agents accounts login claude#work
-agents accounts mint claude --token-stdin < token.txt
-agents accounts mint claude --code AUTHCODE --json
-agents accounts mint claude --fleet`,
-        notes: `Hidden alias of the worker-credential step that \`agents accounts add <harness> [name]\` (mint during add) and \`agents accounts login <harness>#<name>\` (re-mint) now own. Claude is the only harness with an interactive long-lived setup-token (\`claude setup-token\`, ~1 year, shareable across machines). The command drives that flow in a PTY, opens the authorize URL, captures a well-formed sk-ant-oat01- token (refusing the #1767 TTY-banner capture), and seeds:
-  1. a named provider account (policy never) for \`agents run --account\` / \`agents accounts sync\`
-  2. the reserved FILE-BASED auth bundle keyed per email, which usage/probe reads
-Native rotating OAuth is never copied. Other harnesses fail loud: device-code login is \`agents fleet login\`; API keys are \`agents accounts add\`.
-Already have a token? \`--token-stdin\` skips the browser dance. \`agents auth mint\` and \`agents accounts mint\` are the same hidden command.`,
-    });
-    return mint;
-}

package/dist/commands/pty.d.ts

@@ -1,20 +0,0 @@
-/**
- * PTY Commands
- *
- * CLI commands for managing interactive PTY sessions.
- * Auto-starts the sidecar server on first use.
- *
- * Usage:
- *   agents pty start [--rows 24 --cols 120 --shell zsh --cwd /path]
- *   agents pty exec  <id> <command>
- *   agents pty read  <id> [--ms 200]
- *   agents pty write <id> <input>
- *   agents pty screen <id>
- *   agents pty signal <id> [INT|TERM|KILL]
- *   agents pty list
- *   agents pty stop  <id>
- *   agents pty server [start|stop|status]
- */
-import type { Command } from 'commander';
-/** Register the `agents pty` command tree. */
-export declare function registerPtyCommands(program: Command): void;