mu-harness 0.16.8 → 0.16.11

package/esm/harness/npm/src/scheduler/tool.js

@@ -10,8 +10,7 @@ const toSchedule = (raw) => {
 };
 export const createScheduleTaskTool = (deps) => ({
     name: 'schedule_task',
-    description: 'Persist a recurring (cron / heartbeat) or one-shot task that runs a sub-agent under a skill on a given prompt.',
-    prompt: 'Use `schedule_task` to register work that should run later or on a schedule: a `cron` expression, an `everyMs` heartbeat, or a one-shot `at` timestamp. It invokes a skill on a prompt, like `run_skill`.',
+    description: 'Persist work to run later or on a schedule: a `cron` expression, an `everyMs` heartbeat, or a one-shot `at` timestamp. It invokes a skill on a prompt (like `run_skill`) via a sub-agent.',
     parameters: {
         type: 'object',
         properties: {

package/esm/harness/npm/src/session/agent-session.js

@@ -72,6 +72,7 @@ export const createAgentSession = (config) => {
     };
     return {
         id,
+        tools,
         get messages() {
             return messages;
         },

package/esm/harness/npm/src/session/manager.js

@@ -9,6 +9,9 @@ const onFirstMessage = (session, fire) => {
         get messages() {
             return session.messages;
         },
+        get tools() {
+            return session.tools;
+        },
         send: async (input) => {
             if (pending) {
                 pending = false;

package/esm/harness/npm/src/session/persist.js

@@ -7,6 +7,9 @@ export const persistTo = (store, session, persisted = 0) => {
         get messages() {
             return session.messages;
         },
+        get tools() {
+            return session.tools;
+        },
         send: async (input) => {
             await session.send(input);
             const all = session.messages;

package/esm/harness/npm/src/session/types.d.ts

@@ -1,4 +1,4 @@
-import type { ContentPart, LoopEvent, Message } from 'mu-core';
+import type { ContentPart, LoopEvent, Message, Tool } from 'mu-core';
 export type AgentSessionEvent = {
     type: 'turn_start';
     input: Message;
@@ -11,6 +11,7 @@ export type AgentSessionEvent = {
 export interface AgentSession {
     readonly id: string;
     readonly messages: readonly Message[];
+    readonly tools: readonly Tool[];
     send(input: string | ContentPart[]): Promise<void>;
     abort(): void;
     subscribe(listener: (event: AgentSessionEvent) => void): () => void;

package/esm/harness/npm/src/skills/run.js

@@ -18,8 +18,7 @@ export const runSkill = async (deps, args) => {
 };
 export const createRunSkillTool = (deps) => ({
     name: 'run_skill',
-    description: 'Invoke a sub-agent equipped with a named skill to carry out a specific task. Returns its final answer.',
-    prompt: 'To carry out a self-contained task under a skill, call `run_skill` with the skill name, the task, and the agent persona to run it as.',
+    description: 'Invoke a sub-agent equipped with a named skill to carry out a self-contained task — pass the skill name, the task, and the agent persona to run it as. Returns its final answer.',
     parameters: {
         type: 'object',
         properties: {

package/esm/harness/npm/src/skills/tool.js

@@ -1,12 +1,12 @@
 export const createSkillTool = (registry) => ({
     name: 'skill',
-    description: "Load a named skill's instructions into the conversation, then follow them.",
-    get prompt() {
+    get description() {
+        const base = "Load a named skill's instructions into the conversation, then follow them.";
         const list = registry.list();
         if (!list.length)
-            return undefined;
+            return base;
         const catalog = list.map((skill) => `- ${skill.name}${skill.description ? `: ${skill.description}` : ''}`).join('\n');
-        return `When a request matches one of these skills, call \`skill\` with its name BEFORE acting, then follow the returned instructions:\n${catalog}`;
+        return `${base} When a request matches one of these skills, call \`skill\` with its name BEFORE acting:\n${catalog}`;
     },
     parameters: {
         type: 'object',

package/esm/harness/npm/src/skills/writer.js

@@ -4,8 +4,7 @@ import { parseSkill } from './parser.js';
 const slug = (name) => name.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
 export const createSkillWriterTool = (deps) => ({
     name: 'create_skill',
-    description: 'Create a reusable skill: a named set of instructions the agent can load on demand later.',
-    prompt: 'When you discover a reusable workflow worth keeping, capture it with `create_skill` (name, description, instructions). Use `scope: "local"` for a skill specific to this project, or `scope: "config"` to make it available across all projects. It can then be loaded via `skill`.',
+    description: 'Create a reusable skill (name, description, instructions) the agent can load on demand later — capture a reusable workflow worth keeping. `scope: "local"` saves it to this project, `scope: "config"` makes it available across all projects; load it later via `skill`.',
     parameters: {
         type: 'object',
         properties: {

package/esm/harness/npm/src/subAgents/tool.js

@@ -1,5 +1,5 @@
 import { runSubAgent } from './runner.js';
-const BASE_PROMPT = 'Delegate self-contained research or sub-tasks to a named sub-agent with `subagent`; treat its answer as research input.';
+const BASE_PROMPT = 'Delegate isolated, fully-specifiable tasks to named sub-agents instead of doing them inline; each returns only its final answer. List several tasks in one call to run them concurrently — put all independent work in a single call rather than one at a time. Brief each sub-agent from scratch, then verify its answer before relying on it.';
 export const createSubAgentTool = (deps) => {
     const roster = deps.registry.list()
         .filter((agent) => agent.name !== 'title')
@@ -7,31 +7,58 @@ export const createSubAgentTool = (deps) => {
         .join('\n');
     return {
         name: 'subagent',
-        description: 'Delegate an isolated task to a named sub-agent. Returns its final answer.',
-        prompt: roster ? `${BASE_PROMPT}\n\nAvailable sub-agents:\n${roster}` : BASE_PROMPT,
+        description: roster ? `${BASE_PROMPT}\n\nAvailable sub-agents:\n${roster}` : BASE_PROMPT,
         parameters: {
             type: 'object',
             properties: {
-                agent: { type: 'string', description: 'Sub-agent name.' },
-                task: { type: 'string', description: 'The task to delegate.' },
+                tasks: {
+                    type: 'array',
+                    description: 'One or more tasks to delegate; multiple entries run in parallel.',
+                    minItems: 1,
+                    items: {
+                        type: 'object',
+                        properties: {
+                            agent: { type: 'string', description: 'Sub-agent name.' },
+                            task: { type: 'string', description: 'The task to delegate.' },
+                        },
+                        required: ['agent', 'task'],
+                        additionalProperties: false,
+                    },
+                },
             },
-            required: ['agent', 'task'],
+            required: ['tasks'],
             additionalProperties: false,
         },
         run: async (input, ctx) => {
-            const { agent, task } = (input ?? {});
-            if (!agent || !task)
-                return [{ type: 'text', text: 'Error: subagent requires `agent` and `task`.' }];
-            const def = deps.registry.get(agent);
-            if (!def)
-                return [{ type: 'text', text: `Error: unknown sub-agent "${agent}".` }];
-            const result = await runSubAgent(def, task, {
-                spawn: deps.spawn,
-                runs: deps.runs,
-                parentId: deps.parentId,
-                signal: ctx.signal,
-            });
-            return [{ type: 'text', text: result.text }];
+            const { tasks } = (input ?? {});
+            if (!Array.isArray(tasks) || tasks.length === 0) {
+                return [{ type: 'text', text: 'Error: subagent requires a non-empty `tasks` array.' }];
+            }
+            const results = await Promise.all(tasks.map(({ agent, task }) => runOne(agent, task, deps, ctx.signal)));
+            const labeled = results.length > 1;
+            return results.map(({ agent, text }) => ({
+                type: 'text',
+                text: labeled ? `[${agent ?? 'unknown'}]\n${text}` : text,
+            }));
         },
     };
 };
+const runOne = async (agent, task, deps, signal) => {
+    if (!agent || !task)
+        return { agent, text: 'Error: each task requires `agent` and `task`.' };
+    const def = deps.registry.get(agent);
+    if (!def)
+        return { agent, text: `Error: unknown sub-agent "${agent}".` };
+    try {
+        const result = await runSubAgent(def, task, {
+            spawn: deps.spawn,
+            runs: deps.runs,
+            parentId: deps.parentId,
+            signal,
+        });
+        return { agent, text: result.text };
+    }
+    catch (err) {
+        return { agent, text: `Error: ${err instanceof Error ? err.message : String(err)}` };
+    }
+};

package/esm/tui/src/components/scroll-view.d.ts

@@ -1,14 +1,26 @@
 import type { InputEvent } from '../events';
 import type { Component, Surface } from '../surface';
+export interface ScrollViewOptions {
+    wheelStep?: number;
+    stickyHeader?: (info: {
+        scrollY: number;
+        width: number;
+    }) => Component | undefined;
+    footer?: () => Component | undefined;
+}
 export declare class ScrollView implements Component {
     private content;
     private scrollY;
     private stick;
-    constructor(content: Component);
+    private readonly wheelStep;
+    private readonly stickyHeader?;
+    private readonly footer?;
+    constructor(content: Component, opts?: ScrollViewOptions);
+    atBottom(): boolean;
     setContent(content: Component): void;
     scrollToBottom(): void;
     render(s: Surface): void;
     handleInput(event: InputEvent): void;
     private scrollBy;
 }
-export declare const scrollView: (content: Component) => ScrollView;
+export declare const scrollView: (content: Component, opts?: ScrollViewOptions) => ScrollView;

package/esm/tui/src/components/scroll-view.js

@@ -2,8 +2,17 @@ export class ScrollView {
     content;
     scrollY = 0;
     stick = true;
-    constructor(content) {
+    wheelStep;
+    stickyHeader;
+    footer;
+    constructor(content, opts = {}) {
         this.content = content;
+        this.wheelStep = Math.max(1, opts.wheelStep ?? 3);
+        this.stickyHeader = opts.stickyHeader;
+        this.footer = opts.footer;
+    }
+    atBottom() {
+        return this.stick;
     }
     setContent(content) {
         this.content = content;
@@ -21,13 +30,29 @@ export class ScrollView {
         }
         const scroll = Number.isFinite(s.height) ? this.scrollY : 0;
         s.child(this.content, { x: 0, y: -scroll, width: s.width, height: contentHeight });
+        if (this.stickyHeader && Number.isFinite(s.height) && !this.stick) {
+            const header = this.stickyHeader({ scrollY: this.scrollY, width: s.width });
+            if (header) {
+                const h = Math.min(s.measure(header, s.width), s.height);
+                if (h > 0)
+                    s.child(header, { x: 0, y: 0, width: s.width, height: h });
+            }
+        }
+        if (this.footer && Number.isFinite(s.height) && !this.stick) {
+            const footer = this.footer();
+            if (footer) {
+                const h = Math.min(s.measure(footer, s.width), s.height);
+                if (h > 0)
+                    s.child(footer, { x: 0, y: s.height - h, width: s.width, height: h });
+            }
+        }
     }
     handleInput(event) {
         if (event.type === 'mouse' && event.kind === 'wheel') {
             if (event.button === 'wheelUp')
-                this.scrollBy(-1);
+                this.scrollBy(-this.wheelStep);
             else if (event.button === 'wheelDown')
-                this.scrollBy(1);
+                this.scrollBy(this.wheelStep);
             return;
         }
         if (event.type !== 'key' || event.kind === 'release')
@@ -42,4 +67,4 @@ export class ScrollView {
         this.scrollY = Math.max(0, this.scrollY + delta);
     }
 }
-export const scrollView = (content) => new ScrollView(content);
+export const scrollView = (content, opts) => new ScrollView(content, opts);

package/esm/tui/src/components/select-list.d.ts

@@ -17,7 +17,7 @@ export declare class SelectList<T> implements Component {
     selectedItem(): SelectItem<T> | undefined;
     move(delta: number): void;
     render(s: Surface): void;
-    handleInput(event: InputEvent): void;
+    handleInput(event: InputEvent): boolean | void;
 }
 export declare const selectList: <T>(items?: SelectItem<T>[], opts?: {
     maxRows?: number;

package/esm/tui/src/components/select-list.js

@@ -45,13 +45,15 @@ export class SelectList {
         }
     }
     handleInput(event) {
-        if (event.type === 'mouse' && event.kind === 'press' && event.button === 'left') {
+        if (event.type === 'mouse') {
+            if (event.kind !== 'press' || event.button !== 'left')
+                return false;
             const index = this.top + (event.localY ?? 0);
             if (index >= 0 && index < this.items.length) {
                 this.selected = index;
                 this.onSelect?.(this.items[index]);
             }
-            return;
+            return true;
         }
         if (event.type !== 'key' || event.kind === 'release')
             return;

package/esm/tui/src/index.d.ts

@@ -2,7 +2,7 @@ export type { Component, Surface, SurfaceEntry } from './surface';
 export { measure, measureWidth, renderToBuffer } from './surface';
 export { box, type BoxOptions, column, flex, type FlexItem, modal, type ModalOptions, overlay, type OverlayOptions, row, text, toast, type ToastKind, type ToastOptions, } from './views';
 export { Editor, editor, type EditorOptions } from './components/editor';
-export { ScrollView, scrollView } from './components/scroll-view';
+export { ScrollView, type ScrollViewOptions, scrollView } from './components/scroll-view';
 export { type SelectItem, SelectList, selectList } from './components/select-list';
 export { type Command, CommandPalette, commandPalette, type CommandPaletteOptions } from './components/command-palette';
 export { type LayerHandle, type ToastHandle, TUI, type TuiOptions } from './tui';

package/esm/tui/src/inputRouter.js

@@ -98,7 +98,13 @@ export class InputRouter {
                 continue;
             if (!containsPoint(entry.rect, event.x, event.y))
                 continue;
-            entry.component.handleInput({ ...event, localX: event.x - entry.rect.x, localY: event.y - entry.rect.y });
+            const handled = entry.component.handleInput({
+                ...event,
+                localX: event.x - entry.rect.x,
+                localY: event.y - entry.rect.y,
+            });
+            if (handled === false)
+                continue;
             this.host.requestRender();
             return;
         }

package/esm/tui/src/keyboard.js

@@ -257,6 +257,20 @@ function codepointToKey(code) {
         13: 'enter',
         27: 'escape',
         127: 'backspace',
+        57344: 'escape',
+        57345: 'enter',
+        57346: 'tab',
+        57347: 'backspace',
+        57348: 'insert',
+        57349: 'delete',
+        57350: 'left',
+        57351: 'right',
+        57352: 'up',
+        57353: 'down',
+        57354: 'pageUp',
+        57355: 'pageDown',
+        57356: 'home',
+        57357: 'end',
     };
     return named[code] ?? codepointToText(code) ?? `unknown:${code}`;
 }

package/esm/tui/src/surface.d.ts

@@ -3,7 +3,7 @@ import { type CellBuffer } from './layout/cellbuffer';
 import type { Color, Rect } from './layout/types';
 export interface Component {
     render(surface: Surface): void;
-    handleInput?(event: InputEvent): void;
+    handleInput?(event: InputEvent): boolean | void;
     wantsKeyRelease?: boolean;
 }
 export interface Surface {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mu-harness",
-  "version": "0.16.8",
+  "version": "0.16.11",
   "description": "Agent harness: createHarness wires mu-core into a host — XDG paths, model registry, plugins, disk-loaded agents & skills, sub-agents, sessions (JSONL + SQLite catalog), slash commands, permission/approval hooks, an optional scheduler, and a composable TUI chat app",
   "license": "MIT",
   "main": "./script/index.js",
@@ -16,8 +16,8 @@
   "dependencies": {
     "@swc/wasm-typescript": "^1.15.0",
     "croner": "^9.0.0",
-    "mu-core": "^0.16.8",
-    "mu-tui": "^0.16.8"
+    "mu-core": "^0.16.11",
+    "mu-tui": "^0.16.11"
   },
   "_generatedBy": "dnt@dev"
 }

package/script/harness/npm/src/scheduler/tool.js

@@ -13,8 +13,7 @@ const toSchedule = (raw) => {
 };
 const createScheduleTaskTool = (deps) => ({
     name: 'schedule_task',
-    description: 'Persist a recurring (cron / heartbeat) or one-shot task that runs a sub-agent under a skill on a given prompt.',
-    prompt: 'Use `schedule_task` to register work that should run later or on a schedule: a `cron` expression, an `everyMs` heartbeat, or a one-shot `at` timestamp. It invokes a skill on a prompt, like `run_skill`.',
+    description: 'Persist work to run later or on a schedule: a `cron` expression, an `everyMs` heartbeat, or a one-shot `at` timestamp. It invokes a skill on a prompt (like `run_skill`) via a sub-agent.',
     parameters: {
         type: 'object',
         properties: {

package/script/harness/npm/src/session/agent-session.js

@@ -75,6 +75,7 @@ const createAgentSession = (config) => {
     };
     return {
         id,
+        tools,
         get messages() {
             return messages;
         },

package/script/harness/npm/src/session/manager.js

@@ -12,6 +12,9 @@ const onFirstMessage = (session, fire) => {
         get messages() {
             return session.messages;
         },
+        get tools() {
+            return session.tools;
+        },
         send: async (input) => {
             if (pending) {
                 pending = false;

package/script/harness/npm/src/session/persist.js

@@ -10,6 +10,9 @@ const persistTo = (store, session, persisted = 0) => {
         get messages() {
             return session.messages;
         },
+        get tools() {
+            return session.tools;
+        },
         send: async (input) => {
             await session.send(input);
             const all = session.messages;

package/script/harness/npm/src/session/types.d.ts

@@ -1,4 +1,4 @@
-import type { ContentPart, LoopEvent, Message } from 'mu-core';
+import type { ContentPart, LoopEvent, Message, Tool } from 'mu-core';
 export type AgentSessionEvent = {
     type: 'turn_start';
     input: Message;
@@ -11,6 +11,7 @@ export type AgentSessionEvent = {
 export interface AgentSession {
     readonly id: string;
     readonly messages: readonly Message[];
+    readonly tools: readonly Tool[];
     send(input: string | ContentPart[]): Promise<void>;
     abort(): void;
     subscribe(listener: (event: AgentSessionEvent) => void): () => void;

package/script/harness/npm/src/skills/run.js

@@ -22,8 +22,7 @@ const runSkill = async (deps, args) => {
 exports.runSkill = runSkill;
 const createRunSkillTool = (deps) => ({
     name: 'run_skill',
-    description: 'Invoke a sub-agent equipped with a named skill to carry out a specific task. Returns its final answer.',
-    prompt: 'To carry out a self-contained task under a skill, call `run_skill` with the skill name, the task, and the agent persona to run it as.',
+    description: 'Invoke a sub-agent equipped with a named skill to carry out a self-contained task — pass the skill name, the task, and the agent persona to run it as. Returns its final answer.',
     parameters: {
         type: 'object',
         properties: {

package/script/harness/npm/src/skills/tool.js

@@ -3,13 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSkillTool = void 0;
 const createSkillTool = (registry) => ({
     name: 'skill',
-    description: "Load a named skill's instructions into the conversation, then follow them.",
-    get prompt() {
+    get description() {
+        const base = "Load a named skill's instructions into the conversation, then follow them.";
         const list = registry.list();
         if (!list.length)
-            return undefined;
+            return base;
         const catalog = list.map((skill) => `- ${skill.name}${skill.description ? `: ${skill.description}` : ''}`).join('\n');
-        return `When a request matches one of these skills, call \`skill\` with its name BEFORE acting, then follow the returned instructions:\n${catalog}`;
+        return `${base} When a request matches one of these skills, call \`skill\` with its name BEFORE acting:\n${catalog}`;
     },
     parameters: {
         type: 'object',

package/script/harness/npm/src/skills/writer.js

@@ -7,8 +7,7 @@ const parser_js_1 = require("./parser.js");
 const slug = (name) => name.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
 const createSkillWriterTool = (deps) => ({
     name: 'create_skill',
-    description: 'Create a reusable skill: a named set of instructions the agent can load on demand later.',
-    prompt: 'When you discover a reusable workflow worth keeping, capture it with `create_skill` (name, description, instructions). Use `scope: "local"` for a skill specific to this project, or `scope: "config"` to make it available across all projects. It can then be loaded via `skill`.',
+    description: 'Create a reusable skill (name, description, instructions) the agent can load on demand later — capture a reusable workflow worth keeping. `scope: "local"` saves it to this project, `scope: "config"` makes it available across all projects; load it later via `skill`.',
     parameters: {
         type: 'object',
         properties: {

package/script/harness/npm/src/subAgents/tool.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSubAgentTool = void 0;
 const runner_js_1 = require("./runner.js");
-const BASE_PROMPT = 'Delegate self-contained research or sub-tasks to a named sub-agent with `subagent`; treat its answer as research input.';
+const BASE_PROMPT = 'Delegate isolated, fully-specifiable tasks to named sub-agents instead of doing them inline; each returns only its final answer. List several tasks in one call to run them concurrently — put all independent work in a single call rather than one at a time. Brief each sub-agent from scratch, then verify its answer before relying on it.';
 const createSubAgentTool = (deps) => {
     const roster = deps.registry.list()
         .filter((agent) => agent.name !== 'title')
@@ -10,32 +10,59 @@ const createSubAgentTool = (deps) => {
         .join('\n');
     return {
         name: 'subagent',
-        description: 'Delegate an isolated task to a named sub-agent. Returns its final answer.',
-        prompt: roster ? `${BASE_PROMPT}\n\nAvailable sub-agents:\n${roster}` : BASE_PROMPT,
+        description: roster ? `${BASE_PROMPT}\n\nAvailable sub-agents:\n${roster}` : BASE_PROMPT,
         parameters: {
             type: 'object',
             properties: {
-                agent: { type: 'string', description: 'Sub-agent name.' },
-                task: { type: 'string', description: 'The task to delegate.' },
+                tasks: {
+                    type: 'array',
+                    description: 'One or more tasks to delegate; multiple entries run in parallel.',
+                    minItems: 1,
+                    items: {
+                        type: 'object',
+                        properties: {
+                            agent: { type: 'string', description: 'Sub-agent name.' },
+                            task: { type: 'string', description: 'The task to delegate.' },
+                        },
+                        required: ['agent', 'task'],
+                        additionalProperties: false,
+                    },
+                },
             },
-            required: ['agent', 'task'],
+            required: ['tasks'],
             additionalProperties: false,
         },
         run: async (input, ctx) => {
-            const { agent, task } = (input ?? {});
-            if (!agent || !task)
-                return [{ type: 'text', text: 'Error: subagent requires `agent` and `task`.' }];
-            const def = deps.registry.get(agent);
-            if (!def)
-                return [{ type: 'text', text: `Error: unknown sub-agent "${agent}".` }];
-            const result = await (0, runner_js_1.runSubAgent)(def, task, {
-                spawn: deps.spawn,
-                runs: deps.runs,
-                parentId: deps.parentId,
-                signal: ctx.signal,
-            });
-            return [{ type: 'text', text: result.text }];
+            const { tasks } = (input ?? {});
+            if (!Array.isArray(tasks) || tasks.length === 0) {
+                return [{ type: 'text', text: 'Error: subagent requires a non-empty `tasks` array.' }];
+            }
+            const results = await Promise.all(tasks.map(({ agent, task }) => runOne(agent, task, deps, ctx.signal)));
+            const labeled = results.length > 1;
+            return results.map(({ agent, text }) => ({
+                type: 'text',
+                text: labeled ? `[${agent ?? 'unknown'}]\n${text}` : text,
+            }));
         },
     };
 };
 exports.createSubAgentTool = createSubAgentTool;
+const runOne = async (agent, task, deps, signal) => {
+    if (!agent || !task)
+        return { agent, text: 'Error: each task requires `agent` and `task`.' };
+    const def = deps.registry.get(agent);
+    if (!def)
+        return { agent, text: `Error: unknown sub-agent "${agent}".` };
+    try {
+        const result = await (0, runner_js_1.runSubAgent)(def, task, {
+            spawn: deps.spawn,
+            runs: deps.runs,
+            parentId: deps.parentId,
+            signal,
+        });
+        return { agent, text: result.text };
+    }
+    catch (err) {
+        return { agent, text: `Error: ${err instanceof Error ? err.message : String(err)}` };
+    }
+};

package/script/tui/src/components/scroll-view.d.ts

@@ -1,14 +1,26 @@
 import type { InputEvent } from '../events';
 import type { Component, Surface } from '../surface';
+export interface ScrollViewOptions {
+    wheelStep?: number;
+    stickyHeader?: (info: {
+        scrollY: number;
+        width: number;
+    }) => Component | undefined;
+    footer?: () => Component | undefined;
+}
 export declare class ScrollView implements Component {
     private content;
     private scrollY;
     private stick;
-    constructor(content: Component);
+    private readonly wheelStep;
+    private readonly stickyHeader?;
+    private readonly footer?;
+    constructor(content: Component, opts?: ScrollViewOptions);
+    atBottom(): boolean;
     setContent(content: Component): void;
     scrollToBottom(): void;
     render(s: Surface): void;
     handleInput(event: InputEvent): void;
     private scrollBy;
 }
-export declare const scrollView: (content: Component) => ScrollView;
+export declare const scrollView: (content: Component, opts?: ScrollViewOptions) => ScrollView;

package/script/tui/src/components/scroll-view.js

@@ -5,8 +5,17 @@ class ScrollView {
     content;
     scrollY = 0;
     stick = true;
-    constructor(content) {
+    wheelStep;
+    stickyHeader;
+    footer;
+    constructor(content, opts = {}) {
         this.content = content;
+        this.wheelStep = Math.max(1, opts.wheelStep ?? 3);
+        this.stickyHeader = opts.stickyHeader;
+        this.footer = opts.footer;
+    }
+    atBottom() {
+        return this.stick;
     }
     setContent(content) {
         this.content = content;
@@ -24,13 +33,29 @@ class ScrollView {
         }
         const scroll = Number.isFinite(s.height) ? this.scrollY : 0;
         s.child(this.content, { x: 0, y: -scroll, width: s.width, height: contentHeight });
+        if (this.stickyHeader && Number.isFinite(s.height) && !this.stick) {
+            const header = this.stickyHeader({ scrollY: this.scrollY, width: s.width });
+            if (header) {
+                const h = Math.min(s.measure(header, s.width), s.height);
+                if (h > 0)
+                    s.child(header, { x: 0, y: 0, width: s.width, height: h });
+            }
+        }
+        if (this.footer && Number.isFinite(s.height) && !this.stick) {
+            const footer = this.footer();
+            if (footer) {
+                const h = Math.min(s.measure(footer, s.width), s.height);
+                if (h > 0)
+                    s.child(footer, { x: 0, y: s.height - h, width: s.width, height: h });
+            }
+        }
     }
     handleInput(event) {
         if (event.type === 'mouse' && event.kind === 'wheel') {
             if (event.button === 'wheelUp')
-                this.scrollBy(-1);
+                this.scrollBy(-this.wheelStep);
             else if (event.button === 'wheelDown')
-                this.scrollBy(1);
+                this.scrollBy(this.wheelStep);
             return;
         }
         if (event.type !== 'key' || event.kind === 'release')
@@ -46,5 +71,5 @@ class ScrollView {
     }
 }
 exports.ScrollView = ScrollView;
-const scrollView = (content) => new ScrollView(content);
+const scrollView = (content, opts) => new ScrollView(content, opts);
 exports.scrollView = scrollView;

package/script/tui/src/components/select-list.d.ts

@@ -17,7 +17,7 @@ export declare class SelectList<T> implements Component {
     selectedItem(): SelectItem<T> | undefined;
     move(delta: number): void;
     render(s: Surface): void;
-    handleInput(event: InputEvent): void;
+    handleInput(event: InputEvent): boolean | void;
 }
 export declare const selectList: <T>(items?: SelectItem<T>[], opts?: {
     maxRows?: number;

package/script/tui/src/components/select-list.js

@@ -48,13 +48,15 @@ class SelectList {
         }
     }
     handleInput(event) {
-        if (event.type === 'mouse' && event.kind === 'press' && event.button === 'left') {
+        if (event.type === 'mouse') {
+            if (event.kind !== 'press' || event.button !== 'left')
+                return false;
             const index = this.top + (event.localY ?? 0);
             if (index >= 0 && index < this.items.length) {
                 this.selected = index;
                 this.onSelect?.(this.items[index]);
             }
-            return;
+            return true;
         }
         if (event.type !== 'key' || event.kind === 'release')
             return;

package/script/tui/src/index.d.ts

@@ -2,7 +2,7 @@ export type { Component, Surface, SurfaceEntry } from './surface';
 export { measure, measureWidth, renderToBuffer } from './surface';
 export { box, type BoxOptions, column, flex, type FlexItem, modal, type ModalOptions, overlay, type OverlayOptions, row, text, toast, type ToastKind, type ToastOptions, } from './views';
 export { Editor, editor, type EditorOptions } from './components/editor';
-export { ScrollView, scrollView } from './components/scroll-view';
+export { ScrollView, type ScrollViewOptions, scrollView } from './components/scroll-view';
 export { type SelectItem, SelectList, selectList } from './components/select-list';
 export { type Command, CommandPalette, commandPalette, type CommandPaletteOptions } from './components/command-palette';
 export { type LayerHandle, type ToastHandle, TUI, type TuiOptions } from './tui';

package/script/tui/src/inputRouter.js

@@ -101,7 +101,13 @@ class InputRouter {
                 continue;
             if (!(0, insets_1.containsPoint)(entry.rect, event.x, event.y))
                 continue;
-            entry.component.handleInput({ ...event, localX: event.x - entry.rect.x, localY: event.y - entry.rect.y });
+            const handled = entry.component.handleInput({
+                ...event,
+                localX: event.x - entry.rect.x,
+                localY: event.y - entry.rect.y,
+            });
+            if (handled === false)
+                continue;
             this.host.requestRender();
             return;
         }

package/script/tui/src/keyboard.js

@@ -260,6 +260,20 @@ function codepointToKey(code) {
         13: 'enter',
         27: 'escape',
         127: 'backspace',
+        57344: 'escape',
+        57345: 'enter',
+        57346: 'tab',
+        57347: 'backspace',
+        57348: 'insert',
+        57349: 'delete',
+        57350: 'left',
+        57351: 'right',
+        57352: 'up',
+        57353: 'down',
+        57354: 'pageUp',
+        57355: 'pageDown',
+        57356: 'home',
+        57357: 'end',
     };
     return named[code] ?? codepointToText(code) ?? `unknown:${code}`;
 }

package/script/tui/src/surface.d.ts

@@ -3,7 +3,7 @@ import { type CellBuffer } from './layout/cellbuffer';
 import type { Color, Rect } from './layout/types';
 export interface Component {
     render(surface: Surface): void;
-    handleInput?(event: InputEvent): void;
+    handleInput?(event: InputEvent): boolean | void;
     wantsKeyRelease?: boolean;
 }
 export interface Surface {