@dsh-workbench/shared 1.1.8 → 1.1.9

package/src/host/bundle-manager.ts

@@ -0,0 +1,195 @@
+import type { DshHostContext } from '../api/dsh.js';
+import { RESTART_REASONS } from '../contract/protocol/bundle-install.js';
+import type { BundleManager } from './adapter-types.js';
+import type {
+  BundleChange,
+  BundleInspection,
+  BundleRegistries,
+  BundleRegistry,
+} from '../contract/protocol/bundle-install.js';
+
+const MANAGER_SERVICE = 'pluginManager';
+
+interface PluginManagerFace {
+  registries?(): Promise<unknown>;
+  inspect?(spec: string, options?: { readonly registry?: BundleRegistry }): Promise<unknown>;
+  installBundle?(spec: string, options?: unknown): Promise<unknown>;
+  removeBundle?(name: string): Promise<unknown>;
+  setBundleEnabled?(name: string, enabled: boolean): Promise<unknown>;
+  cancelInstall?(requestId: string): Promise<unknown>;
+}
+
+const APPLICATIONS = ['applied', 'restart-required', 'overridden', 'failed', 'cancelled'] as const;
+const STAGES = ['install', 'enable', 'remove'] as const;
+const PROBLEMS = [
+  'invalid-spec',
+  'already-installed',
+  'not-found',
+  'not-a-package',
+  'not-a-bundle',
+  'not-a-workbench-module',
+  'network',
+  'unknown',
+] as const;
+const SPEC_KINDS = ['registry', 'path', 'git', 'tarball'] as const;
+const FAILURE_KINDS = [
+  'pnpm-missing',
+  'timeout',
+  'not-found',
+  'no-matching-version',
+  'network',
+  'disk-full',
+  'permission',
+  'build-blocked',
+  'integrity',
+  'unknown',
+] as const;
+const CANCELLATIONS = ['cancelled', 'too-late', 'not-running'] as const;
+
+function asRecord(value: unknown): Readonly<Record<string, unknown>> | undefined {
+  return typeof value === 'object' && value !== null ? (value as Readonly<Record<string, unknown>>) : undefined;
+}
+
+function asText(value: unknown): string {
+  return typeof value === 'string' ? value : '';
+}
+
+function pick<T extends string>(allowed: readonly T[], value: unknown): T | undefined {
+  return typeof value === 'string' && (allowed as readonly string[]).includes(value) ? (value as T) : undefined;
+}
+
+function asRegistry(value: unknown): BundleRegistry | undefined {
+  if (value === null) return null;
+  return typeof value === 'string' ? value : undefined;
+}
+
+function asTextArray(value: unknown): string[] {
+  return Array.isArray(value) ? value.filter((item): item is string => typeof item === 'string') : [];
+}
+
+function asRegistries(raw: unknown): BundleRegistries | null {
+  const record = asRecord(raw);
+  if (record === undefined) return null;
+  const registry = asRegistry(record.registry);
+  if (registry === undefined) return null;
+  return {
+    registry,
+    fallbackRegistries: asTextArray(record.fallbackRegistries),
+    resolved: typeof record.resolved === 'string' ? record.resolved : null,
+  };
+}
+
+function asPackageResult(raw: unknown) {
+  const record = asRecord(raw);
+  if (record === undefined) return undefined;
+  const kind = pick(FAILURE_KINDS, record.kind);
+  return {
+    exitCode: typeof record.exitCode === 'number' ? record.exitCode : -1,
+    output: asText(record.output),
+    truncated: record.truncated === true,
+    logPath: asText(record.logPath),
+    ...(kind === undefined ? {} : { kind }),
+  };
+}
+
+function asChange(raw: unknown): BundleChange | null {
+  const record = asRecord(raw);
+  if (record === undefined) return null;
+  const application = pick(APPLICATIONS, record.application);
+  const stage = pick(STAGES, record.stage);
+  if (application === undefined || stage === undefined) return null;
+  const error = asRecord(record.error);
+  const packageResult = asPackageResult(record.packageResult);
+  const pendingBuilds = asTextArray(record.pendingBuilds);
+  const restartReason = pick(RESTART_REASONS, record.restartReason);
+  const failedAt = pick(['registry', 'spec-host'] as const, record.failedAt);
+  const bundle = asText(record.bundle);
+  const version = asText(record.version);
+  const errorCode = error === undefined ? '' : asText(error.code);
+  const errorDetail = error === undefined ? '' : asText(error.diagnostic);
+  return {
+    application,
+    stage,
+    changed: record.changed === true,
+    target: asText(record.target),
+    ...(bundle === '' ? {} : { bundle }),
+    ...(version === '' ? {} : { version }),
+    ...(errorCode === '' ? {} : { errorCode }),
+    ...(errorDetail === '' ? {} : { errorDetail }),
+    ...(packageResult === undefined ? {} : { packageResult }),
+    ...(pendingBuilds.length === 0 ? {} : { pendingBuilds }),
+    ...(restartReason === undefined ? {} : { restartReason }),
+    ...(failedAt === undefined ? {} : { failedAt }),
+  };
+}
+
+function asInspection(raw: unknown): BundleInspection | null {
+  const record = asRecord(raw);
+  if (record === undefined) return null;
+  const status = asText(record.status);
+  if (status === 'refused') {
+    const problem = pick(PROBLEMS, record.problem) ?? 'unknown';
+    const registries = Array.isArray(record.registries)
+      ? record.registries.map(asRegistry).filter((item): item is BundleRegistry => item !== undefined)
+      : [];
+    return {
+      status: 'refused',
+      problem,
+      reason: asText(record.reason),
+      ...(registries.length === 0 ? {} : { registries }),
+    };
+  }
+  if (status !== 'accepted') return null;
+  const kind = pick(SPEC_KINDS, record.kind);
+  const registry = asRegistry(record.registry);
+  if (kind === undefined || registry === undefined) return null;
+  const name = asText(record.name);
+  const version = asText(record.version);
+  const description = asText(record.description);
+  const host = asText(record.host);
+  return {
+    status: 'accepted',
+    kind,
+    bundle: typeof record.bundle === 'boolean' ? record.bundle : null,
+    registry,
+    ...(name === '' ? {} : { name }),
+    ...(version === '' ? {} : { version }),
+    ...(description === '' ? {} : { description }),
+    ...(host === '' ? {} : { host }),
+  };
+}
+
+export function readBundleManager(ctx: DshHostContext): BundleManager | undefined {
+  const face = ctx.get<PluginManagerFace>(MANAGER_SERVICE);
+  if (face === undefined) return undefined;
+  if (typeof face.installBundle !== 'function' || typeof face.removeBundle !== 'function') return undefined;
+  return {
+    async registries() {
+      if (typeof face.registries !== 'function') return null;
+      return asRegistries(await face.registries());
+    },
+    async inspect(spec, registry) {
+      if (typeof face.inspect !== 'function') return null;
+      return asInspection(await face.inspect(spec, registry === undefined ? undefined : { registry }));
+    },
+    async install(request) {
+      const options = {
+        ...(request.registry === undefined ? {} : { registry: request.registry }),
+        ...(request.requestId === undefined ? {} : { requestId: request.requestId }),
+        ...(request.approvedBuilds === undefined ? {} : { approvedBuilds: request.approvedBuilds }),
+      };
+      return asChange(await face.installBundle?.(request.spec, options));
+    },
+    async remove(name) {
+      return asChange(await face.removeBundle?.(name));
+    },
+    async setEnabled(name, enabled) {
+      if (typeof face.setBundleEnabled !== 'function') return null;
+      return asChange(await face.setBundleEnabled(name, enabled));
+    },
+    async cancel(requestId) {
+      if (typeof face.cancelInstall !== 'function') return null;
+      return pick(CANCELLATIONS, (asRecord(await face.cancelInstall(requestId)) ?? {}).status) ?? null;
+    },
+  };
+}

package/src/host/cli.ts

@@ -3,7 +3,9 @@ import type { CliPort } from '../contract/cli.js';
 import { adaptersOf } from './adapters.js';
 
 export function cliPortOf(ctx: DshHostContext): CliPort {
-  return { command: adaptersOf(ctx).runtime.opencliCommand(ctx).command };
+  const commands = adaptersOf(ctx).runtime.commands(ctx);
+  const first = Object.values(commands)[0];
+  return { command: first ?? '' };
 }
 
 export function cliCommandOf(ctx: DshHostContext): string {

package/src/host/config-sync.ts

@@ -0,0 +1,386 @@
+import { existsSync, readFileSync, readdirSync, renameSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import type { PostResource, RouteHandler } from './http.js';
+import type { ConfigSyncProfile, ConfigSyncRow, ConfigSyncSnapshot } from '../contract/protocol/config-sync.js';
+import { CONFIG_SYNC_RESOURCE } from '../contract/protocol/config-sync.js';
+
+export interface PatchBlock {
+  readonly key: string;
+  readonly id: string;
+  readonly insert: boolean;
+  readonly body: string;
+  readonly names: readonly string[];
+}
+
+interface SpannedBlock extends PatchBlock {
+  readonly from: number;
+  readonly to: number;
+}
+
+const ID_LINE = /^- id:[ \t]*"?([^"\s#]+)/;
+const INSERT_LINE = /^- insert:[ \t]*$/;
+const NESTED_ID = /^[ \t]+-[ \t]*id:[ \t]*"?([^"\s#]+)/;
+const NAME_LINE = /^[ \t]*-?[ \t]*name:[ \t]*['"]?([^'"\s#]+)/;
+const COMMENT_LINE = /^[ \t]*#/;
+const ISOLATION_IDS = new Set([
+  'session-persistence-jsonl',
+  'storage-json',
+  'attachment-local',
+  'sandbox-policy',
+]);
+
+function trimmedTail(lines: readonly string[]): readonly string[] {
+  let end = lines.length;
+  while (end > 0 && (lines[end - 1] ?? '').trim() === '') end -= 1;
+  return lines.slice(0, end);
+}
+
+function matched(text: string, pattern: RegExp): string | undefined {
+  const found = pattern.exec(text);
+  return found === null ? undefined : found[1];
+}
+
+function blockOf(body: string, index: number): PatchBlock {
+  const lines = body.split('\n');
+  const first = lines[0] ?? '';
+  const id = matched(first, ID_LINE);
+  const nested = lines.flatMap((line) => {
+    const one = matched(line, NESTED_ID);
+    return one === undefined ? [] : [one];
+  });
+  const insert = id === undefined && INSERT_LINE.test(first);
+  const label = id ?? nested.join(', ');
+  const key = id !== undefined ? `id:${id}` : insert ? `insert:${nested.join(', ')}` : `block:${String(index)}`;
+  const names = lines.flatMap((line) => {
+    const one = matched(line, NAME_LINE);
+    return one === undefined ? [] : [one];
+  });
+  return { key, id: label === '' ? key : label, insert, body, names };
+}
+
+function spannedBlocks(text: string): SpannedBlock[] {
+  const lines = text.split('\n');
+  const starts: number[] = [];
+  lines.forEach((line, index) => {
+    if (/^- /.test(line) || line === '-') starts.push(index);
+  });
+  const blocks: SpannedBlock[] = [];
+  for (let i = 0; i < starts.length; i += 1) {
+    const from = starts[i] ?? 0;
+    const to = i + 1 < starts.length ? (starts[i + 1] ?? lines.length) : lines.length;
+    const body = trimmedTail(lines.slice(from, to)).join('\n');
+    if (body.trim() === '') continue;
+    blocks.push({ ...blockOf(body, blocks.length), from, to });
+  }
+  return blocks;
+}
+
+export function patchBlocks(text: string): PatchBlock[] {
+  return spannedBlocks(text).map(({ from: _from, to: _to, ...block }) => block);
+}
+
+export function normalizeBlock(body: string): string {
+  return body
+    .split('\n')
+    .map((line) => line.replace(/\s+$/, ''))
+    .filter((line) => line.trim() !== '' && !COMMENT_LINE.test(line))
+    .join('\n');
+}
+
+function rewriteForTarget(body: string, self: string): string {
+  if (self === '' || self === 'workbench') return body;
+  return body.replace(/(dshHomePath\(\s*['"])workbench(?=[/'"])/g, `$1${self}`);
+}
+
+function syncable(block: PatchBlock): boolean {
+  return !block.insert && !ISOLATION_IDS.has(block.id);
+}
+
+export function syncRows(
+  source: readonly PatchBlock[],
+  own: readonly PatchBlock[],
+  missing: (block: PatchBlock) => readonly string[],
+): ConfigSyncRow[] {
+  const mine = new Map(own.map((block) => [block.key, block]));
+  const rows: ConfigSyncRow[] = [];
+  for (const block of source) {
+    if (!syncable(block)) continue;
+    const here = mine.get(block.key);
+    if (here !== undefined && normalizeBlock(here.body) === normalizeBlock(block.body)) continue;
+    rows.push({
+      key: block.key,
+      id: block.id,
+      state: here === undefined ? 'new' : 'differs',
+      body: block.body,
+      ownBody: here === undefined ? null : here.body,
+      missing: missing(block),
+    });
+  }
+  return rows;
+}
+
+function replaceBlocks(text: string, blocks: readonly PatchBlock[]): string {
+  const wanted = new Map(blocks.map((block) => [block.key, block]));
+  const spans = spannedBlocks(text).filter((span) => wanted.has(span.key));
+  const lines = text.split('\n');
+  for (const span of [...spans].reverse()) {
+    const replacement = (wanted.get(span.key)?.body ?? '').split('\n');
+    lines.splice(span.from, span.to - span.from, ...replacement);
+  }
+  return lines.join('\n');
+}
+
+function appendBlocks(text: string, blocks: readonly PatchBlock[]): string {
+  const kept = text
+    .split('\n')
+    .filter((line) => line.trim() !== '[]')
+    .join('\n')
+    .replace(/\s+$/, '');
+  let out = kept === '' ? '' : `${kept}\n`;
+  for (const block of blocks) out += `\n${block.body}\n`;
+  return out;
+}
+
+export function mergeBlocks(
+  ownText: string,
+  incoming: readonly PatchBlock[],
+  overwrite: ReadonlySet<string>,
+): { ok: true; text: string; written: string[]; skipped: string[] } | { ok: false; reason: string } {
+  const own = patchBlocks(ownText);
+  const mine = new Set(own.map((block) => block.key));
+  const written: string[] = [];
+  const skipped: string[] = [];
+  const take: PatchBlock[] = [];
+  for (const block of incoming) {
+    if (!mine.has(block.key) || overwrite.has(block.key)) {
+      take.push(block);
+      written.push(block.id);
+      continue;
+    }
+    skipped.push(block.id);
+  }
+  if (take.length === 0) return { ok: true, text: ownText, written, skipped };
+  const replaced = replaceBlocks(ownText, take.filter((block) => mine.has(block.key)));
+  const text = appendBlocks(
+    replaced,
+    take.filter((block) => !mine.has(block.key)),
+  );
+  const check = patchBlocks(text);
+  const expected = new Set([...mine, ...take.map((block) => block.key)]);
+  if (check.length !== expected.size || new Set(check.map((block) => block.key)).size !== expected.size) {
+    return { ok: false, reason: '写入前的自检没过：行的 id 会重复或丢行' };
+  }
+  return { ok: true, text, written, skipped };
+}
+
+export function readPatchBlocks(
+  path: string,
+): { ok: true; text: string; blocks: PatchBlock[] } | { ok: false; reason: string } {
+  try {
+    const text = readFileSync(path, 'utf8');
+    return { ok: true, text, blocks: patchBlocks(text) };
+  } catch (error) {
+    return { ok: false, reason: error instanceof Error ? error.message : String(error) };
+  }
+}
+
+function patchMode(path: string): number {
+  try {
+    return statSync(path).mode & 0o777;
+  } catch {
+    return 0o644;
+  }
+}
+
+export function writePatchFile(path: string, text: string): void {
+  const mode = patchMode(path);
+  const tmp = `${path}.wb-sync-${String(process.pid)}`;
+  writeFileSync(tmp, text, { mode });
+  try {
+    renameSync(tmp, path);
+  } catch (error) {
+    try {
+      unlinkSync(tmp);
+    } catch {
+      throw error;
+    }
+    throw error;
+  }
+}
+
+export interface ConfigSyncDeps {
+  readonly home: string;
+  readonly self: string;
+  readonly profileDir: string | null;
+  readonly reconcile?: (() => Promise<boolean | void>) | undefined;
+}
+
+export function configSyncHandler(deps: ConfigSyncDeps): RouteHandler {
+  return (search) => ({ ok: true, ...configSyncSnapshot(deps, search.get('source') ?? undefined) });
+}
+
+function textOf(value: unknown): string {
+  return typeof value === 'string' ? value : '';
+}
+
+function profileDependencies(dir: string): ReadonlySet<string> {
+  try {
+    const manifest = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8')) as {
+      dependencies?: Record<string, unknown>;
+    };
+    return new Set(Object.keys(manifest.dependencies ?? {}));
+  } catch {
+    return new Set();
+  }
+}
+
+function profileNames(profilesDir: string): readonly string[] {
+  try {
+    return readdirSync(profilesDir, { withFileTypes: true })
+      .filter((entry) => entry.isDirectory() || entry.isSymbolicLink())
+      .map((entry) => entry.name)
+      .filter((name) => existsSync(join(profilesDir, name, 'package.json')))
+      .sort((a, b) => a.localeCompare(b));
+  } catch {
+    return [];
+  }
+}
+
+export function configSyncSnapshot(deps: ConfigSyncDeps, asked?: string): ConfigSyncSnapshot {
+  const profilesDir = join(deps.home, 'profiles');
+  const names = profileNames(profilesDir);
+  const others = names.filter((name) => name !== deps.self);
+  const base = {
+    self: deps.self,
+    home: deps.home,
+  };
+  if (deps.profileDir === null) {
+    return {
+      ...base,
+      source: '',
+      profiles: [],
+      rows: [],
+      emptyProviders: false,
+      reason: '拿不到当前 profile 目录',
+    };
+  }
+  const own = readPatchBlocks(join(deps.profileDir, 'cordis.patch.yml'));
+  const emptyProviders = own.ok && !own.blocks.some((block) => block.key.startsWith('id:llm-'));
+  const ownBlocks = own.ok ? own.blocks : [];
+  const profiles: ConfigSyncProfile[] = others.map((name) => {
+    const read = readPatchBlocks(join(profilesDir, name, 'cordis.patch.yml'));
+    const blocks = read.ok
+      ? read.blocks
+          .filter(syncable)
+          .map((block) => ({ ...block, body: rewriteForTarget(block.body, deps.self) }))
+      : [];
+    return {
+      name,
+      readable: read.ok,
+      candidates: read.ok ? syncRows(blocks, ownBlocks, () => []).length : 0,
+    };
+  });
+  if (others.length === 0) {
+    return {
+      ...base,
+      source: '',
+      profiles,
+      rows: [],
+      emptyProviders,
+      reason: '这台机器上只有当前这个 profile，没有可同步的来源',
+    };
+  }
+  const source = others.includes(asked ?? '') ? (asked ?? '') : others.includes('web') ? 'web' : (others[0] ?? '');
+  const sourceDir = join(profilesDir, source);
+  const read = readPatchBlocks(join(sourceDir, 'cordis.patch.yml'));
+  if (!read.ok) {
+    return { ...base, source, profiles, rows: [], emptyProviders, reason: read.reason };
+  }
+  if (!own.ok) {
+    return { ...base, source, profiles, rows: [], emptyProviders, reason: own.reason };
+  }
+  const declared = profileDependencies(sourceDir);
+  const modulesDir = join(deps.profileDir, 'node_modules');
+  const sourceBlocks = read.blocks
+    .filter(syncable)
+    .map((block) => ({ ...block, body: rewriteForTarget(block.body, deps.self) }));
+  const rows = syncRows(sourceBlocks, own.blocks, (block) =>
+    block.names.filter((name) => declared.has(name) && !existsSync(join(modulesDir, name))),
+  );
+  return { ...base, source, profiles, rows, emptyProviders };
+}
+
+export async function configSyncApply(
+  deps: ConfigSyncDeps,
+  payload: unknown,
+): Promise<{ ok: true; written: string[]; skipped: string[]; verified: boolean } | { ok: false; text: string }> {
+  if (deps.profileDir === null) return { ok: false, text: '拿不到当前 profile 目录，这次没写任何东西' };
+  const body = typeof payload === 'object' && payload !== null ? (payload as Record<string, unknown>) : {};
+  const source = textOf(body['source']);
+  const keys = new Set(
+    (Array.isArray(body['keys']) ? body['keys'] : []).map((item) => textOf(item)).filter((item) => item !== ''),
+  );
+  const overwrite = new Set(
+    (Array.isArray(body['overwrite']) ? body['overwrite'] : []).map((item) => textOf(item)),
+  );
+  if (source === '' || keys.size === 0) {
+    return { ok: false, text: '没说清从哪个 profile 同步哪几行' };
+  }
+  const profilesDir = join(deps.home, 'profiles');
+  if (!profileNames(profilesDir).includes(source)) return { ok: false, text: `没有这个 profile：${source}` };
+  if (source === deps.self) return { ok: false, text: '来源不能是工作台自己' };
+  const sourceDir = join(profilesDir, source);
+  const read = readPatchBlocks(join(sourceDir, 'cordis.patch.yml'));
+  if (!read.ok) return { ok: false, text: `读不到 ${source} 的配置：${read.reason}` };
+  const own = readPatchBlocks(join(deps.profileDir, 'cordis.patch.yml'));
+  if (!own.ok) return { ok: false, text: `读不到工作台自己的配置：${own.reason}` };
+  if (read.blocks.some((block) => block.insert && keys.has(block.key))) {
+    return { ok: false, text: '插件行不同步：先把插件装到工作台这边，再同步它的设置' };
+  }
+  const picked = read.blocks
+    .filter((block) => keys.has(block.key) && syncable(block))
+    .map((block) => ({ ...block, body: rewriteForTarget(block.body, deps.self) }));
+  if (picked.length === 0) {
+    return { ok: false, text: '选中的行在来源里已经找不到了，重新读一遍再试' };
+  }
+  const merged = mergeBlocks(own.text, picked, overwrite);
+  if (!merged.ok) return { ok: false, text: merged.reason };
+  const patchPath = join(deps.profileDir, 'cordis.patch.yml');
+  const patchChanged = merged.text !== own.text;
+  try {
+    if (patchChanged) writePatchFile(patchPath, merged.text);
+  } catch (error) {
+    return { ok: false, text: `写不进去：${error instanceof Error ? error.message : String(error)}` };
+  }
+  if (deps.reconcile === undefined) {
+    return { ok: true, written: merged.written, skipped: merged.skipped, verified: false };
+  }
+  try {
+    const verified = await deps.reconcile();
+    if (verified === false) {
+      return { ok: true, written: merged.written, skipped: merged.skipped, verified: false };
+    }
+  } catch (error) {
+    if (patchChanged) {
+      try {
+        writePatchFile(patchPath, own.text);
+      } catch {
+        return { ok: false, text: `写进去了，但启动检查没通过：${error instanceof Error ? error.message : String(error)}。原来的设置没能恢复，手动检查一下` };
+      }
+    }
+    try {
+      await deps.reconcile();
+    } catch {
+      return { ok: false, text: `写进去了，但启动检查没通过：${error instanceof Error ? error.message : String(error)}。已恢复原来的设置` };
+    }
+    return { ok: false, text: `写进去了，但启动检查没通过：${error instanceof Error ? error.message : String(error)}。已恢复原来的设置` };
+  }
+  return { ok: true, written: merged.written, skipped: merged.skipped, verified: true };
+}
+
+export function configSyncAction(deps: ConfigSyncDeps): PostResource {
+  return {
+    resource: CONFIG_SYNC_RESOURCE,
+    handle: (payload: unknown) => configSyncApply(deps, payload),
+  };
+}

package/src/host/dsh-plugins.ts

@@ -0,0 +1,60 @@
+import type { DshHostContext } from '../api/dsh.js';
+import type { RouteHandler } from './http.js';
+import type { DshPluginRow, DshPluginsSnapshot } from '../contract/protocol/dsh-plugins.js';
+
+const MANAGER_SERVICE = 'pluginManager';
+
+interface DshPluginManagerFace {
+  listBundles?(): Promise<unknown>;
+  listPlugins?(): Promise<unknown>;
+}
+
+function asRecord(value: unknown): Readonly<Record<string, unknown>> | undefined {
+  return typeof value === 'object' && value !== null ? (value as Readonly<Record<string, unknown>>) : undefined;
+}
+
+function asArray(value: unknown): readonly unknown[] {
+  if (Array.isArray(value)) return value;
+  const record = asRecord(value);
+  if (record === undefined) return [];
+  for (const key of ['rows', 'items', 'list', 'bundles', 'plugins']) {
+    const inner = record[key];
+    if (Array.isArray(inner)) return inner;
+  }
+  return [];
+}
+
+function asText(value: unknown): string {
+  return typeof value === 'string' ? value : '';
+}
+
+function rowOf(value: unknown): DshPluginRow | undefined {
+  const record = asRecord(value);
+  if (record === undefined) return undefined;
+  const name = asText(record.name) || asText(record.id);
+  if (name === '') return undefined;
+  return { name, version: asText(record.version), enabled: record.disabled !== true && record.enabled !== false };
+}
+
+function rowsOf(value: unknown): readonly DshPluginRow[] {
+  const rows: DshPluginRow[] = [];
+  for (const item of asArray(value)) {
+    const row = rowOf(item);
+    if (row !== undefined) rows.push(row);
+  }
+  return rows;
+}
+
+export async function readDshPlugins(ctx: DshHostContext): Promise<DshPluginsSnapshot> {
+  const manager = ctx.get<DshPluginManagerFace>(MANAGER_SERVICE);
+  if (manager === undefined) return { available: false, bundles: [], plugins: [] };
+  const [bundles, plugins] = await Promise.all([
+    manager.listBundles === undefined ? undefined : manager.listBundles(),
+    manager.listPlugins === undefined ? undefined : manager.listPlugins(),
+  ]);
+  return { available: true, bundles: rowsOf(bundles), plugins: rowsOf(plugins) };
+}
+
+export function dshPluginsHandler(ctx: DshHostContext): RouteHandler {
+  return () => readDshPlugins(ctx);
+}

package/src/host/extension.ts

@@ -35,7 +35,7 @@ export function extensionCallerOf(
       const command = [need.name, ...args].join(' ');
       const advice =
         code === 'cli-unclassified'
-          ? `这条命令（${command}）在这份 ${need.name} 插件里可能不存在（插件版本旧就会缺）：用 workbench_modules_update（id=${callerOptions.suiteId ?? need.name}）升级，或在面板的模块状态里点更新，再重试。终端确认：opencli ${need.name} ${args[0] ?? ''} --help`
+          ? `这条命令（${command}）在这份 ${need.name} 插件里可能不存在（插件版本旧就会缺）：用 workbench_modules_update（id=${callerOptions.suiteId ?? need.name}）升级，或在面板的模块状态里点更新，再重试。终端确认：${need.name} ${args[0] ?? ''} --help`
           : undefined;
       const hint =
         advice === undefined