@researai/deepscientist 1.5.3 → 1.5.4

package/README.md

@@ -55,7 +55,7 @@ Use `ds --home <path>` if you want to place the runtime somewhere else.
 If you want to use the current working directory directly as the DeepScientist home, use:
 
 ```bash
-ds --hero
+ds --here
 ```
 
 This is equivalent to launching with `ds --home "$PWD"`.

package/bin/ds.js

@@ -35,7 +35,6 @@ 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 UPDATE_PROMPT_TTL_MS = 12 * 60 * 60 * 1000;
 
 const optionsWithValues = new Set(['--home', '--host', '--port', '--quest-id', '--mode']);
 
@@ -48,8 +47,8 @@ Usage:
   ds update --check
   ds update --yes
   ds migrate /data/DeepScientist
-  ds --hero
-  ds --hero doctor
+  ds --here
+  ds --here doctor
   ds --tui
   ds --both
   ds --host 0.0.0.0 --port 21000
@@ -71,7 +70,7 @@ Launcher flags:
   --stop                Stop the managed daemon
   --restart             Restart the managed daemon
   --home <path>         Use a custom DeepScientist home
-  --hero                Use the current working directory as DeepScientist home
+  --here                Use the current working directory as DeepScientist home
   --quest-id <id>       Open the TUI on one quest directly
 
 Update:
@@ -185,10 +184,7 @@ function detectInstallMode(rootPath = repoRoot) {
 }
 
 function updateManualCommand(installMode) {
-  if (installMode === 'npm-package') {
-    return `npm install -g ${UPDATE_PACKAGE_NAME}@latest`;
-  }
-  return 'git pull && bash install.sh';
+  return `npm install -g ${UPDATE_PACKAGE_NAME}@latest`;
 }
 
 function updateSupportSummary(installMode, npmBinary, launcherPath) {
@@ -203,14 +199,14 @@ function updateSupportSummary(installMode, npmBinary, launcherPath) {
     return {
       canCheck: true,
       canSelfUpdate: false,
-      reason: 'This DeepScientist installation comes from a source checkout and should be updated from Git.',
+      reason: 'Self-update is disabled for this installation. Use the npm command below to install the latest release build.',
     };
   }
   if (!launcherPath || !fs.existsSync(launcherPath)) {
     return {
       canCheck: true,
       canSelfUpdate: false,
-      reason: 'The launcher entrypoint could not be resolved.',
+      reason: 'Self-update is disabled because the launcher entrypoint could not be resolved. Use the npm command below instead.',
     };
   }
   return {
@@ -288,14 +284,17 @@ function buildUpdateStatus(home, statePatch = {}) {
   const support = updateSupportSummary(installMode, npmBinary, launcherPath);
   const currentVersion = normalizeVersion(state.current_version || packageJson.version);
   const latestVersion = normalizeVersion(state.latest_version || '');
+  const promptedVersion = normalizeVersion(state.last_prompted_version || '');
   const updateAvailable = Boolean(latestVersion) && compareVersions(latestVersion, currentVersion) > 0;
   const skippedVersion = normalizeVersion(state.last_skipped_version || '');
+  const promptedCurrentTarget = Boolean(updateAvailable && promptedVersion && promptedVersion === latestVersion);
   const skippedCurrentTarget = Boolean(updateAvailable && skippedVersion && skippedVersion === latestVersion);
   const promptRecommended =
     Boolean(updateAvailable)
     && !Boolean(state.busy)
+    && !promptedCurrentTarget
     && !skippedCurrentTarget
-    && isExpired(state.last_prompted_at || state.last_deferred_at, UPDATE_PROMPT_TTL_MS);
+    ;
 
   return {
     ok: true,
@@ -311,6 +310,7 @@ function buildUpdateStatus(home, statePatch = {}) {
     last_checked_at: state.last_checked_at || null,
     last_check_error: state.last_check_error || null,
     last_prompted_at: state.last_prompted_at || null,
+    last_prompted_version: promptedVersion || null,
     last_deferred_at: state.last_deferred_at || null,
     last_skipped_version: skippedVersion || null,
     last_update_started_at: state.last_update_started_at || null,
@@ -354,10 +354,12 @@ function checkForUpdates(home, { force = false, timeoutMs = 3500 } = {}) {
 }
 
 function markUpdateDeferred(home, version) {
+  const normalizedVersion = normalizeVersion(version || readUpdateState(home).latest_version || '');
   const patched = mergeUpdateState(home, {
     last_prompted_at: new Date().toISOString(),
     last_deferred_at: new Date().toISOString(),
-    latest_version: normalizeVersion(version || readUpdateState(home).latest_version || '') || null,
+    last_prompted_version: normalizedVersion || null,
+    latest_version: normalizedVersion || null,
   });
   return buildUpdateStatus(home, patched);
 }
@@ -366,6 +368,7 @@ function markUpdateSkipped(home, version) {
   const normalized = normalizeVersion(version);
   const patched = mergeUpdateState(home, {
     last_prompted_at: new Date().toISOString(),
+    last_prompted_version: normalized || null,
     last_skipped_version: normalized || null,
   });
   return buildUpdateStatus(home, patched);
@@ -393,7 +396,7 @@ function resolveHome(args) {
   if (index >= 0 && index + 1 < args.length) {
     return path.resolve(args[index + 1]);
   }
-  if (args.includes('--hero') || args.includes('--here')) {
+  if (args.includes('--here')) {
     return process.cwd();
   }
   if (process.env.DEEPSCIENTIST_HOME) {
@@ -566,7 +569,7 @@ function renderLaunchHints({ home, url, bindUrl, pythonSelection }) {
   renderKeyValueRows([
     ['ds --port 21000', 'Change the web port'],
     ['ds --host 0.0.0.0 --port 21000', 'Bind on all interfaces'],
-    ['ds --hero', 'Use the current directory as home'],
+    ['ds --here', 'Use the current directory as home'],
     ['ds --both', 'Start web + TUI together'],
     ['ds --tui', 'Start the terminal workspace only'],
     ['ds --no-browser', 'Do not auto-open the browser'],
@@ -2031,7 +2034,7 @@ function normalizePythonCliArgs(args, home) {
       index += 1;
       continue;
     }
-    if (arg === '--hero' || arg === '--here') {
+    if (arg === '--here') {
       continue;
     }
     normalized.push(arg);
@@ -2492,96 +2495,11 @@ function runNpmInstallLatest(home, npmBinary) {
   };
 }
 
-async function promptUpdateAction(status) {
-  const options = [
-    {
-      value: 'update',
-      label: status.can_self_update ? 'Update now' : 'Show manual update',
-    },
-    { value: 'later', label: 'Remind me later' },
-    { value: 'skip', label: 'Skip this version' },
-  ];
-  if (!process.stdin.isTTY || !process.stdout.isTTY) {
-    return 'later';
-  }
-  return new Promise((resolve) => {
-    let selected = 1;
-    const lines = [
-      '',
-      'A new DeepScientist version is available.',
-      '',
-      `Current: ${status.current_version}`,
-      `Latest:  ${status.latest_version || 'unknown'}`,
-      '',
-      status.can_self_update
-        ? 'What do you want to do?'
-        : 'Self-update is not available for this installation. Choose an action:',
-    ];
-
-    const cleanup = () => {
-      process.stdin.off('keypress', onKeypress);
-      if (process.stdin.isTTY) {
-        process.stdin.setRawMode(false);
-      }
-      process.stdin.pause();
-      console.log('');
-    };
-
-    const render = () => {
-      console.clear();
-      for (const line of lines) {
-        console.log(line);
-      }
-      for (let index = 0; index < options.length; index += 1) {
-        const option = options[index];
-        console.log(`${index === selected ? '>' : ' '} ${option.label}`);
-      }
-      console.log('');
-      console.log('Use ↑/↓ and Enter.');
-    };
-
-    const onKeypress = (_str, key) => {
-      if (key?.name === 'up') {
-        selected = (selected - 1 + options.length) % options.length;
-        render();
-        return;
-      }
-      if (key?.name === 'down') {
-        selected = (selected + 1) % options.length;
-        render();
-        return;
-      }
-      if (key?.name === 'return') {
-        const choice = options[selected].value;
-        cleanup();
-        resolve(choice);
-        return;
-      }
-      if (key?.ctrl && key?.name === 'c') {
-        cleanup();
-        resolve('later');
-      }
-    };
-
-    readline.emitKeypressEvents(process.stdin);
-    process.stdin.setRawMode(true);
-    process.stdin.resume();
-    process.stdin.on('keypress', onKeypress);
-    render();
-  });
-}
-
 function printUpdateStatus(status, { compact = false } = {}) {
   if (compact) {
     if (status.update_available) {
-      console.log(
-        `DeepScientist update available: ${status.current_version} -> ${status.latest_version}`
-      );
-      if (status.can_self_update) {
-        console.log('Run `ds update --yes` to install it.');
-      } else {
-        console.log(`Manual update: ${status.manual_update_command}`);
-      }
+      console.log(`DeepScientist update available: ${status.current_version} -> ${status.latest_version}`);
+      console.log(`Update with: ${status.manual_update_command}`);
       return;
     }
     console.log(`DeepScientist is up to date (${status.current_version}).`);
@@ -2594,16 +2512,15 @@ function printUpdateStatus(status, { compact = false } = {}) {
     ['Latest', status.latest_version || 'unknown'],
     ['Available', status.update_available ? 'yes' : 'no'],
     ['Install mode', status.install_mode],
-    ['Self-update', status.can_self_update ? 'supported' : 'manual-only'],
     ['Last checked', status.last_checked_at || 'never'],
   ]);
   if (status.last_check_error) {
     console.log('');
     console.log(`Version check error: ${status.last_check_error}`);
   }
-  if (!status.can_self_update) {
+  if (status.update_available || status.manual_update_command) {
     console.log('');
-    console.log(`Manual update command: ${status.manual_update_command}`);
+    console.log(`Update command: ${status.manual_update_command}`);
     if (status.reason) {
       console.log(status.reason);
     }
@@ -2631,26 +2548,6 @@ function spawnDetachedNode(args, options = {}) {
   return child;
 }
 
-async function restartIntoUpdatedLauncher(rawArgs) {
-  const launcherPath = resolveLauncherPath();
-  if (!launcherPath) {
-    throw new Error('Could not resolve the DeepScientist launcher after the update.');
-  }
-  const args = [launcherPath, '--skip-update-check', ...rawArgs.filter((item) => item !== '--skip-update-check')];
-  const child = spawn(process.execPath, args, {
-    cwd: repoRoot,
-    stdio: 'inherit',
-    env: process.env,
-  });
-  await new Promise((resolve, reject) => {
-    child.on('error', reject);
-    child.on('exit', (code) => {
-      process.exit(code ?? 0);
-      resolve();
-    });
-  });
-}
-
 async function performSelfUpdate(home, options = {}) {
   const status = checkForUpdates(home, { force: true });
   if (!status.update_available) {
@@ -2816,42 +2713,8 @@ async function maybeHandleStartupUpdate(home, rawArgs, options = {}) {
     return false;
   }
 
-  if (!process.stdin.isTTY || !process.stdout.isTTY) {
-    printUpdateStatus(status, { compact: true });
-    mergeUpdateState(home, {
-      last_prompted_at: new Date().toISOString(),
-    });
-    return false;
-  }
-
-  const action = await promptUpdateAction(status);
-  if (action === 'later') {
-    markUpdateDeferred(home, status.latest_version);
-    return false;
-  }
-  if (action === 'skip') {
-    markUpdateSkipped(home, status.latest_version);
-    return false;
-  }
-  if (action === 'update' && !status.can_self_update) {
-    console.log(`Manual update required: ${status.manual_update_command}`);
-    if (status.reason) {
-      console.log(status.reason);
-    }
-    markUpdateDeferred(home, status.latest_version);
-    return false;
-  }
-  if (action === 'update') {
-    console.log(`Updating DeepScientist ${status.current_version} -> ${status.latest_version} ...`);
-    const result = await performSelfUpdate(home, { restartDaemon: false });
-    if (!result.ok) {
-      console.error(result.message);
-      return false;
-    }
-    console.log(result.message);
-    await restartIntoUpdatedLauncher(rawArgs);
-    return true;
-  }
+  printUpdateStatus(status, { compact: true });
+  markUpdateDeferred(home, status.latest_version);
   return false;
 }
 
@@ -3218,32 +3081,8 @@ async function updateMain(rawArgs) {
     printUpdateStatus(status, { compact: true });
     process.exit(0);
   }
-
-  const action = await promptUpdateAction(status);
-  if (action === 'later') {
-    markUpdateDeferred(home, status.latest_version);
-    console.log('Update reminder deferred.');
-    process.exit(0);
-  }
-  if (action === 'skip') {
-    markUpdateSkipped(home, status.latest_version);
-    console.log(`Skipped ${status.latest_version}.`);
-    process.exit(0);
-  }
-  if (!status.can_self_update) {
-    console.log(`Manual update command: ${status.manual_update_command}`);
-    if (status.reason) {
-      console.log(status.reason);
-    }
-    process.exit(0);
-  }
-  const payload = await performSelfUpdate(home, {
-    host: options.host,
-    port: options.port,
-    restartDaemon: options.restartDaemon,
-  });
-  console.log(payload.message);
-  process.exit(payload.ok ? 0 : 1);
+  printUpdateStatus(status, { compact: true });
+  process.exit(0);
 }
 
 async function migrateMain(rawArgs) {
@@ -3531,6 +3370,7 @@ module.exports = {
     useEditableProjectInstall,
     compareVersions,
     detectInstallMode,
+    updateManualCommand,
     buildUpdateStatus,
   },
 };

package/docs/en/00_QUICK_START.md

@@ -42,7 +42,7 @@ By default, the DeepScientist home is `~/DeepScientist` on macOS and Linux, and
 If you want to use the current working directory as the DeepScientist home directly, run:
 
 ```bash
-ds --hero
+ds --here
 ```
 
 This is equivalent to `ds --home "$PWD"`.

package/docs/en/01_SETTINGS_REFERENCE.md

@@ -44,7 +44,7 @@ Connector-specific setup guides:
 ```yaml
 home: ~/DeepScientist
 default_runner: codex
-default_locale: zh-CN
+default_locale: en-US # or zh-CN, initialized from the browser on first web launch
 daemon:
   session_restore_on_start: true
   max_concurrent_quests: 1
@@ -67,6 +67,14 @@ skills:
   sync_global_on_init: true
   sync_quest_on_create: true
   sync_quest_on_open: true
+bootstrap:
+  codex_ready: false
+  codex_last_checked_at: null
+  codex_last_result: {}
+  locale_source: browser
+  locale_initialized_from_browser: true
+  locale_initialized_at: 2026-03-18T00:00:00+00:00
+  locale_initialized_browser_locale: en-US
 connectors:
   auto_ack: true
   milestone_push: true
@@ -108,10 +116,11 @@ acp:
 **`default_locale`**
 
 - Type: `string`
-- Default: `zh-CN`
+- Default: initialized from the browser language on the first web launch, then persisted as `zh-CN` or `en-US`
 - Allowed values: `zh-CN`, `en-US`
 - UI label: `Default locale`
-- Meaning: default prompt and UI language preference.
+- Meaning: default language preference used by prompts and runtime copy.
+- Notes: after the first browser-driven initialization, changing this field in `Settings` makes it a manual override and DeepScientist will not auto-follow the browser again.
 
 ### Daemon policy
 
@@ -1074,7 +1083,7 @@ servers:
 ```yaml
 # config.yaml
 default_runner: codex
-default_locale: zh-CN
+default_locale: en-US
 ui:
   host: 0.0.0.0
   port: 20999

package/docs/en/99_ACKNOWLEDGEMENTS.md

@@ -11,6 +11,7 @@ We especially thank the following projects for their ideas, research direction,
 - AlphaEvolve
 - OpenEvolve
 - EvoScientist
+- Orchestra-Research/AI-Research-SKILLs
 
 These projects have been important references for thinking about automated research, open-ended exploration, evolutionary search, experiment organization, and long-horizon research agents.
 

package/docs/images/connectors/discord-setup-overview.svg

@@ -0,0 +1,52 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720" fill="none">
+  <rect width="1280" height="720" rx="32" fill="#F7F7FF"/>
+  <rect x="40" y="40" width="1200" height="640" rx="28" fill="#FFFFFF" stroke="#DADCFB" stroke-width="2"/>
+  <circle cx="110" cy="108" r="34" fill="#5865F2"/>
+  <path d="M124.6 96.6c-2.4-1.8-4.8-3-7.4-3.8-.1 0-.2 0-.2.1-.3.6-.6 1.2-.9 1.9-2.8-.4-5.5-.4-8.2 0-.3-.6-.6-1.3-.9-1.9-.1-.1-.1-.1-.2-.1-2.6.8-5.1 2-7.4 3.8-.1 0-.1.1-.1.1-4.5 6.7-5.7 13.2-5.1 19.6 0 .1 0 .1.1.2 3.1 2.3 6.2 3.7 9.2 4.7.1 0 .2 0 .2-.1.7-1 1.3-2 1.8-3 .1-.1 0-.2-.1-.2-1-.4-1.9-.8-2.8-1.4-.1 0-.1-.2 0-.2.2-.1.4-.3.6-.4h.1c6 2.7 12.5 2.7 18.5 0h.1c.2.1.4.3.6.4.1.1.1.2 0 .2-.9.5-1.8 1-2.8 1.4-.1 0-.1.1-.1.2.5 1 1.1 2 1.8 3 .1.1.1.1.2.1 3-.9 6.1-2.4 9.2-4.7.1 0 .1-.1.1-.2.7-7.4-1.1-13.8-5.1-19.6 0 0 0-.1-.1-.1ZM104.8 112.5c-1.8 0-3.3-1.6-3.3-3.7s1.4-3.7 3.3-3.7c1.8 0 3.3 1.6 3.3 3.7-.1 2-1.5 3.7-3.3 3.7Zm14.4 0c-1.8 0-3.3-1.6-3.3-3.7s1.4-3.7 3.3-3.7c1.8 0 3.3 1.6 3.3 3.7s-1.4 3.7-3.3 3.7Z" fill="#fff"/>
+  <text x="164" y="98" fill="#0F172A" font-family="Arial, sans-serif" font-size="34" font-weight="700">Discord Setup Flow</text>
+  <text x="164" y="138" fill="#475569" font-family="Arial, sans-serif" font-size="20">Developer Portal -&gt; Bot token + Application ID -&gt; invite bot -&gt; one DM or mention</text>
+
+  <rect x="72" y="198" width="340" height="414" rx="26" fill="#FBFBFF" stroke="#D7D9FE" stroke-width="2"/>
+  <rect x="98" y="224" width="90" height="34" rx="17" fill="#EDE9FE"/>
+  <text x="122" y="246" fill="#4338CA" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 1</text>
+  <text x="98" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Create the app</text>
+  <rect x="98" y="324" width="288" height="76" rx="18" fill="#fff" stroke="#E3E5FF"/>
+  <text x="122" y="352" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Developer Portal</text>
+  <text x="122" y="378" fill="#475569" font-family="Arial, sans-serif" font-size="16">General Information + Bot tab</text>
+  <rect x="98" y="416" width="288" height="92" rx="18" fill="#EEF2FF"/>
+  <text x="122" y="446" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Copy two values</text>
+  <text x="122" y="474" fill="#4338CA" font-family="Arial, sans-serif" font-size="16">bot_token</text>
+  <text x="122" y="498" fill="#4338CA" font-family="Arial, sans-serif" font-size="16">application_id</text>
+  <rect x="98" y="524" width="288" height="60" rx="18" fill="#fff" stroke="#E3E5FF"/>
+  <text x="122" y="560" fill="#475569" font-family="Arial, sans-serif" font-size="16">Enable bot user and keep Gateway mode</text>
+
+  <rect x="470" y="198" width="340" height="414" rx="26" fill="#FBFCFF" stroke="#DADCFB" stroke-width="2"/>
+  <rect x="496" y="224" width="90" height="34" rx="17" fill="#DBEAFE"/>
+  <text x="520" y="246" fill="#1D4ED8" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 2</text>
+  <text x="496" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Fill Settings</text>
+  <rect x="496" y="324" width="288" height="220" rx="18" fill="#fff" stroke="#DFE4FD"/>
+  <text x="520" y="356" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Connector fields</text>
+  <text x="520" y="390" fill="#334155" font-family="Arial, sans-serif" font-size="17">Enabled: on</text>
+  <text x="520" y="422" fill="#334155" font-family="Arial, sans-serif" font-size="17">transport: gateway</text>
+  <text x="520" y="454" fill="#334155" font-family="Arial, sans-serif" font-size="17">bot_token: paste from Bot tab</text>
+  <text x="520" y="486" fill="#334155" font-family="Arial, sans-serif" font-size="17">application_id: paste from General Info</text>
+  <text x="520" y="518" fill="#334155" font-family="Arial, sans-serif" font-size="17">guild_allowlist: optional</text>
+  <rect x="496" y="560" width="288" height="24" rx="12" fill="#111827"/>
+
+  <rect x="868" y="198" width="340" height="414" rx="26" fill="#FCFCFF" stroke="#DADCFB" stroke-width="2"/>
+  <rect x="894" y="224" width="90" height="34" rx="17" fill="#DCFCE7"/>
+  <text x="918" y="246" fill="#166534" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 3</text>
+  <text x="894" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Invite and verify</text>
+  <rect x="894" y="324" width="288" height="76" rx="18" fill="#fff" stroke="#E4E7FD"/>
+  <text x="918" y="352" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Generate one real event</text>
+  <text x="918" y="378" fill="#475569" font-family="Arial, sans-serif" font-size="16">Invite bot, then send one DM or @mention</text>
+  <rect x="894" y="416" width="288" height="76" rx="18" fill="#fff" stroke="#E4E7FD"/>
+  <text x="918" y="444" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Back to DeepScientist</text>
+  <text x="918" y="470" fill="#475569" font-family="Arial, sans-serif" font-size="16">Use the discovered target, not a guessed id</text>
+  <rect x="894" y="508" width="288" height="76" rx="18" fill="#ECFDF5"/>
+  <text x="918" y="536" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Final actions</text>
+  <text x="918" y="564" fill="#166534" font-family="Arial, sans-serif" font-size="16">Check -&gt; Send probe</text>
+
+  <path d="M423 406H455" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+  <path d="M821 406H853" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+</svg>

package/docs/images/connectors/feishu-setup-overview.svg

@@ -0,0 +1,53 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720" fill="none">
+  <rect width="1280" height="720" rx="32" fill="#F8FCFF"/>
+  <rect x="40" y="40" width="1200" height="640" rx="28" fill="#FFFFFF" stroke="#D7E7FF" stroke-width="2"/>
+  <rect x="76" y="74" width="68" height="68" rx="18" fill="#fff" stroke="#D7E7FF"/>
+  <path d="M104.3 112.1c18.1 0 33.9-10 42.1-24.8.3-.5.6-1 .9-1.5-.4.8-.9 1.5-1.4 2.2-.2.2-.4.4-.6.7-.2.3-.5.6-.8.8-.2.2-.4.4-.6.6-.4.4-.9.8-1.3 1.2-.2.2-.5.4-.8.6-.3.3-.6.5-.9.7l-.6.4-.6.4c-.5.3-1 .5-1.5.7-.4.2-.8.4-1.2.5-.5.2-1 .4-1.6.5-.8.2-1.6.4-2.3.5-.6.1-1.2.2-1.8.2-.7 0-1.4 0-2.1-.1-.7-.1-1.3-.1-2-.2-.5-.1-1-.2-1.5-.3l-.8-.2c-.7-.2-1.4-.4-2.1-.6-.3-.1-.7-.2-1-.3-.5-.2-1.1-.3-1.6-.5-.4-.1-.8-.3-1.3-.4-.4-.1-.8-.3-1.2-.4l-1.3-.5c-.3-.1-.7-.2-1-.4l-.9-.3c-.5-.2-1-.4-1.4-.6l-.8-.3-.9-.4-.9-.4-1.2-.5-1.3-.6c-.5-.2-.9-.4-1.4-.6l-1.1-.5c-20.4-10.2-38.7-23.9-54.2-40.6-.5-.5-1.3-.5-1.8 0-.2.2-.3.5-.3.9v17.3c0 3.6 1.8 6.9 4.8 8.8 14.3 9.5 31.1 14.5 48.2 14.5Z" fill="#3370FF"/>
+  <path d="M118.7 88.7c-1.9-3.1-1.1-7 .8-9.5 8.1-7.8 12.9-19.1 11.9-31.4C129.9 28.5 114 13.6 94.2 12.2 70.2 10.6 50 29.7 50 53.5v51.1c0 2.1 1.7 3.8 3.8 3.8h12.5c2.1 0 3.8-1.7 3.8-3.8V84.9c0-.6.1-1.2.2-1.8.8-3.7 3.9-6.6 7.8-6.8 4.1-.3 7.9 2.4 9 6.3l.7 2.5 5.9 21.6c.5 1.6 1.9 2.8 3.6 2.8h14.8c2.8 0 4.7-3 3.3-5.5l-12.2-23.1-.1-.2Zm-19.1-14.2c-8.6 1.1-15.9-6.2-14.8-14.9.7-5.9 5.4-10.6 11.3-11.4 8.6-1.1 15.9 6.2 14.8 14.8-.7 5.9-5.4 10.7-11.3 11.5Z" fill="#00D6B9"/>
+  <path d="M151.6 52.4c-6.8-3.3-14.5-4-21.8-2-.3.1-.6.2-.9.3l-.6.2c-.4.1-.9.3-1.2.4-.8.3-1.6.6-2.4 1-.8.4-1.5.8-2.2 1.2-.8.5-1.5.9-2.1 1.5-.5.4-1 .8-1.4 1.3-.5.5-1 .9-1.5 1.4l-.9.8-1.3 1.3-1 1-.8.8-.9.9-.8.8-1.4 1.4-.9.8-.3.3c-.2.1-.3.3-.5.5l-.3.3-.3.3c-3.4 3.1-7.2 5.8-11.2 8l1.2.5.9.4.9.4.9.3 1 .4 1.3.5c.4.1.8.3 1.2.4.5.2.9.3 1.4.5.5.2 1 .3 1.6.5.3.1.7.2 1 .3.7.2 1.4.4 2.1.6l.8.2c.5.1 1 .2 1.5.3.6.1 1.3.2 2 .2.7.1 1.4.1 2.1.1.6 0 1.2-.1 1.8-.2.8-.1 1.6-.3 2.3-.5.6-.1 1.1-.3 1.6-.5.4-.1.8-.3 1.2-.5.5-.2 1-.4 1.5-.7l.6-.4.6-.4c.3-.2.6-.4.9-.7.3-.2.5-.4.8-.6.5-.4.9-.8 1.3-1.2.2-.2.4-.4.6-.6.3-.3.5-.6.8-.8.2-.2.4-.5.6-.7.6-.7 1-1.4 1.4-2.2l.5-1 4.6-9.3.1-.1c1.5-3.3 3.6-6.3 6.1-8.8Z" fill="#133C9A"/>
+  <text x="164" y="98" fill="#0F172A" font-family="Arial, sans-serif" font-size="34" font-weight="700">Feishu / Lark Setup Flow</text>
+  <text x="164" y="138" fill="#475569" font-family="Arial, sans-serif" font-size="20">Open Platform -&gt; App ID + App Secret -&gt; long connection -&gt; one DM or @mention -&gt; probe</text>
+
+  <rect x="72" y="198" width="340" height="414" rx="26" fill="#FBFDFF" stroke="#D8E8FF" stroke-width="2"/>
+  <rect x="98" y="224" width="90" height="34" rx="17" fill="#DBEAFE"/>
+  <text x="122" y="246" fill="#1D4ED8" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 1</text>
+  <text x="98" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Create the app</text>
+  <rect x="98" y="324" width="288" height="84" rx="18" fill="#fff" stroke="#E0ECFF"/>
+  <text x="122" y="352" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Feishu Open Platform</text>
+  <text x="122" y="378" fill="#475569" font-family="Arial, sans-serif" font-size="16">Credentials page + app installation</text>
+  <rect x="98" y="424" width="288" height="84" rx="18" fill="#F0F9FF"/>
+  <text x="122" y="452" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Copy two values</text>
+  <text x="122" y="480" fill="#0369A1" font-family="Arial, sans-serif" font-size="16">app_id</text>
+  <text x="122" y="502" fill="#0369A1" font-family="Arial, sans-serif" font-size="16">app_secret</text>
+  <rect x="98" y="524" width="288" height="60" rx="18" fill="#fff" stroke="#E0ECFF"/>
+  <text x="122" y="560" fill="#475569" font-family="Arial, sans-serif" font-size="16">Install the app into the target tenant</text>
+
+  <rect x="470" y="198" width="340" height="414" rx="26" fill="#FCFDFF" stroke="#D8E8FF" stroke-width="2"/>
+  <rect x="496" y="224" width="90" height="34" rx="17" fill="#DCFCE7"/>
+  <text x="520" y="246" fill="#166534" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 2</text>
+  <text x="496" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Fill Settings</text>
+  <rect x="496" y="324" width="288" height="220" rx="18" fill="#fff" stroke="#E0ECFF"/>
+  <text x="520" y="356" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Connector fields</text>
+  <text x="520" y="390" fill="#334155" font-family="Arial, sans-serif" font-size="17">Enabled: on</text>
+  <text x="520" y="422" fill="#334155" font-family="Arial, sans-serif" font-size="17">transport: long_connection</text>
+  <text x="520" y="454" fill="#334155" font-family="Arial, sans-serif" font-size="17">app_id: paste from platform</text>
+  <text x="520" y="486" fill="#334155" font-family="Arial, sans-serif" font-size="17">app_secret: paste from platform</text>
+  <text x="520" y="518" fill="#334155" font-family="Arial, sans-serif" font-size="17">require_mention_in_groups: optional</text>
+  <rect x="496" y="560" width="288" height="24" rx="12" fill="#111827"/>
+
+  <rect x="868" y="198" width="340" height="414" rx="26" fill="#FBFDFF" stroke="#D8E8FF" stroke-width="2"/>
+  <rect x="894" y="224" width="90" height="34" rx="17" fill="#FDE68A"/>
+  <text x="918" y="246" fill="#92400E" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 3</text>
+  <text x="894" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Start one chat</text>
+  <rect x="894" y="324" width="288" height="84" rx="18" fill="#fff" stroke="#E0ECFF"/>
+  <text x="918" y="352" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Generate one event</text>
+  <text x="918" y="378" fill="#475569" font-family="Arial, sans-serif" font-size="16">Send one DM or @mention in Feishu</text>
+  <rect x="894" y="424" width="288" height="84" rx="18" fill="#fff" stroke="#E0ECFF"/>
+  <text x="918" y="452" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Back to DeepScientist</text>
+  <text x="918" y="478" fill="#475569" font-family="Arial, sans-serif" font-size="16">Wait until discovered targets appear</text>
+  <rect x="894" y="524" width="288" height="60" rx="18" fill="#FEFCE8"/>
+  <text x="918" y="560" fill="#92400E" font-family="Arial, sans-serif" font-size="16">Check -&gt; Send probe</text>
+
+  <path d="M423 406H455" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+  <path d="M821 406H853" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+</svg>

package/docs/images/connectors/slack-setup-overview.svg

@@ -0,0 +1,51 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720" fill="none">
+  <rect width="1280" height="720" rx="32" fill="#FCF8FC"/>
+  <rect x="40" y="40" width="1200" height="640" rx="28" fill="#FFFFFF" stroke="#E7D7E7" stroke-width="2"/>
+  <circle cx="110" cy="108" r="34" fill="#4A154B"/>
+  <path d="M103.1 93.3c0-3 2.4-5.5 5.5-5.5 3 0 5.5 2.5 5.5 5.5v5.5h-5.5c-3.1 0-5.5-2.5-5.5-5.5Zm-10.8 10.8h5.5v5.5c0 3.1-2.5 5.5-5.5 5.5-3.1 0-5.5-2.4-5.5-5.5 0-3 2.4-5.5 5.5-5.5Zm21.8 0h5.5c3 0 5.5 2.5 5.5 5.5 0 3.1-2.5 5.5-5.5 5.5-3.1 0-5.5-2.4-5.5-5.5v-5.5Zm-5.5 16.3v-5.5h5.5c3 0 5.5 2.5 5.5 5.5 0 3.1-2.5 5.5-5.5 5.5-3.1 0-5.5-2.4-5.5-5.5Zm-10.8-10.8v-5.5h5.5c3 0 5.5 2.5 5.5 5.5v16.3c0 3.1-2.5 5.5-5.5 5.5-3.1 0-5.5-2.4-5.5-5.5v-16.3Zm16.3-10.8v-5.5c0-3 2.4-5.5 5.5-5.5 3 0 5.5 2.5 5.5 5.5 0 3-2.5 5.5-5.5 5.5h-5.5Zm-16.3 0H92.3c-3.1 0-5.5-2.5-5.5-5.5 0-3 2.4-5.5 5.5-5.5 3 0 5.5 2.5 5.5 5.5v5.5Z" fill="#fff"/>
+  <text x="164" y="98" fill="#0F172A" font-family="Arial, sans-serif" font-size="34" font-weight="700">Slack Setup Flow</text>
+  <text x="164" y="138" fill="#475569" font-family="Arial, sans-serif" font-size="20">Slack app dashboard -&gt; Socket Mode -&gt; xoxb + xapp -&gt; one mention -&gt; probe</text>
+
+  <rect x="72" y="198" width="340" height="414" rx="26" fill="#FFFDFE" stroke="#E9D9E9" stroke-width="2"/>
+  <rect x="98" y="224" width="90" height="34" rx="17" fill="#F3E8FF"/>
+  <text x="122" y="246" fill="#6B21A8" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 1</text>
+  <text x="98" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Prepare the app</text>
+  <rect x="98" y="324" width="288" height="84" rx="18" fill="#fff" stroke="#EEE2EE"/>
+  <text x="122" y="352" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Slack App dashboard</text>
+  <text x="122" y="378" fill="#475569" font-family="Arial, sans-serif" font-size="16">Basic Information + Socket Mode</text>
+  <rect x="98" y="424" width="288" height="84" rx="18" fill="#FDF4FF"/>
+  <text x="122" y="452" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Copy two tokens</text>
+  <text x="122" y="480" fill="#6B21A8" font-family="Arial, sans-serif" font-size="16">Bot User OAuth Token: xoxb-...</text>
+  <text x="122" y="502" fill="#6B21A8" font-family="Arial, sans-serif" font-size="16">App-Level Token: xapp-...</text>
+  <rect x="98" y="524" width="288" height="60" rx="18" fill="#fff" stroke="#EEE2EE"/>
+  <text x="122" y="560" fill="#475569" font-family="Arial, sans-serif" font-size="16">Install app into the target workspace</text>
+
+  <rect x="470" y="198" width="340" height="414" rx="26" fill="#FFFCFF" stroke="#E7D7E7" stroke-width="2"/>
+  <rect x="496" y="224" width="90" height="34" rx="17" fill="#FDE68A"/>
+  <text x="520" y="246" fill="#92400E" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 2</text>
+  <text x="496" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Fill Settings</text>
+  <rect x="496" y="324" width="288" height="220" rx="18" fill="#fff" stroke="#EEE2EE"/>
+  <text x="520" y="356" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Connector fields</text>
+  <text x="520" y="390" fill="#334155" font-family="Arial, sans-serif" font-size="17">Enabled: on</text>
+  <text x="520" y="422" fill="#334155" font-family="Arial, sans-serif" font-size="17">transport: socket_mode</text>
+  <text x="520" y="454" fill="#334155" font-family="Arial, sans-serif" font-size="17">bot_token: xoxb-...</text>
+  <text x="520" y="486" fill="#334155" font-family="Arial, sans-serif" font-size="17">app_token: xapp-...</text>
+  <text x="520" y="518" fill="#334155" font-family="Arial, sans-serif" font-size="17">require_mention_in_groups: recommended</text>
+  <rect x="496" y="560" width="288" height="24" rx="12" fill="#111827"/>
+
+  <rect x="868" y="198" width="340" height="414" rx="26" fill="#FFFDFF" stroke="#E7D7E7" stroke-width="2"/>
+  <rect x="894" y="224" width="90" height="34" rx="17" fill="#DCFCE7"/>
+  <text x="918" y="246" fill="#166534" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 3</text>
+  <text x="894" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Mention and verify</text>
+  <rect x="894" y="324" width="288" height="84" rx="18" fill="#fff" stroke="#EEE2EE"/>
+  <text x="918" y="352" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Generate one event</text>
+  <text x="918" y="378" fill="#475569" font-family="Arial, sans-serif" font-size="16">Mention the app or send one DM in Slack</text>
+  <rect x="894" y="424" width="288" height="84" rx="18" fill="#fff" stroke="#EEE2EE"/>
+  <text x="918" y="452" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Use discovered target</text>
+  <text x="918" y="478" fill="#475569" font-family="Arial, sans-serif" font-size="16">Let runtime fill the channel or DM id first</text>
+  <rect x="894" y="524" width="288" height="60" rx="18" fill="#ECFDF5"/>
+  <text x="918" y="560" fill="#166534" font-family="Arial, sans-serif" font-size="16">Check -&gt; Send probe</text>
+
+  <path d="M423 406H455" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+  <path d="M821 406H853" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+</svg>