Insights for devices and self hosted platforms

[Steve-Mcl]

Description

Part of enabling Insights for Remote instances and self hosted.

• Adds new MQTT bridge entries ff/v1/expert/+/+/platform/+/response and ff/v1/expert/+/+/platform/+/request to permit agent requests for MCP resources/tools.
  • Links into to providing a pathway for platform automations which will require same capabilities for retrieving platform automation tools (cc @cstns)
• Handers for platform requests of mcp-tool and mcp-resource requests targeting devices and instances
• Add stub and driver implementations for mcp features request, mcp tool call and mcp resource request
• Switches the expert http endpoints /mcp/features and /chat to use new proxied pathways

Important

Requires associated drivers, launcher and device agent to be updated before merging
this Pr will be updated with associated PRs and switched out of draft once ready to merge

TODO:

• unit tests

Related Issue(s)

closes #7438

Checklist

• I have read the contribution guidelines
• Suitable unit/system level tests have been added and they pass
• Documentation has been updated
  • Upgrade instructions
  • Configuration details
  • Concepts
• Changes flowforge.yml?
  • Issue/PR raised on FlowFuse/helm to update ConfigMap Template
  • Issue/PR raised on FlowFuse/CloudProject to update values for Staging/Production
• Link to Changelog Entry PR, or note why one is not needed.

Labels

• Includes a DB migration? -> add the area:migration label

[codecov]

Codecov Report

❌ Patch coverage is 25.60000% with 279 lines in your changes missing coverage. Please review.
✅ Project coverage is 76.02%. Comparing base (858ebac) to head (1ff3e94).

Files with missing lines	Patch %	Lines
forge/comms/instances.js	8.64%	74 Missing ⚠️
forge/comms/devices.js	2.70%	72 Missing ⚠️
forge/comms/commsClient.js	2.00%	49 Missing ⚠️
forge/comms/aclManager.js	0.00%	39 Missing ⚠️
forge/containers/wrapper.js	0.00%	15 Missing ⚠️
forge/containers/stub/index.js	0.00%	9 Missing ⚠️
forge/routes/auth/index.js	0.00%	9 Missing ⚠️
forge/ee/db/models/MCPRegistration.js	60.00%	6 Missing ⚠️
forge/ee/routes/expert/index.js	91.17%	6 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #7604      +/-   ##
==========================================
- Coverage   76.95%   76.02%   -0.94%     
==========================================
  Files         411      412       +1     
  Lines       21094    21426     +332     
  Branches     5141     5248     +107     
==========================================
+ Hits        16233    16289      +56     
- Misses       4861     5137     +276     

Flag	Coverage Δ
backend	76.02% <25.60%> (-0.94%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[Steve-Mcl]

these min versions need to be update once understood.

For device agent, that will likely be 4.0.0
For nr-launcher that will likely be 2.32.0

[Steve-Mcl]

Suggested change

	const MIN_HOSTED_INSTANCE_LAUNCHER_VERSION = '2.31.4'
	const MIN_REMOTE_INSTANCE_AGENT_VERSION = '3.9.1'
	const MIN_HOSTED_INSTANCE_LAUNCHER_VERSION = '2.32.0'
	const MIN_REMOTE_INSTANCE_AGENT_VERSION = '4.0.0'