import type { AgentAdapter, AgentId, HomePath, ImportConfig, SearchScope } from "./contract.js";
/**
 * The source-role subset of `AgentAdapter` this module uses. The target-role methods
 * exist on the port but are never called here (module.md, Public Contract).
 */
export type SourceAdapter = Pick<AgentAdapter, "capabilities" | "listSessions" | "loadSession">;
/** One home to search, with the adapter that can read it. */
export interface SearchTarget {
    agent: AgentId;
    /** Resolved absolute path. */
    home: HomePath;
    adapter: SourceAdapter;
    /** Set when the user named this home and no configuration lists it (FR-2). */
    named?: boolean;
}
/** True when the path exists and is a directory. Symlinks are followed. */
export declare function isDirectory(target: string): Promise<boolean>;
/** Expands a leading `~` and makes the path absolute. */
export declare function expandHome(value: string): string;
/** Absolute path with symlinks resolved. A path that does not exist keeps its expanded form. */
export declare function canonicalPath(value: string): Promise<string>;
/** Every source adapter's default home (FR-3), plus every configured extra home (FR-5). */
export declare function buildSearchList(adapters: readonly SourceAdapter[], config: Pick<ImportConfig, "extraHomes">, scope: SearchScope): Promise<SearchTarget[]>;