Skip to content

docs: add Rewind to ecosystem tracing processors list#2872

Draft
risjai wants to merge 1 commit intoopenai:mainfrom
risjai:add-rewind-tracing-processor
Draft

docs: add Rewind to ecosystem tracing processors list#2872
risjai wants to merge 1 commit intoopenai:mainfrom
risjai:add-rewind-tracing-processor

Conversation

@risjai
Copy link
Copy Markdown

@risjai risjai commented Apr 10, 2026

Adds Rewind to the external tracing processors list.

Rewind provides RewindTracingProcessor, a subclass of agents.tracing.TracingProcessor that captures agent spans into a local time-travel debugger.

TracingProcessor implementation:

from agents.tracing import TracingProcessor

class RewindTracingProcessor(TracingProcessor):
    """Subclasses TracingProcessor to capture all agent spans."""

    def on_trace_start(self, trace): ...
    def on_trace_end(self, trace): ...
    def on_span_start(self, span): ...
    def on_span_end(self, span): ...  # maps GenerationSpanData, FunctionSpanData, HandoffSpanData → Rewind steps
    def shutdown(self): ...
    def force_flush(self): ...

Registration via add_trace_processor():

from agents.tracing import add_trace_processor
from rewind_agent.openai_agents import RewindTracingProcessor
from rewind_agent.store import Store

store = Store()
session_id, timeline_id = store.create_session("my-agent")
processor = RewindTracingProcessor(store, session_id, timeline_id)
add_trace_processor(processor)

Rewind provides a TracingProcessor subclass (RewindTracingProcessor)
that captures GenerationSpanData, FunctionSpanData, and HandoffSpanData
spans into a local time-travel debugger with fork, replay, and diff.

Source: https://github.com/agentoptics/rewind/blob/master/python/rewind_agent/openai_agents.py
Docs: https://github.com/agentoptics/rewind/blob/master/docs/openai-agents-sdk.md
PyPI: pip install rewind-agent[agents]
@github-actions github-actions bot added the documentation Improvements or additions to documentation label Apr 10, 2026
@seratch seratch marked this pull request as draft April 10, 2026 01:36
@seratch
Copy link
Copy Markdown
Member

seratch commented Apr 10, 2026

Thanks for sharing this! It seems you just started this open-source project. We'd like to see people starting to use it for OpenAI Agents SDK based apps. Let us keep this PR open for a while.

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