complete
abstract suspend fun complete(request: TerminalCompletionRequest, context: TerminalCompletionContext, limit: Int): List<TerminalCompletionCandidate>
Returns candidates produced by this source for request and context.
Implementations may suspend for bounded host I/O. Cancellation must stop obsolete work promptly. Sources do not launch child coroutines; the merged engine owns parallel collection.
Return
ordered candidates from this source.
Parameters
request
command-line completion context.
context
semantic context resolved for request using the caller's command catalog. Custom engines obtain it through TerminalCompletionContext.resolve and share it across sources.
limit
maximum candidates this source may return.