MolyKit Skill は何をしますか?
MakepadでMolyKit(クロスプラットフォームAIチャットアプリケーション向けツールキット)を使用したAIチャットインターフェース構築のベストプラクティス。
ソースコードベース: /Users/zhangalex/Work/Projects/FW/robius/moly/moly-kit
いつ使用するか
以下の場合にこのスキルを使用します。
- MakepadでAIチャットインターフェースを構築する場合
- OpenAIやその他のLLM APIを統合する場合
- ネイティブおよびWASM向けのクロスプラットフォーム非同期処理を実装する場合
- チャットウィジェット(メッセージ、プロンプト、アバター)を作成する場合
- SSEストリーミング応答を処理する場合
- キーワード: molykit, moly-kit, ai chat, bot client, openai makepad, chat widget, sse streaming
概要
MolyKitが提供するもの:
- クロスプラットフォーム非同期ユーティリティ(
PlatformSend、spawn()、ThreadToken) - すぐに使えるチャットウィジェット(
Chat、Messages、PromptInput、Avatar) - AIプロバイダー統合のための
BotClientトレイト - SSEストリーミング対応のOpenAI互換クライアント
- メッセージ、ボット、ツール呼び出しのためのプロトコル型
- MCP(Model Context Protocol)サポート
クロスプラットフォーム非同期パターン
PlatformSend - ネイティブのみSend
/// ネイティブプラットフォームでのみSendを意味し、WASMでは意味しない
/// - ネイティブ: Sendを実装する型によって実装される
/// - WASM: すべての型によって実装される
pub trait PlatformSend: PlatformSendInner {}
/// クロスプラットフォーム使用のためのボックス化されたfuture型
pub type BoxPlatformSendFuture<'a, T> = Pin<Box<dyn PlatformSendFuture<Output = T> + 'a>>;
/// クロスプラットフォーム使用のためのボックス化されたstream型
pub type BoxPlatformSendStream<'a, T> = Pin<Box<dyn PlatformSendStream<Item = T> + 'a>>;
プラットフォームに依存しないスポーン
/// futureを独立して実行する
/// - ネイティブではtokioを使用(Sendが必要)
/// - WASMではwasm-bindgen-futuresを使用(Send不要)
pub fn spawn(fut: impl PlatformSendFuture<Output = ()> + 'static);
// 使用例
spawn(async move {
let result = fetch_data().await;
Cx::post_action(DataReady(result));
SignalToUI::set_ui_signal();
});
AbortOnDropHandleによるタスクキャンセル
/// ドロップ時にfutureを中断するハンドル
pub struct AbortOnDropHandle(AbortHandle);
// 使用例 - ウィジェットがドロップされるとタスクがキャンセルされる
#[rust]
task_handle: Option<AbortOnDropHandle>,
fn start_task(&mut self) {
let (future, handle) = abort_on_drop(async move {
// 非同期処理...
});
self.task_handle = Some(handle);
spawn(async move { let _ = future.await; });
}
WASM上の非Send型のためのThreadToken
/// スレッドローカルに非Sendな値を保存し、トークンでアクセスする
pub struct ThreadToken<T: 'static>;
impl<T> ThreadToken<T> {
pub fn new(value: T) -> Self;
pub fn peek<R>(&self, f: impl FnOnce(&T) -> R) -> R;
pub fn peek_mut<R>(&self, f: impl FnOnce(&mut T) -> R) -> R;
}
// 使用例 - Send境界を越えて使用するために非Send型をラップする
let token = ThreadToken::new(non_send_value);
spawn(async move {
token.peek(|value| {
// valueを使用...
});
});
BotClientトレイト
AIプロバイダー統合の実装
pub trait BotClient: Send {
/// ストリーミング応答でメッセージを送信
fn send(
&mut self,
bot_id: &BotId,
messages: &[Message],
tools: &[Tool],
) -> BoxPlatformSendStream<'static, ClientResult<MessageContent>>;
/// 利用可能なボット/モデルを取得
fn bots(&self) -> BoxPlatformSendFuture<'static, ClientResult<Vec<Bot>>>;
/// 受け渡し用のクローン
fn clone_box(&self) -> Box<dyn BotClient>;
}
// 使用例
let client = OpenAIClient::new("https://api.openai.com/v1".into());
client.set_key("sk-...")?;
let context = BotContext::from(client);
BotContext - 共有可能なラッパー
/// 同期UIアクセス用に読み込まれたボットを持つ共有可能なラッパー
pub struct BotContext(Arc<Mutex<InnerBotContext>>);
impl BotContext {
pub fn load(&mut self) -> BoxPlatformSendFuture<ClientResult<()>>;
pub fn bots(&self) -> Vec<Bot>;
pub fn get_bot(&self, id: &BotId) -> Option<Bot>;
pub fn client(&self) -> Box<dyn BotClient>;
}
// 使用例
let mut context = BotContext::from(client);
spawn(async move {
if let Err(errors) = context.load().await.into_result() {
// エラー処理
}
Cx::post_action(BotsLoaded);
});
プロトコル型
メッセージ構造
pub struct Message {
pub from: EntityId, // User, System, Bot(BotId), App
pub metadata: MessageMetadata,
pub content: MessageContent,
}
pub struct MessageContent {
pub text: String, // メインコンテンツ(マークダウン)
pub reasoning: String, // AIの推論/思考
pub citations: Vec<String>, // ソースURL
pub attachments: Vec<Attachment>,
pub tool_calls: Vec<ToolCall>,
pub tool_results: Vec<ToolResult>,
}
pub struct MessageMetadata {
pub is_writing: bool, // ストリーミング中
pub created_at: DateTime<Utc>,
}
ボット識別
/// グローバルに一意なボットID: <len>;<id>@<provider>
pub struct BotId(Arc<str>);
impl BotId {
pub fn new(id: &str, provider: &str) -> Self;
pub fn id(&self) -> &str; // プロバイダー内のID
pub fn provider(&self) -> &str; // プロバイダードメイン
}
// 例: BotId::new("gpt-4", "api.openai.com")
// -> "5;[email protected]"
ウィジェットパターン
Slotウィジェット - ランタイムコンテンツ置換
live_design! {
pub Slot = {{Slot}} {
width: Fill, height: Fit,
slot = <View> {} // デフォルトコンテンツ
}
}
// 使用例 - ランタイムにコンテンツを置換
let mut slot = widget.slot(id!(content));
if let Some(custom) = client.content_widget(cx, ...) {
slot.replace(custom);
} else {
slot.restore(); // デフォルトに戻す
slot.default().as_standard_message_content().set_content(cx, &content);
}
Avatarウィジェット - テキスト/画像切替
live_design! {
pub Avatar = {{Avatar}} <View> {
grapheme = <RoundedView> {
visible: false,
label = <Label> { text: "P" }
}
dependency = <RoundedView> {
visible: false,
image = <Image> {}
}
}
}
impl Widget for Avatar {
fn draw_walk(&mut self, cx: &mut Cx2d, ...) -> DrawStep {
if let Some(avatar) = &self.avatar {
match avatar {
Picture::Grapheme(g) => {
self.view(id!(grapheme)).set_visible(cx, true);
self.view(id!(dependency)).set_visible(cx, false);
self.label(id!(label)).set_text(cx, &g);
}
Picture::Dependency(d) => {
self.view(id!(dependency)).set_visible(cx, true);
self.view(id!(grapheme)).set_visible(cx, false);
self.image(id!(image)).load_image_dep_by_path(cx, d.as_str());
}
}
}
self.deref.draw_walk(cx, scope, walk)
}
}
PromptInputウィジェット
#[derive(Live, Widget)]
pub struct PromptInput {
#[deref] deref: CommandTextInput,
#[live] pub send_icon: LiveValue,
#[live] pub stop_icon: LiveValue,
#[rust] pub task: Task, // SendまたはStop
#[rust] pub interactivity: Interactivity,
}
impl PromptInput {
pub fn submitted(&self, actions: &Actions) -> bool;
pub fn reset(&mut self, cx: &mut Cx);
pub fn set_send(&mut self);
pub fn set_stop(&mut self);
pub fn enable(&mut self);
pub fn disable(&mut self);
}
Messagesウィジェット - 会話ビュー
#[derive(Live, Widget)]
pub struct Messages {
#[deref] deref: View,
#[rust] pub messages: Vec<Message>,
#[rust] pub bot_context: Option<BotContext>,
}
impl Messages {
pub fn set_messages(&mut self, messages: Vec<Message>, scroll_to_bottom: bool);
pub fn scroll_to_bottom(&mut self, cx: &mut Cx, triggered_by_stream: bool);
pub fn is_at_bottom(&self) -> bool;
}
非同期からUIへのUiRunnerパターン
impl Widget for PromptInput {
fn handle_event(&mut self, cx: &mut Cx, event: &Event, scope: &mut Scope) {
self.deref.handle_event(cx, event, scope);
self.ui_runner().handle(cx, event, scope, self);
if self.button(id!(attach)).clicked(event.actions()) {
let ui = self.ui_runner();
Attachment::pick_multiple(move |result| match result {
Ok(attachments) => {
ui.defer_with_redraw(move |me, cx, _| {
me.attachment_list_ref().write().attachments.extend(attachments);
});
}
Err(_) => {}
});
}
}
}
SSEストリーミング
/// SSEバイトストリームをメッセージストリームにパースする
pub fn parse_sse<S, B, E>(s: S) -> impl Stream<Item = Result<String, E>>
where
S: Stream<Item = Result<B, E>>,
B: AsRef<[u8]>,
{
// "\n\n"で分割し、"data:"の内容を抽出
// コメントと[DONE]メッセージをフィルタリング
}
// BotClient::sendでの使用例
fn send(&mut self, ...) -> BoxPlatformSendStream<...> {
let stream = stream! {
let response = client.post(url).send().await?;
let events = parse_sse(response.bytes_stream());
for await event in events {
let completion: Completion = serde_json::from_str(&event)?;
content.text.push_str(&completion.delta.content);
yield ClientResult::new_ok(content.clone());
}
};
Box::pin(stream)
}
ベストプラクティス
- クロスプラットフォームにはPlatformSendを使用: 同じコードがネイティブとWASMで動作
- tokio::spawnではなくspawn()を使用: プラットフォームに依存しないタスク起動
- AbortOnDropHandleを使用: ウィジェットドロップ時にタスクをキャンセル
- WASM上の非Send型にはThreadTokenを使用: スレッドローカルストレージとトークンアクセス
- カスタムコンテンツにはSlotを使用: BotClientがカスタムウィジェットを提供可能に
- read()/write()パターンを使用: WidgetRefを介した安全な借用アクセス
- UiRunner::defer_with_redrawを使用: 非同期コンテキストからウィジェットを更新
- ClientResultの部分成功を処理: 値とエラーの両方が存在する可能性あり
参考ファイル
llms.txt- 完全なMolyKit APIリファレンス