Skip to content

[feat] agent: export conversation traces as Markdown reports (#421) - #422

Draft
yefuyou wants to merge 3 commits into
ThinkFlowLab:mainfrom
yefuyou:feat/421-trace-report-export
Draft

yefuyou wants to merge 3 commits into
ThinkFlowLab:mainfrom
yefuyou:feat/421-trace-report-export

Conversation

@yefuyou

@yefuyou yefuyou commented Nov 21, 2026

Copy link
Copy Markdown
Contributor

Summary

Implements a deliberately small first slice of #421, following @FayeSpica's review request on merged PR #409.

  • Add Export report (.md) on the conversation-wide Trace page.
  • Fetch each executed turn's trace and linked Jobs from the existing read-only APIs, including collapsed turns. No new backend endpoint or trace storage.
  • Export turn metadata, safe event types/states only, and linked Job IDs/statuses. Missing logs and unavailable Jobs are marked explicitly; running Turns are marked as partial snapshots.
  • Intentionally omit raw model request files, prompts, system messages, tool arguments/results and asset bytes. User request previews and identifiers are included; review the report before sharing.
  • Put bounded per-source log/event summaries in the report; neither the normal Trace page nor provider execution changes.
  • Add zh-CN/en-US UI labels and focused fixture tests.

Format and boundaries

Markdown is the proposed first format for human-readable reports. Issue #421 asks whether maintainers would prefer machine-readable JSON; we can adjust that without rewriting the trace pipeline.

This PR does not implement the separate per-turn duration request, which should use authoritative server-side timestamps rather than inferred log timing.

Verification

  • Added deterministic tests for mixed runtimes, linked Job status, missing/unavailable logs, Markdown escaping and sensitive raw payload omission.
  • CI pending. No paid model/provider was called.
  • No new business mutation, Job submission, or conversation lease.

Related

Fixes #421
Refs #409, #407, #374, #261.

Suggested labels: type:feat, area:agent.

yefuyou and others added 3 commits November 21, 2026 20:35
…ab#421)

Add a Markdown report export across all executed turns, with bounded event metadata and linked generation-job status. Omit raw model prompts and tool payloads.
Restore the Markdown escape replace after the HTML entity escaping so the file parses again (TS1005/TS1127).

This branch has not been deployed

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[feat] agent: export conversation Trace as a report

2 participants