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

package/lib/types/dsh-adapter/channel/core/compose.js

@@ -1,12 +1,34 @@
+/**
+ * The backend-neutral channel core: one composition for every
+ * `AgentSession`, whatever backend serves it.
+ *
+ * `createCoreChannel` acquires, in one owner transaction, the binding, the
+ * host seams and decision gate, the emitter, notifications, context
+ * bookkeeping, the IDE selection link, the composer and input pipeline (FIFO,
+ * `tui/input` decisions, `@` mentions, staged images, IDE selection) ending in
+ * `session.submit`, the shared projector feed, session switching (`/new`),
+ * local actions, files, reports and the capability-backed actions, and builds
+ * the common half of the `ChannelState`. Nothing is subscribed and no action
+ * is callable yet.
+ *
+ * An extension (the DSH extensions, `../extensions.ts`) then `extend`s the
+ * core: hooks into the feed and the emitter, state fields it serves, and its
+ * action delegates on top of the core's. `start()` installs the action table
+ * once, starts the runtime subscriptions, binds the session, and hands the
+ * channel lifetime to Cordis. A session no extension claims is served by the
+ * core alone: every action is backed by a capability, the core, or explicitly
+ * unavailable.
+ */
 import { markChannelReadDirty } from '../../../adapter/channel/read-view.js';
 import { createActivityProjection } from '../../../channel/activity.js';
 import { channelCapabilities } from '../../../channel/capabilities.js';
 import { anchoredRow, prependHistoryRows, projectHistorySlice, restoreFoldedRows } from '../../../channel/history-restore.js';
 import { t } from '../../../i18n.js';
 import { WORKING_GATE_NOTICES } from '../../../commands.js';
+import { markBoot } from '../../../utils/bootTrace.js';
 import { logForDebugging } from '../../../utils/debug.js';
 import { DEFAULT_SESSION_MODES } from '../../../sessionModes.js';
-import { resolveContextOccupancy } from '../../context-occupancy.js';
+import { resolveContextBreakdown, resolveContextOccupancy } from '../../context-occupancy.js';
 import { IdeChannel, ideLockDir } from '../../ide-channel.js';
 import { createChannelActionMethods, createChannelActionReadiness } from '../action-readiness.js';
 import { createAttachedContextRegistry } from '../attached-context.js';
@@ -23,7 +45,7 @@ import { registerChannelOwner } from '../owner.js';
 import { unavailablePermissionPresetSnapshot } from '../permissions.js';
 import { createPreferences } from '../preferences.js';
 import { createSettingsHosts } from '../settings-host.js';
-import { createInitialChannelView } from '../state.js';
+import { StartupOpenError, createInitialChannelView } from '../state.js';
 import { createCapabilityDelegates, installChannelActions } from './actions.js';
 import { createBindingFeed } from './binding-feed.js';
 import { createCoreFiles, NO_COMPLETION_CATALOG } from './files.js';
@@ -53,6 +75,9 @@ export function createCoreChannel(ctx, initialSession, options, owner) {
     const host = resolveCoreHost(ctx, owner);
     let extension = {};
     let started = false;
+    /** One hook may extend the core during the first adoption; extend throws otherwise. */
+    let adoptHook;
+    let adoptWindow = false;
     const emitter = createChannelEmitter(() => state, () => extension.flushDeferred?.() ?? false, {
         // Folding drops a row's full text on the promise that `loadOlder`
         // restores it; without a history slicer every row stays whole. A
@@ -205,7 +230,11 @@ export function createCoreChannel(ctx, initialSession, options, owner) {
         localImageStore ??= createLocalImageStore(() => binding.session.capabilities.images?.limits ?? NO_IMAGES);
         return localImageStore;
     };
-    const composer = createComposerImages(ctx, owner, { generation: () => state.agentBindingGeneration, localImages });
+    const composer = createComposerImages(ctx, owner, {
+        generation: () => state.agentBindingGeneration,
+        sessionId: () => state.agentId,
+        localImages,
+    });
     const files = createCoreFiles(ctx, {
         owner,
         binding,
@@ -227,7 +256,6 @@ export function createCoreChannel(ctx, initialSession, options, owner) {
      * matched by its call id, not by this.
      */
     let agentMessageIntents = 0;
-    const messaging = binding.session.capabilities.subagents?.messaging;
     const actionReadiness = createChannelActionReadiness();
     const getReadyActions = () => {
         owner.assertActive();
@@ -267,6 +295,73 @@ export function createCoreChannel(ctx, initialSession, options, owner) {
     // and never holding a non-DSH session's id): `read` is a cached lookup, so
     // the accessor on the state below stays cheap.
     const contextPressure = options.contextPressure;
+    /**
+     * The subagent control for `session`: interrupt always; the transcript read
+     * and messaging only while the session serves them. Rebuilt per adoption.
+     */
+    const subagentControlFor = (session) => {
+        const messaging = session.capabilities.subagents?.messaging;
+        return {
+            interrupt: agentId => {
+                const control = binding.session.capabilities.subagents;
+                if (control === undefined) {
+                    unavailable('agents');
+                    return false;
+                }
+                const subagent = activity.subagent(agentId);
+                if (subagent === undefined || (subagent.status !== 'running' && subagent.status !== 'starting'))
+                    return false;
+                void control.interrupt(subagent.agentId).then(stopped => {
+                    if (!stopped && owner.current())
+                        notify(t('subagent-interrupt-failed', { id: subagent.agentId.slice(0, 8) }), { color: 'warning', timeoutMs: 6000 });
+                }, (error) => {
+                    if (owner.current())
+                        notify(t('capability-failed', { name: 'agents', err: error instanceof Error ? error.message : String(error) }), { color: 'error', timeoutMs: 8000 });
+                });
+                return true;
+            },
+            // The child transcript source exists only while the bound session's
+            // `subagents.history` capability does (Claude's store read; the DSH
+            // extension replaces this whole control with one backed by its own
+            // child transcript reader). The detail scene renders a Transcript page
+            // only when this method exists. A failed read resolves null, so the
+            // scene shows "unavailable" rather than an empty transcript.
+            ...(session.capabilities.subagents?.history === undefined ? {} : {
+                history: (agentId, window) => {
+                    const history = binding.session.capabilities.subagents?.history;
+                    if (history === undefined)
+                        return Promise.resolve(null);
+                    return history(agentId, window).catch(() => null);
+                },
+            }),
+            /** Parent-mediated messaging uses the session's submit pipeline. */
+            ...(messaging === undefined ? {} : {
+                message: {
+                    via: messaging,
+                    steer: false,
+                    listTargets: () => Promise.resolve(state.subagents.map(sub => ({
+                        agentId: sub.agentId,
+                        ...(sub.sessionId === undefined ? {} : { sessionId: sub.sessionId }),
+                        label: sub.description,
+                        ...(sub.mode === undefined ? {} : { mode: sub.mode }),
+                        status: sub.status,
+                    }))),
+                    submit: (input) => {
+                        const text = input.text.trim();
+                        if (text === '')
+                            return Promise.resolve({ ok: false, reason: 'failed', message: 'empty text' });
+                        const name = input.targetName !== undefined && input.targetName.trim() !== '' ? input.targetName.trim() : input.targetId;
+                        const tool = binding.session.capabilities.subagents?.messagingTool;
+                        const envelope = tool === undefined ? t('agent-message-envelope', { name, id: input.targetId, text }) : t('agent-message-native-envelope', { tool, name, id: input.targetId, text });
+                        const intentId = `agent-message-${(agentMessageIntents += 1)}`;
+                        dispatchUserText(envelope, 'followup', [], undefined);
+                        return Promise.resolve({ ok: true, intentId, state: 'issued' });
+                    },
+                    messages: () => activity.agentMessages(),
+                },
+            }),
+        };
+    };
     const state = {
         ...createInputActions(() => state, () => binding.session, owner, inputConvergence, composer, (text, placement, images) => dispatchUserText(text, placement, images), (command, includeInContext) => getReadyActions().runLocalCommand(command, includeInContext), sessionId => { extension.touchSession?.(sessionId); }),
         subscribe: emitter.subscribe,
@@ -303,6 +398,15 @@ export function createCoreChannel(ctx, initialSession, options, owner) {
         get contextOccupancy() {
             return resolveContextOccupancy(contextPressure?.read(state.sessionId), state.lastUsage, state.contextWindow, feed.projector.contextUsage());
         },
+        /**
+         * The composition half of the same meter unit, derived on read for the same
+         * reason (and refreshed by the same change feed). `undefined` on a harness
+         * whose meter publishes no `contextBreakdown`: the bar then weights its
+         * fills with this channel's own per-content-type estimates alone.
+         */
+        get contextBreakdown() {
+            return resolveContextBreakdown(contextPressure?.readBreakdown?.(state.sessionId));
+        },
         commandList: localCommandsFor(initialCapabilities.commands),
         backendCapabilities: initialCapabilities,
         capabilities: () => extension.agentCapabilities?.() ?? sessionAgentCapabilities(),
@@ -507,66 +611,7 @@ export function createCoreChannel(ctx, initialSession, options, owner) {
             };
         },
         ...actionMethods,
-        subagentControl: {
-            interrupt: agentId => {
-                const control = binding.session.capabilities.subagents;
-                if (control === undefined) {
-                    unavailable('agents');
-                    return false;
-                }
-                const subagent = activity.subagent(agentId);
-                if (subagent === undefined || (subagent.status !== 'running' && subagent.status !== 'starting'))
-                    return false;
-                void control.interrupt(subagent.agentId).then(stopped => {
-                    if (!stopped && owner.current())
-                        notify(t('subagent-interrupt-failed', { id: subagent.agentId.slice(0, 8) }), { color: 'warning', timeoutMs: 6000 });
-                }, (error) => {
-                    if (owner.current())
-                        notify(t('capability-failed', { name: 'agents', err: error instanceof Error ? error.message : String(error) }), { color: 'error', timeoutMs: 8000 });
-                });
-                return true;
-            },
-            // The child transcript source exists only while the bound session's
-            // `subagents.history` capability does (Claude's store read; the DSH
-            // extension replaces this whole control with one backed by its own
-            // child transcript reader). The detail scene renders a Transcript page
-            // only when this method exists. A failed read resolves null, so the
-            // scene shows "unavailable" rather than an empty transcript.
-            ...(binding.session.capabilities.subagents?.history === undefined ? {} : {
-                history: (agentId, window) => {
-                    const history = binding.session.capabilities.subagents?.history;
-                    if (history === undefined)
-                        return Promise.resolve(null);
-                    return history(agentId, window).catch(() => null);
-                },
-            }),
-            /** Parent-mediated messaging uses the session's submit pipeline. */
-            ...(messaging === undefined ? {} : {
-                message: {
-                    via: messaging,
-                    steer: false,
-                    listTargets: () => Promise.resolve(state.subagents.map(sub => ({
-                        agentId: sub.agentId,
-                        ...(sub.sessionId === undefined ? {} : { sessionId: sub.sessionId }),
-                        label: sub.description,
-                        ...(sub.mode === undefined ? {} : { mode: sub.mode }),
-                        status: sub.status,
-                    }))),
-                    submit: (input) => {
-                        const text = input.text.trim();
-                        if (text === '')
-                            return Promise.resolve({ ok: false, reason: 'failed', message: 'empty text' });
-                        const name = input.targetName !== undefined && input.targetName.trim() !== '' ? input.targetName.trim() : input.targetId;
-                        const tool = binding.session.capabilities.subagents?.messagingTool;
-                        const envelope = tool === undefined ? t('agent-message-envelope', { name, id: input.targetId, text }) : t('agent-message-native-envelope', { tool, name, id: input.targetId, text });
-                        const intentId = `agent-message-${(agentMessageIntents += 1)}`;
-                        dispatchUserText(envelope, 'followup', [], undefined);
-                        return Promise.resolve({ ok: true, intentId, state: 'issued' });
-                    },
-                    messages: () => activity.agentMessages(),
-                },
-            }),
-        },
+        subagentControl: subagentControlFor(initialSession),
         jobControl: {
             kill: id => {
                 const tasks = binding.session.capabilities.tasks;
@@ -683,7 +728,8 @@ export function createCoreChannel(ctx, initialSession, options, owner) {
             trajectory: { observe: (event, replaying) => { if (trajectoryOwned())
                     agentTrajectory.observe(event, replaying); } },
             checkContextWarning, notify: (...args) => notify(...args),
-            renderer: host.rendererRuntime,
+            // Read per event (late row).
+            get renderer() { return host.rendererRuntime; },
             selectionAttached: messageId => selectionAttachments.take(messageId),
         },
         resetTrajectory: () => { if (trajectoryOwned())
@@ -769,10 +815,15 @@ export function createCoreChannel(ctx, initialSession, options, owner) {
         state,
         rowIds,
         resetProjection: feed.resetProjection,
-        resetActivity: () => { activity.reset(); },
+        resetActivity: candidate => {
+            activity.reset();
+            if (activityOwned())
+                state.subagentControl = subagentControlFor(candidate);
+        },
         snapshotOf,
         resetControls: controls.reset,
         bind: seed => feed.bind(seed),
+        attach: candidate => { attachOnAdopt(candidate); },
         bound: () => binding.session,
         mounts: SESSION_MOUNT_LEDGER,
         ...(options.sessionPrefs === undefined ? {} : { touch: (sessionId) => options.sessionPrefs?.touch(sessionId) }),
@@ -798,7 +849,7 @@ export function createCoreChannel(ctx, initialSession, options, owner) {
         binding,
         state,
         rowIds,
-        workspace: host.workspaceService,
+        get workspace() { return host.workspaceService; },
         resetProjection: feed.resetProjection,
         notify,
         unavailable,
@@ -821,15 +872,196 @@ export function createCoreChannel(ctx, initialSession, options, owner) {
         },
     });
     const reports = createCoreReports({ owner, binding, state: () => state });
+    /**
+     * Adopt the startup session once its open settles (`options.startup`). No
+     * switch: no veto, no switched notice, and the rows stay. A failed open
+     * leaves the placeholder bound and `ready` false, with a notice row
+     * pointing at `/new` (or a `StartupOpenError`'s own hint).
+     */
+    const adoptStartup = (startup) => {
+        const adoption = binding.capture();
+        let history = [];
+        let route;
+        let agentPreset;
+        const backend = state.backendCapabilities.backendLabel;
+        // The shared open-failure funnel: also the tail segment's, so a throw
+        // after a successful open can never escape as an unhandled rejection.
+        const onOpenFailed = (error) => {
+            // Released, or a `/new` / `/resume` replaced the placeholder first.
+            // A tail throw released the channel (binding.adopt's rollback), so it
+            // takes this same early exit.
+            if (!owner.current() || binding.session !== adoption.session)
+                return;
+            logForDebugging(`channel: startup session failed to open (${error instanceof Error ? error.message : String(error)})`);
+            // A notice is one line: the reason's first line, and the way out on a
+            // row of its own so a long reason cannot crowd it out.
+            const reason = (error instanceof Error ? error.message : String(error)).split('\n')[0];
+            state.startupFailure = reason;
+            state.rows.push({ id: rowIds.value++, kind: 'notice', text: t('startup-open-failed', { backend, err: reason }) });
+            state.rows.push({ id: rowIds.value++, kind: 'notice', text: error instanceof StartupOpenError ? error.hint : t('startup-open-failed-hint') });
+            state.emit();
+        };
+        void binding.prepare(adoption, async () => {
+            const opened = await startup;
+            history = opened.history;
+            route = opened.route;
+            agentPreset = opened.agentPreset;
+            return opened.session;
+        }).then(async (candidate) => {
+            try {
+                const previousCwd = state.cwd;
+                binding.adopt(candidate, adoption, (_previous, disposePrevious) => {
+                    feed.resetProjection();
+                    if (activityOwned()) {
+                        activity.reset();
+                        state.subagentControl = subagentControlFor(candidate);
+                    }
+                    state.agentId = candidate.ref.sessionId;
+                    state.sessionId = candidate.ref.sessionId;
+                    // A resumed session runs where it was recorded, known only now.
+                    state.cwd = candidate.cwd;
+                    state.displayCwd = host.workspaceService.describe(candidate.cwd).description ?? candidate.cwd;
+                    state.backendCapabilities = snapshotOf(candidate);
+                    // Route and preset the opener resolved only now; written before the
+                    // extensions attach, so theirs win.
+                    if (route !== undefined) {
+                        state.provider = route.provider;
+                        state.model = route.model;
+                    }
+                    if (agentPreset !== undefined)
+                        state.agentPreset = agentPreset;
+                    controls.reset();
+                    attachOnAdopt(candidate);
+                    state.ready = true;
+                    state.startupFailure = undefined;
+                    feed.bind(history);
+                    disposePrevious('dispose');
+                    state.emit();
+                });
+                if (state.cwd !== previousCwd)
+                    resetIdeSelection();
+                refreshGitBranch();
+                scheduleSessionPreload();
+                markBoot('startup-adopted');
+            }
+            catch (error) {
+                // The tail segment runs after the open succeeded; its throws take
+                // the open-failure funnel below instead of an unhandled rejection.
+                // binding.adopt() already revoked a failed transaction (the candidate
+                // is closed, the channel released); a throw from before that point
+                // still owns a prepared candidate, so hand it back for closing.
+                logForDebugging(`channel: startup adoption tail failed (${error instanceof Error ? error.message : String(error)})`);
+                try {
+                    await binding.abandon(candidate);
+                }
+                catch { /* a failed close must not mask the setup error */ }
+                throw error;
+            }
+        }).catch(onOpenFailed);
+    };
     /** A fresh session in another directory (the session browser's new-session
      *  card, `/workspace`'s handoff): the core `/new` with a target. */
     const workspaces = createWorkspaceActions(state, {
         owner,
-        service: host.workspaceService,
+        get service() { return host.workspaceService; },
         newSession: target => sessionSwitch.newSession(target),
         refreshGitBranch: () => refreshGitBranch(),
         notify,
     });
+    /** The actions the core serves itself (read at install time: the
+     *  completion catalog is the extension's). */
+    const coreDelegates = () => ({
+        commandCompletions: files.commandCompletions(extension.completions ?? NO_COMPLETION_CATALOG),
+        runLocalCommand: local.runLocalCommand,
+        loadOlder: local.loadOlder,
+        clear: () => {
+            local.clear();
+            clearedGeneration = state.agentBindingGeneration;
+        },
+        setActivityFrames: local.setActivityFrames,
+        pushLocal: local.pushLocal,
+        listFileCandidates: files.listFileCandidates,
+        listFiles: files.listFiles,
+        doctorInfo: reports.doctorInfo,
+        exportSession: reports.exportSession,
+        newSession: () => sessionSwitch.newSession(),
+        // `/agents` from the event-driven roster (the DSH extension serves its own).
+        mcpStatus: () => {
+            if (binding.session.capabilities.mcp === undefined)
+                return unavailableLines('mcp');
+            const fence = mcpFence();
+            return controls.mcpReport(fence.session, fence.current) ?? [t('backend-mcp-loading')];
+        },
+        listSubagents: () => Promise.resolve(binding.session.capabilities.subagents === undefined ? unavailableLines('agents') : activity.listLines()),
+        resolveWorkspace: workspaces.resolveWorkspace,
+        switchWorkspace: workspaces.switchWorkspace,
+        ...sessionActions.delegates,
+    });
+    let listedFrom;
+    let listedCwd;
+    const installActions = (replace) => {
+        const listSessions = extension.delegates?.listSessions ?? sessionActions.delegates.listSessions;
+        installChannelActions(actionReadiness, {
+            unavailable,
+            unavailableLines,
+            capability: createCapabilityDelegates({
+                owner,
+                session: () => binding.session,
+                state: () => state,
+                notify,
+                unavailable,
+                unavailableLines,
+                guarded,
+            }),
+            core: coreDelegates(),
+            extension: {
+                ...extension.delegates,
+                listSessions: (onEnriched, onPartial) => {
+                    listedFrom = listSessions;
+                    listedCwd = state.cwd;
+                    return listSessions(onEnriched, onPartial);
+                },
+            },
+        }, replace);
+    };
+    /** The first adoption can install DSH listing actions or change cwd. */
+    const scheduleSessionPreload = () => {
+        if (options.sessionCatalog === undefined && extension.delegates?.listSessions === undefined)
+            return;
+        const preload = setImmediate(() => {
+            releasePreload();
+            const listSessions = extension.delegates?.listSessions ?? sessionActions.delegates.listSessions;
+            if (!owner.current() || (listedFrom === listSessions && listedCwd === state.cwd))
+                return;
+            void state.listSessions().catch(error => {
+                logForDebugging(`session list preload failed: ${error instanceof Error ? error.message : String(error)}`);
+            });
+        });
+        const releasePreload = owner.own(() => clearImmediate(preload));
+    };
+    /** Runs `adoptHook` after the core wrote the session's state, before the
+     *  bind; a throw fails the adoption transaction. */
+    const attachOnAdopt = (candidate) => {
+        const hook = adoptHook;
+        if (hook === undefined)
+            return;
+        adoptHook = undefined;
+        const before = extension;
+        adoptWindow = true;
+        try {
+            hook(candidate);
+        }
+        finally {
+            adoptWindow = false;
+        }
+        if (extension === before)
+            return;
+        installActions(true);
+        if (extension.start !== before.start) {
+            extension.start?.before?.();
+            extension.start?.after?.();
+        }
+    };
     const refreshGitBranch = createGitBranchRefresher(ctx, {
         owner,
         state,
@@ -854,9 +1086,9 @@ export function createCoreChannel(ctx, initialSession, options, owner) {
         reports,
         resetIdeSelection,
         refreshGitBranch,
-        /** Merge an extension's contributions (before `start`). */
+        /** Merge an extension's contributions (before `start`, or in the adoption window). */
         extend(next) {
-            if (started)
+            if (started && !adoptWindow)
                 throw new Error('dsh-tui: Channel extensions must attach before the channel starts');
             extension = {
                 ...extension,
@@ -864,67 +1096,34 @@ export function createCoreChannel(ctx, initialSession, options, owner) {
                 delegates: { ...extension.delegates, ...next.delegates },
             };
         },
+        /** Register (before `start`) the adoption-window hook (see `adoptHook`). */
+        extendOnAdopt(hook) {
+            if (started)
+                throw new Error('dsh-tui: Channel adoption extensions must register before the channel starts');
+            if (adoptHook !== undefined)
+                throw new Error('dsh-tui: Channel adoption extension already registered');
+            adoptHook = hook;
+        },
         /** Install the actions, start the runtime, bind the session. */
         start() {
             if (started)
                 throw new Error('dsh-tui: Channel already started');
             started = true;
-            const core = {
-                commandCompletions: files.commandCompletions(extension.completions ?? NO_COMPLETION_CATALOG),
-                runLocalCommand: local.runLocalCommand,
-                loadOlder: local.loadOlder,
-                clear: () => {
-                    local.clear();
-                    clearedGeneration = state.agentBindingGeneration;
-                },
-                setActivityFrames: local.setActivityFrames,
-                pushLocal: local.pushLocal,
-                listFileCandidates: files.listFileCandidates,
-                listFiles: files.listFiles,
-                doctorInfo: reports.doctorInfo,
-                exportSession: reports.exportSession,
-                newSession: () => sessionSwitch.newSession(),
-                // `/agents` from the event-driven roster (the DSH extension serves its own).
-                mcpStatus: () => {
-                    if (binding.session.capabilities.mcp === undefined)
-                        return unavailableLines('mcp');
-                    const fence = mcpFence();
-                    return controls.mcpReport(fence.session, fence.current) ?? [t('backend-mcp-loading')];
-                },
-                listSubagents: () => Promise.resolve(binding.session.capabilities.subagents === undefined ? unavailableLines('agents') : activity.listLines()),
-                resolveWorkspace: workspaces.resolveWorkspace,
-                switchWorkspace: workspaces.switchWorkspace,
-                ...sessionActions.delegates,
-            };
-            installChannelActions(actionReadiness, {
-                unavailable,
-                unavailableLines,
-                capability: createCapabilityDelegates({
-                    owner,
-                    session: () => binding.session,
-                    state: () => state,
-                    notify,
-                    unavailable,
-                    unavailableLines,
-                    guarded,
-                }),
-                core,
-                extension: extension.delegates,
-            });
+            installActions(false);
             // Everything below can synchronously invoke external callbacks. It runs
             // only after the owner is registered and the complete delegate surface
             // is installed; the outer construction transaction rolls every step back.
             extension.start?.before?.();
-            startHostSubscriptions(host, owner, state);
+            startHostSubscriptions(host, owner, state, ctx);
             extension.start?.after?.();
             // The startup session's history, read ahead of construction, paints
             // before any live event (an extension owning the facts replays its own).
             feed.bind(extension.bind?.ownsSessionFacts === true ? undefined : options.initialHistory);
-            // Cordis owns the Channel lifetime. Rebinding handles the common case;
+            scheduleSessionPreload();
+            // The host owns the Channel lifetime. Rebinding handles the common case;
             // this effect closes the final timer and releases the DecisionEvents
-            // dispatch-topology marker when the Channel's context unloads.
-            const effect = ctx.effect;
-            effect?.call(ctx, () => () => {
+            // dispatch-topology marker when the host unloads the Channel.
+            ctx.effect?.(() => () => {
                 // The context owns the complete Channel lifetime. Keep emitter and
                 // IDE-link teardown in the same finally funnel.
                 state.releaseContributions();
@@ -932,6 +1131,8 @@ export function createCoreChannel(ctx, initialSession, options, owner) {
             refreshGitBranch();
             if (extension.bind?.ownsSessionFacts !== true)
                 state.emit();
+            if (options.startup !== undefined)
+                adoptStartup(options.startup);
             return state;
         },
     };

package/lib/types/dsh-adapter/channel/core/files.d.ts

@@ -7,7 +7,7 @@
  * own commands join the command list itself (core/session-controls.ts), so
  * completion lists them like any other entry.
  */
-import type { Context } from '@deepseek-ai/cordis';
+import type { ServiceLookup } from '../channel-host.js';
 import type { CommandCompletionNode } from '../../../commands.js';
 import type { ChannelBinding } from '../binding.js';
 import type { ChannelOwner } from '../owner.js';
@@ -32,10 +32,15 @@ export interface CompletionCatalog {
         }[];
         warmEffortLevels(): void;
     };
+    /** `/plugin info <name>`: the bundles the profile added (absent = no service). */
+    plugin?: {
+        warmPluginNames(): void;
+        pluginNames(): readonly CommandCompletionNode[];
+    };
 }
 /** No argument catalogs: the tree offers its static nodes only. */
 export declare const NO_COMPLETION_CATALOG: CompletionCatalog;
-export declare function createCoreFiles(ctx: Context, deps: {
+export declare function createCoreFiles(ctx: ServiceLookup, deps: {
     owner: Pick<ChannelOwner, 'current' | 'signal'>;
     binding: Pick<ChannelBinding, 'capture' | 'isCurrent'>;
     state: () => ChannelState;

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

@@ -1 +1 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../../../src/dsh-adapter/channel/core/files.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAKnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEzC,mEAAmE;AACnE,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,IAAI,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACnG,KAAK,EAAE;QACL,cAAc,IAAI,IAAI,CAAA;QACtB,UAAU,IAAI,SAAS,qBAAqB,EAAE,CAAA;QAC9C,iBAAiB,IAAI,IAAI,CAAA;QACzB,aAAa,IAAI,SAAS;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,OAAO,CAAA;SAAE,EAAE,CAAA;QACpG,gBAAgB,IAAI,IAAI,CAAA;KACzB,CAAA;CACF;AAED,mEAAmE;AACnE,eAAO,MAAM,qBAAqB,EAAE,iBASnC,CAAA;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;IAClD,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,QAAQ,CAAC,CAAA;IAC/C,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,WAAW,CAAC,CAAA;IACtD,KAAK,EAAE,MAAM,YAAY,CAAA;IACzB,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,cAAc,CAAC,CAAA;IAClD,sEAAsE;IACtE,aAAa,IAAI,OAAO,CAAA;IACxB,gEAAgE;IAChE,UAAU,CAAC,IAAI,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CAC7C;sBAIwB,SAAS,GAAG,SAAS;;cAvC1C,CAAC;YAAoB,CAAA;;;IAoDrB,qEAAqE;gCACzC,iBAAiB,GAAG,YAAY,CAAC,oBAAoB,CAAC;EAWrF"}
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../../../src/dsh-adapter/channel/core/files.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAKnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEzC,mEAAmE;AACnE,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,IAAI,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACnG,KAAK,EAAE;QACL,cAAc,IAAI,IAAI,CAAA;QACtB,UAAU,IAAI,SAAS,qBAAqB,EAAE,CAAA;QAC9C,iBAAiB,IAAI,IAAI,CAAA;QACzB,aAAa,IAAI,SAAS;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,OAAO,CAAA;SAAE,EAAE,CAAA;QACpG,gBAAgB,IAAI,IAAI,CAAA;KACzB,CAAA;IACD,kFAAkF;IAClF,MAAM,CAAC,EAAE;QACP,eAAe,IAAI,IAAI,CAAA;QACvB,WAAW,IAAI,SAAS,qBAAqB,EAAE,CAAA;KAChD,CAAA;CACF;AAED,mEAAmE;AACnE,eAAO,MAAM,qBAAqB,EAAE,iBASnC,CAAA;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE;IACxD,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,QAAQ,CAAC,CAAA;IAC/C,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,WAAW,CAAC,CAAA;IACtD,KAAK,EAAE,MAAM,YAAY,CAAA;IACzB,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,cAAc,CAAC,CAAA;IAClD,sEAAsE;IACtE,aAAa,IAAI,OAAO,CAAA;IACxB,gEAAgE;IAChE,UAAU,CAAC,IAAI,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CAC7C;sBAIwB,SAAS,GAAG,SAAS;;cA5C9C,CAAA;YAAmB,CAAC;;;IAyDhB,qEAAqE;gCACzC,iBAAiB,GAAG,YAAY,CAAC,oBAAoB,CAAC;EAYrF"}

package/lib/types/dsh-adapter/channel/core/files.js

@@ -39,6 +39,7 @@ export function createCoreFiles(ctx, deps) {
                 workspaceCommands: catalog.workspaceCommands,
                 ...(deps.mcpServers === undefined ? {} : { mcpServers: deps.mcpServers }),
                 model: catalog.model,
+                ...(catalog.plugin === undefined ? {} : { plugin: catalog.plugin }),
             });
         },
     };

package/lib/types/dsh-adapter/channel/core/host.d.ts

@@ -6,7 +6,6 @@
  * changes, and the git-branch breadcrumb. Each lookup degrades when its row
  * is not mounted, whatever backend serves the session.
  */
-import type { Context } from '@deepseek-ai/cordis';
 import type { AdapterRuntimeOptions } from '../../../adapter/kernel/runtime.js';
 import { readGrantStore } from '../../../adapter/standard/grants.js';
 import { getHostCommandTrees } from '../../command-trees.js';
@@ -15,9 +14,13 @@ import { getHostSceneRuntime } from '../../scenes.js';
 import { getHostSettingsSections } from '../../settings-sections.js';
 import { getHostThemes } from '../../themes.js';
 import { createLocalWorkspaceRuntime, getHostWorkspaceRuntime } from '../../workspaces.js';
+import type { ChannelHost, ServiceLookup } from '../channel-host.js';
 import type { ChannelOwner } from '../owner.js';
 import type { ChannelState } from '../types.js';
-/** The host services a channel composition resolved at construction. */
+/**
+ * The host services a channel composition reads, looked up per read: the
+ * profile's `tui*` rows can compose after the mount.
+ */
 export interface CoreHost {
     readonly adapterRuntime: AdapterRuntimeOptions;
     readonly themeHost: ReturnType<typeof getHostThemes>;
@@ -36,16 +39,19 @@ export interface CoreHost {
  * is effectful state, so it is owned at acquisition: a later construction
  * failure rolls it back.
  */
-export declare function resolveCoreHost(ctx: Context, owner: Pick<ChannelOwner, 'own'>): CoreHost;
-/** Re-render on settings-section and plugin-scene changes (owner-scoped). */
-export declare function startHostSubscriptions(host: Pick<CoreHost, 'settingsSectionsRuntime' | 'sceneRuntime'>, owner: Pick<ChannelOwner, 'own' | 'current'>, state: Pick<ChannelState, 'pluginScene' | 'emit'>): void;
+export declare function resolveCoreHost(ctx: ChannelHost, owner: Pick<ChannelOwner, 'own'>): CoreHost;
+/**
+ * Re-render on settings-section and plugin-scene changes (owner-scoped),
+ * re-binding when the host reports a service change.
+ */
+export declare function startHostSubscriptions(host: Pick<CoreHost, 'settingsSectionsRuntime' | 'sceneRuntime'>, owner: Pick<ChannelOwner, 'own' | 'current'>, state: Pick<ChannelState, 'pluginScene' | 'emit'>, services?: Pick<ChannelHost, 'watchServices'>): void;
 /**
  * Statusline breadcrumb: the current git branch of the session cwd
  * (best-effort, through the host `shell` service). Re-run when an adoption
  * lands on a different cwd (/resume, /workspace, issue #96) so the
  * breadcrumb never shows the previous workspace's branch.
  */
-export declare function createGitBranchRefresher(ctx: Context, deps: {
+export declare function createGitBranchRefresher(ctx: ServiceLookup, deps: {
     owner: Pick<ChannelOwner, 'current'>;
     state: Pick<ChannelState, 'cwd' | 'gitBranch' | 'emit'>;
     /** Record the resolved branch against the bound session (the session