@ekkos/mcp-server 2.0.3 → 2.0.4

package/dist/offline-queue.js

@@ -0,0 +1,118 @@
+/**
+ * Offline Write Queue for ekkOS MCP Server
+ *
+ * When the cloud gateway is unreachable, queues write operations
+ * (Forge, Track, Outcome, Directive) to a local JSONL file.
+ * Flushes the queue when connectivity is restored.
+ */
+import { appendFileSync, readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const CACHE_DIR = join(homedir(), '.ekkos', 'cache');
+const QUEUE_FILE = join(CACHE_DIR, 'pending-writes.jsonl');
+// Tools that perform writes and should be queued when offline
+const WRITE_TOOLS = new Set([
+    'ekkOS_Forge',
+    'ekkOS_Track',
+    'ekkOS_Outcome',
+    'ekkOS_Directive',
+    'ekkOS_UpdateDirective',
+    'ekkOS_DeleteDirective',
+    'ekkOS_Capture',
+    'ekkOS_StoreSecret',
+    'ekkOS_RotateSecret',
+    'ekkOS_DeleteSecret',
+]);
+/**
+ * Check if a tool is a write operation that can be queued
+ */
+export function isWriteTool(toolName) {
+    return WRITE_TOOLS.has(toolName);
+}
+/**
+ * Queue a write operation for later execution
+ */
+export function queueWrite(toolName, args) {
+    try {
+        if (!existsSync(CACHE_DIR)) {
+            mkdirSync(CACHE_DIR, { recursive: true });
+        }
+        const entry = {
+            timestamp: new Date().toISOString(),
+            toolName,
+            arguments: args,
+        };
+        appendFileSync(QUEUE_FILE, JSON.stringify(entry) + '\n');
+        console.error(`[ekkOS:offline] Queued ${toolName} for later sync`);
+    }
+    catch (err) {
+        console.error('[ekkOS:offline] Failed to queue write:', err);
+    }
+}
+/**
+ * Flush all pending writes to the cloud gateway
+ * Returns the number of successfully flushed writes
+ */
+export async function flushQueue(callGateway) {
+    if (!existsSync(QUEUE_FILE))
+        return 0;
+    let lines;
+    try {
+        const raw = readFileSync(QUEUE_FILE, 'utf-8').trim();
+        if (!raw)
+            return 0;
+        lines = raw.split('\n');
+    }
+    catch {
+        return 0;
+    }
+    let flushed = 0;
+    const failed = [];
+    for (const line of lines) {
+        try {
+            const entry = JSON.parse(line);
+            await callGateway('tools/call', 'tools/call', {
+                name: entry.toolName,
+                arguments: entry.arguments,
+            });
+            flushed++;
+        }
+        catch {
+            // Keep failed writes for next flush attempt
+            failed.push(line);
+        }
+    }
+    // Rewrite queue with only failed writes
+    try {
+        if (failed.length > 0) {
+            writeFileSync(QUEUE_FILE, failed.join('\n') + '\n');
+        }
+        else {
+            writeFileSync(QUEUE_FILE, '');
+        }
+    }
+    catch {
+        // Best effort cleanup
+    }
+    if (flushed > 0) {
+        console.error(`[ekkOS:offline] Flushed ${flushed} queued writes (${failed.length} remaining)`);
+    }
+    return flushed;
+}
+/**
+ * Get count of pending writes
+ */
+export function getPendingCount() {
+    try {
+        if (!existsSync(QUEUE_FILE))
+            return 0;
+        const raw = readFileSync(QUEUE_FILE, 'utf-8').trim();
+        if (!raw)
+            return 0;
+        return raw.split('\n').length;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=offline-queue.js.map

package/dist/offline-queue.js.map

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

package/ekkOS_CONTEXT.md

@@ -0,0 +1,62 @@
+---
+system_id: packages-ekkos-mcp-server
+domain: packages
+status: active
+last_compiled_at: 2026-03-17T00:54:14.311-04:00
+compiled_timezone: America/Toronto
+activity_status: active
+days_since_last_change: 15
+content_hash: dd7d874972bb04417852038485edca703142b4cb1c8e477abd26d7a8aa69f788
+invalidation_fingerprint: 60d856ec21bd71e6ac9cc693cdbdea5717a152588e2fc22b153f6cad9f6a0f1b
+recompile_reason: "1 local file change"
+source_event_ids: []
+source_event_count: 1
+evidence_window_start: 2026-03-17T00:54:11.658-04:00
+evidence_window_end: 2026-03-17T00:54:11.658-04:00
+confidence: medium
+redactions: 0
+compiled_by: ekkOS Local Compiler
+compiler_model: local-mechanical-v1
+compiler_template_version: local-mechanical-v4
+---
+
+<!-- EKKOS_AUTOGENERATED_START dd7d874972bb04417852038485edca703142b4cb1c8e477abd26d7a8aa69f788 -->
+
+# packages/ekkos-mcp-server
+
+Stdio-to-SSE bridge for [ekkOS](https://ekkos.dev) Memory substrate. Enables AI tools like Claude Code and Cursor to access your persistent memory via the Model Context Protocol (MCP).
+
+## Architecture
+- **Runtime**: JSON, TS, MD
+- **Entry points**: `index.ts`
+- **Key dependencies**: `@modelcontextprotocol/sdk`, `@sentry/node`, `@types/better-sqlite3`, `@types/node`, `typescript`
+- **Size**: 7 files across 1 directories (json (3), ts (3), md (1))
+
+## Key Modules
+- `src/` — 3 .ts files
+
+## Environment Variables
+- `EKKOS_API_KEY`
+- `EKKOS_DEBUG`
+- `EKKOS_MCP_URL`
+- `EKKOS_USER_ID`
+- `NODE_ENV`
+- `SENTRY_DSN`
+
+## Change Log
+- **Mar 1**: feat(synk): rebrand Happy Coder fork → ekkOS Synk — files: package-lock.json, package.json, index.ts, local-cache.ts, offline-queue.ts +12 more | - Rename packages: happy-wire → @ekkos/wire, happy-cli → @ekkos/remote, happy-agent → @ekkos/agent, happy-server → @ekko
+
+## Active Work
+These 1 file(s) changed since last compile:
+
+- `ekkos-mcp-server/package.json`
+
+## System Info
+- **Path**: `packages/ekkos-mcp-server` · **ID**: `packages-ekkos-mcp-server` · **Domain**: `packages`
+- **Status**: active (15d since last commit) · **Compiled**: Today, 12:54 AM
+- **Trigger**: 1 local file change
+
+<!-- EKKOS_AUTOGENERATED_END -->
+
+---
+*Generated directly from the local workspace to keep CLI context aligned with on-disk code.*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ekkos/mcp-server",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "ekkOS Memory MCP Server - stdio bridge to cloud memory substrate",
   "type": "module",
   "main": "dist/index.js",
@@ -32,7 +32,11 @@
     "@modelcontextprotocol/sdk": "^1.0.4",
     "@sentry/node": "^10.31.0"
   },
+  "optionalDependencies": {
+    "better-sqlite3": "^9.4.3"
+  },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.8",
     "@types/node": "^20.11.5",
     "typescript": "^5.3.3"
   },