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

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

@@ -0,0 +1,109 @@
+/**
+ * Attached contexts ("Send to Chat", side-panel design §6.7): a panel stages
+ * one of its rows on the channel, the composer renders a chip for it, and the
+ * NEXT submission carries the model-facing `<attached-context …>` block.
+ *
+ * Deliberately the same seam as the IDE-selection channel next door
+ * (`ide-selection.ts`): a projection the composer renders, an ENQUEUE-time
+ * snapshot consumed exactly once by the submit path, and a block builder that
+ * never goes through text parsing. The one difference is where the body comes
+ * from — a panel hands it over in-process, so there is no disk read and no
+ * failure mode to swallow. The only policy left is the shared mention size cap.
+ */
+import { escapeSnippetAttr } from './ide-selection.js';
+import { MENTION_MAX_FILE_CHARS } from './mentions.js';
+/**
+ * Cap one panel body at the shared mention limit. Truncation is recorded ON the
+ * entry (`truncated`) rather than re-derived from the body later: the block
+ * builder appends the visible `[… truncated]` marker from that flag, so a body
+ * that legitimately fills the cap is never mislabelled as cut — and `chars`
+ * stays "the length of what the model will actually receive".
+ */
+function capContent(content) {
+    if (content.length <= MENTION_MAX_FILE_CHARS)
+        return { content, truncated: false };
+    return { content: content.slice(0, MENTION_MAX_FILE_CHARS), truncated: true };
+}
+/**
+ * Build one model-facing block, shaped like the selection channel's
+ * `<attached-file …>`: escaped attributes, one body, the close tag. The
+ * attribute values reuse `escapeSnippetAttr` — a title or source id carrying
+ * `"`/`&`/`<`/`>` must not break out of the attribute or smuggle markup
+ * into the model-facing block.
+ */
+export function buildAttachedContextBlock(context) {
+    const body = context.truncated ? `${context.content}\n[… truncated]` : context.content;
+    return `<attached-context source="${context.source}" sourceId="${escapeSnippetAttr(context.sourceId)}" title="${escapeSnippetAttr(context.title)}">\n${body}\n</attached-context>`;
+}
+/**
+ * Append every staged context as its own block, in stage order (the order the
+ * chips render in), after the typed text and every other attachment. The caller
+ * passes the ENQUEUE-time snapshot: a panel that stages something while the
+ * delivery FIFO is parked can never ride along with a message it was not typed
+ * for. Returns how many blocks were appended (telemetry/assertions).
+ */
+export function appendAttachedContextBlocks(blocks, contexts) {
+    for (const context of contexts) {
+        blocks.push({ type: 'text', text: buildAttachedContextBlock(context) });
+    }
+    return contexts.length;
+}
+/**
+ * Registry behind `ChannelUi.attachedContexts` / `attachContext` /
+ * `detachContext`. It owns no state of its own: every entry lives in the
+ * channel state's array, so the session-scoped reset that clears the other
+ * projections (`resetSessionProjection`) clears this one by assignment.
+ *
+ * Duplicate `sourceId` + `title` REPLACES the existing entry (keeping its id
+ * and position) instead of stacking a second chip: a panel row re-sent after it
+ * changed — or sent twice by a double 's' keypress — is the same attachment, and
+ * a stable id keeps chip keys and any future detach-by-sender valid across the
+ * update. Distinct titles under one id stay separate chips.
+ */
+export function createAttachedContextRegistry(holder, emit) {
+    let sequence = 0;
+    /** NUL cannot appear in either part, so the join is unambiguous. */
+    const keyOf = (sourceId, title) => `${sourceId}\u0000${title}`;
+    return {
+        attach(input) {
+            const capped = capContent(input.content);
+            const list = holder().attachedContexts;
+            const key = keyOf(input.sourceId, input.title);
+            const index = list.findIndex(item => keyOf(item.sourceId, item.title) === key);
+            const existing = index === -1 ? undefined : list[index];
+            const next = {
+                id: existing === undefined ? `ctx-${++sequence}` : existing.id,
+                source: input.source,
+                sourceId: input.sourceId,
+                title: input.title,
+                content: capped.content,
+                chars: capped.content.length,
+                truncated: capped.truncated,
+            };
+            holder().attachedContexts = index === -1
+                ? [...list, next]
+                : list.map((item, at) => (at === index ? next : item));
+            // The projection is read through the detached read view, which keys its
+            // frozen snapshots on `version`: every change must bump it or the
+            // composer keeps rendering the previous array.
+            emit();
+        },
+        detach(id) {
+            const list = holder().attachedContexts;
+            const remaining = list.filter(item => item.id !== id);
+            if (remaining.length === list.length)
+                return;
+            holder().attachedContexts = remaining;
+            emit();
+        },
+        consume() {
+            const list = holder().attachedContexts;
+            if (list.length === 0)
+                return [];
+            const taken = [...list];
+            holder().attachedContexts = [];
+            emit();
+            return taken;
+        },
+    };
+}

package/lib/types/dsh-adapter/channel/binding-events.d.ts

@@ -21,6 +21,12 @@ export declare function createBindingEvents(ctx: Context, deps: {
      *  The line's semantics live in the working-activity plugin: this app folds
      *  nothing itself and forwards no events. */
     seedActivity?(session: unknown): void;
+    /** Read the context-occupancy projection's current value for a freshly bound
+     *  session, for the same reason (and with the same plumbing) as
+     *  `seedActivity`: the value only arrives when it changes, so a resumed
+     *  session needs one baseline read to show its occupancy before the next
+     *  request reports usage. */
+    seedContextOccupancy?(session: unknown): void;
     inputConvergence: InputConvergence;
     selection: ModelSelectionRef;
     modelActions: {

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

@@ -1 +1 @@
-{"version":3,"file":"binding-events.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/binding-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC5F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;IACtD,KAAK,EAAE,YAAY,CAAA;IACnB,OAAO,EAAE,cAAc,CAAA;IACvB,KAAK,EAAE,YAAY,CAAA;IACnB;;;;iDAI6C;IAC7C,YAAY,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACrC,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,SAAS,EAAE,iBAAiB,CAAA;IAC5B,YAAY,EAAE;QAAE,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,SAAS,EAAE,iBAAiB,CAAA;KAAE,CAAA;IACrF,WAAW,EAAE;QAAE,WAAW,IAAI,IAAI,CAAC;QAAC,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAA;IAC5F,SAAS,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAA;IACrD,SAAS,EAAE;QACT,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAA;QACzD,aAAa,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAA;QACpE,OAAO,CAAC,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;QAC7G,KAAK,CAAC,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,CAAA;SAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;QAC9H,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;KAC5B,CAAA;IACD,SAAS,EAAE;QAAE,QAAQ,IAAI,IAAI,CAAA;KAAE,CAAA;IAC/B,eAAe,CAAC,EAAE;QAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAA;IACrE;;;sCAGkC;IAClC,gBAAgB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3C;gBAqCkB,IAAI;EAiJtB"}
+{"version":3,"file":"binding-events.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/binding-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC5F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;IACtD,KAAK,EAAE,YAAY,CAAA;IACnB,OAAO,EAAE,cAAc,CAAA;IACvB,KAAK,EAAE,YAAY,CAAA;IACnB;;;;iDAI6C;IAC7C,YAAY,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACrC;;;;iCAI6B;IAC7B,oBAAoB,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IAC7C,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,SAAS,EAAE,iBAAiB,CAAA;IAC5B,YAAY,EAAE;QAAE,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,SAAS,EAAE,iBAAiB,CAAA;KAAE,CAAA;IACrF,WAAW,EAAE;QAAE,WAAW,IAAI,IAAI,CAAC;QAAC,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAA;IAC5F,SAAS,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAA;IACrD,SAAS,EAAE;QACT,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAA;QACzD,aAAa,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAA;QACpE,OAAO,CAAC,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;QAC7G,KAAK,CAAC,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,CAAA;SAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;QAC9H,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;KAC5B,CAAA;IACD,SAAS,EAAE;QAAE,QAAQ,IAAI,IAAI,CAAA;KAAE,CAAA;IAC/B,eAAe,CAAC,EAAE;QAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAA;IACrE;;;sCAGkC;IAClC,gBAAgB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3C;gBAqEkB,IAAI;EAsJtB"}

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/external-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"external-commands.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/external-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAoB,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAKjF,OAAO,EAAkD,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1G,OAAO,KAAK,EAAqB,gBAAgB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAcjH;0DAC0D;AAC1D,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE;IACJ,cAAc,EAAE,cAAc,GAAG,SAAS,CAAA;IAC1C,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAA;IACpD,KAAK,IAAI,KAAK,CAAA;IACd,OAAO,IAAI,OAAO,CAAA;IAClB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAA;IACzC,MAAM,CAAC,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IAC3G,QAAQ,EAAE,cAAc,CAAA;IACxB,WAAW,IAAI,kBAAkB,GAAG,SAAS,CAAA;IAC7C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CACtG;mBA+HO,MAAM,YACF,MAAM,cACL,SAAS,gBAAgB,EAAE,KACrC,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;uBA2EtC,MAAM,YACF,MAAM,cACL,SAAS,gBAAgB,EAAE,KACrC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;EAG/B"}
+{"version":3,"file":"external-commands.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/external-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAoB,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAKjF,OAAO,EAAkD,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1G,OAAO,KAAK,EAAqB,gBAAgB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAcjH;0DAC0D;AAC1D,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE;IACJ,cAAc,EAAE,cAAc,GAAG,SAAS,CAAA;IAC1C,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAA;IACpD,KAAK,IAAI,KAAK,CAAA;IACd,OAAO,IAAI,OAAO,CAAA;IAClB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAA;IACzC,MAAM,CAAC,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IAC3G,QAAQ,EAAE,cAAc,CAAA;IACxB,WAAW,IAAI,kBAAkB,GAAG,SAAS,CAAA;IAC7C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CACtG;mBA+HO,MAAM,YACF,MAAM,cACL,SAAS,gBAAgB,EAAE,KACrC,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;uBAiFtC,MAAM,YACF,MAAM,cACL,SAAS,gBAAgB,EAAE,KACrC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;EAG/B"}

package/lib/types/dsh-adapter/channel/external-commands.js

@@ -111,8 +111,6 @@ export function createExternalCommandInvoker(ctx, deps) {
     /** Run one DSH registry command (`/plan`, …) on the live agent while
      *  preserving its settled result kind for composer admission. */
     const invoke = async (name, rawInput, imageRefs = []) => {
-        const capture = deps.capture();
-        assertCapabilityShadowPolicy('host.commands.invoke', deps.runtime.mode, deps.runtime.slices);
         const service = deps.commandService;
         if (service === undefined)
             return undefined;
@@ -123,6 +121,14 @@ export function createExternalCommandInvoker(ctx, deps) {
         // apply another scope's owner policy.
         const definition = service.find(commandAgent, name);
         try {
+            // The channel-lifetime capture and the shadow/capability policy check
+            // live INSIDE the try: both can throw (a lease that ended between
+            // keystrokes, a shadow-mode denial), and `invoke` is an async action
+            // whose callers treat a rejection as unhandled — the same refusal must
+            // degrade to the settled `{ kind: 'error' }` outcome every other
+            // failure below uses.
+            const capture = deps.capture();
+            assertCapabilityShadowPolicy('host.commands.invoke', deps.runtime.mode, deps.runtime.slices);
             const signal = new AbortController().signal;
             const line = `/${name}${rawInput}`;
             const batch = await registryCommandImages(service, line, deps.composer.includeLegacyImageRefs(line, imageRefs), stagedSnapshot, signal);

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"}