vibespatial.runtime.execution_trace

Attributes

TRACE_WARNINGS_ENV_VAR

Exceptions

VibeTraceWarning	Base class for warnings generated by user code.
TransferViolationError	Raised by assert_no_transfers when a D->H transfer occurs mid-pipeline.

Classes

TraceTransfer
TraceStep
ExecutionTraceContext

Functions

get_active_trace(→ ExecutionTraceContext | None)
execution_trace(pipeline)
notify_dispatch(→ None)
notify_transfer(→ None)
assert_no_transfers(*[, allow_directions])	Context manager that asserts no D->H transfers occur mid-pipeline.

Module Contents

vibespatial.runtime.execution_trace.TRACE_WARNINGS_ENV_VAR = 'VIBESPATIAL_TRACE_WARNINGS'

exception vibespatial.runtime.execution_trace.VibeTraceWarning

Base class for warnings generated by user code.

class vibespatial.runtime.execution_trace.TraceTransfer

direction: str

trigger: str

reason: str

class vibespatial.runtime.execution_trace.TraceStep

surface: str

operation: str

selected: vibespatial.runtime._runtime.ExecutionMode

implementation: str

class vibespatial.runtime.execution_trace.ExecutionTraceContext

pipeline: str

steps: list[TraceStep] = []

transfers: list[TraceTransfer] = []

record_step(step: TraceStep) → None

record_transfer(transfer: TraceTransfer) → None

summary() → dict[str, Any]

vibespatial.runtime.execution_trace.get_active_trace() → ExecutionTraceContext | None

vibespatial.runtime.execution_trace.execution_trace(pipeline: str)

vibespatial.runtime.execution_trace.notify_dispatch(*, surface: str, operation: str, selected: vibespatial.runtime._runtime.ExecutionMode | str, implementation: str) → None

vibespatial.runtime.execution_trace.notify_transfer(*, direction: str, trigger: str, reason: str) → None

exception vibespatial.runtime.execution_trace.TransferViolationError(transfers: list[TraceTransfer])

Raised by assert_no_transfers when a D->H transfer occurs mid-pipeline.

transfers

vibespatial.runtime.execution_trace.assert_no_transfers(*, allow_directions: frozenset[str] | None = None)

Context manager that asserts no D->H transfers occur mid-pipeline.

Usage:

with assert_no_transfers():
    result = gdf.centroid.buffer(100).intersects(other)
# Raises TransferViolationError if any D->H transfer occurred

Parameters

allow_directionsfrozenset of str, optional

Directions to allow (e.g. frozenset({“h2d”}) to only block D->H). Default: block all transfers.