kazen-event-schema

Canonical KazenEvent schema shared across KazenAI services (orchestrator, FinOps, AgentLens, kazenai-core).

pip install -e ./kazen-event-schema

Publishing status: this workspace version is not yet published on PyPI. Use the local editable install above until the package release workflow is moved into a real repo and run.

Canonical event types

Model invocation: use model.call (not llm.call; legacy llm.call is normalized at ingest).
Human gates: gate.decision, human_gate, human.gate
FinOps: finops.trajectory, finops.circuit_breaker.opened, finops.pause, finops.resumed
Run lifecycle: run.started, run.completed, run.failed

from kazen_event_schema import KazenEvent, normalize_event_type, is_model_call

assert normalize_event_type("llm.call") == "model.call"
assert is_model_call("model.call")

Required / recommended fields (v1.2)

Field	Required	Purpose
`schema_version`	yes	`1.0`, `1.1`, or `1.2`
`event_id`	yes	UUID; idempotent ingest
`ts_ms`	yes	Unix ms timestamp
`event_type`	yes	Dotted lowercase (e.g. `model.call`)
`org_id`	yes	Tenant
`workspace_id` / `project_id`	yes	Workspace scope (alias: `project_id` → workspace)
`run_id`	recommended	Correlates all steps in a run
`step_id`	recommended	Step within run
`parent_step_id`	optional	Multi-agent tree
`agent_role`	recommended	planner, coder, brain, etc.
`tokens` / `tokens_used`	optional	Token count (synced if one set)
`cost_usd`	optional	Step cost
`gate_decision`	optional	proceed, rejected, retry_plan, …
`gate_latency_s`	optional	Human gate wait time
`payload`	optional	Tool names, model id, I/O refs

Service ports

See ../PORTS.md.

License

Apache License 2.0. See LICENSE and NOTICE.

Release files for kazen-event-schema 0.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kazen-event-schema 0.6.0
File	Size	Uploaded
kazen_event_schema-0.6.0.tar.gz	37.6 kB	Sep 18, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for kazen-event-schema 0.6.0
File	Interpreter	ABI	Platform	Reset
kazen_event_schema-0.6.0-py3-none-any.whl 27.9 kB Sep 18, 2026	Python 3	none	any	Details

Total release size: 65.5 kB

Release files / kazen_event_schema-0.6.0.tar.gz

Download URL	kazen_event_schema-0.6.0.tar.gz
Size	37.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`01c183ff4dcc681126d2a9312766a873c0cb26da788792eb6f8f83df183947a0`
BLAKE2b-256 checksum How to use checksums	`80bfb603432227156485c68722185ca9299f4f8f3e80b2e4e2a84c8b758e80f3`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/kazenai-ai/kazen-event-schema
Publishing commit: github.com/kazenai-ai/kazen-event-schema/tree/dfee84151529df03221989131f3b8507234cc73b

Workflow

Publishing configuration: github.com/kazenai-ai/kazen-event-schema/blob/dfee84151529df03221989131f3b8507234cc73b/.github/workflows/publish.yml
Publishing logs: github.com/kazenai-ai/kazen-event-schema/actions/runs/35402912427/attempts/1

Artifact

Subject: kazen_event_schema-0.6.0.tar.gz
SHA-256 checksum: 01c183ff4dcc681126d2a9312766a873c0cb26da788792eb6f8f83df183947a0 Verifying attestations

Release files / kazen_event_schema-0.6.0-py3-none-any.whl

Download URL	kazen_event_schema-0.6.0-py3-none-any.whl
Size	27.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d89f5c6ad46ff577b2b9230759cc6347aa1e410196d9fc85bd92afa56b5d8efb`
BLAKE2b-256 checksum How to use checksums	`b1c3da59dc64d81701d45d12c2429568d4d740754e91e0d61cbfd9cc9e7bc7b6`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/kazenai-ai/kazen-event-schema
Publishing commit: github.com/kazenai-ai/kazen-event-schema/tree/dfee84151529df03221989131f3b8507234cc73b

Workflow

Publishing configuration: github.com/kazenai-ai/kazen-event-schema/blob/dfee84151529df03221989131f3b8507234cc73b/.github/workflows/publish.yml
Publishing logs: github.com/kazenai-ai/kazen-event-schema/actions/runs/35402912427/attempts/1

Artifact

Subject: kazen_event_schema-0.6.0-py3-none-any.whl
SHA-256 checksum: d89f5c6ad46ff577b2b9230759cc6347aa1e410196d9fc85bd92afa56b5d8efb Verifying attestations