@dsh-workbench/shared 0.1.3 → 0.1.4

package/dist/api/host-write.d.ts

@@ -8,5 +8,6 @@ export type WriteOutcome<T> = {
     readonly ok: false;
     readonly message: string;
     readonly detail?: string;
+    readonly helpUrl?: string;
 };
 export declare function writeOutcomeOf<T>(response: ApiResponse<T> | null, networkText: string): WriteOutcome<T>;

package/dist/api/host-write.js

@@ -11,7 +11,13 @@ export function writeOutcomeOf(response, networkText) {
         const own = typeof box.error?.message === 'string' && box.error.message !== '' ? box.error.message : undefined;
         const fallback = typeof box.text === 'string' && box.text !== '' ? box.text : networkText;
         const detail = typeof box.error?.detail === 'string' ? box.error.detail : undefined;
-        return { ok: false, message: own ?? fallback, ...(detail === undefined ? {} : { detail }) };
+        const helpUrl = typeof box.error?.helpUrl === 'string' && box.error.helpUrl !== '' ? box.error.helpUrl : undefined;
+        return {
+            ok: false,
+            message: own ?? fallback,
+            ...(detail === undefined ? {} : { detail }),
+            ...(helpUrl === undefined ? {} : { helpUrl }),
+        };
     }
     return { ok: true, value: response };
 }

package/dist/host.d.ts

@@ -4,6 +4,8 @@ export * from './api/unit.js';
 export * from './api/facts.js';
 export * from './api/long-task.js';
 export * from './lib/text.js';
+export * from './lib/ui.js';
+export * from './api/blocker-table.js';
 export * from './host/cli-error.js';
 export * from './host/data-root.js';
 export * from './host/facts.js';

package/dist/host.js

@@ -4,6 +4,8 @@ export * from './api/unit.js';
 export * from './api/facts.js';
 export * from './api/long-task.js';
 export * from './lib/text.js';
+export * from './lib/ui.js';
+export * from './api/blocker-table.js';
 export * from './host/cli-error.js';
 export * from './host/data-root.js';
 export * from './host/facts.js';

package/dist/i18n/en.js

@@ -78,7 +78,8 @@ export const en = {
     'panels.market.badSource': 'The install method is incomplete — install it yourself',
     'panels.market.empty': 'No modules available',
     'panels.market.installedSection': 'Installed',
-    'panels.market.moduleUpdate': 'Version {version} is out: it may need a restart after installing.',
+    'panels.market.moduleOutdated': 'update available',
+    'panels.market.moduleRestartHint': 'it may need a restart after installing',
     'panels.market.restartNeeded': 'The new version is installed — restart once to pick it up.',
     'panels.market.foot': 'After installing, enable it in the panel page of that project.',
     'panels.market.recheck': 'Check for updates',
@@ -175,11 +176,10 @@ export const en = {
     'panels.market.add.doneRestart': 'Installed — restart once to pick it up.',
     'panels.market.add.cancelled': 'Cancelled.',
     'panels.market.add.failed': "Didn't work: {reason}",
-    'panels.market.add.supplyInstalled': 'The plugins it needs are installed too.',
+    'panels.market.add.removed': 'It has been removed.',
     'panels.market.add.supplyPending': 'Its plugins install after you restart.',
     'panels.market.add.supplyFailed': "Its plugins didn't install: {reason}",
     'panels.market.add.notModule': "This is not a workbench module (no dsh.workbench declaration), so it will not show up on the board.",
-    'panels.market.add.removed': 'Removed.',
     'panels.market.add.removedRestart': 'Removed — restart once to finish.',
     'panels.market.add.remove': 'Remove it',
     'panels.market.add.problem.invalidSpec': "That is not a spec we accept: it cannot be empty or start with a dash.",

package/dist/i18n/index.d.ts

@@ -80,7 +80,8 @@ export declare const dictionaries: {
         readonly 'panels.market.badSource': "安装方式没写全，只能自己动手";
         readonly 'panels.market.empty': "暂无可用模块";
         readonly 'panels.market.installedSection': "已装";
-        readonly 'panels.market.moduleUpdate': "有新版 {version}：安装完成后可能需要重启才生效。";
+        readonly 'panels.market.moduleOutdated': "有新版";
+        readonly 'panels.market.moduleRestartHint': "安装完成后可能需要重启才生效";
         readonly 'panels.market.restartNeeded': "新版装好了，重启一次才生效。";
         readonly 'panels.market.foot': "装好后到那个项目的面板页勾选它，模块才会出现。";
         readonly 'panels.market.recheck': "重新检查更新";
@@ -177,11 +178,10 @@ export declare const dictionaries: {
         readonly 'panels.market.add.doneRestart': "装好了，重启一次才生效。";
         readonly 'panels.market.add.cancelled': "已取消。";
         readonly 'panels.market.add.failed': "没成功：{reason}";
-        readonly 'panels.market.add.supplyInstalled': "它要的插件也装上了。";
+        readonly 'panels.market.add.removed': "已经移除了。";
         readonly 'panels.market.add.supplyPending': "它要的插件重启后再装。";
         readonly 'panels.market.add.supplyFailed': "它要的插件没装上：{reason}";
         readonly 'panels.market.add.notModule': "这不是工作台模块（没有 dsh.workbench 声明），不会出现在面板上。";
-        readonly 'panels.market.add.removed': "已经移除了。";
         readonly 'panels.market.add.removedRestart': "卸掉了，重启一次才彻底生效。";
         readonly 'panels.market.add.remove': "移除它";
         readonly 'panels.market.add.problem.invalidSpec': "这个写法不认：不能是空的，也不能以横杠开头。";
@@ -287,7 +287,7 @@ export declare const dictionaries: {
         readonly 'panel.conversation': "对话";
         readonly 'panels.label': "全局面板";
     };
-    en: Record<"time.now" | "time.minutes" | "time.hours" | "time.days" | "blocker.retry" | "blocker.copy" | "blocker.unknown.title" | "blocker.login.go" | "blocker.login.titleGeneric" | "blocker.login.title" | "blocker.login.manual" | "blocker.login.hint" | "blocker.forbidden.open" | "blocker.forbidden.titleGeneric" | "blocker.forbidden.title" | "blocker.forbidden.hint" | "blocker.timeout.hint" | "blocker.exec.hint" | "blocker.fix.install" | "blocker.fix.update" | "blocker.market.open" | "env.unit.missingPlugin" | "env.unit.hint" | "env.unit.missingCommands" | "env.unit.missingCommandsHint" | "env.unit.unchecked" | "env.unit.uncheckedHint" | "brand.name" | "toggle.open" | "toggle.collapse" | "project.label" | "workspace.section" | "project.none" | "project.empty" | "project.add" | "session.new" | "session.new.label" | "session.empty" | "session.noProject" | "session.pinned" | "session.actions" | "status.idle" | "status.running" | "status.waitingApproval" | "status.planReview" | "status.waitingAnswer" | "status.completed" | "status.subagentsRunning.one" | "status.subagentsRunning.other" | "panels.title" | "panels.reset" | "panels.enabled" | "panels.disabled" | "panels.choose" | "panels.failed" | "panels.hintEffect" | "panels.dragHint" | "panels.unknownStep" | "panels.labelWithHint" | "panels.dep.missingPlugin" | "panels.dep.missingCommands" | "panels.dep.unchecked" | "panels.tab.modules" | "panels.tab.market" | "panels.browseMarket" | "panels.noneInstalled" | "panels.noneInstalledHint" | "panels.market.installed" | "panels.market.outdated" | "panels.market.hasNew" | "panels.market.missing" | "panels.market.unchecked" | "panels.market.checking" | "panels.market.sectionInstalled" | "panels.market.sectionPending" | "panels.market.sectionShared" | "panels.market.sharedUsedBy" | "panels.market.listSeparator" | "panels.market.sharedMissing" | "panels.market.sharedOutdated" | "panels.market.sharedUnsatisfied" | "panels.market.sharedOk" | "panels.market.versionArrow" | "panels.market.lead" | "panels.market.install" | "panels.market.update" | "panels.market.uninstall" | "panels.market.uninstallLabel" | "panels.market.installing" | "panels.market.updating" | "panels.market.uninstalling" | "panels.market.confirmUninstallTitle" | "panels.market.confirmUninstallDetail" | "panels.market.confirmUninstallAck" | "panels.market.confirmYes" | "panels.market.confirmNo" | "panels.market.failed" | "panels.market.needEnv" | "panels.market.noSource" | "panels.market.badSource" | "panels.market.empty" | "panels.market.installedSection" | "panels.market.moduleUpdate" | "panels.market.restartNeeded" | "panels.market.foot" | "panels.market.recheck" | "panels.market.checkUpdates" | "panels.market.checkedAt" | "panels.market.justNow" | "panels.market.minutesAgo" | "panels.market.hoursAgo" | "panels.market.add.description" | "panels.market.add.specPlaceholder" | "panels.market.add.guideToggle" | "panels.market.add.guideHide" | "panels.market.add.guideIdTitle" | "panels.market.add.guideIdExample" | "panels.market.add.guideIdHint" | "panels.market.add.guideGitTitle" | "panels.market.add.guideGitExample" | "panels.market.add.guideGitHint" | "panels.market.add.guidePathTitle" | "panels.market.add.guidePathExample" | "panels.market.add.guidePathHint" | "panels.market.add.guideExampleLabel" | "panels.market.add.guideFill" | "panels.market.add.guideSafety" | "panels.market.add.registryLegend" | "panels.market.add.registryOfficial" | "panels.market.add.registryMirror" | "panels.market.add.registryWithHost" | "panels.market.add.registryToggle" | "panels.market.add.installVersion" | "panels.market.add.registryDefault" | "panels.market.add.registryCustom" | "panels.market.add.registryCustomPlaceholder" | "panels.market.add.registryCustomHint" | "panels.market.add.registryCustomInvalid" | "panels.market.add.run" | "panels.market.add.edit" | "panels.market.add.changeRegistry" | "panels.market.add.installingTitle" | "panels.market.add.installedTitle" | "panels.market.add.failedTitle" | "panels.market.add.cancelledTitle" | "panels.market.add.failureNetworkHost" | "panels.market.add.problemInvalid" | "panels.market.add.problemInstalled" | "panels.market.add.problemNotFound" | "panels.market.add.problemNotPackage" | "panels.market.add.problemNotBundle" | "panels.market.add.problemNetwork" | "panels.market.add.problemUnknown" | "panels.market.add.failureNetwork" | "panels.market.add.failureNotFound" | "panels.market.add.failureNoMatchingVersion" | "panels.market.add.failureDiskFull" | "panels.market.add.failurePermission" | "panels.market.add.failureBuildBlocked" | "panels.market.add.failureIntegrity" | "panels.market.add.failureTimeout" | "panels.market.add.failurePnpmMissing" | "panels.market.add.failureGeneric" | "panels.market.add.approveTitle" | "panels.market.add.approveCaution" | "panels.market.add.approveRun" | "panels.market.add.restart" | "panels.market.add.tookEffect" | "panels.market.add.details" | "panels.market.add.open" | "panels.market.add.title" | "panels.market.add.intro" | "panels.market.add.specLabel" | "panels.market.add.specHint" | "panels.market.add.exampleTitle" | "panels.market.add.exampleFill" | "panels.market.add.registryLabel" | "panels.market.add.registryProfile" | "panels.market.add.registryPnpm" | "panels.market.add.check" | "panels.market.add.checking" | "panels.market.add.change" | "panels.market.add.previewTitle" | "panels.market.add.fieldName" | "panels.market.add.fieldVersion" | "panels.market.add.fieldDescription" | "panels.market.add.fieldSource" | "panels.market.add.install" | "panels.market.add.installing" | "panels.market.add.cancel" | "panels.market.add.close" | "panels.market.add.retry" | "panels.market.add.changeSource" | "panels.market.add.approveBuilds" | "panels.market.add.approveHint" | "panels.market.add.doneApplied" | "panels.market.add.doneRestart" | "panels.market.add.cancelled" | "panels.market.add.failed" | "panels.market.add.supplyInstalled" | "panels.market.add.supplyPending" | "panels.market.add.supplyFailed" | "panels.market.add.notModule" | "panels.market.add.removed" | "panels.market.add.removedRestart" | "panels.market.add.remove" | "panels.market.add.problem.invalidSpec" | "panels.market.add.problem.alreadyInstalled" | "panels.market.add.problem.notFound" | "panels.market.add.problem.notAPackage" | "panels.market.add.problem.notABundle" | "panels.market.add.problem.network" | "panels.market.add.problem.unknown" | "panels.market.add.reason.invalidSpec" | "panels.market.add.reason.incompatible" | "panels.market.add.reason.notBundle" | "panels.market.add.reason.notRemovable" | "panels.market.add.reason.bundleInUse" | "panels.market.add.reason.stopProfile" | "panels.market.add.reason.staleApproval" | "panels.market.add.reason.operationError" | "panels.market.add.reason.buildBlocked" | "panels.market.add.reason.pnpmMissing" | "panels.market.add.reason.noMatchingVersion" | "panels.market.add.reason.diskFull" | "panels.market.add.reason.permission" | "panels.market.add.reason.integrity" | "panels.market.add.reason.timeout" | "panels.market.add.reason.network" | "panels.market.add.reason.notFound" | "panels.market.add.reason.unknown" | "blocker.fix.running" | "blocker.fix.failed" | "blocker.retry.running" | "panels.reading" | "panels.empty" | "panels.emptyHint" | "env.title" | "env.checking" | "env.installing" | "env.failed" | "env.elapsed" | "env.stepFailed.install" | "env.stepFailed.path" | "env.stepFailed.shell" | "env.bridge.ok" | "env.bridge.short" | "env.bridge.why" | "env.bridge.daemon" | "env.bridge.extension" | "env.bridge.extensionLink" | "env.bridge.profile" | "env.bridge.stale" | "env.bridge.unknown" | "env.fix.title" | "env.fix.why" | "env.fix.whyPath" | "env.fix.whyShell" | "env.fix.step" | "env.fix.stepPath" | "env.fix.stepShell" | "env.fix.permission" | "env.fix.network" | "env.fix.details" | "env.retry" | "env.copyCommand" | "env.copied" | "env.step.opencli" | "env.step.codingPlugin" | "env.step.bridge" | "env.step.warm" | "env.warm.done" | "env.warm.short" | "rightbar.label" | "rightbar.expand" | "rightbar.collapse" | "rightbar.refresh" | "rightbar.refreshing" | "rightbar.updatedAt" | "rightbar.noProject" | "coding.notARepo.title" | "error.unknown" | "board.title" | "panel.conversation" | "panels.label", string>;
+    en: Record<"time.now" | "time.minutes" | "time.hours" | "time.days" | "blocker.retry" | "blocker.copy" | "blocker.unknown.title" | "blocker.login.go" | "blocker.login.titleGeneric" | "blocker.login.title" | "blocker.login.manual" | "blocker.login.hint" | "blocker.forbidden.open" | "blocker.forbidden.titleGeneric" | "blocker.forbidden.title" | "blocker.forbidden.hint" | "blocker.timeout.hint" | "blocker.exec.hint" | "blocker.fix.install" | "blocker.fix.update" | "blocker.market.open" | "env.unit.missingPlugin" | "env.unit.hint" | "env.unit.missingCommands" | "env.unit.missingCommandsHint" | "env.unit.unchecked" | "env.unit.uncheckedHint" | "brand.name" | "toggle.open" | "toggle.collapse" | "project.label" | "workspace.section" | "project.none" | "project.empty" | "project.add" | "session.new" | "session.new.label" | "session.empty" | "session.noProject" | "session.pinned" | "session.actions" | "status.idle" | "status.running" | "status.waitingApproval" | "status.planReview" | "status.waitingAnswer" | "status.completed" | "status.subagentsRunning.one" | "status.subagentsRunning.other" | "panels.title" | "panels.reset" | "panels.enabled" | "panels.disabled" | "panels.choose" | "panels.failed" | "panels.hintEffect" | "panels.dragHint" | "panels.unknownStep" | "panels.labelWithHint" | "panels.dep.missingPlugin" | "panels.dep.missingCommands" | "panels.dep.unchecked" | "panels.tab.modules" | "panels.tab.market" | "panels.browseMarket" | "panels.noneInstalled" | "panels.noneInstalledHint" | "panels.market.installed" | "panels.market.outdated" | "panels.market.hasNew" | "panels.market.missing" | "panels.market.unchecked" | "panels.market.checking" | "panels.market.sectionInstalled" | "panels.market.sectionPending" | "panels.market.sectionShared" | "panels.market.sharedUsedBy" | "panels.market.listSeparator" | "panels.market.sharedMissing" | "panels.market.sharedOutdated" | "panels.market.sharedUnsatisfied" | "panels.market.sharedOk" | "panels.market.versionArrow" | "panels.market.lead" | "panels.market.install" | "panels.market.update" | "panels.market.uninstall" | "panels.market.uninstallLabel" | "panels.market.installing" | "panels.market.updating" | "panels.market.uninstalling" | "panels.market.confirmUninstallTitle" | "panels.market.confirmUninstallDetail" | "panels.market.confirmUninstallAck" | "panels.market.confirmYes" | "panels.market.confirmNo" | "panels.market.failed" | "panels.market.needEnv" | "panels.market.noSource" | "panels.market.badSource" | "panels.market.empty" | "panels.market.installedSection" | "panels.market.moduleOutdated" | "panels.market.moduleRestartHint" | "panels.market.restartNeeded" | "panels.market.foot" | "panels.market.recheck" | "panels.market.checkUpdates" | "panels.market.checkedAt" | "panels.market.justNow" | "panels.market.minutesAgo" | "panels.market.hoursAgo" | "panels.market.add.description" | "panels.market.add.specPlaceholder" | "panels.market.add.guideToggle" | "panels.market.add.guideHide" | "panels.market.add.guideIdTitle" | "panels.market.add.guideIdExample" | "panels.market.add.guideIdHint" | "panels.market.add.guideGitTitle" | "panels.market.add.guideGitExample" | "panels.market.add.guideGitHint" | "panels.market.add.guidePathTitle" | "panels.market.add.guidePathExample" | "panels.market.add.guidePathHint" | "panels.market.add.guideExampleLabel" | "panels.market.add.guideFill" | "panels.market.add.guideSafety" | "panels.market.add.registryLegend" | "panels.market.add.registryOfficial" | "panels.market.add.registryMirror" | "panels.market.add.registryWithHost" | "panels.market.add.registryToggle" | "panels.market.add.installVersion" | "panels.market.add.registryDefault" | "panels.market.add.registryCustom" | "panels.market.add.registryCustomPlaceholder" | "panels.market.add.registryCustomHint" | "panels.market.add.registryCustomInvalid" | "panels.market.add.run" | "panels.market.add.edit" | "panels.market.add.changeRegistry" | "panels.market.add.installingTitle" | "panels.market.add.installedTitle" | "panels.market.add.failedTitle" | "panels.market.add.cancelledTitle" | "panels.market.add.failureNetworkHost" | "panels.market.add.problemInvalid" | "panels.market.add.problemInstalled" | "panels.market.add.problemNotFound" | "panels.market.add.problemNotPackage" | "panels.market.add.problemNotBundle" | "panels.market.add.problemNetwork" | "panels.market.add.problemUnknown" | "panels.market.add.failureNetwork" | "panels.market.add.failureNotFound" | "panels.market.add.failureNoMatchingVersion" | "panels.market.add.failureDiskFull" | "panels.market.add.failurePermission" | "panels.market.add.failureBuildBlocked" | "panels.market.add.failureIntegrity" | "panels.market.add.failureTimeout" | "panels.market.add.failurePnpmMissing" | "panels.market.add.failureGeneric" | "panels.market.add.approveTitle" | "panels.market.add.approveCaution" | "panels.market.add.approveRun" | "panels.market.add.restart" | "panels.market.add.tookEffect" | "panels.market.add.details" | "panels.market.add.open" | "panels.market.add.title" | "panels.market.add.intro" | "panels.market.add.specLabel" | "panels.market.add.specHint" | "panels.market.add.exampleTitle" | "panels.market.add.exampleFill" | "panels.market.add.registryLabel" | "panels.market.add.registryProfile" | "panels.market.add.registryPnpm" | "panels.market.add.check" | "panels.market.add.checking" | "panels.market.add.change" | "panels.market.add.previewTitle" | "panels.market.add.fieldName" | "panels.market.add.fieldVersion" | "panels.market.add.fieldDescription" | "panels.market.add.fieldSource" | "panels.market.add.install" | "panels.market.add.installing" | "panels.market.add.cancel" | "panels.market.add.close" | "panels.market.add.retry" | "panels.market.add.changeSource" | "panels.market.add.approveBuilds" | "panels.market.add.approveHint" | "panels.market.add.doneApplied" | "panels.market.add.doneRestart" | "panels.market.add.cancelled" | "panels.market.add.failed" | "panels.market.add.removed" | "panels.market.add.supplyPending" | "panels.market.add.supplyFailed" | "panels.market.add.notModule" | "panels.market.add.removedRestart" | "panels.market.add.remove" | "panels.market.add.problem.invalidSpec" | "panels.market.add.problem.alreadyInstalled" | "panels.market.add.problem.notFound" | "panels.market.add.problem.notAPackage" | "panels.market.add.problem.notABundle" | "panels.market.add.problem.network" | "panels.market.add.problem.unknown" | "panels.market.add.reason.invalidSpec" | "panels.market.add.reason.incompatible" | "panels.market.add.reason.notBundle" | "panels.market.add.reason.notRemovable" | "panels.market.add.reason.bundleInUse" | "panels.market.add.reason.stopProfile" | "panels.market.add.reason.staleApproval" | "panels.market.add.reason.operationError" | "panels.market.add.reason.buildBlocked" | "panels.market.add.reason.pnpmMissing" | "panels.market.add.reason.noMatchingVersion" | "panels.market.add.reason.diskFull" | "panels.market.add.reason.permission" | "panels.market.add.reason.integrity" | "panels.market.add.reason.timeout" | "panels.market.add.reason.network" | "panels.market.add.reason.notFound" | "panels.market.add.reason.unknown" | "blocker.fix.running" | "blocker.fix.failed" | "blocker.retry.running" | "panels.reading" | "panels.empty" | "panels.emptyHint" | "env.title" | "env.checking" | "env.installing" | "env.failed" | "env.elapsed" | "env.stepFailed.install" | "env.stepFailed.path" | "env.stepFailed.shell" | "env.bridge.ok" | "env.bridge.short" | "env.bridge.why" | "env.bridge.daemon" | "env.bridge.extension" | "env.bridge.extensionLink" | "env.bridge.profile" | "env.bridge.stale" | "env.bridge.unknown" | "env.fix.title" | "env.fix.why" | "env.fix.whyPath" | "env.fix.whyShell" | "env.fix.step" | "env.fix.stepPath" | "env.fix.stepShell" | "env.fix.permission" | "env.fix.network" | "env.fix.details" | "env.retry" | "env.copyCommand" | "env.copied" | "env.step.opencli" | "env.step.codingPlugin" | "env.step.bridge" | "env.step.warm" | "env.warm.done" | "env.warm.short" | "rightbar.label" | "rightbar.expand" | "rightbar.collapse" | "rightbar.refresh" | "rightbar.refreshing" | "rightbar.updatedAt" | "rightbar.noProject" | "coding.notARepo.title" | "error.unknown" | "board.title" | "panel.conversation" | "panels.label", string>;
 };
 export type { WorkbenchMessages };
 export interface Dictionaries {

package/dist/i18n/zh.d.ts

@@ -78,7 +78,8 @@ export declare const zh: {
     readonly 'panels.market.badSource': "安装方式没写全，只能自己动手";
     readonly 'panels.market.empty': "暂无可用模块";
     readonly 'panels.market.installedSection': "已装";
-    readonly 'panels.market.moduleUpdate': "有新版 {version}：安装完成后可能需要重启才生效。";
+    readonly 'panels.market.moduleOutdated': "有新版";
+    readonly 'panels.market.moduleRestartHint': "安装完成后可能需要重启才生效";
     readonly 'panels.market.restartNeeded': "新版装好了，重启一次才生效。";
     readonly 'panels.market.foot': "装好后到那个项目的面板页勾选它，模块才会出现。";
     readonly 'panels.market.recheck': "重新检查更新";
@@ -175,11 +176,10 @@ export declare const zh: {
     readonly 'panels.market.add.doneRestart': "装好了，重启一次才生效。";
     readonly 'panels.market.add.cancelled': "已取消。";
     readonly 'panels.market.add.failed': "没成功：{reason}";
-    readonly 'panels.market.add.supplyInstalled': "它要的插件也装上了。";
+    readonly 'panels.market.add.removed': "已经移除了。";
     readonly 'panels.market.add.supplyPending': "它要的插件重启后再装。";
     readonly 'panels.market.add.supplyFailed': "它要的插件没装上：{reason}";
     readonly 'panels.market.add.notModule': "这不是工作台模块（没有 dsh.workbench 声明），不会出现在面板上。";
-    readonly 'panels.market.add.removed': "已经移除了。";
     readonly 'panels.market.add.removedRestart': "卸掉了，重启一次才彻底生效。";
     readonly 'panels.market.add.remove': "移除它";
     readonly 'panels.market.add.problem.invalidSpec': "这个写法不认：不能是空的，也不能以横杠开头。";

package/dist/i18n/zh.js

@@ -78,7 +78,8 @@ export const zh = {
     'panels.market.badSource': '安装方式没写全，只能自己动手',
     'panels.market.empty': '暂无可用模块',
     'panels.market.installedSection': '已装',
-    'panels.market.moduleUpdate': '有新版 {version}：安装完成后可能需要重启才生效。',
+    'panels.market.moduleOutdated': '有新版',
+    'panels.market.moduleRestartHint': '安装完成后可能需要重启才生效',
     'panels.market.restartNeeded': '新版装好了，重启一次才生效。',
     'panels.market.foot': '装好后到那个项目的面板页勾选它，模块才会出现。',
     'panels.market.recheck': '重新检查更新',
@@ -175,11 +176,10 @@ export const zh = {
     'panels.market.add.doneRestart': '装好了，重启一次才生效。',
     'panels.market.add.cancelled': '已取消。',
     'panels.market.add.failed': '没成功：{reason}',
-    'panels.market.add.supplyInstalled': '它要的插件也装上了。',
+    'panels.market.add.removed': '已经移除了。',
     'panels.market.add.supplyPending': '它要的插件重启后再装。',
     'panels.market.add.supplyFailed': '它要的插件没装上：{reason}',
     'panels.market.add.notModule': '这不是工作台模块（没有 dsh.workbench 声明），不会出现在面板上。',
-    'panels.market.add.removed': '已经移除了。',
     'panels.market.add.removedRestart': '卸掉了，重启一次才彻底生效。',
     'panels.market.add.remove': '移除它',
     'panels.market.add.problem.invalidSpec': '这个写法不认：不能是空的，也不能以横杠开头。',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/shared",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "工作台与模块共享的纯代码与契约类型：类型、纯逻辑、哑组件、平台解析。宿主侧的东西从 /host 进（不影响浏览器产物）。",
   "license": "MIT",
   "type": "module",

package/src/api/__tests__/host-write.test.ts

@@ -33,6 +33,26 @@ describe('writeOutcomeOf', () => {
     expect(outcome).toEqual({ ok: false, message: '生产环境要先审批', detail: 'job 1234' });
   });
 
+  it('★ 登录态失效那条错误带着 helpUrl → 一路带出去（卡片才能给「去登录 ↗」而不是"还没绑定"）', () => {
+    const outcome = writeOutcomeOf(
+      {
+        ok: false,
+        error: {
+          code: 'cmdb/login-required',
+          message: 'CMDB 登录态失效了',
+          helpUrl: 'https://cmdb.example.test/login',
+        },
+      },
+      '网络不通',
+    );
+
+    expect(outcome).toEqual({
+      ok: false,
+      message: 'CMDB 登录态失效了',
+      helpUrl: 'https://cmdb.example.test/login',
+    });
+  });
+
   it('没有 detail 就不给那个字段（别塞一个 undefined 进类型里）', () => {
     const outcome = writeOutcomeOf({ ok: false, error: { code: 'x', message: '不行' } }, '网络不通');
 

package/src/api/host-write.ts

@@ -9,19 +9,33 @@ export function writeRoute(channel: WriteChannel, resource: string): string {
 
 export type WriteOutcome<T> =
   | { readonly ok: true; readonly value: T }
-  | { readonly ok: false; readonly message: string; readonly detail?: string };
+  | {
+      readonly ok: false;
+      readonly message: string;
+      readonly detail?: string;
+      readonly helpUrl?: string;
+    };
 
 export function writeOutcomeOf<T>(response: ApiResponse<T> | null, networkText: string): WriteOutcome<T> {
   if (response === null) return { ok: false, message: networkText };
   if (!response.ok) {
     const box = response as {
-      readonly error?: { readonly message?: unknown; readonly detail?: unknown } | undefined;
+      readonly error?:
+        | { readonly message?: unknown; readonly detail?: unknown; readonly helpUrl?: unknown }
+        | undefined;
       readonly text?: unknown;
     };
     const own = typeof box.error?.message === 'string' && box.error.message !== '' ? box.error.message : undefined;
     const fallback = typeof box.text === 'string' && box.text !== '' ? box.text : networkText;
     const detail = typeof box.error?.detail === 'string' ? box.error.detail : undefined;
-    return { ok: false, message: own ?? fallback, ...(detail === undefined ? {} : { detail }) };
+    const helpUrl =
+      typeof box.error?.helpUrl === 'string' && box.error.helpUrl !== '' ? box.error.helpUrl : undefined;
+    return {
+      ok: false,
+      message: own ?? fallback,
+      ...(detail === undefined ? {} : { detail }),
+      ...(helpUrl === undefined ? {} : { helpUrl }),
+    };
   }
   return { ok: true, value: response };
 }

package/src/host.ts

@@ -4,6 +4,8 @@ export * from './api/unit.js';
 export * from './api/facts.js';
 export * from './api/long-task.js';
 export * from './lib/text.js';
+export * from './lib/ui.js';
+export * from './api/blocker-table.js';
 export * from './host/cli-error.js';
 export * from './host/data-root.js';
 export * from './host/facts.js';

package/src/i18n/en.ts

@@ -85,7 +85,8 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.market.badSource': 'The install method is incomplete — install it yourself',
   'panels.market.empty': 'No modules available',
   'panels.market.installedSection': 'Installed',
-  'panels.market.moduleUpdate': 'Version {version} is out: it may need a restart after installing.',
+  'panels.market.moduleOutdated': 'update available',
+  'panels.market.moduleRestartHint': 'it may need a restart after installing',
   'panels.market.restartNeeded': 'The new version is installed — restart once to pick it up.',
   'panels.market.foot': 'After installing, enable it in the panel page of that project.',
   'panels.market.recheck': 'Check for updates',
@@ -182,11 +183,10 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.market.add.doneRestart': 'Installed — restart once to pick it up.',
   'panels.market.add.cancelled': 'Cancelled.',
   'panels.market.add.failed': "Didn't work: {reason}",
-  'panels.market.add.supplyInstalled': 'The plugins it needs are installed too.',
+  'panels.market.add.removed': 'It has been removed.',
   'panels.market.add.supplyPending': 'Its plugins install after you restart.',
   'panels.market.add.supplyFailed': "Its plugins didn't install: {reason}",
   'panels.market.add.notModule': "This is not a workbench module (no dsh.workbench declaration), so it will not show up on the board.",
-  'panels.market.add.removed': 'Removed.',
   'panels.market.add.removedRestart': 'Removed — restart once to finish.',
   'panels.market.add.remove': 'Remove it',
   'panels.market.add.problem.invalidSpec': "That is not a spec we accept: it cannot be empty or start with a dash.",

package/src/i18n/zh.ts

@@ -81,7 +81,8 @@ export const zh = {
   'panels.market.badSource': '安装方式没写全，只能自己动手',
   'panels.market.empty': '暂无可用模块',
   'panels.market.installedSection': '已装',
-  'panels.market.moduleUpdate': '有新版 {version}：安装完成后可能需要重启才生效。',
+  'panels.market.moduleOutdated': '有新版',
+  'panels.market.moduleRestartHint': '安装完成后可能需要重启才生效',
   'panels.market.restartNeeded': '新版装好了，重启一次才生效。',
   'panels.market.foot': '装好后到那个项目的面板页勾选它，模块才会出现。',
   'panels.market.recheck': '重新检查更新',
@@ -178,11 +179,10 @@ export const zh = {
   'panels.market.add.doneRestart': '装好了，重启一次才生效。',
   'panels.market.add.cancelled': '已取消。',
   'panels.market.add.failed': '没成功：{reason}',
-  'panels.market.add.supplyInstalled': '它要的插件也装上了。',
+  'panels.market.add.removed': '已经移除了。',
   'panels.market.add.supplyPending': '它要的插件重启后再装。',
   'panels.market.add.supplyFailed': '它要的插件没装上：{reason}',
   'panels.market.add.notModule': '这不是工作台模块（没有 dsh.workbench 声明），不会出现在面板上。',
-  'panels.market.add.removed': '已经移除了。',
   'panels.market.add.removedRestart': '卸掉了，重启一次才彻底生效。',
   'panels.market.add.remove': '移除它',
   'panels.market.add.problem.invalidSpec': '这个写法不认：不能是空的，也不能以横杠开头。',