@phnx-labs/agents-cli 1.22.35 → 1.22.38

package/dist/commands/hosts.js

@@ -1,330 +0,0 @@
-/**
- * `agents hosts` — register and inspect agent hosts (machines you offload runs to).
- *
- * The registry is a thin overlay: ssh-config hosts are dispatchable with zero
- * registration (connection details stay in ~/.ssh/config); enrollment only adds
- * capability metadata or bootstraps agents-cli, plus inline (non-ssh-config)
- * hosts. Dispatch itself is `agents run --host <name>` (see commands/exec.ts).
- */
-import chalk from 'chalk';
-import { terminalWidth, truncateToWidth, stringWidth } from '../lib/session/width.js';
-import { checkbox, confirm } from '@inquirer/prompts';
-import { isInteractiveTerminal } from './utils.js';
-import { assertValidSshTarget } from '../lib/ssh-exec.js';
-import { getProvider, listAllHosts, resolveHost } from '../lib/hosts/registry.js';
-import { getDevice } from '../lib/devices/registry.js';
-import { hostIdentityArgs, sshTargetFor } from '../lib/hosts/types.js';
-import { listSshConfigHosts, listKnownHosts, isSshConfigHost } from '../lib/hosts/ssh-config.js';
-import { probeHost, remoteAgentsVersion, bootstrapAgentsCli, localCliVersion, } from '../lib/hosts/ready.js';
-import { resolveRemoteOsSync } from '../lib/hosts/remote-os.js';
-import { listTasks, loadTask, findTaskByName, findTaskBySessionId, resolveTaskRef } from '../lib/hosts/tasks.js';
-import { reconcileRunningTasks } from '../lib/hosts/reconcile.js';
-import { showHostTaskLog } from '../lib/hosts/logs.js';
-import { stopDispatchedTask } from '../lib/hosts/dispatch.js';
-/** Parse `user@host` or `host` into its pieces. */
-function parseTarget(target) {
-    const at = target.indexOf('@');
-    if (at === -1)
-        return { address: target };
-    return { user: target.slice(0, at), address: target.slice(at + 1) };
-}
-/**
- * Bootstrap/verify agents-cli on a freshly-enrolled host (best-effort, prompts).
- * Callers that just probed the host pass the result through to avoid a second,
- * redundant `uname` round-trip; otherwise we probe here.
- */
-async function maybeBootstrap(target, hostName, probe = probeHost(target, resolveRemoteOsSync(hostName))) {
-    if (!probe.reachable) {
-        console.log(chalk.yellow(`  Not reachable over SSH yet — skipping bootstrap. Fix key auth, then: agents hosts check ${hostName}`));
-        return;
-    }
-    // Prefer the OS the probe just observed; fall back to the registry hint.
-    const os = probe.os ?? resolveRemoteOsSync(hostName);
-    const remoteVer = remoteAgentsVersion(target, os);
-    const localVer = localCliVersion();
-    if (!remoteVer) {
-        // Non-TTY: this is a best-effort bootstrap prompt, so report and return
-        // instead of hanging on confirm() in a headless/piped shell.
-        if (!isInteractiveTerminal()) {
-            console.log(chalk.gray(`  agents-cli not found on ${hostName} — install it there, then: agents hosts check ${hostName}`));
-            return;
-        }
-        const ok = await confirm({ message: `  agents-cli not found on ${hostName}. Install ${localVer ? `v${localVer}` : 'latest'} now?`, default: true });
-        if (ok) {
-            console.log(chalk.gray('  Installing agents-cli on the host…'));
-            const r = bootstrapAgentsCli(target, localVer, os);
-            console.log(r.ok ? chalk.green('  Installed.') : chalk.red(`  Install failed:\n${r.output}`));
-        }
-        return;
-    }
-    const remoteClean = remoteVer.replace(/^v/, '');
-    if (localVer && remoteClean !== localVer) {
-        if (!isInteractiveTerminal()) {
-            console.log(chalk.gray(`  ${hostName} has agents-cli ${remoteClean}, you have ${localVer} — versions differ; upgrade the host to match when convenient.`));
-            return;
-        }
-        const ok = await confirm({ message: `  ${hostName} has agents-cli ${remoteClean}, you have ${localVer}. Upgrade to match?`, default: false });
-        if (ok) {
-            const r = bootstrapAgentsCli(target, localVer, os);
-            console.log(r.ok ? chalk.green('  Upgraded.') : chalk.red(`  Upgrade failed:\n${r.output}`));
-        }
-    }
-}
-async function registerHost(spec) {
-    const provider = getProvider('local');
-    await provider.register(spec);
-}
-async function doAdd(name, target, opts) {
-    // No name + no target → interactive scan of ssh sources.
-    if (!name && !target) {
-        const existing = new Set((await listAllHosts()).filter((h) => h.enrolled).map((h) => h.name));
-        const candidates = [...new Set([...listSshConfigHosts(), ...listKnownHosts()])].filter((c) => !existing.has(c));
-        if (candidates.length === 0) {
-            console.log(chalk.yellow('No SSH hosts found in ~/.ssh/config or ~/.ssh/known_hosts. Add one explicitly: agents hosts add <name> <user@host>'));
-            return;
-        }
-        const picked = await checkbox({
-            message: 'Select hosts to enroll (connection details come from ~/.ssh/config)',
-            choices: candidates.map((c) => ({ value: c, name: c })),
-        });
-        for (const c of picked) {
-            // The ssh target is the candidate name itself either way: ssh resolves it
-            // for ssh-config hosts, and it's a reachable hostname for known_hosts ones.
-            const source = isSshConfigHost(c) ? 'ssh-config' : 'inline';
-            const probe = probeHost(c);
-            await registerHost({ name: c, provider: 'local', source, ...(source === 'inline' ? { address: c } : {}), os: probe.os, caps: opts.cap });
-            console.log(chalk.green(`Enrolled ${c}`) + chalk.gray(` (${source}${probe.os ? `, ${probe.os}` : ''})`));
-            if (opts.enroll !== false)
-                await maybeBootstrap(c, c, probe);
-        }
-        return;
-    }
-    if (!name) {
-        console.log(chalk.red('Usage: agents hosts add <name> [user@host]'));
-        process.exitCode = 1;
-        return;
-    }
-    let spec;
-    let sshTarget = '';
-    if (target) {
-        assertValidSshTarget(target);
-        const { address, user } = parseTarget(target);
-        spec = { name, provider: 'local', source: 'inline', address, user, caps: opts.cap, os: opts.os };
-        sshTarget = target;
-    }
-    else if (isSshConfigHost(name)) {
-        spec = { name, provider: 'local', source: 'ssh-config', caps: opts.cap, os: opts.os };
-        sshTarget = name;
-    }
-    else {
-        // A registered device enrolls with no target — connection details come from
-        // the device profile. The main reason to enroll one at all is the overlay
-        // metadata (capability tags); plain dispatch already works via the devices
-        // provider.
-        const device = await getDevice(name);
-        if (device && device.auth.method !== 'password') {
-            const address = device.address.dnsName ?? device.address.ip;
-            if (address) {
-                spec = {
-                    name,
-                    provider: 'local',
-                    source: 'inline',
-                    address,
-                    user: device.user,
-                    caps: opts.cap,
-                    os: opts.os ?? (device.platform !== 'unknown' ? device.platform : undefined),
-                };
-                sshTarget = device.user ? `${device.user}@${address}` : address;
-            }
-        }
-        if (!spec) {
-            if (device?.auth.method === 'password') {
-                console.log(chalk.red(`Device "${name}" uses password auth — dispatch needs key auth. Switch it first: agents devices set ${name} --auth key`));
-            }
-            else {
-                console.log(chalk.red(`"${name}" is not in ~/.ssh/config or the devices registry. Pass a target: agents hosts add ${name} <user@host>`));
-            }
-            process.exitCode = 1;
-            return;
-        }
-    }
-    const probe = probeHost(sshTarget);
-    if (!spec.os && probe.os)
-        spec.os = probe.os;
-    await registerHost(spec);
-    console.log(chalk.green(`Enrolled ${name}`) + chalk.gray(` (${spec.source}${spec.os ? `, ${spec.os}` : ''}${spec.caps?.length ? `, caps: ${spec.caps.join(',')}` : ''})`));
-    if (opts.enroll !== false)
-        await maybeBootstrap(sshTarget, name, probe);
-}
-async function doList(json) {
-    const hosts = await listAllHosts();
-    if (json) {
-        console.log(JSON.stringify(hosts, null, 2));
-        return;
-    }
-    if (hosts.length === 0) {
-        console.log(chalk.gray('No hosts. Enroll one: agents hosts add <name> <user@host>  (or just: agents hosts add)'));
-        return;
-    }
-    console.log(chalk.bold('NAME').padEnd(20) + chalk.bold('SOURCE').padEnd(13) + chalk.bold('TARGET').padEnd(28) + chalk.bold('CAPS'));
-    for (const h of hosts) {
-        const tgt = h.source === 'ssh-config' ? chalk.gray('(ssh-config)') : `${h.user ? h.user + '@' : ''}${h.address ?? ''}`;
-        // Cap TARGET at its column so a long user@host can't shove CAPS out of alignment.
-        const tgtW = stringWidth(tgt);
-        const tgtCol = tgtW > 28 ? truncateToWidth(tgt, 28) : tgt + ' '.repeat(28 - tgtW);
-        // Devices surface their registry as SOURCE (they're synced, not enrolled here).
-        const source = h.provider === 'devices' ? 'devices' : h.source;
-        const mark = h.dispatchable === false
-            ? chalk.yellow(' ·password-auth (no dispatch)')
-            : h.enrolled ? '' : chalk.gray(' ·available');
-        console.log(h.name.padEnd(20) + source.padEnd(13) + tgtCol + (h.caps?.join(',') ?? '') + mark);
-    }
-}
-async function doCheck(name) {
-    const host = await resolveHost(name);
-    if (!host) {
-        console.log(chalk.red(`Unknown host "${name}". Known: ${(await listAllHosts()).map((h) => h.name).join(', ') || '(none)'}`));
-        process.exitCode = 1;
-        return;
-    }
-    const target = sshTargetFor(host);
-    const os = host.os ?? resolveRemoteOsSync(name);
-    process.stdout.write(`Probing ${chalk.cyan(name)} (${target})… `);
-    const identityArgs = hostIdentityArgs(host);
-    const probe = probeHost(target, os, identityArgs);
-    if (!probe.reachable) {
-        console.log(chalk.red('unreachable'));
-        process.exitCode = 1;
-        return;
-    }
-    console.log(chalk.green('reachable') + chalk.gray(probe.os ? ` · ${probe.os}` : ''));
-    const ver = remoteAgentsVersion(target, probe.os ?? os, identityArgs);
-    console.log(`  agents-cli: ${ver ? chalk.green(ver) : chalk.yellow('not installed')}`);
-}
-async function doRemove(name) {
-    const host = await resolveHost(name);
-    if (!host || !host.enrolled) {
-        console.log(chalk.yellow(`"${name}" is not enrolled (nothing to remove).`));
-        return;
-    }
-    if (host.provider === 'devices') {
-        // The devices registry owns this entry — hosts remove would silently no-op.
-        console.log(chalk.yellow(`"${name}" comes from the devices registry. Remove it there: agents devices rm ${name}`));
-        process.exitCode = 1;
-        return;
-    }
-    await getProvider('local').remove(name);
-    console.log(chalk.green(`Removed ${name}`));
-}
-async function doPs(json) {
-    // Heal any 'running' record whose local follower died (dropped connection,
-    // laptop sleep) against the remote `.exit` before listing, so `ps` never shows
-    // a finished run stuck at 'running'.
-    const tasks = reconcileRunningTasks(listTasks());
-    if (json) {
-        console.log(JSON.stringify(tasks, null, 2));
-        return;
-    }
-    if (tasks.length === 0) {
-        console.log(chalk.gray('No host tasks yet. Dispatch one: agents run <agent> "<task>" --host <name>'));
-        return;
-    }
-    const cols = terminalWidth();
-    console.log(chalk.bold('ID').padEnd(11) + chalk.bold('NAME').padEnd(16) + chalk.bold('HOST').padEnd(16) + chalk.bold('AGENT').padEnd(10) + chalk.bold('STATUS').padEnd(11) + chalk.bold('PROMPT'));
-    for (const t of tasks) {
-        const status = t.status === 'completed' ? chalk.green(t.status) : t.status === 'failed' ? chalk.red(t.status) : chalk.yellow(t.status);
-        const nameCol = truncateToWidth(t.name ?? chalk.gray('-'), 15).padEnd(16);
-        // Prompt fills the remaining width instead of a fixed 50-char byte slice (98-char rows).
-        const promptCol = truncateToWidth(t.prompt, Math.max(12, cols - (11 + 16 + 16 + 10 + 11)));
-        console.log(t.id.padEnd(11) + nameCol + t.host.padEnd(16) + t.agent.padEnd(10) + status.padEnd(11) + promptCol);
-    }
-}
-async function doLogs(ref, follow, full) {
-    // Resolve the ref as a task id first, then fall back to a `--name` handle so
-    // `agents hosts logs <name>` works, not just the opaque id.
-    const id = loadTask(ref) ? ref : (findTaskByName(ref)?.id ?? findTaskBySessionId(ref)?.id ?? ref);
-    const res = await showHostTaskLog(id, follow, full);
-    if (!res.found) {
-        console.log(chalk.red(`Unknown task "${ref}".`));
-        process.exitCode = 1;
-        return;
-    }
-    if (res.exitCode !== undefined)
-        process.exitCode = res.exitCode;
-}
-async function doStop(ref) {
-    // Heal first so we don't try to kill a process that already exited.
-    const current = resolveTaskRef(ref);
-    if (!current) {
-        console.log(chalk.red(`Unknown task "${ref}".`));
-        process.exitCode = 1;
-        return;
-    }
-    const task = reconcileRunningTasks([current])[0] ?? current;
-    if (task.status !== 'running') {
-        console.log(chalk.gray(`Task ${task.id} is already ${task.status}` + (task.exitCode !== undefined ? ` (exit ${task.exitCode})` : '') + '.'));
-        return;
-    }
-    try {
-        const stopped = stopDispatchedTask(task);
-        const statusColor = stopped.status === 'completed' ? chalk.green : chalk.yellow;
-        const exitNote = stopped.exitCode === 143
-            ? 'exit 143 / SIGTERM'
-            : stopped.exitCode !== undefined
-                ? `exit ${stopped.exitCode}`
-                : stopped.status;
-        console.log(chalk.green(`Stopped ${stopped.id}`) +
-            chalk.gray(` on ${stopped.host}`) +
-            '  ' + statusColor(stopped.status) +
-            chalk.gray(` (${exitNote})`));
-        console.log(chalk.gray(`Logs: agents hosts logs ${stopped.id}`));
-    }
-    catch (err) {
-        console.error(chalk.red(err?.message ?? err));
-        process.exitCode = 1;
-    }
-}
-/** Register the `agents hosts` command tree. */
-export function registerHostsCommand(program) {
-    const hosts = program
-        .command('hosts')
-        .description('Register and inspect agent hosts (machines you offload runs to with `agents run --host <name>`).');
-    hosts
-        .command('add [name] [target]')
-        .description('Enroll a host. With no args, pick from ~/.ssh/config + known_hosts. `target` is user@host for hosts not in ssh config.')
-        .option('--cap <cap...>', 'Capability tag(s) for routing (e.g. --cap gpu)')
-        .option('--os <os>', 'Override detected OS label')
-        .option('--no-enroll', 'Register only — skip the remote agents-cli bootstrap/version check')
-        .action((name, target, opts) => doAdd(name, target, opts));
-    hosts
-        .command('list')
-        .alias('ls')
-        .description('List enrolled + ssh-config hosts (metadata only, no probing).')
-        .option('--json', 'Output JSON')
-        .action((opts) => doList(!!opts.json));
-    hosts
-        .command('check <name>')
-        .description('Probe one host: reachable? agents-cli version?')
-        .action((name) => doCheck(name));
-    hosts
-        .command('remove <name>')
-        .alias('rm')
-        .description('Remove a host from the registry (does not touch ~/.ssh/config).')
-        .action((name) => doRemove(name));
-    hosts
-        .command('ps')
-        .description('List dispatched host tasks.')
-        .option('--json', 'Output JSON')
-        .action((opts) => doPs(!!opts.json));
-    hosts
-        .command('logs <id>')
-        .description('Show a host task’s concise summary; --full for the raw log, -f to follow a running one.')
-        .option('-f, --follow', 'Follow live output')
-        .option('-m, --full', 'Show the full raw combined-stdout log instead of the concise summary')
-        .action((id, opts) => doLogs(id, !!opts.follow, !!opts.full));
-    hosts
-        .command('stop <id>')
-        .alias('kill')
-        .description('Terminate a running host task from this machine (SIGTERM process group; marks failed/143).')
-        .action((id) => doStop(id));
-}

package/dist/commands/lock.d.ts

@@ -1,12 +0,0 @@
-/**
- * `agents lock` — write a deterministic `agents.lock` for the resolved resource
- * set at the project root; `agents lock --frozen` verifies the live resources
- * match that lock EXACTLY and fails closed (non-zero exit + a clear diff) on any
- * drift. The reproducible-CI slice of governance #337.
- *
- * This is OFF the default path: normal `agents add` / `agents sync` never touch
- * the lock. Generation and verification only run when this command is invoked.
- */
-import { Command } from 'commander';
-/** Register the `agents lock` command. */
-export declare function registerLockCommand(program: Command): void;

package/dist/commands/lock.js

@@ -1,70 +0,0 @@
-/**
- * `agents lock` — write a deterministic `agents.lock` for the resolved resource
- * set at the project root; `agents lock --frozen` verifies the live resources
- * match that lock EXACTLY and fails closed (non-zero exit + a clear diff) on any
- * drift. The reproducible-CI slice of governance #337.
- *
- * This is OFF the default path: normal `agents add` / `agents sync` never touch
- * the lock. Generation and verification only run when this command is invoked.
- */
-import chalk from 'chalk';
-import { enumerateLockSources, buildLock, writeLock, readLock, verifyLock, lockDiffIsClean, resolveProjectRoot, LOCK_FILENAME, } from '../lib/lock.js';
-/** Register the `agents lock` command. */
-export function registerLockCommand(program) {
-    program
-        .command('lock')
-        .summary('Write or verify agents.lock — a SHA-256 manifest of resolved resources')
-        .description('Capture a deterministic SHA-256 per resolved resource file (commands, skills, hooks, rules, mcp, permissions, subagents — project > user > system > extras) into an agents.lock at the project root.\n\n' +
-        'Run bare to (re)generate the lock. Pass --frozen to VERIFY the live resolved resources match an existing agents.lock exactly — it exits non-zero with an added/removed/changed diff on any mismatch, and errors if no lock exists yet. That is the reproducible-CI gate; normal installs and syncs are unaffected.')
-        .option('--cwd <path>', 'Working directory to resolve resources and the project root from')
-        .option('--frozen', 'Verify resolved resources match agents.lock exactly; fail (non-zero) on any drift', false)
-        .action((opts) => {
-        runLock(opts);
-    });
-}
-function runLock(opts) {
-    const cwd = opts.cwd || process.cwd();
-    const projectRoot = resolveProjectRoot(cwd);
-    const sources = enumerateLockSources(cwd);
-    if (opts.frozen) {
-        verifyFrozen(projectRoot, sources);
-        return;
-    }
-    const lock = buildLock(sources);
-    const written = writeLock(projectRoot, lock);
-    const count = Object.keys(lock.resources).length;
-    console.log(chalk.green(`Wrote ${LOCK_FILENAME}`) +
-        chalk.gray(` — ${count} resource file(s) → ${written}`));
-}
-function verifyFrozen(projectRoot, sources) {
-    let existing;
-    try {
-        existing = readLock(projectRoot);
-    }
-    catch (e) {
-        console.error(chalk.red(`agents lock --frozen: ${e.message}`));
-        process.exitCode = 1;
-        return;
-    }
-    if (!existing) {
-        console.error(chalk.red(`No ${LOCK_FILENAME} at ${projectRoot}.`));
-        console.error(chalk.gray('Generate one first: agents lock'));
-        process.exitCode = 1;
-        return;
-    }
-    const diff = verifyLock(existing, sources);
-    if (lockDiffIsClean(diff)) {
-        const count = Object.keys(existing.resources).length;
-        console.log(chalk.green(`✓ ${count} resource file(s) match ${LOCK_FILENAME}`));
-        return;
-    }
-    console.error(chalk.red(`✗ resources drifted from ${LOCK_FILENAME}:`));
-    for (const key of diff.changed)
-        console.error(chalk.yellow(`  changed  ${key}`));
-    for (const key of diff.added)
-        console.error(chalk.yellow(`  added    ${key}`));
-    for (const key of diff.removed)
-        console.error(chalk.yellow(`  removed  ${key}`));
-    console.error(chalk.gray('Re-lock once the change is intended: agents lock'));
-    process.exitCode = 1;
-}

package/dist/commands/pull.d.ts

@@ -1,17 +0,0 @@
-/**
- * Removed `agents pull` command.
- *
- * `agents pull` was a god-command bundling git fetch+ff with local
- * materialization (install CLIs, register MCP, sync resources, register hooks,
- * etc.). It is replaced by the explicit split:
- *
- *   - `agents repo pull <alias>`     — git fetch+ff on system / user / extra
- *   - `agents sync [--local] [agent]` — re-materialize installed version homes
- *   - `agents setup`                 — first-time bootstrap
- *
- * The command is kept registered so old muscle-memory invocations get a clear
- * redirect instead of an "unknown command" error.
- */
-import type { Command } from 'commander';
-/** Register the deprecated `agents pull` command as a hard-error redirect. */
-export declare function registerPullCommand(program: Command): void;

package/dist/commands/pull.js

@@ -1,39 +0,0 @@
-/**
- * Removed `agents pull` command.
- *
- * `agents pull` was a god-command bundling git fetch+ff with local
- * materialization (install CLIs, register MCP, sync resources, register hooks,
- * etc.). It is replaced by the explicit split:
- *
- *   - `agents repo pull <alias>`     — git fetch+ff on system / user / extra
- *   - `agents sync [--local] [agent]` — re-materialize installed version homes
- *   - `agents setup`                 — first-time bootstrap
- *
- * The command is kept registered so old muscle-memory invocations get a clear
- * redirect instead of an "unknown command" error.
- */
-import { setHelpSections } from '../lib/help.js';
-const REDIRECT = 'agents-cli: "agents pull" was removed.\n' +
-    '            Git pull a repo:   agents repo pull <alias>      (system | user | <extra>)\n' +
-    '            Re-materialize:    agents sync --local           (all agents; or: agents sync <agent>)\n' +
-    '            First-time setup:  agents setup\n\n';
-/** Register the deprecated `agents pull` command as a hard-error redirect. */
-export function registerPullCommand(program) {
-    const pullCmd = program
-        .command('pull [agent]')
-        .description('Removed. See `agents repo pull` + `agents sync`.')
-        .option('-y, --yes', '(no-op)')
-        .option('--skip-clis', '(no-op)');
-    setHelpSections(pullCmd, {
-        notes: `
-      Removed. Equivalents:
-        agents repo pull <alias>     git pull (system | user | extra)
-        agents sync --local          re-materialize version homes (or: agents sync <agent>)
-        agents setup                 first-time bootstrap
-    `,
-    });
-    pullCmd.action(() => {
-        process.stderr.write(REDIRECT);
-        process.exit(2);
-    });
-}

package/dist/commands/push.d.ts

@@ -1,14 +0,0 @@
-/**
- * Removed `agents push` command.
- *
- * `agents push` was previously the inverse of the god-command `agents pull` —
- * it pushed local commits in `~/.agents/` upstream. It is replaced by the
- * explicit `agents repo push <alias>` so the target repo is named, matching
- * the post-split `agents repo pull` shape.
- *
- * Kept registered so muscle-memory invocations (including `agents push --help`)
- * land on a clear redirect instead of cascading to the top-level help.
- */
-import type { Command } from 'commander';
-/** Register the deprecated `agents push` command as a hard-error redirect. */
-export declare function registerPushCommand(program: Command): void;

package/dist/commands/push.js

@@ -1,30 +0,0 @@
-/**
- * Removed `agents push` command.
- *
- * `agents push` was previously the inverse of the god-command `agents pull` —
- * it pushed local commits in `~/.agents/` upstream. It is replaced by the
- * explicit `agents repo push <alias>` so the target repo is named, matching
- * the post-split `agents repo pull` shape.
- *
- * Kept registered so muscle-memory invocations (including `agents push --help`)
- * land on a clear redirect instead of cascading to the top-level help.
- */
-import { setHelpSections } from '../lib/help.js';
-const REDIRECT = 'agents-cli: "agents push" was removed.\n' +
-    '            Git push a repo: agents repo push <alias>   (system | user | <extra>)\n\n';
-/** Register the deprecated `agents push` command as a hard-error redirect. */
-export function registerPushCommand(program) {
-    const pushCmd = program
-        .command('push [alias]')
-        .description('Removed. See `agents repo push`.');
-    setHelpSections(pushCmd, {
-        notes: `
-      Removed. Equivalent:
-        agents repo push <alias>     git push (system | user | extra)
-    `,
-    });
-    pushCmd.action(() => {
-        process.stderr.write(REDIRECT);
-        process.exit(2);
-    });
-}

package/dist/commands/set.d.ts

@@ -1,15 +0,0 @@
-/**
- * `agents set` — ergonomic top-level setter for per-agent/version run defaults.
- *
- * `agents set claude@2.1.220 --model opus-5` pins the default model (and/or
- * mode) that `agents run` uses for that agent version. It reads and writes the
- * same store as `agents defaults run set` (agents.yaml -> run.defaults), so the
- * two stay consistent — `set` is just the short front door.
- *
- *   agents set                          # list every configured default
- *   agents set claude@2.1.220           # show the default for one version
- *   agents set claude@2.1.220 --model opus-5
- *   agents set 'claude:*' --mode auto --model opus
- */
-import type { Command } from 'commander';
-export declare function registerSetCommand(program: Command): void;

package/dist/commands/set.js

@@ -1,79 +0,0 @@
-/**
- * `agents set` — ergonomic top-level setter for per-agent/version run defaults.
- *
- * `agents set claude@2.1.220 --model opus-5` pins the default model (and/or
- * mode) that `agents run` uses for that agent version. It reads and writes the
- * same store as `agents defaults run set` (agents.yaml -> run.defaults), so the
- * two stay consistent — `set` is just the short front door.
- *
- *   agents set                          # list every configured default
- *   agents set claude@2.1.220           # show the default for one version
- *   agents set claude@2.1.220 --model opus-5
- *   agents set 'claude:*' --mode auto --model opus
- */
-import chalk from 'chalk';
-import { setHelpSections } from '../lib/help.js';
-import { formatRunDefaultEntry, listRunDefaults, parseRunDefaultSelector, setRunDefault, } from '../lib/run-defaults.js';
-export function registerSetCommand(program) {
-    const set = program
-        .command('set [selector]')
-        .description('Set the default model/mode an agent version uses for `agents run`')
-        .option('--model <model>', 'Default model or model alias, forwarded via --model')
-        .option('--mode <mode>', "Default mode: plan, edit, auto, skip. 'full' accepted as alias for skip.")
-        .action((selector, options) => {
-        try {
-            const hasFlags = options.model !== undefined || options.mode !== undefined;
-            if (!selector) {
-                if (hasFlags) {
-                    throw new Error('Selector is required when passing --model/--mode. Example: agents set claude@2.1.220 --model opus-5');
-                }
-                const entries = listRunDefaults();
-                if (entries.length === 0) {
-                    console.log(chalk.gray('No agent defaults configured.'));
-                    console.log(chalk.gray('Set one with: agents set claude@2.1.220 --model opus-5'));
-                    return;
-                }
-                console.log(chalk.bold('Agent Defaults\n'));
-                for (const entry of entries) {
-                    console.log(`  ${formatRunDefaultEntry(entry)}`);
-                }
-                return;
-            }
-            if (!hasFlags) {
-                const parsed = parseRunDefaultSelector(selector);
-                const entry = listRunDefaults().find((e) => e.selector === parsed.selector);
-                if (!entry || (!entry.defaults.mode && !entry.defaults.model)) {
-                    console.log(chalk.gray(`No default set for ${parsed.selector}.`));
-                    console.log(chalk.gray(`Set one with: agents set ${selector} --model <model>`));
-                    return;
-                }
-                console.log(`  ${formatRunDefaultEntry(entry)}`);
-                return;
-            }
-            const entry = setRunDefault(selector, {
-                ...(options.mode !== undefined ? { mode: options.mode } : {}),
-                ...(options.model !== undefined ? { model: options.model } : {}),
-            });
-            console.log(chalk.green('Set default:'));
-            console.log(`  ${formatRunDefaultEntry(entry)}`);
-        }
-        catch (err) {
-            console.error(chalk.red(err.message));
-            process.exit(1);
-        }
-    });
-    setHelpSections(set, {
-        examples: `
-      agents set claude@2.1.220 --model opus-5
-      agents set 'claude:*' --mode auto --model opus
-      agents set claude@2.1.220
-      agents set
-    `,
-        notes: `
-      Selectors use <agent>@<version> or <agent>:<version>; * matches all versions.
-      Exact selectors override wildcard selectors field by field.
-      Writes the same store as 'agents defaults run set'. Explicit flags on
-      'agents run' always win over configured defaults.
-    `,
-    });
-}

package/dist/commands/setup-share.d.ts

@@ -1,17 +0,0 @@
-/**
- * `agents setup share` — interactive wizard to configure the `agents share`
- * endpoint (Cloudflare R2 + Worker). A friendly front door over the existing
- * `agents share setup` (provision) and `agents share join` flows, reusing their
- * exact logic so there is a single source of truth for provisioning.
- *
- * Idempotent: re-running shows the current endpoint and offers to reconfigure.
- */
-import type { Command } from 'commander';
-/**
- * Interactive share setup. Returns true if the user configured (or already had)
- * an endpoint, false if they skipped. Never throws on user cancel — callers
- * (the `agents setup` hub) rely on that to keep the fresh-machine flow going.
- */
-export declare function runShareWizard(): Promise<boolean>;
-/** Register `agents setup share` under the parent `setup` command. */
-export declare function registerSetupShareCommand(setupCmd: Command): void;