chp-adapter-jobs
Run any CHP capability as a polled background job. Built for heavy or
long-running capabilities — e.g. huggingface.generate_image (minutes on MPS) —
that outlive HTTP request timeouts.
How it works
submit runs the target capability via host.ainvoke inside a
ThreadPoolExecutor and returns a job_id immediately. The target runs to
completion server-side regardless of client timeouts, and — because the SQLite
evidence store is thread-safe — keeps its own full evidence chain. This
adapter emits only lightweight job-lifecycle events, never the target's payload
or result.
Capabilities
| Capability | Description |
|---|---|
chp.adapters.jobs.submit |
Submit {capability_id, payload}; returns a job_id. |
chp.adapters.jobs.status |
Poll lifecycle state: submitted / running / completed / failed + duration. |
chp.adapters.jobs.result |
Fetch a completed job's result data (ready: false while running). |
chp.adapters.jobs.list |
List all jobs and their state. |
Example: async image generation
// 1. submit — returns immediately
POST chp.adapters.jobs.submit
{ "capability_id": "chp.adapters.huggingface.generate_image",
"payload": { "prompt": "a serene mountain lake", "output_path": "/tmp/out.png" } }
// → { "job_id": "job_ab12…", "status": "submitted" }
// 2. poll
POST chp.adapters.jobs.status { "job_id": "job_ab12…" } // → running … completed
// 3. fetch result
POST chp.adapters.jobs.result { "job_id": "job_ab12…" }
// → { "ready": true, "success": true, "result": { "output_path": "/tmp/out.png", … } }
Config
| Field | Default | Meaning |
|---|---|---|
max_workers |
2 |
Thread pool size. |
allowed_capabilities |
None |
Allowlist of submittable capability ids (None = any). |
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file chp_adapter_jobs-0.19.0.tar.gz.
File metadata
- Download URL: chp_adapter_jobs-0.19.0.tar.gz
- Upload date:
- Size: 7.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f1117bde9cca13d51563d5603c424212479bcd053917ada1e56168d693c6978f
|
|
| MD5 |
723d599d2479d12bb380e611b5987e71
|
|
| BLAKE2b-256 |
c77b01a61ef2b9d7a3d986c84e24a6b1af610b43a76ce41df5dde8ec25f391f1
|
File details
Details for the file chp_adapter_jobs-0.19.0-py3-none-any.whl.
File metadata
- Download URL: chp_adapter_jobs-0.19.0-py3-none-any.whl
- Upload date:
- Size: 7.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c5f751311d5b520f9b379f37b0956754ea52c31700a87a82bd0031f3b4ac6120
|
|
| MD5 |
1a7a5044053f14fe861d08504dc3649b
|
|
| BLAKE2b-256 |
9de362d4792852c3f099e0a9277623ac8660425c9caef1e166436ac126610733
|
