Skip to main content

Module state

Module state 

Source
Expand description

Engine state: lessons, beads, evidence import, runtime.

Value-returning operations; the CLI renders. Import bumps the evidence epoch and recompiles the derived layer (moved with the code).

Functions§

beads
embeddings_build
embeddings_get
embeddings_status
external_docs
import_evidence
import_plugin_evidence
Plugin evidence import (spec §31 EvidenceProvider): import.<plugin-id> asks the plugin declaring the evidence-provider extension (or the legacy evidence.import operation) for a contribution batch, then commits it through the NORMAL validate+commit path — never a side door. Input carries the file path ({"file": ...}); the plugin answers {"batch": {entities, relationships, evidence, diagnostics}}. Unknown plugin ids fail with the same vocabulary as unknown formats. Counts map onto ImportReport so every transport renders one shape.
ingest_plugin_runtime_edges
Fan out one ingest body to runtime-evidence plugins. Each plugin declaring the extension (or the legacy op) is called once with {"body": ...} and answers {"edges": [...]} in the simple-edges shape. Malformed plugin rows fail that plugin only (degrade, never the ingest); a crashing plugin is skipped with no model change.
ingest_runtime
lessons_add
lessons_list
plugin_state_delete
Delete one key. Requires StateWrite.
plugin_state_get
Namespaced plugin state (§23): get one key. Requires the calling plugin’s StateRead grant (checked by the host before dispatch; the engine re-checks here so direct invoke() callers are gated too).
plugin_state_put
Put one key (JSON text). Requires StateWrite.
plugin_state_scan
Scan keys by prefix (ordered, bounded). Requires StateRead.
reconcile
runtime_edges
sidecar_get
sidecar_put
Sidecar put/get/scan (§124 item 35, raw half): namespaced raw analyzer facts under (plugin, graph). Same grant gate as plugin state (StateRead for get/scan, StateWrite for put); values are opaque JSON text. Never consumed by ranking/context — promotion only.
sidecar_scan