@jingyi0605/codingns4dsh 0.2.0-beta.1 → 0.2.0-beta.2

package/data/build/dist/host/modules/peer-host/peer-host-native-protocol.js

@@ -0,0 +1,184 @@
+/** DSH 0.2.x Workspace/Session Remote 方法；这里只登记原生协议，不登记插件私有 RPC。 */
+export const DSH_NATIVE_REMOTE_METHODS = Object.freeze([
+    'workspace/archiveSession',
+    'workspace/create',
+    'workspace/delete',
+    'workspace/follow',
+    'workspace/initializeDefault',
+    'workspace/insertBefore',
+    'workspace/insertSessionBefore',
+    'workspace/pinSession',
+    'workspace/rename',
+    'workspace/unarchiveSession',
+    'workspace/unpinSession',
+    'session/attachment',
+    'session/cancel',
+    'session/canOpenWorkspacePath',
+    'session/control',
+    'session/create',
+    'session/follow',
+    'session/fork',
+    'session/initializeDefaultModel',
+    'session/list',
+    'session/modelCatalog',
+    'session/openWorkspacePath',
+    'session/page',
+    'session/projections',
+    'session/prompt',
+    'session/rename',
+    'session/search',
+    'session/selectModel',
+    'session/updateQueue',
+    'session/workspacePathApplications',
+    'officeToPdf/generation',
+    'officeToPdf/render',
+    'workspaceFiles/changes',
+    'workspaceFiles/list',
+    'workspaceFiles/read',
+    'workspaceFiles/readBytes',
+    'workspaceFiles/stat',
+    'terminal/close',
+    'terminal/create',
+    'terminal/environment',
+    'terminal/follow',
+    'terminal/list',
+    'terminal/rename',
+    'terminal/resize',
+    'terminal/retain',
+    'terminal/shells',
+    'terminal/write',
+    // CodingNs4DSH 自带终端控制器：右侧终端面板实际调用它（会话身份在 agentId 线参上）。
+    'codingnsTerminal/close',
+    'codingnsTerminal/create',
+    'codingnsTerminal/environment',
+    'codingnsTerminal/follow',
+    'codingnsTerminal/list',
+    'codingnsTerminal/rename',
+    'codingnsTerminal/resize',
+    'codingnsTerminal/retain',
+    'codingnsTerminal/shells',
+    'codingnsTerminal/write',
+    'fileReferences/list',
+    'skills/list',
+]);
+const NATIVE_METHOD_SET = new Set(DSH_NATIVE_REMOTE_METHODS);
+export function isDshNativeRemoteMethod(value) {
+    return NATIVE_METHOD_SET.has(value);
+}
+/**
+ * 将 DSH 原生请求中的虚拟资源 ID 改回目标 Host 的真实 ID。
+ * 只改写 DSH 已知的资源字段，requestId、attachmentId 和任意正文不会被误改。
+ */
+export function rewriteNativeRequestIds(method, payload, resolver) {
+    if (payload === undefined)
+        return payload;
+    return rewriteValue(payload, (key, value) => {
+        if (typeof value !== 'string')
+            return value;
+        if (isWorkspaceField(key)) {
+            return resolver.resolveWorkspace(value)?.workspaceId ?? value;
+        }
+        if (isSessionField(key)) {
+            return resolver.resolveSession(value)?.sessionId ?? value;
+        }
+        return value;
+    });
+}
+/** 将目标 Host 返回的原生结果/事件重新编码为当前 DSH 可见的虚拟 ID。 */
+export function rewriteNativeResponseIds(value, encodeWorkspace, encodeSession) {
+    return rewriteValue(value, (key, current, parentKey) => {
+        if (typeof current !== 'string')
+            return current;
+        if (isWorkspaceField(key))
+            return encodeWorkspace(current);
+        if (isSessionField(key) || key === 'parentSession' || (key === 'id' && parentKey === 'header'))
+            return encodeSession(current);
+        return current;
+    });
+}
+function rewriteValue(value, map, key = '', parentKey) {
+    // 二进制字段（例如 workspaceFiles/readBytes.data）属于 Remote 结果的一部分，
+    // 不能按普通对象展开，否则 Uint8Array 会变成带数字键的对象并在 JSON 边界丢失类型。
+    if (value instanceof Uint8Array)
+        return value;
+    if (Array.isArray(value))
+        return value.map((item) => rewriteValue(item, map, key, parentKey));
+    if (typeof value !== 'object' || value === null)
+        return map(key, value);
+    const result = {};
+    for (const [childKey, childValue] of Object.entries(value)) {
+        const mapped = map(childKey, childValue, key);
+        result[childKey] = mapped === childValue
+            ? rewriteValue(childValue, map, childKey, key)
+            : mapped;
+    }
+    return result;
+}
+/** PeerHost 的 JSON RPC 不能直接传输 Uint8Array，使用显式标记保留二进制结果。 */
+const NATIVE_BYTES_MARKER = '__codingnsNativeBytes';
+export function encodeNativeResponseBytes(value) {
+    if (value instanceof Uint8Array)
+        return { [NATIVE_BYTES_MARKER]: encodeBase64(value) };
+    if (Array.isArray(value))
+        return value.map(encodeNativeResponseBytes);
+    if (typeof value !== 'object' || value === null)
+        return value;
+    const result = {};
+    for (const [key, child] of Object.entries(value))
+        result[key] = encodeNativeResponseBytes(child);
+    return result;
+}
+export function decodeNativeResponseBytes(value) {
+    if (Array.isArray(value))
+        return value.map(decodeNativeResponseBytes);
+    if (typeof value !== 'object' || value === null)
+        return value;
+    const record = value;
+    if (Object.keys(record).length === 1 && typeof record[NATIVE_BYTES_MARKER] === 'string') {
+        return decodeBase64(record[NATIVE_BYTES_MARKER]);
+    }
+    const result = {};
+    for (const [key, child] of Object.entries(record))
+        result[key] = decodeNativeResponseBytes(child);
+    return result;
+}
+function encodeBase64(bytes) {
+    let binary = '';
+    for (const byte of bytes)
+        binary += String.fromCharCode(byte);
+    const browserEncoder = globalThis.btoa;
+    if (typeof browserEncoder === 'function')
+        return browserEncoder(binary);
+    const nodeBuffer = globalThis.Buffer;
+    if (nodeBuffer !== undefined)
+        return nodeBuffer.from(bytes).toString('base64');
+    throw new Error('当前运行时不支持 Base64 编码');
+}
+function decodeBase64(value) {
+    const browserDecoder = globalThis.atob;
+    if (typeof browserDecoder === 'function') {
+        const binary = browserDecoder(value);
+        const bytes = new Uint8Array(binary.length);
+        for (let index = 0; index < binary.length; index += 1)
+            bytes[index] = binary.charCodeAt(index);
+        return bytes;
+    }
+    const nodeBuffer = globalThis.Buffer;
+    if (nodeBuffer !== undefined) {
+        const buffer = nodeBuffer.from(value, 'base64');
+        return Uint8Array.from({ length: buffer.length }, (_, index) => buffer[index] ?? 0);
+    }
+    throw new Error('当前运行时不支持 Base64 解码');
+}
+function isWorkspaceField(key) {
+    return key === 'workspaceId' || key === 'beforeWorkspaceId' || key === 'workspaceIds';
+}
+function isSessionField(key) {
+    if (key === 'workspaceFileScopeId')
+        return true;
+    // CodingNs4DSH 终端 Remote 用 agentId（lookup: agent，codec 为 SessionId）承载会话身份。
+    if (key === 'agentId')
+        return true;
+    return key === 'sessionId' || key === 'beforeSessionId' || key === 'sessionIds' || key === 'parentSessionId' || key === 'childSessionId';
+}
+//# sourceMappingURL=peer-host-native-protocol.js.map

package/data/build/dist/host/modules/peer-host/peer-host-native-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-host-native-protocol.js","sourceRoot":"","sources":["../../../../../../src/host/modules/peer-host/peer-host-native-protocol.ts"],"names":[],"mappings":"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"}

package/data/build/dist/host/modules/peer-host/peer-host-native-transport.d.ts

@@ -0,0 +1,22 @@
+import type { HostScope } from '../../../shared/contracts/peer-host.js';
+import { PeerHostHttpProxyService } from './host-api-proxy-service.js';
+/**
+ * 当前 Host 到目标 Host 的原生 Remote 通道。
+ *
+ * 目标插件把 `peerHost/nativeLocal` 等动作挂在 `/api/codingns/<endpoint>` fetch
+ * 路由上，该入口要求 CodingNS fetch RPC 信封：rpcId 必填、method 必须等于端点名，
+ * 内层 payload 才是 `peerHost/<action>` 的参数。这里集中生成请求并解析响应，
+ * 避免各处自行拼装出与目标入口不匹配的正文。
+ */
+export interface PeerHostNativeTransportRequest {
+    readonly scope: HostScope;
+    readonly method: string;
+    readonly payload?: unknown;
+    readonly signal?: AbortSignal;
+}
+export type PeerHostNativeEndpoint = 'peerHost/nativeLocal' | 'peerHost/nativeStreamOpen' | 'peerHost/nativeStreamNext' | 'peerHost/nativeStreamClose';
+export declare function peerHostNativeEnvelope(endpoint: PeerHostNativeEndpoint, payload: unknown): string;
+export declare function callPeerNativeRpc(httpProxy: PeerHostHttpProxyService, peerHostId: string, request: PeerHostNativeTransportRequest): Promise<unknown>;
+export declare function openPeerNativeStream(httpProxy: PeerHostHttpProxyService, peerHostId: string, request: PeerHostNativeTransportRequest): AsyncIterable<unknown>;
+export declare function readNativeRpcEnvelope(body: string): unknown;
+//# sourceMappingURL=peer-host-native-transport.d.ts.map

package/data/build/dist/host/modules/peer-host/peer-host-native-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-host-native-transport.d.ts","sourceRoot":"","sources":["../../../../../../src/host/modules/peer-host/peer-host-native-transport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAA;AAGvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAA;AAQtE;;;;;;;GAOG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED,MAAM,MAAM,sBAAsB,GAAG,sBAAsB,GAAG,2BAA2B,GAAG,2BAA2B,GAAG,4BAA4B,CAAA;AAEtJ,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAEjG;AAED,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ1J;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,8BAA8B,GAAG,aAAa,CAAC,OAAO,CAAC,CA+B7J;AAsBD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAe3D"}

package/data/build/dist/host/modules/peer-host/peer-host-native-transport.js

@@ -0,0 +1,111 @@
+import { randomUUID } from 'node:crypto';
+import { setTimeout as delay } from 'node:timers/promises';
+import { PEER_HOST_ERROR_CODES } from '../../../shared/contracts/peer-host.js';
+import { CodingNsRpcError } from '../../rpc-table.js';
+import { PeerHostHttpProxyService } from './host-api-proxy-service.js';
+const STREAM_RETRY_ATTEMPTS = 3;
+const STREAM_RETRY_DELAY_MS = 400;
+export function peerHostNativeEnvelope(endpoint, payload) {
+    return JSON.stringify({ rpcId: `peer-host-native-${randomUUID()}`, method: endpoint, payload });
+}
+export async function callPeerNativeRpc(httpProxy, peerHostId, request) {
+    const response = await httpProxy.request(peerHostId, {
+        scope: request.scope,
+        path: '/api/codingns/peerHost/nativeLocal',
+        method: 'POST',
+        body: peerHostNativeEnvelope('peerHost/nativeLocal', { method: request.method, payload: request.payload, scope: request.scope }),
+    });
+    return readNativeRpcEnvelope(response.body);
+}
+export function openPeerNativeStream(httpProxy, peerHostId, request) {
+    return (async function* () {
+        const opened = await requestPeerHostStream(httpProxy, peerHostId, {
+            scope: request.scope,
+            path: '/api/codingns/peerHost/nativeStreamOpen',
+            method: 'POST',
+            body: peerHostNativeEnvelope('peerHost/nativeStreamOpen', { method: request.method, payload: request.payload, scope: request.scope }),
+        }, request.signal);
+        const openedValue = readNativeRpcEnvelope(opened.body);
+        const streamId = requiredString(record(openedValue).streamId, 'streamId');
+        try {
+            while (!(request.signal?.aborted ?? false)) {
+                const next = await requestPeerHostStream(httpProxy, peerHostId, {
+                    scope: request.scope,
+                    path: '/api/codingns/peerHost/nativeStreamNext',
+                    method: 'POST',
+                    body: peerHostNativeEnvelope('peerHost/nativeStreamNext', { streamId, scope: request.scope }),
+                }, request.signal);
+                const value = record(readNativeRpcEnvelope(next.body));
+                if (value.done === true)
+                    return;
+                yield value.value;
+            }
+        }
+        finally {
+            await httpProxy.request(peerHostId, {
+                scope: request.scope,
+                path: '/api/codingns/peerHost/nativeStreamClose',
+                method: 'POST',
+                body: peerHostNativeEnvelope('peerHost/nativeStreamClose', { streamId, scope: request.scope }),
+            }).catch(() => undefined);
+        }
+    })();
+}
+/**
+ * 目标 Host 自身重启时其 LAN 入口会短暂不可达，代理以 502 与连接级错误码返回。
+ * 流通道只有读语义，这类明确的连接级失败可以有限重试；业务错误（例如会话不存在）直接返回。
+ */
+async function requestPeerHostStream(httpProxy, peerHostId, request, signal) {
+    for (let attempt = 1;; attempt += 1) {
+        const response = await httpProxy.request(peerHostId, request);
+        if (attempt >= STREAM_RETRY_ATTEMPTS || !isProxyUnreachable(response) || (signal?.aborted ?? false))
+            return response;
+        await delay(STREAM_RETRY_DELAY_MS * attempt);
+    }
+}
+function isProxyUnreachable(response) {
+    if (response.status !== 502)
+        return false;
+    let value;
+    try {
+        value = JSON.parse(response.body);
+    }
+    catch {
+        return false;
+    }
+    const error = asRecord(asRecord(value)?.error);
+    return error?.code === PEER_HOST_ERROR_CODES.PROXY_UNREACHABLE;
+}
+export function readNativeRpcEnvelope(body) {
+    let value;
+    try {
+        value = JSON.parse(body);
+    }
+    catch {
+        throw new CodingNsRpcError('CODINGNS_RPC_RESPONSE_INVALID', 'PeerHost 原生 Remote 返回不是 JSON');
+    }
+    const envelope = record(value);
+    if (!Object.prototype.hasOwnProperty.call(envelope, 'result')) {
+        const proxyError = asRecord(envelope.error);
+        throw new CodingNsRpcError(typeof proxyError?.code === 'string' ? proxyError.code : 'CODINGNS_RPC_RESPONSE_INVALID', typeof proxyError?.message === 'string' ? proxyError.message : 'PeerHost 原生 Remote 响应格式无效');
+    }
+    const result = record(envelope.result);
+    if (result.ok === true)
+        return result.value;
+    const error = asRecord(result.error);
+    throw new CodingNsRpcError(typeof error?.code === 'string' ? error.code : 'CODINGNS_RPC_REMOTE_FAILED', typeof error?.message === 'string' ? error.message : 'PeerHost 原生 Remote 调用失败');
+}
+function record(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        throw new TypeError('PeerHost 原生 Remote 参数必须是对象');
+    return value;
+}
+function asRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value) ? value : null;
+}
+function requiredString(value, field) {
+    if (typeof value !== 'string' || value.trim() === '')
+        throw new TypeError(`${field} 不能为空`);
+    return value.trim();
+}
+//# sourceMappingURL=peer-host-native-transport.js.map

package/data/build/dist/host/modules/peer-host/peer-host-native-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-host-native-transport.js","sourceRoot":"","sources":["../../../../../../src/host/modules/peer-host/peer-host-native-transport.ts"],"names":[],"mappings":"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"}

package/data/build/dist/host/modules/peer-host/peer-host-relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-host-relay.d.ts","sourceRoot":"","sources":["../../../../../../src/host/modules/peer-host/peer-host-relay.ts"],"names":[],"mappings":"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"}

package/data/build/dist/host/modules/peer-host/peer-host-relay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-host-relay.js","sourceRoot":"","sources":["../../../../../../src/host/modules/peer-host/peer-host-relay.ts"],"names":[],"mappings":"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"}

package/data/build/dist/host/modules/peer-host/peer-host-remote-summary-source.d.ts

@@ -0,0 +1,53 @@
+import type { HostScope } from '../../../shared/contracts/peer-host.js';
+import type { PeerHostWorkspaceSessionSummarySource } from './peer-host-aggregate-service.js';
+/**
+ * 通过 PeerHost 原生 Remote 通道读取目标 Host 的 workspace/session 摘要。
+ *
+ * DSH 没有 workspace 列表的 REST 或 Remote 方法：`workspace/follow` 的首帧
+ * baseline 就是完整的工作区投影（含每个工作区的 sessionIds），会话元数据
+ * 则由 `session/list` 提供。代理层不能凭空假设 `/api/workspaces` 之类的路径。
+ */
+export interface PeerHostRemoteSummaryTransport {
+    rpc(request: {
+        readonly scope: HostScope;
+        readonly method: 'session/list';
+        readonly payload?: unknown;
+        readonly signal?: AbortSignal;
+    }): Promise<unknown>;
+    stream(request: {
+        readonly scope: HostScope;
+        readonly method: 'workspace/follow';
+        readonly payload?: unknown;
+        readonly signal?: AbortSignal;
+    }): AsyncIterable<unknown>;
+}
+export declare function createPeerHostRemoteSummarySource(input: {
+    readonly transport: PeerHostRemoteSummaryTransport;
+    readonly scope: HostScope;
+    /**
+     * 允许投影到侧栏的远端工作区 ID；缺省表示不过滤（仅测试与显式调用方使用）。
+     *
+     * 传空数组表示"用户尚未显式添加任何远端工作区"，此时返回空摘要且不访问目标
+     * Host——这是默认行为，不是降级，也不应伪装成远端没有工作区。
+     */
+    readonly visibleWorkspaceIds?: readonly string[];
+}): PeerHostWorkspaceSessionSummarySource;
+/** 供"添加工作区"选择器使用的远端工作区候选；不过滤，也不含会话正文。 */
+export interface PeerHostRemoteWorkspaceCandidate {
+    readonly workspaceId: string;
+    readonly displayName: string;
+    readonly path: string;
+    readonly sessionCount: number;
+}
+/**
+ * 读取远端 Host 已登记的全部工作区。
+ *
+ * 与摘要不同，这里**刻意不做可见性过滤**：选择器必须先看到全部候选，用户才能
+ * 决定要显式添加哪些。返回值不含会话正文、标题或凭据。
+ */
+export declare function readPeerHostRemoteWorkspaceCandidates(input: {
+    readonly transport: PeerHostRemoteSummaryTransport;
+    readonly scope: HostScope;
+    readonly signal?: AbortSignal;
+}): Promise<readonly PeerHostRemoteWorkspaceCandidate[]>;
+//# sourceMappingURL=peer-host-remote-summary-source.d.ts.map

package/data/build/dist/host/modules/peer-host/peer-host-remote-summary-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-host-remote-summary-source.d.ts","sourceRoot":"","sources":["../../../../../../src/host/modules/peer-host/peer-host-remote-summary-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAA;AACvE,OAAO,KAAK,EAAoD,qCAAqC,EAAE,MAAM,kCAAkC,CAAA;AAE/I;;;;;;GAMG;AACH,MAAM,WAAW,8BAA8B;IAC7C,GAAG,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACzJ,MAAM,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;CACvK;AAOD,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACvD,QAAQ,CAAC,SAAS,EAAE,8BAA8B,CAAA;IAClD,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACjD,GAAG,qCAAqC,CAgBxC;AAED,yCAAyC;AACzC,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B;AAED;;;;;GAKG;AACH,wBAAsB,qCAAqC,CAAC,KAAK,EAAE;IACjE,QAAQ,CAAC,SAAS,EAAE,8BAA8B,CAAA;IAClD,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B,GAAG,OAAO,CAAC,SAAS,gCAAgC,EAAE,CAAC,CAavD"}

package/data/build/dist/host/modules/peer-host/peer-host-remote-summary-source.js

@@ -0,0 +1,153 @@
+export function createPeerHostRemoteSummarySource(input) {
+    const visible = input.visibleWorkspaceIds === undefined ? null : new Set(input.visibleWorkspaceIds);
+    return {
+        capabilityId: 'peer-host.native-workspace-session-summary',
+        available: true,
+        async load(signal) {
+            // 没有可见工作区时不必访问目标 Host：省一次代理往返，也避免把"没有可见
+            // 工作区"和"远端不可达"混成同一个错误。
+            if (visible !== null && visible.size === 0)
+                return [];
+            const [baseline, sessions] = await Promise.all([
+                readWorkspaceBaseline(input.transport, input.scope, signal),
+                readSessionList(input.transport, input.scope, signal),
+            ]);
+            return buildRemoteSummary(baseline, sessions, visible);
+        },
+    };
+}
+/**
+ * 读取远端 Host 已登记的全部工作区。
+ *
+ * 与摘要不同，这里**刻意不做可见性过滤**：选择器必须先看到全部候选，用户才能
+ * 决定要显式添加哪些。返回值不含会话正文、标题或凭据。
+ */
+export async function readPeerHostRemoteWorkspaceCandidates(input) {
+    const baseline = await readWorkspaceBaseline(input.transport, input.scope, input.signal);
+    return baseline.items.flatMap((raw) => {
+        const value = asRecord(raw);
+        const workspaceId = readString(value, ['workspaceId', 'id', 'key']);
+        if (workspaceId === null)
+            return [];
+        return [{
+                workspaceId,
+                displayName: readString(value, ['title', 'displayName', 'name']) ?? workspaceId,
+                path: readString(value, ['path']) ?? workspaceId,
+                sessionCount: readStringList(value?.sessionIds).length,
+            }];
+    });
+}
+async function readWorkspaceBaseline(transport, scope, signal) {
+    // baseline 之后是长期增量流；摘要只需要首帧，取值后立即 return 关闭流。
+    for await (const frame of transport.stream({ scope, method: 'workspace/follow', ...(signal === undefined ? {} : { signal }) })) {
+        const frameRecord = asRecord(frame);
+        if (frameRecord?.type !== undefined && frameRecord.type !== 'baseline')
+            continue;
+        const value = asRecord(frameRecord?.value);
+        if (value === null)
+            continue;
+        return {
+            items: Array.isArray(value.items) ? value.items : [],
+            archivedSessionIds: readStringList(value.archivedSessionIds),
+        };
+    }
+    return { items: [], archivedSessionIds: [] };
+}
+async function readSessionList(transport, scope, signal) {
+    // DSH Remote 的线上载荷按 descriptor 的 wire 名组织；session/list 的参数 wire 是 `_request`。
+    const value = asRecord(await transport.rpc({ scope, method: 'session/list', payload: { args: { _request: {} } }, ...(signal === undefined ? {} : { signal }) }));
+    if (value === null || !Array.isArray(value.items))
+        return [];
+    return value.items.flatMap((item) => {
+        const record = asRecord(item);
+        return record === null ? [] : [record];
+    });
+}
+function buildRemoteSummary(baseline, sessions, visibleWorkspaceIds) {
+    const sessionsById = new Map();
+    for (const session of sessions) {
+        const sessionId = readString(session, ['sessionId', 'id', 'key']);
+        if (sessionId !== null && !sessionsById.has(sessionId))
+            sessionsById.set(sessionId, session);
+    }
+    const archived = new Set(baseline.archivedSessionIds);
+    return baseline.items.flatMap((raw) => {
+        const value = asRecord(raw);
+        const workspaceId = readString(value, ['workspaceId', 'id', 'key']);
+        if (workspaceId === null)
+            return [];
+        // 默认只投影用户显式添加的远端工作区；未在集合内的远端工作区不进入导航。
+        if (visibleWorkspaceIds !== null && !visibleWorkspaceIds.has(workspaceId))
+            return [];
+        const visible = [];
+        const archivedSessions = [];
+        for (const sessionId of readStringList(value?.sessionIds)) {
+            const session = sessionsById.get(sessionId) ?? null;
+            // 子代理会话在可见与归档两侧都不出现在宿主侧栏。
+            if (readString(session, ['origin']) === 'subagent')
+                continue;
+            const entry = {
+                sessionId,
+                blank: session?.blank === true,
+                title: readSessionTitle(session, sessionId),
+                status: session?.running === true ? 'running' : 'idle',
+                updatedAt: readTime(session),
+            };
+            if (archived.has(sessionId))
+                archivedSessions.push(entry);
+            else
+                visible.push(entry);
+        }
+        return [{
+                workspaceId,
+                displayName: readString(value, ['title', 'displayName', 'name']) ?? workspaceId,
+                // 原生文件面板按工作区路径解析，远端摘要必须携带真实路径而不是 workspaceId。
+                path: readString(value, ['path']) ?? workspaceId,
+                sessions: visible,
+                ...(archivedSessions.length === 0 ? {} : { archivedSessions }),
+            }];
+    });
+}
+function readSessionTitle(session, sessionId) {
+    // 空白会话的标题由 DSH 原生 UI 显示为“新会话”，不能用 cwd 伪造正式标题。
+    if (session?.blank === true)
+        return '';
+    // session/list 把持久标题放在 projections.values.title；没有投影时退回目录名。
+    const projected = readString(asRecord(asRecord(session?.projections)?.values), ['title']);
+    if (projected !== null)
+        return projected;
+    const cwd = readString(session, ['cwd']);
+    if (cwd === null)
+        return sessionId;
+    const name = directoryName(cwd);
+    return name === '' ? sessionId : name;
+}
+function directoryName(path) {
+    const segments = path.split(/[\\/]+/u).filter((segment) => segment !== '');
+    return segments.at(-1) ?? '';
+}
+function readStringList(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.flatMap((item) => typeof item === 'string' && item.trim() !== '' ? [item.trim()] : []);
+}
+function asRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value) ? value : null;
+}
+function readString(value, keys) {
+    if (value === null)
+        return null;
+    for (const key of keys) {
+        const candidate = value[key];
+        if (typeof candidate === 'string' && candidate.trim() !== '')
+            return candidate.trim();
+    }
+    return null;
+}
+function readTime(value) {
+    if (value === null)
+        return 0;
+    const candidate = value.updatedAt;
+    return typeof candidate === 'number' && Number.isFinite(candidate) ? candidate : 0;
+}
+//# sourceMappingURL=peer-host-remote-summary-source.js.map

package/data/build/dist/host/modules/peer-host/peer-host-remote-summary-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-host-remote-summary-source.js","sourceRoot":"","sources":["../../../../../../src/host/modules/peer-host/peer-host-remote-summary-source.ts"],"names":[],"mappings":"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"}

package/data/build/dist/host/modules/peer-host/peer-host-session.d.ts

@@ -28,7 +28,26 @@ export declare class PeerHostSessionService {
     login(peerHostId: string, input: PeerHostLoginInput): Promise<PeerHostSessionView>;
     refresh(peerHostId: string): Promise<PeerHostSessionView>;
     getAccessToken(peerHostId: string): Promise<string>;
-    /** 目标 Host 明确拒绝当前 token 时，只清理该 PeerHost 的登录态。 */
+    /**
+     * 用 refreshToken 续期；失败返回 null，交给调用方决定是否静默重登。
+     *
+     * 这里刻意不清除凭据：网络抖动导致的失败不应该抹掉用户在编辑里保存的账号，
+     * 否则"只保存一次"的语义会被一次断网破坏。
+     */
+    private tryRefresh;
+    /**
+     * 用编辑时保存的账号密码静默重登。
+     *
+     * 只有目标明确拒绝该账号（401 → SESSION_REQUIRED）时才清除凭据，避免用过期
+     * 口令反复重试；网络类失败保留凭据，等待下一次请求再试。
+     */
+    private trySavedLogin;
+    /**
+     * 目标 Host 明确拒绝当前 token 时的恢复入口。
+     *
+     * 保存了账号密码时先尝试静默重登：目标是"编辑里保存一次，之后一直能连"，
+     * 因此一次 401 不应该直接把用户打回手工登录。重登失败才清理登录态。
+     */
     invalidate(peerHostId: string): Promise<void>;
     logout(peerHostId: string): Promise<PeerHostSessionView>;
     private ensureReady;

package/data/build/dist/host/modules/peer-host/peer-host-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-host-session.d.ts","sourceRoot":"","sources":["../../../../../../src/host/modules/peer-host/peer-host-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,wCAAwC,CAAA;AAE/F,OAAO,EAAE,aAAa,EAAE,KAAK,uBAAuB,EAA4B,MAAM,sBAAsB,CAAA;AAE5G,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAAA;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAChC;AAED,kDAAkD;AAClD,qBAAa,sBAAsB;IAM/B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;gBAGnB,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,uBAAuB,EACpC,OAAO,GAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,sBAA2B;IAOjF,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAclF,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAYzD,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYzD;;;;;OAKG;YACW,UAAU;IAaxB;;;;;OAKG;YACW,aAAa;IAkB3B;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7C,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;YAgBhD,WAAW;YAWX,OAAO;YA0BP,eAAe;CAI9B;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,iBAAiB;gBAAvB,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM;CAI9D"}