DOCUMENTATION / REFERENCE 1.0.0

Start with the contracts.

Eventus Engine connects bounded runs, approved context, versioned workflows, and attributable decisions. This reference describes the inspected Python implementation at revision 7897a80.

This is an architecture and local-code reference. There is no public SDK, hosted API, or installation service offered by this preview.

INTRODUCTION

A run carries its boundaries with it.

Start with a workflow identity and version. Bind the run to one namespace and a context version. Review the artifact and intended effect before authorizing a consequential action. Link outcomes to those same records.

Namespace: An exact identifier for a governed scope. A parent identifier does not imply access to a child.
Run: One invocation of a workflow, with its own identity, mode, references, timestamps, and status.
Workflow: A versioned process definition declaring inputs, outputs, capabilities, approval requirements, and resource limits.
Context: A versioned record of source references, provenance, applicability, approval status, and reuse scope.
Artifact: A referenced output with a content hash. Approval must match the reviewed artifact.
Approval: An attributable decision for a particular run, artifact, action, and scope.
Task alias: A stable routing name, such as general, independent of a model vendor. It does not mean a live provider is configured.
Knowledge proposal: An evidence-linked candidate for reuse. Promotion requires review and does not itself authorize production activation.

CURRENT CONTRACT FIELDS

Schema version 1.0.0.

These field inventories come from the current run, workflow, context, approval, and knowledge JSON Schemas. All listed keys are required to be present. Some allow null. Additional properties are rejected.

Namespace identifiers are at most 128 characters. They allow alphanumeric segments, underscores, and hyphens separated by dots. Workflow versions use three numeric components. Content hashes use a sha256 prefix and 64 lowercase hexadecimal characters. Canonical runtime timestamps use UTC with +00:00.

Eventus Run v1.0.016 fields

FIELDTYPE / CONSTRAINT

run_idstring · nonempty

namespace_idstring · format constrained

workflow_idstring · nonempty

workflow_versionstring · format constrained

context_versionstring · nonempty

model_routestring · nonempty

modeadvisory | dry-run | production

approval_idstring | null

idempotency_keystring | null

input_referencesarray

created_atstring · date-time

started_atstring | null · date-time

completed_atstring | null · date-time

trigger_refstring | null

schema_versionFixed: 1.0.0

Source: schemas/run-envelope.schema.json at 7897a80. This inventory is a field reference, not a replacement validator.

Eventus Workflow v1.0.021 fields

FIELDTYPE / CONSTRAINT

workflow_idstring · format constrained

workflow_versionstring · format constrained

namespace_idstring · format constrained

trigger_typesarray · at least 1 item

required_inputsarray

expected_outputsarray · at least 1 item

allowed_capabilitiesarray

purposestring · nonempty

model_routestring · format constrained

approval_requirementsarray

external_effectnone | proposed | high_impact

retry_limitinteger · min 0 · max 20

timeout_secondsinteger · min 1 · max 86400

max_cost_unitsinteger · min 0

max_memory_mbinteger · min 1

idempotency_scopestring · nonempty

audit_eventsarray

failure_policystring · nonempty

feedback_outputsarray

modeadvisory | dry-run | production

schema_versionFixed: 1.0.0

Source: schemas/workflow.schema.json at 7897a80. This inventory is a field reference, not a replacement validator.

Eventus Context v1.0.012 fields

FIELDTYPE / CONSTRAINT

context_refstring · nonempty

context_versionstring · nonempty

namespace_idstring · format constrained

content_hashstring · format constrained

source_refsarray · at least 1 item

applicabilitystring · nonempty

approval_statusnot_required | pending | approved | rejected

created_atstring · date-time

originating_run_idstring | null

originating_artifact_refstring | null

reuse_scopeFixed: namespace_only

schema_versionFixed: 1.0.0

Source: schemas/context.schema.json at 7897a80. This inventory is a field reference, not a replacement validator.

Eventus Artifact-Bound Approval v1.0.013 fields

FIELDTYPE / CONSTRAINT

approval_idstring · format constrained

namespace_idstring · format constrained

run_idstring · nonempty

artifact_refstring · nonempty

artifact_hashstring · format constrained

actionstring · nonempty

scopestring · nonempty

decisionpending | approved | changes_requested | rejected | escalated

actor_idstring · nonempty

reasonstring · nonempty

created_atstring · date-time

decided_atstring | null · date-time

schema_versionFixed: 1.0.0

Source: schemas/approval.schema.json at 7897a80. This inventory is a field reference, not a replacement validator.

Eventus Knowledge State v1.0.012 fields

FIELDTYPE / CONSTRAINT

knowledge_idstring · format constrained

namespace_idstring · format constrained

claimstring · nonempty

applicabilitystring · nonempty

reuse_scopenamespace_only | explicit_namespaces | platform_candidate

evidence_refsarray

source_run_idsarray

reuse_namespace_idsarray

created_atstring · date-time

updated_atstring · date-time

schema_versionFixed: 1.0.0

Source: schemas/knowledge.schema.json at 7897a80. This inventory is a field reference, not a replacement validator.

Validation and authorization are different checks.

A run schema accepts a production mode value. That does not enable production execution. The reference orchestrator disables production by default and requires explicit namespace authorization.

EXECUTABLE LOCAL REFERENCE

Inspect one dry-run envelope.

The inspect-run.py reference file constructs a synthetic run, validates its schema, uses a pure in-memory handler, and confirms that a parent namespace grant is rejected. It makes no model, tool, database, or network call.

Save the file as inspect-run.py in the root of an existing authorized engine checkout, then run:

From the engine checkout root

PYTHONPATH=src python3 inspect-run.py

Expected output, followed by the full JSON envelope

Parent namespace grant rejected: expected.
Pure in-memory handler completed. No external effect requested.

Inspect the complete synthetic run-envelope JSON. The downloadable payload is validated against the same schema and is independent of any tenant data.

A dry-run label is not a sandbox.

The reference orchestrator calls a handler supplied by the caller. This example uses a pure function. Do not pass an effectful handler and assume the mode will suppress its behavior.

Repeat the scoped repository checks.

Both commands below passed locally against 7897a80 on October 17, 2026: 4 foundation tests and 22 state tests.

Verified local checks

python3 -m unittest discover -s tests -p test_foundation.py -v
python3 -m unittest discover -s tests -p test_state.py -v

Read the complete validation boundary

PREREQUISITES

Use an existing authorized checkout.

Python 3.11 or later. The example was checked with the local Python interpreter.
Eventus Engine source at revision 7897a80, including its src/ and schemas/ directories.
The checkout’s existing dependencies. The core project declares jsonschema >=4.18,<5 and PyYAML >=6,<7.
Existing permission to access that source. This preview does not grant repository access or a distribution license.

LIMITATIONS

Local semantics have a defined scope.

The reference demonstrates local schema validation and namespace authorization. It does not exercise a deployed service, a model provider, Hermes, production identity, encrypted storage, or an external effect executor.

The complete engine suite is not green in the inspected environment: 24 of 144 tests errored because a downstream dependency, cryptography, is missing. The scoped commands above pass. Production readiness remains unestablished.

Explore the three review patterns