@cmodjs/core 0.1.14 → 0.2.0

package/docs/options.md

@@ -0,0 +1,93 @@
+# Options
+
+An option is a value a person sets for a mod and the mod reads, such as a token, a URL, or how often to check. The mod declares its options in `defineMod`, and `mod.options` holds their values, typed from the declaration. Claude Code stores them: it shows each one in `/config`, keeps a secret in the system keychain, and reloads the mod when one changes.
+
+`mod.state` is the other kind of value: what the mod owns and changes as it runs ([state.md](state.md)).
+
+## Declare the options
+
+```ts
+import { defineMod } from '../node_modules/@cmodjs/core/mod.js'
+import { option } from '../node_modules/@cmodjs/core/options.js'
+
+export const ciWatch = defineMod({
+  name: 'ci-watch',
+  options: {
+    githubToken: option.secret({ title: 'GitHub token', description: 'Reads your CI runs' }),
+    every: option.number({ title: 'Check every', description: 'Minutes between checks', default: 10, min: 1 }),
+    branch: option.text({ title: 'Branch', description: 'The branch to watch', default: 'main' }),
+  },
+  setup(mod) {
+    mod.ui.toast(`Watching ${mod.options.branch} every ${mod.options.every} minutes`)
+  },
+})
+```
+
+`mod.options.every` is a `number` and `mod.options.branch` a `string`, so `tsc` catches a typo or a wrong type.
+
+| Helper | The value | Claude Code shows it as |
+| --- | --- | --- |
+| `option.text({ title, description, default? })` | `string` | a text field |
+| `option.secret({ title, description })` | `string` | a masked field, kept in the keychain |
+| `option.number({ title, description, default?, min?, max? })` | `number` | a number field |
+| `option.toggle({ title, description, default? })` | `boolean`, `false` unless `default` says otherwise | a toggle |
+| `option.choice(choices, { title, description, default? })` | one of `choices` | a picker |
+| `option.folder({ title, description, default? })` | `string`, a folder path | a folder field |
+| `option.file({ title, description, default? })` | `string`, a file path | a file field |
+| `option.list({ title, description, default? })` | `readonly string[]` | a list of text |
+
+- An option name is letters, digits, and `_`, starting with a letter, because Claude Code passes each option on as `CLAUDE_PLUGIN_OPTION_<NAME>`. `defineMod` throws for another name.
+- `title` is the label `/config` shows. `description` is the help text under it.
+- A secret has no default, so a token never ships in the mod.
+
+## Where the values come from
+
+Each value is, in order of precedence:
+
+1. A value the person's organization set in managed settings. `/config` shows it locked.
+2. The value in the project's `options.json`.
+3. The value the person set in `/config`.
+4. The `default` in the declaration.
+
+An option with no default and no value is asked before `setup` runs, on a page of the installer pane: one field per option, each saved to `/config` as the person submits it. A secret is set in `/config` itself, where Claude Code keeps it in the keychain, and the page says so. When the person chooses Not now, or no one can answer, as in `claude -p`, the mod does not start: its progress line says `it needs <title>` and `Set it in /config.`, and Claude Code reloads the mod once the value is set.
+
+`cmod install`, `cmod link`, and `cmod try` set options from the terminal with `--option key=value`, once per option ([commands.md](commands.md)).
+
+`mod.options` follows the values while the session runs. Read an option where you use it, as in `mod.options.branch`, so a change applies at once. A change in `/config` reloads the mod, and a `/cd` reads the new project's `options.json`.
+
+## Set options for a team
+
+A project sets options for everyone who works in it with an `options.json` in its config folder, committed with the repository:
+
+```text
+<project>/.claude/cmods/<mod>/options.json
+```
+
+```json
+{ "branch": "release", "every": 5 }
+```
+
+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
+- an option the mod does not declare
+- a secret, because the file is committed for everyone to read
+- a value the option does not take, such as `0` for an option with `min: 1`
+
+## plugin.json userConfig
+
+Claude Code reads a plugin's options from `userConfig` in `.claude-plugin/plugin.json` before it loads the mod. `cmod check` writes `userConfig` from the options `defineMod` declares, so the declaration is the one place to change them. `cmod publish` refuses a `plugin.json` whose `userConfig` differs: run `cmod check`, then commit `.claude-plugin/plugin.json`.
+
+`cmod check` never writes `required`, because Claude Code refuses to load a mod while a required option has no value. cmod asks for an option with no default instead.
+
+`userConfigOf(options)`, exported from `options.js`, returns the `userConfig` for a declaration.
+
+## Test options
+
+`testMod(mod, { options: { githubToken: 'ghp_test' } })` starts the tested mod with those values, as Claude Code passes them. Each option left out gets its default. A test that leaves out an option with no default fails with `<mod> needs <title>, which a person sets in /config. Give it to the tested mod: testMod(mod, { options: { <key>: … } }).` `fakes.config.list` answers the `/config` rows, so a test can lock a value as managed settings do ([testing.md](testing.md)).
+
+```ts
+const tested = testMod(ciWatch, { options: { githubToken: 'ghp_test', branch: 'develop' } })
+await tested.start()
+expect(tested.shown.toasts).toContain('Watching develop every 10 minutes')
+```

package/docs/permissions.md

@@ -0,0 +1,88 @@
+# Permissions
+
+A mod declares what it does beyond drawing and answering hooks: the hosts it connects to, the programs it runs, the files it changes outside its project, and whether it reads the conversation, adds text Claude reads, asks a model, starts agents, uses Claude's tools, changes Claude Code's settings, or approves tool calls. The person sees each permission as one sentence when they install the mod, turns each one on or off in `/mods`, and cmod checks every call and every answer against what they granted.
+
+Permissions bind every mod built on `@cmodjs/core`, and the plugin directory reads them from `package.json`. They are a contract, not a sandbox: a Claude Code plugin can skip cmod and call Claude Code directly.
+
+## Declare the permissions
+
+They sit in the `package.json` `cmod` key, beside `install` and `keys`, because the person reads them before any of the mod's code runs:
+
+```json
+"cmod": {
+  "permissions": { "network": ["api.github.com"], "run": ["gh"], "prompt": true, "model": true }
+}
+```
+
+| Permission | The person reads | cmod checks |
+| --- | --- | --- |
+| `"network": ["api.github.com"]` | Connect to api.github.com | `mod.http.fetch` to that host. A path starting with `/` or `~/` names a socket, such as `"~/.docker/run/docker.sock"` |
+| `"run": ["gh"]`, or `"run": "*"` | Run gh on your computer | `mod.process.run`, `mod.process.spawn`, and the `program` and `check` jobs. A program matches by its file name, so `"mermaid-ascii"` covers `${mod.dataFolder}/bin/mermaid-ascii` |
+| `"files": ["~/.zshrc"]` | Change ~/.zshrc | `mod.fs.write` and `mod.metadata.update` outside the project and the mod's data folder. A folder covers every file below it |
+| `"conversation": true` | Read this conversation | `mod.session.messages`, and reading Claude Code's transcript files |
+| `"prompt": true` | Add text Claude reads and start turns | `mod.session.append`, `mod.session.submit`, the `prompt` and `schedule` jobs, and the hook answers listed below |
+| `"model": true` | Ask a model, which uses your plan | `mod.model.complete` |
+| `"agents": true` | Start agents | `mod.agent.spawn` |
+| `"tools": true` | Use and change Claude's tool calls | `mod.claude.tool.call`, and a hook that changes a tool call's input |
+| `"config": true` | Change your Claude Code settings | `mod.claude.config.set`, and writes to `.claude/settings.json`, `.claude/settings.local.json`, and `.mcp.json` |
+| `"approve": true` | Approve Claude's tool calls for you | an allow or an ask from the mod's permission rules or hooks, and a `retry`. A deny needs no permission |
+
+Reading files, drawing panes and slot renders, toasts, slash commands, tools of the mod's own, and hooks need no permission.
+
+`cmod check` adds `"approve": true` to `package.json` when `hooks/register.ts` calls `registerPermissionCheck` and the line is missing, and says so.
+
+## What the person sees
+
+The install opens the installer pane in Claude Code and lists every permission in `permissions`, with the install step, the program, and the keys. An update asks again only when it adds a permission, and lists only the new ones. Removing the mod revokes everything it was granted.
+
+`/mods <mod>` lists the same permissions as toggles. A toggle runs `cmod permission <mod> <name> [value] on|off`, and the mod sees the change before its next call, with no reload.
+
+`cmod check` prints the sentences, so you read what the person will see:
+
+```text
+✔ At install the person grants: Connect to api.github.com; Run gh on your computer; Ask a model, which uses your plan
+```
+
+## Check a permission before a feature uses it
+
+```ts
+mod.permissions.has(name: 'network' | 'run' | 'files', value: string): boolean
+mod.permissions.has(name: 'conversation' | 'prompt' | 'model' | 'agents' | 'tools' | 'config' | 'approve'): boolean
+```
+
+`has` says whether the person has the permission turned on, so a mod hides a feature instead of failing it:
+
+```ts
+if (mod.permissions.has('model')) {
+  const verdict = await mod.model.complete({ prompt: 'Is this reply a waste of time?' })
+}
+```
+
+## When a call has no grant
+
+The call rejects, and the error names the fix:
+
+- An undeclared call names the line to add: `ci-watch calls http.fetch(https://api.github.com/repos), which needs "permissions": { "network": ["api.github.com"] } in package.json "cmod".`
+- A declared call the person turned off names where to turn it on: `ci-watch calls model.complete without your grant to "Ask a model, which uses your plan". Turn it on in /mods ci-watch.`
+- A `program` job without its grant stops at once with the same line, with no restarts.
+
+## When a hook answer has no grant
+
+cmod checks the answer each hook returns, part by part. A part without its grant is dropped, and cmod logs once per permission which part it dropped and how to fix it:
+
+```text
+ci-watch answered additionalContext without your grant to "Add text Claude reads and start turns", so cmod dropped it. Turn it on in /mods ci-watch.
+```
+
+| Answer part | Permission |
+| --- | --- |
+| `additionalContext`, `initialUserMessage`, `suppressOriginalPrompt`, `updatedToolOutput`, a `prompt` job's text | `prompt` |
+| a Stop or PostToolUse block | `prompt` |
+| `updatedInput`, and a changed tool input passed down the chain | `tools` |
+| an allow or an ask, and `retry` | `approve` |
+
+A deny needs no permission. A tool of the mod's own, `mcp__<mod>__*`, answers freely.
+
+## Test permissions
+
+`testMod` grants what the mod's `package.json` declares, so tests run as an installed mod does. An undeclared call fails the test with the line to add. `testMod(mod, { permissions: ['network:api.github.com'] })` grants exactly the list instead, so a test checks what happens with a permission turned off ([testing.md](testing.md)).

package/docs/state.md

@@ -80,16 +80,11 @@ export const reads = defineMod({
 
 ## Where the values come from
 
-When the mod starts, each value is, in order of precedence:
+When the mod starts, each value is the value the mod saved for this session, this project, or globally, or else the starting value in `defineMod`. After a `/cd` to another project, cmod loads that project's `project` values.
 
-1. The value the mod saved for this session, this project, or globally.
-2. The value in the project's `state.json`.
-3. The value in the person's own `state.json`.
-4. The starting value in `defineMod`.
+`mod.state` holds what the mod owns and changes as it runs. What a person sets, such as a token or a branch to watch, is an option ([options.md](options.md)).
 
-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
+## Let a person replace a Skill's text
 
 Each mod has two config folders, outside its code:
 
@@ -98,29 +93,7 @@ Each mod has two config folders, outside its code:
 <project>/.claude/cmods/<mod>/      the team's, committed with the repository
 ```
 
-`CLAUDE_CONFIG_DIR` moves `~/.claude`. Removing the mod keeps both folders.
-
-A `state.json` in either folder lists only the values to change:
-
-```json
-{ "global": { "defaultCommitPolicy": "never" }, "session": { "prompts": 10 } }
-```
-
-- A `session` value is what each new conversation starts with. A `project` value is what each project starts with.
-- A file in the project folder wins over the same value in the person's folder.
-- 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:
-
-- a file that is not JSON, or not a JSON object
-- a group the mod does not declare
-- a key the mod does not declare
-- a value whose type differs from the starting value's
-- a `global` value in a project file
-- a `memory` value
-
-## Let a person replace a Skill's text
+`CLAUDE_CONFIG_DIR` moves `~/.claude`. Removing the mod keeps both folders. The project folder also holds the team's options, in `options.json` ([options.md](options.md)).
 
 A person replaces the text of a Skill the mod ships by putting a file at the same path in a config folder:
 

package/docs/testing.md

@@ -3,7 +3,7 @@
 `testMod` runs a mod against a fake Claude Code in `bun test`, so a test drives the mod the way a person and Claude do and reads what they would see. It needs no running Claude Code.
 
 ```ts
-testMod<State>(definition: ModDefinition<State>, options?: TestOptions<State>): TestedMod<State>
+testMod<State, Options>(definition: ModDefinition<State, string, Options>, options?: TestOptions<State, Options>): TestedMod<State>
 ```
 
 ```ts
@@ -24,24 +24,30 @@ Assert what a person or Claude sees: `tested.lines(...)`, `tested.shown`, `teste
 ## TestOptions
 
 ```ts
-type TestOptions<State> = {
+type TestOptions<State, Options> = {
   readonly state?: { [Lifetime in keyof State]?: Partial<State[Lifetime]> }
+  readonly options?: Partial<OptionValues<Options>>
+  readonly permissions?: readonly string[]
   readonly scope?: 'user' | 'project'
   readonly projectRoot?: string
   readonly cwd?: string
   readonly dependencies?: { [Name in keyof CmodDependencies]?: CmodDependencies[Name] }
   readonly files?: Readonly<Record<string, string>>
+  readonly links?: Readonly<Record<string, string>>
 }
 ```
 
 | Option | What it sets | Default |
 | --- | --- | --- |
 | `state` | Values over the declared starting state | The declared state |
+| `options` | The option values Claude Code passes, as a person set them ([options.md](options.md)) | none: each option gets its default |
+| `permissions` | Exactly the permissions the person granted, such as `['network:api.github.com', 'model']` ([permissions.md](permissions.md)) | every permission the mod's `package.json` declares |
 | `scope` | `'project'` makes the mod a project plugin, in `<projectRoot>/.claude/skills/<name>` | `'user'` |
 | `projectRoot` | `mod.projectRoot` | `/test/plugins/<name>`, or `/test/project` for a project plugin |
 | `cwd` | `mod.cwd` | `projectRoot` |
 | `dependencies` | The methods other mods answer with | none: every call fails with `<name> is not installed. Run cmod install <name>.` |
 | `files` | The fake file system, absolute path to text | no files |
+| `links` | Symbolic links in the fake file system, absolute link path to its target | no links |
 
 A project plugin finds its repository through a `.git` entry at `projectRoot`, so a test of one puts it in `files`, such as `files: { '/test/project/.git': '' }`. Without it the project plugin has no repository, and its rules match calls in every folder, as a user mod's do.
 
@@ -213,6 +219,7 @@ type Fakes = {
   fs: { read?, write?, list?, exists?, stat? }
   http: { fetch? }
   settings: { read? }
+  config: { list?, set? }
   ui: { ask?, open?, scroll? }
   session: { messages?, append? }
   prompt: { submit? }
@@ -234,7 +241,11 @@ Set a fake to answer a call:
 - `clock.after(ms, fn)` and `clock.every(ms, fn)` each return `{ cancel() }`, and so must a fake of either. `clock.after` runs a real timer by default. `clock.every` never fires unless a fake keeps `fn` for the test to call, so a test of `mod.every` keeps it and calls it once per tick.
 - `session.append` and `prompt.submit` take every note and prompt by default, into `shown.notes` and `shown.prompts`. A fake that answers `{ deny }` or `{ drop }` refuses one.
 - `model.complete` has no default: set it to the answer the model gives, such as `async () => ({ isAnswered: true, text: 'no', usage })`.
+- `config.list` answers no `/config` rows by default, and `config.set` answers every change with `{ value }`. A `config.list` fake that answers a row with `isLocked: true` locks that option as managed settings do.
 - `tool.call` answers `CronCreate`, `CronDelete`, and `CronList` by default, keeping the crons a `schedule` makes in `shown.schedules`. A call to any other tool needs a fake.
+- `files` takes symbolic links too: `testMod(mod, { files, links: { '/work/skills': '/shared/skills' } })` makes `/work/skills` a link to `/shared/skills`, so a test of `mod.fs.find` or `mod.metadata.update` follows it as a real file system does.
+- `testMod` runs no installer pane: an option with no default and no value fails `start()` with its fix, and the `installer` steps are not shown. Test a step's `render` and `isDone` by calling them with the started `mod`.
+- The `committer` below runs `git`, so its `package.json` declares `"permissions": { "run": ["git"] }`. A gated call the mod does not declare fails before it reaches a fake ([permissions.md](permissions.md)).
 
 ```ts
 import { expect, test } from 'bun:test'

package/installer.d.ts

@@ -0,0 +1,10 @@
+import type { Frozen, RenderElement, RenderPropsOf } from 'claude-code';
+import type { Mod } from './mod.js';
+export type Step<State extends object = Record<never, never>> = {
+    readonly id: string;
+    readonly title: string;
+    render(mod: Mod<State>, props: Frozen<RenderPropsOf['Pane']>): RenderElement;
+    isDone(mod: Mod<State>): boolean | Promise<boolean>;
+};
+export declare function defineStep<State extends object = Record<never, never>>(step: Step<State>): Step<State>;
+//# sourceMappingURL=installer.d.ts.map

package/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["src/installer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACvE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAEnC,MAAM,MAAM,IAAI,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI;IAC9D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,aAAa,CAAA;IAC5E,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACpD,CAAA;AAID,wBAAgB,UAAU,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAItG"}

package/installer.js

@@ -0,0 +1,8 @@
+const stepId = /^[A-Za-z0-9_-]{1,64}$/;
+export function defineStep(step) {
+    if (!stepId.test(step.id))
+        throw new Error(`defineStep: "${step.id}" is not a step id. Use 1 to 64 letters, digits, "_", or "-".`);
+    if (step.title.trim() === '')
+        throw new Error(`defineStep: the step "${step.id}" needs a title, the line the installer shows above it.`);
+    return step;
+}

package/jobs/context.d.ts

@@ -3,12 +3,12 @@ import { type Deadline } from '../runtime/deadline.js';
 import type { ToolCall } from '../utils/call-effects.js';
 import { type Workspace } from './permissions/find-project-scope.js';
 import { type Target } from './permissions/match-target.js';
-export declare function workspaceReader({ claude }: JobContext): () => Promise<Workspace>;
+export declare function workspaceReader({ mod: { claude } }: JobContext): () => Promise<Workspace>;
 export declare function afterCall<State extends object>(job: JobContext<State>, contextAfter: (call: ToolCall, workspace: Workspace) => Promise<readonly string[]>, failed: (error: unknown) => readonly string[]): void;
 export declare function modOf<State extends object>(job: JobContext<State>, { call, folder }: {
     readonly call?: ToolCall;
     readonly folder: string;
 }, workspace: Workspace, deadline: Deadline): Mod<State>;
-export declare function modWithin<State extends object>({ mod, claude }: JobContext<State>, deadline: Deadline, workTree?: () => Promise<string | undefined>): Mod<State>;
+export declare function modWithin<State extends object>({ mod }: JobContext<State>, deadline: Deadline, workTree?: () => Promise<string | undefined>): Mod<State>;
 export declare function targetWords(target: Target): string;
 //# sourceMappingURL=context.d.ts.map

package/jobs/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/jobs/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAEhD,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAItE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,qCAAqC,CAAA;AACtF,OAAO,EAAY,KAAK,MAAM,EAAE,MAAM,+BAA+B,CAAA;AAOrE,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,EAAE,UAAU,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAOhF;AAaD,wBAAgB,SAAS,CAAC,KAAK,SAAS,MAAM,EAC5C,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,EACtB,YAAY,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,KAAK,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,EAClF,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS,MAAM,EAAE,GAC5C,IAAI,CAUN;AAMD,wBAAgB,KAAK,CAAC,KAAK,SAAS,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,CAEjM;AAED,wBAAgB,SAAS,CAAC,KAAK,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAyB,GAAG,GAAG,CAAC,KAAK,CAAC,CA0BvL;AAwBD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CASlD"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/jobs/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAEhD,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAItE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,qCAAqC,CAAA;AACtF,OAAO,EAAY,KAAK,MAAM,EAAE,MAAM,+BAA+B,CAAA;AAOrE,wBAAgB,eAAe,CAAC,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAOzF;AAaD,wBAAgB,SAAS,CAAC,KAAK,SAAS,MAAM,EAC5C,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,EACtB,YAAY,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,KAAK,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,EAClF,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS,MAAM,EAAE,GAC5C,IAAI,CAUN;AAMD,wBAAgB,KAAK,CAAC,KAAK,SAAS,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,CAEjM;AAED,wBAAgB,SAAS,CAAC,KAAK,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAyB,GAAG,GAAG,CAAC,KAAK,CAAC,CA4B/K;AAwBD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CASlD"}

package/jobs/context.js

@@ -4,7 +4,7 @@ import { toolInputOf } from '../runtime/tool-calls.js';
 import { listed } from '../utils/text.js';
 import { findProjectScope } from './permissions/find-project-scope.js';
 import { targetOf } from './permissions/match-target.js';
-export function workspaceReader({ claude }) {
+export function workspaceReader({ mod: { claude } }) {
     let session;
     return async () => {
         session ??= readSession(claude);
@@ -25,7 +25,7 @@ async function readSession(claude) {
 }
 export function afterCall(job, contextAfter, failed) {
     const readWorkspace = workspaceReader(job);
-    job.on('tool.call', async (e, next) => {
+    job.mod.claude.on('tool.call', async (e, next) => {
         const before = Promise.all([useOf(job, e), readWorkspace()]);
         await before.catch(() => undefined);
         const result = await next(e);
@@ -41,7 +41,8 @@ async function useOf({ toolCalls }, e) {
 export function modOf(job, { call, folder }, workspace, deadline) {
     return modWithin(job, deadline, async () => workspace.scope?.workTreeOf(call !== undefined && 'path' in call ? call.path : folder));
 }
-export function modWithin({ mod, claude }, deadline, workTree = async () => undefined) {
+export function modWithin({ mod }, deadline, workTree = async () => undefined) {
+    const { claude } = mod;
     const within = (call, task) => beforeDeadline(claude, deadline, call, task);
     const folderOf = async (cwd) => {
         const folder = cwd ?? (await workTree());
@@ -62,6 +63,7 @@ export function modWithin({ mod, claude }, deadline, workTree = async () => unde
             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)),
+            find: (glob) => within('mod.fs.find', mod.fs.find(glob)),
         },
         http: { fetch: (url, init) => within('mod.http.fetch', mod.http.fetch(url, init)) },
         dependencies: dependencyCalls(claude, within),

package/jobs/permissions.js

@@ -27,7 +27,7 @@ export function permissions(rules) {
                 return { decision: 'deny', reason: `The permissions job could not read the session, so it denies the call: ${messageOf(error)}` };
             }
         };
-        job.on('tool.check', async (e, next) => {
+        job.mod.claude.on('tool.check', async (e, next) => {
             const [below, ours] = await Promise.all([next(e), verdictOf(e)]);
             return ours === undefined ? below : stricterVerdict(below, ours);
         });

package/jobs/program.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/jobs/program.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAGpC,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;IACxE,KAAK,IAAI,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACvD,CAAA;AAMD,wBAAgB,OAAO,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,GAAG,CAAC,OAAO,CAAC,CAyErI"}
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/jobs/program.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAIpC,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;IACxE,KAAK,IAAI,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACvD,CAAA;AAMD,wBAAgB,OAAO,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,GAAG,CAAC,OAAO,CAAC,CA2ErI"}

package/jobs/program.js

@@ -1,8 +1,10 @@
+import { PermissionRefused } from '../runtime/grants.js';
 import { messageOf } from '../utils/text.js';
 const backoffSeconds = [1, 2, 4, 8, 16];
 export function program(options) {
     const { command, environment } = options;
-    return ({ mod, claude, announce }) => {
+    return ({ mod, announce }) => {
+        const { claude } = mod;
         const [executable] = command;
         if (executable === undefined)
             throw new Error(`${mod.name}: the program has no command. Name the program on PATH and its arguments, such as ['preview-server', '--port', '0'].`);
@@ -47,6 +49,8 @@ export function program(options) {
                 }
             }
             catch (error) {
+                if (error instanceof PermissionRefused)
+                    return stop(`${messageOf(error)} Add it, then run /reload-plugins.`);
                 lastError = messageOf(error);
             }
             address = undefined;

package/jobs/prompt.js

@@ -15,7 +15,7 @@ export function prompt({ name, prompt: text, when, after }) {
         targetOf(target);
     return (job) => {
         job.reserveName('prompt', name, `prompt: ${job.mod.name} adds the name "${name}" two times. Give each prompt its own name.`);
-        const log = (reason) => job.claude.ui.log(`prompt "${name}" added nothing: ${reason}`, { to: 'debug' });
+        const log = (reason) => job.mod.claude.ui.log(`prompt "${name}" added nothing: ${reason}`, { to: 'debug' });
         const textFor = async (input, mod) => {
             try {
                 const value = typeof text === 'string' ? text : await text(input, mod);
@@ -49,13 +49,13 @@ function addKeptCurrent(job, name, textFor, log) {
     let hasStarted = false;
     let isQueued = false;
     let updates = Promise.resolve();
-    job.on('classic.SessionStart', (e, next) => {
+    job.mod.claude.on('classic.SessionStart', (e, next) => {
         hasStarted = e.source === 'resume' || e.source === 'compact';
         if (!hasStarted)
             given = undefined;
         return next(e);
     });
-    job.on('prompt.context', async (e, next) => {
+    job.mod.claude.on('prompt.context', async (e, next) => {
         const below = await next(e);
         hasStarted = true;
         if (below.blocks.some((block) => block.name === name)) {
@@ -73,7 +73,7 @@ function addKeptCurrent(job, name, textFor, log) {
         if (value === undefined || value === given)
             return;
         given = value;
-        await job.claude.session.append({ message: { type: 'user', content: [{ type: 'text', text: `# ${name}\n${value}` }] } }).then((added) => {
+        await job.mod.claude.session.append({ message: { type: 'user', content: [{ type: 'text', text: `# ${name}\n${value}` }] } }).then((added) => {
             if (added.deny !== undefined)
                 log(`Claude Code refused the new text: ${added.deny}`);
         });
@@ -86,7 +86,7 @@ function addKeptCurrent(job, name, textFor, log) {
     });
 }
 function addAfterUserPrompts(job, when, textFor, log) {
-    job.on('prompt.submit', async (e, next) => {
+    job.mod.claude.on('prompt.submit', async (e, next) => {
         let value;
         try {
             if (typeof when === 'function' ? when(e.text) : e.text.search(when) >= 0)

package/jobs/schedule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../src/jobs/schedule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAIpC,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAIzE,wBAAgB,QAAQ,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,QAAQ,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,QAAQ,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAmDlJ"}
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../src/jobs/schedule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAIpC,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAIzE,wBAAgB,QAAQ,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,QAAQ,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,QAAQ,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAoDlJ"}

package/jobs/schedule.js

@@ -5,7 +5,8 @@ export function schedule(entry) {
     if (typeof entry !== 'function')
         checked(entry);
     return (job) => {
-        const { mod, claude } = job;
+        const { mod } = job;
+        const { claude } = mod;
         const order = scheduleCounts.get(mod) ?? 0;
         scheduleCounts.set(mod, order + 1);
         const storeKey = `cmod:schedule:${order}`;

package/jobs/slash-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slash-command.d.ts","sourceRoot":"","sources":["../src/jobs/slash-command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAMzC,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAA;AAM5E,wBAAgB,YAAY,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE;IACjF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;CAC1H,GAAG,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CA4BnB"}
+{"version":3,"file":"slash-command.d.ts","sourceRoot":"","sources":["../src/jobs/slash-command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAMzC,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAA;AAM5E,wBAAgB,YAAY,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE;IACjF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;CAC1H,GAAG,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CA6BnB"}

package/jobs/slash-command.js

@@ -7,7 +7,8 @@ const commandName = /^[A-Za-z0-9_-]{1,64}$/;
 export function slashCommand(options) {
     const { name, description, argumentHint, immediate, reply } = options;
     return (job) => {
-        const { mod, claude, announce, reserveName } = job;
+        const { mod, announce, reserveName } = job;
+        const { claude } = mod;
         if (!commandName.test(name))
             throw new Error(`${mod.name}: "${name}" is not a slash command name. Use 1 to 64 letters, digits, "_", or "-", without the slash.`);
         reserveName('slashCommand', name, `${mod.name}: the slash command /${name} is already added. Give each slashCommand its own name.`);
@@ -19,7 +20,7 @@ export function slashCommand(options) {
         });
         announce(`/${name}`);
         const replyMod = modWithin(job, deadline);
-        job.on('command.run', async (e, next) => {
+        claude.on('command.run', async (e, next) => {
             if (e.command !== registered)
                 return next(e);
             try {

package/jobs/status-line.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status-line.d.ts","sourceRoot":"","sources":["../src/jobs/status-line.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAKzC,MAAM,MAAM,KAAK,GAAG;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9D,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CACvB,CAAA;AAID,wBAAgB,UAAU,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE;IAC/E,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAClG,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B,GAAG,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAyCnB"}
+{"version":3,"file":"status-line.d.ts","sourceRoot":"","sources":["../src/jobs/status-line.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAKzC,MAAM,MAAM,KAAK,GAAG;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9D,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CACvB,CAAA;AAID,wBAAgB,UAAU,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE;IAC/E,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAClG,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B,GAAG,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CA0CnB"}

package/jobs/status-line.js

@@ -4,7 +4,8 @@ const deadline = { ms: 2000, job: 'statusLine' };
 export function statusLine(options) {
     const { text, interval = 10000 } = options;
     return (job) => {
-        const { mod, claude, announce, reserveName } = job;
+        const { mod, announce, reserveName } = job;
+        const { claude } = mod;
         if (!(interval >= 1))
             throw new Error(`${mod.name}: the status line interval is ${interval}. Give it in milliseconds, 1 or more.`);
         reserveName('statusLine', '', `${mod.name}: a status line is already added. A mod has one status line: join the texts in one statusLine.`);
@@ -33,7 +34,7 @@ export function statusLine(options) {
             queue = queue.then(update);
         };
         announce('a status line');
-        job.on('session.measure', (e, next) => {
+        claude.on('session.measure', (e, next) => {
             refresh();
             return next(e);
         });

package/jobs/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/jobs/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC/D,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AASzC,wBAAgB,IAAI,CAAC,KAAK,CAAC,MAAM,SAAS,MAAM,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,EAAE,KAAK,SAAS,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE;IAC3H,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,SAAS,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,OAAO,CAAA;CAC9G,GAAG,GAAG,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,CAAC,CAoCxC"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/jobs/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC/D,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AASzC,wBAAgB,IAAI,CAAC,KAAK,CAAC,MAAM,SAAS,MAAM,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,EAAE,KAAK,SAAS,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE;IAC3H,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,SAAS,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,OAAO,CAAA;CAC9G,GAAG,GAAG,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,CAAC,CAqCxC"}

package/jobs/tool.js

@@ -7,7 +7,8 @@ const toolName = /^[A-Za-z0-9_-]{1,64}$/;
 export function tool(options) {
     const { name, description, inputSchema, execute } = options;
     return (job) => {
-        const { mod, claude, announce, reserveName } = job;
+        const { mod, announce, reserveName } = job;
+        const { claude } = mod;
         if (!toolName.test(name))
             throw new Error(`${mod.name}: "${name}" is not a tool name. Use 1 to 64 letters, digits, "_", or "-".`);
         const properties = inputSchema?.properties ?? {};
@@ -24,7 +25,7 @@ export function tool(options) {
         });
         announce(`the ${name} tool`);
         const executeMod = modWithin(job, toolDeadline);
-        job.on('tool.call', async (e, next) => {
+        claude.on('tool.call', async (e, next) => {
             if (e.tool !== registered)
                 return next(e);
             const input = toolInputOf(e);