@clawos-dev/clawd 0.2.242 → 0.2.243

package/dist/cli.cjs

@@ -5330,7 +5330,19 @@ var init_schemas = __esm({
        * selfUrl 保留：它只是"可达地址"（auto-reverse 反向连接用），不是身份——填错只影响
        * 反向连通性，不构成伪造风险，且 url 不在 token 里（token 只签身份不签地址）。
        */
-      selfUrl: external_exports.string().min(1).optional()
+      selfUrl: external_exports.string().min(1).optional(),
+      /**
+       * 客户端自报的 user-agent 性质标签（诊断/展示用）。
+       * 同 selfUrl 性质的「自报事实」，非身份（决策 #16 边界）：不参与鉴权、不参与路由、
+       * 任何 handler 不得据此做权限判断。name 约定命名（'clawd-desktop' / 'clawd-web' /
+       * 'clawd-mobile-android' / ...），宽容未知值（将来加新客户端不动 schema）。
+       * instanceId：客户端首启生成 UUID 并本地持久化——区分同种类多实例（多手机/多 desktop 同连）。
+       */
+      clientInfo: external_exports.object({
+        name: external_exports.string().min(1),
+        version: external_exports.string().min(1),
+        instanceId: external_exports.string().min(1)
+      }).optional()
     });
     AuthOkFrameSchema = external_exports.object({
       type: external_exports.literal("auth:ok"),
@@ -50120,6 +50132,16 @@ var LocalWsServer = class {
     const c = this.clients.get(clientId);
     if (!c) return;
     c.ctx = ctx;
+    if (ctx.clientInfo) {
+      this.logger?.info("client authed", {
+        clientId,
+        principalId: ctx.principal.id,
+        principalKind: ctx.principal.kind,
+        clientName: ctx.clientInfo.name,
+        clientVersion: ctx.clientInfo.version,
+        clientInstanceId: ctx.clientInfo.instanceId
+      });
+    }
     if (ctx.principal.kind === "guest") {
       let set = this.guestIdToClients.get(ctx.principal.id);
       if (!set) {
@@ -50492,6 +50514,9 @@ var AuthGate = class {
       }
       ctx = this.opts.buildOwnerContext?.() ?? null;
     }
+    if (ctx && parsed.data.clientInfo) {
+      ctx = { ...ctx, clientInfo: parsed.data.clientInfo };
+    }
     if (st.timer != null) {
       const clear = this.opts.clearTimer ?? ((h) => clearTimeout(h));
       clear(st.timer);

package/dist/dispatch/mcp-server.cjs

@@ -40380,7 +40380,19 @@ var AuthRequestFrameSchema = external_exports.object({
    * selfUrl 保留：它只是"可达地址"（auto-reverse 反向连接用），不是身份——填错只影响
    * 反向连通性，不构成伪造风险，且 url 不在 token 里（token 只签身份不签地址）。
    */
-  selfUrl: external_exports.string().min(1).optional()
+  selfUrl: external_exports.string().min(1).optional(),
+  /**
+   * 客户端自报的 user-agent 性质标签（诊断/展示用）。
+   * 同 selfUrl 性质的「自报事实」，非身份（决策 #16 边界）：不参与鉴权、不参与路由、
+   * 任何 handler 不得据此做权限判断。name 约定命名（'clawd-desktop' / 'clawd-web' /
+   * 'clawd-mobile-android' / ...），宽容未知值（将来加新客户端不动 schema）。
+   * instanceId：客户端首启生成 UUID 并本地持久化——区分同种类多实例（多手机/多 desktop 同连）。
+   */
+  clientInfo: external_exports.object({
+    name: external_exports.string().min(1),
+    version: external_exports.string().min(1),
+    instanceId: external_exports.string().min(1)
+  }).optional()
 });
 var AuthOkFrameSchema = external_exports.object({
   type: external_exports.literal("auth:ok"),