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.
- {exa_py-2.22.2 → exa_py-2.23.0}/PKG-INFO +4 -6
- {exa_py-2.22.2 → exa_py-2.23.0}/README.md +3 -5
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/async_client.py +17 -1
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/client.py +18 -2
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/types.py +19 -4
- {exa_py-2.22.2 → exa_py-2.23.0}/pyproject.toml +2 -2
- {exa_py-2.22.2 → exa_py-2.23.0}/LICENSE +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/__init__.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/__init__.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/async_base.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/base.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/betas.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/monitors/__init__.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/monitors/async_base.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/monitors/async_client.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/monitors/base.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/monitors/client.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/monitors/types.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/agent/utils.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/api.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/monitors/__init__.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/monitors/async_base.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/monitors/async_client.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/monitors/base.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/monitors/client.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/monitors/types.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/py.typed +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/research/__init__.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/research/async_client.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/research/base.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/research/models.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/research/sync_client.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/research/utils.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/tools.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/utils.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/__init__.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/_generator/pydantic/BaseModel.jinja2 +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/async_client.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/client.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/core/__init__.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/core/async_base.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/core/base.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/enrichments/__init__.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/enrichments/client.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/events/__init__.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/events/client.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/imports/__init__.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/imports/client.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/items/__init__.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/items/client.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/monitors/__init__.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/monitors/client.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/monitors/runs/__init__.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/monitors/runs/client.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/searches/__init__.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/searches/client.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/types.py +0 -0
- {exa_py-2.22.2 → exa_py-2.23.0}/exa_py/websets/webhooks/__init__.py +0 -0
- {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.
|
|
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
|
|
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.
|
|
255
|
+
run = exa.agent.runs.create(
|
|
257
256
|
query="Find all companies building browser automation tools in the United States.",
|
|
258
|
-
effort="
|
|
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
|
|
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.
|
|
228
|
+
run = exa.agent.runs.create(
|
|
230
229
|
query="Find all companies building browser automation tools in the United States.",
|
|
231
|
-
effort="
|
|
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 `
|
|
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 `
|
|
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 `
|
|
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",
|
|
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[
|
|
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 `
|
|
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 `
|
|
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.
|
|
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.
|
|
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
|
|
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
|
|
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
|
|
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
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|