Observability API

Generated from the typed public surface.

tesserix_adk.observability.ATTRIBUTE_PREFIX

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

ATTRIBUTE_PREFIX: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.Arm

Stability: alpha

Which side of the experiment a run was on.

class Arm(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.AttributeSet

Stability: alpha

Everything one kit-emitted span says about the work it covers.

class AttributeSet(AdkModel) {metric_dimensions(self) -> 'dict[str, str]'; rendered(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.Attribution

Stability: alpha

The dimensions a bill is broken down by, all of them stated.

class Attribution(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.BUDGET_BREACHES

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

BUDGET_BREACHES: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.Basis

Stability: alpha

How a figure came to exist, which is the part a reader has to see.

class Basis(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.CACHED_TOKENS

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

CACHED_TOKENS: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.CACHE_HIT_RATIO

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

CACHE_HIT_RATIO: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.CALLS

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

CALLS: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.CARDINALITY

Stability: alpha

dict() -> new empty dictionary dict(mapping) -> new dictionary initialized from a mapping object's (key, value) pairs dict(iterable) -> new dictionary initialized as if via: d = {} for k, v in iterable: d[k] = v dict(**kwargs) -> new dictionary initialized with the name=value pairs in the keyword argument list. For example: dict(one=1, two=2)

CARDINALITY: dict

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.CONVENTION_VERSION

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

CONVENTION_VERSION: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.CORRELATION

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

CORRELATION: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.COST

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

COST: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.CacheHits

Stability: alpha

How much of a prompt the provider did not have to prefill.

class CacheHits(AdkModel)

Typed errors: ValueError

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.CacheStatus

Stability: alpha

Whether a cache answered, across provider prompt caching and the kit's own caches.

class CacheStatus(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.Cardinality

Stability: alpha

Whether an attribute is safe as a metric dimension.

class Cardinality(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.DENIED_KEYS

Stability: alpha

Build an immutable unordered collection of unique elements.

DENIED_KEYS: frozenset

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.DROPPED

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

DROPPED: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.Dimensions

Stability: alpha

Which values a deployment wants its metrics split by.

class Dimensions(AdkModel) {bucket(self, value: 'str', allowed: 'frozenset[str] | None') -> 'str'; of(self, record: 'SpendRecord') -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.ExportedEvent

Stability: alpha

A span event as an exporter receives it.

class ExportedEvent(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.ExportedSpan

Stability: alpha

A span that has been through redaction and may leave the process.

class ExportedSpan(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.FILE_VERSION

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

FILE_VERSION: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.Figure

Stability: alpha

A savings number and how it came to exist.

class Figure(AdkModel) {label(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.HEADER

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

HEADER: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.HoldoutPolicy

Stability: alpha

The slice of traffic that bypasses shaping so the rest can be checked against it.

class HoldoutPolicy(AdkModel) {arm(self, run_id: 'str') -> 'Arm'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.INPUT_TOKENS

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

INPUT_TOKENS: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.ITERATIONS

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

ITERATIONS: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.LATENCY

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

LATENCY: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.LATENCY_SECONDS

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

LATENCY_SECONDS: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.LatencyReport

Stability: alpha

What one run cost, in the terms a user experiences it.

class LatencyReport(AdkModel) {attributes(self) -> 'dict[str, str]'; emit(self, meter: 'Meter', **dimensions: 'str') -> 'None'; render(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.Link

Stability: alpha

A relationship to another span that is not this span's parent.

class Link(AdkModel) {rendered(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.LinkKind

Stability: alpha

Why two spans are related where parent-child would misstate the causality.

class LinkKind(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.MANDATORY

Stability: alpha

Build an immutable unordered collection of unique elements.

MANDATORY: frozenset

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.MASK

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

MASK: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.MAX_STATE_ENTRIES

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

MAX_STATE_ENTRIES: int

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.MAX_STATE_LENGTH

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

MAX_STATE_LENGTH: int

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.MAX_VALUE_LENGTH

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

MAX_VALUE_LENGTH: int

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.MINIMUM_ARM

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

MINIMUM_ARM: int

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.Measured

Stability: alpha

A number that was measured, or an explicit statement that it was not.

class Measured(AdkModel) {rendered(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.Meter

Stability: alpha · Kind: Protocol

Sideband emission of counters.

class Meter(Protocol) {count(self, name: 'str', value: 'float', **dimensions: 'str') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.MeterStats

Stability: alpha

What the meter did, for the counters that should sit near zero.

class MeterStats(object)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.ModelRate

Stability: alpha

What a model costs, per million tokens.

class ModelRate(AdkModel) {of(self, *, input_tokens: 'int', output_tokens: 'int', cached_tokens: 'int' = 0) -> 'Cost'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.NODE_SPAN

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

NODE_SPAN: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.Node

Stability: alpha

One participant in the run, and what it reported.

class Node(AdkModel) {in_currency(self, currency: 'str') -> 'Cost | None'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.ORPHAN

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

ORPHAN: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.Outcome

Stability: alpha

Whether the step that spent it produced anything.

class Outcome(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.PAYLOAD_ATTRIBUTES

Stability: alpha

Build an immutable unordered collection of unique elements.

PAYLOAD_ATTRIBUTES: frozenset

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.Pattern

Stability: alpha

Why this participant was called, which is what a trace cannot be read without.

class Pattern(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.PendingSpan

Stability: alpha

A span about to be exported, with whatever a caller attached to it.

class PendingSpan(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.PricingTable

Stability: alpha

Model prices as of a stated version.

class PricingTable(AdkModel) {rate_of(self, model: 'str') -> 'ModelRate | None'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.REDACTED_EVENT

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

REDACTED_EVENT: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.REFERENCE_SUFFIX

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

REFERENCE_SUFFIX: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.RESERVED_PREFIX

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

RESERVED_PREFIX: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.Rate

Stability: alpha

A conversion somebody recorded, so a converted figure can be argued with.

class Rate(AdkModel) {applied(self, cost: 'Cost') -> 'Cost | None'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.RecordedSpan

Stability: alpha

One step of a run as it was exported.

class RecordedSpan(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.RedactingSpanProcessor

Stability: alpha

Rewrites a span so nothing sensitive can leave the process.

class RedactingSpanProcessor(object) {process(self, span: 'PendingSpan') -> 'ExportedSpan'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.Redaction

Stability: alpha

What was removed on the way out.

class Redaction(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.RedactionPolicy

Stability: alpha

What a deployment is willing to export.

class RedactionPolicy(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.RedactionStats

Stability: alpha

What the processor did, for the counter that should sit at zero in steady state.

class RedactionStats(object)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.Redactor

Stability: alpha

Masks attribute values that match a sensitive shape.

class Redactor(object) {scrub(self, attributes: 'Mapping[str, str]') -> 'tuple[dict[str, str], Redaction]'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.RunTimer

Stability: alpha

Times one run and reports it, on a clock a test can move.

class RunTimer(object) {finished(self, *, output_tokens: 'int', hits: 'CacheHits | None' = None) -> 'LatencyReport'; first_token(self) -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.RunTree

Stability: alpha

Every participant of one run, parents before children.

class RunTree(AdkModel) {by_step(self) -> 'dict[Step, Totals]'; children(self, run_id: 'str') -> 'tuple[Node, ...]'; node(self, run_id: 'str') -> 'Node | None'; records(self) -> 'tuple[SpendRecord, ...]'; totals_by(self, *by: 'str') -> 'dict[tuple[str, ...], Totals]'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.SPAN_NAMES

Stability: alpha

dict() -> new empty dictionary dict(mapping) -> new dictionary initialized from a mapping object's (key, value) pairs dict(iterable) -> new dictionary initialized as if via: d = {} for k, v in iterable: d[k] = v dict(**kwargs) -> new dictionary initialized with the name=value pairs in the keyword argument list. For example: dict(one=1, two=2)

SPAN_NAMES: dict

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.STOPPED

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

STOPPED: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.SavingsReport

Stability: alpha

What shaping saved over a window, with each figure labelled at the point of display.

class SavingsReport(AdkModel) {as_dict(self) -> 'dict[str, object]'; summary(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.ShapedRun

Stability: alpha

One run's token accounting, and which arm it was in.

class ShapedRun(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.SpanEvent

Stability: alpha

An event recorded on a span before redaction.

class SpanEvent(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.SpendMeter

Stability: alpha

Emits the spend and performance series for the records a run produced.

class SpendMeter(object) {record(self, record: 'SpendRecord', *, seconds: 'float | None' = None, iterations: 'int' = 0, tool_calls: 'int' = 0, breached: 'bool' = False, key: 'str | None' = None) -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.SpendRecord

Stability: alpha

One metered step, and who it belongs to.

class SpendRecord(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.Step

Stability: alpha

Which kind of step spent it.

class Step(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.TIME_TO_FIRST_TOKEN

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

TIME_TO_FIRST_TOKEN: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.TOKENS

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

TOKENS: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.TOKENS_PER_SECOND

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

TOKENS_PER_SECOND: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.TOOL_CALLS

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

TOOL_CALLS: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.TRACEPARENT

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

TRACEPARENT: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.TRACESTATE

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

TRACESTATE: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.Totals

Stability: alpha

What one group of records came to.

class Totals(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.TraceContext

Stability: alpha

Where one participant sits in a multi-agent run.

class TraceContext(AdkModel) {carried(self) -> 'dict[str, str]'; child(self, *, run_id: 'str', agent: 'str', pattern: 'Pattern' = <Pattern.DELEGATION: 'delegation'>, branch: 'str | None' = None, tenant: 'str | None' = None) -> 'Self'; header(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.TraceFile

Stability: alpha

A trace saved to disk, redacted so it can be attached to a bug report.

class TraceFile(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.TraceNode

Stability: alpha

A step and what it called.

class TraceNode(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.TreeTotals

Stability: alpha

What a whole multi-agent run came to, and what is missing from the figure.

class TreeTotals(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.UNKNOWN

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

UNKNOWN: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.UNKNOWN_USAGE

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

UNKNOWN_USAGE: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.UNPRICED

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

UNPRICED: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.Unavailability

Stability: alpha

Why a number is absent. Absent with a reason is a fact; absent is a hole.

class Unavailability(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.VENDOR

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

VENDOR: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.VERSION

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

VERSION: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.W3CContext

Stability: alpha

Where this process sits in a trace, in the format every backend already speaks.

class W3CContext(AdkModel) {carried(self) -> 'dict[str, str]'; child(self, name: 'str', *, attempt: 'int' = 1) -> 'Self'; link(self, kind: 'LinkKind', **attributes: 'str') -> 'Link'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.account

Stability: alpha

Total what shaping saved, measuring the input and comparing the arms for the output.

def account(runs: 'Iterable[ShapedRun]', *, policy: 'HoldoutPolicy', minimum: 'int' = 30) -> 'SavingsReport'

Typed errors: ConfigurationError

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.assembled

Stability: alpha

Build the forest a run's spans describe.

def assembled(spans: 'Sequence[RecordedSpan]') -> 'tuple[TraceNode, ...]'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.attributes_of

Stability: alpha

The standard attribute set for one record, ready to hang on a span.

def attributes_of(record: 'SpendRecord') -> 'dict[str, str]'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.attributes_of_context

Stability: alpha

The multi-agent attributes for one participant, ready to hang on a span.

def attributes_of_context(context: 'TraceContext') -> 'dict[str, str]'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.attribution.ATTRIBUTE_PREFIX

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

ATTRIBUTE_PREFIX: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.attribution.Attribution

Stability: alpha

The dimensions a bill is broken down by, all of them stated.

class Attribution(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.attribution.Outcome

Stability: alpha

Whether the step that spent it produced anything.

class Outcome(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.attribution.SpendRecord

Stability: alpha

One metered step, and who it belongs to.

class SpendRecord(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.attribution.Step

Stability: alpha

Which kind of step spent it.

class Step(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.attribution.Totals

Stability: alpha

What one group of records came to.

class Totals(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.attribution.UNKNOWN

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

UNKNOWN: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.attribution.attributes_of

Stability: alpha

The standard attribute set for one record, ready to hang on a span.

def attributes_of(record: 'SpendRecord') -> 'dict[str, str]'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.attribution.spend_of

Stability: alpha

Every metered step of run, in order, attributed.

def spend_of(run: 'Run[OutputT]') -> 'tuple[SpendRecord, ...]'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.attribution.totals_by

Stability: alpha

Group records by attribution dimensions and total each group.

def totals_by(records: 'Iterable[SpendRecord]', *by: 'str') -> 'dict[tuple[str, ...], Totals]'

Typed errors: ValueError

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.attribution.totals_of

Stability: alpha

Total one group of records, keeping every component and the weakest confidence.

def totals_of(group: 'Sequence[SpendRecord]') -> 'Totals'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.by_tenant

Stability: alpha

The same accounting, per tenant, with no figure drawing on another tenant's traffic.

def by_tenant(runs: 'Iterable[ShapedRun]', *, policy: 'HoldoutPolicy', minimum: 'int' = 30) -> 'dict[str, SavingsReport]'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.conforms

Stability: alpha

Check attributes against the convention.

def conforms(attributes: 'Mapping[str, str]') -> 'None'

Typed errors: AttributionError

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.convention.AttributeSet

Stability: alpha

Everything one kit-emitted span says about the work it covers.

class AttributeSet(AdkModel) {metric_dimensions(self) -> 'dict[str, str]'; rendered(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.convention.CARDINALITY

Stability: alpha

dict() -> new empty dictionary dict(mapping) -> new dictionary initialized from a mapping object's (key, value) pairs dict(iterable) -> new dictionary initialized as if via: d = {} for k, v in iterable: d[k] = v dict(**kwargs) -> new dictionary initialized with the name=value pairs in the keyword argument list. For example: dict(one=1, two=2)

CARDINALITY: dict

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.convention.CONVENTION_VERSION

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

CONVENTION_VERSION: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.convention.CacheStatus

Stability: alpha

Whether a cache answered, across provider prompt caching and the kit's own caches.

class CacheStatus(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.convention.Cardinality

Stability: alpha

Whether an attribute is safe as a metric dimension.

class Cardinality(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.convention.MANDATORY

Stability: alpha

Build an immutable unordered collection of unique elements.

MANDATORY: frozenset

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.convention.MAX_VALUE_LENGTH

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

MAX_VALUE_LENGTH: int

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.convention.Measured

Stability: alpha

A number that was measured, or an explicit statement that it was not.

class Measured(AdkModel) {rendered(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.convention.RESERVED_PREFIX

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

RESERVED_PREFIX: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.convention.Unavailability

Stability: alpha

Why a number is absent. Absent with a reason is a fact; absent is a hole.

class Unavailability(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.convention.conforms

Stability: alpha

Check attributes against the convention.

def conforms(attributes: 'Mapping[str, str]') -> 'None'

Typed errors: AttributionError

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.emit.NODE_SPAN

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

NODE_SPAN: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.emit.REDACTED_EVENT

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

REDACTED_EVENT: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.emit.SPAN_NAMES

Stability: alpha

dict() -> new empty dictionary dict(mapping) -> new dictionary initialized from a mapping object's (key, value) pairs dict(iterable) -> new dictionary initialized as if via: d = {} for k, v in iterable: d[k] = v dict(**kwargs) -> new dictionary initialized with the name=value pairs in the keyword argument list. For example: dict(one=1, two=2)

SPAN_NAMES: dict

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.emit.record_spend

Stability: alpha

Export what run spent, and return the records that were exported.

def record_spend(run: 'Run[OutputT]', *, tracer: 'Tracer | None' = None, meter: 'Meter | None' = None, dimensions: 'Dimensions | None' = None, redactor: 'Redactor | None' = None, extra: 'Mapping[str, str] | None' = None, sampled: 'bool' = True) -> 'tuple[SpendRecord, ...]'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.emit.record_tree

Stability: alpha

Export a whole multi-agent run: one span per participant, counters per participant.

def record_tree(assembled: 'RunTree', *, tracer: 'Tracer | None' = None, meter: 'Meter | None' = None, dimensions: 'Dimensions | None' = None, redactor: 'Redactor | None' = None, extra: 'Mapping[str, str] | None' = None, sampled: 'bool' = True) -> 'tuple[Node, ...]'

Typed errors: AttributionError

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.export.DENIED_KEYS

Stability: alpha

Build an immutable unordered collection of unique elements.

DENIED_KEYS: frozenset

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.export.ExportedEvent

Stability: alpha

A span event as an exporter receives it.

class ExportedEvent(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.export.ExportedSpan

Stability: alpha

A span that has been through redaction and may leave the process.

class ExportedSpan(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.export.PAYLOAD_ATTRIBUTES

Stability: alpha

Build an immutable unordered collection of unique elements.

PAYLOAD_ATTRIBUTES: frozenset

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.export.PendingSpan

Stability: alpha

A span about to be exported, with whatever a caller attached to it.

class PendingSpan(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.export.REFERENCE_SUFFIX

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

REFERENCE_SUFFIX: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.export.RedactingSpanProcessor

Stability: alpha

Rewrites a span so nothing sensitive can leave the process.

class RedactingSpanProcessor(object) {process(self, span: 'PendingSpan') -> 'ExportedSpan'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.export.RedactionPolicy

Stability: alpha

What a deployment is willing to export.

class RedactionPolicy(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.export.RedactionStats

Stability: alpha

What the processor did, for the counter that should sit at zero in steady state.

class RedactionStats(object)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.export.SpanEvent

Stability: alpha

An event recorded on a span before redaction.

class SpanEvent(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.joined

Stability: alpha

Attach to the trace a hop carried, or start one and say the chain broke.

def joined(headers: 'Mapping[str, str]', *, run_id: 'str', sampled: 'bool' = True) -> 'tuple[W3CContext, Link | None]'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.latency.CACHE_HIT_RATIO

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

CACHE_HIT_RATIO: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.latency.CacheHits

Stability: alpha

How much of a prompt the provider did not have to prefill.

class CacheHits(AdkModel)

Typed errors: ValueError

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.latency.LATENCY_SECONDS

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

LATENCY_SECONDS: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.latency.LatencyReport

Stability: alpha

What one run cost, in the terms a user experiences it.

class LatencyReport(AdkModel) {attributes(self) -> 'dict[str, str]'; emit(self, meter: 'Meter', **dimensions: 'str') -> 'None'; render(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.latency.RunTimer

Stability: alpha

Times one run and reports it, on a clock a test can move.

class RunTimer(object) {finished(self, *, output_tokens: 'int', hits: 'CacheHits | None' = None) -> 'LatencyReport'; first_token(self) -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.latency.TIME_TO_FIRST_TOKEN

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

TIME_TO_FIRST_TOKEN: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.latency.TOKENS_PER_SECOND

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

TOKENS_PER_SECOND: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.local_view.FILE_VERSION

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

FILE_VERSION: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.local_view.ORPHAN

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

ORPHAN: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.local_view.RecordedSpan

Stability: alpha

One step of a run as it was exported.

class RecordedSpan(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.local_view.STOPPED

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

STOPPED: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.local_view.TraceFile

Stability: alpha

A trace saved to disk, redacted so it can be attached to a bug report.

class TraceFile(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.local_view.TraceNode

Stability: alpha

A step and what it called.

class TraceNode(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.local_view.assembled

Stability: alpha

Build the forest a run's spans describe.

def assembled(spans: 'Sequence[RecordedSpan]') -> 'tuple[TraceNode, ...]'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.local_view.machine_readable

Stability: alpha

The same tree as JSON, for a test assertion rather than an eye.

def machine_readable(nodes: 'Sequence[TraceNode]') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.local_view.rendered

Stability: alpha

Draw a trace for a person to read.

def rendered(nodes: 'Sequence[TraceNode]', *, depth: 'int | None' = None, only: 'Sequence[str]' = ()) -> 'str'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.machine_readable

Stability: alpha

The same tree as JSON, for a test assertion rather than an eye.

def machine_readable(nodes: 'Sequence[TraceNode]') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.metrics.CACHED_TOKENS

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

CACHED_TOKENS: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.metrics.CALLS

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

CALLS: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.metrics.COST

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

COST: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.metrics.Dimensions

Stability: alpha

Which values a deployment wants its metrics split by.

class Dimensions(AdkModel) {bucket(self, value: 'str', allowed: 'frozenset[str] | None') -> 'str'; of(self, record: 'SpendRecord') -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.metrics.INPUT_TOKENS

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

INPUT_TOKENS: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.metrics.Meter

Stability: alpha · Kind: Protocol

Sideband emission of counters.

class Meter(Protocol) {count(self, name: 'str', value: 'float', **dimensions: 'str') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.metrics.TOKENS

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

TOKENS: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.node_of

Stability: alpha

A participant that ran here, read off its run.

def node_of(run: 'Run[OutputT]', context: 'TraceContext') -> 'Node'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.peer_node

Stability: alpha

A participant that ran somewhere else, from what it reported back.

def peer_node(context: 'TraceContext', *, usage: 'Usage | None' = None, cost: 'Cost | None' = None, rate: 'Rate | None' = None, started_at: 'float | None' = None, ended_at: 'float | None' = None) -> 'Node'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.propagation.CORRELATION

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

CORRELATION: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.propagation.Link

Stability: alpha

A relationship to another span that is not this span's parent.

class Link(AdkModel) {rendered(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.propagation.LinkKind

Stability: alpha

Why two spans are related where parent-child would misstate the causality.

class LinkKind(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.propagation.MAX_STATE_ENTRIES

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

MAX_STATE_ENTRIES: int

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.propagation.MAX_STATE_LENGTH

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

MAX_STATE_LENGTH: int

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.propagation.TRACEPARENT

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

TRACEPARENT: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.propagation.TRACESTATE

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

TRACESTATE: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.propagation.VENDOR

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

VENDOR: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.propagation.W3CContext

Stability: alpha

Where this process sits in a trace, in the format every backend already speaks.

class W3CContext(AdkModel) {carried(self) -> 'dict[str, str]'; child(self, name: 'str', *, attempt: 'int' = 1) -> 'Self'; link(self, kind: 'LinkKind', **attributes: 'str') -> 'Link'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.propagation.joined

Stability: alpha

Attach to the trace a hop carried, or start one and say the chain broke.

def joined(headers: 'Mapping[str, str]', *, run_id: 'str', sampled: 'bool' = True) -> 'tuple[W3CContext, Link | None]'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.propagation.span_id_of

Stability: alpha

The span id for one operation in a run, the same on every replay of it.

def span_id_of(run_id: 'str', name: 'str' = '', attempt: 'int' = 1) -> 'str'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.propagation.trace_id_of

Stability: alpha

The trace id for a run, the same on every replay of it.

def trace_id_of(run_id: 'str') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.record_spend

Stability: alpha

Export what run spent, and return the records that were exported.

def record_spend(run: 'Run[OutputT]', *, tracer: 'Tracer | None' = None, meter: 'Meter | None' = None, dimensions: 'Dimensions | None' = None, redactor: 'Redactor | None' = None, extra: 'Mapping[str, str] | None' = None, sampled: 'bool' = True) -> 'tuple[SpendRecord, ...]'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.record_tree

Stability: alpha

Export a whole multi-agent run: one span per participant, counters per participant.

def record_tree(assembled: 'RunTree', *, tracer: 'Tracer | None' = None, meter: 'Meter | None' = None, dimensions: 'Dimensions | None' = None, redactor: 'Redactor | None' = None, extra: 'Mapping[str, str] | None' = None, sampled: 'bool' = True) -> 'tuple[Node, ...]'

Typed errors: AttributionError

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.redaction.MASK

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

MASK: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.redaction.Redaction

Stability: alpha

What was removed on the way out.

class Redaction(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.redaction.Redactor

Stability: alpha

Masks attribute values that match a sensitive shape.

class Redactor(object) {scrub(self, attributes: 'Mapping[str, str]') -> 'tuple[dict[str, str], Redaction]'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.render

Stability: alpha

The tree as text, one line per participant, with cost, tokens and latency.

def render(assembled: 'RunTree') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.rendered

Stability: alpha

Draw a trace for a person to read.

def rendered(nodes: 'Sequence[TraceNode]', *, depth: 'int | None' = None, only: 'Sequence[str]' = ()) -> 'str'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.savings.Arm

Stability: alpha

Which side of the experiment a run was on.

class Arm(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.savings.Basis

Stability: alpha

How a figure came to exist, which is the part a reader has to see.

class Basis(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.savings.Figure

Stability: alpha

A savings number and how it came to exist.

class Figure(AdkModel) {label(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.savings.HoldoutPolicy

Stability: alpha

The slice of traffic that bypasses shaping so the rest can be checked against it.

class HoldoutPolicy(AdkModel) {arm(self, run_id: 'str') -> 'Arm'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.savings.MINIMUM_ARM

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

MINIMUM_ARM: int

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.savings.SavingsReport

Stability: alpha

What shaping saved over a window, with each figure labelled at the point of display.

class SavingsReport(AdkModel) {as_dict(self) -> 'dict[str, object]'; summary(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.savings.ShapedRun

Stability: alpha

One run's token accounting, and which arm it was in.

class ShapedRun(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.savings.account

Stability: alpha

Total what shaping saved, measuring the input and comparing the arms for the output.

def account(runs: 'Iterable[ShapedRun]', *, policy: 'HoldoutPolicy', minimum: 'int' = 30) -> 'SavingsReport'

Typed errors: ConfigurationError

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.savings.by_tenant

Stability: alpha

The same accounting, per tenant, with no figure drawing on another tenant's traffic.

def by_tenant(runs: 'Iterable[ShapedRun]', *, policy: 'HoldoutPolicy', minimum: 'int' = 30) -> 'dict[str, SavingsReport]'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.span_id_of

Stability: alpha

The span id for one operation in a run, the same on every replay of it.

def span_id_of(run_id: 'str', name: 'str' = '', attempt: 'int' = 1) -> 'str'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.spend_metrics.BUDGET_BREACHES

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

BUDGET_BREACHES: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.spend_metrics.DROPPED

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

DROPPED: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.spend_metrics.ITERATIONS

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

ITERATIONS: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.spend_metrics.LATENCY

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

LATENCY: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.spend_metrics.MeterStats

Stability: alpha

What the meter did, for the counters that should sit near zero.

class MeterStats(object)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.spend_metrics.ModelRate

Stability: alpha

What a model costs, per million tokens.

class ModelRate(AdkModel) {of(self, *, input_tokens: 'int', output_tokens: 'int', cached_tokens: 'int' = 0) -> 'Cost'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.spend_metrics.PricingTable

Stability: alpha

Model prices as of a stated version.

class PricingTable(AdkModel) {rate_of(self, model: 'str') -> 'ModelRate | None'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.spend_metrics.SpendMeter

Stability: alpha

Emits the spend and performance series for the records a run produced.

class SpendMeter(object) {record(self, record: 'SpendRecord', *, seconds: 'float | None' = None, iterations: 'int' = 0, tool_calls: 'int' = 0, breached: 'bool' = False, key: 'str | None' = None) -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.spend_metrics.TOOL_CALLS

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

TOOL_CALLS: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.spend_metrics.UNKNOWN_USAGE

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

UNKNOWN_USAGE: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.spend_metrics.UNPRICED

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

UNPRICED: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.spend_of

Stability: alpha

Every metered step of run, in order, attributed.

def spend_of(run: 'Run[OutputT]') -> 'tuple[SpendRecord, ...]'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.totals_by

Stability: alpha

Group records by attribution dimensions and total each group.

def totals_by(records: 'Iterable[SpendRecord]', *by: 'str') -> 'dict[tuple[str, ...], Totals]'

Typed errors: ValueError

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.totals_of

Stability: alpha

Total one group of records, keeping every component and the weakest confidence.

def totals_of(group: 'Sequence[SpendRecord]') -> 'Totals'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.trace.HEADER

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

HEADER: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.trace.Pattern

Stability: alpha

Why this participant was called, which is what a trace cannot be read without.

class Pattern(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.trace.TraceContext

Stability: alpha

Where one participant sits in a multi-agent run.

class TraceContext(AdkModel) {carried(self) -> 'dict[str, str]'; child(self, *, run_id: 'str', agent: 'str', pattern: 'Pattern' = <Pattern.DELEGATION: 'delegation'>, branch: 'str | None' = None, tenant: 'str | None' = None) -> 'Self'; header(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.trace.VERSION

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

VERSION: str

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.trace.attributes_of_context

Stability: alpha

The multi-agent attributes for one participant, ready to hang on a span.

def attributes_of_context(context: 'TraceContext') -> 'dict[str, str]'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.trace_id_of

Stability: alpha

The trace id for a run, the same on every replay of it.

def trace_id_of(run_id: 'str') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.tree

Stability: alpha

Assemble nodes into one tree. See RunTree.of.

def tree(nodes: 'Sequence[Node]') -> 'RunTree'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.tree.Node

Stability: alpha

One participant in the run, and what it reported.

class Node(AdkModel) {in_currency(self, currency: 'str') -> 'Cost | None'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.tree.Rate

Stability: alpha

A conversion somebody recorded, so a converted figure can be argued with.

class Rate(AdkModel) {applied(self, cost: 'Cost') -> 'Cost | None'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.tree.RunTree

Stability: alpha

Every participant of one run, parents before children.

class RunTree(AdkModel) {by_step(self) -> 'dict[Step, Totals]'; children(self, run_id: 'str') -> 'tuple[Node, ...]'; node(self, run_id: 'str') -> 'Node | None'; records(self) -> 'tuple[SpendRecord, ...]'; totals_by(self, *by: 'str') -> 'dict[tuple[str, ...], Totals]'}

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.tree.TreeTotals

Stability: alpha

What a whole multi-agent run came to, and what is missing from the figure.

class TreeTotals(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.tree.node_of

Stability: alpha

A participant that ran here, read off its run.

def node_of(run: 'Run[OutputT]', context: 'TraceContext') -> 'Node'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.tree.peer_node

Stability: alpha

A participant that ran somewhere else, from what it reported back.

def peer_node(context: 'TraceContext', *, usage: 'Usage | None' = None, cost: 'Cost | None' = None, rate: 'Rate | None' = None, started_at: 'float | None' = None, ended_at: 'float | None' = None) -> 'Node'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.tree.render

Stability: alpha

The tree as text, one line per participant, with cost, tokens and latency.

def render(assembled: 'RunTree') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.

tesserix_adk.observability.tree.tree

Stability: alpha

Assemble nodes into one tree. See RunTree.of.

def tree(nodes: 'Sequence[Node]') -> 'RunTree'

Typed errors: None declared.

Runnable recipe: examples/auto_instrumentation.py — telemetry is attributed and redacted.