formagent-sdk 0.1.2 → 0.1.3

package/README.md

@@ -8,6 +8,7 @@ A powerful AI Agent framework for building intelligent assistants with streaming
 ## Features
 
 - **Session-Based API**: Multi-turn conversations with state management
+- **Persistent Sessions**: File-based storage for session persistence across restarts
 - **Streaming Support**: Real-time streaming of LLM responses with event-based notifications
 - **Built-in Tools**: File operations, bash execution, web fetch, and task management
 - **Tool System**: Flexible tool registration with Zod schema support
@@ -227,20 +228,68 @@ for await (const event of session.receive()) {
 
 ## Session Management
 
-Resume and fork sessions:
+### Persistent Sessions
+
+Enable session persistence with `FileSessionStorage`:
 
 ```typescript
-import { createSession, resumeSession, forkSession } from "formagent-sdk"
+import { createSession, FileSessionStorage, builtinTools } from "formagent-sdk"
+
+// Create persistent storage
+const storage = new FileSessionStorage("./sessions")
+
+// Create session with persistence
+const session = await createSession({
+  model: "claude-sonnet-4-20250514",
+  tools: builtinTools,
+  sessionStorage: storage,
+})
+
+console.log(`Session ID: ${session.id}`)  // Save this for later
+await session.close()
+```
+
+### Resume Sessions
+
+Resume a previous session with full conversation context:
+
+```typescript
+import { createSession, FileSessionStorage } from "formagent-sdk"
+
+const storage = new FileSessionStorage("./sessions")
 
-// Create a session
+// Resume from saved session ID
+const session = await createSession({
+  sessionStorage: storage,
+  resume: "previous-session-id",
+})
+
+await session.send("Continue where we left off")
+```
+
+### Global Storage Configuration
+
+Set a default storage for all sessions:
+
+```typescript
+import { setDefaultStorage, FileSessionStorage, createSession } from "formagent-sdk"
+
+// Set once at startup
+setDefaultStorage(new FileSessionStorage("./sessions"))
+
+// All sessions now persist automatically
 const session = await createSession({ model: "claude-sonnet-4-20250514" })
-const sessionId = session.id
+```
 
-// Later: Resume the session
-const resumed = await resumeSession(sessionId)
+### Fork Sessions
+
+Create a branch from an existing session:
+
+```typescript
+import { forkSession } from "formagent-sdk"
 
-// Or: Fork the session (create a branch)
-const forked = await forkSession(sessionId)
+// Fork creates a new session with copied conversation history
+const forked = await forkSession("original-session-id")
 ```
 
 ## Event Types
@@ -272,6 +321,7 @@ See the [examples](./examples) directory for complete examples:
 
 - [Getting Started](./docs/getting-started.md)
 - [API Reference](./docs/api-reference.md)
+- [Session Storage](./docs/session-storage.md)
 - [Built-in Tools](./docs/tools.md)
 - [MCP Servers](./docs/mcp-servers.md)
 

package/dist/cli/index.js

@@ -2630,6 +2630,7 @@ class OpenAIProvider {
 // src/api.ts
 var globalManager = null;
 var defaultProvider = null;
+var defaultStorage = null;
 function getGlobalManager() {
   if (!globalManager) {
     if (!defaultProvider) {
@@ -2646,16 +2647,29 @@ function getGlobalManager() {
     }
     globalManager = new SessionManagerImpl({
       provider: defaultProvider,
-      storage: new MemorySessionStorage
+      storage: defaultStorage ?? new MemorySessionStorage
     });
   }
   return globalManager;
 }
 async function createSession(options) {
-  if (options?.provider) {
+  if (options?.provider || options?.sessionStorage) {
+    let provider = options?.provider ?? defaultProvider;
+    if (!provider) {
+      if (process.env.ANTHROPIC_API_KEY) {
+        provider = new AnthropicProvider;
+      } else if (process.env.OPENAI_API_KEY) {
+        provider = new OpenAIProvider({
+          apiKey: process.env.OPENAI_API_KEY,
+          baseUrl: process.env.OPENAI_BASE_URL
+        });
+      } else {
+        throw new Error("No provider available. Set ANTHROPIC_API_KEY or OPENAI_API_KEY environment variable, " + "call setDefaultProvider(), or pass a provider in the options.");
+      }
+    }
     const customManager = new SessionManagerImpl({
-      provider: options.provider,
-      storage: new MemorySessionStorage
+      provider,
+      storage: options?.sessionStorage ?? defaultStorage ?? new MemorySessionStorage
     });
     return customManager.create(options);
   }

package/dist/index.js

@@ -3014,10 +3014,15 @@ function createOpenAIProvider(config) {
 // src/api.ts
 var globalManager = null;
 var defaultProvider = null;
+var defaultStorage = null;
 function setDefaultProvider(provider2) {
   defaultProvider = provider2;
   globalManager = null;
 }
+function setDefaultStorage(storage) {
+  defaultStorage = storage;
+  globalManager = null;
+}
 function getGlobalManager() {
   if (!globalManager) {
     if (!defaultProvider) {
@@ -3034,16 +3039,29 @@ function getGlobalManager() {
     }
     globalManager = new SessionManagerImpl({
       provider: defaultProvider,
-      storage: new MemorySessionStorage
+      storage: defaultStorage ?? new MemorySessionStorage
     });
   }
   return globalManager;
 }
 async function createSession(options2) {
-  if (options2?.provider) {
+  if (options2?.provider || options2?.sessionStorage) {
+    let provider2 = options2?.provider ?? defaultProvider;
+    if (!provider2) {
+      if (process.env.ANTHROPIC_API_KEY) {
+        provider2 = new AnthropicProvider;
+      } else if (process.env.OPENAI_API_KEY) {
+        provider2 = new OpenAIProvider({
+          apiKey: process.env.OPENAI_API_KEY,
+          baseUrl: process.env.OPENAI_BASE_URL
+        });
+      } else {
+        throw new Error("No provider available. Set ANTHROPIC_API_KEY or OPENAI_API_KEY environment variable, " + "call setDefaultProvider(), or pass a provider in the options.");
+      }
+    }
     const customManager = new SessionManagerImpl({
-      provider: options2.provider,
-      storage: new MemorySessionStorage
+      provider: provider2,
+      storage: options2?.sessionStorage ?? defaultStorage ?? new MemorySessionStorage
     });
     return customManager.create(options2);
   }
@@ -5588,6 +5606,7 @@ export {
   skillTool,
   simpleTool,
   setTodoChangeCallback,
+  setDefaultStorage,
   setDefaultProvider,
   serializeFrontmatter,
   resumeSession,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "formagent-sdk",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "FormAgent SDK - AI Agent framework with streaming support, tool execution, skill management, and hooks system",
   "type": "module",
   "main": "./dist/index.js",