/**
 * PostHog telemetry client singleton.
 */
import { getDistinctId } from './config.js';
import type { CommonProperties, TelemetryEventName, TelemetryEventMap } from './events.js';
export interface InitTelemetryOptions {
    /** Whether to show the first-run telemetry notice. Default: true. */
    showNotice?: boolean;
    /**
     * The emitter's own CLI version, e.g. the root `agent-relay` package version.
     * Pass this explicitly — the fallback auto-detection resolves the *telemetry*
     * package's `package.json`, not the product's.
     */
    cliVersion?: string;
    /** Resolved `@agent-relay/sdk` version, if known. */
    sdkVersion?: string;
    /** `agent-relay-broker` Rust binary version, if known. */
    brokerVersion?: string;
    /** Component emitting telemetry, e.g. `cli`, `broker`, or `sdk`. */
    app?: string;
    /** Product surface responsible for telemetry, e.g. `cli`, `cloud`, or `sdk`. */
    surface?: string;
    /** Parent harness driving Agent Relay, if already detected by the caller. */
    orchestratorHarness?: string;
}
export declare function initTelemetry(options?: InitTelemetryOptions): void;
export declare function track<E extends TelemetryEventName>(event: E, properties?: TelemetryEventMap[E] & Partial<CommonProperties>): void;
export declare function shutdown(): Promise<void>;
export declare function isEnabled(): boolean;
export { getDistinctId };
export declare function getStatus(): {
    enabled: boolean;
    disabledByEnv: boolean;
    distinctId: string;
    notifiedAt: string | undefined;
};
//# sourceMappingURL=client.d.ts.map