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

package/lib/types/dsh-adapter/context-occupancy.d.ts

@@ -104,13 +104,18 @@ export declare function contextPressureUsedTokens(view: ContextPressureView): nu
  * @param projected - Cached `contextPressure` value, `undefined` without a meter.
  * @param sample - Last settled request's billed usage (the fallback numerator).
  * @param requestWindow - `request/context` capacity (the fallback denominator).
+ * @param backendUsage - Backend-measured occupancy; preferred over billed usage
+ * when DSH's projection has no reading.
  * @returns the reading, or `undefined` when neither path knows anything.
  */
 export declare function resolveContextOccupancy(projected: ContextPressureView | undefined, sample: {
     input: number;
     cacheRead: number;
     cacheWrite: number;
-} | undefined, requestWindow: number | undefined): ContextOccupancy | undefined;
+} | undefined, requestWindow: number | undefined, backendUsage?: {
+    readonly used: number;
+    readonly max?: number;
+}): ContextOccupancy | undefined;
 /**
  * The latest `contextPressure` value for the session on screen.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"context-occupancy.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/context-occupancy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAGxE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAEjE,yDAAyD;AACzD,eAAO,MAAM,+BAA+B,oBAAoB,CAAA;AAEhE;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,iGAAiG;IACjG,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,2GAA2G;IAC3G,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,sEAAsE;IACtE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAChC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAA;IACxD,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;CAC5C;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,GAAG,SAAS,CAYrF;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAEvF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,mBAAmB,GAAG,SAAS,EAC1C,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EAC5E,aAAa,EAAE,MAAM,GAAG,SAAS,GAChC,gBAAgB,GAAG,SAAS,CAY9B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAsB,YAAW,qBAAqB;IACjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,+EAA+E;IAC/E,OAAO,CAAC,SAAS,CAAoB;IACrC,kFAAkF;IAClF,OAAO,CAAC,cAAc,CAAS;IAC/B,yEAAyE;IACzE,OAAO,CAAC,QAAQ,CAAoC;IACpD,gFAAgF;IAChF,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyC;gBAElD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;IAI5C;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAKtD;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAe5B;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI/C,iEAAiE;IACjE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAIxD,oEAAoE;IACpE,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAK3C;;;;OAIG;IACH,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAOrC,mFAAmF;IACnF,OAAO,CAAC,QAAQ;IAiBhB,yEAAyE;IACzE,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,IAAI;CAGb;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAwBhG;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,OAAO,GAAG,qBAAqB,CAI/E"}
+{"version":3,"file":"context-occupancy.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/context-occupancy.ts"],"names":[],"mappings":"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"}

package/lib/types/dsh-adapter/context-occupancy.js

@@ -94,14 +94,19 @@ export function contextPressureUsedTokens(view) {
  * @param projected - Cached `contextPressure` value, `undefined` without a meter.
  * @param sample - Last settled request's billed usage (the fallback numerator).
  * @param requestWindow - `request/context` capacity (the fallback denominator).
+ * @param backendUsage - Backend-measured occupancy; preferred over billed usage
+ * when DSH's projection has no reading.
  * @returns the reading, or `undefined` when neither path knows anything.
  */
-export function resolveContextOccupancy(projected, sample, requestWindow) {
+export function resolveContextOccupancy(projected, sample, requestWindow, backendUsage) {
     const contextWindow = projected?.contextWindow ?? requestWindow;
     const projectedUsed = projected === undefined ? undefined : contextPressureUsedTokens(projected);
     if (projectedUsed !== undefined) {
         return { usedTokens: projectedUsed, contextWindow, source: 'projection' };
     }
+    if (backendUsage !== undefined) {
+        return { usedTokens: backendUsage.used, contextWindow: backendUsage.max ?? contextWindow, source: 'backend' };
+    }
     if (sample === undefined)
         return undefined;
     return {

package/lib/types/dsh-adapter/decision-guard.d.ts

@@ -84,6 +84,30 @@ export declare function decisionRegistryOf(ctx: Context): DecisionRegistry;
 export declare function decisionHandlersOf(ctx: Context, event: string, payloadScope?: string): readonly RegisteredDecisionHandler[];
 /** Host-only registration used by TuiPluginHostRuntime. */
 export declare function registerDecisionHandler(pluginCtx: Context, identity: VerifiedComponentIdentity, event: string, listener: (payload: Record<string, unknown>) => unknown, options?: DecisionRegistrationOptions, onRelease?: () => void): () => boolean;
+/** Liveness re-check for a handler snapshot taken before an `await`.
+ *
+ * Decision dispatch awaits plugin handlers, and both grant revocation and
+ * deactivation release their registration while that await is pending. A
+ * snapshot captured at loop start therefore cannot authorize a *late* return
+ * value: a revoked or unloaded component must not be able to veto or rewrite a
+ * user flow with an answer that arrives after its authority ended.
+ *
+ * Liveness is the conjunction of two facts, both cheap and both read live:
+ *
+ * - a row for this activation/event/order is still installed (deactivation and
+ *   grant revocation both release the registration, so a released row is gone);
+ * - the grant still allows this principal at the effective scope (covers a
+ *   store change whose change-watcher has not run yet, or a store with no
+ *   watcher at all).
+ *
+ * The installed check compares the row's own identity rather than the map's
+ * internal key: the registry is host-owned storage, and whether a handler is
+ * still live must not depend on how a row happens to be keyed inside it. In
+ * production `registerDecisionHandler` is the only writer and keys rows by
+ * `activation\0event\0order`; keeping the check identity-based leaves that as
+ * an implementation detail instead of a behavioural requirement.
+ */
+export declare function isDecisionHandlerLive(ctx: Context, handler: RegisteredDecisionHandler, payloadScope?: string): boolean;
 /** Execute ctx.on for one host-mediated decision registration. */
 export declare function withDecisionRegistration<T>(ctx: Context, callback: () => T): T;
 export declare function decisionHandlerMetadataOf(listener: Function): DecisionHandlerMetadata | undefined;

package/lib/types/dsh-adapter/decision-guard.d.ts.map

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

package/lib/types/dsh-adapter/decision-guard.js

@@ -276,6 +276,50 @@ export function registerDecisionHandler(pluginCtx, identity, event, listener, op
     }
     return release;
 }
+/** Liveness re-check for a handler snapshot taken before an `await`.
+ *
+ * Decision dispatch awaits plugin handlers, and both grant revocation and
+ * deactivation release their registration while that await is pending. A
+ * snapshot captured at loop start therefore cannot authorize a *late* return
+ * value: a revoked or unloaded component must not be able to veto or rewrite a
+ * user flow with an answer that arrives after its authority ended.
+ *
+ * Liveness is the conjunction of two facts, both cheap and both read live:
+ *
+ * - a row for this activation/event/order is still installed (deactivation and
+ *   grant revocation both release the registration, so a released row is gone);
+ * - the grant still allows this principal at the effective scope (covers a
+ *   store change whose change-watcher has not run yet, or a store with no
+ *   watcher at all).
+ *
+ * The installed check compares the row's own identity rather than the map's
+ * internal key: the registry is host-owned storage, and whether a handler is
+ * still live must not depend on how a row happens to be keyed inside it. In
+ * production `registerDecisionHandler` is the only writer and keys rows by
+ * `activation\0event\0order`; keeping the check identity-based leaves that as
+ * an implementation detail instead of a behavioural requirement.
+ */
+export function isDecisionHandlerLive(ctx, handler, payloadScope) {
+    const registry = registryFor(ctx);
+    const rows = registry.handlers.get(handler.event);
+    if (rows === undefined)
+        return false;
+    let installed = false;
+    for (const row of rows.values()) {
+        if (row.activationId === handler.activationId
+            && row.event === handler.event
+            && row.order === handler.order) {
+            installed = true;
+            break;
+        }
+    }
+    if (!installed)
+        return false;
+    const permission = eventPermission(handler.event);
+    if (permission === undefined)
+        return true;
+    return registry.grants.allows({ componentId: handler.componentId, activationId: handler.activationId }, permission, payloadScope ?? handler.scope);
+}
 /** Locale-independent comparator for the declared decision order policy.
  * `localeCompare()` can vary with host ICU settings, which would make the
  * winner depend on the machine running the same admitted component set. */

package/lib/types/dsh-adapter/extension-events.d.ts

@@ -41,7 +41,10 @@ export declare const DECISION_TOTAL_TIMEOUT_MS = 5000;
  *   logged and skipped like any other invalid shape;
  * - "no opinion" (undefined/null/false) and invalid shapes are logged and
  *   the chain CONTINUES;
- * - the first listener whose NORMALIZED decision is non-undefined wins.
+ * - the first listener whose NORMALIZED decision is non-undefined wins;
+ * - a decision that arrives after the handler was released (grant revoked,
+ *   activation unloaded) is DISCARDED and the chain continues, because a
+ *   handler is awaited: authority can end while its answer is still pending.
  *
  * Handlers come from the host-mediated DecisionEvents registry.  Raw Cordis
  * `ctx.on` listeners are intentionally absent from this path.

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

@@ -1 +1 @@
-{"version":3,"file":"extension-events.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/extension-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAA;AACxE,YAAY,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAA;AACxE;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAYlD;;wEAEwE;AACxE,eAAO,MAAM,2BAA2B,OAAO,CAAA;AAC/C,eAAO,MAAM,yBAAyB,OAAO,CAAA;AA4C7C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,KAAK,CAAC,GAAG,SAAS,GAC1E,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CA4DxB;AAED;uEACuE;AACvE,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC,CAwCf;AAED;;;kDAGkD;AAClD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC3B;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAQ/C;AAED,mDAAmD;AACnD,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAA;IACjB,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAc,SAAQ,kBAAkB;IACvD,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,2EAA2E;IAC3E,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAA;CAC/B;AAED,MAAM,MAAM,gBAAgB;AAC1B,6DAA6D;AAC3D;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;AAClB;+EAC+E;GAC7E;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;AACpC,kEAAkE;GAChE;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;AACnC,gDAAgD;GAC9C,SAAS,CAAA;AAEb;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,MAAM,uBAAuB;AACjC,2EAA2E;AACzE;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;AACnC;0DAC0D;GACxD;IAAE,KAAK,EAAE,SAAS,aAAa,EAAE,CAAA;CAAE;AACrC,oEAAoE;GAClE,SAAS,CAAA;AAEb;;;;GAIG;AACH,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAA;IACZ;oCACgC;IAChC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAA;IACnB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAA;IACvB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAA;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,MAAM,wBAAwB;AAClC;4BAC4B;AAC1B;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC,SAAS,CAAA;AAEb;;;;;GAKG;AACH,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB;IACjE,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAA;IAC1C,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,2CAA2C;AAC3C,MAAM,WAAW,eAAgB,SAAQ,kBAAkB;CAAG;AAE9D,MAAM,MAAM,kBAAkB;AAC5B,qEAAqE;AACnE;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC,SAAS,CAAA;AAEb,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,MAAM;QACd,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;QAC/E,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,GAAG,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA;QAC5G,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;QAC9F,oBAAoB,CAAC,KAAK,EAAE,qBAAqB,GAAG,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAA;QAChH,sBAAsB,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;QAC5E,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;KACxF;CACF"}
+{"version":3,"file":"extension-events.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/extension-events.ts"],"names":[],"mappings":"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"}

package/lib/types/dsh-adapter/extension-events.js

@@ -1,5 +1,5 @@
 import { cleanScalarText } from './sanitize.js';
-import { DECISION_EVENT_PERMISSIONS, decisionHandlersOf, decisionRegistryOf, } from './decision-guard.js';
+import { DECISION_EVENT_PERMISSIONS, decisionHandlersOf, decisionRegistryOf, isDecisionHandlerLive, } from './decision-guard.js';
 /** Toast-bound plugin text (veto reasons) is render-path data: sanitized
  *  with the one shared implementation, capped at toast width. */
 const NOTICE_CELLS = 200;
@@ -64,7 +64,10 @@ async function runBounded(task, timeoutMs) {
  *   logged and skipped like any other invalid shape;
  * - "no opinion" (undefined/null/false) and invalid shapes are logged and
  *   the chain CONTINUES;
- * - the first listener whose NORMALIZED decision is non-undefined wins.
+ * - the first listener whose NORMALIZED decision is non-undefined wins;
+ * - a decision that arrives after the handler was released (grant revoked,
+ *   activation unloaded) is DISCARDED and the chain continues, because a
+ *   handler is awaited: authority can end while its answer is still pending.
  *
  * Handlers come from the host-mediated DecisionEvents registry.  Raw Cordis
  * `ctx.on` listeners are intentionally absent from this path.
@@ -86,13 +89,12 @@ export async function dispatchTuiDecision(ctx, name, payload, normalize) {
     };
     const started = Date.now();
     for (const handler of listeners) {
-        const permission = DECISION_EVENT_PERMISSIONS[name];
-        const principal = { componentId: handler.componentId, activationId: handler.activationId };
-        if (permission !== undefined
-            // Re-check the handler's declared scope at the concrete payload scope.
-            // GrantStore applies parent-scope grants and narrow deny precedence, so
-            // an event-wide grant cannot bypass a revoked session.
-            && !decisionRegistryOf(ctx).grants.allows(principal, permission, scope ?? handler.scope)) {
+        // The handler's declared scope and its live grant, checked at the concrete
+        // payload scope. GrantStore applies parent-scope grants and narrow deny
+        // precedence, so an event-wide grant cannot bypass a revoked session; the
+        // same check re-runs after the await below.
+        const effectiveScope = scope ?? handler.scope;
+        if (!isDecisionHandlerLive(ctx, handler, effectiveScope)) {
             log(`dsh-tui: ${name} handler from Component "${handler.componentId}" skipped after grant revocation`);
             continue;
         }
@@ -123,8 +125,18 @@ export async function dispatchTuiDecision(ctx, name, payload, normalize) {
             log(`dsh-tui: ${name} listener returned a value that threw during validation; ignored: %o`, error);
             continue;
         }
-        if (decision !== undefined)
+        if (decision !== undefined) {
+            // The handler was awaited, so re-check liveness before accepting its
+            // answer: a grant revoked or an activation unloaded during the await
+            // releases the registration, and an answer from a released handler must
+            // not win the chain. Continuing (rather than returning undefined) keeps
+            // the released handler "as if unregistered".
+            if (!isDecisionHandlerLive(ctx, handler, effectiveScope)) {
+                log(`dsh-tui: ${name} handler from Component "${handler.componentId}" answered after its grant or activation was released; decision discarded`);
+                continue;
+            }
             return decision;
+        }
     }
     return undefined;
 }

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

@@ -9,9 +9,11 @@
 import type { Context } from '@deepseek-ai/cordis';
 import Schema from '@deepseek-ai/schemastery';
 import type { SessionModeSpec } from '../sessionModes.js';
-import { type ImageBacking, type MathImageBacking, type MathImageScale, type MathRendering, type PageMarginSetting, type ScrollGutterMode, type StatusBarConfig, type ToolBackground } from '../tuiDisplayPrefs.js';
+import { type KernelBackendId } from '../kernelPrefs.js';
+import { type CodeFrameStyle, type ImageBacking, type MathImageBacking, type MathImageScale, type MathRendering, type PageMarginSetting, type ScrollGutterMode, type StatusBarConfig, type ToolBackground } from '../tuiDisplayPrefs.js';
 import { type ShortcutActionId } from '../utils/keymap.js';
 import { type SplashFontSetting } from '../components/splashFonts.js';
+import { type BrandSetting } from '../branding.js';
 import { type RuntimeConfig } from './compat/settings.js';
 export declare const name = "dsh-tui";
 export declare const inject: string[];
@@ -22,6 +24,13 @@ export declare const inject: string[];
 export interface Config {
     /** Existing session to attach; a fresh session is created when absent. */
     sessionId?: string;
+    /** Agent backend the session runs on: `dsh` (default), the DeepSeek
+     *  Harness agent; `claude`, the experimental Claude Agent backend driving
+     *  the local Claude CLI through the Claude Agent SDK (optional peer
+     *  `@anthropic-ai/claude-agent-sdk`); `codex`, the experimental Codex
+     *  backend driving the user's own `codex` CLI over `codex app-server`.
+     *  `dsh-tui --backend <id>` sets it through `DSH_TUI_BACKEND`. */
+    backend?: KernelBackendId;
     /** LLM provider route. The route resolves atomically (issue #67): when
      *  cordis.yml names BOTH `provider` and `model`, that pair wins; otherwise
      *  the `/model` choice persisted in `~/.dsh-tui/model.json` wins whole;
@@ -55,6 +64,10 @@ export interface Config {
      *  id from `components/splashFonts.ts` (`bold`/`square`/…) pinning that one
      *  face. An unknown value falls back to `daily`. */
     splashFont?: SplashFontSetting;
+    /** Brand look of the splash and theme (settings `dsh-tui.brand`): `auto`
+     *  (the default) follows the active backend — Claude boots orange;
+     *  `deepseek`/`claude` pin one look. Junk normalizes to `auto`. */
+    brand?: BrandSetting;
     /** Swap the header's pixel whale for the static maid portrait. */
     whaleGirl?: boolean;
     /** Reduce decorative header content and colors. */
@@ -119,6 +132,11 @@ export interface Config {
      *  `+N lines` hint; Ctrl+O / clicking the card expands it. Default off —
      *  the full title keeps rendering. */
     foldTerminalCommand?: boolean;
+    /** Turn-usage ledger row (settings `dsh-tui.turnUsageRow`): the quiet
+     *  right-aligned line that closes each turn in the transcript (tokens
+     *  in/out, cache split, span, retries). Off by default; the ledger data
+     *  feeds /tokens, /status and the footer hover regardless. */
+    turnUsageRow?: boolean;
     /** Show the session name as a chip on the prompt top border's right side
      *  (settings `dsh-tui.promptSessionLabel`); off by default. */
     promptSessionLabel?: boolean;
@@ -139,6 +157,13 @@ export interface Config {
      *  than the viewport or of an unsupported type keeps the fenced source.
      *  On by default; off always shows the source. */
     mermaidDiagrams?: boolean;
+    /** Code-frame shape (settings `dsh-tui.codeFrameStyle`): `light`
+     *  (default) is the open rail frame — corner + language label on top,
+     *  a left rail with one padding column per row, no right wall or
+     *  bottom edge; `full` closes the box with a right wall (continuous
+     *  across wrapped rows) and a bottom edge. The narrow fallback (net
+     *  body width < 8) always stays the plain ANSI fence. */
+    codeFrameStyle?: CodeFrameStyle;
     /** LaTeX math (settings `dsh-tui.mathRendering`): `$…$` / `\(…\)` inline
      *  and `$$…$$` / `\[…\]` blocks in replies. `auto` (default) uses the best
      *  available renderer — today Unicode text: Greek and operator symbols,
@@ -182,8 +207,8 @@ export interface Config {
         /** Chat column as a fraction of the content width, clamped to 0.1–0.95
          *  (default 0.68); +/- while the panel is focused nudges it live. */
         ratio?: number;
-        /** Enabled panel ids, comma-separated, in PanelBar order (default
-         *  `todo,jobs,agents`; add `companion` to enable the pet panel). A
+        /** Enabled panel ids, comma-separated, in PanelBar order (default:
+         *  all eight built-in panels). A
          *  malformed id is dropped, an unknown one survives for a plugin. */
         panels?: string;
     };
@@ -194,6 +219,16 @@ export interface Config {
          *  layered pixel whale). Unknown ids normalize to deepy. */
         skin?: string;
     };
+    /** btw thread context (settings `dsh-tui.btw.*`): how much of the side
+     *  thread follows into the next ask. Members normalize (turns clamp
+     *  1-8, budget clamps 1k-200k), so junk cannot wedge the thread. */
+    btw?: {
+        /** Completed Q/A pairs carried into a follow-up ask, 1-8 (default 4). */
+        contextTurns?: number;
+        /** Total character budget of that carried context (default 24000;
+         *  the per-answer cap derives internally as min(8k, budget/2)). */
+        contextBudget?: number;
+    };
     /** Built-in action-shortcut overrides (`paste: 'alt+v'`), keyed by action
      *  id (see the keymap utility). Combos are `ctrl+`/`alt+`/`shift+` plus a
      *  key; several combos may be comma-separated. Unset actions keep their
@@ -206,6 +241,9 @@ export interface Config {
      *  default/plan/full cycle (see sessionModes.ts). */
     modes?: SessionModeSpec[];
 }
+/** The backend a configured value names: case-insensitive, trimmed;
+ *  empty or unknown → undefined (the DSH default). */
+export declare function normalizeBackendChoice(value: unknown): KernelBackendId | undefined;
 export declare const Config: Schema<Config, RuntimeConfig<Config>>;
 /**
  * Start the interactive TUI front door, delegating to the JSX implementation

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

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

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

@@ -1,7 +1,9 @@
 import Schema from '@deepseek-ai/schemastery';
-import { DEFAULT_COMPANION_SKIN, DEFAULT_SIDE_PANEL_IDS, DEFAULT_STATUS_BAR, normalizeCompanionSkin, normalizePageMargin, normalizeSidePanelPanels, normalizeSidePanelRatio } from '../tuiDisplayPrefs.js';
+import { isKernelId } from '../kernelPrefs.js';
+import { BTW_CONTEXT_BUDGET_DEFAULT, BTW_CONTEXT_TURNS_DEFAULT, DEFAULT_COMPANION_SKIN, DEFAULT_SIDE_PANEL_IDS, DEFAULT_STATUS_BAR, normalizeBtwContextBudget, normalizeBtwContextTurns, normalizeCompanionSkin, normalizePageMargin, normalizeSidePanelPanels, normalizeSidePanelRatio } from '../tuiDisplayPrefs.js';
 import { SHORTCUT_ACTIONS } from '../utils/keymap.js';
 import { normalizeSplashFont } from '../components/splashFonts.js';
+import { normalizeBrandSetting } from '../branding.js';
 import { editableConfig } from './compat/settings.js';
 import { EDITABLE_CONFIG_KEYS } from '../settings/definitions.js';
 export const name = 'dsh-tui';
@@ -15,8 +17,20 @@ export const name = 'dsh-tui';
 // row-level inject purely as an ordering guarantee when the row exists; when
 // it does not, plugin.ts/channel.ts fall back to a local workspace runtime.
 export const inject = ['agents'];
+/** The backend a configured value names: case-insensitive, trimmed;
+ *  empty or unknown → undefined (the DSH default). */
+export function normalizeBackendChoice(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const id = value.trim().toLowerCase();
+    return isKernelId(id) ? id : undefined;
+}
 export const Config = editableConfig(Schema.object({
     sessionId: Schema.string().required(false),
+    // A transform, not a union: the row reads `DSH_TUI_BACKEND`, and a stray
+    // export (`Claude`, a typo) must not fail the whole boot — case and blanks
+    // are normalized and anything unknown means the default (plugin.ts warns).
+    backend: Schema.transform(Schema.string(), value => normalizeBackendChoice(value)),
     // No schema defaults on the route: a `.default()` here would make an
     // unset key indistinguishable from an explicit cordis.yml choice and the
     // persisted `/model` preference could never win (issue #30). The defaults
@@ -37,6 +51,9 @@ export const Config = editableConfig(Schema.object({
     // pageMargin, whose unset value also reads `undefined`), so `daily` comes
     // from `normalizeSplashFont` at every read site.
     splashFont: Schema.transform(Schema.string(), value => normalizeSplashFont(value)),
+    // 同 splashFont 的 transform 而非 union：cordis.yml 保持决定权，`auto`
+    // 的默认值由 `normalizeBrandSetting` 在每个读取点给出。
+    brand: Schema.transform(Schema.string(), value => normalizeBrandSetting(value)),
     whaleGirl: Schema.boolean().default(false),
     minimal: Schema.boolean().default(false),
     activity: Schema.boolean().default(true),
@@ -56,10 +73,12 @@ export const Config = editableConfig(Schema.object({
     // the transform, so every parsed config carries a valid setting.
     pageMargin: Schema.transform(Schema.string().default('normal'), value => normalizePageMargin(value)),
     foldTerminalCommand: Schema.boolean().default(false),
+    turnUsageRow: Schema.boolean().default(false),
     promptSessionLabel: Schema.boolean().default(false),
     expandEditor: Schema.boolean().default(true),
     smoothStreaming: Schema.boolean().default(true),
     mermaidDiagrams: Schema.boolean().default(true),
+    codeFrameStyle: Schema.union(['light', 'full']),
     mathRendering: Schema.union(['auto', 'image', 'unicode', 'source']),
     mathImageScale: Schema.union(['auto', 'large', 'xlarge']),
     mathImageBacking: Schema.union(['transparent', 'terminal']),
@@ -107,6 +126,14 @@ export const Config = editableConfig(Schema.object({
     companion: Schema.object({
         skin: Schema.transform(Schema.string().default(DEFAULT_COMPANION_SKIN), value => normalizeCompanionSkin(value)),
     }).default({ skin: DEFAULT_COMPANION_SKIN }),
+    // btw thread context: schema defaults + transforms (same shape as
+    // sidePanel above) so an unset cordis.yml block and junk values both
+    // resolve to the documented 4 turns / 24k chars before the stores see
+    // them (the store normalize remains the second, identical gate).
+    btw: Schema.object({
+        contextTurns: Schema.transform(Schema.number().default(BTW_CONTEXT_TURNS_DEFAULT), value => normalizeBtwContextTurns(value)),
+        contextBudget: Schema.transform(Schema.number().default(BTW_CONTEXT_BUDGET_DEFAULT), value => normalizeBtwContextBudget(value)),
+    }).default({ contextTurns: BTW_CONTEXT_TURNS_DEFAULT, contextBudget: BTW_CONTEXT_BUDGET_DEFAULT }),
     // One optional combo string per customizable action (no defaults: unset
     // keeps the built-in binding; see Config.shortcuts).
     shortcuts: Schema.object(Object.fromEntries(SHORTCUT_ACTIONS.map(action => [action.id, Schema.string().required(false)]))).required(false),

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

@@ -1,5 +1,5 @@
 import type { BackgroundJobOutputChannel, BackgroundJobStatus, BackgroundJobState } from '../adapter/ports/channel-view.js';
-export type { BackgroundJobOutputChannel, BackgroundJobOutputLine, BackgroundJobStatus, BackgroundJobState } from '../adapter/ports/channel-view.js';
+export type { BackgroundJobOutputChannel, BackgroundJobOutputLine, BackgroundJobStatus, BackgroundJobState, JobTimelineEvent } from '../adapter/ports/channel-view.js';
 /**
  * Structural mirror of the registry's `JobSnapshot` — only the fields the
  * UI reads. Declared locally so no `@deepseek-ai/dsh-jobs` dependency (peer
@@ -102,6 +102,9 @@ export declare const JOBS_MAX_TRACKED = 40;
 /** Output tail lines retained per job (the card waterfall shows the last 3;
  *  the /jobs panel detail shows the whole retained tail). */
 export declare const JOBS_MAX_OUTPUT_LINES = 30;
+/** Timeline events retained per job: the /jobs detail renders the latest
+ *  slice; older observations are dropped, never re-derived. */
+export declare const JOBS_MAX_TIMELINE = 40;
 export declare class BackgroundJobStore {
     private readonly events;
     private readonly jobs;
@@ -162,6 +165,5 @@ export declare class BackgroundJobStore {
     /** Drop everything (session swap / transcript wipe). */
     reset(): void;
 }
-/** `3s` under a minute, `3m12s` under an hour, `1h02m` beyond — transcript-card compact. */
-export declare function formatJobDuration(job: Pick<BackgroundJobState, 'startedAt' | 'finishedAt'>, now?: number): string;
+export { formatJobDuration } from '../channel/job-format.js';
 //# sourceMappingURL=jobs.d.ts.map

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

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

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

@@ -3,11 +3,22 @@ export const JOBS_MAX_TRACKED = 40;
 /** Output tail lines retained per job (the card waterfall shows the last 3;
  *  the /jobs panel detail shows the whole retained tail). */
 export const JOBS_MAX_OUTPUT_LINES = 30;
+/** Timeline events retained per job: the /jobs detail renders the latest
+ *  slice; older observations are dropped, never re-derived. */
+export const JOBS_MAX_TIMELINE = 40;
 /** A `job_output` result's trailing status suffix — never a waterfall line. */
 const STATUS_SUFFIX_PATTERN = /^\s*\[status:\s/;
 function isTerminal(status) {
     return status === 'completed' || status === 'killed' || status === 'failed';
 }
+/** Append one bounded timeline observation. Timeline events live directly
+ *  on the job state so a snapshot reader sees them without a second lookup;
+ *  the ring drops the oldest entries, and the detail renders the latest
+ *  slice without implying a complete history. */
+function recordTimeline(job, event) {
+    const timeline = [...(job.timeline ?? []), event];
+    job.timeline = timeline.length > JOBS_MAX_TIMELINE ? timeline.slice(timeline.length - JOBS_MAX_TIMELINE) : timeline;
+}
 export class BackgroundJobStore {
     events;
     jobs = new Map();
@@ -47,9 +58,13 @@ export class BackgroundJobStore {
                     status: snap.status,
                     ...(snap.detail === undefined ? {} : { detail: snap.detail }),
                     ...(snap.progress === undefined ? {} : { progress: snap.progress }),
+                    ...(snap.progress === undefined || snap.progress === '' ? {} : { lastProgress: snap.progress, lastProgressAt: Date.now() }),
                     startedAt: snap.startedAt,
                     ...(snap.finishedAt === undefined ? {} : { finishedAt: snap.finishedAt }),
                     outputLines: [],
+                    // First sight already terminal (a roster refresh mid-flight missed
+                    // the live phase): the timeline starts at the settle fact.
+                    timeline: [{ kind: isTerminal(snap.status) ? 'settled' : 'started', at: snap.startedAt, ...(snap.detail === undefined ? {} : { text: snap.detail }) }],
                     ...(snap.output === undefined ? {} : {
                         outputTotalBytes: snap.output.total,
                         ...(snap.output.spillPaths === undefined || snap.output.spillPaths.length === 0 ? {} : { spillPaths: [...snap.output.spillPaths] }),
@@ -67,6 +82,9 @@ export class BackgroundJobStore {
                 prev.finishedAt === snap.finishedAt)
                 continue;
             const wasLive = !isTerminal(prev.status);
+            // Captured before the write below: the lifecycle-event gate compares
+            // against the previous status, which the assignment overwrites.
+            const prevStatus = prev.status;
             prev.status = snap.status;
             prev.label = snap.label;
             if (snap.detail === undefined)
@@ -77,10 +95,27 @@ export class BackgroundJobStore {
                 delete prev.progress;
             else
                 prev.progress = snap.progress;
+            // The live progress line dies at settle, but the last thing the producer
+            // said survives for the focused detail, with its observation time (the
+            // source is the producer kind the row already names).
+            if (snap.progress !== undefined && snap.progress !== '') {
+                prev.lastProgress = snap.progress;
+                prev.lastProgressAt = Date.now();
+                recordTimeline(prev, { kind: 'progress', at: prev.lastProgressAt, text: snap.progress });
+            }
             if (snap.finishedAt === undefined)
                 delete prev.finishedAt;
             else
                 prev.finishedAt = snap.finishedAt;
+            // Lifecycle observations land in the timeline ring: stopping, and the
+            // terminal transition with its detail (exit code, kill cause).
+            if (prevStatus !== snap.status) {
+                recordTimeline(prev, {
+                    kind: snap.status === 'stopping' ? 'stopping' : isTerminal(snap.status) ? 'settled' : 'started',
+                    at: snap.finishedAt ?? Date.now(),
+                    ...(snap.detail === undefined ? {} : { text: snap.detail }),
+                });
+            }
             if (snap.output !== undefined) {
                 prev.outputTotalBytes = snap.output.total;
                 if (snap.output.spillPaths !== undefined && snap.output.spillPaths.length > 0)
@@ -96,6 +131,7 @@ export class BackgroundJobStore {
                 continue;
             job.status = 'killed';
             job.finishedAt = Date.now();
+            recordTimeline(job, { kind: 'settled', at: job.finishedAt });
             this.events.onSettled?.(job);
             changed = true;
         }
@@ -150,6 +186,7 @@ export class BackgroundJobStore {
             return;
         job.outputLines = [...job.outputLines, ...lines].slice(-JOBS_MAX_OUTPUT_LINES);
         job.lastOutputAt = at;
+        recordTimeline(job, { kind: 'output', at, bytes: text.length });
         this.events.onChanged?.();
     }
     /**
@@ -167,8 +204,11 @@ export class BackgroundJobStore {
             read.cursor = earliest;
             read.partial = '';
             const job = this.jobs.get(id);
-            if (job !== undefined)
+            if (job !== undefined) {
                 job.outputDropped = true;
+                job.gapCount = (job.gapCount ?? 0) + 1;
+                recordTimeline(job, { kind: 'gap', at: Date.now() });
+            }
         }
     }
     /**
@@ -184,6 +224,7 @@ export class BackgroundJobStore {
             return;
         const state = this.kernelReads.get(id) ?? { cursor: 0, partial: '' };
         this.kernelReads.set(id, state);
+        const startCursor = state.cursor;
         const appended = [];
         let gapPending = read.lossy === true;
         let gapSeen = read.lossy === true;
@@ -217,11 +258,18 @@ export class BackgroundJobStore {
             }
         }
         state.cursor = read.next;
-        if (gapSeen)
+        if (gapSeen) {
             job.outputDropped = true;
+            job.gapCount = (job.gapCount ?? 0) + 1;
+            recordTimeline(job, { kind: 'gap', at });
+        }
         if (appended.length > 0) {
             job.outputLines = [...job.outputLines, ...appended].slice(-JOBS_MAX_OUTPUT_LINES);
             job.lastOutputAt = at;
+            // One observation per drain: the bytes this pull advanced and the
+            // dominant channel label, when the chunks carried one.
+            const channel = appended.find(line => line.channel !== undefined)?.channel;
+            recordTimeline(job, { kind: 'output', at, bytes: read.next - startCursor, ...(channel === undefined ? {} : { channel }) });
             this.events.onChanged?.();
         }
         else if (job.outputTotalBytes !== read.next) {
@@ -258,15 +306,6 @@ export class BackgroundJobStore {
         this.events.onChanged?.();
     }
 }
-/** `3s` under a minute, `3m12s` under an hour, `1h02m` beyond — transcript-card compact. */
-export function formatJobDuration(job, now = Date.now()) {
-    const end = job.finishedAt ?? now;
-    const seconds = Math.max(0, Math.floor((end - job.startedAt) / 1000));
-    if (seconds < 60)
-        return `${seconds}s`;
-    const minutes = Math.floor(seconds / 60);
-    if (minutes < 60)
-        return `${minutes}m${seconds % 60}s`;
-    const hours = Math.floor(minutes / 60);
-    return `${hours}h${String(minutes % 60).padStart(2, '0')}m`;
-}
+// The formatter is backend-neutral (src/channel/job-format.ts); re-exported
+// here for the existing importers.
+export { formatJobDuration } from '../channel/job-format.js';