dsh-plugin-wsl-env 0.10.0 → 0.12.0

package/lib/agent.d.ts

@@ -59,6 +59,14 @@ export interface ExecResult {
 export interface PendingRequest {
     /** The request id, as the agent echoes it. */
     id: string;
+    /** Which metric bucket this request belongs to. */
+    kind: "fs" | "exec";
+    /** When the frame was written, for the queue measurement. */
+    sentAt: number;
+    /** When the agent ACKed it, for the execution measurement. */
+    ackedAt?: number;
+    /** Whether the metrics recorded this request's settle. */
+    measured: boolean;
     /** The frame lines (kept so a rebuild can re-send). */
     lines: string[];
     /** Settles a RES. */
@@ -80,6 +88,51 @@ export interface PendingRequest {
     /** The caller was already settled; a late answer only cleans up. */
     settled: boolean;
 }
+/** Per-kind request metrics. */
+export interface RequestMetrics {
+    /** Requests that settled (successful, failed or cancelled). */
+    requests: number;
+    /** Total queue wait (sent -> ACK), ms. */
+    queueMs: number;
+    /** Largest single queue wait, ms. */
+    queueMaxMs: number;
+    /** Total execution time (ACK -> settle), ms. */
+    execMs: number;
+    /** Largest single execution time, ms. */
+    execMaxMs: number;
+    /** Settled with an error (not cancellation). */
+    failed: number;
+    /** Cancelled by the caller. */
+    cancelled: number;
+    /** Rejected before tracking: queue full, already aborted, or send failed. */
+    rejected: number;
+}
+/** The agent's cumulative request metrics. */
+export interface AgentMetrics {
+    /** FS frames. */
+    fs: RequestMetrics;
+    /** EXEC frames (commands, ping). */
+    exec: RequestMetrics;
+    /** Peak number of pending requests. */
+    inFlightMax: number;
+}
+/** The entry an async preparation may select before the first spawn. */
+export interface WslAgentPrepared {
+    /** The agent entrypoint (the shell script or the native cache path). */
+    scriptPath: string;
+    /** The HELLO digest to verify. */
+    expectedDigest?: string;
+    /** Whether USR1 can reach the agent (false for the native KILL-frame path). */
+    signalable?: boolean;
+    /** The process factory for this entry. */
+    spawnTransport?: (options: {
+        wslPath: string;
+        distro: string;
+        scriptPath: string;
+        argvPrefix: string[];
+        leaseMs: number;
+    }) => ChildProcess;
+}
 /**
  * The Windows environment the transport starts from, pinned.
  *
@@ -180,6 +233,10 @@ export declare class WslAgent {
     idleTimer: NodeJS.Timeout | null;
     /** The last failure, for `unavailableReason` and log messages. */
     lastError: string;
+    /** Cumulative request metrics; see {@link metrics}. */
+    requestMetrics: AgentMetrics;
+    /** The optional async preparation hook. */
+    prepare: (() => Promise<WslAgentPrepared | undefined>) | undefined;
     /**
      * @param config - the agent configuration.
      */
@@ -248,6 +305,8 @@ export declare class WslAgent {
          * refused instead of growing the request map without bound.
          */
         maxPending?: number;
+        /** Optional async preparation selecting the entry before the first spawn. */
+        prepare?: () => Promise<WslAgentPrepared | undefined>;
     });
     /**
      * Whether the agent is permanently out — the executor's fallback cue.
@@ -264,6 +323,18 @@ export declare class WslAgent {
      * @returns resolved once the state is `ready`.
      */
     start(): Promise<void>;
+    /**
+     * Apply an async preparation entry to this agent before the first spawn.
+     *
+     * @param entry - the selected entry.
+     */
+    private applyPrepared;
+    /**
+     * Spawn the process and run the handshake.
+     *
+     * @returns resolved once the state is `ready`.
+     */
+    private beginStart;
     /**
      * One stdout line from the agent. The first must be a matching HELLO.
      *
@@ -384,6 +455,38 @@ export declare class WslAgent {
      *
      * @param signal - the signal to deliver (`SIGUSR1` is the cancel trap).
      */
+    /**
+     * The cumulative request metrics: queue wait (sent -> ACK) and execution
+     * time (ACK -> settle) per request kind, plus the peak in-flight count.
+     *
+     * @returns a snapshot the caller can keep.
+     */
+    metrics(): AgentMetrics;
+    /** Reset the cumulative metrics (diagnostics/probes). */
+    resetMetrics(): void;
+    /**
+     * The metric bucket for a request kind.
+     * @param kind - fs or exec.
+     * @returns the bucket.
+     */
+    private kindMetrics;
+    /**
+     * Record a request that never entered the pending map.
+     * @param kind - the bucket.
+     */
+    private noteRejected;
+    /**
+     * Record the dequeue ACK: the request's queue wait.
+     * @param pending - the request.
+     */
+    private recordAck;
+    /**
+     * Record a settle: the requests count, the execution time (or the queue wait
+     * for a request that never ACKed), and the outcome.
+     * @param pending - the request.
+     * @param error - the failure, when any.
+     */
+    private recordSettle;
     private signalAgent;
     /**
      * Shut the agent down: SHUTDOWN first, then kill after a short grace. The

package/lib/agent.js

@@ -40,6 +40,20 @@
 import { spawn } from "node:child_process";
 import { AgentUnavailableError, CwdError } from "./agent-errors.js";
 import { AGENT_NAME, MAX_FRAME_BYTES, PROTOCOL_VERSION, encodeExecFrame, encodeFsFrame, encodeKill, encodeSetEnv, parseAgentLine } from "./agent-protocol.js";
+/**
+ * A zeroed per-kind metrics record.
+ * @returns the record.
+ */
+function emptyRequestMetrics() {
+    return { requests: 0, queueMs: 0, queueMaxMs: 0, execMs: 0, execMaxMs: 0, failed: 0, cancelled: 0, rejected: 0 };
+}
+/**
+ * A zeroed metrics snapshot.
+ * @returns the snapshot.
+ */
+function emptyAgentMetrics() {
+    return { fs: emptyRequestMetrics(), exec: emptyRequestMetrics(), inFlightMax: 0 };
+}
 /** How long a rebuilt agent has to re-answer the handshake before giving up. */
 const HANDSHAKE_TIMEOUT_MS = 15000;
 /** Extra time the host watchdog waits past the request's own in-distro timeout. */
@@ -160,6 +174,8 @@ export class WslAgent {
         this.rebuildUsed = false;
         this.idleTimer = null;
         this.lastError = "";
+        this.requestMetrics = emptyAgentMetrics();
+        this.prepare = config.prepare;
     }
     /**
      * Whether the agent is permanently out — the executor's fallback cue.
@@ -187,9 +203,42 @@ export class WslAgent {
             return Promise.resolve();
         if (this.startPromise)
             return this.startPromise;
+        const prepared = this.prepare?.();
+        if (prepared === undefined) {
+            const started = this.beginStart();
+            this.startPromise = started;
+            return started;
+        }
+        const started = prepared.then((entry) => {
+            if (entry !== undefined)
+                this.applyPrepared(entry);
+            return this.beginStart();
+        });
+        this.startPromise = started;
+        return started;
+    }
+    /**
+     * Apply an async preparation entry to this agent before the first spawn.
+     *
+     * @param entry - the selected entry.
+     */
+    applyPrepared(entry) {
+        this.scriptPath = entry.scriptPath;
+        this.expectedDigest = entry.expectedDigest;
+        if (entry.signalable !== undefined)
+            this.signalable = entry.signalable;
+        if (entry.spawnTransport !== undefined)
+            this.configuredSpawn = entry.spawnTransport;
+    }
+    /**
+     * Spawn the process and run the handshake.
+     *
+     * @returns resolved once the state is `ready`.
+     */
+    beginStart() {
         this.state = "starting";
         this.agentPid = undefined;
-        this.startPromise = new Promise((resolve, reject) => {
+        return new Promise((resolve, reject) => {
             // stdio is all-pipe (the spawn options above), so every standard stream
             // exists; the broad ChildProcess type models them as nullable.
             const child = (this.process = (this.configuredSpawn ?? spawnDefault)({
@@ -286,7 +335,6 @@ export class WslAgent {
                 this.lastError = String(chunk).trim().slice(0, 2000) || this.lastError;
             });
         });
-        return this.startPromise;
     }
     /**
      * One stdout line from the agent. The first must be a matching HELLO.
@@ -333,6 +381,7 @@ export class WslAgent {
                 const pending = this.pending.get(message.id);
                 if (pending) {
                     pending.started = true;
+                    this.recordAck(pending);
                     if (pending.cancelled)
                         this.signalAgent("SIGUSR1");
                     pending.armWatchdog?.();
@@ -487,16 +536,26 @@ export class WslAgent {
      *
      * @param request - the request to register.
      */
-    track({ id, lines, resolve, reject, timeoutMs, signal }) {
+    track({ id, kind = "exec", lines, resolve, reject, timeoutMs, signal }) {
         if (this.pending.size >= this.maxPending) {
+            this.noteRejected(kind);
             reject(new Error(`the resident agent has ${this.pending.size} requests in flight (max ${this.maxPending}); retry when the queue drains`));
             return;
         }
         const pending = {
             id,
+            kind,
+            sentAt: performance.now(),
+            measured: false,
             lines,
-            resolve,
-            reject,
+            resolve: (result) => {
+                this.recordSettle(pending, undefined);
+                resolve(result);
+            },
+            reject: (error) => {
+                this.recordSettle(pending, error);
+                reject(error);
+            },
             watchdog: null,
             signal: signal ?? null,
             onAbort: null,
@@ -525,9 +584,11 @@ export class WslAgent {
                 : null,
         };
         this.pending.set(id, pending);
+        this.requestMetrics.inFlightMax = Math.max(this.requestMetrics.inFlightMax, this.pending.size);
         if (signal) {
             if (signal.aborted) {
                 this.pending.delete(id);
+                this.noteRejected(kind);
                 reject(signal.reason instanceof Error ? signal.reason : new Error("aborted"));
                 return;
             }
@@ -557,6 +618,7 @@ export class WslAgent {
         if (!this.writeLines(lines)) {
             this.clearPending(pending);
             this.pending.delete(pending.id);
+            this.noteRejected(kind);
             reject(new AgentUnavailableError("the agent exited before the request could be sent; it never ran"));
             return;
         }
@@ -580,7 +642,7 @@ export class WslAgent {
             ...encodeExecFrame({ id, cwd, argv, timeoutMs, maxOutputBytes }),
         ];
         return new Promise((resolve, reject) => {
-            this.track({ id, lines, resolve, reject, timeoutMs, signal });
+            this.track({ id, kind: "exec", lines, resolve, reject, timeoutMs, signal });
         });
     }
     /**
@@ -602,7 +664,7 @@ export class WslAgent {
         const id = `r${this.nextRequestId++}`;
         const lines = encodeFsFrame({ id, op, args, timeoutMs });
         return new Promise((resolve, reject) => {
-            this.track({ id, lines, resolve, reject, timeoutMs, signal });
+            this.track({ id, kind: "fs", lines, resolve, reject, timeoutMs, signal });
         });
     }
     /**
@@ -620,7 +682,7 @@ export class WslAgent {
         return new Promise((resolve, reject) => {
             const id = `r${this.nextRequestId++}`;
             const lines = encodeExecFrame({ id, cwd: "/", argv: ["true"], timeoutMs: 0 });
-            this.track({ id, lines, resolve: () => resolve(), reject, timeoutMs: HANDSHAKE_TIMEOUT_MS, signal });
+            this.track({ id, kind: "exec", lines, resolve: () => resolve(), reject, timeoutMs: HANDSHAKE_TIMEOUT_MS, signal });
         });
     }
     /**
@@ -637,6 +699,80 @@ export class WslAgent {
      *
      * @param signal - the signal to deliver (`SIGUSR1` is the cancel trap).
      */
+    /**
+     * The cumulative request metrics: queue wait (sent -> ACK) and execution
+     * time (ACK -> settle) per request kind, plus the peak in-flight count.
+     *
+     * @returns a snapshot the caller can keep.
+     */
+    metrics() {
+        return {
+            fs: { ...this.requestMetrics.fs },
+            exec: { ...this.requestMetrics.exec },
+            inFlightMax: this.requestMetrics.inFlightMax,
+        };
+    }
+    /** Reset the cumulative metrics (diagnostics/probes). */
+    resetMetrics() {
+        this.requestMetrics = emptyAgentMetrics();
+    }
+    /**
+     * The metric bucket for a request kind.
+     * @param kind - fs or exec.
+     * @returns the bucket.
+     */
+    kindMetrics(kind) {
+        return kind === "fs" ? this.requestMetrics.fs : this.requestMetrics.exec;
+    }
+    /**
+     * Record a request that never entered the pending map.
+     * @param kind - the bucket.
+     */
+    noteRejected(kind) {
+        this.kindMetrics(kind).rejected += 1;
+    }
+    /**
+     * Record the dequeue ACK: the request's queue wait.
+     * @param pending - the request.
+     */
+    recordAck(pending) {
+        if (pending.ackedAt !== undefined)
+            return;
+        const now = performance.now();
+        pending.ackedAt = now;
+        const stats = this.kindMetrics(pending.kind);
+        const wait = now - pending.sentAt;
+        stats.queueMs += wait;
+        stats.queueMaxMs = Math.max(stats.queueMaxMs, wait);
+    }
+    /**
+     * Record a settle: the requests count, the execution time (or the queue wait
+     * for a request that never ACKed), and the outcome.
+     * @param pending - the request.
+     * @param error - the failure, when any.
+     */
+    recordSettle(pending, error) {
+        if (pending.measured)
+            return;
+        pending.measured = true;
+        const now = performance.now();
+        const stats = this.kindMetrics(pending.kind);
+        stats.requests += 1;
+        if (pending.ackedAt !== undefined) {
+            const exec = now - pending.ackedAt;
+            stats.execMs += exec;
+            stats.execMaxMs = Math.max(stats.execMaxMs, exec);
+        }
+        else {
+            const wait = now - pending.sentAt;
+            stats.queueMs += wait;
+            stats.queueMaxMs = Math.max(stats.queueMaxMs, wait);
+        }
+        if (pending.cancelled)
+            stats.cancelled += 1;
+        else if (error !== undefined)
+            stats.failed += 1;
+    }
     signalAgent(signal) {
         const pid = this.agentPid;
         if (pid === undefined || !this.signalable)

package/lib/index.js

@@ -246,7 +246,9 @@ export class WslShellExecutor extends LocalBashExecutor {
         this.resolvedShell = config.shell;
         this.resolvedHome = undefined;
         this.mode = config.sandbox ? ctx.sandboxPolicy.defaultMode : undefined;
-        this.sandbox = config.sandbox ? new WslSandbox({ wslPath: config.wslPath }) : undefined;
+        this.sandbox = config.sandbox
+            ? new WslSandbox({ wslPath: config.wslPath, maskWindowsDrive: config.maskWindowsDrive })
+            : undefined;
         this.processFacts = new Map();
         this.sessionRuntimes = sessionRuntimes;
         this.sessionRuntimeEntries = new Map();

package/lib/paths.d.ts

@@ -138,6 +138,21 @@ export declare function windowsToLinuxMount(winPath: string): string | undefined
  * @returns an absolute Linux path, or the input unchanged when it cannot be mapped.
  */
 export declare function toLinuxPath(value: string, options?: WorldPathOptions): string;
+/**
+ * Join a requested path onto a workspace root in the distro's Linux
+ * coordinate system: UNC absolutes map to their Linux paths, POSIX absolutes
+ * win over the root, and relative paths join onto it.
+ *
+ * This is the path half of the shipped `workspace-files` service's `ctx.fs`
+ * calls: the routed backend receives the same path/`cwd` pairs a host
+ * workspace would, so the stock service can serve a distro workspace without a
+ * second implementation.
+ *
+ * @param linuxRoot - the workspace root in Linux form.
+ * @param path - the requested path, in any coordinate system.
+ * @returns the absolute Linux path.
+ */
+export declare function linuxJoin(linuxRoot: string, path: string): string;
 /**
  * Resolve a caller-supplied path into the UNC coordinate system the host's fs
  * calls use. Linux paths from the model, UNC paths from the harness, and

package/lib/paths.js

@@ -238,6 +238,34 @@ export function toLinuxPath(value, options) {
     const baseLinux = toLinuxPath(base, { distro: options?.distro });
     return `${baseLinux.replace(/\/+$/, "")}/${text.replace(/^\.\//, "")}`;
 }
+/**
+ * Join a requested path onto a workspace root in the distro's Linux
+ * coordinate system: UNC absolutes map to their Linux paths, POSIX absolutes
+ * win over the root, and relative paths join onto it.
+ *
+ * This is the path half of the shipped `workspace-files` service's `ctx.fs`
+ * calls: the routed backend receives the same path/`cwd` pairs a host
+ * workspace would, so the stock service can serve a distro workspace without a
+ * second implementation.
+ *
+ * @param linuxRoot - the workspace root in Linux form.
+ * @param path - the requested path, in any coordinate system.
+ * @returns the absolute Linux path.
+ */
+export function linuxJoin(linuxRoot, path) {
+    // The UNC check runs on the RAW spelling: the backslash-to-slash rewrite
+    // below would leave `//wsl.localhost/...`, which the identity regex cannot
+    // see.
+    const parsed = uncToPosix(path);
+    if (parsed !== undefined)
+        return parsed.linuxPath.length > 0 ? parsed.linuxPath : "/";
+    const text = String(path).replaceAll("\\", "/");
+    if (text.startsWith("/"))
+        return text.length > 1 ? text.replace(/\/+$/, "") : "/";
+    const base = linuxRoot === "/" ? "" : linuxRoot;
+    const joined = text.length === 0 ? base : `${base}/${text}`.replace(/\/\.(?=\/|$)/gu, "");
+    return joined.length === 0 ? "/" : joined;
+}
 /**
  * Resolve a caller-supplied path into the UNC coordinate system the host's fs
  * calls use. Linux paths from the model, UNC paths from the harness, and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-wsl-env",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "\u8ba9 DeepSeek Harness \u4ee5 WSL \u5b50\u7cfb\u7edf\u4f5c\u4e3a\u4f1a\u8bdd\u7684\u6267\u884c\u73af\u5883\uff1ashell\u3001\u6587\u4ef6\u8bfb\u5199\u4e0e\u547d\u4ee4\u6267\u884c\u5747\u5728\u5b50\u7cfb\u7edf\u5185\u5b8c\u6210\uff0c\u76ee\u5f55\u9009\u62e9\u5668\u4e0e GUI \u7ec8\u7aef\u540c\u6837\u5b9a\u4f4d\u5230\u5b50\u7cfb\u7edf\u8def\u5f84\uff0c\u5e76\u901a\u8fc7\u5b50\u7cfb\u7edf\u5185\u7684 bubblewrap \u5bf9\u547d\u4ee4\u8fdb\u884c\u6c99\u7bb1\u9694\u79bb",
   "keywords": [
     "deepseek-harness",
@@ -75,10 +75,6 @@
     },
     "./subprocess/locale/en.json": "./locale/subprocess/en.json",
     "./subprocess/locale/zh.json": "./locale/subprocess/zh.json",
-    "./workspace-files-wsl": {
-      "types": "./lib/workspace-files-wsl.d.ts",
-      "default": "./lib/workspace-files-wsl.js"
-    },
     "./wsl": {
       "types": "./lib/wsl.d.ts",
       "default": "./lib/wsl.js"
@@ -106,6 +102,7 @@
     "docs/UPSTREAM-FSIO-EXPORT.md",
     "docs/UPSTREAM-TERMINAL-TITLE.md",
     "docs/ARCHITECTURE.md",
+    "docs/ROADMAP.md",
     "CHANGELOG.md",
     "CONTRIBUTING.md",
     "SECURITY.md",
@@ -119,9 +116,9 @@
     "lint:types": "tsc --noEmit",
     "build": "node scripts/build.mjs",
     "lint:build": "node test/build-freshness.mjs",
-    "test:coverage": "node --test --experimental-test-coverage --test-coverage-lines=85 --test-coverage-branches=84 --test-coverage-functions=70 test/agent-exec.test.mjs test/agent-fs-script.test.mjs test/agent-protocol.test.mjs test/agent.test.mjs test/fs-substrate.test.mjs test/fs.boot.test.mjs test/workspace-files-wsl.test.mjs test/composition.test.mjs test/provider.test.mjs test/file-reference-wsl.test.mjs test/fsio-agent.test.mjs test/fsio-text.test.mjs test/git-route.test.mjs test/listing.test.mjs test/paths.test.mjs test/ports.test.mjs test/preset-choice.test.mjs test/probe-cache.test.mjs test/preflight.test.mjs test/sandbox.test.mjs test/search-exec.test.mjs test/search-route.test.mjs test/shell.test.mjs test/terminal-activity.test.mjs test/terminal.test.mjs test/watcher.test.mjs test/wsl.test.mjs test/fs-decisions.test.mjs test/session-scope.test.mjs test/session-runtime.test.mjs test/native-agent.test.mjs test/peers.test.mjs",
+    "test:coverage": "node --test --experimental-test-coverage --test-coverage-lines=85 --test-coverage-branches=84 --test-coverage-functions=70 test/agent-exec.test.mjs test/agent-fs-script.test.mjs test/agent-protocol.test.mjs test/agent.test.mjs test/fs-substrate.test.mjs test/fs.boot.test.mjs test/composition.test.mjs test/provider.test.mjs test/file-reference-wsl.test.mjs test/fsio-agent.test.mjs test/fsio-text.test.mjs test/git-route.test.mjs test/listing.test.mjs test/paths.test.mjs test/ports.test.mjs test/preset-choice.test.mjs test/probe-cache.test.mjs test/preflight.test.mjs test/sandbox.test.mjs test/search-exec.test.mjs test/search-route.test.mjs test/shell.test.mjs test/terminal-activity.test.mjs test/terminal.test.mjs test/watcher.test.mjs test/wsl.test.mjs test/fs-decisions.test.mjs test/session-scope.test.mjs test/session-runtime.test.mjs test/native-agent.test.mjs test/peers.test.mjs test/agent-shared.test.mjs",
     "test:syntax": "node test/syntax.mjs",
-    "test:unit": "node --test test/fs.boot.test.mjs test/fsio-text.test.mjs test/workspace-files-wsl.test.mjs test/composition.test.mjs test/provider.test.mjs test/file-reference-wsl.test.mjs test/paths.test.mjs test/listing.test.mjs test/shell.test.mjs test/terminal.test.mjs test/probe-cache.test.mjs test/preflight.test.mjs test/preset-choice.test.mjs test/sandbox.test.mjs test/agent-protocol.test.mjs test/agent.test.mjs test/agent-fs-script.test.mjs test/fsio-agent.test.mjs test/fs-substrate.test.mjs test/agent-exec.test.mjs test/ports.test.mjs test/watcher.test.mjs test/wsl.test.mjs test/fs-decisions.test.mjs test/git-route.test.mjs test/fsio-text.test.mjs test/search-route.test.mjs test/search-exec.test.mjs test/terminal-activity.test.mjs test/session-scope.test.mjs test/session-runtime.test.mjs test/native-agent.test.mjs test/peers.test.mjs",
+    "test:unit": "node --test test/fs.boot.test.mjs test/fsio-text.test.mjs test/composition.test.mjs test/provider.test.mjs test/file-reference-wsl.test.mjs test/paths.test.mjs test/listing.test.mjs test/shell.test.mjs test/terminal.test.mjs test/probe-cache.test.mjs test/preflight.test.mjs test/preset-choice.test.mjs test/sandbox.test.mjs test/agent-protocol.test.mjs test/agent.test.mjs test/agent-fs-script.test.mjs test/fsio-agent.test.mjs test/fs-substrate.test.mjs test/agent-exec.test.mjs test/ports.test.mjs test/watcher.test.mjs test/wsl.test.mjs test/fs-decisions.test.mjs test/git-route.test.mjs test/fsio-text.test.mjs test/search-route.test.mjs test/search-exec.test.mjs test/terminal-activity.test.mjs test/session-scope.test.mjs test/session-runtime.test.mjs test/native-agent.test.mjs test/peers.test.mjs test/agent-shared.test.mjs",
     "lint:style": "node test/style.mjs",
     "prepublishOnly": "pnpm test",
     "probe": "bash test/probe/run.sh",
@@ -165,7 +162,6 @@
     "@deepseek-ai/cordis": "4.0.5",
     "@deepseek-ai/cordis-plugin-include": "*",
     "@deepseek-ai/cordis-plugin-loader": "*",
-    "@deepseek-ai/dsh-api-workspace-files": "0.2.1-rc.2",
     "@deepseek-ai/dsh-bash-local": "0.2.1-rc.2",
     "@deepseek-ai/dsh-fs": "0.2.1-rc.2",
     "@deepseek-ai/dsh-fs-local": "0.2.1-rc.2",
@@ -183,7 +179,6 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "~4.0.5",
-    "@deepseek-ai/dsh-api-workspace-files": "0.2.1-rc.2",
     "@deepseek-ai/dsh-bash-local": "0.2.1-rc.2",
     "@deepseek-ai/dsh-fs": "0.2.1-rc.2",
     "@deepseek-ai/dsh-fs-local": "0.2.1-rc.2",
@@ -198,9 +193,6 @@
     "@deepseek-ai/cordis": {
       "optional": true
     },
-    "@deepseek-ai/dsh-api-workspace-files": {
-      "optional": true
-    },
     "@deepseek-ai/dsh-bash-local": {
       "optional": true
     },

package/lib/workspace-files-route.d.ts

@@ -1,136 +0,0 @@
-/**
- * Pure builders and parsers for the distro-routed `workspace-files` service —
- * the GUI file tree and previews for a `\\wsl.localhost\<distro>` workspace,
- * served from inside the distro instead of Windows-side 9P walks.
- *
- * Peer-free by construction (no DSH imports): the service subclass imports
- * this alongside the shipped `dsh-api-workspace-files` base class, and the
- * unit tests import it standalone.
- *
- * This is a TypeScript source built to `lib/workspace-files-route.js`; edit
- * THIS file and run `pnpm run build` — the artifact under `lib/` is generated,
- * and `pnpm test` fails when it drifts.
- *
- * @module dsh-plugin-wsl/workspace-files-route
- */
-/**
- * Translate one path-shaped value into distro coordinates: UNC identities map
- * onto their Linux paths, drive-letter paths onto their `/mnt/<drive>` mounts,
- * everything else passes through verbatim.
- *
- * @param value - the value to translate.
- * @returns the distro-side spelling.
- */
-export declare function distroPath(value: string): string;
-/**
- * Whether a workspace root belongs to a distro (and therefore routes
- * distro-side).
- *
- * @param workspaceRoot - the scope's workspace root, any coordinate system.
- * @returns true for a `\\wsl.localhost\<distro>` UNC root.
- */
-export declare function isDistroWorkspace(workspaceRoot: string): boolean;
-/**
- * The Linux working path for one request: UNC absolutes map onto their Linux
- * paths, POSIX absolutes and relative paths join onto the root.
- *
- * @param linuxRoot - the workspace root in Linux form.
- * @param path - the requested path, any coordinate system.
- * @returns the absolute Linux path.
- */
-export declare function linuxJoin(linuxRoot: string, path: string): string;
-/**
- * The record invocation for one path: line 1 is the no-follow kind (the
- * upstream lstat gate), line 2 the follow-stat fields (the upstream final
- * stat), tab-joined. The path is resolved and contained first — the GUI's
- * workspace is a boundary for every read, not just for listings.
- *
- * @param file - absolute Linux path.
- * @param root - the workspace root in Linux form (containment boundary).
- * @returns the agent argv.
- */
-export declare function statRecordArgv(file: string, root: string): string[];
-/**
- * Parse one stat record (kind + follow fields, tab-joined).
- *
- * @param line - the record line.
- * @returns the upstream kind spelling, the byte size, and the synthesized
- *   opaque version.
- */
-export declare function parseStatRecord(line: string | Buffer): {
-    kind: string;
-    type: string;
-    size: number;
-    version: string;
-};
-/**
- * Map a `stat` kind onto the wire's kind token.
- *
- * @param kind - the `stat -c %F` spelling.
- * @returns the wire kind token.
- */
-export declare function wireKind(kind: string): string;
-/**
- * The read invocation for one line-paged text read: the stat record rides
- * stderr (the caller builds the stat half of the response), the page rides
- * stdout — one line beyond the page, so EOF is decidable from the yield.
- * `$1` is the file, `$2` the 1-based first line, `$3` the line count.
- *
- * @param file - absolute Linux path.
- * @param offset - first line to return (1-based).
- * @param limit - maximum lines to return.
- * @param root - the workspace root in Linux form (containment boundary).
- * @returns the agent argv.
- */
-export declare function pageArgv(file: string, offset: number, limit: number, root: string): string[];
-/**
- * The byte-window invocation: the stat record rides stderr, the window rides
- * stdout. `$1` is the file, `$2` the byte offset, `$3` the byte count.
- *
- * @param file - absolute Linux path.
- * @param offset - byte offset (0-based).
- * @param length - byte count.
- * @param root - the workspace root in Linux form (containment boundary).
- * @returns the agent argv.
- */
-export declare function bytesArgv(file: string, offset: number, length: number, root: string): string[];
-/**
- * Parse the stat record a read or byte-window relayed on stderr.
- *
- * @param stderr - the relay's raw stderr.
- * @returns the parsed stat record, or undefined when stderr carries none.
- */
-export declare function parseStatRecordFromStderr(stderr: string | Buffer): {
-    kind: string;
-    type: string;
-    size: number;
-    version: string;
-} | undefined;
-/**
- * The listing invocation for one directory: resolve the final component
- * through symlinks, refuse paths outside the root and non-directories, then
- * list one more entry than the cap so truncation is decidable from the yield.
- * `-L` matches the upstream child semantics (a symlink to a directory lists
- * as a directory, a broken link drops out); `-p` marks directories with the
- * trailing `/` the parser keys on.
- *
- * @param linuxRoot - the workspace root in Linux form (containment boundary).
- * @param linuxDir - the directory to list.
- * @param maxEntries - the caller's entry cap.
- * @returns the agent argv.
- */
-export declare function listDistroArgv(linuxRoot: string, linuxDir: string, maxEntries: number): string[];
-/**
- * Parse one capped `ls -1ALp` listing into wire entries.
- *
- * @param stdout - the listing's raw stdout.
- * @param maxEntries - the entry cap the caller configured.
- * @returns at most `maxEntries` entries and whether the level had more.
- */
-export declare function parseDirListing(stdout: string | Buffer, maxEntries: number): {
-    entries: Array<{
-        name: string;
-        type: "file" | "directory";
-    }>;
-    truncated: boolean;
-};