agentfs-sdk 0.1.1 → 0.2.0-pre.1

package/dist/index.d.ts

@@ -2,6 +2,17 @@ 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 {
+    /**
+     * Optional unique identifier for the agent.
+     * - If provided: Creates persistent storage at `.agentfs/{id}.db`
+     * - If omitted: Uses ephemeral in-memory database
+     */
+    id?: string;
+}
 export declare class AgentFS {
     private db;
     readonly kv: KvStore;
@@ -13,10 +24,19 @@ export declare class AgentFS {
     private constructor();
     /**
      * Open an agent filesystem
-     * @param dbPath Path to the database file (defaults to ':memory:')
+     * @param options Configuration options (optional id for persistent storage)
      * @returns Fully initialized AgentFS instance
+     * @example
+     * ```typescript
+     * // Persistent storage
+     * const agent = await AgentFS.open({ id: 'my-agent' });
+     * // Creates: .agentfs/my-agent.db
+     *
+     * // Ephemeral in-memory database
+     * const agent = await AgentFS.open();
+     * ```
      */
-    static open(dbPath?: string): Promise<AgentFS>;
+    static open(options?: AgentFSOptions): Promise<AgentFS>;
     /**
      * Get the underlying Database instance
      */

package/dist/index.js

@@ -2,6 +2,7 @@
 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");
@@ -17,10 +18,44 @@ class AgentFS {
     }
     /**
      * Open an agent filesystem
-     * @param dbPath Path to the database file (defaults to ':memory:')
+     * @param options Configuration options (optional id for persistent storage)
      * @returns Fully initialized AgentFS instance
+     * @example
+     * ```typescript
+     * // Persistent storage
+     * const agent = await AgentFS.open({ id: 'my-agent' });
+     * // Creates: .agentfs/my-agent.db
+     *
+     * // Ephemeral in-memory database
+     * const agent = await AgentFS.open();
+     * ```
      */
-    static async open(dbPath = ':memory:') {
+    static async open(options) {
+        // Error handling for old API usage
+        if (typeof options === 'string') {
+            throw new Error(`AgentFS.open() no longer accepts string paths. ` +
+                `Please use: AgentFS.open({ id: 'your-id' }) for persistent storage, ` +
+                `or AgentFS.open() for ephemeral in-memory database.`);
+        }
+        const { id } = options || {};
+        // Determine database path based on id
+        let dbPath;
+        if (!id) {
+            // No id = ephemeral in-memory database
+            dbPath = ':memory:';
+        }
+        else {
+            // Validate agent ID to prevent path traversal attacks
+            if (!/^[a-zA-Z0-9_-]+$/.test(id)) {
+                throw new Error('Agent ID must contain only alphanumeric characters, hyphens, and underscores');
+            }
+            // Ensure .agentfs directory exists
+            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();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentfs-sdk",
-  "version": "0.1.1",
+  "version": "0.2.0-pre.1",
   "description": "AgentFS SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",