flowspec-mcp 5.5.0 → 5.5.2

package/dist/utils/selectionHelper.js

@@ -0,0 +1,111 @@
+import { MODE, LOCAL_API_BASE, getLocalAuthToken } from '../config.js';
+/**
+ * Fetch current selection state from desktop server
+ */
+export async function fetchCurrentSelection() {
+    if (MODE !== 'local') {
+        return null;
+    }
+    try {
+        const token = getLocalAuthToken();
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (token) {
+            headers['Authorization'] = `Bearer ${token}`;
+        }
+        const res = await fetch(`${LOCAL_API_BASE}/api/selection/current`, {
+            headers,
+            signal: AbortSignal.timeout(2000)
+        });
+        if (!res.ok) {
+            return null;
+        }
+        return res.json();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve "current" node ID to the actual selected node ID.
+ *
+ * @param nodeId - Either a real UUID or the string "current"
+ * @param projectId - Optional project ID to validate selection matches
+ * @returns The resolved node ID
+ * @throws Error if "current" is used but no node is selected, or multiple nodes selected
+ */
+export async function resolveCurrentNodeId(nodeId, projectId) {
+    if (nodeId !== 'current') {
+        return nodeId;
+    }
+    const selection = await fetchCurrentSelection();
+    if (!selection || selection.type === 'none' || selection.stale) {
+        throw new Error('No node currently selected in FlowSpec editor. Please click a node first or provide the node ID explicitly.');
+    }
+    if (projectId && selection.projectId !== projectId) {
+        throw new Error(`Selection is from a different project (${selection.projectName}). Please switch to the correct project or provide the node ID explicitly.`);
+    }
+    const selectedNodes = selection.selectedNodes || [];
+    if (selectedNodes.length === 0) {
+        throw new Error('No node currently selected. Please click a node first or provide the node ID explicitly.');
+    }
+    if (selectedNodes.length > 1) {
+        const nodeList = selectedNodes.map(n => `"${n.label}" (${n.id})`).join(', ');
+        throw new Error(`Multiple nodes selected: ${nodeList}. Please click a single node or provide the node ID explicitly.`);
+    }
+    return selectedNodes[0].id;
+}
+/**
+ * Resolve "current" edge ID to the actual selected edge ID.
+ *
+ * @param edgeId - Either a real UUID or the string "current"
+ * @param projectId - Optional project ID to validate selection matches
+ * @returns The resolved edge ID
+ * @throws Error if "current" is used but no edge is selected, or multiple edges selected
+ */
+export async function resolveCurrentEdgeId(edgeId, projectId) {
+    if (edgeId !== 'current') {
+        return edgeId;
+    }
+    const selection = await fetchCurrentSelection();
+    if (!selection || selection.type === 'none' || selection.stale) {
+        throw new Error('No edge currently selected in FlowSpec editor. Please click an edge first or provide the edge ID explicitly.');
+    }
+    if (projectId && selection.projectId !== projectId) {
+        throw new Error(`Selection is from a different project (${selection.projectName}). Please switch to the correct project or provide the edge ID explicitly.`);
+    }
+    const selectedEdges = selection.selectedEdges || [];
+    if (selectedEdges.length === 0) {
+        throw new Error('No edge currently selected. Please click an edge first or provide the edge ID explicitly.');
+    }
+    if (selectedEdges.length > 1) {
+        throw new Error(`Multiple edges selected. Please click a single edge or provide the edge ID explicitly.`);
+    }
+    return selectedEdges[0].id;
+}
+/**
+ * Get information about the current selection for user-friendly error messages.
+ */
+export async function getSelectionSummary() {
+    const selection = await fetchCurrentSelection();
+    if (!selection || selection.type === 'none') {
+        return 'No selection';
+    }
+    if (selection.stale) {
+        return 'Selection stale (>60s)';
+    }
+    const nodeCount = selection.selectedNodes?.length || 0;
+    const edgeCount = selection.selectedEdges?.length || 0;
+    if (nodeCount > 0 && edgeCount > 0) {
+        return `${nodeCount} node(s) and ${edgeCount} edge(s) selected`;
+    }
+    else if (nodeCount > 0) {
+        return `${nodeCount} node(s) selected`;
+    }
+    else if (edgeCount > 0) {
+        return `${edgeCount} edge(s) selected`;
+    }
+    return 'No selection';
+}
+//# sourceMappingURL=selectionHelper.js.map

package/dist/utils/selectionHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectionHelper.js","sourceRoot":"","sources":["../../src/utils/selectionHelper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAkCvE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IAC1C,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAC;QAClC,MAAM,OAAO,GAA2B;YACvC,cAAc,EAAE,kBAAkB;SAClC,CAAC;QACF,IAAI,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,KAAK,EAAE,CAAC;QAC9C,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,cAAc,wBAAwB,EAAE;YAClE,OAAO;YACP,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SACjC,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACb,CAAC;QAED,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAAc,EAAE,SAAkB;IAC5E,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,qBAAqB,EAAE,CAAC;IAEhD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,6GAA6G,CAAC,CAAC;IAChI,CAAC;IAED,IAAI,SAAS,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,0CAA0C,SAAS,CAAC,WAAW,4EAA4E,CAAC,CAAC;IAC9J,CAAC;IAED,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,IAAI,EAAE,CAAC;IAEpD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,0FAA0F,CAAC,CAAC;IAC7G,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7E,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,iEAAiE,CAAC,CAAC;IACxH,CAAC;IAED,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAAc,EAAE,SAAkB;IAC5E,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,qBAAqB,EAAE,CAAC;IAEhD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,8GAA8G,CAAC,CAAC;IACjI,CAAC;IAED,IAAI,SAAS,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,0CAA0C,SAAS,CAAC,WAAW,4EAA4E,CAAC,CAAC;IAC9J,CAAC;IAED,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,IAAI,EAAE,CAAC;IAEpD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,2FAA2F,CAAC,CAAC;IAC9G,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,wFAAwF,CAAC,CAAC;IAC3G,CAAC;IAED,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACxC,MAAM,SAAS,GAAG,MAAM,qBAAqB,EAAE,CAAC;IAEhD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC7C,OAAO,cAAc,CAAC;IACvB,CAAC;IAED,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,wBAAwB,CAAC;IACjC,CAAC;IAED,MAAM,SAAS,GAAG,SAAS,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,SAAS,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC,CAAC;IAEvD,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QACpC,OAAO,GAAG,SAAS,gBAAgB,SAAS,mBAAmB,CAAC;IACjE,CAAC;SAAM,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,GAAG,SAAS,mBAAmB,CAAC;IACxC,CAAC;SAAM,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,GAAG,SAAS,mBAAmB,CAAC;IACxC,CAAC;IAED,OAAO,cAAc,CAAC;AACvB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flowspec-mcp",
-  "version": "5.5.0",
+  "version": "5.5.2",
   "type": "module",
   "description": "MCP server for FlowSpec — exposes project specs to Claude Code",
   "bin": {