feat(tui): show execute threshold in sidebar + status header

Sidebar header now displays the per-model execute-threshold alongside
the current usage percentage, in a left/right split layout:

  47.5% / 65%                         475K / 1.0M

The left half tells the user how close they are to the next compaction
trigger; the right half stays the absolute "tokens used / context
window" reading.

Status dialog header gets the same shape for visual consistency (was
previously "Context  47.5% percent dot 475K / 1.0M tokens" on one
right-aligned line).

Implementation:

  - `executeThreshold: number` added to `SidebarSnapshot` so the sidebar
    can render it without a second RPC round-trip
  - `buildSidebarSnapshot` now accepts an optional `config` arg and
    resolves the threshold per-model via the same
    `resolveExecuteThresholdDetail` flow used by `buildStatusDetail`
  - Both RPC handler call sites forward the raw config so the sidebar
    and dialog agree on the resolved value
  - Sticky cache and client EMPTY_SNAPSHOT updated for the new field;
    the cache merger inherits `executeThreshold` from the fresh
    snapshot via `...fresh` so model switches surface immediately

Tests: 1479 pass / 0 fail. Lint, typecheck, build clean.

Author: ualtinok

packages/plugin/src/plugin/rpc-handlers.ts

@@ -83,6 +83,11 @@ export function buildSidebarSnapshot(
     directory: string,
     liveSessionState?: LiveSessionState,
     injectionBudgetTokens?: number,
+    // Optional config so the sidebar can show the effective execute threshold
+    // alongside `usagePercentage` (e.g. "47.5% / 65%"). Resolved per-model from
+    // `liveSessionState.liveModelBySession`. When omitted (e.g. legacy test
+    // callers), the snapshot falls back to the runtime default of 65%.
+    config?: Record<string, unknown>,
 ): SidebarSnapshot {
     const empty: SidebarSnapshot = {
         sessionId,
@@ -108,6 +113,7 @@ export function buildSidebarSnapshot(
         conversationTokens: 0,
         toolCallTokens: 0,
         toolDefinitionTokens: 0,
+        executeThreshold: 65,
     };
 
     try {
@@ -340,6 +346,33 @@ export function buildSidebarSnapshot(
                 ? resolveContextLimit(activeProviderID, activeModelID, { db, sessionID: sessionId })
                 : 0;
 
+        // Resolve the effective execute-threshold percentage for this
+        // session's active model so the sidebar header can show
+        // "47.5% / 65%" alongside the absolute "475K / 1.0M". Falls back
+        // to 65% (the runtime default) when no live model is known yet
+        // or when no config was passed in. Mirrors the resolution flow
+        // used by `buildStatusDetail` so the dialog and sidebar agree.
+        let executeThreshold = 65;
+        if (config) {
+            const modelKey =
+                activeProviderID && activeModelID
+                    ? `${activeProviderID}/${activeModelID}`
+                    : undefined;
+            const pctCfg = config.execute_threshold_percentage as
+                | number
+                | { default: number; [k: string]: number }
+                | undefined;
+            const tokensCfg = config.execute_threshold_tokens as
+                | { default?: number; [k: string]: number | undefined }
+                | undefined;
+            const thresholdDetail = resolveExecuteThresholdDetail(pctCfg ?? 65, modelKey, 65, {
+                tokensConfig: tokensCfg,
+                contextLimit: contextLimit || undefined,
+                sessionId,
+            });
+            executeThreshold = thresholdDetail.percentage;
+        }
+
         const calibration = resolveModelCalibration(activeProviderID, activeModelID);
         const calibrated = calibrateBuckets({
             inputTokens,
@@ -377,6 +410,7 @@ export function buildSidebarSnapshot(
             conversationTokens: calibrated.conversationTokens,
             toolCallTokens: calibrated.toolCallTokens,
             toolDefinitionTokens: calibrated.toolDefinitionTokens,
+            executeThreshold,
         };
         // Defensive sticky cache: if `inputTokens` briefly drops to 0 mid-turn
         // (intermittent — possibly streaming events with empty token shape, or
@@ -404,6 +438,7 @@ export function buildStatusDetail(
         directory,
         liveSessionState,
         injectionBudgetTokens,
+        config,
     );
     const detail: StatusDetail = {
         ...base,
@@ -602,6 +637,7 @@ export function registerRpcHandlers(
             dir,
             liveSessionState,
             injectionBudgetTokens,
+            rawConfig,
         ) as unknown as Record<string, unknown>;
     });
 

packages/plugin/src/plugin/sidebar-snapshot-cache.test.ts

@@ -35,6 +35,7 @@ function makeSnapshot(overrides: Partial<SidebarSnapshot> = {}): SidebarSnapshot
         conversationTokens: 0,
         toolCallTokens: 0,
         toolDefinitionTokens: 0,
+        executeThreshold: 65,
         ...overrides,
     };
 }

packages/plugin/src/shared/rpc-types.ts

@@ -45,6 +45,16 @@ export interface SidebarSnapshot {
      * shows this as "Tool Definitions".
      */
     toolDefinitionTokens: number;
+    /**
+     * Effective execute-threshold percentage for this session's active model,
+     * after per-model resolution and the tokens→percentage conversion (when
+     * `execute_threshold_tokens` applies). Surfaces in the sidebar / status
+     * dialog header alongside `usagePercentage` so users can see how close
+     * the session is to triggering compaction. Defaults to `65` when no live
+     * model is known yet — matches the runtime fallback used by the
+     * scheduler and transform paths.
+     */
+    executeThreshold: number;
 }
 
 export interface StatusDetail extends SidebarSnapshot {

packages/plugin/src/tui/data/context-db.ts

@@ -58,6 +58,7 @@ const EMPTY_SNAPSHOT: SidebarSnapshot = {
     conversationTokens: 0,
     toolCallTokens: 0,
     toolDefinitionTokens: 0,
+    executeThreshold: 65,
 };
 
 /**

packages/plugin/src/tui/index.tsx

@@ -290,11 +290,16 @@ const StatusDialog = (props: { api: TuiPluginApi; s: StatusDetail }) => {
                 <text fg={t().textMuted}>v{packageJson.version}</text>
             </box>
 
-            {/* Context summary line */}
+            {/* Context summary line. Mirrors the sidebar header layout
+                ("47.5% / 65%   475K / 1.0M") so users can recognize the
+                same shape in the status dialog. The execute threshold tells
+                them how close they are to compaction triggering. */}
             <box flexDirection="row" justifyContent="space-between" width="100%">
-                <text fg={t().text}>Context</text>
                 <text fg={s().usagePercentage >= 80 ? t().error : s().usagePercentage >= 65 ? t().warning : t().accent}>
-                    <b>{s().usagePercentage.toFixed(1)}%</b> · {fmt(s().inputTokens)} / {contextLimit() > 0 ? fmt(contextLimit()) : "?"} tokens
+                    <b>{s().usagePercentage.toFixed(1)}%</b> / {s().executeThreshold}%
+                </text>
+                <text fg={s().usagePercentage >= 80 ? t().error : s().usagePercentage >= 65 ? t().warning : t().accent}>
+                    {fmt(s().inputTokens)} / {contextLimit() > 0 ? fmt(contextLimit()) : "?"} tokens
                 </text>
             </box>
 

packages/plugin/src/tui/slots/sidebar-content.tsx

@@ -363,9 +363,21 @@ const SidebarContent = (props: {
             {s() && s()!.inputTokens > 0 && (
                 <box marginTop={1} flexDirection="column">
                     {(s()?.contextLimit ?? 0) > 0 && (
-                        <box width="100%" flexDirection="row" justifyContent="flex-end">
+                        <box width="100%" flexDirection="row" justifyContent="space-between">
+                            {/* Left: current usage vs the per-model execute
+                                threshold (the value Magic Context compares
+                                against when scheduling historian / drops).
+                                "47.5% / 65%" tells the user how close they
+                                are to the next compaction trigger. */}
                             <text fg={contextSummaryColor()}>
-                                <b>{s()!.usagePercentage.toFixed(1)}%</b> · {compactTokens(s()!.inputTokens)} / {compactTokens(s()!.contextLimit)}
+                                <b>{s()!.usagePercentage.toFixed(1)}%</b> / {s()!.executeThreshold}%
+                            </text>
+                            {/* Right: absolute token usage vs the model's
+                                full context window (separate from the
+                                execute threshold so users still know how
+                                much headroom remains beyond compaction). */}
+                            <text fg={contextSummaryColor()}>
+                                {compactTokens(s()!.inputTokens)} / {compactTokens(s()!.contextLimit)}
                             </text>
                         </box>
                     )}