vektor-slipstream 1.4.3 → 1.4.5

package/README.md

@@ -3,6 +3,7 @@
 Hardware-accelerated persistent memory for AI agents. Local-first. No cloud. One-time payment.
 
 [![npm](https://img.shields.io/npm/v/vektor-slipstream)](https://www.npmjs.com/package/vektor-slipstream)
+[![downloads](https://img.shields.io/npm/dw/vektor-slipstream)](https://www.npmjs.com/package/vektor-slipstream)
 [![license](https://img.shields.io/badge/license-Commercial-blue)](https://vektormemory.com/product#pricing)
 
 ## Install
@@ -39,7 +40,83 @@ const delta = await memory.delta('project decisions', 7);
 const brief = await memory.briefing();
 ```
 
-## CLI
+---
+
+## CLI Chat — Persistent Memory Terminal
+
+Chat with any LLM with full memory across every session. Zero configuration.
+
+```bash
+npx vektor chat                          # start chat (auto-detects Ollama)
+npx vektor chat --provider claude        # use Anthropic Claude
+npx vektor chat --provider groq --model llama-3.3-70b-versatile
+npx vektor chat --provider gemini
+npx vektor chat --provider openai
+```
+
+### Providers
+
+| Provider | Details |
+|---|---|
+| `ollama` | Default — free, local, no API key. Auto-detects best installed model. |
+| `claude` | Anthropic Claude — set `ANTHROPIC_API_KEY` |
+| `openai` | OpenAI GPT — set `OPENAI_API_KEY` |
+| `groq` | Groq LLaMA — set `GROQ_API_KEY` (free tier available) |
+| `gemini` | Google Gemini — set `GEMINI_API_KEY` |
+
+Set a permanent default:
+```bash
+# Windows
+$env:VEKTOR_PROVIDER = "claude"
+
+# macOS/Linux
+export VEKTOR_PROVIDER=claude
+```
+
+### In-chat commands
+
+Type `/` to see available commands with autocomplete. Tab to select, arrow keys to navigate.
+
+| Command | Action |
+|---|---|
+| `/recall <query>` | Search MAGMA memory mid-conversation |
+| `/stats` | Show memory node count, edges, pinned |
+| `/briefing` | Generate memory briefing inline |
+| `/exit` | Exit chat (Ctrl+C also works) |
+
+### One-liner commands
+
+```bash
+# Store a fact
+npx vektor remember "I prefer TypeScript over JavaScript"
+npx vektor remember "deadline is Friday" --importance 5
+
+# Pipe support
+cat meeting-notes.txt | npx vektor remember
+
+# One-shot recall + LLM answer
+npx vektor ask "what stack am I using?"
+npx vektor ask "what did we decide about the database?"
+
+# Autonomous goal executor
+npx vektor agent "summarise everything I know about project Alpha"
+npx vektor agent "research AI memory tools" --steps 15 --provider groq
+```
+
+### Ollama auto-detection
+
+VEKTOR queries `http://localhost:11434/api/tags` and picks the best available model:
+`qwen3` → `qwen2` → `llama` → `mistral` → first available.
+
+Override:
+```bash
+$env:OLLAMA_MODEL = "qwen3.5:4b"
+export OLLAMA_MODEL=qwen3.5:4b
+```
+
+---
+
+## All CLI Commands
 
 ```bash
 npx vektor setup      # First-run wizard — licence, hardware, integrations
@@ -48,49 +125,110 @@ npx vektor test       # Test memory engine with progress bar
 npx vektor status     # System health check
 npx vektor mcp        # Start Claude Desktop MCP server
 npx vektor rem        # Run REM dream cycle
-npx vektor chat       # Persistent memory chat (all LLMs)
-npx vektor remember   # Store a fact: npx vektor remember "I prefer TypeScript"
-npx vektor ask        # Query memory: npx vektor ask "what stack am I using?"
-npx vektor agent      # Autonomous goal executor
+npx vektor chat       # Persistent memory chat (all LLMs)
+npx vektor remember   # Store a fact
+npx vektor ask        # Query memory + LLM answer
+npx vektor agent      # Autonomous goal executor
 npx vektor help       # All commands
 ```
 
-## CLOAK — Developer Context Layer for Claude Code
+---
+
+## Claude Desktop Extension (DXT)
+
+Install the `.dxt` extension for zero-config memory in every Claude Desktop session.
+
+**Install:** drag `vektor-slipstream.dxt` onto the Claude Desktop Extensions page.
+
+Once installed, Claude automatically:
+- Recalls relevant context at session start
+- Stores facts and decisions during conversation
+- Summarises at session end
 
-CLOAK is a 4-tool MCP layer that gives Claude Code persistent memory of your project.
-Every session starts with full context. Every error is remembered. Every wasted token is tracked.
+All 28 tools are available in Claude Desktop — no configuration needed beyond your licence key.
 
-### What it does
+**User config fields:**
 
-| Tool | Does exactly one thing |
+| Field | Purpose |
 |---|---|
-| `cloak_cortex` | Scans project files, builds a token-aware anatomy index in Vektor's entity graph |
-| `cloak_axon` | Session boundary handler — loads last context on start, saves MemCell on stop |
-| `cloak_cerebellum` | Pre-write enforcer — checks writes against known error patterns, auto-resolves fixes |
-| `cloak_token` | Token ledger — detects repeated reads and waste, one summary write per session |
+| `licence_key` | Your Polar licence key (required) |
+| `db_path` | Memory DB path (defaults to `~/vektor-slipstream-memory.db`) |
+| `project_path` | Default path for `cloak_cortex` project scanning (optional) |
 
-### Import
+Download the latest `.dxt` from [vektormemory.com/docs/dxt](https://vektormemory.com/docs/dxt).
 
-```js
-const { runCortex }        = require('vektor-slipstream/cloak/cortex');
-const { onSessionStart,
-        onSessionStop }    = require('vektor-slipstream/cloak/axon');
-const { checkWrite,
-        recordError }      = require('vektor-slipstream/cloak/cerebellum');
-const { getSessionSummary} = require('vektor-slipstream/cloak/token');
-
-// Clean terminal output (replaces emoji with box-drawing chars)
-const { createMemory }     = require('vektor-slipstream/boot');
-```
+---
+
+## MCP Tools — All 28
+
+### Memory Tools
 
-### Claude Code setup
+| Tool | Function |
+|---|---|
+| `vektor_recall` | Semantic search across MAGMA graph |
+| `vektor_store` | Store memory with importance score |
+| `vektor_graph` | Traverse associative memory graph |
+| `vektor_delta` | See what changed on a topic over time |
+| `vektor_briefing` | Generate morning briefing from recent memories |
+
+### CLOAK Core
+
+| Tool | Function |
+|---|---|
+| `cloak_fetch` | Stealth headless browser fetch via Playwright |
+| `cloak_fetch_smart` | Checks `llms.txt` first, falls back to stealth browser |
+| `cloak_render` | Full CSS/DOM layout sensor |
+| `cloak_diff` | Semantic diff of URL since last fetch |
+| `cloak_diff_text` | Structural diff between two text blobs |
+| `cloak_passport` | AES-256-GCM credential vault (get/set/delete/list) |
+| `tokens_saved` | Token efficiency ROI calculator |
+
+### Identity Tools
+
+| Tool | Function |
+|---|---|
+| `cloak_identity_create` | Create persistent browser fingerprint identity |
+| `cloak_identity_use` | Apply saved identity to a fetch call |
+| `cloak_identity_list` | List all saved identities with trust summary |
+
+### Behaviour Tools
+
+| Tool | Function |
+|---|---|
+| `cloak_inject_behaviour` | Human mouse/scroll injection for reCAPTCHA/Cloudflare bypass |
+| `cloak_behaviour_stats` | List available patterns and categories |
+| `cloak_load_pattern` | Load custom recorded behaviour pattern |
+| `cloak_pattern_stats` | Self-improving pattern store tier breakdown |
+| `cloak_pattern_list` | List patterns with scores and tier |
+| `cloak_pattern_prune` | Remove stale/low-scoring patterns |
+| `cloak_pattern_seed` | Seed store with built-in patterns |
+
+### CAPTCHA Tools
+
+| Tool | Function |
+|---|---|
+| `cloak_detect_captcha` | Detect CAPTCHA type and sitekey |
+| `cloak_solve_captcha` | Solve via vision AI (Claude/GPT-4o/2captcha) |
+
+### Compression & Cortex Tools
+
+| Tool | Function |
+|---|---|
+| `turbo_quant_compress` | PolarQuant vector compression (~75% smaller) |
+| `turbo_quant_stats` | Compression ratio and savings stats |
+| `cloak_cortex` | Scan project directory into MAGMA entity graph |
+| `cloak_cortex_anatomy` | Get cached file anatomy without rescanning |
+
+---
+
+## Claude Code Setup
 
 Add to `.claude/settings.json` in your project:
 
 ```json
 {
   "mcpServers": {
-    "cloak": {
+    "vektor": {
       "command": "node",
       "args": ["/path/to/node_modules/vektor-slipstream/index.js"],
       "env": {
@@ -98,70 +236,11 @@ Add to `.claude/settings.json` in your project:
         "CLOAK_PROJECT_PATH": "/path/to/your/project"
       }
     }
-  },
-  "hooks": {
-    "SessionStart": [{ "type": "command", "command": "node /path/to/node_modules/vektor-slipstream/index.js --hook SessionStart" }],
-    "Stop":         [{ "type": "command", "command": "node /path/to/node_modules/vektor-slipstream/index.js --hook Stop" }],
-    "PreToolUse":   [{ "type": "command", "command": "node /path/to/node_modules/vektor-slipstream/index.js --hook PreToolUse" }],
-    "PostToolUse":  [{ "type": "command", "command": "node /path/to/node_modules/vektor-slipstream/index.js --hook PostToolUse" }]
   }
 }
 ```
 
-### Usage
-
-```js
-// Scan project files into Vektor entity graph (call once on init)
-await cloak_cortex({})
-
-// Start session — loads last context automatically
-await cloak_axon({ action: 'start' })
-
-// Check before a risky write
-await cloak_cerebellum({
-  action: 'check',
-  content: '...code...',
-  filePath: 'src/auth.ts'
-})
-
-// Record a bug you just hit
-await cloak_cerebellum({
-  action: 'record_error',
-  description: 'Null ref on user.id when DB returns empty',
-  filePath: 'src/auth.ts',
-  errorType: 'null_reference',
-  fix: 'Add guard: if (user && user.id)'
-})
-
-// Save session with intent — the "why" not just the "what"
-await cloak_axon({
-  action: 'stop',
-  narrative: 'Fixed null reference in auth module'
-})
-
-// Check token waste
-await cloak_token({ action: 'summary' })
-```
-
-### Architecture
-
-```
-Claude Code
-    ↓ hooks + MCP tool calls
-CLOAK (4 tools, ~800 lines Node.js)
-    ↓ memory.remember() / memory.recall()
-Vektor / MAGMA
-    ↓ 4-layer graph (semantic, temporal, causal, entity)
-SQLite-vec (local, no cloud)
-```
-
-### DB growth
-
-CLOAK writes 3-5 nodes per session — not per operation.
-At 1 year of daily use: ~1,000 nodes. Sub-millisecond recall throughout.
-
-> ⚠️ **Concurrency warning**: Use stdio MCP (default). The HTTP mode
-> (`CLOAK_HTTP=1`) does not support concurrent multi-agent sessions.
+All 28 tools are available in Claude Code via this config.
 
 ---
 
@@ -177,37 +256,19 @@ At 1 year of daily use: ~1,000 nodes. Sub-millisecond recall throughout.
 
 ### Integrations
 
-- **Claude MCP** — `vektor_recall`, `vektor_store`, `vektor_graph`, `vektor_delta`
-- **Claude Code** — CLOAK 4-tool developer context layer (see above)
+- **Claude Desktop** — DXT extension, 28 tools, auto-memory system prompt
+- **Claude Code** — MCP server, all 28 tools
+- **CLI** — `chat`, `remember`, `ask`, `agent` commands
 - **LangChain** — v1 + v2 adapter included
 - **OpenAI Agents SDK** — drop-in integration
-- **Mistral** — `vektor_memoire` HTTP tool, localhost bridge
 - **Gemini · Groq · Ollama** — provider agnostic
 
-### Cloak (Sovereign Identity)
-
-- `cloak_fetch` — stealth headless browser fetch
-- `cloak_render` — computed CSS · post-JS DOM sensor
-- `cloak_passport` — AES-256-GCM credential vault, machine-bound
-- `cloak_diff` — semantic diff since last fetch
-- `tokens_saved` — ROI audit per session
-
-```js
-const { cloak_passport, cloak_fetch, tokens_saved } = require('vektor-slipstream/cloak');
-
-cloak_passport('GITHUB_TOKEN', 'ghp_xxxx');
-const token = cloak_passport('GITHUB_TOKEN');
-
-const { text, tokensSaved } = await cloak_fetch('https://example.com');
-
-const roi = tokens_saved({ raw_tokens: 10000, actual_tokens: 3000 });
-// → { reduction_pct: 70, cost_saved_usd: 0.0175, roi_multiple: 2.3 }
-```
+---
 
 ## Performance
 
 | Metric | Value |
-|--------|-------|
+|---|---|
 | Recall latency | ~8ms avg (local SQLite) |
 | Embedding cost | $0 — fully local ONNX |
 | Embedding latency | ~10ms GPU / ~25ms CPU |
@@ -222,15 +283,19 @@ Zero config. VEKTOR detects and uses the best available accelerator:
 - **Apple Silicon** — CoreML
 - **CPU** — optimised fallback, works everywhere
 
+---
+
 ## Licence
 
 Commercial licence. One-time payment of $159. Activates on up to 3 machines.
 Manage at [polar.sh](https://polar.sh).
 
-Purchase: [vektormemory.com/product#pricing](https://vektormemory.com/product#pricing)
-Docs: [vektormemory.com/docs](https://vektormemory.com/docs)
+Purchase: [vektormemory.com/product#pricing](https://vektormemory.com/product#pricing)  
+Docs: [vektormemory.com/docs](https://vektormemory.com/docs)  
 Support: hello@vektormemory.com
 
+---
+
 ## Research
 
 Built on peer-reviewed research:
@@ -238,4 +303,4 @@ Built on peer-reviewed research:
 - [MAGMA (arxiv:2601.03236)](https://arxiv.org/abs/2601.03236) — Multi-Graph Agentic Memory Architecture
 - [EverMemOS (arxiv:2601.02163)](https://arxiv.org/abs/2601.02163) — Self-Organizing Memory OS
 - [HippoRAG (arxiv:2405.14831)](https://arxiv.org/abs/2405.14831) — Neurobiologically Inspired Long-Term Memory (NeurIPS 2024)
-- [Mem0 (arxiv:2504.19413)](https://arxiv.org/abs/2504.19413) — Production-Ready Agent Memory
+- [Mem0 (arxiv:2504.19413)](https://arxiv.org/abs/2504.19413) — Production-Ready Agent Memory

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vektor-slipstream",
-  "version": "1.4.3",
+  "version": "1.4.5",
   "description": "Hardware-accelerated persistent memory for AI agents. Local-first, zero cloud dependency, $0 embedding cost.",
   "main": "slipstream-core-extended.js",
   "types": "./types/index.d.ts",
@@ -72,7 +72,7 @@
   "dependencies": {
     "better-sqlite3": "^12.8.0",
     "onnxruntime-node": "^1.17.3",
-    "vektor-slipstream": "^1.4.2"
+    "vektor-slipstream": "^1.4.5"
   },
   "optionalDependencies": {
     "@anthropic-ai/sdk": "^0.82.0",

package/CHANGELOG.md

@@ -1,139 +0,0 @@
-# VEKTOR v1.3.7 — Changelog
-
-Released: 2026-04-05
-
-## New features
-
-### memory.forget(id)
-Hard-deletes a memory and cascades to all graph edges. Throws if memory is pinned — must unpin first.
-```js
-await memory.forget('mem_abc123');
-// → { deleted: true, edgesRemoved: 4 }
-```
-
-### memory.forgetWhere(query, opts)
-Semantic bulk-delete. Preview with `dryRun: true` before committing.
-```js
-await memory.forgetWhere('Project Atlas', { dryRun: true });
-await memory.forgetWhere('Project Atlas', { minScore: 0.9, limit: 5 });
-```
-
-### memory.pin(id) / memory.unpin(id) / memory.listPinned()
-Mark memories as permanent — REM cycle will never compress or delete them.
-```js
-const { id } = await memory.remember('User is allergic to peanuts');
-await memory.pin(id);
-await memory.listPinned(); // → all pinned memories
-```
-
-### memory.inspect()
-Full diagnostic snapshot — no more raw SQLite queries to debug state.
-```js
-const state = memory.inspect();
-state.counts       // → { memories: 247, pinned: 3, edges: 7180 }
-state.rem          // → { totalDreams: 11, compressionRatio: '0.06' }
-state.graph.topNodes  // → 5 most-connected memories
-```
-
-### memory.auditLog(opts) / memory.auditStats()
-Full AUDN decision history. Nothing disappears silently.
-```js
-memory.auditLog({ action: 'DELETE', since: '7d' });
-// → [{ action, memory_id, content, reason, similarity, ran_at }]
-```
-
-### memory.briefing({ since }) — scoped date filtering
-```js
-await memory.briefing({ since: '7d' });
-await memory.briefing({ since: '12h', minImportance: 0.7 });
-await memory.briefing({ since: '2026-01-01', raw: true });
-```
-
-### memory.export() / memory.import()
-Full graph serialisation with checksum integrity.
-```js
-const bundle = memory.export();
-fs.writeFileSync('backup.vektor.json', JSON.stringify(bundle));
-
-memory.import(bundle);
-// → { imported: 244, skipped: 3, edgesAdded: 7100 }
-
-memory.import(bundle, { dryRun: true });    // preview
-memory.import(bundle, { mode: 'replace' }); // wipe and restore
-```
-
-### Namespace support
-Scope all reads/writes to prevent project bleed.
-```js
-const memory = await createMemory({ agentId: 'my-agent', namespace: 'project-atlas' });
-memory.listNamespaces();
-// → [{ namespace: 'project-atlas', memories: 18 }, ...]
-```
-
-### TypeScript types
-Full `.d.ts` declarations for all public API methods. No more flying blind in your IDE.
-Add to `tsconfig.json`: `"types": ["vektor-slipstream"]`
-
-### Structured error codes
-Replace string catch blocks with reliable `VektorError.code` switching.
-```js
-import { VektorError, ERR } from 'vektor-slipstream/errors';
-
-try {
-  await memory.remember(...)
-} catch (e) {
-  if (e instanceof VektorError) {
-    switch (e.code) {
-      case ERR.LICENCE_INVALID: // handle
-      case ERR.EMBED_FAILED:    // retry
-    }
-  }
-}
-```
-
-## Schema changes
-Run `npx vektor migrate` after updating, or migration runs automatically on startup.
-
-New columns:
-- `memories.pinned` INTEGER DEFAULT 0
-- `memories.namespace` TEXT DEFAULT 'default'
-- `memories.updated_at` INTEGER
-
-New tables:
-- `audn_log` — AUDN decision audit trail
-- `rem_log` — REM cycle run history (if not already present)
-- `vektor_meta` — schema version tracking
-
-## Bug fixes
-- REM cycle now skips pinned memories (previously could compress critical facts)
-- AUDN deletions now logged before execution (previously silent)
-- briefing() no longer returns stale summary when no memories exist in window
-
-## Breaking changes
-None. All new methods are additive. Existing code works unchanged.
-Migration is backward-compatible — new columns have safe defaults.
-
-## Gemini security review fixes (round 1 — applied)
-- `briefing.js` — pinned memory query now has LIMIT 50 (context bomb prevention)
-- `briefing.js` — `parseSince()` guards against `Date.now()` ms being passed as unix seconds
-- `forget.js` — `forgetWhere()` selective error catching — infra errors re-thrown, only expected skips swallowed
-- `namespace.js` — O(N) JS delete loop replaced with bulk SQL subquery (2 statements vs N*2)
-- `inspect.js` — all `SUM()` aggregations wrapped in `IFNULL(..., 0)` — no more `null` in charts
-- `migrate-137.js` — `PRAGMA table_info()` replaces brittle error-message string matching
-
-## Gemini security review fixes (round 2 — applied)
-- `export-import.js` — Fix 1: `IN (...memIds)` placeholders replaced with SQL subqueries — no more 32,766 param limit crash on large exports
-- `export-import.js` — Fix 2: O(N) loop in `replace` mode replaced with bulk subquery deletes
-- `export-import.js` — Fix 3: checksum now hashes full memories payload — content/importance tampering now detectable
-- `export-import.js` — Fix 4: dangling edge guard — edges only inserted if both source and target exist in destination (`WHERE EXISTS`)
-- `export-import.js` — `edgesSkipped` added to import return value with console.warn for partial imports
-
-## Gemini security review fixes (round 3 — applied)
-- `forget.js` — pinned edge orphan guard: blocks deleting a memory that shares
-  a graph edge with a pinned memory — prevents silent MAGMA traversal corruption
-- `namespace.js` — SQLITE_BUSY retry loop: 3 attempts × 100ms using
-  `Atomics.wait` (correct sync sleep for better-sqlite3) before propagating error
-- `export-import.js` — confirmed: empty bundle guard (line 103) already sits
-  before checksum computation (line 107) — correct order, no change needed
-
-## Total fixes across 3 Gemini review rounds: 13

package/LICENSE

@@ -1,33 +0,0 @@
-VEKTOR SLIPSTREAM — COMMERCIAL LICENCE
-
-Copyright (c) 2026 VEKTOR Memory (vektormemory.com)
-
-This software is licensed, not sold. Purchase of a Vektor Slipstream licence
-grants you a non-exclusive, non-transferable right to use this software in
-accordance with the following terms:
-
-PERMITTED:
-- Use in personal, commercial, and client projects
-- Embed in products you sell or SaaS platforms
-- Deploy on up to 3 machines per licence key
-- Modify for your own use (modifications are not redistributable)
-
-NOT PERMITTED:
-- Redistribute, resell, or sublicense this software
-- Remove or modify licence enforcement mechanisms
-- Share your licence key with others
-- Use in projects that compete directly with VEKTOR Memory
-
-LICENCE ENFORCEMENT:
-This software requires a valid licence key from vektormemory.com.
-Licence keys are validated via Polar (polar.sh) and cached locally.
-Each key activates on up to 3 machines.
-
-SOVEREIGNTY GUARANTEE:
-Core SDK functionality remains a one-time purchase permanently.
-No mandatory subscription will ever be required for the memory core,
-AUDN loop, REM cycle, or integration adapters included in this package.
-
-Purchase: https://vektormemory.com/product#pricing
-Support:  hello@vektormemory.com
-Docs:     https://vektormemory.com/docs