pack
Assemble a prompt-ready context block from one or more queries: retrieve, rerank, and budget top memories into injectable text.
Instructions
Assemble a compact, prompt-ready context block from one or more queries: retrieves, reranks, and budgets the top memories into injectable text. Read-only. This is the retrieval path for putting memory into an agent's prompt; use search instead when you want individual scored records rather than an assembled block.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Restrict retrieval to memories carrying these tags. | |
| space | No | Restrict retrieval to a single memory space (namespace), or "*" for all spaces. Omit for the default space. | |
| title | No | Heading for the assembled pack. Default "context". | |
| queries | Yes | One or more natural-language queries to retrieve and merge into the pack. Required. | |
| max_chars | No | Character budget for the assembled pack. Default 6000. | |
| min_score | No | Drop memories scoring below this threshold; the pack abstains (returns empty) when nothing clears it. Default 0 (no floor). | |
| graph_decay | No | Default 0.5. Per-hop activation decay for graph expansion. | |
| max_memories | No | Maximum memories to include in the pack. Default 10. | |
| graph_expansion | No | Default false. Associative recall: graph-expand the rerank pool one hop from the top seeds so a relationship-reachable memory below the ANN/BM25 threshold can still be reranked (hybrid_assoc_v0). | |
| max_graph_seeds | No | Default 3. Top-of-pool anchors used for graph expansion. | |
| query_expansion | No | Default false. Deterministically add subqueries before retrieval. | |
| max_thread_seeds | No | Default 3. | |
| thread_expansion | No | Default false. Add same-entity/same-claim neighbors to the rerank pool. | |
| graph_rerank_slots | No | Default 0. Reserve N pack slots for top-activation graph candidates so a hop-reached memory the reranker scored low can still land (0 = recall-widening only). | |
| max_query_variants | No | Default engine maximum. | |
| max_graph_neighbors | No | Default 5. Graph-reachable neighbors unioned into the pool (activation budget). | |
| max_thread_neighbors | No | Default 3. | |
| graph_activation_floor | No | Default 0.0. Minimum activation a graph candidate needs to claim a reserved rerank slot. | |
| graph_within_entity_maxsim | No | Default false. Experimental: select one memory per graph entity by first-query MaxSim; requires late-interaction tokens. |