@dsh-electron/dsh-plugin-multi-root-workspace 0.1.9 → 0.1.10

package/lib/types/client/WorkspaceFoldersAction.d.ts

@@ -2,7 +2,7 @@
  * The Workspace Folders panel: one sidebar footer action that opens a dialog
  * listing this session's workspace root and the additional roots registered for
  * it, with the actions the milestone requires — Add (through the composed
- * directory picker), Remove, Alias, Copy Path, Reveal, and reordering.
+ * directory picker), Remove, Alias, Copy Path, and Reveal.
  *
  * Why a footer action and its own dialog, instead of a first-class panel: the
  * slots that can host a full panel (`sidebar.panellist` + the keyed `main`

package/lib/types/client/locales.d.ts

@@ -12,13 +12,20 @@
 export declare const NS = "multiRootWorkspace";
 /** Chinese copy (the canonical shape). */
 export declare const zh: {
-    'panel.mode': string;
-    'panel.effectiveAccess': string;
+    'skills.globalEnable': string;
+    'skills.globalHint': string;
+    'skills.settingsFailed': string;
+    'skills.userOnly': string;
+    'panel.skills': string;
+    'panel.skillsEnabled': string;
+    'panel.skillsDisabled': string;
+    'panel.aliasIdEdit': string;
+    'panel.aliasIdPlaceholder': string;
+    'panel.aliasIdInvalid': string;
+    'error.invalid-alias-id': string;
+    'panel.accessEffective': string;
     'panel.toolCaps': string;
     'panel.invalidCap': string;
-    'mode.read-only': string;
-    'mode.workspace-write': string;
-    'mode.danger-full-access': string;
     'effective.read-only': string;
     'effective.read-write': string;
     'effective.full-access': string;
@@ -27,11 +34,9 @@ export declare const zh: {
     'action.title': string;
     'switcher.manage': string;
     'panel.title': string;
-    'panel.subtitle': string;
     'panel.primary': string;
     'panel.primaryNote': string;
-    'panel.cwd': string;
-    'panel.cwdNote': string;
+    'panel.currentAgentCwd': string;
     'panel.additional': string;
     'panel.limitReached': string;
     'panel.empty': string;
@@ -96,13 +101,20 @@ export declare const zh: {
 export type Key = keyof typeof zh;
 /** English copy, pinned to the Chinese key set. */
 export declare const en: {
-    'panel.mode': string;
-    'panel.effectiveAccess': string;
+    'skills.globalEnable': string;
+    'skills.globalHint': string;
+    'skills.settingsFailed': string;
+    'skills.userOnly': string;
+    'panel.skills': string;
+    'panel.skillsEnabled': string;
+    'panel.skillsDisabled': string;
+    'panel.aliasIdEdit': string;
+    'panel.aliasIdPlaceholder': string;
+    'panel.aliasIdInvalid': string;
+    'error.invalid-alias-id': string;
+    'panel.accessEffective': string;
     'panel.toolCaps': string;
     'panel.invalidCap': string;
-    'mode.read-only': string;
-    'mode.workspace-write': string;
-    'mode.danger-full-access': string;
     'effective.read-only': string;
     'effective.read-write': string;
     'effective.full-access': string;
@@ -111,11 +123,9 @@ export declare const en: {
     'action.title': string;
     'switcher.manage': string;
     'panel.title': string;
-    'panel.subtitle': string;
     'panel.primary': string;
     'panel.primaryNote': string;
-    'panel.cwd': string;
-    'panel.cwdNote': string;
+    'panel.currentAgentCwd': string;
     'panel.additional': string;
     'panel.limitReached': string;
     'panel.empty': string;

package/lib/types/client/skills-client.d.ts

@@ -0,0 +1,23 @@
+import { type SkillsCatalogView, type SkillsPreviewView } from '../skills-contract.ts';
+interface Connection {
+    rpc: {
+        call(channel: string, endpoint: string, payload: unknown, signal?: AbortSignal): Promise<unknown>;
+    };
+}
+export declare class SkillsClient {
+    private readonly connection;
+    private readonly states;
+    private closed;
+    constructor(connection: Connection);
+    private state;
+    private call;
+    list(sessionId: string, signal?: AbortSignal): Promise<SkillsCatalogView>;
+    snapshot(sessionId: string): SkillsCatalogView | undefined;
+    preview(sessionId: string, name: string, signal?: AbortSignal): Promise<SkillsPreviewView>;
+    subscribe(sessionId: string, listener: () => void): () => void;
+    private invalidate;
+    reset(): void;
+    dispose(): void;
+    private watch;
+}
+export {};

package/lib/types/client/skills-settings.d.ts

@@ -0,0 +1,10 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { type SkillsForm } from '../compat/skills-client.ts';
+import type { Translate } from './WorkspaceFoldersAction.tsx';
+interface CardProps {
+    form: SkillsForm;
+    t: Translate;
+}
+export declare function SkillsSettingsCard({ form, t }: CardProps): import("react").JSX.Element;
+export declare function installSkillsSettingsCard(ctx: Context, t: Translate): void;
+export {};

package/lib/types/client/skills.d.ts

@@ -0,0 +1,36 @@
+/** Namespaced Slash completion and plain-text sent-message references. */
+import type { Context } from '@deepseek-ai/cordis';
+import { type NamespaceRule } from '../compat/skills-client.ts';
+import { SkillsClient } from './skills-client.ts';
+import type { Translate } from './WorkspaceFoldersAction.tsx';
+interface Source {
+    trigger: '/';
+    name: string;
+    order: number;
+    candidates(session: {
+        sessionId: string;
+    }, request: {
+        query: string;
+        signal: AbortSignal;
+    }): Promise<readonly {
+        name: string;
+        description: string;
+    }[]>;
+    onPick(pick: {
+        candidate: {
+            name: string;
+        };
+    }): {
+        text: string;
+    };
+    lexicon(session: {
+        sessionId: string;
+    }): readonly string[] | undefined;
+    subscribeLexicon(session: {
+        sessionId: string;
+    }, listener: () => void): () => void;
+}
+export declare const namespaceSkillRule: NamespaceRule;
+export declare function namespaceSource(client: SkillsClient, t: Translate): Source;
+export declare function installSkillsClient(ctx: Context, t: Translate, subscribeSession: (listener: () => void) => () => void): void;
+export {};

package/lib/types/client/styles.d.ts

@@ -11,4 +11,4 @@
  * @module @dsh-electron/dsh-plugin-multi-root-workspace/client/styles
  */
 /** The stylesheet text; every class is prefixed `mrfw-` to stay collision-free. */
-export declare const STYLES = "\n/* Sidebar footer row, mirroring the host ui-settings-general trigger: the row\n * wrapper overhangs each side by 2px (width calc(100% + 4px) against the\n * shell's 12px inline padding) so the icon's ink line lands at 18px from the\n * column edge \u2014 exactly where the Settings gear below sits. */\n.mrfw-triggerRow {\n  flex: none;\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  width: calc(100% + 4px);\n  margin: 4px -2px;\n}\n\n.mrfw-triggerRow.mrfw-railRow {\n  width: 36px;\n  margin: 8px 0 10px;\n}\n\n.mrfw-trigger {\n  box-sizing: border-box;\n  flex: 1;\n  min-width: 0;\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  width: auto;\n  height: 42px;\n  margin: 0;\n  padding: 0 10px 0 8px;\n  border: none;\n  border-radius: 12px;\n  background: transparent;\n  color: var(--dsw-alias-label-primary);\n  font-family: inherit;\n  font-size: 14px;\n  line-height: 22px;\n  text-align: left;\n  cursor: pointer;\n  overflow: hidden;\n  transition: background-color var(--ds-transition-duration-fast) var(--ds-ease-in-out);\n}\n\n.mrfw-trigger:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.mrfw-triggerIcon {\n  flex: none;\n  display: inline-flex;\n}\n\n.mrfw-triggerLabel {\n  overflow: hidden;\n  white-space: nowrap;\n}\n\n.mrfw-triggerRail {\n  flex: none;\n  width: 36px;\n  height: 36px;\n  margin: 0;\n  padding: 0;\n  gap: 0;\n  border-radius: 50%;\n  justify-content: center;\n}\n\n/* Icon-only launcher inside the upstream Files tab header. Upstream's\n   FilesBody renders .header as one flat flex row \u2014 PathLabel, then the\n   reload button, then the files.actions slot occupants \u2014 and each of those\n   children carries a stable data-files-* attribute on the flex item itself\n   (data-files-root on the pane, data-files-path, data-files-reload).\n   A registration order sorts only INSIDE the actions slot and can never\n   overtake the reload button, so the launcher is moved with the flex order\n   property instead: this wrapper is the slot's root element and therefore a\n   direct flex item of .header, and order: -1 puts it ahead of every\n   order-0 sibling while the :has() rule below keeps the path first. */\n.mrfw-fileLauncher {\n  order: -1;\n  flex: none;\n  display: flex;\n  align-items: center;\n}\n\n/* Pin the upstream path label ahead of the launcher \u2014 but only while this\n   plugin is in the row: the :has() guard keeps a rule that names an\n   upstream element inert whenever the launcher is absent. The\n   :not([data-files-entry]) qualifier is load-bearing, not decorative:\n   upstream puts data-files-path on EVERY tree row too (the row's own\n   absolute path), so an unqualified selector would match the whole tree,\n   not just the header's PathLabel. Both selectors depend on upstream's DOM\n   shape, which is not part of the slot contract; if it changes, the rules\n   simply stop matching and the launcher falls back to its in-slot position \u2014\n   a silent degradation, never a broken header. */\n[data-files-root]:has(.mrfw-fileLauncher) [data-files-path]:not([data-files-entry]) {\n  order: -2;\n}\n\n/* The root switcher is the launcher's grown-up form on runtimes whose\n   files.actions owner carries absolutePath. It takes the path label's flex\n   position and stretch: order: -1 ahead of every order-0 sibling, and a\n   growing min-width:0 item so both the trigger label and the PathLabel\n   inside it can ellipsize instead of pushing the header controls out. */\n.mrfw-rootSwitcher {\n  order: -1;\n  flex: 1 1 auto;\n  min-width: 0;\n  display: flex;\n  align-items: center;\n  /* Same 4px the upstream .header puts between its own flex items, so the\n     takeover controls (reload, open-in-app fork) sit at the same offsets the\n     hidden native ones did \u2014 no drift between primary and additional state. */\n  gap: 4px;\n}\n\n/* While the switcher exists it hides the upstream path label \u2014 the\n   :has() guard again keeps the upstream-naming rule inert unless this\n   plugin is actually in the row. The switcher draws its own PathLabel of\n   the selected root next to the trigger (className mrfw-switcherPath, no\n   data-files-* attributes), so the header keeps a path in the same spot.\n   :not([data-files-entry]) is what confines this rule to the header:\n   every tree row carries data-files-path with its own path as the value,\n   and only the PathLabel carries it bare. Without the qualifier this\n   display:none would blank the entire native tree. */\n[data-files-root]:has(.mrfw-rootSwitcher) [data-files-path]:not([data-files-entry]) {\n  display: none;\n}\n\n/* While the switcher names an additional root, the native tree body and its\n   reload hide: the reload refreshes the very tree that is no longer\n   visible, and the plugin's forked tree is portaled in as the body's sibling.\n   The header still offers a reload \u2014 the switcher's own .mrfw-switcherReload\n   calls the forked face's refresh. The native tree keeps watching in the\n   background, so switching back to the primary root restores it instantly. */\n[data-files-root]:has(.mrfw-rootSwitcher[data-root-kind=\"additional\"]) [data-files-body],\n[data-files-root]:has(.mrfw-rootSwitcher[data-root-kind=\"additional\"]) [data-files-reload] {\n  display: none;\n}\n\n/* While the switcher names an additional root, the native open-in-app split\n   button hides too: its slot props carry the pane's primary root, so it\n   would always open the primary root no matter what the switcher selected.\n   The header gets the plugin's own fork of that same control instead (the\n   open-in-app directory), wired to the selected root.\n\n   The slot's render site is wrapped in the renderer's own anchor \u2014\n   <div data-slot=\"sidebar.right.tab.files.actions\" style=\"display:contents\">\n   \u2014 so the header's flex items inside it are the occupants themselves, and\n   the native item is the ui-primitives Menu anchor span wrapping the marked\n   .split. The first selector hides that occupant item through the data-slot\n   anchor: hiding only the inner control would leave the empty anchor span\n   as a zero-width flex item whose header gap pushes the fork 4px left of\n   the native position. The wrapper itself can never be the target \u2014 its\n   inline display:contents beats any stylesheet rule, and hiding it would\n   take the switcher with it. The second selector is the fallback for an\n   upstream that moves the attribute off the item. The fork survives both:\n   the only data-open-target inside .mrfw-rootSwitcher is its own\n   .mrfw-openSplit, which :not() excludes. */\n[data-files-root]:has(.mrfw-rootSwitcher[data-root-kind=\"additional\"]) [data-slot=\"sidebar.right.tab.files.actions\"] > *:has([data-open-target=\"directory\"]:not(.mrfw-openSplit)),\n[data-files-root]:has(.mrfw-rootSwitcher[data-root-kind=\"additional\"]) [data-open-target=\"directory\"]:not(.mrfw-openSplit) {\n  display: none;\n}\n\n/* The trigger borrows the path label's look: quiet text with a folder\n   glyph, the hover of the neighboring header buttons, and the overflow\n   behavior PathLabel itself uses in a narrow header. It may shrink but\n   never grows \u2014 the PathLabel after it owns the free header space. */\n.mrfw-rootSwitchBtn {\n  flex: 0 1 auto;\n  min-width: 0;\n  display: inline-flex;\n  align-items: center;\n  gap: 4px;\n  height: 28px;\n  margin: 0;\n  padding: 0 4px;\n  border: none;\n  border-radius: 8px;\n  background: transparent;\n  color: var(--dsw-alias-label-primary);\n  font-family: inherit;\n  font-size: inherit;\n  line-height: 20px;\n  text-align: left;\n  cursor: pointer;\n  transition: background-color var(--ds-transition-duration-fast) var(--ds-ease-in-out);\n}\n\n.mrfw-rootSwitchBtn:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.mrfw-rootSwitchBtn .mrfw-triggerIcon {\n  color: var(--dsw-alias-label-secondary);\n}\n\n.mrfw-rootSwitchLabel {\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.mrfw-rootSwitchChevron {\n  margin-left: auto;\n  color: var(--dsw-alias-label-tertiary);\n}\n\n/* The selected root's full path sits between the trigger and the reload \u2014\n   the very PathLabel upstream draws there, so it brings its own grow,\n   left-clip and hover-title behavior; only the gutters are ours. The right\n   margin plus the container gap reproduces upstream's .path margin-right\n   12px + header gap 4px; the left gutter comes from the same container gap. */\n.mrfw-switcherPath {\n  margin: 0 12px 0 0;\n}\n\n/* The takeover's own reload, standing exactly where the hidden native one\n   did: the upstream .tool recipe verbatim (28px hit area, 15px glyph,\n   secondary voice, hover fills). It calls the forked face's refresh \u2014 an\n   in-place re-list, not a remount. */\n.mrfw-switcherReload {\n  flex: none;\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 28px;\n  height: 28px;\n  padding: 6px;\n  border: none;\n  border-radius: var(--dsw-radius-sm);\n  background: transparent;\n  color: var(--dsw-alias-label-secondary);\n  line-height: 1;\n  cursor: pointer;\n}\n\n.mrfw-switcherReload:hover {\n  color: var(--dsw-alias-label-primary);\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n/* \u2500\u2500 files-tree fork (verbatim rules, renamed classes) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n   Copied from upstream's FilesBody.module.css (ui-sidebar-files @\n   0.2.1-alpha.2) with local names mapped to mrfw-ft* so the rules cannot\n   collide with host DOM \u2014 and so the fork's own body (which must NOT carry\n   data-files-body) stays visible while the rules above hide the native one.\n   The header-only rules (root/header/path/tool/status/statusLine/titleIcon)\n   belong to the upstream shell this fork drops and are not mapped. Fork sync\n   re-diffs the upstream file and re-applies the rename \u2014 see\n   src/client/files-tree/FORK.md. */\n\n/* The pane's own .root already supplies the flex column, color, and font;\n   the fork's body takes the same stretch item the hidden native body held,\n   including the workspace list's 2px scrollbar offset and stable gutter. */\n.mrfw-ftBody {\n  flex: 1 1 auto;\n  min-height: 0;\n  margin-right: 2px;\n  padding: 8px 0 8px 8px;\n  overflow: auto;\n  scrollbar-gutter: stable;\n}\n\n.mrfw-ftBody::-webkit-scrollbar-track {\n  margin: 2px;\n}\n\n.mrfw-ftLevel {\n  margin: 0;\n  padding: 0;\n  list-style: none;\n}\n\n.mrfw-ftLevel .mrfw-ftLevel {\n  padding-left: 18px;\n}\n\n.mrfw-ftItem {\n  margin: 0;\n  padding: 0;\n}\n\n/* Rows abut, so the hover fill is the whole row; the tree's air is this\n   inset, not a gap between rows. */\n.mrfw-ftRow {\n  display: flex;\n  gap: 6px;\n  align-items: center;\n  width: 100%;\n  min-width: 0;\n  padding: 5px 10px;\n  color: inherit;\n  font: inherit;\n  text-align: left;\n  background: transparent;\n  border: 0;\n  border-radius: var(--dsw-radius-md);\n  cursor: pointer;\n}\n\n.mrfw-ftRow:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n/* The folder glyph rides the tertiary ink, as the workspace tree's does. */\n.mrfw-ftIcon {\n  flex: 0 0 auto;\n  color: var(--dsw-alias-label-tertiary);\n}\n\n/* The type's coloured sheet at the folder glyph's 16px; its colour is its own. */\n.mrfw-ftFileIcon {\n  flex: 0 0 auto;\n}\n\n.mrfw-ftName {\n  min-width: 0;\n  overflow: hidden;\n  white-space: nowrap;\n  text-overflow: ellipsis;\n}\n\n/* Neither a file nor a directory: shown so the directory is reported whole,\n   greyed so nobody tries to open it. */\n.mrfw-ftOther {\n  color: var(--dsw-alias-label-tertiary);\n  cursor: default;\n}\n\n.mrfw-ftOther:hover {\n  background: transparent;\n}\n\n.mrfw-ftNote {\n  margin: 0;\n  padding: 3px 10px;\n  color: var(--dsw-alias-label-tertiary);\n  font-size: 12px;\n}\n\n/* \u2500\u2500 open-in-app fork (verbatim rules, renamed classes) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n   Copied from upstream's OpenTargetButton.module.css\n   (dsh-client-ui-open-in-app @ 0.2.1-alpha.2) with local names mapped to\n   mrfw-open* so the rules cannot collide with host DOM. Fork sync re-diffs\n   the upstream file and re-applies the rename \u2014 see\n   src/client/open-in-app/FORK.md. */\n\n/* Sized to sit in the document header's 24px control row beside its round\n   icon buttons: a hairline pill with a 12px label and a narrow chevron half. */\n.mrfw-openMenuAnchor {\n  display: inline-flex;\n  flex: none;\n  align-self: center;\n}\n\n.mrfw-openSplit {\n  display: inline-flex;\n  align-items: stretch;\n  box-sizing: border-box;\n  height: 24px;\n  overflow: hidden;\n  border: 0.5px solid var(--dsw-alias-border-l4);\n  border-radius: var(--dsw-radius-sm);\n  font-family: var(--dsw-font-family);\n}\n\n.mrfw-openMain,\n.mrfw-openChevron {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  border: 0;\n  background: none;\n  color: var(--dsw-alias-label-primary);\n  font-size: 11px;\n  line-height: 16px;\n  white-space: nowrap;\n  cursor: pointer;\n}\n\n.mrfw-openMain {\n  gap: 4px;\n  padding: 3px 5px;\n}\n\n.mrfw-openChevron {\n  padding: 3px 4px 3px 3px;\n  border-left: 0.5px solid var(--dsw-alias-border-l4);\n  color: var(--dsw-alias-label-secondary);\n}\n\n.mrfw-openMain:hover:not(:disabled),\n.mrfw-openMain:focus-visible,\n.mrfw-openChevron:hover:not(:disabled),\n.mrfw-openChevron:focus-visible {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n/* Pending disables clicks without a restyle; only hover feedback pauses. */\n.mrfw-openMain:disabled,\n.mrfw-openChevron:disabled {\n  cursor: default;\n}\n\n.mrfw-openAppIcon {\n  object-fit: contain;\n}\n\n/* The unavailable preview emphasizes the same actions with a labeled button. */\n.mrfw-openSplit[data-size='large'] {\n  height: 36px;\n  border-radius: var(--dsw-radius-md);\n  border-color: var(--dsw-alias-border-l2);\n}\n\n.mrfw-openSplit[data-size='large'] .mrfw-openMain {\n  gap: 6px;\n  padding: 6px 14px;\n  font-size: 14px;\n}\n\n.mrfw-openSplit[data-size='large'] .mrfw-openChevron {\n  padding: 6px 10px;\n}\n\n.mrfw-openSkeleton { display: inline-block; flex: none; border-radius: var(--dsw-radius-xs); background: var(--dsw-alias-interactive-bg-hover); }\n\n.mrfw-overlay {\n  position: fixed;\n  inset: 0;\n  z-index: 1000;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  padding: 24px;\n}\n\n.mrfw-mask {\n  position: absolute;\n  inset: 0;\n  background: var(--dsw-alias-bg-mask-1);\n  backdrop-filter: var(--dsw-mask-blur);\n}\n\n.mrfw-dialog {\n  position: relative;\n  z-index: 1;\n  display: flex;\n  flex-direction: column;\n  width: min(640px, 100%);\n  max-height: 100%;\n  overflow: hidden;\n  border: none;\n  border-radius: 24px;\n  background: var(--dsw-alias-bg-layer-2);\n  box-shadow: var(--dsw-elevation-prominent);\n  color: var(--dsw-alias-label-primary);\n  font-family: inherit;\n  outline: none;\n}\n\n.mrfw-header {\n  flex: none;\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  gap: 8px;\n  padding: 22px 14px 12px 24px;\n}\n\n.mrfw-title {\n  margin: 0;\n  font-size: 16px;\n  line-height: 24px;\n  font-weight: 500;\n  color: var(--dsw-alias-label-primary);\n}\n\n.mrfw-close {\n  flex: none;\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 28px;\n  height: 28px;\n  border: none;\n  border-radius: 8px;\n  background: transparent;\n  cursor: pointer;\n  color: var(--dsw-alias-label-secondary);\n  transition: background-color var(--ds-transition-duration-fast) var(--ds-ease-in-out);\n}\n\n.mrfw-close:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.mrfw-body {\n  display: flex;\n  flex-direction: column;\n  min-height: 0;\n  overflow-y: auto;\n  padding: 0 24px 24px;\n}\n\n.mrfw-description {\n  margin: 0 0 8px;\n  font-size: 14px;\n  line-height: 22px;\n  color: var(--dsw-alias-label-tertiary);\n}\n\n.mrfw-alert {\n  margin: 0 0 8px;\n  font-size: 14px;\n  line-height: 22px;\n  color: var(--dsw-alias-state-error-primary);\n}\n\n.mrfw-section {\n  display: flex;\n  flex-direction: column;\n}\n\n.mrfw-section + .mrfw-section {\n  margin-top: 8px;\n}\n\n.mrfw-sectionTitleRow {\n  display: flex;\n  align-items: baseline;\n  gap: 8px;\n  padding: 8px 0 4px;\n}\n\n.mrfw-sectionTitle {\n  font-size: 14px;\n  line-height: 22px;\n  font-weight: 500;\n  color: var(--dsw-alias-label-primary);\n}\n\n.mrfw-sectionNote {\n  font-size: 12px;\n  line-height: 18px;\n  color: var(--dsw-alias-label-tertiary);\n}\n\n.mrfw-row {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  gap: 8px;\n  padding: 12px 0;\n  border-bottom: 0.5px solid var(--dsw-alias-border-l2);\n}\n\n.mrfw-rowBare {\n  border-bottom: none;\n}\n\n/* A root entry's two lines: the display name on top, the absolute path under\n   it in the tertiary voice (the workspace rows recipe of the host sidebar). */\n.mrfw-rootText {\n  display: flex;\n  flex: 1 1 240px;\n  flex-direction: column;\n  gap: 2px;\n  min-width: 0;\n}\n\n/* The name line is a flex row: the truncating name text first, the access\n   badge beside it never shrinking \u2014 baseline-aligned so the badge's smaller\n   voice sits on the name's baseline rather than its middle. */\n.mrfw-rootName {\n  display: flex;\n  align-items: baseline;\n  gap: 6px;\n  min-width: 0;\n  overflow: hidden;\n  font-size: 14px;\n  line-height: 20px;\n  font-weight: 500;\n  color: var(--dsw-alias-label-primary);\n}\n\n.mrfw-rootNameText {\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.mrfw-rootPath {\n  font-family: var(--ds-font-family-code);\n  font-size: 12px;\n  line-height: 18px;\n  word-break: break-all;\n  color: var(--dsw-alias-label-tertiary);\n}\n\n/* The path doubles as the copy control: an unstyled button that keeps the\n   text recipe and makes the whole string clickable \u2014 the whole region, not\n   just the icon, copies on click. */\n.mrfw-pathCopy {\n  display: block;\n  width: 100%;\n  padding: 0;\n  border: 0;\n  background: transparent;\n  text-align: left;\n  cursor: pointer;\n}\n\n/* The trailing icon stays in flow but invisible until the path is hovered\n   or focused: appearing never re-wraps the text, and the icon inherits the\n   path's own tertiary ink. */\n.mrfw-pathCopyIcon {\n  display: inline-flex;\n  margin-left: 4px;\n  vertical-align: -2px;\n  opacity: 0;\n  transition: opacity var(--ds-transition-duration-fast) var(--ds-ease-in-out);\n}\n\n.mrfw-pathCopy:hover .mrfw-pathCopyIcon,\n.mrfw-pathCopy:focus-visible .mrfw-pathCopyIcon {\n  opacity: 1;\n}\n\n.mrfw-note {\n  margin: 0;\n  font-size: 12px;\n  line-height: 18px;\n  color: var(--dsw-alias-label-tertiary);\n}\n\n.mrfw-stateWarn {\n  font-size: 12px;\n  line-height: 18px;\n  color: var(--dsw-alias-state-warn-primary);\n}\n\n.mrfw-btn {\n  display: inline-flex;\n  flex: none;\n  align-items: center;\n  justify-content: center;\n  gap: 4px;\n  height: 28px;\n  padding: 0 10px;\n  border: none;\n  border-radius: 14px;\n  background: transparent;\n  color: var(--dsw-alias-label-primary);\n  font-family: inherit;\n  font-size: 12px;\n  line-height: 18px;\n  cursor: pointer;\n  transition: background-color var(--ds-transition-duration-fast) var(--ds-ease-in-out);\n}\n\n.mrfw-btn:disabled {\n  cursor: not-allowed;\n  opacity: 0.4;\n}\n\n.mrfw-btnGhost:hover:not(:disabled) {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.mrfw-btnGhost:active:not(:disabled) {\n  background: var(--dsw-alias-interactive-bg-active);\n}\n\n/* The solid destructive action of the capsule family: the upgrade confirm's\n   red button. state-error-primary is the error ink upstream also uses as a\n   fill (StateDot); the hover mixes in the host's primary label token to\n   follow its theme and contrast choices. Neither color is a guessed token:\n   an undefined var() would fall back\n   to transparent and white-out the whole button. */\n.mrfw-btnDanger {\n  background: var(--dsw-alias-state-error-primary);\n  color: var(--dsw-alias-label-primary-foreground);\n}\n\n.mrfw-btnDanger:hover:not(:disabled) {\n  background: color-mix(in srgb, var(--dsw-alias-state-error-primary) 85%, var(--dsw-alias-label-primary));\n}\n\n.mrfw-btnOutline {\n  border: 0.5px solid var(--dsw-alias-border-l3);\n  background: transparent;\n}\n\n.mrfw-btnOutline:hover:not(:disabled) {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.mrfw-btnPrimary {\n  background: var(--dsw-alias-button-primary-fill);\n  color: var(--dsw-alias-label-primary-foreground);\n}\n\n.mrfw-btnPrimary:hover:not(:disabled) {\n  background: var(--dsw-alias-button-primary-hover);\n}\n\n/* One icon-only action: a square of the capsule family, meaning in title.\n   Declared after the .mrfw-btn family so its padding wins the cascade tie:\n   the capsule's 0 10px padding would otherwise squeeze the icon glyph. */\n.mrfw-iconBtn {\n  width: 28px;\n  padding: 0;\n  border-radius: 8px;\n}\n\n.mrfw-input {\n  flex: 1 1 220px;\n  min-width: 0;\n  height: 32px;\n  padding: 0 8px;\n  border: 0.5px solid var(--dsw-alias-border-l4);\n  border-radius: 8px;\n  background: var(--dsw-alias-bg-layer-1);\n  color: var(--dsw-alias-label-primary);\n  font-family: inherit;\n  font-size: 14px;\n  line-height: 22px;\n  outline: none;\n  transition: border-color var(--ds-transition-duration-fast) var(--ds-ease-in-out);\n}\n\n.mrfw-input:focus {\n  border-color: var(--dsw-alias-brand-primary);\n}\n\n.mrfw-input::placeholder {\n  color: var(--dsw-alias-label-dimmed);\n}\n\n.mrfw-inputInline {\n  flex: 1 1 auto;\n}\n\n.mrfw-accessSelect {\n  flex: 0 0 auto;\n}\n\n/* The access dropdown's capsule trigger: the Menu anchor wrapper is the flex\n   item, the button inside keeps the control row's 32px capsule recipe. */\n.mrfw-accessTrigger {\n  padding: 0 12px;\n}\n\n.mrfw-accessBadge,\n.mrfw-effectiveAccess {\n  flex: none;\n  font-size: 12px;\n  line-height: 18px;\n  color: var(--dsw-alias-label-tertiary);\n}\n\n.mrfw-aliasEditor {\n  display: flex;\n  flex-wrap: wrap;\n  gap: 8px;\n  flex-basis: 100%;\n}\n\n.mrfw-actions {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  gap: 8px;\n  margin-top: 16px;\n  padding-top: 16px;\n  border-top: 0.5px solid var(--dsw-alias-border-l2);\n}\n\n/* One control row, one height: the capsule buttons match the 32px input. */\n.mrfw-actions .mrfw-btn {\n  height: 32px;\n  border-radius: 16px;\n}\n\n.mrfw-actions .mrfw-iconBtn {\n  width: 32px;\n}\n";
+export declare const STYLES = "\n/* Sidebar footer row, mirroring the host ui-settings-general trigger: the row\n * wrapper overhangs each side by 2px (width calc(100% + 4px) against the\n * shell's 12px inline padding) so the icon's ink line lands at 18px from the\n * column edge \u2014 exactly where the Settings gear below sits. */\n.mrfw-triggerRow {\n  flex: none;\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  width: calc(100% + 4px);\n  margin: 4px -2px;\n}\n\n.mrfw-triggerRow.mrfw-railRow {\n  width: 36px;\n  margin: 8px 0 10px;\n}\n\n.mrfw-trigger {\n  box-sizing: border-box;\n  flex: 1;\n  min-width: 0;\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  width: auto;\n  height: 42px;\n  margin: 0;\n  padding: 0 10px 0 8px;\n  border: none;\n  border-radius: 12px;\n  background: transparent;\n  color: var(--dsw-alias-label-primary);\n  font-family: inherit;\n  font-size: 14px;\n  line-height: 22px;\n  text-align: left;\n  cursor: pointer;\n  overflow: hidden;\n  transition: background-color var(--ds-transition-duration-fast) var(--ds-ease-in-out);\n}\n\n.mrfw-trigger:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.mrfw-triggerIcon {\n  flex: none;\n  display: inline-flex;\n}\n\n.mrfw-triggerLabel {\n  overflow: hidden;\n  white-space: nowrap;\n}\n\n.mrfw-triggerRail {\n  flex: none;\n  width: 36px;\n  height: 36px;\n  margin: 0;\n  padding: 0;\n  gap: 0;\n  border-radius: 50%;\n  justify-content: center;\n}\n\n/* Icon-only launcher inside the upstream Files tab header. Upstream's\n   FilesBody renders .header as one flat flex row \u2014 PathLabel, then the\n   reload button, then the files.actions slot occupants \u2014 and each of those\n   children carries a stable data-files-* attribute on the flex item itself\n   (data-files-root on the pane, data-files-path, data-files-reload).\n   A registration order sorts only INSIDE the actions slot and can never\n   overtake the reload button, so the launcher is moved with the flex order\n   property instead: this wrapper is the slot's root element and therefore a\n   direct flex item of .header, and order: -1 puts it ahead of every\n   order-0 sibling while the :has() rule below keeps the path first. */\n.mrfw-fileLauncher {\n  order: -1;\n  flex: none;\n  display: flex;\n  align-items: center;\n}\n\n/* Pin the upstream path label ahead of the launcher \u2014 but only while this\n   plugin is in the row: the :has() guard keeps a rule that names an\n   upstream element inert whenever the launcher is absent. The\n   :not([data-files-entry]) qualifier is load-bearing, not decorative:\n   upstream puts data-files-path on EVERY tree row too (the row's own\n   absolute path), so an unqualified selector would match the whole tree,\n   not just the header's PathLabel. Both selectors depend on upstream's DOM\n   shape, which is not part of the slot contract; if it changes, the rules\n   simply stop matching and the launcher falls back to its in-slot position \u2014\n   a silent degradation, never a broken header. */\n[data-files-root]:has(.mrfw-fileLauncher) [data-files-path]:not([data-files-entry]) {\n  order: -2;\n}\n\n/* The root switcher is the launcher's grown-up form on runtimes whose\n   files.actions owner carries absolutePath. It takes the path label's flex\n   position and stretch: order: -1 ahead of every order-0 sibling, and a\n   growing min-width:0 item so both the trigger label and the PathLabel\n   inside it can ellipsize instead of pushing the header controls out. */\n.mrfw-rootSwitcher {\n  order: -1;\n  flex: 1 1 auto;\n  min-width: 0;\n  display: flex;\n  align-items: center;\n  /* Same 4px the upstream .header puts between its own flex items, so the\n     takeover controls (reload, open-in-app fork) sit at the same offsets the\n     hidden native ones did \u2014 no drift between primary and additional state. */\n  gap: 4px;\n}\n\n/* While the switcher exists it hides the upstream path label \u2014 the\n   :has() guard again keeps the upstream-naming rule inert unless this\n   plugin is actually in the row. The switcher draws its own PathLabel of\n   the selected root next to the trigger (className mrfw-switcherPath, no\n   data-files-* attributes), so the header keeps a path in the same spot.\n   :not([data-files-entry]) is what confines this rule to the header:\n   every tree row carries data-files-path with its own path as the value,\n   and only the PathLabel carries it bare. Without the qualifier this\n   display:none would blank the entire native tree. */\n[data-files-root]:has(.mrfw-rootSwitcher) [data-files-path]:not([data-files-entry]) {\n  display: none;\n}\n\n/* While the switcher names an additional root, the native tree body and its\n   reload hide: the reload refreshes the very tree that is no longer\n   visible, and the plugin's forked tree is portaled in as the body's sibling.\n   The header still offers a reload \u2014 the switcher's own .mrfw-switcherReload\n   calls the forked face's refresh. The native tree keeps watching in the\n   background, so switching back to the primary root restores it instantly. */\n[data-files-root]:has(.mrfw-rootSwitcher[data-root-kind=\"additional\"]) [data-files-body],\n[data-files-root]:has(.mrfw-rootSwitcher[data-root-kind=\"additional\"]) [data-files-reload] {\n  display: none;\n}\n\n/* While the switcher names an additional root, the native open-in-app split\n   button hides too: its slot props carry the pane's primary root, so it\n   would always open the primary root no matter what the switcher selected.\n   The header gets the plugin's own fork of that same control instead (the\n   open-in-app directory), wired to the selected root.\n\n   The slot's render site is wrapped in the renderer's own anchor \u2014\n   <div data-slot=\"sidebar.right.tab.files.actions\" style=\"display:contents\">\n   \u2014 so the header's flex items inside it are the occupants themselves, and\n   the native item is the ui-primitives Menu anchor span wrapping the marked\n   .split. The first selector hides that occupant item through the data-slot\n   anchor: hiding only the inner control would leave the empty anchor span\n   as a zero-width flex item whose header gap pushes the fork 4px left of\n   the native position. The wrapper itself can never be the target \u2014 its\n   inline display:contents beats any stylesheet rule, and hiding it would\n   take the switcher with it. The second selector is the fallback for an\n   upstream that moves the attribute off the item. The fork survives both:\n   the only data-open-target inside .mrfw-rootSwitcher is its own\n   .mrfw-openSplit, which :not() excludes. */\n[data-files-root]:has(.mrfw-rootSwitcher[data-root-kind=\"additional\"]) [data-slot=\"sidebar.right.tab.files.actions\"] > *:has([data-open-target=\"directory\"]:not(.mrfw-openSplit)),\n[data-files-root]:has(.mrfw-rootSwitcher[data-root-kind=\"additional\"]) [data-open-target=\"directory\"]:not(.mrfw-openSplit) {\n  display: none;\n}\n\n/* The trigger borrows the path label's look: quiet text with a folder\n   glyph, the hover of the neighboring header buttons, and the overflow\n   behavior PathLabel itself uses in a narrow header. It may shrink but\n   never grows \u2014 the PathLabel after it owns the free header space. */\n.mrfw-rootSwitchBtn {\n  flex: 0 1 auto;\n  min-width: 0;\n  display: inline-flex;\n  align-items: center;\n  gap: 4px;\n  height: 28px;\n  margin: 0;\n  padding: 0 4px;\n  border: none;\n  border-radius: 8px;\n  background: transparent;\n  color: var(--dsw-alias-label-primary);\n  font-family: inherit;\n  font-size: inherit;\n  line-height: 20px;\n  text-align: left;\n  cursor: pointer;\n  transition: background-color var(--ds-transition-duration-fast) var(--ds-ease-in-out);\n}\n\n.mrfw-rootSwitchBtn:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.mrfw-rootSwitchBtn .mrfw-triggerIcon {\n  color: var(--dsw-alias-label-secondary);\n}\n\n.mrfw-rootSwitchLabel {\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.mrfw-rootSwitchChevron {\n  margin-left: auto;\n  color: var(--dsw-alias-label-tertiary);\n}\n\n/* The selected root's full path sits between the trigger and the reload \u2014\n   the very PathLabel upstream draws there, so it brings its own grow,\n   left-clip and hover-title behavior; only the gutters are ours. The right\n   margin plus the container gap reproduces upstream's .path margin-right\n   12px + header gap 4px; the left gutter comes from the same container gap. */\n.mrfw-switcherPath {\n  margin: 0 12px 0 0;\n}\n\n/* The takeover's own reload, standing exactly where the hidden native one\n   did: the upstream .tool recipe verbatim (28px hit area, 15px glyph,\n   secondary voice, hover fills). It calls the forked face's refresh \u2014 an\n   in-place re-list, not a remount. */\n.mrfw-switcherReload {\n  flex: none;\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 28px;\n  height: 28px;\n  padding: 6px;\n  border: none;\n  border-radius: var(--dsw-radius-sm);\n  background: transparent;\n  color: var(--dsw-alias-label-secondary);\n  line-height: 1;\n  cursor: pointer;\n}\n\n.mrfw-switcherReload:hover {\n  color: var(--dsw-alias-label-primary);\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n/* \u2500\u2500 files-tree fork (verbatim rules, renamed classes) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n   Copied from upstream's FilesBody.module.css (ui-sidebar-files @\n   0.2.1-alpha.2) with local names mapped to mrfw-ft* so the rules cannot\n   collide with host DOM \u2014 and so the fork's own body (which must NOT carry\n   data-files-body) stays visible while the rules above hide the native one.\n   The header-only rules (root/header/path/tool/status/statusLine/titleIcon)\n   belong to the upstream shell this fork drops and are not mapped. Fork sync\n   re-diffs the upstream file and re-applies the rename \u2014 see\n   src/client/files-tree/FORK.md. */\n\n/* The pane's own .root already supplies the flex column, color, and font;\n   the fork's body takes the same stretch item the hidden native body held,\n   including the workspace list's 2px scrollbar offset and stable gutter. */\n.mrfw-ftBody {\n  flex: 1 1 auto;\n  min-height: 0;\n  margin-right: 2px;\n  padding: 8px 0 8px 8px;\n  overflow: auto;\n  scrollbar-gutter: stable;\n}\n\n.mrfw-ftBody::-webkit-scrollbar-track {\n  margin: 2px;\n}\n\n.mrfw-ftLevel {\n  margin: 0;\n  padding: 0;\n  list-style: none;\n}\n\n.mrfw-ftLevel .mrfw-ftLevel {\n  padding-left: 18px;\n}\n\n.mrfw-ftItem {\n  margin: 0;\n  padding: 0;\n}\n\n/* Rows abut, so the hover fill is the whole row; the tree's air is this\n   inset, not a gap between rows. */\n.mrfw-ftRow {\n  display: flex;\n  gap: 6px;\n  align-items: center;\n  width: 100%;\n  min-width: 0;\n  padding: 5px 10px;\n  color: inherit;\n  font: inherit;\n  text-align: left;\n  background: transparent;\n  border: 0;\n  border-radius: var(--dsw-radius-md);\n  cursor: pointer;\n}\n\n.mrfw-ftRow:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n/* The folder glyph rides the tertiary ink, as the workspace tree's does. */\n.mrfw-ftIcon {\n  flex: 0 0 auto;\n  color: var(--dsw-alias-label-tertiary);\n}\n\n/* The type's coloured sheet at the folder glyph's 16px; its colour is its own. */\n.mrfw-ftFileIcon {\n  flex: 0 0 auto;\n}\n\n.mrfw-ftName {\n  min-width: 0;\n  overflow: hidden;\n  white-space: nowrap;\n  text-overflow: ellipsis;\n}\n\n/* Neither a file nor a directory: shown so the directory is reported whole,\n   greyed so nobody tries to open it. */\n.mrfw-ftOther {\n  color: var(--dsw-alias-label-tertiary);\n  cursor: default;\n}\n\n.mrfw-ftOther:hover {\n  background: transparent;\n}\n\n.mrfw-ftNote {\n  margin: 0;\n  padding: 3px 10px;\n  color: var(--dsw-alias-label-tertiary);\n  font-size: 12px;\n}\n\n/* \u2500\u2500 open-in-app fork (verbatim rules, renamed classes) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n   Copied from upstream's OpenTargetButton.module.css\n   (dsh-client-ui-open-in-app @ 0.2.1-alpha.2) with local names mapped to\n   mrfw-open* so the rules cannot collide with host DOM. Fork sync re-diffs\n   the upstream file and re-applies the rename \u2014 see\n   src/client/open-in-app/FORK.md. */\n\n/* Sized to sit in the document header's 24px control row beside its round\n   icon buttons: a hairline pill with a 12px label and a narrow chevron half. */\n.mrfw-openMenuAnchor {\n  display: inline-flex;\n  flex: none;\n  align-self: center;\n}\n\n.mrfw-openSplit {\n  display: inline-flex;\n  align-items: stretch;\n  box-sizing: border-box;\n  height: 24px;\n  overflow: hidden;\n  border: 0.5px solid var(--dsw-alias-border-l4);\n  border-radius: var(--dsw-radius-sm);\n  font-family: var(--dsw-font-family);\n}\n\n.mrfw-openMain,\n.mrfw-openChevron {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  border: 0;\n  background: none;\n  color: var(--dsw-alias-label-primary);\n  font-size: 11px;\n  line-height: 16px;\n  white-space: nowrap;\n  cursor: pointer;\n}\n\n.mrfw-openMain {\n  gap: 4px;\n  padding: 3px 5px;\n}\n\n.mrfw-openChevron {\n  padding: 3px 4px 3px 3px;\n  border-left: 0.5px solid var(--dsw-alias-border-l4);\n  color: var(--dsw-alias-label-secondary);\n}\n\n.mrfw-openMain:hover:not(:disabled),\n.mrfw-openMain:focus-visible,\n.mrfw-openChevron:hover:not(:disabled),\n.mrfw-openChevron:focus-visible {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n/* Pending disables clicks without a restyle; only hover feedback pauses. */\n.mrfw-openMain:disabled,\n.mrfw-openChevron:disabled {\n  cursor: default;\n}\n\n.mrfw-openAppIcon {\n  object-fit: contain;\n}\n\n/* The unavailable preview emphasizes the same actions with a labeled button. */\n.mrfw-openSplit[data-size='large'] {\n  height: 36px;\n  border-radius: var(--dsw-radius-md);\n  border-color: var(--dsw-alias-border-l2);\n}\n\n.mrfw-openSplit[data-size='large'] .mrfw-openMain {\n  gap: 6px;\n  padding: 6px 14px;\n  font-size: 14px;\n}\n\n.mrfw-openSplit[data-size='large'] .mrfw-openChevron {\n  padding: 6px 10px;\n}\n\n.mrfw-openSkeleton { display: inline-block; flex: none; border-radius: var(--dsw-radius-xs); background: var(--dsw-alias-interactive-bg-hover); }\n\n.mrfw-overlay {\n  position: fixed;\n  inset: 0;\n  z-index: 1000;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  padding: 24px;\n}\n\n.mrfw-mask {\n  position: absolute;\n  inset: 0;\n  background: var(--dsw-alias-bg-mask-1);\n  backdrop-filter: var(--dsw-mask-blur);\n}\n\n.mrfw-dialog {\n  position: relative;\n  z-index: 1;\n  display: flex;\n  flex-direction: column;\n  width: min(640px, 100%);\n  max-height: 100%;\n  overflow: hidden;\n  border: none;\n  border-radius: 24px;\n  background: var(--dsw-alias-bg-layer-2);\n  box-shadow: var(--dsw-elevation-prominent);\n  color: var(--dsw-alias-label-primary);\n  font-family: inherit;\n  outline: none;\n}\n\n.mrfw-header {\n  flex: none;\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  gap: 8px;\n  padding: 22px 14px 12px 24px;\n}\n\n.mrfw-title {\n  margin: 0;\n  font-size: 16px;\n  line-height: 24px;\n  font-weight: 500;\n  color: var(--dsw-alias-label-primary);\n}\n\n.mrfw-close {\n  flex: none;\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 28px;\n  height: 28px;\n  border: none;\n  border-radius: 8px;\n  background: transparent;\n  cursor: pointer;\n  color: var(--dsw-alias-label-secondary);\n  transition: background-color var(--ds-transition-duration-fast) var(--ds-ease-in-out);\n}\n\n.mrfw-close:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.mrfw-body {\n  display: flex;\n  flex-direction: column;\n  min-height: 0;\n  overflow-y: auto;\n  padding: 0 24px 24px;\n}\n\n.mrfw-alert {\n  margin: 0 0 8px;\n  font-size: 14px;\n  line-height: 22px;\n  color: var(--dsw-alias-state-error-primary);\n}\n\n.mrfw-section {\n  display: flex;\n  flex-direction: column;\n}\n\n.mrfw-section + .mrfw-section {\n  margin-top: 8px;\n}\n\n.mrfw-sectionTitleRow {\n  display: flex;\n  align-items: baseline;\n  gap: 8px;\n  padding: 8px 0 4px;\n}\n\n.mrfw-sectionTitle {\n  font-size: 14px;\n  line-height: 22px;\n  font-weight: 500;\n  color: var(--dsw-alias-label-primary);\n}\n\n.mrfw-sectionNote {\n  font-size: 12px;\n  line-height: 18px;\n  color: var(--dsw-alias-label-tertiary);\n}\n\n.mrfw-row {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  gap: 8px;\n  padding: 12px 0;\n  border-bottom: 0.5px solid var(--dsw-alias-border-l2);\n}\n\n.mrfw-rowBare {\n  border-bottom: none;\n}\n\n/* A root entry's two lines: the display name on top, the absolute path under\n   it in the tertiary voice (the workspace rows recipe of the host sidebar). */\n/* Match upstream General Settings' DeveloperToolsRow layout. */\n.mrfw-skillsSettings {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  gap: 24px;\n  padding: 16px 0;\n  border-bottom: 0.5px solid var(--dsw-alias-border-l2);\n}\n.mrfw-skillsSettingsText { min-width: 0; }\n.mrfw-skillsSettingsTitle { font-size: 14px; line-height: 20px; }\n.mrfw-skillsSettingsDescription {\n  margin-top: 4px;\n  color: var(--dsw-alias-label-secondary);\n  font-size: 12px;\n  line-height: 18px;\n}\n.mrfw-rootText {\n  display: flex;\n  flex: 1 1 240px;\n  flex-direction: column;\n  gap: 2px;\n  min-width: 0;\n}\n\n/* Keep status tags and permission glyphs visible beside the alias, wrapping\n   onto another line when the dialog is narrow. */\n.mrfw-rootName {\n  display: flex;\n  align-items: center;\n  flex-wrap: wrap;\n  gap: 6px;\n  min-width: 0;\n  font-size: 14px;\n  line-height: 20px;\n  font-weight: 500;\n  color: var(--dsw-alias-label-primary);\n}\n\n.mrfw-rootNameText {\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.mrfw-rootPath {\n  font-family: var(--ds-font-family-code);\n  font-size: 12px;\n  line-height: 18px;\n  word-break: break-all;\n  color: var(--dsw-alias-label-tertiary);\n}\n\n/* The path doubles as the copy control: an unstyled button that keeps the\n   text recipe and makes the whole string clickable \u2014 the whole region, not\n   just the icon, copies on click. */\n.mrfw-pathCopy {\n  display: block;\n  width: 100%;\n  padding: 0;\n  border: 0;\n  background: transparent;\n  text-align: left;\n  cursor: pointer;\n}\n\n/* The trailing icon stays in flow but invisible until the path is hovered\n   or focused: appearing never re-wraps the text, and the icon inherits the\n   path's own tertiary ink. */\n.mrfw-pathCopyIcon {\n  display: inline-flex;\n  margin-left: 4px;\n  vertical-align: -2px;\n  opacity: 0;\n  transition: opacity var(--ds-transition-duration-fast) var(--ds-ease-in-out);\n}\n\n.mrfw-pathCopy:hover .mrfw-pathCopyIcon,\n.mrfw-pathCopy:focus-visible .mrfw-pathCopyIcon {\n  opacity: 1;\n}\n\n.mrfw-note {\n  margin: 0;\n  font-size: 12px;\n  line-height: 18px;\n  color: var(--dsw-alias-label-tertiary);\n}\n\n.mrfw-stateWarn {\n  font-size: 12px;\n  line-height: 18px;\n  color: var(--dsw-alias-state-warn-primary);\n}\n\n.mrfw-btn {\n  display: inline-flex;\n  flex: none;\n  align-items: center;\n  justify-content: center;\n  gap: 4px;\n  height: 28px;\n  padding: 0 10px;\n  border: none;\n  border-radius: 14px;\n  background: transparent;\n  color: var(--dsw-alias-label-primary);\n  font-family: inherit;\n  font-size: 12px;\n  line-height: 18px;\n  cursor: pointer;\n  transition: background-color var(--ds-transition-duration-fast) var(--ds-ease-in-out);\n}\n\n.mrfw-btn[aria-busy='true'] {\n  cursor: wait;\n}\n\n.mrfw-btn:disabled {\n  cursor: not-allowed;\n  opacity: 0.4;\n}\n\n.mrfw-btnGhost:hover:not(:disabled) {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.mrfw-btnGhost:active:not(:disabled) {\n  background: var(--dsw-alias-interactive-bg-active);\n}\n\n/* The solid destructive action of the capsule family: the upgrade confirm's\n   red button. state-error-primary is the error ink upstream also uses as a\n   fill (StateDot); the hover mixes in the host's primary label token to\n   follow its theme and contrast choices. Neither color is a guessed token:\n   an undefined var() would fall back\n   to transparent and white-out the whole button. */\n.mrfw-btnDanger {\n  background: var(--dsw-alias-state-error-primary);\n  color: var(--dsw-alias-label-primary-foreground);\n}\n\n.mrfw-btnDanger:hover:not(:disabled) {\n  background: color-mix(in srgb, var(--dsw-alias-state-error-primary) 85%, var(--dsw-alias-label-primary));\n}\n\n.mrfw-btnOutline {\n  border: 0.5px solid var(--dsw-alias-border-l3);\n  background: transparent;\n}\n\n.mrfw-btnOutline:hover:not(:disabled) {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.mrfw-btnPrimary {\n  background: var(--dsw-alias-button-primary-fill);\n  color: var(--dsw-alias-label-primary-foreground);\n}\n\n.mrfw-btnPrimary:hover:not(:disabled) {\n  background: var(--dsw-alias-button-primary-hover);\n}\n\n/* One icon-only action: a square of the capsule family, meaning in title.\n   Declared after the .mrfw-btn family so its padding wins the cascade tie:\n   the capsule's 0 10px padding would otherwise squeeze the icon glyph. */\n.mrfw-iconBtn {\n  width: 28px;\n  padding: 0;\n  border-radius: 8px;\n}\n\n.mrfw-input {\n  flex: 1 1 220px;\n  min-width: 0;\n  height: 32px;\n  padding: 0 8px;\n  border: 0.5px solid var(--dsw-alias-border-l4);\n  border-radius: 8px;\n  background: var(--dsw-alias-bg-layer-1);\n  color: var(--dsw-alias-label-primary);\n  font-family: inherit;\n  font-size: 14px;\n  line-height: 22px;\n  outline: none;\n  transition: border-color var(--ds-transition-duration-fast) var(--ds-ease-in-out);\n}\n\n.mrfw-input:focus {\n  border-color: var(--dsw-alias-brand-primary);\n}\n\n.mrfw-input::placeholder {\n  color: var(--dsw-alias-label-dimmed);\n}\n\n.mrfw-inputInline {\n  flex: 1 1 auto;\n}\n\n.mrfw-accessSelect {\n  flex: 0 0 auto;\n}\n\n/* The access dropdown's capsule trigger: the Menu anchor wrapper is the flex\n   item, the button inside keeps the control row's 32px capsule recipe. */\n.mrfw-accessTrigger {\n  padding: 0 12px;\n}\n\n.mrfw-cwdTag {\n  flex: none;\n  padding: 0 6px;\n  border-radius: 4px;\n  background: var(--dsw-alias-interactive-bg-hover);\n  color: var(--dsw-alias-label-secondary);\n  font-size: 11px;\n  line-height: 18px;\n}\n\n.mrfw-accessBadge {\n  display: inline-flex;\n  align-items: center;\n  gap: 4px;\n}\n\n.mrfw-accessBadge {\n  flex: none;\n  font-size: 12px;\n  line-height: 18px;\n  color: var(--dsw-alias-label-tertiary);\n}\n\n.mrfw-aliasEditor {\n  display: flex;\n  flex-wrap: wrap;\n  gap: 8px;\n  flex-basis: 100%;\n}\n\n.mrfw-actions {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  gap: 8px;\n  margin-top: 16px;\n  padding-top: 16px;\n  border-top: 0.5px solid var(--dsw-alias-border-l2);\n}\n\n/* One control row, one height: the capsule buttons match the 32px input. */\n.mrfw-actions .mrfw-btn {\n  height: 32px;\n  border-radius: 16px;\n}\n\n.mrfw-actions .mrfw-iconBtn {\n  width: 32px;\n}\n";

package/lib/types/command.d.ts

@@ -37,7 +37,7 @@ export declare const COMMAND_NAME = "workspace-folders";
 /** One parsed command line. */
 export interface FoldersCommand {
     /** The subcommand; `list` when the line named none. */
-    readonly verb: 'list' | 'add' | 'remove' | 'alias' | 'access' | 'reveal' | 'isolate-profiles' | 'help';
+    readonly verb: 'list' | 'add' | 'remove' | 'alias' | 'alias-id' | 'skills' | 'access' | 'reveal' | 'isolate-profiles' | 'help';
     /** Everything after the verb, verbatim (paths may contain spaces). */
     readonly rest: string;
 }

package/lib/types/compat/client-session.d.ts

@@ -32,3 +32,5 @@
 export declare function currentSessionIdOf(sessions: unknown): string | undefined;
 /** Observe native catalog changes when this surface provides a subscribable store. */
 export declare function subscribeSessions(sessions: unknown, listener: () => void): () => void;
+/** Selection changes only: activity/title updates must not close a Skill preview. */
+export declare function subscribeCurrentSession(sessions: unknown, listener: () => void): () => void;

package/lib/types/compat/dsh-version.d.ts

@@ -28,7 +28,7 @@
  * the upgrade smoke passed on that exact version — a green CI run on an
  * unlisted release is evidence, not authorization (ADR-0009).
  */
-export declare const SUPPORTED_DSH_RELEASES: readonly ["0.1.5-rc.2", "0.1.6-alpha.1", "0.1.6-alpha.2", "0.1.7-alpha.1", "0.1.7-alpha.2", "0.1.7-rc.1", "0.1.7-rc.2", "0.2.0-rc.1", "0.2.0-rc.2", "0.2.1-alpha.1", "0.2.1-alpha.2", "0.2.1-alpha.3", "0.2.1-alpha.4", "0.2.1-alpha.5", "0.2.1-rc.1", "0.2.1-rc.2"];
+export declare const SUPPORTED_DSH_RELEASES: readonly ["0.1.5-rc.2", "0.1.6-alpha.1", "0.1.6-alpha.2", "0.1.7-alpha.1", "0.1.7-alpha.2", "0.1.7-rc.1", "0.1.7-rc.2", "0.2.0-rc.1", "0.2.0-rc.2", "0.2.1-alpha.1", "0.2.1-alpha.2", "0.2.1-alpha.3", "0.2.1-alpha.4", "0.2.1-alpha.5", "0.2.1-rc.1", "0.2.1-rc.2", "0.2.1-rc.3"];
 /** One release this plugin claims to support. */
 export type SupportedDshRelease = typeof SUPPORTED_DSH_RELEASES[number];
 /**
@@ -42,7 +42,7 @@ export declare const REQUIRED_CORE_PACKAGES: readonly ["@deepseek-ai/dsh-fs", "@
  * Absence is fine; a version that DISAGREES with the required packages is not —
  * that is the mixed-installation failure this contract exists to catch.
  */
-export declare const OPTIONAL_CORE_PACKAGES: readonly ["@deepseek-ai/dsh-tools", "@deepseek-ai/dsh-working-directory", "@deepseek-ai/dsh-lsp", "@deepseek-ai/dsh-lsp-stdio", "@deepseek-ai/dsh-api-workspace-files", "@deepseek-ai/dsh-typert-protocol", "@deepseek-ai/dsh-sandbox-windows-acl", "@deepseek-ai/dsh-agent", "@deepseek-ai/dsh-agent-instructions", "@deepseek-ai/dsh-client-connection", "@deepseek-ai/dsh-commands", "@deepseek-ai/dsh-llm", "@deepseek-ai/dsh-session", "@deepseek-ai/dsh-subprocess", "@deepseek-ai/dsh-system-prompt"];
+export declare const OPTIONAL_CORE_PACKAGES: readonly ["@deepseek-ai/dsh-skill", "@deepseek-ai/dsh-skill-filesystem", "@deepseek-ai/dsh-settings", "@deepseek-ai/dsh-api-session-controller", "@deepseek-ai/dsh-session-query", "@deepseek-ai/dsh-tools", "@deepseek-ai/dsh-working-directory", "@deepseek-ai/dsh-lsp", "@deepseek-ai/dsh-lsp-stdio", "@deepseek-ai/dsh-api-workspace-files", "@deepseek-ai/dsh-typert-protocol", "@deepseek-ai/dsh-sandbox-windows-acl", "@deepseek-ai/dsh-agent", "@deepseek-ai/dsh-agent-instructions", "@deepseek-ai/dsh-client-connection", "@deepseek-ai/dsh-commands", "@deepseek-ai/dsh-llm", "@deepseek-ai/dsh-session", "@deepseek-ai/dsh-subprocess", "@deepseek-ai/dsh-system-prompt"];
 /**
  * The optional packages this plugin loads itself at run time, through dynamic
  * `import()`s inside this package's own modules. The copy this module resolves
@@ -50,7 +50,7 @@ export declare const OPTIONAL_CORE_PACKAGES: readonly ["@deepseek-ai/dsh-tools",
  * private copy inside this package's own tree genuinely loads, and a version
  * that disagrees with the host is a real mixed installation, not a phantom.
  */
-export declare const RUNTIME_OPTIONAL_PACKAGES: readonly ["@deepseek-ai/dsh-agent-instructions", "@deepseek-ai/dsh-llm", "@deepseek-ai/dsh-session", "@deepseek-ai/dsh-typert-protocol"];
+export declare const RUNTIME_OPTIONAL_PACKAGES: readonly ["@deepseek-ai/dsh-skill", "@deepseek-ai/dsh-skill-filesystem", "@deepseek-ai/dsh-agent-instructions", "@deepseek-ai/dsh-llm", "@deepseek-ai/dsh-session", "@deepseek-ai/dsh-typert-protocol"];
 /**
  * The optional packages this plugin consumes only as mounted host services or
  * ambient types — it never imports them, so a copy inside this package's own
@@ -64,7 +64,7 @@ export declare const RUNTIME_OPTIONAL_PACKAGES: readonly ["@deepseek-ai/dsh-agen
  * devDependencies on a `0.2.0-rc.2` host produced a `mixed` verdict on a
  * uniformly `0.2.0-rc.2` installation).
  */
-export declare const HOST_SERVICE_PACKAGES: readonly ["@deepseek-ai/dsh-agent", "@deepseek-ai/dsh-api-workspace-files", "@deepseek-ai/dsh-client-connection", "@deepseek-ai/dsh-commands", "@deepseek-ai/dsh-lsp", "@deepseek-ai/dsh-lsp-stdio", "@deepseek-ai/dsh-subprocess", "@deepseek-ai/dsh-system-prompt", "@deepseek-ai/dsh-tools", "@deepseek-ai/dsh-working-directory"];
+export declare const HOST_SERVICE_PACKAGES: readonly ["@deepseek-ai/dsh-settings", "@deepseek-ai/dsh-api-session-controller", "@deepseek-ai/dsh-session-query", "@deepseek-ai/dsh-agent", "@deepseek-ai/dsh-api-workspace-files", "@deepseek-ai/dsh-client-connection", "@deepseek-ai/dsh-commands", "@deepseek-ai/dsh-lsp", "@deepseek-ai/dsh-lsp-stdio", "@deepseek-ai/dsh-subprocess", "@deepseek-ai/dsh-system-prompt", "@deepseek-ai/dsh-tools", "@deepseek-ai/dsh-working-directory"];
 /**
  * Optional packages this plugin executes that are resolved through an anchor
  * OTHER than this module. The standalone Windows ACL runner
@@ -79,7 +79,7 @@ export declare const HOST_SERVICE_PACKAGES: readonly ["@deepseek-ai/dsh-agent",
  */
 export declare const RUNNER_ANCHORED_PACKAGES: readonly ["@deepseek-ai/dsh-sandbox-windows-acl"];
 /** Every package the contract inspects, required first. */
-export declare const CORE_PACKAGES: readonly ["@deepseek-ai/dsh-fs", "@deepseek-ai/dsh-fs-local", "@deepseek-ai/dsh-sandbox", "@deepseek-ai/dsh-sandbox-local", "@deepseek-ai/dsh-sandbox-policy", "@deepseek-ai/dsh-storage-domain", "@deepseek-ai/dsh-tools", "@deepseek-ai/dsh-working-directory", "@deepseek-ai/dsh-lsp", "@deepseek-ai/dsh-lsp-stdio", "@deepseek-ai/dsh-api-workspace-files", "@deepseek-ai/dsh-typert-protocol", "@deepseek-ai/dsh-sandbox-windows-acl", "@deepseek-ai/dsh-agent", "@deepseek-ai/dsh-agent-instructions", "@deepseek-ai/dsh-client-connection", "@deepseek-ai/dsh-commands", "@deepseek-ai/dsh-llm", "@deepseek-ai/dsh-session", "@deepseek-ai/dsh-subprocess", "@deepseek-ai/dsh-system-prompt"];
+export declare const CORE_PACKAGES: readonly ["@deepseek-ai/dsh-fs", "@deepseek-ai/dsh-fs-local", "@deepseek-ai/dsh-sandbox", "@deepseek-ai/dsh-sandbox-local", "@deepseek-ai/dsh-sandbox-policy", "@deepseek-ai/dsh-storage-domain", "@deepseek-ai/dsh-skill", "@deepseek-ai/dsh-skill-filesystem", "@deepseek-ai/dsh-settings", "@deepseek-ai/dsh-api-session-controller", "@deepseek-ai/dsh-session-query", "@deepseek-ai/dsh-tools", "@deepseek-ai/dsh-working-directory", "@deepseek-ai/dsh-lsp", "@deepseek-ai/dsh-lsp-stdio", "@deepseek-ai/dsh-api-workspace-files", "@deepseek-ai/dsh-typert-protocol", "@deepseek-ai/dsh-sandbox-windows-acl", "@deepseek-ai/dsh-agent", "@deepseek-ai/dsh-agent-instructions", "@deepseek-ai/dsh-client-connection", "@deepseek-ai/dsh-commands", "@deepseek-ai/dsh-llm", "@deepseek-ai/dsh-session", "@deepseek-ai/dsh-subprocess", "@deepseek-ai/dsh-system-prompt"];
 /** How this plugin reacts to an installation it does not support. */
 export type CompatEnforcement = 'enforce' | 'warn';
 /** The environment variable that relaxes the gate. */

package/lib/types/compat/skill-content.d.ts

@@ -0,0 +1,3 @@
+/** Native rendering is loaded only when a namespaced invocation delivers a body. */
+import type { SkillDefinition } from '@deepseek-ai/dsh-skill';
+export declare function renderAdditionalSkill(skill: SkillDefinition): Promise<string>;

package/lib/types/compat/skills-client.d.ts

@@ -0,0 +1,33 @@
+/** Structural client seams: older hosts have namespace forms and no UserTextRule registry. */
+import type { Context } from '@deepseek-ai/cordis';
+export interface SkillsForm {
+    getSnapshot(): {
+        value?: {
+            enabled?: boolean;
+        } | undefined;
+        status: string;
+        writable: boolean;
+        revision?: number | undefined;
+    };
+    subscribe(listener: () => void): () => void;
+    mutate(ops: readonly {
+        op: 'set';
+        path: string[];
+        value: boolean;
+    }[], revision?: number): Promise<boolean>;
+}
+export declare function bindSkillsForm(ctx: Context): SkillsForm | undefined;
+export declare function clientInject(ctx: Context, services: string[], callback: (scope: Context) => void | (() => void)): void;
+export interface NamespaceRule {
+    id: string;
+    order: number;
+    match(text: string, from: number): {
+        id: string;
+        start: number;
+        end: number;
+        data: {
+            name: string;
+        };
+    } | undefined;
+}
+export declare function registerNamespaceRule(ctx: Context, rule: NamespaceRule): (() => void) | undefined;

package/lib/types/compat/skills-settings.d.ts

@@ -0,0 +1,8 @@
+/** Legacy namespace sections and modern volatile Config forms share one live switch. */
+import type { Context, Fiber } from '@deepseek-ai/cordis';
+export declare const SKILLS_SETTINGS_ID = "multi-root-skills";
+export declare const SKILLS_BUNDLE_KEY = "@dsh-electron/dsh-plugin-multi-root-workspace";
+export declare function installSkillsSettings(ctx: Context, initial: () => unknown, changed: () => void): {
+    read(): unknown;
+    fiber: Fiber;
+};

package/lib/types/compat/skills.d.ts

@@ -0,0 +1,13 @@
+/** Public native Skills seams. All borrowed-scope and optional-package coupling lives here. */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { SkillLookupOptions } from '@deepseek-ai/dsh-skill';
+/** Never infer authority from cwd, a preset key, or a lookalike Agent. */
+export declare function skillAgent(ctx: Context, options: SkillLookupOptions): Agent | undefined;
+export declare function skillOrigin(ctx: Context, options: SkillLookupOptions): string | undefined;
+/** Absence is optional; a present but broken module must fail visibly. */
+export declare function filesystemSkillsApi(): Promise<typeof import('@deepseek-ai/dsh-skill-filesystem') | undefined>;
+export declare function volatileField<S>(schema: S): S;
+export declare function configValue(value: unknown): unknown;
+/** Cold Browser Catalog supplies a Session header, never a fabricated Agent. */
+export declare function observedSkillOrigin(ctx: Context, sessionId: string): Promise<string>;

package/lib/types/compat/storage-zod.d.ts

@@ -49,6 +49,7 @@ interface DomainZodModule {
         optional(): any;
     };
     array(item: unknown): any;
+    unknown(): any;
 }
 /**
  * The `z` namespace as the installed `@deepseek-ai/dsh-storage-domain`

package/lib/types/contract.d.ts

@@ -28,10 +28,15 @@
  *
  * @module @dsh-electron/dsh-plugin-multi-root-workspace/contract
  */
+import type { SkillsResponseMap } from './skills-contract.ts';
+export { SKILLS_ENDPOINTS, skillsRequestSchema, skillsCatalogSchema, skillsPreviewSchema, skillsStatusSchema } from './skills-contract.ts';
+export type { SkillsEndpoint, SkillsStatusView, SkillsCatalogView, SkillsPreviewView } from './skills-contract.ts';
+export interface WorkspaceResponseMap extends PanelResponseMap, SkillsResponseMap {
+}
 /** The absolute logical channel both halves speak over. */
 export declare const PANEL_CHANNEL = "/multi-root-workspace";
 /** Endpoint names, relative to {@link PANEL_CHANNEL}. */
-export type PanelEndpoint = 'list' | 'add' | 'remove' | 'alias' | 'move' | 'setAccess' | 'reveal';
+export type PanelEndpoint = 'list' | 'add' | 'remove' | 'alias' | 'move' | 'setAccess' | 'setSkillsEnabled' | 'setAliasId' | 'reveal';
 /** Every endpoint name, for exhaustive iteration in tests and callers. */
 export declare const PANEL_ENDPOINTS: readonly PanelEndpoint[];
 /**
@@ -61,6 +66,8 @@ export interface RootView {
     /** Canonical absolute directory. */
     readonly path: string;
     /** Display alias as stored; absent when cleared. */
+    readonly aliasId?: string;
+    readonly skillsEnabled?: boolean;
     readonly alias?: string;
     /** ISO-8601 registration instant. */
     readonly addedAt: string;
@@ -119,6 +126,8 @@ export interface PanelResponseMap {
     readonly remove: RootsView;
     readonly alias: RootsView;
     readonly move: RootsView;
+    readonly setSkillsEnabled: RootsView;
+    readonly setAliasId: RootsView;
     readonly setAccess: RootsView;
     readonly reveal: RevealedView;
 }
@@ -138,6 +147,8 @@ export interface PanelRequest {
     /** Candidate directory (add). */
     readonly path?: string;
     /** Display alias (add/alias); empty clears it. */
+    readonly aliasId?: string;
+    readonly skillsEnabled?: boolean;
     readonly alias?: string;
     /** Write authority (add — defaults to `inherit` — and setAccess). */
     readonly access?: RootAccess;

package/lib/types/registry.d.ts

@@ -146,6 +146,8 @@ type PersistedRoot = {
     readOnlyRecordedPath?: string | undefined;
     readWriteRecordedPath?: string | undefined;
     alias?: string | undefined;
+    aliasId?: unknown;
+    skillsEnabled?: unknown;
     addedAt: string;
 };
 /**
@@ -347,6 +349,10 @@ export declare class MultiRootRegistry extends Service {
      * @throws {RootValidationError} `not-found`/`invalid-alias`.
      */
     setAlias(primaryRoot: string, ref: RootRef, alias: string | undefined): Promise<readonly RootStatus[]>;
+    /** Change a Skill switch without changing any grant field. */
+    setSkillsEnabled(primaryRoot: string, ref: RootRef, skillsEnabled: boolean): Promise<readonly RootStatus[]>;
+    setAliasId(primaryRoot: string, ref: RootRef, aliasId: string): Promise<readonly RootStatus[]>;
+    private setSkillsMetadata;
     /**
      * Move one registration within the display order.
      * @param primaryRoot - the session workspace root the root belongs to.
@@ -438,6 +444,7 @@ export declare class MultiRootRegistry extends Service {
      * under a shared byte budget, so a move must update the live scope immediately.
      * Aliases and no-op moves still leave the signature unchanged.
      */
+    private readonly metadataPublished;
     private publish;
     /**
      * The open table.

package/lib/types/roots.d.ts

@@ -105,6 +105,9 @@ export interface RegisteredRoot {
     readonly readWriteRecordedPath?: string;
     /** Optional display alias; absent when the operator cleared it. */
     readonly alias?: string;
+    /** Untrusted stored metadata; consumers must validate both fields and uniqueness. */
+    readonly aliasId?: unknown;
+    readonly skillsEnabled?: unknown;
     /** ISO-8601 instant of registration. */
     readonly addedAt: string;
 }
@@ -169,7 +172,7 @@ export type RootRef = {
     readonly addedAt: string;
 };
 /** Every way root handling can fail, as a stable code the surfaces localize. */
-export type RootValidationCode = 'not-absolute' | 'missing' | 'not-a-directory' | 'equals-primary' | 'primary-overlap' | 'duplicate' | 'nested' | 'invalid-alias' | 'not-found' | 'invalid-ref' | 'storage-unavailable' | 'registry-contended' | 'root-limit-reached' | 'config-invalid' | 'reveal-unavailable' | 'session-not-found' | 'unsupported-path' | 'root-unavailable';
+export type RootValidationCode = 'not-absolute' | 'missing' | 'not-a-directory' | 'equals-primary' | 'primary-overlap' | 'duplicate' | 'nested' | 'invalid-alias' | 'invalid-alias-id' | 'not-found' | 'invalid-ref' | 'storage-unavailable' | 'registry-contended' | 'root-limit-reached' | 'config-invalid' | 'reveal-unavailable' | 'session-not-found' | 'unsupported-path' | 'root-unavailable';
 /** A rejected root operation; `code` is the stable contract, `message` the fallback prose. */
 export declare class RootValidationError extends Error {
     readonly code: RootValidationCode;

package/lib/types/skills/catalog.d.ts

@@ -0,0 +1,34 @@
+import { SkillReaderPool } from './pool.ts';
+import type { Context } from '@deepseek-ai/cordis';
+import type { SkillCandidate, SkillLookupOptions, SkillDefinition } from '@deepseek-ai/dsh-skill';
+import type { RootStatus } from '../roots.ts';
+import { rootReader } from './reader.ts';
+export declare const SKILLS_PROVIDER = "multi-root-workspace";
+export declare function internalSkillName(primary: string, rootId: string, skillName: string): string;
+export interface LocatedSkill {
+    readonly primary: string;
+    readonly rootId: string;
+    readonly aliasId: string;
+    readonly candidate: SkillCandidate;
+}
+export type Reader = NonNullable<Awaited<ReturnType<typeof rootReader>>>;
+export declare class AdditionalSkillCatalog {
+    private readonly ctx;
+    private readonly signal;
+    private readonly enabled;
+    private readonly generation;
+    private readonly loadedReceipts;
+    private readonly locators;
+    private readonly requests;
+    readonly pool: SkillReaderPool;
+    constructor(ctx: Context, signal: AbortSignal, enabled: () => boolean, generation?: () => number, invalidate?: () => void);
+    /** Read synchronously after awaited receipt checks, immediately before batch delivery. */
+    get revision(): number;
+    current(primary: string, id: string): RootStatus | undefined;
+    private withReader;
+    list(primary: string, options: SkillLookupOptions): Promise<SkillCandidate[]>;
+    /** Locators are created here and are not accepted from a client path or object. */
+    load(primary: string, entry: SkillCandidate, options: SkillLookupOptions, user: boolean): Promise<SkillDefinition | undefined>;
+    admissionValid(definition: SkillDefinition): Promise<boolean>;
+    dispose(): Promise<void>;
+}

package/lib/types/skills/invocation.d.ts

@@ -0,0 +1,7 @@
+/** Host-only explicit gesture parsing. External messages cannot forge user intent. */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { AdditionalSkillCatalog, LocatedSkill } from './catalog.ts';
+export declare function installSkillInvocations(ctx: Context, catalog: AdditionalSkillCatalog, known: WeakMap<Agent, Map<string, LocatedSkill>>): void;
+/** The tracked identity is an Agent object, never a process-global current Session. */
+export type SkillCaller = Agent;

package/lib/types/skills/metadata.d.ts

@@ -0,0 +1,13 @@
+export interface SkillsMetadata {
+    readonly id: string;
+    readonly path: string;
+    readonly alias?: string | undefined;
+    readonly aliasId?: unknown;
+    readonly skillsEnabled?: unknown;
+    readonly readOnlyRecordedPath?: string | undefined;
+}
+export declare function validAliasId(value: unknown): value is string;
+export declare function skillsMetadataValid(row: SkillsMetadata, rows: readonly SkillsMetadata[]): boolean;
+export declare function validateAliasId(value: string, others: readonly SkillsMetadata[]): string;
+/** Missing metadata is legacy; malformed supplied metadata is preserved and withheld. */
+export declare function migrateRootSkills<T extends SkillsMetadata>(rows: readonly T[]): T[];

package/lib/types/skills/pool.d.ts

@@ -0,0 +1,19 @@
+import type { Reader } from './catalog.ts';
+export declare class SkillReaderPool {
+    private readonly invalidate;
+    readonly capacity: number;
+    private readonly entries;
+    private readonly waiters;
+    private closing;
+    private polling;
+    private readonly timer;
+    constructor(invalidate: () => void, capacity?: number, intervalMs?: number);
+    get size(): number;
+    get roots(): readonly string[];
+    use<T>(key: string, create: (signal: AbortSignal) => Promise<Reader | undefined>, run: (reader: Reader | undefined) => Promise<T>, signal?: AbortSignal): Promise<T>;
+    poll(): Promise<void>;
+    dispose(): Promise<void>;
+    private closeEntry;
+}
+/** No symlink target outside the Root is read or enumerated. Content reads stay on demand. */
+export declare function skillTreeStamp(root: string): Promise<string>;

package/lib/types/skills/reader.d.ts

@@ -0,0 +1,3 @@
+import type { Context } from '@deepseek-ai/cordis';
+export declare function containsPath(root: string, target: string): boolean;
+export declare function rootReader(ctx: Context, root: string, signal: AbortSignal, valid: () => boolean): Promise<import("@deepseek-ai/dsh-skill-filesystem").FileSystemSkillProvider | undefined>;

package/lib/types/skills/routing.d.ts

@@ -0,0 +1,2 @@
+import type { Context, Fiber } from '@deepseek-ai/cordis';
+export declare function installSkillRouting(ctx: Context): readonly Fiber[];