@phnx-labs/agents-cli 1.22.120 → 1.22.121

package/dist/commands/events.d.ts

@@ -1,30 +1,5 @@
-/**
- * `agents events` — read the unified event stream (the one ops/timeline product).
- *
- * One stream over BOTH operational events (`~/.agents/.history/events/YYYY-MM-DD/`:
- * every `agents <module> <cmd>` invocation plus typed events like secrets access,
- * browser/computer, daemon lifecycle, version installs) AND agent-semantic events
- * (per-session activity: plans, PRs, worktrees, sub-agents, artifacts). Run-dispatch
- * outcomes land here as `run.dispatched` (readable via `--include runs`).
- *
- * `agents events audit` and `agents logs` are thin aliases of this command.
- *
- * Filter with sessions-style `--include` / `--exclude` families (ops, activity,
- * commands, runs, security) plus field filters (`--module`, `--event`, …).
- */
 import type { Command } from 'commander';
-/**
- * Resolve `--limit` into a record cap. `0` means "no cap" — without it there is
- * no way to read the whole stream, and any aggregation (group-by failure, count
- * per module) silently ranks the newest 50 records instead of the real set.
- * A non-numeric or negative value is a usage error, not a quiet fallback.
- */
 export declare function resolveEventsLimit(raw: string | undefined): number | undefined;
-/**
- * Cap `fetched` (read with `limit + 1`) to `limit`, reporting whether records
- * were dropped. The caller announces the cap so a truncated read is never
- * mistaken for the complete set.
- */
 export declare function capRecords<T>(fetched: T[], limit: number | undefined): {
     records: T[];
     truncated: boolean;
@@ -45,17 +20,13 @@ export interface EventsOptions {
     include?: string;
     exclude?: string;
 }
-/** Add the one canonical event-reader option surface to a command or alias. */
 export declare function addEventsReadOptions(command: Command): Command;
-/** Canonical reader used by `agents events`, `agents events audit`, and `agents logs`. */
 export declare function runEventsCommand(options: EventsOptions, forceAudit?: boolean): Promise<void>;
-/** Shared by `events stats` and the `logs stats` alias. */
 export declare function runEventsStats(opts: {
     since?: string;
     json?: boolean;
 }): Promise<void>;
 export declare function registerEventsCommand(program: Command): void;
-/** Shared by `events rotate` and the `logs rotate` alias. */
 export declare function runEventsRotate(opts: {
     days?: string;
     maxMb?: string;

package/dist/commands/events.js

@@ -1,17 +1,3 @@
-/**
- * `agents events` — read the unified event stream (the one ops/timeline product).
- *
- * One stream over BOTH operational events (`~/.agents/.history/events/YYYY-MM-DD/`:
- * every `agents <module> <cmd>` invocation plus typed events like secrets access,
- * browser/computer, daemon lifecycle, version installs) AND agent-semantic events
- * (per-session activity: plans, PRs, worktrees, sub-agents, artifacts). Run-dispatch
- * outcomes land here as `run.dispatched` (readable via `--include runs`).
- *
- * `agents events audit` and `agents logs` are thin aliases of this command.
- *
- * Filter with sessions-style `--include` / `--exclude` families (ops, activity,
- * commands, runs, security) plus field filters (`--module`, `--event`, …).
- */
 import chalk from 'chalk';
 import * as fs from 'fs';
 import { getLogsPath, stats, rotate } from '../lib/feed/events.js';
@@ -20,34 +6,19 @@ import { parseFamilyList, EVENT_FAMILIES } from '../lib/event-families.js';
 import { ingestBatch } from '../lib/events-ingest.js';
 import { setHelpSections } from '../lib/help.js';
 import { registerAuditCommands } from './audit.js';
-/**
- * Resolve `--limit` into a record cap. `0` means "no cap" — without it there is
- * no way to read the whole stream, and any aggregation (group-by failure, count
- * per module) silently ranks the newest 50 records instead of the real set.
- * A non-numeric or negative value is a usage error, not a quiet fallback.
- */
 export function resolveEventsLimit(raw) {
     const token = raw ?? '50';
-    // Number('') and Number('   ') are both 0, which would read as "no cap" — an
-    // empty --limit (an unset "$LIMIT" in a script) must be rejected, not silently
-    // turned into the unbounded read.
     const value = token.trim() === '' ? NaN : Number(token);
     if (!Number.isInteger(value) || value < 0) {
         throw new RangeError(`Invalid --limit ${raw} — pass a whole number, or 0 for no cap.`);
     }
     return value === 0 ? undefined : value;
 }
-/**
- * Cap `fetched` (read with `limit + 1`) to `limit`, reporting whether records
- * were dropped. The caller announces the cap so a truncated read is never
- * mistaken for the complete set.
- */
 export function capRecords(fetched, limit) {
     if (limit === undefined || fetched.length <= limit)
         return { records: fetched, truncated: false };
     return { records: fetched.slice(0, limit), truncated: true };
 }
-/** Parse `--since`: relative offsets (30s/5m/2h/7d/4w) or an ISO/absolute date. */
 function parseSince(s) {
     const m = s.match(/^(\d+)([smhdw])$/);
     if (m) {
@@ -62,19 +33,16 @@ function parseSince(s) {
         throw new Error(`Invalid --since value: ${s} (use e.g. 2h, 7d, or an ISO date)`);
     return new Date(ms);
 }
-/** How the run reached this host — 'local' or 'ssh 203.0.113.7'. */
 function originLabel(r) {
     if (r.transport === 'ssh') {
         return chalk.yellow(`ssh${r.sshClientIp ? ' ' + r.sshClientIp : ''}`);
     }
     return chalk.gray('local');
 }
-/** The most useful one-line detail for a record, by event family. */
 function detailFor(r) {
     if (r.command)
         return r.command;
     const bits = [];
-    // Agent-semantic (activity) events carry detail/url instead of a command.
     if (typeof r.detail === 'string')
         bits.push(r.detail);
     if (typeof r.url === 'string')
@@ -87,7 +55,6 @@ function detailFor(r) {
         bits.push(`skill=${r.skill}`);
     if (typeof r.version === 'string')
         bits.push(`v=${r.version}`);
-    // run.dispatched (and similar) — mode / outcome / exit / repo are the audit line.
     if (typeof r.mode === 'string')
         bits.push(`mode=${r.mode}`);
     if (typeof r.outcome === 'string')
@@ -109,7 +76,6 @@ function renderRow(r) {
     const agent = r.agent ? chalk.gray(` ${r.agent}`) : '';
     return `${time}  ${originLabel(r).padEnd(24)} ${user.padEnd(22)} ${ev.padEnd(26)}${agent}  ${detailFor(r)}`;
 }
-/** Read all of stdin. Returns '' when nothing is piped. */
 async function readStdin() {
     if (process.stdin.isTTY)
         return '';
@@ -126,11 +92,6 @@ function registerEmitSubcommand(events) {
         .option('--dry-run', 'Validate and report without writing')
         .option('--json', 'Report {written, rejected} as JSON')
         .action(async (opts, cmd) => {
-        // The parent `events` command also declares `--json` (for its read view).
-        // Commander binds a flag declared on BOTH to the parent, so a bare
-        // `events emit … --json` lands on parent.opts().json and the child sees
-        // undefined — the human string would print where a caller expects JSON.
-        // Read both, same as `feed post`.
         const wantJson = Boolean(opts?.json ?? cmd?.parent?.opts?.().json);
         const input = await readStdin();
         if (input.trim() === '') {
@@ -159,8 +120,6 @@ function registerEmitSubcommand(events) {
             for (const r of result.rejected)
                 console.error(`  line ${r.line}: ${r.reason}`);
         }
-        // Valid siblings are already written; a non-zero exit reports that the
-        // batch was not fully accepted without pretending nothing landed.
         if (result.rejected.length > 0)
             process.exitCode = 1;
     });
@@ -194,7 +153,6 @@ function registerEmitSubcommand(events) {
     `,
     });
 }
-/** Add the one canonical event-reader option surface to a command or alias. */
 export function addEventsReadOptions(command) {
     command
         .option('--include <families>', `Only these families (comma-sep): ${EVENT_FAMILIES.join(', ')}`)
@@ -213,7 +171,6 @@ export function addEventsReadOptions(command) {
         .option('-f, --follow', "Tail today's operational log live");
     return command;
 }
-/** Canonical reader used by `agents events`, `agents events audit`, and `agents logs`. */
 export async function runEventsCommand(options, forceAudit = false) {
     if (options.follow) {
         await followLog();
@@ -239,8 +196,6 @@ export async function runEventsCommand(options, forceAudit = false) {
         process.exitCode = 2;
         return;
     }
-    // forceAudit (`events audit` / `logs`) = ops-only when no family flags. Families
-    // own the source selection via applyFamilies — never override includeActivity after.
     const includeActivity = (includeFamilies !== undefined || excludeFamilies !== undefined)
         ? true
         : !forceAudit;
@@ -293,7 +248,6 @@ function levelColor(level) {
         return chalk.gray(level);
     return chalk.blue(level);
 }
-/** Shared by `events stats` and the `logs stats` alias. */
 export async function runEventsStats(opts) {
     let days = 7;
     if (opts.since) {
@@ -357,8 +311,6 @@ Examples:
   agents events audit                    Alias of: events --include runs
   agents logs                            Run log viewer (also aliases events audit/stats/rotate)`)
         .action((_options, command) => runEventsCommand(command.optsWithGlobals()));
-    // `events` both reads (its own action, above) and writes (this subcommand) —
-    // the same shape as `feed` / `feed post`.
     registerEmitSubcommand(events);
     events
         .command('stats')
@@ -374,7 +326,6 @@ Examples:
         .action((opts) => runEventsRotate(opts));
     registerAuditCommands(events);
 }
-/** Shared by `events rotate` and the `logs rotate` alias. */
 export function runEventsRotate(opts) {
     const days = Math.max(1, parseInt(opts.days ?? '7', 10) || 7);
     const maxMb = Math.max(1, parseInt(opts.maxMb ?? '50', 10) || 50);
@@ -389,11 +340,9 @@ export function runEventsRotate(opts) {
         console.log(chalk.gray(`No event files removed (retention ${days} days, ceiling ${maxMb} MiB).`));
     }
 }
-/** commander repeatable-option collector. */
 function collect(value, previous) {
     return previous.concat([value]);
 }
-/** Tail today's event file, printing new lines as they land. */
 async function followLog() {
     let file = getLogsPath();
     let offset = 0;
@@ -401,7 +350,6 @@ async function followLog() {
         offset = fs.statSync(file).size;
     }
     catch {
-        // File may not exist yet — start at 0 and pick it up on first write.
     }
     console.log(chalk.gray(`Tailing ${file} — Ctrl-C to stop`));
     const drain = () => {
@@ -420,7 +368,7 @@ async function followLog() {
         }
         if (size <= offset) {
             if (size < offset)
-                offset = 0; // rotated/truncated
+                offset = 0;
             return;
         }
         const fd = fs.openSync(file, 'r');
@@ -433,7 +381,6 @@ async function followLog() {
                     console.log(renderRow(JSON.parse(line)));
                 }
                 catch {
-                    // Skip malformed lines.
                 }
             }
         }
@@ -441,7 +388,6 @@ async function followLog() {
             fs.closeSync(fd);
         }
     };
-    // Poll — simpler and more portable than fs.watch across platforms/editors.
     await new Promise(() => {
         setInterval(drain, 500);
     });

package/dist/commands/exec.d.ts

@@ -1,10 +1,3 @@
-/**
- * Agent execution command.
- *
- * Registers the `agents run` command which spawns agent CLIs interactively
- * or headlessly. Supports profile resolution, version rotation, secrets
- * injection, and multi-agent fallback chains for rate-limit resilience.
- */
 import { type Command } from 'commander';
 import type { ExecMode, ExecEffort } from '../lib/exec.js';
 import { RUN_AUTO_KEYWORD } from '../lib/types.js';
@@ -13,41 +6,30 @@ interface ExecCommandActionOptions {
     effort: ExecEffort;
     model?: string;
     cwd?: string;
-    /** --project <slug>[@worktree]: resolve cwd from the projects root shorthand. */
     project?: string;
     addDir: string[];
     env: string[];
     secrets: string[];
-    /** Commander maps `--no-auto-secrets` to `autoSecrets` (default true, false when passed). */
     autoSecrets?: boolean;
     json?: boolean;
     quiet?: boolean;
     headless?: boolean;
     interactive?: boolean;
-    /** --no-auth-check: Commander maps it to `authCheck` (default true, false when passed). Silences the logged-out preflight warning on an interactive launch. */
     authCheck?: boolean;
-    /** --resume [id]: string id/prefix, or `true` for the bare flag (interactive picker). */
     resume?: string | boolean;
     sessionId?: string;
-    /** --name <slug>: durable launch handle, resolvable via `agents sessions <name>`. */
     name?: string;
-    /** --notify: post a desktop notification when a headless run finishes. */
     notify?: boolean;
-    /** `--no-trace-sync` → commander maps it to `traceSync` (default true, false when passed). Skips the run-exit trace auto-sync for this run (PHNX-3628). */
     traceSync?: boolean;
-    /** --terminal [backend]: open this run in a terminal tab; `true` = auto-detect. */
     terminal?: string | boolean;
     verbose?: boolean;
     raw?: boolean;
-    /** `--no-tmux` → commander sets this false (default true) to bypass the tmux wrapper. */
     tmux?: boolean;
-    /** `--disable-tmux` → explicit alias of --no-tmux. */
     disableTmux?: boolean;
     timeout?: string;
     fallback?: string;
     balanced?: boolean;
     strategy?: string;
-    /** Restrict selection to a named provider account discovered from live version homes. */
     account?: string;
     /**
      * @deprecated Hidden alias for `--device auto`. Resolved before host dispatch.
@@ -86,18 +68,12 @@ interface ExecCommandActionOptions {
     secretsKeys?: string;
     allowExpired?: boolean;
     emitSessionId?: boolean;
-    /** --broadcast: matrix-run the same prompt/task across agents × models. */
     broadcast?: boolean;
-    /** --task <id>: house broadcast task (with --broadcast). */
     task?: string;
-    /** --list-tasks: list broadcast tasks. */
     listTasks?: boolean;
-    /** --results [run-id]: show saved broadcast runs. */
     results?: string | true;
-    /** --concurrency <n>: broadcast cell parallelism. */
     concurrency?: string;
 }
-/** Validate a caller-supplied session id before it reaches tmux, paths, indexes, or remote dispatch. */
 export declare function parseExplicitSessionId(value: string): string;
 export interface RunPickerMarkers {
     accountPicker: boolean;
@@ -106,38 +82,13 @@ export interface RunPickerMarkers {
     valid: boolean;
     reason?: string;
 }
-/**
- * Parse the trailing picker markers on an `agents run` agent spec. A terminal
- * run of `#`/`@` characters requests the account picker (`#`) and/or the
- * device picker (`@`) — each at most once, in either order (`claude#@`,
- * `claude@#`). Stripping them yields the normalized spec (`claude#work@` →
- * `claude#work`, version pins and `#label` account pins intact). A picker
- * cannot combine with an explicit pin of what it picks: `claude@2.1.218#`
- * (the account picker already chooses the version — the old `claude@2.1.218@`
- * rule), `claude#work#`, `claude@@`.
- */
 export declare function parseRunPickerMarkers(agentSpec: string): RunPickerMarkers;
-/**
- * The `--device` alias family — the flags that mean "dispatch this run to another
- * machine over SSH". `--device` is canonical; `--on`/`--computer` are hidden
- * aliases. Returns the values actually given (so callers can both test presence
- * and read the target). Kept in ONE place because a guard that listed only a
- * subset silently let `--terminal --device` open a local tab and drop the remote
- * target — the drift this predicate exists to prevent.
- */
 export declare function hostTargetGiven(options: {
     host?: string;
     device?: string;
     on?: string;
     computer?: string;
 }): string[];
-/**
- * Turn a host target that names THIS machine into an explicit local pin: the
- * host-family flags are cleared and `local` is set, so no dispatch path
- * self-SSHes and the bare-interactive default (`bareInteractiveRunDefaultsToDeviceAuto`)
- * sees a decided placement. Returns true when the pin was applied. Pure over
- * the `isSelf` predicate so the rule is testable without a device registry.
- */
 export declare function pinLocalWhenTargetIsSelf(options: {
     host?: string;
     device?: string;
@@ -145,11 +96,6 @@ export declare function pinLocalWhenTargetIsSelf(options: {
     computer?: string;
     local?: boolean;
 }, isSelf: (name: string) => boolean): boolean;
-/**
- * Return every option whose selection semantics conflict with an account
- * choice (`agent#`). Device routing is deliberately absent: the marker rides
- * the hop and the peer picks from ITS slots.
- */
 export declare function runAccountPickerConflicts(options: {
     resume?: string | boolean;
     strategy?: string;
@@ -162,11 +108,6 @@ export declare function runAccountPickerConflicts(options: {
     on?: string;
     computer?: string;
 }): string[];
-/**
- * Return every option that already decides where the run lands, so a device
- * choice (`agent@`) would be silently ignored: any explicit host flag, and the
- * lease/box paths, which own placement outright.
- */
 export declare function runDevicePickerConflicts(options: {
     lease?: string | boolean;
     box?: string;
@@ -177,19 +118,6 @@ export declare function runDevicePickerConflicts(options: {
     local?: boolean;
 }): string[];
 export { RUN_AUTO_KEYWORD };
-/**
- * Whether `run auto` should default its host layer to the affinity pick (the
- * same machinery as `--device auto`). False when the caller pinned any host
- * flag, and false when this process was itself dispatched by a host run —
- * the dispatcher exports AGENTS_RUN_AUTO_HOST_RESOLVED=1 into the remote SHELL
- * (hosts/dispatch.ts remoteRunShellPrelude) because it already resolved the
- * host layer, and re-picking here would chain-hop the run across the fleet.
- * An INTERACTIVE dispatch of a named harness also reaches the remote as a bare
- * `agents run <harness>` (its argv forwards without the routing flag), so the
- * interactive prelude's AGENTS_REMOTE_INTERACTIVE=1 counts as "already placed"
- * too — without it the remote would re-place the run and ping-pong across the
- * fleet. Pure so the pinning matrix is unit-testable.
- */
 export declare function runAutoDefaultsToAffinity(options: {
     host?: string;
     device?: string;
@@ -197,27 +125,6 @@ export declare function runAutoDefaultsToAffinity(options: {
     computer?: string;
     local?: boolean;
 }, env?: NodeJS.ProcessEnv): boolean;
-/**
- * Whether a bare human-facing `agents run <harness>` — no prompt, so an
- * interactive TUI run — defaults its placement to `--device auto` (PHNX-4083).
- * A marker left off is decided for you: no `#` means balanced rotation, and no
- * `@` (and no other placement flag) now means automatic device placement — the
- * same engine as `--device auto`, whose pool never contains a box marked
- * `personal`. ALL of these must hold:
- *
- * - no prompt (headless runs — teams, routines, hooks, `run <agent> "…"` —
- *   keep running in place, unchanged);
- * - a human-facing surface: a real TTY and no `--json`. This is the same
- *   two-condition gate `signInLaunchDecision` uses in run-account-picker.ts —
- *   reused here through isHumanFacingRun, not re-derived;
- * - no device-picker marker (`agent@` already chose the device; picking this
- *   machine there is a plain local run);
- * - no `--resume` / `--lease` / `--box` / `--cloud` (those own placement);
- * - the host layer is unpinned and this process is not itself a dispatched
- *   hop — delegated to runAutoDefaultsToAffinity, which encodes both.
- *
- * Pure so the default-placement matrix is unit-testable.
- */
 export declare function bareInteractiveRunDefaultsToDeviceAuto(options: {
     host?: string;
     device?: string;
@@ -235,60 +142,18 @@ export declare function bareInteractiveRunDefaultsToDeviceAuto(options: {
     tty: boolean;
     json?: boolean;
 }, env?: NodeJS.ProcessEnv): boolean;
-/**
- * Whether an interactive host dispatch must mint a correlation launch id and
- * resolve the remote session via the launch-id join (RUSH-2034), rather than
- * trusting a pre-known session id. `run auto` ALWAYS joins: the harness is
- * picked on the remote, so an explicit --session-id is only adopted when the
- * pick lands on claude — pre-registering it would strand a stale session-index
- * entry naming an id a non-claude pick never used (RUSH-2132). Pure so the
- * decision matrix is unit-testable.
- */
 export declare function hostInteractiveNeedsCorrelationId(runAgent: string, hostSessionId: string | undefined, resumeId: string | undefined): boolean;
-/**
- * Whether `cwd` is inside a git work tree.
- *
- * `--lease` / `--box` sync the working directory to the box through crabbox,
- * which enumerates the files to copy with `git ls-files`. Outside a git repo
- * that exits 128 (`fatal: not a git repository`) and the whole run dies at
- * "build sync file list: exit status 128" — AFTER the box is provisioned and
- * billed. Checking this up front lets the caller fail fast, before provisioning.
- */
 export declare function isInsideGitWorkTree(cwd: string): boolean;
-/** Absolute git toplevel for `cwd`, or null when it is not a git repo. */
 export declare function gitToplevel(cwd: string): string | null;
-/**
- * Network mode for a `--lease` run (F5, RUSH-1924). `--tailscale` forces the
- * tailnet, `--no-tailscale` forces public, and neither (undefined) defaults to
- * the tailnet ONLY in a reuse context (`--reuse`, `--box`, or a picked warm
- * box) — a one-shot solo `--lease` stays public. Pure so it is unit-testable;
- * the caller downgrades to `'public'` when no auth key is configured.
- */
 export declare function computeNetMode(opts: {
     tailscale?: boolean;
     reuseContext: boolean;
 }): 'public' | 'tailscale';
-/** True when `repoRoot` is in the remembered always-fresh set. Pure. */
 export declare function isAlwaysFreshRepo(repos: string[], repoRoot: string): boolean;
-/** Add `repoRoot` to the always-fresh set (idempotent). Pure. */
 export declare function addAlwaysFreshRepo(repos: string[], repoRoot: string): string[];
-/** Path to the always-fresh state file under the USER agents dir (CLI-written per-user preference, never the maintainer-owned `.system` repo). */
 export declare function leaseFreshReposPath(): string;
-/** Read the remembered always-fresh repo roots (empty on any read/parse error). */
 export declare function readAlwaysFreshRepos(): string[];
-/** Persist the always-fresh repo roots. Best-effort — never throws. */
 export declare function writeAlwaysFreshRepos(repos: string[]): void;
-/**
- * Build the LoopConfig the driver consumes from CLI flags and/or a workflow's
- * `loop:` frontmatter block (issue #332). Returns undefined when neither source
- * activates a loop (the common single-shot run). CLI flags take precedence over
- * the workflow's declared values field-by-field, so `--max-iterations 5`
- * overrides a workflow's `max_iterations: 3`.
- *
- * `--loop` with no sub-options is a valid bare loop (driver applies its own
- * maxIterations safety cap). A workflow `loop:` block activates a loop even
- * without `--loop` so `agents run <workflow>` honors a declared loop.
- */
 export declare function buildLoopConfig(flags: {
     loop?: boolean;
     maxIterations?: string;
@@ -296,41 +161,13 @@ export declare function buildLoopConfig(flags: {
     until?: string;
     interval?: string;
 }, workflowLoop?: import('../lib/workflows.js').LoopConfigRaw): import('../lib/loop.js').LoopConfig | undefined;
-/** Map a loop stop reason to a process exit code. condition-met/max are clean exits. */
 export declare function loopExitCode(stoppedBy: import('../lib/loop.js').LoopStoppedBy): number;
-/**
- * Drive a workflow's declarative `for_each:` fan-out end-to-end (issue #343).
- *
- * Runs the producer, expands one stage teammate per produced item (respecting
- * `max_items` / `DEFAULT_FOR_EACH_CAP`, surfacing any truncation — never a
- * silent cap), stages them into a fresh team via the existing `runForEach`
- * bridge, then drives the teams supervisor until the DAG drains. When a verify
- * panel is declared, tallies each item's `keep_if` gate from the skeptics'
- * terminal status and logs which items survived.
- *
- * Reuses the teams substrate wholesale — no new orchestration engine. Returns
- * the process exit code (0 on drain, 1 on producer failure / non-drain).
- */
 export declare function runWorkflowForEach(spec: import('../lib/workflows.js').ForEachSpec, opts: {
     workflowName: string;
     cwd: string;
     effort?: ExecEffort;
 }): Promise<number>;
-/**
- * The run's working directory from `--cwd` / `--project`. `--project <slug>` owns
- * the directory and is mutually exclusive with `--cwd`/`--remote-cwd`; both the
- * main dispatch and the `--terminal` handoff need the same answer, so the rule
- * and its error live here once instead of in two places that can drift.
- *
- * A project that binds several directories also contributes the ones it is not
- * landing in as `--add-dir` grants, so an agent on a multi-repo project can
- * actually reach the sibling checkouts. Claude / Cursor / Kimi take the native
- * flag; Codex folds them into workspace_roots; Grok widens its sandbox profile
- * (and always injects a rules note). Other harnesses have no multi-root surface
- * and ignore the grants (cwd only).
- */
 export declare function resolveRunCwd(options: Pick<ExecCommandActionOptions, 'cwd' | 'project' | 'remoteCwd' | 'addDir'>, opts: {
     forRemote: boolean;
 }): Promise<string | undefined>;
-/** Register the `agents run <agent> [prompt]` command. */
 export declare function registerRunCommand(program: Command): void;