kennet:twin). Files move through short-lived curl commands that run in the agent’s shell, not through tool arguments.
Follow a task with
get_task; cancel it with cancel_task.
upload_trace
Returns
{upload_id, command, url, expires_at}. Run command before expires_at (10 minutes).
twin_trace
Returns a task. When it completes, its result has
output_path; when it fails, an error with a code. Each upload is twinned once.
Errors on our side are retried automatically. If the organization’s balance runs out, the twin pauses and resumes once credit is added.
pull_trace
Returns
{command, url, expires_at}. Run command before expires_at (10 minutes).
Tool errors
The tools return the API’s error codes, and these:
For many traces, use batches.