@jingyi0605/codingns4dsh 0.1.2 → 0.1.7-rc.3

package/data/build/dist/shared/contracts/cli-adapter.d.ts

@@ -81,6 +81,11 @@ export interface CodingNsCliTurnInput {
     readonly rawStoreRef?: string;
     /** 仅由 Host 的 DSH 分段桥接使用；让支持的 Provider 在工具完成处结束当前 step。 */
     readonly splitToolSteps?: boolean;
+    /**
+     * 仅由 Host 的 DSH 分段桥接使用；显式说明这次调用是在续接上一次被切分的
+     * Provider 运行，而不是新的用户回合。驱动据此复用常驻进程。
+     */
+    readonly resumeSegmentedTurn?: boolean;
 }
 export interface CodingNsAgentPermissionResponse {
     readonly requestId: string;
@@ -167,15 +172,20 @@ export type CodingNsAgentEvent = {
     readonly channel: 'reasoning' | 'text';
     readonly messageId: string;
 } | {
-    /** Provider 已完成一个外部工具，Host 应在当前流结束后注入下一个 DSH step。 */
+    /** Provider 的 assistant item 已切换，Host 应在当前流结束后注入下一个 DSH step。 */
     readonly type: 'step-boundary';
 } | CodingNsAgentToolEvent | {
     readonly type: 'usage';
-    /** Command Code 的 inputTokens 是包含缓存读写的完整输入。 */
+    /**
+     * Provider 上报的输入口径：Codex、Command Code 的 inputTokens 已包含缓存读写，
+     * Anthropic 风格的 input 不含缓存。公共投影层按 `uncachedInputTokens` 折算成
+     * DSH 的互斥桶口径（inputTokens 只含未缓存输入）后再交给 token-meter。
+     */
     readonly inputTokens: number;
     readonly outputTokens: number;
     readonly cacheReadTokens?: number;
     readonly cacheWriteTokens?: number;
+    /** 未缓存输入；Provider 给出缓存分桶时由 `usageChunk` 计算。 */
     readonly uncachedInputTokens?: number;
     readonly totalTokens?: number;
     /** 缓存读取 / 完整输入，百分比取值 0 到 100。 */
@@ -202,5 +212,16 @@ export type CodingNsAgentEvent = {
     readonly type: 'question-request';
     readonly requestId: string;
     readonly questions: readonly CodingNsAgentQuestion[];
+} | {
+    /** Provider 上下文压缩生命周期；由公共消息投影层写入 DSH 原生事件。 */
+    readonly type: 'context-compaction';
+    readonly phase: 'start' | 'summary' | 'end';
+    readonly compactionId?: string;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly summary?: string;
+    readonly shadowedItemCount?: number;
+    readonly shadowedTokenCount?: number;
+    readonly error?: string;
 };
 //# sourceMappingURL=cli-adapter.d.ts.map

package/data/build/dist/shared/contracts/config.d.ts

@@ -17,6 +17,8 @@ export interface CodingNsSettings {
     terminalEnhancement: TerminalEnhancementSettings;
     /** 原生工作区会话行的浏览器端增强选项。 */
     workspaceSessionEnhancement: WorkspaceSessionEnhancementSettings;
+    /** DSH 文件管理侧栏的独立增强选项。 */
+    fileManagement: FileManagementSettings;
     /**
      * 功能模块启用意图：模块名 -> 是否启用。
      *
@@ -74,11 +76,23 @@ export interface WorkspaceSessionEnhancementSettings {
     showSubscriptionUsage: boolean;
     /** 是否在输入工具区显示快捷会话入口。 */
     showQuickPhrases: boolean;
+    /** 是否记忆对话窗口与右侧栏的宽度比例；具体比例保存在当前浏览器。 */
+    rememberConversationRightbarRatio: boolean;
     /** 插件本地保存的快捷会话条目。 */
     quickPhrases: QuickPhrase[];
     /** 内置快捷会话是否已经完成首次初始化；仅用于兼容旧配置。 */
     quickPhrasesSeeded: boolean;
 }
+/** 文件管理增强的独立能力开关。 */
+export interface FileManagementSettings {
+    /** 是否为文件和目录显示右键操作菜单。 */
+    menuEnhancement: boolean;
+    /** 是否为可编辑文本文件显示编辑器入口。 */
+    fileEditor: boolean;
+    /** 是否在当前会话顶部显示“修改文件”视图。 */
+    sessionChangedFiles: boolean;
+}
+export declare const DEFAULT_FILE_MANAGEMENT_SETTINGS: FileManagementSettings;
 /** 可复用的快捷会话文本。 */
 export interface QuickPhrase {
     id: string;
@@ -117,6 +131,7 @@ export declare const CODINGNS_MODULES_FIELD = "modules";
 export declare const CODINGNS_LAN_ACCESS_DSH_FIELD = "lanAccessDsh";
 export declare const CODINGNS_TERMINAL_ENHANCEMENT_FIELD = "terminalEnhancement";
 export declare const CODINGNS_WORKSPACE_SESSION_ENHANCEMENT_FIELD = "workspaceSessionEnhancement";
+export declare const CODINGNS_FILE_MANAGEMENT_FIELD = "fileManagement";
 export declare const DEFAULT_CODINGNS_CONTROL_BASE_URL = "https://channel.codingns.com:1443";
 export declare const DEFAULT_CODINGNS_CONTROL_BASE_URLS: string[];
 /** 控制站的网页登录地址，用于注册 Codingns4DSH 账号。 */

package/data/build/dist/shared/contracts/config.js

@@ -1,4 +1,9 @@
 import { isDshVersionAtLeast } from './version.js';
+export const DEFAULT_FILE_MANAGEMENT_SETTINGS = {
+    menuEnhancement: true,
+    fileEditor: true,
+    sessionChangedFiles: true,
+};
 /** 首次启用快捷会话时提供的内置指令。 */
 export const DEFAULT_QUICK_PHRASES = [
     { id: 'builtin-quick-1', text: '请将本次会话变更的所有代码提交到git暂存区，然后总结一条中文的提交信息' },
@@ -22,6 +27,7 @@ export const CODINGNS_MODULES_FIELD = 'modules';
 export const CODINGNS_LAN_ACCESS_DSH_FIELD = 'lanAccessDsh';
 export const CODINGNS_TERMINAL_ENHANCEMENT_FIELD = 'terminalEnhancement';
 export const CODINGNS_WORKSPACE_SESSION_ENHANCEMENT_FIELD = 'workspaceSessionEnhancement';
+export const CODINGNS_FILE_MANAGEMENT_FIELD = 'fileManagement';
 export const DEFAULT_CODINGNS_CONTROL_BASE_URL = 'https://channel.codingns.com:1443';
 export const DEFAULT_CODINGNS_CONTROL_BASE_URLS = [DEFAULT_CODINGNS_CONTROL_BASE_URL];
 /** 控制站的网页登录地址，用于注册 Codingns4DSH 账号。 */
@@ -51,6 +57,7 @@ export const DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS = {
     hiddenWorkspaceIds: [],
     showSubscriptionUsage: true,
     showQuickPhrases: true,
+    rememberConversationRightbarRatio: false,
     quickPhrases: DEFAULT_QUICK_PHRASES.map((phrase) => ({ ...phrase })),
     quickPhrasesSeeded: true,
 };
@@ -62,6 +69,7 @@ export const DEFAULT_CODINGNS_SETTINGS = {
     agentAdapterPreferences: {},
     terminalEnhancement: DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS,
     workspaceSessionEnhancement: DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS,
+    fileManagement: DEFAULT_FILE_MANAGEMENT_SETTINGS,
     lanAccessDsh: {
         autoStart: false,
         listenHost: '0.0.0.0',
@@ -86,6 +94,8 @@ export function captureRestartFeatureStates(descriptors, settings, dshVersion) {
  * 用户没有表达过意图时使用模块自己声明的 enabledByDefault。
  */
 export function isFeatureEnabled(descriptor, settings) {
+    if (descriptor.disabled === true)
+        return false;
     if (descriptor.ui?.alwaysEnabled === true)
         return true;
     return settings?.modules[descriptor.name] ?? descriptor.enabledByDefault;

package/data/build/dist/shared/contracts/dsh-device.d.ts

@@ -45,6 +45,8 @@ export interface DshDeviceHeartbeatResponse {
 export interface DshDeviceHeartbeatRequest {
     dshVersion?: string;
     computerName?: string;
+    /** Host 当前使用的 DTLS 身份指纹，用于防止设备凭据串用。 */
+    dtlsFingerprint?: string;
 }
 export interface DshRelayTicketRequest {
     dshDeviceId: string;

package/data/build/dist/shared/contracts/errors.d.ts

@@ -19,6 +19,20 @@ export declare const CODINGNS_DSH_ERROR_CODES: {
     readonly DEBUG_RUNTIME_NOT_FOUND: "DEBUG_RUNTIME_NOT_FOUND";
     readonly DEBUG_PROXY_ROUTE_NOT_FOUND: "DEBUG_PROXY_ROUTE_NOT_FOUND";
     readonly DEBUG_DSH_HOST_API_UNAVAILABLE: "DEBUG_DSH_HOST_API_UNAVAILABLE";
+    readonly PEER_HOST_NOT_READY: "PEER_HOST_NOT_READY";
+    readonly PEER_HOST_PROXY_PATH_NOT_ALLOWED: "PEER_HOST_PROXY_PATH_NOT_ALLOWED";
+    readonly PEER_HOST_SCOPE_MISMATCH: "PEER_HOST_SCOPE_MISMATCH";
+    readonly PEER_HOST_PROXY_UNREACHABLE: "PEER_HOST_PROXY_UNREACHABLE";
+    readonly PEER_HOST_RESPONSE_INVALID: "PEER_HOST_RESPONSE_INVALID";
+    readonly PEER_HOST_TOOL_UNSUPPORTED: "PEER_HOST_TOOL_UNSUPPORTED";
+    readonly PEER_HOST_INVALID_ROUTE: "PEER_HOST_INVALID_ROUTE";
+    readonly PEER_HOST_DUPLICATE: "PEER_HOST_DUPLICATE";
+    readonly PEER_HOST_PLUGIN_MISSING: "PEER_HOST_PLUGIN_MISSING";
+    readonly PEER_HOST_IDENTITY_CHANGED: "PEER_HOST_IDENTITY_CHANGED";
+    readonly PEER_HOST_UNREACHABLE: "PEER_HOST_UNREACHABLE";
+    readonly PEER_HOST_RELAY_UNAVAILABLE: "PEER_HOST_RELAY_UNAVAILABLE";
+    readonly PEER_HOST_AGGREGATE_UNAVAILABLE: "PEER_HOST_AGGREGATE_UNAVAILABLE";
+    readonly PEER_HOST_STALE_GENERATION: "PEER_HOST_STALE_GENERATION";
 };
 export declare const SUPPORTED_DSH_VERSION: "0.1.6-alpha.2";
 export declare const SUPPORTED_DSH_COMPATIBILITY: ">=0.1.5-rc.3 <=0.1.7-rc.2";

package/data/build/dist/shared/contracts/errors.js

@@ -1,4 +1,5 @@
 import { DSH_COMPATIBILITY, DSH_VERSION, isDshVersionCompatible } from './version.js';
+import { PEER_HOST_ERROR_CODES } from './peer-host.js';
 export const CODINGNS_DSH_ERROR_CODES = {
     PLUGIN_MANIFEST_INVALID: 'PLUGIN_MANIFEST_INVALID',
     DSH_VERSION_UNSUPPORTED: 'DSH_VERSION_UNSUPPORTED',
@@ -20,6 +21,20 @@ export const CODINGNS_DSH_ERROR_CODES = {
     DEBUG_RUNTIME_NOT_FOUND: 'DEBUG_RUNTIME_NOT_FOUND',
     DEBUG_PROXY_ROUTE_NOT_FOUND: 'DEBUG_PROXY_ROUTE_NOT_FOUND',
     DEBUG_DSH_HOST_API_UNAVAILABLE: 'DEBUG_DSH_HOST_API_UNAVAILABLE',
+    PEER_HOST_NOT_READY: PEER_HOST_ERROR_CODES.NOT_READY,
+    PEER_HOST_PROXY_PATH_NOT_ALLOWED: PEER_HOST_ERROR_CODES.PROXY_PATH_NOT_ALLOWED,
+    PEER_HOST_SCOPE_MISMATCH: PEER_HOST_ERROR_CODES.SCOPE_MISMATCH,
+    PEER_HOST_PROXY_UNREACHABLE: PEER_HOST_ERROR_CODES.PROXY_UNREACHABLE,
+    PEER_HOST_RESPONSE_INVALID: PEER_HOST_ERROR_CODES.RESPONSE_INVALID,
+    PEER_HOST_TOOL_UNSUPPORTED: PEER_HOST_ERROR_CODES.TOOL_UNSUPPORTED,
+    PEER_HOST_INVALID_ROUTE: PEER_HOST_ERROR_CODES.INVALID_ROUTE,
+    PEER_HOST_DUPLICATE: PEER_HOST_ERROR_CODES.DUPLICATE,
+    PEER_HOST_PLUGIN_MISSING: PEER_HOST_ERROR_CODES.PLUGIN_MISSING,
+    PEER_HOST_IDENTITY_CHANGED: PEER_HOST_ERROR_CODES.IDENTITY_CHANGED,
+    PEER_HOST_UNREACHABLE: PEER_HOST_ERROR_CODES.UNREACHABLE,
+    PEER_HOST_RELAY_UNAVAILABLE: PEER_HOST_ERROR_CODES.RELAY_UNAVAILABLE,
+    PEER_HOST_AGGREGATE_UNAVAILABLE: PEER_HOST_ERROR_CODES.AGGREGATE_UNAVAILABLE,
+    PEER_HOST_STALE_GENERATION: PEER_HOST_ERROR_CODES.STALE_GENERATION,
 };
 export const SUPPORTED_DSH_VERSION = DSH_VERSION;
 export const SUPPORTED_DSH_COMPATIBILITY = DSH_COMPATIBILITY;

package/data/build/dist/shared/contracts/feature.d.ts

@@ -36,6 +36,8 @@ export interface FeatureDescriptor {
     name: string;
     version: string;
     enabledByDefault: boolean;
+    /** 维护期间强制停用；即使历史设置为 true 也不得启动。 */
+    disabled?: boolean;
     dependencies: string[];
     runtime: FeatureRuntime;
     /** `restart` 表示只保存下次启动意图，当前进程不跟随设置变化启停。 */

package/data/build/dist/shared/contracts/file-management.d.ts

@@ -0,0 +1,6 @@
+/** 文件管理增强与 Host 之间传输的会话修改文件契约。 */
+export interface SessionChangedFiles {
+    /** 按工作区相对路径规范化后的文件路径。 */
+    readonly paths: readonly string[];
+}
+//# sourceMappingURL=file-management.d.ts.map

package/data/build/dist/shared/contracts/file-management.js

@@ -0,0 +1,3 @@
+/** 文件管理增强与 Host 之间传输的会话修改文件契约。 */
+export {};
+//# sourceMappingURL=file-management.js.map

package/data/build/dist/shared/contracts/peer-host.d.ts

@@ -1,31 +1,132 @@
-export type PeerHostStatus = 'unknown' | 'checking' | 'ready' | 'unreachable' | 'version_mismatch' | 'session_required' | 'disabled';
+/** PeerHost 目标路由；短期 relay ticket 永远不属于持久配置。 */
+export type PeerHostRoute = {
+    readonly kind: 'lan';
+    readonly baseUrl: string;
+    readonly normalizedOrigin: string;
+} | {
+    readonly kind: 'relay';
+    readonly deviceId: string;
+    readonly relayEntryId: string;
+    readonly transportVersion: string;
+};
+export type PeerHostStatus = 'configured' | 'checking' | 'ready' | 'plugin_missing' | 'version_mismatch' | 'identity_changed' | 'session_required' | 'unreachable' | 'reconnecting' | 'disabled';
+/** Host 侧保存的 PeerHost 配置与脱敏握手状态。凭据不在此 DTO 中。 */
 export interface PeerHostRecord {
-    peerHostId: string;
-    name: string;
-    baseUrl: string;
-    status: PeerHostStatus;
-    remoteVersion: string | null;
-    remoteApiCompatibility: string | null;
-    remoteHostFingerprint: string | null;
-    lastCheckedAt: string | null;
-    lastErrorCode: string | null;
+    readonly id: string;
+    readonly ownerUserId: string;
+    readonly displayName: string;
+    readonly route: PeerHostRoute;
+    readonly status: PeerHostStatus;
+    readonly pluginId: string | null;
+    readonly pluginVersion: string | null;
+    readonly dshVersion: string | null;
+    readonly apiCompatibility: string | null;
+    readonly fingerprint: string | null;
+    readonly lastCheckedAt: number | null;
+    readonly lastErrorCode: PeerHostErrorCode | null;
+    readonly createdAt: number;
+    readonly updatedAt: number;
 }
+/** Client 管理面板可见的 PeerHost 摘要；路由详情和所有凭据只留在 Host。 */
+export type PeerHostClientRoute = {
+    readonly kind: 'lan';
+} | {
+    readonly kind: 'relay';
+};
+export type PeerHostClientRecord = Omit<PeerHostRecord, 'route'> & {
+    readonly route: PeerHostClientRoute;
+};
+/** Client 可见的 PeerHost 诊断快照；不包含完整路由、凭据或正文。 */
+export interface PeerHostDiagnosticSnapshot {
+    readonly peerHostId: string;
+    readonly routeKind: 'lan' | 'relay';
+    readonly status: PeerHostStatus;
+    readonly lastErrorCode: PeerHostErrorCode | null;
+    readonly lastCheckedAt: number | null;
+    readonly fingerprint: string | null;
+}
+/** 当前 Host 插件自有 WebSocket 入口；不包含任何目标 Host 地址或凭据。 */
+export interface PeerHostWebSocketEndpoint {
+    readonly host: string;
+    readonly port: number;
+    readonly path: string;
+}
+/** 所有跨 Host 资源共用的完整作用域。 */
+export interface HostScope {
+    readonly hostId: string;
+    readonly targetHostId: string | null;
+    readonly workspaceId: string;
+    readonly sessionId: string | null;
+    readonly scopeGeneration: number;
+}
+/** 会话摘要只用于聚合导航，不包含历史消息或工具内容。 */
+export interface PeerHostSessionRecord {
+    readonly scope: HostScope;
+    readonly title: string;
+    readonly status: string;
+    readonly updatedAt: number;
+}
+/** 当前 Host 和 PeerHost 统一使用的工作区摘要。 */
+export interface AggregateWorkspaceSummary {
+    readonly key: string;
+    readonly hostId: string;
+    readonly targetHostId: string | null;
+    readonly workspaceId: string;
+    readonly displayName: string;
+    readonly hostLabel: string;
+    readonly availability: 'ready' | 'checking' | 'unreachable' | 'unsupported';
+    readonly sessions: readonly PeerHostSessionRecord[];
+}
+export interface AggregateHostResult {
+    readonly hostId: string;
+    readonly targetHostId: string | null;
+    readonly hostLabel: string;
+    readonly availability: 'ready' | 'checking' | 'unreachable' | 'unsupported';
+    readonly errorCode: PeerHostErrorCode | null;
+    /** 摘要能力不可用时保留可诊断原因，禁止以空工作区伪装成功。 */
+    readonly diagnostic?: string;
+    readonly workspaces: readonly AggregateWorkspaceSummary[];
+}
+export declare const PEER_HOST_ERROR_CODES: {
+    readonly NOT_FOUND: "PEER_HOST_NOT_FOUND";
+    readonly NOT_READY: "PEER_HOST_NOT_READY";
+    readonly SESSION_REQUIRED: "PEER_HOST_SESSION_REQUIRED";
+    readonly PROXY_PATH_NOT_ALLOWED: "PEER_HOST_PROXY_PATH_NOT_ALLOWED";
+    readonly SCOPE_MISMATCH: "PEER_HOST_SCOPE_MISMATCH";
+    readonly PROXY_UNREACHABLE: "PEER_HOST_PROXY_UNREACHABLE";
+    readonly RESPONSE_INVALID: "PEER_HOST_RESPONSE_INVALID";
+    readonly TOOL_UNSUPPORTED: "PEER_HOST_TOOL_UNSUPPORTED";
+    readonly INVALID_ROUTE: "PEER_HOST_INVALID_ROUTE";
+    readonly DUPLICATE: "PEER_HOST_DUPLICATE";
+    readonly PLUGIN_MISSING: "PEER_HOST_PLUGIN_MISSING";
+    readonly VERSION_MISMATCH: "PEER_HOST_VERSION_MISMATCH";
+    readonly IDENTITY_CHANGED: "PEER_HOST_IDENTITY_CHANGED";
+    readonly UNREACHABLE: "PEER_HOST_UNREACHABLE";
+    readonly RELAY_UNAVAILABLE: "PEER_HOST_RELAY_UNAVAILABLE";
+    readonly AGGREGATE_UNAVAILABLE: "PEER_HOST_AGGREGATE_UNAVAILABLE";
+    readonly STALE_GENERATION: "PEER_HOST_STALE_GENERATION";
+};
+export type PeerHostErrorCode = typeof PEER_HOST_ERROR_CODES[keyof typeof PEER_HOST_ERROR_CODES];
+/** 可安全返回 Client 的结构化错误，不携带凭据、完整 URL 或内容数据。 */
+export interface PeerHostErrorShape {
+    readonly code: PeerHostErrorCode;
+    readonly peerHostId?: string;
+    readonly message: string;
+}
+/** 作用域管理器仍使用的兼容引用；新跨 Host 代码应优先使用 HostScope。 */
 export interface ResourceScopeRef {
     hostId: string;
     workspaceId: string;
     targetHostId: string | null;
     scopeGeneration: number;
+    sessionId?: string | null;
 }
-/**
- * 作用域切换时使用的输入，不允许调用方自行伪造 generation。
- * generation 只能由 ResourceScopeManager 分配。
- */
 export interface ResourceScopeInput {
     hostId: string;
     workspaceId: string;
     targetHostId: string | null;
+    sessionId?: string | null;
 }
-/** 对外暴露的只读作用域快照。 */
 export type ResourceScopeSnapshot = Readonly<ResourceScopeRef>;
 /** 作用域拥有的清理函数。清理函数必须可重复调用而不会产生副作用。 */
 export type ResourceScopeDisposer = () => void | Promise<void>;

package/data/build/dist/shared/contracts/peer-host.js

@@ -1,3 +1,22 @@
+export const PEER_HOST_ERROR_CODES = {
+    NOT_FOUND: 'PEER_HOST_NOT_FOUND',
+    NOT_READY: 'PEER_HOST_NOT_READY',
+    SESSION_REQUIRED: 'PEER_HOST_SESSION_REQUIRED',
+    PROXY_PATH_NOT_ALLOWED: 'PEER_HOST_PROXY_PATH_NOT_ALLOWED',
+    SCOPE_MISMATCH: 'PEER_HOST_SCOPE_MISMATCH',
+    PROXY_UNREACHABLE: 'PEER_HOST_PROXY_UNREACHABLE',
+    RESPONSE_INVALID: 'PEER_HOST_RESPONSE_INVALID',
+    TOOL_UNSUPPORTED: 'PEER_HOST_TOOL_UNSUPPORTED',
+    INVALID_ROUTE: 'PEER_HOST_INVALID_ROUTE',
+    DUPLICATE: 'PEER_HOST_DUPLICATE',
+    PLUGIN_MISSING: 'PEER_HOST_PLUGIN_MISSING',
+    VERSION_MISMATCH: 'PEER_HOST_VERSION_MISMATCH',
+    IDENTITY_CHANGED: 'PEER_HOST_IDENTITY_CHANGED',
+    UNREACHABLE: 'PEER_HOST_UNREACHABLE',
+    RELAY_UNAVAILABLE: 'PEER_HOST_RELAY_UNAVAILABLE',
+    AGGREGATE_UNAVAILABLE: 'PEER_HOST_AGGREGATE_UNAVAILABLE',
+    STALE_GENERATION: 'PEER_HOST_STALE_GENERATION',
+};
 /** 作用域已经失效时统一抛出的错误。 */
 export class ResourceScopeStaleError extends Error {
     code = 'RESOURCE_SCOPE_STALE';

package/data/build/dist/shared/contracts/version.d.ts

@@ -11,7 +11,7 @@ export declare const CODINGNS_DSH_VERSION_GLOBAL: "__CODINGNS_DSH_VERSION__";
 /** 识别没有 alpha2 Sidebar 扩展 API 的 DSH 旧版运行时。 */
 export declare function isLegacyDshVersion(version: string): boolean;
 /** Codingns4DSH 插件自身的 npm 版本。 */
-export declare const CODINGNS_VERSION: "0.1.2";
+export declare const CODINGNS_VERSION: "0.1.7-rc.3";
 /** 判断宿主版本是否落在当前插件声明的 DSH 兼容范围内。 */
 export declare function isDshVersionCompatible(version: string): boolean;
 /** 判断 DSH 版本是否达到某个功能模块要求的最低版本。 */

package/data/build/dist/shared/contracts/version.js

@@ -13,7 +13,7 @@ export function isLegacyDshVersion(version) {
     return /^0\.1\.5(?:-|$)/u.test(version);
 }
 /** Codingns4DSH 插件自身的 npm 版本。 */
-export const CODINGNS_VERSION = '0.1.2';
+export const CODINGNS_VERSION = '0.1.7-rc.3';
 /** 判断宿主版本是否落在当前插件声明的 DSH 兼容范围内。 */
 export function isDshVersionCompatible(version) {
     const match = /^>=([^ ]+) <=([^ ]+)$/u.exec(DSH_COMPATIBILITY);

package/data/build/dist/shared/index.d.ts

@@ -1,4 +1,4 @@
-export { CODINGNS_CONTROL_BASE_URL_FIELD, CODINGNS_CONTROL_BASE_URLS_FIELD, CODINGNS_CONTROL_STATION_URL, CODINGNS_H5_LOGIN_URL, CODINGNS_LAN_ACCESS_DSH_FIELD, CODINGNS_TERMINAL_ENHANCEMENT_FIELD, CODINGNS_WORKSPACE_SESSION_ENHANCEMENT_FIELD, CODINGNS_MODULES_FIELD, CODINGNS_SETTINGS_NAMESPACE, CODINGNS_SETTINGS_ENTRY_IDS, DEFAULT_CODINGNS_CONTROL_BASE_URL, DEFAULT_CODINGNS_CONTROL_BASE_URLS, DEFAULT_CODINGNS_SETTINGS, DEFAULT_QUICK_PHRASES, DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS, DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS, captureRestartFeatureStates, enabledFeatureNames, isFeatureDshVersionCompatible, isFeatureEnabled, isCodingNsSettingsEntryId, type CodingNsSettings, type CodingNsConfig, type CodingNsRuntimeState, type CodingNsCliAdapterPreference, type LanAccessDshSettings, type LanAccessDshLoginSettings, type LoginProtectionScopes, type RestartFeatureStates, type TerminalAppearanceSettings, type TerminalAppearanceTheme, type TerminalBindingScope, type TerminalCursorStyle, type TerminalEnhancementSettings, type TerminalProfileId, type QuickPhrase, type WorkspaceSessionEnhancementSettings, } from './contracts/config.js';
+export { CODINGNS_CONTROL_BASE_URL_FIELD, CODINGNS_CONTROL_BASE_URLS_FIELD, CODINGNS_CONTROL_STATION_URL, CODINGNS_H5_LOGIN_URL, CODINGNS_LAN_ACCESS_DSH_FIELD, CODINGNS_TERMINAL_ENHANCEMENT_FIELD, CODINGNS_WORKSPACE_SESSION_ENHANCEMENT_FIELD, CODINGNS_FILE_MANAGEMENT_FIELD, CODINGNS_MODULES_FIELD, CODINGNS_SETTINGS_NAMESPACE, CODINGNS_SETTINGS_ENTRY_IDS, DEFAULT_CODINGNS_CONTROL_BASE_URL, DEFAULT_CODINGNS_CONTROL_BASE_URLS, DEFAULT_CODINGNS_SETTINGS, DEFAULT_QUICK_PHRASES, DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS, DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS, DEFAULT_FILE_MANAGEMENT_SETTINGS, captureRestartFeatureStates, enabledFeatureNames, isFeatureDshVersionCompatible, isFeatureEnabled, isCodingNsSettingsEntryId, type CodingNsSettings, type CodingNsConfig, type CodingNsRuntimeState, type CodingNsCliAdapterPreference, type LanAccessDshSettings, type LanAccessDshLoginSettings, type LoginProtectionScopes, type RestartFeatureStates, type TerminalAppearanceSettings, type TerminalAppearanceTheme, type TerminalBindingScope, type TerminalCursorStyle, type TerminalEnhancementSettings, type TerminalProfileId, type QuickPhrase, type WorkspaceSessionEnhancementSettings, type FileManagementSettings, } from './contracts/config.js';
 export type { FeatureContext, FeatureActivation, FeatureDescriptor, FeatureCapabilityRequirement, FeatureDisposer, FeatureModule, FeatureResourceScope, FeatureRuntime, FeatureState, FeatureUiDescriptor, } from './contracts/feature.js';
 export type { DshCapabilityDiagnostic, DshCapabilityId, DshCapabilityProfile, DshCapabilityResolution, DshCapabilityResolutionStatus, DshCapabilityRoute, DshCapabilityRouteStatus, DshCapabilityRuntime, } from '../dsh-capabilities/types.js';
 export { CODINGNS_DSH_ERROR_CODES, CodingNsDshError, SUPPORTED_DSH_COMPATIBILITY, SUPPORTED_DSH_VERSION, assertSupportedDshVersion, type CodingNsDshErrorCode, } from './contracts/errors.js';
@@ -9,9 +9,10 @@ export { CODINGNS_RPC_CHANNEL } from './contracts/transport.js';
 export type { CodingNsCliAdapterDescriptor, CodingNsCliAdapterId, CodingNsCliCapability, CodingNsAgentEvent, CodingNsAgentQuestion, CodingNsAgentQuestionResponse, CodingNsAgentToolEvent, CodingNsCliMessage, CodingNsCliModel, CodingNsCliModelCatalog, CodingNsCliModelGroup, CodingNsAgentPermissionResponse, CodingNsCliSessionConfig, CodingNsCliSessionRecord, CodingNsCliProviderSessionState, CodingNsCliSessionStatus, CodingNsSessionAdapterBinding, CodingNsCliTurnInput, } from './contracts/cli-adapter.js';
 export type { CommandCodeSubscriptionUsage, CommandCodeSubscriptionWindow, } from './contracts/command-code.js';
 export type { GitBranchItem, GitBranchSnapshot, GitChangeItem, GitCommitResult, GitDiff, GitHistoryItem, GitHistoryPage, GitHistoryRef, GitRepoSnapshot, GitStatus, } from './contracts/git.js';
+export type { SessionChangedFiles } from './contracts/file-management.js';
 export type { CliSubscriptionProvider, CliSubscriptionUsage, CliSubscriptionWindow, DeepseekBalance, DeepseekUsage, ProviderBalanceUsage, Sub2ApiDailyUsage, Sub2ApiModelUsage, Sub2ApiUsage, Sub2ApiUsagePoint, } from './contracts/subscription.js';
-export type { PeerHostRecord, PeerHostStatus, ResourceScopeDisposer, ResourceScopeInput, ResourceScopeRef, ResourceScopeSnapshot, } from './contracts/peer-host.js';
-export { ResourceScopeStaleError } from './contracts/peer-host.js';
+export type { AggregateWorkspaceSummary, AggregateHostResult, HostScope, PeerHostErrorCode, PeerHostErrorShape, PeerHostRoute, PeerHostRecord, PeerHostClientRoute, PeerHostClientRecord, PeerHostSessionRecord, PeerHostWebSocketEndpoint, PeerHostStatus, ResourceScopeDisposer, ResourceScopeInput, ResourceScopeRef, ResourceScopeSnapshot, } from './contracts/peer-host.js';
+export { PEER_HOST_ERROR_CODES, ResourceScopeStaleError } from './contracts/peer-host.js';
 export { DEBUG_ERROR_CODES, DEBUG_RPC_ENDPOINTS, parseDebugMutationScope, parseDebugPtyLaunchRequest, parseDebugRpcScope, type DebugAiFallbackState, type DebugCompatibilityLevel, type DebugErrorCode, type DebugMutationScope, type DebugPortState, type DebugProcessInstance, type DebugProcessOwnership, type DebugPlanState, type DebugProxyProtocol, type DebugPtyLaunchRequest, type DebugRpcEndpoint, type DebugRpcScope, type DebugRuntimeMode, type DebugRuntimeState, } from './contracts/debug.js';
 export type { LanAccessDshConfig, LanAccessDshLoginConfig, LanAccessDshSnapshot, LanAccessDshState, } from './contracts/lan-access-dsh.js';
 export type { CodingNsTerminalCreateRequest, CodingNsTerminalEnvironment, CodingNsTerminalFrame, CodingNsTerminalRetentionFrame, CodingNsTerminalRuntimeType, CodingNsTerminalShell, CodingNsTerminalShellOption, CodingNsTerminalStatus, CodingNsTerminalState, CodingNsWebTerminalInfo, PersistentTerminalRecord, TerminalAttachmentRecord, TerminalOwnerScope, TerminalRecordIdentity, } from './contracts/terminal.js';

package/data/build/dist/shared/index.js

@@ -1,9 +1,9 @@
-export { CODINGNS_CONTROL_BASE_URL_FIELD, CODINGNS_CONTROL_BASE_URLS_FIELD, CODINGNS_CONTROL_STATION_URL, CODINGNS_H5_LOGIN_URL, CODINGNS_LAN_ACCESS_DSH_FIELD, CODINGNS_TERMINAL_ENHANCEMENT_FIELD, CODINGNS_WORKSPACE_SESSION_ENHANCEMENT_FIELD, CODINGNS_MODULES_FIELD, CODINGNS_SETTINGS_NAMESPACE, CODINGNS_SETTINGS_ENTRY_IDS, DEFAULT_CODINGNS_CONTROL_BASE_URL, DEFAULT_CODINGNS_CONTROL_BASE_URLS, DEFAULT_CODINGNS_SETTINGS, DEFAULT_QUICK_PHRASES, DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS, DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS, captureRestartFeatureStates, enabledFeatureNames, isFeatureDshVersionCompatible, isFeatureEnabled, isCodingNsSettingsEntryId, } from './contracts/config.js';
+export { CODINGNS_CONTROL_BASE_URL_FIELD, CODINGNS_CONTROL_BASE_URLS_FIELD, CODINGNS_CONTROL_STATION_URL, CODINGNS_H5_LOGIN_URL, CODINGNS_LAN_ACCESS_DSH_FIELD, CODINGNS_TERMINAL_ENHANCEMENT_FIELD, CODINGNS_WORKSPACE_SESSION_ENHANCEMENT_FIELD, CODINGNS_FILE_MANAGEMENT_FIELD, CODINGNS_MODULES_FIELD, CODINGNS_SETTINGS_NAMESPACE, CODINGNS_SETTINGS_ENTRY_IDS, DEFAULT_CODINGNS_CONTROL_BASE_URL, DEFAULT_CODINGNS_CONTROL_BASE_URLS, DEFAULT_CODINGNS_SETTINGS, DEFAULT_QUICK_PHRASES, DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS, DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS, DEFAULT_FILE_MANAGEMENT_SETTINGS, captureRestartFeatureStates, enabledFeatureNames, isFeatureDshVersionCompatible, isFeatureEnabled, isCodingNsSettingsEntryId, } from './contracts/config.js';
 export { CODINGNS_DSH_ERROR_CODES, CodingNsDshError, SUPPORTED_DSH_COMPATIBILITY, SUPPORTED_DSH_VERSION, assertSupportedDshVersion, } from './contracts/errors.js';
 export { CODINGNS_VERSION, DSH_COMPATIBILITY, DSH_PROTOCOL_VERSION, CODINGNS_DSH_VERSION_GLOBAL, DSH_TESTED_VERSION, DSH_VERSION, isDshVersionAtLeast, isLegacyDshVersion, isDshVersionCompatible, } from './contracts/version.js';
 export { DSH_ENVELOPE_PROTOCOL, DSH_ENVELOPE_VERSION, DEFAULT_MAX_DSH_ENVELOPE_BYTES, DEFAULT_MAX_DSH_META_BYTES, decodeDshEnvelope, encodeDshEnvelope, validateDshEnvelope, } from '../transport/dsh-envelope.js';
 export { CODINGNS_RPC_CHANNEL } from './contracts/transport.js';
-export { ResourceScopeStaleError } from './contracts/peer-host.js';
+export { PEER_HOST_ERROR_CODES, ResourceScopeStaleError } from './contracts/peer-host.js';
 export { DEBUG_ERROR_CODES, DEBUG_RPC_ENDPOINTS, parseDebugMutationScope, parseDebugPtyLaunchRequest, parseDebugRpcScope, } from './contracts/debug.js';
 export { EMPTY_DEBUG_CONFIG, parseDebugConfig, } from './contracts/debug-config.js';
 export { CODINGNS4DSH_DEBUG_ENV, debugInfo, debugWarn, resolveCodingNsDebugEnabled, } from './debug.js';

package/data/build/dist/transport/debug.d.ts

@@ -17,6 +17,11 @@ export interface DshTransportDebugOptions {
 }
 /** 创建一个可注入测试 sink 的调试 logger。默认开关由当前运行环境决定。 */
 export declare function createDshTransportDebugLogger(options?: DshTransportDebugOptions): DshTransportDebugLogger;
+/**
+ * 调试字段采用正向白名单。Transport 可能同时处理 token、URL、命令和正文，
+ * 因此不能依赖调用方自觉脱敏；未知字段和错误正文直接丢弃。
+ */
+export declare function sanitizeDshTransportDebugFields(fields: Readonly<Record<string, unknown>>): Readonly<Record<string, unknown>>;
 /** 解析统一的 Codingns4DSH 调试开关，保留旧隧道变量作为兼容别名。 */
 export declare function resolveDshTransportDebugEnabled(): boolean;
 //# sourceMappingURL=debug.d.ts.map

package/data/build/dist/transport/debug.js

@@ -18,11 +18,33 @@ export function createDshTransportDebugLogger(options = {}) {
                 side,
                 component,
                 event,
-                ...fields,
+                ...sanitizeDshTransportDebugFields(fields),
             });
         },
     };
 }
+/**
+ * 调试字段采用正向白名单。Transport 可能同时处理 token、URL、命令和正文，
+ * 因此不能依赖调用方自觉脱敏；未知字段和错误正文直接丢弃。
+ */
+export function sanitizeDshTransportDebugFields(fields) {
+    const allowed = new Set([
+        'bytes', 'physicalBytes', 'bodyBytes', 'sdpBytes', 'streamId', 'messageId', 'sessionId',
+        'generation', 'previousGeneration', 'hostId', 'expectedHostId', 'hostKind', 'expectedHostKind',
+        'channel', 'channelLabel', 'operation', 'feature', 'type', 'code', 'state', 'role',
+        'streams', 'activeStreams', 'openingStreams', 'maxStreams', 'fragmentId', 'chunkCount',
+        'totalBytes', 'payloadBytes', 'bufferedAmount', 'highWaterMark', 'lowWaterMark', 'dataType',
+        'valueType', 'trafficRemainingBytes',
+    ]);
+    const result = {};
+    for (const [key, value] of Object.entries(fields)) {
+        if (!allowed.has(key))
+            continue;
+        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean' || value === null)
+            result[key] = value;
+    }
+    return result;
+}
 /** 解析统一的 Codingns4DSH 调试开关，保留旧隧道变量作为兼容别名。 */
 export function resolveDshTransportDebugEnabled() {
     return resolveCodingNsDebugEnabled();

package/data/build/dist/transport/dsh-transport.d.ts

@@ -22,6 +22,7 @@ export declare class DshCodingNsTransport implements CodingNsTransport {
     private readonly listeners;
     private readonly multiplexer;
     private currentCarrier;
+    private unsubscribeCarrierClosed;
     private generation;
     constructor(options: DshCodingNsTransportOptions);
     rpc<TResponse = unknown, TPayload = unknown>(request: CodingNsRpcRequest<TPayload>): Promise<TResponse>;
@@ -48,6 +49,7 @@ export declare class DshCodingNsTransport implements CodingNsTransport {
     /** 物理连接失效时立即结束旧请求和旧 generation。 */
     invalidateConnection(error?: Error): void;
     close(): Promise<void>;
+    private bindCarrierClosed;
     /** 给 pre-Cordis 启动胶水使用，不直接安装 DSH Connection。 */
     asTransportHooks(): CodingNsTransportHooks & {
         ownsHost?: boolean;

package/data/build/dist/transport/dsh-transport.js

@@ -5,6 +5,7 @@ export class DshCodingNsTransport {
     listeners = new Set();
     multiplexer;
     currentCarrier;
+    unsubscribeCarrierClosed;
     generation;
     constructor(options) {
         this.options = options;
@@ -19,6 +20,7 @@ export class DshCodingNsTransport {
             ...(options.flowControl ? { flowControl: options.flowControl } : {}),
             ...(options.debug ? { debug: options.debug } : {}),
         });
+        this.bindCarrierClosed(options.carrier);
     }
     rpc(request) {
         return this.multiplexer.request('rpc', request, request.signal);
@@ -80,6 +82,7 @@ export class DshCodingNsTransport {
         this.multiplexer.replaceCarrier(carrier);
         this.multiplexer.setSession(session);
         this.currentCarrier = carrier;
+        this.bindCarrierClosed(carrier);
         this.updateGeneration(generation);
     }
     /** 物理连接失效时立即结束旧请求和旧 generation。 */
@@ -92,6 +95,8 @@ export class DshCodingNsTransport {
                 listener(undefined);
     }
     close() {
+        this.unsubscribeCarrierClosed?.();
+        this.unsubscribeCarrierClosed = undefined;
         this.multiplexer.close();
         const previous = this.generation;
         this.generation = undefined;
@@ -100,6 +105,12 @@ export class DshCodingNsTransport {
                 listener(undefined);
         return this.currentCarrier.close();
     }
+    bindCarrierClosed(carrier) {
+        this.unsubscribeCarrierClosed?.();
+        this.unsubscribeCarrierClosed = carrier.onClosed?.((reason) => {
+            this.invalidateConnection(new Error(reason ?? 'Transport Carrier 已关闭'));
+        });
+    }
     /** 给 pre-Cordis 启动胶水使用，不直接安装 DSH Connection。 */
     asTransportHooks() {
         // DSH 0.1.6-alpha.2 的 ClientTransportHooks.rpc 是 ClientConnectionRpc

package/data/build/dist/transport/webrtc-client.d.ts

@@ -44,6 +44,8 @@ export interface WebRtcClientConnectorOptions {
     }): PeerConnectionLike;
     channelLabel?: string;
     timeoutMs?: number;
+    /** 已保留的兼容参数；disconnected 不再单独触发重连，以 DataChannel/failed/closed 为准。 */
+    disconnectedGracePeriodMs?: number;
     heartbeatIntervalMs?: number;
     debug?: DshTransportDebugLogger;
 }

package/data/build/dist/transport/webrtc-client.js

@@ -48,8 +48,9 @@ export async function connectWebRtcClient(options) {
         const state = peerConnection;
         const value = state.connectionState ?? state.iceConnectionState;
         debug.log('webrtc.peer.state', { state: value ?? 'unknown' });
-        if (value === 'failed' || value === 'disconnected' || value === 'closed')
+        if (value === 'failed' || value === 'closed') {
             notifyClosed(new Error(`PeerConnection ${value}`));
+        }
     };
     signaling.addEventListener('close', onSignalingClose);
     signaling.addEventListener('error', onSignalingError);

package/data/build/dist/transport/webrtc-host.d.ts

@@ -27,6 +27,8 @@ export interface WebRtcHostAcceptorOptions {
         iceServers: RelayIceServer[];
         iceTransportPolicy: 'all' | 'relay';
     }): HostPeerConnectionLike;
+    /** 已保留的兼容参数；disconnected 不再单独移除 Host session。 */
+    disconnectedGracePeriodMs?: number;
     channelLabel?: string;
     onConnection?: (connection: WebRtcHostSession) => void | Promise<void>;
     onSessionClosed?: (sessionId: string) => void | Promise<void>;

package/data/build/dist/transport/webrtc-host.js

@@ -115,7 +115,7 @@ export async function acceptWebRtcHost(options) {
             session = new HostSessionImpl(sessionId, options.peerConnectionFactory({
                 iceServers: options.signalingTicket.iceServers,
                 iceTransportPolicy: options.signalingTicket.iceTransportPolicy,
-            }), signaling, options.onConnection, () => { void closeSession(sessionId); }, TUNNEL_DATA_CHANNEL_LABEL, options.debug);
+            }), signaling, options.onConnection, () => { void closeSession(sessionId); }, TUNNEL_DATA_CHANNEL_LABEL, options.disconnectedGracePeriodMs, options.debug);
             sessions.set(sessionId, session);
         }
         await session.answerOffer(sdp);
@@ -146,18 +146,20 @@ class HostSessionImpl {
     signaling;
     onConnection;
     onTransportClosed;
+    disconnectedGracePeriodMs;
     debug;
     _carrier = null;
     closed = false;
     offerPromise = null;
     remoteDescriptionReady = false;
     pendingCandidates = [];
-    constructor(sessionId, peerConnection, signaling, onConnection, onTransportClosed, channelLabel, debug) {
+    constructor(sessionId, peerConnection, signaling, onConnection, onTransportClosed, channelLabel, disconnectedGracePeriodMs, debug) {
         this.sessionId = sessionId;
         this.peerConnection = peerConnection;
         this.signaling = signaling;
         this.onConnection = onConnection;
         this.onTransportClosed = onTransportClosed;
+        this.disconnectedGracePeriodMs = disconnectedGracePeriodMs;
         this.debug = debug;
         this.peerConnection.addEventListener?.('connectionstatechange', this.onPeerState);
         this.peerConnection.addEventListener?.('iceconnectionstatechange', this.onPeerState);
@@ -233,8 +235,9 @@ class HostSessionImpl {
     onPeerState = () => {
         const state = this.peerConnection;
         const value = state.connectionState ?? state.iceConnectionState;
-        if (value === 'failed' || value === 'disconnected' || value === 'closed')
+        if (value === 'failed' || value === 'closed') {
             void this.onTransportClosed();
+        }
     };
 }
 function validateHostTicket(ticket) {