All tools
ToolWrite

Propose Research Thread revision

propose_research_thread_revision

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": {
    "threadId": {
      "type": "string",
      "format": "uuid"
    },
    "summary": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    },
    "changes": {
      "type": "object",
      "minProperties": 1,
      "properties": {
        "title": {
          "type": "string",
          "minLength": 1,
          "maxLength": 240
        },
        "hypothesis": {
          "type": "string",
          "minLength": 1,
          "maxLength": 5000
        },
        "whyItMatters": {
          "type": [
            "string",
            "null"
          ],
          "maxLength": 5000
        },
        "status": {
          "type": "string",
          "enum": [
            "candidate",
            "tracking",
            "strengthened",
            "weakened",
            "validated",
            "rejected",
            "incorporated"
          ]
        },
        "confidence": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100
        },
        "inferenceLevel": {
          "type": "string",
          "enum": [
            "observed",
            "inferred",
            "speculative"
          ]
        },
        "alternativeExplanations": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2000
          },
          "maxItems": 12
        },
        "missingProof": {
          "type": [
            "string",
            "null"
          ],
          "maxLength": 5000
        },
        "nextActions": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2000
          },
          "maxItems": 12
        }
      },
      "additionalProperties": false
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    }
  },
  "required": [
    "threadId",
    "summary",
    "changes",
    "idempotencyKey"
  ],
  "additionalProperties": false
}

Useful next tools