Fix incorrect references for docs retrieval hinter agent

[patricebechard]

Description by Korbit AI

What change is being made?

Fix incorrect references for docs retrieval hinter agent and align hint retrieval flow across the docs hinter integration.

• Introduce and wire up HintsSource-based hint retrieval for the hinter agent, including embedding/direct/LLM-backed modes.
• Update hinter agent initialization and prompt construction to properly use task hints and docs-based retrieval.
• Add and adjust configuration and prompt utilities (GenericAgentArgs, GenericPromptFlags, BASE_FLAGS) to support correct hinter behavior.
• Rename/redirect older hinter module import paths to a new module path and maintain backward compatibility (deprecation warning and aliasing).
• Update supporting scripts and entry points to reflect corrected hinter behavior (run scripts and related sh files).
• Minor fixes to agent and utility modules to ensure compatibility with the new hinter workflow (e.g., prompt construction, hint injection, and parsing).

Why are these changes being made?

To correct broken references and integration points in the docs retrieval hinter flow, ensuring the hinter agent reliably fetches and uses relevant hints from the docs source and aligns with the updated prompt construction and configuration. This improves reliability of hint-based guidance and consistency across agent variants.

Is this description stale? Ask me to generate a new description by commenting /korbit-generate-pr-description

[korbit-ai]

Review by Korbit AI

Korbit automatically attempts to detect when you fix issues in new commits.

Category	Issue	Status
	Missing exports in all list ▹ view
	Unquoted variable expansions in command arguments ▹ view
	Missing configuration variable documentation ▹ view
	Missing error handling for Python execution ▹ view
	Hardcoded Python interpreter assumption ▹ view
	Directory-Dependent Script Path ▹ view
	Duplicate import of GenericAgentArgs ▹ view
	Unnecessary module import overhead ▹ view
	Hardcoded log level ▹ view
	Case-sensitive environment variable check ▹ view

Files scanned

​

File Path	Reviewed
experiments/generic/run_generic_agent.sh	✅
src/agentlab/agents/generic_agent_hinter/init.py	✅
experiments/hinter/run_hinter_agent.sh	✅
src/agentlab/agents/hint_use_agent/init.py	✅
experiments/generic/run_generic_agent.py	✅
src/agentlab/agents/hint_use_agent/tmlr_config.py	✅
src/agentlab/experiments/graph_execution_ray.py	✅
experiments/hinter/run_hinter_agent.py	✅
src/agentlab/agents/generic_agent/generic_agent.py	✅
src/agentlab/experiments/launch_exp.py	✅
src/agentlab/llm/llm_configs.py	✅
src/agentlab/utils/hinting.py	✅
src/agentlab/agents/hint_use_agent/agent_configs.py	✅
src/agentlab/agents/hint_use_agent/generic_agent_prompt.py	✅
src/agentlab/agents/hint_use_agent/generic_agent.py	✅
src/agentlab/agents/tool_use_agent/tool_use_agent.py	✅
src/agentlab/experiments/loop.py	✅
src/agentlab/analyze/agent_xray.py	✅

Explore our documentation to understand the languages and file types we support and the files we ignore.

Check out our docs on how you can make Korbit work best for you and your team.

Loving Korbit!? Share us on LinkedIn Reddit and X