Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Crate Map

All crates in the skelegent workspace, organized by architectural layer.

Layer 0 – Protocol Traits

CrateDescription
layer0Protocol traits (Operator, Dispatcher, StateStore, Environment), middleware traits (DispatchMiddleware, StoreMiddleware, ExecMiddleware), message types, and error types. The stability contract.

Layer 1 – Operator Implementations

CrateDescription
skg-turnShared toolkit: Provider trait, InferRequest, InferResponse, TokenUsage, provider request/response types, content conversions.
skg-provider-anthropicAnthropic Claude API provider. Implements Provider for the Messages API.
skg-provider-openaiOpenAI API provider. Implements Provider for the Chat Completions API.
skg-provider-ollamaOllama local model provider. Implements Provider for the Ollama API.
skg-provider-codexOpenAI Codex (Responses API) provider. Implements Provider for the Responses API.
skg-provider-routerProvider router. Selects an underlying provider per request using pluggable routing policy.
skg-toolToolDyn trait, ToolRegistry, AliasedTool. Object-safe tool abstraction.
skg-contextConversation context assembly and compaction strategies.
skg-mcpMCP (Model Context Protocol) client. Wraps MCP server tools as ToolDyn implementations.
skg-context-engineComposable three-phase context engine (assembly, inference, reaction). Implements Operator with tool execution.
skg-tool-macroProc macro for #[skg_tool] attribute. Generates ToolDyn implementations from async functions.
skg-op-single-shotSingle-shot operator. Implements Operator with one model call and no tools.
skg-turn-kitTurn engine primitives: DispatchPlanner, ConcurrencyDecider, BatchExecutor (execution-only), SteeringSource.

Layer 2 – Orchestration

CrateDescription
skg-orch-localIn-process orchestrator. Implements Dispatcher (layer0), Signalable, and Queryable (skg-effects-core) with tokio tasks.
skg-orch-kitShared utilities for orchestrator implementations.
skg-orch-envEnvironment-aware orchestrator. Routes operators through Environment::run.
skg-run-corePortable durable run/control primitives and kernel above Layer 0.
skg-effects-coreEffect handler trait (EffectHandler), Signalable, Queryable, errors, and policy — no implementations.
skg-effects-localLocal in-process EffectHandler implementation (in-order, best-effort).
skg-runnerRunner binary for containerized/operator-hosted execution with gRPC + healthcheck endpoints.

Layer 3 – State

CrateDescription
skg-state-memoryIn-memory state store. Implements StateStore with HashMap. Ephemeral.
skg-state-fsFilesystem state store. Implements StateStore with file-backed persistence.
skg-state-proxygRPC proxy for StateStore, enabling cross-container state access.

Layer 4 – Environment and Credentials

CrateDescription
skg-env-localLocal environment. Implements Environment with no isolation (passthrough).
skg-env-dockerDocker-backed environment implementation for isolated operator execution.
skg-secretSecret resolution trait. Defines the interface for secret backends.
skg-secret-vaultHashiCorp Vault secret backend.
skg-cryptoCryptographic utilities and primitives.
skg-authAuthentication and authorization abstractions.
skg-auth-ompOMP credential provider that reads Oh My Pi OAuth tokens from agent.db.

Layer 5 – Cross-Cutting

CrateDescription
skg-hook-securitySecurity middleware: RedactionMiddleware (pattern-based content redaction) and ExfilGuardMiddleware (data-loss-prevention guardrails).
skg-hook-recorderUniversal operation recorder middleware. Captures dispatch events for testing and debugging.
skg-hook-retryRetry middleware with configurable backoff and deadline-aware dispatch retries.

Umbrella

CrateDescription
skelegentUmbrella crate. Feature-gated re-exports of all layers.

A2A

CrateDescription
skg-a2a-coreA2A protocol wire types and conversions.

Examples

CrateDescription
custom-operator-barrierExample custom operator with barrier scheduling and steering (workspace member at examples/custom_operator_barrier).
hello-claudeMinimal example binary that wires OMP auth plus a single-shot Claude operator.
middleware_approvalExample demonstrating approval-gated middleware.
middleware_echoExample demonstrating echo middleware.
middleware_recorderExample demonstrating recorder middleware.

Summary

LayerCrates
01
113
27
33
47
53
Umbrella1
A2A1
Examples5
Total41