@cmodjs/core 0.3.0 → 1.5.0

package/runtime/metadata.d.ts

@@ -1,5 +1,6 @@
 import type { FileMatch, Metadata } from '../mod.js';
 import type { Claude } from './claude.js';
+import type { Failure } from './toaster.js';
 export type Places = {
     readonly home: string | undefined;
     readonly configRoot: string | undefined;
@@ -11,10 +12,11 @@ export type ModFiles = {
     update(path: string, change: (metadata: Record<string, string>) => void): Promise<void>;
 };
 export declare function resolvedPath(path: string, places: Places): string;
-export declare function createModFiles({ name, claude, places, checkWrite }: {
+export declare function createModFiles({ name, claude, places, checkWrite, report, }: {
     readonly name: string;
     readonly claude: Claude;
     readonly places: Places;
     readonly checkWrite: (path: string) => Promise<void>;
+    readonly report: (failure: Failure) => void;
 }): ModFiles;
 //# sourceMappingURL=metadata.d.ts.map

package/runtime/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/runtime/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAIpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,MAAM,MAAM,MAAM,GAAG;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAAA;IACrE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACrC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxF,CAAA;AAUD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQjE;AAED,wBAAgB,cAAc,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAAG,QAAQ,CAoHhN"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/runtime/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAKpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C,MAAM,MAAM,MAAM,GAAG;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAAA;IACrE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACrC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxF,CAAA;AAUD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CASjE;AAED,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,MAAM,EACN,MAAM,EACN,UAAU,EACV,MAAM,GACP,EAAE;IACD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpD,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CAC5C,GAAG,QAAQ,CA4HX"}

package/runtime/metadata.js

@@ -1,4 +1,5 @@
 import { formatOf, MetadataError, readMetadata, sidecarSuffix, writeMetadata } from '../utils/metadata.js';
+import { expandHome, homePrefix, ifMissing, isMissing } from '../utils/paths.js';
 import { messageOf } from '../utils/text.js';
 import { picomatch, resolve } from '../vendor.js';
 const skippedFolders = ['.git', 'node_modules'];
@@ -7,14 +8,15 @@ export function resolvedPath(path, places) {
     const configured = /^~\/\.claude(?=\/|$)/.exec(path);
     if (configured !== null && places.configRoot !== undefined)
         return resolve(`${places.configRoot}${path.slice(configured[0].length)}`);
-    if (path === '~' || path.startsWith('~/')) {
+    const prefix = homePrefix.exec(path)?.[0];
+    if (prefix !== undefined) {
         if (places.home === undefined)
-            throw new Error(`${path} starts with ~, and HOME is not set. Start Claude Code with HOME set.`);
-        return resolve(`${places.home}${path.slice(1)}`);
+            throw new Error(`${path} starts with ${prefix}, and HOME is not set. Start Claude Code with HOME set.`);
+        return resolve(expandHome(path, places.home, places.configRoot));
     }
     return path.startsWith('/') ? resolve(path) : resolve(places.projectRoot(), path);
 }
-export function createModFiles({ name, claude, places, checkWrite }) {
+export function createModFiles({ name, claude, places, checkWrite, report, }) {
     const prefix = `${name}.`;
     const cache = new Map();
     const logged = new Set();
@@ -27,11 +29,20 @@ export function createModFiles({ name, claude, places, checkWrite }) {
         const extensionless = !realPath.slice(realPath.lastIndexOf('/') + 1).includes('.');
         const firstLine = extensionless ? (await claude.fs.read(realPath)).split('\n', 1)[0] : undefined;
         const format = formatOf(realPath, firstLine);
-        const holder = format.kind === 'sidecar' ? `${realPath}${sidecarSuffix}` : realPath;
-        const sidecar = format.kind === 'sidecar' ? await claude.fs.stat(holder).catch(() => undefined) : undefined;
+        const holder = format.type === 'sidecar' ? `${realPath}${sidecarSuffix}` : realPath;
+        const sidecar = format.type === 'sidecar' ? await claude.fs.stat(holder).catch(ifMissing(undefined)) : undefined;
         return { realPath, format, holder, signature: `${stat.mtimeMs}:${stat.size}:${sidecar?.kind === 'file' ? `${sidecar.mtimeMs}:${sidecar.size}` : ''}` };
     };
-    const textOf = async (holder) => ((await claude.fs.stat(holder).catch(() => undefined))?.kind === 'file' ? claude.fs.read(holder) : '');
+    const textOf = async (holder) => ((await claude.fs.stat(holder).catch(ifMissing(undefined)))?.kind === 'file' ? claude.fs.read(holder) : '');
+    const skipped = (path, value) => (error) => {
+        if (isMissing(error))
+            return value;
+        const reason = `${name}: fs.find skipped ${path}: ${messageOf(error)}`;
+        if (!logged.has(reason))
+            claude.ui.log(reason, { to: 'debug' });
+        logged.add(reason);
+        return value;
+    };
     const readEntry = async (path) => {
         const located = await locate(path);
         const cached = cache.get(path);
@@ -48,7 +59,7 @@ export function createModFiles({ name, claude, places, checkWrite }) {
             const failure = `${located.holder} ${error.message}`;
             read = { metadata: {}, error: failure };
             if (!logged.has(failure))
-                claude.ui.log(`${name}: ${failure}`);
+                report({ id: `metadata:${located.holder}`, message: `Skips the metadata of ${located.holder}`, description: failure });
             logged.add(failure);
         }
         cache.set(path, { signature: located.signature, read });
@@ -58,21 +69,21 @@ export function createModFiles({ name, claude, places, checkWrite }) {
         const absolute = resolvedPath(pattern, places);
         const scanned = picomatch.scan(absolute);
         if (!scanned.isGlob)
-            return (await claude.fs.stat(absolute).catch(() => undefined))?.kind === 'file' ? [absolute] : [];
+            return (await claude.fs.stat(absolute).catch(skipped(absolute, undefined)))?.kind === 'file' ? [absolute] : [];
         const isMatch = picomatch(absolute, { dot: true });
         const entersSkipped = skippedFolders.filter((folder) => scanned.glob.split('/').includes(folder));
         const maxDepth = scanned.glob.includes('**') ? Number.POSITIVE_INFINITY : scanned.glob.split('/').length;
         const found = [];
         const visited = new Set();
         const walk = async (folder, depth) => {
-            const real = (await claude.fs.stat(folder, { resolve: true }).catch(() => undefined))?.realPath ?? folder;
+            const real = (await claude.fs.stat(folder, { resolve: true }).catch(skipped(folder, undefined)))?.realPath ?? folder;
             if (visited.has(real))
                 return;
             visited.add(real);
-            const entries = await claude.fs.list(folder).catch(() => []);
+            const entries = await claude.fs.list(folder).catch(skipped(folder, []));
             await Promise.all(entries.map(async (entry) => {
                 const path = `${folder}/${entry.name}`;
-                const kind = entry.isLink === true ? (await claude.fs.stat(path).catch(() => undefined))?.kind : entry.kind;
+                const kind = entry.isLink === true ? (await claude.fs.stat(path).catch(skipped(path, undefined)))?.kind : entry.kind;
                 if (kind === 'file' && isMatch(path))
                     found.push(path);
                 if (kind !== 'dir' || depth + 1 >= maxDepth)
@@ -83,7 +94,7 @@ export function createModFiles({ name, claude, places, checkWrite }) {
             }));
         };
         const base = scanned.base === '' ? '/' : scanned.base;
-        if ((await claude.fs.stat(base).catch(() => undefined))?.kind === 'dir')
+        if ((await claude.fs.stat(base).catch(skipped(base, undefined)))?.kind === 'dir')
             await walk(base, 0);
         return found;
     };
@@ -93,7 +104,7 @@ export function createModFiles({ name, claude, places, checkWrite }) {
             const paths = [...new Set((await Promise.all(patterns.map(matchesOf))).flat())].sort();
             const kept = paths.filter((path) => !(path.endsWith(sidecarSuffix) && paths.includes(path.slice(0, -sidecarSuffix.length))));
             return Promise.all(kept.map(async (path) => {
-                const read = await readEntry(path);
+                const read = await readEntry(path).catch((error) => ({ metadata: {}, error: `${path} ${messageOf(error)}` }));
                 return { path, ...(read.name === undefined ? {} : { name: read.name }), metadata: own(read.metadata), ...(read.error === undefined ? {} : { error: read.error }) };
             }));
         },

package/runtime/options.d.ts

@@ -1,6 +1,7 @@
 import type { PluginOptions } from 'claude-code';
 import { type Options } from '../options.js';
 import type { Claude } from './claude.js';
+import type { Failure } from './toaster.js';
 export declare class MissingOptions extends Error {
     readonly keys: readonly string[];
     readonly titles: readonly string[];
@@ -11,11 +12,12 @@ export type ModOptions = {
     readonly missing: readonly string[];
     load(root: string): Promise<void>;
 };
-export declare function createOptions({ name, declared, fromClaude, claude, changed }: {
+export declare function createOptions({ name, declared, fromClaude, claude, report, changed, }: {
     readonly name: string;
     readonly declared: Options;
     readonly fromClaude: PluginOptions;
     readonly claude: Claude;
+    readonly report: (failure: Failure) => void;
     readonly changed: () => void;
 }): ModOptions;
 //# sourceMappingURL=options.d.ts.map

package/runtime/options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/runtime/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAoC,KAAK,OAAO,EAAE,MAAM,eAAe,CAAA;AAG9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAElC,YAAY,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,EAI7D;CACF;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAClD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClC,CAAA;AAED,wBAAgB,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,GAAG,UAAU,CAmE3O"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/runtime/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAoC,KAAK,OAAO,EAAE,MAAM,eAAe,CAAA;AAG9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAElC,YAAY,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,EAI7D;CACF;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAClD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClC,CAAA;AAED,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,MAAM,EACN,MAAM,EACN,OAAO,GACR,EAAE;IACD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAC7B,GAAG,UAAU,CAmEb"}

package/runtime/options.js

@@ -10,7 +10,7 @@ export class MissingOptions extends Error {
         this.titles = titles;
     }
 }
-export function createOptions({ name, declared, fromClaude, claude, changed }) {
+export function createOptions({ name, declared, fromClaude, claude, report, changed, }) {
     let values = merged(declared, fromClaude, {}, new Set());
     let locked;
     let loadedRoot;
@@ -31,7 +31,7 @@ export function createOptions({ name, declared, fromClaude, claude, changed }) {
         const path = `${project.folder}/options.json`;
         if (!(await claude.fs.exists(path)))
             return {};
-        const ignore = (reason) => claude.ui.log(`${path} ${reason}`);
+        const ignore = (reason) => report({ id: `options:${path} ${reason}`, message: `Ignores part of ${path}`, description: `${path} ${reason}` });
         let file;
         try {
             file = JSON.parse(await claude.fs.read(path));
@@ -49,7 +49,7 @@ export function createOptions({ name, declared, fromClaude, claude, changed }) {
             const option = declared[key];
             if (option === undefined)
                 ignore(`sets ${key}, which ${name} does not declare. ${Object.keys(declared).length === 0 ? 'Remove it.' : `Remove it, or use one of: ${Object.keys(declared).join(', ')}.`}`);
-            else if (option.kind === 'secret')
+            else if (option.type === 'secret')
                 ignore(`sets ${key}, a secret, and a project file is committed for everyone to read. Remove it, and set it in /config.`);
             else {
                 const misfit = fitsOption(option, value);
@@ -96,5 +96,5 @@ function valueOf(key, option, own, project, locked) {
         return project[key];
     if (!isUnset(own) && fitsOption(option, own) === undefined)
         return Array.isArray(own) ? Object.freeze([...own]) : own;
-    return option.default ?? (option.kind === 'list' ? Object.freeze([]) : option.kind === 'number' ? undefined : '');
+    return option.default ?? (option.type === 'list' ? Object.freeze([]) : option.type === 'number' ? undefined : '');
 }

package/runtime/programs.d.ts

@@ -1,7 +1,15 @@
+import type { HookStream, ProcessSpawnChunk, ProcessSpawnResult } from 'claude-code';
 import type { Claude } from './claude.js';
 export type Programs = {
     readonly claude: Claude;
     refresh(): Promise<void>;
 };
+export declare function lastLineOf(text: string): string | undefined;
+export declare function cmodError(stderr: string, command: string | undefined): string;
+export declare function readLines(stream: HookStream<ProcessSpawnChunk, ProcessSpawnResult>, onLine: (text: string) => void): Promise<{
+    code: number | null;
+    lastError: string;
+}>;
+export declare function runCmod(claude: Claude, args: readonly string[], session: string): Promise<string>;
 export declare function locatingPrograms(claude: Claude): Programs;
 //# sourceMappingURL=programs.d.ts.map

package/runtime/programs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"programs.d.ts","sourceRoot":"","sources":["../src/runtime/programs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAA;AAE5E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAsBzD"}
+{"version":3,"file":"programs.d.ts","sourceRoot":"","sources":["../src/runtime/programs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAIpF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAA;AAE5E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG3D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI7E;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB9K;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKvG;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAsBzD"}

package/runtime/programs.js

@@ -1,4 +1,42 @@
 import { storeFolder } from '../records.js';
+import { ifMissing } from '../utils/paths.js';
+import { formatExit } from '../utils/text.js';
+export function lastLineOf(text) {
+    const trimmed = text.trim();
+    return trimmed === '' ? undefined : trimmed.slice(trimmed.lastIndexOf('\n') + 1).trim();
+}
+export function cmodError(stderr, command) {
+    const line = lastLineOf(stderr) ?? '';
+    const prefix = `cmod ${command}: `;
+    return line.startsWith(prefix) ? line.slice(prefix.length) : line;
+}
+export async function readLines(stream, onLine) {
+    let pending = '';
+    let lastError = '';
+    let piece = await stream.next();
+    while (piece.done !== true) {
+        if (piece.value.stream === 'stderr') {
+            lastError = lastLineOf(piece.value.text) ?? lastError;
+        }
+        else {
+            const lines = `${pending}${piece.value.text}`.split('\n');
+            pending = lines.pop() ?? '';
+            for (const text of lines)
+                onLine(text);
+        }
+        piece = await stream.next();
+    }
+    if (pending !== '')
+        onLine(pending);
+    return { code: piece.value.code, lastError };
+}
+export async function runCmod(claude, args, session) {
+    const lines = [];
+    const { code, lastError } = await readLines(claude.process.spawn({ argv: ['cmod', ...args], env: { CLAUDE_CODE_SESSION_ID: session } }), (line) => void lines.push(line));
+    if (code !== 0)
+        throw new Error(cmodError(lastError, args[0]) || `cmod ${args.slice(0, 2).join(' ')} ${formatExit(code, '')}.`);
+    return lines.join('\n');
+}
 export function locatingPrograms(claude) {
     let folder;
     let names = new Set();
@@ -17,7 +55,7 @@ export function locatingPrograms(claude) {
         async refresh() {
             const [home, dataHome] = await Promise.all([claude.env.home(), claude.env.dataHome()]);
             const programs = `${storeFolder({ HOME: home, XDG_DATA_HOME: dataHome })}/programs`;
-            names = new Set((await claude.fs.list(programs).catch(() => [])).map((entry) => entry.name));
+            names = new Set((await claude.fs.list(programs).catch(ifMissing([]))).map((entry) => entry.name));
             folder = programs;
         },
     };

package/runtime/router.d.ts

@@ -1,9 +1,10 @@
 import type { Args, EventResult, Frozen } from 'claude-code';
+import type { Disposable } from '../mod.js';
 import type { RoutedEvent } from './hooks.js';
 export type RouterNext<N extends RoutedEvent> = (e: Frozen<Args<N>>) => Promise<EventResult<N>>;
 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;
+    add<N extends RoutedEvent>(event: N, hook: RoutedHook<N>): Disposable;
     has(event: RoutedEvent): boolean;
     dispatch<N extends RoutedEvent>(event: N, e: Frozen<Args<N>>, next: RouterNext<N>): Promise<EventResult<N>>;
 };

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,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"}
+{"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,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,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,UAAU,CAAA;IACrE,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,CA0BrC"}

package/runtime/router.js

@@ -2,9 +2,17 @@ export function createRouter() {
     const hooks = new Map();
     return {
         add(event, hook) {
-            const chain = hooks.get(event) ?? [];
-            chain.push(hook);
-            hooks.set(event, chain);
+            const erased = hook;
+            hooks.set(event, [...(hooks.get(event) ?? []), erased]);
+            return {
+                dispose() {
+                    const chain = (hooks.get(event) ?? []).filter((each) => each !== erased);
+                    if (chain.length === 0)
+                        hooks.delete(event);
+                    else
+                        hooks.set(event, chain);
+                },
+            };
         },
         has: (event) => hooks.has(event),
         dispatch(event, e, next) {

package/runtime/sessions.d.ts

@@ -0,0 +1,58 @@
+import { ToolResult } from '../session/context/turn/message/tool-result.js';
+import type { SessionChange, SessionData } from '../session/conversation.js';
+import { type BeforeEvent, type SessionEvent, type Sessions, type Usage } from '../session/session.js';
+import { type SentMatcher } from '../utils/matcher.js';
+import { type Place } from './before.js';
+import type { Claude } from './claude.js';
+export type Subscription = {
+    readonly event: SessionEvent;
+    readonly matcher: SentMatcher | undefined;
+};
+export declare const everySession = "*";
+export declare const conversationMethods: {
+    readonly sessions: 'cmod:sessions';
+    readonly search: 'cmod:search';
+    readonly messages: 'cmod:messages';
+    readonly turns: 'cmod:turns';
+    readonly contexts: 'cmod:contexts';
+    readonly tasks: 'cmod:tasks';
+    readonly goal: 'cmod:goal';
+    readonly updateGoal: 'cmod:updateGoal';
+    readonly usage: 'cmod:usage';
+    readonly subscribe: 'cmod:subscribe';
+    readonly watchBefore: 'cmod:watchBefore';
+    readonly act: 'cmod:act';
+    readonly changed: 'cmod:changed';
+    readonly before: 'cmod:before';
+};
+export type Act = 'send' | 'startTask' | 'callTool' | 'usage' | 'clients';
+export declare const beforePermission: (event: BeforeEvent) => string;
+export declare const isAct: (action: string) => action is Act;
+export declare function toolPermission(tool: string): string | undefined;
+export declare function actPermission(action: Act, input: unknown): string | undefined;
+export type Scope = {
+    readonly session?: string;
+    readonly context?: number;
+    readonly turn?: string;
+    readonly task?: string;
+    readonly isGoal?: true;
+};
+export type SessionsClient = {
+    readonly sessions: Sessions;
+    changed(session: string, change: SessionChange, isInProject: boolean): void;
+    answerBefore(session: string, event: BeforeEvent, change: SessionChange, isInProject: boolean): Promise<unknown>;
+    /** An empty title keeps the title the session already has. */
+    follow(current: Omit<SessionData, 'isRunning' | 'lastAt'>): void;
+};
+export declare function usageOf(claude: Pick<Claude, 'session'>): Promise<Usage>;
+export declare function payloadOf(change: SessionChange): unknown;
+export declare function isHeardBy(event: SessionEvent, matcher: unknown, change: SessionChange): boolean;
+export declare function isInScope(scope: Scope, session: string, change: SessionChange, isUnder: (task: string, ancestor: string) => boolean): boolean;
+export declare function createSessionsClient({ name, claude, report, isGranted }: {
+    readonly name: string;
+    readonly claude: Claude;
+    readonly report: (id: string, message: string, error: unknown) => void;
+    readonly isGranted: (permission: string) => boolean;
+}): SessionsClient;
+export declare function resultOf(where: Pick<Place, 'session' | 'context' | 'turn'>, answered: Awaited<ReturnType<Claude['tool']['call']>>): ToolResult;
+//# sourceMappingURL=sessions.d.ts.map

package/runtime/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/runtime/sessions.ts"],"names":[],"mappings":"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"}