@phnx-labs/agents-cli 1.22.120 → 1.22.121

package/dist/lib/agent-spec/primitives.js

@@ -1,39 +1,12 @@
-// Pure version primitives for the agent-spec engine — zero dependencies, so the
-// whole module (and versions.ts, which re-uses these) stays trivially testable.
-/**
- * The only shape a version string may take before it reaches an exec/shim/path
- * boundary. Accepts the literal `latest` or a 1–64 char run of `[A-Za-z0-9._+-]`
- * with no `..` traversal. This is THE validation gate — every resolver funnels
- * exact-version tokens through it.
- */
 export const VERSION_RE = /^(?:latest|(?!.*\.\.)[A-Za-z0-9._+-]{1,64})$/;
-/** Canonical qualifier set, in help/display order. `pinned` ≡ `default`. */
 export const AGENT_QUALIFIERS = ['latest', 'oldest', 'pinned', 'default', 'all'];
-/** Split a version into numeric `.`-segments (non-numeric tail → 0), e.g. `2026.2.19-2` → [2026,2,19]. */
 function numericParts(v) {
     return v.split('.').map((n) => parseInt(n, 10) || 0);
 }
-/**
- * Trailing `-<digits>` build suffix as a number (0 when absent). OpenClaw ships
- * same-day rebuilds as `2026.2.19-2` where a higher `-N` is NEWER — the opposite
- * of a semver pre-release. Used only to break exact numeric ties, so semver-style
- * versions (which carry no `-N`) are unaffected.
- */
 function buildSuffix(v) {
     const m = /-(\d+)$/.exec(v);
     return m ? parseInt(m[1], 10) : 0;
 }
-/**
- * Ordering for version strings (ascending).
- *   1. numeric segment comparison (semver-ish: `2.1.187` > `2.1.143`)
- *   2. tie → trailing `-N` build suffix, numerically (`2026.2.19-2` > `2026.2.19`)
- *   3. still tied → 0 (legacy behavior: `1.0` == `1.0.0`, non-numeric tails == 0)
- *
- * Deliberately NOT a full semver comparator: OpenClaw's `-N` is a rebuild marker
- * (higher = newer); a semver comparator would invert it. The `-N` tiebreak is the
- * only addition over the historical numeric-only compare, so suffix-free versions
- * (claude/codex semver) are unaffected.
- */
 export function compareVersions(a, b) {
     const na = numericParts(a);
     const nb = numericParts(b);

package/dist/lib/agent-spec/provider.js

@@ -1,5 +1,3 @@
-// The production VersionProvider: the only fs/meta-coupled file in the engine.
-// Everything else in this module is pure and testable without it.
 import { listInstalledVersions, getGlobalDefault, getIsolatedDefault, getProjectVersion, isVersionInstalled, } from '../installations/store.js';
 export const defaultVersionProvider = {
     listInstalled: (agent) => listInstalledVersions(agent),

package/dist/lib/agent-spec/resolve.d.ts

@@ -1,33 +1,10 @@
 import type { AgentId } from '../types.js';
 import { type AgentTarget, type VersionProvider, type VersionSource, type ResolveOptions, type VersionFilter } from './types.js';
-/**
- * Resolve an agent spec (single or comma-list) into concrete installed targets.
- * `@latest`/`@oldest`/`@all` range over installed versions.
- */
 export declare function resolveAgentTargets(spec: string, provider: VersionProvider, opts?: ResolveOptions): AgentTarget[];
-/**
- * Single-target commands (`run`, `sync`, `inspect`): resolve a spec that must
- * name exactly one installed version. Rejects `@all` / multi-target specs.
- */
 export declare function resolveSingleAgentTarget(spec: string, provider: VersionProvider, opts?: ResolveOptions): {
     agent: AgentId;
     version: string;
     source: VersionSource;
 };
-/**
- * Read/list commands: resolve a qualifier into a version filter.
- *   undefined / '' / @any → no filter (show all installed versions)
- *   @default / @pinned    → the literal 'default' sentinel (show the configured default)
- *   @latest/@oldest/x.y.z → a concrete version (throws if not installed)
- * Uniform `@default` handling fixes the prior rules-vs-view inconsistency.
- */
 export declare function resolveVersionFilter(agent: AgentId, qualifier: string | undefined | null, provider: VersionProvider, opts?: ResolveOptions): VersionFilter;
-/**
- * Concrete version filter for list/display commands whose downstream code
- * filters by an exact version string (not the `'default'` sentinel `view` uses).
- *   undefined / '' / @any → undefined  (no filter → show all installed)
- *   @default / @pinned    → the configured default version, or undefined if none
- *                           is set (falls back to show-all rather than erroring)
- *   @latest/@oldest/x.y.z → a concrete version (throws AgentSpecError if bad)
- */
 export declare function resolveListFilter(agent: AgentId, qualifier: string | undefined | null, provider: VersionProvider, opts?: ResolveOptions): string | undefined;

package/dist/lib/agent-spec/resolve.js

@@ -1,14 +1,6 @@
-// Pure agent-spec resolution — the engine core. Takes a VersionProvider instead
-// of touching the filesystem, so every branch is unit-testable with in-memory
-// fixtures. Domain = installed versions (`add`/install use a separate npm path).
-// Never calls process.exit; throws AgentSpecError on bad input.
 import { AGENTS, ALL_AGENT_IDS, resolveAgentName, formatAgentError } from '../agents.js';
 import { VERSION_RE } from './primitives.js';
 import { AgentSpecError, } from './types.js';
-/**
- * Resolve an agent spec (single or comma-list) into concrete installed targets.
- * `@latest`/`@oldest`/`@all` range over installed versions.
- */
 export function resolveAgentTargets(spec, provider, opts = {}) {
     const cwd = opts.cwd ?? process.cwd();
     const available = opts.availableAgents ?? ALL_AGENT_IDS;
@@ -17,8 +9,6 @@ export function resolveAgentTargets(spec, provider, opts = {}) {
     if (rawEntries.length === 0) {
         throw new AgentSpecError('Empty agent spec.', 'empty');
     }
-    // Expand the bare literal `all` (or `all@all`) into every available agent that
-    // has ≥1 installed version. Lenient: agents with nothing installed are skipped.
     const entries = [];
     for (const e of rawEntries) {
         if (e === 'all' || e === 'all@all') {
@@ -54,7 +44,6 @@ export function resolveAgentTargets(spec, provider, opts = {}) {
             throw new AgentSpecError(formatAgentError(agentToken, [...available]), 'unknown-agent');
         }
         const name = AGENTS[agent].name;
-        // ----- bare: project pin → global default → sole/ambiguous installed -----
         if (qualifier === null) {
             const proj = provider.getProjectVersion(agent, cwd);
             if (proj) {
@@ -66,10 +55,6 @@ export function resolveAgentTargets(spec, provider, opts = {}) {
                 push(agent, glob, 'global-default');
                 continue;
             }
-            // An isolated-only agent never has a global default — that is the point — so
-            // without this step `--agents codex` threw "No default version set" at a user
-            // who had explicitly run `agents use codex@<v>`. resolveVersion already had
-            // this fallback; the two resolvers had drifted apart.
             const iso = provider.getIsolatedDefault(agent);
             if (iso) {
                 push(agent, iso, 'isolated-default');
@@ -90,12 +75,8 @@ export function resolveAgentTargets(spec, provider, opts = {}) {
             }
             throw new AgentSpecError(`No default version set for ${name}. Specify one (${agent}@<version>) or set it: agents use ${agent}@<version>.`, 'no-default', agent, installed);
         }
-        // ----- @pinned / @default: the configured default (global, else isolated) -----
         if (qualifier === 'pinned' || qualifier === 'default') {
             const glob = provider.getGlobalDefault(agent);
-            // Report which kind it was: an isolated default owns none of the launcher /
-            // shim / config-symlink machinery a global default does, and callers that log
-            // the source shouldn't claim otherwise.
             const def = glob ?? provider.getIsolatedDefault(agent);
             if (!def) {
                 throw new AgentSpecError(`No default version set for ${name}. Run: agents use ${agent}@<version>`, 'no-default', agent, provider.listInstalled(agent));
@@ -103,7 +84,6 @@ export function resolveAgentTargets(spec, provider, opts = {}) {
             push(agent, def, glob ? 'global-default(@pinned)' : 'isolated-default');
             continue;
         }
-        // ----- @all: every installed version -----
         if (qualifier === 'all') {
             const installed = provider.listInstalled(agent);
             if (installed.length === 0) {
@@ -113,7 +93,6 @@ export function resolveAgentTargets(spec, provider, opts = {}) {
                 push(agent, v, 'explicit');
             continue;
         }
-        // ----- @latest / @oldest: ends of the installed range -----
         if (qualifier === 'latest' || qualifier === 'oldest') {
             const installed = provider.listInstalled(agent);
             if (installed.length === 0) {
@@ -123,7 +102,6 @@ export function resolveAgentTargets(spec, provider, opts = {}) {
             push(agent, isOldest ? installed[0] : installed[installed.length - 1], isOldest ? 'alias-oldest' : 'alias-latest');
             continue;
         }
-        // ----- exact version: validate then existence-check (no enumeration) -----
         if (!VERSION_RE.test(qualifier)) {
             throw new AgentSpecError(`Invalid version '${qualifier}' for ${name}. Allowed: latest or [A-Za-z0-9._+-]{1,64}.`, 'invalid-version', agent);
         }
@@ -136,10 +114,6 @@ export function resolveAgentTargets(spec, provider, opts = {}) {
     }
     return out;
 }
-/**
- * Single-target commands (`run`, `sync`, `inspect`): resolve a spec that must
- * name exactly one installed version. Rejects `@all` / multi-target specs.
- */
 export function resolveSingleAgentTarget(spec, provider, opts = {}) {
     const targets = resolveAgentTargets(spec, provider, opts);
     if (targets.length !== 1) {
@@ -151,13 +125,6 @@ export function resolveSingleAgentTarget(spec, provider, opts = {}) {
     }
     return { agent: t.agent, version: t.version, source: t.source };
 }
-/**
- * Read/list commands: resolve a qualifier into a version filter.
- *   undefined / '' / @any → no filter (show all installed versions)
- *   @default / @pinned    → the literal 'default' sentinel (show the configured default)
- *   @latest/@oldest/x.y.z → a concrete version (throws if not installed)
- * Uniform `@default` handling fixes the prior rules-vs-view inconsistency.
- */
 export function resolveVersionFilter(agent, qualifier, provider, opts = {}) {
     const q = qualifier?.trim();
     if (!q)
@@ -169,14 +136,6 @@ export function resolveVersionFilter(agent, qualifier, provider, opts = {}) {
     const { version, source } = resolveSingleAgentTarget(`${agent}@${q}`, provider, { ...opts, availableAgents: [agent] });
     return { version, source };
 }
-/**
- * Concrete version filter for list/display commands whose downstream code
- * filters by an exact version string (not the `'default'` sentinel `view` uses).
- *   undefined / '' / @any → undefined  (no filter → show all installed)
- *   @default / @pinned    → the configured default version, or undefined if none
- *                           is set (falls back to show-all rather than erroring)
- *   @latest/@oldest/x.y.z → a concrete version (throws AgentSpecError if bad)
- */
 export function resolveListFilter(agent, qualifier, provider, opts = {}) {
     const q = qualifier?.trim();
     if (!q || q === 'any')

package/dist/lib/agent-spec/types.d.ts

@@ -1,63 +1,29 @@
 import type { AgentId } from '../types.js';
-/** How a resolved version was arrived at — for provenance, display, and error rendering. */
 export type VersionSource = 'explicit' | 'project-pin' | 'global-default' | 'isolated-default' | 'global-default(@pinned)' | 'sole-installed' | 'newest-installed' | 'alias-latest' | 'alias-oldest' | 'none';
 export interface AgentTarget {
     agent: AgentId;
-    /** Resolved exact version, or null when the agent has no installed versions yet. */
     version: string | null;
     source: VersionSource;
 }
 type AgentSpecErrorCode = 'empty' | 'unknown-agent' | 'missing-version' | 'invalid-version' | 'not-installed' | 'no-default' | 'none-installed' | 'multi-not-allowed';
-/**
- * Thrown on any bad spec — never `process.exit`, so the engine is safe on the
- * hot path and in library contexts. `code` + `installed` let callers render a
- * consistent message (e.g. the "No default … Specify one:" version list) without
- * string-matching.
- */
 export declare class AgentSpecError extends Error {
     readonly code: AgentSpecErrorCode;
     readonly agent?: AgentId | undefined;
     readonly installed?: string[] | undefined;
     constructor(message: string, code: AgentSpecErrorCode, agent?: AgentId | undefined, installed?: string[] | undefined);
 }
-/**
- * The filesystem/meta seam. The pure resolver takes this instead of importing
- * versions.ts, so it is fully unit-testable with in-memory fixtures — no $HOME,
- * no subprocess. `provider.ts` supplies the production adapter.
- */
 export interface VersionProvider {
-    /** Installed versions, sorted ascending by `compareVersions`. */
     listInstalled(agent: AgentId): string[];
-    /** Version pinned by a project-root agents.yaml, or null. */
     getProjectVersion(agent: AgentId, cwd: string): string | null;
-    /** The configured global default version, or null. */
     getGlobalDefault(agent: AgentId): string | null;
-    /**
-     * The preferred isolated copy. Kept separate from getGlobalDefault on purpose: a
-     * global default owns the launcher, the bare shim and the real ~/.<agent> config
-     * symlink, and an isolated version must never acquire any of those. Folding the
-     * two together here would hand an isolated version back to every caller that
-     * reasonably assumes a global default means "the one that owns the launcher".
-     */
     getIsolatedDefault(agent: AgentId): string | null;
-    /** Whether an exact version is installed. */
     isInstalled(agent: AgentId, version: string): boolean;
 }
 export interface ResolveOptions {
-    /** Project dir for a bare spec's project pin. Defaults to process.cwd(). */
     cwd?: string;
-    /** Restrict which agents a spec may name (e.g. only mcp-capable). Defaults to all. */
     availableAgents?: readonly AgentId[];
-    /**
-     * Bare spec, >1 installed, no pin/default:
-     *   'error'  (default) → throw AgentSpecError{code:'no-default'} — safe for
-     *                        state-mutating commands (sync/use).
-     *   'newest'          → pick the newest installed (source:'newest-installed');
-     *                        callers should note it. For execution verbs (run/exec).
-     */
     onAmbiguous?: 'error' | 'newest';
 }
-/** A read/list command's version filter. `null` = show all; `'default'` = show the configured default. */
 export type FilterVersion = string | null | 'default';
 export interface VersionFilter {
     version: FilterVersion;

package/dist/lib/agent-spec/types.js

@@ -1,9 +1,3 @@
-/**
- * Thrown on any bad spec — never `process.exit`, so the engine is safe on the
- * hot path and in library contexts. `code` + `installed` let callers render a
- * consistent message (e.g. the "No default … Specify one:" version list) without
- * string-matching.
- */
 export class AgentSpecError extends Error {
     code;
     agent;

package/dist/lib/agents.d.ts

@@ -1,2 +1 @@
-/** Hub facade. The AGENTS table lives in agent-spec/agents.ts. */
 export * from './agent-spec/agents.js';

package/dist/lib/agents.js

@@ -1,2 +1 @@
-/** Hub facade. The AGENTS table lives in agent-spec/agents.ts. */
 export * from './agent-spec/agents.js';

package/dist/lib/analytics/mix-commands.d.ts

@@ -1,25 +1,2 @@
-/**
- * Counter / warehouse mix recipes under `agents insights`.
- *
- * These used to live as the top-level `agents trends` tree. That name was a
- * peer of `agents insights` with overlapping "analytics" meaning, so agents and
- * humans kept picking the wrong verb. The cheap counter path (sessions index +
- * usage.db) still exists — it is now `agents insights mix`. Latency stays on
- * `agents insights perf`; quota on `agents view`.
- *
- * One surface, not five: the board is `agents insights mix`, one section is
- * `agents insights mix <recipe>`, and `--list` names the recipe ids. The former
- * per-recipe shortcut commands (`harness-mix`, `model-mix`, …), the `recipes`
- * lister, and the `trends` alias were removed — `mix` already did all three.
- */
 import type { Command } from 'commander';
-/**
- * Attach counter-mix subcommands to a parent (typically `insights`).
- *
- * Layout:
- *   <parent> mix                 multi-recipe board
- *   <parent> mix <recipe>        one baked recipe (harness-mix, model-mix, …)
- *   <parent> mix --list          list recipe ids
- *   <parent> query               raw usage.db rows
- */
 export declare function registerMixCommands(parent: Command): void;

package/dist/lib/analytics/mix-commands.js

@@ -1,17 +1,3 @@
-/**
- * Counter / warehouse mix recipes under `agents insights`.
- *
- * These used to live as the top-level `agents trends` tree. That name was a
- * peer of `agents insights` with overlapping "analytics" meaning, so agents and
- * humans kept picking the wrong verb. The cheap counter path (sessions index +
- * usage.db) still exists — it is now `agents insights mix`. Latency stays on
- * `agents insights perf`; quota on `agents view`.
- *
- * One surface, not five: the board is `agents insights mix`, one section is
- * `agents insights mix <recipe>`, and `--list` names the recipe ids. The former
- * per-recipe shortcut commands (`harness-mix`, `model-mix`, …), the `recipes`
- * lister, and the `trends` alias were removed — `mix` already did all three.
- */
 import chalk from 'chalk';
 import { setHelpSections } from '../help.js';
 import { buildMixDashboard, analyticsWindow, runRecipe, RECIPE_IDS, } from './dashboard.js';
@@ -57,15 +43,6 @@ function renderMixDashboard(days, asJson, bannerLabel = 'agents insights mix') {
     for (const section of dash.sections)
         printMixSection(section);
 }
-/**
- * Attach counter-mix subcommands to a parent (typically `insights`).
- *
- * Layout:
- *   <parent> mix                 multi-recipe board
- *   <parent> mix <recipe>        one baked recipe (harness-mix, model-mix, …)
- *   <parent> mix --list          list recipe ids
- *   <parent> query               raw usage.db rows
- */
 export function registerMixCommands(parent) {
     const banner = 'agents insights mix';
     const mix = parent
@@ -75,9 +52,6 @@ export function registerMixCommands(parent) {
         .option('--list', 'List baked recipe ids and exit')
         .option('--json', 'Emit JSON instead of tables')
         .action(function summary(recipe) {
-        // optsWithGlobals(): --json collides by name with the `insights` parent, so
-        // commander binds it to the parent and this.opts() never sees it. Merging
-        // ancestor opts is what the per-recipe path below already does.
         const o = this.optsWithGlobals();
         if (o.list) {
             const list = listRecipes();

package/dist/lib/analytics/recipes.d.ts

@@ -1,4 +1,3 @@
-/** Time window for mix recipes under `agents insights mix`. */
 export interface AnalyticsWindow {
     days: number;
     sinceIso: string;

package/dist/lib/analytics/recipes.js

@@ -56,7 +56,7 @@ export function recipeHarnessMix(win) {
         try {
             db.close();
         }
-        catch { /* ignore */ }
+        catch { }
     }
 }
 function recipeModelMix(win) {
@@ -84,7 +84,7 @@ function recipeModelMix(win) {
         try {
             db.close();
         }
-        catch { /* ignore */ }
+        catch { }
     }
 }
 export function recipeToolsPerSession(win) {
@@ -94,11 +94,6 @@ export function recipeToolsPerSession(win) {
     if (!db)
         return { id, title, store: 'sessions', rows: [], empty: true };
     try {
-        // Counts come from tool_scan_ledger — one row per session the tool indexer
-        // has scanned, carrying that session's true call_count (0 included). The
-        // sessions.tool_call_count column is NOT the source: only the teams
-        // summarizer ever writes it (lib/teams/summarizer.ts), so reading it scored
-        // every non-teams session as 0 and pinned p50 at 0 fleet-wide.
         const tables = db.prepare(`SELECT name FROM sqlite_master WHERE type = 'table' AND name = 'tool_scan_ledger'`).all();
         if (tables.length === 0) {
             return { id, title, store: 'sessions', rows: [], empty: true };
@@ -141,7 +136,7 @@ export function recipeToolsPerSession(win) {
         try {
             db.close();
         }
-        catch { /* ignore */ }
+        catch { }
     }
 }
 function recipeTokenRatio(win) {
@@ -195,7 +190,7 @@ function recipeTokenRatio(win) {
         try {
             db.close();
         }
-        catch { /* ignore */ }
+        catch { }
     }
 }
 function recipeSessionVolume(win) {
@@ -229,7 +224,7 @@ function recipeSessionVolume(win) {
         try {
             db.close();
         }
-        catch { /* ignore */ }
+        catch { }
     }
 }
 function recipeSecretsHot(win) {

package/dist/lib/analytics/usage-db.js

@@ -53,7 +53,7 @@ function open() {
         try {
             cached.db.close();
         }
-        catch { /* ignore */ }
+        catch { }
         cached = null;
     }
     try {
@@ -65,7 +65,7 @@ function open() {
         try {
             db.prepare(`DELETE FROM usage_events WHERE ts < ?`).run(new Date(Date.now() - EVENT_RETENTION_MS).toISOString());
         }
-        catch { /* prune best-effort */ }
+        catch { }
         migrateSecretsUsageOnce(db);
         cached = { path: dbPath, db };
         return db;
@@ -101,13 +101,12 @@ function migrateSecretsUsageOnce(db) {
                 try {
                     legacy.close();
                 }
-                catch { /* ignore */ }
+                catch { }
             }
         }
         db.prepare(`INSERT OR REPLACE INTO meta(key, value) VALUES ('migrate_secrets_v1', '1')`).run();
     }
     catch {
-        /* migrate is best-effort */
     }
 }
 export function recordUsage(p) {
@@ -123,7 +122,6 @@ export function recordUsage(p) {
        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(p.ts ?? new Date().toISOString(), p.kind, p.name, p.event, p.agent ?? null, p.sessionId ?? null, p.machine ?? localMachineId(), p.actor ?? null, p.source ?? null, p.status ?? 'success', p.meta != null ? JSON.stringify(p.meta) : null);
     }
     catch {
-        /* telemetry must never break callers */
     }
 }
 export function usageDbPath() {
@@ -226,7 +224,7 @@ export function closeUsageDb() {
         try {
             cached.db.close();
         }
-        catch { /* ignore */ }
+        catch { }
         cached = null;
     }
 }

package/dist/lib/answer-router.d.ts

@@ -1,93 +1,32 @@
-/**
- * Parked-agent answer router (RUSH-1474).
- *
- * `agents message` historically only enqueued into the mailbox (delivered at the
- * next PreToolUse). That steers a *running* agent between tool calls but never
- * unblocks a *parked* agent:
- *   - interactive TUI open on AskUserQuestion (needs keystrokes, not context)
- *   - headless run waiting on input (no next tool call; needs resume)
- *
- * This module picks the delivery mechanism from (open feed block × session
- * liveness × runtime rail). Pure — unit-testable without a live terminal.
- */
 import { type OpenBlock, type BlockOption } from './feed/feed.js';
 import type { ActiveSession } from './session/active.js';
 import type { InjectTarget } from './terminal/index.js';
 export type AnswerRouteKind = 'mailbox' | 'tmux' | 'iterm' | 'resume' | 'refuse';
 export interface AnswerRoute {
     kind: AnswerRouteKind;
-    /** Human reason shown in CLI output / refused errors. */
     reason: string;
-    /**
-     * Keystrokes / payload for the chosen path.
-     *  - mailbox: unused (text is enqueued as-is)
-     *  - tmux/iterm: the digit or free-text to inject
-     *  - resume: the free-text prompt to pass on re-entry
-     */
     payload?: string;
-    /** Inject target when kind is tmux/iterm. */
     inject?: InjectTarget;
-    /** Session id + agent kind for resume. */
     resume?: {
         sessionId: string;
         agent: string;
     };
-    /**
-     * Whether to append Enter after the injected payload. Default (omitted) is
-     * true. A cancel keystroke (Escape, from a deny / send-back choice) sets this
-     * false — the ESC byte itself dismisses the prompt, and a trailing newline
-     * would submit a stray empty line into the composer behind it.
-     */
     enter?: boolean;
 }
 interface AnswerRouterInput {
-    /** Resolved mailbox / session id. */
     mailboxId: string;
-    /** Answer text (option label or free text). */
     answer: string;
-    /** Open feed block for this agent, if any. */
     block?: OpenBlock | null;
-    /** Live session row matching the mailbox, if any. */
     session?: ActiveSession | null;
 }
-/**
- * Match free-text answer against question options.
- * Exact (case-insensitive) > startsWith > includes. Returns 0-based index or -1.
- */
 export declare function matchOptionIndex(answer: string, options: Array<Pick<BlockOption, 'label'>> | undefined): number;
-/**
- * Build the keystroke payload that closes an AskUserQuestion TUI.
- * Numbered options are selected by digit (1-based) + Enter. Free text with an
- * "Other" option selects Other then types; without Other, types the answer.
- */
 export declare function keystrokesForAnswer(answer: string, options?: Array<Pick<BlockOption, 'label'>>): {
     payload: string;
     matched: 'option' | 'free-text' | 'other';
     enter?: boolean;
 };
-/** True when the session is waiting on user input (parked on a question/plan). */
 export declare function isParkedOnInput(session: ActiveSession | null | undefined): boolean;
-/**
- * True when an open feed block still needs an answer.
- *
- * Openness comes from {@link deriveBlockState}, not from `block.answer` being
- * truthy: a PENDING claim records the answer while deliberately leaving the
- * block `open` (feed.ts `recordAnswer`'s two-phase mode), so reading the field
- * directly would call a claimed-but-undelivered block "closed" — and a retry of
- * a stranded claim would then re-route a parked headless agent to the mailbox it
- * will never drain (PHNX-3999).
- */
 export declare function isOpenQuestionBlock(block: OpenBlock | null | undefined): boolean;
-/**
- * Pick the delivery mechanism for one answer.
- *
- * Precedence:
- *   1. Parked on open question + injectable rail (tmux/iterm) → keystroke
- *   2. Parked on open question + headless (no rail) → resume with answer
- *   3. Parked on open question + no rail + interactive → refuse (don't mailbox-drop)
- *   4. Otherwise → mailbox (running agent between tool calls)
- */
 export declare function resolveAnswerRoute(input: AnswerRouterInput): AnswerRoute;
-/** Build argv for a headless resume that continues with the answer text. */
 export declare function resumeArgv(route: AnswerRoute): string[];
 export {};