@dsh-workbench/shared 0.3.10 → 0.3.11

package/dist/api/dsh-client.d.ts

@@ -245,6 +245,7 @@ export interface DshConversationService {
 export interface DshSessionsService {
     readonly list: {
         getSnapshot(): SessionsSnapshot;
+        subscribe?(listener: () => void): () => void;
     };
     scope(sessionId: string): unknown | undefined;
     create?(request: {

package/dist/api/dsh.d.ts

@@ -222,6 +222,24 @@ export interface DshToolRunContext {
         } | undefined;
     } | undefined;
 }
+/**
+ * dsh 的审批服务（服务名 `approval`）：读一个会话此刻生效的审批策略。
+ * 方法可选：服务缺席或老版本没有它时，调用方必须当成「不知道」而不是「已关闭」。
+ */
+export interface DshApprovalService {
+    effectivePolicy?(session: unknown): 'ask' | 'never' | undefined;
+}
+/**
+ * dsh 的沙箱策略服务（服务名 `sandboxPolicy`）：按会话解析这次调用生效的文件边界。
+ * 方法可选：服务缺席或老版本没有它时，调用方必须当成「不知道」而不是「完全放行」。
+ */
+export interface DshSandboxPolicy {
+    resolve?(request?: {
+        readonly session?: unknown;
+    }): {
+        readonly mode?: string;
+    } | undefined;
+}
 /**
  * dsh 的工具表；register 回的清理函数负责在插件卸载时摘掉这条工具。
  */

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

@@ -1,15 +1,7 @@
-import type { ApiResponse } from './workbench-client.js';
 /**
  * 宿主写口的五条通道（偏好、动作、供给、工坊调试、工坊录制），是写路由的第一段。
  */
 export type WriteChannel = 'prefs' | 'actions' | 'provision' | 'diy-debug' | 'diy-record';
-/**
- * 由通道与资源拼出写路由。
- * @param channel 写通道。
- * @param resource 该通道下的资源名。
- * @returns 路由字符串；provision 只有一段，其余是 channel/resource。
- */
-export declare function writeRoute(channel: WriteChannel, resource: string): string;
 /**
  * 写通道统一的结果：成了带值，没成带一句能给人看的话（可选明细与帮助链接）。
  */
@@ -22,10 +14,3 @@ export type WriteOutcome<T> = {
     readonly detail?: string;
     readonly helpUrl?: string;
 };
-/**
- * 把写通道的响应翻成 WriteOutcome。
- * @param response 写口回的响应；null 表示请求本身没成（网络断了，宿主没答）。
- * @param networkText 拿不到任何服务端文案时兜底的那句。
- * @returns 失败时 message 优先用服务端自己的话，没有才用响应正文或 networkText。
- */
-export declare function writeOutcomeOf<T>(response: ApiResponse<T> | null, networkText: string): WriteOutcome<T>;

package/dist/api/host-write.js

@@ -1,35 +1 @@
-/**
- * 由通道与资源拼出写路由。
- * @param channel 写通道。
- * @param resource 该通道下的资源名。
- * @returns 路由字符串；provision 只有一段，其余是 channel/resource。
- */
-export function writeRoute(channel, resource) {
-    if (channel === 'provision')
-        return 'provision';
-    return `${channel}/${resource}`;
-}
-/**
- * 把写通道的响应翻成 WriteOutcome。
- * @param response 写口回的响应；null 表示请求本身没成（网络断了，宿主没答）。
- * @param networkText 拿不到任何服务端文案时兜底的那句。
- * @returns 失败时 message 优先用服务端自己的话，没有才用响应正文或 networkText。
- */
-export function writeOutcomeOf(response, networkText) {
-    if (response === null)
-        return { ok: false, message: networkText };
-    if (!response.ok) {
-        const box = response;
-        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;
-        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 };
-}
+export {};

package/dist/api/unit-board.d.ts

@@ -1,6 +1,4 @@
 import type { ModuleBlocker } from './blocker.js';
-import type { CapabilityPayload } from './workbench-contract.js';
-import type { ApiError } from './workbench-client.js';
 /**
  * 卡片闸的两种档：capability 按环境读数判，none 无条件放行。
  */
@@ -11,13 +9,6 @@ export type GateMode = 'capability' | 'none';
 export interface UnitGate {
     readonly gated: boolean;
 }
-/**
- * 判这张卡现在能不能画。
- * @param capability 环境读数；还没读到给 null。
- * @param mode 闸档。
- * @returns mode 为 none 或读数还没到都放行（先放行让它读）；读到明确不通过（ok 与 unchecked 之外）才拦。
- */
-export declare function gateOf(capability: CapabilityPayload | null, mode: GateMode): UnitGate;
 /**
  * 一个单元攒下的卡住态：blocker 顶掉卡片，notice 只提示；组装方产出，卡片消费。
  */
@@ -25,15 +16,3 @@ export interface UnitBlockers {
     readonly blocker?: ModuleBlocker;
     readonly notice?: ModuleBlocker;
 }
-/**
- * 把候选卡住态分档，每档只留第一个。
- * @param candidates 候选（可能含 undefined），按优先级从高到低给。
- * @returns 分出的 blocker 与 notice；已经有 blocker 时不带 notice（挡住就不必再提示）。
- */
-export declare function splitBlocker(candidates: readonly (ModuleBlocker | undefined)[]): UnitBlockers;
-/**
- * 由读口错误算出「出错搭车强探」的防抖键：同一个键只自动重探一次。
- * @param error 读口错误；undefined 表示这次没有错误。
- * @returns 键字符串；空 code 归一到 unknown。
- */
-export declare function probeKeyOf(error: ApiError | undefined): string | null;

package/dist/api/unit-board.js

@@ -1,45 +1 @@
-/**
- * 判这张卡现在能不能画。
- * @param capability 环境读数；还没读到给 null。
- * @param mode 闸档。
- * @returns mode 为 none 或读数还没到都放行（先放行让它读）；读到明确不通过（ok 与 unchecked 之外）才拦。
- */
-export function gateOf(capability, mode) {
-    if (mode === 'none')
-        return { gated: true };
-    if (capability === null)
-        return { gated: true };
-    return { gated: capability.status === 'ok' || capability.status === 'unchecked' };
-}
-/**
- * 把候选卡住态分档，每档只留第一个。
- * @param candidates 候选（可能含 undefined），按优先级从高到低给。
- * @returns 分出的 blocker 与 notice；已经有 blocker 时不带 notice（挡住就不必再提示）。
- */
-export function splitBlocker(candidates) {
-    let blocker;
-    let notice;
-    for (const candidate of candidates) {
-        if (candidate === undefined)
-            continue;
-        if (candidate.severity === 'block') {
-            blocker ??= candidate;
-            continue;
-        }
-        notice ??= candidate;
-    }
-    return {
-        ...(blocker === undefined ? {} : { blocker }),
-        ...(blocker !== undefined || notice === undefined ? {} : { notice }),
-    };
-}
-/**
- * 由读口错误算出「出错搭车强探」的防抖键：同一个键只自动重探一次。
- * @param error 读口错误；undefined 表示这次没有错误。
- * @returns 键字符串；空 code 归一到 unknown。
- */
-export function probeKeyOf(error) {
-    if (error === undefined)
-        return null;
-    return error.code === '' ? 'unknown' : error.code;
-}
+export {};

package/dist/components/icons.d.ts

@@ -28,12 +28,6 @@ export declare function IconOpencli({ size }: IconProps): JSX.Element;
  * @returns 一枚 `aria-hidden` 的 svg。
  */
 export declare function IconNpm({ size }: IconProps): JSX.Element;
-/**
- * 四宫格："模块"这个概念的通用单色图标（侧栏、面板那颗钮、市场节的标题）；默认 16px。
- * @param props.size - 边长像素，同时给 `width` 与 `height`。
- * @returns 一枚 `aria-hidden` 的 svg。
- */
-export declare function IconModules({ size }: IconProps): JSX.Element;
 /**
  * 模块类型标：渐变方块 + 白四宫格，用在"这是个模块"的行首；品牌物，颜色不跟主题走。默认 16px。
  * @param props.size - 边长像素，同时给 `width` 与 `height`。

package/dist/components/icons.js

@@ -45,18 +45,6 @@ export function IconNpm({ size = 16 }) {
     return (h(Shell, { size: size, viewBox: "0 0 1024 1024" },
         h("path", { d: "M64 337.76h896v298.72H512v49.792H312.896v-49.824H64z m49.792 248.928h99.552v-149.376h49.76v149.344h49.792v-199.104H113.792z m248.896-199.136v248.928h99.552v-49.792h99.552v-199.136z m99.552 49.792H512v99.584h-49.792z m149.344-49.792v199.136h99.552v-149.376h49.792v149.344h49.792v-149.344h49.792v149.344h49.792v-199.104z", fill: "#CB3837" })));
 }
-/**
- * 四宫格："模块"这个概念的通用单色图标（侧栏、面板那颗钮、市场节的标题）；默认 16px。
- * @param props.size - 边长像素，同时给 `width` 与 `height`。
- * @returns 一枚 `aria-hidden` 的 svg。
- */
-export function IconModules({ size = 16 }) {
-    return (h("svg", { width: size, height: size, viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true" },
-        h("rect", { x: "2.5", y: "2.5", width: "4.6", height: "4.6", rx: "1.2", stroke: "currentColor", strokeWidth: "1.2" }),
-        h("rect", { x: "8.9", y: "2.5", width: "4.6", height: "4.6", rx: "1.2", stroke: "currentColor", strokeWidth: "1.2" }),
-        h("rect", { x: "2.5", y: "8.9", width: "4.6", height: "4.6", rx: "1.2", stroke: "currentColor", strokeWidth: "1.2" }),
-        h("rect", { x: "8.9", y: "8.9", width: "4.6", height: "4.6", rx: "1.2", stroke: "currentColor", strokeWidth: "1.2" })));
-}
 /**
  * 模块类型标：渐变方块 + 白四宫格，用在"这是个模块"的行首；品牌物，颜色不跟主题走。默认 16px。
  * @param props.size - 边长像素，同时给 `width` 与 `height`。

package/dist/config/storage.d.ts

@@ -2,7 +2,3 @@
 export declare function readText(key: string): string | null;
 /** 写一段文本进 localStorage；`value` 为 null 时删掉这个键，写不进去就静默作罢。 */
 export declare function writeText(key: string, value: string | null): void;
-/** 读一个布尔开关：键不存在时返回 `fallback`，只有存进去的 `'true'` 算真。 */
-export declare function readFlag(key: string, fallback: boolean): boolean;
-/** 把一个布尔开关写进 localStorage（存 `'true'` / `'false'`）；失败静默。 */
-export declare function writeFlag(key: string, value: boolean): void;

package/dist/config/storage.js

@@ -18,14 +18,3 @@ export function writeText(key, value) {
     catch {
     }
 }
-/** 读一个布尔开关：键不存在时返回 `fallback`，只有存进去的 `'true'` 算真。 */
-export function readFlag(key, fallback) {
-    const raw = readText(key);
-    if (raw === null)
-        return fallback;
-    return raw === 'true';
-}
-/** 把一个布尔开关写进 localStorage（存 `'true'` / `'false'`）；失败静默。 */
-export function writeFlag(key, value) {
-    writeText(key, value ? 'true' : 'false');
-}

package/dist/host/browser-find.js

@@ -166,7 +166,7 @@ export async function browserFind(options) {
             return {
                 kind: 'failed',
                 detail: error instanceof Error ? error.message : String(error),
-                hint: '确认这台机器上 opencli 能跑（工作台会自己把它挂好）',
+                hint: '确认后台服务能跑起来，再重试',
             };
         }
     };

package/dist/host/browser-read.js

@@ -77,8 +77,8 @@ async function evalOnce(shell, command, session, script, timeoutMs, retryMs) {
                 result: {
                     ok: false,
                     code: 'cli-exec-failed',
-                    message: '读不了：opencli 起不来',
-                    hint: '确认这台机器上 opencli 能跑（工作台会自己把它挂好）',
+                    message: '读不了：后台服务起不来',
+                    hint: '确认后台服务能跑起来，再重试',
                     detail: error instanceof Error ? error.message : String(error),
                 },
             };
@@ -116,8 +116,8 @@ async function evalOnce(shell, command, session, script, timeoutMs, retryMs) {
                 result: {
                     ok: false,
                     code: 'cli-exec-failed',
-                    message: '读到了、但不是 JSON',
-                    hint: '脚本必须回 JSON',
+                    message: '读到的格式不对',
+                    hint: '让 agent 检查一下这条读',
                     detail: tailLines(attempt.stdout, 4),
                 },
             };
@@ -142,7 +142,7 @@ async function openOnce(shell, command, session, url, timeoutMs) {
             ok: false,
             code: 'cli-exec-failed',
             message: '打不开那个页面',
-            hint: '确认 opencli 能跑起来',
+            hint: '确认后台服务能跑起来，再重试',
             detail: error instanceof Error ? error.message : String(error),
             helpUrl: url,
         };

package/dist/host/tool-approval.d.ts

@@ -31,10 +31,17 @@ export interface ApprovalCall {
     readonly workspace?: string | undefined;
     readonly session?: string | undefined;
 }
+/**
+ * 套件对一次写调用给出的判定：`read` 只是看看、`allow` 会写但本套件不问、`deny` 这一次根本跑不成
+ * （连问都不该问，`reason` 原样交给 agent）、`ask` 要用户点头（`question` 接在明细后，`fallback` 是没明细时的整句）。
+ */
 export type ApprovalVerdict = {
     readonly kind: 'read';
 } | {
     readonly kind: 'allow';
+} | {
+    readonly kind: 'deny';
+    readonly reason: string;
 } | {
     readonly kind: 'ask';
     readonly reason: string;
@@ -42,10 +49,15 @@ export type ApprovalVerdict = {
     readonly fallback: ApprovalDetail;
 };
 export type ApprovalPolicy = (call: ApprovalCall) => ApprovalVerdict | undefined;
+/**
+ * 闸门的输入：`skipAsk` 为真表示会话已经不要审批提示（完全权限）—— 认领检查、`{blocked}` 与套件自己的
+ * `deny` 照旧，只是不再返回 `ask`；dsh 在 `approval: never` 下会把 `ask` 直接拒掉。
+ */
 export interface ApprovalContext {
     readonly writes?: boolean | undefined;
     readonly policy?: ApprovalPolicy | undefined;
     readonly declaredNote?: boolean | undefined;
+    readonly skipAsk?: boolean | undefined;
     readonly detailOf?: ((call: ApprovalCall) => ApprovalFacts | undefined | Promise<ApprovalFacts | undefined>) | undefined;
 }
 export declare function approvalFor(call: ApprovalCall, context?: ApprovalContext): Promise<AskDecision | undefined>;

package/dist/host/tool-approval.js

@@ -65,6 +65,8 @@ export async function approvalFor(call, context = {}) {
     }
     if (verdict?.kind === 'read' || verdict?.kind === 'allow')
         return undefined;
+    if (verdict?.kind === 'deny')
+        return { kind: 'deny', reason: verdict.reason };
     if (verdict?.kind !== 'ask') {
         return {
             kind: 'deny',
@@ -81,6 +83,8 @@ export async function approvalFor(call, context = {}) {
     }
     if (facts !== undefined && 'blocked' in facts)
         return { kind: 'deny', reason: facts.blocked };
+    if (context.skipAsk === true)
+        return undefined;
     return {
         kind: 'ask',
         reason: verdict.reason,

package/dist/i18n/en.js

@@ -87,7 +87,7 @@ export const en = {
     'panels.buildModule': 'Build a module',
     'panels.failed': 'Could not save the change. Try again.',
     'panels.dragHint': 'Drag to reorder',
-    'panels.unknownStep': 'No suite provides this view',
+    'panels.unknownStep': 'No panel for this view yet',
     'panels.labelWithHint': '{label} ({hint})',
     'panels.hintJoin': '; ',
     'panels.dep.failed': '⚠ failed to start',
@@ -122,6 +122,14 @@ export const en = {
     'panels.market.install': 'Install',
     'panels.market.update': 'Update',
     'panels.market.swapSlow': 'Not swapped yet — maybe a slow or failed download. Press Update again; if it stays like this, restart dsh.',
+    'panels.market.updateNoChange': 'Not updated: you were on {from}, and after the run the disk still has that version; the newest on the registry is {latest}.',
+    'panels.market.updateUnknownVersion': '(unknown)',
+    'panels.market.updateGone': 'Not updated: after the run the module cannot be read from disk.',
+    'panels.market.updateRestored': 'Not updated: the new version was missing from disk, so {version} was put back.',
+    'panels.market.updateBehind': 'Installed {installed}, but the newest on the registry is {latest} — not the latest; you can update once more.',
+    'panels.market.selfUpdateFailed': 'Self-update failed: {reason}',
+    'panels.market.selfUpdateUnknown': 'the outside process left no reason (see ~/.dsh/workbench/self-update.log)',
+    'panels.market.selfUpdateRolledBack': 'Not swapped; rolled back to {version}.',
     'panels.market.uninstall': 'Uninstall',
     'panels.market.uninstallLabel': 'Uninstall {name}',
     'panels.market.installing': 'Installing…',
@@ -152,7 +160,7 @@ export const en = {
     'panels.market.pluginKeptUnsure': 'Files kept for now: some modules on this machine do not say what they use, so it is unclear who needs it.',
     'panels.market.pluginKeptHeld': 'Files kept: this one is yours, and a module letting go will not remove it.',
     'panels.market.pluginKeptUnnamed': 'Files kept for now: this one cannot be identified as a plugin, so it is unclear who needs it.',
-    'panels.market.pluginBroken': 'This install is broken: it cannot be identified as a plugin. Uninstall it, or tell the agent to reinstall it by package name with workbench_modules_install_bundle.',
+    'panels.market.pluginBroken': 'This plugin install is broken: it cannot be identified. Uninstall it first, then ask the agent to reinstall it by package name.',
     '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',
@@ -197,7 +205,7 @@ export const en = {
     'panels.market.add.cancelledTitle': 'Cancelled',
     'panels.market.add.failureNetworkHost': 'Cannot reach {host}. Git URLs and .tgz links bypass the registry, so this machine needs direct access or a proxy; if the module is also on npm, use its package name instead.',
     'panels.market.add.problemInvalid': 'Cannot read this package name or address: {reason}',
-    'panels.market.add.problemInstalled': 'This module is already installed',
+    'panels.market.add.problemInstalled': 'This module is already installed (add @version to switch versions)',
     '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.',
@@ -218,7 +226,7 @@ export const en = {
     'panels.market.add.failureIntegrity': 'The downloaded package failed its integrity check',
     'panels.market.add.failureTimeout': 'The install timed out',
     'panels.market.add.failurePnpmMissing': 'pnpm was not found, cannot install',
-    'panels.market.add.failureInstalled': 'It is already in this profile: this dsh runs with hot reload, which refuses to install over the same package (remove it first) — and removing it failed too',
+    'panels.market.add.failureInstalled': 'It is already installed in this workbench. The same package cannot be installed over itself: uninstall it first, then install again. The uninstall did not succeed this time.',
     'panels.market.add.failureGeneric': 'Something went wrong during install — see the install details',
     'panels.market.add.approveTitle': 'Your approval is needed for install scripts',
     'panels.market.add.approveCaution': 'Only allow packages you trust: install scripts run on this machine with your permissions.',
@@ -256,7 +264,7 @@ export const en = {
     'panels.market.add.doneApplied': 'Installed and live.',
     'panels.market.add.doneRestart': 'Installed — restart once to pick it up.',
     'panels.market.add.restartWhy': 'Why this needs a restart: {reason}',
-    'panels.market.add.restartWhy.no-hmr': 'this profile only applies changes at startup (no hot reload)',
+    'panels.market.add.restartWhy.no-hmr': 'this configuration only applies changes at startup (hot reload is off)',
     'panels.market.add.restartWhy.package-moved': 'an installed package now resolves to another directory, or the change replaced something dsh itself provides',
     'panels.market.add.restartWhy.host-module': 'the change reaches modules dsh itself loaded',
     'panels.market.add.restartWhy.unmanaged-plugin': 'the change reaches a plugin running outside the plugin list',
@@ -271,17 +279,17 @@ export const en = {
     '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.",
     'panels.market.add.problem.alreadyInstalled': 'That package is already in the profile (add @version to switch versions).',
-    'panels.market.add.problem.notFound': 'No such package on that source.',
-    'panels.market.add.problem.notAPackage': 'There is no package at that location.',
-    'panels.market.add.problem.notABundle': 'It is an npm package, but not a dsh plugin (no bundle patch).',
-    'panels.market.add.problem.network': 'The source is unreachable.',
-    'panels.market.add.problem.unknown': 'The check did not pass (reason unknown).',
+    'panels.market.add.problem.notFound': 'No such package on that source. Try another name or version.',
+    'panels.market.add.problem.notAPackage': 'There is no package at that location. Pick a folder that contains a package.json.',
+    'panels.market.add.problem.notABundle': 'It is an npm package, but not a dsh plugin (it is missing the dsh wiring declaration).',
+    'panels.market.add.problem.network': 'The source is unreachable. Check the network and retry.',
+    'panels.market.add.problem.unknown': 'The check did not pass (reason unknown). Open the install details for the raw output, or retry.',
     'panels.market.add.reason.invalidSpec': 'the spec is not accepted',
     'panels.market.add.reason.incompatible': 'it wants a different dsh version than this machine runs',
     'panels.market.add.reason.notBundle': 'it is not a dsh plugin package',
     'panels.market.add.reason.notRemovable': 'it ships with the installation and cannot be removed',
     'panels.market.add.reason.bundleInUse': 'something is still using it',
-    'panels.market.add.reason.stopProfile': 'this profile has no hot reload, so stop the process first',
+    'panels.market.add.reason.stopProfile': 'this configuration has no hot reload, so stop the process first',
     'panels.market.add.reason.staleApproval': 'the scripts to allow changed — start over',
     'panels.market.add.reason.operationError': 'pnpm failed (see the install output)',
     'panels.market.add.reason.buildBlocked': 'pnpm blocked install scripts',
@@ -336,11 +344,11 @@ export const en = {
     'env.bridge.extensionLink': 'Get the extension in the Chrome Web Store',
     'env.bridge.profile': 'Several browser profiles are connected but none is the default: list them (command below), then pick one.',
     'env.bridge.stale': 'The default browser profile is stale (it names an extension instance that no longer exists): pick one again.',
-    'env.bridge.unknown': 'Could not tell what went wrong: the raw output below has the steps opencli itself suggests.',
+    '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 opencli (installed separately from the one in your terminal), and it is not set up on this machine yet.',
     'env.fix.whyPath': 'opencli is installed, but this environment cannot find it \u2014 usually a PATH or shell-session issue.',
-    'env.fix.whyShell': 'The workbench has no shell channel, so it cannot fetch data \u2014 nothing the user can install.',
+    'env.fix.whyShell': 'The workbench has no shell channel, so it cannot fetch data \u2014 you cannot install this from here; someone needs to fix the background environment.',
     '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 shell channel is not wired up.',
@@ -352,9 +360,9 @@ export const en = {
     'env.diy.ok': 'Available',
     'env.diy.short': 'Cannot load',
     'env.diy.hold': 'DIY mode cannot load \u2014 upgrade dsh, then hit Retry; or enter the workbench first.',
-    'env.diy.why': '\u201cWorkbench DIY\u201d is a dsh agent preset, and it is generated from the dsh generation this shell was verified against. The dsh on this machine is older and does not ship some of those rows, so the whole preset fails to mount. dsh lists only the presets that mount, so the mode will simply not appear \u2014 panels and everything else are unaffected.',
-    'env.diy.rows': 'This dsh is missing these rows: {rows}',
-    'env.diy.noRow': 'The health check did not find \u201cWorkbench DIY\u201d in dsh\u2019s preset roster \u2014 most likely this bundle\u2019s preset patch did not apply.',
+    'env.diy.why': 'The dsh on this machine is older than the one this workbench was verified against, so DIY mode cannot load. Panels and everything else are unaffected. Upgrade dsh and restart.',
+    'env.diy.rows': 'This dsh is missing these items: {rows}',
+    'env.diy.noRow': 'The health check did not find \u201cWorkbench DIY mode\u201d in dsh\u2019s mode roster \u2014 the workbench install most likely did not include the matching mode patch.',
     'env.diy.step': 'Upgrade dsh, then restart the workbench:',
     'env.diy.continue': 'Enter the workbench anyway',
     'env.copyCommand': 'Copy command',
@@ -390,6 +398,18 @@ export const en = {
     'board.title': 'Workbench panel',
     'panel.conversation': 'Conversation',
     'panels.label': 'Global panels',
+    'workbenchSettings.nav': 'Workbench settings',
+    'workbenchSettings.lead': 'Settings the workbench itself owns live here.',
+    'sidebarEdition.nav': 'Session list',
+    'sidebarEdition.lead': 'Which whole left column to use: the official dsh one, or the workbench’s own.',
+    'sidebarEdition.official': 'Official',
+    'sidebarEdition.officialHint': 'Matches dsh exactly and stays stable: search, view options, show more, archive, add workspace — no waiting for us to catch up. Pick it to keep things simple.',
+    'sidebarEdition.custom': 'Custom',
+    'sidebarEdition.customHint': 'Built for multi-project work: one project per dropdown, recency-first sessions, edge fades, marquee, DIY new session. Easier when you juggle projects.',
+    'sidebarEdition.saving': 'Configuring…',
+    'sidebarEdition.reloadRequired': 'Saved. Reload the page to apply — no workbench restart needed.',
+    'sidebarEdition.reload': 'Reload page',
+    'sidebarEdition.failed': 'That choice did not save; try again.',
     'configSync.nav': 'Config sync',
     'configSync.lead': 'Bring over the rows another profile configures explicitly — pick any profile as the source.',
     'configSync.source': 'Source',
@@ -412,8 +432,8 @@ export const en = {
     'configSync.code.expandAria': 'Expand the diff ({count} more lines)',
     'configSync.code.expand': 'Show {count} more lines',
     'configSync.missing': '{pkg} is not installed: the row will not take effect — run `dsh plugin --profile {profile} add {pkg}`, or install it from the module market',
-    'configSync.apply': 'Sync {count} selected',
-    'configSync.applyNone': 'Pick some rows first',
+    'configSync.apply': 'Sync {count} selected items',
+    'configSync.applyNone': 'Choose what to sync',
     'configSync.applying': 'Writing…',
     'configSync.applied': 'Written to the workbench config · applied',
     'configSync.appliedIds': 'Written this time: {ids}',
@@ -421,7 +441,7 @@ export const en = {
     'configSync.nothing': 'Nothing to sync',
     'configSync.unreadable': 'Cannot read {path}: {reason}',
     'configSync.noSource': 'This machine has no other profile to sync from',
-    'configSync.emptyProviders': 'The workbench has no model provider yet — sync the llm- rows from some profile, or configure one under Models.',
+    'configSync.emptyProviders': 'The workbench has no model provider yet — sync the model-provider rows from some profile, or configure one under Models.',
     'configSync.failed': 'The sync did not go through; try again.',
     'debug.workspace': 'this workspace',
     'debug.status': 'Debugging “{title}”',