XStream remote data connector
The runner and designer use this self-contained connector for DACP remote catalogs and Item views. Its public package is xstream.connector.dacp.client. It depends on XStream libraries and the bundled wire schema, without a DACP checkout or server artifact.
import xstream.connector.dacp.client.{Source, TlsConfig}
import java.nio.file.Path
import scala.util.Using
val tls = TlsConfig(ca = Some(Path.of("ca.crt")),
tokenFile = Some(Path.of("reader.token")))
val directory = Source.datasets("dacp://data.example.org:8815", tls)
Using.resource(Source.open("dacp://data.example.org:8815/weather", tls)) { dataset =>
println(dataset.list("/"))
}
Anonymous public metadata can be listed without credentials. Protected reads use the configured token; CA trust uses TlsConfig.ca or system roots. Client certificates, when supplied, require both certificate and key. Close datasets and Item readers, including on early exit. Arrow roots are borrowed and reused: consume or copy batches before advancing.
Transport failures become DacpException with stable error codes. Failed reads must be reopened. The DACP SDK and Shell provide remote Job submission; the local engine uses this connector only for data access.
(cd connectors/xstream-dacp-client && sbt test)
Tests use local protocol fixtures; a running DACP service is not required. See engine configuration.
All connections, including anonymous catalog access, verify the server certificate and hostname. Platform trust roots are used by default; configure private or self-signed CAs through TlsConfig.ca or DACP_CA. Verification cannot be disabled.