01
実装済みの機能
02
はじめ方
- リポジトリを取得し、READMEで基盤構築段階の実装範囲とホスト側の責務を確認します。
- cargo test -p katana-chat-uiで下書きと表示モデルのテストを確認し、自分のUIへChatPanelを接続します。
Rustと必要な開発ツールを準備し、導入前にリンク先のREADMEで環境要件を確認してください。実行例は機能の入口であり、すべての環境での動作を保証するものではありません。
根拠git clone https://github.com/HiroyukiFuruno/katana-chat-ui.git
cd katana-chat-ui
cargo test -p katana-chat-ui01 / KCU
どんな場面で使うか
最小chat stateをframeworkから分離する
最新KCUはChatPanelStateにChatTurn履歴とdraft文字列を保持し、ChatPanelRenderModelへ履歴件数とdraftを出します。ホストはこのモデルを自分のUI frameworkで描画でき、KCU本体にwidget実装を持ち込みません。
ACP接続の前段契約を用意する
同じ公開HEADのkatana-acp-clientにはAiRequest、AiResponse、AiProviderがあり、intent、document context、prompt、historyをprovider境界へ渡せます。KCUがprovider接続を完結させるのではなく、hostやconnectorがこの契約を実装する構成です。
02 / KCU
入力から出力までの流れ
hostがstateを所有する
ホストはChatPanelStateを生成し、historyとdraftのライフサイクルを保持します。ChatPanel::newはそのstateをmutableに借用するだけで、アプリ全体のworkspaceやdocument stateを所有しません。
入力をrender modelへ変換する
UI入力はChatPanel::draft_mut()でdraftへ書き込まれ、render_model()がhistory_lenとdraftを含むChatPanelRenderModelを生成します。最新実装には旧版の添付・message output・streaming UI処理はありません。
provider境界をhostが接続する
ACPを使うhostはAiRequestへAiIntent、DocumentContext、prompt、ChatTurn historyを詰め、AiProvider::execute()を呼ぶ設計です。戻ったAiResponseをhistoryや表示へ反映する責任はhost/connector側にあり、KCU本体の実装済み処理ではありません。
03 / KCU
主要API・CLIの使い分け
ChatPanelState- history: Vec<ChatTurn>とdraft: Stringだけを持つ最新のchat stateです。入力や履歴の永続化、providerの実行管理までは含みません。
ChatPanel- newでstateを借用し、draft_mutで入力を更新し、render_modelで表示用snapshotを作ります。UI frameworkの型を持たない薄いfacadeです。
ChatPanelRenderModel- history_lenとdraftを持つ不変の表示モデルです。ホストはこれを任意のUIへ描画できますが、messageの詳細やoutput actionは最新KCUの型として公開されていません。
AiRequestとAiProvider- AiRequestはintent、DocumentContext、prompt、historyを表し、AiProviderはavailable、capabilities、models、executeを定義します。ACP transport自体はscaffoldingで、実provider接続の完成を意味しません。
04 / KCU
具体例で理解する
draftからrender modelを作る
ChatPanelStateをdefaultで作り、ChatPanel::newへ渡します。draft_mut()へ入力を追加してrender_model()を呼び、history_lenとdraftを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
組み込み条件と責務の境界
host UIとproviderを別々に実装する
READMEはkatana-chat-uiをframework-neutral state/render model、Floemをplanned reference UI、connectorをplanned boundaryとしています。導入側は自分のUIでChatPanelRenderModelを描画し、別途ACPまたはdirect providerを接続します。
scaffoldingを前提に範囲を固定する
最新READMEのStatusはScaffoldingです。workspace shell、document state、UI adapter、diagram rendering、document exportは非対象なので、現時点では最小draft表示とACP契約の検討用ライブラリとして扱います。
根拠
調査時点の公開リポジトリに基づく紹介です。リンク先の固定コミットで実装と手順を確認できます。