@phnx-labs/agents-cli 0.1.0

package/dist/lib/subagents.js

@@ -0,0 +1,402 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as yaml from 'yaml';
+import { getSubagentsDir } from './state.js';
+/**
+ * Parse AGENT.md frontmatter to extract subagent metadata
+ */
+export function parseSubagentFrontmatter(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n');
+        // Check for YAML frontmatter
+        if (lines[0] === '---') {
+            const endIndex = lines.slice(1).findIndex((l) => l === '---');
+            if (endIndex > 0) {
+                const frontmatter = lines.slice(1, endIndex + 1).join('\n');
+                const parsed = yaml.parse(frontmatter);
+                return {
+                    name: parsed.name || '',
+                    description: parsed.description || '',
+                    model: parsed.model,
+                    color: parsed.color,
+                };
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get the body content of AGENT.md (everything after frontmatter)
+ */
+export function getSubagentBody(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return '';
+    }
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const lines = content.split('\n');
+    // Skip YAML frontmatter
+    if (lines[0] === '---') {
+        const endIndex = lines.slice(1).findIndex((l) => l === '---');
+        if (endIndex > 0) {
+            return lines.slice(endIndex + 2).join('\n').trim();
+        }
+    }
+    return content;
+}
+/**
+ * Discover subagents from a repository
+ * Looks for subagents/{name}/AGENT.md
+ */
+export function discoverSubagentsFromRepo(repoPath) {
+    const subagents = [];
+    const subagentsDir = path.join(repoPath, 'subagents');
+    if (!fs.existsSync(subagentsDir)) {
+        return subagents;
+    }
+    for (const dir of fs.readdirSync(subagentsDir)) {
+        const dirPath = path.join(subagentsDir, dir);
+        if (!fs.statSync(dirPath).isDirectory())
+            continue;
+        const agentMd = path.join(dirPath, 'AGENT.md');
+        if (!fs.existsSync(agentMd)) {
+            // Skip directories without AGENT.md
+            continue;
+        }
+        const frontmatter = parseSubagentFrontmatter(agentMd);
+        if (!frontmatter) {
+            console.warn(`Warning: ${agentMd} has invalid frontmatter, skipping`);
+            continue;
+        }
+        // Collect all .md files in the directory
+        const files = fs.readdirSync(dirPath)
+            .filter(f => f.endsWith('.md'))
+            .sort();
+        subagents.push({
+            name: dir, // Use directory name as canonical name
+            path: dirPath,
+            files,
+            agentMd,
+            frontmatter,
+        });
+    }
+    return subagents;
+}
+/**
+ * List installed subagents from ~/.agents/subagents/
+ */
+export function listInstalledSubagents() {
+    const subagents = [];
+    const subagentsDir = getSubagentsDir();
+    if (!fs.existsSync(subagentsDir)) {
+        return subagents;
+    }
+    for (const dir of fs.readdirSync(subagentsDir)) {
+        const dirPath = path.join(subagentsDir, dir);
+        if (!fs.statSync(dirPath).isDirectory())
+            continue;
+        const agentMd = path.join(dirPath, 'AGENT.md');
+        if (!fs.existsSync(agentMd))
+            continue;
+        const frontmatter = parseSubagentFrontmatter(agentMd);
+        if (!frontmatter)
+            continue;
+        const files = fs.readdirSync(dirPath)
+            .filter(f => f.endsWith('.md'))
+            .sort();
+        subagents.push({
+            name: dir,
+            path: dirPath,
+            files,
+            frontmatter,
+        });
+    }
+    return subagents;
+}
+/**
+ * Get a specific installed subagent
+ */
+export function getInstalledSubagent(name) {
+    const subagentsDir = getSubagentsDir();
+    const dirPath = path.join(subagentsDir, name);
+    if (!fs.existsSync(dirPath) || !fs.statSync(dirPath).isDirectory()) {
+        return null;
+    }
+    const agentMd = path.join(dirPath, 'AGENT.md');
+    if (!fs.existsSync(agentMd)) {
+        return null;
+    }
+    const frontmatter = parseSubagentFrontmatter(agentMd);
+    if (!frontmatter) {
+        return null;
+    }
+    const files = fs.readdirSync(dirPath)
+        .filter(f => f.endsWith('.md'))
+        .sort();
+    return {
+        name,
+        path: dirPath,
+        files,
+        frontmatter,
+    };
+}
+/**
+ * Install a subagent centrally to ~/.agents/subagents/{name}/
+ */
+export function installSubagentCentrally(sourcePath, name) {
+    const subagentsDir = getSubagentsDir();
+    const targetDir = path.join(subagentsDir, name);
+    try {
+        // Ensure subagents directory exists
+        if (!fs.existsSync(subagentsDir)) {
+            fs.mkdirSync(subagentsDir, { recursive: true });
+        }
+        // Remove existing if present
+        if (fs.existsSync(targetDir)) {
+            fs.rmSync(targetDir, { recursive: true });
+        }
+        // Copy entire directory
+        fs.cpSync(sourcePath, targetDir, { recursive: true });
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+}
+/**
+ * Remove an installed subagent
+ */
+export function removeSubagent(name) {
+    const subagentsDir = getSubagentsDir();
+    const targetDir = path.join(subagentsDir, name);
+    if (!fs.existsSync(targetDir)) {
+        return { success: false, error: `Subagent '${name}' not found` };
+    }
+    try {
+        fs.rmSync(targetDir, { recursive: true });
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+}
+/**
+ * Transform a subagent directory into a single .md file for Claude
+ * Combines AGENT.md frontmatter + body with other files as sections
+ */
+export function transformSubagentForClaude(subagentDir) {
+    const agentMd = path.join(subagentDir, 'AGENT.md');
+    const frontmatter = parseSubagentFrontmatter(agentMd);
+    const body = getSubagentBody(agentMd);
+    if (!frontmatter) {
+        throw new Error(`Invalid AGENT.md in ${subagentDir}`);
+    }
+    // Build the frontmatter section
+    const frontmatterYaml = yaml.stringify({
+        name: frontmatter.name,
+        description: frontmatter.description,
+        ...(frontmatter.model && { model: frontmatter.model }),
+        ...(frontmatter.color && { color: frontmatter.color }),
+    }).trim();
+    let result = `---\n${frontmatterYaml}\n---\n\n${body}`;
+    // Append other .md files as sections
+    const files = fs.readdirSync(subagentDir)
+        .filter(f => f.endsWith('.md') && f !== 'AGENT.md')
+        .sort();
+    for (const file of files) {
+        const filePath = path.join(subagentDir, file);
+        const content = fs.readFileSync(filePath, 'utf-8').trim();
+        const sectionName = file.replace('.md', '');
+        // Convert filename to title case (SOUL.md -> Soul)
+        const title = sectionName.charAt(0).toUpperCase() + sectionName.slice(1).toLowerCase();
+        result += `\n\n## ${title}\n\n${content}`;
+    }
+    return result;
+}
+/**
+ * Sync a subagent to an OpenClaw workspace
+ * Copies full directory, renames AGENT.md to AGENTS.md
+ */
+export function syncSubagentToOpenclaw(subagentDir, targetDir) {
+    try {
+        // Ensure target directory exists
+        if (!fs.existsSync(targetDir)) {
+            fs.mkdirSync(targetDir, { recursive: true });
+        }
+        // Copy all files
+        for (const file of fs.readdirSync(subagentDir)) {
+            const sourcePath = path.join(subagentDir, file);
+            const targetFile = file === 'AGENT.md' ? 'AGENTS.md' : file;
+            const targetPath = path.join(targetDir, targetFile);
+            if (fs.statSync(sourcePath).isFile()) {
+                fs.copyFileSync(sourcePath, targetPath);
+            }
+        }
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+}
+/**
+ * Install a subagent to a specific agent's home
+ */
+export function installSubagentToAgent(subagentDir, subagentName, agent, agentHome) {
+    if (agent === 'claude') {
+        // Claude: flatten to single .md file
+        const agentsDir = path.join(agentHome, '.claude', 'agents');
+        if (!fs.existsSync(agentsDir)) {
+            fs.mkdirSync(agentsDir, { recursive: true });
+        }
+        try {
+            const transformed = transformSubagentForClaude(subagentDir);
+            fs.writeFileSync(path.join(agentsDir, `${subagentName}.md`), transformed);
+            return { success: true };
+        }
+        catch (err) {
+            return { success: false, error: String(err) };
+        }
+    }
+    else if (agent === 'openclaw') {
+        // OpenClaw: copy full directory
+        const targetDir = path.join(agentHome, '.openclaw', subagentName);
+        return syncSubagentToOpenclaw(subagentDir, targetDir);
+    }
+    else {
+        // Other agents don't support subagents yet
+        return { success: false, error: `Agent '${agent}' does not support subagents` };
+    }
+}
+/**
+ * Remove a subagent from a specific agent's home
+ */
+export function removeSubagentFromAgent(subagentName, agent, agentHome) {
+    try {
+        if (agent === 'claude') {
+            const targetPath = path.join(agentHome, '.claude', 'agents', `${subagentName}.md`);
+            if (fs.existsSync(targetPath)) {
+                fs.unlinkSync(targetPath);
+            }
+            return { success: true };
+        }
+        else if (agent === 'openclaw') {
+            const targetDir = path.join(agentHome, '.openclaw', subagentName);
+            if (fs.existsSync(targetDir)) {
+                fs.rmSync(targetDir, { recursive: true });
+            }
+            return { success: true };
+        }
+        else {
+            return { success: true }; // No-op for unsupported agents
+        }
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+}
+/**
+ * Check if subagent content matches between source and installed
+ */
+export function subagentContentMatches(installedDir, sourceDir) {
+    if (!fs.existsSync(installedDir) || !fs.existsSync(sourceDir)) {
+        return false;
+    }
+    const installedFiles = fs.readdirSync(installedDir).filter(f => f.endsWith('.md')).sort();
+    const sourceFiles = fs.readdirSync(sourceDir).filter(f => f.endsWith('.md')).sort();
+    if (installedFiles.length !== sourceFiles.length) {
+        return false;
+    }
+    for (let i = 0; i < installedFiles.length; i++) {
+        if (installedFiles[i] !== sourceFiles[i]) {
+            return false;
+        }
+        const installedContent = fs.readFileSync(path.join(installedDir, installedFiles[i]), 'utf-8');
+        const sourceContent = fs.readFileSync(path.join(sourceDir, sourceFiles[i]), 'utf-8');
+        if (installedContent !== sourceContent) {
+            return false;
+        }
+    }
+    return true;
+}
+// Agents that support subagents
+export const SUBAGENT_CAPABLE_AGENTS = ['claude', 'openclaw'];
+/**
+ * List subagents installed to a specific agent's home
+ * Claude: scans ~/.claude/agents/{name}.md
+ * OpenClaw: scans ~/.openclaw/{name}/AGENTS.md
+ */
+export function listSubagentsForAgent(agentId, home) {
+    const subagents = [];
+    if (agentId === 'claude') {
+        // Claude: flat .md files in agents/
+        const agentsDir = path.join(home, '.claude', 'agents');
+        if (!fs.existsSync(agentsDir))
+            return subagents;
+        for (const file of fs.readdirSync(agentsDir)) {
+            if (!file.endsWith('.md'))
+                continue;
+            const filePath = path.join(agentsDir, file);
+            if (!fs.statSync(filePath).isFile())
+                continue;
+            const frontmatter = parseSubagentFrontmatter(filePath);
+            if (!frontmatter)
+                continue;
+            const name = file.replace('.md', '');
+            subagents.push({
+                name,
+                path: filePath,
+                files: [file],
+                frontmatter,
+            });
+        }
+    }
+    else if (agentId === 'openclaw') {
+        // OpenClaw: directories with AGENTS.md
+        const openclawDir = path.join(home, '.openclaw');
+        if (!fs.existsSync(openclawDir))
+            return subagents;
+        for (const dir of fs.readdirSync(openclawDir)) {
+            const dirPath = path.join(openclawDir, dir);
+            if (!fs.statSync(dirPath).isDirectory())
+                continue;
+            // OpenClaw uses AGENTS.md (not AGENT.md)
+            const agentsMd = path.join(dirPath, 'AGENTS.md');
+            if (!fs.existsSync(agentsMd))
+                continue;
+            // Parse frontmatter - OpenClaw may not have standard frontmatter
+            // Try to extract name/description from content
+            const content = fs.readFileSync(agentsMd, 'utf-8');
+            let frontmatter = {
+                name: dir,
+                description: '',
+            };
+            // Try to parse frontmatter if present
+            const parsed = parseSubagentFrontmatter(agentsMd);
+            if (parsed) {
+                frontmatter = parsed;
+            }
+            else {
+                // Extract first non-empty line as description
+                const firstLine = content.split('\n').find(l => l.trim() && !l.startsWith('#'));
+                frontmatter.description = firstLine?.slice(0, 80) || `OpenClaw agent: ${dir}`;
+            }
+            const files = fs.readdirSync(dirPath)
+                .filter(f => f.endsWith('.md'))
+                .sort();
+            subagents.push({
+                name: dir,
+                path: dirPath,
+                files,
+                frontmatter,
+            });
+        }
+    }
+    return subagents;
+}
+//# sourceMappingURL=subagents.js.map

package/dist/lib/subagents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagents.js","sourceRoot":"","sources":["../../src/lib/subagents.ts"],"names":[],"mappings":"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"}

package/dist/lib/teams/agents.d.ts

@@ -0,0 +1,146 @@
+import { type AgentConfig } from './persistence.js';
+import { AgentType } from './parsers.js';
+/**
+ * Compute the Lowest Common Ancestor (LCA) of multiple file paths.
+ * Returns the deepest common directory shared by all paths.
+ * Returns null if paths is empty or paths have no common ancestor (different roots).
+ */
+export declare function computePathLCA(paths: string[]): string | null;
+export declare enum AgentStatus {
+    PENDING = "pending",// staged with unresolved --after deps
+    RUNNING = "running",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    STOPPED = "stopped"
+}
+export type { AgentType } from './parsers.js';
+export declare const AGENT_COMMANDS: Record<AgentType, string[]>;
+export type EffortLevel = 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'auto';
+declare const VALID_MODES: readonly ["plan", "edit", "full"];
+type Mode = typeof VALID_MODES[number];
+export declare function resolveMode(requestedMode: string | null | undefined, defaultMode?: Mode): Mode;
+export declare function ensureGeminiPlanMode(): Promise<void>;
+export declare function checkCliAvailable(agentType: AgentType): [boolean, string | null];
+export declare function checkAllClis(): Record<string, {
+    installed: boolean;
+    path: string | null;
+    error: string | null;
+}>;
+export declare function getAgentsDir(): Promise<string>;
+export declare class AgentProcess {
+    agentId: string;
+    taskName: string;
+    agentType: AgentType;
+    prompt: string;
+    cwd: string | null;
+    workspaceDir: string | null;
+    mode: Mode;
+    pid: number | null;
+    status: AgentStatus;
+    startedAt: Date;
+    completedAt: Date | null;
+    parentSessionId: string | null;
+    cloudSessionId: string | null;
+    cloudProvider: string | null;
+    prUrl: string | null;
+    version: string | null;
+    remoteSessionId: string | null;
+    name: string | null;
+    after: string[];
+    effort: EffortLevel | null;
+    model: string | null;
+    envOverrides: Record<string, string> | null;
+    private eventsCache;
+    private lastReadPos;
+    private baseDir;
+    constructor(agentId: string, taskName: string, agentType: AgentType, prompt: string, cwd?: string | null, mode?: Mode, pid?: number | null, status?: AgentStatus, startedAt?: Date, completedAt?: Date | null, baseDir?: string | null, parentSessionId?: string | null, workspaceDir?: string | null, cloudSessionId?: string | null, cloudProvider?: string | null, prUrl?: string | null, version?: string | null, remoteSessionId?: string | null, name?: string | null, after?: string[], effort?: EffortLevel | null, model?: string | null, envOverrides?: Record<string, string> | null);
+    get isEditMode(): boolean;
+    getAgentDir(): Promise<string>;
+    getStdoutPath(): Promise<string>;
+    getMetaPath(): Promise<string>;
+    toDict(): any;
+    duration(): string | null;
+    get events(): any[];
+    /**
+     * Return the latest timestamp we have seen in the agent's events.
+     * Falls back to null when none are available.
+     */
+    private getLatestEventTime;
+    readNewEvents(): Promise<void>;
+    saveMeta(): Promise<void>;
+    static loadFromDisk(agentId: string, baseDir?: string | null): Promise<AgentProcess | null>;
+    isProcessAlive(): boolean;
+    updateStatusFromProcess(): Promise<void>;
+    private reapProcess;
+}
+export declare class AgentManager {
+    private agents;
+    private maxAgents;
+    private maxConcurrent;
+    private agentsDir;
+    private filterByCwd;
+    private cleanupAgeDays;
+    private defaultMode;
+    private agentConfigs;
+    private constructorAgentConfigs;
+    private initPromise;
+    private constructorAgentsDir;
+    constructor(maxAgents?: number, maxConcurrent?: number, agentsDir?: string | null, defaultMode?: Mode | null, filterByCwd?: string | null, cleanupAgeDays?: number, agentConfigs?: Record<AgentType, AgentConfig> | null);
+    private initialize;
+    private doInitialize;
+    getDefaultMode(): Mode;
+    setModelOverrides(agentConfigs: Record<AgentType, AgentConfig>): void;
+    registerAgent(agent: AgentProcess): void;
+    private loadExistingAgents;
+    spawn(taskName: string, agentType: AgentType, prompt: string, cwd?: string | null, mode?: Mode | null, effort?: EffortLevel, parentSessionId?: string | null, workspaceDir?: string | null, version?: string | null, name?: string | null, after?: string[], model?: string | null, envOverrides?: Record<string, string> | null): Promise<AgentProcess>;
+    /**
+     * Actually spawn the OS process for a teammate. Extracted from spawn() so
+     * staged teammates can be launched later by startReady().
+     */
+    private launchProcess;
+    /**
+     * Fire any pending teammates in the given team whose `after` deps have all
+     * completed. Returns the list of teammates just launched. Repeatable:
+     * call it once per DAG wave. Safe to call on teams with no pending work
+     * (returns empty list).
+     */
+    startReady(taskName: string): Promise<AgentProcess[]>;
+    private buildCommand;
+    private applyEditMode;
+    private applyFullMode;
+    get(agentId: string): Promise<AgentProcess | null>;
+    /**
+     * Resolve a teammate reference to a single agent_id within a team.
+     * Accepts (in priority order):
+     *   1. exact teammate name                ("alice")
+     *   2. exact UUID                         ("b2438499-dc25-4a5e-9e02-9916012580b8")
+     *   3. UUID prefix, if unique             ("b2438499")
+     *
+     * Returns:
+     *  - { kind: 'ok', agentId }       when exactly one teammate matches
+     *  - { kind: 'none' }              when nothing matches
+     *  - { kind: 'ambiguous', matches } when the prefix matches multiple ids
+     */
+    resolveAgentIdInTask(taskName: string, ref: string): Promise<{
+        kind: 'ok';
+        agentId: string;
+    } | {
+        kind: 'none';
+    } | {
+        kind: 'ambiguous';
+        matches: string[];
+    }>;
+    listAll(): Promise<AgentProcess[]>;
+    listRunning(): Promise<AgentProcess[]>;
+    listCompleted(): Promise<AgentProcess[]>;
+    listByTask(taskName: string): Promise<AgentProcess[]>;
+    listByParentSession(parentSessionId: string): Promise<AgentProcess[]>;
+    stopByTask(taskName: string): Promise<{
+        stopped: string[];
+        alreadyStopped: string[];
+    }>;
+    stop(agentId: string): Promise<boolean>;
+    private cleanupPartialAgent;
+    private cleanupOldAgents;
+}
+//# sourceMappingURL=agents.d.ts.map

package/dist/lib/teams/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/lib/teams/agents.ts"],"names":[],"mappings":"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"}