Core API¶

Generated from the typed public surface.

`tesserix_adk.core.ALLOWED_ATTRIBUTES`¶

Stability: beta

Build an immutable unordered collection of unique elements.

ALLOWED_ATTRIBUTES: frozenset

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Abstention`¶

Stability: beta

An answer of "I do not know", typed rather than a plausible invented alternative.

class Abstention(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ActionClass`¶

Stability: beta

A named class of side effect, and where in a call's arguments its money is.

class ActionClass(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ActionRegistry`¶

Stability: beta

Which action class each tool belongs to.

class ActionRegistry(object) {named(self, action_class: 'str') -> 'ActionClass | None'; of(self, tool: 'str') -> 'ActionClass | None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ActionRequest`¶

Stability: beta

One action an agent wants to take, and what the runtime knows about it.

class ActionRequest(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ActivityClass`¶

Stability: beta

What kind of work an activity does, which is what its numbers follow from.

class ActivityClass(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ActivityPolicy`¶

Stability: beta

The numbers one activity runs under.

class ActivityPolicy(AdkModel) {attempts_for(self, idempotency: 'IdempotencyPolicy | None', *, keyed: 'bool' = False) -> 'int'; backoff(self, seconds: 'float', *, elapsed: 'float') -> 'Backoff'; retryable(self, failure: 'BaseException') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AdkConfig`¶

Stability: beta

The kit's resolved configuration. Frozen, fully typed, validated at startup.

class AdkConfig(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AdkDeprecationWarning`¶

Stability: beta

Warns that a public name of the kit is scheduled for removal.

class AdkDeprecationWarning(DeprecationWarning)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AdkError`¶

Stability: beta

Base class for every error raised by the kit.

class AdkError(Exception)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AdkModel`¶

Stability: beta

Frozen, strict, and closed to fields it does not declare.

class AdkModel(BaseModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Agent`¶

Stability: beta

A declarative description of an agent.

class Agent(AdkModel, Generic)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AgentDefinition`¶

Stability: beta

One agent, as the artifact that was reviewed.

class AgentDefinition(AdkModel, Generic)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AgentIdentity`¶

Stability: beta

What one agent may do on one run: its declaration, cut down to the caller's grant.

class AgentIdentity(object) {check(self, required: 'Iterable[str]', *, where: 'str' = '') -> 'None'; check_live(self, now: 'float', *, where: 'str' = '') -> 'None'; missing(self, required: 'Iterable[str]') -> 'tuple[str, ...]'; narrowed(self, *, agent: 'str', declared: 'Iterable[str]') -> 'Self'; permits(self, scope: 'str') -> 'bool'; unused(self, used: 'Iterable[str]') -> 'tuple[str, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AggregationError`¶

Stability: beta

Raised when concurrent branches did not add up to the aggregate that was asked for.

class AggregationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Applied`¶

Stability: beta

One forward action that really happened, and enough to take it back.

class Applied(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ApprovalBindingError`¶

Stability: beta

Raised when a grant is asked to cover something other than what it was shown.

class ApprovalBindingError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ApprovalDecided`¶

Stability: beta

A human answered.

class ApprovalDecided(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ApprovalDecision`¶

Stability: beta

A human's answer about one held call.

class ApprovalDecision(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ApprovalDeliveryError`¶

Stability: beta

Raised when the question could not be put in front of anybody.

class ApprovalDeliveryError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ApprovalDenial`¶

Stability: beta

What a denied or expired approval means to the run.

class ApprovalDenial(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ApprovalDeniedError`¶

Stability: beta

Raised when a human declined a held tool call.

class ApprovalDeniedError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ApprovalExpiredError`¶

Stability: beta

Raised when a decision arrived past the request's time to live.

class ApprovalExpiredError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ApprovalGate`¶

Stability: beta · Kind: Protocol

Where a run waits for a human to decide about a tool call.

class ApprovalGate(Protocol) {request(self, record: 'ApprovalRecord') -> 'ApprovalDecision'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ApprovalPolicy`¶

Stability: beta

When a tool may not run without a human, decided by code rather than by the model.

class ApprovalPolicy(object) {applies_to(self, arguments: 'Mapping[str, Any]') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ApprovalPredicate`¶

Stability: beta

Type alias.

ApprovalPredicate: TypeAliasType

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ApprovalRecord`¶

Stability: beta

A tool call held for a human decision, in a form safe to put in a queue.

class ApprovalRecord(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ApprovalRequested`¶

Stability: beta

A human was asked before something ran.

class ApprovalRequested(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ApprovalToken`¶

Stability: beta

A bearer secret that resolves to one suspended run and one held action.

class ApprovalToken(AdkModel) {expired_by(self, now: 'float') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ApprovalTokenError`¶

Stability: beta

Raised when a token cannot buy the decision it was presented for.

class ApprovalTokenError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ApprovalTransport`¶

Stability: beta · Kind: Protocol

How the question reaches whoever answers it, apart from where the run waits.

class ApprovalTransport(Protocol) {deliver(self, record: 'ApprovalRecord') -> 'ApprovalDecision | None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AttributionError`¶

Stability: beta

Raised when spend could not be attributed to the participants that incurred it.

class AttributionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AuditDecision`¶

Stability: beta

What was decided about one attempted action.

class AuditDecision(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AuditEvent`¶

Stability: beta

One decision about one attempted action, as it is stored.

class AuditEvent(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AuditSink`¶

Stability: beta · Kind: Protocol

Where decisions are appended, and read back by whoever is accountable for them.

class AuditSink(Protocol) {append(self, event: 'AuditEvent') -> 'AuditEvent'; pseudonymise(self, *, tenant: 'str', subject: 'str') -> 'int'; records(self, *, tenant: 'str', since: 'float' = 0.0, until: 'float | None' = None, decision: 'AuditDecision | None' = None) -> 'tuple[AuditEvent, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AuditUnavailableError`¶

Stability: beta

Raised when a decision about an autonomous action could not be recorded.

class AuditUnavailableError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AuthMethod`¶

Stability: beta

How the principal was established, which is what its expiry means.

class AuthMethod(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AuthenticationError`¶

Stability: beta

Raised when a provider rejected the credential, or what it is allowed to reach.

class AuthenticationError(ProviderError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AuthorisationError`¶

Stability: beta

Raised when work needs authority the run's effective scopes do not carry.

class AuthorisationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AuthorityRevokedError`¶

Stability: beta

Raised when the authority a run was acting on is gone rather than merely stale.

class AuthorityRevokedError(AuthorisationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AutonomyDecision`¶

Stability: beta

What the ladder decided, and what has to be recorded about it.

class AutonomyDecision(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AutonomyGrant`¶

Stability: beta

Permission to act unattended, issued by somebody, expiring by itself.

class AutonomyGrant(AdkModel) {covers(self, *, tenant: 'str', user: 'str | None', now: 'float') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AutonomyLadder`¶

Stability: beta

Resolves one attempted action against the grants that cover it.

class AutonomyLadder(object) {amount_in(self, tool: 'str', arguments: 'Mapping[str, Any]') -> 'Decimal | None'; classify(self, tool: 'str') -> 'str | None'; decide(self, request: 'ActionRequest') -> 'AutonomyDecision'; validate_grants(self) -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AutonomyLevel`¶

Stability: beta

How far a grant lets an agent go before a human is involved.

class AutonomyLevel(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AutonomyOutcome`¶

Stability: beta

What the ladder decided about one attempted action.

class AutonomyOutcome(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.AutonomyRefusedError`¶

Stability: beta

Raised when an action is one no grant could ever have permitted.

class AutonomyRefusedError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Backoff`¶

Stability: beta

How long to wait, and whether the wait was cut to fit inside the activity.

class Backoff(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.BinaryPart`¶

Stability: beta

Bytes in a message — an image, an audio clip, a scanned document.

class BinaryPart(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Bounded`¶

Stability: beta

A numeric field that has to stay inside a band.

class Bounded(object) {check(self, result: 'BaseModel') -> 'tuple[PolicyViolation, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.BudgetDecision`¶

Stability: beta

Whether there is room left, and where there is not.

class BudgetDecision(AdkModel) {as_error(self) -> 'BudgetExceededError'}

Typed errors: None declared.

Runnable recipe: examples/budget.py — ceilings are enforced before dispatch.

`tesserix_adk.core.BudgetExceeded`¶

Stability: beta

A ceiling stopped the work.

class BudgetExceeded(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/budget.py — ceilings are enforced before dispatch.

`tesserix_adk.core.BudgetExceededError`¶

Stability: beta

Raised when a run would exceed its ceiling. Raised before the spend, not after.

class BudgetExceededError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/budget.py — ceilings are enforced before dispatch.

`tesserix_adk.core.BudgetLimits`¶

Stability: beta

A ceiling, in every dimension a run can run away in.

class BudgetLimits(AdkModel) {filled(self) -> 'Self'}

Typed errors: None declared.

Runnable recipe: examples/budget.py — ceilings are enforced before dispatch.

`tesserix_adk.core.BudgetPolicy`¶

Stability: beta · Kind: Protocol

Spend and usage limits applied before and after a metered call.

class BudgetPolicy(Protocol) {check(self) -> 'BudgetDecision'; child(self) -> 'BudgetPolicy'; limits(self) -> 'BudgetLimits'; record(self, usage: 'Usage', *, model_calls: 'int' = 0, tool_calls: 'int' = 0, iterations: 'int' = 0, peer_invocations: 'int' = 0) -> 'None'; reserve(self, estimate: 'int') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/budget.py — ceilings are enforced before dispatch.

`tesserix_adk.core.BudgetScope`¶

Stability: beta

Where a set of limits was attached, which is how the effective one is attributed.

class BudgetScope(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/budget.py — ceilings are enforced before dispatch.

`tesserix_adk.core.BudgetUnavailableError`¶

Stability: beta

Raised when the ledger a shared ceiling lives in cannot be reached.

class BudgetUnavailableError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/budget.py — ceilings are enforced before dispatch.

`tesserix_adk.core.CHEAP`¶

Stability: beta

The kind of work, named rather than the model that does it.

CHEAP: TaskClass

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CHECKPOINT_FORMAT`¶

Stability: beta

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

CHECKPOINT_FORMAT: int

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CURRENT_VERSIONS`¶

Stability: beta

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)

CURRENT_VERSIONS: dict

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CachingSecrets`¶

Stability: beta

A resolver with a ttl, so a rotated secret is picked up without a restart.

class CachingSecrets(object) {invalidate(self, ref: 'SecretRef') -> 'None'; invalidate_all(self) -> 'None'; resolve(self, ref: 'SecretRef') -> 'SecretStr'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CachingTenantConfig`¶

Stability: beta

A provider in front of a provider, so a limit lookup is not a round trip per run.

class CachingTenantConfig(object) {config_for(self, tenant: 'str') -> 'TenantConfig'; invalidate(self, tenant: 'str') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CallCredential`¶

Stability: beta · Kind: Protocol

The part of a minted credential a caller renders.

class CallCredential(Protocol) {headers(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CancelledError`¶

Stability: beta

Raised when a run was cancelled. In-flight work stops; state becomes cancelled.

class CancelledError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Capability`¶

Stability: beta

A thing a model either does or does not do, named the same way everywhere.

class Capability(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CapabilityError`¶

Stability: beta

Raised when something is asked of a provider that it has not declared it can do.

class CapabilityError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CapabilitySet`¶

Stability: beta

Runtime representation of an annotated type.

CapabilitySet = typing.Annotated[frozenset[tesserix_adk.core.capabilities.Capability], BeforeValidator(func=<class 'frozenset'>, json_schema_input_type=PydanticUndefined)]

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Ceiling`¶

Stability: beta

How much a grant covers, in what, over what window.

class Ceiling(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CeilingExceededError`¶

Stability: beta

Raised when an action would take more headroom than the ceiling has left.

class CeilingExceededError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CeilingLedger`¶

Stability: beta · Kind: Protocol

Reserve before the action, settle after it. Also what a ladder reads headroom from.

class CeilingLedger(Protocol) {commit(self, idempotency_key: 'str') -> 'Hold | None'; committed(self, *, tenant: 'str', action_class: 'str', window_seconds: 'float') -> 'Decimal'; release(self, idempotency_key: 'str') -> 'None'; reserve(self, *, tenant: 'str', action_class: 'str', ceiling: 'Ceiling', amount: 'Decimal', idempotency_key: 'str') -> 'Hold'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ChainedSecrets`¶

Stability: beta

Resolvers tried in order, the first that holds the secret answering.

class ChainedSecrets(object) {resolve(self, ref: 'SecretRef') -> 'SecretStr'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Checkpoint`¶

Stability: beta

The frontier of a run, far enough along that another process can carry it on.

class Checkpoint(AdkModel) {resumable_by(self, format_version: 'int' = 1) -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CheckpointBoundary`¶

Stability: beta

Where in a turn a checkpoint may be taken.

class CheckpointBoundary(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CheckpointFormatError`¶

Stability: beta

Raised when a checkpoint was written by a kit version this one cannot read.

class CheckpointFormatError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CheckpointPolicy`¶

Stability: beta

When a run is written down, and how much of it may be.

class CheckpointPolicy(AdkModel) {writes_at(self, boundary: 'CheckpointBoundary') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CheckpointStore`¶

Stability: beta · Kind: Protocol

Where the frontier of a run is kept between processes.

class CheckpointStore(Protocol) {forget(self, run_id: 'str', *, tenant: 'str') -> 'None'; latest(self, run_id: 'str', *, tenant: 'str') -> 'Checkpoint | None'; put(self, checkpoint: 'Checkpoint') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CheckpointTooLargeError`¶

Stability: beta

Raised when a run's frontier exceeds what a checkpoint may carry.

class CheckpointTooLargeError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ChunkingError`¶

Stability: beta

Raised when a run of text cannot be divided under the chunk token limit.

class ChunkingError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Claim`¶

Stability: beta

What the store said when a call asked to run.

class Claim(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ClaimCheckPolicy`¶

Stability: beta

When a result is checked in, how much of it stays, and how long the rest is kept.

class ClaimCheckPolicy(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ClaimCheckStore`¶

Stability: beta · Kind: Protocol

Where a checked-in result lives until the run that made it is over.

class ClaimCheckStore(Protocol) {fetch(self, handle: 'str', *, tenant: 'str', run_id: 'str') -> 'str'; forget(self, *, tenant: 'str', run_id: 'str' = '') -> 'int'; put(self, handle: 'str', content: 'str', *, tenant: 'str', run_id: 'str', ttl_seconds: 'float') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ClaimTicket`¶

Stability: beta

What replaces an oversized result: the beginning of it, and where the rest is.

class ClaimTicket(object) {rendered(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ClaimUnavailableError`¶

Stability: beta

Raised when a checked-in tool result cannot be produced for the handle asked about.

class ClaimUnavailableError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Classification`¶

Stability: beta

What a classifier decided about one passage.

class Classification(AdkModel) {breaches(self, thresholds: 'Thresholds') -> 'tuple[ContentCategory, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Clock`¶

Stability: beta · Kind: Protocol

Source of time, injected so that behaviour under time is testable.

class Clock(Protocol) {now(self) -> 'float'; sleep(self, seconds: 'float') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CommitmentLedger`¶

Stability: beta · Kind: Protocol

What a tenant has already committed against an action class in a window.

class CommitmentLedger(Protocol) {committed(self, *, tenant: 'str', action_class: 'str', window_seconds: 'float') -> 'Decimal'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CompensatedFailure`¶

Stability: beta

A run that failed and left nothing applied behind it.

class CompensatedFailure(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Compensating`¶

Stability: beta · Kind: Protocol

What the runtime needs of a reversal, satisfied by @compensating_activity.

class Compensating(Protocol) {compensate(self, action: 'Applied') -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CompensationIncomplete`¶

Stability: beta

A run that failed and could not put everything back.

class CompensationIncomplete(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CompensationLedger`¶

Stability: beta · Kind: Protocol

Where the record of applied, un-reversed work lives.

class CompensationLedger(Protocol) {forget(self, *, tenant: 'str') -> 'int'; mark(self, reversal: 'Reversal') -> 'None'; outstanding(self, run_id: 'str', *, tenant: 'str', branch: 'str | None' = None) -> 'Sequence[Applied]'; record(self, action: 'Applied') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ConcurrencyConfig`¶

Stability: beta

How wide one turn's tool calls may run, and how long any one of them may take.

class ConcurrencyConfig(AdkModel) {narrowed_to(self, other: 'ConcurrencyConfig | None') -> 'ConcurrencyConfig'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ConfigError`¶

Stability: beta

Raised when configuration cannot be resolved, listing every problem at once.

class ConfigError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ConfigOverrides`¶

Stability: beta

Typed code-layer configuration; unknown or misspelled keys fail static checks.

class ConfigOverrides(dict)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ConfigProblem`¶

Stability: beta

One reason the configuration cannot be used.

class ConfigProblem(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ConfigResolution`¶

Stability: beta

A resolved configuration together with the provenance of every key.

class ConfigResolution(object) {explain(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ConfigurationError`¶

Stability: beta

Raised when the kit is assembled in a way that cannot work.

class ConfigurationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Consumed`¶

Stability: beta

What has been spent against a ceiling so far.

class Consumed(AdkModel) {against(self, name: 'str') -> 'Decimal'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ContentBlockedError`¶

Stability: beta

Raised when content breaches this tenant's bar for one or more categories.

class ContentBlockedError(GuardrailViolationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ContentCategory`¶

Stability: beta

What a passage is about, in the terms a policy is written in.

class ContentCategory(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ContentClassifier`¶

Stability: beta · Kind: Protocol

Anything that can say what a passage is about.

class ContentClassifier(Protocol) {classify(self, text: 'str') -> 'Classification'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ContentFilteredError`¶

Stability: beta

Raised when a provider refused to process or to return content on policy grounds.

class ContentFilteredError(ProviderError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ContentPart`¶

Stability: beta

Runtime representation of an annotated type.

ContentPart = typing.Annotated[tesserix_adk.core.primitives.TextPart | tesserix_adk.core.primitives.BinaryPart, FieldInfo(annotation=NoneType, required=True, discriminator='kind')]

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ContentSeverity`¶

Stability: beta

How bad, ordered so a threshold is a comparison rather than a lookup table.

class ContentSeverity(IntEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ContentSource`¶

Stability: beta

Where content came from, in the form a reviewer would go and look it up by.

class ContentSource(AdkModel) {attributes(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ContextBudgetError`¶

Stability: beta

Raised when a prompt cannot be made to fit the tokens available for it.

class ContextBudgetError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ContextWindowExceededError`¶

Stability: beta

Raised when an assembled prompt is longer than the model declares it can read.

class ContextWindowExceededError(CapabilityError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Cost`¶

Stability: beta

What one call, or one whole run, came to.

class Cost(AdkModel) {quantised(self, places: 'int' = 6) -> 'Cost'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CostConfidence`¶

Stability: beta

How much of the number is known.

class CostConfidence(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CountSource`¶

Stability: beta

Who counted the tokens, which is the difference between a figure and a guess.

class CountSource(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CredentialError`¶

Stability: beta

Raised when a tool could not obtain the credential its call needs.

class CredentialError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CredentialExpiredError`¶

Stability: beta

Raised when the credential a call needs has lapsed and could not be replaced.

class CredentialExpiredError(CredentialError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.CredentialSource`¶

Stability: beta · Kind: Protocol

Whatever mints per-call credentials — tesserix_adk.tools.CredentialBroker does.

class CredentialSource(Protocol) {for_tool(self, *, identity: 'AgentIdentity', audience: 'str', needs: 'Iterable[str]', run_id: 'str', agent_version: 'str' = Ellipsis) -> 'CallCredential'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Credit`¶

Stability: beta

Money coming back, recorded against the class it came back from.

class Credit(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.DEFAULT_ACTIVITY_POLICIES`¶

Stability: beta

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)

DEFAULT_ACTIVITY_POLICIES: dict

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.DEFAULT_DETECTORS`¶

Stability: beta

Built-in immutable sequence.

DEFAULT_DETECTORS: tuple

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.DEFAULT_LEASE`¶

Stability: beta

How long a lease lives and when its holder should renew it.

DEFAULT_LEASE: LeasePolicy

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.DEFAULT_MAX_EVENT_BYTES`¶

Stability: beta

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

DEFAULT_MAX_EVENT_BYTES: int

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.DEFAULT_SUSPENSION_SECONDS`¶

Stability: beta

Convert a string or number to a floating-point number, if possible.

DEFAULT_SUSPENSION_SECONDS: float

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.DeadlineConfig`¶

Stability: beta

Wall-clock ceilings for a run, in seconds. None means no ceiling at that layer.

class DeadlineConfig(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.DeclaresEmulation`¶

Stability: beta · Kind: Protocol

A provider with an opinion about being stood in for.

class DeclaresEmulation(Protocol)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.DelegationError`¶

Stability: beta

Raised when work handed to a worker did not come back as an answer.

class DelegationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.DelegationLimitError`¶

Stability: beta

Raised when one agent may not hand work to another, and the run must say why.

class DelegationLimitError(LoopLimitError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Delivery`¶

Stability: beta

What a publisher that cannot deliver means for the run.

class Delivery(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.DenyReason`¶

Stability: beta

Which layer refused. An operator fixes the setting they own, not the one below it.

class DenyReason(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.DependencyCycleError`¶

Stability: beta

Raised when declared dependencies close a loop, so nothing in it could ever start.

class DependencyCycleError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Deprecation`¶

Stability: beta

A scheduled removal, as promised to consumers.

class Deprecation(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.DeprecationPolicyError`¶

Stability: beta

Raised when a deprecation would break the published versioning policy.

class DeprecationPolicyError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Dispatch`¶

Stability: beta

A dependency graph, executed as wide as the dependencies allow.

class Dispatch(Generic) {run(self) -> 'DispatchResult[T]'}

Typed errors: ConfigurationError, DependencyCycleError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.DispatchNode`¶

Stability: beta

One piece of work and what it waits for.

class DispatchNode(Generic)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.DispatchResult`¶

Stability: beta

What every node in one run of the graph did.

class DispatchResult(Generic) {value(self, name: 'str') -> 'T'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.DuplicateInFlightError`¶

Stability: beta

Raised when another worker of the same consumer group is handling this event now.

class DuplicateInFlightError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.EVENT_SCHEMAS`¶

Stability: beta

Which model validates which event type at which version, and how to move between them.

EVENT_SCHEMAS: EventSchemaRegistry

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.EVENT_SCHEMA_VERSION`¶

Stability: beta

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

EVENT_SCHEMA_VERSION: int

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.EmbeddingDimensionError`¶

Stability: beta

Raised when an embedding is not the width the collection was built with.

class EmbeddingDimensionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.EmbeddingUnavailableError`¶

Stability: beta

Raised when an ingest cannot embed a batch and stops rather than filling the gap.

class EmbeddingUnavailableError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Envelope`¶

Stability: beta

A persisted payload and the version it was written at.

class Envelope(AdkModel) {digest(self) -> 'str'; opened(self, model: 'type[ModelT]') -> 'ModelT'; preserved(self, model: 'type[ModelT]') -> 'dict[str, Any]'; to_json(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.EnvironmentSecrets`¶

Stability: beta

Resolution from the process environment, which is the local development path.

class EnvironmentSecrets(object) {resolve(self, ref: 'SecretRef') -> 'SecretStr'; variable_for(self, ref: 'SecretRef') -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.EstimateUnavailableError`¶

Stability: beta

Raised when a run's cost cannot be estimated on anything better than a guess.

class EstimateUnavailableError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.EvalIncompleteError`¶

Stability: beta

Raised when a quality gate was asked to judge a partly scored dataset.

class EvalIncompleteError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.EventEnvelope`¶

Stability: beta

One event as it travels.

class EventEnvelope(AdkModel) {to_json(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.EventIdReuseError`¶

Stability: beta

Raised when a different event arrives under an id that is already recorded.

class EventIdReuseError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.EventLoopStalledError`¶

Stability: beta

Raised when work blocked the event loop instead of awaiting on it.

class EventLoopStalledError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.EventPayload`¶

Stability: beta

What happened, as attributes drawn from the allowlist.

class EventPayload(AdkModel) {attributes(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.EventPublishError`¶

Stability: beta

Raised when an event could not be delivered and the delivery mode says that stops the run.

class EventPublishError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.EventPublisher`¶

Stability: beta · Kind: Protocol

Where events go. Implemented by a broker adapter, faked in tests, or absent.

class EventPublisher(Protocol) {publish(self, event: 'EventEnvelope') -> 'None'; publish_batch(self, events: 'tuple[EventEnvelope, ...]') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.EventSchemaRegistry`¶

Stability: beta

Which model validates which event type at which version, and how to move between them.

class EventSchemaRegistry(object) {current_version(self, event_type: 'EventType') -> 'int'; model_for(self, event_type: 'EventType', version: 'int') -> 'type[EventPayload]'; payload_of(self, envelope: 'EventEnvelope') -> 'EventPayload'; read(self, raw: 'str | bytes') -> 'EventEnvelope'; register(self, model: 'type[EventPayload]') -> 'None'; register_upcaster(self, event_type: 'EventType', *, from_version: 'int', upcast: 'Upcaster') -> 'None'; requires(self, event_type: 'EventType') -> 'int'; schemas(self) -> 'dict[str, dict[str, Any]]'; upcast(self, envelope: 'EventEnvelope') -> 'EventEnvelope'; versions(self, event_type: 'EventType') -> 'tuple[int, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.EventTooLargeError`¶

Stability: beta

Raised when an event is larger than the transport will carry.

class EventTooLargeError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.EventType`¶

Stability: beta

Everything the kit reports. A consumer switches on this and nothing else.

class EventType(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Eventing`¶

Stability: beta

Builds envelopes from payloads and publishes them under one delivery mode.

class Eventing(object) {emit(self, payload: 'EventPayload', *, caused_by: 'EventEnvelope | None' = None) -> 'EventEnvelope | None'; emit_all(self, payloads: 'Iterable[EventPayload]', *, caused_by: 'EventEnvelope | None' = None) -> 'PublishReport'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.EventsReplayed`¶

Stability: beta

An operator redelivered dead-lettered events. The audit record of a recovery.

class EventsReplayed(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ExpiringCredential`¶

Stability: beta · Kind: Protocol

A credential that says when it stops working, so a run can replace it in time.

class ExpiringCredential(CallCredential, Protocol) {expired(self, now: 'float', *, skew: 'float' = Ellipsis) -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ExpiringCredentialSource`¶

Stability: beta · Kind: Protocol

A mint whose credentials carry an expiry.

class ExpiringCredentialSource(Protocol) {for_tool(self, *, identity: 'AgentIdentity', audience: 'str', needs: 'Iterable[str]', run_id: 'str', agent_version: 'str' = Ellipsis) -> 'ExpiringCredential'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ExtractionError`¶

Stability: beta

Raised when a model's extraction output cannot be trusted as a subgraph.

class ExtractionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.FallbackChain`¶

Stability: beta

The models one run may be attempted against, in order.

class FallbackChain(AdkModel) {after(self, ref: 'str', *, failed: 'Collection[str]' = ()) -> 'str | None'; refuse_the_excluded(self) -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.FallbackExhaustedError`¶

Stability: beta

Raised when every model in a run's chain refused it.

class FallbackExhaustedError(ProviderError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.FallbackUnsafeError`¶

Stability: beta

Raised when another model cannot be tried without risking a repeated side effect.

class FallbackUnsafeError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.FanOutLimitError`¶

Stability: beta

Raised when one turn, or one run, asked for more tool calls than its cap allows.

class FanOutLimitError(LoopLimitError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.FilePromptRegistry`¶

Stability: beta

Prompts as one TOML file per name, versions and aliases inside it.

class FilePromptRegistry(object) {get(self, name: 'str', *, version: 'str' = '', alias: 'str' = '', tenant: 'str' = '') -> 'PromptDefinition'; list_versions(self, name: 'str', *, tenant: 'str' = '') -> 'tuple[str, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.FileTenantConfig`¶

Stability: beta

Tenant configuration as one TOML file per tenant in a directory.

class FileTenantConfig(object) {config_for(self, tenant: 'str') -> 'TenantConfig'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.GrantIssuer`¶

Stability: beta · Kind: Protocol

Issuing and withdrawing autonomy, which only a human or system identity does.

class GrantIssuer(Protocol) {issue(self, grant: 'AutonomyGrant') -> 'AutonomyGrant'; revoke(self, revocation: 'Revocation') -> 'Revocation'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.GrantReader`¶

Stability: beta · Kind: Protocol

What the runtime is allowed to know about grants: what is live, and nothing more.

class GrantReader(Protocol) {grants_for(self, *, tenant: 'str', action_class: 'str') -> 'Sequence[AutonomyGrant]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.GrantRevokedError`¶

Stability: beta

Raised when the grant a run was acting under was withdrawn while it was under way.

class GrantRevokedError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.GuardResult`¶

Stability: beta

One guard's answer about one piece of content.

class GuardResult(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.GuardStage`¶

Stability: beta

Where in a run a check happened. Carried on every verdict and every refusal.

class GuardStage(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.GuardVerdict`¶

Stability: beta

What a guard decided.

class GuardVerdict(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Guardrail`¶

Stability: beta · Kind: Protocol

An inline check on what enters a run and on what leaves it.

class Guardrail(Protocol) {check_input(self, content: 'str') -> 'GuardResult'; check_output(self, content: 'str') -> 'GuardResult'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.GuardrailError`¶

Stability: beta

Base for what a guard decided and for what it could not decide.

class GuardrailError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.GuardrailEvaluationError`¶

Stability: beta

Raised when a guard could not reach a verdict, which is not consent.

class GuardrailEvaluationError(GuardrailError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.GuardrailPipeline`¶

Stability: beta

An ordered, fail-closed chain of guards over one stage of a run.

class GuardrailPipeline(object) {check_input(self, content: 'str') -> 'str'; check_output(self, content: 'str') -> 'str'; check_stream(self, chunks: 'AsyncIterator[str]') -> 'AsyncIterator[str]'}

Typed errors: ConfigurationError, ProtocolConformanceError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.GuardrailViolationError`¶

Stability: beta

Raised when a guardrail rejects content. The step stops; it does not degrade.

class GuardrailViolationError(GuardrailError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.HANDLE_PREFIX`¶

Stability: beta

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

HANDLE_PREFIX: str

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.HEADER`¶

Stability: beta

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

HEADER: str

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.HandoffContractError`¶

Stability: beta

Raised when a conversation could not be handed to the agent it was addressed to.

class HandoffContractError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Heartbeat`¶

Stability: beta

Progress from a running activity. Never a result, and never part of one.

class Heartbeat(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.HeuristicClassifier`¶

Stability: beta

A term-list classifier, so a kit consumer has something before they have a model.

class HeuristicClassifier(object) {classify(self, text: 'str') -> 'Classification'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.HistoryUnavailableError`¶

Stability: beta

Raised when a resume cannot get back the transcript its checkpoint points at.

class HistoryUnavailableError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Hold`¶

Stability: beta

Headroom taken for one action, before the action happens.

class Hold(AdkModel) {live(self, at: 'float') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.HoldState`¶

Stability: beta

Where a reservation got to. Held counts against the ceiling exactly as committed does.

class HoldState(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Hook`¶

Stability: beta · Kind: Protocol

A policy attached to declared points in the loop.

class Hook(Protocol) {on(self, subject: 'HookSubject') -> 'HookDecision'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.HookAction`¶

Stability: beta

What a hook may say, ordered from least to most restrictive.

class HookAction(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.HookChain`¶

Stability: beta

The hooks a runner enforces, in declaration order.

class HookChain(object) {at(self, point: 'HookPoint') -> 'tuple[Hook, ...]'; register(self, hook: 'Hook') -> 'None'; sealed(self) -> 'HookChain'}

Typed errors: HookRegistrationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.HookDecision`¶

Stability: beta

One hook's answer at one point.

class HookDecision(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.HookEvaluationError`¶

Stability: beta

Raised when a hook could not be evaluated, which is a denial rather than a pass.

class HookEvaluationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.HookPoint`¶

Stability: beta

The seven places a run stops to ask.

class HookPoint(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.HookRefusedError`¶

Stability: beta

Raised when a hook refused the step. The reason is the hook's own.

class HookRefusedError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.HookRegistrationError`¶

Stability: beta

Raised when a hook cannot be added to a chain.

class HookRegistrationError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.HookSubject`¶

Stability: beta

What a hook is told about the step it is being asked about.

class HookSubject(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.INLINE_REFS`¶

Stability: beta

No $defs and no $ref — every definition substituted where it is used.

INLINE_REFS: InlineRefs

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.IdFactory`¶

Stability: beta · Kind: Protocol

Source of identifiers, injected so that a run can be compared with another.

class IdFactory(Protocol)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Idempotency`¶

Stability: beta

What happens when the same call runs twice.

class Idempotency(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.IdempotencyPolicy`¶

Stability: beta

A tool's declaration about repeating it, and what identifies one call.

class IdempotencyPolicy(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.IdempotencyStore`¶

Stability: beta · Kind: Protocol

Where the record of an executed side effect lives.

class IdempotencyStore(Protocol) {abandon(self, key: 'str', *, tenant: 'str') -> 'None'; begin(self, key: 'str', *, tenant: 'str', ttl_seconds: 'float') -> 'Claim'; forget(self, *, tenant: 'str') -> 'int'; record(self, key: 'str', *, tenant: 'str', outcome: 'str', ttl_seconds: 'float') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.InFlightPolicy`¶

Stability: beta

What happens to a run that is already under way when its grant is withdrawn.

class InFlightPolicy(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.InMemoryCeilingLedger`¶

Stability: beta

One process's ledger, correct under concurrency within that process.

class InMemoryCeilingLedger(object) {commit(self, idempotency_key: 'str') -> 'Hold | None'; committed(self, *, tenant: 'str', action_class: 'str', window_seconds: 'float') -> 'Decimal'; credit(self, *, tenant: 'str', action_class: 'str', currency: 'str', amount: 'Decimal', authorised_by: 'str', reason: 'str' = '') -> 'Credit'; credits(self) -> 'Sequence[Credit]'; reap(self) -> 'int'; release(self, idempotency_key: 'str') -> 'None'; reserve(self, *, tenant: 'str', action_class: 'str', ceiling: 'Ceiling', amount: 'Decimal', idempotency_key: 'str') -> 'Hold'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.InMemoryGrants`¶

Stability: beta

Grants in a dict, for tests and single-process deployments.

class InMemoryGrants(object) {all_grants(self) -> 'Sequence[AutonomyGrant]'; grants_for(self, *, tenant: 'str', action_class: 'str') -> 'Sequence[AutonomyGrant]'; issue(self, grant: 'AutonomyGrant') -> 'AutonomyGrant'; revoke(self, revocation: 'Revocation') -> 'Revocation'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.IncomparableEvalError`¶

Stability: beta

Raised when two eval runs cannot be compared to each other.

class IncomparableEvalError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.IncompatiblePromptVersionError`¶

Stability: beta

Raised when an alias may not be moved to a version the call sites cannot render.

class IncompatiblePromptVersionError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.IndeterminateOutcomeError`¶

Stability: beta

Raised when nobody can say whether a side effect happened.

class IndeterminateOutcomeError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.IndeterminateToolCallError`¶

Stability: beta

Raised when a resume cannot say whether an effectful call already happened.

class IndeterminateToolCallError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.InexactAmountError`¶

Stability: beta

Raised when an amount cannot be counted against a ceiling without drifting.

class InexactAmountError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.InjectionSignal`¶

Stability: beta

One thing screening recognised, and where.

class InjectionSignal(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.InjectionSuspectedError`¶

Stability: beta

Raised when content the run did not write is shaped like an instruction to it.

class InjectionSuspectedError(GuardrailViolationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.InlineRefs`¶

Stability: beta

No $defs and no $ref — every definition substituted where it is used.

class InlineRefs(object) {adapt(self, schema: 'dict[str, Any]') -> 'dict[str, Any]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.InputT`¶

Stability: beta

Type variable.

InputT: TypeVar

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Instrumentation`¶

Stability: beta

Emits a run-rooted trace with no per-agent wiring.

class Instrumentation(object) {run(self, run_id: 'str', **attributes: 'str') -> 'Iterator[RunSpan]'; step(self, kind: 'SpanKind', name: 'str', *, attempt: 'int' = 1, **attributes: 'str') -> 'Iterator[Span]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.InvalidRequestError`¶

Stability: beta

Raised when a provider rejected the request itself.

class InvalidRequestError(ProviderError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Invariant`¶

Stability: beta

A rule about the answer as a whole, for the ones that are not about one field.

class Invariant(Generic) {check(self, result: 'BaseModel') -> 'tuple[PolicyViolation, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.IrreversibleActionError`¶

Stability: beta

Raised when an action nothing can take back is about to run inside an unwindable scope.

class IrreversibleActionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.JSON_SCHEMA`¶

Stability: beta

Draft 2020-12 as pydantic emits it, normalised. The default.

JSON_SCHEMA: JsonSchema

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.JsonSchema`¶

Stability: beta

Draft 2020-12 as pydantic emits it, normalised. The default.

class JsonSchema(object) {adapt(self, schema: 'dict[str, Any]') -> 'dict[str, Any]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.KeyValueStore`¶

Stability: beta · Kind: Protocol

Durable key-to-value storage, for whatever a caller wants keyed.

class KeyValueStore(Protocol) {delete(self, key: 'str') -> 'None'; get(self, key: 'str') -> 'Any'; put(self, key: 'str', value: 'Any') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.KnownTaskClass`¶

Stability: beta

Exported value.

KnownTaskClass = typing.Literal['cheap', 'smart', 'reasoning']

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.LeaseLostError`¶

Stability: beta

Raised when a worker acted on a claim it no longer holds.

class LeaseLostError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.LeasePolicy`¶

Stability: beta

How long a lease lives and when its holder should renew it.

class LeasePolicy(AdkModel) {due_to_renew(self, lease: 'RunLease', *, now: 'float') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.LeaseStore`¶

Stability: beta · Kind: Protocol

Where the one-holder-at-a-time decision is made.

class LeaseStore(Protocol) {acquire(self, run_id: 'str', *, tenant: 'str', holder: 'str', ttl_seconds: 'float') -> 'RunLease'; held(self, run_id: 'str', *, tenant: 'str') -> 'RunLease | None'; release(self, lease: 'RunLease') -> 'None'; renew(self, lease: 'RunLease', *, ttl_seconds: 'float') -> 'RunLease'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.LedgerFailure`¶

Stability: beta

What a run does when the shared ledger holding a tenant ceiling is unreachable.

class LedgerFailure(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.LedgerKey`¶

Stability: beta

Whose window this is.

class LedgerKey(AdkModel) {at(self, now: 'float') -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.LintFinding`¶

Stability: beta

One thing a prompt says that a tool should decide instead.

class LintFinding(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.LintReport`¶

Stability: beta

What one run of the check found, over one prompt or a whole directory.

class LintReport(AdkModel) {summary(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.LintRule`¶

Stability: beta

One thing a prompt may not say, and what to do instead.

class LintRule(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.LoopConfig`¶

Stability: beta

How often a run may make the same call before it is treated as going nowhere.

class LoopConfig(AdkModel) {narrowed_to(self, other: 'LoopConfig | None') -> 'LoopConfig'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.LoopLimitError`¶

Stability: beta

Raised when a run hit one of the caps on its shape: how deep, how wide, how often.

class LoopLimitError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.MASK`¶

Stability: beta

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

MASK: str

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.MAX_HEADER_BYTES`¶

Stability: beta

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

MAX_HEADER_BYTES: int

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.MaxIterationsError`¶

Stability: beta

Raised when a run hit its iteration cap — the loop was bounded, and it hit the bound.

class MaxIterationsError(LoopLimitError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.McpAuthError`¶

Stability: beta

Raised when an MCP server refused the credential a call presented.

class McpAuthError(CredentialError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.McpAuthReason`¶

Stability: beta

Why an MCP server refused a call, kept apart because the three need different fixes.

class McpAuthReason(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.MediaIntakeError`¶

Stability: beta

Raised when a document or recording could not be read into text.

class MediaIntakeError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.MemoryAdmissionError`¶

Stability: beta

Raised when a fact was not allowed to become a durable memory.

class MemoryAdmissionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.MemoryConflictError`¶

Stability: beta

Raised when a supersession expected a version of a fact that is no longer live.

class MemoryConflictError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.MemoryContradictionError`¶

Stability: beta

Raised when a scope holds contradictory beliefs that nothing may resolve for it.

class MemoryContradictionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.MemoryCorruptionError`¶

Stability: beta

Raised when a stored record no longer validates as the model it was written as.

class MemoryCorruptionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.MemoryErased`¶

Stability: beta

A subject's records were erased, which downstream stores have to hear about.

class MemoryErased(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.MemoryLimitError`¶

Stability: beta

Raised when a value is larger than the adapter declared it can hold.

class MemoryLimitError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.MemoryScopeError`¶

Stability: beta

Raised when a record is filed somewhere it does not say it belongs.

class MemoryScopeError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.MemoryUnavailableError`¶

Stability: beta

Raised when a memory store could not be reached, after the retries were spent.

class MemoryUnavailableError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Message`¶

Stability: beta

One turn in a conversation.

class Message(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.MissingExtraError`¶

Stability: beta

Raised when an optional integration is used without installing its extra.

class MissingExtraError(AdkError, ImportError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.MissingTenantContextError`¶

Stability: beta

Raised when scoped work is attempted with no tenant context bound.

class MissingTenantContextError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ModelArtifactError`¶

Stability: beta

Raised when a model file on disk is not one that can be loaded.

class ModelArtifactError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ModelCapabilities`¶

Stability: beta

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/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ModelProvider`¶

Stability: beta · 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/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ModelRef`¶

Stability: beta

A model, addressable by name from configuration.

class ModelRef(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ModelRequest`¶

Stability: beta

One call to a provider, as data.

class ModelRequest(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ModelRequirements`¶

Stability: beta

What the caller needs of whatever model answers.

class ModelRequirements(AdkModel) {unsatisfied_by(self, declared: 'object') -> 'tuple[str, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ModelResponse`¶

Stability: beta

What a provider returned for one call.

class ModelResponse(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ModelResponseError`¶

Stability: beta

Raised when a provider answered with something the kit cannot read as a response.

class ModelResponseError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ModelRouter`¶

Stability: beta · Kind: Protocol

Resolves a task class and a requirement set to one concrete model.

class ModelRouter(Protocol) {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/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ModelSpec`¶

Stability: beta

A named model together with what it can do and where it may be used.

class ModelSpec(AdkModel) {with_capabilities(self, **overrides: 'object') -> 'Self'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.NEVER_RETRYABLE`¶

Stability: beta

Built-in immutable sequence.

NEVER_RETRYABLE: tuple

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.NoEligibleModelError`¶

Stability: beta

Raised when nothing the routing table offers can do the work asked of it.

class NoEligibleModelError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.NoOutput`¶

Stability: beta

The answer type of an agent that answers in prose: there is not one.

class NoOutput(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.NodeOutcome`¶

Stability: beta

How a node ended. A string enum so a log line and a span attribute agree.

class NodeOutcome(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.NodeResult`¶

Stability: beta

What one node did.

class NodeResult(Generic)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.NonDeterminismError`¶

Stability: beta

Raised when replaying a recorded history against the current code diverges.

class NonDeterminismError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.NullEventPublisher`¶

Stability: beta

The default. Publishes nowhere, so eventing is optional rather than mandatory.

class NullEventPublisher(object) {publish(self, event: 'EventEnvelope') -> 'None'; publish_batch(self, events: 'tuple[EventEnvelope, ...]') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.OneOf`¶

Stability: beta

A field that has to be one of a known set.

class OneOf(object) {check(self, result: 'BaseModel') -> 'tuple[PolicyViolation, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Origin`¶

Stability: beta

What produced a piece of content. The one input to its trust level.

class Origin(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.OutputValidationError`¶

Stability: beta

Raised when the answer does not satisfy its declared type or this tenant's rules.

class OutputValidationError(GuardrailError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Owner`¶

Stability: beta

Who answers for an agent when it misbehaves.

class Owner(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PAYLOAD_KEY`¶

Stability: beta

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

PAYLOAD_KEY: str

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PIIDetector`¶

Stability: beta · Kind: Protocol

Anything that can find identifiers in a passage.

class PIIDetector(Protocol) {detect(self, text: 'str') -> 'tuple[PIIMatch, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PIIKind`¶

Stability: beta

What kind of identifier was found. The placeholder keeps it, so reasoning survives.

class PIIKind(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PIIMatch`¶

Stability: beta

One identifier, located but not carried.

class PIIMatch(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PROMPT_SUFFIXES`¶

Stability: beta

Built-in immutable sequence.

PROMPT_SUFFIXES: tuple

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PartialErasureError`¶

Stability: beta

Raised when an erasure removed the records but could not reach a derived index.

class PartialErasureError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PatternDetector`¶

Stability: beta

A detector built from one shape, optionally checked before it is believed.

class PatternDetector(object) {detect(self, text: 'str') -> 'tuple[PIIMatch, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PayloadTooLargeError`¶

Stability: beta

Raised when an activity input or result is larger than the transport will carry.

class PayloadTooLargeError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PendingCall`¶

Stability: beta

A call the model asked for that the checkpoint could not say had finished.

class PendingCall(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PendingDecision`¶

Stability: beta

One line of somebody's 'waiting on you', carrying no argument values.

class PendingDecision(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PlanValidationError`¶

Stability: beta

Raised when a plan is not something the runtime could execute as written.

class PlanValidationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Policy`¶

Stability: beta · Kind: Protocol

A deterministic rule about a parsed answer.

class Policy(Protocol) {check(self, result: 'BaseModel') -> 'tuple[PolicyViolation, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PolicyReport`¶

Stability: beta

Kept for the caller that asked what was violated, without what was answered.

class PolicyReport(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PolicyViolation`¶

Stability: beta

One rule an answer broke.

class PolicyViolation(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PoolExhaustedError`¶

Stability: beta

Raised when every connection to a provider was in use and none came free in time.

class PoolExhaustedError(ProviderError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PrefixDriftError`¶

Stability: beta

Raised when the frozen part of a prompt is not what was frozen.

class PrefixDriftError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Principal`¶

Stability: beta

Who a run acts for, and what they were granted.

class Principal(AdkModel) {delegating(self, *, until: 'float', scopes: 'Iterable[str] | None' = None) -> 'Self'; expired(self, now: 'float') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PromptDefinition`¶

Stability: beta

One published version of one prompt.

class PromptDefinition(AdkModel) {fits(self, window_tokens: 'int', *, share: 'float' = 0.5) -> 'bool'; instruct(self, agent: 'Agent[OutputT]') -> 'Agent[OutputT]'; instruct_typed(self, agent: 'TypedAgent[InputT, OutputT]') -> 'TypedAgent[InputT, OutputT]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PromptNotFoundError`¶

Stability: beta

Raised when a prompt name, version or alias does not exist in the registry.

class PromptNotFoundError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PromptRef`¶

Stability: beta

What a run and its spans record about the prompt that produced them.

class PromptRef(AdkModel) {attributes(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PromptRegistry`¶

Stability: beta · Kind: Protocol

Where prompt text is read from. The protocol is the stable surface.

class PromptRegistry(Protocol) {get(self, name: 'str', *, version: 'str' = '', alias: 'str' = '', tenant: 'str' = '') -> 'PromptDefinition'; list_versions(self, name: 'str', *, tenant: 'str' = '') -> 'tuple[str, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PromptRejectedError`¶

Stability: beta

Raised when a stored prompt exists but may not be served.

class PromptRejectedError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PromptTemplate`¶

Stability: beta

A prompt body whose every slot is declared, typed and checked before it renders.

class PromptTemplate(AdkModel) {render(self, values: 'Mapping[str, object]', *, window_tokens: 'int' = 0) -> 'Rendered'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ProtocolConformanceError`¶

Stability: beta

Raised when an object does not provide every member of a protocol.

class ProtocolConformanceError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Provenance`¶

Stability: beta

Where one resolved key came from, and what it beat.

class Provenance(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ProvenanceLostError`¶

Stability: beta

Raised when compacting a conversation would drop a source it was carrying.

class ProvenanceLostError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ProvidedSecrets`¶

Stability: beta

A SecretProvider — the kit's synchronous lookup — read as a SecretResolver.

class ProvidedSecrets(object) {resolve(self, ref: 'SecretRef') -> 'SecretStr'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ProviderConfig`¶

Stability: beta

Where the model provider lives and how long to wait for it.

class ProviderConfig(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ProviderError`¶

Stability: beta

Raised when a model provider fails, in the kit's own vocabulary.

class ProviderError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ProviderName`¶

Stability: beta

Exported value.

ProviderName = typing.Literal['anthropic', 'gemini', 'grok', 'groq', 'llama.cpp', 'ollama', 'openai', 'openai-compatible', 'openrouter', 'tgi', 'vllm', 'xai']

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ProviderTimeoutError`¶

Stability: beta

Raised when a provider did not answer inside the deadline.

class ProviderTimeoutError(ProviderError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ProviderUnavailableError`¶

Stability: beta

Raised when a provider could not be reached, or was reached and was not ready.

class ProviderUnavailableError(ProviderError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.PublishReport`¶

Stability: beta

What became of a batch.

class PublishReport(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.QueuePolicy`¶

Stability: beta

How long a claim lasts, how often it may be retried, and how long it waits.

class QueuePolicy(AdkModel) {backoff_for(self, attempts: 'int') -> 'float'; claimed(self, item: 'WorkItem', *, worker: 'str', now: 'float', lease_seconds: 'float | None' = None) -> 'WorkItem'; completed(self, item: 'WorkItem') -> 'WorkItem'; exhausted(self, attempts: 'int') -> 'bool'; overheld(self, item: 'WorkItem', now: 'float') -> 'bool'; renewed(self, item: 'WorkItem', *, now: 'float') -> 'WorkItem'; returned(self, item: 'WorkItem', *, error: 'str', now: 'float', retryable: 'bool' = True, backoff: 'bool' = True) -> 'WorkItem'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.QueueStats`¶

Stability: beta

What the queue looks like right now, for the metrics a deployment alerts on.

class QueueStats(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.QueueUnavailableError`¶

Stability: beta

Raised when a work queue could not be reached.

class QueueUnavailableError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.REASONING`¶

Stability: beta

The kind of work, named rather than the model that does it.

REASONING: TaskClass

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RESERVED_ACTION_CLASS`¶

Stability: beta

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

RESERVED_ACTION_CLASS: str

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RULES`¶

Stability: beta

Built-in immutable sequence.

RULES: tuple

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RateLimitError`¶

Stability: beta

Raised when a provider refused the call because too many were made.

class RateLimitError(ProviderError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ReasoningDelta`¶

Stability: beta

More of the model's own working out.

class ReasoningDelta(StreamEvent)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Recording`¶

Stability: beta

One finished span.

class Recording(object) {exported(self, run_id: 'str') -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RecursionLimitError`¶

Stability: beta

Raised when a run was called from too deep a chain of agents calling agents.

class RecursionLimitError(LoopLimitError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Redacted`¶

Stability: beta

What a passage became, and what was taken out of it.

class Redacted(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RedactionConfig`¶

Stability: beta

Redaction applied before anything is logged or exported.

class RedactionConfig(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RejectedCandidate`¶

Stability: beta

A model the router passed over, and what it could not do.

class RejectedCandidate(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Rendered`¶

Stability: beta

One rendered prompt, and what may be said about it without quoting it.

class Rendered(AdkModel) {attributes(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RepairConfig`¶

Stability: beta

How many times an answer that did not validate may be sent back with the reason.

class RepairConfig(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RepeatedCallError`¶

Stability: beta

Raised when the same tool was asked for with the same arguments past the threshold.

class RepeatedCallError(LoopLimitError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RequiresCitation`¶

Stability: beta

An assertion drawn from retrieved content has to say where it came from.

class RequiresCitation(object) {check(self, result: 'BaseModel') -> 'tuple[PolicyViolation, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Reservation`¶

Stability: beta

An allowance held while a run spends it.

class Reservation(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ResolvedBudget`¶

Stability: beta

The effective ceiling, and which scope each dimension of it came from.

class ResolvedBudget(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ResumeConflictError`¶

Stability: beta

Raised when another worker is already carrying this run on.

class ResumeConflictError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ResumePlan`¶

Stability: beta

What carrying a run on would involve, decided before anything is carried on.

class ResumePlan(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Resumption`¶

Stability: beta

What a resume concluded about one outstanding call.

class Resumption(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RetrievalDegradedError`¶

Stability: beta

Raised when retrieval could not run every branch the caller required.

class RetrievalDegradedError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RetryConfig`¶

Stability: beta

When a failed attempt is worth making again, and how long to wait first.

class RetryConfig(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Reversal`¶

Stability: beta

One attempt at taking one applied action back.

class Reversal(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ReversalOutcome`¶

Stability: beta

What happened when one applied action was taken back.

class ReversalOutcome(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Revocation`¶

Stability: beta

Authority being taken back, by one grant, one class, or one tenant outright.

class Revocation(AdkModel) {covers(self, grant: 'AutonomyGrant') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Role`¶

Stability: beta

Exported value.

Role = typing.Literal['system', 'user', 'assistant', 'tool']

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RoutingDecision`¶

Stability: beta

Which model answered a task class, and why that one.

class RoutingDecision(AdkModel) {explain(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Run`¶

Stability: beta

One execution of an agent, from prompt assembly to a terminal state.

class Run(AdkModel, Generic) {record(self, usage: 'Usage') -> 'Self'; record_event(self, event: 'RunEvent') -> 'Self'; transition_to(self, state: 'RunState', *, at: 'float | None' = None) -> 'Self'; with_output(self, output: 'OutputT') -> 'Self'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RunBudget`¶

Stability: beta

The ceiling for one run, enforced before the spend rather than reported after it.

class RunBudget(object) {check(self) -> 'BudgetDecision'; child(self) -> 'RunBudget'; limits(self) -> 'BudgetLimits'; record(self, usage: 'Usage', *, model_calls: 'int' = 0, tool_calls: 'int' = 0, iterations: 'int' = 0, peer_invocations: 'int' = 0) -> 'None'; reserve(self, estimate: 'int') -> 'None'; sliced(self, limits: 'BudgetLimits') -> 'RunBudget'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RunCancelled`¶

Stability: beta

A run stopped because something asked it to.

class RunCancelled(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RunCompleted`¶

Stability: beta

A run finished on its own terms.

class RunCompleted(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RunContext`¶

Stability: beta

What the runtime threads through every layer of a run.

class RunContext(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RunEvent`¶

Stability: beta

One thing that happened during a run, in the order it happened.

class RunEvent(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RunEventKind`¶

Stability: beta

What happened. One kind per thing the loop does, so a filter is exact.

class RunEventKind(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RunFailed`¶

Stability: beta

A run ended in a failure.

class RunFailed(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RunGrant`¶

Stability: beta

What a run was allowed to do, so a run below it can be allowed no more.

class RunGrant(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RunLease`¶

Stability: beta

One worker's claim on one run, for a bounded time.

class RunLease(AdkModel) {held_at(self, now: 'float') -> 'bool'; superseded_by(self, other: 'RunLease') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RunLeaseError`¶

Stability: beta

Raised when a worker tries to advance a run it does not hold the lease on.

class RunLeaseError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RunRecord`¶

Stability: beta

A run as a store holds it: far enough along to be resumed, and no further.

class RunRecord(AdkModel) {scrubbed(self) -> 'Self'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RunSpan`¶

Stability: beta

The root span, plus the trace it collected once the run is over.

class RunSpan(Span)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RunStarted`¶

Stability: beta

A run began.

class RunStarted(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RunState`¶

Stability: beta

Where a run is, and if it is over, why.

class RunState(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.RunningLoopError`¶

Stability: beta

Raised when a synchronous helper is called from inside a running event loop.

class RunningLoopError(AdkError, RuntimeError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SENSITIVE_SHAPES`¶

Stability: beta

Built-in immutable sequence.

SENSITIVE_SHAPES: tuple

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SEPARATOR`¶

Stability: beta

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

SEPARATOR: str

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SMART`¶

Stability: beta

The kind of work, named rather than the model that does it.

SMART: TaskClass

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SPAN_NAMES`¶

Stability: beta

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/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.STATE_REGISTRY`¶

Stability: beta

Which version each kind is written at, and how to read the versions before it.

STATE_REGISTRY: StateRegistry

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.STRICT_SUBSET`¶

Stability: beta

Every object closed, for providers whose structured-output mode demands it.

STRICT_SUBSET: StrictSubset

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SUPPORTED_WINDOW`¶

Stability: beta

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

SUPPORTED_WINDOW: int

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Sampling`¶

Stability: beta

Which runs are exported.

class Sampling(AdkModel) {keeps(self, run_id: 'str') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SandboxError`¶

Stability: beta

Raised when the sandbox stopped generated code, rather than the code stopping itself.

class SandboxError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SandboxMemoryError`¶

Stability: beta

Raised when generated code asked for more memory than its ceiling allowed.

class SandboxMemoryError(SandboxError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SandboxTimeoutError`¶

Stability: beta

Raised when generated code ran past a time ceiling and was killed.

class SandboxTimeoutError(SandboxError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SchemaDialect`¶

Stability: beta · Kind: Protocol

What one provider will accept, as a transformation and a list of refusals.

class SchemaDialect(Protocol) {adapt(self, schema: 'dict[str, Any]') -> 'dict[str, Any]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SchemaGenerationError`¶

Stability: beta

Raised when a type cannot be faithfully described as a schema.

class SchemaGenerationError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SchemaViolationError`¶

Stability: beta

Raised when a payload does not match the type declared for that boundary.

class SchemaViolationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ScopeEscalationError`¶

Stability: beta

Raised when a sub-agent asked to hold access the agent it acts for does not hold.

class ScopeEscalationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ScopeSet`¶

Stability: beta

A set of scopes that can be narrowed and never widened.

class ScopeSet(object) {missing(self, required: 'Iterable[str]') -> 'tuple[str, ...]'; narrowed_to(self, other: 'ScopeSet') -> 'ScopeSet'; permits(self, scope: 'str') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ScopeViolationError`¶

Stability: beta

Raised when an operator action would reach across a tenant boundary.

class ScopeViolationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ScopedLimits`¶

Stability: beta

One set of limits and where it was attached.

class ScopedLimits(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SecretProvider`¶

Stability: beta · Kind: Protocol

Where a credential is looked up, asked once per use rather than once per process.

class SecretProvider(Protocol) {secret(self, name: 'str') -> 'str | None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SecretRef`¶

Stability: beta

The name of a secret, never the secret.

class SecretRef(AdkModel) {describe(self) -> 'str'; for_tenant(self, tenant: 'str') -> 'Self'; resolve(self, secrets: 'SecretProvider') -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SecretResolutionError`¶

Stability: beta

Raised when a credential could not be fetched for the reference that names it.

class SecretResolutionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SecretResolver`¶

Stability: beta · Kind: Protocol

Where a SecretRef is turned into a value, asked at the point of use.

class SecretResolver(Protocol) {resolve(self, ref: 'SecretRef') -> 'SecretStr'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Sensitive`¶

Stability: beta

Marks a field that must not reach telemetry.

class Sensitive(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SessionRecord`¶

Stability: beta

A conversation across runs, as a store holds it.

class SessionRecord(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Severity`¶

Stability: beta

Exported value.

Severity = typing.Literal['error', 'warning']

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SignalKind`¶

Stability: beta

What a screener recognised. Named, because "suspicious" is not actionable.

class SignalKind(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Span`¶

Stability: beta

A span while it is open. Setting anything on it is a dictionary write, never I/O.

class Span(object) {first_token(self) -> 'None'; iterated(self, count: 'int' = 1) -> 'None'; set(self, **attributes: 'str') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SpanKind`¶

Stability: beta

What a span covers. One kind per stage a run can spend time in.

class SpanKind(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SpanLimits`¶

Stability: beta

Bounds on what one run may record.

class SpanLimits(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SpanStatus`¶

Stability: beta

How a span ended.

class SpanStatus(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SpendLedger`¶

Stability: beta · Kind: Protocol

Where a shared ceiling is actually enforced.

class SpendLedger(Protocol) {forget(self, tenant: 'str') -> 'WindowSpend'; read_window(self, key: 'LedgerKey') -> 'WindowSpend'; reconcile(self) -> 'int'; record_progress(self, reservation: 'Reservation', spent: 'Decimal') -> 'None'; release(self, reservation: 'Reservation') -> 'None'; reserve(self, key: 'LedgerKey', amount: 'Decimal', *, ceiling: 'Decimal', lease_seconds: 'float' = Ellipsis) -> 'Reservation'; settle(self, reservation: 'Reservation', actual: 'Decimal') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StateConflictError`¶

Stability: beta

Raised when a state write named a version that has since moved.

class StateConflictError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StateDelta`¶

Stability: beta

Amounts to add to a run, never values to set.

class StateDelta(AdkModel) {applied_to(self, record: 'RunRecord') -> 'RunRecord'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StateInUseError`¶

Stability: beta

Raised when deleting a session would orphan runs that have not finished.

class StateInUseError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StateKey`¶

Stability: beta

Whose record, and which one.

class StateKey(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StateKind`¶

Stability: beta

A thing the kit persists. Migrations are registered per kind, not per store.

class StateKind(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StateMigration`¶

Stability: beta

One version step, applied on read.

class StateMigration(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StateMigrationError`¶

Stability: beta

Raised when persisted state could not be brought forward into a record.

class StateMigrationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StateNotFoundError`¶

Stability: beta

Raised when a patch or a resume named state that is not there.

class StateNotFoundError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StatePage`¶

Stability: beta

One page of runs, and where the next one starts.

class StatePage(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StatePersistenceError`¶

Stability: beta

Raised when a state store could not take a write, or could not be reached.

class StatePersistenceError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StateQuery`¶

Stability: beta

Which runs to list, for operator tooling and for whatever reaps abandoned work.

class StateQuery(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StateRegistry`¶

Stability: beta

Which version each kind is written at, and how to read the versions before it.

class StateRegistry(object) {oldest(self, kind: 'str') -> 'int'; register(self, migration: 'StateMigration') -> 'None'; upgraded(self, envelope: 'Envelope') -> 'Envelope'; version(self, kind: 'str') -> 'int'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StateStore`¶

Stability: beta · Kind: Protocol

Where session and run state lives, for agents running in more than one process.

class StateStore(Protocol) {delete_run(self, key: 'StateKey') -> 'None'; delete_session(self, key: 'StateKey', *, cascade: 'bool' = False) -> 'None'; get_run(self, key: 'StateKey') -> 'RunRecord | None'; get_session(self, key: 'StateKey') -> 'SessionRecord | None'; list_runs(self, query: 'StateQuery') -> 'StatePage'; patch_run(self, key: 'StateKey', delta: 'StateDelta') -> 'RunRecord'; put_run(self, record: 'RunRecord') -> 'RunRecord'; put_session(self, record: 'SessionRecord') -> 'SessionRecord'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StopReason`¶

Stability: beta

Why a model stopped generating, in the kit's words rather than a vendor's.

class StopReason(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StoreConfig`¶

Stability: beta

Endpoints for the optional stores. Absent means the integration is not in use.

class StoreConfig(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StreamAccumulator`¶

Stability: beta

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/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StreamEnd`¶

Stability: beta

The last event, carrying the assembled answer.

class StreamEnd(StreamEvent)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StreamEvent`¶

Stability: beta

Base for every event a provider may emit while an answer is being generated.

class StreamEvent(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StreamInterruptedError`¶

Stability: beta

Raised when a stream stopped before the model had finished answering.

class StreamInterruptedError(ProviderError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.StrictSubset`¶

Stability: beta

Every object closed, for providers whose structured-output mode demands it.

class StrictSubset(object) {adapt(self, schema: 'dict[str, Any]') -> 'dict[str, Any]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SuspendedRun`¶

Stability: beta

A run stopped on a question, and everything needed to carry it on.

class SuspendedRun(AdkModel) {expired_by(self, now: 'float') -> 'bool'; held_for(self, now: 'float') -> 'float'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.SuspensionStore`¶

Stability: beta · Kind: Protocol

Where stopped runs wait, keyed by run and reachable by token digest.

class SuspensionStore(Protocol) {attempted(self, attempt: 'TokenAttempt') -> 'None'; by_token(self, token_digest: 'str', *, tenant: 'str') -> 'SuspendedRun | None'; forget(self, run_id: 'str', *, tenant: 'str') -> 'None'; get(self, run_id: 'str', *, tenant: 'str') -> 'SuspendedRun | None'; pending(self, *, tenant: 'str') -> 'tuple[SuspendedRun, ...]'; put(self, suspended: 'SuspendedRun') -> 'None'; spend(self, run_id: 'str', *, tenant: 'str') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TRUST_BY_ORIGIN`¶

Stability: beta

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)

TRUST_BY_ORIGIN: dict

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TaskClass`¶

Stability: beta

The kind of work, named rather than the model that does it.

class TaskClass(str)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TelemetryConfig`¶

Stability: beta

OpenTelemetry export. Case content is never an attribute; see docs/contributing.md.

class TelemetryConfig(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TelemetryLoss`¶

Stability: beta

What was not exported, counted locally.

class TelemetryLoss(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TemplateError`¶

Stability: beta

Raised when a prompt template, or a value for one, may not be rendered.

class TemplateError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TenantConfig`¶

Stability: beta

One tenant's entitlement, as it is stored and as it arrives.

class TenantConfig(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TenantConfigProvider`¶

Stability: beta · Kind: Protocol

Where tenant configuration is read from.

class TenantConfigProvider(Protocol) {config_for(self, tenant: 'str') -> 'TenantConfig'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TenantContext`¶

Stability: beta

The isolation boundary the work in hand belongs to.

class TenantContext(AdkModel) {acting_as(self, user: 'str') -> 'Self'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TenantContextError`¶

Stability: beta

Raised when a tenant context arriving from elsewhere cannot be trusted or read.

class TenantContextError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TenantCrossingError`¶

Stability: beta

Raised when a scope names a different tenant than the one it was entered from.

class TenantCrossingError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TenantIsolationError`¶

Stability: beta

Raised when stored data does not belong to the tenant the work is bound to.

class TenantIsolationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TenantLedger`¶

Stability: beta · Kind: Protocol

Where a ceiling wider than one run is kept.

class TenantLedger(Protocol) {consume(self, tenant: 'str', window: 'str', spent: 'Consumed') -> 'Consumed'; total(self, tenant: 'str', window: 'str') -> 'Consumed'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TenantLimitError`¶

Stability: beta

Raised when a tenant's configuration does not permit what was asked for.

class TenantLimitError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TenantLimits`¶

Stability: beta

What one tenant may spend, reach and keep.

class TenantLimits(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TenantPolicy`¶

Stability: beta

The resolved entitlement, bound for the work it applies to.

class TenantPolicy(AdkModel) {budget_scope(self) -> 'ScopedLimits | None'; check_model(self, model: 'str') -> 'None'; check_region(self, region: 'str') -> 'None'; check_tool(self, name: 'str') -> 'None'; model_for(self, task_class: 'str') -> 'str | None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TenantRefusal`¶

Stability: beta

Type alias.

TenantRefusal: TypeAliasType

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TenantUnconfiguredError`¶

Stability: beta

Raised when a tenant's configuration exists somewhere but could not be read.

class TenantUnconfiguredError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TextDelta`¶

Stability: beta

More of the answer. Concatenating every delta in arrival order gives the content.

class TextDelta(StreamEvent)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TextPart`¶

Stability: beta

Text in a message.

class TextPart(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Thresholds`¶

Stability: beta

The severity at which each category is refused, for one tenant.

class Thresholds(AdkModel) {bar_for(self, category: 'ContentCategory') -> 'ContentSeverity'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TokenAttempt`¶

Stability: beta

Somebody presenting a token, and what came of it.

class TokenAttempt(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TokenRedeemer`¶

Stability: beta · Kind: Protocol

A gate that can turn a token back into the run it stopped.

class TokenRedeemer(Protocol) {redeem(self, token: 'str', *, tenant: 'str', presented_by: 'str') -> 'SuspendedRun'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolAllowlist`¶

Stability: beta

The tools a run may call, resolved once and immutable for its lifetime.

class ToolAllowlist(object) {check(self, name: 'str') -> 'None'; decide(self, name: 'str') -> 'ToolDecision'; narrowed(self, declared: 'Iterable[str]', *, agent: 'str' = '') -> 'Self'; permits(self, name: 'str') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolArgumentValidationError`¶

Stability: beta

Raised when a model's tool-call arguments do not match the tool's own schema.

class ToolArgumentValidationError(SchemaViolationError) {feedback(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolCall`¶

Stability: beta

A model's request to run a tool.

class ToolCall(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolCallCompleted`¶

Stability: beta

A tool call came back, one way or another.

class ToolCallCompleted(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolCallDelta`¶

Stability: beta

Part of one tool call. Vendors send the arguments as JSON text, a fragment at a time.

class ToolCallDelta(StreamEvent)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolCallRequested`¶

Stability: beta

A tool call was about to go out.

class ToolCallRequested(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolDecision`¶

Stability: beta

One dispatch decision, as it is recorded.

class ToolDecision(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolDeclaration`¶

Stability: beta

A tool as the model is told about it.

class ToolDeclaration(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolDefinitionError`¶

Stability: beta

Raised when a callable cannot be made into a tool.

class ToolDefinitionError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolDisposition`¶

Stability: beta

What a resume concluded about one outstanding call.

class ToolDisposition(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolError`¶

Stability: beta

Base of the tool taxonomy: something the run loop can branch on.

class ToolError(AdkError)

Typed errors: ValueError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolExecutionError`¶

Stability: beta

Raised when a tool fails. The tool's own exception is the __cause__.

class ToolExecutionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolFailure`¶

Stability: beta

The tool tried and could not finish.

class ToolFailure(ToolError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolFailurePolicy`¶

Stability: beta

What a run does when a tool it called fails.

class ToolFailurePolicy(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolNotFoundError`¶

Stability: beta

Raised when nothing is registered under the name that was asked for.

class ToolNotFoundError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolNotPermittedError`¶

Stability: beta

Raised when a tool exists but this agent's allowlist does not name it.

class ToolNotPermittedError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolRefusal`¶

Stability: beta

The tool worked and declined. An answer, not a fault.

class ToolRefusal(ToolError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolRegistry`¶

Stability: beta · Kind: Protocol

The set of tools an agent may call, and their declared schemas.

class ToolRegistry(Protocol) {declarations(self) -> 'Any'; invoke(self, name: 'str', arguments: 'Any') -> 'Any'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolResultError`¶

Stability: beta

Raised when what a tool returned may not cross into the run as it stands.

class ToolResultError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ToolTimedOutError`¶

Stability: beta

Raised when one tool call outran the ceiling declared for that tool.

class ToolTimedOutError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Trace`¶

Stability: beta

Everything one run recorded.

class Trace(object) {of_kind(self, kind: 'SpanKind') -> 'tuple[Recording, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Tracer`¶

Stability: beta · Kind: Protocol

Sideband emission of spans and events.

class Tracer(Protocol) {event(self, name: 'str', **attributes: 'Any') -> 'None'; span(self, name: 'str', **attributes: 'Any') -> 'Any'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TrustBoundary`¶

Stability: beta

Where a model sits, on the axes a fallback may not cross.

class TrustBoundary(AdkModel) {admits(self, other: 'TrustBoundary') -> 'bool'; differs_from(self, other: 'TrustBoundary') -> 'tuple[str, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TrustBoundaryError`¶

Stability: beta

Raised when the only model left to try sits outside the run's trust boundary.

class TrustBoundaryError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TrustLevel`¶

Stability: beta

How far content may act, decided by where it came from.

class TrustLevel(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TypedAgent`¶

Stability: beta

An agent with an application input type in addition to its output type.

class TypedAgent(Agent, Generic) {render_input(self, value: 'InputT') -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.TypedAgentDefinition`¶

Stability: beta

A reviewed definition for a TypedAgent input and output contract.

class TypedAgentDefinition(AgentDefinition, Generic)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.UncitedClaimError`¶

Stability: beta

Raised when a claim carries no citation at all.

class UncitedClaimError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.UngroundedCitationError`¶

Stability: beta

Raised when an answer cites something the run did not retrieve.

class UngroundedCitationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.UnknownEventTypeError`¶

Stability: beta

Raised when an event names a type this kit has no schema for.

class UnknownEventTypeError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.UnknownTenantError`¶

Stability: beta

Raised when work arrives for a tenant nothing is configured for.

class UnknownTenantError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.UnlimitedBudget`¶

Stability: beta

No ceiling at all, which is a thing somebody has to write down.

class UnlimitedBudget(object) {check(self) -> 'BudgetDecision'; child(self) -> 'UnlimitedBudget'; limits(self) -> 'BudgetLimits'; record(self, usage: 'Usage', *, model_calls: 'int' = 0, tool_calls: 'int' = 0, iterations: 'int' = 0, peer_invocations: 'int' = 0) -> 'None'; reserve(self, estimate: 'int') -> 'None'; sliced(self, limits: 'BudgetLimits') -> 'UnlimitedBudget'}

Typed errors: ValueError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.UnsupportedEventVersionError`¶

Stability: beta

Raised when an event's schema version is outside the window this kit can read.

class UnsupportedEventVersionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.UnsupportedStateVersionError`¶

Stability: beta

Raised when persisted state was written at a version this build cannot read.

class UnsupportedStateVersionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Upcaster`¶

Stability: beta

Type alias.

Upcaster: TypeAliasType

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Usage`¶

Stability: beta

What one step consumed, and what it cost if the cost is knowable.

class Usage(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.UsageDelta`¶

Stability: beta

The running total, as the provider reports it. Later events replace earlier ones.

class UsageDelta(StreamEvent)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.VERSION`¶

Stability: beta

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

VERSION: str

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Variable`¶

Stability: beta

One slot a template declares, and what may go in it.

class Variable(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.Window`¶

Stability: beta

The period a ceiling applies over.

class Window(AdkModel) {bucket(self, now: 'float') -> 'int'; opened_at(self, now: 'float') -> 'float'; resets_at(self, now: 'float') -> 'float'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.WindowKind`¶

Stability: beta

How a window's boundary is decided.

class WindowKind(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.WindowSpend`¶

Stability: beta

What a window holds right now.

class WindowSpend(AdkModel) {remaining(self, ceiling: 'Decimal') -> 'Decimal'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.WorkItem`¶

Stability: beta

One unit of work, as the queue holds it.

class WorkItem(AdkModel) {lapsed_at(self, now: 'float') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.WorkItemNotFoundError`¶

Stability: beta

Raised when a queue operation named an item the queue does not hold.

class WorkItemNotFoundError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.WorkPriority`¶

Stability: beta

How soon an item is claimed relative to its tenant's other work.

class WorkPriority(IntEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.WorkQueue`¶

Stability: beta · Kind: Protocol

Where work waits for a worker, and what becomes of it when one dies holding it.

class WorkQueue(Protocol) {adopt(self, *, worker: 'str') -> 'tuple[WorkItem, ...]'; claim(self, *, worker: 'str', queue: 'str' = 'default', lease_seconds: 'float | None' = None) -> 'WorkItem | None'; complete(self, item_id: 'str', *, tenant: 'str', worker: 'str') -> 'WorkItem'; dead_letters(self, *, tenant: 'str', limit: 'int' = 50) -> 'tuple[WorkItem, ...]'; enqueue(self, item: 'WorkItem') -> 'WorkItem'; fail(self, item_id: 'str', *, tenant: 'str', worker: 'str', error: 'str', retryable: 'bool' = True) -> 'WorkItem'; heartbeat(self, item_id: 'str', *, tenant: 'str', worker: 'str') -> 'WorkItem'; reap(self) -> 'tuple[WorkItem, ...]'; stats(self, *, queue: 'str' = 'default') -> 'QueueStats'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.WorkState`¶

Stability: beta

Where an item is.

class WorkState(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.WorkersBusyError`¶

Stability: beta

Raised when a synchronous body could not be given a worker in time.

class WorkersBusyError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.WriteQueueFullError`¶

Stability: beta

Raised when an asynchronous write cannot be accepted because the queue is full.

class WriteQueueFullError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.activities.ActivityClass`¶

Stability: beta

What kind of work an activity does, which is what its numbers follow from.

class ActivityClass(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.activities.ActivityPolicy`¶

Stability: beta

The numbers one activity runs under.

class ActivityPolicy(AdkModel) {attempts_for(self, idempotency: 'IdempotencyPolicy | None', *, keyed: 'bool' = False) -> 'int'; backoff(self, seconds: 'float', *, elapsed: 'float') -> 'Backoff'; retryable(self, failure: 'BaseException') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.activities.Backoff`¶

Stability: beta

How long to wait, and whether the wait was cut to fit inside the activity.

class Backoff(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.activities.DEFAULT_ACTIVITY_POLICIES`¶

Stability: beta

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)

DEFAULT_ACTIVITY_POLICIES: dict

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.activities.Heartbeat`¶

Stability: beta

Progress from a running activity. Never a result, and never part of one.

class Heartbeat(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.activities.NEVER_RETRYABLE`¶

Stability: beta

Built-in immutable sequence.

NEVER_RETRYABLE: tuple

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.agent.Agent`¶

Stability: beta

A declarative description of an agent.

class Agent(AdkModel, Generic)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.agent.ToolFailurePolicy`¶

Stability: beta

What a run does when a tool it called fails.

class ToolFailurePolicy(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.agent.TypedAgent`¶

Stability: beta

An agent with an application input type in addition to its output type.

class TypedAgent(Agent, Generic) {render_input(self, value: 'InputT') -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.arguments_digest`¶

Stability: beta

A stable fingerprint of what a call was given, safe to keep next to its key.

def arguments_digest(arguments: 'Mapping[str, JsonValue]') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.arriving`¶

Stability: beta

Bind the incoming message's tenant for the length of handling it.

def arriving(headers: 'Mapping[str, str]', *, authenticated: 'str | None' = None) -> 'Iterator[TenantContext]'

Typed errors: TenantContextError, TenantCrossingError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.audit.AuditDecision`¶

Stability: beta

What was decided about one attempted action.

class AuditDecision(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.audit.AuditEvent`¶

Stability: beta

One decision about one attempted action, as it is stored.

class AuditEvent(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.audit.AuditSink`¶

Stability: beta · Kind: Protocol

Where decisions are appended, and read back by whoever is accountable for them.

class AuditSink(Protocol) {append(self, event: 'AuditEvent') -> 'AuditEvent'; pseudonymise(self, *, tenant: 'str', subject: 'str') -> 'int'; records(self, *, tenant: 'str', since: 'float' = 0.0, until: 'float | None' = None, decision: 'AuditDecision | None' = None) -> 'tuple[AuditEvent, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.audit.digest_of_arguments`¶

Stability: beta

The digest an audit record carries in place of the payload.

def digest_of_arguments(arguments: 'Mapping[str, Any]', *, extra_patterns: 'Sequence[str]' = ()) -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.audit.pseudonym`¶

Stability: beta

A stable stand-in for a person, for an audit record that outlives their consent.

def pseudonym(subject: 'str', *, salt: 'str' = '') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.autonomy.ActionClass`¶

Stability: beta

A named class of side effect, and where in a call's arguments its money is.

class ActionClass(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.autonomy.ActionRegistry`¶

Stability: beta

Which action class each tool belongs to.

class ActionRegistry(object) {named(self, action_class: 'str') -> 'ActionClass | None'; of(self, tool: 'str') -> 'ActionClass | None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.autonomy.ActionRequest`¶

Stability: beta

One action an agent wants to take, and what the runtime knows about it.

class ActionRequest(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.autonomy.AutonomyDecision`¶

Stability: beta

What the ladder decided, and what has to be recorded about it.

class AutonomyDecision(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.autonomy.AutonomyGrant`¶

Stability: beta

Permission to act unattended, issued by somebody, expiring by itself.

class AutonomyGrant(AdkModel) {covers(self, *, tenant: 'str', user: 'str | None', now: 'float') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.autonomy.AutonomyLadder`¶

Stability: beta

Resolves one attempted action against the grants that cover it.

class AutonomyLadder(object) {amount_in(self, tool: 'str', arguments: 'Mapping[str, Any]') -> 'Decimal | None'; classify(self, tool: 'str') -> 'str | None'; decide(self, request: 'ActionRequest') -> 'AutonomyDecision'; validate_grants(self) -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.autonomy.AutonomyLevel`¶

Stability: beta

How far a grant lets an agent go before a human is involved.

class AutonomyLevel(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.autonomy.AutonomyOutcome`¶

Stability: beta

What the ladder decided about one attempted action.

class AutonomyOutcome(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.autonomy.Ceiling`¶

Stability: beta

How much a grant covers, in what, over what window.

class Ceiling(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.autonomy.CommitmentLedger`¶

Stability: beta · Kind: Protocol

What a tenant has already committed against an action class in a window.

class CommitmentLedger(Protocol) {committed(self, *, tenant: 'str', action_class: 'str', window_seconds: 'float') -> 'Decimal'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.autonomy.GrantIssuer`¶

Stability: beta · Kind: Protocol

Issuing and withdrawing autonomy, which only a human or system identity does.

class GrantIssuer(Protocol) {issue(self, grant: 'AutonomyGrant') -> 'AutonomyGrant'; revoke(self, revocation: 'Revocation') -> 'Revocation'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.autonomy.GrantReader`¶

Stability: beta · Kind: Protocol

What the runtime is allowed to know about grants: what is live, and nothing more.

class GrantReader(Protocol) {grants_for(self, *, tenant: 'str', action_class: 'str') -> 'Sequence[AutonomyGrant]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.autonomy.InFlightPolicy`¶

Stability: beta

What happens to a run that is already under way when its grant is withdrawn.

class InFlightPolicy(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.autonomy.InMemoryGrants`¶

Stability: beta

Grants in a dict, for tests and single-process deployments.

class InMemoryGrants(object) {all_grants(self) -> 'Sequence[AutonomyGrant]'; grants_for(self, *, tenant: 'str', action_class: 'str') -> 'Sequence[AutonomyGrant]'; issue(self, grant: 'AutonomyGrant') -> 'AutonomyGrant'; revoke(self, revocation: 'Revocation') -> 'Revocation'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.autonomy.RESERVED_ACTION_CLASS`¶

Stability: beta

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

RESERVED_ACTION_CLASS: str

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.autonomy.Revocation`¶

Stability: beta

Authority being taken back, by one grant, one class, or one tenant outright.

class Revocation(AdkModel) {covers(self, grant: 'AutonomyGrant') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.bound`¶

Stability: beta

Wrap call so it runs under the context bound now, wherever it runs later.

def bound(call: 'Callable[ArgsT, ResultT]') -> 'Callable[ArgsT, ResultT]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.budget.BudgetDecision`¶

Stability: beta

Whether there is room left, and where there is not.

class BudgetDecision(AdkModel) {as_error(self) -> 'BudgetExceededError'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.budget.BudgetLimits`¶

Stability: beta

A ceiling, in every dimension a run can run away in.

class BudgetLimits(AdkModel) {filled(self) -> 'Self'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.budget.BudgetScope`¶

Stability: beta

Where a set of limits was attached, which is how the effective one is attributed.

class BudgetScope(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.budget.Consumed`¶

Stability: beta

What has been spent against a ceiling so far.

class Consumed(AdkModel) {against(self, name: 'str') -> 'Decimal'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.budget.LedgerFailure`¶

Stability: beta

What a run does when the shared ledger holding a tenant ceiling is unreachable.

class LedgerFailure(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.budget.ResolvedBudget`¶

Stability: beta

The effective ceiling, and which scope each dimension of it came from.

class ResolvedBudget(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.budget.RunBudget`¶

Stability: beta

The ceiling for one run, enforced before the spend rather than reported after it.

class RunBudget(object) {check(self) -> 'BudgetDecision'; child(self) -> 'RunBudget'; limits(self) -> 'BudgetLimits'; record(self, usage: 'Usage', *, model_calls: 'int' = 0, tool_calls: 'int' = 0, iterations: 'int' = 0, peer_invocations: 'int' = 0) -> 'None'; reserve(self, estimate: 'int') -> 'None'; sliced(self, limits: 'BudgetLimits') -> 'RunBudget'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.budget.ScopedLimits`¶

Stability: beta

One set of limits and where it was attached.

class ScopedLimits(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.budget.TenantLedger`¶

Stability: beta · Kind: Protocol

Where a ceiling wider than one run is kept.

class TenantLedger(Protocol) {consume(self, tenant: 'str', window: 'str', spent: 'Consumed') -> 'Consumed'; total(self, tenant: 'str', window: 'str') -> 'Consumed'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.budget.UnlimitedBudget`¶

Stability: beta

No ceiling at all, which is a thing somebody has to write down.

class UnlimitedBudget(object) {check(self) -> 'BudgetDecision'; child(self) -> 'UnlimitedBudget'; limits(self) -> 'BudgetLimits'; record(self, usage: 'Usage', *, model_calls: 'int' = 0, tool_calls: 'int' = 0, iterations: 'int' = 0, peer_invocations: 'int' = 0) -> 'None'; reserve(self, estimate: 'int') -> 'None'; sliced(self, limits: 'BudgetLimits') -> 'UnlimitedBudget'}

Typed errors: ValueError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.budget.most_restrictive`¶

Stability: beta

The tightest applicable ceiling in each dimension, with its source recorded.

def most_restrictive(*scoped: 'ScopedLimits') -> 'ResolvedBudget'

Typed errors: ConfigurationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.canonical`¶

Stability: beta

The key a tool name is compared under.

def canonical(name: 'str') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.canonical_json`¶

Stability: beta

Serialise state to the one form it hashes and compares by.

def canonical_json(value: 'object') -> 'str'

Typed errors: TypeError, ValueError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.capabilities.Capability`¶

Stability: beta

A thing a model either does or does not do, named the same way everywhere.

class Capability(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.capabilities.CapabilitySet`¶

Stability: beta

Runtime representation of an annotated type.

CapabilitySet = typing.Annotated[frozenset[tesserix_adk.core.capabilities.Capability], BeforeValidator(func=<class 'frozenset'>, json_schema_input_type=PydanticUndefined)]

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.capabilities.ModelCapabilities`¶

Stability: beta

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/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.capabilities.ModelRef`¶

Stability: beta

A model, addressable by name from configuration.

class ModelRef(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.capabilities.ModelSpec`¶

Stability: beta

A named model together with what it can do and where it may be used.

class ModelSpec(AdkModel) {with_capabilities(self, **overrides: 'object') -> 'Self'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.carried`¶

Stability: beta

The headers to merge into an outgoing request.

def carried(context: 'TenantContext') -> 'dict[str, str]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ceiling.CeilingLedger`¶

Stability: beta · Kind: Protocol

Reserve before the action, settle after it. Also what a ladder reads headroom from.

class CeilingLedger(Protocol) {commit(self, idempotency_key: 'str') -> 'Hold | None'; committed(self, *, tenant: 'str', action_class: 'str', window_seconds: 'float') -> 'Decimal'; release(self, idempotency_key: 'str') -> 'None'; reserve(self, *, tenant: 'str', action_class: 'str', ceiling: 'Ceiling', amount: 'Decimal', idempotency_key: 'str') -> 'Hold'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ceiling.Credit`¶

Stability: beta

Money coming back, recorded against the class it came back from.

class Credit(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ceiling.Hold`¶

Stability: beta

Headroom taken for one action, before the action happens.

class Hold(AdkModel) {live(self, at: 'float') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ceiling.HoldState`¶

Stability: beta

Where a reservation got to. Held counts against the ceiling exactly as committed does.

class HoldState(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ceiling.InMemoryCeilingLedger`¶

Stability: beta

One process's ledger, correct under concurrency within that process.

class InMemoryCeilingLedger(object) {commit(self, idempotency_key: 'str') -> 'Hold | None'; committed(self, *, tenant: 'str', action_class: 'str', window_seconds: 'float') -> 'Decimal'; credit(self, *, tenant: 'str', action_class: 'str', currency: 'str', amount: 'Decimal', authorised_by: 'str', reason: 'str' = '') -> 'Credit'; credits(self) -> 'Sequence[Credit]'; reap(self) -> 'int'; release(self, idempotency_key: 'str') -> 'None'; reserve(self, *, tenant: 'str', action_class: 'str', ceiling: 'Ceiling', amount: 'Decimal', idempotency_key: 'str') -> 'Hold'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ceiling.exact`¶

Stability: beta

amount as a Decimal, or a typed refusal.

def exact(amount: 'object') -> 'Decimal'

Typed errors: InexactAmountError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.checkpoint.CHECKPOINT_FORMAT`¶

Stability: beta

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

CHECKPOINT_FORMAT: int

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.checkpoint.Checkpoint`¶

Stability: beta

The frontier of a run, far enough along that another process can carry it on.

class Checkpoint(AdkModel) {resumable_by(self, format_version: 'int' = 1) -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.checkpoint.CheckpointBoundary`¶

Stability: beta

Where in a turn a checkpoint may be taken.

class CheckpointBoundary(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.checkpoint.CheckpointPolicy`¶

Stability: beta

When a run is written down, and how much of it may be.

class CheckpointPolicy(AdkModel) {writes_at(self, boundary: 'CheckpointBoundary') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.checkpoint.CheckpointStore`¶

Stability: beta · Kind: Protocol

Where the frontier of a run is kept between processes.

class CheckpointStore(Protocol) {forget(self, run_id: 'str', *, tenant: 'str') -> 'None'; latest(self, run_id: 'str', *, tenant: 'str') -> 'Checkpoint | None'; put(self, checkpoint: 'Checkpoint') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.checkpoint.PendingCall`¶

Stability: beta

A call the model asked for that the checkpoint could not say had finished.

class PendingCall(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.checkpoint.ResumePlan`¶

Stability: beta

What carrying a run on would involve, decided before anything is carried on.

class ResumePlan(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.checkpoint.Resumption`¶

Stability: beta

What a resume concluded about one outstanding call.

class Resumption(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.checkpoint.ToolDisposition`¶

Stability: beta

What a resume concluded about one outstanding call.

class ToolDisposition(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.claim_check.ClaimCheckPolicy`¶

Stability: beta

When a result is checked in, how much of it stays, and how long the rest is kept.

class ClaimCheckPolicy(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.claim_check.ClaimCheckStore`¶

Stability: beta · Kind: Protocol

Where a checked-in result lives until the run that made it is over.

class ClaimCheckStore(Protocol) {fetch(self, handle: 'str', *, tenant: 'str', run_id: 'str') -> 'str'; forget(self, *, tenant: 'str', run_id: 'str' = '') -> 'int'; put(self, handle: 'str', content: 'str', *, tenant: 'str', run_id: 'str', ttl_seconds: 'float') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.claim_check.ClaimTicket`¶

Stability: beta

What replaces an oversized result: the beginning of it, and where the rest is.

class ClaimTicket(object) {rendered(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.claim_check.HANDLE_PREFIX`¶

Stability: beta

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

HANDLE_PREFIX: str

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.claim_check.claim_handle`¶

Stability: beta

Derive the handle identifying one stored result.

def claim_handle(*, tenant: 'str', run_id: 'str', content: 'str') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.claim_handle`¶

Stability: beta

Derive the handle identifying one stored result.

def claim_handle(*, tenant: 'str', run_id: 'str', content: 'str') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.compatibility_breaks`¶

Stability: beta

Every way current breaks a consumer written against previous, one message each.

def compatibility_breaks(previous: 'Mapping[str, Mapping[str, Any]]', current: 'Mapping[str, Mapping[str, Any]]') -> 'tuple[str, ...]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.compensation.Applied`¶

Stability: beta

One forward action that really happened, and enough to take it back.

class Applied(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.compensation.CompensatedFailure`¶

Stability: beta

A run that failed and left nothing applied behind it.

class CompensatedFailure(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.compensation.Compensating`¶

Stability: beta · Kind: Protocol

What the runtime needs of a reversal, satisfied by @compensating_activity.

class Compensating(Protocol) {compensate(self, action: 'Applied') -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.compensation.CompensationIncomplete`¶

Stability: beta

A run that failed and could not put everything back.

class CompensationIncomplete(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.compensation.CompensationLedger`¶

Stability: beta · Kind: Protocol

Where the record of applied, un-reversed work lives.

class CompensationLedger(Protocol) {forget(self, *, tenant: 'str') -> 'int'; mark(self, reversal: 'Reversal') -> 'None'; outstanding(self, run_id: 'str', *, tenant: 'str', branch: 'str | None' = None) -> 'Sequence[Applied]'; record(self, action: 'Applied') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.compensation.Reversal`¶

Stability: beta

One attempt at taking one applied action back.

class Reversal(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.compensation.ReversalOutcome`¶

Stability: beta

What happened when one applied action was taken back.

class ReversalOutcome(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.compensation.arguments_digest`¶

Stability: beta

A stable fingerprint of what a call was given, safe to keep next to its key.

def arguments_digest(arguments: 'Mapping[str, JsonValue]') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.AdkConfig`¶

Stability: beta

The kit's resolved configuration. Frozen, fully typed, validated at startup.

class AdkConfig(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.ConfigError`¶

Stability: beta

Raised when configuration cannot be resolved, listing every problem at once.

class ConfigError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.ConfigOverrides`¶

Stability: beta

Typed code-layer configuration; unknown or misspelled keys fail static checks.

class ConfigOverrides(dict)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.ConfigProblem`¶

Stability: beta

One reason the configuration cannot be used.

class ConfigProblem(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.ConfigResolution`¶

Stability: beta

A resolved configuration together with the provenance of every key.

class ConfigResolution(object) {explain(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.DeadlineConfig`¶

Stability: beta

Wall-clock ceilings for a run, in seconds. None means no ceiling at that layer.

class DeadlineConfig(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.ENV_PREFIX`¶

Stability: beta

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

ENV_PREFIX: str

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.Layer`¶

Stability: beta

Exported value.

Layer = typing.Literal['code', 'env', 'file', 'default']

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.LoopConfig`¶

Stability: beta

How often a run may make the same call before it is treated as going nowhere.

class LoopConfig(AdkModel) {narrowed_to(self, other: 'LoopConfig | None') -> 'LoopConfig'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.McpConfig`¶

Stability: beta

The MCP servers this process may reach. Empty is a process that reaches none.

class McpConfig(AdkModel) {server(self, name: 'str') -> 'McpServerConfig'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.McpServerConfig`¶

Stability: beta

One declared MCP server, so adopting its tools is configuration rather than code.

class McpServerConfig(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.Provenance`¶

Stability: beta

Where one resolved key came from, and what it beat.

class Provenance(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.ProviderConfig`¶

Stability: beta

Where the model provider lives and how long to wait for it.

class ProviderConfig(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.RedactionConfig`¶

Stability: beta

Redaction applied before anything is logged or exported.

class RedactionConfig(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.RepairConfig`¶

Stability: beta

How many times an answer that did not validate may be sent back with the reason.

class RepairConfig(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.RetryConfig`¶

Stability: beta

When a failed attempt is worth making again, and how long to wait first.

class RetryConfig(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.StoreConfig`¶

Stability: beta

Endpoints for the optional stores. Absent means the integration is not in use.

class StoreConfig(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.TelemetryConfig`¶

Stability: beta

OpenTelemetry export. Case content is never an attribute; see docs/contributing.md.

class TelemetryConfig(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.leaf_keys`¶

Stability: beta

Map every dotted leaf key of a config model to its field.

def leaf_keys(model: 'type[BaseModel]', prefix: 'str' = '') -> 'dict[str, Any]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.load_config`¶

Stability: beta

Resolve configuration and return it, discarding the provenance.

def load_config(overrides: 'dict[str, Any] | None' = None, *, env: 'dict[str, str] | None' = None, path: 'Path | str | None' = None, start: 'Path | str | None' = '.') -> 'AdkConfig'

Typed errors: ConfigError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.load_typed_config`¶

Stability: beta

Load statically checked code overrides without narrowing load_config.

def load_typed_config(overrides: 'ConfigOverrides | None' = None, *, env: 'dict[str, str] | None' = None, path: 'Path | str | None' = None, start: 'Path | str | None' = '.') -> 'AdkConfig'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.resolve_config`¶

Stability: beta

Resolve configuration from code, environment and file, and record where each key came from.

def resolve_config(overrides: 'dict[str, Any] | None' = None, *, env: 'dict[str, str] | None' = None, path: 'Path | str | None' = None, start: 'Path | str | None' = '.') -> 'ConfigResolution'

Typed errors: ConfigError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.resolve_typed_config`¶

Stability: beta

Resolve statically checked code overrides through the stable config loader.

def resolve_typed_config(overrides: 'ConfigOverrides | None' = None, *, env: 'dict[str, str] | None' = None, path: 'Path | str | None' = None, start: 'Path | str | None' = '.') -> 'ConfigResolution'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.config.secret_keys`¶

Stability: beta

Dotted keys whose values are secret: environment-only, never rendered.

def secret_keys(model: 'type[BaseModel]') -> 'set[str]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.content_policy.Classification`¶

Stability: beta

What a classifier decided about one passage.

class Classification(AdkModel) {breaches(self, thresholds: 'Thresholds') -> 'tuple[ContentCategory, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.content_policy.ContentCategory`¶

Stability: beta

What a passage is about, in the terms a policy is written in.

class ContentCategory(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.content_policy.ContentClassifier`¶

Stability: beta · Kind: Protocol

Anything that can say what a passage is about.

class ContentClassifier(Protocol) {classify(self, text: 'str') -> 'Classification'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.content_policy.ContentSeverity`¶

Stability: beta

How bad, ordered so a threshold is a comparison rather than a lookup table.

class ContentSeverity(IntEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.content_policy.HeuristicClassifier`¶

Stability: beta

A term-list classifier, so a kit consumer has something before they have a model.

class HeuristicClassifier(object) {classify(self, text: 'str') -> 'Classification'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.content_policy.Thresholds`¶

Stability: beta

The severity at which each category is refused, for one tenant.

class Thresholds(AdkModel) {bar_for(self, category: 'ContentCategory') -> 'ContentSeverity'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.cost.Cost`¶

Stability: beta

What one call, or one whole run, came to.

class Cost(AdkModel) {quantised(self, places: 'int' = 6) -> 'Cost'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.cost.CostConfidence`¶

Stability: beta

How much of the number is known.

class CostConfidence(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.cost.CountSource`¶

Stability: beta

Who counted the tokens, which is the difference between a figure and a guess.

class CountSource(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.cost.weaker_source`¶

Stability: beta

The less trustworthy of two counting sources.

def weaker_source(one: 'CountSource', other: 'CountSource') -> 'CountSource'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.credentials.CallCredential`¶

Stability: beta · Kind: Protocol

The part of a minted credential a caller renders.

class CallCredential(Protocol) {headers(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.credentials.CredentialSource`¶

Stability: beta · Kind: Protocol

Whatever mints per-call credentials — tesserix_adk.tools.CredentialBroker does.

class CredentialSource(Protocol) {for_tool(self, *, identity: 'AgentIdentity', audience: 'str', needs: 'Iterable[str]', run_id: 'str', agent_version: 'str' = Ellipsis) -> 'CallCredential'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.credentials.ExpiringCredential`¶

Stability: beta · Kind: Protocol

A credential that says when it stops working, so a run can replace it in time.

class ExpiringCredential(CallCredential, Protocol) {expired(self, now: 'float', *, skew: 'float' = Ellipsis) -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.credentials.ExpiringCredentialSource`¶

Stability: beta · Kind: Protocol

A mint whose credentials carry an expiry.

class ExpiringCredentialSource(Protocol) {for_tool(self, *, identity: 'AgentIdentity', audience: 'str', needs: 'Iterable[str]', run_id: 'str', agent_version: 'str' = Ellipsis) -> 'ExpiringCredential'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.current_policy`¶

Stability: beta

The policy bound here, or a refusal.

def current_policy(*, where: 'str' = 'current_policy') -> 'TenantPolicy'

Typed errors: ConfigurationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.current_principal`¶

Stability: beta

The principal bound here, or a refusal.

def current_principal(*, where: 'str' = 'current_principal') -> 'Principal'

Typed errors: AuthorisationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.current_tenant`¶

Stability: beta

The context bound here, or a refusal.

def current_tenant(*, where: 'str' = 'current_tenant') -> 'TenantContext'

Typed errors: MissingTenantContextError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.deduplicate`¶

Stability: beta

Drop repeated calls, keeping the first of each id.

def deduplicate(calls: 'list[ToolCall]') -> 'tuple[ToolCall, ...]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.definition.AgentDefinition`¶

Stability: beta

One agent, as the artifact that was reviewed.

class AgentDefinition(AdkModel, Generic)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.definition.Owner`¶

Stability: beta

Who answers for an agent when it misbehaves.

class Owner(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.definition.TypedAgentDefinition`¶

Stability: beta

A reviewed definition for a TypedAgent input and output contract.

class TypedAgentDefinition(AgentDefinition, Generic)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.deprecate`¶

Stability: beta

Mark a public function or class as deprecated on a fixed schedule.

def deprecate(*, since: 'str', removal: 'str', alternative: 'str', reason: 'str | None' = None) -> 'Callable[[_T], _T]'

Typed errors: DeprecationPolicyError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.deprecation.AdkDeprecationWarning`¶

Stability: beta

Warns that a public name of the kit is scheduled for removal.

class AdkDeprecationWarning(DeprecationWarning)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.deprecation.Deprecation`¶

Stability: beta

A scheduled removal, as promised to consumers.

class Deprecation(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.deprecation.DeprecationPolicyError`¶

Stability: beta

Raised when a deprecation would break the published versioning policy.

class DeprecationPolicyError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.deprecation.WARNINGS_AS_ERRORS_ENV`¶

Stability: beta

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

WARNINGS_AS_ERRORS_ENV: str

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.deprecation.deprecate`¶

Stability: beta

Mark a public function or class as deprecated on a fixed schedule.

def deprecate(*, since: 'str', removal: 'str', alternative: 'str', reason: 'str | None' = None) -> 'Callable[[_T], _T]'

Typed errors: DeprecationPolicyError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.deprecation.deprecations`¶

Stability: beta

Every live deprecation, sorted by name.

def deprecations() -> 'tuple[Deprecation, ...]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.deprecations`¶

Stability: beta

Every live deprecation, sorted by name.

def deprecations() -> 'tuple[Deprecation, ...]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.digest_of_arguments`¶

Stability: beta

The digest an audit record carries in place of the payload.

def digest_of_arguments(arguments: 'Mapping[str, Any]', *, extra_patterns: 'Sequence[str]' = ()) -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.digest_of_token`¶

Stability: beta

Return the SHA-256 of a token value, which is what a store may keep.

def digest_of_token(value: 'str') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.dispatch.Dispatch`¶

Stability: beta

A dependency graph, executed as wide as the dependencies allow.

class Dispatch(Generic) {run(self) -> 'DispatchResult[T]'}

Typed errors: ConfigurationError, DependencyCycleError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.dispatch.DispatchNode`¶

Stability: beta

One piece of work and what it waits for.

class DispatchNode(Generic)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.dispatch.DispatchResult`¶

Stability: beta

What every node in one run of the graph did.

class DispatchResult(Generic) {value(self, name: 'str') -> 'T'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.dispatch.NodeOutcome`¶

Stability: beta

How a node ended. A string enum so a log line and a span attribute agree.

class NodeOutcome(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.dispatch.NodeResult`¶

Stability: beta

What one node did.

class NodeResult(Generic)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.AdkError`¶

Stability: beta

Base class for every error raised by the kit.

class AdkError(Exception)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.AggregationError`¶

Stability: beta

Raised when concurrent branches did not add up to the aggregate that was asked for.

class AggregationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ApprovalBindingError`¶

Stability: beta

Raised when a grant is asked to cover something other than what it was shown.

class ApprovalBindingError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ApprovalDeliveryError`¶

Stability: beta

Raised when the question could not be put in front of anybody.

class ApprovalDeliveryError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ApprovalDeniedError`¶

Stability: beta

Raised when a human declined a held tool call.

class ApprovalDeniedError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ApprovalExpiredError`¶

Stability: beta

Raised when a decision arrived past the request's time to live.

class ApprovalExpiredError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ApprovalTokenError`¶

Stability: beta

Raised when a token cannot buy the decision it was presented for.

class ApprovalTokenError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.AttributionError`¶

Stability: beta

Raised when spend could not be attributed to the participants that incurred it.

class AttributionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.AuditUnavailableError`¶

Stability: beta

Raised when a decision about an autonomous action could not be recorded.

class AuditUnavailableError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.AuthenticationError`¶

Stability: beta

Raised when a provider rejected the credential, or what it is allowed to reach.

class AuthenticationError(ProviderError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.AuthorisationError`¶

Stability: beta

Raised when work needs authority the run's effective scopes do not carry.

class AuthorisationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.AuthorityRevokedError`¶

Stability: beta

Raised when the authority a run was acting on is gone rather than merely stale.

class AuthorityRevokedError(AuthorisationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.AutonomyRefusedError`¶

Stability: beta

Raised when an action is one no grant could ever have permitted.

class AutonomyRefusedError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.BaselineUnusableError`¶

Stability: beta

Raised when the stored baseline cannot decide a change, so the gate refuses instead.

class BaselineUnusableError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.BudgetExceededError`¶

Stability: beta

Raised when a run would exceed its ceiling. Raised before the spend, not after.

class BudgetExceededError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.BudgetUnavailableError`¶

Stability: beta

Raised when the ledger a shared ceiling lives in cannot be reached.

class BudgetUnavailableError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.CancelledError`¶

Stability: beta

Raised when a run was cancelled. In-flight work stops; state becomes cancelled.

class CancelledError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.CapabilityError`¶

Stability: beta

Raised when something is asked of a provider that it has not declared it can do.

class CapabilityError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.CeilingExceededError`¶

Stability: beta

Raised when an action would take more headroom than the ceiling has left.

class CeilingExceededError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.CheckpointFormatError`¶

Stability: beta

Raised when a checkpoint was written by a kit version this one cannot read.

class CheckpointFormatError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.CheckpointTooLargeError`¶

Stability: beta

Raised when a run's frontier exceeds what a checkpoint may carry.

class CheckpointTooLargeError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ChunkingError`¶

Stability: beta

Raised when a run of text cannot be divided under the chunk token limit.

class ChunkingError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ClaimUnavailableError`¶

Stability: beta

Raised when a checked-in tool result cannot be produced for the handle asked about.

class ClaimUnavailableError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ConfigurationError`¶

Stability: beta

Raised when the kit is assembled in a way that cannot work.

class ConfigurationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ContentFilteredError`¶

Stability: beta

Raised when a provider refused to process or to return content on policy grounds.

class ContentFilteredError(ProviderError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ContextBudgetError`¶

Stability: beta

Raised when a prompt cannot be made to fit the tokens available for it.

class ContextBudgetError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ContextWindowExceededError`¶

Stability: beta

Raised when an assembled prompt is longer than the model declares it can read.

class ContextWindowExceededError(CapabilityError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.CredentialError`¶

Stability: beta

Raised when a tool could not obtain the credential its call needs.

class CredentialError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.CredentialExpiredError`¶

Stability: beta

Raised when the credential a call needs has lapsed and could not be replaced.

class CredentialExpiredError(CredentialError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.DelegationError`¶

Stability: beta

Raised when work handed to a worker did not come back as an answer.

class DelegationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.DelegationLimitError`¶

Stability: beta

Raised when one agent may not hand work to another, and the run must say why.

class DelegationLimitError(LoopLimitError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.DependencyCycleError`¶

Stability: beta

Raised when declared dependencies close a loop, so nothing in it could ever start.

class DependencyCycleError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.DuplicateInFlightError`¶

Stability: beta

Raised when another worker of the same consumer group is handling this event now.

class DuplicateInFlightError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.EmbeddingDimensionError`¶

Stability: beta

Raised when an embedding is not the width the collection was built with.

class EmbeddingDimensionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.EmbeddingUnavailableError`¶

Stability: beta

Raised when an ingest cannot embed a batch and stops rather than filling the gap.

class EmbeddingUnavailableError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.EstimateUnavailableError`¶

Stability: beta

Raised when a run's cost cannot be estimated on anything better than a guess.

class EstimateUnavailableError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.EvalIncompleteError`¶

Stability: beta

Raised when a quality gate was asked to judge a partly scored dataset.

class EvalIncompleteError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.EventIdReuseError`¶

Stability: beta

Raised when a different event arrives under an id that is already recorded.

class EventIdReuseError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.EventLoopStalledError`¶

Stability: beta

Raised when work blocked the event loop instead of awaiting on it.

class EventLoopStalledError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.EventPublishError`¶

Stability: beta

Raised when an event could not be delivered and the delivery mode says that stops the run.

class EventPublishError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.EventTooLargeError`¶

Stability: beta

Raised when an event is larger than the transport will carry.

class EventTooLargeError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ExtractionError`¶

Stability: beta

Raised when a model's extraction output cannot be trusted as a subgraph.

class ExtractionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.FallbackExhaustedError`¶

Stability: beta

Raised when every model in a run's chain refused it.

class FallbackExhaustedError(ProviderError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.FallbackUnsafeError`¶

Stability: beta

Raised when another model cannot be tried without risking a repeated side effect.

class FallbackUnsafeError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.FanOutLimitError`¶

Stability: beta

Raised when one turn, or one run, asked for more tool calls than its cap allows.

class FanOutLimitError(LoopLimitError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.GrantRevokedError`¶

Stability: beta

Raised when the grant a run was acting under was withdrawn while it was under way.

class GrantRevokedError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.GuardrailError`¶

Stability: beta

Base for what a guard decided and for what it could not decide.

class GuardrailError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.GuardrailEvaluationError`¶

Stability: beta

Raised when a guard could not reach a verdict, which is not consent.

class GuardrailEvaluationError(GuardrailError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.GuardrailViolationError`¶

Stability: beta

Raised when a guardrail rejects content. The step stops; it does not degrade.

class GuardrailViolationError(GuardrailError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.HandoffContractError`¶

Stability: beta

Raised when a conversation could not be handed to the agent it was addressed to.

class HandoffContractError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.HistoryUnavailableError`¶

Stability: beta

Raised when a resume cannot get back the transcript its checkpoint points at.

class HistoryUnavailableError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.HookEvaluationError`¶

Stability: beta

Raised when a hook could not be evaluated, which is a denial rather than a pass.

class HookEvaluationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.HookRefusedError`¶

Stability: beta

Raised when a hook refused the step. The reason is the hook's own.

class HookRefusedError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.HookRegistrationError`¶

Stability: beta

Raised when a hook cannot be added to a chain.

class HookRegistrationError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.IncomparableEvalError`¶

Stability: beta

Raised when two eval runs cannot be compared to each other.

class IncomparableEvalError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.IncompatiblePromptVersionError`¶

Stability: beta

Raised when an alias may not be moved to a version the call sites cannot render.

class IncompatiblePromptVersionError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.IndeterminateToolCallError`¶

Stability: beta

Raised when a resume cannot say whether an effectful call already happened.

class IndeterminateToolCallError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.InexactAmountError`¶

Stability: beta

Raised when an amount cannot be counted against a ceiling without drifting.

class InexactAmountError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.InvalidRequestError`¶

Stability: beta

Raised when a provider rejected the request itself.

class InvalidRequestError(ProviderError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.IrreversibleActionError`¶

Stability: beta

Raised when an action nothing can take back is about to run inside an unwindable scope.

class IrreversibleActionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.JudgeNotCalibratedError`¶

Stability: beta

Raised when a model judge is used as a gate without demonstrated human agreement.

class JudgeNotCalibratedError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.LeaseLostError`¶

Stability: beta

Raised when a worker acted on a claim it no longer holds.

class LeaseLostError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.LoopLimitError`¶

Stability: beta

Raised when a run hit one of the caps on its shape: how deep, how wide, how often.

class LoopLimitError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.MaxIterationsError`¶

Stability: beta

Raised when a run hit its iteration cap — the loop was bounded, and it hit the bound.

class MaxIterationsError(LoopLimitError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.McpAuthError`¶

Stability: beta

Raised when an MCP server refused the credential a call presented.

class McpAuthError(CredentialError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.McpAuthReason`¶

Stability: beta

Why an MCP server refused a call, kept apart because the three need different fixes.

class McpAuthReason(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.MediaIntakeError`¶

Stability: beta

Raised when a document or recording could not be read into text.

class MediaIntakeError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.MemoryConflictError`¶

Stability: beta

Raised when a supersession expected a version of a fact that is no longer live.

class MemoryConflictError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.MemoryContradictionError`¶

Stability: beta

Raised when a scope holds contradictory beliefs that nothing may resolve for it.

class MemoryContradictionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.MemoryCorruptionError`¶

Stability: beta

Raised when a stored record no longer validates as the model it was written as.

class MemoryCorruptionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.MemoryLimitError`¶

Stability: beta

Raised when a value is larger than the adapter declared it can hold.

class MemoryLimitError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.MemoryScopeError`¶

Stability: beta

Raised when a record is filed somewhere it does not say it belongs.

class MemoryScopeError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.MemoryUnavailableError`¶

Stability: beta

Raised when a memory store could not be reached, after the retries were spent.

class MemoryUnavailableError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.MissingExtraError`¶

Stability: beta

Raised when an optional integration is used without installing its extra.

class MissingExtraError(AdkError, ImportError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.MissingTenantContextError`¶

Stability: beta

Raised when scoped work is attempted with no tenant context bound.

class MissingTenantContextError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ModelArtifactError`¶

Stability: beta

Raised when a model file on disk is not one that can be loaded.

class ModelArtifactError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ModelResponseError`¶

Stability: beta

Raised when a provider answered with something the kit cannot read as a response.

class ModelResponseError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.NoEligibleModelError`¶

Stability: beta

Raised when nothing the routing table offers can do the work asked of it.

class NoEligibleModelError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.NonDeterminismError`¶

Stability: beta

Raised when replaying a recorded history against the current code diverges.

class NonDeterminismError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.PartialErasureError`¶

Stability: beta

Raised when an erasure removed the records but could not reach a derived index.

class PartialErasureError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.PayloadTooLargeError`¶

Stability: beta

Raised when an activity input or result is larger than the transport will carry.

class PayloadTooLargeError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.PlanValidationError`¶

Stability: beta

Raised when a plan is not something the runtime could execute as written.

class PlanValidationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.PoolExhaustedError`¶

Stability: beta

Raised when every connection to a provider was in use and none came free in time.

class PoolExhaustedError(ProviderError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.PrefixDriftError`¶

Stability: beta

Raised when the frozen part of a prompt is not what was frozen.

class PrefixDriftError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.PromptNotFoundError`¶

Stability: beta

Raised when a prompt name, version or alias does not exist in the registry.

class PromptNotFoundError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.PromptRejectedError`¶

Stability: beta

Raised when a stored prompt exists but may not be served.

class PromptRejectedError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ProtocolConformanceError`¶

Stability: beta

Raised when an object does not provide every member of a protocol.

class ProtocolConformanceError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ProvenanceLostError`¶

Stability: beta

Raised when compacting a conversation would drop a source it was carrying.

class ProvenanceLostError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ProviderError`¶

Stability: beta

Raised when a model provider fails, in the kit's own vocabulary.

class ProviderError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ProviderTimeoutError`¶

Stability: beta

Raised when a provider did not answer inside the deadline.

class ProviderTimeoutError(ProviderError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ProviderUnavailableError`¶

Stability: beta

Raised when a provider could not be reached, or was reached and was not ready.

class ProviderUnavailableError(ProviderError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.QueueUnavailableError`¶

Stability: beta

Raised when a work queue could not be reached.

class QueueUnavailableError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.RETRYABLE_STATUS`¶

Stability: beta

Build an immutable unordered collection of unique elements.

RETRYABLE_STATUS: frozenset

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.RateLimitError`¶

Stability: beta

Raised when a provider refused the call because too many were made.

class RateLimitError(ProviderError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.RecursionLimitError`¶

Stability: beta

Raised when a run was called from too deep a chain of agents calling agents.

class RecursionLimitError(LoopLimitError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.RepeatedCallError`¶

Stability: beta

Raised when the same tool was asked for with the same arguments past the threshold.

class RepeatedCallError(LoopLimitError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ResumeConflictError`¶

Stability: beta

Raised when another worker is already carrying this run on.

class ResumeConflictError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.RetrievalDegradedError`¶

Stability: beta

Raised when retrieval could not run every branch the caller required.

class RetrievalDegradedError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.RunLeaseError`¶

Stability: beta

Raised when a worker tries to advance a run it does not hold the lease on.

class RunLeaseError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.RunningLoopError`¶

Stability: beta

Raised when a synchronous helper is called from inside a running event loop.

class RunningLoopError(AdkError, RuntimeError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.SandboxError`¶

Stability: beta

Raised when the sandbox stopped generated code, rather than the code stopping itself.

class SandboxError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.SandboxMemoryError`¶

Stability: beta

Raised when generated code asked for more memory than its ceiling allowed.

class SandboxMemoryError(SandboxError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.SandboxTimeoutError`¶

Stability: beta

Raised when generated code ran past a time ceiling and was killed.

class SandboxTimeoutError(SandboxError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.SchemaGenerationError`¶

Stability: beta

Raised when a type cannot be faithfully described as a schema.

class SchemaGenerationError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.SchemaViolationError`¶

Stability: beta

Raised when a payload does not match the type declared for that boundary.

class SchemaViolationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ScopeEscalationError`¶

Stability: beta

Raised when a sub-agent asked to hold access the agent it acts for does not hold.

class ScopeEscalationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ScopeViolationError`¶

Stability: beta

Raised when an operator action would reach across a tenant boundary.

class ScopeViolationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.SecretResolutionError`¶

Stability: beta

Raised when a credential could not be fetched for the reference that names it.

class SecretResolutionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.StateConflictError`¶

Stability: beta

Raised when a state write named a version that has since moved.

class StateConflictError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.StateInUseError`¶

Stability: beta

Raised when deleting a session would orphan runs that have not finished.

class StateInUseError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.StateMigrationError`¶

Stability: beta

Raised when persisted state could not be brought forward into a record.

class StateMigrationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.StateNotFoundError`¶

Stability: beta

Raised when a patch or a resume named state that is not there.

class StateNotFoundError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.StatePersistenceError`¶

Stability: beta

Raised when a state store could not take a write, or could not be reached.

class StatePersistenceError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.StreamInterruptedError`¶

Stability: beta

Raised when a stream stopped before the model had finished answering.

class StreamInterruptedError(ProviderError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.TemplateError`¶

Stability: beta

Raised when a prompt template, or a value for one, may not be rendered.

class TemplateError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.TenantContextError`¶

Stability: beta

Raised when a tenant context arriving from elsewhere cannot be trusted or read.

class TenantContextError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.TenantCrossingError`¶

Stability: beta

Raised when a scope names a different tenant than the one it was entered from.

class TenantCrossingError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.TenantIsolationError`¶

Stability: beta

Raised when stored data does not belong to the tenant the work is bound to.

class TenantIsolationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.TenantLimitError`¶

Stability: beta

Raised when a tenant's configuration does not permit what was asked for.

class TenantLimitError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.TenantRefusal`¶

Stability: beta

Type alias.

TenantRefusal: TypeAliasType

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.TenantUnconfiguredError`¶

Stability: beta

Raised when a tenant's configuration exists somewhere but could not be read.

class TenantUnconfiguredError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ToolArgumentValidationError`¶

Stability: beta

Raised when a model's tool-call arguments do not match the tool's own schema.

class ToolArgumentValidationError(SchemaViolationError) {feedback(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ToolDefinitionError`¶

Stability: beta

Raised when a callable cannot be made into a tool.

class ToolDefinitionError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ToolError`¶

Stability: beta

Base of the tool taxonomy: something the run loop can branch on.

class ToolError(AdkError)

Typed errors: ValueError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ToolExecutionError`¶

Stability: beta

Raised when a tool fails. The tool's own exception is the __cause__.

class ToolExecutionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ToolFailure`¶

Stability: beta

The tool tried and could not finish.

class ToolFailure(ToolError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ToolNotFoundError`¶

Stability: beta

Raised when nothing is registered under the name that was asked for.

class ToolNotFoundError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ToolNotPermittedError`¶

Stability: beta

Raised when a tool exists but this agent's allowlist does not name it.

class ToolNotPermittedError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ToolRefusal`¶

Stability: beta

The tool worked and declined. An answer, not a fault.

class ToolRefusal(ToolError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ToolResultError`¶

Stability: beta

Raised when what a tool returned may not cross into the run as it stands.

class ToolResultError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.ToolTimedOutError`¶

Stability: beta

Raised when one tool call outran the ceiling declared for that tool.

class ToolTimedOutError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.TrustBoundaryError`¶

Stability: beta

Raised when the only model left to try sits outside the run's trust boundary.

class TrustBoundaryError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.UncitedClaimError`¶

Stability: beta

Raised when a claim carries no citation at all.

class UncitedClaimError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.UngroundedCitationError`¶

Stability: beta

Raised when an answer cites something the run did not retrieve.

class UngroundedCitationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.UnknownEventTypeError`¶

Stability: beta

Raised when an event names a type this kit has no schema for.

class UnknownEventTypeError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.UnknownTenantError`¶

Stability: beta

Raised when work arrives for a tenant nothing is configured for.

class UnknownTenantError(ConfigurationError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.UnsupportedEventVersionError`¶

Stability: beta

Raised when an event's schema version is outside the window this kit can read.

class UnsupportedEventVersionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.UnsupportedStateVersionError`¶

Stability: beta

Raised when persisted state was written at a version this build cannot read.

class UnsupportedStateVersionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.WorkItemNotFoundError`¶

Stability: beta

Raised when a queue operation named an item the queue does not hold.

class WorkItemNotFoundError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.WorkersBusyError`¶

Stability: beta

Raised when a synchronous body could not be given a worker in time.

class WorkersBusyError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.errors.WriteQueueFullError`¶

Stability: beta

Raised when an asynchronous write cannot be accepted because the queue is full.

class WriteQueueFullError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.evaluate`¶

Stability: beta

Every rule this answer breaks, in declaration order.

def evaluate(result: 'BaseModel', policies: 'Sequence[Policy]') -> 'PolicyReport'

Typed errors: GuardrailEvaluationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.event_schema.EVENT_SCHEMAS`¶

Stability: beta

Which model validates which event type at which version, and how to move between them.

EVENT_SCHEMAS: EventSchemaRegistry

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.event_schema.EventSchemaRegistry`¶

Stability: beta

Which model validates which event type at which version, and how to move between them.

class EventSchemaRegistry(object) {current_version(self, event_type: 'EventType') -> 'int'; model_for(self, event_type: 'EventType', version: 'int') -> 'type[EventPayload]'; payload_of(self, envelope: 'EventEnvelope') -> 'EventPayload'; read(self, raw: 'str | bytes') -> 'EventEnvelope'; register(self, model: 'type[EventPayload]') -> 'None'; register_upcaster(self, event_type: 'EventType', *, from_version: 'int', upcast: 'Upcaster') -> 'None'; requires(self, event_type: 'EventType') -> 'int'; schemas(self) -> 'dict[str, dict[str, Any]]'; upcast(self, envelope: 'EventEnvelope') -> 'EventEnvelope'; versions(self, event_type: 'EventType') -> 'tuple[int, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.event_schema.Upcaster`¶

Stability: beta

Type alias.

Upcaster: TypeAliasType

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.event_schema.compatibility_breaks`¶

Stability: beta

Every way current breaks a consumer written against previous, one message each.

def compatibility_breaks(previous: 'Mapping[str, Mapping[str, Any]]', current: 'Mapping[str, Mapping[str, Any]]') -> 'tuple[str, ...]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.event_schema.event_schemas`¶

Stability: beta

The kit's contracts as JSON Schema. Written to docs/event-schemas.json and released.

def event_schemas() -> 'dict[str, dict[str, Any]]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.event_schema.read_envelope`¶

Stability: beta

Decode an event another publisher wrote, upcast to the version this kit reads.

def read_envelope(raw: 'str | bytes') -> 'EventEnvelope'

Typed errors: UnknownEventTypeError, UnsupportedEventVersionError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.event_schemas`¶

Stability: beta

The kit's contracts as JSON Schema. Written to docs/event-schemas.json and released.

def event_schemas() -> 'dict[str, dict[str, Any]]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.ALLOWED_ATTRIBUTES`¶

Stability: beta

Build an immutable unordered collection of unique elements.

ALLOWED_ATTRIBUTES: frozenset

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.ApprovalDecided`¶

Stability: beta

A human answered.

class ApprovalDecided(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.ApprovalRequested`¶

Stability: beta

A human was asked before something ran.

class ApprovalRequested(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.BudgetExceeded`¶

Stability: beta

A ceiling stopped the work.

class BudgetExceeded(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.DEFAULT_MAX_EVENT_BYTES`¶

Stability: beta

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

DEFAULT_MAX_EVENT_BYTES: int

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.Delivery`¶

Stability: beta

What a publisher that cannot deliver means for the run.

class Delivery(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.EVENT_SCHEMA_VERSION`¶

Stability: beta

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

EVENT_SCHEMA_VERSION: int

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.EventEnvelope`¶

Stability: beta

One event as it travels.

class EventEnvelope(AdkModel) {to_json(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.EventPayload`¶

Stability: beta

What happened, as attributes drawn from the allowlist.

class EventPayload(AdkModel) {attributes(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.EventPublisher`¶

Stability: beta · Kind: Protocol

Where events go. Implemented by a broker adapter, faked in tests, or absent.

class EventPublisher(Protocol) {publish(self, event: 'EventEnvelope') -> 'None'; publish_batch(self, events: 'tuple[EventEnvelope, ...]') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.EventType`¶

Stability: beta

Everything the kit reports. A consumer switches on this and nothing else.

class EventType(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.Eventing`¶

Stability: beta

Builds envelopes from payloads and publishes them under one delivery mode.

class Eventing(object) {emit(self, payload: 'EventPayload', *, caused_by: 'EventEnvelope | None' = None) -> 'EventEnvelope | None'; emit_all(self, payloads: 'Iterable[EventPayload]', *, caused_by: 'EventEnvelope | None' = None) -> 'PublishReport'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.EventsReplayed`¶

Stability: beta

An operator redelivered dead-lettered events. The audit record of a recovery.

class EventsReplayed(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.MemoryErased`¶

Stability: beta

A subject's records were erased, which downstream stores have to hear about.

class MemoryErased(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.NullEventPublisher`¶

Stability: beta

The default. Publishes nowhere, so eventing is optional rather than mandatory.

class NullEventPublisher(object) {publish(self, event: 'EventEnvelope') -> 'None'; publish_batch(self, events: 'tuple[EventEnvelope, ...]') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.PublishReport`¶

Stability: beta

What became of a batch.

class PublishReport(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.RunCancelled`¶

Stability: beta

A run stopped because something asked it to.

class RunCancelled(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.RunCompleted`¶

Stability: beta

A run finished on its own terms.

class RunCompleted(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.RunFailed`¶

Stability: beta

A run ended in a failure.

class RunFailed(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.RunStarted`¶

Stability: beta

A run began.

class RunStarted(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.ToolCallCompleted`¶

Stability: beta

A tool call came back, one way or another.

class ToolCallCompleted(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.events.ToolCallRequested`¶

Stability: beta

A tool call was about to go out.

class ToolCallRequested(EventPayload)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.exact`¶

Stability: beta

amount as a Decimal, or a typed refusal.

def exact(amount: 'object') -> 'Decimal'

Typed errors: InexactAmountError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.extras.require_extra`¶

Stability: beta

Import an optional dependency, or say which extra provides it.

def require_extra(extra: 'str', module: 'str') -> 'ModuleType'

Typed errors: MissingExtraError, ModuleNotFoundError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.fallback.FallbackChain`¶

Stability: beta

The models one run may be attempted against, in order.

class FallbackChain(AdkModel) {after(self, ref: 'str', *, failed: 'Collection[str]' = ()) -> 'str | None'; refuse_the_excluded(self) -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.fallback.fallback_eligible`¶

Stability: beta

Whether another model may be asked the same question after failure.

def fallback_eligible(failure: 'BaseException') -> 'bool'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.fallback_eligible`¶

Stability: beta

Whether another model may be asked the same question after failure.

def fallback_eligible(failure: 'BaseException') -> 'bool'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.guards.GuardResult`¶

Stability: beta

One guard's answer about one piece of content.

class GuardResult(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.guards.GuardStage`¶

Stability: beta

Where in a run a check happened. Carried on every verdict and every refusal.

class GuardStage(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.guards.GuardVerdict`¶

Stability: beta

What a guard decided.

class GuardVerdict(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.guards.GuardrailPipeline`¶

Stability: beta

An ordered, fail-closed chain of guards over one stage of a run.

class GuardrailPipeline(object) {check_input(self, content: 'str') -> 'str'; check_output(self, content: 'str') -> 'str'; check_stream(self, chunks: 'AsyncIterator[str]') -> 'AsyncIterator[str]'}

Typed errors: ConfigurationError, ProtocolConformanceError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.header_of`¶

Stability: beta

Encode context as the value of the adk-tenant header.

def header_of(context: 'TenantContext') -> 'str'

Typed errors: TenantContextError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.hooks.ApprovalDecision`¶

Stability: beta

A human's answer about one held call.

class ApprovalDecision(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.hooks.ApprovalDenial`¶

Stability: beta

What a denied or expired approval means to the run.

class ApprovalDenial(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.hooks.ApprovalGate`¶

Stability: beta · Kind: Protocol

Where a run waits for a human to decide about a tool call.

class ApprovalGate(Protocol) {request(self, record: 'ApprovalRecord') -> 'ApprovalDecision'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.hooks.ApprovalPolicy`¶

Stability: beta

When a tool may not run without a human, decided by code rather than by the model.

class ApprovalPolicy(object) {applies_to(self, arguments: 'Mapping[str, Any]') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.hooks.ApprovalPredicate`¶

Stability: beta

Type alias.

ApprovalPredicate: TypeAliasType

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.hooks.ApprovalRecord`¶

Stability: beta

A tool call held for a human decision, in a form safe to put in a queue.

class ApprovalRecord(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.hooks.ApprovalTransport`¶

Stability: beta · Kind: Protocol

How the question reaches whoever answers it, apart from where the run waits.

class ApprovalTransport(Protocol) {deliver(self, record: 'ApprovalRecord') -> 'ApprovalDecision | None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.hooks.Hook`¶

Stability: beta · Kind: Protocol

A policy attached to declared points in the loop.

class Hook(Protocol) {on(self, subject: 'HookSubject') -> 'HookDecision'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.hooks.HookAction`¶

Stability: beta

What a hook may say, ordered from least to most restrictive.

class HookAction(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.hooks.HookChain`¶

Stability: beta

The hooks a runner enforces, in declaration order.

class HookChain(object) {at(self, point: 'HookPoint') -> 'tuple[Hook, ...]'; register(self, hook: 'Hook') -> 'None'; sealed(self) -> 'HookChain'}

Typed errors: HookRegistrationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.hooks.HookDecision`¶

Stability: beta

One hook's answer at one point.

class HookDecision(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.hooks.HookPoint`¶

Stability: beta

The seven places a run stops to ask.

class HookPoint(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.hooks.HookSubject`¶

Stability: beta

What a hook is told about the step it is being asked about.

class HookSubject(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.hooks.resolve_hooks`¶

Stability: beta

Return the decision that holds when several hooks answer at one point.

def resolve_hooks(decisions: 'Sequence[HookDecision] | Iterable[HookDecision]') -> 'HookDecision'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.idempotency.Claim`¶

Stability: beta

What the store said when a call asked to run.

class Claim(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.idempotency.Idempotency`¶

Stability: beta

What happens when the same call runs twice.

class Idempotency(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.idempotency.IdempotencyPolicy`¶

Stability: beta

A tool's declaration about repeating it, and what identifies one call.

class IdempotencyPolicy(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.idempotency.IdempotencyStore`¶

Stability: beta · Kind: Protocol

Where the record of an executed side effect lives.

class IdempotencyStore(Protocol) {abandon(self, key: 'str', *, tenant: 'str') -> 'None'; begin(self, key: 'str', *, tenant: 'str', ttl_seconds: 'float') -> 'Claim'; forget(self, *, tenant: 'str') -> 'int'; record(self, key: 'str', *, tenant: 'str', outcome: 'str', ttl_seconds: 'float') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.idempotency.idempotency_key`¶

Stability: beta

Derive the key identifying one side effect, or None where it cannot be derived.

def idempotency_key(*, tenant: 'str', run_id: 'str', tool: 'str', arguments: 'Mapping[str, Any]', key_arguments: 'tuple[str, ...]' = ()) -> 'str | None'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.idempotency_key`¶

Stability: beta

Derive the key identifying one side effect, or None where it cannot be derived.

def idempotency_key(*, tenant: 'str', run_id: 'str', tool: 'str', arguments: 'Mapping[str, Any]', key_arguments: 'tuple[str, ...]' = ()) -> 'str | None'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.identity.AgentIdentity`¶

Stability: beta

What one agent may do on one run: its declaration, cut down to the caller's grant.

class AgentIdentity(object) {check(self, required: 'Iterable[str]', *, where: 'str' = '') -> 'None'; check_live(self, now: 'float', *, where: 'str' = '') -> 'None'; missing(self, required: 'Iterable[str]') -> 'tuple[str, ...]'; narrowed(self, *, agent: 'str', declared: 'Iterable[str]') -> 'Self'; permits(self, scope: 'str') -> 'bool'; unused(self, used: 'Iterable[str]') -> 'tuple[str, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.identity.AuthMethod`¶

Stability: beta

How the principal was established, which is what its expiry means.

class AuthMethod(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.identity.Principal`¶

Stability: beta

Who a run acts for, and what they were granted.

class Principal(AdkModel) {delegating(self, *, until: 'float', scopes: 'Iterable[str] | None' = None) -> 'Self'; expired(self, now: 'float') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.identity.ScopeSet`¶

Stability: beta

A set of scopes that can be narrowed and never widened.

class ScopeSet(object) {missing(self, required: 'Iterable[str]') -> 'tuple[str, ...]'; narrowed_to(self, other: 'ScopeSet') -> 'ScopeSet'; permits(self, scope: 'str') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.identity.current_principal`¶

Stability: beta

The principal bound here, or a refusal.

def current_principal(*, where: 'str' = 'current_principal') -> 'Principal'

Typed errors: AuthorisationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.identity.principal_here`¶

Stability: beta

The principal bound here, or None outside a scope.

def principal_here() -> 'Principal | None'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.identity.principal_scope`¶

Stability: beta

Bind who a run acts for, restoring what was there before.

def principal_scope(principal: 'Principal') -> 'Iterator[Principal]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.in_payload`¶

Stability: beta

payload with the context added under PAYLOAD_KEY.

def in_payload(context: 'TenantContext', payload: 'Mapping[str, str]') -> 'dict[str, str]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.injection.InjectionSignal`¶

Stability: beta

One thing screening recognised, and where.

class InjectionSignal(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.injection.SignalKind`¶

Stability: beta

What a screener recognised. Named, because "suspicious" is not actionable.

class SignalKind(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.injection.screen`¶

Stability: beta

Recognise instruction-shaped and tool-call-shaped text in a passage.

def screen(text: 'str', *, instructions: 'str' = '') -> 'tuple[InjectionSignal, ...]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.instrumentation.Instrumentation`¶

Stability: beta

Emits a run-rooted trace with no per-agent wiring.

class Instrumentation(object) {run(self, run_id: 'str', **attributes: 'str') -> 'Iterator[RunSpan]'; step(self, kind: 'SpanKind', name: 'str', *, attempt: 'int' = 1, **attributes: 'str') -> 'Iterator[Span]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.instrumentation.Recording`¶

Stability: beta

One finished span.

class Recording(object) {exported(self, run_id: 'str') -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.instrumentation.RunSpan`¶

Stability: beta

The root span, plus the trace it collected once the run is over.

class RunSpan(Span)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.instrumentation.SPAN_NAMES`¶

Stability: beta

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/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.instrumentation.Sampling`¶

Stability: beta

Which runs are exported.

class Sampling(AdkModel) {keeps(self, run_id: 'str') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.instrumentation.Span`¶

Stability: beta

A span while it is open. Setting anything on it is a dictionary write, never I/O.

class Span(object) {first_token(self) -> 'None'; iterated(self, count: 'int' = 1) -> 'None'; set(self, **attributes: 'str') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.instrumentation.SpanKind`¶

Stability: beta

What a span covers. One kind per stage a run can spend time in.

class SpanKind(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.instrumentation.SpanLimits`¶

Stability: beta

Bounds on what one run may record.

class SpanLimits(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.instrumentation.SpanStatus`¶

Stability: beta

How a span ended.

class SpanStatus(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.instrumentation.TelemetryLoss`¶

Stability: beta

What was not exported, counted locally.

class TelemetryLoss(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.instrumentation.Trace`¶

Stability: beta

Everything one run recorded.

class Trace(object) {of_kind(self, kind: 'SpanKind') -> 'tuple[Recording, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.instrumentation.span_here`¶

Stability: beta

The span open right now, or None outside any. What an emitted event parents itself to.

def span_here() -> 'str | None'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.lease.DEFAULT_LEASE`¶

Stability: beta

How long a lease lives and when its holder should renew it.

DEFAULT_LEASE: LeasePolicy

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.lease.LeasePolicy`¶

Stability: beta

How long a lease lives and when its holder should renew it.

class LeasePolicy(AdkModel) {due_to_renew(self, lease: 'RunLease', *, now: 'float') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.lease.LeaseStore`¶

Stability: beta · Kind: Protocol

Where the one-holder-at-a-time decision is made.

class LeaseStore(Protocol) {acquire(self, run_id: 'str', *, tenant: 'str', holder: 'str', ttl_seconds: 'float') -> 'RunLease'; held(self, run_id: 'str', *, tenant: 'str') -> 'RunLease | None'; release(self, lease: 'RunLease') -> 'None'; renew(self, lease: 'RunLease', *, ttl_seconds: 'float') -> 'RunLease'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.lease.RunLease`¶

Stability: beta

One worker's claim on one run, for a bounded time.

class RunLease(AdkModel) {held_at(self, now: 'float') -> 'bool'; superseded_by(self, other: 'RunLease') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ledger.LedgerKey`¶

Stability: beta

Whose window this is.

class LedgerKey(AdkModel) {at(self, now: 'float') -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ledger.Reservation`¶

Stability: beta

An allowance held while a run spends it.

class Reservation(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ledger.SEPARATOR`¶

Stability: beta

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

SEPARATOR: str

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ledger.SpendLedger`¶

Stability: beta · Kind: Protocol

Where a shared ceiling is actually enforced.

class SpendLedger(Protocol) {forget(self, tenant: 'str') -> 'WindowSpend'; read_window(self, key: 'LedgerKey') -> 'WindowSpend'; reconcile(self) -> 'int'; record_progress(self, reservation: 'Reservation', spent: 'Decimal') -> 'None'; release(self, reservation: 'Reservation') -> 'None'; reserve(self, key: 'LedgerKey', amount: 'Decimal', *, ceiling: 'Decimal', lease_seconds: 'float' = Ellipsis) -> 'Reservation'; settle(self, reservation: 'Reservation', actual: 'Decimal') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ledger.Window`¶

Stability: beta

The period a ceiling applies over.

class Window(AdkModel) {bucket(self, now: 'float') -> 'int'; opened_at(self, now: 'float') -> 'float'; resets_at(self, now: 'float') -> 'float'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ledger.WindowKind`¶

Stability: beta

How a window's boundary is decided.

class WindowKind(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.ledger.WindowSpend`¶

Stability: beta

What a window holds right now.

class WindowSpend(AdkModel) {remaining(self, ceiling: 'Decimal') -> 'Decimal'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.legal_transitions`¶

Stability: beta

The states a run in state may move to. Empty for every terminal state.

def legal_transitions(state: 'RunState') -> 'frozenset[RunState]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.lint_directory`¶

Stability: beta

Lint every prompt file under directory, for a project to run in CI.

def lint_directory(directory: 'Path', *, suffixes: 'tuple[str, ...]' = ('.toml', '.txt', '.md', '.prompt')) -> 'LintReport'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.lint_prompt`¶

Stability: beta

Lint one prompt body, wherever it is kept.

def lint_prompt(text: 'str', *, source: 'str' = '') -> 'tuple[LintFinding, ...]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.literal_credentials`¶

Stability: beta

Fields that look like credentials and hold a literal rather than a reference.

def literal_credentials(config: 'AdkModel') -> 'tuple[str, ...]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.load_config`¶

Stability: beta

Resolve configuration and return it, discarding the provenance.

def load_config(overrides: 'dict[str, Any] | None' = None, *, env: 'dict[str, str] | None' = None, path: 'Path | str | None' = None, start: 'Path | str | None' = '.') -> 'AdkConfig'

Typed errors: ConfigError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.load_typed_config`¶

Stability: beta

Load statically checked code overrides without narrowing load_config.

def load_typed_config(overrides: 'ConfigOverrides | None' = None, *, env: 'dict[str, str] | None' = None, path: 'Path | str | None' = None, start: 'Path | str | None' = '.') -> 'AdkConfig'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.looks_sensitive`¶

Stability: beta

Whether value contains anything shaped like a secret.

def looks_sensitive(value: 'str', extra_patterns: 'Sequence[str]' = ()) -> 'bool'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.members_of`¶

Stability: beta

Return the member names a protocol requires, sorted.

def members_of(protocol: 'type') -> 'tuple[str, ...]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.mint_token`¶

Stability: beta

Issue a token for record, good for ttl_seconds from issued_at.

def mint_token(record: 'ApprovalRecord', *, issued_at: 'float' = 0.0, ttl_seconds: 'float' = 259200.0) -> 'ApprovalToken'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.models.AdkModel`¶

Stability: beta

Frozen, strict, and closed to fields it does not declare.

class AdkModel(BaseModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.models.InputT`¶

Stability: beta

Type variable.

InputT: TypeVar

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.models.NoOutput`¶

Stability: beta

The answer type of an agent that answers in prose: there is not one.

class NoOutput(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.models.OutputT`¶

Stability: beta

Type variable.

OutputT: TypeVar

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.models.Sensitive`¶

Stability: beta

Marks a field that must not reach telemetry.

class Sensitive(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.models.parsed_from_strings`¶

Stability: beta

Parse value as annotation, accepting a string where the source only has strings.

def parsed_from_strings(annotation: 'type[Value] | Any', value: 'object') -> 'Value'

Typed errors: SchemaViolationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.models.telemetry_dump`¶

Stability: beta

Dump model for a span, a metric or a log line, without its sensitive fields.

def telemetry_dump(model: 'BaseModel') -> 'dict[str, Any]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.models.validated`¶

Stability: beta

Validate payload as model, or raise naming every field that failed.

def validated(model: 'type[Model]', payload: 'object') -> 'Model'

Typed errors: SchemaViolationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.most_restrictive`¶

Stability: beta

The tightest applicable ceiling in each dimension, with its source recorded.

def most_restrictive(*scoped: 'ScopedLimits') -> 'ResolvedBudget'

Typed errors: ConfigurationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.of_payload`¶

Stability: beta

Read the context back out of a payload, or refuse it.

def of_payload(payload: 'Mapping[str, str]') -> 'TenantContext'

Typed errors: TenantContextError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.output_policy.Abstention`¶

Stability: beta

An answer of "I do not know", typed rather than a plausible invented alternative.

class Abstention(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.output_policy.Bounded`¶

Stability: beta

A numeric field that has to stay inside a band.

class Bounded(object) {check(self, result: 'BaseModel') -> 'tuple[PolicyViolation, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.output_policy.Invariant`¶

Stability: beta

A rule about the answer as a whole, for the ones that are not about one field.

class Invariant(Generic) {check(self, result: 'BaseModel') -> 'tuple[PolicyViolation, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.output_policy.OneOf`¶

Stability: beta

A field that has to be one of a known set.

class OneOf(object) {check(self, result: 'BaseModel') -> 'tuple[PolicyViolation, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.output_policy.Policy`¶

Stability: beta · Kind: Protocol

A deterministic rule about a parsed answer.

class Policy(Protocol) {check(self, result: 'BaseModel') -> 'tuple[PolicyViolation, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.output_policy.PolicyReport`¶

Stability: beta

Kept for the caller that asked what was violated, without what was answered.

class PolicyReport(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.output_policy.PolicyViolation`¶

Stability: beta

One rule an answer broke.

class PolicyViolation(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.output_policy.RequiresCitation`¶

Stability: beta

An assertion drawn from retrieved content has to say where it came from.

class RequiresCitation(object) {check(self, result: 'BaseModel') -> 'tuple[PolicyViolation, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.output_policy.evaluate`¶

Stability: beta

Every rule this answer breaks, in declaration order.

def evaluate(result: 'BaseModel', policies: 'Sequence[Policy]') -> 'PolicyReport'

Typed errors: GuardrailEvaluationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.output_policy.reach`¶

Stability: beta

The value at a dotted path inside result.

def reach(result: 'BaseModel', path: 'str') -> 'object'

Typed errors: GuardrailEvaluationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.packed`¶

Stability: beta

A record as the text a store holds, versioned and canonical.

def packed(record: 'AdkModel', *, kind: 'str', preserved: 'Mapping[str, Any] | None' = None, registry: 'StateRegistry | None' = None) -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.parsed_from_strings`¶

Stability: beta

Parse value as annotation, accepting a string where the source only has strings.

def parsed_from_strings(annotation: 'type[Value] | Any', value: 'object') -> 'Value'

Typed errors: SchemaViolationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.persistence.CURRENT_VERSIONS`¶

Stability: beta

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)

CURRENT_VERSIONS: dict

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.persistence.Envelope`¶

Stability: beta

A persisted payload and the version it was written at.

class Envelope(AdkModel) {digest(self) -> 'str'; opened(self, model: 'type[ModelT]') -> 'ModelT'; preserved(self, model: 'type[ModelT]') -> 'dict[str, Any]'; to_json(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.persistence.STATE_REGISTRY`¶

Stability: beta

Which version each kind is written at, and how to read the versions before it.

STATE_REGISTRY: StateRegistry

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.persistence.SUPPORTED_WINDOW`¶

Stability: beta

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

SUPPORTED_WINDOW: int

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.persistence.StateKind`¶

Stability: beta

A thing the kit persists. Migrations are registered per kind, not per store.

class StateKind(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.persistence.StateMigration`¶

Stability: beta

One version step, applied on read.

class StateMigration(object)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.persistence.StateRegistry`¶

Stability: beta

Which version each kind is written at, and how to read the versions before it.

class StateRegistry(object) {oldest(self, kind: 'str') -> 'int'; register(self, migration: 'StateMigration') -> 'None'; upgraded(self, envelope: 'Envelope') -> 'Envelope'; version(self, kind: 'str') -> 'int'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.persistence.canonical_json`¶

Stability: beta

Serialise state to the one form it hashes and compares by.

def canonical_json(value: 'object') -> 'str'

Typed errors: TypeError, ValueError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.persistence.packed`¶

Stability: beta

A record as the text a store holds, versioned and canonical.

def packed(record: 'AdkModel', *, kind: 'str', preserved: 'Mapping[str, Any] | None' = None, registry: 'StateRegistry | None' = None) -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.persistence.revived`¶

Stability: beta

The counterpart of canonical_json: tagged moments and decimals back as themselves.

def revived(payload: 'Mapping[str, Any]') -> 'dict[str, Any]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.persistence.unpacked`¶

Stability: beta

A record back from what a store held, migrated on the way.

def unpacked(text: 'str', model: 'type[ModelT]', *, kind: 'str', registry: 'StateRegistry | None' = None) -> 'ModelT'

Typed errors: StateMigrationError, UnsupportedStateVersionError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.pii.DEFAULT_DETECTORS`¶

Stability: beta

Built-in immutable sequence.

DEFAULT_DETECTORS: tuple

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.pii.PIIDetector`¶

Stability: beta · Kind: Protocol

Anything that can find identifiers in a passage.

class PIIDetector(Protocol) {detect(self, text: 'str') -> 'tuple[PIIMatch, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.pii.PIIKind`¶

Stability: beta

What kind of identifier was found. The placeholder keeps it, so reasoning survives.

class PIIKind(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.pii.PIIMatch`¶

Stability: beta

One identifier, located but not carried.

class PIIMatch(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.pii.PatternDetector`¶

Stability: beta

A detector built from one shape, optionally checked before it is believed.

class PatternDetector(object) {detect(self, text: 'str') -> 'tuple[PIIMatch, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.pii.Redacted`¶

Stability: beta

What a passage became, and what was taken out of it.

class Redacted(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.pii.placeholder`¶

Stability: beta

The stand-in for one value: its type, and a pseudonym stable within the tenant.

def placeholder(kind: 'PIIKind', value: 'str', *, tenant: 'str') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.pii.redact`¶

Stability: beta

Replace every identifier in text with a placeholder that stands in for it.

def redact(text: 'str', *, tenant: 'str', detectors: 'Sequence[PIIDetector]' = (PatternDetector('card'), PatternDetector('email'), PatternDetector('iban'), PatternDetector('bearer_token'), PatternDetector('api_key'), PatternDetector('national_id'), PatternDetector('passport'), PatternDetector('phone')), threshold: 'float' = 0.6, allow: 'Iterable[str]' = ()) -> 'Redacted'

Typed errors: GuardrailEvaluationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.placeholder`¶

Stability: beta

The stand-in for one value: its type, and a pseudonym stable within the tenant.

def placeholder(kind: 'PIIKind', value: 'str', *, tenant: 'str') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.policy_here`¶

Stability: beta

The policy bound here, or None outside one.

def policy_here() -> 'TenantPolicy | None'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.primitives.BinaryPart`¶

Stability: beta

Bytes in a message — an image, an audio clip, a scanned document.

class BinaryPart(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.primitives.ContentPart`¶

Stability: beta

Runtime representation of an annotated type.

ContentPart = typing.Annotated[tesserix_adk.core.primitives.TextPart | tesserix_adk.core.primitives.BinaryPart, FieldInfo(annotation=NoneType, required=True, discriminator='kind')]

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.primitives.Message`¶

Stability: beta

One turn in a conversation.

class Message(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.primitives.Role`¶

Stability: beta

Exported value.

Role = typing.Literal['system', 'user', 'assistant', 'tool']

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.primitives.TextPart`¶

Stability: beta

Text in a message.

class TextPart(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.primitives.ToolCall`¶

Stability: beta

A model's request to run a tool.

class ToolCall(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.primitives.Usage`¶

Stability: beta

What one step consumed, and what it cost if the cost is knowable.

class Usage(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.primitives.deduplicate`¶

Stability: beta

Drop repeated calls, keeping the first of each id.

def deduplicate(calls: 'list[ToolCall]') -> 'tuple[ToolCall, ...]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.principal_here`¶

Stability: beta

The principal bound here, or None outside a scope.

def principal_here() -> 'Principal | None'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.principal_scope`¶

Stability: beta

Bind who a run acts for, restoring what was there before.

def principal_scope(principal: 'Principal') -> 'Iterator[Principal]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.prompt_digest`¶

Stability: beta

The content address of prompt text.

def prompt_digest(body: 'str') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.prompt_lint.LintFinding`¶

Stability: beta

One thing a prompt says that a tool should decide instead.

class LintFinding(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.prompt_lint.LintReport`¶

Stability: beta

What one run of the check found, over one prompt or a whole directory.

class LintReport(AdkModel) {summary(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.prompt_lint.LintRule`¶

Stability: beta

One thing a prompt may not say, and what to do instead.

class LintRule(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.prompt_lint.PROMPT_SUFFIXES`¶

Stability: beta

Built-in immutable sequence.

PROMPT_SUFFIXES: tuple

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.prompt_lint.RULES`¶

Stability: beta

Built-in immutable sequence.

RULES: tuple

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.prompt_lint.Severity`¶

Stability: beta

Exported value.

Severity = typing.Literal['error', 'warning']

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.prompt_lint.lint_directory`¶

Stability: beta

Lint every prompt file under directory, for a project to run in CI.

def lint_directory(directory: 'Path', *, suffixes: 'tuple[str, ...]' = ('.toml', '.txt', '.md', '.prompt')) -> 'LintReport'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.prompt_lint.lint_prompt`¶

Stability: beta

Lint one prompt body, wherever it is kept.

def lint_prompt(text: 'str', *, source: 'str' = '') -> 'tuple[LintFinding, ...]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.prompts.FilePromptRegistry`¶

Stability: beta

Prompts as one TOML file per name, versions and aliases inside it.

class FilePromptRegistry(object) {get(self, name: 'str', *, version: 'str' = '', alias: 'str' = '', tenant: 'str' = '') -> 'PromptDefinition'; list_versions(self, name: 'str', *, tenant: 'str' = '') -> 'tuple[str, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.prompts.PromptDefinition`¶

Stability: beta

One published version of one prompt.

class PromptDefinition(AdkModel) {fits(self, window_tokens: 'int', *, share: 'float' = 0.5) -> 'bool'; instruct(self, agent: 'Agent[OutputT]') -> 'Agent[OutputT]'; instruct_typed(self, agent: 'TypedAgent[InputT, OutputT]') -> 'TypedAgent[InputT, OutputT]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.prompts.PromptRef`¶

Stability: beta

What a run and its spans record about the prompt that produced them.

class PromptRef(AdkModel) {attributes(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.prompts.PromptRegistry`¶

Stability: beta · Kind: Protocol

Where prompt text is read from. The protocol is the stable surface.

class PromptRegistry(Protocol) {get(self, name: 'str', *, version: 'str' = '', alias: 'str' = '', tenant: 'str' = '') -> 'PromptDefinition'; list_versions(self, name: 'str', *, tenant: 'str' = '') -> 'tuple[str, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.prompts.prompt_digest`¶

Stability: beta

The content address of prompt text.

def prompt_digest(body: 'str') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.propagation.HEADER`¶

Stability: beta

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

HEADER: str

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.propagation.MAX_HEADER_BYTES`¶

Stability: beta

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

MAX_HEADER_BYTES: int

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.propagation.PAYLOAD_KEY`¶

Stability: beta

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

PAYLOAD_KEY: str

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.propagation.VERSION`¶

Stability: beta

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

VERSION: str

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.propagation.arriving`¶

Stability: beta

Bind the incoming message's tenant for the length of handling it.

def arriving(headers: 'Mapping[str, str]', *, authenticated: 'str | None' = None) -> 'Iterator[TenantContext]'

Typed errors: TenantContextError, TenantCrossingError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.propagation.carried`¶

Stability: beta

The headers to merge into an outgoing request.

def carried(context: 'TenantContext') -> 'dict[str, str]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.propagation.header_of`¶

Stability: beta

Encode context as the value of the adk-tenant header.

def header_of(context: 'TenantContext') -> 'str'

Typed errors: TenantContextError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.propagation.in_payload`¶

Stability: beta

payload with the context added under PAYLOAD_KEY.

def in_payload(context: 'TenantContext', payload: 'Mapping[str, str]') -> 'dict[str, str]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.propagation.of_payload`¶

Stability: beta

Read the context back out of a payload, or refuse it.

def of_payload(payload: 'Mapping[str, str]') -> 'TenantContext'

Typed errors: TenantContextError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.propagation.restored`¶

Stability: beta

Read the context off an incoming message, or refuse it.

def restored(headers: 'Mapping[str, str]', *, authenticated: 'str | None' = None) -> 'TenantContext'

Typed errors: TenantContextError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.protocols.BudgetPolicy`¶

Stability: beta · Kind: Protocol

Spend and usage limits applied before and after a metered call.

class BudgetPolicy(Protocol) {check(self) -> 'BudgetDecision'; child(self) -> 'BudgetPolicy'; limits(self) -> 'BudgetLimits'; record(self, usage: 'Usage', *, model_calls: 'int' = 0, tool_calls: 'int' = 0, iterations: 'int' = 0, peer_invocations: 'int' = 0) -> 'None'; reserve(self, estimate: 'int') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.protocols.Clock`¶

Stability: beta · Kind: Protocol

Source of time, injected so that behaviour under time is testable.

class Clock(Protocol) {now(self) -> 'float'; sleep(self, seconds: 'float') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.protocols.DeclaresEmulation`¶

Stability: beta · Kind: Protocol

A provider with an opinion about being stood in for.

class DeclaresEmulation(Protocol)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.protocols.Guardrail`¶

Stability: beta · Kind: Protocol

An inline check on what enters a run and on what leaves it.

class Guardrail(Protocol) {check_input(self, content: 'str') -> 'GuardResult'; check_output(self, content: 'str') -> 'GuardResult'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.protocols.IdFactory`¶

Stability: beta · Kind: Protocol

Source of identifiers, injected so that a run can be compared with another.

class IdFactory(Protocol)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.protocols.KeyValueStore`¶

Stability: beta · Kind: Protocol

Durable key-to-value storage, for whatever a caller wants keyed.

class KeyValueStore(Protocol) {delete(self, key: 'str') -> 'None'; get(self, key: 'str') -> 'Any'; put(self, key: 'str', value: 'Any') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.protocols.ModelProvider`¶

Stability: beta · 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/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.protocols.SecretProvider`¶

Stability: beta · Kind: Protocol

Where a credential is looked up, asked once per use rather than once per process.

class SecretProvider(Protocol) {secret(self, name: 'str') -> 'str | None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.protocols.ToolRegistry`¶

Stability: beta · Kind: Protocol

The set of tools an agent may call, and their declared schemas.

class ToolRegistry(Protocol) {declarations(self) -> 'Any'; invoke(self, name: 'str', arguments: 'Any') -> 'Any'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.protocols.Tracer`¶

Stability: beta · Kind: Protocol

Sideband emission of spans and events.

class Tracer(Protocol) {event(self, name: 'str', **attributes: 'Any') -> 'None'; span(self, name: 'str', **attributes: 'Any') -> 'Any'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.protocols.members_of`¶

Stability: beta

Return the member names a protocol requires, sorted.

def members_of(protocol: 'type') -> 'tuple[str, ...]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.protocols.verify_conformance`¶

Stability: beta

Raise unless obj provides every member protocol requires.

def verify_conformance(obj: 'object', protocol: 'type') -> 'None'

Typed errors: ProtocolConformanceError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.provenance.ContentSource`¶

Stability: beta

Where content came from, in the form a reviewer would go and look it up by.

class ContentSource(AdkModel) {attributes(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.provenance.Origin`¶

Stability: beta

What produced a piece of content. The one input to its trust level.

class Origin(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.provenance.TRUST_BY_ORIGIN`¶

Stability: beta

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)

TRUST_BY_ORIGIN: dict

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.provenance.TrustLevel`¶

Stability: beta

How far content may act, decided by where it came from.

class TrustLevel(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.provenance.sealed`¶

Stability: beta

Return content in a data envelope whose delimiter it cannot forge or close.

def sealed(content: 'str', *, source: 'ContentSource') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.provenance.weakest`¶

Stability: beta

The lowest trust among everything that went into a piece of content.

def weakest(*levels: 'TrustLevel') -> 'TrustLevel'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.provider.ModelRequest`¶

Stability: beta

One call to a provider, as data.

class ModelRequest(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.provider.ModelResponse`¶

Stability: beta

What a provider returned for one call.

class ModelResponse(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.provider.ProviderName`¶

Stability: beta

Exported value.

ProviderName = typing.Literal['anthropic', 'gemini', 'grok', 'groq', 'llama.cpp', 'ollama', 'openai', 'openai-compatible', 'openrouter', 'tgi', 'vllm', 'xai']

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.provider.StopReason`¶

Stability: beta

Why a model stopped generating, in the kit's words rather than a vendor's.

class StopReason(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.provider.ToolDeclaration`¶

Stability: beta

A tool as the model is told about it.

class ToolDeclaration(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.pseudonym`¶

Stability: beta

A stable stand-in for a person, for an audit record that outlives their consent.

def pseudonym(subject: 'str', *, salt: 'str' = '') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.queue.QueuePolicy`¶

Stability: beta

How long a claim lasts, how often it may be retried, and how long it waits.

class QueuePolicy(AdkModel) {backoff_for(self, attempts: 'int') -> 'float'; claimed(self, item: 'WorkItem', *, worker: 'str', now: 'float', lease_seconds: 'float | None' = None) -> 'WorkItem'; completed(self, item: 'WorkItem') -> 'WorkItem'; exhausted(self, attempts: 'int') -> 'bool'; overheld(self, item: 'WorkItem', now: 'float') -> 'bool'; renewed(self, item: 'WorkItem', *, now: 'float') -> 'WorkItem'; returned(self, item: 'WorkItem', *, error: 'str', now: 'float', retryable: 'bool' = True, backoff: 'bool' = True) -> 'WorkItem'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.queue.QueueStats`¶

Stability: beta

What the queue looks like right now, for the metrics a deployment alerts on.

class QueueStats(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.queue.WorkItem`¶

Stability: beta

One unit of work, as the queue holds it.

class WorkItem(AdkModel) {lapsed_at(self, now: 'float') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.queue.WorkPriority`¶

Stability: beta

How soon an item is claimed relative to its tenant's other work.

class WorkPriority(IntEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.queue.WorkQueue`¶

Stability: beta · Kind: Protocol

Where work waits for a worker, and what becomes of it when one dies holding it.

class WorkQueue(Protocol) {adopt(self, *, worker: 'str') -> 'tuple[WorkItem, ...]'; claim(self, *, worker: 'str', queue: 'str' = 'default', lease_seconds: 'float | None' = None) -> 'WorkItem | None'; complete(self, item_id: 'str', *, tenant: 'str', worker: 'str') -> 'WorkItem'; dead_letters(self, *, tenant: 'str', limit: 'int' = 50) -> 'tuple[WorkItem, ...]'; enqueue(self, item: 'WorkItem') -> 'WorkItem'; fail(self, item_id: 'str', *, tenant: 'str', worker: 'str', error: 'str', retryable: 'bool' = True) -> 'WorkItem'; heartbeat(self, item_id: 'str', *, tenant: 'str', worker: 'str') -> 'WorkItem'; reap(self) -> 'tuple[WorkItem, ...]'; stats(self, *, queue: 'str' = 'default') -> 'QueueStats'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.queue.WorkState`¶

Stability: beta

Where an item is.

class WorkState(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.reach`¶

Stability: beta

The value at a dotted path inside result.

def reach(result: 'BaseModel', path: 'str') -> 'object'

Typed errors: GuardrailEvaluationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.read_envelope`¶

Stability: beta

Decode an event another publisher wrote, upcast to the version this kit reads.

def read_envelope(raw: 'str | bytes') -> 'EventEnvelope'

Typed errors: UnknownEventTypeError, UnsupportedEventVersionError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.redact`¶

Stability: beta

Replace every identifier in text with a placeholder that stands in for it.

def redact(text: 'str', *, tenant: 'str', detectors: 'Sequence[PIIDetector]' = (PatternDetector('card'), PatternDetector('email'), PatternDetector('iban'), PatternDetector('bearer_token'), PatternDetector('api_key'), PatternDetector('national_id'), PatternDetector('passport'), PatternDetector('phone')), threshold: 'float' = 0.6, allow: 'Iterable[str]' = ()) -> 'Redacted'

Typed errors: GuardrailEvaluationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.redaction.MASK`¶

Stability: beta

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

MASK: str

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.redaction.SENSITIVE_SHAPES`¶

Stability: beta

Built-in immutable sequence.

SENSITIVE_SHAPES: tuple

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.redaction.looks_sensitive`¶

Stability: beta

Whether value contains anything shaped like a secret.

def looks_sensitive(value: 'str', extra_patterns: 'Sequence[str]' = ()) -> 'bool'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.redaction.scrub`¶

Stability: beta

Return value with each sensitive-looking run replaced by MASK.

def scrub(value: 'str', extra_patterns: 'Sequence[str]' = ()) -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.rendering.PromptTemplate`¶

Stability: beta

A prompt body whose every slot is declared, typed and checked before it renders.

class PromptTemplate(AdkModel) {render(self, values: 'Mapping[str, object]', *, window_tokens: 'int' = 0) -> 'Rendered'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.rendering.Rendered`¶

Stability: beta

One rendered prompt, and what may be said about it without quoting it.

class Rendered(AdkModel) {attributes(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.rendering.Variable`¶

Stability: beta

One slot a template declares, and what may go in it.

class Variable(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.rendering.wrap_untrusted`¶

Stability: beta

Return content marked as data the model must not take instruction from.

def wrap_untrusted(content: 'str', *, source: 'str') -> 'str'

Typed errors: ValueError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.require_extra`¶

Stability: beta

Import an optional dependency, or say which extra provides it.

def require_extra(extra: 'str', module: 'str') -> 'ModuleType'

Typed errors: MissingExtraError, ModuleNotFoundError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.resolve_config`¶

Stability: beta

Resolve configuration from code, environment and file, and record where each key came from.

def resolve_config(overrides: 'dict[str, Any] | None' = None, *, env: 'dict[str, str] | None' = None, path: 'Path | str | None' = None, start: 'Path | str | None' = '.') -> 'ConfigResolution'

Typed errors: ConfigError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.resolve_hooks`¶

Stability: beta

Return the decision that holds when several hooks answer at one point.

def resolve_hooks(decisions: 'Sequence[HookDecision] | Iterable[HookDecision]') -> 'HookDecision'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.resolve_tenant_policy`¶

Stability: beta

The policy for the tenant bound here.

def resolve_tenant_policy(source: 'TenantConfigProvider') -> 'TenantPolicy'

Typed errors: MissingTenantContextError, TenantUnconfiguredError, UnknownTenantError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.resolve_typed_config`¶

Stability: beta

Resolve statically checked code overrides through the stable config loader.

def resolve_typed_config(overrides: 'ConfigOverrides | None' = None, *, env: 'dict[str, str] | None' = None, path: 'Path | str | None' = None, start: 'Path | str | None' = '.') -> 'ConfigResolution'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.restored`¶

Stability: beta

Read the context off an incoming message, or refuse it.

def restored(headers: 'Mapping[str, str]', *, authenticated: 'str | None' = None) -> 'TenantContext'

Typed errors: TenantContextError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.revived`¶

Stability: beta

The counterpart of canonical_json: tagged moments and decimals back as themselves.

def revived(payload: 'Mapping[str, Any]') -> 'dict[str, Any]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.routing.CHEAP`¶

Stability: beta

The kind of work, named rather than the model that does it.

CHEAP: TaskClass

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.routing.KnownTaskClass`¶

Stability: beta

Exported value.

KnownTaskClass = typing.Literal['cheap', 'smart', 'reasoning']

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.routing.ModelRequirements`¶

Stability: beta

What the caller needs of whatever model answers.

class ModelRequirements(AdkModel) {unsatisfied_by(self, declared: 'object') -> 'tuple[str, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.routing.ModelRouter`¶

Stability: beta · Kind: Protocol

Resolves a task class and a requirement set to one concrete model.

class ModelRouter(Protocol) {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/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.routing.REASONING`¶

Stability: beta

The kind of work, named rather than the model that does it.

REASONING: TaskClass

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.routing.RejectedCandidate`¶

Stability: beta

A model the router passed over, and what it could not do.

class RejectedCandidate(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.routing.RoutingDecision`¶

Stability: beta

Which model answered a task class, and why that one.

class RoutingDecision(AdkModel) {explain(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.routing.SMART`¶

Stability: beta

The kind of work, named rather than the model that does it.

SMART: TaskClass

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.routing.TaskClass`¶

Stability: beta

The kind of work, named rather than the model that does it.

class TaskClass(str)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.run.Run`¶

Stability: beta

One execution of an agent, from prompt assembly to a terminal state.

class Run(AdkModel, Generic) {record(self, usage: 'Usage') -> 'Self'; record_event(self, event: 'RunEvent') -> 'Self'; transition_to(self, state: 'RunState', *, at: 'float | None' = None) -> 'Self'; with_output(self, output: 'OutputT') -> 'Self'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.run.RunContext`¶

Stability: beta

What the runtime threads through every layer of a run.

class RunContext(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.run.RunEvent`¶

Stability: beta

One thing that happened during a run, in the order it happened.

class RunEvent(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.run.RunEventKind`¶

Stability: beta

What happened. One kind per thing the loop does, so a filter is exact.

class RunEventKind(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.run.RunState`¶

Stability: beta

Where a run is, and if it is over, why.

class RunState(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.run.TenantContext`¶

Stability: beta

The isolation boundary the work in hand belongs to.

class TenantContext(AdkModel) {acting_as(self, user: 'str') -> 'Self'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.run.legal_transitions`¶

Stability: beta

The states a run in state may move to. Empty for every terminal state.

def legal_transitions(state: 'RunState') -> 'frozenset[RunState]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.schema.INLINE_REFS`¶

Stability: beta

No $defs and no $ref — every definition substituted where it is used.

INLINE_REFS: InlineRefs

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.schema.InlineRefs`¶

Stability: beta

No $defs and no $ref — every definition substituted where it is used.

class InlineRefs(object) {adapt(self, schema: 'dict[str, Any]') -> 'dict[str, Any]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.schema.JSON_SCHEMA`¶

Stability: beta

Draft 2020-12 as pydantic emits it, normalised. The default.

JSON_SCHEMA: JsonSchema

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.schema.JsonSchema`¶

Stability: beta

Draft 2020-12 as pydantic emits it, normalised. The default.

class JsonSchema(object) {adapt(self, schema: 'dict[str, Any]') -> 'dict[str, Any]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.schema.STRICT_SUBSET`¶

Stability: beta

Every object closed, for providers whose structured-output mode demands it.

STRICT_SUBSET: StrictSubset

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.schema.SchemaDialect`¶

Stability: beta · Kind: Protocol

What one provider will accept, as a transformation and a list of refusals.

class SchemaDialect(Protocol) {adapt(self, schema: 'dict[str, Any]') -> 'dict[str, Any]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.schema.StrictSubset`¶

Stability: beta

Every object closed, for providers whose structured-output mode demands it.

class StrictSubset(object) {adapt(self, schema: 'dict[str, Any]') -> 'dict[str, Any]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.schema.annotations_of`¶

Stability: beta

Resolve a callable's annotations, including those of a callable object's __call__.

def annotations_of(target: 'Callable[..., Any]') -> 'dict[str, Any]'

Typed errors: NameError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.schema.schema_for`¶

Stability: beta

Derive a provider-ready JSON Schema from a type or a callable's signature.

def schema_for(target: 'type | UnionType | Callable[..., Any]', *, dialect: 'SchemaDialect' = JsonSchema(name='json-schema', forbidden=frozenset()), max_bytes: 'int | None' = None, exclude: 'Collection[str]' = ()) -> 'dict[str, Any]'

Typed errors: CapabilityError, SchemaGenerationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.schema.schema_hash`¶

Stability: beta

A stable digest of a schema, for prompt versions and run fingerprints.

def schema_hash(schema: 'Mapping[str, Any]') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.schema_for`¶

Stability: beta

Derive a provider-ready JSON Schema from a type or a callable's signature.

def schema_for(target: 'type | UnionType | Callable[..., Any]', *, dialect: 'SchemaDialect' = JsonSchema(name='json-schema', forbidden=frozenset()), max_bytes: 'int | None' = None, exclude: 'Collection[str]' = ()) -> 'dict[str, Any]'

Typed errors: CapabilityError, SchemaGenerationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.schema_hash`¶

Stability: beta

A stable digest of a schema, for prompt versions and run fingerprints.

def schema_hash(schema: 'Mapping[str, Any]') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.screen`¶

Stability: beta

Recognise instruction-shaped and tool-call-shaped text in a passage.

def screen(text: 'str', *, instructions: 'str' = '') -> 'tuple[InjectionSignal, ...]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.scrub`¶

Stability: beta

Return value with each sensitive-looking run replaced by MASK.

def scrub(value: 'str', extra_patterns: 'Sequence[str]' = ()) -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.sealed`¶

Stability: beta

Return content in a data envelope whose delimiter it cannot forge or close.

def sealed(content: 'str', *, source: 'ContentSource') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.secrets.CachingSecrets`¶

Stability: beta

A resolver with a ttl, so a rotated secret is picked up without a restart.

class CachingSecrets(object) {invalidate(self, ref: 'SecretRef') -> 'None'; invalidate_all(self) -> 'None'; resolve(self, ref: 'SecretRef') -> 'SecretStr'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.secrets.ChainedSecrets`¶

Stability: beta

Resolvers tried in order, the first that holds the secret answering.

class ChainedSecrets(object) {resolve(self, ref: 'SecretRef') -> 'SecretStr'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.secrets.EnvironmentSecrets`¶

Stability: beta

Resolution from the process environment, which is the local development path.

class EnvironmentSecrets(object) {resolve(self, ref: 'SecretRef') -> 'SecretStr'; variable_for(self, ref: 'SecretRef') -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.secrets.ProvidedSecrets`¶

Stability: beta

A SecretProvider — the kit's synchronous lookup — read as a SecretResolver.

class ProvidedSecrets(object) {resolve(self, ref: 'SecretRef') -> 'SecretStr'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.secrets.SecretResolver`¶

Stability: beta · Kind: Protocol

Where a SecretRef is turned into a value, asked at the point of use.

class SecretResolver(Protocol) {resolve(self, ref: 'SecretRef') -> 'SecretStr'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.secrets.literal_credentials`¶

Stability: beta

Fields that look like credentials and hold a literal rather than a reference.

def literal_credentials(config: 'AdkModel') -> 'tuple[str, ...]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.span_here`¶

Stability: beta

The span open right now, or None outside any. What an emitted event parents itself to.

def span_here() -> 'str | None'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.state.RunRecord`¶

Stability: beta

A run as a store holds it: far enough along to be resumed, and no further.

class RunRecord(AdkModel) {scrubbed(self) -> 'Self'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.state.SessionRecord`¶

Stability: beta

A conversation across runs, as a store holds it.

class SessionRecord(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.state.StateDelta`¶

Stability: beta

Amounts to add to a run, never values to set.

class StateDelta(AdkModel) {applied_to(self, record: 'RunRecord') -> 'RunRecord'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.state.StateKey`¶

Stability: beta

Whose record, and which one.

class StateKey(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.state.StatePage`¶

Stability: beta

One page of runs, and where the next one starts.

class StatePage(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.state.StateQuery`¶

Stability: beta

Which runs to list, for operator tooling and for whatever reaps abandoned work.

class StateQuery(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.state.StateStore`¶

Stability: beta · Kind: Protocol

Where session and run state lives, for agents running in more than one process.

class StateStore(Protocol) {delete_run(self, key: 'StateKey') -> 'None'; delete_session(self, key: 'StateKey', *, cascade: 'bool' = False) -> 'None'; get_run(self, key: 'StateKey') -> 'RunRecord | None'; get_session(self, key: 'StateKey') -> 'SessionRecord | None'; list_runs(self, query: 'StateQuery') -> 'StatePage'; patch_run(self, key: 'StateKey', delta: 'StateDelta') -> 'RunRecord'; put_run(self, record: 'RunRecord') -> 'RunRecord'; put_session(self, record: 'SessionRecord') -> 'SessionRecord'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.streaming.ReasoningDelta`¶

Stability: beta

More of the model's own working out.

class ReasoningDelta(StreamEvent)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.streaming.StreamAccumulator`¶

Stability: beta

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/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.streaming.StreamEnd`¶

Stability: beta

The last event, carrying the assembled answer.

class StreamEnd(StreamEvent)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.streaming.StreamEvent`¶

Stability: beta

Base for every event a provider may emit while an answer is being generated.

class StreamEvent(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.streaming.TextDelta`¶

Stability: beta

More of the answer. Concatenating every delta in arrival order gives the content.

class TextDelta(StreamEvent)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.streaming.ToolCallDelta`¶

Stability: beta

Part of one tool call. Vendors send the arguments as JSON text, a fragment at a time.

class ToolCallDelta(StreamEvent)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.streaming.UsageDelta`¶

Stability: beta

The running total, as the provider reports it. Later events replace earlier ones.

class UsageDelta(StreamEvent)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.suspension.ApprovalToken`¶

Stability: beta

A bearer secret that resolves to one suspended run and one held action.

class ApprovalToken(AdkModel) {expired_by(self, now: 'float') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.suspension.DEFAULT_SUSPENSION_SECONDS`¶

Stability: beta

Convert a string or number to a floating-point number, if possible.

DEFAULT_SUSPENSION_SECONDS: float

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.suspension.PendingDecision`¶

Stability: beta

One line of somebody's 'waiting on you', carrying no argument values.

class PendingDecision(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.suspension.SuspendedRun`¶

Stability: beta

A run stopped on a question, and everything needed to carry it on.

class SuspendedRun(AdkModel) {expired_by(self, now: 'float') -> 'bool'; held_for(self, now: 'float') -> 'float'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.suspension.SuspensionStore`¶

Stability: beta · Kind: Protocol

Where stopped runs wait, keyed by run and reachable by token digest.

class SuspensionStore(Protocol) {attempted(self, attempt: 'TokenAttempt') -> 'None'; by_token(self, token_digest: 'str', *, tenant: 'str') -> 'SuspendedRun | None'; forget(self, run_id: 'str', *, tenant: 'str') -> 'None'; get(self, run_id: 'str', *, tenant: 'str') -> 'SuspendedRun | None'; pending(self, *, tenant: 'str') -> 'tuple[SuspendedRun, ...]'; put(self, suspended: 'SuspendedRun') -> 'None'; spend(self, run_id: 'str', *, tenant: 'str') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.suspension.TokenAttempt`¶

Stability: beta

Somebody presenting a token, and what came of it.

class TokenAttempt(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.suspension.TokenRedeemer`¶

Stability: beta · Kind: Protocol

A gate that can turn a token back into the run it stopped.

class TokenRedeemer(Protocol) {redeem(self, token: 'str', *, tenant: 'str', presented_by: 'str') -> 'SuspendedRun'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.suspension.digest_of_token`¶

Stability: beta

Return the SHA-256 of a token value, which is what a store may keep.

def digest_of_token(value: 'str') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.suspension.mint_token`¶

Stability: beta

Issue a token for record, good for ttl_seconds from issued_at.

def mint_token(record: 'ApprovalRecord', *, issued_at: 'float' = 0.0, ttl_seconds: 'float' = 259200.0) -> 'ApprovalToken'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.telemetry_dump`¶

Stability: beta

Dump model for a span, a metric or a log line, without its sensitive fields.

def telemetry_dump(model: 'BaseModel') -> 'dict[str, Any]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tenancy.TenantContext`¶

Stability: beta

The isolation boundary the work in hand belongs to.

class TenantContext(AdkModel) {acting_as(self, user: 'str') -> 'Self'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tenancy.bound`¶

Stability: beta

Wrap call so it runs under the context bound now, wherever it runs later.

def bound(call: 'Callable[ArgsT, ResultT]') -> 'Callable[ArgsT, ResultT]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tenancy.current_tenant`¶

Stability: beta

The context bound here, or a refusal.

def current_tenant(*, where: 'str' = 'current_tenant') -> 'TenantContext'

Typed errors: MissingTenantContextError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tenancy.tenant_here`¶

Stability: beta

The context bound here, or None outside one.

def tenant_here() -> 'TenantContext | None'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tenancy.tenant_scope`¶

Stability: beta

Bind a tenant for the duration of the block, restoring what was there before.

def tenant_scope(what: 'TenantContext | str', *, user: 'str | None' = None, crossing: 'str | None' = None) -> 'Iterator[TenantContext]'

Typed errors: TenantCrossingError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tenant_config.CachingTenantConfig`¶

Stability: beta

A provider in front of a provider, so a limit lookup is not a round trip per run.

class CachingTenantConfig(object) {config_for(self, tenant: 'str') -> 'TenantConfig'; invalidate(self, tenant: 'str') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tenant_config.FileTenantConfig`¶

Stability: beta

Tenant configuration as one TOML file per tenant in a directory.

class FileTenantConfig(object) {config_for(self, tenant: 'str') -> 'TenantConfig'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tenant_config.SecretRef`¶

Stability: beta

The name of a secret, never the secret.

class SecretRef(AdkModel) {describe(self) -> 'str'; for_tenant(self, tenant: 'str') -> 'Self'; resolve(self, secrets: 'SecretProvider') -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tenant_config.TenantConfig`¶

Stability: beta

One tenant's entitlement, as it is stored and as it arrives.

class TenantConfig(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tenant_config.TenantConfigProvider`¶

Stability: beta · Kind: Protocol

Where tenant configuration is read from.

class TenantConfigProvider(Protocol) {config_for(self, tenant: 'str') -> 'TenantConfig'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tenant_config.TenantLimits`¶

Stability: beta

What one tenant may spend, reach and keep.

class TenantLimits(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tenant_config.TenantPolicy`¶

Stability: beta

The resolved entitlement, bound for the work it applies to.

class TenantPolicy(AdkModel) {budget_scope(self) -> 'ScopedLimits | None'; check_model(self, model: 'str') -> 'None'; check_region(self, region: 'str') -> 'None'; check_tool(self, name: 'str') -> 'None'; model_for(self, task_class: 'str') -> 'str | None'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tenant_config.current_policy`¶

Stability: beta

The policy bound here, or a refusal.

def current_policy(*, where: 'str' = 'current_policy') -> 'TenantPolicy'

Typed errors: ConfigurationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tenant_config.policy_here`¶

Stability: beta

The policy bound here, or None outside one.

def policy_here() -> 'TenantPolicy | None'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tenant_config.resolve_tenant_policy`¶

Stability: beta

The policy for the tenant bound here.

def resolve_tenant_policy(source: 'TenantConfigProvider') -> 'TenantPolicy'

Typed errors: MissingTenantContextError, TenantUnconfiguredError, UnknownTenantError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tenant_config.tenant_policy`¶

Stability: beta

Bind a resolved policy for the duration of the block.

def tenant_policy(policy: 'TenantPolicy') -> 'Iterator[TenantPolicy]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tenant_here`¶

Stability: beta

The context bound here, or None outside one.

def tenant_here() -> 'TenantContext | None'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tenant_policy`¶

Stability: beta

Bind a resolved policy for the duration of the block.

def tenant_policy(policy: 'TenantPolicy') -> 'Iterator[TenantPolicy]'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tenant_scope`¶

Stability: beta

Bind a tenant for the duration of the block, restoring what was there before.

def tenant_scope(what: 'TenantContext | str', *, user: 'str | None' = None, crossing: 'str | None' = None) -> 'Iterator[TenantContext]'

Typed errors: TenantCrossingError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tool_access.DenyReason`¶

Stability: beta

Which layer refused. An operator fixes the setting they own, not the one below it.

class DenyReason(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tool_access.ToolAllowlist`¶

Stability: beta

The tools a run may call, resolved once and immutable for its lifetime.

class ToolAllowlist(object) {check(self, name: 'str') -> 'None'; decide(self, name: 'str') -> 'ToolDecision'; narrowed(self, declared: 'Iterable[str]', *, agent: 'str' = '') -> 'Self'; permits(self, name: 'str') -> 'bool'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tool_access.ToolDecision`¶

Stability: beta

One dispatch decision, as it is recorded.

class ToolDecision(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.tool_access.canonical`¶

Stability: beta

The key a tool name is compared under.

def canonical(name: 'str') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.trust.AXES`¶

Stability: beta

Built-in immutable sequence.

AXES: tuple

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.trust.TrustBoundary`¶

Stability: beta

Where a model sits, on the axes a fallback may not cross.

class TrustBoundary(AdkModel) {admits(self, other: 'TrustBoundary') -> 'bool'; differs_from(self, other: 'TrustBoundary') -> 'tuple[str, ...]'}

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.unpacked`¶

Stability: beta

A record back from what a store held, migrated on the way.

def unpacked(text: 'str', model: 'type[ModelT]', *, kind: 'str', registry: 'StateRegistry | None' = None) -> 'ModelT'

Typed errors: StateMigrationError, UnsupportedStateVersionError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.validated`¶

Stability: beta

Validate payload as model, or raise naming every field that failed.

def validated(model: 'type[Model]', payload: 'object') -> 'Model'

Typed errors: SchemaViolationError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.verify_conformance`¶

Stability: beta

Raise unless obj provides every member protocol requires.

def verify_conformance(obj: 'object', protocol: 'type') -> 'None'

Typed errors: ProtocolConformanceError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.weaker_source`¶

Stability: beta

The less trustworthy of two counting sources.

def weaker_source(one: 'CountSource', other: 'CountSource') -> 'CountSource'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.weakest`¶

Stability: beta

The lowest trust among everything that went into a piece of content.

def weakest(*levels: 'TrustLevel') -> 'TrustLevel'

Typed errors: None declared.

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

`tesserix_adk.core.wrap_untrusted`¶

Stability: beta

Return content marked as data the model must not take instruction from.

def wrap_untrusted(content: 'str', *, source: 'str') -> 'str'

Typed errors: ValueError

Runnable recipe: examples/typed_primitives.py — boundary values are typed and closed.

Core API¶

tesserix_adk.core.ALLOWED_ATTRIBUTES¶

tesserix_adk.core.Abstention¶

tesserix_adk.core.ActionClass¶

tesserix_adk.core.ActionRegistry¶

tesserix_adk.core.ActionRequest¶

tesserix_adk.core.ActivityClass¶

tesserix_adk.core.ActivityPolicy¶

tesserix_adk.core.AdkConfig¶

tesserix_adk.core.AdkDeprecationWarning¶

tesserix_adk.core.AdkError¶

tesserix_adk.core.AdkModel¶

tesserix_adk.core.Agent¶

tesserix_adk.core.AgentDefinition¶

tesserix_adk.core.AgentIdentity¶

tesserix_adk.core.AggregationError¶

tesserix_adk.core.Applied¶

tesserix_adk.core.ApprovalBindingError¶

tesserix_adk.core.ApprovalDecided¶

tesserix_adk.core.ApprovalDecision¶

tesserix_adk.core.ApprovalDeliveryError¶

tesserix_adk.core.ApprovalDenial¶

tesserix_adk.core.ApprovalDeniedError¶

tesserix_adk.core.ApprovalExpiredError¶

tesserix_adk.core.ApprovalGate¶

tesserix_adk.core.ApprovalPolicy¶

tesserix_adk.core.ApprovalPredicate¶

tesserix_adk.core.ApprovalRecord¶

tesserix_adk.core.ApprovalRequested¶

tesserix_adk.core.ApprovalToken¶

tesserix_adk.core.ApprovalTokenError¶

tesserix_adk.core.ApprovalTransport¶

tesserix_adk.core.AttributionError¶

tesserix_adk.core.AuditDecision¶

tesserix_adk.core.AuditEvent¶

tesserix_adk.core.AuditSink¶

tesserix_adk.core.AuditUnavailableError¶

tesserix_adk.core.AuthMethod¶

tesserix_adk.core.AuthenticationError¶

tesserix_adk.core.AuthorisationError¶

tesserix_adk.core.AuthorityRevokedError¶

tesserix_adk.core.AutonomyDecision¶

tesserix_adk.core.AutonomyGrant¶

tesserix_adk.core.AutonomyLadder¶

tesserix_adk.core.AutonomyLevel¶

tesserix_adk.core.AutonomyOutcome¶

tesserix_adk.core.AutonomyRefusedError¶

tesserix_adk.core.Backoff¶

tesserix_adk.core.BinaryPart¶

tesserix_adk.core.Bounded¶

tesserix_adk.core.BudgetDecision¶

tesserix_adk.core.BudgetExceeded¶

tesserix_adk.core.BudgetExceededError¶

tesserix_adk.core.BudgetLimits¶

tesserix_adk.core.BudgetPolicy¶

tesserix_adk.core.BudgetScope¶

tesserix_adk.core.BudgetUnavailableError¶

tesserix_adk.core.CHEAP¶

tesserix_adk.core.CHECKPOINT_FORMAT¶

tesserix_adk.core.CURRENT_VERSIONS¶

tesserix_adk.core.CachingSecrets¶

tesserix_adk.core.CachingTenantConfig¶

tesserix_adk.core.CallCredential¶

tesserix_adk.core.CancelledError¶

tesserix_adk.core.Capability¶

tesserix_adk.core.CapabilityError¶

tesserix_adk.core.CapabilitySet¶

tesserix_adk.core.Ceiling¶

tesserix_adk.core.CeilingExceededError¶

tesserix_adk.core.CeilingLedger¶

tesserix_adk.core.ChainedSecrets¶

tesserix_adk.core.Checkpoint¶

tesserix_adk.core.CheckpointBoundary¶

tesserix_adk.core.CheckpointFormatError¶

tesserix_adk.core.CheckpointPolicy¶

tesserix_adk.core.CheckpointStore¶

tesserix_adk.core.CheckpointTooLargeError¶

tesserix_adk.core.ChunkingError¶

tesserix_adk.core.Claim¶

tesserix_adk.core.ClaimCheckPolicy¶

`tesserix_adk.core.ALLOWED_ATTRIBUTES`¶

`tesserix_adk.core.Abstention`¶

`tesserix_adk.core.ActionClass`¶

`tesserix_adk.core.ActionRegistry`¶

`tesserix_adk.core.ActionRequest`¶

`tesserix_adk.core.ActivityClass`¶

`tesserix_adk.core.ActivityPolicy`¶

`tesserix_adk.core.AdkConfig`¶

`tesserix_adk.core.AdkDeprecationWarning`¶

`tesserix_adk.core.AdkError`¶

`tesserix_adk.core.AdkModel`¶

`tesserix_adk.core.Agent`¶

`tesserix_adk.core.AgentDefinition`¶

`tesserix_adk.core.AgentIdentity`¶

`tesserix_adk.core.AggregationError`¶

`tesserix_adk.core.Applied`¶

`tesserix_adk.core.ApprovalBindingError`¶

`tesserix_adk.core.ApprovalDecided`¶

`tesserix_adk.core.ApprovalDecision`¶

`tesserix_adk.core.ApprovalDeliveryError`¶

`tesserix_adk.core.ApprovalDenial`¶

`tesserix_adk.core.ApprovalDeniedError`¶

`tesserix_adk.core.ApprovalExpiredError`¶

`tesserix_adk.core.ApprovalGate`¶

`tesserix_adk.core.ApprovalPolicy`¶

`tesserix_adk.core.ApprovalPredicate`¶

`tesserix_adk.core.ApprovalRecord`¶

`tesserix_adk.core.ApprovalRequested`¶

`tesserix_adk.core.ApprovalToken`¶

`tesserix_adk.core.ApprovalTokenError`¶

`tesserix_adk.core.ApprovalTransport`¶

`tesserix_adk.core.AttributionError`¶

`tesserix_adk.core.AuditDecision`¶

`tesserix_adk.core.AuditEvent`¶

`tesserix_adk.core.AuditSink`¶

`tesserix_adk.core.AuditUnavailableError`¶

`tesserix_adk.core.AuthMethod`¶

`tesserix_adk.core.AuthenticationError`¶

`tesserix_adk.core.AuthorisationError`¶

`tesserix_adk.core.AuthorityRevokedError`¶

`tesserix_adk.core.AutonomyDecision`¶

`tesserix_adk.core.AutonomyGrant`¶

`tesserix_adk.core.AutonomyLadder`¶

`tesserix_adk.core.AutonomyLevel`¶

`tesserix_adk.core.AutonomyOutcome`¶

`tesserix_adk.core.AutonomyRefusedError`¶

`tesserix_adk.core.Backoff`¶

`tesserix_adk.core.BinaryPart`¶

`tesserix_adk.core.Bounded`¶

`tesserix_adk.core.BudgetDecision`¶

`tesserix_adk.core.BudgetExceeded`¶

`tesserix_adk.core.BudgetExceededError`¶

`tesserix_adk.core.BudgetLimits`¶

`tesserix_adk.core.BudgetPolicy`¶

`tesserix_adk.core.BudgetScope`¶

`tesserix_adk.core.BudgetUnavailableError`¶

`tesserix_adk.core.CHEAP`¶

`tesserix_adk.core.CHECKPOINT_FORMAT`¶

`tesserix_adk.core.CURRENT_VERSIONS`¶

`tesserix_adk.core.CachingSecrets`¶

`tesserix_adk.core.CachingTenantConfig`¶

`tesserix_adk.core.CallCredential`¶

`tesserix_adk.core.CancelledError`¶

`tesserix_adk.core.Capability`¶

`tesserix_adk.core.CapabilityError`¶

`tesserix_adk.core.CapabilitySet`¶

`tesserix_adk.core.Ceiling`¶

`tesserix_adk.core.CeilingExceededError`¶

`tesserix_adk.core.CeilingLedger`¶

`tesserix_adk.core.ChainedSecrets`¶

`tesserix_adk.core.Checkpoint`¶

`tesserix_adk.core.CheckpointBoundary`¶

`tesserix_adk.core.CheckpointFormatError`¶

`tesserix_adk.core.CheckpointPolicy`¶

`tesserix_adk.core.CheckpointStore`¶

`tesserix_adk.core.CheckpointTooLargeError`¶

`tesserix_adk.core.ChunkingError`¶

`tesserix_adk.core.Claim`¶

`tesserix_adk.core.ClaimCheckPolicy`¶

`tesserix_adk.core.ClaimCheckStore`¶