/**
 * NicknameCommand — pure recognizer for the user's natural-language "move/run this
 * on <machine-nickname>" requests (Multi-Machine Session Pool §L4). The headline
 * test-as-self scenario: the user, mid-conversation, says "move this to the mini"
 * and the session transfers to that machine. Per "Structure > Willpower" this is a
 * deterministic recognizer over the KNOWN nickname set (resolved from the registry),
 * NOT an open-ended LLM intent guess — so it can never invent a target machine.
 *
 * The recognizer is intentionally conservative: it only matches when an explicit
 * relocation verb is present AND the tail resolves to a real, known nickname. A
 * bare mention of a machine name ("the mini is fast") never triggers a transfer.
 */
export interface NicknameCommand {
    /** 'transfer' (move an existing session) vs 'pin' (hard-pin future placement). */
    intent: 'transfer' | 'pin';
    /** The known nickname that was matched (canonical form as registered). */
    nickname: string;
    /** The verb phrase that triggered recognition (for audit/telemetry). */
    matchedVerb: string;
}
/**
 * Recognize a nickname relocation command in free text. Returns null if the text
 * is not an explicit move/pin request OR if the target doesn't resolve to a known
 * nickname. Matching is case-insensitive; when multiple nicknames could match, the
 * LONGEST is chosen (so "mac mini" wins over "mini").
 */
export declare function recognizeNicknameCommand(text: string, knownNicknames: string[]): NicknameCommand | null;
//# sourceMappingURL=NicknameCommand.d.ts.map