@blade-hq/agent-client 2610.0.0-beta.7 → 2610.0.0-beta.71

package/dist/shared/projection/history.d.ts

@@ -4,6 +4,7 @@ export interface RawHistoryEntry {
     kind?: string;
     loop_name?: string;
     message?: Record<string, unknown>;
+    source?: Record<string, unknown>;
     data?: Record<string, unknown>;
     timestamp?: string;
     [key: string]: unknown;

package/dist/shared/projection/index.d.ts

@@ -1,3 +1,4 @@
-export { acceptedPostChatFollowupCompletesLatestRun, ClientProjectionBuilder, type RawEvent, type ProjectionUpdate, } from "./builder";
+export { acceptedPostChatFollowupCompletesLatestRun, acknowledgeTurnEvents, ClientProjectionBuilder, hasChatRunEvent, type RawEvent, type ProjectionUpdate, } from "./builder";
 export { type TurnState, createTurnState, snapshot, PAUSE_TOOL_NAMES } from "./state";
 export { projectHistory, type RawHistoryEntry } from "./history";
+export { buildContextTurn } from "./context";

package/dist/shared/projection/state.d.ts

@@ -10,6 +10,13 @@ export interface TurnState {
     toolCalls: ToolCallProjection[];
     usage: Record<string, unknown> | null;
     responseDone: boolean;
+    firstTokenMs: number | null;
+    streamDurationMs: number | null;
+    firstTokenDeliveryMs: number | null;
+    /** 生产者上报的模型请求时序；缺失时保持 null，不用浏览器时间补（#2581 A1/I1）。 */
+    modelStartedAt: string | null;
+    modelDurationMs: number | null;
+    modelStartedAtReported: boolean;
     memoryRefs: MemoryRef[] | null;
     parentForkToolCallId: string | null;
 }

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

@@ -0,0 +1,58 @@
+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;
+    /** 历史投影标记：绝不重新解析 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";
+/** 解析卡片实际要渲染的内容。archived 卡片只认留档 HTML，绝不回退到
+ * resourceUri——历史恢复/浏览器刷新不得因此重新发起 MCP 资源读取。 */
+export declare function resolveToolUiCardContent(card: ToolUiCard): {
+    type: ToolUiCardContentType;
+    content: string;
+} | null;
+/** 卡片实例身份/去重键：uri 卡片按内容去重（同一 URI 多次产出只留一份），
+ * html 卡片按 toolCallId 去重（同一调用的新 HTML 覆盖旧内容）。 */
+export declare function buildToolUiCardKey(toolCallId: string, type: ToolUiCardContentType, content: 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/types/socket-events.d.ts

@@ -32,6 +32,9 @@ export declare namespace ChatSendPayloadSchema {
         [k: string]: unknown;
     } | null);
     type CompactionRatio = (number | null);
+    type NativeApprovalPolicy = (("unlessTrusted" | "never") | null);
+    type KbIds = (number[] | null);
+    type QueueWhenRunning = boolean;
     interface ChatSendPayload {
         session_id: SessionId;
         message: Message;
@@ -48,6 +51,9 @@ export declare namespace ChatSendPayloadSchema {
         runtime_env?: RuntimeEnv;
         app_context?: AppContext;
         compaction_ratio?: CompactionRatio;
+        native_approval_policy?: NativeApprovalPolicy;
+        kb_ids?: KbIds;
+        queue_when_running?: QueueWhenRunning;
         [k: string]: unknown;
     }
     interface Message {
@@ -72,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;
     }
 }
@@ -87,20 +95,84 @@ 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;
     type EventFormat = "raw";
     type AfterSequence = number;
     type Resume = boolean;
-    type StreamTokens = boolean;
     interface SessionSubscribePayload {
         session_id: SessionId;
         mode?: Mode;
         event_format?: EventFormat;
         after_sequence?: AfterSequence;
         resume?: Resume;
-        stream_tokens?: StreamTokens;
         [k: string]: unknown;
     }
 }
@@ -116,7 +188,6 @@ export declare namespace SessionSubscribeBatchPayloadSchema {
     type EventFormat = "raw";
     type AfterSequence = number;
     type Resume = boolean;
-    type StreamTokens = boolean;
     interface SessionSubscribeBatchPayload {
         sessions: Sessions;
         [k: string]: unknown;
@@ -127,7 +198,6 @@ export declare namespace SessionSubscribeBatchPayloadSchema {
         event_format?: EventFormat;
         after_sequence?: AfterSequence;
         resume?: Resume;
-        stream_tokens?: StreamTokens;
         [k: string]: unknown;
     }
 }
@@ -183,6 +253,51 @@ 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 {
+        session_id: SessionId;
+        [k: string]: unknown;
+    }
+}
+export type SessionCreatedPayload = SessionCreatedPayloadSchema.SessionCreatedPayload;
 export declare namespace SessionUpdatedPayloadSchema {
     type SessionId = string;
     type Model = (string | null);
@@ -213,6 +328,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);
@@ -270,6 +395,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;
@@ -386,11 +525,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;
@@ -404,12 +590,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-beta.7",
+  "version": "2610.0.0-beta.71",
   "description": "Blade Agent 框架无关客户端：会话实时状态机、REST 通道、弹窗登录、页面协作。浏览器与 Node.js 通用。",
   "repository": {
     "type": "git",