Behavior discovery

Most systems detect a fixed menu of behaviors. MemMesh discovers behaviors nobody defined — it clusters subjects by how they actually behave and surfaces the dense, cohesive groups as candidate behaviors.

const { behaviors } = await tf.behaviors.discover();
 
for (const b of behaviors) {
  console.log(
    `${b.label} — ${(b.prevalence * 100).toFixed(0)}% of subjects, ` +
    `stability ${b.stability.toFixed(2)}, ${b.size} members`,
  );
}

What a discovered behavior is

Each behavior is a cluster of like-behaving subjects with the statistics that justify treating it as real:

Field	Meaning
`label`	A human description (“high-value frequent reorderers”).
`prevalence`	Fraction of the analyzed cohort in this cluster — how common.
`stability`	Cohesion (mean intra-cluster similarity) — how tightly they behave alike.
`memberSubjects`	Who exhibits it (medoid first) — provenance.
`exemplarEvidence`	The signals that define it (“pattern: recurring_event”).

Results are sorted most-common-and-cohesive first.

It abstains, too

Discovery only promotes clusters the statistics vouch for. A weak or loose cluster is treated as noise, not a behavior.

⚠️

An empty result means the engine abstained — there isn’t enough signal to assert a behavior yet. It does not mean “this cohort has no behaviors.”

Neuro-symbolic naming

Discovery is the symbolic half of a neuro-symbolic loop: the statistics find and verify clusters; an LLM then names them. Because the model only ever labels a cluster the data already vouched for, it can name a behavior but never invent one.

From discovery to prediction

Discovery is the exploratory, project-wide view — what cohorts exist? The per-subject behavior_pattern memories that feed prediction are produced by pattern mining (/lattice/patterns/extract). The two share the same statistical core, closing the loop: mine → verify → predict, with discovery surfacing the emergent groups.

See the Behavior discovery API for the full request and response shape, and the TypeScript SDK for the behaviors.discover surface.

Predictions Lifecycle