@blade-hq/agent-client 2610.0.0-beta.5 → 2610.0.0-beta.51

package/README.md

@@ -2,16 +2,21 @@
 
 Blade Agent 的框架无关客户端。浏览器和 Node.js 都能用；用 Vue、Svelte 或自建 UI 的团队直接用这个包，React 团队一般用上层的 `@blade-hq/agent-react`。
 
-它做三件事：
+它做四件事：
 
 1. **实时会话**（`AgentSession`）：把 Socket.IO 协议、历史加载、流式合流、断线重连全部封装掉，你只面对"状态快照 + 动作 + 事件"。
 2. **登录**：`client.auth.login()` 弹窗授权，用户点一下"许可授权"就拿到访问令牌，不用手工复制粘贴。
 3. **REST**：类型化会话和模型目录（`client.sessions.*`、`client.models.list()`）。其他长尾接口对照 Swagger 用原生 `fetch` + `client.token` 调用。
+4. **部署端点**：从同源 `config.json` 读取其他 Blade 服务的公开地址，不根据主机名和固定端口猜测拓扑。
 
 ```bash
 npm install @blade-hq/agent-client
 ```
 
+默认装到的是当前长期支持版（LTS），厂内离线交付按它开发。要跟两周一发的公网版本，改用 `@next`。
+
+最稳妥的做法是先读目标 Server 的 `GET /api/version`，按返回的版本号在 `package.json` 里钉死——NPM 的 `latest` 不一定和目标环境跑的版本一致。
+
 ## 快速开始
 
 ```html
@@ -47,6 +52,27 @@ const client = new BladeClient({
 })
 ```
 
+## 部署端点
+
+Blade 平台前端需要跳转其他服务时，读取当前 origin 的公开配置：
+
+```ts
+import { loadPlatformEndpoints, resolveServiceUrl } from "@blade-hq/agent-client"
+
+const endpoints = await loadPlatformEndpoints()
+const hubUrl = resolveServiceUrl(endpoints, "hub", "/skills/42")
+if (hubUrl) window.open(hubUrl)
+```
+
+`loadPlatformEndpoints()` 请求 `config.json`，超过 3 秒、网络失败或配置非法时返回空配置；
+调用方应隐藏对应入口。文件只能放浏览器可访问的公开地址，不能写 Docker 服务名、令牌或
+其他内部配置。应用部署在子路径时，通过 `baseUrl` 显式传入部署根路径。
+`resolveServiceUrl()` 的 `path` 只接受服务内相对路径；绝对 URL、反斜杠和越出服务
+base path 的路径返回 `null`。
+
+公开类型为 `PlatformEndpoints`、`PlatformServiceName`、`LoadPlatformEndpointsOptions`；
+需要同步初始化时可直接使用 `EMPTY_PLATFORM_ENDPOINTS`。
+
 ## BladeClient
 
 ### 构造
@@ -56,10 +82,12 @@ new BladeClient({
   baseUrl: "https://blade.example.com", // 后端地址；同域部署可传 ""
   token: "sk-blade-xxx",                // 可选：PAT。不传则用 cookie 或 login()
   tokenStorage: "local",                // 可选：login() 的令牌存哪（"local" 默认 / "memory"）
-  streamTokens: false,                   // 可选：只接收完成态内容，不订阅逐 token 增量
 })
 ```
 
+SDK 会固定订阅普通聊天所需的完整实时事件。产品内置 Web 的精简/开发者展示模式不属于
+公共 SDK 契约，也没有对应的构造参数或 Socket.IO 字段。
+
 > **`baseUrl` 填哪个地址？** 必须是 Blade Agent 后端的地址（形如 `http://<主机>:8020`），只要域名和端口、不带路径。
 > 注意别填成你平时打开的 Blade OS 地址（同主机的 `:80`）—— 那是另一套接口，SDK 连不上。
 
@@ -139,8 +167,48 @@ await client.sessions.getSession(id)                  // 会话详情
 await client.sessions.updateSession(id, { intent: "新标题" })
 await client.sessions.deleteSession(id)
 await client.sessions.getSessionTurns(id)             // 历史消息（投影格式，与实时流同构）
+const page = await client.sessions.getSessionTurnsPage(id) // 聊天首屏 recent page
+await client.sessions.getSessionTurnsPage(id, { before: page.nextBefore! })
 ```
 
+会话插件可通过 `client.sessions.listSessionPlugins(id)` 查询，并用
+`client.sessions.setSessionPluginActivation(id, name, active)` 切换当前会话。列表项为 `SessionPlugin`；修改结果为 `SessionPluginActivation`，只返回选择和准备状态，安装事实需从列表获取。
+
+插件可以在包内 `cn.com.bladeai.agent/config.schema.json` 用标准 JSON Schema
+（Draft 2020-12）声明账号、token 或任意业务配置。声明了配置的插件用
+`client.sessions.getSessionPluginConfig(id, name)` 读取声明与当前值，用
+`client.sessions.updateSessionPluginConfig(id, name, { expected_revision, set, remove })`
+保存；两者都要等到插件包已准备（即已激活过）才有内容，没有声明的插件返回
+`state: "not_required"`。
+
+```ts
+const { config } = await client.sessions.getSessionPluginConfig(id, "crm")
+// config: SessionPluginConfigState
+//   state       "not_required" | "required" | "configured" | "error"
+//   schema      包内声明的 JSON Schema（Draft 2020-12）
+//   values      已存值，writeOnly 字段已被平台剔除
+//   write_only  当前有值的秘密字段 JSON Pointer
+//   revision    乐观并发用的版本号
+//   errors      SessionPluginConfigError[]，逐条 { path, message }，不含用户输入
+// 列表项 SessionPlugin.config 是 SessionPluginConfigSummary
+// （SessionPluginConfigStateName 之外多一个 "unchecked"：列表只报本地已知事实，
+// 不伪报已配置）
+
+await client.sessions.updateSessionPluginConfig(id, "crm", {
+  expected_revision: config.revision,
+  set: [{ path: "/login/password", value: password }], // SessionPluginConfigSet[]
+  remove: [],
+} satisfies SessionPluginConfigUpdate)
+```
+
+图标用 `client.sessions.fetchSessionPluginIcon(id, name)` 取 `Blob`（自带凭据），
+或 `client.sessions.sessionPluginIconUrl(id, name)` 取已鉴权 URL。
+
+`set`/`remove` 只表达显式改动：没出现的字段保持原值，因此表单不需要回传秘密；
+`null` 是一个合法值，不是删除。校验不通过或版本过期时请求被拒绝，磁盘上的旧
+配置保持不变。平台只写用户 Home 下的 `~/.plugin/<plugin_id>/config.json`，不会
+重启 MCP、清缓存或刷新 token。
+
 ### 会话回放（演示 / 彩排）
 
 拿一个已经聊完的会话当素材，重现当时的回复和工具调用，**完全不调用模型**。
@@ -261,6 +329,57 @@ const body = { model: defaultServiceModel, messages, stream: true }
 没问题，直接交给浏览器就指向用户自己的机器了。默认形态是后端透传（密钥本来也不该进浏览器），
 浏览器直连只适合这个地址对浏览器同样可达的场景。
 
+### 远程电脑：client.computers
+
+一个会话除了自己的运行时，还可以操作用户接入的其他电脑（`blade daemon connect` 接进来的机器）。
+**默认一台都不能用**，要先为这次会话启动它。
+
+```ts
+const { computers } = await client.computers.list(sessionId)
+// SessionComputerList → { computers: SessionComputer[] }
+// SessionComputer: { id, label, os, arch, home, workspace, allowed_paths,
+//                    online, enabled, is_primary, last_seen_at, ... }
+
+await client.computers.setEnabled(sessionId, computer.id, true)   // 启动
+await client.computers.setEnabled(sessionId, computer.id, false)  // 停用
+```
+
+`online` 和 `enabled` 是**两件独立的事**：前者指那台电脑此刻连着后端，后者指这次会话已经启动了它。
+离线的电脑也能先启动，等它连上就直接可用。`online` 由服务端读心跳时间判定，不做实时探测，
+所以电脑离线时列表照样返回它——你拿得到「它离线了」这个结论。
+
+`is_primary` 表示这次会话本身就跑在这台电脑上。这种电脑恒为可用，也不能停用——
+那是会话自己的工作目录所在。
+
+做电脑选择器时用这几个纯函数，别自己重算状态：
+
+```ts
+import {
+  canToggleComputer, computerState, sortComputers,
+  computerOS, computerPlatformLabel, computerDaemonVersion,
+} from "@blade-hq/agent-client"
+
+sortComputers(computers)         // 按接入时间，顺序稳定不随状态变化
+computerState(computer)          // ComputerState: "primary" | "enabled" | "offline" | "idle"
+canToggleComputer(computer)      // 主运行时返回 false
+
+computerOS(computer)             // ComputerOS: "macos" | "windows" | "linux" | "unknown"
+computerPlatformLabel(computer)  // "darwin/arm64"
+computerDaemonVersion(computer)  // "dev (bc3ad71d1)"，未知时是空串
+```
+
+`sortComputers` **刻意不按在线/可用排序**：那样排看着"手边的在前面"，代价是电脑
+上下线、勾选状态一变整个列表就重排，用户正要点的那一项会在手指底下跑掉。改名也
+不会挪位置，新接入的稳定排在末尾。
+
+`computerOS` 判定的是 daemon 上报的 `runtime.GOOS`，各处自己 `startsWith` 一遍必然会分叉；
+图标怎么画交给界面，这里只回答"是哪一类系统"。
+
+`computerDaemonVersion` 返回的是服务端存的完整串——dev 构建带 commit，
+因为 dev 的版本号全都是 `dev`，光看它分不出是哪次构建的二进制。**不要在前端另拼一套格式。**
+
+`ComputersResource` 是 `client.computers` 的类型。
+
 ## AgentSession
 
 一个会话的实时状态机。**状态归属实例**：同一页面建多个会话互不干扰。
@@ -279,6 +398,7 @@ chat.getState()
 //   errorMessage,    最近一次运行错误
 //   replay,          回放状态：{ isReplay, speed, sourceSessionId } | null
 //   viewerRole,      "owner" | "viewer" | null（只读身份改不动会话）
+//   nextBefore, loadingOlder,  历史分页游标与加载状态
 //   turns, askAnswers, agentLoops, activeCompaction   进阶字段
 // }
 
@@ -295,6 +415,7 @@ await chat.send("换个方案", { mode: "planning" }) // 指定模式/模型等
 chat.append("补充：预算不超过 5 万")              // 智能体运行中追加说明
 await chat.stop()                                // 停止当前回复
 await chat.compact()                             // 手动压缩上下文
+if (chat.hasOlderHistory) await chat.loadOlderHistory()
 chat.dispose()                                   // 彻底释放（什么时候该调见下方说明）
 ```
 
@@ -369,7 +490,9 @@ chat.on("chatEnd",    (e) => console.log("回复结束", e.status))
 chat.on("error",      (e) => console.error(e.message))
 ```
 
-完整事件表见 `AgentSessionEvents` 类型定义（含 `modeChange` / `workspaceChanged` / `artifact` / `notification` / `backgroundTask` / `taskListUpdated` / `rewind` / `replayMismatch` 等）。`on()` 返回取消函数；handler 抛异常只告警，不影响会话。
+完整事件表见 `AgentSessionEvents` 类型定义（含 `modeChange` / `workspaceChanged` / `artifact` / `notification` / `backgroundTask` / `taskListUpdated` / `rewind` / `replayMismatch` 等）。`toolResult.source` 区分实时结果、首次连接回放和断线重连回放；`on()` 返回取消函数，handler 抛异常只告警、不影响会话。
+
+分页响应是 `SessionTurnsPage`，其中 `nextBefore: string | null` 是唯一的“还有更早历史”真值。历史页面指令通过独立的 `HistoricalCommand` 日志恢复，不混进展示页。自定义状态容器可复用 `prependOlder`、`replaceWindow` 与 `LiveRevisionState`，但一般直接使用 `AgentSession` 即可。
 
 ## iframe 嵌入形态：connectEmbedded
 
@@ -414,6 +537,15 @@ PATCH / query / FormData / AbortSignal 等完整 HTTP 语义（否则不够用
 > **安全约束**：`client.token` 只应发往 `baseUrl` 同源的接口。不要把它附加到
 > 第三方域名的请求上——那等于把用户的访问凭据交给别人。
 
+### 只读轮询退避
+
+`new PollingBackoff(3000)` 为轮询维护独立退避状态，参数为正常间隔（大于 0、不超过 60 秒）。
+请求成功后调用 `reset()`，失败后调用 `failed(error)`；`waitMs()` 返回剩余等待毫秒数，
+`0` 表示可以请求，`false` 表示停止。HTTP 错误应传入保留响应头的 `BladeApiError`。
+401/403 等确定性错误停止，网络/5xx 指数退避带抖动且最高 60 秒；`Retry-After`
+可以要求更长等待，超出浏览器定时器范围时停止。策略自身不发送请求，调度器须传递
+AbortSignal、在卸载时停止，并避免将它用于自动重放 POST 等有副作用的操作。
+
 ## headless：一次性问答
 
 ```ts
@@ -456,6 +588,9 @@ groupMessagesByLoop(messages)          // 按主/子智能体分组（智能体
 contentPreview(message.content, 80)    // 截断预览
 ```
 
+错误消息在普通聊天界面展示前用 `chatErrorForDisplay(message)` 转成稳定的业务文案，
+避免把内部路径或传输诊断暴露给用户；仅开发者界面显式传入第二个参数 `true` 保留原文。
+
 一个完整的渲染示例：
 
 ```tsx
@@ -496,6 +631,38 @@ transformSlashCommand(skillId, prompt, { local: false, installed: false })
 
 不传第三个参数时按本地已有处理，和不带这个参数的老用法结果一致。
 
+### MCP App 卡片
+
+MCP 工具可以通过 `_meta.ui` 在消息流里产出交互卡片（`tool_ui` block）。卡片的
+实例、守卫、可见性、身份和终态规则全部收敛在这一份共享判定里——内置 Web 与
+SDK 渲染的是同一批卡片，不要自己再写一份判断：
+
+```ts
+import {
+  collectInlineToolUiCards,
+  collectPreviewToolUiCards,
+  resolveToolUiCardContent,
+  buildToolUiCardKey,
+  isToolUiCard,
+} from "@blade-hq/agent-client"
+
+// 按可见性分类：inline 进消息流，preview 交给你的侧栏/面板（也随 toolPreview 事件推送）
+const inlineCards = collectInlineToolUiCards(messages)   // [{ key, toolCallId, card }]
+const previewCards = collectPreviewToolUiCards(messages) // [{ key, toolCall, card, blocks }]
+
+// 渲染前解析实际内容；archived 留档卡片只用留档 HTML，绝不回退 resourceUri
+// （历史恢复/刷新不会因此重放一次 MCP 资源读取）
+const resolved = resolveToolUiCardContent(card) // { type: "resource-html" | "resource-uri", content } | null
+
+// 实例去重键：uri 卡片按内容、html 卡片按 toolCallId，与 toolPreview 事件、内置侧栏一致
+const key = buildToolUiCardKey(toolCallId, resolved.type, resolved.content)
+```
+
+单个 block 判有效用 `isToolUiCard`（严格守卫：`target`/`height` 缺失、archived 无留档
+HTML 一律判无效）；`isInternalStatusToolUiCard` 识别内部「阶段进度」卡片（不对用户展示），
+`isAppDevToolUiCard` 识别应用开发会话的预览卡。相关类型：`ToolUiCard`、
+`ToolUiCardContentType`、`InlineToolUiCardEntry`、`PreviewToolUiCardEntry`。
+
 ## 常见问题
 
 | 现象 | 原因与解法 |
@@ -516,11 +683,18 @@ transformSlashCommand(skillId, prompt, { local: false, installed: false })
 - **SDK 身份**：`SDK_NAME`、`SDK_VERSION`
 - **声明式会话**：`SessionDefinition`、`SolutionDefinition`、`SkillDefinition`、`SessionConfig`、`TextFile`、`SessionSetupError`、`SessionSetupStage`
 - **模型目录**：`ModelsResource`、`ModelCatalog`、`ModelOption`
+- **聊天项目资源（REST）**：`ChatProjectsResource`、`ChatProject`（含 `delete` 永久删除）
 - **会话资源（REST）**：`SessionsResource`、`CreateSessionRequest`、`ImportSessionOptions`、`AppCliDefinition`、`AppCliAttachment`、`AttachAppOptions`、`PaginatedSessionsResult`、`GlobalSearchResult`、`GlobalSearchResultItem`、`GlobalSearchConversationResult`、`GlobalSearchFileResult`、`SessionHistory`、`SessionContextStats`、`ResultFeedback`、`ResultFeedbackReason`、`ShareLinkResult`、`FileEntry`、`UploadFileEntry`、`UploadFilesOptions`、`SessionProfile`、`SessionDetail`、`SessionInfo`、`SessionStatus`、`SessionPortMapping`、`ModeId`、`TemplateId`、`PrimarySkillSnapshot`、`PrimarySkillParallelMode`
 - **会话回放**：`ReplayState`、`ReplaySpeed`、`ReplayPreview`、`ReplaySnapshot`、`toReplaySnapshot`、`DEFAULT_REPLAY_SPEED`
-- **会话状态机**：`SessionHub`、`SessionState`、`SendOptions`、`ConnectionStatus`、`AskUserAnswerData`、`AgentLoopInfo`、`ActiveCompactionState`、`createInitialSessionState`、`AgentSessionEventName`
+- **会话状态机**：`SessionHub`、`SessionConnectOptions`、`SessionState`、`SendOptions`、`ConnectionStatus`、`AskUserAnswerData`、`AgentLoopInfo`、`ActiveCompactionState`、`createInitialSessionState`、`AgentSessionEventName`
 - **页面协作**：`EmbeddedChat`、`EmbeddedChatOptions`、`CommandHandler`、`CommandEnvelope`、`InboundAction`、`InboundEnvelope`、`isCommandEnvelope`、`isInboundEnvelope`
-- **消息与投影协议**：`MessageContent`、`MessageContentPart`、`TextContentPart`、`ImageUrlContentPart`、`FileContentPart`、`ToolCallInfo`、`ToolBridgeContent`、`CompactionInfo`、`MemoryRefInfo`、`ArchivedFileInfo`、`ArchivedToolCallInfo`、`TurnProjection`、`ContentBlock`、`PatchEnvelope`、`MemoryRef`、`PostChatFollowup`、`FinalArtifact`、`latestPostChatFollowup`、`buildMessageContent`、`normalizeMessageContent`、`isHiddenInternalMessage`、`transformSlashCommand`、`SkillMentionAvailability`、`extractTextAttachments`、`ParsedTextAttachment`、`ParsedTextContext`
+- **消息与投影协议**：`MessageContent`、`MessageContentPart`、`TextContentPart`、`ImageUrlContentPart`、`FileContentPart`、`ToolCallInfo`、`ToolBridgeContent`、`CompactionInfo`、`ContextProjectionData`、`ContextProjectionFields`、`ContextDisplayState`、`ContextGroupDisplayState`、`ContextAction`、`ContextSourceInfo`、`MemoryRefInfo`、`ArchivedFileInfo`、`ArchivedToolCallInfo`、`TurnProjection`、`ContentBlock`、`PatchEnvelope`、`MemoryRef`、`PostChatFollowup`、`FinalArtifact`、`contextProjectionData`、`getContextDisplayState`、`getContextGroupDisplayState`、`groupAdjacentContextRuns`、`latestPostChatFollowup`、`buildMessageContent`、`normalizeMessageContent`、`isHiddenInternalMessage`、`transformSlashCommand`、`SkillMentionAvailability`、`extractTextAttachments`、`ParsedTextAttachment`、`ParsedTextContext`
+- **MCP Apps 留档与卡片判定**：`McpAppData`、`isMcpAppData`、`McpAppContextState`、`McpAppContextUpdate`、`ToolUiCard`、`ToolUiCardContentType`、`InlineToolUiCardEntry`、`PreviewToolUiCardEntry`、`isToolUiCard`、`resolveToolUiCardContent`、`buildToolUiCardKey`、`isInternalStatusToolUiCard`、`isAppDevToolUiCard`、`collectInlineToolUiCards`、`collectPreviewToolUiCards`（`McpAppContextState` / `McpAppContextUpdate` 配合 `sessions.getMcpAppContext` / `sessions.updateMcpAppContext`：App 保存的状态在下一个新运行才进入模型上下文）
 - **Solution / 任务协议**：`Solution`、`SolutionAppField`、`SolutionAppState`、`SolutionAppUiConfig`、`SolutionRef`、`PublishedSolutionRef`、`ExistingSolutionRef`、`PreparedSolution`、`PreparedSolutionAsset`、`LayoutType`、`BizRole`、`TaskStatus`、`BackgroundTask`、`BackgroundTaskStopResult`
 - **Headless**：`HeadlessResource`、`RunOptions`、`RunResult`、`RunTrace`
-- **低层通道（apps/web 等高级集成）**：`createSocket`、`CreateSocketOptions`、`TypedSocket`、`AsrAudioPayload`、`ClientProjectionBuilder`、`RawEvent`、`acceptedPostChatFollowupCompletesLatestRun`
+- **低层通道（apps/web 等高级集成）**：`createSocket`、`CreateSocketOptions`、`TypedSocket`、`AsrAudioPayload`、`AuthBusyReconnect`、`authBusyRetryDelayMs`、`ClientProjectionBuilder`、`RawEvent`、`acknowledgeTurnEvents`、`hasChatRunEvent`、`acceptedPostChatFollowupCompletesLatestRun`、`reconcileOptimisticUserTurns`、`reconcileHistoricalUserTurns`
+### MCP App 留档
+
+`McpAppArchive` 是 `client.sessions.getMcpApp(sessionId, sourceId)` 经鉴权返回的归档，包含保存的 HTML 与最新留档输入/结果。`callMcpApp` 在会话 sandbox 内调用该卡片的归档能力；`onMcpAppChanged` 订阅结果变化，返回取消订阅函数。
+
+最新调用失败或完成状态未知时，归档同时提供 `previousToolInput` / `previousToolResult`，用于先恢复最后成功的界面再展示错误。读取这些留档不会重新执行工具。

package/dist/auth.d.ts

@@ -1,7 +1,6 @@
 export interface AuthOptions {
     token?: string | (() => string | null | undefined);
 }
-export declare function buildAuthHeaders(options: AuthOptions): Record<string, string>;
 export declare function buildSocketAuth(options: AuthOptions): {
     token: string;
 } | undefined;

package/dist/blade-client.d.ts

@@ -2,8 +2,10 @@ import { type LoginOptions, type LoginResult, type TokenStorageMode } from "./au
 import { type BladeFetchInit, type HttpMethod } from "./rest";
 import { AuthResource } from "./resources/auth";
 import { HeadlessResource } from "./resources/headless";
+import { ComputersResource } from "./resources/computers";
 import { ModelsResource } from "./resources/models";
 import { SessionsResource } from "./resources/sessions";
+import { ChatProjectsResource } from "./resources/chat-projects";
 import { SessionHub } from "./session/hub";
 import { type TypedSocket } from "./socket";
 export interface BladeClientOptions {
@@ -23,8 +25,6 @@ export interface BladeClientOptions {
     tokenStorage?: TokenStorageMode;
     fetchImpl?: typeof fetch;
     onRefreshSuccess?: () => void | Promise<void>;
-    /** 是否订阅逐 token 增量，默认 true。关闭后仍接收完整消息和语义事件。 */
-    streamTokens?: boolean;
 }
 export declare class BladeClient {
     private refreshPromise;
@@ -35,8 +35,10 @@ export declare class BladeClient {
     readonly options: BladeClientOptions;
     readonly auth: AuthResource;
     readonly headless: HeadlessResource;
+    readonly computers: ComputersResource;
     readonly models: ModelsResource;
     readonly sessions: SessionsResource;
+    readonly chatProjects: ChatProjectsResource;
     /** 实时会话中枢：client.sessions.connect() 内部使用，一般不直接访问。 */
     readonly hub: SessionHub;
     constructor(options: BladeClientOptions);

package/dist/index.d.ts

@@ -1,15 +1,21 @@
 export { BladeClient } from "./blade-client";
 export type { BladeClientOptions, UploadProgress } from "./blade-client";
 export { BladeApiError } from "./rest";
+export { PollingBackoff } from "./polling-backoff";
 export type { LoginOptions, LoginResult, TokenStorageMode } from "./auth-login";
+export { EMPTY_PLATFORM_ENDPOINTS, loadPlatformEndpoints, resolveServiceUrl, } from "./platform-endpoints";
+export type { LoadPlatformEndpointsOptions, PlatformEndpoints, PlatformServiceName, } from "./platform-endpoints";
 export { SDK_NAME, SDK_VERSION } from "./version";
 export { AgentSession } from "./session/agent-session";
 export type { AttachAppOptions, SendOptions } from "./session/agent-session";
 export { SessionHub } from "./session/hub";
+export type { SessionConnectOptions } from "./session/hub";
 export type { AgentSessionEvents, AgentSessionEventName } from "./session/events";
+export { isMcpAppData } from "./schemas/mcp-app";
+export type { McpAppArchive, McpAppContextState, McpAppContextUpdate, McpAppData, } from "./schemas/mcp-app";
 export { SessionSetupError } from "./session/definition";
 export type { SessionConfig, SessionDefinition, SessionSetupStage, SkillDefinition, TextFile, SolutionDefinition, } from "./session/definition";
-export { createInitialSessionState, toReplaySnapshot } from "./session/state";
+export { createInitialSessionState, reconcileHistoricalUserTurns, reconcileOptimisticUserTurns, toReplaySnapshot, } from "./session/state";
 export type { AskUserAnswerData, AgentLoopInfo, ActiveCompactionState, ConnectionStatus, ReplaySnapshot, SessionState, } from "./session/state";
 export { connectEmbedded } from "./commands/embedded";
 export type { EmbeddedChat, EmbeddedChatOptions } from "./commands/embedded";
@@ -18,15 +24,29 @@ export type { CommandEnvelope, InboundAction, InboundEnvelope } from "./commands
 export { isCommandEnvelope, isInboundEnvelope } from "./commands/protocol";
 export type { AuthResource, ExchangeCodeParams, ExchangeCodeResult, ProvidersResponse, UserInfo, } from "./resources/auth";
 export type { HeadlessResource } from "./resources/headless";
+export { ComputersResource } from "./resources/computers";
+export { canToggleComputer, computerDaemonVersion, computerOS, computerPlatformLabel, computerState, sortComputers, } from "./resources/computers";
+export type { ComputerOS, ComputerState, SessionComputer, SessionComputerList, } from "./resources/computers";
 export { ModelsResource } from "./resources/models";
 export type { ModelCatalog, ModelOption } from "./resources/models";
 export type { SessionsResource } from "./resources/sessions";
-export type { CreateSessionRequest, AppCliAttachment, AppCliDefinition, FileEntry, ImportSessionOptions, PaginatedSessionsResult, GlobalSearchConversationResult, GlobalSearchFileResult, GlobalSearchResult, GlobalSearchResultItem, ResultFeedback, ResultFeedbackReason, SessionContextStats, SessionHistory, ShareLinkResult, UploadFileEntry, UploadFilesOptions, } from "./resources/sessions";
+export type { SessionPlugin, SessionPluginActivation } from "./resources/sessions";
+export type { SessionPluginConfigError, SessionPluginConfigSet, SessionPluginConfigState, SessionPluginConfigStateName, SessionPluginConfigSummary, SessionPluginConfigUpdate, } from "./resources/sessions";
+export { ChatProjectsResource } from "./resources/chat-projects";
+export type { ChatProject } from "./resources/chat-projects";
+export { hasChatRunEvent } from "./shared/projection";
+export type { CreateSessionRequest, AppCliAttachment, AppCliDefinition, FileEntry, ImportSessionOptions, PaginatedSessionsResult, GlobalSearchConversationResult, GlobalSearchFileResult, GlobalSearchResult, GlobalSearchResultItem, ResultFeedback, ResultFeedbackReason, HistoricalCommand, SessionContextStats, SessionHistory, SessionTurnsPage, ShareLinkResult, UploadFileEntry, UploadFilesOptions, } from "./resources/sessions";
 export type { ArchivedFileInfo, ArchivedToolCallInfo, ChatMessage, CompactionInfo, FileContentPart, ImageUrlContentPart, MemoryRefInfo, MessageContent, MessageContentPart, TextContentPart, ToolBridgeContent, ToolCallInfo, } from "./schemas/message";
-export { buildMessageContent, contentPreview, extractTextAttachments, getFileParts, getImageParts, getTextContent, groupMessagesByLoop, isHiddenInternalMessage, normalizeMessageContent, transformSlashCommand, } from "./schemas/message-utils";
+export { buildMessageContent, chatErrorForDisplay, contentPreview, extractTextAttachments, getFileParts, getImageParts, getTextContent, groupMessagesByLoop, isHiddenInternalMessage, normalizeMessageContent, transformSlashCommand, } from "./schemas/message-utils";
+export { contextProjectionData, getContextDisplayState, getContextGroupDisplayState, groupAdjacentContextRuns, } from "./schemas/context";
+export type { ContextAction, ContextDisplayState, ContextGroupDisplayState, ContextProjectionData, ContextProjectionFields, ContextSourceInfo, } from "./schemas/context";
 export type { ParsedTextAttachment, ParsedTextContext, SkillMentionAvailability, } from "./schemas/message-utils";
 export type { ContentBlock, FinalArtifact, MemoryRef, PatchEnvelope, PostChatFollowup, TurnProjection, } from "./schemas/projection";
 export { latestPostChatFollowup } from "./schemas/projection-utils";
+export { buildToolUiCardKey, collectInlineToolUiCards, collectPreviewToolUiCards, isAppDevToolUiCard, isInternalStatusToolUiCard, isToolUiCard, resolveToolUiCardContent, } from "./shared/tool-ui-card";
+export type { InlineToolUiCardEntry, PreviewToolUiCardEntry, ToolUiCard, ToolUiCardContentType, } from "./shared/tool-ui-card";
+export { prependOlder, replaceWindow } from "./session/history-page";
+export type { LiveRevisionState } from "./session/history-page";
 export { DEFAULT_REPLAY_SPEED } from "./schemas/session";
 export { SessionInfo, SessionStatus } from "./schemas/session";
 export type { ModeId, PrimarySkillParallelMode, PrimarySkillSnapshot, ReplayPreview, ReplaySpeed, ReplayState, SessionDetail, SessionPortMapping, PublishedSolutionRef, TemplateId, } from "./schemas/session";
@@ -34,8 +54,9 @@ export { LayoutType } from "./schemas/solution";
 export type { BizRole, Solution, SolutionAppField, SolutionAppState, SolutionAppUiConfig, } from "./schemas/solution";
 export { Task, TaskStatus } from "./schemas/task";
 export type { BackgroundTask, BackgroundTaskStopResult } from "./schemas/background";
-export { acceptedPostChatFollowupCompletesLatestRun, ClientProjectionBuilder } from "./shared/projection";
+export { acceptedPostChatFollowupCompletesLatestRun, acknowledgeTurnEvents, ClientProjectionBuilder, } from "./shared/projection";
 export type { RawEvent } from "./shared/projection";
+export { AuthBusyReconnect, authBusyRetryDelayMs } from "./shared/auth-busy";
 export { createSocket } from "./socket";
 export type { CreateSocketOptions, TypedSocket } from "./socket";
 export type { AsrAudioPayload } from "./types/socket-events";