TRACE_SHARING.md

Trace Sharing

Borderless writes non-blocking JSONL tool traces to agent_traces/ by default. These traces are ignored by git so local demos do not accidentally commit noisy runtime files.

Each line includes:

• Timestamp
• Tool name
• Tool arguments
• Duration
• Truncated tool result

Use these traces to support the Build Small Sharing is Caring badge:

1. Run a polished demo prompt in the Space or locally.
2. Review the generated agent_traces/borderless-YYYYMMDD.jsonl file.
3. Remove any personal information from the user profile or tool results.
4. Publish the sanitized trace as a Hugging Face dataset, gist, or appendix to a field-notes post.

Configuration:

• BORDERLESS_TRACE_DIR: output directory, default agent_traces.
• BORDERLESS_DISABLE_TRACE_LOGS=1: disable trace logging.