mu-harness 0.16.9 → 0.16.11

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

@@ -1,5 +1,5 @@
 import { runSubAgent } from './runner.js';
-const BASE_PROMPT = 'Delegate an isolated, fully-specifiable task to a named sub-agent instead of doing it inline; it returns only its final answer. Pick the matching sub-agent, brief it from scratch, then verify its answer before relying on it.';
+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')
@@ -11,26 +11,54 @@ export const createSubAgentTool = (deps) => {
         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.9",
+  "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.9",
-    "mu-tui": "^0.16.9"
+    "mu-core": "^0.16.11",
+    "mu-tui": "^0.16.11"
   },
   "_generatedBy": "dnt@dev"
 }

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 an isolated, fully-specifiable task to a named sub-agent instead of doing it inline; it returns only its final answer. Pick the matching sub-agent, brief it from scratch, then verify its answer before relying on it.';
+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')
@@ -14,27 +14,55 @@ const createSubAgentTool = (deps) => {
         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 {