Source Analysis Request Event
Base event for requesting proposition extraction from any incremental source. The user is typed as NamedEntity so that any application's user type (e.g., UrbotUser, Customer) can be used directly.
A publisher that knows where its material came from can say so by overriding sourceLocator and sourceRevision. The extraction listener collects both into an ExtractionRequest and puts them onto the SourceAnalysisContext it builds, so the async path grounds propositions exactly the way a direct rememberText call carrying a request does. Both default to null, so an existing subclass carries no provenance and behaves as it always did.
profile and currentRun work the same way and reach the same context through the same call, so an async publisher can attribute its extraction to a content profile and a run without the listener growing a second code path. Both also default to null.
Inheritors
Functions
The extraction run this event's analysis belongs to, when the publisher is running one.
The extraction content profile this event's analysis should be attributed to, when the publisher has one. EXPERIMENTAL. DICE carries it and routes nothing on it.
Where this event's material lives, when the publisher knows.
The revision of sourceLocator this event's material was read at, when the publisher knows. Its source key must match the locator's, and the listener checks that when it builds the context.