hot-dev 1.3.0__tar.gz → 1.4.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 (45) hide show
  1. hot_dev-1.3.0/README.md → hot_dev-1.4.0/PKG-INFO +66 -18
  2. hot_dev-1.3.0/PKG-INFO → hot_dev-1.4.0/README.md +35 -38
  3. {hot_dev-1.3.0 → hot_dev-1.4.0}/pyproject.toml +34 -3
  4. hot_dev-1.4.0/src/hot/__init__.py +31 -0
  5. {hot_dev-1.3.0 → hot_dev-1.4.0}/src/hot/_streaming.py +241 -109
  6. hot_dev-1.4.0/src/hot/_transport.py +439 -0
  7. hot_dev-1.4.0/src/hot/_version.py +1 -0
  8. {hot_dev-1.3.0 → hot_dev-1.4.0}/src/hot/client.py +28 -4
  9. {hot_dev-1.3.0 → hot_dev-1.4.0}/src/hot/errors.py +44 -15
  10. {hot_dev-1.3.0 → hot_dev-1.4.0}/src/hot/resources.py +354 -322
  11. hot_dev-1.4.0/src/hot/sse.py +95 -0
  12. {hot_dev-1.3.0 → hot_dev-1.4.0}/src/hot/types.py +12 -1
  13. hot_dev-1.3.0/.github/dependabot.yml +0 -10
  14. hot_dev-1.3.0/.github/workflows/ci.yml +0 -163
  15. hot_dev-1.3.0/.github/workflows/release.yml +0 -37
  16. hot_dev-1.3.0/AGENTS.md +0 -80
  17. hot_dev-1.3.0/integration/VALIDATION.md +0 -51
  18. hot_dev-1.3.0/integration/fixture/.env.example +0 -3
  19. hot_dev-1.3.0/integration/fixture/.gitignore +0 -5
  20. hot_dev-1.3.0/integration/fixture/hot/src/fixture/sdk.hot +0 -79
  21. hot_dev-1.3.0/integration/fixture/hot.hot +0 -22
  22. hot_dev-1.3.0/integration/hot-server.ref +0 -1
  23. hot_dev-1.3.0/integration/run.sh +0 -37
  24. hot_dev-1.3.0/integration/suborg_fixture.py +0 -473
  25. hot_dev-1.3.0/src/hot/__init__.py +0 -13
  26. hot_dev-1.3.0/src/hot/_transport.py +0 -277
  27. hot_dev-1.3.0/src/hot/sse.py +0 -51
  28. hot_dev-1.3.0/tests/openapi_operations.json +0 -87
  29. hot_dev-1.3.0/tests/test_client.py +0 -248
  30. hot_dev-1.3.0/tests/test_deadlines.py +0 -228
  31. hot_dev-1.3.0/tests/test_integration.py +0 -174
  32. hot_dev-1.3.0/tests/test_openapi_coverage.py +0 -143
  33. hot_dev-1.3.0/tests/test_orgs.py +0 -215
  34. hot_dev-1.3.0/tests/test_reconnect.py +0 -194
  35. hot_dev-1.3.0/tests/test_reconnect_policy.py +0 -295
  36. hot_dev-1.3.0/tests/test_resources.py +0 -153
  37. hot_dev-1.3.0/tests/test_run_correlation.py +0 -346
  38. hot_dev-1.3.0/tests/test_runs.py +0 -80
  39. hot_dev-1.3.0/tests/test_suborg_integration.py +0 -244
  40. hot_dev-1.3.0/tests/test_tasks.py +0 -79
  41. hot_dev-1.3.0/tests/test_transport.py +0 -132
  42. {hot_dev-1.3.0 → hot_dev-1.4.0}/.gitignore +0 -0
  43. {hot_dev-1.3.0 → hot_dev-1.4.0}/LICENSE +0 -0
  44. {hot_dev-1.3.0 → hot_dev-1.4.0}/NOTICE +0 -0
  45. {hot_dev-1.3.0 → hot_dev-1.4.0}/src/hot/py.typed +0 -0
@@ -1,3 +1,34 @@
1
+ Metadata-Version: 2.5
2
+ Name: hot-dev
3
+ Version: 1.4.0
4
+ Summary: Python SDK for the Hot Dev API
5
+ Project-URL: Homepage, https://hot.dev
6
+ Project-URL: Repository, https://github.com/hot-dev/hot-python
7
+ Project-URL: Issues, https://github.com/hot-dev/hot-python/issues
8
+ Author: Hot Dev, LLC
9
+ License-Expression: Apache-2.0
10
+ License-File: LICENSE
11
+ License-File: NOTICE
12
+ Keywords: agents,api,hot,hot-dev,sdk,streaming
13
+ Classifier: Development Status :: 5 - Production/Stable
14
+ Classifier: Intended Audience :: Developers
15
+ Classifier: License :: OSI Approved :: Apache Software License
16
+ Classifier: Operating System :: OS Independent
17
+ Classifier: Programming Language :: Python :: 3
18
+ Classifier: Programming Language :: Python :: 3.10
19
+ Classifier: Programming Language :: Python :: 3.11
20
+ Classifier: Programming Language :: Python :: 3.12
21
+ Classifier: Programming Language :: Python :: 3.13
22
+ Classifier: Typing :: Typed
23
+ Requires-Python: >=3.10
24
+ Requires-Dist: httpx<1.0,>=0.28
25
+ Provides-Extra: dev
26
+ Requires-Dist: build==1.6.1; extra == 'dev'
27
+ Requires-Dist: mypy==1.15.0; extra == 'dev'
28
+ Requires-Dist: pytest==9.2.0; extra == 'dev'
29
+ Requires-Dist: ruff==0.17.6; extra == 'dev'
30
+ Description-Content-Type: text/markdown
31
+
1
32
  # hot-dev
2
33
 
3
34
  Official Python SDK for the [Hot Dev](https://hot.dev) API.
@@ -100,14 +131,17 @@ and `streams.subscribe_with_event` share one reconnect policy:
100
131
  cross the deadline raises `TimeoutError` instead.
101
132
  - `max_attempts` (default 5) counts consecutive failed connections. The API
102
133
  closes every subscription 5 minutes after it opens, with `stream:complete`;
103
- those rollovers reconnect at once and do not count, so long runs can be
104
- awaited for as long as `timeout` allows.
134
+ explicit `stream:complete` rollovers reconnect at once and do not count, so
135
+ long runs can be awaited for as long as `timeout` allows. Unexpected premature
136
+ stream closes without `stream:complete` back off and count against
137
+ `max_attempts`.
105
138
  - A run with status `pending_retry` is not final, whatever the event: the
106
- waiter follows the handler's retry run (linked by `origin_run_id`). Hot can
107
- replay a retried attempt as `run:fail` with status `failed` before the retry
108
- run exists; when its `retry_attempt` shows a scheduled retry, the waiter
109
- holds that failure for 5 seconds (or until `timeout`) and raises it only if
110
- no retry run appears. `subscribe_with_event` yields that `run:fail` and ends
139
+ waiter follows the handler's retry run (linked by `retry_run_id` or
140
+ `origin_run_id`). Hot can replay a retried attempt as `run:fail` with status
141
+ `failed` before the retry run exists; when its `retry_attempt` shows a
142
+ scheduled retry, the waiter holds that failure for 5 seconds (or until
143
+ `timeout`) and raises `HotRunError` (a `RuntimeError` subclass) only if no
144
+ retry run appears. `subscribe_with_event` yields that `run:fail` and ends
111
145
  after the same grace.
112
146
  - `on_chunk` receives `stream:data` text in order, including chunks the server
113
147
  delivers before `run:start`.
@@ -164,18 +198,28 @@ every runtime resource.
164
198
 
165
199
  ### Retries
166
200
 
167
- JSON requests are retried automatically (at most twice) when the API responds
168
- 429 with a `retry_after`, and idempotent requests (GET, PUT, DELETE) also on
169
- 502, 503 and 504. Other errors are raised as-is. Raw requests are never
170
- retried; waiters follow the reconnect policy above.
201
+ JSON requests are retried automatically (at most twice, bounded by the client's
202
+ configured read timeout) when the API responds:
203
+
204
+ - `429` with a `retry_after` (including `0`, integer seconds, or HTTP-date),
205
+ - `502`, `503`, or `504` on idempotent requests (`GET`, `HEAD`, `PUT`, `DELETE`),
206
+ - `503` with error code `event_publish_in_progress` on `POST` (for example,
207
+ concurrent retries of `events.publish` with the same client-supplied
208
+ `event_id`).
209
+
210
+ Other errors (including `409 event_id_conflict` when an `event_id` is reused
211
+ with different parameters) are raised as-is. Raw requests (`request_raw`,
212
+ uploads, downloads) are never retried; waiters follow the reconnect policy
213
+ above.
171
214
 
172
215
  ## Resources
173
216
 
174
- `HotClient` mirrors the Hot API v1 resources:
217
+ `HotClient` mirrors the Hot API resources:
175
218
 
176
- - `hot.events` — publish, list, get, inspect event runs, and call Hot functions with `call_hot(fn, args)`
219
+ - `hot.status()` — public, unauthenticated server health check (`GET /status`; does not send `Authorization`)
220
+ - `hot.events` — publish (pass an optional `event_id` for idempotent retries; conflicting reuse returns `409 event_id_conflict`), list, get, inspect event runs, and call Hot functions with `call_hot(fn, args)`
177
221
  - `hot.streams` — subscribe to run and task updates, wait for run results, and publish events atomically (reconnects automatically across the 5-minute SSE timeout; pass `reconnect=False` to opt out)
178
- - `hot.runs` — list, inspect, subscribe to, and wait for durable runs
222
+ - `hot.runs` — list (filter by `status`, `type`, `time_range`, `project_id`, `stream_id`, `function`, `limit`, `offset`), inspect, subscribe to, and wait for durable runs
179
223
  - `hot.tasks` — get, subscribe to, and wait for durable background tasks
180
224
  - `hot.files` — upload, download (`download_stream` for large files), list, and delete files (including multipart uploads)
181
225
  - `hot.projects` — create, list, update, activate, deactivate, and delete projects
@@ -188,10 +232,12 @@ retried; waiters follow the reconnect policy above.
188
232
  - `hot.org` — view the environment's usage and limits
189
233
  - `hot.env` — read environment info, subscribe to environment events, and purge call traces
190
234
  - `hot.orgs` — with an org API key: sub-organizations, their environments and API keys, account usage, and `orgs.env(org_id, env_id)` for projects, builds and context in an environment
191
- - `hot.api_keys` — with an org API key: get, narrow, rotate, and revoke API keys it issued
235
+ - `hot.api_keys` — with an org API key: get, narrow, rotate, and revoke API keys it issued (`status` can be `active`, `revoked`, `disabled`, `expired`, `issuer_inactive`, or `suspended`)
192
236
 
193
- Use `hot.request(...)` or `hot.request_raw(...)` as an escape hatch for API
194
- endpoints that do not yet have a resource helper.
237
+ Use `hot.request(...)` or `hot.request_raw(...)` as an escape hatch for `/v1`
238
+ API endpoints that do not yet have a resource helper. Paths are resolved under
239
+ `/v1` automatically (pass `"/runs"` or `"runs"`, not `"/v1/runs"`); use
240
+ `hot.status()` for the unversioned `GET /status` route.
195
241
 
196
242
  `hot.env.subscribe()` requires API key credentials and a live API pub/sub
197
243
  backend; local API servers without pub/sub return a 503. `subscribe_with_event`
@@ -203,7 +249,9 @@ not end the iterator.
203
249
 
204
250
  Without `timeout` or `client`, requests time out after 60 s per read and 10 s
205
251
  to connect; pass `timeout=httpx.Timeout(None)` to disable that. Streams and
206
- waiters set their own timeouts.
252
+ waiters set their own timeouts. Note that `timeout=` is ignored when you pass a
253
+ custom `client=` — configure timeouts on your `httpx.Client` /
254
+ `httpx.AsyncClient` instead.
207
255
 
208
256
  `HotClient` and `AsyncHotClient` accept an `httpx.Client` (or
209
257
  `httpx.AsyncClient`) via the `client=` argument. Use this to configure retries,
@@ -1,23 +1,3 @@
1
- Metadata-Version: 2.5
2
- Name: hot-dev
3
- Version: 1.3.0
4
- Summary: Python SDK for the Hot Dev API
5
- Project-URL: Homepage, https://hot.dev
6
- Project-URL: Repository, https://github.com/hot-dev/hot-python
7
- Project-URL: Issues, https://github.com/hot-dev/hot-python/issues
8
- Author: Hot Dev, LLC
9
- License-Expression: Apache-2.0
10
- License-File: LICENSE
11
- License-File: NOTICE
12
- Keywords: agents,api,hot,hot-dev,sdk,streaming
13
- Requires-Python: >=3.10
14
- Requires-Dist: httpx>=0.28
15
- Provides-Extra: dev
16
- Requires-Dist: build==1.6.1; extra == 'dev'
17
- Requires-Dist: pytest==9.2.0; extra == 'dev'
18
- Requires-Dist: ruff==0.17.3; extra == 'dev'
19
- Description-Content-Type: text/markdown
20
-
21
1
  # hot-dev
22
2
 
23
3
  Official Python SDK for the [Hot Dev](https://hot.dev) API.
@@ -120,14 +100,17 @@ and `streams.subscribe_with_event` share one reconnect policy:
120
100
  cross the deadline raises `TimeoutError` instead.
121
101
  - `max_attempts` (default 5) counts consecutive failed connections. The API
122
102
  closes every subscription 5 minutes after it opens, with `stream:complete`;
123
- those rollovers reconnect at once and do not count, so long runs can be
124
- awaited for as long as `timeout` allows.
103
+ explicit `stream:complete` rollovers reconnect at once and do not count, so
104
+ long runs can be awaited for as long as `timeout` allows. Unexpected premature
105
+ stream closes without `stream:complete` back off and count against
106
+ `max_attempts`.
125
107
  - A run with status `pending_retry` is not final, whatever the event: the
126
- waiter follows the handler's retry run (linked by `origin_run_id`). Hot can
127
- replay a retried attempt as `run:fail` with status `failed` before the retry
128
- run exists; when its `retry_attempt` shows a scheduled retry, the waiter
129
- holds that failure for 5 seconds (or until `timeout`) and raises it only if
130
- no retry run appears. `subscribe_with_event` yields that `run:fail` and ends
108
+ waiter follows the handler's retry run (linked by `retry_run_id` or
109
+ `origin_run_id`). Hot can replay a retried attempt as `run:fail` with status
110
+ `failed` before the retry run exists; when its `retry_attempt` shows a
111
+ scheduled retry, the waiter holds that failure for 5 seconds (or until
112
+ `timeout`) and raises `HotRunError` (a `RuntimeError` subclass) only if no
113
+ retry run appears. `subscribe_with_event` yields that `run:fail` and ends
131
114
  after the same grace.
132
115
  - `on_chunk` receives `stream:data` text in order, including chunks the server
133
116
  delivers before `run:start`.
@@ -184,18 +167,28 @@ every runtime resource.
184
167
 
185
168
  ### Retries
186
169
 
187
- JSON requests are retried automatically (at most twice) when the API responds
188
- 429 with a `retry_after`, and idempotent requests (GET, PUT, DELETE) also on
189
- 502, 503 and 504. Other errors are raised as-is. Raw requests are never
190
- retried; waiters follow the reconnect policy above.
170
+ JSON requests are retried automatically (at most twice, bounded by the client's
171
+ configured read timeout) when the API responds:
172
+
173
+ - `429` with a `retry_after` (including `0`, integer seconds, or HTTP-date),
174
+ - `502`, `503`, or `504` on idempotent requests (`GET`, `HEAD`, `PUT`, `DELETE`),
175
+ - `503` with error code `event_publish_in_progress` on `POST` (for example,
176
+ concurrent retries of `events.publish` with the same client-supplied
177
+ `event_id`).
178
+
179
+ Other errors (including `409 event_id_conflict` when an `event_id` is reused
180
+ with different parameters) are raised as-is. Raw requests (`request_raw`,
181
+ uploads, downloads) are never retried; waiters follow the reconnect policy
182
+ above.
191
183
 
192
184
  ## Resources
193
185
 
194
- `HotClient` mirrors the Hot API v1 resources:
186
+ `HotClient` mirrors the Hot API resources:
195
187
 
196
- - `hot.events` — publish, list, get, inspect event runs, and call Hot functions with `call_hot(fn, args)`
188
+ - `hot.status()` — public, unauthenticated server health check (`GET /status`; does not send `Authorization`)
189
+ - `hot.events` — publish (pass an optional `event_id` for idempotent retries; conflicting reuse returns `409 event_id_conflict`), list, get, inspect event runs, and call Hot functions with `call_hot(fn, args)`
197
190
  - `hot.streams` — subscribe to run and task updates, wait for run results, and publish events atomically (reconnects automatically across the 5-minute SSE timeout; pass `reconnect=False` to opt out)
198
- - `hot.runs` — list, inspect, subscribe to, and wait for durable runs
191
+ - `hot.runs` — list (filter by `status`, `type`, `time_range`, `project_id`, `stream_id`, `function`, `limit`, `offset`), inspect, subscribe to, and wait for durable runs
199
192
  - `hot.tasks` — get, subscribe to, and wait for durable background tasks
200
193
  - `hot.files` — upload, download (`download_stream` for large files), list, and delete files (including multipart uploads)
201
194
  - `hot.projects` — create, list, update, activate, deactivate, and delete projects
@@ -208,10 +201,12 @@ retried; waiters follow the reconnect policy above.
208
201
  - `hot.org` — view the environment's usage and limits
209
202
  - `hot.env` — read environment info, subscribe to environment events, and purge call traces
210
203
  - `hot.orgs` — with an org API key: sub-organizations, their environments and API keys, account usage, and `orgs.env(org_id, env_id)` for projects, builds and context in an environment
211
- - `hot.api_keys` — with an org API key: get, narrow, rotate, and revoke API keys it issued
204
+ - `hot.api_keys` — with an org API key: get, narrow, rotate, and revoke API keys it issued (`status` can be `active`, `revoked`, `disabled`, `expired`, `issuer_inactive`, or `suspended`)
212
205
 
213
- Use `hot.request(...)` or `hot.request_raw(...)` as an escape hatch for API
214
- endpoints that do not yet have a resource helper.
206
+ Use `hot.request(...)` or `hot.request_raw(...)` as an escape hatch for `/v1`
207
+ API endpoints that do not yet have a resource helper. Paths are resolved under
208
+ `/v1` automatically (pass `"/runs"` or `"runs"`, not `"/v1/runs"`); use
209
+ `hot.status()` for the unversioned `GET /status` route.
215
210
 
216
211
  `hot.env.subscribe()` requires API key credentials and a live API pub/sub
217
212
  backend; local API servers without pub/sub return a 503. `subscribe_with_event`
@@ -223,7 +218,9 @@ not end the iterator.
223
218
 
224
219
  Without `timeout` or `client`, requests time out after 60 s per read and 10 s
225
220
  to connect; pass `timeout=httpx.Timeout(None)` to disable that. Streams and
226
- waiters set their own timeouts.
221
+ waiters set their own timeouts. Note that `timeout=` is ignored when you pass a
222
+ custom `client=` — configure timeouts on your `httpx.Client` /
223
+ `httpx.AsyncClient` instead.
227
224
 
228
225
  `HotClient` and `AsyncHotClient` accept an `httpx.Client` (or
229
226
  `httpx.AsyncClient`) via the `client=` argument. Use this to configure retries,
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "hot-dev"
7
- version = "1.3.0"
7
+ version = "1.4.0"
8
8
  description = "Python SDK for the Hot Dev API"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
@@ -20,8 +20,20 @@ keywords = [
20
20
  "agents",
21
21
  "streaming",
22
22
  ]
23
+ classifiers = [
24
+ "Development Status :: 5 - Production/Stable",
25
+ "Intended Audience :: Developers",
26
+ "License :: OSI Approved :: Apache Software License",
27
+ "Operating System :: OS Independent",
28
+ "Programming Language :: Python :: 3",
29
+ "Programming Language :: Python :: 3.10",
30
+ "Programming Language :: Python :: 3.11",
31
+ "Programming Language :: Python :: 3.12",
32
+ "Programming Language :: Python :: 3.13",
33
+ "Typing :: Typed",
34
+ ]
23
35
  dependencies = [
24
- "httpx>=0.28",
36
+ "httpx>=0.28,<1.0",
25
37
  ]
26
38
 
27
39
  [project.urls]
@@ -33,13 +45,32 @@ Issues = "https://github.com/hot-dev/hot-python/issues"
33
45
  # Pinned so CI and releases use reviewed tool versions; Dependabot bumps them.
34
46
  dev = [
35
47
  "build==1.6.1",
48
+ "mypy==1.15.0",
36
49
  "pytest==9.2.0",
37
- "ruff==0.17.3",
50
+ "ruff==0.17.6",
38
51
  ]
39
52
 
40
53
  [tool.hatch.build.targets.wheel]
41
54
  packages = ["src/hot"]
42
55
 
56
+ [tool.hatch.build.targets.sdist]
57
+ include = [
58
+ "src/hot",
59
+ "README.md",
60
+ "LICENSE",
61
+ "NOTICE",
62
+ "pyproject.toml",
63
+ ]
64
+
65
+ [tool.mypy]
66
+ python_version = "3.10"
67
+ warn_unused_ignores = true
68
+ warn_redundant_casts = true
69
+ check_untyped_defs = true
70
+ disallow_untyped_defs = true
71
+ no_implicit_optional = true
72
+ strict_equality = true
73
+
43
74
  [tool.ruff]
44
75
  line-length = 100
45
76
  target-version = "py310"
@@ -0,0 +1,31 @@
1
+ from ._version import __version__
2
+ from .client import AsyncHotClient, HotClient
3
+ from .errors import HotApiError, HotKeyScopeError, HotRunError, HotTaskError
4
+ from .sse import consume_sse_blocks
5
+ from .types import (
6
+ ApiListResponse,
7
+ ApiResponse,
8
+ AsyncStreamEvents,
9
+ JsonObject,
10
+ JsonValue,
11
+ StreamEvent,
12
+ StreamEvents,
13
+ )
14
+
15
+ __all__ = [
16
+ "ApiListResponse",
17
+ "ApiResponse",
18
+ "AsyncHotClient",
19
+ "AsyncStreamEvents",
20
+ "HotApiError",
21
+ "HotClient",
22
+ "HotKeyScopeError",
23
+ "HotRunError",
24
+ "HotTaskError",
25
+ "JsonObject",
26
+ "JsonValue",
27
+ "StreamEvent",
28
+ "StreamEvents",
29
+ "__version__",
30
+ "consume_sse_blocks",
31
+ ]