Rascunho do Adaptador do Daemon TUI

Obsoleto: este documento descreve o protótipo inicial DaemonTuiAdapter. O adaptador legado ainda existe em packages/cli/src/ui/daemon/, mas a direção reutilizável agora é a camada de transcrição de UI compartilhada do SDK. Para a arquitetura atual, veja ../daemon/14-cli-tui-adapter.md.

Objetivo (histórico)

Adicionar um transporte TUI controlado por flag que se comunica com qwen serve através do DaemonSessionClient em vez de criar um Config + runtime de agente em processo.

Este é um caminho de validação interno para a migração do cliente Modo B. Ele não deve substituir o caminho TUI padrão até que os sinks de saída, eventos tipados do daemon, permissões com escopo de sessão e diagnósticos de ciclo de vida estejam estáveis.

Ponto de Entrada Proposto


QWEN_DAEMON_URL=http://127.0.0.1:4170 qwen --experimental-daemon-tui

Opcional:


QWEN_DAEMON_TOKEN=... QWEN_DAEMON_WORKSPACE=/repo qwen --experimental-daemon-tui

A CLI deve recusar este modo a menos que ambas as condições sejam verdadeiras:

QWEN_DAEMON_URL ou --daemon-url esteja definido.
GET /capabilities anuncie session_create, session_prompt e session_events.

Fluxo Mínimo

Criar DaemonClient com URL e token do daemon.
Buscar /capabilities.
Criar ou anexar com DaemonSessionClient.createOrAttach().
Assinar session.events().
Enviar prompts do usuário através de session.prompt().
Roteizar cancelamento através de session.cancel().
Roteizar troca de modelo através de session.setModel().
Roteizar votos de permissão através de session.respondToPermission().

Contrato de Renderização

A primeira implementação adiciona DaemonTuiAdapter, um reducer e spike de transporte verificável localmente. Ele mapeia apenas estes eventos do daemon:

Evento do daemon	Manipulação no TUI
`session_update` / `agent_message_chunk`	Adicionar texto do assistente
`session_update` / `agent_thought_chunk`	Adicionar texto de pensamento
`session_update` / `tool_call`	Mostrar ciclo de vida da chamada de ferramenta
`permission_request`	Mostrar UI de confirmação existente quando possível
`permission_resolved`	Fechar ou atualizar UI de confirmação
`model_switched`	Atualizar exibição do rodapé/modelo
`session_died`	Mostrar estado desconectado e interromper streaming

Eventos desconhecidos devem ser ignorados, não fatais. Reducers de eventos tipados chegarão em um PR de protocolo posterior.

O adaptador ainda não está conectado ao aplicativo Ink padrão. O comportamento existente do TUI interativo, JSONL, stream-json e saída dupla permanece inalterado.

Não Objetivos Explícitos

Não remover o runtime TUI atual em processo.
Não alterar o comportamento JSONL, stream-json ou saída dupla neste PR.
Não expor CRUD de arquivos, gerenciamento MCP, CRUD de memória ou mutação de provedor/auth através do TUI ainda.
Não fazer suposições de navegador/web direto ao daemon; isto é apenas terminal.

Segurança do Merge

Desabilitado por padrão.
Caminho de código aditivo.
Nenhuma flag CLI existente altera comportamento.
Se o daemon estiver indisponível, o caminho experimental falha antes de iniciar o TUI e informa ao usuário para executar qwen serve.

Plano de Validação

Testar unitariamente o mapeamento de evento-para-estado-TUI com eventos sintéticos do daemon.
Testar unitariamente o encaminhamento de prompt, cancelamento, troca de modelo e voto de permissão.
Testar unitariamente o parsing de flag/env quando a flag de funcionalidade está conectada.
Testar smoke contra um qwen serve local:
- o texto do prompt flui para o TUI
- cancelamento resolve o prompt ativo
- solicitação de permissão pode ser aceita ou rejeitada
- reconexão envia o Last-Event-ID rastreado

Bloqueios Antes da Migração Padrão

Esquema de evento tipado do daemon.
Rota de permissão com escopo de sessão.
Refatoração do sink de saída para paridade JSONL / stream-json / saída dupla.
Semântica de fechamento/exclusão do ciclo de vida da sessão.
Diagnósticos de runtime para MCP, skills, provedores e ambiente de workspace.