All tools
ToolRead

Get belief timeline

get_belief_timeline

Ask what the user believed and when: confidence, status, label, and thesis-field changes for a Thread, claim, company thesis, catalyst, or decision, ordered in time.

When to use it

Ask what the user believed and when: confidence, status, label, and thesis-field changes for a Thread, claim, company thesis, catalyst, or decision, ordered in time.

Typical workflow

Use company context first, then thesis, claims, reviews, and evidence gaps.

What it returns

Ordered belief events with prior and next values, the trigger (run, delta, revision, manual), and actor type.

Avoid using it when

Do not treat belief events as source evidence; they record judgment changes, not facts.

Advanced input contract

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

View full registry notes

Return the ordered belief ledger: confidence, status, inference-level, claim-label, thesis-field, catalyst-verdict, and decision events with prior and next values, who or what triggered each change, and when. Scope by Project, company, or one subject. Use when: Ask what the user believed and when: confidence, status, label, and thesis-field changes for a Thread, claim, company thesis, catalyst, or decision, ordered in time. Avoid when: Do not treat belief events as source evidence; they record judgment changes, not facts.

View JSON Schema
{
  "type": "object",
  "properties": {
    "folderId": {
      "type": "string",
      "format": "uuid"
    },
    "ticker": {
      "type": "string",
      "minLength": 1,
      "maxLength": 12
    },
    "companyId": {
      "type": "string",
      "format": "uuid"
    },
    "subjectType": {
      "type": "string",
      "enum": [
        "research_thread",
        "claim",
        "company_thesis",
        "calendar_event",
        "decision"
      ]
    },
    "subjectId": {
      "type": "string",
      "format": "uuid"
    },
    "since": {
      "type": "string",
      "format": "date-time"
    },
    "until": {
      "type": "string",
      "format": "date-time"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 50
    }
  },
  "additionalProperties": false
}

Useful next tools