Base e ferramentas
KatanA Chat UI
Base Rust para um painel de chat independente do aplicativo host. A versão pública mantém o histórico de conversas e os rascunhos de entrada e produz um modelo de exibição.
Responsáveis por integrar uma UI de chat em aplicativos da série KatanA
01
Funções implementadas
02
Primeiros passos
- Obtenha o repositório e confirme no README que o escopo público ainda é uma fundação e que a UI e a integração continuam sob responsabilidade do host.
- Execute cargo test -p katana-chat-ui para verificar os testes do rascunho e do modelo de exibição e depois conecte ChatPanel à sua própria UI.
Prepare Rust e as ferramentas de desenvolvimento necessárias e consulte o README indicado para os requisitos antes da integração. Os exemplos são pontos de entrada e não garantem funcionamento em todos os ambientes.
Fontesgit clone https://github.com/HiroyukiFuruno/katana-chat-ui.git
cd katana-chat-ui
cargo test -p katana-chat-ui01 / KCU
Casos de uso
Separar o chat state mínimo do framework
A implementação atual de KCU mantém em ChatPanelState o histórico de ChatTurn e a string draft, e expõe quantidade do histórico e draft em ChatPanelRenderModel. O host desenha esse modelo no próprio framework; KCU não traz widget.
Preparar o contrato anterior à conexão ACP
katana-acp-client expõe AiRequest, AiResponse e AiProvider; intent, document context, prompt e history podem ser entregues à fronteira do provider. KCU não conclui a conexão: host ou connector implementa esse contrato.
02 / KCU
Fluxo da entrada à saída
Deixar o host dono do state
O host cria ChatPanelState e mantém o ciclo de vida de history e draft. ChatPanel::new apenas toma esse state emprestado de forma mutável; não possui workspace ou document state da aplicação.
Converter a entrada em render model
A UI escreve a entrada em draft com ChatPanel::draft_mut(); render_model() cria ChatPanelRenderModel com history_len e draft. A implementação atual não inclui o antigo processamento de anexos, message output ou streaming UI.
Conectar a fronteira do provider no host
O host que usa ACP preenche AiRequest com AiIntent, DocumentContext, prompt e history de ChatTurn e chama AiProvider::execute(). Host ou connector decide como refletir AiResponse em history e na UI; isso não é processamento implementado no KCU.
03 / KCU
APIs e CLI principais
ChatPanelState — Estado do chat- É o chat state atual com apenas history: Vec<ChatTurn> e draft: String. Não inclui persistência de input/histórico nem gerenciamento de execução do provider.
ChatPanel — Facade do estado- new toma o state emprestado, draft_mut atualiza a entrada e render_model cria um snapshot de exibição. É uma facade fina sem tipos de UI framework.
ChatPanelRenderModel — Modelo de exibição- É um modelo imutável com history_len e draft. O host pode desenhá-lo em qualquer UI, mas detalhes de message e output action não fazem parte dos tipos KCU atuais.
AiRequest e AiProvider- AiRequest representa intent, DocumentContext, prompt e history; AiProvider define available, capabilities, models e execute. O ACP transport é scaffolding e não significa conexão provider concluída.
04 / KCU
Entenda com um exemplo
Criar render model a partir de draft
Crie ChatPanelState com default, passe-o a ChatPanel::new, acrescente texto com draft_mut() e chame render_model(). Entregue history_len e draft à UI do host.
use katana_chat_ui::{ChatPanel, ChatPanelState};
fn main() {
let mut state = ChatPanelState::default();
let mut panel = ChatPanel::new(&mut state);
panel.draft_mut().push_str("Explain this document");
let model = panel.render_model();
println!("history={} draft={}", model.history_len, model.draft);
}05 / KCU
Integração e limites
Implementar UI e provider separadamente
O README descreve katana-chat-ui como state/render model framework-neutral, Floem como planned reference UI e connector como planned boundary. O consumidor desenha ChatPanelRenderModel e conecta ACP ou um provider direto separadamente.
Fixar o escopo de scaffolding
O Status do README atual é Scaffolding. Workspace shell, document state, UI adapter, diagram rendering e document export estão fora do escopo; trate a biblioteca como base para draft mínimo e contrato ACP.
Fontes
Apresentação baseada nos repositórios públicos disponíveis no momento da pesquisa. A implementação e os passos podem ser conferidos no commit fixado do link.