@blade-hq/agent-client 2610.0.0-beta.0 → 2610.0.0-beta.2

package/README.md

@@ -56,6 +56,7 @@ new BladeClient({
   baseUrl: "https://blade.example.com", // 后端地址；同域部署可传 ""
   token: "sk-blade-xxx",                // 可选：PAT。不传则用 cookie 或 login()
   tokenStorage: "local",                // 可选：login() 的令牌存哪（"local" 默认 / "memory"）
+  streamTokens: false,                   // 可选：只接收完成态内容，不订阅逐 token 增量
 })
 ```
 
@@ -133,6 +134,7 @@ Solution 和 Skill 都声明为 `{ path, content }[]` 文本文件；SDK 负责
 
 ```ts
 await client.sessions.listSessions()                  // 会话列表
+await client.sessions.searchOwnedContent({ q: "项目报告" }) // 搜索自己的对话和文件名
 await client.sessions.getSession(id)                  // 会话详情
 await client.sessions.updateSession(id, { intent: "新标题" })
 await client.sessions.deleteSession(id)
@@ -224,6 +226,18 @@ await chat.countFiles()                         // 递归统计，不含目录
 await chat.downloadFile("输出/简历.md", "简历.md") // 浏览器下载
 ```
 
+对符合评价条件的最新整体结果，可读取或更新当前用户的反馈：
+
+```ts
+const feedback = await client.sessions.listResultFeedback(id)
+await client.sessions.putResultFeedback(id, assistantEntryId, {
+  helpful: false,
+  reason: "incomplete",
+})
+```
+
+`ResultFeedbackReason` 是固定枚举；Server 会校验结果资格、写权限，并自行推导 Chat / 软件工厂场景和项目 ID。
+
 ### 模型目录
 
 ```ts
@@ -502,11 +516,11 @@ transformSlashCommand(skillId, prompt, { local: false, installed: false })
 - **SDK 身份**：`SDK_NAME`、`SDK_VERSION`
 - **声明式会话**：`SessionDefinition`、`SolutionDefinition`、`SkillDefinition`、`SessionConfig`、`TextFile`、`SessionSetupError`、`SessionSetupStage`
 - **模型目录**：`ModelsResource`、`ModelCatalog`、`ModelOption`
-- **会话资源（REST）**：`SessionsResource`、`CreateSessionRequest`、`ImportSessionOptions`、`AppCliDefinition`、`AppCliAttachment`、`AttachAppOptions`、`PaginatedSessionsResult`、`SessionHistory`、`SessionContextStats`、`ShareLinkResult`、`FileEntry`、`UploadFileEntry`、`UploadFilesOptions`、`SessionProfile`、`SessionDetail`、`SessionInfo`、`SessionStatus`、`SessionPortMapping`、`ModeId`、`TemplateId`、`PrimarySkillSnapshot`、`PrimarySkillParallelMode`
+- **会话资源（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`
 - **页面协作**：`EmbeddedChat`、`EmbeddedChatOptions`、`CommandHandler`、`CommandEnvelope`、`InboundAction`、`InboundEnvelope`、`isCommandEnvelope`、`isInboundEnvelope`
-- **消息与投影协议**：`MessageContent`、`MessageContentPart`、`TextContentPart`、`ImageUrlContentPart`、`FileContentPart`、`ToolCallInfo`、`ToolBridgeContent`、`CompactionInfo`、`MemoryRefInfo`、`ArchivedFileInfo`、`ArchivedToolCallInfo`、`TurnProjection`、`ContentBlock`、`PatchEnvelope`、`MemoryRef`、`buildMessageContent`、`normalizeMessageContent`、`isHiddenInternalMessage`、`transformSlashCommand`、`SkillMentionAvailability`、`extractTextAttachments`、`ParsedTextAttachment`、`ParsedTextContext`
+- **消息与投影协议**：`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`
 - **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`
+- **低层通道（apps/web 等高级集成）**：`createSocket`、`CreateSocketOptions`、`TypedSocket`、`AsrAudioPayload`、`ClientProjectionBuilder`、`RawEvent`、`acceptedPostChatFollowupCompletesLatestRun`

package/dist/blade-client.d.ts

@@ -23,6 +23,8 @@ export interface BladeClientOptions {
     tokenStorage?: TokenStorageMode;
     fetchImpl?: typeof fetch;
     onRefreshSuccess?: () => void | Promise<void>;
+    /** 是否订阅逐 token 增量，默认 true。关闭后仍接收完整消息和语义事件。 */
+    streamTokens?: boolean;
 }
 export declare class BladeClient {
     private refreshPromise;

package/dist/index.d.ts

@@ -21,11 +21,12 @@ export type { HeadlessResource } from "./resources/headless";
 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, SessionContextStats, SessionHistory, ShareLinkResult, UploadFileEntry, UploadFilesOptions, } 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 { 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 type { ParsedTextAttachment, ParsedTextContext, SkillMentionAvailability, } from "./schemas/message-utils";
-export type { ContentBlock, MemoryRef, PatchEnvelope, TurnProjection } from "./schemas/projection";
+export type { ContentBlock, FinalArtifact, MemoryRef, PatchEnvelope, PostChatFollowup, TurnProjection, } from "./schemas/projection";
+export { latestPostChatFollowup } from "./schemas/projection-utils";
 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";
@@ -33,7 +34,7 @@ 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 { ClientProjectionBuilder } from "./shared/projection";
+export { acceptedPostChatFollowupCompletesLatestRun, ClientProjectionBuilder } from "./shared/projection";
 export type { RawEvent } from "./shared/projection";
 export { createSocket } from "./socket";
 export type { CreateSocketOptions, TypedSocket } from "./socket";

package/dist/index.js

@@ -350,7 +350,11 @@ var HeadlessResource = class {
       socket.on("chat:start", onChatStart);
       socket.on("chat:end", onChatEnd);
       socket.on("system:error", onSystemError);
-      socket.emit("session:subscribe", { session_id, event_format: "raw" });
+      socket.emit("session:subscribe", {
+        session_id,
+        event_format: "raw",
+        stream_tokens: this.client.options.streamTokens !== false
+      });
       socket.emit(
         "chat:send",
         {
@@ -893,7 +897,7 @@ function sourceLoopFor(loopId, loopDescriptions) {
   if (!description) return null;
   return { loop_name: loopId, description };
 }
-var MAX_FINAL_ARTIFACTS = 3;
+var MAX_FINAL_ARTIFACTS = 20;
 function normalizeFinalArtifacts(raw) {
   if (!Array.isArray(raw)) return [];
   const artifacts = [];
@@ -927,12 +931,16 @@ function normalizePostChatFollowup(data, assistantEntryId) {
   }
   const recaption = String(data.recaption ?? "");
   const finalArtifacts = normalizeFinalArtifacts(data.final_artifacts);
-  if (suggestions.length === 0 && !recaption && finalArtifacts.length === 0) return null;
+  const feedbackEligible = data.feedback_eligible === true;
+  if (suggestions.length === 0 && !recaption && finalArtifacts.length === 0 && !feedbackEligible)
+    return null;
   return {
     assistant_entry_id: assistantEntryId,
     recaption,
     suggestions: suggestions.slice(0, 3),
-    final_artifacts: finalArtifacts
+    final_artifacts: finalArtifacts,
+    feedback_eligible: feedbackEligible,
+    feedback_scope: "latest_result"
   };
 }
 function normalizeChildPause(pausePayload) {
@@ -1016,11 +1024,60 @@ function toolStatusFromResult(result) {
 }
 
 // src/shared/projection/builder.ts
+function hasChatRunEvent(events) {
+  return events.some(
+    (event) => event.type !== "session:post_chat_followup" && !event.type.startsWith("compaction:")
+  );
+}
+function acceptedPostChatFollowupCompletesLatestRun(events, updates) {
+  const acceptedAssistantEntryIds = new Set(
+    updates.flatMap((update) => {
+      if (update.kind !== "upsert") return [];
+      const followup = update.turn.post_chat_followup;
+      return followup?.assistant_entry_id ? [followup.assistant_entry_id] : [];
+    })
+  );
+  for (let index = events.length - 1; index >= 0; index -= 1) {
+    const event = events[index];
+    if (event?.type !== "session:post_chat_followup") continue;
+    const assistantEntryId = String(event.payload.assistant_entry_id ?? "");
+    return acceptedAssistantEntryIds.has(assistantEntryId) && !hasChatRunEvent(events.slice(index + 1));
+  }
+  return false;
+}
 function isConversationTurn(turn) {
   return (turn.role === "user" || turn.role === "assistant") && (turn.kind ?? "message") === "message" && !turn.blocks.some(
     (block) => block.type === "mode_change" || block.type === "plan_status" || block.type === "ask_user_answer"
   );
 }
+function completedResponseText(content) {
+  if (typeof content === "string") return content;
+  if (!Array.isArray(content)) return content == null ? "" : String(content);
+  return content.filter(
+    (part) => typeof part === "object" && part !== null && !Array.isArray(part)
+  ).filter((part) => part.type === "text").map((part) => String(part.text ?? "")).join("");
+}
+function replaceTextContent(state, content) {
+  if (state.blocks.some((block) => block.type === "text")) return;
+  const replacement = { type: "text", content };
+  const blocks = [];
+  let inserted = false;
+  for (const block of state.blocks) {
+    if (block.type === "text") {
+      if (content && !inserted) {
+        blocks.push(replacement);
+        inserted = true;
+      }
+      continue;
+    }
+    blocks.push(block);
+  }
+  if (content && !inserted) {
+    const toolIndex = blocks.findIndex((block) => block.type === "tool_use");
+    blocks.splice(toolIndex < 0 ? blocks.length : toolIndex, 0, replacement);
+  }
+  state.blocks = blocks;
+}
 var ClientProjectionBuilder = class {
   activeTurns = /* @__PURE__ */ new Map();
   lastTurnIds = /* @__PURE__ */ new Map();
@@ -1103,6 +1160,9 @@ var ClientProjectionBuilder = class {
         return this.onDelta(state, "thinking", "", String(payload.content ?? ""));
       case "llm:content:delta":
         return this.onDelta(state, "text", "", String(payload.content ?? ""));
+      case "llm:content:complete":
+        replaceTextContent(state, String(payload.content ?? ""));
+        return this.syncPatch(state);
       case "llm:tool_call:created":
         return this.onToolCallCreated(state, payload);
       case "llm:response:done":
@@ -1392,6 +1452,9 @@ var ClientProjectionBuilder = class {
     if (typeof payload.usage === "object" && payload.usage !== null) {
       state.usage = { ...payload.usage };
     }
+    if ("content" in payload) {
+      replaceTextContent(state, completedResponseText(payload.content));
+    }
     const toolCalls = payload.tool_calls;
     if (Array.isArray(toolCalls)) {
       for (const raw of toolCalls) {
@@ -2195,6 +2258,11 @@ var SessionsResource = class {
   listSessionsWithSkillData() {
     return this.client.json("GET", "/api/sessions/with-skill-data");
   }
+  searchOwnedContent(params) {
+    const searchParams = new URLSearchParams({ q: params.q.trim() });
+    if (params.limit !== void 0) searchParams.set("limit", String(params.limit));
+    return this.client.json("GET", `/api/search?${searchParams.toString()}`);
+  }
   createSession(intent, template_id, primary_skill_id) {
     return this.createSessionWithRequest({ intent, template_id, primary_skill_id });
   }
@@ -2261,6 +2329,16 @@ var SessionsResource = class {
     );
     return projectHistory(entries);
   }
+  listResultFeedback(sessionId) {
+    return this.client.json("GET", `/api/sessions/${encodeURIComponent(sessionId)}/feedback`);
+  }
+  putResultFeedback(sessionId, assistantEntryId, feedback) {
+    return this.client.json(
+      "PUT",
+      `/api/sessions/${encodeURIComponent(sessionId)}/turns/${encodeURIComponent(assistantEntryId)}/feedback`,
+      feedback
+    );
+  }
   getSessionContextStats(sessionId, init) {
     return this.client.jsonFromInit(`/api/sessions/${sessionId}/context-stats`, init);
   }
@@ -3229,7 +3307,7 @@ function extractTerminalChatEndStatus(events) {
   }
   return null;
 }
-function hasChatRunEvent(events) {
+function hasChatRunEvent2(events) {
   return events.some(
     (event) => event.type !== "session:post_chat_followup" && !event.type.startsWith("compaction:")
   );
@@ -3281,6 +3359,7 @@ var AgentSession = class _AgentSession {
     const session = new _AgentSession(
       sessionId,
       {
+        streamTokens: false,
         emitEvent: readonlyError,
         emitWithAck: async () => readonlyError(),
         ensureConnected: readonlyError,
@@ -3654,7 +3733,7 @@ var AgentSession = class _AgentSession {
   _handleTurnEvents(events) {
     if (!events.length) return;
     const terminalChatEndStatus = extractTerminalChatEndStatus(events);
-    if (!terminalChatEndStatus && hasChatRunEvent(events)) {
+    if (!terminalChatEndStatus && hasChatRunEvent2(events)) {
       this.markRunningIfIdle();
     }
     if (this.state.turns.length) {
@@ -3668,8 +3747,8 @@ var AgentSession = class _AgentSession {
         this.emitter.emit("workspaceChanged", {});
       }
     }
-    if (terminalChatEndStatus) {
-      this.finishStreaming(terminalChatEndStatus);
+    if (terminalChatEndStatus || acceptedPostChatFollowupCompletesLatestRun(events, updates)) {
+      this.completeChat(terminalChatEndStatus ?? "completed");
     }
   }
   /** @internal */
@@ -3679,10 +3758,7 @@ var AgentSession = class _AgentSession {
   /** @internal */
   _handleChatEnd(status) {
     this.flushPatches();
-    this.finishStreaming(status);
-    this.recentChatEndAt = Date.now();
-    void this.syncTurnsFromHistory();
-    this.emitter.emit("chatEnd", { status });
+    this.completeChat(status);
   }
   /** @internal */
   _handleSystemError(message) {
@@ -3826,6 +3902,12 @@ var AgentSession = class _AgentSession {
       return next;
     });
   }
+  completeChat(status) {
+    this.finishStreaming(status);
+    this.recentChatEndAt = Date.now();
+    void this.syncTurnsFromHistory();
+    this.emitter.emit("chatEnd", { status });
+  }
   applyTurn(turn) {
     this.flushPatches();
     const previous = this.state;
@@ -4008,7 +4090,12 @@ var AgentSession = class _AgentSession {
     if (this.joinPending) return this.joinPending;
     const join = this.runtime.emitWithAck(
       "session:subscribe",
-      { session_id: this.sessionId, event_format: "raw", resume: true },
+      {
+        session_id: this.sessionId,
+        event_format: "raw",
+        resume: true,
+        stream_tokens: this.runtime.streamTokens
+      },
       5e3
     ).then((response) => {
       if (response && response.ok === false) {
@@ -4144,6 +4231,7 @@ var SessionHub = class {
   }
   runtimeFor() {
     return {
+      streamTokens: this.client.options?.streamTokens !== false,
       emitEvent: (event, data) => {
         ;
         this.client.socket().emit(event, data);
@@ -4383,7 +4471,7 @@ function resolveAuthToken(options) {
 
 // src/version.ts
 var SDK_NAME = "agent-client";
-var SDK_VERSION = true ? "2610.0.0-beta.0" : "1.1.1";
+var SDK_VERSION = true ? "2610.0.0-beta.2" : "1.1.1";
 
 // src/socket.ts
 function withSdkIdentity(auth) {
@@ -4835,6 +4923,19 @@ function connectEmbedded(options) {
   };
 }
 
+// src/schemas/projection-utils.ts
+function latestPostChatFollowup(turns) {
+  for (let index = turns.length - 1; index >= 0; index -= 1) {
+    const turn = turns[index];
+    if (turn.loop_id === "root" && (turn.role === "user" || turn.role === "assistant") && (turn.kind ?? "message") === "message" && !turn.blocks.some(
+      (block) => ["mode_change", "plan_status", "ask_user_answer"].includes(block.type)
+    )) {
+      return turn.role === "assistant" ? turn.post_chat_followup ?? null : null;
+    }
+  }
+  return null;
+}
+
 // src/schemas/solution.ts
 var LayoutType = /* @__PURE__ */ ((LayoutType2) => {
   LayoutType2["Default"] = "default";
@@ -4877,6 +4978,7 @@ export {
   SessionStatus,
   Task,
   TaskStatus,
+  acceptedPostChatFollowupCompletesLatestRun,
   buildMessageContent,
   connectEmbedded,
   contentPreview,
@@ -4890,6 +4992,7 @@ export {
   isCommandEnvelope,
   isHiddenInternalMessage,
   isInboundEnvelope,
+  latestPostChatFollowup,
   normalizeMessageContent,
   toReplaySnapshot,
   transformSlashCommand