@deepseek-harness-tui/dsh-tui 0.12.0 → 0.13.0

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

@@ -31,11 +31,13 @@ import { ensurePackagedPresets } from './packaged-presets.js';
 import { registerBundledPresets } from './bundled-presets.js';
 import { ensureLegacySessionEventTypes, snapshotLiveSessionEvents } from './compat/index.js';
 import { clearResumeTarget, resumeTargetFromArgv, writeResumeTarget } from '../sessionHistory.js';
+import { initialPromptFromCmdlineArgs } from './startup-args.js';
 import { readHomePrefs } from '../homePrefs.js';
+import { shouldOfferOnboarding } from '../onboardingPrefs.js';
 import { resolveSessionCwd } from '../utils/workspaceRoot.js';
 import { beginRestartAttempt, checkForTuiUpdate, installedTuiVersion, isBootDeadlockTarget, isStandaloneRuntime, isVersionNewer, logRestartEvent, resolveDshProfileName, resolveTuiUpdateTarget, restartTui, updateTuiAndRestart, writeHandoffNotice } from '../update.js';
 import { getLang, isLang, resolveStartupLang, setLang, t, writeLangPref } from '../i18n.js';
-import { DEFAULT_PAGE_MARGIN, DEFAULT_STATUS_BAR, applyImageBacking, applyMathImageBacking, applyMathImageScale, applyMathRendering, applyMermaidDiagrams, applyPageMargin, isPageMarginMode, normalizePageMargin, normalizeScrollGutter, normalizeStatusBar, normalizeToolBackground, parsePageMarginSpec, resolveMathRendering } from '../tuiDisplayPrefs.js';
+import { DEFAULT_PAGE_MARGIN, DEFAULT_SIDE_PANEL_IDS, DEFAULT_STATUS_BAR, SIDE_PANEL_ID_PATTERN, applyCompanionSkin, applyImageBacking, applyMathImageBacking, applyMathImageScale, applyMathRendering, applyMermaidDiagrams, applyPageMargin, applySidePanelOpen, applySidePanelPanels, applySidePanelRatio, applySidePanelSplitEnabled, isPageMarginMode, normalizeJobGroupFold, normalizePageMargin, normalizeScrollGutter, normalizeSidePanelPanels, normalizeStatusBar, normalizeToolBackground, parsePageMarginSpec, resolveMathRendering } from '../tuiDisplayPrefs.js';
 import { draftComboConflicts, effectiveComboString, parseComboDraft, setKeymapOverrides, SHORTCUT_ACTIONS, } from '../utils/keymap.js';
 import { attachHerdrIntegration } from '../herdr.js';
 import { logMouseDebug } from '../utils/debug.js';
@@ -46,6 +48,7 @@ import { reserveMount } from '../sessionMounts.js';
 import { getHostDialogStore } from './dialogs.js';
 import { getHostStatusStore } from './status.js';
 import { createActivityStore } from './activity-store.js';
+import { createContextOccupancyStore } from './context-occupancy.js';
 import { getHostToastStore } from './toast.js';
 import { getHostShortcuts } from './shortcuts.js';
 import { getHostThemes } from './themes.js';
@@ -86,39 +89,28 @@ import { fatalReasonForExit, registerProcessGuardFatalSink } from '../ink/update
 let lastBootedFullscreen;
 // Image preferences also stay fixed across host recomposes until /restart.
 let lastBootedTerminalImages;
+// Kept importable from here: the startup parser moved to its own dependency-free
+// module so argv probes can load it without the whole plugin graph.
+export { initialPromptFromCmdlineArgs };
 /**
  * Extract the startup prompt from raw app argv, excluding session selectors
  * and Web startup flag values. `--trusted-host` consumes multiple authorities
  * up to the next flag; none of them are prompt text (issue #882). An app-level
  * `--` ends flag parsing; all following tokens are literal prompt text.
  */
-export function initialPromptFromCmdlineArgs(args) {
-    if (args === undefined)
-        return '';
-    const promptArgs = [];
-    for (let i = 0; i < args.length; i += 1) {
-        const arg = args[i];
-        if (arg === '--') {
-            promptArgs.push(...args.slice(i + 1));
-            break;
-        }
-        if (arg === '--resume' || arg === '--host' || arg === '--port') {
-            if (args[i + 1] !== undefined && !args[i + 1].startsWith('-'))
-                i += 1;
-            continue;
-        }
-        if (arg === '--trusted-host') {
-            while (args[i + 1] !== undefined && !args[i + 1].startsWith('-'))
-                i += 1;
-            continue;
-        }
-        if (arg.startsWith('--resume='))
-            continue;
-        if (arg.startsWith('-'))
-            continue;
-        promptArgs.push(arg);
-    }
-    return promptArgs.join(' ').trim();
+/**
+ * 落地页 / 首启引导该不该在这次启动出现。
+ *
+ * 只看「用户有没有说要回到哪儿」：`--resume` 目标与首句都算他知道自己要去哪。
+ * **工作区目标不算**——`dst` 默认把 cwd 当工作区目标喂进来，算进去就等于在本机
+ * 最主流的启动方式下把这两个屏永久关掉（实测事故，见调用点的口径注释）。
+ *
+ * @param input.launchSessionId - 本次要恢复的会话（--resume / DSH_TUI_RESUME_SESSION）。
+ * @param input.initialPrompt - 命令行里带的首句提示词（无则空串）。
+ * @returns true 表示这次是「普通启动」。
+ */
+export function isLandingLaunch(input) {
+    return input.launchSessionId === undefined && input.initialPrompt === '';
 }
 export function resolveTuiHostMode(stdoutIsTTY = process.stdout.isTTY === true, env = process.env) {
     if (stdoutIsTTY) {
@@ -384,6 +376,14 @@ export async function apply(ctx, runtimeConfig, configOwner = ctx) {
         ctx.logger.warn('dsh-tui: tuiScenes service is not mounted; plugin scenes will never open. ' +
             'The bundle patch is older than the installed dsh-tui package — update the globally installed dsh-tui launcher to match the profile (issue #183).');
     }
+    // Same skew guard for the side-panel registry (dsh-tui-panels row): the
+    // tuiPanels runtime is what admits plugin panels into the PanelStore, so
+    // register() warns and returns undefined for every plugin when the row is
+    // absent — say why on profile launches.
+    if (ctx.get('tuiPanels') === undefined && resolveDshProfileName() !== undefined) {
+        ctx.logger.warn('dsh-tui: tuiPanels service is not mounted; plugin side panels will never register. ' +
+            'The bundle patch is older than the installed dsh-tui package — update the globally installed dsh-tui launcher to match the profile (issue #183).');
+    }
     // Same skew guard for the plugin-UI services (dsh-tui-extensions row):
     // managed dialogs park unanswered, status contributions never render,
     // shortcuts never match, custom-entry renderers stay invisible, and runtime
@@ -471,6 +471,13 @@ export async function apply(ctx, runtimeConfig, configOwner = ctx) {
     // (the runtime `/activity` command only changes the preset), so a hidden
     // line attaches nothing at all — no feed, no 500ms tick.
     const activityStore = createActivityStore(ctx, config.activity !== false);
+    // Read side of the token meter's `contextPressure` unit: the ONE occupancy
+    // source for the footer, the segmented bar, the status commands and the
+    // context-low warning. Created unconditionally (unlike the activity store,
+    // there is no config gate: hiding the bar must not make the warning or the
+    // footer read a stale sample). A composition without the meter leaves it
+    // empty and the channel falls back to the last-request sample.
+    const contextOccupancyStore = createContextOccupancyStore(ctx);
     const rawChannel = createChannel(ctx, agent, {
         // The namespace this boot actually registered the settings section under
         // (the Config owner's Loader id; custom ids are supported). Chat and the
@@ -481,6 +488,10 @@ export async function apply(ctx, runtimeConfig, configOwner = ctx) {
         // soon as this session binds so a resumed or reattached session renders its
         // line immediately instead of waiting for the next event.
         seedActivity: session => activityStore.seed(session),
+        // Same reason as the activity line: the occupancy projection only pushes on
+        // change, so a resumed session reads one baseline at bind time.
+        contextPressure: contextOccupancyStore,
+        seedContextOccupancy: session => contextOccupancyStore.seed(session),
         // A RESUMED session keeps its persisted header cwd (issue #96 review):
         // pre-upgrade sessions recorded the launch directory, and re-resolving
         // from the current launch directory would split @ expansion / file
@@ -515,6 +526,7 @@ export async function apply(ctx, runtimeConfig, configOwner = ctx) {
         // screen edits this key live through the dsh-tui namespace.
         diffLayout: config.diffLayout,
         thinkingFold: config.thinkingFold,
+        jobGroupFold: config.jobGroupFold,
         toolBackground: config.toolBackground,
         scrollGutter: config.scrollGutter,
         pageMargin: config.pageMargin,
@@ -564,6 +576,15 @@ export async function apply(ctx, runtimeConfig, configOwner = ctx) {
     // mermaid and LaTeX switches ride the same kind of store (Markdown is
     // memoized by content, so no prop reaches the diagram/formula nodes).
     applyPageMargin(config.pageMargin);
+    // Side panel (settings `dsh-tui.sidePanel.*`): same reason as pageMargin —
+    // the useSidePanel controller reads these module-level stores ABOVE the
+    // channel's version bump, so a Ctrl+B toggle re-renders Chat without any
+    // session change. applyDisplay below mirrors every settings edit into them.
+    applySidePanelSplitEnabled(config.sidePanel?.splitEnabled);
+    applySidePanelOpen(config.sidePanel?.open);
+    applySidePanelRatio(config.sidePanel?.ratio);
+    applySidePanelPanels(config.sidePanel?.panels);
+    applyCompanionSkin(config.companion?.skin);
     applyMermaidDiagrams(config.mermaidDiagrams);
     applyMathRendering(resolveMathRendering({}, config));
     applyMathImageScale(config.mathImageScale ?? 'auto');
@@ -613,6 +634,7 @@ export async function apply(ctx, runtimeConfig, configOwner = ctx) {
         const scope = createSettingsScope(configOwner, settingsCtx.settings, tuiSettingsNs, Schema.object({
             diffLayout: Schema.union(['auto', 'split', 'unified']).default('auto'),
             thinkingFold: Schema.union(['preview', 'full']).default('preview'),
+            jobGroupFold: Schema.union(['auto', 'always', 'never']).default('auto'),
             toolBackground: Schema.union(['none', 'subtle', 'strong']).default('none'),
             scrollGutter: Schema.union(['timeline', 'scrollbar', 'hidden']).default('timeline'),
             // Preset names AND custom `NxM` specs (the settings field's parse
@@ -657,6 +679,7 @@ export async function apply(ctx, runtimeConfig, configOwner = ctx) {
                 contextUsage: Schema.boolean().default(DEFAULT_STATUS_BAR.contextUsage),
                 cache: Schema.boolean().default(DEFAULT_STATUS_BAR.cache),
                 tokens: Schema.boolean().default(DEFAULT_STATUS_BAR.tokens),
+                cost: Schema.boolean().default(DEFAULT_STATUS_BAR.cost),
                 tps: Schema.boolean().default(DEFAULT_STATUS_BAR.tps),
                 gitBranch: Schema.boolean().default(DEFAULT_STATUS_BAR.gitBranch),
                 sessionTitle: Schema.boolean().default(DEFAULT_STATUS_BAR.sessionTitle),
@@ -668,6 +691,22 @@ export async function apply(ctx, runtimeConfig, configOwner = ctx) {
                 trajectory: Schema.boolean().default(DEFAULT_STATUS_BAR.trajectory),
                 shortcutHint: Schema.boolean().default(DEFAULT_STATUS_BAR.shortcutHint),
             }).default({ ...DEFAULT_STATUS_BAR }),
+            // Side-panel preferences. No schema defaults on purpose (same rule as
+            // foldTerminalCommand/expandEditor above): a default here would come
+            // back from scope.get()/watch() and shadow an explicit cordis.yml
+            // `sidePanel` block while the user layer is unset. applyDisplay
+            // resolves `?? config.sidePanel?.x` and the apply* stores normalize
+            // undefined to the documented defaults (true / false / 0.68 / the
+            // built-in panel trio).
+            sidePanel: Schema.object({
+                splitEnabled: Schema.boolean(),
+                open: Schema.boolean(),
+                ratio: Schema.number(),
+                panels: Schema.string(),
+            }),
+            companion: Schema.object({
+                skin: Schema.string(),
+            }),
             // Header pixel whale art; on unless settings.yaml says otherwise.
             whale: Schema.boolean().default(true),
             // Idle whale behaviors after the intro settles; on by default —
@@ -762,6 +801,7 @@ export async function apply(ctx, runtimeConfig, configOwner = ctx) {
             if (shadow)
                 return;
             channel.setThinkingFold(value.thinkingFold ?? config.thinkingFold ?? 'preview');
+            channel.setJobGroupFold(normalizeJobGroupFold(value.jobGroupFold ?? config.jobGroupFold));
             channel.setToolBackground(normalizeToolBackground(value.toolBackground ?? config.toolBackground));
             channel.setScrollGutter(normalizeScrollGutter(value.scrollGutter ?? config.scrollGutter));
             // Page margin: the channel carries the mode (tests observe it), the
@@ -780,6 +820,15 @@ export async function apply(ctx, runtimeConfig, configOwner = ctx) {
             applyMathImageBacking(value.mathImageBacking ?? config.mathImageBacking ?? 'transparent');
             applyImageBacking(value.imageBacking ?? config.imageBacking ?? 'transparent');
             channel.setStatusBar(normalizeStatusBar(value.statusBar ?? config.statusBar));
+            // Side panel: no channel member — the layout owns module-level stores
+            // (they sit above the channel's version bump), so /settings writes them
+            // directly and useSidePanel's own subscriptions re-lay out at once. An
+            // unset user layer falls back to cordis.yml, then to the store default.
+            applySidePanelSplitEnabled(value.sidePanel?.splitEnabled ?? config.sidePanel?.splitEnabled);
+            applySidePanelOpen(value.sidePanel?.open ?? config.sidePanel?.open);
+            applySidePanelRatio(value.sidePanel?.ratio ?? config.sidePanel?.ratio);
+            applySidePanelPanels(value.sidePanel?.panels ?? config.sidePanel?.panels);
+            applyCompanionSkin(value.companion?.skin ?? config.companion?.skin);
         };
         // Legacy user scopes layer over cordis.yml. Modern Config is already
         // resolved: an unset action must not revive its startup override.
@@ -953,6 +1002,9 @@ export async function apply(ctx, runtimeConfig, configOwner = ctx) {
                 {
                     ...settingField('thinkingFold'),
                 },
+                {
+                    ...settingField('jobGroupFold'),
+                },
                 {
                     ...settingField('toolBackground'),
                 },
@@ -1093,6 +1145,66 @@ export async function apply(ctx, runtimeConfig, configOwner = ctx) {
                 {
                     ...settingField('statusBar.shortcutHint'),
                 },
+                {
+                    ...settingField('sidePanel.splitEnabled'),
+                    format(value) {
+                        // Unset in the user layer: the effective default is on.
+                        return String(typeof value === 'boolean' ? value : config.sidePanel?.splitEnabled !== false);
+                    },
+                },
+                {
+                    ...settingField('sidePanel.open'),
+                    format(value) {
+                        // Unset in the user layer: the effective default is off.
+                        return String(typeof value === 'boolean' ? value : config.sidePanel?.open === true);
+                    },
+                },
+                {
+                    ...settingField('sidePanel.ratio'),
+                    placeholder: '0.68',
+                    format(value) {
+                        // Unset in the user layer: show the effective fraction.
+                        const ratio = typeof value === 'number' && Number.isFinite(value) ? value : config.sidePanel?.ratio;
+                        return String(ratio ?? 0.68);
+                    },
+                    parse(text) {
+                        const draft = text.trim();
+                        if (draft === '')
+                            return { kind: 'clear' };
+                        const ratio = Number(draft);
+                        // Range gate mirrors the geometry contract (0.1–0.95): an
+                        // out-of-range draft would be silently clamped by the store, so
+                        // refuse it and let the editor keep the error badge instead.
+                        if (!Number.isFinite(ratio) || ratio < 0.1 || ratio > 0.95)
+                            return undefined;
+                        return { kind: 'set', value: ratio };
+                    },
+                },
+                {
+                    ...settingField('sidePanel.panels'),
+                    placeholder: DEFAULT_SIDE_PANEL_IDS,
+                    format(value) {
+                        // Unset in the user layer: show the effective list.
+                        return typeof value === 'string' && value.trim() !== ''
+                            ? value
+                            : config.sidePanel?.panels ?? DEFAULT_SIDE_PANEL_IDS;
+                    },
+                    parse(text) {
+                        const draft = text.trim();
+                        if (draft === '')
+                            return { kind: 'clear' };
+                        // Strict gate: every token must be a well-formed panel id. The
+                        // store would drop a typo silently, so a draft that does not
+                        // round-trip is refused instead of saved as something else.
+                        const tokens = draft.split(',').map(token => token.trim().toLowerCase()).filter(token => token !== '');
+                        if (tokens.length === 0 || tokens.some(token => !SIDE_PANEL_ID_PATTERN.test(token)))
+                            return undefined;
+                        return { kind: 'set', value: normalizeSidePanelPanels(draft) };
+                    },
+                },
+                {
+                    ...settingField('companion.skin'),
+                },
                 {
                     ...settingField('whale'),
                 },
@@ -1328,10 +1440,33 @@ export async function apply(ctx, runtimeConfig, configOwner = ctx) {
      * so a process that dies before the first frame does not consume it.
      */
     const homeSeen = readHomePrefs().seen === true;
-    const openHomeOnBoot = !homeSeen
-        && launchSessionId === undefined
-        && requestedWorkspace === undefined
-        && initialPrompt === '';
+    /**
+     * 「普通启动」在这里有两档口径，差在**工作区目标算不算**：
+     *
+     *   - 落地页与首启引导只认「没说要回到哪儿」：没有 resume 目标、没有首句。
+     *   - home（会话与工作区）还多认一条「没说在哪儿干活」——那一屏问的就是这个。
+     *
+     * 工作区目标**不能**进前者的判定：`dst` 那类 launcher 默认把 cwd 当工作区
+     * 目标喂进来（D:/node/dst.cmd 里 set DSH_TUI_WORKSPACE_TARGET=%CD%），一旦
+     * 算进去，落地页在本机最主流的启动方式下**永远不出**——用户实测「既没看到
+     * ob 也没看到 lp」的根因就是这一条。
+     */
+    const noResume = isLandingLaunch({ launchSessionId, initialPrompt });
+    const openHomeOnBoot = !homeSeen && noResume && requestedWorkspace === undefined;
+    /**
+     * The launchpad is NOT one-shot the way the workspace home is: every
+     * ordinary launch starts on it, because it is where the first sentence gets
+     * typed rather than a tutorial that retires itself. `DSH_TUI_NO_LAUNCHPAD=1`
+     * is the escape hatch (an automation that wants the old blank conversation
+     * and no dialog in front of it).
+     */
+    const launchpadOnBoot = noResume && process.env.DSH_TUI_NO_LAUNCHPAD !== '1';
+    /**
+     * The first-run guide. Gated on its own preference (not on `homeSeen`): the
+     * two answer different questions, and an install that already knows its
+     * workspace may still never have configured a key.
+     */
+    const onboardingOnBoot = noResume && shouldOfferOnboarding();
     const chat = React.createElement(Chat, {
         channel,
         renderScene: createChannelSceneOutlet(() => rawChannel.pluginScene),
@@ -1339,6 +1474,8 @@ export async function apply(ctx, runtimeConfig, configOwner = ctx) {
         approvalStore,
         injectControllerRef,
         openHomeOnBoot,
+        launchpadOnBoot,
+        onboardingOnBoot,
         // 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.

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

@@ -79,12 +79,32 @@ export declare function runningPresetOf(session: unknown): string | undefined;
  */
 export declare function resolvePersistedRoute(ctx: Context, sessionId: SessionId): Promise<ModelRoute | undefined>;
 /**
- * Keep the official Minimal preset's model-facing catalog minimal. The preset
- * itself declares exactly one persistent shell tool (bash on POSIX, pwsh on
- * Windows), while the TUI mounts ask_user_question at the host layer so every
- * other preset (including user presets) can use its questionnaire UI —
- * that host-layer tool otherwise merges into Minimal's scoped catalog as an
- * extra tool.
+ * Whether the host-layer `ask_user_question` tool must stay invisible to one
+ * preset's model-facing catalog.
+ *
+ * The official Minimal preset is a single-persistent-shell trajectory
+ * (`@deepseek-ai/dsh-web-app/presets/minimal.patch.yml`: `persona` +
+ * `persistent-shell`, i.e. bash on POSIX / pwsh on Windows — `str_replace_editor`
+ * has been opt-in since 0.1.3-alpha.2), while the TUI mounts
+ * ask_user_question at the HOST layer so every other preset (including user
+ * presets) can use its questionnaire UI; that host-layer tool otherwise merges
+ * into Minimal's scoped catalog as an extra tool.
+ *
+ * The recorded preset id is the only signal available at the assembly
+ * boundary: the composition exposes no per-tool manifest, and a host tool's
+ * presence in the tool registry cannot tell whether a preset declared it. This
+ * is therefore the ONE preset-id read in the capability path, shared with
+ * `resolveAgentCapabilities` so advertisement and assembly agree, and pinned
+ * by `verify:minimal-preset-tools`.
+ *
+ * @param presetId - Preset recorded for the requesting session.
+ * @returns True when the host-layer tool must be filtered out of the assembly.
+ */
+export declare function presetHidesHostAskTool(presetId: string | undefined): boolean;
+/**
+ * Keep the official Minimal preset's model-facing catalog minimal: it declares
+ * exactly one persistent shell tool, and the host-mounted ask_user_question
+ * must not become a second one.
  *
  * This is a per-assembly filter rather than a startup-time decision because
  * one TUI process can resume, create, or recompose sessions under different

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

@@ -1 +1 @@
-{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAWtE,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAA;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmBhG;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW5G;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGpE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAW/G;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAM/G;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAKpG"}
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAWtE,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAA;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmBhG;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW5G;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGpE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAW/G;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE5E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAM/G;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAKpG"}

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

@@ -120,12 +120,34 @@ export async function resolvePersistedRoute(ctx, sessionId) {
     }
 }
 /**
- * Keep the official Minimal preset's model-facing catalog minimal. The preset
- * itself declares exactly one persistent shell tool (bash on POSIX, pwsh on
- * Windows), while the TUI mounts ask_user_question at the host layer so every
- * other preset (including user presets) can use its questionnaire UI —
- * that host-layer tool otherwise merges into Minimal's scoped catalog as an
- * extra tool.
+ * Whether the host-layer `ask_user_question` tool must stay invisible to one
+ * preset's model-facing catalog.
+ *
+ * The official Minimal preset is a single-persistent-shell trajectory
+ * (`@deepseek-ai/dsh-web-app/presets/minimal.patch.yml`: `persona` +
+ * `persistent-shell`, i.e. bash on POSIX / pwsh on Windows — `str_replace_editor`
+ * has been opt-in since 0.1.3-alpha.2), while the TUI mounts
+ * ask_user_question at the HOST layer so every other preset (including user
+ * presets) can use its questionnaire UI; that host-layer tool otherwise merges
+ * into Minimal's scoped catalog as an extra tool.
+ *
+ * The recorded preset id is the only signal available at the assembly
+ * boundary: the composition exposes no per-tool manifest, and a host tool's
+ * presence in the tool registry cannot tell whether a preset declared it. This
+ * is therefore the ONE preset-id read in the capability path, shared with
+ * `resolveAgentCapabilities` so advertisement and assembly agree, and pinned
+ * by `verify:minimal-preset-tools`.
+ *
+ * @param presetId - Preset recorded for the requesting session.
+ * @returns True when the host-layer tool must be filtered out of the assembly.
+ */
+export function presetHidesHostAskTool(presetId) {
+    return presetId === 'minimal';
+}
+/**
+ * Keep the official Minimal preset's model-facing catalog minimal: it declares
+ * exactly one persistent shell tool, and the host-mounted ask_user_question
+ * must not become a second one.
  *
  * This is a per-assembly filter rather than a startup-time decision because
  * one TUI process can resume, create, or recompose sessions under different
@@ -136,7 +158,7 @@ export async function resolvePersistedRoute(ctx, sessionId) {
  * @returns The original assembly, except ask_user_question is absent in Minimal.
  */
 export function filterMinimalPresetTools(assembly, presetId) {
-    if (presetId !== 'minimal' || !assembly.tools.some(tool => tool.name === ASK_USER_TOOL))
+    if (!presetHidesHostAskTool(presetId) || !assembly.tools.some(tool => tool.name === ASK_USER_TOOL))
         return assembly;
     return {
         ...assembly,

package/lib/types/dsh-adapter/startup-args.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Extract the startup prompt from raw app argv, excluding session selectors
+ * and Web startup flag values. `--trusted-host` consumes multiple authorities
+ * up to the next flag; none of them are prompt text (issue #882). An app-level
+ * `--` ends flag parsing; all following tokens are literal prompt text.
+ */
+export declare function initialPromptFromCmdlineArgs(args: readonly string[] | undefined): string;
+//# sourceMappingURL=startup-args.d.ts.map

package/lib/types/dsh-adapter/startup-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-args.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/startup-args.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,CAsBxF"}

package/lib/types/dsh-adapter/startup-args.js

@@ -0,0 +1,34 @@
+/**
+ * Extract the startup prompt from raw app argv, excluding session selectors
+ * and Web startup flag values. `--trusted-host` consumes multiple authorities
+ * up to the next flag; none of them are prompt text (issue #882). An app-level
+ * `--` ends flag parsing; all following tokens are literal prompt text.
+ */
+export function initialPromptFromCmdlineArgs(args) {
+    if (args === undefined)
+        return '';
+    const promptArgs = [];
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === '--') {
+            promptArgs.push(...args.slice(i + 1));
+            break;
+        }
+        if (arg === '--resume' || arg === '--host' || arg === '--port') {
+            if (args[i + 1] !== undefined && !args[i + 1].startsWith('-'))
+                i += 1;
+            continue;
+        }
+        if (arg === '--trusted-host') {
+            while (args[i + 1] !== undefined && !args[i + 1].startsWith('-'))
+                i += 1;
+            continue;
+        }
+        if (arg.startsWith('--resume='))
+            continue;
+        if (arg.startsWith('-'))
+            continue;
+        promptArgs.push(arg);
+    }
+    return promptArgs.join(' ').trim();
+}

package/lib/types/history.d.ts

@@ -3,32 +3,49 @@ export type HistoryEntry = {
     text: string;
     /** Unix ms timestamp. */
     ts: number;
+    /**
+     * Normalized workspace cwd the input was submitted in. Absent on entries
+     * written before history became project-scoped; those legacy entries stay
+     * visible in every project until that project's own entries push them out
+     * of the `HISTORY_LIMIT` window.
+     */
+    project?: string;
 };
 /**
- * Entry cap for the persisted history. `↑`/`↓` and the Ctrl+R overlay read
- * the same file, so both depths come from this one number.
+ * Per-project entry cap. `↑`/`↓` and the Ctrl+R overlay read the same file,
+ * so both depths come from this one number.
  */
 export declare const HISTORY_LIMIT = 200;
 /**
- * Append an input to the persisted history, deduping the immediately
- * previous entry and capping the file at `HISTORY_LIMIT` entries.
+ * Project key for a workspace cwd: absolute, forward slashes, no trailing
+ * slash, case-folded on Windows (whose filesystem is case-insensitive).
+ * @param cwd - Workspace cwd; blank means unscoped.
+ * @returns The normalized key, or `undefined` when unscoped.
+ */
+export declare function historyProjectKey(cwd: string | undefined): string | undefined;
+/**
+ * Append an input to the persisted history, deduping the project's
+ * immediately previous entry and capping each project at `HISTORY_LIMIT`.
  * @param text - Input to persist; blank inputs are ignored.
+ * @param cwd - Workspace cwd the input belongs to; omitted = unscoped.
  * @returns Resolves once this entry is persisted; callers on the input path
  * intentionally discard it because persistence is best-effort.
  */
-export declare function appendHistory(text: string): Promise<void>;
+export declare function appendHistory(text: string, cwd?: string): Promise<void>;
 /**
  * Read the persisted history, newest first.
+ * @param cwd - Workspace cwd to scope to; omitted = every project.
  * @returns The persisted entries in reverse-chronological order.
  */
-export declare function loadHistory(): HistoryEntry[];
+export declare function loadHistory(cwd?: string): HistoryEntry[];
 /**
  * Read the persisted history in the order the composer walks it: oldest
  * first, so `↑` reaches the newest entry first (the list tail) exactly as it
  * does for the entries this process pushed itself.
+ * @param cwd - Workspace cwd to scope to; omitted = every project.
  * @returns The persisted entries in chronological order.
  */
-export declare function loadHistoryOldestFirst(): HistoryEntry[];
+export declare function loadHistoryOldestFirst(cwd?: string): HistoryEntry[];
 /**
  * Stable id for a history entry (keeps React keys distinct across identical texts).
  * @param entry - The history entry to hash.

package/lib/types/history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/history.ts"],"names":[],"mappings":"AAWA,yCAAyC;AACzC,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAA;CACX,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,MAAM,CAAA;AAuHhC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzD;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,YAAY,EAAE,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,EAAE,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,SAAI,GAAG,MAAM,CAErE"}
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/history.ts"],"names":[],"mappings":"AAWA,yCAAyC;AACzC,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAA;IACV;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,MAAM,CAAA;AA+ChC;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAI7E;AA6GD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASvE;AAWD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,SAAI,GAAG,MAAM,CAErE"}