@xache/mcp-server 0.7.0 → 0.8.0

package/dist/index.js

@@ -647,6 +647,127 @@ const TOOLS = [
             required: ['name'],
         },
     },
+    // =========================================================================
+    // Memory Probe (Cognitive Fingerprints)
+    // =========================================================================
+    {
+        name: 'xache_memory_probe',
+        description: 'Search your memories by topic using zero-knowledge semantic matching. Uses cognitive fingerprints to find relevant memories without knowing exact storage keys. All fingerprint computation is client-side — the server never sees plaintext.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'What to search for in your memories',
+                },
+                category: {
+                    type: 'string',
+                    enum: [
+                        'preference', 'fact', 'event', 'procedure', 'relationship',
+                        'observation', 'decision', 'goal', 'constraint', 'reference',
+                        'summary', 'handoff', 'pattern', 'feedback', 'unknown',
+                    ],
+                    description: 'Optional cognitive category filter',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of results (default: 10, max: 50)',
+                },
+            },
+            required: ['query'],
+        },
+    },
+    // =========================================================================
+    // Ephemeral Context Tools
+    // =========================================================================
+    {
+        name: 'xache_ephemeral_create_session',
+        description: 'Create a new ephemeral working memory session. Returns a session key for storing temporary data in slots (conversation, facts, tasks, cache, scratch, handoff). Sessions auto-expire after TTL.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ttlSeconds: {
+                    type: 'number',
+                    description: 'Session time-to-live in seconds (default: 3600)',
+                },
+                maxWindows: {
+                    type: 'number',
+                    description: 'Maximum renewal windows (default: 5)',
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'xache_ephemeral_write_slot',
+        description: 'Write data to an ephemeral session slot. Use slots to organize working memory: conversation (dialog history), facts (extracted facts), tasks (current tasks), cache (temporary data), scratch (working notes), handoff (data for next agent).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sessionKey: {
+                    type: 'string',
+                    description: 'The ephemeral session key',
+                },
+                slot: {
+                    type: 'string',
+                    enum: ['conversation', 'facts', 'tasks', 'cache', 'scratch', 'handoff'],
+                    description: 'Slot name',
+                },
+                data: {
+                    type: 'object',
+                    description: 'Data to write to the slot',
+                },
+            },
+            required: ['sessionKey', 'slot', 'data'],
+        },
+    },
+    {
+        name: 'xache_ephemeral_read_slot',
+        description: 'Read data from an ephemeral session slot.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sessionKey: {
+                    type: 'string',
+                    description: 'The ephemeral session key',
+                },
+                slot: {
+                    type: 'string',
+                    enum: ['conversation', 'facts', 'tasks', 'cache', 'scratch', 'handoff'],
+                    description: 'Slot name',
+                },
+            },
+            required: ['sessionKey', 'slot'],
+        },
+    },
+    {
+        name: 'xache_ephemeral_promote',
+        description: 'Promote an ephemeral session to persistent memory. Extracts valuable data from all slots and stores as permanent memories with cryptographic receipts.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sessionKey: {
+                    type: 'string',
+                    description: 'The ephemeral session key to promote',
+                },
+            },
+            required: ['sessionKey'],
+        },
+    },
+    {
+        name: 'xache_ephemeral_status',
+        description: 'Get the status and details of an ephemeral session. Shows active slots, total size, TTL, window count, and cumulative cost.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sessionKey: {
+                    type: 'string',
+                    description: 'The ephemeral session key',
+                },
+            },
+            required: ['sessionKey'],
+        },
+    },
 ];
 // =============================================================================
 // Tool Handlers
@@ -1190,6 +1311,82 @@ async function handleGraphEntityHistory(client, args) {
     return output;
 }
 // =============================================================================
+// Memory Probe Handler
+// =============================================================================
+async function handleMemoryProbe(client, args) {
+    const result = await client.memory.probe({
+        query: args.query,
+        category: args.category,
+        limit: args.limit || 10,
+    });
+    const matches = result.matches || [];
+    if (matches.length === 0) {
+        return 'No matching memories found for this query.';
+    }
+    let output = `Found ${matches.length} matching memories (total: ${result.total}):\n`;
+    matches.forEach((match, i) => {
+        const data = typeof match.data === 'string'
+            ? match.data.slice(0, 300)
+            : JSON.stringify(match.data).slice(0, 300);
+        output += `\n${i + 1}. [${match.category}] ${data}`;
+        output += ` (key: ${match.storageKey})`;
+    });
+    return output;
+}
+// =============================================================================
+// Ephemeral Context Handlers
+// =============================================================================
+async function handleEphemeralCreateSession(client, args) {
+    const session = await client.ephemeral.createSession({
+        ttlSeconds: args.ttlSeconds,
+        maxWindows: args.maxWindows,
+    });
+    return [
+        `Created ephemeral session.`,
+        `Session Key: ${session.sessionKey}`,
+        `Status: ${session.status}`,
+        `TTL: ${session.ttlSeconds}s`,
+        `Window: ${session.window}/${session.maxWindows}`,
+        `Expires: ${session.expiresAt}`,
+    ].join('\n');
+}
+async function handleEphemeralWriteSlot(client, args) {
+    await client.ephemeral.writeSlot(args.sessionKey, args.slot, args.data);
+    return `Wrote data to slot "${args.slot}" in session ${args.sessionKey.substring(0, 12)}...`;
+}
+async function handleEphemeralReadSlot(client, args) {
+    const data = await client.ephemeral.readSlot(args.sessionKey, args.slot);
+    return `Slot "${args.slot}" data:\n${JSON.stringify(data, null, 2)}`;
+}
+async function handleEphemeralPromote(client, args) {
+    const result = await client.ephemeral.promoteSession(args.sessionKey);
+    let output = `Promoted session ${args.sessionKey.substring(0, 12)}...\n`;
+    output += `Memories created: ${result.memoriesCreated}\n`;
+    if (result.memoryIds.length > 0) {
+        output += `Memory IDs: ${result.memoryIds.join(', ')}\n`;
+    }
+    if (result.receiptId) {
+        output += `Receipt: ${result.receiptId}`;
+    }
+    return output;
+}
+async function handleEphemeralStatus(client, args) {
+    const session = await client.ephemeral.getSession(args.sessionKey);
+    if (!session) {
+        return `Session ${args.sessionKey.substring(0, 12)}... not found.`;
+    }
+    return [
+        `Session: ${session.sessionKey.substring(0, 12)}...`,
+        `Status: ${session.status}`,
+        `Window: ${session.window}/${session.maxWindows}`,
+        `TTL: ${session.ttlSeconds}s`,
+        `Expires: ${session.expiresAt}`,
+        `Active Slots: ${session.activeSlots.length > 0 ? session.activeSlots.join(', ') : 'none'}`,
+        `Total Size: ${session.totalSize} bytes`,
+        `Cumulative Cost: $${session.cumulativeCost.toFixed(4)}`,
+    ].join('\n');
+}
+// =============================================================================
 // Server Setup
 // =============================================================================
 async function main() {
@@ -1273,6 +1470,24 @@ async function main() {
                 case 'xache_graph_entity_history':
                     result = await handleGraphEntityHistory(client, args);
                     break;
+                case 'xache_memory_probe':
+                    result = await handleMemoryProbe(client, args);
+                    break;
+                case 'xache_ephemeral_create_session':
+                    result = await handleEphemeralCreateSession(client, args);
+                    break;
+                case 'xache_ephemeral_write_slot':
+                    result = await handleEphemeralWriteSlot(client, args);
+                    break;
+                case 'xache_ephemeral_read_slot':
+                    result = await handleEphemeralReadSlot(client, args);
+                    break;
+                case 'xache_ephemeral_promote':
+                    result = await handleEphemeralPromote(client, args);
+                    break;
+                case 'xache_ephemeral_status':
+                    result = await handleEphemeralStatus(client, args);
+                    break;
                 default:
                     throw new Error(`Unknown tool: ${name}`);
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xache/mcp-server",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "MCP server for Xache Protocol - collective intelligence, verifiable memory, and reputation for AI agents",
   "main": "dist/index.js",
   "bin": {
@@ -32,7 +32,7 @@
   "homepage": "https://xache.xyz",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "@xache/sdk": "workspace:*",
+    "@xache/sdk": "^5.10.0",
     "zod": "^3.22.0"
   },
   "devDependencies": {

package/src/index.ts

@@ -687,6 +687,38 @@ const TOOLS: Tool[] = [
     },
   },
 
+  // =========================================================================
+  // Memory Probe (Cognitive Fingerprints)
+  // =========================================================================
+  {
+    name: 'xache_memory_probe',
+    description:
+      'Search your memories by topic using zero-knowledge semantic matching. Uses cognitive fingerprints to find relevant memories without knowing exact storage keys. All fingerprint computation is client-side — the server never sees plaintext.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        query: {
+          type: 'string',
+          description: 'What to search for in your memories',
+        },
+        category: {
+          type: 'string',
+          enum: [
+            'preference', 'fact', 'event', 'procedure', 'relationship',
+            'observation', 'decision', 'goal', 'constraint', 'reference',
+            'summary', 'handoff', 'pattern', 'feedback', 'unknown',
+          ],
+          description: 'Optional cognitive category filter',
+        },
+        limit: {
+          type: 'number',
+          description: 'Maximum number of results (default: 10, max: 50)',
+        },
+      },
+      required: ['query'],
+    },
+  },
+
   // =========================================================================
   // Ephemeral Context Tools
   // =========================================================================
@@ -1526,6 +1558,39 @@ async function handleGraphEntityHistory(
   return output;
 }
 
+// =============================================================================
+// Memory Probe Handler
+// =============================================================================
+
+async function handleMemoryProbe(
+  client: XacheClient,
+  args: { query: string; category?: string; limit?: number }
+): Promise<string> {
+  const result = await client.memory.probe({
+    query: args.query,
+    category: args.category as any,
+    limit: args.limit || 10,
+  });
+
+  const matches = result.matches || [];
+
+  if (matches.length === 0) {
+    return 'No matching memories found for this query.';
+  }
+
+  let output = `Found ${matches.length} matching memories (total: ${result.total}):\n`;
+
+  matches.forEach((match: any, i: number) => {
+    const data = typeof match.data === 'string'
+      ? match.data.slice(0, 300)
+      : JSON.stringify(match.data).slice(0, 300);
+    output += `\n${i + 1}. [${match.category}] ${data}`;
+    output += ` (key: ${match.storageKey})`;
+  });
+
+  return output;
+}
+
 // =============================================================================
 // Ephemeral Context Handlers
 // =============================================================================
@@ -1698,6 +1763,9 @@ async function main(): Promise<void> {
         case 'xache_graph_entity_history':
           result = await handleGraphEntityHistory(client, args as any);
           break;
+        case 'xache_memory_probe':
+          result = await handleMemoryProbe(client, args as any);
+          break;
         case 'xache_ephemeral_create_session':
           result = await handleEphemeralCreateSession(client, args as any);
           break;