mixle.experimental.typed_runtime.context_materializer module

Provenance-preserving bounded materialization from an effective-context graph.

class ContextTokenizer(tokenizer_id, encode)

Bases: object

Named deterministic tokenizer used for hard rendered-prompt bounds.

Parameters:

• tokenizer_id (str)

• encode (Callable[[str], Sequence[int]])

token_ids(text)

Encode twice to reject stateful tokenizers and validate stable integer ids.

Parameters:

text (str)

Return type:

tuple[int, …]

class MaterializationPolicy(token_budget, attended_token_budget=None, maximum_nodes=128, minimum_relevance=0.0, require_supported_claims=True, exclude_contradicted=True)

Bases: object

Hard active-context bounds and evidence admission policy.

Parameters:

• token_budget (int)

• attended_token_budget (int | None)

• maximum_nodes (int)

• minimum_relevance (float)

• require_supported_claims (bool)

• exclude_contradicted (bool)

class MaterializedContext(text, node_ids, edge_ids, tokenizer_id, token_ids, token_count, attended_token_indices, attended_tokens, excluded, measurement)

Bases: object

Bounded prompt text, selected evidence subgraph, and honest context receipt.

Parameters:

• text (str)

• node_ids (tuple[str, ...])

• edge_ids (tuple[str, ...])

• tokenizer_id (str)

• token_ids (tuple[int, ...])

• token_count (int)

• attended_token_indices (tuple[int, ...])

• attended_tokens (int)

• excluded (dict[str, str])

• measurement (EffectiveContextMeasurement)

as_dict()

Return a JSON-compatible materialization receipt.

Return type:

dict[str, Any]

materialize_context(graph, relevance, policy, tokenizer, *, source_horizon_tokens=None, required_node_ids=(), context_actions=0, retrieval_actions=0, generation_actions=0, verification_actions=0, tool_calls=0, latency_seconds=0.0, monetary_cost=0.0, stopped_reason=None)

Greedily pack relevance-per-token evidence bundles under hard bounds.

Parameters:

• graph (ContextGraph)

• relevance (dict[str, float])

• policy (MaterializationPolicy)

• tokenizer (ContextTokenizer)

• source_horizon_tokens (int | None)

• required_node_ids (tuple[str, ...])

• context_actions (int)

• retrieval_actions (int)

• generation_actions (int)

• verification_actions (int)

• tool_calls (int)

• latency_seconds (float)

• monetary_cost (float)

• stopped_reason (str | None)

Return type:

MaterializedContext