dsh-multi-chat 0.4.0

package/plugin/dsh-client-ui-multi-wall/lib/invariant.js

@@ -0,0 +1,27 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for
+* `@deepseek-ai/dsh-client-ui-multi-wall`.
+* @module @deepseek-ai/dsh-client-ui-multi-wall/invariant
+*/
+const PACKAGE_NAME = "@deepseek-ai/dsh-client-ui-multi-wall";
+/** Cordis companion plugin name. */
+const name = "client-ui-multi-wall-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: the wall contributes the conversation view-ring entry
+* (the wall surface) and the sidebar footer shortcut, whose disposal is
+* proven by the HMR-safety spec — the plugin owns one store handle used by
+* the view entry, emits no cordis events, and holds no cross-plugin mutable
+* state.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/plugin/dsh-client-ui-multi-wall/lib/types/client/WallToggle.d.ts

@@ -0,0 +1,10 @@
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+/** Composed props: sidebar column state + locale. */
+export type WallToggleProps = PropsRuntime<'sidebar.footer.action'> & PropsLocale<'multiWall'>;
+/**
+ * Render the wall shortcut row (icon; label only in the wide column).
+ * @param props - composed slot props.
+ * @returns the shortcut row.
+ */
+export declare function WallToggle({ wide, t }: WallToggleProps): import("react").JSX.Element;
+//# sourceMappingURL=WallToggle.d.ts.map

package/plugin/dsh-client-ui-multi-wall/lib/types/client/WallView.d.ts

@@ -0,0 +1,16 @@
+import type { PropsLocale, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import type { HandleOf } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ConvViewProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { createWallStore } from './store.ts';
+import type { WallInjected } from './wall-injected.ts';
+/** Composed props: the view-ring runtime share, the store, the probe face, and locale. */
+export type WallViewProps = ConvViewProps & PropsStore<HandleOf<typeof createWallStore>> & WallInjected & PropsLocale<'multiWall'>;
+/**
+ * Render the wall: toolbar plus the horizontally-filled pane grid. Discovery
+ * runs on mount and liveness polls every 5s; the store's persisted ports
+ * survive view switches and reloads.
+ * @param props - composed slot props.
+ * @returns the wall surface.
+ */
+export declare function WallView({ useStore, actions, discover, probe, stop, create, link, t }: WallViewProps): import("react").JSX.Element;
+//# sourceMappingURL=WallView.d.ts.map

package/plugin/dsh-client-ui-multi-wall/lib/types/client/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Multi-window wall plugin, browser half: contributes the wall as a
+ * `conversation.view` ring entry (the official replace-the-chat-surface
+ * mechanism — the header grows a "多窗口墙" tab and the right panel swaps to
+ * the wall) plus a sidebar footer shortcut that jumps to that view. No
+ * existing slot is replaced and no original interaction logic changes; the
+ * wall is pure UI over the node half's /multi/api probe routes.
+ *
+ * Recursion guard: a wall pane embeds each instance as
+ * `http://127.0.0.1:<port>/?multi-wall=embed`; the embedded page sees the
+ * query flag and registers nothing, so a pane can never grow a wall of its
+ * own. The wall also never renders the port it is served on (SELF_PORT is
+ * filtered at render time and by the node half's discovery).
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type MultiWallKey } from './locales.ts';
+export { WallView } from './WallView.tsx';
+export type { WallViewProps } from './WallView.tsx';
+export { WallToggle } from './WallToggle.tsx';
+export type { WallToggleProps } from './WallToggle.tsx';
+export type { MultiWallKey } from './locales.ts';
+export { createWallStore } from './store.ts';
+export type { WallState, WallActions } from './store.ts';
+export type { ProbeRow, StopRow, WallInjected } from './wall-injected.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Multi-window wall copy. */
+        multiWall: MultiWallKey;
+    }
+}
+/** Required services: slots for both registrations, locale for copy. */
+export declare const inject: string[];
+/**
+ * Client plugin body: register the dictionaries, the view-ring entry (the
+ * wall), and the sidebar footer shortcut. Embedded panes register nothing.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

package/plugin/dsh-client-ui-multi-wall/lib/types/client/locales.d.ts

@@ -0,0 +1,94 @@
+/** `multiWall` namespace dictionaries. */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    toggle: string;
+    'toggle.aria': string;
+    'view.multiWall': string;
+    'overlay.title': string;
+    'overlay.close': string;
+    scan: string;
+    'scan.from': string;
+    'scan.to': string;
+    create: string;
+    'create.done': string;
+    'create.failed': string;
+    'create.unknown': string;
+    exit: string;
+    'exit.aria': string;
+    link: string;
+    'link.aria': string;
+    'link.fetching': string;
+    'link.none': string;
+    'link.copy': string;
+    'link.copied': string;
+    'link.hint': string;
+    'link.reachable': string;
+    'link.unreachable': string;
+    columns: string;
+    'columns.auto': string;
+    refresh: string;
+    openTab: string;
+    reload: string;
+    remove: string;
+    stop: string;
+    'stop.confirm': string;
+    'stop.self': string;
+    'stop.done': string;
+    'stop.failed': string;
+    zoom: string;
+    loading: string;
+    empty: string;
+    'empty.hint': string;
+    'status.scanning': string;
+    'status.found': string;
+    'status.none': string;
+    'status.refreshed': string;
+};
+/** The multi-wall namespace key union. */
+export type MultiWallKey = keyof typeof zh;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    toggle: string;
+    'toggle.aria': string;
+    'view.multiWall': string;
+    'overlay.title': string;
+    'overlay.close': string;
+    scan: string;
+    'scan.from': string;
+    'scan.to': string;
+    create: string;
+    'create.done': string;
+    'create.failed': string;
+    'create.unknown': string;
+    exit: string;
+    'exit.aria': string;
+    link: string;
+    'link.aria': string;
+    'link.fetching': string;
+    'link.none': string;
+    'link.copy': string;
+    'link.copied': string;
+    'link.hint': string;
+    'link.reachable': string;
+    'link.unreachable': string;
+    columns: string;
+    'columns.auto': string;
+    refresh: string;
+    openTab: string;
+    reload: string;
+    remove: string;
+    stop: string;
+    'stop.confirm': string;
+    'stop.self': string;
+    'stop.done': string;
+    'stop.failed': string;
+    zoom: string;
+    loading: string;
+    empty: string;
+    'empty.hint': string;
+    'status.scanning': string;
+    'status.found': string;
+    'status.none': string;
+    'status.refreshed': string;
+};
+//# sourceMappingURL=locales.d.ts.map

package/plugin/dsh-client-ui-multi-wall/lib/types/client/store.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Wall store: which instances are shown and the grid columns. The ports list
+ * is the wall's whole business state — discovery writes it, removal filters
+ * it, and the grid renders from it. Open/closed is NOT stored here: the wall
+ * is a `conversation.view` ring entry, so the active view (chat store's
+ * `view` field) decides whether it renders.
+ */
+import { type EngineStoreHandle } from '@deepseek-ai/dsh-client-runtime/client';
+/** Wall viewing state: displayed ports and grid columns. */
+export type WallState = {
+    ports: number[];
+    columns: string;
+};
+/** The wall store's complete write set. */
+export type WallActions = {
+    setPorts: (draft: WallState, ports: number[]) => void;
+    addPort: (draft: WallState, port: number) => void;
+    removePort: (draft: WallState, port: number) => void;
+    setColumns: (draft: WallState, columns: string) => void;
+};
+/**
+ * Create the wall store handle. Persisted under `dsh.multi-wall` so the port
+ * set and column choice survive view switches and reloads.
+ * @returns the store handle (spec + type + identity + factory in one).
+ */
+export declare function createWallStore(): EngineStoreHandle<WallState, WallActions>;
+//# sourceMappingURL=store.d.ts.map

package/plugin/dsh-client-ui-multi-wall/lib/types/client/wall-injected.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Injected probe face for the wall view: same-origin fetches to the node
+ * half's /multi/api routes. Callbacks only — components never see ctx.
+ */
+/** One liveness row from /multi/api/status. */
+export interface ProbeRow {
+    port: number;
+    alive: boolean;
+    status: number;
+}
+/** One stop result row from /multi/api/stop. */
+export interface StopRow {
+    port: number;
+    ok: boolean;
+    error?: string;
+}
+/** One create result row from /multi/api/create. */
+export interface CreateRow {
+    ok: boolean;
+    port?: number;
+    error?: string;
+}
+/** The phone-reachable link info from /multi/api/link. */
+export interface LinkRow {
+    port: number;
+    host: string;
+    /** LAN URLs (`http://<lan-ip>:<port>/`), possibly empty. */
+    lan: string[];
+    /** Whether the instance is reachable off-loopback (binds 0.0.0.0). */
+    reachable: boolean;
+    /** Human hint when not reachable (restart / tunnel guidance). */
+    hint?: string;
+}
+/** The inject face delivered to the wall view registration. */
+export interface WallInjected {
+    /** Discover live DSH instances (same-origin /multi/api/ports). */
+    discover: () => Promise<number[]>;
+    /** Probe liveness of specific ports (same-origin /multi/api/status). */
+    probe: (ports: number[]) => Promise<ProbeRow[]>;
+    /** Terminate the DSH instance on one port (same-origin /multi/api/stop). */
+    stop: (port: number) => Promise<StopRow>;
+    /** Start a new DSH instance and return its port (same-origin /multi/api/create). */
+    create: () => Promise<CreateRow>;
+    /** The phone-reachable link for this instance (same-origin /multi/api/link). */
+    link: () => Promise<LinkRow>;
+}
+/**
+ * Build the probe face bound to this origin's /multi/api routes.
+ * @param mount - the API base path ('' at the root, '/multi' when mounted).
+ * @returns the injected callbacks.
+ */
+export declare function createWallInjected(mount?: string): WallInjected;
+//# sourceMappingURL=wall-injected.d.ts.map

package/plugin/dsh-client-ui-multi-wall/lib/types/index.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Multi-window wall plugin, node half: registers the `/multi/api/*` routes
+ * on the webserver. The browser half fetches these same-origin to discover
+ * which local ports are live DSH instances, to poll liveness, and to
+ * terminate a chosen instance (`/multi/api/stop`). The wall itself is pure
+ * UI — this half answers a few small JSON requests.
+ * @module @deepseek-ai/dsh-client-ui-multi-wall
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+/** Stable Cordis plugin name. */
+export declare const name = "client-ui-multi-wall";
+/** Services required before the probe routes can be registered. */
+export declare const inject: string[];
+/** Plugin config: the wall's auto-discovery scan range. */
+export interface MultiWallConfig {
+    /** First port of the auto-discovery range. */
+    scanFrom?: number;
+    /** Last port of the auto-discovery range. */
+    scanTo?: number;
+    /** Optional fixed port list; when set, discovery ignores the scan range. */
+    ports?: number[];
+    /**
+     * External base URL reported by `/multi/api/link` (e.g. the authenticated
+     * gateway in front of this loopback instance). When set, the link route
+     * answers `{ lan: [publicUrl + '/'], reachable: true }`.
+     */
+    publicUrl?: string;
+}
+/** Schema-validated config (the Loader resolves defaults for absent keys). */
+export declare const Config: z<Schemastery.ObjectS<{
+    scanFrom: z<number, number>;
+    scanTo: z<number, number>;
+    ports: z<number[], number[]>;
+    publicUrl: z<string, string>;
+}>, Schemastery.ObjectT<{
+    scanFrom: z<number, number>;
+    scanTo: z<number, number>;
+    ports: z<number[], number[]>;
+    publicUrl: z<string, string>;
+}>>;
+/** One stop result row from /multi/api/stop. */
+export interface StopRow {
+    port: number;
+    ok: boolean;
+    /** Human-readable failure reason (absent on success). */
+    error?: string;
+}
+/**
+ * Terminate the DSH instance listening on one local port. The port serving
+ * this wall may also be terminated (the user may want to stop the instance
+ * they are viewing): the kill is deferred a beat so the HTTP response is
+ * written before the process dies, then the listener's PIDs are force-killed.
+ * @param port - the target port.
+ * @param selfPort - this instance's own listening port.
+ * @returns the stop result.
+ */
+export declare function stopPort(port: number, selfPort: number): Promise<StopRow>;
+/**
+ * Register the probe routes. Everything lives under `/multi/api` so the
+ * plugin is purely additive: exact `ports` (auto-discovery) and `status`
+ * (liveness of a specific port list).
+ * @param ctx - plugin context carrying the webServer service.
+ * @param config - validated {@link MultiWallConfig}.
+ */
+export declare function apply(ctx: Context, config?: MultiWallConfig): void;
+//# sourceMappingURL=index.d.ts.map

package/plugin/dsh-client-ui-multi-wall/lib/types/invariant.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Package-owned invariant companion for
+ * `@deepseek-ai/dsh-client-ui-multi-wall`.
+ * @module @deepseek-ai/dsh-client-ui-multi-wall/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-multi-wall-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/plugin/dsh-client-ui-multi-wall/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@deepseek-ai/dsh-client-ui-multi-wall",
+  "description": "Multi-window wall surface: a sidebar footer action that opens a full-screen wall of every running DSH instance (one pane per port), inside the official web GUI. Additive slots only 鈥?no existing row or interaction logic is changed.",
+  "version": "0.2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-multi-wall"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-ui-sidebar",
+        "@deepseek-ai/dsh-client-ui-primitives"
+      ],
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/dsh-client-locale": "workspace:^",
+    "@deepseek-ai/dsh-client-runtime": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-layout": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-primitives": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-sidebar": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-slots": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-conversation": "workspace:^",
+    "@deepseek-ai/dsh-invariants": "workspace:^",
+    "@deepseek-ai/cordis": "workspace:^",
+    "@deepseek-ai/schemastery": "workspace:^",
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-client-locale": "workspace:^",
+    "@deepseek-ai/dsh-client-runtime": "workspace:^",
+    "@deepseek-ai/dsh-client-test-runtime": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-layout": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-primitives": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-sidebar": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-slots": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-conversation": "workspace:^",
+    "@deepseek-ai/dsh-invariants": "workspace:^",
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "~18.3.1",
+    "@deepseek-ai/cordis": "workspace:^",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ]
+}

package/scripts/gateway-hidden.vbs

@@ -0,0 +1,35 @@
+' gateway-hidden.vbs — launch the authenticated gateway with NO console window.
+' Uses WScript.Shell.Run(..., 0, false) so no conhost window ever flashes.
+'
+' Usage:
+'   wscript.exe "D:\2026AppDev\dsh-plugins-multi-task\scripts\gateway-hidden.vbs"
+'
+' Or, to run with custom values, edit the constants below.
+' The node process is detached (second Run arg = false), so it outlives this
+' script. The hidden-window flag (0) keeps it fully invisible.
+
+Option Explicit
+
+' ---- config ----
+Dim port, target, token, name
+port   = 8443
+target = "127.0.0.1:3070"
+token  = "dsh2026"
+name   = "DSH"
+' ----------------
+
+Dim fso, shell, scriptAbs
+Set fso   = CreateObject("Scripting.FileSystemObject")
+Set shell = CreateObject("WScript.Shell")
+
+' Absolute path to gateway.mjs, resolved relative to THIS script file.
+scriptAbs = fso.GetParentFolderName(WScript.ScriptFullName) & "\gateway.mjs"
+
+' Quote the path defensively (spaces etc.).
+scriptAbs = """" & scriptAbs & """"
+
+Dim cmd
+cmd = "node " & scriptAbs & " --target " & target & " --listen 0.0.0.0:" & CStr(port) & " --token " & token & " --name " & name
+
+' 0 = hidden window, false = don't wait for it to finish.
+shell.Run cmd, 0, false

package/scripts/gateway-start.ps1

@@ -0,0 +1,21 @@
+# gateway-start.ps1 — start the authenticated gateway with no console window.
+# Wrapper around gateway-hidden.vbs (WScript.Shell window style 0 = invisible).
+#
+# Usage:
+#   .\scripts\gateway-start.ps1
+#
+# Values come from gateway-hidden.vbs (port 8443 -> 127.0.0.1:3070,
+# token dsh2026). Edit that file to change them.
+
+$ErrorActionPreference = 'Stop'
+$root = Split-Path -Parent $PSScriptRoot
+$vbs = Join-Path $root 'scripts\gateway-hidden.vbs'
+
+if (-not (Test-Path $vbs)) { throw "未找到启动器：$vbs" }
+
+# wscript runs the VBS with a hidden window (no console flash).
+Start-Process -FilePath 'wscript.exe' -ArgumentList ('"' + $vbs + '"') -WindowStyle Hidden | Out-Null
+
+Write-Host "网关已在后台静默启动（无窗口）。"
+Write-Host "手机访问：http://<局域网IP>:8443  （口令 dsh2026）"
+Write-Host "停止：.\scripts\gateway-stop.ps1"

package/scripts/gateway-stop.ps1

@@ -0,0 +1,34 @@
+# gateway-stop.ps1 — stop the authenticated gateway (finds the node process
+# listening on the gateway port and terminates it).
+#
+# Usage:
+#   .\scripts\gateway-stop.ps1           # default port 8443
+#   .\scripts\gateway-stop.ps1 -Port 8443
+
+param(
+    [int]$Port = 8443
+)
+
+$ErrorActionPreference = 'Stop'
+
+$conns = Get-NetTCPConnection -LocalPort $Port -State Listen -ErrorAction SilentlyContinue
+if (-not $conns) {
+    Write-Host "端口 $Port 上没有正在监听的网关进程。"
+    exit 0
+}
+
+$pids = $conns | Select-Object -ExpandProperty OwningProcess -Unique
+foreach ($pid in $pids) {
+    $proc = Get-Process -Id $pid -ErrorAction SilentlyContinue
+    if ($proc) {
+        Stop-Process -Id $pid -Force
+        Write-Host "已停止网关进程 (PID $pid, $($proc.ProcessName))。"
+    }
+}
+
+Start-Sleep -Milliseconds 300
+if (Get-NetTCPConnection -LocalPort $Port -State Listen -ErrorAction SilentlyContinue) {
+    Write-Warning "端口 $Port 仍有监听，可能未完全停止。"
+} else {
+    Write-Host "端口 $Port 已释放。"
+}