@cmodjs/core 4.0.3 → 4.1.1

package/runtime/lifecycle.js

@@ -1,4 +1,4 @@
-import { consentPath, dataFolder, finishStepsMethod, grantFix, coreVersion, isAtLeast, marketplaceOf, parseConsent, pendingStepsMethod, parseEvent, permissionWords, readRecord, readSteps, recordPath, scriptsSha256, storeFolder, updatesToTurnOn } from '../records.js';
+import { consentPath, dataFolder, finishStepsMethod, grantFix, coreVersion, isAtLeast, isProgramNewer, marketplaceOf, parseConsent, pendingStepsMethod, parseEvent, permissionWords, programPath, readRecord, readSteps, recordPath, scriptsSha256, storeFolder, updatesToTurnOn } from '../records.js';
 import { homePrefix, ifMissing, relativePath } from '../utils/paths.js';
 import { firstLine, formatExit, messageOf } from '../utils/text.js';
 import { beforeDeadline } from './deadline.js';
@@ -8,8 +8,8 @@ import { serveConversations } from './conversations.js';
 import { answerCall, answeringOwnCalls, cmodPluginName, dependencyCalls, withBareRefusals } from './dependencies.js';
 import { keepEngine } from './engine.js';
 import { classicFailure, classicHook, userSkillHook } from './hooks.js';
-import { checkedAnswer, checkingGrants, checkSettings, checksAnswers, checkWrite, isCovered, itemOf, passedDown, programAddresses } from './grants.js';
-import { cmodError, locatingPrograms, readLines } from './programs.js';
+import { checkedAnswer, checkingGrants, checkRun, checkSettings, checksAnswers, checkWrite, isCovered, itemOf, passedDown, programAddresses } from './grants.js';
+import { cmodError, locatingPrograms, readLines, spawnCmod } from './programs.js';
 import { createModFiles, resolvedPath } from './metadata.js';
 import { fitsOption } from '../options.js';
 import { createInstaller } from './installer.js';
@@ -35,6 +35,8 @@ const askingId = 'cmod:asking';
 const recordId = 'cmod:record';
 const installRetrySeconds = [2, 4, 8, 16, 32, 64, 128];
 const cmodCheckMs = 1000;
+const recordCheckMs = 1000;
+const drawsPerMs = 1000;
 const cmodWaitMs = 60_000;
 const cmodSlowCheckMs = 10_000;
 const hookMs = 10_000;
@@ -68,7 +70,8 @@ export async function readPlugin(claude) {
     if (version === undefined || record?.scriptsSha256 !== scripts)
         return { ...plugin, isInstalled: false, shouldRecord: false };
     const isInstalled = record.version === version || record.root === root;
-    return { ...plugin, isInstalled, shouldRecord: isInstalled && record.version !== version };
+    const programModifiedMs = record.program === null ? undefined : (await claude.fs.stat(programPath(store, record.program, record.version)).catch(ifMissing(undefined)))?.mtimeMs;
+    return { ...plugin, isInstalled, shouldRecord: isInstalled && (record.version !== version || isProgramNewer(record, programModifiedMs)) };
 }
 async function filesBelow(claude, folder) {
     const entries = await claude.fs.list(folder);
@@ -121,6 +124,8 @@ export function createLifecycle(definition, permissionRoutes = () => undefined,
     let raise;
     let failure;
     let pluginOptions = options;
+    let drawCount = 0;
+    const nextDraw = () => (drawCount += 1);
     const installer = createInstaller(definition.name, () => claude(), {
         show: (open) => {
             if (phase !== 'active')
@@ -128,7 +133,7 @@ export function createLifecycle(definition, permissionRoutes = () => undefined,
             runtime?.toaster.toast.info('Installing', { id: askingId, description: 'Waiting for your answer', duration: Infinity, action: { label: 'Answer', onClick: open } });
         },
         hide: () => runtime?.toaster.toast.dismiss(askingId),
-    });
+    }, nextDraw);
     let shouldRecord = false;
     let recording;
     let missedSessionStart;
@@ -147,6 +152,7 @@ export function createLifecycle(definition, permissionRoutes = () => undefined,
         failure ??= new Error(`${definition.name}: ${reason}${/[.!?]$/.test(reason) ? '' : '.'}${fix === undefined ? '' : ` ${fix}`}`, { cause: error });
         const again = retry === undefined ? {} : { retry: () => ((failure = undefined), stopRetrying(), retry().catch(report)) };
         toastFailure({ id: installId, message: reason, ...(fix === undefined ? {} : { description: fix }), ...(error === undefined ? {} : { error }), ...again });
+        watchRecord();
     };
     let consented;
     const installAgain = () => install(consented);
@@ -255,29 +261,34 @@ export function createLifecycle(definition, permissionRoutes = () => undefined,
     };
     const runSteps = async (active) => {
         const steps = asksPerson ? (definition.installer ?? []) : [];
-        for (const [index, step] of steps.entries()) {
-            if (await isStepDone(active, step))
-                continue;
-            const isAnswered = (await claude().session.surfaces()).length > 0 && (await installer.step(active, step, index + 1, steps.length));
-            if (!isAnswered) {
-                runtime?.toaster.toast.warning(steps.length - index === 1 ? 'Needs one more step' : `Needs ${steps.length - index} more steps`, {
-                    id: 'cmod:steps',
-                    description: `Starting with ${step.title}.`,
-                    duration: Infinity,
-                    action: { label: 'Finish', onClick: () => runSteps(active) },
-                });
-                break;
+        try {
+            for (const [index, step] of steps.entries()) {
+                if (await isStepDone(active, step))
+                    continue;
+                const isAnswered = (await claude().session.surfaces()).length > 0 && (await installer.step(active, step, index + 1, steps.length));
+                if (!isAnswered) {
+                    runtime?.toaster.toast.warning(steps.length - index === 1 ? 'Needs one more step' : `Needs ${steps.length - index} more steps`, {
+                        id: 'cmod:steps',
+                        description: `Starting with ${step.title}.`,
+                        duration: Infinity,
+                        action: { label: 'Finish', onClick: () => runSteps(active) },
+                    });
+                    break;
+                }
             }
         }
-        await installer.close();
+        finally {
+            await installer.close();
+        }
     };
     const activate = async () => {
         if (runtime === undefined || plugin === undefined)
             return;
         const activeRouter = createRouter();
-        const active = await createMod(definition, { ...runtime, router: activeRouter, dataFolder: dataFolder(plugin.store, plugin.name), store: plugin.store, steps: plugin.steps, granted, refreshGrants, permissionRoutes, options: pluginOptions }).catch(async (error) => {
+        const active = await createMod(definition, { ...runtime, router: activeRouter, dataFolder: dataFolder(plugin.store, plugin.name), store: plugin.store, steps: plugin.steps, granted, refreshGrants, permissionRoutes, options: pluginOptions, nextDraw }).catch(async (error) => {
             if (error instanceof MissingOptions && (await askOptions(error)))
                 return undefined;
+            await installer.close();
             fail(messageOf(error), error instanceof MissingOptions ? `Retry asks for ${error.keys.length === 1 ? 'it' : 'them'}.` : undefined, begin, error);
             throw error;
         });
@@ -289,7 +300,10 @@ export function createLifecycle(definition, permissionRoutes = () => undefined,
         raise = active.raise;
         router = activeRouter;
         phase = 'active';
+        stopWatchingRecord();
         runtime.claude.ui.invalidate('ui.render');
+        if (definition.name === cmodPluginName)
+            runtime.claude.ui.invalidate('command.describe');
         void runSteps(active.mod).catch((error) => toastFailure({ id: 'cmod:steps', message: 'Its installer stopped', error }));
         const missed = missedSessionStart;
         missedSessionStart = undefined;
@@ -343,9 +357,15 @@ export function createLifecycle(definition, permissionRoutes = () => undefined,
             toastFailure({ id: 'cmod:updates', message: 'Could not read whether its marketplace updates automatically', error });
             return undefined;
         });
-        const isAccepted = await installer.consent({ ...event, updates });
+        const installedElsewhere = new Promise((resolve) => (settleAsked = () => resolve('installed')));
+        watchRecord();
+        const answer = await Promise.race([installer.consent({ ...event, program: plugin?.steps.program ?? '', updates }), installedElsewhere]).finally(() => {
+            settleAsked = undefined;
+        });
         await installer.close();
-        if (isAccepted) {
+        if (answer === 'installed')
+            return startInstalled();
+        if (answer) {
             consented = event.sha256;
             return install(consented);
         }
@@ -480,8 +500,8 @@ export function createLifecycle(definition, permissionRoutes = () => undefined,
     };
     let recordMs = 0;
     let readStarted;
-    const recover = async () => {
-        if (plugin === undefined || readStarted === undefined || (phase !== 'failed' && phase !== 'declined'))
+    const isNewlyInstalled = async () => {
+        if (plugin === undefined || readStarted === undefined)
             return false;
         const modifiedMs = await stampOf(recordPath(plugin.store, plugin.name));
         if (modifiedMs === recordMs)
@@ -491,12 +511,40 @@ export function createLifecycle(definition, permissionRoutes = () => undefined,
         if (!current.isInstalled)
             return false;
         plugin = current;
+        return true;
+    };
+    const startInstalled = async () => {
         failure = undefined;
         activation = undefined;
         await refreshGrants();
         await finish();
+    };
+    let settleAsked;
+    const recover = async () => {
+        if ((settleAsked === undefined && phase !== 'failed' && phase !== 'declined') || !(await isNewlyInstalled()))
+            return false;
+        if (settleAsked === undefined)
+            await startInstalled();
+        else
+            settleAsked();
         return true;
     };
+    let recordCheck;
+    let checking;
+    const watchRecord = () => {
+        recordCheck ??= claude().clock.every(recordCheckMs, () => {
+            checking ??= recover()
+                .then(() => undefined)
+                .catch((error) => claude().ui.log(`${definition.name} could not read whether another cmod installed it: ${messageOf(error)}`, { to: 'debug' }))
+                .finally(() => {
+                checking = undefined;
+            });
+        });
+    };
+    const stopWatchingRecord = () => {
+        recordCheck?.cancel();
+        recordCheck = undefined;
+    };
     const refreshGrants = async () => {
         if (plugin === undefined || plugin.name === cmodPluginName)
             return;
@@ -579,6 +627,7 @@ export function createLifecycle(definition, permissionRoutes = () => undefined,
             runtime = { claude: programs.claude, toaster: createToaster(claudeCalls, definition.name, () => plugin?.version, () => openSettings('permissions')) };
             readStarted = read;
             try {
+                drawCount = (await claudeCalls.clock.now()) * drawsPerMs;
                 await programs.refresh();
                 await begin().catch(report);
             }
@@ -589,10 +638,16 @@ export function createLifecycle(definition, permissionRoutes = () => undefined,
         async route(event, e, next) {
             if (imports !== undefined)
                 bind(imports);
-            if (event === 'ui.render' && installer.draws(e))
-                return installer.draw(e);
-            if (event === 'ui.close')
-                installer.closed(e.id);
+            const asked = e;
+            if (event === 'cmod.call' && asked.to === definition.name && asked.caller === cmodPluginName) {
+                if (asked.method === partMethods.shown)
+                    installer.hear(asked.input);
+                const answered = installer.answer(asked.method, asked.input);
+                if (answered !== undefined)
+                    return (await answered.catch((error) => ({ deny: `${definition.name}: ${messageOf(error)}` })));
+                if (asked.method === partMethods.shown && phase !== 'active')
+                    return { value: null };
+            }
             if (event === 'classic.SessionStart') {
                 missedSessionStart = undefined;
                 hasHeardSessionStart = true;
@@ -605,10 +660,11 @@ export function createLifecycle(definition, permissionRoutes = () => undefined,
                 record();
             if (event === 'classic.UserPromptSubmit' || event === 'classic.SessionStart')
                 await recover().catch((error) => claude().ui.log(`${definition.name} stays stopped: ${messageOf(error)}`, { to: 'debug' }));
-            const isCallToThisMod = event === 'cmod.call' && e.to === definition.name;
+            const tool = e.tool;
+            const isCallToThisMod = (event === 'cmod.call' && e.to === definition.name) || (event === 'tool.call' && typeof tool === 'string' && tool.startsWith(`mcp__${definition.name}__`));
             if (event === 'cmod.call' && !isCallToThisMod)
                 return next(e);
-            await (event === 'classic.SessionStart' || isCallToThisMod ? holdUntilStarted() : whenActive());
+            await (event === 'classic.SessionStart' || event === 'session.append' || isCallToThisMod ? holdUntilStarted() : whenActive());
             if (event === 'classic.SessionStart' && phase !== 'active') {
                 missedSessionStart = e;
                 return next(e);
@@ -621,8 +677,11 @@ export function createLifecycle(definition, permissionRoutes = () => undefined,
             if (event === 'cmod.call' && call.to === definition.name && mod !== undefined) {
                 if (call.method === pendingStepsMethod)
                     return { value: await pendingSteps(mod) };
-                if (call.method === finishStepsMethod)
-                    return (await runSteps(mod), { value: null });
+                if (call.method === finishStepsMethod) {
+                    const active = mod;
+                    const opened = await installer.collect(() => Promise.race([runSteps(active).catch((error) => void toastFailure({ id: 'cmod:steps', message: 'Could not finish the setup', error })), installer.shown()]));
+                    return { value: opened };
+                }
             }
             if (event === 'classic.UserPromptSubmit' || event === 'classic.SessionStart')
                 await refreshGrants().catch((error) => claude().ui.log(`${definition.name} keeps its grants from before: ${messageOf(error)}`, { to: 'debug' }));
@@ -638,7 +697,7 @@ export function createLifecycle(definition, permissionRoutes = () => undefined,
                 return answer;
             return runtime.toaster.draw((await answer), runtime.claude.ui.resolve(render), render.props, render.requestId);
         },
-        async caught(event, e, next, { kind, message }) {
+        async caught(event, e, next, { error: { kind, message }, called }) {
             const call = e;
             const isAsk = event === 'cmod.call' && call.to === definition.name && beforeAskOf(call) !== undefined;
             const reasons = { timeout: `it ran past the ${hookMs / 1000} s Claude Code gives a hook`, throw: message ?? 'it threw' };
@@ -646,7 +705,9 @@ export function createLifecycle(definition, permissionRoutes = () => undefined,
             if (reason === undefined)
                 return isAsk ? { value: null } : next(e);
             const error = new Error(reason);
-            toastFailure({ id: `stopped:${event}`, message: `Claude Code stopped its ${event.replace(/^classic\./, '')} hook`, error });
+            const failedBeneath = called && kind === 'throw' ? await next(e).then(() => undefined, messageOf) : undefined;
+            if (failedBeneath === undefined || failedBeneath !== message)
+                toastFailure({ id: `stopped:${event}`, message: `Claude Code stopped its ${event.replace(/^classic\./, '')} hook`, error });
             return router.dispatchFailure(event, e, error, next);
         },
     };
@@ -689,7 +750,13 @@ async function createMod(definition, runtime) {
     let parentAsked;
     let hasEarlierPrompts = true;
     let agentType;
-    const area = createUi({ name: definition.name, claude, router, report, announce, mod: () => mod });
+    let parts;
+    const borrowed = (styler, cached, input) => {
+        const name = `The markdown style of ${styler}`;
+        void parts?.fill(styler, cached, input, name)?.then(() => claude.ui.invalidate('ui.render'));
+        return parts?.element(styler, cached, `${styler}/markdown:`, name, `markdown:${styler}`);
+    };
+    const area = createUi({ name: definition.name, claude, router, report, announce, mod: () => mod, borrowed, nextDraw: runtime.nextDraw });
     const askParent = async () => {
         if (definition.name === cmodPluginName)
             return undefined;
@@ -968,9 +1035,24 @@ async function createMod(definition, runtime) {
     const conversations = definition.name === cmodPluginName ? serveConversations({ claude, router, store: runtime.store, project: () => modState.root, report: (id, message, error) => report({ id, message, error }), clear: (id) => toaster.toast.dismiss(id) }) : undefined;
     let pages;
     const reportPart = (id, message, error) => report({ id, message, error });
-    const parts = drawnParts({ claude, report: reportPart, press: (to, input) => pages?.press(to, input) });
-    const widgets = conversations === undefined ? undefined : serveWidgets({ claude, router, store: runtime.store, report: reportPart, turnClosedBy: (rowId) => conversations.turnClosedBy(rowId), parts });
-    pages = widgets === undefined ? undefined : servePages({ claude, router, report: reportPart, widgets, parts });
+    const pressElsewhere = (to, input) => void claude.cmod.call({ to, method: partMethods.press, input }).catch((error) => {
+        parts?.forget(to);
+        claude.ui.invalidate('ui.render');
+        reportPart(`press:${to}`, `${to} did not take the press`, error);
+    });
+    parts = drawnParts({ claude, report: reportPart, press: (to, input) => (pages === undefined ? pressElsewhere(to, input) : pages.press(to, input)) });
+    const widgets = conversations === undefined ? undefined : serveWidgets({ claude, router, store: runtime.store, report: reportPart, turnClosedBy: (rowId) => conversations.turnClosedBy(rowId), parts, markdownIn: area.markdownIn });
+    pages = widgets === undefined ? undefined : servePages({ claude, router, report: reportPart, widgets, parts, tellStylers: area.restyled });
+    const tellColor = (to, told) => {
+        if (told.session === '' || to === cmodPluginName)
+            return;
+        claude.clock.after(0, () => void claude.cmod.call({ to, method: conversationMethods.sessionColor, input: told }).catch((error) => claude.ui.log(`cmod: ${to} did not hear the session's color: ${messageOf(error)}`, { to: 'debug' })));
+    };
+    conversations?.onColor((told) => {
+        client.recolor(told);
+        for (const { mod: to } of pages?.declared() ?? [])
+            tellColor(to, told);
+    });
     router.add('cmod.call', async (e, next) => {
         if (e.to !== definition.name)
             return next(e);
@@ -982,17 +1064,24 @@ async function createMod(definition, runtime) {
             client.changed(changedSession, change, isInProject !== false);
             return { value: null };
         }
+        if (e.method === conversationMethods.sessionColor && call.caller === cmodPluginName) {
+            client.recolor(e.input);
+            return { value: null };
+        }
         const ask = beforeAskOf(call);
         if (ask !== undefined)
             return { value: (await client.answerBefore(ask.session, ask.event, ask.change, ask.isInProject)) ?? null };
         if (e.method === partMethods.changed && call.caller !== undefined && pages !== undefined) {
-            return { value: { isHeld: pages.update(call.caller, e.input) } };
+            const update = e.input;
+            if (update.parts !== undefined && conversations !== undefined)
+                tellColor(call.caller, conversations.color());
+            return { value: { isHeld: pages.update(call.caller, update), stylers: pages.stylers() } };
         }
-        if (call.caller === cmodPluginName) {
+        if (call.caller !== undefined) {
             const turn = e.method === partMethods.draw ? e.input.turn : undefined;
-            const answered = area.answer(e.method, turn === undefined ? e.input : { ...e.input, turn: client.turn(turn) });
+            const answered = area.answer(e.method, turn === undefined ? e.input : { ...e.input, turn: client.turn(turn) }, call.caller);
             if (answered !== undefined)
-                return answered;
+                return answered.catch((error) => ({ deny: `${definition.name}: ${messageOf(error)}` }));
         }
         const served = await conversations?.answer(call);
         return served ?? answerCall(definition.name, api, e);
@@ -1003,7 +1092,20 @@ async function createMod(definition, runtime) {
         return ask === undefined ? { deny: `${definition.name}: ${error.message}` } : { value: client.failedBefore(ask.session, ask.event, ask.change, ask.isInProject, error) ?? null };
     });
     const agents = toolCalls(claude, router);
-    keepEngine(mod, { claude: checked, router, toolCalls: agents, report, hasPermissionCheck: () => runtime.permissionRoutes() !== undefined, answerInput: area.answerInput, ...(widgets === undefined ? {} : { widgets }), ...(pages === undefined ? {} : { pages }) });
+    keepEngine(mod, {
+        claude: checked,
+        router,
+        toolCalls: agents,
+        report,
+        hasPermissionCheck: () => runtime.permissionRoutes() !== undefined,
+        answerInput: area.answerInput,
+        spawnCmod: async (args, program) => {
+            await checkRun(grants, 'process.spawn', program.argv);
+            return spawnCmod(claude, args, session, program.env);
+        },
+        ...(widgets === undefined ? {} : { widgets }),
+        ...(pages === undefined ? {} : { pages }),
+    });
     const names = new Set();
     const reserveName = (type, name, taken) => {
         const key = `${type}:${name}`;

package/runtime/pages.d.ts

@@ -11,6 +11,7 @@ export type ModPages = {
 export type PageApply = (mod: string, requests: readonly PageRequest[]) => Promise<void>;
 export type Pages = {
     declared(): readonly ModPages[];
+    stylers(): readonly string[];
     element(mod: string, page: string, params: unknown, columns: number, isFocused: boolean): RenderElement | undefined;
     press(mod: string, press: PartPress): void;
     update(mod: string, update: PartsUpdate): boolean;
@@ -18,11 +19,12 @@ export type Pages = {
     apply(listener: PageApply): void;
 };
 export declare function pagesOf(input: unknown): PageDeclaration[];
-export declare function servePages({ claude, router, report, widgets, parts }: {
+export declare function servePages({ claude, router, report, widgets, parts, tellStylers, }: {
     readonly claude: Claude;
     readonly router: Router;
     readonly report: (id: string, message: string, error: unknown) => void;
     readonly widgets: Pick<Widgets, 'update'>;
     readonly parts: DrawnParts;
+    readonly tellStylers: (stylers: readonly string[]) => void;
 }): Pages;
 //# sourceMappingURL=pages.d.ts.map

package/runtime/pages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../src/runtime/pages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAGhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAe,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAA;AAChI,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAI3C,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAA;CAAE,CAAA;AAE3F,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,WAAW,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAExF,MAAM,MAAM,KAAK,GAAG;IAClB,QAAQ,IAAI,SAAS,QAAQ,EAAE,CAAA;IAC/B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAAA;IACnH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAAA;IAC1C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAA;IACjD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IAC1C,KAAK,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAA;CACjC,CAAA;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAGzD;AAED,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,KAAK,CAiGjR"}
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../src/runtime/pages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAIhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAA2B,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAA;AAC5I,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAI3C,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAA;CAAE,CAAA;AAE3F,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,WAAW,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAExF,MAAM,MAAM,KAAK,GAAG;IAClB,QAAQ,IAAI,SAAS,QAAQ,EAAE,CAAA;IAC/B,OAAO,IAAI,SAAS,MAAM,EAAE,CAAA;IAC5B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAAA;IACnH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAAA;IAC1C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAA;IACjD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IAC1C,KAAK,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAA;CACjC,CAAA;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAGzD;AAED,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,MAAM,EACN,MAAM,EACN,OAAO,EACP,KAAK,EACL,WAAW,GACZ,EAAE;IACD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IACtE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IACzC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAA;CAC3D,GAAG,KAAK,CA4HR"}

package/runtime/pages.js

@@ -1,13 +1,16 @@
 import { isObject } from '../records.js';
+import { Text } from '../ui/elements.js';
 import { messageOf } from '../utils/text.js';
-import { partMethods } from './ui.js';
+import { cmodPluginName } from './dependencies.js';
+import { partMethods, stalePress } from './ui.js';
 const askedWaitMs = 1000;
 export function pagesOf(input) {
     const listed = isObject(input) && Array.isArray(input['pages']) ? input['pages'] : [];
     return listed.filter(isObject).flatMap((each) => (typeof each['id'] === 'string' && typeof each['title'] === 'string' && (each['place'] === 'sidebar' || each['place'] === 'settings') ? [{ id: each['id'], title: each['title'], place: each['place'] }] : []));
 }
-export function servePages({ claude, router, report, widgets, parts }) {
+export function servePages({ claude, router, report, widgets, parts, tellStylers, }) {
     const declared = new Map();
+    const stylers = new Set();
     const asking = new Map();
     const pressing = new Set();
     let waiting = [];
@@ -20,16 +23,18 @@ export function servePages({ claude, router, report, widgets, parts }) {
         for (const { mod, requests } of taken)
             await run(mod, requests);
     };
-    const settle = async () => {
-        while (pressing.size > 0)
-            await Promise.allSettled(pressing);
+    const settle = async (earlier) => {
+        const own = () => [...pressing].filter((pending) => !earlier.has(pending));
+        for (let pending = own(); pending.length > 0; pending = own())
+            await Promise.allSettled(pending);
         await takeWaiting();
     };
     const wrapped = async (next) => {
         inputDepth += 1;
+        const earlier = new Set(pressing);
         try {
             const answer = await next();
-            await settle();
+            await settle(earlier);
             return answer;
         }
         finally {
@@ -47,11 +52,27 @@ export function servePages({ claude, router, report, widgets, parts }) {
         asking.set(mod, pending);
         return pending;
     };
+    const restyle = (mod, isStyler) => {
+        if (!isStyler && !stylers.delete(mod))
+            return;
+        if (isStyler)
+            stylers.add(mod);
+        parts.forget(mod);
+        const listed = [...stylers];
+        tellStylers(listed);
+        for (const told of declared.keys()) {
+            if (told !== cmodPluginName)
+                void claude.cmod.call({ to: told, method: partMethods.stylers, input: listed }).catch((error) => claude.ui.log(`cmod: ${told} did not hear which mods style markdown: ${messageOf(error)}`, { to: 'debug' }));
+        }
+    };
     const update = (mod, { parts: listing, redraw, requests, isAsked }) => {
         if (listing !== undefined)
             declared.set(mod, pagesOf(listing));
-        if (listing !== undefined || redraw === true)
-            widgets.update(mod, { ...(listing === undefined ? {} : { parts: listing }), ...(redraw === undefined ? {} : { redraw }) });
+        if (listing !== undefined)
+            restyle(mod, isObject(listing) && listing['stylesMarkdown'] === true);
+        const isRedrawn = redraw === true || requests?.some((request) => 'open' in request) === true;
+        if (listing !== undefined || isRedrawn)
+            widgets.update(mod, { ...(listing === undefined ? {} : { parts: listing }), ...(isRedrawn ? { redraw: true } : {}) });
         if (requests === undefined || requests.length === 0)
             return false;
         if (isAsked !== true)
@@ -68,28 +89,41 @@ export function servePages({ claude, router, report, widgets, parts }) {
             .then((answer) => void update(mod, (isObject(answer) ? answer : {})), (error) => {
             parts.forget(mod);
             claude.ui.invalidate('ui.render');
-            report(`press:${mod}`, `${mod} did not take the press`, error);
+            if (messageOf(error).includes(stalePress))
+                claude.ui.log(`cmod: ${mod} draws its page again, because the button pressed was from an older drawing:${messageOf(error)}`, { to: 'debug' });
+            else
+                report(`press:${mod}`, `${mod} did not take the press`, error);
         })
             .finally(() => pressing.delete(pending));
         pressing.add(pending);
         if (inputDepth === 0)
             void pending.then(takeWaiting);
     };
-    const cacheKey = (page, params, columns, isFocused) => `${page}\u0000${JSON.stringify(params ?? null)}\u0000${columns}\u0000${isFocused}`;
+    const lastDrawn = new Map();
+    const plain = (data) => JSON.parse(JSON.stringify(data));
     return {
         declared: () => [...declared].map(([mod, pages]) => ({ mod, pages })),
+        stylers: () => [...stylers],
         element(mod, page, params, columns, isFocused) {
             if (!declared.has(mod))
                 void ask(mod);
-            const cached = cacheKey(page, params, columns, isFocused);
+            const given = JSON.stringify(params ?? null);
+            const cached = `${page}\u0000${given}\u0000${columns}\u0000${isFocused}`;
             const name = `The ${page} page of ${mod}`;
-            void parts.fill(mod, cached, { page, params: params ?? null, columns, isFocused }, name)?.then(() => claude.ui.invalidate('ui.render'));
-            return parts.element(mod, cached, `${mod}/${page}:`, name, `page:${mod}/${page}`);
+            const keyPrefix = `${mod}/${page}:`;
+            void parts.fill(mod, cached, { page, params: plain(params ?? null), columns, isFocused }, name)?.then(() => claude.ui.invalidate('ui.render'));
+            const failure = parts.failure(mod, cached);
+            const drawnAt = (key) => parts.element(mod, key, keyPrefix, name, `page:${mod}/${page}`);
+            const last = lastDrawn.get(keyPrefix);
+            const drawn = drawnAt(cached);
+            if (drawn !== undefined)
+                lastDrawn.set(keyPrefix, { params: given, cached });
+            return drawn ?? (last?.params === given ? drawnAt(last.cached) : undefined) ?? (failure === undefined ? undefined : Text({ color: 'error', children: `${name} could not draw: ${failure}` }));
         },
         press,
         update,
         tell(mod, shown) {
-            void claude.cmod.call({ to: mod, method: partMethods.shown, input: shown }).catch((error) => claude.ui.log(`cmod: ${mod} did not hear which of its pages show: ${messageOf(error)}`, { to: 'debug' }));
+            void claude.cmod.call({ to: mod, method: partMethods.shown, input: plain(shown) }).catch((error) => claude.ui.log(`cmod: ${mod} did not hear which of its pages show: ${messageOf(error)}`, { to: 'debug' }));
         },
         apply(listener) {
             applyTo = listener;

package/runtime/parts.d.ts

@@ -4,6 +4,7 @@ import { type PartPress } from './ui.js';
 export type DrawnParts = {
     fill(mod: string, cached: string, input: Readonly<Record<string, unknown>>, name: string): Promise<void> | undefined;
     element(mod: string, cached: string, keyPrefix: string, name: string, reportId: string): RenderElement | undefined;
+    failure(mod: string, cached: string): string | undefined;
     forget(mod: string): void;
 };
 export declare function drawnParts({ claude, report, press }: {

package/runtime/parts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parts.d.ts","sourceRoot":"","sources":["../src/runtime/parts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAGhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,SAAS,CAAA;AAErE,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAA;IACpH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAA;IAClH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B,CAAA;AAMD,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;CAAE,GAAG,UAAU,CAqD9N"}
+{"version":3,"file":"parts.d.ts","sourceRoot":"","sources":["../src/runtime/parts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAGhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,SAAS,CAAA;AAErE,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAA;IACpH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAA;IAClH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACxD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B,CAAA;AAMD,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;CAAE,GAAG,UAAU,CAwD9N"}

package/runtime/parts.js

@@ -14,9 +14,9 @@ export function drawnParts({ claude, report, press }) {
             const generation = generationOf(mod);
             if (drawn.get(key)?.generation === generation)
                 return undefined;
-            const keep = (data) => {
+            const keep = (data, failure) => {
                 drawn.delete(key);
-                drawn.set(key, { data, generation });
+                drawn.set(key, { data, ...(failure === undefined ? {} : { failure }), generation });
                 const [oldest] = drawn.keys();
                 if (drawn.size > keptDrawings && oldest !== undefined)
                     drawn.delete(oldest);
@@ -28,7 +28,7 @@ export function drawnParts({ claude, report, press }) {
                     .call({ to: mod, method: partMethods.draw, input })
                     .then((data) => keep((data ?? null)), (error) => {
                     claude.ui.log(`cmod: ${name} drew nothing: ${messageOf(error)}`, { to: 'debug' });
-                    keep(null);
+                    keep(drawn.get(key)?.data ?? null, messageOf(error));
                 })
                     .finally(() => drawing.delete(key));
             drawing.set(key, pending);
@@ -52,6 +52,9 @@ export function drawnParts({ claude, report, press }) {
                 return undefined;
             }
         },
+        failure(mod, cached) {
+            return drawn.get(keyOf(mod, cached))?.failure;
+        },
         forget(mod) {
             generations.set(mod, generationOf(mod) + 1);
         },

package/runtime/programs.d.ts

@@ -10,6 +10,7 @@ export declare function readLines(stream: HookStream<ProcessSpawnChunk, ProcessS
     code: number | null;
     lastError: string;
 }>;
+export declare function spawnCmod(claude: Claude, args: readonly string[], session: string, env?: Readonly<Record<string, string>>): HookStream<ProcessSpawnChunk, ProcessSpawnResult>;
 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":"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"}
+{"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,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GAAG,UAAU,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAEjL;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

@@ -30,9 +30,12 @@ export async function readLines(stream, onLine) {
         onLine(pending);
     return { code: piece.value.code, lastError };
 }
+export function spawnCmod(claude, args, session, env = {}) {
+    return claude.process.spawn({ argv: ['cmod', ...args], env: { ...env, CLAUDE_CODE_SESSION_ID: session } });
+}
 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));
+    const { code, lastError } = await readLines(spawnCmod(claude, args, 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');

package/runtime/sessions.d.ts

@@ -30,8 +30,14 @@ export declare const conversationMethods: {
     readonly act: 'cmod:act';
     readonly changed: 'cmod:changed';
     readonly before: 'cmod:before';
+    readonly sessionColor: 'cmod:sessionColor';
 };
-export type Act = 'send' | 'startTask' | 'callTool' | 'usage' | 'surfaces' | 'abort';
+export type SessionColor = {
+    readonly session: string;
+    readonly color?: string;
+};
+export declare function pickedColor(args: string): string | undefined;
+export type Act = 'send' | 'startTask' | 'fork' | 'clone' | 'startBackgroundTask' | 'callTool' | 'usage' | 'surfaces' | 'abort';
 export declare const beforePermission: (event: BeforeEvent) => string;
 export declare const isAct: (action: string) => action is Act;
 export declare function toolPermission(tool: string): string | undefined;
@@ -55,7 +61,8 @@ export type SessionsClient = {
     listen(method: string, args: readonly unknown[]): Subscription;
     turn(data: TurnData): Turn;
     /** An empty title keeps the title the session already has. */
-    follow(current: Omit<SessionData, 'isRunning' | 'lastAt'>): void;
+    follow(current: Omit<SessionData, 'isRunning' | 'lastAt' | 'color'>): void;
+    recolor(told: SessionColor): void;
 };
 export declare function usageOf(claude: Pick<Claude, 'session'>): Promise<Usage>;
 export declare function payloadOf(change: SessionChange): unknown;
@@ -90,7 +97,7 @@ export type RouteOn = {
 export declare const recordOf: (value: unknown) => Readonly<Record<string, unknown>>;
 export declare const defined: (fields: HookFields) => HookFields;
 type ProcessFieldsName = Exclude<ProcessName, 'PermissionCheck'>;
-export declare function spawnTask(claude: Pick<Claude, 'agent'>, task: TaskStartArgs): Promise<TaskData>;
+export declare function spawnTask(claude: Pick<Claude, 'agent'>, task: TaskStartArgs, forkedFrom?: string): Promise<TaskData>;
 export declare function processPayloadOf(named: ProcessFieldsName, input: unknown): HookFields;
 export declare function resultOf(where: Pick<Place, 'session' | 'context' | 'turn'>, call: ToolCallArgs & {
     readonly cwd: string;