基盤・ツール

KatanA Chat UI

会話履歴と入力下書きを保持し、表示モデルへ変換する小さなRustライブラリです。公開版は基盤構築段階で、UIやAI接続はホスト側で組み合わせます。

KatanA系アプリへチャットUIを組み込む開発担当者

01

実装済みの機能

ChatPanelStateで会話履歴と入力下書きを保持

根拠

ChatPanelから下書きを更新し表示モデルを生成

根拠

履歴件数と下書きを持つフレームワーク中立の表示契約

根拠

02

はじめ方

  1. リポジトリを取得し、READMEで基盤構築段階の実装範囲とホスト側の責務を確認します。
  2. cargo test -p katana-chat-uiで下書きと表示モデルのテストを確認し、自分のUIへChatPanelを接続します。

Rustと必要な開発ツールを準備し、導入前にリンク先のREADMEで環境要件を確認してください。実行例は機能の入口であり、すべての環境での動作を保証するものではありません。

根拠
sh
git clone https://github.com/HiroyukiFuruno/katana-chat-ui.git
cd katana-chat-ui
cargo test -p katana-chat-ui

01 / 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

入力から出力までの流れ

  1. hostがstateを所有する

    ホストはChatPanelStateを生成し、historyとdraftのライフサイクルを保持します。ChatPanel::newはそのstateをmutableに借用するだけで、アプリ全体のworkspaceやdocument stateを所有しません。

  2. 入力をrender modelへ変換する

    UI入力はChatPanel::draft_mut()でdraftへ書き込まれ、render_model()がhistory_lenとdraftを含むChatPanelRenderModelを生成します。最新実装には旧版の添付・message output・streaming UI処理はありません。

  3. 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の表示へ渡します。

rust
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契約の検討用ライブラリとして扱います。

根拠

調査時点の公開リポジトリに基づく紹介です。リンク先の固定コミットで実装と手順を確認できます。

リポジトリREADME420c1052699e
根拠 · KCU
すべての製品