@aragon-agent/cli 0.6.35 → 0.6.37

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

@@ -14,7 +14,8 @@
 import { useEffect, useRef } from 'react';
 import { MODE_TOGGLE_KEYS } from '../agent/agent-mode.js';
 import { readConfigFile } from '../config/store.js';
-import { getMouseNoticeVersion, getScrollModeNoticeVersion, getVtInputNoticeVersion, } from '../config/ui-state.js';
+import { getMouseNoticeVersion, getPromptKeyNoticeVersion, getScrollModeNoticeVersion, getVtInputNoticeVersion, } from '../config/ui-state.js';
+import { PROMPT_KEY_NOTICE_COPY } from '../prompts/copy.js';
 import { getLogger } from '../logging/logger.js';
 /**
  * The revision of the mouse notice a user must have seen for it to stay quiet
@@ -103,7 +104,14 @@ export function scrollModeNoticeText() {
     return ('Scrolling now uses your terminal: wheel, scrollbar, selection and search all work as ' +
         'usual. Prefer the old full-screen view? Run: aragon config set scrollMode app');
 }
-export function useStartupNotices(dispatch, mouseNotice, retainNotice, vtInputNotice, scrollModeNotice) {
+/**
+ * The revision of the prompt-key notice a user must have seen for it to stay quiet
+ * (`state.json::promptKeyNoticeVersion`, `0` when absent). BUMP IT WHENEVER THE ADVICE
+ * CHANGES, never for a rewording.
+ */
+export const PROMPT_KEY_NOTICE_VERSION = 1;
+export function useStartupNotices(dispatch, options) {
+    const { mouse: mouseNotice, retain: retainNotice, vtInput: vtInputNotice, scrollMode: scrollModeNotice, promptKeys: promptKeyNotice, } = options;
     // The sink gives up after repeated write failures (a read-only log directory,
     // a full disk). Silently logging nothing is exactly the state a user must not
     // discover later, from an empty file, while trying to explain a bug.
@@ -193,6 +201,25 @@ export function useStartupNotices(dispatch, mouseNotice, retainNotice, vtInputNo
         dispatch({ type: 'notice', level: 'info', text: scrollModeNoticeText() });
         scrollNoticeRef.current?.onSeen();
     }, [scrollNoticeWanted, dispatch]);
+    // THE PROMPT-KEY MIGRATION (quick-prompt-library D-20). A durable `notice` and not
+    // a toast, for the reason every "you must learn a key" message in this file is one:
+    // a toast expires, and the whole mitigation for a moved key is that the sentence is
+    // READ. It queues LAST because it explains a key rather than making one work.
+    const promptNoticeRef = useRef(promptKeyNotice);
+    promptNoticeRef.current = promptKeyNotice;
+    const promptKeyWanted = promptKeyNotice !== undefined;
+    const promptKeyShown = useRef(false);
+    useEffect(() => {
+        if (!promptKeyWanted || promptKeyShown.current)
+            return;
+        // `>=`, not `!==`: a state file written by a NEWER build has already told this
+        // user everything the text below says.
+        if (getPromptKeyNoticeVersion() >= PROMPT_KEY_NOTICE_VERSION)
+            return;
+        promptKeyShown.current = true;
+        dispatch({ type: 'notice', level: 'info', text: PROMPT_KEY_NOTICE_COPY });
+        promptNoticeRef.current?.onSeen();
+    }, [promptKeyWanted, dispatch]);
     // A `warn` notice rather than a toast: it is about a value the user typed, so
     // it belongs in the transcript where it can be scrolled back to, not in a row
     // that expires. DEPENDS ON THE TWO SCALARS, never on the options object —

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

@@ -110,7 +110,15 @@ export function useWheelRouting(options) {
             // Modes A only. `model` / `confirm` / `question` own their own keys and
             // scrolling them would leave an inconsistent cursor (R-11).
             const controlled = overlay === 'help' || overlay === 'settings' || overlay === 'plan'
-                || overlay === 'queue' || overlay === 'kit';
+                || overlay === 'queue' || overlay === 'kit'
+                // The prompt surfaces (quick-prompt-library appendix B-2). Missing this line
+                // makes the wheel fall through to the transcript BEHIND an open overlay,
+                // which reads as a frozen list and a jumping transcript at the same time.
+                || overlay === 'prompts' || overlay === 'prompt-pick'
+                // The Agents board (tui-subagent-panel §6.5). Missing this line makes the
+                // wheel fall through to the transcript BEHIND the open board, which reads
+                // as a frozen list and a jumping transcript at the same time.
+                || overlay === 'agents';
             if (!controlled)
                 return;
             // D-3: the row is not consulted here either. Behind an overlay the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aragon-agent/cli",
-  "version": "0.6.35",
+  "version": "0.6.37",
   "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.47",
+    "@aragon-agent/core": "^0.2.49",
     "chalk": "^5.6.2",
     "cli-highlight": "^2.0.0",
     "commander": "^12.1.0",