@kumologica/sdk 3.5.4 → 3.6.0-alpha7

package/src/app/preload.js

@@ -5,52 +5,53 @@
  * main process (electron), kumologica runtime and itself (node part)
  */
 
-
 // const { AppServer, lambdify } = require('./lib/runtime-loader');
-const { lambdify } = require('@kumologica/runtime');
-const { codegen } = require('@kumologica/builder');
-
-const { DesignerServer } = require('../server/DesignerServer')
-
-const { Terminal } = require('xterm');
-const { FitAddon } = require('xterm-addon-fit');
-const electron = require('electron');
-const remote = require('@electron/remote');
+const { lambdify } = require("@kumologica/runtime");
+const { codegen } = require("@kumologica/builder");
+const { DesignerServer } = require("../server/DesignerServer");
+const { Terminal } = require("xterm");
+const { FitAddon } = require("xterm-addon-fit");
+const electron = require("electron");
+const remote = require("@electron/remote");
+const { exec, spawn } = require("child_process");
+const chalk = require("chalk");
 
 // Parse arguments from: webPreferences.additionalArguments
-const argv = require('yargs/yargs')(process.argv.slice(2)).parse();
+const argv = require("yargs/yargs")(process.argv.slice(2)).parse();
 const port = argv.port || 1880;
 
-const events = require('events');
-const debounce = require('debounce');
-const { promisify } = require('util');
+const events = require("events");
+const debounce = require("debounce");
+const { promisify } = require("util");
 
-const dagre = require('dagre');
-const simpleGit = require('simple-git');
-const request = require('request');
+const dagre = require("dagre");
+const simpleGit = require("simple-git");
+const request = require("request");
 const requestAsync = promisify(request);
 
-const CloudConfig = require('./lib/stores/aws-cloud-config-store');
-const TestConfig = require('./lib/stores/test-config-store');
-const KumohubConfig = require('./lib/stores/kumohub-config-store');
-const AzureConfig = require('./lib/stores/azure-config-store');
-const ProjectInfoConfig = require('./lib/stores/project-info-config-store');
-const { CloudConfigStore } = require('./lib/stores/settings-cloud-store');
-const { NetworkConfigStore } = require('./lib/stores/settings-network-store');
-const { OpenAIClient } = require('./lib/ai/openai');
+const CloudConfig = require("./lib/stores/aws-cloud-config-store");
+const TestConfig = require("./lib/stores/test-config-store");
+const KumohubConfig = require("./lib/stores/kumohub-config-store");
+const AzureConfig = require("./lib/stores/azure-config-store");
+const ProjectInfoConfig = require("./lib/stores/project-info-config-store");
+const { CloudConfigStore } = require("./lib/stores/settings-cloud-store");
+const { NetworkConfigStore } = require("./lib/stores/settings-network-store");
+const { OpenAIClient } = require("./lib/ai/openai");
 
-const AWSProfile = require('./lib/aws/aws-profile');
-const AWSDeployer = require('./lib/aws');
-const ServerlessDeployer = require('./lib/serverless');
-const GithubDeployer = require('./lib/github');
+const AWSProfile = require("./lib/aws/aws-profile");
+const AWSDeployer = require("./lib/aws");
+const ServerlessDeployer = require("./lib/serverless");
+const GithubDeployer = require("./lib/github");
 
-const { WorkspacePreferenceStore } = require('./lib/stores/workspace-preference-store');
+const {
+  WorkspacePreferenceStore,
+} = require("./lib/stores/workspace-preference-store");
 
-const Kumohub = require('./lib/kumohub');
-const deployCli = require('@kumologica/builder');
-const Azure = require('./lib/azure');
+const Kumohub = require("./lib/kumohub");
+const deployCli = require("@kumologica/builder");
+const Azure = require("./lib/azure");
 
-const { openFileOnEditor, openFolder } = require('./lib/utils/editor');
+const { openFileOnEditor, openFolder } = require("./lib/utils/editor");
 
 const terminalEmitter = new events.EventEmitter();
 const awsDeployer = new AWSDeployer(terminalEmitter);
@@ -64,14 +65,13 @@ const azure = new Azure(terminalEmitter);
 
 const DESIGNER_DEBUGGER_URL = `http://127.0.0.1:${port}/__debugger__`;
 
-const KUMOLOGICA_NODE_LIB_BASEURL =
-  'https://library.kumohub.io';
+const KUMOLOGICA_NODE_LIB_BASEURL = "https://library.kumohub.io";
 const KUMOLOGICA_NODE_LIB_URL = `${KUMOLOGICA_NODE_LIB_BASEURL}/library.json`;
 
 const cloudConfigStore = new CloudConfigStore();
 const networkConfigStore = new NetworkConfigStore();
 
-const openAIClient = new OpenAIClient({ version: 'gpt-3.5-turbo' }); //'gpt-4'
+const openAIClient = new OpenAIClient({ version: "gpt-3.5-turbo" }); //'gpt-4'
 
 // function to be called each time
 // project changes - either new project created or old project opened.
@@ -83,9 +83,10 @@ function loadConfigs() {
     dataPath: window.__kumologica.settings.projectDir,
   });
 
-  window.__kumologica.settings.kumohubConfig = new KumohubConfig.KumohubConfigStore({
-    dataPath: window.__kumologica.settings.projectDir,
-  });
+  window.__kumologica.settings.kumohubConfig =
+    new KumohubConfig.KumohubConfigStore({
+      dataPath: window.__kumologica.settings.projectDir,
+    });
 
   window.__kumologica.settings.azureConfig = new AzureConfig.AzureConfigStore({
     dataPath: window.__kumologica.settings.projectDir,
@@ -95,30 +96,31 @@ function loadConfigs() {
     dataPath: window.__kumologica.settings.projectDir,
   });
 
-  window.__kumologica.settings.projectInfoConfig = new ProjectInfoConfig.ProjectInfoConfigStore({
-    dataPath: window.__kumologica.settings.projectDir,
-  });
+  window.__kumologica.settings.projectInfoConfig =
+    new ProjectInfoConfig.ProjectInfoConfigStore({
+      dataPath: window.__kumologica.settings.projectDir,
+    });
 }
 
 function deploy(projectInfo, params) {
-  const alias = cloudConfigStore.getAWSAliasInfo(window.__kumologica.cloud.profile);
+  const alias = cloudConfigStore.getAWSAliasInfo(
+    window.__kumologica.cloud.profile
+  );
 
   return awsDeployer.deploy(projectInfo, params, alias.profile);
 }
 
 async function kumohubBuild(projectInfo) {
-  const { build } = require('@kumologica/builder');
+  const { build } = require("@kumologica/builder");
   const params = {
     "project-directory": projectInfo.projectDir,
     "flow-file-name": projectInfo.projectFlowName,
-    "zip-file-name": "lambda.zip"
-  }
-
-  build('kumohub', params, terminalEmitter);  // default options
+    "zip-file-name": "lambda.zip",
+  };
 
+  build("kumohub", params, terminalEmitter); // default options
 }
 async function kumohubDeploy(projectInfo, params) {
-
   const alias = cloudConfigStore.getKumohubAliasInfo(params.profile);
 
   params.username = alias.username;
@@ -127,7 +129,7 @@ async function kumohubDeploy(projectInfo, params) {
   params["flow-file-name"] = projectInfo.projectFlowName;
   params["project-directory"] = projectInfo.projectDir;
 
-  return await deployCli.deploy('kumohub', params, terminalEmitter);
+  return await deployCli.deploy("kumohub", params, terminalEmitter);
 }
 
 async function azureDeploy(projectInfo, params) {
@@ -138,42 +140,34 @@ async function azureDeploy(projectInfo, params) {
 }
 
 async function generateScript(provider, projectInfo, params) {
-  const alias = cloudConfigStore.getAWSAliasInfo(window.__kumologica.cloud.profile);
+  const alias = cloudConfigStore.getAWSAliasInfo(
+    window.__kumologica.cloud.profile
+  );
 
   if (provider == window.__kumologica.cloud.provider.aws) {
-    await awsDeployer.generateScript(
-      projectInfo,
-      params,
-      alias.profile
-    );
+    await awsDeployer.generateScript(projectInfo, params, alias.profile);
   } else if (provider == window.__kumologica.cloud.provider.serverless) {
-    await serverlessDeployer.generateScript(
-      projectInfo,
-      params,
-      alias.profile
-    );
+    await serverlessDeployer.generateScript(projectInfo, params, alias.profile);
   } else if (provider == window.__kumologica.cloud.provider.github) {
-    await githubDeployer.generateScript(
-      projectInfo,
-      params,
-      alias.profile
-    );
+    await githubDeployer.generateScript(projectInfo, params, alias.profile);
   }
 }
 
 async function listServices(type) {
-  const alias = cloudConfigStore.getAWSAliasInfo(window.__kumologica.cloud.profile);
+  const alias = cloudConfigStore.getAWSAliasInfo(
+    window.__kumologica.cloud.profile
+  );
 
   let lServices = await awsDeployer.listServices(type, alias.profile);
   return lServices;
 }
 
 function hasJsonStructure(str) {
-  if (typeof str !== 'string') return false;
+  if (typeof str !== "string") return false;
   try {
     const result = JSON.parse(str);
     const type = Object.prototype.toString.call(result);
-    return type === '[object Object]' || type === '[object Array]';
+    return type === "[object Object]" || type === "[object Array]";
   } catch (err) {
     return false;
   }
@@ -189,10 +183,9 @@ async function getRegion(profile) {
 }
 
 async function testFlow(testEvent, targetNode, environmentVariables) {
-
   let event;
 
-  targetNode = targetNode || '*';
+  targetNode = targetNode || "*";
   try {
     // TODO:  we should check not only if data is json parsable, but also if it is well-formed JSON structure
     // Eg. 1234, "hello world"
@@ -203,13 +196,13 @@ async function testFlow(testEvent, targetNode, environmentVariables) {
     throw err;
   }
 
-  headers = { ...headers, 'x-kumologica-testcasenode': targetNode };
+  headers = { ...headers, "x-kumologica-testcasenode": targetNode };
 
   if (environmentVariables) {
     if (Object.keys(environmentVariables).length > 0) {
       headers = {
         ...headers,
-        'x-kumologica-aws-env': JSON.stringify(environmentVariables),
+        "x-kumologica-aws-env": JSON.stringify(environmentVariables),
       };
     }
   }
@@ -217,53 +210,71 @@ async function testFlow(testEvent, targetNode, environmentVariables) {
   if (environmentVariables && environmentVariables["AWS_PROFILE"]) {
     headers = {
       ...headers,
-      'x-kumologica-aws-profile': environmentVariables["AWS_PROFILE"],
+      "x-kumologica-aws-profile": environmentVariables["AWS_PROFILE"],
     };
 
     const region = await new AWSProfile().getRegion(
       environmentVariables["AWS_PROFILE"]
     );
 
-    headers = { ...headers, 'x-kumologica-aws-region': region };
+    headers = { ...headers, "x-kumologica-aws-region": region };
   } else {
-    terminalEmitter.emit('terminal-output', " ");
-    terminalEmitter.emit('terminal-output', "AWS_PROFILE property not defined on test tab, default aws cli precedence will be used.");
-    terminalEmitter.emit('terminal-output', "For details see: https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html");
-    terminalEmitter.emit('terminal-output', " ");
-    terminalEmitter.emit('terminal-output', "Your environment variables:");
-    terminalEmitter.emit('terminal-output', `  AWS_PROFILE: ${process.env.AWS_PROFILE}`);
-    terminalEmitter.emit('terminal-output', `  AWS_REGION: ${process.env.AWS_REGION}`);
-    terminalEmitter.emit('terminal-output', `  AWS_ACCESS_KEY_ID: ${process.env.AWS_ACCESS_KEY_ID}`);
-    terminalEmitter.emit('terminal-output', `  AWS_SECRET_ACCESS_KEY: ${process.env.AWS_SECRET_ACCESS_KEY}`);
-    terminalEmitter.emit('terminal-output', " ");
+    terminalEmitter.emit("terminal-output", " ");
+    terminalEmitter.emit(
+      "terminal-output",
+      "AWS_PROFILE property not defined on test tab, default aws cli precedence will be used."
+    );
+    terminalEmitter.emit(
+      "terminal-output",
+      "For details see: https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html"
+    );
+    terminalEmitter.emit("terminal-output", " ");
+    terminalEmitter.emit("terminal-output", "Your environment variables:");
+    terminalEmitter.emit(
+      "terminal-output",
+      `  AWS_PROFILE: ${process.env.AWS_PROFILE}`
+    );
+    terminalEmitter.emit(
+      "terminal-output",
+      `  AWS_REGION: ${process.env.AWS_REGION}`
+    );
+    terminalEmitter.emit(
+      "terminal-output",
+      `  AWS_ACCESS_KEY_ID: ${process.env.AWS_ACCESS_KEY_ID}`
+    );
+    terminalEmitter.emit(
+      "terminal-output",
+      `  AWS_SECRET_ACCESS_KEY: ${process.env.AWS_SECRET_ACCESS_KEY}`
+    );
+    terminalEmitter.emit("terminal-output", " ");
   }
-  console.log('[preload] Invoking the testFlow...');
+  console.log("[preload] Invoking the testFlow...");
   try {
     let resp = await requestAsync({
       uri: `http://127.0.0.1:${port}/`,
-      method: 'POST',
+      method: "POST",
       headers: headers,
       body: event,
       json: true,
     });
-    console.log('[preload] Response:', resp.body);
+    console.log("[preload] Response:", resp.body);
     return resp;
   } catch (err) {
-    console.log('[preload] Request end with errors...', e);
+    console.log("[preload] Request end with errors...", e);
     throw e;
   }
 }
 
-/** 
+/**
  * Debugger API Client endpoints
  */
 
 async function addBreakpoint(id) {
-  const url = `${DESIGNER_DEBUGGER_URL}/add-breakpoint/${id}`
+  const url = `${DESIGNER_DEBUGGER_URL}/add-breakpoint/${id}`;
 
   let options = {
     uri: url,
-    method: 'GET',
+    method: "GET",
     json: true,
   };
 
@@ -275,7 +286,7 @@ async function addBreakpoint(id) {
       console.log(
         `Received a "${statusCode}" from Kumologica Node Library host`
       );
-      return '';
+      return "";
     }
   } catch (err) {
     throw err;
@@ -283,11 +294,11 @@ async function addBreakpoint(id) {
 }
 
 async function removeAllBreakpoints() {
-  const url = `${DESIGNER_DEBUGGER_URL}/remove-all-breakpoints`
+  const url = `${DESIGNER_DEBUGGER_URL}/remove-all-breakpoints`;
 
   let options = {
     uri: url,
-    method: 'GET',
+    method: "GET",
     json: true,
   };
 
@@ -296,15 +307,14 @@ async function removeAllBreakpoints() {
   } catch (err) {
     throw err;
   }
-
 }
 
 async function isBreakpointFound(id) {
-  const url = `${DESIGNER_DEBUGGER_URL}/contains-breakpoint/${id}`
+  const url = `${DESIGNER_DEBUGGER_URL}/contains-breakpoint/${id}`;
 
   let options = {
     uri: url,
-    method: 'GET',
+    method: "GET",
     json: true,
   };
 
@@ -313,15 +323,14 @@ async function isBreakpointFound(id) {
   } catch (err) {
     throw err;
   }
-
 }
 
 async function toggleBreakpoint(id) {
-  const url = `${DESIGNER_DEBUGGER_URL}/toggle-breakpoint/${id}`
+  const url = `${DESIGNER_DEBUGGER_URL}/toggle-breakpoint/${id}`;
 
   let options = {
     uri: url,
-    method: 'GET',
+    method: "GET",
     json: true,
   };
 
@@ -330,15 +339,14 @@ async function toggleBreakpoint(id) {
   } catch (err) {
     throw err;
   }
-
 }
 
 async function enableDebugger() {
-  const url = `${DESIGNER_DEBUGGER_URL}/enable`
+  const url = `${DESIGNER_DEBUGGER_URL}/enable`;
 
   let options = {
     uri: url,
-    method: 'GET',
+    method: "GET",
     json: true,
   };
 
@@ -349,13 +357,12 @@ async function enableDebugger() {
   }
 }
 
-
 async function listBreakpoints() {
-  const url = `${DESIGNER_DEBUGGER_URL}/list-breakpoints`
+  const url = `${DESIGNER_DEBUGGER_URL}/list-breakpoints`;
 
   let options = {
     uri: url,
-    method: 'GET',
+    method: "GET",
     json: true,
   };
 
@@ -367,11 +374,11 @@ async function listBreakpoints() {
 }
 
 async function redrawBreakpoints() {
-  const url = `${DESIGNER_DEBUGGER_URL}/redraw-breakpoints`
+  const url = `${DESIGNER_DEBUGGER_URL}/redraw-breakpoints`;
 
   let options = {
     uri: url,
-    method: 'GET',
+    method: "GET",
     json: true,
   };
 
@@ -383,11 +390,11 @@ async function redrawBreakpoints() {
 }
 
 async function disableDebugger() {
-  const url = `${DESIGNER_DEBUGGER_URL}/disable`
+  const url = `${DESIGNER_DEBUGGER_URL}/disable`;
 
   let options = {
     uri: url,
-    method: 'GET',
+    method: "GET",
     json: true,
   };
 
@@ -399,11 +406,11 @@ async function disableDebugger() {
 }
 
 async function continueDebugger() {
-  const url = `${DESIGNER_DEBUGGER_URL}/continue`
+  const url = `${DESIGNER_DEBUGGER_URL}/continue`;
 
   let options = {
     uri: url,
-    method: 'GET',
+    method: "GET",
     json: true,
   };
 
@@ -415,11 +422,11 @@ async function continueDebugger() {
 }
 
 async function stopDebugger() {
-  const url = `${DESIGNER_DEBUGGER_URL}/stop`
+  const url = `${DESIGNER_DEBUGGER_URL}/stop`;
 
   let options = {
     uri: url,
-    method: 'GET',
+    method: "GET",
     json: true,
   };
 
@@ -431,11 +438,11 @@ async function stopDebugger() {
 }
 
 async function nextDebugger() {
-  const url = `${DESIGNER_DEBUGGER_URL}/next`
+  const url = `${DESIGNER_DEBUGGER_URL}/next`;
 
   let options = {
     uri: url,
-    method: 'GET',
+    method: "GET",
     json: true,
   };
 
@@ -447,11 +454,11 @@ async function nextDebugger() {
 }
 
 async function terminateDebugger() {
-  const url = `${DESIGNER_DEBUGGER_URL}/terminate`
+  const url = `${DESIGNER_DEBUGGER_URL}/terminate`;
 
   let options = {
     uri: url,
-    method: 'GET',
+    method: "GET",
     json: true,
   };
 
@@ -470,14 +477,14 @@ async function fetchAvailableNodes() {
 
   let options = {
     uri: KUMOLOGICA_NODE_LIB_URL,
-    method: 'GET',
+    method: "GET",
     json: true,
   };
 
   // Inject proxy header if required
   let proxyHeader = RED.uiSettings.getProxyHeader();
   if (proxyHeader) {
-    options.proxy = proxyHeader
+    options.proxy = proxyHeader;
   }
 
   try {
@@ -528,11 +535,11 @@ function kumohubIsLoggedIn(profile) {
 function validateAlias(alias) {
   let msg = undefined;
   if (!alias.username) {
-    msg = 'Invalid kumohub profile, missing username.';
+    msg = "Invalid kumohub profile, missing username.";
   } else if (!alias.password) {
-    msg = 'Invalid kumohub profile, missing password.';
+    msg = "Invalid kumohub profile, missing password.";
   } else if (!alias.subscription) {
-    msg = 'Invalid kumohub profile, missing subscription';
+    msg = "Invalid kumohub profile, missing subscription";
   }
 
   if (msg) {
@@ -563,25 +570,104 @@ function dispatch(type, payload) {
   ipcRenderer.send(type, payload);
 }
 
+function includeNodePathIntoPath() {
+  // Include the node_path into the path, otherwise the npm wont be found if dynamically exported
+  if (process.env.NODE_PATH) {
+    const shellEnvSeparator = process.platform === "win32" ? ";" : ":";
+    return process.env.NODE_PATH + shellEnvSeparator + process.env.PATH;
+  } else {
+    return process.env.PATH;
+  }
+}
+
+async function npmInstall(dependency) {
+  return new Promise((resolve, reject) => {
+    window.__kumologica.editor.terminal.eventEmitter.emit(
+      "terminal-output",
+      `Running ${dependency} in directory: ${window.__kumologica.settings.projectDir}...`
+    );
+
+    // Break the dependency (string) into command + args
+    const parts = dependency.trim().split(" ");
+    let command = parts[0];
+    const args = parts.slice(1);
+
+    const child = spawn(command, args, {
+      cwd: window.__kumologica.settings.projectDir,
+      env: {
+        ...process.env,
+        PATH: includeNodePathIntoPath(),
+      },
+      shell: true,
+    });
+
+    // Stream stdout data
+    child.stdout.on("data", (data) => {
+      window.__kumologica.editor.terminal.eventEmitter.emit(
+        "terminal-output",
+        data.toString()
+      );
+    });
+
+    // Stream stderr data
+    child.stderr.on("data", (data) => {
+      window.__kumologica.editor.terminal.eventEmitter.emit(
+        "terminal-output",
+        data.toString()
+      );
+    });
+
+    // Handle process exit
+    child.on("close", (code) => {
+      console.log("preload: close with code:", code);
+
+      if (code !== 0) {
+        let message =
+          code === 127
+            ? `The task failed with exit code ${code}. Please ensure that the NODE_PATH environment variable is correctly set and exported in your system's environment.`
+            : `The task failed with exit code ${code}`;
+
+        window.__kumologica.editor.terminal.eventEmitter.emit(
+          "terminal-output",
+          `❌ Error: ${message}`
+        );
+        reject(new Error(message));
+      } else {
+        window.__kumologica.editor.terminal.eventEmitter.emit(
+          "terminal-output",
+          `✅ Done.`
+        );
+        resolve();
+      }
+    });
+
+    // Handle execution errors
+    child.on("error", (error) => {
+      window.__kumologica.editor.terminal.eventEmitter.emit(
+        "terminal-output",
+        `Error: ${error.message}`
+      );
+    });
+  });
+}
 
 window.__kumologica = {};
 window.__kumologica.electron = electron;
 window.__kumologica.electron.remote = remote;
 
-
 // Present a contract to interact with main process
 window.__kumologica.main = {};
 window.__kumologica.main.dispatch = dispatch;
 
 // Present a contract to interact with editor project (itself)
 window.__kumologica.editor = {};
-window.__kumologica.editor.runner = require('./ui/editor-api/lib/runner');
+window.__kumologica.editor.runner = require("./ui/editor-api/lib/runner");
 
 // terminal section
 window.__kumologica.editor.terminal = {};
 window.__kumologica.editor.terminal.opts = {
   fontSize: 13,
-  fontFamily: 'Ubuntu Mono, courier-new, courier, monospace',
+  fontFamily: "Ubuntu Mono, courier-new, courier, monospace",
 };
 window.__kumologica.editor.terminal.Terminal = Terminal;
 window.__kumologica.editor.terminal.FitAddon = FitAddon;
@@ -594,13 +680,13 @@ window.__kumologica.settings.loadConfigs = loadConfigs;
 
 window.__kumologica.settings.cloudConfigStore = cloudConfigStore;
 window.__kumologica.settings.networkConfigStore = networkConfigStore;
-window.__kumologica.settings.workspacePreferenceStore = new WorkspacePreferenceStore();
+window.__kumologica.settings.workspacePreferenceStore =
+  new WorkspacePreferenceStore();
 
 window.__kumologica.settings.platform = {};
-window.__kumologica.settings.platform.isMac = process.platform === 'darwin';
-window.__kumologica.settings.platform.isWindows = process.platform === 'win32';
-window.__kumologica.settings.platform.isLinux = process.platform === 'linux';
-
+window.__kumologica.settings.platform.isMac = process.platform === "darwin";
+window.__kumologica.settings.platform.isWindows = process.platform === "win32";
+window.__kumologica.settings.platform.isLinux = process.platform === "linux";
 
 // Present a contract to interact with runtime project
 window.__kumologica.runtime = {};
@@ -643,7 +729,7 @@ window.__kumologica.azure.deploy = azureDeploy;
 // Expose utilities and extra libs
 window.__kumologica.libs = {};
 window.__kumologica.libs.debounce = debounce;
-window.__kumologica.libs.path = require('path');
+window.__kumologica.libs.path = require("path");
 window.__kumologica.libs.testFlow = testFlow;
 window.__kumologica.libs.openFileOnEditor = openFileOnEditor;
 window.__kumologica.libs.openFolder = openFolder;
@@ -655,8 +741,8 @@ window.__kumologica.libs.openAIClient = openAIClient;
 
 /**
  * Return the name of the valid kumologica flow or undefined otherwise.
- * @param {} projectDir 
- * @returns 
+ * @param {} projectDir
+ * @returns
  */
 function findValidKumologicaFlowInDir(projectDir) {
   return codegen.findFlowFile(projectDir);
@@ -686,6 +772,6 @@ window.__kumologica.debugger.terminate = terminateDebugger;
 window.__kumologica.debugger.next = nextDebugger;
 window.__kumologica.debugger.stop = stopDebugger;
 
-
-
-
+// Commands
+window.__kumologica.command = {};
+window.__kumologica.command.npmInstall = npmInstall;