blackboard_read
Retrieve a value from the shared blackboard using an exact key. Returns the entry if it exists, or null if missing or expired.
Instructions
Read a single entry from the shared blackboard by key. Read-only — never modifies the blackboard. Returns {ok:true, key, value, sourceAgent, timestamp} when found, or {ok:true, key, value:null} when the key does not exist or has expired. Returns {ok:false, error:"..."} if the blackboard is unavailable. key uses the same namespaced format as blackboard_write (e.g. "task:analysis:q3"); agent_id is used for scoped access checks and audit logging. Use when you know the exact key; call blackboard_list with a prefix filter first if you need to discover available keys.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | The blackboard key to read (e.g. "task:analysis:q3") | |
| agent_id | Yes | The agent performing the read (used for scoped access checks) |