import type { Mailbox, MailboxAgentStatus, MailboxMessage } from '../coordination/mailbox-types.js';
import type { HqMailboxAgentSummary, HqMailboxEventPayload, HqMailboxMessageScope, HqMailboxMessageSummary, HqMailboxSnapshotPayload, HqRedactionPolicy } from './protocol.js';
export interface HqMailboxMappingOptions {
    mailboxId: string;
    scope?: 'project' | 'global';
    limit?: number;
    previewLength?: number;
    redactionPolicy?: Partial<HqRedactionPolicy>;
}
export interface HqMailboxSnapshotOptions extends HqMailboxMappingOptions {
    includeCompleted?: boolean;
}
export type HqMailboxEventAction = HqMailboxEventPayload['action'];
/**
 * Classify a mailbox recipient address for UI labeling.
 *
 * - `'*'` (project broadcast) → `'project'`
 * - `@session:<id>`             → `'session'` (returns the session id)
 * - everything else             → `'agent'`
 */
export interface HqMailboxRecipientScope {
    scope: HqMailboxMessageScope;
    recipientSessionId?: string;
}
export declare function classifyMailboxRecipient(to: string): HqMailboxRecipientScope;
export declare function mapMailboxMessageToHqSummary(message: MailboxMessage, options?: Pick<HqMailboxMappingOptions, 'previewLength' | 'redactionPolicy'>): HqMailboxMessageSummary;
export declare function mapMailboxAgentToHqSummary(agent: MailboxAgentStatus): HqMailboxAgentSummary;
export declare function createMailboxSnapshotPayload(messages: readonly MailboxMessage[], agents: readonly MailboxAgentStatus[], options: HqMailboxSnapshotOptions): HqMailboxSnapshotPayload;
export declare function createMailboxSnapshotPayloadFromMailbox(mailbox: Pick<Mailbox, 'query' | 'getAgentStatuses'>, options: HqMailboxSnapshotOptions): Promise<HqMailboxSnapshotPayload>;
export declare function createMailboxEventPayload(input: {
    mailboxId: string;
    action: HqMailboxEventAction;
    message?: MailboxMessage;
    agent?: MailboxAgentStatus;
    summary?: string;
    previewLength?: number;
    redactionPolicy?: Partial<HqRedactionPolicy>;
}): HqMailboxEventPayload;
//# sourceMappingURL=mailbox-mapper.d.ts.map