learn

Store verifiable claims with their evidence. Facts in Knowledge persist until superseded.

Usage

{
  "tool": "learn",
  "arguments": {
    "claim": "API rate limit is 100 requests/minute",
    "evidence": "https://docs.example.com/limits"
  }
}

Parameters

Parameter	Type	Required	Description
claim	string	Yes	The factual claim
evidence	string	Yes	Source URL or reference
confidence	float	No	Confidence score 0-1 (default: 0.8)
tags	string[]	No	Tags for organization
supersedes	string	No	Node ID this claim replaces

Examples

Basic fact:

{
  "tool": "learn",
  "arguments": {
    "claim": "OAuth tokens expire after 1 hour",
    "evidence": "https://docs.example.com/auth#expiry",
    "confidence": 0.95
  }
}

Updating a fact:

{
  "tool": "learn",
  "arguments": {
    "claim": "OAuth tokens now expire after 2 hours",
    "evidence": "https://docs.example.com/changelog#v2",
    "confidence": 0.95,
    "supersedes": "node_old_expiry_fact"
  }
}

When to Use

• Verifiable information from documentation
• API behaviors confirmed by testing
• Configuration values from official sources
• Anything you’d need to cite

When NOT to Use

• Observations without sources (use remember)
• Opinions or preferences (use remember)
• Conclusions from multiple facts (use believe)