docs: rewrite Convos HTTP API reference

[saulmc]

Summary

• Rewrites extensions/convos/POOL-MANAGER.md as a factual HTTP API reference derived from the implemented code
• Documents all 12 HTTP endpoints with exact request parameters, defaults, and response shapes
• Adds missing endpoints: /convos/setup, /convos/setup/status, /convos/setup/complete, /convos/setup/cancel, /convos/reset
• Adds missing parameters on /convos/conversation (profileName, profileImage, description, imageUrl, permissions, instructions) and /convos/join (profileName, profileImage, instructions)
• Documents poolApiKey Bearer authentication
• Removes hypothetical/recommended content (golden checkpoint proposal, provisioning walkthrough, customization guidance)

Test plan

• Verify documented endpoints, params, and responses match extensions/convos/index.ts

[macroscopeapp]

Rewrite Convos plugin docs to provide HTTP API reference and authentication details in POOL-MANAGER.md

Replace the prior provisioning guide with an HTTP API reference covering Bearer auth via channels.convos.poolApiKey, status and conversation endpoints, setup/reset flows with 10-minute auto-cleanup, one-conversation-per-process 409 constraints, and request/response schemas with codes including 401, 409, and timeout behavior.

📍Where to Start

Start with the HTTP API sections in POOL-MANAGER.md, beginning at the authentication overview and GET /convos/status to follow endpoint semantics.

---

Macroscope summarized 96be0ac.