Interface SourceDescriptor

Canonical descriptor for one protocol-backed data source. Carries everything required to construct a Source, negotiate capabilities, and project the source onto a server SourceBinding.

interface SourceDescriptor {
    analytics?: SourceAnalyticsCapabilities;
    attribution?: string;
    capabilities: Capabilities;
    capabilityProfile?: CapabilityProfile;
    id: string;
    locator: SourceLocator;
    protocol: Protocol;
    schema?: SourceSchema;
    schemaV2?: SourceSchemaV2Envelope;
}

Properties

attribution?: string
capabilities: Capabilities
capabilityProfile?: CapabilityProfile

Evaluated, immutable capability truth for this source. When present it is authoritative over the legacy capabilities set; the set is retained as a derived compatibility view for built-in capability identifiers.

Profiles must be produced or parsed by @honua/sdk-js/source-capabilities and match both this descriptor's schemaV2 fingerprint and its canonical protocol endpoint identity. Protocol discovery attaches them in the focused capability-aware connection path.

id: string
locator: SourceLocator
protocol: Protocol
schema?: SourceSchema

Identity envelope for an experimental vendor-neutral schema projected alongside legacy schema. Use @honua/sdk-js/source-schema to validate and inspect the complete schema value.