@jingyi0605/codingns4dsh 0.1.0

package/assets/provider-icons/command-code.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-hidden="true">
+  <rect x="5" y="5" width="54" height="54" rx="12" fill="#111827" />
+  <path d="M18 24l8 8-8 8" fill="none" stroke="#f9fafb" stroke-linecap="round" stroke-linejoin="round" stroke-width="5" />
+  <path d="M33 42h13" fill="none" stroke="#60a5fa" stroke-linecap="round" stroke-width="5" />
+</svg>

package/assets/provider-icons/deepseek-harness.svg

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-hidden="true">
+  <circle cx="32" cy="32" r="27" fill="#2563eb" />
+  <path
+    d="M15 37c3-11 12-18 23-18 7 0 13 3 17 8-3-1-6-1-9 0 3 2 5 5 6 8-4-2-8-3-12-2-4 2-8 5-11 9-4 0-9-2-14-5z"
+    fill="#fff"
+  />
+  <circle cx="43" cy="27" r="2.5" fill="#2563eb" />
+  <path d="M17 39c4 5 10 8 17 8 5 0 10-2 14-5-5 1-10 1-14-1-5-2-10-3-17-2z" fill="#bfdbfe" />
+</svg>

package/assets/provider-icons/pi.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-hidden="true">
+  <rect x="5" y="5" width="54" height="54" rx="12" fill="#0b1220" />
+  <path d="M32 15v34" fill="none" stroke="#f9fafb" stroke-linecap="round" stroke-width="5" />
+  <path d="M19 32h26" fill="none" stroke="#f9fafb" stroke-linecap="round" stroke-width="5" />
+  <path d="M23 21h18" fill="none" stroke="#38bdf8" stroke-linecap="round" stroke-width="4" />
+  <path d="M23 43h18" fill="none" stroke="#38bdf8" stroke-linecap="round" stroke-width="4" />
+</svg>

package/data/build/dist/bootstrap/dsh-connection-adapter.d.ts

@@ -0,0 +1,97 @@
+import { type CodingNsTransportGeneration } from '../shared/index.js';
+import type { CodingNsTransport } from '../shared/index.js';
+import { DshCodingNsTransport } from '../transport/dsh-transport.js';
+import { type CodingNsTransportRegistration } from './index.js';
+export type { CodingNsTransportRegistration } from './index.js';
+/** DSH 0.1.6-alpha.2 的 ClientConnectionRpc 结果形状。 */
+export interface DshConnectionRpcResult<T = unknown> {
+    readonly ok: true;
+    readonly value: T;
+}
+export interface DshConnectionRpcFailure {
+    readonly code: string;
+    readonly message: string;
+    readonly details: object;
+}
+export type DshConnectionRpcResponse<T = unknown> = DshConnectionRpcResult<T> | {
+    readonly ok: false;
+    readonly error: DshConnectionRpcFailure;
+};
+/** 从 DSH 0.1.6-alpha.2 ClientTransportHooks 提取的最小运行时接口。 */
+export interface DshClientTransportHooks {
+    rpc: {
+        call(channel: string, endpoint: string, payload: unknown, signal?: AbortSignal): Promise<DshConnectionRpcResponse>;
+        open?(channel: string, endpoint: string, payload: unknown, signal: AbortSignal): AsyncIterable<unknown>;
+    };
+    fetch?: (input: URL, init: RequestInit) => Promise<Response>;
+    openStream?: (endpoint: string, payload: unknown, signal: AbortSignal) => AsyncIterable<unknown>;
+    loadBundle?: (url: string) => Promise<void>;
+    ownsHost?: boolean;
+    streamBaseUrl?: string;
+}
+export interface DshGenerationSource {
+    (signal: AbortSignal, ready: (host: {
+        home: string;
+    }) => void): Promise<void>;
+}
+export interface DshConnectionHandle {
+    registerGenerationSource(source: DshGenerationSource): () => void;
+    start(sinks: {
+        onReconnectRequested?: () => void;
+        onConnected?: (host: {
+            home: string;
+        }) => void;
+        onStateChange?: (state: 'connected' | 'connecting' | 'disconnected') => void;
+    }): {
+        stop(): void;
+    };
+}
+export interface DshConnectionContext {
+    connection: DshConnectionHandle;
+    effect(dispose: () => void | Promise<void>, name?: string): unknown;
+}
+export interface DshConnectionAdapter {
+    readonly hooks: DshClientTransportHooks;
+    readonly generationSource: DshGenerationSource;
+    readonly dispose: () => Promise<void>;
+}
+export interface DshTransportLifecycle {
+    generation?: () => CodingNsTransportGeneration | undefined;
+    onGenerationChange?: (listener: (generation: CodingNsTransportGeneration | undefined) => void) => () => void;
+    reconnect?: (signal?: AbortSignal) => Promise<void>;
+    close?: () => Promise<void>;
+}
+/**
+ * 将插件内部 Transport 映射为 DSH 的 ClientTransportHooks。
+ *
+ * DSH 的 rpc 以 channel/endpoint 分离路由；插件帧协议暂时只有一个 method
+ * 字段，因此适配层保留完整路由在 payload 中，避免丢失 DSH 的绝对 channel。
+ */
+export declare function createDshClientTransportHooks(transport: CodingNsTransport): DshClientTransportHooks;
+/**
+ * 将插件 generation 转换为 DSH ConnectionGenerationSource。
+ * 每个 source 只负责一个 generation；generation 失效后 promise 结束，
+ * 由 DSH ConnectionController 统一触发下一次 reconnect。
+ */
+export declare function createDshGenerationSource(transport: CodingNsTransport): DshGenerationSource;
+/** 从全局 hooks 读取 generation，供 Client entry 不持有 Node/Host 对象。 */
+export declare function createDshGenerationSourceFromHooks(hooks: DshTransportLifecycle): DshGenerationSource;
+/**
+ * 将已安装的 DSH Connection service 绑定到 Codingns4DSH Transport。
+ * 该函数只依赖 DSH 公开的 registerGenerationSource/start/stop，不覆盖默认 Connection。
+ */
+export declare function bindDshConnection(ctx: DshConnectionContext, transport: DshCodingNsTransport): () => Promise<void>;
+/** 将全局 hooks 的 generation/reconnect/close 生命周期接入 DSH Connection。 */
+export declare function bindDshConnectionHooks(ctx: DshConnectionContext, hooks: DshTransportLifecycle): () => Promise<void>;
+/**
+ * pre-Cordis 启动胶水：登记正确的 DSH hooks，并返回 Connection 绑定函数。
+ * 版本检查遵循 version.json 声明的兼容范围，避免未经验证的 generation 契约静默漂移。
+ */
+export declare function installDshTransport(options: {
+    dshVersion: string;
+    transport: DshCodingNsTransport;
+}): CodingNsTransportRegistration & {
+    hooks: DshClientTransportHooks;
+};
+export declare const SUPPORTED_DSH_CONNECTION_VERSION: "0.1.6-alpha.2";
+//# sourceMappingURL=dsh-connection-adapter.d.ts.map

package/data/build/dist/bootstrap/dsh-connection-adapter.js

@@ -0,0 +1,169 @@
+import { assertSupportedDshVersion, SUPPORTED_DSH_VERSION, } from '../shared/index.js';
+import { DshCodingNsTransport } from '../transport/dsh-transport.js';
+import { installPreCordisTransport, } from './index.js';
+/**
+ * 将插件内部 Transport 映射为 DSH 的 ClientTransportHooks。
+ *
+ * DSH 的 rpc 以 channel/endpoint 分离路由；插件帧协议暂时只有一个 method
+ * 字段，因此适配层保留完整路由在 payload 中，避免丢失 DSH 的绝对 channel。
+ */
+export function createDshClientTransportHooks(transport) {
+    const rpc = {
+        async call(channel, endpoint, payload, signal) {
+            try {
+                const request = {
+                    method: endpoint,
+                    payload: { channel, payload },
+                    ...(signal === undefined ? {} : { signal }),
+                };
+                const value = await transport.rpc(request);
+                return { ok: true, value };
+            }
+            catch (error) {
+                return {
+                    ok: false,
+                    error: {
+                        code: 'transport',
+                        message: error instanceof Error ? error.message : String(error),
+                        details: {},
+                    },
+                };
+            }
+        },
+        open(channel, endpoint, payload, signal) {
+            return transport.openStream({ method: endpoint, payload: { channel, payload }, signal });
+        },
+    };
+    const hooks = {
+        rpc,
+        fetch: (input, init) => transport.fetch(input, init),
+        openStream: (endpoint, payload, signal) => transport.openStream({ method: endpoint, payload, signal }),
+        loadBundle: (url) => transport.loadBundle(url),
+        generation: transport.getGeneration.bind(transport),
+        onGenerationChange: transport.onGenerationChange.bind(transport),
+        reconnect: transport.reconnect.bind(transport),
+        close: transport.close.bind(transport),
+    };
+    const generation = transport.getGeneration();
+    if (generation?.host.home)
+        hooks.ownsHost = true;
+    return hooks;
+}
+/**
+ * 将插件 generation 转换为 DSH ConnectionGenerationSource。
+ * 每个 source 只负责一个 generation；generation 失效后 promise 结束，
+ * 由 DSH ConnectionController 统一触发下一次 reconnect。
+ */
+export function createDshGenerationSource(transport) {
+    return (signal, ready) => new Promise((resolve) => {
+        let published;
+        let settled = false;
+        const cleanup = transport.onGenerationChange((generation) => {
+            if (settled)
+                return;
+            if (published === undefined && generation !== undefined) {
+                published = generation;
+                ready({ home: generation.host.home });
+                return;
+            }
+            if (published !== undefined && (generation === undefined || generation.id !== published.id))
+                finish();
+        });
+        const abort = () => finish();
+        signal.addEventListener('abort', abort, { once: true });
+        const current = transport.getGeneration();
+        if (current !== undefined) {
+            published = current;
+            ready({ home: current.host.home });
+        }
+        function finish() {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            signal.removeEventListener('abort', abort);
+            resolve();
+        }
+    });
+}
+/** 从全局 hooks 读取 generation，供 Client entry 不持有 Node/Host 对象。 */
+export function createDshGenerationSourceFromHooks(hooks) {
+    return (signal, ready) => new Promise((resolve) => {
+        if (!hooks.generation || !hooks.onGenerationChange) {
+            resolve();
+            return;
+        }
+        let published;
+        let settled = false;
+        const cleanup = hooks.onGenerationChange((generation) => {
+            if (settled)
+                return;
+            if (published === undefined && generation !== undefined) {
+                published = generation;
+                ready({ home: generation.host.home });
+            }
+            else if (published !== undefined && (generation === undefined || generation.id !== published.id)) {
+                finish();
+            }
+        });
+        const abort = () => finish();
+        signal.addEventListener('abort', abort, { once: true });
+        const current = hooks.generation();
+        if (current !== undefined) {
+            published = current;
+            ready({ home: current.host.home });
+        }
+        function finish() {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            signal.removeEventListener('abort', abort);
+            resolve();
+        }
+    });
+}
+/**
+ * 将已安装的 DSH Connection service 绑定到 Codingns4DSH Transport。
+ * 该函数只依赖 DSH 公开的 registerGenerationSource/start/stop，不覆盖默认 Connection。
+ */
+export function bindDshConnection(ctx, transport) {
+    return bindDshConnectionHooks(ctx, {
+        generation: transport.getGeneration.bind(transport),
+        onGenerationChange: transport.onGenerationChange.bind(transport),
+        reconnect: transport.reconnect.bind(transport),
+        close: transport.close.bind(transport),
+    });
+}
+/** 将全局 hooks 的 generation/reconnect/close 生命周期接入 DSH Connection。 */
+export function bindDshConnectionHooks(ctx, hooks) {
+    const source = createDshGenerationSourceFromHooks(hooks);
+    const unregister = ctx.connection.registerGenerationSource(source);
+    const loop = ctx.connection.start({
+        onReconnectRequested: () => { void hooks.reconnect?.(); },
+    });
+    let disposed = false;
+    return async () => {
+        if (disposed)
+            return;
+        disposed = true;
+        unregister();
+        loop.stop();
+        await hooks.close?.();
+    };
+}
+/**
+ * pre-Cordis 启动胶水：登记正确的 DSH hooks，并返回 Connection 绑定函数。
+ * 版本检查遵循 version.json 声明的兼容范围，避免未经验证的 generation 契约静默漂移。
+ */
+export function installDshTransport(options) {
+    assertSupportedDshVersion(options.dshVersion);
+    const hooks = createDshClientTransportHooks(options.transport);
+    const registration = installPreCordisTransport({
+        dshVersion: options.dshVersion,
+        transport: hooks,
+    });
+    return { ...registration, hooks };
+}
+export const SUPPORTED_DSH_CONNECTION_VERSION = SUPPORTED_DSH_VERSION;
+//# sourceMappingURL=dsh-connection-adapter.js.map

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

@@ -0,0 +1,38 @@
+import type { CodingNsTransportHooks } from '../shared/index.js';
+/**
+ * DSH 在 Cordis 启动前读取的页面级 Transport 形状。
+ *
+ * 这里故意只保留浏览器可用字段。真正的 WebRTC、信令和帧复用器由后续
+ * 阶段提供，本模块只负责把已经创建好的 Transport 交给 DSH。
+ */
+export interface CodingNsPreCordisTransport extends CodingNsTransportHooks {
+    ownsHost?: boolean;
+    streamBaseUrl?: string;
+}
+export interface CodingNsBootstrapOptions {
+    dshVersion: string;
+    transport: CodingNsPreCordisTransport;
+}
+export interface CodingNsBootWithTransportOptions extends CodingNsBootstrapOptions {
+    boot: () => void | Promise<void>;
+}
+export interface CodingNsTransportRegistration {
+    readonly transport: CodingNsPreCordisTransport;
+    dispose(): void;
+}
+export declare const CODINGNS_BOOTSTRAP_DSH_VERSION: "0.1.6-alpha.2";
+/**
+ * 在 DSH Client/Cordis 启动前登记唯一 Transport。
+ *
+ * 普通动态插件不得调用此函数。重复登记直接失败，避免悄悄覆盖 DSH
+ * 默认 Connection 或让两个连接 owner 竞争同一个 generation。
+ */
+export declare function installPreCordisTransport(options: CodingNsBootstrapOptions): CodingNsTransportRegistration;
+/**
+ * 以一次性启动顺序执行：版本校验 -> 登记 Transport -> 启动 DSH Client。
+ * boot 失败时会立即撤销全局 Transport，避免半启动状态污染下一次启动。
+ */
+export declare function bootWithPreCordisTransport(options: CodingNsBootWithTransportOptions): Promise<CodingNsTransportRegistration>;
+export { bindDshConnection, bindDshConnectionHooks, createDshClientTransportHooks, createDshGenerationSource, createDshGenerationSourceFromHooks, installDshTransport, SUPPORTED_DSH_CONNECTION_VERSION, } from './dsh-connection-adapter.js';
+export type { DshClientTransportHooks, DshConnectionAdapter, DshConnectionContext, DshConnectionHandle, DshConnectionRpcFailure, DshConnectionRpcResponse, DshConnectionRpcResult, DshGenerationSource, DshTransportLifecycle, } from './dsh-connection-adapter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,44 @@
+import { assertSupportedDshVersion, CODINGNS_DSH_ERROR_CODES, CodingNsDshError, SUPPORTED_DSH_VERSION, } from '../shared/index.js';
+export const CODINGNS_BOOTSTRAP_DSH_VERSION = SUPPORTED_DSH_VERSION;
+/**
+ * 在 DSH Client/Cordis 启动前登记唯一 Transport。
+ *
+ * 普通动态插件不得调用此函数。重复登记直接失败，避免悄悄覆盖 DSH
+ * 默认 Connection 或让两个连接 owner 竞争同一个 generation。
+ */
+export function installPreCordisTransport(options) {
+    assertSupportedDshVersion(options.dshVersion);
+    const globals = globalThis;
+    if (globals.__DSH_TRANSPORT__ !== undefined) {
+        throw new CodingNsDshError(CODINGNS_DSH_ERROR_CODES.TRANSPORT_NOT_READY, 'DSH 启动胶水已经登记了 Transport；不允许重复接管 Connection');
+    }
+    globals.__DSH_TRANSPORT__ = options.transport;
+    let disposed = false;
+    return {
+        transport: options.transport,
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            if (globals.__DSH_TRANSPORT__ === options.transport)
+                delete globals.__DSH_TRANSPORT__;
+        },
+    };
+}
+/**
+ * 以一次性启动顺序执行：版本校验 -> 登记 Transport -> 启动 DSH Client。
+ * boot 失败时会立即撤销全局 Transport，避免半启动状态污染下一次启动。
+ */
+export async function bootWithPreCordisTransport(options) {
+    const registration = installPreCordisTransport(options);
+    try {
+        await options.boot();
+        return registration;
+    }
+    catch (error) {
+        registration.dispose();
+        throw error;
+    }
+}
+export { bindDshConnection, bindDshConnectionHooks, createDshClientTransportHooks, createDshGenerationSource, createDshGenerationSourceFromHooks, installDshTransport, SUPPORTED_DSH_CONNECTION_VERSION, } from './dsh-connection-adapter.js';
+//# sourceMappingURL=index.js.map

package/data/build/dist/client/account-bar.d.ts

@@ -0,0 +1,9 @@
+import type { CodingNsSettings } from '../shared/contracts/config.js';
+import type { CodingNsRpcClient } from './features/types.js';
+import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+export interface AccountBarController {
+    dispose(): void;
+}
+/** 在 DSH 设置触发器旁挂载统一账户入口，兼容侧栏横排与收起竖排。 */
+export declare function startCodingNsAccountBar(rpc: CodingNsRpcClient, dom?: Document, settings?: SettingsScope<CodingNsSettings>): AccountBarController;
+//# sourceMappingURL=account-bar.d.ts.map