z4j-core
The z4j domain core, shared models, protocols, transport, redaction, policy.
Pure-Python dependency for every z4j package. No framework / engine / database imports, so it can be vendored into agent processes without dragging server runtime weight. End users do not install this package directly; it ships as a transitive dependency of z4j or any agent package.
Compatibility
Python 3.11+. Pure-Python, no framework or database imports.
Full per-adapter matrix at https://z4j.dev/reference/compatibility/.
What's in here
- Pydantic models,
Task,Worker,Queue,Schedule,Event,Command,Agent, plus the wire-frame envelope types - Adapter protocols,
QueueEngineAdapter,SchedulerAdapter,FrameworkAdapter. Every framework / engine / scheduler package implements one or more of these. - Wire protocol, frame definitions and the HMAC envelope used by z4j ↔ agent WebSocket transport (signed v2 protocol)
- Redaction engine, scrubs values that match the built-in or operator-configured patterns from event payloads (URLs, headers, kwargs, exceptions) before they hit the brain
- Policy helpers, role-based action enums and a pure policy engine for direct consumers. The brain enforces its API RBAC in its own domain layer.
- Error hierarchy, shared exception classes so agents and brain
agree on what counts as
AuthorizationErrorvsNotFoundErrorvsConflictError
Install
pip install z4j-core
End users normally get this as a transitive dependency. Direct installation is appropriate when you're building a custom adapter against the protocols.
Stability
The wire protocol is v=2; its frame models ignore additive fields.
Product-version skew is narrower than the wire format alone, so upgrade
the active z4j packages together according to the
compatibility policy. Adapter
interfaces are structural Python protocols; adding a method can therefore
require coordinated adapter updates even when the wire format is unchanged.
Documentation
Full docs at z4j.dev/concepts/architecture/.
License
Apache-2.0, see LICENSE.
Links
- Homepage: https://z4j.com
- Documentation: https://z4j.dev
- PyPI: https://pypi.org/project/z4j-core/
- Issues: https://github.com/z4jdev/z4j-core/issues
- Changelog: CHANGELOG.md
- Security: security@z4j.com (see SECURITY.md)
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 z4j_core-1.9.0.tar.gz.
File metadata
- Download URL: z4j_core-1.9.0.tar.gz
- Upload date:
- Size: 131.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
62d4d7d51700cccfd363680fe880bdf29206932d71243aa81e136a3b547b4ae9
|
|
| MD5 |
b69a1f0611881309243b54524e15aa3e
|
|
| BLAKE2b-256 |
a6c4dc547e88ef2fe87ddcda40bd264e199dddf73d772105ddf2925d4cc06d7e
|
File details
Details for the file z4j_core-1.9.0-py3-none-any.whl.
File metadata
- Download URL: z4j_core-1.9.0-py3-none-any.whl
- Upload date:
- Size: 114.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ed81d3e4163a524b7d30631bad77187ffa480aed5e34651da1cad83df4737481
|
|
| MD5 |
486ce80d2b7b72121d697b3525bbcd37
|
|
| BLAKE2b-256 |
dba9f5d0cfc62357c274b712cbb04944673480f230b804eb0ee362e06d378337
|
