@dsh-workbench/shared 1.1.12 → 1.1.14-beta.0

package/src/host/unit-plugin.ts

@@ -0,0 +1,49 @@
+import { UNITS_SERVICE } from '../config/constants.js';
+import type { UnitModuleFace } from './unit-face.js';
+
+/**
+ * 宿主面注册只需要的那点上下文：`get` / `effect` / 可选的 `logger`。
+ */
+export interface UnitHostContextLike {
+  get<T = unknown>(name: string): T | undefined;
+  effect(effect: () => void | (() => void), label?: string): () => void;
+  readonly logger?: { warn?(message: string): void } | undefined;
+}
+
+/**
+ * 一个宿主插件导出的三件：`name` / `inject` / `apply`。
+ */
+export interface UnitHostPlugin {
+  readonly name: string;
+  readonly inject: readonly string[];
+  apply(ctx: UnitHostContextLike): void;
+}
+
+/**
+ * 把「宿主面注册进外壳」这段在每个模块里都一样的接线收成一份。
+ * 用法：先 `const plugin = defineUnitHostPlugin({ … })`，再逐个导出 `name` / `inject` / `apply`
+ * （逐名 `export const` 才过 arch 的导出对账；解构导出它认不出）。
+ * @param options.name 插件名（包名）。
+ * @param options.unit 单元 id。
+ * @param options.face 这个单元的宿主面。
+ * @returns `{ name, inject, apply }`；`apply` 里取 `workbenchUnits`、缺了就 warn 一声。
+ */
+export function defineUnitHostPlugin(options: {
+  readonly name: string;
+  readonly unit: string;
+  readonly face: UnitModuleFace;
+}): UnitHostPlugin {
+  const { name, unit, face } = options;
+  return {
+    name,
+    inject: [UNITS_SERVICE],
+    apply(ctx: UnitHostContextLike): void {
+      const units = ctx.get<{ register(face: UnitModuleFace): () => void }>(UNITS_SERVICE);
+      if (units === undefined) {
+        ctx.logger?.warn?.(`[${unit}] 外壳没有提供 workbenchUnits 服务：这个模块装不进来`);
+        return;
+      }
+      ctx.effect(() => units.register(face), `${name}: 注册 ${unit}`);
+    },
+  };
+}

package/src/host/workspace-store.ts

@@ -30,15 +30,22 @@ export function workspaceKey(workspace: string): string {
   return `${slug(path.basename(abs))}-${createHash('sha1').update(abs).digest('hex').slice(0, 8)}`;
 }
 
-function inside(dir: string, name: string): string {
+function safeName(name: string): string {
   const trimmed = name.trim();
   if (trimmed === '' || trimmed === '.' || trimmed === '..') {
     throw new Error(`模块文件夹里只接受相对文件名，收到的是「${name}」`);
   }
-  if (trimmed.includes('\0') || path.isAbsolute(trimmed)) {
+  if (trimmed.includes('\0') || path.isAbsolute(trimmed) || /^[A-Za-z]:[\\/]/.test(trimmed)) {
     throw new Error(`模块只能写自己的文件夹：不接受绝对路径「${name}」`);
   }
-  const full = path.resolve(dir, trimmed);
+  if (trimmed.replace(/\\/g, '/').split('/').includes('..')) {
+    throw new Error(`模块只能写自己的文件夹：路径越界「${name}」`);
+  }
+  return trimmed;
+}
+
+function inside(dir: string, name: string): string {
+  const full = path.resolve(dir, safeName(name));
   if (full !== dir && !full.startsWith(dir + path.sep)) {
     throw new Error(`模块只能写自己的文件夹：路径越界「${name}」`);
   }
@@ -50,15 +57,15 @@ function memoryStore(dir: string): ModuleStore {
   return {
     dir,
     read: (name) => {
-      inside(dir, name);
+      safeName(name);
       return files.get(name) ?? null;
     },
     write: (name, value) => {
-      inside(dir, name);
+      safeName(name);
       files.set(name, value);
     },
     remove: (name) => {
-      inside(dir, name);
+      safeName(name);
       files.delete(name);
     },
     list: () => [...files.keys()].sort(),

package/src/host.ts

@@ -57,13 +57,16 @@ export * from './host/flow/expr.js';
 export * from './host/flow/check.js';
 export * from './host/flow/run.js';
 export * from './host/flow/kit.js';
+export * from './host/flow/step.js';
 export * from './host/host-kit.js';
 export * from './host/panel-state.js';
+export * from './host/payload.js';
 export * from './host/plugin-ledger.js';
 export * from './host/time.js';
 export * from './host/tokens.js';
 export * from './host/tool-approval.js';
 export * from './host/tool-kit.js';
+export * from './host/unit-plugin.js';
 export * from './host/unit-face.js';
 export * from './host/lib-runners.js';
 export * from './host/value-handoff.js';

package/src/i18n/en.ts

@@ -600,6 +600,7 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'env.stepFailed.install': 'install failed',
   'env.stepFailed.path': 'installed but not found',
   'env.stepFailed.shell': 'cannot reach the command line',
+  'env.stepFailed.host': 'the command never returned',
   'env.toolchain.ok': 'Looks good',
   'env.toolchain.warn': 'Almost ready',
   'env.runtime.ok': 'Ready',
@@ -612,12 +613,15 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'env.fix.why': 'The workbench uses its own background tool (installed separately from the one in your terminal), and it is not set up on this machine yet.',
   'env.fix.whyPath': 'The background tool is installed, but this environment cannot find it \u2014 usually a PATH or shell-session issue.',
   'env.fix.whyShell': 'The workbench cannot reach the command line on this machine, so it cannot fetch data \u2014 you cannot install this from here; someone needs to fix the background environment.',
+  'env.fix.whyHost': 'The workbench runs a few checks on the command line and collects what they return; this time the command went out and nothing came back. The tools themselves are most likely fine \u2014 reinstalling Node / npm / pnpm will not help.',
   'env.fix.step': 'Run this in a terminal, then hit Retry:',
   'env.fix.stepPath': 'Open a new terminal window (or make sure npm\u2019s global bin directory is on PATH), then hit Retry.',
   'env.fix.stepShell': 'Restart the workbench (or dsh); if it keeps happening, the workbench still cannot reach the command line.',
+  'env.fix.stepHost': 'Quit the workbench completely (including the tray icon), clear the dsh-* leftovers in the system temp folder, then open it again. If it keeps happening, update dsh.',
   'env.fix.permission': 'Permission denied: rerun with sudo, or point npm\u2019s global directory at your home.',
   'env.fix.network': 'Network unreachable: check your network or proxy, then retry.',
   'env.fix.details': 'Details (for troubleshooting)',
+  'env.log': 'Detailed output',
   'env.retry': 'Retry',
   'env.wake': 'Open browser',
   'env.wake.opening': 'Opening the browser…',

package/src/i18n/zh.ts

@@ -596,6 +596,7 @@ export const zh = {
   'env.stepFailed.install': '装不上',
   'env.stepFailed.path': '装了但还找不到',
   'env.stepFailed.shell': '连不上命令行',
+  'env.stepFailed.host': '命令行没有返回',
   'env.toolchain.ok': '正常',
   'env.toolchain.warn': '还没完全准备好',
   'env.runtime.ok': '已就绪',
@@ -608,12 +609,15 @@ export const zh = {
   'env.fix.why': '工作台用它自己那份后台工具（与你在终端里那套分开装，互不影响），这台机器上还没装好它。',
   'env.fix.whyPath': '后台工具装上了，但当前环境还找不到它 —— 通常是 PATH 或终端会话的问题。',
   'env.fix.whyShell': '工作台拿不到这台机器的命令行，所以取不了数据 —— 这一步你装不了，需要有人处理后台环境。',
+  'env.fix.whyHost': '工作台要靠命令行跑几条检查，再把结果收回来；这次命令发出去了，结果一直没回来。工具本身多半是好的 —— 重装 Node / npm / pnpm 不会有帮助。',
   'env.fix.step': '在终端里运行下面这条命令，装好之后点「重试」：',
   'env.fix.stepPath': '新开一个终端窗口（或确认 npm 的全局 bin 目录在 PATH 里），然后点「重试」。',
   'env.fix.stepShell': '重启一次工作台（或 dsh）；如果反复出现，说明工作台还是拿不到命令行。',
+  'env.fix.stepHost': '完全退出工作台（托盘图标也要退），清掉系统临时目录里 dsh- 开头的残留，再重新打开；反复出现就升级 dsh。',
   'env.fix.permission': '权限不够：在命令前加 sudo 重跑，或先把 npm 的全局目录配到你的用户目录。',
   'env.fix.network': '网络不通：检查网络或代理设置后重试。',
   'env.fix.details': '详细输出（排障用）',
+  'env.log': '详细输出',
   'env.retry': '重试',
   'env.wake': '打开浏览器',
   'env.wake.opening': '正在打开浏览器…',

package/src/lib/__tests__/board-fact.test.ts

@@ -51,4 +51,12 @@ describe('干不了活是为什么：先看人在不在工坊，再看板画没
     expect(insideWorkshop('/a/b', '/a/bc')).toBe(false);
     expect(insideWorkshop('/a/b/', '/a/b/c')).toBe(true);
   });
+
+  it('★ Windows 路径：反斜杠、混合分隔符与盘符大小写都认', () => {
+    expect(insideWorkshop('C:\\w\\ws', 'C:\\w\\ws\\packages\\module-demo')).toBe(true);
+    expect(insideWorkshop('C:\\w\\ws', 'C:/w/ws/packages/module-demo')).toBe(true);
+    expect(insideWorkshop('c:\\w\\ws', 'C:\\W\\WS\\packages')).toBe(true);
+    expect(insideWorkshop('C:\\w\\ws', 'C:\\w\\ws2')).toBe(false);
+    expect(insideWorkshop('C:\\w\\ws', 'D:\\w\\ws\\packages')).toBe(false);
+  });
 });

package/src/lib/__tests__/ui.test.ts

@@ -3,6 +3,7 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import {
   cx,
   parseLocalTimestamp,
+  pathBase,
   relativeTime,
   relativeTimeAgo,
   relativeTimeBucket,
@@ -112,8 +113,14 @@ describe('shortenPath', () => {
     expect(shortenPath('/Users/you/dev/app')).toBe('~/dev/app');
   });
 
+  it('Linux 与 Windows 的用户主目录也缩', () => {
+    expect(shortenPath('/home/you/dev/app')).toBe('~/dev/app');
+    expect(shortenPath('C:\\Users\\you\\dev\\app')).toBe('~\\dev\\app');
+  });
+
   it('非用户目录原样返回', () => {
     expect(shortenPath('/Volumes/dev/app')).toBe('/Volumes/dev/app');
+    expect(shortenPath('D:\\work\\app')).toBe('D:\\work\\app');
   });
 
   it('非字符串给空串', () => {
@@ -122,6 +129,25 @@ describe('shortenPath', () => {
   });
 });
 
+describe('pathBase', () => {
+  it('取最后一段，POSIX 与 Windows 都认', () => {
+    expect(pathBase('/Users/you/dev/app')).toBe('app');
+    expect(pathBase('C:\\Users\\you\\dev\\app')).toBe('app');
+    expect(pathBase('C:/Users/you/dev/app')).toBe('app');
+  });
+
+  it('尾部有分隔符先去掉', () => {
+    expect(pathBase('/Users/you/dev/app/')).toBe('app');
+    expect(pathBase('C:\\Users\\you\\dev\\app\\')).toBe('app');
+  });
+
+  it('没有分隔符就整串，非字符串给空串', () => {
+    expect(pathBase('app')).toBe('app');
+    expect(pathBase(undefined)).toBe('');
+    expect(pathBase(42)).toBe('');
+  });
+});
+
 describe('parseLocalTimestamp', () => {
   it('按本地时区解析 Coding 的时间戳形态', () => {
     const parsed = parseLocalTimestamp('2026-09-27 08:18:36');

package/src/lib/board-fact.ts

@@ -29,16 +29,23 @@ export interface BoardProbe {
   readonly drawn: boolean;
 }
 
+function normalizePath(value: string): string {
+  const forward = value.replace(/\\/g, '/').replace(/\/+$/g, '');
+  return /^[A-Za-z]:\//.test(forward) || forward.startsWith('//') ? forward.toLowerCase() : forward;
+}
+
 /**
  * 判一个路径落不落在这个工作区里（按路径前缀比，不是字符串包含）。
  * @param root - 工作区根路径。
  * @param target - 要判的路径。
- * @returns 同一个路径或在其下给 `true`；`root` 末尾带不带斜杠都认（`/a` 不匹配 `/ab`）。
+ * @returns 同一个路径或在其下给 `true`；分隔符先归一（Windows 的 `\` 与 `/` 都认），
+ *   盘符路径按大小写不敏感比；`root` 末尾带不带斜杠都认（`/a` 不匹配 `/ab`）。
  */
 export function insideWorkshop(root: string, target: string): boolean {
-  if (target === root) return true;
-  const base = root.endsWith('/') ? root : `${root}/`;
-  return target.startsWith(base);
+  const base = normalizePath(root);
+  const real = normalizePath(target);
+  if (real === base) return true;
+  return real.startsWith(base === '' ? '/' : `${base}/`);
 }
 
 /**

package/src/lib/ui.ts

@@ -95,15 +95,33 @@ export function relativeTime(epochMs: number, t: TimeTranslate): string {
   return dayjs(epochMs).format('YYYY/M/D HH:mm:ss');
 }
 
+const HOME_PREFIXES = [/^\/Users\/[^/]+/, /^\/home\/[^/]+/, /^[A-Za-z]:\\Users\\[^\\]+/];
+
 /**
- * 把 `/Users/<用户名>/…` 缩成 `~/…`，免得会话行里全是一样的长前缀。
+ * 把用户主目录（macOS `/Users/<用户名>`、Linux `/home/<用户名>`、Windows `C:\Users\<用户名>`）缩成 `~`，
+ * 免得会话行里全是一样的长前缀。
  * @param path - 任意值。
  * @returns 缩好的路径；不在用户主目录下原样返回，不是字符串给空串。
  */
 export function shortenPath(path: unknown): string {
   if (typeof path !== 'string') return '';
-  const hit = path.match(/^\/Users\/[^/]+/);
-  return hit === null ? path : path.replace(hit[0], '~');
+  for (const pattern of HOME_PREFIXES) {
+    const hit = path.match(pattern);
+    if (hit !== null) return path.replace(hit[0], '~');
+  }
+  return path;
+}
+
+/**
+ * 取路径最后一段，`/` 与 `\` 都认（Windows 路径、混合分隔符都行）。
+ * @param path - 任意值。
+ * @returns 末段；尾部有分隔符先去掉，没有分隔符就整串，不是字符串给空串。
+ */
+export function pathBase(path: unknown): string {
+  if (typeof path !== 'string') return '';
+  const trimmed = path.replace(/[\\/]+$/, '');
+  const at = Math.max(trimmed.lastIndexOf('/'), trimmed.lastIndexOf('\\'));
+  return at === -1 ? trimmed : trimmed.slice(at + 1);
 }
 
 const LOCAL_TIMESTAMP = /^(\d{4})-(\d{2})-(\d{2})[ T](\d{2}):(\d{2}):(\d{2})$/;

package/src/testing/host-fakes.ts

@@ -7,6 +7,7 @@ export interface ShellCall {
   timeoutMs?: number;
   onExpiry?: string;
   stdoutMaxBytes?: number;
+  env?: Readonly<Record<string, string>>;
 }
 
 export interface ShellReply {
@@ -15,6 +16,7 @@ export interface ShellReply {
   exitCode?: number | null;
   timedOut?: boolean;
   aborted?: boolean;
+  truncated?: boolean;
   failWith?: Error;
 }
 
@@ -49,7 +51,7 @@ export function createFakeShell(replies: ShellReply[] | ((call: ShellCall, index
             exitCode: reply.exitCode ?? 0,
             timedOut: reply.timedOut ?? false,
             aborted: reply.aborted ?? false,
-            stdout: { text: reply.stdout ?? '', truncated: false },
+            stdout: { text: reply.stdout ?? '', truncated: reply.truncated === true },
             stderr: { text: reply.stderr ?? '', truncated: false },
           };
         },

package/dist/components/SelectFieldWheel.d.ts

@@ -1,9 +0,0 @@
-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

@@ -1,35 +0,0 @@
-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/host/channel-plugin.d.ts

@@ -1,15 +0,0 @@
-export declare const CHANNEL_PLUGIN_NAME = "opencli-plugin-workbench";
-export declare const CHANNEL_PLUGIN_SITE = "workbench";
-export interface ChannelPluginPlan {
-    readonly dest: string;
-    readonly version: string;
-    readonly commands: readonly string[];
-    readonly line: string;
-}
-export declare function channelVersionOf(dir: string): string | undefined;
-export declare function channelPluginPlan(options: {
-    readonly channelDir: string;
-    readonly command?: string;
-}): ChannelPluginPlan | undefined;
-export declare function channelInstalledVersion(): string | undefined;
-export declare function channelSiteInstalled(): boolean;

package/dist/host/channel-plugin.js

@@ -1,42 +0,0 @@
-import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { isolatedHome, toolchainOpencliDir, vendorPeerLink, vendorPluginsDir } from './paths.js';
-import { quoteShellArg } from './shell-text.js';
-export const CHANNEL_PLUGIN_NAME = 'opencli-plugin-workbench';
-export const CHANNEL_PLUGIN_SITE = 'workbench';
-function textOf(value) {
-    return typeof value === 'string' ? value.trim() : '';
-}
-export function channelVersionOf(dir) {
-    try {
-        const parsed = JSON.parse(readFileSync(join(dir, 'opencli-plugin.json'), 'utf8'));
-        if (typeof parsed !== 'object' || parsed === null)
-            return undefined;
-        const version = textOf(parsed['version']);
-        return version === '' ? undefined : version;
-    }
-    catch {
-        return undefined;
-    }
-}
-export function channelPluginPlan(options) {
-    const version = channelVersionOf(options.channelDir);
-    if (version === undefined)
-        return undefined;
-    const command = options.command ?? 'opencli';
-    const dest = join(vendorPluginsDir(), CHANNEL_PLUGIN_NAME);
-    const peer = vendorPeerLink();
-    const commands = [
-        `rm -rf ${quoteShellArg(dest)} && mkdir -p ${quoteShellArg(dest)} && cp -R ${quoteShellArg(options.channelDir)}/. ${quoteShellArg(dest)}/`,
-        `rm -rf ${quoteShellArg(peer.dir)} && mkdir -p ${quoteShellArg(peer.parent)} && ln -s ${quoteShellArg(toolchainOpencliDir())} ${quoteShellArg(peer.dir)}`,
-        `(${quoteShellArg(command)} plugin uninstall ${quoteShellArg(CHANNEL_PLUGIN_SITE)} || true)`,
-        `${quoteShellArg(command)} plugin install ${quoteShellArg(dest)}`,
-    ];
-    return { dest, version, commands, line: commands.join(' && ') };
-}
-export function channelInstalledVersion() {
-    return channelVersionOf(join(vendorPluginsDir(), CHANNEL_PLUGIN_NAME));
-}
-export function channelSiteInstalled() {
-    return existsSync(join(isolatedHome(), '.opencli', 'plugins', CHANNEL_PLUGIN_SITE));
-}

package/dist/host/command-name.d.ts

@@ -1 +0,0 @@
-export declare function commandNamesMatch(declared: string, resolved: string): boolean;

package/dist/host/command-name.js

@@ -1,14 +0,0 @@
-function baseName(value) {
-    const parts = value.trim().split(/[\\/]/);
-    return parts[parts.length - 1] ?? '';
-}
-function isOpencli(name) {
-    return name === 'opencli' || name === 'opencli.cmd' || name === 'opencli.exe';
-}
-export function commandNamesMatch(declared, resolved) {
-    const left = baseName(declared);
-    const right = baseName(resolved);
-    if (left === '' || right === '')
-        return false;
-    return left === right || (isOpencli(left) && isOpencli(right));
-}

package/dist/host/opencli-runner.d.ts

@@ -1,26 +0,0 @@
-import type { DataRequest, DataResult } from '../contract/data.js';
-/**
- * 一条 opencli 命令的执行器：同一形状的 `execFile('opencli', args)`，结果只留 stdout。
- */
-export type LibRunner = (args: readonly string[]) => Promise<{
-    readonly stdout: string;
-}>;
-export type OpencliRunner = LibRunner;
-/**
- * 读缝（`DataReader.read`）的形状；模块直接把自己的 `data.read` 传进来即可。
- */
-export type OpencliRead = (request: DataRequest) => Promise<DataResult<unknown>>;
-export interface OpencliRunnerOptions {
-    readonly timeoutMs?: number;
-}
-/**
- * 把读缝包成一条 opencli 命令的执行器：给还按 `execFile('opencli', args)` 收结果的编排库用，
- * 让它们跑在面板用的那份 opencli 上（同一套插件、同一份登录态）。
- *
- * 失败按 opencli 自己的约定还原：未登录是 `code: AUTH_REQUIRED` + 退出码 77，编排库的
- * 「等登录再重试」才接得上；其它失败保留 `Command failed: opencli …` 那句外壳。
- * @param read 模块手里的读缝（`data.read`）。
- * @param options `timeoutMs` 透传给读缝；不传就用读缝自己的默认值。
- * @returns 执行器；直接交给编排库的 `setOpencliRunner`。
- */
-export declare function opencliRunnerOf(read: OpencliRead, options?: OpencliRunnerOptions): OpencliRunner;

package/dist/host/opencli-runner.js

@@ -1,50 +0,0 @@
-const AUTH_REQUIRED_EXIT_CODE = 77;
-function textOf(value) {
-    return typeof value === 'string' ? value : '';
-}
-function failedOf(args, error) {
-    const head = `Command failed: opencli ${args.join(' ')}`;
-    const auth = error?.pageCode === 'auth-required';
-    const helpUrl = textOf(error?.helpUrl);
-    const detail = textOf(error?.detail);
-    const hint = textOf(error?.hint);
-    const failed = new Error([
-        head,
-        ...(auth
-            ? ['code: AUTH_REQUIRED', `message: ${textOf(error?.message)}`]
-            : [textOf(error?.message) || 'opencli 这条命令没跑通']),
-        ...(detail === '' ? [] : [detail]),
-        ...(hint === '' ? [] : [hint]),
-        ...(auth && helpUrl !== ''
-            ? [`help: Please open Chrome or Chromium and log in to ${helpUrl}`]
-            : []),
-    ].join('\n'));
-    if (auth)
-        failed.code = AUTH_REQUIRED_EXIT_CODE;
-    return failed;
-}
-/**
- * 把读缝包成一条 opencli 命令的执行器：给还按 `execFile('opencli', args)` 收结果的编排库用，
- * 让它们跑在面板用的那份 opencli 上（同一套插件、同一份登录态）。
- *
- * 失败按 opencli 自己的约定还原：未登录是 `code: AUTH_REQUIRED` + 退出码 77，编排库的
- * 「等登录再重试」才接得上；其它失败保留 `Command failed: opencli …` 那句外壳。
- * @param read 模块手里的读缝（`data.read`）。
- * @param options `timeoutMs` 透传给读缝；不传就用读缝自己的默认值。
- * @returns 执行器；直接交给编排库的 `setOpencliRunner`。
- */
-export function opencliRunnerOf(read, options = {}) {
-    return async (args) => {
-        const result = await read({
-            kind: 'command',
-            adapter: 'opencli',
-            argv: [...args],
-            ...(options.timeoutMs === undefined
-                ? {}
-                : { timeoutMs: options.timeoutMs }),
-        });
-        if (result.ok)
-            return { stdout: JSON.stringify(result.data) };
-        throw failedOf(args, result.error);
-    };
-}

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

@@ -1,33 +0,0 @@
-import type { SupplySource } from '../contract/needs.js';
-import type { ProvisionProblem } from '../contract/plugin-source.js';
-export type { ProvisionProblem } from '../contract/plugin-source.js';
-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';
-}
-export declare function npmRegistryOf(source: {
-    readonly registryEnv?: string;
-    readonly registryDefault?: string;
-}, env: Readonly<Record<string, string | undefined>>): {
-    readonly ok: true;
-    readonly value: string;
-} | {
-    readonly ok: false;
-    readonly env: string;
-};
-export declare function resolvePluginSource(source: SupplySource | undefined, env: Readonly<Record<string, string | undefined>>, options?: PluginSourceOptions): ResolvedPluginSource;

package/dist/host/plugin-source.js

@@ -1,91 +0,0 @@
-import { quoteShellArg } from './shell-text.js';
-import { npmCacheDir, toolchainOpencliDir, vendorPeerLink, vendorPrefix } from './paths.js';
-function mergeLines(commands) {
-    return commands.map((item) => (item.optional === true ? `(${item.line} || true)` : item.line)).join(' && ');
-}
-function envValue(env, name) {
-    const value = env[name]?.trim();
-    return value === undefined || value === '' ? { ok: false } : { ok: true, value };
-}
-export function npmRegistryOf(source, env) {
-    const name = source.registryEnv ?? '';
-    if (name !== '') {
-        const fromEnv = envValue(env, name);
-        if (fromEnv.ok)
-            return fromEnv;
-    }
-    const fallback = source.registryDefault?.trim();
-    if (fallback === undefined || fallback === '')
-        return { ok: false, env: name };
-    return { ok: true, value: fallback };
-}
-function installOne(command, spec) {
-    const line = `${quoteShellArg(command)} plugin install ${quoteShellArg(spec)}`;
-    return { ok: true, commands: [{ line }], line };
-}
-function pluginPackageOf(source, plugin) {
-    if (source.kind === 'npm') {
-        const pkg = source.package?.trim() ?? '';
-        if (pkg !== '')
-            return pkg;
-        return plugin.trim() === '' ? '' : `opencli-plugin-${plugin.trim()}`;
-    }
-    if (source.kind === 'git')
-        return source.url.trim();
-    return '';
-}
-function npmSource(source, env, options) {
-    const registry = npmRegistryOf(source, env);
-    if (!registry.ok)
-        return { ok: false, problem: 'env-missing', env: registry.env };
-    const { command = 'opencli', plugin = '', version = 'latest', mode = 'install' } = options;
-    const name = pluginPackageOf(source, plugin);
-    if (name === '')
-        return { ok: false, problem: 'malformed' };
-    const prefix = vendorPrefix();
-    const dirInPrefix = `${prefix}/node_modules/${name}`;
-    const peer = vendorPeerLink();
-    const commands = [
-        {
-            line: [
-                'npm i',
-                `--prefix ${quoteShellArg(prefix)}`,
-                quoteShellArg(`${name}@${version}`),
-                `--registry ${quoteShellArg(registry.value)}`,
-                `--cache ${quoteShellArg(npmCacheDir())}`,
-            ].join(' '),
-        },
-        {
-            line: `rm -rf ${quoteShellArg(peer.dir)} && mkdir -p ${quoteShellArg(peer.parent)} && ln -s ${quoteShellArg(toolchainOpencliDir())} ${quoteShellArg(peer.dir)}`,
-        },
-    ];
-    if (mode === 'install') {
-        if (plugin !== '') {
-            commands.push({
-                line: `${quoteShellArg(command)} plugin uninstall ${quoteShellArg(plugin)}`,
-                optional: true,
-            });
-        }
-        commands.push({
-            line: `NPM_CONFIG_REGISTRY=${quoteShellArg(registry.value)} ${quoteShellArg(command)} plugin install ${quoteShellArg(dirInPrefix)}`,
-        });
-    }
-    return { ok: true, commands, line: mergeLines(commands) };
-}
-export function resolvePluginSource(source, env, options = {}) {
-    if (source === undefined)
-        return { ok: false, problem: 'not-declared' };
-    const command = options.command ?? 'opencli';
-    if (source.kind === 'git') {
-        const url = source.url.trim();
-        return url === '' ? { ok: false, problem: 'malformed' } : installOne(command, url);
-    }
-    if (source.kind === 'npm')
-        return npmSource(source, env, options);
-    const value = source.env === undefined ? { ok: false } : envValue(env, source.env);
-    if (value.ok)
-        return installOne(command, value.value);
-    if (source.path !== undefined && source.path.trim() !== '')
-        return installOne(command, source.path.trim());
-    return { ok: false, problem: 'env-missing', env: source.env ?? '' };
-}