agentfs-sdk 0.3.1 → 0.4.0-pre.10

package/dist/agentfs.d.ts

@@ -1,6 +1,6 @@
 import type { DatabasePromise } from '@tursodatabase/database-common';
 import { KvStore } from './kvstore.js';
-import { Filesystem } from './filesystem.js';
+import { AgentFS as Filesystem } from './filesystem/index.js';
 import { ToolCalls } from './toolcalls.js';
 /**
  * Configuration options for opening an AgentFS instance

package/dist/errors.d.ts

@@ -0,0 +1,20 @@
+/**
+ * POSIX-style error codes for filesystem operations.
+ */
+export type FsErrorCode = 'ENOENT' | 'EEXIST' | 'EISDIR' | 'ENOTDIR' | 'ENOTEMPTY' | 'EPERM' | 'EINVAL' | 'ENOSYS';
+/**
+ * Filesystem syscall names for error reporting.
+ * rm, scandir and copyFile are not actual syscall but used for convenience
+ */
+export type FsSyscall = 'open' | 'stat' | 'mkdir' | 'rmdir' | 'rm' | 'unlink' | 'rename' | 'scandir' | 'copyfile' | 'access';
+export interface ErrnoException extends Error {
+    code?: FsErrorCode;
+    syscall?: FsSyscall;
+    path?: string;
+}
+export declare function createFsError(params: {
+    code: FsErrorCode;
+    syscall: FsSyscall;
+    path?: string;
+    message?: string;
+}): ErrnoException;

package/dist/errors.js

@@ -0,0 +1,13 @@
+export function createFsError(params) {
+    const { code, syscall, path, message } = params;
+    const base = message ?? code;
+    const suffix = path !== undefined
+        ? ` '${path}'`
+        : '';
+    const err = new Error(`${code}: ${base}, ${syscall}${suffix}`);
+    err.code = code;
+    err.syscall = syscall;
+    if (path !== undefined)
+        err.path = path;
+    return err;
+}

package/dist/filesystem/agentfs.d.ts

@@ -0,0 +1,56 @@
+import type { DatabasePromise } from '@tursodatabase/database-common';
+import { type Stats, type DirEntry, type FilesystemStats, type FileHandle, type FileSystem } from './interface.js';
+/**
+ * A filesystem backed by SQLite, implementing the FileSystem interface.
+ */
+export declare class AgentFS implements FileSystem {
+    private db;
+    private bufferCtor;
+    private rootIno;
+    private chunkSize;
+    private constructor();
+    static fromDatabase(db: DatabasePromise, b?: BufferConstructor): Promise<AgentFS>;
+    getChunkSize(): number;
+    private initialize;
+    private ensureRoot;
+    private normalizePath;
+    private splitPath;
+    private resolvePathOrThrow;
+    private resolvePath;
+    private resolveParent;
+    private createInode;
+    private createDentry;
+    private ensureParentDirs;
+    private getLinkCount;
+    private getInodeMode;
+    writeFile(path: string, content: string | Buffer, options?: BufferEncoding | {
+        encoding?: BufferEncoding;
+    }): Promise<void>;
+    private updateFileContent;
+    readFile(path: string): Promise<Buffer>;
+    readFile(path: string, encoding: BufferEncoding): Promise<string>;
+    readFile(path: string, options: {
+        encoding: BufferEncoding;
+    }): Promise<string>;
+    readdir(path: string): Promise<string[]>;
+    readdirPlus(path: string): Promise<DirEntry[]>;
+    stat(path: string): Promise<Stats>;
+    lstat(path: string): Promise<Stats>;
+    mkdir(path: string): Promise<void>;
+    rmdir(path: string): Promise<void>;
+    unlink(path: string): Promise<void>;
+    rm(path: string, options?: {
+        force?: boolean;
+        recursive?: boolean;
+    }): Promise<void>;
+    private rmDirContentsRecursive;
+    private removeDentryAndMaybeInode;
+    rename(oldPath: string, newPath: string): Promise<void>;
+    copyFile(src: string, dest: string): Promise<void>;
+    symlink(target: string, linkpath: string): Promise<void>;
+    readlink(path: string): Promise<string>;
+    access(path: string): Promise<void>;
+    statfs(): Promise<FilesystemStats>;
+    open(path: string): Promise<FileHandle>;
+    deleteFile(path: string): Promise<void>;
+}