koneck 2.26.0 → 2.28.0

package/dist/web/changes.js

@@ -0,0 +1,215 @@
+/**
+ * What a session changed on disk, and what the change was.
+ *
+ * KONECK has a git-based checkpoint already, and it is the right thing when there is a repository:
+ * `git write-tree` is cheap and exact. But it needs one, and the workspace this was asked for has
+ * no repository of its own — the enclosing directory has one, which is a tree full of other
+ * projects and precisely what the git tools are now withheld from touching. A diff view that only
+ * works in a git repo is a diff view that does not work.
+ *
+ * So the workspace is read directly: a snapshot of the text files before a turn, another after, and
+ * the difference between them. Bounded in every direction, because a workspace can contain a
+ * node_modules and a build output and a database.
+ */
+import { readdir, readFile, stat } from 'fs/promises';
+import path from 'path';
+/** Directories never worth reading: generated, enormous, or not the user's work. */
+const SKIP_DIRS = new Set([
+    'node_modules', '.git', '.svn', '.hg', 'dist', 'build', 'out', 'target',
+    '.next', '.nuxt', '.venv', 'venv', '__pycache__', '.cache', '.turbo',
+    'coverage', '.pytest_cache', '.mypy_cache', '.gradle', 'vendor', '.koneck',
+]);
+/** A file larger than this is recorded by size alone: no diff is readable at that length. */
+export const MAX_DIFF_BYTES = 512 * 1024;
+/** A cap on how many files are held, so a snapshot cannot become the memory problem. */
+export const MAX_FILES = 4_000;
+/** Anything that is plainly not text does not get diffed. */
+const BINARY_EXT = new Set([
+    '.png', '.jpg', '.jpeg', '.gif', '.webp', '.avif', '.ico', '.bmp', '.svgz',
+    '.pdf', '.zip', '.gz', '.tgz', '.bz2', '.xz', '.7z', '.rar', '.jar',
+    '.mp3', '.mp4', '.mov', '.avi', '.mkv', '.wav', '.flac', '.ogg',
+    '.woff', '.woff2', '.ttf', '.otf', '.eot',
+    '.so', '.dylib', '.dll', '.exe', '.bin', '.wasm', '.db', '.sqlite', '.sqlite3',
+    '.pyc', '.class', '.o', '.a', '.node',
+]);
+const looksBinary = (name) => BINARY_EXT.has(path.extname(name).toLowerCase());
+/** Written as a code point so no source file needs to contain the byte itself. */
+const NUL = String.fromCharCode(0);
+/**
+ * Every text file under a workspace, with its contents.
+ *
+ * Content is read rather than hashed because the diff needs it anyway, and a workspace that fits
+ * in the caps above is small enough that reading it is faster than deciding not to.
+ */
+export async function snapshot(cwd) {
+    const out = new Map();
+    async function walk(dir, depth) {
+        if (out.size >= MAX_FILES || depth > 12)
+            return;
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (out.size >= MAX_FILES)
+                return;
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (SKIP_DIRS.has(entry.name) || entry.name.startsWith('.'))
+                    continue;
+                await walk(full, depth + 1);
+                continue;
+            }
+            if (!entry.isFile())
+                continue; // a socket or a symlink loop
+            const rel = path.relative(cwd, full);
+            try {
+                const info = await stat(full);
+                const state = { size: info.size, mtimeMs: info.mtimeMs };
+                if (!looksBinary(entry.name) && info.size <= MAX_DIFF_BYTES) {
+                    const text = await readFile(full, 'utf8');
+                    // A NUL byte in the first stretch means it is binary whatever the extension says.
+                    if (!text.slice(0, 4_000).includes(NUL))
+                        state.text = text;
+                }
+                out.set(rel, state);
+            }
+            catch { /* vanished between readdir and stat, or unreadable */ }
+        }
+    }
+    await walk(cwd, 0);
+    return out;
+}
+/**
+ * The longest common subsequence of two line arrays, as an edit script.
+ *
+ * Written out rather than pulled in: a diff is forty lines of Myers and the dependency would be
+ * another thing to keep current. Bounded by area, and above the bound it reports a whole-file
+ * replacement rather than spending a second on a file nobody will read the diff of.
+ */
+function diffLines(before, after) {
+    const n = before.length, m = after.length;
+    if (n * m > 4_000_000) {
+        return [...before.map(l => ['-', l]),
+            ...after.map(l => ['+', l])];
+    }
+    // Classic LCS table. Memory is the reason for the area bound above.
+    const lcs = Array.from({ length: n + 1 }, () => new Array(m + 1).fill(0));
+    for (let i = n - 1; i >= 0; i--) {
+        for (let j = m - 1; j >= 0; j--) {
+            lcs[i][j] = before[i] === after[j]
+                ? lcs[i + 1][j + 1] + 1
+                : Math.max(lcs[i + 1][j], lcs[i][j + 1]);
+        }
+    }
+    const script = [];
+    let i = 0, j = 0;
+    while (i < n && j < m) {
+        if (before[i] === after[j]) {
+            script.push([' ', before[i]]);
+            i++;
+            j++;
+        }
+        else if (lcs[i + 1][j] >= lcs[i][j + 1]) {
+            script.push(['-', before[i]]);
+            i++;
+        }
+        else {
+            script.push(['+', after[j]]);
+            j++;
+        }
+    }
+    while (i < n)
+        script.push(['-', before[i++]]);
+    while (j < m)
+        script.push(['+', after[j++]]);
+    return script;
+}
+/** Context lines either side of a change. Three is what everybody's diff shows. */
+const CONTEXT = 3;
+/** The edit script as a unified diff, with untouched stretches collapsed. */
+export function unified(before, after) {
+    const script = diffLines(before.split('\n'), after.split('\n'));
+    let added = 0, removed = 0;
+    for (const [kind] of script) {
+        if (kind === '+')
+            added++;
+        else if (kind === '-')
+            removed++;
+    }
+    // Which lines to keep: any change, plus context around it.
+    const keep = new Array(script.length).fill(false);
+    for (let k = 0; k < script.length; k++) {
+        if (script[k][0] === ' ')
+            continue;
+        for (let c = Math.max(0, k - CONTEXT); c <= Math.min(script.length - 1, k + CONTEXT); c++) {
+            keep[c] = true;
+        }
+    }
+    const lines = [];
+    let gap = false;
+    for (let k = 0; k < script.length; k++) {
+        if (!keep[k]) {
+            gap = true;
+            continue;
+        }
+        if (gap) {
+            lines.push('@@');
+            gap = false;
+        }
+        lines.push(script[k][0] + script[k][1]);
+    }
+    return { diff: lines.join('\n'), added, removed };
+}
+/** What changed between two snapshots, newest interesting first. */
+export function compare(before, after) {
+    const changes = [];
+    for (const [file, now] of after) {
+        const was = before.get(file);
+        if (!was) {
+            const lines = now.text ? now.text.split('\n').length : 0;
+            changes.push({
+                path: file, kind: 'added', added: lines, removed: 0, size: now.size,
+                diff: now.text === undefined ? null
+                    : now.text.split('\n').map(l => '+' + l).join('\n'),
+            });
+            continue;
+        }
+        // mtime alone is not evidence: a tool can rewrite a file with identical contents.
+        if (was.size === now.size && was.text !== undefined && was.text === now.text)
+            continue;
+        if (was.text === undefined || now.text === undefined) {
+            if (was.size === now.size && was.mtimeMs === now.mtimeMs)
+                continue;
+            changes.push({ path: file, kind: 'modified', added: 0, removed: 0, diff: null, size: now.size });
+            continue;
+        }
+        if (was.text === now.text)
+            continue;
+        const { diff, added, removed } = unified(was.text, now.text);
+        changes.push({ path: file, kind: 'modified', added, removed, diff, size: now.size });
+    }
+    for (const [file, was] of before) {
+        if (after.has(file))
+            continue;
+        changes.push({
+            path: file, kind: 'deleted', added: 0,
+            removed: was.text ? was.text.split('\n').length : 0, size: 0,
+            diff: was.text === undefined ? null : was.text.split('\n').map(l => '-' + l).join('\n'),
+        });
+    }
+    // Most changed first, since that is what anybody looks at.
+    return changes.sort((a, b) => (b.added + b.removed) - (a.added + a.removed));
+}
+/** Totals for a header line. */
+export function summarise(changes) {
+    return {
+        files: changes.length,
+        added: changes.reduce((n, c) => n + c.added, 0),
+        removed: changes.reduce((n, c) => n + c.removed, 0),
+    };
+}
+//# sourceMappingURL=changes.js.map

package/dist/web/changes.js.map

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

package/dist/web/files.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Reading the workspace: a tree to browse, and a file to look at.
+ *
+ * Every path arrives from a URL, so every path is resolved and checked against the workspace root
+ * before anything is opened. That check is the whole of this module's security, and it is done once
+ * in one function rather than at each call site — `..` is the obvious attack and a symlink pointing
+ * out of the tree is the one that gets forgotten, so the resolved real path is what gets compared.
+ *
+ * Read-only. Editing from the browser is a different feature with a different risk, and mixing the
+ * two would mean a traversal bug wrote instead of leaked.
+ */
+/** A file this size is shown by its head, because nothing reads a megabyte in a browser panel. */
+export declare const MAX_VIEW_BYTES: number;
+/** Entries per directory. A folder with ten thousand files is not a tree to browse. */
+export declare const MAX_ENTRIES = 500;
+export interface TreeEntry {
+    name: string;
+    /** Relative to the workspace root, always with forward slashes. */
+    path: string;
+    dir: boolean;
+    size: number;
+    mtimeMs: number;
+}
+/**
+ * The resolved absolute path, or null when it would leave the workspace.
+ *
+ * Symlinks are resolved first, so a link inside the workspace pointing at /etc is caught. A path
+ * that does not exist yet cannot be realpath'd, so the parent is resolved instead and the last
+ * segment appended — which is what a browser asking for a file it saw a moment ago needs.
+ */
+export declare function resolveInside(root: string, rel: string): Promise<string | null>;
+/** One directory, folders first then files, both alphabetical. */
+export declare function listDir(root: string, rel?: string): Promise<TreeEntry[] | null>;
+export interface FileView {
+    path: string;
+    size: number;
+    text: string | null;
+    truncated: boolean;
+    binary: boolean;
+}
+/** One file, as text where that means anything. */
+export declare function viewFile(root: string, rel: string): Promise<FileView | null>;
+//# sourceMappingURL=files.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/web/files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,kGAAkG;AAClG,eAAO,MAAM,cAAc,QAAa,CAAC;AACzC,uFAAuF;AACvF,eAAO,MAAM,WAAW,MAAM,CAAC;AAE/B,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmBrF;AAED,kEAAkE;AAClE,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAyBjF;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAWD,mDAAmD;AACnD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAuBlF"}

package/dist/web/files.js

@@ -0,0 +1,131 @@
+/**
+ * Reading the workspace: a tree to browse, and a file to look at.
+ *
+ * Every path arrives from a URL, so every path is resolved and checked against the workspace root
+ * before anything is opened. That check is the whole of this module's security, and it is done once
+ * in one function rather than at each call site — `..` is the obvious attack and a symlink pointing
+ * out of the tree is the one that gets forgotten, so the resolved real path is what gets compared.
+ *
+ * Read-only. Editing from the browser is a different feature with a different risk, and mixing the
+ * two would mean a traversal bug wrote instead of leaked.
+ */
+import { readdir, readFile, stat, realpath } from 'fs/promises';
+import path from 'path';
+/** Never listed: generated, enormous, or not the user's work. */
+const HIDE = new Set([
+    'node_modules', '.git', '.svn', '.hg', 'dist', 'build', 'out', 'target',
+    '.next', '.nuxt', '.venv', 'venv', '__pycache__', '.cache', '.turbo',
+    'coverage', '.pytest_cache', '.mypy_cache', '.gradle', '.idea', '.DS_Store',
+]);
+/** A file this size is shown by its head, because nothing reads a megabyte in a browser panel. */
+export const MAX_VIEW_BYTES = 400 * 1024;
+/** Entries per directory. A folder with ten thousand files is not a tree to browse. */
+export const MAX_ENTRIES = 500;
+/**
+ * The resolved absolute path, or null when it would leave the workspace.
+ *
+ * Symlinks are resolved first, so a link inside the workspace pointing at /etc is caught. A path
+ * that does not exist yet cannot be realpath'd, so the parent is resolved instead and the last
+ * segment appended — which is what a browser asking for a file it saw a moment ago needs.
+ */
+export async function resolveInside(root, rel) {
+    // A NUL in a path is a way to truncate it inside a syscall, so it never gets that far.
+    if (rel.includes(String.fromCharCode(0)))
+        return null;
+    const rootReal = await realpath(root).catch(() => path.resolve(root));
+    const wanted = path.resolve(rootReal, rel);
+    const check = (candidate) => {
+        const relative = path.relative(rootReal, candidate);
+        // Empty means the root itself, which is allowed. Anything starting with `..`, or absolute,
+        // is outside.
+        if (relative !== '' && (relative.startsWith('..') || path.isAbsolute(relative)))
+            return null;
+        return candidate;
+    };
+    const real = await realpath(wanted).catch(() => null);
+    if (real)
+        return check(real);
+    const parentReal = await realpath(path.dirname(wanted)).catch(() => null);
+    if (!parentReal)
+        return null;
+    return check(path.join(parentReal, path.basename(wanted)));
+}
+/** One directory, folders first then files, both alphabetical. */
+export async function listDir(root, rel = '') {
+    const dir = await resolveInside(root, rel);
+    if (!dir)
+        return null;
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return null;
+    }
+    const out = [];
+    for (const entry of entries) {
+        if (out.length >= MAX_ENTRIES)
+            break;
+        if (HIDE.has(entry.name))
+            continue;
+        const full = path.join(dir, entry.name);
+        const childRel = path.posix.join(rel.split(path.sep).join('/'), entry.name);
+        try {
+            const info = await stat(full);
+            out.push({
+                name: entry.name,
+                path: childRel,
+                dir: info.isDirectory(),
+                size: info.isDirectory() ? 0 : info.size,
+                mtimeMs: info.mtimeMs,
+            });
+        }
+        catch { /* vanished, or a broken symlink */ }
+    }
+    return out.sort((a, b) => a.dir === b.dir ? a.name.localeCompare(b.name) : (a.dir ? -1 : 1));
+}
+const BINARY_EXT = new Set([
+    '.png', '.jpg', '.jpeg', '.gif', '.webp', '.avif', '.ico', '.bmp', '.pdf',
+    '.zip', '.gz', '.tgz', '.bz2', '.xz', '.7z', '.rar', '.jar', '.wasm',
+    '.mp3', '.mp4', '.mov', '.avi', '.mkv', '.wav', '.flac', '.ogg',
+    '.woff', '.woff2', '.ttf', '.otf', '.so', '.dylib', '.dll', '.exe', '.bin',
+    '.db', '.sqlite', '.sqlite3', '.pyc', '.class', '.node',
+]);
+const NUL = String.fromCharCode(0);
+/** One file, as text where that means anything. */
+export async function viewFile(root, rel) {
+    const full = await resolveInside(root, rel);
+    if (!full)
+        return null;
+    let info;
+    try {
+        info = await stat(full);
+    }
+    catch {
+        return null;
+    }
+    if (!info.isFile())
+        return null;
+    if (BINARY_EXT.has(path.extname(full).toLowerCase())) {
+        return { path: rel, size: info.size, text: null, truncated: false, binary: true };
+    }
+    let text;
+    try {
+        text = await readFile(full, 'utf8');
+    }
+    catch {
+        return null;
+    }
+    if (text.slice(0, 4_000).includes(NUL)) {
+        return { path: rel, size: info.size, text: null, truncated: false, binary: true };
+    }
+    const truncated = text.length > MAX_VIEW_BYTES;
+    return {
+        path: rel,
+        size: info.size,
+        text: truncated ? text.slice(0, MAX_VIEW_BYTES) : text,
+        truncated,
+        binary: false,
+    };
+}
+//# sourceMappingURL=files.js.map

package/dist/web/files.js.map

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

package/dist/web/history.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Sessions already on disk, read back as something a browser can show.
+ *
+ * Every CLI run writes a JSONL transcript into `.koneck/sessions`, and until now the web side
+ * listed their titles and could do nothing with them. That is the larger half of what a harness is
+ * for: most of the value is in looking at a run that has already happened — what it did, in what
+ * order, and where the time went — and none of that needs an agent to be running.
+ *
+ * The file is the record, so this only reads. A past session cannot be resumed from the browser
+ * because resuming is what the CLI does, and pretending otherwise would produce a second live
+ * session pointed at the same transcript.
+ */
+import { type TrajectoryEvent, type TrajectorySummary } from '../trajectory.js';
+export interface PastSessionMeta {
+    file: string;
+    id: string;
+    task: string;
+    model: string;
+    provider: string;
+    turns: number;
+    totalTokens: number;
+    at: number;
+    bytes: number;
+}
+/** One entry in a rendered transcript. */
+export type PastEntry = {
+    kind: 'user';
+    text: string;
+} | {
+    kind: 'assistant';
+    text: string;
+} | {
+    kind: 'tool';
+    name: string;
+    args: string;
+    result: string;
+    ok: boolean;
+} | {
+    kind: 'system';
+    text: string;
+};
+export interface PastSession {
+    meta: PastSessionMeta;
+    entries: PastEntry[];
+    trajectory: TrajectoryEvent[];
+    summary: TrajectorySummary | null;
+    /** True when the file held more than was read, so the view can say so. */
+    truncated: boolean;
+}
+/** A transcript longer than this is read to here and the rest reported as omitted. */
+export declare const MAX_ENTRIES = 600;
+/** Only the first line of each file is read: it holds the metadata. */
+export declare function listPast(cwd: string, limit?: number): Promise<PastSessionMeta[]>;
+/**
+ * One session, read into entries.
+ *
+ * The file is a sequence of records; older KONECK versions wrote slightly different shapes, so this
+ * accepts what it recognises and ignores the rest rather than refusing to open an old transcript.
+ */
+export declare function readPast(cwd: string, file: string): Promise<PastSession | null>;
+//# sourceMappingURL=history.d.ts.map

package/dist/web/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/web/history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAAa,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE3F,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0CAA0C;AAC1C,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAClC,0EAA0E;IAC1E,SAAS,EAAE,OAAO,CAAC;CACpB;AAID,sFAAsF;AACtF,eAAO,MAAM,WAAW,MAAM,CAAC;AAE/B,uEAAuE;AACvE,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAkClF;AAmBD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAgGrF"}