import { type BrokerDiscovery } from "../broker/discovery";
export interface SdkSessionEndpoint {
    sessionId: string;
    url: string;
    token: string;
    pid?: number;
    stale?: boolean;
    path: string;
}
export interface SdkDiscoveryWarning {
    code: "discovery_error";
    path: string;
    message: string;
}
export interface SdkSessionEndpointList {
    endpoints: SdkSessionEndpoint[];
    warnings: SdkDiscoveryWarning[];
}
export declare class SdkDiscoveryError extends Error {
    readonly path: string;
    readonly code = "discovery_error";
    constructor(path: string, message: string);
}
export type SdkSessionEndpointScope = "default" | "chat";
/** Lists endpoint files and returns individual malformed or unreadable records as warnings. */
export declare function listSdkSessionEndpoints(repo: string): Promise<SdkSessionEndpointList>;
/** Resolves one per-session SDK endpoint discovery file. */
export declare function readSdkSessionEndpoint(repo: string, sessionId: string, scope?: SdkSessionEndpointScope): Promise<SdkSessionEndpoint | null>;
/** Reads the agent-global broker discovery record. */
export declare function readSdkBrokerDiscovery(agentDir: string): Promise<BrokerDiscovery | null>;