feat(miniapp): let MiniApps claim the floating bubble composer

Route chat.claimComposer / setComposerDraft / focusSession through the host bubble so MiniApps can own composer input and display their own agent sessions, with PPT Live as the first consumer.

Author: bobleer

MiniApp/Skills/miniapp-dev/SKILL.md

@@ -193,6 +193,9 @@ MiniApp 框架**只暴露下列能力**，没有任何"通用 BitFun 后端通
 | AI | `app.ai.complete / chat / cancel / getModels` | 复用宿主 AIClient，受 `permissions.ai`（含 `allowed_models` / 速率限制） |
 | 对话框 | `app.dialog.open/save/message` | Tauri dialog 插件 |
 | 剪贴板 | `app.clipboard.readText/writeText` | 宿主 navigator.clipboard |
+| Agent 会话 | `app.agent.run / cancel / turnText / cancelStaleRuns / onEvent` | 受 `permissions.agent.enabled` 限制；启动小应用自己的隐藏 agent 回合，事件只回流到发起的小应用 |
+| 悬浮会话气泡 | `app.chat.claimComposer / releaseComposer / focusSession / setComposerDraft / onUserMessage` | 受 `permissions.agent.enabled` 限制；把右下角悬浮会话气泡认领为小应用的输入框与过程展示（Agentic MiniApp 模式，样板间：`builtin-ppt-live`） |
+| 幻灯片栅格化 | `app.deck.renderPage` | 在隐藏宿主 WebView 中渲染单页 HTML，返回 base64 PNG/PDF（导出用） |
 | 自定义后端 | `app.call('xxx', …)` + `worker.js` | 仅 `node.enabled = true` 时可用，自己实现业务逻辑 |
 | 主题 / i18n | `app.theme` / `app.locale` / `app.onThemeChange` / `app.onLocaleChange` / `app.t(...)` | 见对应章节 |
 
@@ -203,7 +206,7 @@ MiniApp 框架**只暴露下列能力**，没有任何"通用 BitFun 后端通
 - WorkspaceService（结构化工作区索引、统一搜索）
 - GitService（结构化 status / diff / blame，区别于裸 `git` 命令）
 - TerminalService（创建/读写交互式终端）
-- Session / AgenticSystem（启动 Agent 会话、消费工具调用与流式事件）
+- Session / AgenticSystem 的**通用**会话管理（任意会话的创建、接管、读写）——小应用只能通过 `app.agent.*` 启动**自己的**隐藏会话并消费其事件，再通过 `app.chat.*` 借用悬浮会话气泡做输入与过程展示；不能访问其他会话
 - LSP / Snapshot / Mermaid / Skills / Browser API / Computer Use / Config 等
 
 需要这类能力时的合规姿势：
@@ -227,6 +230,8 @@ MiniApp UI 内通过 **window.app** 访问：
 | `app.os.*` | 同上 |
 | `app.storage.*` | 同上 |
 | `app.dialog.open/save/message` | 由 Bridge 转 Tauri dialog 插件 |
+| `app.agent.*` | 隐藏 agent 回合（`permissions.agent.enabled`），事件经 `app.agent.onEvent` 回流 |
+| `app.chat.*` | 悬浮会话气泡集成：`claimComposer({ placeholder })` 认领气泡输入框（当前 tab 为本小应用时，用户输入经 `onUserMessage` 送达）、`focusSession(sessionId)` 让气泡展示本小应用的 agent 会话、`setComposerDraft(text)` 展开气泡并预填输入（不发送，供示例 prompt 使用）|
 | 生命周期 / 事件 | 见 bridge_builder 生成的适配器 |
 
 ## 主题集成

src/crates/contracts/product-domains/src/miniapp/bridge_builder.rs

@@ -5,7 +5,7 @@ use serde_json;
 
 /// Build the Runtime Adapter script (JS) to inject into the iframe.
 /// Exposes window.app with call(), fs.*, shell.*, net.*, os.*, storage.*, dialog.*,
-/// ai.*, agent.*, deck.*, clipboard.*, lifecycle, events.
+/// ai.*, agent.*, deck.*, chat.*, clipboard.*, lifecycle, events.
 pub fn build_bridge_script(
     app_id: &str,
     app_data_dir: &str,
@@ -135,6 +135,24 @@ pub fn build_bridge_script(
       renderPage: (opts) => _rpc('deck.renderPage', opts || {{}}),
     }},
 
+    // Chat namespace — floating session bubble integration for agentic
+    // MiniApps. While this MiniApp's tab is active, `claimComposer` routes the
+    // bubble composer to the MiniApp: user messages arrive via
+    // 'chat:userMessage' instead of being sent to the host chat session, and
+    // `focusSession` shows one of the MiniApp's own agent.run sessions in the
+    // bubble so agent progress renders on the shared chat surface.
+    // Requires manifest permissions.agent.enabled = true; enforced host-side.
+    chat: {{
+      claimComposer:   (opts) => _rpc('chat.claimComposer', opts || {{}}),
+      releaseComposer: () => _rpc('chat.releaseComposer', {{}}),
+      focusSession:    (sessionId) => _rpc('chat.focusSession', {{ sessionId }}),
+      // Opens the bubble and prefills its composer without sending, so the
+      // MiniApp can offer example prompts the user still edits and submits.
+      setComposerDraft: (text) => _rpc('chat.setComposerDraft', {{ text }}),
+      onUserMessage:   (fn) => app.on('chat:userMessage', fn),
+      offUserMessage:  (fn) => app.off('chat:userMessage', fn),
+    }},
+
     // Clipboard namespace — proxies to host navigator.clipboard (bypasses sandbox restriction).
     clipboard: {{
       writeText: (text) => _rpc('clipboard.writeText', {{ text }}),

src/crates/contracts/product-domains/src/miniapp/builtin.rs

@@ -151,7 +151,7 @@ pub const BUILTIN_APPS: &[BuiltinMiniAppBundle] = &[
     },
     BuiltinMiniAppBundle {
         id: "builtin-ppt-live",
-        version: 252,
+        version: 253,
         meta_json: include_str!("builtin/assets/ppt-live/meta.json"),
         html: include_str!("builtin/assets/ppt-live/index.html"),
         css: include_str!("builtin/assets/ppt-live/style.css"),

src/crates/contracts/product-domains/src/miniapp/builtin/assets/ppt-live/README.md

@@ -2,6 +2,43 @@
 
 PPT Live 是 BitFun 的内置 MiniApp，用于 AI 驱动的 PPT 生成、编辑和导出。
 
+## Agentic MiniApp 样板间：复用悬浮会话气泡
+
+PPT Live 同时是 BitFun **Agentic MiniApp** 的样板间：它自己**没有输入框，也没有
+过程显示**——右侧栏只有样式设置和一张引导卡。用户在右下角的悬浮会话气泡里描述
+需求，链路如下：
+
+```
+用户在悬浮气泡输入
+  → FloatingMiniChat 检测到当前 tab 的 MiniApp 持有 composer claim
+  → window CustomEvent 'miniapp-composer-message'
+  → useMiniAppBridge 转成 iframe 事件 'chat:userMessage'
+  → ui.js submitInstruction(text)：包装 ppt-design 协议 prompt，走原有
+    app.agent.run 隐藏会话（首轮建会话，后续编辑复用同一 sessionId）
+  → executeBackendTurn 拿到 sessionId 后调用 app.chat.focusSession(sessionId)
+  → 气泡的 ChatPane 切到该会话——agent 的执行过程直接显示在气泡里
+  → agent 按文件协议写 project.json / slides/*.html，PPT Live 渐进式读文件上屏
+```
+
+涉及的 `app.chat.*` API（`bridge_builder.rs` 生成，宿主端在
+`web-ui/src/app/scenes/miniapps/hooks/useMiniAppBridge.ts`，需要
+`permissions.agent.enabled = true`）：
+
+| API | 作用 |
+|-----|------|
+| `app.chat.claimComposer({ placeholder })` | 认领气泡输入框；本应用 tab 激活时用户输入改送本应用。幂等 upsert，locale 变更时重调可更新占位文案 |
+| `app.chat.onUserMessage(fn)` | 接收气泡输入，payload 为 `{ text }` |
+| `app.chat.focusSession(sessionId)` | 让气泡的会话面板展示本应用自己的 agent 会话（仅限本应用 `agent.run` 启动的会话） |
+| `app.chat.setComposerDraft(text)` | 展开气泡并预填输入框，**不发送**——欢迎页的示例 prompt 用它，用户仍可编辑后再发 |
+| `app.chat.releaseComposer()` | 主动释放；iframe 卸载时宿主自动释放 |
+
+> 认领是按 **runner 实例**（token）而不是 appId 记账的：AI 定制时同一个 appId 会同时挂载
+> 已安装实例和草稿预览实例，若按 appId 路由，一条气泡消息会让两个 iframe 各跑一次 agent。
+
+为什么这是好实践：PPT Live 在用户输入需求后本来就是启动一个 agent 会话去完成
+任务——与其在 MiniApp 里再造一套输入框和过程流水线，不如把输入和过程都交给宿主
+现成的会话表面，MiniApp 只专注于自己的领域视图（画布、样式、导出）。
+
 ## 目录结构
 
 ```

src/crates/contracts/product-domains/src/miniapp/builtin/assets/ppt-live/bundle.json

@@ -1,5 +1,5 @@
 {
   "schemaVersion": 1,
   "id": "builtin-ppt-live",
-  "version": 252
+  "version": 253
 }