@yadsh/dsh-session-scope 0.5.0 → 0.6.0

package/LICENSE

@@ -1,22 +1,22 @@
-MIT License
-
+MIT License
+
 Copyright (c) 2026 jiangr100
 Copyright (c) 2026 xarleyn
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -48,11 +48,11 @@ Version `0.5.0` implements the specification through Phase 4:
 
 - durable `session-scope/set` snapshots with a last-write-wins fold;
 - canonical root validation, nested-root collapse, navigation ancestors, and stable error codes;
-- typed host operations, the `/scope` command, and a `session-scope` projection;
+- projection-backed scope state and capabilities, a dedicated `sessionScope/list` RPC, and a write-only `/scope` command;
 - filtered directory listings and scoped glob, grep, and search roots;
 - per-session filesystem enforcement carried with `AsyncLocalStorage`;
 - a monotonic final guard for known path-aware tools;
-- model-facing context that names accessible roots without revealing hidden siblings;
+- model-facing context that names accessible roots without revealing hidden siblings; `full` emits no scope prompt and bypasses the filesystem carrier;
 - an independent **Scope** chip and tree picker beside Workspace and permission controls;
 - Linux isolation for one-shot bash and persistent PTY creation;
 - permission-aware read-only and writable mounts in an empty workspace overlay;
@@ -70,6 +70,7 @@ Version `0.5.0` implements the specification through Phase 4:
 - Isolated scope requires the supported Linux sandbox path and a recognized bubblewrap profile.
 - Unknown runner profiles, partial enforcement, and unsupported platforms fail closed.
 - Scope changes are blocked while foreground jobs, background jobs, or persistent terminals retain the previous mount view.
+- Opening or refreshing the Scope editor is read-only: it uses projections and `sessionScope/list`, so it does not add command rows to session history. Applying an unchanged scope is a no-op.
 
 ## Requirements
 

package/compatibility.json

@@ -13,6 +13,7 @@
     ],
     "requiredClientFeatures": [
       "conversation.input.left",
+      "remote.$mount",
       "remote.commands",
       "session-projections"
     ]

package/cordis.patch.yml

@@ -1,7 +1,7 @@
-# dsh-session-scope bundle patch — mounts the plugin row into the
-# profile composition. The `dsh.bundle.patch` manifest field points here, so
-# `dsh plugin --profile web add <this directory>` activates this row
-# automatically on the next boot.
-- insert:
-    - id: dsh-session-scope
-      name: "@yadsh/dsh-session-scope"
+# dsh-session-scope bundle patch — mounts the plugin row into the
+# profile composition. The `dsh.bundle.patch` manifest field points here, so
+# `dsh plugin --profile web add <this directory>` activates this row
+# automatically on the next boot.
+- insert:
+    - id: dsh-session-scope
+      name: "@yadsh/dsh-session-scope"

package/lib/client.js

@@ -6,16 +6,16 @@
 // with the web shell's module loader (window.__ModuleLoader__) and exports a
 // Cordis client plugin. It requires only `react` and `react-dom` (both are
 // shell statics); everything else comes from client services (`slots`,
-// `connection`, `remote`, `sessions`).
+// `remote`, `sessions`).
 //
 // It contributes an independent Scope chip beside the Workspace picker while
 // a session is blank and beside the permission selector after the first turn.
-// The editor consumes the `session-scope` projection and writes
-// complete snapshots through `/scope`; permission and scope never share UI
-// state.
-// - The editor walks the directory tree (breadcrumbs up to the filesystem
-//   root) and toggles which directories the agent may write to, in addition
-//   to the session workspace. Changes go through the host's
+// The editor consumes state and host capabilities from the `session-scope`
+// projection and writes complete snapshots through `/scope`; permission and
+// scope never share UI state.
+// - The editor walks the directory tree beneath the session workspace and
+//   toggles which directories the agent may write to, in addition to the
+//   session workspace. Changes go through the host's
 //   `/scope` command; the `session-scope` session projection
 //   pushes the state back, so the button and the tree stay in sync with the
 //   server.
@@ -24,12 +24,10 @@
 // z-index, because the composer seat is `position: sticky` inside its own
 // stacking context — an in-place fixed overlay would be clipped or buried.
 //
-// Directory listings come from the host's `host.listDirectory` RPC (the
-// browse capability) when the composition serves it; when the composition
-// serves the native picker instead, the tree falls back to the plugin's own
-// `/scope list` host command.
+// Directory listings come from the plugin's dedicated `sessionScope/list`
+// RPC. Read-only UI refreshes never execute durable slash commands.
 window.__ModuleLoader__.load({
-    id: 'dsh-session-scope',
+    id: '@yadsh/dsh-session-scope',
     factory: (require) => {
         var module = { exports: {} };
         var exports = module.exports;
@@ -60,6 +58,7 @@ window.__ModuleLoader__.load({
             '.wss-mode { border: 1px solid var(--dsw-alias-border-l2); border-radius: 8px; background: transparent; color: var(--dsw-alias-label-secondary); padding: 7px 8px; font: inherit; font-size: 12px; cursor: pointer; }',
             '.wss-mode:hover:not(:disabled) { background: var(--dsw-alias-interactive-bg-hover); }',
             '.wss-modeOn { border-color: var(--dsw-alias-state-business-primary); color: var(--dsw-alias-label-primary); background: var(--dsw-alias-fill-tsp-secondary); }',
+            '.wss-modeUnavailable { opacity: .55; }',
             '.wss-crumbs { display: flex; align-items: center; gap: 2px; flex-wrap: wrap; font-size: 12px; line-height: 18px; }',
             '.wss-crumb { border: none; background: transparent; color: var(--dsw-alias-label-secondary); cursor: pointer; padding: 1px 4px; border-radius: 6px; font: inherit; }',
             '.wss-crumb:hover { background: var(--dsw-alias-interactive-bg-hover); color: var(--dsw-alias-label-primary); }',
@@ -106,13 +105,18 @@ window.__ModuleLoader__.load({
         function sepOf(path) {
             return path.indexOf('\\') !== -1 ? '\\' : '/';
         }
+        function comparablePath(path) {
+            return sepOf(path) === '\\' ? path.toLowerCase() : path;
+        }
         // Whether `path` is `root` or lies beneath it (separator-aware prefix).
         function isUnder(path, root) {
-            if (path === root)
+            var comparableTarget = comparablePath(path);
+            var comparableRoot = comparablePath(root);
+            if (comparableTarget === comparableRoot)
                 return true;
             var sep = sepOf(root);
-            var prefix = root.endsWith(sep) ? root : root + sep;
-            return path.indexOf(prefix) === 0;
+            var prefix = comparableRoot.endsWith(sep) ? comparableRoot : comparableRoot + sep;
+            return comparableTarget.indexOf(prefix) === 0;
         }
         // The deepest selected root that covers `path`, or undefined.
         function coveringRoot(path, roots) {
@@ -129,9 +133,89 @@ window.__ModuleLoader__.load({
             var parts = path.split(sep).filter(Boolean);
             return parts.length === 0 ? path : parts[parts.length - 1];
         }
+        // Render paths relative to the session workspace. Absolute paths remain
+        // host-side implementation details and never need to appear in the picker.
+        function displayPath(path, root) {
+            if (typeof path !== 'string' || typeof root !== 'string' || !isUnder(path, root))
+                return baseName(path);
+            if (comparablePath(path) === comparablePath(root))
+                return '.';
+            var relative = path.slice(root.length);
+            var sep = sepOf(root);
+            while (relative.startsWith(sep))
+                relative = relative.slice(1);
+            return relative.split(sep).join('/');
+        }
         function normalizeDraftRoots(roots) {
             return Array.isArray(roots) ? roots.filter(function (root) { return typeof root === 'string'; }) : [];
         }
+        function comparableScopeRoots(roots) {
+            var ordered = normalizeDraftRoots(roots).slice().sort(function (left, right) {
+                return left.length - right.length || comparablePath(left).localeCompare(comparablePath(right));
+            });
+            var collapsed = [];
+            for (var i = 0; i < ordered.length; i++) {
+                if (!collapsed.some(function (root) { return isUnder(ordered[i], root); }))
+                    collapsed.push(ordered[i]);
+            }
+            return collapsed.sort(function (left, right) { return comparablePath(left).localeCompare(comparablePath(right)); });
+        }
+        function sameRoots(left, right) {
+            var a = comparableScopeRoots(left);
+            var b = comparableScopeRoots(right);
+            return a.length === b.length && a.every(function (root, index) {
+                return comparablePath(root) === comparablePath(b[index]);
+            });
+        }
+        var stringSchema = {
+            parse: function (value) {
+                if (typeof value !== 'string' || value.length === 0)
+                    throw new TypeError('expected a non-empty string');
+                return value;
+            },
+        };
+        var directoryListingSchema = {
+            parse: function (value) {
+                if (value === null || typeof value !== 'object')
+                    throw new TypeError('expected a directory listing');
+                if (typeof value.path !== 'string' || typeof value.home !== 'string')
+                    throw new TypeError('invalid directory listing roots');
+                if (!Array.isArray(value.crumbs) || !Array.isArray(value.entries))
+                    throw new TypeError('invalid directory listing rows');
+                return {
+                    path: value.path,
+                    home: value.home,
+                    crumbs: value.crumbs.map(function (crumb) {
+                        if (crumb === null || typeof crumb !== 'object' || typeof crumb.name !== 'string' || typeof crumb.path !== 'string') {
+                            throw new TypeError('invalid directory crumb');
+                        }
+                        return { name: crumb.name, path: crumb.path };
+                    }),
+                    entries: value.entries.map(function (entry) {
+                        if (entry === null || typeof entry !== 'object' || typeof entry.name !== 'string' || typeof entry.path !== 'string') {
+                            throw new TypeError('invalid directory entry');
+                        }
+                        return { name: entry.name, path: entry.path, hidden: entry.hidden === true };
+                    }),
+                    truncated: value.truncated === true,
+                };
+            },
+        };
+        var scopeRemoteContribution = {
+            package: '@yadsh/dsh-session-scope',
+            descriptors: [{
+                    id: '@yadsh/dsh-session-scope#sessionScope/list',
+                    service: 'sessionScopeRead',
+                    namespace: 'sessionScope',
+                    method: 'list',
+                    invocation: { kind: 'direct' },
+                    parameters: [
+                        { name: 'sessionId', wire: 'sessionId', source: 'json', codec: { mode: 'strict', typeSymbol: 'SessionId', schema: stringSchema } },
+                        { name: 'path', wire: 'path', source: 'json', codec: { mode: 'strict', typeSymbol: 'string', schema: stringSchema } },
+                    ],
+                    result: { mode: 'strict', typeSymbol: 'DirectoryListing', schema: directoryListingSchema },
+                }],
+        };
         function apply(ctx) {
             var styleTag = null;
             try {
@@ -140,18 +224,29 @@ window.__ModuleLoader__.load({
                 document.head.appendChild(styleTag);
             }
             catch (err) { /* styling is cosmetic */ }
-            function connection() {
-                var value = ctx.get('connection');
-                return value !== undefined && value !== null ? value : undefined;
-            }
             function remote() {
                 var value = ctx.get('remote');
                 return value !== undefined && value !== null ? value : undefined;
             }
-            function api() {
-                var conn = connection();
-                return conn !== undefined && conn.api !== undefined ? conn.api : undefined;
-            }
+            var scopeRemoteDispose = null;
+            var scopeRemoteError = null;
+            var scopeRemoteFace = null;
+            var rem = remote();
+            var scopeRemoteReady = rem !== undefined && typeof rem.$mount === 'function'
+                ? rem.$mount(scopeRemoteContribution).then(function (dispose) {
+                    scopeRemoteDispose = dispose;
+                    if (typeof ctx.inject !== 'function')
+                        throw new Error('session-scope: client injection unavailable');
+                    return ctx.inject(['remote.sessionScope'], function (remoteCtx) {
+                        var injectedRemote = remoteCtx.get('remote');
+                        scopeRemoteFace = injectedRemote.sessionScope;
+                    });
+                }).catch(function (err) {
+                    scopeRemoteError = err instanceof Error ? err.message : String(err);
+                })
+                : Promise.resolve().then(function () {
+                    scopeRemoteError = 'session-scope: Remote gateway unavailable';
+                });
             // Execute one slash-command and return { ok, result } where result is
             // the normalized { kind, text } command result when the host answered.
             async function runCommand(sessionId, line) {
@@ -179,49 +274,35 @@ window.__ModuleLoader__.load({
                     return { ok: false, error: err instanceof Error ? err.message : String(err) };
                 }
             }
-            // List one directory level. Primary: host.listDirectory (browse
-            // capability). Fallback: the plugin's own /scope list
-            // command, used when the composition serves the native picker.
+            // List one directory level through the dedicated host RPC.
             async function listLevel(sessionId, path) {
-                var face = api();
-                if (face !== undefined && face.host !== undefined && typeof face.host.listDirectory === 'function') {
-                    try {
-                        var response = await face.host.listDirectory({ path: path });
-                        if (response !== undefined && response.result !== undefined && response.result.ok === true) {
-                            return { ok: true, value: response.result.value, source: 'browse' };
-                        }
-                        if (response !== undefined && response.result !== undefined && response.result.error !== undefined) {
-                            var code = response.result.error.code;
-                            if (code === 'directory-picker-unavailable') {
-                                return fallbackList(sessionId, path);
-                            }
-                            return { ok: false, error: response.result.error.message };
-                        }
-                    }
-                    catch (err) {
-                        return { ok: false, error: err instanceof Error ? err.message : String(err) };
-                    }
+                await scopeRemoteReady;
+                if (scopeRemoteError !== null)
+                    return { ok: false, error: scopeRemoteError };
+                if (scopeRemoteFace === null || typeof scopeRemoteFace.list !== 'function') {
+                    return { ok: false, error: 'session-scope: read RPC unavailable' };
                 }
-                return fallbackList(sessionId, path);
-            }
-            async function fallbackList(sessionId, path) {
-                var outcome = await runCommand(sessionId, '/scope list ' + path);
-                if (!outcome.ok)
-                    return { ok: false, error: outcome.error };
                 try {
-                    return { ok: true, value: JSON.parse(outcome.result.text), source: 'command' };
+                    var response = await scopeRemoteFace.list(sessionId, path);
+                    if (response !== undefined && response.ok === true) {
+                        return { ok: true, value: response.value, source: 'scope-rpc' };
+                    }
+                    var message = response !== undefined && response.error !== undefined && response.error.message !== undefined
+                        ? response.error.message
+                        : 'session-scope: directory listing failed';
+                    return { ok: false, error: message };
                 }
                 catch (err) {
-                    return { ok: false, error: 'session-scope: host returned an invalid listing' };
+                    return { ok: false, error: err instanceof Error ? err.message : String(err) };
                 }
             }
             // ---------- the scope editor (modal with the directory tree) ----------
             function ScopeEditor(props) {
                 // props: sessionId, workspaceRoot (injected cwd, may be undefined),
-                // projectedRoot, scopeMode, scopeRoots, onClose
+                // projectedRoot, scopeMode, scopeRoots, capabilities, onClose
                 var state = React.useState({
                     root: null,
-                    rootSource: null, // 'injected' | 'projection' | 'info'
+                    rootSource: null, // 'injected' | 'projection'
                     path: null,
                     listing: null, // { path, crumbs, entries, truncated }
                     loading: false,
@@ -229,7 +310,7 @@ window.__ModuleLoader__.load({
                     error: null,
                     phase: L('正在解析工作区…', 'Resolving workspace…'),
                     retryToken: 0,
-                    isolatedSupported: null,
+                    isolatedSupported: props.capabilities !== undefined ? props.capabilities.isolated === true : null,
                     mode: props.scopeMode === 'focused' || props.scopeMode === 'isolated' ? props.scopeMode : 'full',
                     // Local pending content roots. In full mode the workspace root is
                     // inserted after root resolution to keep the checkbox semantics.
@@ -238,27 +319,15 @@ window.__ModuleLoader__.load({
                 var snap = state[0];
                 var setSnap = state[1];
                 var patch = function (part) { setSnap(function (prev) { return Object.assign({}, prev, part); }); };
-                React.useEffect(function () {
-                    var cancelled = false;
-                    runCommand(props.sessionId, '/scope capabilities').then(function (outcome) {
-                        if (cancelled || !outcome.ok)
-                            return;
-                        try {
-                            var capabilities = JSON.parse(outcome.result.text);
-                            patch({ isolatedSupported: capabilities.isolated === true });
-                        }
-                        catch (err) { /* keep unknown capability state */ }
-                    });
-                    return function () { cancelled = true; };
-                }, [props.sessionId]);
-                // Resolve the workspace root through a chain of sources: the injected
-                // session cwd, the session-scope projection root, then `/scope show`.
+                // Resolve the immutable workspace root from the session list or the
+                // session-scope projection. No read command is issued from the UI.
                 function applyRoot(root, source, mode, roots) {
                     var nextMode = mode === 'focused' || mode === 'isolated' ? mode : 'full';
                     patch({
                         root: root,
                         rootSource: source,
                         phase: L('正在加载目录…', 'Loading directories…'),
+                        error: null,
                         mode: nextMode,
                         draft: nextMode === 'full' ? [root] : normalizeDraftRoots(roots),
                     });
@@ -280,34 +349,7 @@ window.__ModuleLoader__.load({
                                 applyRoot(projected, 'projection', snap.mode, snap.draft);
                                 return;
                             }
-                            patch({ phase: L('正在解析工作区…', 'Resolving workspace…') });
-                            timer = setTimeout(function () {
-                                if (cancelled || snap.root !== null)
-                                    return;
-                                patch({ loading: false, error: L('解析工作区超时 — 请重试', 'resolving the workspace timed out — please retry'), phase: null });
-                            }, 12000);
-                            var outcome = await runCommand(props.sessionId, '/scope show');
-                            if (cancelled)
-                                return;
-                            if (timer !== null) {
-                                clearTimeout(timer);
-                                timer = null;
-                            }
-                            if (!outcome.ok) {
-                                patch({ loading: false, error: outcome.error, phase: null });
-                                return;
-                            }
-                            var info = null;
-                            try {
-                                info = JSON.parse(outcome.result.text);
-                            }
-                            catch (err) { /* invalid */ }
-                            var root = info !== null && typeof info.workspaceRoot === 'string' && info.workspaceRoot !== '' ? info.workspaceRoot : null;
-                            if (root === null) {
-                                patch({ loading: false, error: L('无法解析工作区根目录', 'could not resolve the workspace root'), phase: null });
-                                return;
-                            }
-                            applyRoot(root, 'info', info.mode, info.roots);
+                            patch({ loading: false, error: L('无法解析工作区根目录', 'could not resolve the workspace root'), phase: null });
                         }
                         catch (err) {
                             if (cancelled)
@@ -399,6 +441,13 @@ window.__ModuleLoader__.load({
                 // and a rejection handler both settle the flag and surface a visible
                 // error, keeping the modal open with the draft intact.
                 function save(mode, draft) {
+                    var effectiveMode = snap.root !== null && draft.indexOf(snap.root) !== -1 ? 'full' : mode;
+                    var effectiveRoots = effectiveMode === 'full' ? [] : normalizeDraftRoots(draft);
+                    var currentRoots = normalizeDraftRoots(props.scopeRoots);
+                    if (effectiveMode === props.scopeMode && sameRoots(effectiveRoots, currentRoots)) {
+                        props.onClose();
+                        return;
+                    }
                     patch({ saving: true, error: null });
                     var settled = false;
                     var timer = setTimeout(function () {
@@ -407,7 +456,6 @@ window.__ModuleLoader__.load({
                         settled = true;
                         patch({ saving: false, error: L('保存超时 — 请重试', 'saving timed out — please retry') });
                     }, 12000);
-                    var effectiveMode = snap.root !== null && draft.indexOf(snap.root) !== -1 ? 'full' : mode;
                     var command = effectiveMode === 'full'
                         ? '/scope full'
                         : '/scope ' + effectiveMode + ' ' + JSON.stringify(draft);
@@ -458,8 +506,12 @@ window.__ModuleLoader__.load({
                     patch({ draft: next, error: null });
                 }
                 function selectMode(mode) {
-                    if (mode === 'isolated' && snap.isolatedSupported === false)
+                    if (mode === 'isolated' && snap.isolatedSupported === false) {
+                        patch({
+                            error: L('隔离模式需要支持 bubblewrap 的 Linux 主机。此主机仍可使用聚焦模式。', 'Isolated mode requires a Linux host with supported bubblewrap. Focused mode remains available on this host.'),
+                        });
                         return;
+                    }
                     if (mode === 'full') {
                         patch({ mode: 'full', draft: snap.root === null ? [] : [snap.root], error: null });
                         return;
@@ -495,6 +547,7 @@ window.__ModuleLoader__.load({
                 var listing = snap.listing;
                 var crumbs = listing !== null ? listing.crumbs : [];
                 var entries = listing !== null ? listing.entries : [];
+                var visibleCrumbs = snap.root === null ? [] : crumbs.filter(function (crumb) { return isUnder(crumb.path, snap.root); });
                 var overlay = React.createElement('div', { className: 'wss-overlay' }, React.createElement('div', { className: 'wss-modal', ref: modalRef, role: 'dialog', 'aria-label': L('会话范围', 'Session scope') }, React.createElement('div', { className: 'wss-head' }, React.createElement('span', { className: 'wss-title' }, L('会话范围', 'Session Scope')), React.createElement('button', { type: 'button', className: 'wss-close', onClick: props.onClose, 'aria-label': L('关闭', 'Close') }, IconClose())), React.createElement('div', { className: 'wss-caption' }, L('范围控制 agent 可以看到的工作区部分，与读写权限无关。Focused 限制 DSH 文件工具；Isolated 还限制受支持的 shell 进程。', 'Scope controls which workspace areas the agent can see, independently from read/write permission. Focused restricts DSH filesystem tools; Isolated also confines supported shell processes.')), React.createElement('div', { className: 'wss-modes', role: 'radiogroup', 'aria-label': L('范围模式', 'Scope mode') }, [
                     { value: 'full', label: L('整个工作区', 'Entire workspace') },
                     { value: 'focused', label: L('聚焦', 'Focused') },
@@ -506,9 +559,10 @@ window.__ModuleLoader__.load({
                         type: 'button',
                         role: 'radio',
                         'aria-checked': snap.mode === option.value,
-                        className: 'wss-mode' + (snap.mode === option.value ? ' wss-modeOn' : ''),
-                        disabled: snap.saving || unavailable,
-                        title: unavailable ? L('此主机不支持隔离模式', 'Isolated mode is unavailable on this host') : option.label,
+                        className: 'wss-mode' + (snap.mode === option.value ? ' wss-modeOn' : '') + (unavailable ? ' wss-modeUnavailable' : ''),
+                        disabled: snap.saving,
+                        'aria-disabled': unavailable,
+                        title: unavailable ? L('需要支持 bubblewrap 的 Linux 主机', 'Requires a Linux host with supported bubblewrap') : option.label,
                         onClick: function () { selectMode(option.value); },
                     }, option.label);
                 })), snap.phase !== null && React.createElement('div', { className: 'wss-busy' }, snap.phase), snap.error !== null && React.createElement('div', { className: 'wss-error' }, snap.error, React.createElement('button', {
@@ -516,30 +570,30 @@ window.__ModuleLoader__.load({
                     className: 'wss-btn wss-btnGhost',
                     onClick: retry,
                     style: { marginLeft: 8 },
-                }, L('重试', 'Retry'))), snap.root !== null && React.createElement('div', { className: 'wss-crumbs' }, crumbs.map(function (crumb, index) {
+                }, L('重试', 'Retry'))), snap.root !== null && React.createElement('div', { className: 'wss-crumbs' }, visibleCrumbs.map(function (crumb, index) {
                     return React.createElement(React.Fragment, { key: crumb.path }, index > 0 && React.createElement('span', { className: 'wss-crumbSep' }, '/'), React.createElement('button', {
                         type: 'button',
                         className: 'wss-crumb',
-                        title: crumb.path,
+                        title: displayPath(crumb.path, snap.root),
                         onClick: function () {
                             if (crumb.path !== snap.path)
                                 enter(crumb.path);
                         },
-                    }, crumb.name));
+                    }, index === 0 ? '.' : crumb.name));
                 })), React.createElement('div', { className: 'wss-tree' }, snap.loading && React.createElement('div', { className: 'wss-busy' }, L('加载中…', 'Loading…')), !snap.loading && snap.path !== null && React.createElement('div', { className: 'wss-row' }, React.createElement('button', {
                     type: 'button',
                     className: 'wss-check' + (coveringRoot(snap.path, snap.draft) !== undefined ? ' wss-checkOn' : ''),
                     disabled: snap.saving || (coveringRoot(snap.path, snap.draft) !== undefined && snap.draft.indexOf(snap.path) === -1),
-                    'aria-label': L('切换目录', 'Toggle directory') + ' ' + snap.path,
+                    'aria-label': L('切换目录', 'Toggle directory') + ' ' + displayPath(snap.path, snap.root),
                     title: coveringRoot(snap.path, snap.draft) !== undefined && snap.draft.indexOf(snap.path) === -1
                         ? L('经父目录包含：取消父目录后整个子树将不可见', 'Included via a parent directory; uncheck the parent to hide its whole subtree')
                         : snap.path === snap.root
                             ? (snap.draft.indexOf(snap.path) !== -1
                                 ? L('整个工作区可见 — 取消勾选后选择聚焦范围', 'The entire workspace is visible — uncheck to choose a focused scope')
                                 : L('勾选以显示整个工作区', 'Check to expose the entire workspace'))
-                            : snap.path,
+                            : displayPath(snap.path, snap.root),
                     onClick: function (ev) { ev.stopPropagation(); toggle(snap.path); },
-                }, coveringRoot(snap.path, snap.draft) !== undefined ? IconCheck() : null), React.createElement('span', { className: 'wss-rowName' }, IconFolder(), React.createElement('span', { style: { minWidth: 0, overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' } }, snap.path)), coveringRoot(snap.path, snap.draft) !== undefined && snap.draft.indexOf(snap.path) === -1 &&
+                }, coveringRoot(snap.path, snap.draft) !== undefined ? IconCheck() : null), React.createElement('span', { className: 'wss-rowName' }, IconFolder(), React.createElement('span', { style: { minWidth: 0, overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' } }, displayPath(snap.path, snap.root))), coveringRoot(snap.path, snap.draft) !== undefined && snap.draft.indexOf(snap.path) === -1 &&
                     React.createElement('span', { className: 'wss-hint' }, L('经父目录包含', 'via parent')), snap.path === snap.root && coveringRoot(snap.path, snap.draft) === undefined &&
                     React.createElement('span', { className: 'wss-hint' }, L('聚焦范围', 'focused scope'))), !snap.loading && snap.path !== null && entries.map(function (entry) {
                     var covered = coveringRoot(entry.path, snap.draft);
@@ -553,12 +607,12 @@ window.__ModuleLoader__.load({
                         type: 'button',
                         className: 'wss-check' + (on ? ' wss-checkOn' : ''),
                         disabled: snap.saving || (on && !self),
-                        'aria-label': L('切换目录', 'Toggle directory') + ' ' + entry.path,
-                        title: on && !self ? L('经父目录包含：取消父目录后整个子树将不可见', 'Included via a parent directory; uncheck the parent to hide its whole subtree') : entry.path,
+                        'aria-label': L('切换目录', 'Toggle directory') + ' ' + displayPath(entry.path, snap.root),
+                        title: on && !self ? L('经父目录包含：取消父目录后整个子树将不可见', 'Included via a parent directory; uncheck the parent to hide its whole subtree') : displayPath(entry.path, snap.root),
                         onClick: function (ev) { ev.stopPropagation(); toggle(entry.path); },
                     }, on ? IconCheck() : null), React.createElement('span', { className: 'wss-rowName' + (entry.hidden ? ' wss-rowNameDim' : '') }, IconFolder(), React.createElement('span', { style: { minWidth: 0, overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' } }, entry.name)), on && !self && React.createElement('span', { className: 'wss-hint' }, L('经父目录', 'via parent')), React.createElement('span', { className: 'wss-chevron' }, IconChevron()));
                 }), !snap.loading && snap.path !== null && entries.length === 0 &&
-                    React.createElement('div', { className: 'wss-empty' }, L('（无子目录）', '(no subdirectories)'))), React.createElement('div', { className: 'wss-foot' }, React.createElement('span', { className: 'wss-footRoots', title: snap.draft.join('\n') }, (snap.mode === 'full'
+                    React.createElement('div', { className: 'wss-empty' }, L('（无子目录）', '(no subdirectories)'))), React.createElement('div', { className: 'wss-foot' }, React.createElement('span', { className: 'wss-footRoots', title: snap.draft.map(function (root) { return displayPath(root, snap.root); }).join('\n') }, (snap.mode === 'full'
                     ? L('整个工作区 · ', 'entire workspace · ')
                     : (snap.mode === 'isolated' ? L('隔离 · ', 'isolated · ') : L('聚焦 · ', 'focused · '))) +
                     (snap.draft.length === 0
@@ -630,6 +684,7 @@ window.__ModuleLoader__.load({
                 var roots = scope !== undefined && Array.isArray(scope.roots) ? scope.roots : [];
                 var projectedRoot = scope !== undefined && typeof scope.workspaceRoot === 'string' && scope.workspaceRoot !== '' ? scope.workspaceRoot : undefined;
                 var mode = scope !== undefined && (scope.mode === 'focused' || scope.mode === 'isolated') ? scope.mode : 'full';
+                var capabilities = scope !== undefined && scope.capabilities !== undefined ? scope.capabilities : undefined;
                 var label = mode === 'full'
                     ? L('范围：全部', 'Scope: All')
                     : roots.length === 0
@@ -658,6 +713,7 @@ window.__ModuleLoader__.load({
                     projectedRoot: projectedRoot,
                     scopeMode: mode,
                     scopeRoots: roots,
+                    capabilities: capabilities,
                     onClose: function () { setOpen(false); },
                 }));
             }
@@ -668,8 +724,7 @@ window.__ModuleLoader__.load({
                 function scopeInjection(sessionId) {
                     // The session's workspace root never changes; the sessions list
                     // store (byId, keyed by session id) is the cheapest reliable
-                    // source. The editor falls back to the projection root and then to
-                    // /scope show.
+                    // source. The editor falls back to the session-scope projection.
                     var root = undefined;
                     try {
                         var sessions = ctx.get('sessions');
@@ -704,12 +759,18 @@ window.__ModuleLoader__.load({
                     }
                     catch (err) { /* best effort */ }
                 }
+                if (scopeRemoteDispose !== null) {
+                    try {
+                        void scopeRemoteDispose();
+                    }
+                    catch (err) { /* best effort */ }
+                }
                 if (styleTag !== null && styleTag.parentNode !== null)
                     styleTag.parentNode.removeChild(styleTag);
             };
         }
         exports.apply = apply;
-        exports.inject = ['slots', 'connection', 'remote', 'remote.commands', 'sessions'];
+        exports.inject = ['slots', 'remote', 'remote.commands', 'sessions'];
         return module.exports;
     },
 });