feat: Add the FerePro plugin

[Rudrakc]

Relates to:

Adding FerePro integration – Adding structured ChatResponse handling. Fixes #1405

---

Risks

Low –

• Minor risk of WebSocket disconnection if API credentials are missing or invalid.
• Potential parsing errors if unexpected data formats are returned from the WebSocket API.

Mitigation:

• Graceful error handling and logging added.
• Fallback responses provided for invalid data formats.

---

Background

What does this PR do?

• Introduces structured handling of WebSocket responses using a new ChatResponse interface.
• Updates the FereProService to parse WebSocket responses directly into ChatResponse.
• Adds error handling for malformed data and WebSocket connection issues.

What kind of change is this?

Feature – Adds new functionality for structured WebSocket responses.
Improvement – Enhances existing WebSocket communication with additional validation and logging.

---

Documentation changes needed?

My changes do not require a change to the project documentation.

---

Testing

Where should a reviewer start?

• Review the services/FereProService.ts file for WebSocket response handling logic.
• Inspect the new ChatResponse interface and mapping in sendMessage().

Detailed testing steps

1. Initialize the plugin by setting FERE_USER_ID in runtime settings.
2. Send a WebSocket message through sendFereProMessage action.
3. Verify structured response by logging ChatResponse details (answer, chat_id, credits used).
4. Trigger error cases by using invalid WebSocket URLs and observe error handling behavior.

---

Deploy Notes

• No database changes.
• Ensure the WebSocket URL and user ID are correctly set in the environment configuration before deployment.