orchestrata_contracts.util

Reference › components › contracts › orchestrata_contracts › util

orchestrata_contracts.util package.

The util subpackage of contracts holds general-purpose helpers that several components need and that would otherwise create import edges between them. Most of its larger modules are whole-module lifts of frozen single-package code (D-C3, and function-only lifts under D-C6): logging, monitoring_engine, monitoring_spans, observer, tracing_context, cassette (from the LLM layer), plan_parser (from planning), banned_libraries, gate_waivers, paths and usage_log. The remaining modules include iteration_tracer, tracer, trace_config, error_handler, error_detail, lru_cache, word_token_counter and source_walk, which decides which .py files count as source rather than output.

20 modules, 2,734 lines of code.

Modules

Module Summary LOC
__init__ orchestrata_contracts.util package. 2
banned_libraries orchestrata_contracts.util.banned_libraries — whole-module lift of frozen core.banned_libraries (function-only… 95
cassette orchestrata_contracts.util.cassette — whole-module lift of frozen llm._cassette (D-C3). 299
error_detail 34
error_handler 147
gate_waivers orchestrata_contracts.util.gate_waivers — whole-module lift of frozen core.gate_waivers (function-only, D-C3/D-C6). 51
iteration_tracer 312
logging orchestrata_contracts.util.logging — whole-module lift of frozen core.logging (D-C3). 180
lru_cache 120
monitoring_engine orchestrata_contracts.util.monitoring_engine — whole-module lift of frozen core.monitoring.engine (D-C3). 412
monitoring_spans orchestrata_contracts.util.monitoring_spans — whole-module lift of frozen core.monitoring.spans (D-C3). 93
observer orchestrata_contracts.util.observer — whole-module lift of frozen core.patterns.observer (D-C3). 220
paths orchestrata_contracts.util.paths — whole-module lift of frozen core.paths (function-only, D-C3/D-C6). 47
plan_parser orchestrata_contracts.util.plan_parser — whole-module lift of frozen planning.plan_parser (D-C3). 366
source_walk Source-tree walk — which .py files are OUR SOURCE rather than output. 75
trace_config 61
tracer 89
tracing_context orchestrata_contracts.util.tracing_context — whole-module lift of frozen core.tracing.context (function-only… 94
usage_log orchestrata_contracts.util.usage_log — whole-module lift of frozen context.usage_log (function-only, D-C3/D-C6). 4
word_token_counter 33

Dependency diagram

Package dependency diagram orchestrata_contracts.util