@ai-setting/roy-plugin-task-show 2.5.7 → 2.5.9

package/dist/cli-path-resolver.d.ts

@@ -0,0 +1,102 @@
+/**
+ * @fileoverview `roy-agent` CLI path resolver — Task #2895 (v2 PATH-first).
+ *
+ * ## User direction
+ *
+ * User correction (Task #2895 v2): "task-show的实现机制估计是有问题
+ * 的，需要用系统的roy-agent命令行，而不需要去特定地方找roy-agent
+ * 所需的bin啥的呀"
+ *
+ * Translation: "task-show's implementation mechanism is likely wrong —
+ * it should use the system `roy-agent` CLI, not look for the binary in
+ * specific source-layout locations."
+ *
+ * ## Background (Task #2893)
+ *
+ * v2.5.8 added a fallback HTML page so the `AdapterError: CLI exited
+ * with code 1 and no parseable JSON envelope` error no longer bubbles
+ * to the user. The fallback was visible because the underlying CLI
+ * call **still exits 1**.
+ *
+ * The previous resolution logic preferred hardcoded paths:
+ *   1. `cfg.royAgentCliPath`
+ *   2. `$ROY_AGENT_CLI`
+ *   3. `<cwd>/../roy-agent/packages/cli/dist/bin/roy-agent.js`
+ *      (sibling-repo / monorepo source layout)
+ *   4. `roy-agent` on PATH
+ *
+ * When the user runs `roy-agent run` inside the `roy-agent` monorepo,
+ * step #3 picks the monorepo `roy-agent.js` source file. Without a
+ * locally-built `better_sqlite3.node` binding, that source crashes on
+ * startup with exit 1 and 100+ KiB of stderr — yielding the
+ * `AdapterError` users see.
+ *
+ * ## Resolution order (this module — Task #2895 v2)
+ *
+ *   1. PATH `roy-agent` (`which`-style lookup, executable-bit check).
+ *      The bundled `@ai-setting/roy-agent-standalone@1.7.6` binary
+ *      ships with native bindings embedded — always works regardless
+ *      of cwd / install layout.
+ *   2. Explicit override (`cfg.royAgentCliPath`) when the file exists.
+ *      Advanced users only.
+ *   3. `$ROY_AGENT_CLI` env var when the file exists.
+ *   4. Dev hardcoded paths — ONLY when `NODE_ENV !== 'production'`.
+ *      Lets plugin authors iterate on the `roy-agent` monorepo without
+ *      installing the standalone binary globally.
+ *   5. None of the above → soft fallback: return the literal string
+ *      `"roy-agent"` (the OS spawn will look it up via `$PATH` at exec
+ *      time) and emit a one-time `process.stderr` warning. This
+ *      preserves the v2.5.8 sendIndex failsafe UX (the existing
+ *      `AdapterError` will trigger the fallback HTML page with the
+ *      Retry button) **without** throwing out of the plugin
+ *      constructor — a hard throw would prevent the HTTP server from
+ *      ever starting, which is strictly worse than letting users see
+ *      the retry-friendly fallback page. Operators who want a quieter
+ *      experience can install `@ai-setting/roy-agent-standalone`
+ *      globally so step #1 finds it.
+ *
+ * Pure functions only — exported for unit tests.
+ */
+/**
+ * Locate `roy-agent` on `$PATH`. Returns the first hit or `undefined`
+ * when no executable named `roy-agent` is discoverable.
+ *
+ * Pure function — exported for tests. Behaviour:
+ *   - Splits `$PATH` on `path.delimiter` (POSIX `:` / Windows `;`).
+ *   - For each directory, checks `<dir>/roy-agent`.
+ *   - Accepts either a regular file or a symlink to one.
+ *   - Skips directories that don't exist (no throw).
+ *
+ * This is a *Node-side* check (fs.statSync), not a shell `which`.
+ On Linux/macOS we additionally require the executable bit to be
+ * set; on Windows we accept anything that's a file or symlink since
+ * executable-bit semantics are looser there. The plugin runs on
+ * Linux/macOS in practice (verified by the user's report).
+ */
+export declare function findRoyAgentOnPath(pathEnv: string | undefined): string | undefined;
+export interface ResolveRoyAgentCliPathOptions {
+    /** Path-style overrides (test seam). Falls back to `process.cwd()`. */
+    cwd?: string;
+    /** Path-style overrides (test seam). Falls back to `process.env.PATH`. */
+    pathEnv?: string;
+    /** Path-style overrides (test seam). Falls back to `process.env.ROY_AGENT_CLI`. */
+    royAgentCliEnv?: string;
+    /**
+     * Path-style overrides (test seam). Falls back to
+     * `process.env.NODE_ENV`. When `"production"`, the hardcoded
+     * dev paths are skipped entirely.
+     */
+    nodeEnv?: string | undefined;
+}
+/**
+ * Resolve the `roy-agent` executable used by the operations /
+ * tasks-tree / chat pipelines. See the file-level JSDoc for the
+ * full resolution algorithm.
+ *
+ * Pure function — accepts an `options` parameter so tests can inject
+ * `cwd` / `pathEnv` / `royAgentCliEnv` / `nodeEnv` without mutating
+ * `process.*`. Production callers omit the parameter and let it
+ * default to the live `process` snapshot.
+ */
+export declare function resolveRoyAgentCliPath(override: string | undefined, options?: ResolveRoyAgentCliPathOptions): string;
+//# sourceMappingURL=cli-path-resolver.d.ts.map

package/dist/cli-path-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-path-resolver.d.ts","sourceRoot":"","sources":["../src/cli-path-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AAMH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,MAAM,GAAG,SAAS,CAsBpB;AAED,MAAM,WAAW,6BAA6B;IAC5C,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,GAAE,6BAAkC,GAC1C,MAAM,CAgGR"}

package/dist/cli-path-resolver.js

@@ -0,0 +1,187 @@
+/**
+ * @fileoverview `roy-agent` CLI path resolver — Task #2895 (v2 PATH-first).
+ *
+ * ## User direction
+ *
+ * User correction (Task #2895 v2): "task-show的实现机制估计是有问题
+ * 的，需要用系统的roy-agent命令行，而不需要去特定地方找roy-agent
+ * 所需的bin啥的呀"
+ *
+ * Translation: "task-show's implementation mechanism is likely wrong —
+ * it should use the system `roy-agent` CLI, not look for the binary in
+ * specific source-layout locations."
+ *
+ * ## Background (Task #2893)
+ *
+ * v2.5.8 added a fallback HTML page so the `AdapterError: CLI exited
+ * with code 1 and no parseable JSON envelope` error no longer bubbles
+ * to the user. The fallback was visible because the underlying CLI
+ * call **still exits 1**.
+ *
+ * The previous resolution logic preferred hardcoded paths:
+ *   1. `cfg.royAgentCliPath`
+ *   2. `$ROY_AGENT_CLI`
+ *   3. `<cwd>/../roy-agent/packages/cli/dist/bin/roy-agent.js`
+ *      (sibling-repo / monorepo source layout)
+ *   4. `roy-agent` on PATH
+ *
+ * When the user runs `roy-agent run` inside the `roy-agent` monorepo,
+ * step #3 picks the monorepo `roy-agent.js` source file. Without a
+ * locally-built `better_sqlite3.node` binding, that source crashes on
+ * startup with exit 1 and 100+ KiB of stderr — yielding the
+ * `AdapterError` users see.
+ *
+ * ## Resolution order (this module — Task #2895 v2)
+ *
+ *   1. PATH `roy-agent` (`which`-style lookup, executable-bit check).
+ *      The bundled `@ai-setting/roy-agent-standalone@1.7.6` binary
+ *      ships with native bindings embedded — always works regardless
+ *      of cwd / install layout.
+ *   2. Explicit override (`cfg.royAgentCliPath`) when the file exists.
+ *      Advanced users only.
+ *   3. `$ROY_AGENT_CLI` env var when the file exists.
+ *   4. Dev hardcoded paths — ONLY when `NODE_ENV !== 'production'`.
+ *      Lets plugin authors iterate on the `roy-agent` monorepo without
+ *      installing the standalone binary globally.
+ *   5. None of the above → soft fallback: return the literal string
+ *      `"roy-agent"` (the OS spawn will look it up via `$PATH` at exec
+ *      time) and emit a one-time `process.stderr` warning. This
+ *      preserves the v2.5.8 sendIndex failsafe UX (the existing
+ *      `AdapterError` will trigger the fallback HTML page with the
+ *      Retry button) **without** throwing out of the plugin
+ *      constructor — a hard throw would prevent the HTTP server from
+ *      ever starting, which is strictly worse than letting users see
+ *      the retry-friendly fallback page. Operators who want a quieter
+ *      experience can install `@ai-setting/roy-agent-standalone`
+ *      globally so step #1 finds it.
+ *
+ * Pure functions only — exported for unit tests.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * Locate `roy-agent` on `$PATH`. Returns the first hit or `undefined`
+ * when no executable named `roy-agent` is discoverable.
+ *
+ * Pure function — exported for tests. Behaviour:
+ *   - Splits `$PATH` on `path.delimiter` (POSIX `:` / Windows `;`).
+ *   - For each directory, checks `<dir>/roy-agent`.
+ *   - Accepts either a regular file or a symlink to one.
+ *   - Skips directories that don't exist (no throw).
+ *
+ * This is a *Node-side* check (fs.statSync), not a shell `which`.
+ On Linux/macOS we additionally require the executable bit to be
+ * set; on Windows we accept anything that's a file or symlink since
+ * executable-bit semantics are looser there. The plugin runs on
+ * Linux/macOS in practice (verified by the user's report).
+ */
+export function findRoyAgentOnPath(pathEnv) {
+    if (!pathEnv)
+        return undefined;
+    const dirs = pathEnv.split(path.delimiter);
+    for (const dir of dirs) {
+        if (!dir)
+            continue;
+        const candidate = path.join(dir, "roy-agent");
+        try {
+            const st = fs.statSync(candidate);
+            if (st.isFile() || st.isSymbolicLink()) {
+                // On POSIX, require executable bit; on Windows we accept any
+                // file (executable bit semantics are looser there).
+                if (process.platform !== "win32") {
+                    // 0o111 = owner+group+other execute bits
+                    if ((st.mode & 0o111) === 0)
+                        continue;
+                }
+                return candidate;
+            }
+        }
+        catch {
+            /* not found here — try next */
+        }
+    }
+    return undefined;
+}
+/**
+ * Resolve the `roy-agent` executable used by the operations /
+ * tasks-tree / chat pipelines. See the file-level JSDoc for the
+ * full resolution algorithm.
+ *
+ * Pure function — accepts an `options` parameter so tests can inject
+ * `cwd` / `pathEnv` / `royAgentCliEnv` / `nodeEnv` without mutating
+ * `process.*`. Production callers omit the parameter and let it
+ * default to the live `process` snapshot.
+ */
+export function resolveRoyAgentCliPath(override, options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const pathEnv = options.pathEnv ?? process.env?.PATH;
+    const royAgentCliEnv = options.royAgentCliEnv ?? process.env?.ROY_AGENT_CLI;
+    const nodeEnv = options.nodeEnv !== undefined
+        ? options.nodeEnv
+        : process.env?.NODE_ENV;
+    // 1. PATH `roy-agent` — system binary wins.
+    const onPath = findRoyAgentOnPath(pathEnv);
+    if (onPath)
+        return onPath;
+    // 2. Explicit override (advanced / power-user knob).
+    if (override && fs.existsSync(override))
+        return override;
+    // 3. Env var override (same escape hatch, env-driven).
+    if (royAgentCliEnv && fs.existsSync(royAgentCliEnv))
+        return royAgentCliEnv;
+    // 4. Developer escape hatch — hardcoded paths ONLY in dev.
+    const isDev = nodeEnv !== "production";
+    if (isDev) {
+        const devPaths = [
+            // sibling-repo layout — cwd is `<workspace>/roy-agent/` so
+            // `..` gives `<workspace>/` and the resolved path lands at
+            // `<workspace>/roy-agent/packages/cli/dist/bin/roy-agent.js`.
+            path.resolve(cwd, "..", "roy-agent", "packages", "cli", "dist", "bin", "roy-agent.js"),
+        ];
+        // monorepo layout — derive from `import.meta.url` so the plugin
+        // package's own location points at the host monorepo's CLI
+        // build. We try-catch because `import.meta.url` is not
+        // available in every runtime.
+        try {
+            const metaUrl = typeof import.meta !== "undefined" ? import.meta.url : undefined;
+            if (metaUrl) {
+                const here = path.dirname(fileURLToPath(metaUrl));
+                devPaths.push(path.resolve(here, "..", "..", "..", "..", "packages", "cli", "dist", "bin", "roy-agent.js"));
+            }
+        }
+        catch {
+            /* import.meta unavailable — skip */
+        }
+        for (const p of devPaths) {
+            if (p && fs.existsSync(p))
+                return p;
+        }
+    }
+    // 5. Last resort — return the literal string `"roy-agent"` so the
+    // OS spawn will look it up via `$PATH` at exec time. This
+    // preserves the v2.5.8 failsafe behaviour: if PATH has a
+    // `roy-agent` binary at runtime (e.g. the operator installed it
+    // between resolve time and spawn time), it still works. If not,
+    // `runTasksTree` will throw `AdapterError` and the existing
+    // sendIndex fallback page will render — same UX as before this
+    // fix, but with the PATH-first ordering in the common case.
+    //
+    // We deliberately don't throw here. Hard-throwing from the plugin
+    // constructor would mean the HTTP server never starts, which is
+    // a worse UX than the existing fallback page (the user still
+    // gets a working UI with `/task/<id>` pages). Operators see a
+    // one-time console message instructing them to install the
+    // standalone binary globally for a quieter experience.
+    if (typeof process !== "undefined" && process.stderr) {
+        process.stderr.write("[roy-plugin-task-show] WARN: cannot locate `roy-agent` CLI " +
+            "via $PATH, cfg.royAgentCliPath override, $ROY_AGENT_CLI env var" +
+            (isDev ? ", or dev-mode sibling/monorepo paths" : "") +
+            ". Falling back to literal `roy-agent` (will rely on $PATH at " +
+            "spawn time). Install `@ai-setting/roy-agent-standalone` " +
+            "globally (`npm i -g @ai-setting/roy-agent-standalone`) for a " +
+            "quieter experience.\n");
+    }
+    return override ?? "roy-agent";
+}
+//# sourceMappingURL=cli-path-resolver.js.map

package/dist/cli-path-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-path-resolver.js","sourceRoot":"","sources":["../src/cli-path-resolver.ts"],"names":[],"mappings":"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"}

package/dist/plugin.d.ts

@@ -179,13 +179,10 @@ export declare class TaskShowPlugin implements TaskShowPluginInterface {
     private registered;
     constructor(config?: Partial<TaskShowConfig>);
     /**
-     * Resolve the `roy-agent` executable to use for the operations pipeline.
-     * Resolution order:
-     *   1. Explicit override (`cfg.royAgentCliPath`) if it exists
-     *   2. `$ROY_AGENT_CLI` env var if it exists
-     *   3. `<cwd>/../roy-agent/packages/cli/dist/bin/roy-agent.js`
-     *      (the typical layout when both repos live side-by-side)
-     *   4. The global `roy-agent` on PATH (best-effort)
+     * Thin alias to the module-level `resolveRoyAgentCliPath` in
+     * `./cli-path-resolver.js`. Kept as a method so existing callers
+     * (and subclasses) keep working. See the cli-path-resolver module
+     * for the full Task #2895 PATH-first algorithm.
      */
     private resolveRoyAgentCliPath;
     /**

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EACV,aAAa,EAIb,cAAc,EAGf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AA8C1C;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,YAAsB,GAC7B,IAAI,CAGN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,GAAG,IAAI,CAwBP;AAMD;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,GAAG,EACR,MAAM,GAAE,qBAA+B,GACtC,MAAM,CA6BR;AAkBD;;;;GAIG;AACH,wBAAgB,uCAAuC,IAAI,IAAI,CAE9D;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,IAAI,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,yCAAyC;IACzC,aAAa,IAAI,MAAM,GAAG,IAAI,CAAC;IAC/B,yCAAyC;IACzC,YAAY,IAAI,iBAAiB,CAAC;IAClC,yCAAyC;IACzC,WAAW,IAAI,QAAQ,CAAC;IACxB,uEAAuE;IACvE,SAAS,IAAI,cAAc,CAAC;IAC5B;;;OAGG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7C;AAED;;;GAGG;AACH,qBAAa,cAAe,YAAW,uBAAuB;IAC5D,QAAQ,CAAC,IAAI,0BAA0B;IACvC,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,WAAW,0SACqR;IAEzS,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiB;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,2DAA2D;IAC3D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,+EAA+E;IAC/E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAChD,OAAO,CAAC,GAAG,CAA8B;IACzC,OAAO,CAAC,QAAQ,CAAS;IAEzB;;;;;;;;;OASG;IACH,OAAO,CAAC,aAAa,CAA8D;IAEnF;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB,CAA0B;IAClD,gHAAgH;IAChH,OAAO,CAAC,UAAU,CAAyC;gBAE/C,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IA6G5C;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAI9B;;;;OAIG;IACG,IAAI,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAyC7C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgD9B,aAAa,IAAI,MAAM,GAAG,IAAI;IAK9B,YAAY,IAAI,iBAAiB;IAIjC,WAAW,IAAI,QAAQ;IAIvB,SAAS,IAAI,cAAc;IAI3B,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAQ3C;;;;;;;;OAQG;IACG,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBtF;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;;;OAIG;IACG,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA4GrF;;;;OAIG;IACG,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAyCjD;;;;;;;;OAQG;IACG,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAoChD;;;;;;;;;;;;;;OAcG;IACG,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAuFlD;;;;OAIG;IACG,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhD;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAYjB;;;;OAIG;IACH,OAAO,CAAC,aAAa;YA2EP,wBAAwB;IAuCtC;;;;OAIG;IACH;;;;;;;OAOG;IACH,OAAO,CAAC,wBAAwB;IA6BhC;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,kBAAkB;CAM3B;AAgCD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAErF;AAED;;;GAGG;AACH,eAAe,cAAc,CAAC"}

package/dist/plugin.js

@@ -43,9 +43,7 @@ import { defaultRunner as defaultCliRunner, makeTaskOperationsSource, } from "./
 import { defaultRunner as defaultTreeCliRunner, makeTasksTreeSource, } from "./cli-tasks-tree-adapter.js";
 import { TasksTreeCache } from "./tasks-tree-cache.js";
 import { TaskSessionStore, } from "./task-session-store.js";
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
+import { resolveRoyAgentCliPath as resolveRoyAgentCliPathImpl } from "./cli-path-resolver.js";
 // ============================================================================
 // Logger
 // ============================================================================
@@ -330,38 +328,13 @@ export class TaskShowPlugin {
         });
     }
     /**
-     * Resolve the `roy-agent` executable to use for the operations pipeline.
-     * Resolution order:
-     *   1. Explicit override (`cfg.royAgentCliPath`) if it exists
-     *   2. `$ROY_AGENT_CLI` env var if it exists
-     *   3. `<cwd>/../roy-agent/packages/cli/dist/bin/roy-agent.js`
-     *      (the typical layout when both repos live side-by-side)
-     *   4. The global `roy-agent` on PATH (best-effort)
+     * Thin alias to the module-level `resolveRoyAgentCliPath` in
+     * `./cli-path-resolver.js`. Kept as a method so existing callers
+     * (and subclasses) keep working. See the cli-path-resolver module
+     * for the full Task #2895 PATH-first algorithm.
      */
     resolveRoyAgentCliPath(override) {
-        const tries = [];
-        if (override)
-            tries.push(override);
-        if (process.env?.ROY_AGENT_CLI)
-            tries.push(process.env.ROY_AGENT_CLI);
-        // sibling-repo layout
-        tries.push(path.resolve(process.cwd(), "..", "roy-agent", "packages", "cli", "dist", "bin", "roy-agent.js"));
-        // monorepo layout
-        try {
-            const metaUrl = typeof import.meta !== "undefined" ? import.meta.url : undefined;
-            if (metaUrl) {
-                const here = path.dirname(fileURLToPath(metaUrl));
-                tries.push(path.resolve(here, "..", "..", "..", "..", "packages", "cli", "dist", "bin", "roy-agent.js"));
-            }
-        }
-        catch {
-            /* fall through */
-        }
-        for (const c of tries) {
-            if (c && fs.existsSync(c))
-                return c;
-        }
-        return override ?? "roy-agent";
+        return resolveRoyAgentCliPathImpl(override);
     }
     /**
      * Called by the loader (or by tests) with the host's `PluginEnv`. We use