import type { BookCommitment } from '../../commitments/_base/BookCommitment';
import type { AgentReferenceResolver } from './AgentReferenceResolver';
/**
 * Structured issue captured when compact agent reference resolution fails.
 *
 * @private internal utility of agent reference resolution
 */
export type AgentReferenceResolutionIssue = {
    /**
     * Commitment where the unresolved token appeared.
     */
    readonly commitmentType: BookCommitment;
    /**
     * Original token text (for example `{Unknown Agent}` or `@UnknownAgent`).
     */
    readonly token: string;
    /**
     * Normalized token payload used for lookup.
     */
    readonly reference: string;
    /**
     * Human-readable explanation of why the token could not be resolved.
     */
    readonly message: string;
};
/**
 * Extension implemented by resolvers that can expose accumulated resolution issues.
 *
 * @private internal utility of agent reference resolution
 */
export type IssueTrackingAgentReferenceResolver = AgentReferenceResolver & {
    /**
     * Returns tracked issues and clears the internal queue.
     */
    consumeResolutionIssues(): Array<AgentReferenceResolutionIssue>;
};
/**
 * Drains unresolved compact-reference issues from a resolver when supported.
 *
 * @param resolver - Resolver instance that may implement issue tracking.
 * @returns Collected issues or an empty list.
 *
 * @private internal utility of agent reference resolution
 */
export declare function consumeAgentReferenceResolutionIssues(resolver?: AgentReferenceResolver): Array<AgentReferenceResolutionIssue>;