@cmodjs/core 0.1.8 → 0.1.10

package/runtime/hooks.js

@@ -1,9 +1,9 @@
 import { configFolders } from '../records.js';
-import { toolInputOf } from './tool-calls.js';
+import { reservedKeys, toolInputOf } from './tool-calls.js';
 import { callEffects } from '../utils/call-effects.js';
 import { dynamicPattern } from '../utils/parse-shell.js';
 import { messageOf } from '../utils/text.js';
-export const permissionEvents = ['tool.check', 'classic.PreToolUse', 'classic.PermissionRequest'];
+export const permissionEvents = ['tool.check', 'classic.PermissionRequest'];
 const flags = ['suppressOriginalPrompt', 'reloadSkills', 'retry'];
 const readFields = {
     SessionStart: ['additionalContext', 'initialUserMessage', 'sessionTitle', 'watchPaths', 'reloadSkills'],
@@ -23,11 +23,10 @@ const readFields = {
     Stop: ['additionalContext'],
     StopFailure: [],
     CwdChanged: [],
+    FileChanged: [],
 };
 export function classicHook(name, event, hook, claude, calls) {
     const inputOf = async (e) => {
-        if (event === 'PreToolUse')
-            return preToolUseInput(name, e, claude, calls.agentOf);
         if (event !== 'PostToolUse' && event !== 'PostToolUseFailure')
             return e;
         const input = e;
@@ -45,8 +44,6 @@ export function classicHook(name, event, hook, claude, calls) {
     const routed = async (e, next) => {
         const ours = await resultOf(e).catch((error) => {
             const reason = `${name}: the ${event} hook failed: ${messageOf(error)}`;
-            if (event === 'PreToolUse')
-                return { deny: reason };
             if (event === 'PermissionRequest')
                 return { decision: { behavior: 'deny', message: reason } };
             claude.ui.log(reason);
@@ -54,10 +51,61 @@ export function classicHook(name, event, hook, claude, calls) {
         });
         if (ours === undefined)
             return next(e);
-        return mergeClassic(event, (await next(e)), ours);
+        return mergeClassic((await next(e)), ours);
     };
     return routed;
 }
+export function preToolUseHook(name, hook, claude, calls, held) {
+    return async (e, next) => {
+        let ours;
+        try {
+            const answer = await hook(await preToolUseInput(name, e, claude, calls.agentOf));
+            if (answer?.systemMessage !== undefined)
+                claude.ui.log(answer.systemMessage);
+            ours = answer === undefined ? {} : classicResult('PreToolUse', answer);
+        }
+        catch (error) {
+            return { deny: `${name}: the PreToolUse hook failed: ${messageOf(error)}` };
+        }
+        if (typeof ours['deny'] === 'string')
+            return { deny: ours['deny'] };
+        const decided = heldDecisionOf(ours);
+        if (decided !== undefined && held === undefined) {
+            return { deny: `${name}: the PreToolUse hook answered permissionDecision "${decided.decision}", so hooks/register.ts must call registerPermissionCheck(addHook) after registerMod.` };
+        }
+        const updated = ours['updatedInput'];
+        const reserved = Object.fromEntries(Object.entries(e).filter(([key]) => reservedKeys.includes(key)));
+        const earlier = held?.get(e.tool_use_id);
+        if (decided !== undefined)
+            held?.set(e.tool_use_id, earlier !== undefined && strictness.indexOf(earlier.decision) >= strictness.indexOf(decided.decision) ? earlier : decided);
+        let result;
+        try {
+            result = await next(updated === undefined ? e : { ...reserved, ...updated });
+        }
+        finally {
+            if (decided !== undefined)
+                held?.delete(e.tool_use_id);
+        }
+        const context = ours['additionalContext'];
+        if (context === undefined || result.deny !== undefined)
+            return result;
+        return { ...result, context: [...(result.context ?? []), ...context] };
+    };
+}
+export function heldDecisionHook(held) {
+    return async (e, next) => {
+        const below = await next(e);
+        const ours = e.tool_use_id === undefined ? undefined : held.get(e.tool_use_id);
+        return ours === undefined || below.decision === 'deny' ? below : ours;
+    };
+}
+function heldDecisionOf(ours) {
+    if (ours['allow'] !== undefined)
+        return { decision: 'allow' };
+    if (typeof ours['ask'] !== 'string')
+        return undefined;
+    return ours['ask'] === '' ? { decision: 'ask' } : { decision: 'ask', reason: ours['ask'] };
+}
 const frontmatter = /^---\r?\n[\s\S]*?\r?\n---[ \t]*(?:\r?\n|$)/;
 const baseDirectoryLine = /^Base directory for this skill: [^\n]*\n\n/;
 export function userSkillHook(claude) {
@@ -149,20 +197,10 @@ function classicResult(event, answer) {
     return result;
 }
 export const strictness = ['allow', 'ask', 'deny'];
-function strictnessOf(result) {
-    return strictness.findLastIndex((decision) => result[decision] !== undefined);
-}
-function mergeClassic(event, below, ours) {
+function mergeClassic(below, ours) {
     const merged = { ...below, ...ours };
     const context = [...(below['additionalContext'] ?? []), ...(ours['additionalContext'] ?? [])];
     if (context.length > 0)
         merged['additionalContext'] = context;
-    if (event !== 'PreToolUse')
-        return merged;
-    const strictest = strictness[Math.max(strictnessOf(below), strictnessOf(ours))];
-    for (const decision of strictness)
-        delete merged[decision];
-    if (strictest !== undefined)
-        merged[strictest] = ours[strictest] ?? below[strictest];
     return merged;
 }

package/runtime/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/runtime/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAiE,MAAM,aAAa,CAAA;AAC3H,OAAO,KAAK,EAAE,GAAG,EAAE,aAAa,EAAqB,MAAM,WAAW,CAAA;AAItE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,OAAO,EAAgD,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AAC3F,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AAKxE,MAAM,MAAM,MAAM,GAAG;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,KAAK,GAAG,UAAU,GAAG,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEtG,MAAM,MAAM,SAAS,CAAC,KAAK,SAAS,MAAM,IAAI;IAC5C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/E,KAAK,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;CACzG,CAAA;AAiCD,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBhE;AAkCD,wBAAgB,eAAe,CAAC,KAAK,SAAS,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,iBAAiB,GAAE,MAAM,OAAoB,GAAG,SAAS,CAAC,KAAK,CAAC,CAkOvJ"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/runtime/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAiE,MAAM,aAAa,CAAA;AAC3H,OAAO,KAAK,EAAa,GAAG,EAAE,aAAa,EAAqB,MAAM,WAAW,CAAA;AAIjF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,OAAO,EAAsG,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AACjJ,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AAKxE,MAAM,MAAM,MAAM,GAAG;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,KAAK,GAAG,UAAU,GAAG,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEtG,MAAM,MAAM,SAAS,CAAC,KAAK,SAAS,MAAM,IAAI;IAC5C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/E,KAAK,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;CACzG,CAAA;AAiCD,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBhE;AAkCD,wBAAgB,eAAe,CAAC,KAAK,SAAS,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,iBAAiB,GAAE,MAAM,OAAoB,GAAG,SAAS,CAAC,KAAK,CAAC,CAkOvJ"}

package/runtime/lifecycle.js

@@ -3,7 +3,7 @@ import { relativePath } from '../utils/paths.js';
 import { formatExit, listed, messageOf } from '../utils/text.js';
 import { beforeDeadline } from './deadline.js';
 import { answerCall, dependencyCalls, notInstalled } from './dependencies.js';
-import { classicHook, permissionEvents, userSkillHook } from './hooks.js';
+import { classicHook, heldDecisionHook, permissionEvents, preToolUseHook, userSkillHook } from './hooks.js';
 import { createRouter } from './router.js';
 import { createState } from './state.js';
 import { toolCalls } from './tool-calls.js';
@@ -332,6 +332,7 @@ async function createMod(definition, runtime) {
     let staleCwd;
     const area = createUi({ name: definition.name, claude, router, progress, announce, mod: () => mod });
     const modState = createState({ name: definition.name, initial: definition.state ?? {}, session, root, claude, changed: area.changed });
+    const held = runtime.checksPermissions() ? new Map() : undefined;
     const mod = {
         name: definition.name,
         state: modState.state,
@@ -339,7 +340,10 @@ async function createMod(definition, runtime) {
         on(event, hook) {
             if (!hookEvents.includes(event))
                 hookEvents.push(event);
-            router.add(`classic.${event}`, classicHook(definition.name, event, hook, claude, agents));
+            if (event === 'PreToolUse')
+                router.add('tool.call', preToolUseHook(definition.name, hook, claude, agents, held));
+            else
+                router.add(`classic.${event}`, classicHook(definition.name, event, hook, claude, agents));
         },
         use: (job) => job({ mod, claude, on: (event, hook) => router.add(event, hook), announce, reserveName, toolCalls: agents }),
         ui: area.ui,
@@ -351,9 +355,13 @@ async function createMod(definition, runtime) {
             read: (path) => claude.fs.read(path),
             write: (path, text) => claude.fs.write(path, text),
             list: (path) => claude.fs.list(path),
+            exists: (path) => claude.fs.exists(path),
+            stat: (path, options) => claude.fs.stat(path, options),
         },
         http: { fetch: (url, init) => claude.http.fetch(url, init) },
         settings: { read: (args) => claude.settings.read(args) },
+        session: { messages: claude.session.messages },
+        agent: { spawn: (args) => claude.agent.spawn(args) },
         get projectRoot() {
             return modState.root;
         },
@@ -433,6 +441,8 @@ async function createMod(definition, runtime) {
     if (permissionHooks.length > 0 && !runtime.checksPermissions()) {
         throw new Error(`it decides permissions on ${listed(permissionHooks)}, so hooks/register.ts must call registerPermissionCheck(addHook) after registerMod`);
     }
+    if (held !== undefined && hookEvents.includes('PreToolUse'))
+        router.add('tool.check', heldDecisionHook(held));
     await failsAs('its open panes did not load', () => area.restorePanes());
     if (hookEvents.length > 0)
         added.push(`${hookEvents.length === 1 ? 'a hook' : 'hooks'} on ${listed(hookEvents)}`);

package/runtime/ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/runtime/ui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAA+B,aAAa,EAAS,MAAM,aAAa,CAAA;AAClG,OAAO,KAAK,EAAE,GAAG,EAAc,YAAY,EAAE,MAAM,WAAW,CAAA;AAM9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAA;IAChC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,GAAG,IAAI,IAAI,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAA;IAClC,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAAA;CAC5F,CAAA;AAkBD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAqDvD;AAqHD,MAAM,MAAM,SAAS,CAAC,KAAK,SAAS,MAAM,IAAI;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,KAAK,CAAC,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,MAAM,CAAC,KAAK,SAAS,MAAM,IAAI;IACzC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAA;IAC7B,OAAO,IAAI,IAAI,CAAA;IACf,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9B,CAAA;AAED,wBAAgB,QAAQ,CAAC,KAAK,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAwLjI"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/runtime/ui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAA+B,aAAa,EAAS,MAAM,aAAa,CAAA;AAClG,OAAO,KAAK,EAAE,GAAG,EAAc,YAAY,EAAE,MAAM,WAAW,CAAA;AAO9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAA;IAChC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,GAAG,IAAI,IAAI,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAA;IAClC,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAAA;CAC5F,CAAA;AAkBD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAqDvD;AAsGD,MAAM,MAAM,SAAS,CAAC,KAAK,SAAS,MAAM,IAAI;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,KAAK,CAAC,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,MAAM,CAAC,KAAK,SAAS,MAAM,IAAI;IACzC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAA;IAC7B,OAAO,IAAI,IAAI,CAAA;IACf,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9B,CAAA;AAED,wBAAgB,QAAQ,CAAC,KAAK,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAmNjI"}

package/runtime/ui.js

@@ -1,3 +1,4 @@
+import { ProgressBar } from '../ui/components.js';
 import { Box, drawWith, Text } from '../ui/elements.js';
 import { messageOf } from '../utils/text.js';
 const spinner = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
@@ -77,23 +78,8 @@ function drawLine(line, frame, columns) {
     if (line.step === undefined)
         return Text({ wrap: 'truncate-end', children: [glyph, ' ', title, Text({ dimColor: true, children: '…' })] });
     const { done, total, label = '' } = line.step;
-    const count = `${done}/${total}`;
-    const width = barWidth(columns, `${line.title}${count}${label}`.length);
-    const filled = total > 0 ? Math.round(Math.min(done / total, 1) * width) : 0;
-    return Text({
-        wrap: 'truncate-end',
-        children: [
-            glyph,
-            ' ',
-            title,
-            '  ',
-            Text({ color: 'claude', children: '█'.repeat(filled) }),
-            Text({ color: 'subtle', children: '░'.repeat(width - filled) }),
-            '  ',
-            Text({ dimColor: true, children: count }),
-            ...(label === '' ? [] : ['  ', label]),
-        ],
-    });
+    const width = barWidth(columns, `${line.title}${done}/${total}${label}`.length);
+    return Text({ wrap: 'truncate-end', children: [glyph, ' ', title, '  ', ProgressBar({ done, total, width }), ...(label === '' ? [] : ['  ', label])] });
 }
 function barWidth(columns, textLength) {
     if (columns === undefined)
@@ -165,6 +151,7 @@ function drawPieces(pieces, place) {
 }
 export function createUi({ name, claude, router, progress, announce, mod }) {
     const panes = new Map();
+    const paneLogs = new Map();
     const openPanes = new Set();
     const requestedSizes = new Map();
     const renders = new Set();
@@ -231,9 +218,10 @@ export function createUi({ name, claude, router, progress, announce, mod }) {
             return drawWith(table, () => drawPieces(drawn, e.props.isFirstOfReply ? 'opensReply' : 'inReply'));
         });
     };
-    const openAt = (pane, size) => {
+    const openAt = (pane, size, focus) => {
         requestedSizes.set(pane.id, size);
-        return claude.ui.open({ id: pane.id, title: pane.title, ...size });
+        const { id, title, closeOnEscape, holdToasts } = pane;
+        return claude.ui.open({ id, title, ...size, ...(closeOnEscape === true ? { closeOnEscape } : {}), ...(holdToasts === true ? { holdToasts } : {}), ...(focus === true ? { focus } : {}) });
     };
     const resize = async (pane) => {
         try {
@@ -257,27 +245,54 @@ export function createUi({ name, claude, router, progress, announce, mod }) {
                 return next(e);
             openPanes.add(pane.id);
             const table = claude.ui.resolve(e);
-            return drawWith(table, () => pane.render(mod(), e.props), markdownIn(table));
+            try {
+                return drawWith(table, () => pane.render(mod(), e.props), markdownIn(table));
+            }
+            catch (error) {
+                paneLogs.get(pane.id)?.(`threw: ${messageOf(error)}`);
+                return drawWith(table, () => Text({ color: 'error', children: `The ${pane.title} pane could not draw: ${messageOf(error)}` }));
+            }
         });
-        router.add('ui.close', (e, next) => {
+        router.add('ui.scroll', async (e, next) => {
+            const pane = panes.get(e.requestId);
+            const moved = await next(e);
+            if (pane?.onScroll === undefined || e.component !== 'Pane' || moved.deny !== undefined)
+                return moved;
+            await handle(pane, 'onScroll', () => pane.onScroll?.(mod(), e));
+            return moved;
+        });
+        router.add('ui.close', async (e, next) => {
             openPanes.delete(e.id);
-            return next(e);
+            const closed = await next(e);
+            const pane = panes.get(e.id);
+            if (pane?.onClose !== undefined)
+                await handle(pane, 'onClose', () => pane.onClose?.(mod(), e));
+            return closed;
         });
     };
+    const handle = async (pane, handler, run) => {
+        try {
+            await run();
+        }
+        catch (error) {
+            claude.ui.log(`${name}: the ${pane.title} pane's ${handler} threw: ${messageOf(error)}`);
+        }
+    };
     return {
         ui: {
             pane(pane) {
                 if (panes.has(pane.id))
                     throw new Error(`${name}: the pane "${pane.id}" is already added. Give each pane its own id.`);
                 panes.set(pane.id, pane);
+                paneLogs.set(pane.id, logOnce(`${pane.title} pane`));
                 announce(`the ${pane.title} pane`);
                 route();
                 const handle = {
                     get isOpen() {
                         return openPanes.has(pane.id);
                     },
-                    async open() {
-                        const { isPlaced } = await openAt(pane, paneSize(pane, mod().state));
+                    async open(options) {
+                        const { isPlaced } = await openAt(pane, paneSize(pane, mod().state), options?.focus);
                         if (isPlaced)
                             openPanes.add(pane.id);
                     },
@@ -285,7 +300,7 @@ export function createUi({ name, claude, router, progress, announce, mod }) {
                         await claude.ui.close({ id: pane.id });
                         openPanes.delete(pane.id);
                     },
-                    toggle: () => (openPanes.has(pane.id) ? handle.close() : handle.open()),
+                    toggle: (options) => (openPanes.has(pane.id) ? handle.close() : handle.open(options)),
                 };
                 return handle;
             },
@@ -318,7 +333,7 @@ export function createUi({ name, claude, router, progress, announce, mod }) {
                     return drawWith(table, () => drawPieces([drawn], e.props.isFirstOfReply ? 'opensReply' : 'inReply'));
                 });
             },
-            toast: (text) => claude.ui.toast(text),
+            toast: (text, options) => claude.ui.toast(text, options),
             async progress(title, task) {
                 const line = progress.start(title);
                 try {
@@ -329,6 +344,7 @@ export function createUi({ name, claude, router, progress, announce, mod }) {
                 }
             },
             ask: (question, options) => claude.ui.ask(question, options),
+            scroll: (args) => claude.ui.scroll(args),
         },
         changed() {
             if (panes.size === 0 && renders.size === 0)

package/shell.d.ts

@@ -0,0 +1,2 @@
+export { parseShell, type ParsedShell, type ShellCommand } from './utils/parse-shell.js';
+//# sourceMappingURL=shell.d.ts.map

package/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["src/shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAA"}

package/shell.js

@@ -0,0 +1 @@
+export { parseShell } from './utils/parse-shell.js';

package/src/jobs/check.ts

@@ -1,7 +1,7 @@
 import type { Job } from '../mod.js'
 import { longestMs, type Deadline } from '../runtime/deadline.js'
 import { callEffects, type ToolUse } from '../utils/call-effects.js'
-import { parentOf } from '../utils/paths.js'
+import { dirname } from '../vendor.js'
 import { listed, messageOf } from '../utils/text.js'
 import { afterCall, modOf, targetWords } from './context.js'
 import type { Workspace } from './permissions/find-project-scope.js'
@@ -52,6 +52,6 @@ async function triggeredRun(after: readonly Target[], run: readonly string[], us
   const existing: string[] = []
   for (const path of paths) if (await workspace.fs.exists(path)) existing.push(path)
   const last = existing.at(-1)
-  if (last !== undefined) return { command: [...run, ...existing], folder: parentOf(last) }
+  if (last !== undefined) return { command: [...run, ...existing], folder: dirname(last) }
   return commandFolder === undefined ? undefined : { command: [...run], folder: commandFolder }
 }

package/src/jobs/context.ts

@@ -77,6 +77,8 @@ export function modWithin<State extends object>({ mod, claude }: JobContext<Stat
       read: (path) => within('mod.fs.read', mod.fs.read(path)),
       write: (path, text) => within('mod.fs.write', mod.fs.write(path, text)),
       list: (path) => within('mod.fs.list', mod.fs.list(path)),
+      exists: (path) => within('mod.fs.exists', mod.fs.exists(path)),
+      stat: (path, options) => within('mod.fs.stat', mod.fs.stat(path, options)),
     },
     http: { fetch: (url, init) => within('mod.http.fetch', mod.http.fetch(url, init)) },
     dependencies: dependencyCalls(claude, within),

package/src/jobs/permissions/decide-permission.ts

@@ -3,7 +3,7 @@ import { messageOf } from '../../utils/text.js'
 import { callBaseOf, callEffects, type CallEffects, type ToolCall, type ToolUse } from '../../utils/call-effects.js'
 import type { Workspace } from './find-project-scope.js'
 import { folderInScope, matchTarget, targetOf, type MatchedCall, type Target, type TargetCalls, type TargetKey, type TargetOf } from './match-target.js'
-import { resolvePath } from '../../utils/paths.js'
+import { resolve } from '../../vendor.js'
 
 export type Rule<Mod> = {
   [Key in TargetKey]: TargetOf<Key> & {
@@ -71,7 +71,7 @@ async function unparsedMatches(target: Target, use: ToolUse, effects: CallEffect
   const named = patterns.map((pattern) => pattern.slice(pattern.lastIndexOf('/') + 1)).filter((segment) => segment !== '' && !/[*?[\]{}]/.test(segment) && line.includes(segment.toLowerCase()))
   const folder = named.length === 0 ? undefined : await folderInScope(shell, workspace)
   if (folder === undefined) return []
-  return named.map((segment) => ({ call: { ...base, path: resolvePath(segment, folder) }, access: undefined, folder }))
+  return named.map((segment) => ({ call: { ...base, path: resolve(folder, segment) }, access: undefined, folder }))
 }
 
 function containsWord(line: string, word: string): boolean {

package/src/jobs/permissions/find-project-scope.ts

@@ -1,14 +1,15 @@
-import { nameOf, parentOf, resolvePath, type FileSystem } from '../../utils/paths.js'
+import type { FileSystem } from '../../utils/paths.js'
+import { basename, dirname, resolve } from '../../vendor.js'
 
 export type ProjectScope = { workTreeOf: (path: string) => Promise<string | undefined> }
 
 export type Workspace = { projectRoot: string; cwd: string; home: string; fs: FileSystem; scope: ProjectScope | undefined }
 
 export async function findProjectScope(pluginRoot: string, home: string, fs: FileSystem): Promise<ProjectScope | undefined> {
-  const skills = parentOf(pluginRoot)
-  const claude = parentOf(skills)
-  const root = parentOf(claude)
-  if (nameOf(skills) !== 'skills' || nameOf(claude) !== '.claude' || root === resolvePath(home, '/')) return undefined
+  const skills = dirname(pluginRoot)
+  const claude = dirname(skills)
+  const root = dirname(claude)
+  if (basename(skills) !== 'skills' || basename(claude) !== '.claude' || root === resolve('/', home)) return undefined
   const repositories = new Map<string, string>()
   const repositoryOf = async (workTree: string) => {
     const known = repositories.get(workTree)
@@ -21,7 +22,7 @@ export async function findProjectScope(pluginRoot: string, home: string, fs: Fil
   if (project === undefined) return undefined
   return {
     async workTreeOf(path) {
-      for (let folder = path; ; folder = parentOf(folder)) {
+      for (let folder = path; ; folder = dirname(folder)) {
         const repository = await repositoryOf(folder)
         if (repository !== undefined) return repository === project ? folder : undefined
         if (folder === '/') return undefined
@@ -31,16 +32,16 @@ export async function findProjectScope(pluginRoot: string, home: string, fs: Fil
 }
 
 async function readRepository(workTree: string, fs: FileSystem): Promise<string | undefined> {
-  const gitPath = resolvePath('.git', workTree)
+  const gitPath = resolve(workTree, '.git')
   const git = await fs.stat(gitPath).catch(() => undefined)
   if (git === undefined) return undefined
   if (git.kind === 'dir') return git.realPath ?? gitPath
   try {
     const gitDirectory = /^gitdir:\s*(.+)$/m.exec(await fs.read(gitPath))?.[1]?.trim()
     if (gitDirectory === undefined) throw new Error(`${gitPath} has no gitdir line.`)
-    const linkedDirectory = resolvePath(gitDirectory, workTree)
-    const commonDirectory = await fs.read(resolvePath('commondir', linkedDirectory)).then(
-      (text) => resolvePath(text.trim(), linkedDirectory),
+    const linkedDirectory = resolve(workTree, gitDirectory)
+    const commonDirectory = await fs.read(resolve(linkedDirectory, 'commondir')).then(
+      (text) => resolve(linkedDirectory, text.trim()),
       () => linkedDirectory,
     )
     return (await fs.stat(commonDirectory)).realPath ?? commonDirectory

package/src/jobs/permissions/match-target.ts

@@ -2,7 +2,8 @@ import { matchesGlob } from '../../utils/matches-glob.js'
 import { parseShell } from '../../utils/parse-shell.js'
 import { callBaseOf, type CallBase, type CallEffects, type CommandCall, type FetchCall, type FileAccess, type FileCall, type ToolCall, type ToolUse } from '../../utils/call-effects.js'
 import type { Workspace } from './find-project-scope.js'
-import { nameOf, realPathOf, relativePath } from '../../utils/paths.js'
+import { realPathOf, relativePath } from '../../utils/paths.js'
+import { basename } from '../../vendor.js'
 
 export type TargetCalls = { command: CommandCall; read: FileCall; write: FileCall; fetch: FetchCall; subagent: CallBase; tool: CallBase }
 export type TargetKey = keyof TargetCalls
@@ -56,11 +57,11 @@ export async function matchTarget(target: Target, use: ToolUse, effects: CallEff
 function commandPattern(pattern: string): [string, ...string[]] {
   const command = parseShell(pattern).commands[0]
   if (command === undefined) throw new Error(`The command pattern '${pattern}' names no program.`)
-  return command
+  return command.argv
 }
 
 function commandMatches(pattern: [string, ...string[]], argv: [string, ...string[]]): boolean {
-  if (nameOf(argv[0]) !== nameOf(pattern[0])) return false
+  if (basename(argv[0]) !== basename(pattern[0])) return false
   const wanted = splitArguments(pattern.slice(1))
   const actual = splitArguments(argv.slice(1))
   let next = 0

package/src/mod.ts

@@ -1,11 +1,16 @@
 import type {
+  AgentSpawnArgs,
+  AgentSpawnResult,
   AskOptions,
   ClassicHookInputs,
   CmodDependencies,
   FsEntry,
+  FsStat,
+  FsStatOptions,
   HookStream,
   HttpInit,
   HttpResponse,
+  PaneOpenArgs,
   PermissionRequestDecision,
   ProcessRunInit,
   ProcessRunResult,
@@ -15,6 +20,9 @@ import type {
   RenderElement,
   Settings,
   SettingsReadArgs,
+  ToastOptions,
+  UiScrollArgs,
+  UiScrollResult,
 } from 'claude-code'
 import type { Claude } from './runtime/claude.js'
 import type { RoutedEvent } from './runtime/hooks.js'
@@ -30,9 +38,9 @@ export type ProgressStep = {
 }
 
 export type PaneHandle = {
-  open(): Promise<void>
+  open(options?: Readonly<Pick<PaneOpenArgs, 'focus'>>): Promise<void>
   close(): Promise<void>
-  toggle(): Promise<void>
+  toggle(options?: Readonly<Pick<PaneOpenArgs, 'focus'>>): Promise<void>
   readonly isOpen: boolean
 }
 
@@ -59,6 +67,7 @@ export type ModEvent =
   | 'Stop'
   | 'StopFailure'
   | 'CwdChanged'
+  | 'FileChanged'
 
 export type HookAnswer = {
   continue?: boolean
@@ -104,7 +113,9 @@ type HookInputs = Omit<ClassicHookInputs, 'PreToolUse' | 'PostToolUse' | 'PostTo
   CwdChanged: Omit<ClassicHookInputs['CwdChanged'], 'transcript_path'>
 }
 
-export type ModHook<E extends ModEvent> = (input: HookInputs[E]) => HookAnswer | void | Promise<HookAnswer | void>
+export type HookInput<E extends ModEvent> = HookInputs[E]
+
+export type ModHook<E extends ModEvent> = (input: HookInput<E>) => HookAnswer | void | Promise<HookAnswer | void>
 
 export type Mod<State extends object = Record<never, never>> = {
   readonly name: string
@@ -115,9 +126,10 @@ export type Mod<State extends object = Record<never, never>> = {
   readonly ui: {
     pane(pane: Pane<State>): PaneHandle
     render<S extends Slot>(slot: S, Component: (props: SlotProps<S>) => RenderElement): void
-    toast(text: string): void
+    toast(text: string, options?: ToastOptions): void
     progress<T>(title: string, task: (report: (step: ProgressStep) => void) => Promise<T>): Promise<T>
     ask(question: string, options?: readonly string[] | AskOptions): Promise<string>
+    scroll(args: UiScrollArgs): Promise<UiScrollResult>
   }
   readonly process: {
     run(argv: readonly string[], init?: ProcessRunInit): Promise<ProcessRunResult>
@@ -127,6 +139,8 @@ export type Mod<State extends object = Record<never, never>> = {
     read(path: string): Promise<string>
     write(path: string, text: string): Promise<void>
     list(path?: string): Promise<FsEntry[]>
+    exists(path: string): Promise<boolean>
+    stat(path: string, options?: FsStatOptions): Promise<FsStat>
   }
   readonly http: {
     fetch(url: string, init?: HttpInit): Promise<HttpResponse>
@@ -134,6 +148,12 @@ export type Mod<State extends object = Record<never, never>> = {
   readonly settings: {
     read(args?: SettingsReadArgs): Promise<Settings>
   }
+  readonly session: {
+    messages: Claude['session']['messages']
+  }
+  readonly agent: {
+    spawn(args: AgentSpawnArgs): Promise<AgentSpawnResult>
+  }
   readonly projectRoot: string
   readonly cwd: string
   readonly dependencies: CmodDependencies

package/src/path.ts

@@ -0,0 +1 @@
+export { basename, dirname, extname, isAbsolute, join, normalize, relative, resolve } from './vendor.js'

package/src/register.ts

@@ -21,6 +21,7 @@ async function startMod($: EngineInterface, eventInput: Frozen<Args<'session.sta
       open: (pane) => $.ui.open(pane),
       close: (pane) => $.ui.close(pane),
       panes: () => $.ui.panes(),
+      scroll: (args) => $.ui.scroll(args),
       resolve: (render) => $.ui.resolve(render),
     },
     process: {
@@ -54,10 +55,14 @@ async function startMod($: EngineInterface, eventInput: Frozen<Args<'session.sta
       model: () => $.session.model(),
       usage: () => $.session.usage(),
       surfaces: () => $.session.surfaces(),
+      messages: ((args?: Parameters<Claude['session']['messages']>[0]) => (args === undefined ? $.session.messages() : $.session.messages(args))) as Claude['session']['messages'],
     },
     command: { register: (command) => $.command.register(command) },
     tool: { register: (tool) => $.tool.register(tool) },
-    agent: { list: () => $.agent.list() },
+    agent: {
+      list: () => $.agent.list(),
+      spawn: (args) => $.agent.spawn(args),
+    },
     env: {
       home: () => $.env.get('HOME'),
       dataHome: () => $.env.get('XDG_DATA_HOME'),
@@ -91,6 +96,7 @@ export function registerMod<State extends object>(addHook: On, definition: ModDe
   addHook('classic.PreCompact', routeToMod)
   addHook('classic.Stop', routeToMod)
   addHook('classic.StopFailure', routeToMod)
+  addHook('classic.FileChanged', routeToMod)
   addHook('tool.call', routeToMod)
   addHook('prompt.submit', routeToMod)
   addHook('prompt.context', routeToMod)
@@ -99,6 +105,7 @@ export function registerMod<State extends object>(addHook: On, definition: ModDe
   addHook('skill.prompt', routeToMod)
   addHook('ui.render', routeToMod)
   addHook('ui.press', routeToMod)
+  addHook('ui.scroll', routeToMod)
   addHook('ui.close', routeToMod)
   addHook('cmod.call', routeToMod)
 }
@@ -106,6 +113,5 @@ export function registerMod<State extends object>(addHook: On, definition: ModDe
 export function registerPermissionCheck(addHook: On): void {
   checksPermissions = true
   addHook('tool.check', routeToMod)
-  addHook('classic.PreToolUse', routeToMod)
   addHook('classic.PermissionRequest', routeToMod)
 }

package/src/runtime/claude.ts

@@ -1,6 +1,9 @@
 import type {
   AgentInfo,
+  AgentSpawnArgs,
+  AgentSpawnResult,
   Args,
+  EngineInterface,
   AskOptions,
   CommandSpec,
   ElementTable,
@@ -29,6 +32,8 @@ import type {
   UiLogOptions,
   UiOpenResult,
   UiPane,
+  UiScrollArgs,
+  UiScrollResult,
 } from 'claude-code'
 
 export type Claude = {
@@ -43,6 +48,7 @@ export type Claude = {
     open(pane: PaneOpenArgs): Promise<UiOpenResult>
     close(pane: PaneCloseArgs): Promise<void>
     panes(): Promise<readonly UiPane[]>
+    scroll(args: UiScrollArgs): Promise<UiScrollResult>
     resolve(e: ResolveInput): ElementTable<RenderSurface>
   }
   readonly process: {
@@ -76,10 +82,14 @@ export type Claude = {
     model(): Promise<string>
     usage(): Promise<SessionUsage>
     surfaces(): Promise<readonly RenderSurface[]>
+    messages: EngineInterface['session']['messages']
   }
   readonly command: { register(command: CommandSpec): Promise<{ command: string }> }
   readonly tool: { register(tool: ToolSpec): Promise<{ tool: string }> }
-  readonly agent: { list(): Promise<AgentInfo[]> }
+  readonly agent: {
+    list(): Promise<AgentInfo[]>
+    spawn(args: AgentSpawnArgs): Promise<AgentSpawnResult>
+  }
   readonly env: {
     home(): Promise<string | undefined>
     dataHome(): Promise<string | undefined>