@kruntime/komputer 0.1.0

package/dist/vfs.js

@@ -0,0 +1,248 @@
+import { KState, normalizeKPath } from "./kstate.js";
+import { dirnamePath, joinPath } from "./path.js";
+import { basenameOf } from "./drive.js";
+export class KFileSystem {
+    kstate;
+    mounts;
+    home;
+    sessionId;
+    trace;
+    by;
+    authorize;
+    constructor(kstate, { home = '/home/agent', sessionId, trace, by, authorize, mounts }) {
+        this.kstate = kstate;
+        this.mounts = mounts;
+        this.home = home;
+        this.sessionId = sessionId;
+        this.trace = trace;
+        this.by = by;
+        this.authorize = authorize;
+    }
+    path(path) {
+        return normalizeKPath(path, this.home);
+    }
+    async readText(path, opts = {}) {
+        const kPath = this.path(path);
+        const target = this.mounts.resolve(kPath);
+        const text = await target.drive.readText(target.drivePath);
+        await this.trace?.('fs.read', { path: kPath, by: this.by?.() });
+        if (opts.maxTokens)
+            return text.slice(0, opts.maxTokens * 4);
+        return text;
+    }
+    async readFile(path, options = 'utf8') {
+        const text = await this.readText(path);
+        const encoding = typeof options === 'string' ? options : options.encoding;
+        if (encoding === 'utf8' || encoding === undefined)
+            return text;
+        return new TextEncoder().encode(text);
+    }
+    async writeText(path, text) {
+        let kPath = this.path(path);
+        const authorized = await this.authorize?.({ op: 'write', path: kPath, text });
+        kPath = authorized?.path || kPath;
+        const target = this.mounts.resolve(kPath);
+        this.assertWritable(target, 'write');
+        if (!target.drive.writeText)
+            throw new Error(`drive mounted at ${target.mountPath} is readonly`);
+        await target.drive.writeText(target.drivePath, text);
+        await this.trace?.('fs.write', { path: kPath, bytes: new TextEncoder().encode(text).byteLength, by: this.by?.() });
+    }
+    async writeFile(path, data) {
+        await this.writeText(path, typeof data === 'string' ? data : new TextDecoder().decode(data));
+    }
+    async appendText(path, text) {
+        let kPath = this.path(path);
+        const authorized = await this.authorize?.({ op: 'append', path: kPath, text });
+        kPath = authorized?.path || kPath;
+        const target = this.mounts.resolve(kPath);
+        this.assertWritable(target, 'append');
+        if (!target.drive.writeText)
+            throw new Error(`drive mounted at ${target.mountPath} is readonly`);
+        const current = await target.drive.exists(target.drivePath) ? await target.drive.readText(target.drivePath) : '';
+        await target.drive.writeText(target.drivePath, `${current}${text}`);
+        await this.trace?.('fs.append', { path: kPath, bytes: new TextEncoder().encode(text).byteLength, by: this.by?.() });
+    }
+    async appendFile(path, data) {
+        await this.appendText(path, typeof data === 'string' ? data : new TextDecoder().decode(data));
+    }
+    async mkdir(path) {
+        let kPath = this.path(path);
+        const authorized = await this.authorize?.({ op: 'mkdir', path: kPath });
+        kPath = authorized?.path || kPath;
+        const target = this.mounts.resolve(kPath);
+        this.assertWritable(target, 'mkdir');
+        if (!target.drive.mkdir)
+            throw new Error(`drive mounted at ${target.mountPath} does not support mkdir`);
+        await target.drive.mkdir(target.drivePath);
+        await this.trace?.('fs.mkdir', { path: kPath, by: this.by?.() });
+    }
+    async rm(path, options = {}) {
+        let kPath = this.path(path);
+        const authorized = await this.authorize?.({ op: 'rm', path: kPath, options });
+        kPath = authorized?.path || kPath;
+        const target = this.mounts.resolve(kPath);
+        this.assertWritable(target, 'rm');
+        if (!target.drive.rm)
+            throw new Error(`drive mounted at ${target.mountPath} does not support rm`);
+        await target.drive.rm(target.drivePath, options);
+        await this.trace?.('fs.rm', { path: kPath, recursive: Boolean(options.recursive), force: Boolean(options.force), by: this.by?.() });
+    }
+    async rename(from, to) {
+        const fromPath = this.path(from);
+        const toPath = this.path(to);
+        await this.authorize?.({ op: 'rename', path: fromPath, to: toPath });
+        const source = this.mounts.resolve(fromPath);
+        const target = this.mounts.resolve(toPath);
+        this.assertWritable(source, 'rename');
+        this.assertWritable(target, 'rename');
+        if (source.drive !== target.drive)
+            throw new Error('cross-drive rename is not supported; copy then rm explicitly');
+        if (!source.drive.rename)
+            throw new Error(`drive mounted at ${source.mountPath} does not support rename`);
+        await source.drive.rename(source.drivePath, target.drivePath);
+        await this.trace?.('fs.rename', { from: fromPath, to: toPath, by: this.by?.() });
+    }
+    async symlink(target, path) {
+        let kPath = this.path(path);
+        const authorized = await this.authorize?.({ op: 'symlink', path: kPath, target });
+        kPath = authorized?.path || kPath;
+        const resolved = this.mounts.resolve(kPath);
+        this.assertWritable(resolved, 'symlink');
+        if (!resolved.drive.symlink)
+            throw new Error(`drive mounted at ${resolved.mountPath} does not support symlink`);
+        await resolved.drive.symlink(target, resolved.drivePath);
+        await this.trace?.('fs.symlink', { path: kPath, target, by: this.by?.() });
+    }
+    async chmod(path, mode) {
+        let kPath = this.path(path);
+        const authorized = await this.authorize?.({ op: 'chmod', path: kPath, mode });
+        kPath = authorized?.path || kPath;
+        const target = this.mounts.resolve(kPath);
+        this.assertWritable(target, 'chmod');
+        if (!target.drive.chmod)
+            throw new Error(`drive mounted at ${target.mountPath} does not support chmod`);
+        await target.drive.chmod(target.drivePath, mode);
+        await this.trace?.('fs.chmod', { path: kPath, mode, by: this.by?.() });
+    }
+    async utime(path, mtime) {
+        let kPath = this.path(path);
+        const value = typeof mtime === 'string' ? new Date(mtime) : mtime;
+        if (!Number.isFinite(value.getTime()))
+            throw new Error(`invalid mtime: ${String(mtime)}`);
+        const iso = value.toISOString();
+        const authorized = await this.authorize?.({ op: 'utime', path: kPath, mtime: iso });
+        kPath = authorized?.path || kPath;
+        const target = this.mounts.resolve(kPath);
+        this.assertWritable(target, 'utime');
+        if (!target.drive.utime)
+            throw new Error(`drive mounted at ${target.mountPath} does not support utime`);
+        await target.drive.utime(target.drivePath, iso);
+        await this.trace?.('fs.utime', { path: kPath, mtime: iso, by: this.by?.() });
+    }
+    async readLink(path) {
+        const kPath = await this.realpath(path, { followFinal: false, allowMissing: false });
+        const target = this.mounts.resolve(kPath);
+        return target.drive.readLink?.(target.drivePath);
+    }
+    async realpath(path, options = {}) {
+        let currentPath = this.path(path);
+        const followFinal = options.followFinal ?? true;
+        for (let depth = 0; depth < 40; depth += 1) {
+            const parts = currentPath.split('/').filter(Boolean);
+            if (!parts.length)
+                return '/';
+            let current = '/';
+            let changed = false;
+            for (let index = 0; index < parts.length; index += 1) {
+                current = joinPath(current, parts[index]);
+                const isFinal = index === parts.length - 1;
+                if (isFinal && !followFinal)
+                    break;
+                const resolved = this.mounts.resolve(current);
+                const link = await resolved.drive.readLink?.(resolved.drivePath);
+                if (link === undefined)
+                    continue;
+                const base = link.startsWith('/') ? link : joinPath(dirnamePath(current), link);
+                const rest = parts.slice(index + 1).join('/');
+                currentPath = this.path(rest ? joinPath(base, rest) : base);
+                changed = true;
+                break;
+            }
+            if (!changed) {
+                if (!options.allowMissing && !await this.exists(currentPath))
+                    throw new Error(`realpath: ${path}: not found`);
+                return currentPath;
+            }
+        }
+        throw new Error(`too many symbolic link levels: ${path}`);
+    }
+    async exists(path) {
+        const kPath = this.path(path);
+        const target = this.mounts.resolve(kPath);
+        return await target.drive.exists(target.drivePath) || this.mounts.hasDescendant(kPath);
+    }
+    async readdir(path) {
+        const kPath = this.path(path);
+        const target = this.mounts.resolve(kPath);
+        const childMounts = this.mounts.childMounts(kPath);
+        let entries = [];
+        try {
+            entries = await target.drive.readdir(target.drivePath);
+        }
+        catch (error) {
+            if (!childMounts.length)
+                throw error;
+        }
+        return this.mergeMountedChildren(entries, childMounts);
+    }
+    async stat(path) {
+        const kPath = this.path(path);
+        const target = this.mounts.resolve(kPath);
+        if (!target.drive.stat)
+            throw new Error(`drive mounted at ${target.mountPath} does not support stat`);
+        try {
+            return await target.drive.stat(target.drivePath);
+        }
+        catch (error) {
+            if (this.mounts.hasDescendant(kPath))
+                return { type: 'dir' };
+            throw error;
+        }
+    }
+    async walk(path = '.', options = {}) {
+        const root = this.path(path);
+        const maxDepth = options.maxDepth ?? Number.POSITIVE_INFINITY;
+        const output = [];
+        await this.walkInto(root, 0, maxDepth, output);
+        return output;
+    }
+    async walkInto(path, depth, maxDepth, output) {
+        if (depth > maxDepth)
+            return;
+        const entries = await this.readdir(path);
+        for (const entry of entries) {
+            const childPath = joinPath(path, entry.name);
+            output.push({ ...entry, path: childPath });
+            if (entry.type === 'dir' && depth < maxDepth) {
+                await this.walkInto(childPath, depth + 1, maxDepth, output);
+            }
+        }
+    }
+    assertWritable(target, op) {
+        if (target.mode === 'ro')
+            throw new Error(`drive mounted at ${target.mountPath} is ro; cannot ${op}`);
+    }
+    async mergeMountedChildren(entries, childMounts) {
+        if (!childMounts.length)
+            return entries;
+        const byName = new Map(entries.map((entry) => [entry.name, entry]));
+        for (const mount of childMounts) {
+            const name = basenameOf(mount.path);
+            const stat = await mount.drive.stat?.('/');
+            byName.set(name, { name, type: stat?.type ?? 'dir' });
+        }
+        return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
+    }
+}
+//# sourceMappingURL=vfs.js.map

package/dist/vfs.js.map

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

package/dist/vprocess.d.ts

@@ -0,0 +1,139 @@
+import type { EventLog } from './events.js';
+import type { KState } from './kstate.js';
+import type { Remote, ShellExecutionLimits, ShellSandboxAttestation, ShellSandboxRequest } from './remote.js';
+import type { EventEnvelope, RuntimeEvent } from './types.js';
+export interface VProcessRecord {
+    vpid: string;
+    jobId: string;
+    pgrp: string;
+    kind: 'remote' | 'k';
+    status: 'running' | 'exited' | 'failed' | 'uncertain';
+    foreground: boolean;
+    cwd?: string;
+    argv: string[];
+    remote?: {
+        name: string;
+        ref: {
+            pid?: number;
+        };
+        fencingToken: string;
+    };
+    sandbox?: {
+        request?: ShellSandboxRequest;
+        attestation?: ShellSandboxAttestation;
+    };
+    startedAt: string;
+    endedAt?: string;
+    exitCode?: number | null;
+    signal?: string | null;
+    error?: string;
+    restartPolicy: 'never';
+    reconcile?: {
+        needed: true;
+    };
+    receiptId?: string;
+    recovered?: boolean;
+}
+export interface VJobRecord {
+    jobId: string;
+    pgrp: string;
+    command: string;
+    processIds: string[];
+    foreground: boolean;
+    status: 'running' | 'exited' | 'failed' | 'uncertain';
+    startedAt: string;
+    endedAt?: string;
+}
+export interface SpawnShellOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    stdin?: string;
+    foreground?: boolean;
+    remote?: Remote;
+    limits?: ShellExecutionLimits;
+    sandbox?: ShellSandboxRequest;
+}
+export interface SpawnShellResult {
+    vpid: string;
+    jobId: string;
+    background: boolean;
+    code?: number;
+    signal?: string | null;
+    stdout?: string;
+    stderr?: string;
+    timedOut?: boolean;
+    sandbox?: ShellSandboxAttestation;
+    done?: Promise<ShellDoneResult>;
+}
+interface ShellDoneResult {
+    code: number;
+    signal?: string | null;
+    stdout: string;
+    stderr: string;
+    timedOut?: boolean;
+    sandbox?: ShellSandboxAttestation;
+}
+interface ActiveProcess {
+    done: Promise<ShellDoneResult>;
+    abort?: (signal: string) => void;
+    detach?: () => void;
+    recovered?: boolean;
+}
+export declare class VProcessTable {
+    kstate: KState;
+    sessionId: string;
+    eventLog: EventLog;
+    emitEvent: (event: RuntimeEvent) => Promise<EventEnvelope>;
+    defaultRemote: Remote;
+    remoteByName: (name: string) => Remote | undefined;
+    active: Map<string, ActiveProcess>;
+    constructor(kstate: KState, sessionId: string, eventLog: EventLog, defaultRemote: Remote, remoteByName?: (name: string) => Remote | undefined, emitEvent?: (event: RuntimeEvent) => Promise<EventEnvelope>);
+    processesName(): string;
+    jobsName(): string;
+    stdoutName(vpid: string): string;
+    stderrName(vpid: string): string;
+    spawnShell(script: string, { cwd, env, stdin, foreground, remote, limits, sandbox }?: SpawnShellOptions): Promise<SpawnShellResult>;
+    spawnVirtual(script: string, run: (signal: AbortSignal) => Promise<{
+        stdout: string;
+        stderr: string;
+        code?: number;
+        signal?: string | null;
+    }>, { cwd, foreground }?: {
+        cwd?: string;
+        foreground?: boolean;
+    }): Promise<SpawnShellResult>;
+    private execShellWithoutProcess;
+    private consumeProcessStream;
+    private recordOutput;
+    private stopUntrustedProcess;
+    recover(): Promise<VProcessRecord[]>;
+    private recoverDeterministicVirtualProcess;
+    processes(): Promise<VProcessRecord[]>;
+    localActiveProcessCount(): number;
+    detachActive(): void;
+    jobs(): Promise<VJobRecord[]>;
+    kill(idOrJob: string, signal?: string): Promise<VProcessRecord[]>;
+    wait(idOrJob: string): Promise<ShellDoneResult & {
+        status: string;
+        vpid?: string;
+        jobId?: string;
+        receiptId?: string;
+        recovered?: boolean;
+    }>;
+    foreground(idOrJob: string): Promise<ShellDoneResult & {
+        status: string;
+        vpid?: string;
+        jobId?: string;
+        receiptId?: string;
+        recovered?: boolean;
+    }>;
+    background(idOrJob: string): Promise<VProcessRecord>;
+    attachReceipt(vpid: string, receiptId: string): Promise<void>;
+    private trackActive;
+    private findProcess;
+    private processOutput;
+    private readOutputLog;
+    private markForeground;
+    private appendJobForProcess;
+}
+export {};