@deeplake/hivemind 0.7.49 → 0.7.51

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/.claude-plugin/marketplace.json +3 -3
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/README.md +68 -40
  4. package/bundle/cli.js +9743 -21944
  5. package/codex/bundle/capture.js +3 -74
  6. package/codex/bundle/commands/auth-login.js +3 -74
  7. package/codex/bundle/graph-pull-worker.js +3 -74
  8. package/codex/bundle/pre-tool-use.js +3 -74
  9. package/codex/bundle/session-start-setup.js +3 -74
  10. package/codex/bundle/session-start.js +3 -74
  11. package/codex/bundle/shell/deeplake-shell.js +3 -74
  12. package/codex/bundle/skillify-worker.js +0 -28
  13. package/codex/bundle/stop.js +3 -74
  14. package/codex/skills/hivemind-goals/SKILL.md +2 -2
  15. package/cursor/bundle/capture.js +3 -74
  16. package/cursor/bundle/commands/auth-login.js +3 -74
  17. package/cursor/bundle/graph-pull-worker.js +3 -74
  18. package/cursor/bundle/pre-tool-use.js +3 -74
  19. package/cursor/bundle/session-end.js +3 -6
  20. package/cursor/bundle/session-start.js +68 -338
  21. package/cursor/bundle/shell/deeplake-shell.js +3 -74
  22. package/cursor/bundle/skillify-worker.js +0 -28
  23. package/hermes/bundle/capture.js +3 -74
  24. package/hermes/bundle/commands/auth-login.js +3 -74
  25. package/hermes/bundle/graph-pull-worker.js +3 -74
  26. package/hermes/bundle/pre-tool-use.js +3 -74
  27. package/hermes/bundle/session-end.js +3 -6
  28. package/hermes/bundle/session-start.js +68 -338
  29. package/hermes/bundle/shell/deeplake-shell.js +3 -74
  30. package/hermes/bundle/skillify-worker.js +0 -28
  31. package/mcp/bundle/server.js +3 -74
  32. package/openclaw/dist/chunks/{config-FH6JYSJW.js → config-3D3X7JQH.js} +3 -6
  33. package/openclaw/dist/index.js +2 -68
  34. package/openclaw/dist/skillify-worker.js +0 -28
  35. package/openclaw/openclaw.plugin.json +1 -1
  36. package/openclaw/package.json +1 -1
  37. package/openclaw/skills/hivemind-goals/SKILL.md +1 -1
  38. package/package.json +1 -1
@@ -6,18 +6,18 @@
6
6
  },
7
7
  "metadata": {
8
8
  "description": "Cloud-backed persistent shared memory for AI agents powered by Deeplake",
9
- "version": "0.7.49"
9
+ "version": "0.7.51"
10
10
  },
11
11
  "plugins": [
12
12
  {
13
13
  "name": "hivemind",
14
14
  "description": "Persistent shared memory powered by Deeplake — captures all session activity and provides cross-session, cross-agent memory search",
15
- "version": "0.7.49",
15
+ "version": "0.7.51",
16
16
  "source": {
17
17
  "source": "git-subdir",
18
18
  "url": "https://github.com/activeloopai/hivemind.git",
19
19
  "path": "claude-code",
20
- "sha": "032c528d737ea200593cc7a16785e1954f9c66b2"
20
+ "sha": "c0c861150a00e85bc4fd21120ae2a331417468d0"
21
21
  },
22
22
  "homepage": "https://github.com/activeloopai/hivemind"
23
23
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "hivemind",
3
3
  "description": "Cloud-backed persistent memory powered by Deeplake — read, write, and share memory across Claude Code sessions and agents",
4
- "version": "0.7.49",
4
+ "version": "0.7.51",
5
5
  "author": {
6
6
  "name": "Activeloop",
7
7
  "url": "https://deeplake.ai"
package/README.md CHANGED
@@ -16,6 +16,7 @@
16
16
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License"></a>
17
17
  <a href="package.json"><img src="https://img.shields.io/badge/node-%3E%3D22.0.0-brightgreen.svg" alt="Node"></a>
18
18
  <a href="https://deeplake.ai"><img src="https://img.shields.io/badge/Powered%20by-Deeplake-orange.svg" alt="Deeplake"></a>
19
+ <a href="https://www.ycombinator.com"><img src="https://img.shields.io/badge/Y%20Combinator-backed-ff6600.svg" alt="Y Combinator backed"></a>
19
20
  </p>
20
21
 
21
22
  <p align="center">
@@ -26,14 +27,35 @@
26
27
  >
27
28
  > Tuesday, every agent on the team can execute the pattern.
28
29
 
29
- **Beyond memory.** Hivemind captures every coding-agent interaction in your org as a structured trace, codifies repeated patterns into reusable skills, and propagates those skills to every agent on your team.
30
+ On [LoCoMo](https://arxiv.org/abs/2402.17753), the public long-context memory benchmark, Hivemind is **25% cheaper, 1.7× fewer tokens, and 31% fewer turns** than running without shared memory. ([See the numbers below.](#benchmarks))
31
+
32
+ **Beyond memory.** Hivemind doesn't just remember — it mines your team's traces for repeated patterns and codifies them into reusable skills that propagate back into every agent on the team. The agent your junior engineer used this morning is sharper because of what your senior engineer's agent figured out last week.
30
33
 
31
34
  - 📥 **Captures** every session's prompts, tool calls, and responses as structured traces in Deeplake
32
- - 🧠 **Codifies** patterns in those traces into reusable skills, available to every agent on your team
33
- - 🔍 **Searches** across all traces and skills with lexical retrieval (grep fallback when index unavailable)
35
+ - 🧠 **Codifies** patterns into reusable `SKILL.md` files, available to every agent on your team
36
+ - 🔍 **Searches** traces and skills with hybrid lexical + semantic retrieval (BM25 fallback when embeddings off)
34
37
  - 🔗 **Propagates** capability across sessions, agents, teammates, and machines in real time
35
38
  - 📁 **Intercepts** file operations on `~/.deeplake/memory/` through a virtual filesystem backed by SQL
36
39
  - 📝 **Summarizes** sessions into AI-generated wiki pages via a background worker at session end
40
+ - ☁️ **BYOC**: keep data in your own GCS, Azure, S3, or on-prem bucket — [see Security & storage](#security--storage)
41
+
42
+ ## Benchmarks
43
+
44
+ On the [LoCoMo](https://arxiv.org/abs/2402.17753) long-context memory benchmark (100 QA pairs, Claude Haiku via `claude -p`, hybrid lexical + semantic retrieval), Hivemind cuts cost, tokens, and turns versus a no-memory baseline:
45
+
46
+ | Metric | Baseline | Hivemind | Improvement |
47
+ |-------------------|----------|----------|------------------|
48
+ | Cost / 100 QA | $8.94 | $6.65 | **25% cheaper** |
49
+ | Tokens / question | 1,700 | 1,008 | **1.7× fewer** |
50
+ | Turns / question | 8.9 | 6.2 | **31% fewer** |
51
+
52
+ The agent reaches the answer in fewer turns with less context, because the prior work is already in scope at recall time — not re-derived per session.
53
+
54
+ <p align="center">
55
+ <a href="https://star-history.com/#activeloopai/hivemind&Date">
56
+ <img src="https://api.star-history.com/svg?repos=activeloopai/hivemind&type=Date" alt="Star History Chart" width="600">
57
+ </a>
58
+ </p>
37
59
 
38
60
  ## Quick start
39
61
 
@@ -285,26 +307,16 @@ hivemind skillify unpull # remove pulled skills
285
307
 
286
308
  Triggers, generation flow, full `pull` / `unpull` semantics, gate-CLI table per agent, env vars, logs: **[docs/SKILLIFY.md](docs/SKILLIFY.md)**.
287
309
 
288
- ## Rules + tasks (cross-agent KPIs)
310
+ ## Rules (cross-agent team principles)
289
311
 
290
- Hivemind **shares team rules and tasks across every agent in the org**, injected at SessionStart so every claude-code / cursor / hermes session starts knowing them. Tasks come with LLM-generated KPIs; the agent records progress via a CLI; `tasks report` shows current/target.
312
+ Hivemind **shares team rules across every agent in the org**, injected at SessionStart so every claude-code / cursor / hermes session starts knowing them. For personal or team work items with progress tracking, use [Goals + KPIs](#goals--kpis) (VFS-backed) instead.
291
313
 
292
314
  ```bash
293
- # Rules — team-wide principles ("never DROP TABLE on prod")
294
315
  hivemind rules add "no DROP TABLE on prod creds"
295
316
  hivemind rules list # latest 10 active
296
317
  hivemind rules edit <rule-id> "<new text>" # bumps version
297
318
  hivemind rules done <rule-id> # mark closed
298
319
 
299
- # Tasks — personal or team work items, with agent-generated KPIs
300
- hivemind tasks add "ship the search bar" [--scope me|team] [--assign <user>]
301
- hivemind tasks list [--mine|--team|--all] [--status active|done|all]
302
- hivemind tasks edit <task-id> "<new text>"
303
- hivemind tasks done <task-id>
304
- hivemind tasks assign <task-id> <user>
305
- hivemind tasks progress <task-id> <kpi-id> --value N [--note "..."]
306
- hivemind tasks report [<task-id>] # SUM events per KPI
307
-
308
320
  # Cross-agent diagnostic / pi/openclaw fallback
309
321
  hivemind context # print the injection block on demand
310
322
  ```
@@ -318,36 +330,28 @@ fall back to `hivemind context`):
318
330
  - <rule_id>: <text>
319
331
  (X more — run 'hivemind rules list' to see all)
320
332
 
321
- === HIVEMIND TASKS (N active) ===
322
- [team] <task_id>: <text> ★YOU | PRs merged: 3/5 count
323
- [me] <task_id>: <text> | Lines reviewed: 75/200 lines
324
- (X more — run 'hivemind tasks list' to see all)
325
-
326
333
  === HIVEMIND HOW-TO ===
327
334
  - Rules above are team principles. Treat any action that would violate one as a critical error and surface it to the user before proceeding.
328
- - Tasks above are your current work. Use 'hivemind tasks progress <task-id> <kpi-id> --value N' to record progress on a KPI.
329
- - Run 'hivemind rules list' / 'hivemind tasks list' for the full inventories beyond what's shown here.
335
+ - Run 'hivemind rules list' for the full inventory beyond what's shown here.
330
336
  ```
331
337
 
332
- **Auto-extract** — `gh pr merge` from inside an agent's Bash tool
333
- appends an event to `hivemind_task_events` automatically (failed
334
- merges, `--auto` enablement, interrupted commands all skipped). The
335
- event is "orphan" in v1 (no task binding yet); v1.1 ships
336
- `hivemind events attribute` for retroactive binding.
337
-
338
- **KPI generation** — `hivemind tasks add` calls Claude Sonnet to
339
- produce 1-3 KPIs from the task text. Failure modes (no API key,
340
- timeout, parse error) degrade to empty kpis; the task still INSERTs
341
- and the user can record progress manually.
342
-
343
338
  **Env vars:**
344
- - `HIVEMIND_RULES_TABLE`, `HIVEMIND_TASKS_TABLE`, `HIVEMIND_TASK_EVENTS_TABLE` — table names (default `hivemind_rules` / `hivemind_tasks` / `hivemind_task_events`).
345
- - `HIVEMIND_KPI_MODEL` — model id for KPI generation (default `claude-sonnet-4-6`).
346
- - `HIVEMIND_KPI_LLM=disable` — opt out of LLM KPI gen.
347
- - `ANTHROPIC_API_KEY` — required for KPI gen; absence is a silent no-op (kpis = `[]`).
339
+ - `HIVEMIND_RULES_TABLE` — table name (default `hivemind_rules`).
348
340
  - `HIVEMIND_CAPTURE=false` — full read-only mode. Skips placeholder + ensure DDL; renderer still injects.
349
341
 
350
- Full data model, identity contract, per-agent injection status, auto-extract pipeline, KPI LLM details, and known v1 limitations: **[docs/RULES_TASKS_KPIS.md](docs/RULES_TASKS_KPIS.md)**.
342
+ ## Goals + KPIs
343
+
344
+ Personal / team objectives + measurable targets live in the Deeplake virtual filesystem under `~/.deeplake/memory/goal/<owner>/<status>/<uuid>.md` and `~/.deeplake/memory/kpi/<goal_id>/<kpi-slug>.md`. Path encodes structure (owner, status, goal_id); the file body holds the human-readable description.
345
+
346
+ ```bash
347
+ # CLI fallback for runtimes that can't route VFS writes (cursor/hermes/pi)
348
+ hivemind goal add "ship the search bar"
349
+ hivemind goal list [--all|--mine]
350
+ hivemind goal done <goal_id>
351
+ hivemind goal progress <goal_id> opened|in_progress|closed
352
+ ```
353
+
354
+ For VFS-capable runtimes (claude-code/codex) the `hivemind-goals` skill creates and edits goals/KPIs directly via Bash heredoc against the VFS path — `mv` between `opened/`, `in_progress/`, and `closed/` is the canonical status transition. KPIs are manual files; the body format is documented in the skill (`target:`, `current:`, `unit:`).
351
355
 
352
356
  ## Architecture
353
357
 
@@ -360,13 +364,37 @@ Per-agent integration mechanisms (marketplace plugin, hooks, skills, native exte
360
364
  - **Skill versioning and review.** Pre-release human review for codified skills before they propagate org-wide, for teams that want a curation step.
361
365
  - **More agents.** If your team uses an agent that isn't on the supported-assistants list above, open an issue.
362
366
 
363
- ## Security
367
+ ## Security & storage
368
+
369
+ ### Tenant isolation & encryption
370
+
371
+ - TLS between every agent and Deep Lake. AES-256 on the bytes once they land. Your cloud credentials live in Deep Lake's vault — Hivemind never sees the raw keys.
372
+ - Org and workspace boundaries enforced at the storage layer, not just the API. Sessions never share a row, a partition, or an index with another workspace.
373
+ - Disable capture per session with `HIVEMIND_CAPTURE=false`. Delete a workspace and the underlying objects go with it.
374
+
375
+ ### Code-level controls
364
376
 
365
377
  - SQL values escaped with `sqlStr()`, `sqlLike()`, `sqlIdent()`
366
378
  - ~70 allowlisted builtins run in the virtual FS; unrecognized commands are denied
367
379
  - Credentials stored with mode `0600`, config dir with mode `0700`
368
380
  - Device flow login: no tokens in environment or code
369
- - `HIVEMIND_CAPTURE=false` fully disables data collection
381
+
382
+ ### Bring your own cloud (BYOC)
383
+
384
+ Hivemind Cloud is the default. When that isn't enough, point Hivemind at storage in your own cloud — we handle the orchestration, data never leaves your perimeter.
385
+
386
+ | Provider | Status | Setup |
387
+ |----------------------------|------------|--------------------------------------------------------|
388
+ | Google Cloud Storage | Available | [docs](https://docs.deeplake.ai/latest/guide/gcs/) |
389
+ | Azure Blob Storage | Available | [docs](https://docs.deeplake.ai/latest/guide/azure/) |
390
+ | Amazon S3 | Available | [contact us](https://deeplake.ai/hivemind#security) |
391
+ | S3-compatible on-prem | On request | [contact us](https://deeplake.ai/hivemind#security) |
392
+
393
+ ## Who builds Hivemind
394
+
395
+ Hivemind is built and maintained by [Activeloop](https://activeloop.ai) — the open-source team behind [Deeplake](https://github.com/activeloopai/deeplake), backed by Y Combinator.
396
+
397
+ We run Hivemind ourselves, all day, across Claude Code, OpenClaw, Codex, and Cursor. Every benchmark number above came from our own internal eval against the LoCoMo public benchmark. If you're running coding agents at a team or org and want to talk through your setup, drop us a line: [hello@activeloop.ai](mailto:hello@activeloop.ai).
370
398
 
371
399
  ## Development
372
400