@neetru/cli 2.14.0 → 2.15.0

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

@@ -0,0 +1,27 @@
+import type { CodeMessage, CodeSettings } from './code-agent-types.js';
+export declare const AI_GATEWAY_CHAT_PATH = "/api/cli/v1/ai/chat";
+export interface GatewayChatResponse {
+    choices?: Array<{
+        message?: {
+            role?: CodeMessage['role'];
+            content?: string;
+        };
+    }>;
+    model?: string;
+    provider?: string;
+}
+export declare function callGateway(settings: CodeSettings, messages: CodeMessage[]): Promise<string>;
+/**
+ * Chamada com streaming (Fase 5, NEETRU_CODE_ARCHITECTURE.md: "streaming de
+ * resposta se o AI Gateway suportar"). Mesmo padrão de `streamGateway` em
+ * `src/lib/ai/orchestrator.ts` (fetch direto + `readSseLines` compartilhado) —
+ * não passa por `apiRequest`/`apiStream` porque nenhum dos dois fala SSE, e
+ * não importa o orchestrator inteiro só por essa função (ele carrega
+ * @anthropic-ai/sdk + openai, que `neetru code` não precisa).
+ *
+ * Acumula os deltas e retorna o texto completo — o protocolo
+ * `NEETRU_TOOL`/`NEETRU_PATCH` só pode ser parseado sobre a resposta inteira,
+ * então `onDelta` serve só para feedback visual (ex: contador de chars
+ * recebidos), não para processar a resposta aos poucos.
+ */
+export declare function streamGatewayChat(settings: CodeSettings, messages: CodeMessage[], onDelta?: (delta: string, totalChars: number) => void): Promise<string>;

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

@@ -0,0 +1,115 @@
+/**
+ * Chamada ao AI Gateway do Core pro `neetru code` — extraído de
+ * commands/code.ts (Fase 2, NEETRU_CODE_ARCHITECTURE.md: "separar núcleo de
+ * interface"). Sem lógica de UI/REPL — só monta e envia a requisição.
+ */
+import { apiRequest, maybeWarnUntrustedHost } from './api-client.js';
+import { getActiveTokenSync } from './token-resolver.js';
+import { config } from './config.js';
+import { readSseLines } from './sse.js';
+export const AI_GATEWAY_CHAT_PATH = '/api/cli/v1/ai/chat';
+export async function callGateway(settings, messages) {
+    const response = await apiRequest(AI_GATEWAY_CHAT_PATH, {
+        method: 'POST',
+        body: {
+            model: settings.model,
+            messages,
+            stream: false,
+            maxTokens: settings.maxTokens,
+            temperature: settings.temperature,
+        },
+        timeoutMs: settings.timeoutMs,
+    });
+    const content = response.choices?.[0]?.message?.content;
+    if (typeof content !== 'string') {
+        throw new Error('AI Gateway retornou resposta sem choices[0].message.content.');
+    }
+    return content;
+}
+/**
+ * Chamada com streaming (Fase 5, NEETRU_CODE_ARCHITECTURE.md: "streaming de
+ * resposta se o AI Gateway suportar"). Mesmo padrão de `streamGateway` em
+ * `src/lib/ai/orchestrator.ts` (fetch direto + `readSseLines` compartilhado) —
+ * não passa por `apiRequest`/`apiStream` porque nenhum dos dois fala SSE, e
+ * não importa o orchestrator inteiro só por essa função (ele carrega
+ * @anthropic-ai/sdk + openai, que `neetru code` não precisa).
+ *
+ * Acumula os deltas e retorna o texto completo — o protocolo
+ * `NEETRU_TOOL`/`NEETRU_PATCH` só pode ser parseado sobre a resposta inteira,
+ * então `onDelta` serve só para feedback visual (ex: contador de chars
+ * recebidos), não para processar a resposta aos poucos.
+ */
+export async function streamGatewayChat(settings, messages, onDelta) {
+    const token = getActiveTokenSync();
+    if (!token) {
+        throw new Error('Sessao Neetru ausente ou expirada. Rode `neetru login`.');
+    }
+    const baseUrl = (config.get('neetruApiUrl') ?? 'https://api.neetru.com').replace(/\/+$/, '');
+    maybeWarnUntrustedHost(baseUrl);
+    const url = `${baseUrl}${AI_GATEWAY_CHAT_PATH}`;
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(new Error(`neetru code stream timeout (${settings.timeoutMs}ms)`)), settings.timeoutMs);
+    try {
+        let resp;
+        try {
+            resp = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    accept: 'text/event-stream',
+                    authorization: `Bearer ${token}`,
+                },
+                body: JSON.stringify({
+                    model: settings.model,
+                    messages,
+                    stream: true,
+                    maxTokens: settings.maxTokens,
+                    temperature: settings.temperature,
+                }),
+                signal: ctrl.signal,
+            });
+        }
+        catch (error) {
+            if (ctrl.signal.aborted)
+                throw error;
+            throw new Error(`Falha ao contactar o AI Gateway (${url}): ${error?.message ?? String(error)}`);
+        }
+        if (!resp.ok) {
+            const bodyText = await resp.text().catch(() => '');
+            let detail = bodyText;
+            try {
+                const parsed = JSON.parse(bodyText);
+                if (parsed?.error?.message)
+                    detail = parsed.error.message;
+            }
+            catch {
+                // corpo nao-JSON — usa o texto cru (truncado abaixo).
+            }
+            throw new Error(`AI Gateway retornou ${resp.status}: ${detail.slice(0, 300) || 'erro sem detalhe'}`);
+        }
+        if (!resp.body)
+            throw new Error('AI Gateway retornou resposta sem body.');
+        let content = '';
+        await readSseLines(resp.body, (payload) => {
+            if (payload === '[DONE]')
+                return;
+            let obj;
+            try {
+                obj = JSON.parse(payload);
+            }
+            catch {
+                return; // linha nao-JSON (keep-alive) — ignora.
+            }
+            const delta = obj?.choices?.[0]?.delta?.content;
+            if (typeof delta === 'string' && delta) {
+                content += delta;
+                onDelta?.(delta, content.length);
+            }
+        });
+        return content;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=code-agent-gateway.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"code-agent-gateway.js","sourceRoot":"","sources":["../../src/lib/code-agent-gateway.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxC,MAAM,CAAC,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAa1D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAsB,EAAE,QAAuB;IAC/E,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAsB,oBAAoB,EAAE;QAC3E,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;YACJ,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,QAAQ;YACR,MAAM,EAAE,KAAK;YACb,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,WAAW,EAAE,QAAQ,CAAC,WAAW;SAClC;QACD,SAAS,EAAE,QAAQ,CAAC,SAAS;KAC9B,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC;IACxD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAsB,EACtB,QAAuB,EACvB,OAAqD;IAErD,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,wBAAwB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7F,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,oBAAoB,EAAE,CAAC;IAEhD,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,UAAU,CACtB,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,+BAA+B,QAAQ,CAAC,SAAS,KAAK,CAAC,CAAC,EACnF,QAAQ,CAAC,SAAS,CACnB,CAAC;IAEF,IAAI,CAAC;QACH,IAAI,IAAc,CAAC;QACnB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBACtB,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,MAAM,EAAE,mBAAmB;oBAC3B,aAAa,EAAE,UAAU,KAAK,EAAE;iBACjC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;oBACrB,QAAQ;oBACR,MAAM,EAAE,IAAI;oBACZ,SAAS,EAAE,QAAQ,CAAC,SAAS;oBAC7B,WAAW,EAAE,QAAQ,CAAC,WAAW;iBAClC,CAAC;gBACF,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,MAAM,KAAK,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,oCAAoC,GAAG,MAAM,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClG,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,IAAI,MAAM,GAAG,QAAQ,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAoD,CAAC;gBACvF,IAAI,MAAM,EAAE,KAAK,EAAE,OAAO;oBAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;YAC5D,CAAC;YAAC,MAAM,CAAC;gBACP,sDAAsD;YACxD,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,kBAAkB,EAAE,CAAC,CAAC;QACvG,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAE1E,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE;YACxC,IAAI,OAAO,KAAK,QAAQ;gBAAE,OAAO;YACjC,IAAI,GAA0D,CAAC;YAC/D,IAAI,CAAC;gBACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,wCAAwC;YAClD,CAAC;YACD,MAAM,KAAK,GAAG,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC;YAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,EAAE,CAAC;gBACvC,OAAO,IAAI,KAAK,CAAC;gBACjB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}

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

@@ -1,10 +1,17 @@
 export interface CodeToolRequest {
     tool: string;
     path?: unknown;
+    paths?: unknown;
     pattern?: unknown;
+    flags?: unknown;
     query?: unknown;
     error?: string;
 }
+export interface PatchFileSummary {
+    file: string;
+    added: number;
+    removed: number;
+}
 export declare function parseToolRequest(text: string): CodeToolRequest | null;
 /**
  * So aceita o bloco explicito `NEETRU_PATCH ... NEETRU_END` do protocolo —
@@ -14,3 +21,4 @@ export declare function parseToolRequest(text: string): CodeToolRequest | null;
  * review 2026-07-09).
  */
 export declare function extractPatch(text: string): string | null;
+export declare function summarizePatch(patch: string): PatchFileSummary[];

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

@@ -31,4 +31,26 @@ export function extractPatch(text) {
     const marker = source.match(/NEETRU_PATCH\s*([\s\S]*?)\s*NEETRU_END/);
     return marker?.[1] ? `${marker[1].trim()}\n` : null;
 }
+export function summarizePatch(patch) {
+    const summaries = new Map();
+    let current = null;
+    for (const line of patch.split(/\r?\n/)) {
+        const match = line.match(/^diff --git a\/(.+?) b\/(.+)$/);
+        if (match) {
+            const file = match[2] || match[1];
+            current = summaries.get(file) ?? { file, added: 0, removed: 0 };
+            summaries.set(file, current);
+            continue;
+        }
+        if (!current)
+            continue;
+        if (line.startsWith('+++') || line.startsWith('---'))
+            continue;
+        if (line.startsWith('+'))
+            current.added += 1;
+        if (line.startsWith('-'))
+            current.removed += 1;
+    }
+    return Array.from(summaries.values());
+}
 //# sourceMappingURL=code-agent-protocol.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"code-agent-protocol.js","sourceRoot":"","sources":["../../src/lib/code-agent-protocol.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACxC,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,SAAS;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,IAAI,CAAC,GAAG;YAAE,SAAS;QAEnB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;YAC1C,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAQ,MAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpG,OAAO,MAAyB,CAAC;YACnC,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;QACjF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,iCAAiC,GAAG,EAAE,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACtE,OAAO,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACtD,CAAC"}
+{"version":3,"file":"code-agent-protocol.js","sourceRoot":"","sources":["../../src/lib/code-agent-protocol.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACxC,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,SAAS;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,IAAI,CAAC,GAAG;YAAE,SAAS;QAEnB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;YAC1C,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAQ,MAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpG,OAAO,MAAyB,CAAC;YACnC,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;QACjF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,iCAAiC,GAAG,EAAE,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACtE,OAAO,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,SAAS,GAAG,IAAI,GAAG,EAA4B,CAAC;IACtD,IAAI,OAAO,GAA4B,IAAI,CAAC;IAE5C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC1D,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;YAClC,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;YAChE,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC7B,SAAS;QACX,CAAC;QAED,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,SAAS;QAC/D,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;QAC7C,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;AACxC,CAAC"}

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

@@ -0,0 +1,54 @@
+/**
+ * Máquina de estados da sessão do `neetru code` (Fase 2,
+ * NEETRU_CODE_ARCHITECTURE.md: "Estados da sessão" — "hoje isso esta
+ * implicito por prints; o proximo passo e transformar em estrutura
+ * testavel"). Pura, sem I/O — commands/code.ts chama `transition()` nos
+ * pontos do loop de turno; testes verificam a sequência sem mockar o
+ * AI Gateway inteiro.
+ */
+export type CodeAgentState = 'idle' | 'thinking' | 'tool_requested' | 'tool_running' | 'patch_ready' | 'awaiting_confirm' | 'applied' | 'failed' | 'aborted';
+export declare class CodeAgentStateMachine {
+    private current;
+    private readonly log;
+    get state(): CodeAgentState;
+    /** Histórico de estados desde a criação (ou último `reset`). Só leitura. */
+    get history(): readonly CodeAgentState[];
+    transition(next: CodeAgentState): void;
+    reset(): void;
+}
+export type CodeSessionRole = 'system' | 'user' | 'assistant';
+export interface CodeSessionMessage {
+    role: CodeSessionRole;
+    content: string;
+}
+export interface CodeSessionSnapshot {
+    cwd: string;
+    model: string;
+}
+export declare function compactCodeHistory<T extends CodeSessionMessage>(history: T[], keepRecent?: number): number;
+export declare function formatCodeSessionMarkdown(settings: CodeSessionSnapshot, history: CodeSessionMessage[]): string;
+export declare function saveCodeSession(settings: CodeSessionSnapshot, history: CodeSessionMessage[]): string;
+/**
+ * Retomar sessao por id (Fase 4, NEETRU_CODE_ARCHITECTURE.md) — mesmo padrao
+ * de UX de qualquer REPL com persistencia (lista sessoes salvas, numera,
+ * usuario escolhe). Nada disso vem de codigo alheio: e o jeito obvio de
+ * resolver "listar + escolher" numa CLI de terminal.
+ */
+export interface CodeSessionSummary {
+    /** Path relativo ao cwd (ex: `.neetru/code/sessions/2026-07-10T...-abc.md`). */
+    file: string;
+    timestamp: string;
+    messageCount: number;
+    /** Primeiras ~80 chars da primeira mensagem de usuario — ajuda a reconhecer a sessao na lista. */
+    preview: string;
+}
+/** Lista sessoes salvas, mais recente primeiro (nomes de arquivo ISO ordenam lexicograficamente). */
+export declare function listCodeSessions(cwd: string): CodeSessionSummary[];
+/** Carrega as mensagens de uma sessao salva (`file` relativo ao cwd, vindo de listCodeSessions). */
+export declare function loadCodeSession(cwd: string, file: string): CodeSessionMessage[];
+/**
+ * Log local de patch aplicado (Fase 4) — 1 linha por patch, append-only.
+ * Nao substitui git log/reflog; e so um resumo rapido "o que o agente mudou
+ * e quando", legivel sem abrir o git.
+ */
+export declare function logAppliedPatch(cwd: string, summary: string): void;

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

@@ -0,0 +1,147 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { redactSecrets } from './code-agent-files.js';
+const VALID_TRANSITIONS = {
+    idle: ['thinking'],
+    // thinking -> idle: turno terminou em texto final (sem tool nem patch).
+    thinking: ['tool_requested', 'patch_ready', 'idle', 'failed'],
+    tool_requested: ['tool_running'],
+    tool_running: ['thinking', 'failed'],
+    patch_ready: ['awaiting_confirm', 'applied', 'aborted'],
+    awaiting_confirm: ['applied', 'aborted'],
+    applied: ['idle'],
+    failed: ['idle'],
+    aborted: ['idle'],
+};
+export class CodeAgentStateMachine {
+    current = 'idle';
+    log = ['idle'];
+    get state() {
+        return this.current;
+    }
+    /** Histórico de estados desde a criação (ou último `reset`). Só leitura. */
+    get history() {
+        return this.log;
+    }
+    transition(next) {
+        const allowed = VALID_TRANSITIONS[this.current];
+        if (!allowed.includes(next)) {
+            throw new Error(`Transicao de estado invalida: ${this.current} -> ${next}`);
+        }
+        this.current = next;
+        this.log.push(next);
+    }
+    reset() {
+        this.current = 'idle';
+        this.log.length = 0;
+        this.log.push('idle');
+    }
+}
+export function compactCodeHistory(history, keepRecent = 8) {
+    if (history.length <= keepRecent + 1)
+        return 0;
+    const system = history.find((message) => message.role === 'system');
+    const recent = history.slice(-keepRecent);
+    const next = system ? [system, ...recent.filter((message) => message !== system)] : recent;
+    const removed = history.length - next.length;
+    history.splice(0, history.length, ...next);
+    return removed;
+}
+export function formatCodeSessionMarkdown(settings, history) {
+    const lines = [
+        '# Neetru Code Session',
+        '',
+        `- date: ${new Date().toISOString()}`,
+        `- cwd: ${settings.cwd}`,
+        `- model: ${settings.model}`,
+        `- messages: ${history.length}`,
+        '',
+        '## Conversa',
+        '',
+    ];
+    for (const message of history) {
+        lines.push(`### ${message.role}`);
+        lines.push('');
+        lines.push('```text');
+        lines.push(redactSecrets(message.content).slice(0, 40_000));
+        lines.push('```');
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function saveCodeSession(settings, history) {
+    const dir = path.join(settings.cwd, '.neetru', 'code', 'sessions');
+    fs.mkdirSync(dir, { recursive: true });
+    const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const file = path.join(dir, `${stamp}.md`);
+    fs.writeFileSync(file, formatCodeSessionMarkdown(settings, history), 'utf8');
+    return path.relative(settings.cwd, file).replace(/\\/g, '/');
+}
+function sessionsDir(cwd) {
+    return path.join(cwd, '.neetru', 'code', 'sessions');
+}
+function parseSessionMarkdown(content) {
+    const dateMatch = content.match(/^- date: (.+)$/m);
+    const countMatch = content.match(/^- messages: (\d+)$/m);
+    const messages = [];
+    const blockRe = /### (system|user|assistant)\n\n```text\n([\s\S]*?)\n```/g;
+    let match;
+    while ((match = blockRe.exec(content))) {
+        messages.push({ role: match[1], content: match[2] });
+    }
+    return {
+        date: dateMatch?.[1] ?? '',
+        messageCount: countMatch ? Number.parseInt(countMatch[1], 10) : messages.length,
+        messages,
+    };
+}
+/** Lista sessoes salvas, mais recente primeiro (nomes de arquivo ISO ordenam lexicograficamente). */
+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,
+        };
+    });
+}
+/** Carrega as mensagens de uma sessao salva (`file` relativo ao cwd, vindo de listCodeSessions). */
+export function loadCodeSession(cwd, file) {
+    const full = path.resolve(cwd, file);
+    if (!full.startsWith(path.resolve(sessionsDir(cwd)))) {
+        throw new Error(`Sessao fora do diretorio esperado: ${file}`);
+    }
+    if (!fs.existsSync(full)) {
+        throw new Error(`Sessao nao encontrada: ${file}`);
+    }
+    const content = fs.readFileSync(full, 'utf8');
+    return parseSessionMarkdown(content).messages;
+}
+/**
+ * Log local de patch aplicado (Fase 4) — 1 linha por patch, append-only.
+ * Nao substitui git log/reflog; e so um resumo rapido "o que o agente mudou
+ * e quando", legivel sem abrir o git.
+ */
+export function logAppliedPatch(cwd, summary) {
+    const dir = path.join(cwd, '.neetru', 'code');
+    fs.mkdirSync(dir, { recursive: true });
+    const file = path.join(dir, 'patches.log');
+    fs.appendFileSync(file, `${new Date().toISOString()} ${summary}\n`, 'utf8');
+}
+//# sourceMappingURL=code-agent-session.js.map

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

@@ -0,0 +1 @@
+{"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-tools.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Registro de ferramentas locais do `neetru code` — extraído de
+ * commands/code.ts (Fase 2, NEETRU_CODE_ARCHITECTURE.md: "separar núcleo de
+ * interface"). O system prompt é montado a partir do registro: Fase 3
+ * (run_tests, read_many_files, search_regex, project_symbols) só precisa
+ * adicionar entradas aqui — não editar o prompt à mão em vários lugares.
+ *
+ * Execução real das ferramentas (I/O de arquivo/git) mora em
+ * code-agent-files.ts — este módulo só descreve o protocolo pro modelo.
+ */
+export interface CodeToolDescriptor {
+    name: string;
+    /** Linha de invocação mostrada no system prompt (protocolo NEETRU_TOOL). */
+    usage: string;
+}
+export declare const CODE_TOOL_REGISTRY: CodeToolDescriptor[];
+export declare function buildSystemPrompt(): string;

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

@@ -0,0 +1,52 @@
+/**
+ * Registro de ferramentas locais do `neetru code` — extraído de
+ * commands/code.ts (Fase 2, NEETRU_CODE_ARCHITECTURE.md: "separar núcleo de
+ * interface"). O system prompt é montado a partir do registro: Fase 3
+ * (run_tests, read_many_files, search_regex, project_symbols) só precisa
+ * adicionar entradas aqui — não editar o prompt à mão em vários lugares.
+ *
+ * Execução real das ferramentas (I/O de arquivo/git) mora em
+ * code-agent-files.ts — este módulo só descreve o protocolo pro modelo.
+ */
+export const CODE_TOOL_REGISTRY = [
+    { name: 'read_file', usage: 'NEETRU_TOOL {"tool":"read_file","path":"caminho/relativo.ext"}' },
+    { name: 'list_files', usage: 'NEETRU_TOOL {"tool":"list_files","pattern":"texto opcional"}' },
+    { name: 'search', usage: 'NEETRU_TOOL {"tool":"search","query":"texto literal"}' },
+    { name: 'git_status', usage: 'NEETRU_TOOL {"tool":"git_status"}' },
+    { name: 'git_diff', usage: 'NEETRU_TOOL {"tool":"git_diff"}' },
+    { name: 'project_overview', usage: 'NEETRU_TOOL {"tool":"project_overview"}' },
+    // Fase 3 (NEETRU_CODE_ARCHITECTURE.md): ferramentas produtivas.
+    { name: 'read_many_files', usage: 'NEETRU_TOOL {"tool":"read_many_files","paths":["a.ts","b.ts"]}' },
+    { 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"}' },
+];
+export function buildSystemPrompt() {
+    const toolLines = CODE_TOOL_REGISTRY.map((tool) => tool.usage).join('\n');
+    return `
+Voce e o Neetru Code, um assistente local de codificacao da Neetru.
+Voce conversa com modelos do AI Gateway do Neetru Core, normalmente Groq/NVIDIA.
+Nao use Anthropic/Claude como caminho assumido.
+
+Voce nao tem tool calling nativo. Use exatamente estes protocolos textuais:
+
+${toolLines}
+
+Regras:
+- Peca arquivos antes de alterar codigo quando faltar contexto.
+- Use project_overview/git_status quando precisar entender o projeto antes de editar.
+- Use git_diff antes de revisar mudancas ja existentes.
+- Nunca invente conteudo de arquivo.
+- Peca uma tool por resposta, no maximo.
+- Quando estiver pronto para alterar, responda somente com um diff aplicavel por git:
+
+NEETRU_PATCH
+diff --git a/path b/path
+...
+NEETRU_END
+
+- Nao coloque explicacao dentro do bloco NEETRU_PATCH.
+- Se a tarefa nao exigir alteracao, responda em texto curto.
+`.trim();
+}
+//# sourceMappingURL=code-agent-tools.js.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;CAiBV,CAAC,IAAI,EAAE,CAAC;AACT,CAAC"}

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

@@ -0,0 +1,34 @@
+/**
+ * Tipos compartilhados entre os módulos do `neetru code`
+ * (code.ts, code-agent-ui.ts, code-agent-gateway.ts, code-agent-tools.ts,
+ * code-agent-session.ts) — evita import circular de tipo entre eles.
+ */
+export type CodeRole = 'system' | 'user' | 'assistant';
+export interface CodeMessage {
+    role: CodeRole;
+    content: string;
+}
+export interface CodeCommandOptions {
+    cwd?: string;
+    file?: string[];
+    model?: string;
+    maxTurns?: string | number;
+    maxTokens?: string | number;
+    temperature?: string | number;
+    plan?: boolean;
+    apply?: boolean;
+    yes?: boolean;
+}
+export interface CodeSettings {
+    cwd: string;
+    files: string[];
+    model: string;
+    modelWarning?: string;
+    maxTurns: number;
+    maxTokens: number;
+    temperature: number;
+    apply: boolean;
+    yes: boolean;
+    timeoutMs: number;
+}
+export type ConfirmFn = (question: string) => Promise<boolean>;

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

@@ -0,0 +1,7 @@
+/**
+ * Tipos compartilhados entre os módulos do `neetru code`
+ * (code.ts, code-agent-ui.ts, code-agent-gateway.ts, code-agent-tools.ts,
+ * code-agent-session.ts) — evita import circular de tipo entre eles.
+ */
+export {};
+//# sourceMappingURL=code-agent-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"code-agent-types.js","sourceRoot":"","sources":["../../src/lib/code-agent-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

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

@@ -0,0 +1,30 @@
+import { type CodeToolRequest } from './code-agent-protocol.js';
+import type { CodeMessage, CodeSettings } from './code-agent-types.js';
+export declare function stripAnsi(text: string): string;
+export declare function visibleLength(text: string): number;
+export declare function padVisible(text: string, width: number): string;
+export declare function terminalWidth(): number;
+export declare function truncateMiddle(text: string, max: number): string;
+export declare function wrapPlain(text: string, width: number): string[];
+export declare function printBox(title: string, rows?: string[]): void;
+export declare function printStatusBar(settings: CodeSettings, mode: 'interactive' | 'oneshot' | 'doctor'): void;
+export declare function printDivider(label?: string): void;
+export declare function printEvent(kind: 'wait' | 'tool' | 'ok' | 'warn' | 'error', title: string, detail?: string): void;
+export declare function summarizeToolResult(result: string): string;
+export declare function printAssistantText(content: string): void;
+export declare function patchSummaryRows(patch: string): string[];
+export declare function printPatchPreview(patch: string): void;
+export declare function renderHeader(settings: CodeSettings, mode?: 'interactive' | 'oneshot' | 'doctor'): void;
+export declare function renderInteractiveHelp(): void;
+export declare function renderSessionStatus(settings: CodeSettings, history?: CodeMessage[]): void;
+export declare function renderPrompt(settings: CodeSettings): string;
+export declare function printFileSample(files: string[], total: number): void;
+/** Picker de arquivos (Fase 5) — lista numerada; `/pick` pede o(s) numero(s) ao usuario. */
+export declare function printFilePicker(files: string[], total: number): void;
+/** Lista sessoes salvas numeradas (Fase 4) — usuario escolhe pelo numero em `/resume`. */
+export declare function printSessionList(sessions: Array<{
+    timestamp: string;
+    messageCount: number;
+    preview: string;
+}>): void;
+export declare function toolDetail(tool: CodeToolRequest | null): string;