vault_context
Composite budgeted context in ONE call (the Honcho-style context() primitive): graph-reranked chunks packed to a token budget and grouped by note, recent synthesis patterns touching the query, open contradictions on the packed notes, and applicable past lessons (decision/lesson/postmortem chunks relevant to the query) — with source metadata and packing stats. include_work adds eligible work-memory episodes (the work-memory reader contract; explicit opt-in, never default). Omit query for session bootstrap: the queued thread is read from the memory folder’s _next-session.md signal note, so every session opens with its applicable lessons (push, not pull). response_format=concise drops the route, budget and stats blocks, each chunk’s source and hop and each lesson’s via.
| Domain | knowledge |
| Scopes | read:notes |
| Access | read |
| Tags | read-only, domain:knowledge, knowledge, search, external-network |
| Profile | core, full |
Annotations
Section titled “Annotations”| Annotation | Value |
|---|---|
| Read-only | yes |
| Destructive | no |
| Idempotent | no |
| Accepts an idempotency key | no |
Idempotent is the advisory MCP idempotentHint. Destructive is also yes for a tool that
asks for confirmation only on some calls.
Confirmation (human in the loop)
Section titled “Confirmation (human in the loop)”No human confirmation is required to call this tool.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
vault |
string |
— | Vault id. May be omitted when only one vault is available. length 1–64; pattern ^[a-z0-9_-]+$ |
|
query |
string |
— | length ≥ 1 | |
token_budget |
integer |
4000 |
range 1–64000 | |
k |
integer |
30 |
range 1–60 | |
include_work |
boolean |
false |
— | |
include_lessons |
boolean |
true |
— | |
since |
string |
— | ISO-8601. A LOWER-BOUND HINT for differential mode: the server floors it against this caller’s own stored watermark (if any), so a client clock running ahead can never cause a row to be silently skipped — it can only ever see a row again, not lose one. Filters notes/syntheses/contradictions (and episodes, with include_work) to rows newer than the effective cutoff. Omit for the full snapshot (unchanged default behavior). pattern ^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$; format date-time |
|
response_format |
enum |
— | concise returns only the high-signal fields; detailed (the shipped default) returns the full payload. Errors and safety warnings are never trimmed. When omitted, the server’s tools.defaults.responseFormat applies. One of: "concise", "detailed" |
|
verbosity |
enum |
— | Legacy alias for response_format: terse = concise, full = detailed. One of: "full", "terse" |
Output
Section titled “Output”| Field | Type | Always present | Description |
|---|---|---|---|
vault |
string |
yes | — |
route |
string[] |
— | |
query_source |
enum |
One of: "input", "next_session" |
|
signal |
string |
— | |
signal_hash |
string |
— | |
budget |
object |
— | |
budget.requested |
number |
with parent | — |
budget.chunk_budget |
number |
with parent | — |
budget.packed_tokens |
number |
with parent | — |
stats |
object |
— | |
stats.chunks_considered |
number |
with parent | — |
stats.chunks_packed |
number |
with parent | — |
stats.notes |
number |
with parent | — |
stats.contradictions |
number |
with parent | — |
stats.syntheses |
number |
with parent | — |
stats.lessons |
number |
with parent | — |
notes |
object[] |
yes | — |
notes[].path |
string |
yes | — |
notes[].chunks |
object[] |
yes | — |
syntheses |
object[] |
yes | — |
syntheses[].iso_year |
number |
yes | — |
syntheses[].iso_week |
number |
yes | — |
syntheses[].generated_at |
number |
yes | — |
syntheses[].patterns |
any |
yes | — |
contradictions |
object[] |
yes | — |
contradictions[].id |
string |
yes | — |
contradictions[].source_path |
string |
yes | — |
contradictions[].conflict_path |
string |
yes | — |
contradictions[].judge_verdict |
string |
yes | — |
contradictions[].judge_rationale |
string |
yes | — |
15 more field(s) not shown; describe_capability returns the full output schema.
Related tools
Section titled “Related tools”Other tools in the knowledge domain: add_observation, audit_provenance, close_goal, commit_capture, commit_wiki_page, create_entity, delete_entity, diagnose_retrieval, draft_wiki_page, end_session, enqueue_capture, episode_stats, explain_answer, find_existing_page, gap_report, get_entity, get_session_traces, knowledge_challenge, link_entities, lint_wiki, list_capture_queue, list_contradictions, list_goals, note_quality_report, plur_get, plur_recall, plur_recall_hybrid, plur_similarity_search, query_entity_graph, record_retrieval_feedback, reflect, rename_entity, session_bootstrap, set_goal, start_session, unlink_entities, update_observation, vault_graph_search, work_episode_chain, work_episodes, work_forget, work_result, work_search.
Back to the tool catalog.