@blade-hq/agent-client 2610.0.0-rc.0 → 2610.0.0

package/dist/shared/tool-ui-card.d.ts

@@ -0,0 +1,60 @@
+import type { ChatMessage, ToolCallInfo } from "../schemas/message";
+import type { ContentBlock } from "../schemas/projection";
+import { type McpAppData } from "../schemas/mcp-app";
+/**
+ * MCP App 卡片（`_meta.ui` → `tool_ui` block）的共享判定层。
+ *
+ * 判定逻辑不许各写一份（仓库 CLAUDE.md）：agent-react 与 apps/web 都从这里消费卡片的
+ * 实例、可见性、身份和终态规则；样式与状态容器（侧栏页签栈等）两侧各自实现。
+ */
+export interface ToolUiCard {
+    resourceUri?: string;
+    resourceURI?: string;
+    resourceHTML?: string;
+    /** Local HTML source file; hosts can normalize it against the session workspace. */
+    sourcePath?: string;
+    /** 历史投影标记：绝不重新解析 resourceUri（刷新不重放 MCP/资源读取）。 */
+    archived?: boolean;
+    target: "inline" | "preview";
+    height: number;
+    title?: string;
+    /** 留档的 MCP App 来源身份与调用数据（来源 server、ui:// 资源、CSP 元数据）。 */
+    mcpApp?: McpAppData;
+}
+/** 严格守卫：target/height 缺失、archived 无留档 HTML、或 mcpApp 来源身份残缺的
+ * 卡片一律判无效，消息流、侧栏、toolPreview 事件三处一致降级（不渲染、不发事件、
+ * 不推送）。后端 `_tool_ui_meta.py` 总会补齐 target/height 默认值，判无效即数据畸形。 */
+export declare function isToolUiCard(value: unknown): value is ToolUiCard;
+export type ToolUiCardContentType = "resource-html" | "resource-uri" | "resource-file";
+/** 解析卡片实际要渲染的内容。archived 卡片只认留档 HTML，绝不回退到
+ * resourceUri——历史恢复/浏览器刷新不得因此重新发起 MCP 资源读取。 */
+export declare function resolveToolUiCardContent(card: ToolUiCard): {
+    type: ToolUiCardContentType;
+    content: string;
+} | null;
+/** 卡片实例身份/去重键：uri 卡片按内容去重（同一 URI 多次产出只留一份），
+ * 文件 HTML 按来源路径，无来源的 HTML 按 toolCallId 去重。 */
+export declare function buildToolUiCardKey(toolCallId: string, type: ToolUiCardContentType, content: string, sourcePath?: string): string;
+/** 内部「阶段进度」卡片不对用户展示入口。 */
+export declare function isInternalStatusToolUiCard(card: {
+    title?: string | null;
+} | null): boolean;
+/** app-dev 会话里的应用预览卡片：走专门的预览页签，不开普通侧栏 artifact。 */
+export declare function isAppDevToolUiCard(card: ToolUiCard, isAppDev: boolean): boolean;
+export interface InlineToolUiCardEntry {
+    key: string;
+    toolCallId: string;
+    card: ToolUiCard;
+}
+/** 从一轮消息里收集 target=inline 的卡片（渲染进消息流）。 */
+export declare function collectInlineToolUiCards(messages: ChatMessage[]): InlineToolUiCardEntry[];
+export interface PreviewToolUiCardEntry {
+    key: string;
+    toolCall: ToolCallInfo;
+    card: ToolUiCard;
+    /** 所属消息的 blocks；调用方需要还原卡片所在 block 上下文时用。 */
+    blocks: ContentBlock[];
+}
+/** 从一轮消息里收集 target=preview 的卡片（进侧栏/面板，不进消息流），
+ * 并绑定回所属的 toolCall。 */
+export declare function collectPreviewToolUiCards(messages: ChatMessage[]): PreviewToolUiCardEntry[];

package/dist/shared/type-guards.d.ts

@@ -0,0 +1,2 @@
+/** Return true for non-null, non-array objects. */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;

package/dist/socket.d.ts

@@ -4,6 +4,8 @@ import type { ClientToServerEvents, ServerToClientEvents } from "./types/socket-
 export type TypedSocket = Socket<ServerToClientEvents, ClientToServerEvents>;
 export interface CreateSocketOptions extends AuthOptions {
     baseUrl: string;
+    /** MV3 service workers have WebSocket but no XMLHttpRequest. */
+    transports?: ("polling" | "websocket")[];
     path?: string;
 }
 export declare function createSocket(options: CreateSocketOptions): TypedSocket;

package/dist/types/socket-events.d.ts

@@ -34,6 +34,7 @@ export declare namespace ChatSendPayloadSchema {
     type CompactionRatio = (number | null);
     type NativeApprovalPolicy = (("unlessTrusted" | "never") | null);
     type KbIds = (number[] | null);
+    type QueueWhenRunning = boolean;
     interface ChatSendPayload {
         session_id: SessionId;
         message: Message;
@@ -52,6 +53,7 @@ export declare namespace ChatSendPayloadSchema {
         compaction_ratio?: CompactionRatio;
         native_approval_policy?: NativeApprovalPolicy;
         kb_ids?: KbIds;
+        queue_when_running?: QueueWhenRunning;
         [k: string]: unknown;
     }
     interface Message {
@@ -76,9 +78,11 @@ export type ChatStopPayload = ChatStopPayloadSchema.ChatStopPayload;
 export declare namespace ChatAppendPayloadSchema {
     type SessionId = string;
     type Message = string;
+    type ClientRequestId = (string | null);
     interface ChatAppendPayload {
         session_id: SessionId;
         message: Message;
+        client_request_id?: ClientRequestId;
         [k: string]: unknown;
     }
 }
@@ -91,6 +95,72 @@ export declare namespace ChatCompactPayloadSchema {
     }
 }
 export type ChatCompactPayload = ChatCompactPayloadSchema.ChatCompactPayload;
+export declare namespace ChatQueueListPayloadSchema {
+    type SessionId = string;
+    interface ChatQueueListPayload {
+        session_id: SessionId;
+        [k: string]: unknown;
+    }
+}
+export type ChatQueueListPayload = ChatQueueListPayloadSchema.ChatQueueListPayload;
+export declare namespace ChatQueueUpdatePayloadSchema {
+    type SessionId = string;
+    type ItemId = string;
+    type ExpectedVersion = number;
+    type Message = string;
+    interface ChatQueueUpdatePayload {
+        session_id: SessionId;
+        item_id: ItemId;
+        expected_version: ExpectedVersion;
+        message: Message;
+        [k: string]: unknown;
+    }
+}
+export type ChatQueueUpdatePayload = ChatQueueUpdatePayloadSchema.ChatQueueUpdatePayload;
+export declare namespace ChatQueueReorderPayloadSchema {
+    type SessionId = string;
+    type ExpectedRevision = number;
+    type OrderedIds = string[];
+    interface ChatQueueReorderPayload {
+        session_id: SessionId;
+        expected_revision: ExpectedRevision;
+        ordered_ids: OrderedIds;
+        [k: string]: unknown;
+    }
+}
+export type ChatQueueReorderPayload = ChatQueueReorderPayloadSchema.ChatQueueReorderPayload;
+export declare namespace ChatQueueCancelPayloadSchema {
+    type SessionId = string;
+    type ItemId = string;
+    type ExpectedVersion = (number | null);
+    interface ChatQueueCancelPayload {
+        session_id: SessionId;
+        item_id: ItemId;
+        expected_version?: ExpectedVersion;
+        [k: string]: unknown;
+    }
+}
+export type ChatQueueCancelPayload = ChatQueueCancelPayloadSchema.ChatQueueCancelPayload;
+export declare namespace ChatQueueDeliverPayloadSchema {
+    type SessionId = string;
+    type ItemId = string;
+    type ExpectedVersion = number;
+    interface ChatQueueDeliverPayload {
+        session_id: SessionId;
+        item_id: ItemId;
+        expected_version: ExpectedVersion;
+        [k: string]: unknown;
+    }
+}
+export type ChatQueueDeliverPayload = ChatQueueDeliverPayloadSchema.ChatQueueDeliverPayload;
+export declare namespace ChatQueueResumePayloadSchema {
+    type SessionId = string;
+    interface ChatQueueResumePayload {
+        session_id: SessionId;
+        [k: string]: unknown;
+    }
+}
+export type ChatQueueResumePayload = ChatQueueResumePayloadSchema.ChatQueueResumePayload;
 export declare namespace SessionSubscribePayloadSchema {
     type SessionId = string;
     type Mode = string;
@@ -183,6 +253,43 @@ export declare namespace ChatEndPayloadSchema {
     }
 }
 export type ChatEndPayload = ChatEndPayloadSchema.ChatEndPayload;
+export declare namespace ChatQueueUpdatedPayloadSchema {
+    type SessionId = string;
+    type Revision = number;
+    type Paused = boolean;
+    type PauseReason = (string | null);
+    type Id = string;
+    type Content = string;
+    type Position = number;
+    type Version = number;
+    type Status = string;
+    type CreatedAt = string;
+    type UpdatedAt = string;
+    type TargetRunId = (string | null);
+    type Error = (string | null);
+    type Items = ChatQueueItem[];
+    interface ChatQueueUpdatedPayload {
+        session_id: SessionId;
+        revision: Revision;
+        paused?: Paused;
+        pause_reason?: PauseReason;
+        items?: Items;
+        [k: string]: unknown;
+    }
+    interface ChatQueueItem {
+        id: Id;
+        content: Content;
+        position: Position;
+        version: Version;
+        status: Status;
+        created_at: CreatedAt;
+        updated_at: UpdatedAt;
+        target_run_id?: TargetRunId;
+        error?: Error;
+        [k: string]: unknown;
+    }
+}
+export type ChatQueueUpdatedPayload = ChatQueueUpdatedPayloadSchema.ChatQueueUpdatedPayload;
 export declare namespace SessionCreatedPayloadSchema {
     type SessionId = string;
     interface SessionCreatedPayload {
@@ -192,6 +299,8 @@ export declare namespace SessionCreatedPayloadSchema {
 }
 export type SessionCreatedPayload = SessionCreatedPayloadSchema.SessionCreatedPayload;
 export declare namespace SessionUpdatedPayloadSchema {
+    type WorkspacePath = (string | null);
+    type ChatGroupId = (string | null);
     type SessionId = string;
     type Model = (string | null);
     type ReplayState = ({
@@ -201,6 +310,8 @@ export declare namespace SessionUpdatedPayloadSchema {
     type ProjectId = (number | null);
     type ProjectName = (string | null);
     interface SessionUpdatedPayload {
+        workspace_path?: WorkspacePath;
+        chat_group_id?: ChatGroupId;
         session_id: SessionId;
         model?: Model;
         replay_state?: ReplayState;
@@ -221,6 +332,16 @@ export declare namespace WorkspaceFilesChangedPayloadSchema {
     }
 }
 export type WorkspaceFilesChangedPayload = WorkspaceFilesChangedPayloadSchema.WorkspaceFilesChangedPayload;
+export declare namespace MCPAppChangedPayloadSchema {
+    type SessionId = string;
+    type SourceId = string;
+    interface MCPAppChangedPayload {
+        session_id: SessionId;
+        source_id: SourceId;
+        [k: string]: unknown;
+    }
+}
+export type MCPAppChangedPayload = MCPAppChangedPayloadSchema.MCPAppChangedPayload;
 export declare namespace SystemErrorPayloadSchema {
     type Message = string;
     type SessionId = (string | null);
@@ -278,6 +399,20 @@ export declare namespace TurnEventsPayloadSchema {
     }
 }
 export type TurnEventsPayload = TurnEventsPayloadSchema.TurnEventsPayload;
+export declare namespace TurnTimingPayloadSchema {
+    type SessionId = string;
+    type LoopName = string;
+    type TurnId = string;
+    type FirstTokenDeliveryMs = number;
+    interface TurnTimingPayload {
+        session_id: SessionId;
+        loop_name: LoopName;
+        turn_id: TurnId;
+        first_token_delivery_ms: FirstTokenDeliveryMs;
+        [k: string]: unknown;
+    }
+}
+export type TurnTimingPayload = TurnTimingPayloadSchema.TurnTimingPayload;
 export declare namespace AsrReadyPayloadSchema {
     type RequestId = string;
     type Provider = string;
@@ -394,11 +529,58 @@ export declare namespace ChatCompactAckSchema {
     }
 }
 export type ChatCompactAck = ChatCompactAckSchema.ChatCompactAck;
+export declare namespace ChatQueueAckSchema {
+    type SessionId = string;
+    type Revision = number;
+    type Paused = boolean;
+    type PauseReason = (string | null);
+    type Id = string;
+    type Content = string;
+    type Position = number;
+    type Version = number;
+    type Status = string;
+    type CreatedAt = string;
+    type UpdatedAt = string;
+    type TargetRunId = (string | null);
+    type Error = (string | null);
+    type Items = ChatQueueItem[];
+    type Status1 = string;
+    type Message = (string | null);
+    interface ChatQueueAck {
+        session_id: SessionId;
+        revision: Revision;
+        paused?: Paused;
+        pause_reason?: PauseReason;
+        items?: Items;
+        status?: Status1;
+        message?: Message;
+        [k: string]: unknown;
+    }
+    interface ChatQueueItem {
+        id: Id;
+        content: Content;
+        position: Position;
+        version: Version;
+        status: Status;
+        created_at: CreatedAt;
+        updated_at: UpdatedAt;
+        target_run_id?: TargetRunId;
+        error?: Error;
+        [k: string]: unknown;
+    }
+}
+export type ChatQueueAck = ChatQueueAckSchema.ChatQueueAck;
 export interface ClientToServerEvents {
     "chat:send": (payload: ChatSendPayload, ack: (response: ChatSendAck) => void) => void;
     "chat:stop": (payload: ChatStopPayload, ack: (response: ChatStopAck) => void) => void;
-    "chat:append": (payload: ChatAppendPayload) => void;
+    "chat:append": (payload: ChatAppendPayload, ack: (response: ChatQueueAck) => void) => void;
     "chat:compact": (payload: ChatCompactPayload, ack: (response: ChatCompactAck) => void) => void;
+    "chat:queue:list": (payload: ChatQueueListPayload, ack: (response: ChatQueueAck) => void) => void;
+    "chat:queue:update": (payload: ChatQueueUpdatePayload, ack: (response: ChatQueueAck) => void) => void;
+    "chat:queue:reorder": (payload: ChatQueueReorderPayload, ack: (response: ChatQueueAck) => void) => void;
+    "chat:queue:cancel": (payload: ChatQueueCancelPayload, ack: (response: ChatQueueAck) => void) => void;
+    "chat:queue:deliver": (payload: ChatQueueDeliverPayload, ack: (response: ChatQueueAck) => void) => void;
+    "chat:queue:resume": (payload: ChatQueueResumePayload, ack: (response: ChatQueueAck) => void) => void;
     "session:subscribe": (payload: SessionSubscribePayload) => void;
     "session:subscribe_batch": (payload: SessionSubscribeBatchPayload) => void;
     "session:unsubscribe": (payload: SessionUnsubscribePayload) => void;
@@ -412,13 +594,15 @@ export interface ClientToServerEvents {
 export interface ServerToClientEvents {
     "chat:start": (payload: ChatStartPayload) => void;
     "chat:end": (payload: ChatEndPayload) => void;
-    "chat:append:ack": (payload: unknown) => void;
+    "chat:queue:updated": (payload: ChatQueueUpdatedPayload) => void;
     "session:created": (payload: SessionCreatedPayload) => void;
     "session:updated": (payload: SessionUpdatedPayload) => void;
     "workspace:files_changed": (payload: WorkspaceFilesChangedPayload) => void;
+    "mcp-app:changed": (payload: MCPAppChangedPayload) => void;
     "system:error": (payload: SystemErrorPayload) => void;
     "system:notification": (payload: SystemNotificationPayload) => void;
     "turn:events": (payload: TurnEventsPayload) => void;
+    "turn:timing": (payload: TurnTimingPayload) => void;
     "task:updated": (payload: unknown) => void;
     "task:synced": (payload: unknown) => void;
     "artifact:created": (payload: unknown) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blade-hq/agent-client",
-  "version": "2610.0.0-rc.0",
+  "version": "2610.0.0",
   "description": "Blade Agent 框架无关客户端：会话实时状态机、REST 通道、弹窗登录、页面协作。浏览器与 Node.js 通用。",
   "repository": {
     "type": "git",