@jinion/core 0.2.1 → 0.4.0

package/dist/files/operations.js

@@ -0,0 +1,173 @@
+import { cp, lstat, mkdir, realpath, writeFile } from 'node:fs/promises';
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
+import { within } from '../lib/paths.js';
+import { freeName } from './names.js';
+import { fromTrash, moveAcross, restorable, toTrash } from './trash.js';
+/** Why an operation was refused, for the API to tell as its own error. */
+export class FileProblem extends Error {
+    kind;
+    path;
+    constructor(kind, message, path) {
+        super(message);
+        this.kind = kind;
+        this.path = path;
+    }
+}
+/**
+ * What can change which files a folder holds: each keeps to the folder, by real paths, so neither `..` nor a link
+ * leads out of it, and a name already taken is refused unless `replace` says to move what holds it to the Trash.
+ */
+export class FolderFiles {
+    root;
+    constructor(root) {
+        this.root = root;
+    }
+    static async of(folder) {
+        return new FolderFiles(await realpath(folder));
+    }
+    /** A file, empty or with `content`, or a folder; the folders it is in are made as needed. */
+    async create(path, { folder = false, content, replace = false }) {
+        const target = await this.target(path);
+        const replaced = await this.clear(target, replace);
+        await mkdir(dirname(target), { recursive: true });
+        if (folder)
+            await mkdir(target);
+        else
+            await writeFile(target, content ?? '', { flag: 'wx' });
+        return { path: this.named(target), replaced };
+    }
+    /** Gives a file or folder another name where it is. */
+    async rename(path, name, replace = false) {
+        if (!name || name === '.' || name === '..' || name.includes('/') || name.includes(sep)) {
+            throw new FileProblem('invalid', `“${name}” can't be a file's name.`);
+        }
+        const source = await this.existing(path);
+        return this.relocate([[source, join(dirname(source), name)]], replace);
+    }
+    /**
+     * Moves files and folders into a folder of the session's, each keeping its name; with `keepBoth`, one whose name is
+     * taken there takes the next free one, as the Finder's Keep Both names it, `box 2.tsx`.
+     */
+    async move(paths, into, replace = false, keepBoth = false) {
+        const folder = await this.folderAt(into);
+        const sources = await Promise.all(paths.map((path) => this.existing(path)));
+        const pairs = [];
+        for (const source of sources)
+            pairs.push([source, join(folder, keepBoth && dirname(source) !== folder ? await freeName(folder, basename(source), '') : basename(source))]);
+        return this.relocate(pairs, replace);
+    }
+    /**
+     * Copies files and folders into a folder of the session's: ones of the folder by their paths in it, others, as files
+     * dropped from the Finder, by their whole paths. Copied into the folder it is in, a copy takes a name of its own, as
+     * one whose name is taken does with `keepBoth`.
+     */
+    async copy(paths, into, replace = false, keepBoth = false) {
+        const folder = await this.folderAt(into);
+        const copied = [];
+        const replaced = [];
+        for (const path of paths) {
+            const source = isAbsolute(path) && within(path, this.root) === undefined ? await this.outside(path) : await this.existing(path);
+            const own = dirname(source) === folder;
+            const name = own ? await freeName(folder, basename(source), 'copy') : keepBoth ? await freeName(folder, basename(source), '') : basename(source);
+            const target = join(folder, name);
+            this.notInto(source, target);
+            replaced.push(...(await this.clear(target, replace)));
+            await cp(source, target, { recursive: true, verbatimSymlinks: true, errorOnExist: true, force: false });
+            copied.push({ from: within(source, this.root) === undefined ? source : this.named(source), to: this.named(target) });
+        }
+        return { copied, replaced };
+    }
+    /** Moves files and folders to the Trash. */
+    async delete(paths) {
+        const sources = await Promise.all(paths.map((path) => this.existing(path)));
+        const trashed = [];
+        for (const source of sources)
+            trashed.push({ path: this.named(source), trash: await toTrash(source) });
+        return trashed;
+    }
+    /** Puts back what `delete` or a replace sent to the Trash, at the path it had. */
+    async restore(items, replace = false) {
+        const restored = [];
+        const replaced = [];
+        for (const { path, trash } of items) {
+            const target = await this.target(path);
+            if (!(await restorable(trash)))
+                throw new FileProblem('missing', `${path} isn't in the Trash any more.`, path);
+            replaced.push(...(await this.clear(target, replace)));
+            await fromTrash(trash, target);
+            restored.push(this.named(target));
+        }
+        return { restored, replaced };
+    }
+    /** A folder of the session's by its path there, `''` for the folder itself, as a whole path. */
+    async folderAt(path) {
+        const folder = path === '' || path === '.' ? this.root : await this.existing(path).then((each) => realpath(each));
+        const info = await lstat(folder);
+        if (!info.isDirectory() || within(folder, this.root) === undefined)
+            throw new FileProblem('missing', `${path} isn't a folder in this session's folder.`, path);
+        return folder;
+    }
+    async relocate(pairs, replace) {
+        const moved = [];
+        const replaced = [];
+        for (const [source, target] of pairs) {
+            if (source === target)
+                continue;
+            this.notInto(source, target);
+            // A name that differs only in case is the same file on a disk that ignores case, which is no clash.
+            if (!(await sameFile(source, target)))
+                replaced.push(...(await this.clear(target, replace)));
+            await moveAcross(source, target);
+            moved.push({ from: this.named(source), to: this.named(target) });
+        }
+        return { moved, replaced };
+    }
+    notInto(source, target) {
+        if (target.startsWith(`${source}${sep}`))
+            throw new FileProblem('invalid', `${this.named(source)} can't go into itself.`, this.named(source));
+    }
+    /** What holds `target`, to the Trash when `replace` says so. */
+    async clear(target, replace) {
+        if (!(await lstat(target).catch(() => undefined)))
+            return [];
+        if (!replace)
+            throw new FileProblem('taken', `${this.named(target)} is already there.`, this.named(target));
+        return [{ path: this.named(target), trash: await toTrash(target) }];
+    }
+    // A path that is there, its last part not followed, so a link is moved itself rather than what it points at.
+    async existing(path) {
+        const absolute = resolve(this.root, path);
+        const parent = within(absolute, this.root) === undefined ? undefined : await realpath(dirname(absolute)).catch(() => undefined);
+        const file = parent && join(parent, basename(absolute));
+        const there = file && file !== this.root && within(file, this.root) !== undefined && (await lstat(file).catch(() => undefined));
+        if (!file || !there)
+            throw new FileProblem('missing', `${path} isn't in this session's folder.`, path);
+        return file;
+    }
+    async outside(path) {
+        if (!(await lstat(path).catch(() => undefined)))
+            throw new FileProblem('missing', `${path} isn't there.`, path);
+        return path;
+    }
+    /** Where something new goes: under the deepest folder of its path that is there, which has to be in the folder. */
+    async target(path) {
+        const absolute = resolve(this.root, path);
+        if (within(absolute, this.root) === undefined || absolute === this.root)
+            throw new FileProblem('missing', `${path} isn't in this session's folder.`, path);
+        let base = dirname(absolute);
+        while (!(await lstat(base).catch(() => undefined)))
+            base = dirname(base);
+        const real = await realpath(base);
+        if (within(real, this.root) === undefined)
+            throw new FileProblem('missing', `${path} isn't in this session's folder.`, path);
+        return join(real, relative(base, absolute));
+    }
+    named(file) {
+        return relative(this.root, file);
+    }
+}
+async function sameFile(one, other) {
+    const [a, b] = await Promise.all([lstat(one), lstat(other).catch(() => undefined)]);
+    return b !== undefined && a.dev === b.dev && a.ino === b.ino;
+}
+//# sourceMappingURL=operations.js.map

package/dist/files/operations.js.map

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

package/dist/files/search.d.ts

@@ -0,0 +1,11 @@
+import type { Replaced, SearchQuery, SearchResults } from './types.js';
+/** What `query` asks for as a regular expression; throws one that isn't valid. */
+export declare function patternOf({ query, caseSensitive, wholeWord, regex }: SearchQuery): RegExp;
+/** Every line of the folder's files the query finds, file by file in the order git lists them, up to a limit. */
+export declare function searchFiles(folder: string, search: SearchQuery): Promise<SearchResults>;
+/**
+ * Replaces what the query finds with `replacement` in the folder's files, or in `paths` of them only, and writes those
+ * it changed. In a regular expression `$1` and the like stand for what it caught; otherwise the text goes in as it is.
+ */
+export declare function replaceInFiles(folder: string, search: SearchQuery, replacement: string, paths?: string[]): Promise<Replaced>;
+//# sourceMappingURL=search.d.ts.map

package/dist/files/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/files/search.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAe,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AASpF,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,WAAW,UAIhF;AAED,iHAAiH;AACjH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAqB7F;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsBlI"}

package/dist/files/search.js

@@ -0,0 +1,112 @@
+import { readFile, stat, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { matchesGlob } from '../lib/glob.js';
+import { listProjectFiles } from '../prompt/files.js';
+// Large enough for any source file; a bigger one is data, a bundle or a log, and would slow every search down.
+const MAX_BYTES = 1024 * 1024;
+const MAX_MATCHES = 5000;
+const MAX_LINE = 500;
+// Files read at once: enough to keep the disk busy, few enough not to run out of handles in a large project.
+const AT_ONCE = 32;
+/** What `query` asks for as a regular expression; throws one that isn't valid. */
+export function patternOf({ query, caseSensitive, wholeWord, regex }) {
+    const source = regex ? query : query.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(wholeWord ? `\\b(?:${source})\\b` : source, caseSensitive ? 'g' : 'gi');
+}
+/** Every line of the folder's files the query finds, file by file in the order git lists them, up to a limit. */
+export async function searchFiles(folder, search) {
+    const pattern = patternOf(search);
+    const files = [];
+    let found = 0;
+    await eachText(folder, await candidates(folder, search), (path, text) => {
+        if (found >= MAX_MATCHES)
+            return false;
+        const matches = matchesIn(text, pattern, MAX_MATCHES - found);
+        if (matches.length > 0) {
+            files.push({ path, matches });
+            found += matches.reduce((sum, match) => sum + match.ranges.length, 0);
+        }
+        return true;
+    });
+    files.sort((a, b) => a.path.localeCompare(b.path));
+    return { files, truncated: found >= MAX_MATCHES };
+}
+/**
+ * Replaces what the query finds with `replacement` in the folder's files, or in `paths` of them only, and writes those
+ * it changed. In a regular expression `$1` and the like stand for what it caught; otherwise the text goes in as it is.
+ */
+export async function replaceInFiles(folder, search, replacement, paths) {
+    // Line by line, as the search found them: `^` and `$` stand for a line's start and end.
+    const pattern = new RegExp(patternOf(search).source, `${patternOf(search).flags}m`);
+    const text = search.regex ? replacement : replacement.replaceAll('$', '$$$$');
+    const chosen = (await candidates(folder, search)).filter((path) => !paths || paths.includes(path));
+    const changed = [];
+    let replacements = 0;
+    await eachText(folder, chosen, (path, content) => {
+        const count = [...content.matchAll(pattern)].filter((found) => found[0] !== '').length;
+        if (count > 0) {
+            changed.push({ path, text: content.replace(pattern, text) });
+            replacements += count;
+        }
+        return true;
+    });
+    await Promise.all(changed.map(({ path, text: next }) => writeFile(join(folder, path), next)));
+    return { files: changed.length, replacements };
+}
+/** The folder's files the search's globs let in, as git lists them, so ignored ones stay out. */
+async function candidates(folder, { include, exclude }) {
+    const included = globsOf(include);
+    const excluded = globsOf(exclude);
+    return (await listProjectFiles(folder)).filter((path) => !path.endsWith('/') && (included.length === 0 || included.some((glob) => fits(glob, path))) && !excluded.some((glob) => fits(glob, path)));
+}
+/** Each file's text, a few at a time, till `each` says to stop; one too large or not text is passed. */
+async function eachText(folder, paths, each) {
+    for (let start = 0; start < paths.length; start += AT_ONCE) {
+        const read = await Promise.all(paths.slice(start, start + AT_ONCE).map(async (path) => {
+            const file = join(folder, path);
+            const info = await stat(file).catch(() => undefined);
+            if (!info?.isFile() || info.size > MAX_BYTES)
+                return undefined;
+            const text = await readFile(file, 'utf8').catch(() => undefined);
+            return text === undefined || text.includes('\u0000') ? undefined : { path, text };
+        }));
+        for (const file of read)
+            if (file && !each(file.path, file.text))
+                return;
+    }
+}
+function matchesIn(text, pattern, room) {
+    const matches = [];
+    const lines = text.split(/\r?\n/);
+    let left = room;
+    for (let index = 0; index < lines.length && left > 0; index++) {
+        const line = lines[index];
+        const ranges = [];
+        pattern.lastIndex = 0;
+        for (let found = pattern.exec(line); found && left > 0; found = pattern.exec(line)) {
+            // One that finds nothing, as `^`, would find it again at the same place for ever.
+            if (found[0] === '') {
+                pattern.lastIndex++;
+                continue;
+            }
+            if (found.index < MAX_LINE)
+                ranges.push([found.index, Math.min(found.index + found[0].length, MAX_LINE)]);
+            left--;
+        }
+        if (ranges.length > 0)
+            matches.push({ line: index + 1, text: line.slice(0, MAX_LINE), ranges });
+    }
+    return matches;
+}
+function globsOf(list) {
+    return (list ?? '')
+        .split(',')
+        .map((glob) => glob.trim())
+        .filter(Boolean);
+}
+/** A glob fits a file itself, or a folder it is in, as `src` lets in everything under it. */
+function fits(glob, path) {
+    const parts = path.split('/');
+    return parts.some((_, index) => matchesGlob(glob, parts.slice(0, index + 1).join('/')));
+}
+//# sourceMappingURL=search.js.map

package/dist/files/search.js.map

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

package/dist/files/trash.d.ts

@@ -0,0 +1,11 @@
+export declare class TrashUnsupported extends Error {
+}
+/** Moves a file or folder to the Trash, as the Finder would, under a name free there; where it went. */
+export declare function toTrash(path: string): Promise<string>;
+/** Whether `fromTrash` can put it back: `toTrash` moved it there, and it is still there. */
+export declare function restorable(trash: string): Promise<boolean>;
+/** Puts what `toTrash` moved back at `path`, once `restorable` said it can. */
+export declare function fromTrash(trash: string, path: string): Promise<void>;
+/** A rename, or a copy and a removal where the two are on different disks, as a project on another volume is. */
+export declare function moveAcross(from: string, to: string): Promise<void>;
+//# sourceMappingURL=trash.d.ts.map

package/dist/files/trash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trash.d.ts","sourceRoot":"","sources":["../../src/files/trash.ts"],"names":[],"mappings":"AAQA,qBAAa,gBAAiB,SAAQ,KAAK;CAAG;AAE9C,wGAAwG;AACxG,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,mBAiBzC;AAED,4FAA4F;AAC5F,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,oBAE7C;AAED,+EAA+E;AAC/E,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,iBAO1D;AAED,iHAAiH;AACjH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,iBASxD"}

package/dist/files/trash.js

@@ -0,0 +1,64 @@
+import { cp, lstat, mkdir, rename, rm, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { basename, dirname, join } from 'node:path';
+import { freeName } from './names.js';
+/** What this process put in the Trash, so only that can be taken back out through it. */
+const trashed = new Set();
+export class TrashUnsupported extends Error {
+}
+/** Moves a file or folder to the Trash, as the Finder would, under a name free there; where it went. */
+export async function toTrash(path) {
+    const { files, info } = trashFolders();
+    await mkdir(files, { recursive: true });
+    const name = await freeName(files, basename(path), '');
+    const trash = join(files, name);
+    if (info) {
+        await mkdir(info, { recursive: true });
+        await writeFile(join(info, `${name}.trashinfo`), `[Trash Info]\nPath=${encodeURI(path)}\nDeletionDate=${localDate(new Date())}\n`);
+    }
+    await moveAcross(path, trash);
+    trashed.add(trash);
+    return trash;
+}
+/** Whether `fromTrash` can put it back: `toTrash` moved it there, and it is still there. */
+export async function restorable(trash) {
+    return trashed.has(trash) && (await lstat(trash).then(() => true, () => false));
+}
+/** Puts what `toTrash` moved back at `path`, once `restorable` said it can. */
+export async function fromTrash(trash, path) {
+    const { info } = trashFolders();
+    await mkdir(dirname(path), { recursive: true });
+    await moveAcross(trash, path);
+    trashed.delete(trash);
+    if (info)
+        await rm(join(info, `${basename(trash)}.trashinfo`), { force: true });
+}
+/** A rename, or a copy and a removal where the two are on different disks, as a project on another volume is. */
+export async function moveAcross(from, to) {
+    try {
+        await rename(from, to);
+    }
+    catch (error) {
+        if (error.code !== 'EXDEV')
+            throw error;
+        await cp(from, to, { recursive: true, verbatimSymlinks: true, errorOnExist: true, force: false });
+        await rm(from, { recursive: true, force: true });
+    }
+}
+// The Finder's Trash takes what is moved into it without the record its own Put Back reads, which only the Finder
+// writes; Jinion puts back what it trashed itself. Elsewhere, the trash freedesktop.org describes, record and all.
+function trashFolders() {
+    if (process.env.JINION_TRASH)
+        return { files: process.env.JINION_TRASH };
+    if (process.platform === 'darwin')
+        return { files: join(homedir(), '.Trash') };
+    if (process.platform === 'win32')
+        throw new TrashUnsupported("Moving to the Recycle Bin isn't supported on Windows yet.");
+    const trash = join(process.env.XDG_DATA_HOME ?? join(homedir(), '.local', 'share'), 'Trash');
+    return { files: join(trash, 'files'), info: join(trash, 'info') };
+}
+function localDate(date) {
+    const two = (value) => String(value).padStart(2, '0');
+    return `${date.getFullYear()}-${two(date.getMonth() + 1)}-${two(date.getDate())}T${two(date.getHours())}:${two(date.getMinutes())}:${two(date.getSeconds())}`;
+}
+//# sourceMappingURL=trash.js.map

package/dist/files/trash.js.map

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

package/dist/files/types.d.ts

@@ -0,0 +1,112 @@
+import { z } from 'zod';
+/** What to find in the folder's files, and in which of them. */
+export declare const SearchQuery: z.ZodObject<{
+    query: z.ZodString;
+    caseSensitive: z.ZodOptional<z.ZodBoolean>;
+    wholeWord: z.ZodOptional<z.ZodBoolean>;
+    regex: z.ZodOptional<z.ZodBoolean>;
+    include: z.ZodOptional<z.ZodString>;
+    exclude: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SearchQuery = z.infer<typeof SearchQuery>;
+/** A line with what was found in it, as `[start, end)` places in `text`, counted from 0. */
+export declare const SearchMatch: z.ZodObject<{
+    line: z.ZodNumber;
+    text: z.ZodString;
+    ranges: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+}, z.core.$strip>;
+export type SearchMatch = z.infer<typeof SearchMatch>;
+export declare const FileMatches: z.ZodObject<{
+    path: z.ZodString;
+    matches: z.ZodArray<z.ZodObject<{
+        line: z.ZodNumber;
+        text: z.ZodString;
+        ranges: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type FileMatches = z.infer<typeof FileMatches>;
+/** `truncated` when there were more than are given. */
+export declare const SearchResults: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        matches: z.ZodArray<z.ZodObject<{
+            line: z.ZodNumber;
+            text: z.ZodString;
+            ranges: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    truncated: z.ZodBoolean;
+}, z.core.$strip>;
+export type SearchResults = z.infer<typeof SearchResults>;
+export declare const Replaced: z.ZodObject<{
+    files: z.ZodNumber;
+    replacements: z.ZodNumber;
+}, z.core.$strip>;
+export type Replaced = z.infer<typeof Replaced>;
+/**
+ * A file a client watches changed on disk: its time now, none once it is gone. Moved or renamed through the API, with
+ * `movedTo`, its path now, which is watched from then on in its place.
+ */
+export declare const FileChanged: z.ZodObject<{
+    session: z.ZodString;
+    path: z.ZodString;
+    modified: z.ZodOptional<z.ZodNumber>;
+    movedTo: z.ZodOptional<z.ZodString>;
+    by: z.ZodOptional<z.ZodEnum<{
+        agent: "agent";
+        other: "other";
+    }>>;
+}, z.core.$strip>;
+export type FileChanged = z.infer<typeof FileChanged>;
+/** A file or folder moved, renamed or copied, by its paths in the session's folder; a copy from outside it, by its whole path. */
+export declare const Moved: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+}, z.core.$strip>;
+export type Moved = z.infer<typeof Moved>;
+/** What went to the Trash: its path in the session's folder, and its whole path in the Trash, by which it is put back. */
+export declare const Trashed: z.ZodObject<{
+    path: z.ZodString;
+    trash: z.ZodString;
+}, z.core.$strip>;
+export type Trashed = z.infer<typeof Trashed>;
+/** What a call did, so a client can undo it; `replaced`, what was in the way and went to the Trash for it. */
+export declare const FilesMoved: z.ZodObject<{
+    moved: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, z.core.$strip>>;
+    replaced: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        trash: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type FilesMoved = z.infer<typeof FilesMoved>;
+export declare const FilesCopied: z.ZodObject<{
+    copied: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, z.core.$strip>>;
+    replaced: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        trash: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type FilesCopied = z.infer<typeof FilesCopied>;
+export declare const FileCreated: z.ZodObject<{
+    path: z.ZodString;
+    replaced: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        trash: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type FileCreated = z.infer<typeof FileCreated>;
+export declare const FilesRestored: z.ZodObject<{
+    restored: z.ZodArray<z.ZodString>;
+    replaced: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        trash: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type FilesRestored = z.infer<typeof FilesRestored>;
+//# sourceMappingURL=types.d.ts.map

package/dist/files/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/files/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gEAAgE;AAChE,eAAO,MAAM,WAAW;;;;;;;iBAWtB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,4FAA4F;AAC5F,eAAO,MAAM,WAAW;;;;iBAKtB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,WAAW;;;;;;;iBAAgE,CAAC;AAEzF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,uDAAuD;AACvD,eAAO,MAAM,aAAa;;;;;;;;;;iBAAoE,CAAC;AAE/F,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,QAAQ;;;iBAAwE,CAAC;AAE9F,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;iBAOtB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,kIAAkI;AAClI,eAAO,MAAM,KAAK;;;iBAAiD,CAAC;AAEpE,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;AAE1C,0HAA0H;AAC1H,eAAO,MAAM,OAAO;;;iBAAoD,CAAC;AAEzE,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AAE9C,8GAA8G;AAC9G,eAAO,MAAM,UAAU;;;;;;;;;iBAAkE,CAAC;AAE1F,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,WAAW;;;;;;;;;iBAAmE,CAAC;AAE5F,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,WAAW;;;;;;iBAA6D,CAAC;AAEtF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,aAAa;;;;;;iBAA0E,CAAC;AAErG,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/files/types.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+/** What to find in the folder's files, and in which of them. */
+export const SearchQuery = z.object({
+    query: z.string().min(1),
+    caseSensitive: z.boolean().optional(),
+    /** Only where it stands as a word of its own. */
+    wholeWord: z.boolean().optional(),
+    /** `query` is a regular expression, as JavaScript reads one. */
+    regex: z.boolean().optional(),
+    /** Globs, by commas, as `src, *.ts`: only the files one fits, or a folder of them. */
+    include: z.string().optional(),
+    /** Globs the same way, for files left out. */
+    exclude: z.string().optional(),
+});
+/** A line with what was found in it, as `[start, end)` places in `text`, counted from 0. */
+export const SearchMatch = z.object({
+    /** Counted from 1. */
+    line: z.number().int(),
+    text: z.string(),
+    ranges: z.array(z.tuple([z.number().int(), z.number().int()])),
+});
+export const FileMatches = z.object({ path: z.string(), matches: z.array(SearchMatch) });
+/** `truncated` when there were more than are given. */
+export const SearchResults = z.object({ files: z.array(FileMatches), truncated: z.boolean() });
+export const Replaced = z.object({ files: z.number().int(), replacements: z.number().int() });
+/**
+ * A file a client watches changed on disk: its time now, none once it is gone. Moved or renamed through the API, with
+ * `movedTo`, its path now, which is watched from then on in its place.
+ */
+export const FileChanged = z.object({
+    session: z.string(),
+    path: z.string(),
+    modified: z.number().optional(),
+    movedTo: z.string().optional(),
+    /** `agent` when the session's running turn edits it, `other` when no turn runs; neither when a turn runs but names it in no edit, as a command of the agent's may change it. */
+    by: z.enum(['agent', 'other']).optional(),
+});
+/** A file or folder moved, renamed or copied, by its paths in the session's folder; a copy from outside it, by its whole path. */
+export const Moved = z.object({ from: z.string(), to: z.string() });
+/** What went to the Trash: its path in the session's folder, and its whole path in the Trash, by which it is put back. */
+export const Trashed = z.object({ path: z.string(), trash: z.string() });
+/** What a call did, so a client can undo it; `replaced`, what was in the way and went to the Trash for it. */
+export const FilesMoved = z.object({ moved: z.array(Moved), replaced: z.array(Trashed) });
+export const FilesCopied = z.object({ copied: z.array(Moved), replaced: z.array(Trashed) });
+export const FileCreated = z.object({ path: z.string(), replaced: z.array(Trashed) });
+export const FilesRestored = z.object({ restored: z.array(z.string()), replaced: z.array(Trashed) });
+//# sourceMappingURL=types.js.map

package/dist/files/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/files/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gEAAgE;AAChE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACrC,iDAAiD;IACjD,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,gEAAgE;IAChE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,sFAAsF;IACtF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,8CAA8C;IAC9C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAIH,4FAA4F;AAC5F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,sBAAsB;IACtB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACtB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;CAC/D,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;AAIzF,uDAAuD;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAI/F,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAI9F;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,gLAAgL;IAChL,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAIH,kIAAkI;AAClI,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAIpE,0HAA0H;AAC1H,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAIzE,8GAA8G;AAC9G,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAI1F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAI5F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAItF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC"}

package/dist/files/watch.d.ts

@@ -0,0 +1,26 @@
+import type { FileChanged, Moved } from './types.js';
+/**
+ * The files one client has open, watched on disk: each folder holding one is watched, as many editors write a file by
+ * putting a new one in its place, which a watch on the file itself would lose.
+ */
+export declare class FileWatcher {
+    private readonly changed;
+    private readonly wanted;
+    private readonly folders;
+    private files;
+    private readonly settling;
+    constructor(changed: (change: FileChanged) => void);
+    /**
+     * Files and folders of `folder` moved or renamed through the API, by their paths there: each open file in them is told
+     * of with its path now, and watched there from then on.
+     */
+    static moved(folder: string, moves: Moved[]): void;
+    /** The files of the session's folder it now has open, by their paths there; the ones before are let go. */
+    set(session: string, folder: string, paths: string[]): void;
+    close(): void;
+    private follow;
+    private rebuild;
+    private touched;
+    private tell;
+}
+//# sourceMappingURL=watch.d.ts.map

package/dist/files/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/files/watch.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAQrD;;;GAGG;AACH,qBAAa,WAAW;IAMV,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0D;IACjF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,KAAK,CAA0D;IACvE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoD;IAE7E,YAA6B,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,EAElE;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAE1C;IAED,2GAA2G;IAC3G,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAGnD;IAED,KAAK,SAOJ;IAED,OAAO,CAAC,MAAM;IAwBd,OAAO,CAAC,OAAO;IAoCf,OAAO,CAAC,OAAO;IAkBf,OAAO,CAAC,IAAI;CAGb"}