@powerformer/refly-cli 0.1.18 → 0.1.20

package/dist/bin/refly.js

@@ -989,7 +989,7 @@ var require_command = __commonJS({
     init_cjs_shims();
     var EventEmitter = require("events").EventEmitter;
     var childProcess2 = require("child_process");
-    var path23 = require("path");
+    var path22 = require("path");
     var fs27 = require("fs");
     var process8 = require("process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
@@ -1922,9 +1922,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path23.resolve(baseDir, baseName);
+          const localBin = path22.resolve(baseDir, baseName);
           if (fs27.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path23.extname(baseName))) return void 0;
+          if (sourceExt.includes(path22.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
             (ext) => fs27.existsSync(`${localBin}${ext}`)
           );
@@ -1942,17 +1942,17 @@ Expecting one of '${allowedValues.join("', '")}'`);
           } catch (err) {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path23.resolve(
-            path23.dirname(resolvedScriptPath),
+          executableDir = path22.resolve(
+            path22.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path23.basename(
+            const legacyName = path22.basename(
               this._scriptPath,
-              path23.extname(this._scriptPath)
+              path22.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -1963,7 +1963,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path23.extname(executableFile));
+        launchWithNode = sourceExt.includes(path22.extname(executableFile));
         let proc;
         if (process8.platform !== "win32") {
           if (launchWithNode) {
@@ -2803,7 +2803,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path23.basename(filename, path23.extname(filename));
+        this._name = path22.basename(filename, path22.extname(filename));
         return this;
       }
       /**
@@ -2817,9 +2817,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path24) {
-        if (path24 === void 0) return this._executableDir;
-        this._executableDir = path24;
+      executableDir(path23) {
+        if (path23 === void 0) return this._executableDir;
+        this._executableDir = path23;
         return this;
       }
       /**
@@ -4894,7 +4894,7 @@ var ErrorCodes = {
 
 // src/bin/refly.ts
 var fs26 = __toESM(require("fs"));
-var path22 = __toESM(require("path"));
+var path21 = __toESM(require("path"));
 
 // src/commands/init.ts
 init_cjs_shims();
@@ -5399,8 +5399,8 @@ function getErrorMap() {
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/parseUtil.js
 init_cjs_shims();
 var makeIssue = (params) => {
-  const { data, path: path23, errorMaps, issueData } = params;
-  const fullPath = [...path23, ...issueData.path || []];
+  const { data, path: path22, errorMaps, issueData } = params;
+  const fullPath = [...path22, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -5520,11 +5520,11 @@ var errorUtil;
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path23, key) {
+  constructor(parent, value, path22, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path23;
+    this._path = path22;
     this._key = key;
   }
   get path() {
@@ -9886,10 +9886,10 @@ var NetworkError = class extends CLIError {
 // src/api/client.ts
 init_logger();
 var DEFAULT_TIMEOUT = 3e4;
-async function apiRequest(path23, options = {}) {
+async function apiRequest(path22, options = {}) {
   const { method = "GET", body, query, timeout = DEFAULT_TIMEOUT, requireAuth = true } = options;
   const endpoint = getApiEndpoint();
-  let url = `${endpoint}${path23}`;
+  let url = `${endpoint}${path22}`;
   if (query && Object.keys(query).length > 0) {
     const params = new URLSearchParams(query);
     url = `${url}?${params.toString()}`;
@@ -9927,7 +9927,7 @@ async function apiRequest(path23, options = {}) {
   const controller = new AbortController();
   const timeoutId = setTimeout(() => controller.abort(), timeout);
   try {
-    logger.debug(`API Request: ${method} ${path23}`);
+    logger.debug(`API Request: ${method} ${path22}`);
     const response = await fetch(url, {
       method,
       headers,
@@ -10042,10 +10042,10 @@ function mapAPIError(status, response) {
   }
   return new CLIError(errCode, errMsg);
 }
-async function apiRequestStream(path23, options = {}) {
+async function apiRequestStream(path22, options = {}) {
   const { timeout = 3e5 } = options;
   const endpoint = getApiEndpoint();
-  const url = `${endpoint}${path23}`;
+  const url = `${endpoint}${path22}`;
   const headers = {
     "User-Agent": "refly-cli/0.1.0"
   };
@@ -10076,7 +10076,7 @@ async function apiRequestStream(path23, options = {}) {
   const controller = new AbortController();
   const timeoutId = setTimeout(() => controller.abort(), timeout);
   try {
-    logger.debug(`API Stream Request: GET ${path23}`);
+    logger.debug(`API Stream Request: GET ${path22}`);
     const response = await fetch(url, {
       method: "GET",
       headers,
@@ -10750,7 +10750,7 @@ var import_node_child_process6 = require("child_process");
 var import_node_fs5 = __toESM(require("fs"));
 init_logger();
 init_paths();
-var CLI_VERSION = "0.1.18";
+var CLI_VERSION = "0.1.20";
 var NPM_TAG = "test";
 function compareSemver(a, b) {
   const parseVersion = (v) => {
@@ -11006,16 +11006,16 @@ configCommand.action(() => {
   };
   ok("config", safeConfig);
 });
-function getNestedValue(obj, path23) {
-  return path23.split(".").reduce((current, key) => {
+function getNestedValue(obj, path22) {
+  return path22.split(".").reduce((current, key) => {
     if (current && typeof current === "object" && key in current) {
       return current[key];
     }
     return void 0;
   }, obj);
 }
-function setNestedValue(obj, path23, value) {
-  const keys = path23.split(".");
+function setNestedValue(obj, path22, value) {
+  const keys = path22.split(".");
   const lastKey = keys.pop();
   let current = obj;
   for (const key of keys) {
@@ -11386,7 +11386,7 @@ var workflowDeleteCommand = new Command("delete").description("Delete a workflow
 init_cjs_shims();
 var readline2 = __toESM(require("readline/promises"));
 var import_node_process8 = require("process");
-var path10 = __toESM(require("path"));
+var path9 = __toESM(require("path"));
 
 // src/utils/prompt.ts
 init_cjs_shims();
@@ -11436,34 +11436,87 @@ async function promptForFilePath(variableName, resourceTypes, isRequired) {
 
 // src/utils/file-type.ts
 init_cjs_shims();
-var path9 = __toESM(require("path"));
+var CODE_FILE_EXTENSIONS = [
+  // TypeScript/JavaScript
+  "ts",
+  "tsx",
+  "js",
+  "jsx",
+  "mjs",
+  "cjs",
+  // Web
+  "css",
+  "scss",
+  "sass",
+  "less",
+  // Other programming languages
+  "py",
+  "java",
+  "c",
+  "cpp",
+  "h",
+  "hpp",
+  "cs",
+  "go",
+  "rs",
+  "rb",
+  "php",
+  "swift",
+  "kt",
+  "scala",
+  "sh",
+  "bash",
+  "zsh",
+  // Config files
+  "json",
+  "yaml",
+  "yml",
+  "toml",
+  "xml",
+  "ini",
+  "env",
+  // Text and document files
+  "txt",
+  "md",
+  "markdown"
+];
 var IMAGE_EXTENSIONS = ["jpg", "jpeg", "png", "gif", "webp", "svg", "bmp", "ico", "tiff", "tif"];
 var VIDEO_EXTENSIONS = ["mp4", "webm", "mov", "avi", "mkv", "flv", "wmv", "m4v"];
-var AUDIO_EXTENSIONS = ["mp3", "wav", "ogg", "flac", "m4a", "aac", "wma", "opus"];
-function determineFileType(filePath, mimeType) {
-  const ext = path9.extname(filePath).slice(1).toLowerCase();
-  if (IMAGE_EXTENSIONS.includes(ext)) {
-    return "image";
-  }
-  if (VIDEO_EXTENSIONS.includes(ext)) {
-    return "video";
-  }
-  if (AUDIO_EXTENSIONS.includes(ext)) {
-    return "audio";
-  }
+var AUDIO_EXTENSIONS = ["mp3", "wav", "ogg", "flac", "m4a", "aac", "wma", "opus", "mpga"];
+function getFileExtension(filename) {
+  const lastDotIndex = filename.lastIndexOf(".");
+  if (lastDotIndex === -1 || lastDotIndex === filename.length - 1) {
+    return "";
+  }
+  return filename.slice(lastDotIndex + 1).toLowerCase();
+}
+function getFileCategoryByName(filename, mimeType) {
+  const extension = getFileExtension(filename);
+  if (CODE_FILE_EXTENSIONS.includes(extension)) {
+    return "document";
+  }
+  if (IMAGE_EXTENSIONS.includes(extension)) return "image";
+  if (VIDEO_EXTENSIONS.includes(extension)) return "video";
+  if (AUDIO_EXTENSIONS.includes(extension)) return "audio";
   if (mimeType) {
-    if (mimeType.startsWith("image/")) {
-      return "image";
-    }
-    if (mimeType.startsWith("video/")) {
-      return "video";
-    }
-    if (mimeType.startsWith("audio/")) {
-      return "audio";
-    }
+    const mimeTypePrefix = mimeType.split("/")[0].toLowerCase();
+    if (mimeTypePrefix === "image") return "image";
+    if (mimeTypePrefix === "audio") return "audio";
+    if (mimeTypePrefix === "video") return "video";
   }
   return "document";
 }
+function getFileCategoryByMimeType(mimeType) {
+  if (mimeType.startsWith("image/")) return "image";
+  if (mimeType.startsWith("video/")) return "video";
+  if (mimeType.startsWith("audio/")) return "audio";
+  if (mimeType === "application/pdf") return "document";
+  if (mimeType.includes("word") || mimeType.includes("document")) return "document";
+  if (mimeType.includes("sheet") || mimeType.includes("excel")) return "document";
+  if (mimeType.includes("presentation") || mimeType.includes("powerpoint")) return "document";
+  if (mimeType.startsWith("text/")) return "document";
+  return "document";
+}
 
 // src/utils/variable-check.ts
 init_cjs_shims();
@@ -11683,7 +11736,7 @@ ${details}`;
     if (!filePath) {
       continue;
     }
-    const filename = path10.basename(filePath);
+    const filename = path9.basename(filePath);
     process.stdout.write(`  Uploading ${filename}...`);
     try {
       const uploadResult = await apiUploadDriveFile(filePath, workflowId);
@@ -11692,7 +11745,7 @@ ${details}`;
         type: "resource",
         resource: {
           name: uploadResult.name,
-          fileType: determineFileType(filePath, uploadResult.type),
+          fileType: getFileCategoryByName(filePath, uploadResult.type),
           fileId: uploadResult.fileId,
           storageKey: uploadResult.storageKey
         }
@@ -11743,7 +11796,7 @@ function convertKeyValueToVariables(obj, workflow) {
       }
       variables.push({
         variableId: varDef?.variableId,
-        name,
+        name: varDef?.name || name,
         variableType: "resource",
         value: fileValues,
         required: varDef?.required
@@ -11757,7 +11810,7 @@ function convertKeyValueToVariables(obj, workflow) {
       }
       variables.push({
         variableId: varDef?.variableId,
-        name,
+        name: varDef?.name || name,
         variableType: "string",
         value,
         required: varDef?.required
@@ -12327,9 +12380,12 @@ var workflowLayoutCommand = new Command("layout").description("Auto-layout workf
   }
 });
 
-// src/commands/workflow/nodes.ts
+// src/commands/workflow/node/index.ts
 init_cjs_shims();
-var workflowNodesCommand = new Command("nodes").description("List all nodes in a workflow").argument("<workflowId>", "Workflow ID").option("--include-edges", "Include edge/connection information").option("--include-position", "Include node position coordinates").option("--include-metadata", "Include full node metadata").action(async (workflowId, options) => {
+
+// src/commands/workflow/node/list.ts
+init_cjs_shims();
+var nodeListCommand = new Command("list").description("List all nodes in a workflow").argument("<workflowId>", "Workflow ID").option("--include-edges", "Include edge/connection information").option("--include-position", "Include node position coordinates").option("--include-metadata", "Include full node metadata").action(async (workflowId, options) => {
   try {
     const result = await apiRequest(`/v1/cli/workflow/${workflowId}`);
     const nodes = result.nodes.map((node) => {
@@ -12362,12 +12418,13 @@ var workflowNodesCommand = new Command("nodes").description("List all nodes in a
       }));
       output3.edgeCount = result.edges.length;
     }
-    ok("workflow.nodes", output3);
+    ok("workflow.node.list", output3);
   } catch (error) {
     if (error instanceof CLIError) {
+      const hint = error.hint?.replace(/<workflowId>/g, workflowId);
       fail(error.code, error.message, {
         details: error.details,
-        hint: error.hint,
+        hint,
         suggestedFix: error.suggestedFix
       });
     }
@@ -12378,9 +12435,9 @@ var workflowNodesCommand = new Command("nodes").description("List all nodes in a
   }
 });
 
-// src/commands/workflow/node-get.ts
+// src/commands/workflow/node/get.ts
 init_cjs_shims();
-var workflowNodeGetCommand = new Command("node").description("Get single node information from a workflow").argument("<id>", "Workflow ID (c-xxx) or Run ID (we-xxx)").argument("<nodeId>", "Node ID").option("--include-connections", "Include incoming and outgoing connections").action(async (id, nodeId, options) => {
+var nodeGetCommand = new Command("get").description("Get single node information from a workflow").argument("<id>", "Workflow ID (c-xxx) or Run ID (we-xxx)").argument("<nodeId>", "Node ID").option("--include-connections", "Include incoming and outgoing connections").action(async (id, nodeId, options) => {
   try {
     const idType = detectIdType2(id);
     let workflowId = id;
@@ -12392,7 +12449,7 @@ var workflowNodeGetCommand = new Command("node").description("Get single node in
     const node = result.nodes.find((n) => n.id === nodeId);
     if (!node) {
       fail(ErrorCodes.NODE_NOT_FOUND, `Node ${nodeId} not found in workflow ${workflowId}`, {
-        hint: `Use 'refly workflow nodes ${id}' to list all nodes`
+        hint: `Use 'refly workflow node list ${id}' to list all nodes`
       });
     }
     const output3 = {
@@ -12427,12 +12484,13 @@ var workflowNodeGetCommand = new Command("node").description("Get single node in
         outgoingCount: outgoing.length
       };
     }
-    ok("workflow.node", output3);
+    ok("workflow.node.get", output3);
   } catch (error) {
     if (error instanceof CLIError) {
+      const hint = error.hint?.replace(/<workflowId>/g, id).replace(/<id>/g, id).replace(/<nodeId>/g, nodeId);
       fail(error.code, error.message, {
         details: error.details,
-        hint: error.hint,
+        hint,
         suggestedFix: error.suggestedFix
       });
     }
@@ -12443,9 +12501,9 @@ var workflowNodeGetCommand = new Command("node").description("Get single node in
   }
 });
 
-// src/commands/workflow/node-add.ts
+// src/commands/workflow/node/add.ts
 init_cjs_shims();
-var workflowNodeAddCommand = new Command("node-add").description("Add a node to a workflow").argument("<workflowId>", "Workflow ID (c-xxx)").requiredOption("--type <type>", "Node type (skillResponse, start, document, resource, memo)").option("--id <nodeId>", "Custom node ID (auto-generated if not provided)").option("--query <query>", "Query/prompt for the node").option("--title <title>", "Node title").option("--toolset-keys <keys>", 'Comma-separated toolset keys (e.g., "web_search,execute_code")').option("--position <x,y>", 'Node position as "x,y" (default: 0,0)').option("--connect-from <nodeId>", "Connect from this node (creates edge)").option("--connect-to <nodeId>", "Connect to this node (creates edge)").option("--resolve-toolset-keys", "Resolve toolset keys to full IDs").option("--auto-layout", "Enable auto-layout to prevent overlapping").action(async (workflowId, options) => {
+var nodeAddCommand = new Command("add").description("Add a node to a workflow").argument("<workflowId>", "Workflow ID (c-xxx)").requiredOption("--type <type>", "Node type (skillResponse, start, document, resource, memo)").option("--id <nodeId>", "Custom node ID (auto-generated if not provided)").option("--query <query>", "Query/prompt for the node").option("--title <title>", "Node title").option("--toolset-keys <keys>", 'Comma-separated toolset keys (e.g., "web_search,execute_code")').option("--position <x,y>", 'Node position as "x,y" (default: 0,0)').option("--connect-from <nodeId>", "Connect from this node (creates edge)").option("--connect-to <nodeId>", "Connect to this node (creates edge)").option("--resolve-toolset-keys", "Resolve toolset keys to full IDs").option("--auto-layout", "Enable auto-layout to prevent overlapping").action(async (workflowId, options) => {
   if (!workflowId.startsWith("c-")) {
     fail(ErrorCodes.INVALID_INPUT, `Invalid workflow ID: ${workflowId}`, {
       hint: 'Workflow ID should start with "c-"',
@@ -12544,15 +12602,16 @@ var workflowNodeAddCommand = new Command("node-add").description("Add a node to
       ...options.connectFrom && { connectedFrom: options.connectFrom },
       ...options.connectTo && { connectedTo: options.connectTo },
       nextSteps: [
-        `View node: \`refly workflow node ${workflowId} ${nodeId}\``,
-        `List all nodes: \`refly workflow nodes ${workflowId}\``
+        `View node: \`refly workflow node get ${workflowId} ${nodeId}\``,
+        `List all nodes: \`refly workflow node list ${workflowId}\``
       ]
     });
   } catch (error) {
     if (error instanceof CLIError) {
+      const hint = error.hint?.replace(/<workflowId>/g, workflowId);
       fail(error.code, error.message, {
         details: error.details,
-        hint: error.hint,
+        hint,
         suggestedFix: error.suggestedFix
       });
       return;
@@ -12564,9 +12623,9 @@ var workflowNodeAddCommand = new Command("node-add").description("Add a node to
   }
 });
 
-// src/commands/workflow/node-update.ts
+// src/commands/workflow/node/update.ts
 init_cjs_shims();
-var workflowNodeUpdateCommand = new Command("node-update").description("Update a node in a workflow").argument("<workflowId>", "Workflow ID (c-xxx)").argument("<nodeId>", "Node ID to update").option("--query <query>", "Update the query/prompt for the node").option("--title <title>", "Update the node title").option("--toolset-keys <keys>", 'Comma-separated toolset keys (e.g., "web_search,execute_code")').option("--data <json>", "Full node data as JSON (advanced usage)").option("--resolve-toolset-keys", "Resolve toolset keys to full IDs").action(async (workflowId, nodeId, options) => {
+var nodeUpdateCommand = new Command("update").description("Update a node in a workflow").argument("<workflowId>", "Workflow ID (c-xxx)").argument("<nodeId>", "Node ID to update").option("--query <query>", "Update the query/prompt for the node").option("--title <title>", "Update the node title").option("--toolset-keys <keys>", 'Comma-separated toolset keys (e.g., "web_search,execute_code")').option("--data <json>", "Full node data as JSON (advanced usage)").option("--resolve-toolset-keys", "Resolve toolset keys to full IDs").action(async (workflowId, nodeId, options) => {
   if (!workflowId.startsWith("c-")) {
     fail(ErrorCodes.INVALID_INPUT, `Invalid workflow ID: ${workflowId}`, {
       hint: 'Workflow ID should start with "c-"',
@@ -12656,15 +12715,16 @@ var workflowNodeUpdateCommand = new Command("node-update").description("Update a
         ...options.data && { data: "custom data applied" }
       },
       nextSteps: [
-        `View updated node: \`refly workflow node ${workflowId} ${nodeId}\``,
-        `List all nodes: \`refly workflow nodes ${workflowId}\``
+        `View updated node: \`refly workflow node get ${workflowId} ${nodeId}\``,
+        `List all nodes: \`refly workflow node list ${workflowId}\``
       ]
     });
   } catch (error) {
     if (error instanceof CLIError) {
+      const hint = error.hint?.replace(/<workflowId>/g, workflowId).replace(/<nodeId>/g, nodeId);
       fail(error.code, error.message, {
         details: error.details,
-        hint: error.hint,
+        hint,
         suggestedFix: error.suggestedFix
       });
       return;
@@ -12676,9 +12736,9 @@ var workflowNodeUpdateCommand = new Command("node-update").description("Update a
   }
 });
 
-// src/commands/workflow/node-delete.ts
+// src/commands/workflow/node/delete.ts
 init_cjs_shims();
-var workflowNodeDeleteCommand = new Command("node-delete").description("Delete a node from a workflow").argument("<workflowId>", "Workflow ID (c-xxx)").argument("<nodeId>", "Node ID to delete").action(async (workflowId, nodeId) => {
+var nodeDeleteCommand = new Command("delete").description("Delete a node from a workflow").argument("<workflowId>", "Workflow ID (c-xxx)").argument("<nodeId>", "Node ID to delete").action(async (workflowId, nodeId) => {
   if (!workflowId.startsWith("c-")) {
     fail(ErrorCodes.INVALID_INPUT, `Invalid workflow ID: ${workflowId}`, {
       hint: 'Workflow ID should start with "c-"',
@@ -12708,13 +12768,14 @@ var workflowNodeDeleteCommand = new Command("node-delete").description("Delete a
       workflowId,
       nodeId,
       note: "Connected edges were also removed",
-      nextSteps: [`List remaining nodes: \`refly workflow nodes ${workflowId}\``]
+      nextSteps: [`List remaining nodes: \`refly workflow node list ${workflowId}\``]
     });
   } catch (error) {
     if (error instanceof CLIError) {
+      const hint = error.hint?.replace(/<workflowId>/g, workflowId).replace(/<nodeId>/g, nodeId);
       fail(error.code, error.message, {
         details: error.details,
-        hint: error.hint,
+        hint,
         suggestedFix: error.suggestedFix
       });
       return;
@@ -12726,9 +12787,9 @@ var workflowNodeDeleteCommand = new Command("node-delete").description("Delete a
   }
 });
 
-// src/commands/workflow/node-output.ts
+// src/commands/workflow/node/output.ts
 init_cjs_shims();
-var workflowNodeOutputCommand = new Command("node-output").description("Get node execution output content").argument("<id>", "Workflow ID (c-xxx) or Run ID (we-xxx)").argument("<nodeId>", "Node ID").option("--include-tool-calls", "Include tool call details in output").option("--raw", "Output raw content without formatting").action(async (id, nodeId, options) => {
+var nodeOutputCommand = new Command("output").description("Get node execution output content").argument("<id>", "Workflow ID (c-xxx) or Run ID (we-xxx)").argument("<nodeId>", "Node ID").option("--include-tool-calls", "Include tool call details in output").option("--raw", "Output raw content without formatting").action(async (id, nodeId, options) => {
   try {
     const params = new URLSearchParams();
     if (options.includeToolCalls) {
@@ -12740,7 +12801,7 @@ var workflowNodeOutputCommand = new Command("node-output").description("Get node
     const idType = detectIdType2(id);
     const url = buildWorkflowApiUrl(id, `node/${nodeId}/output`, params);
     const result = await apiRequest(url);
-    ok("workflow.nodeOutput", {
+    ok("workflow.node.output", {
       runId: result.runId,
       workflowId: result.workflowId,
       idType,
@@ -12761,9 +12822,10 @@ var workflowNodeOutputCommand = new Command("node-output").description("Get node
     });
   } catch (error) {
     if (error instanceof CLIError) {
+      const hint = error.hint?.replace(/<workflowId>/g, id).replace(/<id>/g, id);
       fail(error.code, error.message, {
         details: error.details,
-        hint: error.hint,
+        hint,
         suggestedFix: error.suggestedFix
       });
     }
@@ -12771,12 +12833,15 @@ var workflowNodeOutputCommand = new Command("node-output").description("Get node
       ErrorCodes.INTERNAL_ERROR,
       error instanceof Error ? error.message : "Failed to get node output",
       {
-        hint: "Ensure the node has completed execution. Use `refly workflow status <id>` to check."
+        hint: `Ensure the node has completed execution. Use \`refly workflow status ${id}\` to check.`
       }
     );
   }
 });
 
+// src/commands/workflow/node/index.ts
+var workflowNodeCommand = new Command("node").description("Manage workflow nodes").addCommand(nodeListCommand).addCommand(nodeGetCommand).addCommand(nodeAddCommand).addCommand(nodeUpdateCommand).addCommand(nodeDeleteCommand).addCommand(nodeOutputCommand);
+
 // src/commands/workflow/edit.ts
 init_cjs_shims();
 var workflowEditCommand = new Command("edit").description("Edit a workflow using natural language").argument("<id>", "Canvas ID (c-xxx)").option("--query <text>", "Edit instruction in natural language").option("--session-id <id>", "Session ID (cs-xxx) for context continuity").option("--timeout <ms>", "Timeout for AI processing", "60000").action(async (id, options) => {
@@ -12854,17 +12919,6 @@ var workflowEditCommand = new Command("edit").description("Edit a workflow using
 
 // src/commands/workflow/variables.ts
 init_cjs_shims();
-function getFileTypeCategory(mimeType) {
-  if (mimeType.startsWith("image/")) return "image";
-  if (mimeType.startsWith("video/")) return "video";
-  if (mimeType.startsWith("audio/")) return "audio";
-  if (mimeType === "application/pdf") return "document";
-  if (mimeType.includes("word") || mimeType.includes("document")) return "document";
-  if (mimeType.includes("sheet") || mimeType.includes("excel")) return "document";
-  if (mimeType.includes("presentation") || mimeType.includes("powerpoint")) return "document";
-  if (mimeType.startsWith("text/")) return "document";
-  return "document";
-}
 async function getFileMetadata(fileId) {
   try {
     return await apiRequest(`/v1/cli/drive/files/${fileId}?includeContent=false`);
@@ -13024,7 +13078,7 @@ var variablesSetCommand = new Command("set").description("Set variable values fo
                     resource: {
                       fileId: newValue,
                       name: metadata?.name || "",
-                      fileType: metadata ? getFileTypeCategory(metadata.type) : "document",
+                      fileType: metadata ? getFileCategoryByMimeType(metadata.type) : "document",
                       storageKey: metadata?.storageKey || ""
                     }
                   }
@@ -13201,7 +13255,7 @@ var workflowSessionCommand = new Command("session").description("Get the latest
 });
 
 // src/commands/workflow/index.ts
-var workflowCommand = new Command("workflow").description("Manage and run workflows").addCommand(workflowCreateCommand).addCommand(workflowGenerateCommand).addCommand(workflowListCommand).addCommand(workflowGetCommand).addCommand(workflowDeleteCommand).addCommand(workflowRunCommand).addCommand(workflowRunsCommand).addCommand(workflowStatusCommand).addCommand(workflowDetailCommand).addCommand(workflowToolcallsCommand).addCommand(workflowAbortCommand).addCommand(workflowToolsetKeysCommand).addCommand(workflowLayoutCommand).addCommand(workflowNodesCommand).addCommand(workflowNodeGetCommand).addCommand(workflowNodeAddCommand).addCommand(workflowNodeUpdateCommand).addCommand(workflowNodeDeleteCommand).addCommand(workflowNodeOutputCommand).addCommand(workflowEditCommand).addCommand(workflowVariablesCommand).addCommand(workflowSessionCommand).addCommand(workflowResultCommand);
+var workflowCommand = new Command("workflow").description("Manage and run workflows").addCommand(workflowCreateCommand).addCommand(workflowGenerateCommand).addCommand(workflowListCommand).addCommand(workflowGetCommand).addCommand(workflowDeleteCommand).addCommand(workflowRunCommand).addCommand(workflowRunsCommand).addCommand(workflowStatusCommand).addCommand(workflowDetailCommand).addCommand(workflowToolcallsCommand).addCommand(workflowAbortCommand).addCommand(workflowToolsetKeysCommand).addCommand(workflowLayoutCommand).addCommand(workflowNodeCommand).addCommand(workflowEditCommand).addCommand(workflowVariablesCommand).addCommand(workflowSessionCommand).addCommand(workflowResultCommand);
 
 // src/commands/tool/index.ts
 init_cjs_shims();
@@ -13382,14 +13436,14 @@ var fileGetCommand = new Command("get").description("Get file details").argument
 // src/commands/file/download.ts
 init_cjs_shims();
 var fs14 = __toESM(require("fs"));
-var path11 = __toESM(require("path"));
+var path10 = __toESM(require("path"));
 var fileDownloadCommand = new Command("download").description("Download file to local filesystem").argument("<fileId>", "File ID").option("-o, --output <path>", "Output file path (defaults to original filename)").action(async (fileId, options) => {
   try {
     const { data, filename, contentType, size } = await apiRequestStream(
       `/v1/cli/drive/files/${fileId}/download`
     );
     const outputPath = options.output || filename || `${fileId}`;
-    const resolvedPath = path11.resolve(outputPath);
+    const resolvedPath = path10.resolve(outputPath);
     fs14.writeFileSync(resolvedPath, data);
     ok("file.download", {
       fileId,
@@ -13416,7 +13470,7 @@ var fileDownloadCommand = new Command("download").description("Download file to
 // src/commands/file/upload.ts
 init_cjs_shims();
 var fs15 = __toESM(require("fs"));
-var path12 = __toESM(require("path"));
+var path11 = __toESM(require("path"));
 var MAX_FILES = 10;
 function formatSize(bytes) {
   if (bytes < 1024) return `${bytes}B`;
@@ -13426,7 +13480,7 @@ function formatSize(bytes) {
 var fileUploadCommand = new Command("upload").description("Upload file(s) to a canvas").argument("<path>", "File or directory path").requiredOption("--canvas-id <id>", "Canvas ID (required)").option("--filter <extensions>", "Filter by extensions (e.g., pdf,docx,png)").action(async (inputPath, options) => {
   const formatter = getFormatter();
   try {
-    const resolvedPath = path12.resolve(inputPath);
+    const resolvedPath = path11.resolve(inputPath);
     if (!fs15.existsSync(resolvedPath)) {
       fail(ErrorCodes.NOT_FOUND, `Path not found: ${inputPath}`, {
         hint: "Check if the file or directory exists"
@@ -13445,7 +13499,7 @@ var fileUploadCommand = new Command("upload").description("Upload file(s) to a c
     const errors = [];
     for (let i = 0; i < files.length; i++) {
       const filePath = files[i];
-      const filename = path12.basename(filePath);
+      const filename = path11.basename(filePath);
       const fileStats = fs15.statSync(filePath);
       const sizeStr = formatSize(fileStats.size);
       let currentStage = "presign";
@@ -13531,7 +13585,7 @@ function resolveFilesToUpload(inputPath, filter) {
   if (stats.isFile()) {
     if (filter) {
       const filterExts = filter.split(",").map((e) => e.trim().toLowerCase());
-      const ext = path12.extname(inputPath).slice(1).toLowerCase();
+      const ext = path11.extname(inputPath).slice(1).toLowerCase();
       if (!filterExts.includes(ext)) {
         return [];
       }
@@ -13541,7 +13595,7 @@ function resolveFilesToUpload(inputPath, filter) {
   if (stats.isDirectory()) {
     const entries = fs15.readdirSync(inputPath);
     const filterExts = filter?.split(",").map((e) => e.trim().toLowerCase());
-    const files = entries.map((e) => path12.join(inputPath, e)).filter((p) => {
+    const files = entries.map((e) => path11.join(inputPath, e)).filter((p) => {
       try {
         return fs15.statSync(p).isFile();
       } catch {
@@ -13549,7 +13603,7 @@ function resolveFilesToUpload(inputPath, filter) {
       }
     }).filter((p) => {
       if (!filterExts) return true;
-      const ext = path12.extname(p).slice(1).toLowerCase();
+      const ext = path11.extname(p).slice(1).toLowerCase();
       return filterExts.includes(ext);
     }).sort((a, b) => {
       try {
@@ -13740,6 +13794,7 @@ var skillCreateCommand = new Command("create").description("Create a new skill p
     const webUrl = getWebUrl();
     const payload = {
       skillId: result.skillId,
+      installationId: result.installationId,
       name: result.name,
       status: result.status,
       createdAt: result.createdAt,
@@ -13771,7 +13826,7 @@ var skillCreateCommand = new Command("create").description("Create a new skill p
 // src/commands/skill/update.ts
 init_cjs_shims();
 var fs17 = __toESM(require("fs"));
-var path13 = __toESM(require("path"));
+var path12 = __toESM(require("path"));
 init_paths();
 init_symlink();
 var MIN_DESCRIPTION_WORDS = 20;
@@ -13801,7 +13856,7 @@ var skillUpdateCommand = new Command("update").description("Update skill install
   try {
     const name = options.name;
     const skillDir = getReflyDomainSkillDir(name);
-    const skillMdPath = path13.join(skillDir, "SKILL.md");
+    const skillMdPath = path12.join(skillDir, "SKILL.md");
     if (!fs17.existsSync(skillMdPath)) {
       const skillsDir = getReflySkillsDir();
       fail(ErrorCodes.NOT_FOUND, `SKILL.md not found at ${skillMdPath}`, {
@@ -13895,29 +13950,15 @@ To see installed skills: refly skill list`
 // src/commands/skill/publish.ts
 init_cjs_shims();
 var fs18 = __toESM(require("fs"));
-var path14 = __toESM(require("path"));
+var path13 = __toESM(require("path"));
 init_symlink();
 init_paths();
-var skillPublishCommand = new Command("publish").description("Publish a skill package using local SKILL.md").option("--id <skillId>", "Skill ID (skp-xxx) - overrides ID from SKILL.md").option("--name <name>", "Local skill name (directory in ~/.refly/skills/)").action(async (options) => {
+var skillPublishCommand = new Command("publish").description("Publish a skill package using local SKILL.md").requiredOption("--name <name>", "Local skill name (directory in ~/.refly/skills/)").action(async (options) => {
   try {
     const skillsDir = getReflySkillsDir();
-    if (!options.name) {
-      fail(ErrorCodes.INVALID_INPUT, "Missing required option: --name", {
-        hint: `The publish command requires --name to locate the local SKILL.md.
-
-Usage:
-  refly skill publish --name <name>
-  refly skill publish --name <name> --id <skillId>  # override skillId
-
-To find your skill name:
-  refly skill list
-  ls ${skillsDir}/`
-      });
-      return;
-    }
     const name = options.name;
     const skillDir = getReflyDomainSkillDir(name);
-    const skillMdPath = path14.join(skillDir, "SKILL.md");
+    const skillMdPath = path13.join(skillDir, "SKILL.md");
     if (!fs18.existsSync(skillMdPath)) {
       fail(ErrorCodes.NOT_FOUND, `SKILL.md not found at ${skillMdPath}`, {
         hint: `Make sure the skill '${name}' exists in ${skillsDir}/
@@ -13932,17 +13973,26 @@ To create a new skill: refly skill create --name "${name}" --workflow-query "...
     try {
       parsedSkill = parseReflySkillMd(skillContent);
     } catch (parseError) {
-      fail(
-        ErrorCodes.INVALID_INPUT,
-        `Failed to parse SKILL.md: ${parseError.message}`,
-        {
-          hint: "Make sure SKILL.md has valid frontmatter with required fields: name, description, skillId, workflowId"
-        }
-      );
+      const errorMessage = parseError.message;
+      if (errorMessage.includes("skillId")) {
+        fail(ErrorCodes.INVALID_INPUT, "SKILL.md is missing skillId", {
+          hint: `The skill "${name}" has no skillId. This may happen if the skill was created manually.
+
+To fix this:
+  1. Reinstall the skill: refly skill install <skillId> --force
+  2. Or create a new skill: refly skill create --name "${name}" --workflow <workflowId>
+
+To find available skills: refly skill list`
+        });
+        return;
+      }
+      fail(ErrorCodes.INVALID_INPUT, `Failed to parse SKILL.md: ${errorMessage}`, {
+        hint: "Make sure SKILL.md has valid frontmatter with required fields: name, description, skillId, workflowId"
+      });
       return;
     }
     const { meta } = parsedSkill;
-    const skillId = options.id || meta.skillId;
+    const skillId = meta.skillId;
     const result = await apiRequest(
       `/v1/skill-packages/${skillId}/publish`,
       {
@@ -13981,7 +14031,7 @@ To create a new skill: refly skill create --name "${name}" --workflow-query "...
 // src/commands/skill/unpublish.ts
 init_cjs_shims();
 var fs19 = __toESM(require("fs"));
-var path15 = __toESM(require("path"));
+var path14 = __toESM(require("path"));
 init_symlink();
 init_paths();
 var skillUnpublishCommand = new Command("unpublish").description("Unpublish a skill package to make it private").option("--id <skillId>", "Skill ID (skp-xxx)").option("--name <name>", "Local skill name (directory in ~/.refly/skills/)").action(async (options) => {
@@ -14003,8 +14053,20 @@ To find your skill name:
     let name;
     if (options.name) {
       name = options.name;
+      if (!name) {
+        fail(ErrorCodes.INVALID_INPUT, "Skill name cannot be empty", {
+          hint: `Usage:
+  refly skill unpublish --name <name>
+  refly skill unpublish --id <skillId>
+
+To find your skill name:
+  refly skill list
+  ls ${skillsDir}/`
+        });
+        return;
+      }
       const skillDir = getReflyDomainSkillDir(name);
-      const skillMdPath = path15.join(skillDir, "SKILL.md");
+      const skillMdPath = path14.join(skillDir, "SKILL.md");
       if (!fs19.existsSync(skillMdPath)) {
         fail(ErrorCodes.NOT_FOUND, `SKILL.md not found at ${skillMdPath}`, {
           hint: `Make sure the skill '${name}' exists in ${skillsDir}/
@@ -14058,7 +14120,7 @@ To see installed skills: refly skill list`
 // src/commands/skill/run.ts
 init_cjs_shims();
 var fs20 = __toESM(require("fs"));
-var path16 = __toESM(require("path"));
+var path15 = __toESM(require("path"));
 init_symlink();
 init_paths();
 var skillRunCommand = new Command("run").description("Run an installed skill").option("--id <installationId>", "Installation ID (skpi-xxx)").option("--name <name>", "Local skill name (directory in ~/.refly/skills/)").option("--input <json>", "Input JSON for the skill").option("--workflow <skillWorkflowId>", "Run specific workflow only").option("--async", "Run asynchronously").option("--no-prompt", "Disable interactive prompts (fail if required variables are missing)").action(async (options) => {
@@ -14083,7 +14145,7 @@ To find your skill name:
     if (options.name) {
       name = options.name;
       const skillDir = getReflyDomainSkillDir(options.name);
-      const skillMdPath = path16.join(skillDir, "SKILL.md");
+      const skillMdPath = path15.join(skillDir, "SKILL.md");
       if (!fs20.existsSync(skillMdPath)) {
         fail(ErrorCodes.NOT_FOUND, `SKILL.md not found at ${skillMdPath}`, {
           hint: `Make sure the skill '${name}' exists in ${skillsDir}/
@@ -14212,7 +14274,7 @@ To install: refly skill install ${meta.skillId}`
 // src/commands/skill/stop.ts
 init_cjs_shims();
 var fs21 = __toESM(require("fs"));
-var path17 = __toESM(require("path"));
+var path16 = __toESM(require("path"));
 init_symlink();
 init_paths();
 function getLocalSkillNames() {
@@ -14227,7 +14289,7 @@ var skillStopCommand = new Command("stop").description("Stop running skill execu
     const skillsDir = getReflySkillsDir();
     const name = options.name;
     const skillDir = getReflyDomainSkillDir(name);
-    const skillMdPath = path17.join(skillDir, "SKILL.md");
+    const skillMdPath = path16.join(skillDir, "SKILL.md");
     if (!fs21.existsSync(skillMdPath)) {
       const availableSkills = getLocalSkillNames();
       const skillList = availableSkills.length > 0 ? availableSkills.join(", ") : "(no skills installed)";
@@ -14427,7 +14489,7 @@ var skillInstallCommand = new Command("install").description("Install a skill pa
 // src/commands/skill/uninstall.ts
 init_cjs_shims();
 var fs22 = __toESM(require("fs"));
-var path18 = __toESM(require("path"));
+var path17 = __toESM(require("path"));
 init_symlink();
 init_paths();
 init_logger();
@@ -14451,8 +14513,20 @@ To find your skill name:
     let name;
     if (options.name) {
       name = options.name;
+      if (!name) {
+        fail(ErrorCodes.INVALID_INPUT, "Skill name cannot be empty", {
+          hint: `Usage:
+  refly skill uninstall --name <name>
+  refly skill uninstall --id <installationId>
+
+To find your skill name:
+  refly skill list
+  ls ${skillsDir}/`
+        });
+        return;
+      }
       const skillDir = getReflyDomainSkillDir(name);
-      const skillMdPath = path18.join(skillDir, "SKILL.md");
+      const skillMdPath = path17.join(skillDir, "SKILL.md");
       if (!fs22.existsSync(skillMdPath)) {
         fail(ErrorCodes.NOT_FOUND, `SKILL.md not found at ${skillMdPath}`, {
           hint: `Make sure the skill '${name}' exists in ${skillsDir}/
@@ -14578,7 +14652,7 @@ init_cjs_shims();
 // src/skill/loader.ts
 init_cjs_shims();
 var fs23 = __toESM(require("fs"));
-var path19 = __toESM(require("path"));
+var path18 = __toESM(require("path"));
 var import_gray_matter = __toESM(require("gray-matter"));
 init_logger();
 
@@ -14759,13 +14833,13 @@ function extractSkillMetadata(content) {
 // src/commands/skill/validate.ts
 init_paths();
 var fs24 = __toESM(require("fs"));
-var path20 = __toESM(require("path"));
+var path19 = __toESM(require("path"));
 var skillValidateCommand = new Command("validate").description("Validate local skill files").argument("[skillPath]", "Path to skill file or directory (defaults to ~/.refly/skills)").option("--fix", "Attempt to fix common issues").action(async (skillPath, _options) => {
   try {
     const results = [];
     let targetPath;
     if (skillPath) {
-      targetPath = path20.resolve(skillPath);
+      targetPath = path19.resolve(skillPath);
     } else {
       await ensureSkillsDir();
       targetPath = getSkillsDir();
@@ -14835,7 +14909,7 @@ function validateSkillFile(filePath) {
 function findSkillFiles(dir, files = []) {
   const entries = fs24.readdirSync(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const fullPath = path20.join(dir, entry.name);
+    const fullPath = path19.join(dir, entry.name);
     if (entry.isDirectory()) {
       if (!entry.name.startsWith(".")) {
         findSkillFiles(fullPath, files);
@@ -14852,7 +14926,7 @@ init_cjs_shims();
 init_symlink();
 init_paths();
 var fs25 = __toESM(require("fs"));
-var path21 = __toESM(require("path"));
+var path20 = __toESM(require("path"));
 var skillSyncCommand = new Command("sync").description("Validate and repair skill symlinks").option("--dry-run", "Show issues without making changes").option("--fix", "Attempt to repair broken symlinks").option("--prune", "Remove orphan symlinks (symlinks without source directory)").action(async (options) => {
   try {
     const symlinks = listSkillSymlinks();
@@ -14886,7 +14960,7 @@ var skillSyncCommand = new Command("sync").description("Validate and repair skil
         if (entry.isDirectory() && entry.name !== "base") {
           if (!symlinkNames.has(entry.name)) {
             orphans += 1;
-            warnings.push(`Orphan directory (no symlink): ${path21.join(skillsDir, entry.name)}`);
+            warnings.push(`Orphan directory (no symlink): ${path20.join(skillsDir, entry.name)}`);
             if (options.prune && !options.dryRun) {
               const result = createSkillSymlink(entry.name);
               if (result.success) {
@@ -14936,7 +15010,7 @@ var skillCommand = new Command("skill").description("Manage skill packages and l
 // src/bin/refly.ts
 function getVersion() {
   try {
-    const pkgPath = path22.join(__dirname, "..", "..", "package.json");
+    const pkgPath = path21.join(__dirname, "..", "..", "package.json");
     const pkg = JSON.parse(fs26.readFileSync(pkgPath, "utf-8"));
     return pkg.version || "0.1.0";
   } catch {