vektor-slipstream 1.4.2 → 1.4.4

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.2",
+  "version": "1.4.4",
   "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.1"
+    "vektor-slipstream": "^1.4.4"
   },
   "optionalDependencies": {
     "@anthropic-ai/sdk": "^0.82.0",