@houwert/conductor 0.27.0 → 0.27.1

package/dist/drivers/flow-runner.js

@@ -7,11 +7,13 @@ exports.parseFlowFile = parseFlowFile;
 exports.parseFlowString = parseFlowString;
 exports.executeFlow = executeFlow;
 exports.resolvePoint = resolvePoint;
+exports.resolvePath = resolvePath;
 /**
  * Native Conductor YAML flow parser and executor.
  * Parses flow YAML files and executes commands directly using IOSDriver / AndroidDriver.
  */
 const promises_1 = __importDefault(require("fs/promises"));
+const node_fs_1 = require("node:fs");
 const path_1 = __importDefault(require("path"));
 const node_vm_1 = __importDefault(require("node:vm"));
 const js_yaml_1 = __importDefault(require("js-yaml"));
@@ -1368,8 +1370,72 @@ async function executeCommandBody(key, val, driver, opts) {
     }
 }
 // ── Utilities ─────────────────────────────────────────────────────────────────
+// Resolve a `file:` reference from within a flow. A path starting with `@` is an
+// alias of the form `@name/rest`, where `name` maps to a directory declared under
+// `paths:` in the nearest `config.yaml`. Everything else keeps the historical
+// behavior: resolved relative to the flow file's directory (`cwd`).
+// Mirrors the plexinc/maestro FlowPathResolver.
 function resolvePath(filePath, cwd) {
-    return path_1.default.isAbsolute(filePath) ? filePath : path_1.default.join(cwd ?? process.cwd(), filePath);
+    const base = cwd ?? process.cwd();
+    if (filePath.startsWith('@'))
+        return resolvePathAlias(filePath, base);
+    return path_1.default.isAbsolute(filePath) ? filePath : path_1.default.join(base, filePath);
+}
+const CONFIG_FILE_NAMES = ['config.yaml', 'config.yml'];
+// Cache discovered config → paths map for the process lifetime (flows are short-lived).
+const configPathsCache = new Map();
+function resolvePathAlias(requestedPath, startDir) {
+    const body = requestedPath.slice(1);
+    const separator = body.indexOf('/');
+    const alias = separator >= 0 ? body.slice(0, separator) : body;
+    const remainder = separator >= 0 ? body.slice(separator + 1) : '';
+    const configPath = findWorkspaceConfig(startDir);
+    if (!configPath) {
+        throw new Error(`Path alias '@${alias}' used but no config.yaml was found in any parent directory. ` +
+            'Declare aliases under `paths:` in a workspace config.yaml.');
+    }
+    const paths = readWorkspacePaths(configPath);
+    const target = paths[alias];
+    if (target === undefined) {
+        const known = Object.keys(paths).sort();
+        throw new Error(`Unknown path alias '@${alias}' referenced in a flow. ` +
+            `Known aliases in ${configPath}: [${known.join(', ')}]`);
+    }
+    const configDir = path_1.default.dirname(path_1.default.resolve(configPath));
+    const targetDir = path_1.default.normalize(path_1.default.resolve(configDir, target));
+    if (!(0, node_fs_1.existsSync)(targetDir) || !(0, node_fs_1.statSync)(targetDir).isDirectory()) {
+        throw new Error(`Path alias '@${alias}' points to '${targetDir}', which is not an existing directory.`);
+    }
+    return path_1.default.normalize(path_1.default.resolve(targetDir, remainder));
+}
+function findWorkspaceConfig(startDir) {
+    let dir = path_1.default.resolve(startDir);
+    while (dir) {
+        for (const name of CONFIG_FILE_NAMES) {
+            const candidate = path_1.default.join(dir, name);
+            if ((0, node_fs_1.existsSync)(candidate))
+                return candidate;
+        }
+        const parent = path_1.default.dirname(dir);
+        dir = parent === dir ? null : parent;
+    }
+    return null;
+}
+function readWorkspacePaths(configPath) {
+    const cached = configPathsCache.get(configPath);
+    if (cached)
+        return cached;
+    let paths = {};
+    try {
+        const doc = js_yaml_1.default.load((0, node_fs_1.readFileSync)(configPath, 'utf-8'));
+        if (doc && typeof doc.paths === 'object' && doc.paths)
+            paths = doc.paths;
+    }
+    catch {
+        // A malformed config leaves aliases unresolved; the unknown-alias error below is clearer.
+    }
+    configPathsCache.set(configPath, paths);
+    return paths;
 }
 function resolveAppId(val, cmdName) {
     if (typeof val === 'string' && val)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@houwert/conductor",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "CLI tool for mobile app interactions — optimized for AI agents",
   "license": "MIT",
   "repository": {