Files
graph_explorer/agent.h
T
egutierrez 0bab5c97c7 chore: auto-commit (5 archivos)
- CMakeLists.txt
- agent.cpp
- agent.h
- gx-cli
- main.cpp

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-10 13:30:27 +02:00

66 lines
2.6 KiB
C++

#pragma once
#include <string>
#include <vector>
// Panel Chat — agente Claude (claude -p) con tool-use sobre operations.db
// via gx-cli. Subprocess persistente bidireccional (stdin/stdout JSON-lines).
// El usuario escribe, el hilo lector parsea stream-json y va emitiendo
// fragmentos al historial. gx-cli muta operations.db; el contador
// agent_mutations en graph_explorer.db dispara reload del viewport.
namespace app_agent {
// Inicia el subprocess claude -p (lazy: hasta el primer mensaje no se
// arranca). Setea env vars GX_OPS_DB / GX_APP_DB / GX_APP_DIR. Devuelve
// false si claude no esta disponible (o, en Windows, wsl no esta).
bool chat_init(const char* ops_db_path,
const char* app_db_path,
const char* app_dir);
// Si la ops_db cambia (proyecto switch), refresca env del subprocess
// matandolo y dejando que el siguiente send lo reabra.
void chat_set_ops_db(const char* ops_db_path);
// Envia un mensaje del usuario al agente. Si el subprocess no esta vivo,
// lo arranca primero. No bloquea — el resultado llega via chat_render
// al ir vaciando la cola del hilo lector.
void chat_send(const char* user_text);
// Renderiza el panel ImGui (titulo "Chat"). Drena cola de mensajes del
// hilo lector. `panel_open` es bound al close button.
void chat_render(bool* panel_open);
// Cierra el subprocess y libera recursos. Llamar en shutdown.
void chat_shutdown();
// Counter de mutaciones (lee tabla agent_mutations en app_db). Se llama
// desde main.cpp cada frame para detectar si gx-cli muto algo y disparar
// reload del grafo. Devuelve 0 si la tabla no existe todavia.
int chat_mutations_counter();
// ----------------------------------------------------------------------------
// Logging con tags
//
// Todas las trazas del subsistema chat van a `<app_dir>/chat.log` ademas de
// stderr. Cada linea tiene formato:
//
// 2026-05-01T18:35:50.853Z [chat:detect] mensaje
//
// Tags usados (grep amigable):
// detect deteccion de claude/wsl al arrancar
// env env vars seteadas para el subprocess
// spawn argv completo + cwd al lanzar el subprocess
// io operaciones sobre los pipes (lectura/escritura/EOF)
// parse eventos JSON parseados desde stream-json
// tools tool_use detectados, comandos Bash invocados
// mut cambios detectados via agent_mutations.counter
// error fallos y exit codes
// ----------------------------------------------------------------------------
void chat_log(const char* tag, const char* fmt, ...);
// Devuelve el path absoluto del fichero de log (vacio si no inicializado).
const char* chat_log_path();
} // namespace app_agent