Struct DeferredResolutionContext 

pub struct DeferredResolutionContext {
    pub pending: Vec<UncertainReference>,
    pub resolved: Vec<UncertainReference>,
    pub entity_mentions: HashMap<u64, Vec<usize>>,
    pub position: usize,
}

Context for managing multiple uncertain references across a discourse.

This is the “virtual machine” state for deferred coreference resolution, tracking pending references and resolving them as context becomes available.

Example

use anno::discourse::uncertain_reference::{
    DeferredResolutionContext, UncertainReference, ReferenceCandidate,
};

let mut context = DeferredResolutionContext::new();

// Encounter a cataphoric pronoun "When she arrived..."
let cataphoric = UncertainReference::new("she").cataphoric().at_position(5);
context.add_uncertain(cataphoric);

// Process more text...
context.advance();

// Later, encounter "Mary walked in"
context.try_resolve_cataphoric(&[(1, "Mary".to_string(), 0.9)]);

// At discourse end, resolve all pending
context.resolve_all();

// Check statistics
let stats = context.statistics();
assert_eq!(stats.resolved, 1);

Workflow

1. Create context at discourse start
2. Add uncertain references as they’re encountered
3. Call advance to track position
4. When new entities appear, call try_resolve_cataphoric
5. At discourse end, call resolve_all
6. Inspect statistics for analysis

Fields

pending: Vec<UncertainReference>

Uncertain references not yet resolved.

resolved: Vec<UncertainReference>

References that have been resolved (for tracking and analysis).

entity_mentions: HashMap<u64, Vec<usize>>

Entity mentions seen so far: entity_id -> list of positions.

position: usize

Current discourse position (incremented via advance).

Implementations

impl DeferredResolutionContext

pub fn new() -> DeferredResolutionContext

Create a new context.

pub fn add_uncertain(&mut self, reference: UncertainReference)

Add a new uncertain reference.

pub fn record_mention(&mut self, entity_id: u64)

Record an entity mention at the current position.

pub fn advance(&mut self)

Advance discourse position.

pub fn try_resolve_cataphoric(&mut self, new_entities: &[(u64, String, f64)])

Try to resolve pending cataphoric references.

Called when new entities become available.

pub fn resolve_all(&mut self)

Force resolution of all pending references.

Used at discourse end or when resolution is required.

pub fn ambiguous_references(&self, threshold: f64) -> Vec<&UncertainReference>

Get pending references that are ambiguous.

pub fn statistics(&self) -> ResolutionStatistics

Get statistics about resolution.

Trait Implementations

impl Clone for DeferredResolutionContext

fn clone(&self) -> DeferredResolutionContext

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DeferredResolutionContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for DeferredResolutionContext

fn default() -> DeferredResolutionContext

Returns the “default value” for a type.