@deepseek-harness-tui/dsh-tui 0.8.1 → 0.8.2

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

@@ -22,11 +22,16 @@ import { ensureLegacySessionEventTypes } from './compat/index.js';
 import { clearResumeTarget, writeResumeTarget } from '../sessionHistory.js';
 import { resolveSessionCwd } from '../utils/workspaceRoot.js';
 import { checkForTuiUpdate, installedTuiVersion, isBootDeadlockTarget, isVersionNewer, resolveDshProfileName, resolveTuiUpdateTarget, updateTuiAndRestart } from '../update.js';
-import { isLang, resolveStartupLang, setLang, t } from '../i18n.js';
+import { getLang, isLang, resolveStartupLang, setLang, t, writeLangPref } from '../i18n.js';
 import { detectLegacyEnv, migrateLegacyDataDir, RENAMED_ENV } from '../utils/paths.js';
 import { Chat } from '../screens/Chat.js';
+import { getHostDialogStore } from './dialogs.js';
+import { getHostStatusStore } from './status.js';
+import { getHostShortcuts } from './shortcuts.js';
 import { attachSessionToWorkspace } from './workspace.js';
-import { createLocalWorkspaceRuntime } from './workspaces.js';
+import { createLocalWorkspaceRuntime, getHostWorkspaceRuntime } from './workspaces.js';
+import { getHostSettingsSections } from './settings-sections.js';
+import { withHostRootCapability } from './host-access.js';
 import { render, ThemeProvider, AlternateScreen } from '../ui.js';
 import instances from '../ink/instances.js';
 import { cursorMove, DISABLE_KITTY_KEYBOARD, DISABLE_MODIFY_OTHER_KEYS, DISABLE_WIN32_INPUT_MODE } from '../ink/termio/csi.js';
@@ -66,10 +71,11 @@ export async function apply(ctx, config) {
     // already touches lang.json). Copy, not move — old launchers keep working
     // and the user deletes the legacy directory themselves.
     const migrated = migrateLegacyDataDir();
-    // UI language resolution: DSH_TUI_LANG env var wins, then cordis.yml
-    // `lang`, then the persisted `/lang` choice, then `zh`. Must settle
-    // before the first render so every module resolves strings in the same
-    // language.
+    // UI language resolution: DSH_TUI_LANG env var wins, then the
+    // settings.yaml `dsh-tui.lang` user layer (applied once the settings
+    // namespace registers below), then cordis.yml `lang`, then the
+    // persisted `/lang` choice, then `zh`. Must settle before the first
+    // render so every module resolves strings in the same language.
     const envLang = process.env.DSH_TUI_LANG;
     setLang(isLang(envLang) ? envLang : isLang(config.lang) ? config.lang : resolveStartupLang());
     // Rename notices must land before the first render — stderr writes break
@@ -211,7 +217,7 @@ export async function apply(ctx, config) {
     // without the service means the patch came from an older dsh-tui copy
     // than the running code — warn once so the skew is diagnosable. Bare
     // embedders (no --profile) take the same fallback by design, silently.
-    const mountedWorkspaceService = ctx.get('tuiWorkspaces');
+    const mountedWorkspaceService = getHostWorkspaceRuntime(ctx.get('tuiWorkspaces'));
     if (mountedWorkspaceService === undefined && resolveDshProfileName() !== undefined) {
         ctx.logger.warn('dsh-tui: tuiWorkspaces service is not mounted; /workspace runs with the local-only fallback. ' +
             'The bundle patch is older than the installed dsh-tui package — update the globally installed dsh-tui launcher to match the profile (issue #183).');
@@ -302,6 +308,7 @@ export async function apply(ctx, config) {
         // Edit/Write diff presentation (schema default 'auto'); the /settings
         // screen edits this key live through the dsh-tui namespace.
         diffLayout: config.diffLayout,
+        thinkingFold: config.thinkingFold,
         handle,
     });
     // Register the dsh-tui settings namespace so the /settings screen can
@@ -311,24 +318,69 @@ export async function apply(ctx, config) {
     ctx.inject(['settings'], (settingsCtx) => {
         const scope = settingsCtx.settings.register(settingsNamespace('dsh-tui'), Schema.object({
             diffLayout: Schema.union(['auto', 'split', 'unified']).default('auto'),
+            thinkingFold: Schema.union(['preview', 'full']).default('preview'),
+            // No default on purpose: an unset `lang` keeps the field showing
+            // the effective language (see the section's format below) and lets
+            // cordis.yml / lang.json keep their precedence.
+            lang: Schema.union(['zh', 'en']),
         }));
         const applyLayout = (value) => {
             channel.setDiffLayout(value.diffLayout ?? config.diffLayout ?? 'auto');
         };
-        applyLayout(scope.get());
-        scope.watch(next => {
+        // The /settings language field writes `lang` through the settings
+        // service (user layer): apply it live and mirror it to lang.json so
+        // the /lang command and next-boot resolution agree. DSH_TUI_LANG
+        // stays the top precedence — a pinned env is never overridden by the
+        // document.
+        const applyLang = (value) => {
+            if (!isLang(process.env.DSH_TUI_LANG) && isLang(value.lang)) {
+                setLang(value.lang);
+                writeLangPref(value.lang);
+            }
+        };
+        // thinkingFold rides the same namespace: /settings writes it live and
+        // the channel picks it up at the next step seal.
+        const applyThinkingFold = (value) => {
+            channel.setThinkingFold(value.thinkingFold ?? config.thinkingFold ?? 'preview');
+        };
+        const apply = (next) => {
             applyLayout(next);
+            applyLang(next);
+            applyThinkingFold(next);
+        };
+        apply(scope.get());
+        scope.watch(next => {
+            apply(next);
         });
     });
     // The /settings screen's own section: the dsh-tui namespace comes from
-    // this plugin's Config schema, and the declared select writes diffLayout
-    // back through the settings service's revision-fenced mutate.
-    const settingsSections = ctx.get('tuiSettingsSections');
+    // the settings registration above, and the declared selects write `lang`
+    // and `diffLayout` back through the settings service's revision-fenced
+    // mutate (the watch applies both live).
+    const settingsSections = getHostSettingsSections(ctx.get('tuiSettingsSections'));
     if (settingsSections !== undefined) {
         const unregister = settingsSections.register({
             ns: 'dsh-tui',
             title: 'dsh-tui',
             fields: [
+                {
+                    path: ['lang'],
+                    label: 'Language',
+                    descriptions: { zh: '界面语言' },
+                    hint: 'UI language for the whole interface — applies immediately and is saved.',
+                    hintDescriptions: { zh: '整个界面的显示语言——立即生效并保存。' },
+                    kind: 'select',
+                    options: [
+                        { value: 'zh', label: '中文', descriptions: { zh: '中文' } },
+                        { value: 'en', label: 'English', descriptions: { zh: '英文' } },
+                    ],
+                    format(value) {
+                        // Unset in settings.yaml: show the effective UI language
+                        // (env / cordis.yml / lang.json resolution) instead of a
+                        // blank "unset" that hides the current choice.
+                        return value === undefined || value === null ? getLang() : String(value);
+                    },
+                },
                 {
                     path: ['diffLayout'],
                     label: 'Diff layout',
@@ -342,6 +394,18 @@ export async function apply(ctx, config) {
                         { value: 'unified', label: 'Unified', descriptions: { zh: '统一式' } },
                     ],
                 },
+                {
+                    path: ['thinkingFold'],
+                    label: 'Thinking display',
+                    descriptions: { zh: '思考块展示' },
+                    hint: 'Streaming thinking shows a 2-3 line live preview and each step folds when it settles; Full keeps thinking expanded until the turn ends.',
+                    hintDescriptions: { zh: '流式时思考显示 2-3 行动态预览，每步落定后折叠；展开模式保持思考展开直到整轮结束。' },
+                    kind: 'select',
+                    options: [
+                        { value: 'preview', label: 'Preview (2-3 lines)', descriptions: { zh: '预览（2-3 行）' } },
+                        { value: 'full', label: 'Full until turn end', descriptions: { zh: '展开至轮末' } },
+                    ],
+                },
             ],
         });
         ctx.effect(() => unregister);
@@ -449,9 +513,9 @@ export async function apply(ctx, config) {
         // The dsh-tui-extensions row's services (managed dialogs, status line,
         // shortcuts). Soft-consumed: absent the row (stale patch, bare embed),
         // Chat falls back to inert stores and no shortcut registry.
-        extensionDialogs: ctx.get('tuiDialogs')?.store,
-        extensionStatus: ctx.get('tuiStatus')?.store,
-        extensionShortcuts: ctx.get('tuiShortcuts'),
+        extensionDialogs: getHostDialogStore(ctx.get('tuiDialogs')),
+        extensionStatus: getHostStatusStore(ctx.get('tuiStatus')),
+        extensionShortcuts: getHostShortcuts(ctx.get('tuiShortcuts')),
         // Full-screen surfaces inside Chat — the trajectory scene and the session
         // browser — enter the alt screen themselves in inline mode; in fullscreen
         // the tree is already wrapped below, so they must not nest.
@@ -824,7 +888,7 @@ function resumeCommand(profile, sessionId) {
 function disposeRootAndThen(ctx, done, fallbackCode = 1) {
     const timer = setTimeout(() => process.exit(fallbackCode), 5000);
     timer.unref();
-    void ctx.root.fiber.dispose().then(() => {
+    void withHostRootCapability(() => ctx.root.fiber.dispose()).then(() => {
         clearTimeout(timer);
         done();
     }, () => {

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

@@ -1,10 +1,4 @@
 import type { Context } from '@deepseek-ai/cordis';
 export declare const PROMPT_DEBUG_FILENAME = ".dsh-prompt-debug.json";
-/**
- * Register `/debug-prompt` and retain every final request observed for each
- * live session. The command writes one private, atomic snapshot into the
- * receiving session's workspace; it never records credentials, transport
- * headers, or AbortSignals.
- */
 export declare function registerPromptDebug(ctx: Context): void;
 //# sourceMappingURL=promptDebug.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"promptDebug.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/promptDebug.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAMlD,eAAO,MAAM,qBAAqB,2BAA2B,CAAA;AAmF7D;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CA4FtD"}
+{"version":3,"file":"promptDebug.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/promptDebug.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAMlD,eAAO,MAAM,qBAAqB,2BAA2B,CAAA;AAiG7D,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CA+FtD"}

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

@@ -52,11 +52,17 @@ function captureRequest(agent, options, requestIndex, position, attempt) {
     };
 }
 /**
- * Register `/debug-prompt` and retain every final request observed for each
- * live session. The command writes one private, atomic snapshot into the
- * receiving session's workspace; it never records credentials, transport
- * headers, or AbortSignals.
+ * Register `/debug-prompt` and retain the final requests observed for each
+ * live session (most recent {@link DEBUG_PROMPT_MAX_REQUESTS} kept). The
+ * command writes one private, atomic snapshot into the receiving session's
+ * workspace; it never records credentials, transport headers, or
+ * AbortSignals.
  */
+/** Retention cap per session: every capture holds the fully assembled
+ * request context (messages + tools), so an unbounded list grows
+ * quadratically with an uncompacted conversation — the dominant long-session
+ * memory term. Retries of the current step stay well inside this window. */
+const DEBUG_PROMPT_MAX_REQUESTS = 8;
 export function registerPromptDebug(ctx) {
     const commands = ctx.get('commands');
     const agents = ctx.get('agents');
@@ -80,6 +86,9 @@ export function registerPromptDebug(ctx) {
         const previous = capture.requests.findLast(request => request.turn === position.turn && request.step === position.step);
         const attempt = (previous?.attempt ?? 0) + 1;
         capture.requests.push(captureRequest(agent, options, capture.requests.length + 1, position, attempt));
+        if (capture.requests.length > DEBUG_PROMPT_MAX_REQUESTS) {
+            capture.requests.splice(0, capture.requests.length - DEBUG_PROMPT_MAX_REQUESTS);
+        }
         return next();
     });
     // Replaced agents are no longer addressable by `/debug-prompt`; release

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

@@ -30,6 +30,11 @@ export interface TuiEntryRenderResult {
     lines: readonly string[];
 }
 export type TuiEntryRenderer = (payload: unknown) => TuiEntryRenderResult | undefined;
+/** Host-only transcript projection path. Plugins can register a renderer but
+ * cannot invoke an arbitrary registered renderer on demand. */
+export interface TuiRendererHost {
+    render(type: string, payload: unknown): TuiEntryRenderResult | undefined;
+}
 declare module '@deepseek-ai/cordis' {
     interface Context {
         tuiRenderers: TuiRendererRuntime;
@@ -37,8 +42,6 @@ declare module '@deepseek-ai/cordis' {
 }
 /** `ctx.tuiRenderers` — custom session-entry text renderers. */
 export declare class TuiRendererRuntime extends Service {
-    private readonly renderers;
-    private readonly failedTypes;
     constructor(ctx: Context);
     /**
      * Map a log-only session event type to transcript rows. Returns the
@@ -48,18 +51,7 @@ export declare class TuiRendererRuntime extends Service {
      * pluginId — omitting it records `undeclared` (C-060).
      */
     register(type: string, renderer: TuiEntryRenderer, identity?: Context): () => void;
-    /**
-     * Project one event; undefined when no renderer applies, the renderer has
-     * no opinion, or it failed (failure is sticky-logged once per type so a
-     * replayed log does not spam the warn stream per event).
-     *
-     * The result is validated and sanitized INSIDE the try boundary: the title
-     * must be a string (anything else is dropped — a non-string would crash
-     * the React render path), lines are kept to scalars, control chars are
-     * stripped, and the count/width caps bound what a replay can synchronously
-     * lay out.
-     */
-    render(type: string, payload: unknown): TuiEntryRenderResult | undefined;
 }
+export declare function getHostRenderers(runtime: TuiRendererRuntime | undefined): TuiRendererHost | undefined;
 export default TuiRendererRuntime;
 //# sourceMappingURL=renderers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"renderers.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/renderers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAItD,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CACzB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,oBAAoB,GAAG,SAAS,CAAA;AAsBrF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,YAAY,EAAE,kBAAkB,CAAA;KACjC;CACF;AAED,gEAAgE;AAChE,qBAAa,kBAAmB,SAAQ,OAAO;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAChE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;gBAEpC,GAAG,EAAE,OAAO;IAIxB;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,IAAI;IA+ClF;;;;;;;;;;OAUG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,oBAAoB,GAAG,SAAS;CAwBzE;AAED,eAAe,kBAAkB,CAAA"}
+{"version":3,"file":"renderers.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/renderers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKtD,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CACzB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,oBAAoB,GAAG,SAAS,CAAA;AAErF;+DAC+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,oBAAoB,GAAG,SAAS,CAAA;CACzE;AAsBD,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,YAAY,EAAE,kBAAkB,CAAA;KACjC;CACF;AAED,gEAAgE;AAChE,qBAAa,kBAAmB,SAAQ,OAAO;gBACjC,GAAG,EAAE,OAAO;IAexB;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,IAAI;CA8DnF;AA4CD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,CAOrG;AAED,eAAe,kBAAkB,CAAA"}

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

@@ -24,6 +24,7 @@
 import { Service } from '@deepseek-ai/cordis';
 import { KNOWN_SESSION_EVENT_TYPES } from '@deepseek-ai/dsh-session';
 import { cleanRenderText } from './sanitize.js';
+import { bindCallerEffect, compositionRoot, concreteService, requirePluginCaller } from './host-access.js';
 const TYPE_PATTERN = /^[a-z][a-z0-9-]*\/[a-z][a-z0-9-]*$/u;
 /**
  * The built-in session-event vocabulary, FROZEN at module load. The live
@@ -43,10 +44,19 @@ const TITLE_CELLS = 120;
 const LINE_CELLS = 400;
 /** `ctx.tuiRenderers` — custom session-entry text renderers. */
 export class TuiRendererRuntime extends Service {
-    renderers = new Map();
-    failedTypes = new Set();
     constructor(ctx) {
         super(ctx, 'tuiRenderers');
+        compositionRoot(ctx);
+        const runtime = this;
+        const state = {
+            renderers: new Map(),
+            failedTypes: new Set(),
+            host: undefined,
+            logger: ctx.logger,
+        };
+        const host = Object.freeze({ render: (type, payload) => renderEntry(runtime, type, payload) });
+        state.host = host;
+        hostRenderers.set(runtime, state);
     }
     /**
      * Map a log-only session event type to transcript rows. Returns the
@@ -56,9 +66,25 @@ export class TuiRendererRuntime extends Service {
      * pluginId — omitting it records `undeclared` (C-060).
      */
     register(type, renderer, identity) {
-        const normalized = String(type ?? '').trim().toLowerCase();
+        let caller;
+        try {
+            caller = requirePluginCaller(this.ctx, 'tuiRenderers.register', this);
+        }
+        catch {
+            this.ctx.logger.warn('dsh-tui: tuiRenderers.register requires a live non-root plugin activation');
+            return () => { };
+        }
+        const state = rendererStateFor(this);
+        let normalized;
+        try {
+            normalized = String(type ?? '').trim().toLowerCase();
+        }
+        catch {
+            this.ctx.logger.warn('dsh-tui: tuiRenderers.register rejected an uncoercible event type');
+            return () => { };
+        }
         if (!TYPE_PATTERN.test(normalized)) {
-            this.ctx.logger.warn(`dsh-tui: tuiRenderers.register rejected invalid event type ${JSON.stringify(type)}`);
+            this.ctx.logger.warn('dsh-tui: tuiRenderers.register rejected an invalid event type');
             return () => { };
         }
         // The channel's own projection (its renderEvent switch plus special-
@@ -70,7 +96,7 @@ export class TuiRendererRuntime extends Service {
             this.ctx.logger.warn(`dsh-tui: tuiRenderers.register rejected "${normalized}" — built-in event types keep their own projection`);
             return () => { };
         }
-        if (this.renderers.has(normalized)) {
+        if (state.renderers.has(normalized)) {
             this.ctx.logger.warn(`dsh-tui: tuiRenderers.register rejected "${normalized}" — already registered`);
             this.ctx.get('tuiEffectLedger')?.record({
                 operation: 'create',
@@ -84,55 +110,64 @@ export class TuiRendererRuntime extends Service {
             this.ctx.logger.warn(`dsh-tui: tuiRenderers.register rejected "${normalized}" — renderer must be a function`);
             return () => { };
         }
-        this.renderers.set(normalized, renderer);
+        state.renderers.set(normalized, renderer);
         this.ctx.get('tuiEffectLedger')?.record({ operation: 'create', resource: { kind: 'renderer', id: normalized }, result: 'applied' }, identity);
-        return () => {
-            if (this.renderers.get(normalized) !== renderer)
+        const dispose = () => {
+            if (state.renderers.get(normalized) !== renderer)
                 return;
-            this.renderers.delete(normalized);
+            state.renderers.delete(normalized);
             this.ctx.get('tuiEffectLedger')?.record({ operation: 'release', resource: { kind: 'renderer', id: normalized }, result: 'applied' }, identity);
         };
+        bindCallerEffect(caller, dispose);
+        return dispose;
     }
-    /**
-     * Project one event; undefined when no renderer applies, the renderer has
-     * no opinion, or it failed (failure is sticky-logged once per type so a
-     * replayed log does not spam the warn stream per event).
-     *
-     * The result is validated and sanitized INSIDE the try boundary: the title
-     * must be a string (anything else is dropped — a non-string would crash
-     * the React render path), lines are kept to scalars, control chars are
-     * stripped, and the count/width caps bound what a replay can synchronously
-     * lay out.
-     */
-    render(type, payload) {
-        const renderer = this.renderers.get(type);
-        if (renderer === undefined)
+}
+const hostRenderers = new WeakMap();
+function rendererStateFor(runtime) {
+    const state = hostRenderers.get(concreteService(runtime));
+    if (state === undefined)
+        throw new Error('tuiRenderers host state is unavailable');
+    return state;
+}
+function renderEntry(runtime, type, payload) {
+    const state = rendererStateFor(runtime);
+    const renderer = state.renderers.get(type);
+    if (renderer === undefined)
+        return undefined;
+    try {
+        const result = renderer(payload);
+        if (result === undefined)
             return undefined;
-        try {
-            const result = renderer(payload);
-            if (result === undefined)
-                return undefined;
-            const raw = result;
-            if (!Array.isArray(raw.lines))
-                return undefined;
-            const lines = [];
-            for (const line of raw.lines) {
-                if (lines.length >= MAX_RENDER_LINES)
-                    break;
-                if (typeof line !== 'string' && typeof line !== 'number' && typeof line !== 'boolean')
-                    continue;
-                lines.push(cleanRenderText(String(line), LINE_CELLS));
-            }
-            const title = typeof raw.title === 'string' ? cleanRenderText(raw.title, TITLE_CELLS) : undefined;
-            return { ...(title === undefined || title === '' ? {} : { title }), lines };
-        }
-        catch (error) {
-            if (!this.failedTypes.has(type)) {
-                this.failedTypes.add(type);
-                this.ctx.logger.warn(`dsh-tui: renderer for "${type}" threw; its entries are skipped: %o`, error);
-            }
+        const raw = result;
+        if (!Array.isArray(raw.lines))
             return undefined;
+        const lines = [];
+        for (const line of raw.lines) {
+            if (lines.length >= MAX_RENDER_LINES)
+                break;
+            if (typeof line !== 'string' && typeof line !== 'number' && typeof line !== 'boolean')
+                continue;
+            lines.push(cleanRenderText(String(line), LINE_CELLS));
         }
+        const title = typeof raw.title === 'string' ? cleanRenderText(raw.title, TITLE_CELLS) : undefined;
+        return { ...(title === undefined || title === '' ? {} : { title }), lines };
+    }
+    catch (error) {
+        if (!state.failedTypes.has(type)) {
+            state.failedTypes.add(type);
+            state.logger.warn(`dsh-tui: renderer for "${type}" threw; its entries are skipped: %o`, error);
+        }
+        return undefined;
+    }
+}
+export function getHostRenderers(runtime) {
+    if (runtime === undefined)
+        return undefined;
+    try {
+        return hostRenderers.get(concreteService(runtime))?.host;
+    }
+    catch {
+        return undefined;
     }
 }
 export default TuiRendererRuntime;

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

@@ -37,6 +37,13 @@ export interface TuiSceneDescriptor {
     title?: string;
     component: React.ComponentType<TuiSceneProps>;
 }
+/** Host-only scene controls used by the channel; omitted from the plugin export. */
+export interface TuiSceneHost {
+    readonly active: TuiSceneDescriptor | undefined;
+    open(id: string): boolean;
+    close(): void;
+    subscribe(listener: () => void): () => void;
+}
 declare module '@deepseek-ai/cordis' {
     interface Context {
         tuiScenes: TuiSceneRuntime;
@@ -53,9 +60,6 @@ export declare const name = "dsh-tui-scenes";
  * takes the whole terminal the way the trajectory scene does.
  */
 export declare class TuiSceneRuntime extends Service {
-    private readonly scenes;
-    private readonly listeners;
-    private current;
     constructor(ctx: Context);
     /**
      * Register a full-screen scene; returns the dispose function (caller
@@ -75,7 +79,7 @@ export declare class TuiSceneRuntime extends Service {
     get active(): TuiSceneDescriptor | undefined;
     /** UI-side change feed: fired after every open/close/dispose transition. */
     subscribe(listener: () => void): () => void;
-    private notify;
 }
+export declare function getHostSceneRuntime(runtime: TuiSceneRuntime | undefined): TuiSceneHost | undefined;
 export default TuiSceneRuntime;
 //# sourceMappingURL=scenes.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"scenes.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/scenes.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,KAAK,EAAE,OAAO,KAAK,CAAA;IACnB,8DAA8D;IAC9D,EAAE,EAAE,cAAc,UAAU,CAAC,CAAA;IAC7B,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAA;IAChB,mEAAmE;IACnE,KAAK,IAAI,IAAI,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAA;IACV,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,aAAa,CAAC,CAAA;CAC9C;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,SAAS,EAAE,eAAe,CAAA;KAC3B;CACF;AAED,eAAO,MAAM,IAAI,mBAAmB,CAAA;AAEpC;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,OAAO;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,OAAO,CAAgC;gBAEnC,GAAG,EAAE,OAAO;IAIxB;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,kBAAkB,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,IAAI;IAoCxE;;;;OAIG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAYzB,KAAK,IAAI,IAAI;IAMb,8DAA8D;IAC9D,IAAI,MAAM,IAAI,kBAAkB,GAAG,SAAS,CAE3C;IAED,4EAA4E;IAC5E,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAO3C,OAAO,CAAC,MAAM;CAGf;AAED,eAAe,eAAe,CAAA"}
+{"version":3,"file":"scenes.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/scenes.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAI3C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,KAAK,EAAE,OAAO,KAAK,CAAA;IACnB,8DAA8D;IAC9D,EAAE,EAAE,cAAc,UAAU,CAAC,CAAA;IAC7B,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAA;IAChB,mEAAmE;IACnE,KAAK,IAAI,IAAI,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAA;IACV,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,aAAa,CAAC,CAAA;CAC9C;AAED,oFAAoF;AACpF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAA;IAC/C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;IACzB,KAAK,IAAI,IAAI,CAAA;IACb,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;CAC5C;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,SAAS,EAAE,eAAe,CAAA;KAC3B;CACF;AAED,eAAO,MAAM,IAAI,mBAAmB,CAAA;AAEpC;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,OAAO;gBAC9B,GAAG,EAAE,OAAO;IA6BxB;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,kBAAkB,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,IAAI;IAiDxE;;;;OAIG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAMzB,KAAK,IAAI,IAAI;IAMb,8DAA8D;IAC9D,IAAI,MAAM,IAAI,kBAAkB,GAAG,SAAS,CAO3C;IAED,4EAA4E;IAC5E,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;CAS5C;AAkED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAOlG;AAED,eAAe,eAAe,CAAA"}