All tools
ToolWrite

Update Research Thread campaign

update_research_thread_campaign

Pause, resume, or cancel a campaign when the user asks.

When to use it

Pause, resume, or cancel a campaign when the user asks. Cancelling stops future runs; it never changes the Thread's status.

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

Do not cancel a campaign as a way of rejecting the hypothesis; Thread adjudication is human-only.

Advanced input contract

Agent hosts use this JSON Schema to validate the exact input shape.

View full registry notes

Pause, resume, or cancel a campaign. Cancelling stops future runs and never changes the Thread's status or the canonical thesis. Use when: Pause, resume, or cancel a campaign when the user asks. Cancelling stops future runs; it never changes the Thread's status. Avoid when: Do not cancel a campaign as a way of rejecting the hypothesis; Thread adjudication is human-only.

View JSON Schema
{
  "type": "object",
  "properties": {
    "campaignId": {
      "type": "string",
      "format": "uuid"
    },
    "action": {
      "type": "string",
      "enum": [
        "pause",
        "resume",
        "cancel",
        "revise"
      ]
    },
    "expectedVersion": {
      "type": "integer",
      "minimum": 1
    },
    "remainingPlan": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "minItems": 1,
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "mode": {
            "type": "string",
            "enum": [
              "deepen",
              "verify",
              "red_team",
              "refresh"
            ]
          },
          "prompt": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 4000
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "mode"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "campaignId",
    "action"
  ],
  "additionalProperties": false
}

Useful next tools