All tools
ToolRead

List Research Threads

list_research_threads

Use to orient within a Project's durable hypotheses before creating a duplicate or starting another model run.

When to use it

Use to orient within a Project's durable hypotheses before creating a duplicate or starting another model run.

Typical workflow

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.

What it returns

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 durable Research Thread hypotheses for one authorized Project, including evidence coverage and active runs. This is read-only and does not adjudicate or change a Thread. Use when: Use to orient within a Project's durable hypotheses before creating a duplicate or starting another model run.

View JSON Schema
{
  "type": "object",
  "properties": {
    "folderId": {
      "type": "string",
      "format": "uuid"
    },
    "statuses": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "candidate",
          "tracking",
          "strengthened",
          "weakened",
          "validated",
          "rejected",
          "incorporated"
        ]
      },
      "maxItems": 7
    },
    "includeArchived": {
      "type": "boolean",
      "default": false
    },
    "search": {
      "type": "string",
      "minLength": 1,
      "maxLength": 240
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 100
    }
  },
  "required": [
    "folderId"
  ],
  "additionalProperties": false
}

Useful next tools