/**
 * Detect which MCP client is invoking nexus-prime.
 *
 * Three tiers (highest-priority first):
 *  1. setMcpClientName()    — from MCP initialize handshake clientInfo.name (most reliable)
 *  2. detectCallerFromEnv() — sync env-var detection, covers ~99% of real clients
 *  3. detectCallerAsync()   — async ps(1) fallback for edge cases (no env vars)
 *
 * The MCP adapter constructor uses tier-2 for immediate init, then the Server's
 * oninitialized callback calls setMcpClientName() (tier-1) once the handshake
 * completes.  detectCallerAsync() falls through only when tier-1 and tier-2 miss.
 */
/**
 * Store the caller identity obtained from the MCP `initialize` handshake
 * `clientInfo.name` field.  Pass an empty string to clear.
 * Called by the MCP adapter's `oninitialized` callback.
 */
export declare function setMcpClientName(rawName: string): void;
/** Instant env-variable detection. Safe to call in a constructor. */
export declare function detectCallerFromEnv(): string;
/** Full detection: MCP handshake name → env vars → ps(1) fallback. */
export declare function detectCallerAsync(): Promise<string>;
