@sagmans/dsh-tui 0.5.2 → 0.7.0

package/lib/surface/appearance.js

@@ -0,0 +1,353 @@
+import { defaultKeymap } from "../input/actions.js";
+import { DEFAULT_PREFIX_KEYS, DEFAULT_PREFIX_WINDOW_S } from "../input/keymap.js";
+import { createDeferredNotice } from "../settings-notice.js";
+import { createTheme, forwardEditorTheme, forwardMarkdownTheme } from "../theme.js";
+import { detectColourMode } from "../theme-capability.js";
+import { renderThemeTable } from "../theme-command.js";
+import { DEFAULT_THEME, builtinNames, builtinThemesDir, ensureThemesHome, exportTheme, loadThemes, themesHomeDir, watchThemes } from "../theme-files.js";
+import { defaultSettings, toOverrides } from "../theme-settings.js";
+import { ThemePicker } from "../ui/theme-picker.js";
+import { DEFAULT_VIEW_STATE } from "../ui/view.js";
+import { createAppearancePreferences } from "./appearance-preferences.js";
+/** One second in the unit a chord window is scheduled in. */
+const MS_PER_SECOND = 1000;
+/**
+ * The reader's appearance and display preferences, and the theme's lifetime.
+ *
+ * Every preference is read through a getter rather than captured, and the theme
+ * table is replaced behind a delegate the renderers already hold, because the
+ * document is hot-reloaded and the shade the reader saves has to reach a session
+ * that is already on screen.
+ */
+export function createAppearance(ctx, ports) {
+    const themeMode = () => (ports.color() ? detectColourMode(process.env) : 'none');
+    /**
+     * The themes this session can draw.
+     *
+     * Read from disk rather than compiled in, so a file the reader saves is a theme
+     * the moment the save lands. Held beside the settings rather than inside them
+     * because the two answer different questions: the section says which name the
+     * reader chose, and this says which names exist — including the one they typed
+     * into the directory a second ago.
+     */
+    const themesHome = themesHomeDir();
+    let themeLibrary = loadThemes(themesHome, builtinThemesDir());
+    /**
+     * A refused settings edit, kept until the surface can show it: stderr is
+     * behind the alt screen, and the section is read on a schedule of its own.
+     */
+    const settingsNotice = createDeferredNotice();
+    let current = createTheme(themeMode());
+    /**
+     * The section as it was last read.
+     *
+     * Held so a preview can rebuild the table without reading the document again:
+     * the picker repaints on every arrow key, and a read there would report a
+     * refused section once per press.
+     */
+    let appliedSection;
+    /**
+     * The theme the picker's cursor is on, while its list is open.
+     *
+     * A preview is a name and nothing else — the document is not written — so
+     * leaving the list is one more rebuild from the section, and a session that
+     * ends mid-preview has still persisted only what the reader chose.
+     */
+    let previewTheme;
+    /**
+     * The theme in force: the reader's section, then the name the row pins, then
+     * whatever file answers to no name at all.
+     *
+     * One question asked at two scopes. A section belongs to the settings document,
+     * so a reader who has one is naming a theme for it; the row belongs to the
+     * profile, and a harness that keeps configuration per row has no document left
+     * to hold a name — which is why the row is read here, below the section and
+     * above the default, rather than as the only answer.
+     */
+    const themeName = (section) => section.theme ?? (preferences.configBacked() ? undefined : ports.rowTheme);
+    const applyTheme = (section) => {
+        // The row under the cursor outranks both while a list is open, so a theme is
+        // judged on the reader's own transcript before it is taken.
+        current = createTheme(themeMode(), toOverrides({ ...section, theme: previewTheme ?? themeName(section) }, themeLibrary));
+    };
+    /** Repaint the surface: both caches hold rows drawn under the table this replaced. */
+    const restyle = () => {
+        ports.invalidateMarkdown();
+        ports.invalidateView();
+        ports.render();
+    };
+    /**
+     * Show a theme without choosing it.
+     *
+     * The list's cursor is the preview: every row paints the surface and writes
+     * nothing, so two themes are compared on the reader's own transcript rather
+     * than on a name. Clearing the name puts back what the document says, which is
+     * what cancelling the list has to leave behind.
+     */
+    const showTheme = (name) => {
+        previewTheme = name;
+        // Nothing to rebuild from before the first read, and nothing to show either.
+        if (appliedSection === undefined)
+            return;
+        applyTheme(appliedSection);
+        restyle();
+    };
+    const theme = {
+        get revision() { return current.revision; },
+        get color() { return current.color; },
+        style: (token, text) => current.style(token, text),
+        rich: (raw, options) => current.rich(raw, options),
+        cut: (text, width, ellipsis) => current.cut(text, width, ellipsis),
+        glyph: token => current.glyph(token),
+        visible: token => current.visible(token),
+        // Forwarded rather than read, because the editor and the markdown view keep
+        // the theme object they were built with: a settings change has to reach them
+        // through a stable delegate or they would keep the boot appearance.
+        editor: forwardEditorTheme(() => current.editor),
+        markdown: forwardMarkdownTheme(() => current.markdown),
+    };
+    /**
+     * Rows the reader has opened by key. The model stays untouched; only the view
+     * reads this, and a click on one message overrides it there. A thought starts
+     * folded: it is the longest, least scannable row in the transcript, so leaving
+     * it open pushes the answer a reader came for off the screen, and a folded row
+     * still names itself and its key. Cards start from the reader's own `tools:`
+     * settings, and a PTC card's calls start open for the opposite reason: each is
+     * one clipped line under a header that already names the program.
+     */
+    const viewState = { ...DEFAULT_VIEW_STATE };
+    const toggleCards = () => {
+        viewState.expandCards = !viewState.expandCards;
+    };
+    const toggleSubCalls = () => {
+        viewState.expandSubCalls = !viewState.expandSubCalls;
+    };
+    const toggleReasoning = () => {
+        viewState.expandReasoning = !viewState.expandReasoning;
+    };
+    /**
+     * How a reply's mermaid fences draw, seeded from the reader's section.
+     *
+     * The transform reads this per render instead of capturing it, because the
+     * settings document is hot-reloaded and a session already on screen has to
+     * follow the edit.
+     */
+    let mermaidMode = defaultSettings().mermaid;
+    /** How each tool's cards draw; the settings document owns it and the view reads it live. */
+    let toolDisplay = defaultSettings().tools;
+    /** The keys that start a chord, and how long one waits; the settings document owns all of it. */
+    let prefixKeys = DEFAULT_PREFIX_KEYS;
+    let prefixWindowMs = DEFAULT_PREFIX_WINDOW_S * MS_PER_SECOND;
+    /** Every action's keys in force; the settings document owns it and a press reads it live. */
+    let keymap = defaultKeymap();
+    /** Whether prompts are recorded and offered, and the cap on how many; the settings document owns all three. */
+    let historyEnabled = false;
+    let historyGhost = false;
+    let historyMaxEntries = defaultSettings().history.maxEntries;
+    /**
+     * Seed the display the reader configured.
+     *
+     * The key toggles nested calls for one session, but a settings edit is a
+     * deliberate act, so it re-seeds and becomes the new starting point; the
+     * mermaid mode and the per-tool card fold have no key of their own and only
+     * ever come from the document. Installing the keys, and ending a chord armed
+     * under the map this edit replaced, belong to the prompt bar's owner.
+     */
+    const applyDisplay = (section) => {
+        viewState.expandSubCalls = section.subcalls === 'inline';
+        mermaidMode = section.mermaid;
+        toolDisplay = section.tools;
+        prefixKeys = section.prefixes;
+        prefixWindowMs = section.prefixWindow * MS_PER_SECOND;
+        keymap = section.keymap;
+        ports.keybindings().installBindings();
+        historyEnabled = section.history.enabled;
+        historyGhost = section.history.ghost;
+        historyMaxEntries = section.history.maxEntries;
+        ports.keybindings().disarmChord();
+    };
+    /**
+     * Read the reader's section once and apply everything it configures.
+     *
+     * One read per change, because a refused section is reported on the way past:
+     * reading it once per field would show the reader the same refusal twice.
+     */
+    let applyingSettings = false;
+    const applySettings = () => {
+        // describe() can synchronously announce its first snapshot while it is being read.
+        if (applyingSettings)
+            return;
+        applyingSettings = true;
+        try {
+            const section = preferences.read();
+            previewTheme = undefined;
+            reportMissingTheme(section);
+            applyTheme(section);
+            appliedSection = section;
+            applyDisplay(section);
+        }
+        finally {
+            applyingSettings = false;
+        }
+    };
+    /**
+     * Say so when the reader named a theme that nothing answers to.
+     *
+     * The schema cannot refuse the name: a theme is a file, so the set of names is
+     * known to the directory rather than to this build, and one can stop answering
+     * between two reads. Falling back to the default without a word would leave the
+     * reader looking at shades they did not choose, so the refusal lands here
+     * instead — beside the read that found it, and alongside the rest of the
+     * section, which is still theirs.
+     */
+    const reportMissingTheme = (section) => {
+        const name = themeName(section);
+        if (name === undefined || themeLibrary.get(name) !== undefined)
+            return;
+        settingsNotice.post(`dsh-tui theme "${name}" is not a theme · themes: ${themeLibrary.names().join(' · ')} · the default, ${DEFAULT_THEME}, is drawn instead`);
+    };
+    /**
+     * Choose a theme from a list the screen follows.
+     *
+     * Enter writes the choice through the settings document, the same path a typed
+     * name takes, so what lands is what the reader was looking at. Leaving the list
+     * restores the theme in force, because the document never changed while they
+     * looked.
+     */
+    const openThemePicker = async () => {
+        const picked = await ports.openPicker(new ThemePicker(() => themeLibrary, 
+        // What the surface draws right now, so a name pinned in the row is the
+        // row the list opens on instead of reading as no choice at all.
+        () => appliedSection === undefined ? ports.rowTheme : themeName(appliedSection), () => keymap, theme => showTheme(theme?.name)));
+        if (picked === undefined) {
+            showTheme(undefined);
+            return;
+        }
+        // The row stays on screen until the document carries it: restoring first
+        // would flash the theme the reader just left. The write clears the preview as
+        // it lands, and a write that fails says so, leaving a theme that is still one
+        // of theirs rather than shades nothing chose.
+        preferences.chooseTheme(picked);
+    };
+    const runThemeCommand = (argument) => {
+        // A bare command is the list: a theme is judged by looking at it, so
+        // choosing one belongs in a list the screen follows rather than in a name
+        // the reader has to already know.
+        if (argument === '') {
+            void openThemePicker();
+            return;
+        }
+        const [head = '', ...rest] = argument.split(/\s+/u);
+        // The table answers the other question a theme raises — which layer drew a
+        // shade — and stays reachable by name now that the list has the command.
+        if (head === 'tokens') {
+            // The table answers for the appearance on screen, not only for the
+            // document: a row-pinned theme would otherwise read as every shade
+            // untouched, which is the opposite of the question this command answers.
+            const section = appliedSection ?? preferences.read();
+            for (const line of renderThemeTable(toOverrides({ ...section, theme: previewTheme ?? themeName(section) }, themeLibrary), themeLibrary))
+                ports.notice(line);
+            ports.render();
+            return;
+        }
+        // The one way a built-in becomes editable. Its file ships inside the
+        // package and the next version replaces it, so a reader who wants to
+        // change one needs a copy that is theirs — and the copy is a theme the
+        // moment it lands, which is why the table is re-read rather than patched.
+        if (head === 'export') {
+            const chosen = rest.join(' ').trim();
+            if (chosen === '') {
+                ports.notice(`theme export · which built-in? ${builtinNames(themeLibrary).join(' · ')}`);
+                ports.render();
+                return;
+            }
+            const outcome = exportTheme(themeLibrary, chosen);
+            if (outcome.ok) {
+                themeLibrary = loadThemes(themesHome, builtinThemesDir());
+                ports.notice(`theme · exported ${chosen} to ${outcome.path} · /theme ${outcome.select} applies it`);
+            }
+            else {
+                ports.notice(outcome.problem);
+            }
+            ports.render();
+            return;
+        }
+        // A name nothing answers to is refused by name, like an unknown key
+        // layer: the reader asked for something, so the answer lists names.
+        if (themeLibrary.get(head) === undefined) {
+            ports.notice(`unknown theme "${head}" · themes: ${themeLibrary.names().join(' · ')}`);
+            ports.render();
+            return;
+        }
+        preferences.chooseTheme(head);
+    };
+    const preferences = createAppearancePreferences(ctx, {
+        rowSettings: ports.rowSettings,
+        rowSettingsLive: ports.rowSettingsLive,
+        applied: () => appliedSection,
+        apply: applySettings,
+        restyle,
+        restorePreview: () => showTheme(undefined),
+        disableHistory: () => { historyEnabled = false; historyGhost = false; },
+        notice: ports.notice,
+        problem: message => settingsNotice.post(message),
+    });
+    let reportedThemes = new Set();
+    const reportThemes = () => {
+        // Only what is newly wrong: the watcher re-reads the whole directory on every
+        // save, so an unfixed file would otherwise repeat its complaint on each one,
+        // and a reader who has just been told is not helped by being told again.
+        const problems = themeLibrary.problems();
+        for (const problem of problems) {
+            if (!reportedThemes.has(problem))
+                settingsNotice.post(problem);
+        }
+        reportedThemes = new Set(problems);
+    };
+    /**
+     * The reader's own themes: created, reported, and then watched.
+     *
+     * Created because a directory that is not there is a command that cannot work —
+     * `/theme export` names a path the reader should find where the surface said it
+     * would be. Watched because a theme is a file they are editing by hand, so
+     * saving one is how they ask for it; a session that needed a restart per shade
+     * would make the whole table useless for tuning. Everything unreadable is
+     * reported through the deferred notice rather than stderr, which the alternate
+     * screen is drawn over.
+     */
+    const createThemesHome = () => {
+        for (const problem of ensureThemesHome(themesHome))
+            settingsNotice.post(problem);
+        reportThemes();
+    };
+    const watchThemeFiles = () => watchThemes(themesHome, () => {
+        themeLibrary = loadThemes(themesHome, builtinThemesDir());
+        reportThemes();
+        // The file that was just saved may be the theme already in force, so the
+        // table is rebuilt rather than only repainted.
+        applySettings();
+        restyle();
+    });
+    return {
+        theme,
+        viewState: () => viewState,
+        toggleCards,
+        toggleSubCalls,
+        toggleReasoning,
+        mermaidMode: () => mermaidMode,
+        toolDisplay: () => toolDisplay,
+        keymap: () => keymap,
+        prefixKeys: () => prefixKeys,
+        prefixWindowMs: () => prefixWindowMs,
+        historyEnabled: () => preferences.allowsHistory('enabled', historyEnabled),
+        historyGhost: () => preferences.allowsHistory('ghost', historyGhost),
+        historyMaxEntries: () => historyMaxEntries,
+        openNotices: sink => settingsNotice.open(sink),
+        registerSection: preferences.register,
+        createThemesHome,
+        settingsListener: preferences.listen,
+        watchThemes: watchThemeFiles,
+        runThemeCommand,
+    };
+}
+//# sourceMappingURL=appearance.js.map

package/lib/surface/appearance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appearance.js","sourceRoot":"","sources":["../../src/surface/appearance.ts"],"names":[],"mappings":"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"}

package/lib/surface/background-work.d.ts

@@ -0,0 +1,49 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { SessionId } from '@deepseek-ai/dsh-session';
+import type { TuiAgent } from '../agent/host.ts';
+import { type JobSummary } from '../jobs.ts';
+import { SubagentRoster } from '../subagents.ts';
+/**
+ * What the background-work owner needs from the surface that composes it.
+ *
+ * The agent and the session on screen are read at call time: a command, a
+ * listener, or the job watch each has to follow whatever this terminal drives
+ * now, and a captured identity would follow the one it drove at construction.
+ */
+export interface BackgroundWorkPorts {
+    readonly drivingAgent: () => TuiAgent | undefined;
+    readonly activeSession: () => SessionId;
+    readonly notice: (text: string) => void;
+    readonly marker: (text: string) => void;
+    readonly render: () => void;
+    /** Show the session a child runs in; the viewed-session owner performs it. */
+    readonly navigate: (id: string) => void;
+}
+/** The commands and live reads the composing surface routes to this owner. */
+export interface BackgroundWork {
+    readonly roster: SubagentRoster;
+    readonly jobs: () => readonly JobSummary[];
+    readonly refresh: () => void;
+    /** Fold the parent's durable catalog, which is where a child's task name lives. */
+    readonly acceptCatalog: (info: unknown) => void;
+    readonly resetRoster: () => void;
+    readonly runSubagentsCommand: (argument: string) => void;
+    readonly runJobsCommand: (argument: string) => void;
+    /**
+     * Register the two subagent lifecycle listeners.
+     *
+     * They are returned rather than pushed here so the composition root keeps one
+     * ordered list of teardowns, which is unwound in reverse registration order.
+     */
+    readonly subagentListeners: () => readonly (() => void)[];
+    readonly watchJobs: () => () => void;
+}
+/**
+ * The work that runs beside the conversation: background jobs and child agents.
+ *
+ * Neither is folded from the transcript. A job board is live state owned by a
+ * service, and a child's name arrives on its own event, so this owner keeps
+ * those reads and the two commands that show them in one place.
+ */
+export declare function createBackgroundWork(ctx: Context, ports: BackgroundWorkPorts): BackgroundWork;
+//# sourceMappingURL=background-work.d.ts.map

package/lib/surface/background-work.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-work.d.ts","sourceRoot":"","sources":["../../src/surface/background-work.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAML,KAAK,UAAU,EAChB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,cAAc,EAAgF,MAAM,iBAAiB,CAAA;AAO9H;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,QAAQ,GAAG,SAAS,CAAA;IACjD,QAAQ,CAAC,aAAa,EAAE,MAAM,SAAS,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAA;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;CACxC;AAED,8EAA8E;AAC9E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,SAAS,UAAU,EAAE,CAAA;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,IAAI,CAAA;IAChC,QAAQ,CAAC,mBAAmB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACxD,QAAQ,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACnD;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,CAAA;IACzD,QAAQ,CAAC,SAAS,EAAE,MAAM,MAAM,IAAI,CAAA;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAwI7F"}

package/lib/surface/background-work.js

@@ -0,0 +1,146 @@
+import { JOB_READ_LINES, createJobDirectory, describeJobs, parseJobsArgument, } from "../jobs.js";
+import { SubagentRoster, createSubagentControl, describeSubagents, parseSubagentsArgument, resolveRun } from "../subagents.js";
+/** Decode a lifecycle payload the roster only takes when it carries the shape it expects. */
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : undefined;
+}
+/**
+ * The work that runs beside the conversation: background jobs and child agents.
+ *
+ * Neither is folded from the transcript. A job board is live state owned by a
+ * service, and a child's name arrives on its own event, so this owner keeps
+ * those reads and the two commands that show them in one place.
+ */
+export function createBackgroundWork(ctx, ports) {
+    const jobDirectory = createJobDirectory(ctx);
+    let jobs = [];
+    const roster = new SubagentRoster();
+    const subagentControl = createSubagentControl(ctx);
+    /** Re-read the job board; it is live state, so nothing else can fold it. */
+    const refresh = () => {
+        const agent = ports.drivingAgent();
+        jobs = agent === undefined || jobDirectory === undefined ? [] : jobDirectory.list(agent.agent);
+        ports.render();
+    };
+    /**
+     * List or stop the delegations this session started.
+     *
+     * A child runs in the same process as an ordinary agent, so a stop is the
+     * cancel a reader's Ctrl+C sends to the parent; nothing here reaches into the
+     * child's own session, which keeps its own transcript either way.
+     */
+    const runSubagentsCommand = (argument) => {
+        const command = parseSubagentsArgument(argument);
+        switch (command.kind) {
+            case 'list':
+                ports.notice(describeSubagents(roster.list(), Date.now()));
+                ports.render();
+                return;
+            case 'open': {
+                const run = resolveRun(roster.list(), command.id);
+                if (run === undefined) {
+                    ports.notice(`${command.id}: no single child matches; /subagents lists them`);
+                    ports.render();
+                    return;
+                }
+                ports.navigate(run.id);
+                return;
+            }
+            case 'kill': {
+                const stopped = subagentControl?.stop(command.id) ?? false;
+                ports.notice(stopped
+                    ? `${command.id}: stop requested`
+                    : `${command.id}: no live child with that id`);
+                ports.render();
+                return;
+            }
+            case 'invalid':
+                ports.notice(`/subagents: ${command.reason}`);
+                ports.render();
+                return;
+        }
+    };
+    const runJobsCommand = (argument) => {
+        const agent = ports.drivingAgent();
+        if (jobDirectory === undefined) {
+            ports.notice('this profile has no job registry, so there is nothing to list');
+            ports.render();
+            return;
+        }
+        if (agent === undefined) {
+            ports.notice('the agent is still starting; try again in a moment');
+            ports.render();
+            return;
+        }
+        const command = parseJobsArgument(argument);
+        switch (command.kind) {
+            case 'list':
+                refresh();
+                ports.notice(describeJobs(jobs, Date.now()));
+                ports.render();
+                return;
+            case 'read': {
+                const result = jobDirectory.read(agent.agent, command.id);
+                const text = result?.text.trim() ?? '';
+                ports.notice(text === ''
+                    ? `${command.id}: no output yet`
+                    : `${command.id} output\n${text.split('\n').slice(-JOB_READ_LINES).join('\n')}`);
+                refresh();
+                return;
+            }
+            case 'kill': {
+                const outcome = jobDirectory.kill(agent.agent, command.id);
+                ports.notice(outcome === undefined
+                    ? `${command.id}: no such job`
+                    : outcome === 'requested' ? `${command.id}: stop requested` : `${command.id} had already finished`);
+                refresh();
+                return;
+            }
+            case 'invalid':
+                ports.notice(`/jobs: ${command.reason}`);
+                ports.render();
+                return;
+        }
+    };
+    /**
+     * Subagent lifecycle arrives as a service event rather than a session event,
+     * so it is decoration in the transcript: the parent's durable catalog
+     * carries the child's task. The name is cast so a rename in the
+     * harness cannot break compilation of this surface.
+     */
+    const listenFor = (name, handler) => ctx.on(name, handler);
+    return {
+        roster,
+        jobs: () => jobs,
+        refresh,
+        acceptCatalog: info => roster.catalog(info),
+        resetRoster: () => roster.reset(),
+        runSubagentsCommand,
+        runJobsCommand,
+        subagentListeners: () => [
+            listenFor('subagent/start', info => {
+                roster.start(info);
+                const record = asRecord(info);
+                const provider = typeof record?.provider === 'string' ? record.provider : 'subagent';
+                const id = typeof record?.id === 'string' ? record.id : '';
+                ports.marker(`subagent ${provider} started${id === '' ? '' : ` · ${id}`}`);
+                ports.render();
+            }),
+            listenFor('subagent/end', info => {
+                roster.end(info);
+                const record = asRecord(info);
+                const provider = typeof record?.provider === 'string' ? record.provider : 'subagent';
+                const stop = typeof record?.stopReason === 'string' ? record.stopReason : undefined;
+                ports.marker(`subagent ${provider} finished${stop === undefined ? '' : ` · ${stop}`}`);
+                ports.render();
+            }),
+        ],
+        // The board is live state: watch it directly rather than folding events.
+        watchJobs: () => jobDirectory?.watch(owner => {
+            if (owner !== undefined && owner.id !== ports.activeSession())
+                return;
+            refresh();
+        }) ?? (() => { }),
+    };
+}
+//# sourceMappingURL=background-work.js.map

package/lib/surface/background-work.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-work.js","sourceRoot":"","sources":["../../src/surface/background-work.ts"],"names":[],"mappings":"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"}

package/lib/surface/commands.d.ts

@@ -0,0 +1,80 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { PresetRoster } from '../agent/presets.ts';
+import type { RegisteredCommand } from '../input/completion.ts';
+import { type Submission } from '../input/submission.ts';
+import type { PromptStash } from '../stash.ts';
+import type { StatusFacts } from '../ui/status.ts';
+import type { Appearance } from './appearance.ts';
+import type { BackgroundWork } from './background-work.ts';
+import type { ModalInput } from './modal-input.ts';
+import type { ModelChoice } from './model-choice.ts';
+import type { PresetChoice, PresetLaunch } from './preset-choice.ts';
+import type { PromptMemory } from './prompt-memory.ts';
+import type { SessionLifecycle } from './session-lifecycle.ts';
+import type { SessionView } from './session-view.ts';
+import type { StagedTurns } from './staged-turns.ts';
+import type { TerminalLifecycle } from './terminal-lifecycle.ts';
+/**
+ * What the command plane needs from the surface that composes it.
+ *
+ * Each owner arrives whole, because this module is the one place that knows
+ * which of their operations a typed line, a chord, or the launch maps onto; the
+ * reads it takes of them are live, so a command typed after a session switch
+ * answers for the session now on screen. The launch facts and the mode roster
+ * are the two things no owner holds, and the notice and render sinks are what a
+ * refusal and a repaint are printed through.
+ */
+export interface CommandsPorts {
+    /** The launch this run was started for, and the mode its own flag named. */
+    readonly launch: PresetLaunch;
+    readonly preset: string | undefined;
+    /** The roster that can say whether a stored session's mode still exists. */
+    readonly presetRoster: PresetRoster | undefined;
+    /** A composition row that is missing, printed before the screen is taken. */
+    readonly missingOptional: () => string | undefined;
+    readonly session: SessionLifecycle;
+    readonly transcript: SessionView;
+    readonly route: ModelChoice;
+    readonly modes: PresetChoice;
+    readonly work: BackgroundWork;
+    readonly staged: StagedTurns;
+    readonly memory: PromptMemory;
+    readonly appearance: Appearance;
+    /** The terminal this surface owns, which is where a copy is written. */
+    readonly terminal: TerminalLifecycle;
+    /** The one modal interaction at a time, which lends its keyboard to a list. */
+    readonly modals: ModalInput;
+    readonly statusFacts: () => StatusFacts;
+    /** The bank the parked-draft commands read, late-bound behind the picker it needs. */
+    readonly stash: () => PromptStash | undefined;
+    readonly render: () => void;
+}
+/** The operations the composing surface routes back into the command plane. */
+export interface Commands {
+    /** Carry out one classified line, wherever it was asked for. */
+    readonly runSubmission: (submission: Submission) => void;
+    /**
+     * The commands one agent can run, or undefined when no registry answers.
+     *
+     * A scoped read rather than the registry itself: the registry stays with this
+     * owner, and completion only ever needs the names it offers.
+     */
+    readonly registeredCommands: (agent: Agent) => readonly RegisteredCommand[] | undefined;
+    /**
+     * Take the screen, then open the session this run was launched for.
+     *
+     * The launch belongs to this owner because the resume it may ask is the same
+     * question the resume command asks, answered by the same list.
+     */
+    readonly start: () => Promise<void>;
+}
+/**
+ * The router over everything the reader and the launcher can ask for.
+ *
+ * The registry is read from the composition rather than taken as a port: it is
+ * scoped to the agent in service, so its listing, lookup and dispatch all have
+ * to follow whichever agent the surface is driving now.
+ */
+export declare function createCommands(ctx: Context, ports: CommandsPorts): Commands;
+//# sourceMappingURL=commands.d.ts.map