@jingyi0605/codingns4dsh 0.1.0

package/data/build/dist/client/dsh-h5-bootstrap.js

@@ -0,0 +1,293 @@
+import { assertSupportedDshVersion } from '../shared/index.js';
+import { installDshTransport } from '../bootstrap/dsh-connection-adapter.js';
+import { DshSession } from '../transport/dsh-session.js';
+import { DshCodingNsTransport } from '../transport/dsh-transport.js';
+import { connectWebRtcClient } from '../transport/webrtc-client.js';
+import { RemoteDshWebContext } from './remote-web-context.js';
+import { createDshTransportDebugLogger } from '../transport/debug.js';
+import { assertInjectedDshVersion } from './dsh-runtime-version.js';
+/**
+ * DSH H5 的最小入口：选择独立 DSH 设备、申请票据、建立 WebRTC，最后才启动远程 DSH。
+ * 账号凭据只在 Host RPC 内部使用，浏览器只看到设备摘要和短期票据。
+ */
+export async function startDshH5Bootstrap(options) {
+    const dshVersion = assertInjectedDshVersion();
+    assertSupportedDshVersion(dshVersion);
+    const signal = options.signal;
+    const debug = createDshTransportDebugLogger({ side: 'h5', component: 'h5-bootstrap' });
+    const devices = await callRpc(options.rpc, 'auth/dsh/device/list', {}, signal);
+    const device = chooseDshDevice(devices, options.dshDeviceId);
+    const ticket = await callRpc(options.rpc, 'auth/dsh/relayTicket', {
+        dshDeviceId: device.dshDeviceId,
+        ...(options.loginProtectionToken === undefined ? {} : { loginProtectionToken: options.loginProtectionToken }),
+    }, signal);
+    const connection = await connectWebRtcClient({
+        signalingTicket: ticket,
+        signalingSocketFactory: (url) => new WebSocket(url),
+        peerConnectionFactory: ({ iceServers, iceTransportPolicy }) => createPeerConnection({ iceServers, iceTransportPolicy }),
+        debug,
+    });
+    const generation = 1;
+    const hostScope = resolveDshHostScope(ticket);
+    const session = new DshSession({ carrier: connection.carrier, role: 'client', generation: String(generation), hostScope, dshVersion, debug });
+    const transport = new DshCodingNsTransport({
+        carrier: connection.carrier,
+        generation: { id: generation, host: { home: '/' } },
+        hostScope,
+        session,
+        requireSessionReady: true,
+        debug,
+    });
+    let registration;
+    try {
+        session.start();
+        await session.waitReady(signal);
+        registration = installDshTransport({ dshVersion, transport });
+        if (options.boot)
+            await options.boot();
+        const dispose = async () => {
+            registration?.dispose();
+            session.close();
+            await transport.close();
+            await connection.close();
+        };
+        return { dshDeviceId: device.dshDeviceId, relayMode: ticket.iceTransportPolicy === 'relay' ? 'relay' : 'direct', registration, dispose };
+    }
+    catch (error) {
+        registration?.dispose();
+        session.close();
+        await transport.close();
+        await connection.close();
+        throw error;
+    }
+}
+/** 独立 H5 页面使用的入口；Control API 会话通过 HttpOnly Cookie 提供。 */
+export async function startDshH5BrowserBootstrap(options) {
+    const signal = options.signal;
+    const debug = createDshTransportDebugLogger({ side: 'h5', component: 'h5-bootstrap' });
+    options.onStatus?.('ticket');
+    const devices = await options.controlApi.listDevices(signal);
+    const device = chooseDshDevice(devices, options.dshDeviceId);
+    let generation = options.generation ?? 1;
+    let connection;
+    let session;
+    let reconnecting = false;
+    let stopped = false;
+    let reconnectTimer;
+    let reconnectRef;
+    const clientSessionId = options.clientSessionId?.trim() || undefined;
+    const firstTicket = await options.controlApi.createClientTicket(device.dshDeviceId, signal, clientSessionId);
+    options.onStatus?.('webrtc');
+    connection = await connectWebRtcClient(createWebRtcClientOptions(firstTicket, debug));
+    const hostScope = resolveDshHostScope(firstTicket);
+    session = new DshSession({ carrier: connection.carrier, role: 'client', generation: String(generation), hostScope, debug });
+    const transport = new DshCodingNsTransport({
+        carrier: connection.carrier,
+        generation: { id: generation, host: { home: '/' } },
+        hostScope,
+        session,
+        requireSessionReady: true,
+        reconnect: (reconnectSignal) => reconnectRef?.(reconnectSignal) ?? Promise.reject(new Error('H5 重连尚未就绪')),
+        debug,
+    });
+    const reconnect = async () => {
+        if (stopped || reconnecting)
+            return;
+        reconnecting = true;
+        debug.log('bootstrap.reconnect.start', { generation });
+        transport.invalidateConnection(new Error('WebRTC connection closed'));
+        session?.close('旧 WebRTC generation 已失效');
+        try {
+            for (let attempt = 0; !stopped; attempt += 1) {
+                try {
+                    const waitMs = Math.min(10_000, 500 * (attempt + 1));
+                    if (attempt > 0)
+                        await delay(waitMs, signal);
+                    options.onStatus?.('ticket');
+                    const ticket = await options.controlApi.createClientTicket(device.dshDeviceId, signal, clientSessionId);
+                    debug.log('bootstrap.reconnect.ticket', { generation: generation + 1 });
+                    options.onStatus?.('webrtc');
+                    const nextConnection = await connectWebRtcClient(createWebRtcClientOptions(ticket, debug));
+                    const nextSession = new DshSession({ carrier: nextConnection.carrier, role: 'client', generation: String(generation + 1), hostScope: resolveDshHostScope(ticket), debug });
+                    nextSession.start();
+                    await waitForSessionReady(nextSession, signal, 15_000);
+                    const previous = connection;
+                    connection = nextConnection;
+                    session = nextSession;
+                    generation += 1;
+                    transport.replaceConnection(nextConnection.carrier, nextSession, { id: generation, host: { home: '/' } });
+                    attachConnectionClose(nextConnection);
+                    await previous?.close();
+                    debug.log('bootstrap.reconnect.ready', { generation });
+                    options.onStatus?.('remote-web');
+                    return;
+                }
+                catch (error) {
+                    debug.log('bootstrap.reconnect.error', { generation, error: error instanceof Error ? error.message : String(error) });
+                    if (stopped || signal?.aborted)
+                        throw error;
+                }
+            }
+        }
+        finally {
+            reconnecting = false;
+        }
+    };
+    const attachConnectionClose = (current) => {
+        current.onClosed((error) => {
+            if (stopped || current !== connection)
+                return;
+            debug.log('bootstrap.connection.closed', { generation, error: error?.message ?? 'closed' });
+            reconnectTimer = setTimeout(() => { reconnectTimer = undefined; void reconnect(); }, 50);
+        });
+    };
+    reconnectRef = reconnect;
+    attachConnectionClose(connection);
+    let webContext;
+    try {
+        session.start();
+        await waitForSessionReady(session, signal, 15_000);
+        options.onStatus?.('session-ready');
+        if (options.webContext) {
+            webContext = new RemoteDshWebContext({ ...options.webContext, transport });
+            options.onStatus?.('remote-web');
+            await withTimeout(webContext.open(signal), signal, 30_000, '读取远程 DSH Web 超时');
+        }
+        return {
+            dshDeviceId: device.dshDeviceId,
+            transport,
+            get session() { return session; },
+            ...(webContext ? { webContext } : {}),
+            dispose: async () => {
+                stopped = true;
+                if (reconnectTimer !== undefined)
+                    clearTimeout(reconnectTimer);
+                await webContext?.dispose();
+                session?.close();
+                await transport.close();
+                await connection?.close();
+            },
+        };
+    }
+    catch (error) {
+        await webContext?.dispose();
+        stopped = true;
+        session?.close();
+        await transport.close();
+        await connection?.close();
+        throw error;
+    }
+}
+function createWebRtcClientOptions(ticket, debug) {
+    return {
+        signalingTicket: ticket,
+        signalingSocketFactory: (url) => new WebSocket(url),
+        peerConnectionFactory: ({ iceServers, iceTransportPolicy }) => createPeerConnection({ iceServers, iceTransportPolicy }),
+        debug,
+    };
+}
+async function delay(ms, signal) {
+    if (signal?.aborted)
+        throw signal.reason instanceof Error ? signal.reason : new Error('请求已取消');
+    await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => { signal?.removeEventListener('abort', abort); resolve(); }, ms);
+        const abort = () => { clearTimeout(timer); signal?.removeEventListener('abort', abort); reject(signal?.reason instanceof Error ? signal.reason : new Error('请求已取消')); };
+        signal?.addEventListener('abort', abort, { once: true });
+    });
+}
+async function waitForSessionReady(session, signal, timeoutMs) {
+    await withTimeout(session.waitReady(signal), signal, timeoutMs, '等待 DSH session.ready 超时');
+}
+async function withTimeout(promise, signal, timeoutMs, message) {
+    if (signal?.aborted)
+        throw signal.reason instanceof Error ? signal.reason : new Error('请求已取消');
+    let timer;
+    let removeAbort;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error(message)), timeoutMs);
+                if (signal) {
+                    const onAbort = () => reject(signal.reason instanceof Error ? signal.reason : new Error('请求已取消'));
+                    signal.addEventListener('abort', onAbort, { once: true });
+                    removeAbort = () => signal.removeEventListener('abort', onAbort);
+                }
+            }),
+        ]);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+        removeAbort?.();
+    }
+}
+/** 使用同源或跨域 HttpOnly Cookie 调用控制站，不读取 Cookie 内容。 */
+export function createHttpDshH5ControlApi(baseUrl = '') {
+    const normalizedBaseUrl = baseUrl.replace(/\/+$/u, '');
+    return {
+        async listDevices(signal) {
+            return requestJson(`${normalizedBaseUrl}/api/v1/dsh/devices`, signal === undefined ? {} : { signal });
+        },
+        async createClientTicket(dshDeviceId, signal, sessionId) {
+            return requestJson(`${normalizedBaseUrl}/api/v1/dsh/relay/ticket`, {
+                method: 'POST',
+                ...(signal === undefined ? {} : { signal }),
+                body: { dshDeviceId, role: 'client', ...(sessionId?.trim() ? { sessionId: sessionId.trim() } : {}) },
+            });
+        },
+    };
+}
+export function chooseDshDevice(response, requested) {
+    const device = requested === undefined
+        ? response.devices.find((item) => item.online && item.status === 'active')
+        : response.devices.find((item) => item.dshDeviceId === requested && item.online && item.status === 'active');
+    if (!device)
+        throw new Error(requested ? `DSH 设备不可用: ${requested}` : '没有可用的 DSH Host');
+    return device;
+}
+/**
+ * HostScope 是线上 Tunnel 的共享身份，不是两端各自的视角。
+ * Host Runtime 当前以 local 作为 canonical kind；旧 Control API 未下发
+ * hostScope 时也必须回退到同一值，否则首个 session.hello 会被 Host 拒绝。
+ */
+export function resolveDshHostScope(ticket) {
+    const scope = ticket.hostScope;
+    if (scope !== undefined) {
+        if (scope.hostId !== ticket.dshDeviceId)
+            throw new Error('DSH Ticket HostScope 与设备不一致');
+        return scope;
+    }
+    return { hostId: ticket.dshDeviceId, kind: 'local' };
+}
+function createPeerConnection(options) {
+    const Constructor = globalThis.RTCPeerConnection;
+    if (!Constructor)
+        throw new Error('当前浏览器不支持 RTCPeerConnection');
+    return new Constructor({ iceServers: [...options.iceServers], iceTransportPolicy: options.iceTransportPolicy });
+}
+async function callRpc(rpc, endpoint, payload, signal) {
+    let result = await rpc.call('/codingns', endpoint, payload, signal);
+    // 旧 Host 在 auth 命名空间下暂时暴露 DSH 动作；迁移期间只允许此兼容回退，
+    // 数据和身份仍然使用 DSH 独立 DTO，不会回退到 Codingns4DSH binding。
+    if (!result.ok && (result.error.code === 'CODINGNS_RPC_NOT_FOUND' || /未知 Codingns4DSH RPC/u.test(result.error.message))) {
+        result = await rpc.call('/codingns', `auth/${endpoint}`, payload, signal);
+    }
+    if (!result.ok)
+        throw new Error(result.error.message);
+    return result.value;
+}
+async function requestJson(url, options = {}) {
+    const response = await fetch(url, {
+        method: options.method ?? 'GET',
+        credentials: 'include',
+        ...(options.signal === undefined ? {} : { signal: options.signal }),
+        headers: { accept: 'application/json', ...(options.body === undefined ? {} : { 'content-type': 'application/json' }) },
+        ...(options.body === undefined ? {} : { body: JSON.stringify(options.body) }),
+    });
+    const data = await response.json().catch(() => ({}));
+    if (!response.ok)
+        throw new Error(data.detail ?? data.errorCode ?? `Control API 请求失败 (${response.status})`);
+    return data;
+}
+//# sourceMappingURL=dsh-h5-bootstrap.js.map

package/data/build/dist/client/dsh-runtime-version.d.ts

@@ -0,0 +1,3 @@
+/** 读取 Host 注入的真实 DSH 版本，并在无法读取时拒绝启用 Client。 */
+export declare function assertInjectedDshVersion(): string;
+//# sourceMappingURL=dsh-runtime-version.d.ts.map

package/data/build/dist/client/dsh-runtime-version.js

@@ -0,0 +1,11 @@
+import { assertSupportedDshVersion, CODINGNS_DSH_ERROR_CODES, CODINGNS_DSH_VERSION_GLOBAL, CodingNsDshError, } from '../shared/index.js';
+/** 读取 Host 注入的真实 DSH 版本，并在无法读取时拒绝启用 Client。 */
+export function assertInjectedDshVersion() {
+    const value = globalThis[CODINGNS_DSH_VERSION_GLOBAL];
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new CodingNsDshError(CODINGNS_DSH_ERROR_CODES.DSH_VERSION_UNSUPPORTED, '无法读取当前 DSH 版本；为避免 Client API 不兼容，已拒绝启用 codingns4dsh');
+    }
+    assertSupportedDshVersion(value);
+    return value;
+}
+//# sourceMappingURL=dsh-runtime-version.js.map

package/data/build/dist/client/external-tool-stream.d.ts

@@ -0,0 +1,24 @@
+import type { CodingNsClientServices } from './features/types.js';
+/** 浏览器收到的 Host 外部工具临时标记。 */
+interface ExternalToolMarker {
+    readonly source: 'codingns-external-tool';
+    readonly phase: 'start' | 'update';
+    readonly callId: string;
+    readonly name: string;
+    readonly arguments: string;
+    readonly status: 'running' | 'completed' | 'failed';
+    readonly output?: string;
+    readonly error?: string;
+}
+export interface CodingNsExternalToolChatData {
+    readonly callId: string;
+    readonly name: string;
+    readonly arguments: string;
+    readonly status: ExternalToolMarker['status'];
+    readonly output?: string;
+    readonly error?: string;
+}
+/** 启用外部 Agent 时安装实时工具节点；模块停用时同时撤销 Definition 和 Renderer。 */
+export declare function registerExternalToolStreamUi(services: CodingNsClientServices): () => void;
+export {};
+//# sourceMappingURL=external-tool-stream.d.ts.map

package/data/build/dist/client/external-tool-stream.js

@@ -0,0 +1,114 @@
+import { createElement } from 'react';
+import { dshThemeColor } from './theme.js';
+/**
+ * 把实时 assistant/live-chunk 工具标记投影成 Chat 节点。
+ * assistant/attempt 读取仅为兼容已经存在的旧历史；新 Host 的持久时间线使用原生
+ * tool/call 与 tool/result，避免把工具事件误当成模型结算。
+ */
+const externalToolDefinition = {
+    kind: 'codingns-external-tool',
+    target: 'chat',
+    match(event) {
+        const marker = readMarker(event);
+        return marker === null ? null : { id: marker.callId, role: marker.phase === 'start' ? 'start' : 'update' };
+    },
+    start(_context, match) {
+        const marker = readMarker(match.event);
+        if (marker === null)
+            throw new Error('外部工具节点缺少起始标记');
+        return { marker };
+    },
+    update(context, match) {
+        const marker = readMarker(match.event);
+        return marker === null ? context.state : { marker };
+    },
+    buildViewNode(context) {
+        const state = context.state;
+        if (state === undefined)
+            return null;
+        const location = context.start?.location ?? context.matches[0]?.location ?? { kind: 'unresolved' };
+        return {
+            key: context.key,
+            kind: 'codingns-external-tool',
+            id: context.id,
+            target: 'chat',
+            anchorSeq: context.start?.event.seq ?? context.matches[0]?.event.seq ?? 0,
+            location,
+            visibility: 'visible',
+            data: state.marker,
+        };
+    },
+};
+/** 外部工具临时节点的紧凑渲染；持久化后由 DSH 原生工具节点接管。 */
+function ExternalToolNodeView(props) {
+    const data = props.node.data;
+    const statusLabel = data.status === 'failed' ? '失败' : data.status === 'completed' ? '已完成' : '运行中';
+    const output = data.error ?? data.output;
+    return createElement('div', {
+        style: {
+            alignSelf: 'stretch',
+            margin: '4px 0',
+            padding: '8px 10px',
+            border: `1px solid ${data.status === 'failed' ? dshThemeColor.error : dshThemeColor.border}`,
+            borderRadius: 6,
+            color: dshThemeColor.labelPrimary,
+            background: dshThemeColor.inputBackground,
+            fontSize: 13,
+            lineHeight: 1.45,
+        },
+        'data-codingns-external-tool': data.callId,
+    }, createElement('div', { style: { display: 'flex', justifyContent: 'space-between', gap: 12, fontWeight: 600 } }, createElement('span', undefined, data.name), createElement('span', { style: { color: data.status === 'failed' ? dshThemeColor.error : dshThemeColor.labelTertiary, fontWeight: 400 } }, statusLabel)), createElement('pre', { style: { margin: '4px 0 0', whiteSpace: 'pre-wrap', wordBreak: 'break-word', fontFamily: 'var(--dsw-font-family-mono, monospace)', color: dshThemeColor.labelSecondary } }, data.arguments), output === undefined || output === '' ? null : createElement('pre', { style: { margin: '6px 0 0', maxHeight: 180, overflow: 'auto', whiteSpace: 'pre-wrap', wordBreak: 'break-word', fontFamily: 'var(--dsw-font-family-mono, monospace)', color: data.status === 'failed' ? dshThemeColor.error : dshThemeColor.labelSecondary } }, output));
+}
+/** 启用外部 Agent 时安装实时工具节点；模块停用时同时撤销 Definition 和 Renderer。 */
+export function registerExternalToolStreamUi(services) {
+    const uiConversation = services.uiConversation;
+    const slots = services.slots;
+    if (uiConversation?.events?.register === undefined || slots === undefined)
+        return () => undefined;
+    const removeDefinition = uiConversation.events.register(externalToolDefinition);
+    const slotRegistry = slots;
+    const removeRenderer = slotRegistry.inject('conversation.chat.node', () => slotRegistry.register({
+        name: 'conversation.chat.node',
+        key: 'codingns-external-tool',
+    }, ExternalToolNodeView));
+    return () => {
+        removeRenderer();
+        removeDefinition();
+    };
+}
+function readMarker(event) {
+    if (!isRecord(event))
+        return null;
+    const data = event.data;
+    if (!isRecord(data))
+        return null;
+    const candidate = event.type === 'assistant/live-chunk'
+        ? isRecord(data.chunk) ? data.chunk.codingnsExternalTool : undefined
+        : event.type === 'assistant/attempt'
+            ? data.codingnsExternalTool
+            : undefined;
+    if (!isRecord(candidate) || candidate.source !== 'codingns-external-tool')
+        return null;
+    if (typeof candidate.callId !== 'string' || candidate.callId === '')
+        return null;
+    if (typeof candidate.name !== 'string' || typeof candidate.arguments !== 'string')
+        return null;
+    if (candidate.phase !== 'start' && candidate.phase !== 'update')
+        return null;
+    if (candidate.status !== 'running' && candidate.status !== 'completed' && candidate.status !== 'failed')
+        return null;
+    return {
+        source: 'codingns-external-tool',
+        phase: candidate.phase,
+        callId: candidate.callId,
+        name: candidate.name,
+        arguments: candidate.arguments,
+        status: candidate.status,
+        ...(typeof candidate.output === 'string' ? { output: candidate.output } : {}),
+        ...(typeof candidate.error === 'string' ? { error: candidate.error } : {}),
+    };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=external-tool-stream.js.map

package/data/build/dist/client/features/cli-adapters.d.ts

@@ -0,0 +1,7 @@
+import type { ReactElement } from 'react';
+import type { FeaturePanelProps, CodingNsClientFeatureModule } from './types.js';
+/** 外部 Agent 集成模块。Agent 进程在 Host 运行，浏览器只读取目录和状态。 */
+export declare const cliAdaptersFeature: CodingNsClientFeatureModule;
+/** 设置页中的 Agent 列表和详情模态框。 */
+export declare function CliAdaptersPanel({ services, enabled }: FeaturePanelProps): ReactElement;
+//# sourceMappingURL=cli-adapters.d.ts.map