Skip to content

Crate Map

All crates in the SmartPoints workspace, organized by the ADR-088 six-layer protocol stack. Test counts reflect #[test] attributes in source and test files.

Layer 0: Kernel

The SPTOS microkernel provides the execution environment for agents and services.

CrateDescriptionKey TypesTests
sptos-nucleusKernel core: syscalls, scheduler, vector store, checkpointKernel, KernelConfig, VectorStore157
sptos-capCapability-based access control: grants, revocation, derivationCapabilityTable, CapabilityGrant, CapManager103
sptos-proofFormal proof engine: witnesses, attestations, verificationProofEngine, Witness, Verifier, Attestation73
sptos-bootSecure boot chain: stages, signatures, attestationBootLoader, BootManifest, WitnessLog61
sptos-queueLock-free ring buffer message queuesKernelQueue, Descriptor, RingBuffer80
sptos-schedTask scheduler with novelty-aware priorityScheduler, Task, Priority, Partition47
sptos-vecgraphHNSW vector graph with coherence gatingGraphStore, VectorStore, CoherenceGate69
sptos-typesShared type definitions across kernel cratesCapability, TaskId, RegionId, Handle63
sptos-regionMemory region management: slab allocation, append-onlyRegionManager, Slab, AppendOnly, Immutable88
sptos-shellInteractive kernel shell (spsh)Parser, ShellCommand41

Layer 1: Host

The host daemon manages kernel instance lifecycles and platform-native integration.

CrateDescriptionKey TypesTests
sptos-host-corePlatform-agnostic host daemon libraryInstanceManager, InstanceState, ResourceLimits57
sptos-host-macosmacOS: Secure Enclave, launchd, BonjourMacOsKeyStore, MacOsLifecycle, MacOsDiscovery47
sptos-host-linuxLinux: TPM 2.0, systemd, AvahiLinuxKeyStore, LinuxLifecycle, LinuxDiscovery45
sptos-host-iosiOS: Secure Enclave, XPC, satellite modeIosKeyStore, IosLifecycle, Satellite73
sptos-host-visionosvisionOS: Secure Enclave, spatial feedVisionOsKeyStore, SpatialFeed63
sptos-host-windowsWindows: TPM 2.0, SCM, WSDWindowsKeyStore, WindowsLifecycle66

Layer 2: Wire

DID-addressed vector transport over QUIC with store-and-forward.

CrateDescriptionKey TypesTests
spt-wireQUIC transport with DID routing, ConnectionCascade, pub/subTransportEndpoint, TransportChannel, ConnectionCascade, SubscriptionManager35
spt-wire-formatBinary segment codec (varint, delta, hash)Segment, Codec--
spt-wire-bridgeBridges SmartPoint envelopes to QUIC transportWireBridge, WireSession0
spt-crypto-providerrustls CryptoProvider with DID auth and PQ cryptoSptCryptoProvider, DidVerifier--
spt-natNAT-PMP, TURN (with 401 retry + IPv6) for NAT traversalQuicNat, StunClient32

Layer 3: SmartPoint

The cryptographic core: asymmetric pairs, post-quantum crypto, identity.

CrateDescriptionKey TypesTests
spt-smartpointSmartPoint pairs and three-layer vector envelopeSmartPointPair, VectorEnvelope, CryptoSuite48
spt-pq-cryptoPost-quantum cryptography: ML-KEM, ML-DSA, HQCMlKem768, MlDsaKeyPair, HybridKem56
spt-vaultKey storage with hardware integrationVault, SmartPointKeys, Attestation74
spt-aidSmart Agentic ID (SAID): DID generation and W3C complianceDid, DidDocument, QuicCert, Federation60

Layer 4: Scope and Governance

Governance boundaries, policy enforcement, and external service connectors.

CrateDescriptionKey TypesTests
sptos-scopeScope governance: policies, actors, connectors, rendezvousScope, ScopePolicy, ActorRegistry, Rendezvous48
spt-connectors-coreConnector framework: traits, lifecycle, manifestsConnectorTrait, ConnectorManifest, Lifecycle29
spt-connector-githubGitHub connector: repos, PRs, issuesGitHubConnector, GitHubAuth, Operations52
spt-entraMicrosoft Entra ID connector: auth, groups, rolesEntraConnector, EntraConfig, RoleMapping114
spt-federationCross-scope federation: trust, negotiation, routingFederationRegistry, TrustRelationship43

Layer 5: Marketplace

Service discovery, retention lifecycle, quarx metering, and privacy overlays.

CrateDescriptionKey TypesTests
spt-discoveryDHT-based service discovery and reputationServiceRegistry, DhtNode, ReputationTracker69
spt-marketplaceRetention lifecycle, escrow, quarx meteringRetentionManager, QuarxLedger, CircuitBreaker56
spt-aicAgentic Identity Chain: Merkle DAG identity ledgerMerkleDag, Vertex, MerkleProof41
spt-darkDark overlay network: shadow addressing, validationShadowAddress, DarkRegistry, DomainResolver83
spt-p2pPeer-to-peer networking: gossip, mesh, KademliaP2pNode, GossipProtocol, MeshTopology48
spt-onionMulti-hop onion routing for traffic analysis resistanceOnionRouter, Circuit, Relay, Mixer69
spt-checkpointIncremental state checkpointing and transferCheckpointManifest, IncrementalCheckpoint36

Layer 6: Application

End-user functionality: appliance, telemetry, LLM routing, crews, spatial.

CrateDescriptionKey TypesTests
spt-applianceNetwork appliance: bootstrap, configuration, invitesAppliance, BootstrapConfig, InviteManager20
spt-telemetryTelemetry pipeline: OTLP, Splunk, webhooks, filtersTelemetryPipeline, Collector, Filter30
spt-llm-routerLLM request routing with tier-based model selectionLlmRouter, TierAssessment, BudgetTracker47
spt-llm-connectorLLM provider connectors: Azure, Anthropic, Bedrock, VertexLlmProvider, AzureConnector, AnthropicConnector40
spt-crewCrew orchestration: agent teams, topics, sessionsCrew, Topic, Session, Roster66
spt-ops-agentsOperational agents: sentinel, alerting, recommendationsSentinel, AlertManager, QuarxEconomist40
spt-spatialSpatial computing: scene graph, animations, agent visualizationSceneGraph, Animation, AgentViz48
spt-spatial-macosmacOS spatial: SceneKit rendering, camera, inputMacOsRenderer, Camera, InputHandler39
spt-spatial-visionosvisionOS spatial: hand/eye tracking, immersive spacesHandTracking, EyeTracking, ImmersiveSpace60
spt-dev-scopeDeveloper scope: tasks, workflows, agent pools, templatesDevScope, TaskRunner, AgentPool, Template42

Layer 7: Intelligence

Model inference, generative runtime, and model registry.

CrateDescriptionKey TypesTests
spt-inferenceMicro-inference via tract: ONNX/GGUF models, batch predictionInferenceEngine, ModelSession, TractBackend29
spt-llm-runtimeGenerative LLM runtime via Candle: tokenization, sampling, KV-cacheLlmRuntime, CandleBackend, SamplingConfig34
spt-modelsModel registry: download, verify, format detection, catalogModelRegistry, ModelCard, FormatDetector94

Layer 8: Orchestration

Agent orchestration, swarm coordination, and MCP tooling (Rust-native, replaces npm sptflo).

CrateDescriptionKey TypesTests
spt-floWire publisher + ReasoningBank: swarm coordination, memory, hooksFloEngine, ReasoningBank, WirePublisher, SwarmCoordinator89
spt-flo-mcpMCP tool server: 13 tools for agent/swarm/memory operationsMcpServer, ToolRegistry, McpHandler29

Bridges

Cross-layer integration and testing.

CrateDescriptionKey TypesTests
spt-apple-host-bridgeUniFFI bridge: Rust host to Swift/Apple APIsAppleBridge, SwiftCallback16
spt-integration-testsEnd-to-end tests across all layers--23

Summary

LayerCrate CountTotal Tests
0 - Kernel10782
1 - Host6351
2 - Wire367
3 - SmartPoint4238
4 - Scope5286
5 - Marketplace7402
6 - Application10432
7 - Intelligence3157
8 - Orchestration2118
Bridges239
Total522,872

Note: This table covers the 52 crates in the ADR-088 architecture. The workspace contains additional crates for vector DB, neural architecture, reasoning, and other subsystems not part of the core protocol stack.

Released under the MIT License.