@clawos-dev/clawd 0.2.543 → 0.2.545

package/dist/app-builder-plugin/mcp-server.cjs

@@ -24201,6 +24201,11 @@ var METHOD_DOCS = {
     summary: "\u586B\u5199\u578B\u8FDE\u63A5\u5668\uFF1A\u628A\u4F7F\u7528\u8005\u672C\u4EBA\u7684\u51ED\u636E\u503C\u4EA4\u7ED9\u4E2D\u5FC3\u52A0\u5BC6\u5165\u5E93\uFF08\u4E00\u6B21\u586B\u5199\u5168\u5C40\u5171\u7528\uFF09\u3002**\u8FD9\u662F\u503C\u552F\u4E00\u7684\u5165\u53E3**\uFF1A\u5165\u53C2\u4E0D\u8FDB\u65E5\u5FD7\u3001\u54CD\u5E94\u4E0D\u56DE\u663E\u3001\u672C\u673A\u4E0D\u843D\u76D8\uFF1B\u683C\u540D\u5FC5\u987B\u662F\u8BE5\u8FDE\u63A5\u5668\u58F0\u660E\u8FC7\u7684\uFF1Bowner-only",
     args: CloudConnectorFillArgsSchema
   },
+  // ---- cloud:volume:get（云上会话聊天页顶栏的云盘角标；design 2026-09-19-cloud-volume-usage §3.3）----
+  "cloud:volume:get": {
+    summary: "\u8C03\u7528\u65B9\u81EA\u5DF1\u90A3\u5757\u4E91\u76D8\u4E0A\u4E00\u8F6E\u672B\u7684\u7528\u91CF\uFF08usedBytes / sizeBytes / measuredAt\uFF09\u3002\u6309\u4EBA\u4E0D\u6309 persona\uFF1A\u4E91\u4E0A\u6240\u6709 persona \u5171\u7528\u4E00\u5757\u76D8\u3002daemon \u62FF\u672C\u673A api key \u95EE gateway /me/volume\uFF1B\u6CA1\u767B\u5F55 / \u6CA1 key / gateway \u4E0D\u901A / \u6CA1\u8DD1\u8FC7\u4EFB\u52A1\u4E00\u5F8B\u56DE volume:null\uFF08\u89D2\u6807\u4E0D\u6E32\uFF09\uFF0C\u4E0D\u629B\uFF1Bowner-only\u3002\u65E0\u53C2\u6570\uFF08\u67E5\u7684\u662F\u8C03\u7528\u65B9\u81EA\u5DF1\u7684\u76D8\uFF09",
+    args: NO_ARGS
+  },
   "shift:list": {
     summary: "\u5217\u51FA owner \u7684\u5168\u90E8 shift\uFF08\u6392\u73ED\uFF09\uFF0C\u7ED9 UI \u65E5\u5386\u6E32\u67D3\u7528\uFF1Bowner-only",
     args: NO_ARGS
@@ -24645,6 +24650,19 @@ var MetaMethodsResultSchema = external_exports.object({
   methods: external_exports.array(RpcMethodInfoSchema)
 });
 
+// ../protocol/src/cloud-volume-schemas.ts
+var CloudVolumeUsageSchema = external_exports.object({
+  /** 已用字节（df 的 Used 列） */
+  usedBytes: external_exports.number().int().nonnegative(),
+  /** 盘的总字节（df 的 1B-blocks 列；ext4 预留之后比 PVC 的 5Gi 略小） */
+  sizeBytes: external_exports.number().int().positive(),
+  /** 量的时刻（ms）= 上一轮结束时 */
+  measuredAt: external_exports.number().int().nonnegative()
+}).strict();
+var CloudVolumeGetResultSchema = external_exports.object({
+  volume: CloudVolumeUsageSchema.nullable()
+}).strict();
+
 // ../protocol/src/log.ts
 var LOG_SOURCES = ["daemon", "main", "renderer"];
 var LogSourceSchema = external_exports.enum(LOG_SOURCES);

package/dist/cli.cjs

@@ -9028,6 +9028,11 @@ var init_methods = __esm({
         summary: "\u586B\u5199\u578B\u8FDE\u63A5\u5668\uFF1A\u628A\u4F7F\u7528\u8005\u672C\u4EBA\u7684\u51ED\u636E\u503C\u4EA4\u7ED9\u4E2D\u5FC3\u52A0\u5BC6\u5165\u5E93\uFF08\u4E00\u6B21\u586B\u5199\u5168\u5C40\u5171\u7528\uFF09\u3002**\u8FD9\u662F\u503C\u552F\u4E00\u7684\u5165\u53E3**\uFF1A\u5165\u53C2\u4E0D\u8FDB\u65E5\u5FD7\u3001\u54CD\u5E94\u4E0D\u56DE\u663E\u3001\u672C\u673A\u4E0D\u843D\u76D8\uFF1B\u683C\u540D\u5FC5\u987B\u662F\u8BE5\u8FDE\u63A5\u5668\u58F0\u660E\u8FC7\u7684\uFF1Bowner-only",
         args: CloudConnectorFillArgsSchema
       },
+      // ---- cloud:volume:get（云上会话聊天页顶栏的云盘角标；design 2026-09-19-cloud-volume-usage §3.3）----
+      "cloud:volume:get": {
+        summary: "\u8C03\u7528\u65B9\u81EA\u5DF1\u90A3\u5757\u4E91\u76D8\u4E0A\u4E00\u8F6E\u672B\u7684\u7528\u91CF\uFF08usedBytes / sizeBytes / measuredAt\uFF09\u3002\u6309\u4EBA\u4E0D\u6309 persona\uFF1A\u4E91\u4E0A\u6240\u6709 persona \u5171\u7528\u4E00\u5757\u76D8\u3002daemon \u62FF\u672C\u673A api key \u95EE gateway /me/volume\uFF1B\u6CA1\u767B\u5F55 / \u6CA1 key / gateway \u4E0D\u901A / \u6CA1\u8DD1\u8FC7\u4EFB\u52A1\u4E00\u5F8B\u56DE volume:null\uFF08\u89D2\u6807\u4E0D\u6E32\uFF09\uFF0C\u4E0D\u629B\uFF1Bowner-only\u3002\u65E0\u53C2\u6570\uFF08\u67E5\u7684\u662F\u8C03\u7528\u65B9\u81EA\u5DF1\u7684\u76D8\uFF09",
+        args: NO_ARGS
+      },
       "shift:list": {
         summary: "\u5217\u51FA owner \u7684\u5168\u90E8 shift\uFF08\u6392\u73ED\uFF09\uFF0C\u7ED9 UI \u65E5\u5386\u6E32\u67D3\u7528\uFF1Bowner-only",
         args: NO_ARGS
@@ -9534,6 +9539,26 @@ var init_frames = __esm({
   }
 });
 
+// ../protocol/src/cloud-volume-schemas.ts
+var CloudVolumeUsageSchema, CloudVolumeGetResultSchema;
+var init_cloud_volume_schemas = __esm({
+  "../protocol/src/cloud-volume-schemas.ts"() {
+    "use strict";
+    init_zod();
+    CloudVolumeUsageSchema = external_exports.object({
+      /** 已用字节（df 的 Used 列） */
+      usedBytes: external_exports.number().int().nonnegative(),
+      /** 盘的总字节（df 的 1B-blocks 列；ext4 预留之后比 PVC 的 5Gi 略小） */
+      sizeBytes: external_exports.number().int().positive(),
+      /** 量的时刻（ms）= 上一轮结束时 */
+      measuredAt: external_exports.number().int().nonnegative()
+    }).strict();
+    CloudVolumeGetResultSchema = external_exports.object({
+      volume: CloudVolumeUsageSchema.nullable()
+    }).strict();
+  }
+});
+
 // ../protocol/src/persona-mode.ts
 var init_persona_mode = __esm({
   "../protocol/src/persona-mode.ts"() {
@@ -9705,6 +9730,7 @@ var init_runtime = __esm({
     init_frames();
     init_environment_schemas();
     init_cloud_connector_schemas();
+    init_cloud_volume_schemas();
     init_deploy_schemas();
     init_github_auth_schemas();
     init_persona_schemas();
@@ -62471,7 +62497,9 @@ var GATEWAY_ROUTES = {
   session: (personaId2) => `/p/${encodeURIComponent(personaId2)}/session`,
   sessionSend: (personaId2, sessionId) => `/p/${encodeURIComponent(personaId2)}/session/${encodeURIComponent(sessionId)}`,
   // 历史文件不挂在 persona 下：使用者卷跨 persona 共用（design 2026-09-14-codex-native-memories §3.2f）
-  thread: (threadId) => `/threads/${encodeURIComponent(threadId)}`
+  thread: (threadId) => `/threads/${encodeURIComponent(threadId)}`,
+  // 调用方自己那块盘的用量（design 2026-09-19-cloud-volume-usage §3.3）：同样按人、不挂 persona
+  volume: () => "/me/volume"
 };
 var trimSlash = (u2) => u2.replace(/\/+$/, "");
 var CloudApiKeyRequiredError = class extends Error {
@@ -62522,6 +62550,10 @@ var CloudGatewayClient = class {
   }
   async listPersonas() {
     const { gatewayUrl } = await this.locate();
+    return this.fetchDeployments(gatewayUrl);
+  }
+  /** /healthz 的登记表 → official 行。gatewayUrl 由调用方定：listPersonas 从中心拿，personaConnectors 用 persona 文件里的 */
+  async fetchDeployments(gatewayUrl) {
     const res = await this.fetchImpl(gatewayUrl + GATEWAY_ROUTES.healthz());
     if (!res.ok) throw new Error(`gateway /healthz \u56DE ${res.status}`);
     const body = await res.json();
@@ -62543,9 +62575,13 @@ var CloudGatewayClient = class {
     }
     return out;
   }
-  /** gateway 登记行上这个 persona（gateway 名）装了哪些连接器；没这行 = 空 */
-  async personaConnectors(gatewayPersonaId) {
-    const list = await this.listPersonas();
+  /**
+   * gateway 登记行上这个 persona（gateway 名）装了哪些连接器；没这行 = 空。
+   * gatewayUrl 从 persona 文件的 cloud.gatewayUrl 来，**不经 locate()**：那一跳只为拿同一个地址，
+   * 远端网络下白等 ~1s（design 2026-09-19-cloud-connectors-skip-locate）。/healthz 不看票，这里也不要求登录。
+   */
+  async personaConnectors(gatewayPersonaId, gatewayUrl) {
+    const list = await this.fetchDeployments(trimSlash(gatewayUrl));
     return list.find((p3) => p3.personaId === gatewayPersonaId)?.connectors ?? [];
   }
   /**
@@ -62562,6 +62598,20 @@ var CloudGatewayClient = class {
       logger: this.deps.logger
     });
   }
+  /**
+   * 这个人云盘上一轮末的用量（design 2026-09-19-cloud-volume-usage §3.3）。gateway 回 `volume: null` = 还没跑过任务（没有盘）。
+   * 没登录 / 没 key 走 credentials() 的抛法，调用方（cloud:volume:get 的 handler）把它们和网络错一并折成 null——角标不该弹错。
+   */
+  async fetchVolume() {
+    const { apiKey, gatewayUrl } = await this.credentials();
+    const res = await this.fetchImpl(gatewayUrl + GATEWAY_ROUTES.volume(), {
+      headers: { authorization: `Bearer ${apiKey}` }
+    });
+    if (!res.ok) throw new Error(`gateway /me/volume \u56DE ${res.status}`);
+    const body = await res.json();
+    if (body.volume == null) return null;
+    return CloudVolumeUsageSchema.parse(body.volume);
+  }
   /** rollout 原文；404 = 没这条 thread（还没开过第一轮 / 卷被清）→ null */
   async fetchRollout(threadId) {
     const { apiKey, gatewayUrl } = await this.credentials();
@@ -70582,7 +70632,7 @@ function buildCloudConnectorsHandlers(deps) {
     const persona = deps.getPersona(personaId2);
     if (!persona) throw new ClawdError(ERROR_CODES.PERSONA_NOT_FOUND, `PERSONA_NOT_FOUND: \u6CA1\u6709\u8FD9\u4E2A persona\uFF08${personaId2}\uFF09`);
     if (!persona.cloud) throw invalid2(`${personaId2} \u4E0D\u662F\u4E91\u4E0A persona\uFF0C\u6CA1\u6709\u8FDE\u63A5\u5668\u533A`);
-    const all = await deps.gatewayConnectors(persona.cloud.personaId);
+    const all = await deps.gatewayConnectors(persona.cloud.personaId, persona.cloud.gatewayUrl);
     return { gatewayPersonaId: persona.cloud.personaId, connectors: all.filter((c2) => c2.credentialSource === "personal") };
   }
   const list = async (frame, _client, ctx) => {
@@ -70612,6 +70662,30 @@ function buildCloudConnectorsHandlers(deps) {
   };
 }
 
+// src/handlers/cloud-volume.ts
+init_protocol();
+function ensureOwner7(ctx) {
+  if (!ctx || ctx.principal.kind !== "owner") {
+    throw new ClawdError(ERROR_CODES.UNAUTHORIZED, "UNAUTHORIZED: cloud:volume:get requires owner ctx");
+  }
+}
+function buildCloudVolumeHandlers(deps) {
+  const get = async (_frame, _client, ctx) => {
+    ensureOwner7(ctx);
+    let volume = null;
+    if (deps.getLoginPass()) {
+      try {
+        volume = await deps.fetchVolume();
+      } catch (err) {
+        deps.logger?.debug("cloud:volume:get skipped", { reason: err.message });
+        volume = null;
+      }
+    }
+    return { response: { type: "cloud:volume:get:ok", volume } };
+  };
+  return { "cloud:volume:get": get };
+}
+
 // src/handlers/meta.ts
 var import_node_os23 = __toESM(require("os"), 1);
 init_protocol();
@@ -70671,6 +70745,8 @@ var METHOD_GRANT_MAP = {
   // 拿本机登录凭证向中心代查 / 代填使用者本人的凭据，guest 一律够不着
   "cloud:connectors:list": ADMIN_ANY,
   "cloud:connectors:fill": ADMIN_ANY,
+  // cloud:volume:get（云上会话顶栏的云盘角标；design 2026-09-19-cloud-volume-usage）：本机 api key 问 gateway，guest 够不着
+  "cloud:volume:get": ADMIN_ANY,
   // ---- session:* / chat:* 业务方法（v2 Phase 8 两层模型）----
   // dispatcher 不验资源，handler 内按 ctx + frame.args 反查 ownerPersonaId 调 assertGrant。
   // owner 自动通过（ctx 自带 '*':'admin' grant 一切 match）；guest 在被授权 persona 内可调。
@@ -70919,7 +70995,7 @@ function computeMethodAccess(args) {
 }
 
 // src/version.ts
-var version = "0.2.543".length > 0 ? "0.2.543" : "dev";
+var version = "0.2.545".length > 0 ? "0.2.545" : "dev";
 
 // src/cli-probe/probe.ts
 var fs78 = __toESM(require("fs"), 1);
@@ -72578,7 +72654,7 @@ function buildGithubHandlers(deps) {
 
 // src/handlers/visitor.ts
 init_protocol();
-function ensureOwner7(ctx) {
+function ensureOwner8(ctx) {
   if (!ctx || ctx.principal.kind !== "owner") {
     throw new ClawdError(
       ERROR_CODES.UNAUTHORIZED,
@@ -72588,7 +72664,7 @@ function ensureOwner7(ctx) {
 }
 function buildVisitorHandlers(deps) {
   const list = async (_frame, _client, ctx) => {
-    ensureOwner7(ctx);
+    ensureOwner8(ctx);
     return {
       response: {
         type: "visitor:list",
@@ -72874,6 +72950,7 @@ function buildMethodHandlers(deps) {
     ...buildFeishuAuthHandlers(deps.feishuAuth),
     ...buildDeviceHandlers(deps.feishuDevice),
     ...buildCloudConnectorsHandlers(deps.cloudConnectors),
+    ...buildCloudVolumeHandlers(deps.cloudVolume),
     ...deps.attachment ? buildAttachmentHandlers(deps.attachment) : {},
     ...buildExtensionHandlers({
       loadAll,
@@ -74508,13 +74585,19 @@ async function startDaemon(config) {
       // 连没连上问中心。登录票只在 daemon 内部传给中心，与 apiKeyClient 同一条纪律。
       cloudConnectors: {
         getPersona: (personaId2) => personaRegistry.get(personaId2),
-        gatewayConnectors: (gatewayPersonaId) => cloudGateway.personaConnectors(gatewayPersonaId),
+        gatewayConnectors: (gatewayPersonaId, gatewayUrl) => cloudGateway.personaConnectors(gatewayPersonaId, gatewayUrl),
         getLoginPass: () => ownerIdentityStore.read()?.loginPass ?? null,
         central: {
           mine: (args) => centralConnectorsMine({ api: config.clawosApi ?? DEFAULT_CLAWOS_API, ...args }),
           fill: (args) => centralConnectorFill({ api: config.clawosApi ?? DEFAULT_CLAWOS_API, ...args })
         }
       },
+      // 云盘角标（design 2026-09-19-cloud-volume-usage）：拿不到一律 null，handler 自己折
+      cloudVolume: {
+        getLoginPass: () => ownerIdentityStore.read()?.loginPass ?? null,
+        fetchVolume: () => cloudGateway.fetchVolume(),
+        logger
+      },
       // 设备目录 + 连接（决策 #15：daemon 代理中心 server）。
       // exchange/listDevices 包掉本机登录票（每次现读 store——热切换后立即用新身份）；
       // dispatcher 的 FEISHU_GATED_METHODS gate 已保证未登录时这些 RPC 到不了 handler，

package/dist/dispatch/mcp-server.cjs

@@ -24016,6 +24016,11 @@ var METHOD_DOCS = {
     summary: "\u586B\u5199\u578B\u8FDE\u63A5\u5668\uFF1A\u628A\u4F7F\u7528\u8005\u672C\u4EBA\u7684\u51ED\u636E\u503C\u4EA4\u7ED9\u4E2D\u5FC3\u52A0\u5BC6\u5165\u5E93\uFF08\u4E00\u6B21\u586B\u5199\u5168\u5C40\u5171\u7528\uFF09\u3002**\u8FD9\u662F\u503C\u552F\u4E00\u7684\u5165\u53E3**\uFF1A\u5165\u53C2\u4E0D\u8FDB\u65E5\u5FD7\u3001\u54CD\u5E94\u4E0D\u56DE\u663E\u3001\u672C\u673A\u4E0D\u843D\u76D8\uFF1B\u683C\u540D\u5FC5\u987B\u662F\u8BE5\u8FDE\u63A5\u5668\u58F0\u660E\u8FC7\u7684\uFF1Bowner-only",
     args: CloudConnectorFillArgsSchema
   },
+  // ---- cloud:volume:get（云上会话聊天页顶栏的云盘角标；design 2026-09-19-cloud-volume-usage §3.3）----
+  "cloud:volume:get": {
+    summary: "\u8C03\u7528\u65B9\u81EA\u5DF1\u90A3\u5757\u4E91\u76D8\u4E0A\u4E00\u8F6E\u672B\u7684\u7528\u91CF\uFF08usedBytes / sizeBytes / measuredAt\uFF09\u3002\u6309\u4EBA\u4E0D\u6309 persona\uFF1A\u4E91\u4E0A\u6240\u6709 persona \u5171\u7528\u4E00\u5757\u76D8\u3002daemon \u62FF\u672C\u673A api key \u95EE gateway /me/volume\uFF1B\u6CA1\u767B\u5F55 / \u6CA1 key / gateway \u4E0D\u901A / \u6CA1\u8DD1\u8FC7\u4EFB\u52A1\u4E00\u5F8B\u56DE volume:null\uFF08\u89D2\u6807\u4E0D\u6E32\uFF09\uFF0C\u4E0D\u629B\uFF1Bowner-only\u3002\u65E0\u53C2\u6570\uFF08\u67E5\u7684\u662F\u8C03\u7528\u65B9\u81EA\u5DF1\u7684\u76D8\uFF09",
+    args: NO_ARGS
+  },
   "shift:list": {
     summary: "\u5217\u51FA owner \u7684\u5168\u90E8 shift\uFF08\u6392\u73ED\uFF09\uFF0C\u7ED9 UI \u65E5\u5386\u6E32\u67D3\u7528\uFF1Bowner-only",
     args: NO_ARGS
@@ -24460,6 +24465,19 @@ var MetaMethodsResultSchema = external_exports.object({
   methods: external_exports.array(RpcMethodInfoSchema)
 });
 
+// ../protocol/src/cloud-volume-schemas.ts
+var CloudVolumeUsageSchema = external_exports.object({
+  /** 已用字节（df 的 Used 列） */
+  usedBytes: external_exports.number().int().nonnegative(),
+  /** 盘的总字节（df 的 1B-blocks 列；ext4 预留之后比 PVC 的 5Gi 略小） */
+  sizeBytes: external_exports.number().int().positive(),
+  /** 量的时刻（ms）= 上一轮结束时 */
+  measuredAt: external_exports.number().int().nonnegative()
+}).strict();
+var CloudVolumeGetResultSchema = external_exports.object({
+  volume: CloudVolumeUsageSchema.nullable()
+}).strict();
+
 // ../protocol/src/log.ts
 var LOG_SOURCES = ["daemon", "main", "renderer"];
 var LogSourceSchema = external_exports.enum(LOG_SOURCES);