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:
Newer release available (1.0.40)

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.39.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.39-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: moot_memory-1.0.39.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.39.tar.gz
Algorithm Hash digest
SHA256 c027cf93b422680c610cf9b596286e82baf60d883f3bbfc82544dc148f6c3119
MD5 21ad61c9ada565fbd783627853a701c7
BLAKE2b-256 7abeb28a718abe11c3c646212614705e8780c8e11499299eacb9f32c529e8c32

See more details on using hashes here.

Provenance

The following attestation bundles were made for moot_memory-1.0.39.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.39-py3-none-any.whl.

File metadata

  • Download URL: moot_memory-1.0.39-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.39-py3-none-any.whl
Algorithm Hash digest
SHA256 dd160d14852a8e3b5a2a3b777af38c3550077397837e7a2bcd6c230564480264
MD5 2db4d83afe775ecbf5a7d64a7bf8e84b
BLAKE2b-256 4ed0640107c7773547464df3644bc24472696cae15da3a6cfa9d6cb3ae3c7a45

See more details on using hashes here.

Provenance

The following attestation bundles were made for moot_memory-1.0.39-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