@phnx-labs/agents-cli 1.22.120 → 1.22.121

package/dist/commands/permissions.js

@@ -16,7 +16,6 @@ import { isPromptCancelled, isInteractiveTerminal, parseCommaSeparatedList, prin
 export function shouldRefuseBroadPermissions(permissions, allowBroadPermissions) {
     return !allowBroadPermissions && permissions.some((perm) => containsBroadGrants(perm.set) !== null);
 }
-/** Register the `agents permissions` command tree (list, add, remove, view). */
 export function registerPermissionsCommands(program) {
     const permissionsCmd = program
         .command('permissions')
@@ -51,17 +50,6 @@ When to use:
         .option('-s, --scope <scope>', 'user (global) or project (repo-specific)', 'user')
         .action(async (agentArg, options) => {
         const cwd = process.cwd();
-        // Helper to render permissions for a specific version
-        /**
-         * Print one harness's permission block.
-         *
-         * claude/opencode/codex keep their native renderings (Codex in particular
-         * has no rule list — showing its sandbox mode is more useful than the
-         * blanket grants that mode widens into). Every other allowlist-capable
-         * harness renders the canonical allow/deny that `PERMISSION_TARGETS` reads
-         * back, which is what makes `permissions list` answer for all 13 rather
-         * than three (RUSH-2676).
-         */
         const renderPermissionBody = (agentId, perms) => {
             if (agentId === 'claude') {
                 const claudePerms = perms;
@@ -136,7 +124,6 @@ When to use:
             renderPermissionBody(agentId, perms);
         };
         if (agentArg) {
-            // Parse agent@version syntax
             const parts = agentArg.split('@');
             const agentName = parts[0];
             const agentId = resolveAgentName(agentName);
@@ -154,7 +141,6 @@ When to use:
             const defaultVer = getGlobalDefault(agentId);
             console.log(chalk.bold(`Installed Permissions for ${agentLabel(agent.id)} (${options.scope}):\n`));
             if (installedVersions.length === 0) {
-                // Not version-managed - use default home
                 const perms = readAgentPermissions(agentId, options.scope, cwd);
                 if (!perms) {
                     console.log(chalk.gray(`  No permissions configured`));
@@ -164,7 +150,6 @@ When to use:
                 renderPermissionBody(agentId, perms);
                 return;
             }
-            // Version-managed: determine which versions to show
             let versionsToShow;
             if (requestedVersion === 'default') {
                 if (!defaultVer) {
@@ -182,7 +167,6 @@ When to use:
                 versionsToShow = [requestedVersion];
             }
             else {
-                // Show all versions, default first
                 versionsToShow = [...installedVersions].sort((a, b) => {
                     if (a === defaultVer)
                         return -1;
@@ -197,7 +181,6 @@ When to use:
             }
         }
         else {
-            // List central permission sets
             const sets = listInstalledPermissions();
             if (sets.length === 0) {
                 console.log(chalk.gray('No permission sets installed.'));
@@ -208,7 +191,6 @@ When to use:
             const permCols = terminalWidth();
             for (const perm of sets) {
                 const prefix = `  ${chalk.cyan(perm.name)}`;
-                // Cap the description to the line so a prose-paragraph set (400+ chars) can't smear.
                 const budget = permCols - stringWidth(prefix) - 3;
                 const desc = perm.set.description && budget > 3
                     ? ` - ${chalk.gray(truncateToWidth(perm.set.description, budget))}`
@@ -247,7 +229,6 @@ Examples:
         .action(async (source, options) => {
         try {
             const skipPrompts = options.yes || !isInteractiveTerminal();
-            // Interactive mode: pick from central storage
             if (!source) {
                 const installedSets = listInstalledPermissions();
                 if (installedSets.length === 0) {
@@ -330,7 +311,6 @@ Examples:
                     console.log(chalk.yellow('\nNo agents selected.'));
                     return;
                 }
-                // Apply selected permission sets
                 let applied = 0;
                 for (const setName of selectedNames) {
                     const installed = installedSets.find((s) => s.name === setName);
@@ -374,24 +354,14 @@ Examples:
                 }
                 spinner.succeed('Using local path');
             }
-            // Is this a harness config agents-cli knows how to read?
-            //
-            // This used to hardcode `.json`/`.jsonc`/`.toml` plus a `.claude`/
-            // `.opencode`/`.codex` substring, which excluded the ten other harnesses
-            // the CLI writes -- and excluded hermes twice over, since
-            // its config is YAML. The registry already answers this by matching
-            // each harness's own declared path, so ask it (RUSH-2676).
             const isAgentConfig = detectPermissionAgentFromPath(localPath) !== null;
             if (isAgentConfig) {
-                // Handle agent config file - convert, diff, merge into default set
                 const incoming = exportPermissionsFromPath(localPath);
                 if (!incoming || (incoming.allow.length === 0 && (!incoming.deny || incoming.deny.length === 0))) {
                     console.log(chalk.yellow(`\nNo permissions found in ${localPath}`));
                     return;
                 }
-                // Get existing default permission set
                 const existing = getDefaultPermissionSet();
-                // Compute diff
                 const diff = computePermissionsDiff(existing, incoming);
                 const totalNew = diff.allow.added.length + diff.deny.added.length;
                 const totalExisting = diff.allow.existing.length + diff.deny.existing.length;
@@ -399,7 +369,6 @@ Examples:
                     console.log(chalk.gray('\nAll permissions already exist in central storage.'));
                     return;
                 }
-                // Show diff
                 console.log(chalk.bold('\nPermissions to add:\n'));
                 if (diff.allow.added.length > 0) {
                     console.log(chalk.green('  New allow rules:'));
@@ -420,7 +389,6 @@ Examples:
                     console.log(chalk.gray(`\n  (${totalExisting} rules already exist, will be skipped)`));
                 }
                 console.log();
-                // Confirm
                 if (!skipPrompts) {
                     const proceed = await confirm({
                         message: `Add ${totalNew} new permission rule${totalNew === 1 ? '' : 's'}?`,
@@ -431,7 +399,6 @@ Examples:
                         return;
                     }
                 }
-                // Merge and save
                 const merged = mergePermissionSets(existing, incoming);
                 const result = saveDefaultPermissionSet(merged);
                 if (!result.success) {
@@ -439,7 +406,6 @@ Examples:
                     return;
                 }
                 console.log(chalk.green(`Added ${totalNew} permission${totalNew === 1 ? '' : 's'} to ~/.agents/permissions/default.yml`));
-                // Apply to agent versions
                 let selectedAgents;
                 let versionSelections;
                 if (options.agents) {
@@ -503,7 +469,6 @@ Examples:
                 }
             }
             else {
-                // Handle permission YAML files or repo
                 let permissions;
                 if (localPath.endsWith('.yml') || localPath.endsWith('.yaml')) {
                     const { parsePermissionSet } = await import('../lib/permissions.js');
@@ -544,7 +509,6 @@ Examples:
                         process.exit(1);
                     }
                 }
-                // Confirm installation
                 if (!skipPrompts) {
                     const proceed = await confirm({
                         message: 'Install these permission sets?',
@@ -569,7 +533,6 @@ Examples:
                     }
                 }
                 installSpinner.succeed(`Installed ${installed} permission set(s) to ~/.agents/permissions/`);
-                // Apply to agent versions
                 let selectedAgents;
                 let versionSelections;
                 if (options.agents) {
@@ -660,7 +623,6 @@ Examples:
             setsToRemove = [name];
         }
         else {
-            // Interactive picker
             const installedSets = listInstalledPermissions();
             if (installedSets.length === 0) {
                 console.log(chalk.yellow('No permission sets installed.'));
@@ -722,7 +684,6 @@ Examples:
             console.log(chalk.yellow('No permission sets installed'));
             return;
         }
-        // If no name provided, show interactive select
         if (!name) {
             if (!isInteractiveTerminal()) {
                 requireInteractiveSelection('Selecting a permission set to view', [
@@ -754,7 +715,6 @@ Examples:
             console.log(chalk.yellow(`Permission set '${name}' not found`));
             return;
         }
-        // Build output
         const lines = [];
         lines.push(chalk.bold(`\n${perm.name}\n`));
         if (perm.set.description) {
@@ -777,7 +737,4 @@ Examples:
         const output = lines.join('\n');
         printWithPager(output, lines.length);
     });
-    // Deprecated alias handler for 'perms'
-    // Note: This needs to be registered at the program level, not as a subcommand
-    // The actual deprecation message is shown in index.ts
 }

package/dist/commands/plugins.d.ts

@@ -1,14 +1,6 @@
-/**
- * Plugin management commands.
- *
- * Registers the `agents plugins` command tree for listing, viewing,
- * syncing, and removing plugin bundles (skills + hooks + permissions)
- * stored in ~/.agents/plugins/.
- */
 import type { Command } from 'commander';
 import { type PluginCapabilities } from '../lib/plugins/plugins.js';
 export declare function shouldRefusePluginInstall(capabilities: PluginCapabilities, allowExecSurfaces: boolean): boolean;
-/** Register the `agents plugins` command tree. */
 export declare function registerPluginsCommands(program: Command): void;
 interface MarketplaceRow {
     name: string;
@@ -16,12 +8,6 @@ interface MarketplaceRow {
     plugins: number;
     enabled: number;
 }
-/**
- * Build one row per discovered marketplace. `plugins` counts plugin manifests
- * under the marketplace's source pluginsRoot; `enabled` counts entries in the
- * default Claude version's settings.json#enabledPlugins keyed on @<marketplace>.
- */
 export declare function collectMarketplaceRows(): MarketplaceRow[];
-/** Per-category color for a plugin resource breakdown (shared with `agents inspect`). */
 export declare const PLUGIN_GROUP_COLORS: Record<string, (s: string) => string>;
 export {};

package/dist/commands/plugins.js

@@ -1,10 +1,3 @@
-/**
- * Plugin management commands.
- *
- * Registers the `agents plugins` command tree for listing, viewing,
- * syncing, and removing plugin bundles (skills + hooks + permissions)
- * stored in ~/.agents/plugins/.
- */
 import * as fs from 'fs';
 import * as path from 'path';
 import { withAliases } from '../lib/verbs.js';
@@ -21,7 +14,6 @@ import { showResourceList, buildTargetsSection, } from './resource-view.js';
 import { getPluginsDir } from '../lib/state.js';
 import { safeJoin } from '../lib/paths.js';
 import { discoverMarketplaces } from '../lib/plugins/plugin-marketplace.js';
-/** Replace the home directory prefix with ~ for display. */
 function formatPath(p) {
     const home = homeDir();
     if (home && p.startsWith(home)) {
@@ -32,7 +24,6 @@ function formatPath(p) {
 export function shouldRefusePluginInstall(capabilities, allowExecSurfaces) {
     return hasPluginExecSurfaces(capabilities) && !allowExecSurfaces;
 }
-/** Register the `agents plugins` command tree. */
 export function registerPluginsCommands(program) {
     const pluginsCmd = program
         .command('plugins')
@@ -58,12 +49,9 @@ When to use:
   - Version control: sync plugins selectively to different agent versions
   - Team onboarding: distribute a full toolkit via a single plugin directory
 `);
-    // Shared list implementation — reused by `list` and the bare `agents plugins` default.
     const runList = async (options = {}) => {
         const plugins = discoverPlugins();
         if (options.json) {
-            // Structured dump (name/description + per-agent-version sync targets) — the
-            // same rows the table is built from, mirroring `plugins marketplaces --json`.
             console.log(JSON.stringify(plugins.length === 0 ? [] : buildPluginRows(plugins), null, 2));
             return;
         }
@@ -82,17 +70,12 @@ When to use:
             centralPath: getPluginsDir(),
         });
     };
-    // Bare `agents plugins` → same as `list`. (--json lives on the explicit `list`
-    // subcommand only; declaring it on both parent + child makes commander bind the
-    // flag to the parent for `plugins list --json`, dropping it from the subcommand.)
     pluginsCmd.action(runList);
-    // agents plugins list
     withAliases(pluginsCmd
         .command('list'), 'list')
         .description('Show plugins in a table with sync status across agent versions')
         .option('--json', 'Emit machine-readable JSON')
         .action(runList);
-    // agents plugins marketplaces
     const marketplacesCmd = pluginsCmd
         .command('marketplaces')
         .description('List plugin marketplaces — one per DotAgents repo with a plugins/ directory')
@@ -118,7 +101,6 @@ When to use:
         console.log();
         console.log(chalk.gray(`${rows.length} marketplace(s) — manage via 'agents repo'.`));
     });
-    // Redirect add/remove/etc. on marketplaces to repo commands.
     const marketplaceRedirect = (verb) => () => {
         console.log(chalk.gray(`Use 'agents repo ${verb === 'add' ? 'add' : verb} <path|gh:user/repo>' to ${verb} a marketplace (one repo = one marketplace).`));
     };
@@ -128,7 +110,6 @@ When to use:
             .description(`Redirects to 'agents repo ${verb}' — marketplaces follow repos`)
             .action(marketplaceRedirect(verb));
     }
-    // agents plugins view [name]
     withAliases(pluginsCmd
         .command('view [name]'), 'view')
         .alias('info')
@@ -143,7 +124,6 @@ Examples:
 `)
         .action(async (nameArg) => {
         let name = nameArg;
-        // No name → pick one from the installed plugins.
         if (!name) {
             const discovered = discoverPlugins();
             if (discovered.length === 0) {
@@ -257,7 +237,6 @@ Examples:
             console.log(chalk.bold('\n  Settings'));
             console.log(`    ${chalk.gray('settings.json')}`);
         }
-        // Show installation status per agent version
         console.log(chalk.bold('\n  Installation Status'));
         let anyInstalled = false;
         for (const agentId of capableAgents('plugins')) {
@@ -283,7 +262,6 @@ Examples:
         }
         console.log();
     });
-    // agents plugins remove [name]
     withAliases(pluginsCmd
         .command('remove [name]'), 'remove')
         .description('Unsync a plugin from all agent versions and optionally delete its source directory')
@@ -309,14 +287,12 @@ Examples:
         const name = nameArg;
         const pluginsDir = path.join(homeDir(), '.agents', 'plugins');
         const pluginRoot = safeJoin(pluginsDir, name);
-        // Use discovered plugin when present; fall back to name+root if source is already gone
         const plugin = getPlugin(name);
         const resolvedRoot = plugin?.root || pluginRoot;
         if (!plugin && !fs.existsSync(pluginRoot)) {
             console.log(chalk.red(`Plugin '${name}' not found`));
             process.exit(1);
         }
-        // Build list of targets that have this plugin synced
         const availableTargets = [];
         for (const agentId of capableAgents('plugins')) {
             if (plugin && !pluginSupportsAgent(plugin, agentId))
@@ -337,7 +313,6 @@ Examples:
             }
             return;
         }
-        // Show multi-select picker for targets
         const removalTargets = availableTargets.map((t) => ({
             agent: t.agent,
             version: t.version,
@@ -388,7 +363,6 @@ Examples:
             totalMcp > 0 ? `${totalMcp} MCP servers` : null,
         ].filter(Boolean).join(', ') || 'nothing';
         console.log(chalk.green(`\nUnsynced ${name} from ${versionsTouched} version(s) — ${summary}`));
-        // Only delete source if ALL targets were selected
         if (!options.keepSource && selectedTargets.length === availableTargets.length) {
             if (fs.existsSync(pluginRoot)) {
                 fs.rmSync(pluginRoot, { recursive: true, force: true });
@@ -402,7 +376,6 @@ Examples:
             console.log(chalk.gray(`Kept source at ${formatPath(pluginRoot)}`));
         }
     });
-    // agents plugins add <spec>
     pluginsCmd
         .command('add <spec>')
         .alias('install')
@@ -453,13 +426,11 @@ Examples:
             fs.rmSync(root, { recursive: true, force: true });
             process.exit(1);
         }
-        // Check dependencies
         const missingDeps = checkPluginDependencies(plugin.manifest);
         if (missingDeps.length > 0) {
             console.log(chalk.yellow(`Warning: missing dependencies: ${missingDeps.join(', ')}`));
             console.log(chalk.gray('Install them with: agents plugins add <name>@<source>'));
         }
-        // Prompt for userConfig fields
         if (plugin.manifest.userConfig && plugin.manifest.userConfig.length > 0 && isInteractiveTerminal()) {
             const existingConfig = loadUserConfig(name);
             const newConfig = await promptUserConfig(plugin.manifest, existingConfig);
@@ -468,7 +439,6 @@ Examples:
                 console.log(chalk.gray('User config saved.'));
             }
         }
-        // Sync to all supported installed versions
         console.log();
         let synced = 0;
         for (const agentId of capableAgents('plugins')) {
@@ -494,7 +464,6 @@ Examples:
         }
         console.log(chalk.bold(`\nInstalled ${plugin.name} v${plugin.manifest.version} to ${formatPath(root)}`));
     });
-    // agents plugins update [name]
     pluginsCmd
         .command('update [name]')
         .description('Re-pull a plugin from its original source and re-sync to all versions')
@@ -526,8 +495,6 @@ Examples:
             const result = await updatePlugin(plugin.name, { allowExecSurfaces: allowExec });
             if (!result.success) {
                 if (result.blockedByExecSurfaces) {
-                    // Security (RUSH-1757): the update introduced new executable surfaces.
-                    // Refuse without renewed consent; the last-good content stays in place.
                     console.log(chalk.yellow('skipped'));
                     console.log(chalk.yellow(`  Update introduces new executable surfaces: ${(result.newExecSurfaces || []).join(', ')}`));
                     console.log(chalk.gray('  Kept the currently-installed revision. Re-run with --allow-exec-surfaces if you trust the source.'));
@@ -538,12 +505,7 @@ Examples:
                 continue;
             }
             console.log(chalk.green('done'));
-            // Reload the plugin so the re-sync reads the freshly-applied revision.
             const updated = getPlugin(plugin.name) ?? plugin;
-            // Re-sync to all supported installed versions. When the applied revision
-            // carries executable surfaces, only enable them if the user consented on
-            // this update (--allow-exec-surfaces); otherwise the benign content syncs
-            // but stays disabled, matching the install-time trust gate.
             for (const agentId of capableAgents('plugins')) {
                 if (!pluginSupportsAgent(updated, agentId))
                     continue;
@@ -562,10 +524,6 @@ Examples:
         }
     });
 }
-/**
- * Prompt for missing or empty userConfig fields interactively.
- * Only prompts for fields not already present in existingConfig.
- */
 async function promptUserConfig(manifest, existingConfig = {}) {
     const result = {};
     const fields = manifest.userConfig || [];
@@ -600,15 +558,9 @@ function padCol(s, w) {
         return s;
     return s + ' '.repeat(w - raw.length);
 }
-/**
- * Build one row per discovered marketplace. `plugins` counts plugin manifests
- * under the marketplace's source pluginsRoot; `enabled` counts entries in the
- * default Claude version's settings.json#enabledPlugins keyed on @<marketplace>.
- */
 export function collectMarketplaceRows() {
     const marketplaces = discoverMarketplaces();
     const rows = [];
-    // Find the default Claude version (if any) and read its enabledPlugins map.
     const claudeDefault = isCapable('claude', 'plugins') ? getGlobalDefault('claude') : null;
     let enabledMap = {};
     if (claudeDefault) {
@@ -619,7 +571,7 @@ export function collectMarketplaceRows() {
                 const parsed = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
                 enabledMap = parsed.enabledPlugins ?? {};
             }
-            catch { /* ignore parse errors */ }
+            catch { }
         }
     }
     for (const m of marketplaces) {
@@ -634,7 +586,7 @@ export function collectMarketplaceRows() {
                     pluginCount++;
             }
         }
-        catch { /* ignore unreadable dir */ }
+        catch { }
         const suffix = `@${m.name}`;
         const enabled = Object.entries(enabledMap)
             .filter(([key, val]) => val === true && key.endsWith(suffix))
@@ -643,10 +595,8 @@ export function collectMarketplaceRows() {
     }
     return rows;
 }
-/** Convert discovered plugins into rows suitable for the resource list view. */
 function buildPluginRows(plugins) {
     const rows = [];
-    // Cache version lists per agent once.
     const versionsByAgent = new Map();
     const defaultsByAgent = new Map();
     for (const agent of capableAgents('plugins')) {
@@ -687,7 +637,6 @@ function buildPluginRows(plugins) {
     });
     return rows;
 }
-/** Per-category color for a plugin resource breakdown (shared with `agents inspect`). */
 export const PLUGIN_GROUP_COLORS = {
     skills: chalk.cyan,
     commands: chalk.cyan,
@@ -700,7 +649,6 @@ export const PLUGIN_GROUP_COLORS = {
     scripts: chalk.white,
     settings: chalk.gray,
 };
-/** Human-readable section header per category, used by the picker detail pane. */
 const PLUGIN_GROUP_TITLES = {
     skills: 'Skills',
     commands: 'Commands',
@@ -713,7 +661,6 @@ const PLUGIN_GROUP_TITLES = {
     scripts: 'Scripts',
     settings: 'Settings',
 };
-/** Build the multi-line detail pane shown when a plugin is selected in the picker. */
 function formatPluginDetail(plugin, targets) {
     const lines = [];
     const title = plugin.manifest.version

package/dist/commands/profiles.d.ts

@@ -1,23 +1,7 @@
-/**
- * Custom-harness profile helpers (shared by `agents harness`).
- *
- * Named bundles of (host CLI, endpoint, model, keychain auth) live under
- * ~/.agents/profiles/*.yml. The user-facing surface is `agents harness`
- * (add/fork/edit/list/view/remove). This module keeps the shared write helpers
- * (`addProfile`, `ensureProviderToken`, …) that harness and the run path use.
- */
 import { type Profile } from '../lib/profiles.js';
 import { type Preset } from '../lib/profiles-presets.js';
-/**
- * Pure helper: builds a Profile from collected wizard inputs. Extracted so the
- * shape of preset->profile mapping for the `create` wizard is unit-testable
- * without mocking @inquirer/prompts.
- */
 export declare function buildProfileFromCollection(name: string, preset: Preset, collected: Record<string, string>, version?: string): Profile;
-/** Read all available data from stdin synchronously, trimmed. */
-/** Ensure a provider API key exists in keychain, prompting or reading stdin if missing. */
 export declare function ensureProviderToken(provider: string, signupUrl?: string, fromStdin?: boolean): Promise<void>;
-/** Options accepted by {@link addProfile} — shared by `agents harness add` and `agents harness add`. */
 export interface AddProfileOptions {
     preset?: string;
     host?: string;
@@ -28,7 +12,6 @@ export interface AddProfileOptions {
     version?: string;
     keyStdin?: boolean;
     force?: boolean;
-    /** `<bundle>` or `<bundle>:<key>` — see {@link applyFromSecrets}. */
     fromSecrets?: string;
 }
 /**
@@ -71,12 +54,4 @@ export interface AddProfileOptions {
 export declare function applyFromSecrets(profile: Profile, spec: string, explicitAuthProvider?: string, opts?: {
     allowInheritedAuth?: boolean;
 }): Promise<void>;
-/**
- * Create a profile ("custom harness"). Two paths:
- *  - `--host <agent> --model <id>`: one-shot custom harness from a host + model
- *    (no preset needed). This is what makes a model like Muse Spark a named,
- *    runnable harness.
- *  - otherwise: apply a built-in preset (existing behavior).
- * `label` only tunes the success wording (Profile vs Harness). Throws on error.
- */
 export declare function addProfile(name: string, opts: AddProfileOptions, label?: 'Profile' | 'Harness'): Promise<void>;

package/dist/commands/profiles.js

@@ -1,11 +1,3 @@
-/**
- * Custom-harness profile helpers (shared by `agents harness`).
- *
- * Named bundles of (host CLI, endpoint, model, keychain auth) live under
- * ~/.agents/profiles/*.yml. The user-facing surface is `agents harness`
- * (add/fork/edit/list/view/remove). This module keeps the shared write helpers
- * (`addProfile`, `ensureProviderToken`, …) that harness and the run path use.
- */
 import chalk from 'chalk';
 import { readStdinSync } from '../lib/format.js';
 import { writeProfile, profileFromPreset, profileFromHostModel, baseUrlEnvKeyForHost, authEnvKeyForHost, validateProfileName, profileExists, } from '../lib/profiles.js';
@@ -14,11 +6,6 @@ import { getKeychainToken, hasKeychainToken, isSecretsClientError, parseBundleVa
 import { isInteractiveTerminal } from './utils.js';
 import { ALL_AGENT_IDS } from '../lib/agents.js';
 import { findAccount } from '../lib/account-registry.js';
-/**
- * Pure helper: builds a Profile from collected wizard inputs. Extracted so the
- * shape of preset->profile mapping for the `create` wizard is unit-testable
- * without mocking @inquirer/prompts.
- */
 export function buildProfileFromCollection(name, preset, collected, version) {
     return {
         name,
@@ -34,7 +21,6 @@ export function buildProfileFromCollection(name, preset, collected, version) {
         provider: preset.provider,
     };
 }
-/** Prompt the user for a secret value with masked input. Requires an interactive TTY. */
 async function promptForSecret(message) {
     if (!isInteractiveTerminal()) {
         throw new Error('A secret is required but the shell is not interactive. Pipe the key via stdin (--key-stdin).');
@@ -42,8 +28,6 @@ async function promptForSecret(message) {
     const { password } = await import('@inquirer/prompts');
     return await password({ message, mask: true });
 }
-/** Read all available data from stdin synchronously, trimmed. */
-/** Ensure a provider API key exists in keychain, prompting or reading stdin if missing. */
 export async function ensureProviderToken(provider, signupUrl, fromStdin) {
     const item = profileKeychainItem(provider);
     if (await hasKeychainToken(item)) {
@@ -109,7 +93,6 @@ export async function applyFromSecrets(profile, spec, explicitAuthProvider, opts
         bundle = await readBundle(bundleName);
     }
     catch (err) {
-        // The standalone reports only a code; name the bundle the user asked for.
         if (!isSecretsClientError(err, 'NOT_FOUND'))
             throw err;
         throw new Error(`Secrets bundle '${bundleName}' not found. List bundles with 'agents secrets list'.`);
@@ -153,14 +136,6 @@ export async function applyFromSecrets(profile, spec, explicitAuthProvider, opts
         profile.authOptional = false;
     }
 }
-/**
- * Create a profile ("custom harness"). Two paths:
- *  - `--host <agent> --model <id>`: one-shot custom harness from a host + model
- *    (no preset needed). This is what makes a model like Muse Spark a named,
- *    runnable harness.
- *  - otherwise: apply a built-in preset (existing behavior).
- * `label` only tunes the success wording (Profile vs Harness). Throws on error.
- */
 export async function addProfile(name, opts, label = 'Profile') {
     validateProfileName(name);
     const account = opts.account ? findAccount(opts.account) : null;
@@ -169,7 +144,6 @@ export async function addProfile(name, opts, label = 'Profile') {
     if (profileExists(name) && !opts.force) {
         throw new Error(`${label} '${name}' already exists. Use --force to overwrite.`);
     }
-    // One-shot host + model → custom harness, no preset required.
     if (opts.host || opts.model) {
         if (!opts.host || !opts.model) {
             throw new Error('Both --host <agent> and --model <id> are required to build a harness from a host + model.');
@@ -208,7 +182,6 @@ export async function addProfile(name, opts, label = 'Profile') {
         console.log(chalk.gray(`Try: agents run ${name} "hello"`));
         return;
     }
-    // Preset path.
     const presetName = opts.preset || name;
     const preset = getPreset(presetName);
     if (!preset) {

package/dist/commands/projects-todo.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerProjectTodoCommands(projects: Command): void;