{"_id":"@adhd/sox-extension-sox-memory-bundle","_rev":"2-c012d468f112e46e4151be172cdcd89a","name":"@adhd/sox-extension-sox-memory-bundle","dist-tags":{"latest":"0.2.1"},"versions":{"0.2.0":{"name":"@adhd/sox-extension-sox-memory-bundle","version":"0.2.0","license":"MIT","_id":"@adhd/sox-extension-sox-memory-bundle@0.2.0","maintainers":[{"name":"pseudosky","email":"skywinston.sk@gmail.com"}],"dist":{"shasum":"6836a198c55b111a64accd6755439a6a676c8d18","tarball":"https://registry.npmjs.org/@adhd/sox-extension-sox-memory-bundle/-/sox-extension-sox-memory-bundle-0.2.0.tgz","fileCount":3,"integrity":"sha512-2vkTphLjJsFZ7ONA48437aE3rSjAwXqLJkl8+vECRunDK2Wu4vRyHxXz6/KNh+Lkz84N/da6SyGSgAtf0d8RVg==","signatures":[{"sig":"MEUCIQCl2Fz3Zst34hi2ThIP3JEvYul8LGJx5NfFzOjOXLuIHAIgAytoOYupLtPmKg6wl1U7mxoDOySFWS7p5i0lkFH0Mjk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4078},"_from":"file:adhd-sox-extension-sox-memory-bundle-0.2.0.tgz","engines":{"node":">=20"},"_npmUser":{"name":"pseudosky","email":"skywinston.sk@gmail.com"},"_resolved":"/private/var/folders/yg/cfczgtx54bzfh74lx2_mv0z80000gp/T/36cb1cfdf3c7d13342ae265cf5b8e9ea/adhd-sox-extension-sox-memory-bundle-0.2.0.tgz","_integrity":"sha512-2vkTphLjJsFZ7ONA48437aE3rSjAwXqLJkl8+vECRunDK2Wu4vRyHxXz6/KNh+Lkz84N/da6SyGSgAtf0d8RVg==","_npmVersion":"11.6.2","description":"SOX Memory Bundle — atomic install of the full SOX memory subsystem","directories":{},"_nodeVersion":"24.11.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sox-extension-sox-memory-bundle_0.2.0_1782451181904_0.8363498470817783","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"_id":"@adhd/sox-extension-sox-memory-bundle@0.2.1","bugs":{"url":"https://github.com/PseudoSky/adhd/issues"},"dist":{"shasum":"a64608d5057d2a3c7e5c5f61555dd6150184c271","tarball":"https://registry.npmjs.org/@adhd/sox-extension-sox-memory-bundle/-/sox-extension-sox-memory-bundle-0.2.1.tgz","fileCount":4,"integrity":"sha512-BIwM5Gg/e5/KbVgadm9JK/w9lHt4dz+a197PU4BKS93j2jiqfhItq3ejU5T2NJVE+GghQWwxWVK5LDEeI0qvQA==","signatures":[{"sig":"MEUCIQCJ9nI5DlKIEZ+FrhnSSU/7L1DT0gKEDzFCkN0iLMEOmAIgKfqFtVNfB9AnBINmepihp0Rr4lAZYeBn6GaYfcZ6mBg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCf2ZwE11M/6hC40GbsqkHO8xeWnwNanyhPB4O52k8FjQIhAJYSKGAMPe1C4sav9FNfyPh7O8lSvdbBnVy1tSNoQQ7+"}],"unpackedSize":6287},"name":"@adhd/sox-extension-sox-memory-bundle","_from":"file:adhd-sox-extension-sox-memory-bundle-0.2.1.tgz","engines":{"node":">=20"},"license":"MIT","version":"0.2.1","_npmUser":{"name":"pseudosky","email":"skywinston.sk@gmail.com"},"homepage":"https://github.com/PseudoSky/adhd","keywords":["memory","bundle","mcp","install","typescript"],"_resolved":"/private/var/folders/yg/cfczgtx54bzfh74lx2_mv0z80000gp/T/03545b89e72f831422a3d136121f5662/adhd-sox-extension-sox-memory-bundle-0.2.1.tgz","_integrity":"sha512-BIwM5Gg/e5/KbVgadm9JK/w9lHt4dz+a197PU4BKS93j2jiqfhItq3ejU5T2NJVE+GghQWwxWVK5LDEeI0qvQA==","repository":{"url":"git+https://github.com/PseudoSky/adhd.git","type":"git"},"_npmVersion":"11.6.2","description":"SOX Memory Bundle — atomic install of the full SOX memory subsystem","directories":{},"maintainers":[{"name":"pseudosky","email":"skywinston.sk@gmail.com"}],"_nodeVersion":"24.11.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sox-extension-sox-memory-bundle_0.2.1_1788566535663_0.7750591595866354"}}},"time":{"created":"2026-06-26T05:19:41.765Z","modified":"2026-09-05T00:02:15.973Z","0.2.0":"2026-06-26T05:19:42.031Z","0.2.1":"2026-09-05T00:02:15.746Z"},"license":"MIT","description":"SOX Memory Bundle — atomic install of the full SOX memory subsystem","maintainers":[{"name":"pseudosky","email":"skywinston.sk@gmail.com"}],"readme":"# sox-memory (graph memory subsystem)\n\n> Install this when you want the full sox-memory graph-memory subsystem in one command.\n\n## Overview\n\n`sox-memory-bundle` is a meta-package that expands to four coordinated extensions at install time. Installing the bundle is exactly equivalent to installing all four members individually at their pinned versions, but lets you treat the subsystem as a single installable unit with its own version.\n\n```bash\nsoxe install sox-memory-bundle\n```\n\nThe four members together form a complete agent memory subsystem built entirely on ecosystem primitives: a durable graph store (Turso by default, `better-sqlite3` as a fallback), hybrid semantic recall under 50 ms, deterministic batch enrichment (clustering, importance, auto-links via `@adhd/sox-memory-core`), session persistence on conversation end, and administration commands for store lifecycle.\n\nThere is no separate daemon process. An earlier version of this subsystem ran a supervised Unix-socket writer daemon; batch enrichment now runs in-process inside `memory-server` on a periodic loop instead — nothing separate to install, enable, or supervise. The store's own multi-process story is unrelated to that daemon removal: with the default Turso backend, `memory-server` opens the store in `multiprocess_wal` mode, so multiple OS processes (several agents, several CLI invocations, several `memory-server` instances) can hold concurrent write connections to the same store file, serialized through a coordinator sidecar rather than through any in-process queue. The `better-sqlite3` fallback (`STORE_ADAPTER=sqlite`) remains single-writer.\n\n## When to use\n\n- Install this bundle when you want persistent, searchable agent memory and do not need to pick and choose individual components.\n- Install individual members instead if you only need a subset (e.g. `memory-cli` alone for store administration).\n\n## Members\n\n| Extension id    | Type        | Role                                                                        |\n| --------------- | ----------- | --------------------------------------------------------------------------- |\n| `memory-server` | mcp-server  | 20 MCP tools over the graph store; hybrid recall; session state; in-process batch enrichment (clustering, importance, auto-links, stale-vector healing) |\n| `memory-flush`  | hook        | `SessionEnd` persistence + episode enqueue; `ScopePromotionProposed` approval |\n| `memory-cli`    | command     | Store lifecycle: init, status, list, registry, export, reembed, backup, compact, pipeline |\n| `memory-usage`  | skill       | How-to guidance for recalling and writing via the `memory_*` tools           |\n\n## Architecture summary\n\n```\nmemory-server (mcp-server, stdio/http/sse)\n  ├─ reads/writes one store file per scope (Turso default + multiprocess_wal, or SQLite fallback)\n  ├─ exposes 20 memory_* MCP tools; write-time enrichment runs synchronously\n  └─ runs periodic in-process batch enrichment\n       └─ clustering, importance, auto-links, stale-vector healing (deterministic, zero LLM)\n\nmemory-flush (hook: SessionEnd, ScopePromotionProposed)\n  └─ persists working memory + enqueues episodes → same store; optional markdown auto-export\n\nmemory-cli (command)\n  └─ init | status | list | registry | export | reembed | backup | compact | pipeline (deterministic, no LLM)\n```\n\n## Usage\n\n```bash\nsoxe install sox-memory-bundle\n```\n\nAfter installation, create a scope store via `memory-cli`'s `init` subcommand (see that package's README for exact invocation — as a host-installed `command` extension it's driven by the host/agent, not a standalone shell binary). Then configure your agent to call `memory_write` and `memory_recall` against the installed `memory-server` MCP server.\n\n## License\n\nMIT\n","readmeFilename":"README.md","homepage":"https://github.com/PseudoSky/adhd","keywords":["memory","bundle","mcp","install","typescript"],"repository":{"url":"git+https://github.com/PseudoSky/adhd.git","type":"git"},"bugs":{"url":"https://github.com/PseudoSky/adhd/issues"}}