MOOTx01 Memory Adapter

Drop-in /memories backend with governance for the Anthropic memory_20250818 tool.

What it does

Any Claude 4+ / Fable 5 agent that thinks it is reading and writing /memories files is actually reading and writing governed MOOTx01 drawers — with dedup, provenance, sensitivity floor, confirmation state, and a full audit trail included.

The differentiator

Every model-written memory lands as unconfirmed with derived trust. A startup scan or audit pass can quarantine suspect lessons using the estate's contained filter and anomaly lenses. This is the poisoning defense the ecosystem currently lacks — the memory tool contract gives models write access; MOOTx01 gives you the governance to trust (or not trust) what they wrote.

Two surfaces

1. MCP tool (built into mootx01)

The mootx01 daemon registers a memory tool on its MCP surface that matches Anthropic's contract exactly. Claude Code and Claude Desktop users already connected to mootx01 as an MCP server get the memory tool for free — no adapter needed.

2. Python SDK handler (this package)

For Messages API users who run the tool-use loop themselves:

from moot_memory import MootMemoryTool
import anthropic

client = anthropic.Anthropic()
memory = MootMemoryTool(base_url="http://127.0.0.1:4242")

runner = client.beta.messages.tool_runner(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Remember that Acme prefers email."}],
    tools=[memory],
)
final = runner.until_done()

Or standalone without the SDK:

from moot_memory import MootMemoryHandler

handler = MootMemoryHandler(base_url="http://127.0.0.1:4242")
result = handler.execute({"command": "view", "path": "/memories"})

Op mapping

memory_20250818 Estate behavior
view (dir) enumerate drawers in wing="memories"
view (file) drawer content with line numbers
create capture as unconfirmed drawer
str_replace supersede: new content, old withdrawn (full lineage)
insert supersede: content with insertion applied
delete soft withdrawal (never hard-erase from model ops)
rename capture at new location, withdraw old

Security

  • Path traversal protection: all paths validated against /memories
  • Model writes land unconfirmed: poisoning quarantine seam
  • Deletes are soft withdrawals: reversible, audit trail preserved
  • Sensitivity floor: adapter wing is Normal
  • File size cap: 100KB per file
  • No hidden files: dotfiles rejected

Tests

# Against the running daemon
python -m pytest apps/moot-memory-adapter/tests/

# The poisoning quarantine test
python -m pytest apps/moot-memory-adapter/tests/test_memory_adapter.py::TestPoisoningQuarantine -v

Requirements

  • Running mootx01 daemon (v1.0.22+)
  • Python 3.10+
  • anthropic SDK (optional, for the BetaAbstractMemoryTool subclass)

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for bob-codedaptive from gravatar.com bob-codedaptive

Credits

Author: Codedaptive

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.10

Provides Extra

anthropic

Tags

anthropic claude memory mcp mootx01 ai-memory

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

moot_memory-1.0.40.tar.gz (7.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

moot_memory-1.0.40-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

Details for the file moot_memory-1.0.40.tar.gz.

File metadata

  • Download URL: moot_memory-1.0.40.tar.gz
  • Upload date:
  • Size: 7.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for moot_memory-1.0.40.tar.gz
Algorithm Hash digest
SHA256 e6eca0c83b429f3b9e8e07cd72397378367c24f01fa2f773fd2f11fada89ca5f
MD5 4a673c0382c01ac07271aaa6b50f655d
BLAKE2b-256 f4cef1ed215921ee76f4352c244b90a38d1131318d48a2d6252acadc9703d278

See more details on using hashes here.

Provenance

The following attestation bundles were made for moot_memory-1.0.40.tar.gz:

Publisher: release.yml on codedaptive/mootx01-ce

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file moot_memory-1.0.40-py3-none-any.whl.

File metadata

  • Download URL: moot_memory-1.0.40-py3-none-any.whl
  • Upload date:
  • Size: 5.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for moot_memory-1.0.40-py3-none-any.whl
Algorithm Hash digest
SHA256 37bd041bde07809af5c7b02b33c78ca76f2bc049ef528015510701e1fb25de7b
MD5 c73f9a2ba2ee0bde94805352e235303f
BLAKE2b-256 ac8d30a8e6a9c331d766db80bab8abce94d5d6b3eecd99d02e877b609357a65a

See more details on using hashes here.

Provenance

The following attestation bundles were made for moot_memory-1.0.40-py3-none-any.whl:

Publisher: release.yml on codedaptive/mootx01-ce

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page