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 theevidence-providerextension (or the legacyevidence.importoperation) 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-evidenceplugins. 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