@deepseek-harness-tui/dsh-tui 0.15.0 → 0.16.0

package/lib/types/dsh-adapter/backend-contribution.js

@@ -35,3 +35,44 @@ export function backendContributionOf(manifest) {
         ...(manifest.unloadExport === undefined ? {} : { unloadExport: manifest.unloadExport }),
     };
 }
+/**
+ * The registry entry a **third-party** declaration becomes (D-1): the inverse of
+ * {@link backendContributionOf} on the fields both shapes carry.
+ *
+ * A contribution declares less than an in-tree manifest, and everything it cannot
+ * declare is fixed here rather than defaulted by the caller:
+ *
+ *  - `inTree: false` — the one fact that flips the registry's rules (reserved ids,
+ *    host label keys, `alwaysAvailable`, `nativeKey`, label sanitization). A
+ *    contribution is exactly the non-in-tree case, so the projection says so
+ *    instead of leaving a boolean for a caller to get wrong.
+ *  - `label` is already the literal the spec requires; `label.kind === 'key'` is
+ *    unreachable here (the spec has no such field, and `validateBackendSpec()`
+ *    refuses it as an unknown field), so a declaration can never borrow this
+ *    host's own vocabulary.
+ *  - `alwaysAvailable` / `nativeKey` / `vendorPackages` / `backendExport` are
+ *    **not** writable from a declaration and are therefore absent from the
+ *    result: `registerBackend()` rejects an explicit `alwaysAvailable` /
+ *    `nativeKey`, and the `backendExport` default (`'backend'`) is the registry's
+ *    documented read of the module namespace, not a field to invent here.
+ *  - `confirmation` stays behind: it is a request to the *install / enable* chain
+ *    (`BACKEND_CONFIRMATION_POLICIES`), which reads the declaration, not the
+ *    manifest. Dropping it here is what keeps one reading of it.
+ *
+ * Pure, like its counterpart: the same declaration projects to a deep-equal
+ * manifest every time, and the result is the value `registerBackend()` validates,
+ * admits and registers.
+ */
+export function backendManifestOf(spec) {
+    return {
+        id: spec.id,
+        label: { kind: 'literal', text: spec.label.text },
+        shortLabel: spec.shortLabel,
+        ...(spec.product === undefined ? {} : { product: spec.product }),
+        capabilities: [...spec.capabilities],
+        grants: [...spec.grants],
+        ...(spec.install === undefined ? {} : { install: { ...spec.install } }),
+        ...(spec.unloadExport === undefined ? {} : { unloadExport: spec.unloadExport }),
+        inTree: false,
+    };
+}

package/lib/types/dsh-adapter/backend-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend-registry.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/backend-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAKzG,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAE7E,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAKhF,OAAO,EAAE,iBAAiB,EAAE,CAAA;AA6C5B;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;IAClC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAA;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CACvD;AA0CD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAgEzD;AAOD,uEAAuE;AACvE,wBAAgB,YAAY,IAAI,SAAS,iBAAiB,EAAE,CAE3D;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,iBAAiB,EAAE,CAElE;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB;;6CAEyC;IACzC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,IAAI,qBAAqB,CAkB7D;AAED,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEpE;AAED;;sEAEsE;AACtE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAI9E;AAED;;kBAEkB;AAClB,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAkB5E;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CASpD"}
+{"version":3,"file":"backend-registry.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/backend-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAKzG,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAE7E,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAKhF,OAAO,EAAE,iBAAiB,EAAE,CAAA;AA6C5B;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;IAClC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAA;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CACvD;AA0CD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAsEzD;AAOD,uEAAuE;AACvE,wBAAgB,YAAY,IAAI,SAAS,iBAAiB,EAAE,CAE3D;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,iBAAiB,EAAE,CAElE;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB;;6CAEyC;IACzC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,IAAI,qBAAqB,CAkB7D;AAED,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEpE;AAED;;sEAEsE;AACtE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAI9E;AAED;;kBAEkB;AAClB,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CA6B5E;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CASpD"}

package/lib/types/dsh-adapter/backend-registry.js

@@ -1,7 +1,7 @@
 import { isBackendIdSyntax } from '../agent/backend-manifest.js';
 import { BACKEND_CAPABILITY_NAMES } from '../adapter/spec/backend-capabilities.js';
 import { EXPECTED_PERMISSIONS } from '../adapter/spec/protocol-constants.js';
-import { validateBackendSpec } from '../adapter/spec/tui-contributions.js';
+import { assertBackendHandler, validateBackendSpec } from '../adapter/spec/tui-contributions.js';
 import { cleanRenderText } from '../channel/sanitize.js';
 import { BUILTIN_BACKEND_IDS } from '../kernelPrefs.js';
 import { logForDebugging } from '../utils/debug.js';
@@ -95,13 +95,19 @@ export function registerBackend(entry) {
     if (!isBackendIdSyntax(manifest.id)) {
         throw new Error(`${where} has an invalid id (lowercase letters, digits and dashes, at most 32 characters)`);
     }
-    if (entries.has(manifest.id))
-        throw new Error(`${where} is already registered`);
+    // The reserved check comes first on purpose (D-1). Every built-in id is seeded
+    // before any other caller can run, so an "is it taken?" test would answer for a
+    // plugin wearing `claude` too — and it would name the wrong reason: the id is
+    // not taken by a rival, it is one this host owns and no declaration may wear
+    // (`BACKEND_ID_RESERVED` in the family's contract). Registration is the last
+    // place that can still tell the two apart.
     if (!manifest.inTree && BUILTIN_BACKEND_IDS.includes(manifest.id)) {
         // `dsh` refs serialize without a prefix (`formatSessionRef`), so a plugin
         // wearing that id would collide with first-party references.
         throw new Error(`${where} is a reserved built-in id`);
     }
+    if (entries.has(manifest.id))
+        throw new Error(`${where} is already registered`);
     if (!manifest.inTree && manifest.label.kind === 'key') {
         // Otherwise a plugin could claim a first-party name: `t()` returns the text
         // of an existing key (`src/i18n.ts`), so the row would read "DeepSeek Harness".
@@ -244,6 +250,9 @@ export async function loadBackend(id) {
     const entry = entries.get(id);
     if (entry === undefined)
         throw new Error(`dsh-tui: backend "${id}" is not registered`);
+    if (entry.admission.decision === 'waiting_authorization') {
+        throw new Error(`dsh-tui: backend "${id}" cannot load: ${entry.admission.reasonCode} (${entry.admission.deniedPermissions.join(', ')})`);
+    }
     if (entry.load === undefined)
         throw new Error(`dsh-tui: backend "${id}" has no loader (only the DSH kernel is not an AgentBackend)`);
     const module = await entry.load();
@@ -260,6 +269,16 @@ export async function loadBackend(id) {
     const backend = module[exportName];
     if (backend === undefined)
         throw new Error(`dsh-tui: backend "${id}" does not export "${exportName}"`);
+    // Book the imported module's pool above even when its handler is invalid.
+    // No caller may prepare a session or data directory under another backend id.
+    try {
+        assertBackendHandler(backend);
+    }
+    catch (error) {
+        throw new Error(`dsh-tui: backend "${id}" has an invalid handler (${error instanceof Error ? error.message : String(error)})`, { cause: error });
+    }
+    if (backend.id !== id)
+        throw new Error(`dsh-tui: backend "${id}" exports a handler for ${JSON.stringify(backend.id)}`);
     return backend;
 }
 /**

package/lib/types/dsh-adapter/backends.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backends.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/backends.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAyB,UAAU,EAAE,iBAAiB,EAAkC,MAAM,qBAAqB,CAAA;AAC1J,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAWlE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAW3E;AAID;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAqB1I;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE;IACtF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IACrC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CACjC;;;;;;iBASyB,OAAO,CAAC;QAAE,OAAO,EAAE,YAAY,CAAC;QAAC,cAAc,EAAE,SAAS,UAAU,EAAE,CAAA;KAAE,CAAC;4BA2CvE,MAAM,QAAQ,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;+BAC/C,MAAM;mBAClB,OAAO,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAA;KAAE,CAAC;GAG7E;AAED,oFAAoF;AACpF,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAAC;aAnDnF,YAAY;oBAAkB,SAAS,UAAU,EAAE;;;;;;iBAAtE,OAAO,CAAC;QAAE,OAAO,EAAE,YAAY,CAAC;QAAC,cAAc,EAAE,SAAS,UAAU,EAAE,CAAA;KAAE,CAAC;4BA2CvE,MAAM,QAAQ,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;+BAC/C,MAAM;mBAClB,OAAO,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAA;KAAE,CAAC;GAS7E;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAenG"}
+{"version":3,"file":"backends.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/backends.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAyB,UAAU,EAAE,iBAAiB,EAAkC,MAAM,qBAAqB,CAAA;AAC1J,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAWlE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAW3E;AAID;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAqB1I;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE;IACtF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IACrC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CACjC;;;;;;iBASyB,OAAO,CAAC;QAAE,OAAO,EAAE,YAAY,CAAC;QAAC,cAAc,EAAE,SAAS,UAAU,EAAE,CAAA;KAAE,CAAC;4BA2CvE,MAAM,QAAQ,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;+BAC/C,MAAM;mBAClB,OAAO,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAA;KAAE,CAAC;GAG7E;AAED,oFAAoF;AACpF,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAAC;aAnDnF,YAAY;oBAAkB,SAAS,UAAU,EAAE;;;;;;iBAAtE,OAAO,CAAC;QAAE,OAAO,EAAE,YAAY,CAAC;QAAC,cAAc,EAAE,SAAS,UAAU,EAAE,CAAA;KAAE,CAAC;4BA2CvE,MAAM,QAAQ,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;+BAC/C,MAAM;mBAClB,OAAO,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAA;KAAE,CAAC;GAS7E;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAenG"}

package/lib/types/dsh-adapter/backends.js

@@ -1,13 +1,12 @@
-import { join } from 'node:path';
 import { formatSessionRef } from '../agent/refs.js';
-import { getBackend, listBackends, loadBackend } from './backend-registry.js';
+import { getBackend, listOfferedBackends, loadBackend } from './backend-registry.js';
 import { reserveMount, reserveNewSession } from '../sessionMounts.js';
 import { resumeTargetFromArgv } from '../sessionHistory.js';
 import { mountFailureText } from '../sessions/resumeFailure.js';
 import { getLang } from '../i18n.js';
 import { installedTuiVersion } from '../update.js';
 import { logForDebugging } from '../utils/debug.js';
-import { DATA_DIR } from '../utils/paths.js';
+import { backendDataDir } from '../utils/paths.js';
 import { installExecutor } from './install/executors.js';
 import { fileChannelTokens } from '../backends/shared/channel-tokens.js';
 /**
@@ -55,7 +54,7 @@ export async function createBackendHost(ctx, backendId, cwd, stderr) {
     const appVersion = installedTuiVersion();
     return {
         cwd,
-        dataDir: join(DATA_DIR, 'backends', backendId),
+        dataDir: backendDataDir(backendId),
         locale: () => getLang(),
         ...(appVersion === undefined ? {} : { appVersion }),
         debug: message => logForDebugging(message),
@@ -152,7 +151,7 @@ export async function openBackendStartup(ctx, backend, input) {
  */
 export async function probeKernels(ctx, cwd) {
     const statuses = {};
-    for (const entry of listBackends()) {
+    for (const entry of listOfferedBackends()) {
         if (entry.load === undefined)
             continue;
         // One host per entry: `dataDir` is backend-scoped, and a probe must not

package/lib/types/dsh-adapter/bundled-presets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundled-presets.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/bundled-presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAwClD;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CA0C3E"}
+{"version":3,"file":"bundled-presets.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/bundled-presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAuFlD;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAoD3E"}

package/lib/types/dsh-adapter/bundled-presets.js

@@ -4,6 +4,9 @@ import { join } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { parse } from 'yaml';
 import { packagedPresetRoot } from './packaged-presets.js';
+import { PRESET_PATCH_MODULE } from '../preset-patch.js';
+/** Upstream presets copied into the roster by id; liangshen ships in this package. */
+const UPSTREAM_PRESET_IDS = ['standard', 'ptc', 'minimal', 'cordis'];
 function declarativePresets(ctx) {
     const service = ctx.get('agentPresets');
     return service !== null && typeof service === 'object'
@@ -25,6 +28,49 @@ function readPresetPatch(path) {
     }
     throw new Error(`dsh-tui: invalid upstream preset declaration: ${path}`);
 }
+/** Preset id → row id → replacement config, from preset-patch rows (src/preset-patch.ts). */
+function presetPatches(ctx, loader) {
+    const patches = new Map();
+    for (const entry of loader?.entries() ?? []) {
+        if (entry.disabled || entry.options.name !== PRESET_PATCH_MODULE)
+            continue;
+        const config = entry.options.config;
+        const rows = config?.config;
+        if (typeof config?.preset !== 'string' || rows === null || typeof rows !== 'object' || Array.isArray(rows)) {
+            ctx.logger.warn('dsh-tui: ignoring a preset-patch row without `preset` and a `config` map');
+            continue;
+        }
+        const target = patches.get(config.preset) ?? new Map();
+        for (const [id, value] of Object.entries(rows))
+            target.set(id, value);
+        patches.set(config.preset, target);
+    }
+    return patches;
+}
+/** Copy an entry list with the named rows' `config` replaced, nested groups included. */
+function withRowConfigs(rows, configs, matched) {
+    return rows.map((row) => {
+        const entry = row;
+        if (typeof entry.id === 'string' && configs.has(entry.id)) {
+            matched.add(entry.id);
+            return { ...row, config: configs.get(entry.id) };
+        }
+        if (entry.group === true && Array.isArray(entry.config))
+            return { ...row, config: withRowConfigs(entry.config, configs, matched) };
+        return row;
+    });
+}
+function patchDefinition(ctx, definition, configs) {
+    if (configs === undefined)
+        return definition;
+    const matched = new Set();
+    const plugins = withRowConfigs(definition.plugins, configs, matched);
+    for (const id of configs.keys()) {
+        if (!matched.has(id))
+            ctx.logger.warn(`dsh-tui: preset-patch row "${id}" not found in preset "${definition.id}"`);
+    }
+    return { ...definition, plugins };
+}
 /**
  * 0.1.7 removed directory discovery. Consume the official bundle definitions
  * through its registry, without copying or reimplementing their tool sets.
@@ -51,13 +97,14 @@ export async function registerBundledPresets(ctx) {
             declared.add(config.id);
         }
     }
+    const patches = presetPatches(ctx, loader);
     const require = createRequire(ctx.baseUrl ?? import.meta.url);
-    for (const id of ['standard', 'ptc', 'minimal', 'cordis']) {
+    for (const id of UPSTREAM_PRESET_IDS) {
         if (declared.has(id))
             continue;
         const path = require.resolve(`@deepseek-ai/dsh-web-app/presets/${id}.patch.yml`);
         const owner = ctx.extend({ baseUrl: pathToFileURL(path).href });
-        const dispose = await declarativePresets(owner).register(readPresetPatch(path));
+        const dispose = await declarativePresets(owner).register(patchDefinition(ctx, readPresetPatch(path), patches.get(id)));
         ctx.effect(() => dispose);
     }
     if (!declared.has('liangshen')) {
@@ -71,10 +118,20 @@ export async function registerBundledPresets(ctx) {
             plugins: [{
                     id: 'liangshen-plugins',
                     name: '@deepseek-ai/cordis-plugin-include',
-                    config: { path: pathToFileURL(join(root, 'agent.cordis.yml')).href },
+                    config: {
+                        path: pathToFileURL(join(root, 'agent.cordis.yml')).href,
+                        patches: [...patches.get('liangshen') ?? []].map(([id, config]) => ({ id, config })),
+                    },
                 }],
         });
         ctx.effect(() => dispose);
     }
+    // A typo in `preset` would otherwise be a silent no-op (row ids warn inside
+    // patchDefinition). Profile-declared presets are the profile's own seats.
+    for (const preset of patches.keys()) {
+        if (preset === 'liangshen' || UPSTREAM_PRESET_IDS.includes(preset) || declared.has(preset))
+            continue;
+        ctx.logger.warn(`dsh-tui: preset-patch row names a preset dsh-tui does not register: "${preset}"`);
+    }
     return true;
 }

package/lib/types/dsh-adapter/channel/binding-events.d.ts

@@ -32,6 +32,7 @@ export declare function createBindingEvents(ctx: Context, deps: {
      *  session needs one baseline read to show its occupancy before the next
      *  request reports usage. */
     seedContextOccupancy?(session: unknown): void;
+    seedTeam?(session: unknown): void;
     inputConvergence: InputConvergence;
     modelSelection: ReturnType<typeof createModelSelection>;
     modelActions: {

package/lib/types/dsh-adapter/channel/binding-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"binding-events.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/binding-events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"binding-events.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/binding-events.ts"],"names":[],"mappings":"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"}

package/lib/types/dsh-adapter/channel/binding-events.js

@@ -99,6 +99,7 @@ export function createBindingEvents(ctx, deps) {
         onBind({ capture, current, register }) {
             deps.seedActivity?.(deps.binding.agent.session);
             deps.seedContextOccupancy?.(deps.binding.agent.session);
+            deps.seedTeam?.(deps.binding.agent.session);
             deps.modelSelection.bind(deps.binding.agent, { provider: deps.state.provider, model: deps.state.model });
             const selected = deps.modelSelection.selection.current;
             // A parked turn may not have logged its first selected request yet.

package/lib/types/dsh-adapter/channel/command-completions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-completions.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/command-completions.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAK1G,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,KAAK,EAAE,MAAM,YAAY,CAAA;IACzB,SAAS,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAA;IACjD,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,qBAAqB,EAAE,CAAA;KAAE,CAAA;IACtF,iBAAiB,IAAI,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACnG;4EACwE;IACxE,UAAU,CAAC,IAAI,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IAC5C,yEAAyE;IACzE,MAAM,CAAC,EAAE;QACP,eAAe,IAAI,IAAI,CAAA;QACvB,WAAW,IAAI,SAAS,qBAAqB,EAAE,CAAA;KAChD,CAAA;IACD,KAAK,EAAE;QACL,cAAc,IAAI,IAAI,CAAA;QACtB,UAAU,IAAI,SAAS,qBAAqB,EAAE,CAAA;QAC9C,iBAAiB,IAAI,IAAI,CAAA;QACzB,aAAa,IAAI,SAAS;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,OAAO,CAAA;SAAE,EAAE,CAAA;QACpG,gBAAgB,IAAI,IAAI,CAAA;KACzB,CAAA;CACF,IAES,OAAO,MAAM,qDAsHtB"}
+{"version":3,"file":"command-completions.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/command-completions.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAM1G,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAmC9C,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,KAAK,EAAE,MAAM,YAAY,CAAA;IACzB,SAAS,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAA;IACjD,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,qBAAqB,EAAE,CAAA;KAAE,CAAA;IACtF,iBAAiB,IAAI,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACnG;4EACwE;IACxE,UAAU,CAAC,IAAI,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IAC5C,yEAAyE;IACzE,MAAM,CAAC,EAAE;QACP,eAAe,IAAI,IAAI,CAAA;QACvB,WAAW,IAAI,SAAS,qBAAqB,EAAE,CAAA;KAChD,CAAA;IACD,KAAK,EAAE;QACL,cAAc,IAAI,IAAI,CAAA;QACtB,UAAU,IAAI,SAAS,qBAAqB,EAAE,CAAA;QAC9C,iBAAiB,IAAI,IAAI,CAAA;QACzB,aAAa,IAAI,SAAS;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,OAAO,CAAA;SAAE,EAAE,CAAA;QACpG,gBAAgB,IAAI,IAAI,CAAA;KACzB,CAAA;CACF,IAES,OAAO,MAAM,qDAiJtB"}

package/lib/types/dsh-adapter/channel/command-completions.js

@@ -1,10 +1,38 @@
 import { completeCommands, isCommandCompletionToken } from '../../commands.js';
 import { getSidePanelPanels, parseSidePanelIds } from '../../tuiDisplayPrefs.js';
 import { SESSION_COLOR_NAMES } from '../../terminal-utils/sessionColors.js';
-import { getLang, LANGS } from '../../i18n.js';
+import { getLang, LANGS, t } from '../../i18n.js';
+import { PERMISSION_PRESET_AUTO, permissionPresetKeys } from '../../permissionPresetLabels.js';
 import { AUTO_THEME_NAME } from '../../theme.js';
 import { listThemeCatalog } from '../../themeCatalog.js';
 import { PRESET_NAMES } from '../../components/activityFrames.js';
+/**
+ * What a `/plugin install | info` spec may name — the same three shapes the
+ * README lists, in the same order. A path and a git URL cannot be enumerated,
+ * and `info` also takes a spec for a bundle that is not installed yet, so these
+ * are shown as example rows rather than discovered candidates.
+ */
+const PLUGIN_SPEC_EXAMPLES = [
+    { spec: '/path/to/repo', description: 'Example: a local directory', descriptionKey: 'sugg-plugin-spec-path-desc' },
+    { spec: 'https://github.com/exam/ple.git', description: 'Example: a git URL', descriptionKey: 'sugg-plugin-spec-git-desc' },
+    { spec: '@scope/package@1.2.3', description: 'Example: a registry package, @version pins it', descriptionKey: 'sugg-plugin-spec-package-desc' },
+];
+/**
+ * The spec shapes as completion rows for one `/plugin` form. They carry
+ * `example` (`CommandCompletionNode`): Tab hands the draft back untouched and
+ * Enter submits the draft as typed — the bare subcommand at the empty argument
+ * position (its usage line), and the typed spec once there is one. A placeholder
+ * spec can therefore neither be written into the draft nor installed by picking
+ * its row, and a real spec that only starts like one is not swallowed.
+ */
+function pluginSpecExamples() {
+    return PLUGIN_SPEC_EXAMPLES.map(shape => ({
+        name: shape.spec,
+        description: shape.description,
+        descriptionKey: shape.descriptionKey,
+        example: true,
+    }));
+}
 /** Owns slash completion composition and cache warming; it has no lifecycle effects. */
 export function createCommandCompletions(deps) {
     const { themeHost, commandTrees, workspaceCommands, model } = deps;
@@ -58,6 +86,12 @@ export function createCommandCompletions(deps) {
                 model.warmPresetOptions();
                 return [{ name: 'status', description: 'Show the current agent preset', descriptionKey: 'sugg-status-desc' }, ...model.presetOptions().map(preset => ({ name: preset.id, description: preset.description ?? preset.name ?? preset.id, ...(preset.id === state.agentPreset ? { tag: 'current' } : preset.isDefault ? { tag: 'default' } : {}) }))];
             }
+            if (path.length === 1 && path[0] === 'team')
+                return [
+                    { name: 'status', description: 'Show the team mode state', descriptionKey: 'sugg-status-desc' },
+                    { name: 'on', description: 'Switch Agent Teams on', descriptionKey: 'sugg-team-on-desc' },
+                    { name: 'off', description: 'Switch Agent Teams off', descriptionKey: 'sugg-team-off-desc' },
+                ];
             if (path.length === 1 && path[0] === 'activity')
                 return [
                     { name: 'status', description: 'Show the current activity preset', descriptionKey: 'sugg-status-desc' },
@@ -81,11 +115,16 @@ export function createCommandCompletions(deps) {
             if (path.length === 1 && path[0] === 'permission') {
                 const snapshot = state.permissionPresets();
                 if (snapshot.options.length > 0) {
-                    return snapshot.options.filter(option => isCommandCompletionToken(option.value)).map(option => ({
-                        name: option.value, description: option.description ?? option.name,
-                        ...(option.value === 'read-only' ? { descriptionKey: 'permission-preset-readonly-desc' } : option.value === 'workspace-write' ? { descriptionKey: 'permission-preset-workspace-write-desc' } : option.value === 'danger-full-access' ? { descriptionKey: 'permission-preset-full-access-desc' } : {}),
-                        ...(snapshot.current?.kind === 'preset' && snapshot.current.value === option.value ? { tag: 'current' } : {}),
-                    }));
+                    return snapshot.options.filter(option => isCommandCompletionToken(option.value)).map((option) => {
+                        const keys = permissionPresetKeys(option);
+                        return {
+                            name: option.value, description: option.description ?? option.name,
+                            ...(keys === undefined ? {} : { descriptionKey: keys.description }),
+                            ...(snapshot.current?.kind === 'preset' && snapshot.current.value === option.value
+                                ? { tag: 'current' }
+                                : option.value === PERMISSION_PRESET_AUTO ? { tag: t('permission-preset-exp-tag') } : {}),
+                        };
+                    });
                 }
                 // No preset roster (a non-DSH backend): the typed `modes` capability
                 // is the roster. DSH sessions declare no such capability, so this
@@ -134,13 +173,31 @@ export function createCommandCompletions(deps) {
                 return [
                     { name: 'list', description: 'List the plugins this profile added', descriptionKey: 'sugg-plugin-list-desc' },
                     { name: 'info', description: 'Describe an installed plugin or an install spec', descriptionKey: 'sugg-plugin-info-desc' },
+                    { name: 'install', description: 'Install a plugin bundle into this profile', descriptionKey: 'sugg-plugin-install-desc' },
+                    { name: 'remove', description: 'Uninstall a plugin bundle from this profile', descriptionKey: 'sugg-plugin-remove-desc' },
+                    { name: 'disable', description: 'Switch a plugin bundle or row off', descriptionKey: 'sugg-plugin-disable-desc' },
+                    { name: 'enable', description: 'Switch a plugin bundle or row back on', descriptionKey: 'sugg-plugin-enable-desc' },
                     { name: 'registries', description: 'Show where installations ask', descriptionKey: 'sugg-plugin-registries-desc' },
                     { name: 'check', description: 'Validate a plugin manifest without installing it', descriptionKey: 'sugg-plugin-check-desc' },
                 ];
-            if (path.length === 2 && path[0] === 'plugin' && path[1] === 'info') {
+            // `/plugin install <spec>` takes a spec nothing local can enumerate, so
+            // its argument position shows the shapes it accepts (`pluginSpecExamples`).
+            if (path.length === 2 && path[0] === 'plugin' && path[1] === 'install')
+                return pluginSpecExamples();
+            // The three lifecycle forms take the same installed list as `info`: what
+            // they act on is what the profile holds, and an absent service answers an
+            // empty list rather than a throw.
+            if (path.length === 2 && path[0] === 'plugin'
+                && (path[1] === 'remove' || path[1] === 'enable' || path[1] === 'disable')) {
                 deps.plugin?.warmPluginNames();
                 return deps.plugin?.pluginNames() ?? [];
             }
+            // `info` reads an installed bundle OR a spec about to be installed, so it
+            // offers both: what the profile holds first, then the spec shapes.
+            if (path.length === 2 && path[0] === 'plugin' && path[1] === 'info') {
+                deps.plugin?.warmPluginNames();
+                return [...(deps.plugin?.pluginNames() ?? []), ...pluginSpecExamples()];
+            }
             return commandTrees?.children(path) ?? [];
         });
     };

package/lib/types/dsh-adapter/channel/compaction.d.ts

@@ -2,9 +2,12 @@ import type { Agent } from '@deepseek-ai/dsh-agent';
 import type { Context } from '@deepseek-ai/cordis';
 import type { ChannelOwner } from './owner.js';
 import type { ChannelState } from './types.js';
-type CompactionState = Pick<ChannelState, 'agentId' | 'cwd' | 'working' | 'compaction' | 'emit'>;
+type CompactionState = Pick<ChannelState, 'agentId' | 'cwd' | 'working' | 'compaction' | 'emit' | 'emitStream'>;
 type Notify = ChannelState['notify'];
-/** Owns the one manual compaction transaction that must settle before a switch. */
+/** One manual compaction transaction per live agent, including agents parked
+ * by `/bg`. `settle` aborts the transaction of the FOREGROUND binding — the
+ * session a switch is leaving — so returning to a compacting background session
+ * keeps it running while navigating to a different one still settles it. */
 export declare function createManualCompaction(ctx: Context, state: CompactionState, deps: {
     owner: Pick<ChannelOwner, 'current' | 'signal' | 'own'>;
     agent(): Agent;
@@ -14,6 +17,8 @@ export declare function createManualCompaction(ctx: Context, state: CompactionSt
     compact: () => void;
     settle: () => Promise<void>;
     cancel: () => void;
+    restore: () => void;
+    ownsProgress: () => boolean;
 };
 export {};
 //# sourceMappingURL=compaction.d.ts.map

package/lib/types/dsh-adapter/channel/compaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAO9C,KAAK,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,CAAC,CAAA;AAChG,KAAK,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AAEpC,mFAAmF;AACnF,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE;IACJ,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC,CAAA;IACvD,KAAK,IAAI,KAAK,CAAA;IACd,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACrE,MAAM,EAAE,MAAM,CAAA;CACf;mBA0BmB,IAAI;kBAlBC,OAAO,CAAC,IAAI,CAAC;kBA4HnB,IAAI;EAQxB"}
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAS9C,KAAK,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,YAAY,CAAC,CAAA;AAC/G,KAAK,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AAEpC;;;4EAG4E;AAC5E,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE;IACJ,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC,CAAA;IACvD,KAAK,IAAI,KAAK,CAAA;IACd,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACrE,MAAM,EAAE,MAAM,CAAA;CACf;mBAkCmB,IAAI;kBAnBC,OAAO,CAAC,IAAI,CAAC;kBAuKnB,IAAI;mBAQH,IAAI;;EAQzB"}