@phnx-labs/agents-cli 1.12.0 → 1.14.2

package/dist/commands/status.js

@@ -1,5 +1,12 @@
+/**
+ * Deprecated status command.
+ *
+ * Registers the `agents status` command as a backward-compatible alias
+ * for `agents view`. Prints a deprecation notice and delegates to viewAction.
+ */
 import chalk from 'chalk';
 import { viewAction } from './view.js';
+/** Register the deprecated `agents status` command (alias for `agents view`). */
 export function registerStatusCommand(program) {
     // Deprecated: use `agents view` instead
     program
@@ -16,4 +23,3 @@ export function registerStatusCommand(program) {
         }
     });
 }
-//# sourceMappingURL=status.js.map

package/dist/commands/subagents.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Subagent management commands.
+ *
+ * Registers the `agents subagents` command tree for listing, viewing,
+ * installing, and removing lightweight agent definitions (AGENT.md files)
+ * that parent agents can spawn for focused subtasks.
+ */
 import type { Command } from 'commander';
+/** Register the `agents subagents` command tree. */
 export declare function registerSubagentsCommands(program: Command): void;
-//# sourceMappingURL=subagents.d.ts.map

package/dist/commands/subagents.js

@@ -1,3 +1,10 @@
+/**
+ * Subagent management commands.
+ *
+ * Registers the `agents subagents` command tree for listing, viewing,
+ * installing, and removing lightweight agent definitions (AGENT.md files)
+ * that parent agents can spawn for focused subtasks.
+ */
 import chalk from 'chalk';
 import ora from 'ora';
 import * as fs from 'fs';
@@ -10,6 +17,7 @@ import { listInstalledVersions, syncResourcesToVersion, getGlobalDefault, getVer
 import { getSubagentsDir } from '../lib/state.js';
 import { isInteractiveTerminal, isPromptCancelled, requireInteractiveSelection, requireDestructiveArg, } from './utils.js';
 import { showResourceList, buildTargetsSection, } from './resource-view.js';
+/** Replace the home directory prefix with ~ for display. */
 function formatPath(p) {
     const home = process.env.HOME || '';
     if (home && p.startsWith(home)) {
@@ -17,6 +25,7 @@ function formatPath(p) {
     }
     return p;
 }
+/** Register the `agents subagents` command tree. */
 export function registerSubagentsCommands(program) {
     const subagentsCmd = program
         .command('subagents')
@@ -271,6 +280,7 @@ function buildSubagentTargets(name) {
     }
     return targets;
 }
+/** Build resource rows for all centrally-installed subagents with sync status. */
 function buildSubagentRows() {
     const central = listInstalledSubagents();
     if (central.length === 0)
@@ -311,6 +321,7 @@ function buildSubagentRows() {
     });
     return rows;
 }
+/** Build the multi-line detail pane shown when a subagent is selected in the picker. */
 function formatSubagentDetail(sub, targets) {
     const lines = [];
     lines.push(chalk.bold.cyan(sub.name));
@@ -347,4 +358,3 @@ function formatSubagentDetail(sub, targets) {
     }
     return lines.join('\n');
 }
-//# sourceMappingURL=subagents.js.map

package/dist/commands/sync.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Internal resource sync command.
+ *
+ * Registers the hidden `agents sync` command invoked by shims to
+ * synchronize resources (commands, skills, hooks, memory, MCP, etc.)
+ * into a specific agent version home before launch.
+ */
 import { Command } from 'commander';
+/** Register the hidden `agents sync` command. */
 export declare function registerSyncCommand(program: Command): void;
-//# sourceMappingURL=sync.d.ts.map

package/dist/commands/sync.js

@@ -1,6 +1,14 @@
+/**
+ * Internal resource sync command.
+ *
+ * Registers the hidden `agents sync` command invoked by shims to
+ * synchronize resources (commands, skills, hooks, memory, MCP, etc.)
+ * into a specific agent version home before launch.
+ */
 import chalk from 'chalk';
 import { AGENTS } from '../lib/agents.js';
 import { isVersionInstalled, syncResourcesToVersion } from '../lib/versions.js';
+/** Register the hidden `agents sync` command. */
 export function registerSyncCommand(program) {
     program
         .command('sync', { hidden: true })
@@ -59,4 +67,3 @@ export function registerSyncCommand(program) {
         }
     });
 }
-//# sourceMappingURL=sync.js.map

package/dist/commands/teams-picker.d.ts

@@ -7,8 +7,11 @@ export interface TeamRow {
 export interface PickedTeam {
     team: string;
 }
+/** Format a single team as a one-line row for the list table or picker label. */
 export declare function formatTeamRow(row: TeamRow, nameWidth: number, compositionWidth: number): string;
+/** Build a multi-line preview string for the picker's detail pane. */
 export declare function buildTeamPreview(row: TeamRow): string;
+/** Print a non-interactive team table to stdout (used when output is piped). */
 export declare function printTeamTable(rows: TeamRow[]): void;
+/** Show an interactive team picker with fuzzy search and return the selected team name. */
 export declare function teamPicker(rows: TeamRow[], initialSearch?: string): Promise<PickedTeam | null>;
-//# sourceMappingURL=teams-picker.d.ts.map

package/dist/commands/teams-picker.js

@@ -1,3 +1,11 @@
+/**
+ * Interactive team picker and table renderer.
+ *
+ * Provides the fuzzy-searchable team list for `agents teams list` in a TTY,
+ * and the non-interactive table fallback when output is piped. Builds rich
+ * preview panels showing teammate composition, status breakdown, and last
+ * activity for each team.
+ */
 import chalk from 'chalk';
 import { itemPicker } from '../lib/picker.js';
 const AGENT_LABEL = {
@@ -45,6 +53,22 @@ function firstLine(s) {
     }
     return '';
 }
+function compactPrompt(s, max = 140) {
+    return truncate(s.replace(/\s+/g, ' ').trim(), max);
+}
+function formatTimestamp(iso) {
+    if (!iso)
+        return null;
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime()))
+        return null;
+    return d.toLocaleString(undefined, {
+        month: 'short',
+        day: 'numeric',
+        hour: 'numeric',
+        minute: '2-digit',
+    });
+}
 function displayAgent(agent, version) {
     const label = AGENT_LABEL[agent] || agent;
     return version ? `${label}@${version}` : label;
@@ -131,6 +155,7 @@ function workCell(agents) {
         return `${tools} tool${tools === 1 ? '' : 's'}`;
     return '';
 }
+/** Format a single team as a one-line row for the list table or picker label. */
 export function formatTeamRow(row, nameWidth, compositionWidth) {
     const t = row.team;
     const name = chalk.cyan(t.task_name.padEnd(nameWidth));
@@ -146,6 +171,13 @@ export function formatTeamRow(row, nameWidth, compositionWidth) {
 function handle(a) {
     return a.name || a.agent_id.slice(0, 8);
 }
+function displayHandle(a) {
+    if (a.name && a.session_label && a.name !== a.session_label) {
+        return `${a.name} / ${a.session_label}`;
+    }
+    return a.name || a.session_label || a.agent_id.slice(0, 8);
+}
+/** Build a multi-line preview string for the picker's detail pane. */
 export function buildTeamPreview(row) {
     const t = row.team;
     const lines = [];
@@ -169,11 +201,13 @@ export function buildTeamPreview(row) {
     }
     lines.push('');
     // Column widths
-    const nameW = Math.max(6, ...row.agents.map((a) => handle(a).length));
+    const nameW = Math.max(6, ...row.agents.map((a) => displayHandle(a).length));
     const agentW = Math.max(8, ...row.agents.map((a) => displayAgent(a.agent_type, a.version).length));
     for (const a of row.agents) {
         const stat = statusColor(a.status)(a.status);
         const metaParts = [];
+        if (a.task_type)
+            metaParts.push(chalk.magenta(a.task_type));
         if (a.duration)
             metaParts.push(chalk.white(a.duration));
         metaParts.push(chalk.gray(`${a.tool_count} tools`));
@@ -181,7 +215,24 @@ export function buildTeamPreview(row) {
         if (modified)
             metaParts.push(chalk.gray(`${modified} file${modified === 1 ? '' : 's'} modified`));
         const meta = metaParts.join(DOT);
-        lines.push(`  ${chalk.cyan(handle(a).padEnd(nameW))}  ${displayAgent(a.agent_type, a.version).padEnd(agentW)}  ${stat}${DOT}${meta}`);
+        lines.push(`  ${chalk.cyan(displayHandle(a).padEnd(nameW))}  ${displayAgent(a.agent_type, a.version).padEnd(agentW)}  ${stat}${DOT}${meta}`);
+        if (a.prompt) {
+            lines.push(`    ${chalk.gray('task')} ${chalk.white(compactPrompt(a.prompt))}`);
+        }
+        const started = formatTimestamp(a.started_at);
+        const completed = formatTimestamp(a.completed_at);
+        if (started || completed) {
+            const parts = [];
+            if (started)
+                parts.push(`started ${started}`);
+            if (completed)
+                parts.push(`ended ${completed}`);
+            lines.push(`    ${chalk.gray(parts.join(' · '))}`);
+        }
+        for (const call of a.recent_tool_calls.slice(-3)) {
+            const when = call.timestamp ? `${relTime(call.timestamp)} ` : '';
+            lines.push(`    ${chalk.gray(when)}${chalk.bold(call.tool)} ${chalk.gray(truncate(call.summary, 96))}`);
+        }
         const lastMsg = a.last_messages[a.last_messages.length - 1];
         if (lastMsg) {
             const oneLine = firstLine(lastMsg);
@@ -195,6 +246,7 @@ export function buildTeamPreview(row) {
     }
     return lines.join('\n');
 }
+/** Print a non-interactive team table to stdout (used when output is piped). */
 export function printTeamTable(rows) {
     if (rows.length === 0)
         return;
@@ -240,6 +292,7 @@ function searchHaystack(row) {
         parts.push('stopped');
     return parts.join(' ').toLowerCase();
 }
+/** Show an interactive team picker with fuzzy search and return the selected team name. */
 export async function teamPicker(rows, initialSearch) {
     const nameWidth = Math.max(12, ...rows.map((r) => r.team.task_name.length));
     const compositionWidth = Math.max(8, ...rows.map((r) => formatComposition(r.agents).length));
@@ -275,4 +328,3 @@ export async function teamPicker(rows, initialSearch) {
         return null;
     return { team: picked.item.team.task_name };
 }
-//# sourceMappingURL=teams-picker.js.map

package/dist/commands/teams.d.ts

@@ -1,3 +1,17 @@
+/**
+ * Team management commands for organizing multi-agent collaboration.
+ *
+ * Implements `agents teams` -- create named teams, add teammates (background
+ * agent processes), check status with session-aware previews, manage DAG
+ * dependencies between teammates, and clean up when work is done.
+ */
 import type { Command } from 'commander';
+import { AgentManager } from '../lib/teams/agents.js';
+/**
+ * Register the generic cloud dispatcher — staged cloud teammates get
+ * dispatched when their --after deps resolve, using repo/branch stored on
+ * the teammate itself so we don't need the original --cloud CLI args.
+ */
+export declare function wireCloudDispatcher(mgr: AgentManager): void;
+/** Register the `agents teams` command tree (list, create, add, status, start, remove, disband, logs, doctor). */
 export declare function registerTeamsCommands(program: Command): void;
-//# sourceMappingURL=teams.d.ts.map