{
  "name": "meshdrop",
  "section": 1,
  "title": "p2p file inbox and outbox",
  "synopsis": [
    "meshdrop offer FILE [--to PEER_HINT]",
    "meshdrop send-next OFFER_ID [MAX_CHUNKS]",
    "meshdrop inbox [N]",
    "meshdrop accept OFFER_ID",
    "meshdrop fetch OFFER_ID [DEST]"
  ],
  "description": "Transfers files between booted Bare OS peers using a chunked `bare-p2p-v1` meshdrop protocol carried over the existing p2p chat transport. Transfer lifecycle uses offer/accept/chunk/progress/cancel/complete events with local queue state under `~/.bare/p2p-suite/meshdrop.json`. Host bridge hooks can consume emitted mirror-drive hints.",
  "options": [],
  "keywords": ["p2p", "files", "meshdrop", "swarm"],
  "examples": [
    { "caption": "offer a file to peers", "code": "meshdrop offer ./report.txt" },
    { "caption": "send more queued chunks", "code": "meshdrop send-next offer-abc123 16" },
    { "caption": "accept then inspect transfer progress", "code": "meshdrop accept offer-abc123 && meshdrop status" },
    { "caption": "save an accepted transfer", "code": "meshdrop fetch offer-abc123 ./received-report.txt" }
  ],
  "seeAlso": [
    { "name": "chat", "section": 1 },
    { "name": "tar", "section": 1 }
  ]
}