agentfs-sdk 0.2.3-pre.7 → 0.3.0-pre.4

package/dist/filesystem.d.ts

@@ -15,10 +15,13 @@ export interface Stats {
 }
 export declare class Filesystem {
     private db;
-    private initialized;
     private rootIno;
     private chunkSize;
-    constructor(db: Database);
+    private constructor();
+    /**
+     * Create a Filesystem from an existing database connection
+     */
+    static fromDatabase(db: Database): Promise<Filesystem>;
     /**
      * Get the configured chunk size
      */
@@ -62,12 +65,10 @@ export declare class Filesystem {
     private getLinkCount;
     writeFile(path: string, content: string | Buffer): Promise<void>;
     private updateFileContent;
-    readFile(path: string, encoding?: BufferEncoding): Promise<Buffer | string>;
+    readFile(path: string, options?: BufferEncoding | {
+        encoding?: BufferEncoding;
+    }): Promise<Buffer | string>;
     readdir(path: string): Promise<string[]>;
     deleteFile(path: string): Promise<void>;
     stat(path: string): Promise<Stats>;
-    /**
-     * Wait for initialization to complete
-     */
-    ready(): Promise<void>;
 }

package/dist/filesystem.js

@@ -15,7 +15,14 @@ class Filesystem {
         this.rootIno = 1;
         this.chunkSize = DEFAULT_CHUNK_SIZE;
         this.db = db;
-        this.initialized = this.initialize();
+    }
+    /**
+     * Create a Filesystem from an existing database connection
+     */
+    static async fromDatabase(db) {
+        const fs = new Filesystem(db);
+        await fs.initialize();
+        return fs;
     }
     /**
      * Get the configured chunk size
@@ -24,16 +31,6 @@ class Filesystem {
         return this.chunkSize;
     }
     async initialize() {
-        // Ensure database is connected
-        try {
-            await this.db.connect();
-        }
-        catch (error) {
-            // Ignore "already connected" errors
-            if (!error.message?.includes('already')) {
-                throw error;
-            }
-        }
         // Create the config table
         await this.db.exec(`
       CREATE TABLE IF NOT EXISTS fs_config (
@@ -141,7 +138,6 @@ class Filesystem {
      * Resolve a path to an inode number
      */
     async resolvePath(path) {
-        await this.initialized;
         const normalized = this.normalizePath(path);
         // Root directory
         if (normalized === '/') {
@@ -239,7 +235,6 @@ class Filesystem {
         return result.count;
     }
     async writeFile(path, content) {
-        await this.initialized;
         // Ensure parent directories exist
         await this.ensureParentDirs(path);
         // Check if file already exists
@@ -289,8 +284,11 @@ class Filesystem {
     `);
         await updateStmt.run(buffer.length, now, ino);
     }
-    async readFile(path, encoding) {
-        await this.initialized;
+    async readFile(path, options) {
+        // Normalize options
+        const encoding = typeof options === 'string'
+            ? options
+            : options?.encoding;
         const ino = await this.resolvePath(path);
         if (ino === null) {
             throw new Error(`ENOENT: no such file or directory, open '${path}'`);
@@ -321,7 +319,6 @@ class Filesystem {
         return combined;
     }
     async readdir(path) {
-        await this.initialized;
         const ino = await this.resolvePath(path);
         if (ino === null) {
             throw new Error(`ENOENT: no such file or directory, scandir '${path}'`);
@@ -336,7 +333,6 @@ class Filesystem {
         return rows.map(row => row.name);
     }
     async deleteFile(path) {
-        await this.initialized;
         const ino = await this.resolvePath(path);
         if (ino === null) {
             throw new Error(`ENOENT: no such file or directory, unlink '${path}'`);
@@ -363,7 +359,6 @@ class Filesystem {
         }
     }
     async stat(path) {
-        await this.initialized;
         const ino = await this.resolvePath(path);
         if (ino === null) {
             throw new Error(`ENOENT: no such file or directory, stat '${path}'`);
@@ -393,11 +388,5 @@ class Filesystem {
             isSymbolicLink: () => (row.mode & S_IFMT) === S_IFLNK,
         };
     }
-    /**
-     * Wait for initialization to complete
-     */
-    async ready() {
-        await this.initialized;
-    }
 }
 exports.Filesystem = Filesystem;

package/dist/index.d.ts

@@ -45,6 +45,7 @@ export declare class AgentFS {
      * ```
      */
     static open(options: AgentFSOptions): Promise<AgentFS>;
+    static openWith(db: Database): Promise<AgentFS>;
     /**
      * Get the underlying Database instance
      */

package/dist/index.js

@@ -58,15 +58,14 @@ class AgentFS {
         const db = new database_1.Database(dbPath);
         // Connect to the database to ensure it's created
         await db.connect();
-        // Create subsystems
-        const kv = new kvstore_1.KvStore(db);
-        const fs = new filesystem_1.Filesystem(db);
-        const tools = new toolcalls_1.ToolCalls(db);
-        // Wait for all subsystems to initialize
-        await kv.ready();
-        await fs.ready();
-        await tools.ready();
-        // Return fully initialized instance
+        return await AgentFS.openWith(db);
+    }
+    static async openWith(db) {
+        const [kv, fs, tools] = await Promise.all([
+            kvstore_1.KvStore.fromDatabase(db),
+            filesystem_1.Filesystem.fromDatabase(db),
+            toolcalls_1.ToolCalls.fromDatabase(db),
+        ]);
         return new AgentFS(db, kv, fs, tools);
     }
     /**

package/dist/kvstore.d.ts

@@ -1,14 +1,17 @@
 import { Database } from '@tursodatabase/database';
 export declare class KvStore {
     private db;
-    private initialized;
-    constructor(db: Database);
+    private constructor();
+    /**
+     * Create a KvStore from an existing database connection
+     */
+    static fromDatabase(db: Database): Promise<KvStore>;
     private initialize;
     set(key: string, value: any): Promise<void>;
-    get(key: string): Promise<any>;
+    get<T = any>(key: string): Promise<T | undefined>;
+    list(prefix: string): Promise<{
+        key: string;
+        value: any;
+    }[]>;
     delete(key: string): Promise<void>;
-    /**
-     * Wait for initialization to complete
-     */
-    ready(): Promise<void>;
 }

package/dist/kvstore.js

@@ -4,19 +4,16 @@ exports.KvStore = void 0;
 class KvStore {
     constructor(db) {
         this.db = db;
-        this.initialized = this.initialize();
+    }
+    /**
+     * Create a KvStore from an existing database connection
+     */
+    static async fromDatabase(db) {
+        const kv = new KvStore(db);
+        await kv.initialize();
+        return kv;
     }
     async initialize() {
-        // Ensure database is connected
-        try {
-            await this.db.connect();
-        }
-        catch (error) {
-            // Ignore "already connected" errors
-            if (!error.message?.includes('already')) {
-                throw error;
-            }
-        }
         // Create the key-value store table if it doesn't exist
         await this.db.exec(`
       CREATE TABLE IF NOT EXISTS kv_store (
@@ -33,7 +30,6 @@ class KvStore {
     `);
     }
     async set(key, value) {
-        await this.initialized;
         // Serialize the value to JSON
         const serializedValue = JSON.stringify(value);
         // Use prepared statement to insert or update
@@ -47,7 +43,6 @@ class KvStore {
         await stmt.run(key, serializedValue);
     }
     async get(key) {
-        await this.initialized;
         const stmt = this.db.prepare(`SELECT value FROM kv_store WHERE key = ?`);
         const row = await stmt.get(key);
         if (!row) {
@@ -56,16 +51,15 @@ class KvStore {
         // Deserialize the JSON value
         return JSON.parse(row.value);
     }
+    async list(prefix) {
+        const stmt = this.db.prepare(`SELECT key, value FROM kv_store WHERE key LIKE ? ESCAPE '\\'`);
+        const escaped = prefix.replace('\\', '\\\\').replace('%', '\\%').replace('_', '\\_');
+        const rows = await stmt.all(escaped + '%');
+        return rows.map(r => ({ key: r.key, value: JSON.parse(r.value) }));
+    }
     async delete(key) {
-        await this.initialized;
         const stmt = this.db.prepare(`DELETE FROM kv_store WHERE key = ?`);
         await stmt.run(key);
     }
-    /**
-     * Wait for initialization to complete
-     */
-    async ready() {
-        await this.initialized;
-    }
 }
 exports.KvStore = KvStore;

package/dist/toolcalls.d.ts

@@ -19,8 +19,11 @@ export interface ToolCallStats {
 }
 export declare class ToolCalls {
     private db;
-    private initialized;
-    constructor(db: Database);
+    private constructor();
+    /**
+     * Create a ToolCalls from an existing database connection
+     */
+    static fromDatabase(db: Database): Promise<ToolCalls>;
     private initialize;
     /**
      * Start a new tool call and mark it as pending
@@ -62,8 +65,4 @@ export declare class ToolCalls {
      * Helper to convert database row to ToolCall object
      */
     private rowToToolCall;
-    /**
-     * Wait for initialization to complete
-     */
-    ready(): Promise<void>;
 }

package/dist/toolcalls.js

@@ -4,19 +4,16 @@ exports.ToolCalls = void 0;
 class ToolCalls {
     constructor(db) {
         this.db = db;
-        this.initialized = this.initialize();
+    }
+    /**
+     * Create a ToolCalls from an existing database connection
+     */
+    static async fromDatabase(db) {
+        const tools = new ToolCalls(db);
+        await tools.initialize();
+        return tools;
     }
     async initialize() {
-        // Ensure database is connected
-        try {
-            await this.db.connect();
-        }
-        catch (error) {
-            // Ignore "already connected" errors
-            if (!error.message?.includes('already')) {
-                throw error;
-            }
-        }
         // Create the tool_calls table
         await this.db.exec(`
       CREATE TABLE IF NOT EXISTS tool_calls (
@@ -46,7 +43,6 @@ class ToolCalls {
      * Returns the ID of the created tool call record
      */
     async start(name, parameters) {
-        await this.initialized;
         const serializedParams = parameters !== undefined ? JSON.stringify(parameters) : null;
         const started_at = Math.floor(Date.now() / 1000);
         const stmt = this.db.prepare(`
@@ -60,7 +56,6 @@ class ToolCalls {
      * Mark a tool call as successful
      */
     async success(id, result) {
-        await this.initialized;
         const serializedResult = result !== undefined ? JSON.stringify(result) : null;
         const completed_at = Math.floor(Date.now() / 1000);
         // Get the started_at time to calculate duration
@@ -81,7 +76,6 @@ class ToolCalls {
      * Mark a tool call as failed
      */
     async error(id, error) {
-        await this.initialized;
         const completed_at = Math.floor(Date.now() / 1000);
         // Get the started_at time to calculate duration
         const getStmt = this.db.prepare('SELECT started_at FROM tool_calls WHERE id = ?');
@@ -103,7 +97,6 @@ class ToolCalls {
      * Returns the ID of the created tool call record
      */
     async record(name, started_at, completed_at, parameters, result, error) {
-        await this.initialized;
         const serializedParams = parameters !== undefined ? JSON.stringify(parameters) : null;
         const serializedResult = result !== undefined ? JSON.stringify(result) : null;
         const duration_ms = (completed_at - started_at) * 1000;
@@ -119,7 +112,6 @@ class ToolCalls {
      * Get a specific tool call by ID
      */
     async get(id) {
-        await this.initialized;
         const stmt = this.db.prepare(`
       SELECT * FROM tool_calls WHERE id = ?
     `);
@@ -133,7 +125,6 @@ class ToolCalls {
      * Query tool calls by name
      */
     async getByName(name, limit) {
-        await this.initialized;
         const limitClause = limit !== undefined ? `LIMIT ${limit}` : '';
         const stmt = this.db.prepare(`
       SELECT * FROM tool_calls
@@ -148,7 +139,6 @@ class ToolCalls {
      * Query recent tool calls
      */
     async getRecent(since, limit) {
-        await this.initialized;
         const limitClause = limit !== undefined ? `LIMIT ${limit}` : '';
         const stmt = this.db.prepare(`
       SELECT * FROM tool_calls
@@ -164,7 +154,6 @@ class ToolCalls {
      * Only includes completed calls (success or failed), not pending ones
      */
     async getStats() {
-        await this.initialized;
         const stmt = this.db.prepare(`
       SELECT
         name,
@@ -202,11 +191,5 @@ class ToolCalls {
             duration_ms: row.duration_ms !== null ? row.duration_ms : undefined,
         };
     }
-    /**
-     * Wait for initialization to complete
-     */
-    async ready() {
-        await this.initialized;
-    }
 }
 exports.ToolCalls = ToolCalls;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentfs-sdk",
-  "version": "0.2.3-pre.7",
+  "version": "0.3.0-pre.4",
   "description": "AgentFS SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -24,6 +24,10 @@
   ],
   "author": "",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tursodatabase/agentfs"
+  },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "@vitest/ui": "^4.0.1",