@neetru/cli 2.19.1 → 2.20.1

package/dist/lib/code-agent-session.js

@@ -118,6 +118,28 @@ export function saveCodeSession(settings, history) {
     fs.writeFileSync(file, formatCodeSessionMarkdown(settings, history), 'utf8');
     return path.relative(settings.cwd, file).replace(/\\/g, '/');
 }
+/**
+ * Nome fixo (não-timestamped) do checkpoint automático — GAP-M1-18
+ * (2026-07-11, "ajuda a trabalho a longo prazo"): antes só `/save` manual
+ * persistia a conversa; uma sessão longa/densa que crashar ou fechar sem o
+ * usuário lembrar de salvar perdia tudo. Prefixo `_` (nunca gerado por
+ * `saveCodeSession`, que usa timestamp ISO) marca "não é uma sessão salva
+ * de verdade" — `listCodeSessions`/`/resume` ignoram este arquivo de
+ * propósito (ver filtro abaixo), senão toda sessão nova mostraria o
+ * autosave da anterior como se fosse uma escolha do usuário.
+ */
+const AUTOSAVE_FILENAME = '_autosave.md';
+/** Sobrescreve o mesmo arquivo a cada chamada (não acumula um .md por turno). */
+export function autoSaveCodeSession(settings, history) {
+    try {
+        const dir = path.join(settings.cwd, '.neetru', 'code', 'sessions');
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(path.join(dir, AUTOSAVE_FILENAME), formatCodeSessionMarkdown(settings, history), 'utf8');
+    }
+    catch {
+        // Best-effort — autosave nunca deve interromper a sessao interativa.
+    }
+}
 function sessionsDir(cwd) {
     return path.join(cwd, '.neetru', 'code', 'sessions');
 }
@@ -136,31 +158,46 @@ function parseSessionMarkdown(content) {
         messages,
     };
 }
-/** Lista sessoes salvas, mais recente primeiro (nomes de arquivo ISO ordenam lexicograficamente). */
+function readSessionSummary(dir, file, previewPrefix = '') {
+    const full = path.join(dir, file);
+    let content = '';
+    try {
+        content = fs.readFileSync(full, 'utf8');
+    }
+    catch {
+        content = '';
+    }
+    const parsed = parseSessionMarkdown(content);
+    const firstUser = parsed.messages.find((m) => m.role === 'user');
+    const preview = previewPrefix + (firstUser?.content ?? '').replace(/\s+/g, ' ').trim().slice(0, 80);
+    return {
+        file: `.neetru/code/sessions/${file}`,
+        timestamp: parsed.date || file.replace(/\.md$/, ''),
+        messageCount: parsed.messageCount,
+        preview,
+    };
+}
+/**
+ * Lista sessoes salvas, mais recente primeiro (nomes de arquivo ISO ordenam
+ * lexicograficamente). O checkpoint automatico (`autoSaveCodeSession`)
+ * aparece PRIMEIRO com prefixo "[auto]" quando existe — nao e "escondido"
+ * do usuario (senao a sessao perdida por crash/fechar sem `/save` fica
+ * irrecuperavel via UI), so marcado como diferente de um save manual.
+ */
 export function listCodeSessions(cwd) {
     const dir = sessionsDir(cwd);
     if (!fs.existsSync(dir))
         return [];
-    const files = fs.readdirSync(dir).filter((f) => f.endsWith('.md')).sort().reverse();
-    return files.map((file) => {
-        const full = path.join(dir, file);
-        let content = '';
-        try {
-            content = fs.readFileSync(full, 'utf8');
-        }
-        catch {
-            content = '';
-        }
-        const parsed = parseSessionMarkdown(content);
-        const firstUser = parsed.messages.find((m) => m.role === 'user');
-        const preview = (firstUser?.content ?? '').replace(/\s+/g, ' ').trim().slice(0, 80);
-        return {
-            file: `.neetru/code/sessions/${file}`,
-            timestamp: parsed.date || file.replace(/\.md$/, ''),
-            messageCount: parsed.messageCount,
-            preview,
-        };
-    });
+    const all = fs.readdirSync(dir);
+    const autosave = all.includes(AUTOSAVE_FILENAME)
+        ? [readSessionSummary(dir, AUTOSAVE_FILENAME, '[auto] ')]
+        : [];
+    const manual = all
+        .filter((f) => f.endsWith('.md') && f !== AUTOSAVE_FILENAME)
+        .sort()
+        .reverse()
+        .map((file) => readSessionSummary(dir, file));
+    return [...autosave, ...manual];
 }
 /** Carrega as mensagens de uma sessao salva (`file` relativo ao cwd, vindo de listCodeSessions). */
 export function loadCodeSession(cwd, file) {

package/dist/lib/code-agent-session.js.map

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

package/dist/lib/code-agent-settings.d.ts

@@ -2,6 +2,17 @@ export declare const DEFAULT_CODE_MODEL = "llama-3.3-70b-versatile";
 export declare const DEFAULT_CODE_MAX_TURNS = 8;
 export declare const DEFAULT_CODE_MAX_TOKENS = 4096;
 export declare const DEFAULT_CODE_TEMPERATURE = 0.2;
+/**
+ * GAP-M1-18 (2026-07-11) — preset "ultracode": pedido do usuário por um modo
+ * pra trabalho denso/longo (`--ultracode` ou `/ultracode` na sessão
+ * interativa). Amplia turnos/tokens/effort de uma vez em vez do usuário
+ * precisar lembrar de 3 flags toda vez. Tetos escolhidos dentro dos limites
+ * já validados em `resolveSettings` (`parseBoundedNumber` — max 30
+ * turnos/32768 tokens), não introduz teto novo no request em si.
+ */
+export declare const ULTRACODE_MAX_TURNS = 24;
+export declare const ULTRACODE_MAX_TOKENS = 32768;
+export declare const ULTRACODE_EFFORT: "high";
 export interface ResolveCodeModelInput {
     cliModel?: string;
     envModel?: string;
@@ -23,7 +34,19 @@ type CatalogProvider = (typeof KNOWN_CATALOG_PROVIDERS)[number];
  * um provider inválido não deveria travar o comando inteiro, só perde o
  * roteamento forçado e cai no WRRR normal).
  */
-export declare function resolveCodeProvider(cliProvider?: string, configuredProvider?: string): CatalogProvider | undefined;
+export declare function resolveCodeProvider(cliProvider?: string, configuredProvider?: string, model?: string): CatalogProvider | undefined;
+declare const KNOWN_EFFORT_LEVELS: readonly ["low", "medium", "high"];
+export type CodeEffort = (typeof KNOWN_EFFORT_LEVELS)[number];
+/**
+ * Resolve o nível de esforço de raciocínio — prioridade `--effort` (flag da
+ * tarefa) sobre `gatewayEffort` configurado (`neetru config set`). Ausente =
+ * undefined = comportamento default do provider/modelo (a maioria não é
+ * "reasoning model" e ignora o campo quando presente — só Groq/OpenAI
+ * recebem `reasoning_effort` de verdade, ver `provider-adapters.ts` no
+ * Core). Valor fora do conjunto conhecido é ignorado silenciosamente
+ * (fail-open — mesmo padrão de `resolveCodeProvider`).
+ */
+export declare function resolveCodeEffort(cliEffort?: string, configuredEffort?: string): CodeEffort | undefined;
 export declare function parseBoundedNumber(value: unknown, fallback: number, limits: {
     min: number;
     max: number;

package/dist/lib/code-agent-settings.js

@@ -2,6 +2,17 @@ export const DEFAULT_CODE_MODEL = 'llama-3.3-70b-versatile';
 export const DEFAULT_CODE_MAX_TURNS = 8;
 export const DEFAULT_CODE_MAX_TOKENS = 4096;
 export const DEFAULT_CODE_TEMPERATURE = 0.2;
+/**
+ * GAP-M1-18 (2026-07-11) — preset "ultracode": pedido do usuário por um modo
+ * pra trabalho denso/longo (`--ultracode` ou `/ultracode` na sessão
+ * interativa). Amplia turnos/tokens/effort de uma vez em vez do usuário
+ * precisar lembrar de 3 flags toda vez. Tetos escolhidos dentro dos limites
+ * já validados em `resolveSettings` (`parseBoundedNumber` — max 30
+ * turnos/32768 tokens), não introduz teto novo no request em si.
+ */
+export const ULTRACODE_MAX_TURNS = 24;
+export const ULTRACODE_MAX_TOKENS = 32_768;
+export const ULTRACODE_EFFORT = 'high';
 export function isAnthropicModel(model) {
     if (!model)
         return false;
@@ -27,6 +38,25 @@ export function resolveCodeModel(input) {
     return { model: DEFAULT_CODE_MODEL };
 }
 const KNOWN_CATALOG_PROVIDERS = ['groq', 'nvidia', 'openai'];
+/**
+ * Nomes de modelo NATIVOS de um único provider do catálogo curado
+ * (model-catalog.ts no Core, GAP-M1-16) — duplicados aqui de propósito pra
+ * funcionar OFFLINE/sync (sem round-trip ao Core só pra resolver o provider
+ * antes da 1a chamada). Achado em uso real (2026-07-11): `neetru code -m
+ * meta-llama/llama-4-scout-17b-16e-instruct` sem `--provider`/`gatewayProvider`
+ * configurado caiu no WRRR livre — quando sorteou uma key NVIDIA, o modelo
+ * (Groq-only) deu 404 la, nao-retryable, `withKeyRetryDetailed` devolveu
+ * null na 1a tentativa -> 503 "nenhum provider disponivel" mesmo com Groq
+ * saudavel no pool. `neetru ai models use <id>` ja resolve isso fixando os
+ * dois juntos; este fallback cobre quem passa `-m` manualmente com um nome
+ * do catalogo sem saber que precisa do `--provider` junto.
+ */
+const NATIVE_MODEL_PROVIDER = {
+    'meta-llama/llama-4-scout-17b-16e-instruct': 'groq',
+    'llama-3.3-70b-versatile': 'groq',
+    'meta/llama-4-maverick-17b-128e-instruct': 'nvidia',
+    'meta/llama-3.3-70b-instruct': 'nvidia',
+};
 /**
  * GAP-M1-16 (2026-07-10): resolve o provider a forçar no request — prioridade
  * `--provider` (flag explícita da tarefa) sobre `gatewayProvider` configurado
@@ -35,13 +65,32 @@ const KNOWN_CATALOG_PROVIDERS = ['groq', 'nvidia', 'openai'];
  * um provider inválido não deveria travar o comando inteiro, só perde o
  * roteamento forçado e cai no WRRR normal).
  */
-export function resolveCodeProvider(cliProvider, configuredProvider) {
+export function resolveCodeProvider(cliProvider, configuredProvider, model) {
     const explicit = firstNonEmpty(cliProvider, configuredProvider);
+    if (explicit) {
+        return KNOWN_CATALOG_PROVIDERS.includes(explicit)
+            ? explicit
+            : undefined;
+    }
+    // Nenhum dos dois informado — tenta inferir do nome do modelo antes de
+    // desistir pro WRRR livre (ver doc de NATIVE_MODEL_PROVIDER acima).
+    return model ? NATIVE_MODEL_PROVIDER[model] : undefined;
+}
+const KNOWN_EFFORT_LEVELS = ['low', 'medium', 'high'];
+/**
+ * Resolve o nível de esforço de raciocínio — prioridade `--effort` (flag da
+ * tarefa) sobre `gatewayEffort` configurado (`neetru config set`). Ausente =
+ * undefined = comportamento default do provider/modelo (a maioria não é
+ * "reasoning model" e ignora o campo quando presente — só Groq/OpenAI
+ * recebem `reasoning_effort` de verdade, ver `provider-adapters.ts` no
+ * Core). Valor fora do conjunto conhecido é ignorado silenciosamente
+ * (fail-open — mesmo padrão de `resolveCodeProvider`).
+ */
+export function resolveCodeEffort(cliEffort, configuredEffort) {
+    const explicit = firstNonEmpty(cliEffort, configuredEffort);
     if (!explicit)
         return undefined;
-    return KNOWN_CATALOG_PROVIDERS.includes(explicit)
-        ? explicit
-        : undefined;
+    return KNOWN_EFFORT_LEVELS.includes(explicit) ? explicit : undefined;
 }
 export function parseBoundedNumber(value, fallback, limits) {
     if (value === undefined || value === null || value === '')

package/dist/lib/code-agent-settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"code-agent-settings.js","sourceRoot":"","sources":["../../src/lib/code-agent-settings.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,yBAAyB,CAAC;AAC5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAC5C,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAa5C,MAAM,UAAU,gBAAgB,CAAC,KAAyB;IACxD,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,OAAO,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,aAAa,CAAC,GAAG,MAAiC;IACzD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/D,IAAI,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC/D,IAAI,UAAU,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAE9E,IAAI,UAAU,IAAI,gBAAgB,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/C,OAAO;YACL,KAAK,EAAE,kBAAkB;YACzB,OAAO,EACL,2CAA2C,UAAU,KAAK;gBAC1D,qBAAqB,kBAAkB,gDAAgD;SAC1F,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAGtE;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAoB,EAAE,kBAA2B;IACnF,MAAM,QAAQ,GAAG,aAAa,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;IAChE,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,OAAQ,uBAA6C,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACtE,CAAC,CAAE,QAA4B;QAC/B,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAAc,EACd,QAAgB,EAChB,MAAuD;IAEvD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC3E,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,QAAQ,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACxD,CAAC"}
+{"version":3,"file":"code-agent-settings.js","sourceRoot":"","sources":["../../src/lib/code-agent-settings.ts"],"names":[],"mappings":"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"}

package/dist/lib/code-agent-subagents.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Orquestrador de subagentes do `neetru code` — permite delegar subtarefas a
+ * agentes que rodam concorrentemente (fan-out) enquanto a sessão principal
+ * continua livre. Cada subagente reusa o MESMO loop de turnos (`runAgentTask`),
+ * porém em modo plano e silencioso, e devolve seu resultado (texto final ou
+ * patch proposto) pra sessão principal decidir o que fazer.
+ *
+ * Arquitetura (princípios gerais de orquestração multi-agente, nada copiado de
+ * CLI alheia):
+ *  - fan-out: N subtarefas independentes disparadas sem bloquear o prompt;
+ *  - isolamento de contexto: cada subagente tem seu PRÓPRIO histórico de
+ *    mensagens (`CodeMessage[]`) — nunca compartilha com a sessão principal nem
+ *    com outro subagente;
+ *  - coleta assíncrona: o estado vive em memória; o resultado é lido sob demanda
+ *    (`/agents result`) e um patch só é aplicado por um passo explícito e
+ *    separado (`/agents apply`), passando pelo mesmo `confirm` de sempre.
+ *
+ * Segurança (invariantes duras):
+ *  - subagentes SEMPRE rodam com `apply:false` — nunca aplicam patch sozinhos,
+ *    independente da config da sessão (escrita concorrente no mesmo working dir
+ *    corromperia o estado git);
+ *  - sem aninhamento: um subagente nunca inicia outro (só o REPL interativo
+ *    chama `startSubagent`; o loop de turnos não tem como fazê-lo);
+ *  - limite de concorrência (`MAX_CONCURRENT_SUBAGENTS`) protege o rate-limit
+ *    do AI Gateway.
+ *
+ * O runner (`runAgentTask`) é INJETADO por quem monta o REPL
+ * (`configureSubagentRunner`), não importado daqui — assim este módulo não
+ * depende de `commands/code.ts` (import unidirecional, sem ciclo) e os testes
+ * injetam um stub sem tocar na rede.
+ */
+import type { AgentTaskOutcome, CodeMessage, CodeSettings, ConfirmFn, RunAgentTaskOptions } from './code-agent-types.js';
+import type { CodeAgentState } from './code-agent-session.js';
+/**
+ * Máximo de subagentes rodando ao mesmo tempo. Escolhido em 4 porque o AI
+ * Gateway do Core limita `AI_GATEWAY_RATE_LIMIT = 30 req/min/IP`: cada turno de
+ * subagente é 1 requisição e um subagente faz vários turnos; com 4 concorrentes
+ * MAIS a própria sessão principal (que também consome o gateway) as requisições
+ * interleiam bem abaixo do teto, sobrando folga pra retries/backoff. Mais que
+ * isso arrisca 429 e desperdício de tokens sem ganho real de paralelismo (Node
+ * é single-thread — isto é concorrência de I/O, não paralelismo de CPU).
+ */
+export declare const MAX_CONCURRENT_SUBAGENTS = 4;
+export type SubagentStatus = 'running' | 'done' | 'failed' | 'stopped';
+export interface SubagentSummary {
+    id: string;
+    /** Resumo curto da tarefa (1 linha). */
+    task: string;
+    status: SubagentStatus;
+    startedAt: number;
+    finishedAt?: number;
+    /** true quando o subagente concluiu propondo um patch aplicável. */
+    hasPatch: boolean;
+}
+export interface SubagentResult {
+    id: string;
+    status: SubagentStatus;
+    task: string;
+    outcome?: AgentTaskOutcome;
+    error?: string;
+}
+/**
+ * Assinatura do runner injetado. Bate exatamente com `runAgentTask` de
+ * `commands/code.ts` (incluindo o retorno `AgentTaskOutcome` e o parâmetro
+ * `options`). Injetar em vez de importar evita o import circular
+ * commands/code.ts <-> este módulo.
+ */
+export type AgentTaskRunner = (task: string, settings: CodeSettings, confirm: ConfirmFn, history?: CodeMessage[], onState?: (state: CodeAgentState) => void, options?: RunAgentTaskOptions) => Promise<AgentTaskOutcome>;
+type SettledListener = (summary: SubagentSummary) => void;
+export declare function configureSubagentRunner(runner: AgentTaskRunner): void;
+/**
+ * Registra um ouvinte de conclusão. Retorna uma função pra cancelar o registro.
+ * O REPL usa isto pra emitir UMA linha de notificação quando um subagente
+ * termina (respeitando a regra de silêncio: nada de output enquanto roda). O
+ * orquestrador não conhece o terminal/Ink — só avisa quem se registrou.
+ */
+export declare function onSubagentSettled(cb: SettledListener): () => void;
+/**
+ * Dispara um subagente em background (fire-and-forget). Retorna o id curto pra
+ * consulta posterior. A Promise roda solta; o estado é atualizado quando ela
+ * assenta. `apply:false` é FORÇADO aqui, ignorando `settings.apply` — a
+ * aplicação de patch é sempre um passo separado e explícito da sessão principal.
+ */
+export declare function startSubagent(task: string, settings: CodeSettings): string;
+export declare function listSubagents(): SubagentSummary[];
+/**
+ * Sinaliza cancelamento cooperativo. Marca 'stopped' de imediato (determinístico
+ * pra UI/consulta) e aborta o `AbortController` — o loop de turnos percebe na
+ * fronteira do próximo turno e encerra. Retorna false se o id não existe ou já
+ * terminou.
+ */
+export declare function stopSubagent(id: string): boolean;
+/** Para todos os subagentes ainda rodando (ex: ao sair da sessão) — evita órfãos. */
+export declare function stopAllSubagents(): number;
+export declare function getSubagentResult(id: string): SubagentResult | null;
+/**
+ * Patch aplicável = subagente concluído COM SUCESSO propondo um patch. Um
+ * subagente parado/falho/rodando nunca devolve patch aqui (é o que impede
+ * aplicar o resultado de um subagente cancelado). A APLICAÇÃO em si continua
+ * sendo responsabilidade da sessão principal (confirm + git apply).
+ */
+export declare function getApplicablePatch(id: string): string | null;
+/** Só pra testes: zera o estado global entre casos. */
+export declare function __resetSubagents(): void;
+export {};

package/dist/lib/code-agent-subagents.js

@@ -0,0 +1,179 @@
+/**
+ * Máximo de subagentes rodando ao mesmo tempo. Escolhido em 4 porque o AI
+ * Gateway do Core limita `AI_GATEWAY_RATE_LIMIT = 30 req/min/IP`: cada turno de
+ * subagente é 1 requisição e um subagente faz vários turnos; com 4 concorrentes
+ * MAIS a própria sessão principal (que também consome o gateway) as requisições
+ * interleiam bem abaixo do teto, sobrando folga pra retries/backoff. Mais que
+ * isso arrisca 429 e desperdício de tokens sem ganho real de paralelismo (Node
+ * é single-thread — isto é concorrência de I/O, não paralelismo de CPU).
+ */
+export const MAX_CONCURRENT_SUBAGENTS = 4;
+const subagents = new Map();
+const settledListeners = new Set();
+let runnerImpl = null;
+let seq = 0;
+/** Subagentes nunca aplicam patch → confirm nunca é chamado; nega por garantia. */
+const denyConfirm = async () => false;
+export function configureSubagentRunner(runner) {
+    runnerImpl = runner;
+}
+/**
+ * Registra um ouvinte de conclusão. Retorna uma função pra cancelar o registro.
+ * O REPL usa isto pra emitir UMA linha de notificação quando um subagente
+ * termina (respeitando a regra de silêncio: nada de output enquanto roda). O
+ * orquestrador não conhece o terminal/Ink — só avisa quem se registrou.
+ */
+export function onSubagentSettled(cb) {
+    settledListeners.add(cb);
+    return () => settledListeners.delete(cb);
+}
+function toSummary(record) {
+    return {
+        id: record.id,
+        task: record.task,
+        status: record.status,
+        startedAt: record.startedAt,
+        finishedAt: record.finishedAt,
+        hasPatch: record.outcome?.kind === 'patch',
+    };
+}
+function notifySettled(record) {
+    const summary = toSummary(record);
+    for (const cb of settledListeners) {
+        try {
+            cb(summary);
+        }
+        catch {
+            // Um ouvinte com defeito nunca deve derrubar a coleta de resultado.
+        }
+    }
+}
+/** Reduz a tarefa a uma linha curta (pra listagem/resumo). */
+function summarizeTask(task) {
+    const oneLine = task.replace(/\s+/g, ' ').trim();
+    return oneLine.length > 80 ? `${oneLine.slice(0, 77)}...` : oneLine;
+}
+/**
+ * Dispara um subagente em background (fire-and-forget). Retorna o id curto pra
+ * consulta posterior. A Promise roda solta; o estado é atualizado quando ela
+ * assenta. `apply:false` é FORÇADO aqui, ignorando `settings.apply` — a
+ * aplicação de patch é sempre um passo separado e explícito da sessão principal.
+ */
+export function startSubagent(task, settings) {
+    if (!runnerImpl) {
+        throw new Error('Runner de subagente não configurado (configureSubagentRunner).');
+    }
+    const trimmed = task.trim();
+    if (!trimmed)
+        throw new Error('Tarefa vazia.');
+    const running = countRunning();
+    if (running >= MAX_CONCURRENT_SUBAGENTS) {
+        throw new Error(`Limite de ${MAX_CONCURRENT_SUBAGENTS} subagentes simultâneos atingido — pare um com /agents stop <id>.`);
+    }
+    const id = `a${++seq}`;
+    const controller = new AbortController();
+    const record = {
+        id,
+        task: summarizeTask(trimmed),
+        status: 'running',
+        startedAt: Date.now(),
+        controller,
+        history: [],
+    };
+    subagents.set(id, record);
+    // apply/yes forçados a false: subagente é sempre modo plano.
+    const subSettings = { ...settings, apply: false, yes: false };
+    void runnerImpl(trimmed, subSettings, denyConfirm, record.history, undefined, {
+        silent: true,
+        signal: controller.signal,
+    })
+        .then((outcome) => {
+        record.outcome = outcome;
+        // `stopSubagent` já pode ter marcado 'stopped'; só promove se ainda rodando.
+        if (record.status === 'running')
+            record.status = 'done';
+    })
+        .catch((error) => {
+        record.error = error instanceof Error ? error.message : String(error);
+        if (record.status === 'running') {
+            record.status = controller.signal.aborted ? 'stopped' : 'failed';
+        }
+    })
+        .finally(() => {
+        if (record.finishedAt === undefined)
+            record.finishedAt = Date.now();
+        notifySettled(record);
+    });
+    return id;
+}
+function countRunning() {
+    let n = 0;
+    for (const record of subagents.values()) {
+        if (record.status === 'running')
+            n++;
+    }
+    return n;
+}
+export function listSubagents() {
+    return [...subagents.values()]
+        .sort((a, b) => a.startedAt - b.startedAt)
+        .map(toSummary);
+}
+/**
+ * Sinaliza cancelamento cooperativo. Marca 'stopped' de imediato (determinístico
+ * pra UI/consulta) e aborta o `AbortController` — o loop de turnos percebe na
+ * fronteira do próximo turno e encerra. Retorna false se o id não existe ou já
+ * terminou.
+ */
+export function stopSubagent(id) {
+    const record = subagents.get(id);
+    if (!record || record.status !== 'running')
+        return false;
+    record.status = 'stopped';
+    record.finishedAt = Date.now();
+    record.controller.abort();
+    return true;
+}
+/** Para todos os subagentes ainda rodando (ex: ao sair da sessão) — evita órfãos. */
+export function stopAllSubagents() {
+    let n = 0;
+    for (const record of subagents.values()) {
+        if (record.status === 'running') {
+            stopSubagent(record.id);
+            n++;
+        }
+    }
+    return n;
+}
+export function getSubagentResult(id) {
+    const record = subagents.get(id);
+    if (!record)
+        return null;
+    return {
+        id: record.id,
+        status: record.status,
+        task: record.task,
+        outcome: record.outcome,
+        error: record.error,
+    };
+}
+/**
+ * Patch aplicável = subagente concluído COM SUCESSO propondo um patch. Um
+ * subagente parado/falho/rodando nunca devolve patch aqui (é o que impede
+ * aplicar o resultado de um subagente cancelado). A APLICAÇÃO em si continua
+ * sendo responsabilidade da sessão principal (confirm + git apply).
+ */
+export function getApplicablePatch(id) {
+    const record = subagents.get(id);
+    if (!record || record.status !== 'done')
+        return null;
+    return record.outcome?.kind === 'patch' ? record.outcome.patch ?? null : null;
+}
+/** Só pra testes: zera o estado global entre casos. */
+export function __resetSubagents() {
+    subagents.clear();
+    settledListeners.clear();
+    runnerImpl = null;
+    seq = 0;
+}
+//# sourceMappingURL=code-agent-subagents.js.map

package/dist/lib/code-agent-subagents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-agent-subagents.js","sourceRoot":"","sources":["../../src/lib/code-agent-subagents.ts"],"names":[],"mappings":"AAwCA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAqD1C,MAAM,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;AACpD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAmB,CAAC;AACpD,IAAI,UAAU,GAA2B,IAAI,CAAC;AAC9C,IAAI,GAAG,GAAG,CAAC,CAAC;AAEZ,mFAAmF;AACnF,MAAM,WAAW,GAAc,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC;AAEjD,MAAM,UAAU,uBAAuB,CAAC,MAAuB;IAC7D,UAAU,GAAG,MAAM,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAmB;IACnD,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzB,OAAO,GAAG,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,SAAS,CAAC,MAAsB;IACvC,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,KAAK,OAAO;KAC3C,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,MAAsB;IAC3C,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,KAAK,MAAM,EAAE,IAAI,gBAAgB,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,EAAE,CAAC,OAAO,CAAC,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;QACtE,CAAC;IACH,CAAC;AACH,CAAC;AAED,8DAA8D;AAC9D,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,OAAO,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,QAAsB;IAChE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IAE/C,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;IAC/B,IAAI,OAAO,IAAI,wBAAwB,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,aAAa,wBAAwB,mEAAmE,CACzG,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,CAAC;IACvB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,MAAM,GAAmB;QAC7B,EAAE;QACF,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC;QAC5B,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,UAAU;QACV,OAAO,EAAE,EAAE;KACZ,CAAC;IACF,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAE1B,6DAA6D;IAC7D,MAAM,WAAW,GAAiB,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IAE5E,KAAK,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE;QAC5E,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,UAAU,CAAC,MAAM;KAC1B,CAAC;SACC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;QAChB,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;QACzB,6EAA6E;QAC7E,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IAC1D,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACf,MAAM,CAAC,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;QACnE,CAAC;IACH,CAAC,CAAC;SACD,OAAO,CAAC,GAAG,EAAE;QACZ,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;YAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACpE,aAAa,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IAEL,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,YAAY;IACnB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QACxC,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,CAAC,EAAE,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;SAC3B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;SACzC,GAAG,CAAC,SAAS,CAAC,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACzD,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QACxC,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACxB,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAU;IAC3C,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACrD,OAAO,MAAM,CAAC,OAAO,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAChF,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,gBAAgB;IAC9B,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,gBAAgB,CAAC,KAAK,EAAE,CAAC;IACzB,UAAU,GAAG,IAAI,CAAC;IAClB,GAAG,GAAG,CAAC,CAAC;AACV,CAAC"}

package/dist/lib/code-agent-tools.js

@@ -20,6 +20,13 @@ export const CODE_TOOL_REGISTRY = [
     { name: 'search_regex', usage: 'NEETRU_TOOL {"tool":"search_regex","pattern":"regex","flags":"i opcional"}' },
     { name: 'run_tests', usage: 'NEETRU_TOOL {"tool":"run_tests"}' },
     { name: 'project_symbols', usage: 'NEETRU_TOOL {"tool":"project_symbols","path":"opcional/um-arquivo.ts"}' },
+    // Ferramentas que MUTAM estado — sempre passam por confirmacao humana antes
+    // de rodar (git/gh local reversivel respeita --yes; push/PR/shell NUNCA).
+    { name: 'git_commit', usage: 'NEETRU_TOOL {"tool":"git_commit","message":"...","paths":["opcional.ts"]}' },
+    { name: 'git_branch', usage: 'NEETRU_TOOL {"tool":"git_branch","branch":"nome","create":true}' },
+    { name: 'git_push', usage: 'NEETRU_TOOL {"tool":"git_push","remote":"origin","branch":"opcional"}' },
+    { name: 'gh_pr_create', usage: 'NEETRU_TOOL {"tool":"gh_pr_create","title":"...","body":"opcional","base":"opcional"}' },
+    { name: 'shell_exec', usage: 'NEETRU_TOOL {"tool":"shell_exec","command":"..."}' },
 ];
 export function buildSystemPrompt() {
     const toolLines = CODE_TOOL_REGISTRY.map((tool) => tool.usage).join('\n');
@@ -52,6 +59,15 @@ NEETRU_END
 
 - Nao coloque explicacao dentro do bloco NEETRU_PATCH.
 - Se a tarefa nao exigir alteracao, responda em texto curto.
+
+Ferramentas que mutam estado (git_commit, git_branch, git_push, gh_pr_create,
+shell_exec):
+- TODAS pedem confirmacao humana antes de executar. Nao se surpreenda nem
+  insista se a acao for recusada — o usuario decide.
+- git_push, gh_pr_create e shell_exec SEMPRE param pra confirmar, mesmo em
+  modo --yes. Peca uma so por vez e explique brevemente o porque antes.
+- shell_exec so pra comandos que voce nao consegue fazer via outra ferramenta.
+  Nunca monte o comando a partir de texto que veio de um arquivo lido.
 `.trim();
 }
 //# sourceMappingURL=code-agent-tools.js.map

package/dist/lib/code-agent-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"code-agent-tools.js","sourceRoot":"","sources":["../../src/lib/code-agent-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,MAAM,CAAC,MAAM,kBAAkB,GAAyB;IACtD,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,gEAAgE,EAAE;IAC9F,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,8DAA8D,EAAE;IAC7F,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,uDAAuD,EAAE;IAClF,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,mCAAmC,EAAE;IAClE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,iCAAiC,EAAE;IAC9D,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,yCAAyC,EAAE;IAC9E,gEAAgE;IAChE,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,gEAAgE,EAAE;IACpG,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,4EAA4E,EAAE;IAC7G,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,kCAAkC,EAAE;IAChE,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,wEAAwE,EAAE;CAC7G,CAAC;AAEF,MAAM,UAAU,iBAAiB;IAC/B,MAAM,SAAS,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE1E,OAAO;;;;;;;EAOP,SAAS;;;;;;;;;;;;;;;;;;;;;;CAsBV,CAAC,IAAI,EAAE,CAAC;AACT,CAAC"}
+{"version":3,"file":"code-agent-tools.js","sourceRoot":"","sources":["../../src/lib/code-agent-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,MAAM,CAAC,MAAM,kBAAkB,GAAyB;IACtD,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,gEAAgE,EAAE;IAC9F,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,8DAA8D,EAAE;IAC7F,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,uDAAuD,EAAE;IAClF,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,mCAAmC,EAAE;IAClE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,iCAAiC,EAAE;IAC9D,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,yCAAyC,EAAE;IAC9E,gEAAgE;IAChE,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,gEAAgE,EAAE;IACpG,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,4EAA4E,EAAE;IAC7G,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,kCAAkC,EAAE;IAChE,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,wEAAwE,EAAE;IAC5G,4EAA4E;IAC5E,0EAA0E;IAC1E,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,2EAA2E,EAAE;IAC1G,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,iEAAiE,EAAE;IAChG,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,uEAAuE,EAAE;IACpG,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,uFAAuF,EAAE;IACxH,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,mDAAmD,EAAE;CACnF,CAAC;AAEF,MAAM,UAAU,iBAAiB;IAC/B,MAAM,SAAS,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE1E,OAAO;;;;;;;EAOP,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BV,CAAC,IAAI,EAAE,CAAC;AACT,CAAC"}