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

package/lib/types/components/subagentDetailMemory.d.ts

@@ -0,0 +1,17 @@
+/**
+ * subagentDetailMemory：Detail 场景的页码/滚动记忆。主屏 Agent View 盖过
+ * Detail 时（Chat 的整屏 early-return）组件会卸载；从 Agent View 返回时
+ * 按 agentId 恢复最后的页码与滚动位置。只保留最近 16 个代理。
+ */
+export interface SubagentDetailSnapshot {
+    readonly page: string;
+    readonly scrollTop: number;
+}
+export declare const subagentDetailMemory: {
+    read(agentId: string): SubagentDetailSnapshot | undefined;
+    /** 常规退出（返回 Dashboard / 关面板）不带走记忆：只有主屏 Agent View
+     *  的往返才恢复页码与滚动，重新从 Dashboard 进入是全新一次浏览。 */
+    clear(agentId: string): void;
+    save(agentId: string, snapshot: SubagentDetailSnapshot): void;
+};
+//# sourceMappingURL=subagentDetailMemory.d.ts.map

package/lib/types/components/subagentDetailMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagentDetailMemory.d.ts","sourceRoot":"","sources":["../../../src/components/subagentDetailMemory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAKD,eAAO,MAAM,oBAAoB;kBACjB,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAGzD;+CAC2C;mBAC5B,MAAM,GAAG,IAAI;kBAGd,MAAM,YAAY,sBAAsB,GAAG,IAAI;CAU9D,CAAA"}

package/lib/types/components/subagentDetailMemory.js

@@ -0,0 +1,28 @@
+/**
+ * subagentDetailMemory：Detail 场景的页码/滚动记忆。主屏 Agent View 盖过
+ * Detail 时（Chat 的整屏 early-return）组件会卸载；从 Agent View 返回时
+ * 按 agentId 恢复最后的页码与滚动位置。只保留最近 16 个代理。
+ */
+const MEMORY_CAP = 16;
+const memory = new Map();
+export const subagentDetailMemory = {
+    read(agentId) {
+        return memory.get(agentId);
+    },
+    /** 常规退出（返回 Dashboard / 关面板）不带走记忆：只有主屏 Agent View
+     *  的往返才恢复页码与滚动，重新从 Dashboard 进入是全新一次浏览。 */
+    clear(agentId) {
+        memory.delete(agentId);
+    },
+    save(agentId, snapshot) {
+        // LRU 触碰：删除重插，超量淘汰最旧。
+        memory.delete(agentId);
+        memory.set(agentId, snapshot);
+        while (memory.size > MEMORY_CAP) {
+            const oldest = memory.keys().next().value;
+            if (oldest === undefined)
+                break;
+            memory.delete(oldest);
+        }
+    },
+};

package/lib/types/components/trajectory/Inspector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Inspector.d.ts","sourceRoot":"","sources":["../../../../src/components/trajectory/Inspector.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,MAAM,EACN,MAAM,EACN,KAAK,EACL,QAAQ,EACR,MAAM,GACP,EAAE;IACD,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC1B,MAAM,EAAE,aAAa,GAAG,SAAS,CAAA;IACjC,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,QAAQ,EAAE,OAAO,CAAA;IACjB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,KAAK,CAAC,SAAS,CAiGlB"}
+{"version":3,"file":"Inspector.d.ts","sourceRoot":"","sources":["../../../../src/components/trajectory/Inspector.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,MAAM,EACN,MAAM,EACN,KAAK,EACL,QAAQ,EACR,MAAM,GACP,EAAE;IACD,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC1B,MAAM,EAAE,aAAa,GAAG,SAAS,CAAA;IACjC,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,QAAQ,EAAE,OAAO,CAAA;IACjB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,KAAK,CAAC,SAAS,CAyGlB"}

package/lib/types/components/trajectory/Inspector.js

@@ -1,6 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from '../../ui.js';
 import { formatDuration } from '../../trajectory/format.js';
+import { t } from '../../i18n.js';
 /**
  * The inspector — full detail for the focused row, in a fixed-height slot.
  *
@@ -25,6 +26,14 @@ export function Inspector({ node, detail, height, width, expanded, scroll, }) {
     // Flatten every section into display lines up front, so paging and
     // clipping operate on one uniform list.
     const lines = [];
+    // 还在等的审批/问卷行没有 durationMs，这里按渲染时刻算已等待时长；
+    // 场景与侧栏都在动画帧上重渲染，这行会随等待走动。
+    if (node.kind === 'approval' && node.status === 'running') {
+        lines.push({ text: t('trajectory-wait-elapsed', { duration: formatDuration(Math.max(0, Date.now() - node.time)) }) });
+    }
+    if (detail.unresolved === true) {
+        lines.push({ text: t('trajectory-inspect-unavailable'), tone: 'dim' });
+    }
     for (const section of detail.sections) {
         // A lone section whose heading repeats the pane title (a message row's
         // `assistant` under `assistant`) spends a line saying nothing.

package/lib/types/components/trajectory/Ledger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Ledger.d.ts","sourceRoot":"","sources":["../../../../src/components/trajectory/Ledger.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAgBjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AA6C1D,wBAAgB,MAAM,CAAC,EACrB,IAAI,EACJ,KAAK,EACL,MAAM,EACN,MAAM,EACN,KAAK,EACL,IAAI,EACJ,WAAW,EACX,WAAW,EACX,UAAU,GACX,EAAE;IACD,sCAAsC;IACtC,IAAI,EAAE,SAAS,QAAQ,EAAE,CAAA;IACzB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAA;IACnB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAA;IACnB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;CACxD,GAAG,KAAK,CAAC,SAAS,CAsKlB"}
+{"version":3,"file":"Ledger.d.ts","sourceRoot":"","sources":["../../../../src/components/trajectory/Ledger.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAgBjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AA6C1D,wBAAgB,MAAM,CAAC,EACrB,IAAI,EACJ,KAAK,EACL,MAAM,EACN,MAAM,EACN,KAAK,EACL,IAAI,EACJ,WAAW,EACX,WAAW,EACX,UAAU,GACX,EAAE;IACD,sCAAsC;IACtC,IAAI,EAAE,SAAS,QAAQ,EAAE,CAAA;IACzB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAA;IACnB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAA;IACnB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;CACxD,GAAG,KAAK,CAAC,SAAS,CA8KlB"}

package/lib/types/components/trajectory/Ledger.js

@@ -125,6 +125,12 @@ export function Ledger({ rows, start, height, cursor, width, tick, arrivalTick,
             const outcome = layout.outcome && node.outcome !== undefined && node.outcome !== ''
                 ? previewText(node.outcome, Math.max(8, Math.floor(layout.detail * 0.3)))
                 : '';
-            return (_jsxs(Box, { flexDirection: "row", width: "100%", height: 1, flexShrink: 0, gap: 1, ...rowEvents, children: [_jsx(Box, { flexShrink: 0, children: _jsxs(Text, { color: spineColor, children: [pointer, spineGlyph(rows, index)] }) }), layout.index && (_jsx(Box, { flexShrink: 0, width: 8, children: _jsx(Text, { color: "subtle", children: formatClock(node.time) }) })), _jsx(Box, { flexShrink: 0, children: _jsx(Text, { color: isNew ? mix(theme[KIND_FG[node.kind]], theme.text, arriving) : KIND_FG[node.kind], backgroundColor: badgeBg, bold: true, children: badge }) }), _jsx(Box, { flexGrow: 1, flexShrink: 1, overflow: "hidden", children: _jsxs(Text, { wrap: "truncate", color: focused ? 'suggestion' : node.seed === true ? 'subtle' : undefined, children: [label, detail === '' ? '' : ' ', _jsx(Text, { color: focused ? 'suggestion' : 'inactive', children: detail }), outcome === '' ? '' : _jsx(Text, { color: "subtle", children: `  → ${outcome}` })] }) }), _jsx(Box, { flexShrink: 0, children: _jsx(Text, { color: running ? 'success' : heatColor(duration), children: costGlyph(duration) }) }), _jsx(Box, { flexShrink: 0, justifyContent: "flex-end", width: 7, children: _jsx(Text, { color: running ? 'success' : heatColor(duration), children: running ? '…' : duration === undefined ? '' : formatDuration(duration) }) })] }, `${node.seq}:${node.kind}`));
+            return (_jsxs(Box, { flexDirection: "row", width: "100%", height: 1, flexShrink: 0, gap: 1, ...rowEvents, children: [_jsx(Box, { flexShrink: 0, children: _jsxs(Text, { color: spineColor, children: [pointer, spineGlyph(rows, index)] }) }), layout.index && (_jsx(Box, { flexShrink: 0, width: 8, children: _jsx(Text, { color: "subtle", children: formatClock(node.time) }) })), _jsx(Box, { flexShrink: 0, children: _jsx(Text, { color: isNew ? mix(theme[KIND_FG[node.kind]], theme.text, arriving) : KIND_FG[node.kind], backgroundColor: badgeBg, bold: true, children: badge }) }), _jsx(Box, { flexGrow: 1, flexShrink: 1, overflow: "hidden", children: _jsxs(Text, { wrap: "truncate", color: focused ? 'suggestion' : node.seed === true ? 'subtle' : undefined, children: [label, detail === '' ? '' : ' ', _jsx(Text, { color: focused ? 'suggestion' : 'inactive', children: detail }), outcome === '' ? '' : _jsx(Text, { color: "subtle", children: `  → ${outcome}` })] }) }), _jsx(Box, { flexShrink: 0, children: _jsx(Text, { color: running ? 'success' : heatColor(duration), children: costGlyph(duration) }) }), _jsx(Box, { flexShrink: 0, justifyContent: "flex-end", width: 7, children: _jsx(Text, { color: running ? 'success' : heatColor(duration), children: running
+                                ? node.kind === 'approval'
+                                    ? formatDuration(Math.max(0, Date.now() - node.time))
+                                    : '…'
+                                : duration === undefined
+                                    ? ''
+                                    : formatDuration(duration) }) })] }, `${node.seq}:${node.kind}`));
         }) }));
 }

package/lib/types/components/trajectory/scope.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Trajectory scope — the cross-agent drilldown selector (current agent /
+ * delegating turn / all descendants).
+ *
+ * The scope is a pure value describing WHICH lane's rows the trajectory
+ * surfaces render. `session` is the default and the pre-scope behavior;
+ * the other three kinds are all anchored on one drilldown target agent:
+ *
+ *  - `agent`        that agent's own lane log (its tools, its messages);
+ *  - `parent-turn`  the MAIN lane's rows of the delegating turn — the
+ *                   context the spawn happened in;
+ *  - `descendants`  the agent's whole subtree merged in emission order.
+ *
+ * Pure logic only (no React, no i18n): the surfaces build their chip text
+ * from {@link scopeChipParts} and drive the cycle through {@link drillScopeFrom}
+ * / {@link nextScope}.
+ */
+import type { TrajectoryLane } from '../../dsh-adapter/trajectory/index.js';
+import type { TrajNode } from '../../dsh-adapter/types.js';
+/** Which lane's rows the trajectory surfaces render. */
+export type TrajScope = {
+    readonly kind: 'session';
+} | {
+    readonly kind: 'agent';
+    readonly agentId: string;
+    readonly label: string;
+} | {
+    readonly kind: 'parent-turn';
+    readonly agentId: string;
+    readonly label: string;
+    readonly turn: number;
+} | {
+    readonly kind: 'descendants';
+    readonly agentId: string;
+    readonly label: string;
+};
+/** The lane's display label: its description, else model, else id head. */
+export declare function laneLabelOf(lane: TrajectoryLane): string;
+/**
+ * The lane a ledger row can drill into: a `subagent` descriptor row names
+ * its agent directly (the neutral source stamps `agentId`); the
+ * DELEGATING tool row anchors one through its `callId`.
+ */
+export declare function laneOfNode(node: TrajNode | undefined, lanes: readonly TrajectoryLane[]): TrajectoryLane | undefined;
+/**
+ * The MAIN-lane turn a lane's delegating call landed in — the 父回合 a
+ * drilldown can jump back to. `undefined` when the anchor call never
+ * folded into the main ledger (or the lane registered without a call).
+ */
+export declare function parentTurnOf(lane: TrajectoryLane, mainNodes: readonly TrajNode[]): number | undefined;
+/** Drill INTO the lane a focused row names; `undefined` = not drillable. */
+export declare function drillScopeFrom(node: TrajNode | undefined, lanes: readonly TrajectoryLane[]): TrajScope | undefined;
+/**
+ * The drill key's cycle: 当前 Agent → 父回合 → 全部后代 → 会话. The parent
+ * turn is skipped when it cannot be resolved; a scope whose lane vanished
+ * (a reset) falls straight back to the session.
+ */
+export declare function nextScope(scope: TrajScope, lanes: readonly TrajectoryLane[], mainNodes: readonly TrajNode[]): TrajScope;
+/** The scope chip's i18n key and interpolation params (`undefined` = hide). */
+export declare function scopeChipParts(scope: TrajScope): {
+    readonly key: 'trajectory-view-agent' | 'trajectory-view-parent' | 'trajectory-view-descendants';
+    readonly params: Readonly<Record<string, string | number>>;
+} | undefined;
+//# sourceMappingURL=scope.d.ts.map

package/lib/types/components/trajectory/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../../src/components/trajectory/scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAA;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAE1D,wDAAwD;AACxD,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC5E;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzG;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtF,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAIxD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,EAAE,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,cAAc,GAAG,SAAS,CAKnH;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,GAAG,SAAS,CAMrG;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAC5B,IAAI,EAAE,QAAQ,GAAG,SAAS,EAC1B,KAAK,EAAE,SAAS,cAAc,EAAE,GAC/B,SAAS,GAAG,SAAS,CAGvB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,cAAc,EAAE,EAAE,SAAS,EAAE,SAAS,QAAQ,EAAE,GAAG,SAAS,CAYvH;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG;IAChD,QAAQ,CAAC,GAAG,EAAE,uBAAuB,GAAG,wBAAwB,GAAG,6BAA6B,CAAA;IAChG,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAA;CAC3D,GAAG,SAAS,CAOZ"}

package/lib/types/components/trajectory/scope.js

@@ -0,0 +1,88 @@
+/**
+ * Trajectory scope — the cross-agent drilldown selector (current agent /
+ * delegating turn / all descendants).
+ *
+ * The scope is a pure value describing WHICH lane's rows the trajectory
+ * surfaces render. `session` is the default and the pre-scope behavior;
+ * the other three kinds are all anchored on one drilldown target agent:
+ *
+ *  - `agent`        that agent's own lane log (its tools, its messages);
+ *  - `parent-turn`  the MAIN lane's rows of the delegating turn — the
+ *                   context the spawn happened in;
+ *  - `descendants`  the agent's whole subtree merged in emission order.
+ *
+ * Pure logic only (no React, no i18n): the surfaces build their chip text
+ * from {@link scopeChipParts} and drive the cycle through {@link drillScopeFrom}
+ * / {@link nextScope}.
+ */
+/** The lane's display label: its description, else model, else id head. */
+export function laneLabelOf(lane) {
+    if (lane.label !== undefined && lane.label !== '')
+        return lane.label;
+    if (lane.model !== undefined && lane.model !== '')
+        return lane.model;
+    return lane.agentId.slice(0, 8);
+}
+/**
+ * The lane a ledger row can drill into: a `subagent` descriptor row names
+ * its agent directly (the neutral source stamps `agentId`); the
+ * DELEGATING tool row anchors one through its `callId`.
+ */
+export function laneOfNode(node, lanes) {
+    if (node === undefined)
+        return undefined;
+    if (node.agentId !== undefined)
+        return lanes.find(lane => lane.agentId === node.agentId);
+    if (node.callId !== undefined)
+        return lanes.find(lane => lane.callId === node.callId);
+    return undefined;
+}
+/**
+ * The MAIN-lane turn a lane's delegating call landed in — the 父回合 a
+ * drilldown can jump back to. `undefined` when the anchor call never
+ * folded into the main ledger (or the lane registered without a call).
+ */
+export function parentTurnOf(lane, mainNodes) {
+    if (lane.callId === undefined)
+        return undefined;
+    for (const node of mainNodes) {
+        if (node.callId === lane.callId && (node.kind === 'tool' || node.kind === 'subtool'))
+            return node.turn;
+    }
+    return undefined;
+}
+/** Drill INTO the lane a focused row names; `undefined` = not drillable. */
+export function drillScopeFrom(node, lanes) {
+    const lane = laneOfNode(node, lanes);
+    return lane === undefined ? undefined : { kind: 'agent', agentId: lane.agentId, label: laneLabelOf(lane) };
+}
+/**
+ * The drill key's cycle: 当前 Agent → 父回合 → 全部后代 → 会话. The parent
+ * turn is skipped when it cannot be resolved; a scope whose lane vanished
+ * (a reset) falls straight back to the session.
+ */
+export function nextScope(scope, lanes, mainNodes) {
+    if (scope.kind === 'session')
+        return scope;
+    const lane = lanes.find(entry => entry.agentId === scope.agentId);
+    if (lane === undefined)
+        return { kind: 'session' };
+    if (scope.kind === 'agent') {
+        const turn = parentTurnOf(lane, mainNodes);
+        return turn === undefined
+            ? { kind: 'descendants', agentId: lane.agentId, label: laneLabelOf(lane) }
+            : { kind: 'parent-turn', agentId: lane.agentId, label: laneLabelOf(lane), turn };
+    }
+    if (scope.kind === 'parent-turn')
+        return { kind: 'descendants', agentId: lane.agentId, label: laneLabelOf(lane) };
+    return { kind: 'session' };
+}
+/** The scope chip's i18n key and interpolation params (`undefined` = hide). */
+export function scopeChipParts(scope) {
+    switch (scope.kind) {
+        case 'agent': return { key: 'trajectory-view-agent', params: { label: scope.label } };
+        case 'parent-turn': return { key: 'trajectory-view-parent', params: { turn: scope.turn } };
+        case 'descendants': return { key: 'trajectory-view-descendants', params: { label: scope.label } };
+        default: return undefined;
+    }
+}

package/lib/types/components/trajectory/useTrajectoryScope.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The scope state + scoped data plane shared by the trajectory scene and
+ * the side panel.
+ *
+ * The hook owns three things the two surfaces would otherwise drift on:
+ *
+ * - the lane roster, read tolerantly (trajectoryLanes is an optional
+ *   capability — a source without lane attribution offers no filter);
+ * - the scoped node list + event snapshot every downstream region
+ *   (query, wave, ledger, inspector, hotspot) renders from — ONE
+ *   substitution point, so a scoped view can never show the session's
+ *   wave over the lane's ledger;
+ * - the lane fold itself, kept incremental per scope exactly the way Chat
+ *   keeps the main one: extended during render against the lane snapshot's
+ *   prefix identity, refolded from scratch when the scope switches.
+ */
+import { type RawTrajEvent, type TrajBuild, type TrajectoryLane } from '../../dsh-adapter/trajectory/index.js';
+import type { TrajNode } from '../../dsh-adapter/types.js';
+import type { ChannelUi } from '../../adapter/channel/ui-policy.js';
+import { type TrajScope } from './scope.js';
+/** One scoped data plane: the rows to render and the log to inspect from. */
+export interface ScopedTrajectory {
+    readonly nodes: readonly TrajNode[];
+    readonly events: readonly RawTrajEvent[];
+    /**
+     * The scoped build the aggregators read. For lane scopes this is the
+     * lane's own incremental build; for parent-turn a derived view over the
+     * main build (its nodes filtered, its timing slots shared); for session
+     * the main build itself, untouched.
+     */
+    readonly build: TrajBuild;
+}
+export declare function useTrajectoryScope(channel: ChannelUi | undefined, build: TrajBuild): {
+    readonly scope: TrajScope;
+    readonly lanes: readonly TrajectoryLane[];
+    readonly scoped: ScopedTrajectory;
+    /** The drill key / chip click: drill from a focused row, or cycle. */
+    drill(node: TrajNode | undefined): void;
+    /** Esc's first layer: true when a non-session scope consumed the press. */
+    popScope(): boolean;
+};
+//# sourceMappingURL=useTrajectoryScope.d.ts.map

package/lib/types/components/trajectory/useTrajectoryScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTrajectoryScope.d.ts","sourceRoot":"","sources":["../../../../src/components/trajectory/useTrajectoryScope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAqC,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,uCAAuC,CAAA;AACjJ,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AACnE,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAKtE,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAA;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG;IACpF,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAA;IACzC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,sEAAsE;IACtE,KAAK,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAA;IACvC,2EAA2E;IAC3E,QAAQ,IAAI,OAAO,CAAA;CACpB,CAqEA"}

package/lib/types/components/trajectory/useTrajectoryScope.js

@@ -0,0 +1,86 @@
+/**
+ * The scope state + scoped data plane shared by the trajectory scene and
+ * the side panel.
+ *
+ * The hook owns three things the two surfaces would otherwise drift on:
+ *
+ * - the lane roster, read tolerantly (trajectoryLanes is an optional
+ *   capability — a source without lane attribution offers no filter);
+ * - the scoped node list + event snapshot every downstream region
+ *   (query, wave, ledger, inspector, hotspot) renders from — ONE
+ *   substitution point, so a scoped view can never show the session's
+ *   wave over the lane's ledger;
+ * - the lane fold itself, kept incremental per scope exactly the way Chat
+ *   keeps the main one: extended during render against the lane snapshot's
+ *   prefix identity, refolded from scratch when the scope switches.
+ */
+import React from 'react';
+import { emptyTrajectory, extendTrajectory } from '../../dsh-adapter/trajectory/index.js';
+import { drillScopeFrom, nextScope } from './scope.js';
+const NO_EVENTS = [];
+const NO_LANES = [];
+export function useTrajectoryScope(channel, build) {
+    const [scope, setScope] = React.useState({ kind: 'session' });
+    // The roster rebuilds when the main build grows (lanes register on
+    // subagent.start, which appends to the main log) — the same staleness
+    // contract every other per-render read follows.
+    const lanes = React.useMemo(
+    // oxlint-disable-next-line react-hooks/exhaustive-deps
+    () => (channel !== undefined && typeof channel.trajectoryLanes === 'function' ? channel.trajectoryLanes() : NO_LANES), [channel, build]);
+    /** The lane fold, keyed by scope so a switch refolds from scratch. */
+    const laneBuildRef = React.useRef({ key: '', build: null });
+    // The parent-turn view is derived from the main build; memoized so the
+    // animation tick does not refilter the ledger and invalidate every
+    // aggregate keyed on the scoped build.
+    const parentTurn = scope.kind === 'parent-turn' ? scope.turn : undefined;
+    const parentTurnBuild = React.useMemo(() => {
+        if (parentTurn === undefined)
+            return undefined;
+        const filtered = build.nodes.filter(node => node.turn === parentTurn);
+        return { source: build.source, nodes: filtered, timing: build.timing, counts: build.counts, state: build.state };
+    }, [build, parentTurn]);
+    let nodes = build.nodes;
+    let events = NO_EVENTS;
+    let scopedBuild = build;
+    if (scope.kind === 'agent' || scope.kind === 'descendants') {
+        const descendants = scope.kind === 'descendants';
+        const key = scope.agentId + ':' + (descendants ? 'd' : 'a');
+        if (laneBuildRef.current.key !== key)
+            laneBuildRef.current = { key, build: null };
+        // Per-render incremental extend (the lane's events grow without the
+        // main build changing — a memo keyed on the main build would never see
+        // the tail; Chat's own main fold follows the same render-time pattern).
+        const snapshot = channel !== undefined && typeof channel.trajectoryLaneEvents === 'function'
+            ? channel.trajectoryLaneEvents(scope.agentId, descendants)
+            : NO_EVENTS;
+        laneBuildRef.current.build = extendTrajectory(laneBuildRef.current.build, snapshot);
+        scopedBuild = laneBuildRef.current.build ?? emptyTrajectory();
+        nodes = scopedBuild.nodes;
+        events = snapshot;
+    }
+    else if (parentTurnBuild !== undefined) {
+        // The main lane's rows of the delegating turn: a derived view (the
+        // timing slots stay the main build's — keyed turn:step, they answer
+        // this turn's TTFT/decode questions exactly).
+        nodes = parentTurnBuild.nodes;
+        events = (channel?.traceEvents?.() ?? NO_EVENTS);
+        scopedBuild = parentTurnBuild;
+    }
+    else {
+        events = (channel?.traceEvents?.() ?? NO_EVENTS);
+    }
+    const drill = React.useCallback((node) => {
+        setScope(previous => {
+            if (previous.kind === 'session')
+                return drillScopeFrom(node, lanes) ?? previous;
+            return nextScope(previous, lanes, build.nodes);
+        });
+    }, [lanes, build]);
+    const popScope = React.useCallback(() => {
+        if (scope.kind === 'session')
+            return false;
+        setScope({ kind: 'session' });
+        return true;
+    }, [scope]);
+    return { scope, lanes, scoped: { nodes, events, build: scopedBuild }, drill, popScope };
+}

package/lib/types/customTheme.d.ts

@@ -21,7 +21,7 @@
  */
 import { type Theme, type ThemeColorKey } from './theme.js';
 /** The base palettes a user theme may overlay. */
-export declare const THEME_BASE_NAMES: readonly ["light", "dark", "dark-ansi"];
+export declare const THEME_BASE_NAMES: readonly ["light", "dark", "dark-ansi", "claude-dark", "claude-paper", "codex-lavender", "codex-paper"];
 export type ThemeBase = (typeof THEME_BASE_NAMES)[number];
 /** The directory user theme files live in (~/.dsh-tui/themes). */
 export declare const CUSTOM_THEME_DIR: string;
@@ -96,11 +96,9 @@ export declare function buildTheme(spec: CustomThemeSpec): Theme;
  */
 export declare function resolveCustomTheme(name: string): Theme | undefined;
 /**
- * Whether a name selects a usable theme: a built-in palette, the `auto`
- * pseudo-theme, or a valid user theme file. Used for DSH_TUI_THEME /
- * persisted-preference validation and the runtime /theme switch.
- * @param name - Candidate theme name.
- * @returns True when the theme resolves.
+ * Availability from this module's static view: built-ins, `auto`, a valid user
+ * theme file. Runtime (plugin) themes belong to theme.isThemeAvailable(); the
+ * callers here are the static verification scripts.
  */
 export declare function isThemeAvailable(name: string): boolean;
 /** Drop the resolved-theme cache and name index (tests, or after themes change on disk). */

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

@@ -1 +1 @@
-{"version":3,"file":"customTheme.d.ts","sourceRoot":"","sources":["../../src/customTheme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,EAML,KAAK,KAAK,EACV,KAAK,aAAa,EACnB,MAAM,YAAY,CAAA;AAGnB,kDAAkD;AAClD,eAAO,MAAM,gBAAgB,yCAA0C,CAAA;AACvE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEzD,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,QAA2B,CAAA;AAExD,6EAA6E;AAC7E,MAAM,MAAM,eAAe,GAAG;IAC5B,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAA;IACnB,gDAAgD;IAChD,IAAI,EAAE,SAAS,CAAA;IACf,oEAAoE;IACpE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IACtB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAuCD,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQrD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAUjE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,eAAe,GAAG,SAAS,CAwE7B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAAyB,GAC7B,eAAe,GAAG,SAAS,CAQ7B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAyB,GAAG,eAAe,EAAE,CAclF;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,KAAK,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAWlE;AAcD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C"}
+{"version":3,"file":"customTheme.d.ts","sourceRoot":"","sources":["../../src/customTheme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,EAOL,KAAK,KAAK,EACV,KAAK,aAAa,EACnB,MAAM,YAAY,CAAA;AAGnB,kDAAkD;AAClD,eAAO,MAAM,gBAAgB,yGAA0G,CAAA;AACvI,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEzD,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,QAA2B,CAAA;AAExD,6EAA6E;AAC7E,MAAM,MAAM,eAAe,GAAG;IAC5B,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAA;IACnB,gDAAgD;IAChD,IAAI,EAAE,SAAS,CAAA;IACf,oEAAoE;IACpE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IACtB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAuCD,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQrD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAUjE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,eAAe,GAAG,SAAS,CAwE7B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAAyB,GAC7B,eAAe,GAAG,SAAS,CAQ7B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAyB,GAAG,eAAe,EAAE,CAclF;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,KAAK,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAWlE;AAcD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C"}

package/lib/types/customTheme.js

@@ -21,10 +21,10 @@
  */
 import { readdirSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { getTheme, AUTO_THEME_NAME, isThemeColorKey, normalizeThemeKey, isRetiredThemeKey, } from './theme.js';
+import { getTheme, AUTO_THEME_NAME, isBuiltInThemeName, isThemeColorKey, normalizeThemeKey, isRetiredThemeKey, } from './theme.js';
 import { DATA_DIR } from './utils/paths.js';
 /** The base palettes a user theme may overlay. */
-export const THEME_BASE_NAMES = ['light', 'dark', 'dark-ansi'];
+export const THEME_BASE_NAMES = ['light', 'dark', 'dark-ansi', 'claude-dark', 'claude-paper', 'codex-lavender', 'codex-paper'];
 /** The directory user theme files live in (~/.dsh-tui/themes). */
 export const CUSTOM_THEME_DIR = join(DATA_DIR, 'themes');
 // #rgb / #rrggbb / #rrggbbaa
@@ -262,14 +262,12 @@ function indexCustomThemeNames() {
     nameIndexed = true;
 }
 /**
- * Whether a name selects a usable theme: a built-in palette, the `auto`
- * pseudo-theme, or a valid user theme file. Used for DSH_TUI_THEME /
- * persisted-preference validation and the runtime /theme switch.
- * @param name - Candidate theme name.
- * @returns True when the theme resolves.
+ * Availability from this module's static view: built-ins, `auto`, a valid user
+ * theme file. Runtime (plugin) themes belong to theme.isThemeAvailable(); the
+ * callers here are the static verification scripts.
  */
 export function isThemeAvailable(name) {
-    if (name === AUTO_THEME_NAME || isThemeBase(name))
+    if (name === AUTO_THEME_NAME || isBuiltInThemeName(name))
         return true;
     return resolveCustomTheme(name) !== undefined;
 }

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

@@ -12,13 +12,21 @@
  * Outcomes are the protocol's closed set — `'allowed-once'` and
  * `'rejected'` from the panel, `'cancelled'` on abort/teardown; there is
  * no allow-always or feedback channel in the protocol.
+ *
+ * The store presents its asks through the shared permission-panel shape
+ * (`src/channel/permissions.ts`), so the one approval panel renders DSH and
+ * backend prompts alike: a DSH ask offers exactly the protocol's two
+ * options (allow once / reject), and the DSH-only facts (the `external`
+ * source badge, the background-session id) ride along on the snapshot.
  */
 import { compositionRoot } from './host-access.js';
 import { type AdapterRuntimeOptions } from '../adapter/kernel/runtime.js';
 import type { ApprovalOutcome, ApprovalRequest } from '@deepseek-ai/dsh-user-approval';
 import type { SessionEvent } from '@deepseek-ai/dsh-session';
-/** What the TUI renders while an approval is pending. */
-export interface ApprovalSnapshot {
+import { type PermissionPanelDecision, type PermissionPanelOutcome, type PermissionPanelSnapshot, type PermissionPanelSource } from '../channel/permissions.js';
+/** What the TUI renders while an approval is pending (the shared panel
+ *  shape plus the DSH facts it documents below). */
+export interface ApprovalSnapshot extends PermissionPanelSnapshot {
     /** Stable key so the panel remounts (fresh focus state) per request. */
     readonly key: string;
     readonly toolName: string;
@@ -49,6 +57,8 @@ export interface ApprovalSnapshot {
      * "needs input" instead of hanging on a fail-closed answer).
      */
     readonly agentId: string;
+    /** The protocol's two choices: allow once / reject. */
+    readonly options: PermissionPanelSnapshot['options'];
 }
 /** Host-only registration used by the TUI plugin bootstrap. */
 export declare function bindApprovalStore(ctx: Parameters<typeof compositionRoot>[0], store: ApprovalStore): void;
@@ -60,7 +70,7 @@ export declare function getApprovalStore(ctx: Parameters<typeof compositionRoot>
  * the ask is withdrawn. The TUI subscribes for re-renders and decides via
  * {@link ApprovalStore.decide}.
  */
-export declare class ApprovalStore {
+export declare class ApprovalStore implements PermissionPanelSource {
     private readonly runtime;
     constructor(runtime?: AdapterRuntimeOptions);
     private readonly queue;
@@ -193,9 +203,12 @@ export declare class ApprovalStore {
     /**
      * The user decided on the current approval; settles it and drains the
      * next queued ask if any. No-op when nothing is pending.
-     * @param outcome - `'allowed-once'` or `'rejected'`.
+     * @param outcome - `'allowed-once'` or `'rejected'`. The protocol has no
+     *   allow-always and the panel never offers it for a DSH ask; one arriving
+     *   anyway is refused (fail closed). The panel's option detail carries
+     *   nothing the protocol can use beyond its panel key.
      */
-    decide(outcome: 'allowed-once' | 'rejected'): void;
+    decide(outcome: PermissionPanelOutcome, decision?: PermissionPanelDecision): void;
     /**
      * Settle the active and all queued asks (plugin teardown). The panel
      * unmounts as the snapshot clears.

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

@@ -1 +1 @@
-{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/approvals.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/approvals.ts"],"names":[],"mappings":"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"}

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

@@ -12,10 +12,17 @@
  * Outcomes are the protocol's closed set — `'allowed-once'` and
  * `'rejected'` from the panel, `'cancelled'` on abort/teardown; there is
  * no allow-always or feedback channel in the protocol.
+ *
+ * The store presents its asks through the shared permission-panel shape
+ * (`src/channel/permissions.ts`), so the one approval panel renders DSH and
+ * backend prompts alike: a DSH ask offers exactly the protocol's two
+ * options (allow once / reject), and the DSH-only facts (the `external`
+ * source badge, the background-session id) ride along on the snapshot.
  */
 import { compositionRoot } from './host-access.js';
 import { assertCapabilityShadowPolicy, defaultAdapterRuntime, } from '../adapter/kernel/runtime.js';
 import { snapshotLiveSessionEvents } from './compat/liveSession.js';
+import { DEFAULT_PERMISSION_OPTIONS, } from '../channel/permissions.js';
 const approvalStores = new WeakMap();
 /** Host-only registration used by the TUI plugin bootstrap. */
 export function bindApprovalStore(ctx, store) {
@@ -221,7 +228,7 @@ export class ApprovalStore {
         const pending = this.active;
         this.snapshotCache = pending === undefined
             ? null
-            : { key: pending.key, ...pending.snapshot };
+            : { key: pending.key, ...pending.snapshot, options: DEFAULT_PERMISSION_OPTIONS };
     }
     /**
      * Re-run the source-badge verdict for the active ask (P-4).
@@ -388,16 +395,22 @@ export class ApprovalStore {
     /**
      * The user decided on the current approval; settles it and drains the
      * next queued ask if any. No-op when nothing is pending.
-     * @param outcome - `'allowed-once'` or `'rejected'`.
+     * @param outcome - `'allowed-once'` or `'rejected'`. The protocol has no
+     *   allow-always and the panel never offers it for a DSH ask; one arriving
+     *   anyway is refused (fail closed). The panel's option detail carries
+     *   nothing the protocol can use beyond its panel key.
      */
-    decide(outcome) {
+    decide(outcome, decision) {
         const pending = this.active;
         if (pending === undefined)
             return;
+        // A keystroke the withdrawn panel still handled answers nothing.
+        if (decision?.key !== undefined && decision.key !== pending.key)
+            return;
         this.noteConsumed(pending);
         this.active = undefined;
         this.rebuildSnapshot();
-        pending.resolve(outcome);
+        pending.resolve(outcome === 'allowed-once' ? 'allowed-once' : 'rejected');
         this.startNext();
         this.emit();
     }