@phnx-labs/agents-cli 0.1.0 → 1.14.1

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