links_suggest
Surfaces candidate co-evidential particle pairs within a Subject for operator review by comparing embeddings against a similarity threshold. Read-only report that flags unlinked pairs; no mutation.
Instructions
Propose co-evidential candidate pairs within Subjects (read-only).
Within each Subject, ACTIVE particles whose embeddings exceed the
similarity threshold and are not already linked CO_EVIDENTIAL are
surfaced as candidate pairs for operator review. No LLM call, no
mutation — this is the ``REPORT`` mode of ``particles links suggest``.
Args:
subject_id: Restrict to one Subject. ``None`` scans every
Subject — prefer passing a ``subject_id`` to keep results focused.
threshold: Cosine-similarity floor (0.0–1.0). Defaults to
``links_suggest.candidate_threshold`` when omitted.
limit: Maximum candidate pairs to include across all clusters
(default 100). A ``truncated`` flag is added when the cap fires.
Returns:
``{run_at, mode, clusters, total_candidates, warnings}`` matching the
``SuggestReport`` schema, optionally with ``truncated: True``.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| threshold | No | ||
| subject_id | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||