Knowledge Corpus
manage_corpusRegister, route, grant, deny, and inspect access to cold-reference corpus documents; record reads and acquisitions while auditing mutations for controlled knowledge use.
Instructions
Manage the cold-reference knowledge corpus. corpus_register indexes a document with optional access_public, access_domains, grants, and denies; route derives its domain from a trusted source profile; grant and deny add per-entity decisions, and an explicit deny overrides public, grant, and domain access; access sets an entity's domain profile; consume records a read. Mutating actions persist access state and are audited; list, get, and acquisitions are read-only. Corpus mutations are not undoable via manage_history. Use when: registering, listing, reading, routing, granting/denying access, consuming, or inspecting acquisitions of corpus documents. Do NOT use when: writing Novel lore entries or secrets — use manage_lore; ranking derived text or traversing the knowledge graph — use manage_knowledge.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "manage_corpus"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | corpus_register, corpus_list, corpus_get, corpus_route, corpus_grant, corpus_deny, corpus_access, corpus_consume, corpus_acquisitions. | |
| corpus_body | No | Document reference text (corpus_register). | |
| corpus_mode | No | read, research, taught, or import (corpus_consume; default read). | |
| corpus_title | No | Document title (corpus_register). | |
| corpus_denies | No | Entity ids explicitly denied access (corpus_register). | |
| corpus_domain | No | Knowledge domain (corpus_register/corpus_route/corpus_list). | |
| corpus_grants | No | Entity ids explicitly granted access (corpus_register). | |
| corpus_domains | No | Knowledge domains the entity may access (corpus_access). | |
| corpus_entity_id | No | Entity acquiring or inspected (corpus_consume/corpus_acquisitions/corpus_access/corpus_grant/corpus_deny). | |
| corpus_document_id | No | Corpus document id (corpus_get/corpus_route/corpus_grant/corpus_deny/corpus_consume). | |
| corpus_access_public | No | Whether every entity may consume it (corpus_register; default false). | |
| corpus_access_domains | No | Knowledge domains granted access (corpus_register). | |
| corpus_source_profile | No | Trusted source profile the domain is routed from (corpus_register; default manual). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | Human-readable text envelope mirroring the structured result (REQ-001, REQ-548a). | |
| status | Yes | Machine-readable result status: OK, NEED_INPUT, WARNING, PARTIAL, or an error category (REQ-002, REQ-548c). |