@aragon-agent/cli 0.6.15 → 0.6.17

package/dist/cli.js

@@ -46,6 +46,7 @@ import { createFrameDiffer } from './ui/frame-differ.js';
 import { wrapStdoutForFrames } from './ui/stdout-frame-writer.js';
 import { setFrameStatsProvider } from './commands/perf.js';
 import { tryCreateStdinFilter } from './input/stdin-filter.js';
+import { enableKeyboardEnhancement, NOOP_KEYBOARD_ENHANCEMENT, } from './input/keyboard-enhancement.js';
 import { createScrollbarBridge } from './ui/scrollbar-controller.js';
 import { createPointerRouter } from './input/pointer-router.js';
 import { createFrameObserver } from './ui/frame-observer.js';
@@ -120,6 +121,10 @@ function toFlags(opts) {
         // `CliFlags`, AND a line here; `config.test.ts` is the regression pin that
         // exists because `--no-mouse` shipped inert once already.
         paste: opts.paste,
+        // Site three of three for `--keyboard-enhancement` /
+        // `--no-keyboard-enhancement`, for the reason `paste` one line up
+        // records: the key is persisted and defaults to true.
+        keyboardEnhancement: opts.keyboardEnhancement,
         skills: opts.skills,
         skill: opts.skill,
         skillsYes: opts.skillsYes,
@@ -155,11 +160,6 @@ function toFlags(opts) {
         fastModel: opts.fastModel,
         fastProvider: opts.fastProvider,
         fastReview: opts.fastReview,
-        // …and again for `--fast-delegate` / `--no-fast-delegate`, one feature
-        // later — NINE features, one trap. It is `fast.delegate`'s only channel:
-        // there is no `ARAGON_FAST_DELEGATE`, so missing this line leaves a wrapper
-        // with no way at all to say "do not delegate on this run".
-        fastDelegate: opts.fastDelegate,
         // `--verbose` is just a shorthand for `--log-level debug`; an explicit
         // `--log-level` still wins, so the two can be combined without surprise.
         logLevel: opts.logLevel ?? (opts.verbose ? 'debug' : undefined),
@@ -465,8 +465,22 @@ function runInteractive(flags, extras = {}) {
     // advising the user about a mode they just disabled.
     const wantPaste = config.paste && !!process.stdin.isTTY;
     const pasteBridge = { notify: null };
+    // --- Keyboard enhancement (Shift+Enter newline). --------------------------
+    //
+    // THE THIRD STREAM GATE, AND THE SAME DISCIPLINE AS THE OTHER TWO. On
+    // win32 the enhancement rides the SAME `vtInputSupported` measurement
+    // the mouse does: Node < 22.17 / < 24.2 never turns on
+    // `ENABLE_VIRTUAL_TERMINAL_INPUT`, the win32-input-mode records cannot
+    // reach the process, and pushing `?9001h` there would be a mode nobody
+    // can observe -- the exact gap the mouse gate closes for `?1000h`.
+    // Elsewhere the push is kitty disambiguate + modifyOtherKeys, which a
+    // terminal that implements neither ignores (verified byte-identical on
+    // conhost), so no capability gate is possible or needed there.
+    const wantEnhancedKeys = config.keyboardEnhancement &&
+        !!process.stdin.isTTY &&
+        (process.platform !== 'win32' || vtInputSupported);
     const filter = process.stdin.isTTY
-        ? tryCreateStdinFilter(process.stdin, { mouse: wantMouse, paste: wantPaste }, (reason) => logger.warn('cli', 'stdin_filter_failed', { reason }), pasteBridge)
+        ? tryCreateStdinFilter(process.stdin, { mouse: wantMouse, paste: wantPaste, enhancedKeys: wantEnhancedKeys }, (reason) => logger.warn('cli', 'stdin_filter_failed', { reason }), pasteBridge)
         : null;
     /**
      * THE ONE EXPRESSION EVERY MOUSE SITE READS (I-11 / D-17).
@@ -478,6 +492,8 @@ function runInteractive(flags, extras = {}) {
     const mouseOn = wantMouse && filter !== null;
     /** Same discipline for DEC 2004: already decided here, never re-derived. */
     const pasteOn = wantPaste && filter !== null;
+    /** Same discipline: the translation runs only when a filter fronts Ink. */
+    const enhancedKeysOn = wantEnhancedKeys && filter !== null;
     const disposeStdinFilter = () => filter?.dispose();
     // --- Drag-select (tui-selection-and-scroll-follow §4.4). ------------------
     //
@@ -565,6 +581,16 @@ function runInteractive(flags, extras = {}) {
             ...(snapshot.droppedEntries ? { droppedEntries: snapshot.droppedEntries } : {}),
         }));
     };
+    // AFTER the filter, BEFORE the render: the enhanced encodings this mode
+    // turns on must never reach Ink un-translated, and the ordering invariant
+    // `stdin-filter.ts` states for `?1000h` / `?2004h` covers `?9001h`
+    // and the CSI-u pushes identically.
+    const keyboardEnhancement = enhancedKeysOn
+        ? enableKeyboardEnhancement(process.stdout, {
+            platform: process.platform,
+            vtInputSupported,
+        })
+        : NOOP_KEYBOARD_ENHANCEMENT;
     {
         // `mouse` here means "a mouse-parsing filter is installed", NOT "the user
         // wants mouse support" — see `AltScreenOptions`. `screen.ts` must never
@@ -581,7 +607,14 @@ function runInteractive(flags, extras = {}) {
             motion: mouseOn,
             bracketedPaste: pasteOn,
         });
-        const restore = () => screen?.restore();
+        // Input-encoding modes unwind FIRST, for the same reason the mouse
+        // reporting does inside `screen.restore()`: the terminal must stop
+        // sending enhanced encodings before anything else tears the reader
+        // down, or a keystroke taken in that instant survives into the shell.
+        const restore = () => {
+            keyboardEnhancement.restore();
+            screen?.restore();
+        };
         // Four idempotent restore paths (§4.4). The signal hook is NOT redundant:
         //   - `waitUntilExit().then()` is a microtask and may never be reached when
         //     the process is killed;
@@ -948,6 +981,9 @@ const CONFIG_SET_KEYS = new Set([
     // `mouse` records: a key present here but absent there falls through every
     // case, writes nothing, and still prints `Set paste = false`.
     'paste',
+    // Listed here AND cased in the switch below, for the reason the note above
+    // `paste` records.
+    'keyboardEnhancement',
     'scrollResumeMs',
     'historyEnabled',
     'planModeDefault',
@@ -1187,6 +1223,9 @@ function runConfigSetValue(key, value) {
         case 'paste':
             patch.paste = value === 'true' || value === '1';
             break;
+        case 'keyboardEnhancement':
+            patch.keyboardEnhancement = value === 'true' || value === '1';
+            break;
         // Clamped rather than rejected, for the same reason `planModeDefault` below
         // records: hardening only the READ path leaves a bad value on disk that
         // reverts to the default on every launch, which presents as "my setting
@@ -1451,6 +1490,9 @@ function buildProgram() {
         // silence, and silently overriding a stored `false` on every run.
         .option('--paste', 'Collapse large pastes into a placeholder (the default)')
         .option('--no-paste', 'Treat pasted bytes as keystrokes (pre-0.6.3 behavior)')
+        // Same persisted-defaults-true trap as `--paste` above.
+        .option('--keyboard-enhancement', 'Make Shift+Enter insert a newline (the default where the terminal can)')
+        .option('--no-keyboard-enhancement', 'Never push keyboard-enhancement modes (Shift+Enter then needs a terminal binding)')
         .option('--no-exit-transcript', 'Do not replay the session summary after exiting')
         .option('--plan', 'Start the session in PLAN mode (read-only research + review)')
         .option('--no-plan', 'Start the session in BUILD mode (overrides planModeDefault)')
@@ -1490,14 +1532,6 @@ function buildProgram() {
         .option('--fast-model <id>', 'The fast model id (implies nothing about --fast)')
         .option('--fast-provider <id>', 'Provider for the fast model (default: the main provider)')
         .option('--fast-review <n|off>', 'Turns between automatic fast reviews, or "off"')
-        // BOTH FORMS, POSITIVE FIRST, and here it matters more than anywhere above:
-        // `fast.delegate` is PERSISTED and defaults to TRUE, so declaring only
-        // `--no-fast-delegate` would make commander default `opts.fastDelegate` to
-        // `true` and force `delegate: true` on EVERY run that passed no flag at all
-        // — silently overwriting a user's stored `false`. Same polarity, same trap
-        // and same fix as `--update` / `--compaction`.
-        .option('--fast-delegate', 'Let the fast tier take mechanical sub-steps (the default)')
-        .option('--no-fast-delegate', 'Run every sub-step on the main model')
         // BOTH FORMS, positive first, for the reason recorded seven times above —
         // and this is the pair whose omission would be worst. `update.mode` is
         // PERSISTED and defaults to `'auto'`, so a lone `--no-update` would make

package/dist/commands/builtins.js

@@ -106,8 +106,7 @@ function formatFastStatus(controller) {
     else {
         lines.push(`Fast tier: ${state}. Model: ${cfg.model || '(not set)'}.`);
     }
-    lines.push(`Review: ${cfg.review ? `every ${cfg.reviewEveryTurns} turns` : 'off'}. ` +
-        `Delegation: ${cfg.delegate ? 'on' : 'off'}.`);
+    lines.push(`Review: ${cfg.review ? `every ${cfg.reviewEveryTurns} turns` : 'off'}.`);
     const snapshot = status.snapshot;
     const cost = snapshot.pricingUnknown
         ? `unknown (no price table for ${snapshot.model})`
@@ -124,7 +123,6 @@ function formatFastStatus(controller) {
     // numbers are `0` placeholders and `reviews >= reviewBudget` would be true.
     const budget = snapshot.budgetReached ? ' (budget reached - raise with /fast budget <n>)' : '';
     lines.push(`This session: ${snapshot.reviews}/${snapshot.reviewBudget} reviews${budget}, ` +
-        `${snapshot.delegated} delegated subagents, ` +
         `in ${formatTokens(snapshot.usage.inputTokens)} / out ` +
         `${formatTokens(snapshot.usage.outputTokens)}, cost ${cost}.`);
     return lines.join('\n');
@@ -339,7 +337,7 @@ const COMMANDS = [
     {
         name: 'fast',
         description: 'Fast model tier: status | on | off | model <id> | provider <id> | same | ' +
-            'review <n|off> | budget <n> | delegate on|off',
+            'review <n|off> | budget <n>',
         /**
          * `/fast on` CANNOT turn the tier on in a session that started without it,
          * for the reason `/team on` above records at length: the tool array is built
@@ -516,20 +514,8 @@ const COMMANDS = [
                     `${snapshot.reviews} used.`);
                 return;
             }
-            if (verb === 'delegate') {
-                const raw = (value ?? '').trim().toLowerCase();
-                if (raw !== 'on' && raw !== 'off') {
-                    ctx.notify('warn', 'Usage: /fast delegate <on|off>');
-                    return;
-                }
-                if (!persist({ delegate: raw === 'on' }))
-                    return;
-                ctx.toast('success', `Fast delegation ${raw}.`);
-                return;
-            }
             ctx.notify('warn', `Unknown argument "${verb}" - use /fast ` +
-                '[status|on|off|model <id>|provider <id>|same|review <n|off>|budget <n>|' +
-                'delegate on|off].');
+                '[status|on|off|model <id>|provider <id>|same|review <n|off>|budget <n>].');
         },
     },
     {
@@ -1054,55 +1040,53 @@ const COMMANDS = [
     },
     {
         name: 'terminal-setup',
-        description: 'How to make Shift+Enter send a newline in your terminal',
+        description: 'How Shift+Enter sends a newline in your terminal',
         run: (ctx) => {
-            // READ-ONLY BY DESIGN (3.6): pushing kitty keyboard mode or
-            // modifyOtherKeys=2 would re-encode EVERY modified key as CSI-u and
-            // blind Ink's parser for the whole session. One user-side binding
-            // reaches the same result for the one key that needs it.
-            //
-            // Ctrl+J and Alt+Enter work with no setup at all; CSI-u terminals
-            // (kitty / WezTerm / foot with keyboard enhancement on) need none
-            // either. The lines below are for the terminals that send a plain
-            // CR for Shift+Enter and CAN be configured.
+            // THE APP NOW PUSHES THE MODES ITSELF (shift-enter-newline fix):
+            // win32-input-mode on Windows, kitty disambiguate + modifyOtherKeys=2
+            // elsewhere, each translated back to legacy bytes before Ink parses
+            // them. The lines below cover the terminals where pushing is not
+            // enough: macOS Terminal.app and conhost under an old Node publish no
+            // keyboard-enhancement protocol at all, and a terminal that ignores
+            // the push still sends a plain CR for Shift+Enter.
             const lines = [
                 'Shift+Enter newline - terminal setup',
                 '',
-                'Ctrl+J inserts a newline when delivered; Alt+Enter may be intercepted.',
-                'To get a dedicated Shift+Enter key, make the terminal send',
-                'the CSI-u sequence \\u001b[13;2u for it:',
+                'This app asks the terminal to report modified keys itself:',
+                '  Windows: win32-input-mode (conhost and Windows Terminal)',
+                '  macOS/Linux: kitty disambiguate + modifyOtherKeys (iTerm2,',
+                '    kitty, ghostty, WezTerm, foot, Alacritty)',
+                'A terminal that implements none of these sends a plain CR for',
+                'Shift+Enter, indistinguishable from Enter. There Ctrl+J inserts a',
+                'newline with no setup, and Alt+Enter may also work.',
+                '',
+                'If your terminal can be configured, make Shift+Enter send the',
+                'CSI-u sequence \\u001b[13;2u and it works even without the push:',
                 '',
                 '  Windows Terminal settings.json, merge root-level arrays:',
                 '    "copyOnSelect": false,',
                 '    "actions": [{ "id": "User.AragonNewline", "command":',
                 '      { "action": "sendInput", "input": "\\u001b[13;2u" } }],',
                 '    "keybindings": [{ "keys": "shift+enter", "id": "User.AragonNewline" }]',
-                '    PowerShell runs inside the terminal; configure this binding in',
-                '    Windows Terminal, not in the PowerShell profile. If both keys',
-                '    send CR, the application cannot distinguish Shift+Enter from Enter.',
                 '  VS Code terminal  keybindings.json:',
                 '    { "key": "shift+enter",',
                 '      "command": "workbench.action.terminal.sendSequence",',
                 '      "when": "terminalFocus",',
                 '      "args": { "text": "\\u001b[13;2u" } }',
-                '    User settings: "terminal.integrated.copyOnSelection": false',
                 '  iTerm2            Settings > Profiles > Keys > Key Mappings:',
                 '    Shift+Enter -> Send Escape Sequence: [13;2u',
                 '  kitty/WezTerm/foot  native once keyboard enhancement is on',
                 '    (kitty: map shift+enter send_text all \\u001b[13;2u)',
                 '  Alacritty         alacritty.toml, [keyboard] bindings:',
                 '    { key = "Enter", mods = "Shift", chars = "\\u001b[13;2u" }',
-                '  macOS Terminal.app / conhost  cannot rebind Enter; use Ctrl+J',
-                '    or Alt+Enter',
+                '  macOS Terminal.app / old conhost  cannot rebind Enter; use Ctrl+J',
                 '',
+                'Windows needs Node >= 22.17 (or >= 24.2): older versions never',
+                'turn on virtual-terminal input, so no report can arrive.',
+                'Opt out of the push entirely:',
+                '  aragon config set keyboardEnhancement false',
+                '  --no-keyboard-enhancement / ARAGON_KEYBOARD_ENHANCEMENT=0',
                 'This command only prints advice; it changes no terminal modes.',
-                'Host selections (Shift+drag or /mouse off) belong to the terminal.',
-                'App selections wait for Ctrl+C; only a native tool exit confirms copying.',
-                'SSH uses OSC 52: the terminal may deny it; sent does not mean confirmed.',
-                'Without the stdin filter, Delete falls back to Backspace.',
-                'Without paste support, multiline paste cannot be guaranteed safe.',
-                'IME confirmation has no composition signal in PTY bytes. If it emits CR,',
-                'edit externally and use bracketed paste; this host combination needs validation.',
             ];
             ctx.notify('info', lines.join('\n'));
         },

package/dist/compaction/child.d.ts

@@ -13,15 +13,17 @@
  * turn the child already ran, and receives one partial sentence for all of it.
  * Two fast-model summarizations is the cheap side of that trade.
  *
- * A CHILD MANAGER IS THE SAME `Compactor` UNDER A DIFFERENT POLICY, and the
- * overlay needs TWO mechanisms rather than one (RV-2):
+ * SINCE MAIN-AGENT PARITY, A CHILD MANAGER RUNS THE LEAD'S OWN POLICY. The only
+ * overlay left is the CONNECTION (provider / model / base URL / manual window),
+ * which must follow the model the child actually runs on. `keepRecentTurns`,
+ * `onFailure`, `useFastTier`, `archive` and the per-run compaction bound are all
+ * read from the SAME live config the lead reads, so a user who tunes compaction
+ * tunes every child identically - the requirement "same mode and configuration
+ * as the main agent", taken literally.
  *
- *   A. A CONFIG VIEW, for `keepRecentTurns` / `onFailure` / `useFastTier`, which
- *      `Compactor` reads through `deps.getConfig()`.
- *   B. AN INSTANCE BOUND, for `maxPerRun`, which is STRUCTURAL and has no config
- *      path by design (`limits.ts` header). Without it the child silently
- *      inherits the lead's 5 - two and a half times the bound the reversal above
- *      rests on.
+ * THE INSTANCE BOUND stays (mechanism B of RV-2) because `maxPerRun` is
+ * STRUCTURAL with no config path by design (`limits.ts` header); it is now the
+ * SAME `COMPACTION_LIMITS.maxPerRun` the lead's own manager runs under.
  *
  * NO UI. A child's compaction produces no transcript card (DH-7): the lead's
  * transcript describes the LEAD's context, and a card there would claim the

package/dist/compaction/child.js

@@ -13,15 +13,17 @@
  * turn the child already ran, and receives one partial sentence for all of it.
  * Two fast-model summarizations is the cheap side of that trade.
  *
- * A CHILD MANAGER IS THE SAME `Compactor` UNDER A DIFFERENT POLICY, and the
- * overlay needs TWO mechanisms rather than one (RV-2):
+ * SINCE MAIN-AGENT PARITY, A CHILD MANAGER RUNS THE LEAD'S OWN POLICY. The only
+ * overlay left is the CONNECTION (provider / model / base URL / manual window),
+ * which must follow the model the child actually runs on. `keepRecentTurns`,
+ * `onFailure`, `useFastTier`, `archive` and the per-run compaction bound are all
+ * read from the SAME live config the lead reads, so a user who tunes compaction
+ * tunes every child identically - the requirement "same mode and configuration
+ * as the main agent", taken literally.
  *
- *   A. A CONFIG VIEW, for `keepRecentTurns` / `onFailure` / `useFastTier`, which
- *      `Compactor` reads through `deps.getConfig()`.
- *   B. AN INSTANCE BOUND, for `maxPerRun`, which is STRUCTURAL and has no config
- *      path by design (`limits.ts` header). Without it the child silently
- *      inherits the lead's 5 - two and a half times the bound the reversal above
- *      rests on.
+ * THE INSTANCE BOUND stays (mechanism B of RV-2) because `maxPerRun` is
+ * STRUCTURAL with no config path by design (`limits.ts` header); it is now the
+ * SAME `COMPACTION_LIMITS.maxPerRun` the lead's own manager runs under.
  *
  * NO UI. A child's compaction produces no transcript card (DH-7): the lead's
  * transcript describes the LEAD's context, and a card there would claim the
@@ -45,11 +47,11 @@ export function createChildContextManager(req, deps) {
      * which is the same reason `subagent.ts` reuses the lead's `getApiKey` closure
      * rather than the resolved key.
      *
-     * `useFastTier: true` EXPRESSES A PREFERENCE, NOT AN OUTCOME. `resolveFastTier`
-     * still decides, and when nothing resolves the child falls back exactly as the
-     * lead does - to its OWN model, because `provider` / `model` are overlaid here
-     * too.
-     *
+     * `useFastTier` is read LIVE from the base config (main-agent
+     * parity - no overlay): it expresses a PREFERENCE, not an outcome.
+     * `resolveFastTier` still decides, and when nothing resolves the child
+     * falls back exactly as the lead does - to its OWN model, because
+     * `provider` / `model` are overlaid here too.
      * Failed summaries preserve the child's task just as they preserve the lead's.
      */
     const childConfig = () => {
@@ -63,16 +65,11 @@ export function createChildContextManager(req, deps) {
             baseUrl: req.model.baseUrl,
             // The lead's manual limit describes its connection, not every worker.
             contextWindow: sameConnection ? base.contextWindow : null,
-            compaction: {
-                ...base.compaction,
-                keepRecentTurns: COMPACTION_LIMITS.childKeepRecentTurns,
-                onFailure: 'stop',
-                useFastTier: true,
-                // ONE ARCHIVE PER LEAD COMPACTION IS AUDITABLE; TWENTY PER DISPATCH IS
-                // NOISE. The child's dropped slice is therefore never retained either -
-                // `runCompaction` reads this key before it stashes anything.
-                archive: false,
-            },
+            // NO POLICY OVERLAY (main-agent parity): `keepRecentTurns`, `onFailure`,
+            // `useFastTier` and `archive` are read LIVE from the base config, so the
+            // child compacts under exactly the policy the lead compacts under. A
+            // settings-screen edit mid-dispatch reaches a running child because this
+            // view is re-read on every call.
         };
     };
     const meter = new ContextMeter({
@@ -121,8 +118,9 @@ export function createChildContextManager(req, deps) {
         // user's transcript with no card to explain which agent it is about.
         notify: () => { },
     }, 
-    // MECHANISM B - the instance bound (RV-2 / DH-16).
-    { maxPerRun: COMPACTION_LIMITS.childMaxPerRun });
+    // MECHANISM B - the instance bound (RV-2 / DH-16). The SAME bound the
+    // lead's own manager runs under (main-agent parity).
+    { maxPerRun: COMPACTION_LIMITS.maxPerRun });
     return {
         // THERE IS NO `/compact` FOR A CHILD, so nothing is ever queued and the
         // manual branch of `shouldCompact` is unreachable by construction.

package/dist/compaction/context-command.js

@@ -74,7 +74,9 @@ function occupancyLine(usage) {
     return `${pct}   ${formatTokens(usage.occupied)} of ${formatTokens(usage.window)}   ${breakdown}`;
 }
 /**
- * Where the denominator came from. THREE SOURCES, ALL NAMED.
+ * Where the denominator came from. FOUR SOURCES, ALL NAMED - the fourth
+ * being the user's own model-windows.json, which exists precisely because
+ * the other three cannot know a gateway alias released last week.
  *
  * THE PLACEHOLDER BRANCH IS THE ONE THAT MATTERS. `buildRuntimeModel` returns a
  * flat 128000 for any model the static table has never seen - a custom
@@ -85,11 +87,20 @@ function occupancyLine(usage) {
  */
 function windowLine(usage) {
     if (usage.windowOverridden) {
-        return `${usage.window}   from contextWindow configuration (overrides API and model table)`;
+        return `${usage.window}   from contextWindow configuration (overrides API, model table, and model-windows.json)`;
     }
     if (!usage.windowKnown) {
         return (`UNKNOWN - no verified model limit; internal fallback budget ${usage.window}; ` +
-            'set contextWindow to correct it');
+            'set contextWindow or list the model in model-windows.json to correct it');
+    }
+    if (usage.windowSource === 'user') {
+        return `${usage.window}   from model-windows.json (your per-model table)`;
+    }
+    if (usage.windowSource === undefined) {
+        // A child agent can be windowKnown through the pricing-table heuristic
+        // without naming a source; claiming 'the model table' there would be an
+        // evidence-free assertion in the one report that exists to be checked.
+        return `${usage.window}   source unverified`;
     }
     return `${usage.window}   from ${usage.windowSource === 'api' ? 'the model API' : 'the model table'}`;
 }

package/dist/compaction/limits.d.ts

@@ -28,8 +28,6 @@ export declare const COMPACTION_LIMITS: {
     readonly archiveMaxFiles: 20;
     readonly archiveMaxAgeMs: 604800000;
     readonly archiveMaxBytes: 8000000;
-    readonly childKeepRecentTurns: 2;
-    readonly childMaxPerRun: 2;
     readonly cardTextRows: 6;
     readonly statusCompactCols: 100;
 };

package/dist/compaction/limits.js

@@ -29,8 +29,6 @@ export const COMPACTION_LIMITS = {
     archiveMaxFiles: 20,
     archiveMaxAgeMs: 604_800_000,
     archiveMaxBytes: 8_000_000,
-    childKeepRecentTurns: 2,
-    childMaxPerRun: 2,
     cardTextRows: 6,
     statusCompactCols: 100,
 };

package/dist/compaction/types.d.ts

@@ -65,7 +65,12 @@ export interface CompactionDecision {
     deltaTokens: number;
 }
 export interface Pressure {
-    windowSource?: 'api' | 'catalog' | 'fallback';
+    /**
+     * `user` means the CLI's model-windows.json supplied the denominator - a
+     * hand-typed window for a model no table knows. It outranks `api` and
+     * `catalog` in `getModelInfoFor` precisely because the user asserted it.
+     */
+    windowSource?: 'api' | 'catalog' | 'fallback' | 'user';
     occupied: number;
     contextWindow: number;
     /** `occupied / contextWindow`, clamped to [0, 1]. */

package/dist/config/app-paths.d.ts

@@ -12,6 +12,7 @@
  *   ~/.aragon-agent/
  *   ├── config.json            persisted config (0600 on POSIX)
  *   ├── config.json.bak        `aragon config edit` pre-edit backup
+ *   ├── model-windows.json     per-model context windows, user-edited
  *   ├── prompt-history.jsonl   submitted prompts, append-only (0600 on POSIX)
  *   ├── state.json             UI bookkeeping scalars (0600 on POSIX)
  *   ├── update-state.json      auto-update coordination (0600 on POSIX)
@@ -72,6 +73,15 @@ export declare function getHomeRoot(): string;
 export declare function getConfigPath(): string;
 /** Written by `aragon config edit` before spawning the editor. */
 export declare function getConfigBackupPath(): string;
+/**
+ * `<home>/model-windows.json` — per-model context windows the user declares by
+ * hand for ids no table knows (`kimi-k3`, a gateway alias, a self-hosted model).
+ *
+ * READ-ONLY from the application's side: nothing ever writes or creates it, so
+ * a user's file cannot be clobbered by an upgrade and its absence is not an
+ * error. `config/model-windows.ts` owns the format and the lookup.
+ */
+export declare function getModelWindowsPath(): string;
 /**
  * `<home>/prompt-history.jsonl` — the prompts the user submitted, one JSON
  * object per line. Deliberately NOT under `logs/`: that directory is governed

package/dist/config/app-paths.js

@@ -12,6 +12,7 @@
  *   ~/.aragon-agent/
  *   ├── config.json            persisted config (0600 on POSIX)
  *   ├── config.json.bak        `aragon config edit` pre-edit backup
+ *   ├── model-windows.json     per-model context windows, user-edited
  *   ├── prompt-history.jsonl   submitted prompts, append-only (0600 on POSIX)
  *   ├── state.json             UI bookkeeping scalars (0600 on POSIX)
  *   ├── update-state.json      auto-update coordination (0600 on POSIX)
@@ -129,6 +130,17 @@ export function getConfigPath() {
 export function getConfigBackupPath() {
     return join(resolution.root, 'config.json.bak');
 }
+/**
+ * `<home>/model-windows.json` — per-model context windows the user declares by
+ * hand for ids no table knows (`kimi-k3`, a gateway alias, a self-hosted model).
+ *
+ * READ-ONLY from the application's side: nothing ever writes or creates it, so
+ * a user's file cannot be clobbered by an upgrade and its absence is not an
+ * error. `config/model-windows.ts` owns the format and the lookup.
+ */
+export function getModelWindowsPath() {
+    return join(resolution.root, 'model-windows.json');
+}
 /**
  * `<home>/prompt-history.jsonl` — the prompts the user submitted, one JSON
  * object per line. Deliberately NOT under `logs/`: that directory is governed

package/dist/config/cli-commands.d.ts

@@ -42,7 +42,7 @@ export declare const RETRY_CONFIG_SET_KEYS: readonly ["retry.enabled", "retry.ma
  * would silently never take effect, and `config set` would still print
  * `Set fast.model = haiku`.
  */
-export declare const FAST_CONFIG_SET_KEYS: readonly ["fast.enabled", "fast.provider", "fast.model", "fast.baseUrl", "fast.thinkingLevel", "fast.delegate", "fast.review", "fast.reviewEveryTurns", "fast.reviewContextTurns", "fast.reviewMaxChars", "fast.reviewMaxPerSession"];
+export declare const FAST_CONFIG_SET_KEYS: readonly ["fast.enabled", "fast.provider", "fast.model", "fast.baseUrl", "fast.thinkingLevel", "fast.review", "fast.reviewEveryTurns", "fast.reviewContextTurns", "fast.reviewMaxChars", "fast.reviewMaxPerSession"];
 /**
  * Config keys under `update.` that `aragon config set` accepts (cli-auto-update
  * §4.1).

package/dist/config/cli-commands.js

@@ -14,7 +14,7 @@ import { getConfigBackupPath, getConfigPath, getHomeRoot, getLogsDir, getPromptH
 import { getHomeMigrationBreadcrumbPath } from './migrate-home.js';
 import { loadPersistedConfig, updatePersistedConfig } from './store.js';
 import { normalizeModelProfiles, validateModelProfiles } from './model-profiles.js';
-import { clampFastConfig, clampRetryConfig, clampCompactionConfig, parseThresholdInput, clampUpdateConfig, coercePositiveInt, maskSecret, DEFAULT_FAST_CONFIG, DEFAULT_RETRY_CONFIG, DEFAULT_TEAM_CONFIG, DEFAULT_COMPACTION_CONFIG, DEFAULT_UPDATE_CONFIG, } from './schema.js';
+import { clampFastConfig, clampRetryConfig, clampCompactionConfig, clampTeamConfig, parseThresholdInput, clampUpdateConfig, coercePositiveInt, maskSecret, DEFAULT_FAST_CONFIG, DEFAULT_RETRY_CONFIG, DEFAULT_TEAM_CONFIG, DEFAULT_COMPACTION_CONFIG, DEFAULT_UPDATE_CONFIG, } from './schema.js';
 import { clampLogLevel } from '../logging/levels.js';
 /** Config keys under `log.` that `aragon config set` accepts. */
 export const LOG_CONFIG_SET_KEYS = [
@@ -81,7 +81,6 @@ export const FAST_CONFIG_SET_KEYS = [
     'fast.model',
     'fast.baseUrl',
     'fast.thinkingLevel',
-    'fast.delegate',
     'fast.review',
     'fast.reviewEveryTurns',
     'fast.reviewContextTurns',
@@ -177,25 +176,29 @@ export function applyLogConfigSet(key, value) {
  */
 export function applyTeamConfigSet(key, value) {
     const patch = (team) => ({ team });
+    // EVERY NUMERIC KEY ROUTES THROUGH `clampTeamConfig`, not through
+    // `coercePositiveInt`, for the reason `applyRetryConfigSet` records one block
+    // below: `coercePositiveInt` returns its fallback for `n <= 0`, so
+    // `config set team.subagentTimeoutMs 0` would write 300000 (the old default)
+    // instead of the documented NO-LIMIT value, silently. The caller echoes the
+    // STORED value, which is what makes an out-of-range input visible.
+    const clampOne = (field) => {
+        const merged = clampTeamConfig({ ...DEFAULT_TEAM_CONFIG, [field]: value });
+        return { [field]: merged[field] };
+    };
     switch (key) {
         case 'team.enabled':
             return patch({ enabled: isTrue(value) });
         case 'team.maxSubagents':
-            return patch({ maxSubagents: coercePositiveInt(value, DEFAULT_TEAM_CONFIG.maxSubagents) });
+            return patch(clampOne('maxSubagents'));
         case 'team.maxConcurrent':
-            return patch({ maxConcurrent: coercePositiveInt(value, DEFAULT_TEAM_CONFIG.maxConcurrent) });
+            return patch(clampOne('maxConcurrent'));
         case 'team.subagentTimeoutMs':
-            return patch({
-                subagentTimeoutMs: coercePositiveInt(value, DEFAULT_TEAM_CONFIG.subagentTimeoutMs),
-            });
+            return patch(clampOne('subagentTimeoutMs'));
         case 'team.dispatchTimeoutMs':
-            return patch({
-                dispatchTimeoutMs: coercePositiveInt(value, DEFAULT_TEAM_CONFIG.dispatchTimeoutMs),
-            });
+            return patch(clampOne('dispatchTimeoutMs'));
         case 'team.maxTurnsPerSubagent':
-            return patch({
-                maxTurnsPerSubagent: coercePositiveInt(value, DEFAULT_TEAM_CONFIG.maxTurnsPerSubagent),
-            });
+            return patch(clampOne('maxTurnsPerSubagent'));
         default:
             return null;
     }
@@ -273,8 +276,6 @@ export function applyFastConfigSet(key, value) {
             return patch(clampOne('baseUrl'));
         case 'fast.thinkingLevel':
             return patch(clampOne('thinkingLevel'));
-        case 'fast.delegate':
-            return patch({ delegate: isTrue(value) });
         case 'fast.review':
             return patch({ review: isTrue(value) });
         case 'fast.reviewEveryTurns':

package/dist/config/env.d.ts

@@ -7,7 +7,8 @@
  *   - Overrides: ARAGON_PROVIDER, ARAGON_MODEL, ARAGON_BASE_URL, ARAGON_THINKING,
  *     ARAGON_SHOW_THINKING,
  *     ARAGON_MAX_TOKENS (a number, or `auto` / `0` for the per-model ceiling),
- *     ARAGON_THEME, ARAGON_MOUSE, ARAGON_PASTE, ARAGON_PLAN, ARAGON_TEAM,
+ *     ARAGON_THEME, ARAGON_MOUSE, ARAGON_PASTE, ARAGON_KEYBOARD_ENHANCEMENT,
+ *     ARAGON_PLAN, ARAGON_TEAM,
  *     ARAGON_TEAM_MAX, ARAGON_RETRY, ARAGON_RETRY_MAX, ARAGON_FAST,
  *     ARAGON_FAST_PROVIDER, ARAGON_FAST_MODEL, ARAGON_FAST_BASE_URL,
  *     ARAGON_LOG_LEVEL,

package/dist/config/env.js

@@ -7,7 +7,8 @@
  *   - Overrides: ARAGON_PROVIDER, ARAGON_MODEL, ARAGON_BASE_URL, ARAGON_THINKING,
  *     ARAGON_SHOW_THINKING,
  *     ARAGON_MAX_TOKENS (a number, or `auto` / `0` for the per-model ceiling),
- *     ARAGON_THEME, ARAGON_MOUSE, ARAGON_PASTE, ARAGON_PLAN, ARAGON_TEAM,
+ *     ARAGON_THEME, ARAGON_MOUSE, ARAGON_PASTE, ARAGON_KEYBOARD_ENHANCEMENT,
+ *     ARAGON_PLAN, ARAGON_TEAM,
  *     ARAGON_TEAM_MAX, ARAGON_RETRY, ARAGON_RETRY_MAX, ARAGON_FAST,
  *     ARAGON_FAST_PROVIDER, ARAGON_FAST_MODEL, ARAGON_FAST_BASE_URL,
  *     ARAGON_LOG_LEVEL,
@@ -151,6 +152,17 @@ export function readEnvConfig() {
     if (paste !== undefined && paste.length > 0) {
         partial.paste = paste === '1' || paste === 'true' || paste === 'on' || paste === 'yes';
     }
+    // ARAGON_KEYBOARD_ENHANCEMENT=0 stops the Shift+Enter mode push and its
+    // translation -- the one-env revert to pre-enhancement input handling.
+    // Parsed by the POSITIVE list, exactly as its three neighbours above are.
+    const keyboardEnhancement = process.env.ARAGON_KEYBOARD_ENHANCEMENT?.trim().toLowerCase();
+    if (keyboardEnhancement !== undefined && keyboardEnhancement.length > 0) {
+        partial.keyboardEnhancement =
+            keyboardEnhancement === '1' ||
+                keyboardEnhancement === 'true' ||
+                keyboardEnhancement === 'on' ||
+                keyboardEnhancement === 'yes';
+    }
     // ARAGON_SCROLL_RESUME_MS=<n> — idle delay before a paused viewport returns to
     // the newest line; `0` disables auto-resume. THE ONLY CHANNEL BESIDES THE
     // CONFIG FILE, because §6.1 gives this key no CLI flag on purpose. `load.ts`