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

package/lib/types/dsh-adapter/channel/binding-events.js

@@ -1,4 +1,7 @@
 import { carrierKeyOf } from '@deepseek-ai/dsh-scope';
+import { t } from '../../i18n.js';
+import { runningPresetOf } from '../presets.js';
+import { agentCapabilityEvidence, resolveAgentCapabilities } from './capabilities.js';
 import { isTokenDelta, tokenDeltaChars } from './usage.js';
 /**
  * Foreground transcript listeners capture a binding generation. Child event
@@ -8,6 +11,41 @@ import { isTokenDelta, tokenDeltaChars } from './usage.js';
  */
 export function createBindingEvents(ctx, deps) {
     let subagentsInstalled = false;
+    /**
+     * Preset of the last binding we announced a capability gap for. The gap is a
+     * property of the agent's PRESET, so it is reported once per entry into a
+     * preset that lacks it (a rebind to the SAME preset — /model, /rewind —
+     * stays quiet; switching away and back reports again). Facts come from
+     * `channel/capabilities.ts`, never from a preset-id list: a user preset that
+     * adds compaction/pruning back gets no warning at all.
+     *
+     * A session recording NO preset (rosterless bare `cordis.yml`, or an embed
+     * that composes its own leaf) stays silent: nothing there attributes the
+     * missing services to a preset choice, and the command-list annotation plus
+     * the use-time refusal already say it when it matters. Only the id, not its
+     * contents, is read here.
+     */
+    let announcedPreset;
+    let announced = false;
+    const announceCapabilityGap = () => {
+        const agent = deps.binding.agent;
+        const presetId = runningPresetOf(agent.session);
+        if (presetId === undefined)
+            return;
+        if (announced && presetId === announcedPreset)
+            return;
+        announced = true;
+        announcedPreset = presetId;
+        const capabilities = resolveAgentCapabilities(agentCapabilityEvidence(ctx, agent));
+        if (capabilities.compaction && capabilities.pruner)
+            return;
+        const key = capabilities.compaction
+            ? 'capability-gap-pruner'
+            : capabilities.pruner
+                ? 'capability-gap-compaction'
+                : 'capability-gap-compaction-pruner';
+        deps.state.notify(t(key), { color: 'warning', timeoutMs: 12000 });
+    };
     const installSubagents = () => {
         if (subagentsInstalled)
             return;
@@ -56,6 +94,7 @@ export function createBindingEvents(ctx, deps) {
             deps.inputConvergence.cancelInFlight = false;
             deps.inputConvergence.interruptSeq += 1;
             deps.seedActivity?.(deps.binding.agent.session);
+            deps.seedContextOccupancy?.(deps.binding.agent.session);
             deps.modelActions.selection.current = undefined;
             deps.modelActions.selection.assembled = undefined;
             if (deps.binding.agent.options?.model === undefined && deps.state.provider !== '' && deps.state.model !== '') {
@@ -63,6 +102,10 @@ export function createBindingEvents(ctx, deps) {
             }
             void deps.modelActions.applyPreferredEffort();
             deps.modeActions.refreshMode();
+            // Entering/resuming a session whose preset serves neither automatic
+            // compaction nor tool-result pruning changes what the user can expect
+            // from a long session; say it once, here, before the turn starts.
+            announceCapabilityGap();
             const capture = deps.binding.capture();
             const session = capture.agent.session;
             const current = () => deps.owner.current() && deps.binding.isCurrent(capture);

package/lib/types/dsh-adapter/channel/capabilities.d.ts

@@ -0,0 +1,82 @@
+/**
+ * One place that answers "can this agent actually do X?", with the evidence
+ * for every answer.
+ *
+ * The TUI used to answer that question three different ways: `/permission`
+ * read the merged command list or the permission-presets snapshot, `/plan`
+ * read the command list only, and `/compact` asked nothing at all — so a
+ * command could look available (Help, `/` completion) and then fail on use.
+ * Every consumer now reads these facts: Chat's command switch, the
+ * session-mode actions, and the Help/completion annotation applied where the
+ * command list is built (`annotateCommandCapabilities`).
+ *
+ * Resolution is FACT-based on purpose. Each fact is read from the live service
+ * the agent's own scope chain resolves (`presets.serviceForAgent`, which
+ * mirrors the official host's `agentPresets.serviceFor(agent, key) ??
+ * ctx.get(key)`), never from a preset-id table — a user preset that adds
+ * compaction/pruning back gets the full feature set with no TUI change. The
+ * single preset-id read left is the official Minimal `ask_user_question`
+ * carve-out, and it lives in `presets.ts` (one source, pinned by
+ * `verify:minimal-preset-tools`).
+ *
+ * Evidence per fact:
+ *   compaction     `serviceForAgent(ctx, agent, 'compaction')` exposing
+ *                  `compactNow` — the same seam the TUI transaction and the
+ *                  official `/compact` command both call;
+ *   pruner         `serviceForAgent(ctx, agent, 'toolResultPruner')`;
+ *   skills         `serviceForAgent(ctx, agent, 'skills')`;
+ *   compact/plan   the DSH command registry (`commands.find(agent, name)`,
+ *                  scope-correct: same name in another scope is not this
+ *                  agent's command). `/compact` prefers the TUI's own
+ *                  transaction whenever the compaction service exists, because
+ *                  that path owns the `tui/compact` decision event, the
+ *                  progress row, Esc cancellation and the session-switch
+ *                  settle; it falls back to the registry command only when the
+ *                  local path cannot run.
+ */
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { Context } from '@deepseek-ai/cordis';
+import type { CommandRuntime } from '@deepseek-ai/dsh-commands';
+import type { AgentCapabilities } from '../../adapter/ports/channel-capabilities.js';
+import type { LocalCommand } from '../../commands.js';
+/**
+ * Everything the resolver reads, passed in explicitly so the decision can be
+ * driven from fixtures (the focused regression) instead of a live composition.
+ */
+export interface CapabilityEvidence {
+    /** The live agent whose composition is described; undefined before a bind. */
+    readonly agent: Agent | undefined;
+    /** `ctx.commands` (the DSH command registry), undefined without the row. */
+    readonly commandService: CommandRuntime | undefined;
+    /** Read one service the way the agent sees it (preset scope chain first). */
+    readonly service: (key: string) => unknown;
+    /** Whether the agent's scoped tool catalog carries one model-facing tool. */
+    readonly toolPresent: (name: string) => boolean;
+    /** The preset recorded for the agent (only the Minimal carve-out reads it). */
+    readonly presetId: string | undefined;
+}
+/**
+ * Resolve the facts for one agent.
+ *
+ * @param evidence - The live reads described on {@link CapabilityEvidence}.
+ * @returns Facts plus, for a missing route, the i18n key naming the reason.
+ */
+export declare function resolveAgentCapabilities(evidence: CapabilityEvidence): AgentCapabilities;
+/** The live evidence bag for one agent, read through its preset scope chain. */
+export declare function agentCapabilityEvidence(ctx: Context, agent: Agent | undefined): CapabilityEvidence;
+/**
+ * Mark the commands whose capability route is `none` so Help and `/`
+ * completion state that instead of advertising a command that can only fail.
+ *
+ * The marker is a `descriptionKey` override, so `localizedDescription`
+ * resolves it at render time (`/lang` applies immediately) and every list
+ * consumer — Help menu, suggestion overlay, i18n verifier — picks it up with
+ * no new UI mode. The command stays dispatchable: removing it from the list
+ * would silently forward `/compact` to the model as a plain message.
+ *
+ * @param commands - The merged command list (locals + registry).
+ * @param capabilities - Facts for the agent the list is built for.
+ * @returns The same list, with `none`-route entries re-described.
+ */
+export declare function annotateCommandCapabilities(commands: readonly LocalCommand[], capabilities: AgentCapabilities): LocalCommand[];
+//# sourceMappingURL=capabilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,6CAA6C,CAAA;AACvG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAWrD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAA;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,EAAE,cAAc,GAAG,SAAS,CAAA;IACnD,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;IAC1C,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IAC/C,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CACtC;AAQD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,iBAAiB,CAyCxF;AAED,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,kBAAkB,CAwBlG;AAiBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,YAAY,EAAE,iBAAiB,GAC9B,YAAY,EAAE,CAShB"}

package/lib/types/dsh-adapter/channel/capabilities.js

@@ -0,0 +1,165 @@
+/**
+ * One place that answers "can this agent actually do X?", with the evidence
+ * for every answer.
+ *
+ * The TUI used to answer that question three different ways: `/permission`
+ * read the merged command list or the permission-presets snapshot, `/plan`
+ * read the command list only, and `/compact` asked nothing at all — so a
+ * command could look available (Help, `/` completion) and then fail on use.
+ * Every consumer now reads these facts: Chat's command switch, the
+ * session-mode actions, and the Help/completion annotation applied where the
+ * command list is built (`annotateCommandCapabilities`).
+ *
+ * Resolution is FACT-based on purpose. Each fact is read from the live service
+ * the agent's own scope chain resolves (`presets.serviceForAgent`, which
+ * mirrors the official host's `agentPresets.serviceFor(agent, key) ??
+ * ctx.get(key)`), never from a preset-id table — a user preset that adds
+ * compaction/pruning back gets the full feature set with no TUI change. The
+ * single preset-id read left is the official Minimal `ask_user_question`
+ * carve-out, and it lives in `presets.ts` (one source, pinned by
+ * `verify:minimal-preset-tools`).
+ *
+ * Evidence per fact:
+ *   compaction     `serviceForAgent(ctx, agent, 'compaction')` exposing
+ *                  `compactNow` — the same seam the TUI transaction and the
+ *                  official `/compact` command both call;
+ *   pruner         `serviceForAgent(ctx, agent, 'toolResultPruner')`;
+ *   skills         `serviceForAgent(ctx, agent, 'skills')`;
+ *   compact/plan   the DSH command registry (`commands.find(agent, name)`,
+ *                  scope-correct: same name in another scope is not this
+ *                  agent's command). `/compact` prefers the TUI's own
+ *                  transaction whenever the compaction service exists, because
+ *                  that path owns the `tui/compact` decision event, the
+ *                  progress row, Esc cancellation and the session-switch
+ *                  settle; it falls back to the registry command only when the
+ *                  local path cannot run.
+ */
+import { presetHidesHostAskTool, runningPresetOf, serviceForAgent } from '../presets.js';
+/** Whether `/compact` can run through the TUI's own transaction. */
+function hasCompactNow(service) {
+    return typeof service?.compactNow === 'function';
+}
+/** Command name → the capability that gates its advertisement. */
+const COMMAND_CAPABILITIES = new Map([
+    ['compact', capabilities => capabilities.compact],
+    ['plan', capabilities => capabilities.plan],
+]);
+/**
+ * Resolve the facts for one agent.
+ *
+ * @param evidence - The live reads described on {@link CapabilityEvidence}.
+ * @returns Facts plus, for a missing route, the i18n key naming the reason.
+ */
+export function resolveAgentCapabilities(evidence) {
+    const { agent, commandService, presetId } = evidence;
+    // The command service can be a partial shape (script fixtures, hosts whose row
+    // does not expose the whole surface), so read `find` structurally and call it
+    // as a method: a detached registry method loses `this` (see #864). A missing
+    // member and a throwing one both mean "no registry route", never a throw out
+    // of the capability read — this runs on the render path and inside bind()'s
+    // gap notice, where an exception disposes the whole channel.
+    const registered = (name) => {
+        // The unbound read is deliberate: the merged command list is built with the
+        // same scope (`skill-catalog` calls `commandService.list(agent)` before the
+        // first bind, which resolves the global-only view), so a registry command
+        // the user can already see in Help must not read as unavailable merely
+        // because no agent is bound yet — that is exactly the launchpad screen.
+        if (commandService === undefined)
+            return false;
+        const { find } = commandService;
+        if (typeof find !== 'function')
+            return false;
+        try {
+            return find.call(commandService, agent, name) !== undefined;
+        }
+        catch {
+            return false;
+        }
+    };
+    const compaction = hasCompactNow(evidence.service('compaction'));
+    return {
+        compact: compaction
+            ? { route: 'local' }
+            : registered('compact')
+                ? { route: 'registry' }
+                : { route: 'none', reasonKey: 'capability-reason-no-compaction' },
+        plan: registered('plan')
+            ? { route: 'registry' }
+            : { route: 'none', reasonKey: 'capability-reason-no-plan-command' },
+        compaction,
+        pruner: evidence.service('toolResultPruner') !== undefined,
+        // The TUI mounts ask_user_question at the HOST layer, so the tool catalog
+        // alone is not evidence: the official Minimal preset's assembly filter
+        // strips it again (see `presets.presetHidesHostAskTool`).
+        questionTool: evidence.toolPresent('ask_user_question') && !presetHidesHostAskTool(presetId),
+        skills: evidence.service('skills') !== undefined,
+    };
+}
+/** The live evidence bag for one agent, read through its preset scope chain. */
+export function agentCapabilityEvidence(ctx, agent) {
+    const read = (key) => {
+        try {
+            return agent === undefined ? ctx.get(key) : serviceForAgent(ctx, agent, key);
+        }
+        catch {
+            // A failing scope read must degrade to "not mounted", never break the
+            // caller that is only describing what exists.
+            return undefined;
+        }
+    };
+    return {
+        agent,
+        commandService: ctx.get('commands'),
+        service: read,
+        toolPresent: name => {
+            try {
+                const tools = ctx.get('tools');
+                return tools?.get(name, agent) !== undefined;
+            }
+            catch {
+                return false;
+            }
+        },
+        presetId: agent === undefined ? undefined : recordedPresetId(agent),
+    };
+}
+/**
+ * The preset recorded for the agent, or undefined when the session cannot be
+ * read. `runningPresetOf` walks the live session contract and throws on a
+ * session that violates it; this bag must stay descriptive, so a bad read
+ * degrades to "no preset recorded" rather than escaping into the caller (where
+ * it would dispose the channel through bind()'s catch).
+ */
+function recordedPresetId(agent) {
+    try {
+        return runningPresetOf(agent.session);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Mark the commands whose capability route is `none` so Help and `/`
+ * completion state that instead of advertising a command that can only fail.
+ *
+ * The marker is a `descriptionKey` override, so `localizedDescription`
+ * resolves it at render time (`/lang` applies immediately) and every list
+ * consumer — Help menu, suggestion overlay, i18n verifier — picks it up with
+ * no new UI mode. The command stays dispatchable: removing it from the list
+ * would silently forward `/compact` to the model as a plain message.
+ *
+ * @param commands - The merged command list (locals + registry).
+ * @param capabilities - Facts for the agent the list is built for.
+ * @returns The same list, with `none`-route entries re-described.
+ */
+export function annotateCommandCapabilities(commands, capabilities) {
+    let annotated;
+    commands.forEach((command, index) => {
+        const gate = COMMAND_CAPABILITIES.get(command.name);
+        if (gate === undefined || gate(capabilities).route !== 'none')
+            return;
+        annotated ??= [...commands];
+        annotated[index] = { ...command, descriptionKey: `cmd-desc-${command.name}-unavailable` };
+    });
+    return annotated ?? commands;
+}

package/lib/types/dsh-adapter/channel/command-completions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-completions.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/command-completions.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAI1G,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,KAAK,EAAE,MAAM,YAAY,CAAA;IACzB,SAAS,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAA;IACjD,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,qBAAqB,EAAE,CAAA;KAAE,CAAA;IACtF,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,IAES,OAAO,MAAM,qDAyEtB"}
+{"version":3,"file":"command-completions.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/command-completions.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAK1G,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,KAAK,EAAE,MAAM,YAAY,CAAA;IACzB,SAAS,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAA;IACjD,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,qBAAqB,EAAE,CAAA;KAAE,CAAA;IACtF,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,IAES,OAAO,MAAM,qDA+EtB"}

package/lib/types/dsh-adapter/channel/command-completions.js

@@ -1,4 +1,5 @@
 import { completeCommands, isCommandCompletionToken } from '../../commands.js';
+import { getSidePanelPanels, parseSidePanelIds } from '../../tuiDisplayPrefs.js';
 import { SESSION_COLOR_NAMES } from '../../terminal-utils/sessionColors.js';
 import { getLang, LANGS } from '../../i18n.js';
 import { AUTO_THEME_NAME } from '../../theme.js';
@@ -83,6 +84,13 @@ export function createCommandCompletions(deps) {
                     ...(snapshot.current?.kind === 'preset' && snapshot.current.value === option.value ? { tag: 'current' } : {}),
                 }));
             }
+            if (path.length === 1 && path[0] === 'panel')
+                return [
+                    { name: 'toggle', description: 'Toggle the sidebar', descriptionKey: 'sugg-panel-toggle-desc' },
+                    { name: 'focus', description: 'Focus the side panel', descriptionKey: 'sugg-panel-focus-desc' },
+                    { name: 'zoom', description: 'Zoom the active panel', descriptionKey: 'sugg-panel-zoom-desc' },
+                    ...parseSidePanelIds(getSidePanelPanels()).map(id => ({ name: id, description: `Open the ${id} panel`, descriptionKey: 'sugg-panel-id-desc' })),
+                ];
             if (path.length === 1 && path[0] === 'plan')
                 return [
                     { name: 'on', description: 'Enter plan mode: read-only, plan before acting', descriptionKey: 'plan-mode-on-desc' },

package/lib/types/dsh-adapter/channel/context-bookkeeping.d.ts

@@ -1,18 +1,10 @@
+import type { ContextOccupancy } from '../../adapter/ports/channel-view.js';
 import type { ComposerImageRef, PendingMessage } from './types.js';
 /** Small mutable cells for Channel-local warning and pending-message state. */
 export declare function createContextBookkeeping(state: () => {
-    contextWindow: number | undefined;
-    tokens: {
-        input: number;
-    };
-    /** Last turn's billed token shape; the honest numerator for the
-     * context-low warning (input alone misses cached reads/writes, which
-     * resumed sessions replay back at full size). */
-    lastUsage: {
-        input: number;
-        cacheRead: number;
-        cacheWrite: number;
-    } | undefined;
+    /** The channel's single occupancy reading (projection first, sample
+     *  fallback) — the honest numerator for the context-low warning. */
+    contextOccupancy: ContextOccupancy | undefined;
     pending: PendingMessage[];
     emit(): void;
 }, notify: (text: string, options: {

package/lib/types/dsh-adapter/channel/context-bookkeeping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-bookkeeping.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/context-bookkeeping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAElE,+EAA+E;AAC/E,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM;IACX,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACzB;;qDAEiD;IACjD,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;IAC/E,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,IAAI,IAAI,IAAI,CAAA;CACb,EACD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,EACnF,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,EAC3C,mBAAmB,EAAE,MAAM;;;;+BAyBK,IAAI;+BAtBJ,IAAI;4BAWL;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAA;KAAE,aAAa,cAAc,CAAC,WAAW,CAAC,KAAG,IAAI;gCAK7G,MAAM,KAAG,IAAI;EAQjD"}
+{"version":3,"file":"context-bookkeeping.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/context-bookkeeping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAElE,+EAA+E;AAC/E,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM;IACX;wEACoE;IACpE,gBAAgB,EAAE,gBAAgB,GAAG,SAAS,CAAA;IAC9C,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,IAAI,IAAI,IAAI,CAAA;CACb,EACD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,EACnF,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,EAC3C,mBAAmB,EAAE,MAAM;;;;+BA6BK,IAAI;+BA1BJ,IAAI;4BAeL;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAA;KAAE,aAAa,cAAc,CAAC,WAAW,CAAC,KAAG,IAAI;gCAK7G,MAAM,KAAG,IAAI;EAQjD"}

package/lib/types/dsh-adapter/channel/context-bookkeeping.js

@@ -3,14 +3,19 @@ export function createContextBookkeeping(state, notify, lowContextText, warningB
     const warning = { value: false };
     const checkContextWarning = () => {
         const channel = state();
-        if (warning.value || channel.contextWindow === undefined || channel.lastUsage === undefined)
+        const occupancy = channel.contextOccupancy;
+        // No window (no route capacity) is the only reason to stay silent: the
+        // numerator is now the projected occupancy, which exists as soon as a
+        // meter (any normal deployment) or one settled request knows anything.
+        if (warning.value || occupancy === undefined || occupancy.contextWindow === undefined)
             return;
-        const used = channel.lastUsage.input + channel.lastUsage.cacheRead + channel.lastUsage.cacheWrite;
-        const remaining = channel.contextWindow - used;
+        if (occupancy.contextWindow <= 0)
+            return;
+        const remaining = occupancy.contextWindow - occupancy.usedTokens;
         if (remaining >= warningBufferTokens)
             return;
         warning.value = true;
-        notify(lowContextText(Math.max(0, Math.round((remaining / channel.contextWindow) * 100))), {
+        notify(lowContextText(Math.max(0, Math.round((remaining / occupancy.contextWindow) * 100))), {
             color: 'warning', timeoutMs: 8000,
         });
     };

package/lib/types/dsh-adapter/channel/input-delivery.d.ts

@@ -3,7 +3,7 @@ import type { Agent } from '@deepseek-ai/dsh-agent';
 import { type UserMessage } from '@deepseek-ai/dsh-llm';
 import { type ComposerImages } from './composer-images.js';
 import type { ChannelOwner } from './owner.js';
-import type { ChannelSelection, SelectionAttachment } from '../../adapter/ports/channel-view.js';
+import type { AttachedContext, ChannelSelection, SelectionAttachment } from '../../adapter/ports/channel-view.js';
 import type { ChannelImageBlock, ChannelState, ComposerImageRef, MentionAttachments, MentionFs, PendingMessage, StagedImageInput } from './types.js';
 /** One submission's enqueue-time world: the session it was typed in, the
  *  services that resolve its references, and the capabilities live then. */
@@ -19,6 +19,10 @@ interface UserTextOrigin {
      *  selection made while the FIFO or mention expansion parks the delivery
      *  can never attach to this message. */
     readonly selection: ChannelSelection | undefined;
+    /** "Send to Chat" contexts AT ENQUEUE, already taken off the channel (see
+     *  `consumeAttachedContexts`): the same one-shot rule as the selection, and
+     *  the reason a chip can never ride along with a second submission. */
+    readonly attachedContexts: readonly AttachedContext[];
 }
 /** Input FIFO, staged attachments and decision notice timers share one lifetime. */
 export declare function createInputDelivery(ctx: Context, owner: ChannelOwner, binding: {
@@ -27,7 +31,14 @@ export declare function createInputDelivery(ctx: Context, owner: ChannelOwner, b
     id: string;
     text: string;
     images?: readonly ComposerImageRef[];
-}, placement: PendingMessage['placement']) => void, untrackPending: (id: string) => void, composer: ComposerImages, selection: () => ChannelSelection | undefined, rememberSelection: (messageId: string, info: SelectionAttachment) => void): {
+}, placement: PendingMessage['placement']) => void, untrackPending: (id: string) => void, composer: ComposerImages, selection: () => ChannelSelection | undefined, rememberSelection: (messageId: string, info: SelectionAttachment) => void, 
+/**
+ * Take-and-clear the staged "Send to Chat" contexts for the submission being
+ * enqueued (side-panel §6.7). Optional so a bare embedder/fixture that owns
+ * only the decision seam stays constructible; with it absent the origin
+ * simply carries no contexts.
+ */
+consumeAttachedContexts?: () => readonly AttachedContext[]): {
     dispatchUserText: (text: string, placement: PendingMessage["placement"], images?: readonly ComposerImageRef[], attach?: UserMessage) => void;
     deliverUserText: (text: string, placement: PendingMessage["placement"], images?: readonly ComposerImageRef[], attach?: UserMessage) => void;
     claimAttachments: (messages: readonly UserMessage[]) => UserMessage[];

package/lib/types/dsh-adapter/channel/input-delivery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input-delivery.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/input-delivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAI1E,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAA;AAK7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA;AAChG,OAAO,KAAK,EACV,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAEnB;4EAC4E;AAC5E,UAAU,cAAc;IACtB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,EAAE,SAAS,GAAG,SAAS,CAAA;IAClC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,GAAG,SAAS,CAAA;IACpD,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAA;IAC3E;;4CAEwC;IACxC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,GAAG,SAAS,CAAA;CACjD;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,EACrE,KAAK,EAAE,MAAM,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,SAAS,GAAG,wBAAwB,CAAC,EAC7E,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,EAC9B,YAAY,EAAE,CAAC,OAAO,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAAE,EAAE,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,KAAK,IAAI,EAC3I,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,EACpC,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,gBAAgB,GAAG,SAAS,EAC7C,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,KAAK,IAAI;6BAkRhE,MAAM,aACD,cAAc,CAAC,WAAW,CAAC,WAC9B,SAAS,gBAAgB,EAAE,WAC1B,WAAW,KACnB,IAAI;4BAcC,MAAM,aACD,cAAc,CAAC,WAAW,CAAC,WAC9B,SAAS,gBAAgB,EAAE,WAC1B,WAAW,KACnB,IAAI;iCAlR6B,SAAS,WAAW,EAAE,KAAG,WAAW,EAAE;kCAarC,MAAM,KAAG,IAAI;0BAuIrB,CAAC,QAAQ,MAAM,WAAW,OAAO,CAAC,CAAC,CAAC,WAAW,cAAc,KAAG,OAAO,CAAC,CAAC,CAAC;6BAkIzE,IAAI;wBAaZ,gBAAgB,KAAG,OAAO,CAAC,MAAM,CAAC;wBACpC,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC;;EAGzE"}
+{"version":3,"file":"input-delivery.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/input-delivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAI1E,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAA;AAM7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA;AACjH,OAAO,KAAK,EACV,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAEnB;4EAC4E;AAC5E,UAAU,cAAc;IACtB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,EAAE,SAAS,GAAG,SAAS,CAAA;IAClC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,GAAG,SAAS,CAAA;IACpD,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAA;IAC3E;;4CAEwC;IACxC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,GAAG,SAAS,CAAA;IAChD;;2EAEuE;IACvE,QAAQ,CAAC,gBAAgB,EAAE,SAAS,eAAe,EAAE,CAAA;CACtD;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,EACrE,KAAK,EAAE,MAAM,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,SAAS,GAAG,wBAAwB,CAAC,EAC7E,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,EAC9B,YAAY,EAAE,CAAC,OAAO,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAAE,EAAE,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,KAAK,IAAI,EAC3I,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,EACpC,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,gBAAgB,GAAG,SAAS,EAC7C,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,KAAK,IAAI;AACzE;;;;;GAKG;AACH,uBAAuB,CAAC,EAAE,MAAM,SAAS,eAAe,EAAE;6BA2RjD,MAAM,aACD,cAAc,CAAC,WAAW,CAAC,WAC9B,SAAS,gBAAgB,EAAE,WAC1B,WAAW,KACnB,IAAI;4BAcC,MAAM,aACD,cAAc,CAAC,WAAW,CAAC,WAC9B,SAAS,gBAAgB,EAAE,WAC1B,WAAW,KACnB,IAAI;iCA3R6B,SAAS,WAAW,EAAE,KAAG,WAAW,EAAE;kCAarC,MAAM,KAAG,IAAI;0BAgJrB,CAAC,QAAQ,MAAM,WAAW,OAAO,CAAC,CAAC,CAAC,WAAW,cAAc,KAAG,OAAO,CAAC,CAAC,CAAC;6BAkIzE,IAAI;wBAaZ,gBAAgB,KAAG,OAAO,CAAC,MAAM,CAAC;wBACpC,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC;;EAGzE"}

package/lib/types/dsh-adapter/channel/input-delivery.js

@@ -4,11 +4,19 @@ import { logForDebugging } from '../../utils/debug.js';
 import { dispatchTuiDecision } from '../extension-events.js';
 import { firstStaleComposerToken, formatMissingReference, orderedComposerImages, } from './composer-images.js';
 import { expandComposerMentions } from './composer-mentions.js';
+import { appendAttachedContextBlocks } from './attached-context.js';
 import { normalizeInputDecision } from './decisions.js';
 import { attachIdeSelection } from './ide-selection.js';
 import { mentionAttachments, mentionFs } from './mentions.js';
 /** Input FIFO, staged attachments and decision notice timers share one lifetime. */
-export function createInputDelivery(ctx, owner, binding, state, notify, trackPending, untrackPending, composer, selection, rememberSelection) {
+export function createInputDelivery(ctx, owner, binding, state, notify, trackPending, untrackPending, composer, selection, rememberSelection, 
+/**
+ * Take-and-clear the staged "Send to Chat" contexts for the submission being
+ * enqueued (side-panel §6.7). Optional so a bare embedder/fixture that owns
+ * only the decision seam stays constructible; with it absent the origin
+ * simply carries no contexts.
+ */
+consumeAttachedContexts) {
     /**
      * `@` file mentions (issue #15): expansion reads files asynchronously, so
      * every user-text delivery (submit / steer / interrupt-requeue) funnels
@@ -84,6 +92,10 @@ export function createInputDelivery(ctx, owner, binding, state, notify, trackPen
         attachments: mentionAttachments(ctx),
         stagedImages: composer.snapshot(),
         selection: selection(),
+        // Consumed (not merely read): the snapshot and the clear are one step, so
+        // the chips leave with the submission that owns them and a second,
+        // faster-typed message can never re-attach the same context.
+        attachedContexts: consumeAttachedContexts?.() ?? [],
     });
     /**
      * Expand the text's `@` mentions and deliver ONE user message: the typed
@@ -113,6 +125,11 @@ export function createInputDelivery(ctx, owner, binding, state, notify, trackPen
         // attached-file block — direct construction, never text parsing, failures
         // silently skipped (an IDE-side extra must never block a send).
         const selectionAttached = await attachIdeSelection(expansion.blocks, origin.cwd, origin.selection, origin.fs);
+        // "Send to Chat": append every context staged for THIS submission as its
+        // own `<attached-context …>` block, behind the typed text and the
+        // mention/selection attachments. Unlike the selection there is nothing to
+        // resolve and nothing that can fail — the body is already in hand.
+        appendAttachedContextBlocks(expansion.blocks, origin.attachedContexts);
         const message = createUserMessage({
             content: expansion.blocks,
             source: { kind: 'user' },

package/lib/types/dsh-adapter/channel/mode-actions.d.ts

@@ -28,9 +28,6 @@ export declare function createModeActions(ctx: Context, state: ModeState, deps:
     runtime: AdapterRuntimeOptions;
     binding: Pick<Binding, 'agent' | 'capture' | 'isCurrent'>;
     sessionModes: readonly SessionModeSpec[];
-    commandService?: {
-        find(agent: Agent, name: string): unknown;
-    };
     executeRegistryCommand(name: string, input: string): Promise<string | undefined>;
     notify: ChannelState['notify'];
 }): {

package/lib/types/dsh-adapter/channel/mode-actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mode-actions.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/mode-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE5D,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC7E,OAAO,EAAsB,KAAK,qBAAqB,EAAE,MAAM,iCAAiC,CAAA;AAChG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAExD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACtD,KAAK,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC,CAAA;AAElE;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,EAC9B,WAAW,EAAE,MAAM,IAAI,EACvB,KAAK,EAAE,OAAO,GACb,IAAI,CAUN;AAED,iHAAiH;AACjH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE;IACJ,KAAK,EAAE;QAAE,OAAO,IAAI,OAAO,CAAA;KAAE,CAAA;IAC7B,OAAO,EAAE,qBAAqB,CAAA;IAC9B,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC,CAAA;IACzD,YAAY,EAAE,SAAS,eAAe,EAAE,CAAA;IACxC,cAAc,CAAC,EAAE;QAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;IAC9D,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAChF,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;CAC/B;uBAyDqB,IAAI;qBA4JE,OAAO,CAAC,IAAI,CAAC;sBA1EV,eAAe,sDAA0B,OAAO,CAAC,IAAI,CAAC;8BAuFpD,KAAK,CAAC,SAAS,CAAC,SAAS,YAAY,KAAG,IAAI;EA4B9E"}
+{"version":3,"file":"mode-actions.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/mode-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAG5D,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC7E,OAAO,EAAsB,KAAK,qBAAqB,EAAE,MAAM,iCAAiC,CAAA;AAChG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAG9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAExD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACtD,KAAK,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC,CAAA;AAElE;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,EAC9B,WAAW,EAAE,MAAM,IAAI,EACvB,KAAK,EAAE,OAAO,GACb,IAAI,CAUN;AAED,iHAAiH;AACjH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE;IACJ,KAAK,EAAE;QAAE,OAAO,IAAI,OAAO,CAAA;KAAE,CAAA;IAC7B,OAAO,EAAE,qBAAqB,CAAA;IAC9B,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC,CAAA;IACzD,YAAY,EAAE,SAAS,eAAe,EAAE,CAAA;IACxC,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAChF,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;CAC/B;uBA8DqB,IAAI;qBA4JE,OAAO,CAAC,IAAI,CAAC;sBA1EV,eAAe,sDAA0B,OAAO,CAAC,IAAI,CAAC;8BAuFpD,KAAK,CAAC,SAAS,CAAC,SAAS,YAAY,KAAG,IAAI;EA4B9E"}

package/lib/types/dsh-adapter/channel/mode-actions.js

@@ -2,6 +2,7 @@ import { t } from '../../i18n.js';
 import { modeDisplayName } from '../../sessionModes.js';
 import { assertShadowPolicy } from '../../adapter/kernel/runtime.js';
 import { snapshotLiveSessionEvents } from '../compat/liveSession.js';
+import { agentCapabilityEvidence, resolveAgentCapabilities } from './capabilities.js';
 /**
  * Fail-soft reporting for a session-mode write. The mutation path reaches
  * kernel-owned state (`session.append`, `approval.setPolicy` → the agent
@@ -28,7 +29,11 @@ export function reportModeSwitchFailure(ctx, notify, refreshMode, error) {
 }
 /** Durable session-mode folds and transitions. Construction is inert; root wires it after state construction. */
 export function createModeActions(ctx, state, deps) {
-    const { owner, runtime, binding, sessionModes, commandService, executeRegistryCommand, notify } = deps;
+    const { owner, runtime, binding, sessionModes, executeRegistryCommand, notify } = deps;
+    /** `/plan` is registry-only: read the shared capability facts for the agent
+     *  instead of this module keeping its own registry lookup (the same fact
+     *  `/plan` dispatch and the command-list annotation use). */
+    const planRoute = (agent) => resolveAgentCapabilities(agentCapabilityEvidence(ctx, agent)).plan.route;
     const current = (capture) => owner.current() && binding.isCurrent(capture);
     const capturedSession = (capture) => capture.agent.session;
     // Session-mode folds: last-wins projections over the session log. The
@@ -188,7 +193,7 @@ export function createModeActions(ctx, state, deps) {
             explicitPlanExits.delete(session);
         }
         if (spec.plan !== undefined && (planMode?.get?.(agent).pending ?? planActive) !== spec.plan) {
-            if (commandService?.find(agent, 'plan') === undefined) {
+            if (planRoute(agent) === 'none') {
                 notify(t('mode-plan-unavailable'), { color: 'warning' });
                 return;
             }

package/lib/types/dsh-adapter/channel/mode-permission-actions.d.ts

@@ -1,4 +1,5 @@
 import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
 import { type SessionModeSpec } from '../../sessionModes.js';
 import type { createChannelBinding } from './binding.js';
 import { createModeActions } from './mode-actions.js';
@@ -21,8 +22,14 @@ type BaseModeActionDeps = Parameters<typeof createModeActions>[2];
  * `createBindingEvents` can consume it unchanged, plus
  * `runPermissionPreset` for the public `ChannelUi` surface.
  */
-export declare function createPermissionModeActions(ctx: Context, state: ModeState, deps: Pick<BaseModeActionDeps, 'owner' | 'runtime' | 'binding' | 'sessionModes' | 'commandService' | 'executeRegistryCommand' | 'notify'> & {
+export declare function createPermissionModeActions(ctx: Context, state: ModeState, deps: Pick<BaseModeActionDeps, 'owner' | 'runtime' | 'binding' | 'sessionModes' | 'executeRegistryCommand' | 'notify'> & {
     roster: PermissionModeRoster;
+    /** Only the permission identity reads the registry directly (#755 is the
+     *  authoritative design for `/permission`); the plan route comes from the
+     *  shared capability facts inside `createModeActions`. */
+    commandService?: {
+        find(agent: Agent, name: string): unknown;
+    };
 }): {
     refreshMode(): void;
     cycleMode(): Promise<void>;

package/lib/types/dsh-adapter/channel/mode-permission-actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mode-permission-actions.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/mode-permission-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE7E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EAAE,iBAAiB,EAA2B,MAAM,mBAAmB,CAAA;AAC9E,OAAO,EAAkD,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC9G,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACtD,KAAK,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC,CAAA;AAClE,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAA;AACjD;gDACgD;AAChD,KAAK,kBAAkB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAA;AAmEjE;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,IAAI,CACR,kBAAkB,EAClB,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,GAAG,gBAAgB,GAAG,wBAAwB,GAAG,QAAQ,CAC1G,GAAG;IAAE,MAAM,EAAE,oBAAoB,CAAA;CAAE,GACnC;IACD,WAAW,IAAI,IAAI,CAAA;IACnB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,SAAS,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtE,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IACtD,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACnD,UAAU,EAAE,kBAAkB,CAAA;CAC/B,CAsIA"}
+{"version":3,"file":"mode-permission-actions.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/mode-permission-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAInD,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE7E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EAAE,iBAAiB,EAA2B,MAAM,mBAAmB,CAAA;AAC9E,OAAO,EAAkD,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC9G,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACtD,KAAK,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC,CAAA;AAClE,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAA;AACjD;gDACgD;AAChD,KAAK,kBAAkB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAA;AAmEjE;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,IAAI,CACR,kBAAkB,EAClB,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,GAAG,wBAAwB,GAAG,QAAQ,CACvF,GAAG;IACF,MAAM,EAAE,oBAAoB,CAAA;IAC5B;;8DAE0D;IAC1D,cAAc,CAAC,EAAE;QAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;CAC/D,GACA;IACD,WAAW,IAAI,IAAI,CAAA;IACnB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,SAAS,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtE,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IACtD,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACnD,UAAU,EAAE,kBAAkB,CAAA;CAC/B,CAqIA"}

package/lib/types/dsh-adapter/channel/mode-permission-actions.js

@@ -78,7 +78,6 @@ export function createPermissionModeActions(ctx, state, deps) {
         runtime: deps.runtime,
         binding,
         sessionModes,
-        commandService,
         executeRegistryCommand,
         notify,
     });

package/lib/types/dsh-adapter/channel/preferences.d.ts

@@ -1,3 +1,3 @@
 import type { ChannelState } from '../channel/types.js';
-export declare function createPreferences(getState: () => Pick<ChannelState, 'diffLayout' | 'thinkingFold' | 'toolBackground' | 'scrollGutter' | 'pageMargin' | 'foldTerminalCommand' | 'promptSessionLabel' | 'expandEditor' | 'smoothStreaming' | 'statusBar' | 'whale' | 'whaleIdle' | 'whaleGirl' | 'splashFont' | 'minimalUi' | 'emit'>): Pick<ChannelState, 'setDiffLayout' | 'setThinkingFold' | 'setToolBackground' | 'setScrollGutter' | 'setPageMargin' | 'setFoldTerminalCommand' | 'setPromptSessionLabel' | 'setExpandEditor' | 'setSmoothStreaming' | 'setStatusBar' | 'setWhale' | 'setWhaleIdle' | 'setWhaleGirl' | 'setSplashFont' | 'setMinimalUi' | 'setMinimal'>;
+export declare function createPreferences(getState: () => Pick<ChannelState, 'diffLayout' | 'thinkingFold' | 'jobGroupFold' | 'toolBackground' | 'scrollGutter' | 'pageMargin' | 'foldTerminalCommand' | 'promptSessionLabel' | 'expandEditor' | 'smoothStreaming' | 'statusBar' | 'whale' | 'whaleIdle' | 'whaleGirl' | 'splashFont' | 'minimalUi' | 'emit'>): Pick<ChannelState, 'setDiffLayout' | 'setThinkingFold' | 'setJobGroupFold' | 'setToolBackground' | 'setScrollGutter' | 'setPageMargin' | 'setFoldTerminalCommand' | 'setPromptSessionLabel' | 'setExpandEditor' | 'setSmoothStreaming' | 'setStatusBar' | 'setWhale' | 'setWhaleIdle' | 'setWhaleGirl' | 'setSplashFont' | 'setMinimalUi' | 'setMinimal'>;
 //# sourceMappingURL=preferences.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/preferences.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAYvD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,cAAc,GAAG,gBAAgB,GAAG,cAAc,GAAG,YAAY,GAAG,qBAAqB,GAAG,oBAAoB,GAAG,cAAc,GAAG,iBAAiB,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,eAAe,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,eAAe,GAAG,wBAAwB,GAAG,uBAAuB,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,cAAc,GAAG,UAAU,GAAG,cAAc,GAAG,cAAc,GAAG,eAAe,GAAG,cAAc,GAAG,YAAY,CAAC,CAuH3oB"}
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/preferences.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAYvD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,cAAc,GAAG,cAAc,GAAG,gBAAgB,GAAG,cAAc,GAAG,YAAY,GAAG,qBAAqB,GAAG,oBAAoB,GAAG,cAAc,GAAG,iBAAiB,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,eAAe,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,eAAe,GAAG,wBAAwB,GAAG,uBAAuB,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,cAAc,GAAG,UAAU,GAAG,cAAc,GAAG,cAAc,GAAG,eAAe,GAAG,cAAc,GAAG,YAAY,CAAC,CA+HhrB"}