@flowfuse/driver-kubernetes 2.31.4-f28cf74-202606161618.0 → 2.32.0

package/.github/workflows/release-publish.yml

@@ -8,7 +8,7 @@ jobs:
     publish:
         runs-on: ubuntu-latest
         steps:
-            - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+            - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
             - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
               with:
                   node-version: 24

package/CHANGELOG.md

@@ -1,3 +1,14 @@
+#### 2.32.0: Release
+
+ - Sync changes to Insight support code across drivers (#383)
+ - feat: Add Insights support with get-features and call-tool/read-resource methods (#382)
+ - Bump actions/checkout from 6.0.3 to 7.0.0 (#381)
+ - ci: set dependabot pull request limit to 30 (#380)
+ - Bump ws from 8.20.1 to 8.21.0 (#379)
+ - Bump actions/checkout from 6.0.2 to 6.0.3 (#373)
+ - Bump form-data from 4.0.4 to 4.0.6 (#378)
+ - Bump js-yaml from 4.1.1 to 4.2.0 (#377)
+
 #### 2.31.3: Release
 
 

package/kubernetes.js

@@ -29,6 +29,18 @@ let k8s
  *
  */
 
+/**
+ * @typedef {object} accessToken
+ * @property {string} [scheme] - auth scheme, e.g. 'Bearer'. Basic auth is currently rejected.
+ * @property {string} [token] - the token value
+ * @property {string|string[]} [scope] - token scope(s); only tokens including `ff-expert:mcp` are honoured
+ *
+ * @typedef {object} McpEndpointSpec - Specification for an MCP endpoint. Additional properties are allowed and will be passed back in the result (for correlation purposes).
+ * @property {string} endpoint - The path of the MCP server e.g. '/mcp'. Should not contain the host/port; those are determined to agent/launcher
+ * @property {object} [headers] - extra request headers to send with every MCP HTTP request
+ * @property {accessToken} [accessToken] - access token; merged into `Authorization` when scoped for MCP
+ */
+
 const createDeployment = async (project, options) => {
     const stack = project.ProjectStack.properties
 
@@ -1430,6 +1442,106 @@ module.exports = {
         }
         return { state: 'okay' }
     },
+
+    // #region MCP Support
+
+    // MCP ROUTE: step 4 (hosted)
+    // Called By: forge app (forge/containers/wrapper.js)
+    // Calls To : launchers `command` endpoint in lib/admin.js
+
+    /**
+     * Get MCP features
+     * @param {Project} project - the project model instance
+     * @param {Array<string|McpEndpointSpec>} endpoints - list of MCP endpoints to query.
+     *   Each entry may be a bare URL/path string, or an object `{ endpoint, headers?, accessToken? }`
+     * @returns {Object} MCP features
+     */
+    getMCPFeatures: async (project, endpoints) => {
+        const cachedProject = await this._projects.get(project.id)
+        if (cachedProject === undefined) {
+            throw new Error('Instance cannot get MCP features')
+        }
+        try {
+            const prefix = project.safeName.match(/^[0-9]/) ? 'srv-' : ''
+            const dnsUrl = `http://${prefix}${project.safeName}.${this._namespace}:2880/flowforge/command`
+            const response = await got.post(dnsUrl, {
+                json: {
+                    cmd: 'mcp:get-features',
+                    data: {
+                        endpoints
+                    }
+                }
+            }).json()
+            return response
+        } catch (error) {
+            throw new Error(`Failed to get MCP features: ${error.message}`)
+        }
+    },
+
+    /**
+     * Call MCP endpoint
+     * @param {Project} project - the project model instance
+     * @param {string|McpEndpointSpec} endpoint - MCP endpoint to call.
+     * @param {string} name - Name of the MCP tool to call
+     * @param {Object} input - Arguments to pass to the MCP tool
+     * @returns {Object} MCP tool result
+     */
+    callMCPTool: async (project, endpoint, name, input) => {
+        const cachedProject = await this._projects.get(project.id)
+        if (cachedProject === undefined) {
+            throw new Error('Instance cannot call MCP tool')
+        }
+        try {
+            const prefix = project.safeName.match(/^[0-9]/) ? 'srv-' : ''
+            const dnsUrl = `http://${prefix}${project.safeName}.${this._namespace}:2880/flowforge/command`
+            const response = await got.post(dnsUrl, {
+                json: {
+                    cmd: 'mcp:call-tool',
+                    data: {
+                        endpoint,
+                        name,
+                        input
+                    }
+                }
+            }).json()
+            return response
+        } catch (error) {
+            throw new Error(`Failed to call MCP tool: ${error.message}`)
+        }
+    },
+
+    /**
+     * Read MCP resource
+     * @param {Project} project - the project model instance
+     * @param {string|McpEndpointSpec} endpoint - MCP endpoint to call.
+     * @param {string} uri - URI of the MCP resource to read
+     * @returns {Object} MCP resource result
+     */
+    readMCPResource: async (project, endpoint, uri) => {
+        const cachedProject = await this._projects.get(project.id)
+        if (cachedProject === undefined) {
+            throw new Error('Instance cannot read MCP resource')
+        }
+        try {
+            const prefix = project.safeName.match(/^[0-9]/) ? 'srv-' : ''
+            const dnsUrl = `http://${prefix}${project.safeName}.${this._namespace}:2880/flowforge/command`
+            const response = await got.post(dnsUrl, {
+                json: {
+                    cmd: 'mcp:read-resource',
+                    data: {
+                        endpoint,
+                        uri
+                    }
+                }
+            }).json()
+            return response
+        } catch (error) {
+            throw new Error(`Failed to read MCP resource: ${error.message}`)
+        }
+    },
+
+    // #endregion MCP Support
+
     /**
    * Logout Node-RED instance
    * @param {Project} project - the project model instance

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@flowfuse/driver-kubernetes",
-    "version": "2.31.4-f28cf74-202606161618.0",
+    "version": "2.32.0",
     "description": "Kubernetes driver for FlowFuse",
     "main": "kubernetes.js",
     "scripts": {