Type Alias: SourceWriteMode

@kortexya/reasoninglayer / Sources / SourceWriteMode

Type Alias: SourceWriteMode

SourceWriteMode = "transpile" | "ingest"

Defined in: src/types/sources.ts:26

The write-path mode of a source — whether its rows stay in place or become facts.

Remarks

The two modes are deliberately exhaustive: a source that is both a live view and a materialized snapshot is the footgun this distinction exists to make unrepresentable.

transpile — the source’s bound sorts are live SQL views (zero copy). POST /api/v1/sources/{id}/ingest is refused with 409: materializing such a source would create a second, divergent namespace over the same rows.
ingest — rows become Ψ-term facts. Any SQL sort-table binding on the source is honored as a column→feature projection, so ingested facts land on the sort’s declared feature names.

Sent verbatim on the wire. Anything outside this set is rejected by the backend with 422 (serde fails the variant before the handler runs), which is why RegisterSourceRequest.mode is typed as this union rather than a bare string.

Example

const mode: SourceWriteMode = 'ingest';