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
/delegateanswers. The launcher returns HTTP 200 for EVERY outcome and signals success inok, so a refusal decoded as a transport success is silent data loss —answeris the entire point of delegating. - Entry
- One conversation turn.
- Fact
- One long-term memory, with the score its retrieval assigned.
- Handoff
- What
/handoffanswers, 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).