All tools
ToolWrite

Create Research Thread

create_research_thread

You need durable cross-source hypotheses, contradiction tracking, missing-proof analysis, or a bounded Prism investigation inside one Project.

When to use it

You need durable cross-source hypotheses, contradiction tracking, missing-proof analysis, or a bounded Prism investigation inside one Project.

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 JSON Schema
{
  "type": "object",
  "properties": {
    "folderId": {
      "type": "string",
      "format": "uuid"
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 240
    },
    "hypothesis": {
      "type": "string",
      "minLength": 1,
      "maxLength": 5000
    },
    "whyItMatters": {
      "type": [
        "string",
        "null"
      ],
      "maxLength": 5000
    },
    "inferenceLevel": {
      "type": "string",
      "enum": [
        "observed",
        "inferred",
        "speculative"
      ],
      "default": "inferred"
    },
    "confidence": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100,
      "default": 50
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    }
  },
  "required": [
    "folderId",
    "title",
    "hypothesis",
    "idempotencyKey"
  ],
  "additionalProperties": false
}

Useful next tools