/**
 * builtin 명령 `/retouch-start` 의 실행 흐름을 담당한다.
 * 리터치 브리지 HTTP 서버를 백그라운드로 띄우고 REPL 제어권을 즉시 돌려준다.
 * Storybook local-server 설정(manager.tsx/preview.ts)이 새로 반영된 경우 /server-restart 안내를 남긴다.
 */
import type { AIServiceType, ParsedCliArgs, StoragePaths, TraceLogger } from '../../../platform/types/index';
/**
 * 백그라운드로 실행 중인 리터치 브리지 서버 핸들 (REPL 프로세스당 1개).
 * `infrastructure/server` 를 정적 import하면 AI 규칙(md) 의존 체인이 따라와 vitest가 깨지므로,
 * 핸들은 구조적 타입으로 선언하고 실제 모듈은 실행 시점에 동적 import 한다.
 */
type RunningRetouchServer = {
    close: () => Promise<void>;
    url: string;
    waitUntilClosed: () => Promise<void>;
};
/**
 * @description 백그라운드로 실행 중인 리터치 브리지 서버를 종료한다. 세션 종료 시 cleanup 용도로 사용한다.
 */
export declare function stopRunningRetouchServer(): Promise<void>;
/**
 * @description
 * 리터치 브리지 서버를 백그라운드로 보장한다. (이미 실행 중이면 그대로, testMode면 스킵)
 * Storybook 기동 시 자동 호출되어 "리터치" 패널이 항상 연결되도록 한다.
 * @param options 실행 옵션
 * @returns 실행 중인 브리지 핸들 또는 undefined(testMode)
 */
export declare function ensureRetouchBackgroundServer(options: {
    parsedArgs: ParsedCliArgs;
    paths: StoragePaths;
    service: AIServiceType;
    trace: TraceLogger;
}): Promise<RunningRetouchServer | undefined>;
/**
 * @description
 * Storybook 기동 명령에서 리터치 브리지를 best-effort로 자동 기동한다.
 * 실패(포트 부족 등)해도 호출자 명령을 깨지 않도록 예외를 삼킨다.
 * @param options 실행 옵션
 */
export declare function autoStartRetouchBackgroundServer(options: {
    parsedArgs: ParsedCliArgs;
    paths: StoragePaths;
    service: AIServiceType;
    trace: TraceLogger;
}): Promise<void>;
/**
 * @description
 * `/retouch-start` 를 실행해 리터치 브리지 서버를 백그라운드로 기동한다.
 * @param options 실행 옵션
 * @returns 세션 기록
 */
export declare function runRetouchStartAction(options: {
    parsedArgs: ParsedCliArgs;
    paths: StoragePaths;
    service: AIServiceType;
    trace: TraceLogger;
}): Promise<import("../../../platform/types/history").SessionActionRecord>;
export {};
//# sourceMappingURL=action.d.ts.map