strawpot-memory

Interface definition for StrawPot memory providers.

This package defines the MemoryProvider protocol and associated types that any memory backend must implement to integrate with the StrawPot agent orchestration system.

Install

pip install strawpot-memory

Usage

Implement the MemoryProvider protocol to create a custom memory backend:

from strawpot_memory.memory_protocol import (
    MemoryProvider,
    GetResult,
    DumpReceipt,
    RememberResult,
    RecallResult,
)


class MyMemoryProvider:
    name = "my-provider"

    def get(self, *, session_id, agent_id, role, behavior_ref, task,
            budget=None, parent_agent_id=None, group_id=None) -> GetResult:
        ...

    def dump(self, *, session_id, agent_id, role, behavior_ref, task, status, output,
             tool_trace="", parent_agent_id=None, artifacts=None, group_id=None) -> DumpReceipt:
        ...

    def remember(self, *, session_id, agent_id, role, content,
                 keywords=None, scope="project", group_id=None) -> RememberResult:
        ...

    def recall(self, *, session_id, agent_id, role, query,
               keywords=None, scope="", max_results=10, group_id=None) -> RecallResult:
        ...


assert isinstance(MyMemoryProvider(), MemoryProvider)  # runtime check

Protocol Methods

Types

• MemoryKind — enum of memory types (PM, SM, STM, RM, EM)
• ContextCard — single unit of context returned by get
• ControlSignal — advisory signals (risk level, suggested next step, policy flags)
• GetResult — full output of a get call
• DumpReceipt — receipt returned by dump
• RememberResult — result returned by remember
• RecallEntry — single entry returned by recall
• RecallResult — result returned by recall

License

MIT