exa-py 2.22.2__tar.gz → 2.23.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. {exa_py-2.22.2 → exa_py-2.23.0}/PKG-INFO +4 -6
  2. {exa_py-2.22.2 → exa_py-2.23.0}/README.md +3 -5
  3. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/async_client.py +17 -1
  4. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/client.py +18 -2
  5. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/types.py +19 -4
  6. {exa_py-2.22.2 → exa_py-2.23.0}/pyproject.toml +2 -2
  7. {exa_py-2.22.2 → exa_py-2.23.0}/LICENSE +0 -0
  8. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/__init__.py +0 -0
  9. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/__init__.py +0 -0
  10. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/async_base.py +0 -0
  11. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/base.py +0 -0
  12. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/betas.py +0 -0
  13. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/monitors/__init__.py +0 -0
  14. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/monitors/async_base.py +0 -0
  15. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/monitors/async_client.py +0 -0
  16. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/monitors/base.py +0 -0
  17. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/monitors/client.py +0 -0
  18. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/monitors/types.py +0 -0
  19. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/utils.py +0 -0
  20. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/api.py +0 -0
  21. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/monitors/__init__.py +0 -0
  22. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/monitors/async_base.py +0 -0
  23. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/monitors/async_client.py +0 -0
  24. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/monitors/base.py +0 -0
  25. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/monitors/client.py +0 -0
  26. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/monitors/types.py +0 -0
  27. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/py.typed +0 -0
  28. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/research/__init__.py +0 -0
  29. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/research/async_client.py +0 -0
  30. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/research/base.py +0 -0
  31. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/research/models.py +0 -0
  32. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/research/sync_client.py +0 -0
  33. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/research/utils.py +0 -0
  34. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/tools.py +0 -0
  35. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/utils.py +0 -0
  36. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/__init__.py +0 -0
  37. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/_generator/pydantic/BaseModel.jinja2 +0 -0
  38. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/async_client.py +0 -0
  39. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/client.py +0 -0
  40. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/core/__init__.py +0 -0
  41. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/core/async_base.py +0 -0
  42. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/core/base.py +0 -0
  43. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/enrichments/__init__.py +0 -0
  44. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/enrichments/client.py +0 -0
  45. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/events/__init__.py +0 -0
  46. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/events/client.py +0 -0
  47. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/imports/__init__.py +0 -0
  48. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/imports/client.py +0 -0
  49. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/items/__init__.py +0 -0
  50. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/items/client.py +0 -0
  51. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/monitors/__init__.py +0 -0
  52. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/monitors/client.py +0 -0
  53. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/monitors/runs/__init__.py +0 -0
  54. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/monitors/runs/client.py +0 -0
  55. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/searches/__init__.py +0 -0
  56. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/searches/client.py +0 -0
  57. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/types.py +0 -0
  58. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/webhooks/__init__.py +0 -0
  59. {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/webhooks/client.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: exa-py
3
- Version: 2.22.2
3
+ Version: 2.23.0
4
4
  Summary: Python SDK for Exa API.
5
5
  License: MIT
6
6
  License-File: LICENSE
@@ -246,18 +246,16 @@ run = exa.agent.runs.poll_until_finished(run.id)
246
246
  print(run.output.structured if run.output else None)
247
247
  ```
248
248
 
249
- For Agent Max, use the beta namespace and pass the beta token explicitly:
249
+ For Agent Ultra, set `effort="ultra"`:
250
250
 
251
251
  ```python
252
252
  from exa_py import Exa
253
- from exa_py.agent import AGENT_MAX_EFFORT_BETA
254
253
 
255
254
  exa = Exa()
256
- run = exa.beta.agent.runs.create(
255
+ run = exa.agent.runs.create(
257
256
  query="Find all companies building browser automation tools in the United States.",
258
- effort="max",
257
+ effort="ultra",
259
258
  budget={"maxCostDollars": 10},
260
- betas=[AGENT_MAX_EFFORT_BETA],
261
259
  )
262
260
  ```
263
261
 
@@ -219,18 +219,16 @@ run = exa.agent.runs.poll_until_finished(run.id)
219
219
  print(run.output.structured if run.output else None)
220
220
  ```
221
221
 
222
- For Agent Max, use the beta namespace and pass the beta token explicitly:
222
+ For Agent Ultra, set `effort="ultra"`:
223
223
 
224
224
  ```python
225
225
  from exa_py import Exa
226
- from exa_py.agent import AGENT_MAX_EFFORT_BETA
227
226
 
228
227
  exa = Exa()
229
- run = exa.beta.agent.runs.create(
228
+ run = exa.agent.runs.create(
230
229
  query="Find all companies building browser automation tools in the United States.",
231
- effort="max",
230
+ effort="ultra",
232
231
  budget={"maxCostDollars": 10},
233
- betas=[AGENT_MAX_EFFORT_BETA],
234
232
  )
235
233
  ```
236
234
 
@@ -142,7 +142,7 @@ class AsyncAgentRunsClient(AsyncAgentBaseClient):
142
142
  input: Optional structured input data for the Agent.
143
143
  output_schema: Optional JSON schema or Pydantic model for structured output.
144
144
  effort: Optional cost and reasoning effort preference. Defaults to auto.
145
- budget: Optional per-run spend ceiling for `auto` and `max`; the API
145
+ budget: Optional per-run spend ceiling for `auto` and `ultra`; the API
146
146
  validates this field and applies defaults when omitted.
147
147
  previous_run_id: Optional prior run ID to continue from.
148
148
  metadata: Optional metadata to attach to the run.
@@ -298,6 +298,22 @@ class AsyncAgentRunsClient(AsyncAgentBaseClient):
298
298
  response = await self.request(f"/{run_id}/cancel", method="POST")
299
299
  return AgentRun.model_validate(response)
300
300
 
301
+ async def stop(self, run_id: str) -> AgentRun:
302
+ """Stop a running Agent run, completing it early with the results gathered so far.
303
+
304
+ Only supported for `ultra` effort runs.
305
+
306
+ Examples:
307
+ from exa_py import AsyncExa
308
+
309
+ exa = AsyncExa("EXA_API_KEY")
310
+
311
+ run = await exa.agent.runs.stop("agent_run_123")
312
+ print(run.stop_reason)
313
+ """
314
+ response = await self.request(f"/{run_id}/stop", method="POST")
315
+ return AgentRun.model_validate(response)
316
+
301
317
  async def delete(self, run_id: str) -> DeletedAgentRun:
302
318
  """Delete an Agent run.
303
319
 
@@ -195,7 +195,7 @@ class AgentRunsClient(AgentBaseClient):
195
195
  input: Optional structured input data for the Agent.
196
196
  output_schema: Optional JSON schema or Pydantic model for structured output.
197
197
  effort: Optional cost and reasoning effort preference. Defaults to auto.
198
- budget: Optional per-run spend ceiling for `auto` and `max`; the API
198
+ budget: Optional per-run spend ceiling for `auto` and `ultra`; the API
199
199
  validates this field and applies defaults when omitted.
200
200
  previous_run_id: Optional prior run ID to continue from.
201
201
  metadata: Optional metadata to attach to the run.
@@ -344,6 +344,22 @@ class AgentRunsClient(AgentBaseClient):
344
344
  response = self.request(f"/{run_id}/cancel", method="POST")
345
345
  return AgentRun.model_validate(response)
346
346
 
347
+ def stop(self, run_id: str) -> AgentRun:
348
+ """Stop a running Agent run, completing it early with the results gathered so far.
349
+
350
+ Only supported for `ultra` effort runs.
351
+
352
+ Examples:
353
+ from exa_py import Exa
354
+
355
+ exa = Exa("EXA_API_KEY")
356
+
357
+ run = exa.agent.runs.stop("agent_run_123")
358
+ print(run.stop_reason)
359
+ """
360
+ response = self.request(f"/{run_id}/stop", method="POST")
361
+ return AgentRun.model_validate(response)
362
+
347
363
  def delete(self, run_id: str) -> DeletedAgentRun:
348
364
  """Delete an Agent run.
349
365
 
@@ -427,7 +443,7 @@ class AgentRunsClient(AgentBaseClient):
427
443
  input: Optional structured input data for the Agent.
428
444
  output_schema: Optional JSON schema or Pydantic model for structured output.
429
445
  effort: Optional cost and reasoning effort preference. Defaults to auto.
430
- budget: Optional per-run spend ceiling for `auto` and `max`; the API
446
+ budget: Optional per-run spend ceiling for `auto` and `ultra`; the API
431
447
  validates this field and applies defaults when omitted.
432
448
  previous_run_id: Optional prior run ID to continue from.
433
449
  metadata: Optional metadata to attach to the run.
@@ -12,10 +12,17 @@ AGENT_MAX_EFFORT_BETA = "agent-max-effort-2026-07-27"
12
12
 
13
13
  AgentRunStatus = Literal["queued", "running", "completed", "failed", "cancelled"]
14
14
  AgentStopReason = Literal[
15
- "schema_satisfied", "budget_reached", "stopped", "error", "cancelled"
15
+ "schema_satisfied",
16
+ "budget_reached",
17
+ "time_limit_reached",
18
+ "stopped",
19
+ "error",
20
+ "cancelled",
16
21
  ]
17
22
  AgentConfidence = Literal["low", "medium", "high"]
18
- AgentEffort = Literal["minimal", "low", "medium", "high", "xhigh", "auto", "max"]
23
+ AgentEffort = Literal[
24
+ "minimal", "low", "medium", "high", "xhigh", "auto", "ultra", "max"
25
+ ]
19
26
 
20
27
  AgentDataSourceProvider = str
21
28
  """Identifier of an Exa Connect data provider."""
@@ -99,17 +106,25 @@ class AgentError(BaseModel):
99
106
 
100
107
 
101
108
  class AgentBudget(BaseModel):
102
- """Per-run spend ceiling for the metered `auto` and `max` efforts."""
109
+ """Per-run spend ceiling for the metered `auto` and `ultra` efforts."""
103
110
 
104
111
  max_cost_dollars: Optional[float] = Field(
105
112
  default=None,
106
113
  alias="maxCostDollars",
107
114
  description=(
108
115
  "Maximum spend for the run in US dollars. Only accepted by the API "
109
- "for `auto` and `max`; the server validates the allowed range and "
116
+ "for `auto` and `ultra`; the server validates the allowed range and "
110
117
  "applies defaults when omitted."
111
118
  ),
112
119
  )
120
+ max_duration_seconds: Optional[int] = Field(
121
+ default=None,
122
+ alias="maxDurationSeconds",
123
+ description=(
124
+ "Soft wall-clock ceiling in seconds (300-10,800). "
125
+ "Only accepted for `ultra`."
126
+ ),
127
+ )
113
128
 
114
129
  model_config = {"populate_by_name": True, "extra": "allow"}
115
130
 
@@ -1,6 +1,6 @@
1
1
  [tool.poetry]
2
2
  name = "exa-py"
3
- version = "2.22.2" # x-release-please-version
3
+ version = "2.23.0" # x-release-please-version
4
4
  description = "Python SDK for Exa API."
5
5
  authors = ["Exa AI <hello@exa.ai>"]
6
6
  readme = "README.md"
@@ -32,7 +32,7 @@ build-backend = "poetry.core.masonry.api"
32
32
 
33
33
  [project]
34
34
  name = "exa-py"
35
- version = "2.22.2"
35
+ version = "2.23.0"
36
36
  description = "Python SDK for Exa API."
37
37
  readme = "README.md"
38
38
  requires-python = ">=3.9"
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes