@cmodjs/core 0.1.6 → 0.1.8

package/docs/state.md

@@ -1,6 +1,6 @@
 # State
 
-`mod.state` holds the mod's values. Claude Mod Manager (CMod) saves them, redraws the mod's panes and slot renders when one changes, and lets a person change the starting values without touching the mod's code.
+`mod.state` holds the mod's values. Claude Mod Manager (cmod) saves them, redraws the mod's panes and slot renders when one changes, and lets a person change the starting values without touching the mod's code.
 
 ## Declare the state
 
@@ -13,7 +13,7 @@
 | `project` | This project, in every conversation. | Yes |
 | `global` | Every project. | Yes |
 
-CMod keeps each `session` value for the 20 sessions that wrote it last, and each `project` value for the 20 projects that wrote it last. A session or project past those 20 starts that value over from its starting value.
+cmod keeps each `session` value for the 20 sessions that wrote it last, and each `project` value for the 20 projects that wrote it last. A session or project past those 20 starts that value over from its starting value.
 
 Put values the mod works out again on every prompt, such as a git status, in `memory`.
 
@@ -56,7 +56,7 @@ A group other than `memory`, `session`, `project`, and `global` throws `<mod>: s
 
 ## Change a value
 
-Assign to a key. CMod saves the new value and redraws the mod.
+Assign to a key. cmod saves the new value and redraws the mod.
 
 - A key the state does not declare throws `<mod>: mod.state.<group>.<key> is not declared. Add it to state.<group> in defineMod with its starting value.`
 - An object or an array in the state is frozen. Changing it in place throws `<mod>: mod.state.<path> cannot change in place.` Assign a new value instead:
@@ -75,8 +75,8 @@ export const reads = defineMod({
 })
 ```
 
-- Keep only JSON data in a saved group. A value CMod cannot save logs `<mod> could not keep state.<group>.<key>: <error>. Keep only JSON data in mod.state.`
-- CMod saves values one at a time in the order they were assigned.
+- Keep only JSON data in a saved group. A value cmod cannot save logs `<mod> could not keep state.<group>.<key>: <error>. Keep only JSON data in mod.state.`
+- cmod saves values one at a time in the order they were assigned.
 
 ## Where the values come from
 
@@ -87,7 +87,7 @@ When the mod starts, each value is, in order of precedence:
 3. The value in the person's own `state.json`.
 4. The starting value in `defineMod`.
 
-After a `/cd` to another project, CMod loads that project's `project` values and reads its `state.json` again.
+After a `/cd` to another project, cmod loads that project's `project` values and reads its `state.json` again.
 
 ## Let a person change the starting values
 
@@ -111,7 +111,7 @@ A `state.json` in either folder lists only the values to change:
 - A project `state.json` cannot set `global` values, because one repository cannot change a value for every project.
 - A file cannot set `memory` values.
 
-CMod ignores each entry it cannot use and logs one line naming the file, the entry, and the fix:
+cmod ignores each entry it cannot use and logs one line naming the file, the entry, and the fix:
 
 - a file that is not JSON, or not a JSON object
 - a group the mod does not declare
@@ -131,7 +131,7 @@ A person replaces the text of a Skill the mod ships by putting a file at the sam
 
 - Claude reads that file in place of the mod's from the next time the Skill loads, and updates of the mod keep it.
 - The project file wins over the person's file.
-- CMod drops the file's frontmatter, so the mod's own name and description stay.
+- cmod drops the file's frontmatter, so the mod's own name and description stay.
 - Only a Skill the mod ships in `skills/<skill>/` is replaced, and only when it loads as `<mod>:<skill>`.
 - Deleting the file brings the mod's text back.
 

package/docs/ui.md

@@ -10,7 +10,7 @@ mod.ui.progress<T>(title: string, task: (report: (step: ProgressStep) => void) =
 mod.ui.ask(question: string, options?: readonly string[] | AskOptions): Promise<string>
 ```
 
-Claude Mod Manager (CMod) draws the mod again whenever a value in `mod.state` changes. A render reads `mod.state` and returns what to show. It never draws by hand.
+Claude Mod Manager (cmod) draws the mod again whenever a value in `mod.state` changes. A render reads `mod.state` and returns what to show. It never draws by hand.
 
 ## Elements
 
@@ -46,7 +46,7 @@ export function Count({ label, count }: { readonly label: string; readonly count
 
 An element called outside a render throws `<Element> was called outside a render. Use it inside a pane's render or a slot's component.` So build elements inside a pane's `render` or a slot's component, never at module load or in a hook.
 
-`drawWith(table, draw, markdown?)` is the function CMod draws a render with. A mod never calls it.
+`drawWith(table, draw, markdown?)` is the function cmod draws a render with. A mod never calls it.
 
 ## Panes
 
@@ -68,7 +68,7 @@ type Pane<State> = {
 
 - `id` is 1 to 64 letters, digits, `_`, or `-`. Another id throws `definePane: "<id>" is not a pane id.`
 - `title` labels the pane's tab while more than one pane is open.
-- `columns` and `rows` ask for a size. A number must be a whole number above 0, or `definePane` throws. A function reads the state and returns the size, or `undefined` for Claude Code's default. When the state changes the size, CMod resizes an open pane. A function that returns a bad size keeps an open pane at its size and logs the pane's title to the debug log. `open`, and `toggle` on a closed pane, reject with that size instead.
+- `columns` and `rows` ask for a size. A number must be a whole number above 0, or `definePane` throws. A function reads the state and returns the size, or `undefined` for Claude Code's default. When the state changes the size, cmod resizes an open pane. A function that returns a bad size keeps an open pane at its size and logs the pane's title to the debug log. `open`, and `toggle` on a closed pane, reject with that size instead.
 - `render` draws the pane's body. `props` holds `title`, `isFocused`, `bodyColumns`, `placement` (`'dock'` or `'inline'`), `scroll`, the body's window over a taller drawing, and `view`, which transcript is on screen beside the pane.
 
 Put each pane in its own file in `src/panes/`.
@@ -106,13 +106,13 @@ type PaneHandle = {
 ```
 
 - `open` asks Claude Code to show the pane. `isOpen` turns true once Claude Code places it. Claude Code may hold a pane back, and then `isOpen` stays false.
-- `mod.ui.pane` only adds the pane. CMod opens it only when the mod calls `open` or `toggle`, and Claude Code shows a pane only once the plugin has opened it. So give the person a way in, such as a slash command whose `reply` calls `pane.toggle()`.
+- `mod.ui.pane` only adds the pane. cmod opens it only when the mod calls `open` or `toggle`, and Claude Code shows a pane only once the plugin has opened it. So give the person a way in, such as a slash command whose `reply` calls `pane.toggle()`.
 - A pane opened from what the person did, such as a slash command they typed or a `Button` they pressed, shows at any terminal width. A pane opened from anything else, such as `setup`, a timer, or `SessionStart`, shows only on a terminal 144 columns wide, or 110 for a pane the person opened before. Below that it waits undrawn until the person opens it or the terminal widens.
 - `close` closes it. The person closes a pane too, and `isOpen` follows.
 - `toggle` closes an open pane and opens a closed one.
 - When the mod starts, `isOpen` is true for each of its panes Claude Code already shows.
 - Adding two panes with one id throws `<mod>: the pane "<id>" is already added. Give each pane its own id.`
-- The line CMod logs when the mod first starts names the pane by its `title`, as in `the Notes pane`.
+- The line cmod logs when the mod first starts names the pane by its `title`, as in `the Notes pane`.
 
 ```tsx
 import { defineMod } from '../node_modules/@cmodjs/core/mod.js'
@@ -157,7 +157,7 @@ export const notes = defineMod({
 - `Default` draws what Claude Code, and the renders of other mods, would draw. Pass it props to change what it draws, such as `<Default hint="…" />`. Return `<Default />` to change nothing.
 - A render adds to what it wraps. In `AbovePrompt`, drawing `<Default />` and a line under it keeps the lines of Claude Code and other mods.
 - A render must draw the same for the same props. One that calls `Default` a different number of times on a second draw falls back to Claude Code's drawing.
-- A render that throws falls back to Claude Code's drawing. CMod logs `<mod>: the <Slot> render threw, so Claude Code draws its own: <error>` once.
+- A render that throws falls back to Claude Code's drawing. cmod logs `<mod>: the <Slot> render threw, so Claude Code draws its own: <error>` once.
 - A mod renders each slot once. A second `mod.ui.render` of one slot throws `<mod>: a render of <Slot> is already added. Render each slot once.` For a markdown slot the error names it as `a render of markdown <Kind>`, such as `a render of markdown CodeBlock`.
 - `slots.ToolUse` changes a call's own row. A group of calls shows the `slots.ToolGroup` row, which Claude Code builds from the stored message, so a mod that hides a tool's input also sets `isExpanded` on `slots.ToolGroup` to unfold the group into `ToolUse` rows.
 - No slot covers the permission dialog.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmodjs/core",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Build Claude Code mods: hooks, panes, permissions, checks, and an install that just works.",
   "license": "MIT",
   "type": "module",
@@ -25,7 +25,7 @@
     "docs/"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.build.json && bun build src/vendor.ts --outfile vendor.js --format esm --target browser && NODE_ENV=production bun build src/vendor-markdown.ts --outfile vendor-markdown.js --format esm --target browser --conditions worker",
+    "build": "tsc -p tsconfig.build.json && bun build src/vendor.ts --outfile vendor.js --format esm --target browser --define process=undefined && NODE_ENV=production bun build src/vendor-markdown.ts --outfile vendor-markdown.js --format esm --target browser --conditions worker",
     "check": "tsc -p tsconfig.json --noEmit && oxlint --deny-warnings",
     "test": "bun test"
   },

package/records.js

@@ -6,7 +6,7 @@ export function storeFolder(env) {
     if (dataHome)
         return `${dataHome}/cmod`;
     if (!home)
-        throw new Error('Neither XDG_DATA_HOME nor HOME is set, so the CMod store has no folder. Set HOME.');
+        throw new Error('Neither XDG_DATA_HOME nor HOME is set, so the cmod store has no folder. Set HOME.');
     return `${home}/.local/share/cmod`;
 }
 export function recordPath(store, name) {
@@ -56,7 +56,7 @@ function parseRecord(text, path) {
         throw new Error(`${path} is not JSON (${messageOf(error)}). ${fix}`);
     }
     if (!isObject(value))
-        throw new Error(`${path} is not a CMod install record. ${fix}`);
+        throw new Error(`${path} is not a cmod install record. ${fix}`);
     for (const key of ['name', 'version', 'root', 'installedAt', 'scriptsSha256']) {
         if (typeof value[key] !== 'string')
             throw new Error(`${path} has no "${key}" text. ${fix}`);
@@ -102,7 +102,7 @@ function readCommand(steps, key) {
         throw new Error(`package.json "cmod.${key}" holds a line break or a tab. Write one command, such as "./setup/${key}.sh".`);
     const atRoot = scriptPaths(command).find((path) => folderOf(path) === '.');
     if (atRoot !== undefined)
-        throw new Error(`package.json "cmod.${key}" names ${atRoot}, a script at the plugin root. Move it into a folder, such as ./setup/${key}.sh: CMod asks consent for the whole folder of each script.`);
+        throw new Error(`package.json "cmod.${key}" names ${atRoot}, a script at the plugin root. Move it into a folder, such as ./setup/${key}.sh: cmod asks consent for the whole folder of each script.`);
     return { [key]: command };
 }
 export function scriptPaths(command) {

package/register.d.ts

@@ -0,0 +1,5 @@
+import type { On } from 'claude-code';
+import type { ModDefinition } from './mod.js';
+export declare function registerMod<State extends object>(addHook: On, definition: ModDefinition<State>): void;
+export declare function registerPermissionCheck(addHook: On): void;
+//# sourceMappingURL=register.d.ts.map

package/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["src/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoD,EAAE,EAAE,MAAM,aAAa,CAAA;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AA0E7C,wBAAgB,WAAW,CAAC,KAAK,SAAS,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,IAAI,CA4BrG;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,CAKzD"}

package/{connect.js → register.js}

@@ -1,5 +1,6 @@
 import { createLifecycle, readPlugin } from './runtime/lifecycle.js';
 let lifecycle;
+let checksPermissions = false;
 async function startMod($, eventInput, passOn) {
     const claude = {
         plugin: { name: $.plugin.name, root: $.plugin.root },
@@ -63,34 +64,38 @@ async function startMod($, eventInput, passOn) {
 function routeToMod(_$, eventInput, passOn) {
     return lifecycle.route(passOn.event, eventInput, (passed) => passOn(passed));
 }
-export function connect(on, definition) {
-    lifecycle = createLifecycle(definition);
-    on('session.start', startMod);
-    on('classic.SessionStart', routeToMod);
-    on('classic.SessionEnd', routeToMod);
-    on('classic.UserPromptSubmit', routeToMod);
-    on('classic.InstructionsLoaded', routeToMod);
-    on('classic.PreToolUse', routeToMod);
-    on('classic.PermissionRequest', routeToMod);
-    on('classic.PermissionDenied', routeToMod);
-    on('classic.PostToolUse', routeToMod);
-    on('classic.PostToolUseFailure', routeToMod);
-    on('classic.PostToolBatch', routeToMod);
-    on('classic.SubagentStart', routeToMod);
-    on('classic.SubagentStop', routeToMod);
-    on('classic.Notification', routeToMod);
-    on('classic.PreCompact', routeToMod);
-    on('classic.Stop', routeToMod);
-    on('classic.StopFailure', routeToMod);
-    on('tool.check', routeToMod);
-    on('tool.call', routeToMod);
-    on('prompt.submit', routeToMod);
-    on('prompt.context', routeToMod);
-    on('command.run', routeToMod);
-    on('session.measure', routeToMod);
-    on('skill.prompt', routeToMod);
-    on('ui.render', routeToMod);
-    on('ui.press', routeToMod);
-    on('ui.close', routeToMod);
-    on('cmod.call', routeToMod);
+export function registerMod(addHook, definition) {
+    checksPermissions = false;
+    lifecycle = createLifecycle(definition, () => checksPermissions);
+    addHook('session.start', startMod);
+    addHook('classic.SessionStart', routeToMod);
+    addHook('classic.SessionEnd', routeToMod);
+    addHook('classic.UserPromptSubmit', routeToMod);
+    addHook('classic.InstructionsLoaded', routeToMod);
+    addHook('classic.PermissionDenied', routeToMod);
+    addHook('classic.PostToolUse', routeToMod);
+    addHook('classic.PostToolUseFailure', routeToMod);
+    addHook('classic.PostToolBatch', routeToMod);
+    addHook('classic.SubagentStart', routeToMod);
+    addHook('classic.SubagentStop', routeToMod);
+    addHook('classic.Notification', routeToMod);
+    addHook('classic.PreCompact', routeToMod);
+    addHook('classic.Stop', routeToMod);
+    addHook('classic.StopFailure', routeToMod);
+    addHook('tool.call', routeToMod);
+    addHook('prompt.submit', routeToMod);
+    addHook('prompt.context', routeToMod);
+    addHook('command.run', routeToMod);
+    addHook('session.measure', routeToMod);
+    addHook('skill.prompt', routeToMod);
+    addHook('ui.render', routeToMod);
+    addHook('ui.press', routeToMod);
+    addHook('ui.close', routeToMod);
+    addHook('cmod.call', routeToMod);
+}
+export function registerPermissionCheck(addHook) {
+    checksPermissions = true;
+    addHook('tool.check', routeToMod);
+    addHook('classic.PreToolUse', routeToMod);
+    addHook('classic.PermissionRequest', routeToMod);
 }

package/runtime/hooks.d.ts

@@ -3,6 +3,7 @@ import type { Claude } from './claude.js';
 import type { RoutedHook } from './router.js';
 import { type ToolCalls } from './tool-calls.js';
 export type RoutedEvent = `classic.${ModEvent}` | 'tool.check' | 'tool.call' | 'prompt.submit' | 'prompt.context' | 'command.run' | 'session.measure' | 'skill.prompt' | 'ui.render' | 'ui.press' | 'ui.close' | 'cmod.call';
+export declare const permissionEvents: readonly RoutedEvent[];
 export declare function classicHook<E extends ModEvent>(name: string, event: E, hook: ModHook<E>, claude: Claude, calls: ToolCalls): RoutedHook<RoutedEvent>;
 export declare function userSkillHook(claude: Claude): RoutedHook<'skill.prompt'>;
 export declare const strictness: readonly ['allow', 'ask', 'deny'];

package/runtime/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/runtime/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAE9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAK7D,MAAM,MAAM,WAAW,GACnB,WAAW,QAAQ,EAAE,GACrB,YAAY,GACZ,WAAW,GACX,eAAe,GACf,gBAAgB,GAChB,aAAa,GACb,iBAAiB,GACjB,cAAc,GACd,WAAW,GACX,UAAU,GACV,UAAU,GACV,WAAW,CAAA;AA8Bf,wBAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,UAAU,CAAC,WAAW,CAAC,CA0BnJ;AAMD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,cAAc,CAAC,CAexE;AA4DD,eAAO,MAAM,UAAU,YAAI,OAAO,EAAE,KAAK,EAAE,MAAM,CAAU,CAAA"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/runtime/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAE9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAK7D,MAAM,MAAM,WAAW,GACnB,WAAW,QAAQ,EAAE,GACrB,YAAY,GACZ,WAAW,GACX,eAAe,GACf,gBAAgB,GAChB,aAAa,GACb,iBAAiB,GACjB,cAAc,GACd,WAAW,GACX,UAAU,GACV,UAAU,GACV,WAAW,CAAA;AAEf,eAAO,MAAM,gBAAgB,EAAE,SAAS,WAAW,EAAsE,CAAA;AA8BzH,wBAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,UAAU,CAAC,WAAW,CAAC,CA0BnJ;AAMD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,cAAc,CAAC,CAexE;AA4DD,eAAO,MAAM,UAAU,YAAI,OAAO,EAAE,KAAK,EAAE,MAAM,CAAU,CAAA"}

package/runtime/hooks.js

@@ -3,6 +3,7 @@ import { 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'];
 const flags = ['suppressOriginalPrompt', 'reloadSkills', 'retry'];
 const readFields = {
     SessionStart: ['additionalContext', 'initialUserMessage', 'sessionTitle', 'watchPaths', 'reloadSkills'],

package/runtime/lifecycle.d.ts

@@ -20,5 +20,5 @@ export type Lifecycle<State extends object> = {
     route<N extends RoutedEvent>(event: N, e: Frozen<Args<N>>, next: RouterNext<N>): Promise<EventResult<N>>;
 };
 export declare function readPlugin(claude: Claude): Promise<Plugin>;
-export declare function createLifecycle<State extends object>(definition: ModDefinition<State>): Lifecycle<State>;
+export declare function createLifecycle<State extends object>(definition: ModDefinition<State>, checksPermissions?: () => boolean): Lifecycle<State>;
 //# sourceMappingURL=lifecycle.d.ts.map

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,EAA8B,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AACzE,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;AAgCD,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,GAAG,SAAS,CAAC,KAAK,CAAC,CAkOxG"}
+{"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"}

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, userSkillHook } from './hooks.js';
+import { classicHook, permissionEvents, userSkillHook } from './hooks.js';
 import { createRouter } from './router.js';
 import { createState } from './state.js';
 import { toolCalls } from './tool-calls.js';
@@ -79,7 +79,7 @@ async function cmodVersion(claude) {
         throw new Error(`cmod --version ${formatExit(result.exitCode, lastLineOf(result.stderr) ?? '')}`);
     return result.stdout.trim().split(/\s+/).at(-1);
 }
-export function createLifecycle(definition) {
+export function createLifecycle(definition, checksPermissions = () => true) {
     let router = createRouter();
     let phase = 'starting';
     let runtime;
@@ -95,7 +95,7 @@ export function createLifecycle(definition) {
     const startSettled = new Promise((resolve) => (settleStart = resolve));
     const claude = () => {
         if (runtime === undefined)
-            throw new Error(`${definition.name}: the lifecycle has not started. connect(on, mod) starts it at session.start.`);
+            throw new Error(`${definition.name}: the lifecycle has not started. registerMod(addHook, mod) starts it at session.start.`);
         return runtime.claude;
     };
     const showLine = () => {
@@ -127,7 +127,7 @@ export function createLifecycle(definition) {
     };
     const record = () => {
         recording ??= recordThroughCmod()
-            .catch((error) => claude().ui.log(`${definition.name} has no CMod record yet: ${messageOf(error)}`, { to: 'debug' }))
+            .catch((error) => claude().ui.log(`${definition.name} has no cmod record yet: ${messageOf(error)}`, { to: 'debug' }))
             .finally(() => {
             recording = undefined;
         });
@@ -136,7 +136,7 @@ export function createLifecycle(definition) {
         if (runtime === undefined || plugin === undefined)
             return;
         const activeRouter = createRouter();
-        const active = await createMod(definition, { ...runtime, router: activeRouter, dataFolder: dataFolder(plugin.store, plugin.name) }).catch((error) => {
+        const active = await createMod(definition, { ...runtime, router: activeRouter, dataFolder: dataFolder(plugin.store, plugin.name), checksPermissions }).catch((error) => {
             fail(messageOf(error), 'Fix it, then run /reload-plugins.');
             throw error;
         });
@@ -186,7 +186,7 @@ export function createLifecycle(definition) {
             return bootstrap(plugin.root);
         phase = 'installing';
         if ((await cmodVersion(claude())) === undefined)
-            return waitForCMod();
+            return waitForcmod();
         endLine();
         const progress = showLine();
         let outcome;
@@ -205,9 +205,9 @@ export function createLifecycle(definition) {
         const reason = outcome?.kind === 'failed' ? outcome.message : `cmod setup ${formatExit(code, lastError)}`;
         fail(reason, `Fix the cause, then run: cmod install ${definition.name}`);
     };
-    const waitForCMod = () => {
+    const waitForcmod = () => {
         phase = 'waiting';
-        showLine().wait('Waiting for CMod');
+        showLine().wait('Waiting for cmod');
         let check;
         const stop = () => {
             timer.cancel();
@@ -227,7 +227,7 @@ export function createLifecycle(definition) {
                 report(error);
             });
         });
-        const longWait = claude().clock.after(cmodWaitMs, () => showLine().wait("Still waiting for CMod to download cmod. See CMod's own line."));
+        const longWait = claude().clock.after(cmodWaitMs, () => showLine().wait("Still waiting for cmod to download cmod. See cmod's own line."));
     };
     const bootstrap = async (root) => {
         const progress = showLine();
@@ -429,6 +429,10 @@ async function createMod(definition, runtime) {
     };
     await failsAs('its state did not load', () => modState.load());
     await failsAs('its setup function threw', () => definition.setup(mod));
+    const permissionHooks = permissionEvents.filter((event) => router.has(event));
+    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`);
+    }
     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/router.d.ts

@@ -4,6 +4,7 @@ export type RouterNext<N extends RoutedEvent> = (e: Frozen<Args<N>>) => Promise<
 export type RoutedHook<N extends RoutedEvent> = (e: Frozen<Args<N>>, next: RouterNext<N>) => EventResult<N> | Promise<EventResult<N>>;
 export type Router = {
     add<N extends RoutedEvent>(event: N, hook: RoutedHook<N>): void;
+    has(event: RoutedEvent): boolean;
     dispatch<N extends RoutedEvent>(event: N, e: Frozen<Args<N>>, next: RouterNext<N>): Promise<EventResult<N>>;
 };
 export declare function createRouter(): Router;

package/runtime/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/runtime/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;AAE/F,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;AAErI,MAAM,MAAM,MAAM,GAAG;IACnB,GAAG,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IAC/D,QAAQ,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;CAC5G,CAAA;AAID,wBAAgB,YAAY,IAAI,MAAM,CAmBrC"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/runtime/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;AAE/F,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;AAErI,MAAM,MAAM,MAAM,GAAG;IACnB,GAAG,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IAC/D,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAA;IAChC,QAAQ,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;CAC5G,CAAA;AAID,wBAAgB,YAAY,IAAI,MAAM,CAoBrC"}

package/runtime/router.js

@@ -6,6 +6,7 @@ export function createRouter() {
             chain.push(hook);
             hooks.set(event, chain);
         },
+        has: (event) => hooks.has(event),
         dispatch(event, e, next) {
             const chain = hooks.get(event);
             const call = async (index, current) => {

package/runtime/tool-calls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-calls.d.ts","sourceRoot":"","sources":["../src/runtime/tool-calls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,MAAM,MAAM,KAAK,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5D,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IACtD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAC7C,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAAkD,CAAA;AAE5F,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAErE;AAMD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAiDnE"}
+{"version":3,"file":"tool-calls.d.ts","sourceRoot":"","sources":["../src/runtime/tool-calls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,MAAM,MAAM,KAAK,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5D,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IACtD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAC7C,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAAkD,CAAA;AAE5F,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAErE;AAMD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CA8CnE"}

package/runtime/tool-calls.js

@@ -20,6 +20,12 @@ export function toolCalls(claude, router) {
         return next(e);
     });
     router.add('tool.call', async (e, next) => {
+        cwds.set(e.tool_use_id, await claude.session.cwd());
+        for (const oldest of cwds.keys()) {
+            if (cwds.size <= keptCalls)
+                break;
+            cwds.delete(oldest);
+        }
         if (e.agentId === undefined)
             return next(e);
         agentIds.set(e.tool_use_id, e.agentId);
@@ -30,15 +36,6 @@ export function toolCalls(claude, router) {
             agentIds.delete(e.tool_use_id);
         }
     });
-    router.add('classic.PreToolUse', async (e, next) => {
-        cwds.set(e.tool_use_id, await claude.session.cwd());
-        for (const oldest of cwds.keys()) {
-            if (cwds.size <= keptCalls)
-                break;
-            cwds.delete(oldest);
-        }
-        return next(e);
-    });
     for (const event of ['classic.PostToolUse', 'classic.PostToolUseFailure']) {
         router.add(event, async (e, next) => {
             try {

package/src/records.ts

@@ -28,7 +28,7 @@ export function storeFolder(env: Record<string, string | undefined>): string {
   const dataHome = env['XDG_DATA_HOME']
   const home = env['HOME']
   if (dataHome) return `${dataHome}/cmod`
-  if (!home) throw new Error('Neither XDG_DATA_HOME nor HOME is set, so the CMod store has no folder. Set HOME.')
+  if (!home) throw new Error('Neither XDG_DATA_HOME nor HOME is set, so the cmod store has no folder. Set HOME.')
   return `${home}/.local/share/cmod`
 }
 
@@ -81,7 +81,7 @@ function parseRecord(text: string, path: string): InstallRecord {
   } catch (error) {
     throw new Error(`${path} is not JSON (${messageOf(error)}). ${fix}`)
   }
-  if (!isObject(value)) throw new Error(`${path} is not a CMod install record. ${fix}`)
+  if (!isObject(value)) throw new Error(`${path} is not a cmod install record. ${fix}`)
   for (const key of ['name', 'version', 'root', 'installedAt', 'scriptsSha256'] as const) {
     if (typeof value[key] !== 'string') throw new Error(`${path} has no "${key}" text. ${fix}`)
   }
@@ -117,7 +117,7 @@ function readCommand(steps: Record<string, unknown>, key: 'install' | 'uninstall
   if (typeof command !== 'string' || command.trim() === '') throw new Error(`package.json "cmod.${key}" must be a command, such as "./setup/${key}.sh".`)
   if (/[\n\t]/.test(command)) throw new Error(`package.json "cmod.${key}" holds a line break or a tab. Write one command, such as "./setup/${key}.sh".`)
   const atRoot = scriptPaths(command).find((path) => folderOf(path) === '.')
-  if (atRoot !== undefined) throw new Error(`package.json "cmod.${key}" names ${atRoot}, a script at the plugin root. Move it into a folder, such as ./setup/${key}.sh: CMod asks consent for the whole folder of each script.`)
+  if (atRoot !== undefined) throw new Error(`package.json "cmod.${key}" names ${atRoot}, a script at the plugin root. Move it into a folder, such as ./setup/${key}.sh: cmod asks consent for the whole folder of each script.`)
   return { [key]: command }
 }
 

package/src/{connect.ts → register.ts}

@@ -6,6 +6,8 @@ import { createLifecycle, readPlugin, type Lifecycle } from './runtime/lifecycle
 
 let lifecycle: Lifecycle<object>
 
+let checksPermissions = false
+
 async function startMod($: EngineInterface, eventInput: Frozen<Args<'session.start'>>, passOn: Next<'session.start'>): Promise<EventResult<'session.start'>> {
   const claude: Claude = {
     plugin: { name: $.plugin.name, root: $.plugin.root },
@@ -71,34 +73,39 @@ function routeToMod<N extends RoutedEvent>(_$: EngineInterface, eventInput: Froz
   return lifecycle.route(passOn.event, eventInput, (passed: unknown) => passOn(passed as Args<N>) as Promise<EventResult<N>>)
 }
 
-export function connect<State extends object>(on: On, definition: ModDefinition<State>): void {
-  lifecycle = createLifecycle(definition)
-  on('session.start', startMod)
-  on('classic.SessionStart', routeToMod)
-  on('classic.SessionEnd', routeToMod)
-  on('classic.UserPromptSubmit', routeToMod)
-  on('classic.InstructionsLoaded', routeToMod)
-  on('classic.PreToolUse', routeToMod)
-  on('classic.PermissionRequest', routeToMod)
-  on('classic.PermissionDenied', routeToMod)
-  on('classic.PostToolUse', routeToMod)
-  on('classic.PostToolUseFailure', routeToMod)
-  on('classic.PostToolBatch', routeToMod)
-  on('classic.SubagentStart', routeToMod)
-  on('classic.SubagentStop', routeToMod)
-  on('classic.Notification', routeToMod)
-  on('classic.PreCompact', routeToMod)
-  on('classic.Stop', routeToMod)
-  on('classic.StopFailure', routeToMod)
-  on('tool.check', routeToMod)
-  on('tool.call', routeToMod)
-  on('prompt.submit', routeToMod)
-  on('prompt.context', routeToMod)
-  on('command.run', routeToMod)
-  on('session.measure', routeToMod)
-  on('skill.prompt', routeToMod)
-  on('ui.render', routeToMod)
-  on('ui.press', routeToMod)
-  on('ui.close', routeToMod)
-  on('cmod.call', routeToMod)
+export function registerMod<State extends object>(addHook: On, definition: ModDefinition<State>): void {
+  checksPermissions = false
+  lifecycle = createLifecycle(definition, () => checksPermissions)
+  addHook('session.start', startMod)
+  addHook('classic.SessionStart', routeToMod)
+  addHook('classic.SessionEnd', routeToMod)
+  addHook('classic.UserPromptSubmit', routeToMod)
+  addHook('classic.InstructionsLoaded', routeToMod)
+  addHook('classic.PermissionDenied', routeToMod)
+  addHook('classic.PostToolUse', routeToMod)
+  addHook('classic.PostToolUseFailure', routeToMod)
+  addHook('classic.PostToolBatch', routeToMod)
+  addHook('classic.SubagentStart', routeToMod)
+  addHook('classic.SubagentStop', routeToMod)
+  addHook('classic.Notification', routeToMod)
+  addHook('classic.PreCompact', routeToMod)
+  addHook('classic.Stop', routeToMod)
+  addHook('classic.StopFailure', routeToMod)
+  addHook('tool.call', routeToMod)
+  addHook('prompt.submit', routeToMod)
+  addHook('prompt.context', routeToMod)
+  addHook('command.run', routeToMod)
+  addHook('session.measure', routeToMod)
+  addHook('skill.prompt', routeToMod)
+  addHook('ui.render', routeToMod)
+  addHook('ui.press', routeToMod)
+  addHook('ui.close', routeToMod)
+  addHook('cmod.call', routeToMod)
+}
+
+export function registerPermissionCheck(addHook: On): void {
+  checksPermissions = true
+  addHook('tool.check', routeToMod)
+  addHook('classic.PreToolUse', routeToMod)
+  addHook('classic.PermissionRequest', routeToMod)
 }

package/src/runtime/hooks.ts

@@ -22,6 +22,8 @@ export type RoutedEvent =
   | 'ui.close'
   | 'cmod.call'
 
+export const permissionEvents: readonly RoutedEvent[] = ['tool.check', 'classic.PreToolUse', 'classic.PermissionRequest']
+
 type ClassicFields = Record<string, unknown>
 
 type PreToolUseInput = Parameters<ModHook<'PreToolUse'>>[0]