agentfs-sdk 0.3.0-pre.8 → 0.3.0

package/dist/agentfs.d.ts

@@ -0,0 +1,39 @@
+import type { DatabasePromise } from '@tursodatabase/database-common';
+import { KvStore } from './kvstore.js';
+import { Filesystem } from './filesystem.js';
+import { ToolCalls } from './toolcalls.js';
+/**
+ * Configuration options for opening an AgentFS instance
+ */
+export interface AgentFSOptions {
+    /**
+     * Unique identifier for the agent.
+     * - If provided without `path`: Creates storage at `.agentfs/{id}.db`
+     * - If provided with `path`: Uses the specified path
+     */
+    id?: string;
+    /**
+     * Explicit path to the database file.
+     * - If provided: Uses the specified path directly
+     * - Can be combined with `id`
+     */
+    path?: string;
+}
+export declare class AgentFSCore {
+    private db;
+    readonly kv: KvStore;
+    readonly fs: Filesystem;
+    readonly tools: ToolCalls;
+    /**
+     * Private constructor - use AgentFS.open() instead
+     */
+    protected constructor(db: DatabasePromise, kv: KvStore, fs: Filesystem, tools: ToolCalls);
+    /**
+     * Get the underlying Database instance
+     */
+    getDatabase(): DatabasePromise;
+    /**
+     * Close the database connection
+     */
+    close(): Promise<void>;
+}

package/dist/agentfs.js

@@ -0,0 +1,27 @@
+export class AgentFSCore {
+    db;
+    kv;
+    fs;
+    tools;
+    /**
+     * Private constructor - use AgentFS.open() instead
+     */
+    constructor(db, kv, fs, tools) {
+        this.db = db;
+        this.kv = kv;
+        this.fs = fs;
+        this.tools = tools;
+    }
+    /**
+     * Get the underlying Database instance
+     */
+    getDatabase() {
+        return this.db;
+    }
+    /**
+     * Close the database connection
+     */
+    async close() {
+        await this.db.close();
+    }
+}

package/dist/filesystem.d.ts

@@ -1,4 +1,4 @@
-import { Database } from '@tursodatabase/database';
+import type { DatabasePromise } from '@tursodatabase/database-common';
 export interface Stats {
     ino: number;
     mode: number;
@@ -15,13 +15,14 @@ export interface Stats {
 }
 export declare class Filesystem {
     private db;
+    private bufferCtor;
     private rootIno;
     private chunkSize;
     private constructor();
     /**
      * Create a Filesystem from an existing database connection
      */
-    static fromDatabase(db: Database): Promise<Filesystem>;
+    static fromDatabase(db: DatabasePromise, b?: BufferConstructor): Promise<Filesystem>;
     /**
      * Get the configured chunk size
      */

package/dist/filesystem.js

@@ -1,6 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Filesystem = void 0;
 // File types for mode field
 const S_IFMT = 0o170000; // File type mask
 const S_IFREG = 0o100000; // Regular file
@@ -10,17 +7,20 @@ const S_IFLNK = 0o120000; // Symbolic link
 const DEFAULT_FILE_MODE = S_IFREG | 0o644; // Regular file, rw-r--r--
 const DEFAULT_DIR_MODE = S_IFDIR | 0o755; // Directory, rwxr-xr-x
 const DEFAULT_CHUNK_SIZE = 4096;
-class Filesystem {
-    constructor(db) {
-        this.rootIno = 1;
-        this.chunkSize = DEFAULT_CHUNK_SIZE;
+export class Filesystem {
+    db;
+    bufferCtor;
+    rootIno = 1;
+    chunkSize = DEFAULT_CHUNK_SIZE;
+    constructor(db, b) {
         this.db = db;
+        this.bufferCtor = b;
     }
     /**
      * Create a Filesystem from an existing database connection
      */
-    static async fromDatabase(db) {
-        const fs = new Filesystem(db);
+    static async fromDatabase(db, b) {
+        const fs = new Filesystem(db, b ?? Buffer);
         await fs.initialize();
         return fs;
     }
@@ -259,7 +259,7 @@ class Filesystem {
         }
     }
     async updateFileContent(ino, content) {
-        const buffer = typeof content === 'string' ? Buffer.from(content, 'utf-8') : content;
+        const buffer = typeof content === 'string' ? this.bufferCtor.from(content, 'utf-8') : content;
         const now = Math.floor(Date.now() / 1000);
         // Delete existing data chunks
         const deleteStmt = this.db.prepare('DELETE FROM fs_data WHERE ino = ?');
@@ -303,12 +303,12 @@ class Filesystem {
         const rows = await stmt.all(ino);
         let combined;
         if (rows.length === 0) {
-            combined = Buffer.alloc(0);
+            combined = this.bufferCtor.alloc(0);
         }
         else {
             // Concatenate all chunks
             const buffers = rows.map(row => row.data);
-            combined = Buffer.concat(buffers);
+            combined = this.bufferCtor.concat(buffers);
         }
         // Update atime
         const now = Math.floor(Date.now() / 1000);
@@ -390,4 +390,3 @@ class Filesystem {
         };
     }
 }
-exports.Filesystem = Filesystem;

package/dist/index_browser.d.ts

@@ -0,0 +1,11 @@
+import { AgentFSCore } from "./agentfs.js";
+import { DatabasePromise } from "@tursodatabase/database-common";
+export declare class AgentFS extends AgentFSCore {
+    static openWith(db: DatabasePromise): Promise<AgentFSCore>;
+}
+export { AgentFSOptions } from './agentfs.js';
+export { KvStore } from './kvstore.js';
+export { Filesystem } from './filesystem.js';
+export type { Stats } from './filesystem.js';
+export { ToolCalls } from './toolcalls.js';
+export type { ToolCall, ToolCallStats } from './toolcalls.js';

package/dist/index_browser.js

@@ -0,0 +1,18 @@
+import { AgentFSCore } from "./agentfs.js";
+import { KvStore } from "./kvstore.js";
+import { Filesystem } from "./filesystem.js";
+import { ToolCalls } from "./toolcalls.js";
+import { Buffer } from "buffer";
+export class AgentFS extends AgentFSCore {
+    static async openWith(db) {
+        const [kv, fs, tools] = await Promise.all([
+            KvStore.fromDatabase(db),
+            Filesystem.fromDatabase(db, Buffer),
+            ToolCalls.fromDatabase(db),
+        ]);
+        return new AgentFS(db, kv, fs, tools);
+    }
+}
+export { KvStore } from './kvstore.js';
+export { Filesystem } from './filesystem.js';
+export { ToolCalls } from './toolcalls.js';

package/dist/index_node.d.ts

@@ -0,0 +1,28 @@
+import { AgentFSCore, AgentFSOptions } from "./agentfs.js";
+import { DatabasePromise } from "@tursodatabase/database-common";
+export declare class AgentFS extends AgentFSCore {
+    /**
+   * Open an agent filesystem
+   * @param options Configuration options (id and/or path required)
+   * @returns Fully initialized AgentFS instance
+   * @example
+   * ```typescript
+   * // Using id (creates .agentfs/my-agent.db)
+   * const agent = await AgentFS.open({ id: 'my-agent' });
+   *
+   * // Using id with custom path
+   * const agent = await AgentFS.open({ id: 'my-agent', path: './data/mydb.db' });
+   *
+   * // Using path only
+   * const agent = await AgentFS.open({ path: './data/mydb.db' });
+   * ```
+   */
+    static open(options: AgentFSOptions): Promise<AgentFS>;
+    static openWith(db: DatabasePromise): Promise<AgentFSCore>;
+}
+export { AgentFSOptions } from './agentfs.js';
+export { KvStore } from './kvstore.js';
+export { Filesystem } from './filesystem.js';
+export type { Stats } from './filesystem.js';
+export { ToolCalls } from './toolcalls.js';
+export type { ToolCall, ToolCallStats } from './toolcalls.js';

package/dist/index_node.js

@@ -0,0 +1,63 @@
+import { Database } from "@tursodatabase/database";
+import { existsSync, mkdirSync } from "fs";
+import { AgentFSCore } from "./agentfs.js";
+import { KvStore } from "./kvstore.js";
+import { Filesystem } from "./filesystem.js";
+import { ToolCalls } from "./toolcalls.js";
+export class AgentFS extends AgentFSCore {
+    /**
+   * Open an agent filesystem
+   * @param options Configuration options (id and/or path required)
+   * @returns Fully initialized AgentFS instance
+   * @example
+   * ```typescript
+   * // Using id (creates .agentfs/my-agent.db)
+   * const agent = await AgentFS.open({ id: 'my-agent' });
+   *
+   * // Using id with custom path
+   * const agent = await AgentFS.open({ id: 'my-agent', path: './data/mydb.db' });
+   *
+   * // Using path only
+   * const agent = await AgentFS.open({ path: './data/mydb.db' });
+   * ```
+   */
+    static async open(options) {
+        const { id, path } = options;
+        // Require at least id or path
+        if (!id && !path) {
+            throw new Error("AgentFS.open() requires at least 'id' or 'path'.");
+        }
+        // Validate agent ID if provided
+        if (id && !/^[a-zA-Z0-9_-]+$/.test(id)) {
+            throw new Error('Agent ID must contain only alphanumeric characters, hyphens, and underscores');
+        }
+        // Determine database path: explicit path takes precedence, otherwise use id-based path
+        let dbPath;
+        if (path) {
+            dbPath = path;
+        }
+        else {
+            // id is guaranteed to be defined here (we checked !id && !path above)
+            const dir = '.agentfs';
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+            dbPath = `${dir}/${id}.db`;
+        }
+        const db = new Database(dbPath);
+        // Connect to the database to ensure it's created
+        await db.connect();
+        return await this.openWith(db);
+    }
+    static async openWith(db) {
+        const [kv, fs, tools] = await Promise.all([
+            KvStore.fromDatabase(db),
+            Filesystem.fromDatabase(db),
+            ToolCalls.fromDatabase(db),
+        ]);
+        return new AgentFS(db, kv, fs, tools);
+    }
+}
+export { KvStore } from './kvstore.js';
+export { Filesystem } from './filesystem.js';
+export { ToolCalls } from './toolcalls.js';

package/dist/kvstore.d.ts

@@ -1,11 +1,11 @@
-import { Database } from '@tursodatabase/database';
+import type { DatabasePromise } from '@tursodatabase/database-common';
 export declare class KvStore {
     private db;
     private constructor();
     /**
      * Create a KvStore from an existing database connection
      */
-    static fromDatabase(db: Database): Promise<KvStore>;
+    static fromDatabase(db: DatabasePromise): Promise<KvStore>;
     private initialize;
     set(key: string, value: any): Promise<void>;
     get<T = any>(key: string): Promise<T | undefined>;

package/dist/kvstore.js

@@ -1,7 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.KvStore = void 0;
-class KvStore {
+export class KvStore {
+    db;
     constructor(db) {
         this.db = db;
     }
@@ -62,4 +60,3 @@ class KvStore {
         await stmt.run(key);
     }
 }
-exports.KvStore = KvStore;

package/dist/toolcalls.d.ts

@@ -1,4 +1,4 @@
-import { Database } from '@tursodatabase/database';
+import type { DatabasePromise } from '@tursodatabase/database-common';
 export interface ToolCall {
     id: number;
     name: string;
@@ -23,7 +23,7 @@ export declare class ToolCalls {
     /**
      * Create a ToolCalls from an existing database connection
      */
-    static fromDatabase(db: Database): Promise<ToolCalls>;
+    static fromDatabase(db: DatabasePromise): Promise<ToolCalls>;
     private initialize;
     /**
      * Start a new tool call and mark it as pending

package/dist/toolcalls.js

@@ -1,7 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToolCalls = void 0;
-class ToolCalls {
+export class ToolCalls {
+    db;
     constructor(db) {
         this.db = db;
     }
@@ -194,4 +192,3 @@ class ToolCalls {
         };
     }
 }
-exports.ToolCalls = ToolCalls;

package/package.json

@@ -1,19 +1,28 @@
 {
   "name": "agentfs-sdk",
-  "version": "0.3.0-pre.8",
+  "version": "0.3.0",
   "description": "AgentFS SDK",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "dist/index_node.js",
+  "types": "dist/index_node.d.ts",
   "packageManager": "npm@10.9.0",
+  "type": "module",
   "scripts": {
     "build": "tsc",
     "watch": "tsc --watch",
     "test": "vitest run",
+    "test:browser": "CI=1 vitest -c vitest.browser.config.ts --browser=chromium --run && CI=1 vitest -c vitest.browser.config.ts --browser=firefox --run",
     "test:watch": "vitest watch",
     "test:ui": "vitest --ui",
     "test:coverage": "vitest run --coverage",
     "prepublishOnly": "npm run build"
   },
+  "exports": {
+    ".": {
+      "node": "./dist/index_node.js",
+      "browser": "./dist/index_browser.js",
+      "default": "./dist/index_node.js"
+    }
+  },
   "keywords": [
     "ai",
     "agent",
@@ -29,13 +38,18 @@
     "url": "https://github.com/tursodatabase/agentfs"
   },
   "devDependencies": {
+    "@tursodatabase/database-wasm": "^0.4.0-pre.17",
     "@types/node": "^20.0.0",
+    "@vitest/browser": "^4.0.16",
+    "@vitest/browser-playwright": "^4.0.16",
     "@vitest/ui": "^4.0.1",
     "typescript": "^5.3.0",
     "vitest": "^4.0.1"
   },
   "dependencies": {
-    "@tursodatabase/database": "^0.4.0-pre.17"
+    "@tursodatabase/database": "^0.4.0-pre.17",
+    "@tursodatabase/database-common": "^0.4.0-pre.17",
+    "buffer": "^6.0.3"
   },
   "files": [
     "dist"

package/dist/index.d.ts

@@ -1,62 +0,0 @@
-import { Database } from '@tursodatabase/database';
-import { KvStore } from './kvstore';
-import { Filesystem } from './filesystem';
-import { ToolCalls } from './toolcalls';
-/**
- * Configuration options for opening an AgentFS instance
- */
-export interface AgentFSOptions {
-    /**
-     * Unique identifier for the agent.
-     * - If provided without `path`: Creates storage at `.agentfs/{id}.db`
-     * - If provided with `path`: Uses the specified path
-     */
-    id?: string;
-    /**
-     * Explicit path to the database file.
-     * - If provided: Uses the specified path directly
-     * - Can be combined with `id`
-     */
-    path?: string;
-}
-export declare class AgentFS {
-    private db;
-    readonly kv: KvStore;
-    readonly fs: Filesystem;
-    readonly tools: ToolCalls;
-    /**
-     * Private constructor - use AgentFS.open() instead
-     */
-    private constructor();
-    /**
-     * Open an agent filesystem
-     * @param options Configuration options (id and/or path required)
-     * @returns Fully initialized AgentFS instance
-     * @example
-     * ```typescript
-     * // Using id (creates .agentfs/my-agent.db)
-     * const agent = await AgentFS.open({ id: 'my-agent' });
-     *
-     * // Using id with custom path
-     * const agent = await AgentFS.open({ id: 'my-agent', path: './data/mydb.db' });
-     *
-     * // Using path only
-     * const agent = await AgentFS.open({ path: './data/mydb.db' });
-     * ```
-     */
-    static open(options: AgentFSOptions): Promise<AgentFS>;
-    static openWith(db: Database): Promise<AgentFS>;
-    /**
-     * Get the underlying Database instance
-     */
-    getDatabase(): Database;
-    /**
-     * Close the database connection
-     */
-    close(): Promise<void>;
-}
-export { KvStore } from './kvstore';
-export { Filesystem } from './filesystem';
-export type { Stats } from './filesystem';
-export { ToolCalls } from './toolcalls';
-export type { ToolCall, ToolCallStats } from './toolcalls';

package/dist/index.js

@@ -1,90 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToolCalls = exports.Filesystem = exports.KvStore = exports.AgentFS = void 0;
-const database_1 = require("@tursodatabase/database");
-const fs_1 = require("fs");
-const kvstore_1 = require("./kvstore");
-const filesystem_1 = require("./filesystem");
-const toolcalls_1 = require("./toolcalls");
-class AgentFS {
-    /**
-     * Private constructor - use AgentFS.open() instead
-     */
-    constructor(db, kv, fs, tools) {
-        this.db = db;
-        this.kv = kv;
-        this.fs = fs;
-        this.tools = tools;
-    }
-    /**
-     * Open an agent filesystem
-     * @param options Configuration options (id and/or path required)
-     * @returns Fully initialized AgentFS instance
-     * @example
-     * ```typescript
-     * // Using id (creates .agentfs/my-agent.db)
-     * const agent = await AgentFS.open({ id: 'my-agent' });
-     *
-     * // Using id with custom path
-     * const agent = await AgentFS.open({ id: 'my-agent', path: './data/mydb.db' });
-     *
-     * // Using path only
-     * const agent = await AgentFS.open({ path: './data/mydb.db' });
-     * ```
-     */
-    static async open(options) {
-        const { id, path } = options;
-        // Require at least id or path
-        if (!id && !path) {
-            throw new Error("AgentFS.open() requires at least 'id' or 'path'.");
-        }
-        // Validate agent ID if provided
-        if (id && !/^[a-zA-Z0-9_-]+$/.test(id)) {
-            throw new Error('Agent ID must contain only alphanumeric characters, hyphens, and underscores');
-        }
-        // Determine database path: explicit path takes precedence, otherwise use id-based path
-        let dbPath;
-        if (path) {
-            dbPath = path;
-        }
-        else {
-            // id is guaranteed to be defined here (we checked !id && !path above)
-            const dir = '.agentfs';
-            if (!(0, fs_1.existsSync)(dir)) {
-                (0, fs_1.mkdirSync)(dir, { recursive: true });
-            }
-            dbPath = `${dir}/${id}.db`;
-        }
-        const db = new database_1.Database(dbPath);
-        // Connect to the database to ensure it's created
-        await db.connect();
-        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);
-    }
-    /**
-     * Get the underlying Database instance
-     */
-    getDatabase() {
-        return this.db;
-    }
-    /**
-     * Close the database connection
-     */
-    async close() {
-        await this.db.close();
-    }
-}
-exports.AgentFS = AgentFS;
-var kvstore_2 = require("./kvstore");
-Object.defineProperty(exports, "KvStore", { enumerable: true, get: function () { return kvstore_2.KvStore; } });
-var filesystem_2 = require("./filesystem");
-Object.defineProperty(exports, "Filesystem", { enumerable: true, get: function () { return filesystem_2.Filesystem; } });
-var toolcalls_2 = require("./toolcalls");
-Object.defineProperty(exports, "ToolCalls", { enumerable: true, get: function () { return toolcalls_2.ToolCalls; } });