DACP

DACP plugin integration

Install and enable data or execution plugins in a DACP server. For implementation contracts, registration and examples, use the XStream plugin guide.

Installation and configuration

Install plugin JARs and private dependencies not already supplied by the host in plugin_directory, then restart. Do not bundle duplicate public APIs. Data plugins compile against xstream-data-core; execution extensions use xstream-execution-api, with Provided scope. Register through META-INF/services/ inside each JAR. Built-in and external implementations use the same mechanism.

plugin_directory: /opt/dacp/plugins
datasets:
  documents:
    provider: directory
    source:
      root: /srv/data

Plugins run in the server JVM as administrator-installed trusted code. They are distinct from user-submitted operators and are not isolated by operator containers. Plugins validate parameters; DACP enforces service authorization. Registration changes require a restart.

Embedded hosts and lifecycle

DacpServer.builder().plugins(environment, owned = false) injects an application-owned PluginEnvironment that survives server shutdown. Request access handles close after each request; the server releases resources it owns on shutdown.

Execution history can use execution_store: {provider: file, settings: {directory: /var/lib/dacp/executions}}. The file implementation lives in XStream's plugins/xstream-plugin-execution-file. XStream defines the execution-history storage contracts and Sink lifecycle.

A node producing checkpoints configures checkpoint_store with a plugin provider and administrator-controlled directory. The same file plugin provides CheckpointStoreProvider; see execution policies and checkpoints for quotas, lifecycle and configuration.

Service adaptation

DACP maps the shared catalog to remote access and authorizes protected operations. Its S3 adapter reuses the same data access object without a second backend registration. Records-only Items can expose JSONL bytes through the shared adapter; see S3 service.

See configuration reference and embedded server for host integration.

Physical plan generation and optimization · Extend planning optimization