Models API¶
Generated from the typed public surface.
tesserix_adk.models.BatchConfig¶
Stability: alpha
How long to wait for a batch to fill, and how big to let it get.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.BatchingEmbedder¶
Stability: alpha
Coalesces concurrent single-text requests into provider batches.
class BatchingEmbedder(object) {aclose(self) -> 'None'; embed(self, text: 'str', *, model: 'str', tenant: 'str' = 'default', interactive: 'bool' = False) -> 'Vector'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.CATALOGUE_VERSION¶
Stability: alpha
str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.CacheEntry¶
Stability: alpha
One stored answer and everything needed to decide whether to serve it.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.CacheKey¶
Stability: alpha
Every determinant of an answer, so that changing one cannot serve the old answer.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.CacheMetrics¶
Stability: alpha
Counters an operator reads to decide whether the cache earns its risk.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.CacheOutcome¶
Stability: alpha
What the cache did for one call, handed to an observer for the run's trace.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.CachePolicy¶
Stability: alpha
The written-down rules about what may be cached, and for how long.
Typed errors: ValueError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.CacheStatus¶
Stability: alpha
What the cache did for one call, as the word an operator reads in a trace.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.CacheStore¶
Stability: alpha · Kind: Protocol
Where entries live. Narrow, so no store is hardwired into the kit.
class CacheStore(Protocol) {get(self, digest: 'str') -> 'CacheEntry | None'; purge(self, **by: 'str | None') -> 'int'; put(self, entry: 'CacheEntry') -> 'None'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.Cacheability¶
Stability: alpha
Whether a call may be cached, and the rule that decided it.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.CachingProvider¶
Stability: alpha
A ModelProvider that answers from a previous call where the rules allow it.
class CachingProvider(object) {complete(self, request: 'ModelRequest') -> 'ModelResponse'; count_tokens(self, messages: 'Sequence[Message]') -> 'int'; forget(self, **by: 'str | None') -> 'int'; stream(self, request: 'ModelRequest') -> 'AsyncIterator[StreamEvent]'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.Capability¶
Stability: alpha
A thing a model either does or does not do, named the same way everywhere.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.CapabilityError¶
Stability: alpha
Raised when something is asked of a provider that it has not declared it can do.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.ClientKey¶
Stability: alpha
What makes two requests eligible to share a connection.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.ClientPool¶
Stability: alpha
The registry that owns provider clients and their lifetime.
class ClientPool(object) {aclose(self) -> 'None'; config_for(self, provider: 'str') -> 'PoolConfig'; retire(self, *, provider: 'str', base_url: 'str', credential: 'str' = '', timeout_seconds: 'float | None' = None, connect_seconds: 'float | None' = None) -> 'None'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.ContextWindowExceededError¶
Stability: alpha
Raised when an assembled prompt is longer than the model declares it can read.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.Credential¶
Stability: alpha
One provider key, resolved on each use.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.Device¶
Stability: alpha
Where a session runs. The only thing a GPU changes about this backend.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.Effort¶
Stability: alpha
How much deliberation a call is worth, expressed once and mapped per provider.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.EmbeddingLimits¶
Stability: alpha
What one provider says it will accept in a single embedding call.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.EmbeddingMetrics¶
Stability: alpha
A snapshot of what the embedder did, for an operator tuning the window.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.EmbeddingProvider¶
Stability: alpha · Kind: Protocol
A provider that turns texts into vectors, one call at a time.
class EmbeddingProvider(Protocol) {embed(self, texts: 'Sequence[str]', *, model: 'str') -> 'Sequence[Vector]'; limits(self, model: 'str') -> 'EmbeddingLimits'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.Encoded¶
Stability: alpha
A batch of texts as the model takes them.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.EnvironmentSecrets¶
Stability: alpha
The default secret provider: the process environment, read on every request.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.MemoryCacheStore¶
Stability: alpha
An in-process store, for a single replica and for tests.
class MemoryCacheStore(object) {every(self) -> 'list[CacheEntry]'; get(self, digest: 'str') -> 'CacheEntry | None'; purge(self, **by: 'str | None') -> 'int'; put(self, entry: 'CacheEntry') -> 'None'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.MemorySemanticIndex¶
Stability: alpha
An in-process vector index, exact over few entries and honest about being so.
class MemorySemanticIndex(object) {add(self, digest: 'str', vector: 'Vector', *, tenant: 'str', embedding_model: 'str') -> 'None'; nearest(self, vector: 'Vector', *, tenant: 'str', embedding_model: 'str') -> 'tuple[str, float] | None'; purge(self, **by: 'str | None') -> 'int'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.ModelCapabilities¶
Stability: alpha
What a provider says its model supports.
class ModelCapabilities(AdkModel) {declaring(self, **overrides: 'object') -> 'Self'; require(self, requirement: 'Capability', *, provider: 'str', model: 'str') -> 'None'; supports(self, requirement: 'Capability') -> 'bool'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.ModelCard¶
Stability: alpha
One model, as the snapshot recorded it.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.ModelProvider¶
Stability: alpha · Kind: Protocol
A source of model completions.
class ModelProvider(Protocol) {complete(self, request: 'ModelRequest') -> 'ModelResponse'; count_tokens(self, messages: 'Sequence[Message]') -> 'int'; stream(self, request: 'ModelRequest') -> 'AsyncIterator[StreamEvent]'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.ModelRef¶
Stability: alpha
A model, addressable by name from configuration.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.ModelRequest¶
Stability: alpha
One call to a provider, as data.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.ModelResponse¶
Stability: alpha
What a provider returned for one call.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.ModelResponseError¶
Stability: alpha
Raised when a provider answered with something the kit cannot read as a response.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.ModelSpec¶
Stability: alpha
A named model together with what it can do and where it may be used.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.ONNX_MODELS¶
Stability: alpha
Built-in immutable sequence.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.OnnxCrossEncoder¶
Stability: alpha
A CrossEncoder over a local ONNX session: query and passage in, one score out.
class OnnxCrossEncoder(object) {score(self, pairs: 'Sequence[tuple[str, str]]') -> 'Sequence[float]'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.OnnxEmbeddings¶
Stability: alpha
An EmbeddingProvider over a local ONNX session, batched and cached.
class OnnxEmbeddings(object) {embed(self, texts: 'Sequence[str]', *, model: 'str') -> 'Sequence[Vector]'; limits(self, model: 'str') -> 'EmbeddingLimits'}
Typed errors: ValueError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.OnnxMetrics¶
Stability: alpha
What the last call did, for an operator holding the backend to its budget.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.OnnxModel¶
Stability: alpha
One model in the shipped set, and everything needed to check it before loading.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.OnnxSession¶
Stability: alpha · Kind: Protocol
A loaded model, run synchronously. The one thing onnxruntime is needed for.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.PoolConfig¶
Stability: alpha
How many connections a provider is allowed, and how long an idle one is kept.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.PoolMetrics¶
Stability: alpha
A snapshot of what the registry has done, taken rather than watched.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.Pricing¶
Stability: alpha
What a vendor charges, in US dollars per million tokens.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.ReasoningDelta¶
Stability: alpha
More of the model's own working out.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.SecretProvider¶
Stability: alpha · Kind: Protocol
Where a credential is looked up, asked once per use rather than once per process.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.SemanticConfig¶
Stability: alpha
The optional near-match tier, which is off unless one of these is passed.
Typed errors: ValueError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.SemanticIndex¶
Stability: alpha · Kind: Protocol
Where the vectors behind an optional near-match tier live.
class SemanticIndex(Protocol) {add(self, digest: 'str', vector: 'Vector', *, tenant: 'str', embedding_model: 'str') -> 'None'; nearest(self, vector: 'Vector', *, tenant: 'str', embedding_model: 'str') -> 'tuple[str, float] | None'; purge(self, **by: 'str | None') -> 'int'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.Shaped¶
Stability: alpha
What shaping decided for one call, for the model call record.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.Shaping¶
Stability: alpha
A clamp-only output shaping policy, off until an agent turns it on.
class Shaping(AdkModel) {shape(self, request: 'ModelRequest', *, effort: 'Effort | None' = None, final: 'bool' = False) -> 'Shaped'; steer(self, request: 'ModelRequest') -> 'ModelRequest'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.StopReason¶
Stability: alpha
Why a model stopped generating, in the kit's words rather than a vendor's.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.StreamAccumulator¶
Stability: alpha
Assembles a ModelResponse from the events of one stream.
class StreamAccumulator(object) {feed(self, event: 'StreamEvent') -> 'None'; finish(self, stop_reason: 'StopReason') -> 'ModelResponse'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.StreamEnd¶
Stability: alpha
The last event, carrying the assembled answer.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.StreamEvent¶
Stability: alpha
Base for every event a provider may emit while an answer is being generated.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.StreamInterruptedError¶
Stability: alpha
Raised when a stream stopped before the model had finished answering.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.TOOL_ERROR¶
Stability: alpha
str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.TextDelta¶
Stability: alpha
More of the answer. Concatenating every delta in arrival order gives the content.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.Throughput¶
Stability: alpha
What a model costs, at the batch and thread count it was measured with.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.Tokenizing¶
Stability: alpha · Kind: Protocol
Turns text into the ids a session runs on.
class Tokenizing(Protocol) {encode(self, texts: 'Sequence[str]', *, max_tokens: 'int') -> 'Encoded'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.ToolArgumentValidationError¶
Stability: alpha
Raised when a model's tool-call arguments do not match the tool's own schema.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.ToolCallDelta¶
Stability: alpha
Part of one tool call. Vendors send the arguments as JSON text, a fragment at a time.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.ToolDeclaration¶
Stability: alpha
A tool as the model is told about it.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.TurnKind¶
Stability: alpha
What a turn is for, which is what decides whether thinking less is safe.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.UsageDelta¶
Stability: alpha
The running total, as the provider reports it. Later events replace earlier ones.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.Vector¶
Stability: alpha
Type alias.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.cache.CacheEntry¶
Stability: alpha
One stored answer and everything needed to decide whether to serve it.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.cache.CacheKey¶
Stability: alpha
Every determinant of an answer, so that changing one cannot serve the old answer.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.cache.CacheMetrics¶
Stability: alpha
Counters an operator reads to decide whether the cache earns its risk.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.cache.CacheOutcome¶
Stability: alpha
What the cache did for one call, handed to an observer for the run's trace.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.cache.CachePolicy¶
Stability: alpha
The written-down rules about what may be cached, and for how long.
Typed errors: ValueError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.cache.CacheStatus¶
Stability: alpha
What the cache did for one call, as the word an operator reads in a trace.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.cache.CacheStore¶
Stability: alpha · Kind: Protocol
Where entries live. Narrow, so no store is hardwired into the kit.
class CacheStore(Protocol) {get(self, digest: 'str') -> 'CacheEntry | None'; purge(self, **by: 'str | None') -> 'int'; put(self, entry: 'CacheEntry') -> 'None'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.cache.Cacheability¶
Stability: alpha
Whether a call may be cached, and the rule that decided it.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.cache.CachingProvider¶
Stability: alpha
A ModelProvider that answers from a previous call where the rules allow it.
class CachingProvider(object) {complete(self, request: 'ModelRequest') -> 'ModelResponse'; count_tokens(self, messages: 'Sequence[Message]') -> 'int'; forget(self, **by: 'str | None') -> 'int'; stream(self, request: 'ModelRequest') -> 'AsyncIterator[StreamEvent]'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.cache.MemoryCacheStore¶
Stability: alpha
An in-process store, for a single replica and for tests.
class MemoryCacheStore(object) {every(self) -> 'list[CacheEntry]'; get(self, digest: 'str') -> 'CacheEntry | None'; purge(self, **by: 'str | None') -> 'int'; put(self, entry: 'CacheEntry') -> 'None'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.cache.MemorySemanticIndex¶
Stability: alpha
An in-process vector index, exact over few entries and honest about being so.
class MemorySemanticIndex(object) {add(self, digest: 'str', vector: 'Vector', *, tenant: 'str', embedding_model: 'str') -> 'None'; nearest(self, vector: 'Vector', *, tenant: 'str', embedding_model: 'str') -> 'tuple[str, float] | None'; purge(self, **by: 'str | None') -> 'int'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.cache.SemanticConfig¶
Stability: alpha
The optional near-match tier, which is off unless one of these is passed.
Typed errors: ValueError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.cache.SemanticIndex¶
Stability: alpha · Kind: Protocol
Where the vectors behind an optional near-match tier live.
class SemanticIndex(Protocol) {add(self, digest: 'str', vector: 'Vector', *, tenant: 'str', embedding_model: 'str') -> 'None'; nearest(self, vector: 'Vector', *, tenant: 'str', embedding_model: 'str') -> 'tuple[str, float] | None'; purge(self, **by: 'str | None') -> 'int'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.cache.not_cacheable¶
Stability: alpha
Mark every model call made inside this block as one that must not be cached.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.catalogue.CATALOGUE_VERSION¶
Stability: alpha
str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.catalogue.ModelCard¶
Stability: alpha
One model, as the snapshot recorded it.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.catalogue.Pricing¶
Stability: alpha
What a vendor charges, in US dollars per million tokens.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.catalogue.known_models¶
Stability: alpha
Return every card in the snapshot, or every card for one provider.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.catalogue.model_card¶
Stability: alpha
Return the card for ref, by model id or by one of the vendor's dated aliases.
Typed errors: ConfigurationError, ValueError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.catalogue.priced¶
Stability: alpha
Return usage with its cost filled in from card, where the card records one.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.classify¶
Stability: alpha
What the next call is for, judged from what the conversation ends with.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.credentials.Credential¶
Stability: alpha
One provider key, resolved on each use.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.credentials.EnvironmentSecrets¶
Stability: alpha
The default secret provider: the process environment, read on every request.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.embeddings.BatchConfig¶
Stability: alpha
How long to wait for a batch to fill, and how big to let it get.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.embeddings.BatchingEmbedder¶
Stability: alpha
Coalesces concurrent single-text requests into provider batches.
class BatchingEmbedder(object) {aclose(self) -> 'None'; embed(self, text: 'str', *, model: 'str', tenant: 'str' = 'default', interactive: 'bool' = False) -> 'Vector'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.embeddings.EmbeddingLimits¶
Stability: alpha
What one provider says it will accept in a single embedding call.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.embeddings.EmbeddingMetrics¶
Stability: alpha
A snapshot of what the embedder did, for an operator tuning the window.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.embeddings.EmbeddingProvider¶
Stability: alpha · Kind: Protocol
A provider that turns texts into vectors, one call at a time.
class EmbeddingProvider(Protocol) {embed(self, texts: 'Sequence[str]', *, model: 'str') -> 'Sequence[Vector]'; limits(self, model: 'str') -> 'EmbeddingLimits'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.embeddings.Vector¶
Stability: alpha
Type alias.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.errored¶
Stability: alpha
Return message marked as a failed tool result, so no policy clamps the recovery.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.gguf.DEFAULT_KV_BYTES_PER_TOKEN¶
Stability: alpha
int([x]) -> integer int(x, base=10) -> integer
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.gguf.DEFAULT_QUANTIZATION¶
Stability: alpha
A GGUF quantization, named as the file names it.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.gguf.GgufModel¶
Stability: alpha
A quantized model as it will be loaded.
class GgufModel(AdkModel) {at(self, quantization: 'Quantization') -> 'GgufModel'; footprint(self, *, context_tokens: 'int') -> 'MemoryEstimate'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.gguf.MemoryEstimate¶
Stability: alpha
What loading a model will cost, broken into the parts that move for different reasons.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.gguf.ModelTooLargeError¶
Stability: alpha
Raised when a model cannot fit in the memory the machine has.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.gguf.Quantization¶
Stability: alpha
A GGUF quantization, named as the file names it.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.gguf.quantization_for¶
Stability: alpha
The format to serve this model in on a machine with available_bytes.
def quantization_for(parameters_b: 'float', *, context_tokens: 'int', available_bytes: 'int', kv_bytes_per_token: 'int' = 131072) -> 'Quantization'
Typed errors: ModelTooLargeError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.gguf.refuse_if_it_will_not_fit¶
Stability: alpha
Check a model against the memory there is, before anything tries to load it.
def refuse_if_it_will_not_fit(model: 'GgufModel', *, context_tokens: 'int', available_bytes: 'int') -> 'None'
Typed errors: ModelTooLargeError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.known_models¶
Stability: alpha
Return every card in the snapshot, or every card for one provider.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.load_session¶
Stability: alpha
Verify the artefact and load it into an onnxruntime session.
def load_session(model: 'OnnxModel', *, directory: 'Path', device: 'Device' = <Device.CPU: 'cpu'>, threads: 'int' = 0) -> 'OnnxSession'
Typed errors: ConfigurationError, ModelArtifactError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.model_card¶
Stability: alpha
Return the card for ref, by model id or by one of the vendor's dated aliases.
Typed errors: ConfigurationError, ValueError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.not_cacheable¶
Stability: alpha
Mark every model call made inside this block as one that must not be cached.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.onnx.Device¶
Stability: alpha
Where a session runs. The only thing a GPU changes about this backend.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.onnx.Encoded¶
Stability: alpha
A batch of texts as the model takes them.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.onnx.ONNX_MODELS¶
Stability: alpha
Built-in immutable sequence.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.onnx.OnnxCrossEncoder¶
Stability: alpha
A CrossEncoder over a local ONNX session: query and passage in, one score out.
class OnnxCrossEncoder(object) {score(self, pairs: 'Sequence[tuple[str, str]]') -> 'Sequence[float]'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.onnx.OnnxEmbeddings¶
Stability: alpha
An EmbeddingProvider over a local ONNX session, batched and cached.
class OnnxEmbeddings(object) {embed(self, texts: 'Sequence[str]', *, model: 'str') -> 'Sequence[Vector]'; limits(self, model: 'str') -> 'EmbeddingLimits'}
Typed errors: ValueError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.onnx.OnnxMetrics¶
Stability: alpha
What the last call did, for an operator holding the backend to its budget.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.onnx.OnnxModel¶
Stability: alpha
One model in the shipped set, and everything needed to check it before loading.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.onnx.OnnxSession¶
Stability: alpha · Kind: Protocol
A loaded model, run synchronously. The one thing onnxruntime is needed for.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.onnx.Throughput¶
Stability: alpha
What a model costs, at the batch and thread count it was measured with.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.onnx.Tokenizing¶
Stability: alpha · Kind: Protocol
Turns text into the ids a session runs on.
class Tokenizing(Protocol) {encode(self, texts: 'Sequence[str]', *, max_tokens: 'int') -> 'Encoded'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.onnx.load_session¶
Stability: alpha
Verify the artefact and load it into an onnxruntime session.
def load_session(model: 'OnnxModel', *, directory: 'Path', device: 'Device' = <Device.CPU: 'cpu'>, threads: 'int' = 0) -> 'OnnxSession'
Typed errors: ConfigurationError, ModelArtifactError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.onnx.onnx_model¶
Stability: alpha
Return the shipped model called name.
Typed errors: ConfigurationError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.onnx.verify_artefact¶
Stability: alpha
Check the model file before anything tries to load it, and return its path.
Typed errors: ModelArtifactError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.onnx_model¶
Stability: alpha
Return the shipped model called name.
Typed errors: ConfigurationError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.pool.ClientKey¶
Stability: alpha
What makes two requests eligible to share a connection.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.pool.ClientPool¶
Stability: alpha
The registry that owns provider clients and their lifetime.
class ClientPool(object) {aclose(self) -> 'None'; config_for(self, provider: 'str') -> 'PoolConfig'; retire(self, *, provider: 'str', base_url: 'str', credential: 'str' = '', timeout_seconds: 'float | None' = None, connect_seconds: 'float | None' = None) -> 'None'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.pool.PoolConfig¶
Stability: alpha
How many connections a provider is allowed, and how long an idle one is kept.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.pool.PoolMetrics¶
Stability: alpha
A snapshot of what the registry has done, taken rather than watched.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.priced¶
Stability: alpha
Return usage with its cost filled in from card, where the card records one.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.pricing.PRICE_LIST_ENV¶
Stability: alpha
str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.pricing.PriceCard¶
Stability: alpha
One rate, for one model, from one day, under one request shape.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.pricing.PriceList¶
Stability: alpha
Every card a deployment bills against.
class PriceList(AdkModel) {overridden_by(self, other: 'PriceList') -> 'Self'; rate_for(self, ref: 'str | ModelRef', *, at: 'date', input_tokens: 'int' = 0, batch: 'bool' = False) -> 'Rate | None'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.pricing.Rate¶
Stability: alpha
What one model costs, per million tokens, in one currency.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.pricing.UnknownPricing¶
Stability: alpha
Raised as a warning when a model has no price on the day it was called.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.pricing.cost_of¶
Stability: alpha
What usage came to on ref, at the price in force on at.
def cost_of(usage: 'Usage', ref: 'str | ModelRef', *, at: 'date', prices: 'PriceList | None' = None, batch: 'bool' = False) -> 'Cost'
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.pricing.kit_prices¶
Stability: alpha
The prices the kit ships, taken from the model catalogue snapshot.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.pricing.price_list¶
Stability: alpha
The kit's prices with a deployment's own laid over them.
Typed errors: ConfigurationError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.pricing.pricing_at¶
Stability: alpha
The shipped price list, as the Pricing an estimate is built against.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.provider_effort¶
Stability: alpha
How to say effort to provider, or nothing at all where it has no such parameter.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.AnthropicProvider¶
Stability: alpha
Calls Anthropic's Messages API and answers in the kit's types.
class AnthropicProvider(HttpProvider) {complete(self, request: 'ModelRequest') -> 'ModelResponse'; stream(self, request: 'ModelRequest') -> 'AsyncIterator[StreamEvent]'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.CompatibilityPreset¶
Stability: alpha
One server's deviations from the format it claims to speak.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.GROK¶
Stability: alpha
One server's deviations from the format it claims to speak.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.GROQ¶
Stability: alpha
One server's deviations from the format it claims to speak.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.GeminiProvider¶
Stability: alpha
Calls Gemini's generateContent API and answers in the kit's types.
class GeminiProvider(HttpProvider) {complete(self, request: 'ModelRequest') -> 'ModelResponse'; stream(self, request: 'ModelRequest') -> 'AsyncIterator[StreamEvent]'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.LLAMA_CPP¶
Stability: alpha
One server's deviations from the format it claims to speak.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.LlamaCppProvider¶
Stability: alpha
A llama-server endpoint, with the CPU backend's own concerns handled.
Typed errors: ConfigurationError, ModelTooLargeError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.LlamaCppTuning¶
Stability: alpha
How the server was started, in the form both the operator and the kit read.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.OLLAMA¶
Stability: alpha
One server's deviations from the format it claims to speak.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.OPENROUTER¶
Stability: alpha
One server's deviations from the format it claims to speak.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.OpenAICompatibleProvider¶
Stability: alpha
An OpenAI-compatible endpoint, described rather than probed.
class OpenAICompatibleProvider(OpenAIProvider) {complete(self, request: 'ModelRequest') -> 'ModelResponse'; stream(self, request: 'ModelRequest') -> 'AsyncIterator[StreamEvent]'}
Typed errors: ConfigurationError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.OpenAIProvider¶
Stability: alpha
Calls OpenAI's Chat Completions API and answers in the kit's types.
class OpenAIProvider(HttpProvider) {complete(self, request: 'ModelRequest') -> 'ModelResponse'; stream(self, request: 'ModelRequest') -> 'AsyncIterator[StreamEvent]'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.PHASE_DEFAULTS¶
Stability: alpha
Seconds allowed for each phase of one provider call.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.PhaseTimeouts¶
Stability: alpha
Seconds allowed for each phase of one provider call.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.TGI¶
Stability: alpha
One server's deviations from the format it claims to speak.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.VLLM¶
Stability: alpha
One server's deviations from the format it claims to speak.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.XAI¶
Stability: alpha
One server's deviations from the format it claims to speak.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.anthropic.AnthropicProvider¶
Stability: alpha
Calls Anthropic's Messages API and answers in the kit's types.
class AnthropicProvider(HttpProvider) {complete(self, request: 'ModelRequest') -> 'ModelResponse'; stream(self, request: 'ModelRequest') -> 'AsyncIterator[StreamEvent]'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.compatible.CompatibilityPreset¶
Stability: alpha
One server's deviations from the format it claims to speak.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.compatible.GROK¶
Stability: alpha
One server's deviations from the format it claims to speak.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.compatible.GROQ¶
Stability: alpha
One server's deviations from the format it claims to speak.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.compatible.OLLAMA¶
Stability: alpha
One server's deviations from the format it claims to speak.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.compatible.OPENROUTER¶
Stability: alpha
One server's deviations from the format it claims to speak.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.compatible.OpenAICompatibleProvider¶
Stability: alpha
An OpenAI-compatible endpoint, described rather than probed.
class OpenAICompatibleProvider(OpenAIProvider) {complete(self, request: 'ModelRequest') -> 'ModelResponse'; stream(self, request: 'ModelRequest') -> 'AsyncIterator[StreamEvent]'}
Typed errors: ConfigurationError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.compatible.TGI¶
Stability: alpha
One server's deviations from the format it claims to speak.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.compatible.VLLM¶
Stability: alpha
One server's deviations from the format it claims to speak.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.compatible.XAI¶
Stability: alpha
One server's deviations from the format it claims to speak.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.gemini.GeminiProvider¶
Stability: alpha
Calls Gemini's generateContent API and answers in the kit's types.
class GeminiProvider(HttpProvider) {complete(self, request: 'ModelRequest') -> 'ModelResponse'; stream(self, request: 'ModelRequest') -> 'AsyncIterator[StreamEvent]'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.llama_cpp.LLAMA_CPP¶
Stability: alpha
One server's deviations from the format it claims to speak.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.llama_cpp.LlamaCppProvider¶
Stability: alpha
A llama-server endpoint, with the CPU backend's own concerns handled.
Typed errors: ConfigurationError, ModelTooLargeError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.llama_cpp.LlamaCppTuning¶
Stability: alpha
How the server was started, in the form both the operator and the kit read.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.normalised_tool_calls¶
Stability: alpha
Return calls unchanged, having proved they are callable.
def normalised_tool_calls(calls: 'Sequence[ToolCall]', *, request: 'ModelRequest', capabilities: 'ModelCapabilities', provider: 'str') -> 'tuple[ToolCall, ...]'
Typed errors: CapabilityError, ModelResponseError, ToolArgumentValidationError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.providers.openai.OpenAIProvider¶
Stability: alpha
Calls OpenAI's Chat Completions API and answers in the kit's types.
class OpenAIProvider(HttpProvider) {complete(self, request: 'ModelRequest') -> 'ModelResponse'; stream(self, request: 'ModelRequest') -> 'AsyncIterator[StreamEvent]'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.routing.ROUTING_TABLE_ENV¶
Stability: alpha
str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.routing.RoutingRule¶
Stability: alpha
One task class, optionally narrowed to who is asking, and what may answer it.
class RoutingRule(AdkModel) {answers(self, task_class: 'TaskClass', tenant: 'str | None', agent: 'str | None') -> 'bool'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.routing.RoutingTable¶
Stability: alpha
Every rule a deployment routes by, validated when it is built.
class RoutingTable(AdkModel) {matching(self, task_class: 'TaskClass', tenant: 'str | None', agent: 'str | None') -> 'RoutingRule | None'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.routing.TABLE_VERSION¶
Stability: alpha
int([x]) -> integer int(x, base=10) -> integer
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.routing.TableRouter¶
Stability: alpha
A ModelRouter that reads a RoutingTable.
class TableRouter(object) {reloaded(self, table: 'RoutingTable') -> 'TableRouter'; resolve(self, task_class: 'TaskClass', *, requirements: 'ModelRequirements | None' = None, tenant: 'str | None' = None, agent: 'str | None' = None, pinned: 'ModelRef | None' = None) -> 'RoutingDecision'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.routing.routing_table¶
Stability: alpha
Read a routing table from TOML, validated as it is read.
def routing_table(path: 'Path | str | None' = None, *, env: 'Mapping[str, str] | None' = None) -> 'RoutingTable'
Typed errors: ConfigurationError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.shaping.Effort¶
Stability: alpha
How much deliberation a call is worth, expressed once and mapped per provider.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.shaping.Shaped¶
Stability: alpha
What shaping decided for one call, for the model call record.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.shaping.Shaping¶
Stability: alpha
A clamp-only output shaping policy, off until an agent turns it on.
class Shaping(AdkModel) {shape(self, request: 'ModelRequest', *, effort: 'Effort | None' = None, final: 'bool' = False) -> 'Shaped'; steer(self, request: 'ModelRequest') -> 'ModelRequest'}
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.shaping.TOOL_ERROR¶
Stability: alpha
str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.shaping.TurnKind¶
Stability: alpha
What a turn is for, which is what decides whether thinking less is safe.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.shaping.classify¶
Stability: alpha
What the next call is for, judged from what the conversation ends with.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.shaping.errored¶
Stability: alpha
Return message marked as a failed tool result, so no policy clamps the recovery.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.shaping.provider_effort¶
Stability: alpha
How to say effort to provider, or nothing at all where it has no such parameter.
Typed errors: None declared.
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.
tesserix_adk.models.verify_artefact¶
Stability: alpha
Check the model file before anything tries to load it, and return its path.
Typed errors: ModelArtifactError
Runnable recipe: examples/providers.py — providers are substitutable behind declared capabilities.