Skip to content

docs: add inspeximus to community session implementations#3906

Draft
DanceNitra wants to merge 1 commit into
openai:mainfrom
DanceNitra:inspeximus-session
Draft

docs: add inspeximus to community session implementations#3906
DanceNitra wants to merge 1 commit into
openai:mainfrom
DanceNitra:inspeximus-session

Conversation

@DanceNitra

Copy link
Copy Markdown

Adds one row to the community session implementations table, per the standing invitation at the end of that section.

inspeximus (MIT, zero-dependency core) implements the Session protocol as inspeximus.integrations.openai_agents.InspeximusSession, backed by a JSON file — no server and no extra install beyond the package itself.

from agents import Agent, Runner
from inspeximus.integrations.openai_agents import InspeximusSession

session = InspeximusSession("user-42", path="sessions.json")
Runner.run_sync(agent, "hi", session=session)

Checked against SQLiteSession

Rather than assert "drop-in", I ran both implementations through the same scenarios and compared the observable results: round-trip ordering, limit returning the latest N oldest-first, limit=0, LIFO pop_item and None on empty, clear_session (including on an already-empty session), adding an empty list, and isolation between two session ids. 13 checks, no differences, on openai-agents 0.18.3. The audit runs in CI, and it has a falsification mode that swallows writes — if that mode still passed, the comparison would be proving nothing.

The one thing it adds beyond persistence: session.forget_subject(request_id=...) hard-deletes a user's turns across sessions and leaves a signed, content-free tombstone, so the erasure is provable and does not read as tampering.

To be straight about scope: a Session is a verbatim turn log, so the library's supersession features do not silently rewrite replayed messages. This row is about the session backend only.

AI disclosure

This contribution was drafted with AI assistance. A human reviewed it, and the parity numbers above come from a run rather than from the README.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@seratch seratch added the documentation Improvements or additions to documentation label Jul 21, 2026
@seratch
seratch marked this pull request as draft July 21, 2026 21:08
@seratch

seratch commented Jul 21, 2026

Copy link
Copy Markdown
Member

Thanks for sharing this. It seems like the project is still pretty new, so we'd like to wait and see whether people start using it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants