@blade-hq/agent-client 2610.0.0-beta.89 → 2610.0.0-beta.90

package/dist/resources/chat-groups.d.ts

@@ -6,6 +6,7 @@ export interface ChatGroup {
     created_at: string;
     updated_at: string;
     session_count: number;
+    initiator: "ui" | "sdk" | null;
     workspace_path: string;
 }
 export declare class ChatGroupsResource {
@@ -15,6 +16,7 @@ export declare class ChatGroupsResource {
     create(payload: {
         name: string;
         instructions?: string;
+        initiator?: "ui" | "sdk";
     }): Promise<ChatGroup>;
     update(groupId: string, payload: {
         name?: string;

package/dist/schemas/message-utils.d.ts

@@ -67,4 +67,6 @@ interface MessageGroup {
     }[];
 }
 export declare function groupMessagesByLoop(messages: ChatMessage[]): MessageGroup[];
+/** A typed wake input stays internal for navigation, but has a visible notice. */
+export declare function isBackgroundWakeMessage(message: Pick<ChatMessage, "blocks">): boolean;
 export {};

package/dist/session/definition.d.ts

@@ -11,11 +11,16 @@ export type SolutionDefinition = {
     files: TextFile[];
     role?: string;
 };
+export type SkillFile = TextFile & {
+    /** 二进制内容使用 base64；省略时为 UTF-8 文本。 */
+    encoding?: "utf-8" | "base64";
+    executable?: boolean;
+};
 export interface SkillDefinition {
     /** 会话内安装名，格式为 `组织/名称`。 */
     name: string;
     /** 必须包含根目录的 SKILL.md。 */
-    files: TextFile[];
+    files: SkillFile[];
 }
 export interface SessionConfig {
     /** Server 模型目录中的 model ID。 */

package/dist/session/events.d.ts

@@ -83,8 +83,10 @@ export interface AgentSessionEvents {
     };
     /** 工具返回值带 _meta.ui 的可视化预览（resource HTML / URI）。 */
     toolPreview: {
+        /** Source file identity when the preview comes from a local HTML file. */
+        sourcePath?: string;
         toolCallId: string;
-        type: "resource-html" | "resource-uri";
+        type: "resource-html" | "resource-uri" | "resource-file";
         content: string;
         title: string;
         mcpApp?: McpAppData;

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

@@ -11,6 +11,8 @@ 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";
@@ -23,7 +25,7 @@ export interface ToolUiCard {
  * 卡片一律判无效，消息流、侧栏、toolPreview 事件三处一致降级（不渲染、不发事件、
  * 不推送）。后端 `_tool_ui_meta.py` 总会补齐 target/height 默认值，判无效即数据畸形。 */
 export declare function isToolUiCard(value: unknown): value is ToolUiCard;
-export type ToolUiCardContentType = "resource-html" | "resource-uri";
+export type ToolUiCardContentType = "resource-html" | "resource-uri" | "resource-file";
 /** 解析卡片实际要渲染的内容。archived 卡片只认留档 HTML，绝不回退到
  * resourceUri——历史恢复/浏览器刷新不得因此重新发起 MCP 资源读取。 */
 export declare function resolveToolUiCardContent(card: ToolUiCard): {
@@ -31,8 +33,8 @@ export declare function resolveToolUiCardContent(card: ToolUiCard): {
     content: string;
 } | null;
 /** 卡片实例身份/去重键：uri 卡片按内容去重（同一 URI 多次产出只留一份），
- * html 卡片按 toolCallId 去重（同一调用的新 HTML 覆盖旧内容）。 */
-export declare function buildToolUiCardKey(toolCallId: string, type: ToolUiCardContentType, content: string): string;
+ * 文件 HTML 按来源路径，无来源的 HTML 按 toolCallId 去重。 */
+export declare function buildToolUiCardKey(toolCallId: string, type: ToolUiCardContentType, content: string, sourcePath?: string): string;
 /** 内部「阶段进度」卡片不对用户展示入口。 */
 export declare function isInternalStatusToolUiCard(card: {
     title?: string | null;

package/package.json

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

package/public-api.md

@@ -3,7 +3,7 @@
 > 本文件由 `scripts/public-api-report.mjs` 生成，请勿手改。
 > 公共面变更时重新生成本报告，并同步更新 README 对应章节——CI 会校验两者。
 
-共 245 个公开声明。
+共 247 个公开声明。
 
 ## `acceptedPostChatFollowupCompletesLatestRun` (function)
 
@@ -138,7 +138,7 @@ sandboxOom: { toolCallId: string; }
 sessionUpdated: { workspacePath?: string; chatGroupId?: string | null; intent?: string; status?: SessionStatus; model?: string | null; boundSkillId?: string | null; replayState?: Record<string, unknown> | null; }
 taskListUpdated: { tasks: unknown[]; }
 toolCall: { toolCall: ToolCallInfo; turn: TurnProjection; }
-toolPreview: { toolCallId: string; type: "resource-html" | "resource-uri"; content: string; title: string; mcpApp?: McpAppData; }
+toolPreview: { sourcePath?: string; toolCallId: string; type: "resource-html" | "resource-uri" | "resource-file"; content: string; title: string; mcpApp?: McpAppData; }
 toolResult: { toolCall: ToolCallInfo; turn: TurnProjection; source: "live" | "bootstrap_replay" | "reconnect_replay"; }
 workspaceChanged: { filePath?: string; }
 ```
@@ -330,7 +330,7 @@ buildMessageContent: (text: string, attachments: Array<{ kind: "file"; name: str
 ## `buildToolUiCardKey` (function)
 
 ```ts
-buildToolUiCardKey: (toolCallId: string, type: ToolUiCardContentType, content: string) => string
+buildToolUiCardKey: (toolCallId: string, type: ToolUiCardContentType, content: string, sourcePath?: string) => string
 ```
 
 ## `canCancelQueuedMessage` (function)
@@ -375,6 +375,7 @@ chatErrorForDisplay: (message: string, developer?: boolean) => string
 ```ts
 created_at: string
 id: string
+initiator: "ui" | "sdk" | null
 instructions: string
 name: string
 session_count: number
@@ -385,7 +386,7 @@ workspace_path: string
 ## `ChatGroupsResource` (class)
 
 ```ts
-create: (payload: { name: string; instructions?: string; }) => Promise<ChatGroup>
+create: (payload: { name: string; instructions?: string; initiator?: "ui" | "sdk"; }) => Promise<ChatGroup>
 delete: (groupId: string, options?: { deleteWorkspace?: boolean; }) => Promise<{ deleted: boolean; deleted_sessions: number; }>
 list: () => Promise<ChatGroup[]>
 update: (groupId: string, payload: { name?: string; instructions?: string; }) => Promise<ChatGroup>
@@ -892,6 +893,12 @@ toolCallId: string
 isAppDevToolUiCard: (card: ToolUiCard, isAppDev: boolean) => boolean
 ```
 
+## `isBackgroundWakeMessage` (function)
+
+```ts
+isBackgroundWakeMessage: (message: Pick<ChatMessage, "blocks">) => boolean
+```
+
 ## `isCommandEnvelope` (function)
 
 ```ts
@@ -1982,7 +1989,7 @@ total_pv: number
 ## `SkillDefinition` (interface)
 
 ```ts
-files: TextFile[]
+files: SkillFile[]
 name: string
 ```
 
@@ -1992,6 +1999,16 @@ name: string
 export type SkillEditorTemplateId = "skill_editor"
 ```
 
+## `SkillFile` (type)
+
+```ts
+export type SkillFile = TextFile & {
+  /** 二进制内容使用 base64；省略时为 UTF-8 文本。 */
+  encoding?: "utf-8" | "base64"
+  executable?: boolean
+}
+```
+
 ## `SkillMentionAvailability` (interface)
 
 ```ts
@@ -2216,6 +2233,7 @@ mcpApp: McpAppData | undefined
 resourceHTML: string | undefined
 resourceUri: string | undefined
 resourceURI: string | undefined
+sourcePath: string | undefined
 target: "inline" | "preview"
 title: string | undefined
 ```
@@ -2223,7 +2241,7 @@ title: string | undefined
 ## `ToolUiCardContentType` (type)
 
 ```ts
-export type ToolUiCardContentType = "resource-html" | "resource-uri"
+export type ToolUiCardContentType = "resource-html" | "resource-uri" | "resource-file"
 ```
 
 ## `toReplaySnapshot` (function)