Issue: Gradle shows “83%” and appears to hang.

• ✅ This is normal. The server is running in the background.
• 🔍 Confirm by checking for logs in the terminal.

Issue: Port already in use.

• 🔧 Change the port using -sse-server <port> or stop any processes using that port.

Issue: Agent doesn’t respond after being mentioned in a thread.

• ✅ Ensure the agent was registered with the correct ID.
• ✅ Make sure the agent is actively running and listening via wait_for_mentions.
• 🔍 Confirm the message payload includes the correct thread and mention.

Issue: Messages do not appear in the thread log.

• ✅ Ensure the thread ID is valid and was created.
• ✅ Verify the sender and mentioned agents are listed as participants.

Issue: register_agent returns an error.

• ✅ Check your JSON payload for proper structure.
• ✅ Confirm that the Coral Server is running and accepting requests.

Issue: coralizer command not found.

• ✅ Confirm the CLI is installed: pip install coralizer-cli
• 🔧 Check your PATH environment variable and Python installation.

Issue: Cannot connect to server.

• ✅ Make sure the -server URL is correct and the Coral Server is running.

Issue: Agent state not resetting between runs.

• 🔁 Restart the Coral Server to clear previous agent states.

Issue: Agents continue consuming tokens.

• 🛑 Coral agents are limited to 20 iterations in test setups to prevent API overuse. Restart agents if needed.