@aragon-agent/cli 0.6.2 → 0.6.3

package/dist/ui/transcript-text.js

@@ -111,6 +111,29 @@ function renderEntry(entry, glyphs) {
             const detail = entry.detail ? `: ${entry.detail}` : '';
             return [`${head} ${entry.status}${detail}`];
         }
+        case 'compaction': {
+            // A compaction is real spend AND a real, permanent loss of history, and an
+            // exported transcript that omitted it would be unaccountable for both —
+            // the argument the `team`, `retry` and `fast` cases above each make in
+            // their own words. It matters most here: this is the one entry kind whose
+            // presence explains why the messages the reader is looking for are gone.
+            const glyph = entry.applied ? glyphs.compaction : glyphs.toolError;
+            const duration = entry.durationMs === undefined ? '' : ` (${entry.durationMs}ms)`;
+            if (!entry.applied) {
+                const why = entry.reason ? `: ${entry.reason}` : '';
+                return [`${TOOL_INDENT}${glyph} context not compacted #${entry.index}${why}`];
+            }
+            const head = `${TOOL_INDENT}${glyph} context compacted #${entry.index} ` +
+                `${entry.messagesBefore} ${glyphs.arrowRight} ${entry.messagesAfter} messages, ` +
+                `${entry.tokensBefore} ${glyphs.arrowRight} ${entry.tokensAfter} tokens ` +
+                `[${entry.mode}] ${entry.model}${duration}`;
+            if (!entry.summary)
+                return [head];
+            return [
+                head,
+                ...entry.summary.split('\n').map((l) => `${TOOL_INDENT}${CONTINUATION_INDENT}${l}`),
+            ];
+        }
         case 'notice': {
             const glyph = entry.level === 'error'
                 ? glyphs.error

package/dist/ui/use-startup-notices.d.ts

@@ -12,6 +12,18 @@
  * not otherwise see — rather than belonging to the view.
  */
 import type { ViewAction } from '../agent/reducer.js';
+/**
+ * The revision of the mouse notice a user must have seen for it to stay quiet
+ * (`state.json::mouseNoticeVersion`, `0` when absent).
+ *
+ * BUMP IT WHENEVER THE ADVICE CHANGES, never for a rewording that leaves the
+ * recommended actions alone — the same rule `VT_INPUT_NOTICE_VERSION` below
+ * carries, and for the same reason.
+ *
+ * `1` = the first text that names DRAG-SELECT and `/mouse`. `0` = the 0.6.2 text
+ * that taught the Shift bypass, recorded back when this was a boolean.
+ */
+export declare const MOUSE_NOTICE_VERSION = 1;
 /**
  * The revision of the text below that a user must have seen for this notice to
  * stay quiet (`state.json::vtInputNoticeVersion`, `0` when absent).
@@ -100,7 +112,21 @@ export interface MouseNoticeOptions {
      * re-deriving either one here would put them back out of step.
      */
     enabled: boolean;
-    /** Record that it was shown (`state.json`). Called once, after dispatch. */
+    /**
+     * Whether DRAG-SELECT is running too, i.e. the resolved `mouseSelect`.
+     *
+     * A SECOND FLAG RATHER THAN AN INFERENCE, for the reason the field above
+     * records about its own two halves: "the mouse is captured" and "dragging
+     * selects text" are not the same claim, and a session that turned drag-select
+     * off must not be handed advice about a mode that is not running.
+     */
+    selectEnabled: boolean;
+    /**
+     * Record that `MOUSE_NOTICE_VERSION` was shown (`state.json`). Called once,
+     * after dispatch — and it must write that constant, not `true`: the gate
+     * compares against it, so a caller storing anything else either replays the
+     * notice forever or silences a future revision of the text.
+     */
     onSeen: () => void;
 }
 export interface VtInputNoticeOptions {

package/dist/ui/use-startup-notices.js

@@ -14,18 +14,42 @@
 import { useEffect, useRef } from 'react';
 import { MODE_TOGGLE_KEYS } from '../agent/agent-mode.js';
 import { readConfigFile } from '../config/store.js';
-import { getMouseNoticeSeen, getVtInputNoticeVersion } from '../config/ui-state.js';
+import { getMouseNoticeVersion, getVtInputNoticeVersion } from '../config/ui-state.js';
 import { getLogger } from '../logging/logger.js';
 /**
- * The §6.1 notice (mouse-wheel-region-routing). Shown at most once, ever.
+ * The revision of the mouse notice a user must have seen for it to stay quiet
+ * (`state.json::mouseNoticeVersion`, `0` when absent).
  *
- * R-3 is the only part of wheel region routing that reaches users who never
- * scroll, and it REMOVES a gesture — drag to select — that is used more often
- * than the one being added. A README is consulted only after the belief
- * "aragon broke copy/paste" has already formed.
+ * BUMP IT WHENEVER THE ADVICE CHANGES, never for a rewording that leaves the
+ * recommended actions alone — the same rule `VT_INPUT_NOTICE_VERSION` below
+ * carries, and for the same reason.
+ *
+ * `1` = the first text that names DRAG-SELECT and `/mouse`. `0` = the 0.6.2 text
+ * that taught the Shift bypass, recorded back when this was a boolean.
  */
-const MOUSE_SELECTION_NOTICE = 'Mouse wheel scrolls the transcript. Hold Shift to select text, ' +
-    'or turn it off with `aragon config set mouse false`.';
+export const MOUSE_NOTICE_VERSION = 1;
+/**
+ * The one-shot mouse notice (tui-selection-and-scroll-follow §5.2 row 29).
+ *
+ * IT NO LONGER TEACHES THE SHIFT WORKAROUND. That text was a workaround told
+ * once, in a line that scrolls away, naming a key that is not portable — Shift
+ * on xterm / VTE / Windows Terminal, Fn on macOS Terminal, a preference
+ * elsewhere — and it collided with our own Shift+wheel binding. The user report
+ * this feature exists for is the evidence that it was not enough (D-1).
+ *
+ * TWO TEXTS, because a `mouseSelect: false` session must not be told about a
+ * gesture that is not running — the same rule the vt-input notice follows below,
+ * and the reason `MouseNoticeOptions` carries the flag rather than this module
+ * re-deriving it.
+ */
+function mouseNoticeText(selectEnabled) {
+    if (!selectEnabled) {
+        return ('Mouse wheel scrolls the transcript. Drag-select is off (mouseSelect); ' +
+            '/mouse off hands the mouse back to your terminal for this session.');
+    }
+    return ('Mouse wheel scrolls the transcript, and dragging selects text - releasing ' +
+        'copies it. /mouse off hands the mouse back to your terminal for this session.');
+}
 /**
  * The §5.1 notice (tui-render-performance). Shown once per run, and only when
  * the user's own `transcriptRetain` was below `transcriptWindow`.
@@ -142,16 +166,24 @@ export function useStartupNotices(dispatch, mouseNotice, retainNotice, vtInputNo
     const noticeRef = useRef(mouseNotice);
     noticeRef.current = mouseNotice;
     const mouseEnabled = mouseNotice?.enabled ?? false;
+    const mouseSelectEnabled = mouseNotice?.selectEnabled ?? false;
     const mouseNoticeShown = useRef(false);
     useEffect(() => {
         if (!mouseEnabled || mouseNoticeShown.current)
             return;
-        if (getMouseNoticeSeen())
+        // A VERSION, NOT THE OLD BOOLEAN (P1-8 / AC-16). The audience for the
+        // corrected text is exactly the set of users who already have
+        // `mouseNoticeSeen: true` on disk from the text it replaces, so reading that
+        // flag would make this change inert for everyone it is for.
+        //
+        // `>=`, not `!==`: a state file written by a NEWER build (a downgrade, or a
+        // shared home directory) has already told this user everything below.
+        if (getMouseNoticeVersion() >= MOUSE_NOTICE_VERSION)
             return;
         mouseNoticeShown.current = true;
-        dispatch({ type: 'notice', level: 'info', text: MOUSE_SELECTION_NOTICE });
+        dispatch({ type: 'notice', level: 'info', text: mouseNoticeText(mouseSelectEnabled) });
         noticeRef.current?.onSeen();
-    }, [mouseEnabled, dispatch]);
+    }, [mouseEnabled, mouseSelectEnabled, dispatch]);
     // The R-1 notice. `warn`, not `info`: unlike the one above it reports a
     // capability the user was promised and does not have, plus a key that is
     // actively editing their draft.

package/dist/ui/use-wheel-routing.js

@@ -84,6 +84,14 @@ export function useWheelRouting(options) {
         }
     }, [flush]);
     const route = useCallback((event) => {
+        // The channel now carries press / drag / release as well
+        // (tui-selection-and-scroll-follow §4.4.2). ONE LINE, AT THE TOP, and the
+        // rest of this module is untouched: widening the single channel rather
+        // than adding a second is what keeps arrival order intact between a wheel
+        // notch and a button, and each subscriber ignoring what it does not own is
+        // the price of that.
+        if (event.kind !== 'wheel')
+            return;
         const current = optionsRef.current;
         const overlay = current.getOverlay();
         // THE OVERLAY BRANCH IS EVALUATED FIRST AND RETURNS FOR EVERY OVERLAY IT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aragon-agent/cli",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "AragonAgent CLI — a Claude-Code / Codex-style interactive terminal UI (TUI) on top of the @aragon-agent/core engine. Installable and runnable via npm / npx.",
   "license": "MIT",
   "author": "AragonAgent contributors",
@@ -56,7 +56,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@aragon-agent/core": "^0.2.14",
+    "@aragon-agent/core": "^0.2.15",
     "chalk": "^5.6.2",
     "cli-highlight": "^2.0.0",
     "commander": "^12.1.0",
@@ -67,6 +67,8 @@
     "ink-select-input": "^6.0.0",
     "ink-spinner": "^5.0.0",
     "react": "^18.3.1",
+    "string-width": "^7.2.0",
+    "strip-ansi": "^7.1.0",
     "tinyglobby": "^0.2.17"
   },
   "devDependencies": {