@blade-hq/agent-client 2610.0.0-beta.28 → 2610.0.0-beta.29

package/README.md

@@ -289,6 +289,40 @@ 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, ... }
+
+await client.computers.setEnabled(sessionId, computer.id, true)   // 启动
+await client.computers.setEnabled(sessionId, computer.id, false)  // 停用
+```
+
+`online` 和 `enabled` 是**两件独立的事**：前者指那台电脑此刻连着后端，后者指这次会话已经启动了它。
+离线的电脑也能先启动，等它连上就直接可用。`online` 由服务端读心跳时间判定，不做实时探测，
+所以电脑离线时列表照样返回它——你拿得到「它离线了」这个结论。
+
+`is_primary` 表示这次会话本身就跑在这台电脑上。这种电脑恒为可用，也不能停用——
+那是会话自己的工作目录所在。
+
+做电脑选择器时用这几个纯函数，别自己重算状态：
+
+```ts
+import { canToggleComputer, computerState, sortComputers } from "@blade-hq/agent-client"
+
+sortComputers(computers)      // 可用的在前，其次在线的，最后按名字
+computerState(computer)       // ComputerState: "primary" | "enabled" | "offline" | "idle"
+canToggleComputer(computer)   // 主运行时返回 false
+```
+
+`ComputersResource` 是 `client.computers` 的类型。
+
 ## AgentSession
 
 一个会话的实时状态机。**状态归属实例**：同一页面建多个会话互不干扰。

package/dist/blade-client.d.ts

@@ -2,6 +2,7 @@ import { type LoginOptions, type LoginResult, type TokenStorageMode } from "./au
 import { type BladeFetchInit, type HttpMethod } from "./rest";
 import { AuthResource } from "./resources/auth";
 import { HeadlessResource } from "./resources/headless";
+import { ComputersResource } from "./resources/computers";
 import { ModelsResource } from "./resources/models";
 import { SessionsResource } from "./resources/sessions";
 import { SessionHub } from "./session/hub";
@@ -33,6 +34,7 @@ export declare class BladeClient {
     readonly options: BladeClientOptions;
     readonly auth: AuthResource;
     readonly headless: HeadlessResource;
+    readonly computers: ComputersResource;
     readonly models: ModelsResource;
     readonly sessions: SessionsResource;
     /** 实时会话中枢：client.sessions.connect() 内部使用，一般不直接访问。 */

package/dist/index.d.ts

@@ -20,6 +20,9 @@ export type { CommandEnvelope, InboundAction, InboundEnvelope } from "./commands
 export { isCommandEnvelope, isInboundEnvelope } from "./commands/protocol";
 export type { AuthResource, ExchangeCodeParams, ExchangeCodeResult, ProvidersResponse, UserInfo, } from "./resources/auth";
 export type { HeadlessResource } from "./resources/headless";
+export { ComputersResource } from "./resources/computers";
+export { canToggleComputer, computerState, sortComputers, } from "./resources/computers";
+export type { ComputerState, SessionComputer, SessionComputerList, } from "./resources/computers";
 export { ModelsResource } from "./resources/models";
 export type { ModelCatalog, ModelOption } from "./resources/models";
 export type { SessionsResource } from "./resources/sessions";

package/dist/index.js

@@ -424,6 +424,50 @@ function ensureSocketConnected(socket, timeoutMs, detail) {
   });
 }
 
+// src/resources/computers.ts
+function computerState(computer) {
+  if (computer.is_primary) return "primary";
+  if (computer.enabled) return "enabled";
+  return computer.online ? "idle" : "offline";
+}
+function canToggleComputer(computer) {
+  return !computer.is_primary;
+}
+function sortComputers(computers) {
+  return [...computers].sort((a, b) => {
+    if (a.enabled !== b.enabled) return a.enabled ? -1 : 1;
+    if (a.online !== b.online) return a.online ? -1 : 1;
+    return a.label.localeCompare(b.label);
+  });
+}
+var ComputersResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * 列出当前用户的全部电脑，带上"在不在线"和"这次会话能不能用"。
+   * 服务端只查库，电脑离线时同样返回，所以拿得到"它离线了"这个结论。
+   */
+  list(sessionId) {
+    return this.client.json(
+      "GET",
+      `/api/sessions/${encodeURIComponent(sessionId)}/computers`
+    );
+  }
+  /**
+   * 启动或停止一台电脑。只改这次会话的可用范围，不会碰远程机器，
+   * 电脑离线时同样能登记，等它上线就直接可用。
+   */
+  setEnabled(sessionId, computer, enabled) {
+    return this.client.json(
+      "PUT",
+      `/api/sessions/${encodeURIComponent(sessionId)}/computers/${encodeURIComponent(computer)}/enabled`,
+      { enabled }
+    );
+  }
+};
+
 // src/resources/models.ts
 var ModelsResource = class {
   constructor(client) {
@@ -4701,7 +4745,7 @@ function resolveAuthToken(options) {
 
 // src/version.ts
 var SDK_NAME = "agent-client";
-var SDK_VERSION = true ? "2610.0.0-beta.28" : "1.1.1";
+var SDK_VERSION = true ? "2610.0.0-beta.29" : "1.1.1";
 
 // src/socket.ts
 function withSdkIdentity(auth) {
@@ -4729,6 +4773,7 @@ var BladeClient = class {
   options;
   auth;
   headless;
+  computers;
   models;
   sessions;
   /** 实时会话中枢：client.sessions.connect() 内部使用，一般不直接访问。 */
@@ -4740,6 +4785,7 @@ var BladeClient = class {
     };
     this.auth = new AuthResource(this);
     this.headless = new HeadlessResource(this);
+    this.computers = new ComputersResource(this);
     this.models = new ModelsResource(this);
     this.sessions = new SessionsResource(this);
     this.hub = new SessionHub(this);
@@ -5280,6 +5326,7 @@ export {
   BladeApiError,
   BladeClient,
   ClientProjectionBuilder,
+  ComputersResource,
   DEFAULT_REPLAY_SPEED,
   EMPTY_PLATFORM_ENDPOINTS,
   LayoutType,
@@ -5294,6 +5341,8 @@ export {
   TaskStatus,
   acceptedPostChatFollowupCompletesLatestRun,
   buildMessageContent,
+  canToggleComputer,
+  computerState,
   connectEmbedded,
   contentPreview,
   contextProjectionData,
@@ -5313,6 +5362,7 @@ export {
   normalizeMessageContent,
   reconcileOptimisticUserTurns,
   resolveServiceUrl,
+  sortComputers,
   toReplaySnapshot,
   transformSlashCommand
 };