Engramma

Exploration

advanced

Proactive exploration: test uncertain compositions, get suggestions, find consolidation candidates, detect spurious patterns.

Explore compositions

POST/v1/memory/explore

Proactively test the most uncertain compositions to maximize information gain.

batch_sizeintegerDefault: 5

Number of compositions to explore (1–20).

200Response
{
  "explorations": [
    {
      "information_gain": 0.82,
      "composition_valid": true,
      "coherence": 0.91,
      "consolidation_priority": 0.75
    },
    {
      "information_gain": 0.45,
      "composition_valid": false,
      "coherence": 0.23,
      "consolidation_priority": 0.1
    }
  ],
  "total_explored": 2
}

Exploration suggestions

GET/v1/memory/explore/suggestions

Return the most informative compositions to explore next.

200Response
{
  "suggestions": [
    {
      "pair_id": [
        12,
        45
      ],
      "expected_information_gain": 0.89,
      "uncertainty": 0.92
    },
    {
      "pair_id": [
        7,
        23
      ],
      "expected_information_gain": 0.71,
      "uncertainty": 0.78
    }
  ]
}

Consolidation candidates

GET/v1/memory/explore/consolidation-candidates

Get compositions ready for long-term memory consolidation.

min_prioritynumberDefault: 0.5

Minimum consolidation priority to include.

200Response
{
  "candidates": [
    {
      "pair_id": [
        12,
        45
      ],
      "priority": 0.92,
      "times_validated": 5
    },
    {
      "pair_id": [
        3,
        18
      ],
      "priority": 0.67,
      "times_validated": 3
    }
  ]
}

Detect spurious

POST/v1/memory/explore/detect-spurious

Proactively detect compositions that are likely spurious/invalid.

200Response
{
  "spurious_pairs": [
    [
      5,
      22
    ],
    [
      8,
      31
    ]
  ],
  "total_checked": 45,
  "spurious_rate": 0.044
}

Next steps

TemporalHDC