@phnx-labs/agents-cli 1.22.119 → 1.22.121

package/dist/commands/prune.js

@@ -1,27 +1,3 @@
-/**
- * `agents prune cleanup` — destructive cleanup across the install.
- *
- * Cleanup targets:
- *   - Resource orphans: command/skill/hook files inside a version home that no
- *     longer come from any source (deleted from ~/.agents/ but never reconciled
- *     into the version install).
- *   - Version duplicates: older installed versions of an agent that share an
- *     account with a newer installed version of the same agent.
- *   - Trash/session targets are retained as no-op compatibility shims: version
- *     homes and session history are durable and must not be hard-deleted by
- *     agents-cli.
- *   - Runs: routine execution logs, keeping only the last N per job.
- *
- * Sync (additive: copy missing/changed files into version homes) is the job
- * of `agents sync` / `agents refresh` — the shim's launch hook
- * (`agents sync --launch`) is project-scoped only and deliberately skips
- * version-home reconciliation. Pruning, however, is destructive, so it stays
- * explicit.
- *
- * Default scope: each agent's currently-pinned default version for orphan
- * cleanup, plus the standard cross-agent version-dedup pass. Pass `--all`
- * to widen orphan cleanup to every installed version.
- */
 import * as fs from 'fs';
 import chalk from 'chalk';
 import { formatBytes } from '../lib/format.js';
@@ -66,11 +42,6 @@ function collectOrphans(types, all) {
     }
     if (types.includes('hooks')) {
         for (const { agent, version } of scopePairs(iterHooksCapableVersions(), all)) {
-            // Orphan hooks = scripts present in the version home but absent from
-            // every configured source (user + system + extras) — genuinely dead
-            // files, not merely unregistered ones (sync copies helper/test scripts
-            // that no manifest entry declares). Same definition the doctor overview
-            // reports (PHNX-2693).
             const orphans = listUnmanagedHooksInVersionHome(agent, version);
             if (orphans.length > 0) {
                 groups.push({ type: 'hooks', agent, version, orphans });
@@ -122,7 +93,6 @@ function parseTarget(arg) {
     if (arg === 'versions') {
         return { resourceTypes: [], includeVersions: true };
     }
-    // Try treating as an agent name — shortcut for `prune versions <agent>`.
     const agentId = resolveAgentName(arg);
     if (agentId) {
         return { resourceTypes: [], includeVersions: true, versionAgent: agentId };

package/dist/commands/ps-roster.d.ts

@@ -0,0 +1,92 @@
+import { type ActiveSession } from '../lib/session/active.js';
+export interface LiveStatusFlags {
+    working?: boolean;
+    idle?: boolean;
+    waiting?: boolean;
+    orphan?: boolean;
+    orphaned?: boolean;
+    crashed?: boolean;
+    closed?: boolean;
+    abandoned?: boolean;
+    queued?: boolean;
+    unknown?: boolean;
+}
+export declare function statusColor(status: ActiveSession['status']): (s: string) => string;
+export declare function cleanPreview(text: string): string;
+export declare function buildSessionDescription(s: ActiveSession): string;
+export declare function formatActiveRowDescription(s: ActiveSession): string;
+export declare function indexActiveBySessionId(active: ActiveSession[]): Map<string, ActiveSession>;
+export declare function liveGlyphAndPreview(a: ActiveSession | undefined): {
+    glyph: string;
+    preview: string;
+};
+export declare function liveStatusWord(a: ActiveSession | undefined): string;
+export declare function isAwaitingUser(s: ActiveSession): boolean;
+export declare function signalBadges(s: Pick<ActiveSession, 'awaitingReason' | 'pr' | 'worktree' | 'ticket'>): string;
+export declare function renderActiveRowLines(s: ActiveSession, indent: string, termW: number): string[];
+export declare function ownerLabel(s: ActiveSession): string;
+interface ActiveSessionsLayout {
+    workspaces: Array<{
+        key: string;
+        total: number;
+        windows: Array<{
+            windowId: string;
+            sessions: ActiveSession[];
+        }>;
+        flat: ActiveSession[];
+    }>;
+}
+export declare function groupActiveSessions(sessions: ActiveSession[]): ActiveSessionsLayout;
+interface MachineGroup {
+    machine: string;
+    isLocal: boolean;
+    total: number;
+    layout: ActiveSessionsLayout;
+}
+interface MachineGroupedLayout {
+    machines: MachineGroup[];
+}
+export declare function groupSessionsByMachine(sessions: ActiveSession[], localMachine: string): MachineGroupedLayout;
+export declare function dedupeByMachineSession(sessions: ActiveSession[]): ActiveSession[];
+export declare function filterActiveSessionsByHostScope(sessions: ActiveSession[], hosts: string[] | undefined, self: string): ActiveSession[];
+export declare function shouldIncludeLocal(hosts: string[] | undefined, self: string): boolean;
+export declare function remoteHostsToDial(hosts: string[] | undefined, self: string): string[] | undefined;
+export declare function gatherActiveSessions(opts?: {
+    local?: boolean;
+    hosts?: string[];
+    forceRefresh?: boolean;
+}): Promise<{
+    sessions: ActiveSession[];
+    remoteDeviceCount: number;
+    remoteSkipped?: string[];
+    remoteDiscoveryFailed?: boolean;
+}>;
+export declare function renderActiveSessions(asJson: boolean, waitingOnly?: boolean, opts?: {
+    local?: boolean;
+    hosts?: string[];
+    bookmarksOnly?: boolean;
+    statuses?: LiveStatusFilter[];
+    routine?: boolean | string;
+}): Promise<void>;
+export declare function filterActiveSessionsByRoutine(sessions: ActiveSession[], routine: boolean | string | undefined): ActiveSession[];
+export type LiveStatusFilter = 'working' | 'idle' | 'waiting' | 'orphaned' | 'crashed' | 'closed' | 'abandoned' | 'queued' | 'unknown';
+export declare function matchesLiveStatus(session: ActiveSession, status: LiveStatusFilter): boolean;
+export declare function requestedLiveStatuses(options: LiveStatusFlags): LiveStatusFilter[];
+export declare function resolveRoutineName(query: string, names: readonly string[]): string | null;
+export interface LiveRosterOptions extends LiveStatusFlags {
+    json?: boolean;
+    interactive?: boolean;
+    local?: boolean;
+    host?: string[];
+    teams?: boolean;
+    agent?: string;
+    since?: string;
+    until?: string;
+    all?: boolean;
+    bookmarks?: boolean;
+    routine?: boolean | string;
+    project?: string;
+    sort?: string;
+}
+export declare function runLiveRoster(options: LiveRosterOptions): Promise<void>;
+export {};