Skip to content

Interface: IngestionSyncOptions

@kortexya/reasoninglayer


@kortexya/reasoninglayer / IngestionSyncOptions

Defined in: src/resources/ingestion.ts:128

Options controlling synchronous vs asynchronous ingestion.

When sync is true (default), the request blocks until extraction completes and returns the full result. When sync is false, the engine queues the work and answers HTTP 202 with a session to poll; see each method for the exact return shape.

optional causal?: AuditCausalHeaders

Defined in: src/types/common.ts:97

Causal assertions for the audit ledger, sent as the x-osfkb-* request headers. See AuditCausalHeaders.

RequestOptions.causal


optional namespaceId?: string

Defined in: src/types/common.ts:84

Override the namespace for this request (X-Namespace-Id header).

RequestOptions.namespaceId


optional retries?: number

Defined in: src/types/common.ts:92

Number of retry attempts for this request. Set to 0 to disable retries.

RequestOptions.retries


optional signal?: AbortSignal

Defined in: src/types/common.ts:88

AbortSignal for request cancellation.

RequestOptions.signal


optional sync?: boolean

Defined in: src/resources/ingestion.ts:137

Whether to process synchronously.

  • true (default): blocks until complete, returns full result.
  • false: asks the engine to queue the work.
true

optional timeoutMs?: number

Defined in: src/types/common.ts:90

Per-call timeout in milliseconds. Overrides the client-level timeoutMs default.

RequestOptions.timeoutMs


optional userId?: string

Defined in: src/types/common.ts:86

Override the user ID for this request (X-User-Id header). Used for admin impersonation.

RequestOptions.userId