Change default forecast effort level to high (#5798)

As discussed in the product sync earlier today.

Claude falls back to a low-effort forecast if the user doesn't
have a large enough balance.

Sourced from commit 29d9153bbece81342555befc1aac22d4bfbb5ad1

Author: rgambee

futuresearch-mcp/src/futuresearch_mcp/models.py

@@ -459,8 +459,7 @@ class ForecastInput(_SingleSourceInput):
     effort_level: ForecastEffortLevel | None = Field(
         default=None,
         description="Effort level for the forecast. 'low' tends to be faster and cheaper. "
-        "'high' tends to be more accurate. When not specified, defaults to 'high' for "
-        "single-question forecasts and 'low' for multi-question forecasts.",
+        "'high' tends to be more accurate. When not specified, defaults to 'high'.",
     )
     output_field: str | None = Field(
         default=None,

src/futuresearch/generated/api/operations/single_agent_operations_single_agent_post.py

@@ -75,9 +75,14 @@ def sync_detailed(
     body: SingleAgentOperation,
     x_cohort_source: None | str | Unset = UNSET,
 ) -> Response[ErrorResponse | InsufficientBalanceResponse | OperationResponse]:
-    """Single AI research agent
+    """Single AI research agent (deprecated)
 
-     Run a single AI agent to perform research and generate a response.
+     **DEPRECATED.** Will be removed in a future release.
+    Use `/operations/agent-map` (one task per row, optionally with `return_list=True`)
+    or `/operations/multi-agent` (parallel agents synthesized per row) instead.
+    Both accept an empty `input` list to generate output from the task alone.
+
+    Run a single AI agent to perform research and generate a response.
 
     **Configuration options** (mutually exclusive):
 
@@ -123,9 +128,14 @@ def sync(
     body: SingleAgentOperation,
     x_cohort_source: None | str | Unset = UNSET,
 ) -> ErrorResponse | InsufficientBalanceResponse | OperationResponse | None:
-    """Single AI research agent
+    """Single AI research agent (deprecated)
+
+     **DEPRECATED.** Will be removed in a future release.
+    Use `/operations/agent-map` (one task per row, optionally with `return_list=True`)
+    or `/operations/multi-agent` (parallel agents synthesized per row) instead.
+    Both accept an empty `input` list to generate output from the task alone.
 
-     Run a single AI agent to perform research and generate a response.
+    Run a single AI agent to perform research and generate a response.
 
     **Configuration options** (mutually exclusive):
 
@@ -166,9 +176,14 @@ async def asyncio_detailed(
     body: SingleAgentOperation,
     x_cohort_source: None | str | Unset = UNSET,
 ) -> Response[ErrorResponse | InsufficientBalanceResponse | OperationResponse]:
-    """Single AI research agent
+    """Single AI research agent (deprecated)
 
-     Run a single AI agent to perform research and generate a response.
+     **DEPRECATED.** Will be removed in a future release.
+    Use `/operations/agent-map` (one task per row, optionally with `return_list=True`)
+    or `/operations/multi-agent` (parallel agents synthesized per row) instead.
+    Both accept an empty `input` list to generate output from the task alone.
+
+    Run a single AI agent to perform research and generate a response.
 
     **Configuration options** (mutually exclusive):
 
@@ -212,9 +227,14 @@ async def asyncio(
     body: SingleAgentOperation,
     x_cohort_source: None | str | Unset = UNSET,
 ) -> ErrorResponse | InsufficientBalanceResponse | OperationResponse | None:
-    """Single AI research agent
+    """Single AI research agent (deprecated)
+
+     **DEPRECATED.** Will be removed in a future release.
+    Use `/operations/agent-map` (one task per row, optionally with `return_list=True`)
+    or `/operations/multi-agent` (parallel agents synthesized per row) instead.
+    Both accept an empty `input` list to generate output from the task alone.
 
-     Run a single AI agent to perform research and generate a response.
+    Run a single AI agent to perform research and generate a response.
 
     **Configuration options** (mutually exclusive):
 

src/futuresearch/generated/models/forecast_operation.py

@@ -36,8 +36,7 @@ class ForecastOperation:
         units (None | str | Unset): Units for the numeric forecast (e.g. 'USD per barrel', 'thousands'). Required when
             forecast_type is 'numeric'.
         effort_level (ForecastEffortLevel | None | Unset): Effort level for the forecast. 'LOW' tends to be faster and
-            cheaper. 'HIGH' tends to be more accurate. When not specified, defaults to 'HIGH' for single-question forecasts
-            and 'LOW' for multi-question forecasts.
+            cheaper. 'HIGH' tends to be more accurate. When not specified, defaults to 'HIGH'.
     """
 
     input_: ForecastOperationInputType2 | list[ForecastOperationInputType1Item] | UUID

src/futuresearch/generated/models/multi_agent_operation.py

@@ -39,7 +39,8 @@ class MultiAgentOperation:
             agents), medium (4 agents), high (6 agents). Default: PublicEffortLevel.MEDIUM.
         join_with_input (bool | Unset): If True, merge the synthesized output with the input row. Default: True.
         return_list (bool | Unset): If True, treat each row's synthesized output as a list of records and emit one
-            output row per item (with an `_expand_index` column). Default: False.
+            output row per item (with an `_expand_index` column). The `response_schema` should describe a single item; the
+            worker wraps it in a list automatically. Do not pre-wrap your schema. Default: False.
     """
 
     input_: list[MultiAgentOperationInputType1Item] | MultiAgentOperationInputType2 | UUID

src/futuresearch/ops.py

@@ -907,8 +907,7 @@ async def forecast(
         session: Optional session. If not provided, one will be created automatically.
         forecast_type: ``"binary"`` for probability forecasts, ``"numeric"`` for
             percentile estimates, ``"date"`` for date percentile estimates.
-        effort_level: affects accuracy and cost of forecast. Default: high for single
-            questions, low for multiple questions.
+        effort_level: affects accuracy and cost of forecast. Default: high.
         output_field: Name of the quantity being forecast (required for numeric
             and date, e.g. ``"price"``, ``"launch_date"``).
         units: Units for numeric forecasts (e.g. ``"USD per barrel"``).
@@ -965,8 +964,7 @@ async def forecast_async(
         input: Input data.
         forecast_type: ``"binary"`` for yes/no probability, ``"numeric"`` for
             percentile estimates, ``"date"`` for date percentile estimates.
-        effort_level: affects accuracy and cost of forecast. Default: high for single
-            questions, low for multiple questions.
+        effort_level: affects accuracy and cost of forecast. Default: high.
         output_field: Name of the quantity (required for numeric and date).
         units: Units for numeric forecasts (required for numeric).