Add example using Claude Agent SDK and AgentFS (#37)

Fixes #36

Author: penberg

.github/workflows/typescript.yml

@@ -77,3 +77,9 @@ jobs:
       run: |
         npm ci
         npm run build
+
+    - name: Test Claude Agent SDK Example
+      working-directory: examples/claude-agent/research-assistant
+      run: |
+        npm ci
+        npm run build

README.md

@@ -100,7 +100,14 @@ await agent.tools.record(
 );
 ```
 
-See the **[examples](examples)** directory for more comprehensive examples.
+### Examples
+
+AgentFS includes examples demonstrating integration with popular AI frameworks:
+
+- **[Mastra](examples/mastra/research-assistant)** - Research assistant using the Mastra AI framework
+- **[Claude Agent SDK](examples/claude-agent/research-assistant)** - Research assistant using Anthropic's Claude Agent SDK
+
+See the **[examples](examples)** directory for more details.
 
 ## 💡 Why AgentFS?
 

examples/claude-agent/research-assistant/.env.example

@@ -0,0 +1,5 @@
+# Anthropic API Key (required)
+ANTHROPIC_API_KEY=your-api-key-here
+
+# Optional: Custom AgentFS database path
+# AGENTFS_DB=agentfs.db

examples/claude-agent/research-assistant/.gitignore

@@ -0,0 +1,29 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# Environment files
+.env
+.env.local
+
+# AgentFS database
+agentfs.db
+agentfs.db-shm
+agentfs.db-wal
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*

examples/claude-agent/research-assistant/README.md

@@ -0,0 +1,17 @@
+# Research Assistant (VLDB + SIGMOD)
+
+A minimal research assistant that answers database research questions by finding most relevant papers from the VLDB and SIGMOD conference proceedings.
+
+## Getting Started
+
+Install dependencies:
+
+```console
+npm install
+```
+
+Ask a research question:
+
+```
+npm run ask -- "How do learned indexes compare to B+ trees?"
+```