@phnx-labs/agents-cli 1.22.119 → 1.22.121

package/dist/commands/harness-wizard.d.ts

@@ -1,49 +1,13 @@
-/**
- * Shared interactive step engine for `agents harness` create + edit.
- *
- * A single engine drives BOTH the create wizard (`agents harness add`/`fork`,
- * previously `runHarnessWizard`) and the new edit wizard (`agents harness edit`,
- * which was flag-only before). A "step" is a self-contained unit — decide whether
- * it runs for the current draft, then prompt/validate/apply — so the two modes
- * differ only in their step list, not in the runner.
- *
- * Design goals (RUSH-2219, parent RUSH-2218):
- *   - One runner, two modes. `create` builds a new harness from a source; `edit`
- *     loads an existing profile and re-asks each field pre-filled with its value.
- *   - Every step is skippable. A flag that already supplied the value pre-fills
- *     the draft and its step is not re-asked — so non-interactive scripting via
- *     flags is unchanged and the wizard only asks for what is missing.
- *   - Pure and injectable. The engine talks to the user through {@link WizardIO},
- *     an injected seam. Tests drive a scripted fake IO and assert which steps ran,
- *     with no TTY. {@link defaultWizardIO} is the production driver over
- *     `@inquirer/prompts`.
- *   - Typed extension points, not stubs. The three sibling subtasks plug in via
- *     {@link WizardHooks} without editing the engine: RUSH-2220 (model catalog +
- *     secrets surface) via `pickModel`, RUSH-2221 (connection test) via
- *     `connectionTest`, RUSH-2222 (edit matrix) via `editable`. Each hook is a
- *     real no-op extension point — absent, the scaffold falls back to today's
- *     behavior (free-text model, no test, resolver-sourced editability). None of
- *     them fakes a result. RUSH-2223 (cross-host portability, `fork --to-host`)
- *     extends the create source step; the seam is `HarnessDraft.toHost`.
- */
 import type { AgentId } from '../lib/types.js';
 import { type Profile } from '../lib/profiles.js';
 import type { ConnectionTestResult } from '../lib/harness-connection-test.js';
 export type { ConnectionTestResult } from '../lib/harness-connection-test.js';
-/** Whether the wizard is creating a new harness or editing an existing one. */
 export type WizardMode = 'create' | 'edit';
-/** A single `select` choice. `disabled` greys the row (used by the edit matrix). */
 export interface WizardChoice<T> {
     name: string;
     value: T;
     disabled?: boolean | string;
 }
-/**
- * The prompt seam the engine drives. Injected so the engine is testable with no
- * TTY: the production implementation ({@link defaultWizardIO}) wraps
- * `@inquirer/prompts`; a test passes a scripted fake that records calls and
- * returns canned answers.
- */
 export interface WizardIO {
     select<T>(opts: {
         message: string;
@@ -62,68 +26,36 @@ export interface WizardIO {
         message: string;
         default?: boolean;
     }): Promise<boolean>;
-    /** Emit an informational line — a disabled field's reason, or a preset note. */
     note(message: string): void;
 }
-/**
- * The mutable draft threaded through every step. It is a superset of both modes'
- * fields; a step reads what it needs and records its answer here. `create` maps
- * the finished draft into `{ source, name, opts }` for `runForkFlow`; `edit` maps
- * it into the `EditOptions` shape the flag-driven edit path already persists — so
- * a wizard-built and a hand-written harness are byte-identical after save.
- */
 export interface HarnessDraft {
     readonly mode: WizardMode;
-    /** create: the fork source (a native agent id or an existing harness name). */
     source?: string;
-    /** The resolved host CLI — drives the editability seams. edit: the profile host. */
     host?: AgentId;
     name?: string;
     model?: string;
     baseUrl?: string;
     authProvider?: string;
     account?: string;
-    /** `<bundle>` or `<bundle>:<key>` — a value copied out of an agents secrets bundle. */
     fromSecrets?: string;
     version?: string;
     description?: string;
     fallbackModel?: string;
-    /** edit: the profile being edited, providing current values. Read-only. */
     readonly original?: Profile;
-    /**
-     * RUSH-2223 seam (cross-host portability): the target host to re-key a cloned
-     * harness onto (`fork --to-host <host>`). The scaffold never sets it; the
-     * portability subtask reads it in an extended source step. Left here so the
-     * draft shape is stable when that lands.
-     */
     toHost?: AgentId;
-    /** The user chose "build custom" over a preset (create only). */
     custom?: boolean;
-    /** The preset a create run selected, if any. */
     preset?: string;
-    /** Pre-computed default for the name prompt (source or preset name). */
     defaultName?: string;
-    /** The provider step has run (distinguishes "no auth chosen" from "not asked"). */
     providerAsked?: boolean;
 }
-/**
- * What the engine does with a step for a given draft:
- *   - `'run'`             prompt the user, validate, and apply into the draft.
- *   - `'skip'`            value already supplied (by a flag) or step N/A — silent.
- *   - `{ disabled: … }`   the step does not apply to this host; surface the reason
- *                         (the field reads as greyed/disabled) but do not prompt.
- *                         This is the seam the edit matrix (RUSH-2222) drives.
- */
 export type StepDecision = 'run' | 'skip' | {
     disabled: string;
 };
-/** One wizard step: decide, then (only when decided `'run'`) prompt + apply. */
 export interface WizardStep {
     readonly id: string;
     decide(draft: HarnessDraft): StepDecision;
     run(io: WizardIO, draft: HarnessDraft, hooks: WizardHooks): Promise<void>;
 }
-/** Per-host editability — which params this host's API format lets you change. */
 export interface HarnessEditable {
     model: boolean;
     baseUrl: boolean;
@@ -131,13 +63,10 @@ export interface HarnessEditable {
     version: boolean;
     fallback: boolean;
 }
-/** One field's editability plus, when disabled, the one-line reason to surface. */
 interface EditableField {
     enabled: boolean;
-    /** Set only when `enabled` is false — the greyed field's stated reason. */
     reason?: string;
 }
-/** Per-host editability with a reason attached to every disabled field. */
 interface HarnessEditability {
     model: EditableField;
     baseUrl: EditableField;
@@ -145,82 +74,16 @@ interface HarnessEditability {
     version: EditableField;
     fallback: EditableField;
 }
-/**
- * The per-harness editability matrix (RUSH-2222). Which of a harness's params
- * this host's API format actually lets you change, each disabled field carrying
- * the reason the wizard greys it with.
- *
- * Sourced ENTIRELY from the same maps the run-time resolver reads —
- * `baseUrlEnvKeyForHost` (endpoint slot), `authEnvKeyForHost` (auth env), and
- * `isSelfUpdatingAgent` (pinnable version) — never a table hardcoded alongside
- * them, so the wizard's enable/disable can never drift from what a run actually
- * honors (repo rule: the capability table stays truthful, in lockstep with the
- * code). A disabled param is never a silent no-op — the wizard shows its reason
- * and the flag path fails loud (`forkProfile`'s base-URL throw is the precedent).
- */
 export declare function harnessEditable(host: AgentId): HarnessEditability;
-/**
- * The boolean projection of {@link harnessEditable} — the scaffold default behind
- * the RUSH-2222 {@link WizardHooks.editable} seam. Derived from the reason-carrying
- * matrix so the two can never disagree.
- */
 export declare function defaultEditable(host: AgentId): HarnessEditable;
-/**
- * Extension points the sibling subtasks fill without touching the engine. Each is
- * a real no-op-by-default seam: absent, the scaffold uses today's behavior; none
- * fabricates a result.
- */
 export interface WizardHooks {
-    /**
-     * RUSH-2220 — model catalog pick. Given the resolved host (+ version and the
-     * current value in edit), return a chosen model id, or `null` to fall through
-     * to the free-text prompt. Absent → always free-text (today's behavior).
-     */
     pickModel?: (io: WizardIO, host: AgentId | undefined, version: string | undefined, current: string | undefined) => Promise<string | null>;
-    /**
-     * RUSH-2221 — connection test after configure, before save. Absent → no test
-     * (the wizard saves without one, exactly as today).
-     */
     connectionTest?: (draft: HarnessDraft) => Promise<ConnectionTestResult>;
-    /**
-     * RUSH-2222 — per-host editability matrix. Absent → {@link defaultEditable}.
-     */
     editable?: (host: AgentId) => HarnessEditable;
 }
-/** Resolve the host CLI a fork `source` runs under (the host `buildFork` will use). */
 export declare function hostForSource(source: string | undefined): AgentId | undefined;
-/**
- * The engine. Walk the steps in order; for each, ask `decide` what to do, then
- * prompt only when it says `'run'`. A `{ disabled }` decision surfaces the reason
- * and moves on; `'skip'` is silent. Returns the finished draft.
- */
 export declare function runWizardSteps(steps: WizardStep[], draft: HarnessDraft, io: WizardIO, hooks?: WizardHooks): Promise<HarnessDraft>;
-/**
- * The create step list — the shape of `agents harness add`/`fork`. Faithful to
- * the previous `runHarnessWizard` sequence (source → preset|custom → model →
- * provider → base URL → name → key source), re-expressed as engine steps so the
- * sibling subtasks can gate/replace individual steps. Produces the same
- * `{ source, name, opts }` draft the fork flow already persists.
- */
 export declare function createSteps(): WizardStep[];
-/**
- * The edit step list — `agents harness edit <name>` with no flags on a TTY. Each
- * step is pre-filled with the profile's current value and gated by the host's
- * editability matrix (RUSH-2222 seam): an unsupported param reads as disabled with
- * a reason instead of being silently accepted. Records into the same draft, which
- * `runEditWizard` maps to the `EditOptions` shape the flag path already persists.
- */
 export declare function editSteps(original: Profile): WizardStep[];
-/**
- * Run the connection-test hook against a finished draft, if one is wired
- * (RUSH-2221). Returns `null` when no hook is present (no test performed) so the
- * caller can distinguish "not tested" from "tested and passed". Separated from the
- * step list because the test needs the assembled profile, which the caller builds.
- */
 export declare function runConnectionTest(draft: HarnessDraft, hooks: WizardHooks): Promise<ConnectionTestResult | null>;
-/**
- * Production {@link WizardIO} over `@inquirer/prompts`, lazy-imported so the
- * dependency loads only when a wizard actually runs. `note` prints to stderr so it
- * never contaminates a `--json`/piped stdout.
- */
 export declare function defaultWizardIO(): Promise<WizardIO>;

package/dist/commands/harness-wizard.js

@@ -1,50 +1,9 @@
-/**
- * Shared interactive step engine for `agents harness` create + edit.
- *
- * A single engine drives BOTH the create wizard (`agents harness add`/`fork`,
- * previously `runHarnessWizard`) and the new edit wizard (`agents harness edit`,
- * which was flag-only before). A "step" is a self-contained unit — decide whether
- * it runs for the current draft, then prompt/validate/apply — so the two modes
- * differ only in their step list, not in the runner.
- *
- * Design goals (RUSH-2219, parent RUSH-2218):
- *   - One runner, two modes. `create` builds a new harness from a source; `edit`
- *     loads an existing profile and re-asks each field pre-filled with its value.
- *   - Every step is skippable. A flag that already supplied the value pre-fills
- *     the draft and its step is not re-asked — so non-interactive scripting via
- *     flags is unchanged and the wizard only asks for what is missing.
- *   - Pure and injectable. The engine talks to the user through {@link WizardIO},
- *     an injected seam. Tests drive a scripted fake IO and assert which steps ran,
- *     with no TTY. {@link defaultWizardIO} is the production driver over
- *     `@inquirer/prompts`.
- *   - Typed extension points, not stubs. The three sibling subtasks plug in via
- *     {@link WizardHooks} without editing the engine: RUSH-2220 (model catalog +
- *     secrets surface) via `pickModel`, RUSH-2221 (connection test) via
- *     `connectionTest`, RUSH-2222 (edit matrix) via `editable`. Each hook is a
- *     real no-op extension point — absent, the scaffold falls back to today's
- *     behavior (free-text model, no test, resolver-sourced editability). None of
- *     them fakes a result. RUSH-2223 (cross-host portability, `fork --to-host`)
- *     extends the create source step; the seam is `HarnessDraft.toHost`.
- */
 import chalk from 'chalk';
 import { baseUrlEnvKeyForHost, authEnvKeyForHost, modelEnvKeyForHost, validateProfileName, listProfiles, } from '../lib/profiles.js';
 import { listPresets, getPreset } from '../lib/profiles-presets.js';
 import { listBundles } from '../lib/secrets-client.js';
 import { AGENTS, ALL_AGENT_IDS, isSelfUpdatingAgent, resolveAgentName } from '../lib/agents.js';
 import { readAccountRegistry } from '../lib/account-registry.js';
-/**
- * The per-harness editability matrix (RUSH-2222). Which of a harness's params
- * this host's API format actually lets you change, each disabled field carrying
- * the reason the wizard greys it with.
- *
- * Sourced ENTIRELY from the same maps the run-time resolver reads —
- * `baseUrlEnvKeyForHost` (endpoint slot), `authEnvKeyForHost` (auth env), and
- * `isSelfUpdatingAgent` (pinnable version) — never a table hardcoded alongside
- * them, so the wizard's enable/disable can never drift from what a run actually
- * honors (repo rule: the capability table stays truthful, in lockstep with the
- * code). A disabled param is never a silent no-op — the wizard shows its reason
- * and the flag path fails loud (`forkProfile`'s base-URL throw is the precedent).
- */
 export function harnessEditable(host) {
     const hasEndpoint = baseUrlEnvKeyForHost(host) !== null;
     const hasAuth = authEnvKeyForHost(host) !== null;
@@ -63,11 +22,6 @@ export function harnessEditable(host) {
         fallback: { enabled: true },
     };
 }
-/**
- * The boolean projection of {@link harnessEditable} — the scaffold default behind
- * the RUSH-2222 {@link WizardHooks.editable} seam. Derived from the reason-carrying
- * matrix so the two can never disagree.
- */
 export function defaultEditable(host) {
     const e = harnessEditable(host);
     return {
@@ -78,22 +32,15 @@ export function defaultEditable(host) {
         fallback: e.fallback.enabled,
     };
 }
-/** Resolve the host CLI a fork `source` runs under (the host `buildFork` will use). */
 export function hostForSource(source) {
     if (!source)
         return undefined;
     const native = resolveAgentName(source);
     if (native)
         return native;
-    // An existing custom harness: its own host.
     const custom = listProfiles().find((p) => p.name === source);
     return custom?.host.agent;
 }
-/**
- * The engine. Walk the steps in order; for each, ask `decide` what to do, then
- * prompt only when it says `'run'`. A `{ disabled }` decision surfaces the reason
- * and moves on; `'skip'` is silent. Returns the finished draft.
- */
 export async function runWizardSteps(steps, draft, io, hooks = {}) {
     for (const step of steps) {
         const decision = step.decide(draft);
@@ -106,26 +53,17 @@ export async function runWizardSteps(steps, draft, io, hooks = {}) {
     }
     return draft;
 }
-// --- shared prompt fragments ------------------------------------------------
 const NO_AUTH = '__none__';
 const CUSTOM = '__custom__';
 const TYPE_NOW = 'type';
 const FROM_SECRETS = 'secrets';
 const KEEP = '__keep__';
-/** The first `_MODEL`-suffixed env var in a preset's static env block, if any. */
 function presetModel(preset) {
     return Object.entries(preset.env).find(([k]) => k.endsWith('_MODEL'))?.[1];
 }
-/** Providers offered in the custom-auth select, deduped from the preset catalog. */
 function knownProviders() {
     return [...new Set(listPresets().map((p) => p.provider))];
 }
-/**
- * Prompt for a key source when a provider needs one: type it now, or copy it from
- * an existing agents secrets bundle. Sets `draft.fromSecrets` for the bundle path;
- * the type-now path is handled downstream (ensureProviderToken), unchanged. This
- * is today's behavior, lifted verbatim; RUSH-2220 enriches the bundle browse.
- */
 async function askKeySource(io, draft, provider) {
     const bundles = await listBundles();
     const source = bundles.length > 0
@@ -153,7 +91,6 @@ async function askKeySource(io, draft, provider) {
         : await io.select({ message: 'Key', choices: keys.map((k) => ({ name: k, value: k })) });
     draft.fromSecrets = `${bundleName}:${key}`;
 }
-/** Free-text model prompt, unless RUSH-2220's catalog hook picks one first. */
 async function askModel(io, draft, hooks, current) {
     if (hooks.pickModel) {
         const picked = await hooks.pickModel(io, draft.host, draft.version ?? draft.original?.host.version, current);
@@ -162,14 +99,6 @@ async function askModel(io, draft, hooks, current) {
     }
     return io.input({ message: 'Model id', default: current });
 }
-// --- create steps -----------------------------------------------------------
-/**
- * The create step list — the shape of `agents harness add`/`fork`. Faithful to
- * the previous `runHarnessWizard` sequence (source → preset|custom → model →
- * provider → base URL → name → key source), re-expressed as engine steps so the
- * sibling subtasks can gate/replace individual steps. Produces the same
- * `{ source, name, opts }` draft the fork flow already persists.
- */
 export function createSteps() {
     return [
         {
@@ -210,8 +139,6 @@ export function createSteps() {
                 d.baseUrl = preset.env.ANTHROPIC_BASE_URL || preset.env.OPENAI_BASE_URL || undefined;
                 d.authProvider = preset.authOptional ? undefined : preset.provider;
                 d.providerAsked = true;
-                // Pre-fill the name with the preset's own name (e.g. 'deepseek'), not a
-                // model detail, so users aren't nudged toward baking one into the identity.
                 d.defaultName = preset.name;
             },
         },
@@ -242,10 +169,6 @@ export function createSteps() {
             decide: (d) => {
                 if (!d.custom || d.baseUrl !== undefined)
                     return 'skip';
-                // Endpoint slot is a function of the host's API format (§3.4): only the
-                // Anthropic/OpenAI-compatible hosts carry one. Skipping the prompt for the
-                // rest replaces the old silent-drop (`profileFromHostModel` discards a
-                // base URL the host can't honor) with an explicit reason.
                 const host = d.host ?? hostForSource(d.source);
                 if (host) {
                     const cap = harnessEditable(host).baseUrl;
@@ -295,29 +218,16 @@ export function createSteps() {
         connectionTestStep(),
     ];
 }
-// --- edit steps -------------------------------------------------------------
-/** The raw model id currently pinned on a profile (not the display label). */
 function currentModel(p) {
     return p.env[modelEnvKeyForHost(p.host.agent)];
 }
-/** The raw base URL currently pinned on a profile, if the host carries one. */
 function currentBaseUrl(p) {
     const key = baseUrlEnvKeyForHost(p.host.agent);
     return key ? p.env[key] : undefined;
 }
-/**
- * The edit step list — `agents harness edit <name>` with no flags on a TTY. Each
- * step is pre-filled with the profile's current value and gated by the host's
- * editability matrix (RUSH-2222 seam): an unsupported param reads as disabled with
- * a reason instead of being silently accepted. Records into the same draft, which
- * `runEditWizard` maps to the `EditOptions` shape the flag path already persists.
- */
 export function editSteps(original) {
     const host = original.host.agent;
     const editableFor = (hooks) => (hooks.editable ?? defaultEditable)(host);
-    // decide() has no access to hooks, so gate on the resolver-sourced matrix; a
-    // hook that narrows editability further is applied inside run(). The matrix is
-    // the resolver truth (RUSH-2222), reasons and all.
     const cap = harnessEditable(host);
     return [
         {
@@ -387,38 +297,19 @@ export function editSteps(original) {
         connectionTestStep(),
     ];
 }
-/**
- * The connection-test step (RUSH-2221 seam). Kept in both step lists so the id is
- * a stable member of the sequence, but the actual test needs the assembled profile
- * (which the caller builds after the wizard), so the run is performed separately by
- * {@link runConnectionTest}. The step itself decides `'skip'` — a real no-op
- * extension point that fakes nothing.
- */
 function connectionTestStep() {
     return {
         id: 'connectionTest',
         decide: () => 'skip',
         async run() {
-            /* no-op: superseded by runConnectionTest, kept so the step id is stable */
         },
     };
 }
-/**
- * Run the connection-test hook against a finished draft, if one is wired
- * (RUSH-2221). Returns `null` when no hook is present (no test performed) so the
- * caller can distinguish "not tested" from "tested and passed". Separated from the
- * step list because the test needs the assembled profile, which the caller builds.
- */
 export async function runConnectionTest(draft, hooks) {
     if (!hooks.connectionTest)
         return null;
     return hooks.connectionTest(draft);
 }
-/**
- * Production {@link WizardIO} over `@inquirer/prompts`, lazy-imported so the
- * dependency loads only when a wizard actually runs. `note` prints to stderr so it
- * never contaminates a `--json`/piped stdout.
- */
 export async function defaultWizardIO() {
     const { select, input, password, confirm } = await import('@inquirer/prompts');
     return {

package/dist/commands/harness.d.ts

@@ -1,26 +1,8 @@
-/**
- * Custom harness commands (`agents harness`).
- *
- * A "custom harness" is a named (host CLI + model) combo — e.g. OpenCode pinned
- * to meta/muse-spark-1.1, called `spark`. It runs like a native agent type
- * (`agents run spark`) and syncs across devices via `agents repo push user`.
- *
- * Mechanism: harnesses ARE profiles (same ~/.agents/profiles/*.yml, same run
- * resolution). This command group is the surface over that layer + a discovery
- * `list` spanning custom harnesses, addable presets, and the native harness
- * registry. The former top-level `agents profiles` tree was removed — use harness.
- */
 import type { Command } from 'commander';
 import { type AddProfileOptions } from './profiles.js';
 import { type Profile } from '../lib/profiles.js';
 import { type HarnessDraft } from './harness-wizard.js';
-/**
- * Print one custom harness. Shared by `agents harness view <name>` and by
- * `agents view <name>` — a custom harness resolves as an agent type there, so
- * both entry points must describe it identically.
- */
 export declare function renderHarnessDetail(name: string): void;
-/** Options accepted by `agents harness fork`. */
 export interface ForkOptions {
     toHost?: string;
     model?: string;
@@ -29,75 +11,30 @@ export interface ForkOptions {
     account?: string;
     version?: string;
     description?: string;
-    /** `<bundle>` or `<bundle>:<key>` — see {@link applyFromSecrets} in ./profiles.js. */
     fromSecrets?: string;
     keyStdin?: boolean;
     force?: boolean;
-    /** Tri-state pre-save connection test: true = force, false = skip, undefined = ask on a TTY. */
     test?: boolean;
 }
-/** Options accepted by `agents harness edit`. */
 export interface EditOptions {
     model?: string;
     baseUrl?: string;
     authProvider?: string;
     account?: string;
-    /** Empty string ('') unpins the host CLI version. */
     version?: string;
     description?: string;
-    /** Empty string ('') clears the fallback model. */
     fallbackModel?: string;
-    /** `<bundle>` or `<bundle>:<key>` — see {@link applyFromSecrets} in ./profiles.js. */
     fromSecrets?: string;
     keyStdin?: boolean;
-    /** Tri-state pre-save connection test: true = force, false = skip, undefined = ask on a TTY. */
     test?: boolean;
 }
-/**
- * Build the new harness for `agents harness fork <source> <name>`.
- *
- * Two sources, one verb: an existing custom harness is copied and overridden;
- * a native agent id is turned into a harness pinned to `--model` on that host.
- * Forking a native harness therefore requires `--model` — there is nothing to
- * copy a model from.
- */
 export declare function buildFork(source: string, name: string, opts: ForkOptions): Profile;
-/** True when at least one recognized edit flag was given. */
 export declare function hasEditFlags(opts: EditOptions): boolean;
-/**
- * Build the edited harness for `agents harness edit <name>` — the profile-shape
- * transform only; the caller applies `--from-secrets`/`--auth-provider` (async
- * keychain side effects) and persists with `writeProfile`. Mirrors
- * {@link buildFork}'s split between a pure builder and the action's IO.
- */
 export declare function buildEdit(name: string, opts: EditOptions): Profile;
-/** True when `agents harness fork` was given too little to proceed without the wizard. */
 export declare function forkNeedsWizard(source: string | undefined, name: string | undefined, opts: ForkOptions): boolean;
-/** True when `agents harness add` was given too little to proceed without the wizard.
- * Mirrors {@link addProfile}'s own error condition in ./profiles.js so a bare
- * `agents harness add <preset-name>` (no flags) still resolves via the preset
- * fallback instead of being routed into the wizard. */
 export declare function addNeedsWizard(name: string | undefined, opts: AddProfileOptions): boolean;
-/** Whether the pre-save connection test runs, or must be asked for on a TTY. */
 type ConnectionTestGate = 'on' | 'off' | 'ask';
-/**
- * Resolve the tri-state connection-test gate (RUSH-2221), pure so the branching
- * is unit-tested with no prompt or spawn. `--test` forces it on, `--no-test`
- * forces it off, and with neither flag a TTY is asked (default yes) while a
- * non-interactive caller (`--key-stdin`, piped, CI) skips it — so scripting stays
- * non-interactive unless it opts in with `--test`.
- */
 export declare function connectionTestGate(testFlag: boolean | undefined, interactive: boolean): ConnectionTestGate;
-/**
- * Map a finished edit-wizard draft onto {@link EditOptions}, keeping only the
- * fields the user actually changed from the profile's current values. Unchanged
- * accepts (the wizard pre-fills each prompt with the current value) drop out, so
- * the resulting {@link buildEdit} touches nothing the user left alone — and the
- * "no changes" case is detectable via {@link hasEditFlags}. Base-URL clearing is
- * intentionally not expressed here: the flag path can't clear it either (an empty
- * `--base-url` is a no-op in `forkProfile`), so the wizard matches that until a
- * later subtask adds explicit clearing.
- */
 export declare function draftToEditOptions(draft: HarnessDraft, original: Profile): EditOptions;
 export declare function registerHarnessCommands(program: Command): void;
 export {};