import type { RoomOrchestrationRecord, RoomOrchestrationState, SagaPhase, RoomMemberSeat, ProvisioningDetail, MemberRetirementPhase, RoomClosePhase, RoomRoleBriefingDefinition, RoomMemberLaunchState } from './types.js';
export declare const roomsDir: () => string;
export declare class RoomStateError extends Error {
}
export interface CreateRoomInput {
    room_id: string;
    room_name: string;
    goal?: string;
    room_identity_cid?: string;
    task_id?: string;
    template_snapshot?: import('./types.js').TemplateSnapshot;
    room_policy?: import('./types.js').RoomLaunchPolicy;
}
export declare function createRoomRecord(input: CreateRoomInput): RoomOrchestrationRecord;
export declare function getRoomRecord(id: string): RoomOrchestrationRecord | undefined;
/** Remove a terminal orchestration record from the live room inventory. */
export declare function deleteRoomRecord(id: string): void;
export declare function listRoomRecords(filter?: {
    state?: RoomOrchestrationState | RoomOrchestrationState[];
}): RoomOrchestrationRecord[];
export declare function advanceSaga(id: string, phase: SagaPhase, stepIndex?: number, detail?: ProvisioningDetail): RoomOrchestrationRecord;
export declare function setSagaError(id: string, error: string, hint?: string, detail?: ProvisioningDetail): RoomOrchestrationRecord;
export declare function setRoomIdentity(id: string, roomIdentityCid: string): RoomOrchestrationRecord;
export declare function setOwnerSeat(id: string, ownerSeatCid: string, inviteFingerprint: string): RoomOrchestrationRecord;
export declare function updateMemberSeats(id: string, seats: RoomMemberSeat[]): RoomOrchestrationRecord;
export declare function updateRoomRoleBriefing(id: string, role: string, definition: RoomRoleBriefingDefinition): RoomOrchestrationRecord;
export declare function updateRoomHistoryCursor(id: string, cursor: number): RoomOrchestrationRecord;
export declare function updateMemberStartup(id: string, roleName: string, update: {
    launch?: RoomMemberLaunchState;
}): RoomOrchestrationRecord;
export declare function activateRoom(id: string): RoomOrchestrationRecord;
export declare function closeRoom(id: string): RoomOrchestrationRecord;
export declare function beginRoomClose(id: string): RoomOrchestrationRecord;
export declare function advanceMemberRetirement(id: string, roleName: string, phase: MemberRetirementPhase, launchId: string, archivePath?: string): RoomOrchestrationRecord;
export declare function advanceRoomClose(id: string, phase: RoomClosePhase): RoomOrchestrationRecord;
export declare function setRoomCloseError(id: string, error: string, recoveryHint: string): RoomOrchestrationRecord;