@walkhi/code-relax 0.1.0-beta.50 → 0.1.0-beta.51

package/dist/src/dots-profile.mjs

@@ -1,77 +1,77 @@
-import http2 from 'node:http2';
-
-const colors = new Set(['black', 'blue', 'green', 'orange', 'pink', 'purple', 'red', 'yellow']);
-export function dotsProfile(profile) {
-  const name = typeof profile?.display_name === 'string' ? profile.display_name.trim() : '';
-  const pointer = profile?.avatar_manifest?.snapshot?.asset_pointer;
-  return { profileId: profile.id, activeRootThreadId: profile.active_root_thread_id || '',
-    messagingRoomId: typeof profile.messaging_room_id === 'string' ? profile.messaging_room_id : '',
-    name: name && !['O', 'o', 'Orbit', 'orbit', 'dot'].includes(name) ? name : 'Dots',
-    avatarFileId: typeof pointer === 'string' && /^sediment:\/\/file_[a-f0-9]+$/.test(pointer)
-      ? pointer.slice('sediment://'.length) : '', color: colors.has(profile.color) ? profile.color : '' };
-}
-
-// Desktop 26.930.7945.0 discovers roots through /tbo and its thread attachments.
-// Hosted thread/list can omit every aeon root while thread/read still resolves it.
-export async function readDotsCatalog(localServer, identity) {
-  const auth = await localServer.request('getAuthStatus', { includeToken: true, refreshToken: false });
-  const principal = JSON.parse(Buffer.from(auth.authToken.split('.')[1], 'base64url'))['https://api.openai.com/auth'];
-  if (!identity || principal?.chatgpt_account_id !== identity.accountId || principal.chatgpt_user_id !== identity.userId) {
-    throw new Error('点点账号已变化，请重新连接。');
-  }
-  const session = http2.connect('https://chatgpt.com');
-  session.on('error', () => {}); // Individual requests report the transport error.
-  try {
-    const get = route => new Promise((resolve, reject) => {
-      const request = session.request({ ':method': 'GET', ':path': `/backend-api${route}`,
-        authorization: `Bearer ${auth.authToken}`, 'chatgpt-account-id': identity.accountId,
-        'user-agent': 'Code-Relax/0.1.0', accept: 'application/json' });
-      let status, body = '', size = 0;
-      const timer = setTimeout(() => request.destroy(new Error('读取点点资料超时。')), 15000);
-      request.setEncoding('utf8');
-      request.on('response', headers => { status = headers[':status']; });
-      request.on('data', chunk => {
-        size += Buffer.byteLength(chunk);
-        if (size > 1024 * 1024) request.destroy(new Error('点点资料响应过大。'));
-        else body += chunk;
-      });
-      request.on('error', reject);
-      request.on('close', () => clearTimeout(timer));
-      request.on('end', () => {
-        try {
-          if (status !== 200) throw new Error(`读取点点目录失败（HTTP ${status}）。`);
-          resolve(JSON.parse(body));
-        } catch (error) { reject(error); }
-      });
-      request.end();
-    });
-    const profiles = new Map(), rootThreadIds = new Set();
-    let cursor;
-    do {
-      const query = new URLSearchParams({ limit: '25', ...(cursor ? { cursor } : {}) });
-      const page = await get(`/tbo?${query}`);
-      for (const value of page.items) {
-        if (typeof value.id !== 'string' || !value.id
-          || value.active_root_thread_id != null && typeof value.active_root_thread_id !== 'string') {
-          throw new Error('点点资料缺少有效身份。');
-        }
-        const profile = dotsProfile(value);
-        let threadCursor;
-        do {
-          const threadQuery = new URLSearchParams({ limit: '100', include_hidden: 'true',
-            ...(threadCursor ? { cursor: threadCursor } : {}) });
-          const attachments = await get(`/tbo/${encodeURIComponent(value.id)}/threads?${threadQuery}`);
-          for (const attachment of attachments.items) {
-            const id = attachment.thread_id;
-            profiles.set(id, profile);
-            if (value.status !== 'deleting' && (!profile.activeRootThreadId || profile.activeRootThreadId === id)
-              && (attachment.parent_thread_id === null || attachment.parent_thread_id === id)) rootThreadIds.add(id);
-          }
-          threadCursor = attachments.cursor;
-        } while (threadCursor);
-      }
-      cursor = page.cursor;
-    } while (cursor);
-    return { profiles, rootThreadIds };
-  } finally { session.destroy(); }
-}
+import http2 from 'node:http2';
+
+const colors = new Set(['black', 'blue', 'green', 'orange', 'pink', 'purple', 'red', 'yellow']);
+export function dotsProfile(profile) {
+  const name = typeof profile?.display_name === 'string' ? profile.display_name.trim() : '';
+  const pointer = profile?.avatar_manifest?.snapshot?.asset_pointer;
+  return { profileId: profile.id, activeRootThreadId: profile.active_root_thread_id || '',
+    messagingRoomId: typeof profile.messaging_room_id === 'string' ? profile.messaging_room_id : '',
+    name: name && !['O', 'o', 'Orbit', 'orbit', 'dot'].includes(name) ? name : 'Dots',
+    avatarFileId: typeof pointer === 'string' && /^sediment:\/\/file_[a-f0-9]+$/.test(pointer)
+      ? pointer.slice('sediment://'.length) : '', color: colors.has(profile.color) ? profile.color : '' };
+}
+
+// Desktop 26.930.7945.0 discovers roots through /tbo and its thread attachments.
+// Hosted thread/list can omit every aeon root while thread/read still resolves it.
+export async function readDotsCatalog(localServer, identity) {
+  const auth = await localServer.request('getAuthStatus', { includeToken: true, refreshToken: false });
+  const principal = JSON.parse(Buffer.from(auth.authToken.split('.')[1], 'base64url'))['https://api.openai.com/auth'];
+  if (!identity || principal?.chatgpt_account_id !== identity.accountId || principal.chatgpt_user_id !== identity.userId) {
+    throw new Error('点点账号已变化，请重新连接。');
+  }
+  const session = http2.connect('https://chatgpt.com');
+  session.on('error', () => {}); // Individual requests report the transport error.
+  try {
+    const get = route => new Promise((resolve, reject) => {
+      const request = session.request({ ':method': 'GET', ':path': `/backend-api${route}`,
+        authorization: `Bearer ${auth.authToken}`, 'chatgpt-account-id': identity.accountId,
+        'user-agent': 'Code-Relax/0.1.0', accept: 'application/json' });
+      let status, body = '', size = 0;
+      const timer = setTimeout(() => request.destroy(new Error('读取点点资料超时。')), 15000);
+      request.setEncoding('utf8');
+      request.on('response', headers => { status = headers[':status']; });
+      request.on('data', chunk => {
+        size += Buffer.byteLength(chunk);
+        if (size > 1024 * 1024) request.destroy(new Error('点点资料响应过大。'));
+        else body += chunk;
+      });
+      request.on('error', reject);
+      request.on('close', () => clearTimeout(timer));
+      request.on('end', () => {
+        try {
+          if (status !== 200) throw new Error(`读取点点目录失败（HTTP ${status}）。`);
+          resolve(JSON.parse(body));
+        } catch (error) { reject(error); }
+      });
+      request.end();
+    });
+    const profiles = new Map(), rootThreadIds = new Set();
+    let cursor;
+    do {
+      const query = new URLSearchParams({ limit: '25', ...(cursor ? { cursor } : {}) });
+      const page = await get(`/tbo?${query}`);
+      for (const value of page.items) {
+        if (typeof value.id !== 'string' || !value.id
+          || value.active_root_thread_id != null && typeof value.active_root_thread_id !== 'string') {
+          throw new Error('点点资料缺少有效身份。');
+        }
+        const profile = dotsProfile(value);
+        let threadCursor;
+        do {
+          const threadQuery = new URLSearchParams({ limit: '100', include_hidden: 'true',
+            ...(threadCursor ? { cursor: threadCursor } : {}) });
+          const attachments = await get(`/tbo/${encodeURIComponent(value.id)}/threads?${threadQuery}`);
+          for (const attachment of attachments.items) {
+            const id = attachment.thread_id;
+            profiles.set(id, profile);
+            if (value.status !== 'deleting' && (!profile.activeRootThreadId || profile.activeRootThreadId === id)
+              && (attachment.parent_thread_id === null || attachment.parent_thread_id === id)) rootThreadIds.add(id);
+          }
+          threadCursor = attachments.cursor;
+        } while (threadCursor);
+      }
+      cursor = page.cursor;
+    } while (cursor);
+    return { profiles, rootThreadIds };
+  } finally { session.destroy(); }
+}

package/dist/src/dots-room-activity.mjs

@@ -1,172 +1,172 @@
-import { EventEmitter } from 'node:events';
-
-// Desktop 26.1007.9446.0: room-live activity and responding heartbeats are
-// independent. Heartbeats expire after 10s; Dot reply handoff lasts at most 5s.
-const typingTimeout = 10000, handoffTimeout = 5000;
-const statusLabels = {
-  working: '正在处理…', searching: '正在搜索…', creating: '正在创建…',
-  payment: '等待支付', 'needs input': '等待你的输入', paused: '已暂停',
-};
-const waitingStates = new Set(['payment', 'needs input', 'paused']);
-
-export class DotsRoomActivity extends EventEmitter {
-  constructor(server) {
-    super(); this.server = server; this.watches = new Map();
-    this.message = (topic, event) => {
-      for (const watch of this.watches.values()) {
-        if (topic === 'calpico-chatgpt-messaging') { this.roomEvent(watch, event); continue; }
-        if (event?.type !== 'calpico-room-live') continue;
-        const value = event.payload;
-        if (watch.topic !== topic || watch.roomId !== value?.room_id || value.version !== 1) continue;
-        if (!watch.subscriptionId) {
-          if (watch.pending.size >= 4) watch.pending.delete(watch.pending.keys().next().value);
-          const old = watch.pending.get(value.subscription_id);
-          if (!old || value.revision > old.revision) watch.pending.set(value.subscription_id, value);
-        } else this.apply(watch, value);
-      }
-    };
-    server.rooms.on('message', this.message);
-  }
-  acquire(threadId, listener) {
-    let watch = this.watches.get(threadId);
-    if (!watch) {
-      watch = { threadId, listeners: new Set(), activity: null, generation: 0, attempts: 0 };
-      this.watches.set(threadId, watch);
-    }
-    watch.listeners.add(listener); listener({ threadId, activity: watch.activity });
-    if (!watch.controller && !watch.timer) void this.start(watch);
-    let released = false;
-    return () => {
-      if (released) return; released = true; watch.listeners.delete(listener);
-      if (!watch.listeners.size) { this.watches.delete(threadId); this.stop(watch); }
-    };
-  }
-  publish(watch, activity) {
-    if (JSON.stringify(watch.activity) === JSON.stringify(activity)) return;
-    watch.activity = activity;
-    for (const listener of watch.listeners) listener({ threadId: watch.threadId, activity });
-  }
-  refresh(watch) {
-    const activity = watch.typing ? { kind: 'replying', label: '正在回复…', spinning: true }
-      : watch.liveActivity || (watch.handoffTimer ? { kind: 'replying', label: '正在回复…', spinning: true }
-        : watch.unavailable ? { kind: 'unavailable', label: '活动状态暂不可用', spinning: false } : null);
-    this.publish(watch, activity);
-  }
-  clearReply(watch) {
-    clearTimeout(watch.typingTimer); clearTimeout(watch.handoffTimer);
-    watch.typingTimer = null; watch.handoffTimer = null; watch.typing = false; watch.handoffMessageId = null;
-  }
-  handoff(watch, messageId = null) {
-    const wasTyping = watch.typing;
-    clearTimeout(watch.typingTimer); watch.typingTimer = null; watch.typing = false;
-    if (messageId && (wasTyping || watch.handoffTimer)) watch.handoffMessageId = messageId;
-    if (wasTyping && !watch.handoffTimer) {
-      watch.handoffTimer = setTimeout(() => {
-        watch.handoffTimer = null; watch.handoffMessageId = null;
-        if (this.watches.get(watch.threadId) === watch) this.refresh(watch);
-      }, handoffTimeout);
-      watch.handoffTimer.unref();
-    }
-    this.refresh(watch);
-  }
-  completeReply(threadId, turns) {
-    const watch = this.watches.get(threadId);
-    if (!watch?.handoffMessageId || !turns.some(turn => turn.id === watch.handoffMessageId
-      && turn.items.some(item => item.type === 'agentMessage' && !item.dotsStreaming))) return;
-    // The matching formal message has entered the existing chat stream.
-    clearTimeout(watch.handoffTimer); watch.handoffTimer = null; watch.handoffMessageId = null;
-    this.refresh(watch);
-  }
-  roomEvent(watch, event) {
-    if (!this.server.rooms.ready || !watch.roomId || event?.payload?.room_id !== watch.roomId) return;
-    const payload = event.payload, heartbeat = event.type === 'calpico-is-responding-heartbeat';
-    if (!heartbeat && event.type !== 'calpico-message-add') return;
-    const room = this.server.bindings.get(watch.threadId);
-    const sender = heartbeat ? payload.source : payload.message;
-    if (room?.id !== watch.roomId || !room.aeon_id || heartbeat && sender?.role !== 'user'
-      || !sender?.account_user_id
-      || !room.members.some(member => member.account_user_id === sender.account_user_id && member.aeon_id === room.aeon_id)) return;
-    if (!heartbeat || payload.typing === false) {
-      this.handoff(watch, heartbeat ? null : payload.message.id); return;
-    }
-    if (payload.typing != null && payload.typing !== true) return;
-    this.clearReply(watch); watch.typing = true;
-    watch.typingTimer = setTimeout(() => {
-      watch.typingTimer = null;
-      if (this.watches.get(watch.threadId) === watch) this.handoff(watch);
-    }, typingTimeout);
-    watch.typingTimer.unref(); this.refresh(watch);
-  }
-  apply(watch, value) {
-    if (value.subscription_id !== watch.subscriptionId || !Number.isSafeInteger(value.revision) || value.revision <= watch.revision) return;
-    watch.revision = value.revision;
-    if (value.type === 'calpico-room-live-error') {
-      this.fail(watch, new Error('点点活动暂不可用。'), value.code === 'temporarily_unavailable'); return;
-    }
-    if (value.type !== 'calpico-room-live-state' || !Array.isArray(value.threads)) return;
-    const current = value.threads[0];
-    watch.attempts = 0; watch.unavailable = false; watch.liveActivity = null;
-    if (current?.stream_state !== 'attached') { this.refresh(watch); return; }
-    if (current.turn_status === 'failed') {
-      this.clearReply(watch); watch.liveActivity = { kind: 'error', label: '回复出错', spinning: false };
-      this.refresh(watch); return;
-    }
-    if (current.turn_status !== 'in_progress') { this.refresh(watch); return; }
-    const status = typeof current.activity_status?.status_type === 'string' ? current.activity_status.status_type.toLowerCase() : '';
-    const label = current.activity_status?.status_label;
-    if (status !== 'ready') {
-      const waiting = waitingStates.has(status);
-      const fallback = Object.hasOwn(statusLabels, status) ? statusLabels[status] : null;
-      if (waiting) this.clearReply(watch);
-      watch.liveActivity = { kind: waiting ? 'waiting' : fallback ? 'operation' : 'thinking',
-        label: typeof label === 'string' && label.trim() ? label : fallback || '正在思考…', spinning: !waiting };
-    }
-    this.refresh(watch);
-  }
-  async start(watch) {
-    const generation = ++watch.generation, controller = new AbortController();
-    watch.controller = controller; watch.pending = new Map(); watch.subscriptionId = null; watch.revision = -1;
-    const current = () => this.watches.get(watch.threadId) === watch && generation === watch.generation && !controller.signal.aborted;
-    try {
-      await this.server.connect();
-      const room = this.server.bindings.get(watch.threadId) || await this.server.room(watch.threadId);
-      if (!current()) return;
-      watch.roomId = room.id; watch.topic = `calpico-room-live:${room.id}`;
-      await this.server.rooms.subscribe(watch.topic);
-      if (!current()) { if (!this.watches.has(watch.threadId)) await this.server.rooms.unsubscribe(watch.topic); return; }
-      await this.server.rooms.request(`/messaging/rooms/${encodeURIComponent(room.id)}/live`, {
-        method: 'POST', signal: controller.signal, onEvent: value => {
-          if (!current()) return;
-          // The live SSE sends {} keepalives after ready; they carry no identity.
-          if (value && typeof value === 'object' && !Array.isArray(value) && Object.keys(value).length === 0) return;
-          if (value?.type !== 'calpico-room-live-ready' || value.version !== 1 || value.room_id !== room.id
-            || typeof value.subscription_id !== 'string' || watch.subscriptionId && watch.subscriptionId !== value.subscription_id) {
-            throw new Error('点点活动订阅身份无效。');
-          }
-          watch.subscriptionId = value.subscription_id;
-          const pending = watch.pending.get(value.subscription_id); watch.pending.clear();
-          if (pending) this.apply(watch, pending);
-        },
-      });
-      if (current()) this.fail(watch, new Error('点点活动连接已结束。'), true);
-    } catch (error) { if (current()) this.fail(watch, error, ![401, 403, 404].includes(error.status)); }
-  }
-  fail(watch, error, retry) {
-    this.stop(watch, true); watch.unavailable = true; this.refresh(watch); this.emit('unavailable', error);
-    if (retry && watch.listeners.size && this.server.ready && watch.attempts < 5) {
-      watch.timer = setTimeout(() => { watch.timer = null; void this.start(watch); }, Math.min(30000, 1000 * 2 ** watch.attempts++));
-      watch.timer.unref();
-    }
-  }
-  stop(watch, keepReply = false) {
-    watch.generation++; clearTimeout(watch.timer); watch.timer = null;
-    watch.controller?.abort(); watch.controller = null; watch.pending?.clear(); watch.liveActivity = null;
-    watch.subscriptionId = null; watch.revision = -1;
-    if (!keepReply) { this.clearReply(watch); watch.unavailable = false; watch.roomId = null; }
-    if (!keepReply) this.publish(watch, null);
-    // The SSE cancellation ends the server watch. The shared topic remains
-    // subscribed while this account socket lives, avoiding unsubscribe races.
-  }
-  close() { for (const watch of this.watches.values()) this.stop(watch); this.watches.clear(); }
-  dispose() { this.close(); this.server.rooms.off('message', this.message); }
-}
+import { EventEmitter } from 'node:events';
+
+// Desktop 26.1007.9446.0: room-live activity and responding heartbeats are
+// independent. Heartbeats expire after 10s; Dot reply handoff lasts at most 5s.
+const typingTimeout = 10000, handoffTimeout = 5000;
+const statusLabels = {
+  working: '正在处理…', searching: '正在搜索…', creating: '正在创建…',
+  payment: '等待支付', 'needs input': '等待你的输入', paused: '已暂停',
+};
+const waitingStates = new Set(['payment', 'needs input', 'paused']);
+
+export class DotsRoomActivity extends EventEmitter {
+  constructor(server) {
+    super(); this.server = server; this.watches = new Map();
+    this.message = (topic, event) => {
+      for (const watch of this.watches.values()) {
+        if (topic === 'calpico-chatgpt-messaging') { this.roomEvent(watch, event); continue; }
+        if (event?.type !== 'calpico-room-live') continue;
+        const value = event.payload;
+        if (watch.topic !== topic || watch.roomId !== value?.room_id || value.version !== 1) continue;
+        if (!watch.subscriptionId) {
+          if (watch.pending.size >= 4) watch.pending.delete(watch.pending.keys().next().value);
+          const old = watch.pending.get(value.subscription_id);
+          if (!old || value.revision > old.revision) watch.pending.set(value.subscription_id, value);
+        } else this.apply(watch, value);
+      }
+    };
+    server.rooms.on('message', this.message);
+  }
+  acquire(threadId, listener) {
+    let watch = this.watches.get(threadId);
+    if (!watch) {
+      watch = { threadId, listeners: new Set(), activity: null, generation: 0, attempts: 0 };
+      this.watches.set(threadId, watch);
+    }
+    watch.listeners.add(listener); listener({ threadId, activity: watch.activity });
+    if (!watch.controller && !watch.timer) void this.start(watch);
+    let released = false;
+    return () => {
+      if (released) return; released = true; watch.listeners.delete(listener);
+      if (!watch.listeners.size) { this.watches.delete(threadId); this.stop(watch); }
+    };
+  }
+  publish(watch, activity) {
+    if (JSON.stringify(watch.activity) === JSON.stringify(activity)) return;
+    watch.activity = activity;
+    for (const listener of watch.listeners) listener({ threadId: watch.threadId, activity });
+  }
+  refresh(watch) {
+    const activity = watch.typing ? { kind: 'replying', label: '正在回复…', spinning: true }
+      : watch.liveActivity || (watch.handoffTimer ? { kind: 'replying', label: '正在回复…', spinning: true }
+        : watch.unavailable ? { kind: 'unavailable', label: '活动状态暂不可用', spinning: false } : null);
+    this.publish(watch, activity);
+  }
+  clearReply(watch) {
+    clearTimeout(watch.typingTimer); clearTimeout(watch.handoffTimer);
+    watch.typingTimer = null; watch.handoffTimer = null; watch.typing = false; watch.handoffMessageId = null;
+  }
+  handoff(watch, messageId = null) {
+    const wasTyping = watch.typing;
+    clearTimeout(watch.typingTimer); watch.typingTimer = null; watch.typing = false;
+    if (messageId && (wasTyping || watch.handoffTimer)) watch.handoffMessageId = messageId;
+    if (wasTyping && !watch.handoffTimer) {
+      watch.handoffTimer = setTimeout(() => {
+        watch.handoffTimer = null; watch.handoffMessageId = null;
+        if (this.watches.get(watch.threadId) === watch) this.refresh(watch);
+      }, handoffTimeout);
+      watch.handoffTimer.unref();
+    }
+    this.refresh(watch);
+  }
+  completeReply(threadId, turns) {
+    const watch = this.watches.get(threadId);
+    if (!watch?.handoffMessageId || !turns.some(turn => turn.id === watch.handoffMessageId
+      && turn.items.some(item => item.type === 'agentMessage' && !item.dotsStreaming))) return;
+    // The matching formal message has entered the existing chat stream.
+    clearTimeout(watch.handoffTimer); watch.handoffTimer = null; watch.handoffMessageId = null;
+    this.refresh(watch);
+  }
+  roomEvent(watch, event) {
+    if (!this.server.rooms.ready || !watch.roomId || event?.payload?.room_id !== watch.roomId) return;
+    const payload = event.payload, heartbeat = event.type === 'calpico-is-responding-heartbeat';
+    if (!heartbeat && event.type !== 'calpico-message-add') return;
+    const room = this.server.bindings.get(watch.threadId);
+    const sender = heartbeat ? payload.source : payload.message;
+    if (room?.id !== watch.roomId || !room.aeon_id || heartbeat && sender?.role !== 'user'
+      || !sender?.account_user_id
+      || !room.members.some(member => member.account_user_id === sender.account_user_id && member.aeon_id === room.aeon_id)) return;
+    if (!heartbeat || payload.typing === false) {
+      this.handoff(watch, heartbeat ? null : payload.message.id); return;
+    }
+    if (payload.typing != null && payload.typing !== true) return;
+    this.clearReply(watch); watch.typing = true;
+    watch.typingTimer = setTimeout(() => {
+      watch.typingTimer = null;
+      if (this.watches.get(watch.threadId) === watch) this.handoff(watch);
+    }, typingTimeout);
+    watch.typingTimer.unref(); this.refresh(watch);
+  }
+  apply(watch, value) {
+    if (value.subscription_id !== watch.subscriptionId || !Number.isSafeInteger(value.revision) || value.revision <= watch.revision) return;
+    watch.revision = value.revision;
+    if (value.type === 'calpico-room-live-error') {
+      this.fail(watch, new Error('点点活动暂不可用。'), value.code === 'temporarily_unavailable'); return;
+    }
+    if (value.type !== 'calpico-room-live-state' || !Array.isArray(value.threads)) return;
+    const current = value.threads[0];
+    watch.attempts = 0; watch.unavailable = false; watch.liveActivity = null;
+    if (current?.stream_state !== 'attached') { this.refresh(watch); return; }
+    if (current.turn_status === 'failed') {
+      this.clearReply(watch); watch.liveActivity = { kind: 'error', label: '回复出错', spinning: false };
+      this.refresh(watch); return;
+    }
+    if (current.turn_status !== 'in_progress') { this.refresh(watch); return; }
+    const status = typeof current.activity_status?.status_type === 'string' ? current.activity_status.status_type.toLowerCase() : '';
+    const label = current.activity_status?.status_label;
+    if (status !== 'ready') {
+      const waiting = waitingStates.has(status);
+      const fallback = Object.hasOwn(statusLabels, status) ? statusLabels[status] : null;
+      if (waiting) this.clearReply(watch);
+      watch.liveActivity = { kind: waiting ? 'waiting' : fallback ? 'operation' : 'thinking',
+        label: typeof label === 'string' && label.trim() ? label : fallback || '正在思考…', spinning: !waiting };
+    }
+    this.refresh(watch);
+  }
+  async start(watch) {
+    const generation = ++watch.generation, controller = new AbortController();
+    watch.controller = controller; watch.pending = new Map(); watch.subscriptionId = null; watch.revision = -1;
+    const current = () => this.watches.get(watch.threadId) === watch && generation === watch.generation && !controller.signal.aborted;
+    try {
+      await this.server.connect();
+      const room = this.server.bindings.get(watch.threadId) || await this.server.room(watch.threadId);
+      if (!current()) return;
+      watch.roomId = room.id; watch.topic = `calpico-room-live:${room.id}`;
+      await this.server.rooms.subscribe(watch.topic);
+      if (!current()) { if (!this.watches.has(watch.threadId)) await this.server.rooms.unsubscribe(watch.topic); return; }
+      await this.server.rooms.request(`/messaging/rooms/${encodeURIComponent(room.id)}/live`, {
+        method: 'POST', signal: controller.signal, onEvent: value => {
+          if (!current()) return;
+          // The live SSE sends {} keepalives after ready; they carry no identity.
+          if (value && typeof value === 'object' && !Array.isArray(value) && Object.keys(value).length === 0) return;
+          if (value?.type !== 'calpico-room-live-ready' || value.version !== 1 || value.room_id !== room.id
+            || typeof value.subscription_id !== 'string' || watch.subscriptionId && watch.subscriptionId !== value.subscription_id) {
+            throw new Error('点点活动订阅身份无效。');
+          }
+          watch.subscriptionId = value.subscription_id;
+          const pending = watch.pending.get(value.subscription_id); watch.pending.clear();
+          if (pending) this.apply(watch, pending);
+        },
+      });
+      if (current()) this.fail(watch, new Error('点点活动连接已结束。'), true);
+    } catch (error) { if (current()) this.fail(watch, error, ![401, 403, 404].includes(error.status)); }
+  }
+  fail(watch, error, retry) {
+    this.stop(watch, true); watch.unavailable = true; this.refresh(watch); this.emit('unavailable', error);
+    if (retry && watch.listeners.size && this.server.ready && watch.attempts < 5) {
+      watch.timer = setTimeout(() => { watch.timer = null; void this.start(watch); }, Math.min(30000, 1000 * 2 ** watch.attempts++));
+      watch.timer.unref();
+    }
+  }
+  stop(watch, keepReply = false) {
+    watch.generation++; clearTimeout(watch.timer); watch.timer = null;
+    watch.controller?.abort(); watch.controller = null; watch.pending?.clear(); watch.liveActivity = null;
+    watch.subscriptionId = null; watch.revision = -1;
+    if (!keepReply) { this.clearReply(watch); watch.unavailable = false; watch.roomId = null; }
+    if (!keepReply) this.publish(watch, null);
+    // The SSE cancellation ends the server watch. The shared topic remains
+    // subscribed while this account socket lives, avoiding unsubscribe races.
+  }
+  close() { for (const watch of this.watches.values()) this.stop(watch); this.watches.clear(); }
+  dispose() { this.close(); this.server.rooms.off('message', this.message); }
+}