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

package/data/build/dist/host/rpc.js

@@ -1,6 +1,9 @@
 import { CODINGNS_SETTINGS_NAMESPACE, isCodingNsSettingsEntryId } from '../shared/contracts/config.js';
 import { debugInfo, debugWarn } from '../shared/debug.js';
 import { CodingNsRpcError } from './rpc-table.js';
+function invokeConnectionRpcHandler(handler, endpoint, payload, signal, peer) {
+    return handler(endpoint, payload, signal, peer);
+}
 /**
  * 创建 Codingns4DSH Host RPC 主处理器。
  *
@@ -10,7 +13,9 @@ import { CodingNsRpcError } from './rpc-table.js';
  * 凭据存储。
  */
 export function createCodingNsRpcHandler(table) {
-    return async (endpoint, payload, signal) => {
+    // `peer` 是 DSH 0.2 Connection 注入的调用方作用域；0.1 carrier 没有该参数，
+    // 因此保留可选形态，让同一处理器可被旧版 HTTP 回退入口复用。
+    return async (endpoint, payload, signal, peer) => {
         debugInfo('codingns4dsh: host rpc request', { endpoint });
         const target = table.resolve(endpoint);
         if (target === null) {
@@ -18,7 +23,7 @@ export function createCodingNsRpcHandler(table) {
             return failure('CODINGNS_RPC_NOT_FOUND', `未知 Codingns4DSH RPC: ${endpoint}`);
         }
         try {
-            const value = await target.handler(target.action, payload, { signal });
+            const value = await target.handler(target.action, payload, { signal, peer });
             debugInfo('codingns4dsh: host rpc success', { endpoint });
             return success(value);
         }
@@ -71,7 +76,7 @@ export function registerCodingNsRpc(ctx, table, settingsProvider) {
             path: `/api/codingns/${endpoint}`,
             methods: ['POST'],
             requestBody: 'buffered',
-            fetch: async (request) => handleFetchRpc(request, endpoint, handler),
+            fetch: async (request) => handleFetchRpc(request, endpoint, connection, handler),
         }));
         debugInfo('codingns4dsh: host rpc fetch routes registered', {
             prefix: '/api/codingns/',
@@ -132,7 +137,8 @@ async function handleChannelRequest(request, response, connection, handler) {
         return;
     }
     try {
-        writeRpcResponse(response, body.rpcId, await handler(endpoint, body.payload, abortController.signal));
+        const peer = connection.operator;
+        writeRpcResponse(response, body.rpcId, await invokeConnectionRpcHandler(handler, endpoint, body.payload, abortController.signal, peer));
     }
     catch (error) {
         response.statusCode = 500;
@@ -182,7 +188,7 @@ const CODINGNS_RPC_ENDPOINTS = [
     'fileManagement/session-changes', 'fileManagement/read', 'fileManagement/download', 'fileManagement/write', 'fileManagement/create-file', 'fileManagement/create-directory', 'fileManagement/rename', 'fileManagement/copy', 'fileManagement/move', 'fileManagement/delete', 'fileManagement/git-ignore',
     'lanAccessDsh/addresses', 'lanAccessDsh/detect', 'lanAccessDsh/get', 'lanAccessDsh/settings/get', 'lanAccessDsh/settings/set', 'lanAccessDsh/login/get', 'lanAccessDsh/login/set', 'lanAccessDsh/login/session/open', 'lanAccessDsh/login/session/refresh', 'lanAccessDsh/start', 'lanAccessDsh/stop',
     'peerHost/list', 'peerHost/diagnostics', 'peerHost/create', 'peerHost/update', 'peerHost/remove', 'peerHost/check', 'peerHost/reconnect', 'peerHost/login', 'peerHost/logout', 'peerHost/request', 'peerHost/wsEndpoint', 'peerHost/aggregate',
-    'cli/catalog', 'cli/models', 'cli/adapter/set', 'cli/session/get', 'cli/session/set', 'cli/session/list', 'cli/session/adapter-map', 'cli/session/archive', 'cli/session/steer', 'cli/session/follow-up', 'cli/session/interrupt', 'cli/subscription',
+    'cli/catalog', 'cli/models', 'cli/adapter/set', 'cli/session/get', 'cli/session/set', 'cli/session/list', 'cli/session/adapter-map', 'cli/session/archive', 'cli/session/steer', 'cli/session/follow-up', 'cli/session/interrupt', 'cli/subscription', 'cli/team/status', 'cli/team/members', 'cli/team/tasks', 'cli/team/task', 'cli/team/spawn', 'cli/team/message', 'cli/team/task/create', 'cli/team/task/update', 'cli/team/wait', 'cli/team/interrupt',
 ];
 /** 创建远程设置处理器；只允许 Codingns4DSH 自己的 namespace 和路径编辑。 */
 export function createCodingNsSettingsRpcHandler(provider) {
@@ -193,7 +199,15 @@ export function createCodingNsSettingsRpcHandler(provider) {
             if (!provider.writable)
                 throw new CodingNsRpcError('CODINGNS_SETTINGS_READ_ONLY', 'Host 设置提供器当前只读');
             const input = parseSettingsMutation(payload);
-            await provider.mutate(resolveCodingNsSettingsNamespace(provider), input.ops, input.expectedRevision);
+            if (typeof provider.mutate === 'function') {
+                await provider.mutate(resolveCodingNsSettingsNamespace(provider), input.ops, input.expectedRevision);
+            }
+            else if (typeof provider.update === 'function') {
+                await provider.update(resolveCodingNsSettingsNamespace(provider), operationsToPatch(input.ops), input.expectedRevision);
+            }
+            else {
+                throw new CodingNsRpcError('CODINGNS_SETTINGS_UNAVAILABLE', 'Codingns4DSH 设置提供器不支持写入');
+            }
             return readCodingNsSettings(provider);
         }
         throw new CodingNsRpcError('CODINGNS_RPC_NOT_FOUND', `未知 Codingns4DSH RPC: settings/${action}`);
@@ -247,14 +261,28 @@ function parseSettingsOp(value) {
         throw new TypeError('set 操作缺少 value');
     return { op: 'set', path, value: value.value };
 }
+/** 兼容仅暴露 update 的旧设置提供器；0.2 SettingsForms 优先走 mutate。 */
+function operationsToPatch(operations) {
+    const patch = {};
+    for (const operation of operations) {
+        if (operation.path.length !== 1)
+            throw new TypeError('设置提供器 update 回退只支持一级字段');
+        if (operation.op === 'set')
+            patch[operation.path[0]] = operation.value;
+    }
+    return patch;
+}
 function isAllowedSettingsPath(path) {
     if (path.length === 1)
-        return ['controlBaseUrl', 'controlBaseUrls', 'terminalEnhancement', 'workspaceSessionEnhancement'].includes(path[0] ?? '');
+        return ['controlBaseUrl', 'controlBaseUrls', 'terminalEnhancement', 'workspaceSessionEnhancement', 'subscriptionUsage'].includes(path[0] ?? '');
     if (path[0] === 'modules')
         return path.length === 2 && ['lanAccess', 'reverseProxy', 'cliAdapters', 'terminalEnhancement', 'workspaceSessionEnhancement', 'debug', 'gitManagement', 'fileManagement', 'peerHost'].includes(path[1] ?? '');
     if (path[0] === 'workspaceSessionEnhancement') {
         return path.length === 2 && ['showAdapterLogo', 'showArchivedSessions', 'showWorkspaceHiding', 'hiddenWorkspaceIds', 'showSubscriptionUsage', 'showQuickPhrases', 'rememberConversationRightbarRatio', 'quickPhrases', 'quickPhrasesSeeded'].includes(path[1] ?? '');
     }
+    if (path[0] === 'subscriptionUsage') {
+        return path.length === 2 && ['timeoutSecs', 'refreshIntervalMins'].includes(path[1] ?? '');
+    }
     if (path[0] === 'fileManagement') {
         return path.length === 2 && ['menuEnhancement', 'fileEditor', 'sessionChangedFiles'].includes(path[1] ?? '');
     }
@@ -263,7 +291,7 @@ function isAllowedSettingsPath(path) {
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
-async function handleFetchRpc(request, endpoint, handler) {
+async function handleFetchRpc(request, endpoint, connection, handler) {
     debugInfo('codingns4dsh: host fetch rpc request', {
         endpoint,
         method: request.method,
@@ -283,7 +311,8 @@ async function handleFetchRpc(request, endpoint, handler) {
     if (typeof envelope.rpcId !== 'string' || (method !== endpoint && method !== `codingns/${endpoint}`)) {
         return new Response('invalid RPC envelope', { status: 400 });
     }
-    const result = await handler(endpoint, envelope.payload, request.signal);
+    const peer = connection.operator;
+    const result = await invokeConnectionRpcHandler(handler, endpoint, envelope.payload, request.signal, peer);
     debugInfo('codingns4dsh: host fetch rpc response', { endpoint, ok: result.ok });
     return Response.json({ type: 'server-response', rpcId: envelope.rpcId, result });
 }

package/data/build/dist/host/session-migration-repair.js

@@ -46,6 +46,11 @@ export async function repairLegacySessionLog(path, signal) {
     const source = await readFileBytes(path);
     throwIfAborted(signal);
     const parsed = decodeLog(path, source);
+    // 0.2 使用 V4；未知的更高 generation 必须交给官方迁移器，插件不能重排
+    // 它的 event envelope，否则 repair 会把新 projection 引用改写成旧语义。
+    const generation = sessionHeaderVersion(parsed.header);
+    if (generation !== undefined && generation > 4)
+        return false;
     const repaired = repairEvents(parsed.events, isV4Log(path, parsed.header));
     if (repaired === null)
         return false;
@@ -186,6 +191,15 @@ function repairEvents(events, canonicalizeV4Results = false) {
 function isV4Log(path, header) {
     return header.version === 4 || /\.v4\.jsonl(?:\.zstd)?$/u.test(path);
 }
+function sessionHeaderVersion(header) {
+    const direct = header.version;
+    if (typeof direct === 'number' && Number.isSafeInteger(direct) && direct >= 0)
+        return direct;
+    const data = header.data;
+    if (isRecord(data) && typeof data.version === 'number' && Number.isSafeInteger(data.version) && data.version >= 0)
+        return data.version;
+    return undefined;
+}
 /** 将插件旧版在 V4 文件中留下的 V3 tool-result wrapper 提升为 tool-role 消息。 */
 function canonicalizeV4ToolResult(event) {
     if (event.type !== 'tool/result')

package/data/build/dist/host/settings.d.ts

@@ -1,6 +1,6 @@
 import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
-import type { SettingsScope } from '@deepseek-ai/dsh-settings';
+import type { DshHostSettingsScope } from '../dsh-capabilities/host/config-forms-adapter.js';
 import { type CodingNsConfig, type CodingNsSettings } from '../shared/contracts/config.js';
 /**
  * DSH 设置服务使用的 Codingns4DSH namespace schema。
@@ -22,5 +22,5 @@ export declare const CodingNsConfigSchema: z<CodingNsConfig>;
  * 必须在已经注入 `settings` 的上下文里调用。返回的 scope 既用于读取当前值，
  * 也通过 watch 驱动功能模块启停。
  */
-export declare function registerCodingNsSettings(ctx: Context): SettingsScope<CodingNsSettings>;
+export declare function registerCodingNsSettings(ctx: Context): DshHostSettingsScope<CodingNsSettings>;
 //# sourceMappingURL=settings.d.ts.map

package/data/build/dist/host/settings.js

@@ -1,5 +1,5 @@
 import z from '@deepseek-ai/schemastery';
-import { CODINGNS_SETTINGS_NAMESPACE, isCodingNsSettingsEntryId, DEFAULT_CODINGNS_SETTINGS, } from '../shared/contracts/config.js';
+import { CODINGNS_SETTINGS_NAMESPACE, isCodingNsSettingsEntryId, DEFAULT_CODINGNS_SETTINGS, SUBSCRIPTION_USAGE_REFRESH_INTERVAL_MINS_LIMITS, SUBSCRIPTION_USAGE_TIMEOUT_SECS_LIMITS, } from '../shared/contracts/config.js';
 import { debugInfo } from '../shared/debug.js';
 /**
  * DSH 设置服务使用的 Codingns4DSH namespace schema。
@@ -73,6 +73,16 @@ export const CodingNsSettingsSchema = z.object({
         fileEditor: z.boolean().default(DEFAULT_CODINGNS_SETTINGS.fileManagement.fileEditor),
         sessionChangedFiles: z.boolean().default(DEFAULT_CODINGNS_SETTINGS.fileManagement.sessionChangedFiles),
     }).default(DEFAULT_CODINGNS_SETTINGS.fileManagement),
+    subscriptionUsage: z.object({
+        timeoutSecs: z.number().step(1)
+            .min(SUBSCRIPTION_USAGE_TIMEOUT_SECS_LIMITS.min)
+            .max(SUBSCRIPTION_USAGE_TIMEOUT_SECS_LIMITS.max)
+            .default(DEFAULT_CODINGNS_SETTINGS.subscriptionUsage.timeoutSecs),
+        refreshIntervalMins: z.number().step(1)
+            .min(SUBSCRIPTION_USAGE_REFRESH_INTERVAL_MINS_LIMITS.min)
+            .max(SUBSCRIPTION_USAGE_REFRESH_INTERVAL_MINS_LIMITS.max)
+            .default(DEFAULT_CODINGNS_SETTINGS.subscriptionUsage.refreshIntervalMins),
+    }).default(DEFAULT_CODINGNS_SETTINGS.subscriptionUsage),
 });
 /**
  * DSH 0.1.7 只会把 `volatile` 配置投影成可编辑 ConfigForm。

package/data/build/dist/host/terminal/startup.d.ts

@@ -1,7 +1,7 @@
 import type { Context } from '@deepseek-ai/cordis';
-import type { SettingsProvider, SettingsScope } from '@deepseek-ai/dsh-settings';
 import type { CodingNsSettings } from '../../shared/contracts/config.js';
 import { createTerminalController, type TerminalControllerFactoryResult } from './controller-factory.js';
+import type { DshHostSettingsProvider, DshHostSettingsScope } from '../../dsh-capabilities/host/config-forms-adapter.js';
 export interface TerminalStartupIdentity {
     readonly hostId: string;
     readonly storeFilename: string;
@@ -31,5 +31,5 @@ export declare function terminalWorkspaceId(cwd: string): string;
  * 在 Host 启动时读取一次启用快照并安装唯一 controller。
  * 设置后续变化不会热切同名 Cordis service，必须重启 DSH 才会重新选择模式。
  */
-export declare function installTerminalController(ctx: Context, settings: SettingsScope<CodingNsSettings>, provider: Pick<SettingsProvider, 'documentPath'>, options?: InstallTerminalControllerOptions): Promise<TerminalControllerFactoryResult>;
+export declare function installTerminalController(ctx: Context, settings: DshHostSettingsScope<CodingNsSettings>, provider: Pick<DshHostSettingsProvider, 'documentPath'>, options?: InstallTerminalControllerOptions): Promise<TerminalControllerFactoryResult>;
 //# sourceMappingURL=startup.d.ts.map

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

@@ -13,7 +13,11 @@ export interface CodingNsCliAdapterDescriptor {
     readonly version: string | null;
     readonly command: string | null;
 }
-export type CodingNsCliCapability = 'models' | 'stream' | 'resume' | 'interrupt' | 'tool-events' | 'reasoning' | 'usage' | 'permission' | 'questions' | 'steer';
+export type CodingNsCliCapability = 'models' | 'stream' | 'resume'
+/** DSH 0.2 continuable child 生命周期；声明不代表已接入原生 Team。 */
+ | 'continuable'
+/** DSH 0.2 Agent Team proxy 边界；当前插件未声明此能力。 */
+ | 'team-proxy' | 'interrupt' | 'tool-events' | 'reasoning' | 'usage' | 'permission' | 'questions' | 'steer';
 /** 适配器模型及其可用思考强度。 */
 export interface CodingNsCliModel {
     readonly id: string;
@@ -31,6 +35,12 @@ export interface CodingNsCliModelCatalog {
     readonly currentModel: string | null;
     readonly currentEffort: string | null;
 }
+/** DSH 0.2 Agent Team 能力诊断；明确区分“未接入”与“可用”。 */
+export interface CodingNsCliTeamDiagnostic {
+    readonly supported: boolean;
+    readonly code: 'DSH_TEAM_NATIVE_UNAVAILABLE' | 'DSH_TEAM_PROXY_READY';
+    readonly message: string;
+}
 /** 每个 DSH 会话绑定的 CLI 选择；不包含凭据。 */
 export interface CodingNsCliSessionConfig {
     readonly adapterId: CodingNsCliAdapterId;
@@ -41,6 +51,17 @@ export interface CodingNsCliSessionConfig {
     /** 外部运行时会话标识，只保存在 Host 会话表中。 */
     readonly providerSessionId?: string;
     readonly rawStoreRef?: string;
+    /** DSH 0.2 Session V4 的父会话关系；外部 Provider 不得自行伪造。 */
+    readonly parentSessionId?: string;
+    /** 会话来源，供 V4 projection 区分 subagent 与普通用户会话。 */
+    readonly origin?: 'user' | 'subagent' | 'plugin';
+    /** 子 Agent 委托深度；仅由 Host/Team adapter 写入。 */
+    readonly delegationDepth?: number;
+    /** Continuable child 的稳定标识。 */
+    readonly continuationId?: string;
+    /** 原生 Team 投影中的 Team 和成员标识。 */
+    readonly teamId?: string;
+    readonly teamMemberId?: string;
 }
 /** Client 展示会话 Agent 时使用的最小脱敏绑定。 */
 export interface CodingNsSessionAdapterBinding {

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

@@ -19,6 +19,8 @@ export interface CodingNsSettings {
     workspaceSessionEnhancement: WorkspaceSessionEnhancementSettings;
     /** DSH 文件管理侧栏的独立增强选项。 */
     fileManagement: FileManagementSettings;
+    /** 用量查询设置：超时控制单次网络查询，间隔控制自动刷新。 */
+    subscriptionUsage: SubscriptionUsageSettings;
     /**
      * 功能模块启用意图：模块名 -> 是否启用。
      *
@@ -32,6 +34,24 @@ export interface CodingNsSettings {
     /** 适配器级最近选择；新建会话时作为默认模型和思考强度。 */
     agentAdapterPreferences?: Record<string, CodingNsCliAdapterPreference>;
 }
+/** 用量查询设置：超时控制单次网络查询，间隔控制自动刷新。 */
+export interface SubscriptionUsageSettings {
+    /** 单次用量查询的网络超时（秒）。 */
+    timeoutSecs: number;
+    /** 自动查询间隔（分钟）；0 表示不自动查询。 */
+    refreshIntervalMins: number;
+}
+export declare const DEFAULT_SUBSCRIPTION_USAGE_SETTINGS: SubscriptionUsageSettings;
+export declare const SUBSCRIPTION_USAGE_TIMEOUT_SECS_LIMITS: {
+    readonly min: 3;
+    readonly max: 120;
+};
+export declare const SUBSCRIPTION_USAGE_REFRESH_INTERVAL_MINS_LIMITS: {
+    readonly min: 0;
+    readonly max: 1440;
+};
+/** 归一化用量查询设置：缺省字段回填默认值，越界值收敛到允许范围。 */
+export declare function normalizeSubscriptionUsageSettings(value: unknown): SubscriptionUsageSettings;
 /** 0.1.7 ConfigForm 面向用户的持久化配置；Host-only 会话索引不在其中。 */
 export type CodingNsConfig = Omit<CodingNsSettings, 'cliSessions'>;
 /** Host 运行时状态，与可编辑配置分离，避免泄露到 Client 配置表单。 */
@@ -132,6 +152,7 @@ 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 CODINGNS_SUBSCRIPTION_USAGE_FIELD = "subscriptionUsage";
 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,19 @@
 import { isDshVersionAtLeast } from './version.js';
+export const DEFAULT_SUBSCRIPTION_USAGE_SETTINGS = { timeoutSecs: 10, refreshIntervalMins: 5 };
+export const SUBSCRIPTION_USAGE_TIMEOUT_SECS_LIMITS = { min: 3, max: 120 };
+export const SUBSCRIPTION_USAGE_REFRESH_INTERVAL_MINS_LIMITS = { min: 0, max: 1440 };
+/** 归一化用量查询设置：缺省字段回填默认值，越界值收敛到允许范围。 */
+export function normalizeSubscriptionUsageSettings(value) {
+    const record = typeof value === 'object' && value !== null && !Array.isArray(value) ? value : {};
+    return {
+        timeoutSecs: clampSettingsInteger(record.timeoutSecs, SUBSCRIPTION_USAGE_TIMEOUT_SECS_LIMITS, DEFAULT_SUBSCRIPTION_USAGE_SETTINGS.timeoutSecs),
+        refreshIntervalMins: clampSettingsInteger(record.refreshIntervalMins, SUBSCRIPTION_USAGE_REFRESH_INTERVAL_MINS_LIMITS, DEFAULT_SUBSCRIPTION_USAGE_SETTINGS.refreshIntervalMins),
+    };
+}
+function clampSettingsInteger(value, limits, fallback) {
+    const numeric = typeof value === 'number' && Number.isFinite(value) ? Math.round(value) : fallback;
+    return Math.min(limits.max, Math.max(limits.min, numeric));
+}
 export const DEFAULT_FILE_MANAGEMENT_SETTINGS = {
     menuEnhancement: true,
     fileEditor: true,
@@ -28,6 +43,7 @@ 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 CODINGNS_SUBSCRIPTION_USAGE_FIELD = 'subscriptionUsage';
 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 账号。 */
@@ -70,6 +86,7 @@ export const DEFAULT_CODINGNS_SETTINGS = {
     terminalEnhancement: DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS,
     workspaceSessionEnhancement: DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS,
     fileManagement: DEFAULT_FILE_MANAGEMENT_SETTINGS,
+    subscriptionUsage: DEFAULT_SUBSCRIPTION_USAGE_SETTINGS,
     lanAccessDsh: {
         autoStart: false,
         listenHost: '0.0.0.0',

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

@@ -34,8 +34,8 @@ export declare const CODINGNS_DSH_ERROR_CODES: {
     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";
+export declare const SUPPORTED_DSH_VERSION: "0.2.0-rc.1";
+export declare const SUPPORTED_DSH_COMPATIBILITY: ">=0.2.0-rc.1 <=0.2.0-rc.1";
 export type CodingNsDshErrorCode = typeof CODINGNS_DSH_ERROR_CODES[keyof typeof CODINGNS_DSH_ERROR_CODES];
 /** 统一错误形状；阶段 0 只定义，不主动产生这些业务错误。 */
 export declare class CodingNsDshError extends Error {

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

@@ -112,4 +112,11 @@ export interface Sub2ApiUsage {
     readonly tpm: number | null;
     readonly averageDurationMs: number | null;
 }
+/**
+ * 判断上一次用量查询结果是否仍在可复用窗口内。
+ *
+ * 间隔 ≤ 0 表示不自动查询：此时不复用旧结果，每次挂载都重新查询一次。
+ * 该判定由 Client 侧底部用量入口使用，避免每次进入会话都请求上游。
+ */
+export declare function isSubscriptionUsageFresh(capturedAtMs: number, nowMs: number, refreshIntervalMins: number): boolean;
 //# sourceMappingURL=subscription.d.ts.map

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

@@ -1,2 +1,15 @@
-export {};
+/**
+ * 判断上一次用量查询结果是否仍在可复用窗口内。
+ *
+ * 间隔 ≤ 0 表示不自动查询：此时不复用旧结果，每次挂载都重新查询一次。
+ * 该判定由 Client 侧底部用量入口使用，避免每次进入会话都请求上游。
+ */
+export function isSubscriptionUsageFresh(capturedAtMs, nowMs, refreshIntervalMins) {
+    if (!Number.isFinite(refreshIntervalMins) || refreshIntervalMins <= 0)
+        return false;
+    if (!Number.isFinite(capturedAtMs) || !Number.isFinite(nowMs))
+        return false;
+    const age = nowMs - capturedAtMs;
+    return age >= 0 && age < refreshIntervalMins * 60_000;
+}
 //# sourceMappingURL=subscription.js.map

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

@@ -1,9 +1,9 @@
 /** 当前经过完整验证的 DSH 版本；源文件由根目录 version.json 同步。 */
-export declare const DSH_VERSION: "0.1.6-alpha.2";
+export declare const DSH_VERSION: "0.2.0-rc.1";
 /** DSH 测试版本别名，供新代码表达语义，保留 DSH_VERSION 兼容旧调用方。 */
-export declare const DSH_TESTED_VERSION: "0.1.6-alpha.2";
+export declare const DSH_TESTED_VERSION: "0.2.0-rc.1";
 /** 插件支持的 DSH 版本范围；插件版本与宿主版本独立发布。 */
-export declare const DSH_COMPATIBILITY: ">=0.1.5-rc.3 <=0.1.7-rc.2";
+export declare const DSH_COMPATIBILITY: ">=0.2.0-rc.1 <=0.2.0-rc.1";
 /** DSH Envelope/Tunnel 协议主版本。 */
 export declare const DSH_PROTOCOL_VERSION: 1;
 /** Host 注入到浏览器页面的真实 DSH 版本全局字段。 */
@@ -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.7-rc.2";
+export declare const CODINGNS_VERSION: "0.2.0-beta.1";
 /** 判断宿主版本是否落在当前插件声明的 DSH 兼容范围内。 */
 export declare function isDshVersionCompatible(version: string): boolean;
 /** 判断 DSH 版本是否达到某个功能模块要求的最低版本。 */

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

@@ -1,9 +1,9 @@
 /** 当前经过完整验证的 DSH 版本；源文件由根目录 version.json 同步。 */
-export const DSH_VERSION = '0.1.6-alpha.2';
+export const DSH_VERSION = '0.2.0-rc.1';
 /** DSH 测试版本别名，供新代码表达语义，保留 DSH_VERSION 兼容旧调用方。 */
 export const DSH_TESTED_VERSION = DSH_VERSION;
 /** 插件支持的 DSH 版本范围；插件版本与宿主版本独立发布。 */
-export const DSH_COMPATIBILITY = '>=0.1.5-rc.3 <=0.1.7-rc.2';
+export const DSH_COMPATIBILITY = '>=0.2.0-rc.1 <=0.2.0-rc.1';
 /** DSH Envelope/Tunnel 协议主版本。 */
 export const DSH_PROTOCOL_VERSION = 1;
 /** Host 注入到浏览器页面的真实 DSH 版本全局字段。 */
@@ -13,7 +13,7 @@ export function isLegacyDshVersion(version) {
     return /^0\.1\.5(?:-|$)/u.test(version);
 }
 /** Codingns4DSH 插件自身的 npm 版本。 */
-export const CODINGNS_VERSION = '0.1.7-rc.2';
+export const CODINGNS_VERSION = '0.2.0-beta.1';
 /** 判断宿主版本是否落在当前插件声明的 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_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 { 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_SUBSCRIPTION_USAGE_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, DEFAULT_SUBSCRIPTION_USAGE_SETTINGS, SUBSCRIPTION_USAGE_REFRESH_INTERVAL_MINS_LIMITS, SUBSCRIPTION_USAGE_TIMEOUT_SECS_LIMITS, normalizeSubscriptionUsageSettings, 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, type SubscriptionUsageSettings, } 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';
@@ -6,11 +6,12 @@ export { CODINGNS_VERSION, DSH_COMPATIBILITY, DSH_PROTOCOL_VERSION, CODINGNS_DSH
 export type { CodingNsRpcRequest, CodingNsStreamRequest, CodingNsTransport, CodingNsTransportErrorShape, CodingNsTransportGeneration, CodingNsTransportHooks, } from './contracts/transport.js';
 export { DSH_ENVELOPE_PROTOCOL, DSH_ENVELOPE_VERSION, DEFAULT_MAX_DSH_ENVELOPE_BYTES, DEFAULT_MAX_DSH_META_BYTES, decodeDshEnvelope, encodeDshEnvelope, validateDshEnvelope, type DshChannel, type DshEnvelope, type DshEnvelopeCodecOptions, type DshEnvelopeFlags, type DshHostScope, } from '../transport/dsh-envelope.js';
 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 { CodingNsCliAdapterDescriptor, CodingNsCliAdapterId, CodingNsCliCapability, CodingNsAgentEvent, CodingNsAgentQuestion, CodingNsAgentQuestionResponse, CodingNsAgentToolEvent, CodingNsCliMessage, CodingNsCliModel, CodingNsCliModelCatalog, CodingNsCliModelGroup, CodingNsCliTeamDiagnostic, 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 { isSubscriptionUsageFresh } from './contracts/subscription.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';

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

@@ -1,8 +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_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_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_SUBSCRIPTION_USAGE_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, DEFAULT_SUBSCRIPTION_USAGE_SETTINGS, SUBSCRIPTION_USAGE_REFRESH_INTERVAL_MINS_LIMITS, SUBSCRIPTION_USAGE_TIMEOUT_SECS_LIMITS, normalizeSubscriptionUsageSettings, 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 { isSubscriptionUsageFresh } from './contracts/subscription.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';

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

@@ -1,9 +1,19 @@
 import { type DshTransportDebugLogger } from './debug.js';
 export declare const TUNNEL_DATA_CHANNEL_LABEL = "codingns-tunnel";
-/** DataChannel 单消息保守上限；实际对端协商值可能只有 256 KiB。 */
+/** 单个分片的正文上限；整帧为正文加上分片头。 */
 export declare const DATA_CHANNEL_FRAGMENT_PAYLOAD_BYTES: number;
 export declare const DATA_CHANNEL_FRAGMENT_HEADER_BYTES = 20;
 export declare const DATA_CHANNEL_MAX_REASSEMBLY_BYTES: number;
+/**
+ * Host 侧向浏览器宣告的 SCTP max-message-size（256 KiB）。
+ *
+ * 浏览器按对端 SDP 里的 max-message-size 限制 `RTCDataChannel.send()`；werift 默认
+ * 只宣告 64 KiB，而 Carrier 的整分片是 64 KiB 正文加 20 字节头，因此浏览器侧只要
+ * 发送超过 64 KiB 的消息就会抛 `Trying to send message larger than max-message-size`。
+ * 中继下的设置写入、附件和大字段都属于这一类，必须把上限抬到浏览器自身
+ * （Chrome/Firefox 为 256 KiB）能接受的水平。
+ */
+export declare const DATA_CHANNEL_MAX_MESSAGE_BYTES: number;
 export interface CodingNsCarrier {
     readonly state: 'connecting' | 'open' | 'closed';
     send(data: Uint8Array): Promise<void>;