mu-harness 0.16.9 → 0.16.12

package/esm/harness/npm/src/agents/index.d.ts

@@ -1,4 +1,4 @@
-export type { Agent, ToolDecision, ToolGrants } from './types.js';
-export { type AgentRegistry, createAgentRegistry, toolDecision, toolNames } from './registry.js';
+export type { Agent, GrantValue, ToolDecision, ToolGrants } from './types.js';
+export { type AgentRegistry, createAgentRegistry, grantArg, toolDecision, toolNames } from './registry.js';
 export { parseAgent } from './parser.js';
 export { loadAgents } from './loader.js';

package/esm/harness/npm/src/agents/index.js

@@ -1,3 +1,3 @@
-export { createAgentRegistry, toolDecision, toolNames } from './registry.js';
+export { createAgentRegistry, grantArg, toolDecision, toolNames } from './registry.js';
 export { parseAgent } from './parser.js';
 export { loadAgents } from './loader.js';

package/esm/harness/npm/src/agents/parser.js

@@ -1,9 +1,17 @@
 import { parseFrontmatter, str } from '../common/index.js';
 const DECISIONS = new Set(['allow', 'ask', 'deny']);
+const isDecision = (value) => typeof value === 'string' && DECISIONS.has(value);
 const parseStringList = (raw) => (Array.isArray(raw) ? raw : raw.split(','))
     .filter((entry) => typeof entry === 'string')
     .map((entry) => entry.trim())
     .filter(Boolean);
+const parseDecisionMap = (raw) => {
+    const out = {};
+    for (const [key, value] of Object.entries(raw))
+        if (isDecision(value))
+            out[key] = value;
+    return Object.keys(out).length > 0 ? out : undefined;
+};
 const parseTools = (raw) => {
     if (Array.isArray(raw) || typeof raw === 'string') {
         const list = parseStringList(raw);
@@ -11,9 +19,14 @@ const parseTools = (raw) => {
     }
     if (raw && typeof raw === 'object') {
         const out = {};
-        for (const [tool, decision] of Object.entries(raw)) {
-            if (typeof decision === 'string' && DECISIONS.has(decision))
-                out[tool] = decision;
+        for (const [tool, value] of Object.entries(raw)) {
+            if (isDecision(value))
+                out[tool] = value;
+            else if (value && typeof value === 'object' && !Array.isArray(value)) {
+                const nested = parseDecisionMap(value);
+                if (nested)
+                    out[tool] = nested;
+            }
         }
         return Object.keys(out).length > 0 ? out : undefined;
     }

package/esm/harness/npm/src/agents/registry.d.ts

@@ -3,6 +3,7 @@ export interface AgentRegistry {
     list(): Agent[];
     get(name: string): Agent | undefined;
 }
-export declare const toolDecision: (agent: Agent, tool: string) => ToolDecision;
+export declare const grantArg: (tool: string, input: unknown) => string | undefined;
+export declare const toolDecision: (agent: Agent, tool: string, arg?: string) => ToolDecision;
 export declare const toolNames: (agent: Agent) => string[] | undefined;
 export declare const createAgentRegistry: (agents?: Agent[]) => AgentRegistry;

package/esm/harness/npm/src/agents/registry.js

@@ -1,24 +1,59 @@
-const asMap = (tools) => {
-    if (!tools)
+import { matchesGlob } from 'node:path';
+const asMap = (grants) => {
+    if (!grants)
         return undefined;
-    if (Array.isArray(tools))
-        return Object.fromEntries(tools.map((tool) => [tool, 'allow']));
-    return tools;
+    if (Array.isArray(grants))
+        return Object.fromEntries(grants.map((name) => [name, 'allow']));
+    return grants;
 };
-export const toolDecision = (agent, tool) => {
-    const map = asMap(agent.tools);
+const matchKey = (keys, name) => {
+    if (keys.includes(name))
+        return name;
+    let glob;
+    for (const key of keys) {
+        if (key === '*' || key === name)
+            continue;
+        if (matchesGlob(name, key) && (glob === undefined || key.length > glob.length))
+            glob = key;
+    }
+    if (glob !== undefined)
+        return glob;
+    return keys.includes('*') ? '*' : undefined;
+};
+const resolveGrant = (grants, tool, arg) => {
+    const map = asMap(grants);
     if (!map)
         return 'allow';
-    return map[tool] ?? map['*'] ?? 'deny';
+    const key = matchKey(Object.keys(map), tool);
+    if (key === undefined)
+        return 'deny';
+    const value = map[key];
+    if (typeof value === 'string')
+        return value;
+    if (arg === undefined)
+        return 'allow';
+    const inner = matchKey(Object.keys(value), arg);
+    return inner === undefined ? 'deny' : value[inner];
 };
-export const toolNames = (agent) => {
-    const map = asMap(agent.tools);
+const grantNames = (grants) => {
+    const map = asMap(grants);
     if (!map)
         return undefined;
-    if (map['*'] && map['*'] !== 'deny')
+    const wildcard = map['*'];
+    if (wildcard !== undefined && wildcard !== 'deny')
         return ['*'];
-    return Object.entries(map).filter(([, decision]) => decision !== 'deny').map(([tool]) => tool);
+    return Object.entries(map).filter(([, value]) => value !== 'deny').map(([name]) => name);
+};
+const GRANT_ARG = { skill: 'name', bash: 'command' };
+export const grantArg = (tool, input) => {
+    const field = GRANT_ARG[tool];
+    if (!field || typeof input !== 'object' || input === null)
+        return undefined;
+    const value = input[field];
+    return typeof value === 'string' ? value : undefined;
 };
+export const toolDecision = (agent, tool, arg) => resolveGrant(agent.tools, tool, arg);
+export const toolNames = (agent) => grantNames(agent.tools);
 const merge = (base, child) => ({
     name: child.name,
     description: child.description || base.description,

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

@@ -1,5 +1,6 @@
 export type ToolDecision = 'allow' | 'ask' | 'deny';
-export type ToolGrants = string[] | Record<string, ToolDecision>;
+export type GrantValue = ToolDecision | Record<string, ToolDecision>;
+export type ToolGrants = string[] | Record<string, GrantValue>;
 export interface Agent {
     name: string;
     description: string;

package/esm/harness/npm/src/harness/create.js

@@ -1,6 +1,6 @@
 import { join } from 'node:path';
 import process from 'node:process';
-import { createAgentRegistry, loadAgents, toolDecision, toolNames } from '../agents/index.js';
+import { createAgentRegistry, grantArg, loadAgents, toolDecision, toolNames } from '../agents/index.js';
 import { createAgentsCommand, createCommandRegistry, createHelpCommand, createSessionsCommand, createSkillsCommand, } from '../commands/index.js';
 import { createHarnessConfig } from '../config/index.js';
 import { mergeHooks } from '../hooks/index.js';
@@ -33,22 +33,35 @@ export const createHarness = async (options) => {
     const cwdSkills = await loadSkills(cwdSkillsDir);
     const diskSkills = await loadSkills(skillsDir);
     const skills = createSkillRegistry([...hostSkills, ...pluginSkills, ...cwdSkills, ...diskSkills]);
-    const skillTools = [
-        createSkillTool(skills),
-        createSkillWriterTool({ dirs: { local: cwdSkillsDir, config: skillsDir }, registry: skills }),
-    ];
+    const skillWriterTool = createSkillWriterTool({
+        dirs: { local: cwdSkillsDir, config: skillsDir },
+        registry: skills,
+    });
+    const scopeSkills = (agent) => {
+        if (!agent)
+            return skills;
+        return skills.select(skills.list().map((s) => s.name).filter((name) => toolDecision(agent, 'skill', name) !== 'deny'));
+    };
     const tasks = enableScheduler ? createTaskStore({ dir: join(config.configDir, 'tasks') }) : undefined;
     let schedulerTools = [];
     const runs = createSubAgentRegistry();
     const store = createSessionStore({ dir: join(config.dataDir, 'sessions') });
-    const sessionTools = (extra = []) => [...(sessionDefaults.tools ?? []), ...extra, ...skillTools, ...schedulerTools];
+    const sessionTools = (agent, extra = []) => [
+        ...(sessionDefaults.tools ?? []),
+        ...extra,
+        createSkillTool(scopeSkills(agent)),
+        skillWriterTool,
+        ...schedulerTools,
+    ];
     const approvalHook = (getAgent) => approvals
         ? approvals.manager.hooksFor({
             decide: (call) => {
                 const agent = getAgent();
                 if (!agent)
                     return 'allow';
-                return approvals.decide ? approvals.decide(agent, call) : toolDecision(agent, call.name);
+                if (approvals.decide)
+                    return approvals.decide(agent, call);
+                return toolDecision(agent, call.name, grantArg(call.name, call.input));
             },
             agent: () => getAgent()?.name,
         })
@@ -62,7 +75,7 @@ export const createHarness = async (options) => {
         id: newId(),
     });
     const spawn = (agent) => persistTo(store, persona(agent, {
-        tools: sessionTools(),
+        tools: sessionTools(agent),
         hooks: mergeHooks([sessionDefaults.hooks, allowList(toolNames(agent)), approvalHook(() => agent)]),
     }));
     const scheduler = enableScheduler && tasks
@@ -112,7 +125,7 @@ export const createHarness = async (options) => {
         revive: ({ id, model: ref, messages }) => createAgentSession({
             ...sessionDefaults,
             hooks: mergeHooks([sessionDefaults.hooks, approvalHook(() => approvals?.activeAgent())]),
-            tools: sessionTools([createSubAgentTool({ registry: agents, spawn, runs, parentId: id })]),
+            tools: sessionTools(undefined, [createSubAgentTool({ registry: agents, spawn, runs, parentId: id })]),
             ...models.resolve(ref),
             id,
             messages,

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.12",
   "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.12",
+    "mu-tui": "^0.16.12"
   },
   "_generatedBy": "dnt@dev"
 }

package/script/harness/npm/src/agents/index.d.ts

@@ -1,4 +1,4 @@
-export type { Agent, ToolDecision, ToolGrants } from './types.js';
-export { type AgentRegistry, createAgentRegistry, toolDecision, toolNames } from './registry.js';
+export type { Agent, GrantValue, ToolDecision, ToolGrants } from './types.js';
+export { type AgentRegistry, createAgentRegistry, grantArg, toolDecision, toolNames } from './registry.js';
 export { parseAgent } from './parser.js';
 export { loadAgents } from './loader.js';

package/script/harness/npm/src/agents/index.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadAgents = exports.parseAgent = exports.toolNames = exports.toolDecision = exports.createAgentRegistry = void 0;
+exports.loadAgents = exports.parseAgent = exports.toolNames = exports.toolDecision = exports.grantArg = exports.createAgentRegistry = void 0;
 var registry_js_1 = require("./registry.js");
 Object.defineProperty(exports, "createAgentRegistry", { enumerable: true, get: function () { return registry_js_1.createAgentRegistry; } });
+Object.defineProperty(exports, "grantArg", { enumerable: true, get: function () { return registry_js_1.grantArg; } });
 Object.defineProperty(exports, "toolDecision", { enumerable: true, get: function () { return registry_js_1.toolDecision; } });
 Object.defineProperty(exports, "toolNames", { enumerable: true, get: function () { return registry_js_1.toolNames; } });
 var parser_js_1 = require("./parser.js");

package/script/harness/npm/src/agents/parser.js

@@ -3,10 +3,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseAgent = void 0;
 const index_js_1 = require("../common/index.js");
 const DECISIONS = new Set(['allow', 'ask', 'deny']);
+const isDecision = (value) => typeof value === 'string' && DECISIONS.has(value);
 const parseStringList = (raw) => (Array.isArray(raw) ? raw : raw.split(','))
     .filter((entry) => typeof entry === 'string')
     .map((entry) => entry.trim())
     .filter(Boolean);
+const parseDecisionMap = (raw) => {
+    const out = {};
+    for (const [key, value] of Object.entries(raw))
+        if (isDecision(value))
+            out[key] = value;
+    return Object.keys(out).length > 0 ? out : undefined;
+};
 const parseTools = (raw) => {
     if (Array.isArray(raw) || typeof raw === 'string') {
         const list = parseStringList(raw);
@@ -14,9 +22,14 @@ const parseTools = (raw) => {
     }
     if (raw && typeof raw === 'object') {
         const out = {};
-        for (const [tool, decision] of Object.entries(raw)) {
-            if (typeof decision === 'string' && DECISIONS.has(decision))
-                out[tool] = decision;
+        for (const [tool, value] of Object.entries(raw)) {
+            if (isDecision(value))
+                out[tool] = value;
+            else if (value && typeof value === 'object' && !Array.isArray(value)) {
+                const nested = parseDecisionMap(value);
+                if (nested)
+                    out[tool] = nested;
+            }
         }
         return Object.keys(out).length > 0 ? out : undefined;
     }

package/script/harness/npm/src/agents/registry.d.ts

@@ -3,6 +3,7 @@ export interface AgentRegistry {
     list(): Agent[];
     get(name: string): Agent | undefined;
 }
-export declare const toolDecision: (agent: Agent, tool: string) => ToolDecision;
+export declare const grantArg: (tool: string, input: unknown) => string | undefined;
+export declare const toolDecision: (agent: Agent, tool: string, arg?: string) => ToolDecision;
 export declare const toolNames: (agent: Agent) => string[] | undefined;
 export declare const createAgentRegistry: (agents?: Agent[]) => AgentRegistry;

package/script/harness/npm/src/agents/registry.js

@@ -1,28 +1,64 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createAgentRegistry = exports.toolNames = exports.toolDecision = void 0;
-const asMap = (tools) => {
-    if (!tools)
+exports.createAgentRegistry = exports.toolNames = exports.toolDecision = exports.grantArg = void 0;
+const node_path_1 = require("node:path");
+const asMap = (grants) => {
+    if (!grants)
         return undefined;
-    if (Array.isArray(tools))
-        return Object.fromEntries(tools.map((tool) => [tool, 'allow']));
-    return tools;
+    if (Array.isArray(grants))
+        return Object.fromEntries(grants.map((name) => [name, 'allow']));
+    return grants;
 };
-const toolDecision = (agent, tool) => {
-    const map = asMap(agent.tools);
+const matchKey = (keys, name) => {
+    if (keys.includes(name))
+        return name;
+    let glob;
+    for (const key of keys) {
+        if (key === '*' || key === name)
+            continue;
+        if ((0, node_path_1.matchesGlob)(name, key) && (glob === undefined || key.length > glob.length))
+            glob = key;
+    }
+    if (glob !== undefined)
+        return glob;
+    return keys.includes('*') ? '*' : undefined;
+};
+const resolveGrant = (grants, tool, arg) => {
+    const map = asMap(grants);
     if (!map)
         return 'allow';
-    return map[tool] ?? map['*'] ?? 'deny';
+    const key = matchKey(Object.keys(map), tool);
+    if (key === undefined)
+        return 'deny';
+    const value = map[key];
+    if (typeof value === 'string')
+        return value;
+    if (arg === undefined)
+        return 'allow';
+    const inner = matchKey(Object.keys(value), arg);
+    return inner === undefined ? 'deny' : value[inner];
 };
-exports.toolDecision = toolDecision;
-const toolNames = (agent) => {
-    const map = asMap(agent.tools);
+const grantNames = (grants) => {
+    const map = asMap(grants);
     if (!map)
         return undefined;
-    if (map['*'] && map['*'] !== 'deny')
+    const wildcard = map['*'];
+    if (wildcard !== undefined && wildcard !== 'deny')
         return ['*'];
-    return Object.entries(map).filter(([, decision]) => decision !== 'deny').map(([tool]) => tool);
+    return Object.entries(map).filter(([, value]) => value !== 'deny').map(([name]) => name);
 };
+const GRANT_ARG = { skill: 'name', bash: 'command' };
+const grantArg = (tool, input) => {
+    const field = GRANT_ARG[tool];
+    if (!field || typeof input !== 'object' || input === null)
+        return undefined;
+    const value = input[field];
+    return typeof value === 'string' ? value : undefined;
+};
+exports.grantArg = grantArg;
+const toolDecision = (agent, tool, arg) => resolveGrant(agent.tools, tool, arg);
+exports.toolDecision = toolDecision;
+const toolNames = (agent) => grantNames(agent.tools);
 exports.toolNames = toolNames;
 const merge = (base, child) => ({
     name: child.name,

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

@@ -1,5 +1,6 @@
 export type ToolDecision = 'allow' | 'ask' | 'deny';
-export type ToolGrants = string[] | Record<string, ToolDecision>;
+export type GrantValue = ToolDecision | Record<string, ToolDecision>;
+export type ToolGrants = string[] | Record<string, GrantValue>;
 export interface Agent {
     name: string;
     description: string;

package/script/harness/npm/src/harness/create.js

@@ -39,22 +39,35 @@ const createHarness = async (options) => {
     const cwdSkills = await (0, index_js_9.loadSkills)(cwdSkillsDir);
     const diskSkills = await (0, index_js_9.loadSkills)(skillsDir);
     const skills = (0, index_js_9.createSkillRegistry)([...hostSkills, ...pluginSkills, ...cwdSkills, ...diskSkills]);
-    const skillTools = [
-        (0, index_js_9.createSkillTool)(skills),
-        (0, index_js_9.createSkillWriterTool)({ dirs: { local: cwdSkillsDir, config: skillsDir }, registry: skills }),
-    ];
+    const skillWriterTool = (0, index_js_9.createSkillWriterTool)({
+        dirs: { local: cwdSkillsDir, config: skillsDir },
+        registry: skills,
+    });
+    const scopeSkills = (agent) => {
+        if (!agent)
+            return skills;
+        return skills.select(skills.list().map((s) => s.name).filter((name) => (0, index_js_1.toolDecision)(agent, 'skill', name) !== 'deny'));
+    };
     const tasks = enableScheduler ? (0, index_js_7.createTaskStore)({ dir: (0, node_path_1.join)(config.configDir, 'tasks') }) : undefined;
     let schedulerTools = [];
     const runs = (0, index_js_10.createSubAgentRegistry)();
     const store = (0, index_js_8.createSessionStore)({ dir: (0, node_path_1.join)(config.dataDir, 'sessions') });
-    const sessionTools = (extra = []) => [...(sessionDefaults.tools ?? []), ...extra, ...skillTools, ...schedulerTools];
+    const sessionTools = (agent, extra = []) => [
+        ...(sessionDefaults.tools ?? []),
+        ...extra,
+        (0, index_js_9.createSkillTool)(scopeSkills(agent)),
+        skillWriterTool,
+        ...schedulerTools,
+    ];
     const approvalHook = (getAgent) => approvals
         ? approvals.manager.hooksFor({
             decide: (call) => {
                 const agent = getAgent();
                 if (!agent)
                     return 'allow';
-                return approvals.decide ? approvals.decide(agent, call) : (0, index_js_1.toolDecision)(agent, call.name);
+                if (approvals.decide)
+                    return approvals.decide(agent, call);
+                return (0, index_js_1.toolDecision)(agent, call.name, (0, index_js_1.grantArg)(call.name, call.input));
             },
             agent: () => getAgent()?.name,
         })
@@ -68,7 +81,7 @@ const createHarness = async (options) => {
         id: newId(),
     });
     const spawn = (agent) => (0, index_js_8.persistTo)(store, persona(agent, {
-        tools: sessionTools(),
+        tools: sessionTools(agent),
         hooks: (0, index_js_4.mergeHooks)([sessionDefaults.hooks, (0, index_js_5.allowList)((0, index_js_1.toolNames)(agent)), approvalHook(() => agent)]),
     }));
     const scheduler = enableScheduler && tasks
@@ -118,7 +131,7 @@ const createHarness = async (options) => {
         revive: ({ id, model: ref, messages }) => (0, index_js_8.createAgentSession)({
             ...sessionDefaults,
             hooks: (0, index_js_4.mergeHooks)([sessionDefaults.hooks, approvalHook(() => approvals?.activeAgent())]),
-            tools: sessionTools([(0, index_js_10.createSubAgentTool)({ registry: agents, spawn, runs, parentId: id })]),
+            tools: sessionTools(undefined, [(0, index_js_10.createSubAgentTool)({ registry: agents, spawn, runs, parentId: id })]),
             ...models.resolve(ref),
             id,
             messages,

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 {