blackboard_read
Read a specific entry from the shared blackboard by its exact key. Returns the value, source agent, and timestamp if found, or null if the key does not exist or has 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) |