slm-cache

# slm-cache — KV Cache for Repeated Reads (Surface B) ## Purpose When the same file, query result, or expensive tool output is needed more than once in a session, fetching it again wastes tokens and time. `slm_cache_set` stores a result under a stable key; `slm_cache_get` retrieves it on subsequent calls. The cache is agent-scoped (automatically namespaced by tenant/agent ID), TTL-bounded, and fail-open. This is an agent-routed cache — it caches results the agent explicitly routes through SLM. It cannot cache Claude conversation turns. ## Tool: slm_cache_set ``` slm_cache_set( key: str, # required — cache key (max 512 chars) value: str, # required — value to store (max 1 MB) ttl_seconds: int = 86400, # time-to-live in seconds (default 24 h) ) -> dict ``` ### Return dict | Key | Type | Meaning | |-----|------|---------| | `ok` | bool | `True` on success; `False` on validation error or internal error | | `stored` | bool | `True` when the value was written to the cache | | `note` | str \| None | Error detail or `None` on success | Keys are SHA-256-hashed internally per agent so they do not collide across agents. The raw key string you supply is the only handle you need. ## Tool: slm_cache_get ``` slm_cache_get( key: str, # required — same key used in slm_cache_set ) -> dict ``` ### Return dict | Key | Type | Meaning | |-----|------|---------| | `ok` | bool | `True` on clean execution (including miss); `False` on i...