Skip to content

Interface: SourceCapabilities

Typed view of what a source adapter supports — TS twin of the Py SourceCapabilities dataclass (s-sourceport-contract-cleanup).

Adapters DECLARE this explicitly (capabilities() returns a literal); the kernel consults sourceCapabilities instead of scattering typeof src.query === "function" feature-tests. deriveCapabilities (structural probing) survives as (a) the conformance-test oracle that keeps declarations honest and (b) the deprecated fallback for external adapters that don't declare yet.

Py-only fields with no TS meaning are omitted on purpose: write_kwargs/delete_kwargs/tenant_layer_writes exist in Python because optional kwargs must be probed via inspect.signature; the TS write surface is an options bag, so there is nothing to probe.

Properties

bundleRead

bundleRead: boolean;

bundleWrite

bundleWrite: boolean;

drafts

drafts: boolean;

granularList

granularList: boolean;

Implements the L1 granular reads (independent flags on purpose — the TS FS source ships loadOne but not listDocRefs).


granularOne

granularOne: boolean;

kernelAttachable

kernelAttachable: boolean;

layers

layers: boolean;

queryPushdown

queryPushdown: boolean;

Implements query/count natively (FS: native but in-memory).


source

source: string;

Human-readable adapter label ("filesystem", "postgres", ...).


versions

versions: boolean;