@xth26/dsh-plan-build-mode 0.2.3 → 0.3.0

package/README.md

@@ -97,6 +97,32 @@ dsh plugin --profile dsh-tui add @xth26/dsh-plan-build-mode@latest
 | `/plan-build switch build` | Enter Build mode (writable) |
 | `/plan-build switch` | Same as `/plan-build`; toggles between modes |
 
+## Keyboard shortcuts
+
+`Ctrl+Alt+Shift+P` toggles between Plan and Build mode (the same action as
+bare `/plan-build`) in both frontends:
+
+- **dsh-tui** — bound through the plugin shortcut registry (`ctx.tuiShortcuts`).
+  It matches only in the plain chat state; overlays and pickers own the
+  keyboard while open.
+- **dsh web** — a global keydown listener runs `/plan-build` against the
+  current session. Inert while no session is open and during IME composition.
+
+The combo is deliberately complex (three modifiers) so it collides with no
+terminal, browser, or OS built-in. Change it with the `shortcut` config key,
+which accepts a single string or an array:
+
+```yaml
+- id: plan-build-mode
+  name: '@xth26/dsh-plan-build-mode'
+  config:
+    shortcut: ['ctrl+alt+shift+p', 'alt+p']
+```
+
+Combos use the `ctrl+alt+shift+p` grammar and must include Ctrl or Alt. The
+TUI refuses combos reserved by its built-in keymap (with a warning; the plugin
+keeps running).
+
 ## Configuration
 
 ```yaml
@@ -134,6 +160,16 @@ After installing/linking the plugin in a DSH profile:
 5. Ask the agent to call `write` again. It should now be allowed.
 6. Run `/plan-build status` to check the current mode without switching.
 
+## Changelog
+
+### 0.3.0 (unreleased)
+
+- Add a Plan/Build toggle keyboard shortcut (`Ctrl+Alt+Shift+P` by default) in
+  both the TUI (`ctx.tuiShortcuts`) and the web frontend (global keydown). The
+  shortcut executes `/plan-build`, so mode state, lifecycle events and grants
+  stay single-source. Configurable via the new `shortcut` config key (a string
+  or an array of combos).
+
 ## License
 
 MIT

package/README.zh.md

@@ -94,6 +94,24 @@ dsh plugin --profile dsh-tui add @xth26/dsh-plan-build-mode@latest
 | `/plan-build switch build` | 进入 Build 模式（可写） |
 | `/plan-build switch` | 同 `/plan-build`，切换当前模式 |
 
+## 快捷键
+
+`Ctrl+Alt+Shift+P` 在两个前端里都能切换 Plan / Build 模式（等同裸 `/plan-build`）：
+
+- **dsh-tui** — 通过插件快捷键注册表（`ctx.tuiShortcuts`）绑定。仅在普通聊天态生效；弹层/选择器打开时会独占键盘。
+- **dsh web** — 全局 keydown 监听对当前会话执行 `/plan-build`。无会话打开或处于输入法组合期间不生效。
+
+组合键刻意做得复杂（三个修饰键），不会与终端、浏览器或系统的内置快捷键冲突。可通过 `shortcut` 配置修改，支持单个字符串或数组：
+
+```yaml
+- id: plan-build-mode
+  name: '@xth26/dsh-plan-build-mode'
+  config:
+    shortcut: ['ctrl+alt+shift+p', 'alt+p']
+```
+
+组合键遵循 `ctrl+alt+shift+p` 语法，必须包含 Ctrl 或 Alt。TUI 会拒绝与其内置键位表冲突的组合（仅警告，插件照常运行）。
+
 ## 配置
 
 ```yaml
@@ -131,6 +149,12 @@ pytest -p no:cacheprovider -q tests/test_sanity.py
 5. 再次让 agent 调用 `write`，应允许执行。
 6. 输入 `/plan-build status`，可只查看当前模式而不切换。
 
+## 变更日志
+
+### 0.3.0（未发布）
+
+- 在 TUI（`ctx.tuiShortcuts`）与 web 前端（全局 keydown）都新增 Plan / Build 切换快捷键（默认 `Ctrl+Alt+Shift+P`）。快捷键执行 `/plan-build`，因此模式状态、生命周期事件与授权保持单一来源。可通过新增的 `shortcut` 配置键自定义（单个字符串或组合数组）。
+
 ## 许可证
 
 MIT

package/lib/client/index.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Browser half of `dsh-plan-build-mode`.
+ *
+ * Adds a global keyboard shortcut that toggles OpenCode Plan / Build mode by
+ * executing the host `/plan-build` command against the current session. The
+ * bundle is a pure listener: it renders nothing and occupies no Slot seat.
+ *
+ * The services are consumed through locally declared structural faces rather
+ * than cross-plugin imports on purpose — a browser bundle must not compile a
+ * require() edge into the loader module table (bundle purity), and these
+ * shapes are small and stable. The default combo is kept deliberately complex
+ * (three modifiers) so it collides with no terminal or browser built-in.
+ *
+ * @module dsh-plan-build-mode/client
+ */
+/** Default shortcut; keep in sync with DEFAULT_SHORTCUT in ../helpers.ts. */
+export declare const DEFAULT_SHORTCUT = "ctrl+alt+shift+p";
+/** Client plugin name. */
+export declare const name = "plan-build-mode-client";
+/**
+ * Services required at runtime: the commands Remote for `/plan-build` and the
+ * session list for the current session id.
+ */
+export declare const inject: readonly ["remote", "remote.commands", "sessions"];
+/** Optional config subset accepted by the client bundle. */
+export interface PlanBuildModeClientConfig {
+    /** One or more `ctrl+alt+shift+p` style combos; defaults to DEFAULT_SHORTCUT. */
+    readonly shortcut?: string | readonly string[];
+}
+/** Minimal structural faces of the services this plugin consumes. */
+export interface PlanBuildModeClientContext {
+    effect(fn: () => (() => void) | void): void;
+    sessions: {
+        list: {
+            getSnapshot(): {
+                current: string | undefined;
+            };
+        };
+    };
+    remote: {
+        commands: {
+            execute(sessionId: string, line: string, images: readonly unknown[]): Promise<{
+                ok: boolean;
+                error?: {
+                    code: string;
+                    message: string;
+                };
+            }>;
+        };
+    };
+}
+/** A parsed `ctrl+alt+shift+p` style combo. */
+export interface ParsedShortcut {
+    readonly ctrl: boolean;
+    readonly alt: boolean;
+    readonly shift: boolean;
+    readonly key: string;
+}
+/**
+ * Parse a `ctrl+alt+shift+p` style combo. Requires at least one of ctrl/alt
+ * and exactly one key; returns undefined for malformed or modifier-less
+ * combos (mirrors the dsh-tui combo grammar).
+ */
+export declare function parseShortcutCombo(raw: string): ParsedShortcut | undefined;
+/** Structural keydown shape so matching is testable without a DOM. */
+export interface ShortcutKeyEvent {
+    readonly ctrlKey: boolean;
+    readonly altKey: boolean;
+    readonly shiftKey: boolean;
+    readonly metaKey: boolean;
+    readonly key: string;
+}
+/** Exact modifier + key match against a keydown event. The mac cmd (meta)
+ *  modifier is never part of a spelled combo, so any meta press is a miss. */
+export declare function shortcutMatches(combo: ParsedShortcut, event: ShortcutKeyEvent): boolean;
+/** Resolve configured combos to parsed form, dropping malformed entries. */
+export declare function resolveCombos(configured: string | readonly string[] | undefined): ParsedShortcut[];
+/**
+ * Client plugin body: one global keydown listener that runs `/plan-build`
+ * against the current session. Inert without a current session, during IME
+ * composition, and on non-matching combos.
+ * @param ctx - client root context.
+ * @param config - optional config subset (shortcut combos).
+ */
+export declare function apply(ctx: PlanBuildModeClientContext, config?: PlanBuildModeClientConfig): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,qBAAqB,CAAA;AAElD,0BAA0B;AAC1B,eAAO,MAAM,IAAI,2BAA2B,CAAA;AAE5C;;;GAGG;AACH,eAAO,MAAM,MAAM,oDAAqD,CAAA;AAExE,4DAA4D;AAC5D,MAAM,WAAW,yBAAyB;IACxC,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;CAC/C;AAED,qEAAqE;AACrE,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAA;IAC3C,QAAQ,EAAE;QACR,IAAI,EAAE;YACJ,WAAW,IAAI;gBAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;aAAE,CAAA;SAC/C,CAAA;KACF,CAAA;IACD,MAAM,EAAE;QACN,QAAQ,EAAE;YACR,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC;gBAC5E,EAAE,EAAE,OAAO,CAAA;gBACX,KAAK,CAAC,EAAE;oBAAE,IAAI,EAAE,MAAM,CAAC;oBAAC,OAAO,EAAE,MAAM,CAAA;iBAAE,CAAA;aAC1C,CAAC,CAAA;SACH,CAAA;KACF,CAAA;CACF;AAED,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CA+B1E;AAED,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED;8EAC8E;AAC9E,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAMvF;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,cAAc,EAAE,CASlG;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,0BAA0B,EAAE,MAAM,GAAE,yBAA8B,GAAG,IAAI,CAwBnG"}

package/lib/client/index.js

@@ -0,0 +1,139 @@
+"use strict";
+/**
+ * Browser half of `dsh-plan-build-mode`.
+ *
+ * Adds a global keyboard shortcut that toggles OpenCode Plan / Build mode by
+ * executing the host `/plan-build` command against the current session. The
+ * bundle is a pure listener: it renders nothing and occupies no Slot seat.
+ *
+ * The services are consumed through locally declared structural faces rather
+ * than cross-plugin imports on purpose — a browser bundle must not compile a
+ * require() edge into the loader module table (bundle purity), and these
+ * shapes are small and stable. The default combo is kept deliberately complex
+ * (three modifiers) so it collides with no terminal or browser built-in.
+ *
+ * @module dsh-plan-build-mode/client
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inject = exports.name = exports.DEFAULT_SHORTCUT = void 0;
+exports.parseShortcutCombo = parseShortcutCombo;
+exports.shortcutMatches = shortcutMatches;
+exports.resolveCombos = resolveCombos;
+exports.apply = apply;
+/** Default shortcut; keep in sync with DEFAULT_SHORTCUT in ../helpers.ts. */
+exports.DEFAULT_SHORTCUT = 'ctrl+alt+shift+p';
+/** Client plugin name. */
+exports.name = 'plan-build-mode-client';
+/**
+ * Services required at runtime: the commands Remote for `/plan-build` and the
+ * session list for the current session id.
+ */
+exports.inject = ['remote', 'remote.commands', 'sessions'];
+/**
+ * Parse a `ctrl+alt+shift+p` style combo. Requires at least one of ctrl/alt
+ * and exactly one key; returns undefined for malformed or modifier-less
+ * combos (mirrors the dsh-tui combo grammar).
+ */
+function parseShortcutCombo(raw) {
+    const parts = String(raw ?? '')
+        .toLowerCase()
+        .split('+')
+        .map(part => part.trim())
+        .filter(part => part !== '');
+    if (parts.length < 2)
+        return undefined;
+    let ctrl = false;
+    let alt = false;
+    let shift = false;
+    let key;
+    for (const part of parts) {
+        if (part === 'ctrl' || part === 'control') {
+            ctrl = true;
+        }
+        else if (part === 'alt' || part === 'meta' || part === 'option') {
+            alt = true;
+        }
+        else if (part === 'shift') {
+            shift = true;
+        }
+        else if (part === 'space') {
+            if (key !== undefined)
+                return undefined;
+            key = ' ';
+        }
+        else if ([...part].length === 1) {
+            if (key !== undefined)
+                return undefined;
+            key = part;
+        }
+        else {
+            return undefined;
+        }
+    }
+    if (key === undefined)
+        return undefined;
+    if (!ctrl && !alt)
+        return undefined;
+    return { ctrl, alt, shift, key };
+}
+/** Exact modifier + key match against a keydown event. The mac cmd (meta)
+ *  modifier is never part of a spelled combo, so any meta press is a miss. */
+function shortcutMatches(combo, event) {
+    if (event.metaKey)
+        return false;
+    if (event.ctrlKey !== combo.ctrl)
+        return false;
+    if (event.altKey !== combo.alt)
+        return false;
+    if (event.shiftKey !== combo.shift)
+        return false;
+    return event.key.toLowerCase() === combo.key;
+}
+/** Resolve configured combos to parsed form, dropping malformed entries. */
+function resolveCombos(configured) {
+    const raw = configured === undefined
+        ? [exports.DEFAULT_SHORTCUT]
+        : typeof configured === 'string'
+            ? [configured]
+            : [...configured];
+    return raw
+        .map(parseShortcutCombo)
+        .filter((combo) => combo !== undefined);
+}
+/**
+ * Client plugin body: one global keydown listener that runs `/plan-build`
+ * against the current session. Inert without a current session, during IME
+ * composition, and on non-matching combos.
+ * @param ctx - client root context.
+ * @param config - optional config subset (shortcut combos).
+ */
+function apply(ctx, config = {}) {
+    const combos = resolveCombos(config.shortcut);
+    if (combos.length === 0)
+        return;
+    ctx.effect(() => {
+        const onKeyDown = (event) => {
+            if (event.isComposing)
+                return;
+            for (const combo of combos) {
+                if (!shortcutMatches(combo, event))
+                    continue;
+                const sessionId = ctx.sessions.list.getSnapshot().current;
+                if (sessionId === undefined)
+                    return;
+                event.preventDefault();
+                void ctx.remote.commands.execute(sessionId, '/plan-build', []).then((result) => {
+                    if (!result.ok && result.error !== undefined) {
+                        console.warn(`[plan-build-mode] shortcut failed (${result.error.code}): ${result.error.message}`);
+                    }
+                });
+                return;
+            }
+        };
+        window.addEventListener('keydown', onKeyDown);
+        return () => {
+            window.removeEventListener('keydown', onKeyDown);
+        };
+    });
+}
+//# sourceMappingURL=index.js.map

package/lib/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"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"}

package/lib/client.js

@@ -0,0 +1,141 @@
+window.__ModuleLoader__.load({ id: "@xth26/dsh-plan-build-mode", factory: (require) => {
+var module = { exports: {} }; var exports = module.exports;
+"use strict";
+/**
+ * Browser half of `dsh-plan-build-mode`.
+ *
+ * Adds a global keyboard shortcut that toggles OpenCode Plan / Build mode by
+ * executing the host `/plan-build` command against the current session. The
+ * bundle is a pure listener: it renders nothing and occupies no Slot seat.
+ *
+ * The services are consumed through locally declared structural faces rather
+ * than cross-plugin imports on purpose — a browser bundle must not compile a
+ * require() edge into the loader module table (bundle purity), and these
+ * shapes are small and stable. The default combo is kept deliberately complex
+ * (three modifiers) so it collides with no terminal or browser built-in.
+ *
+ * @module dsh-plan-build-mode/client
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inject = exports.name = exports.DEFAULT_SHORTCUT = void 0;
+exports.parseShortcutCombo = parseShortcutCombo;
+exports.shortcutMatches = shortcutMatches;
+exports.resolveCombos = resolveCombos;
+exports.apply = apply;
+/** Default shortcut; keep in sync with DEFAULT_SHORTCUT in ../helpers.ts. */
+exports.DEFAULT_SHORTCUT = 'ctrl+alt+shift+p';
+/** Client plugin name. */
+exports.name = 'plan-build-mode-client';
+/**
+ * Services required at runtime: the commands Remote for `/plan-build` and the
+ * session list for the current session id.
+ */
+exports.inject = ['remote', 'remote.commands', 'sessions'];
+/**
+ * Parse a `ctrl+alt+shift+p` style combo. Requires at least one of ctrl/alt
+ * and exactly one key; returns undefined for malformed or modifier-less
+ * combos (mirrors the dsh-tui combo grammar).
+ */
+function parseShortcutCombo(raw) {
+    const parts = String(raw ?? '')
+        .toLowerCase()
+        .split('+')
+        .map(part => part.trim())
+        .filter(part => part !== '');
+    if (parts.length < 2)
+        return undefined;
+    let ctrl = false;
+    let alt = false;
+    let shift = false;
+    let key;
+    for (const part of parts) {
+        if (part === 'ctrl' || part === 'control') {
+            ctrl = true;
+        }
+        else if (part === 'alt' || part === 'meta' || part === 'option') {
+            alt = true;
+        }
+        else if (part === 'shift') {
+            shift = true;
+        }
+        else if (part === 'space') {
+            if (key !== undefined)
+                return undefined;
+            key = ' ';
+        }
+        else if ([...part].length === 1) {
+            if (key !== undefined)
+                return undefined;
+            key = part;
+        }
+        else {
+            return undefined;
+        }
+    }
+    if (key === undefined)
+        return undefined;
+    if (!ctrl && !alt)
+        return undefined;
+    return { ctrl, alt, shift, key };
+}
+/** Exact modifier + key match against a keydown event. The mac cmd (meta)
+ *  modifier is never part of a spelled combo, so any meta press is a miss. */
+function shortcutMatches(combo, event) {
+    if (event.metaKey)
+        return false;
+    if (event.ctrlKey !== combo.ctrl)
+        return false;
+    if (event.altKey !== combo.alt)
+        return false;
+    if (event.shiftKey !== combo.shift)
+        return false;
+    return event.key.toLowerCase() === combo.key;
+}
+/** Resolve configured combos to parsed form, dropping malformed entries. */
+function resolveCombos(configured) {
+    const raw = configured === undefined
+        ? [exports.DEFAULT_SHORTCUT]
+        : typeof configured === 'string'
+            ? [configured]
+            : [...configured];
+    return raw
+        .map(parseShortcutCombo)
+        .filter((combo) => combo !== undefined);
+}
+/**
+ * Client plugin body: one global keydown listener that runs `/plan-build`
+ * against the current session. Inert without a current session, during IME
+ * composition, and on non-matching combos.
+ * @param ctx - client root context.
+ * @param config - optional config subset (shortcut combos).
+ */
+function apply(ctx, config = {}) {
+    const combos = resolveCombos(config.shortcut);
+    if (combos.length === 0)
+        return;
+    ctx.effect(() => {
+        const onKeyDown = (event) => {
+            if (event.isComposing)
+                return;
+            for (const combo of combos) {
+                if (!shortcutMatches(combo, event))
+                    continue;
+                const sessionId = ctx.sessions.list.getSnapshot().current;
+                if (sessionId === undefined)
+                    return;
+                event.preventDefault();
+                void ctx.remote.commands.execute(sessionId, '/plan-build', []).then((result) => {
+                    if (!result.ok && result.error !== undefined) {
+                        console.warn(`[plan-build-mode] shortcut failed (${result.error.code}): ${result.error.message}`);
+                    }
+                });
+                return;
+            }
+        };
+        window.addEventListener('keydown', onKeyDown);
+        return () => {
+            window.removeEventListener('keydown', onKeyDown);
+        };
+    });
+}
+return module.exports; } });

package/lib/helpers.d.ts

@@ -10,6 +10,15 @@ import type { ToolExecution } from '@deepseek-ai/dsh-tools';
 export declare const DEFAULT_PLAN_SANDBOX: SandboxMode;
 /** Default sandbox mode while Build mode is active. */
 export declare const DEFAULT_BUILD_SANDBOX: SandboxMode;
+/**
+ * Default keyboard shortcut that toggles Plan/Build mode. Kept deliberately
+ * complex (three modifiers) so it collides with no terminal or browser
+ * built-in: the TUI reserved set (ctrl+c/d/e/a/u/k/w, ctrl+left/right,
+ * ctrl+return, alt+return, alt+up, tab, …) and the built-in actions
+ * (ctrl+v/r/g/o/t/a/p/e/l/q, …) are all single-modifier, and no browser or
+ * OS binds ctrl+alt+shift+p.
+ */
+export declare const DEFAULT_SHORTCUT = "ctrl+alt+shift+p";
 /** Tools forbidden while in Plan mode. */
 export declare const WRITE_TOOLS: Set<string>;
 /**

package/lib/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAG3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE3D,sDAAsD;AACtD,eAAO,MAAM,oBAAoB,EAAE,WAAyB,CAAA;AAE5D,uDAAuD;AACvD,eAAO,MAAM,qBAAqB,EAAE,WAA+B,CAAA;AAEnE,0CAA0C;AAC1C,eAAO,MAAM,WAAW,aAA6B,CAAA;AAErD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,WAAW,GAAG,SAAS,CAQ3F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAEnG;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,GAAG,IAAI,CAGhI;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,aAAa,EACnB,WAAW,EAAE,WAAW,EACxB,UAAU,GAAE,WAAW,CAAC,MAAM,CAAe,GAC5C,MAAM,GAAG,SAAS,CAQpB"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAG3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE3D,sDAAsD;AACtD,eAAO,MAAM,oBAAoB,EAAE,WAAyB,CAAA;AAE5D,uDAAuD;AACvD,eAAO,MAAM,qBAAqB,EAAE,WAA+B,CAAA;AAEnE;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,qBAAqB,CAAA;AAElD,0CAA0C;AAC1C,eAAO,MAAM,WAAW,aAA6B,CAAA;AAErD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,WAAW,GAAG,SAAS,CAQ3F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAEnG;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,GAAG,IAAI,CAGhI;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,aAAa,EACnB,WAAW,EAAE,WAAW,EACxB,UAAU,GAAE,WAAW,CAAC,MAAM,CAAe,GAC5C,MAAM,GAAG,SAAS,CAQpB"}

package/lib/helpers.js

@@ -6,6 +6,15 @@
 export const DEFAULT_PLAN_SANDBOX = 'read-only';
 /** Default sandbox mode while Build mode is active. */
 export const DEFAULT_BUILD_SANDBOX = 'workspace-write';
+/**
+ * Default keyboard shortcut that toggles Plan/Build mode. Kept deliberately
+ * complex (three modifiers) so it collides with no terminal or browser
+ * built-in: the TUI reserved set (ctrl+c/d/e/a/u/k/w, ctrl+left/right,
+ * ctrl+return, alt+return, alt+up, tab, …) and the built-in actions
+ * (ctrl+v/r/g/o/t/a/p/e/l/q, …) are all single-modifier, and no browser or
+ * OS binds ctrl+alt+shift+p.
+ */
+export const DEFAULT_SHORTCUT = 'ctrl+alt+shift+p';
 /** Tools forbidden while in Plan mode. */
 export const WRITE_TOOLS = new Set(['write', 'edit']);
 /**

package/lib/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,sDAAsD;AACtD,MAAM,CAAC,MAAM,oBAAoB,GAAgB,WAAW,CAAA;AAE5D,uDAAuD;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAgB,iBAAiB,CAAA;AAEnE,0CAA0C;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;AAErD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA+B;IAChE,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE,CAAA;QACxB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAClC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAA;QACxB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA+B,EAAE,WAAwB;IACxF,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,WAAW,CAAA;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAY,EAAE,IAAsB,EAAE,WAAwB,EAAE,YAAyB;IACxH,MAAM,MAAM,GAAgB,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAA;IACxE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;AACxD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAmB,EACnB,WAAwB,EACxB,aAAkC,WAAW;IAE7C,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC9C,IAAI,WAAW,KAAK,WAAW;QAAE,OAAO,SAAS,CAAA;IACjD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC;QAAE,OAAO,SAAS,CAAA;IAC/E,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO,SAAS,IAAI,CAAC,IAAI,qHAAqH,CAAA;IAChJ,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,sDAAsD;AACtD,MAAM,CAAC,MAAM,oBAAoB,GAAgB,WAAW,CAAA;AAE5D,uDAAuD;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAgB,iBAAiB,CAAA;AAEnE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAA;AAElD,0CAA0C;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;AAErD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA+B;IAChE,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE,CAAA;QACxB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAClC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAA;QACxB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA+B,EAAE,WAAwB;IACxF,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,WAAW,CAAA;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAY,EAAE,IAAsB,EAAE,WAAwB,EAAE,YAAyB;IACxH,MAAM,MAAM,GAAgB,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAA;IACxE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;AACxD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAmB,EACnB,WAAwB,EACxB,aAAkC,WAAW;IAE7C,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC9C,IAAI,WAAW,KAAK,WAAW;QAAE,OAAO,SAAS,CAAA;IACjD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC;QAAE,OAAO,SAAS,CAAA;IAC/E,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO,SAAS,IAAI,CAAC,IAAI,qHAAqH,CAAA;IAChJ,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/lib/index.d.ts

@@ -26,11 +26,13 @@ export declare const Config: z<Schemastery.ObjectS<{
     buildSandbox: z<"read-only" | "workspace-write" | "danger-full-access", "read-only" | "workspace-write" | "danger-full-access">;
     denyWriteTools: z<boolean, boolean>;
     section: z<boolean, boolean>;
+    shortcut: z<string | string[], string | string[]>;
 }>, Schemastery.ObjectT<{
     planSandbox: z<"read-only" | "workspace-write" | "danger-full-access", "read-only" | "workspace-write" | "danger-full-access">;
     buildSandbox: z<"read-only" | "workspace-write" | "danger-full-access", "read-only" | "workspace-write" | "danger-full-access">;
     denyWriteTools: z<boolean, boolean>;
     section: z<boolean, boolean>;
+    shortcut: z<string | string[], string | string[]>;
 }>>;
 /**
  * Plugin entry point.

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAmBxC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAErD,0BAA0B;AAC1B,eAAO,MAAM,IAAI,wBAAwB,CAAA;AACzC,8CAA8C;AAC9C,eAAO,MAAM,MAAM,8CAA+C,CAAA;AAClE,4BAA4B;AAC5B,eAAO,MAAM,MAAM;;;;;;;;;;GAajB,CAAA;AAEF;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,mBAAwB,GAAG,IAAI,CAoG1E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAoBxC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAErD,0BAA0B;AAC1B,eAAO,MAAM,IAAI,wBAAwB,CAAA;AACzC,8CAA8C;AAC9C,eAAO,MAAM,MAAM,8CAA+C,CAAA;AAclE,4BAA4B;AAC5B,eAAO,MAAM,MAAM;;;;;;;;;;;;GAcjB,CAAA;AAEF;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,mBAAwB,GAAG,IAAI,CAkI1E"}

package/lib/index.js

@@ -14,7 +14,7 @@
  * @module dsh-plan-build-mode
  */
 import z from '@deepseek-ai/schemastery';
-import { DEFAULT_BUILD_SANDBOX, DEFAULT_PLAN_SANDBOX, isPlanModeActive, planModeDenial, setPlanBuildMode, WRITE_TOOLS, } from "./helpers.js";
+import { DEFAULT_BUILD_SANDBOX, DEFAULT_PLAN_SANDBOX, DEFAULT_SHORTCUT, isPlanModeActive, planModeDenial, setPlanBuildMode, WRITE_TOOLS, } from "./helpers.js";
 /** Cordis plugin name. */
 export const name = 'dsh-plan-build-mode';
 /** Service dependencies for the host half. */
@@ -33,6 +33,7 @@ export const Config = z.object({
     ]).required(false),
     denyWriteTools: z.boolean().default(true),
     section: z.boolean().default(true),
+    shortcut: z.union([z.string(), z.array(z.string())]).required(false),
 });
 /**
  * Plugin entry point.
@@ -125,6 +126,38 @@ export function apply(ctx, config = {}) {
                     return { kind: 'success', text: `Switched to ${target} mode.` };
                 },
             }));
+            // dsh-tui keyboard shortcut: toggles through the same /plan-build
+            // command, so state, lifecycle events and grants stay single-source.
+            // Waits on ctx.tuiShortcuts (the dsh-tui-extensions row); inert in web
+            // and headless compositions where that service never mounts. The child
+            // fiber is cleaned up with the commands scope (same pattern as the
+            // outer ctx.inject).
+            commandCtx.inject(['tuiShortcuts'], (tuiCtx) => {
+                const tuiShortcuts = tuiCtx.get('tuiShortcuts');
+                if (tuiShortcuts === undefined)
+                    return;
+                const combos = config.shortcut === undefined
+                    ? [DEFAULT_SHORTCUT]
+                    : typeof config.shortcut === 'string'
+                        ? [config.shortcut]
+                        : [...config.shortcut];
+                for (const combo of combos) {
+                    disposers.push(tuiShortcuts.register(combo, {
+                        description: 'Toggle between OpenCode Plan and Build modes',
+                        handler: async () => {
+                            const agent = ctx.agents.list()[0];
+                            if (agent === undefined)
+                                return;
+                            try {
+                                await commandCtx.commands.execute(agent, '/plan-build', [], new AbortController().signal);
+                            }
+                            catch (error) {
+                                ctx.logger.warn('dsh-plan-build-mode: TUI shortcut /plan-build failed: %o', error);
+                            }
+                        },
+                    }, ctx));
+                }
+            });
         });
         return () => {
             for (const dispose of disposers)

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/types.d.ts

@@ -29,5 +29,13 @@ export interface PlanBuildModeConfig {
      * @default true
      */
     section?: boolean;
+    /**
+     * Keyboard shortcut(s) that toggle between Plan and Build modes in clients
+     * exposing a shortcut seam. dsh-tui binds them through `ctx.tuiShortcuts`;
+     * the web client binds the same combos through its global keydown listener.
+     * Combos use the `ctrl+alt+shift+p` grammar (ctrl or alt required).
+     * @default ['ctrl+alt+shift+p']
+     */
+    shortcut?: string | readonly string[];
 }
 //# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE3D,OAAO,QAAQ,gCAAgC,CAAC;CAG/C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB;;;OAGG;IACH,YAAY,CAAC,EAAE,WAAW,CAAA;IAC1B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE3D,OAAO,QAAQ,gCAAgC,CAAC;CAG/C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB;;;OAGG;IACH,YAAY,CAAC,EAAE,WAAW,CAAA;IAC1B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;CACtC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xth26/dsh-plan-build-mode",
   "description": "OpenCode-style Plan / Build hard permission model for DSH",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "publishConfig": {
     "access": "public"
   },
@@ -17,6 +17,10 @@
       "types": "./lib/types/invariant.d.ts",
       "default": "./lib/invariant.js"
     },
+    "./client": {
+      "types": "./lib/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
     "./src/*": "./src/*",
     "./package.json": "./package.json"
   },
@@ -30,6 +34,12 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-api-remotes"
+      ],
+      "platform": "web"
     }
   },
   "license": "MIT",
@@ -93,7 +103,7 @@
     "vitest": "^2.1.0"
   },
   "scripts": {
-    "build": "tsc -b tsconfig.json",
+    "build": "tsc -b tsconfig.json && tsc -b tsconfig.client.json && node scripts/build-client-bundle.mjs",
     "test": "vitest run",
     "typecheck": "tsc --noEmit -p tsconfig.json"
   }