Replay Sessions and Exports

Replay Sessions and Exports

AgentDesk is designed to turn a failed run into portable evidence.

Replay Session JSON

The replay-session export is the main restoration format. It can include:

• workflow graph
• nodes and edges
• trace events
• selected trace event
• selected artifact
• inspected node
• graph validation issues
• imported MCP metadata
• runtime mode state
• trace summary
• portable workflow payload
• framework starter exports

Use replay-session JSON when you want someone else to reopen the same debugging state.

Trace Bundle ZIP

The trace bundle ZIP is file-oriented. It includes:

• manifest.json
• trace event evidence
• artifact files
• sanitized file paths

Use the ZIP when you want a file bundle that can be inspected outside the app or attached to an issue, PR, or handoff.

Redaction

Exports redact common secret formats and private path prefixes. Examples include:

• API key fields
• bearer tokens
• GitHub tokens
• Slack tokens
• JWT-like strings
• private key fields
• database URLs
• local user path prefixes

Redaction is defensive, not absolute. Do not intentionally paste raw secrets into content that will become trace evidence.

Framework Starter Exports

AgentDesk includes starter export paths and examples for:

• LangGraph
• CrewAI

Example files:

• docs/examples/langgraph-agentdesk-example.py
• docs/examples/crewai-agentdesk-example.py

These examples are intentionally small. They show how to begin translating AgentDesk evidence into framework-specific workflows without hiding safety tradeoffs.

Recommended Handoff Flow

When reporting a failed run:

1. Reproduce in Demo, Ollama, Cloud BYOK, or Runtime mode.
2. Click the failed trace event.
3. Confirm the linked graph node is selected.
4. Inspect Debug, Artifacts, Costs, and Validation.
5. Replay the failed step if useful.
6. Export replay-session JSON.
7. Export trace bundle ZIP if artifact files matter.
8. Remove or review sensitive evidence before posting publicly.

Import Flow

To restore a replay session:

1. Open AgentDesk.
2. Click import.
3. Select the .agentdesk-session.json file.
4. Review restored workflow, trace, selected event, artifact, and mode state.

Imported sessions should be treated as untrusted input. Review content before using Runtime mode or executing live tools.