export interface ActorProfile {
    actorId: string;
    actorType: string;
    displayName: string;
    secondaryLabel: string;
    email?: string;
    avatarUrl?: string;
    resolved: boolean;
}
export type ActorProfileMap = Record<string, ActorProfile>;
export interface ActorInput {
    actorId: string;
    actorType: string;
}
export interface UseActorProfilesOptions {
    /**
     * Override the global gateway base URL. Most callers should leave this
     * unset — the hook resolves the correct global gateway URL from the
     * current hostname (LOCAL/ALPHA/PROD).
     *
     * Note: many microfes are handed a *workspace* gateway URL as their
     * `apiGatewayUrl` prop, which is NOT compatible with this user query.
     * Don't forward such a prop here unless you know it's a global URL.
     */
    apiGatewayUrl?: string;
    authToken?: string;
    orgId?: string;
    workspaceId?: string;
}
export declare function buildActorFallback(actor: ActorInput): ActorProfile;
/**
 * Resolves a list of actor IDs to human-friendly profiles (displayName + email
 * + avatar), with a 5-minute in-memory cache and scope-aware batch lookups.
 *
 * Resolution order for user actors:
 * 1. workspace-scoped batch lookup when workspaceId is available
 * 2. organization-scoped batch lookup when orgId is available
 * 3. global batch lookup for super/tenant admins
 * 4. local fallback
 *
 * Non-user actor types resolve locally to a humanized fallback. Network
 * failures return the fallback rather than throwing — UI always has *something*
 * to render.
 *
 * Pair with the {@link ActorIdentity} component for consistent UUID hygiene:
 * displayName + email in the primary slot, UUID hidden in a drill-down.
 */
export declare function useActorProfiles(actors: ActorInput[], options?: UseActorProfilesOptions): ActorProfileMap;
//# sourceMappingURL=useActorProfiles.d.ts.map