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

package/dist/index.js

@@ -1023,6 +1023,87 @@ function toolStatusFromResult(result) {
   return inferToolStatus(text);
 }
 
+// src/schemas/context.ts
+var BUILTIN_CONTEXT_TITLES = {
+  "agent-instructions": "\u9879\u76EE\u8BF4\u660E",
+  "skill-catalog": "\u53EF\u7528\u80FD\u529B",
+  "runtime-context": "\u5F53\u524D\u5DE5\u4F5C\u73AF\u5883"
+};
+var BUILTIN_CONTEXT_DETAILS = {
+  "agent-instructions": "\u8FD9\u4E9B\u8BF4\u660E\u4F1A\u5E2E\u52A9\u667A\u80FD\u4F53\u7406\u89E3\u5F53\u524D\u9879\u76EE\u548C\u5DE5\u4F5C\u8981\u6C42\u3002",
+  "skill-catalog": "\u8FD9\u4E9B\u80FD\u529B\u4F1A\u5E2E\u52A9\u667A\u80FD\u4F53\u9009\u62E9\u5408\u9002\u7684\u65B9\u5F0F\u5B8C\u6210\u4EFB\u52A1\u3002",
+  "runtime-context": "\u8FD9\u4E9B\u4FE1\u606F\u4F1A\u5E2E\u52A9\u667A\u80FD\u4F53\u4E86\u89E3\u5F53\u524D\u6587\u4EF6\u5939\u548C\u8FD0\u884C\u6761\u4EF6\u3002"
+};
+function nonEmptyString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function contextProjectionData(fields) {
+  const contextKind = nonEmptyString(fields.context_kind);
+  const contextKey = nonEmptyString(fields.context_key);
+  const contextName = nonEmptyString(fields.context_name);
+  const contextRevision = nonEmptyString(fields.context_revision);
+  if (!contextKind || !contextKey || !contextName || !contextRevision || typeof fields.context_order !== "number" || !Number.isFinite(fields.context_order) || !fields.context_action) {
+    return null;
+  }
+  return {
+    context_kind: contextKind,
+    context_key: contextKey,
+    context_name: contextName,
+    context_order: fields.context_order,
+    context_action: fields.context_action,
+    context_revision: contextRevision,
+    display_title: nonEmptyString(fields.display_title),
+    display_summary: nonEmptyString(fields.display_summary),
+    sources: Array.isArray(fields.sources) ? fields.sources : []
+  };
+}
+function getContextDisplayState(context) {
+  const title = BUILTIN_CONTEXT_TITLES[context.context_kind] ?? nonEmptyString(context.display_title) ?? "\u5BF9\u8BDD\u80CC\u666F";
+  const isRemoved = context.context_action === "removed";
+  const summary = nonEmptyString(context.display_summary) ?? (isRemoved ? "\u5DF2\u505C\u6B62\u7528\u4E8E\u540E\u7EED\u5BF9\u8BDD" : context.context_action === "retained" ? "\u7EE7\u7EED\u7528\u4E8E\u540E\u7EED\u5BF9\u8BDD" : context.context_kind === "agent-instructions" ? "\u5DF2\u66F4\u65B0\u672C\u6B21\u5BF9\u8BDD\u4F7F\u7528\u7684\u9879\u76EE\u8BF4\u660E" : context.context_kind === "skill-catalog" ? "\u5DF2\u66F4\u65B0\u672C\u6B21\u53EF\u7528\u80FD\u529B" : context.context_kind === "runtime-context" ? "\u5DF2\u66F4\u65B0\u672C\u6B21\u5DE5\u4F5C\u73AF\u5883" : "\u5DF2\u66F4\u65B0\u672C\u6B21\u5BF9\u8BDD\u80CC\u666F");
+  const detail = isRemoved ? `${title}\u5DF2\u4E0D\u518D\u7528\u4E8E\u540E\u7EED\u5BF9\u8BDD\u3002` : BUILTIN_CONTEXT_DETAILS[context.context_kind] ?? "\u8FD9\u4E9B\u4FE1\u606F\u4F1A\u5E2E\u52A9\u667A\u80FD\u4F53\u7406\u89E3\u5F53\u524D\u4EFB\u52A1\u3002";
+  return { title, summary, detail, isRemoved };
+}
+
+// src/shared/projection/context.ts
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function buildContextTurn(entry, sequence) {
+  if (entry.kind !== "context" || !isRecord2(entry.source) || !isRecord2(entry.data)) {
+    return null;
+  }
+  const display = isRecord2(entry.data.display) ? entry.data.display : {};
+  const context = contextProjectionData({
+    context_kind: typeof entry.source.kind === "string" ? entry.source.kind : null,
+    context_key: typeof entry.source.key === "string" ? entry.source.key : null,
+    context_name: typeof entry.data.contribution_name === "string" ? entry.data.contribution_name : null,
+    context_order: typeof entry.data.order === "number" ? entry.data.order : null,
+    context_action: entry.data.action === "published" || entry.data.action === "retained" || entry.data.action === "removed" ? entry.data.action : null,
+    context_revision: typeof entry.data.revision === "string" ? entry.data.revision : null,
+    display_title: typeof display.title === "string" ? display.title : null,
+    display_summary: typeof display.summary === "string" ? display.summary : null,
+    sources: Array.isArray(display.sources) ? display.sources.filter(isRecord2) : []
+  });
+  if (!context) return null;
+  const turnId = typeof entry.id === "string" && entry.id ? entry.id : `context-${sequence}`;
+  return {
+    id: turnId,
+    sequence,
+    turn_id: turnId,
+    loop_id: typeof entry.loop_name === "string" && entry.loop_name ? entry.loop_name : "root",
+    kind: "context",
+    role: "system",
+    status: "completed",
+    blocks: [],
+    tool_calls: [],
+    model: null,
+    usage: null,
+    duration_ms: 0,
+    ...context
+  };
+}
+
 // src/shared/projection/builder.ts
 function hasChatRunEvent(events) {
   return events.some(
@@ -1117,6 +1198,8 @@ var ClientProjectionBuilder = class {
         return this.onMemoryInject(loopId, payload);
       case "memory:inject:none":
         return null;
+      case "context:entry":
+        return this.onContextEntry(payload);
       case "loop:turn":
         return this.onLoopTurn(loopId, payload);
       case "mode:change":
@@ -1165,6 +1248,8 @@ var ClientProjectionBuilder = class {
         return this.syncPatch(state);
       case "llm:tool_call:created":
         return this.onToolCallCreated(state, payload);
+      case "llm:tool_call:arguments:delta":
+        return this.onToolCallArgumentsDelta(state, payload);
       case "llm:response:done":
         return this.onResponseDone(state, loopId, payload);
       case "tool:result:delta":
@@ -1232,6 +1317,11 @@ var ClientProjectionBuilder = class {
     }
     return null;
   }
+  onContextEntry(payload) {
+    if (!isRecord3(payload.entry)) return null;
+    const turn = buildContextTurn(payload.entry, this.nextSeq());
+    return turn ? [{ kind: "upsert", turn }] : null;
+  }
   onLoopTurn(loopId, payload) {
     let turnId = String(payload.turn_id ?? this.nextTurnId(`turn:${loopId}`));
     let memoryRefs = null;
@@ -1288,11 +1378,11 @@ var ClientProjectionBuilder = class {
         loopId,
         toolCallId: optStr(payload.tool_call_id) ?? void 0,
         toolName: toolNameFromPayload(payload) ?? void 0,
-        workspacePath: isRecord2(payload.workspace_change) ? optStr(payload.workspace_change.to) ?? void 0 : void 0
+        workspacePath: isRecord3(payload.workspace_change) ? optStr(payload.workspace_change.to) ?? void 0 : void 0
       }
     ];
     const change = payload.workspace_change;
-    if (isRecord2(change)) {
+    if (isRecord3(change)) {
       const source = optStr(change.source) ?? "";
       const projectName = optStr(change.project_name) ?? "";
       const fromPath = optStr(change.from) ?? "";
@@ -1430,13 +1520,7 @@ var ClientProjectionBuilder = class {
   }
   onToolCallCreated(state, payload) {
     if ("arguments_delta" in payload) {
-      const delta = String(payload.arguments_delta ?? "");
-      const toolCallId2 = String(payload.id ?? "");
-      if (delta && toolCallId2) {
-        appendToolCallArguments(state, toolCallId2, delta);
-        return this.syncPatch(state);
-      }
-      return null;
+      return this.onToolCallArgumentsDelta(state, payload);
     }
     const toolCallId = String(payload.id ?? "");
     const toolName = toolNameFromPayload(payload);
@@ -1445,6 +1529,13 @@ var ClientProjectionBuilder = class {
     upsertToolCall(state, toolCallId, toolName, displayName, args);
     return this.syncPatch(state);
   }
+  onToolCallArgumentsDelta(state, payload) {
+    const delta = String(payload.arguments_delta ?? "");
+    const toolCallId = String(payload.id ?? "");
+    if (!delta || !toolCallId) return null;
+    appendToolCallArguments(state, toolCallId, delta);
+    return this.syncPatch(state);
+  }
   onResponseDone(state, loopId, payload) {
     state.responseDone = true;
     const model = optStr(payload.model);
@@ -1754,7 +1845,7 @@ var ClientProjectionBuilder = class {
     return `${prefix}:${this.syntheticCounter}:${hex}`;
   }
 };
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function optStr(value) {
@@ -1790,7 +1881,7 @@ function projectHistory(entries) {
     const kind = String(entry.kind ?? "");
     const loopId = String(entry.loop_name ?? "root");
     const id = String(entry.id ?? `history-${sequence + 1}`);
-    if (kind === "post_chat_followup" && isRecord3(entry.data)) {
+    if (kind === "post_chat_followup" && isRecord4(entry.data)) {
       const assistantEntryId = String(entry.data.assistant_entry_id ?? "");
       if (latestRootMessage?.role === "assistant" && latestRootMessage.turn_id === assistantEntryId) {
         const followup = normalizePostChatFollowup(entry.data, assistantEntryId);
@@ -1798,7 +1889,15 @@ function projectHistory(entries) {
       }
       continue;
     }
-    if (kind === "message" && isRecord3(entry.message)) {
+    if (kind === "context") {
+      const turn = buildContextTurn(entry, sequence + 1);
+      if (turn) {
+        sequence += 1;
+        turns.push(turn);
+      }
+      continue;
+    }
+    if (kind === "message" && isRecord4(entry.message)) {
       const message = entry.message;
       const role = String(message.role ?? "");
       if (role === "tool") {
@@ -1830,7 +1929,7 @@ function projectHistory(entries) {
         blocks,
         tool_calls: toolCalls,
         model: stringOrNull(message.model),
-        usage: isRecord3(message._usage) ? { ...message._usage } : null,
+        usage: isRecord4(message._usage) ? { ...message._usage } : null,
         duration_ms: numberOrZero(message._duration_ms),
         started_at: typeof entry.timestamp === "string" ? entry.timestamp : void 0
       };
@@ -1849,7 +1948,7 @@ function projectHistory(entries) {
     if (kind === "mode_change") {
       turns.push(markerTurn(id, ++sequence, loopId, "mode_change", entry.data ?? {}));
     } else if (kind === "workspace_change") {
-      const change = isRecord3(entry.data) ? entry.data : {};
+      const change = isRecord4(entry.data) ? entry.data : {};
       const source = stringOrNull(change.source) ?? "";
       const projectName = stringOrNull(change.project_name) ?? "";
       const fromPath = stringOrNull(change.from) ?? "";
@@ -1890,7 +1989,7 @@ function projectHistory(entries) {
     } else if (kind === "compaction" || kind === "tool_result_archive") {
       const data = entry.data ?? {};
       const compactionId = String(data.compaction_id ?? entry.id ?? `history-${sequence + 1}`);
-      let content = isRecord3(entry.message) ? entry.message.content : void 0;
+      let content = isRecord4(entry.message) ? entry.message.content : void 0;
       if (kind === "tool_result_archive") {
         const archivedCount = Array.isArray(data.archived_files) ? data.archived_files.length : 0;
         content = `<compaction-summary>
@@ -1905,11 +2004,11 @@ function projectHistory(entries) {
       );
     } else if (kind === "child_pause") {
       const data = entry.data ?? {};
-      const sourceLoop = isRecord3(data.source_loop) ? data.source_loop : {};
+      const sourceLoop = isRecord4(data.source_loop) ? data.source_loop : {};
       const childLoopId = String(data.child_loop_name ?? sourceLoop.name ?? "");
       const childToolCallId = String(data.child_pause_tool_call_id ?? "");
       const parentToolCallId = String(data.parent_fork_tool_call_id ?? "");
-      const pauseToolData = isRecord3(data.pause_tool_data) ? data.pause_tool_data : {};
+      const pauseToolData = isRecord4(data.pause_tool_data) ? data.pause_tool_data : {};
       const description = String(sourceLoop.description ?? "");
       applyAskUserPauseToTurn(
         latestAssistantByLoop.get(childLoopId),
@@ -1997,15 +2096,15 @@ function parseToolArguments(value) {
   if (!value) return {};
   try {
     const parsed = JSON.parse(value);
-    return isRecord3(parsed) ? parsed : {};
+    return isRecord4(parsed) ? parsed : {};
   } catch {
     return {};
   }
 }
 function buildToolCalls(value) {
   if (!Array.isArray(value)) return [];
-  return value.filter(isRecord3).map((raw) => {
-    const fn = isRecord3(raw.function) ? raw.function : {};
+  return value.filter(isRecord4).map((raw) => {
+    const fn = isRecord4(raw.function) ? raw.function : {};
     const name = String(fn.name ?? "");
     return {
       id: String(raw.id ?? ""),
@@ -2025,7 +2124,7 @@ function buildBlocks(message, toolCalls) {
     blocks.push({ type: "text", content: displayContent });
   } else if (Array.isArray(stored)) {
     for (const raw of stored) {
-      if (!isRecord3(raw)) continue;
+      if (!isRecord4(raw)) continue;
       const type3 = String(raw.type ?? "");
       if (type3 === "thinking") blocks.push({ type: type3, content: raw.thinking ?? raw.content ?? "" });
       if (type3 === "text") blocks.push({ type: type3, content: raw.text ?? raw.content ?? "" });
@@ -2058,7 +2157,7 @@ function markerTurn(id, sequence, loopId, type3, content, toolCallId = null) {
     duration_ms: 0
   };
 }
-function isRecord3(value) {
+function isRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function stringOrNull(value) {
@@ -2903,10 +3002,10 @@ function inferLoopStatusFromMessages(messages) {
 }
 function inferLoopStatusFromTurns(turns, messages) {
   const latestAgentNotification = [...turns].reverse().flatMap((turn) => turn.blocks).find((block) => {
-    if (block.type !== "system_notification" || !isRecord4(block.content)) return false;
+    if (block.type !== "system_notification" || !isRecord5(block.content)) return false;
     return block.content.notification_type === "agent:start" || block.content.notification_type === "agent:end";
   });
-  if (latestAgentNotification?.type === "system_notification" && isRecord4(latestAgentNotification.content)) {
+  if (latestAgentNotification?.type === "system_notification" && isRecord5(latestAgentNotification.content)) {
     const notificationType = latestAgentNotification.content.notification_type;
     const status = latestAgentNotification.content.status;
     if (notificationType === "agent:start" || status === "running") return "running";
@@ -2915,17 +3014,47 @@ function inferLoopStatusFromTurns(turns, messages) {
   }
   return inferLoopStatusFromMessages(messages);
 }
-function isRecord4(value) {
+function isRecord5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function toSelectionMap(value) {
+  if (!isRecord5(value)) return {};
+  const entries = Object.entries(value).map(([questionKey, optionIndexes]) => {
+    if (!Array.isArray(optionIndexes)) return null;
+    const parsedIndexes = optionIndexes.map((item) => typeof item === "number" ? item : Number(item)).filter((item) => Number.isInteger(item));
+    return [Number(questionKey), parsedIndexes];
+  }).filter((entry) => entry !== null);
+  return Object.fromEntries(entries);
+}
+function toCustomMap(value) {
+  if (!isRecord5(value)) return {};
+  const entries = Object.entries(value).filter(([, text]) => typeof text === "string").map(([questionKey, text]) => [Number(questionKey), text]);
+  return Object.fromEntries(entries);
+}
+function extractAskAnswers(turns) {
+  const answers = {};
+  for (const turn of turns) {
+    for (const block of turn.blocks) {
+      if (block.type !== "ask_user_answer" || typeof block.tool_call_id !== "string") continue;
+      if (!isRecord5(block.content)) continue;
+      const note = typeof block.content.note === "string" ? block.content.note.trim() : "";
+      answers[block.tool_call_id] = {
+        selections: toSelectionMap(block.content.selections),
+        custom: toCustomMap(block.content.custom),
+        ...note ? { note } : {}
+      };
+    }
+  }
+  return answers;
+}
 function parentForkToolCallIdFromTurn(turn) {
   if (typeof turn.parent_fork_tool_call_id === "string" && turn.parent_fork_tool_call_id.length > 0) {
     return turn.parent_fork_tool_call_id;
   }
   for (const block of turn.blocks) {
-    if (block.type !== "system_notification" || !isRecord4(block.content)) continue;
+    if (block.type !== "system_notification" || !isRecord5(block.content)) continue;
     const metadata = block.content.metadata;
-    if (!isRecord4(metadata)) continue;
+    if (!isRecord5(metadata)) continue;
     const parentId = metadata.parent_fork_tool_call_id;
     if (typeof parentId === "string" && parentId.length > 0) return parentId;
   }
@@ -2942,16 +3071,16 @@ function buildMessageContent2(turn) {
 }
 function workspaceNotificationContent(turn) {
   const block = turn.blocks.find(
-    (candidate) => candidate.type === "system_notification" && isRecord4(candidate.content) && candidate.content.notification_type === "workspace_change"
+    (candidate) => candidate.type === "system_notification" && isRecord5(candidate.content) && candidate.content.notification_type === "workspace_change"
   );
-  if (!block || !isRecord4(block.content)) return "";
+  if (!block || !isRecord5(block.content)) return "";
   const title = typeof block.content.title === "string" ? block.content.title.trim() : "";
   const detail = typeof block.content.detail === "string" ? block.content.detail.trim() : "";
   return [title ? `**${title}**` : "", detail].filter(Boolean).join("\n\n");
 }
 function askUserAnswerContent(turn) {
   const answerBlock = turn.blocks.find((block) => block.type === "ask_user_answer");
-  if (!answerBlock || !isRecord4(answerBlock.content)) return null;
+  if (!answerBlock || !isRecord5(answerBlock.content)) return null;
   const answer = answerBlock.content.answer;
   return typeof answer === "string" && answer.trim().length > 0 ? answer : null;
 }
@@ -2971,6 +3100,19 @@ function extractModeFromBlocks(blocks) {
   return null;
 }
 function projectionToMessage(turn) {
+  if (turn.kind === "context") {
+    const context = contextProjectionData(turn);
+    if (!context) return null;
+    return {
+      role: "assistant",
+      content: "",
+      kind: "context",
+      context,
+      loop_name: turn.loop_id,
+      entry_id: turn.turn_id,
+      status: turn.status
+    };
+  }
   if (turn.kind === "compaction" && turn.compaction_id) {
     return {
       role: "assistant",
@@ -3140,6 +3282,25 @@ function orderTurns(turns) {
   }
   return turns;
 }
+function reconcileOptimisticUserTurns(currentTurns, incomingTurns) {
+  const currentById = new Map(currentTurns.map((turn) => [turn.turn_id, turn]));
+  const optimisticUserTurn = currentTurns.find(
+    (turn) => turn.role === "user" && (turn.kind ?? "message") === "message" && turn.turn_id.startsWith("local-user-")
+  );
+  let optimisticUserMatched = false;
+  return incomingTurns.map((turn) => {
+    const current = currentById.get(turn.turn_id);
+    if (current) {
+      const currentRenderId = current.client_render_id;
+      return turn.client_render_id || !currentRenderId ? turn : { ...turn, client_render_id: currentRenderId };
+    }
+    if (!optimisticUserMatched && optimisticUserTurn && turn.role === "user" && (turn.kind ?? "message") === "message" && !turn.turn_id.startsWith("local-user-")) {
+      optimisticUserMatched = true;
+      return { ...turn, client_render_id: optimisticUserTurn.turn_id };
+    }
+    return turn;
+  });
+}
 function areAgentLoopsEqual(left, right) {
   if (!left) return Object.keys(right).length === 0;
   const leftEntries = Object.entries(left);
@@ -3151,7 +3312,7 @@ function areAgentLoopsEqual(left, right) {
   });
 }
 function withTurns(state, turns) {
-  const orderedTurns = orderTurns(turns);
+  const orderedTurns = orderTurns(reconcileOptimisticUserTurns(state.turns, turns));
   const { messages, agentLoops, activeCompaction } = materialize(orderedTurns);
   const isWaitingForInput = orderedTurns.some(
     (turn) => turn.tool_calls.some((toolCall) => toolCall.status === "awaiting_answer")
@@ -3161,14 +3322,31 @@ function withTurns(state, turns) {
   const preservedErrors = lastTurnId ? state.messages.filter(
     (m) => m.role === "error" && typeof m.entry_id === "string" && m.entry_id.startsWith(`${ERROR_ANCHOR_PREFIX}${lastTurnId}:`)
   ) : [];
-  const mergedMessages = preservedErrors.length > 0 ? [...messages, ...preservedErrors] : messages;
+  const turnById = new Map(orderedTurns.map((turn) => [turn.turn_id, turn]));
+  const messagesWithRenderIds = messages.map((message) => {
+    if (!message.entry_id) return message;
+    const renderId = turnById.get(message.entry_id)?.client_render_id;
+    return renderId ? { ...message, render_id: renderId } : message;
+  });
+  const mergedMessages = preservedErrors.length > 0 ? [...messagesWithRenderIds, ...preservedErrors] : messagesWithRenderIds;
   const latestMode = [...orderedTurns].reverse().map((turn) => extractModeFromBlocks(turn.blocks)).find((mode) => mode !== null);
+  const askAnswersFromHistory = extractAskAnswers(orderedTurns);
+  const presentToolCallIds = new Set(
+    orderedTurns.flatMap((turn) => turn.tool_calls.map((toolCall) => toolCall.id))
+  );
+  const askAnswers = { ...askAnswersFromHistory };
+  for (const [toolCallId, answer] of Object.entries(state.askAnswers)) {
+    if (!(toolCallId in askAnswers) && presentToolCallIds.has(toolCallId)) {
+      askAnswers[toolCallId] = answer;
+    }
+  }
   return {
     ...state,
     turns: orderedTurns,
     messages: mergedMessages,
     agentLoops: stableAgentLoops,
     activeCompaction,
+    askAnswers,
     mode: latestMode ?? state.mode,
     // 历史恢复时 chat:end(paused) 可能已不在 socket replay 缓存中；
     // awaiting_answer 是投影里的持久权威状态，必须据此恢复问答交互。
@@ -3196,14 +3374,17 @@ function addUserMessage(state, content) {
 }
 function upsertTurn(state, turn) {
   let existing = [...state.turns];
-  if (turn.role === "user" && !turn.turn_id.startsWith("local-user-")) {
-    existing = existing.filter((t) => !t.turn_id.startsWith("local-user-"));
+  const [nextTurn] = reconcileOptimisticUserTurns(existing, [turn]);
+  if (nextTurn.client_render_id && turn.role === "user") {
+    existing = existing.filter(
+      (item) => !(item.role === "user" && item.turn_id.startsWith("local-user-"))
+    );
   }
-  const index = existing.findIndex((item) => item.turn_id === turn.turn_id);
+  const index = existing.findIndex((item) => item.turn_id === nextTurn.turn_id);
   if (index >= 0) {
-    existing[index] = turn;
+    existing[index] = nextTurn;
   } else {
-    existing.push(turn);
+    existing.push(nextTurn);
   }
   return withTurns(state, existing);
 }
@@ -3255,18 +3436,18 @@ function markStreamingTurns(state, turnStatus, toolCallStatus) {
 // src/session/agent-session.ts
 var OOM_MESSAGE = "\u6C99\u76D2\u5185\u5B58\u4F7F\u7528\u8D85\u51FA\u9650\u5236\uFF0C\u5DF2\u81EA\u52A8\u91CD\u542F\u3002\u5982\u679C\u7ECF\u5E38\u89E6\u53D1\uFF0C\u53EF\u4EE5\u8054\u7CFB\u7BA1\u7406\u5458\u8C03\u6574\u989D\u5EA6\u3002";
 var OOM_KEYWORDS_RE = /(?:\b(?:exit_code|ExitedWith|exited with)|退出码)\D*(?<!\d)137(?!\d)/i;
-function isRecord5(value) {
+function isRecord6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isOomText(value) {
   return typeof value === "string" && OOM_KEYWORDS_RE.test(value);
 }
 function parseJsonRecord(value) {
-  if (isRecord5(value)) return value;
+  if (isRecord6(value)) return value;
   if (typeof value !== "string") return null;
   try {
     const parsed = JSON.parse(value);
-    return isRecord5(parsed) ? parsed : null;
+    return isRecord6(parsed) ? parsed : null;
   } catch {
     return null;
   }
@@ -3313,7 +3494,7 @@ function hasChatRunEvent2(events) {
   );
 }
 function isUiMetaLike(value) {
-  return isRecord5(value) && ("resourceHTML" in value || "resourceUri" in value || "resourceURI" in value);
+  return isRecord6(value) && ("resourceHTML" in value || "resourceUri" in value || "resourceURI" in value);
 }
 var AgentSession = class _AgentSession {
   sessionId;
@@ -3464,7 +3645,7 @@ var AgentSession = class _AgentSession {
     if (this.getAppContext) {
       try {
         const rawContext = await this.getAppContext();
-        if (!isRecord5(rawContext)) {
+        if (!isRecord6(rawContext)) {
           throw new Error("getContext \u5FC5\u987B\u8FD4\u56DE JSON \u5BF9\u8C61");
         }
         const serialized = JSON.stringify(rawContext);
@@ -3472,7 +3653,7 @@ var AgentSession = class _AgentSession {
           throw new Error("getContext \u5FC5\u987B\u8FD4\u56DE\u53EF\u5E8F\u5217\u5316\u7684 JSON \u5BF9\u8C61");
         }
         const normalized = JSON.parse(serialized);
-        if (!isRecord5(normalized)) {
+        if (!isRecord6(normalized)) {
           throw new Error("getContext \u5FC5\u987B\u8FD4\u56DE JSON \u5BF9\u8C61");
         }
         appContext = normalized;
@@ -3486,13 +3667,11 @@ var AgentSession = class _AgentSession {
     let optimisticTurnId = null;
     let optimisticAskAnswer;
     let previousAskAnswer;
-    if (!(askUserAnswer && typeof askUserAnswer.tool_call_id === "string")) {
-      this.update((state) => {
-        const next = addUserMessage(state, content);
-        optimisticTurnId = next.turns.at(-1)?.turn_id ?? null;
-        return next;
-      });
-    }
+    this.update((state) => {
+      const next = addUserMessage(state, content);
+      optimisticTurnId = next.turns.at(-1)?.turn_id ?? null;
+      return next;
+    });
     this.update((s) => ({ ...s, isStreaming: true }));
     if (askUserAnswer && typeof askUserAnswer.tool_call_id === "string") {
       const { tool_call_id, ...rest } = askUserAnswer;
@@ -3516,7 +3695,8 @@ var AgentSession = class _AgentSession {
       thinking_override: options.thinkingOverride,
       whatif: options.whatif,
       replay_decision: options.replayDecision,
-      app_context: appContext
+      app_context: appContext,
+      kb_ids: options.kbIds && options.kbIds.length > 0 ? options.kbIds : void 0
     };
     try {
       await this.ensureJoined();
@@ -3855,9 +4035,9 @@ var AgentSession = class _AgentSession {
       detail,
       status,
       loopId,
-      metadata: isRecord5(notification.metadata) ? notification.metadata : void 0
+      metadata: isRecord6(notification.metadata) ? notification.metadata : void 0
     });
-    if (notificationType === "bg:started" && isRecord5(notification.metadata)) {
+    if (notificationType === "bg:started" && isRecord6(notification.metadata)) {
       const taskId = typeof notification.metadata.task_id === "string" ? notification.metadata.task_id : "";
       if (taskId) {
         this.emitter.emit("backgroundTask", {
@@ -3987,7 +4167,7 @@ var AgentSession = class _AgentSession {
           title: ui.title ?? "\u5DE5\u5177\u9884\u89C8"
         });
       }
-      if (block.type === "system_notification" && isRecord5(block.content)) {
+      if (block.type === "system_notification" && isRecord6(block.content)) {
         this._handleSystemNotification(turn.loop_id, block.content);
       }
     }
@@ -4471,7 +4651,7 @@ function resolveAuthToken(options) {
 
 // src/version.ts
 var SDK_NAME = "agent-client";
-var SDK_VERSION = true ? "2610.0.0-beta.2" : "1.1.1";
+var SDK_VERSION = true ? "2610.0.0-beta.21" : "1.1.1";
 
 // src/socket.ts
 function withSdkIdentity(auth) {
@@ -4864,6 +5044,89 @@ function parseXhrHeaders(rawHeaders) {
   return headers;
 }
 
+// src/platform-endpoints.ts
+var PLATFORM_SERVICE_NAMES = [
+  "os",
+  "hub",
+  "agent",
+  "oauth",
+  "llmGateway",
+  "gitea",
+  "tile"
+];
+var EMPTY_PLATFORM_ENDPOINTS = Object.freeze({
+  services: Object.freeze({})
+});
+function defaultDocumentBaseUrl() {
+  if (typeof document === "undefined") return void 0;
+  if (document.querySelector("base[href]")) return document.baseURI;
+  if (typeof location !== "undefined" && location.origin) return `${location.origin}/`;
+  return document.baseURI;
+}
+function isRecord7(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function normalizeServiceUrl(value) {
+  if (typeof value !== "string" || !value.trim()) return null;
+  if (value.includes("?") || value.includes("#")) return null;
+  try {
+    const url = new URL(value.trim());
+    if (url.protocol !== "http:" && url.protocol !== "https:") return null;
+    if (url.username || url.password || url.search || url.hash) return null;
+    return url.toString().replace(/\/$/, "");
+  } catch {
+    return null;
+  }
+}
+function parsePlatformEndpoints(value) {
+  if (!isRecord7(value) || !isRecord7(value.services)) return null;
+  const services = {};
+  for (const name of PLATFORM_SERVICE_NAMES) {
+    if (!(name in value.services)) continue;
+    const url = normalizeServiceUrl(value.services[name]);
+    if (!url) return null;
+    if (name === "agent" && new URL(url).pathname !== "/") return null;
+    services[name] = url;
+  }
+  return { services };
+}
+async function loadPlatformEndpoints(options = {}) {
+  const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+  const baseUrl = options.baseUrl ?? defaultDocumentBaseUrl();
+  if (!fetchImpl || !baseUrl) return EMPTY_PLATFORM_ENDPOINTS;
+  const controller = new AbortController();
+  const timeout = globalThis.setTimeout(() => controller.abort(), options.timeoutMs ?? 3e3);
+  try {
+    const response = await fetchImpl(new URL("config.json", baseUrl), {
+      cache: "no-store",
+      credentials: "same-origin",
+      headers: { Accept: "application/json" },
+      signal: controller.signal
+    });
+    if (!response.ok) return EMPTY_PLATFORM_ENDPOINTS;
+    return parsePlatformEndpoints(await response.json()) ?? EMPTY_PLATFORM_ENDPOINTS;
+  } catch {
+    return EMPTY_PLATFORM_ENDPOINTS;
+  } finally {
+    globalThis.clearTimeout(timeout);
+  }
+}
+function resolveServiceUrl(endpoints, name, path = "") {
+  const baseUrl = endpoints.services[name];
+  if (!baseUrl) return null;
+  if (!path) return baseUrl;
+  const pathReference = path.trimStart();
+  if (path.includes("\\") || pathReference.startsWith("//") || /^[a-z][a-z0-9+.-]*:/i.test(pathReference)) {
+    return null;
+  }
+  const base = new URL(`${baseUrl}/`);
+  const target = new URL(path.replace(/^\/+/, ""), base);
+  if (target.origin !== base.origin || !target.pathname.startsWith(base.pathname)) {
+    return null;
+  }
+  return target.toString();
+}
+
 // src/commands/protocol.ts
 function isCommandEnvelope(value) {
   if (typeof value !== "object" || value === null) return false;
@@ -4968,6 +5231,7 @@ export {
   BladeClient,
   ClientProjectionBuilder,
   DEFAULT_REPLAY_SPEED,
+  EMPTY_PLATFORM_ENDPOINTS,
   LayoutType,
   ModelsResource,
   SDK_NAME,
@@ -4982,9 +5246,11 @@ export {
   buildMessageContent,
   connectEmbedded,
   contentPreview,
+  contextProjectionData,
   createInitialSessionState,
   createSocket,
   extractTextAttachments,
+  getContextDisplayState,
   getFileParts,
   getImageParts,
   getTextContent,
@@ -4993,7 +5259,10 @@ export {
   isHiddenInternalMessage,
   isInboundEnvelope,
   latestPostChatFollowup,
+  loadPlatformEndpoints,
   normalizeMessageContent,
+  reconcileOptimisticUserTurns,
+  resolveServiceUrl,
   toReplaySnapshot,
   transformSlashCommand
 };