vektor-slipstream 1.4.4 → 2.0.0

package/mistral/mistral-bridge.js

@@ -1,218 +0,0 @@
-'use strict';
-/**
- * mistral/mistral-bridge.js
- * VEKTOR SLIPSTREAM — Mistral HTTP Bridge
- * ─────────────────────────────────────────────────────────────────────────────
- * Lightweight HTTP server that exposes Slipstream memory as a tool endpoint
- * for Mistral agents (Le Chat, Mistral API, La Plateforme).
- *
- * Architecture: fully local — Mistral calls localhost:3847
- * Your memory never leaves your machine.
- *
- * Start via: node mistral/mistral-setup.js
- * Or directly: node mistral/mistral-bridge.js
- *
- * Endpoint: POST http://localhost:3847/api/v1/mistral/vektor_memoire
- * ─────────────────────────────────────────────────────────────────────────────
- */
-
-const http   = require('http');
-const path   = require('path');
-const fs     = require('fs');
-const os     = require('os');
-
-const PORT         = process.env.VEKTOR_MISTRAL_PORT || 3847;
-const CONFIG_PATH  = path.join(os.homedir(), '.vektor', 'mistral.config.json');
-
-// ── Load config ───────────────────────────────────────────────────────────────
-
-function loadConfig() {
-  try {
-    if (fs.existsSync(CONFIG_PATH)) {
-      return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8'));
-    }
-  } catch(_) {}
-  return null;
-}
-
-// ── Session state — per-key turn isolation ────────────────────────────────────
-// Prevents one Mistral session from stomping another.
-// TTL: 60s — stale sessions are garbage collected.
-
-const sessions    = new Map();
-const SESSION_TTL = 60_000;
-
-function getSession(key) {
-  const s = sessions.get(key);
-  if (s && Date.now() - s.updatedAt > SESSION_TTL) {
-    sessions.delete(key);
-    return { lastAction: 'NONE', updatedAt: Date.now() };
-  }
-  return s ?? { lastAction: 'NONE', updatedAt: Date.now() };
-}
-
-function setSession(key, action) {
-  sessions.set(key, { lastAction: action, updatedAt: Date.now() });
-}
-
-// ── Response helpers ──────────────────────────────────────────────────────────
-
-function json(res, status, body) {
-  const payload = JSON.stringify(body);
-  res.writeHead(status, {
-    'Content-Type':                'application/json',
-    'Content-Length':              Buffer.byteLength(payload),
-    'Access-Control-Allow-Origin': '*',
-  });
-  res.end(payload);
-}
-
-// ── Main handler ──────────────────────────────────────────────────────────────
-
-async function handler(req, res) {
-  // CORS preflight
-  if (req.method === 'OPTIONS') {
-    res.writeHead(204, { 'Access-Control-Allow-Origin': '*', 'Access-Control-Allow-Methods': 'POST', 'Access-Control-Allow-Headers': 'Content-Type' });
-    res.end();
-    return;
-  }
-
-  // Health check
-  if (req.method === 'GET' && req.url === '/health') {
-    return json(res, 200, { status: 'ok', bridge: 'vektor-mistral', version: '1.0.5' });
-  }
-
-  if (req.method !== 'POST' || req.url !== '/api/v1/mistral/vektor_memoire') {
-    return json(res, 404, { error: 'NOT_FOUND' });
-  }
-
-  // Parse body
-  let body;
-  try {
-    const raw = await new Promise((resolve, reject) => {
-      let data = '';
-      req.on('data', chunk => data += chunk);
-      req.on('end', () => resolve(data));
-      req.on('error', reject);
-    });
-    body = JSON.parse(raw);
-  } catch(_) {
-    return json(res, 400, { error: 'INVALID_JSON' });
-  }
-
-  const { key, action = 'recall', query, content, limit = 5 } = body;
-
-  // Require key
-  if (!key || key.length < 8) {
-    return json(res, 400, { error: 'MISSING_KEY', detail: 'Pass your Vektor licence key as the "key" field.' });
-  }
-
-  // Require query for recall, content for remember
-  if (action === 'recall' && !query) {
-    return json(res, 400, { error: 'MISSING_QUERY', detail: 'Pass a "query" string for recall operations.' });
-  }
-  if (action === 'remember' && !content) {
-    return json(res, 400, { error: 'MISSING_CONTENT', detail: 'Pass a "content" string for remember operations.' });
-  }
-
-  // Validate key against config
-  const config = loadConfig();
-  if (!config) {
-    return json(res, 503, {
-      error:  'BRIDGE_NOT_CONFIGURED',
-      detail: 'Run node mistral/mistral-setup.js first to activate the bridge.',
-    });
-  }
-
-  if (config.licenceKey !== key) {
-    return json(res, 401, { error: 'AUTHENTICATION_FAILED', detail: 'Key does not match registered licence.' });
-  }
-
-  // Load memory lazily — reuses the same db connection across requests
-  if (!handler._memory) {
-    try {
-      const { createMemory } = require('../slipstream-core');
-      handler._memory = await createMemory({
-        agentId:    config.agentId    || 'mistral-agent',
-        dbPath:     config.dbPath     || path.join(os.homedir(), '.vektor', 'mistral-memory.db'),
-        licenceKey: config.licenceKey,
-        silent:     true,
-      });
-      console.log('[mistral-bridge] Memory loaded:', config.dbPath || 'default path');
-    } catch(e) {
-      return json(res, 500, { error: 'MEMORY_INIT_FAILED', detail: e.message });
-    }
-  }
-
-  const memory = handler._memory;
-  const session = getSession(key);
-
-  try {
-    if (action === 'recall') {
-      const results = await memory.recall(query, Math.min(limit, 20));
-      setSession(key, 'RECALL');
-      return json(res, 200, {
-        action: 'recall',
-        query,
-        memory_fragments: results.map(r => ({
-          content:    r.content,
-          relevance:  r.score,
-          importance: r.importance,
-          id:         r.id,
-        })),
-        count:    results.length,
-        metadata: { engine: 'VEKTOR_MAGMA_v1.0.5', auth: 'VERIFIED', local: true },
-      });
-    }
-
-    if (action === 'remember') {
-      const result = await memory.remember(content, { importance: body.importance || 2 });
-      setSession(key, 'REMEMBER');
-      return json(res, 200, {
-        action:   'remember',
-        stored:   result.action !== 'NO_OP',
-        audn:     result.action,
-        id:       result.id,
-        content:  content.slice(0, 100),
-        metadata: { engine: 'VEKTOR_MAGMA_v1.0.5', auth: 'VERIFIED', local: true },
-      });
-    }
-
-    return json(res, 400, { error: 'INVALID_ACTION', detail: 'action must be "recall" or "remember"' });
-
-  } catch(e) {
-    console.error('[mistral-bridge] Error:', e.message);
-    return json(res, 500, { error: 'MEMORY_ERROR', detail: e.message });
-  }
-}
-
-// ── Start server ──────────────────────────────────────────────────────────────
-
-const server = http.createServer(handler);
-
-server.listen(PORT, '127.0.0.1', () => {
-  console.log('');
-  console.log('  ╔══════════════════════════════════════════════════════╗');
-  console.log('  ║         VEKTOR SLIPSTREAM — MISTRAL BRIDGE           ║');
-  console.log('  ╚══════════════════════════════════════════════════════╝');
-  console.log('');
-  console.log(`  Listening:  http://127.0.0.1:${PORT}`);
-  console.log(`  Endpoint:   POST /api/v1/mistral/vektor_memoire`);
-  console.log(`  Health:     GET  /health`);
-  console.log('');
-  console.log('  Your memory never leaves this machine.');
-  console.log('  Law I — Locality: enforced.');
-  console.log('');
-});
-
-server.on('error', err => {
-  if (err.code === 'EADDRINUSE') {
-    console.error(`[mistral-bridge] Port ${PORT} already in use.`);
-    console.error('[mistral-bridge] Either the bridge is already running, or change VEKTOR_MISTRAL_PORT.');
-  } else {
-    console.error('[mistral-bridge] Server error:', err.message);
-  }
-  process.exit(1);
-});
-
-module.exports = { server };

package/mistral/mistral-setup.js

@@ -1,220 +0,0 @@
-'use strict';
-/**
- * mistral/mistral-setup.js
- * VEKTOR SLIPSTREAM — Mistral Bridge Setup
- * ─────────────────────────────────────────────────────────────────────────────
- * Interactive CLI that:
- *   1. Prompts for your Vektor licence key
- *   2. Validates it against Polar
- *   3. Writes config to ~/.vektor/mistral.config.json
- *   4. Starts the local Mistral bridge on port 3847
- *
- * Run once to activate:
- *   node mistral/mistral-setup.js
- *
- * To start the bridge without setup (config already exists):
- *   node mistral/mistral-setup.js --start
- *
- * ─────────────────────────────────────────────────────────────────────────────
- */
-
-const readline = require('readline');
-const fs       = require('fs');
-const path     = require('path');
-const os       = require('os');
-const { spawn } = require('child_process');
-
-const CONFIG_DIR  = path.join(os.homedir(), '.vektor');
-const CONFIG_PATH = path.join(CONFIG_DIR, 'mistral.config.json');
-const BRIDGE_PATH = path.join(__dirname, 'mistral-bridge.js');
-const MANIFEST_PATH = path.join(__dirname, 'vektor-tool-manifest.json');
-
-// ── Helpers ───────────────────────────────────────────────────────────────────
-
-function ask(rl, question) {
-  return new Promise(resolve => rl.question(question, resolve));
-}
-
-function writeConfig(config) {
-  if (!fs.existsSync(CONFIG_DIR)) fs.mkdirSync(CONFIG_DIR, { recursive: true });
-  fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
-}
-
-function readConfig() {
-  try {
-    if (fs.existsSync(CONFIG_PATH)) return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8'));
-  } catch(_) {}
-  return null;
-}
-
-async function validateKey(licenceKey) {
-  const POLAR_ORG_ID = 'a922049c-3049-41e8-9b20-b18890576b6f';
-  const POLAR_API    = 'https://api.polar.sh/v1/customer-portal/license-keys/validate';
-
-  process.stdout.write('  Validating licence key...');
-
-  try {
-    const res = await fetch(POLAR_API, {
-      method:  'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body:    JSON.stringify({ key: licenceKey, organization_id: POLAR_ORG_ID }),
-      signal:  AbortSignal.timeout(10000),
-    });
-
-    if (!res.ok) {
-      process.stdout.write(' ✗\n');
-      return { valid: false, reason: `API error ${res.status}` };
-    }
-
-    const data = await res.json();
-    if (data.status !== 'granted') {
-      process.stdout.write(' ✗\n');
-      return { valid: false, reason: `Licence ${data.status}` };
-    }
-
-    process.stdout.write(' ✓\n');
-    return { valid: true, email: data.user?.email || '', tier: data.benefit?.type || 'slipstream' };
-
-  } catch(e) {
-    process.stdout.write(' ✗\n');
-    return { valid: false, reason: e.message };
-  }
-}
-
-function startBridge(background = false) {
-  if (background) {
-    // Detached background process — survives the setup script
-    const child = spawn(process.execPath, [BRIDGE_PATH], {
-      detached: true,
-      stdio:    'ignore',
-    });
-    child.unref();
-    console.log(`\n  Bridge started in background (PID ${child.pid})`);
-    console.log(`  To stop it: kill ${child.pid}`);
-  } else {
-    // Foreground — process stays open, logs to console
-    require(BRIDGE_PATH);
-  }
-}
-
-function printManifestInstructions() {
-  console.log('\n  ─────────────────────────────────────────────────────────');
-  console.log('  NEXT STEP — Add the tool to your Mistral agent');
-  console.log('  ─────────────────────────────────────────────────────────');
-  console.log('\n  Tool manifest location:');
-  console.log(`  ${MANIFEST_PATH}`);
-  console.log('\n  Add it to your Mistral agent config or La Plateforme project.');
-  console.log('  The bridge endpoint is: http://localhost:3847/api/v1/mistral/vektor_memoire');
-  console.log('\n  Example tool call from your Mistral agent:');
-  console.log('  {');
-  console.log('    "action": "recall",');
-  console.log('    "query":  "user coding preferences",');
-  console.log(`    "key":    "YOUR_LICENCE_KEY"`);
-  console.log('  }');
-  console.log('\n  ─────────────────────────────────────────────────────────\n');
-}
-
-// ── Main ──────────────────────────────────────────────────────────────────────
-
-async function main() {
-  console.log('');
-  console.log('  ╔══════════════════════════════════════════════════════╗');
-  console.log('  ║       VEKTOR SLIPSTREAM — MISTRAL BRIDGE SETUP       ║');
-  console.log('  ╚══════════════════════════════════════════════════════╝');
-  console.log('');
-
-  const startOnly = process.argv.includes('--start');
-
-  // If --start flag and config exists, skip setup
-  if (startOnly) {
-    const config = readConfig();
-    if (!config) {
-      console.error('  No config found. Run without --start to complete setup first.');
-      process.exit(1);
-    }
-    console.log(`  Config found. Starting bridge for agent: ${config.agentId}`);
-    startBridge(false);
-    return;
-  }
-
-  // Check for existing config
-  const existing = readConfig();
-  if (existing) {
-    console.log(`  Existing config found for licence: ${existing.licenceKey.slice(0, 12)}...`);
-    console.log(`  Agent ID: ${existing.agentId}`);
-    console.log(`  DB path:  ${existing.dbPath}`);
-    console.log('');
-  }
-
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-
-  try {
-    // Step 1 — Licence key
-    const defaultKey = existing?.licenceKey || process.env.VEKTOR_LICENCE_KEY || '';
-    const keyPrompt  = defaultKey
-      ? `  Enter licence key [${defaultKey.slice(0, 12)}...]: `
-      : '  Enter your Vektor licence key: ';
-
-    const rawKey = (await ask(rl, keyPrompt)).trim();
-    const licenceKey = rawKey || defaultKey;
-
-    if (!licenceKey || licenceKey.length < 8) {
-      console.error('\n  No licence key provided. Purchase at: https://vektormemory.com');
-      rl.close();
-      process.exit(1);
-    }
-
-    // Step 2 — Validate
-    const validation = await validateKey(licenceKey);
-    if (!validation.valid) {
-      console.error(`\n  Licence invalid: ${validation.reason}`);
-      console.error('  Purchase at: https://vektormemory.com');
-      rl.close();
-      process.exit(1);
-    }
-
-    if (validation.email) console.log(`  Licence owner: ${validation.email}`);
-
-    // Step 3 — Agent ID
-    const defaultAgentId = existing?.agentId || 'mistral-agent';
-    const agentIdRaw = (await ask(rl, `\n  Agent ID [${defaultAgentId}]: `)).trim();
-    const agentId = agentIdRaw || defaultAgentId;
-
-    // Step 4 — DB path
-    const defaultDbPath = existing?.dbPath || path.join(CONFIG_DIR, 'mistral-memory.db');
-    const dbPathRaw = (await ask(rl, `  Memory DB path [${defaultDbPath}]: `)).trim();
-    const dbPath = dbPathRaw || defaultDbPath;
-
-    // Step 5 — Background or foreground
-    const bgRaw = (await ask(rl, '\n  Run bridge in background? [Y/n]: ')).trim().toLowerCase();
-    const background = bgRaw !== 'n' && bgRaw !== 'no';
-
-    rl.close();
-
-    // Write config
-    const config = { licenceKey, agentId, dbPath, version: '1.0.5', createdAt: new Date().toISOString() };
-    writeConfig(config);
-
-    console.log('\n  ─────────────────────────────────────────────────────────');
-    console.log('  Config saved to: ~/.vektor/mistral.config.json');
-    console.log('  ─────────────────────────────────────────────────────────');
-
-    printManifestInstructions();
-
-    // Start bridge
-    startBridge(background);
-
-    if (background) {
-      console.log('\n  Setup complete. Bridge is running.');
-      console.log('  To restart: node mistral/mistral-setup.js --start\n');
-      process.exit(0);
-    }
-
-  } catch(e) {
-    rl.close();
-    console.error('\n  Setup error:', e.message);
-    process.exit(1);
-  }
-}
-
-main();

package/mistral/vektor-tool-manifest.json

@@ -1,41 +0,0 @@
-{
-  "function": {
-    "name": "vektor_memoire",
-    "description": "Query the VEKTOR Slipstream persistent memory graph for long-term context and recalled associations. Returns ranked memory fragments with importance scores. Requires a valid Vektor licence key. The bridge must be running locally via: node mistral/mistral-setup.js",
-    "parameters": {
-      "type": "object",
-      "properties": {
-        "query": {
-          "type": "string",
-          "description": "The concept, question, or topic to retrieve from memory."
-        },
-        "key": {
-          "type": "string",
-          "description": "Your Vektor Slipstream licence key (VEKTOR-XXXX-XXXX-XXXX)."
-        },
-        "action": {
-          "type": "string",
-          "description": "Operation to perform: 'recall' (default) to retrieve memories, 'remember' to store a new memory.",
-          "enum": ["recall", "remember"],
-          "default": "recall"
-        },
-        "content": {
-          "type": "string",
-          "description": "When action is 'remember': the text to store as a memory."
-        },
-        "limit": {
-          "type": "integer",
-          "description": "Maximum number of memory fragments to return (recall only). Default: 5. Max: 20.",
-          "default": 5,
-          "minimum": 1,
-          "maximum": 20
-        }
-      },
-      "required": ["key", "action"]
-    }
-  },
-  "_bridge": {
-    "url": "http://localhost:3847/api/v1/mistral/vektor_memoire",
-    "note": "The bridge runs locally on your machine. Start it with: node mistral/mistral-setup.js"
-  }
-}