Auto-Map Elements via AI

Run the MappingOperator over a mapping structure (async).

The MappingOperator walks every unmapped CoA element and proposes associations to reporting concepts. Confidence thresholds: ≥0.90 auto-approved (association created), 0.70-0.89 flagged for review (created with confidence set; surface it in your UI), <0.70 skipped. Returns a pending envelope immediately; subscribe to the SSE stream for progress.

Uniform response shape for every operation endpoint.

Every dispatch carries an op_<ULID> operation_id, which is the bridge to the monitoring surface: pass it to GET /v1/operations/{operation_id}/stream (see routers/operations.py) to subscribe to SSE progress events. Sync commands complete in the envelope itself (status: "completed", HTTP 200); async commands (status: "pending", HTTP 202) hand off to a background worker and stream their tail through that SSE endpoint. Failed dispatches still mint an operation_id so the audit log and any partial SSE events stay correlatable.

TResult parameterizes result so per-op response shapes surface in OpenAPI. Operations that pin OperationSpec.result_type get OperationEnvelope[YourEnvelope] as their response model; the rest keep the default Any shape (result: any | null on the wire).