@dsh-workbench/shared 1.1.7 → 1.1.9

package/dist/api/blocker-table.d.ts

@@ -12,6 +12,7 @@ import type { ModuleBlocker } from '../contract/blocker.js';
 export declare function blockerOfError(error: ApiError | undefined, t: Translate, context?: {
     path?: string | null;
     platform?: string;
+    diagnose?: Readonly<Partial<Record<'exec' | 'login' | 'bridge', string>>>;
 }): ModuleBlocker;
 /**
  * 把宿主回的环境读数翻成卡住态：探针没查过（unchecked）只算提示，不挡卡片。

package/dist/api/blocker-table.js

@@ -74,7 +74,7 @@ export function blockerOfError(error, t, context = {}) {
                 id: 'cli-exec-failed',
                 severity: 'block',
                 title: error.message,
-                hint: error.hint ?? t('blocker.exec.hint'),
+                hint: error.hint ?? context.diagnose?.exec ?? t('blocker.exec.hint'),
                 ...(error.detail === undefined ? {} : { detail: error.detail }),
                 actions: [retryAction(t)],
             };

package/dist/components/SelectField.css

@@ -70,12 +70,6 @@
   justify-content: center;
 }
 
-.wb-selectReveal {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-}
-
 .wb-selectIconOnly .wb-selectIcon {
   width: 100%;
   height: 100%;

package/dist/components/SelectField.d.ts

@@ -47,7 +47,6 @@ export interface SelectFieldProps {
     readonly selection?: 'check' | 'fill' | undefined;
     readonly variant?: 'ghost' | 'boxed' | undefined;
     readonly iconOnly?: boolean | undefined;
-    readonly revealId?: string | undefined;
     readonly ariaLabel?: string | undefined;
     readonly title?: string | undefined;
     readonly id?: string | undefined;
@@ -65,8 +64,8 @@ export declare function filterSelectOptions(options: readonly SelectFieldOption[
 export declare function selectCursorValue(shown: readonly SelectFieldOption[], cursor: number | null): string | null;
 /** 按上下键移动游标（两头环绕）：还没选过时向下取第一项、向上取最后一项；列表为空回 `null`（一步都动不了）。`step` 1 向下、-1 向上。 */
 export declare function stepSelectCursor(shown: readonly SelectFieldOption[], cursor: number | null, step: 1 | -1): number | null;
-/** 把候选排成 `Menu` 要的条目表：按 `group` 插分组标题；一项都没有时退回 `emptyText` 那一行（不给就是空表）。`revealId` 是开列表时要滚进可视区的那个 value。 */
-export declare function selectEntries(shown: readonly SelectFieldOption[], emptyText: string | undefined, revealId?: string | undefined): readonly MenuEntry[];
+/** 把候选排成 `Menu` 要的条目表：按 `group` 插分组标题；一项都没有时退回 `emptyText` 那一行（不给就是空表）。 */
+export declare function selectEntries(shown: readonly SelectFieldOption[], emptyText: string | undefined): readonly MenuEntry[];
 /**
  * 下拉选择：默认是跟 `TextField` 一套的常规下拉框（不是原生 `<select>`），无边框那种给 `variant: 'ghost'`。
  * `open` 不给就内部自己管（两种接法下 `onOpenChange` 都会通知），`loading` 把触发器换成转圈 + `loadingText`（默认 `…`），

package/dist/components/SelectField.js

@@ -12,35 +12,14 @@ function mergeClass(...parts) {
 function triggerClassOf(variantClass, iconOnly) {
     return mergeClass('wb-selectTrigger', variantClass, iconOnly ? 'wb-selectIconOnly' : undefined);
 }
-function itemOf(option, revealId) {
-    const mark = option.value === revealId;
-    if (!mark) {
-        return {
-            id: option.value,
-            label: option.label,
-            ...(option.icon === undefined ? {} : { icon: option.icon }),
-            ...(option.disabled === true ? { disabled: true } : {}),
-        };
-    }
-    const revealed = (node) => (h("span", { className: "wb-selectReveal", "data-wb-select-reveal": "" }, node));
+function itemOf(option) {
     return {
         id: option.value,
-        label: option.icon === undefined ? revealed(option.label) : option.label,
-        ...(option.icon === undefined ? {} : { icon: revealed(option.icon) }),
+        label: option.label,
+        ...(option.icon === undefined ? {} : { icon: option.icon }),
         ...(option.disabled === true ? { disabled: true } : {}),
     };
 }
-function revealNode() {
-    const found = document.querySelector('[data-wb-select-reveal]');
-    return found instanceof HTMLElement ? found : null;
-}
-function useRevealOnOpen(open, revealId) {
-    useEffect(() => {
-        if (!open || revealId === undefined)
-            return;
-        revealNode()?.scrollIntoView({ block: 'nearest' });
-    }, [open, revealId]);
-}
 function selectValueNode(current, renderValue, placeholder) {
     if (current === undefined) {
         return h("span", { className: "wb-selectPlaceholder" }, placeholder ?? '—');
@@ -101,8 +80,8 @@ export function stepSelectCursor(shown, cursor, step) {
         return step === 1 ? 0 : shown.length - 1;
     return (cursor + step + shown.length) % shown.length;
 }
-/** 把候选排成 `Menu` 要的条目表：按 `group` 插分组标题；一项都没有时退回 `emptyText` 那一行（不给就是空表）。`revealId` 是开列表时要滚进可视区的那个 value。 */
-export function selectEntries(shown, emptyText, revealId) {
+/** 把候选排成 `Menu` 要的条目表：按 `group` 插分组标题；一项都没有时退回 `emptyText` 那一行（不给就是空表）。 */
+export function selectEntries(shown, emptyText) {
     if (shown.length === 0) {
         return emptyText === undefined ? [] : [{ type: 'label', id: EMPTY_ID, text: emptyText }];
     }
@@ -113,7 +92,7 @@ export function selectEntries(shown, emptyText, revealId) {
             out.push({ type: 'label', id: `__wb-select-group-${String(out.length)}`, text: option.group });
             group = option.group;
         }
-        out.push(itemOf(option, revealId));
+        out.push(itemOf(option));
     }
     return out;
 }
@@ -193,10 +172,9 @@ function useSelectState(props) {
  * @returns 触发器，以及打开时的搜索框与列表。
  */
 export function SelectField(props) {
-    const { value, options, onChange, label, hint, icon, renderValue, placeholder, search = true, searchLabel, searchPlaceholder, footer, onFooter, disabled = false, invalid = false, loading = false, loadingText, fallback, selection = 'fill', variant = 'boxed', iconOnly = false, revealId, ariaLabel, title, id, name, className, menuClassName, } = props;
+    const { value, options, onChange, label, hint, icon, renderValue, placeholder, search = true, searchLabel, searchPlaceholder, footer, onFooter, disabled = false, invalid = false, loading = false, loadingText, fallback, selection = 'fill', variant = 'boxed', iconOnly = false, ariaLabel, title, id, name, className, menuClassName, } = props;
     const state = useSelectState(props);
     const current = options.find((option) => option.value === value);
-    useRevealOnOpen(state.open, revealId);
     const variantClass = variant === 'ghost' ? 'wb-selectGhost' : undefined;
     const triggerClass = triggerClassOf(variantClass, iconOnly);
     if (loading) {
@@ -217,6 +195,7 @@ export function SelectField(props) {
         value: selectValueNode(current, renderValue, placeholder),
         iconOnly,
         onOpen: () => state.setOpen(true),
+        ref: state.triggerRef,
     });
     const anchor = state.open && search
         ? searchNode({
@@ -255,7 +234,7 @@ export function SelectField(props) {
         anchor,
         selection,
         selectedId: selectCursorValue(state.shown, state.cursor) ?? undefined,
-        items: selectEntries(state.shown, state.empty, revealId),
+        items: selectEntries(state.shown, state.empty),
         footer: footer === undefined
             ? undefined
             : [

package/dist/components/SelectFieldNodes.d.ts

@@ -1,4 +1,4 @@
-import type { ReactNode } from 'react';
+import type { ReactNode, Ref } from 'react';
 /**
  * 下拉触发器那颗按钮：图标 + 当前值 + 箭头，交给 `Menu` 当 anchor；宽窄两档共用一个形状。
  * @param args.id - 触发器 id。
@@ -12,6 +12,7 @@ import type { ReactNode } from 'react';
  * @param args.value - 已渲染好的当前值节点（文本或占位）。
  * @param args.iconOnly - 只画图标（窄栏那颗切换钮），值与箭头都不画。
  * @param args.onOpen - 点它做什么，通常是把列表打开。
+ * @param args.ref - 挂到这颗 `<button>` 上，取消后回焦点、菜单开着头条滚轮要用它。
  * @returns 一颗 `<button>`。
  */
 export declare function selectTriggerNode(args: {
@@ -26,6 +27,7 @@ export declare function selectTriggerNode(args: {
     readonly value: ReactNode;
     readonly iconOnly: boolean;
     readonly onOpen: () => void;
+    readonly ref: Ref<HTMLButtonElement> | undefined;
 }): ReactNode;
 /**
  * 名单还没读到时的触发器：禁用 + `aria-busy` 的按钮，`SelectField` 在 `loading` 那档画它。

package/dist/components/SelectFieldNodes.js

@@ -14,10 +14,11 @@ import { Spinner } from './Spinner.js';
  * @param args.value - 已渲染好的当前值节点（文本或占位）。
  * @param args.iconOnly - 只画图标（窄栏那颗切换钮），值与箭头都不画。
  * @param args.onOpen - 点它做什么，通常是把列表打开。
+ * @param args.ref - 挂到这颗 `<button>` 上，取消后回焦点、菜单开着头条滚轮要用它。
  * @returns 一颗 `<button>`。
  */
 export function selectTriggerNode(args) {
-    return (h("button", { type: "button", id: args.id, className: args.className, disabled: args.disabled, "aria-haspopup": "listbox", "aria-expanded": args.open, "aria-invalid": args.invalid || undefined, "aria-label": args.ariaLabel, title: args.title, onClick: args.onOpen }, args.iconOnly ? (h("span", { className: "wb-selectIcon" }, args.icon)) : (h(Fragment, null,
+    return (h("button", { type: "button", ref: args.ref, id: args.id, className: args.className, disabled: args.disabled, "aria-haspopup": "listbox", "aria-expanded": args.open, "aria-invalid": args.invalid || undefined, "aria-label": args.ariaLabel, title: args.title, onClick: args.onOpen }, args.iconOnly ? (h("span", { className: "wb-selectIcon" }, args.icon)) : (h(Fragment, null,
         args.icon === undefined ? null : h("span", { className: "wb-selectIcon" }, args.icon),
         h("span", { className: "wb-selectValue" }, args.value),
         h("span", { className: "wb-selectChevron" },

package/dist/components/SelectFieldWheel.d.ts

@@ -0,0 +1,9 @@
+import type { RefObject } from 'react';
+/**
+ * 菜单开着时，滚轮落在「头条」（搜索框 / 触发钮）上也滚列表：点开菜单后指针还停在原来那个点上，
+ * 第一下滚动不该没有反应。列表自己那一格照旧由 dsh 的 `Menu` 滚，这里只补头条这段死区；
+ * 列表短到不用滚时不接管，滚轮该给谁还给谁。
+ * @param open - 菜单是否开着；关着时不接管滚轮。
+ * @param head - 头条那个节点的 ref：`search` 那档是搜索框，窄栏（`iconOnly`）那档是触发钮。
+ */
+export declare function useHeadWheel(open: boolean, head: RefObject<HTMLElement | null>): void;

package/dist/components/SelectFieldWheel.js

@@ -0,0 +1,35 @@
+import { useEffect } from '../lib/react.js';
+const MENU_CARD = '[role="menu"].wb-selectMenu';
+const LINE_HEIGHT_PX = 16;
+function menuViewport() {
+    const cards = document.querySelectorAll(MENU_CARD);
+    const card = cards[cards.length - 1];
+    const viewport = card?.querySelector('[role="presentation"]');
+    return viewport instanceof HTMLElement ? viewport : null;
+}
+/**
+ * 菜单开着时，滚轮落在「头条」（搜索框 / 触发钮）上也滚列表：点开菜单后指针还停在原来那个点上，
+ * 第一下滚动不该没有反应。列表自己那一格照旧由 dsh 的 `Menu` 滚，这里只补头条这段死区；
+ * 列表短到不用滚时不接管，滚轮该给谁还给谁。
+ * @param open - 菜单是否开着；关着时不接管滚轮。
+ * @param head - 头条那个节点的 ref：`search` 那档是搜索框，窄栏（`iconOnly`）那档是触发钮。
+ */
+export function useHeadWheel(open, head) {
+    useEffect(() => {
+        const node = head.current;
+        if (!open || node === null)
+            return undefined;
+        const onWheel = (event) => {
+            const viewport = menuViewport();
+            if (viewport === null || viewport.scrollHeight <= viewport.clientHeight)
+                return;
+            const step = event.deltaMode === WheelEvent.DOM_DELTA_LINE ? event.deltaY * LINE_HEIGHT_PX : event.deltaY;
+            viewport.scrollTop += step;
+            event.preventDefault();
+        };
+        node.addEventListener('wheel', onWheel, { passive: false });
+        return () => {
+            node.removeEventListener('wheel', onWheel);
+        };
+    }, [open, head]);
+}

package/dist/config/constants.d.ts

@@ -22,7 +22,7 @@ export declare const DIY_RECORD_PATH = "diy-record";
 export declare const DIY_RECORD_ACT_PATH = "diy-record/act";
 /** 面板运行态的路由前缀，挂在外壳 API 下：上报口用它，拒报回 report-refused。 */
 export declare const PANEL_STATE_PREFIX = "/workbench/api/panel-state";
-/** 钉住的 opencli 插件版本：`opencli-runtime` 按它校验、取那一份。 */
+/** 钉住的运行时版本：隔离运行时按它校验、取那一份。 */
 export declare const OPENCLI_PIN = "1.8.8";
 /** 缺陷看板套件的 dsh 服务名（`workbenchIssues`）：套件照它登记自己那份服务。 */
 export declare const ISSUES_SERVICE = "workbenchIssues";
@@ -38,11 +38,11 @@ export declare const DIY_DEBUG_SERVICE = "workbenchDiyDebug";
 export declare const DIY_RECORD_SERVICE = "workbenchDiyRecord";
 /** 会话投影服务的 dsh 服务名（`sessionProjections`）：宿主经 `stateOf(session, 'agentPreset')` 读那一档。 */
 export declare const SESSION_PROJECTIONS_SERVICE = "sessionProjections";
-/** 面板清单一次取回的行数上限（条）：外部模块拿它当 opencli `--pageSize`。 */
+/** 面板清单一次取回的行数上限（条）：外部模块拿它当分页参数。 */
 export declare const PANEL_LIST_LIMIT = 50;
-/** 单次 opencli 调用的默认超时（毫秒）；调用点没传 `timeoutMs` 时按它算。 */
+/** 单次运行时调用的默认超时（毫秒）；调用点没传 `timeoutMs` 时按它算。 */
 export declare const OPENCLI_TIMEOUT_MS = 120000;
-/** 同时最多几条 opencli 在跑（条）：`opencli.ts` 超出就排队。 */
+/** 同时最多几条运行时调用在跑（条）：超出就排队。 */
 export declare const OPENCLI_MAX_CONCURRENT = 4;
 /** 启动预热站点那一跳的超时（毫秒）；超时按未热对待，不挡面板。 */
 export declare const WARM_TIMEOUT_MS = 20000;

package/dist/config/constants.js

@@ -22,7 +22,7 @@ export const DIY_RECORD_PATH = "diy-record";
 export const DIY_RECORD_ACT_PATH = `${DIY_RECORD_PATH}/act`;
 /** 面板运行态的路由前缀，挂在外壳 API 下：上报口用它，拒报回 report-refused。 */
 export const PANEL_STATE_PREFIX = `${API_PREFIX}/${PANEL_STATE_PATH}`;
-/** 钉住的 opencli 插件版本：`opencli-runtime` 按它校验、取那一份。 */
+/** 钉住的运行时版本：隔离运行时按它校验、取那一份。 */
 export const OPENCLI_PIN = "1.8.8";
 /** 缺陷看板套件的 dsh 服务名（`workbenchIssues`）：套件照它登记自己那份服务。 */
 export const ISSUES_SERVICE = "workbenchIssues";
@@ -38,11 +38,11 @@ export const DIY_DEBUG_SERVICE = "workbenchDiyDebug";
 export const DIY_RECORD_SERVICE = "workbenchDiyRecord";
 /** 会话投影服务的 dsh 服务名（`sessionProjections`）：宿主经 `stateOf(session, 'agentPreset')` 读那一档。 */
 export const SESSION_PROJECTIONS_SERVICE = "sessionProjections";
-/** 面板清单一次取回的行数上限（条）：外部模块拿它当 opencli `--pageSize`。 */
+/** 面板清单一次取回的行数上限（条）：外部模块拿它当分页参数。 */
 export const PANEL_LIST_LIMIT = 50;
-/** 单次 opencli 调用的默认超时（毫秒）；调用点没传 `timeoutMs` 时按它算。 */
+/** 单次运行时调用的默认超时（毫秒）；调用点没传 `timeoutMs` 时按它算。 */
 export const OPENCLI_TIMEOUT_MS = 120_000;
-/** 同时最多几条 opencli 在跑（条）：`opencli.ts` 超出就排队。 */
+/** 同时最多几条运行时调用在跑（条）：超出就排队。 */
 export const OPENCLI_MAX_CONCURRENT = 4;
 /** 启动预热站点那一跳的超时（毫秒）；超时按未热对待，不挡面板。 */
 export const WARM_TIMEOUT_MS = 20_000;

package/dist/contract/capabilities.d.ts

@@ -0,0 +1,29 @@
+export interface RuntimeCapabilities {
+    readonly console: boolean;
+    readonly pluginMarket: boolean;
+    readonly browserBridge: boolean;
+}
+export interface RuntimeText {
+    readonly zh: string;
+    readonly en: string;
+}
+export interface RuntimeTerms {
+    readonly plugin: RuntimeText;
+    readonly pluginOf: RuntimeText;
+    readonly pluginThing: RuntimeText;
+    readonly pluginArea: RuntimeText;
+}
+export interface RuntimeBridgeFix {
+    readonly text: RuntimeText;
+    readonly link?: {
+        readonly label: RuntimeText;
+        readonly href: string;
+    };
+}
+export interface RuntimeProfile {
+    readonly label: string;
+    readonly terms: RuntimeTerms;
+    readonly installHint: RuntimeText;
+    readonly diagnose: Readonly<Partial<Record<'exec' | 'login' | 'bridge', RuntimeText>>>;
+    readonly bridge?: Readonly<Partial<Record<string, RuntimeBridgeFix>>>;
+}

package/dist/contract/capabilities.js

@@ -0,0 +1 @@
+export {};

package/dist/contract/needs.d.ts

@@ -64,7 +64,7 @@ export interface BinNeed extends NeedCommon {
     readonly docs?: string | undefined;
 }
 /**
- * 某个运行时上要有一个扩展（opencli 的插件就是这种），并且要提供这些命令。
+ * 某个运行时上要有一个扩展（运行时自己的插件就是这种），并且要提供这些命令。
  */
 export interface ExtensionNeed extends NeedCommon {
     readonly kind: 'extension';
@@ -76,8 +76,8 @@ export interface ExtensionNeed extends NeedCommon {
 }
 /**
  * 要在隔离运行时里有一个共用依赖包。
- * `runs` 写它自己会起哪些运行时的命令（如 `["opencli"]`）—— 写了外壳就把那份执行器注入进去
- * （库侧约定 `setOpencliRunner`）；不写就按它自己在 PATH 上找。
+ * `runs` 写它自己会起哪个运行时的命令 —— 写了外壳就把那份执行器注入进去
+ * （库侧约定 `set<Runtime>Runner`）；不写就按它自己在 PATH 上找。
  */
 export interface LibNeed extends NeedCommon {
     readonly kind: 'lib';

package/dist/contract/needs.js

@@ -178,7 +178,7 @@ function perKindProblemsOf(kind, raw, at) {
         errors.push(...libRunsProblemsOf(raw['runs'], at));
     if (kind === 'extension') {
         if (text(raw['runtime']) === '')
-            errors.push(`${at}.runtime 没写 —— 扩展属于哪个运行时（如 opencli）`);
+            errors.push(`${at}.runtime 没写 —— 扩展属于哪个运行时`);
         if (text(raw['name']) === '')
             errors.push(`${at}.name 没写`);
         if (raw['commands'] !== undefined) {

package/dist/contract/plugin-source.d.ts

@@ -1 +1,20 @@
 export type ProvisionProblem = 'not-declared' | 'env-missing' | 'malformed';
+export interface PluginSourceCommand {
+    readonly line: string;
+    readonly optional?: true;
+}
+export type ResolvedPluginSource = {
+    readonly ok: true;
+    readonly commands: readonly PluginSourceCommand[];
+    readonly line: string;
+} | {
+    readonly ok: false;
+    readonly problem: ProvisionProblem;
+    readonly env?: string;
+};
+export interface PluginSourceOptions {
+    readonly command?: string;
+    readonly plugin?: string;
+    readonly version?: string;
+    readonly mode?: 'install' | 'update';
+}

package/dist/contract/protocol/bundle-install.d.ts

@@ -98,8 +98,10 @@ export interface BundleSupplyPayload {
     readonly state: BundleSupplyState;
     readonly reason?: string;
 }
+export type PluginPackageKind = 'runtime-plugin';
+export declare function isPluginPackageKind(kind: unknown): kind is PluginPackageKind;
 export interface BundleInstalledPlugin {
-    readonly kind: 'opencli-plugin';
+    readonly kind: PluginPackageKind;
     readonly pkg: string;
     readonly name?: string;
 }

package/dist/contract/protocol/bundle-install.js

@@ -10,3 +10,6 @@ export const RESTART_REASONS = [
     'unmanaged-plugin',
     'module-comparison',
 ];
+export function isPluginPackageKind(kind) {
+    return kind === 'runtime-plugin';
+}

package/dist/contract/protocol/market-index.d.ts

@@ -208,6 +208,7 @@ export interface PublishPreview {
     readonly name: string;
     readonly version: string;
     readonly author?: string;
+    readonly labels?: readonly string[];
     readonly registry?: string;
     readonly market?: MarketPublishDestination;
     readonly claim?: MarketClaim;

package/dist/contract/protocol/platform.d.ts

@@ -17,7 +17,7 @@ export interface ToolchainPlan {
         readonly source: 'desktop-shim' | 'path';
     };
     readonly npm: {
-        readonly neededFor: 'opencli-install';
+        readonly neededFor: 'runtime-install';
     };
     readonly pnpm: {
         readonly neededFor: 'workshop';

package/dist/contract/runner.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 一条运行时命令的执行器：同一形状的 `execFile('<runtime>', args)`，结果只留 stdout。
+ */
+export type LibRunner = (args: readonly string[]) => Promise<{
+    readonly stdout: string;
+}>;

package/dist/contract/runner.js

@@ -0,0 +1 @@
+export {};

package/dist/contract/unit.d.ts

@@ -19,21 +19,21 @@ export interface UnitCard {
     readonly order: number;
 }
 /**
- * 合成工具背后那条 opencli 命令：插件名与命令名都是 opencli 那边的原名，`args` 是命令自己声明的参数名（按声明顺序）。
+ * 合成工具背后那条运行时命令：插件名与命令名都是运行时那边的原名，`args` 是命令自己声明的参数名（按声明顺序）。
  */
-export interface UnitToolOpencli {
+export interface UnitToolRuntime {
     readonly plugin: string;
     readonly command: string;
     readonly args: readonly string[];
 }
 /**
  * 一条工具在清单里的样子：全名加会不会写；审批按 writes 认领。
- * `opencli` 只有「按已装插件合成」的单元写，手写模块的工具没有这一格。
+ * `runtime` 只有「按已装插件合成」的单元写，手写模块的工具没有这一格。
  */
 export interface UnitTool {
     readonly name: string;
     readonly writes: boolean;
-    readonly opencli?: UnitToolOpencli;
+    readonly runtime?: UnitToolRuntime;
 }
 /**
  * 模块要外壳的哪些服务：inject 缺一个就挂不上，optional 缺了照挂。

package/dist/host/adapter-contract.d.ts

@@ -0,0 +1,3 @@
+import type { DshHostContext } from '../api/dsh.js';
+import type { AdapterSet } from './adapters.js';
+export declare function adapterContractGaps(set: AdapterSet, ctx: DshHostContext): readonly string[];

package/dist/host/adapter-contract.js

@@ -0,0 +1,93 @@
+import { validateAdapterSet } from './adapter-set.js';
+const CAPABILITY_KEYS = ['console', 'pluginMarket', 'browserBridge'];
+const DATA_METHODS = ['read', 'request', 'requestMany', 'submit'];
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim() !== '';
+}
+const CLI_DIR_METHODS = [
+    ['cliCatalogPath', 'cliCatalogPath'],
+    ['vendorPluginsDir', 'vendorPluginsDir'],
+];
+export function adapterContractGaps(set, ctx) {
+    const gaps = [];
+    const validated = validateAdapterSet(set, '契约');
+    if (!validated.ok) {
+        gaps.push(`成员不全：${validated.detail}`);
+        return gaps;
+    }
+    if (!Number.isInteger(set.apiVersion) || set.apiVersion < 1) {
+        gaps.push(`apiVersion 不是正整数：${String(set.apiVersion)}`);
+    }
+    const capabilities = set.runtime.capabilities(ctx);
+    for (const key of CAPABILITY_KEYS) {
+        if (typeof capabilities[key] !== 'boolean')
+            gaps.push(`capabilities.${key} 不是布尔值`);
+    }
+    if (typeof set.runtime.profile === 'function') {
+        const profile = set.runtime.profile(ctx);
+        if (!isNonEmptyString(profile?.label))
+            gaps.push('runtime.profile().label 不是非空字符串');
+        for (const key of ['plugin', 'pluginOf', 'pluginThing', 'pluginArea']) {
+            const text = profile?.terms?.[key];
+            if (!isNonEmptyString(text?.zh) || !isNonEmptyString(text?.en)) {
+                gaps.push(`runtime.profile().terms.${key} 要给 zh / en 两份非空文案`);
+            }
+        }
+        if (!isNonEmptyString(profile?.installHint?.zh) || !isNonEmptyString(profile?.installHint?.en)) {
+            gaps.push('runtime.profile().installHint 要给 zh / en 两份非空文案');
+        }
+    }
+    if (typeof set.runtime.commandSurface === 'function') {
+        const surface = set.runtime.commandSurface(ctx);
+        if (surface !== undefined) {
+            if (!isNonEmptyString(surface.name))
+                gaps.push('runtime.commandSurface().name 不是非空字符串');
+            if (!isNonEmptyString(surface.pluginPrefix)) {
+                gaps.push('runtime.commandSurface().pluginPrefix 不是非空字符串');
+            }
+            if (typeof surface.invoke !== 'function')
+                gaps.push('runtime.commandSurface().invoke 不是函数');
+            else if (!isNonEmptyString(surface.invoke('site', 'command'))) {
+                gaps.push('runtime.commandSurface().invoke(site, command) 拼不出非空命令行');
+            }
+            if (typeof surface.help !== 'function')
+                gaps.push('runtime.commandSurface().help 不是函数');
+            else if (!isNonEmptyString(surface.help('site'))) {
+                gaps.push('runtime.commandSurface().help(site) 拼不出非空提示');
+            }
+        }
+    }
+    const health = set.runtime.health(ctx);
+    const commands = set.runtime.commands(ctx);
+    for (const [name, status] of Object.entries(health)) {
+        if (!isNonEmptyString(status?.command))
+            gaps.push(`health['${name}'].command 不是非空字符串`);
+        if (!['env', 'isolated', 'path'].includes(status?.source))
+            gaps.push(`health['${name}'].source 不是已知来源`);
+    }
+    for (const name of Object.keys(commands)) {
+        if (health[name] === undefined)
+            gaps.push(`commands 里的 ${name} 在 health 里没有对应条目`);
+        else if (!isNonEmptyString(commands[name]))
+            gaps.push(`commands['${name}'] 不是非空字符串`);
+    }
+    for (const method of DATA_METHODS) {
+        if (typeof set.data[method] !== 'function')
+            gaps.push(`data.${method} 不是函数`);
+    }
+    if (!isNonEmptyString(set.modules.isolatedRoot()))
+        gaps.push('modules.isolatedRoot() 不是非空字符串');
+    if (set.modules.runtimeInstallCommand !== undefined && !isNonEmptyString(set.modules.runtimeInstallCommand())) {
+        gaps.push('modules.runtimeInstallCommand() 给了但不是非空字符串');
+    }
+    for (const [name, method] of CLI_DIR_METHODS) {
+        const given = set.modules[method];
+        if (given !== undefined && !isNonEmptyString(given()))
+            gaps.push(`modules.${method}() 给了但不是非空字符串（${name}）`);
+    }
+    if (typeof set.probe.probeUnits !== 'function')
+        gaps.push('probe.probeUnits 不是函数');
+    if (typeof set.probe.registerPreflight !== 'function')
+        gaps.push('probe.registerPreflight 不是函数');
+    return gaps;
+}

package/dist/host/adapter-set.js

@@ -26,10 +26,9 @@ const CORE_METHODS = [
 ];
 const FULL_MEMBERS = ['modules', 'runtime', 'plugins', 'actions'];
 const FULL_METHODS = [
+    ['modules', 'isolatedRoot'],
     ['modules', 'isolatedHome'],
-    ['modules', 'cliCatalogPath'],
-    ['modules', 'vendorPluginsDir'],
-    ['modules', 'opencliInstallCommand'],
+    ['modules', 'afterLibInstall'],
     ['modules', 'profileDirOf'],
     ['modules', 'profileModules'],
     ['modules', 'readInstalledModule'],
@@ -46,7 +45,10 @@ const FULL_METHODS = [
     ['modules', 'isNewerVersion'],
     ['modules', 'startSelfUpdate'],
     ['runtime', 'packageRoot'],
-    ['runtime', 'opencliCommand'],
+    ['runtime', 'capabilities'],
+    ['runtime', 'commands'],
+    ['runtime', 'runners'],
+    ['runtime', 'health'],
     ['runtime', 'seed'],
     ['runtime', 'warnUnwritableRoot'],
     ['plugins', 'declarationLookup'],

package/dist/host/adapter-types.d.ts

@@ -63,7 +63,7 @@ export interface SelfUpdateStart {
     readonly paths: SelfUpdatePaths;
     readonly forward: string;
 }
-export interface OpencliResolution {
+export interface RuntimeStatus {
     readonly command: string;
     readonly source: 'env' | 'isolated' | 'path';
     readonly isolated: string | null;

package/dist/host/bundle-manager.d.ts

@@ -0,0 +1,3 @@
+import type { DshHostContext } from '../api/dsh.js';
+import type { BundleManager } from './adapter-types.js';
+export declare function readBundleManager(ctx: DshHostContext): BundleManager | undefined;