mimic-memory 0.2.0a0

Domain-neutral memory substrate for Mimic workflows and local OS adapters

mimic-memory

Domain-neutral memory substrate for Mimic.

A Python-first memory layer for OS-wide and workflow-wide memory:

• composable modules callable from Temporal workflows;
• semantic, episodic, procedural, and artifact memory records;
• deterministic snapshot/export for world_state_hash;
• signed, replayable memory events;
• adapters for local OS sources, apps, and Mimic simulations.

Core code stays use-case neutral. Application-specific concepts (coach, wellness, plan, signal, etc.) belong only in downstream adapters or examples.

Python core

The package lives in mimic_memory/ and provides:

• MemoryRecord for semantic, episodic, procedural, and artifact memory;
• MemorySource for OS, workflow, app, agent, connector, or import origins;
• MemoryEvent for replayable upsert/delete/snapshot logs;
• MemorySnapshot for sorted canonical JSON and agent_memory_state hashing;
• InMemoryStore for tests, local adapters, and workflow prototypes;
• LocalEventLogStore for append-only signed JSONL replay logs on local disk;
• OS adapters: file_record, iter_file_records, clipboard_record, sqlite_records, calendar_event_record, screenshot_record.

Run the focused package tests with:

pytest packages/mimic-memory/tests -q

Use MemorySnapshot.world_state_component() as the value for Mimic framework's world_state_hash(agent_memory_state=...) input. This keeps snapshot timestamps and other manifest-only fields out of the deterministic component hash.