@dsh-workbench/shared 1.1.7 → 1.1.9

package/src/host/release-probe.ts

@@ -0,0 +1,202 @@
+import type { DshShell } from '../api/dsh.js';
+import type { PluginRelease } from '../contract/unit.js';
+
+import { RELEASE_PACKAGES } from './release-packages.generated.js';
+import { VERSION_CHECK_TIMEOUT_MS, VERSION_CHECK_TTL_MS } from '../config/constants.js';
+import { isValidVersion } from './version.js';
+import { parseJsonLoose } from '../lib/text.js';
+import { quoteShellArg } from './shell-text.js';
+import { runShell } from './shell.js';
+
+function cacheFlag(cacheDir: string | undefined): string {
+  return cacheDir === undefined ? '' : ` --cache ${quoteShellArg(cacheDir)}`;
+}
+
+export function parseLedgerVersion(
+  stdout: string,
+  name: string,
+): string | undefined {
+  const parsed = parseJsonLoose(stdout);
+  if (typeof parsed !== "object" || parsed === null) return undefined;
+  const entry = (parsed as { dependencies?: Record<string, unknown> })
+    .dependencies?.[name];
+  if (typeof entry !== "object" || entry === null) return undefined;
+  const version = (entry as { version?: unknown }).version;
+  return typeof version === "string" && isValidVersion(version.trim())
+    ? version.trim()
+    : undefined;
+}
+
+function parseVersion(stdout: string): string | undefined {
+  const value = stdout.trim();
+  return isValidVersion(value) ? value : undefined;
+}
+
+interface CacheEntry {
+  readonly at: number;
+  readonly value: string | undefined;
+}
+
+
+export interface ReleaseProbe {
+  latestVersion(options: LatestVersionOptions): Promise<string | undefined>;
+  missingReleaseParts(options: MissingPartsOptions): Promise<readonly string[]>;
+  probeRelease(options: ProbeReleaseOptions): Promise<PluginRelease | undefined>;
+  reset(): void;
+}
+
+export function createReleaseProbe(): ReleaseProbe {
+  const latestCache = new Map<string, CacheEntry>();
+  const existsCache = new Map<string, ExistsEntry>();
+
+  return {
+    latestVersion: async (options) => latestVersionOf(latestCache, options),
+    missingReleaseParts: async (options) => missingPartsOf(latestCache, existsCache, options),
+    probeRelease: async (options) => probeOf(latestCache, options),
+    reset: () => {
+      latestCache.clear();
+      existsCache.clear();
+    },
+  };
+}
+
+interface LatestVersionOptions {
+  readonly shell: DshShell;
+  readonly name: string;
+  readonly registry: string;
+  readonly force?: boolean;
+  readonly cacheDir?: string | undefined;
+}
+
+interface MissingPartsOptions {
+  readonly shell: DshShell;
+  readonly name: string;
+  readonly registry: string;
+  readonly version: string;
+  readonly force?: boolean;
+  readonly cacheDir?: string | undefined;
+}
+
+interface ProbeReleaseOptions {
+  readonly shell: DshShell;
+  readonly package: string;
+  readonly registry?: string | undefined;
+  readonly force?: boolean;
+  readonly cacheDir?: string | undefined;
+  readonly prefix?: string | undefined;
+}
+
+async function latestVersionOf(latestCache: Map<string, CacheEntry>, options: {
+  shell: DshShell;
+  name: string;
+  registry: string;
+  force?: boolean;
+  cacheDir?: string | undefined;
+}): Promise<string | undefined> {
+  const { shell, name, registry, force = false, cacheDir } = options;
+  const key = `${registry}|${name}`;
+  const hit = latestCache.get(key);
+  if (!force && hit !== undefined && Date.now() - hit.at < VERSION_CHECK_TTL_MS)
+    return hit.value;
+
+  const result = await runShell(
+    shell,
+    `npm view ${quoteShellArg(name)} version --registry ${quoteShellArg(registry)}${cacheFlag(cacheDir)}`,
+    { timeoutMs: VERSION_CHECK_TIMEOUT_MS },
+  ).catch(() => undefined);
+  const read = result?.exitCode === 0 ? parseVersion(result.stdout) : undefined;
+  latestCache.set(key, { at: Date.now(), value: read });
+  return read;
+}
+
+interface ExistsEntry {
+  readonly at: number;
+  readonly value: boolean;
+}
+
+
+async function versionExists(
+  existsCache: Map<string, ExistsEntry>,
+  options: {
+  shell: DshShell;
+  name: string;
+  version: string;
+  registry: string;
+  force?: boolean;
+  cacheDir?: string | undefined;
+}): Promise<boolean> {
+  const { shell, name, version, registry, force = false, cacheDir } = options;
+  const key = `${registry}|${name}@${version}`;
+  const hit = existsCache.get(key);
+  if (!force && hit !== undefined && (hit.value || Date.now() - hit.at < VERSION_CHECK_TTL_MS))
+    return hit.value;
+
+  const result = await runShell(
+    shell,
+    `npm view ${quoteShellArg(`${name}@${version}`)} version --registry ${quoteShellArg(registry)}${cacheFlag(cacheDir)}`,
+    { timeoutMs: VERSION_CHECK_TIMEOUT_MS },
+  ).catch(() => undefined);
+  const value = result?.exitCode === 0 && parseVersion(result.stdout) !== undefined;
+  existsCache.set(key, { at: Date.now(), value });
+  return value;
+}
+
+async function missingPartsOf(
+  latestCache: Map<string, CacheEntry>,
+  existsCache: Map<string, ExistsEntry>,
+  options: {
+  shell: DshShell;
+  name: string;
+  registry: string;
+  version: string;
+  force?: boolean;
+  cacheDir?: string | undefined;
+}): Promise<readonly string[]> {
+  const { shell, name, registry, version, force = false, cacheDir } = options;
+  const checked = await Promise.all(
+    RELEASE_PACKAGES.filter((part) => part !== name).map(async (part) => ({
+      part,
+      present: await versionExists(existsCache, { shell, name: part, version, registry, force, cacheDir }),
+    })),
+  );
+  return checked.filter((entry) => !entry.present).map((entry) => entry.part);
+}
+
+async function probeOf(
+  latestCache: Map<string, CacheEntry>,
+  options: {
+  shell: DshShell;
+  package: string;
+  registry?: string | undefined;
+  force?: boolean;
+  cacheDir?: string | undefined;
+  prefix?: string | undefined;
+}): Promise<PluginRelease | undefined> {
+  const { shell, package: pkg, registry, force = false, cacheDir, prefix } = options;
+  if (pkg === "") return undefined;
+
+  const ledger = await runShell(
+    shell,
+    `npm ls --prefix ${quoteShellArg(prefix ?? '')} ${quoteShellArg(pkg)} --json --depth=0${cacheFlag(cacheDir)}`,
+    { timeoutMs: VERSION_CHECK_TIMEOUT_MS },
+  ).catch(() => undefined);
+  const installed =
+    ledger === undefined ? undefined : parseLedgerVersion(ledger.stdout, pkg);
+  if (installed === undefined) return undefined;
+
+  const source =
+    registry === undefined || registry.trim() === ""
+      ? undefined
+      : registry.trim();
+  const latest =
+    source === undefined
+      ? undefined
+      : await latestVersionOf(latestCache, { shell, name: pkg, registry: source, force, cacheDir });
+
+  return {
+    installed,
+    ...(latest === undefined ? {} : { latest }),
+  };
+}
+
+

package/src/host/shell.ts

@@ -1,6 +1,5 @@
 import type { DshShell } from '../api/dsh.js';
 import { GIT_TIMEOUT_MS } from '../config/constants.js';
-import { quoteShellArg } from './shell-text.js';
 
 export interface ShellResult {
   readonly exitCode: number | null;
@@ -41,11 +40,3 @@ export async function runShell(
     truncated: result.stdout.truncated || result.stderr.truncated,
   };
 }
-
-export function backgroundPrefix(): readonly string[] {
-  return [quoteShellArg('env'), quoteShellArg('OPENCLI_WINDOW=background')];
-}
-
-export function backgroundLine(command: string, argv: readonly string[]): string {
-  return [...backgroundPrefix(), quoteShellArg(command), ...argv.map(quoteShellArg)].join(' ');
-}

package/src/host/spec.ts

@@ -28,5 +28,5 @@ export function localDirOf(spec: string): string | undefined {
 }
 
 export function refusalReason(): string {
-  return '这个包既不是工作台的模块，也不是 opencli 的插件，装了也用不上';
+  return '这个包既不是工作台的模块，也不是运行时的插件，装了也用不上';
 }

package/src/host/supply-index.ts

@@ -1,5 +1,5 @@
 import type { ExtensionNeed, LibNeed, Need, SupplySource } from '../contract/needs.js';
-import { npmRegistryOf } from './plugin-source.js';
+import { npmRegistryOf } from './npm-registry.js';
 
 export interface SupplyDeclaration {
   readonly id: string;
@@ -8,6 +8,7 @@ export interface SupplyDeclaration {
 
 export interface SupplyIndexOptions {
   readonly env?: Readonly<Record<string, string | undefined>>;
+  readonly packagePrefix?: string | undefined;
 }
 
 export interface SupplyEntry {
@@ -61,8 +62,8 @@ function text(value: string | undefined): string {
   return value === undefined ? '' : value.trim();
 }
 
-function conventionPackage(name: string): string {
-  return `opencli-plugin-${name}`;
+function conventionPackage(name: string, prefix: string): string {
+  return `${prefix}${name}`;
 }
 
 function nativeSourcePackage(source: SupplySource): string {
@@ -71,13 +72,13 @@ function nativeSourcePackage(source: SupplySource): string {
   return `local:${text(source.env) || text(source.path)}`;
 }
 
-function packageOf(need: ExtensionNeed | LibNeed): string {
+function packageOf(need: ExtensionNeed | LibNeed, prefix: string): string {
   if (need.kind === 'lib') return text(need.name);
   const first = need.sources?.[0];
-  if (first === undefined) return conventionPackage(need.name);
+  if (first === undefined) return conventionPackage(need.name, prefix);
   if (first.kind === 'npm') {
     const pkg = text(first.package);
-    return pkg === '' ? conventionPackage(need.name) : pkg;
+    return pkg === '' ? conventionPackage(need.name, prefix) : pkg;
   }
   return nativeSourcePackage(first);
 }
@@ -180,6 +181,7 @@ export function buildSupplyIndex(
   options: SupplyIndexOptions = {},
 ): SupplyIndex {
   const env = options.env ?? {};
+  const prefix = options.packagePrefix ?? '';
   const entries = new Map<string, MutableEntry>();
   const byName = new Map<string, MutableEntry>();
   const conflicts: SupplyConflict[] = [];
@@ -206,7 +208,7 @@ export function buildSupplyIndex(
   for (const declaration of declarations) {
     for (const need of declaration.needs ?? []) {
       if (need.kind !== 'extension' && need.kind !== 'lib') continue;
-      const pkg = packageOf(need);
+      const pkg = packageOf(need, prefix);
       const entry = ensure(need.kind, pkg);
       if (!entry.names.includes(need.name)) entry.names.push(need.name);
       if (need.kind === 'extension') {

package/src/host/supply-port.ts

@@ -8,20 +8,30 @@ export function supplyPortOf(ctx: DshHostContext): SupplyPort {
   const set = adaptersOf(ctx);
   const env = set.supply;
   const modules = set.modules;
+  const pluginPackagePrefix = modules.pluginPackagePrefix;
+  const pluginManifestFile = modules.pluginManifestFile;
+  const cliCatalogPath = modules.cliCatalogPath;
+  const vendorPluginsDir = modules.vendorPluginsDir;
+  const runtimeInstallCommand = modules.runtimeInstallCommand;
   return {
     env,
     modules,
     resolvePluginSource: (source, environment, options) => env.resolvePluginSource(source, environment, options),
     libInstallCommand: (options) => env.libInstallCommand(options),
+    libUninstallCommand: (options) => env.libUninstallCommand(options),
     pluginInstallPlan: (options) => env.pluginInstallPlan(options),
     latestVersion: (options) => env.latestVersion(options),
     missingReleaseParts: (options) => env.missingReleaseParts(options),
     probeRelease: (options) => env.probeRelease(options),
     splitNpmSpec: (spec) => env.splitNpmSpec(spec),
+    isolatedRoot: () => modules.isolatedRoot(),
     isolatedHome: () => modules.isolatedHome(),
-    cliCatalogPath: () => modules.cliCatalogPath(),
-    vendorPluginsDir: () => modules.vendorPluginsDir(),
-    opencliInstallCommand: () => modules.opencliInstallCommand(),
+    ...(pluginPackagePrefix === undefined ? {} : { pluginPackagePrefix: () => pluginPackagePrefix() }),
+    ...(pluginManifestFile === undefined ? {} : { pluginManifestFile: () => pluginManifestFile() }),
+    ...(cliCatalogPath === undefined ? {} : { cliCatalogPath: () => cliCatalogPath() }),
+    ...(vendorPluginsDir === undefined ? {} : { vendorPluginsDir: () => vendorPluginsDir() }),
+    ...(runtimeInstallCommand === undefined ? {} : { runtimeInstallCommand: () => runtimeInstallCommand() }),
+    afterLibInstall: () => modules.afterLibInstall(),
     profileDirOf: (context) => modules.profileDirOf(context),
     profileModules: (dir) => modules.profileModules(dir),
     readInstalledModule: (dir, pkg) => modules.readInstalledModule(dir, pkg),

package/src/host/unit-face.ts

@@ -11,13 +11,14 @@ import type { DataReader } from '../contract/data.js';
 import type { LibReader } from '../contract/lib.js';
 import type { GitReader } from '../contract/git.js';
 import type { CommandReader } from '../contract/command.js';
+import type { HostKit } from './host-kit.js';
 
 export interface ToolScopeContext {
   readonly workspace: string | null;
   readonly preset: string | null;
 }
 
-export interface UnitMountDeps {
+export interface UnitMountDeps extends HostKit {
   readonly manifest: UnitManifest;
   readonly ctx: DshHostContext;
   readonly logger?: { info?(message: string): void; warn?(message: string): void } | undefined;

package/src/host/version.ts

@@ -19,12 +19,17 @@ export function isNewerVersion(latest: string, installed: string): boolean {
 }
 
 export function runningVersionOf(moduleUrl: string): string | undefined {
-  try {
-    const read = JSON.parse(readFileSync(new URL('../../package.json', moduleUrl), 'utf8')) as {
-      readonly version?: unknown;
-    };
-    return typeof read.version === 'string' && read.version !== '' ? read.version : undefined;
-  } catch {
-    return undefined;
+  for (const depth of ['../../package.json', '../package.json']) {
+    try {
+      const read = JSON.parse(readFileSync(new URL(depth, moduleUrl), 'utf8')) as {
+        readonly version?: unknown;
+        readonly name?: unknown;
+      };
+      if (typeof read.name !== 'string' || !read.name.startsWith('@dsh-workbench/')) continue;
+      return typeof read.version === 'string' && read.version !== '' ? read.version : undefined;
+    } catch {
+      continue;
+    }
   }
+  return undefined;
 }

package/src/host.ts

@@ -19,6 +19,31 @@ export * from './lib/git-address.js';
 export * from './api/blocker-table.js';
 export * from './contract/unit-declaration.js';
 export * from './host/board-fact.js';
+export * from './host/bundle-manager.js';
+export * from './host/installed-module.js';
+export * from './host/local-declaration.js';
+export * from './host/registry-declaration.js';
+export * from './host/release-probe.js';
+export * from './host/package-kind.js';
+export * from './host/package-content.js';
+export * from './host/package-route.js';
+export * from './host/lib-install.js';
+export * from './host/module-root.js';
+export * from './host/dsh-plugins.js';
+export * from './host/profile-registries.js';
+export * from './host/host-actions.js';
+export {
+  configSyncAction,
+  configSyncApply,
+  configSyncHandler,
+  configSyncSnapshot,
+  mergeBlocks,
+  normalizeBlock,
+  readPatchBlocks,
+  syncRows,
+  type ConfigSyncDeps,
+} from './host/config-sync.js';
+export * from './host/profile-create.js';
 export * from './host/context-ref.js';
 export * from './host/diy-debug.js';
 export * from './host/diy-record.js';
@@ -27,6 +52,12 @@ export * from './host/git.js';
 export * from './host/http.js';
 export * from './host/lib-capabilities.js';
 export * from './host/long-task.js';
+export * from './host/flow/types.js';
+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/host-kit.js';
 export * from './host/panel-state.js';
 export * from './host/plugin-ledger.js';
 export * from './host/time.js';
@@ -34,7 +65,6 @@ export * from './host/tokens.js';
 export * from './host/tool-approval.js';
 export * from './host/tool-kit.js';
 export * from './host/unit-face.js';
-export * from './host/opencli-runner.js';
 export * from './host/lib-runners.js';
 export * from './host/value-handoff.js';
 export * from './host/workspace-store.js';
@@ -45,9 +75,7 @@ export * from './host/shell-text.js';
 export * from './host/shell.js';
 export * from './host/data-error.js';
 export * from './host/install-failure.js';
-export * from './host/runtime-links.js';
 export * from './host/provision.js';
-export * from './host/channel-plugin.js';
 export * from './host/recipe.js';
 export * from './host/recipe-rules.js';
 export * from './host/release-packages.generated.js';
@@ -55,7 +83,6 @@ export * from './contract/unit-capability.js';
 export * from './contract/plugin-source.js';
 export * from './contract/cli.js';
 export * from './host/cli.js';
-export * from './host/command-name.js';
 export * from './host/browser.js';
 export * from './host/preflight.js';
 export * from './host/platform.js';
@@ -66,8 +93,8 @@ export * from './host/adapter-types.js';
 export * from './host/paths.js';
 export * from './host/plugin.js';
 export * from './host/spec.js';
-export * from './host/plugin-source.js';
-export * from './host/lib-install.js';
+export type { PluginSourceCommand, PluginSourceOptions, ResolvedPluginSource } from './contract/plugin-source.js';
+export * from './host/npm-registry.js';
 export * from './host/supply-index.js';
 export * from './host/patch.js';
 export * from './host/adapters.js';
@@ -75,6 +102,7 @@ export * from './host/adapter-set.js';
 export * from './host/needs.js';
 export * from './host/extension.js';
 export * from './host/port-types.js';
+export * from './host/adapter-contract.js';
 export * from './host/version-range.js';
 export * from './host/market-index.js';
 export * from './host/market-index-claim.js';

package/src/i18n/{index.test.ts → __tests__/index.test.ts}

@@ -1,7 +1,7 @@
 import { describe, expect, it } from 'vitest';
-import { en } from './en.js';
-import { dictionaries } from './index.js';
-import { zh } from './zh.js';
+import { en } from '../en.js';
+import { dictionaries } from '../index.js';
+import { zh } from '../zh.js';
 
 describe('dictionaries', () => {
   it('同时导出两种语言，且就是那两份字典', () => {

package/src/i18n/{merge.test.ts → __tests__/merge.test.ts}

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { mergeMessages, mergeMessagesSkipping } from './merge.js';
+import { mergeMessages, mergeMessagesSkipping } from '../merge.js';
 
 const base = { zh: { 'board.title': '看板' }, en: { 'board.title': 'Board' } };
 

package/src/i18n/{zh.test.ts → __tests__/zh.test.ts}

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'vitest';
-import { en } from './en.js';
-import { zh } from './zh.js';
+import { en } from '../en.js';
+import { zh } from '../zh.js';
 
 function placeholders(text: string): string[] {
   return [...text.matchAll(/\{(\w+)\}/g)].map((match) => match[1] ?? '').sort();

package/src/i18n/en.ts

@@ -79,7 +79,11 @@ export const en: Record<keyof WorkbenchMessages, string> = {
 
   'panels.title': 'Panel modules',
   'panels.groupBoardless': 'No-board modules',
-  'panels.groupPlugins': 'opencli plugins',
+  'panels.groupPlugins': 'Plugins',
+  'runtime.plugin': 'plugin',
+  'runtime.pluginOf': 'a plugin the runtime provides',
+  'runtime.pluginThing': 'a plugin',
+  'runtime.pluginArea': 'the plugin area',
   'panels.market.defaultHint': 'When on, it is on by default in every workspace; you can also turn it off for a single workspace in Panel setup.',
   'panels.market.defaultLabel': 'On by default everywhere',
   'panels.market.defaultLocked': 'Unusable right now — update or uninstall it first',
@@ -159,10 +163,6 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.market.confirmNo': 'Cancel',
   'panels.market.noMarketSource': 'The index has no newer version of this module (refresh the index and retry)',
   'panels.market.failed': 'Failed: {reason}',
-  'panels.market.askAgent': 'Ask the agent',
-  'panels.market.askAgentCopied': 'Copied',
-  'panels.market.askAgentText':
-    'This workbench module cannot be used: "{name}" (unit {unit}) — {reason}. Work out what is missing and how to add it, then confirm it works.',
   'panels.market.failure.permission': "Didn't install: no write access",
   'panels.market.failure.diskFull': "Didn't install: the disk is full",
   'panels.market.failure.sandbox': "Didn't install: the system blocked it",
@@ -202,7 +202,7 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.market.noSource': 'This module declares no install method — install it yourself',
   'panels.market.badSource': 'The install method is incomplete — install it yourself',
   'panels.market.empty': 'No modules available',
-  'panels.market.sectionPlugins': 'Installed opencli plugins',
+  'panels.market.sectionPlugins': 'Installed plugins',
   'panels.market.moduleOutdated': 'update available',
   'panels.market.updateNeedsWorkbench': 'this version needs a newer workbench first',
   'panels.market.updateIncompatible': 'the new version does not match this workbench, so it cannot be installed now',
@@ -240,7 +240,7 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.market.justNow': 'just now',
   'panels.market.minutesAgo': '{n} min ago',
   'panels.market.hoursAgo': '{n} h ago',
-  "panels.market.add.description": "Enter a module or opencli plugin package name, Git repository URL, or local directory path.",
+  "panels.market.add.description": "Enter a module or {plugin} package name, Git repository URL, or local directory path.",
   'panels.market.add.specPlaceholder': 'e.g. @dsh-workbench/module-hello',
   'panels.market.add.guideToggle': 'Install guide and examples',
   'panels.market.add.guideHide': 'Hide guide',
@@ -280,13 +280,13 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.market.add.problemNotFound': 'No such module found',
   'panels.market.add.problemNotPackage': 'That path does not exist or is not a valid module package',
   'panels.market.add.problemNotBundle':
-    'This package cannot be installed here: {reason}. This entry recognises workbench modules and opencli plugins by package name, and installs either; but a git URL or a tarball does not reveal what it is — if it is really one of those two, use its package name or a local folder instead.',
+    'This package cannot be installed here: {reason}. This entry recognises workbench modules and {plugin}s by package name, and installs either; but a git URL or a tarball does not reveal what it is — if it is really one of those two, use its package name or a local folder instead.',
   'panels.market.add.problemNotWorkbenchModule': 'This package does not match the workbench you are running, so installing it would not work. Pick another version, or ask the module author.',
-  'panels.market.add.problemNotModuleOrPlugin': 'This package is neither a workbench module nor an opencli plugin, so installing it would do nothing. Pick another version, or ask the package author.',
-  'panels.market.add.failureNotModuleOrPlugin': 'This package is neither a workbench module nor an opencli plugin, so installing it would do nothing',
-  'panels.market.add.installedPlugin': 'Installed: the opencli plugin {name}',
+  'panels.market.add.problemNotModuleOrPlugin': 'This package is neither a workbench module nor {pluginOf}, so installing it would do nothing. Pick another version, or ask the package author.',
+  'panels.market.add.failureNotModuleOrPlugin': 'This package is neither a workbench module nor {pluginOf}, so installing it would do nothing',
+  'panels.market.add.installedPlugin': 'Installed: {plugin} {name}',
   'panels.market.add.pluginPreview':
-    'This is an opencli plugin: it goes into the opencli plugin area and works as soon as it is installed — no restart.',
+    'This is {pluginThing}: it goes into {pluginArea} and works as soon as it is installed — no restart.',
   'panels.market.add.pluginAlias': 'Plugin name: {name}',
   'panels.market.add.problemNetwork': 'Cannot reach the module source; check the network and retry',
   'panels.market.add.problemUnknown': 'Cannot fetch module information: {reason}',
@@ -383,7 +383,7 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.discover.missingIndex': 'This repository has no {path} yet.',
   'panels.discover.initTitle': 'Initialize this repository as a module market index?',
   'panels.discover.initCta': 'Initialize market index',
-  'panels.discover.initWhat': 'It will write the index directory market/ and README.md on {branch}, commit once, and push. Modules you publish from this workbench will commit their build files under artifacts/<package-name>/<version>/ and their entry under market/<package-name>/<version>.json. The repository stays owned by its owner.',
+  'panels.discover.initWhat': 'It will write the index directory market/ and README.md on {branch}, commit once, and push. Modules you publish from this workbench will commit their build files under artifacts/<package-name>/ and their entry in market/<package-name>.json. The repository stays owned by its owner.',
   'panels.discover.initBranch': 'Branch',
   'panels.discover.initBranchHint': 'The index and build files go to this branch; an empty repository gets it created.',
   'panels.discover.initBranchBad': 'Use only letters, digits, dots, underscores, slashes, or dashes in a branch name.',
@@ -564,7 +564,7 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'blocker.forbidden.hint': 'You are signed in, but this project/repo is not permitted for your account.',
   'blocker.forbidden.open': 'Open permissions page',
   'blocker.timeout.hint': 'The background browser may not have started; retrying usually helps.',
-  'blocker.exec.hint': 'Make sure opencli is installed and runs from your terminal (which opencli).',
+  'blocker.exec.hint': 'Make sure the runtime is installed and runs from your terminal.',
   'blocker.unknown.title': 'Something went wrong',
   'panels.reading': 'Reading the panel setup…',
   'panels.cardBroken': 'This module will not render: {unit} ({reason})',
@@ -581,16 +581,11 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'env.stepFailed.shell': 'cannot reach the command line',
   'env.toolchain.ok': 'Looks good',
   'env.toolchain.warn': 'Almost ready',
-  'env.opencli.ok': 'Ready',
+  'env.runtime.ok': 'Ready',
   'env.bridge.ok': 'Connected',
   'env.bridge.short': 'Not connected yet',
   'env.bridge.why': 'Panel data uses the login state in your browser. Without this connection, modules cannot fetch data. It does not block startup: fix it, or enter the workbench first.',
   'env.bridge.hold': 'The browser is not connected yet \u2014 fix it below and hit Retry, or enter the workbench first.',
-  'env.bridge.daemon': 'The background service is not running. It usually starts by itself \u2014 run the command below in your terminal first.',
-  'env.bridge.extension': 'The browser extension is not connected. Make sure the browser is running and the extension is enabled; install it once from the store if needed (then hit Retry here).',
-  'env.bridge.extensionLink': 'Get the extension in the Chrome Web Store',
-  'env.bridge.profile': 'Several browser accounts are connected but none is the default: list them (command below), then pick one.',
-  'env.bridge.stale': 'The default browser account is stale (it names an extension instance that no longer exists): pick one again.',
   'env.bridge.unknown': 'Could not tell what went wrong. Expand the raw output and follow the steps in it.',
   'env.fix.title': 'How to fix it',
   '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.',
@@ -620,7 +615,8 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'env.copyCommand': 'Copy command',
   'env.copied': 'Copied',
   'env.step.toolchain': 'Runtime',
-  'env.step.opencli': 'Background tools',
+  'env.step.adapter': 'Runtime',
+  'env.step.runtime': 'Background tools',
   'env.step.bridge': 'Browser connection',
   'env.step.diy': 'DIY mode',
   'env.step.warm': 'Site sign-in',
@@ -722,6 +718,8 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'approval.publish.version': 'Version',
   'approval.publish.author': 'Author',
   'approval.publish.authorMissing': 'unsigned',
+  'approval.publish.labels': 'Labels',
+  'approval.publish.labelsMissing': 'none yet (1–2 picked on publish)',
   'approval.publish.owner': 'Owner',
   'approval.publish.ownerUnowned': 'originally unattributed',
   'approval.publish.ownerTaken': 'Owned by {owner}',

package/src/i18n/runtime-terms.ts

@@ -0,0 +1,26 @@
+import type { Translate } from '../lib/dsh-client.js';
+import type { RuntimeText } from '../contract/capabilities.js';
+
+/**
+ * 把适配器给的 zh / en 两份文案落到当前语言。
+ * @param text 适配器档案里的那段话。
+ * @param resolve dsh 的语言解析器；没有就取中文那份。
+ * @returns 当前语言的那一段。
+ */
+export function resolveRuntimeText(text: RuntimeText, resolve?: (text: RuntimeText) => string): string {
+  return resolve === undefined ? text.zh : resolve(text);
+}
+
+/**
+ * 取当前语言的运行时术语（没给档案时的兜底）。
+ * @param t 文案函数。
+ * @returns `plugin` / `pluginOf` / `pluginThing` / `pluginArea` 四个名词短语。
+ */
+export function runtimeTermsOf(t: Translate): Readonly<Record<string, string>> {
+  return {
+    plugin: t('runtime.plugin'),
+    pluginOf: t('runtime.pluginOf'),
+    pluginThing: t('runtime.pluginThing'),
+    pluginArea: t('runtime.pluginArea'),
+  };
+}