Yeah fair feedback. Would love to discuss the interface in this issue and would even welcome a contribution once we are happy with it!

Cool! I went ahead and submitted #752 after some experimentation. I'm more than happy to workshop the API -- I just found coding and documentation to be the best way to shape my thinking.

Usage

from agents import Agent, Runner, Session, SQLiteSession

agent = Agent(name="Assistant", instructions="Reply concisely.")
session: Session = SQLiteSession("convo_123")

messages = [
    "Hi, I'm planning a trip to Japan",
    "What's the best time to visit?",
    "How about cherry blossom season?"
]

for message in messages:
    response = Runner.run_sync(agent, message, session=session)
    print(response.final_output)

Session Interface

The basic idea is to have an interface (typing.Protocol) that describes how to manage conversation history for a given session. A Session instance would be passed to one of the Runner methods to handle conversation history for the session. I included a SQLiteSession implementation since that won't introduce any new dependencies.

class CustomSession:
    session_id: str

    async def get_items(self, limit: int | None = None) -> List[dict]:
        ...
    async def add_items(self, items: List[dict]) -> None:
        ...
    async def pop_item(self) -> dict | None:
        ...
    async def clear_session(self) -> None:
        ...

Are there any plans to include different implementations, like postgres? @rm-openai are you open to including a postgres implementation in the library?

@artificial-aidan yeah would welcome a PR!

Ok, I've got something working locally. I'll work on putting together a PR