@elizaos/agent 2.0.0-beta.2 → 2.0.11-beta.5

package/services/vfs-git.js

@@ -0,0 +1,315 @@
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import path from "node:path";
+import git from "isomorphic-git";
+import http from "isomorphic-git/http/node";
+export class VfsGitError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "VfsGitError";
+    }
+}
+export function createVfsGitService(vfs) {
+    return new IsomorphicVfsGitService(vfs);
+}
+class IsomorphicVfsGitService {
+    vfs;
+    constructor(vfs) {
+        this.vfs = vfs;
+    }
+    async run(request) {
+        await this.vfs.initialize();
+        switch (request.action) {
+            case "init":
+                return this.init(request);
+            case "clone":
+                return this.clone(request);
+            case "status":
+                return this.status();
+            case "add":
+                return this.add(request);
+            case "remove":
+                return this.remove(request);
+            case "commit":
+                return this.commit(request);
+            case "log":
+                return this.log(request);
+            case "branch":
+                return this.branch(request);
+            case "checkout":
+                return this.checkout(request);
+            case "fetch":
+                return this.fetch(request);
+            case "pull":
+                return this.pull(request);
+            case "push":
+                return this.push(request);
+        }
+    }
+    async init(request) {
+        await git.init({
+            fs,
+            dir: this.vfs.filesRoot,
+            defaultBranch: request.defaultBranch ?? request.branch ?? "main",
+        });
+        return {
+            action: "init",
+            branch: await currentBranch(this.vfs.filesRoot),
+        };
+    }
+    async clone(request) {
+        const url = requireUrl(request.url);
+        await git.clone({
+            fs,
+            http,
+            dir: this.vfs.filesRoot,
+            url,
+            singleBranch: request.singleBranch ?? true,
+            depth: request.depth ?? 1,
+            ref: request.ref ?? request.branch,
+            onAuth: authCallback(request),
+        });
+        await rejectAndRemoveSymlinks(this.vfs.filesRoot);
+        return {
+            action: "clone",
+            url: redactGitUrl(url),
+            branch: await currentBranch(this.vfs.filesRoot),
+        };
+    }
+    async status() {
+        const matrix = await git.statusMatrix({
+            fs,
+            dir: this.vfs.filesRoot,
+        });
+        return {
+            action: "status",
+            branch: await currentBranch(this.vfs.filesRoot),
+            clean: matrix.every((row) => isCleanStatus(row)),
+            files: matrix.map(statusRowView),
+        };
+    }
+    async add(request) {
+        const paths = requestPaths(request);
+        for (const filepath of paths) {
+            await git.add({ fs, dir: this.vfs.filesRoot, filepath });
+        }
+        return { action: "add", paths };
+    }
+    async remove(request) {
+        const paths = requestPaths(request);
+        for (const filepath of paths) {
+            await git.remove({ fs, dir: this.vfs.filesRoot, filepath });
+        }
+        return { action: "remove", paths };
+    }
+    async commit(request) {
+        const message = requireString(request.message, "message");
+        const oid = await git.commit({
+            fs,
+            dir: this.vfs.filesRoot,
+            message,
+            author: {
+                name: request.authorName ??
+                    process.env.GIT_AUTHOR_NAME ??
+                    process.env.GITHUB_USER ??
+                    "eliza",
+                email: request.authorEmail ??
+                    process.env.GIT_AUTHOR_EMAIL ??
+                    "eliza@example.local",
+            },
+        });
+        return { action: "commit", oid };
+    }
+    async log(request) {
+        const commits = await git.log({
+            fs,
+            dir: this.vfs.filesRoot,
+            ref: request.ref,
+            depth: request.depth ?? 20,
+        });
+        return {
+            action: "log",
+            commits: commits.map(commitView),
+        };
+    }
+    async branch(request) {
+        const ref = requireString(request.branch ?? request.ref, "branch");
+        await git.branch({
+            fs,
+            dir: this.vfs.filesRoot,
+            ref,
+            checkout: true,
+            force: request.force ?? false,
+        });
+        return {
+            action: "branch",
+            branch: await currentBranch(this.vfs.filesRoot),
+        };
+    }
+    async checkout(request) {
+        const ref = requireString(request.ref ?? request.branch, "ref");
+        await git.checkout({
+            fs,
+            dir: this.vfs.filesRoot,
+            ref,
+            force: request.force ?? false,
+        });
+        await rejectAndRemoveSymlinks(this.vfs.filesRoot);
+        return {
+            action: "checkout",
+            branch: await currentBranch(this.vfs.filesRoot),
+        };
+    }
+    async fetch(request) {
+        const result = await git.fetch({
+            fs,
+            http,
+            dir: this.vfs.filesRoot,
+            remote: request.remote ?? "origin",
+            ref: request.ref ?? request.branch,
+            singleBranch: request.singleBranch ?? true,
+            depth: request.depth ?? 1,
+            onAuth: authCallback(request),
+        });
+        return { action: "fetch", result };
+    }
+    async pull(request) {
+        const result = await git.pull({
+            fs,
+            http,
+            dir: this.vfs.filesRoot,
+            remote: request.remote ?? "origin",
+            ref: request.ref ?? request.branch,
+            singleBranch: request.singleBranch ?? true,
+            author: {
+                name: request.authorName ??
+                    process.env.GIT_AUTHOR_NAME ??
+                    process.env.GITHUB_USER ??
+                    "eliza",
+                email: request.authorEmail ??
+                    process.env.GIT_AUTHOR_EMAIL ??
+                    "eliza@example.local",
+            },
+            onAuth: authCallback(request),
+        });
+        await rejectAndRemoveSymlinks(this.vfs.filesRoot);
+        return { action: "pull", result };
+    }
+    async push(request) {
+        const result = await git.push({
+            fs,
+            http,
+            dir: this.vfs.filesRoot,
+            remote: request.remote ?? "origin",
+            ref: request.ref ?? request.branch,
+            force: request.force ?? false,
+            onAuth: authCallback(request),
+        });
+        return { action: "push", result };
+    }
+}
+function requireUrl(raw) {
+    const value = requireString(raw, "url");
+    const parsed = new URL(value);
+    if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
+        throw new VfsGitError("VFS Git only supports HTTP(S) remotes", "INVALID_GIT_URL");
+    }
+    return value;
+}
+function requireString(value, name) {
+    const trimmed = value?.trim();
+    if (!trimmed) {
+        throw new VfsGitError(`${name} is required`, "MISSING_ARGUMENT");
+    }
+    return trimmed;
+}
+function requestPaths(request) {
+    const paths = request.paths ?? (request.filepath ? [request.filepath] : []);
+    if (paths.length === 0) {
+        throw new VfsGitError("paths or filepath is required", "MISSING_ARGUMENT");
+    }
+    return paths.map(normalizeGitFilepath);
+}
+function normalizeGitFilepath(input) {
+    const normalized = path.posix.normalize(input.trim().replace(/\\/g, "/"));
+    const stripped = normalized.replace(/^\/+/, "");
+    if (!stripped ||
+        stripped === "." ||
+        stripped === ".." ||
+        stripped.startsWith("../") ||
+        path.posix.isAbsolute(stripped)) {
+        throw new VfsGitError("Invalid Git filepath", "INVALID_GIT_PATH");
+    }
+    return stripped;
+}
+function authCallback(request) {
+    const token = request.auth?.token ??
+        process.env.GITHUB_TOKEN?.trim() ??
+        process.env.GITHUB_PAT?.trim();
+    const username = request.auth?.username?.trim();
+    const password = request.auth?.password ?? token;
+    if (!password)
+        return undefined;
+    return () => ({
+        username: token ? (username ?? "x-access-token") : (username ?? "git"),
+        password,
+    });
+}
+function statusRowView(row) {
+    return {
+        filepath: `/${row[0]}`,
+        head: gitState(row[1]),
+        workdir: gitState(row[2]),
+        stage: gitState(row[3]),
+    };
+}
+function gitState(value) {
+    return value === 0 ? "absent" : value === 1 ? "unchanged" : "modified";
+}
+function isCleanStatus(row) {
+    return row[1] === row[2] && row[2] === row[3];
+}
+async function currentBranch(dir) {
+    return git
+        .currentBranch({ fs, dir, fullname: false })
+        .then((branch) => (typeof branch === "string" ? branch : null))
+        .catch(() => null);
+}
+function commitView(commit) {
+    return {
+        oid: commit.oid,
+        message: commit.commit.message,
+        author: commit.commit.author,
+        committer: commit.commit.committer,
+    };
+}
+async function rejectAndRemoveSymlinks(root) {
+    const symlinks = [];
+    const walk = async (dir) => {
+        for (const dirent of await fsp.readdir(dir, { withFileTypes: true })) {
+            const realPath = path.join(dir, dirent.name);
+            const stat = await fsp.lstat(realPath);
+            if (stat.isSymbolicLink()) {
+                symlinks.push(realPath);
+                continue;
+            }
+            if (stat.isDirectory())
+                await walk(realPath);
+        }
+    };
+    await walk(root);
+    for (const symlink of symlinks) {
+        await fsp.rm(symlink, { force: true });
+    }
+    if (symlinks.length > 0) {
+        throw new VfsGitError("Git operation produced symlinks, which are not allowed in VFS projects", "SYMLINK_DENIED");
+    }
+}
+function redactGitUrl(value) {
+    const url = new URL(value);
+    url.username = "";
+    url.password = "";
+    return url.toString();
+}

package/services/virtual-filesystem.d.ts

@@ -0,0 +1,100 @@
+export type VirtualFilesystemDiffStatus = "added" | "modified" | "deleted";
+export interface VirtualFilesystemOptions {
+    stateDir?: string;
+    projectId: string;
+    quotaBytes?: number;
+    maxFileBytes?: number;
+    now?: () => Date;
+}
+export interface VirtualFilesystemEntry {
+    path: string;
+    type: "file" | "directory";
+    size: number;
+    mtimeMs: number;
+}
+export interface VirtualFilesystemSnapshot {
+    id: string;
+    projectId: string;
+    createdAt: string;
+    root: string;
+    filesBytes: number;
+    fileCount: number;
+    note?: string;
+}
+export interface VirtualFilesystemRollback {
+    snapshotId: string;
+    projectId: string;
+    rolledBackAt: string;
+    previousSnapshotId?: string;
+}
+export interface VirtualFilesystemDiffEntry {
+    path: string;
+    status: VirtualFilesystemDiffStatus;
+    before?: VirtualFilesystemEntry;
+    after?: VirtualFilesystemEntry;
+}
+export interface VirtualFilesystemQuota {
+    usedBytes: number;
+    fileCount: number;
+    quotaBytes: number;
+    maxFileBytes: number;
+}
+export interface VirtualFilesystemExportFile extends VirtualFilesystemEntry {
+    bytes: Buffer;
+}
+export declare class VirtualFilesystemError extends Error {
+    readonly code: "PATH_TRAVERSAL" | "INVALID_PATH" | "NOT_FOUND" | "NOT_FILE" | "NOT_DIRECTORY" | "SYMLINK_DENIED" | "QUOTA_EXCEEDED" | "SNAPSHOT_NOT_FOUND";
+    constructor(message: string, code: "PATH_TRAVERSAL" | "INVALID_PATH" | "NOT_FOUND" | "NOT_FILE" | "NOT_DIRECTORY" | "SYMLINK_DENIED" | "QUOTA_EXCEEDED" | "SNAPSHOT_NOT_FOUND");
+}
+export declare class VirtualFilesystemService {
+    readonly projectId: string;
+    readonly projectRoot: string;
+    readonly filesRoot: string;
+    readonly snapshotsRoot: string;
+    readonly quotaBytes: number;
+    readonly maxFileBytes: number;
+    private readonly now;
+    constructor(options: VirtualFilesystemOptions);
+    initialize(): Promise<void>;
+    writeFile(virtualPath: string, contents: string | Uint8Array): Promise<VirtualFilesystemEntry>;
+    readFile(virtualPath: string, encoding?: BufferEncoding): Promise<string>;
+    readFileBytes(virtualPath: string): Promise<Buffer>;
+    list(virtualPath?: string, options?: {
+        recursive?: boolean;
+    }): Promise<VirtualFilesystemEntry[]>;
+    delete(virtualPath: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    createSnapshot(note?: string): Promise<VirtualFilesystemSnapshot>;
+    getSnapshot(id: string): Promise<VirtualFilesystemSnapshot>;
+    listSnapshots(): Promise<VirtualFilesystemSnapshot[]>;
+    diffSnapshots(beforeSnapshotId: string, afterSnapshotId: string): Promise<VirtualFilesystemDiffEntry[]>;
+    diffCurrent(snapshotId: string): Promise<VirtualFilesystemDiffEntry[]>;
+    rollback(snapshotId: string): Promise<VirtualFilesystemRollback>;
+    quota(): Promise<VirtualFilesystemQuota>;
+    resolveVirtualPath(virtualPath: string): string;
+    /**
+     * Resolve a virtual path to its absolute on-disk location, applying the same
+     * traversal/symlink rules used by readFile/writeFile. The returned path is
+     * always inside the project's `filesRoot` and is the path Node/Bun will use
+     * if you `pathToFileURL()` it for a dynamic import. The path is not required
+     * to exist — callers that need existence should `readFile` it first.
+     */
+    resolveDiskPath(virtualPath: string): string;
+    exportFiles(snapshotId?: string): Promise<VirtualFilesystemExportFile[]>;
+    private resolvePath;
+    private ensureSafeParentDirectory;
+    private rejectSymlinkIfExists;
+    private assertFile;
+    private assertDirectory;
+    private entryFor;
+    private listEntries;
+    private measureFiles;
+    private measureTree;
+    private fileSizeIfExists;
+    private readSnapshot;
+    private snapshotFilesRoot;
+    private indexTree;
+}
+export declare function createVirtualFilesystemService(options: VirtualFilesystemOptions): VirtualFilesystemService;
+//# sourceMappingURL=virtual-filesystem.d.ts.map

package/services/virtual-filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-filesystem.d.ts","sourceRoot":"","sources":["../../src/services/virtual-filesystem.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,2BAA2B,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAE3E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,2BAA2B,CAAC;IACpC,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,KAAK,CAAC,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,2BAA4B,SAAQ,sBAAsB;IACzE,KAAK,EAAE,MAAM,CAAC;CACf;AAWD,qBAAa,sBAAuB,SAAQ,KAAK;aAG7B,IAAI,EAChB,gBAAgB,GAChB,cAAc,GACd,WAAW,GACX,UAAU,GACV,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,oBAAoB;gBATxB,OAAO,EAAE,MAAM,EACC,IAAI,EAChB,gBAAgB,GAChB,cAAc,GACd,WAAW,GACX,UAAU,GACV,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,oBAAoB;CAK3B;AAED,qBAAa,wBAAwB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;gBAErB,OAAO,EAAE,wBAAwB;IAiBvC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,SAAS,CACb,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GAAG,UAAU,GAC5B,OAAO,CAAC,sBAAsB,CAAC;IA+B5B,QAAQ,CACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,cAAwB,GACjC,OAAO,CAAC,MAAM,CAAC;IAMZ,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMnD,IAAI,CACR,WAAW,SAAM,EACjB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GACpC,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAO9B,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GACpC,OAAO,CAAC,IAAI,CAAC;IAiBV,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IA2BjE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAW3D,aAAa,IAAI,OAAO,CAAC,yBAAyB,EAAE,CAAC;IAgBrD,aAAa,CACjB,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,0BAA0B,EAAE,CAAC;IAQlC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,EAAE,CAAC;IAOtE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAyBhE,KAAK,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAU9C,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAI/C;;;;;;OAMG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAItC,WAAW,CACf,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,2BAA2B,EAAE,CAAC;IAkCzC,OAAO,CAAC,WAAW;YAYL,yBAAyB;YAwBzB,qBAAqB;YAUrB,UAAU;YAiBV,eAAe;YAoBf,QAAQ;YAUR,WAAW;YAuBX,YAAY;YAIZ,WAAW;YA2BX,gBAAgB;YAehB,YAAY;YAaZ,iBAAiB;YAgBjB,SAAS;CA4BxB;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,CAE1B"}