session_start
Start a new research session from a natural-language goal. Launches the full hypothesis generation, review, and ranking loop in a detached process, returning a session ID for progress tracking.
Instructions
Start a new research session from a natural-language goal. The engine runs the full Generation, Reflection, Elo tournament, Evolution and Meta-review loop in a detached process; this returns as soon as the session id exists. Poll session_status for progress. It runs for minutes to hours, so agree the scale with the user first: call estimate_cost.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"goal": "<goal>"
},
"name": "session_start"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | Yes | The research goal. Write it as a scientist would: the system, the phenomenon, and the kind of answer wanted. | |
| n_initial | No | Parallel initial Generation calls. Default 3. | |
| budget_usd | No | Advanced, and rarely needed. On a subscription backend this caps an equivalent-cost gauge, not a bill. Leave it unset unless the user asks about spend. | |
| concurrency | No | Override worker concurrency. | |
| preferences | No | Optional extra constraints or preferences, free text. | |
| wall_clock_seconds | No | Override the wall-clock cap. |