Skip to main content

Crate ctxmesh

Crate ctxmesh 

Source
Expand description

Rust SDK for agents running on ctxmesh, the Kubernetes-native control plane for AI agents.

An agent runs in a pod beside the platform’s sidecars, and this crate is the typed way to reach them over localhost: conversation memory, long-term memory, tools, knowledge bases, feedback, agent-to-agent calls, delegation and handoff.

It holds no credentials. Endpoints and identity arrive in the environment the platform injects, so there is no API key to manage and no base URL to configure.

Conformance tier: plane-client (ADR 0139). Every launcher route is reachable here; the managed agent loop and model client are authoring-tier and live in the Python and TypeScript SDKs. Every capability is also a plain HTTP endpoint, so this crate is convenience, never a requirement.

Structs§

Chunk
One retrieval hit, with the provenance a citation needs.
Client
The entry point.
Config
The resolved plane for one agent process.
Delegation
What /delegate answers. The launcher returns HTTP 200 for EVERY outcome and signals success in ok, so a refusal decoded as a transport success is silent data loss — answer is the entire point of delegating.
Entry
One conversation turn.
Fact
One long-term memory, with the score its retrieval assigned.
Handoff
What /handoff answers, with the same ok-not-status convention.
Skill
One attached skill.

Enums§

Error
The SDK’s error vocabulary.

Constants§

CAPABILITY_HEADER
Carries the run capability. Delegation, handoff, per-user session memory, per-user long-term memory and per-user knowledge bases all key on it. Session memory fails SAFE without it — every user silently shares the agent-wide bucket instead of their own — so omitting it defeats an isolation control with no error to notice.
VERSION
Stamped from the product tag at release (ADR 0135).