chore: create integration APi for chat and deep research mode (#293)

* chore: create integration APi for chat and deep research mode

* fix: fix test create new conversation by integration API

---------

Co-authored-by: Longbb <longbb@Longbbs-MacBook-Pro.local>

Author: longbb

openhands/llm/llm.py

@@ -98,18 +98,27 @@
     'gpt-5',
     'gpt-4.1',
     'o3',
+    'gpt-5-mini',
 ]
 
 FORMATTED_MODELS = ['llama-4-maverick-17b-128e-instruct']
 
-MODELS_USING_MAX_COMPLETION_TOKENS = ['o4-mini', 'chatgpt-5', 'gpt-5', 'gpt-4.1', 'o3']
+MODELS_USING_MAX_COMPLETION_TOKENS = [
+    'o4-mini',
+    'chatgpt-5',
+    'gpt-5',
+    'gpt-4.1',
+    'o3',
+    'gpt-5-mini',
+]
 
 MODELS_WITH_TEMPERATURE_DEFAULT_AS_1 = [
     'o4-mini',
     'chatgpt-5',
     'gpt-5',
     'gpt-4.1',
     'o3',
+    'gpt-5-mini',
 ]
 
 

openhands/server/routes/integration/__init__.py

@@ -1,9 +1,15 @@
 from fastapi import APIRouter
 
-from openhands.server.routes.integration.conversation import conversation_router
+from openhands.server.routes.integration.conversation import (
+    chat_router,
+    conversation_router,
+    deep_research_router,
+)
 from openhands.server.routes.integration.space import space_router
 
 app = APIRouter(prefix='/api/v1/integration')
 
 app.include_router(conversation_router, tags=['conversations'])
 app.include_router(space_router, tags=['spaces'])
+app.include_router(chat_router, tags=['conversations'])
+app.include_router(deep_research_router, tags=['conversations'])

openhands/server/routes/integration/conversation.py

@@ -5,6 +5,7 @@
 
 from openhands.core.logger import openhands_logger as logger
 from openhands.core.schema.action import ActionType
+from openhands.core.schema.research import ResearchMode
 from openhands.events.action.agent import RecallAction
 from openhands.events.action.empty import NullAction
 from openhands.events.async_event_store_wrapper import AsyncEventStoreWrapper
@@ -32,23 +33,35 @@
 from openhands.storage.data_models.conversation_status import ConversationStatus
 
 conversation_router = APIRouter(prefix='/conversations')
+chat_router = APIRouter(prefix='/chat_researchs')
+deep_research_router = APIRouter(prefix='/deep_researchs')
 
 
-class CreatNewConversationIntegrationRequest(BaseModel):
+class CreateNewConversationIntegrationRequest(BaseModel):
     initial_user_msg: str | None = None
-    research_mode: str | None = None
+    research_mode: ResearchMode | None = None
     space_id: int | None = None
     space_section_id: int | None = None
     thread_follow_up: int | None = None
     followup_discover_id: str | None = None
     mcp_disable: dict[str, bool] | None = None
     system_prompt: str | None = None
-    image_urls: list[str] | None = None
 
 
-@conversation_router.post('')
+class CreateChatConversationIntegrationRequest(BaseModel):
+    initial_user_msg: str | None = None
+    system_prompt: str | None = None
+
+
+class CreateDeepResearchConversationIntegrationRequest(BaseModel):
+    initial_user_msg: str | None = None
+    mcp_disable: dict[str, bool] | None = None
+    system_prompt: str | None = None
+
+
+@conversation_router.post('', description='Create new conversation.')
 async def integration_new_conversation(
-    request: Request, data: CreatNewConversationIntegrationRequest
+    request: Request, data: CreateNewConversationIntegrationRequest
 ):
     new_conversation_data = InitSessionRequest(**data.model_dump())
     new_conversation_result = await new_conversation(request, new_conversation_data)
@@ -69,6 +82,30 @@ async def integration_new_conversation(
     return new_conversation_result
 
 
+@chat_router.post('', description='Create new conversation in chat mode.')
+async def integration_new_chat_conversation(
+    request: Request, data: CreateChatConversationIntegrationRequest
+):
+    new_conversation_data = InitSessionRequest(
+        **data.model_dump(),
+        research_mode=ResearchMode.CHAT.value,
+    )
+    return await new_conversation(request, new_conversation_data)
+
+
+@deep_research_router.post(
+    '', description='Create new conversation in deep research mode.'
+)
+async def integration_new_deep_research_conversation(
+    request: Request, data: CreateDeepResearchConversationIntegrationRequest
+):
+    new_conversation_data = InitSessionRequest(
+        **data.model_dump(),
+        research_mode=ResearchMode.DEEP_RESEARCH.value,
+    )
+    return await new_conversation(request, new_conversation_data)
+
+
 @conversation_router.get('/{conversation_id}')
 async def integration_get_conversation(
     conversation_id: str, request: Request

openhands/server/session/session.py

@@ -163,6 +163,10 @@ async def initialize_agent(
                 config=routing_llm_config,
             )
 
+        # @ use simple llm for chatmode
+        if research_mode == ResearchMode.CHAT and routing_llms.get('simple'):
+            llm = routing_llms['simple']
+
         agent_config = self.config.get_agent_config(agent_cls)
         self.logger.info(f'Enabling default condenser: {agent_config.condenser}')
         if settings.enable_default_condenser and agent_config.condenser.type == 'noop':

tests/unit/test_integration_conversation_api.py

@@ -77,7 +77,7 @@ async def test_create_conversation_success(self, test_client):
             # Use the new integration request format
             payload = {
                 'initial_user_msg': 'Hello, I need help with coding',
-                'research_mode': 'normal',
+                'research_mode': 'chat',
                 'space_id': 123,
                 'thread_follow_up': None,
                 'followup_discover_id': None,
@@ -126,7 +126,7 @@ async def test_create_conversation_error(self, test_client):
                 status_code=400, detail='Missing required settings'
             )
 
-            payload = {'initial_user_msg': 'Hello', 'research_mode': 'normal'}
+            payload = {'initial_user_msg': 'Hello', 'research_mode': 'chat'}
 
             response = test_client.post(
                 '/api/v1/integration/conversations/',
@@ -576,7 +576,7 @@ async def test_create_conversation_with_space_data_success(self, test_client):
 
             payload = {
                 'initial_user_msg': 'Hello, I need help with coding',
-                'research_mode': 'normal',
+                'research_mode': 'chat',
                 'space_id': space_id,
                 'space_section_id': space_section_id,
             }
@@ -642,7 +642,7 @@ async def test_create_conversation_without_space_data(self, test_client):
 
             payload = {
                 'initial_user_msg': 'Hello, I need help with coding',
-                'research_mode': 'normal',
+                'research_mode': 'chat',
                 # No space_id or space_section_id
             }
 
@@ -685,7 +685,7 @@ async def test_create_conversation_with_partial_space_data(self, test_client):
 
             payload = {
                 'initial_user_msg': 'Hello, I need help with coding',
-                'research_mode': 'normal',
+                'research_mode': 'chat',
                 'space_id': 123,
                 # Missing space_section_id
             }