apiario 0.6.0 → 0.7.0

package/dist/extensions/subagent/index.js

@@ -0,0 +1,349 @@
+/**
+ * Extensão de subagentes para o Apiário Dev
+ *
+ * Registra a ferramenta "subagent" que permite ao LLM delegar tarefas para
+ * subagentes especializados (scout, generalist, reviewer, e agentes do usuário)
+ * em processos isolados.
+ *
+ * Modos suportados:
+ *   - single:  { agent: "nome", task: "..." }
+ *   - parallel: { tasks: [{ agent: "nome", task: "..." }, ...] }
+ *   - chain:   { chain: [{ agent: "nome", task: "... {previous} ..." }, ...] }
+ */
+import { StringEnum } from "@earendil-works/pi-ai";
+import { Type } from "typebox";
+import { discoverAgents, seedBuiltinAgents, } from "./agents.js";
+import { getResultOutput, isFailedResult, mapWithConcurrencyLimit, runSingleAgent, truncateParallelOutput, } from "./spawn.js";
+import { renderSubagentCall, renderSubagentResult, } from "./display.js";
+// ---------------------------------------------------------------------------
+// Constantes
+// ---------------------------------------------------------------------------
+const MAX_PARALLEL_TASKS = 8;
+const MAX_CONCURRENCY = 4;
+const PER_TASK_OUTPUT_CAP = 50 * 1024; // 50 KB
+// ---------------------------------------------------------------------------
+// Schema dos parâmetros
+// ---------------------------------------------------------------------------
+const TaskItem = Type.Object({
+    agent: Type.String({ description: "Nome do agente a invocar" }),
+    task: Type.String({ description: "Tarefa a delegar para o agente" }),
+    cwd: Type.Optional(Type.String({
+        description: "Diretório de trabalho para o processo do agente",
+    })),
+});
+const ChainItem = Type.Object({
+    agent: Type.String({ description: "Nome do agente a invocar" }),
+    task: Type.String({
+        description: "Tarefa com placeholder opcional {previous} para saída anterior",
+    }),
+    cwd: Type.Optional(Type.String({
+        description: "Diretório de trabalho para o processo do agente",
+    })),
+});
+const AgentScopeSchema = StringEnum(["user", "project", "both"], {
+    description: 'Diretórios de agente a usar. Padrão: "user". Use "both" para incluir agentes do projeto.',
+    default: "user",
+});
+const SubagentParams = Type.Object({
+    agent: Type.Optional(Type.String({ description: "Nome do agente (modo single)" })),
+    task: Type.Optional(Type.String({ description: "Tarefa a delegar (modo single)" })),
+    tasks: Type.Optional(Type.Array(TaskItem, {
+        description: "Array de {agent, task} para execução paralela",
+    })),
+    chain: Type.Optional(Type.Array(ChainItem, {
+        description: "Array de {agent, task} para execução sequencial",
+    })),
+    agentScope: Type.Optional(AgentScopeSchema),
+    confirmProjectAgents: Type.Optional(Type.Boolean({
+        description: "Perguntar antes de executar agentes do projeto. Padrão: true.",
+        default: true,
+    })),
+    cwd: Type.Optional(Type.String({
+        description: "Diretório de trabalho para o agente (modo single)",
+    })),
+});
+// ---------------------------------------------------------------------------
+// Helper para criar makeDetails
+// ---------------------------------------------------------------------------
+function createMakeDetails(mode, agentScope, projectAgentsDir) {
+    return (results) => ({
+        mode,
+        agentScope,
+        projectAgentsDir,
+        results,
+    });
+}
+// ---------------------------------------------------------------------------
+// Extensão
+// ---------------------------------------------------------------------------
+export default function subagentExtension(pi) {
+    // Garante que os agentes built-in existam na primeira execução
+    seedBuiltinAgents();
+    pi.registerTool({
+        name: "subagent",
+        label: "Subagente",
+        description: [
+            "Delega tarefas para subagentes especializados com contexto isolado.",
+            "Modos: single (agent + task), parallel (tasks array), chain (sequencial com {previous}).",
+            'Escopo padrão de agente é "user" (~/.config/apiario/agents).',
+            'Para ativar agentes locais do projeto, use agentScope: "both" (ou "project").',
+        ].join(" "),
+        promptSnippet: "Delega tarefa para subagente especializado (scout, generalist, reviewer)",
+        promptGuidelines: [
+            "Use subagent para tarefas que exigem isolamento de contexto, como explorar o repositório antes de editar.",
+            "Prefira chain mode para fluxos multi-etapa (scout → generalist → reviewer).",
+            "Use parallel mode para tarefas independentes de reconhecimento.",
+        ],
+        parameters: SubagentParams,
+        async execute(_toolCallId, params, signal, onUpdate, ctx) {
+            const agentScope = params.agentScope ?? "user";
+            const discovery = discoverAgents(ctx.cwd, agentScope);
+            const agents = discovery.agents;
+            const confirmProjectAgents = params.confirmProjectAgents ?? true;
+            const hasChain = (params.chain?.length ?? 0) > 0;
+            const hasTasks = (params.tasks?.length ?? 0) > 0;
+            const hasSingle = Boolean(params.agent && params.task);
+            const modeCount = Number(hasChain) + Number(hasTasks) + Number(hasSingle);
+            const makeDetails = createMakeDetails(hasChain ? "chain" : hasTasks ? "parallel" : "single", agentScope, discovery.projectAgentsDir);
+            if (modeCount !== 1) {
+                const available = agents
+                    .map((a) => `${a.name} (${a.source})`)
+                    .join(", ") || "nenhum";
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Parâmetros inválidos. Forneça exatamente um modo.\nAgentes disponíveis: ${available}`,
+                        },
+                    ],
+                    details: makeDetails([]),
+                };
+            }
+            // Confirmação para agentes de projeto
+            if ((agentScope === "project" || agentScope === "both") &&
+                confirmProjectAgents &&
+                ctx.hasUI) {
+                const requestedAgentNames = new Set();
+                if (params.chain)
+                    for (const step of params.chain)
+                        requestedAgentNames.add(step.agent);
+                if (params.tasks)
+                    for (const t of params.tasks)
+                        requestedAgentNames.add(t.agent);
+                if (params.agent)
+                    requestedAgentNames.add(params.agent);
+                const projectAgentsRequested = Array.from(requestedAgentNames)
+                    .map((name) => agents.find((a) => a.name === name))
+                    .filter((a) => a?.source === "project");
+                if (projectAgentsRequested.length > 0) {
+                    const names = projectAgentsRequested
+                        .map((a) => a.name)
+                        .join(", ");
+                    const dir = discovery.projectAgentsDir ?? "(desconhecido)";
+                    const ok = await ctx.ui.confirm("Executar agentes do projeto?", `Agentes: ${names}\nOrigem: ${dir}\n\nAgentes de projeto são controlados pelo repositório. Continue apenas para repositórios confiáveis.`);
+                    if (!ok)
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: "Cancelado: agentes do projeto não aprovados.",
+                                },
+                            ],
+                            details: makeDetails([]),
+                        };
+                }
+            }
+            // ── Chain mode ──────────────────────────────────────
+            if (params.chain && params.chain.length > 0) {
+                const results = [];
+                let previousOutput = "";
+                for (let i = 0; i < params.chain.length; i++) {
+                    const step = params.chain[i];
+                    const taskWithContext = step.task.replace(/\{previous\}/g, previousOutput);
+                    const chainUpdate = onUpdate
+                        ? (partial) => {
+                            const currentResult = partial.details?.results[0];
+                            if (currentResult) {
+                                const allResults = [
+                                    ...results,
+                                    currentResult,
+                                ];
+                                onUpdate({
+                                    content: partial.content,
+                                    details: makeDetails(allResults),
+                                });
+                            }
+                        }
+                        : undefined;
+                    const result = await runSingleAgent(ctx.cwd, agents, step.agent, taskWithContext, step.cwd, i + 1, signal, chainUpdate, makeDetails);
+                    results.push(result);
+                    if (isFailedResult(result)) {
+                        const errorMsg = getResultOutput(result);
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: `Chain interrompida na etapa ${i + 1} (${step.agent}): ${errorMsg}`,
+                                },
+                            ],
+                            details: makeDetails(results),
+                            isError: true,
+                        };
+                    }
+                    previousOutput = getFinalOutput(result.messages);
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: getFinalOutput(results[results.length - 1].messages) || "(sem saída)",
+                        },
+                    ],
+                    details: makeDetails(results),
+                };
+            }
+            // ── Parallel mode ───────────────────────────────────
+            if (params.tasks && params.tasks.length > 0) {
+                if (params.tasks.length > MAX_PARALLEL_TASKS) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Muitas tarefas paralelas (${params.tasks.length}). Máximo é ${MAX_PARALLEL_TASKS}.`,
+                            },
+                        ],
+                        details: makeDetails([]),
+                    };
+                }
+                const allResults = new Array(params.tasks.length);
+                // Inicializa placeholders
+                for (let i = 0; i < params.tasks.length; i++) {
+                    allResults[i] = {
+                        agent: params.tasks[i].agent,
+                        agentSource: "unknown",
+                        task: params.tasks[i].task,
+                        exitCode: -1,
+                        messages: [],
+                        stderr: "",
+                        usage: {
+                            input: 0,
+                            output: 0,
+                            cacheRead: 0,
+                            cacheWrite: 0,
+                            cost: 0,
+                            contextTokens: 0,
+                            turns: 0,
+                        },
+                    };
+                }
+                const emitParallelUpdate = () => {
+                    if (onUpdate) {
+                        const running = allResults.filter((r) => r.exitCode === -1).length;
+                        const done = allResults.filter((r) => r.exitCode !== -1).length;
+                        onUpdate({
+                            content: [
+                                {
+                                    type: "text",
+                                    text: `Paralelo: ${done}/${allResults.length} concluídas, ${running} em execução...`,
+                                },
+                            ],
+                            details: makeDetails([...allResults]),
+                        });
+                    }
+                };
+                const results = await mapWithConcurrencyLimit(params.tasks, MAX_CONCURRENCY, async (t, index) => {
+                    const result = await runSingleAgent(ctx.cwd, agents, t.agent, t.task, t.cwd, undefined, signal, (partial) => {
+                        if (partial.details?.results[0]) {
+                            allResults[index] =
+                                partial.details.results[0];
+                            emitParallelUpdate();
+                        }
+                    }, makeDetails);
+                    allResults[index] = result;
+                    emitParallelUpdate();
+                    return result;
+                });
+                const successCount = results.filter((r) => !isFailedResult(r)).length;
+                const summaries = results.map((r) => {
+                    const output = truncateParallelOutput(getResultOutput(r));
+                    const status = isFailedResult(r)
+                        ? `falhou${r.stopReason && r.stopReason !== "end" ? ` (${r.stopReason})` : ""}`
+                        : "concluída";
+                    return `### [${r.agent}] ${status}\n\n${output}`;
+                });
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Paralelo: ${successCount}/${results.length} sucesso\n\n${summaries.join("\n\n---\n\n")}`,
+                        },
+                    ],
+                    details: makeDetails(results),
+                };
+            }
+            // ── Single mode ─────────────────────────────────────
+            if (params.agent && params.task) {
+                const result = await runSingleAgent(ctx.cwd, agents, params.agent, params.task, params.cwd, undefined, signal, onUpdate, makeDetails);
+                if (isFailedResult(result)) {
+                    const errorMsg = getResultOutput(result);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Agente ${result.stopReason || "falhou"}: ${errorMsg}`,
+                            },
+                        ],
+                        details: makeDetails([result]),
+                        isError: true,
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: getFinalOutput(result.messages) ||
+                                "(sem saída)",
+                        },
+                    ],
+                    details: makeDetails([result]),
+                };
+            }
+            // Fallback — nunca deve chegar aqui
+            const available = agents
+                .map((a) => `${a.name} (${a.source})`)
+                .join(", ") || "nenhum";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Parâmetros inválidos. Agentes disponíveis: ${available}`,
+                    },
+                ],
+                details: makeDetails([]),
+            };
+        },
+        // ── Renderização ───────────────────────────────────────
+        renderCall(args, theme, _context) {
+            return renderSubagentCall(args, theme);
+        },
+        renderResult(result, { expanded }, theme, _context) {
+            return renderSubagentResult(result, expanded, theme);
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// Helpers internos
+// ---------------------------------------------------------------------------
+function getFinalOutput(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (msg.role === "assistant") {
+            for (const part of msg.content) {
+                if (part.type === "text")
+                    return part.text;
+            }
+        }
+    }
+    return "";
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * Spawn do child process (npx apiario --mode json)
+ *
+ * Lida com:
+ *   - Spawn do processo filho
+ *   - Streaming de saída JSON-line
+ *   - Coleta de resultados (mensagens, uso)
+ *   - Abort (Ctrl+C) — mata o child
+ */
+import type { Message } from "@earendil-works/pi-ai";
+import type { AgentConfig } from "./agents.js";
+export type OnUpdateCallback = (partial: any) => void;
+export interface UsageStats {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    cost: number;
+    contextTokens: number;
+    turns: number;
+}
+export interface SingleResult {
+    agent: string;
+    agentSource: "user" | "project" | "unknown";
+    task: string;
+    exitCode: number;
+    messages: Message[];
+    stderr: string;
+    usage: UsageStats;
+    model?: string;
+    stopReason?: string;
+    errorMessage?: string;
+    step?: number;
+}
+export interface SubagentDetails {
+    mode: "single" | "parallel" | "chain";
+    agentScope: "user" | "project" | "both";
+    projectAgentsDir: string | null;
+    results: SingleResult[];
+}
+export declare function isFailedResult(result: SingleResult): boolean;
+export declare function getResultOutput(result: SingleResult): string;
+export declare function truncateParallelOutput(output: string): string;
+export declare function formatTokens(count: number): string;
+export declare function formatUsageStats(usage: UsageStats, model?: string): string;
+export declare function runSingleAgent(defaultCwd: string, agents: AgentConfig[], agentName: string, task: string, cwd: string | undefined, step: number | undefined, signal: AbortSignal | undefined, onUpdate: OnUpdateCallback | undefined, makeDetails: (results: SingleResult[]) => SubagentDetails): Promise<SingleResult>;
+export declare function mapWithConcurrencyLimit<TIn, TOut>(items: TIn[], concurrency: number, fn: (item: TIn, index: number) => Promise<TOut>): Promise<TOut[]>;
+//# sourceMappingURL=spawn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/extensions/subagent/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM/C,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;AAEtD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;IACtC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IACxC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAwBD,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAM5D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAU5D;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAS7D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKlD;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAcR;AA+DD,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,WAAW,EAAE,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,QAAQ,EAAE,gBAAgB,GAAG,SAAS,EACtC,WAAW,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,GACxD,OAAO,CAAC,YAAY,CAAC,CAyLvB;AAMD,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,IAAI,EACrD,KAAK,EAAE,GAAG,EAAE,EACZ,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAC9C,OAAO,CAAC,IAAI,EAAE,CAAC,CAgBjB"}