leglas 0.5.0 → 0.6.0

package/README.md

@@ -66,12 +66,15 @@ and sessions that clean up after themselves.
   precise request for your agent, file path included. The composer
   carries its own agent picker, the way every chat you already use
   carries a model picker: the CLIs found on your machine (Claude Code,
-  Codex, Cursor) are one click away next to the send button, each asked
-  for its login status so a signed-out CLI says so before a run instead
-  of failing one. Not on that list? Type the command that runs your
-  agent once, in the same menu, and Leglas hands it each request; or
-  connect an agent Leglas can't spawn (an IDE panel, an MCP host) with
-  the copy-paste MCP wiring behind "Connect another agent". Each run
+  Codex, Cursor) are one click away next to the send button. Leglas checks
+  your shell path and the conventional per-user install locations, then asks
+  each CLI for its login status so a signed-out agent says so before a run
+  instead of failing one. Claude Code and Codex can optionally override effort
+  for this project, remembered separately for each agent; `Agent default`
+  leaves the CLI's own setting untouched. To
+  work from an IDE panel or chat host, choose
+  "Connect agent via MCP" for the exact setup and a live confirmation
+  once the agent uses a Leglas tool. Each run
   reports in a card above the field: who is working, what file they
   are touching, how long it has been, a stop button while it runs and
   retry when it fails. Your agent, your subscription, no keys.
@@ -207,6 +210,13 @@ wrong. `npx leglas watch` in another terminal is the same loop with the
 agent's own output in view, and it needs no flag once an agent has been
 picked in the interface.
 
+To use a CLI that is not in the picker, keep the custom command explicit
+in the terminal:
+
+```sh
+npx leglas watch --run "my-agent {prompt}"
+```
+
 ### MCP server
 
 For agent hosts that cannot run shell commands, `leglas-mcp` exposes the

package/dist/bin.js

@@ -587,9 +587,12 @@ function nextRequest(requests, failed) {
 
 // ../server/dist/agents.js
 import { spawn } from "child_process";
-import { constants } from "fs";
+import { constants, readdirSync } from "fs";
 import { access, mkdir, readFile, writeFile } from "fs/promises";
 import { delimiter, dirname, isAbsolute, join, relative } from "path";
+var AGENT_EFFORTS = ["low", "medium", "high", "xhigh", "max"];
+var effortFlag = (effort) => effort === null ? [] : ["--effort", effort];
+var codexEffortConfig = (effort) => effort === null ? [] : ["-c", `model_reasoning_effort=${effort}`];
 var CODEX_WORKSPACE_CONFIG = [
   "-c",
   "sandbox_workspace_write.network_access=true"
@@ -598,22 +601,25 @@ var KNOWN_AGENTS = {
   claude: {
     name: "Claude",
     binary: "claude",
-    args: (prompt) => [
+    efforts: AGENT_EFFORTS,
+    args: (prompt, effort = null) => [
       "-p",
       prompt,
       "--output-format",
       "stream-json",
       "--verbose",
       "--permission-mode",
-      "acceptEdits"
+      "acceptEdits",
+      ...effortFlag(effort)
     ],
-    terminalArgs: (prompt) => [
+    terminalArgs: (prompt, effort = null) => [
       "-p",
       prompt,
       "--permission-mode",
-      "acceptEdits"
+      "acceptEdits",
+      ...effortFlag(effort)
     ],
-    resumeArgs: (sessionId, prompt) => [
+    resumeArgs: (sessionId, prompt, effort = null) => [
       "-p",
       "--resume",
       sessionId,
@@ -622,7 +628,8 @@ var KNOWN_AGENTS = {
       "stream-json",
       "--verbose",
       "--permission-mode",
-      "acceptEdits"
+      "acceptEdits",
+      ...effortFlag(effort)
     ],
     // Non-interactive Claude cannot approve a Bash call: acceptEdits covers
     // files, so a command the prompt requires is refused every time with
@@ -650,6 +657,7 @@ var KNOWN_AGENTS = {
   codex: {
     name: "Codex",
     binary: "codex",
+    efforts: AGENT_EFFORTS,
     // `--skip-git-repo-check` is what lets Codex run at all in a project the
     // user never put under version control: without it codex-cli refuses
     // before it reaches a model, with "Not inside a trusted directory and
@@ -658,18 +666,20 @@ var KNOWN_AGENTS = {
     // moves that precondition and only that: `-s workspace-write` still
     // confines writes to the project, so the sandbox boundary is unchanged,
     // and in a git repository the flag does nothing at all.
-    args: (prompt) => [
+    args: (prompt, effort = null) => [
       "exec",
       "--json",
       ...CODEX_WORKSPACE_CONFIG,
+      ...codexEffortConfig(effort),
       "-s",
       "workspace-write",
       "--skip-git-repo-check",
       prompt
     ],
-    terminalArgs: (prompt) => [
+    terminalArgs: (prompt, effort = null) => [
       "exec",
       ...CODEX_WORKSPACE_CONFIG,
+      ...codexEffortConfig(effort),
       "-s",
       "workspace-write",
       "--skip-git-repo-check",
@@ -678,12 +688,13 @@ var KNOWN_AGENTS = {
     // No sandbox flag here: `codex exec resume` refuses it and inherits the
     // session's own sandbox, which the first turn set to workspace-write. The
     // repository check is per invocation, so resume needs the flag of its own.
-    resumeArgs: (sessionId, prompt) => [
+    resumeArgs: (sessionId, prompt, effort = null) => [
       "exec",
       "resume",
       sessionId,
       "--json",
       ...CODEX_WORKSPACE_CONFIG,
+      ...codexEffortConfig(effort),
       "--skip-git-repo-check",
       prompt
     ],
@@ -695,8 +706,14 @@ var KNOWN_AGENTS = {
   cursor: {
     name: "Cursor",
     binary: "cursor-agent",
-    args: (prompt) => ["-p", prompt, "--output-format", "stream-json"],
-    terminalArgs: (prompt) => ["-p", prompt],
+    efforts: [],
+    args: (prompt, _effort = null) => [
+      "-p",
+      prompt,
+      "--output-format",
+      "stream-json"
+    ],
+    terminalArgs: (prompt, _effort = null) => ["-p", prompt],
     authArgs: ["status"],
     // UNVERIFIED: cursor-agent was not available on the build machine. The
     // reading is deliberately loose, and anything ambiguous stays unknown.
@@ -714,7 +731,11 @@ function execProbe(binary, args, timeoutMs = PROBE_TIMEOUT_MS) {
   return new Promise((resolve) => {
     let child;
     try {
-      child = spawn(binary, [...args], { shell: false, stdio: ["ignore", "pipe", "ignore"] });
+      child = spawn(binary, [...args], {
+        env: agentEnvironment(),
+        shell: false,
+        stdio: ["ignore", "pipe", "ignore"]
+      });
     } catch {
       return resolve(null);
     }
@@ -737,8 +758,50 @@ function execProbe(binary, args, timeoutMs = PROBE_TIMEOUT_MS) {
     });
   });
 }
+function agentSearchPath(env = process.env, platform = process.platform) {
+  const home = env.HOME ?? env.USERPROFILE ?? "";
+  const npmPrefix = env.NPM_CONFIG_PREFIX;
+  const versionBins = (root, suffix) => {
+    try {
+      return readdirSync(root, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => join(root, entry.name, ...suffix));
+    } catch {
+      return [];
+    }
+  };
+  const candidates = [
+    ...(env.PATH ?? "").split(delimiter),
+    env.PNPM_HOME,
+    env.NVM_BIN,
+    env.BUN_INSTALL === void 0 ? void 0 : join(env.BUN_INSTALL, "bin"),
+    env.CARGO_HOME === void 0 ? void 0 : join(env.CARGO_HOME, "bin"),
+    npmPrefix === void 0 ? void 0 : platform === "win32" ? npmPrefix : join(npmPrefix, "bin"),
+    home === "" ? void 0 : join(home, ".local", "bin"),
+    home === "" ? void 0 : join(home, ".npm-global", "bin"),
+    home === "" ? void 0 : join(home, ".bun", "bin"),
+    home === "" ? void 0 : join(home, ".cargo", "bin"),
+    home === "" ? void 0 : join(home, ".volta", "bin"),
+    home === "" ? void 0 : join(home, ".asdf", "shims"),
+    home === "" ? void 0 : join(home, ".local", "share", "mise", "shims"),
+    home === "" ? void 0 : join(home, ".local", "share", "pnpm"),
+    home === "" ? void 0 : join(home, "Library", "pnpm"),
+    ...home === "" ? [] : versionBins(join(home, ".nvm", "versions", "node"), ["bin"]),
+    ...home === "" ? [] : versionBins(join(home, ".local", "share", "fnm", "node-versions"), [
+      "installation",
+      "bin"
+    ]),
+    platform === "win32" ? env.APPDATA : void 0,
+    platform === "darwin" ? "/opt/homebrew/bin" : void 0,
+    platform === "darwin" ? "/usr/local/bin" : void 0,
+    platform === "darwin" ? "/Applications/Codex.app/Contents/Resources" : void 0,
+    platform === "darwin" ? "/Applications/Codex++.app/Contents/Resources" : void 0
+  ].filter((entry) => typeof entry === "string" && entry !== "");
+  return [...new Set(candidates)].join(delimiter);
+}
+function agentEnvironment(env = process.env) {
+  return { ...env, PATH: agentSearchPath(env) };
+}
 async function pathLookup(binary) {
-  const entries = (process.env.PATH ?? "").split(delimiter).filter((entry) => entry !== "");
+  const entries = agentSearchPath().split(delimiter).filter((entry) => entry !== "");
   const extensions = process.platform === "win32" ? (process.env.PATHEXT ?? ".COM;.EXE;.BAT;.CMD").split(";").filter((entry) => entry !== "") : [""];
   for (const entry of entries) {
     for (const extension of extensions) {
@@ -755,14 +818,22 @@ async function detectAgents(lookup = pathLookup, probe2 = execProbe) {
   const entries = Object.entries(KNOWN_AGENTS);
   return Promise.all(entries.map(async ([id, adapter]) => {
     const available = await lookup(adapter.binary).catch(() => false);
-    if (!available)
-      return { id, name: adapter.name, available, auth: "unknown" };
+    if (!available) {
+      return {
+        id,
+        name: adapter.name,
+        available,
+        auth: "unknown",
+        efforts: adapter.efforts
+      };
+    }
     const result2 = await probe2(adapter.binary, adapter.authArgs).catch(() => null);
     return {
       id,
       name: adapter.name,
       available,
-      auth: result2 === null ? "unknown" : adapter.authVerdict(result2)
+      auth: result2 === null ? "unknown" : adapter.authVerdict(result2),
+      efforts: adapter.efforts
     };
   }));
 }
@@ -889,6 +960,9 @@ function retryFrom(agent, line) {
 function isAgentChoice(value) {
   return value === "custom" || typeof value === "string" && Object.hasOwn(KNOWN_AGENTS, value);
 }
+function isAgentEffort(value) {
+  return typeof value === "string" && AGENT_EFFORTS.includes(value);
+}
 async function readWatchConfig(cwd) {
   try {
     const parsed2 = JSON.parse(await readFile(join(cwd, WATCH_PATH), "utf8"));
@@ -899,14 +973,28 @@ async function readWatchConfig(cwd) {
 }
 async function readAgentChoice(cwd) {
   const config = await readWatchConfig(cwd);
+  const agent = isAgentChoice(config.agent) ? config.agent : null;
+  const efforts = record(config.efforts);
   return {
-    agent: isAgentChoice(config.agent) ? config.agent : null,
+    agent,
+    effort: agent !== null && agent !== "custom" && isAgentEffort(efforts?.[agent]) ? efforts[agent] : null,
     run: typeof config.run === "string" && config.run !== "" ? config.run : null
   };
 }
 async function saveAgentChoice(cwd, choice) {
   const config = await readWatchConfig(cwd);
   config.agent = choice.agent;
+  if (choice.agent !== "custom" && choice.effort !== void 0) {
+    const efforts = record(config.efforts) ?? {};
+    if (choice.effort === null)
+      delete efforts[choice.agent];
+    else
+      efforts[choice.agent] = choice.effort;
+    if (Object.keys(efforts).length === 0)
+      delete config.efforts;
+    else
+      config.efforts = efforts;
+  }
   if (choice.run !== void 0)
     config.run = choice.run;
   const path = join(cwd, WATCH_PATH);
@@ -1762,7 +1850,7 @@ function resolveCommand(choice, prompt, sessionId = null, registration = null) {
       agent: choice.agent,
       name: adapter.name,
       command: adapter.binary,
-      args: [...adapter.resumeArgs(sessionId, prompt), ...allow],
+      args: [...adapter.resumeArgs(sessionId, prompt, choice.effort), ...allow],
       resumed: true
     };
   }
@@ -1770,7 +1858,7 @@ function resolveCommand(choice, prompt, sessionId = null, registration = null) {
     agent: choice.agent,
     name: adapter.name,
     command: adapter.binary,
-    args: [...adapter.args(prompt), ...allow],
+    args: [...adapter.args(prompt, choice.effort), ...allow],
     resumed: false
   };
 }
@@ -1793,7 +1881,7 @@ function lineReader(stream, onLine) {
   return flush;
 }
 function defaultSpawn(command, args, options) {
-  return nodeSpawn(command, args, options);
+  return nodeSpawn(command, args, { ...options, env: agentEnvironment() });
 }
 function startRunner(options) {
   const spawn5 = options.spawn ?? defaultSpawn;
@@ -2303,18 +2391,16 @@ async function startServer(options) {
     });
     return agentsInflight;
   };
-  const currentAgents = () => {
-    if (agentsCache === null)
+  const currentAgents = (refresh = false) => {
+    if (refresh || agentsCache === null || Date.now() - agentsCache.at > AGENTS_FRESH_MS) {
       return probeAgents();
-    if (Date.now() - agentsCache.at > AGENTS_FRESH_MS) {
-      void probeAgents().catch(() => {
-      });
     }
     return Promise.resolve(agentsCache.agents);
   };
   const server = http2.createServer((req, res) => {
     const url = req.url ?? "/";
     const path = url.split("?")[0] ?? "/";
+    const query = new URLSearchParams(url.includes("?") ? url.slice(url.indexOf("?") + 1) : "");
     if (req.method === "POST" && path.startsWith(`${LEGLAS_PREFIX}/api/`) && !isTrustedMutation(req)) {
       return sendJson(res, 403, { ok: false, error: "Cross-origin API mutations are refused." });
     }
@@ -2454,10 +2540,14 @@ async function startServer(options) {
       });
     }
     if (path === `${LEGLAS_PREFIX}/api/agents` && req.method === "GET") {
-      return void Promise.all([currentAgents(), readAgentChoice(cwd)]).then(([agents, choice]) => sendJson(res, 200, {
+      return void Promise.all([
+        currentAgents(query.get("refresh") === "1"),
+        readAgentChoice(cwd)
+      ]).then(([agents, choice]) => sendJson(res, 200, {
         agents,
         choice: choice.agent,
-        customRun: choice.run
+        customRun: choice.run,
+        effort: choice.effort
       }));
     }
     if (path === `${LEGLAS_PREFIX}/api/agent` && req.method === "POST") {
@@ -2485,7 +2575,17 @@ async function startServer(options) {
         if (parsed2.run !== void 0 && typeof parsed2.run !== "string") {
           return sendJson(res, 400, { ok: false, error: "The custom run command must be a string." });
         }
+        const effort = parsed2.effort === null || isAgentEffort(parsed2.effort) ? parsed2.effort : void 0;
+        if (parsed2.effort !== void 0 && effort === void 0) {
+          return sendJson(res, 400, { ok: false, error: "Effort must be a supported level or null." });
+        }
         if (parsed2.agent === "custom") {
+          if (effort !== void 0) {
+            return sendJson(res, 400, {
+              ok: false,
+              error: "Custom agents manage effort in their own command."
+            });
+          }
           if (typeof parsed2.run !== "string") {
             return sendJson(res, 400, { ok: false, error: "A custom agent needs a run command." });
           }
@@ -2494,7 +2594,16 @@ async function startServer(options) {
             return sendJson(res, 400, { ok: false, error: template.error });
           return void saveAgentChoice(cwd, { agent: "custom", run: parsed2.run }).then(() => sendJson(res, 200, { ok: true }), () => sendJson(res, 500, { ok: false, error: "Agent choice could not be saved." }));
         }
-        return void saveAgentChoice(cwd, { agent: parsed2.agent }).then(() => sendJson(res, 200, { ok: true }), () => sendJson(res, 500, { ok: false, error: "Agent choice could not be saved." }));
+        if (effort !== void 0 && effort !== null && !KNOWN_AGENTS[parsed2.agent].efforts.includes(effort)) {
+          return sendJson(res, 400, {
+            ok: false,
+            error: `${KNOWN_AGENTS[parsed2.agent].name} does not expose an effort override.`
+          });
+        }
+        return void saveAgentChoice(cwd, {
+          agent: parsed2.agent,
+          ...effort === void 0 ? {} : { effort }
+        }).then(() => sendJson(res, 200, { ok: true }), () => sendJson(res, 500, { ok: false, error: "Agent choice could not be saved." }));
       });
     }
     if (path === `${LEGLAS_PREFIX}/api/watch` && req.method === "POST") {
@@ -3778,7 +3887,7 @@ async function runWatch(options, deps) {
     const adapter = KNOWN_AGENTS[saved.agent];
     template = {
       command: adapter.binary,
-      args: adapter.terminalArgs(PROMPT_TOKEN)
+      args: adapter.terminalArgs(PROMPT_TOKEN, saved.effort)
     };
     shownCommand2 = [template.command, ...template.args].join(" ");
     synthesizedAgent = adapter.name;