forgetted v0.2.2

Selective memory windows for Python agents

forgetted lets you run a bounded part of an agent workflow without persisting selected agent-controlled state. Wrap the work in a ForgetSession: existing workspace state remains readable, while supported writes inside the window are intercepted or cleaned up according to the configured adapters.

This is useful when testing an agent without polluting its usual memory, discussing material that should not become future agent context, or trying an approach you do not want retained as a session log or deliverable.

What changed

• Publishing is now bound to the GitHub Release tag: the workflow checks out that tag and verifies that it matches the package version before uploading.
• CI and the release workflow now build the distribution, run twine check, install the wheel in a clean environment, and verify the installed package version.
• Mem0Adapter cleanup now recognizes timezone-aware ISO timestamps as well as epoch timestamps when identifying memories created during the window.
• The quick-start wording now clearly scopes default protection to protected workspace writes and points users to adapters for vector stores and other persistence layers.
• Package metadata for 0.2.2 points to the canonical hermes-labs-ai/forgetted repository.

Install

pip install forgetted

from forgetted import ForgetSession

with ForgetSession("/path/to/workspace"):
    agent.chat("Try this without retaining supported workspace writes.")

By default, forgetted intercepts builtins.open writes to memory/, DELIVERABLES.md, and *.jsonl files inside the declared workspace. To govern a supported semantic-memory store, register its adapter—for example, Mem0Adapter.

Compatibility and limits

• Requires Python 3.9 or later.
• Reads remain available by design.
• This release does not broaden the protection boundary: writes outside the workspace, Path.write_text, os.open, subprocesses, C-extension writes, network/API calls, provider logs, and OS-level forensics are not covered.
• It is a developer convenience layer for configured agent persistence, not a security boundary or a general deletion/privacy guarantee.
• Concurrent or nested forgetted sessions on the same workspace are unsupported.

See the README, limitations, and changelog.

Full Changelog: v0.2.1...v0.2.2

v0.2.1

This release carries the scholarly metadata (.zenodo.json, CITATION.cff), an entity-definition README, and consistent Hermes Labs identity, archived with a citable DOI.

v0.2.0

What's New

• Mem0Adapter — blocks vector DB writes during incognito sessions
• ForgetSession context manager with checkpoint/restore lifecycle
• Adapter registry for custom persistence layers
• 97 tests covering all adapters and edge cases

Install

pip install forgetted==0.2.0

Full changelog: https://github.com/roli-lpci/forgetted/blob/main/CHANGELOG.md