@nlxai/cli 1.2.4 → 1.2.6

package/README.md

@@ -41,6 +41,10 @@ Commands:
   data-requests                          Data Requests
   data-requests sync [opts] <input>      Sync Data Requests from an OpenAPI Specification or Swagger
   test [options] <applicationId>         Run conversation tests for a given application ID
+  code                                   Work with code nodes in NLX flows
+  code init                              Initialize local folders for flows with code nodes
+  code pull [options]                    Pull code nodes from a flow into local files
+  code push [options]                    Push local code node files to NLX flow
   http [options] <method> <path> [body]  Perform an authenticated request to the management API
   help [command]                         display help for command
 
@@ -94,6 +98,22 @@ Transcript:
     └───────┘
 
 Debug at:  https://dev.platform.nlx.ai/flows/SimpleCarousel
+
+
+> nlx code init
+ℹ Fetching available flows...
+✔ Select flows to initialize: ChattyKathy
+✔ Created folder ChattyKathy
+ℹ Fetching flow from conversationTrees/ChattyKathy-Omni
+✔ Created/Updated 74af8e42-4c30-4ce0-aaec-bb2b155f2f95.js
+
+> cd ChattyKathy
+
+> echo "export default async (input, system) => { console.log('Hello world'); }" > 74af8e42-4c30-4ce0-aaec-bb2b155f2f95.js
+
+> nlx code push
+✔ Updated code for node 74af8e42-4c30-4ce0-aaec-bb2b155f2f95
+✔ Pushed 1 code node(s) to flow.
 ```
 
 ## Running in CI

package/lib/commands/code/index.js

@@ -0,0 +1,9 @@
+import { Command } from "commander";
+import { pullCommand } from "./pull.js";
+import { pushCommand } from "./push.js";
+import { initCommand } from "./init.js";
+export const codeCommand = new Command("code")
+    .description("Work with code nodes in NLX flows")
+    .addCommand(initCommand)
+    .addCommand(pullCommand)
+    .addCommand(pushCommand);

package/lib/commands/code/init.js

@@ -0,0 +1,42 @@
+import { fetchManagementApiPaginated, } from "../../utils/index.js";
+import { consola } from "consola";
+import { checkbox } from "@inquirer/prompts";
+import * as fs from "fs";
+import { pull } from "./pull.js";
+import { Command } from "commander";
+export default async function init() {
+    consola.info("Fetching available flows...");
+    const flows = await fetchManagementApiPaginated("conversationTrees");
+    // Filter flows with code nodes
+    const codeFlows = new Set();
+    for (const flow of flows) {
+        if (flow.nodes &&
+            Object.values(flow.nodes).some((node) => node.type === "code")) {
+            codeFlows.add(flow.intentId);
+        }
+    }
+    if (codeFlows.size === 0) {
+        consola.info("No flows with code nodes found.");
+        return;
+    }
+    // Interactive selection
+    const selected = await checkbox({
+        message: "Select flows to initialize:",
+        choices: Array.from(codeFlows).map((f) => ({ value: f, name: f })),
+    });
+    for (const flowId of selected) {
+        if (fs.existsSync(flowId)) {
+            consola.info(`Folder ${flowId} already exists. Skipping.`);
+            continue;
+        }
+        fs.mkdirSync(flowId);
+        consola.success(`Created folder ${flowId}`);
+        // Run pull in new folder
+        process.chdir(flowId);
+        await pull({ flowId });
+        process.chdir("..");
+    }
+}
+export const initCommand = new Command("init")
+    .description("Initialize local folders for flows with code nodes")
+    .action(init);

package/lib/commands/code/pull.js

@@ -0,0 +1,86 @@
+import { Command } from "commander";
+import { fetchManagementApi } from "../../utils/index.js";
+import { consola } from "consola";
+import * as fs from "fs";
+import * as path from "path";
+import { tmpdir } from "os";
+import { execSync } from "child_process";
+// Helper: get current folder name
+function getCurrentFolderName() {
+    return path.basename(process.cwd());
+}
+export async function pull({ flowId, force, interactive } = {}) {
+    const id = flowId || getCurrentFolderName();
+    const endpoint = `conversationTrees/${id}-Omni`;
+    consola.info(`Fetching flow from ${endpoint}`);
+    const flow = await fetchManagementApi(endpoint);
+    if (!flow.nodes) {
+        consola.error("No nodes found in flow.");
+        process.exit(1);
+    }
+    let codeNodeCount = 0;
+    for (const nodeId in flow.nodes) {
+        const node = flow.nodes[nodeId];
+        if (node.type === "code" && node.metadata?.code?.code) {
+            codeNodeCount++;
+            const fileName = `${nodeId}.js`;
+            if (fs.existsSync(fileName)) {
+                const existing = fs.readFileSync(fileName, "utf8");
+                if (existing.trim() === node.metadata.code.code.trim()) {
+                    consola.info(`File ${fileName} already up to date.`);
+                    continue;
+                }
+                if (interactive) {
+                    // Write remote code to temp file
+                    const tempFile = path.join(tmpdir(), `${nodeId}-remote.js`);
+                    let content = "";
+                    if (node.metadata?.name) {
+                        content += `// ${node.metadata.name}\n`;
+                    }
+                    content += node.metadata.code.code;
+                    if (existing.trim() === content.trim()) {
+                        consola.info(`File ${fileName} already up to date.`);
+                        continue;
+                    }
+                    fs.writeFileSync(tempFile, content);
+                    const mergeTool = process.env.NLX_CODE_MERGE_TOOL || "vimdiff";
+                    consola.info(`Launching merge tool (${mergeTool}) for ${fileName}...`);
+                    try {
+                        execSync(`${mergeTool} ${fileName} ${tempFile}`, {
+                            stdio: "inherit",
+                        });
+                        consola.success(`Merge completed for ${fileName}`);
+                    }
+                    catch (err) {
+                        consola.error(`Merge tool failed for ${fileName}:`, err);
+                    }
+                    fs.unlinkSync(tempFile);
+                    continue;
+                }
+                else if (force) {
+                    consola.warn(`Overwriting ${fileName} without prompting.`);
+                }
+                else {
+                    consola.error(`File ${fileName} already exists. Skipping.`);
+                    continue;
+                }
+            }
+            let content = "";
+            if (node.metadata?.name) {
+                content += `// ${node.metadata.name}\n`;
+            }
+            content += node.metadata.code.code;
+            fs.writeFileSync(fileName, content);
+            consola.success(`Created/Updated ${fileName}`);
+        }
+    }
+    if (codeNodeCount === 0) {
+        consola.info("No code nodes found.");
+    }
+}
+export const pullCommand = new Command("pull")
+    .description("Pull code nodes from a flow")
+    .option("--flow <flowId>", "Specify flow ID (default: current folder name)")
+    .option("-f, --force", "Overwrite existing files without prompting", false)
+    .option("-i, --interactive", "Use git mergetool for interactive merge", false)
+    .action(pull);

package/lib/commands/code/push.js

@@ -0,0 +1,55 @@
+import { fetchManagementApi } from "../../utils/index.js";
+import { consola } from "consola";
+import * as fs from "fs";
+import * as path from "path";
+function getCurrentFolderName() {
+    return path.basename(process.cwd());
+}
+export async function push({ flowId } = {}) {
+    const id = flowId || getCurrentFolderName();
+    const endpoint = `conversationTrees/${id}-Omni`;
+    const flow = await fetchManagementApi(endpoint);
+    if (!flow.nodes) {
+        consola.error("No nodes found in flow.");
+        process.exit(1);
+    }
+    let updated = 0;
+    for (const nodeId in flow.nodes) {
+        const node = flow.nodes[nodeId];
+        if (node.type === "code" && node.metadata?.code?.code) {
+            const fileName = `${nodeId}.js`;
+            if (!fs.existsSync(fileName)) {
+                consola.warn(`File ${fileName} does not exist. Skipping.`);
+                continue;
+            }
+            let localCode = fs.readFileSync(fileName, "utf8");
+            // Remove leading comment if present and matches node name
+            const lines = localCode.split("\n");
+            if (node.metadata?.name &&
+                lines[0].trim() === `// ${node.metadata.name}`) {
+                localCode = lines.slice(1).join("\n");
+            }
+            if (localCode.trim() === node.metadata.code.code.trim()) {
+                consola.info(`Code for ${nodeId} is already up to date.`);
+                continue;
+            }
+            // Update node code
+            node.metadata.code.code = localCode;
+            updated++;
+            consola.success(`Updated code for node ${nodeId}`);
+        }
+    }
+    if (updated > 0) {
+        // Push updated flow
+        await fetchManagementApi(endpoint, "POST", flow);
+        consola.success(`Pushed ${updated} code node(s) to flow.`);
+    }
+    else {
+        consola.info("No code changes to push.");
+    }
+}
+import { Command } from "commander";
+export const pushCommand = new Command("push")
+    .description("Push local code node files to NLX flow")
+    .option("--flow <flowId>", "Specify flow ID (default: current folder name)")
+    .action(push);

package/lib/commands/http.js

@@ -1,6 +1,6 @@
 import { Command } from "commander";
 import * as fs from "fs";
-import { fetchManagementApi } from "../utils/index.js";
+import { fetchManagementApi, fetchManagementApiPaginated, } from "../utils/index.js";
 import { consola } from "consola";
 export const httpCommand = new Command("http")
     .description("Perform an authenticated request to the management API")
@@ -38,23 +38,12 @@ export const httpCommand = new Command("http")
             process.exit(1);
         }
     }
-    let result = await fetchManagementApi(apiPath +
-        (opts.paginate
-            ? apiPath.includes("?")
-                ? "&size=1000"
-                : "?size=1000"
-            : ""), method.toUpperCase(), body);
-    let agg;
+    let result;
     if (opts.paginate) {
-        const key = Object.keys(result).filter((k) => k !== "nextPageId")[0];
-        agg = result[key];
-        while (result.nextPageId) {
-            result = await fetchManagementApi(apiPath + `?pageId=${result.nextPageId}`, method.toUpperCase(), body);
-            agg.push(...result[key]);
-        }
+        result = await fetchManagementApiPaginated(apiPath);
     }
     else {
-        agg = result;
+        result = await fetchManagementApi(apiPath, method.toUpperCase(), body);
     }
-    console.log(JSON.stringify(agg, null, 2));
+    console.log(JSON.stringify(result, null, 2));
 });

package/lib/index.js

@@ -4,6 +4,7 @@ import { modalitiesCommand } from "./commands/modalities/index.js";
 import { dataRequestsCommand } from "./commands/data-requests/index.js";
 import { httpCommand } from "./commands/http.js";
 import { testCommand } from "./commands/test.js";
+import { codeCommand } from "./commands/code/index.js";
 import { consola } from "consola";
 import { readFileSync } from "fs";
 import { resolve } from "path";
@@ -22,5 +23,6 @@ program.addCommand(authCommand);
 program.addCommand(modalitiesCommand);
 program.addCommand(dataRequestsCommand);
 program.addCommand(testCommand);
+program.addCommand(codeCommand);
 program.addCommand(httpCommand);
 program.parse(process.argv);

package/lib/utils/index.js

@@ -20,6 +20,17 @@ export const fetchManagementApi = async (path, method = "GET", body) => {
     consola.debug("Response:", JSON.stringify(result));
     return result;
 };
+export const fetchManagementApiPaginated = async (path) => {
+    let result = await fetchManagementApi(path + (path.includes("?") ? "&size=1000" : "?size=1000"));
+    let agg;
+    const key = Object.keys(result).filter((k) => k !== "nextPageId")[0];
+    agg = result[key];
+    while (result.nextPageId) {
+        result = await fetchManagementApi(path + `?page=${result.nextPageId}`);
+        agg.push(...result[key]);
+    }
+    return agg;
+};
 export const singleton = (fn) => {
     let running = null;
     return async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nlxai/cli",
-  "version": "1.2.4",
+  "version": "1.2.6",
   "description": "Tools for integrating with NLX apps",
   "keywords": [
     "NLX",
@@ -34,7 +34,7 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^7.8.4",
-    "@nlxai/core": "^1.2.4",
+    "@nlxai/core": "^1.2.6",
     "boxen": "^8.0.1",
     "chalk": "^4.1.0",
     "commander": "^14.0",
@@ -58,5 +58,5 @@
     "@vitest/ui": "^3.2.4",
     "vitest": "^3.2.4"
   },
-  "gitHead": "bbfa1fad3f009a0f509903d6db4f51bec17b1f6c"
+  "gitHead": "fb9a0b00ca2184fb69ffd1e11e8f55d30fe1d85e"
 }