claudish 14.11.0 → 14.12.0

package/dist/index.js

@@ -5491,7 +5491,7 @@ var init_onepassword_config = __esm(() => {
 });
 
 // src/version.ts
-var VERSION = "14.11.0";
+var VERSION = "14.12.0";
 
 // src/redact.ts
 function isPlaceholder(value) {
@@ -73048,7 +73048,8 @@ var init_contract = __esm(() => {
     "capture_since_seq",
     "capture_spans",
     "resize",
-    "allowance"
+    "allowance",
+    "scroll"
   ];
   SLOT_STATES = [
     "STARTING",
@@ -93473,6 +93474,39 @@ var init_screen_classifier = __esm(() => {
   NON_ANSWER_ROW = /^\s+\u23BF|^\s{2}(Ran|Read|Searched|Wrote|Edited|Listed|Updated) \d+ |^\s*[\u00B7\u2722\u2733\u2736\u273B\u273D*\u25CF\u2217]\s|^\s*\(ctrl\+/;
 });
 
+// src/pane/scroll-input.ts
+function isLiveBottom(pos) {
+  return pos.atBottom && pos.lastDirection === null;
+}
+function scrollRowsOf(by) {
+  if (!Number.isFinite(by))
+    return 0;
+  return Math.min(Math.abs(Math.trunc(by)), MAX_SCROLL_ROWS);
+}
+function planScroll(pos, req) {
+  if ("to" in req)
+    return { bytes: CTRL_END, events: 1, next: LIVE_BOTTOM };
+  const n = scrollRowsOf(req.by);
+  if (n === 0)
+    return { bytes: "", events: 0, next: pos };
+  const dir = req.by < 0 ? "up" : "down";
+  const extra = pos.atBottom || pos.lastDirection !== dir ? 1 : 0;
+  const events = n + extra;
+  return {
+    bytes: (dir === "up" ? WHEEL_UP : WHEEL_DOWN).repeat(events),
+    events,
+    next: { atBottom: false, lastDirection: dir }
+  };
+}
+var MAX_SCROLL_ROWS = 200, WHEEL_UP = "\x1B[<64;1;1M", WHEEL_DOWN = "\x1B[<65;1;1M", CTRL_END = "\x1B[1;5F", LIVE_BOTTOM, UNKNOWN_POSITION;
+var init_scroll_input = __esm(() => {
+  LIVE_BOTTOM = Object.freeze({ atBottom: true, lastDirection: null });
+  UNKNOWN_POSITION = Object.freeze({
+    atBottom: false,
+    lastDirection: null
+  });
+});
+
 // src/pane/session-registry.ts
 import { readFileSync as readFileSync40, readdirSync as readdirSync6 } from "fs";
 import { join as join48 } from "path";
@@ -94617,6 +94651,9 @@ class PaneSessionImpl {
   resizeQuietFrom = 0;
   resizeQuietUntil = 0;
   activityChangedAt = 0;
+  scrollPos = LIVE_BOTTOM;
+  scrollEndsInFlight = 0;
+  scrollEndConfirmedAt = 0;
   gate = null;
   gateTrusted = false;
   gateInFlight = false;
@@ -95407,8 +95444,8 @@ ${gate}`
           await this.pause(adm, TICK_MS);
           continue;
         }
-        if (!this.client || !this.gateTrusted) {
-          await this.awaitTrustedClient(adm);
+        if (!this.trustedConnection() || this.needsAdmissionLiveBottom(adm)) {
+          await this.connectionStep(adm);
           continue;
         }
         if (await this.beforeSend(adm) !== "send")
@@ -95420,8 +95457,22 @@ ${gate}`
       adm.inFlight = false;
     }
   }
+  needsAdmissionLiveBottom(adm) {
+    if (adm.liveBottomClient === this.client)
+      return false;
+    adm.liveBottomClient = this.client;
+    return !isLiveBottom(this.scrollPos);
+  }
+  trustedConnection() {
+    return !!this.client && !this.client.isClosed && this.gateTrusted;
+  }
+  connectionStep(adm) {
+    if (!this.trustedConnection())
+      return this.awaitTrustedClient(adm);
+    return this.returnToLiveBottom(Math.max(0, adm.deadline - Date.now()));
+  }
   awaitTrustedClient(adm) {
-    return this.waitFor(() => !this.admitting(adm) || !!this.client && this.gateTrusted, Math.max(0, adm.deadline - Date.now()));
+    return this.waitFor(() => !this.admitting(adm) || this.trustedConnection(), Math.max(0, adm.deadline - Date.now()));
   }
   async attemptOnce(adm) {
     const c = this.client;
@@ -95846,6 +95897,7 @@ ${screenTailOf(this.screen)}` });
   accept() {
     this.admission = null;
     this.initialDelivery = false;
+    this.scrollPos = LIVE_BOTTOM;
     const now = Date.now();
     this.lastChatSeenAt = now;
     this.turnAcceptedAt = now;
@@ -95922,6 +95974,7 @@ ${screenTailOf(this.screen)}`
       const d = this.currentDelivery;
       this.turnSource = "screen";
       this.anomaly("degraded_mode");
+      this.returnToLiveBottom(SCROLL_REPLY_MS);
       this.screenTurn = {
         echo: d && d.mode !== "refused" ? d.line : "",
         acceptedAt: at,
@@ -96399,11 +96452,21 @@ ${screenTailOf(this.screen)}`
     const g = this.gateNow();
     if (!g || !g.ready || g.dialog !== null || workingAboveBox(this.screen) === true)
       return false;
-    const quiet = this.aboveBoxQuietMs() ?? Date.now() - this.screen.changedAt;
+    let quiet = this.aboveBoxQuietMs() ?? Date.now() - this.screen.changedAt;
+    if (this.scrollEndConfirmedAt > 0)
+      quiet = Math.min(quiet, Date.now() - this.scrollEndConfirmedAt);
     if (view.availability === "off" && quiet >= this.secondaryQuietMs)
       return true;
     return (!!answer || !!apiError) && quiet >= 2 * this.t("screenSettleQuietMs", SCREEN_SETTLE_QUIET_MS);
   }
+  screenViewLive() {
+    if (this.scrollEndsInFlight > 0)
+      return false;
+    if (isLiveBottom(this.scrollPos))
+      return true;
+    this.returnToLiveBottom(SCROLL_REPLY_MS);
+    return false;
+  }
   evalScreenTurn(view) {
     if (this.witnessed(view.current)) {
       this.turnSource = "transcript";
@@ -96418,7 +96481,7 @@ ${screenTailOf(this.screen)}`
     const answer = screenAnswer(this.screen, st.echo);
     const apiError = this.screenApiError(st, answer);
     this.activity = "thinking";
-    if (!this.screenSettleReady(view, answer, apiError))
+    if (!this.screenViewLive() || !this.screenSettleReady(view, answer, apiError))
       return;
     this.follower.poll();
     if (this.witnessed(this.follower.view().current))
@@ -96749,6 +96812,69 @@ ${screenTailOf(this.screen)}`
       answer({ ...set, changed: true, seq: this.screen.seq });
     }
   }
+  async scroll(req) {
+    const refusal = this.scrollRefusal();
+    if (refusal)
+      throw new ContractErrorException("scroll_unavailable", refusal);
+    const c = this.client;
+    if (!c || c.isClosed)
+      throw new ContractErrorException("scroll_unavailable", "the pane's socket is reconnecting");
+    const plan = planScroll(this.scrollPos, req);
+    if (plan.bytes === "")
+      return { seq: this.screen.seq };
+    this.scrollPos = plan.next;
+    const seq0 = this.screen.seq;
+    this.extendResizeQuiet();
+    const r = await c.request({ type: "send", pane: 0, text: plan.bytes, enter: false, noGate: true }, SCROLL_REPLY_MS);
+    if (!r.ok) {
+      this.scrollPos = UNKNOWN_POSITION;
+      if (r.code === "client_lost" || r.code === "client_timeout")
+        this.extendResizeQuiet();
+      throw new ContractErrorException("scroll_unavailable", `magmux did not confirm the scroll: ${r.code}${r.error ? `: ${r.error}` : ""}`);
+    }
+    this.extendResizeQuiet();
+    await this.waitFor(() => isTerminalPhase(this.phase) || this.screen.seq !== seq0, this.t("scrollScreenMs", SCROLL_SCREEN_MS));
+    return { seq: this.screen.seq };
+  }
+  screenTurnActive() {
+    if (this.turnSource !== "screen")
+      return false;
+    return this.phase === "RUNNING" || this.phase === "QUESTION" || this.phase === "PERMISSION";
+  }
+  scrollRefusal() {
+    if (isTerminalPhase(this.phase) || this.final)
+      return "the session has finished";
+    if (this.phase === "BOOTING" || this.screen.seq === 0)
+      return "the session is still starting";
+    if (this.phase === "ADMITTING")
+      return "a prompt is being delivered to the session";
+    if (this.screenTurnActive())
+      return "the session's turn is being read from its screen (no transcript)";
+    if (!this.client || this.client.isClosed || !this.gateTrusted)
+      return "the pane's socket is reconnecting";
+    return null;
+  }
+  async returnToLiveBottom(ms) {
+    if (isLiveBottom(this.scrollPos))
+      return;
+    const c = this.client;
+    if (!c || c.isClosed || !this.gateTrusted || ms <= 0)
+      return;
+    this.scrollPos = LIVE_BOTTOM;
+    this.extendResizeQuiet();
+    this.scrollEndsInFlight++;
+    try {
+      const r = await c.request({ type: "send", pane: 0, text: CTRL_END, enter: false, noGate: true }, Math.min(SCROLL_REPLY_MS, ms));
+      if (r.ok) {
+        this.scrollEndConfirmedAt = Date.now();
+      } else {
+        this.scrollPos = UNKNOWN_POSITION;
+        this.anomaly(`scroll_end_unconfirmed:${r.code}`);
+      }
+    } finally {
+      this.scrollEndsInFlight--;
+    }
+  }
   turnAnswer(index) {
     const done = this.answers.get(index);
     if (done !== undefined)
@@ -97001,7 +97127,8 @@ function newAdmission(a) {
     clearAfter: 0,
     lostType: null,
     last: null,
-    noted: new Set
+    noted: new Set,
+    liveBottomClient: null
   };
 }
 function markClearFirst(adm) {
@@ -97168,7 +97295,7 @@ async function startPaneSession(o) {
   await session.start({ magmuxBinary: magmux.binary, env: p.magmuxEnv, cwd: p.cwd });
   return session;
 }
-var BOOT_TIMEOUT_MS = 90000, ADMIT_TIMEOUT_MS = 30000, DEGRADED_ENTRY_MS = 1e4, SCREEN_SETTLE_QUIET_MS = 3000, PANEL_SETTLE_MS = 500, SEND_CLIENT_SLACK_MS = 2000, MIN_READY_TIMEOUT_MS = 1000, BUSY_RETRY_MS = 250, MISMATCH_SETTLE_MS = 1000, CLEAR_WAIT_MS = 1000, BOOT_STATIC_MS = 5000, TICK_MS = 250, WATCH_FPS = 4, POLL_BACKSTOP_MS = 1000, TURN_END_MISSING_FACTOR = 3, RESIZE_REPLY_MS = 1e4, RESIZE_SCREEN_MS = 1000, GATE_POLL_MS = 250, GATE_REPLY_MS = 1000, GATE_STALE_MS2 = 1000, GATE_GRACE_MS, GATE_DEAD_BACKSTOP_MS = 1000, EXIT_CODE_QUERY_MS = 2000, EXIT_CODE_RETRY_MS = 50, GATE_KINDLESS_REASONS, RUNTIME_DIALOG_KINDS, REGISTRY_READ_MS = 250, REGISTRY_DISAGREE_MS = 2000, REGISTRY_GATE_BOOT_DISAGREE_MS = 5000, REGISTRY_MISSING_MS = 5000, MAX_ANOMALY_KEYS = 64, KEPT_ANSWERS = 4, DEFAULT_MAX_CONSECUTIVE = 3, EVENT_REASON, VERDICT_EVENT, PaneStartError;
+var BOOT_TIMEOUT_MS = 90000, ADMIT_TIMEOUT_MS = 30000, DEGRADED_ENTRY_MS = 1e4, SCREEN_SETTLE_QUIET_MS = 3000, PANEL_SETTLE_MS = 500, SEND_CLIENT_SLACK_MS = 2000, MIN_READY_TIMEOUT_MS = 1000, BUSY_RETRY_MS = 250, MISMATCH_SETTLE_MS = 1000, CLEAR_WAIT_MS = 1000, BOOT_STATIC_MS = 5000, TICK_MS = 250, WATCH_FPS = 4, POLL_BACKSTOP_MS = 1000, TURN_END_MISSING_FACTOR = 3, RESIZE_REPLY_MS = 1e4, RESIZE_SCREEN_MS = 1000, SCROLL_REPLY_MS = 5000, SCROLL_SCREEN_MS = 1000, GATE_POLL_MS = 250, GATE_REPLY_MS = 1000, GATE_STALE_MS2 = 1000, GATE_GRACE_MS, GATE_DEAD_BACKSTOP_MS = 1000, EXIT_CODE_QUERY_MS = 2000, EXIT_CODE_RETRY_MS = 50, GATE_KINDLESS_REASONS, RUNTIME_DIALOG_KINDS, REGISTRY_READ_MS = 250, REGISTRY_DISAGREE_MS = 2000, REGISTRY_GATE_BOOT_DISAGREE_MS = 5000, REGISTRY_MISSING_MS = 5000, MAX_ANOMALY_KEYS = 64, KEPT_ANSWERS = 4, DEFAULT_MAX_CONSECUTIVE = 3, EVENT_REASON, VERDICT_EVENT, PaneStartError;
 var init_pane_session = __esm(() => {
   init_queue();
   init_parent_session();
@@ -97185,6 +97312,7 @@ var init_pane_session = __esm(() => {
   init_prompt_delivery();
   init_screen_classifier();
   init_screen_model();
+  init_scroll_input();
   init_session_registry();
   init_settle_rule();
   init_slot_state();
@@ -97239,6 +97367,7 @@ var init_pane = __esm(() => {
   init_pane_launch();
   init_pane_registry();
   init_pane_session();
+  init_scroll_input();
   init_contract();
 });
 
@@ -97967,6 +98096,20 @@ async function resizeTeamSlot(path, slot, cols, rows, runId) {
     return { ...where, cols: DEFAULT_PANE_COLS, rows: DEFAULT_PANE_ROWS, changed: false, seq: 0 };
   return { ...where, ...await e.session.resize(cols, rows) };
 }
+async function scrollTeamSlot(path, slot, req, runId) {
+  const run = addressRun(path, runId);
+  if (!run)
+    throw unknownRun(path, runId);
+  const e = run.slots.get(slot);
+  if (!e)
+    throw new ContractErrorException("unknown_slot", `run ${run.runId} has no slot ${JSON.stringify(slot)}`);
+  if (!e.session) {
+    const state = run.status.models[e.id]?.state;
+    throw new ContractErrorException("scroll_unavailable", state === undefined || isTerminalState(state) ? "the slot has finished" : "the slot is still starting");
+  }
+  const r = await e.session.scroll(req);
+  return { run_id: run.runId, path: run.path, slot, seq: r.seq };
+}
 function teamLiveMaps(path, runId) {
   const run = addressRun(path, runId);
   if (!run)
@@ -100007,6 +100150,15 @@ class SessionManager {
     const r = await entry.session.resize(cols, rows);
     return { session_id: sessionId, ...r };
   }
+  async scrollSession(sessionId, req) {
+    const entry = this.liveEntry(sessionId);
+    if (!entry)
+      throw unknownSession(sessionId);
+    if (!entry.session)
+      throw new ContractErrorException("scroll_unavailable", isTerminalState(entry.info.state) ? "the session has finished" : "the session is still starting");
+    const r = await entry.session.scroll(req);
+    return { session_id: sessionId, seq: r.seq };
+  }
   captureSession(sessionId, sinceSeq, spans) {
     const entry = this.liveEntry(sessionId);
     if (!entry)
@@ -100442,7 +100594,7 @@ var NESTED_MCP_TOOL_NAMES, NESTED_INSTRUCTIONS = `Claudish MCP server provides a
 
 ## Nested mode \u2014 no sessions
 
-This server runs inside a session that a claudish MCP server started (CLAUDISH_PANE_CHILD=1). One level of nesting is the limit, so these tools are not registered: create_session, team, send_input, get_output, cancel_session, list_sessions, get_diagnostics, capture_session, preflight, report_error. No channel notifications are sent.
+This server runs inside a session that a claudish MCP server started (CLAUDISH_PANE_CHILD=1). One level of nesting is the limit, so these tools are not registered: create_session, team, send_input, get_output, cancel_session, list_sessions, get_diagnostics, capture_session, resize_session, scroll_session, preflight, report_error. No channel notifications are sent.
 
 - run_prompt or compare_models: a one-shot answer from another model.
 - list_models, search_models: find a model.
@@ -101539,6 +101691,22 @@ function requiredInteger(raw, name, mode) {
     throw new ContractErrorException("invalid_args", `'${name}' is required${mode ? ` for mode '${mode}'` : ""}`);
   return n;
 }
+function scrollArgs(args) {
+  const by = optionalInteger(args.by, "by");
+  const to = args.to;
+  if (to !== undefined && to !== null && to !== "end")
+    throw new ContractErrorException("invalid_args", `'to' must be "end"`);
+  const hasTo = to === "end";
+  if (by !== undefined && hasTo)
+    throw new ContractErrorException("invalid_args", "give exactly one of 'by' and 'to', not both");
+  if (hasTo)
+    return { to: "end" };
+  if (by === undefined)
+    throw new ContractErrorException("invalid_args", "one of 'by' and 'to' is required");
+  if (by === 0)
+    throw new ContractErrorException("invalid_args", "'by' must not be 0");
+  return { by };
+}
 function teamStatusAnswer(path, runId) {
   let row = null;
   if (runId) {
@@ -101583,6 +101751,7 @@ async function teamContractVerb(mode, args) {
     const spans = optionalBoolean(args.spans, "spans");
     const cols = mode === "resize" ? requiredInteger(args.cols, "cols", mode) : undefined;
     const rows = mode === "resize" ? requiredInteger(args.rows, "rows", mode) : undefined;
+    const scroll = mode === "scroll" ? scrollArgs(args) : undefined;
     switch (mode) {
       case "status":
         return contractAnswer(teamStatusAnswer(path, runId));
@@ -101598,6 +101767,11 @@ async function teamContractVerb(mode, args) {
           throw new ContractErrorException("invalid_args", "'slot' is required for mode 'resize'");
         return contractAnswer(await resizeTeamSlot(path, slot, cols, rows, runId));
       }
+      case "scroll": {
+        if (slot === undefined)
+          throw new ContractErrorException("invalid_args", "'slot' is required for mode 'scroll'");
+        return contractAnswer(await scrollTeamSlot(path, slot, scroll, runId));
+      }
     }
   } catch (e) {
     return contractErrorAnswer(e);
@@ -101945,18 +102119,28 @@ This searched OpenRouter's listing only. Subscription wire ids and catalog alias
   });
   tools.push({
     name: "team",
-    description: "Run AI models on a task with anonymized outputs and optional blind judging. Every slot is an interactive Claude Code session in its own headless magmux pane. " + "Modes: 'run' (START the models and return once each has taken its prompt \u2014 it does " + "NOT wait for answers), 'status' (per-slot state; read `run.slots`), 'list' (every run this server holds), 'capture' (one slot's screen), 'resize' (set one slot's terminal size), 'cancel' (stop one slot or the whole run), 'judge'(blind-vote on existing outputs), 'run-and-judge' (the blocking pipeline). Poll 'status' (read run.slots) or 'list'. NO SLOT IS EVER KILLED ON A TIMER once its prompt is accepted. A team slot is a full Claude Code session and may work for a long time; a slot inside a build or test suite emits nothing for minutes and is working, not stuck. Judge the silence against the task you set, and use 'cancel' if you decide a slot is wedged. A slot that stops on a question it cannot answer is FAILED 'blocked' (team has no way to answer it). JUDGING A WORKING SLOT: read live_output_bytes_by_slot, idle_seconds_by_slot and activity_by_slot (or each row's idle_seconds and " + "activity). Do NOT use 'outputSize' \u2014 it is the size of the final answer, written " + "only when a slot finishes, so it is 0 for every working slot no matter how much that slot has produced.",
+    description: "Run AI models on a task with anonymized outputs and optional blind judging. Every slot is an interactive Claude Code session in its own headless magmux pane. " + "Modes: 'run' (START the models and return once each has taken its prompt \u2014 it does " + "NOT wait for answers), 'status' (per-slot state; read `run.slots`), 'list' (every run this server holds), 'capture' (one slot's screen), 'resize' (set one slot's terminal size), 'scroll' (scroll one slot's transcript view), 'cancel' (stop one slot or the whole run), 'judge'(blind-vote on existing outputs), 'run-and-judge' (the blocking pipeline). Poll 'status' (read run.slots) or 'list'. NO SLOT IS EVER KILLED ON A TIMER once its prompt is accepted. A team slot is a full Claude Code session and may work for a long time; a slot inside a build or test suite emits nothing for minutes and is working, not stuck. Judge the silence against the task you set, and use 'cancel' if you decide a slot is wedged. A slot that stops on a question it cannot answer is FAILED 'blocked' (team has no way to answer it). JUDGING A WORKING SLOT: read live_output_bytes_by_slot, idle_seconds_by_slot and activity_by_slot (or each row's idle_seconds and " + "activity). Do NOT use 'outputSize' \u2014 it is the size of the final answer, written " + "only when a slot finishes, so it is 0 for every working slot no matter how much that slot has produced.",
     inputSchema: {
       type: "object",
       properties: {
         mode: {
           type: "string",
-          enum: ["run", "judge", "run-and-judge", "status", "cancel", "list", "capture", "resize"],
-          description: "Operation mode. 'run' STARTS the models and returns once every slot has taken " + "its prompt (or failed to) \u2014 it does not wait for answers. Poll 'status' (read " + "`run.slots`) or 'list' for progress, then 'judge' once the slots have finished. 'capture' returns one slot's screen; 'resize' sets its terminal size. 'run-and-judge' is the blocking pipeline and holds the call open for the whole run. 'cancel' stops one slot or the whole run."
+          enum: [
+            "run",
+            "judge",
+            "run-and-judge",
+            "status",
+            "cancel",
+            "list",
+            "capture",
+            "resize",
+            "scroll"
+          ],
+          description: "Operation mode. 'run' STARTS the models and returns once every slot has taken " + "its prompt (or failed to) \u2014 it does not wait for answers. Poll 'status' (read " + "`run.slots`) or 'list' for progress, then 'judge' once the slots have finished. 'capture' returns one slot's screen; 'resize' sets its terminal size; 'scroll' scrolls its transcript view (`by` or `to`). 'run-and-judge' is the blocking pipeline and holds the call open for the whole run. 'cancel' stops one slot or the whole run."
         },
         slot: {
           type: "string",
-          description: "For 'cancel', 'capture' and 'resize': the anonymised slot id (e.g. '02') from the slot map 'run' returned. 'capture' and 'resize' require it; for 'cancel', omit it to stop every slot in the run."
+          description: "For 'cancel', 'capture', 'resize' and 'scroll': the anonymised slot id (e.g. '02') from the slot map 'run' returned. 'capture', 'resize' and 'scroll' require it; for 'cancel', omit it to stop every slot in the run."
         },
         path: {
           type: "string",
@@ -101964,7 +102148,7 @@ This searched OpenRouter's listing only. Subscription wire ids and catalog alias
         },
         run_id: {
           type: "string",
-          description: "For 'status', 'cancel', 'capture' and 'resize': the run_id a 'run' answer returned. It addresses THAT run while this server retains it, even after a newer run reused the path. Omit it to address the newest run at 'path'."
+          description: "For 'status', 'cancel', 'capture', 'resize' and 'scroll': the run_id a 'run' answer returned. It addresses THAT run while this server retains it, even after a newer run reused the path. Omit it to address the newest run at 'path'."
         },
         since_seq: {
           type: "number",
@@ -101982,6 +102166,15 @@ This searched OpenRouter's listing only. Subscription wire ids and catalog alias
           type: "integer",
           description: "For 'resize' (required): the terminal height in rows, clamped to 24\u20139999 and to " + "at most 4 000 000 cells (cols \xD7 rows)."
         },
+        by: {
+          type: "integer",
+          description: "For 'scroll': rows to scroll the slot's transcript view; negative = toward older " + `content, positive = toward the live bottom. A target, \xB1 1 row; |by| is capped at ${MAX_SCROLL_ROWS}. Not 0. Give exactly one of 'by' and 'to'. The answer {run_id, path, slot, seq} carries the screen's seq after the scroll.`
+        },
+        to: {
+          type: "string",
+          enum: ["end"],
+          description: `For 'scroll': "end" returns the slot's view to the live bottom. Give exactly one of 'by' and 'to'.`
+        },
         models: {
           type: "array",
           items: { type: "string" },
@@ -102038,7 +102231,7 @@ This searched OpenRouter's listing only. Subscription wire ids and catalog alias
     heartbeat: true,
     handler: async (args, ctx) => {
       const mode = args.mode;
-      if (mode === "list" || mode === "status" || mode === "cancel" || mode === "capture" || mode === "resize") {
+      if (mode === "list" || mode === "status" || mode === "cancel" || mode === "capture" || mode === "resize" || mode === "scroll") {
         return teamContractVerb(mode, args);
       }
       try {
@@ -102739,6 +102932,38 @@ Report manually at https://github.com/anthropics/claudish/issues${autoSendHint}`
       }
     }
   });
+  tools.push({
+    name: "scroll_session",
+    description: "Scroll a session's transcript view, as a mouse wheel over the child's Claude Code would: the next capture_session shows the child scrolled. `by` is a signed row count (negative = toward older content, positive = toward the live bottom); it is a " + `target, \xB1 1 row, and |by| is capped at ${MAX_SCROLL_ROWS} per call. \`to:"end"\` returns to the live bottom. Give exactly one of \`by\` and \`to\`; \`by:0\` is refused. It never types into the prompt, submits or answers a dialog, and a prompt claudish delivers next returns the view to the bottom first. The answer {session_id, seq} carries the screen's seq after the scroll (the first changed screen within 1 s, else the current one). Errors are a JSON ContractError: \`scroll_unavailable\` while the session is still starting, finished, delivering a prompt, reading its turn from the screen or reconnecting, or when magmux did not confirm the send (the scroll may still land). Nothing is queued.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        session_id: { type: "string", description: "Session ID from create_session" },
+        by: {
+          type: "integer",
+          description: `Rows to scroll; negative = older content. Not 0; |by| capped at ${MAX_SCROLL_ROWS}; a target, \xB1 1 row`
+        },
+        to: {
+          type: "string",
+          enum: ["end"],
+          description: '"end" returns the view to the live bottom'
+        }
+      },
+      required: ["session_id"]
+    },
+    group: "session",
+    handler: async (args) => {
+      try {
+        const sessionId = optionalString(args.session_id, "session_id");
+        if (sessionId === undefined)
+          throw new ContractErrorException("invalid_args", "'session_id' is required");
+        const req = scrollArgs(args);
+        return contractAnswer(await sessionManager.scrollSession(sessionId, req));
+      } catch (e) {
+        return contractErrorAnswer(e);
+      }
+    }
+  });
   return tools;
 }
 function resolveToolGroups(mode) {
@@ -102882,7 +103107,7 @@ Each session is an interactive Claude Code running the model in its own headless
 3. send_input may be called at any time; it is queued until the session is idle.
 4. COMPLETED: call get_output for the answer.
 5. FAILED or TIMEOUT \u2014 or COMPLETED with an empty or surprising answer \u2014 call get_diagnostics. It returns the child's final screen, the upstream error bodies, the recent state records, the resolved model chain and the paths to the full records. It needs no re-run and no debug flag.
-6. capture_session reads a session's current screen; resize_session sets its terminal size (any time, mid-turn included); cancel_session stops it. Nothing stops a session for being idle: a child inside a long build is silent and working.
+6. capture_session reads a session's current screen; resize_session sets its terminal size (any time, mid-turn included); scroll_session scrolls the child's transcript view (by rows, or back to the live bottom); cancel_session stops it. Nothing stops a session for being idle: a child inside a long build is silent and working.
 
 The session_id from create_session is the key for every session tool.`, proxyInstance = null, proxyStarting = null, SCORE_TIE_EPSILON = 0.000001, NEXT_STEP, KEEP_EFFORT = "default", USER_REQUIRED_MODEL_DESCRIPTION, sanitize2, TOOL_MODES;
 var init_mcp_server = __esm(() => {
@@ -116084,6 +116309,7 @@ function buildClaudishSettingsOverlay(statusLine, proxyAuthMode, paneChild = isP
   if (paneChild) {
     settings.skipDangerousModePermissionPrompt = true;
     settings.editorMode = "normal";
+    settings.wheelScrollAccelerationEnabled = false;
   }
   return settings;
 }
@@ -116108,6 +116334,9 @@ function mergeUserSettingsIfPresent(config, tempSettingsPath, statusLine, proxyA
     if (paneChild) {
       userSettings.editorMode = "normal";
     }
+    if (paneChild) {
+      userSettings.wheelScrollAccelerationEnabled = false;
+    }
     chmodSync5(tempSettingsPath, 384);
     writeFileSync27(tempSettingsPath, JSON.stringify(userSettings, null, 2), {
       encoding: "utf-8",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudish",
-  "version": "14.11.0",
+  "version": "14.12.0",
   "description": "Run Claude Code with any model - OpenRouter, Ollama, LM Studio & local models",
   "type": "module",
   "main": "./dist/index.js",
@@ -71,10 +71,10 @@
     "ai"
   ],
   "optionalDependencies": {
-    "@claudish/magmux-darwin-arm64": "14.11.0",
-    "@claudish/magmux-darwin-x64": "14.11.0",
-    "@claudish/magmux-linux-arm64": "14.11.0",
-    "@claudish/magmux-linux-x64": "14.11.0"
+    "@claudish/magmux-darwin-arm64": "14.12.0",
+    "@claudish/magmux-darwin-x64": "14.12.0",
+    "@claudish/magmux-linux-arm64": "14.12.0",
+    "@claudish/magmux-linux-x64": "14.12.0"
   },
   "author": "Jack Rudenko <i@madappgang.com>",
   "license": "MIT",