after moving all to cipher

worker-toolkit-stocks-in-the-future/explore/scripts/setup-harnesses.sh

@@ -113,11 +113,24 @@ harness_install_launchers() {
     mkdir -p "$bin"
     # Read at launcher run time so the note stays a file, not a baked-in copy.
     local note_src="${HARNESS_TOOLSET_NOTE:-/workspace/scripts/toolset_note.md}"
+    local browser_note_src="${note_src%.md}_browser.md"
+    local read_note_src="${note_src%.md}_read.md"
     local agent_cli_dir="${AGENT_CLI_DIR:-/opt/agent-cli}"
 
-    local id cli launch
+    local id cli launch switchable
     while IFS=$'\t' read -r id cli launch; do
         [ -n "$cli" ] && [ -n "$launch" ] || continue
+        # Whether RACCOON_BROWSER_TASK can change THIS harness's toolset, read off the
+        # registry rather than hardcoded: a launch line that interpolates $RACCOON_TOOLS
+        # can, and one that doesn't cannot. codex is the second case — it ships view_image,
+        # so a browser task needs nothing added and the flag has nothing to switch.
+        # Match the whole variable name: a substring test also hits RACCOON_TOOLSET_NOTE,
+        # which every launch line references, and every harness would look switchable.
+        if [[ "$launch" =~ \$\{?RACCOON_TOOLS\}?([^A-Za-z0-9_]|$) ]]; then
+            switchable=1
+        else
+            switchable=0
+        fi
         cat > "$bin/raccoon-explore-$cli" <<LAUNCHER
 #!/bin/bash
 # GENERATED by scripts/setup-harnesses.sh from harness-registry.toml — do not edit.
@@ -127,7 +140,38 @@ if [ -f "$note_src" ]; then
 else
     RACCOON_TOOLSET_NOTE=""
 fi
-export RACCOON_TOOLSET_NOTE
+# RACCOON_BROWSER_TASK=1 explores with the toolset a \`browser = true\` task runs under.
+# Named for the flag it mirrors: one word, \`browser\`, whether it's set in task.toml or
+# here. Per invocation, not per container — authoring a browser task shouldn't need a
+# rebuild, and neither should changing your mind. Default off, so ordinary exploring
+# still mirrors an ordinary trial.
+#
+# The correction must be appended AFTER the base note, which says there is no Read tool.
+RACCOON_TOOLS="Bash"
+if [ "\${RACCOON_BROWSER_TASK:-0}" = "1" ] && [ "$switchable" = "1" ] && [ -f "$read_note_src" ]; then
+    RACCOON_TOOLS="Bash,Read"
+    RACCOON_TOOLSET_NOTE="\${RACCOON_TOOLSET_NOTE}
+
+\$(cat "$read_note_src")"
+fi
+export RACCOON_TOOLS
+# Only mention the browser on an image that actually has one — most don't. Probed at
+# launch, not baked in, so the same launcher is correct in whichever container it runs.
+#
+# Exported two ways because the harnesses take extra instructions differently: claude
+# appends the whole toolset note to --append-system-prompt, while codex has no equivalent
+# and takes -c developer_instructions=. codex must NOT get the claude-shaped toolset note
+# (it has no str_replace_editor), so the browser part is exported on its own too.
+RACCOON_BROWSER_NOTE=""
+RACCOON_BROWSER_FLAGS=()
+if command -v pw >/dev/null 2>&1 && [ -f "$browser_note_src" ]; then
+    RACCOON_BROWSER_NOTE="\$(cat "$browser_note_src")"
+    RACCOON_TOOLSET_NOTE="\${RACCOON_TOOLSET_NOTE}
+
+\${RACCOON_BROWSER_NOTE}"
+    RACCOON_BROWSER_FLAGS=(-c "developer_instructions=\${RACCOON_BROWSER_NOTE}")
+fi
+export RACCOON_TOOLSET_NOTE RACCOON_BROWSER_NOTE
 export RACCOON_HARNESS="$id"
 # No RACCOON_SNAPSHOT_DATA here on purpose. capture-snapshot.mjs and save-session-info.mjs
 # already share the same default ($HOME/.raccoon/snapshot-data), which is what codex needs
@@ -143,11 +187,33 @@ LAUNCHER
 
 # Alias lines for ~/.bashrc.
 harness_alias_lines() {
-    local id cli launch
+    local id cli launch switchable
+    local browser_clis=""
     while IFS=$'\t' read -r id cli launch; do
         [ -n "$cli" ] && [ -n "$launch" ] || continue
         echo "alias $cli=\"raccoon-explore-$cli\""
+        # Same derivation as the launcher: only a harness whose launch line takes
+        # $RACCOON_TOOLS has a toolset the flag can change.
+        if [[ "$launch" =~ \$\{?RACCOON_TOOLS\}?([^A-Za-z0-9_]|$) ]]; then
+            browser_clis="${browser_clis:+$browser_clis }$cli"
+        fi
     done < <(_harness_query --explore-launchers 2>/dev/null || true)
+
+    # The browser hint belongs at the shell prompt, not in the launcher. Claude Code takes the
+    # alternate screen buffer, so anything printed just before exec is hidden for the whole
+    # session and resurfaces only after quitting — advice arriving exactly too late. Here it
+    # lands in ordinary scrollback, before any TUI exists, and there is nothing to quit yet.
+    #
+    # `pw` is probed at shell start, so one ~/.bashrc is correct in a container with a browser
+    # and in one without.
+    [ -n "$browser_clis" ] || return 0
+    local first="${browser_clis%% *}"
+    cat <<HINT
+if [[ \$- == *i* ]] && [ "\${RACCOON_BROWSER_TASK:-0}" != "1" ] && command -v pw >/dev/null 2>&1; then
+    echo "browser available (Playwright + Chromium, \\\`pw <script.js>\\\`)."
+    echo "Authoring a \\\`browser = true\\\` task? Start it with:  RACCOON_BROWSER_TASK=1 $first"
+fi
+HINT
 }
 
 # Write each harness's config file from the registry, replacing whatever was there.