Add Knowledge Base API module for FreeScout with JavaScript and Python clients

[Copilot]

Implements a FreeScout module that exposes the Knowledge Base via REST API for consumption by JavaScript applications and backend services.

FreeScout Module (Modules/KnowledgeBaseAPI/)

Laravel module with 11 REST endpoints:

• Public endpoints (no auth): /api/kb/public/* - categories, articles, search
• Protected endpoints (API key): /api/kb/* - full access with authentication
• Hierarchical categories, pagination, full-text search, view tracking
• SQL injection prevention via parameterized queries, XSS-safe responses

JavaScript Client (frontend/)

const client = new FreeScoutKBClient('https://your-freescout.com');
const articles = await client.search('password reset');

// Or use the complete widget
new KnowledgeBaseWidget('container-id', 'https://your-freescout.com');

• FreeScoutKBClient - API wrapper with async methods
• KnowledgeBaseWidget - Full UI component with search and navigation
• HTML-escaped output prevents XSS

Python Client (backend/GlobalDeskClient.py)

client = FreeScoutClient()
categories = client.list_kb_categories(public=True)
articles = client.search_kb_articles("help", public=True)

Extended existing client with KB methods, maintains backward compatibility.

Documentation

• INSTALLATION.md - Setup with troubleshooting
• API_REFERENCE.md - Complete endpoint documentation
• QUICKSTART.md - 5-minute integration guide
• ARCHITECTURE.md - System design and data flow

Security

Fixed 2 XSS vulnerabilities identified by CodeQL (search query display, error messages). All user-controlled content now properly escaped. SQL injection prevented via parameterized queries.

Original prompt

I'd like to create a custom module for FreeScout that exposes the knowledge base with an API to then be read by a javascript function

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.