multi-agent message bus: Blackboard vs Message Bus Orchestration

# blackboard/scratch.py — OK for demos, not for prod apply
class Scratch:
    def __init__(self):
        self.notes: list[dict] = []
    def append(self, role: str, text: str):
        self.notes.append({"role": role, "text": text})  # ❌ no hash, no schema

{
  "run_id": "run_7f3a",
  "role": "planner",
  "type": "PlanReady",
  "schema_version": 3,
  "payload_s3": "s3://agent-artifacts/run_7f3a/plan.json",
  "payload_sha256": "ab12…",
  "ts": "2026-09-11T15:00:00Z"
}

# bus/emit.py
import boto3, hashlib, json
eb = boto3.client("events")
s3 = boto3.client("s3")

def emit_plan(run_id: str, plan: dict, bucket: str):
    body = json.dumps(plan, sort_keys=True).encode()
    key = f"{run_id}/plan.json"
    s3.put_object(Bucket=bucket, Key=key, Body=body, ContentType="application/json")
    eb.put_events(Entries=[{
        "Source": "agents.planner",
        "DetailType": "PlanReady",
        "Detail": json.dumps({
            "run_id": run_id,
            "payload_s3": f"s3://{bucket}/{key}",
            "payload_sha256": hashlib.sha256(body).hexdigest(),
            "schema_version": 3,
        }),
        "EventBusName": "agent-orchestration",
    }])

// consumer/idempotency.ts
const seen = new Set<string>();
export function once(key: string, fn: () => Promise<void>) {
  if (seen.has(key)) return; // ✅ at-least-once bus, exactly-once side effect
  seen.add(key);
  return fn();
}