Add example using OpenAI Agents SDK and AgentFS (#40)

Author: penberg

.github/workflows/typescript.yml

@@ -83,3 +83,9 @@ jobs:
       run: |
         npm ci
         npm run build
+
+    - name: Test OpenAI Agents Example
+      working-directory: examples/openai-agents/research-assistant
+      run: |
+        npm ci
+        npm run build

examples/openai-agents/research-assistant/.env.example

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

examples/openai-agents/research-assistant/.gitignore

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+.env
+*.db
+*.log

examples/openai-agents/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?"
+```