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

package/lib/types/dsh-adapter/host-entry.js

@@ -0,0 +1,253 @@
+/**
+ * This package's own entry (docs/standalone-host-design.md), started by
+ * bin/dsh-tui.js for every kernel: take over the installed dsh's root and
+ * module resolution before any TUI module loads, mount the runtime on it, then
+ * compose the dsh-tui profile (DSH) or the light profile (other kernels). A DSH
+ * launch without a usable installed dsh is handed to `dsh --profile` unchanged.
+ */
+import '../force-production-react.js';
+import { spawn } from 'node:child_process';
+import { markBoot } from '../utils/bootTrace.js';
+import { configuredBackend, delegatesToProfile, entryKernel, hostProfile } from '../hostEntryRoute.js';
+import { HANDOFF_ACK_FD_ENV } from '../handoffAck.js';
+import { HOST_NOTICE_ENV } from '../kernelPrefs.js';
+import { logForDebugging } from '../utils/debug.js';
+import { cmdEscapeArgument } from '../utils/shellQuote.js';
+import { ENTRY_ROW_DEFAULTS } from './lite-profile.js';
+import { HostComposeError, loadHostDsh, NO_DSH_ON_PATH, prepareHostRoot } from './host-dsh.js';
+import { installEntrySignals } from './process-exit.js';
+import { disposeRootSettled, trackComposition } from './root-dispose.js';
+markBoot('entry-start');
+// DSH's native flock loader reads `process.report.getReport()`; with sockets
+// already open, the network section's reverse lookups block the event loop.
+if (process.report !== undefined)
+    process.report.excludeNetwork = true;
+const profile = hostProfile();
+const configured = configuredBackend(profile);
+// A `!!js` backend is evaluated only by the profile's Loader: that launch
+// keeps the full `dsh --profile` path, which honours the evaluated row.
+if (delegatesToProfile(configured))
+    delegateToDsh();
+else
+    await runInEntry(entryKernel(process.env, { configured }));
+/** bin/dsh-tui.js `MSG.noDsh`, newline-terminated. */
+function noDshGuidance() {
+    return process.env.DSH_TUI_LANG === 'en'
+        ? '[dsh-tui] dsh CLI not found. Install the official client first:\n  npm install -g @deepseek-ai/dsh\n'
+        : '[dsh-tui] 未检测到 dsh CLI。请先安装官方客户端：\n  npm install -g @deepseek-ai/dsh\n';
+}
+function delegateToDsh() {
+    const appArgs = process.argv.slice(2);
+    const args = ['--profile', profile, ...(appArgs.length > 0 ? ['--', ...appArgs] : [])];
+    // A kernel-switch replacement's ACK pipe (fd 3) goes to dsh, which adopts the screen.
+    const ack = process.env[HANDOFF_ACK_FD_ENV] === '3';
+    const windows = process.platform === 'win32';
+    // cmd.exe joins the arguments unescaped, and `dsh` is an npm `.cmd` shim that
+    // parses the line again: quote, then caret-escape metacharacters twice, so a
+    // prompt with `&`, `|`, `<` or `>` stays one argument.
+    const child = spawn('dsh', windows ? args.map(arg => cmdEscapeArgument(arg, true)) : args, {
+        stdio: ack ? ['inherit', 'inherit', 'inherit', 3] : 'inherit',
+        env: process.env,
+        ...(windows ? { shell: true } : {}),
+    });
+    // The terminal's own signals reach dsh through the process group; one sent
+    // to this pid alone is passed on (SIGINT only by the group: Ctrl+C would
+    // otherwise reach dsh twice).
+    const forwarders = new Map([
+        ['SIGTERM', () => { child.kill('SIGTERM'); }],
+        ['SIGHUP', () => { child.kill('SIGHUP'); }],
+        ['SIGINT', () => undefined],
+    ]);
+    for (const [signal, forward] of forwarders)
+        process.on(signal, forward);
+    child.on('error', error => {
+        process.stderr.write(`dsh-tui: cannot start dsh (${error.message})\n`);
+        if (error.code === 'ENOENT')
+            process.stderr.write(noDshGuidance());
+        process.exit(1);
+    });
+    child.on('exit', (code, signal) => {
+        if (signal === null) {
+            process.exit(code ?? 0);
+            return;
+        }
+        // Mirror a signal death: the forwarders above would catch (and swallow)
+        // the re-raised signal, ending this process with 0 instead.
+        for (const [name, forward] of forwarders)
+            process.removeListener(name, forward);
+        process.kill(process.pid, signal);
+    });
+}
+/**
+ * Runs before anything renders, so the stderr line stays above the next
+ * screen (skipped for a kernel-switch replacement, which draws without a
+ * gap); the screen also gets it as a notice (HOST_NOTICE_ENV, read once).
+ */
+function noteHostUnavailable(kernel, error) {
+    const reason = (error instanceof Error ? error.message : String(error)).split('\n')[0] ?? '';
+    const fallback = kernel === 'dsh' ? 'starting DSH through `dsh --profile`' : 'starting without its module resolution';
+    const line = `dsh-tui: the installed dsh cannot host this launch (${reason}); ${fallback}`;
+    logForDebugging(line);
+    if (process.env[HANDOFF_ACK_FD_ENV] === undefined && process.env.DSH_TUI_RESTART_CHILD !== '1')
+        process.stderr.write(`${line}\n`);
+    process.env[HOST_NOTICE_ENV] = reason;
+}
+/**
+ * Fallback when the funnel is not up (or refused): also close what the
+ * funnel's teardown closes — the codex hub pool is process-wide and no
+ * session's dispose closes it. Dynamic import keeps backends off the entry's
+ * load surface.
+ */
+async function disposeEntryRoot(ctx) {
+    try {
+        await disposeRootSettled(ctx);
+    }
+    finally {
+        try {
+            const { unloadBackends } = await import('./backend-registry.js');
+            await unloadBackends();
+        }
+        catch (error) {
+            logForDebugging(`dsh-tui: closing backend resources on the entry's exit path failed (${error instanceof Error ? error.message : String(error)})`);
+        }
+    }
+}
+async function runInEntry(kernelBeforeHost) {
+    // Without a usable dsh, DSH delegates to `dsh --profile`; the other kernels
+    // run on this package's own cordis. This pre-mount answer is only for the two
+    // failure paths below. The root starts neutral: its final composition mode is
+    // selected only after the Loader can assemble third-party backends.
+    let root;
+    const exitSeam = {};
+    try {
+        root = await prepareHostRoot(await loadHostDsh(), { profile, args: process.argv.slice(2), exitSeam });
+        markBoot('entry-hijacked');
+    }
+    catch (error) {
+        markBoot('entry-host-unavailable');
+        // No dsh at all: stop with the install guidance rather than delegate into
+        // a spawn failure (on Windows `shell: true` hides the ENOENT).
+        if (kernelBeforeHost === 'dsh' && error instanceof Error && error.message === NO_DSH_ON_PATH) {
+            process.stderr.write(noDshGuidance());
+            process.exit(1);
+        }
+        noteHostUnavailable(kernelBeforeHost, error);
+        if (kernelBeforeHost === 'dsh') {
+            delegateToDsh();
+            return;
+        }
+    }
+    const [{ Config }, { apply, handleStartupError }, { assembleBackendsFromProfile }, { createEntrySlot }, { deferRootCapabilityGuard, armRootCapabilityGuard }, { processGuardActive }, { logRestartEvent }] = await Promise.all([
+        import('./index.js'),
+        import('./plugin.js'),
+        import('./backend-assembly.js'),
+        import('./entry-slot.js'),
+        import('./host-access.js'),
+        import('../ink/update-overflow-guard.js'),
+        import('../update.js'),
+    ]);
+    markBoot('entry-modules');
+    const ctx = root?.ctx ?? new (await import('@deepseek-ai/cordis')).Context();
+    const env = process.env;
+    // D-1: this entry decides the kernel *before* `apply` runs, and that decision is
+    // registry membership — `entryKernel` drops an id no backend answers for, and a
+    // third-party bundle's backend is only registered by the assembly below. So the
+    // installed bundles are assembled here first, on the mounted root's Loader, and
+    // the route is re-decided afterwards. `apply` assembles again; the pass is a
+    // no-op the second time. Without a host root there is no Loader and no profile to
+    // read: the assembly says so and registers nothing.
+    assembleBackendsFromProfile(ctx);
+    const kernel = entryKernel(env, { configured: configuredBackend(profile) });
+    try {
+        await root?.selectKernel(kernel === 'dsh');
+    }
+    catch (error) {
+        if (kernel === 'dsh') {
+            noteHostUnavailable(kernel, error);
+            delegateToDsh();
+            return;
+        }
+        handleStartupError(ctx, error);
+        return;
+    }
+    // cordis.patch.yml's dsh-tui row, rebuilt from the same environment; the
+    // editable fields come from ./tui-settings.ts on top.
+    const config = Config({
+        ...ENTRY_ROW_DEFAULTS,
+        ...(env.DSH_TUI_PRESET === undefined ? {} : { preset: env.DSH_TUI_PRESET }),
+        ...(env.DSH_TUI_WORKSPACE_TARGET === undefined ? {} : { workspace: env.DSH_TUI_WORKSPACE_TARGET }),
+        ...(env.DSH_TUI_RESUME_SESSION === undefined ? {} : { sessionId: env.DSH_TUI_RESUME_SESSION }),
+        ...(env.DSH_TUI_BACKEND === undefined ? {} : { backend: env.DSH_TUI_BACKEND }),
+    });
+    installEntrySignals({
+        seam: exitSeam,
+        disposeRoot: () => disposeEntryRoot(ctx),
+        log: logRestartEvent,
+    });
+    // Only a host root gets a composition (DSH without one was delegated above).
+    const slot = root === undefined ? undefined : createEntrySlot(kernel === 'dsh', root.kernelVersion);
+    // Plugins use root capabilities while they activate: hold the TUI's guard
+    // back until composition arms it (./host-access.ts).
+    const releaseRootGuard = slot === undefined ? undefined : deferRootCapabilityGuard(ctx);
+    try {
+        // `entryKernel`: the runtime must not re-resolve the kernel — its rebuilt Config
+        // lacks the profile patch's row this route was decided on (the entry read that
+        // row above, after the assembly registered what an installed bundle declares).
+        await apply(ctx, config, ctx, { deferBackendOpen: true, profile, entryKernel: kernel, exitSeam, ...(slot === undefined ? {} : { entrySlot: slot }) });
+    }
+    catch (error) {
+        handleStartupError(ctx, error);
+        return;
+    }
+    // One owner of a fatal error: with the TUI's process guard up, DSH's
+    // fail-loud would exit 1 before the exit funnel ran.
+    if (root !== undefined && processGuardActive())
+        root.uninstallFailLoud();
+    if (root === undefined || slot === undefined)
+        return;
+    // The "starting" frame must reach the terminal before the composition's
+    // synchronous stretch.
+    await slot.firstFrameFlushed?.();
+    markBoot('entry-compose-start');
+    armRootCapabilityGuard(ctx);
+    const loaderOf = () => ctx.get('loader');
+    const composition = trackComposition(ctx, async () => { await loaderOf()?.await(); });
+    let failure;
+    try {
+        await root.compose(line => { logForDebugging(`dsh-tui: host composition: ${line.trimEnd()}`); }, () => composition.disposing);
+    }
+    catch (error) {
+        failure = { error };
+    }
+    finally {
+        composition.done();
+        releaseRootGuard?.();
+        markBoot('entry-compose-end');
+    }
+    if (!slot.dsh) {
+        // A light-profile failure ends the process loudly: a kernel whose plugin
+        // ecosystem did not come up must not pass as a boot.
+        if (failure === undefined) {
+            slot.composeSucceeded?.();
+            return;
+        }
+        const { error } = failure;
+        handleStartupError(ctx, error instanceof HostComposeError && error.logPath !== undefined ? `${error.message} — startup report: ${error.logPath}` : error);
+        return;
+    }
+    // DSH: past the mount nothing writes to the terminal; a failure lands in the screen.
+    if (failure !== undefined) {
+        const { error } = failure;
+        if (error instanceof HostComposeError)
+            slot.composeFailed?.(error.original, error.logPath);
+        else
+            slot.composeFailed?.(error);
+        return;
+    }
+    if (composition.disposing)
+        return;
+    if (!slot.rowSeen)
+        slot.composeFailed?.(new Error(`the ${profile} profile has no dsh-tui row`));
+    else
+        slot.composeSucceeded?.();
+}

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

@@ -9,6 +9,7 @@
 import type { Context } from '@deepseek-ai/cordis';
 import Schema from '@deepseek-ai/schemastery';
 import type { SessionModeSpec } from '../sessionModes.js';
+import type { NotificationMethod, TaskNotifications } from '../ink/terminal-notification.js';
 import { type KernelBackendId } from '../kernelPrefs.js';
 import { type CodeFrameStyle, type ImageBacking, type MathImageBacking, type MathImageScale, type MathRendering, type PageMarginSetting, type ScrollGutterMode, type StatusBarConfig, type ToolBackground } from '../tuiDisplayPrefs.js';
 import { type ShortcutActionId } from '../utils/keymap.js';
@@ -29,14 +30,24 @@ export interface Config {
      *  the local Claude CLI through the Claude Agent SDK (optional peer
      *  `@anthropic-ai/claude-agent-sdk`); `codex`, the experimental Codex
      *  backend driving the user's own `codex` CLI over `codex app-server`.
-     *  `dsh-tui --backend <id>` sets it through `DSH_TUI_BACKEND`. */
-    backend?: KernelBackendId;
-    /** LLM provider route. The route resolves atomically (issue #67): when
-     *  cordis.yml names BOTH `provider` and `model`, that pair wins; otherwise
-     *  the `/model` choice persisted in `~/.dsh-tui/model.json` wins whole;
-     *  otherwise `agentDefaultModel` supplies the provider-neutral Harness
-     *  default. A bare embedder without that service falls back to DeepSeek.
-     *  A provider-only pin never half-overrides the persisted choice. */
+     *  `dsh-tui --backend <id>` sets it through `DSH_TUI_BACKEND`.
+     *
+     *  A plain `string` on purpose: this is the **input** surface, so an embedder
+     *  writing `{ backend: 'codex' }` keeps compiling. The schema normalizes syntax;
+     *  the boot checks registry membership after assembling installed bundles.
+     *  The `BackendId` brand stays inside the package, where it guards session
+     *  refs and `~/.dsh-tui/backends/<id>/` paths. Declaring the
+     *  branded `KernelBackendId` here breaks published consumers instead
+     *  (PR #1380 review R1). */
+    backend?: string;
+    /** LLM provider route. The route resolves atomically (issue #67): the
+     *  `/model` choice persisted in `~/.dsh-tui/model.json` — the route the
+     *  last session ran — wins whole; otherwise a `provider`+`model` pair named
+     *  here is the deployment DEFAULT; otherwise `agentDefaultModel` supplies
+     *  the provider-neutral Harness default. A bare embedder without that
+     *  service falls back to DeepSeek. A half-pinned pair (only one of the two
+     *  keys) is ignored outright and never half-overrides the persisted
+     *  choice. */
     provider?: string;
     /** Model override passed to the agent; resolved together with `provider`
      *  as one atomic route (see `provider`). */
@@ -50,11 +61,13 @@ export interface Config {
     workspace?: string;
     /** Reasoning effort applied to every request, validated against the live
      *  route's adapter levels (an unlisted level is ignored and the adapter
-     *  default applies). Wins over the persisted /effort choice; also seeds
-     *  the startup status line until the first request header reports the
-     *  live value. */
+     *  default applies). This is the deployment DEFAULT beneath the persisted
+     *  `/effort` choice (the level the last session ran); it also seeds the
+     *  startup status line until the first request header reports the live
+     *  value. */
     effort?: string;
-    /** Settings default for future sessions; overrides the `effort` fallback. */
+    /** Settings user-layer default for future sessions; when set it outranks
+     *  both the persisted `/effort` choice and the `effort` fallback. */
     effortDefault?: string;
     /** Show the header whale and its idle animation. */
     whale?: boolean;
@@ -93,13 +106,20 @@ export interface Config {
      *  /settings choices override this value after restart. The environment
      *  override DSH_TUI_DISABLE_TERMINAL_IMAGES can always force previews off. */
     terminalImages?: boolean;
+    /** Launchpad landing page (settings `dsh-tui.launchpad`): an ordinary
+     *  launch (no --resume, no first prompt) starts on the launchpad — the
+     *  page where the first sentence gets typed. On by default; `false` boots
+     *  straight into the chat page. Saved /settings choices override this
+     *  value after restart; DSH_TUI_NO_LAUNCHPAD=1 skips it regardless. */
+    launchpad?: boolean;
     /** UI language: `en` / `zh`. When absent, the `DSH_TUI_LANG` env var wins,
      *  then the `/lang` choice persisted in `~/.dsh-tui/lang.json`, then `zh`. */
     lang?: string;
     /** Agent preset id new sessions compose from (standard/ptc/minimal/
-     *  cordis/… when the roster is mounted). When absent, the `/preset` choice
-     *  persisted in `~/.dsh-tui/agent-preset.json` wins, then the roster
-     *  default (`standard`). */
+     *  cordis/… when the roster is mounted). A `DSH_TUI_PRESET` launch
+     *  instruction outranks everything; otherwise the `/preset` choice
+     *  persisted in `~/.dsh-tui/agent-preset.json` wins, then this value as
+     *  the deployment default, then the roster default (`standard`). */
     preset?: string;
     /** Edit/Write diff presentation: `auto` picks side-by-side on wide
      *  terminals (≥110 cols) and unified below; `split`/`unified` force one
@@ -150,6 +170,10 @@ export interface Config {
      *  a ~30fps reveal instead of jumping per provider burst — bursty or
      *  one-shot deliveries read as an even flow. On by default. */
     smoothStreaming?: boolean;
+    /** Successful task notifications: off, unfocused (default), or always. */
+    taskNotifications?: TaskNotifications;
+    /** Terminal notification transport: auto (default), OSC 9, or BEL. */
+    notificationMethod?: NotificationMethod;
     /** Mermaid diagrams (settings `dsh-tui.mermaidDiagrams`): ```mermaid
      *  fences in replies render as Unicode box-drawing art — flowcharts,
      *  sequence/state/class/ER diagrams, pie, mindmap, timeline, gitGraph —
@@ -240,9 +264,18 @@ export interface Config {
      *  `plan`/`sandbox`/`approval` atoms; absent → the built-in
      *  default/plan/full cycle (see sessionModes.ts). */
     modes?: SessionModeSpec[];
+    /** Upstream auto-retry for DSH sessions (default on): seed a retry
+     *  policy (5 attempts, transport-drop-aware failure codes) on the
+     *  llm-pi-ai provider route the bound session actually uses whenever
+     *  it declares no retryPolicy, through the llm-pi-ai settings section
+     *  — the policy the kernel's llm-retry plugin executes. Dormant
+     *  channels are never written; routes with an explicit retryPolicy are
+     *  never overwritten; setting this to false opts out entirely. */
+    upstreamRetry?: boolean;
 }
-/** The backend a configured value names: case-insensitive, trimmed;
- *  empty or unknown → undefined (the DSH default). */
+/** The complete two-stage parse: syntax, then registry membership (P0 D1).
+ *  Empty, malformed or unregistered values mean "not configured". Unlike the
+ *  syntax-only Config schema, this helper requires discovery to have run. */
 export declare function normalizeBackendChoice(value: unknown): KernelBackendId | undefined;
 export declare const Config: Schema<Config, RuntimeConfig<Config>>;
 /**
@@ -253,4 +286,7 @@ export declare const Config: Schema<Config, RuntimeConfig<Config>>;
  * @returns a promise settling when the Loader entry has scheduled its runtime.
  */
 export declare function apply(ctx: Context, config: RuntimeConfig<Config>): Promise<void>;
+export { BACKEND, BACKEND_CAPABILITY_NAMES, BACKEND_RESERVED_IDS, validateBackendSpec, type BackendInstallRecipe, type BackendSpec, } from '../adapter/spec/tui-contributions.js';
+export { backendAdmission, type BackendAdmission, type BackendAdmissionHost } from './backend-admission.js';
+export { backendContributionOf } from './backend-contribution.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAE5F,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,EAAkR,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACxf,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC5E,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAC1F,OAAO,EAAyB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACzE,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAIzE,eAAO,MAAM,IAAI,YAAY,CAAA;AAU7B,eAAO,MAAM,MAAM,UAAa,CAAA;AAEhC;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;;;;;;;;gCAa4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;;;kBAOc;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;gDAC4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;gFAE4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;oCACgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;iBAKa;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;yEACqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;wDAGoD;IACpD,UAAU,CAAC,EAAE,iBAAiB,CAAA;IAC9B;;uEAEmE;IACnE,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,kEAAkE;IAClE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;2BAGuB;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;wDAEoD;IACpD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;+DAI2D;IAC3D,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;kFAE8E;IAC9E,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;2EAIuE;IACvE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;kFAC8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;wEAIoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;6DAEyD;IACzD,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IACzC;;8EAE0E;IAC1E,YAAY,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACjC;;;;uEAImE;IACnE,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;IAC1C,sEAAsE;IACtE,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B;;2CAEuC;IACvC,YAAY,CAAC,EAAE,gBAAgB,CAAA;IAC/B;;;;iEAI6D;IAC7D,UAAU,CAAC,EAAE,iBAAiB,CAAA;IAC9B;;;0CAGsC;IACtC,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B;;;kEAG8D;IAC9D,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;mEAC+D;IAC/D,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B;;;kDAG8C;IAC9C,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;mEAG+D;IAC/D,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,sEAAsE;IACtE,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC;;;;;sDAKkD;IAClD,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;;6DAKyD;IACzD,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B;;;;;gFAK4E;IAC5E,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;;+CAI2C;IAC3C,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B;;0EAEsE;IACtE,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC;;4EAEwE;IACxE,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;iFAE6E;IAC7E,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAA;IACpC;;;mEAG+D;IAC/D,SAAS,CAAC,EAAE;QACV;6DACqD;QACrD,YAAY,CAAC,EAAE,OAAO,CAAA;QACtB;4EACoE;QACpE,IAAI,CAAC,EAAE,OAAO,CAAA;QACd;6EACqE;QACrE,KAAK,CAAC,EAAE,MAAM,CAAA;QACd;;6EAEqE;QACrE,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;IACD;qBACiB;IACjB,SAAS,CAAC,EAAE;QACV;oEAC4D;QAC5D,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD;;wEAEoE;IACpE,GAAG,CAAC,EAAE;QACJ,yEAAyE;QACzE,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB;2EACmE;QACnE,aAAa,CAAC,EAAE,MAAM,CAAA;KACvB,CAAA;IACD;;;;sCAIkC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAA;IACrD;;;yDAGqD;IACrD,KAAK,CAAC,EAAE,eAAe,EAAE,CAAA;IACzB;;;;;;sEAMkE;IAClE,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;6EAE6E;AAC7E,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAElF;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CA+JH,CAAA;AAEtD;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BtF;AAkCD,OAAO,EACL,OAAO,EACP,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,WAAW,GACjB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC3G,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA"}

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

@@ -1,11 +1,13 @@
 import Schema from '@deepseek-ai/schemastery';
-import { isKernelId } from '../kernelPrefs.js';
+import { parseBackendChoice } from './backend-registry.js';
+import { parseBackendId } from '../kernelPrefs.js';
 import { BTW_CONTEXT_BUDGET_DEFAULT, BTW_CONTEXT_TURNS_DEFAULT, DEFAULT_COMPANION_SKIN, DEFAULT_SIDE_PANEL_IDS, DEFAULT_STATUS_BAR, normalizeBtwContextBudget, normalizeBtwContextTurns, normalizeCompanionSkin, normalizePageMargin, normalizeSidePanelPanels, normalizeSidePanelRatio } from '../tuiDisplayPrefs.js';
 import { SHORTCUT_ACTIONS } from '../utils/keymap.js';
 import { normalizeSplashFont } from '../components/splashFonts.js';
 import { normalizeBrandSetting } from '../branding.js';
 import { editableConfig } from './compat/settings.js';
 import { EDITABLE_CONFIG_KEYS } from '../settings/definitions.js';
+import { peekEntrySlot, takeEntryAttach } from './entry-slot.js';
 export const name = 'dsh-tui';
 // `tuiWorkspaces` must stay OUT of this code-level inject (issue #183): the
 // dsh CLI resolves the bundle's cordis.patch.yml from the FIRST copy of this
@@ -17,20 +19,20 @@ export const name = 'dsh-tui';
 // row-level inject purely as an ordering guarantee when the row exists; when
 // it does not, plugin.ts/channel.ts fall back to a local workspace runtime.
 export const inject = ['agents'];
-/** The backend a configured value names: case-insensitive, trimmed;
- *  empty or unknown → undefined (the DSH default). */
+/** The complete two-stage parse: syntax, then registry membership (P0 D1).
+ *  Empty, malformed or unregistered values mean "not configured". Unlike the
+ *  syntax-only Config schema, this helper requires discovery to have run. */
 export function normalizeBackendChoice(value) {
-    if (typeof value !== 'string')
-        return undefined;
-    const id = value.trim().toLowerCase();
-    return isKernelId(id) ? id : undefined;
+    return parseBackendChoice(value);
 }
 export const Config = editableConfig(Schema.object({
     sessionId: Schema.string().required(false),
     // A transform, not a union: the row reads `DSH_TUI_BACKEND`, and a stray
     // export (`Claude`, a typo) must not fail the whole boot — case and blanks
-    // are normalized and anything unknown means the default (plugin.ts warns).
-    backend: Schema.transform(Schema.string(), value => normalizeBackendChoice(value)),
+    // are normalized here and the id-shape gate drops junk. Cordis validates
+    // before `apply` assembles installed backends: membership must wait until
+    // after that discovery, or a third-party Config choice is erased.
+    backend: Schema.transform(Schema.string(), value => parseBackendId(value)),
     // No schema defaults on the route: a `.default()` here would make an
     // unset key indistinguishable from an explicit cordis.yml choice and the
     // persisted `/model` preference could never win (issue #30). The defaults
@@ -61,6 +63,10 @@ export const Config = editableConfig(Schema.object({
     contextBar: Schema.boolean().default(true),
     fullscreen: Schema.boolean().default(true),
     terminalImages: Schema.boolean().default(true),
+    // No `.default()` on purpose (same rule as recapOnOpen): an unset key must
+    // stay distinguishable from an explicit `false`, and the boot reads
+    // undefined as on (`config.launchpad !== false`).
+    launchpad: Schema.boolean(),
     lang: Schema.string().required(false),
     preset: Schema.string().required(false),
     diffLayout: Schema.union(['auto', 'split', 'unified']).default('auto'),
@@ -77,6 +83,8 @@ export const Config = editableConfig(Schema.object({
     promptSessionLabel: Schema.boolean().default(false),
     expandEditor: Schema.boolean().default(true),
     smoothStreaming: Schema.boolean().default(true),
+    taskNotifications: Schema.union(['off', 'unfocused', 'always']),
+    notificationMethod: Schema.union(['auto', 'osc9', 'bel']),
     mermaidDiagrams: Schema.boolean().default(true),
     codeFrameStyle: Schema.union(['light', 'full']),
     mathRendering: Schema.union(['auto', 'image', 'unicode', 'source']),
@@ -145,6 +153,9 @@ export const Config = editableConfig(Schema.object({
         approval: Schema.union(['ask', 'never']).required(false),
         permission: Schema.string().required(false),
     })).required(false),
+    // Upstream auto-retry seeding (see upstream-retry.ts): on by default so
+    // an upstream link drop retries like any other transient failure.
+    upstreamRetry: Schema.boolean().default(true),
 }), EDITABLE_CONFIG_KEYS);
 /**
  * Start the interactive TUI front door, delegating to the JSX implementation
@@ -154,6 +165,14 @@ export const Config = editableConfig(Schema.object({
  * @returns a promise settling when the Loader entry has scheduled its runtime.
  */
 export async function apply(ctx, config) {
+    // The entry already mounted the screen in this process (./entry-slot.ts):
+    // the row only runs the DSH side and hands the session to that screen.
+    const entrySlot = peekEntrySlot();
+    if (entrySlot !== undefined) {
+        entrySlot.rowSeen = true;
+        attachToEntry(ctx, config);
+        return;
+    }
     // Upstream drift is NO LONGER spammed to stderr here: per-package
     // console.warn lines interleave with the TUI frame redraw and arrive
     // garbled (typewriter animation repaints over them). The merged,
@@ -179,3 +198,38 @@ export async function apply(ctx, config) {
             handleStartupError(ctx, error);
     });
 }
+/** The row under the entry's screen: the DSH side in its own runtime fiber
+ *  once the Loader settled, never a second render; a recompose stays idle. */
+function attachToEntry(ctx, config) {
+    const attach = takeEntryAttach();
+    if (attach === undefined) {
+        ctx.logger.warn('dsh-tui: the entry\'s screen already holds a DSH session; this dsh-tui row stays idle');
+        return;
+    }
+    let disposed = false;
+    ctx.effect(() => () => { disposed = true; });
+    const loader = ctx.get('loader');
+    void (loader?.await() ?? ctx.fiber.await()).then(() => {
+        if (disposed)
+            return;
+        return ctx.plugin({
+            name: 'dsh-tui-runtime',
+            apply: (runtimeCtx) => attach(runtimeCtx, config, ctx),
+        });
+    }).catch((error) => {
+        ctx.logger.error(`dsh-tui: the DSH side failed to start under the entry's screen: ${error instanceof Error ? error.message : String(error)}`);
+    });
+}
+// ── The Backend contribution family (B-2) ─────────────────────────────────────
+// `alpha`, and deliberately narrow: the *declaration* shape, its validator, the
+// admission verdict and the projection this package uses for its own manifests.
+// A third-party author writes a declaration by hand against exactly this surface
+// (scripts/verify-public-config-types.mjs compiles a real consumer file against
+// the published declarations), and from here on it may only grow — removing any
+// of it is a breaking change. What is NOT here: the registry, the loader and the
+// picker. Those stay the host's, and the stage C install chain is where a mounted
+// bundle's declaration reaches them (the admission chain itself is wired; see
+// docs/plugins.md).
+export { BACKEND, BACKEND_CAPABILITY_NAMES, BACKEND_RESERVED_IDS, validateBackendSpec, } from '../adapter/spec/tui-contributions.js';
+export { backendAdmission } from './backend-admission.js';
+export { backendContributionOf } from './backend-contribution.js';

package/lib/types/dsh-adapter/install/executors.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The host's install-executor table (roadmap Stage B / B-1, §6 item 12).
+ *
+ * Stage A locked the install surface to a **backend id** — `backend-registry.ts`
+ * kept `HOST_INSTALLABLE_BACKEND_ID = 'claude'` and `backends.ts` statically
+ * imported that one backend's installer. That held only while the host had
+ * exactly one consumer writing manifests. A manifest now names an **executor**
+ * instead, and the registry looks the name up in this table when the entry
+ * registers: the value is data any mounted bundle can be checked against
+ * (§4.4), not a static import.
+ *
+ * The table holds exactly one value today, and a recipe naming anything else is
+ * treated as **having no install surface** rather than refused (§6 item 12: the
+ * field *shape* is public, the value set is the host's). Widening it is adding an
+ * entry here; the shape does not change, which is what keeps "one more executor"
+ * a non-breaking act once the contribution family freezes (§6 item 5).
+ */
+import type { SdkInstallTarget, SdkInstaller } from '../../agent/backend.js';
+/** The one executor value this host implements: one `pnpm add` in the DSH
+ *  profile root. Named as a verb, not as a backend — a backend *declares* it. */
+export declare const PNPM_PROFILE_ADD = "pnpm-profile-add";
+/**
+ * What one executor value means: the parameterized *how* of an install, with
+ * every backend-specific *what* left to the manifest recipe that names it.
+ */
+export interface InstallExecutor {
+    /** Where this launch would install — synchronous, read-only (argv + the file
+     *  system) and never throwing. The non-profile kinds carry the reason for the
+     *  wizard's manual-instructions panel. `argv` is injectable for regressions. */
+    readonly resolveTarget: (argv?: readonly string[]) => SdkInstallTarget;
+    /** Whether the tool this executor shells out to runs at all (the wizard's
+     *  preflight, asked after the user confirmed the target). */
+    readonly preflight: () => Promise<boolean>;
+    /** Start one install of `specifier` into `dir`; cancellable, settles once. */
+    readonly start: (specifier: string, dir: string) => SdkInstaller;
+}
+/** Executor name → actions. The single source of "which recipes this host can
+ *  actually run"; everything else reads it through {@link installExecutor}. */
+export declare const INSTALL_EXECUTORS: ReadonlyMap<string, InstallExecutor>;
+/** The executor a manifest recipe names, or undefined when this host does not
+ *  implement it — which every caller reads as "no install surface", never as an
+ *  error (§6 item 12). */
+export declare function installExecutor(name: string): InstallExecutor | undefined;
+//# sourceMappingURL=executors.d.ts.map

package/lib/types/dsh-adapter/install/executors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executors.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/install/executors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAG5E;iFACiF;AACjF,eAAO,MAAM,gBAAgB,qBAAqB,CAAA;AAElD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;oFAEgF;IAChF,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,KAAK,gBAAgB,CAAA;IACtE;iEAC6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1C,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,YAAY,CAAA;CACjE;AAED;+EAC+E;AAC/E,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAEjE,CAAA;AAEF;;0BAE0B;AAC1B,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEzE"}

package/lib/types/dsh-adapter/install/executors.js

@@ -0,0 +1,15 @@
+import { pnpmProfileAdd } from './pnpm-profile-add.js';
+/** The one executor value this host implements: one `pnpm add` in the DSH
+ *  profile root. Named as a verb, not as a backend — a backend *declares* it. */
+export const PNPM_PROFILE_ADD = 'pnpm-profile-add';
+/** Executor name → actions. The single source of "which recipes this host can
+ *  actually run"; everything else reads it through {@link installExecutor}. */
+export const INSTALL_EXECUTORS = new Map([
+    [PNPM_PROFILE_ADD, pnpmProfileAdd],
+]);
+/** The executor a manifest recipe names, or undefined when this host does not
+ *  implement it — which every caller reads as "no install surface", never as an
+ *  error (§6 item 12). */
+export function installExecutor(name) {
+    return INSTALL_EXECUTORS.get(name);
+}

package/lib/types/dsh-adapter/install/pnpm-profile-add.d.ts

@@ -0,0 +1,3 @@
+import type { InstallExecutor } from './executors.js';
+export declare const pnpmProfileAdd: InstallExecutor;
+//# sourceMappingURL=pnpm-profile-add.d.ts.map

package/lib/types/dsh-adapter/install/pnpm-profile-add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnpm-profile-add.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/install/pnpm-profile-add.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AA8HrD,eAAO,MAAM,cAAc,EAAE,eAAqD,CAAA"}