@cmodjs/core 0.3.0 → 1.0.0

package/src/ui/places.ts

@@ -0,0 +1,49 @@
+import type { Frozen, RenderComponent, RenderElement, RenderPropsOf } from 'claude-code'
+import type { BlockProps, MarkdownPlace } from './markdown.js'
+
+export const ToolGroup = 'toolGroup'
+export const ToolProgress = 'toolProgress'
+export const CommandOutput = 'commandOutput'
+export const AskUserQuestion = 'askUserQuestion'
+export const Spinner = 'spinner'
+export const TurnDuration = 'turnDuration'
+export const SessionMode = 'sessionMode'
+export const PromptHint = 'promptHint'
+export const AbovePrompt = 'abovePrompt'
+
+const components = {
+  prompt: 'UserMessage',
+  reply: 'AssistantMessage',
+  toolCall: 'ToolUse',
+  toolResult: 'ToolResult',
+  notice: 'InfoNotice',
+  [ToolGroup]: 'ToolGroup',
+  [ToolProgress]: 'ToolProgress',
+  [CommandOutput]: 'CommandOutput',
+  [AskUserQuestion]: 'AskUserQuestion',
+  [Spinner]: 'Spinner',
+  [TurnDuration]: 'TurnDuration',
+  [SessionMode]: 'SessionMode',
+  [PromptHint]: 'PromptHint',
+  [AbovePrompt]: 'AbovePrompt',
+} as const satisfies Readonly<Record<string, Exclude<RenderComponent, 'Pane'>>>
+
+export type ComponentPlace = keyof typeof components
+
+export type Place = ComponentPlace | MarkdownPlace
+
+type ComponentProps = { readonly [P in ComponentPlace]: RenderPropsOf[(typeof components)[P]] }
+
+type PropsOf<P extends Place> = P extends ComponentPlace ? ComponentProps[P] : P extends MarkdownPlace<infer Type> ? BlockProps<Type> : never
+
+type DefaultOf<P extends Place> = P extends ComponentPlace ? Partial<Omit<ComponentProps[P], 'onScreen'>> : { readonly source?: string }
+
+export type PlaceProps<P extends Place> = Frozen<PropsOf<P>> & { readonly Default: (props: Frozen<DefaultOf<P>>) => RenderElement }
+
+export function componentOf(place: Place): Exclude<RenderComponent, 'Pane'> | undefined {
+  return typeof place === 'string' && Object.hasOwn(components, place) ? components[place] : undefined
+}
+
+export function nameOf(place: Place): string {
+  return typeof place === 'string' ? `${place.charAt(0).toUpperCase()}${place.slice(1)}` : place.name
+}

package/src/utils/call-effects.ts

@@ -1,12 +1,12 @@
 import { parseShell, type ShellCommand } from './parse-shell.js'
-import { expandHome, type FileSystem } from './paths.js'
+import { expandHome, ifMissing, type FileSystem } from './paths.js'
 import { resolve } from '../vendor.js'
 
 export type CallBase = { tool: string; input: Readonly<Record<string, unknown>>; agentId?: string; agentType?: string }
 export type CommandCall = CallBase & { commands: [string, ...string[]][]; isFullyParsed: boolean }
 export type FileCall = CallBase & { path: string; content?: string; previousContent?: string }
 export type FetchCall = CallBase & { url: string }
-export type ToolCall = CommandCall | FileCall | FetchCall | CallBase
+export type Call = CommandCall | FileCall | FetchCall | CallBase
 
 export type Contents = { content?: string; previousContent?: string }
 export type FileAccess = { path: string; contents: (() => Promise<Contents>) | undefined }
@@ -79,7 +79,7 @@ async function editedContents(use: CallBase, path: string, fs: FileSystem): Prom
 }
 
 async function previousContentOf(path: string, fs: FileSystem): Promise<string | undefined> {
-  const stat = await fs.stat(path).catch(() => undefined)
+  const stat = await fs.stat(path).catch(ifMissing(undefined))
   return stat?.kind === 'file' ? fs.read(path) : undefined
 }
 

package/src/utils/changelog.ts

@@ -0,0 +1,32 @@
+export type ChangelogSection = { readonly version: string; readonly date?: string; readonly text: string }
+
+export const unreleased = 'Unreleased'
+
+const heading = /^##\s+\[?([^\]\s]+)\]?(?:\s+-\s+(\S+))?\s*$/
+
+const linkReference = /^\[[^\]]+\]:\s/
+
+export function changelogSections(markdown: string): ChangelogSection[] {
+  const sections: { readonly version: string; readonly date: string | undefined; readonly lines: string[] }[] = []
+  for (const line of markdown.split('\n')) {
+    const match = heading.exec(line)
+    if (match !== null) sections.push({ version: match[1] as string, date: match[2], lines: [] })
+    else if (!linkReference.test(line)) sections.at(-1)?.lines.push(line)
+  }
+  return sections.map(({ version, date, lines }) => ({ version, ...(date === undefined ? {} : { date }), text: lines.join('\n').trim() }))
+}
+
+export function changeLines(text: string): string[] {
+  let group: string | undefined
+  return text.split('\n').flatMap((line) => {
+    const trimmed = line.trim()
+    const subheading = /^###\s+(.+)$/.exec(trimmed)?.[1]
+    if (subheading !== undefined) {
+      group = subheading
+      return []
+    }
+    const item = /^[-*]\s+(.+)$/.exec(trimmed)?.[1] ?? trimmed
+    if (item === '') return []
+    return [group === undefined ? item : `${group}: ${item}`]
+  })
+}

package/src/utils/matcher.ts

@@ -0,0 +1,37 @@
+export type Matcher<Value> = Value extends string
+  ? string | RegExp
+  : Value extends number | boolean | null | undefined
+    ? Value
+    : Value extends readonly (infer Item)[]
+      ? Matcher<Item>
+      : Value extends (...args: never[]) => unknown
+        ? never
+        : Value extends object
+          ? { readonly [Key in keyof Value]?: Matcher<Value[Key]> }
+          : Value
+
+export type SentMatcher = string | number | boolean | null | { readonly regexp: string; readonly flags: string } | { readonly [key: string]: SentMatcher } | readonly SentMatcher[]
+
+export function matches(value: unknown, matcher: unknown): boolean {
+  if (matcher instanceof RegExp) return matcher.test(String(value))
+  if (Array.isArray(matcher)) return matcher.some((each) => matches(value, each))
+  if (typeof matcher !== 'object' || matcher === null) return value === matcher
+  if (Array.isArray(value)) return value.some((each) => matches(each, matcher))
+  if (typeof value !== 'object' || value === null) return false
+  return Object.entries(matcher).every(([key, wanted]) => wanted === undefined || matches((value as Record<string, unknown>)[key], wanted))
+}
+
+export function sentMatcher(matcher: unknown): SentMatcher {
+  if (matcher instanceof RegExp) return { regexp: matcher.source, flags: matcher.flags }
+  if (Array.isArray(matcher)) return matcher.map(sentMatcher)
+  if (typeof matcher !== 'object' || matcher === null) return matcher as SentMatcher
+  return Object.fromEntries(Object.entries(matcher).filter(([, value]) => value !== undefined).map(([key, value]) => [key, sentMatcher(value)]))
+}
+
+export function receivedMatcher(sent: SentMatcher): unknown {
+  if (Array.isArray(sent)) return sent.map(receivedMatcher)
+  if (typeof sent !== 'object' || sent === null) return sent
+  const fields = sent as Readonly<Record<string, unknown>>
+  if (typeof fields['regexp'] === 'string' && typeof fields['flags'] === 'string' && Object.keys(fields).length === 2) return new RegExp(fields['regexp'], fields['flags'])
+  return Object.fromEntries(Object.entries(fields).map(([key, value]) => [key, receivedMatcher(value as SentMatcher)]))
+}

package/src/utils/metadata.ts

@@ -1,4 +1,4 @@
-export type MetadataFormat = { readonly kind: 'frontmatter' } | { readonly kind: 'comment'; readonly prefix: string } | { readonly kind: 'sidecar' }
+export type MetadataFormat = { readonly type: 'frontmatter' } | { readonly type: 'comment'; readonly prefix: string } | { readonly type: 'sidecar' }
 
 export type ReadMetadata = {
   readonly metadata: Readonly<Record<string, string>>
@@ -26,12 +26,12 @@ export function formatOf(path: string, firstLine: string | undefined): MetadataF
   const name = path.slice(path.lastIndexOf('/') + 1)
   const dot = name.lastIndexOf('.')
   const extension = dot <= 0 ? '' : name.slice(dot + 1).toLowerCase()
-  if (markdown.includes(extension)) return { kind: 'frontmatter' }
-  if (hashComments.includes(extension) || hashCommentNames.includes(name)) return { kind: 'comment', prefix: '#' }
-  if (slashComments.includes(extension)) return { kind: 'comment', prefix: '//' }
-  if (dashComments.includes(extension)) return { kind: 'comment', prefix: '--' }
-  if (extension === '' && firstLine?.startsWith('#!') === true) return { kind: 'comment', prefix: '#' }
-  return { kind: 'sidecar' }
+  if (markdown.includes(extension)) return { type: 'frontmatter' }
+  if (hashComments.includes(extension) || hashCommentNames.includes(name)) return { type: 'comment', prefix: '#' }
+  if (slashComments.includes(extension)) return { type: 'comment', prefix: '//' }
+  if (dashComments.includes(extension)) return { type: 'comment', prefix: '--' }
+  if (extension === '' && firstLine?.startsWith('#!') === true) return { type: 'comment', prefix: '#' }
+  return { type: 'sidecar' }
 }
 
 type Region = { readonly start: number; readonly end: number; readonly lines: readonly string[] }
@@ -42,21 +42,21 @@ type Block = { readonly start: number; readonly end: number; readonly entries: r
 
 export function readMetadata(text: string, format: MetadataFormat): ReadMetadata {
   const lines = text.split('\n')
-  if (format.kind === 'comment') {
+  if (format.type === 'comment') {
     const region = commentRegion(lines, format.prefix)
     return { metadata: region === undefined ? {} : asRecord(mapEntries(region.lines, region.start + 2, 0)) }
   }
-  const region = format.kind === 'frontmatter' ? frontmatterRegion(lines) : { start: -1, end: lines.length, lines }
+  const region = format.type === 'frontmatter' ? frontmatterRegion(lines) : { start: -1, end: lines.length, lines }
   if (region === undefined) return { metadata: {} }
   const block = metadataBlock(region)
-  const name = format.kind === 'frontmatter' ? topLevelScalar(region, 'name') : undefined
+  const name = format.type === 'frontmatter' ? topLevelScalar(region, 'name') : undefined
   return { metadata: block === undefined ? {} : asRecord(block.entries), ...(name === undefined ? {} : { name }) }
 }
 
 export function writeMetadata(text: string, format: MetadataFormat, metadata: Readonly<Record<string, string>>): string {
   const lines = text.split('\n')
   const entries = Object.entries(metadata)
-  if (format.kind === 'comment') {
+  if (format.type === 'comment') {
     const { prefix } = format
     const block = entries.length === 0 ? [] : [`${prefix} /// metadata`, ...entries.map(([key, value]) => `${prefix} ${scalar(key)}: ${scalar(value)}`), `${prefix} ///`]
     const region = commentRegion(lines, prefix)
@@ -66,7 +66,7 @@ export function writeMetadata(text: string, format: MetadataFormat, metadata: Re
     return [...lines.slice(0, at), ...block, ...lines.slice(at)].join('\n')
   }
   const map = entries.length === 0 ? [] : ['metadata:', ...entries.map(([key, value]) => `  ${scalar(key)}: ${scalar(value)}`)]
-  if (format.kind === 'sidecar') {
+  if (format.type === 'sidecar') {
     const block = metadataBlock({ start: -1, end: lines.length, lines })
     const rest = block === undefined ? lines : [...lines.slice(0, block.start), ...lines.slice(block.end)]
     const kept = rest.join('\n').trim()
@@ -206,7 +206,8 @@ function unquoted(text: string, lineNumber: number): string {
     if (!text.endsWith('"') || text.length < 2) throw new MetadataError(lineNumber, `${text} opens a double quote that never closes.`)
     try {
       return JSON.parse(text) as string
-    } catch {
+    } catch (error) {
+      if (!(error instanceof SyntaxError)) throw error
       throw new MetadataError(lineNumber, `${text} is not a double-quoted text. Escape a " inside it as \\".`)
     }
   }
@@ -224,8 +225,9 @@ function topLevelScalar(region: Region, key: string): string | undefined {
   if (text === '') return undefined
   try {
     return unquoted(text, region.start + 2 + at)
-  } catch {
-    return undefined
+  } catch (error) {
+    if (error instanceof MetadataError) return undefined
+    throw error
   }
 }
 

package/src/utils/parse-shell.ts

@@ -18,7 +18,7 @@ type Scan = { text: string; markers: Marker[]; end: number }
 type Redirect = { operator: string; target: Word }
 type Pipe = { writer: number | undefined }
 type Command = { words: Word[]; redirects: Redirect[]; pipe: Pipe | undefined }
-type Stdin = { kind: 'text'; text: string } | { kind: 'pipe' }
+type Stdin = { type: 'text'; text: string } | { type: 'pipe' }
 type Access = 'reads' | 'writes'
 type OptionSpec = { valued?: string; optional?: string; longValued?: readonly string[] }
 type Option = { name: string; value: Word | undefined }
@@ -211,7 +211,8 @@ function parseLine(line: string, folder: string, result: ParsedShell): void {
   try {
     const { text, markers } = scan(line, 0, false)
     walk(parse(text, (name) => (name === '' ? undefined : `$${name}`)), markers, folder, result)
-  } catch {
+  } catch (error) {
+    if (!(error instanceof SyntaxError) && !(error instanceof Error && error.message.startsWith('Bad substitution: '))) throw error
     result.isFullyParsed = false
   }
 }
@@ -546,7 +547,7 @@ function finish(command: Command, operator: string, folder: string, result: Pars
   const [first, ...args] = words
   if (first === undefined || first.text === 'for' || first.text === 'select') return folder
   const here = command.redirects.findLast((redirect) => redirect.operator === '<<<')
-  const stdin: Stdin | undefined = here !== undefined ? { kind: 'text', text: here.target.text } : command.pipe !== undefined ? { kind: 'pipe' } : undefined
+  const stdin: Stdin | undefined = here !== undefined ? { type: 'text', text: here.target.text } : command.pipe !== undefined ? { type: 'pipe' } : undefined
   const reader = result.commands.length
   const changed = addCommand(first, args, folder, stdin, result)
   const read = result.commands[reader]
@@ -629,7 +630,7 @@ function findStarts(args: Word[]): Word[] {
 
 function addWrapper(first: Word, program: string, args: Word[], folder: string, stdin: Stdin | undefined, result: ParsedShell): void {
   const wrapper = wrappers.get(program)!
-  if (program === 'xargs' && stdin?.kind !== 'text') result.isFullyParsed = false
+  if (program === 'xargs' && stdin?.type !== 'text') result.isFullyParsed = false
   const { options, operands } = readArguments(args, wrapper, true)
   let start = args.length - operands.length
   if (options.some((option) => wrapper.stops?.includes(option.name) === true)) start = args.length
@@ -669,8 +670,8 @@ function addEffects(program: string, args: Word[], flags: string[], folder: stri
   else if (inlineFlags !== undefined) {
     if (program === 'perl' && readArguments(args, perl, false).options.some((option) => option.name === '-i')) addFileArguments(perl, args, folder, result)
     const script = args.find((word) => !word.text.startsWith('-') || word.text === '-')
-    const readsCodeFromPipe = stdin?.kind === 'pipe' && (script === undefined || script.text === '-')
-    if (flags.some((flag) => inlineFlags.includes(flag)) || stdin?.kind === 'text' || readsCodeFromPipe) result.isFullyParsed = false
+    const readsCodeFromPipe = stdin?.type === 'pipe' && (script === undefined || script.text === '-')
+    if (flags.some((flag) => inlineFlags.includes(flag)) || stdin?.type === 'text' || readsCodeFromPipe) result.isFullyParsed = false
   }
 }
 
@@ -701,8 +702,8 @@ function addFetches(fetcher: OptionSpec, args: Word[], result: ParsedShell): voi
 }
 
 function addStdinCode(stdin: Stdin | undefined, folder: string, result: ParsedShell): void {
-  if (stdin?.kind === 'text') parseLine(stdin.text, folder, result)
-  if (stdin?.kind === 'pipe') result.isFullyParsed = false
+  if (stdin?.type === 'text') parseLine(stdin.text, folder, result)
+  if (stdin?.type === 'pipe') result.isFullyParsed = false
 }
 
 function addCopy(program: CopyProgram, args: Word[], folder: string, result: ParsedShell): void {

package/src/utils/paths.ts

@@ -1,4 +1,18 @@
 import { basename, dirname, resolve } from '../vendor.js'
+import { messageOf } from './text.js'
+
+const missingPath = /(?:^|: )(?:ENOENT|ENOTDIR)\b/
+
+export function isMissing(error: unknown): boolean {
+  return missingPath.test(messageOf(error))
+}
+
+export function ifMissing<Value>(value: Value): (error: unknown) => Value {
+  return (error) => {
+    if (isMissing(error)) return value
+    throw error
+  }
+}
 
 export type FileSystem = {
   read: (path: string) => Promise<string>
@@ -18,7 +32,7 @@ export function relativePath(base: string, path: string): string | undefined {
 }
 
 export async function realPathOf(path: string, fs: FileSystem): Promise<string | undefined> {
-  const stat = await fs.stat(path).catch(() => undefined)
+  const stat = await fs.stat(path).catch(ifMissing(undefined))
   if (stat !== undefined || path === '/') return stat?.realPath
   const folder = await realPathOf(dirname(path), fs)
   return folder === undefined ? undefined : resolve(folder, basename(path))

package/src/utils/text.ts

@@ -3,6 +3,10 @@ export function listed(items: readonly string[]): string {
   return `${items.slice(0, -1).join(', ')} and ${items.at(-1)}`
 }
 
+export function firstLine(text: string): string {
+  return text.split('\n').find((line) => line.trim() !== '')?.trim() ?? ''
+}
+
 export function messageOf(error: unknown): string {
   return error instanceof Error ? error.message : String(error)
 }

package/testing/fake-claude.d.ts

@@ -1,3 +1,4 @@
+import type { EventResult } from 'claude-code';
 import type { Claude } from '../runtime/claude.js';
 export type TestCall = {
     readonly call: string;
@@ -28,10 +29,12 @@ export type Fakes = {
         ask?: Claude['ui']['ask'];
         open?: Claude['ui']['open'];
         scroll?: Claude['ui']['scroll'];
+        copy?: Claude['ui']['copy'];
     };
     session: {
         messages?: Claude['session']['messages'];
         append?: Claude['session']['append'];
+        send?: Claude['session']['send'];
     };
     prompt: {
         submit?: Claude['prompt']['submit'];
@@ -60,7 +63,6 @@ export type ShownSchedule = {
     readonly prompt: string;
 };
 export type Shown = {
-    readonly toasts: string[];
     readonly notes: string[];
     readonly prompts: string[];
     readonly logs: string[];
@@ -79,6 +81,7 @@ export type FakeClaude = {
     readonly store: Map<string, unknown>;
     settle(): Promise<void>;
 };
+export declare function calledAnswer(caller: string, answer: EventResult<'cmod.call'>): unknown;
 export declare function fakeClaude(plugin: {
     readonly name: string;
     readonly root: string;

package/testing/fake-claude.d.ts.map

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

package/testing/fake-claude.js

@@ -1,8 +1,16 @@
+import { isObject } from '../records.js';
 import { elements } from './fake-elements.js';
+import { fakeFiles } from './fake-files.js';
+export function calledAnswer(caller, answer) {
+    if (isObject(answer) && typeof answer['deny'] === 'string')
+        throw new Error(`${caller}: $.cmod.call: ${answer['deny']}`);
+    return isObject(answer) ? answer['value'] : undefined;
+}
 export function fakeClaude(plugin) {
     const calls = [];
     const fakes = { process: {}, fs: {}, http: {}, settings: {}, config: {}, ui: {}, session: {}, prompt: {}, model: {}, agent: {}, clock: {}, cmod: {}, tool: {} };
-    const shown = { toasts: [], notes: [], prompts: [], logs: [], debug: [], statuses: [], openPanes: new Set(), commands: [], tools: [], schedules: [] };
+    const emptyDisk = fakeFiles({});
+    const shown = { notes: [], prompts: [], logs: [], debug: [], statuses: [], openPanes: new Set(), commands: [], tools: [], schedules: [] };
     const unplacedPanes = new Set();
     let focusedPane;
     const store = new Map();
@@ -49,9 +57,6 @@ export function fakeClaude(plugin) {
     const claude = {
         plugin,
         ui: {
-            toast: (text) => {
-                shown.toasts.push(text);
-            },
             status: (text) => {
                 shown.statuses.push(text);
             },
@@ -88,6 +93,7 @@ export function fakeClaude(plugin) {
                 ...[...unplacedPanes].map((id) => ({ id, title: id, isShown: false, isFocused: false, isPlaced: false })),
             ],
             scroll: rejected('ui.scroll', () => fakes.ui.scroll ?? (async () => ({}))),
+            copy: rejected('ui.copy', () => fakes.ui.copy ?? (async () => ({ isCopied: true }))),
             resolve: () => elements,
         },
         process: {
@@ -95,14 +101,14 @@ export function fakeClaude(plugin) {
             spawn: faked('process.spawn', () => fakes.process.spawn),
         },
         fs: {
-            read: rejected('fs.read', () => fakes.fs.read),
-            write: rejected('fs.write', () => fakes.fs.write),
-            list: rejected('fs.list', () => fakes.fs.list),
-            exists: rejected('fs.exists', () => fakes.fs.exists ?? (async () => false)),
-            stat: rejected('fs.stat', () => fakes.fs.stat),
+            read: rejected('fs.read', () => fakes.fs.read ?? emptyDisk.read),
+            write: rejected('fs.write', () => fakes.fs.write ?? emptyDisk.write),
+            list: rejected('fs.list', () => fakes.fs.list ?? emptyDisk.list),
+            exists: rejected('fs.exists', () => fakes.fs.exists ?? emptyDisk.exists),
+            stat: rejected('fs.stat', () => fakes.fs.stat ?? emptyDisk.stat),
         },
         http: { fetch: rejected('http.fetch', () => fakes.http.fetch) },
-        settings: { read: rejected('settings.read', () => fakes.settings.read) },
+        settings: { read: rejected('settings.read', () => fakes.settings.read ?? (async () => ({}))) },
         config: {
             list: rejected('config.list', () => fakes.config.list ?? (async () => [])),
         },
@@ -130,10 +136,11 @@ export function fakeClaude(plugin) {
             root: async () => plugin.root,
             cwd: async () => plugin.root,
             model: async () => 'test-model',
-            usage: async () => ({ context: { window: 200000 }, rateLimits: {}, cost: { usd: 0 } }),
+            usage: async () => ({ startedAt: Date.parse('2026-01-01T00:00:00.000Z'), context: { window: 200000 }, rateLimits: [], cost: { usd: 0 } }),
             surfaces: async () => ['terminal'],
             messages: rejected('session.messages', () => fakes.session.messages),
             append: rejected('session.append', () => fakes.session.append ?? appendNote),
+            send: rejected('session.send', () => fakes.session.send ?? (async () => ({ isDelivered: true }))),
         },
         prompt: { submit: rejected('prompt.submit', () => fakes.prompt.submit ?? submitPrompt) },
         model: { complete: rejected('model.complete', () => fakes.model.complete) },

package/testing/fake-elements.js

@@ -119,8 +119,10 @@ function sideBySide(children, width, gap) {
 function minWidthOf(node) {
     if (typeof node === 'string')
         return 0;
-    const minWidth = insideOf(node).props['minWidth'];
-    return typeof minWidth === 'number' ? minWidth : 0;
+    const { props } = insideOf(node);
+    if (props['flexShrink'] === 0)
+        return Number.POSITIVE_INFINITY;
+    return typeof props['minWidth'] === 'number' ? props['minWidth'] : 0;
 }
 function blankRows(count) {
     return Array.from({ length: count }, () => '');

package/testing/fake-files.js

@@ -37,7 +37,7 @@ export function fakeFiles(files, links = {}) {
         },
         list: async (path) => {
             if (path === undefined)
-                throw new Error('fs.list() lists the working folder, which the fake files do not know. Name the folder, such as fs.list(mod.cwd).');
+                throw new Error('fs.list() lists the working folder, which the fake files do not know. Name the folder, such as fs.list(sessions.current.cwd).');
             const folder = realPathOf(path);
             if (kindOf(folder) !== 'dir')
                 throw new Error(`ENOENT: no such directory, list '${path}'`);

package/testing/fake-sessions.d.ts

@@ -0,0 +1,74 @@
+import { Document } from '../session/context/turn/message/document.js';
+import { Message } 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 { type Sender } 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 { type SessionChange, type SessionData } from '../session/conversation.js';
+export type MessageDraft = {
+    readonly type: typeof Prompt;
+    readonly text: string;
+    readonly from?: Sender;
+} | {
+    readonly type: typeof Note;
+    readonly text: string;
+    readonly from?: Sender;
+} | {
+    readonly type: typeof Reply;
+    readonly text: string;
+} | {
+    readonly type: typeof ToolCall;
+    readonly name: string;
+    readonly input?: Readonly<Record<string, unknown>>;
+    readonly callId?: string;
+} | {
+    readonly type: typeof ToolResult;
+    readonly callId: string;
+    readonly text: string;
+    readonly isError?: boolean;
+} | {
+    readonly type: typeof Skill;
+    readonly name: string;
+    readonly text: string;
+} | {
+    readonly type: typeof Document;
+    readonly path: string;
+    readonly text: string;
+} | {
+    readonly type: typeof Notice;
+    readonly text: string;
+};
+export type FakeSession = Partial<Omit<SessionData, 'id'>> & {
+    readonly id: string;
+    readonly messages?: readonly MessageDraft[];
+    readonly goal?: string;
+};
+export type FakeSessions = {
+    answer(caller: string, method: string, input: unknown): unknown;
+    add(draft: MessageDraft, task?: string): Message[];
+    endTurn(): void;
+    compact(): void;
+    startTask(task: {
+        readonly title: string;
+        readonly agentType?: string;
+        readonly model?: string;
+        readonly openedBy?: string;
+    }): string;
+    start(id: string): void;
+    readonly sent: {
+        readonly session: string;
+        readonly type: string;
+        readonly text: string;
+        readonly as?: string;
+    }[];
+};
+export declare function fakeSessions({ project, given, push }: {
+    readonly project: () => string;
+    readonly given: readonly FakeSession[];
+    readonly push: (mod: string, session: string, change: SessionChange) => void;
+}): FakeSessions;
+//# sourceMappingURL=fake-sessions.d.ts.map

package/testing/fake-sessions.d.ts.map

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