@lantanios/agentic-server 0.1.0 → 0.2.0

package/.env.example

@@ -1,16 +1,16 @@
-# Server
-PORT=3847
-CORS_ORIGINS=http://localhost:3000,http://localhost:5173
-
-# MongoDB
-MONGODB_URI=mongodb+srv://user:pass@cluster.mongodb.net/Agentic?retryWrites=true&w=majority
-
-# OpenAI (for embeddings + TTS fallback)
-OPENAI_API_KEY=sk-...
-
-# Local audio server (your PC)
-LOCAL_STT_ENDPOINT=http://localhost:8001
-LOCAL_TTS_ENDPOINT=http://localhost:8001
-
-# Cloud fallbacks (optional)
-DEEPGRAM_API_KEY=
+# Server
+PORT=3847
+CORS_ORIGINS=http://localhost:3000,http://localhost:5173
+
+# MongoDB
+MONGODB_URI=mongodb+srv://user:pass@cluster.mongodb.net/Agentic?retryWrites=true&w=majority
+
+# OpenAI (for embeddings + TTS fallback)
+OPENAI_API_KEY=sk-...
+
+# Local audio server (your PC)
+LOCAL_STT_ENDPOINT=http://localhost:8001
+LOCAL_TTS_ENDPOINT=http://localhost:8001
+
+# Cloud fallbacks (optional)
+DEEPGRAM_API_KEY=

package/README.md

@@ -0,0 +1,397 @@
+# @lantanios/agentic-server
+
+Real-time Socket.IO server combining memory, audio, and event communication for AI agents.
+
+## Features
+
+- 🔌 **Socket.IO namespaces** — Separate channels for memory, audio, events
+- 🧠 **Memory namespace** — CRUD + vector search via WebSocket
+- 🎙️ **Audio namespace** — Real-time STT/TTS streaming
+- 📡 **Events namespace** — Pub/sub, broadcast, direct messaging between agents
+- 🔄 **Priority providers** — Local-first audio with cloud fallback
+
+## Installation
+
+```bash
+npm install @lantanios/agentic-server
+```
+
+## Configuration
+
+Create `.env`:
+
+```bash
+# Server
+PORT=3847
+CORS_ORIGINS=http://localhost:3000,http://localhost:5173
+
+# MongoDB (required)
+MONGODB_URI=mongodb+srv://user:pass@cluster.mongodb.net/Agentic
+
+# OpenAI (required for embeddings, optional for TTS)
+OPENAI_API_KEY=sk-...
+
+# Local audio server (optional, for local STT/TTS)
+LOCAL_STT_ENDPOINT=http://localhost:8001
+LOCAL_TTS_ENDPOINT=http://localhost:8001
+
+# Cloud fallbacks (optional)
+DEEPGRAM_API_KEY=...
+```
+
+## Quick Start
+
+### Run the Server
+
+```bash
+# Using npx
+npx @lantanios/agentic-server
+
+# Or in code
+import '@lantanios/agentic-server';
+```
+
+### Connect from Client
+
+```typescript
+import { io } from 'socket.io-client';
+
+// Connect to memory namespace
+const memory = io('http://localhost:3847/memory', {
+  auth: { agentId: 'pip' }  // Required: your agent ID
+});
+
+// Connect to audio namespace
+const audio = io('http://localhost:3847/audio', {
+  auth: { agentId: 'pip' }
+});
+
+// Connect to events namespace
+const events = io('http://localhost:3847/events', {
+  auth: { agentId: 'pip' }
+});
+```
+
+## Socket.IO Namespaces
+
+### `/memory` — Memory Operations
+
+All operations require `agentId` in auth. Agents can only access their own memories.
+
+#### Create Memory
+
+```typescript
+memory.emit('create', {
+  type: 'fact',
+  content: 'User prefers dark mode',
+  metadata: {
+    importance: 4,
+    tags: ['preferences', 'ui'],
+    project: 'settings',
+  }
+}, (response) => {
+  if (response.success) {
+    console.log('Created:', response.memory);
+  }
+});
+```
+
+#### List Memories
+
+```typescript
+memory.emit('list', {
+  type: 'fact',           // optional filter
+  project: 'settings',    // optional filter
+  minImportance: 3,       // optional filter
+  limit: 20,
+  offset: 0,
+}, (response) => {
+  console.log(response.memories);
+  console.log(`Total: ${response.total}`);
+});
+```
+
+#### Vector Search
+
+```typescript
+memory.emit('search', {
+  query: 'what are the user preferences?',
+  limit: 10,
+  minScore: 0.7,
+}, (response) => {
+  response.results.forEach(r => {
+    console.log(`${r.score.toFixed(2)}: ${r.content}`);
+  });
+});
+```
+
+#### Recall Context
+
+```typescript
+memory.emit('recall', {
+  context: 'Starting work on the Lantanios project',
+  limit: 30,
+}, (response) => {
+  console.log('Important:', response.breakdown.important);
+  console.log('Context-matched:', response.breakdown.contextMatched);
+  console.log('Recent:', response.breakdown.recent);
+  console.log('Memories:', response.memories);
+});
+```
+
+#### Other Operations
+
+```typescript
+// Get single memory
+memory.emit('get', memoryId, callback);
+
+// Update memory
+memory.emit('update', { id: memoryId, content: 'Updated content' }, callback);
+
+// Delete memory (soft delete)
+memory.emit('delete', memoryId, callback);
+
+// Get summary stats
+memory.emit('summary', (response) => {
+  console.log(response.summary);
+});
+```
+
+### `/audio` — Audio Streaming
+
+#### Stream Recording
+
+```typescript
+// Start recording
+audio.emit('stream:start', {}, (response) => {
+  console.log('Recording started');
+});
+
+// Send audio chunks (from microphone)
+mediaRecorder.ondataavailable = (e) => {
+  audio.emit('stream:chunk', e.data);
+};
+
+// Stop and get transcription
+audio.emit('stream:stop', { language: 'en' }, (response) => {
+  if (response.success) {
+    console.log('Transcript:', response.result.text);
+  }
+});
+
+// Also emitted as event
+audio.on('transcription', (result) => {
+  console.log('Transcript:', result.text);
+});
+```
+
+#### One-shot Transcription
+
+```typescript
+audio.emit('transcribe', {
+  audio: audioBuffer,  // Buffer or ArrayBuffer
+  language: 'en',
+  provider: 'local-whisper',  // optional: force provider
+}, (response) => {
+  console.log(response.result.text);
+});
+```
+
+#### Text to Speech
+
+```typescript
+// One-shot TTS
+audio.emit('speak', {
+  text: 'Hello, how can I help you?',
+  voice: 'nova',
+  speed: 1.0,
+  format: 'mp3',
+}, (response) => {
+  if (response.success) {
+    playAudio(response.audio);  // Buffer
+  }
+});
+
+// Streaming TTS
+audio.emit('speak:stream', {
+  text: 'This is a long response that will be streamed...',
+  voice: 'nova',
+});
+
+audio.on('speak:start', () => console.log('TTS started'));
+audio.on('speak:chunk', (chunk) => streamToSpeaker(chunk));
+audio.on('speak:end', () => console.log('TTS finished'));
+audio.on('speak:error', (err) => console.error(err));
+```
+
+#### Check Providers
+
+```typescript
+audio.emit('providers:status', (response) => {
+  console.log(response.status);
+  // { stt: { 'local-whisper': true }, tts: { 'local-piper': false, 'openai-tts': true } }
+});
+```
+
+### `/events` — Agent Communication
+
+#### Subscribe to Channels
+
+```typescript
+events.emit('subscribe', 'project-updates', (response) => {
+  console.log(`Subscribed to ${response.channel}`);
+});
+
+events.emit('unsubscribe', 'project-updates', callback);
+```
+
+#### Publish to Channel
+
+```typescript
+events.emit('publish', {
+  channel: 'project-updates',
+  event: 'task-completed',
+  payload: { taskId: '123', status: 'done' },
+}, (response) => {
+  console.log(`Delivered to ${response.delivered} subscribers`);
+});
+
+// Receive events
+events.on('event', (data) => {
+  console.log(`[${data.channel}] ${data.event} from ${data.from}:`, data.payload);
+});
+```
+
+#### Broadcast to All Agents
+
+```typescript
+events.emit('broadcast', {
+  event: 'system-alert',
+  payload: { message: 'Server restarting in 5 minutes' },
+}, (response) => {
+  console.log(`Broadcast to ${response.delivered} agents`);
+});
+
+events.on('broadcast', (data) => {
+  console.log(`Broadcast from ${data.from}:`, data.event, data.payload);
+});
+```
+
+#### Direct Message
+
+```typescript
+events.emit('dm', {
+  to: 'deep',  // Target agent ID
+  event: 'private-message',
+  payload: { text: 'Hey Deep, can you check the Lantanios logs?' },
+}, (response) => {
+  console.log(response.delivered ? 'Delivered' : 'Agent not online');
+});
+
+events.on('dm', (data) => {
+  console.log(`DM from ${data.from}:`, data.event, data.payload);
+});
+```
+
+#### List Online Agents
+
+```typescript
+events.emit('agents:list', (response) => {
+  console.log('Online agents:', response.agents);
+  // ['pip', 'deep']
+});
+```
+
+## REST Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| `GET` | `/health` | Health check with MongoDB and socket status |
+| `GET` | `/providers` | Audio provider availability |
+
+```bash
+curl http://localhost:3847/health
+# { "status": "ok", "mongodb": "connected", "sockets": 2 }
+
+curl http://localhost:3847/providers
+# { "status": "ok", "providers": { "stt": {...}, "tts": {...} } }
+```
+
+## Architecture
+
+```
+Client (Browser/Node)
+    │
+    ├── Socket.IO ─────► /memory  ────► MongoDB + OpenAI Embeddings
+    │
+    ├── Socket.IO ─────► /audio   ────► Local Whisper/Piper
+    │                                   └──► Deepgram/OpenAI (fallback)
+    │
+    └── Socket.IO ─────► /events  ────► Pub/Sub (in-memory)
+```
+
+## Example: Full Agent Connection
+
+```typescript
+import { io } from 'socket.io-client';
+
+class AgentClient {
+  private memory;
+  private audio;
+  private events;
+
+  constructor(serverUrl: string, agentId: string) {
+    const auth = { agentId };
+
+    this.memory = io(`${serverUrl}/memory`, { auth });
+    this.audio = io(`${serverUrl}/audio`, { auth });
+    this.events = io(`${serverUrl}/events`, { auth });
+
+    // Subscribe to relevant channels
+    this.events.emit('subscribe', 'system');
+    this.events.on('event', this.handleEvent.bind(this));
+    this.events.on('dm', this.handleDM.bind(this));
+  }
+
+  async remember(content: string, type = 'fact', importance = 3) {
+    return new Promise((resolve) => {
+      this.memory.emit('create', { type, content, metadata: { importance } }, resolve);
+    });
+  }
+
+  async search(query: string) {
+    return new Promise((resolve) => {
+      this.memory.emit('search', { query, limit: 10 }, resolve);
+    });
+  }
+
+  async transcribe(audioBuffer: Buffer) {
+    return new Promise((resolve) => {
+      this.audio.emit('transcribe', { audio: audioBuffer }, resolve);
+    });
+  }
+
+  async speak(text: string) {
+    return new Promise((resolve) => {
+      this.audio.emit('speak', { text }, resolve);
+    });
+  }
+
+  private handleEvent(data) {
+    console.log(`Event from ${data.from}:`, data.event);
+  }
+
+  private handleDM(data) {
+    console.log(`DM from ${data.from}:`, data.payload);
+  }
+}
+
+// Usage
+const agent = new AgentClient('http://localhost:3847', 'pip');
+await agent.remember('User asked about weather', 'conversation', 2);
+const results = await agent.search('weather conversations');
+```
+
+## License
+
+Private - Lantanios

package/dist/config.d.ts

@@ -1,6 +1,7 @@
 export declare const config: {
     port: number;
     mongoUri: string;
+    redisUrl: string;
     openaiApiKey: string;
     corsOrigins: string[];
     audio: {

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;CAuBlB,CAAC;AAEF,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAWzC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;CA0BlB,CAAC;AAEF,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAWzC"}

package/dist/config.js

@@ -11,6 +11,8 @@ exports.config = {
     port: parseInt(process.env.PORT || '3847', 10),
     // MongoDB
     mongoUri: process.env.MONGODB_URI || '',
+    // Redis (optional — system degrades gracefully without it)
+    redisUrl: process.env.REDIS_URL || '',
     // OpenAI (for embeddings)
     openaiApiKey: process.env.OPENAI_API_KEY || '',
     // CORS

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;;AA4BA,wCAWC;AAvCD,oDAA4B;AAC5B,gBAAM,CAAC,MAAM,EAAE,CAAC;AAEH,QAAA,MAAM,GAAG;IACpB,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC;IAE9C,UAAU;IACV,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE;IAEvC,0BAA0B;IAC1B,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE;IAE9C,OAAO;IACP,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,uBAAuB,CAAC;IAE9E,kBAAkB;IAClB,KAAK,EAAE;QACL,GAAG,EAAE;YACH,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,uBAAuB;YACxE,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE;SACnD;QACD,GAAG,EAAE;YACH,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,uBAAuB;YACxE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE;SAC/C;KACF;CACF,CAAC;AAEF,SAAgB,cAAc;IAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,cAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,CAAC,cAAM,CAAC,YAAY,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;;AA+BA,wCAWC;AA1CD,oDAA4B;AAC5B,gBAAM,CAAC,MAAM,EAAE,CAAC;AAEH,QAAA,MAAM,GAAG;IACpB,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC;IAE9C,UAAU;IACV,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE;IAEvC,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE;IAErC,0BAA0B;IAC1B,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE;IAE9C,OAAO;IACP,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,uBAAuB,CAAC;IAE9E,kBAAkB;IAClB,KAAK,EAAE;QACL,GAAG,EAAE;YACH,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,uBAAuB;YACxE,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE;SACnD;QACD,GAAG,EAAE;YACH,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,uBAAuB;YACxE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE;SAC/C;KACF;CACF,CAAC;AAEF,SAAgB,cAAc;IAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,cAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,CAAC,cAAM,CAAC,YAAY,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAOnC,QAAA,MAAM,GAAG,EAAE,WAAuB,CAAC;AAInC,QAAA,MAAM,UAAU,oGAAoB,CAAC;AAErC,QAAA,MAAM,EAAE,+HAMN,CAAC;AAwHH,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAQnC,QAAA,MAAM,GAAG,EAAE,WAAuB,CAAC;AAInC,QAAA,MAAM,UAAU,oGAAoB,CAAC;AAErC,QAAA,MAAM,EAAE,+HAMN,CAAC;AAiJH,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC"}

package/dist/index.js

@@ -12,6 +12,7 @@ const mongoose_1 = __importDefault(require("mongoose"));
 const config_1 = require("./config");
 const namespaces_1 = require("./namespaces");
 const agentic_audio_1 = require("@lantanios/agentic-audio");
+const agentic_redis_1 = require("@lantanios/agentic-redis");
 const app = (0, express_1.default)();
 exports.app = app;
 app.use((0, cors_1.default)({ origin: config_1.config.corsOrigins }));
@@ -77,10 +78,19 @@ function createAudioService() {
 // Health check
 app.get('/health', async (_req, res) => {
     const mongoStatus = mongoose_1.default.connection.readyState === 1 ? 'connected' : 'disconnected';
+    let redisHealth = { connected: false, latencyMs: null };
+    try {
+        redisHealth = await (0, agentic_redis_1.checkRedisHealth)();
+    }
+    catch {
+        // Redis not available
+    }
     res.json({
         status: 'ok',
         timestamp: new Date().toISOString(),
         mongodb: mongoStatus,
+        redis: redisHealth.connected ? 'connected' : 'disconnected',
+        redisLatencyMs: redisHealth.latencyMs,
         sockets: io.engine.clientsCount,
     });
 });
@@ -114,20 +124,38 @@ async function start() {
             console.error('✗ MongoDB connection failed:', err);
         }
     }
+    // Connect to Redis (optional — degrades gracefully)
+    if (config_1.config.redisUrl) {
+        try {
+            (0, agentic_redis_1.initRedis)({ url: config_1.config.redisUrl });
+            await (0, agentic_redis_1.connectRedis)();
+            console.log('✓ Connected to Redis');
+        }
+        catch (err) {
+            console.warn('✗ Redis connection failed (continuing without):', err.message);
+        }
+    }
+    else {
+        console.log('⊘ Redis not configured (set REDIS_URL to enable caching)');
+    }
     // Create audio service
     const audioService = createAudioService();
     // Setup Socket.IO namespaces
     (0, namespaces_1.setupMemoryNamespace)(io.of('/memory'));
     (0, namespaces_1.setupAudioNamespace)(io.of('/audio'), { audioService });
     (0, namespaces_1.setupEventsNamespace)(io.of('/events'));
+    (0, namespaces_1.setupContextNamespace)(io.of('/context'));
+    (0, namespaces_1.setupSyncNamespace)(io.of('/sync'));
     console.log('✓ Socket.IO namespaces configured');
     // Start server
     httpServer.listen(config_1.config.port, () => {
         console.log(`\n✓ @lantanios/agentic-server running on http://localhost:${config_1.config.port}`);
         console.log('\nNamespaces:');
-        console.log('  /memory  - Memory CRUD + vector search');
-        console.log('  /audio   - STT/TTS streaming');
-        console.log('  /events  - Pub/sub + direct messaging');
+        console.log('  /memory   - Memory CRUD + vector search');
+        console.log('  /context  - Context assembly + goals + search');
+        console.log('  /sync     - Bidirectional SQLite ↔ MongoDB sync');
+        console.log('  /audio    - STT/TTS streaming');
+        console.log('  /events   - Pub/sub + direct messaging');
         console.log('\nREST endpoints:');
         console.log('  GET /health    - Health check');
         console.log('  GET /providers - Audio provider status');

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/namespaces/context.d.ts

@@ -0,0 +1,9 @@
+/**
+ * /context Namespace
+ *
+ * Context assembly, search, goal management, and state tracking
+ * via Socket.IO. Central coordination point for the Context Engine.
+ */
+import { Namespace } from 'socket.io';
+export declare function setupContextNamespace(io: Namespace): void;
+//# sourceMappingURL=context.d.ts.map

package/dist/namespaces/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/namespaces/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAU,MAAM,WAAW,CAAC;AAqB9C,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,SAAS,QA8PlD"}