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

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

@@ -1,41 +1,78 @@
 /** Non-DSH backend loading, detection and startup session ownership. */
 import type { Context } from '@deepseek-ai/cordis';
-import type { AgentBackend, BackendHost, OpenTarget, SdkInstallTarget, SdkInstaller } from '../agent/backend.js';
+import type { AgentBackend, BackendHost, OpenTarget, SdkInstallSurface } from '../agent/backend.js';
 import type { AgentEvent } from '../agent/events.js';
 import type { AgentSession } from '../agent/session.js';
 import type { KernelStatus } from '../components/kernelCatalog.js';
-/** Close an already-loaded backend's pooled processes without loading it on DSH. */
-export declare function closeBackendResources(): Promise<void>;
-export declare const BACKEND_LOADERS: {
-    claude: () => Promise<AgentBackend>;
-    codex: () => Promise<AgentBackend>;
-};
-/** The kernel picker's one-click SDK install surface (Chat consumes it as
- *  props; the types are the neutral ones from agent/backend.js). */
-export declare const sdkInstall: {
-    resolveTarget: () => SdkInstallTarget;
-    start: (dir: string) => SdkInstaller;
-    checkPnpm: () => Promise<boolean>;
-    pinned: {
-        readonly specifier: "@anthropic-ai/claude-agent-sdk@0.3.287";
-        readonly version: "0.3.287";
-    };
-};
-/** All probes and sessions share one credential source per provider. */
-export declare function createBackendHost(ctx: Context, cwd: string, stderr: (line: string) => void): Promise<BackendHost>;
-/** Resume failures abort boot; history is read before the channel's first paint. */
-export declare function openBackendStartup(ctx: Context, backend: AgentBackend, input: {
+/**
+ * The install surface of one registered backend (Stage B / B-1): the manifest's
+ * recipe with the actions of the executor that recipe names. Undefined when the
+ * entry declares no recipe, is not registered, or names an executor this host
+ * does not implement — all three are "no install surface", which the picker
+ * renders as the dim row's dead-end reason.
+ *
+ * The manifest says **what** (specifier + pin) and **which executor**; nothing
+ * here imports a backend, and nothing is resolved before the user picks a row:
+ * the entry behind that row is the one whose recipe gets run (§6 item 12).
+ *
+ * The id is a plain `string` on purpose, exactly like `getBackend`: membership is
+ * half of what this answers, so asking about an id that was never registered is a
+ * question with an answer, not a type error.
+ */
+export declare function installSurfaceFor(id: string): SdkInstallSurface | undefined;
+/**
+ * The host services of one backend. Built per backend (not once for all of
+ * them) because `dataDir` is backend-scoped: `<DATA_DIR>/backends/<id>` is the
+ * only place a backend has any business writing, and the id is what names it.
+ *
+ * `locale` is a live read, not a snapshot: `/lang` switches the whole UI at
+ * runtime, and a backend's own text follows it string by string (B-3). The
+ * language union is restated by `getLang()`'s own return type, so a new
+ * shipped language fails to compile here until the domain contract knows it.
+ */
+export declare function createBackendHost(ctx: Context, backendId: string, cwd: string, stderr: (line: string) => void): Promise<BackendHost>;
+/**
+ * What the channel needs about the startup backend before its session exists,
+ * plus `start()`, which opens it (mount claim, open, history); the screen
+ * mounts in between.
+ * A resume failure rejects `start()`; no fresh session is started instead.
+ */
+export declare function prepareBackendStartup(ctx: Context, backend: AgentBackend, input: {
     readonly cwd: string;
     readonly stderr: (line: string) => void;
     readonly configuredSessionId?: string;
     readonly argv: readonly string[];
 }): Promise<{
-    session: AgentSession;
+    resumedSessionId: string | undefined;
     label: string;
     backendId: string;
+    catalog: import("../agent/backend.js").SessionCatalog | undefined;
+    sessionPrefs: import("../agent/backend.js").BackendSessionPrefs;
+    start: () => Promise<{
+        session: AgentSession;
+        initialHistory: readonly AgentEvent[];
+    }>;
+    persisted: (_sessionId: string, rows: readonly {
+        readonly kind: string;
+    }[]) => boolean;
+    resumeCommand: (sessionId: string) => string;
+    open: (target: Extract<OpenTarget, {
+        readonly kind: "create" | "resume";
+    }>) => Promise<AgentSession>;
+}>;
+/** Resume failures abort boot; history is read before the channel's first paint. */
+export declare function openBackendStartup(ctx: Context, backend: AgentBackend, input: Parameters<typeof prepareBackendStartup>[2]): Promise<{
+    session: AgentSession;
     initialHistory: readonly AgentEvent[];
+    resumedSessionId: string | undefined;
+    label: string;
+    backendId: string;
     catalog: import("../agent/backend.js").SessionCatalog | undefined;
     sessionPrefs: import("../agent/backend.js").BackendSessionPrefs;
+    start: () => Promise<{
+        session: AgentSession;
+        initialHistory: readonly AgentEvent[];
+    }>;
     persisted: (_sessionId: string, rows: readonly {
         readonly kind: string;
     }[]) => boolean;
@@ -44,6 +81,12 @@ export declare function openBackendStartup(ctx: Context, backend: AgentBackend,
         readonly kind: "create" | "resume";
     }>) => Promise<AgentSession>;
 }>;
-/** Probe optional backends lazily; failed loading leaves their row unavailable. */
+/**
+ * Probe every optional backend once (`dsh` is always available and has no
+ * loader). Loading goes through the registry, so a probed backend's pool hook is
+ * booked just like an opened one's — a backend that builds its pool in `detect()`
+ * (the contract does not forbid it) is then still closed at exit. Failures leave
+ * their row unavailable instead of failing the probe.
+ */
 export declare function probeKernels(ctx: Context, cwd: string): Promise<Record<string, KernelStatus>>;
 //# sourceMappingURL=backends.d.ts.map

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;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAyB,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvI,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;AAclE,oFAAoF;AACpF,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3D;AAED,eAAO,MAAM,eAAe;;;CAMoD,CAAA;AAEhF;oEACoE;AACpE,eAAO,MAAM,UAAU;yBACF,gBAAgB;iBACtB,MAAM,KAAG,YAAY;qBACnB,OAAO,CAAC,OAAO,CAAC;;;;;CAEhC,CAAA;AAID,wEAAwE;AACxE,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAiBvH;AAED,oFAAoF;AACpF,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE;IACnF,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;;;;;;;4BAgD2B,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,mFAAmF;AACnF,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAYnG"}
+{"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.generated.d.ts

@@ -0,0 +1,12 @@
+/**
+ * GENERATED by scripts/gen-backend-index.mjs — do not edit.
+ * 2 backend manifest(s) in directory-name order (picker order):
+ * claude, codex.
+ *
+ * `pnpm compile` refreshes this file: commit the result. It is checked in
+ * because the CI test groups restore the build artifact instead of compiling, and
+ * the registry imports it from `src/` (see the generator for the whole story).
+ */
+import type { BackendEntry } from '../agent/backend-manifest.js';
+export declare const GENERATED_BACKENDS: readonly BackendEntry[];
+//# sourceMappingURL=backends.generated.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backends.generated.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/backends.generated.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAIhE,eAAO,MAAM,kBAAkB,EAAE,SAAS,YAAY,EAGrD,CAAA"}

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

@@ -0,0 +1,6 @@
+import { manifest as claudeManifest } from '../backends/claude/manifest.js';
+import { manifest as codexManifest } from '../backends/codex/manifest.js';
+export const GENERATED_BACKENDS = [
+    { manifest: claudeManifest, load: () => import('../backends/claude/index.js') },
+    { manifest: codexManifest, load: () => import('../backends/codex/index.js') },
+];

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

@@ -1,40 +1,62 @@
 import { formatSessionRef } from '../agent/refs.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';
-// Static on purpose: the install module imports no vendor package (node
-// built-ins + update.ts, which this adapter loads anyway), so a DSH-only
-// boot pays nothing for having the wizard's surface at hand.
-import { checkPnpmAvailable, CLAUDE_SDK_SPECIFIER, resolveSdkInstallTarget, startClaudeSdkInstall } from '../backends/claude/install.js';
-import { VALIDATED_SDK_VERSION } from '../backends/claude/contract.js';
+import { backendDataDir } from '../utils/paths.js';
+import { installExecutor } from './install/executors.js';
 import { fileChannelTokens } from '../backends/shared/channel-tokens.js';
-let closeCodexHubs;
-/** Close an already-loaded backend's pooled processes without loading it on DSH. */
-export async function closeBackendResources() {
-    await closeCodexHubs?.();
+/**
+ * The install surface of one registered backend (Stage B / B-1): the manifest's
+ * recipe with the actions of the executor that recipe names. Undefined when the
+ * entry declares no recipe, is not registered, or names an executor this host
+ * does not implement — all three are "no install surface", which the picker
+ * renders as the dim row's dead-end reason.
+ *
+ * The manifest says **what** (specifier + pin) and **which executor**; nothing
+ * here imports a backend, and nothing is resolved before the user picks a row:
+ * the entry behind that row is the one whose recipe gets run (§6 item 12).
+ *
+ * The id is a plain `string` on purpose, exactly like `getBackend`: membership is
+ * half of what this answers, so asking about an id that was never registered is a
+ * question with an answer, not a type error.
+ */
+export function installSurfaceFor(id) {
+    const recipe = getBackend(id)?.manifest.install;
+    if (recipe === undefined)
+        return undefined;
+    const executor = installExecutor(recipe.executor);
+    if (executor === undefined)
+        return undefined;
+    return {
+        ...recipe,
+        resolveTarget: () => executor.resolveTarget(),
+        start: (dir) => executor.start(recipe.specifier, dir),
+        preflight: () => executor.preflight(),
+    };
 }
-export const BACKEND_LOADERS = {
-    claude: () => import('../backends/claude/index.js').then(m => m.claudeBackend),
-    codex: () => import('../backends/codex/index.js').then(m => {
-        closeCodexHubs = m.closeAllCodexHubs;
-        return m.codexBackend;
-    }),
-};
-/** The kernel picker's one-click SDK install surface (Chat consumes it as
- *  props; the types are the neutral ones from agent/backend.js). */
-export const sdkInstall = {
-    resolveTarget: () => resolveSdkInstallTarget(),
-    start: (dir) => startClaudeSdkInstall(dir),
-    checkPnpm: () => checkPnpmAvailable(),
-    pinned: { specifier: CLAUDE_SDK_SPECIFIER, version: VALIDATED_SDK_VERSION },
-};
 const credentialSources = new Map();
-/** All probes and sessions share one credential source per provider. */
-export async function createBackendHost(ctx, cwd, stderr) {
+/**
+ * The host services of one backend. Built per backend (not once for all of
+ * them) because `dataDir` is backend-scoped: `<DATA_DIR>/backends/<id>` is the
+ * only place a backend has any business writing, and the id is what names it.
+ *
+ * `locale` is a live read, not a snapshot: `/lang` switches the whole UI at
+ * runtime, and a backend's own text follows it string by string (B-3). The
+ * language union is restated by `getLang()`'s own return type, so a new
+ * shipped language fails to compile here until the domain contract knows it.
+ */
+export async function createBackendHost(ctx, backendId, cwd, stderr) {
     const { createOAuthCredentialSource } = await import('./oauth-credential-source.js');
+    const appVersion = installedTuiVersion();
     return {
         cwd,
+        dataDir: backendDataDir(backendId),
+        locale: () => getLang(),
+        ...(appVersion === undefined ? {} : { appVersion }),
         debug: message => logForDebugging(message),
         warn: message => ctx.logger.warn(message),
         stderr,
@@ -49,26 +71,37 @@ export async function createBackendHost(ctx, cwd, stderr) {
         },
     };
 }
-/** Resume failures abort boot; history is read before the channel's first paint. */
-export async function openBackendStartup(ctx, backend, input) {
+/**
+ * What the channel needs about the startup backend before its session exists,
+ * plus `start()`, which opens it (mount claim, open, history); the screen
+ * mounts in between.
+ * A resume failure rejects `start()`; no fresh session is started instead.
+ */
+export async function prepareBackendStartup(ctx, backend, input) {
     const launch = backend.launch;
     if (launch === undefined)
         throw new Error(`dsh-tui: backend "${backend.id}" does not support startup`);
-    const host = await createBackendHost(ctx, input.cwd, input.stderr);
-    const prefs = launch.sessionPrefs(host.debug);
+    const host = await createBackendHost(ctx, backend.id, input.cwd, input.stderr);
+    const prefs = launch.sessionPrefs(host);
     const requested = (input.configuredSessionId ?? resumeTargetFromArgv(input.argv, () => prefs.lastSession()))?.trim();
     const resumeId = requested === undefined || requested === ''
         ? undefined
         : requested.startsWith(`${backend.id}:`) ? requested.slice(backend.id.length + 1) : requested;
-    let session;
-    let initialHistory = [];
-    if (resumeId !== undefined) {
+    const start = async () => {
+        if (resumeId === undefined) {
+            const session = await backend.open({ kind: 'create', cwd: input.cwd }, host);
+            const { reservation } = await reserveNewSession(formatSessionRef(session.ref));
+            reservation.settle();
+            return { session, initialHistory: [] };
+        }
         const key = formatSessionRef({ backendId: backend.id, sessionId: resumeId });
         const reserved = await reserveMount(key);
         if (!reserved.ok) {
             throw new Error(`dsh-tui: cannot resume ${backend.descriptor.label} session "${resumeId}": ${mountFailureText(reserved)} — ` +
                 'two processes driving one session would interleave its transcript. Close that terminal, or drop --resume to start a fresh session.');
         }
+        let session;
+        let initialHistory;
         try {
             session = await backend.open({ kind: 'resume', sessionId: resumeId }, host);
             try {
@@ -88,36 +121,48 @@ export async function openBackendStartup(ctx, backend, input) {
         reserved.reservation.settle();
         prefs.setLastSession(resumeId);
         prefs.touch(resumeId);
-    }
-    else {
-        session = await backend.open({ kind: 'create', cwd: input.cwd }, host);
-        const { reservation } = await reserveNewSession(formatSessionRef(session.ref));
-        reservation.settle();
-    }
+        return { session, initialHistory };
+    };
     return {
-        session,
+        // Boot and landing-page state use the target this backend actually opened.
+        resumedSessionId: resumeId,
         label: backend.descriptor.label,
         backendId: backend.id,
-        initialHistory,
         catalog: backend.catalog,
         sessionPrefs: prefs,
+        start,
         // A submitted user row means the backend has persisted a resumable transcript.
         persisted: (_sessionId, rows) => rows.some(row => row.kind === 'user'),
         resumeCommand: (sessionId) => launch.resumeCommand(sessionId),
         open: (target) => backend.open(target, target.kind === 'create' ? { ...host, cwd: target.cwd } : host),
     };
 }
-/** Probe optional backends lazily; failed loading leaves their row unavailable. */
+/** Resume failures abort boot; history is read before the channel's first paint. */
+export async function openBackendStartup(ctx, backend, input) {
+    const prepared = await prepareBackendStartup(ctx, backend, input);
+    return { ...prepared, ...await prepared.start() };
+}
+/**
+ * Probe every optional backend once (`dsh` is always available and has no
+ * loader). Loading goes through the registry, so a probed backend's pool hook is
+ * booked just like an opened one's — a backend that builds its pool in `detect()`
+ * (the contract does not forbid it) is then still closed at exit. Failures leave
+ * their row unavailable instead of failing the probe.
+ */
 export async function probeKernels(ctx, cwd) {
-    const host = await createBackendHost(ctx, cwd, () => undefined);
     const statuses = {};
-    for (const [id, load] of Object.entries(BACKEND_LOADERS)) {
+    for (const entry of listOfferedBackends()) {
+        if (entry.load === undefined)
+            continue;
+        // One host per entry: `dataDir` is backend-scoped, and a probe must not
+        // hand a backend a directory that is not its own.
+        const host = await createBackendHost(ctx, entry.id, cwd, () => undefined);
         try {
-            statuses[id] = await (await load()).detect(host);
+            statuses[entry.id] = await (await loadBackend(entry.id)).detect(host);
         }
         catch (error) {
             host.debug('dsh-tui: kernel probe failed (' + (error instanceof Error ? error.message : String(error)) + ')');
-            statuses[id] = { installed: false };
+            statuses[entry.id] = { installed: false };
         }
     }
     return statuses;

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/action-readiness.d.ts

@@ -14,6 +14,8 @@ export type ChannelActionMethods = Pick<ChannelState, ChannelActionMethodName>;
 export declare function createChannelActionMethods(getReadyActions: () => ChannelActionDelegates): ChannelActionMethods;
 export declare function createChannelActionReadiness(): {
     install(next: ChannelActionDelegates): void;
+    /** Replace the installed table (the adoption-window extension, core/compose.ts). */
+    reinstall(next: ChannelActionDelegates): void;
     getReadyActions(): ChannelActionDelegates;
 };
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"action-readiness.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/action-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,YAAY,EAClD,oBAAoB,GACpB,WAAW,GACX,UAAU,GACV,cAAc,GACd,aAAa,GACb,UAAU,GACV,YAAY,GACZ,gBAAgB,GAChB,uBAAuB,GACvB,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,qBAAqB,GACrB,aAAa,GACb,aAAa,GACb,WAAW,GACX,kBAAkB,GAClB,WAAW,GACX,qBAAqB,GACrB,OAAO,GACP,mBAAmB,GACnB,aAAa,GACb,cAAc,GACd,YAAY,GACZ,eAAe,GACf,2BAA2B,GAC3B,YAAY,GACZ,oBAAoB,GACpB,aAAa,GACb,cAAc,GACd,oBAAoB,GACpB,WAAW,GACX,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAChB,oBAAoB,GACpB,qBAAqB,GACrB,sBAAsB,GACtB,mBAAmB,GACnB,eAAe,GACf,oBAAoB,GACpB,yBAAyB,GACzB,qBAAqB,GACrB,eAAe,GACf,kBAAkB,GAClB,cAAc,GACd,mBAAmB,GACnB,iBAAiB,GACjB,eAAe,GACf,iBAAiB,GACjB,aAAa,GACb,eAAe,GACf,iBAAiB,GACjB,SAAS,GACT,eAAe,GACf,oBAAoB,GACpB,2BAA2B,GAC3B,WAAW,GACX,WAAW,GACX,eAAe,GACf,eAAe,GACf,YAAY,GACZ,aAAa,GACb,eAAe,CAClB,GAAG;IACF,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3E,CAAA;AAED,KAAK,uBAAuB,GAAG,OAAO,CAAC,MAAM,sBAAsB,EAAE,iBAAiB,CAAC,CAAA;AACvF,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAA;AAE9E;4EAC4E;AAC5E,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,sBAAsB,GAC5C,oBAAoB,CAyEtB;AAED,wBAAgB,4BAA4B;kBAG1B,sBAAsB,GAAG,IAAI;uBAIxB,sBAAsB;EAK5C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EACnC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,GAC3C,sBAAsB,CA2FxB"}
+{"version":3,"file":"action-readiness.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/action-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,YAAY,EAClD,oBAAoB,GACpB,WAAW,GACX,UAAU,GACV,cAAc,GACd,aAAa,GACb,UAAU,GACV,YAAY,GACZ,gBAAgB,GAChB,uBAAuB,GACvB,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,qBAAqB,GACrB,aAAa,GACb,aAAa,GACb,WAAW,GACX,kBAAkB,GAClB,WAAW,GACX,qBAAqB,GACrB,OAAO,GACP,mBAAmB,GACnB,aAAa,GACb,cAAc,GACd,YAAY,GACZ,eAAe,GACf,2BAA2B,GAC3B,YAAY,GACZ,oBAAoB,GACpB,aAAa,GACb,cAAc,GACd,oBAAoB,GACpB,WAAW,GACX,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAChB,oBAAoB,GACpB,qBAAqB,GACrB,sBAAsB,GACtB,mBAAmB,GACnB,eAAe,GACf,oBAAoB,GACpB,yBAAyB,GACzB,qBAAqB,GACrB,eAAe,GACf,kBAAkB,GAClB,cAAc,GACd,mBAAmB,GACnB,iBAAiB,GACjB,eAAe,GACf,iBAAiB,GACjB,aAAa,GACb,eAAe,GACf,iBAAiB,GACjB,SAAS,GACT,eAAe,GACf,oBAAoB,GACpB,2BAA2B,GAC3B,WAAW,GACX,WAAW,GACX,eAAe,GACf,eAAe,GACf,YAAY,GACZ,aAAa,GACb,eAAe,CAClB,GAAG;IACF,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3E,CAAA;AAED,KAAK,uBAAuB,GAAG,OAAO,CAAC,MAAM,sBAAsB,EAAE,iBAAiB,CAAC,CAAA;AACvF,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAA;AAE9E;4EAC4E;AAC5E,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,sBAAsB,GAC5C,oBAAoB,CAyEtB;AAED,wBAAgB,4BAA4B;kBAG1B,sBAAsB,GAAG,IAAI;IAI3C,oFAAoF;oBACpE,sBAAsB,GAAG,IAAI;uBAI1B,sBAAsB;EAK5C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EACnC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,GAC3C,sBAAsB,CA2FxB"}

package/lib/types/dsh-adapter/channel/action-readiness.js

@@ -22,7 +22,7 @@ export function createChannelActionMethods(getReadyActions) {
         workspaceCommands: () => getReadyActions().workspaceCommands(),
         runWorkspaceCommand: (name, input) => getReadyActions().runWorkspaceCommand(name, input),
         switchModel: (provider, model) => getReadyActions().switchModel(provider, model),
-        listEfforts: () => getReadyActions().listEfforts(),
+        listEfforts: route => getReadyActions().listEfforts(route),
         setEffort: id => getReadyActions().setEffort(id),
         setDefaultEffort: id => getReadyActions().setDefaultEffort(id),
         cycleMode: () => getReadyActions().cycleMode(),
@@ -65,7 +65,7 @@ export function createChannelActionMethods(getReadyActions) {
         cancelCompact: () => getReadyActions().cancelCompact(),
         runExternalCommand: (name, rawInput) => getReadyActions().runExternalCommand(name, rawInput),
         runExternalCommandOutcome: (name, rawInput, images) => getReadyActions().runExternalCommandOutcome(name, rawInput, images),
-        pushLocal: (title, lines) => getReadyActions().pushLocal(title, lines),
+        pushLocal: (title, lines, options) => getReadyActions().pushLocal(title, lines, options),
         mcpStatus: () => getReadyActions().mcpStatus(),
         exportSession: () => getReadyActions().exportSession(),
         initWorkspace: () => getReadyActions().initWorkspace(),
@@ -82,6 +82,12 @@ export function createChannelActionReadiness() {
                 throw new Error('dsh-tui: Channel actions are already installed');
             delegates = Object.freeze(next);
         },
+        /** Replace the installed table (the adoption-window extension, core/compose.ts). */
+        reinstall(next) {
+            if (delegates === undefined)
+                throw new Error('dsh-tui: Channel actions are not installed');
+            delegates = Object.freeze(next);
+        },
         getReadyActions() {
             if (delegates === undefined)
                 throw new Error('dsh-tui: Channel actions are not installed');
@@ -192,7 +198,7 @@ export function createUnavailableActionDelegates(unavailable, unavailableLines)
         exportSession: () => refuse('export', null),
         initWorkspace: () => refuse('init', null),
         doctorInfo: () => unavailableLines('doctor'),
-        pluginsInfo: () => unavailableLines('plugins'),
+        pluginsInfo: () => Promise.resolve(unavailableLines('plugin')),
         listSubagents: () => Promise.resolve(unavailableLines('agents')),
     };
 }

package/lib/types/dsh-adapter/channel/agent-view-projection.js

@@ -3,7 +3,7 @@ import { SessionId } from '@deepseek-ai/dsh-session';
 import { randomUUID } from 'node:crypto';
 import { resolveModelRoute, validateModelRoute } from '../../modelRoute.js';
 import { readModelPref } from '../../modelPrefs.js';
-import { readPresetPref } from '../../presetPrefs.js';
+import { presetOverrideFromEnv, readPresetPref } from '../../presetPrefs.js';
 import { forgetAgentViewSession, readAgentViewSessions, touchAgentViewSession, touchSession } from '../../sessionHistory.js';
 import { t } from '../../i18n.js';
 import { AGENT_VIEW_STATUS_ORDER, agentViewLivePreview, agentViewStatusOf, foldAgentViewEvents, oneLine, sessionTitleFallback, } from '../agent-view.js';
@@ -141,7 +141,7 @@ export function createAgentViewProjection(ctx, deps) {
         let detached;
         try {
             deps.owner.assertActive();
-            const composed = await composePreset(ctx, deps.configuredPreset ?? readPresetPref());
+            const composed = await composePreset(ctx, presetOverrideFromEnv() ?? readPresetPref() ?? deps.configuredPreset);
             const resolved = resolveModelRoute({ provider: deps.configuredProvider, model: deps.configuredModel }, readModelPref(), { provider: deps.provider, model: deps.model });
             const llm = ctx.get('llm');
             const { route } = await validateModelRoute(llm, resolved, { provider: deps.provider, model: deps.model });

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

@@ -1 +1 @@
-{"version":3,"file":"background-action.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/background-action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,wBAAwB,CAAA;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAalD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEhE,KAAK,OAAO,GAAG,iBAAiB,CAAA;AAEhC;iFACiF;AACjF,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,IAAI,CAAC,YAAY,EACtB,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,eAAe,GAAG,eAAe,GAC9E,cAAc,GAAG,iBAAiB,GAAG,MAAM,GAAG,QAAQ,CAAC,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,EACxG,OAAO,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAC9H,IAAI,EAAE;IACJ,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAA;IACpC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,CAAA;IACjF,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IAC3C,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACzB,cAAc,IAAI,IAAI,CAAA;IACtB,cAAc,IAAI,IAAI,CAAA;IACtB,aAAa,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;IAChD,SAAS,IAAI,IAAI,CAAA;IACjB,mBAAmB,IAAI,IAAI,CAAA;IAC3B,SAAS,IAAI,IAAI,CAAA;IACjB,eAAe,IAAI,IAAI,CAAA;IACvB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,iBAAiB,IAAI,IAAI,CAAA;IACzB,qBAAqB,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7F,4EAA4E;IAC5E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAA;IAC5F,eAAe,IAAI,IAAI,CAAA;CACxB,GACA,MAAM,OAAO,CAAC,gBAAgB,CAAC,CA2FjC"}
+{"version":3,"file":"background-action.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/background-action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,wBAAwB,CAAA;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAclD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEhE,KAAK,OAAO,GAAG,iBAAiB,CAAA;AAEhC;iFACiF;AACjF,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,IAAI,CAAC,YAAY,EACtB,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,eAAe,GAAG,eAAe,GAC9E,cAAc,GAAG,iBAAiB,GAAG,MAAM,GAAG,QAAQ,CAAC,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,EACxG,OAAO,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAC9H,IAAI,EAAE;IACJ,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAA;IACpC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,CAAA;IACjF,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IAC3C,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACzB,cAAc,IAAI,IAAI,CAAA;IACtB,cAAc,IAAI,IAAI,CAAA;IACtB,aAAa,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;IAChD,SAAS,IAAI,IAAI,CAAA;IACjB,mBAAmB,IAAI,IAAI,CAAA;IAC3B,SAAS,IAAI,IAAI,CAAA;IACjB,eAAe,IAAI,IAAI,CAAA;IACvB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,iBAAiB,IAAI,IAAI,CAAA;IACzB,qBAAqB,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7F,4EAA4E;IAC5E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAA;IAC5F,eAAe,IAAI,IAAI,CAAA;CACxB,GACA,MAAM,OAAO,CAAC,gBAAgB,CAAC,CA+FjC"}

package/lib/types/dsh-adapter/channel/background-action.js

@@ -2,12 +2,13 @@ import { SessionId } from '@deepseek-ai/dsh-session';
 import { randomUUID } from 'node:crypto';
 import { resolveModelRoute, validateModelRoute } from '../../modelRoute.js';
 import { readModelPref } from '../../modelPrefs.js';
-import { readPresetPref } from '../../presetPrefs.js';
+import { presetOverrideFromEnv, readPresetPref } from '../../presetPrefs.js';
 import { clearResumeTarget, touchAgentViewSession, touchSession } from '../../sessionHistory.js';
 import { t } from '../../i18n.js';
 import { reserveMount } from '../../sessionMounts.js';
 import { mountFailureText } from '../../sessions/resumeFailure.js';
 import { composePreset } from '../presets.js';
+import { createFreshAgent } from '../fresh-agent.js';
 import { createDshSession, dshHandleOf } from '../backend/session.js';
 import { attachSessionToWorkspace } from '../workspace.js';
 import { resetSessionProjection } from './session-reset.js';
@@ -30,9 +31,13 @@ export function createBackgroundCurrentAction(ctx, state, options, deps) {
             deps.notify(mountFailureText(reserved), { color: 'warning', timeoutMs: 8000 });
         const reservation = reserved.ok ? reserved.reservation : { settle: () => { }, abandon: () => { } };
         try {
-            const composed = await composePreset(ctx, options.configuredPreset ?? readPresetPref());
+            const composed = await composePreset(ctx, presetOverrideFromEnv() ?? readPresetPref() ?? options.configuredPreset);
             const route = await validateModelRoute(ctx.get('llm'), resolveModelRoute({ provider: options.configuredProvider, model: options.configuredModel }, readModelPref(), { provider: options.provider, model: options.model }), { provider: options.provider, model: options.model });
-            const candidate = await deps.binding.prepare(adoption, async () => createDshSession(ctx, await agents.create({
+            // `/bg` starts an unseeded session nobody has typed into yet, so it
+            // shares the fresh-session gate: creation-time checkpoints (the
+            // projection cache flushes on `session/created`) must not publish the
+            // permission-only shell before the first real event.
+            const candidate = await deps.binding.prepare(adoption, async () => createDshSession(ctx, await createFreshAgent(ctx, agents, {
                 sessionId,
                 meta: { cwd: state.cwd, ...(composed.agentPreset === undefined ? {} : { agentPreset: composed.agentPreset }) },
                 agentOptions: route.route,

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

@@ -1,10 +1,11 @@
-import type { Agent, AssistantStreamFrame, ModelSelectionRef } from '@deepseek-ai/dsh-agent';
+import type { Agent, AssistantStreamFrame } from '@deepseek-ai/dsh-agent';
 import type { Context } from '@deepseek-ai/cordis';
 import type { ChannelProjection } from '../../channel/projection.js';
 import { type BindingScope } from './core/binding-feed.js';
 import type { InputConvergence } from './input-actions.js';
 import type { DshChannelBinding } from './binding.js';
 import type { ChannelOwner } from './owner.js';
+import type { createModelSelection } from './model-selection.js';
 import type { ChannelState } from './types.js';
 /**
  * Foreground transcript listeners capture a binding generation: the bound
@@ -31,15 +32,18 @@ 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;
-    selection: ModelSelectionRef;
+    modelSelection: ReturnType<typeof createModelSelection>;
     modelActions: {
         applyPreferredEffort(): Promise<void>;
-        selection: ModelSelectionRef;
     };
     modeActions: {
         refreshMode(): void;
         onSessionEvent(session: unknown, event: unknown): void;
+        /** Seed an untouched session with the persisted permission preference
+         *  (permissionPrefs.ts); fire-and-forget on bind, never rejects. */
+        applyRememberedPermission(): Promise<void>;
     };
     projector: ChannelProjection;
     subagents: {
@@ -59,12 +63,22 @@ export declare function createBindingEvents(ctx: Context, deps: {
         }, parent: object | null): void;
         forget?(agent: Agent): void;
     };
+    /** The job projection's own raw-event half: it times the card hold a tool
+     *  call puts on the job it registers (see channel/job-projection.ts). */
+    jobs?: {
+        onSessionEvent(event: unknown): void;
+    };
     agentView: {
         schedule(): void;
     };
     messageObserver?: {
         publish(session: unknown, event: unknown): void;
     };
+    /** Seed the upstream auto-retry policy (upstream-retry.ts) for the
+     *  provider route this session actually uses; fire-and-forget on bind,
+     *  never rejects, never blocks. Optional for direct/embed constructors
+     *  that bring no settings seam. */
+    seedUpstreamRetry?(provider: string | undefined): void;
     /** Drop a pre-step attachment registered by this channel for one message id
      *  (input-delivery's `retireAttachment`); see the discard hook below.
      *  Optional for direct/embed constructors that never emit inbox discards;