blackboard_write
Store a JSON-encoded value under a key in the shared blackboard, overwriting any existing entry and replacing its TTL. Use namespaced keys to avoid collisions.
Instructions
Write a JSON-encoded value to the shared blackboard under the given key. Overwrites any existing entry for that key — TTL is also replaced (or removed if omitted). Not idempotent: each call records a new timestamp and sourceAgent. Returns {ok:true, key, value, sourceAgent, timestamp} on success. Returns {ok:false, error:"..."} if value is not valid JSON, agent_id is missing, or the agent token is rejected. value must be a valid JSON string (use JSON.stringify on objects); ttl sets expiry in seconds — omit for a persistent entry; agent_token is required only if the target key is protected. Use namespaced keys (e.g. "task:result:q3") to avoid collisions; confirm with blackboard_read immediately if the consumer agent is already polling.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | The key to write (e.g. "task:result:q3") | |
| value | Yes | JSON-encoded value to store | |
| agent_id | Yes | The agent performing the write | |
| agent_token | No | Optional verification token for authenticated writes | |
| ttl | No | Optional TTL in seconds (e.g. "3600" for 1 hour) |