List research tasks
list_research_tasksAt the start of a session, list active tasks in the authorized Project to resume unfinished work instead of starting over.
When to use it
At the start of a session, list active tasks in the authorized Project to resume unfinished work instead of starting over.
List existing Threads first, inspect the case file, then add exact evidence, propose a revision, or start one bounded run and poll it to a terminal state.
Research Thread case files, exact evidence, pending revisions, or pollable metered run state and results.
Avoid using it when
You only need a one-off answer, or you intend to validate, reject, incorporate, apply, or dismiss a conclusion without human review.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View full registry notes
List this user's durable research tasks, optionally for one authorized Project or by status. Call at the start of a session to resume unfinished work. Use when: At the start of a session, list active tasks in the authorized Project to resume unfinished work instead of starting over.
View JSON Schema
{
"type": "object",
"properties": {
"folderId": {
"type": "string",
"format": "uuid"
},
"statuses": {
"type": "array",
"maxItems": 4,
"items": {
"type": "string",
"enum": [
"active",
"paused",
"completed",
"abandoned"
]
}
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"default": 50
}
},
"additionalProperties": false
}