@blade-hq/agent-client 2612.0.0-beta.47 → 2612.0.0-beta.49

package/README.md

@@ -431,24 +431,23 @@ const body = { model: defaultServiceModel, messages, stream: true }
 ### 远程电脑：client.computers
 
 一个会话除了自己的运行时，还可以操作用户接入的其他电脑（`blade daemon connect` 接进来的机器）。
-**默认一台都不能用**，要先为这次会话启动它。
+**用户接入的电脑默认在本次会话可用**，可以按会话停用。
 
 ```ts
 const { computers } = await client.computers.list(sessionId)
 // SessionComputerList → { computers: SessionComputer[] }
 // SessionComputer: { id, label, os, arch, home, workspace, allowed_paths,
-//                    online, enabled, is_primary, last_seen_at, ... }
+//                    online, enabled, last_seen_at, ... }
 
 await client.computers.setEnabled(sessionId, computer.id, true)   // 启动
 await client.computers.setEnabled(sessionId, computer.id, false)  // 停用
 ```
 
-`online` 和 `enabled` 是**两件独立的事**：前者指那台电脑此刻连着后端，后者指这次会话已经启动了它。
+`online` 和 `enabled` 是**两件独立的事**：前者指那台电脑此刻连着后端，后者指这次会话允许使用它（默认启用，显式停用优先）。
 离线的电脑也能先启动，等它连上就直接可用。`online` 由服务端读心跳时间判定，不做实时探测，
 所以电脑离线时列表照样返回它——你拿得到「它离线了」这个结论。
 
-`is_primary` 表示这次会话本身就跑在这台电脑上。这种电脑恒为可用，也不能停用——
-那是会话自己的工作目录所在。
+智能体与会话工作目录始终在沙盒，远程电脑只提供命令、文件与画面能力。
 
 `ComputersResource` 是 `client.computers` 的类型。
 
@@ -968,3 +967,30 @@ await client.auth.exchangeCode({ code, state, clientOrigin, codeVerifier, androi
 ```
 
 `state` 必须与发起请求时一致；PA 还须校验自身登录请求 cookie。访问令牌保存在自己的服务端，不能通过回调 URL 或网页消息转发。手机端回传及部署约定见仓库 `docs/specs/261026-android-browser-login/`。
+
+### 原生提问和回答
+
+`parseAskUserQuestion` 解析 `AskUserQuestion` 的工具参数或结果，返回 `AskUserQuestionData`。每个 `AskUserQuestionItem` 包含问题、`AskUserQuestionOption` 选项和可选多选标记。组件和后端共享这些定义，支持历史中的字符串选项与 `multi_select` 字段。
+
+`formatAskUserAnswer` 根据问题及 `AskUserAnswerData` 生成用户可读文本；回答应送回原始会话和工具调用。`getState().askAnswers` 同时从实时事件和历史恢复已回答内容。`sendPrepared` 是普通输入队列，不能代替原生回答。
+
+```ts
+const question = parseAskUserQuestion(toolCall.arguments)
+if (question) {
+  const answer = { selections: { 0: [1] }, custom: {} }
+  const accepted = await session.send(formatAskUserAnswer(question, answer), {
+    askUserAnswer: { tool_call_id: toolCall.id, ...answer },
+  })
+  // 只有 accepted 为 true，才能把此次投递视为服务端已接收。
+}
+```
+
+### 桌面系统浏览器回传
+
+Electron 主进程负责临时监听 `http://127.0.0.1:<port>/auth/callback`，并用
+`desktop_app=ba|pa`、`callback_uri`、`code_challenge`（S256）、`state` 和
+`client_origin` 请求 `/api/auth/sdk/authorize`。平台和回调绑定不可省略或改写。
+服务端通过 `auth.exchangeCode({ code, state, clientOrigin, codeVerifier,
+desktopApp: "pa", callbackUri })` 换码；PA 的 PAT 留在服务端。
+BA 桌面使用同源 `/api/auth/sdk/desktop-session` 建立自身 cookie 会话。
+`auth.login()` 仍是普通浏览器的弹窗登录，不负责本机监听。

package/dist/{chunk-GYJFPRM3.js → chunk-NNYV4ZVA.js}

@@ -224,7 +224,7 @@ var ToolProvider = class {
 
 // src/version.ts
 var SDK_NAME = "agent-client";
-var SDK_VERSION = true ? "2612.0.0-beta.47" : "1.1.1";
+var SDK_VERSION = true ? "2612.0.0-beta.49" : "1.1.1";
 
 // src/auth-login.ts
 function isAuthCallbackMessage(value) {
@@ -378,7 +378,7 @@ var AuthResource = class {
       headers: { Origin: params.clientOrigin },
       body: JSON.stringify({
         code: params.code,
-        ...params.codeVerifier ? { code_verifier: params.codeVerifier, android_app: params.androidApp } : {},
+        ...params.codeVerifier ? { code_verifier: params.codeVerifier, android_app: params.androidApp, desktop_app: params.desktopApp, callback_uri: params.callbackUri } : {},
         state: params.state,
         client_origin: params.clientOrigin
       })
@@ -8616,7 +8616,7 @@ function encode(input) {
     if (value && typeof value === "object")
       return [
         "dict",
-        Object.entries(value).map(([key, item]) => [key, walk(item)])
+        Object.entries(value).filter(([, item]) => item !== void 0).map(([key, item]) => [key, walk(item)])
       ];
     return ["value", value ?? null];
   };
@@ -9145,6 +9145,67 @@ var ApplicationProviderSocket = class extends Events {
   }
 };
 
+// src/schemas/ask-user-question.ts
+function parseAskUserQuestion(toolResult) {
+  if (!toolResult) return null;
+  try {
+    const parsed = JSON.parse(toolResult);
+    let questions = parsed?.questions;
+    if (typeof questions === "string") {
+      try {
+        questions = JSON.parse(questions);
+      } catch {
+        return null;
+      }
+    }
+    if (Array.isArray(questions) && questions.length > 0) {
+      const normalized = questions.map(normalizeQuestionItem);
+      if (normalized.every((question) => question !== null)) {
+        return { ...parsed, questions: normalized };
+      }
+    }
+  } catch {
+  }
+  return null;
+}
+function formatAskUserAnswer(data, answer) {
+  const parts = data.questions.map((question, index) => {
+    const text = typeof answer.custom[index] === "string" ? answer.custom[index].trim() : [...answer.selections[index] ?? []].sort((a, b) => a - b).map((optionIndex) => question.options[optionIndex].label).join(", ");
+    return `- ${question.question} -> ${indentAnswerContinuationLines(text)}`;
+  });
+  const note = answer.note?.trim() ?? "";
+  return [
+    `\u5173\u4E8E\u9700\u8981\u786E\u8BA4\u7684\u95EE\u9898\uFF0C\u7528\u6237\u7684\u56DE\u7B54\u5982\u4E0B\uFF1A
+${parts.join("\n")}`,
+    note ? `\u8865\u5145\u8BF4\u660E\uFF1A${indentAnswerContinuationLines(note)}` : ""
+  ].filter(Boolean).join("\n");
+}
+function indentAnswerContinuationLines(answer) {
+  return answer.replaceAll("\n", "\n  ");
+}
+function normalizeQuestionItem(value) {
+  if (!value || typeof value !== "object") return null;
+  const item = value;
+  if (typeof item.question !== "string" || !Array.isArray(item.options)) return null;
+  const options = item.options.map(normalizeOptionItem);
+  if (!options.every((option) => option !== null)) return null;
+  return {
+    question: item.question,
+    options,
+    multiSelect: item.multiSelect === true || item.multi_select === true
+  };
+}
+function normalizeOptionItem(value) {
+  if (typeof value === "string") return { label: value, description: "" };
+  if (!value || typeof value !== "object") return null;
+  const option = value;
+  if (typeof option.label !== "string") return null;
+  return {
+    label: option.label,
+    description: typeof option.description === "string" ? option.description : ""
+  };
+}
+
 export {
   SandboxResource,
   BladeApiError,
@@ -9238,6 +9299,8 @@ export {
   SessionHub,
   createSocket,
   BladeClient,
-  BladeApplicationClient
+  BladeApplicationClient,
+  parseAskUserQuestion,
+  formatAskUserAnswer
 };
-//# sourceMappingURL=chunk-GYJFPRM3.js.map
+//# sourceMappingURL=chunk-NNYV4ZVA.js.map