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, strips secrets from logged event payloads (URLs, headers, kwargs, exceptions) before they hit the brain
- Policy types, role-based action enums (Viewer / Operator / Admin), used by the brain's RBAC 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 and additive within the 1.x major.
Adapter protocols (QueueEngineAdapter, etc.) are stable contracts
within the 1.x major; new optional methods may be added.
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.8.0.tar.gz.
File metadata
- Download URL: z4j_core-1.8.0.tar.gz
- Upload date:
- Size: 112.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8a8f84d89ba8fbef04421ca69aececbac09d20b93a618d3a8e1d686fbb0b3ed2
|
|
| MD5 |
c9ea4d9be2c2eb57813ba71b890ffb2c
|
|
| BLAKE2b-256 |
fa0635c7414aada4ebefbc392430cc5bccd683db56dea1e928d3c7022ba9cda9
|
File details
Details for the file z4j_core-1.8.0-py3-none-any.whl.
File metadata
- Download URL: z4j_core-1.8.0-py3-none-any.whl
- Upload date:
- Size: 106.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5610314ee23f869966f676716236376f27103d641b1702004f6cc3e8a6d712ca
|
|
| MD5 |
9721483df0ab2dd117a79145f4a079a2
|
|
| BLAKE2b-256 |
9743f305e2cb632a6b88bf37d8277e5a4031e6a7c287aa5c8acf494be5a3fc5c
|
