@researai/deepscientist 1.5.12 → 1.5.14

package/bin/ds.js

@@ -36,11 +36,15 @@ const pythonCommands = new Set([
 const UPDATE_PACKAGE_NAME = String(packageJson.name || '@researai/deepscientist').trim() || '@researai/deepscientist';
 const UPDATE_CHECK_TTL_MS = 12 * 60 * 60 * 1000;
 
-const optionsWithValues = new Set(['--home', '--host', '--port', '--quest-id', '--mode', '--proxy', '--codex-profile']);
+const optionsWithValues = new Set(['--home', '--host', '--port', '--quest-id', '--mode', '--proxy', '--codex-profile', '--codex']);
 
-function buildCodexOverrideEnv({ yolo = false, profile = null } = {}) {
+function buildCodexOverrideEnv({ yolo = false, profile = null, binary = null } = {}) {
   const normalizedProfile = typeof profile === 'string' ? profile.trim() : '';
+  const normalizedBinary = typeof binary === 'string' ? binary.trim() : '';
   const overrides = {};
+  if (normalizedBinary) {
+    overrides.DEEPSCIENTIST_CODEX_BINARY = normalizedBinary;
+  }
   if (!yolo) {
     if (normalizedProfile) {
       overrides.DEEPSCIENTIST_CODEX_PROFILE = normalizedProfile;
@@ -103,6 +107,7 @@ Launcher flags:
   --proxy <url>         Use an outbound HTTP/WS proxy for npm and Python runtime traffic
   --yolo                Run Codex in YOLO mode: approval_policy=never and sandbox_mode=danger-full-access
   --codex-profile <id>  Run DeepScientist with a specific Codex profile, for example \`m27\`
+  --codex <path>        Run DeepScientist with a specific Codex executable path for this launch
   --quest-id <id>       Open the TUI on one quest directly
 
 Update:
@@ -981,6 +986,7 @@ function parseLauncherArgs(argv) {
   let skipUpdateCheck = false;
   let yolo = false;
   let codexProfile = null;
+  let codexBinary = null;
 
   if (args[0] === 'ui') {
     args.shift();
@@ -1001,6 +1007,7 @@ function parseLauncherArgs(argv) {
     else if (arg === '--skip-update-check') skipUpdateCheck = true;
     else if (arg === '--yolo') yolo = true;
     else if (arg === '--codex-profile' && args[index + 1]) codexProfile = args[++index];
+    else if (arg === '--codex' && args[index + 1]) codexBinary = args[++index];
     else if (arg === '--host' && args[index + 1]) host = args[++index];
     else if (arg === '--port' && args[index + 1]) port = Number(args[++index]);
     else if (arg === '--home' && args[index + 1]) home = path.resolve(args[++index]);
@@ -1027,6 +1034,7 @@ function parseLauncherArgs(argv) {
     skipUpdateCheck,
     yolo,
     codexProfile,
+    codexBinary,
   };
 }
 
@@ -2321,6 +2329,10 @@ function normalizePythonCliArgs(args, home) {
       index += 1;
       continue;
     }
+    if (arg === '--codex') {
+      index += 1;
+      continue;
+    }
     normalized.push(arg);
   }
   return ['--home', home, ...normalized];
@@ -4002,7 +4014,11 @@ async function launcherMain(rawArgs) {
 
   const pythonRuntime = ensurePythonRuntime(home);
   const runtimePython = pythonRuntime.runtimePython;
-  const codexOverrideEnv = buildCodexOverrideEnv({ yolo: options.yolo, profile: options.codexProfile });
+  const codexOverrideEnv = buildCodexOverrideEnv({
+    yolo: options.yolo,
+    profile: options.codexProfile,
+    binary: options.codexBinary,
+  });
   ensureInitialized(home, runtimePython);
   if (await maybeHandleStartupUpdate(home, rawArgs, options)) {
     return true;
@@ -4083,6 +4099,7 @@ async function main() {
     const codexOverrideEnv = buildCodexOverrideEnv({
       yolo: args.includes('--yolo'),
       profile: readOptionValue(args, '--codex-profile'),
+      binary: readOptionValue(args, '--codex'),
     });
     if (positional.value === 'run' || positional.value === 'daemon') {
       maybePrintOptionalLatexNotice(home);

package/docs/en/00_QUICK_START.md

@@ -79,7 +79,7 @@ npm install -g @researai/deepscientist
 
 This installs the `ds` command globally.
 
-DeepScientist depends on a working Codex CLI. The npm package tries to bring the bundled Codex dependency with it, but if `codex` is still missing afterward, repair it explicitly:
+DeepScientist depends on a working Codex CLI. It prefers the `codex` already available on your machine and only falls back to the bundled npm dependency when no local Codex path is available. If `codex` is still missing afterward, repair it explicitly:
 
 ```bash
 npm install -g @openai/codex
@@ -124,25 +124,44 @@ ds doctor
 If you already use a named Codex profile for MiniMax, GLM, Volcengine Ark, Alibaba Bailian, or another provider-backed path, verify that profile first in a terminal:
 
 ```bash
-codex --profile minimax
+codex --profile m27
 ```
 
 Then run DeepScientist through the same profile:
 
 ```bash
-ds doctor --codex-profile minimax
+ds doctor --codex-profile m27
 ```
 
 and later:
 
 ```bash
-ds --codex-profile minimax
+ds --codex-profile m27
 ```
 
-Replace `minimax` with the real profile name you created, such as `m27`, `glm`, `ark`, or `bailian`.
+If you need one specific Codex binary for this run, add `--codex` too:
+
+```bash
+ds doctor --codex /absolute/path/to/codex --codex-profile m27
+ds --codex /absolute/path/to/codex --codex-profile m27
+```
+
+`m27` is the MiniMax profile name used consistently in this repo. MiniMax's own page currently uses `m21`, but the profile name is only a local alias; if you created a different name, use that same name in all commands.
 
 DeepScientist blocks startup until Codex can pass a real hello probe. By default, the runner model in `~/DeepScientist/config/runners.yaml` is `gpt-5.4`. If your profile expects the model to come from the profile itself, use `model: inherit` in `runners.yaml`, or simply launch with `--codex-profile <name>` and let that session inherit the profile-defined model.
 
+MiniMax note:
+
+- if the current `@openai/codex` latest does not work with MiniMax, install `npm install -g @openai/codex@0.57.0`
+- create a MiniMax `Coding Plan Key` first
+- clear `OPENAI_API_KEY` and `OPENAI_BASE_URL` in the current shell before exporting `MINIMAX_API_KEY`
+- use `https://api.minimaxi.com/v1`
+- the `codex-MiniMax-*` model names shown on MiniMax's current Codex CLI page did not pass reliably through Codex CLI in local testing with the provided key
+- the locally verified working model name is `MiniMax-M2.7`
+- DeepScientist can auto-adapt MiniMax's profile-only `model_provider` / `model` config shape during probe and runtime
+- if you also want plain terminal `codex --profile <name>` to work directly, add `model_provider = "minimax"` and `model = "MiniMax-M2.7"` at the top level of `~/.codex/config.toml`
+- DeepScientist automatically downgrades `xhigh` to `high` when it detects an older Codex CLI that does not support `xhigh`
+
 ## 3. Start the Local Runtime
 
 Run:

package/docs/en/01_SETTINGS_REFERENCE.md

@@ -430,6 +430,8 @@ claude:
 - UI label: `Binary`
 - Meaning: command name or absolute path used to launch the runner.
 - `Test` behavior: checks whether the binary is on `PATH`.
+- Resolution order for `codex`: env override, explicit path, local `PATH`, then bundled fallback.
+- One-off note: you can temporarily override this with `ds --codex /absolute/path/to/codex`.
 - First-run note: DeepScientist does not finish Codex authentication for you. Before the first `ds`, make sure `codex --login` (or `codex`) has completed successfully.
 - Repair note: if the bundled dependency is missing after `npm install -g @researai/deepscientist`, install Codex explicitly with `npm install -g @openai/codex`.
 
@@ -448,6 +450,7 @@ claude:
 - Meaning: optional Codex profile name passed through as `codex --profile <name>`.
 - Use this when your Codex CLI is already configured for a provider-backed setup such as MiniMax, GLM, Volcengine Ark, or Alibaba Bailian.
 - One-off note: you can also leave this field empty and launch with `ds --codex-profile <name>`.
+- Combined note: one-off profile and binary overrides can be combined as `ds --codex /absolute/path/to/codex --codex-profile <name>`.
 
 **`model`**
 
@@ -465,6 +468,7 @@ claude:
 - UI label: `Reasoning effort`
 - Allowed values: `""`, `minimal`, `low`, `medium`, `high`, `xhigh`
 - Meaning: default reasoning intensity.
+- Compatibility note: when DeepScientist detects a Codex CLI older than `0.63.0`, it automatically downgrades `xhigh` to `high` for the startup probe and runner command. This covers MiniMax's currently recommended `@openai/codex@0.57.0` path.
 
 **`approval_policy`**