SDK Reference

Exhaustive API listing for @svantic/sdk. Every class, function, and type the package exports is documented here. Looking to do something? Start in Guides — they walk through end-to-end tasks with full examples.

Entry points

@svantic/sdk exposes two importable entry points:

Import	Contents
`@svantic/sdk`	Everything below — the normal import for application code.
`@svantic/sdk/mesh`	`MeshConnector` and `DEFAULT_SVANTIC_URL`. Use when you manage the Svantic connection yourself.

Building agents

Symbol	Page
`Agent`	Agent
`attach()`, `AgentHandle`, `RuntimeTrigger`	attach
`McpBridge` (used via `agent.register_mcp`)	McpBridge

Calling other agents

Symbol	Page
`RemoteAgent`	RemoteAgent
`AgentDiscovery`	AgentDiscovery
`MessageBuilder`	MessageBuilder

Platform connection

Symbol	Page
`MeshConnector`, `DEFAULT_SVANTIC_URL`	MeshConnector

Security

Symbol	Page
`verify_dispatch_auth`, `DispatchAuthVerifyError`, `DispatchAuthContext`, `VerifierConfig`	Dispatch auth
`parse_traceparent`, `parse_baggage`, `extract_trace_context`	Trace propagation
`SensitiveFormRouter`	A2UI

Built-in tool packages

Symbol	Page
`BuiltinToolLoader`, `BUILTIN_DOMAINS`, `FilesystemToolServer`, `CodeRunnerToolServer`	Built-in tools

Telemetry

Tracing is built in and runs on OpenTelemetry — no SDK-specific classes. See Telemetry for how the SDK emits spans and how to add your own with @opentelemetry/api.

Types

All configuration types (AgentConfig, CapabilityConfig, MeshConnectorConfig, LlmConfig, FilePayload, AgentStatus, …) live in Types.

Versioning

@svantic/sdk follows semver. Breaking changes bump the major version. Minimum runtime is Node.js 20.