apiario 0.6.0 → 0.8.0

package/dist/extensions/subagent/agents.js

@@ -0,0 +1,239 @@
+/**
+ * Descoberta de agentes, parsing de frontmatter e seed dos built-in
+ *
+ * Carrega agentes de:
+ *   - ~/.config/apiario/agents/*.md  (usuário)
+ *   - .agents/agents/*.md            (projeto, opcional)
+ *
+ * Na primeira execução, cria os 3 agentes built-in:
+ *   scout, generalist, reviewer
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { homedir } from "node:os";
+import { parseFrontmatter, } from "@earendil-works/pi-coding-agent";
+// ---------------------------------------------------------------------------
+// Constantes
+// ---------------------------------------------------------------------------
+const USER_AGENT_DIR = path.join(homedir(), ".config", "apiario", "agents");
+const BUILTIN_AGENTS = [
+    {
+        name: "scout",
+        description: "Fast codebase recon that returns compressed context for handoff",
+        tools: ["read", "grep", "find", "ls", "bash"],
+        systemPrompt: [
+            "You are a **scout agent** specialized in fast codebase reconnaissance.",
+            "",
+            "Your goal is to explore the codebase, gather relevant context, and return a",
+            "compressed summary for the next agent in the chain.",
+            "",
+            "## Guidelines",
+            "",
+            "- Use `read` to inspect key files and understand structure.",
+            "- Use `grep` to find relevant patterns, function definitions, imports.",
+            "- Use `find` / `ls` to discover file layouts.",
+            "- Use `bash` for project introspection (e.g., package.json, configs).",
+            "- **Do NOT** use `write` or `edit` — you are read-only.",
+            "- Return a concise Markdown summary with:",
+            "  - Key files and their purposes",
+            "  - Relevant code snippets (paths + line numbers)",
+            "  - Architecture notes and relationships",
+            "  - Anything the next agent needs to implement the task",
+            "",
+            "Be thorough but concise. Focus on what's relevant to the task.",
+        ].join("\n"),
+    },
+    {
+        name: "generalist",
+        description: "General-purpose agent with full tool access",
+        tools: undefined,
+        systemPrompt: [
+            "You are a **generalist agent** with full access to all available tools.",
+            "",
+            "Your goal is to complete the assigned task thoroughly and correctly.",
+            "",
+            "## Guidelines",
+            "",
+            "- Read files before editing to understand existing code.",
+            "- Make targeted, minimal changes.",
+            "- Test your changes when possible.",
+            "- Return the final result or a summary of what was done.",
+        ].join("\n"),
+    },
+    {
+        name: "reviewer",
+        description: "Code review agent that checks for issues and improvements",
+        tools: ["read", "grep", "find", "ls", "bash"],
+        systemPrompt: [
+            "You are a **reviewer agent** specialized in code review.",
+            "",
+            "Your goal is to analyze code changes and provide actionable feedback.",
+            "",
+            "## Guidelines",
+            "",
+            "- Read the relevant files to understand the change context.",
+            "- Use `grep` to find related code that may be affected.",
+            "- Check for:",
+            "  - Correctness and edge cases",
+            "  - Error handling",
+            "  - Performance implications",
+            "  - Code style and consistency",
+            "  - Security concerns",
+            "  - Test coverage",
+            "- **Do NOT** make edits — you are read-only.",
+            "- Return a structured review with:",
+            "  - Summary of what was reviewed",
+            "  - Issues found (categorized by severity)",
+            "  - Suggestions for improvement",
+            "  - Overall verdict (approved / changes requested)",
+        ].join("\n"),
+    },
+];
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function isDirectory(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function findNearestProjectAgentsDir(cwd) {
+    let current = cwd;
+    while (true) {
+        const candidate = path.join(current, ".agents", "agents");
+        if (isDirectory(candidate))
+            return candidate;
+        const parent = path.dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+function loadAgentsFromDir(dir, source) {
+    const agents = [];
+    if (!isDirectory(dir))
+        return agents;
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return agents;
+    }
+    for (const entry of entries) {
+        if (!entry.name.endsWith(".md"))
+            continue;
+        if (!entry.isFile() && !entry.isSymbolicLink())
+            continue;
+        const filePath = path.join(dir, entry.name);
+        let content;
+        try {
+            content = fs.readFileSync(filePath, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        const { frontmatter, body } = parseFrontmatter(content);
+        if (!frontmatter.name || !frontmatter.description) {
+            continue;
+        }
+        const tools = frontmatter.tools
+            ?.split(",")
+            .map((t) => t.trim())
+            .filter(Boolean);
+        agents.push({
+            name: frontmatter.name,
+            description: frontmatter.description,
+            tools: tools && tools.length > 0 ? tools : undefined,
+            model: frontmatter.model || undefined,
+            systemPrompt: body,
+            source,
+            filePath,
+        });
+    }
+    return agents;
+}
+// ---------------------------------------------------------------------------
+// Seed dos built-in
+// ---------------------------------------------------------------------------
+/**
+ * Cria os 3 agentes built-in (scout, generalist, reviewer) no diretório de
+ * agentes do usuário, caso o diretório esteja vazio (primeira execução).
+ * Nunca sobrescreve arquivos existentes.
+ */
+export function seedBuiltinAgents() {
+    if (!isDirectory(USER_AGENT_DIR)) {
+        fs.mkdirSync(USER_AGENT_DIR, { recursive: true });
+    }
+    for (const agent of BUILTIN_AGENTS) {
+        const filePath = path.join(USER_AGENT_DIR, `${agent.name}.md`);
+        if (fs.existsSync(filePath))
+            continue;
+        const toolsLine = agent.tools ? `tools: ${agent.tools.join(", ")}` : "";
+        const modelLine = agent.model ? `model: ${agent.model}` : "";
+        const frontmatter = [
+            "---",
+            `name: ${agent.name}`,
+            `description: ${agent.description}`,
+            ...(toolsLine ? [toolsLine] : []),
+            ...(modelLine ? [modelLine] : []),
+            "---",
+        ].join("\n");
+        const content = `${frontmatter}\n\n${agent.systemPrompt}\n`;
+        try {
+            fs.writeFileSync(filePath, content, "utf-8");
+        }
+        catch {
+            // ignora — não crítico
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Descoberta principal
+// ---------------------------------------------------------------------------
+export function discoverAgents(cwd, scope) {
+    const projectAgentsDir = findNearestProjectAgentsDir(cwd);
+    const userAgents = scope === "project" ? [] : loadAgentsFromDir(USER_AGENT_DIR, "user");
+    const projectAgents = scope === "user" || !projectAgentsDir
+        ? []
+        : loadAgentsFromDir(projectAgentsDir, "project");
+    const agentMap = new Map();
+    if (scope === "both") {
+        // Usuário primeiro; projeto sobrescreve (mesmo nome vence projeto)
+        for (const agent of userAgents)
+            agentMap.set(agent.name, agent);
+        for (const agent of projectAgents)
+            agentMap.set(agent.name, agent);
+    }
+    else if (scope === "user") {
+        for (const agent of userAgents)
+            agentMap.set(agent.name, agent);
+    }
+    else {
+        for (const agent of projectAgents)
+            agentMap.set(agent.name, agent);
+    }
+    return {
+        agents: Array.from(agentMap.values()),
+        projectAgentsDir,
+    };
+}
+/**
+ * Formata lista de agentes para display
+ */
+export function formatAgentList(agents, maxItems) {
+    if (agents.length === 0)
+        return { text: "nenhum", remaining: 0 };
+    const listed = agents.slice(0, maxItems);
+    const remaining = agents.length - listed.length;
+    return {
+        text: listed
+            .map((a) => `${a.name} (${a.source}): ${a.description}`)
+            .join("; "),
+        remaining,
+    };
+}
+//# sourceMappingURL=agents.js.map

package/dist/extensions/subagent/agents.js.map

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

package/dist/extensions/subagent/display.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Renderização customizada da tool subagent
+ *
+ * Fornece funções de renderização para os modos collapsed e expandido,
+ * com ícones de status, formatação de tool calls e uso de recursos.
+ */
+import { type Theme } from "@earendil-works/pi-coding-agent";
+import { Container, Text } from "@earendil-works/pi-tui";
+import { type SubagentDetails } from "./spawn.js";
+export declare function renderSubagentCall(args: Record<string, any>, theme: Theme): Text;
+export declare function renderSubagentResult(result: {
+    content: Array<{
+        type: string;
+        text?: string;
+    }>;
+    details?: SubagentDetails;
+}, expanded: boolean, theme: Theme): Text | Container;
+//# sourceMappingURL=display.d.ts.map

package/dist/extensions/subagent/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../../src/extensions/subagent/display.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAEL,KAAK,KAAK,EACX,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,SAAS,EAGT,IAAI,EACL,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,KAAK,eAAe,EAIrB,MAAM,YAAY,CAAC;AA2KpB,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,KAAK,EAAE,KAAK,GACX,IAAI,CA0DN;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,eAAe,CAAA;CAAE,EACtF,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,KAAK,GACX,IAAI,GAAG,SAAS,CA6BlB"}