fn_registry/dev/issues/0131-cpp-module-chat-panel.md

id, title, status, type, domain, scope, priority, depends, blocks, related, created, updated, tags, flow

id	title	status	type	domain	scope	priority	depends	blocks	related	created	updated	tags	flow
0131	Modulo C++ chat_panel — panel ImGui para chat con agentes	pendiente	app	cpp-stack agents dev-ux	cross-stack	alta	0113		0130	2026-05-22	2026-05-22	cpp imgui agents chat module sse

0131 — Modulo C++ chat_panel

Status: pendiente

Por que

Tras lanzar un agente desde kanban_cpp (issue 0130), no hay forma de interactuar con el desde la propia app. Hoy el flujo es: lanzar agente, abrir terminal aparte, tail -f /tmp/wt-.../agent.log. Queremos un panel C++ reutilizable que cualquier app embebra para chatear con un agente (Claude headless o futuros) y ver su output en streaming.

Que entrega

Modulo cpp/functions/viz/chat_panel/ (paquete del registry, kind: function, lang: cpp, domain: viz). API:

namespace fn_chat {
    struct ChatPanel {
        // run_id del agent_runner_api; null = panel vacio "no agent attached"
        std::string run_id;
        std::string backend_url = "http://127.0.0.1:8486"; // agent_runner_api
        bool        auto_scroll = true;
    };
    void render(ChatPanel& panel);
}

Comportamiento:

• Conecta SSE /api/runs/<run_id>/sse en background thread (reusa sse_client_cpp_core).
• Parsea eventos state, log, evidence, finish y los renderiza:
  • log → linea cruda en buffer scrollable.
  • state → badge superior con status (pending/running/done/aborted/failed).
  • evidence → chip lateral con kind + payload_url.
  • finish → marca run terminada, deja conexion para ver historico.
• Input box inferior (multiline) + boton "Send". POST a /api/runs/<run_id>/message (endpoint A IMPLEMENTAR en agent_runner_api — extension paralela; si no existe, boton se deshabilita).
• Toolbar: Abort run, Clear buffer, Show evidence panel.

Estructura

cpp/functions/viz/chat_panel/
  chat_panel.h
  chat_panel.cpp
  chat_panel.md
  chat_panel_test.cpp

Reusa del registry

• sse_client_cpp_core — SSE async.
• http_request_cpp_core — POST mensajes / abort.
• selectable_text_cpp_viz — copy log lines.
• data_table_cpp_viz — opcional para tabla de evidencias.

DoD

• Modulo compila en Linux + Windows.
• Demo en primitives_gallery o app dedicada agent_chat_demo con run_id fijo + mock SSE feeder.
• Integracion en kanban_cpp v2: nuevo panel "Chat" que se abre al hacer click en card con agent_active, run_id se pasa automatico.
• e2e_checks: smoke con mock SSE; assertion: tras emitir 3 eventos de log, panel los muestra en orden.

Anti-scope (v1)

• No persiste history local (refresh = perdemos buffer; agent.log es la fuente).
• No syntax highlight markdown / codigo.
• Sin multi-run (un panel = un run).
• Sin file diff inline (kind:evidence con kind:diff queda como link a git show).

Notas

Si el endpoint POST /api/runs/:id/message no existe en agent_runner_api, abrir issue paralelo 0131b para anadirlo (claude headless aceptara mensajes via stdin del subprocess — el runner debe forwardearlos). Para v1 se acepta panel read-only.