| Upload shows failed | Check the row's error: image processing off (enable in Settings), missing Anthropic/OpenAI key (§8), file too big, or unsupported type |
| "a crawl is already running for this workspace" | Wait for the running crawl; one at a time per workspace |
| "no OpenAI API key for embeddings" | Anthropic BYOM needs the second key — Settings → Model key |
| Agent sees nothing / too little | Token minted by the right member? Groups changed? Permissions are live per request |
| "agent token expired" | Mint a new one (90-day expiry); old one can be deleted |
| Deep process button missing | Needs: workspace toggle on + document actually has skipped pages + you have write access |