@cmodjs/core 0.3.0 → 1.5.0

package/runtime/announce.js

@@ -0,0 +1,68 @@
+import { changelogPage, isObject, marketplaceOf, permissionWords } from '../records.js';
+import { changeLines, changelogSections, unreleased } from '../utils/changelog.js';
+import { ifMissing } from '../utils/paths.js';
+import { listed } from '../utils/text.js';
+import { cmodPluginName } from './dependencies.js';
+export const announcementMs = 10_000;
+const shownChanges = 3;
+export function announcedOf(saved) {
+    if (typeof saved === 'string')
+        return { version: saved, added: [] };
+    if (!isObject(saved) || typeof saved['version'] !== 'string')
+        return undefined;
+    return { version: saved['version'], added: Array.isArray(saved['added']) ? saved['added'].map(String) : [] };
+}
+export async function announcementOf(claude, plugin, granted, added, previous) {
+    const read = (path) => claude.fs.read(`${plugin.root}/${path}`).catch(ifMissing(undefined));
+    const manifest = jsonOf(await read('.claude-plugin/plugin.json'));
+    const field = (key) => (isObject(manifest) && typeof manifest[key] === 'string' ? manifest[key] : undefined);
+    const open = (page) => () => claude.cmod.call({ to: cmodPluginName, method: 'openSettings', input: { mod: plugin.name, ...(page === undefined ? {} : { page }) } });
+    if (previous === undefined) {
+        const { program, keys } = plugin.steps;
+        const rules = (await claude.fs.list(`${plugin.root}/rules`).catch(ifMissing([]))).filter((entry) => entry.kind === 'file' && entry.name.endsWith('.md')).map((entry) => entry.name.slice(0, -'.md'.length)).toSorted();
+        const lines = [
+            field('description'),
+            added.length > 0 ? `Adds ${listed(added)}.` : undefined,
+            rules.length > 0 ? `Adds ${rules.length} ${rules.length === 1 ? 'rule' : 'rules'}: ${listed(rules)}.` : undefined,
+            program === undefined ? undefined : `Installed the ${program} program.`,
+            ...Object.entries(keys ?? {}).map(([key, command]) => `Binds ${key} to /${command}.`),
+            ...[...granted].map((item) => `${permissionWords(item)}.`),
+        ];
+        return { message: 'Installed', ...described(lines), action: { label: 'Settings', onClick: open() } };
+    }
+    const version = plugin.version ?? '';
+    const isCheckout = marketplaceOf(plugin.root, plugin.name) === undefined;
+    const sections = changelogSections((await read('CHANGELOG.md')) ?? '');
+    const section = sections.find((each) => each.version === version) ?? (isCheckout ? sections.find((each) => each.version === unreleased) : undefined);
+    const changes = section === undefined ? [] : changeLines(section.text);
+    const nowAdded = added.filter((each) => !previous.added.includes(each));
+    const gone = previous.added.filter((each) => !added.includes(each));
+    const fallback = previous.added.length === 0 ? [] : [nowAdded.length > 0 ? `Now adds ${listed(nowAdded)}.` : undefined, gone.length > 0 ? `No longer adds ${listed(gone)}.` : undefined];
+    const home = await claude.env.home();
+    const folder = home !== undefined && plugin.root.startsWith(`${home}/`) ? `~${plugin.root.slice(home.length)}` : plugin.root;
+    const repository = field('repository');
+    const lines = [
+        ...(changes.length === 0 ? fallback : changes.length > shownChanges ? [...changes.slice(0, shownChanges), '…'] : changes),
+        `From ${previous.version}${isCheckout ? `, loaded from ${folder}` : ''}.`,
+        repository === undefined || isCheckout ? undefined : `Release notes: ${repository.replace(/\/$/, '')}/releases/tag/v${version}`,
+    ];
+    return {
+        message: `Updated to ${version}`,
+        ...described(lines),
+        ...(sections.length > 0 ? { action: { label: 'Changelog', onClick: open(changelogPage) } } : {}),
+    };
+}
+function jsonOf(text) {
+    try {
+        return text === undefined ? undefined : JSON.parse(text);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            return undefined;
+        throw error;
+    }
+}
+function described(lines) {
+    const kept = lines.filter((line) => line !== undefined);
+    return kept.length === 0 ? {} : { description: kept.join('\n') };
+}

package/runtime/before.d.ts

@@ -0,0 +1,32 @@
+import type { Args, Frozen } from 'claude-code';
+import type { Disposable } from '../mod.js';
+import type { ConversationState, SessionChange } from '../session/conversation.js';
+import type { BeforeEvent } from '../session/session.js';
+import type { Claude } from './claude.js';
+import type { Router } from './router.js';
+export type Place = Pick<ConversationState, 'session' | 'context' | 'contextOpenedAt' | 'turn' | 'tasks' | 'taskTurns'>;
+export type Decide = (event: BeforeEvent, change: SessionChange) => Promise<Partial<Answers> | undefined>;
+export type Answers = {
+    readonly text: string;
+    readonly refuse: string;
+    readonly input: Readonly<Record<string, unknown>>;
+    readonly result: string;
+    readonly owner: {
+        readonly model: string;
+    };
+};
+export type BeforeHooks = {
+    readonly place: () => Promise<Place>;
+    readonly wants: (event: BeforeEvent) => Promise<boolean>;
+    readonly decide: Decide;
+};
+export declare function relayOf(e: Frozen<Args<'session.receive'>>): string | undefined;
+export declare function installBefore({ claude, router, hooks }: {
+    readonly claude: Claude;
+    readonly router: Router;
+    readonly hooks: BeforeHooks;
+}): Disposable;
+export declare function withAnswer(change: SessionChange, answer: Partial<Answers>): SessionChange;
+export declare function foldAnswers(event: BeforeEvent, change: SessionChange, askers: readonly ((change: SessionChange) => Promise<unknown>)[], report: (error: unknown) => void): Promise<Partial<Answers> | undefined>;
+export declare function answerOf(event: BeforeEvent, answer: unknown): Partial<Answers> | undefined;
+//# sourceMappingURL=before.d.ts.map

package/runtime/before.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"before.d.ts","sourceRoot":"","sources":["../src/runtime/before.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAa3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAY,MAAM,4BAA4B,CAAA;AAE5F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,MAAM,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,SAAS,GAAG,iBAAiB,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC,CAAA;AAEvH,MAAM,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,CAAA;AAEzG,MAAM,MAAM,OAAO,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAA;AAEhM,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAMrJ,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,GAAG,MAAM,GAAG,SAAS,CAG9E;AAED,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GAAG,UAAU,CAkHtJ;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,aAAa,CAKzF;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,CAetN;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,CAoB1F"}

package/runtime/before.js

@@ -0,0 +1,214 @@
+import { ContextEnd } from '../session/context/context.js';
+import { Document } from '../session/context/turn/message/document.js';
+import { Message, messagesOf, rowOfAppend, withTexts } from '../session/context/turn/message/message.js';
+import { Note } from '../session/context/turn/message/note.js';
+import { Notice } from '../session/context/turn/message/notice.js';
+import { Prompt } from '../session/context/turn/message/prompt.js';
+import { Reply } from '../session/context/turn/message/reply.js';
+import { senderOf } from '../session/context/turn/message/sender.js';
+import { Skill } from '../session/context/turn/message/skill.js';
+import { ToolCall } from '../session/context/turn/message/tool-call.js';
+import { ToolResult } from '../session/context/turn/message/tool-result.js';
+import { TurnEnd } from '../session/context/turn/turn.js';
+import { TaskEnd, TaskStart } from '../session/goal/task.js';
+import { cmodPluginName } from './dependencies.js';
+import { toolInputOf } from './tool-calls.js';
+const appended = [Note, Reply, ToolResult, Notice];
+const relayTag = /^(?:<cross-session-message[^>]*>\s*)?<cmod-relay>([\s\S]*)<\/cmod-relay>(?:\s*<\/cross-session-message>[\s\S]*)?$/;
+export function relayOf(e) {
+    const isFromCmod = e.origin.kind === 'peer' && !('teammate' in e.origin) && e.origin.plugin === cmodPluginName;
+    return isFromCmod ? relayTag.exec(e.text)?.[1] : undefined;
+}
+export function installBefore({ claude, router, hooks }) {
+    const { place, wants, decide } = hooks;
+    const now = () => new Date().toISOString();
+    const asked = async (event, change) => (await decide(event, change)) ?? {};
+    const message = (where, unplaced, task, isInTurn = true) => {
+        const turn = isInTurn ? (task === undefined ? where.turn : where.taskTurns[task]) : undefined;
+        const context = task === undefined ? where.context : (where.tasks[task]?.context ?? where.context);
+        return { type: Message, message: { ...unplaced, session: where.session, context, ...(turn === undefined ? {} : { turn: turn.prompt.id }), ...(task === undefined ? {} : { task }) } };
+    };
+    const added = [
+        router.add('prompt.submit', async (e, next) => {
+            if (!(await wants(Prompt)) || e.text.startsWith('/'))
+                return next(e);
+            const where = await place();
+            const answer = await asked(Prompt, message(where, { id: '', at: now(), type: Prompt, text: e.text, from: senderOf(e.origin, false) }, undefined, false));
+            if (answer.refuse !== undefined)
+                return { drop: answer.refuse };
+            return next(answer.text === undefined ? e : { ...e, text: answer.text });
+        }),
+        router.add('command.run', async (e, next) => {
+            if (!(await wants(Prompt)))
+                return next(e);
+            const typed = e.args === '' ? `/${e.command}` : `/${e.command} ${e.args}`;
+            const where = await place();
+            const answer = await asked(Prompt, message(where, { id: '', at: now(), type: Prompt, text: typed, from: senderOf(e.origin, false) }, undefined, false));
+            if (answer.refuse !== undefined)
+                return { text: answer.refuse };
+            if (answer.text === undefined || answer.text === typed)
+                return next(e);
+            const same = new RegExp(`^/${e.command}(?:\\s+|$)`).exec(answer.text);
+            if (same !== null)
+                return next({ ...e, args: answer.text.slice(same[0].length) });
+            void claude.prompt.submit({ text: answer.text });
+            return {};
+        }),
+        router.add('session.receive', async (e, next) => {
+            if (!(await wants(Prompt)) || relayOf(e) !== undefined)
+                return next(e);
+            const where = await place();
+            const answer = await asked(Prompt, message(where, { id: '', at: now(), type: Prompt, text: e.text, from: { type: 'session' } }, e.agentId, false));
+            if (answer.refuse !== undefined)
+                return { consumed: answer.refuse };
+            return next(answer.text === undefined ? e : { ...e, text: answer.text });
+        }),
+        router.add('skill.prompt', async (e, next) => {
+            if (!(await wants(Skill)))
+                return next(e);
+            const where = await place();
+            const answer = await asked(Skill, message(where, { id: '', at: now(), type: Skill, name: e.skill, text: e.text }, undefined));
+            return answer.text === undefined ? next(e) : { text: answer.text };
+        }),
+        router.add('prompt.attachment', async (e, next) => {
+            if (!(await wants(Document)) || e.type !== 'nested_memory')
+                return next(e);
+            const where = await place();
+            const path = /^Contents of (.+?) \(/.exec(e.text)?.[1] ?? '';
+            const answer = await asked(Document, message(where, { id: '', at: now(), type: Document, path, text: e.text }, e.agentId));
+            if (answer.refuse !== undefined)
+                return { text: null };
+            return answer.text === undefined ? next(e) : { text: answer.text };
+        }),
+        router.add('session.append', async (e, next) => {
+            const wanted = new Set((await Promise.all(appended.map(async (event) => ((await wants(event)) ? [event] : [])))).flat());
+            if (wanted.size === 0)
+                return next(e);
+            const row = rowOfAppend({ uuid: e.uuid, door: e.door, origin: e.origin, message: e.message }, now(), '');
+            const found = messagesOf(row, e.agentId !== undefined);
+            if (!found.some((each) => wanted.has(each.type)))
+                return next(e);
+            const where = await place();
+            const texts = new Map();
+            for (const [part, unplaced] of found.entries()) {
+                if (!wanted.has(unplaced.type))
+                    continue;
+                const answer = await asked(unplaced.type, message(where, unplaced, e.agentId));
+                if (answer.text !== undefined)
+                    texts.set(part, answer.text);
+            }
+            return next(texts.size === 0 ? e : { ...e, message: { ...e.message, content: withTexts(row, texts) } });
+        }),
+        router.add('tool.call', async (e, next) => {
+            if (!(await wants(ToolCall)))
+                return next(e);
+            const where = await place();
+            const input = toolInputOf(e);
+            const answer = await asked(ToolCall, message(where, { id: e.tool_use_id, at: now(), type: ToolCall, callId: e.tool_use_id, name: e.tool, input, cwd: await claude.session.cwd() }, e.agentId));
+            if (answer.refuse !== undefined)
+                return { deny: answer.refuse };
+            if (answer.result !== undefined)
+                return { result: answer.result };
+            if (answer.input === undefined)
+                return next(e);
+            const reserved = Object.fromEntries(Object.entries(e).filter(([key]) => !(key in input)));
+            return next({ ...reserved, ...answer.input });
+        }),
+        router.add('agent.spawn', async (e, next) => {
+            if (!(await wants(TaskStart)))
+                return next(e);
+            const where = await place();
+            const task = { id: '', title: e.description, agentType: e.subagentType, model: e.model ?? e.parentModel, openedBy: e.tool_use_id, openedAt: now(), ...(e.parentAgentId === undefined ? {} : { parent: e.parentAgentId }) };
+            const answer = await asked(TaskStart, { type: TaskStart, task: { ...task, context: where.context } });
+            if (answer.refuse !== undefined)
+                return { deny: answer.refuse };
+            return next(answer.owner === undefined ? e : { ...e, model: answer.owner.model });
+        }),
+        router.add('classic.SubagentStop', async (e, next) => {
+            if (!(await wants(TaskEnd)) && !(await wants(TurnEnd)))
+                return next(e);
+            const where = await place();
+            const task = where.tasks[e.agent_id];
+            if (task === undefined)
+                return next(e);
+            const turn = where.taskTurns[e.agent_id];
+            const ending = (await wants(TaskEnd)) ? await asked(TaskEnd, { type: TaskEnd, task: { ...task, closedAt: now() } }) : {};
+            const refuse = ending.refuse ?? ((await wants(TurnEnd)) && turn !== undefined ? (await asked(TurnEnd, { type: TurnEnd, turn: { ...turn, closedAt: now() } })).refuse : undefined);
+            const below = await next(e);
+            return refuse === undefined ? below : { ...below, block: refuse };
+        }),
+        router.add('classic.Stop', async (e, next) => {
+            if (!(await wants(TurnEnd)))
+                return next(e);
+            const where = await place();
+            if (where.turn === undefined)
+                return next(e);
+            const answer = await asked(TurnEnd, { type: TurnEnd, turn: { ...where.turn, closedAt: now() } });
+            const below = await next(e);
+            return answer.refuse === undefined ? below : { ...below, block: answer.refuse };
+        }),
+        router.add('session.compact', async (e, next) => {
+            if (!(await wants(ContextEnd)) || e.trigger === 'precompute')
+                return next(e);
+            const where = await place();
+            const task = e.agentId === undefined ? undefined : where.tasks[e.agentId];
+            if (e.agentId !== undefined && task === undefined)
+                return next(e);
+            const context = task === undefined ? { number: where.context, openedAt: where.contextOpenedAt } : { number: task.context, openedAt: task.contextOpenedAt ?? task.openedAt, task: task.id };
+            const answer = await asked(ContextEnd, { type: ContextEnd, context: { ...context, closedAt: now() } });
+            return answer.refuse === undefined ? next(e) : { skip: answer.refuse };
+        }),
+    ];
+    return { dispose: () => added.forEach((each) => each.dispose()) };
+}
+export function withAnswer(change, answer) {
+    if (change.type === Message && answer.text !== undefined)
+        return { ...change, message: { ...change.message, text: answer.text } };
+    if (change.type === Message && answer.input !== undefined && change.message.type === ToolCall)
+        return { ...change, message: { ...change.message, input: answer.input } };
+    if (change.type === TaskStart && answer.owner !== undefined)
+        return { ...change, task: { ...change.task, model: answer.owner.model } };
+    return change;
+}
+export async function foldAnswers(event, change, askers, report) {
+    let latest = change;
+    let result;
+    for (const ask of askers) {
+        try {
+            const answer = answerOf(event, await ask(latest));
+            if (answer === undefined)
+                continue;
+            result = { ...result, ...answer };
+            if (answer.refuse !== undefined || answer.result !== undefined)
+                return result;
+            latest = withAnswer(latest, answer);
+        }
+        catch (error) {
+            report(error);
+        }
+    }
+    return result;
+}
+export function answerOf(event, answer) {
+    if (typeof answer !== 'object' || answer === null)
+        return undefined;
+    const given = answer;
+    const allowed = {
+        prompt: ['text', 'refuse'],
+        note: ['text'],
+        skill: ['text'],
+        document: ['text', 'refuse'],
+        reply: ['text'],
+        toolCall: ['input', 'result', 'refuse'],
+        toolResult: ['text'],
+        notice: ['text'],
+        taskStart: ['owner', 'refuse'],
+        taskEnd: ['refuse'],
+        turnEnd: ['refuse'],
+        contextEnd: ['refuse'],
+    };
+    const unread = Object.keys(given).filter((key) => !allowed[event].includes(key));
+    if (unread.length > 0)
+        throw new Error(`a before(${event}) listener answered ${unread.join(' and ')}, which ${event} does not take. It takes ${allowed[event].map((key) => `{ ${key} }`).join(', ')}.`);
+    return given;
+}

package/runtime/bound.d.ts

@@ -0,0 +1,4 @@
+import type { Imports } from '../mod.js';
+export declare function bind(imports: Imports): void;
+export declare function bound(): Imports;
+//# sourceMappingURL=bound.d.ts.map

package/runtime/bound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bound.d.ts","sourceRoot":"","sources":["../src/runtime/bound.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAIxC,wBAAgB,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE3C;AAED,wBAAgB,KAAK,IAAI,OAAO,CAG/B"}

package/runtime/bound.js

@@ -0,0 +1,9 @@
+let current;
+export function bind(imports) {
+    current = imports;
+}
+export function bound() {
+    if (current === undefined)
+        throw new Error("A mod's imports work once its setup runs. Call them from setup or from a hook, never at the top of a module.");
+    return current;
+}

package/runtime/claude.d.ts

@@ -1,11 +1,10 @@
-import type { AgentInfo, AgentSpawnArgs, AgentSpawnResult, Args, EngineInterface, AskOptions, CommandSpec, ConfigRow, ElementTable, FsEntry, FsStat, FsStatOptions, HookStream, HttpInit, HttpResponse, InvalidatableEventName, PaneCloseArgs, PaneOpenArgs, ProcessRunInit, ProcessRunResult, ProcessSpawnChunk, ProcessSpawnRequest, ProcessSpawnResult, RenderSurface, ResolveInput, SessionUsage, Settings, SettingsReadArgs, Timer, ToastOptions, ToolSpec, UiLogOptions, UiOpenResult, UiPane, UiScrollArgs, UiScrollResult } from 'claude-code';
+import type { AgentInfo, AgentSpawnArgs, AgentSpawnResult, Args, EngineInterface, AskOptions, CommandSpec, ConfigRow, ElementTable, FsEntry, FsStat, FsStatOptions, HookStream, HttpInit, HttpResponse, InvalidatableEventName, PaneCloseArgs, PaneOpenArgs, ProcessRunInit, ProcessRunResult, ProcessSpawnChunk, ProcessSpawnRequest, ProcessSpawnResult, RenderSurface, ResolveInput, SessionUsage, Settings, SettingsReadArgs, Timer, ToolSpec, UiCopyArgs, UiFocusArgs, UiFocusResult, UiCopyResult, UiLogOptions, UiOpenResult, UiPane, UiScrollArgs, UiScrollResult } from 'claude-code';
 export type Claude = {
     readonly plugin: {
         readonly name: string;
         readonly root: string;
     };
     readonly ui: {
-        toast(text: string, options?: ToastOptions): void;
         status(text: string | undefined): void;
         log(text: string, options?: UiLogOptions): void;
         notice(toolUseId: string, text: string | undefined): void;
@@ -15,6 +14,8 @@ export type Claude = {
         close(pane: PaneCloseArgs): Promise<void>;
         panes(): Promise<readonly UiPane[]>;
         scroll(args: UiScrollArgs): Promise<UiScrollResult>;
+        copy(args: UiCopyArgs): Promise<UiCopyResult>;
+        focus(args: UiFocusArgs): Promise<UiFocusResult>;
         resolve(e: ResolveInput): ElementTable<RenderSurface>;
     };
     readonly process: {
@@ -57,6 +58,7 @@ export type Claude = {
         surfaces(): Promise<readonly RenderSurface[]>;
         messages: EngineInterface['session']['messages'];
         append: EngineInterface['session']['append'];
+        send: EngineInterface['session']['send'];
     };
     readonly prompt: {
         submit: EngineInterface['prompt']['submit'];

package/runtime/claude.d.ts.map

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

package/runtime/conversations.d.ts

@@ -0,0 +1,17 @@
+import type { Args, EventResult, Frozen } from 'claude-code';
+import type { Claude } from './claude.js';
+import type { Router } from './router.js';
+export type Conversations = {
+    answer(e: Frozen<Args<'cmod.call'>> & {
+        readonly caller?: string;
+    }): Promise<EventResult<'cmod.call'> | undefined>;
+    moved(): void;
+};
+export declare function serveConversations({ claude, router, store, project, report }: {
+    readonly claude: Claude;
+    readonly router: Router;
+    readonly store: string;
+    readonly project: () => string;
+    readonly report: (id: string, message: string, error: unknown) => void;
+}): Conversations;
+//# sourceMappingURL=conversations.d.ts.map

package/runtime/conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../src/runtime/conversations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAY5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AA2BzC,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC,CAAA;IAClH,KAAK,IAAI,IAAI,CAAA;CACd,CAAA;AAED,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE,GAAG,aAAa,CAugBlR"}