Skip to main content

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).

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chp_adapter_jobs-0.16.0.tar.gz (7.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

chp_adapter_jobs-0.16.0-py3-none-any.whl (7.3 kB view details)

Uploaded Python 3

File details

Details for the file chp_adapter_jobs-0.16.0.tar.gz.

File metadata

  • Download URL: chp_adapter_jobs-0.16.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

Hashes for chp_adapter_jobs-0.16.0.tar.gz
Algorithm Hash digest
SHA256 e5d97592168ee725ce35f147b851b3d9cbbd2b6fca92627e600898e762a5da1a
MD5 d6303282ec482037efd12c5d302b6b14
BLAKE2b-256 31a3834491c2476f43d2f36028cee44712f6430eb4a6d5dca7cdf6b85b43fa77

See more details on using hashes here.

File details

Details for the file chp_adapter_jobs-0.16.0-py3-none-any.whl.

File metadata

File hashes

Hashes for chp_adapter_jobs-0.16.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9c3a971ce5e5622558b3e3a5ae69be41f4b3f5e5b8fa579bc1f2a15ddbd94785
MD5 2a1af08eae2a2d68b36e0fe35470af83
BLAKE2b-256 7b9aef9d737b8a9eb955289eb5f9b847b9e49a8d28423f86cbb97b0f37525bf8

See more details on using hashes here.

Release history Release notifications | RSS feed

0.28.0

2 files

0.27.0

2 files

0.26.0

2 files

0.25.0

2 files

0.24.0

2 files

0.23.0

1 file

0.22.0

2 files

0.21.0

2 files

0.20.0

2 files

0.19.0

2 files

0.18.0

2 files

0.17.0

2 files

This release

0.16.0 This release

2 files

0.15.0

2 files

0.14.0

2 files

0.13.1

2 files

0.13.0

2 files

0.12.0

2 files

0.11.0

2 files

0.10.0

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page